diff --git a/.gitignore b/.gitignore deleted file mode 100644 index d8892ba..0000000 --- a/.gitignore +++ /dev/null @@ -1,3 +0,0 @@ -_static/logo-composer-transparent.png -_static/logo_silex.png -_static/twig-logo.png \ No newline at end of file diff --git a/.nojekyll b/.nojekyll deleted file mode 100644 index e69de29..0000000 diff --git a/CONTRIBUTING.html b/CONTRIBUTING.html deleted file mode 100644 index 1258959..0000000 --- a/CONTRIBUTING.html +++ /dev/null @@ -1,115 +0,0 @@ - - - - - - - Colaborando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
-
-
-
- -
-

Colaborando

-

¡Nos encantan los colaboradores! Para más información sobre cómo puedes contribuir a la documentación de Symfony, por favor lee [Colaborando en la documentación](<http://gitnacho.github.com/symfony-docs-es/contributing/documentation/overview.html>)

-
- - -
-
-
-
-
- Bifúrcame en GitHub - -
-
-

Navegación

- -
-
- - -
-
- -
- © Copyright 2011-2012, Traducido por Nacho Pacheco. - Actualizado por última vez en Dec 08, 2012. - Creado con Sphinx 1.1.3. -
-
- - - - - \ No newline at end of file diff --git a/_images/01-workflow.png b/_images/01-workflow.png deleted file mode 100644 index 44c32be..0000000 Binary files a/_images/01-workflow.png and /dev/null differ diff --git a/_images/02-kernel-request.png b/_images/02-kernel-request.png deleted file mode 100644 index f3ca215..0000000 Binary files a/_images/02-kernel-request.png and /dev/null differ diff --git a/_images/03-kernel-request-response.png b/_images/03-kernel-request-response.png deleted file mode 100644 index 817abec..0000000 Binary files a/_images/03-kernel-request-response.png and /dev/null differ diff --git a/_images/04-resolve-controller.png b/_images/04-resolve-controller.png deleted file mode 100644 index ae521aa..0000000 Binary files a/_images/04-resolve-controller.png and /dev/null differ diff --git a/_images/06-kernel-controller.png b/_images/06-kernel-controller.png deleted file mode 100644 index 5327e4b..0000000 Binary files a/_images/06-kernel-controller.png and /dev/null differ diff --git a/_images/07-controller-arguments.png b/_images/07-controller-arguments.png deleted file mode 100644 index a1c6ffc..0000000 Binary files a/_images/07-controller-arguments.png and /dev/null differ diff --git a/_images/08-call-controller.png b/_images/08-call-controller.png deleted file mode 100644 index bb74085..0000000 Binary files a/_images/08-call-controller.png and /dev/null differ diff --git a/_images/09-controller-returns-response.png b/_images/09-controller-returns-response.png deleted file mode 100644 index c155847..0000000 Binary files a/_images/09-controller-returns-response.png and /dev/null differ diff --git a/_images/10-kernel-view.png b/_images/10-kernel-view.png deleted file mode 100644 index f8f64f3..0000000 Binary files a/_images/10-kernel-view.png and /dev/null differ diff --git a/_images/11-kernel-exception.png b/_images/11-kernel-exception.png deleted file mode 100644 index 3bb0e39..0000000 Binary files a/_images/11-kernel-exception.png and /dev/null differ diff --git a/_images/DataTransformersTypes.png b/_images/DataTransformersTypes.png deleted file mode 100644 index 950acd3..0000000 Binary files a/_images/DataTransformersTypes.png and /dev/null differ diff --git a/_images/classdiagram.jpg b/_images/classdiagram.jpg deleted file mode 100644 index 8f0d017..0000000 Binary files a/_images/classdiagram.jpg and /dev/null differ diff --git a/_images/docs-pull-request-change-base.png b/_images/docs-pull-request-change-base.png deleted file mode 100644 index b0c36f4..0000000 Binary files a/_images/docs-pull-request-change-base.png and /dev/null differ diff --git a/_images/docs-pull-request.png b/_images/docs-pull-request.png deleted file mode 100644 index 7ec199e..0000000 Binary files a/_images/docs-pull-request.png and /dev/null differ diff --git a/_images/doctrine_image_1_es.png b/_images/doctrine_image_1_es.png deleted file mode 100644 index 530dcfe..0000000 Binary files a/_images/doctrine_image_1_es.png and /dev/null differ diff --git a/_images/doctrine_image_2_es.png b/_images/doctrine_image_2_es.png deleted file mode 100644 index 8ba8cfa..0000000 Binary files a/_images/doctrine_image_2_es.png and /dev/null differ diff --git a/_images/doctrine_image_3_es.png b/_images/doctrine_image_3_es.png deleted file mode 100644 index 912eda5..0000000 Binary files a/_images/doctrine_image_3_es.png and /dev/null differ diff --git a/_images/doctrine_web_debug_toolbar_es.png b/_images/doctrine_web_debug_toolbar_es.png deleted file mode 100644 index 5a5890b..0000000 Binary files a/_images/doctrine_web_debug_toolbar_es.png and /dev/null differ diff --git a/_images/form-simple.png b/_images/form-simple.png deleted file mode 100644 index e740dca..0000000 Binary files a/_images/form-simple.png and /dev/null differ diff --git a/_images/form-simple2.png b/_images/form-simple2.png deleted file mode 100644 index d50028f..0000000 Binary files a/_images/form-simple2.png and /dev/null differ diff --git a/_images/hola_nacho.png b/_images/hola_nacho.png deleted file mode 100644 index fa67ac8..0000000 Binary files a/_images/hola_nacho.png and /dev/null differ diff --git a/_images/http-xkcd-request_es.png b/_images/http-xkcd-request_es.png deleted file mode 100644 index 025d9c5..0000000 Binary files a/_images/http-xkcd-request_es.png and /dev/null differ diff --git a/_images/http-xkcd_es.png b/_images/http-xkcd_es.png deleted file mode 100644 index c724f6b..0000000 Binary files a/_images/http-xkcd_es.png and /dev/null differ diff --git a/_images/profiler_es.png b/_images/profiler_es.png deleted file mode 100644 index 41c3b0c..0000000 Binary files a/_images/profiler_es.png and /dev/null differ diff --git a/_images/progress.png b/_images/progress.png deleted file mode 100644 index c126bff..0000000 Binary files a/_images/progress.png and /dev/null differ diff --git a/_images/release-process.jpg b/_images/release-process.jpg deleted file mode 100644 index f3244c1..0000000 Binary files a/_images/release-process.jpg and /dev/null differ diff --git a/_images/request-flow_es.png b/_images/request-flow_es.png deleted file mode 100644 index 45167d4..0000000 Binary files a/_images/request-flow_es.png and /dev/null differ diff --git a/_images/request-response-flow.png b/_images/request-response-flow.png deleted file mode 100644 index 2ae1011..0000000 Binary files a/_images/request-response-flow.png and /dev/null differ diff --git a/_images/routing_auto_post_schema.png b/_images/routing_auto_post_schema.png deleted file mode 100644 index 73c0903..0000000 Binary files a/_images/routing_auto_post_schema.png and /dev/null differ diff --git a/_images/security_admin_role_access_es.png b/_images/security_admin_role_access_es.png deleted file mode 100644 index 4ce1edb..0000000 Binary files a/_images/security_admin_role_access_es.png and /dev/null differ diff --git a/_images/security_anonymous_user_access_es.png b/_images/security_anonymous_user_access_es.png deleted file mode 100644 index 8ed65cf..0000000 Binary files a/_images/security_anonymous_user_access_es.png and /dev/null differ diff --git a/_images/security_anonymous_user_denied_authorization_es.png b/_images/security_anonymous_user_denied_authorization_es.png deleted file mode 100644 index fa9ce8c..0000000 Binary files a/_images/security_anonymous_user_denied_authorization_es.png and /dev/null differ diff --git a/_images/security_authentication_authorization_es.png b/_images/security_authentication_authorization_es.png deleted file mode 100644 index 2d28333..0000000 Binary files a/_images/security_authentication_authorization_es.png and /dev/null differ diff --git a/_images/security_ryan_no_role_admin_access_es.png b/_images/security_ryan_no_role_admin_access_es.png deleted file mode 100644 index 3271ab6..0000000 Binary files a/_images/security_ryan_no_role_admin_access_es.png and /dev/null differ diff --git a/_images/serializer_workflow.png b/_images/serializer_workflow.png deleted file mode 100644 index 3e1944e..0000000 Binary files a/_images/serializer_workflow.png and /dev/null differ diff --git a/_images/sub-request.png b/_images/sub-request.png deleted file mode 100644 index 8609092..0000000 Binary files a/_images/sub-request.png and /dev/null differ diff --git a/_images/table.png b/_images/table.png deleted file mode 100644 index ba1e3ae..0000000 Binary files a/_images/table.png and /dev/null differ diff --git a/_images/web_debug_toolbar_es.png b/_images/web_debug_toolbar_es.png deleted file mode 100644 index 25974c6..0000000 Binary files a/_images/web_debug_toolbar_es.png and /dev/null differ diff --git a/_images/welcome.png b/_images/welcome.png deleted file mode 100644 index b5e9e57..0000000 Binary files a/_images/welcome.png and /dev/null differ diff --git a/_images/welcome_es.jpg b/_images/welcome_es.jpg deleted file mode 100644 index f709b6b..0000000 Binary files a/_images/welcome_es.jpg and /dev/null differ diff --git a/_sources/CONTRIBUTING.txt b/_sources/CONTRIBUTING.txt deleted file mode 100644 index c5ab2a2..0000000 --- a/_sources/CONTRIBUTING.txt +++ /dev/null @@ -1,4 +0,0 @@ -Colaborando ------------ - -¡Nos encantan los colaboradores! Para más información sobre cómo puedes contribuir a la documentación de *Symfony*, por favor lee [Colaborando en la documentación]() diff --git a/_sources/book/controller.txt b/_sources/book/controller.txt deleted file mode 100644 index 4517333..0000000 --- a/_sources/book/controller.txt +++ /dev/null @@ -1,633 +0,0 @@ -.. index:: - single: Controlador - -Controlador -=========== - -Un controlador es una función *PHP* que tú creas, misma que toma información desde la petición *HTTP* y construye una respuesta *HTTP* y la devuelve (como un objeto ``Respuesta`` de *Symfony2*). La respuesta podría ser una página *HTML*, un documento *XML*, un arreglo *JSON* serializado, una imagen, una redirección, un error 404 o cualquier otra cosa que se te ocurra. El controlador contiene toda la lógica arbitraria que *tu aplicación necesita* para reproducir el contenido de la página. - -Ve lo sencillo que es mirando un controlador *Symfony2* en acción. -El siguiente controlador reproducirá una página que simplemente imprime ``Hello world!``:: - - use Symfony\Component\HttpFoundation\Response; - - public function helloAction() - { - return new Response('Hello world!'); - } - -El objetivo de un controlador siempre es el mismo: crear y devolver un objeto ``Respuesta``. Al mismo tiempo, este puede leer la información de la petición, cargar un recurso de base de datos, enviar un correo electrónico, o fijar información en la sesión del usuario. -Pero en todos los casos, el controlador eventualmente devuelve el objeto ``Respuesta`` que será entregado al cliente. - -¡No hay magia y ningún otro requisito del cual preocuparse! Aquí tienes unos cuantos ejemplos comunes: - -* *Controlador A* prepara un objeto ``Respuesta`` que reproduce el contenido de la página principal del sitio. - -* *Controlador B* lee el parámetro ``slug`` de la petición para cargar una entrada del *blog* desde la base de datos y crear un objeto ``Respuesta`` exhibiendo ese *blog*. Si el ``slug`` no se puede encontrar en la base de datos, crea y devuelve un objeto ``Respuesta`` con un código de estado 404. - -* *Controlador C* procesa la información presentada en un formulario de contacto. Este lee la información del formulario desde la petición, guarda la información del contacto en la base de datos y envía mensajes de correo electrónico con la información de contacto al administrador del sitio *web*. Por último, crea un objeto ``Respuesta`` que redirige al navegador del cliente desde el formulario de contacto a la página de *«agradecimiento»*. - -.. index:: - single: Controlador; Ciclo de vida de la petición, controlador, respuesta - -Ciclo de vida de la petición, controlador, respuesta ----------------------------------------------------- - -Cada petición manejada por un proyecto *Symfony2* pasa por el mismo ciclo de vida básico. -La plataforma se encarga de las tareas repetitivas y, finalmente, ejecuta el controlador, que contiene el código personalizado de tu aplicación: - -#. Cada petición es manejada por un único archivo controlador frontal (por ejemplo, :file:`app.php` o :file:`app_dev.php`) el cual es responsable de arrancar la aplicación; - -#. El ``Enrutador`` lee la información de la petición (por ejemplo, la *URI*), encuentra una ruta que coincida con esa información, y lee el parámetro ``_controller`` de la ruta; - -#. El controlador de la ruta encontrada es ejecutado y el código dentro del controlador crea y devuelve un objeto ``Respuesta``; - -#. Las cabeceras *HTTP* y el contenido del objeto ``Respuesta`` se envían de vuelta al cliente. - -La creación de una página es tan fácil como crear un controlador (#3) y hacer una ruta que vincula una *URL* con ese controlador (#2). - -.. note:: - - A pesar de la similitud en el nombre, un «controlador frontal» es diferente a los «controladores» tratados en este capítulo. Un controlador frontal es un pequeño archivo *PHP* que vive en tu directorio web raíz y a través del cual se dirigen todas las peticiones. Una aplicación típica tendrá un controlador frontal en producción (por ejemplo, :file:`app.php`) y un controlador frontal para desarrollo (por ejemplo, :file:`app_dev.php`). Probablemente nunca necesites editar, ver o preocuparte por los controladores frontales en tu aplicación. - -.. index:: - single: Controlador; Ejemplo sencillo - -Un controlador sencillo ------------------------ - -Mientras que un controlador puede ser cualquier ejecutable *PHP* (una función, un método en un objeto o un ``Cierre``), en *Symfony2*, un controlador suele ser un único método dentro de un objeto controlador. Los controladores también se conocen como *acciones*. - -.. code-block:: php - :linenos: - - // src/Acme/HelloBundle/Controller/HelloController.php - namespace Acme\HelloBundle\Controller; - - use Symfony\Component\HttpFoundation\Response; - - class HelloController - { - public function indexAction($name) - { - return new Response('Hello '.$name.'!'); - } - } - -.. tip:: - - Ten en cuenta que el *controlador* es el método ``indexAction``, que vive dentro de una *clase controlador* (``HelloController``). No te dejes confundir por la nomenclatura: una *clase controlador* simplemente es una conveniente forma de agrupar varios controladores/acciones. Generalmente, la clase controlador albergará varios controladores (por ejemplo, ``updateAction``, ``deleteAction``, etc.). - -Este controlador es bastante sencillo: - -* *línea 4*: *Symfony2* toma ventaja de la funcionalidad del espacio de nombres de *PHP 5.3* para el espacio de nombres de la clase del controlador completa. La palabra clave ``use`` importa la clase ``Respuesta``, la cual devolverá el controlador. - -* *línea 6*: El nombre de clase es la concatenación del nombre de la clase controlador (es decir ``Hello``) y la palabra ``Controller``. Esta es una convención que proporciona consistencia a los controladores y permite hacer referencia sólo a la primera parte del nombre (es decir, ``Hello``) en la configuración del enrutador. - -* *línea 8*: Cada acción en una clase controlador se sufija con ``Action`` y en la configuración de enrutado se refiere con el nombre de la acción (``index``). - En la siguiente sección, crearás una ruta que asigna una *URI* a esta acción. - Aprenderás cómo los marcadores de posición de la ruta (``{name}``) se convierten en argumentos para el método de acción (``$name``). - -* *línea 10*: el controlador crea y devuelve un objeto ``Respuesta``. - -.. index:: - single: Controlador; Rutas y controladores - -Asociando una *URL* a un controlador ------------------------------------- - -El nuevo controlador devuelve una página *HTML* simple. Para realmente ver esta página en tu navegador, necesitas crear una ruta, la cual corresponda a un patrón de *URL* específico para el controlador: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - hello: - path: /hello/{name} - defaults: { _controller: AcmeHelloBundle:Hello:index } - - .. code-block:: xml - - - - AcmeHelloBundle:Hello:index - - - .. code-block:: php - - // app/config/routing.php - $collection->add('hello', new Route('/hello/{name}', array( - '_controller' => 'AcmeHelloBundle:Hello:index', - ))); - -Yendo ahora a ``/hello/ryan`` se ejecuta el controlador ``HelloController::indexAction()`` y pasa ``ryan`` a la variable ``$name``. Crear una «página» significa simplemente que debes crear un método controlador y una ruta asociada. - -Observa la sintaxis utilizada para referirse al controlador: ``AcmeHelloBundle:Hello:index``. -*Symfony2* utiliza una flexible notación de cadena para referirse a diferentes controladores. -Esta es la sintaxis más común y le dice a *Symfony2* que busque una clase controlador llamada ``HelloController`` dentro de un paquete llamado ``AcmeHelloBundle``. Entonces ejecuta el método ``indexAction()``. - -Para más detalles sobre el formato de cadena utilizado para referirte a diferentes controladores, consulta el :ref:`controller-string-syntax`. - -.. note:: - - Este ejemplo coloca la configuración de enrutado directamente en el directorio ``app/config/``. Una mejor manera de organizar tus rutas es colocar cada ruta en el paquete al que pertenece. Para más información sobre este tema, consulta :ref:`routing-include-external-resources`. - -.. tip:: - - Puedes aprender mucho más sobre el sistema de enrutado en el :doc:`capítulo de enrutado `. - -.. index:: - single: Controlador; Argumentos del controlador - -.. _route-parameters-controller-arguments: - -Parámetros de ruta como argumentos para el controlador -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ya sabes que el parámetro ``_controller`` en ``AcmeHelloBundle:Hello:index`` se refiere al método ``HelloController::indexAction()`` que vive dentro del paquete ``AcmeHelloBundle``. Lo más interesante de esto son los argumentos que se pasan a este método:: - - // src/Acme/HelloBundle/Controller/HelloController.php - namespace Acme\HelloBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - - class HelloController extends Controller - { - public function indexAction($name) - { - // ... - } - } - -El controlador tiene un solo argumento, ``$name``, el cual corresponde al parámetro ``{name}`` de la ruta coincidente (``ryan`` en el ejemplo). De hecho, cuando ejecutas tu controlador, *Symfony2* empareja cada argumento del controlador con un parámetro de la ruta coincidente. Ve el siguiente ejemplo: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - hello: - path: /hello/{first_name}/{last_name} - defaults: { _controller: AcmeHelloBundle:Hello:index, color: green } - - .. code-block:: xml - - - - AcmeHelloBundle:Hello:index - green - - - .. code-block:: php - - // app/config/routing.php - $collection->add('hello', new Route('/hello/{first_name}/{last_name}', array( - '_controller' => 'AcmeHelloBundle:Hello:index', - 'color' => 'green', - ))); - -El controlador para esto puede tomar varios argumentos:: - - public function indexAction($first_name, $last_name, $color) - { - // ... - } - -Ten en cuenta que ambas variables marcadoras de posición (``{first_name}``, ``{last_name}``) así como la variable predeterminada ``color`` están disponibles como argumentos en el controlador. Cuando una ruta corresponde, las variables marcadoras de posición se combinan con ``defaults`` para hacer que un arreglo esté disponible para tu controlador. - -Asociar parámetros de ruta a los argumentos del controlador es fácil y flexible. Ten muy en cuenta las siguientes pautas mientras desarrollas. - -* **El orden de los argumentos del controlador no tiene importancia** - - *Symfony2* es capaz de igualar los nombres de los parámetros de la ruta con los nombres de las variables en la firma del método controlador. En otras palabras, se da cuenta de que el parámetro ``{last_name}`` coincide con el argumento ``$last_name``. - Los argumentos del controlador se pueden reorganizar completamente y aún así siguen funcionando perfectamente:: - - public function indexAction($last_name, $color, $first_name) - { - // ... - } - -* **Cada argumento requerido del controlador debe coincidir con un parámetro de enrutado** - - Lo siguiente lanzará una ``RuntimeException`` porque no hay ningún parámetro ``foo`` definido en la ruta:: - - public function indexAction($first_name, $last_name, $color, $foo) - { - // ... - } - - Sin embargo, hacer que el argumento sea opcional, es perfectamente legal. El siguiente ejemplo no lanzará una excepción:: - - public function indexAction($first_name, $last_name, $color, $foo = 'bar') - { - // ... - } - -* **No todos los parámetros de enrutado deben ser argumentos en tu controlador** - - Si por ejemplo, ``last_name`` no es tan importante para tu controlador, lo puedes omitir por completo:: - - public function indexAction($first_name, $color) - { - // ... - } - -.. tip:: - - Además, todas las rutas tienen un parámetro ``_route`` especial, el cual es igual al nombre de la ruta con la que fue emparejado (por ejemplo, ``hello``). Aunque no suele ser útil, igualmente está disponible como un argumento del controlador. - -.. _book-controller-request-argument: - -La ``Petición`` como argumento para el controlador -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para mayor comodidad, también puedes hacer que *Symfony* pase el objeto ``Petición`` como un argumento a tu controlador. Esto es conveniente especialmente cuando trabajas con formularios, por ejemplo:: - - use Symfony\Component\HttpFoundation\Request; - - public function updateAction(Request $request) - { - $form = $this->createForm(...); - - $form->bind($request); - // ... - } - -.. index:: - single: Controlador; Clase base controlador - -Creando páginas estáticas -------------------------- - -Puedes crear una página estática incluso sin crear un controlador (sólo se necesita una ruta -y la plantilla). - -¡Utilizalo! Ve :doc:`/cookbook/templating/render_without_controller`. - -La clase base del controlador ------------------------------ - -Para mayor comodidad, *Symfony2* viene con una clase ``Controller`` base, que te ayuda en algunas de las tareas más comunes del ``Controlador`` y proporciona acceso a cualquier recurso que tu clase controlador pueda necesitar. Al extender esta clase ``Controlador``, puedes tomar ventaja de varios métodos ayudantes. - -Agrega la instrucción ``use`` en lo alto de la clase ``Controlador`` y luego modifica ``HelloController`` para extenderla:: - - // src/Acme/HelloBundle/Controller/HelloController.php - namespace Acme\HelloBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - use Symfony\Component\HttpFoundation\Response; - - class HelloController extends Controller - { - public function indexAction($name) - { - return new Response('Hello '.$name.'!'); - } - } - -Esto, en realidad no cambia nada acerca de cómo funciona el controlador. En la siguiente sección, aprenderás acerca de los métodos ayudantes que la clase base del controlador pone a tu disposición. Estos métodos sólo son atajos para utilizar la funcionalidad del núcleo de *Symfony2* que está a nuestra disposición, usando o no la clase base ``Controller``. Una buena manera de ver la funcionalidad del núcleo en acción es buscar en la misma clase :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller`. - -.. tip:: - - Extender la clase base ``Controller`` en *Symfony* es opcional; esta contiene útiles atajos, pero no es obligatorio. También puedes extender la clase :class:`Symfony\\Component\\DependencyInjection\\ContainerAware`. El objeto contenedor del servicio será accesible a través de la propiedad ``container``. - -.. note:: - - Puedes definir tus :doc:`Controladores como Servicios `. - -.. index:: - single: Controlador; Tareas comunes - -Tareas comunes del controlador ------------------------------- - -A pesar de que un controlador puede hacer prácticamente cualquier cosa, la mayoría de los controladores se encargarán de las mismas tareas básicas una y otra vez. Estas tareas, tal como redirigir, procesar plantillas y acceder a servicios básicos, son muy fáciles de manejar en *Symfony2*. - -.. index:: - single: Controlador; Redirigiendo - -Redirigiendo -~~~~~~~~~~~~ - -Si deseas redirigir al usuario a otra página, utiliza el método ``redirect()``:: - - public function indexAction() - { - return $this->redirect($this->generateUrl('homepage')); - } - -El método ``generateUrl()`` es sólo una función auxiliar que genera la *URL* de una determinada ruta. Para más información, consulta el capítulo :doc:`Enrutando `. - -Por omisión, el método ``redirect()`` produce una redirección 302 (temporal). Para realizar una redirección 301 (permanente), modifica el segundo argumento:: - - public function indexAction() - { - return $this->redirect($this->generateUrl('homepage'), 301); - } - -.. tip:: - - El método ``redirect()`` simplemente es un atajo que crea un objeto ``Respuesta`` que se especializa en redirigir a los usuarios. Es equivalente a:: - - use Symfony\Component\HttpFoundation\RedirectResponse; - - return new RedirectResponse($this->generateUrl('homepage')); - -.. index:: - single: Controlador; Reenviando - -Reenviando -~~~~~~~~~~ - -Además, fácilmente puedes redirigir internamente hacia a otro controlador con el método ``forward()``. En lugar de redirigir el navegador del usuario, este hace una subpetición interna, y llama el controlador especificado. El método ``forward()`` regresa el objeto ``Respuesta``, el cual es devuelto desde el controlador:: - - public function indexAction($name) - { - $response = $this->forward('AcmeHelloBundle:Hello:fancy', array( - 'name' => $name, - 'color' => 'green', - )); - - // ... adicionalmente modifica la respuesta o la devuelve - // directamente - - return $response; - } - -Ten en cuenta que el método ``forward()`` utiliza la misma representación de cadena del controlador utilizada en la configuración de enrutado. En este caso, la clase controlador de destino será ``HelloController`` dentro de algún ``AcmeHelloBundle``. -El arreglo pasado al método se convierte en los argumentos del controlador resultante. -Esta misma interfaz se utiliza al incrustar controladores en las plantillas (consulta :ref:`templating-embedding-controller`). El método del controlador destino debe tener un aspecto como el siguiente:: - - public function fancyAction($name, $color) - { - // ... crea y devuelve un objeto Response - } - -Y al igual que al crear un controlador para una ruta, el orden de los argumentos para ``fancyAction`` no tiene la menor importancia. *Symfony2* empareja las claves nombre con el índice (por ejemplo, ``name``) con el argumento del método (por ejemplo, ``$name``). Si cambias el orden de los argumentos, *Symfony2* todavía pasará el valor correcto a cada variable. - -.. tip:: - - Al igual que otros métodos del ``Controller`` base, el método ``forward`` sólo es un atajo para la funcionalidad del núcleo de *Symfony2*. Puedes redirigir directamente por medio del servicio ``http_kernel``. Un reenvío devuelve un objeto ``Respuesta``:: - - $httpKernel = $this->container->get('http_kernel'); - $response = $httpKernel->forward( - 'AcmeHelloBundle:Hello:fancy', - array( - 'name' => $name, - 'color' => 'green', - ) - ); - -.. index:: - single: Controlador; Reproduciendo plantillas - -.. _controller-rendering-templates: - -Procesando plantillas -~~~~~~~~~~~~~~~~~~~~~ - -Aunque no es un requisito, la mayoría de los controladores en última instancia, reproducen una plantilla que es responsable de generar el código *HTML* (u otro formato) para el controlador. -El método ``renderView()`` procesa una plantilla y devuelve su contenido. Puedes usar el contenido de la plantilla para crear un objeto ``Respuesta``:: - - use Symfony\Component\HttpFoundation\Response; - - $content = $this->renderView( - 'AcmeHelloBundle:Hello:index.html.twig', - array('name' => $name) - ); - - return new Response($content); - -Incluso puedes hacerlo en un solo paso con el método ``render()``, el cual devuelve un objeto ``Respuesta`` con el contenido de la plantilla:: - - return $this->render( - 'AcmeHelloBundle:Hello:index.html.twig', - array('name' => $name) - ); - -En ambos casos, se reproducirá la plantilla ``Resources/views/Hello/index.html.twig`` dentro del ``AcmeHelloBundle``. - -El motor de plantillas de *Symfony* se explica con gran detalle en el capítulo :doc:`Plantillas `. - -.. tip:: - - Incluso puedes evitar la llamada al método ``render`` utilizando la anotación ``@Template``. Consulta la documentación del :doc:`FrameworkExtraBundle ` para más detalles. - -.. tip:: - - El método ``renderView`` es un atajo para usar el servicio de ``plantillas``. También puedes usar directamente el servicio de ``plantillas``:: - - $templating = $this->get('templating'); - $content = $templating->render( - 'AcmeHelloBundle:Hello:index.html.twig', - array('name' => $name) - ); - -.. note:: - - Es posible reproducir las plantillas en subdirectorios más profundos también, no obstante, ten cuidado para evitar caer en la trampa de hacer la estructura de directorios excesivamente elaborada:: - - $templating->render( - 'AcmeHelloBundle:Hello/Greetings:index.html.twig', - array('name' => $name) - ); - // reproduce index.html.twig ubicada en Resources/views/Hello/Greetings. - -.. index:: - single: Controlador; Accediendo a servicios - -Accediendo a otros servicios -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Al extender la clase base del controlador, puedes acceder a cualquier servicio de *Symfony2* a través del método ``get()``. Aquí hay varios servicios comunes que puedes necesitar:: - - $request = $this->getRequest(); - - $templating = $this->get('templating'); - - $router = $this->get('router'); - - $mailer = $this->get('mailer'); - -Hay un sinnúmero de servicios disponibles y te animamos a definir tus propios servicios. Para listar todos los servicios disponibles, utiliza la orden ``container:debug`` de la consola: - -.. code-block:: bash - - $ php app/console container:debug - -Para más información, consulta el capítulo :doc:`/book/service_container`. - -.. index:: - single: Controlador; Gestionando errores - single: Controlador; páginas 404 - -Gestionando errores y páginas 404 ---------------------------------- - -Cuando no se encuentra algo, debes jugar bien con el protocolo *HTTP* y devolver una respuesta 404. Para ello, debes lanzar un tipo de excepción especial. -Si estás extendiendo la clase base del controlador, haz lo siguiente:: - - public function indexAction() - { - // recupera el objeto desde la base de datos - $product = ...; - if (!$product) { - throw $this->createNotFoundException('The product does not exist'); - } - - return $this->render(...); - } - -El método ``createNotFoundException()`` crea un objeto ``NotFoundHttpException`` especial, que en última instancia, desencadena una respuesta *HTTP 404* en el interior de *Symfony*. - -Por supuesto, estás en libertad de lanzar cualquier clase de ``Excepción`` en tu controlador ---*Symfony2* automáticamente devolverá una respuesta *HTTP* con código 500. - -.. code-block:: php - - throw new \Exception('Something went wrong!'); - -En todos los casos, el usuario final ve una página de error estilizada y a los desarrolladores se les muestra una página de depuración de error completa (cuando visualizas la página en modo de depuración). -Puedes personalizar ambas páginas de error. Para más detalles, lee «:doc:`/cookbook/controller/error_pages`» en el recetario. - -.. index:: - single: Controlador; La sesión - single: Sesión - -Gestionando la sesión ---------------------- - -*Symfony2* proporciona un agradable objeto sesión que puedes utilizar para almacenar información sobre el usuario (ya sea una persona real usando un navegador, un robot o un servicio web) entre las peticiones. De manera predeterminada, *Symfony2* almacena los atributos de una :dfn:`cookie` usando las sesiones nativas de *PHP*. - -Almacenar y recuperar información de la sesión se puede conseguir fácilmente desde cualquier controlador:: - - $session = $this->getRequest()->getSession(); - - // guarda un atributo para reutilizarlo durante una - // posterior petición del usuario - $session->set('foo', 'bar'); - - // en otro controlador por otra petición - $foo = $session->get('foo'); - - // usa un valor predefinido si la clave no existe - $filters = $session->set('filters', array()); - -Estos atributos se mantendrán en el usuario por el resto de esa sesión. - -.. index:: - single: Sesión; Mensajes flash - -Mensajes flash -~~~~~~~~~~~~~~ - -También puedes almacenar pequeños mensajes que se pueden guardar en la sesión del usuario para exactamente una petición adicional. Esto es útil cuando procesas un formulario: -deseas redirigir y proporcionar un mensaje especial que aparezca en la *siguiente* petición. -Este tipo de mensajes se conocen como mensajes «flash». - -Por ejemplo, imagina que estás procesando el envío de un formulario:: - - public function updateAction() - { - $form = $this->createForm(...); - - $form->bind($this->getRequest()); - if ($form->isValid()) { - // hace algún tipo de procesamiento - - $this->get('session')->getFlashBag()->add('notice', 'Your changes were saved!'); - - return $this->redirect($this->generateUrl(...)); - } - - return $this->render(...); - } - -Después de procesar la petición, el controlador establece un mensaje flash ``notice`` y luego redirige al usuario. El nombre (``aviso``) no es significativo ---es lo que estás usando para identificar el tipo del mensaje. - -En la siguiente acción de la plantilla, podrías utilizar el siguiente código para reproducir el mensaje de ``aviso``: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% for flashMessage in app.session.flashbag.get('notice') %} -
- {{ flashMessage }} -
- {% endfor %} - - .. code-block:: html+php - - getFlashBag()->get('notice') as $message): ?> -
- $message
" ?> - - - -Por diseño, los mensajes flash están destinados a vivir por exactamente una petición (estos «desaparecen en un flash»). Están diseñados para utilizarlos a través de redirecciones exactamente como lo se hizo en este ejemplo. - -.. index:: - single: Controlador; Objeto Respuesta - -El objeto ``Respuesta`` ------------------------ - -El único requisito para un controlador es que devuelva un objeto ``Respuesta``. La clase :class:`Symfony\\Component\\HttpFoundation\\Response` es una abstracción *PHP* en torno a la respuesta *HTTP* ---el mensaje de texto, relleno con cabeceras *HTTP* y el contenido que se envía de vuelta al cliente:: - - use Symfony\Component\HttpFoundation\Response; - - // crea una simple respuesta con un código de estado 200 (el predeterminado) - $response = new Response('Hello '.$name, 200); - - // crea una respuesta JSON con código de estado 200 - $response = new Response(json_encode(array('name' => $name))); - $response->headers->set('Content-Type', 'application/json'); - -.. tip:: - - La propiedad ``headers`` es un objeto :class:`Symfony\\Component\\HttpFoundation\\HeaderBag` con varios métodos útiles para lectura y mutación de las cabeceras del objeto ``Respuesta``. Los nombres de las cabeceras están normalizados para que puedas usar ``Content-Type`` y este sea equivalente a ``content-type``, e incluso a ``content_type``. - -.. tip:: - - También hay clases especiales para hacer más fácil ciertas clases de respuestas: - - - Para JSON, está la clase :class:`Symfony\\Component\\HttpFoundation\\JsonResponse`. - Ve :ref:`component-http-foundation-json-response`. - - Para archivos, está la clase :class:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse`. - Ve :ref:`component-http-foundation-serving-files`. - -.. index:: - single: Controlador; Objeto Petición - -El objeto ``Petición`` ----------------------- - -Además de los valores de los marcadores de posición de enrutado, el controlador también tiene acceso al objeto ``Petición`` al extender la clase base ``Controlador``:: - - $request = $this->getRequest(); - - $request->isXmlHttpRequest(); // ¿es una petición Ajax? - - $request->getPreferredLanguage(array('en', 'fr')); - - $request->query->get('page'); // obtiene un parámetro $_GET - - $request->request->get('page'); // obtiene un parámetro $_POST - -Al igual que el objeto ``Respuesta``, las cabeceras de la petición se almacenan en un objeto ``HeaderBag`` y son fácilmente accesibles. - -Consideraciones finales ------------------------ - -Siempre que creas una página, en última instancia, tendrás que escribir algún código que contenga la lógica para esa página. En *Symfony*, a esto se le llama *controlador*, y es una función *PHP* que puede hacer cualquier cosa que necesites a fin de devolver el objeto ``Respuesta`` que se entregará al usuario final. - -Para facilitarte la vida, puedes optar por extender la clase base ``Controller``, la cual contiene atajos a métodos para muchas tareas de control comunes. Por ejemplo, puesto que no deseas poner el código *HTML* en tu controlador, puedes usar el método ``render()`` para reproducir y devolver el contenido desde una plantilla. - -En otros capítulos, verás cómo puedes usar el controlador para conservar y recuperar objetos desde una base de datos, procesar formularios presentados, manejar el almacenamiento en caché y mucho más. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/controller/error_pages` -* :doc:`/cookbook/controller/service` diff --git a/_sources/book/doctrine.txt b/_sources/book/doctrine.txt deleted file mode 100644 index 8d84e4b..0000000 --- a/_sources/book/doctrine.txt +++ /dev/null @@ -1,1277 +0,0 @@ -.. index:: - single: Doctrine - -Bases de datos y *Doctrine* -=========================== - -Seamos realistas, una de las tareas más comunes y desafiantes para cualquier aplicación involucra la persistencia y lectura de información hacia y desde una base de datos. Afortunadamente, *Symfony* viene integrado con `Doctrine`_, una biblioteca, cuyo único objetivo es dotarte de poderosas herramientas para facilitarte eso. En este capítulo, aprenderás la filosofía básica detrás de *Doctrine* y verás lo fácil que puede ser trabajar con una base de datos. - -.. note:: - - *Doctrine* está totalmente desconectado de *Symfony* y utilizarlo es opcional. - Este capítulo trata acerca del *ORM* de *Doctrine*, el cual te permite asociar objetos a una base de datos relacional (tal como *MySQL*, *PostgreSQL* o *Microsoft SQL*). Si prefieres utilizar las consultas de base de datos en bruto, es fácil y se explica en el artículo «:doc:`/cookbook/doctrine/dbal`» del recetario. - - También puedes persistir tus datos en `MongoDB`_ utilizando la biblioteca *ODM* de *Doctrine*. Para más información, lee la documentación en «:doc:`/bundles/DoctrineMongoDBBundle/index`». - -Un sencillo ejemplo: Un producto --------------------------------- - -La forma más fácil de entender cómo funciona *Doctrine* es verlo en acción. -En esta sección, configurarás tu base de datos, crearás un objeto ``Producto``, lo persistirás en la base de datos y lo recuperarás de nuevo. - -.. sidebar:: El código del ejemplo - - Si quieres seguir el ejemplo de este capítulo, crea el paquete ``AcmeStoreBundle`` ejecutando la orden: - - .. code-block:: bash - - $ php app/console generate:bundle --namespace=Acme/StoreBundle - -Configurando la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de comenzar realmente, tendrás que configurar tu información de conexión a la base de datos. Por convención, esta información se suele configurar en el archivo -:file:`app/config/parameters.yml`: - -.. code-block:: yaml - - # app/config/parameters.yml - parameters: - database_driver: pdo_mysql - database_host: localhost - database_name: proyecto_de_prueba - database_user: nombre_de_usuario - database_password: password - - # ... - -.. note:: - - Definir la configuración a través de :file:`parameters.yml` sólo es una convención. - Los parámetros definidos en este archivo son referidos en el archivo de configuración principal al configurar *Doctrine*: - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - dbal: - driver: "%database_driver%" - host: "%database_host%" - dbname: "%database_name%" - user: "%database_user%" - password: "%database_password%" - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $configuration->loadFromExtension('doctrine', array( - 'dbal' => array( - 'driver' => '%database_driver%', - 'host' => '%database_host%', - 'dbname' => '%database_name%', - 'user' => '%database_user%', - 'password' => '%database_password%', - ), - )); - - Al separar la información de la base de datos en un archivo independiente, puedes mantener fácilmente diferentes versiones del archivo en cada servidor. Además, fácilmente puedes almacenar la configuración de la base de datos (o cualquier otra información sensible) fuera de tu proyecto, posiblemente dentro de tu configuración de *Apache*, por ejemplo. Para más información, consulta :doc:`/cookbook/configuration/external_parameters`. - -Ahora que *Doctrine* conoce tu base de datos, posiblemente tenga que crear la base de datos para ti: - -.. code-block:: bash - - $ php app/console doctrine:database:create - -.. sidebar:: Configura la base de datos para que sea *UTF8* - - Una equivocación en la cual caen incluso los desarrolladores más experimentados cuándo empiezan un proyecto *Symfony2* es olvidar configurar el código de caracteres y cotejamiento en su base de datos, terminando con cotejamientos de tipo latin, los cuales están predefinidos en la mayoría de las bases de datos. - Incluso podrían recordar hacerlo al principio, pero olvidan que todo esto se hace después de ejecutar una orden relativamente común durante el desarrollo: - - .. code-block:: bash - - $ php app/console doctrine:database:drop --force - $ php app/console doctrine:database:create - - No hay manera de configurar estos valores predeterminados dentro de *Doctrine*, ya que trata de ser lo más agnóstica posible en términos de configuración del entorno. Una manera de resolver este problema consiste en configurar el nivel predeterminado del servidor. - - La configuración predefinida UTF8 para *MySQL* es tan simple como añadir unas cuantas líneas a tu archivo de configuración (generalmente ``my.cnf``): - - .. code-block:: yaml - - [mysqld] - collation-server = utf8_general_ci - character-set-server = utf8 - -.. note:: - - Si quieres usar ``SQLite`` como tu base de datos, debes especificar la ruta a donde se debería almacenar tu archivo de base de datos: - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - dbal: - driver: pdo_sqlite - path: "%kernel.root_dir%/sqlite.db" - charset: UTF8 - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'driver' => 'pdo_sqlite', - 'path' => '%kernel.root_dir%/sqlite.db', - 'charset' => 'UTF-8', - ), - )); - -Creando una clase Entidad -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Supongamos que estás construyendo una aplicación donde necesitas mostrar tus productos. -Sin siquiera pensar en *Doctrine* o en una base de datos, ya sabes que necesitas un objeto ``Producto`` para representar los productos. Crea esta clase en el directorio ``Entity`` de tu paquete ``AcmeStoreBundle``:: - - // src/Acme/StoreBundle/Entity/Product.php - namespace Acme\StoreBundle\Entity; - - class Product - { - protected $name; - - protected $price; - - protected $description; - } - -La clase ---a menudo llamada «entidad», es decir, *una clase básica que contiene datos*--- es simple y ayuda a cumplir con el requisito del negocio de productos que necesita tu aplicación. Sin embargo, esta clase no se puede guardar en una base de datos ---es sólo una clase *PHP* simple. - -.. tip:: - - Una vez que aprendas los conceptos detrás de *Doctrine*, puedes dejar que *Doctrine* cree clases de entidad simples por ti: - - .. code-block:: bash - - $ php app/console doctrine:generate:entity --entity="AcmeStoreBundle:Product" --fields="name:string(255) price:float description:text" - -.. index:: - single: Doctrine; Agregando metadatos de asociación - -.. _book-doctrine-adding-mapping: - -Agregando información de asignación -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Doctrine* te permite trabajar con bases de datos de una manera mucho más interesante que solo recuperar filas de una tabla basada en columnas de un arreglo. En cambio, *Doctrine* te permite persistir *objetos* completos a la base de datos y recuperar objetos completos desde la base de datos. Esto funciona asociando una clase *PHP* a una tabla de la base de datos, y las propiedades de esa clase *PHP* a las columnas de la tabla: - -.. image:: /images/book/doctrine_image_1_es.png - :align: center - -Para que *Doctrine* sea capaz de hacer esto, sólo hay que crear «metadatos», o la configuración que le dice a *Doctrine* exactamente cómo debe *asociar* la clase ``Producto`` y sus propiedades a la base de datos. Estos metadatos se pueden especificar en una serie de diferentes formatos, incluyendo *YAML*, *XML* o directamente dentro de la clase ``Producto`` a través de anotaciones: - -.. configuration-block:: - - .. code-block:: php-annotations - - // src/Acme/StoreBundle/Entity/Product.php - namespace Acme\StoreBundle\Entity; - - use Doctrine\ORM\Mapping as ORM; - - /** - * @ORM\Entity - * @ORM\Table(name="product") - */ - class Product - { - /** - * @ORM\Id - * @ORM\Column(type="integer") - * @ORM\GeneratedValue(strategy="AUTO") - */ - protected $id; - - /** - * @ORM\Column(type="string", length=100) - */ - protected $name; - - /** - * @ORM\Column(type="decimal", scale=2) - */ - protected $price; - - /** - * @ORM\Column(type="text") - */ - protected $description; - } - - .. code-block:: yaml - - # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml - Acme\StoreBundle\Entity\Product: - type: entity - table: product - id: - id: - type: integer - generator: { strategy: AUTO } - fields: - name: - type: string - length: 100 - price: - type: decimal - scale: 2 - description: - type: text - - .. code-block:: xml - - - - - - - - - - - - - - -.. note:: - - Un paquete sólo puede aceptar un formato para definir metadatos. Por ejemplo, no es posible mezclar metadatos para la clase Entidad definidos en *YAML* con definidos en anotaciones *PHP*. - -.. tip:: - - El nombre de la tabla es opcional y si la omites, será determinada automáticamente basándose en el nombre de la clase entidad. - -*Doctrine* te permite elegir entre una amplia variedad de diferentes tipos de campo, cada uno con sus propias opciones. Para obtener información sobre los tipos de campo disponibles, consulta la sección :ref:`book-doctrine-field-types`. - -.. seealso:: - - También puedes consultar la `Documentación de asociación básica`_ de *Doctrine* para todos los detalles sobre la información de asignación. Si utilizas anotaciones, tendrás que prefijar todas las anotaciones con ``ORM\`` (por ejemplo, ``ORM\Column(..)``), lo cual no se muestra en la documentación de *Doctrine*. También tendrás que incluir la declaración ``use Doctrine\ORM\Mapping as ORM;`` la cual *importa* el prefijo ``ORM`` de las anotaciones. - -.. caution:: - - Ten cuidado de que tu nombre de clase y propiedades no estén asignados a un área protegida por palabras clave de *SQL* (tal como ``group`` o ``user``). Por ejemplo, si el nombre de clase de tu entidad es ``group``, entonces, de manera predeterminada, el nombre de la tabla será ``group``, lo cual provocará un error en algunos motores *SQL*. Consulta la `Documentación de palabras clave reservadas por SQL`_ para que sepas cómo escapar correctamente estos nombres. Alternativamente, si estás en libertad de elegir el esquema de tu base de datos, simplemente asigna un diferente nombre de tabla o columna. Ve las `Clases persistentes`_ y la `Asignación de propiedades`_ en la documentación de *Doctrine*. - -.. note:: - - Cuando utilizas otra biblioteca o programa (es decir, *Doxygen*) que utiliza anotaciones, debes colocar la anotación ``@IgnoreAnnotation`` en la clase para indicar que se deben ignorar las anotaciones *Symfony*. - - Por ejemplo, para evitar que la anotación ``@fn`` lance una excepción, añade lo siguiente:: - - /** - * @IgnoreAnnotation("fn") - */ - class Product - // ... - -Generando captadores y definidores -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A pesar de que *Doctrine* ahora sabe cómo persistir en la base de datos un objeto ``Producto``, la clase en sí realmente no es útil todavía. Puesto que ``Producto`` es sólo una clase *PHP* regular, es necesario crear métodos captadores y definidores (por ejemplo, ``getName()``, ``setName()``) para poder acceder a sus propiedades (ya que las propiedades son ``protegidas``). Afortunadamente, *Doctrine* puede hacer esto por ti con la siguiente orden: - -.. code-block:: bash - - $ php app/console doctrine:generate:entities Acme/StoreBundle/Entity/Product - -Esta orden se asegura de que se generen todos los captadores y definidores para la clase ``Producto``. Esta es una orden segura --- la puedes ejecutar una y otra vez: sólo genera captadores y definidores que no existen (es decir, no sustituye métodos existentes). - -.. caution:: - - Ten en cuenta que el generador de entidades de *Doctrine* produce captadores/definidores sencillos. - Debes revisar las entidades generadas y ajustar a tus propias necesidades la lógica de los captadores/definidores. - -.. sidebar:: Más sobre ``doctrine:generate:entities`` - - con la orden ``doctrine:generate:entities`` puedes: - - * generar captadores y definidores; - - * generar clases repositorio configuradas con la anotación ``@ORM\Entity(repositoryClass="...")``, - - * generar el constructor adecuado para relaciones ``1:n`` y ``n:m``. - - La orden ``doctrine:generate:entities`` guarda una copia de seguridad del :file:`Producto.php` original llamada :file:`Producto.php~`. En algunos casos, la presencia de este archivo puede provocar un error «No se puede redeclarar la clase». Lo puedes quitar sin problemas. - - Ten en cuenta que no *necesitas* usar esta orden. *Doctrine* no se basa en la generación de código. Al igual que con las clases de *PHP* normales, sólo tienes que asegurarte de que sus propiedades protegidas/privadas tienen métodos captadores y definidores. - Puesto que cuando utilizas *Doctrine* es algo que tienes que hacer comúnmente, se creó esta orden. - -También puedes generar todas las entidades conocidas (es decir, cualquier clase *PHP* con información de asignación *Doctrine*) de un paquete o un espacio de nombres completo: - -.. code-block:: bash - - $ php app/console doctrine:generate:entities AcmeStoreBundle - $ php app/console doctrine:generate:entities Acme - -.. note:: - - A *Doctrine* no le importa si tus propiedades son ``protegidas`` o ``privadas``, o si una propiedad tiene o no una función captadora o definidora. - Aquí, los captadores y definidores se generan sólo porque los necesitarás para interactuar con tu objeto *PHP*. - -Creando tablas/esquema de la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora tienes una clase ``Producto`` utilizable con información de asignación de modo que *Doctrine* sabe exactamente cómo persistirla. Por supuesto, en tu base de datos aún no tienes la tabla ``producto`` correspondiente. Afortunadamente, *Doctrine* puede crear automáticamente todas las tablas de la base de datos necesarias para cada entidad conocida en tu aplicación. Para ello, ejecuta: - -.. code-block:: bash - - $ php app/console doctrine:schema:update --force - -.. tip:: - - En realidad, esta orden es increíblemente poderosa. Esta compara cómo se *debe* ver tu base de datos (en base a la información de asignación de tus entidades) con la forma en que *realmente* se ve, y genera las declaraciones *SQL* necesarias para *actualizar* la base de datos a su verdadera forma. En otras palabras, si agregas una nueva propiedad asignando metadatos a ``Producto`` y ejecutas esta tarea de nuevo, vas a generar la declaración ``alter table`` necesaria para añadir la nueva columna a la tabla ``Producto`` existente. - - Una forma aún mejor para tomar ventaja de esta funcionalidad es a través de las :doc:`migraciones `, las cuales te permiten generar estas instrucciones *SQL* y almacenarlas en las clases de la migración, mismas que puedes ejecutar sistemáticamente en tu servidor en producción con el fin de seguir la pista y migrar el esquema de la base de datos segura y fiablemente. - -Tu base de datos ahora cuenta con una tabla ``producto`` completamente operativa, con columnas que coinciden con los metadatos que has especificado. - -Persistiendo objetos a la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora que tienes asignada una entidad ``Producto`` y la tabla ``Producto`` correspondiente, estás listo para persistir los datos a la base de datos. Desde el interior de un controlador, esto es bastante fácil. Agrega el siguiente método al ``DefaultController`` del paquete: - -.. code-block:: php - :linenos: - - // src/Acme/StoreBundle/Controller/DefaultController.php - - // ... - use Acme\StoreBundle\Entity\Product; - use Symfony\Component\HttpFoundation\Response; - - public function createAction() - { - $product = new Product(); - $product->setName('A Foo Bar'); - $product->setPrice('19.99'); - $product->setDescription('Lorem ipsum dolor'); - - $em = $this->getDoctrine()->getManager(); - $em->persist($product); - $em->flush(); - - return new Response('Created product id '.$product->getId()); - } - -.. note:: - - Si estás siguiendo este ejemplo, tendrás que crear una ruta que apunte a esta acción para verla trabajar. - -Veamos detenidamente el ejemplo anterior: - -* **líneas 9-12** En esta sección, creas una instancia y trabajas con el objeto ``$product`` como con cualquier otro objeto *PHP* normal. - -* **línea 14** Esta línea consigue un objeto *gestor de entidades* de *Doctrine*, el cual es responsable de manejar el proceso de persistir y recuperar objetos hacia y desde la base de datos. - -* **línea 15** El método ``persist()`` dice a *Doctrine* que «maneje» el objeto ``$product``. Esto en realidad no provoca una consulta que se deba introducir en la base de datos (todavía). - -* **línea 16** Cuando se llama al método ``flush()``, *Doctrine* examina todos los objetos que está gestionando para ver si es necesario persistirlos en la base de datos. En este ejemplo, el objeto ``$product`` aún no se ha persistido, por lo tanto el gestor de la entidad ejecuta una consulta ``INSERT`` y crea una fila en la tabla ``producto``. - -.. note:: - - De hecho, ya que *Doctrine* es consciente de todas tus entidades gestionadas, cuando se llama al método ``flush()``, calcula el conjunto de cambios y ejecuta la(s) consulta(s) más eficiente(s) posible(s). Por ejemplo, si persistes un total de 100 objetos ``Producto`` y, posteriormente llamas a ``flush()``, *Doctrine* creará una *sola* declaración preparada y la volverá a utilizar en cada inserción. Este patrón se conoce como *Unidad de trabajo*, y se usa porque es rápido y eficiente. - -Al crear o actualizar objetos, el flujo de trabajo siempre es el mismo. En la siguiente sección, verás cómo *Doctrine* es lo suficientemente inteligente como para emitir automáticamente una consulta *UPDATE* si el registro ya existe en la base de datos. - -.. tip:: - - *Doctrine* proporciona una biblioteca que te permite cargar en tu proyecto mediante programación los datos de prueba (es decir, «datos accesorios»). Para más información, consulta :doc:`/bundles/DoctrineFixturesBundle/index`. - -Recuperando objetos desde la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Recuperar un objeto desde la base de datos es aún más fácil. Por ejemplo, supongamos que has configurado una ruta para mostrar un ``Producto`` específico en función del valor de su ``id``:: - - public function showAction($id) - { - $product = $this->getDoctrine() - ->getRepository('AcmeStoreBundle:Product') - ->find($id); - - if (!$product) { - throw $this->createNotFoundException( - 'No product found for id '.$id - ); - } - - // ... haz algo, como pasar el objeto $product a una plantilla - } - -.. tip:: - - Puedes conseguir el equivalente de este sin escribir ningún código utilizando el método abreviado ``@ParamConverter``. Consulta la documentación del :doc:`FrameworkExtraBundle ` para más detalles. - -Al consultar un determinado tipo de objeto, siempre utiliza lo que se conoce como «repositorio». Puedes pensar en un repositorio como una clase *PHP*, cuyo único trabajo consiste en ayudarte a buscar las entidades de una determinada clase. Puedes acceder al objeto ``repositorio`` de una clase ``entidad`` a través de:: - - $repository = $this->getDoctrine() - ->getRepository('AcmeStoreBundle:Product'); - -.. note:: - - La cadena ``AcmeStoreBundle:Product`` es un método abreviado que puedes utilizar en cualquier lugar de *Doctrine* en lugar del nombre de clase completo de la entidad (es decir, ``Acme\StoreBundle\Entity\Product``). - Mientras que tu entidad viva bajo el espacio de nombres ``Entity`` de tu paquete, esto debe funcionar. - -Una vez que tengas tu repositorio, tienes acceso a todo tipo de útiles métodos:: - - // consulta por la clave principal (generalmente 'id') - $product = $repository->find($id); - - // nombres dinámicos de métodos para buscar un valor basad en columna - $product = $repository->findOneById($id); - $product = $repository->findOneByName('foo'); - - // recupera TODOS los productos - $products = $repository->findAll(); - - // busca un grupo de productos basándose en el valor de una columna arbitraria - $products = $repository->findByPrice(19.99); - -.. note:: - - Por supuesto, también puedes realizar consultas complejas, acerca de las cuales aprenderás más en la sección :ref:`book-doctrine-queries`. - -También puedes tomar ventaja de los útiles métodos ``findBy`` y ``findOneBy`` para recuperar objetos fácilmente basándote en varias condiciones:: - - // consulta por un producto que coincide en nombre y precio - $product = $repository->findOneBy(array('name' => 'foo', - 'price' => 19.99)); - - // consulta para todos los productos que emparejen el nombre, ordenados por precio - $products = $repository->findBy( - array('name' => 'foo'), - array('price' => 'ASC') - ); - -.. tip:: - - Cuando reproduces una página, puedes ver, en la esquina inferior derecha de la barra de herramientas de depuración web, cuántas consultas se realizaron. - - .. image:: /images/book/doctrine_web_debug_toolbar_es.png - :align: center - :scale: 75 - :width: 350 - - Si haces clic en el icono, se abrirá el generador de perfiles, mostrando las consultas exactas que se hicieron. - -Actualizando un objeto -~~~~~~~~~~~~~~~~~~~~~~ - -Una vez que hayas extraído un objeto de *Doctrine*, actualizarlo es relativamente fácil. Supongamos que tienes una ruta que asigna un identificador de producto a una acción de actualización de un controlador:: - - public function updateAction($id) - { - $em = $this->getDoctrine()->getManager(); - $product = $em->getRepository('AcmeStoreBundle:Product')->find($id); - - if (!$product) { - throw $this->createNotFoundException( - 'No product found for id '.$id - ); - } - - $product->setName('New product name!'); - $em->flush(); - - return $this->redirect($this->generateUrl('homepage')); - } - -La actualización de un objeto únicamente consta de tres pasos: - -#. Recuperar el objeto desde *Doctrine*; -#. Modificar el objeto; -#. Invocar a ``flush()`` en el gestor de la entidad; - -Ten en cuenta que no es necesario llamar a ``$em->persist($product)``. Recuerda que este método simplemente dice a *Doctrine* que procese o «vea» el objeto ``$product``. -En este caso, ya que recuperaste el objeto ``$product`` desde *Doctrine*, este ya está gestionado. - -Eliminando un objeto -~~~~~~~~~~~~~~~~~~~~ - -Eliminar un objeto es muy similar, pero requiere una llamada al método ``remove()`` del gestor de la entidad:: - - $em->remove($product); - $em->flush(); - -Como es de esperar, el método ``remove()`` notifica a *Doctrine* que deseas eliminar la entidad de la base de datos. La consulta *DELETE* real, sin embargo, no se ejecuta efectivamente hasta que se invoca al método ``flush()``. - -.. _`book-doctrine-queries`: - -Consultando por objetos ------------------------ - -Ya has visto cómo el objeto ``repositorio`` te permite ejecutar consultas básicas sin ningún trabajo:: - - $repository->find($id); - - $repository->findOneByName('Foo'); - -Por supuesto, *Doctrine* también te permite escribir consultas más complejas utilizando el lenguaje de consulta *Doctrine* (*DQL* por *Doctrine Query Language*). *DQL* es similar a *SQL*, excepto que debes imaginar que estás consultando por uno o más objetos de una clase entidad (por ejemplo, ``Producto``) en lugar de consultar por filas de una tabla (por ejemplo, ``producto``). - -Al consultar en *Doctrine*, tienes dos opciones: escribir consultas *Doctrine* puras o utilizar el generador de consultas de *Doctrine*. - -Consultando objetos con *DQL* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Imagina que deseas consultar los productos, pero sólo quieres devolver aquellos que cuestan más de ``19.99``, ordenados del más barato al más caro. Desde el interior de un controlador, haz lo siguiente:: - - $em = $this->getDoctrine()->getManager(); - $query = $em->createQuery( - 'SELECT p FROM AcmeStoreBundle:Product p WHERE p.price > :price ORDER BY p.price ASC' - )->setParameter('price', '19.99'); - - $products = $query->getResult(); - -Si te sientes cómodo con *SQL*, entonces debes sentir a *DQL* muy natural. La más grande diferencia es que necesitas pensar en términos de «objetos» en lugar de filas de una base de datos. Por esta razón, seleccionas *from* ``AcmeStoreBundle:Product`` y luego lo apodas ``p``. - -El método ``getResult()`` devuelve un arreglo de resultados. Si estás preguntando por un solo objeto, en su lugar puedes utilizar el método ``getSingleResult()``:: - - $product = $query->getSingleResult(); - -.. caution:: - - El método ``getSingleResult()`` lanza una excepción ``Doctrine\ORM\NoResultException`` si no se devuelven resultados y una ``Doctrine\ORM\NonUniqueResultException`` si se devuelve *más* de un resultado. Si utilizas este método, posiblemente tengas que envolverlo en un bloque ``try-catch`` y asegurarte de que sólo devuelve un resultado (si estás consultando sobre algo que sea viable podrías regresar más de un resultado):: - - $query = $em->createQuery('SELECT ...') - ->setMaxResults(1); - - try { - $product = $query->getSingleResult(); - } catch (\Doctrine\Orm\NoResultException $e) { - $product = null; - } - // ... - -La sintaxis *DQL* es increíblemente poderosa, permitiéndote unir entidades fácilmente (el tema de las :ref:`relaciones ` se describe más adelante), agrupación, etc. Para más información, consulta la documentación oficial de `Doctrine Query Language`_. - -.. sidebar:: Configurando parámetros - - Toma nota del método ``setParameter()``. Al trabajar con *Doctrine*, siempre es buena idea establecer cualquier valor externo como «marcador de posición», tal cómo se hizo en la consulta anterior: - - .. code-block:: text - - ... WHERE p.price > :price ... - - Entonces, puedes establecer el valor del marcador de posición ``price`` llamando al método ``setParameter()``:: - - ->setParameter('price', '19.99') - - Utilizar parámetros en lugar de colocar los valores directamente en la cadena de consulta, se hace para prevenir ataques de inyección *SQL* y *siempre* se debe hacer. - Si estás utilizando varios parámetros, puedes establecer simultáneamente sus valores usando el método ``setParameters()``:: - - ->setParameters(array( - 'price' => '19.99', - 'name' => 'Foo', - )) - -Usando el generador de consultas de *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En lugar de escribir las consultas directamente, también puedes usar el ``QueryBuilder`` de *Doctrine* para hacer el mismo trabajo con una agradable interfaz orientada a objetos. -Si usas un *IDE*, también puedes tomar ventaja del autocompletado a medida que escribes los nombres de método. Desde el interior de un controlador:: - - $repository = $this->getDoctrine() - ->getRepository('AcmeStoreBundle:Product'); - - $query = $repository->createQueryBuilder('p') - ->where('p.price > :price') - ->setParameter('price', '19.99') - ->orderBy('p.price', 'ASC') - ->getQuery(); - - $products = $query->getResult(); - -El objeto ``QueryBuilder`` contiene todos los métodos necesarios para construir tu consulta. Al invocar al método ``getQuery()``, el generador de consultas devuelve un objeto ``Query`` normal, el cual es el mismo objeto que construiste directamente en la sección anterior. - -Para más información sobre el generador de consultas de *Doctrine*, consulta la documentación del `Generador de consultas`_ de *Doctrine*. - -Repositorio de clases personalizado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En las secciones anteriores, comenzamos a construir y utilizar consultas más complejas desde el interior de un controlador. Con el fin de aislar, probar y volver a usar estas consultas, es buena idea crear una clase ``repositorio`` personalizada para tu ``entidad`` y agregar métodos con tu lógica de consulta allí. - -Para ello, agrega el nombre de la clase del repositorio a la definición de asignación. - -.. configuration-block:: - - .. code-block:: php-annotations - - // src/Acme/StoreBundle/Entity/Product.php - namespace Acme\StoreBundle\Entity; - - use Doctrine\ORM\Mapping as ORM; - - /** - * @ORM\Entity(repositoryClass="Acme\StoreBundle\Entity\ProductRepository") - */ - class Product - { - //... - } - - .. code-block:: yaml - - # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml - Acme\StoreBundle\Entity\Product: - type: entity - repositoryClass: Acme\StoreBundle\Entity\ProductRepository - # ... - - .. code-block:: xml - - - - - - - - - - - -*Doctrine* puede generar la clase ``repositorio`` por ti ejecutando la misma orden usada anteriormente para generar los métodos captadores y definidores omitidos: - -.. code-block:: bash - - $ php app/console doctrine:generate:entities Acme - -A continuación, agrega un nuevo método --- ``findAllOrderedByName()`` --- a la clase repositorio recién generada. Este método debe consultar todas las entidades ``Producto``, ordenadas alfabéticamente. - -.. code-block:: php - - // src/Acme/StoreBundle/Entity/ProductRepository.php - namespace Acme\StoreBundle\Entity; - - use Doctrine\ORM\EntityRepository; - - class ProductRepository extends EntityRepository - { - public function findAllOrderedByName() - { - return $this->getEntityManager() - ->createQuery('SELECT p FROM AcmeStoreBundle:Product p ORDER BY p.name ASC') - ->getResult(); - } - } - -.. tip:: - - Puedes acceder al gestor de la entidad a través de ``$this->getEntityManager()`` desde el interior del repositorio. - -Puedes utilizar este nuevo método al igual que los métodos de búsqueda predefinidos del repositorio:: - - $em = $this->getDoctrine()->getManager(); - $products = $em->getRepository('AcmeStoreBundle:Product') - ->findAllOrderedByName(); - -.. note:: - - Al utilizar una clase repositorio personalizada, todavía tienes acceso a los métodos de búsqueda predeterminados como ``find()`` y ``findAll()``. - -.. _`book-doctrine-relations`: - -Entidad relaciones/asociaciones -------------------------------- - -Supón que los productos en tu aplicación pertenecen exactamente a una ``«categoría»``. -En este caso, necesitarás un objeto ``Categoría`` y una manera de relacionar un objeto ``Producto`` a un objeto ``Categoría``. Empieza por crear la entidad ``Categoría``. -Ya sabes que tarde o temprano tendrás que persistir la clase a través de *Doctrine*, puedes dejar que *Doctrine* cree la clase por ti. - -.. code-block:: bash - - $ php app/console doctrine:generate:entity --entity="AcmeStoreBundle:Category" --fields="name:string(255)" - -Esta tarea genera la entidad ``Categoría`` para ti, con un campo ``id``, un campo ``name`` y las funciones captadoras y definidoras asociadas. - -Relación con la asignación de metadatos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para relacionar las entidades ``Categoría`` y ``Producto``, empieza por crear una propiedad ``productos`` en la clase ``Categoría``: - -.. configuration-block:: - - .. code-block:: php-annotations - - // src/Acme/StoreBundle/Entity/Category.php - - // ... - use Doctrine\Common\Collections\ArrayCollection; - - class Category - { - // ... - - /** - * @ORM\OneToMany(targetEntity="Product", mappedBy="category") - */ - protected $products; - - public function __construct() - { - $this->products = new ArrayCollection(); - } - } - - .. code-block:: yaml - - # src/Acme/StoreBundle/Resources/config/doctrine/Category.orm.yml - Acme\StoreBundle\Entity\Category: - type: entity - # ... - oneToMany: - products: - targetEntity: Product - mappedBy: category - # no olvides iniciar la colección en el método __construct() de la entidad - - .. code-block:: xml - - - - - - - - - - - - -En primer lugar, ya que un objeto ``Categoría`` debe relacionar muchos objetos ``Producto``, agregamos una propiedad ``Productos`` para contener esos objetos ``Producto``. -Una vez más, esto no se hace porque lo necesite *Doctrine*, sino porque tiene sentido en la aplicación para que cada ``Categoría`` mantenga una gran variedad de objetos ``Producto``. - -.. note:: - - El código del método ``__construct()`` es importante porque *Doctrine* requiere que la propiedad ``$products`` sea un objeto ``ArrayCollection``. - Este objeto se ve y actúa casi *exactamente* como un arreglo, pero tiene cierta flexibilidad. Si esto te hace sentir incómodo, no te preocupes. Sólo imagina que es un ``arreglo`` y estarás bien. - -.. tip:: - - El valor de ``targetEntity`` en el decorador utilizado anteriormente puede hacer referencia a cualquier entidad con un espacio de nombres válido, no sólo a las entidades definidas en la misma clase. Para relacionarlo con una entidad definida en una clase o paquete diferente, escribe un espacio de nombres completo como la ``targetEntity``. - -Después, ya que cada clase ``Producto`` se puede relacionar exactamente a un objeto ``Categoría``, podrías desear agregar una propiedad ``$category`` a la clase ``Producto``: - -.. configuration-block:: - - .. code-block:: php-annotations - - // src/Acme/StoreBundle/Entity/Product.php - - // ... - class Product - { - // ... - - /** - * @ORM\ManyToOne(targetEntity="Category", inversedBy="products") - * @ORM\JoinColumn(name="category_id", referencedColumnName="id") - */ - protected $category; - } - - .. code-block:: yaml - - # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml - Acme\StoreBundle\Entity\Product: - type: entity - # ... - manyToOne: - category: - targetEntity: Category - inversedBy: products - joinColumn: - name: category_id - referencedColumnName: id - - .. code-block:: xml - - - - - - - - - - - - -Por último, ahora que agregaste una nueva propiedad a ambas clases ``Categoría`` y ``Producto``, le dices a *Doctrine* que genere por ti los métodos captadores y definidores omitidos: - -.. code-block:: bash - - $ php app/console doctrine:generate:entities Acme - -No hagas caso de los metadatos de *Doctrine* por un momento. Ahora tienes dos clases ---``Categoría`` y ``Producto``--- con una relación natural de uno a muchos. La clase ``Categoría`` tiene un arreglo de objetos ``Producto`` y el objeto ``producto`` puede contener un objeto ``Categoría``. En otras palabras, construiste tus clases de una manera que tiene sentido para tus necesidades. El hecho de que los datos se tienen que persistir en una base de datos, siempre es secundario. - -Ahora, veamos los metadatos sobre la propiedad ``$category`` en la clase ``Producto``. Esta información le dice a *Doctrine* que la clase está relacionada con ``Categoría`` y que debe guardar el ``id`` del registro de la categoría en un campo ``category_id`` que vive en la tabla ``producto``. En otras palabras, el objeto ``Categoría`` relacionado se almacenará en la propiedad ``$category``, pero tras bambalinas, *Doctrine* deberá persistir esta relación almacenando el valor del ``id`` de la categoría en una columna ``category_id`` de la tabla ``producto``. - -.. image:: /images/book/doctrine_image_2_es.png - :align: center - -Los metadatos sobre la propiedad ``$products`` del objeto ``Categoría`` son menos importantes, y simplemente dicen a *Doctrine* que vea la propiedad ``Product.category`` para resolver cómo se asigna la relación. - -Antes de continuar, asegúrate de decirle a *Doctrine* que agregue la nueva tabla ``categoría``, la columna ``product.category_id`` y la nueva clave externa: - -.. code-block:: bash - - $ php app/console doctrine:schema:update --force - -.. note:: - - Esta tarea sólo la deberías utilizar durante el desarrollo. Para un más robusto método de actualización sistemática de tu base de datos en producción, lee sobre las :doc:`Migraciones de Doctrine `. - -Guardando entidades relacionadas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora, ¡puedes ver este nuevo código en acción! Imagina que estás dentro de un controlador:: - - // ... - - use Acme\StoreBundle\Entity\Category; - use Acme\StoreBundle\Entity\Product; - use Symfony\Component\HttpFoundation\Response; - - class DefaultController extends Controller - { - public function createProductAction() - { - $category = new Category(); - $category->setName('Main Products'); - - $product = new Product(); - $product->setName('Foo'); - $product->setPrice(19.99); - // relaciona este producto a la categoría - $product->setCategory($category); - - $em = $this->getDoctrine()->getManager(); - $em->persist($category); - $em->persist($product); - $em->flush(); - - return new Response( - 'Created product id: '.$product->getId().' and category id: '.$category->getId() - ); - } - } - -Ahora, se agrega una sola fila a las tablas ``categoría`` y ``producto``. -La columna ``product.category_id`` para el nuevo producto se ajusta a algún ``id`` de la nueva categoría. *Doctrine* gestiona la persistencia de esta relación para ti. - -Recuperando objetos relacionados -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando necesites recuperar objetos asociados, tu flujo de trabajo se ve justo como lo hacías antes. En primer lugar, buscas un objeto ``$product`` y luego accedes a su ``Categoría`` asociada:: - - public function showAction($id) - { - $product = $this->getDoctrine() - ->getRepository('AcmeStoreBundle:Product') - ->find($id); - - $categoryName = $product->getCategory()->getName(); - - // ... - } - -En este ejemplo, primero consultas por un objeto ``Producto`` basándote en el ``id`` del producto. Este emite una consulta *solo* para los datos del producto e hidrata al objeto ``$product`` con esos datos. Más tarde, cuando llames a ``$product->getCategory()->getName()``, *Doctrine* silenciosamente hace una segunda consulta para encontrar la ``Categoría`` que está relacionada con este ``Producto``. Entonces, prepara el objeto ``$category`` y te lo devuelve. - -.. image:: /images/book/doctrine_image_3_es.png - :align: center - -Lo importante es el hecho de que tienes fácil acceso a la categoría relacionada con el producto, pero, los datos de la categoría realmente no se recuperan hasta que pides la categoría (es decir, trata de «cargarlos de manera diferida»). - -También puedes consultar en la dirección contraria:: - - public function showProductAction($id) - { - $category = $this->getDoctrine() - ->getRepository('AcmeStoreBundle:Category') - ->find($id); - - $products = $category->getProducts(); - - // ... - } - -En este caso, ocurre lo mismo: primero consultas por un único objeto ``Categoría``, y luego *Doctrine* hace una segunda consulta para recuperar los objetos ``Producto`` relacionados, pero sólo una vez/si le preguntas por ellos (es decir, cuando invoques a ``->getProducts()``). -La variable ``$products`` es un arreglo de todos los objetos ``Producto`` relacionados con el objeto ``Categoría`` propuesto a través de sus valores ``category_id``. - -.. sidebar:: Relaciones y clases delegadas - - Esta «carga diferida» es posible porque, cuando sea necesario, *Doctrine* devuelve un objeto «delegado» en lugar del verdadero objeto. Veamos de nuevo el ejemplo anterior:: - - $product = $this->getDoctrine() - ->getRepository('AcmeStoreBundle:Product') - ->find($id); - - $category = $product->getCategory(); - - // imprime 'Proxies\AcmeStoreBundleEntityCategoryProxy' - echo get_class($category); - - Este objeto delegado extiende al verdadero objeto ``Categoría``, y se ve y actúa exactamente igual que él. La diferencia es que, al usar un objeto delegado, *Doctrine* puede retrasar la consulta de los datos reales de ``Categoría`` hasta que efectivamente se necesiten esos datos (por ejemplo, hasta que invoques a ``$category->getName()``). - - Las clases delegadas las genera *Doctrine* y se almacenan en el directorio :file:`cache`. - Y aunque probablemente nunca te des cuenta de que tu objeto ``$category`` en realidad es un objeto delegado, es importante tenerlo en cuenta. - - En la siguiente sección, al recuperar simultáneamente los datos del producto y la categoría (a través de una *unión*), *Doctrine* devolverá el *verdadero* objeto ``Categoría``, puesto que nada se tiene que cargar de forma diferida. - -Uniendo registros relacionados -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En los ejemplos anteriores, se realizaron dos consultas ---una para el objeto original (por ejemplo, una ``Categoría``)--- y otra para el/los objetos relacionados (por ejemplo, los objetos ``Producto``). - -.. tip:: - - Recuerda que puedes ver todas las consultas realizadas durante una petición a través de la barra de herramientas de depuración web. - -Por supuesto, si sabes por adelantado que necesitas tener acceso a los objetos, puedes evitar la segunda consulta emitiendo una unión en la consulta original. Agrega el siguiente método a la clase ``ProductRepository``:: - - // src/Acme/StoreBundle/Entity/ProductRepository.php - public function findOneByIdJoinedToCategory($id) - { - $query = $this->getEntityManager() - ->createQuery(' - SELECT p, c FROM AcmeStoreBundle:Product p - JOIN p.category c - WHERE p.id = :id' - )->setParameter('id', $id); - - try { - return $query->getSingleResult(); - } catch (\Doctrine\ORM\NoResultException $e) { - return null; - } - } - -Ahora, puedes utilizar este método en el controlador para consultar un objeto ``Producto`` y su correspondiente ``Categoría`` con una sola consulta:: - - public function showAction($id) - { - $product = $this->getDoctrine() - ->getRepository('AcmeStoreBundle:Product') - ->findOneByIdJoinedToCategory($id); - - $category = $product->getCategory(); - - // ... - } - -Más información sobre asociaciones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Esta sección ha sido una introducción a un tipo común de relación entre entidades, la relación uno a muchos. Para obtener detalles más avanzados y ejemplos de cómo utilizar otros tipos de relaciones (por ejemplo, ``uno a uno``, ``muchos a muchos``), consulta la sección `Asignando asociaciones`_ en la documentación de *Doctrine*. - -.. note:: - - Si estás utilizando anotaciones, tendrás que prefijar todas las anotaciones con ``ORM\`` (por ejemplo, ``ORM\OneToMany``), lo cual no se refleja en la documentación de *Doctrine*. También tendrás que incluir la declaración ``use Doctrine\ORM\Mapping as ORM;`` la cual *importa* el prefijo ``ORM`` de las anotaciones. - -Configurando ------------- - -*Doctrine* es altamente configurable, aunque probablemente nunca tendrás que preocuparte de la mayor parte de sus opciones. Para más información sobre la configuración de *Doctrine*, consulta la sección *Doctrine* del :doc:`Manual de referencia `. - -Ciclo de vida de las retrollamadas ----------------------------------- - -A veces, es necesario realizar una acción justo antes o después de insertar, actualizar o eliminar una entidad. Este tipo de acciones se conoce como «ciclo de vida» de las retrollamadas, ya que son métodos retrollamados que necesitas ejecutar durante las diferentes etapas del ciclo de vida de una entidad (por ejemplo, cuando la entidad es insertada, actualizada, eliminada, etc.) - -Si estás utilizando anotaciones para los metadatos, empieza por permitir el ciclo de vida de las retrollamadas. Esto no es necesario si estás usando *YAML* o *XML* para tu asignación: - -.. code-block:: php-annotations - - /** - * @ORM\Entity() - * @ORM\HasLifecycleCallbacks() - */ - class Product - { - // ... - } - -Ahora, puedes decir a *Doctrine* que ejecute un método en cualquiera de los eventos del ciclo de vida disponibles. Por ejemplo, supongamos que deseas establecer una columna de fecha ``created`` a la fecha actual, sólo cuando se persiste por primera vez la entidad (es decir, se inserta): - -.. configuration-block:: - - .. code-block:: php-annotations - - /** - * @ORM\PrePersist - */ - public function setCreatedValue() - { - $this->created = new \DateTime(); - } - - .. code-block:: yaml - - # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml - Acme\StoreBundle\Entity\Product: - type: entity - # ... - lifecycleCallbacks: - prePersist: [setCreatedValue] - - .. code-block:: xml - - - - - - - - - - - - - - -.. note:: - - En el ejemplo anterior se supone que has creado y asignado una propiedad ``created`` (no mostrada aquí). - -Ahora, justo antes de persistir la primer entidad, *Doctrine* automáticamente llamará a este método y establecerá el campo ``created`` a la fecha actual. - -Esto se puede repetir en cualquiera de los otros eventos del ciclo de vida, los cuales incluyen a: - -* ``preRemove`` -* ``postRemove`` -* ``prePersist`` -* ``postPersist`` -* ``preUpdate`` -* ``postUpdate`` -* ``postLoad`` -* ``loadClassMetadata`` - -Para más información sobre qué significan estos eventos y el ciclo de vida de las retrollamadas en general, consulta la sección `Ciclo de vida de los eventos`_ en la documentación de *Doctrine*. - -.. sidebar:: Ciclo de vida de retrollamada y escuchas de eventos - - Observa que el método ``setCreatedValue()`` no recibe argumentos. Este siempre es el caso para el ciclo de vida de las retrollamadas y es intencional: el ciclo de vida de las retrollamadas debe ser un método sencillo que se ocupe de transformar los datos internos de la entidad (por ejemplo, estableciendo un campo a creado/actualizado, generando un valor ficticio). - - Si necesitas hacer alguna tarea más pesada ---como llevar la bitácora de eventos o enviar un correo electrónico--- debes registrar una clase externa como un escucha o suscriptor de eventos y darle acceso a todos los recursos que necesites. Para más información, consulta :doc:`/cookbook/doctrine/event_listeners_subscribers`. - -Extensiones *Doctrine*: ``Timestampable``, ``Sluggable``, etc. --------------------------------------------------------------- - -*Doctrine* es bastante flexible, y dispone de una serie de extensiones de terceros que te permiten realizar fácilmente tareas repetitivas y comunes en tus entidades. -Estas incluyen cosas tales como ``Sluggable``, ``Timestampable``, ``Loggable``, ``Translatable`` y ``Tree``. - -Para más información sobre cómo encontrar y utilizar estas extensiones, ve el artículo sobre el uso de :doc:`extensiones comunes de Doctrine `. - -.. _book-doctrine-field-types: - -Referencia de tipos de campo *Doctrine* ---------------------------------------- - -*Doctrine* dispone de una gran cantidad de tipos de campo. Cada uno de estos asigna un tipo de dato *PHP* a un tipo de columna específica en cualquier base de datos que estés utilizando. Los siguientes tipos son compatibles con *Doctrine*: - -* **Cadenas** - - * ``string`` (usado para cadenas cortas) - * ``text`` (usado para cadenas grandes) - -* **Números** - - * ``integer`` - * ``smallint`` - * ``bigint`` - * ``decimal`` - * ``float`` - -* **Fechas y horas** (usa un objeto `DateTime`_ para estos campos en *PHP*) - - * ``date`` - * ``time`` - * ``datetime`` - -* **Otros tipos** - - * ``boolean`` - * ``object`` (serializado y almacenado en un campo ``CLOB``) - * ``array`` (serializado y almacenado en un campo ``CLOB``) - -Para más información, consulta la sección `Asignando tipos`_ en la documentación de *Doctrine*. - -Opciones de campo -~~~~~~~~~~~~~~~~~ - -Cada campo puede tener un conjunto de opciones aplicables. Las opciones disponibles incluyen ``type`` (el predeterminado es ``string``), ``name``, ``length``, ``unique`` y ``nullable``. Aquí tienes algunos ejemplos: - -.. configuration-block:: - - .. code-block:: php-annotations - - /** - * Un campo cadena con una longitud de 255 caracteres que no puede ser nulo - * (reflejando los valores predefinidos para 'type', 'length' - * y opciones *nullable*) - * - * @ORM\Column() - */ - protected $name; - - /** - * Un campo cadena de 150 caracteres de longitud que se persiste a una columna «email_address» y tiene un índice único. - * - * @ORM\Column(name="email_address", unique=true, length=150) - */ - protected $email; - - .. code-block:: yaml - - fields: - # Un campo cadena de longitud 255 que no puede ser null - # (reflejando los valores predefinidos para las opciones 'length' y 'nullable') - # el atributo type es necesario en las definiciones yaml - name: - type: string - - # Un campo cadena de longitud 150 que persiste a una columna 'email_address' - # y tiene un índice único. - email: - type: string - column: email_address - length: 150 - unique: true - - .. code-block:: xml - - # Un campo de tipo «string» de longitud 255 que no puede ser nulo - # (reflejando los valores predefinidos para las opciones «length» y «nullable») - # el atributo «type» es necesario en las definiciones yaml - name: - - - -.. note:: - - Hay algunas opciones más que no figuran en esta lista. Para más detalles, consulta la sección `Asignando propiedades`_ de la documentación de *Doctrine*. - -.. index:: - single: Doctrine; Ordenes de consola ORM - single: CLI; ORM de Doctrine - -Ordenes de consola ------------------- - -La integración del *ORM* de *Doctrine2* ofrece varias ordenes de consola bajo el espacio de nombres ``doctrine``. Para ver la lista de ordenes puedes ejecutar la consola sin ningún tipo de argumento: - -.. code-block:: bash - - $ php app/console - -Mostrará una lista con las ordenes disponibles, muchas de las cuales comienzan con el prefijo ``doctrine:``. Puedes encontrar más información sobre cualquiera de estas ordenes (o cualquier orden de *Symfony*) ejecutando la orden ``help``. Por ejemplo, para obtener detalles acerca de la tarea ``doctrine:database:create``, ejecuta: - -.. code-block:: bash - - $ php app/console help doctrine:database:create - -Algunas tareas notables o interesantes son: - -* ``doctrine:ensure-production-settings`` --- comprueba si el entorno actual está configurado de manera eficiente para producción. Esta siempre se debe ejecutar en el entorno ``prod``: - - .. code-block:: bash - - $ php app/console doctrine:ensure-production-settings --env=prod - -* ``doctrine:mapping:import`` --- permite a *Doctrine* llevar a cabo una introspección a una base de datos existente y crear información de asignación. Para más información, consulta :doc:`/cookbook/doctrine/reverse_engineering`. - -* ``doctrine:mapping:info`` --- te dice todas las entidades de las que *Doctrine* es consciente y si hay algún error básico con la asignación. - -* ``doctrine:query:dql`` y ``doctrine:query:sql`` --- te permiten ejecutar consultas *DQL* o *SQL* directamente desde la línea de ordenes. - -.. note:: - - Para poder cargar accesorios a tu base de datos, en su lugar, necesitas tener instalado el paquete ``DoctrineFixturesBundle``. Para aprender cómo hacerlo, lee el artículo «:doc:`/bundles/DoctrineFixturesBundle/index`» en la documentación. - -.. tip:: - - Esta página muestra cómo trabajar con *Doctrine* dentro de un controlador. Posiblemente también quieras trabajar con *Doctrine* en algún otro lugar en tu aplicación. El método :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::getDoctrine` del controlador regresa el servicio ``doctrine``, puedes trabajar con este de la misma manera que en cualquier otro lugar inyectándolo en tus propios servicios. Consulta :doc:`/book/service_container` para más sobre la creación de tus propios servicios. - -Resumen -------- - -Con *Doctrine*, puedes centrarte en tus objetos y la forma en que son útiles en tu aplicación y luego preocuparte por su persistencia en la base de datos. Esto se debe a que *Doctrine* te permite utilizar cualquier objeto *PHP* para almacenar los datos y se basa en la información de asignación de metadatos para asignar los datos de un objeto a una tabla particular de la base de datos. - -Y aunque *Doctrine* gira en torno a un concepto simple, es increíblemente poderoso, permitiéndote crear consultas complejas y suscribirte a los eventos que te permiten realizar diferentes acciones conforme los objetos recorren su ciclo de vida en la persistencia. - -Para más información acerca de *Doctrine*, ve la sección *Doctrine* del :doc:`Recetario `, que incluye los siguientes artículos: - -* :doc:`/bundles/DoctrineFixturesBundle/index` -* :doc:`/cookbook/doctrine/common_extensions` - -.. _`Doctrine`: http://www.doctrine-project.org/ -.. _`MongoDB`: http://www.mongodb.org/ -.. _`Documentación de asignación básica`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html -.. _`Generador de consultas`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/query-builder.html -.. _`Doctrine Query Language`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/dql-doctrine-query-language.html -.. _`Asignando asociaciones`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/association-mapping.html -.. _`DateTime`: http://www.php.net/manual/es/class.datetime.php -.. _`Asignando tipos`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#doctrine-mapping-types -.. _`Asignando propiedades`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#property-mapping -.. _`Ciclo de vida de los eventos`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#lifecycle-events -.. _`Documentación de palabras clave reservadas por SQL`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words -.. _`Clases persistentes`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#persistent-classes -.. _`Asignación de propiedades`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#property-mapping diff --git a/_sources/book/forms.txt b/_sources/book/forms.txt deleted file mode 100644 index c70abdc..0000000 --- a/_sources/book/forms.txt +++ /dev/null @@ -1,1312 +0,0 @@ -.. index:: - single: Formularios - -Formularios -=========== - -Utilizar formularios *HTML* es una de las más comunes ---y desafiantes--- tareas para un desarrollador web. *Symfony2* integra un componente ``Form`` que se ocupa de facilitarnos la utilización de formularios. En este capítulo, construirás un formulario complejo desde el principio, del cual, de paso, aprenderás las características más importantes de la biblioteca de formularios. - -.. note:: - - El componente ``Form`` de *Symfony* es una biblioteca independiente que puedes utilizar fuera de los proyectos *Symfony2*. Para más información, consulta el `Componente Form de Symfony2`_ en *Github*. - -.. index:: - single: Formularios; Creando un formulario sencillo - -Creando un formulario sencillo ------------------------------- - -Supón que estás construyendo una sencilla aplicación de tareas pendientes que necesita mostrar tus «pendientes». Debido a que tus usuarios tendrán que editar y crear tareas, tienes que crear un formulario. Pero antes de empezar, vamos a concentrarnos en la clase genérica ``Task`` que representa y almacena los datos para una sola tarea:: - - // src/Acme/TaskBundle/Entity/Task.php - namespace Acme\TaskBundle\Entity; - - class Task - { - protected $task; - - protected $dueDate; - - public function getTask() - { - return $this->task; - } - public function setTask($task) - { - $this->task = $task; - } - - public function getDueDate() - { - return $this->dueDate; - } - public function setDueDate(\DateTime $dueDate = null) - { - $this->dueDate = $dueDate; - } - } - -.. note:: - - Si estás codificando este ejemplo, primero crea el paquete ``AcmeTaskBundle`` ejecutando la siguiente orden (aceptando todas las opciones predeterminadas): - - .. code-block:: bash - - $ php app/console generate:bundle --namespace=Acme/TaskBundle - -Esta clase es un «antiguo objeto *PHP* sencillo», ya que, hasta ahora, no tiene nada que ver con *Symfony* o cualquier otra biblioteca. Es simplemente un objeto *PHP* normal que directamente resuelve un problema dentro de *tu* aplicación (es decir, la necesidad de representar una tarea pendiente en tu aplicación). Por supuesto, al final de este capítulo, serás capaz de enviar datos a una instancia de ``Task`` (a través de un formulario), validar sus datos, y persistirla en una base de datos. - -.. index:: - single: Formularios; Creando un formulario en un controlador - -Construyendo el formulario -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora que has creado una clase ``Task``, el siguiente paso es crear y reproducir el formulario *HTML* real. En *Symfony2*, esto se hace construyendo un objeto ``Form`` y luego pintándolo en una plantilla. Por ahora, esto se puede hacer en el interior de un controlador:: - - // src/Acme/TaskBundle/Controller/DefaultController.php - namespace Acme\TaskBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - use Acme\TaskBundle\Entity\Task; - use Symfony\Component\HttpFoundation\Request; - - class DefaultController extends Controller - { - public function newAction(Request $request) - { - // crea una task y le asigna algunos datos ficticios para este ejemplo - $task = new Task(); - $task->setTask('Write a blog post'); - $task->setDueDate(new \DateTime('tomorrow')); - - $form = $this->createFormBuilder($task) - ->add('task', 'text') - ->add('dueDate', 'date') - ->getForm(); - - return $this->render('AcmeTaskBundle:Default:new.html.twig', array( - 'form' => $form->createView(), - )); - } - } - -.. tip:: - - Este ejemplo muestra cómo crear el formulario directamente en el controlador. - Más adelante, en la sección «:ref:`book-form-creating-form-classes`», aprenderás cómo construir tu formulario en una clase independiente, lo cual es muy recomendable puesto que vuelve reutilizable tu formulario. - -La creación de un formulario requiere poco código relativamente, porque los objetos ``form`` de *Symfony2* se construyen con un «generador de formularios». El propósito del generador de formularios es permitirte escribir sencillas «recetas» de formulario, y hacer todo el trabajo pesado de la contrucción de un formulario. - -En este ejemplo, añadiste dos campos al formulario ---``task`` y ``dueDate``--- que corresponden a las propiedades ``task`` y ``dueDate`` de la clase ``Task``. -También asignaste a cada uno un «tipo» (por ejemplo, ``text``, ``date``), el cual entre otras cosas, determina qué etiqueta de formulario *HTML* se dibuja para ese campo. - -*Symfony2* viene con muchos tipos integrados que explicaremos en breve (consulta :ref:`book-forms-type-reference`). - -.. index:: - single: Formularios; Reproducción básica de plantillas - -Reproduciendo el formulario -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora que creaste el formulario, el siguiente paso es dibujarlo. Lo puedes hacer pasando un objeto ``view`` especial para formularios a tu plantilla (ten en cuenta la declaración ``$form->createView()`` en el controlador de arriba) y usando un conjunto de funciones ayudantes de formulario: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #} -
- {{ form_widget(form) }} - - -
- - .. code-block:: html+php - - -
enctype($form) ?> > - widget($form) ?> - - -
- -.. image:: /images/book/form-simple.png - :align: center - -.. note:: - - Este ejemplo asume que has creado una ruta llamada ``task_new`` que apunta al controlador ``AcmeTaskBundle:Default:new`` creado anteriormente. - -¡Eso es todo! Al imprimir ``form_widget(form)``, se pinta cada campo en el formulario, junto con la etiqueta y un mensaje de error (si lo hay). Tan fácil como esto, aunque no es muy flexible (todavía). Por lo general, querrás reproducir individualmente cada campo del formulario para que puedas controlar la apariencia del formulario. Aprenderás cómo hacerlo en la sección «:ref:`form-rendering-template`». - -Antes de continuar, observa cómo el campo de entrada ``task`` reproducido tiene el valor de la propiedad ``task`` del objeto ``$task`` (es decir, «Escribe una entrada del *blog*»). -El primer trabajo de un formulario es: tomar datos de un objeto y traducirlos a un formato idóneo para reproducirlos en un formulario *HTML*. - -.. tip:: - - El sistema de formularios es lo suficientemente inteligente como para acceder al valor de la propiedad protegida ``task`` a través de los métodos ``getTask()`` y ``setTask()`` de la clase ``Task``. A menos que una propiedad sea pública, *debe* tener métodos «captadores» y «definidores» para que el componente ``Form`` pueda obtener y fijar datos en la propiedad. Para una propiedad booleana, puedes utilizar un método «isser» (por «es servicio», por ejemplo, ``isPublished()``) en lugar de un captador (por ejemplo, ``getPublished()`` o ``getReminder()``). - - .. versionadded:: 2.1 - La compatibilidad para los métodos «hasser» se añadió en *Symfony 2.1*. - -.. index:: - single: Formularios; Procesando el envío del formulario - -Procesando el envío del formulario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El segundo trabajo de un ``formulario`` es traducir los datos enviados por el usuario a las propiedades de un objeto. Para lograrlo, los datos presentados por el usuario deben estar vinculados al formulario. Añade la siguiente funcionalidad a tu controlador:: - - // ... - use Symfony\Component\HttpFoundation\Request; - - public function newAction(Request $request) - { - // sólo configura un objeto $task fresco (remueve los datos de prueba) - $task = new Task(); - - $form = $this->createFormBuilder($task) - ->add('task', 'text') - ->add('dueDate', 'date') - ->getForm(); - - if ($request->isMethod('POST')) { - $form->bind($request); - - if ($form->isValid()) { - // realiza alguna acción, tal como guardar la tarea en la base de datos - - return $this->redirect($this->generateUrl('task_success')); - } - } - - // ... - } - -.. versionadded:: 2.1 - El método ``bind`` se hizo más flexible en *Symfony 2.1*. Ahora acepta datos del cliente sin procesar (como antes) o un objeto ``Petición`` de *Symfony*. Este es preferible al método depreciado ``bindRequest``. - -Ahora, cuando se presente el formulario, el controlador vincula al formulario los datos presentados, los cuales se traducen en los nuevos datos de las propiedades ``task`` y ``dueDate`` del objeto ``$task``. Esto sucede a través del método ``bind()``. - -.. note:: - - Tan pronto como se llame a ``bind()``, los datos presentados se transfieren inmediatamente al objeto subyacente. Esto ocurre independientemente de si los datos subyacentes son válidos realmente o no. - -Este controlador sigue un patrón común para el manejo de formularios, y tiene tres posibles rutas: - -#. Inicialmente, cuando se carga el formulario en un navegador, el método de la petición es *GET*, lo cual significa simplemente que se debe crear y reproducir el formulario; - -#. Cuando el usuario envía el formulario (es decir, el método es *POST*), pero los datos presentados no son válidos (la validación se trata en la siguiente sección), el formulario es vinculado y, a continuación reproducido, esta vez mostrando todos los errores de validación; - -#. Cuando el usuario envía el formulario con datos válidos, el formulario es vinculado y en ese momento tienes la oportunidad de realizar algunas acciones usando el objeto ``$task`` (por ejemplo, persistirlo a la base de datos) antes de redirigir al usuario a otra página (por ejemplo, una página de «agradecimiento» o «éxito»). - -.. note:: - - Redirigir a un usuario después de un exitoso envío de formulario evita que el usuario pueda hacer clic en «actualizar» y volver a enviar los datos. - -.. index:: - single: Formularios; Validando - -Validando formularios ---------------------- - -En la sección anterior, aprendiste cómo se puede presentar un formulario con datos válidos o no válidos. En *Symfony2*, la validación se aplica al objeto subyacente (por ejemplo, ``Task``). En otras palabras, la cuestión no es si el «formulario» es válido, sino más bien si el objeto ``$task`` es válido después de aplicarle los datos enviados en el formulario. Invocar a ``$form->isValid()`` es un atajo que pregunta al objeto ``$task`` si tiene datos válidos o no. - -La validación se realiza añadiendo un conjunto de reglas (llamadas restricciones) a una clase. Para ver esto en acción, añade restricciones de validación para que el campo ``task`` no pueda estar vacío y el campo ``dueDate`` no pueda estar vacío y debe ser un objeto ``\DateTime`` válido. - -.. configuration-block:: - - .. code-block:: yaml - - # Acme/TaskBundle/Resources/config/validation.yml - Acme\TaskBundle\Entity\Task: - properties: - task: - - NotBlank: ~ - dueDate: - - NotBlank: ~ - - Type: \DateTime - - .. code-block:: php-annotations - - // Acme/TaskBundle/Entity/Task.php - use Symfony\Component\Validator\Constraints as Assert; - - class Task - { - /** - * @Assert\NotBlank() - */ - public $task; - - /** - * @Assert\NotBlank() - * @Assert\Type("\DateTime") - */ - protected $dueDate; - } - - .. code-block:: xml - - - - - - - - - \DateTime - - - - .. code-block:: php - - // Acme/TaskBundle/Entity/Task.php - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\NotBlank; - use Symfony\Component\Validator\Constraints\Type; - - class Task - { - // ... - - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint('task', new NotBlank()); - - $metadata->addPropertyConstraint('dueDate', new NotBlank()); - $metadata->addPropertyConstraint('dueDate', new Type('\DateTime')); - } - } - -¡Eso es todo! Si vuelves a enviar el formulario con datos no válidos, verás replicados los errores correspondientes en el formulario. - -.. _book-forms-html5-validation-disable: - -.. sidebar:: Validación HTML5 - - A partir de *HTML5*, muchos navegadores nativamente pueden imponer ciertas restricciones de validación en el lado del cliente. La validación más común se activa al reproducir un atributo ``required`` en los campos que son obligatorios. Para los navegadores compatibles con *HTML5*, esto se traducirá en un mensaje nativo del navegador que muestra si el usuario intenta enviar el formulario con ese campo en blanco. - - Los formularios generados sacan el máximo provecho de esta nueva característica añadiendo atributos *HTML* razonables que desencadenan la validación. La validación del lado del cliente, sin embargo, se puede desactivar añadiendo el atributo ``novalidate`` de la etiqueta ``form`` o ``formnovalidate`` a la etiqueta de envío. Esto es especialmente útil cuando deseas probar tus limitaciones en el lado del la validación del servidor, pero su navegador las previene, por ejemplo, la presentación de campos en blanco. - -La validación es una característica muy poderosa de *Symfony2* y tiene su propio :doc:`capítulo dedicado `. - -.. index:: - single: Formularios; Validando grupos - -.. _book-forms-validation-groups: - -Validando grupos -~~~~~~~~~~~~~~~~ - -.. tip:: - - Si no estás utilizando la :ref:`validación de grupos `, entonces puedes saltarte esta sección. - -Si tu objeto aprovecha la :ref:`validación de grupos `, tendrás que especificar la validación de grupos que utiliza tu formulario:: - - $form = $this->createFormBuilder($users, array( - 'validation_groups' => array('registration'), - ))->add(...); - -Si vas a crear :ref:`clases form ` (una buena práctica), entonces tendrás que agregar lo siguiente al método ``getDefaultOptions()``:: - - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'validation_groups' => array('registration') - )); - } - -En ambos casos, *sólo* se utilizará el grupo de validación ``registration`` para validar el objeto subyacente. - -Grupos basados en datos presentados -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - La posibilidad de especificar una retrollamada o Cierre en ``validation_groups`` es nueva en la versión 2.1 - -Si necesitas alguna lógica avanzada para determinar los grupos de validación (por ejemplo, basándote en datos presentados), puedes poner la opción ``validation_groups`` a un arreglo de retrollamadas, o a un ``Cierre``:: - - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'validation_groups' => array('Acme\\AcmeBundle\\Entity\\Client', 'determineValidationGroups'), - )); - } - -Esto llamará al método estático ``determineValidationGroups()`` en la clase ``Cliente`` después de vincular el formulario, pero antes de llevar a cabo la validación. -El objeto formulario se pasa como argumento al método (ve el siguiente ejemplo). -Además puedes definir tu lógica completa en línea usando un ``Cierre``:: - - use Symfony\Component\Form\FormInterface; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'validation_groups' => function(FormInterface $form) { - $data = $form->getData(); - if (Entity\Client::TYPE_PERSON == $data->getType()) { - return array('person'); - } else { - return array('company'); - } - }, - )); - } - -.. index:: - single: Formularios; Tipos de campo integrados - -.. _book-forms-type-reference: - -Tipos de campo integrados -------------------------- - -*Symfony* estándar viene con un gran grupo de tipos de campo que cubre todos los campos de formulario comunes y tipos de datos necesarios: - -.. include:: /reference/forms/types/map.rst.inc - -También puedes crear tus propios tipos de campo personalizados. Este tema se trata en el artículo «:doc:`/cookbook/form/create_custom_field_type`» del recetario. - -.. index:: - single: Formularios; Opciones del tipo de campo - -Opciones del tipo de campo -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada tipo de campo tiene una serie de opciones que puedes utilizar para configurarlo. -Por ejemplo, el campo ``dueDate`` se está traduciendo como 3 cajas de selección. Sin embargo, puedes configurar el :doc:`campo de fecha ` para que sea interpretado como un cuadro de texto (donde el usuario introduce la fecha como una cadena en el cuadro):: - - ->add('dueDate', 'date', array('widget' => 'single_text')) - -.. image:: /images/book/form-simple2.png - :align: center - -Cada tipo de campo tiene una diferente serie de opciones que le puedes pasar. -Muchas de ellas son específicas para el tipo de campo y puedes encontrar los detalles en la documentación de cada tipo. - -.. sidebar:: La opción ``required`` - - La opción más común es la opción ``required``, la cual puedes aplicar a cualquier campo. De manera predeterminada, la opción ``required`` está establecida en ``true``, lo cual significa que los navegadores preparados para *HTML5* aplicarán la validación en el cliente si el campo se deja en blanco. Si no deseas este comportamiento, establece la opción ``required`` en tu campo a ``false`` o :ref:`desactiva la validación de HTML5 `. - - También ten en cuenta que al establecer la opción ``required`` a ``true`` **no** resultará en aplicar la validación de lado del servidor. En otras palabras, si un usuario envía un valor en blanco para el campo (ya sea con un navegador antiguo o un servicio web, por ejemplo), será aceptado como un valor válido a menos que utilices la validación de restricción ``NotBlank`` o ``NotNull`` de *Symfony*. - - En otras palabras, la opción ``required`` es «agradable», pero ciertamente *siempre* se debe utilizar de lado del servidor. - -.. sidebar:: La opción ``label`` - - La etiqueta para el campo ``form`` se puede fijar usando la opción ``label``, la cual se puede aplicar a cualquier campo:: - - ->add('dueDate', 'date', array( - 'widget' => 'single_text', - 'label' => 'Due Date', - )) - - La etiqueta de un campo también se puede configurar al pintar la plantilla del formulario, ve más abajo. - -.. index:: - single: Formularios; Deduciendo el tipo de campo - -.. _book-forms-field-guessing: - -Deduciendo el tipo de campo ---------------------------- - -Ahora que has añadido metadatos de validación a la clase ``Task``, *Symfony* ya sabe un poco sobre tus campos. Si le permites, *Symfony* puede «deducir» el tipo de tu campo y configurarlo por ti. En este ejemplo, *Symfony* lo puede deducir a partir de las reglas de validación de ambos campos, ``task`` es un campo de texto normal y ``dueDate`` es un campo ``date``:: - - public function newAction() - { - $task = new Task(); - - $form = $this->createFormBuilder($task) - ->add('task') - ->add('dueDate', null, array('widget' => 'single_text')) - ->getForm(); - } - -El «adivino» se activa cuando omites el segundo argumento del método ``add()`` (o si le pasas ``null``). Si pasas un arreglo de opciones como tercer argumento (hecho por ``dueDate`` arriba), estas opciones se aplican al campo inferido. - -.. caution:: - - Si tu formulario utiliza una validación de grupo específica, el adivino del tipo de campo seguirá considerando *todas* las restricciones de validación cuando infiere el tipo de campo (incluyendo las restricciones que no son parte de la validación de grupo utilizada). - -.. index:: - single: Formularios; Deduciendo el tipo de campo - -Opciones para deducir el tipo de campo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Además de deducir el «tipo» de un campo, *Symfony* también puede tratar de inferir los valores correctos a partir de una serie de opciones del campo. - -.. tip:: - - Cuando estas opciones están configuradas, el campo se dibujará con los atributos *HTML* especiales proporcionados para la validación de *HTML5* en el cliente. Sin embargo, no genera el equivalente de las restricciones de lado del servidor (por ejemplo, ``Assert\Length``). - Y aunque tendrás que agregar manualmente la validación de lado del servidor, estas opciones del tipo de campo entonces se pueden deducir a partir de esa información. - -* ``required``: La opción ``required`` se puede deducir basándose en las reglas de validación (es decir, el campo es ``NotBlank`` o ``NotNull``) o los metadatos de *Doctrine* (es decir, el campo es ``nullable``). Esto es muy útil, ya que tu validación de lado del cliente se ajustará automáticamente a tus reglas de validación. - -* ``max_length``: Si el campo es una especie de campo de texto, entonces la opción ``max_length`` se puede inferir a partir de las restricciones de validación (si utilizas ``Length`` o ``Range``) o desde los metadatos de *Doctrine* (vía la longitud del campo). - -.. note:: - - Estas opciones de campo *sólo* se infieren si estás utilizando *Symfony* para deducir el tipo de campo (es decir, las omites por completo o pasas ``null`` como el segundo argumento de ``add()``). - -Si quieres cambiar uno de los valores inferidos, lo puedes redefinir pasando la opción en el arreglo de opciones del campo:: - - ->add('task', null, array('max_length' => 4)) - -.. index:: - single: Formularios; Reproduciendo en una plantilla - -.. _form-rendering-template: - -Reproduciendo un formulario en una plantilla --------------------------------------------- - -Hasta ahora, has visto cómo se puede reproducir todo el formulario con una sola línea de código. Por supuesto, generalmente necesitarás mucha más flexibilidad al reproducirlo: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #} -
- {{ form_errors(form) }} - - {{ form_row(form.task) }} - {{ form_row(form.dueDate) }} - - {{ form_rest(form) }} - - -
- - .. code-block:: html+php - - -
enctype($form) ?>> - errors($form) ?> - - row($form['task']) ?> - row($form['dueDate']) ?> - - rest($form) ?> - - -
- -Échale un vistazo a cada parte: - -* ``form_enctype(form)`` --- Si por lo menos un campo es para carga de archivos, se reproduce el obligado ``enctype="multipart/form-data"``; - -* ``form_errors(form)`` --- Dibuja cualquier error global para todo el formulario (los errores específicos al campo se muestran junto a cada campo); - -* ``form_row(form.dueDate)`` --- Dibuja la etiqueta, cualquier error, y el elemento gráfico *HTML* del formulario para el campo en cuestión (por ejemplo, ``dueDate``), por omisión, en el interior de un elemento ``div``; - -* ``form_rest(form)`` --- Pinta todos los campos que aún no se han reproducido. - Por lo general es buena idea realizar una llamada a este ayudante en la parte inferior de cada formulario (en caso de haber olvidado sacar un campo o si no quieres preocuparte de reproducir manualmente los campos ocultos). Este ayudante también es útil para tomar ventaja de la :ref:`Protección CSRF ` automática. - -La mayor parte del trabajo la realiza el ayudante ``form_row``, el cual de manera predeterminada reproduce la etiqueta, los errores y el elemento gráfico *HTML* de cada campo del formulario dentro de una etiqueta ``div``. En la sección :ref:`form-theming`, aprenderás cómo puedes personalizar ``form_row`` en diferentes niveles. - -.. tip:: - - Puedes acceder a los datos reales de tu formulario vía ``form.vars.value``: - - .. configuration-block:: - - .. code-block:: jinja - - {{ form.vars.value.task }} - - .. code-block:: html+php - - get('value')->getTask() ?> - -.. index:: - single: Formularios; Reproduciendo cada campo a mano - -Reproduciendo cada campo a mano -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El ayudante ``form_row`` es magnífico porque rápidamente puedes reproducir cada campo del formulario (y también puedes personalizar el formato utilizado para la «fila»). Pero, puesto que la vida no siempre es tan simple, también puedes dibujar cada campo totalmente a mano. El producto final del siguiente fragmento es el mismo que cuando usas el ayudante ``form_row``: - -.. configuration-block:: - - .. code-block:: html+jinja - - {{ form_errors(form) }} - -
- {{ form_label(form.task) }} - {{ form_errors(form.task) }} - {{ form_widget(form.task) }} -
- -
- {{ form_label(form.dueDate) }} - {{ form_errors(form.dueDate) }} - {{ form_widget(form.dueDate) }} -
- - {{ form_rest(form) }} - - .. code-block:: html+php - - errors($form) ?> - -
- label($form['task']) ?> - errors($form['task']) ?> - widget($form['task']) ?> -
- -
- label($form['dueDate']) ?> - errors($form['dueDate']) ?> - widget($form['dueDate']) ?> -
- - rest($form) ?> - -Si la etiqueta generada automáticamente para un campo no es del todo correcta, la puedes especificar explícitamente: - -.. configuration-block:: - - .. code-block:: html+jinja - - {{ form_label(form.task, 'Task Description') }} - - .. code-block:: html+php - - label($form['task'], 'Task Description') ?> - -Algunos tipos de campo tienen opciones adicionales para su representación que puedes pasar al elemento gráfico. Estas opciones están documentadas con cada tipo, pero una opción común es ``attr``, la cual te permite modificar los atributos en el elemento del formulario. -Lo siguiente debería añadir la clase ``task_field`` al campo de entrada de texto reproducido: - -.. configuration-block:: - - .. code-block:: html+jinja - - {{ form_widget(form.task, { 'attr': {'class': 'task_field'} }) }} - - .. code-block:: html+php - - widget($form['task'], array( - 'attr' => array('class' => 'task_field'), - )) ?> - -Si necesitas dibujar campos de formulario «a mano», entonces puedes acceder a los valores individuales de los campos tal como el ``id`` ``nombre`` y ``etiqueta``. Por ejemplo, para conseguir el ``id``: - -.. configuration-block:: - - .. code-block:: html+jinja - - {{ form.task.vars.id }} - - .. code-block:: html+php - - get('id') ?> - -Para recuperar el valor utilizado para el atributo nombre del campo en el formulario necesitas utilizar -el valor ``full_name``: - -.. configuration-block:: - - .. code-block:: html+jinja - - {{ form.task.vars.full_name }} - - .. code-block:: html+php - - get('full_name') ?> - -Referencia de funciones de plantilla *Twig* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si estás utilizando *Twig*, hay disponible una referencia completa de las funciones de reproducción de formularios en el :doc:`Manual de referencia `. -Estúdiala para conocer todo acerca de los ayudantes y las opciones disponibles que puedes utilizar con cada uno. - -.. index:: - single: Formularios; Creando clases Form - -.. _book-form-creating-form-classes: - -Creando clases ``Form`` ------------------------ - -Como viste, puedes crear un formulario y utilizarlo directamente en un controlador. -Sin embargo, una mejor práctica es construir el formulario en una clase separada, independiente de las clases *PHP*, misma que puedes reutilizar en cualquier lugar de tu aplicación. Crea una nueva clase que albergará la lógica para la construcción del formulario de la tarea:: - - // src/Acme/TaskBundle/Form/Type/TaskType.php - namespace Acme\TaskBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - - class TaskType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('task'); - $builder->add('dueDate', null, array('widget' => 'single_text')); - } - - public function getName() - { - return 'task'; - } - } - -Esta nueva clase contiene todas las indicaciones necesarias para crear el formulario de la tarea (observa que el método ``getName()`` devolverá un identificador único para este «tipo» de formulario). La puedes utilizar para construir rápidamente un objeto formulario en el controlador:: - - // src/Acme/TaskBundle/Controller/DefaultController.php - - // agrega esta nueva declaración use en lo alto de la clase - use Acme\TaskBundle\Form\Type\TaskType; - - public function newAction() - { - $task = ...; - $form = $this->createForm(new TaskType(), $task); - - // ... - } - -Colocar la lógica del formulario en su propia clase significa que fácilmente puedes reutilizar el formulario en otra parte del proyecto. Esta es la mejor manera de crear formularios, pero la decisión en última instancia, depende de ti. - -.. _book-forms-data-class: - -.. sidebar:: Configurando el ``data_class`` - - Cada formulario tiene que conocer el nombre de la clase que contiene los datos subyacentes (por ejemplo, ``Acme\TaskBundle\Entity\Task``). Por lo general, esto sólo se deduce basándose en el objeto pasado como segundo argumento de ``createForm`` (es decir, ``$task``). Más tarde, cuando comiences a incorporar formularios, esto ya no será suficiente. Así que, si bien no siempre es necesario, generalmente es buena idea especificar directamente la opción ``data_class`` añadiendo lo siguiente al tipo de tu clase formulario:: - - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\TaskBundle\Entity\Task', - )); - } - -.. tip:: - - Al asignar formularios a objetos, se asignan todos los campos. Todos los campos del formulario que no existen en el objeto asignado provocarán que se lance una excepción. - - En los casos donde necesites más campos en el formulario (por ejemplo: para una casilla de verificación «Estoy de acuerdo con estos términos») que no se asociará al objeto subyacente, necesitas establecer la opción ``property_path`` a ``false``:: - - use Symfony\Component\Form\FormBuilderInterface; - - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('task'); - $builder->add('dueDate', null, array('mapped' => false)); - } - - Además, si hay algunos campos en el formulario que no se incluyen en los datos presentados, esos campos explícitamente se establecerán en ``null``. - - Los datos del campo se pueden acceder en un controlador con:: - - $form->get('dueDate')->getData(); - -.. index:: - pair: Formularios; Doctrine - -Formularios y *Doctrine* ------------------------- - -El objetivo de un formulario es traducir los datos de un objeto (por ejemplo, ``Task``) a un formulario *HTML* y luego traducir los datos enviados por el usuario al objeto original. Como tal, el tema de la persistencia del objeto ``Task`` a la base de datos es del todo ajeno al tema de los formularios. Pero, si has configurado la clase ``Task`` para persistirla a través de *Doctrine* (es decir, que le has añadido :ref:`metadatos de asignación `), entonces persistirla después de la presentación de un formulario se puede hacer cuando el formulario es válido:: - - if ($form->isValid()) { - $em = $this->getDoctrine()->getManager(); - $em->persist($task); - $em->flush(); - - return $this->redirect($this->generateUrl('task_success')); - } - -Si por alguna razón, no tienes acceso a tu objeto ``$task`` original, lo puedes recuperar desde el formulario:: - - $task = $form->getData(); - -Para más información, consulta el capítulo :doc:`ORM de Doctrine `. - -La clave es entender que cuando el formulario está vinculado, los datos presentados inmediatamente se transfieren al objeto subyacente. Si deseas conservar los datos, sólo tendrás que conservar el objeto en sí (el cual ya contiene los datos presentados). - -.. index:: - single: Formularios; Integrando formularios - -Integrando formularios ----------------------- - -A menudo, querrás crear un formulario que incluye campos de muchos objetos diferentes. Por ejemplo, un formulario de registro puede contener datos que pertenecen a un objeto ``User``, así como a muchos objetos ``Address``. Afortunadamente, esto es fácil y natural con el componente ``Form``. - -Integrando un solo objeto -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Supongamos que cada ``Task`` pertenece a un simple objeto ``Categoría``. Inicia, por supuesto, creando el objeto ``Categoría``:: - - // src/Acme/TaskBundle/Entity/Category.php - namespace Acme\TaskBundle\Entity; - - use Symfony\Component\Validator\Constraints as Assert; - - class Category - { - /** - * @Assert\NotBlank() - */ - public $name; - } - -A continuación, añade una nueva propiedad ``categoría`` a la clase ``Task``:: - - // ... - - class Task - { - // ... - - /** - * @Assert\Type(type="Acme\TaskBundle\Entity\Category") - */ - protected $category; - - // ... - - public function getCategory() - { - return $this->category; - } - - public function setCategory(Category $category = null) - { - $this->category = $category; - } - } - -Ahora que actualizaste tu aplicación para reflejar las nuevas necesidades, crea una clase formulario para que el usuario pueda modificar un objeto ``Categoría``:: - - // src/Acme/TaskBundle/Form/Type/CategoryType.php - namespace Acme\TaskBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class CategoryType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('name'); - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\TaskBundle\Entity\Category', - )); - } - - public function getName() - { - return 'category'; - } - } - -El objetivo final es permitir que la ``Categoría`` de una ``Task`` sea modificada justo dentro del mismo formulario de la tarea. Para lograr esto, añade un campo ``categoría`` al objeto ``TaskType`` cuyo tipo es una instancia de la nueva clase ``CategoryType``: - -.. code-block:: php - - use Symfony\Component\Form\FormBuilderInterface; - - public function buildForm(FormBuilderInterface $builder, array $options) - { - // ... - - $builder->add('category', new CategoryType()); - } - -Los campos de ``CategoryType`` ahora se pueden reproducir junto a los de la clase ``TaskType``. Para activar la validación en ``CategoryType``, añade la opción ``cascade_validation`` como ``TaskType``:: - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\TaskBundle\Entity\Task', - 'cascade_validation' => true, - )); - } - -Reproduce los campos de ``Categoría`` de la misma manera que los campos de la ``Task`` original: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# ... #} - -

Category

-
- {{ form_row(form.category.name) }} -
- - {{ form_rest(form) }} - {# ... #} - - .. code-block:: html+php - - - -

Category

-
- row($form['category']['name']) ?> -
- - rest($form) ?> - - -Cuando el usuario envía el formulario, los datos presentados para los campos de ``Categoría`` se utilizan para construir una instancia de ``Categoría``, que entonces se establece en el campo ``categoría`` de la instancia de ``Task``. - -La instancia de ``Categoría`` es accesible naturalmente vía ``$task->getCategory()`` y la puedes persistir en la base de datos o utilizarla como necesites. - -Integrando una colección de formularios -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes integrar una colección de formularios en un solo formulario (imagina un formulario ``Categoría`` con muchos subformularios ``Producto``). Esto se consigue usando el tipo de campo ``collection``. - -Para más información consulta el artículo «:doc:`/cookbook/form/form_collections`» del recetario y la referencia del tipo de campo :doc:`collection`. - -.. index:: - single: Formularios; Tematizando - single: Formularios; Personalizando campos - -.. _form-theming: - -Tematizando formularios ------------------------ - -Puedes personalizar cómo se reproduce cada parte de un formulario. Eres libre de cambiar la forma en que se dibuja cada «fila» del formulario, cambiar el formato que sirve para reproducir errores, e incluso personalizar la forma en que se debe reproducir una etiqueta ``textarea``. Nada está fuera de límites, y puedes usar diferentes personalizaciones en diferentes lugares. - -*Symfony* utiliza plantillas para reproducir todas y cada una de las partes de un formulario, como las etiquetas ``label``, etiquetas ``input``, mensajes de error y todo lo demás. - -En *Twig*, cada «fragmento» del formulario está representado por un bloque *Twig*. Para personalizar alguna parte de cómo se reproduce un formulario, sólo hay que reemplazar el bloque adecuado. - -En *PHP*, cada «fragmento» del formulario se reproduce vía un archivo de plantilla individual. -Para personalizar cualquier parte de cómo se reproduce un formulario, sólo hay que reemplazar la plantilla existente creando una nueva. - -Para entender cómo funciona esto, vamos a personalizar el fragmento ``form_row`` añadiendo un atributo «class» al elemento ``div`` que envuelve cada fila. Para ello, crea un nuevo archivo de plantilla que almacenará el nuevo marcado: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/TaskBundle/Resources/views/Form/fields.html.twig #} - {% block form_row %} - {% spaceless %} -
- {{ form_label(form) }} - {{ form_errors(form) }} - {{ form_widget(form) }} -
- {% endspaceless %} - {% endblock form_row %} - - .. code-block:: html+php - - -
- label($form, $label) ?> - errors($form) ?> - widget($form, $parameters) ?> -
- -El fragmento ``field_row`` del formulario se usa cuando al dibujar la mayoría de los campos a través de la función ``form_row``. Para decir al componente ``Form`` que utilice tu nuevo fragmento ``field_row`` definido anteriormente, añade lo siguiente en la parte superior de la plantilla que dibuja el formulario: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #} - {% form_theme form 'AcmeTaskBundle:Form:fields.html.twig' %} - - {% form_theme form 'AcmeTaskBundle:Form:fields.html.twig' - 'AcmeTaskBundle:Form:fields2.html.twig' %} - -
- - .. code-block:: html+php - - - setTheme($form, array('AcmeTaskBundle:Form')) ?> - - setTheme($form, array('AcmeTaskBundle:Form', 'AcmeTaskBundle:Form')) ?> - - - -La etiqueta ``form_theme`` (en *Twig*) «importa» los fragmentos definidos en la plantilla dada y los utiliza al reproducir el formulario. En otras palabras, cuando más adelante en esta plantilla se invoque la función ``form_row``, se utilizará el bloque ``field_row`` de tu tema personalizado (en lugar del bloque ``field_row`` predefinido suministrado con *Symfony*). - -Tu tema personalizado no tiene que sustituir todos los bloques. Cuando dibujes un bloque que no se reemplaza en tu tema personalizado, el motor de creación de temas caerá de nuevo en el tema global (definido a nivel del paquete). - -Si hay varios temas personalizados siempre se buscará en el orden listado antes de caer de nuevo al tema global. - -Para personalizar cualquier parte de un formulario, sólo tienes que reemplazar el fragmento apropiado. Saber exactamente qué bloque sustituir es el tema de la siguiente sección. - -.. versionadded:: 2.1 - Introduce una sintaxis alterna para el ``form_theme`` de *Twig*. Esta acepta cualquier expresión *Twig* válida (la diferencia más notable es el uso de un arreglo cuando utilizas múltiples temas). - - .. code-block:: html+jinja - - {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #} - - {% form_theme form with 'AcmeTaskBundle:Form:fields.html.twig' %} - - {% form_theme form with ['AcmeTaskBundle:Form:fields.html.twig', - 'AcmeTaskBundle:Form:fields2.html.twig'] %} - -Para una explicación más extensa, consulta :doc:`/cookbook/form/form_customization`. - -.. index:: - single: Formularios; Nombrando fragmentos de la plantilla - -.. _form-template-blocks: - -Nombrando fragmentos de formulario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En *Symfony*, cada parte de un formulario reproducido ---elementos *HTML* de formulario, errores, -etiquetas, etc.--- se definen en base a un tema, el cual es una colección de bloques en *Twig* y una colección de archivos de plantilla en *PHP*. - -En *Twig*, cada bloque necesario se define en un solo archivo de plantilla (`form_div_layout.html.twig`_) que vive dentro del `puente Twig`_. Dentro de este archivo, puedes ver todos los bloques necesarios para reproducir un formulario y cada tipo de campo predeterminado. - -En *PHP*, los fragmentos son archivos de plantilla individuales. De manera predeterminada se encuentran en el directorio ``Resources/views/Form`` del paquete de la plataforma (`ver en GitHub`_). - -El nombre de cada fragmento sigue el mismo patrón básico y se divide en dos partes, separadas por un solo carácter de guión bajo (``_``). Algunos ejemplos son: - -* ``form_row`` --- usado por ``form_row`` para reproducir la mayoría de los campos; -* ``textarea_widget`` --- usado por ``form_widget`` para dibujar un campo de tipo ``textarea``; -* ``form_errors`` --- usado por ``form_errors`` para dibujar los errores de un campo; - -Cada fragmento sigue el mismo patrón básico: ``type_part``. La porción ``type`` corresponde al *tipo* del campo que se está reproduciendo (por ejemplo, ``textarea``, ``checkbox``, ``date``, etc.), mientras que la porción ``part`` corresponde a *qué* se está reproduciendo (por ejemplo, ``label``, ``widget``, ``errors``, etc.). Por omisión, hay cuatro posibles *partes* de un formulario que puedes pintar: - -+-------------+--------------------------+---------------------------------------------------------+ -| ``label`` | (p. ej. ``form_label``) | dibuja la etiqueta de los campos | -+-------------+--------------------------+---------------------------------------------------------+ -| ``widget`` | (p. ej. ``form_widget``) | dibuja la representación *HTML* de los campos | -+-------------+--------------------------+---------------------------------------------------------+ -| ``errors`` | (p. ej. ``form_errors``) | dibuja los errores de los campos | -+-------------+--------------------------+---------------------------------------------------------+ -| ``row`` | (p. ej. ``form_row``) | dibuja el renglón completo de los campos (etiqueta, | -| | | elemento gráfico y errores) | -+-------------+--------------------------+---------------------------------------------------------+ - -.. note:: - - En realidad, hay otras 3 *partes* ---``rows``, ``rest`` y ``enctype``--- pero rara vez o quizá nunca te tengas que preocupar de cómo sustituirlas. - -Al conocer el tipo de campo (por ejemplo, ``textarea``) y cual parte deseas personalizar (por ejemplo, ``widget``), puedes construir el nombre del fragmento que se debe redefinir (por ejemplo, ``textarea_widget``). - -.. index:: - single: Formularios; Heredando fragmentos de plantilla - -Heredando fragmentos de plantilla -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En algunos casos, parece que falta el fragmento que deseas personalizar. -Por ejemplo, no hay fragmento ``textarea_errors`` en los temas predeterminados provistos con *Symfony*. Entonces, ¿cómo se reproducen los errores de un campo ``textarea``? - -La respuesta es: a través del fragmento ``field_errors``. Cuando *Symfony* pinta los errores del tipo ``textarea``, primero busca un fragmento ``textarea_errors`` antes de caer de nuevo al fragmento ``form_errors``. Cada tipo de campo tiene un tipo *padre* (el tipo primario del ``textarea`` es ``text``, y su padre es el ``form``), y *Symfony* utiliza el fragmento para el tipo del padre si no existe el fragmento base. - -Por lo tanto, para sustituir *sólo* los errores de los campos ``textarea``, copia el fragmento ``form_errors``, renómbralo como ``textarea_errors`` y personalízalo. Para sustituir la reproducción predeterminada para error de *todos* los campos, copia y personaliza el fragmento ``form_errors`` directamente. - -.. tip:: - - El tipo «padre» de cada tipo de campo está disponible en la :doc:`referencia del tipo form ` para cada tipo de campo. - -.. index:: - single: Formularios; Tematizado global - -Tematizando formularios globalmente -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En el ejemplo anterior, utilizaste el ayudante ``form_theme`` (en *Twig*) para «importar» fragmentos de formulario personalizados *sólo* para ese formulario. También puedes decirle a *Symfony* que importe formularios personalizados a través de tu proyecto. - -*Twig* -...... - -Para incluir automáticamente en *todas* las plantillas los bloques personalizados de la plantilla ``fields.html.twig`` creada anteriormente, modifica el archivo de configuración de tu aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - twig: - form: - resources: - - 'AcmeTaskBundle:Form:fields.html.twig' - # ... - - .. code-block:: xml - - - - - AcmeTaskBundle:Form:fields.html.twig - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('twig', array( - 'form' => array( - 'resources' => array( - 'AcmeTaskBundle:Form:fields.html.twig', - ), - ), - // ... - )); - -Ahora se utilizan todos los bloques dentro de la plantilla ``fields.html.twig`` a nivel global para definir el formulario producido. - -.. sidebar:: Personalizando toda la salida del formulario en un único archivo con *Twig* - - En *Twig*, también puedes personalizar el bloque correcto de un formulario dentro de la plantilla donde se necesita esa personalización: - - .. code-block:: html+jinja - - {% extends '::base.html.twig' %} - - {# importa '_self' como el tema del formulario #} - {% form_theme form _self %} - - {# hace la personalización del fragmento del formulario #} - {% block form_row %} - {# pinta la fila del campo personalizado #} - {% endblock form_row %} - - {% block content %} - {# ... #} - - {{ form_row(form.task) }} - {% endblock %} - - La etiqueta ``{% form_theme form_self %}`` permite personalizar bloques directamente dentro de la plantilla que utilizará las personalizaciones. Utiliza este método para crear rápidamente formularios personalizados que sólo son necesarios en una sola plantilla. - - .. caution:: - - La funcionalidad ``{% form_theme form _self %}`` *únicamente* trabajará si tu plantilla extiende a otra. Si no, debes hacer que ``form_theme`` apunte a una plantilla distinta. - -*PHP* -..... - -Para incluir automáticamente *todas* las plantillas personalizadas del directorio `Acme/TaskBundle/Resources/views/Form` creado anteriormente, modifica el archivo de configuración de tu aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - templating: - form: - resources: - - 'AcmeTaskBundle:Form' - # ... - - - .. code-block:: xml - - - - - - AcmeTaskBundle:Form - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - 'templating' => array( - 'form' => array( - 'resources' => array( - 'AcmeTaskBundle:Form', - ), - ), - ) - // ... - )); - -Cualquier fragmento dentro del directorio `Acme/TaskBundle/Resources/views/Form` ahora se utiliza globalmente para definir la salida del formulario. - -.. index:: - single: Formularios; Protección CSRF - -.. _forms-csrf: - -Protección *CSRF* ------------------ - -*CSRF* (Cross-site request forgery) ---o `Falsificación de petición en sitios cruzados`_--- es un método por el cual un usuario malintencionado intenta hacer que tus usuarios legítimos, sin saberlo, presenten datos que no tienen la intención de enviar. Afortunadamente, los ataques *CSRF* se pueden prevenir usando un elemento *CSRF* dentro de tus formularios. - -La buena nueva es que, por omisión, *Symfony* integra y valida elementos *CSRF* automáticamente. Esto significa que puedes aprovechar la protección *CSRF* sin hacer nada. De hecho, ¡cada formulario en este capítulo se ha aprovechado de la protección *CSRF*! - -La protección *CSRF* funciona añadiendo un campo oculto al formulario ---por omisión denominado ``_token``--- el cual contiene un valor que sólo tú y tu usuario conocen. Esto garantiza que el usuario ---y no alguna otra entidad--- es el que presenta dichos datos. -*Symfony* automáticamente valida la presencia y exactitud de este elemento. - -El campo ``_token`` es un campo oculto y será reproducido automáticamente si se incluye la función ``form_rest()`` de la plantilla, la cual garantiza que se presenten todos los campos producidos. - -El elemento *CSRF* se puede personalizar formulario por formulario. Por ejemplo:: - - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class TaskType extends AbstractType - { - // ... - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\TaskBundle\Entity\Task', - 'csrf_protection' => true, - 'csrf_field_name' => '_token', - // una clave única para ayudar generar la ficha secreta - 'intention' => 'task_item', - )); - } - - // ... - } - -Para desactivar la protección *CSRF*, fija la opción ``csrf_protection`` a ``false``. -Las personalizaciones también se pueden hacer a nivel global en tu proyecto. Para más información, consulta la sección :ref:`referencia de configuración de formularios `. - -.. note:: - - La opción ``intention`` es opcional pero mejora considerablemente la seguridad del elemento generado produciendo uno diferente para cada formulario. - -.. index:: - single: Formularios; Sin clase - -Usando un formulario sin clase ------------------------------- - -En la mayoría de los casos, un formulario está ligado a un objeto, y los campos del formulario obtienen y almacenan sus datos en las propiedades de ese objeto. Esto exactamente es lo que has visto hasta ahora en este capítulo con la clase ``Task``. - -Pero a veces, es posible que sólo desees utilizar un formulario sin una clase, y devolver un arreglo de los datos presentados. Esto realmente es muy fácil:: - - // asegúrate de importar el espacio de nombres Request antes de la clase - use Symfony\Component\HttpFoundation\Request; - // ... - - public function contactAction(Request $request) - { - $defaultData = array('message' => 'Type your message here'); - $form = $this->createFormBuilder($defaultData) - ->add('name', 'text') - ->add('email', 'email') - ->add('message', 'textarea') - ->getForm(); - - if ($request->isMethod('POST')) { - $form->bind($request); - - // data es un arreglo con claves 'name', 'email', y 'message' - $data = $form->getData(); - } - - // ... pinta el formulario - } - -Por omisión, un formulario en realidad asume que deseas trabajar con arreglos de datos, en lugar de con un objeto. Hay exactamente dos maneras en que puedes cambiar este comportamiento y en su lugar enlazar el formulario a un objeto: - -#. Pasa un objeto al crear el formulario (como primer argumento de ``createFormBuilder`` o segundo argumento de ``createForm``); - -#. Declara la opción ``data_class`` en tu formulario. - -Si *no* haces ninguna de estas, entonces el formulario devolverá los datos como un arreglo. En este ejemplo, debido a que ``$defaultData`` no es un objeto (y no se ha establecido la opción ``data_class``), en última instancia ``$form->getData()``, devuelve un arreglo. - -.. tip:: - - También puedes acceder a los valores *POST* (en este caso ``«name»``) directamente a través del objeto ``Petición``, de la siguiente manera:: - - $this->get('request')->request->get('name'); - - Ten en cuenta, sin embargo, que en la mayoría de los casos una mejor opción es utilizar el método ``getData()``, ya que devuelve los datos (generalmente un objeto), después de que la infraestructura del formulario los ha transformado. - -Añadiendo validación -~~~~~~~~~~~~~~~~~~~~ - -La única pieza faltante es la validación. Por lo general, cuando llamas a ``$form->isValid()``, el objeto es validado leyendo las restricciones que aplicaste a esa clase. Si tu formulario está vinculado a un objeto (es decir, estás utilizando la opción ``data_class`` -o pasando un objeto a tu formulario), este casi siempre es el enfoque que quieres usar. Ve :doc:`/book/validation` para más detalles. - -.. _form-option-constraints: - -Pero si no está vinculado a un objeto y en cambio recuperaste un simple arreglo de los datos presentados, ¿cómo puedes agregar restricciones a los datos de tu formulario? - -La respuesta es configurar las restricciones tú mismo, y anexarlas a los campos individuales. El enfoque general está cubierto un poco más en el :ref:`capítulo de validación `, pero aquí está un pequeño ejemplo: - -.. versionadded:: 2.1 - La opción ``constraints``, que acepta una única restricción o un arreglo de restricciones (antes de 2.1, la opción fue llamada ``validation_constraint``, y sólo acepta una única restricción) es nueva para *Symfony 2.1*. - -.. code-block:: php - - use Symfony\Component\Validator\Constraints\Length; - use Symfony\Component\Validator\Constraints\NotBlank; - - $builder - ->add('firstName', 'text', array( - 'constraints' => new Length(array('min' => 3)), - )) - ->add('lastName', 'text', array( - 'constraints' => array( - new NotBlank(), - new Length(array('min' => 3)), - ), - )) - ; - -.. tip:: - - Si utilizas grupos de validación, necesitas o bien hacer referencia al grupo ``Default`` al crear el formulario, o establecer el grupo correcto en la restricción que estás añadiendo. - -.. code-block:: php - - new NotBlank(array('groups' => array('create', 'update')) - - -Consideraciones finales ------------------------ - -Ahora ya conoces todos los bloques de construcción necesarios para elaborar formularios complejos y funcionales para tu aplicación. Cuando construyas formularios, ten en cuenta que el primer objetivo de un formulario es traducir los datos de un objeto (``Task``) a un formulario *HTML* para que el usuario pueda modificar esos datos. El segundo objetivo de un formulario es tomar los datos presentados por el usuario y volverlos a aplicar al objeto. - -Todavía hay mucho más que aprender sobre el poderoso mundo de los formularios, tal como la forma de :doc:`manejar archivos subidos con Doctrine ` o cómo crear un formulario donde puedes agregar dinámicamente una serie de subformularios (por ejemplo, una lista de tareas donde puedes seguir añadiendo más campos a través de *Javascript* antes de presentarlos). Consulta el recetario para estos temas. Además, asegúrate de apoyarte en la :doc:`referencia de tipos de campo `, que incluye ejemplos de cómo utilizar cada tipo de campo y sus opciones. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/doctrine/file_uploads` -* :doc:`Referencia del campo File ` -* :doc:`Creando tipos de campo personalizados ` -* :doc:`/cookbook/form/form_customization` -* :doc:`/cookbook/form/dynamic_form_modification` -* :doc:`/cookbook/form/data_transformers` - -.. _`Componente Form de Symfony2`: https://github.com/symfony/Form -.. _`DateTime`: http://www.php.net/manual/es/class.datetime.php -.. _`puente Twig`: https://github.com/symfony/symfony/tree/2.2/src/Symfony/Bridge/Twig -.. _`form_div_layout.html.twig`: https://github.com/symfony/symfony/blob/2.2/src/Symfony/Bridge/Twig/Resources/views/Form/form_div_layout.html.twig -.. _`Falsificación de petición en sitios cruzados`: http://es.wikipedia.org/wiki/Cross_Site_Request_Forgery -.. _`ver en GitHub`: https://github.com/symfony/symfony/tree/2.2/src/Symfony/Bundle/FrameworkBundle/Resources/views/Form diff --git a/_sources/book/from_flat_php_to_symfony2.txt b/_sources/book/from_flat_php_to_symfony2.txt deleted file mode 100644 index 9cdcc90..0000000 --- a/_sources/book/from_flat_php_to_symfony2.txt +++ /dev/null @@ -1,628 +0,0 @@ -*Symfony2* frente a *PHP* simple -================================ - -**¿Por qué Symfony2 es mejor que sólo abrir un archivo y escribir PHP simple?** - -Si nunca has usado una plataforma *PHP*, no estás familiarizado con la filosofía *MVC*, o simplemente te preguntas qué es todo ese *alboroto* en torno a *Symfony2*, este capítulo es para ti. En vez de *decirte* que *Symfony2* te permite desarrollar software más rápido y mejor que con *PHP* simple, debes verlo tú mismo. - -En este capítulo, vamos a escribir una aplicación sencilla en *PHP* simple, y luego la reconstruiremos para que esté mejor organizada. Podrás viajar a través del tiempo, viendo las decisiones de por qué el desarrollo web ha evolucionado en los últimos años hasta donde está ahora. - -Al final, verás cómo *Symfony2* te puede rescatar de las tareas cotidianas y te permite recuperar el control de tu código. - -Un sencillo *blog* en *PHP* simple ----------------------------------- - -En este capítulo, crearemos una simbólica aplicación de *blog* utilizando sólo *PHP* simple. -Para empezar, crea una página que muestre las entradas del *blog* que se han persistido en la base de datos. Escribirla en *PHP* simple es rápido y sucio: - -.. code-block:: html+php - - - - - - - List of Posts - - -

List of Posts

- - - - - - -Eso es fácil de escribir, se ejecuta rápido, y, cuando tu aplicación crece, imposible de mantener. Hay varios problemas que es necesario abordar: - -* **No hay comprobación de errores**: ¿Qué sucede si falla la conexión a la base de datos? - -* **Deficiente organización**: Si la aplicación crece, este único archivo cada vez será más difícil de mantener, hasta que finalmente sea imposible. ¿Dónde se debe colocar el código para manejar un formulario enviado? ¿Cómo se pueden validar los datos? ¿Dónde debe ir el código para enviar mensajes de correo electrónico? - -* **Es difícil reutilizar el código**: Ya que todo está en un archivo, no hay manera de volver a utilizar alguna parte de la aplicación en otras «páginas» del *blog*. - -.. note:: - - Otro problema no mencionado aquí es el hecho de que la base de datos está vinculada a *MySQL*. Aunque no se ha tratado aquí, *Symfony2* integra `Doctrine`_ plenamente, una biblioteca dedicada a la abstracción y asignación de bases de datos. - -Trabajaremos en la solución de estos y muchos problemas más. - -Aislando la presentación -~~~~~~~~~~~~~~~~~~~~~~~~ - -El código inmediatamente se puede beneficiar de la separación entre la «lógica» de la aplicación y el código que prepara la «presentación» *HTML*: - -.. code-block:: html+php - - - - - List of Posts - - -

List of Posts

- - - - -Por convención, el archivo que contiene toda la lógica de la aplicación ---:file:`index.php`--- se conoce como *«controlador»*. El término :term:`controlador` es una palabra que se escucha mucho, independientemente del lenguaje o plataforma que utilices. Simplemente se refiere a la zona de *tu código* que procesa la entrada del usuario y prepara la respuesta. - -En este caso, el controlador prepara los datos de la base de datos y, luego los incluye en una plantilla para presentarlos. Con el controlador aislado, fácilmente podríamos cambiar *sólo* el archivo de plantilla si es necesario procesar las entradas del *blog* en algún otro formato (por ejemplo, ``lista.json.php`` para el formato *JSON*). - -Aislando la lógica de la aplicación (el dominio) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Hasta ahora, la aplicación sólo contiene una página. Pero ¿qué pasa si una segunda página necesita utilizar la misma conexión a la base de datos, e incluso el mismo arreglo de entradas del *blog*? Reconstruye el código para que el comportamiento de las funciones básicas de acceso a datos de la aplicación esté aislado en un nuevo archivo llamado :file:`model.php`: - -.. code-block:: html+php - - - - - - <?php echo $title ?> - - - - - - -La plantilla (``templates/list.php``) ahora se puede simplificar para «extender» el diseño: - -.. code-block:: html+php - - - - -

List of Posts

- - - - - -Ahora se introdujo una metodología que te permite reutilizar el diseño. Desafortunadamente, para lograrlo, estás obligado a utilizar en la plantilla algunas desagradables funciones de *PHP* (``ob_start()``, ``ob_get_clean()``). *Symfony2* utiliza un componente ``Templating`` que te permite realizar esto limpia y fácilmente. En breve lo verás en acción. - -Agregando una página ``«show»`` al *blog* ------------------------------------------ - -La página ``«list»`` del *blog* se ha rediseñado para que el código esté mejor organizado y sea reutilizable. Para probarlo, añade una página ``«show»`` al *blog*, que muestre una entrada individual del *blog* identificada por un parámetro de consulta ``id``. - -Para empezar, crea una nueva función en el archivo :file:`model.php` que recupere un resultado individual del *blog* basándose en un identificador dado:: - - // model.php - function get_post_by_id($id) - { - $link = open_database_connection(); - - $id = intval($id); - $query = 'SELECT date, title, body FROM post WHERE id = '.$id; - $result = mysql_query($query); - $row = mysql_fetch_assoc($result); - - close_database_connection($link); - - return $row; - } - -A continuación, crea un nuevo archivo llamado :file:`show.php` ---el controlador para esta nueva página: - -.. code-block:: html+php - - - - -

- -
-
- -
- - - - -Ahora, es muy fácil crear la segunda página y sin duplicar código. Sin embargo, esta página introduce problemas aún más perniciosos que una plataforma puede resolver por ti. Por ejemplo, un parámetro ``id`` ilegal u omitido en la consulta hará que la página se bloquee. Sería mejor si esto reprodujera una página 404, pero sin embargo, en realidad esto no se puede hacer fácilmente. Peor aún, si olvidaras desinfectar el parámetro ``id`` por medio de la función ``intval()``, tu base de datos estaría en riesgo de un ataque de inyección *SQL*. - -Otro importante problema es que cada archivo de controlador individual debe incluir al archivo :file:`model.php`. ¿Qué pasaría si cada archivo de controlador de repente tuviera que incluir un archivo adicional o realizar alguna tarea global (por ejemplo, reforzar la seguridad)? -Tal como está ahora, el código tendría que incluir todos los archivos de los controladores. -Si olvidas incluir algo en un solo archivo, esperemos que no sea alguno relacionado con la seguridad... - -El «controlador frontal» al rescate ------------------------------------ - -Una mucho mejor solución es usar un :term:`controlador frontal`: un único archivo *PHP* a través del cual se procesen *todas* las peticiones. Con un controlador frontal, la *URI* de la aplicación cambia un poco, pero se vuelve más flexible: - -.. code-block:: text - - Sin controlador frontal - /index.php => (ejecuta index.php) la página lista de mensajes. - /show.php => (ejecuta show.php) la página muestra un mensaje particular. - - Con index.php como controlador frontal - /index.php => (ejecuta index.php) la página lista de mensajes. - /index.php/show => (ejecuta index.php) la página muestra un mensaje particular. - -.. tip:: - Puedes quitar la porción :file:`index.php` de la *URI* si utilizas las reglas de reescritura de *Apache* (o equivalentes). En ese caso, la *URI* resultante de la página show del *blog* simplemente sería ``/show``. - -Cuando se usa un controlador frontal, un solo archivo *PHP* (:file:`index.php` en este caso) procesa todas las peticiones. Para la página ``show`` del *blog*, ``/index.php/show`` realmente ejecuta el archivo :file:`index.php`, que ahora es el responsable de dirigir internamente las peticiones basándose en la *URI* completa. Como puedes ver, un controlador frontal es una herramienta muy poderosa. - -Creando el controlador frontal -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Estás a punto de dar un **gran** paso en la aplicación. Con un archivo manejando todas las peticiones, puedes centralizar cosas tales como el manejo de la seguridad, la carga de configuración y enrutado. En esta aplicación, :file:`index.php` ahora debe ser lo suficientemente inteligente como para reproducir la lista de entradas del *blog* *o* mostrar la página de una entrada particular basándose en la *URI* solicitada: - -.. code-block:: html+php - -

Page Not Found

'; - } - -Por organización, ambos controladores (antes :file:`index.php` y :file:`show.php`) son funciones *PHP* y cada una se ha movido a un archivo separado, :file:`controllers.php`: - -.. code-block:: php - - function list_action() - { - $posts = get_all_posts(); - require 'templates/list.php'; - } - - function show_action($id) - { - $post = get_post_by_id($id); - require 'templates/show.php'; - } - -Como controlador frontal, :file:`index.php` ha asumido un papel completamente nuevo, el cual incluye la carga de las bibliotecas del núcleo y encaminar la aplicación para invocar a uno de los dos controladores (las funciones ``list_action()`` y ``show_action()``). En realidad, el controlador frontal está empezando a verse y actuar como el mecanismo *Symfony2* para la manipulación y enrutado de peticiones. - -.. tip:: - - Otra ventaja del controlador frontal es la flexibilidad de las *URL*. Ten en cuenta que la *URL* a la página ``show`` del *blog* se puede cambiar de ``/show`` a ``/read`` cambiando el código solamente en una única ubicación. Antes, era necesario cambiar todo un archivo para cambiar el nombre. En *Symfony2*, incluso las *URL* son más flexibles. - -Por ahora, la aplicación ha evolucionado de un único archivo *PHP*, a una estructura organizada y permite la reutilización de código. Debes estar feliz, pero aún lejos de estar satisfecho. Por ejemplo, el sistema de «enrutado» es voluble, y no reconoce que la página ``list`` (``/index.php``) también debe ser accesible a través de ``/`` (si has agregado las reglas de reescritura de *Apache*). Además, en lugar de desarrollar el *blog*, una gran cantidad del tiempo se ha gastado trabajando en la «arquitectura» del código (por ejemplo, el enrutado, invocando controladores, plantillas, etc.) Se tendrá que gastar más tiempo para manejar el envío de formularios, validación de entradas, llevar la bitácora de sucesos y la seguridad. -¿Por qué tienes que reinventar soluciones a todos estos problemas rutinarios? - -Añadiendo un toque *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Symfony2* al rescate. Antes de utilizar *Symfony2* realmente, necesitas descargarlo. Esto se puede hacer utilizando ``Composer``, el cual cuida de descargar la versión -correcta con todas sus dependencias y proporciona un cargador automático. Un cargador automático es una herramienta que permite empezar a utilizar clases *PHP* sin incluir explícitamente el archivo que contiene la clase. - -En tu directorio raíz crea un archivo de texto llamado :file:`composer.json` con el siguiente contenido: - -.. code-block:: json - - { - "require": { - "symfony/symfony": "2.2.*" - }, - "autoload": { - "files": ["model.php","controllers.php"] - } - } - -Luego, `descarga Composer`_ y entonces ejecuta la siguiente orden, la cual descargará *Symfony* a un directorio :file:`vendor/`: - -.. code-block:: bash - - $ php composer.phar install - -Junto con la descarga de tus dependencias, ``Composer`` genera un archivo :file:`vendor/autoload.php`, el cual cuida de cargar automáticamente todos los archivos en la platafomra *Symfony* así como los archivos mencionados en la sección ``autoload`` de tu :file:`composer.json`. - -La esencia de la filosofía *Symfony* es la idea de que el trabajo principal de una aplicación es interpretar cada petición y devolver una respuesta. Con este fin, *Symfony2* proporciona ambas clases :class:`Symfony\\Component\\HttpFoundation\\Request` y :class:`Symfony\\Component\\HttpFoundation\\Response`. Estas clases son representaciones orientadas a objetos de la petición *HTTP* que se está procesando y la respuesta *HTTP* que devolverá. Úsalas para mejorar el *blog*: - -.. code-block:: html+php - - getPathInfo(); - if ('/' == $uri) { - $response = list_action(); - } elseif ('/show' == $uri && $request->query->has('id')) { - $response = show_action($request->query->get('id')); - } else { - $html = '

Page Not Found

'; - $response = new Response($html, 404); - } - - // difunde las cabeceras y envía la respuesta - $response->send(); - -Los controladores son responsables de devolver un objeto ``Respuesta``. -Para facilitarnos esto, puedes agregar una nueva función ``render_template()``, la cual, por cierto, actúa un poco como el motor de plantillas de *Symfony2*: - -.. code-block:: php - - // controllers.php - use Symfony\Component\HttpFoundation\Response; - - function list_action() - { - $posts = get_all_posts(); - $html = render_template('templates/list.php', array('posts' => $posts)); - - return new Response($html); - } - - function show_action($id) - { - $post = get_post_by_id($id); - $html = render_template('templates/show.php', array('post' => $post)); - - return new Response($html); - } - - // función ayudante para reproducir plantillas - function render_template($path, array $args) - { - extract($args); - ob_start(); - require $path; - $html = ob_get_clean(); - - return $html; - } - -Al reunir una pequeña parte de *Symfony2*, la aplicación es más flexible y fiable. La ``Petición`` proporciona una manera confiable para acceder a información de la petición *HTTP*. Especialmente, el método ``getPathInfo()`` devuelve una *URI* limpia (siempre devolviendo ``/show`` y nunca ``/index.php/show``). -Por lo tanto, incluso si el usuario va a ``/index.php/show``, la aplicación es lo suficientemente inteligente para encaminar la petición hacia ``show_action()``. - -El objeto ``Respuesta`` proporciona flexibilidad al construir la respuesta *HTTP*, permitiendo que las cabeceras *HTTP* y el contenido se agreguen a través de una interfaz orientada a objetos. -Y aunque las respuestas en esta aplicación son simples, esta flexibilidad pagará dividendos en cuanto tu aplicación crezca. - -Aplicación de ejemplo en *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El *blog* ha *avanzado*, pero todavía contiene una gran cantidad de código para una aplicación tan simple. De paso, también inventamos un sencillo sistema de enrutado y un método utilizando ``ob_start()`` y ``ob_get_clean()`` para procesar plantillas. Si por alguna razón, necesitas continuar la construcción de esta «plataforma» desde cero, por lo menos puedes usar los componentes independientes `Routing`_ y `Templating`_ de *Symfony*, que resuelven estos problemas. - -En lugar de volver a solucionar problemas comunes, puedes dejar que *Symfony2* se preocupe de ellos por ti. Aquí está la misma aplicación de ejemplo, ahora construida en *Symfony2*:: - - // src/Acme/BlogBundle/Controller/BlogController.php - namespace Acme\BlogBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - - class BlogController extends Controller - { - public function listAction() - { - $posts = $this->get('doctrine')->getManager() - ->createQuery('SELECT p FROM AcmeBlogBundle:Post p') - ->execute(); - - return $this->render( - 'AcmeBlogBundle:Blog:list.html.php', - array('posts' => $posts) - ); - } - - public function showAction($id) - { - $post = $this->get('doctrine') - ->getManager() - ->getRepository('AcmeBlogBundle:Post') - ->find($id) - ; - - if (!$post) { - // provoca que se muestre la página de error 404 - throw $this->createNotFoundException(); - } - - return $this->render( - 'AcmeBlogBundle:Blog:show.html.php', - array('post' => $post) - ); - } - } - -Los dos controladores siguen siendo ligeros. Cada uno utiliza la :doc:`biblioteca ORM de Doctrine ` para recuperar objetos de la base de datos y el componente ``Templating`` para reproducir una plantilla y devolver un objeto ``Respuesta``. La plantilla ``list`` ahora es un poco más simple: - -.. code-block:: html+php - - - extend('::layout.html.php') ?> - - set('title', 'List of Posts') ?> - -

List of Posts

- - -El diseño es casi idéntico: - -.. code-block:: html+php - - - - - - <?php echo $view['slots']->output( - 'title', - 'Default title' - ) ?> - - - output('_content') ?> - - - -.. note:: - - Te vamos a dejar como ejercicio la plantilla ``show``, porque debería ser trivial crearla basándote en la plantilla ``list``. - -Cuando arranca el motor *Symfony2* (conocido como el ``núcleo``), necesita un mapa para saber qué controladores ejecutar basándose en la información solicitada. -Un mapa de configuración de enrutado proporciona esta información en formato legible: - -.. code-block:: yaml - - # app/config/routing.yml - blog_list: - path: /blog - defaults: { _controller: AcmeBlogBundle:Blog:list } - - blog_show: - path: /blog/show/{id} - defaults: { _controller: AcmeBlogBundle:Blog:show } - -Ahora que *Symfony2* se encarga de todas las tareas rutinarias, el controlador frontal es muy simple. Y debido a que hace tan poco, nunca tienes que volver a tocarlo una vez creado (y si utilizas una distribución *Symfony2*, ¡ni siquiera tendrás que crearlo!):: - - // web/app.php - require_once __DIR__.'/../app/bootstrap.php'; - require_once __DIR__.'/../app/AppKernel.php'; - - use Symfony\Component\HttpFoundation\Request; - - $kernel = new AppKernel('prod', false); - $kernel->handle(Request::createFromGlobals())->send(); - -El único trabajo del controlador frontal es iniciar el motor de *Symfony2* (``núcleo``) y pasarle un objeto ``Petición`` para que lo manipule. El núcleo de *Symfony2* entonces utiliza el mapa de enrutado para determinar qué controlador invocar. Al igual que antes, el método controlador es el responsable de devolver el objeto ``Respuesta`` final. -Realmente no hay mucho más sobre él. - -Para conseguir una representación visual de cómo maneja *Symfony2* cada petición, consulta el :ref:`diagrama de flujo de la petición `. - -Qué más ofrece *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~ - -En los siguientes capítulos, aprenderás más acerca de cómo funciona cada pieza de *Symfony* y la organización recomendada de un proyecto. Por ahora, vamos a ver cómo, migrar el *blog* de *PHP* simple a *Symfony2* nos ha mejorado la vida: - -* Tu aplicación cuenta con **código claro y organizado consistentemente** (aunque *Symfony* no te obliga a ello). Este promueve la **reutilización** y permite a los nuevos desarrolladores ser productivos en el proyecto con mayor rapidez. - -* 100% del código que escribes es para *tu* aplicación. **No necesitas desarrollar o mantener servicios públicos de bajo nivel** tal como la :ref:`carga automática ` de clases, el :doc:`enrutado ` o la reproducción de :doc:`controladores `; - -* *Symfony2* te proporciona **acceso a herramientas de código abierto** tal como *Doctrine*, plantillas, seguridad, formularios, validación y componentes de traducción (por nombrar algunos); - -* La aplicación ahora disfruta de **direcciones URL totalmente flexibles** gracias al componente ``Routing``; - -* La arquitectura centrada en *HTTP* de *Symfony2* te da acceso a poderosas herramientas, tal como la **memoria caché HTTP** impulsadas por la **caché HTTP interna de Symfony2** o herramientas más poderosas, tales como `Varnish`_. Esto se trata posteriormente en el capítulo «:doc:`todo sobre caché `». - -Y lo mejor de todo, utilizando *Symfony2*, ¡ahora tienes acceso a un conjunto de herramientas de **código abierto de alta calidad desarrolladas por la comunidad Symfony2**! -Puedes encontrar una buena colección de herramientas comunitarias de *Symfony2* en `KnpBundles.com`_. - -Mejores plantillas ------------------- - -Si decides utilizarlo, *Symfony2* de serie viene con un motor de plantillas llamado `Twig`_ el cual hace que las plantillas se escriban más rápido y sean más fáciles de leer. -Esto significa que, incluso, ¡la aplicación de ejemplo podría contener mucho menos código! Toma por ejemplo, la plantilla ``list`` escrita en *Twig*: - -.. code-block:: html+jinja - - {# src/Acme/BlogBundle/Resources/views/Blog/list.html.twig #} - {% extends "::layout.html.twig" %} - - {% block title %}List of Posts{% endblock %} - - {% block body %} -

List of Posts

- - {% endblock %} - -También es fácil escribir la plantilla ``layout.html.twig`` correspondiente: - -.. code-block:: html+jinja - - {# app/Resources/views/layout.html.twig #} - - - - {% block title %}Default title{% endblock %} - - - {% block body %}{% endblock %} - - - -*Twig* es compatible con *Symfony2*. Y si bien, las plantillas *PHP* siempre contarán con el apoyo de *Symfony2*, vamos a seguir explicando muchas de las ventajas de *Twig*. Para más información, consulta el capítulo :doc:`Plantillas `. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/templating/PHP` -* :doc:`/cookbook/controller/service` - -.. _`Doctrine`: http://www.doctrine-project.org -.. _`descarga Composer`: http://getcomposer.org/download/ -.. _`Routing`: https://github.com/symfony/Routing -.. _`Templating`: https://github.com/symfony/Templating -.. _`KnpBundles.com`: http://knpbundles.com/ -.. _`Twig`: http://gitnacho.github.com/symfony-docs-es/twig/index.html -.. _`Varnish`: https://www.varnish-cache.org/ -.. _`PHPUnit`: http://www.phpunit.de diff --git a/_sources/book/http_cache.txt b/_sources/book/http_cache.txt deleted file mode 100644 index 386a01b..0000000 --- a/_sources/book/http_cache.txt +++ /dev/null @@ -1,788 +0,0 @@ -.. index:: - single: Caché - -Caché *HTTP* -============ - -La naturaleza de las aplicaciones *web* ricas significa que son dinámicas. No importa qué tan eficiente sea tu aplicación, cada petición siempre contendrá más sobrecarga que simplemente servir un archivo estático. - -Y para la mayoría de las aplicaciones *Web*, está bien. *Symfony2* es tan rápido como el rayo, a menos que estés haciendo una muy complicada aplicación, cada petición se responderá rápidamente sin poner demasiada tensión a tu servidor. - -Pero cuando tu sitio crezca, la sobrecarga general se puede convertir en un problema. El procesamiento que se realiza normalmente en cada petición se debe hacer sólo una vez. Este exactamente es el objetivo que tiene que consumar la memoria caché. - -La memoria caché en hombros de gigantes ---------------------------------------- - -La manera más efectiva para mejorar el rendimiento de una aplicación es memorizar en caché la salida completa de una página y luego eludir por completo la aplicación en cada petición posterior. Por supuesto, esto no siempre es posible para los sitios web altamente dinámicos, ¿o no? En este capítulo, te mostraremos cómo funciona el sistema de caché *Symfony2* y por qué este es el mejor enfoque posible. - -El sistema de cache *Symfony2* es diferente porque se basa en la simplicidad y el poder de la caché *HTTP* tal como está definida en la :term:`especificación HTTP`. -En lugar de reinventar una metodología de memoria caché, *Symfony2* adopta la norma que define la comunicación básica en la Web. Una vez que comprendas los principios fundamentales de los modelos de caducidad y validación de la memoria caché *HTTP*, estarás listo para dominar el sistema de caché *Symfony2*. - -Para efectos de aprender cómo guardar en caché con *Symfony2*, abordaremos el tema en cuatro pasos: - -#. Una :ref:`pasarela de caché `, o delegado inverso (``«proxy»``), es una capa independiente situada frente a tu aplicación. La caché del delegado inverso responde a medida que son devueltas desde tu aplicación y contesta a peticiones con respuestas de la caché antes de que lleguen a tu aplicación. *Symfony2* proporciona su propio delegado inverso, pero puedes utilizar cualquier delegado inverso. - -#. Las cabeceras de :ref:`cache HTTP ` se utilizan para comunicarse con la pasarela de caché y cualquier otra caché entre tu aplicación y el cliente. *Symfony2* proporciona parámetros predeterminados y una potente interfaz para interactuar con las cabeceras de caché. - -#. La :ref:`caducidad y validación ` *HTTP* son los dos modelos utilizados para determinar si el contenido memorizado en caché es *fresco* (se puede reutilizar de la memoria caché) u *obsoleto* (lo debe regenerar la aplicación). - -#. :ref:`Inclusión del borde lateral ` (*Edge Side Includes -ESI*) permite que la caché *HTTP* utilice fragmentos de la página en caché (incluso fragmentos anidados) independientemente. - Con *ESI*, incluso puedes guardar en caché una página entera durante 60 minutos, pero una barra lateral integrada sólo por 5 minutos. - -Dado que la memoria caché *HTTP* no es exclusiva de *Symfony*, ya existen muchos artículos sobre el tema. Si eres novato en el tema de la memoria caché *HTTP*, te *recomendamos* el artículo de Ryan Tomayko `Things Caches Do`_. Otro recurso que aborda el tema es la `Guía de caché`_ de Mark Nottingham. - -.. index:: - single: Caché; Delegado - single: Caché; Delegado inverso - single: Caché; Pasarela - -.. _gateway-caches: - -Memoria caché con pasarela de caché ------------------------------------ - -Cuándo memorizar caché con *HTTP*, la *caché* está separada de tu aplicación por completo y se sitúa entre tu aplicación y el cliente haciendo la petición. - -El trabajo de la caché es aceptar las peticiones del cliente y pasarlas de nuevo a tu aplicación. La memoria caché también recibirá las respuestas devueltas por tu aplicación y las remitirá al cliente. La caché es el «geniecillo» de la comunicación petición-respuesta entre el cliente y tu aplicación. - -De paso, la memoria caché almacena cada respuesta que se considere «almacenable en caché» (consulta :ref:`http-cache-introduction`). Si de nuevo se solicita el mismo recurso, la memoria caché envía la respuesta memorizada en caché al cliente, eludiendo tu aplicación por completo. - -Este tipo de caché se conoce como pasarela de caché *HTTP* y existen muchas como `Varnish`_, `Squid en modo delegado inverso`_ y el delegado inverso de *Symfony2*. - -.. index:: - single: Caché; Tipos de - -Tipos de Caché -~~~~~~~~~~~~~~ - -Sin embargo, una pasarela de caché no es el único tipo de caché. De hecho, las cabeceras de caché *HTTP* enviadas por tu aplicación son consumidas e interpretadas por un máximo de tres diferentes tipos de caché: - -* *Caché de navegadores*: Cada navegador viene con su propia caché local, lo cual es realmente útil para cuando pulsas «atrás» o para imágenes y otros activos. - La caché del navegador es una caché *privada*, los recursos memorizados en caché no se comparten con nadie más; - -* *Delegados de caché*: Un delegado de caché *compartida* es aquel en el cual muchas personas pueden estar detrás de uno solo. Por lo general instalado por las grandes corporaciones y proveedores de Internet para reducir latencia y tráfico de red; - -* *Pasarela de caché*: Al igual que un delegado, también es una caché *compartida* pero en el lado del servidor. Instalada por los administradores de red, esta tiene sitios web más escalables, confiables y prácticos. - -.. tip:: - - Las pasarelas de caché a veces también se conocen como delegados inversos de caché, cachés alquiladas o incluso aceleradores *HTTP*. - -.. note:: - - La importancia de la caché *privada* frente a la *compartida* será más evidente a medida que hablemos de las respuestas en la memoria caché con contenido que es específico para un solo usuario (por ejemplo, información de cuenta). - -Cada respuesta de tu aplicación probablemente vaya a través de uno o los dos primeros tipos de caché. Estas cachés están fuera de tu control, pero siguen las instrucciones de la caché *HTTP* establecidas en la respuesta. - -.. index:: - single: Caché; Delegado inverso de Symfony2 - -.. _`symfony-gateway-cache`: - -Delegado inverso de *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Symfony2* viene con un delegado inverso de caché (también conocido como pasarela de caché) escrito en *PHP*. Que al activarla, inmediatamente puede memorizar en caché respuestas de tu aplicación. La instalación es muy fácil. Cada nueva aplicación *Symfony2* viene con una caché preconfigurada en el núcleo (``AppCache``) que envuelve al predeterminado (``AppKernel``). El núcleo de la memoria caché *es* el delegado inverso. - -Para habilitar la memoria caché, modifica el código de un controlador frontal para utilizar la caché del núcleo:: - - // web/app.php - require_once __DIR__.'/../app/bootstrap.php.cache'; - require_once __DIR__.'/../app/AppKernel.php'; - require_once __DIR__.'/../app/AppCache.php'; - - use Symfony\Component\HttpFoundation\Request; - - $kernel = new AppKernel('prod', false); - $kernel->loadClassCache(); - // envuelve el AppKernel predeterminado con un AppCache - $kernel = new AppCache($kernel); - $request = Request::createFromGlobals(); - $response = $kernel->handle($request); - $response->send(); - $kernel->terminate($request, $response); - -La memoria caché del núcleo actúa de inmediato como un delegado inverso ---memorizando en caché las respuestas de tu aplicación y devolviéndolas al cliente---. - -.. tip:: - - La caché del núcleo tiene un método especial `getLog()`, el cual devuelve una cadena que representa lo que sucedió en la capa de la caché. En el entorno de desarrollo, se usa para depurar y validar la estrategia de caché:: - - error_log($kernel->getLog()); - -El objeto ``AppCache`` tiene una sensible configuración predeterminada, pero la puedes afinar por medio de un conjunto de opciones que puedes configurar sustituyendo el método :method:`Symfony\\Bundle\\FrameworkBundle\\HttpCache\\HttpCache::getOptions`:: - - // app/AppCache.php - use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache; - - class AppCache extends HttpCache - { - protected function getOptions() - { - return array( - 'debug' => false, - 'default_ttl' => 0, - 'private_headers' => array('Authorization', 'Cookie'), - 'allow_reload' => false, - 'allow_revalidate' => false, - 'stale_while_revalidate' => 2, - 'stale_if_error' => 60, - ); - } - } - -.. tip:: - - A menos que la sustituyas en ``getOptions()``, la opción ``debug`` se establecerá automáticamente al valor de depuración del ``AppKernel`` envuelto. - -Aquí está una lista de las principales opciones: - -* ``default_ttl``: El número de segundos que una entrada de caché se debe considerar nueva cuando no hay información fresca proporcionada explícitamente en una respuesta. Las cabeceras explícitas ``Cache-Control`` o ``Expires`` sustituyen este valor (predeterminado: ``0``); - -* ``private_headers``: Conjunto de cabeceras de la petición que desencadenan el comportamiento ``Cache-Control`` «privado» en las respuestas en que no son clasificadas explícitamente como ``públicas`` o ``privadas`` vía una directiva ``Cache-Control``. - (default: ``Authorization`` y :dfn:`cookie`); - -* ``allow_reload``: Especifica si el cliente puede forzar una recarga desde caché incluyendo una directiva ``Cache-Control`` «``no-cache``» en la petición. Selecciona ``true`` para cumplir con la RFC 2616 (por omisión: ``false``); - -* ``allow_revalidate``: Especifica si el cliente puede forzar una revalidación de caché incluyendo una directiva ``Cache-Control`` ``max-age = 0`` en la petición. Ponla en ``true`` para cumplir con la RFC 2616 (por omisión: false); - -* ``stale_while_revalidate``: Especifica el número de segundos predeterminado (la granularidad es el segundo puesto que la precisión de respuesta *TTL* es un segundo) durante el cual la memoria caché puede regresar inmediatamente una respuesta obsoleta mientras que revalida en segundo plano (por omisión: ``2``); este ajuste lo reemplaza ``stale-while-revalidate`` de la extensión *HTTP* ``Cache-Control`` (consulta la *RFC 5.861*); - -* ``stale_if_error``: Especifica el número de segundos predeterminado (la granularidad es el segundo) durante el cual la caché puede servir una respuesta obsoleta cuando se detecta un error (por omisión: ``60``). Este valor lo reemplaza ``stale-if-error`` de la extensión *HTTP* ``Cache-Control`` (consulta la RFC 5861). - -Si ``debug`` es ``true``, *Symfony2* automáticamente agrega una cabecera ``X-Symfony-Cache`` a la respuesta que contiene información útil acerca de aciertos y errores de caché. - -.. sidebar:: Cambiando de un delegado inverso a otro - - El delegado inverso de *Symfony2* es una gran herramienta a utilizar en el desarrollo de tu sitio web o al desplegar tu web en un servidor compartido donde no puedes instalar nada más allá que código *PHP*. Pero está escrito en *PHP*, y por lo tanto no puede ser tan rápido como un delegado escrito en *C*. Es por eso que recomendamos ---de ser posible--- usar *Varnish* o *Squid* en tus servidores de producción. La buena nueva es que el cambio de un servidor delegado a otro es fácil y transparente, sin modificar el código necesario en tu aplicación. Comienza fácilmente con el delegado inverso de *Symfony2* y actualiza a *Varnish* cuando aumente el tráfico. - - Para más información sobre el uso de *Varnish* con *Symfony2*, consulta el capítulo :doc:`Cómo usar Varnish ` en el recetario. - -.. note:: - - El rendimiento del delegado inverso de *Symfony2* es independiente de la complejidad de tu aplicación. Eso es porque el núcleo de tu aplicación sólo se inicia cuando la petición se debe remitir a ella. - -.. index:: - single: Caché; HTTP - -.. _http-cache-introduction: - -Introducción a la memoria caché *HTTP* --------------------------------------- - -Para aprovechar las ventajas de las capas de memoria caché disponibles, tu aplicación se debe poder comunicar con las respuestas que son memorizables y las reglas que rigen cuándo y cómo la caché será obsoleta. Esto se hace ajustando las cabeceras de caché *HTTP* en la respuesta. - -.. tip:: - - Ten en cuenta que *HTTP* no es más que el lenguaje (un lenguaje de texto simple) que los clientes web (navegadores, por ejemplo) y los servidores web utilizan para comunicarse entre sí. Cuando hablamos de la memoria caché *HTTP*, estamos hablando de la parte de ese lenguaje que permite a los clientes y servidores intercambiar información relacionada con la memoria caché. - -*HTTP* especifica cuatro cabeceras de caché para respuestas en las que estamos interesados aquí: - -* ``Cache-Control`` -* ``Expires`` -* ``ETag`` -* ``Last-Modified`` - -La cabecera más importante y versátil es la cabecera ``Cache-Control``, la cual en realidad es una colección de variada información de caché. - -.. note:: - - Cada una de las cabeceras se explica en detalle en la sección :ref:`http-expiration-validation`. - -.. index:: - single: Caché; Cabecera Cache-Control - single: Cabeceras HTTP; Cache-Control - -La cabecera ``Cache-Control`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La cabecera ``Cache-Control`` es la única que no contiene una, sino varias piezas de información sobre la memoria caché de una respuesta. Cada pieza de información está separada por una coma:: - - Cache-Control: private, max-age=0, must-revalidate - - Cache-Control: max-age=3600, must-revalidate - -*Symfony* proporciona una abstracción de la cabecera ``Cache-Control`` para hacer más manejable su creación:: - - // ... - - use Symfony\Component\HttpFoundation\Response; - - $response = new Response(); - - // marca la respuesta como pública o privada - $response->setPublic(); - $response->setPrivate(); - - // fija la edad máxima de privado o compartido - $response->setMaxAge(600); - $response->setSharedMaxAge(600); - - // fija una directiva Cache-Control personalizada - $response->headers->addCacheControlDirective('must-revalidate', true); - -Respuestas públicas frente a privadas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ambas, la pasarela de caché y el delegado de caché, son considerados como cachés «compartidas» debido a que el contenido memorizado en caché se comparte con más de un usuario. Si cada vez equivocadamente una memoria caché compartida almacena una respuesta específica al usuario, posteriormente la puede devolver a cualquier cantidad de usuarios diferentes. ¡Imagina si la información de tu cuenta se memoriza en caché y luego la regresa a todos los usuarios posteriores que soliciten la página de su cuenta! - -Para manejar esta situación, cada respuesta se puede fijar para que sea pública o privada: - -* *public*: Indica que la respuesta se puede memorizar en caché por ambas cachés privadas y compartidas; - -* *private*: Indica que la totalidad o parte del mensaje de la respuesta es para un solo usuario y no se debe memorizar en caché en una caché compartida. - -Por omisión, *Symfony* conservadoramente fija cada respuesta para que sea privada. Para aprovechar las ventajas de las cachés compartidas (como el delegado inverso de *Symfony2*), explícitamente deberás fijar la respuesta como pública. - -.. index:: - single: Caché; Métodos seguros - -Métodos seguros -~~~~~~~~~~~~~~~ - -La memoria caché *HTTP* sólo funciona para métodos *HTTP* «seguros» (como *GET* y *HEAD*). Estar seguro significa que nunca cambia de estado la aplicación en el servidor al servir la petición (por supuesto puedes registrar información, datos de la caché, etc.) -Esto tiene dos consecuencias muy razonables: - -* *Nunca* debes cambiar el estado de tu aplicación al responder a una petición *GET* o *HEAD*. Incluso si no utilizas una pasarela caché, la presencia del delegado de caché significa que alguna petición *GET* o *HEAD* puede o no llegar a tu servidor; - -* No esperes que haya métodos *PUT*, *POST* o *DELETE* en caché. Estos métodos están diseñados para utilizarse al mutar el estado de tu aplicación (por ejemplo, borrar una entrada de *blog*). La memoria caché debe impedir que determinadas peticiones toquen y muten tu aplicación. - -Reglas de caché y valores predeterminados -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*HTTP* 1.1 por omisión, permite memorizar en caché cualquier cosa a menos que haya una cabecera ``Cache-Control`` explícita. En la práctica, la mayoría de las cachés no hacen nada cuando las peticiones tienen una ``galleta``, una cabecera de autorización, utilizan un método no seguro (es decir, *PUT*, *POST*, *DELETE*), o cuando las respuestas tienen código de redirección de estado. - -*Symfony2* automáticamente establece una sensible y conservadora cabecera ``Cache-Control`` cuando esta no está definida por el desarrollador, siguiendo estas reglas: - -* Si no has definido cabecera caché (``Cache-Control``, ``Expires``, ``ETag`` o ``Last-Modified``), ``Cache-Control`` es establecida en ``no-cache``, lo cual significa que la respuesta no se guarda en caché; - -* Si ``Cache-Control`` está vacía (pero una de las otras cabeceras de caché está presente), su valor se establece en ``private, must-revalidate``; - -* Pero si por lo menos una directiva ``Cache-Control`` está establecida, y no se han añadido directivas ``public`` o ``private`` de forma explícita, *Symfony2* agrega la directiva ``private`` automáticamente (excepto cuando ``s-maxage`` está establecida). - -.. _http-expiration-validation: - -Caducidad y validación *HTTP* ------------------------------ - -La especificación *HTTP* define dos modelos de memoria caché: - -* Con el `modelo de caducidad`_, sólo tienes que especificar el tiempo en que la respuesta se debe considerar «fresca» incluyendo una cabecera ``Cache-Control`` y/o una ``Expires``. Las cachés que entienden de expiración no harán la misma petición hasta que la versión en caché alcance el límite de caducidad y se vuelva «obsoleta»; - -* Cuando las páginas realmente son dinámicas (es decir, su representación cambia con mucha frecuencia), a menudo es necesario el `modelo de validación`_. Con este modelo, la memoria caché memoriza la respuesta, pero, pregunta al servidor en cada petición si la respuesta memorizada sigue siendo válida. La aplicación utiliza un identificador de respuesta único (la cabecera ``Etag``) y/o una marca de tiempo (la cabecera ``Last-Modified``) para comprobar si la página ha cambiado desde su memorización en caché. - -El objetivo de ambos modelos es nunca generar la misma respuesta en dos ocasiones dependiendo de una caché para almacenar y devolver respuestas «``frescas``». - -.. sidebar:: Leyendo la especificación *HTTP* - - La especificación *HTTP* define un sencillo pero potente lenguaje con el cual clientes y servidores se pueden comunicar. Como desarrollador *web*, el modelo petición-respuesta de la especificación domina tu trabajo. Lamentablemente, el documento de la especificación real ---`RFC 2616`_--- puede ser difícil de leer. - - Hay un esfuerzo en curso (`HTTP Bis`_) para reescribir la RFC 2616. Este no describe una nueva versión de *HTTP*, sino sobre todo aclara la especificación *HTTP* original. La organización también se ha mejorado ya que la especificación se divide en siete partes; todo lo relacionado con la caché *HTTP* se puede encontrar en dos partes dedicadas (`P4 - Petición condicional`_ y `P6 - Caché: Navegador y caché intermedia`_). - - Como desarrollador web, estás invitado a leer la especificación. Su claridad y poder ---incluso más de diez años después de su creación--- tiene un valor incalculable. No te desanimes por la apariencia de la especificación ---su contenido es mucho más bello que la cubierta---. - -.. index:: - single: Caché; Caducidad HTTP - -Caducidad -~~~~~~~~~ - -El modelo de caducidad es el más eficiente y simple de los dos modelos de memoria caché y se debe utilizar siempre que sea posible. Cuando una respuesta se memoriza en caché con una caducidad, la caché memorizará la respuesta y la enviará directamente sin tocar a la aplicación hasta que esta caduque. - -El modelo de caducidad se puede lograr usando una de dos, casi idénticas, cabeceras *HTTP*: ``Expires`` o ``Cache-Control``. - -.. index:: - single: Caché; Cabecera Expires - single: Cabeceras HTTP; Expires - -Caducidad con la cabecera ``Expires`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -De acuerdo con la especificación *HTTP* «el campo de la cabecera ``Expires`` da la fecha/hora después de la cual se considera que la respuesta es vieja». La cabecera ``Expires`` se puede establecer con el método ``setExpires()`` de la ``Respuesta``. Esta necesita una instancia de ``DateTime`` como argumento:: - - $fecha = new DateTime(); - $date->modify('+600 seconds'); - - $response->setExpires($date); - -La cabecera *HTTP* resultante se ve de la siguiente manera: - -.. code-block:: text - - Expires: Thu, 01 Mar 2011 16:00:00 GMT - -.. note:: - - El método ``setExpires()`` automáticamente convierte la fecha a la zona horaria GMT como lo requiere la especificación. - -Ten en cuenta que en las versiones de *HTTP* anteriores a la 1.1 el servidor origen no estaba obligado a enviar la cabecera ``Date``. En consecuencia, la memoria caché (por ejemplo el navegador) podría -necesitar de contar en su reloj local para evaluar la cabecera ``Expires`` tomando el cálculo de la vida vulnerable para desviaciones del reloj. Otra limitación de la cabecera ``Expires`` es que la especificación establece que «Los servidores HTTP/1.1 no deben enviar fechas de más de un año en el futuro en ``Expires``». - -.. index:: - single: Caché; Cabecera Cache-Control - single: Cabeceras HTTP; Cache-Control - -Caducidad con la cabecera ``Cache-Control`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Debido a las limitaciones de la cabecera ``Expires``, la mayor parte del tiempo, debes usar la cabecera ``Cache-Control`` en su lugar. Recordemos que la cabecera ``Cache-Control`` se utiliza para especificar muchas directivas de caché diferentes. Para caducidad, hay dos directivas, ``max-age`` y ``s-maxage``. La primera la utilizan todas las cachés, mientras que la segunda sólo se tiene en cuenta por las cachés compartidas:: - - // Establece el número de segundos después de que la - // respuesta ya no se debe considerar fresca - $response->setMaxAge(600); - - // Lo mismo que la anterior pero sólo para cachés compartidas - $response->setSharedMaxAge(600); - -La cabecera ``Cache-Control`` debería tener el siguiente formato (esta puede tener directivas adicionales): - -.. code-block:: text - - Cache-Control: max-age=600, s-maxage=600 - -.. index:: - single: Caché; Validando - -Validando -~~~~~~~~~ - -Cuando un recurso se tiene que actualizar tan pronto como se realiza un cambio en los datos subyacentes, el modelo de caducidad se queda corto. Con el modelo de caducidad, no se pedirá a la aplicación que devuelva la respuesta actualizada hasta que la caché finalmente se convierta en obsoleta. - -El modelo de validación soluciona este problema. Bajo este modelo, la memoria caché sigue almacenando las respuestas. La diferencia es que, por cada petición, la caché pregunta a la aplicación cuando o no la respuesta memorizada sigue siendo válida. Si la caché todavía *es* válida, tu aplicación debe devolver un código de estado 304 y no el contenido. Esto le dice a la caché que está bien devolver la respuesta memorizada. - -Bajo este modelo, sobre todo ahorras ancho de banda ya que la representación no se envía dos veces al mismo cliente (en su lugar se envía una respuesta 304). Pero si diseñas cuidadosamente tu aplicación, es posible que puedas obtener los datos mínimos necesarios para enviar una respuesta 304 y ahorrar *CPU* también (más abajo puedes ver una implementación de ejemplo). - -.. tip:: - - El código de estado 304 significa «No Modificado». Es importante porque este código de estado *no* tiene el contenido real solicitado. - En cambio, la respuesta simplemente es un ligero conjunto de instrucciones que indican a la caché que se debe utilizar la versión almacenada. - -Al igual que con la caducidad, hay dos diferentes cabeceras *HTTP* que puedes utilizar para implementar el modelo de validación: ``Etag`` y ``Last-Modified``. - -.. index:: - single: Caché; Cabecera Etag - single: Cabeceras HTTP; Etag - -Validando con la cabecera ``ETag`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La cabecera ``ETag`` es una cabecera de cadena (llamada «entidad-etiqueta») que identifica unívocamente una representación del recurso destino. Este es generado completamente y establecido por tu aplicación de modo que puedes decir, por ejemplo, si el recurso memorizado ``/sobre`` está al día con el que tu aplicación iba a devolver. Una ``ETag`` es como una huella digital y se utiliza para comparar rápidamente si dos versiones diferentes de un recurso son equivalentes. Como las huellas digitales, cada ``ETag`` debe ser única en todas las representaciones de un mismo recurso. - -Para ver una sencilla implementación, genera la ``ETag`` como el ``md5`` del contenido:: - - public function indexAction() - { - $response = $this->render('MyBundle:Main:index.html.twig'); - $response->setETag(md5($response->getContent())); - $response->setPublic(); // verifica que la respuesta es púbica/susceptible de guardar en caché - $response->isNotModified($this->getRequest()); - - return $response; - } - -El método :method:`Symfony\\Component\\HttpFoundation\\Response::isNotModified` compara la ``ETag`` enviada en la ``Petición`` con la configurada en la ``Respuesta``. Si ambas coinciden, el método automáticamente establece el código de estado de la ``Respuesta`` a 304. - -Este algoritmo es bastante simple y muy genérico, pero es necesario crear la ``Respuesta`` completa antes de ser capaz de calcular la ``ETag``, lo cual es subóptimo. -En otras palabras, esta ahorra ancho de banda, pero no ciclos de la *CPU*. - -En la sección :ref:`optimizing-cache-validation`, te mostraré cómo puedes utilizar la validación de manera más inteligente para determinar la validez de una caché sin hacer tanto trabajo. - -.. tip:: - - *Symfony2* también apoya ``ETags`` débiles pasando ``true`` como segundo argumento del método :method:`Symfony\\Component\\HttpFoundation\\Response::setETag`. - -.. index:: - single: Caché; Cabecera Last-Modified - single: Cabeceras HTTP; Last-Modified - -Validando con la cabecera ``Last-Modified`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La cabecera ``Last-Modified`` es la segunda forma de validación. De acuerdo con la especificación *HTTP*, «El campo de la cabecera ``Last-Modified`` indica la fecha y hora en que el servidor origen considera que la representación fue modificada por última vez». En otras palabras, la aplicación decide si o no el contenido memorizado se ha actualizado en función de sí o no se ha actualizado desde que la respuesta entró en caché. - -Por ejemplo, puedes utilizar la última fecha de actualización de todos los objetos necesarios para calcular la representación del recurso como valor para el valor de la cabecera ``Last-Modified``:: - - public function showAction($articleSlug) - { - // ... - - $articleDate = new \DateTime($article->getUpdatedAt()); - $authorDate = new \DateTime($author->getUpdatedAt()); - - $date = $authorDate > $articleDate ? $authorDate : $articleDate; - - $response->setLastModified($date); - // Ajusta la respuesta como pública. De lo contrario será privada por omisión. - $response->setPublic(); - - if ($response->isNotModified($this->getRequest())) { - return $response; - } - - // ... hace más trabajo para poblar la respuesta con el contenido completo - - return $response; - } - -El método :method:`Symfony\\Component\\HttpFoundation\\Response::isNotModified` compara la cabecera ``If-Modified-Since`` enviada por la petición con la cabecera ``Last-Modified`` configurada en la respuesta. Si son equivalentes, la ``Respuesta`` establecerá un código de estado 304. - -.. note:: - - La cabecera ``If-Modified-Since`` de la petición es igual a la cabecera ``Last-Modified`` de la última respuesta enviada al cliente por ese recurso en particular. - Así es como se comunican el cliente y el servidor entre ellos y deciden si el recurso se ha actualizado desde que se memorizó. - -.. index:: - single: Caché; Get Condicional - single: HTTP; 304 - -.. _optimizing-cache-validation: - -Optimizando tu código con validación -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El objetivo principal de cualquier estrategia de memoria caché es aligerar la carga de la aplicación. -Dicho de otra manera, cuanto menos hagas en tu aplicación para devolver una respuesta 304, mejor. El método ``Response::isNotModified()`` hace exactamente eso al exponer un patrón simple y eficiente:: - - use Symfony\Component\HttpFoundation\Response; - - public function showAction($articleSlug) - { - // Obtiene la mínima información para calcular la ETag - // o el valor de Last-Modified (basado en la petición, - // los datos se recuperan de una base de datos o un par - // clave-valor guardado, por ejemplo) - $article = ...; - - // crea una respuesta con una cabecera ETag y/o Last-Modified - $response = new Response(); - $response->setETag($article->computeETag()); - $response->setLastModified($article->getPublishedAt()); - - // Ajusta la respuesta como pública. De lo contrario será privada por omisión. - $response->setPublic(); - - // verifica que la respuesta no se ha modificado para la petición dada - if ($response->isNotModified($this->getRequest())) { - // devuelve la instancia de la aplicación - return $response; - } else { - // aquí haz algo más - como recuperar más datos - $comments = ...; - - // o reproduce una plantilla con la $response que acabas de iniciar - return $this->render( - 'MyBundle:MyController:article.html.twig', - array('article' => $article, 'comments' => $comments), - $response - ); - } - } - -Cuando la ``Respuesta`` no es modificada, el ``isNotModified()`` automáticamente fija el código de estado de la respuesta a ``304``, remueve el contenido, y remueve algunas cabeceras que no deben estar presentes en respuestas ``304`` (consulta -:method:`Symfony\\Component\\HttpFoundation\\Response::setNotModified`). - -.. index:: - single: Caché; Vary - single: Cabeceras HTTP; Vary - -Variando la respuesta -~~~~~~~~~~~~~~~~~~~~~ - -Hasta ahora, asumiste que cada *URI* tiene exactamente una representación del recurso destino. De forma predeterminada, la caché *HTTP* se memoriza usando la *URI* del recurso como la clave de la caché. Si dos personas solicitan la misma *URI* de un recurso memorizable, la segunda persona recibirá la versión en caché. - -A veces esto no es suficiente y se necesita memorizar en caché diferentes versiones de la misma *URI* basándose en uno o más valores de las cabeceras de la petición. Por ejemplo, si comprimes las páginas cuando el cliente lo permite, cualquier *URI* tiene dos representaciones: -una cuando el cliente es compatible con la compresión, y otra cuando no. Esta determinación se hace por el valor de la cabecera ``Accept-Encoding`` de la petición. - -En este caso, necesitas que la memoria almacene una versión comprimida y otra sin comprimir de la respuesta para la *URI* particular y devolverlas basándose en el valor de la cabecera ``Accept-Encoding``. Esto se hace usando la cabecera ``Vary`` de la respuesta, la cual es una lista separada por comas de diferentes cabeceras cuyos valores lanzan una diferente representación de los recursos solicitados: - -.. code-block:: text - - Vary: Accept-Encoding, User-Agent - -.. tip:: - - Esta cabecera ``Vary`` particular debería memorizar diferentes versiones de cada recurso en base a la *URI* y el valor de las cabeceras ``Accept-Encoding`` y ``User-Agent`` de la petición. - -El objeto ``Respuesta`` ofrece una interfaz limpia para gestionar la cabecera ``Vary``:: - - // establece una cabecera vary - $response->setVary('Accept-Encoding'); - - // establece múltiples cabeceras vary - $response->setVary(array('Accept-Encoding', 'User-Agent')); - -El método ``setVary()`` toma un nombre de cabecera o un arreglo de nombres de cabecera de cual respuesta varía. - -Caducidad y validación -~~~~~~~~~~~~~~~~~~~~~~ - -Por supuesto, puedes utilizar tanto la caducidad como la validación de la misma ``Respuesta``. -La caducidad gana a la validación, te puedes beneficiar de lo mejor de ambos mundos. En otras palabras, utilizando tanto la caducidad como la validación, puedes instruir a la caché para que sirva el contenido memorizado, mientras que revisas de nuevo algún intervalo (de caducidad) para verificar que el contenido sigue siendo válido. - -.. index:: - pair: Caché; Configuración - -Más métodos de respuesta -~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase ``Respuesta`` proporciona muchos métodos más relacionados con la caché. Estos son los más útiles:: - - // Marca la respuesta como obsoleta - $response->expire(); - - // Fuerza a la respuesta a devolver una adecuada respuesta 304 sin contenido - $response->setNotModified(); - -Adicionalmente, puedes configurar muchas de las cabeceras *HTTP* relacionadas con la caché a través del único método :method:`Symfony\\Component\\HttpFoundation\\Response::setCache`:: - - // Establece la configuración de caché en una llamada - $response->setCache(array( - 'etag' => $etag, - 'last_modified' => $date, - 'max_age' => 10, - 's_maxage' => 10, - 'public' => true, - // 'private' => true, - )); - -.. index:: - single: Caché; ESI - single: ESI - -.. _edge-side-includes: - -Usando inclusión del borde lateral ----------------------------------- - -Las pasarelas de caché son una excelente forma de hacer que tu sitio web tenga un mejor desempeño. Pero tienen una limitación: sólo pueden memorizar páginas enteras. Si no puedes memorizar todas las páginas o si partes de una página tienen «más» elementos dinámicos, se te acabó la suerte. Afortunadamente, *Symfony2* ofrece una solución para estos casos, basada ​​en una tecnología llamada `ESI`_, o Inclusión de bordes laterales («``Edge Side Includes``»). Akamaï escribió esta especificación hace casi 10 años, y esta permite que partes específicas de una página tengan una estrategia de memorización diferente a la de la página principal. - -La especificación *ESI* describe las etiquetas que puedes incrustar en tus páginas para comunicarte con la pasarela de caché. *Symfony2* sólo implementa una etiqueta, ``include``, ya que es la única útil fuera del contexto de Akamaï: - -.. code-block:: html - - - - - - - - - - - - - -.. note:: - - Observa que en el ejemplo cada etiqueta *ESI* tiene una *URL* completamente cualificada. - Una etiqueta *ESI* representa un fragmento de página que se puede recuperar a través de la *URL*. - -Cuando se maneja una petición, la pasarela de caché obtiene toda la página de su caché o la pide a partir de la interfaz de administración de tu aplicación. Si la respuesta contiene una o más etiquetas *ESI*, estas se procesan de la misma manera. En otras palabras, la pasarela caché o bien, recupera el fragmento de página incluida en su caché o de nuevo pide el fragmento de página desde la interfaz de administración de tu aplicación. Cuando se han resuelto todas las etiquetas *ESI*, la pasarela caché une cada una en la página principal y envía el contenido final al cliente. - -Todo esto sucede de forma transparente a nivel de la pasarela caché (es decir, fuera de tu aplicación). Como verás, si decides tomar ventaja de las etiquetas *ESI*, *Symfony2* hace que el proceso de incluirlas sea casi sin esfuerzo. - -Usando *ESI* en *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Primero, para usar *ESI*, asegúrate de activarlo en la configuración de tu aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - # ... - esi: { enabled: true } - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - // ... - 'esi' => array('enabled' => true), - )); - -Ahora, supongamos que tenemos una página que es relativamente estática, salvo por un teletipo de noticias en la parte inferior del contenido. Con *ESI*, puedes memorizar el teletipo de noticias independientemente del resto de la página. - -.. code-block:: php - - public function indexAction() - { - $response = $this->render('MyBundle:MyController:index.html.twig'); - // Pone el tiempo compartido máximo - el cual además marca la respuesta como pública - $response->setSharedMaxAge(600); - - return $response; - } - -En este ejemplo, la caché de la página completa tiene un tiempo de vida de diez minutos. -En seguida, incluirás el teletipo de noticias en la plantilla incorporando una acción. -Esto se hace a través del ayudante ``render`` (Consulta :ref:`templating-embedding-controller` para más detalles). - -Como el contenido integrado viene de otra página (o controlador en este caso), *Symfony2* utiliza el ayudante ``render`` estándar para configurar las etiquetas *ESI*: - -.. configuration-block:: - - .. code-block:: jinja - - {# puedes usar una referencia al controlador #} - {{ render_esi(controller('...:news', { 'max': 5 })) }} - - {# ... o una URL #} - {{ render_esi(url('latest_news', { 'max': 5 })) }} - - .. code-block:: html+php - - render( - new ControllerReference('...:news', array('max' => 5)), - array('renderer' => 'esi')) - ?> - - render( - $view['router']->generate('latest_news', array('max' => 5), true), - array('renderer' => 'esi'), - ) ?> - -Al utilizar el ``esi`` reproducido (vía la función ``render_esi`` de *Twig*), le dices a *Symfony2* que la acción se debería reproducir como una etiqueta *ESI*. Te podrías estar preguntando por qué querrías utilizar un ayudante en vez de sólo escribir la etiqueta *ESI* directamente. Esto se debe a que al utilizar un ayudante haces que tu aplicación trabaje incluso si no tienes instalada ninguna pasarela de caché. - -Al utilizar la función ``render`` predefinida (o configurar la estrategia a ``inline``), *Symfony2* fusiona el contenido de la página incluida con la principal antes de enviar la respuesta al cliente. Pero si utilizas la estrategia ``esi`` (es decir, llamas a ``render_esi``), *y* si *Symfony2* detecta que está hablando con una pasarela de caché que cuenta con soporte *ESI*, genera una etiqueta que incluye *ESI*. Pero si no hay ninguna pasarela de caché o si no cuenta con soporte *ESI*, *Symfony2* sólo fusionará el contenido de la página incluida dentro de la principal tal como lo haría si hubieras utilizado ``render``. - -.. note:: - - *Symfony2* detecta si una pasarela caché admite *ESI* a través de otra especificación Akamaï que fuera de la caja es compatible con el delegado inverso de *Symfony2*. - -La acción integrada ahora puede especificar sus propias reglas de caché, totalmente independientes de la página principal. - -.. code-block:: php - - public function newsAction($max) - { - // ... - - $response->setSharedMaxAge(60); - } - -Con *ESI*, la caché de la página completa será válida durante 600 segundos, pero la caché del componente de noticias sólo dura 60 segundos. - -Cuándo utilizas una referencia al controlador, la etiqueta *ESI* se debe referir a la acción incorporada como una *URL* accesible a modo de que la pasarela de caché la pueda recuperar independientemente del resto de la página. *Symfony2* cuida de generar una *URL* única para cualquier referencia de controlador y es capaz de enrutarla correctamente gracias a un escucha que debes habilitar en tu configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - # ... - fragments: { path: /_fragment } - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - // ... - 'fragments' => array('path' => '/_fragment'), - )); - -Una gran ventaja de estrategia *ESI* es que puedes hacer tu aplicación tan dinámica como sea necesario y al mismo tiempo, tocar la aplicación lo menos posible. - -.. tip:: - - El escucha sólo responde a direcciones *IP* locales o a delegados inversos confiables. - -.. note:: - - Una vez que comiences a usar *ESI*, recuerda usar siempre la directiva ``s-maxage`` en lugar de ``max-age``. Como el navegador nunca recibe recursos agregados, no es consciente del subcomponente, y por lo tanto obedecerá la directiva ``max-age`` y memorizará la página completa. Y no quieres eso. - -El ayudante ``render_esi`` apoya otras dos útiles opciones: - -* ``alt``: utilizada como el atributo ``alt`` en la etiqueta *ESI*, el cual te permite especificar una *URL* alternativa para utilizarla si no se puede encontrar ``src``; - -* ``ignore_errors``: si la fijas a ``true``, se agrega un atributo ``onerror`` a la *ESI* con un valor de ``continue`` indicando que, en caso de una falla, la pasarela caché simplemente debe eliminar la etiqueta *ESI* silenciosamente. - -.. index:: - single: Caché; Invalidando - -.. _http-cache-invalidation: - -Invalidando la caché --------------------- - - «Sólo hay dos cosas difíciles en Ciencias de la Computación: Invalidación de caché y nombrar cosas» --Phil Karlton - -Nunca debería ser necesario invalidar los datos memorizados en caché porque la invalidación ya se tiene en cuenta de forma nativa en los modelos de caché *HTTP*. Si utilizas la validación, por definición, no será necesario invalidar ninguna cosa; y si utilizas la caducidad y necesitas invalidar un recurso, significa que estableciste la fecha de caducidad muy adelante en el futuro. - -.. note:: - - Debido a que la invalidación es un tema específico de cada tipo de delegado inverso, si no te preocupa la invalidación, puedes cambiar entre los delegados inversos sin cambiar nada en el código de tu aplicación. - -En realidad, todos los delegados inversas proporcionan una manera de purgar datos almacenados en caché, pero lo debes evitar tanto como sea posible. La forma más habitual es purgar la caché de una *URL* dada solicitándola con el método especial ``PURGE`` de *HTTP*. - -Aquí está cómo puedes configurar la caché del delegado inverso de *Symfony2* para apoyar el método ``PURGE`` de *HTTP*:: - - // app/AppCache.php - - // ... - use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache; - use Symfony\Component\HttpFoundation\Request; - use Symfony\Component\HttpFoundation\Response; - - class AppCache extends HttpCache - { - protected function invalidate(Request $request, $catch = false) - { - if ('PURGE' !== $request->getMethod()) { - return parent::invalidate($request, $catch); - } - - $response = new Response(); - if (!$this->getStore()->purge($request->getUri())) { - $response->setStatusCode(404, 'Not purged'); - } else { - $response->setStatusCode(200, 'Purged'); - } - - return $response; - } - } - -.. caution:: - - De alguna manera, debes proteger el método ``PURGE`` de *HTTP* para evitar que alguien aleatoriamente purgue los datos memorizados. - -Resumen -------- - -*Symfony2* fue diseñado para seguir las reglas probadas de la carretera: *HTTP*. El almacenamiento en caché no es una excepción. Dominar el sistema caché de *Symfony2* significa familiarizarse con los modelos de caché *HTTP* y usarlos eficientemente. Esto significa que, en lugar de confiar sólo en la documentación de *Symfony2* y ejemplos de código, tienes acceso a un mundo de conocimientos relacionados con la memorización en caché *HTTP* y la pasarela caché, tal como *Varnish*. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/cache/varnish` - -.. _`Things Caches Do`: http://tomayko.com/writings/things-caches-do -.. _`Guía de caché`: http://www.mnot.net/cache_docs/ -.. _`Varnish`: https://www.varnish-cache.org/ -.. _`Squid en modo delegado inverso`: http://wiki.squid-cache.org/SquidFaq/ReverseProxy -.. _`modelo de caducidad`: http://tools.ietf.org/html/rfc2616#section-13.2 -.. _`modelo de validación`: http://tools.ietf.org/html/rfc2616#section-13.3 -.. _`RFC 2616`: http://tools.ietf.org/html/rfc2616 -.. _`HTTP Bis`: http://tools.ietf.org/wg/httpbis/ -.. _`P4 - Petición condicional`: http://tools.ietf.org/html/draft-ietf-httpbis-p4-conditional-12 -.. _`P6 - Caché: Navegador y caché intermedia`: http://tools.ietf.org/html/draft-ietf-httpbis-p6-cache-12 -.. _`ESI`: http://www.w3.org/TR/esi-lang diff --git a/_sources/book/http_fundamentals.txt b/_sources/book/http_fundamentals.txt deleted file mode 100644 index cf3b783..0000000 --- a/_sources/book/http_fundamentals.txt +++ /dev/null @@ -1,401 +0,0 @@ -.. index:: - single: Fundamentos de Symfony2 - -*Symfony2* y fundamentos *HTTP* -=============================== - -¡Enhorabuena! Al aprender acerca de *Symfony2*, vas bien en tu camino para llegar a ser un más *productivo*, bien *enfocado* y *popular* desarrollador web (en realidad, en la última parte, estás por tu cuenta). *Symfony2* está diseñado para volver a lo básico: las herramientas de desarrollo que te permiten desarrollar más rápido y construir aplicaciones más robustas, mientras que permanece fuera de tu camino. *Symfony* está basado en las mejores ideas de muchas tecnologías: las herramientas y conceptos que estás a punto de aprender representan el esfuerzo de miles de personas, durante muchos años. En otras palabras, no estás aprendiendo «*Symfony*», estás aprendiendo los fundamentos de la *web*, buenas prácticas de desarrollo, y cómo utilizar muchas nuevas y asombrosas bibliotecas *PHP*, dentro o independientemente de *Symfony2*. Por lo tanto, ¡prepárate! - -Fiel a la filosofía *Symfony2*, este capítulo comienza explicando el concepto fundamental común para el desarrollo *web*: *HTTP*. Independientemente de tus antecedentes o lenguaje de programación preferido, este capítulo es una **lectura obligada** para todo mundo. - -*HTTP* es Simple ----------------- - -*HTTP* («*HyperText Transfer Protocol*» para los apasionados y, en Español *Protocolo de transferencia hipertexto*) es un lenguaje de texto que permite a dos máquinas comunicarse entre sí. ¡Eso es todo! Por ejemplo, al comprobar las últimas noticias acerca de cómica `xkcd`_, la siguiente conversación (aproximadamente) se lleva a cabo: - -.. image:: /images/http-xkcd_es.png - :align: center - -Y aunque el lenguaje real utilizado es un poco más formal, sigue siendo bastante simple. -*HTTP* es el término utilizado para describir este lenguaje simple basado en texto. Y no importa cómo desarrolles en la web, el objetivo de tu servidor *siempre* es entender las peticiones de texto simple, y devolver respuestas en texto simple. - -*Symfony2* está construido basado en torno a esa realidad. Ya sea que te des cuenta o no, *HTTP* es algo que usas todos los días. Con *Symfony2*, aprenderás a dominarlo. - -.. index:: - single: HTTP; El paradigma petición/respuesta - -Paso 1: El cliente envía una petición -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Todas las conversaciones en la web comienzan con una *petición*. La petición es un mensaje de texto creado por un cliente (por ejemplo un navegador, una aplicación para el *iPhone*, etc.) en un formato especial conocido como *HTTP*. El cliente envía la petición a un servidor, y luego espera la respuesta. - -Echa un vistazo a la primera parte de la interacción (la petición) entre un navegador y el servidor web `xkcd`: - -.. image:: /images/http-xkcd-request_es.png - :align: center - -Hablando en *HTTP*, esta petición *HTTP* en realidad se vería algo parecida a esto: - -.. code-block:: text - - GET / HTTP/1.1 - Host: xkcd.com - Accept: text/html - User-Agent: Mozilla/5.0 (Macintosh) - -Este sencillo mensaje comunica *todo* lo necesario sobre qué recursos exactamente solicita el cliente. La primera línea de una petición *HTTP* es la más importante y contiene dos cosas: la *URI* y el método *HTTP*. - -La *URI* (por ejemplo, ``/``, ``/contact``, etc.) es la dirección o ubicación que identifica unívocamente al recurso que el cliente quiere. El método *HTTP* (por ejemplo, *GET*) define lo que quieres *hacer* con el recurso. Los métodos *HTTP* son los *verbos* de la petición y definen las pocas formas más comunes en que puedes actuar sobre el recurso: - -+----------+---------------------------------------+ -| *GET* | Recupera el recurso desde el servidor | -+----------+---------------------------------------+ -| *POST* | Crea un recurso en el servidor | -+----------+---------------------------------------+ -| *PUT* | Actualiza el recurso en el servidor | -+----------+---------------------------------------+ -| *DELETE* | Elimina el recurso del servidor | -+----------+---------------------------------------+ - -Con esto en mente, te puedes imaginar que una petición *HTTP* podría ser similar a eliminar una entrada de *blog* específica, por ejemplo: - -.. code-block:: text - - DELETE /blog/15 HTTP/1.1 - -.. note:: - - En realidad, hay nueve métodos *HTTP* definidos por la especificación *HTTP*, pero muchos de ellos no se utilizan o apoyan ampliamente. En realidad, muchos navegadores modernos no apoyan los métodos *PUT* y *DELETE*. - -Además de la primera línea, una petición *HTTP* invariablemente contiene otras líneas de información conocidas como cabeceras de petición. Las cabeceras pueden suministrar una amplia gama de información como el servidor (o ``host``) solicitado, los formatos de respuesta que acepta el cliente (``Accept``) y la aplicación que utiliza el cliente para realizar la petición (``User-Agent``). Existen muchas otras cabeceras y se pueden encontrar en el artículo `Lista de campos de las cabeceras HTTP`_ en la Wikipedia. - -Paso 2: El servidor devuelve una respuesta -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Una vez que un servidor ha recibido la petición, sabe exactamente qué recursos necesita el cliente (a través de la *URI*) y lo que el cliente quiere hacer con ese recurso (a través del método). Por ejemplo, en el caso de una petición *GET*, el servidor prepara el recurso y lo devuelve en una respuesta *HTTP*. Considera la respuesta del servidor web, xkcd: - -.. image:: /images/http-xkcd_es.png - :align: center - -Traducida a *HTTP*, la respuesta enviada de vuelta al navegador se verá algo similar a esto: - -.. code-block:: text - - HTTP/1.1 200 OK - Date: Sat, 02 Apr 2011 21:05:05 GMT - Server: lighttpd/1.4.19 - Content-Type: text/html - - - - - -La respuesta *HTTP* contiene el recurso solicitado (contenido *HTML* en este caso), así como otra información acerca de la respuesta. La primera línea es especialmente importante y contiene el código de estado *HTTP* (200 en este caso) de la respuesta. El código de estado comunica el resultado global de la petición devuelta al cliente. ¿Tuvo éxito la petición? ¿Hubo algún error? Existen diferentes códigos de estado que indican éxito, un error o qué más se necesita hacer con el cliente (por ejemplo, redirigirlo a otra página). La lista completa se puede encontrar en el artículo `Lista de códigos de estado HTTP`_ en la Wikipedia. - -Al igual que la petición, una respuesta *HTTP* contiene datos adicionales conocidos como cabeceras *HTTP*. Por ejemplo, una importante cabecera de la respuesta *HTTP* es ``Content-Type``. El cuerpo del mismo recurso se puede devolver en varios formatos diferentes, incluyendo *HTML*, *XML* o *JSON* y la cabecera ``Content-Type`` utiliza Internet Media Types como ``text/html`` para decirle al cliente cual formato se ha devuelto. Puedes encontrar una lista completa en el artículo `Lista de tipos de medios comunes`_ en la Wikipedia. - -Existen muchas otras cabeceras, algunas de las cuales son muy poderosas. Por ejemplo, puedes usar ciertas cabeceras para crear un poderoso sistema de memoria caché. - -Peticiones, respuestas y desarrollo Web -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Esta conversación petición-respuesta es el proceso fundamental que impulsa toda la comunicación en la web. Y tan importante y poderoso como es este proceso, inevitablemente es simple. - -El hecho más importante es el siguiente: independientemente del lenguaje que utilices, el tipo de aplicación que construyas (*web*, móvil, *API* *JSON*), o la filosofía de desarrollo que sigas, el objetivo final de una aplicación **siempre** es entender cada petición y crear y devolver la respuesta adecuada. - -*Symfony* está diseñado para adaptarse a esta realidad. - -.. tip:: - - Para más información acerca de la especificación *HTTP*, lee la referencia original `HTTP 1.1 RFC`_ o `HTTP Bis`_, el cual es un esfuerzo activo para aclarar la especificación original. Una gran herramienta para comprobar tanto la petición como las cabeceras de la respuesta mientras navegas es la extensión `Cabeceras HTTP en vivo`_ (*Live HTTP Headers*) para Firefox. - -.. index:: - single: Fundamentos de Symfony2; Peticiones y respuestas - -Peticiones y respuestas en *PHP* --------------------------------- - -Entonces ¿cómo interactúas con la «petición» y creas una «respuesta» utilizando *PHP*? En realidad, *PHP* te abstrae un poco de todo el proceso:: - - $uri = $_SERVER['REQUEST_URI']; - $foo = $_GET['foo']; - - header('Content-type: text/html'); - echo 'La URI solicitada es: '.$uri; - echo 'El valor del parámetro "foo" es: '.$foo; - -Por extraño que parezca, esta pequeña aplicación, de hecho, está tomando información de la petición *HTTP* y la utiliza para crear una respuesta *HTTP*. En lugar de analizar el mensaje *HTTP* de la petición, *PHP* prepara variables superglobales tales como ``$_SERVER`` y ``$_GET`` que contienen toda la información de la petición. Del mismo modo, en lugar de devolver la respuesta *HTTP* con formato de texto, puedes usar la función ``header()`` para crear las cabeceras de la respuesta y simplemente imprimir el contenido real que será la porción que contiene el mensaje de la respuesta. *PHP* creará una verdadera respuesta *HTTP* y la devolverá al cliente: - -.. code-block:: text - - HTTP/1.1 200 OK - Date: Sat, 03 Apr 2011 02:14:33 GMT - Server: Apache/2.2.17 (Unix) - Content-Type: text/html - - La URI solicitada es: /testing?foo=symfony - El valor del parámetro "foo" es: symfony - -Peticiones y respuestas en *Symfony* ------------------------------------- - -*Symfony* ofrece una alternativa al enfoque de *PHP* a través de dos clases que te permiten interactuar con la petición *HTTP* y la respuesta de una manera más fácil. -La clase :class:`Symfony\\Component\\HttpFoundation\\Request` es una sencilla representación orientada a objetos del mensaje de la petición *HTTP*. Con ella, tienes toda la información a tu alcance:: - - use Symfony\Component\HttpFoundation\Request; - - $request = Request::createFromGlobals(); - - // la URI solicitada (p. ej. /sobre) menos algunos parámetros de la consulta - $request->getPathInfo(); - - // recupera las variables GET y POST respectivamente - $request->query->get('foo'); - $request->request->get('bar', 'default value if bar does not exist'); - - // recupera las variables de SERVER - $request->server->get('HTTP_HOST'); - - // recupera una instancia del archivo subido identificado por foo - $request->files->get('foo'); - - // recupera un valor de COOKIE - $request->cookies->get('PHPSESSID'); - - // recupera una cabecera HTTP de la petición, normalizada, con índices en minúscula - $request->headers->get('host'); - $request->headers->get('content_type'); - - $request->getMethod(); // GET, POST, PUT, DELETE, HEAD - $request->getLanguages(); // un arreglo de idiomas aceptados por el cliente - -Como bono adicional, en el fondo la clase ``Petición`` hace un montón de trabajo del cual nunca tendrás que preocuparte. Por ejemplo, el método ``isSecure()`` comprueba *tres* diferentes valores en *PHP* que pueden indicar si el usuario está conectado a través de una conexión segura (es decir, ``https``). - -.. sidebar:: ``ParameterBags`` y atributos de la petición - - Como vimos anteriormente, las variables ``$_GET`` y ``$_POST`` son accesibles a través de las propiedades ``query`` y ``request``, respectivamente. Cada uno de estos objetos es un objeto de la :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`, la cual cuenta con métodos cómo: - :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::get`, - :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::has`, - :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::all` entre otros. - De hecho, todas las propiedades públicas utilizadas en el ejemplo anterior son un ejemplo del ``ParameterBag``. - - .. _book-fundamentals-attributes: - - La clase ``Petición`` también tiene una propiedad pública ``attributes``, que tiene datos especiales relacionados en cómo funciona internamente la aplicación. Para la plataforma *Symfony2*, ``attibutes`` mantiene los valores devueltos por la ruta buscada, tal como ``_controller``, ``id`` (por lo tanto si tienes un comodín ``{id}``), e incluso el nombre de la ruta buscada (``_route``). La propiedad ``attributes`` existe enteramente para ser un lugar donde se pueda preparar y almacenar información del contexto específico de la petición. - - -*Symfony* también proporciona una clase ``Respuesta``: una simple representación *PHP* de un mensaje de respuesta *HTTP*. Esto permite que tu aplicación utilice una interfaz orientada a objetos para construir la respuesta que será devuelta al cliente:: - - use Symfony\Component\HttpFoundation\Response; - $response = new Response(); - - $response->setContent('

Hello world!

'); - $response->setStatusCode(200); - $response->headers->set('Content-Type', 'text/html'); - - // imprime las cabeceras HTTP seguidas por el contenido - $response->send(); - -Si *Symfony* no ofreciera nada más, ya tendrías un conjunto de herramientas para acceder fácilmente a la información de la petición y una interfaz orientada a objetos para crear la respuesta. Incluso, a medida que aprendas muchas de las poderosas características de *Symfony*, nunca olvides que el objetivo de tu aplicación es *interpretar una petición y crear la respuesta adecuada basada en la lógica de tu aplicación*. - -.. tip:: - - Las clases ``Respuesta`` y ``Petición`` forman parte de un componente independiente incluido en *Symfony* llamado ``HttpFoundation``. Este componente se puede utilizar completamente independiente de *Symfony* y también proporciona clases para manejar sesiones y subir archivos. - -El viaje desde la petición hasta la respuesta ---------------------------------------------- - -Al igual que el mismo *HTTP*, los objetos ``Petición`` y ``Respuesta`` son bastante simples. -La parte difícil de la construcción de una aplicación es escribir lo que viene en el medio. -En otras palabras, el verdadero trabajo viene al escribir el código que interpreta la información de la petición y crea la respuesta. - -Tu aplicación probablemente hace muchas cosas, como enviar correo electrónico, manejar los formularios presentados, guardar cosas en una base de datos, reproducir las páginas *HTML* y proteger el contenido con seguridad. ¿Cómo puedes manejar todo esto y todavía mantener tu código organizado y fácil de mantener? - -*Symfony* fue creado para resolver estos problemas para que no tengas que hacerlo personalmente. - -El controlador frontal -~~~~~~~~~~~~~~~~~~~~~~ - -Tradicionalmente, las aplicaciones eran construidas de modo que cada «página» de un sitio tenía su propio archivo físico: - -.. code-block:: text - - index.php - contacto.php - blog.php - -Hay varios problemas con este enfoque, incluyendo la falta de flexibilidad de las *URL* (¿qué pasa si quieres cambiar :file:`blog.php` a :file:`noticias.php` sin romper todos tus enlaces?) y el hecho de que cada archivo *debe* incluir manualmente un conjunto de archivos básicos para la seguridad, conexiones a base de datos y que el «aspecto» del sitio pueda permanecer constante. - -Una mucho mejor solución es usar un :term:`controlador frontal`: un solo archivo *PHP* que se encargue de todas las peticiones que llegan a tu aplicación. Por ejemplo: - -+-----------------------------+----------------------------+ -| :file:`/index.php` | ejecuta :file:`index.php` | -+-----------------------------+----------------------------+ -| :file:`/index.php/contact` | ejecuta :file:`index.php` | -+-----------------------------+----------------------------+ -| :file:`/index.php/blog` | ejecuta :file:`index.php` | -+-----------------------------+----------------------------+ - -.. tip:: - - Usando ``mod_rewrite`` de *Apache* (o equivalente con otros servidores web), las *URL* se pueden limpiar fácilmente hasta ser sólo ``/``, ``/contact`` y ``/blog``. - -Ahora, cada petición se maneja de la misma manera exactamente. En lugar de *URL* individuales ejecutando diferentes archivos *PHP*, el controlador frontal *siempre* se ejecuta, y el enrutado de diferentes *URL* a diferentes partes de tu aplicación se realiza internamente. Esto resuelve los problemas del enfoque original. -Casi todas las aplicaciones *web* modernas lo hacen ---incluyendo aplicaciones como *WordPress*. - -Mantente organizado -~~~~~~~~~~~~~~~~~~~ - -Dentro de tu controlador frontal, tienes que averiguar qué código se debe ejecutar y cual contenido se debe regresar. Para resolver esto, necesitas comprobar la *URI* entrante y ejecutar diferentes partes de tu código dependiendo de ese valor. Esto se puede poner feo rápidamente:: - - // index.php - use Symfony\Component\HttpFoundation\Request; - use Symfony\Component\HttpFoundation\Response; - $request = Request::createFromGlobals(); - $path = $request->getPathInfo(); // La ruta URI solicitada - - if (in_array($path, array('', '/'))) { - $response = new Response('Welcome to the homepage.'); - } elseif ($path == '/contact') { - $response = new Response('Contact us'); - } else { - $response = new Response('Page not found.', 404); - } - $response->send(); - -La solución a este problema puede ser difícil. Afortunadamente esto es *exactamente* para lo que *Symfony* está diseñado. - -El flujo de las aplicaciones *Symfony* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando dejas que *Symfony* controle cada petición, la vida es mucho más fácil. *Symfony* sigue el mismo patrón simple en cada petición: - -.. _request-flow-figure: - -.. figure:: /images/request-flow_es.png - :align: center - :alt: Flujo de la petición en Symfony2 - - Las peticiones entrantes son interpretadas por el enrutador y pasadas a las funciones controladoras que regresan objetos ``Respuesta``. - -Cada «página» de tu sitio está definida en un archivo de configuración de enrutado que asigna las diferentes *URL* a diferentes funciones *PHP*. El trabajo de cada función *PHP* conocida como :term:`controlador`, es utilizar la información de la petición ---junto con muchas otras herramientas que *Symfony* pone a tu disposición--- para crear y devolver un objeto ``Respuesta``. En otras palabras, el controlador es donde *está tu* código: ahí es dónde se interpreta la petición y crea una respuesta. - -¡Así de fácil! Repasemos: - -* Cada petición ejecuta un archivo controlador frontal; - -* El sistema de enrutado determina cual función *PHP* se debe ejecutar en base a la información de la petición y la configuración de enrutado que creaste; - -* La función *PHP* correcta se ejecuta, donde tu código crea y devuelve el objeto ``Respuesta`` adecuado. - -Una petición *Symfony* en acción -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Sin bucear demasiado en los detalles, veamos este proceso en acción. Supongamos que deseas agregar una página ``/contact`` a tu aplicación *Symfony*. En primer lugar, empezamos agregando una entrada ``/contact`` a tu archivo de configuración de enrutado: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - contact: - path: /contact - defaults: { _controller: AcmeDemoBundle:Main:contact } - - .. code-block:: xml - - - AcmeBlogBundle:Main:contact - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('contact', new Route('/contact', array( - '_controller' => 'AcmeBlogBundle:Main:contact', - ))); - - return $collection; - -.. note:: - - Este ejemplo utiliza :doc:`YAML ` para definir la configuración de enrutado. La configuración de enrutado también se puede escribir en otros formatos, tal como *XML* o *PHP*. - -Cuando alguien visita la página ``/contact``, esta ruta coincide, y se ejecuta el controlador especificado. Como veremos en el capítulo :doc:`Enrutando `, la cadena ``AcmeDemoBundle:Main:contact`` es una sintaxis corta que apunta hacia el método *PHP* ``contactAction`` dentro de una clase llamada ``MainController``:: - - // src/Acme/DemoBundle/Controller/MainController.php - use Symfony\Component\HttpFoundation\Response; - - class MainController - { - public function contactAction() - { - return new Response('

Contact us!

'); - } - } - -En este muy simple ejemplo, el controlador sencillamente crea un objeto :class:`Symfony\\Component\\HttpFoundation\\Response` con el código *HTML* ``«

Contact us!

»``. En el capítulo :doc:`Controlador `, aprenderás cómo un controlador puede reproducir plantillas, permitiendo que tu código de «presentación» (es decir, algo que en realidad escribe *HTML*) viva en un archivo de plantilla separado. Esto libera al controlador de preocuparse sólo de las cosas difíciles: la interacción con la base de datos, la manipulación de los datos presentados o el envío de mensajes de correo electrónico. - -*Symfony2*: Construye tu aplicación, no tus herramientas. ---------------------------------------------------------- - -Ahora sabemos que el objetivo de cualquier aplicación es interpretar cada petición entrante y crear una respuesta adecuada. Cuando una aplicación crece, es más difícil mantener organizado tu código y que a la vez sea fácil darle mantenimiento. Invariablemente, las mismas tareas complejas siguen viniendo una y otra vez: la persistencia de cosas a la base de datos, procesamiento y reutilización de plantillas, manejo de formularios presentados, envío de mensajes de correo electrónico, validación de entradas del usuario y administración de la seguridad. - -La buena nueva es que ninguno de estos problemas es único. *Symfony* proporciona una plataforma completa, con herramientas que te permiten construir tu aplicación, no tus herramientas. Con *Symfony2*, nada se te impone: eres libre de usar la plataforma *Symfony* completa, o simplemente una pieza de *Symfony* por sí misma. - -.. index:: - single: Componentes de Symfony2 - -Herramientas independientes: *Componentes* de *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Entonces, ¿qué *es Symfony2*? En primer lugar, *Symfony2* es una colección de más de veinte bibliotecas independientes que se pueden utilizar dentro de *cualquier* proyecto *PHP*. Estas bibliotecas, llamadas *componentes de Symfony2*, contienen algo útil para casi cualquier situación, independientemente de cómo desarrolles tu proyecto. Para nombrar algunas: - -* :doc:`HttpFoundation` --- Contiene las clases ``Petición`` y ``Respuesta``, así como otras clases para manejar sesiones y cargar archivos; - -* :doc:`Enrutando ` --- Potente y rápido sistema de enrutamiento que te permite asociar una *URI* específica (por ejemplo ``/contacto``) a cierta información acerca de cómo se debe manejar esa petición (por ejemplo, ejecutando el método ``contactoAction()``); - -* `Form`_ --- Una completa y flexible plataforma para crear formularios y procesar los datos presentados en ellos; - -* `Validator`_ Un sistema para crear reglas sobre datos y entonces, cuando el usuario presenta los datos comprobar si son válidos o no siguiendo esas reglas; - -* :doc:`ClassLoader` Una biblioteca de carga automática que permite utilizar clases *PHP* sin necesidad de ``require`` los archivos que contienen esas clases manualmente; - -* :doc:`Plantillas ` Un juego de herramientas para reproducir plantillas, manejar la herencia de plantillas (es decir, una plantilla es decorada con un diseño) y realizar otras tareas comunes de las plantillas; - -* `Security`_ --- Una poderosa biblioteca para manejar todo tipo de seguridad dentro de una aplicación; - -* `Translation`_ Una plataforma para traducir cadenas en tu aplicación. - -Todos y cada uno de estos componentes se desacoplan y se pueden utilizar en *cualquier* proyecto *PHP*, independientemente de si utilizas la plataforma *Symfony2*. -Cada parte está hecha para utilizarla si es conveniente y sustituirse cuando sea necesario. - -La solución completa: La *plataforma Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Entonces, ¿qué *es* la *plataforma* *Symfony2*? La *plataforma* *Symfony2* es una biblioteca *PHP* que realiza dos distintas tareas: - -#. Proporciona una selección de componentes (es decir, los componentes de *Symfony2*) y bibliotecas de terceros (por ejemplo, `SwiftMailer`_ para enviar mensajes de correo electrónico); - -#. Proporciona configuración sensible y el «pegamento» que une la biblioteca con todas estas piezas. - -El objetivo de la plataforma es integrar muchas herramientas independientes con el fin de proporcionar una experiencia coherente al desarrollador. Incluso la propia plataforma es un paquete *Symfony2* (es decir, un complemento) que puedes configurar o sustituir completamente. - -*Symfony2* proporciona un potente conjunto de herramientas para desarrollar aplicaciones web rápidamente sin imponerse en tu aplicación. Los usuarios normales rápidamente pueden comenzar el desarrollo usando una distribución *Symfony2*, que proporciona un esqueleto del proyecto con parámetros predeterminados. Para los usuarios más avanzados, el cielo es el límite. - -.. _`xkcd`: http://xkcd.com/ -.. _`HTTP 1.1 RFC`: http://www.w3.org/Protocols/rfc2616/rfc2616.html -.. _`HTTP Bis`: http://datatracker.ietf.org/wg/httpbis/ -.. _`Cabeceras HTTP en vivo`: https://addons.mozilla.org/en-US/firefox/addon/live-http-headers/ -.. _`Lista de códigos de estado HTTP`: http://en.wikipedia.org/wiki/List_of_HTTP_status_codes -.. _`Lista de campos de las cabeceras HTTP`: http://en.wikipedia.org/wiki/List_of_HTTP_header_fields -.. _`Lista de tipos de medios comunes`: http://en.wikipedia.org/wiki/Internet_media_type#List_of_common_media_types -.. _`Form`: https://github.com/symfony/Form -.. _`Validator`: https://github.com/symfony/Validator -.. _`Security`: https://github.com/symfony/Security -.. _`Translation`: https://github.com/symfony/Translation -.. _`Swiftmailer`: http://swiftmailer.org/ diff --git a/_sources/book/index.txt b/_sources/book/index.txt deleted file mode 100644 index 0e7abfe..0000000 --- a/_sources/book/index.txt +++ /dev/null @@ -1,27 +0,0 @@ -Libro -===== - -.. toctree:: - :hidden: - - http_fundamentals - from_flat_php_to_symfony2 - installation - page_creation - controller - routing - templating - doctrine - propel - testing - validation - forms - security - http_cache - translation - service_container - performance - internals - stable_api - -.. include:: /book/map.rst.inc diff --git a/_sources/book/installation.txt b/_sources/book/installation.txt deleted file mode 100644 index a29c6d9..0000000 --- a/_sources/book/installation.txt +++ /dev/null @@ -1,266 +0,0 @@ -.. index:: - single: Instalando - -Instalando y configurando *Symfony* -=================================== - -El objetivo de este capítulo es empezar a trabajar con una aplicación funcionando incorporada en lo alto de *Symfony*. Afortunadamente, *Symfony* dispone de «distribuciones», que son proyectos *Symfony* funcionales desde el «arranque», los cuales puedes descargar y comenzar a desarrollar inmediatamente. - -.. tip:: - - Si estás buscando instrucciones sobre la mejor manera de crear un nuevo proyecto y guardarlo vía el control de código fuente, consulta `Usando control de código fuente`_. - -Instalando una distribución de *Symfony2* ------------------------------------------ - -.. tip:: - - En primer lugar, comprueba que tienes instalado y configurado un servidor web (como *Apache*) con *PHP 5.3.8* o superior. Para más información sobre los requisitos de *Symfony2*, consulta los :doc:`requisitos en la referencia `. - -Los paquetes de las «distribuciones» de *Symfony2*, son aplicaciones totalmente funcionales que incluyen las bibliotecas del núcleo de *Symfony2*, una selección de útiles paquetes, una sensible estructura de directorios y alguna configuración predeterminada. Al descargar una distribución *Symfony2*, estás descargando la estructura de una aplicación operativa que puedes utilizar inmediatamente para comenzar a desarrollar tu aplicación. - -Empieza por visitar la página de descarga de *Symfony2* en `http://symfony.com/download`_. -En esta página, puedes encontrar la *edición estándar de Symfony*, que es la distribución principal de *Symfony2*. Hay 2 maneras en las que puedes iniciar tu proyecto: - -Opción 1) ``Composer`` -~~~~~~~~~~~~~~~~~~~~~~ - -`Composer`_ es una biblioteca de administración de dependencias para *PHP*, la cual puedes utilizar para descargar la *Edición estándar de Symfony2*. - -Comienza `descargando Composer`_ en algún lugar de tu ordenador local. Si tienes instalado :command:`curl`, es tan fácil como: - -.. code-block:: bash - - % curl -s https://getcomposer.org/installer | php - -.. note:: - - Si tu ordenador no está listo para utilizar ``Composer``, verás algunas recomendaciones cuándo ejecutes esta orden. Sigue las recomendaciones hasta lograr que ``Composer`` trabaje correctamente. - -``Composer`` es un archivo *PHAR* ejecutable, el cual puedes utilizar para descargar la distribución estándar: - -.. code-block:: bash - - php composer.phar create-project symfony/framework-standard-edition /ruta/al/directorio/web-raiz/Symfony 2.2.0 - -.. tip:: - - Para una versión exacta, reemplaza `2.2.0` con la más reciente versión de *Symfony* (p. ej. 2.2.1). Para detalles, ve la `Página de instalación de Symfony`_ - -.. tip:: - - Para descargar más rápido los archivos de proveedores, añade la opción ``--prefer-dist`` al final de cualquier orden de *Composer*. - -Esta orden puede tardar varios minutos en su ejecución puesto que composer descarga la Distribución estándar junto con todas las bibliotecas de proveedores que necesita. Cuando termine, tendrás un directorio parecido a este: - -.. code-block:: text - - ruta/al/directorio/web-raiz/ <- tu directorio raíz del servidor web - Symfony/ <- el archivo extraído - app/ - cache/ - config/ - logs/ - src/ - ... - vendor/ - ... - web/ - app.php - ... - -Opción 2) Descarga un archivo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -También puedes descargar un archivo de la Edición estándar. En este caso, necesitas hacer dos elecciones: - -* Descargar o bien un archivo ``.tgz`` o ``.zip`` --- ambos son equivalentes, descarga aquel con el que te sientas más cómodo---; - -* Descargar la distribución con o sin ``vendors``. Si estás planeando utilizar más bibliotecas o paquetes de terceros y gestionarlas vía ``Composer``, probablemente tienes que descarga la versión «sin ``vendors``». - -Descarga uno de los archivos en algún lugar bajo el directorio raíz de tu servidor web local y descomprímelo. Desde una línea de ordenes de *UNIX*, esto se puede hacer con una de las siguientes ordenes (sustituye ``###`` con el nombre del archivo real): - -.. code-block:: bash - - # para un archivo .tgz - $ tar zxvf Symfony_Standard_Vendors_2.2.###.tgz - - # para un archivo .zip - $ unzip Symfony_Standard_Vendors_2.2.###.zip - -Si descargaste el archivo «sin ``vendors``», definitivamente necesitarás leer la siguiente sección. - -.. note:: - - Fácilmente puedes sustituir la estructura de directorios predefinida. Consulta :doc:`/cookbook/configuration/override_dir_structure` para más información. - -.. _installation-updating-vendors: - -Actualizando ``vendors`` -~~~~~~~~~~~~~~~~~~~~~~~~ - -Al llegar a este punto, has descargado un proyecto *Symfony* completamente operativo en el cual puedes comenzar a desarrollar tu propia aplicación. Un proyecto *Symfony* depende de una serie de bibliotecas externas. Estas se han descargado al directorio ``vendor/`` de tu proyecto vía una biblioteca llamada `Composer`_. - -Dependiendo de cómo descargaste *Symfony*, ahora posiblemente o no necesites actualizar tus proveedores. Pero, actualizar tus proveedores siempre es seguro, y garantiza que tienes todas las bibliotecas de proveedores necesarias. - -Paso 1: Consigue `Composer`_ (El nuevo gran sistema de empacado *PHP*) - -.. code-block:: bash - - curl -s http://getcomposer.org/installer | php - -Asegúrate de descargar :file:`composer.phar` en el mismo directorio dónde se encuentra el archivo :file:`composer.json` (este, por omisión, es el directorio raíz de tu proyecto *Symfony*). - -Paso 2: Instala las bibliotecas de terceros - -.. code-block:: bash - - $ php composer.phar install - -Esta orden descarga todas las bibliotecas de terceros necesarias ---incluyendo al mismo *Symfony*--- en el directorio :file:`vendor/`. - -.. note:: - - Si no tienes instalado ``curl``, simplemente puedes descargar manualmente el archivo ``instalador`` de http://getcomposer.org/installer. Coloca ese archivo en tu proyecto y luego ejecuta: - - .. code-block:: bash - - php installer - php composer.phar install - -.. tip:: - - Cuando ejecutes ``php composer.phar install`` o ``php composer.phar update``, composer ejecutará las ordenes postinstalación/postactualización para limpiar la caché e instalar los activos. De manera predeterminada, los activos se copiarán a tu directorio ``web``. - - En vez de copiar tus activos *Symfony*, puedes crear enlaces simbólicos si tu sistema operativo los apoya. Para crear enlaces simbólicos, añade una entrada en el nodo ``extra`` de tu archivo :file:`composer.json`` con la clave ``symfony-assets-install`` y el valor ``symlink``: - - - .. code-block:: json - - "extra": { - "symfony-app-dir": "app", - "symfony-web-dir": "web", - "symfony-assets-install": "symlink" - } - - Al suministrar ``relative`` en lugar de ``symlink`` a ``symfony-assets-install``, la orden generará enlaces simbólicos relativos. - -Instalando y configurando -~~~~~~~~~~~~~~~~~~~~~~~~~ - -En este punto, todas las bibliotecas de terceros necesarias ahora viven en el directorio :file:`vendor/`. También tienes una instalación predeterminada de la aplicación en :file:`app/` y algunos ejemplos de código dentro de :file:`src/`. - -*Symfony2* viene con una interfaz visual para probar la configuración del servidor, muy útil para ayudarte a solucionar problemas relacionados con la configuración de tu servidor web y *PHP* para utilizar *Symfony*. Usa la siguiente *URL* para examinar tu configuración: - -.. code-block:: text - - http://localhost/config.php - -Si hay algún problema, corrígelo antes de continuar. - -.. sidebar:: Configurando permisos - - Un problema común es que ambos directorios ``app/cache`` y ``app/logs`` deben tener permiso de escritura, tanto para el servidor web cómo para la línea de ordenes del usuario. En un sistema *UNIX*, si el usuario del servidor *web* es diferente de tu usuario de la línea de ordenes, puedes ejecutar las siguientes ordenes una sola vez en el proyecto para garantizar que los permisos se configuran correctamente. - - **Ten en cuenta que no todos los servidores web corren como el usuario** ``www-data`` como en los ejemplos de abajo. En su lugar, revisa qué usuario está corriendo *tu* servidor *web* y úsalo en lugar de ``www-data``. - - En un sistema *UNIX*, esto se puede hacer con una de las siguientes órdenes: - - .. code-block:: bash - - $ ps aux | grep httpd - - o - - .. code-block:: bash - - $ ps aux | grep apache - - **1. Usando ACL en un sistema que admite chmod +a** - - Muchos sistemas te permiten utilizar la orden chmod +a. Intenta esta orden primero, y si se produce un error --- intenta el siguiente método: Asegurate de cambiar ``www-data`` por el usuario de tu servidor *web* en la primer orden ``chmod``: - - .. code-block:: bash - - $ rm -rf app/cache/* - $ rm -rf app/logs/* - - $ sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs - $ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs - - **2. Usando ACL en un sistema que no es compatible con chmod +a** - - Algunos sistemas, no son compatibles con ``chmod +a``, pero son compatibles con otra utilidad llamada ``setfacl``. Posiblemente tengas que habilitar la `compatibilidad con ACL`_ en tu partición e instalar :dfn:`setfacl` antes de usarlo (como es el caso de *Ubuntu*), de esta manera: - - .. code-block:: bash - - $ sudo setfacl -R -m u:www-data:rwX -m u:`whoami`:rwX app/cache app/logs - $ sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs - - **3. Sin usar ACL** - - Si no tienes acceso para modificar los directorios *ACL*, tendrás que cambiar la ``umask`` para que los directorios ``cache/`` y ``logs/`` se puedan escribir por el grupo o por cualquiera (dependiendo de si el usuario del servidor web y el usuario de la línea de ordenes están en el mismo grupo o no). Para ello, pon la siguiente línea al comienzo de los archivos ``app/console``, ``web/app.php`` y ``web/app_dev.php``:: - - umask(0002); // Esto permitirá que los permisos sean 0775 - - // o - - umask(0000); // Esto permitirá que los permisos sean 0777 - - Ten en cuenta que el uso de *ACL* se recomienda cuando tienes acceso a ellos en el servidor porque cambiar la ``umask`` no es seguro en subprocesos. - -Cuando todo esté listo, haz clic en el enlace «Visita la página de Bienvenida» para ver tu primer aplicación «real» en *Symfony2*: - -.. code-block:: text - - http://localhost/app_dev.php/ - -¡*Symfony2* debería darte la bienvenida y felicitarte por tu arduo trabajo hasta el momento! - -.. image:: /images/quick_tour/welcome.png - -.. tip:: - - Para conseguir bonitas y breves *URL* deberías apuntar el documento raíz de tu servidor *web* o servidor virtual al directorio ``Symfony/web/``. Aunque esto no es necesario para el desarrollo, es recomendable al momento de desplegar tu aplicación en producción cuando todo el sistema y archivos de configuración se vuelven inaccesibles a los clientes. Para información sobre cómo configurar el directorio raíz de tu servidor web, lee :doc:`/cookbook/configuration/web_server_configuration` o consulta la documentación oficial de tu servidor web: - `Apache`_ | `Nginx`_ . - -Empezando a desarrollar ------------------------ - -Ahora que tienes una aplicación *Symfony2* completamente operativa, ¡puedes empezar a desarrollarla! Tu distribución puede contener algún código de ejemplo --- revisa el archivo ``README.md`` incluido con la distribución (abrelo como archivo de texto) para ver qué código de ejemplo incluye tu distribución. - -Si es tu primer contacto con *Symfony*, alcánzanos en «:doc:`page_creation`», donde aprenderás a crear páginas, cambiar la configuración, y todo lo que necesitarás en tu nueva aplicación. - -Además, asegúrate de revisar el :doc:`Recetario `, el cual contiene una amplia variedad de artículos que solucionan problemas específicos con *Symfony*. - -.. note:: - - Si quieres eliminar el código de ejemplo de tu distribución, dale un vistazo a este artículo en el recetario: «:doc:`/cookbook/bundles/remove`» - -Usando control de código fuente -------------------------------- - -Si estás utilizando un sistema de control de versiones como ``Git`` o ``Subversion``, puedes configurar tu sistema de control de versiones y empezar a confirmar cambios al proyecto normalmente. La *edición estándar de Symfony* **es** el punto de partida para tu nuevo proyecto. - -Para instrucciones específicas sobre la mejor manera de configurar el proyecto para almacenarlo en *git*, consulta :doc:`/cookbook/workflow/new_project_git`. - -Ignorando el directorio :file:`vendor/` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si has descargado el archivo *sin proveedores*, puedes omitir todo el directorio :file:`vendor/` y no confirmarlo al control de versiones. Con ``Git``, esto se logra creando un archivo :file:`.gitignore` y añadiendo lo siguiente: - -.. code-block:: text - - /vendor/ - -Ahora, el directorio de proveedores no será confirmado al control de versiones. Esto está muy bien (en realidad, ¡es genial!) porque cuando alguien más clone o coteje el proyecto, él/ella simplemente puede ejecutar el archivo ``php composer.phar install`` para descargar todas las bibliotecas de proveedores necesarias. - -.. _`compatibilidad con ACL`: https://help.ubuntu.com/community/FilePermissionsACLs -.. _`http://symfony.com/download`: http://symfony.com/download -.. _`Git`: http://git-scm.com/ -.. _`GitHub Bootcamp`: http://help.github.com/set-up-git-redirect -.. _`Composer`: http://getcomposer.org/ -.. _`descargando Composer`: http://getcomposer.org/download/ -.. _`Apache`: http://httpd.apache.org/docs/current/mod/core.html#documentroot -.. _`Nginx`: http://wiki.nginx.org/Symfony -.. _`Página de instalación de Symfony`: http://symfony.com/download diff --git a/_sources/book/internals.txt b/_sources/book/internals.txt deleted file mode 100644 index 6aee06f..0000000 --- a/_sources/book/internals.txt +++ /dev/null @@ -1,543 +0,0 @@ -.. index:: - single: Funcionamiento interno - -Funcionamiento interno -====================== - -Parece que quieres entender cómo funciona y cómo extender *Symfony2*. -¡Eso me hace muy feliz! Esta sección es una explicación en profundidad de *Symfony2* desde dentro. - -.. note:: - - Necesitas leer esta sección sólo si quieres entender cómo funciona *Symfony2* detrás de la escena, o si deseas extender *Symfony2*. - -Descripción ------------ - -El código *Symfony2* está hecho de varias capas independientes. Cada capa está construida en lo alto de la anterior. - -.. tip:: - - La carga automática no la gestiona la plataforma directamente; Esto se hace utilizando el cargador automático de ``Composer`` (:file:`vendor/autoload.php`), el cual está incluido en el archivo :file:`src/autoload.php`. - -Componente ``HttpFoundation`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Al nivel más profundo está el componente :namespace:`Symfony\\Component\\HttpFoundation`. ``HttpFoundation`` proporciona los principales objetos necesarios para hacer frente a *HTTP*. -Es una abstracción orientada a objetos de algunas funciones y variables nativas de *PHP*: - -* La clase :class:`Symfony\\Component\\HttpFoundation\\Request` resume las principales variables globales de *PHP*, tales como ``$_GET``, ``$_POST``, ``$_COOKIE``, ``$_FILES`` y ``$_SERVER``; - -* La clase :class:`Symfony\\Component\\HttpFoundation\\Response` abstrae algunas funciones *PHP* como ``header()``, ``setcookie()`` y ``echo``; - -* La clase :class:`Symfony\\Component\\HttpFoundation\\Session` y la interfaz :class:`Symfony\\Component\\HttpFoundation\\SessionStorage\\SessionStorageInterface`, abstraen la gestión de sesiones y las funciones ``session_*()``. - -Componente ``HttpKernel`` -~~~~~~~~~~~~~~~~~~~~~~~~~ - -En lo alto de ``HttpFoundation`` está el componente :namespace:`Symfony\\Component\\HttpKernel`. ``HttpKernel`` se encarga de la parte dinámica de *HTTP*; es una fina capa en la parte superior de las clases ``Petición`` y ``Respuesta`` para estandarizar la forma en que se manejan las peticiones. Este, también proporciona puntos de extensión y herramientas que lo convierten en el punto de partida ideal para crear una plataforma *Web* sin demasiado trabajo. - -Además, opcionalmente añade configurabilidad y extensibilidad, gracias al componente de inyección de dependencias y un potente sistema de complementos (paquetes). - -.. seealso:: - - Lee más sobre la :doc:`Inyección de dependencias ` y los :doc:`Paquetes `. - -Paquete ``FrameworkBundle`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El paquete :namespace:`Symfony\\Bundle\\FrameworkBundle` es el paquete que une los principales componentes y bibliotecas para hacer una plataforma *MVC* ligera y rápida. Este viene con una sensible configuración predeterminada y convenios para suavizar la curva de aprendizaje. - -.. index:: - single: Funcionamiento interno; Kernel - -El núcleo ---------- - -La clase :class:`Symfony\\Component\\HttpKernel\\HttpKernel` es la clase central de *Symfony2* y es responsable de procesar las peticiones del cliente. Su objetivo principal es «convertir» un objeto :class:`Symfony\\Component\\HttpFoundation\\Request` a un objeto :class:`Symfony\\Component\\HttpFoundation\\Response`. - -Cada ``núcleo`` de *Symfony2* implementa :class:`Symfony\\Component\\HttpKernel\\HttpKernelInterface`:: - - function handle(Request $request, $type = self::MASTER_REQUEST, $catch = true) - -.. index:: - single: Funcionamiento interno; Resolutor de controlador - -Controladores -~~~~~~~~~~~~~ - -Para convertir una ``Petición`` a una ``Respuesta``, el ``núcleo`` cuenta con un «``Controlador``». Un controlador puede ser cualquier *PHP* ejecutable válido. - -El ``núcleo`` delega la selección de cual controlador se debe ejecutar a una implementación de :class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface`:: - - public function getController(Request $request); - - public function getArguments(Request $request, $controller); - -El método :method:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface::getController` devuelve el controlador (un *PHP* ejecutable) asociado a la petición dada. La implementación predeterminada de (:class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolver`) busca un atributo ``_controller`` en la petición que representa el nombre del controlador (una cadena ``«class::method»``, cómo ``Bundle\BlogBundle\PostController:indexAction``). - -.. tip:: - - La implementación predeterminada utiliza la clase :class:`Symfony\\Bundle\\FrameworkBundle\\EventListener\\RouterListener` para definir el atributo ``_controller`` de la petición (consulta el :ref:`kernel-core-request`). - -El método :method:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface::getArguments` devuelve un arreglo de argumentos para pasarlo al Controlador ejecutable. La implementación predeterminada automáticamente resuelve los argumentos del método, basándose en los atributos de la Petición. - -.. sidebar:: Emparejando los argumentos del método ``Controlador`` desde los atributos de la ``Petición`` - - Por cada argumento del método, *Symfony2* trata de obtener el valor de un atributo de la ``Petición`` con el mismo nombre. Si no se proporciona, el valor predeterminado es el argumento utilizado de estar definido:: - - // Symfony2 debe buscar un atributo 'id' (obligatorio) - // y un 'admin' (opcional) - public function showAction($id, $admin = true) - { - // ... - } - -.. index:: - single: Funcionamiento interno; Procesando la petición - -Procesando peticiones -~~~~~~~~~~~~~~~~~~~~~ - -El método :method:`Symfony\\Component\\HttpKernel\\HttpKernel::handle` toma una ``Petición`` y *siempre* devuelve una ``Respuesta``. Para convertir la ``Petición``, ``handle()`` confía en el mecanismo de resolución y una cadena ordenada de notificaciones de evento (consulta la siguiente sección para más información acerca de cada evento): - -#. Antes de hacer cualquier otra cosa, difunde el evento ``kernel.request`` ---si alguno de los escuchas devuelve una ``Respuesta``, salta directamente al paso 8; - -#. El mecanismo de resolución es llamado para determinar el controlador a ejecutar; - -#. Los escuchas del evento ``kernel.controller`` ahora pueden manipular el controlador ejecutable como quieras (cambiarlo, envolverlo, ...); - -#. El núcleo verifica que el controlador en realidad es un *PHP* ejecutable válido; - -#. Se llama al mecanismo de resolución para determinar los argumentos a pasar al controlador; - -#. El ``núcleo`` llama al controlador; - -#. Si el controlador no devuelve una ``Respuesta``, los escuchas del evento ``kernel.view`` pueden convertir en ``Respuesta`` el valor devuelto por el Controlador; - -#. Los escuchas del evento ``kernel.response`` pueden manipular la ``Respuesta`` (contenido y cabeceras); - -#. Devuelve la respuesta. - -Si se produce una Excepción durante el procesamiento, difunde la ``kernel.exception`` y se da la oportunidad a los escuchas de convertir la excepción en una ``Respuesta``. Si esto funciona, se difunde el evento ``kernel.response``; si no, se vuelve a lanzar la excepción. - -Si no deseas que se capturen las Excepciones (para peticiones incrustadas, por ejemplo), desactiva el evento ``kernel.exception`` pasando ``false`` como tercer argumento del método ``handle()``. - -.. index:: - single: Funcionamiento interno; Peticiones internas - -Funcionamiento interno de las peticiones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En cualquier momento durante el manejo de una petición (la 'maestra' uno), puede manejar una subpetición. Puedes pasar el tipo de petición al método ``handle()`` (su segundo argumento): - -* ``HttpKernelInterface::MASTER_REQUEST``; -* ``HttpKernelInterface::SUB_REQUEST``. - -El tipo se pasa a todos los eventos y los escuchas pueden actuar en consecuencia (algún procesamiento sólo debe ocurrir en la petición maestra). - -.. index:: - pair: Kernel; Evento - -Eventos -~~~~~~~ - -Cada evento lanzado por el ``núcleo`` es una subclase de :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`. Esto significa que cada evento tiene acceso a la misma información básica: - -* :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequestType` --- devuelve el *tipo* de la petición (``HttpKernelInterface::MASTER_REQUEST`` o ``HttpKernelInterface::SUB_REQUEST``); - -* :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getKernel` --- devuelve el núcleo que está procesando la petición; - -* :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequest` --- devuelve la ``Petición`` procesada actualmente. - -``getRequestType()`` -.................... - -El método ``getRequestType()`` permite a los escuchas conocer el tipo de la petición. Por ejemplo, si un escucha sólo debe estar atento a las peticiones maestras, agrega el siguiente código al principio de tu método escucha:: - - use Symfony\Component\HttpKernel\HttpKernelInterface; - - if (HttpKernelInterface::MASTER_REQUEST !== $event->getRequestType()) { - // regresa inmediatamente - return; - } - -.. tip:: - - Si todavía no estás familiarizado con el *Despachador de eventos* de *Symfony2*, primero lee la sección del :doc:`Componente despachador de eventos `. - -.. index:: - single: Evento; kernel.request - -.. _kernel-core-request: - -Evento ``kernel.request`` -......................... - -*Clase del evento*: :class:`Symfony\\Component\\HttpKernel\\Event\\GetResponseEvent` - -El objetivo de este evento es devolver inmediatamente un objeto ``Respuesta`` o variables de configuración para poder invocar un controlador después del evento. Cualquier escucha puede devolver un objeto ``Respuesta`` a través del método ``setResponse()`` en el evento. En este caso, todos los otros escuchas no serán llamados. - -Este evento lo utiliza el ``FrameworkBundle`` para llenar el atributo ``_controller`` de la ``Petición``, a través de :class:`Symfony\\Bundle\\FrameworkBundle\\EventListener\\RouterListener`. ``RequestListener`` usa un objeto :class:`Symfony\\Component\\Routing\\RouterInterface` para emparejar la ``Petición`` y determinar el nombre del controlador (guardado en el atributo ``_controller`` de la ``Petición``). - -.. index:: - single: Evento; kernel.controller - -Evento ``kernel.controller`` -............................ - -*Clase del evento*: :class:`Symfony\\Component\\HttpKernel\\Event\\FilterControllerEvent` - -Este evento no lo utiliza el ``FrameworkBundle``, pero puede ser un punto de entrada para modificar el controlador que se debe ejecutar:: - - use Symfony\Component\HttpKernel\Event\FilterControllerEvent; - - public function onKernelController(FilterControllerEvent $event) - { - $controller = $event->getController(); - // ... - - // el controlador se puede cambiar a cualquier PHP ejecutable - $event->setController($controller); - } - -.. index:: - single: Evento; kernel.view - -Evento ``kernel.view`` -...................... - -*Clase del evento*: :class:`Symfony\\Component\\HttpKernel\\Event\\GetResponseForControllerResultEvent` - -Este evento no lo utiliza el ``FrameworkBundle``, pero lo puedes usar para implementar un subsistema de vistas. Este evento se llama *sólo* si el controlador *no* devuelve un objeto ``Respuesta``. El propósito del evento es permitir que algún otro valor de retorno se convierta en una ``Respuesta``. - -El valor devuelto por el controlador es accesible a través del método ``getControllerResult``:: - - use Symfony\Component\HttpKernel\Event\GetResponseForControllerResultEvent; - use Symfony\Component\HttpFoundation\Response; - - public function onKernelView(GetResponseForControllerResultEvent $event) - { - $val = $event->getControllerResult(); - $response = new Response(); - - // ... de alguna manera modifica la Respuesta desde el valor de retorno - - $event->setResponse($response); - } - -.. index:: - single: Evento; kernel.response - -Evento ``kernel.response`` -.......................... - -*Clase del evento*: :class:`Symfony\\Component\\HttpKernel\\Event\\FilterResponseEvent` - -El propósito de este evento es permitir que otros sistemas modifiquen o sustituyan el objeto ``Respuesta`` después de su creación:: - - public function onKernelResponse(FilterResponseEvent $event) - { - $response = $event->getResponse(); - - // ... modifica el objeto Respuesta - } - -El ``FrameworkBundle`` registra varios escuchas: - -* :class:`Symfony\\Component\\HttpKernel\\EventListener\\ProfilerListener`: - recoge los datos de la petición actual; - -* :class:`Symfony\\Bundle\\WebProfilerBundle\\EventListener\\WebDebugToolbarListener`: - inyecta la barra de herramientas de depuración web; - -* :class:`Symfony\\Component\\HttpKernel\\EventListener\\ResponseListener`: fija el ``Content-Type`` de la respuesta basándose en el formato de la petición; - -* :class:`Symfony\\Component\\HttpKernel\\EventListener\\EsiListener`: agrega una cabecera *HTTP* ``Surrogate-Control`` cuando es necesario analizar etiquetas *ESI* en la respuesta. - -.. index:: - single: Evento; kernel.exception - -.. _kernel-kernel.exception: - -Evento ``kernel.exception`` -........................... - -*Clase del evento*: :class:`Symfony\\Component\\HttpKernel\\Event\\GetResponseForExceptionEvent` - -``FrameworkBundle`` registra un :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener` el cual remite la ``Petición`` a un determinado controlador (el valor del parámetro ``exception_listener.controller`` ---debe estar en notación ``clase::método``---). - -Un escucha de este evento puede crear y configurar un objeto ``Respuesta``, crear y establecer un nuevo objeto ``Excepción``, o simplemente no hacer nada:: - - use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent; - use Symfony\Component\HttpFoundation\Response; - - public function onKernelException(GetResponseForExceptionEvent $event) - { - $exception = $event->getException(); - $response = new Response(); - // configura el objeto respuesta basándose en la excepción capturada - $event->setResponse($response); - - // alternativamente puedes establecer una nueva excepción - // $exception = new \Exception('Some special exception'); - // $event->setException($exception); - } - -.. note:: - - Debido a que *Symfony* se asegura de que el código de estado de la ``Respuesta`` se ajusta al más adecuado dependiendo de la excepción, establecer el estado de la respuesta no funcionará. Si quieres reescribir el código de estado (no deberías, sin una buena razón), configurar la cabecera ``X-Status-Code``:: - - return new Response('Error', 404 /* ignored */, array('X-Status-Code' => 200)); - -.. index:: - single: Despachador de evento - -El despachador de eventos -------------------------- - -El despachador de eventos es un componente independiente y es el responsable de mucha de la lógica y flujo subyacente detrás de una petición *Symfony*. Para más información consulta la documentación del :doc:`Componente despachador de eventos `. - -.. index:: - single: Generador de perfiles - -.. _internals-profiler: - -Generador de perfiles ---------------------- - -Cuando se activa, el generador de perfiles de *Symfony2* recoge información útil sobre cada petición presentada a tu aplicación y la almacena para su posterior análisis. Utiliza el generador de perfiles en el entorno de desarrollo para que te ayude a depurar tu código y mejorar el rendimiento; úsalo en el entorno de producción para explorar problemas después del hecho. - -Rara vez tienes que lidiar con el generador de perfiles directamente puesto que *Symfony2* proporciona herramientas de visualización como la barra de herramientas de depuración web y el generador de perfiles web. Si utilizas la *edición estándar de Symfony2*, el generador de perfiles, la barra de herramientas de depuración web, y el generador de perfiles web, ya están configurados con ajustes razonables. - -.. note:: - - El generador de perfiles recopila información para todas las peticiones (peticiones simples, redirecciones, excepciones, peticiones *Ajax*, peticiones *ESI*; y para todos los métodos *HTTP* y todos los formatos). Esto significa que para una única *URL*, puedes tener varios perfiles de datos asociados (un par petición/respuesta externa). - -.. index:: - single: Generador de perfiles: Visualizando - -Visualizando perfiles de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Usando la barra de depuración web -................................. - -En el entorno de desarrollo, la barra de depuración web está disponible en la parte inferior de todas las páginas. Esta muestra un buen resumen de los datos perfilados que te da acceso instantáneo a una gran cantidad de información útil cuando algo no funciona como esperabas. - -Si el resumen presentado por las herramientas de la barra de depuración web no es suficiente, haz clic en el enlace simbólico (una cadena compuesta de 13 caracteres aleatorios) para acceder al generador de perfiles web. - -.. note:: - - Si no se puede hacer clic en el enlace, significa que las rutas del generador de perfiles no están registradas (más adelante hay información de configuración). - -Analizando datos del perfil con el generador de perfiles web -............................................................ - -El generador de perfiles web es una herramienta de visualización para perfilar datos que puedes utilizar en desarrollo para depurar tu código y mejorar el rendimiento; pero también lo puedes utilizar para explorar problemas que ocurren en producción. Este expone toda la información recogida por el generador de perfiles en una interfaz web. - -.. index:: - single: Generador de perfiles: Usando el servicio generador de perfiles - -Accediendo a información del generador de perfiles -.................................................. - -No es necesario utilizar el visualizador predeterminado para acceder a la información de perfiles. Pero ¿cómo se puede recuperar información del perfil de una petición específica después del hecho? Cuando el generador de perfiles almacena datos sobre una ``Petición``, también le asocia una ficha; esta ficha está disponible en la cabecera *HTTP* ``X-Debug-Token`` de la Respuesta:: - - $profile = $container->get('profiler')->loadProfileFromResponse($response); - - $profile = $container->get('profiler')->loadProfile($token); - -.. tip:: - - Cuando el generador de perfiles está habilitado pero no la barra de herramientas de depuración *web*, o cuando desees obtener la ficha de una petición *Ajax*, utiliza una herramienta como *Firebug* para obtener el valor de la cabecera *HTTP* ``X-Debug-Token``. - -Usa el método :method:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler::find` para acceder a elementos basándose en algún criterio:: - - // consigue las 10 últimas fichas - $tokens = $container->get('profiler')->find('', '', 10); - - // consigue las 10 últimas fichas de todas las URL que contienen /admin/ - $tokens = $container->get('profiler')->find('', '/admin/', 10); - - // consigue las 10 últimas fichas de peticiones locales - $tokens = $container->get('profiler')->find('127.0.0.1', '', 10); - -Si deseas manipular los datos del perfil en una máquina diferente a la que generó la información, utiliza los métodos :method:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler::export` e :method:`Symfony\\Component\\HttpKernel\\Profiler\\Profiler::import`:: - - // en la máquina en producción - $profile = $container->get('profiler')->loadProfile($token); - $data = $profiler->export($profile); - - // en la máquina de desarrollo - $profiler->import($data); - -.. index:: - single: Generador de perfiles: Visualizando - -Configurando -............ - -La configuración predeterminada de *Symfony2* viene con ajustes razonables para el generador de perfiles, la barra de herramientas de depuración web, y el generador de perfiles web. Aquí está por ejemplo la configuración para el entorno de desarrollo: - -.. configuration-block:: - - .. code-block:: yaml - - # carga el generador de perfiles - framework: - profiler: { only_exceptions: false } - - # activa el generador de perfiles web - web_profiler: - toolbar: true - intercept_redirects: true - - .. code-block:: xml - - - - - - - - - - - - - .. code-block:: php - - // carga el generador de perfiles - $container->loadFromExtension('framework', array( - 'profiler' => array('only-exceptions' => false), - )); - - // activa el generador de perfiles web - $container->loadFromExtension('web_profiler', array( - 'toolbar' => true, - 'intercept-redirects' => true, - 'verbose' => true, - )); - -Cuando ``only-exceptions`` se establece a ``true``, el generador de perfiles sólo recoge datos cuando tu aplicación lanza una excepción. - -Cuando ``intercept-redirects`` está establecido en ``true``, el generador de perfiles web intercepta las redirecciones y te da la oportunidad de analizar los datos recogidos antes de seguir la redirección. - -Si activas el generador de perfiles web, también es necesario montar las rutas de los perfiles: - -.. configuration-block:: - - .. code-block:: yaml - - _profiler: - resource: @WebProfilerBundle/Resources/config/routing/profiler.xml - prefix: /_profiler - - .. code-block:: xml - - - - .. code-block:: php - - $collection->addCollection($loader->import("@WebProfilerBundle/Resources/config/routing/profiler.xml"), '/_profiler'); - -Dado que el generador de perfiles añade algo de sobrecarga, posiblemente desees activarlo sólo bajo ciertas circunstancias en el entorno de producción. La configuración ``only-exceptions`` limita al generador de perfiles a 500 páginas, ¿pero si quieres obtener información cuando la *IP* cliente proviene de una dirección específica, o para una porción limitada del sitio web? Puedes utilizar una emparejadora de petición: - -.. configuration-block:: - - .. code-block:: yaml - - # activa el generador de perfiles sólo para peticiones entrantes de la red 192.168.0.0 - framework: - profiler: - matcher: { ip: 192.168.0.0/24 } - - # activa el generador de perfiles sólo para las URL /admin - framework: - profiler: - matcher: { path: "^/admin/" } - - # combina reglas - framework: - profiler: - matcher: { ip: 192.168.0.0/24, path: "^/admin/" } - - # usa una instancia emparejadora personalizada definida en el servicio 'custom_matcher' - framework: - profiler: - matcher: { service: custom_matcher } - - .. code-block:: xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - // activa el generador de perfiles sólo para peticiones entrantes de la red 192.168.0.0 - $container->loadFromExtension('framework', array( - 'profiler' => array( - 'matcher' => array('ip' => '192.168.0.0/24'), - ), - )); - - // activa el generador de perfiles sólo para las URL /admin - $container->loadFromExtension('framework', array( - 'profiler' => array( - 'matcher' => array('path' => '^/admin/'), - ), - )); - - // combina reglas - $container->loadFromExtension('framework', array( - 'profiler' => array( - 'matcher' => array('ip' => '192.168.0.0/24', 'path' => '^/admin/'), - ), - )); - - # usa una instancia emparejadora personalizada definida en el servicio 'custom_matcher' - $container->loadFromExtension('framework', array( - 'profiler' => array( - 'matcher' => array('service' => 'custom_matcher'), - ), - )); - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/testing/profiling` -* :doc:`/cookbook/profiler/data_collector` -* :doc:`/cookbook/event_dispatcher/class_extension` -* :doc:`/cookbook/event_dispatcher/method_behavior` - -.. _`componente de Inyección de dependencias de Symfony2`: https://github.com/symfony/DependencyInjection diff --git a/_sources/book/page_creation.txt b/_sources/book/page_creation.txt deleted file mode 100644 index 3e9f911..0000000 --- a/_sources/book/page_creation.txt +++ /dev/null @@ -1,789 +0,0 @@ -.. index:: - single: Creando páginas - -Creando páginas en *Symfony2* -============================= - -Crear una nueva página en *Symfony2* es un sencillo proceso de dos pasos: - -* *Crea una ruta*: Una ruta define la *URL* de tu página (por ejemplo ``/sobre``) y especifica un controlador (el cual es una función *PHP*) que *Symfony2* debe ejecutar cuando la *URL* de una petición entrante coincida con el patrón de la ruta; - -* *Crea un controlador*: Un controlador es una función *PHP* que toma la petición entrante y la transforma en el objeto ``Respuesta`` de *Symfony2* que es devuelto al usuario. - -Nos encanta este enfoque simple porque coincide con la forma en que funciona la *Web*. -Cada interacción en la *Web* se inicia con una petición *HTTP*. El trabajo de la aplicación simplemente es interpretar la petición y devolver la respuesta *HTTP* adecuada. - -*Symfony2* sigue esta filosofía y te proporciona las herramientas y convenios para mantener organizada tu aplicación a medida que crece en usuarios y complejidad. - -.. index:: - single: Creando páginas; Ejemplo - -La página «¡Hola *Symfony*!» ----------------------------- - -Vamos a empezar construyendo un subproducto de la clásica aplicación «¡Hola Mundo!». Cuando hayamos terminado, el usuario podrá recibir un saludo personal (por ejemplo, «Hola *Symfony*») al ir a la siguiente *URL*: - -.. code-block:: text - - http://localhost/app_dev.php/hello/Symfony - -En realidad, serás capaz de sustituir ``Symfony`` con cualquier otro nombre al cual darle la bienvenida. Para crear la página, sigue el simple proceso de dos pasos. - -.. note:: - - La guía asume que ya has descargado *Symfony2* y configurado tu servidor web. En la *URL* anterior se supone que ``localhost`` apunta al directorio ``web``, de tu nuevo proyecto *Symfony2*. Para información más detallada sobre este proceso, consulta la documentación del servidor *web* que estás usando. - Aquí están las páginas de la documentación pertinente para algunos servidores *web* que podrías estar utilizando: - - * Para el servidor *HTTP* *Apache*, consulta la documentación de `Apache sobre DirectoryIndex`_. Para *Nginx*, consulta la documentación de `ubicación HttpCoreModule de Nginx`_. - -Antes de empezar: Crea el paquete -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de empezar, tendrás que crear un ``bundle`` (*paquete* en adelante). En *Symfony2*, un :term:`paquete` es como un complemento (o plugin, para los puristas), salvo que todo el código de tu aplicación debe vivir dentro de un paquete. - -Un paquete no es más que un directorio que alberga todo lo relacionado con una función específica, incluyendo clases *PHP*, configuración, e incluso hojas de estilo y archivos de *Javascript* (consulta :ref:`page-creation-bundles`). - -Para crear un paquete llamado ``AcmeHelloBundle`` (el paquete de ejemplo que vamos a construir en este capítulo), ejecuta la siguiente orden y sigue las instrucciones en pantalla (usa todas las opciones predeterminadas): - -.. code-block:: bash - - $ php app/console generate:bundle --namespace=Acme/HelloBundle --format=yml - -Detrás del escenario, se crea un directorio para el paquete en :file:`src/Acme/HelloBundle`. -Además, automáticamente agrega una línea al archivo ``app/AppKernel.php`` para registrar el paquete en el núcleo:: - - // app/AppKernel.php - public function registerBundles() - { - $bundles = array( - ..., - new Acme\HelloBundle\AcmeHelloBundle(), - ); - // ... - - return $bundles; - } - -Ahora que ya está configurado el paquete, puedes comenzar a construir tu aplicación dentro del paquete. - -Paso 1: Creando la ruta -~~~~~~~~~~~~~~~~~~~~~~~~ - -De manera predeterminada, el archivo de configuración de enrutado en una aplicación *Symfony2* se encuentra en :file:`app/config/routing.yml`. Al igual que toda la configuración en *Symfony2*, fuera de la caja también puedes optar por utilizar *XML* o *PHP* para configurar tus rutas. - -Si te fijas en el archivo de enrutado principal, verás que *Symfony* ya ha agregado una entrada al generar el ``AcmeHelloBundle``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - acme_hello: - resource: "@AcmeHelloBundle/Resources/config/routing.yml" - prefix: / - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->addCollection( - $loader->import('@AcmeHelloBundle/Resources/config/routing.php'), - '/', - ); - - return $collection; - -Esta entrada es bastante básica: le dice a *Symfony* que cargue la configuración de enrutado del archivo ``Resources/config/routing.yml`` que reside en el interior del ``AcmeHelloBundle``. -Esto significa que colocas la configuración de enrutado directamente en ``app/config/routing.yml`` u organizas tus rutas a través de tu aplicación, y las importas desde ahí. - -Ahora que el archivo :file:`routing.yml` es importado desde el paquete, añade la nueva ruta que define la *URL* de la página que estás a punto de crear: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/routing.yml - hello: - path: /hello/{name} - defaults: { _controller: AcmeHelloBundle:Hello:index } - - .. code-block:: xml - - - - - - - - AcmeHelloBundle:Hello:index - - - - .. code-block:: php - - // src/Acme/HelloBundle/Resources/config/routing.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('hello', new Route('/hello/{name}', array( - '_controller' => 'AcmeHelloBundle:Hello:index', - ))); - - return $collection; - -La ruta se compone de dos piezas básicas: ``path``, que es la *URL* con la que esta ruta debe coincidir, y un arreglo ``defaults``, que especifica el controlador que se debe ejecutar. La sintaxis del marcador de posición (``{name}``) en la ruta es un comodín. Significa que ``/hello/Ryan``, ``/hello/Fabien`` o cualquier otra *URI* similar coincidirá con esta ruta. El parámetro marcador de posición ``{name}`` también se pasará al controlador, de manera que podamos utilizar su valor para saludar personalmente al usuario. - -.. note:: - - El sistema de enrutado tiene muchas más características para crear estructuras *URI* flexibles y potentes en tu aplicación. Para más detalles, consulta el capítulo :doc:`Enrutando `. - -Paso 2: Creando el controlador -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando una *URL* como ``/hello/Ryan`` es manejada por la aplicación, la ruta ``hello`` corresponde con el controlador ``AcmeHelloBundle:Hello:index`` el cual es ejecutado por la plataforma. El segundo paso del proceso de creación de páginas es precisamente la creación de ese controlador. - -El controlador --- ``AcmeHelloBundle:Hello:index`` es el nombre *lógico* del controlador, el cual se asigna al método ``indexAction`` de una clase *PHP* llamada ``Acme\HelloBundle\Controller\HelloController``. Empieza creando este archivo dentro de tu ``AcmeHelloBundle``:: - - // src/Acme/HelloBundle/Controller/HelloController.php - namespace Acme\HelloBundle\Controller; - - class HelloController - { - } - -En realidad, el controlador no es más que un método *PHP* que tú creas y *Symfony* ejecuta. Aquí es donde el código utiliza la información de la petición para construir y preparar el recurso solicitado. Salvo en algunos casos avanzados, el producto final de un controlador siempre es el mismo: un objeto ``Respuesta`` de *Symfony2*. - -Crea el método ``indexAction`` que *Symfony* ejecutará cuando concuerde la ruta ``hello``:: - - // src/Acme/HelloBundle/Controller/HelloController.php - namespace Acme\HelloBundle\Controller; - - use Symfony\Component\HttpFoundation\Response; - - class HelloController - { - public function indexAction($name) - { - return new Response('Hello '.$name.'!'); - } - } - -El controlador es simple: este crea un nuevo objeto ``Respuesta``, cuyo primer argumento es el contenido que se debe utilizar para la respuesta (una pequeña página *HTML* en este ejemplo). - -¡Enhorabuena! Después de crear solamente una ruta y un controlador ¡ya tienes una página completamente operativa! Si todo lo has configurado correctamente, la aplicación debe darte la bienvenida: - -.. code-block:: text - - http://localhost/app_dev.php/hello/Ryan - -.. tip:: - - También puedes ver tu aplicación en el :ref:`entorno ` «prod» visitando: - - .. code-block:: text - - http://localhost/app.php/hello/Ryan - - Si se produce un error, probablemente sea porque necesitas vaciar la caché ejecutando: - - .. code-block:: bash - - $ php app/console cache:clear --env=prod --no-debug - -Un opcional, pero frecuente, tercer paso en el proceso es crear una plantilla. - -.. note:: - - Los controladores son el punto de entrada principal a tu código y un ingrediente clave en la creación de páginas. Puedes encontrar mucho más información en el capítulo :doc:`Controlador `. - -Paso 3 opcional: Creando la plantilla -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Las plantillas te permiten mover toda la presentación (por ejemplo, el código *HTML*) a un archivo separado y reutilizar diferentes partes del diseño de la página. En vez de escribir el código *HTML* dentro del controlador, en su lugar reproduce una plantilla: - -.. code-block:: php - :linenos: - - // src/Acme/HelloBundle/Controller/HelloController.php - namespace Acme\HelloBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - - class HelloController extends Controller - { - public function indexAction($name) - { - return $this->render( - 'AcmeHelloBundle:Hello:index.html.twig', - array('name' => $name) - ); - - // dibuja una plantilla PHP en su lugar - // return $this->render( - // 'AcmeHelloBundle:Hello:index.html.php', - // array('name' => $name) - // ); - } - } - -.. note:: - - Para poder usar el método :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::render`, tu controlador debe extender la clase :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller` que añade atajos para las tareas comunes en los controladores. Esto se hace en el ejemplo anterior añadiendo la declaración ``use`` en la línea 4 y luego extendiendo el ``Controlador`` en la línea 6. - -El método ``render()`` crea un objeto ``Respuesta`` poblado con el contenido propuesto, y reproduce la plantilla. Como cualquier otro controlador, en última instancia vas a devolver ese objeto ``Respuesta``. - -Ten en cuenta que hay dos ejemplos diferentes para procesar la plantilla. -De forma predeterminada, *Symfony2* admite dos diferentes lenguajes de plantillas: las clásicas plantillas *PHP* y las breves pero poderosas plantillas `Twig`_. No te espantes ---eres libre de optar por una o, incluso, ambas en el mismo proyecto. - -El controlador procesa la plantilla ``AcmeHelloBundle:Hello:index.html.twig``, utilizando la siguiente convención de nomenclatura: - - **NombrePaquete**:**NombreControlador**:**NombrePlantilla** - -Este es el nombre *lógico* de la plantilla, el cual se asigna a una ubicación física usando la siguiente convención. - - **/ruta/a/NombrePaquete**/Resources/views/**NombreControlador**/**NombrePlantilla** - -En este caso, ``AcmeHelloBundle`` es el nombre del paquete, ``Hello`` es el controlador e ``index.html.twig`` la plantilla: - -.. configuration-block:: - - .. code-block:: jinja - :linenos: - - {# src/Acme/HelloBundle/Resources/views/Hello/index.html.twig #} - {% extends '::base.html.twig' %} - - {% block body %} - Hello {{ name }}! - {% endblock %} - - .. code-block:: html+php - - - extend('::base.html.php') ?> - - Hello escape($name) ?>! - -Veamos la situación a través de la plantilla *Twig* línea por línea: - -* *línea 2*: La etiqueta ``extends`` define una plantilla padre. La plantilla define explícitamente un archivo con el diseño dentro del cual será colocada. - -* *línea 4*: La etiqueta ``block`` dice que todo el interior se debe colocar dentro de un bloque llamado ``body``. Como verás, es responsabilidad de la plantilla padre (``base.html.twig``) reproducir, en última instancia, el bloque llamado ``body``. - -La plantilla padre, ``::base.html.twig``, omite ambas porciones de su nombre tanto **NombrePaquete** como **NombreControlador** (de ahí los dobles dos puntos (``::``) al principio). Esto significa que la plantilla vive fuera de cualquier paquete, en el directorio ``app``: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# app/Resources/views/base.html.twig #} - - - - - {% block title %}Welcome!{% endblock %} - {% block stylesheets %}{% endblock %} - - - - {% block body %}{% endblock %} - {% block javascripts %}{% endblock %} - - - - .. code-block:: html+php - - - - - - - <?php $view['slots']->output('title', 'Welcome!') ?> - output('stylesheets') ?> - - - - output('_content') ?> - output('javascripts') ?> - - - -El archivo de la plantilla base define el diseño *HTML* y reproduce el bloque ``body`` que definiste en la plantilla ``index.html.twig``. Además reproduce el bloque ``title``, el cual puedes optar por definir en la plantilla ``index.html.twig``. -Dado que no has definido el bloque ``title`` en la plantilla derivada, el valor predeterminado es «``Welcome!``». - -Las plantillas son una poderosa manera de reproducir y organizar el contenido de tu página. Una plantilla puede reproducir cualquier cosa, desde el marcado *HTML*, al código *CSS*, o cualquier otra cosa que el controlador posiblemente tenga que devolver. - -En el ciclo de vida del manejo de una petición, el motor de plantillas simplemente es una herramienta opcional. Recuerda que el objetivo de cada controlador es devolver un objeto ``Respuesta``. Las plantillas son una poderosa, pero opcional, herramienta para crear el contenido de ese objeto ``Respuesta``. - -.. index:: - single: Estructura del directorio - -La estructura de directorios ----------------------------- - -Después de unas cortas secciones, ya entiendes la filosofía detrás de la creación y procesamiento de páginas en *Symfony2*. También has comenzado a ver cómo están estructurados y organizados los proyectos *Symfony2*. Al final de esta sección, sabrás dónde encontrar y colocar diferentes tipos de archivos y por qué. - -Aunque totalmente flexible, por omisión, cada :term:`aplicación` *Symfony* tiene la misma estructura de directorios básica y recomendada: - -* ``app/``: Este directorio contiene la configuración de la aplicación; - -* :file:`src/`: Todo el código *PHP* del proyecto se almacena en este directorio; - -* :file:`vendor/`: Por convención aquí se coloca cualquier biblioteca de terceros; - -* ``web/``: Este es el directorio *web* raíz y contiene todos los archivos de acceso público; - -.. _the-web-directory: - -El directorio *web* -~~~~~~~~~~~~~~~~~~~ - -El directorio raíz del servidor *web*, es el hogar de todos los archivos públicos y estáticos tales como imágenes, hojas de estilo y archivos *JavaScript*. También es el lugar donde vive cada :term:`controlador frontal`:: - - // web/app.php - require_once __DIR__.'/../app/bootstrap.php.cache'; - require_once __DIR__.'/../app/AppKernel.php'; - - use Symfony\Component\HttpFoundation\Request; - - $kernel = new AppKernel('prod', false); - $kernel->loadClassCache(); - $kernel->handle(Request::createFromGlobals())->send(); - -El archivo del controlador frontal (:file:`app.php` en este ejemplo) es el archivo *PHP* que realmente se ejecuta cuando utilizas una aplicación *Symfony2* y su trabajo consiste en utilizar una clase del núcleo, ``AppKernel``, para arrancar la aplicación. - -.. tip:: - - Tener un controlador frontal significa que se utilizan diferentes y más flexibles *URL* que en una aplicación *PHP* típica. Cuando usamos un controlador frontal, las *URL* se formatean de la siguiente manera: - - .. code-block:: text - - http://localhost/app.php/hello/Ryan - - El controlador frontal, :file:`app.php`, se ejecuta y la *URL* «interna»: ``/hello/Ryan`` es encaminada internamente con la configuración de enrutado. - Al utilizar las reglas ``mod_rewrite`` de *Apache*, puedes forzar la ejecución del archivo :file:`app.php` sin necesidad de especificarlo en la *URL*: - - .. code-block:: text - - http://localhost/hello/Ryan - -Aunque los controladores frontales son esenciales en el manejo de cada petición, rara vez los tendrás que modificar o incluso pensar en ellos. Los vamos a mencionar brevemente de nuevo en la sección de `Entornos`_. - -El directorio de la aplicación (``app``) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Como vimos en el controlador frontal, la clase ``AppKernel`` es el punto de entrada principal de la aplicación y es la responsable de toda la configuración. Como tal, se almacena en el directorio ``app/``. - -Esta clase debe implementar dos métodos que definen todo lo que *Symfony* necesita saber acerca de tu aplicación. Ni siquiera tienes que preocuparte de estos métodos durante el arranque ---*Symfony* los llena por ti con parámetros predeterminados. - -* ``registerBundles()``: Devuelve un arreglo con todos los paquetes necesarios para ejecutar la aplicación (consulta :ref:`page-creation-bundles`); - -* ``registerContainerConfiguration()``: Carga el archivo de configuración de recursos principal de la aplicación (consulta la sección `Configurando la aplicación`_); - -En el desarrollo del día a día, generalmente vas a utilizar el directorio ``app/`` para modificar la configuración y los archivos de enrutado en el directorio ``app/config/`` (consulta la sección `Configurando la aplicación`_). Este también contiene el directorio caché de la aplicación (``app/cache``), un directorio de registro (``app/logs``) y un directorio para archivos de recursos a nivel de la aplicación, tal como plantillas (``app/Resources``). -Aprenderás más sobre cada uno de estos directorios en capítulos posteriores. - -.. _autoloading-introduction-sidebar: - -.. sidebar:: Carga automática - - Al arrancar *Symfony*, un archivo especial ---:file:`app/autoload.php`--- es| incluido. Este archivo es creado por ``Composer`` y cargará automáticamente todos los archivos que vivan en el directorio :file:`src/` de tu aplicación así como todas las bibliotecas de terceros mencionadas en el archivo :file:`Composer.json`. - - Gracias al cargador automático, nunca tendrás que preocuparte de usar declaraciones ``include`` o ``require``. En cambio, ``Composer`` utiliza el espacio de nombres de una clase para determinar su ubicación e incluir automáticamente el archivo en el instante en que necesitas una clase. - - El cargador automático ya está configurado para buscar cualquiera de tus clases *PHP* en el directorio :file:`src/`. Para que trabaje la carga automática, el nombre de la clase y la ruta del archivo deben seguir el mismo patrón: - - .. code-block:: text - - Class Name: - Acme\HelloBundle\Controller\HelloController - Path: - src/Acme/HelloBundle/Controller/HelloController.php - -El directorio fuente (``src``) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En pocas palabras, el directorio :file:`src/` contiene todo el código real (código *PHP*, plantillas, archivos de configuración, estilo, etc.) que impulsa a *tu* aplicación. -De hecho, cuando desarrollas, la gran mayoría de tu trabajo se llevará a cabo dentro de uno o más paquetes creados en este directorio. - -Pero, ¿qué es exactamente un :term:`paquete`? - -.. _page-creation-bundles: - -El sistema de paquetes ----------------------- - -Un paquete es similar a un complemento en otro software, pero aún mejor. La diferencia clave es que en *Symfony2* **todo** es un paquete, incluyendo tanto la funcionalidad básica de la plataforma como el código escrito para tu aplicación. -Los paquetes son ciudadanos de primera clase en *Symfony2*. Esto te proporciona la flexibilidad para utilizar las características preconstruidas envasadas en `paquetes de terceros`_ o para distribuir tus propios paquetes. Además, facilita la selección y elección de las características por habilitar en tu aplicación y optimizarlas en la forma que desees. - -.. note:: - - Si bien, aquí vamos a cubrir lo básico, hay un capítulo dedicado completamente al tema de los :doc:`paquetes `. - -Un paquete simplemente es un conjunto estructurado de archivos en un directorio que implementa una sola característica. Puedes crear un ``BlogBundle``, un ``ForoBundle`` o un paquete para gestionar usuarios (muchos de ellos ya existen como paquetes de código abierto). Cada directorio contiene todo lo relacionado con esa característica, incluyendo archivos *PHP*, plantillas, hojas de estilo, archivos *Javascript*, pruebas y cualquier otra cosa necesaria. -Cada aspecto de una característica existe en un paquete y cada característica vive en un paquete. - -Una aplicación se compone de paquetes tal como está definido en el método ``registerBundles()`` de la clase ``AppKernel``:: - - // app/AppKernel.php - public function registerBundles() - { - $bundles = array( - new Symfony\Bundle\FrameworkBundle\FrameworkBundle(), - new Symfony\Bundle\SecurityBundle\SecurityBundle(), - new Symfony\Bundle\TwigBundle\TwigBundle(), - new Symfony\Bundle\MonologBundle\MonologBundle(), - new Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle(), - new Symfony\Bundle\DoctrineBundle\DoctrineBundle(), - new Symfony\Bundle\AsseticBundle\AsseticBundle(), - new Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle(), - new JMS\SecurityExtraBundle\JMSSecurityExtraBundle(), - ); - - if (in_array($this->getEnvironment(), array('dev', 'test'))) { - $bundles[] = new Acme\DemoBundle\AcmeDemoBundle(); - $bundles[] = new Symfony\Bundle\WebProfilerBundle\WebProfilerBundle(); - $bundles[] = new Sensio\Bundle\DistributionBundle\SensioDistributionBundle(); - $bundles[] = new Sensio\Bundle\GeneratorBundle\SensioGeneratorBundle(); - } - - return $bundles; - } - -Con el método ``registerBundles()``, tienes el control total sobre cuales paquetes utiliza tu aplicación (incluyendo los paquetes del núcleo de *Symfony*). - -.. tip:: - - Un paquete puede vivir en *cualquier lugar* siempre y cuando *Symfony2* lo pueda cargar automáticamente (vía el autocargador configurado en ``app/autoload.php``). - - -Creando un paquete -~~~~~~~~~~~~~~~~~~ - -La *edición estándar de Symfony* viene con una práctica tarea que crea un paquete totalmente operativo para ti. Por supuesto, la creación manual de un paquete también es muy fácil. - -Para mostrarte lo sencillo que es el sistema de paquetes, vamos a crear y activar un nuevo paquete llamado ``AcmeTestBundle``. - -.. tip:: - - La parte ``Acme`` es sólo un nombre ficticio que debes sustituir por un «proveedor» que represente tu nombre u organización (por ejemplo, ``ABCTestBundle`` por alguna empresa llamada ``ABC``). - -En primer lugar, crea un directorio :file:`src/Acme/TestBundle/` y añade un nuevo archivo llamado :file:`AcmeTestBundle.php`:: - - // src/Acme/TestBundle/AcmeTestBundle.php - namespace Acme\TestBundle; - - use Symfony\Component\HttpKernel\Bundle\Bundle; - - class AcmeTestBundle extends Bundle - { - } - -.. tip:: - - El nombre ``AcmeTestBundle`` sigue las :ref:`convenciones de nomenclatura de paquetes ` estándar. - También puedes optar por acortar el nombre del paquete simplemente a ``TestBundle`` al nombrar esta clase ``TestBundle`` (y el nombre del archivo :file:`TestBundle.php`). - -Esta clase vacía es la única pieza que necesitamos para crear nuestro nuevo paquete. Aunque comúnmente está vacía, esta clase es poderosa y se puede utilizar para personalizar el comportamiento del paquete. - -Ahora que creaste tu paquete, tienes que activarlo a través de la clase ``AppKernel``:: - - // app/AppKernel.php - public function registerBundles() - { - $bundles = array( - ..., - // registra tus paquetes - new Acme\TestBundle\AcmeTestBundle(), - ); - // ... - - return $bundles; - } - -Y si bien ``AcmeTestBundle`` aún no hace nada, está listo para utilizarlo. - -Y aunque esto es bastante fácil, *Symfony* también proporciona una interfaz de línea de ordenes para generar una estructura de paquete básica: - -.. code-block:: bash - - $ php app/console generate:bundle --namespace=Acme/TestBundle - -Esto genera el esqueleto del paquete con un controlador básico, la plantilla y recursos de enrutado que se pueden personalizar. Aprenderás más sobre la línea de ordenes de las herramientas de *Symfony2* más tarde. - -.. tip:: - - Cuando quieras crear un nuevo paquete o uses un paquete de terceros, siempre asegúrate de habilitar el paquete en ``registerBundles()``. Cuando usas la orden ``generate:bundle``, hace esto para ti. - -Estructura de directorios de un paquete -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La estructura de directorios de un paquete es simple y flexible. De forma predeterminada, el sistema de paquetes sigue una serie de convenciones que ayudan a mantener el código consistente entre todos los paquetes *Symfony2*. Echa un vistazo a ``AcmeHelloBundle``, ya que contiene algunos de los elementos más comunes de un paquete: - -* :file:`Controller/` Contiene los controladores del paquete (por ejemplo, :file:`HelloController.php`); - -* ``DependencyInjection/`` mantiene ciertas extensiones para las clases de inyección de dependencias, qué configuración puede importar el servicio, registra uno o más pases del compilador (este directorio no es necesario); - -* :file:`Resources/config/` Contiene la configuración, incluyendo la configuración de enrutado (por ejemplo, :file:`routing.yml`); - -* ``Resources/views/`` Contiene las plantillas organizadas por nombre de controlador (por ejemplo, ``Hello/index.html.twig``); - -* ``Resources/public/`` Contiene recursos *web* (imágenes, hojas de estilo, etc.) y es copiado o enlazado simbólicamente al directorio ``web/`` del proyecto vía la orden de consola ``assets:install``; - -* ``Tests/`` Tiene todas las pruebas para el paquete. - -Un paquete puede ser tan pequeño o tan grande como la característica que implementa. Este contiene sólo los archivos que necesita y nada más. - -A medida que avances en el libro, aprenderás cómo persistir objetos a una base de datos, crear y validar formularios, crear traducciones para tu aplicación, escribir pruebas y mucho más. Cada uno de estos tiene su propio lugar y rol dentro del paquete. - -Configurando la aplicación --------------------------- - -La aplicación consiste de una colección de paquetes que representan todas las características y capacidades de tu aplicación. Cada paquete se puede personalizar a través de archivos de configuración escritos en *YAML*, *XML* o *PHP*. De forma predeterminada, el archivo de configuración principal vive en el directorio :file:`app/config/` y se llama :file:`config.yml`, :file:`config.xml` o :file:`config.php` en función del formato que prefieras: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - imports: - - { resource: parameters.yml } - - { resource: security.yml } - - framework: - secret: "%secret%" - router: { resource: "%kernel.root_dir%/config/routing.yml" } - # ... - - # Twig Configuration - twig: - debug: "%kernel.debug%" - strict_variables: "%kernel.debug%" - - # ... - - .. code-block:: xml - - - - - - - - - - - - - - - - - - .. code-block:: php - - $this->import('parameters.yml'); - $this->import('security.yml'); - - $container->loadFromExtension('framework', array( - 'secret' => '%secret%', - 'router' => array('resource' => '%kernel.root_dir%/config/routing.php'), - // ... - ), - )); - - // Configuración Twig - $container->loadFromExtension('twig', array( - 'debug' => '%kernel.debug%', - 'strict_variables' => '%kernel.debug%', - )); - - // ... - -.. note:: - - Aprenderás exactamente cómo cargar cada archivo/formato en la siguiente sección, `Entornos`_. - -Cada entrada de nivel superior como ``framework`` o ``twig`` define la configuración de un paquete específico. Por ejemplo, la clave ``framework`` define la configuración para el núcleo de *Symfony* ``FrameworkBundle`` e incluye la configuración de enrutado, plantillas, y otros sistemas del núcleo. - -Por ahora, no te preocupes por las opciones de configuración específicas de cada sección. -El archivo de configuración viene con parámetros predeterminados. A medida que leas y explores más cada parte de *Symfony2*, aprenderás sobre las opciones de configuración específicas de cada característica. - -.. sidebar:: Formatos de configuración - - A lo largo de los capítulos, todos los ejemplos de configuración muestran los tres formatos (*YAML*, *XML* y *PHP*). Cada uno tiene sus propias ventajas y desventajas. Tú eliges cual utilizar: - - * *YAML*: Sencillo, limpio y legible (aprende más sobre *yaml* en «:doc:`/components/yaml/yaml_format`»); - - * *XML*: Más poderoso que *YAML* a veces y es compatible con el autocompletado del *IDE*; - - * *PHP*: Muy potente, pero menos fácil de leer que los formatos de configuración estándar. - -Volcando la configuración predefinida -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - La orden ``config:dump-reference`` se añadió en *Symfony 2.1* - -Puedes volcar a la consola la configuración predefinida en *YAML* de un paquete usando la orden ``config:dump-reference``. He aquí un ejemplo del volcado de la configuración predefinida del ``FrameworkBundle``: - -.. code-block:: text - - app/console config:dump-reference FrameworkBundle - -También puedes usar el alias de la extensión (la ``clave`` en el archivo de configuración): - -.. code-block:: text - - app/console config:dump-reference framework - -.. note:: - - Revisa el artículo del recetario: :doc:`Cómo exponer la configuración semántica de un paquete ` para información sobre cómo añadir configuración a tus propios paquetes. - -.. index:: - single: Entornos; Introducción - -.. _environments-summary: - -Entornos --------- - -Una aplicación puede funcionar en diversos entornos. Los diferentes entornos comparten el mismo código *PHP* (aparte del controlador frontal), pero usan diferente configuración. Por ejemplo, un entorno de desarrollo ``dev`` registrará las advertencias y errores, mientras que un entorno de producción ``prod`` sólo registra los errores. Algunos archivos se vuelven a generar en cada petición en el entorno ``dev`` (para mayor comodidad de los desarrolladores), pero se memorizan en caché en el entorno ``prod``. Todos los entornos viven juntos en la misma máquina y ejecutan la misma aplicación. - -Un proyecto *Symfony2* generalmente comienza con tres entornos (``dev``, ``test`` y ``prod``), aunque la creación de nuevos entornos es fácil. Puedes ver tu aplicación en diferentes entornos con sólo cambiar el controlador frontal en tu navegador. Para ver la aplicación en el entorno ``dev``, accede a la aplicación a través del controlador frontal de desarrollo: - -.. code-block:: text - - http://localhost/app_dev.php/hello/Ryan - -Si deseas ver cómo se comportará tu aplicación en el entorno de producción, en su lugar, llama al controlador frontal ``prod``: - -.. code-block:: text - - http://localhost/app.php/hello/Ryan - -Puesto que el entorno ``prod`` está optimizado para velocidad; la configuración, el enrutado y las plantillas *Twig* se compilan en clases *PHP* simples y se guardan en caché. -Cuando veas los cambios en el entorno ``prod``, tendrás que borrar estos archivos memorizados en caché y así permitir su reconstrucción: - -.. code-block:: bash - - $ php app/console cache:clear --env=prod --no-debug - -.. note:: - - Si abres el archivo ``web/app.php``, encontrarás que está configurado explícitamente para usar el entorno ``prod``:: - - $kernel = new AppKernel('prod', false); - - Puedes crear un nuevo controlador frontal para un nuevo entorno copiando el archivo y cambiando ``prod`` por algún otro valor. - -.. note:: - - El entorno ``test`` se utiliza cuando se ejecutan pruebas automáticas y no se puede acceder directamente a través del navegador. Consulta el capítulo :doc:`Probando ` para más detalles. - -.. index:: - single: Entornos; Configuración - -Configurando entornos -~~~~~~~~~~~~~~~~~~~~~ - -La clase ``AppKernel`` es responsable de cargar realmente el archivo de configuración de tu elección:: - - // app/AppKernel.php - public function registerContainerConfiguration(LoaderInterface $loader) - { - $loader->load( - __DIR__.'/config/config_'.$this->getEnvironment().'.yml' - ); - } - -Ya sabes que la extensión :file:`.yml` se puede cambiar a :file:`.xml` o :file:`.php` si prefieres usar *XML* o *PHP* para escribir tu configuración. -Además, observa que cada entorno carga su propio archivo de configuración. Considera el archivo de configuración para el entorno ``dev``. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_dev.yml - imports: - - { resource: config.yml } - - framework: - router: { resource: "%kernel.root_dir%/config/routing_dev.yml" } - profiler: { only_exceptions: false } - - # ... - - .. code-block:: xml - - - - - - - - - - - - - - .. code-block:: php - - // app/config/config_dev.php - $loader->import('config.php'); - - $container->loadFromExtension('framework', array( - 'router' => array('resource' => '%kernel.root_dir%/config/routing_dev.php'), - 'profiler' => array('only-exceptions' => false), - )); - - // ... - -La clave ``imports`` es similar a una declaración ``include`` *PHP* y garantiza que en primer lugar se carga el archivo de configuración principal (:file:`config.yml`). El resto del archivo de configuración predeterminado aumenta el registro en la bitácora de eventos y otros ajustes conducentes a un entorno de desarrollo. - -Ambos entornos ``prod`` y ``test`` siguen el mismo modelo: cada uno importa el archivo de configuración básico y luego modifica sus valores de configuración para adaptarlos a las necesidades específicas del entorno. Esto es sólo una convención, pero te permite reutilizar la mayor parte de tu configuración y personalizar sólo piezas puntuales entre entornos. - -Resumen -------- - -¡Enhorabuena! Ahora has visto todos los aspectos fundamentales de *Symfony2* y afortunadamente descubriste lo fácil y flexible que puede ser. Y si bien aún *hay muchas* características por venir, asegúrate de tener en cuenta los siguientes puntos básicos: - -* La creación de una página es un proceso de tres pasos que involucran una **ruta**, un **controlador** y (opcionalmente) una **plantilla**; - -* Cada proyecto sólo contiene unos cuantos directorios principales: :file:`web/` (recursos web y controladores frontales), :file:`app/` (configuración), :file:`src/` (tus paquetes), y :file:`vendor/` (código de terceros) (también hay un directorio :file:`bin/` que se utiliza para ayudarte a actualizar las bibliotecas de proveedores); - -* Cada característica en *Symfony2* (incluyendo el núcleo de la plataforma *Symfony2*) está organizada en un *paquete*, el cual es un conjunto estructurado de archivos para esa característica; - -* La **configuración** de cada paquete vive en el directorio ``Resources/config`` del paquete y se puede especificar en *YAML*, *XML* o *PHP*; - -* La **configuración global de la aplicación** vive en el directorio ``app/config/``; - -* Cada **entorno** es accesible a través de un diferente controlador frontal (por ejemplo, :file:`app.php` y :file:`app_dev.php`) el cual carga un archivo de configuración diferente. - -A partir de aquí, cada capítulo te dará a conocer más y más potentes herramientas y conceptos avanzados. Cuanto más sepas sobre *Symfony2*, tanto más apreciarás la flexibilidad de su arquitectura y el poder que te proporciona para desarrollar aplicaciones rápidamente. - -.. _`Twig`: http://gitnacho.github.com/symfony-docs-es/twig/index.html -.. _`paquetes de terceros`: http://knpbundles.com -.. _`edición estándar de Symfony`: http://symfony.com/download -.. _`Apache sobre DirectoryIndex`: http://httpd.apache.org/docs/2.0/mod/mod_dir.html -.. _`ubicación HttpCoreModule de Nginx`: http://wiki.nginx.org/HttpCoreModule#location diff --git a/_sources/book/performance.txt b/_sources/book/performance.txt deleted file mode 100644 index 4d0a8cd..0000000 --- a/_sources/book/performance.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. index:: - single: Pruebas - -Rendimiento -=========== - -*Symfony2* es rápido, desde que lo sacas de la caja. Por supuesto, si realmente necesitas velocidad, hay muchas maneras en las cuales puedes hacer que *Symfony* sea aún más rápido. En este capítulo, podrás explorar muchas de las formas más comunes y potentes para hacer que tu aplicación *Symfony* sea aún más rápida. - -.. index:: - single: Rendimiento; Caché de código de bytes - -Utilizando una caché de código de bytes (p. ej. *APC*) ------------------------------------------------------- - -Una de las mejores (y más fáciles) cosas que debes hacer para mejorar el rendimiento es utilizar una «caché de código de bytes». La idea de una caché de código de bytes es eliminar la necesidad de constantemente tener que volver a compilar el código fuente *PHP*. Hay disponible una serie de `cachés de código de bytes`_, algunas de las cuales son de código abierto. Probablemente, la caché de código de bytes más utilizada sea `APC`_ - -Usar una caché de código de bytes realmente no tiene ningún inconveniente, y *Symfony2* se ha diseñado para desempeñarse muy bien en este tipo de entorno. - -Optimización adicional -~~~~~~~~~~~~~~~~~~~~~~ - -La caché de código de bytes, por lo general, comprueba los cambios de los archivos fuente. Esto garantiza que si cambias un archivo fuente, el código de bytes se vuelve a compilar automáticamente. -Esto es muy conveniente, pero, obviamente, implica una sobrecarga. - -Por esta razón, algunas cachés de código de bytes ofrecen una opción para desactivar esa comprobación. -Obviamente, cuando desactivas esta comprobación, será responsabilidad del administrador del servidor asegurarse de que la caché se borra cada vez que cambia un archivo fuente. De lo contrario, no se verán los cambios realizados. - -Por ejemplo, para desactivar estos controles en *APC*, sólo tienes que añadir la opción ``apc.stat=0`` en tu archivo de configuración :file:`php.ini`. - -.. index:: - single: Rendimiento; Autocargador - -Usa la funcionalidad de asociación de clases de ``Composer`` ------------------------------------------------------------- - -De manera predeterminada, la *edición estándar de Symfony2* utiliza el autocargador en el archivo `autoload.php`_. Este autocargador es fácil de usar, ya que automáticamente encontrará cualquier nueva clase que hayas colocado en los directorios registrados. - -Desafortunadamente, esto tiene un costo, puesto que el cargador itera en todos los espacios de nombres configurados para encontrar un archivo, haciendo llamadas a ``file_exists`` hasta que finalmente encuentra el archivo que estás buscando. - -La solución más sencilla es decirle a ``Composer`` que construya un «mapa de clases» (es decir, un gran arreglo con la ubicación de todas las clases). Esto se puede hacer desde la línea de ordenes, y se podría convertir en parte de tu proceso de despliegue: - -.. code-block:: bash - - php composer.phar dump-autoload --optimize - -Internamente, esto construye el gran arreglo con el mapa de clases en ``vendor/composer/autoload_namespaces.php``. - -Memorizando en caché el autocargador con *APC* ----------------------------------------------- - -Otra solución es memorizar en caché la ubicación de cada clase después de localizarla -por primera vez. *Symfony* viene con una clase ---:class:`Symfony\\Component\\ClassLoader\\ApcClassLoader`--- que hace eso exactamente. Para usarla, sólo adapta tu archivo del controlador frontal. -Si estás utilizando la distribución estándar, este código ya debe estar disponible como comentarios en este archivo:: - - // app.php - // ... - - $loader = require_once __DIR__.'/../app/bootstrap.php.cache'; - - // Usa APC para mejorar el rendimiento de la carga automática - // Cambia 'sf2' por el prefijo que desees a fin de evitar - // conflictos de clave con otra aplicación. - /* - $loader = new ApcClassLoader('sf2', $loader); - $loader->register(true); - */ - - // ... - -.. note:: - - Al utilizar el cargador automático *APC*, si agregas nuevas clases, las encontrará automáticamente y todo funcionará igual que antes (es decir, no hay razón para «limpiar» la caché). Sin embargo, si cambias la ubicación de un determinado espacio de nombres o prefijo, tendrás que limpiar tu caché *APC*. De lo contrario, el cargador aún buscará en la ubicación anterior todas las clases dentro de ese espacio de nombres. - -.. index:: - single: Rendimiento; Archivos de arranque - -Utilizando archivos de arranque -------------------------------- - -Para garantizar una óptima flexibilidad y reutilización de código, las aplicaciones de *Symfony2* aprovechan una variedad de clases y componentes de terceros. Pero cargar todas estas clases desde archivos separados en cada petición puede dar lugar a alguna sobrecarga. Para reducir esta sobrecarga, la *edición estándar de Symfony2* proporciona un guión para generar lo que se conoce como `archivo de arranque`_, el cual contiene la definición de múltiples clases en un solo archivo. Al incluir este archivo (el cual contiene una copia de muchas de las clases del núcleo), *Symfony* ya no tiene que incluir algunos de los archivos de código fuente que contienen las clases. Esto reducirá bastante la E/S del disco. - -Si estás utilizando la *edición estándar de Symfony2*, entonces probablemente ya estás utilizando el archivo de arranque. Para estar seguro, abre el controlador frontal (por lo general :file:`app.php`) y asegúrate de que existe la siguiente línea:: - - require_once __DIR__.'/../app/bootstrap.php.cache'; - -Ten en cuenta que hay dos desventajas cuando utilizas un archivo de arranque: - -* El archivo se tiene que regenerar cada vez que cambia alguna de las fuentes original (es decir, cuando actualizas el código fuente de *Symfony2* o las bibliotecas de proveedores); - -* En la depuración, será necesario colocar puntos de interrupción dentro del archivo de arranque. - -Si estás utilizando la *edición estándar de Symfony2*, los archivos de arranque se reconstruyen automáticamente después de actualizar las bibliotecas de proveedores a través de la orden ``php composer.phar install``. - -Archivos de arranque y caché de código de bytes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Incluso cuando utilizas código de bytes en caché, el rendimiento mejorará cuando utilices un archivo de arranque ya que habrá menos archivos en los cuales supervisar cambios. Por supuesto, si esta función está desactivada en la caché del código de bytes (por ejemplo, ``apc.stat = 0`` en *APC*), no existe una razón para utilizar un archivo de arranque. - -.. _`cachés de código de bytes`: http://en.wikipedia.org/wiki/List_of_PHP_accelerators -.. _`APC`: http://www.php.net/manual/es/book.apc.php -.. _`autoload.php`: https://github.com/symfony/symfony-standard/blob/master/app/autoload.php -.. _`archivo de arranque`: https://github.com/sensio/SensioDistributionBundle/blob/master/Composer/ScriptHandler.php diff --git a/_sources/book/propel.txt b/_sources/book/propel.txt deleted file mode 100644 index 9378732..0000000 --- a/_sources/book/propel.txt +++ /dev/null @@ -1,408 +0,0 @@ -.. index:: - single: Propel - -Bases de datos y *Propel* -========================= - -Seamos realistas, una de las tareas más comunes y desafiantes para cualquier aplicación involucra la persistencia y lectura de información hacia y desde una base de datos. *Symfony2* no viene integrado con ningún *ORM*, pero integrar *Propel* es relativamente fácil. -Para instalar *Propel*, lee `Trabajando Con Symfony2`_ en la documentación de *Propel*. - -Un sencillo ejemplo: Un producto --------------------------------- - -En esta sección, configurarás tu base de datos, crearás un objeto ``Producto``, lo persistirás en la base de datos y lo recuperarás de nuevo. - -.. sidebar:: El código del ejemplo - - Si quieres seguir el ejemplo de este capítulo, crea el paquete ``AcmeStoreBundle`` ejecutando la orden: - - .. code-block:: bash - - $ php app/console generate:bundle --namespace=Acme/StoreBundle - -Configurando la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de poder comenzar realmente, tendrás que establecer tu información para la conexión a la base de datos. Por convención, esta información se suele configurar en el archivo -:file:`app/config/parameters.yml`: - -.. code-block:: yaml - - # app/config/parameters.yml - parameters: - database_driver: mysql - database_host: localhost - database_name: proyecto_de_prueba - database_user: nombre_de_usuario - database_password: password - database_charset: UTF8 - -.. note:: - - Definir la configuración a través de :file:`parameters.yml` sólo es una convención. Los parámetros definidos en este archivo son referidos en el archivo de configuración principal al ajustar *Propel*: - -Estos parámetros definidos en ``parameters.yml`` ahora se pueden incluir en el archivo de configuración (:file:`config.yml`): - -.. code-block:: yaml - - propel: - dbal: - driver: "%database_driver%" - user: "%database_user%" - password: "%database_password%" - dsn: "%database_driver%:host=%database_host%;dbname=%database_name%;charset=%database_charset%" - -Ahora que *Propel* está consciente de tu base de datos, posiblemente tenga que crear la base de datos para ti: - -.. code-block:: bash - - $ php app/console propel:database:create - -.. note:: - - En este ejemplo, tienes configurada una conexión, denominada ``default``. Si quieres configurar más de una conexión, consulta la `sección de configuración del PropelBundle`_. - -Creando una clase ``Modelo`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En el mundo de *Propel*, las clases ``ActiveRecord`` son conocidas como **modelos** debido a que las clases generadas por *Propel* contienen alguna lógica del negocio. - -.. note:: - - Para la gente que usa *Symfony2* with *Doctrine2*, los **modelos** son equivalentes a **entidades**. - -Supongamos que estás construyendo una aplicación donde necesitas mostrar tus productos. -Primero, crea un archivo :file:`schema.xml` en el directorio ``Resources/config`` de tu paquete ``AcmeStoreBundle``: - -.. code-block:: xml - - - - - - - - -
- - -Construyendo el modelo -~~~~~~~~~~~~~~~~~~~~~~ - -Después de crear tu archivo ``schema.xml``, genera tu modelo ejecutando: - -.. code-block:: bash - - $ php app/console propel:model:build - -Esto genera todas las clases del modelo en el directorio ``Model/`` del paquete ``AcmeStoreBundle`` para que desarrolles rápidamente tu aplicación. - -Creando tablas/esquema de la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora tienes una clase ``Producto`` utilizable con todo lo que necesitas para persistirla. Por supuesto, en tu base de datos aún no tienes la tabla ``producto`` correspondiente. Afortunadamente, *Propel* puede crear automáticamente todas las tablas de la base de datos necesarias para cada modelo conocido en tu aplicación. Para ello, ejecuta: - -.. code-block:: bash - - $ php app/console propel:sql:build - $ php app/console propel:sql:insert --force - -Tu base de datos ahora cuenta con una tabla ``producto`` completamente operativa, con columnas que coinciden con el esquema que has especificado. - -.. tip:: - - Puedes combinar las tres últimas ordenes ejecutando la siguiente orden: ``php app/console propel:build --insert-sql``. - -Persistiendo objetos a la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora que tienes un objeto ``Producto`` y la tabla ``producto`` correspondiente, estás listo para persistir la información a la base de datos. Desde el interior de un controlador, esto es bastante fácil. Agrega el siguiente método al ``DefaultController`` del paquete:: - - // src/Acme/StoreBundle/Controller/DefaultController.php - - // ... - use Acme\StoreBundle\Model\Product; - use Symfony\Component\HttpFoundation\Response; - - public function createAction() - { - $product = new Product(); - $product->setName('A Foo Bar'); - $product->setPrice(19.99); - $product->setDescription('Lorem ipsum dolor'); - - $product->save(); - - return new Response('Created product id '.$product->getId()); - } - -En esta pieza de código, creas y trabajas con una instancia del objeto ``$product``. -Al invocar al método ``save()``, la persistes a la base de datos. No tienes que usar otros servicios, el objeto sabe cómo persistirse a sí mismo. - -.. note:: - - Si estás siguiendo este ejemplo, necesitas crear una :doc:`ruta ` que apunte a este método para verlo en acción. - -Recuperando objetos desde la base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Recuperar un objeto desde la base de datos es aún más fácil. Por ejemplo, supongamos que has configurado una ruta para mostrar un ``Producto`` específico en función del valor de su ``id``:: - - // ... - use Acme\StoreBundle\Model\ProductQuery; - - public function showAction($id) - { - $product = ProductQuery::create() - ->findPk($id); - - if (!$product) { - throw $this->createNotFoundException( - 'No product found for id '.$id - ); - } - - // ... haz algo, como pasar el objeto $product a una plantilla - } - -Actualizando un objeto -~~~~~~~~~~~~~~~~~~~~~~ - -Una vez que hayas recuperado un objeto de *Propel*, actualizarlo es relativamente fácil. Supongamos que tienes una ruta que asigna un identificador de producto a una acción de actualización en un controlador:: - - // ... - use Acme\StoreBundle\Model\ProductQuery; - - public function updateAction($id) - { - $product = ProductQuery::create() - ->findPk($id); - - if (!$product) { - throw $this->createNotFoundException( - 'No product found for id '.$id - ); - } - - $product->setName('New product name!'); - $product->save(); - - return $this->redirect($this->generateUrl('homepage')); - } - -La actualización de un objeto únicamente consta de tres pasos: - -#. recuperar el objeto desde Propel (línea 6 - 13); -#. modificar el objeto (línea 15); -#. guardarlo (línea 16). - -Eliminando un objeto -~~~~~~~~~~~~~~~~~~~~ - -Eliminar un objeto es muy similar, pero requiere una llamada al método ``delete()`` del objeto:: - - $product->delete(); - -Consultando por objetos ------------------------ - -*Propel* provee clases ``Query`` generadas para ejecutar ambas consultas, básicas y complejas sin mayor esfuerzo:: - - \Acme\StoreBundle\Model\ProductQuery::create()->findPk($id); - - \Acme\StoreBundle\Model\ProductQuery::create() - ->filterByName('Foo') - ->findOne(); - -Imagina que deseas consultar los productos, pero sólo quieres devolver aquellos que cuestan más de ``19.99``, ordenados del más barato al más caro. Desde el interior de un controlador, haz lo siguiente:: - - $products = \Acme\StoreBundle\Model\ProductQuery::create() - ->filterByPrice(array('min' => 19.99)) - ->orderByPrice() - ->find(); - -En una línea, recuperas tus productos en una potente manera orientada a objetos. No necesitas gastar tu tiempo con *SQL* o ninguna otra cosa, *Symfony2* ofrece programación completamente orientada a objetos y *Propel* respeta la misma filosofía proveyendo una impresionante capa de abstracción. - -Si quieres reutilizar algunas consultas, puedes añadir tus propios métodos a la clase ``ProductQuery``:: - - // src/Acme/StoreBundle/Model/ProductQuery.php - class ProductQuery extends BaseProductQuery - { - public function filterByExpensivePrice() - { - return $this - ->filterByPrice(array('min' => 1000)); - } - } - -Pero, ten en cuenta que *Propel* genera una serie de métodos por ti y puedes escribir un sencillo ``findAllOrderedByName()`` sin ningún esfuerzo:: - - \Acme\StoreBundle\Model\ProductQuery::create() - ->orderByName() - ->find(); - -Relaciones/Asociaciones ------------------------ - -Supón que los productos en tu aplicación pertenecen exactamente a una «categoría». En este caso, necesitarás un objeto ``Categoría`` y una manera de relacionar un objeto ``Producto`` a un objeto ``Categoría``. - -Comienza agregando la definición de ``categoría`` en tu archivo :file:`schema.xml`: - -.. code-block:: xml - - - - - - - - - - - - -
- - - - -
- - -Crea las clases: - -.. code-block:: bash - - $ php app/console propel:model:build - -Asumiendo que tienes productos en tu base de datos, no los querrás perder. Gracias a las migraciones, *Propel* es capaz de actualizar tu base de datos sin perder la información existente. - -.. code-block:: bash - - $ php app/console propel:migration:generate-diff - $ php app/console propel:migration:migrate - -Tu base de datos se ha actualizado, puedes continuar escribiendo tu aplicación. - -Guardando objetos relacionados -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora, veamos el código en acción. Imagina que estás dentro de un controlador:: - - // ... - use Acme\StoreBundle\Model\Category; - use Acme\StoreBundle\Model\Product; - use Symfony\Component\HttpFoundation\Response; - - class DefaultController extends Controller - { - public function createProductAction() - { - $category = new Category(); - $category->setName('Main Products'); - - $product = new Product(); - $product->setName('Foo'); - $product->setPrice(19.99); - // relaciona este producto a la categoría - $product->setCategory($category); - - // guarda todo - $product->save(); - - return new Response( - 'Created product id: '.$product->getId().' and category id: '.$category->getId() - ); - } - } - -Ahora, se agrega una sola fila en ambas tablas ``categoría`` y ``producto``. La columna ``product.category_id`` para el nuevo producto se ajusta al ``id`` de la nueva categoría. *Propel* maneja la persistencia de las relaciones por ti. - -Recuperando objetos relacionados -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando necesites recuperar objetos asociados, tu flujo de trabajo se ve justo como lo hacías antes. En primer lugar, buscas un objeto ``$product`` y luego accedes a su ``Categoría`` asociada:: - - // ... - use Acme\StoreBundle\Model\ProductQuery; - - public function showAction($id) - { - $product = ProductQuery::create() - ->joinWithCategory() - ->findPk($id); - - $categoryName = $product->getCategory()->getName(); - - // ... - } - -Ten en cuenta que en el ejemplo anterior, únicamente hicimos una consulta. - -Más información sobre asociaciones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Encontrarás más información sobre las relaciones leyendo el capítulo dedicado a las -`relaciones`_. - -Ciclo de vida de las retrollamadas ----------------------------------- - -A veces, es necesario realizar una acción justo antes o después de insertar, actualizar o eliminar un objeto. Este tipo de acciones se conoce como «ciclo de vida» de las retrollamadas o :dfn:`hooks` (en adelante «ganchos»), ya que son métodos retrollamados que necesitas ejecutar durante las diferentes etapas del ciclo de vida de un objeto (por ejemplo, cuando insertas, actualizas, eliminas, etc., un objeto) - -Para añadir un gancho, solo tenemos que añadir un método a la clase del objeto:: - - // src/Acme/StoreBundle/Model/Product.php - - // ... - class Product extends BaseProduct - { - public function preInsert(\PropelPDO $con = null) - { - // hace algo antes de insertar el objeto - } - } - -*Propel* ofrece los siguientes ganchos: - -* ``preInsert()`` código ejecutado antes de insertar un nuevo objeto -* ``postInsert()`` código ejecutado después de insertar un nuevo objeto -* ``preUpdate()`` código ejecutado antes de actualizar un objeto existente -* ``postUpdate()`` código ejecutado después de actualizar un objeto existente -* ``preSave()`` código ejecutado antes de guardar un objeto (nuevo o existente) -* ``postSave()`` código ejecutado después de guardar un objeto (nuevo o existente) -* ``preDelete()`` código ejecutado antes de borrar un objeto -* ``postDelete()`` código ejecutado después de borrar un objeto - - -Comportamientos ---------------- - -Todo los comportamientos empacados en *Propel* trabajan con *Symfony2*. Para conseguir más información sobre cómo utiliza *Propel* los comportamientos, consulta la sección de `referencia de comportamientos`_. - -Ordenes -------- - -Debes leer la sección dedicada a las `Ordenes de Propel en Symfony2`_. - -.. _`Trabajando con Symfony2`: http://propelorm.org/cookbook/symfony2/working-with-symfony2.html#installation -.. _`sección de configuración del PropelBundle`: http://propelorm.org/cookbook/symfony2/working-with-symfony2.html#configuration -.. _`relaciones`: http://propelorm.org/documentation/04-relationships.html -.. _`referencia de comportamientos`: http://propelorm.org/documentation/#behaviors_reference -.. _`Ordenes de Propel en Symfony2`: http://propelorm.org/cookbook/symfony2/working-with-symfony2#the_commands diff --git a/_sources/book/routing.txt b/_sources/book/routing.txt deleted file mode 100644 index 1cb2cfe..0000000 --- a/_sources/book/routing.txt +++ /dev/null @@ -1,1089 +0,0 @@ -.. index:: - single: Routing - -Enrutando -========= - -Las *URL* bonitas absolutamente son una necesidad para cualquier aplicación web seria. Esto significa dejar atrás las *URL* feas como ``index.php?article_id=57`` en favor de algo así como ``/leer/intro-a-symfony``. - -Tener tal flexibilidad es más importante aún. ¿Qué pasa si necesitas cambiar la *URL* de una página de ``/blog`` a ``/noticias``? ¿Cuántos enlaces necesitas cazar y actualizar para hacer el cambio? Si estás utilizando el enrutador de *Symfony*, el cambio es sencillo. - -El enrutador de *Symfony2* te permite definir *URL* creativas que se asignan a diferentes áreas de la aplicación. Al final de este capítulo, serás capaz de: - -* Crear rutas complejas asignadas a controladores -* Generar *URL* que contienen plantillas y controladores -* Cargar recursos de enrutado desde paquetes (o de cualquier otro lugar) -* Depurar tus rutas - -.. index:: - single: Enrutando; Fundamentos - -Enrutador en acción -------------------- - -Una ``ruta`` es un mapa desde la trayectoria de una *URL* hasta un controlador. Por ejemplo, supongamos que deseas adaptar cualquier *URL* como ``/blog/mi-post`` o ``/blog/todo-sobre-symfony`` y enviarla a un controlador que puede buscar y reproducir esta entrada del *blog*. -La ruta es simple: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - blog_show: - path: /blog/{slug} - defaults: { _controller: AcmeBlogBundle:Blog:show } - - .. code-block:: xml - - - - - - - AcmeBlogBundle:Blog:show - - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('blog_show', new Route('/blog/{slug}', array( - '_controller' => 'AcmeBlogBundle:Blog:show', - ))); - - return $collection; - -.. versionadded:: 2.2 - La opción ``path`` es nueva en *Symfony* 2.2, en versiones anteriores se utilizaba ``pattern``. - -La ruta definida por ``blog_show`` actúa como ``/blog/*`` donde al comodín se le da el nombre de ``slug``. Para la *URL* ``/blog/my-blog-post``, la variable ``slug`` obtiene un valor de ``my-blog-post``, que está disponible para usarlo en el controlador (sigue leyendo). - -El parámetro ``_controller`` es una clave especial que le dice a *Symfony* qué controlador se debe ejecutar cuando una *URL* coincida con esta ruta. La cadena ``_controller`` se conoce como el :ref:`nombre lógico `. Esta sigue un patrón que apunta a una clase y método *PHP* específicos:: - - // src/Acme/BlogBundle/Controller/BlogController.php - namespace Acme\BlogBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - - class BlogController extends Controller - { - public function showAction($slug) - { - // usa la variable $slug para consultar la base de datos - $blog = ...; - - return $this->render('AcmeBlogBundle:Blog:show.html.twig', array( - 'blog' => $blog, - )); - } - } - -¡Enhorabuena! Acabas de crear tu primera ruta y la conectaste a un controlador. Ahora, cuando visites ``/blog/my-post``, el controlador ``showAction`` será ejecutado y la variable ``$slug`` será igual a ``my-post``. - -Este es el objetivo del enrutador de *Symfony2*: asignar la *URL* de una petición a un controlador. De paso, aprenderás todo tipo de trucos que incluso facilitan la asignación de *URL* complejas. - -.. index:: - single: Enrutando; Bajo el capó - -Enrutando: Bajo el capó ------------------------- - - -Cuando se hace una petición a tu aplicación, esta contiene una dirección al «recurso» exacto que solicitó el cliente. Esta dirección se conoce como *URL* (o *URI*), y podría ser ``/contact``, ``/blog/read-me``, o cualquier otra cosa. Tomemos la siguiente petición *HTTP*, por ejemplo: - -.. code-block:: text - - GET /blog/my-blog-post - -El objetivo del sistema de enrutado de *Symfony2* es analizar esta *URL* y determinar qué controlador se debe ejecutar. Todo el proceso es el siguiente: - -#. La petición es manejada por el controlador frontal de *Symfony2* (por ejemplo, :file:`app.php`); - -#. El núcleo de *Symfony2* (es decir, el Kernel) pregunta al enrutador que examine la petición; - -#. El enrutador busca la *URL* entrante para emparejarla con una ruta específica y devuelve información sobre la ruta, incluyendo el controlador que se debe ejecutar; - -#. El núcleo de *Symfony2* ejecuta el controlador, que en última instancia, devuelve un objeto ``Respuesta``. - -.. figure:: /images/request-flow_es.png - :align: center - :alt: Flujo de la petición en Symfony2 - - La capa del enrutador es una herramienta que traduce la *URL* entrante a un controlador específico a ejecutar. - -.. index:: - single: Enrutando; Creando rutas - -Creando rutas -------------- - -*Symfony* carga todas las rutas de tu aplicación desde un archivo de configuración de enrutado. El archivo usualmente es ``app/config/routing.yml``, pero lo puedes configurar para que sea cualquier otro (incluyendo un archivo *XML* o *PHP*) vía el archivo de configuración de la aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - # ... - router: { resource: "%kernel.root_dir%/config/routing.yml" } - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - // ... - 'router' => array('resource' => '%kernel.root_dir%/config/routing.php'), - )); - -.. tip:: - - A pesar de que todas las rutas se cargan desde un solo archivo, es práctica común incluir recursos de enrutado adicionales. Para ello, sólo indica en el archivo de configuración de enrutado principal cuáles archivos externos se tendrían que incluir. - Consulta la sección :ref:`routing-include-external-resources` para más información. - -Configuración básica de rutas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Definir una ruta es fácil, y una aplicación típica tendrá un montón de rutas. -Una ruta básica consta de dos partes: el ``path`` a emparejar y un arreglo ``defaults``: - -.. configuration-block:: - - .. code-block:: yaml - - _welcome: - path: / - defaults: { _controller: AcmeDemoBundle:Main:homepage } - - .. code-block:: xml - - - - - - - AcmeDemoBundle:Main:homepage - - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('_welcome', new Route('/', array( - '_controller' => 'AcmeDemoBundle:Main:homepage', - ))); - - return $collection; - -Esta ruta coincide con la página de inicio (``/``) y la asigna al controlador de la página principal ``AcmeDemoBundle:Main:homepage``. *Symfony2* convierte la cadena ``_controller`` en una función *PHP* real y la ejecuta. Este proceso será explicado en breve en la sección :ref:`controller-string-syntax`. - -.. index:: - single: Enrutando; Marcadores de posición - -Enrutando con marcadores de posición -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Por supuesto, el sistema de enrutado es compatible con rutas mucho más interesantes. Muchas rutas contienen uno o más «comodines» llamados marcadores de posición: - -.. configuration-block:: - - .. code-block:: yaml - - blog_show: - path: /blog/{slug} - defaults: { _controller: AcmeBlogBundle:Blog:show } - - .. code-block:: xml - - - - - - - AcmeBlogBundle:Blog:show - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('blog_show', new Route('/blog/{slug}', array( - '_controller' => 'AcmeBlogBundle:Blog:show', - ))); - - return $collection; - -La ruta emparejará con cualquier cosa que se parezca a ``/blog/*``. Aún mejor, el valor coincide con el marcador de posición ``{slug}`` que estará disponible dentro de tu controlador. En otras palabras, si la *URL* es ``/blog/hello-world``, una variable ``$slug``, con un valor de ``hello-world``, estará disponible en el controlador. -Esta se puede usar, por ejemplo, para cargar la entrada en el ``blog`` coincidente con esa cadena. - -La ruta *no* debe, sin embargo, emparejar con un ``/blog`` sencillo. Eso es porque, por omisión, todos los marcadores de posición son obligatorios. Esto se puede cambiar agregando un valor marcador de posición al arreglo ``defaults``. - -Marcadores de posición obligatorios y opcionales -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para hacer las cosas más emocionantes, añade una nueva ruta que muestre una lista de todas las entradas del *'blog'* para la petición imaginaria *'blog'*: - -.. configuration-block:: - - .. code-block:: yaml - - blog: - path: /blog - defaults: { _controller: AcmeBlogBundle:Blog:index } - - .. code-block:: xml - - - - - - - AcmeBlogBundle:Blog:index - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('blog', new Route('/blog', array( - '_controller' => 'AcmeBlogBundle:Blog:index', - ))); - - return $collection; - -Hasta el momento, esta ruta es tan simple como es posible --- no contiene marcadores de posición y sólo coincidirá con la *URL* exacta ``/blog``. ¿Pero si necesitamos que esta ruta sea compatible con paginación, donde ``/blog/2`` muestra la segunda página de las entradas del *blog*? Actualiza la ruta para que tenga un nuevo marcador de posición ``{page}``: - -.. configuration-block:: - - .. code-block:: yaml - - blog: - path: /blog/{page} - defaults: { _controller: AcmeBlogBundle:Blog:index } - - .. code-block:: xml - - - - - - - AcmeBlogBundle:Blog:index - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('blog', new Route('/blog/{page}', array( - '_controller' => 'AcmeBlogBundle:Blog:index', - ))); - - return $collection; - -Al igual que el marcador de posición ``{slug}`` anterior, el valor coincidente con ``{page}`` estará disponible dentro de tu controlador. Puedes utilizar su valor para determinar cual conjunto de entradas del *blog* muestra determinada página. - -¡Pero espera! Puesto que los marcadores de posición de forma predeterminada son obligatorios, esta ruta ya no coincidirá con ``/blog`` simplemente. En su lugar, para ver la página 1 del *blog*, ¡habrá la necesidad de utilizar la *URL* ``/blog/1``! Debido a que esa no es la manera en que se comporta una aplicación web rica, debes modificar la ruta para que el parámetro ``{page}`` sea opcional. -Esto se consigue incluyéndolo en la colección ``defaults``: - -.. configuration-block:: - - .. code-block:: yaml - - blog: - path: /blog/{page} - defaults: { _controller: AcmeBlogBundle:Blog:index, page: 1 } - - .. code-block:: xml - - - - - - - AcmeBlogBundle:Blog:index - 1 - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('blog', new Route('/blog/{page}', array( - '_controller' => 'AcmeBlogBundle:Blog:index', - 'page' => 1, - ))); - - return $collection; - -Agregando ``page`` a la clave ``defaults``, el marcador de posición ``{page}`` ya no es necesario. La *URL* ``/blog`` coincidirá con esta ruta y el valor del parámetro ``page`` se fijará en ``1``. La *URL* ``/blog/2`` también coincide, dando al parámetro ``page`` un valor de ``2``. Perfecto. - -+---------+--------------+ -| /blog | {page} = 1 | -+---------+--------------+ -| /blog/1 | {page} = 1 | -+---------+--------------+ -| /blog/2 | {page} = 2 | -+---------+--------------+ - -.. tip:: - - Las rutas con parámetros opcionales al final no coincidirán con peticiones con una barra inclinada final (es decir, ``/blog/`` no coincidirá, en cambio ``/blog`` concordará). - -.. index:: - single: Enrutando; Requisitos - -Agregando requisitos -~~~~~~~~~~~~~~~~~~~~ - -Echa un vistazo a las rutas que hemos creado hasta ahora: - -.. configuration-block:: - - .. code-block:: yaml - - blog: - path: /blog/{page} - defaults: { _controller: AcmeBlogBundle:Blog:index, page: 1 } - - blog_show: - path: /blog/{slug} - defaults: { _controller: AcmeBlogBundle:Blog:show } - - .. code-block:: xml - - - - - - - AcmeBlogBundle:Blog:index - 1 - - - - AcmeBlogBundle:Blog:show - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('blog', new Route('/blog/{page}', array( - '_controller' => 'AcmeBlogBundle:Blog:index', - 'page' => 1, - ))); - - $collection->add('blog_show', new Route('/blog/{show}', array( - '_controller' => 'AcmeBlogBundle:Blog:show', - ))); - - return $collection; - -¿Puedes ver el problema? Ten en cuenta que ambas rutas tienen patrones que coinciden con las *URL* que se parezcan a ``/blog/*``. El enrutador de *Symfony* siempre elegirá la **primera** ruta coincidente que encuentre. En otras palabras, la ruta ``blog_show`` *nunca* corresponderá. En cambio, una *URL* como ``/blog/my-blog-post`` coincidirá con la primera ruta (``blog``) y devolverá un valor sin sentido de ``my-blog-post`` para el parámetro ``{page}``. - -+---------------------------+-------+------------------------------+ -| *URL* | ruta | parámetros | -+===========================+=======+==============================+ -| /blog/2 | blog | {page} = 2 | -+---------------------------+-------+------------------------------+ -| /blog/mi-entrada-del-blog | blog | {page} = mi-entrada-del-blog | -+---------------------------+-------+------------------------------+ - -La respuesta al problema es añadir *requisitos* a la ruta. Las rutas en este ejemplo funcionarán perfectamente si el patrón ``/blog/{page}`` *sólo* concuerda con una *URL* dónde la parte ``{page}`` sea un número entero. Afortunadamente, se puede agregar fácilmente una expresión regular de requisitos para cada parámetro. Por ejemplo: - -.. configuration-block:: - - .. code-block:: yaml - - blog: - path: /blog/{page} - defaults: { _controller: AcmeBlogBundle:Blog:index, page: 1 } - requirements: - page: \d+ - - .. code-block:: xml - - - - - - - AcmeBlogBundle:Blog:index - 1 - \d+ - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('blog', new Route('/blog/{page}', array( - '_controller' => 'AcmeBlogBundle:Blog:index', - 'page' => 1, - ), array( - 'page' => '\d+', - ))); - - return $collection; - -El requisito ``\d+`` es una expresión regular diciendo que el valor del parámetro ``{page}`` debe ser un dígito (es decir, un número). La ruta ``blog`` todavía coincide con una *URL* como ``/blog/2`` (porque 2 es un número), pero ya no concuerda con una *URL* como ``/blog/my-blog-pos`` (porque ``my-blog-post`` *no* es un número). - -Como resultado, una *URL* como ``/blog/my-blog-post`` ahora coincide correctamente con la ruta ``blog_show``. - -+---------------------------+-----------+-------------------------------+ -| *URL* | ruta | parámetros | -+===========================+===========+===============================+ -| /blog/2 | blog | {page} = 2 | -+---------------------------+-----------+-------------------------------+ -| /blog/mi-entrada-del-blog | blog_show | {ficha} = mi-entrada-del-blog | -+---------------------------+-----------+-------------------------------+ - -.. sidebar:: Las primeras rutas siempre ganan - - ¿Qué significa todo eso de que el orden de las rutas es muy importante? - Si la ruta ``blog_show`` se coloca por encima de la ruta ``blog``, la *URL* ``/blog/2`` coincidiría con ``blog_show`` en lugar de ``blog`` ya que el parámetro ``{slug}`` de ``blog_show`` no tiene ningún requisito. Usando el orden adecuado y requisitos claros, puedes lograr casi cualquier cosa. - -Puesto que el parámetro ``requirements`` consiste de expresiones regulares, la complejidad y flexibilidad de cada requisito es totalmente tuya. Supongamos que la página principal de tu aplicación está disponible en dos diferentes idiomas, basándose en la *URL*: - -.. configuration-block:: - - .. code-block:: yaml - - homepage: - path: /{_locale} - defaults: { _controller: AcmeDemoBundle:Main:homepage, _locale: en } - requirements: - _locale: en|fr - - .. code-block:: xml - - - - - - - AcmeDemoBundle:Main:homepage - en - en|fr - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('homepage', new Route('/{culture}', array( - '_controller' => 'AcmeDemoBundle:Main:homepage', - 'culture' => 'en', - ), array( - 'culture' => 'en|fr', - ))); - - return $collection; - -Para las peticiones entrantes, la porción ``{_locale}`` de la dirección se compara con la expresión regular ``(en|es)``. - -+-----+-------------------------------+ -| / | {_locale} = es | -+-----+-------------------------------+ -| /en | {_locale} = en | -+-----+-------------------------------+ -| /es | {_locale} = es | -+-----+-------------------------------+ -| /fr | *no coincidirá con esta ruta* | -+-----+-------------------------------+ - -.. index:: - single: Enrutando; Requisitos de método - -Agregando requisitos de método *HTTP* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Además de la *URL*, también puedes coincidir con el *método* de la petición entrante (es decir, *GET*, *HEAD*, *POST*, *PUT*, *DELETE*). Supongamos que tienes un formulario de contacto con dos controladores ---uno para mostrar el formulario (en una petición *GET*) y uno para procesar el formulario una vez presentado (en una petición *POST*). Esto se puede lograr con la siguiente configuración de ruta: - -.. configuration-block:: - - .. code-block:: yaml - - contact: - path: /contact - defaults: { _controller: AcmeDemoBundle:Main:contact } - methods: [GET] - - contact_process: - path: /contact - defaults: { _controller: AcmeDemoBundle:Main:contactProcess } - methods: [POST] - - .. code-block:: xml - - - - - - - AcmeDemoBundle:Main:contact - - - - AcmeDemoBundle:Main:contactProcess - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('contact', new Route('/contact', array( - '_controller' => 'AcmeDemoBundle:Main:contact', - ), array(), array(), '', array(), array('GET'))); - - $collection->add('contact_process', new Route('/contact', array( - '_controller' => 'AcmeDemoBundle:Main:contactProcess', - ), array(), array(), '', array(), array('POST'))); - - return $collection; - -.. versionadded:: 2.2 - La opción ``methods`` se añadió en *Symfony* 2.2. Usa el requisito ``_method`` en versiones anteriores. - -A pesar del hecho de que estas dos rutas tienen patrones idénticos (``/contact``), la primera ruta sólo coincidirá con las peticiones ``GET`` y la segunda sólo coincidirá con las peticiones ``POST``. Esto significa que puedes mostrar y enviar el formulario a través de la misma *URL*, mientras usas controladores distintos para las dos acciones. - -.. note:: - - Si no especifícas ningún ``método``, la ruta emparejará con *todos* los métodos. - -Añadiendo un servidor -~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.2 - El soporte necesario para emparejar con el servidor se añadió en *Symfony* 2.2 - -También puedes emparejar con el *host* *HTTP* de la petición entrante. Para más información, consulta el :doc:`/components/routing/hostname_pattern` en la documentación del componente *Routing*. - -.. index:: - single: Enrutando; Ejemplo avanzado - single: Enrutando; parámetro _format - -.. _advanced-routing-example: - -Ejemplo de enrutado avanzado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En este punto, tienes todo lo necesario para crear una poderosa estructura de enrutado *Symfony*. El siguiente es un ejemplo de cuán flexible puede ser el sistema de enrutado: - -.. configuration-block:: - - .. code-block:: yaml - - article_show: - path: /articles/{_locale}/{year}/{title}.{_format} - defaults: { _controller: AcmeDemoBundle:Article:show, _format: html } - requirements: - _locale: en|fr - _format: html|rss - year: \d+ - - .. code-block:: xml - - - - - - - AcmeDemoBundle:Article:show - html - en|fr - html|rss - \d+ - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('homepage', new Route('/articles/{culture}/{year}/{title}.{_format}', array( - '_controller' => 'AcmeDemoBundle:Article:show', - '_format' => 'html', - ), array( - 'culture' => 'en|fr', - '_format' => 'html|rss', - 'year' => '\d+', - ))); - - return $collection; - -Como hemos visto, esta ruta sólo coincide si la porción ``{_locale}`` de la *URL* es o bien «``en``» o «``fr``» y si ``{year}`` es un número. Esta ruta también muestra cómo puedes utilizar un punto entre los marcadores de posición en lugar de una barra inclinada. Las *URL* que coinciden con esta ruta se podrían ver como las siguientes: - -* ``/articles/en/2010/my-post`` -* ``/articles/fr/2010/my-post.rss`` -* ``/articles/en/2013/my-latest-post.html`` - -.. _book-routing-format-param: - -.. sidebar:: El parámetro especial de enrutado ``_format`` - - Este ejemplo también resalta el parámetro especial de enrutado ``_format``. - Cuando se utiliza este parámetro, el valor coincidente se convierte en el «formato de la petición» del objeto ``Petición``. En última instancia, el formato de la petición se usa para cosas tales como establecer el ``Content-Type`` de la respuesta (por ejemplo, un formato de petición ``json`` se traduce en un ``Content-Type`` de ``application/json``). - Este también se puede usar en el controlador para reproducir una plantilla diferente por cada valor de ``_format``. El parámetro ``_format`` es una forma muy poderosa para reproducir el mismo contenido en distintos formatos. - -.. note:: - - A veces quieres hacer configurables globalmente ciertas partes de tus rutas. - *Symfony 2.1* te proporciona una manera de hacer esto aprovechando los parámetros del contenedor de servicios. Lee más sobre esto en «:doc:`/cookbook/routing/service_container_parameters`». - -Parámetros de enrutado especiales -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Como has visto, cada parámetro de enrutado o valor predeterminado finalmente está disponible como un argumento en el método controlador. Adicionalmente, hay tres parámetros que son especiales: cada uno añade una única pieza de funcionalidad a tu aplicación: - -* ``_controller``: Como hemos visto, este parámetro se utiliza para determinar qué controlador se ejecuta cuando la ruta concuerda; - -* ``_format``: Se utiliza para establecer el formato de la petición (:ref:`Leer más `); - -* ``_locale``: Se utiliza para establecer la configuración regional en la petición (:ref:`Leer más `); - -.. tip:: - - Si utilizas el parámetro ``_locale`` en una ruta, ese valor también se almacenará en la sesión para las subsecuentes peticiones lo cual evita guardar la misma región. - -.. index:: - single: Enrutando; Controladores - single: Controlador; Cadena denominando el formato - -.. _controller-string-syntax: - -Patrón de nomenclatura para controladores ------------------------------------------ - -Cada ruta debe tener un parámetro ``_controller``, el cual determina qué controlador se debe ejecutar cuando dicha ruta concuerde. Este parámetro utiliza un patrón de cadena simple llamado el *nombre lógico del controlador*, que *Symfony* asigna a un método y clase *PHP* específico. El patrón consta de tres partes, cada una separada por dos puntos: - - **paquete**:**controlador**:**acción** - -Por ejemplo, un valor ``_controller`` de ``AcmeBlogBundle:Blog:show`` significa: - -+----------------+----------------------+-----------------+ -| Paquete | Clase de controlador | Nombre método | -+================+======================+=================+ -| AcmeBlogBundle | BlogController | showAction | -+----------------+----------------------+-----------------+ - -El controlador podría tener este aspecto:: - - // src/Acme/BlogBundle/Controller/BlogController.php - namespace Acme\BlogBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - - class BlogController extends Controller - { - public function showAction($slug) - { - // ... - } - } - -Ten en cuenta que *Symfony* añade la cadena ``Controller`` al nombre de la clase (``Blog`` -=> ``BlogController``) y ``Action`` al nombre del método (``show`` => ``showAction``). - -También podrías referirte a este controlador utilizando su nombre de clase y método completamente cualificado: ``Acme\BlogBundle\Controller\BlogController::showAction``. -Pero si sigues algunas simples convenciones, el nombre lógico es más conciso y permite mayor flexibilidad. - -.. note:: - - Además de utilizar el nombre lógico o el nombre de clase completamente cualificado, *Symfony* es compatible con una tercera forma de referirse a un controlador. Este método utiliza un solo separador de dos puntos (por ejemplo, ``service_name:indexAction``) y hace referencia al controlador como un servicio (consulta :doc:`/cookbook/controller/service`). - -Parámetros de ruta y argumentos del controlador ------------------------------------------------ - -Los parámetros de ruta (por ejemplo, ``{slug}``) son especialmente importantes porque cada uno se pone a disposición como argumento para el método controlador:: - - public function showAction($slug) - { - // ... - } - -En realidad, toda la colección ``defaults`` se combina con los valores del parámetro para formar un solo arreglo. Cada clave de ese arreglo está disponible como un argumento en el controlador. - -En otras palabras, por cada argumento de tu método controlador, *Symfony* busca un parámetro de ruta con ese nombre y asigna su valor a ese argumento. -En el ejemplo avanzado anterior, podrías utilizar cualquier combinación (en cualquier orden) de las siguientes variables como argumentos para el método ``showAction()``: - -* ``$_locale`` -* ``$year`` -* ``$title`` -* ``$_format`` -* ``$_controller`` - -Dado que los marcadores de posición y los valores de la colección ``defaults`` se combinan, incluso la variable ``$_controller`` está disponible. Para una explicación más detallada, consulta :ref:`route-parameters-controller-arguments`. - -.. tip:: - - También puedes utilizar una variable especial ``$_route``, que se fija al nombre de la ruta que concordó. - -.. index:: - single: Enrutando; Importando recursos de enrutado - -.. _routing-include-external-resources: - -Incluyendo recursos de enrutado externos ----------------------------------------- - -Todas las rutas se cargan a través de un único archivo de configuración ---usualmente ``app/config/routing.yml`` (consulta `Creando rutas`_ más arriba). Por lo general, sin embargo, deseas cargar rutas para otros lugares, como un archivo de enrutado que vive dentro de un paquete. Esto se puede hacer «importando» ese archivo: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - acme_hello: - resource: "@AcmeHelloBundle/Resources/config/routing.yml" - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - - $collection = new RouteCollection(); - $collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php")); - - return $collection; - -.. note:: - - Cuando importas recursos desde *YAML*, la clave (por ejemplo, ``acme_hello``) no tiene sentido. - Sólo asegúrate de que es única para que no haya otras líneas que reemplazar. - -La clave ``resource`` carga el recurso de la ruta dada. En este ejemplo, el recurso es la ruta completa a un archivo, donde la sintaxis contextual del atajo ``@AcmeHelloBundle`` se resuelve en la ruta a ese paquete. El archivo importado podría tener este aspecto: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/routing.yml - acme_hello: - path: /hello/{name} - defaults: { _controller: AcmeHelloBundle:Hello:index } - - .. code-block:: xml - - - - - - - - AcmeHelloBundle:Hello:index - - - - .. code-block:: php - - // src/Acme/HelloBundle/Resources/config/routing.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('acme_hello', new Route('/hello/{name}', array( - '_controller' => 'AcmeHelloBundle:Hello:index', - ))); - - return $collection; - -Las rutas de este archivo se analizan y cargan en la misma forma que el archivo de enrutado principal. - -Prefijando rutas importadas -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -También puedes optar por proporcionar un «prefijo» para las rutas importadas. Por ejemplo, supongamos que deseas que la ruta ``acme_hello`` tenga una ruta final de ``/admin/hello/{name}`` en lugar de simplemente ``/hello/{name}``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - acme_hello: - resource: "@AcmeHelloBundle/Resources/config/routing.yml" - prefix: /admin - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - - $collection = new RouteCollection(); - $collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"), '/admin'); - - return $collection; - -La cadena ``/admin`` ahora será prefijada a la trayectoria de cada ruta cargada del nuevo recurso de enrutado. - -.. tip:: - - Además puedes definir rutas usando anotaciones. Consulta la documentación del :doc:`FrameworkExtraBundle ` para ver cómo hacerlo. - -Añadiendo un servidor a la expresión regular de las rutas importadas --------------------------------------------------------------------- - -.. versionadded:: 2.2 - El soporte necesario para emparejar con el servidor se añadió en *Symfony* 2.2 - -Puedes poner el servidor en la expresión regular de las rutas importadas. Para más información, ve :ref:`component-routing-host-imported`. - -.. index:: - single: Enrutando; Depurando - -Visualizando y depurando rutas ------------------------------- - -Si bien agregar y personalizar rutas, es útil para poder visualizar y obtener información detallada sobre tus rutas. Una buena manera de ver todas las rutas en tu aplicación es a través de la orden de consola ``router:debug``. Ejecuta la siguiente orden desde la raíz de tu proyecto. - -.. code-block:: bash - - $ php app/console router:debug - -Esta orden imprimirá una útil lista de *todas* las rutas configuradas en tu aplicación: - -.. code-block:: text - - homepage ANY / - contact GET /contact - contact_process POST /contact - article_show ANY /articles/{_locale}/{year}/{title}.{_format} - blog ANY /blog/{page} - blog_show ANY /blog/{slug} - -También puedes obtener información muy específica de una sola ruta incluyendo el nombre de la ruta después de la orden: - -.. code-block:: bash - - $ php app/console router:debug article_show - -Asímismo, si deseas probar acuál ruta coincide con una trayectoria dada, puedes usar la orden de consola ``router:match``: - -.. code-block:: bash - - $ php app/console router:match /blog/my-latest-post - -Esta orden imprimirá la ruta de la *URL* coincidente. - -.. code-block:: text - - Route "blog_show" matches - -.. index:: - single: Enrutando; Generando URL - -Generando *URL* ---------------- - -El sistema de enrutado también se debe utilizar para generar *URL*. En realidad, el enrutado es un sistema bidireccional: asignando la *URL* a un controlador+parámetros y la ruta+parámetros a una *URL*. Los métodos :method:`Symfony\\Component\\Routing\\Router::match` y :method:`Symfony\\Component\\Routing\\Router::generate` de este sistema bidireccional. Tomando la ruta ``blog_show`` del ejemplo anterior:: - - $params = $this->get('router')->match('/blog/my-blog-post'); - // array( - // 'slug' => 'my-blog-post', - // '_controller' => 'AcmeBlogBundle:Blog:show', - // ) - - $uri = $this->get('router')->generate('blog_show', array('slug' => 'my-blog-post')); - // /blog/my-blog-post - -Para generar una *URL*, debes especificar el nombre de la ruta (por ejemplo, ``blog_show``) y cualquier comodín (por ejemplo, ``slug = my-blog-post``) usado en el patrón de esa ruta. Con esta información, fácilmente puedes generar cualquier *URL*:: - - class MainController extends Controller - { - public function showAction($slug) - { - // ... - - $url = $this->generateUrl( - 'blog_show', - array('slug' => 'my-blog-post') - ); - } - } - -.. note:: - - En los controladores que extienden la clase base :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller` de *Symfony*, puedes utilizar el método :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::generateUrl`, el cual llama al método :method:`Symfony\\Component\\Routing\\Router::generate` del servicio enrutador. - -En una sección posterior, aprenderás cómo generar *URL* desde el interior de tus plantillas. - -.. tip:: - - Si la interfaz de tu aplicación utiliza peticiones *AJAX*, posiblemente desees poder generar las direcciones *URL* en *JavaScript* basándote en tu configuración de enrutado. - Usando el `FOSJsRoutingBundle`_, puedes hacer eso exactamente: - - .. code-block:: javascript - - var url = Routing.generate( - 'blog_show', - {"slug": 'my-blog-post'} - ); - - Para más información, consulta la documentación del paquete. - -.. index:: - single: Enrutando; URL absolutas - -Generando *URL* absolutas -~~~~~~~~~~~~~~~~~~~~~~~~~ - -De forma predeterminada, el enrutador va a generar *URL* relativas (por ejemplo ``/blog``). Para generar una *URL* absoluta, sólo tienes que pasar ``true`` como tercer argumento del método ``generate()``:: - - $router->generate('blog_show', array('slug' => 'my-blog-post'), true); - // http://www.example.com/blog/my-blog-post - -.. note:: - - El servidor utilizado al generar una *URL* absoluta es el anfitrión del objeto ``Petición`` actual. Este se detercta automática basándose en la información del servidor suministrada por *PHP*. Al generar direcciones *URL* absolutas para archivos ejecutables desde la línea de ordenes, debes configurar manualmente el servidor que desees en el objeto ``RequestContext``:: - - $router->getContext()->setHost('www.example.com'); - -.. index:: - single: Enrutando; Generando URL en plantillas - -Generando *URL* con cadena de consulta -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El método ``generate`` toma un arreglo de valores comodín para generar la *URI*. -Pero si pasas adicionales, se añadirán a la *URI* como cadena de consulta:: - - $router->generate('blog', array('page' => 2, 'category' => 'Symfony')); - // /blog/2?category=Symfony - -Generando *URL* desde una plantilla -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El lugar más común para generar una *URL* es dentro de una plantilla cuando creas enlaces entre las páginas de tu aplicación. Esto se hace igual que antes, pero utilizando una función ayudante de plantilla: - -.. configuration-block:: - - .. code-block:: html+jinja - - - Read this blog post. - - - .. code-block:: html+php - - - Read this blog post. - - -También puedes generar *URL* absolutas. - -.. configuration-block:: - - .. code-block:: html+jinja - - - Read this blog post. - - - .. code-block:: html+php - - - Read this blog post. - - -Resumen -------- - -El enrutado es un sistema para asignar la dirección de las peticiones entrantes a la función controladora que se debe llamar para procesar la petición. Este permite especificar ambas *URL* bonitas y mantiene la funcionalidad de tu aplicación disociada de las *URL*. El enrutado es un mecanismo de dos vías, lo cual significa que también lo debes usar para generar tus direcciones *URL*. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/routing/scheme` - -.. _`FOSJsRoutingBundle`: https://github.com/FriendsOfSymfony/FOSJsRoutingBundle diff --git a/_sources/book/security.txt b/_sources/book/security.txt deleted file mode 100644 index 70e5f93..0000000 --- a/_sources/book/security.txt +++ /dev/null @@ -1,1722 +0,0 @@ -.. index:: - single: Seguridad - -Seguridad -========= - -La seguridad es un proceso de dos etapas, cuyo objetivo es evitar que un usuario acceda a un recurso al cual no debería tener acceso. - -En el primer paso del proceso, el sistema de seguridad identifica quién es el usuario obligándolo a presentar algún tipo de identificación. Esto se llama **autenticación**, y significa que el sistema está tratando de determinar quién eres. - -Una vez que el sistema sabe quien eres, el siguiente paso es determinar si deberías tener acceso a un determinado recurso. Esta parte del proceso se llama **autorización**, y significa que el sistema está comprobando si tienes suficientes privilegios para realizar una determinada acción. - -.. image:: /images/book/security_authentication_authorization_es.png - :align: center - -Puesto que la mejor manera de aprender es viendo un ejemplo, empieza asegurando tu aplicación con autenticación *HTTP* básica. - -.. note:: - - El `componente Security de Symfony`_ está disponible como una biblioteca *PHP* independiente para usarla en cualquier proyecto *PHP*. - -Ejemplo básico: Autenticación *HTTP* ------------------------------------- - -Puedes ajustar el componente de seguridad a través de la configuración de tu aplicación. -De hecho, la mayoría de las opciones de seguridad estándar son sólo cuestión de usar los ajustes correctos. La siguiente configuración le dice a *Symfony* que proteja cualquier *URL* coincidente con ``/admin/*`` y pida al usuario sus credenciales mediante autenticación *HTTP* básica (es decir, el cuadro de dialogo a la vieja escuela: nombre de usuario/contraseña): - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - firewalls: - secured_area: - pattern: ^/ - anonymous: ~ - http_basic: - realm: "Secured Demo Area" - - access_control: - - { path: ^/admin, roles: ROLE_ADMIN } - - providers: - in_memory: - memory: - users: - ryan: { password: ryanpass, roles: 'ROLE_USER' } - admin: { password: kitten, roles: 'ROLE_ADMIN' } - - encoders: - Symfony\Component\Security\Core\User\User: plaintext - - .. code-block:: xml - - - - - - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'firewalls' => array( - 'secured_area' => array( - 'pattern' => '^/', - 'anonymous' => array(), - 'http_basic' => array( - 'realm' => 'Secured Demo Area', - ), - ), - ), - 'access_control' => array( - array('path' => '^/admin', 'role' => 'ROLE_ADMIN'), - ), - 'providers' => array( - 'in_memory' => array( - 'memory' => array( - 'users' => array( - 'ryan' => array('password' => 'ryanpass', 'roles' => 'ROLE_USER'), - 'admin' => array('password' => 'kitten', 'roles' => 'ROLE_ADMIN'), - ), - ), - ), - ), - 'encoders' => array( - 'Symfony\Component\Security\Core\User\User' => 'plaintext', - ), - )); - -.. tip:: - - Una distribución estándar de *Symfony* separa la configuración de seguridad en un archivo independiente (por ejemplo, ``app/config/security.yml``). Si no tienes un archivo de seguridad autónomo, puedes poner la configuración directamente en el archivo de configuración principal (por ejemplo, :file:`app/config/config.yml`). - -El resultado final de esta configuración es un sistema de seguridad totalmente operativo que tiene el siguiente aspecto: - -* Hay dos usuarios en el sistema (``ryan`` y ``admin``); -* Los usuarios se autentican a través de la autenticación *HTTP* básica del sistema; -* Cualquier *URL* que coincida con ``/admin/*`` está protegida, y sólo el usuario ``admin`` puede acceder a ellas; -* Todas las *URL* que *no* coincidan con ``/admin/*`` son accesibles para todos los usuarios (y nunca se pide al usuario que se registre). - -Veamos brevemente cómo funciona la seguridad y cómo entra en juego cada parte de la configuración. - -Cómo funciona la seguridad: autenticación y autorización --------------------------------------------------------- - -El sistema de seguridad de *Symfony* trabaja identificando a un usuario (es decir, la autenticación) y comprobando si ese usuario debe tener acceso a una *URL* o recurso específico. - -.. _book-security-firewalls: - -Cortafuegos (autenticación) -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando un usuario hace una petición a una *URL* que está protegida por un cortafuegos, se activa el sistema de seguridad. El trabajo del cortafuegos es determinar si el usuario necesita estar autenticado, y si lo hace, enviar una respuesta al usuario para iniciar el proceso de autenticación. - -Un cortafuegos se activa cuando la *URL* de una petición entrante concuerda con el ``patrón`` de la expresión regular configurada en el valor ``config`` del cortafuegos. En este ejemplo el ``patrón`` (``^/``) concordará con *cada* petición entrante. El hecho de que el cortafuegos esté activado *no* significa, sin embargo, que el nombre de usuario de autenticación *HTTP* y el cuadro de diálogo de la contraseña se muestre en cada *URL*. Por ejemplo, cualquier usuario puede acceder a ``/foo`` sin que se le pida se autentique. - -.. image:: /images/book/security_anonymous_user_access_es.png - :align: center - -Esto funciona en primer lugar porque el cortafuegos permite *usuarios anónimos* a través del parámetro de configuración ``anonymous``. En otras palabras, el cortafuegos no requiere que el usuario se autentique plenamente de inmediato. Y puesto que no hay ``rol`` especial necesario para acceder a ``/foo`` (bajo la sección ``access_control``), la petición se puede llevar a cabo sin solicitar al usuario se autentique. - -Si eliminas la clave ``anonymous``, el cortafuegos *siempre* hará que un usuario se autentique inmediatamente. - -Control de acceso (autorización) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si un usuario solicita ``/admin/foo``, sin embargo, el proceso se comporta de manera diferente. -Esto se debe a la sección de configuración ``access_control`` la cual dice que cualquier *URL* coincidente con el patrón de la expresión regular ``^/admin`` (es decir, ``/admin`` o cualquier cosa coincidente con ``/admin/*``) requiere el rol ``ROLE_ADMIN``. Los roles son la base para la mayor parte de la autorización: el usuario puede acceder a ``/admin/foo`` sólo si cuenta con el rol ``ROLE_ADMIN``. - -.. image:: /images/book/security_anonymous_user_denied_authorization_es.png - :align: center - -Como antes, cuando el usuario hace la petición originalmente, el cortafuegos no solicita ningún tipo de identificación. Sin embargo, tan pronto como la capa de control de acceso niega el acceso a los usuarios (ya que el usuario anónimo no tiene el rol ``ROLE_ADMIN``), el servidor de seguridad entra en acción e inicia el proceso de autenticación). -El proceso de autenticación depende del mecanismo de autenticación que utilices. Por ejemplo, si estás utilizando el método de autenticación con formulario de acceso, el usuario será redirigido a la página de inicio de sesión. Si estás utilizando autenticación *HTTP*, se enviará al usuario una respuesta *HTTP 401* para que el usuario vea el cuadro de diálogo de nombre de usuario y contraseña. - -Ahora el usuario de nuevo tiene la posibilidad de presentar sus credenciales a la aplicación. -Si las credenciales son válidas, se puede intentar de nuevo la petición original. - -.. image:: /images/book/security_ryan_no_role_admin_access_es.png - :align: center - -En este ejemplo, el usuario ``ryan`` se autentica correctamente con el cortafuegos. -Pero como ``ryan`` no cuenta con el rol ``ROLE_ADMIN``, se le sigue negando el acceso a ``/admin/foo``. En última instancia, esto significa que el usuario debe ver algún tipo de mensaje indicándole que se le ha denegado el acceso. - -.. tip:: - - Cuando *Symfony* niega el acceso al usuario, él verá una pantalla de error y recibe un código de estado *HTTP 403* (``Prohibido``). Puedes personalizar la pantalla de error, acceso denegado, siguiendo las instrucciones de las :ref:`Páginas de error ` en el artículo para personalizar la página de error 403 del recetario. - -Por último, si el usuario ``admin`` solicita ``/admin/foo``, se lleva a cabo un proceso similar, excepto que ahora, después de haberse autenticado, la capa de control de acceso le permitirá pasar a través de la petición: - -.. image:: /images/book/security_admin_role_access_es.png - :align: center - -El flujo de la petición cuando un usuario solicita un recurso protegido es sencillo, pero increíblemente flexible. Como verás más adelante, la autenticación se puede realizar de varias maneras, incluyendo a través de un formulario de acceso, certificados X.509 o la autenticación del usuario a través de *Twitter*. Independientemente del método de autenticación, el flujo de la petición siempre es el mismo: - -#. Un usuario accede a un recurso protegido; -#. La aplicación redirige al usuario al formulario de acceso; -#. El usuario presenta sus credenciales (por ejemplo nombre de usuario/contraseña); -#. El cortafuegos autentica al usuario; -#. El nuevo usuario autenticado intenta de nuevo la petición original. - -.. note:: - - El proceso *exacto* realmente depende un poco en el mecanismo de autenticación utilizado. Por ejemplo, cuando utilizas el formulario de acceso, el usuario presenta sus credenciales a una *URL* que procesa el formulario (por ejemplo ``/login_check``) y luego es redirigido a la dirección solicitada originalmente (por ejemplo ``/admin/foo``). - Pero con la autenticación *HTTP*, el usuario envía sus credenciales directamente a la *URL* original (por ejemplo ``/admin/foo``) y luego la página se devuelve al usuario en la misma petición (es decir, sin redirección). - - Este tipo de idiosincrasia no debería causar ningún problema, pero es bueno tenerla en cuenta. - -.. tip:: - - También aprenderás más adelante cómo puedes proteger *cualquier cosa* en *Symfony2*, incluidos controladores específicos, objetos, e incluso métodos *PHP*. - -.. _book-security-form-login: - -Usando un formulario de acceso tradicional ------------------------------------------- - -.. tip:: - - En esta sección, aprenderás cómo crear un formulario de acceso básico que continúa usando los usuarios definidos en el código del archivo ``security.yml``. - - Para cargar usuarios desde la base de datos, por favor consulta :doc:`/cookbook/security/entity_provider`. - Al leer este artículo y esta sección, puedes crear un sistema de formularios de acceso completo que carga usuarios desde la base de datos. - -Hasta ahora, hemos visto cómo cubrir tu aplicación bajo un cortafuegos y proteger el acceso a determinadas zonas con roles. Al usar la autenticación *HTTP*, puedes aprovechar sin esfuerzo, el cuadro de diálogo nativo nombre de usuario/contraseña que ofrecen todos los navegadores. Sin embargo, fuera de la caja, *Symfony* es compatible con múltiples mecanismos de autenticación. Para información detallada sobre todos ellos, consulta la :doc:`Referencia para afinar el sistema de seguridad `. - -En esta sección, vamos a mejorar este proceso permitiendo la autenticación del usuario a través de un formulario de acceso *HTML* tradicional. - -En primer lugar, activa el formulario de acceso en el cortafuegos: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - firewalls: - secured_area: - pattern: ^/ - anonymous: ~ - form_login: - login_path: login - check_path: login_check - - .. code-block:: xml - - - - - - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'firewalls' => array( - 'secured_area' => array( - 'pattern' => '^/', - 'anonymous' => array(), - 'form_login' => array( - 'login_path' => 'login', - 'check_path' => 'login_check', - ), - ), - ), - )); - -.. tip:: - - Si no necesitas personalizar tus valores ``login_path`` o ``check_path`` (los valores utilizados aquí son los valores predeterminados), puedes acortar tu configuración: - - .. configuration-block:: - - .. code-block:: yaml - - form_login: ~ - - .. code-block:: xml - - - - .. code-block:: php - - 'form_login' => array(), - -Ahora, cuando el sistema de seguridad inicia el proceso de autenticación, redirige al usuario al formulario de acceso (predeterminado a ``/login``). La implementación visual de este formulario de acceso es tu trabajo. Primero, crea las dos rutas que utilizarás en la configuración de seguridad: La ruta ``login`` mostrará el formulario de inicio de sesión (es decir ``/login``) y la ruta ``login_check`` procesará el formulario enviado (es decir ``/login_check``): - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - login: - pattern: /login - defaults: { _controller: AcmeSecurityBundle:Security:login } - login_check: - pattern: /login_check - - .. code-block:: xml - - - - - - - - AcmeSecurityBundle:Security:login - - - - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('login', new Route('/login', array( - '_controller' => 'AcmeDemoBundle:Security:login', - ))); - $collection->add('login_check', new Route('/login_check', array())); - - return $collection; - -.. note:: - - *No* necesitas implementar un controlador para la *URL* ``/login_check`` ya que el cortafuegos automáticamente captura y procesa cualquier formulario enviado a esta *URL*. - -.. versionadded:: 2.1 - A partir de *Symfony* 2.1, *debes* tener configuradas las rutas para tus claves ``login_path``, ``check_path`` y ``logout``. Estas claves pueden ser nombres de ruta (tal como muestra este ejemplo) o las *URL* que tienen rutas configuradas para ello. - -Ten en cuenta que el nombre de la ruta ``login`` coincide con el valor ``login_path`` configurado, a donde el sistema de seguridad redirigirá a los usuarios que necesiten ingresar. - -A continuación, crea el controlador que mostrará el formulario de acceso:: - - // src/Acme/SecurityBundle/Controller/SecurityController.php; - namespace Acme\SecurityBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - use Symfony\Component\Security\Core\SecurityContext; - - class SecurityController extends Controller - { - public function loginAction() - { - $request = $this->getRequest(); - $session = $request->getSession(); - - // obtiene el error de inicio de sesión si lo hay - if ($request->attributes->has(SecurityContext::AUTHENTICATION_ERROR)) { - $error = $request->attributes->get( - SecurityContext::AUTHENTICATION_ERROR - ); - } else { - $error = $session->get(SecurityContext::AUTHENTICATION_ERROR); - $session->remove(SecurityContext::AUTHENTICATION_ERROR); - } - - return $this->render( - 'AcmeSecurityBundle:Security:login.html.twig', - array( - // último nombre de usuario ingresado - 'last_username' => $session->get(SecurityContext::LAST_USERNAME), - 'error' => $error, - ) - ); - } - } - -No dejes que este controlador te confunda. Como veremos en un momento, cuando el usuario envía el formulario, el sistema de seguridad automáticamente se encarga de procesar la recepción del formulario por ti. Si el usuario ha presentado un nombre de usuario o contraseña no válidos, este controlador lee el error del formulario enviado desde el sistema de seguridad de modo que se pueda mostrar al usuario. - -En otras palabras, tu trabajo es mostrar el formulario al usuario y los errores de ingreso que puedan haber ocurrido, pero, el propio sistema de seguridad se encarga de verificar el nombre de usuario y contraseña y la autenticación del usuario. - -Por último, crea la plantilla correspondiente: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/SecurityBundle/Resources/views/Security/login.html.twig #} - {% if error %} -
{{ error.message }}
- {% endif %} - - - - - - - - - {# - Si deseas controlar la URL a la que rediriges al - usuario en caso de éxito (más detalles abajo) - - #} - - - - - .. code-block:: html+php - - - -
getMessage() ?>
- - -
- - - - - - - - - -
- -.. tip:: - - La variable ``error`` pasada a la plantilla es una instancia de :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`. - Esta puede contener más información ---o incluso información confidencial--- sobre el fallo de autenticación, ¡por lo tanto utilízala prudentemente! - -El formulario tiene muy pocos requisitos. En primer lugar, presentando el formulario a ``/login_check`` (a ​​través de la ruta ``login_check``), el sistema de seguridad debe interceptar el envío del formulario y procesarlo automáticamente. En segundo lugar, el sistema de seguridad espera que los campos presentados se llamen ``_username`` y ``_password`` (estos nombres de campo se pueden :ref:`configurar `). - -¡Y eso es todo! Cuando envías el formulario, el sistema de seguridad automáticamente comprobará las credenciales del usuario y, o bien autenticará al usuario o lo enviará al formulario de acceso donde se puede mostrar el error. - -Revisemos todo el proceso: - -#. El usuario intenta acceder a un recurso que está protegido; -#. El cortafuegos inicia el proceso de autenticación redirigiendo al usuario al formulario de acceso (``/login``); -#. La página ``/login`` reproduce el formulario de acceso a través de la ruta y el controlador creado en este ejemplo; -#. El usuario envía el formulario de acceso a ``/login_check``; -#. El sistema de seguridad intercepta la petición, comprueba las credenciales presentadas por el usuario, autentica al usuario si todo está correcto, y si no, envía al usuario de nuevo al formulario de acceso. - -Por omisión, si las credenciales presentadas son correctas, el usuario será redirigido a la página solicitada originalmente (por ejemplo ``/admin/foo``). Si originalmente el usuario fue directo a la página de inicio de sesión, será redirigido a la página principal. -Esto puede ser altamente personalizado, lo cual te permite, por ejemplo, redirigir al usuario a una *URL* específica. - -Para más detalles sobre esto y cómo personalizar el proceso de entrada en general, consulta :doc:`/cookbook/security/form_login`. - -.. _book-security-common-pitfalls: - -.. sidebar:: Evitando errores comunes - - Cuando prepares tu formulario de acceso, ten cuidado con unas cuantas trampas muy comunes. - - **1. Crea las rutas correctas** - - En primer lugar, asegúrate de que has definido correctamente las rutas ``/login`` y ``/login_check`` y que corresponden a los valores configurados de ``login_path`` y ``check_path``. Una mala configuración aquí puede significar que seas redirigido a una página de error 404 en lugar de a la página de acceso, o que al presentar el formulario de acceso no haga nada (sólo verás el formulario de acceso una y otra vez). - - **2. Asegúrate de que la página de inicio de sesión no esté protegida** - - Además, asegúrate de que la página de acceso *no* requiere ningún rol para verla. Por ejemplo, la siguiente configuración ---la cual requiere el rol ``ROLE_ADMIN`` para todas las *URL* (incluyendo la *URL* ``/login``)---, provocará un bucle de redirección: - - .. configuration-block:: - - .. code-block:: yaml - - access_control: - - { path: ^/, roles: ROLE_ADMIN } - - .. code-block:: xml - - - - - - .. code-block:: php - - 'access_control' => array( - array('path' => '^/', 'role' => 'ROLE_ADMIN'), - ), - - Quitar el control de acceso en la *URL* ``/login`` soluciona el problema: - - .. configuration-block:: - - .. code-block:: yaml - - access_control: - - { path: ^/login, roles: IS_AUTHENTICATED_ANONYMOUSLY } - - { path: ^/, roles: ROLE_ADMIN } - - .. code-block:: xml - - - - - - - .. code-block:: php - - 'access_control' => array( - array('path' => '^/login', 'role' => 'IS_AUTHENTICATED_ANONYMOUSLY'), - array('path' => '^/', 'role' => 'ROLE_ADMIN'), - ), - - Además, si el cortafuegos *no* permite usuarios anónimos, necesitas crear un cortafuegos especial que permita usuarios anónimos en la página de acceso: - - .. configuration-block:: - - .. code-block:: yaml - - firewalls: - login_firewall: - pattern: ^/login$ - anonymous: ~ - secured_area: - pattern: ^/ - form_login: ~ - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - 'firewalls' => array( - 'login_firewall' => array( - 'pattern' => '^/login$', - 'anonymous' => array(), - ), - 'secured_area' => array( - 'pattern' => '^/', - 'form_login' => array(), - ), - ), - - **3. Asegúrate de que** ``/login_check`` **está detrás de un cortafuegos** - - A continuación, asegúrate de que tu ruta *URL* ``check_path`` (por ejemplo ``/login_check``) está detrás del cortafuegos que estás utilizando para tu formulario de acceso (en este ejemplo, el único cortafuegos coincide con *todas* las *URL*, incluyendo ``/login_check``). Si ``/login_check`` no coincide con ningún cortafuegos, recibirás una excepción ``No se puede encontrar el controlador para la ruta «/login_check»``. - - **4. Múltiples cortafuegos no comparten el contexto de seguridad** - - Si estás utilizando múltiples cortafuegos y autenticas contra un cortafuegos, *no* serás autenticado automáticamente contra ningún otro cortafuegos. - Diferentes cortafuegos, son como diferentes sistemas de seguridad. Para hacerlo debes especificar explícitamente el mismo :ref:`reference-security-firewall-context` para diferentes cortafuegos. Pero normalmente la mayoría de las aplicaciones, tener un cortafuegos principal es suficiente. - -Autorizando ------------ - -El primer paso en la seguridad siempre es la autenticación: el proceso de verificar quién es el usuario. Con *Symfony*, la autenticación se puede hacer de cualquier manera ---a través de un formulario de acceso, autenticación básica *HTTP*, e incluso a través de *Facebook*. - -Una vez que el usuario se ha autenticado, comienza la autorización. La autorización proporciona una forma estándar y potente para decidir si un usuario puede acceder a algún recurso (una *URL*, un modelo de objetos, una llamada a un método, ...). Esto funciona asignando roles específicos a cada usuario y, a continuación, requiriendo diferentes roles para diferentes recursos. - -El proceso de autorización tiene dos lados diferentes: - -#. El usuario tiene un conjunto de roles específico; -#. Un recurso requiere un rol específico a fin de tener acceso. - -En esta sección, nos centraremos en cómo proteger diferentes recursos (por ejemplo, *URL*, llamadas a métodos, etc.) con diferentes roles. Más tarde, aprenderás más sobre cómo crear y asignar roles a los usuarios. - -Protegiendo patrones de *URL* específicas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La forma más básica para proteger parte de tu aplicación es asegurar un patrón de *URL* completo. Ya lo viste en el primer ejemplo de este capítulo, cómo algo que coincide con el patrón de la expresión regular ``^/admin`` requiere el rol ``ROLE_ADMIN``. - -.. caution:: - - Entender exactamente cómo trabaja ``access_control`` es **muy** importante para garantizar que tu aplicación está protegida correctamente. Ve más adelante :ref:`security-book-access-control-explanation` para información detallada. - -Puedes definir tantos patrones *URL* como necesites ---cada uno es una expresión regular---. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - # ... - access_control: - - { path: ^/admin/users, roles: ROLE_SUPER_ADMIN } - - { path: ^/admin, roles: ROLE_ADMIN } - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - // ... - 'access_control' => array( - array('path' => '^/admin/users', 'role' => 'ROLE_SUPER_ADMIN'), - array('path' => '^/admin', 'role' => 'ROLE_ADMIN'), - ), - )); - -.. tip:: - - Al prefijar la ruta con ``^`` te aseguras que sólo coinciden las *URL* que *comienzan* con ese patrón. Por ejemplo, una ruta de simplemente ``/admin`` (sin el ``^``) correctamente coincidirá con ``/admin/foo`` pero también coincide con la *URL* ``/foo/admin``. - -.. _security-book-access-control-explanation: - -Entendiendo cómo trabaja ``access_control`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Por cada petición entrante, *Symfony2* comprueba cada opción ``access_control`` para encontrar *una* que concuerde con la petición actual. Tan pronto como encuentra una entrada ``access_control`` coincidente, se detiene ---únicamente si el **primer** ``access_control`` concordante se usa para forzar el acceso---. - -Cada ``access_control`` tiene varias opciones que configuran dos diferentes cosas: (a) :ref:`la petición entrante emparejada debe tener esta entrada de control de acceso ` y (b) :ref:`una vez emparejada, debe tener algún tipo de restricción de acceso aplicable `: - -.. _security-book-access-control-matching-options: - -**(a) Emparejando Opciones** - -*Symfony2* crea una instancia de :class:`Symfony\\Component\\HttpFoundation\\RequestMatcher` para cada entrada ``access_control``, la cual determina si o no se debería usar un determinado control de acceso en esa petición. Las siguientes opciones de ``access_control`` se utilizan para emparejar: - -* ``path`` -* ``ip`` -* ``host`` -* ``methods`` - -Toma las siguientes entradas de ``access_control`` como ejemplo: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - # ... - access_control: - - { path: ^/admin, roles: ROLE_USER_IP, ip: 127.0.0.1 } - - { path: ^/admin, roles: ROLE_USER_HOST, host: symfony.com } - - { path: ^/admin, roles: ROLE_USER_METHOD, methods: [POST, PUT] } - - { path: ^/admin, roles: ROLE_USER } - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - 'access_control' => array( - array('path' => '^/admin', 'role' => 'ROLE_USER_IP', 'ip' => '127.0.0.1'), - array('path' => '^/admin', 'role' => 'ROLE_USER_HOST', 'host' => 'symfony.com'), - array('path' => '^/admin', 'role' => 'ROLE_USER_METHOD', 'method' => 'POST, PUT'), - array('path' => '^/admin', 'role' => 'ROLE_USER'), - ), - -Para cada petición entrante, *Symfony* debe decidir cuál ``access_control`` utilizar basándose en la *URI*, la dirección *IP* del cliente, el nombre del servidor entrante, y el método de la petición. Recuerda, se usa la primera regla que coincida, y si para una entrada no se especifican ``ip``, ``host`` o ``method``, ese ``access_control`` emparejará con cualquier ``ip``, ``host`` o ``method``: - -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| **URI** | **IP** | **HOST** | **METHOD** | ``access_control`` | ¿Porqué? | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| ``/admin/user`` | 127.0.0.1 | example.com | GET | regla #1 (``ROLE_USER_IP``) | La *URI* empareja con ``path`` y la *IP* con ``ip``. | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| ``/admin/user`` | 127.0.0.1 | symfony.com | GET | regla #1 (``ROLE_USER_IP``) | ``path`` e ``ip`` todavía concuerdan. Esta además debería | -| | | | | | emparejar con la entrada ``ROLE_USER_HOST``, pero *sólo* si se | -| | | | | | usa el **primer** ``access_control`` coincidente. | -| | | | | | | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| ``/admin/user`` | 168.0.0.1 | symfony.com | GET | regla #2 (``ROLE_USER_HOST``) | La ``ip`` no concuerda con la primera regla, por lo tanto se | -| | | | | | usa la segunda regla (la cual concuerda). | -| | | | | | | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| ``/admin/user`` | 168.0.0.1 | symfony.com | POST | regla #2 (``ROLE_USER_HOST``) | La segunda regla todavía concuerda. Esta además debería | -| | | | | | emparejar con la tercera regla (``ROLE_USER_METHOD``), pero | -| | | | | | solo si se usa la **primer** ``access_control`` coincidente. | -| | | | | | | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| ``/admin/user`` | 168.0.0.1 | example.com | POST | regla #3 (``ROLE_USER_METHOD``)| La ``ip`` y ``host`` no concuerdan con las primeras dos | -| | | | | | entradas, pero la tercera ---``ROLE_USER_METHOD``--- concuerda | -| | | | | | y se usa. | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| ``/admin/user`` | 168.0.0.1 | example.com | GET | regla #4 (``ROLE_USER``) | La ``ip``, ``host`` y ``method`` evitan que las primeras tres | -| | | | | | entradas concuerden. Pero debido a que la *URI* concuerda con | -| | | | | | el patrón ``path`` de la entrada ``ROLE_USER``, esta se usa. | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ -| ``/foo`` | 127.0.0.1 | symfony.com | POST | no hay entradas concordantes | Esta no concuerda con ninguna regla ``access_control``, debido | -| | | | | | a que la *URI* no concuerda con los valores de ``path``. | -| | | | | | | -+-----------------+-------------+-------------+------------+--------------------------------+-----------------------------------------------------------------+ - -.. _security-book-access-control-enforcement-options: - -**(b) Forzando el acceso** - -Una vez que *Symfony2* ha decidido cuál entrada ``access_control`` concuerda (si la hay), entonces *aplica* las restricciones de acceso basándose en las opciones ``roles`` y ``requires_channel``: - -* ``role`` Si el usuario no tiene determinado rol o roles, entonces el acceso es denegado (internamente, se lanza una :class:`Symfony\\Component\\Security\\Core\\Exception\\AccessDeniedException`); - -* ``requires_channel`` Si el canal de la petición entrante (p. ej. ``http``) no concuerda con este valor (p. ej. ``https``), el usuario será redirigido (p. ej. redirigido de ``http`` a ``https``, o viceversa). - -.. tip:: - - Si el acceso es denegado, el sistema intentará autenticar al usuario si aún no lo está (p. ej. redirigiendo al usuario a la página de inicio de sesión). Si el usuario ya inició sesión, se mostrará la página del error 403 «acceso denegado». Consulta :doc:`/cookbook/controller/error_pages` para más información. - -.. _book-security-securing-ip: - -Protegiendo por *IP* -~~~~~~~~~~~~~~~~~~~~ - -En algunas situaciones puede surgir la necesidad de restringir el acceso a una determinada ruta basándose en la *IP*. Esto es importante particularmente en el caso de la :ref:`Inclusión del borde lateral ` (*ESI*), por ejemplo. Cuándo *ESI* está habilitada, es recomendable proteger el acceso a direcciones *URL* *ESI*. De hecho, algunas *ESI* pueden contener algo de contenido privado tal como la información del usuario actual. Para impedir cualquier acceso directo a estos recursos desde un navegador *web* (deduciendo el patrón *ESI* de la *URL*), la ruta *ESI* se **debe** asegurar para que únicamente sea visible desde la caché de un delegado inverso de confianza. - -Aquí tienes un ejemplo de cómo podrías proteger todas las rutas *ESI* que empiezan con un determinado prefijo, ``/esi``, para que no se accedan desde el exterior: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - # ... - access_control: - - { path: ^/esi, roles: IS_AUTHENTICATED_ANONYMOUSLY, ip: 127.0.0.1 } - - { path: ^/esi, roles: ROLE_NO_ACCESS } - - .. code-block:: xml - - - - - - - .. code-block:: php - - 'access_control' => array( - array('path' => '^/esi', 'role' => 'IS_AUTHENTICATED_ANONYMOUSLY', 'ip' => '127.0.0.1'), - array('path' => '^/esi', 'role' => 'ROLE_NO_ACCESS'), - ), - -Así es como trabaja cuándo la ruta es ``/esi/algo`` proveniente de la *IP* ``10.0.0.1``: - -* La primera regla del control de acceso es ignorada debido a que ``path`` concuerda pero la ``ip`` no; - -* La segunda regla de control de acceso se activa (la única restricción sigue siendo ``path`` y concuerda): Puesto que el usuario no puede tener el rol ``ROLE_NO_ACCESS`` cuando no está definido, el acceso es denegado (el rol ``ROLE_NO_ACCESS`` puede ser cualquier cosa que no empareje con un rol existente, solo sirve como un truco para negar el acceso siempre). - -Ahora, si la misma petición proviene de ``127.0.0.1``: - -* Ahora, se activa la primera regla del control de acceso porque ambas ``path`` e ``ip`` concuerdan: El acceso es permitido debido a que el usuario siempre tiene el rol ``IS_AUTHENTICATED_ANONYMOUSLY``. - -* La segunda regla de acceso no se examina debido a que la primera regla concordó. - -.. _book-security-securing-channel: - -Protegiendo por canal -~~~~~~~~~~~~~~~~~~~~~ - -También puedes requerir que un usuario acceda a una *URL* vía *SSL*; Sólo utiliza el argumento ``requires_channel`` en cualquier entrada del ``access_control``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - # ... - access_control: - - { path: ^/cart/checkout, roles: IS_AUTHENTICATED_ANONYMOUSLY, requires_channel: https } - - .. code-block:: xml - - - - - - .. code-block:: php - - 'access_control' => array( - array('path' => '^/cart/checkout', 'role' => 'IS_AUTHENTICATED_ANONYMOUSLY', 'requires_channel' => 'https'), - ), - -.. _book-security-securing-controller: - -Protegiendo un controlador -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Proteger tu aplicación basándote en los patrones *URL* es fácil, pero, en algunos casos, puede no estar suficientemente bien ajustado. Cuando sea necesario, fácilmente puedes forzar la autorización desde un controlador:: - - // ... - use Symfony\Component\Security\Core\Exception\AccessDeniedException; - - public function helloAction($name) - { - if (false === $this->get('security.context')->isGranted('ROLE_ADMIN')) { - throw new AccessDeniedException(); - } - - // ... - } - -.. _book-security-securing-controller-annotations: - -También puedes optar por instalar y utilizar el opcional ``JMSSecurityExtraBundle``, con el cual puedes asegurar tu controlador usando anotaciones:: - - // ... - use JMS\SecurityExtraBundle\Annotation\Secure; - - /** - * @Secure(roles="ROLE_ADMIN") - */ - public function helloAction($name) - { - // ... - } - -Para más información, consulta la documentación de `JMSSecurityExtraBundle`_. Si estás usando la distribución estándar de *Symfony*, este paquete está disponible de forma predeterminada. -Si no es así, lo puedes descargar e instalar. - -Protegiendo otros servicios -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -De hecho, en *Symfony* puedes proteger cualquier cosa utilizando una estrategia similar a la observada en la sección anterior. Por ejemplo, supongamos que tienes un servicio (es decir, una clase *PHP*), cuyo trabajo consiste en enviar mensajes de correo electrónico de un usuario a otro. -Puedes restringir el uso de esta clase ---no importa dónde se esté utilizando--- a los usuarios que tienen un rol específico. - -Para más información sobre cómo utilizar el componente de seguridad para proteger diferentes servicios y métodos en tu aplicación, consulta :doc:`/cookbook/security/securing_services`. - -Listas de control de acceso (*ACL*): Protegiendo objetos individuales de base de datos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Imagina que estás diseñando un sistema de *blog* donde los usuarios pueden comentar tus entradas. Ahora, deseas que un usuario pueda editar sus propios comentarios, pero no los de otros usuarios. Además, como usuario ``admin``, quieres tener la posibilidad de editar *todos* los comentarios. - -El componente de seguridad viene con un sistema opcional de lista de control de acceso (*ACL*) que puedes utilizar cuando sea necesario para controlar el acceso a instancias individuales de un objeto en el sistema. *Sin* *ACL*, puedes proteger tu sistema para que sólo determinados usuarios puedan editar los comentarios del *blog* en general. Pero *con* *ACL*, puedes restringir o permitir el acceso en base a comentario por comentario. - -Para más información, consulta el artículo del recetario: :doc:`/cookbook/security/acl`. - -Usuarios --------- - -En las secciones anteriores, aprendiste cómo puedes proteger diferentes recursos que requieren un conjunto de *roles* para un recurso. En esta sección vamos a explorar el otro lado de la autorización: los usuarios. - -¿De dónde provienen los usuarios? (*Proveedores de usuarios*) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Durante la autenticación, el usuario envía un conjunto de credenciales (por lo general un nombre de usuario y contraseña). El trabajo del sistema de autenticación es concordar esas credenciales contra una piscina de usuarios. Entonces, ¿de dónde viene esta lista de usuarios? - -En *Symfony2*, los usuarios pueden venir de cualquier parte ---un archivo de configuración, una tabla de base de datos, un servicio web, o cualquier otra cosa que se te ocurra. Todo lo que proporcione uno o más usuarios al sistema de autenticación se conoce como «proveedor de usuario». -*Symfony2* de serie viene con los dos proveedores de usuario más comunes: uno que carga los usuarios de un archivo de configuración y otro que carga usuarios de una tabla de la base de datos. - -Especificando usuarios en un archivo de configuración -..................................................... - -La forma más fácil para especificar usuarios es directamente en un archivo de configuración. -De hecho, ya lo has visto en algunos ejemplos de este capítulo. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - # ... - providers: - default_provider: - memory: - users: - ryan: { password: ryanpass, roles: 'ROLE_USER' } - admin: { password: kitten, roles: 'ROLE_ADMIN' } - - .. code-block:: xml - - - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - // ... - 'providers' => array( - 'default_provider' => array( - 'memory' => array( - 'users' => array( - 'ryan' => array('password' => 'ryanpass', 'roles' => 'ROLE_USER'), - 'admin' => array('password' => 'kitten', 'roles' => 'ROLE_ADMIN'), - ), - ), - ), - ), - )); - -Este proveedor de usuario se denomina proveedor de usuario «en memoria», ya que los usuarios no se almacenan en alguna parte de una base de datos. El objeto usuario en realidad lo proporciona *Symfony* (:class:`Symfony\\Component\\Security\\Core\\User\\User`). - -.. tip:: - Cualquier proveedor de usuario puede cargar usuarios directamente desde la configuración especificando el parámetro de configuración ``users`` y la lista de usuarios debajo de él. - -.. caution:: - - Si tu nombre de usuario es completamente numérico (por ejemplo, ``77``) o contiene un guión (por ejemplo, ``user-name``), debes utilizar la sintaxis alterna al especificar usuarios en *YAML*: - - .. code-block:: yaml - - users: - - { name: 77, password: pass, roles: 'ROLE_USER' } - - { name: user-name, password: pass, roles: 'ROLE_USER' } - -Para sitios pequeños, este método es rápido y fácil de configurar. Para sistemas más complejos, querrás cargar usuarios desde la base de datos. - -.. _book-security-user-entity: - -Cargando usuarios de la base de datos -..................................... - -Si deseas cargar tus usuarios a través del *ORM* de *Doctrine*, lo puedes hacer creando una clase ``User`` y configurando el proveedor ``entity``. - -.. tip:: - - Hay disponible un paquete de código abierto de alta calidad, el cual te permite almacenar tus usuarios a través del *ORM* u *ODM* de *Doctrine*. Lee más acerca del `FOSUserBundle`_ en *GitHub*. - -Con este enfoque, primero crea tu propia clase ``User``, la cual se almacenará en la base de datos. - -.. code-block:: php - - // src/Acme/UserBundle/Entity/User.php - namespace Acme\UserBundle\Entity; - - use Symfony\Component\Security\Core\User\UserInterface; - use Doctrine\ORM\Mapping as ORM; - - /** - * @ORM\Entity - */ - class User implements UserInterface - { - /** - * @ORM\Column(type="string", length=255) - */ - protected $username; - - // ... - } - -En cuanto al sistema de seguridad se refiere, el único requisito para tu clase Usuario personalizada es que implemente la interfaz :class:`Symfony\\Component\\Security\\Core\\User\\UserInterface`. Esto significa que el concepto de un «usuario» puede ser cualquier cosa, siempre y cuando implemente esta interfaz. - -.. versionadded:: 2.1 - En *Symfony* 2.1, se removió el método ``equals`` de la ``UserInterface``. - Si necesitas sustituir la implementación predeterminada de la lógica de comparación, implementa la nueva interfaz :class:`Symfony\\Component\\Security\\Core\\User\\EquatableInterface`. - -.. note:: - - El objeto ``User`` se debe serializar y guardar en la sesión entre peticiones, por lo tanto se recomienda que `implementes la interfaz \Serializable`_ en tu objeto que representa al usuario. Esto es especialmente importante si tu clase ``User`` tiene una clase padre con propiedades privadas. - -A continuación, configura una ``entidad`` proveedora de usuario, y apúntala a tu clase ``User``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - providers: - main: - entity: { class: Acme\UserBundle\Entity\User, property: username } - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'providers' => array( - 'main' => array( - 'entity' => array('class' => 'Acme\UserBundle\Entity\User', 'property' => 'username'), - ), - ), - )); - -Con la introducción de este nuevo proveedor, el sistema de autenticación intenta cargar un objeto ``User`` de la base de datos utilizando el campo ``username`` de esa clase. - -.. note:: - Este ejemplo sólo intenta mostrar la idea básica detrás del proveedor ``entity``. Para ver un ejemplo completo funcionando, consulta :doc:`/cookbook/security/entity_provider`. - -Para más información sobre cómo crear tu propio proveedor personalizado (por ejemplo, si necesitas cargar usuarios a través de un servicio *Web*), consulta :doc:`/cookbook/security/custom_provider`. - -.. _book-security-encoding-user-password: - -Codificando la contraseña del usuario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Hasta ahora, por simplicidad, todos los ejemplos tienen las contraseñas de los usuarios almacenadas en texto plano (si los usuarios se almacenan en un archivo de configuración o en alguna base de datos). Por supuesto, en una aplicación real, por razones de seguridad, desearás codificar las contraseñas de los usuarios. Esto se logra fácilmente asignando la clase Usuario a una de las varias integradas en ``encoders``. Por ejemplo, para almacenar los usuarios en memoria, pero ocultar sus contraseñas a través de ``sha1``, haz lo siguiente: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - # ... - providers: - in_memory: - memory: - users: - ryan: { password: bb87a29949f3a1ee0559f8a57357487151281386, roles: 'ROLE_USER' } - admin: { password: 74913f5cd5f61ec0bcfdb775414c2fb3d161b620, roles: 'ROLE_ADMIN' } - - encoders: - Symfony\Component\Security\Core\User\User: - algorithm: sha1 - iterations: 1 - encode_as_base64: false - - .. code-block:: xml - - - - - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - // ... - 'providers' => array( - 'in_memory' => array( - 'memory' => array( - 'users' => array( - 'ryan' => array('password' => 'bb87a29949f3a1ee0559f8a57357487151281386', 'roles' => 'ROLE_USER'), - 'admin' => array('password' => '74913f5cd5f61ec0bcfdb775414c2fb3d161b620', 'roles' => 'ROLE_ADMIN'), - ), - ), - ), - ), - 'encoders' => array( - 'Symfony\Component\Security\Core\User\User' => array( - 'algorithm' => 'sha1', - 'iterations' => 1, - 'encode_as_base64' => false, - ), - ), - )); - -Al establecer las ``iterations`` a ``1`` y ``encode_as_base64`` en ``false``, la contraseña simplemente se corre una vez a través del algoritmo ``sha1`` y sin ninguna codificación adicional. Ahora puedes calcular el ``hash`` de la contraseña mediante programación (por ejemplo, ``hash('sha1', 'ryanpass')``) o a través de alguna herramienta en línea como `functions-online.com`_ - -Si vas a crear tus usuarios dinámicamente (y almacenarlos en una base de datos), puedes utilizar algoritmos ``hash`` aún más difíciles y, luego confiar en un objeto codificador de clave real para ayudarte a codificar las contraseñas. Por ejemplo, supongamos que tu objeto usuario es ``Acme\UserBundle\Entity\User`` (como en el ejemplo anterior). Primero, configura el codificador para ese usuario: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - # ... - - encoders: - Acme\UserBundle\Entity\User: sha512 - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - // ... - 'encoders' => array( - 'Acme\UserBundle\Entity\User' => 'sha512', - ), - )); - -En este caso, estás utilizando el algoritmo ``SHA512`` fuerte. Además, puesto que hemos especificado simplemente el algoritmo (``sha512``) como una cadena, el sistema de manera predeterminada revuelve tu contraseña 5000 veces en una fila y luego la codifica como ``base64``. En otras palabras, la contraseña ha sido fuertemente ofuscada por lo tanto la contraseña revuelta no se puede decodificar (es decir, no se puede determinar la contraseña desde la contraseña ofuscada). - -.. versionadded:: 2.2 - A partir de *Symfony* 2.2 también puedes utilizar los codificadores de contraseña :ref:`PBKDF2 ` y :ref:`BCrypt `. - -Determinando la contraseña codificada -..................................... - -Si tienes algún formulario de registro para los usuarios, necesitas poder determinar el algoritmo de codificación utilizado en la contraseña, para que lo puedas usar en tu usuario. No importa qué algoritmo configures para tu objeto usuario, desde un controlador siempre puedes determinar el algoritmo de codificación de la contraseña de la siguiente manera:: - - $factory = $this->get('security.encoder_factory'); - $user = new Acme\UserBundle\Entity\User(); - - $encoder = $factory->getEncoder($user); - $password = $encoder->encodePassword('ryanpass', $user->getSalt()); - $user->setPassword($password); - -Recuperando el objeto usuario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Después de la autenticación, el objeto ``Usuario`` del usuario actual se puede acceder a través del servicio ``security.context``. Desde el interior de un controlador, este se verá así:: - - public function indexAction() - { - $user = $this->get('security.context')->getToken()->getUser(); - } - -En un controlador existe un atajo para esto: - -.. code-block:: php - - public function indexAction() - { - $user = $this->getUser(); - } - - -.. note:: - - Los usuarios anónimos técnicamente están autenticados, lo cual significa que el método ``isAuthenticated()`` de un objeto usuario anónimo devolverá ``true``. Para comprobar si el usuario está autenticado realmente, verifica el rol ``IS_AUTHENTICATED_FULLY``. - -En una plantilla *Twig* puedes acceder a este objeto a través de la clave ``app.user``, la cual llama al método :method:`GlobalVariables::getUser()`: - -.. configuration-block:: - - .. code-block:: html+jinja - -

Username: {{ app.user.username }}

- - .. code-block:: html+php - -

Username: getUser()->getUsername() ?>

- - -Usando múltiples proveedores de usuario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada mecanismo de autenticación (por ejemplo, la autenticación *HTTP*, formulario de acceso, etc.) utiliza exactamente un proveedor de usuario, y de forma predeterminada utilizará el primer proveedor de usuario declarado. Pero, si deseas especificar unos cuantos usuarios a través de la configuración y el resto de los usuarios en la base de datos? Esto es posible creando un nuevo proveedor que encadene los dos: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - providers: - chain_provider: - chain: - providers: [in_memory, user_db] - in_memory: - memory: - users: - foo: { password: test } - user_db: - entity: { class: Acme\UserBundle\Entity\User, property: username } - - .. code-block:: xml - - - - - - in_memory - user_db - - - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'providers' => array( - 'chain_provider' => array( - 'chain' => array( - 'providers' => array('in_memory', 'user_db'), - ), - ), - 'in_memory' => array( - 'memory' => array( - 'users' => array( - 'foo' => array('password' => 'test'), - ), - ), - ), - 'user_db' => array( - 'entity' => array('class' => 'Acme\UserBundle\Entity\User', 'property' => 'username'), - ), - ), - )); - -Ahora, todos los mecanismos de autenticación utilizan el ``chain_provider``, puesto que es el primero especificado. El ``chain_provider``, a su vez, intenta cargar el usuario, tanto el proveedor ``in_memory`` cómo ``USER_DB``. - -.. tip:: - - Si no tienes razones para separar a tus usuarios ``in_memory`` de tus usuarios ``user_db``, lo puedes hacer aún más fácil combinando las dos fuentes en un único proveedor: - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - providers: - main_provider: - memory: - users: - foo: { password: test } - entity: - class: Acme\UserBundle\Entity\User, - property: username - - .. code-block:: xml - - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'providers' => array( - 'main_provider' => array( - 'memory' => array( - 'users' => array( - 'foo' => array('password' => 'test'), - ), - ), - 'entity' => array('class' => 'Acme\UserBundle\Entity\User', 'property' => 'username'), - ), - ), - )); - -También puedes configurar el cortafuegos o mecanismos de autenticación individuales para utilizar un proveedor específico. Una vez más, a menos que explícitamente especifiques un proveedor, siempre se utiliza el primer proveedor: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - firewalls: - secured_area: - # ... - provider: user_db - http_basic: - realm: "Secured Demo Area" - provider: in_memory - form_login: ~ - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'firewalls' => array( - 'secured_area' => array( - // ... - 'provider' => 'user_db', - 'http_basic' => array( - // ... - 'provider' => 'in_memory', - ), - 'form_login' => array(), - ), - ), - )); - -En este ejemplo, si un usuario intenta acceder a través de autenticación *HTTP*, el sistema de autenticación debe utilizar el proveedor de usuario ``in_memory``. Pero si el usuario intenta acceder a través del formulario de acceso, utilizará el proveedor ``USER_DB`` (ya que es el valor predeterminado para el servidor de seguridad en su conjunto). - -Para más información acerca de los proveedores de usuario y la configuración del cortafuegos, consulta la :doc:`/reference/configuration/security`. - -Roles ------ - -La idea de un «rol» es clave para el proceso de autorización. Cada usuario tiene asignado un conjunto de roles y cada recurso requiere uno o más roles. Si el usuario tiene los roles necesarios, se le concede acceso. En caso contrario se deniega el acceso. - -Los roles son bastante simples, y básicamente son cadenas que puedes inventar y utilizar cuando sea necesario (aunque los roles son objetos internos). Por ejemplo, si necesitas comenzar a limitar el acceso a la sección ``admin`` del *blog* de tu sitio *web*, puedes proteger esa sección con un rol llamado ``ROLE_BLOG_ADMIN``. Este rol no necesita estar definido en ningún lugar ---puedes comenzar a usarlo. - -.. note:: - - Todos los roles **deben** comenzar con el prefijo ``ROLE_`` el cual será gestionado por *Symfony2*. Si defines tus propios roles con una clase ``Role`` dedicada (más avanzada), no utilices el prefijo ``ROLE_``. - -Roles jerárquicos -~~~~~~~~~~~~~~~~~ - -En lugar de asociar muchos roles a los usuarios, puedes definir reglas de herencia creando una jerarquía de roles: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - role_hierarchy: - ROLE_ADMIN: ROLE_USER - ROLE_SUPER_ADMIN: [ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH] - - .. code-block:: xml - - - - ROLE_USER - ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'role_hierarchy' => array( - 'ROLE_ADMIN' => 'ROLE_USER', - 'ROLE_SUPER_ADMIN' => array('ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH'), - ), - )); - -En la configuración anterior, los usuarios con rol ``ROLE_ADMIN`` también tendrán el rol de ``ROLE_USER``. El rol ``ROLE_SUPER_ADMIN`` tiene ``ROLE_ADMIN``, ``ROLE_ALLOWED_TO_SWITCH`` y ``ROLE_USER`` (heredado de ``ROLE_ADMIN``). - -Cerrando sesión ---------------- - -Por lo general, también quieres que tus usuarios puedan salir. Afortunadamente, el cortafuegos puede manejar esto automáticamente cuando activas el parámetro de configuración ``logout``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - firewalls: - secured_area: - # ... - logout: - path: /logout - target: / - # ... - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'firewalls' => array( - 'secured_area' => array( - // ... - 'logout' => array('path' => 'logout', 'target' => '/'), - ), - ), - // ... - )); - -Una vez lo hayas configurado en tu cortafuegos, enviar a un usuario a ``/logout`` (o cualquiera que sea tu ``path`` configurada), desautenticará al usuario actual. El usuario será enviado a la página de inicio (el valor definido por el parámetro ``target``). Ambos parámetros ``path`` y ``target`` por omisión se configuran a lo que esté especificado aquí. En otras palabras, a menos que necesites personalizarlos, los puedes omitir por completo y abreviar tu configuración: - -.. configuration-block:: - - .. code-block:: yaml - - logout: ~ - - .. code-block:: xml - - - - .. code-block:: php - - 'logout' => array(), - -Ten en cuenta que *no* es necesario implementar un controlador para la *URL* ``/logout`` porque el cortafuegos se encarga de todo. Sin embargo, posiblemente necesites crear una ruta para que la puedas utilizar para generar la *URL*: - -.. caution:: - - A partir de *Symfony 2.1* **debes** tener una ruta que corresponda a la ruta para cerrar la sesión. Sin esta ruta, el cierre de sesión no trabajará. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - logout: - path: /logout - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('logout', new Route('/logout', array())); - - return $collection; - -Una vez que el usuario ha cerrado la sesión, será redirigido a cualquier ruta definida por el parámetro ``target`` anterior (por ejemplo, la página ``principal``). Para más información sobre cómo configurar el cierre de sesión, consulta la :doc:`Referencia para afinar el sistema de seguridad `. - -.. _book-security-template: - -Controlando el acceso en plantillas ------------------------------------ - -Si dentro de una plantilla deseas comprobar si el usuario actual tiene un rol, utiliza la función ayudante incorporada: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% if is_granted('ROLE_ADMIN') %} - Delete - {% endif %} - - .. code-block:: html+php - - isGranted('ROLE_ADMIN')): ?> - Delete - - -.. note:: - - Si utilizas esta función y *no* estás en una *URL* donde haya un cortafuegos activo, se lanzará una excepción. Una vez más, casi siempre es buena idea tener un cortafuegos principal que cubra todas las *URL* (como hemos mostrado en este capítulo). - -Controlando el acceso en controladores --------------------------------------- - -Si deseas comprobar en tu controlador si el usuario actual tiene un rol, utiliza el método :method:`Symfony\\Component\\Security\\Core\\SecurityContext::isGranted` del contexto de seguridad:: - - public function indexAction() - { - // a los usuarios 'admin' les muestra diferente contenido - if ($this->get('security.context')->isGranted('ROLE_ADMIN')) { - // ... aquí carga el contenido 'admin' - } - - // ... aquí carga otro contenido regular - } - -.. note:: - - Debe haber un cortafuegos activo o al llamar al método ``isGranted`` se producirá una excepción. Ve la nota anterior acerca de las plantillas para más detalles. - -Suplantando a un usuario ------------------------- - -A veces, es útil poder cambiar de un usuario a otro sin tener que iniciar sesión de nuevo (por ejemplo, cuando depuras o tratas de entender un error que un usuario ve y que no se puede reproducir). Esto se puede hacer fácilmente activando el escucha ``switch_user`` del cortafuegos: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - firewalls: - main: - # ... - switch_user: true - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'firewalls' => array( - 'main'=> array( - // ... - 'switch_user' => true - ), - ), - )); - -Para cambiar a otro usuario, sólo tienes que añadir una cadena de consulta con el parámetro ``_switch_user`` y el nombre de usuario como el valor de la dirección actual: - -.. code-block:: text - - http://ejemplo.com/somewhere?_switch_user=thomas - -Para volver al usuario original, utiliza el nombre de usuario especial ``_exit``: - -.. code-block:: text - - http://ejemplo.com/somewhere?_switch_user=_exit - -Durante la suplantación, el usuario está provisto con una función de rol especial -llamada ``ROLE_PREVIOUS_ADMIN``. En una plantilla, por ejemplo, este rol se puede usar para mostrar un enlace para salir de la suplantación: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% if is_granted('ROLE_PREVIOUS_ADMIN') %} - Exit impersonation - {% endif %} - - .. code-block:: html+php - - isGranted('ROLE_PREVIOUS_ADMIN')): ?> - - Exit impersonation - - - -Por supuesto, esta función se debe poner a disposición de un pequeño grupo de usuarios. -De forma predeterminada, el acceso está restringido a usuarios que tienen el rol ``ROLE_ALLOWED_TO_SWITCH``. El nombre de esta función se puede modificar a través de la configuración ``role``. Para mayor seguridad, también puedes cambiar el nombre del parámetro de consulta a través de la configuración ``parameter``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - firewalls: - main: - # ... - switch_user: { role: ROLE_ADMIN, parameter: _want_to_be_this_user } - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'firewalls' => array( - 'main'=> array( - // ... - 'switch_user' => array('role' => 'ROLE_ADMIN', 'parameter' => '_want_to_be_this_user'), - ), - ), - )); - -Autenticación apátrida ----------------------- - -De forma predeterminada, *Symfony2* confía en una :dfn:`cookie` (la Sesión) para persistir el contexto de seguridad del usuario. Pero si utilizas certificados o autenticación *HTTP*, por ejemplo, la persistencia no es necesaria ya que están disponibles las credenciales para cada petición. En ese caso, y si no es necesario almacenar cualquier otra cosa entre peticiones, puedes activar la autenticación apátrida (lo cual significa que *Symfony2* jamás creará una :dfn:`cookie`): - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/security.yml - security: - firewalls: - main: - http_basic: ~ - stateless: true - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - // app/config/security.php - $container->loadFromExtension('security', array( - 'firewalls' => array( - 'main' => array('http_basic' => array(), 'stateless' => true), - ), - )); - -.. note:: - - Si utilizas un formulario de acceso, *Symfony2* creará una :dfn:`cookie`, incluso si estableces ``stateless`` a ``true``. - -Utilerías ---------- - -.. versionadded:: 2.2 - Las clases ``StringUtils`` y ``SecureRandom`` se añadieron en *Symfony 2.2* - -El componente de seguridad de *Symfony* viene con una colección de agradables utilidades relacionadas con la seguridad. Estas utilidades las usa *Symfony*, pero también las deberías utilizar si quieres solucionar los problemas a que están destinadas. - -Comparando cadenas -~~~~~~~~~~~~~~~~~~ - -El tiempo que tome comparar dos cadenas depende de sus diferencias. Este lo puede utilizar un atacante cuándo las dos cadenas representan una contraseña por ejemplo; Este se conoce como `Ataque temporizado`_. - -Internamente, al comparar dos contraseñas, *Symfony* utiliza un algoritmo de tiempo -constante; Puedes utilizar la misma estrategia en tu propio código gracias a la clase :class:`Symfony\\Component\\Security\\Core\\Util\\StringUtils`:: - - use Symfony\Component\Security\Core\Util\StringUtils; - - // ¿es igual la contraseña1 a la contraseña2? - $bool = StringUtils::equals($password1, $password2); - -Generando aleatoriamente un número seguro -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Siempre que necesites generar un número aleatorio seguro, te -animamos a utilizar la clase :class:`Symfony\\Component\\Security\\Core\\Util\\SecureRandom` de *Symfony*:: - - use Symfony\Component\Security\Core\Util\SecureRandom; - - $generator = new SecureRandom(); - $random = $generator->nextBytes(10); - -El método :method:`Symfony\\Component\\Security\\Core\\Util\\SecureRandom::nextBytes` -regresa una cadena aleatoria compuesta del número de caracteres pasados como argumento (10 en el ejemplo anterior). - -La clase *SecureRandom* trabaja mejor cuándo está instalado *OpenSSL* pero cuándo no -está disponible, recae en un algoritmo interno, el cual necesita un archivo de semilla -para trabajar correctamente. Sólo suministra un nombre de archivo para habilitarlo:: - - $generator = new SecureRandom('/alguna/ruta/para/guardar/la/semilla.txt'); - $random = $generator->nextBytes(10); - -.. note:: - - También puedes acceder a una instancia aleatoria segura directamente desde el contenedor de inyección de dependencias de *Symfony*; Su nombre es ``security.secure_random``. - -Palabras finales ----------------- - -La seguridad puede ser un tema profundo y complejo para resolverlo correctamente en tu aplicación. -Afortunadamente, el componente de seguridad de *Symfony* sigue un modelo de seguridad bien probado en torno a la *autenticación* y *autorización*. La autenticación, siempre sucede en primer lugar, está a cargo de un cortafuegos, cuyo trabajo es determinar la identidad del usuario a través de varios métodos diferentes (por ejemplo, la autenticación *HTTP*, formulario de acceso, etc.) En el recetario, encontrarás ejemplos de otros métodos para manejar la autenticación, incluyendo la manera de implementar una funcionalidad «recuérdame» por medio de :dfn:`cookie`. - -Una vez que un usuario se autentica, la capa de autorización puede determinar si el usuario debe tener acceso a un recurso específico. Por lo general, los *roles* se aplican a *URL*, clases o métodos y si el usuario actual no tiene ese rol, se le niega el acceso. La capa de autorización, sin embargo, es mucho más profunda, y sigue un sistema de «voto» para que varias partes puedan determinar si el usuario actual debe tener acceso a un determinado recurso. -Para saber más sobre este y otros temas busca en el recetario. - -Aprende más en el recetario ---------------------------- - -* :doc:`Forzando HTTP/HTTPS ` -* :doc:`Agregando usuarios a la lista negra por dirección IP con un votante personalizado ` -* :doc:`Listas de control de acceso (ACL) ` -* :doc:`/cookbook/security/remember_me` - -.. _`componente Security de Symfony`: https://github.com/symfony/Security -.. _`JMSSecurityExtraBundle`: http://gitnacho.github.com/symfony-docs-es/bundles/JMSSecurityExtraBundle/index.html -.. _`FOSUserBundle`: https://github.com/FriendsOfSymfony/FOSUserBundle -.. _`implementes la interfaz \Serializable`: http://www.php.net/manual/es/class.serializable.php -.. _`functions-online.com`: http://www.functions-online.com/sha1.html -.. _`Ataque temporizado`: http://en.wikipedia.org/wiki/Timing_attack diff --git a/_sources/book/service_container.txt b/_sources/book/service_container.txt deleted file mode 100644 index b4d43c6..0000000 --- a/_sources/book/service_container.txt +++ /dev/null @@ -1,750 +0,0 @@ -.. index:: - single: Contenedor de Servicios - single: Inyección de dependencias; Contenedor - -Contenedor de servicios -======================= - -Una aplicación *PHP* moderna está llena de objetos. Un objeto te puede facilitar la entrega de mensajes de correo electrónico, mientras que otro te puede permitir mantener información en una base de datos. En tu aplicación, puedes crear un objeto que gestione tu inventario de productos, y otro objeto que procese los datos de una *API* de terceros. El punto es que una aplicación moderna hace muchas cosas y está organizada en muchos objetos que se encargan de cada tarea. - -Este capítulo es sobre un objeto *PHP* especial en *Symfony2* que te ayuda a crear instancias, organizar y recuperar los muchos objetos de tu aplicación. -Este objeto, llamado contenedor de servicios, te permitirá estandarizar y centralizar la forma en que se construyen los objetos en tu aplicación. El contenedor te facilita la vida, es superveloz, y enfatiza una arquitectura que promueve el código reutilizable y disociado. Y debido a que todas las clases de *Symfony2* básicas usan el contenedor, aprenderás cómo ampliar, configurar y utilizar cualquier objeto en *Symfony2*. En gran parte, el contenedor de servicios es el mayor contribuyente a la velocidad y extensibilidad de *Symfony2*. - -Por último, configurar y usar el contenedor de servicios es fácil. Al final de este capítulo, te sentirás cómodo creando tus propios objetos y personalizando objetos de cualquier paquete de terceros a través del contenedor. Empezarás a escribir código más reutilizable, comprobable y disociado, simplemente porque el contenedor de servicios facilita la escritura de buen código. - -.. tip:: - - Si quieres conocer un poco más después de leer este capítulo, revisa la :doc:`Documentación del componente de inyección de dependencias `. - -.. index:: - single: Contenedor de servicios; ¿Qué es un servicio? - -¿Qué es un servicio? --------------------- - -En pocas palabras, un :term:`Servicio` es cualquier objeto *PHP* que realiza algún tipo de tarea «global». Es un nombre genérico que se utiliza a propósito en informática para describir un objeto creado para un propósito específico (por ejemplo, la entrega de mensajes de correo electrónico). Cada servicio se utiliza en toda tu aplicación cada vez que necesites la funcionalidad específica que proporciona. No tienes que hacer nada especial para hacer un servicio: simplemente escribe una clase *PHP* con algo de código que realice una tarea específica. ¡Felicidades, acabas de crear un servicio! - -.. note:: - - Por regla general, un objeto *PHP* es un servicio si se utiliza a nivel global en tu aplicación. Utilizamos un solo servicio ``Mailer`` a nivel global para enviar mensajes de correo electrónico mientras que muchos objetos ``Mensaje`` que este entrega **no** son servicios. Del mismo modo, un objeto ``Producto`` **no** es un servicio, pero un objeto que persiste objetos ``Producto`` a una base de datos **es** un servicio. - -Entonces, ¿cuál es la ventaja? La ventaja de pensar en «servicios» es que comienzas a pensar en la separación de cada parte de la funcionalidad de tu aplicación como una serie de servicios. Puesto que cada servicio se limita a un trabajo, puedes acceder fácilmente a cada servicio y usar su funcionalidad siempre que la necesites. Cada servicio también se puede probar y configurar muy fácilmente, ya que está separado de la otra funcionalidad de tu aplicación. Esta idea se llama `arquitectura orientada a servicios`_ y no es única de *Symfony2* e incluso de *PHP*. Estructurando tu aplicación en torno a un conjunto de clases *Servicio* independientes es una bien conocida y confiable práctica mejor orientada a objetos. Estas habilidades son clave para ser un buen desarrollador en casi cualquier lenguaje. - -.. index:: - single: Contenedor de servicios; ¿Qué es un contenedor de servicios? - -¿Qué es un contenedor de servicios? ------------------------ - -Un :term:`Contenedor de servicios` (o *contenedor de inyección de dependencias*) simplemente es un objeto *PHP* que gestiona la creación de instancias de servicios (es decir, objetos). - -Por ejemplo, supongamos que tienes una simple clase *PHP* que envía mensajes de correo electrónico. -Sin un contenedor de servicios, debes crear manualmente el objeto cada vez que lo necesites:: - - use Acme\HelloBundle\Mailer; - - $mailer = new Mailer('sendmail'); - $mailer->send('ryan@foobar.net', ...); - -Esto es bastante fácil. La clase imaginaria ``Mailer`` te permite configurar el método utilizado para entregar los mensajes de correo electrónico (por ejemplo, ``sendmail``, ``smtp``, etc.). -Pero, ¿si quisieras utilizar el servicio *mailer* en algún otro lugar? Desde luego, no quieres repetir la configuración del *mailer* cada vez que necesites utilizar el objeto ``Mailer``. Qué pasa si necesitas cambiar el ``transporte`` de ``sendmail`` a ``smtp`` en toda tu aplicación? Tendrías que cazar cada sitio en que creas un servicio ``Mailer`` y cambiarlo. - -.. index:: - single: Contenedor de servicios; Configurando servicios - -Creando/configurando servicios en el contenedor ------------------------------------------------ - -Una mejor respuesta es dejar que el contenedor de servicios cree el objeto ``Mailer`` para ti. Para que esto funcione, debes *enseñar* al contenedor cómo crear el servicio ``Mailer``. Esto se hace a través de configuración, la cual se puede especificar en *YAML*, *XML* o *PHP*: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - services: - my_mailer: - class: Acme\HelloBundle\Mailer - arguments: [sendmail] - - .. code-block:: xml - - - - - sendmail - - - - .. code-block:: php - - // app/config/config.php - use Symfony\Component\DependencyInjection\Definition; - - $container->setDefinition('my_mailer', new Definition( - 'Acme\HelloBundle\Mailer', - array('sendmail') - )); - -.. note:: - - Cuando se inicia, por omisión *Symfony2* construye el contenedor de servicios usando la configuración de (:file:`app/config/config.yml`). El archivo exacto que se carga es dictado por el método ``AppKernel::registerContainerConfiguration()``, el cual carga un archivo de configuración específico al entorno (por ejemplo, :file:`config_dev.yml` para el entorno ``dev`` o :file:`config_prod.yml` para ``prod``). - -Una instancia del objeto ``Acme\HelloBundle\Mailer`` ahora está disponible a través del contenedor de servicios. El contenedor está disponible en cualquier controlador tradicional de *Symfony2*, donde puedes acceder al servicio del contenedor a través del método ``get()``:: - - class HelloController extends Controller - { - // ... - - public function sendEmailAction() - { - // ... - $mailer = $this->get('my_mailer'); - $mailer->send('ryan@foobar.net', ...); - } - } - -Cuando solicites el servicio ``my_mailer`` desde el contenedor, el contenedor construye el objeto y te lo devuelve. Esta es otra de las principales ventajas de utilizar el contenedor de servicios. Es decir, un servicio *nunca* se construye hasta que es necesario. Si defines un servicio y no lo utilizas en una petición, el servicio no se crea. Esto ahorra memoria y aumenta la velocidad de tu aplicación. -Esto también significa que la sanción en rendimiento por definir muchos servicios es mínima o inexistente. Los servicios que nunca se usan nunca se construyen. - -Como bono adicional, el servicio ``Mailer`` se crea sólo una vez y esa misma instancia se vuelve a utilizar cada vez que solicites el servicio. Este es el comportamiento que ---casi siempre--- necesitarás (el cual es más flexible y potente), pero, más adelante aprenderás cómo puedes configurar un servicio que tiene varias instancias en el artículo «:doc:`/cookbook/service_container/scopes`» del recetario. - -.. _book-service-container-parameters: - -Parámetros del servicio ------------------------ - -La creación de nuevos servicios (es decir, objetos) a través del contenedor es bastante sencilla. Los parámetros provocan que al definir los servicios estén más organizados y sean más flexibles: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - parameters: - my_mailer.class: Acme\HelloBundle\Mailer - my_mailer.transport: sendmail - - services: - my_mailer: - class: "%my_mailer.class%" - arguments: ["%my_mailer.transport%"] - - .. code-block:: xml - - - - Acme\HelloBundle\Mailer - sendmail - - - - - %my_mailer.transport% - - - - .. code-block:: php - - // app/config/config.php - use Symfony\Component\DependencyInjection\Definition; - - $container->setParameter('my_mailer.class', 'Acme\HelloBundle\Mailer'); - $container->setParameter('my_mailer.transport', 'sendmail'); - - $container->setDefinition('my_mailer', new Definition( - '%my_mailer.class%', - array('%my_mailer.transport%') - )); - -El resultado final es exactamente el mismo que antes ---la diferencia sólo está en *cómo* defines el servicio---. Al rodear las cadenas ``my_mailer.class`` y ``my_mailer.transport`` entre signos de porcentaje (``%``), el contenedor sabe que tiene que buscar los parámetros con esos nombres. Cuando se construye el contenedor, este busca el valor de cada parámetro y lo utiliza en la definición del servicio. - -.. versionadded:: 2.1 - Escapar el carácter ``@`` en los valores de parámetros *YAML* es nuevo en *Symfony 2.1.9* y *Symfony 2.2.1*. - -.. note:: - - Si quieres utilizar una cadena que comience con un signo de ``@`` como valor del parámetro (es decir, una muy segura contraseña de correo) en un archivo *yaml*, necesitas escaparlo añadiendo otra ``@`` (Esto sólo aplica al formato *YAML*): - - .. code-block:: yaml - - # app/config/parameters.yml - parameters: - # Esto será analizado como la cadena "@clavesegura" - mailer_password: "@@clavesegura" - -.. note:: - - El signo de porcentaje en un parámetro o argumento, como parte de la cadena, se debe escapar con otro signo de porcentaje: - - .. code-block:: xml - - http://symfony.com/?foo=%%s&bar=%%d - -.. caution:: - - Puedes recibir una :class:`Symfony\\Component\\DependencyInjection\\Exception\\ScopeWideningInjectionException` al pasar el servicio ``request`` como argumento. Para entender este mejor problema y aprender cómo solucionarlo, consulta el artículo :doc:`/cookbook/service_container/scopes` en el recetario. - -El propósito de los parámetros es alimentar información a los servicios. Por supuesto, no hay nada malo en definir el servicio sin utilizar ningún parámetro. -Los parámetros, sin embargo, tienen varias ventajas: - -* Separan y organizan todo el servicio en «opciones» bajo una sola clave ``parameters``; - -* Los valores del parámetro se pueden utilizar en la definición de múltiples servicios; - -* Cuando creas un servicio en un paquete (mostrado en breve), el uso de parámetros facilita la personalización del servicio en tu aplicación. - -La opción de usar o no parámetros depende de ti. Los paquetes de terceros de alta calidad *siempre* usan parámetros, ya que producen servicios más configurables almacenados en el contenedor. Para los servicios de tu aplicación, sin embargo, posiblemente no necesites la flexibilidad de los parámetros. - -Arreglo de parámetros -~~~~~~~~~~~~~~~~~~~~~ - -Los parámetros también pueden contener arreglos como valores. Ve :ref:`component-di-parameters-array`. - -Importando la configuración de recursos desde otros contenedores ----------------------------------------------------------------- - -.. tip:: - - En esta sección, nos referiremos a los archivos de configuración de servicios como *recursos*. - Esto es para resaltar el hecho de que, si bien la mayoría de la configuración de recursos debe estar en archivos (por ejemplo, *YAML*, *XML*, *PHP*), *Symfony2* es tan flexible que la configuración se puede cargar desde cualquier lugar (por ejemplo, una base de datos e incluso a través de un servicio web externo). - -El contenedor de servicios se construye usando un recurso de configuración simple (:file:`app/config/config.yml` por omisión). Toda la configuración de otros servicios (incluido el núcleo de *Symfony2* y la configuración de paquetes de terceros) se debe importar desde el interior de este archivo de una u otra manera. Esto proporciona absoluta flexibilidad sobre los servicios en tu aplicación. - -La configuración externa de servicios se puede importar de dos diferentes maneras. La primera --- y el método más común--- es vía la directiva ``imports``. Más tarde, veremos el segundo método, el cual es el método más flexible y preferido -para importar la configuración de servicios desde paquetes de terceros. - -.. index:: - single: Contenedor de servicios; Imports - -.. _service-container-imports-directive: - -Importando configuración con ``imports`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Hasta ahora, has puesto tu definición del contenedor del servicios ``my_mailer`` directamente en el archivo de configuración de la aplicación (por ejemplo, :file:`app/config/config.yml`). Por supuesto, debido a que la clase ``Mailer`` vive dentro de ``AcmeHelloBundle``, también tiene más sentido poner la definición del contenedor de ``my_mailer`` en el paquete. - -En primer lugar, mueve la definición del contenedor de ``my_mailer`` a un nuevo archivo contenedor de recursos dentro de ``AcmeHelloBundle``. Si los directorios ``Resources`` y ``Resources/config`` no existen, créalos. - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/services.yml - parameters: - my_mailer.class: Acme\HelloBundle\Mailer - my_mailer.transport: sendmail - - services: - my_mailer: - class: "%my_mailer.class%" - arguments: ["%my_mailer.transport%"] - - .. code-block:: xml - - - - Acme\HelloBundle\Mailer - sendmail - - - - - %my_mailer.transport% - - - - .. code-block:: php - - // src/Acme/HelloBundle/Resources/config/services.php - use Symfony\Component\DependencyInjection\Definition; - - $container->setParameter('my_mailer.class', 'Acme\HelloBundle\Mailer'); - $container->setParameter('my_mailer.transport', 'sendmail'); - - $container->setDefinition('my_mailer', new Definition( - '%my_mailer.class%', - array('%my_mailer.transport%') - )); - -La propia definición no ha cambiado, sólo su ubicación. Por supuesto, el contenedor de servicios no sabe sobre el nuevo archivo de recursos. Afortunadamente, es fácil importar el archivo de recursos utilizando la clave ``imports`` en la configuración de la aplicación. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - imports: - - { resource: "@AcmeHelloBundle/Resources/config/services.yml" } - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $this->import('@AcmeHelloBundle/Resources/config/services.php'); - -La directiva ``imports`` permite a tu aplicación incluir recursos de configuración del contenedor de servicios desde cualquier otro lugar (comúnmente desde paquetes). -La ubicación de ``resources``, para archivos, es la ruta absoluta al archivo de recursos. La sintaxis especial ``@AcmeHello`` resuelve la ruta al directorio del paquete ``AcmeHelloBundle``. Esto te ayuda a especificar la ruta a los recursos sin tener que preocuparte más adelante de si se mueve el ``AcmeHelloBundle`` a un directorio diferente. - -.. index:: - single: Contenedor de servicios; Configuración de extensión - -.. _service-container-extension-configuration: - -Importando configuración vía el contenedor de extensiones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando desarrollas en *Symfony2*, comúnmente debes usar la directiva ``imports`` para importar la configuración del contenedor desde los paquetes que has creado específicamente para tu aplicación. La configuración del contenedor de paquetes de terceros, incluyendo los servicios básicos de *Symfony2*, normalmente se carga con cualquier otro método que sea más flexible y fácil de configurar en tu aplicación. - -Así es como funciona. Internamente, cada paquete define sus servicios de manera muy parecida a lo que has visto hasta ahora. Es decir, un paquete utiliza uno o más archivos de configuración de recursos (por lo general *XML*) para especificar los parámetros y servicios para ese paquete. Sin embargo, en lugar de importar cada uno de estos recursos directamente desde la configuración de tu aplicación utilizando la directiva ``imports``, sólo tienes que invocar una *extensión contenedora de servicios* dentro del paquete, la cual hace el trabajo por ti. Una extensión del contenedor de servicios es una clase *PHP* creada por el autor del paquete para lograr dos cosas: - -* Importar todos los recursos del contenedor de servicios necesarios para configurar los servicios del paquete; - -* Permitir una configuración semántica y directa para poder ajustar el paquete sin interactuar con los parámetros planos de configuración del paquete contenedor del servicio. - -En otras palabras, una extensión del contenedor de servicios configura los servicios para un paquete en tu nombre. Y como veremos en un momento, la extensión proporciona una interfaz sensible y de alto nivel para configurar el paquete. - -Tomemos el ``FrameworkBundle`` ---el núcleo de la plataforma *Symfony2*--- como ejemplo. La presencia del siguiente código en la configuración de tu aplicación invoca a la extensión ``FrameworkBundle`` en el interior del contenedor de servicios: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - secret: xxxxxxxxxx - form: true - csrf_protection: true - router: { resource: "%kernel.root_dir%/config/routing.yml" } - # ... - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - 'secret' => 'xxxxxxxxxx', - 'form' => array(), - 'csrf-protection' => array(), - 'router' => array('resource' => '%kernel.root_dir%/config/routing.php'), - - // ... - )); - -Cuando se analiza la configuración, el contenedor busca una extensión que pueda manejar la directiva de configuración ``framework``. La extensión en cuestión, que vive en el ``FrameworkBundle``, es invocada y cargada la configuración del servicio para el ``FrameworkBundle``. Si quitas por completo la clave ``framework`` del archivo de configuración de tu aplicación, no se cargarán los servicios básicos de *Symfony2*. El punto es que tú tienes el control: la plataforma *Symfony2* no contiene ningún tipo de magia ni realiza alguna acción en que tú no tengas el control. - -Por supuesto, puedes hacer mucho más sencilla la «activación» de la extensión ``FrameworkBundle`` en el contenedor de servicios. Cada extensión te permite personalizar fácilmente el paquete, sin tener que preocuparte acerca de cómo se definen los servicios internos. - -En este caso, la extensión te permite personalizar la configuración de ``error_handler``, ``csrf_protection``, ``router`` y mucho más. Internamente, el ``FrameworkBundle`` utiliza las opciones especificadas aquí para definir y configurar los servicios específicos del mismo. El paquete se encarga de crear todos los ``parámetros`` y ``servicios`` necesarios para el contenedor de servicios, mientras permite que la mayor parte de la configuración se pueda personalizar fácilmente. Como bono adicional, la mayoría de las extensiones del contenedor de servicios también son lo suficientemente inteligentes como para realizar la validación ---notificándote opciones omitidas o datos de tipo incorrecto. - -Al instalar o configurar un paquete, consulta la documentación del paquete sobre cómo se deben instalar y configurar sus servicios. Las opciones disponibles para los paquetes básicos se pueden encontrar dentro de la :doc:`Guía de Referencia `. - -.. note:: - - Nativamente, el contenedor de servicios sólo reconoce las directivas ``parameters``, ``services`` e ``imports``. Cualquier otra directiva es manejada por una extensión del contenedor de servicios. - -Si quieres exponer la configuración fácil en tus propios paquetes, lee -«:doc:`/cookbook/bundles/extension`» del recetario. - -.. index:: - single: Contenedor de servicios; Refiriendo servicios - -Refiriendo (inyectando) servicios ---------------------------------- - -Hasta el momento, nuestro servicio original ``my_mailer`` es simple: sólo toma un argumento en su constructor, el cual es fácilmente configurable. Como verás, el poder real del contenedor se lleva a cabo cuando es necesario crear un servicio que depende de uno o varios otros servicios en el contenedor. - -Por ejemplo, supongamos que tienes un nuevo servicio, ``NewsletterManager``, que ayuda a gestionar la preparación y entrega de un mensaje de correo electrónico a una colección de direcciones. Por supuesto el servicio ``my_mailer`` ciertamente ya es bueno en la entrega de mensajes de correo electrónico, así que lo usaremos dentro de ``NewsletterManager`` para manejar la entrega real de los mensajes. Se pretende que esta clase pudiera ser algo como esto:: - - // src/Acme/HelloBundle/Newsletter/NewsletterManager.php - namespace Acme\HelloBundle\Newsletter; - - use Acme\HelloBundle\Mailer; - - class NewsletterManager - { - protected $mailer; - - public function __construct(Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -Sin utilizar el contenedor de servicios, podemos crear un nuevo ``NewsletterManager`` muy fácilmente desde el interior de un controlador:: - - use Acme\HelloBundle\Newsletter\NewsletterManager; - - // ... - - public function sendNewsletterAction() - { - $mailer = $this->get('my_mailer'); - $newsletter = new NewsletterManager($mailer); - // ... - } - -Este enfoque está bien, pero, ¿si más adelante decides que la clase ``NewsletterManager`` necesita un segundo o tercer argumento constructor? ¿Y si decides reconstruir tu código y cambiar el nombre de la clase? En ambos casos, habría que encontrar todos los lugares donde se crea una instancia de ``NewsletterManager`` y modificarla. Por supuesto, el contenedor de servicios te da una opción mucho más atractiva: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/services.yml - parameters: - # ... - newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager - - services: - my_mailer: - # ... - newsletter_manager: - class: %newsletter_manager.class% - arguments: ["@my_mailer"] - - .. code-block:: xml - - - - - Acme\HelloBundle\Newsletter\NewsletterManager - - - - - - - - - - - - .. code-block:: php - - // src/Acme/HelloBundle/Resources/config/services.php - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter( - 'newsletter_manager.class', - 'Acme\HelloBundle\Newsletter\NewsletterManager' - ); - - $container->setDefinition('my_mailer', ...); - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%', - array(new Reference('my_mailer')) - )); - -En *YAML*, la sintaxis especial ``@my_mailer`` le dice al contenedor que busque un servicio llamado ``my_mailer`` y pase ese objeto al constructor de ``NewsletterManager``. En este caso, sin embargo, el servicio especificado ``my_mailer`` debe existir. Si no es así, lanzará una excepción. Puedes marcar tus dependencias como opcionales --- explicaremos esto en la siguiente sección. - -La utilización de referencias es una herramienta muy poderosa que te permite crear clases de servicios independientes con dependencias bien definidas. En este ejemplo, el servicio ``newsletter_manager`` necesita del servicio ``my_mailer`` para poder funcionar. Al definir esta dependencia en el contenedor de servicios, el contenedor se encarga de todo el trabajo de crear instancias de objetos. - -Dependencias opcionales: Inyección del definidor -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Inyectar dependencias en el constructor de esta manera es una excelente manera de asegurarte que la dependencia está disponible para usarla. Si tienes dependencias opcionales para una clase, entonces, la «inyección del definidor» puede ser una mejor opción. Esto significa inyectar la dependencia usando una llamada a método en lugar de a través del constructor. La clase se vería así:: - - namespace Acme\HelloBundle\Newsletter; - - use Acme\HelloBundle\Mailer; - - class NewsletterManager - { - protected $mailer; - - public function setMailer(Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -La inyección de la dependencia por medio del método definidor sólo necesita un cambio de sintaxis: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/services.yml - parameters: - # ... - newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager - - services: - my_mailer: - # ... - newsletter_manager: - class: %newsletter_manager.class% - calls: - - [setMailer, ["@my_mailer"]] - - .. code-block:: xml - - - - - Acme\HelloBundle\Newsletter\NewsletterManager - - - - - - - - - - - - - - .. code-block:: php - - // src/Acme/HelloBundle/Resources/config/services.php - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter( - 'newsletter_manager.class', - 'Acme\HelloBundle\Newsletter\NewsletterManager' - ); - - $container->setDefinition('my_mailer', ...); - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%' - ))->addMethodCall('setMailer', array( - new Reference('my_mailer'), - )); - -.. note:: - - Los enfoques presentados en esta sección se llaman «inyección de constructor» e «inyección de definidor». El contenedor de servicios de *Symfony2* también es compatible con la «inyección de propiedad». - -Haciendo que las referencias sean opcionales --------------------------------------------- - -A veces, uno de tus servicios puede tener una dependencia opcional, lo cual significa que la dependencia no es necesaria para que el servicio funcione correctamente. En el ejemplo anterior, el servicio ``my_mailer`` *debe* existir, si no, será lanzada una excepción. Al modificar la definición del servicio ``newsletter_manager``, puedes hacer opcional esta referencia. Entonces, el contenedor será inyectado si es que existe y no hace nada si no: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/services.yml - parameters: - # ... - - services: - newsletter_manager: - class: %newsletter_manager.class% - arguments: ["@?my_mailer"] - - .. code-block:: xml - - - - - - - - - - - - - .. code-block:: php - - // src/Acme/HelloBundle/Resources/config/services.php - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - use Symfony\Component\DependencyInjection\ContainerInterface; - - // ... - $container->setParameter( - 'newsletter_manager.class', - 'Acme\HelloBundle\Newsletter\NewsletterManager' - ); - - $container->setDefinition('my_mailer', ...); - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%', - array( - new Reference( - 'my_mailer', - ContainerInterface::IGNORE_ON_INVALID_REFERENCE - ) - ) - )); - -En *YAML*, la sintaxis especial ``@?`` le dice al contenedor de servicios que la dependencia es opcional. Por supuesto, también debes escribir ``NewsletterManager`` para que permita una dependencia opcional:: - - public function __construct(Mailer $mailer = null) - { - // ... - } - -El núcleo de *Symfony* y servicios en paquetes de terceros ----------------------------------------------------------- - -Puesto que *Symfony2* y todos los paquetes de terceros configuran y recuperan sus servicios a través del contenedor, puedes acceder fácilmente a ellos e incluso utilizarlos en tus propios servicios. Para mantener las cosas simples, de manera predeterminada *Symfony2* no requiere que los controladores se definan como servicios. Además *Symfony2* inyecta el contenedor de servicios completo en el controlador. Por ejemplo, para manejar el almacenamiento de información sobre la sesión de un usuario, *Symfony2* proporciona un servicio ``sesión``, al cual se puede acceder dentro de un controlador estándar de la siguiente manera:: - - public function indexAction($bar) - { - $session = $this->get('session'); - $session->set('foo', $bar); - - // ... - } - -En *Symfony2*, constantemente vas a utilizar los servicios prestados por el núcleo de *Symfony* o paquetes de terceros para realizar tareas como la reproducción de plantillas (``templating``), el envío de mensajes de correo electrónico (``mailer``), o para acceder a información sobre la petición. - -Puedes dar un paso más allá usando estos servicios dentro de los servicios que has creado para tu aplicación. Empieza modificando el ``NewsletterManager`` para usar el gestor de correo real de *Symfony2*, el servicio ``mailer`` (en vez del pretendido ``my_mailer``). -También vamos a pasar el servicio del motor de plantillas al ``NewsletterManager`` para que puedas generar el contenido del correo electrónico a través de una plantilla:: - - namespace Acme\HelloBundle\Newsletter; - - use Symfony\Component\Templating\EngineInterface; - - class NewsletterManager - { - protected $mailer; - - protected $templating; - - public function __construct(\Swift_Mailer $mailer, EngineInterface $templating) - { - $this->mailer = $mailer; - $this->templating = $templating; - } - - // ... - } - -Configurar el contenedor de servicios es fácil: - -.. configuration-block:: - - .. code-block:: yaml - - services: - newsletter_manager: - class: %newsletter_manager.class% - arguments: ["@mailer", "@templating"] - - .. code-block:: xml - - - - - - - .. code-block:: php - - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%', - array( - new Reference('mailer'), - new Reference('templating'), - ) - )); - -El servicio ``newsletter_manager`` ahora tiene acceso a los servicios del núcleo ``mailer`` y ``templating``. Esta es una forma común de crear servicios específicos para tu aplicación que aprovechan el poder de los distintos servicios en la plataforma. - -.. tip:: - - Asegúrate que la clave ``swiftmailer`` aparece en la configuración de tu aplicación. Como se mencionó en :ref:`service-container-extension-configuration`, la clave ``SwiftMailer`` invoca a la extensión de servicio desde el ``SwiftmailerBundle``, el cual registra el servicio ``mailer``. - -.. _book-service-container-tags: - -Etiquetas ---------- - -De la misma manera que en la *Web* una entrada de *blog* se puede etiquetar con cosas tales como *«Symfony»* o *«PHP»*, los servicios configurados en el contenedor también se pueden etiquetar. En el contenedor de servicios, una etiqueta implica que el servicio está destinado a usarse para un propósito específico. Tomemos el siguiente ejemplo: - -.. configuration-block:: - - .. code-block:: yaml - - services: - foo.twig.extension: - class: Acme\HelloBundle\Extension\FooExtension - tags: - - { name: twig.extension } - - .. code-block:: xml - - - - - - .. code-block:: php - - $definition = new Definition('Acme\HelloBundle\Extension\FooExtension'); - $definition->addTag('twig.extension'); - $container->setDefinition('foo.twig.extension', $definition); - -La etiqueta ``twig.extension`` es una etiqueta especial que ``TwigBundle`` usa -durante la configuración. Al dar al servicio esta etiqueta ``twig.extension``, el paquete sabe que el servicio ``foo.twig.extension`` se debe registrar como una extensión *Twig* con *Twig*. En otras palabras, *Twig* encuentra todos los servicios con la etiqueta ``twig.extension`` y automáticamente los registra como extensiones. - -Las etiquetas, entonces, son una manera de decirle a *Symfony2* u otros paquetes de terceros que el paquete se debe registrar o utilizar de alguna forma especial. - -La siguiente es una lista de etiquetas disponibles con los paquetes del núcleo de *Symfony2*. -Cada una de ellas tiene un efecto diferente en tu servicio y muchas etiquetas requieren argumentos adicionales (más allá de sólo el parámetro ``name``). - -Para una lista de todas las etiquetas disponibles en el núcleo de la plataforma *Symfony*, revisa las :doc:`/reference/dic_tags`. - -Depurando servicios -------------------- - -Puedes descubrir los servicios que están registrados con el contenedor utilizando la consola. Para mostrar todos los servicios y la clase de cada servicio, ejecuta: - -.. code-block:: bash - - $ php app/console container:debug - -De manera predefinida únicamente se muestran los servicios públicos, pero también puedes ver servicios privados: - -.. code-block:: bash - - $ php app/console container:debug --show-private - -Puedes conseguir información más detallada sobre un servicio particular especificando su id: - -.. code-block:: bash - - $ php app/console container:debug my_mailer - -Aprende más ------------ - -* :doc:`/components/dependency_injection/parameters` -* :doc:`/components/dependency_injection/compilation` -* :doc:`/components/dependency_injection/definitions` -* :doc:`/components/dependency_injection/factories` -* :doc:`/components/dependency_injection/parentservices` -* :doc:`/components/dependency_injection/tags` -* :doc:`/cookbook/controller/service` -* :doc:`/cookbook/service_container/scopes` -* :doc:`/cookbook/service_container/compiler_passes` -* :doc:`/components/dependency_injection/advanced` - -.. _`arquitectura orientada a servicios`: http://wikipedia.org/wiki/Service-oriented_architecture diff --git a/_sources/book/stable_api.txt b/_sources/book/stable_api.txt deleted file mode 100644 index 3110a9a..0000000 --- a/_sources/book/stable_api.txt +++ /dev/null @@ -1,40 +0,0 @@ -.. index:: - single: API estable - -*API* estable de *Symfony2* -=========================== - -La *API* estable de *Symfony2* es un subconjunto de todos los métodos públicos de *Symfony2* (componentes y paquetes básicos) que comparten las siguientes propiedades: - -* El espacio de nombres y nombre de la clase no van a cambiar; -* El nombre del método no va a cambiar; -* La firma del método (el tipo de los argumentos y del valor de retorno) no va a cambiar; -* La semántica de lo que hace el método no va a cambiar. - -Sin embargo, la imprementación en sí misma puede cambiar. El único caso válido para un cambio en la *API* estable es con el fin de corregir algún problema de seguridad. - -La *API* estable se basa en una lista blanca, marcada con ``@api``. Por lo tanto, todo lo no etiquetado explícitamente no es parte de la *API* estable. - -.. tip:: - - Cualquier paquete de terceros también deberá publicar su propia *API* estable. - -A partir de *Symfony 2.0*, los siguientes componentes tienen una *API* etiquetada pública: - -* BrowserKit -* ClassLoader -* Console -* CssSelector -* DependencyInjection -* DomCrawler -* EventDispatcher -* Finder -* HttpFoundation -* HttpKernel -* Locale -* Process -* Routing -* Templating -* Translation -* Validator -* Yaml diff --git a/_sources/book/templating.txt b/_sources/book/templating.txt deleted file mode 100644 index 83a5d0a..0000000 --- a/_sources/book/templating.txt +++ /dev/null @@ -1,1274 +0,0 @@ -.. index:: - single: Plantillas - -Creando y usando plantillas -=========================== - -Como sabes, el :doc:`Controlador ` es responsable de manejar cada petición entrante en una aplicación *Symfony2*. En realidad, el controlador delega la mayor parte del trabajo pesado ​​a otros lugares para que el código se pueda probar y volver a utilizar. Cuando un controlador necesita generar *HTML*, *CSS* o cualquier otro contenido, que maneje el trabajo fuera del motor de plantillas. -En este capítulo, aprenderás cómo escribir potentes plantillas que puedes utilizar para devolver contenido al usuario, rellenar el cuerpo de correo electrónico y mucho más. Aprenderás métodos abreviados, formas inteligentes para extender las plantillas y cómo reutilizar código de plantilla. - -.. note:: - - El tema de cómo reproducir plantillas se aborda en la página :ref:`controlador ` del libro. - - -.. index:: - single: Plantillas; ¿Qué es una plantilla? - -Plantillas ----------- - -Una plantilla simplemente es un archivo de texto que puede generar cualquier formato basado en texto (*HTML*, *XML*, *CSV*, *LaTeX*...). El tipo de plantilla más familiar es una plantilla *PHP* --- un archivo de texto interpretado por *PHP* que contiene una mezcla de texto y código *PHP*: - -.. code-block:: html+php - - - - - Welcome to Symfony! - - -

- - - - - -.. index:: Twig; Introducción - -Pero *Symfony2* contiene un lenguaje de plantillas aún más potente llamado `Twig`_. -*Twig* te permite escribir plantillas concisas y fáciles de leer que son más amigables para los diseñadores web y, de varias maneras, más poderosas que las plantillas *PHP*: - -.. code-block:: html+jinja - - - - - Welcome to Symfony! - - -

{{ page_title }}

- - - - - -*Twig* define dos tipos de sintaxis especial: - -* ``{{ ... }}``: «Dice algo»: imprime una variable o el resultado de una expresión a la plantilla; - -* ``{% ... %}``: «Hace algo»: una **etiqueta** que controla la lógica de la plantilla; se utiliza para declaraciones ``if`` y ejecutar bucles ``for``, por ejemplo. - -.. note:: - - Hay una tercer sintaxis utilizada para crear comentarios: ``{# esto es un comentario #}``. - Esta sintaxis se puede utilizar en múltiples líneas como la sintaxis ``/* comentario */`` equivalente de *PHP*. - -*Twig* también contiene **filtros**, los cuales modifican el contenido antes de reproducirlo. -El siguiente fragmento convierte a mayúsculas la variable ``title`` antes de reproducirla: - -.. code-block:: jinja - - {{ title|upper }} - -*Twig* viene con una larga lista de `etiquetas`_ y `filtros`_ que están disponibles de forma predeterminada. Incluso puedes `agregar tus propias extensiones`_ a *Twig*, según sea necesario. - -.. tip:: - - Registrar una extensión *Twig* es tan fácil como crear un nuevo servicio y etiquetarlo con :ref:`twig.extension `. - -Como verás a través de la documentación, *Twig* también es compatible con funciones y fácilmente puedes añadir nuevas. Por ejemplo, la siguiente función, utiliza una etiqueta ``for`` estándar y la función ``cycle`` para imprimir diez etiquetas ``div``, alternando entre clases ``par`` e ``impar``: - -.. code-block:: html+jinja - - {% for i in 0..10 %} -
- -
- {% endfor %} - -A lo largo de este capítulo, mostraremos las plantillas de ejemplo en ambos formatos *Twig* y *PHP*. - -.. tip:: - - Si *decides* no utilizar *Twig* y lo desactivas, tendrás que implementar tu propio controlador de excepciones a través del evento ``kernel.exception``. - -.. sidebar:: ¿Porqué *Twig*? - - Las plantillas *Twig* están destinadas a ser simples y no procesar etiquetas *PHP*. Esto es por diseño: el sistema de plantillas *Twig* está destinado a expresar la presentación, no la lógica del programa. Cuanto más utilices *Twig*, más apreciarás y te beneficiarás de esta distinción. Y, por supuesto, todos los diseñadores web las amarán. - - *Twig* también puede hacer cosas que *PHP* no puede, como controlar el espacio en blanco, cuenta con un recinto de seguridad, escape de salida automático y contextual e incluye funciones personalizadas y filtros que sólo afectan a las plantillas. *Twig* contiene pequeñas características que facilitan la escritura de plantillas y estas son más concisas. Tomemos el siguiente ejemplo, el cual combina un bucle con una declaración ``if`` lógica: - - .. code-block:: html+jinja - -
    - {% for user in users if user.active %} -
  • {{ user.username }}
    • - {% else %} -
  • No users found
    • - {% endfor %} -
- -.. index:: - pair: Twig; Caché - -Guardando en caché plantillas *Twig* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Twig* es rápido. Cada plantilla *Twig* se compila hasta una clase *PHP* nativa que se reproduce en tiempo de ejecución. Las clases compiladas se encuentran en el directorio ``app/cache/{entorno}/twig`` (donde ``{entorno}`` es el entorno, tal como ``dev`` o ``prod``) y, en algunos casos, pueden ser útiles mientras depuras. Consulta la sección :ref:`environments-summary` para más información sobre los entornos. - -Cuando está habilitado el modo ``debug`` (comúnmente en el entorno ``dev``) al realizar cambios a una plantilla *Twig*, esta se vuelve a compilar automáticamente. Esto significa que durante el desarrollo, felizmente, puedes realizar cambios en una plantilla *Twig* e inmediatamente ver las modificaciones sin tener que preocuparte de limpiar ninguna caché. - -Cuando el modo ``debug`` está desactivado (comúnmente en el entorno ``prod``), sin embargo, debes borrar el directorio de caché para regenerar las plantillas. Recuerda hacer esto al desplegar tu aplicación. - -.. index:: - single: Plantillas; Herencia - -Plantillas, herencia y diseño ------------------------------ - -A menudo, las plantillas en un proyecto comparten elementos comunes, como el encabezado, pie de página, barra lateral o más. En *Symfony2*, nos gusta pensar en este problema de forma diferente: una plantilla se puede decorar con otra. Esto funciona exactamente igual que las clases *PHP*: la herencia de plantillas nos permite crear un «diseño» de plantilla base que contiene todos los elementos comunes de tu sitio definidos como **bloques** (piensa en «clases *PHP* con métodos base»). Una plantilla hija puede extender el diseño base y reemplazar cualquiera de sus bloques (piensa en las «subclases *PHP* que sustituyen determinados métodos de su clase padre»). - -En primer lugar, crea un archivo con tu diseño base: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# app/Resources/views/base.html.twig #} - - - - - {% block title %}Test Application{% endblock %} - - - - -
- {% block body %}{% endblock %} -
- - - - .. code-block:: html+php - - - - - - - <?php $view['slots']->output('title', 'Test Application') ?> - - - - -
- output('body') ?> -
- - - -.. note:: - - Aunque la explicación sobre la herencia de plantillas será en términos de *Twig*, la filosofía es la misma entre plantillas *Twig* y *PHP*. - -Esta plantilla define el esqueleto del documento *HTML* base de una simple página de dos columnas. En este ejemplo, se definen tres áreas ``{% block %}`` (``title``, ``sidebar`` y ``body``). Una plantilla hija puede sustituir cada uno de los bloques o dejarlos con su implementación predeterminada. Esta plantilla también se podría reproducir directamente. En este caso, los bloques ``title``, ``sidebar`` y ``body`` simplemente mantienen los valores predeterminados usados en esta plantilla. - -Una plantilla hija podría tener este aspecto: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/BlogBundle/Resources/views/Blog/index.html.twig #} - {% extends '::base.html.twig' %} - - {% block title %}My cool blog posts{% endblock %} - - {% block body %} - {% for entry in blog_entries %} -

{{ entry.title }}

-

{{ entry.body }}

- {% endfor %} - {% endblock %} - - .. code-block:: html+php - - - extend('::base.html.php') ?> - - set('title', 'My cool blog posts') ?> - - start('body') ?> - -

getTitle() ?>

-

getBody() ?>

- - stop() ?> - -.. note:: - - La plantilla padre se identifica mediante una sintaxis de cadena especial (``::base.html.twig``) la cual indica que la plantilla vive en el directorio ``app/Resources/views`` del proyecto. Esta convención de nomenclatura se explica completamente en :ref:`template-naming-locations`. - -La clave para la herencia de plantillas es la etiqueta ``{% extends %}``. Esta le indica al motor de plantillas que primero evalúe la plantilla base, la cual establece el diseño y define varios bloques. Luego reproduce la plantilla hija, en ese momento, los bloques ``title`` y ``body`` del padre son reemplazados por los de la hija. Dependiendo del valor de ``blog_entries``, el resultado sería algo como esto: - -.. code-block:: html - - - - - - My cool blog posts - - - - -
-

My first post

-

The body of the first post.

- -

Another post

-

The body of the second post.

-
- - - -Ten en cuenta que como en la plantilla hija no has definido un bloque ``sidebar``, en su lugar, se utiliza el valor de la plantilla padre. Una plantilla padre, de forma predeterminada, siempre utiliza una etiqueta ``{% block %}`` para el contenido. - -Puedes utilizar tantos niveles de herencia como quieras. En la siguiente sección, explicaremos un modelo común de tres niveles de herencia junto con la forma en que se organizan las plantillas dentro de un proyecto *Symfony2*. - -Cuando trabajes con la herencia de plantillas, ten en cuenta los siguientes consejos: - -* Si utilizas ``{% extends %}`` en una plantilla, esta debe ser la primer etiqueta en esa plantilla; - -* Mientras más etiquetas ``{% block %}`` tengas en tu plantilla base, mejor. - Recuerda, las plantillas hijas no tienen que definir todos los bloques de los padres, por lo tanto crea tantos bloques en tus plantillas base como desees y dale a cada uno un razonable valor predeterminado. Mientras más bloques tengan tus plantillas base, más flexible será tu diseño; - -* Si te encuentras duplicando contenido en una serie de plantillas, muy probablemente significa que debes mover el contenido a un ``{% block %}`` en una plantilla padre. - En algunos casos, una mejor solución podría ser mover el contenido a una nueva plantilla e incluirla con ``include`` (consulta :ref:`incluyendo-plantillas`); - -* Si necesitas conseguir el contenido de un bloque desde la plantilla padre, puedes usar la función ``{{ parent() }}``. Esta es útil si deseas añadir algo al contenido de un bloque padre en vez de reemplazarlo por completo: - - .. code-block:: html+jinja - - {% block sidebar %} -

Table of Contents

- - {# ... #} - - {{ parent() }} - {% endblock %} - -.. index:: - single: Plantillas; Convenciones de nomenclatura - single: Plantillas; Ubicación de archivos - -.. _template-naming-locations: - -Nomenclatura y ubicación de plantillas --------------------------------------- - -.. versionadded:: 2.2 - El soporte necesario para rutas en el espacio de nombres se añadió en 2.2, permitiendo nombres de plantilla tal como ``@AcmeDemo/layout.html.twig``. Consulta :doc:`/cookbook/templating/namespaced_paths` para más detalles. - -De forma predeterminada, las plantillas pueden vivir en dos diferentes lugares: - -* ``app/Resources/views/``: El directorio de las ``vistas`` de la aplicación puede contener todas las plantillas base de la aplicación (es decir, los diseños de tu aplicación), así como plantillas que sustituyen a plantillas de paquetes (consulta :ref:`overriding-bundle-templates`); - -* ``ruta/al/paquete/Resources/views/`` Cada paquete contiene sus plantillas en su directorio (y subdirectorios) ``Resources/views``. La mayoría de las plantillas viven dentro de un paquete. - -*Symfony2* utiliza una sintaxis de cadena **paquete**:**controlador**:**plantilla** para las plantillas. Esto permite diferentes tipos de plantilla, dónde cada una vive en un lugar específico: - -* ``AcmeBlogBundle:Blog:index.html.twig``: Esta sintaxis se utiliza para especificar una plantilla para una página específica. Las tres partes de la cadena, cada una separada por dos puntos (``:``), significan lo siguiente: - - * ``AcmeBlogBundle``: (*paquete*) la plantilla vive dentro de :dfn:`AcmeBlogBundle` (por ejemplo, :file:`src/Acme/BlogBundle`); - - * ``Blog``: (*controlador*) indica que la plantilla vive dentro del subdirectorio ``Blog`` de ``Resources/views``; - - * ``index.html.twig``: (*plantilla*) el nombre real del archivo es ``index.html.twig``. - - Suponiendo que :dfn:`AcmeBlogBundle` vive en :file:`src/Acme/BlogBundle`, la ruta final para el diseño debería ser :file:`src/Acme/BlogBundle/Resources/views/Blog/index.html.twig`. - -* ``AcmeBlogBundle::layout.html.twig``: Esta sintaxis se refiere a una plantilla base que es específica para ``AcmeBlogBundle``. Puesto que falta la porción central, «controlador» (por ejemplo, ``Blog``), la plantilla vive en ``Resources/views/layout.html.twig`` dentro de ``AcmeBlogBundle``. - -* ``::base.html.twig``: Esta sintaxis se refiere a una plantilla o diseño base de la aplicación. Observa que la cadena comienza con dobles dos puntos (``::``), lo cual significa que faltan ambas porciones *paquete* y *controlador*. Esto quiere decir que la plantilla no se encuentra en ningún paquete, sino en el directorio raíz de la aplicación ``app/Resources/views/``. - -En la sección :ref:`overriding-bundle-templates`, encontrarás cómo puedes sustituir cada plantilla que vive dentro de ``AcmeBlogBundle``, por ejemplo, colocando una plantilla del mismo nombre en el directorio ``app/Resources/AcmeBlog/views/``. Esto nos da el poder para sustituir plantillas de cualquier paquete de terceros. - -.. tip:: - - Esperemos que la sintaxis de nomenclatura de plantilla te resulte familiar ---es la misma convención de nomenclatura utilizada para referirse al :ref:`controller-string-syntax`. - -Sufijo de plantilla -~~~~~~~~~~~~~~~~~~~ - -El formato **paquete**:**controlador**:**plantilla** de cada plantilla, especifica *dónde* se encuentra el archivo de plantilla. Cada nombre de plantilla también cuenta con dos extensiones que especifican el *formato* y *motor* de esa plantilla. - -* **AcmeBlogBundle:Blog:index.html.twig** --- formato *HTML*, motor *Twig* - -* **AcmeBlogBundle:Blog:index.html.php** --- formato *HTML*, motor *PHP* - -* **AcmeBlogBundle:Blog:index.css.twig** --- formato *CSS*, motor *Twig* - -De forma predeterminada, cualquier plantilla *Symfony2* se puede escribir en *Twig* o *PHP*, y la última parte de la extensión (por ejemplo :file:`.twig` o :file:`.php`) especifica cuál de los dos *motores* se debe utilizar. La primera parte de la extensión, (por ejemplo :file:`.html`, :file:`.css`, etc.) es el formato final que la plantilla debe generar. A diferencia del motor, el cual determina cómo procesa *Symfony2* la plantilla, esta simplemente es una táctica de organización utilizada en caso de que el mismo recurso se tenga que reproducir como *HTML* (``index.html.twig``), *XML* (``index.xml.twig``), o cualquier otro formato. Para más información, lee la sección :ref:`template-formats`. - -.. note:: - - Los «motores» disponibles se pueden configurar e incluso agregar nuevos motores. - Consulta :ref:`Configuración de plantillas ` para más detalles. - -.. index:: - single: Plantillas; Etiquetas y ayudantes - single: Plantillas; Ayudantes - -Etiquetas y ayudantes ---------------------- - -Ya entendiste los conceptos básicos de las plantillas, cómo son denominadas y cómo utilizar la herencia en plantillas. Las partes más difíciles ya quedaron atrás. En esta sección, aprenderás acerca de un amplio grupo de herramientas disponibles para ayudarte a realizar las tareas de plantilla más comunes, como la inclusión de otras plantillas, enlazar páginas e incluir imágenes. - -*Symfony2* viene con varias etiquetas *Twig* especializadas y funciones que facilitan la labor del diseñador de la plantilla. En *PHP*, el sistema de plantillas extensible ofrece un sistema de *ayudantes* que proporciona funciones útiles en el contexto de la plantilla. - -Ya hemos visto algunas etiquetas integradas en *Twig* (``{% block %}`` y ``{% extends %}``), así como un ejemplo de un ayudante *PHP* (consulta ``$view['slot']``). Aquí aprenderás un poco más. - -.. index:: - single: Plantillas; Incluyendo otras plantillas - -.. _incluyendo-plantillas: - -Incluyendo otras plantillas -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A menudo querrás incluir la misma plantilla o fragmento de código en varias páginas diferentes. Por ejemplo, en una aplicación con «artículos de noticias», el código de la plantilla que muestra un artículo se puede utilizar en la página de detalles del artículo, en una página que muestra los artículos más populares, o en una lista de los artículos más recientes. - -Cuando necesitas volver a utilizar un trozo de código *PHP*, normalmente mueves el código a una nueva clase o función *PHP*. Lo mismo es cierto para las plantillas. Al mover el código de la plantilla a su propia plantilla, este se puede incluir en cualquier otra plantilla. En primer lugar, crea la plantilla que tendrás que volver a usar. - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/ArticleBundle/Resources/views/Article/articleDetails.html.twig #} -

{{ article.title }}

-

by {{ article.authorName }}

- -

- {{ article.body }} -

- - .. code-block:: html+php - - -

getTitle() ?>

-

by getAuthorName() ?>

- -

- getBody() ?> -

- -Incluir esta plantilla en cualquier otra plantilla es sencillo: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/ArticleBundle/Resources/views/Article/list.html.twig #} - {% extends 'AcmeArticleBundle::layout.html.twig' %} - - {% block body %} -

Recent Articles

- - {% for article in articles %} - {{ include('AcmeArticleBundle:Article:articleDetails.html.twig', {'article': article}) }} - {% endfor %} - {% endblock %} - - .. code-block:: html+php - - - extend('AcmeArticleBundle::layout.html.php') ?> - - start('body') ?> -

Recent Articles

- - - render( - 'AcmeArticleBundle:Article:articleDetails.html.php', - array('article' => $article) - ) ?> - - stop() ?> - -La plantilla se incluye utilizando la función ``{{ include() }}``. Observa que el nombre de la plantilla sigue la misma convención típica. La plantilla ``articleDetails.html.twig`` utiliza una variable ``article``. Esta es proporcionada por la plantilla ``list.html.twig`` utilizando la orden ``with``. - -.. tip:: - - ``{'article': article}`` es la sintaxis de asignación estándar de *Twig* (es decir, un arreglo con claves nombradas). Si tuviéramos que pasar varios elementos, se vería así: ``{'foo': foo, 'bar': bar}``. - -.. versionadded:: 2.2 - La función ``include()`` es una nueva característica de *Twig* que está disponible en *Symfony 2.2*. Anteriormente se utilizaba la etiqueta ``{% include %}``. - -.. index:: - single: Plantillas; Integrando acción - -.. _templating-embedding-controller: - -Integrando controladores -~~~~~~~~~~~~~~~~~~~~~~~~ - -En algunos casos, es necesario hacer algo más que incluir una simple plantilla. Supongamos que en tu diseño tienes una barra lateral, la cual contiene los tres artículos más recientes. -Recuperar los tres artículos puede incluir consultar la base de datos o realizar otra pesada lógica ​​que no se puede hacer desde dentro de una plantilla. - -La solución es simplemente insertar el resultado de un controlador en tu plantilla entera. En primer lugar, crea un controlador que reproduzca una cierta cantidad de artículos recientes:: - - // src/Acme/ArticleBundle/Controller/ArticleController.php - class ArticleController extends Controller - { - public function recentArticlesAction($max = 3) - { - // hace una llamada a la base de datos u otra lógica - // para obtener los "$max" artículos más recientes - $articles = ...; - - return $this->render( - 'AcmeArticleBundle:Article:recentList.html.twig', - array('articles' => $articles) - ); - } - } - -La plantilla ``recentList`` es perfectamente clara: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig #} - {% for article in articles %} - - {{ article.title }} - - {% endfor %} - - .. code-block:: html+php - - - - - getTitle() ?> - - - -.. note:: - - Ten en cuenta que la *URL* del artículo está directamente en el código en este ejemplo - (p. ej. ``/article/*slug*``). Esta es una mala práctica. En la siguiente sección, aprenderás cómo hacer esto correctamente. - -Para incluir el controlador, tendrás que referirte a él utilizando la sintaxis de cadena estándar para controladores (es decir, **paquete**:**controlador**:**acción**): - -.. configuration-block:: - - .. code-block:: html+jinja - - {# app/Resources/views/base.html.twig #} - - {# ... #} - - - .. code-block:: html+php - - - - - - -Cada vez que te encuentres necesitando una variable o una pieza de información a la que una plantilla no tiene acceso, considera reproducir un controlador. -Los controladores se ejecutan rápidamente y promueven la buena organización y reutilización de código. - -Contenido asíncrono con ``hinclude.js`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - La compatibilidad con :file:`hinclude.js` se añadió en *Symfony 2.1* - -Los controladores se pueden incorporar asincrónicamente usando la biblioteca *JavaScript* `hinclude.js`_. -Debido a que el contenido integrado proviene de otra página (o controlador para el caso), *Symfony2* utiliza el ayudante ``render`` estándar para configurar las etiquetas ``hinclude``: - -.. configuration-block:: - - .. code-block:: jinja - - {% render url('...') with {}, {'standalone': 'js'} %} - - .. code-block:: php - - render( - new ControllerReference('...'), - array('renderer' => 'hinclude') - ) ?> - - render( - $view['router']->generate('...'), - array('renderer' => 'hinclude') - ) ?> - -.. note:: - - Para que trabaje, debes incluir `hinclude.js`_ en tu página. - -.. note:: - - Al utilizar un controlador en vez de una *URL*, debes habilitar la configuración de ``fragmentos`` de *Symfony*: - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - # ... - fragments: { path: /_fragment } - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - // ... - 'fragments' => array('path' => '/_fragment'), - )); - -Puedes especificar globalmente el contenido predeterminado (al cargar o si *JavaScript* está desactivado) en la configuración de tu aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - # ... - templating: - hinclude_default_template: AcmeDemoBundle::hinclude.html.twig - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - // ... - 'templating' => array( - 'hinclude_default_template' => array('AcmeDemoBundle::hinclude.html.twig'), - ), - )); - -.. versionadded:: 2.2 - Las plantillas ``default`` para la función ``render`` se añadieron en *Symfony 2.2* - -Puedes definir plantillas ``default`` para la función ``render`` (lo cuál sustituye cualquier plantilla ``default`` global que esté definida): - -.. configuration-block:: - - .. code-block:: jinja - - {{ render_hinclude(controller('...'), {'default': 'AcmeDemoBundle:Default:content.html.twig'}) }} - - .. code-block:: php - - render( - new ControllerReference('...'), - array( - 'renderer' => 'hinclude', - 'default' => 'AcmeDemoBundle:Default:content.html.twig', - ) - ) ?> - -O puedes especificar además, una cadena que se mostrará como el contenido predefinido: - -.. configuration-block:: - - .. code-block:: jinja - - {{ render_hinclude(controller('...'), {'default': 'Loading...'}) }} - - .. code-block:: php - - render( - new ControllerReference('...'), - array( - 'renderer' => 'hinclude', - 'default' => 'Loading...', - ) - ) ?> - -.. index:: - single: Plantillas; Enlazando páginas - -.. _book-templating-pages: - -Enlazando páginas -~~~~~~~~~~~~~~~~~ - -La creación de enlaces a otras páginas en tu aplicación es uno de los trabajos más comunes de una plantilla. En lugar de codificar las *URL* en las plantillas, utiliza la función ``path`` de *Twig* (o el ayudante ``router`` en *PHP*) para generar *URL* basadas en la configuración de enrutado. Más tarde, si deseas modificar la *URL* de una página en particular, todo lo que tienes que hacer es cambiar la configuración de enrutado; las plantillas automáticamente generarán la nueva *URL*. - -En primer lugar, crea el enlace a la página ``«_welcome»``, la cual es accesible a través de la siguiente configuración de enrutado: - -.. configuration-block:: - - .. code-block:: yaml - - _welcome: - path: / - defaults: { _controller: AcmeDemoBundle:Welcome:index } - - .. code-block:: xml - - - AcmeDemoBundle:Welcome:index - - - .. code-block:: php - - $collection = new RouteCollection(); - $collection->add('_welcome', new Route('/', array( - '_controller' => 'AcmeDemoBundle:Welcome:index', - ))); - - return $collection; - -Para enlazar a la página, sólo tienes que utilizar la función ``path`` de *Twig* y referir la ruta: - -.. configuration-block:: - - .. code-block:: html+jinja - - Home - - .. code-block:: html+php - - Home - -Como era de esperar, esto genera la *URL* ``/``. Ahora para una ruta más complicada: - -.. configuration-block:: - - .. code-block:: yaml - - article_show: - path: /article/{slug} - defaults: { _controller: AcmeArticleBundle:Article:show } - - .. code-block:: xml - - - AcmeArticleBundle:Article:show - - - .. code-block:: php - - $collection = new RouteCollection(); - $collection->add('article_show', new Route('/article/{slug}', array( - '_controller' => 'AcmeArticleBundle:Article:show', - ))); - - return $collection; - -En este caso, es necesario especificar el nombre de la ruta (``article_show``) y un valor para el parámetro ``{slug}``. Usando esta ruta, revisemos la plantilla ``recentList`` de la sección anterior y enlacemos los artículos correctamente: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig #} - {% for article in articles %} - - {{ article.title }} - - {% endfor %} - - .. code-block:: html+php - - - - - getTitle() ?> - - - -.. tip:: - - También puedes generar una *URL* absoluta utilizando la función ``url`` de *Twig*: - - .. code-block:: html+jinja - - Home - - Lo mismo se puede hacer en plantillas *PHP* pasando un tercer argumento al método ``generate()``: - - .. code-block:: html+php - - Home - -.. index:: - single: Plantillas; Enlazando activos - -.. _book-templating-assets: - -Enlazando activos -~~~~~~~~~~~~~~~~~ - -Las plantillas también se refieren comúnmente a imágenes, *JavaScript*, hojas de estilo y otros activos. Por supuesto, puedes codificar la ruta de estos activos (por ejemplo ``/images/logo.png``), pero *Symfony2* ofrece una opción más dinámica a través de la función ``asset`` de *Twig*: - -.. configuration-block:: - - .. code-block:: html+jinja - - Symfony! - - - - .. code-block:: html+php - - Symfony! - - - -El propósito principal de la función ``asset`` es hacer más portátil tu aplicación. -Si tu aplicación vive en la raíz de tu servidor (por ejemplo, http://ejemplo.com), entonces las rutas reproducidas deben ser ``/images/logo.png``. Pero si tu aplicación vive en un subdirectorio (por ejemplo, http://ejemplo.com/mi_aplic), cada ruta de activo debe reproducir el subdirectorio (por ejemplo ``/mi_aplic/images/logo.png``). La función ``asset`` se encarga de esto determinando cómo se está utilizando tu aplicación y generando las rutas correctas en consecuencia. - -Además, si utilizas la función ``asset``, *Symfony* automáticamente puede añadir una cadena de consulta a tu activo, con el fin de garantizar que los activos estáticos actualizados no se almacenen en caché al desplegar tu aplicación. Por ejemplo, ``/images/logo.png`` podría ser ``/images/logo.png?v2``. Para más información, consulta la opción de configuración :ref:`ref-framework-assets-version`. - -.. index:: - single: Plantillas; Incluyendo hojas de estilo y JavaScript - single: Hojas de estilo; Incluyendo hojas de estilo - single: JavaScript; Incluyendo archivos JavaScript - -Incluyendo hojas de estilo y *JavaScript* en *Twig* ---------------------------------------------------- - -Ningún sitio estaría completo sin incluir archivos de *JavaScript* y hojas de estilo. -En *Symfony*, la inclusión de estos activos se maneja elegantemente, aprovechando la herencia de plantillas de *Symfony*. - -.. tip:: - - Esta sección te enseñará la filosofía detrás de la inclusión de activos como hojas de estilo y *Javascript* en *Symfony*. *Symfony* también empaca otra biblioteca, llamada ``Assetic``, la cual sigue esta filosofía, pero te permite hacer cosas mucho más interesantes con esos activos. Para más información sobre el uso de ``Assetic`` consulta :doc:`/cookbook/assetic/asset_management`. - - -Comienza agregando dos bloques a la plantilla base que mantendrá tus activos: -uno llamado ``stylesheet`` dentro de la etiqueta ``head`` y otro llamado ``javascript`` justo por encima de la etiqueta de cierre ``body``. Estos bloques deben contener todas las hojas de estilo y archivos *Javascript* que necesitas en tu sitio: - -.. code-block:: html+jinja - - {# app/Resources/views/base.html.twig #} - - - {# ... #} - - {% block stylesheets %} - - {% endblock %} - - - {# ... #} - - {% block javascripts %} - - {% endblock %} - - - -¡Eso es bastante fácil! Pero ¿y si es necesario incluir una hoja de estilo extra o archivos *Javascript* desde una plantilla hija? Por ejemplo, supongamos que tienes una página de contacto y necesitas incluir una hoja de estilo :file:`contact.css` *sólo* en esa página. Desde dentro de la plantilla de la página de contacto, haz lo siguiente: - -.. code-block:: html+jinja - - {# src/Acme/DemoBundle/Resources/views/Contact/contact.html.twig #} - {% extends '::base.html.twig' %} - - {% block stylesheets %} - {{ parent() }} - - - {% endblock %} - - {# ... #} - -En la plantilla hija, sólo tienes que reemplazar el bloque ``stylesheets`` y poner tu nueva etiqueta de hoja de estilo dentro de ese bloque. Por supuesto, debido a que la quieres añadir al contenido del bloque padre (y no *cambiarla* en realidad), debes usar la función ``parent()`` de *Twig* para incluir todo, desde el bloque ``stylesheets`` de la plantilla base. - -Además, puedes incluir activos ubicados en el directorio ``Resources/public`` de tus paquetes. -Deberás ejecutar la orden ``php app/console assets:install destino [--symlink]``, la cual mueve (o enlaza simbólicamente) tus archivos a la ubicación correcta. (destino por omisión es «web»). - -.. code-block:: html+jinja - - - -El resultado final es una página que incluye ambas hojas de estilo :file:`main.css` y :file:`contact.css`. - -Variables de plantilla globales -------------------------------- - -En cada petición, *Symfony2* debe configurar una variable de plantilla global ``app`` en ambos motores de plantilla predefinidos *Twig* y *PHP*. La variable ``app`` es una instancia de :class:`Symfony\\Bundle\\FrameworkBundle\\Templating\\GlobalVariables` que automáticamente te proporciona acceso a algunas variables específicas de la aplicación: - -* ``app.security`` - El contexto de seguridad. -* ``app.user`` - El objeto ``Usuario`` actual. -* ``app.request`` - El objeto ``Petición``. -* ``app.session`` - El objeto ``Sesión``. -* ``app.environment`` - El entorno actual («dev», «prod», etc.) -* ``app.debug`` - ``True`` si está en modo de depuración. ``False`` en caso contrario. - -.. configuration-block:: - - .. code-block:: html+jinja - -

Username: {{ app.user.username }}

- {% if app.debug %} -

Request method: {{ app.request.method }}

-

Application Environment: {{ app.environment }}

- {% endif %} - - .. code-block:: html+php - -

Username: getUser()->getUsername() ?>

- getDebug()): ?> -

Request method: getRequest()->getMethod() ?>

-

Application Environment: getEnvironment() ?>

- - -.. tip:: - - Puedes agregar tus propias variables de plantilla globales. Ve el ejemplo de :doc:`variables globales` en el recetario. - -.. index:: - single: Plantillas; El servicio plantillas (templating) - -Configurando y usando el servicio ``plantilla`` ------------------------------------------------ - -El corazón del sistema de plantillas en *Symfony2* es el ``motor`` de plantillas. -Este objeto especial es el encargado de reproducir las plantillas y devolver su contenido. Cuando reproduces una plantilla en un controlador, por ejemplo, en realidad estás usando el motor del servicio de plantillas. Por ejemplo:: - - return $this->render('AcmeArticleBundle:Article:index.html.twig'); - -es equivalente a:: - - use Symfony\Component\HttpFoundation\Response; - - $engine = $this->container->get('templating'); - $content = $engine->render('AcmeArticleBundle:Article:index.html.twig'); - - return $response = new Response($content); - -.. _template-configuration: - -El motor de plantillas (o «servicio») está configurado para funcionar automáticamente al interior de *Symfony2*. Por supuesto, puedes configurar más en el archivo de configuración de la aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - # ... - templating: { engines: ['twig'] } - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - // ... - - 'templating' => array( - 'engines' => array('twig'), - ), - )); - -Disponemos de muchas opciones de configuración y están cubiertas en el :doc:`Apéndice Configurando `. - -.. note:: - - En el motor de ``twig`` es obligatorio el uso del ``webprofiler`` (así como muchos otros paquetes de terceros). - -.. index:: - single: Plantilla; Sustituyendo plantillas - -.. _overriding-bundle-templates: - -Sustituyendo plantillas del paquete ------------------------------------ - -La comunidad de *Symfony2* se enorgullece de crear y mantener paquetes de alta calidad (consulta `KnpBundles.com`_) para ver la gran cantidad de diferentes características. -Una vez que utilizas un paquete de terceros, probablemente necesites redefinir y personalizar una o más de sus plantillas. - -Supongamos que hemos incluido el paquete imaginario :dfn:`AcmeBlogBundle` de código abierto en el proyecto (por ejemplo, en el directorio :file:`src/Acme/BlogBundle`). Y si bien estás muy contento con todo, deseas sustituir la página «lista» del *blog* para personalizar el marcado específicamente para tu aplicación. Al excavar en el controlador del ``Blog`` de ``AcmeBlogBundle``, encuentras lo siguiente:: - - public function indexAction() - { - // alguna lógica para recuperar artículos - $blogs = ...; - - $this->render( - 'AcmeBlogBundle:Blog:index.html.twig', - array('blogs' => $blogs) - ); - } - -Al reproducir ``AcmeBlogBundle:Blog:index.html.twig``, en realidad *Symfony2* busca la plantilla en dos diferentes lugares: - -#. ``app/Resources/AcmeBlogBundle/views/Blog/index.html.twig`` -#. :file:`src/Acme/BlogBundle/Resources/views/Blog/index.html.twig` - -Para sustituir la plantilla del paquete, sólo tienes que copiar la plantilla ``index.html.twig`` del paquete a ``app/Resources/AcmeBlogBundle/views/Blog/index.html.twig`` (el directorio ``app/Resources/AcmeBlogBundle`` no existe, por lo tanto tendrás que crearlo). Ahora eres libre de personalizar la plantilla para tu aplicación. - -.. caution:: - - Si agregas una plantilla en una nueva ubicación, *posiblemente* tengas que vaciar la caché (con ``php app/consola cache:clear``), incluso si estás en modo de depuración. - -Esta lógica también aplica a las plantillas base del paquete. Supongamos también que cada plantilla en ``AcmeBlogBundle`` hereda de una plantilla base llamada ``AcmeBlogBundle::layout.html.twig``. Al igual que antes, *Symfony2* buscará la plantilla en los dos siguientes lugares: - -#. ``app/Resources/AcmeBlogBundle/views/layout.html.twig`` -#. :file:`src/Acme/BlogBundle/Resources/views/layout.html.twig` - -Una vez más, para sustituir la plantilla, sólo tienes que copiarla desde el paquete a ``app/Resources/AcmeBlogBundle/views/layout.html.twig``. Ahora estás en libertad de personalizar esta copia como mejor te parezca. - -Si retrocedes un paso, verás que *Symfony2* siempre empieza a buscar una plantilla en el directorio ``app/Resources/{NOMBRE_PAQUETE}/views/``. Si la plantilla no existe allí, continúa buscando dentro del directorio ``Resources/views`` del propio paquete. Esto significa que todas las plantillas del paquete se pueden sustituir colocándolas en el subdirectorio ``app/Resources`` correcto. - -.. note:: - - También puedes reemplazar las plantillas de un paquete usando la herencia de paquetes. Para más información, consulta :doc:`/cookbook/bundles/inheritance`. - -.. _templating-overriding-core-templates: - -.. index:: - single: Plantilla; Excepción al sustituir plantillas - -Sustituyendo plantillas del núcleo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Puesto que la plataforma *Symfony2* en sí misma sólo es un paquete, las plantillas del núcleo se pueden sustituir de la misma manera. Por ejemplo, el núcleo de ``TwigBundle`` contiene una serie de diferentes plantillas para «excepción» y «error» que puedes sustituir copiando cada una del directorio ``Resources/views/Exception`` del ``TwigBundle`` a... ¡adivinaste! el directorio ``app/Resources/TwigBundle/views/Exception``. - -.. index:: - single: Plantillas; Patrón de herencia de tres niveles - -Herencia de tres niveles ------------------------- - -Una manera común de usar la herencia es utilizar un enfoque de tres niveles. Este método funciona a la perfección con los tres diferentes tipos de plantilla que acabamos de cubrir: - -* Crea un archivo ``app/Resources/views/base.html.twig`` que contenga el diseño principal para tu aplicación (como en el ejemplo anterior). Internamente, esta plantilla se llama ``::base.html.twig``; - -* Crea una plantilla para cada «sección» de tu sitio. Por ejemplo, ``AcmeBlogBundle``, tendría una plantilla llamada ``AcmeBlogBundle::layout.html.twig`` que sólo contiene los elementos específicos de la sección *blog*; - - .. code-block:: html+jinja - - {# src/Acme/BlogBundle/Resources/views/layout.html.twig #} - {% extends '::base.html.twig' %} - - {% block body %} -

Blog Application

- - {% block content %}{% endblock %} - {% endblock %} - -* Crea plantillas individuales para cada página y haz que cada una extienda la plantilla de la sección adecuada. Por ejemplo, la página «index» se llama algo parecido a ``AcmeBlogBundle:Blog:index.html.twig`` y enumera las entradas del *blog* real. - - .. code-block:: html+jinja - - {# src/Acme/BlogBundle/Resources/views/Blog/index.html.twig #} - {% extends 'AcmeBlogBundle::layout.html.twig' %} - - {% block content %} - {% for entry in blog_entries %} -

{{ entry.title }}

-

{{ entry.body }}

- {% endfor %} - {% endblock %} - -Ten en cuenta que esta plantilla extiende la plantilla de la sección --- (``AcmeBlogBundle::layout.html.twig``), que a su vez, extiende el diseño base de la aplicación (``::base.html.twig``). -Este es el modelo común de la herencia de tres niveles. - -Cuando construyas tu aplicación, podrás optar por este método o, simplemente, hacer que cada plantilla de página extienda directamente la plantilla base de tu aplicación (por ejemplo, ``{% extends '::base.html.twig' %}``). El modelo de plantillas de tres niveles es un método de las buenas prácticas utilizadas por los paquetes de proveedores a fin de que la plantilla base de un paquete se pueda sustituir fácilmente para extender correctamente el diseño base de tu aplicación. - -.. index:: - single: Plantillas; Mecanismo de escape - - -Mecanismo de escape -------------------- - -Cuando generas *HTML* a partir de una plantilla, siempre existe el riesgo de que una variable de plantilla pueda producir *HTML* involuntario o código peligroso de lado del cliente. El resultado es que el contenido dinámico puede romper el código *HTML* de la página resultante o permitir a un usuario malicioso realizar un ataque de `Explotación de vulnerabilidades del sistema`_ (*Cross Site Scripting XSS*). Considera este ejemplo clásico: - -.. configuration-block:: - - .. code-block:: html+jinja - - Hello {{ name }} - - .. code-block:: html+php - - Hello - -Imagina que el usuario introduce el siguiente código como su nombre: - -.. code-block:: text - - - -Sin ningún tipo de mecanismo de escape, la plantilla resultante provocaría que aparezca un cuadro de alerta *JavaScript*: - -.. code-block:: html - - Hello - -Y aunque esto parece inofensivo, si un usuario puede llegar hasta aquí, ese mismo usuario también será capaz de escribir código *JavaScript* malicioso que subrepticiamente realice acciones dentro de la zona segura de un usuario legítimo. - -La respuesta al problema es el mecanismo de escape. Con el mecanismo de escape, reproduces la misma plantilla sin causar daño alguno, y literalmente, imprimes en pantalla la etiqueta ``script``: - -.. code-block:: html - - Hello <script>alert('helloe')</script> - -*Twig* y los sistemas de plantillas *PHP* abordan el problema de diferentes maneras. -Si estás utilizando *Twig*, el mecanismo de escape por omisión está activado y tu aplicación está protegida. -En *PHP*, el mecanismo de escape no es automático, lo cual significa que, de ser necesario, necesitas escapar todo manualmente. - -Mecanismo de escape en *Twig* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si estás utilizando las plantillas de *Twig*, entonces el mecanismo de escape está activado por omisión. Esto significa que estás protegido fuera de la caja de las consecuencias no intencionales del código presentado por los usuarios. De forma predeterminada, el mecanismo de escape asume que el contenido se escapó para salida *HTML*. - -En algunos casos, tendrás que desactivar el mecanismo de escape cuando estás reproduciendo una variable de confianza y marcado que no se debe escapar. -Supongamos que los usuarios administrativos están autorizados para escribir artículos que contengan código *HTML*. De forma predeterminada, *Twig* debe escapar el cuerpo del artículo. - -Para reproducirlo normalmente, agrega el filtro ``raw``: - -.. code-block:: jinja - - {{ article.body|raw }} - -También puedes desactivar el mecanismo de escape dentro de una área ``{% block %}`` o para una plantilla completa. Para más información, consulta la documentación de *Twig* sobre el `Mecanismo de escape`_. - -Mecanismo de escape en *PHP* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El mecanismo de escape no es automático cuando utilizas plantillas *PHP*. Esto significa que a menos que escapes una variable expresamente, no estás protegido. Para utilizar el mecanismo de escape, usa el método especial de la vista ``escape()``: - -.. code-block:: html+php - - Hello escape($name) ?> - -De forma predeterminada, el método ``escape()`` asume que la variable se está reproduciendo en un contexto *HTML* (y por tanto la variable se escapa para que sea *HTML* seguro). -El segundo argumento te permite cambiar el contexto. Por ejemplo, para mostrar algo en una cadena *JavaScript*, utiliza el contexto ``js``: - -.. code-block:: html+php - - var myMsg = 'Hello escape($name, 'js') ?>'; - -.. index:: - single: Plantillas; Formatos - -.. _template-formats: - -Depurando ---------- - -.. versionadded:: 2.0.9 - Esta característica está disponible desde *Twig* ``1.5.x``, que se adoptó por primera vez en *Symfony* 2.0.9. - -Cuando utilizas *PHP*, puedes usar ``var_dump()`` si necesitas encontrar rápidamente el valor de una variable proporcionada. Esto es útil, por ejemplo, dentro de tu controlador. -Lo mismo puedes lograr cuando utilizas *Twig* usando la extensión de depuración (``debug``). Necesitas activarla en la configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - services: - acme_hello.twig.extension.debug: - class: Twig_Extension_Debug - tags: - - { name: 'twig.extension' } - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - // app/config/config.php - use Symfony\Component\DependencyInjection\Definition; - - $definition = new Definition('Twig_Extension_Debug'); - $definition->addTag('twig.extension'); - $container->setDefinition('acme_hello.twig.extension.debug', $definition); - -Puedes descargar los parámetros de plantilla utilizando la función ``dump``: - -.. code-block:: html+jinja - - {# src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig #} - {{ dump(articles) }} - - {% for article in articles %} - - {{ article.title }} - - {% endfor %} - - -Las variables serán descargadas si configuras a *Twig* (en :file:`config.yml`) con ``debug`` a ``true``. De manera predeterminada, esto significa que las variables serán descargadas en el entorno ``dev``, pero no el entorno ``prod``. - -Comprobando la sintaxis ------------------------ - -.. versionadded:: 2.1 - La orden ``twig:lint`` fue añadida en *Symfony 2.1* - -Puedes localizar errores de sintaxis en plantillas *Twig* utilizando la orden de consola ``twig:lint``: - -.. code-block:: bash - - # Puedes buscar por nombre de archivo: - $ php app/console twig:lint src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig - - # o por directorio: - $ php app/console twig:lint src/Acme/ArticleBundle/Resources/views - - # o usando el nombre del paquete: - $ php app/console twig:lint @AcmeArticleBundle - -Formato de plantillas ---------------------- - -Las plantillas son una manera genérica para reproducir contenido en *cualquier* formato. Y, aunque en la mayoría de los casos debes utilizar plantillas para reproducir contenido *HTML*, una plantilla fácilmente puede generar *JavaScript*, *CSS*, *XML* o cualquier otro formato que puedas soñar. - -Por ejemplo, el mismo «recurso» a menudo se reproduce en varios formatos diferentes. -Para reproducir una página índice de artículos en formato *XML*, basta con incluir el formato en el nombre de la plantilla: - -* *nombre de plantilla XML*: ``AcmeArticleBundle:Article:index.xml.twig`` -* *nombre del archivo de plantilla XML*: ``index.xml.twig`` - -Ciertamente, esto no es más que una convención de nomenclatura y la plantilla realmente no se reproduce de manera diferente en función de ese formato. - -En muchos casos, posiblemente quieras permitir que un solo controlador reproduzca múltiples formatos basándose en el «formato de la petición». Por esa razón, un patrón común es hacer lo siguiente:: - - public function indexAction() - { - $format = $this->getRequest()->getRequestFormat(); - - return $this->render('AcmeBlogBundle:Blog:index.'.$format.'.twig'); - } - -El ``getRequestFormat`` en el objeto ``Petición`` por omisión es *HTML*, pero lo puedes devolver en cualquier otro formato basándote en el formato solicitado por el usuario. -El formato de la petición muy frecuentemente es gestionado por el enrutador, donde puedes configurar una ruta para que ``/contact`` establezca el formato ``html`` de la petición, mientras que ``/contact.xml`` establezca al formato ``xml``. Para más información, consulta el :ref:`ejemplo avanzado en el capítulo de Enrutado `. - -Para crear enlaces que incluyan el parámetro de formato, agrega una clave ``_format`` en el parámetro ``hash``: - -.. configuration-block:: - - .. code-block:: html+jinja - - - PDF Version - - - .. code-block:: html+php - - - PDF Version - - -Consideraciones finales ------------------------ - -El motor de plantillas de *Symfony* es una poderosa herramienta que puedes utilizar cada vez que necesites generar contenido de presentación en *HTML*, *XML* o cualquier otro formato. -Y aunque las plantillas son una manera común de generar contenido en un controlador, su uso no es obligatorio. El objeto ``Respuesta`` devuelto por un controlador se puede crear usando o sin usar una plantilla:: - - // crea un objeto Respuesta donde el contenido reproduce la plantilla - $response = $this->render('AcmeArticleBundle:Article:index.html.twig'); - - // crea un objeto Respuesta cuyo contenido es texto simple - $response = new Response('response content'); - -El motor de plantillas de *Symfony* es muy flexible y de manera predeterminada disponemos de dos diferentes reproductores de plantilla: las tradicionales plantillas *PHP* y las elegantes y potentes plantillas *Twig*. Ambas apoyan una jerarquía de plantillas y vienen empacadas con un rico conjunto de funciones auxiliares capaces de realizar las tareas más comunes. - -En general, el tema de las plantillas se debe pensar como una poderosa herramienta que está a tu disposición. En algunos casos, posiblemente no necesites reproducir una plantilla, y en *Symfony2*, eso está absolutamente bien. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/templating/PHP` -* :doc:`/cookbook/controller/error_pages` -* :doc:`/cookbook/templating/twig_extension` - -.. _`Twig`: http://gitnacho.github.com/symfony-docs-es/twig/index.html -.. _`KnpBundles.com`: http://knpbundles.com -.. _`Explotación de vulnerabilidades del sistema`: http://es.wikipedia.org/wiki/Cross-site_scripting -.. _`Mecanismo de escape`: http://gitnacho.github.com/Twig/api.html#extension-escaper -.. _`etiquetas`: http://gitnacho.github.com/Twig/tags/index.html -.. _`filtros`: http://gitnacho.github.com/Twig/filters/index.html -.. _`agregar tus propias extensiones`: http://gitnacho.github.com/Twig/advanced.html#creando-una-extension -.. _`hinclude.js`: http://mnot.github.com/hinclude/ diff --git a/_sources/book/testing.txt b/_sources/book/testing.txt deleted file mode 100644 index 5b1dc71..0000000 --- a/_sources/book/testing.txt +++ /dev/null @@ -1,701 +0,0 @@ -.. index:: - single: Pruebas - -Probando -======== - -Cada vez que escribes una nueva línea de código, potencialmente, añades nuevos errores también. -Para construir mejores y más confiables aplicaciones, debes probar tu código usando ambas pruebas, unitarias y funcionales. - -La plataforma de pruebas *PHPUnit* ----------------------------------- - -*Symfony2* integra una biblioteca independiente ---llamada *PHPUnit*--- para proporcionarte una rica plataforma de pruebas. Esta parte no cubre *PHPUnit* en sí mismo, puesto que la biblioteca cuenta con su propia y excelente `documentación`_. - -.. note:: - - *Symfony2* trabaja con *PHPUnit* 3.5.11 o posterior, aunque se necesita la versión 3.6.4 para probar el código del núcleo de Symfony. - -Cada prueba ---si se trata de una prueba unitaria o una prueba funcional--- es una clase *PHP* que debe vivir en el subdirectorio ``Tests/`` de tus paquetes. Si sigues esta regla, entonces puedes ejecutar todas las pruebas de tu aplicación con la siguiente orden: - -.. code-block:: bash - - # especifica la configuración del directorio en la línea de ordenes - $ phpunit -c app/ - -La opción ``-c`` le dice a *PHPUnit* que busque el archivo de configuración en el directorio ``app/``. Si tienes curiosidad sobre qué significan las opciones de *PHPUnit*, dale un vistazo al archivo ``app/phpunit.xml.dist``. - -.. tip:: - - La cobertura de código se puede generar con la opción ``--coverage-html``. - -.. index:: - single: Pruebas; Pruebas unitarias - -Pruebas unitarias ------------------ - -Una prueba unitaria normalmente es una prueba contra una clase *PHP* específica. Si deseas probar el comportamiento de tu aplicación en conjunto, ve la sección sobre las `Pruebas funcionales`_. - -Escribir pruebas unitarias en *Symfony2* no es diferente a escribir pruebas unitarias *PHPUnit* normales. Supongamos, por ejemplo, que tienes una clase *increíblemente* simple llamada ``Calculator`` en el directorio ``Utility/`` de tu paquete:: - - // src/Acme/DemoBundle/Utility/Calculator.php - namespace Acme\DemoBundle\Utility; - - class Calculator - { - public function add($a, $b) - { - return $a + $b; - } - } - -Para probarla, crea un archivo ``CalculatorTest`` en el directorio ``Tests/Utility`` de tu paquete:: - - // src/Acme/DemoBundle/Tests/Utility/CalculatorTest.php - namespace Acme\DemoBundle\Tests\Utility; - - use Acme\DemoBundle\Utility\Calculator; - - class CalculatorTest extends \PHPUnit_Framework_TestCase - { - public function testAdd() - { - $calc = new Calculator(); - $result = $calc->add(30, 12); - - // ¡acierta que nuestra calculadora suma dos números correctamente! - $this->assertEquals(42, $result); - } - } - -.. note:: - - Por convención, el subdirectorio ``Tests/`` debería replicar al directorio de tu paquete. Por lo tanto, si estás probando una clase en el directorio ``Utility/`` de tu paquete, pon tus pruebas en el directorio ``Tests/Utility``. - -Al igual que en tu aplicación real ---el archivo ``bootstrap.php.cache``--- automáticamente activa el autocargador (como si lo hubieras configurado por omisión en el archivo ``phpunit.xml.dist``). - -Correr las pruebas de un determinado archivo o directorio también es muy fácil: - -.. code-block:: bash - - # ejecuta todas las pruebas en el directorio 'Utility' - $ phpunit -c app src/Acme/DemoBundle/Tests/Utility/ - - # corre las pruebas para la clase Calculator - $ phpunit -c app src/Acme/DemoBundle/Tests/Utility/CalculatorTest.php - - # corre todas las pruebas del paquete entero - $ phpunit -c app src/Acme/DemoBundle/ - -.. index:: - single: Pruebas; Pruebas funcionales - -Pruebas funcionales -------------------- - -Las pruebas funcionales verifican la integración de las diferentes capas de una aplicación (desde el enrutado hasta la vista). Ellas no son diferentes de las pruebas unitarias en cuanto a *PHPUnit* se refiere, pero tienen un flujo de trabajo muy específico: - -* Envían una petición; -* Prueban la respuesta; -* Hacen clic en un enlace o envían un formulario; -* Prueban la respuesta; -* Enjuagan y repiten. - -Tu primera prueba funcional -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Las pruebas funcionales son simples archivos *PHP* que suelen vivir en el directorio ``Tests/Controller`` de tu paquete. Si deseas probar las páginas a cargo de tu clase ``DemoController``, empieza creando un nuevo archivo :file:`DemoControllerTest.php` que extiende una clase ``WebTestCase`` especial. - -Por ejemplo, la *edición estándar de Symfony2* proporciona una sencilla prueba funcional para ``DemoController`` (`DemoControllerTest`_) que dice lo siguiente:: - - // src/Acme/DemoBundle/Tests/Controller/DemoControllerTest.php - namespace Acme\DemoBundle\Tests\Controller; - - use Symfony\Bundle\FrameworkBundle\Test\WebTestCase; - - class DemoControllerTest extends WebTestCase - { - public function testIndex() - { - $client = static::createClient(); - - $crawler = $client->request('GET', '/demo/hello/Fabien'); - - $this->assertGreaterThan( - 0, - $crawler->filter('html:contains("Hello Fabien")')->count() - ); - } - } - -.. tip:: - - Para ejecutar tus pruebas funcionales, la clase ``WebTestCase`` arranca el núcleo de tu aplicación. En la mayoría de los casos, esto sucede automáticamente. - Sin embargo, si tu núcleo se encuentra en un directorio no estándar, deberás modificar tu archivo :file:`phpunit.xml.dist` para ajustar la variable de entorno ``KERNEL_DIR`` al directorio de tu núcleo: - - .. code-block:: xml - - - - - - - - - -El método ``createClient()`` devuelve un cliente, el cual es como un navegador que debes usar para explorar tu sitio:: - - $crawler = $client->request('GET', '/demo/hello/Fabien'); - -El método ``request()`` (consulta :ref:`más sobre el método request `) devuelve un objeto :class:`Symfony\\Component\\DomCrawler\\Crawler` que puedes utilizar para seleccionar elementos en la respuesta, hacer clic en enlaces, y enviar formularios. - -.. tip:: - - El ``Crawler`` únicamente trabaja cuando la respuesta es *XML* o un documento *HTML*. - Para conseguir el contenido crudo de la respuesta, llama a ``$client->getResponse()->getContent()``. - -Haz clic en un enlace seleccionándolo primero con el ``Crawler`` utilizando una expresión ``XPath`` o un selector *CSS*, luego utiliza el cliente para hacer clic en él. Por ejemplo, el siguiente código buscará todos los enlaces con el texto ``Greet``, a continuación, selecciona el segundo, y en última instancia, hace clic en él:: - - $link = $crawler->filter('a:contains("Greet")')->eq(1)->link(); - - $crawler = $client->click($link); - -El envío de un formulario es muy similar; selecciona un botón del formulario, opcionalmente sustituye algunos valores del formulario, y ​​envía el formulario correspondiente:: - - $form = $crawler->selectButton('submit')->form(); - - // sustituye algunos valores - $form['name'] = 'Lucas'; - $form['form_name[subject]'] = 'Hey there!'; - - // envía el formulario - $crawler = $client->submit($form); - -.. tip:: - - El formulario también puede manejar archivos subidos y contiene métodos para llenar los diferentes tipos de campos del formulario (por ejemplo, ``select()`` y ``tick()``). Para más detalles, consulta la sección `Formularios`_ más adelante. - -Ahora que puedes navegar fácilmente a través de una aplicación, utiliza las aserciones para probar que en realidad hace lo que se espera. Utiliza el ``Crawler`` para hacer aserciones sobre el *DOM*:: - - // Afirma que la respuesta concuerda con un determinado selector CSS. - $this->assertGreaterThan(0, $crawler->filter('h1')->count()); - -O bien, prueba contra el contenido de la respuesta directamente si lo que deseas es acertar que el contenido contiene algún texto, o si la respuesta no es un documento *XML* o *HTML*:: - - $this->assertRegExp( - '/Hello Fabien/', - $client->getResponse()->getContent() - ); - -.. _book-testing-request-method-sidebar: - -.. sidebar:: Más sobre el método ``request()``: - - La firma completa del método ``request()`` es la siguiente:: - - request( - $method, - $uri, - array $parameters = array(), - array $files = array(), - array $server = array(), - $content = null, - $changeHistory = true - ) - - El arreglo ``server`` son los valores crudos que esperarías encontrar normalmente en la superglobal `$_SERVER`_ de *PHP*. Por ejemplo, para establecer las cabeceras *HTTP* ``Content-Type``, ``Referer`` y ``X-Requested-With``, deberías pasar lo siguiente (no olvides el prefijo ``HTTP_`` para las cabeceras que no son estándar):: - - $client->request( - 'GET', - '/demo/hello/Fabien', - array(), - array(), - array( - 'CONTENT_TYPE' => 'application/json', - 'HTTP_REFERER' => '/foo/bar', - 'HTTP_X-Requested-With' => 'XMLHttpRequest', - ) - ); - -.. index:: - single: Pruebas; Aserciones - -.. sidebar:: Útiles aserciones - - Para empezar más rápido, aquí tienes una lista de las aserciones más comunes y útiles:: - - // Acierta que cuando menos hay una etiqueta h2 - // con la clase «subtitle» - $this->assertGreaterThan( - 0, - $crawler->filter('h2.subtitle')->count() - ); - - // Acierta que hay exactamente 4 etiquetas h2 en la página - $this->assertCount(4, $crawler->filter('h2')); - - // Acierta que la cabecera 'Content-Type' es 'application/json' - $this->assertTrue( - $client->getResponse()->headers->contains( - 'Content-Type', - 'application/json' - ) - ); - - // Acierta que el contenido de la respuesta concuerda con una expresión regular. - $this->assertRegExp('/foo/', $client->getResponse()->getContent()); - - // Acierta que el código de estado de la respuesta es 2xx - $this->assertTrue($client->getResponse()->isSuccessful()); - // Acierta que el código de estado de la respuesta es 404 - $this->assertTrue($client->getResponse()->isNotFound()); - // Acierta un código de estado 200 específico - $this->assertEquals( - 200, - $client->getResponse()->getStatusCode() - ); - - // Acierta que la respuesta es una redirección a '/demo/contact' - $this->assertTrue( - $client->getResponse()->isRedirect('/demo/contact') - ); - // o simplemente comprueba que la respuesta es una redirección a cualquier URL - $this->assertTrue($client->getResponse()->isRedirect()); - -.. index:: - single: Pruebas; Cliente - -Trabajando con el Cliente de pruebas ------------------------------------- - -El Cliente de pruebas simula un cliente *HTTP* tal como un navegador y hace peticiones a tu aplicación *Symfony2*:: - - $crawler = $client->request('GET', '/hello/Fabien'); - -El método ``request()`` toma el método *HTTP* y una *URL* como argumentos y devuelve una instancia de ``Crawler``. - -Utiliza el rastreador para encontrar elementos del *DOM* en la respuesta. Puedes utilizar estos elementos para hacer clic en los enlaces y presentar formularios:: - - $link = $crawler->selectLink('Go elsewhere...')->link(); - $crawler = $client->click($link); - - $form = $crawler->selectButton('validate')->form(); - $crawler = $client->submit($form, array('name' => 'Fabien')); - -Ambos métodos ``click()`` y ``submit()`` devuelven un objeto ``Crawler``. -Estos métodos son la mejor manera para navegar por tu aplicación permitiéndole se preocupe de un montón de detalles por ti, tal como detectar el método *HTTP* de un formulario y proporcionándote una buena *API* para cargar archivos. - -.. tip:: - - Aprenderás más sobre los objetos ``Link`` y ``Form`` más adelante en la sección :ref:`Crawler `. - -También puedes usar el método ``request`` para simular el envío de formularios directamente o realizar peticiones más complejas:: - - // envía un formulario directamente (¡Pero es más fácil usando el 'Crawler'!) - $client->request('POST', '/submit', array('name' => 'Fabien')); - - // Envía una simple cadena JSON en el cuerpo de la petición - $client->request( - 'POST', - '/submit', - array(), - array(), - array('CONTENT_TYPE' => 'application/json'), - '{"name":"Fabien"}' - ); - - // envía un formulario con un campo para subir un archivo - use Symfony\Component\HttpFoundation\File\UploadedFile; - - $photo = new UploadedFile( - '/ruta/a/foto.jpg', - 'foto.jpg', - 'image/jpeg', - 123 - ); - $client->request( - 'POST', - '/submit', - array('name' => 'Fabien'), - array('photo' => $photo) - ); - - // Realiza una petición DELETE, y pasa las cabeceras HTTP - $client->request( - 'DELETE', - '/post/12', - array(), - array(), - array('PHP_AUTH_USER' => 'username', 'PHP_AUTH_PW' => 'pa$$word') - ); - -Por último pero no menos importante, puedes hacer que cada petición se ejecute en su propio proceso *PHP* para evitar efectos secundarios cuando se trabaja con varios clientes en el mismo archivo:: - - $client->insulate(); - -Navegando -~~~~~~~~~ - -El cliente es compatible con muchas operaciones que se pueden hacer en un navegador real:: - - $client->back(); - $client->forward(); - $client->reload(); - - // Limpia todas las cookies y el historial - $client->restart(); - -Accediendo a objetos internos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si utilizas el cliente para probar tu aplicación, posiblemente quieras acceder a los objetos internos del cliente:: - - $history = $client->getHistory(); - $cookieJar = $client->getCookieJar(); - -También puedes obtener los objetos relacionados con la última petición:: - - $request = $client->getRequest(); - $response = $client->getResponse(); - $crawler = $client->getCrawler(); - -Si tus peticiones no son aisladas, también puedes acceder al ``Contenedor`` y al ``núcleo``:: - - $container = $client->getContainer(); - $kernel = $client->getKernel(); - -Accediendo al contenedor -~~~~~~~~~~~~~~~~~~~~~~~~ - -Es altamente recomendable que una prueba funcional sólo pruebe la respuesta. Sin embargo, bajo ciertas circunstancias muy raras, posiblemente desees acceder a algunos objetos internos para escribir aserciones. En tales casos, puedes acceder al contenedor de inyección de dependencias:: - - $container = $client->getContainer(); - -Ten en cuenta que esto no tiene efecto si aíslas el cliente o si utilizas una capa *HTTP*. Para listar todos los servicios disponibles en tu aplicación, utiliza la orden ``container:debug`` de la consola. - -.. tip:: - - Si la información que necesitas comprobar está disponible desde el generador de perfiles, úsala en su lugar. - -Accediendo a los datos del perfil -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En cada petición, puedes habilitar el perfilador de *Symfony* para recolectar datos sobre el -manejo interno de esa petición. Por ejemplo, podrías usar el perfilador para verificar que una determinada página ejecuta menos de un cierto número de consultas a la base de datos al cargarla. - -Para obtener el generador de perfiles de la última petición, haz lo siguiente:: - - // habilita el perfilador para la próxima petición - $client->enableProfiler(); - - $crawler = $client->request('GET', '/profiler'); - - // consigue el perfil - $profile = $client->getProfile(); - -Para detalles específicos en el uso del generador de perfiles en una prueba, consulta el artículo :doc:`/cookbook/testing/profiling` en el recetario. - -Redirigiendo -~~~~~~~~~~~~ - -Cuando una petición devuelve una respuesta de redirección, el cliente no la sigue automáticamente. Puedes examinar la ``Respuesta`` y después forzar la redirección con el método ``followRedirect()``:: - - $crawler = $client->followRedirect(); - -Si quieres que el cliente siga todos los cambios de dirección automáticamente, lo puedes forzar con el método ``followRedirects()``:: - - $client->followRedirects(); - -.. index:: - single: Pruebas; Crawler - -.. _book-testing-crawler: - -El ``Crawler`` --------------- - -Cada vez que hagas una petición con el cliente devolverá una instancia del ``Crawler``. -Este nos permite recorrer documentos *HTML*, seleccionar nodos, encontrar enlaces y formularios. - -Recorriendo -~~~~~~~~~~~ - -Al igual que *jQuery*, el ``Crawler`` tiene métodos para recorrer el *DOM* de un documento *HTML*/*XML*: Por ejemplo, el siguiente fragmento encuentra todos los elementos ``input[type=submit]``, selecciona el último en la página, y luego selecciona el elemento padre inmediato:: - - $newCrawler = $crawler->filter('input[type=submit]') - ->last() - ->parents() - ->first() - ; - -Disponemos de muchos otros métodos: - -+------------------------+----------------------------------------------------+ -| Método | Descripción | -+========================+====================================================+ -| ``filter('h1.title')`` | Nodos que coinciden con el selector *CSS* | -+------------------------+----------------------------------------------------+ -| ``filterXpath('h1')`` | Nodos que coinciden con la expresión *XPath* | -+------------------------+----------------------------------------------------+ -| ``eq(1)`` | Nodo para el índice especificado | -+------------------------+----------------------------------------------------+ -| ``first()`` | Primer nodo | -+------------------------+----------------------------------------------------+ -| ``last()`` | Último nodo | -+------------------------+----------------------------------------------------+ -| ``siblings()`` | Hermanos | -+------------------------+----------------------------------------------------+ -| ``nextAll()`` | Todos los hermanos siguientes | -+------------------------+----------------------------------------------------+ -| ``previousAll()`` | Todos los hermanos precedentes | -+------------------------+----------------------------------------------------+ -| ``parents()`` | Devuelve los nodos padre | -+------------------------+----------------------------------------------------+ -| ``children()`` | Devuelve los nodos hijo | -+------------------------+----------------------------------------------------+ -| ``reduce($lambda)`` | Nodos para los cuales el ejecutable no devuelve | -| | ``false`` | -+------------------------+----------------------------------------------------+ - -Debido a que cada uno de estos métodos devuelve una nueva instancia del ``Crawler``, puedes reducir tu selección de nodos encadenando las llamadas al método:: - - $crawler - ->filter('h1') - ->reduce(function ($node, $i) - { - if (!$node->getAttribute('class')) { - return false; - } - }) - ->first(); - -.. tip:: - - Usa la función ``count()`` para obtener el número de nodos almacenados en un ``Crawler``: - ``count($crawler)`` - -Extrayendo información -~~~~~~~~~~~~~~~~~~~~~~ - -El ``Crawler`` puede extraer información de los nodos:: - - // Devuelve el valor del atributo del primer nodo - $crawler->attr('class'); - - // Devuelve el valor del nodo para el primer nodo - $crawler->text(); - - // Extrae un arreglo de atributos de todos los nodos - // (_text devuelve el valor del nodo) - // devuelve un arreglo de cada elemento en 'crawler', - // cada cual con su valor y href - $info = $crawler->extract(array('_text', 'href')); - - // Ejecuta una función anónima por cada nodo y - // devuelve un arreglo de resultados - $data = $crawler->each(function ($node, $i) - { - return $node->attr('href'); - }); - -Enlaces -~~~~~~~ - -Para seleccionar enlaces, puedes usar los métodos de recorrido anteriores o el conveniente atajo ``selectLink()``:: - - $crawler->selectLink('Click here'); - -Este selecciona todos los enlaces que contienen el texto dado, o hace clic en las imágenes en que el atributo ``alt`` contiene el texto dado. Al igual que los otros métodos de filtrado, devuelve otro objeto ``Crawler``. - -Una vez seleccionado un enlace, tienes acceso al objeto especial ``Link``, el cual tiene útiles métodos específicos para enlaces (tal como ``getMethod()`` y -``getUri()``). Para hacer clic en el enlace, usa el método ``click()`` del cliente suministrando un objeto ``Link``:: - - $link = $crawler->selectLink('Click here')->link(); - - $client->click($link); - -Formularios -~~~~~~~~~~~ - -Al igual que con cualquier otro enlace, seleccionas el formulario con el método ``selectButton()``:: - - $buttonCrawlerNode = $crawler->selectButton('submit'); - -.. note:: - - Ten en cuenta que seleccionamos botones del formulario y no el formulario porque un formulario puede tener varios botones; si utilizas la *API* para recorrerlos, ten en cuenta que debes buscar un botón. - -El método ``selectButton()`` puede seleccionar etiquetas ``button`` y etiquetas ``input`` de envío. Este usa diferentes partes de los botones para encontrarlos: - -* El valor del atributo ``value``; - -* El valor del atributo ``id`` o ``alt`` de imágenes; - -* El valor del atributo ``id`` o ``name`` de las etiquetas ``button``. - -Una vez que tienes un ``Crawler`` que representa un botón, invoca al método ``form()`` para obtener la instancia del ``Formulario`` del nodo del formulario que envuelve al botón:: - - $form = $buttonCrawlerNode->form(); - -Cuando llamas al método ``form()``, también puedes pasar un arreglo de valores de campo que sustituyan los valores predeterminados:: - - $form = $buttonCrawlerNode->form(array( - 'name' => 'Fabien', - 'my_form[subject]' => 'Symfony rocks!', - )); - -Y si quieres simular un método *HTTP* específico del formulario, pásalo como segundo argumento:: - - $form = $buttonCrawlerNode->form(array(), 'DELETE'); - -El cliente puede enviar instancias de ``Form``:: - - $client->submit($form); - -Los valores del campo también se pueden pasar como segundo argumento del método ``submit()``:: - - $client->submit($form, array( - 'name' => 'Fabien', - 'my_form[subject]' => 'Symfony rocks!', - )); - -Para situaciones más complejas, utiliza la instancia de ``Form`` como un arreglo para establecer el valor de cada campo individualmente:: - - // Cambia el valor de un campo - $form['name'] = 'Fabien'; - $form['my_form[subject]'] = 'Symfony rocks!'; - -También hay una buena *API* para manipular los valores de los campos de acuerdo a su tipo:: - - // selecciona una opción o un botón de radio - $form['country']->select('France'); - - // marca una casilla de verificación (checkbox) - $form['like_symfony']->tick(); - - // carga un archivo - $form['photo']->upload('/ruta/a/lucas.jpg'); - -.. tip:: - - Puedes conseguir los valores que se enviarán llamando al método ``getValues()`` del objeto ``Form``. Los archivos subidos están disponibles en un arreglo separado devuelto por ``getFiles()``. Los métodos ``getPhpValues()`` y ``getPhpFiles()`` también devuelven los valores enviados, pero en formato *PHP* (este convierte las claves en notación con paréntesis cuadrados ---por ejemplo, ``my_form[subject]``--- a arreglos *PHP*). - -.. index:: - pair: Pruebas; Configuración - -Probando la configuración -------------------------- - -El cliente utilizado por las pruebas funcionales crea un núcleo que se ejecuta en un entorno de ``prueba`` especial. Debido a que *Symfony* carga el ``app/config/config_test.yml`` -en el entorno ``test``, puedes ajustar cualquiera de las opciones de tu aplicación específicamente para pruebas. - -Por ejemplo, por omisión, el ``swiftmailer`` está configurado para que en el entorno ``test`` *no* se entregue realmente el correo electrónico. Lo puedes ver bajo la opción de configuración ``swiftmailer``. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_test.yml - - # ... - swiftmailer: - disable_delivery: true - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config_test.php - - // ... - $container->loadFromExtension('swiftmailer', array( - 'disable_delivery' => true, - )); - -Además, puedes usar un entorno completamente diferente, o redefinir el modo de depuración predeterminado (``true``) pasando cada opción al método ``createClient()``:: - - $client = static::createClient(array( - 'environment' => 'my_test_env', - 'debug' => false, - )); - -Si tu aplicación se comporta de acuerdo a algunas cabeceras *HTTP*, pásalas como segundo argumento de ``createClient()``:: - - $client = static::createClient(array(), array( - 'HTTP_HOST' => 'en.example.com', - 'HTTP_USER_AGENT' => 'MySuperBrowser/1.0', - )); - -También puedes reemplazar cabeceras *HTTP* en base a la petición:: - - $client->request('GET', '/', array(), array(), array( - 'HTTP_HOST' => 'en.example.com', - 'HTTP_USER_AGENT' => 'MySuperBrowser/1.0', - )); - -.. tip:: - - El cliente de prueba está disponible como un servicio en el contenedor del entorno ``test`` (o cuando está habilitada la opción :ref:`framework.test `). Esto significa que ---de ser necesario--- puedes redefinir el servicio completamente. - -.. index:: - pair: PHPUnit; Configuración - -Configuración de *PHPUnit* -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada aplicación tiene su propia configuración de *PHPUnit*, almacenada en el archivo ``phpunit.xml.dist``. Puedes editar este archivo para cambiar los valores predeterminados o crear un archivo :file:`phpunit.xml` para modificar la configuración de tu máquina local. - -.. tip:: - - Guarda el archivo :file:`phpunit.xml.dist` en tu repositorio de código, e ignora el archivo :file:`phpunit.xml`. - -De forma predeterminada, la orden ``PHPUnit`` sólo ejecuta las pruebas almacenadas en los paquetes «estándar» (las pruebas estándar están en el directorio :file:`src/*/Bundle/Tests` o :file:`src/*/Bundle/*Bundle/Tests`), pero fácilmente puedes añadir más directorios. Por ejemplo, la siguiente configuración añade las pruebas de los paquetes de terceros que has instalado: - -.. code-block:: xml - - - - - ../src/*/*Bundle/Tests - ../src/Acme/Bundle/*Bundle/Tests - - - -Para incluir otros directorios en la cobertura de código, también edita la sección ````: - -.. code-block:: xml - - - - - ../src - - ../src/*/*Bundle/Resources - ../src/*/*Bundle/Tests - ../src/Acme/Bundle/*Bundle/Resources - ../src/Acme/Bundle/*Bundle/Tests - - - - -Aprende más ------------ - -* :doc:`/components/dom_crawler` -* :doc:`/components/css_selector` -* :doc:`/cookbook/testing/http_authentication` -* :doc:`/cookbook/testing/insulating_clients` -* :doc:`/cookbook/testing/profiling` -* :doc:`/cookbook/testing/bootstrap` - - -.. _`DemoControllerTest`: https://github.com/symfony/symfony-standard/blob/master/src/Acme/DemoBundle/Tests/Controller/DemoControllerTest.php -.. _`$_SERVER`: http://www.php.net/manual/es/reserved.variables.server.php -.. _`documentación`: http://www.phpunit.de/manual/3.5/en/ diff --git a/_sources/book/translation.txt b/_sources/book/translation.txt deleted file mode 100644 index 0a53856..0000000 --- a/_sources/book/translation.txt +++ /dev/null @@ -1,842 +0,0 @@ -.. index:: - single: Traducciones - -Traduciendo -=========== - -El término «internacionalización» (frecuentemente abreviado como `i18n`_) se refiere al proceso de abstraer cadenas y otros elementos específicos de la configuración regional de tu aplicación a una capa donde se puedan traducir y convertir basándose en la configuración regional del usuario (es decir, idioma y país). Para el texto, esto significa envolver cada uno con una función capaz de traducir el texto (o «mensaje») al idioma del usuario:: - - // el texto *siempre* se imprime en Inglés - echo 'Hello World'; - - // el texto se puede traducir al idioma del - // usuario final o predeterminado en Inglés - echo $translator->trans('Hello World'); - -.. note:: - - El término *locale* se refiere más o menos al lenguaje y país del usuario. Este puede ser cualquier cadena que tu aplicación utilice para manejar las traducciones y otras diferencias de formato (por ejemplo, el formato de moneda). Recomendamos el código de *idioma* `ISO639-1`_, un guión bajo (``_``), luego el código de *país* `ISO3166 Alpha-2`_ (p. ej. ``fr_FR`` para Francés/Francia). - -En este capítulo, aprenderas cómo preparar una aplicación para apoyar varias configuraciones regionales, y luego, cómo crear traducciones para múltiples regiones. En general, el proceso tiene varios pasos comunes: - -#. Habilitar y configurar el componente ``Translation`` de *Symfony*; - -#. Abstraer cadenas (es decir, «mensajes») envolviéndolas en llamadas al ``Traductor``; - -#. Crear recursos de traducción para cada configuración regional compatible, la cual traduce cada mensaje en la aplicación; - -#. Determinar, establecer y administrar la configuración regional del usuario para la petición y, opcionalmente, la sesión entera. - -.. index:: - single: Traducciones; Configuración - -Configurando ------------- - -La traducción está a cargo de un :term:`servicio` ``Traductor`` que utiliza la configuración regional del usuario para buscar y devolver mensajes traducidos. Antes de usarlo, habilita el ``Traductor`` en tu configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - translator: { fallback: en } - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - 'translator' => array('fallback' => 'en'), - )); - -La opción ``fallback`` define la configuración regional de reserva cuando la traducción no existe en la configuración regional del usuario. - -.. tip:: - - Cuando la traducción no existe para una configuración regional, el traductor primero intenta encontrar la traducción para el idioma («``es``» si la región es «``es_MX``» por ejemplo). Si esto también falla, busca una traducción utilizando la configuración regional de reserva. - -La región utilizada en las traducciones es la almacenada en la petición. Esta, normalmente se establece en el atributo ``_locale`` de tus rutas (ve :ref:`book-translation-locale-url`). - -.. index:: - single: Traducciones; Traducción básica - -Traducción básica ------------------ - -La traducción de texto se hace a través del servicio ``traductor`` (:class:`Symfony\\Component\\Translation\\Translator`). Para traducir un bloque de texto (llamado un *mensaje*), utiliza el método :method:`Symfony\\Component\\Translation\\Translator::trans`. Supongamos, por ejemplo, que estás traduciendo un simple mensaje desde el interior de un controlador:: - - // ... - use Symfony\Component\HttpFoundation\Response; - - public function indexAction() - { - $t = $this->get('translator')->trans('Symfony2 is great'); - - return new Response($t); - } - -Al ejecutar este código, *Symfony2* tratará de traducir el mensaje ``«Symfony2 is great»``, basándose en la variable ``locale`` del usuario. Para que esto funcione, tenemos que decirle a *Symfony2* la manera de traducir el mensaje a través de un «recurso de traducción», el cual es una colección de mensajes traducidos para una determinada configuración regional. -Este «diccionario» de traducciones se puede crear en varios formatos diferentes, *XLIFF* es el formato recomendado: - -.. configuration-block:: - - .. code-block:: xml - - - - - - - - Symfony2 is great - J'aime Symfony2 - - - - - - .. code-block:: php - - // messages.fr.php - return array( - 'Symfony2 is great' => 'J\'aime Symfony2', - ); - - .. code-block:: yaml - - # messages.fr.yml - Symfony2 is great: J'aime Symfony2 - -Ahora, si el idioma de la configuración regional del usuario es el Francés (por ejemplo, ``fr_FR`` o ``fr_BE``), el mensaje será traducido a ``J'aime Symfony2``. - -El proceso de traducción -~~~~~~~~~~~~~~~~~~~~~~~~ - -Para empezar a traducir el mensaje, *Symfony2* utiliza un sencillo proceso: - -* Determina la ``región`` del usuario actual, la cual está almacenada en la petición (o almacenada como ``locale`` en la sesión del usuario); - -* Carga un catálogo de mensajes traducidos desde los recursos de traducción definidos para la configuración de ``locale`` (por ejemplo, ``fr_FR``). Los mensajes de la configuración regional de reserva también se cargan y se agregan al catálogo si no existen ya. El resultado final es un gran «diccionario» de traducciones. Consulta `Catálogos de mensajes`_ para más detalles; - -* Si se encuentra el mensaje en el catálogo, devuelve la traducción. En caso contrario, el traductor devuelve el mensaje original. - -Cuando se usa el método ``trans()``, *Symfony2* busca la cadena exacta dentro del catálogo de mensajes apropiado y la devuelve (si existe). - -.. index:: - single: Traducciones; Marcadores de posición en mensajes - -Marcadores de posición en mensajes -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A veces, debes traducir un mensaje que contiene una variable:: - - // ... - use Symfony\Component\HttpFoundation\Response; - - public function indexAction($name) - { - $t = $this->get('translator')->trans('Hello '.$name); - - return new Response($t); - } - -Sin embargo, la creación de una traducción de esta cadena es imposible, ya que el traductor tratará de buscar el mensaje exacto, incluyendo las porciones variables (por ejemplo, ``«Hello Ryan»`` o ``«Hello Fabien»``). En lugar de escribir una traducción de cada posible iteración de la variable ``$name``, podemos reemplazar la variable con un «marcador de posición»:: - - // ... - use Symfony\Component\HttpFoundation\Response; - - public function indexAction($name) - { - $t = $this->get('translator')->trans( - 'Hello %name%', - array('%name%' => $name) - ); - - return new Response($t); - } - -*Symfony2* ahora busca una traducción del mensaje en bruto (``Hello %name%``) y *después* reemplaza los marcadores de posición con sus valores. La creación de una traducción se hace igual que antes: - -.. configuration-block:: - - .. code-block:: xml - - - - - - - - Hello %name% - Bonjour %name% - - - - - - .. code-block:: php - - // messages.fr.php - return array( - 'Hello %name%' => 'Bonjour %name%', - ); - - .. code-block:: yaml - - # messages.fr.yml - 'Hello %name%': Bonjour %name% - -.. note:: - - Los marcadores de posición pueden tomar cualquier forma, el mensaje completo se reconstruye usando la `función strtr`_ de *PHP*. Sin embargo, se requiere la notación ``%var%`` cuando se traduce en plantillas *Twig*, y en general es un convenio razonable a seguir. - -Como ya viste, la creación de una traducción es un proceso de dos pasos: - -#. Abstraer el mensaje que se necesita traducir procesándolo con el ``Traductor``. - -#. Crear una traducción del mensaje para cada región que elijas apoyar. - -El segundo paso se realiza creando catálogos de mensajes que definen las traducciones para cualquier número de regiones diferentes. - -.. index:: - single: Traducciones; Catálogos de mensajes - -Catálogos de mensajes ---------------------- - -Cuando se traduce un mensaje, *Symfony2* compila un catálogo de mensajes para la configuración regional del usuario y busca en ese una traducción del mensaje. Un catálogo de mensajes es como un diccionario de traducciones para una configuración regional específica. Por ejemplo, el catálogo de la configuración regional ``fr_FR`` podría contener la siguiente traducción: - -.. code-block:: text - - Symfony2 is Great => J'aime Symfony2 - -Es responsabilidad del desarrollador (o traductor) de una aplicación internacionalizada crear estas traducciones. Las traducciones son almacenadas en el sistema de archivos y descubiertas por *Symfony*, gracias a algunos convenios. - -.. tip:: - - Cada vez que creas un *nuevo* recurso de traducción (o instalas un paquete que incluye un recurso de traducción), para que *Symfony* pueda descubrir el nuevo recurso de traducción, asegúrate de borrar la caché con la siguiente orden: - - .. code-block:: bash - - $ php app/console cache:clear - -.. index:: - single: Traducciones; Ubicación de recursos de traducción - -Ubicación de traducción y convenciones de nomenclatura -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Symfony2* busca archivos de mensajes (es decir, traducciones) en los siguientes lugares: - -* el ``/Resources/translations``; - -* el ``/Resources//translations``; - -* el directorio ``Resources/translations/`` del paquete. - -Las ubicaciones están enumeradas basándose en su prioridad. Por lo tanto puedes -redefinir la traducción de los mensajes de un paquete en cualquiera de los 2 directorios superiores. - -El mecanismo de sustitución trabaja a nivel de claves: sólo es necesario enumerar las claves remplazadas en un archivo de mensajes de alta prioridad. Cuando una clave no se encuentra en un archivo de mensajes, el traductor automáticamente vuelve a los archivos de mensajes de reserva de menor prioridad. - -El nombre del archivo de las traducciones también es importante ya que *Symfony2* utiliza una convención para determinar los detalles sobre las traducciones. Cada archivo de mensaje se tiene que denominar de acuerdo a la siguiente ruta: ``dominio.región.cargador``: - -* **dominio**: Una forma opcional para organizar los mensajes en grupos (por ejemplo, ``admin``, ``navigation`` o el valor predeterminado ``messages``) --- consulta `Usando el dominio de los mensajes`_; - -* **región**: La región para la cual son las traducciones (por ejemplo, «\ ``en_GB``\ », «``en``\ », etc.); - -* **cargador**: ¿Cómo debe cargar y analizar el archivo *Symfony2* (por ejemplo, ``XLIFF``, ``php`` o ``yml``). - -El cargador puede ser el nombre de cualquier gestor registrado. De manera predeterminada, *Symfony* incluye los siguientes cargadores: - -* ``xliff``: archivo *XLIFF*; -* ``php``: archivo *PHP*; -* ``yml``: archivo *YAML*. - -La elección del cargador a utilizar es totalmente tuya y es una cuestión de gusto. - -.. note:: - - También puedes almacenar las traducciones en una base de datos, o cualquier otro almacenamiento, proporcionando una clase personalizada que implemente la interfaz :class:`Symfony\\Component\\Translation\\Loader\\LoaderInterface`. - -.. index:: - single: Traducciones; Creando recursos de traducción - -Creando traducciones -~~~~~~~~~~~~~~~~~~~~ - -El acto de crear archivos de traducción es una parte importante de la «localización» (a menudo abreviado `L10n`_). Los archivos de traducción constan de una serie de pares Identificador-traducción para un determinado dominio y configuración regional. - La fuente es el identificador para la traducción individual, y puede ser el mensaje en la región principal (por ejemplo ``«Symfony is great»``) de tu aplicación o un identificador único (por ejemplo, ``«symfony2.great»`` ---ve la barra lateral más abajo---): - -.. configuration-block:: - - .. code-block:: xml - - - - - - - - Symfony2 is great - J'aime Symfony2 - - - symfony2.great - J'aime Symfony2 - - - - - - .. code-block:: php - - // src/Acme/DemoBundle/Resources/translations/messages.fr.php - return array( - 'Symfony2 is great' => 'J\'aime Symfony2', - 'symfony2.great' => 'J\'aime Symfony2', - ); - - .. code-block:: yaml - - # src/Acme/DemoBundle/Resources/translations/messages.fr.yml - Symfony2 is great: J'aime Symfony2 - symfony2.great: J'aime Symfony2 - -*Symfony2* descubrirá estos archivos y los utilizará cuando traduce o bien ``«Symfony2 is great»`` o ``«symfony2.great»`` en un idioma regional de Francés (por ejemplo, ``fr_FR`` o ``fr_BE``). - -.. sidebar:: Usar mensajes reales o palabras clave - - Este ejemplo ilustra las dos diferentes filosofías cuando creas mensajes a traducir:: - - $t = $translator->trans('Symfony2 is great'); - - $t = $translator->trans('symfony2.great'); - - En el primer método, los mensajes están escritos en el idioma de la región predeterminada (Inglés en este caso). Ese mensaje se utiliza entonces como el «id» al crear traducciones. - - En el segundo método, los mensajes en realidad son «palabras clave» que transmiten la idea del mensaje. Entonces, la palabra clave del mensaje se utiliza como el «id» para las traducciones. En este caso, la traducción se debe hacer para la región predeterminada (es decir, para traducir ``symfony2.great`` a ``Symfony2 is great``). - - El segundo método es útil porque la clave del mensaje no se tendrá que cambiar en cada archivo de la traducción si decides que el mensaje en realidad debería decir «Ciertamente Symfony2 es magnífico» en la región predeterminada. - - La elección del método a utilizar es totalmente tuya, pero a menudo se recomienda el formato de «palabra clave». - - Además, es compatible con archivos anidados en formato ``php`` y ``yaml`` para evitar repetir siempre lo mismo si utilizas palabras clave en lugar de texto real para tus identificadores: - - .. configuration-block:: - - .. code-block:: yaml - - symfony2: - is: - great: Symfony2 is great - amazing: Symfony2 is amazing - has: - bundles: Symfony2 has bundles - user: - login: Login - - .. code-block:: php - - return array( - 'symfony2' => array( - 'is' => array( - 'great' => 'Symfony2 is great', - 'amazing' => 'Symfony2 is amazing', - ), - 'has' => array( - 'bundles' => 'Symfony2 has bundles', - ), - ), - 'user' => array( - 'login' => 'Login', - ), - ); - - Los niveles múltiples se acoplan en pares de id/traducción añadiendo un punto (.) entre cada nivel, por lo tanto los ejemplos anteriores son equivalentes a los siguientes: - - .. configuration-block:: - - .. code-block:: yaml - - symfony2.is.great: Symfony2 is great - symfony2.is.amazing: Symfony2 is amazing - symfony2.has.bundles: Symfony2 has bundles - user.login: Login - - .. code-block:: php - - return array( - 'symfony2.is.great' => 'Symfony2 is great', - 'symfony2.is.amazing' => 'Symfony2 is amazing', - 'symfony2.has.bundles' => 'Symfony2 has bundles', - 'user.login' => 'Login', - ); - -.. index:: - single: Traducciones; Dominio de los mensajes - -Usando el dominio de los mensajes ---------------------------------- - -Como ya viste, los archivos de mensajes se organizan en las diferentes regiones en que se traducirán. Los archivos de mensajes también se pueden organizar en «dominios». -Al crear archivos de mensajes, el dominio es la primera porción del nombre de archivo. -El dominio predeterminado es ``messages``. Por ejemplo, supongamos que, por organización, las traducciones se dividieron en tres diferentes dominios: ``messages``, ``admin`` -y ``navigation``. La traducción española debe tener los siguientes archivos de mensaje: - -* ``messages.es.xliff`` -* ``admin.es.xliff`` -* ``navigation.es.xliff`` - -Al traducir las cadenas que no están en el dominio predeterminado (``messages``), debes especificar el dominio como tercer argumento de ``trans()``:: - - $this->get('translator')->trans('Symfony2 is great', array(), 'admin'); - -*Symfony2* ahora buscará el mensaje en el dominio ``admin`` de la configuración regional del usuario. - -.. index:: - single: Traducciones; Región del usuario - -Manejando la configuración regional del usuario ------------------------------------------------ - -La configuración regional del usuario actual se almacena en la petición y se puede acceder a través del objeto ``Petición``:: - - // accede al objeto request en un controlador estándar - $request = $this->getRequest(); - - $locale = $request->getLocale(); - - $request->setLocale('en_US'); - -.. index:: - single: Traducciones; Región y reserva predeterminada - -También es posible almacenar la región en la sesión en lugar de en base a cada petición. Si lo haces, cada subsecuente petición tendrá esa región. - -.. code-block:: php - - $this->get('session')->set('_locale', 'en_US'); - -En la sección :ref:`book-translation-locale-url`, más adelante, puedes ver cómo configurar la región a través del enrutado. - -Configuración regional predeterminada y reserva -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si la configuración regional no se ha establecido explícitamente en la sesión, el parámetro de configuración ``fallback_locale`` será utilizado por el ``Traductor``. El valor predeterminado del parámetro es ``«en»`` (consulta la sección `Configurando`_). - -Alternativamente, puedes garantizar que hay una ``región`` establecida en cada petición definiendo una opción ``default_locale`` en la clave ``framework``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - default_locale: en - - .. code-block:: xml - - - - en - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - 'default_locale' => 'en', - )); - -.. versionadded:: 2.1 - El parámetro ``default_locale`` originalmente se definía bajo la clave ``session``, sin embargo, se movió en la versión 2.1. Esto se debe a que la región ahora se establece en la petición en lugar de en la sesión. - -.. _book-translation-locale-url: - -``Locale`` y la *URL* -~~~~~~~~~~~~~~~~~~~~~ - -Dado que la configuración regional del usuario se almacena en la sesión, puede ser tentador utilizar la misma *URL* para mostrar un recurso en muchos idiomas diferentes en función de la región del usuario. Por ejemplo, ``http://www.ejemplo.com/contact`` podría mostrar el contenido en Inglés para un usuario y en Francés para otro. Por desgracia, esto viola una norma fundamental de la *Web*: que una *URL* particular devuelve el mismo recurso, independientemente del usuario. Para acabar de enturbiar el problema, ¿cual sería la versión del contenido indexado por los motores de búsqueda? - -Una mejor política es incluir la configuración regional en la *URL*. Esto es totalmente compatible con el sistema de enrutado mediante el parámetro especial ``_locale``: - -.. configuration-block:: - - .. code-block:: yaml - - contact: - path: /{_locale}/contact - defaults: { _controller: AcmeDemoBundle:Contact:index, _locale: en } - requirements: - _locale: en|fr|de - - .. code-block:: xml - - - AcmeDemoBundle:Contact:index - en - en|fr|de - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('contact', new Route('/{_locale}/contact', array( - '_controller' => 'AcmeDemoBundle:Contact:index', - '_locale' => 'en', - ), array( - '_locale' => 'en|fr|de', - ))); - - return $collection; - -Cuando utilizas el parámetro especial ``_locale`` en una ruta, la configuración regional emparejada *automáticamente se establece en la sesión del usuario*. En otras palabras, si un usuario visita la *URI* ``/es/contact``, la región ``«es»`` se ajustará automáticamente según la configuración regional de la sesión del usuario. - -Ahora puedes utilizar la configuración regional del usuario para crear rutas hacia otras páginas traducidas en tu aplicación. - -.. index:: - single: Traducciones; Pluralización - -Pluralizando ------------- - -La pluralización de mensajes es un tema difícil puesto que las reglas pueden ser bastante complejas. Por ejemplo, aquí tienes la representación matemática de las reglas de pluralización de Rusia:: - - (($number % 10 == 1) && ($number % 100 != 11)) - ? 0 - : ((($number % 10 >= 2) - && ($number % 10 <= 4) - && (($number % 100 < 10) - || ($number % 100 >= 20))) - ? 1 - : 2 - ); - -Como puedes ver, en Ruso, puedes tener tres formas diferentes del plural, dando a cada una un índice de 0, 1 o 2. Para todas las formas, el plural es diferente, por lo que la traducción también es diferente. - -Cuando una traducción tiene diferentes formas debido a la pluralización, puedes proporcionar todas las formas como una cadena separada por una línea vertical (``|``):: - - 'Hay una manzana|Hay %count% manzanas' - -Para traducir mensajes pluralizados, utiliza el método :method:`Symfony\\Component\\Translation\\Translator::transChoice`:: - - $t = $this->get('translator')->transChoice( - 'There is one apple|There are %count% apples', - 10, - array('%count%' => 10) - ); - -El segundo argumento (``10`` en este ejemplo), es el *número* de objetos descrito y se utiliza para determinar cual traducción usar y también para rellenar el marcador de posición ``%count%``. - -En base al número dado, el traductor elige la forma plural adecuada. -En Inglés, la mayoría de las palabras tienen una forma singular cuando hay exactamente un objeto y una forma plural para todos los otros números (0, 2, 3...). Así pues, si ``count`` es ``1``, el traductor utilizará la primera cadena (``Hay una manzana``) como la traducción. De lo contrario, utilizará ``Hay %count% manzanas``. - -Aquí está la traducción al Francés:: - - 'Il y a %count% pomme|Il y a %count% pommes' - -Incluso si la cadena tiene una apariencia similar (se compone de dos subcadenas separadas por una línea vertical), las reglas francesas son diferentes: la primera forma (no plural) se utiliza cuando ``count`` es ``0`` o ``1``. Por lo tanto, el traductor utilizará automáticamente la primera cadena (``Il y a %count% pomme``) cuando ``count`` es ``0`` o ``1``. - -Cada región tiene su propio conjunto de reglas, con algunas que tienen hasta seis formas diferentes de plural con reglas complejas detrás de las cuales los números asignan a tal forma plural. -Las reglas son bastante simples para Inglés y Francés, pero para el Ruso, puedes querer una pista para saber qué regla coincide con qué cadena. Para ayudar a los traductores, puedes «etiquetar» cada cadena:: - - 'one: There is one apple|some: There are %count% apples' - - 'none_or_one: Il y a %count% pomme|some: Il y a %count% pommes' - -Las etiquetas realmente son pistas sólo para los traductores y no afectan a la lógica utilizada para determinar qué forma plural usar. Las etiquetas pueden ser cualquier cadena descriptiva que termine con dos puntos (``:``). Las etiquetas además no necesitan ser las mismas en el mensaje original cómo en la traducción. - -.. tip:: - - Como las etiquetas son opcionales, el traductor no las utiliza (el traductor únicamente obtendrá una cadena basada en su posición en la cadena). - -Intervalo explícito de pluralización -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La forma más fácil de pluralizar un mensaje es dejar que *Symfony2* utilice su lógica interna para elegir qué cadena se utiliza en base a un número dado. A veces, tendrás más control o quieres una traducción diferente para casos específicos (por ``0``, o cuando el número es negativo, por ejemplo). Para estos casos, puedes utilizar intervalos matemáticos explícitos:: - - '{0} There are no apples|{1} There is one apple|]1,19] There are %count% apples|[20,Inf] There are many apples' - -Los intervalos siguen la notación `ISO 31-11`_. La cadena anterior especifica cuatro intervalos diferentes: exactamente ``0``, exactamente ``1``, ``2-19`` y ``20`` y superior. - -También puedes mezclar reglas matemáticas explícitas y estándar. En este caso, si la cuenta no corresponde con un intervalo específico, las reglas estándar entran en vigor después de remover las reglas explícitas:: - - '{0} There are no apples|[20,Inf] There are many apples|There is one apple|a_few: There are %count% apples' - -Por ejemplo, para ``1 apple``, la regla estándar ``There is one apple`` será utilizada. Para ``2-19 apples``, la segunda regla estándar ``There are %count% -apples`` será seleccionada. - -Un :class:`Symfony\\Component\\Translation\\Interval` puede representar un conjunto finito de números:: - - {1,2,3,4} - -O números entre otros dos números:: - - [1, +Inf[ - ]-1,2[ - -El delimitador izquierdo puede ser ``[`` (inclusive) o ``]`` (exclusivo). El delimitador derecho puede ser ``[`` (exclusivo) o ``]`` (inclusive). Más allá de los números, puedes usar ``-Inf`` y ``+Inf`` para el infinito. - -.. index:: - single: Traducciones; En plantillas - -Traducciones en plantillas --------------------------- - -La mayoría de las veces, la traducción ocurre en las plantillas. *Symfony2* proporciona apoyo nativo para ambas plantillas *Twig* y *PHP*. - -.. _book-translation-tags: - -Plantillas *Twig* -~~~~~~~~~~~~~~~~~ - -*Symfony2* proporciona etiquetas *Twig* especializadas (``trans`` y ``transchoice``) para ayudar con la traducción de los mensajes de *bloques de texto estático*: - -.. code-block:: jinja - - {% trans %}Hello %name%{% endtrans %} - - {% transchoice count %} - {0} There are no apples|{1} There is one apple|]1,Inf] There are %count% apples - {% endtranschoice %} - -La etiqueta ``transchoice`` obtiene automáticamente la variable ``%count%`` a partir del contexto actual y la pasa al traductor. Este mecanismo sólo funciona cuando se utiliza un marcador de posición después del patrón ``%var%``. - -.. tip:: - - Si necesitas utilizar el carácter de porcentaje (``%``) en una cadena, lo tienes que escapar duplicando el siguiente: ``{% trans %}Porcentaje: %percent%%%{% endtrans %}`` - -También puedes especificar el dominio del mensaje y pasar algunas variables adicionales: - -.. code-block:: jinja - - {% trans with {'%name%': 'Fabien'} from "app" %}Hello %name%{% endtrans %} - - {% trans with {'%name%': 'Fabien'} from "app" into "fr" %}Hello %name%{% endtrans %} - - {% transchoice count with {'%name%': 'Fabien'} from "app" %} - {0} %name%, there are no apples|{1} %name%, there is one apple|]1,Inf] %name%, there are %count% apples - {% endtranschoice %} - -.. _book-translation-filters: - -Los filtros ``trans`` y ``transchoice`` se pueden utilizar para traducir *texto variable* y expresiones complejas: - -.. code-block:: jinja - - {{ message|trans }} - - {{ message|transchoice(5) }} - - {{ message|trans({'%name%': 'Fabien'}, "app") }} - - {{ message|transchoice(5, {'%name%': 'Fabien'}, 'app') }} - -.. tip:: - - Usar etiquetas de traducción o filtros tiene el mismo efecto, pero con una sutil diferencia: la salida escapada automáticamente sólo se aplica a las traducciones usando un filtro. En otras palabras, si necesitas garantizar que tu traducción *no* se escape en la salida, debes aplicar el filtro ``raw`` después del filtro de traducción: - - .. code-block:: jinja - - {# el texto traducido entre etiquetas nunca se escapa #} - {% trans %} -

foo

- {% endtrans %} - - {% set message = '

foo

' %} - - {# Las cadenas y variables traducidas vía un filtro se escapan por omisión #} - {{ message|trans|raw }} - {{ '

bar

'|trans|raw }} - -.. tip:: - - Puedes establecer el ámbito de traducción para una plantilla *Twig* entera con una sola etiqueta: - - .. code-block:: jinja - - {% trans_default_domain "app" %} - - Ten en cuenta que esto sólo influye en la plantilla actual, no en las plantillas «incluidas» (con el fin de evitar efectos secundarios). - -.. versionadded:: 2.1 - La etiqueta ``trans_default_domain`` es nueva en *Symfony2.1* - -Plantillas *PHP* -~~~~~~~~~~~~~~~~ - -El servicio traductor es accesible en plantillas *PHP* a través del ayudante ``translator``: - -.. code-block:: html+php - - trans('Symfony2 is great') ?> - - transChoice( - '{0} There is no apples|{1} There is one apple|]1,Inf[ There are %count% apples', - 10, - array('%count%' => 10) - ) ?> - -Forzando la configuración regional del traductor ------------------------------------------------- - -Al traducir un mensaje, *Symfony2* utiliza la configuración regional de la petición o la configuración regional de ``reserva`` si es necesario. También puedes especificar manualmente la configuración regional utilizada para la traducción:: - - $this->get('translator')->trans( - 'Symfony2 is great', - array(), - 'messages', - 'fr_FR' - ); - - $this->get('translator')->transChoice( - '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples', - 10, - array('%count%' => 10), - 'messages', - 'fr_FR' - ); - -Traduciendo contenido de base de datos --------------------------------------- - -La traducción del contenido de la base de datos la debe manejar *Doctrine* a través de la `Extensión Translatable`_. Para más información, consulta la documentación de la biblioteca. - -.. _book-translation-constraint-messages: - -Traduciendo mensajes de restricción ------------------------------------ - -La mejor manera de entender la traducción de las restricciones es verla en acción. Para empezar, supongamos que creaste un sencillo objeto *PHP* el cual en algún lugar tiene que utilizar tu aplicación:: - - // src/Acme/BlogBundle/Entity/Author.php - namespace Acme\BlogBundle\Entity; - - class Author - { - public $name; - } - -Añade las restricciones con cualquiera de los métodos admitidos. Configura la opción de mensaje al texto fuente traducido. Por ejemplo, para garantizar que la propiedad ``$name`` no esté vacía, agrega lo siguiente: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\Author: - properties: - name: - - NotBlank: { message: "author.name.not_blank" } - - .. code-block:: php-annotations - - // src/Acme/BlogBundle/Entity/Author.php - use Symfony\Component\Validator\Constraints as Assert; - - class Autor - { - /** - * @Assert\NotBlank(message = "author.name.not_blank") - */ - public $name; - } - - .. code-block:: xml - - - - - - - - - - - - - - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\NotBlank; - - class Autor - { - public $name; - - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint('name', new NotBlank(array( - 'message' => 'author.name.not_blank', - ))); - } - } - -Crea un archivo de traducción bajo el catálogo ``validators`` para los mensajes de restricción, por lo general en el directorio ``Resources/translations/`` del paquete. Consulta `Catálogos de mensajes`_ para más detalles; - -.. configuration-block:: - - .. code-block:: xml - - - - - - - - author.name.not_blank - Por favor, ingresa un nombre de autor. - - - - - - .. code-block:: php - - // validators.en.php - return array( - 'author.name.not_blank' => 'Por favor, ingresa un nombre de autor.', - ); - - .. code-block:: yaml - - # validators.en.yml - author.name.not_blank: Por favor, ingresa un nombre de autor.. - -Resumen -------- - -Con el componente ``Translation`` de *Symfony2*, la creación de una aplicación internacionalizada ya no tiene que ser un proceso doloroso y se reduce a sólo algunos pasos básicos: - -* Abstrae los mensajes en tu aplicación envolviendo cada uno en el método :method:`Symfony\\Component\\Translation\\Translator::trans` o :method:`Symfony\\Component\\Translation\\Translator::transChoice`; - -* Traduce cada mensaje en varias configuraciones regionales creando archivos de mensajes traducidos. *Symfony2* descubre y procesa cada archivo porque su nombre sigue una convención específica; - -* Gestiona la región del usuario, la cual está almacenada en la petición, pero también se puede poner en la sesión del usuario. - -.. _`i18n`: http://es.wikipedia.org/wiki/Internacionalizaci%C3%B3n_y_localizaci%C3%B3n -.. _`L10n`: http://es.wikipedia.org/wiki/Internacionalizaci%C3%B3n_y_localizaci%C3%B3n -.. _`función strtr`: http://www.php.net/manual/es/function.strtr.php -.. _`ISO 31-11`: http://en.wikipedia.org/wiki/Interval_(mathematics)#Notations_for_intervals -.. _`Extensión Translatable`: https://github.com/l3pp4rd/DoctrineExtensions -.. _`ISO3166 Alpha-2`: http://en.wikipedia.org/wiki/ISO_3166-1#Current_codes -.. _`ISO639-1`: http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes diff --git a/_sources/book/validation.txt b/_sources/book/validation.txt deleted file mode 100644 index 18e0012..0000000 --- a/_sources/book/validation.txt +++ /dev/null @@ -1,773 +0,0 @@ -.. index:: - single: Validando - -Validando -========= - -La validación es una tarea muy común en aplicaciones *web*. Los datos introducidos en formularios se tienen que validar. Los datos también se deben validar antes de escribirlos en una base de datos o pasarlos a un servicio *web*. - -*Symfony2* viene con un componente `Validator`_ que facilita y transparenta esta tarea. Este componente está basado en la `especificación de validación Bean JSR303`_. - -.. index:: - single: Validación; Fundamentos - -Fundamentos de la validación ----------------------------- - -La mejor manera de entender la validación es verla en acción. Para empezar, supongamos que creaste un objeto *PHP* plano el cual en algún lugar tiene que utilizar tu aplicación:: - - // src/Acme/BlogBundle/Entity/Author.php - namespace Acme\BlogBundle\Entity; - - class Author - { - public $name; - } - -Hasta ahora, esto es sólo una clase ordinaria que sirve a algún propósito dentro de tu aplicación. El objetivo de la validación es decir si o no los datos de un objeto son válidos. Para que esto funcione, debes configurar una lista de reglas (llamada :ref:`constraints ---en adelante: restricciones--- `) que el objeto debe seguir para ser válido. Estas reglas se pueden especificar a través de una serie de diferentes formatos (*YAML*, *XML*, anotaciones o *PHP*). - -Por ejemplo, para garantizar que la propiedad ``$name`` no esté vacía, agrega lo siguiente: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\Author: - properties: - name: - - NotBlank: ~ - - .. code-block:: php-annotations - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Constraints as Assert; - - class Autor - { - /** - * @Assert\NotBlank() - */ - public $name; - } - - .. code-block:: xml - - - - - - - - - - - - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\NotBlank; - - class Autor - { - public $name; - - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint('name', new NotBlank()); - } - } - -.. tip:: - - Las propiedades protegidas y privadas también se pueden validar, así como los métodos «get» (consulta la sección :ref:`validator-constraint-targets`). - -.. index:: - single: Validación; Usando el validador - -Usando el servicio ``validador`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A continuación, para validar realmente un objeto ``Author``, utiliza el método ``validate`` del servicio ``validador`` (clase :class:`Symfony\\Component\\Validator\\Validator`). -El trabajo del ``validador`` es fácil: lee las restricciones (es decir, las reglas) de una clase y comprueba si los datos en el objeto satisfacen esas restricciones. Si la validación falla, devuelve un arreglo de errores. Toma este sencillo ejemplo desde el interior de un controlador:: - - // ... - use Symfony\Component\HttpFoundation\Response; - use Acme\BlogBundle\Entity\Author; - - public function indexAction() - { - $author = new Author(); - // ... hace algo con el objeto $author - - $validator = $this->get('validator'); - $errors = $validator->validate($author); - - if (count($errors) > 0) { - return new Response(print_r($errors, true)); - } else { - return new Response('The author is valid! Yes!'); - } - } - -Si la propiedad ``$name`` está vacía, verás el siguiente mensaje de error: - -.. code-block:: text - - Acme\BlogBundle\Author.name: - This value should not be blank - -Si insertas un valor en la propiedad ``name``, aparecerá el satisfactorio mensaje de éxito. - -.. tip:: - - La mayor parte del tiempo, no interactúas directamente con el servicio ``validador`` o necesitas preocuparte por imprimir los errores. La mayoría de las veces, vas a utilizar la validación indirectamente al manejar los datos de formularios presentados. Para más información, consulta la sección :ref:`book-validation-forms`. - -También puedes pasar la colección de errores a una plantilla. - -.. code-block:: php - - if (count($errors) > 0) { - return $this->render('AcmeBlogBundle:Author:validate.html.twig', array( - 'errors' => $errors, - )); - } else { - // ... - } - -Dentro de la plantilla, puedes sacar la lista de errores exactamente como la necesites: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/BlogBundle/Resources/views/Autor/validate.html.twig #} -

The author has the following errors

-
    - {% for error in errors %} -
  • {{ error.message }}
    • - {% endfor %} -
- - .. code-block:: html+php - - -

The author has the following errors

-
    - -
  • getMessage() ?>
    • - -
- -.. note:: - - Cada error de validación (conocido cómo «violación de restricción»), está representado por un objeto :class:`Symfony\\Component\\Validator\\ConstraintViolation`. - -.. index:: - single: Validación; Validando con formularios - -.. _book-validation-forms: - -Validación y formularios -~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes utilizar el servicio ``validator`` en cualquier momento para validar cualquier objeto. -En realidad, sin embargo, por lo general al trabajar con formularios vas a trabajar con el ``validador`` indirectamente. La biblioteca de formularios de *Symfony* utiliza internamente el servicio ``validador`` para validar el objeto subyacente después de que los valores se han presentado y vinculado. Las violaciones de restricción en el objeto se convierten en objetos ``FieldError`` los cuales puedes mostrar fácilmente en tu formulario. El flujo de trabajo típico en la presentación del formulario se parece al siguiente visto desde el interior de un controlador:: - - // ... - use Acme\BlogBundle\Entity\Author; - use Acme\BlogBundle\Form\AuthorType; - use Symfony\Component\HttpFoundation\Request; - - public function updateAction(Request $request) - { - $author = new Author(); - $form = $this->createForm(new AuthorType(), $author); - - if ($request->isMethod('POST')) { - $form->bind($request); - - if ($form->isValid()) { - // validación superada, haz algo con el objeto $author - - return $this->redirect($this->generateUrl(...)); - } - } - - return $this->render('BlogBundle:Author:form.html.twig', array( - 'form' => $form->createView(), - )); - } - -.. note:: - - Este ejemplo utiliza un formulario de la clase ``AutorType``, el cual no mostramos aquí. - -Para más información, consulta el capítulo :doc:`Formularios `. - -.. index:: - pair: Validación; Configuración - -.. _book-validation-configuration: - -Configurando ------------- - -El validador de *Symfony2* está activado por omisión, pero debes habilitar explícitamente las anotaciones si estás utilizando el método de anotación para especificar tus restricciones: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - validation: { enable_annotations: true } - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('framework', array( - 'validation' => array( - 'enable_annotations' => true, - ), - )); - -.. index:: - single: Validación; Restricciones - -.. _validation-constraints: - -Restricciones -------------- - -El ``validador`` está diseñado para validar objetos contra *restricciones* (es decir, reglas). A fin de validar un objeto, basta con asignar una o más restricciones a tu clase y luego pasarla al servicio ``validador``. - -Detrás del escenario, una restricción simplemente es un objeto *PHP* que hace una declaración asertiva. En la vida real, una restricción podría ser: «El pastel no se debe quemar». -En *Symfony2*, las restricciones son similares: son aserciones de que una condición es verdadera. Dado un valor, una restricción te dirá si o no el valor se adhiere a las reglas de tu restricción. - -Restricciones compatibles -~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Symfony2* viene con un gran número de las más comunes restricciones necesarias. - -.. include:: /reference/constraints/map.rst.inc - -También puedes crear tus propias restricciones personalizadas. Este tema se trata en el artículo «:doc:`/cookbook/validation/custom_constraint`» del recetario. - -.. index:: - single: Validación; Configurando restricciones - -.. _book-validation-constraint-configuration: - -Configurando restricciones -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Algunas restricciones, como :doc:`NotBlank`, son simples, mientras que otras, como la restricción :doc:`Choice`, tienen varias opciones de configuración disponibles. Supongamos que la clase ``Autor`` tiene otra propiedad, ``género`` que se puede configurar como «masculino» o «femenino»: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\Author: - properties: - gender: - - Choice: { choices: [male, female], message: Choose a valid gender. } - - .. code-block:: php-annotations - - // src/Acme/BlogBundle/Entity/Author.php - use Symfony\Component\Validator\Constraints as Assert; - - class Autor - { - /** - * @Assert\Choice( - * choices = { "male", "female" }, - * message = "Choose a valid gender." - * ) - */ - public $gender; - } - - .. code-block:: xml - - - - - - - - - - - - - - - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\Choice; - - class Autor - { - public $gender; - - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint('gender', new Choice(array( - 'choices' => array('male', 'female'), - 'message' => 'Choose a valid gender.', - ))); - } - } - -.. _validation-default-option: - -Las opciones de una restricción siempre se pueden pasar como un arreglo. Algunas restricciones, sin embargo, también te permiten pasar el valor de una opción *«predeterminada»*, en lugar del arreglo. En el caso de la restricción ``Choice``, las ``opciones`` se pueden especificar de esta manera: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\Author: - properties: - gender: - - Choice: [male, female] - - .. code-block:: php-annotations - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Constraints as Assert; - - class Autor - { - /** - * @Assert\Choice({"male", "female"}) - */ - protected $gender; - } - - .. code-block:: xml - - - - - - - - - male - female - - - - - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\Choice; - - class Autor - { - protected $gender; - - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint( - 'gender', - new Choice(array('male', 'female')) - ); - } - } - -Esto, simplemente está destinado a hacer que la configuración de las opciones más comunes de una restricción sea más breve y rápida. - -Si alguna vez no estás seguro de cómo especificar una opción, o bien consulta la documentación de la *API* por la restricción o juega a lo seguro pasando siempre las opciones en un arreglo (el primer método se muestra más arriba). - -Traduciendo mensajes de restricción ------------------------------------ - -Para más información sobre la traducción de los mensajes de restricción, consulta :ref:`book-translation-constraint-messages`. - -.. index:: - single: Validación; Objetivos de restricción - -.. _validator-constraint-targets: - -Objetivos de restricción ------------------------- - -Las restricciones se pueden aplicar a una propiedad de clase (por ejemplo, ``name``) o a un método captador público (por ejemplo ``getFullName``). El primero es el más común y fácil de usar, pero el segundo te permite especificar reglas de validación más complejas. - -.. index:: - single: Validación; Restricción de propiedades - -.. _validation-property-target: - -Propiedades -~~~~~~~~~~~ - -La validación de propiedades de clase es la técnica de validación más básica. *Symfony2* te permite validar propiedades privadas, protegidas o públicas. El siguiente listado muestra cómo configurar la propiedad ``$firstName`` de una clase ``Author`` para que por lo menos tenga 3 caracteres. - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\Author: - properties: - firstName: - - NotBlank: ~ - - Length: - min: 3 - - .. code-block:: php-annotations - - // Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Constraints as Assert; - - class Autor - { - /** - * @Assert\NotBlank() - * @Assert\Length(min = "3") - */ - private $firstName; - } - - .. code-block:: xml - - - - - - - - - - - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\NotBlank; - use Symfony\Component\Validator\Constraints\Length; - - class Autor - { - private $firstName; - - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint('firstName', new NotBlank()); - $metadata->addPropertyConstraint( - 'firstName', - new Length(array("min" => 3))); - } - } - -.. index:: - single: Validación; Restricción de captadores - -Captadores -~~~~~~~~~~ - -Las restricciones también se pueden aplicar al valor devuelto por un método. *Symfony2* te permite agregar una restricción a cualquier método público cuyo nombre comience con ``get`` o ``is``. En esta guía, ambos métodos de este tipo son conocidos como «captadores» o ``getters``. - -La ventaja de esta técnica es que te permite validar el objeto de forma dinámica. Por ejemplo, supongamos que quieres asegurarte de que un campo de contraseña no coincide con el nombre del usuario (por razones de seguridad). Puedes hacerlo creando un método ``isPasswordLegal``, a continuación, acertar que este método debe devolver ``true``: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\Author: - getters: - passwordLegal: - - "True": { message: "The password cannot match your first name" } - - .. code-block:: php-annotations - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Constraints as Assert; - - class Autor - { - /** - * @Assert\True(message = "The password cannot match your first name") - */ - public function isPasswordLegal() - { - // devuelve 'true' o 'false' - } - } - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\True; - - class Autor - { - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addGetterConstraint('passwordLegal', new True(array( - 'message' => 'The password cannot match your first name', - ))); - } - } - -Ahora, crea el método ``isPasswordLegal()`` e incluye la lógica que necesites:: - - public function isPasswordLegal() - { - return ($this->firstName != $this->password); - } - -.. note:: - - El ojo perspicaz se habrá dado cuenta de que el prefijo del captador (``get`` o ``is``) se omite en la asignación. Esto te permite mover la restricción a una propiedad con el mismo nombre más adelante (o viceversa) sin cambiar la lógica de validación. - -.. _validation-class-target: - -Clases -~~~~~~ - -Algunas restricciones se aplican a toda la clase que se va a validar. Por ejemplo, la restricción :doc:`Retrollamada ` es una restricción que se aplica a la clase en sí misma: Cuando se valide esa clase, los métodos especificados por esta restricción se ejecutarán simplemente para que cada uno pueda proporcionar una validación más personalizada. - -.. _book-validation-validation-groups: - -Validando grupos ----------------- - -Hasta ahora, hemos sido capaces de agregar restricciones a una clase y consultar si o no esa clase pasa todas las restricciones definidas. En algunos casos, sin embargo, tendrás que validar un objeto contra únicamente *algunas* restricciones de esa clase. Para ello, puedes organizar cada restricción en uno o más «grupos de validación», y luego aplicar la validación contra un solo grupo de restricciones. - -Por ejemplo, supongamos que tienes una clase ``Usuario``, la cual se usa más adelante tanto cuando un usuario se registra como cuando un usuario actualiza su información de contacto: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\User: - properties: - email: - - Email: { groups: [registration] } - password: - - NotBlank: { groups: [registration] } - - Length: { min: 7, groups: [registration] } - city: - - Length: - min: 2 - - .. code-block:: php-annotations - - // src/Acme/BlogBundle/Entity/User.php - namespace Acme\BlogBundle\Entity; - - use Symfony\Component\Security\Core\User\UserInterface; - use Symfony\Component\Validator\Constraints as Assert; - - class User implements UserInterface - { - /** - * @Assert\Email(groups={"registration"}) - */ - private $email; - - /** - * @Assert\NotBlank(groups={"registration"}) - * @Assert\Length(min=7, groups={"registration"}) - */ - private $password; - - /** - * @Assert\Length(min = "2") - */ - private $city; - } - - .. code-block:: xml - - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/User.php - namespace Acme\BlogBundle\Entity; - - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints\Email; - use Symfony\Component\Validator\Constraints\NotBlank; - use Symfony\Component\Validator\Constraints\Length; - - class User - { - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint('email', new Email(array( - 'groups' => array('registration'), - ))); - - $metadata->addPropertyConstraint('password', new NotBlank(array( - 'groups' => array('registration'), - ))); - $metadata->addPropertyConstraint('password', new Length(array( - 'min' => 7, - 'groups' => array('registration') - ))); - - $metadata->addPropertyConstraint( - 'city', - Length(array("min" => 3))); - } - } - -Con esta configuración, hay dos grupos de validación: - -* contiene las restricciones no asignadas a algún otro grupo; - -* contiene restricciones sólo en los campos de ``email`` y ``password``. - -Para decir al validador que use un grupo específico, pasa uno o más nombres de grupo como segundo argumento al método ``validate()``:: - - $errors = $validator->validate($author, array('registration')); - -Por supuesto, por lo general vas a trabajar con la validación indirectamente a través de la biblioteca de formularios. Para obtener información sobre cómo utilizar la validación de grupos dentro de los formularios, consulta :ref:`book-forms-validation-groups`. - -.. index:: - single: Validación; Validando valores crudos - -.. _book-validation-raw-values: - -Validando valores y arreglos ----------------------------- - -Hasta ahora, hemos visto cómo puedes validar objetos completos. Pero a veces, sólo deseas validar un único valor ---como verificar que una cadena es una dirección de correo electrónico válida---. Esto realmente es muy fácil de hacer. Desde el interior de un controlador, se ve así:: - - use Symfony\Component\Validator\Constraints\Email; - // ... - - public function addEmailAction($email) - { - $emailConstraint = new Email(); - // puedes fijar todas las "opciones" de restricción de esta manera - $emailConstraint->message = 'Invalid email address'; - - // usa el validador para validar el valor - $errorList = $this->get('validator')->validateValue( - $email, - $emailConstraint - ); - - if (count($errorList) == 0) { - // esta ES una dirección de correo válida, haz algo - } else { - // esta *no* es una dirección de correo electrónico válida - $errorMessage = $errorList[0]->getMessage(); - - // ... haz algo con el error - } - - // ... - } - -Al llamar a ``validateValue`` en el validador, puedes pasar un valor en bruto y el objeto restricción contra el cual deseas validar el valor. Una lista completa de restricciones disponibles ---así como el nombre de clase completo para cada restricción--- está disponible en la sección :doc:`referencia de restricciones `. - -El método ``validateValue`` devuelve un objeto :class:`Symfony\\Component\\Validator\\ConstraintViolationList`, que actúa como un arreglo de errores. Cada error de la colección es un objeto :class:`Symfony\\Component\\Validator\\ConstraintViolation`, que contiene el mensaje de error en su método ``getMessage``. - -Consideraciones finales ------------------------ - -El ``validador`` de *Symfony2* es una herramienta poderosa que puedes aprovechar para garantizar que los datos de cualquier objeto son «válidos». El poder detrás de la validación radica en las «restricciones», las cuales son reglas que se pueden aplicar a propiedades o métodos captadores de tu objeto. Y mientras más utilices la plataforma de validación indirectamente cuando uses formularios, recordarás que puedes utilizarla en cualquier lugar para validar cualquier objeto. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/validation/custom_constraint` - -.. _`Validator`: https://github.com/symfony/Validator -.. _`especificación de validación Bean JSR303`: http://jcp.org/en/jsr/detail?id=303 diff --git a/_sources/bundles/DoctrineFixturesBundle/index.txt b/_sources/bundles/DoctrineFixturesBundle/index.txt deleted file mode 100644 index 9799cd1..0000000 --- a/_sources/bundles/DoctrineFixturesBundle/index.txt +++ /dev/null @@ -1,308 +0,0 @@ -``DoctrineFixturesBundle`` -========================== - -Los accesorios se utilizan para cargar en una base de datos un juego de datos controlado. Puedes utilizar estos datos para pruebas o podrían ser los datos iniciales necesarios para ejecutar la aplicación sin problemas. *Symfony2* no tiene integrada forma alguna de administrar accesorios, pero *Doctrine2* cuenta con una biblioteca para ayudarte a escribir accesorios para el :doc:`ORM ` u :doc:`ODM ` de *Doctrine*. - -Instalando y configurando -------------------------- - -Los accesorios de *Doctrine* para *Symfony* se mantienen en el `DoctrineMigrationsBundle`_. -El paquete utiliza la biblioteca externa de `Datos accesorios de Doctrine`_. - -Sigue estos pasos para instalar el paquete y la biblioteca en la edición estándar de *Symfony*. Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: json - - { - "require": { - "doctrine/doctrine-fixtures-bundle": "dev-master" - } - } - -Actualiza las bibliotecas de proveedores: - -.. code-block:: bash - - $ php composer.phar update - -Si todo va bien, el ``DoctrineFixturesBundle`` ahora se puede encontrar en ``vendor/doctrine/doctrine-fixtures-bundle``. - -.. note:: - - ``DoctrineFixturesBundle`` instala la biblioteca de `Datos accesorios de Doctrine`_. La biblioteca se puede encontrar en ``vendor/doctrine/data-fixtures``. - -Por último, registra el paquete ``DoctrineFixturesBundle`` en ``app/AppKernel.php``. - -.. code-block:: php - - // ... - public function registerBundles() - { - $bundles = array( - // ... - new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(), - // ... - ); - // ... - } - -Escribiendo accesorios sencillos --------------------------------- - -Los accesorios de *Doctrine2* son clases *PHP* que pueden crear y persistir objetos a la base de datos. Al igual que todas las clases en *Symfony2*, los accesorios deben vivir dentro de uno de los paquetes de tu aplicación. - -Para un paquete situado en ``src/Acme/HelloBundle``, las clases accesorio deben vivir dentro de ``src/Acme/HelloBundle/DataFixtures/ORM`` o ``src/Acme/HelloBundle/DataFixtures/MongoDB``, para *ORM* y *ODM* respectivamente, esta guía asume que estás utilizando el *ORM* --- pero, los accesorios se pueden agregar con la misma facilidad si estás utilizando *ODM*. - -Imagina que tienes una clase ``User``, y te gustaría cargar un nuevo ``Usuario``: - -.. code-block:: php - - // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserData.php - - namespace Acme\HelloBundle\DataFixtures\ORM; - - use Doctrine\Common\DataFixtures\FixtureInterface; - use Doctrine\Common\Persistence\ObjectManager; - use Acme\HelloBundle\Entity\User; - - class LoadUserData implements FixtureInterface - { - /** - * {@inheritDoc} - */ - public function load(ObjectManager $manager) - { - $userAdmin = new User(); - $userAdmin->setUsername('admin'); - $userAdmin->setPassword('test'); - - $manager->persist($userAdmin); - $manager->flush(); - } - } - -En *Doctrine2*, los accesorios sólo son objetos en los que cargas datos interactuando con tus entidades como lo haces normalmente. Esto te permite crear el accesorio exacto que necesitas para tu aplicación. - -La limitación más importante es que no puedes compartir objetos entre accesorios. -Más adelante, veremos la manera de superar esta limitación. - -Ejecutando accesorios ---------------------- - -Una vez que has escrito tus accesorios, los puedes cargar a través de la línea de ordenes usando la orden ``doctrine:fixtures:load`` - -.. code-block:: bash - - php app/console doctrine:fixtures:load - -Si estás utilizando *ODM*, en su lugar usa la orden ``doctrine:mongodb:fixtures:load``: - -.. code-block:: bash - - php app/console doctrine:mongodb:fixtures:load - -La tarea verá dentro del directorio ``DataFixtures/ORM`` (o ``DataFixtures/MongoDB`` para *ODM*) de cada paquete y ejecutará cada clase que implemente la ``FixtureInterface``. - -Ambas ordenes vienen con unas cuantas opciones: - -* ``--fixtures=/ruta/al/accesorio`` --- Usa esta opción para especificar manualmente el directorio de donde se deben cargar las clases accesorio; - -* ``--append`` --- Utiliza esta opción para añadir datos en lugar de eliminarlos antes de cargarlos (borrar primero es el comportamiento predeterminado); - -* ``--em=manager_name`` --- Especifica manualmente el gestor de la entidad a utilizar para cargar los datos. - -.. note:: - - Si utilizas la tarea ``doctrine:mongodb:fixtures:load``, reemplaza la opción ``--em=`` con ``--dm=`` para especificar manualmente el gestor de documentos. - -Un ejemplo de uso completo podría tener este aspecto: - -.. code-block:: bash - - php app/console doctrine:fixtures:load --fixtures=/ruta/al/accesorio1 --fixtures=/ruta/al/accesorio2 --append --em=gestor_foo - -Compartiendo objetos entre accesorios -------------------------------------- - -Escribir un accesorio básico es sencillo. Pero, ¿si tienes varias clases de accesorios y quieres poder referirte a los datos cargados en otras clases accesorio? -Por ejemplo, ¿qué pasa si cargas un objeto ``Usuario`` en un accesorio, y luego quieres mencionar una referencia a un accesorio diferente con el fin de asignar dicho usuario a un grupo particular? - -La biblioteca de accesorios de *Doctrine* maneja esto fácilmente permitiéndote especificar el orden en que se cargan los accesorios. - -.. code-block:: php - - // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserData.php - namespace Acme\HelloBundle\DataFixtures\ORM; - - use Doctrine\Common\DataFixtures\AbstractFixture; - use Doctrine\Common\DataFixtures\OrderedFixtureInterface; - use Doctrine\Common\Persistence\ObjectManager; - use Acme\HelloBundle\Entity\User; - - class LoadUserData extends AbstractFixture implements OrderedFixtureInterface - { - /** - * {@inheritDoc} - */ - public function load(ObjectManager $manager) - { - $userAdmin = new User(); - $userAdmin->setUsername('admin'); - $userAdmin->setPassword('test'); - - $manager->persist($userAdmin); - $manager->flush(); - - $this->addReference('admin-user', $userAdmin); - } - - /** - * {@inheritDoc} - */ - public function getOrder() - { - return 1; // el orden en el cual serán cargados los accesorios - } - } - -La clase accesorio ahora implementa la ``OrderedFixtureInterface``, la cual dice a *Doctrine* que deseas controlar el orden de tus accesorios. Crea otra clase accesorio y haz que se cargue después de ``LoadUserData`` devolviendo un orden de 2: - -.. code-block:: php - - // src/Acme/HelloBundle/DataFixtures/ORM/LoadGroupData.php - - namespace Acme\HelloBundle\DataFixtures\ORM; - - use Doctrine\Common\DataFixtures\AbstractFixture; - use Doctrine\Common\DataFixtures\OrderedFixtureInterface; - use Doctrine\Common\Persistence\ObjectManager; - use Acme\HelloBundle\Entity\Group; - - class LoadGroupData extends AbstractFixture implements OrderedFixtureInterface - { - /** - * {@inheritDoc} - */ - public function load(ObjectManager $manager) - { - $groupAdmin = new Group(); - $groupAdmin->setGroupName('admin'); - - $manager->persist($groupAdmin); - $manager->flush(); - - $this->addReference('admin-group', $groupAdmin); - } - - /** - * {@inheritDoc} - */ - public function getOrder() - { - return 2; // el orden en el cual serán cargados los accesorios - } - } - -Ambas clases accesorio extienden ``AbstractFixture``, lo cual te permite crear objetos y luego ponerlos como referencias para que se puedan utilizar posteriormente en otros accesorios. Por ejemplo, más tarde puedes referirte a los objetos ``$userAdmin`` y ``$groupAdmin`` a través de las referencias ``admin-user`` y ``admin-group``: - -.. code-block:: php - - // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserGroupData.php - - namespace Acme\HelloBundle\DataFixtures\ORM; - - use Doctrine\Common\DataFixtures\AbstractFixture; - use Doctrine\Common\DataFixtures\OrderedFixtureInterface; - use Doctrine\Common\Persistence\ObjectManager; - use Acme\HelloBundle\Entity\UserGroup; - - class LoadUserGroupData extends AbstractFixture implements OrderedFixtureInterface - { - /** - * {@inheritDoc} - */ - public function load(ObjectManager $manager) - { - $userGroupAdmin = new UserGroup(); - $userGroupAdmin->setUser($this->getReference('admin-user')); - $userGroupAdmin->setGroup($this->getReference('admin-group')); - - $manager->persist($userGroupAdmin); - $manager->flush(); - } - - /** - * {@inheritDoc} - */ - public function getOrder() - { - return 3; - } - } - -Los accesorios ahora se ejecutan en el orden ascendente del valor devuelto por ``getOrder()``. Cualquier objeto que se establece con el método ``setReference()`` se puede acceder a través de ``getReference()`` en las clases accesorio que tienen un orden superior. - -Los accesorios te permiten crear cualquier tipo de dato que necesites a través de la interfaz normal de *PHP* para crear y persistir objetos. Al controlar el orden de los accesorios y establecer referencias, puedes manejar casi todo por medio de accesorios. - -Usando el contenedor en los accesorios --------------------------------------- - -En algunos casos necesitarás acceder a algunos servicios para cargar los accesorios. -*Symfony2* hace esto realmente fácil. El contenedor se inyectará en todas las clases accesorio que implementen la :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareInterface`. - -Vamos a rescribir el primer accesorio para codificar la contraseña antes de almacenarla en la base de datos (una muy buena práctica). Esto utilizará el generador de codificadores para codificar la contraseña, garantizando que está codificada en la misma forma que la utiliza el componente de seguridad al efectuar la verificación: - -.. code-block:: php - - // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserData.php - - namespace Acme\HelloBundle\DataFixtures\ORM; - - use Doctrine\Common\DataFixtures\FixtureInterface; - use Symfony\Component\DependencyInjection\ContainerAwareInterface; - use Symfony\Component\DependencyInjection\ContainerInterface; - use Acme\HelloBundle\Entity\User; - - class LoadUserData implements FixtureInterface, ContainerAwareInterface - { - /** - * @var ContainerInterface - */ - private $container; - - /** - * {@inheritDoc} - */ - public function setContainer(ContainerInterface $container = null) - { - $this->container = $container; - } - - /** - * {@inheritDoc} - */ - public function load(ObjectManager $manager) - { - $user = new User(); - $user->setUsername('admin'); - $user->setSalt(md5(uniqid())); - - $encoder = $this->container - ->get('security.encoder_factory') - ->getEncoder($user) - ; - $user->setPassword($encoder->encodePassword('secret', $user->getSalt())); - - $manager->persist($user); - $manager->flush(); - } - } - -Como puedes ver, todo lo que necesitas hacer es agregar :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareInterface` a la clase y luego crear un nuevo método :method:`Symfony\\Component\\DependencyInjection\\ContainerInterface::setContainer` que implemente esa interfaz. Antes de ejecutar el accesorio, *Symfony* automáticamente llamará al método :method:`Symfony\\Component\\DependencyInjection\\ContainerInterface::setContainer`. Siempre y cuando guardes el contenedor como una propiedad en la clase (como se muestra arriba), puedes acceder a él en el método ``load()``. - -.. note:: - - Si te da flojera implementar el método necesario :method:`Symfony\\Component\\DependencyInjection\\ContainerInterface::setContainer`, entonces, puedes extender tu clase con :class:`Symfony\\Component\\DependencyInjection\\ContainerAware`. - -.. _DoctrineFixturesBundle: https://github.com/doctrine/DoctrineFixturesBundle -.. _`Datos accesorios de Doctrine`: https://github.com/doctrine/data-fixtures diff --git a/_sources/bundles/DoctrineMigrationsBundle/index.txt b/_sources/bundles/DoctrineMigrationsBundle/index.txt deleted file mode 100644 index 11fbec7..0000000 --- a/_sources/bundles/DoctrineMigrationsBundle/index.txt +++ /dev/null @@ -1,241 +0,0 @@ -``DoctrineMigrationsBundle`` -============================ - -La funcionalidad de migración de base de datos, es una extensión de la capa de abstracción de bases de datos y te ofrece la posibilidad de desplegar programáticamente nuevas versiones del esquema de la base de datos de forma segura y estandarizada. - -.. tip:: - - Puedes leer más sobre las migraciones de base de datos de *Doctrine* en la `documentación`_ del proyecto. - -Instalando ----------- - -Las migraciones de *Doctrine* para *Symfony* se mantienen en el `DoctrineMigrationsBundle`_. -El paquete usa la biblioteca `Migraciones de Base de datos de Doctrine`_. - -Sigue estos pasos para instalar el paquete y la biblioteca en la edición estándar de *Symfony*. Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: json - - { - "require": { - "doctrine/doctrine-migrations-bundle": "dev-master" - } - } - -Actualiza las bibliotecas de proveedores: - -.. code-block:: bash - - $ php composer.phar update - -Si todo funciona, ahora puedes encontrar la biblioteca ``DoctrineMigrationsBundle`` en ``vendor/doctrine/doctrine-migrations-bundle``. - -.. note:: - - ``DoctrineMigrationsBundle`` instala la biblioteca `Migraciones de Base de datos de Doctrine`_. Puedes encontrar la biblioteca en ``vendor/doctrine/migrations``. - -Por último, asegúrate de activar el paquete en ``AppKernel.php`` incluyendo lo siguiente: - -.. code-block:: php - - // app/AppKernel.php - public function registerBundles() - { - $bundles = array( - //... - new Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle(), - ); - } - -Usando ------- - -Toda la funcionalidad de las migraciones se encuentra en unas cuantas ordenes de consola: - -.. code-block:: bash - - doctrine:migrations - :diff Genera una migración comparando tu base de datos actual - a tu información asignada. - :execute Ejecuta manualmente una sola versión de migración hacia - arriba o abajo. - :generate Genera una clase de migración en blanco. - :migrate Ejecuta una migración a una determinada versión o, a la - última versión disponible. - :status Ve el estado de un conjunto de migraciones. - :version Añade y elimina versiones de migración manualmente desde - la tabla de versiones. - -Empieza consiguiendo la situación de las migraciones en tu aplicación ejecutando la orden ``status``: - -.. code-block:: bash - - php app/console doctrine:migrations:status - - == Configuration - - >> Name: Application Migrations - >> Configuration Source: manually configured - >> Version Table Name: migration_versions - >> Migrations Namespace: Application\Migrations - >> Migrations Directory: /ruta/a/proyecto/app/DoctrineMigrations - >> Current Version: 0 - >> Latest Version: 0 - >> Executed Migrations: 0 - >> Available Migrations: 0 - >> New Migrations: 0 - -Ahora, podemos empezar a trabajar con las migraciones generando una nueva clase de migración en blanco. Más adelante, aprenderás cómo puedes generar migraciones automáticamente con *Doctrine*. - -.. code-block:: bash - - php app/console doctrine:migrations:generate - Nueva clase migración generada para "/ruta/a/tu/proyecto/app/DoctrineMigrations/Version20100621140655.php" - -Echa un vistazo a la clase migración recién generada y verás algo como lo siguiente:: - - namespace Application\Migrations; - - use Doctrine\DBAL\Migrations\AbstractMigration, - Doctrine\DBAL\Schema\Schema; - - class Version20100621140655 extends AbstractMigration - { - public function up(Schema $schema) - { - - } - - public function down(Schema $schema) - { - - } - } - -Si ahora ejecutas la orden ``status`` te mostrará que tienes una nueva migración por ejecutar: - -.. code-block:: bash - - php app/console doctrine:migrations:status - - == Configuration - - >> Name: Application Migrations - >> Configuration Source: manually configured - >> Version Table Name: migration_versions - >> Migrations Namespace: Application\Migrations - >> Migrations Directory: /ruta/a/proyecto/app/DoctrineMigrations - >> Current Version: 0 - >> Latest Version: 2010-06-21 14:06:55 (20100621140655) - >> Executed Migrations: 0 - >> Available Migrations: 1 - >> New Migrations: 1 - - == Versiones de migración - - >> 2011-06-21 14:06:55 (20110621140655) no migrada - -Ahora puedes agregar algo de código de migración a los métodos ``up()`` y ``down()``, y finalmente cuando estés listo migrar: - -.. code-block:: bash - - php app/console doctrine:migrations:migrate - -Para más información sobre cómo escribir migraciones en sí mismas (es decir, la manera de rellenar los métodos ``up()`` y ``down()``), consulta la `documentación`_ oficial de las Migraciones de *Doctrine*. - -Ejecutando migraciones al desplegar tu aplicación -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Por supuesto, el objetivo final al escribir migraciones es poder utilizarlas para actualizar de manera fiable la estructura de tu base de datos cuando despliegues tu aplicación. -Al ejecutar las migraciones localmente (o en un servidor de pruebas), puedes asegurarte de que las migraciones trabajan según lo previsto. - -Cuando finalmente despliegues tu aplicación, sólo tienes que recordar ejecutar la orden ``doctrine:migrations:migrate``. Internamente, *Doctrine* crea una tabla ``migration_versions`` dentro de la base de datos y allí lleva a cabo el seguimiento de las migraciones que se han ejecutado. Por lo tanto, no importa cuantas migraciones hayas creado y ejecutado localmente, cuando se ejecuta la orden durante el despliegue, *Doctrine* sabrá exactamente qué migraciones no se han ejecutado todavía mirando la tabla ``migration_versions`` de tu base de datos en producción. Independientemente de qué servidor esté activado, siempre puedes ejecutar esta orden de forma segura para realizar sólo las migraciones que todavía no se han llevado a cabo en *esa* base de datos particular. - -Generando migraciones automáticamente -------------------------------------- - -En realidad, no deberías tener que escribir migraciones manualmente, puesto que la biblioteca de migraciones puede generar las clases de la migración automáticamente comparando tu información asignada a *Doctrine* (es decir, cómo se *debe* ver tu base de datos) con la estructura de la base de datos actual. - -Por ejemplo, supongamos que creas una nueva entidad ``Usuario`` y agregas información asignándola al *ORM* de *Doctrine*: - -.. configuration-block:: - - .. code-block:: php-annotations - - // src/Acme/HelloBundle/Entity/User.php - namespace Acme\HelloBundle\Entity; - - use Doctrine\ORM\Mapping as ORM; - - /** - * @ORM\Entity - * @ORM\Table(name="hello_user") - */ - class User - { - /** - * @ORM\Id - * @ORM\Column(type="integer") - * @ORM\GeneratedValue(strategy="AUTO") - */ - protected $id; - - /** - * @ORM\Column(type="string", length="255") - */ - protected $name; - } - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/doctrine/User.orm.yml - Acme\HelloBundle\Entity\User: - type: entity - table: hello_user - id: - id: - type: integer - generator: - strategy: AUTO - fields: - name: - type: string - length: 255 - - .. code-block:: xml - - - - - - - - - - - - - -Con esta información, *Doctrine* ya está listo para ayudarte a persistir tu nuevo objeto ``Usuario`` hacia y desde la tabla ``hello_user``. Por supuesto, ¡esta tabla no existe aún! Genera una nueva migración para esta tabla automáticamente ejecutando la siguiente orden: - -.. code-block:: bash - - php app/console doctrine:migrations:diff - -Deberás ver un mensaje informando que se ha generado una nueva clase migración basada en las diferencias del esquema. Si abres ese archivo, encontrarás que tiene el código *SQL* necesario para crear la tabla ``hello_user``. A continuación, ejecuta la migración para agregar la tabla a tu base de datos: - -.. code-block:: bash - - php app/console doctrine:migrations:migrate - -La moraleja de la historia es la siguiente: después de cada cambio que realices en tu información de asignación a *Doctrine*, ejecuta la orden ``doctrine:migrations:diff`` para generar automáticamente las clases de la migración. - -Si lo haces desde el principio de tu proyecto (es decir, de modo que incluso las primeras tablas fueran cargadas a través de una clase migración), siempre podrás crear una base de datos actualizada y ejecutar las migraciones a fin de tener tu esquema de base de datos totalmente actualizado. De hecho, este es un flujo de trabajo fácil y confiable para tu proyecto. - -.. _`documentación`: http://docs.doctrine-project.org/projects/doctrine-migrations/en/latest/index.html -.. _`DoctrineMigrationsBundle`: https://github.com/doctrine/DoctrineMigrationsBundle -.. _`Migraciones de Base de datos de Doctrine`: https://github.com/doctrine/migrations diff --git a/_sources/bundles/DoctrineMongoDBBundle/config.txt b/_sources/bundles/DoctrineMongoDBBundle/config.txt deleted file mode 100644 index aaa0dc8..0000000 --- a/_sources/bundles/DoctrineMongoDBBundle/config.txt +++ /dev/null @@ -1,295 +0,0 @@ -Configurando ``DoctrineMongoDBBundle`` -====================================== - -Configuración de ejemplo ------------------------- - -.. code-block:: yaml - - # app/config/config.yml - doctrine_mongodb: - connections: - default: - server: mongodb://localhost:27017 - options: {} - default_database: hello_%kernel.environment% - document_managers: - default: - mappings: - AcmeDemoBundle: ~ - filters: - filter-name: - class: Class\Example\Filter\ODM\ExampleFilter - enabled: true - metadata_cache_driver: array # array, apc, xcache, memcache - -Si deseas utilizar ``memcache`` para memorizar tus metadatos, es necesario configurar la instancia ``Memcache``; por ejemplo, puedes hacer lo siguiente: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_mongodb: - default_database: hello_%kernel.environment% - connections: - default: - server: mongodb://localhost:27017 - options: {} - document_managers: - default: - mappings: - AcmeDemoBundle: ~ - metadata_cache_driver: - type: memcache - class: Doctrine\Common\Cache\MemcacheCache - host: localhost - port: 11211 - instance_class: Memcache - - .. code-block:: xml - - - - - - - - - - Doctrine\Common\Cache\MemcacheCache - localhost - 11211 - Memcache - - - - - - - - - -Configurando la asignación -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La definición explícita de todos los documentos asignados es la única configuración necesaria para *ODM* y hay varias opciones de configuración que puedes controlar. Existen las siguientes opciones de configuración para una asignación: - -- ``type`` Uno de ``annotations``, ``xml``, ``yml``, ``php`` o ``staticphp``. - Esta especifica cual tipo de metadatos usa el tipo de tu asignación. - -- ``dir`` Ruta a los archivos de entidad o asignación (dependiendo del controlador). Si esta ruta es relativa, se supone que es relativa a la raíz del paquete. Esto sólo funciona si el nombre de tu asignación es un nombre de paquete. Si deseas utilizar esta opción para especificar rutas absolutas debes prefijar la ruta con los parámetros del núcleo existentes en el *DIC* (por ejemplo ``%kernel.root_dir%``). - -- ``prefix`` Un prefijo de espacio de nombres común que comparten todos los documentos de esta asignación. Este prefijo no debe entrar en conflicto con otros prefijos definidos por otras asignaciones, de otra manera *Doctrine* no podrá encontrar algunos de tus documentos. Esta opción, por omisión, es el espacio de nombres del paquete + ``Document``, por ejemplo, para un paquete de la aplicación llamada ``AcmeHelloBundle``, el prefijo sería ``Acme\HelloBundle\Document``. - -- ``alias`` *Doctrine* ofrece una forma simple para rebautizar el espacio de nombres de los documentos, los nombres más cortos se utilizan en las consultas o para acceder al repositorio. - -* ``is_bundle`` Esta opción es un valor derivado de ``dir`` y por omisión se establece en ``true`` si ``dir`` es relativo provisto por un ``file_exists()`` verifica que devuelve ``false``. Este es ``false`` si al comprobar la existencia devuelve ``true``. En este caso has especificado una ruta absoluta y es más probable que los archivos de metadatos estén en un directorio fuera del paquete. - -Para evitar tener que configurar un montón de información para tus asignaciones, debes seguir los siguientes convenios: - -1. Pon todos tus documentos en un directorio ``Document/`` dentro de tu paquete. Por ejemplo ``Acme/HelloBundle/Document/``. - -2. Si estás usando asignación ``xml``, ``php`` o ``yml`` coloca todos tus archivos de configuración en el directorio ``Resources/config/doctrine/`` con el sufijo ``mongodb.xml``, ``mongodb.yml`` o ``mongodb.php`` respectivamente. - -3. Asume anotaciones si es un ``Document/`` pero no se encuentra el directorio ``Resources/config/doctrine/``. - -La siguiente configuración muestra un montón de ejemplos de asignación: - -.. code-block:: yaml - - doctrine_mongodb: - document_managers: - default: - mappings: - MyBundle1: ~ - MyBundle2: yml - MyBundle3: { type: annotation, dir: Documents/ } - MyBundle4: { type: xml, dir: Resources/config/doctrine/mapping } - MyBundle5: - type: yml - dir: my-bundle-mappings-dir - alias: BundleAlias - doctrine_extensions: - type: xml - dir: %kernel.root_dir%/../src/vendor/DoctrineExtensions/lib/DoctrineExtensions/Documents - prefix: DoctrineExtensions\Documents\ - alias: DExt - -Filtros -~~~~~~~ - -Fácilmente puedes añadir filtros a un gestor de documentos utilizando la siguiente sintaxis: - -.. code-block:: yaml - - doctrine_mongodb: - document_managers: - default: - filters: - filter-one: - class: Class\ExampleOne\Filter\ODM\ExampleFilter - enabled: true - filter-two: - class: Class\ExampleTwo\Filter\ODM\ExampleFilter - enabled: false - -Los filtros se usan para añadir condiciones al ``queryBuilder`` sin tener en cuenta dónde se generó la consulta. - -Múltiples conexiones -~~~~~~~~~~~~~~~~~~~~ - -Si necesitas múltiples conexiones y gestores de documentos puedes utilizar la siguiente sintaxis: - -.. configuration-block - - .. code-block:: yaml - - doctrine_mongodb: - default_database: hello_%kernel.environment% - default_connection: conn2 - default_document_manager: dm2 - metadata_cache_driver: apc - connections: - conn1: - server: mongodb://localhost:27017 - conn2: - server: mongodb://localhost:27017 - document_managers: - dm1: - connection: conn1 - metadata_cache_driver: xcache - mappings: - AcmeDemoBundle: ~ - dm2: - connection: conn2 - mappings: - AcmeHelloBundle: ~ - - .. code-block:: xml - - - - - - - - - - - - - - - - - - - - - - - -Ahora puedes recuperar los servicios configurados conectando servicios:: - - $conn1 = $container->get('doctrine_mongodb.odm.conn1_connection'); - $conn2 = $container->get('doctrine_mongodb.odm.conn2_connection'); - -Y también puedes recuperar los gestores de servicios de documentos configurados que utilizan la conexión de servicios anterior:: - - $dm1 = $container->get('doctrine_mongodb.odm.dm1_document_manager'); - $dm2 = $container->get('doctrine_mongodb.odm.dm2_document_manager'); - -Conectando un grupo de servidores ``mongodb`` en 1 conexión -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Es posible conectarse a varios servidores ``mongodb`` en una conexión si utilizas un conjunto de réplicas haciendo una lista de todos los servidores dentro de la cadena de conexión como una lista separada por comas. - -.. configuration-block:: - - .. code-block:: yaml - - doctrine_mongodb: - # ... - connections: - default: - server: 'mongodb://mongodb-01:27017,mongodb-02:27017,mongodb-03:27017' - -Dónde ``mongodb-01``, ``mongodb-02`` y ``mongodb-03`` son los nombres de las máquinas anfitrionas. También puedes utilizar direcciones *IP*, si lo prefiere. - -Volviendo a intentar conexiones y sonsultas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*MongoDB* de *Doctrine* automáticamente es compatible con reintentos de conexión y consultas despues de encontrar una excepción, lo cual es útil cuando tratas con situaciones como conjunto de réplicas para la recuperación de fallos. Esto alivia mucha de la necesidad de capturar las excepciones del controlador *MongoDB* de *PHP* en la aplicación y volver a intentar esas operaciones manualmente. - -Puedes especificar el número de veces en que se reintentarán las conexiones y consultas a través de las opciones ``retry_connect`` y ``retry_query`` en la configuración del gestor de documentos. -Estas opciones de manerea predeterminada están en cero, lo cual significa que ninguna operación se volverá a intentar. - -Configuración predeterminada completa -------------------------------------- - -.. configuration-block:: - - .. code-block:: yaml - - doctrine_mongodb: - document_managers: - - # Prototype - id: - connection: ~ - database: ~ - logging: true - auto_mapping: false - retry_connect: 0 - retry_query: 0 - metadata_cache_driver: - type: ~ - class: ~ - host: ~ - port: ~ - instance_class: ~ - mappings: - - # Prototipo - name: [] - mapping: true - type: ~ - dir: ~ - prefix: ~ - alias: ~ - is_bundle: ~ - connections: - - # Prototype - id: - server: ~ - options: - connect: ~ - persist: ~ - timeout: ~ - replicaSet: ~ - username: ~ - password: ~ - proxy_namespace: MongoDBODMProxies - proxy_dir: %kernel.cache_dir%/doctrine/odm/mongodb/Proxies - auto_generate_proxy_classes: false - hydrator_namespace: Hydrators - hydrator_dir: %kernel.cache_dir%/doctrine/odm/mongodb/Hydrators - auto_generate_hydrator_classes: false - default_document_manager: ~ - default_connection: ~ - default_database: default diff --git a/_sources/bundles/DoctrineMongoDBBundle/form.txt b/_sources/bundles/DoctrineMongoDBBundle/form.txt deleted file mode 100644 index 63bb70a..0000000 --- a/_sources/bundles/DoctrineMongoDBBundle/form.txt +++ /dev/null @@ -1,248 +0,0 @@ -Cómo implementar un sencillo formulario de inscripción con *MongoDB* -==================================================================== - -Algunos formularios tienen campos adicionales cuyos valores no es necesario almacenar en la base de datos. En este ejemplo, crearás un formulario de registro con algunos campos adicionales, además, incluirás en el formulario un campo «términos aceptados» (como casilla de verificación), el cual en realidad no se almacena en la información de la cuenta. Vamos a utilizar *MongoDB* para almacenar los datos. - -El modelo de Usuario simple ---------------------------- - -Por lo tanto, en esta guía comenzarás con el modelo para un documento ``Usuario``:: - - // src/Acme/AccountBundle/Document/User.php - namespace Acme\AccountBundle\Document; - - use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB; - use Symfony\Component\Validator\Constraints as Assert; - use Doctrine\Bundle\MongoDBBundle\Validator\Constraints\Unique as MongoDBUnique; - - /** - * @MongoDB\Document(collection="users") - * @MongoDBUnique(fields="email") - */ - class User - { - /** - * @MongoDB\Id - */ - protected $id; - - /** - * @MongoDB\Field(type="string") - * @Assert\NotBlank() - * @Assert\Email() - */ - protected $email; - - /** - * @MongoDB\Field(type="string") - * @Assert\NotBlank() - */ - protected $password; - - public function getId() - { - return $this->id; - } - - public function getEmail() - { - return $this->email; - } - - public function setEmail($email) - { - $this->email = $email; - } - - public function getPassword() - { - return $this->password; - } - - // encriptado estúpidamente simple (¡por favor no copies esto!) - public function setPassword($password) - { - $this->password = sha1($password); - } - } - -Este documento ``Usuario`` contiene tres campos y dos de ellos (correo y contraseña) se deben mostrar en el formulario. La propiedad correo debe ser única en la base de datos, por lo tanto añadimos esta validación en lo alto de la clase. - -.. note:: - - Si deseas integrar este Usuario en el sistema de seguridad, es necesario implementar la :ref:`Interfaz de usuario ` del componente de Seguridad. - -Creando un formulario para el modelo ------------------------------------- - -A continuación, crea el formulario para el modelo ``Usuario``:: - - // src/Acme/AccountBundle/Form/Type/UserType.php - namespace Acme\AccountBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\Extension\Core\Type\RepeatedType; - use Symfony\Component\Form\FormBuilder; - - class UserType extends AbstractType - { - public function buildForm(FormBuilder $builder, array $options) - { - $builder->add('email', 'email'); - $builder->add('password', 'repeated', array( - 'first_name' => 'password', - 'second_name' => 'confirm', - 'type' => 'password' - )); - } - - public function getDefaultOptions(array $options) - { - return array('data_class' => 'Acme\AccountBundle\Document\User'); - } - - public function getName() - { - return 'user'; - } - } - -Acabamos de añadir dos campos: correo y contraseña (repetido para confirmar la contraseña introducida). La opción ``data_class`` le indica al formulario el nombre de la clase de los datos (es decir, el documento ``Usuario``). - -.. tip:: - - Para explorar más cosas sobre el componente Formulario, lee esta :doc:`documentación `. - -Incorporando el formulario Usuario en un formulario de inscripción ------------------------------------------------------------------- - -El formulario que vamos a usar para la página de registro no es el mismo que el formulario utilizado para simplemente modificar al ``Usuario`` (es decir, ``UserType``). El formulario de registro contiene más campos como «acepto las condiciones», cuyo valor no se almacenará en la base de datos. - -En otras palabras, creas un segundo formulario de inscripción, el cual incorpora el formulario ``Usuario`` y añades el campo extra necesario. Empecemos creando una clase simple que representa la «inscripción»:: - - // src/Acme/AccountBundle/Form/Model/Registration.php - namespace Acme\AccountBundle\Form\Model; - - use Symfony\Component\Validator\Constraints as Assert; - - use Acme\AccountBundle\Document\User; - - class Registration - { - /** - * @Assert\Type(type="Acme\AccountBundle\Document\User") - */ - protected $user; - - /** - * @Assert\NotBlank() - * @Assert\True() - */ - protected $termsAccepted; - - public function setUser(User $user) - { - $this->usuario = $usuario; - } - - public function getUser() - { - return $this->user; - } - - public function getTermsAccepted() - { - return $this->termsAccepted; - } - - public function setTermsAccepted($termsAccepted) - { - $this->termsAccepted = (boolean)$termsAccepted; - } - } - -A continuación, crea el formulario para el modelo ``Registro``:: - - // src/Acme/AccountBundle/Form/Type/RegistrationType.php - namespace Acme\AccountBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\Extension\Core\Type\RepeatedType; - use Symfony\Component\Form\FormBuilder; - - class RegistrationType extends AbstractType - { - public function buildForm(FormBuilder $builder, array $options) - { - $builder->add('user', new UserType()); - $builder->add('terms', 'checkbox', array('property_path' => 'termsAccepted')); - } - - public function getName() - { - return 'registration'; - } - } - -No necesitas utilizar métodos especiales para integrar el ``UserType`` en el formulario. -Un formulario es un campo, también --- por lo tanto lo puedes añadir como cualquier otro campo, con la expectativa de que la propiedad ``Usuario`` correspondiente mantendrá una instancia de la clase ``UserType``. - -Manejando el envío del formulario ---------------------------------- - -A continuación, necesitas un controlador para manejar el formulario. Comienza creando un controlador simple para mostrar el formulario de inscripción:: - - // src/Acme/AccountBundle/Controller/AccountController.php - namespace Acme\AccountBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - use Symfony\Component\HttpFoundation\Response; - - use Acme\AccountBundle\Form\Type\RegistrationType; - use Acme\AccountBundle\Form\Model\Registration; - - class AccountController extends Controller - { - public function registerAction() - { - $form = $this->createForm(new RegistrationType(), new Registration()); - - return $this->render('AcmeAccountBundle:Account:register.html.twig', array('form' => $form->createView())); - } - } - -y su plantilla: - -.. code-block:: html+jinja - - {# src/Acme/AccountBundle/Resources/views/Account/register.html.twig #} - -
- {{ form_widget(form) }} - - -
- -Finalmente, crea el controlador que maneja el envío del formulario. Esto realiza la validación y guarda los datos en *MongoDB*:: - - public function createAction() - { - $dm = $this->get('doctrine_mongodb')->getManager(); - - $form = $this->createForm(new RegistrationType(), new Registration()); - - $form->bindRequest($this->getRequest()); - - if ($form->isValid()) { - $registration = $form->getData(); - - $dm->persist($registration->getUser()); - $dm->flush(); - - return $this->redirect(...); - } - - return $this->render('AcmeAccountBundle:Account:register.html.twig', array('form' => $form->createView())); - } - -¡Eso es todo! Tu formulario ahora valida, y te permite guardar el objeto ``Usuario`` a *MongoDB*. diff --git a/_sources/bundles/DoctrineMongoDBBundle/index.txt b/_sources/bundles/DoctrineMongoDBBundle/index.txt deleted file mode 100644 index 520defe..0000000 --- a/_sources/bundles/DoctrineMongoDBBundle/index.txt +++ /dev/null @@ -1,631 +0,0 @@ -``DoctrineMongoDBBundle`` -========================= - -.. toctree:: - :hidden: - - config - form - -El asignador de objeto a documento `MongoDB`_ (*ODM* por Object Document Mapper) es muy similar al *ORM* de *Doctrine2* en su filosofía y funcionamiento. En otras palabras, similar al :doc:`ORM de Doctrine2 `, con el *ODM* de *Doctrine*, sólo tratas con objetos *PHP* simples, los cuales luego se persisten de forma transparente hacia y desde *MongoDB*. - -.. tip:: - - Puedes leer más acerca del *ODM* de *Doctrine MongoDB* en la `documentación`_ del proyecto. - -Está disponible el paquete que integra el *ODM MongoDB de Doctrine* en *Symfony*, por lo tanto es fácil configurarlo y usarlo. - -.. note:: - - Este capítulo lo debes de sentir muy parecido al capítulo :doc:`ORM de Doctrine2 `, que habla de cómo puedes utilizar el *ORM* de *Doctrine* para guardar los datos en bases de datos relacionales (por ejemplo, *MySQL*). Esto es a propósito --- si persistes en una base de datos relacional por medio del *ORM* o a través del *ODM MongoDB*, las filosofías son muy parecidas. - -Instalando ----------- - -Para utilizar el *ODM MongoDB*, necesitarás dos bibliotecas proporcionadas por *Doctrine* y un paquete que las integra en *Symfony*. - -Instalando el paquete con ``Composer`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para instalar ``DoctrineMongoDBBundle`` con ``Composer`` sólo tienes que añadir lo siguiente a tu archivo :file:`composer.json`:: - - { - "require": { - "doctrine/mongodb-odm-bundle": "3.0.*" - }, - "minimum-stability": "dev" - } - -La definición de ``minimum-stability`` es necesaria hasta que una versión no beta del paquete esté disponible. Dependiendo de las necesidades de tu proyecto, puedes utilizar valores distintos a ``dev``, lo cual se explica en la `documentación del esquema`_ *Composer*. - -Ahora puedes instalar las nuevas dependencias ejecutando la orden ``update`` de *Composer* desde el directorio donde se encuentra el archivo ``composer.json``: - -.. code-block:: bash - - php composer.phar update - -Ahora, ``Composer`` automáticamente descargará todos los archivos necesarios y los instalará por ti. - -Registrando las anotaciones y el paquete -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Luego, registra la biblioteca de anotaciones añadiendo lo siguiente al cargador automático (bajo la línea ``AnnotationRegistry::registerLoader`` existente):: - - // app/autoload.php - use Doctrine\ODM\MongoDB\Mapping\Driver\AnnotationDriver; - AnnotationDriver::registerAnnotationClasses(); - -Todo lo que resta por hacer es actualizar tu archivo :file:`AppKernel.php`, y registrar el nuevo paquete:: - - // app/AppKernel.php - public function registerBundles() - { - $bundles = array( - // ... - new Doctrine\Bundle\MongoDBBundle\DoctrineMongoDBBundle(), - ); - - // ... - } - -¡Enhorabuena! Estás listo para empezar a trabajar. - -Configurando ------------- - -Para empezar, necesitarás una estructura básica que configure el gestor de documentos. La forma más fácil es habilitar el ``auto_mapping``, el cual activará al *ODM MongoDB* a través de tu aplicación: - -.. code-block:: yaml - - # app/config/config.yml - doctrine_mongodb: - connections: - default: - server: mongodb://localhost:27017 - options: {} - default_database: test_database - document_managers: - default: - auto_mapping: true - -.. note:: - - Por supuesto, también te tienes que asegurar de que el servidor *MongoDB* se ejecute en segundo plano. Para más información, consulta la `Guía de inicio rápido`_ de *MongoDB*. - -Un sencillo ejemplo: Un producto --------------------------------- - -La mejor manera de entender el *ODM* de *Doctrine MongoDB* es verlo en acción. -En esta sección, recorreremos cada paso necesario para empezar a persistir documentos hacia y desde *MongoDB*. - -.. sidebar:: El código del ejemplo - - Si quieres seguir el ejemplo de este capítulo, crea el paquete ``AcmeStoreBundle`` ejecutando la orden: - - .. code-block:: bash - - php app/console generate:bundle --namespace=Acme/StoreBundle - -Creando una clase Documento -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Supongamos que estás construyendo una aplicación donde necesitas mostrar tus productos. -Sin siquiera pensar en *Doctrine* o *MongoDB*, ya sabes que necesitas un objeto ``Producto`` para representar los productos. Crea esta clase en el directorio ``Document`` de tu ``AcmeStoreBundle``:: - - // src/Acme/StoreBundle/Document/Product.php - namespace Acme\StoreBundle\Document; - - class Product - { - protected $name; - - protected $price; - } - -La clase --- a menudo llamada «documento», es decir, *una clase básica que contiene los datos* --- es simple y ayuda a cumplir con el requisito del negocio de que tu aplicación necesita productos. Esta clase, todavía no se puede persistir a *Doctrine MongoDB* --- es sólo una clase *PHP* simple. - -Agregando información de asignación -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Doctrine* te permite trabajar con *MongoDB* de una manera mucho más interesante que solo recuperar datos de un lado a otro como una matriz. En cambio, *Doctrine* te permite persistir *objetos* completos a *MongoDB* y recuperar objetos enteros desde *MongoDB*. Esto funciona asignando una clase *PHP* y sus propiedades a las entradas de una colección *MongoDB*. - -Para que *Doctrine* sea capaz de hacer esto, sólo tienes que crear «metadatos», o la configuración que le dice a *Doctrine* exactamente cómo se deben *asignar* a *MongoDB* la clase ``Producto`` y sus propiedades. Estos metadatos se pueden especificar en una variedad de formatos diferentes, incluyendo *YAML*, *XML* o directamente dentro de la clase ``Producto`` a través de anotaciones: - -.. configuration-block:: - - .. code-block:: php-annotations - - // src/Acme/StoreBundle/Document/Product.php - namespace Acme\StoreBundle\Document; - - use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB; - - /** - * @MongoDB\Document - */ - class Product - { - /** - * @MongoDB\Id - */ - protected $id; - - /** - * @MongoDB\String - */ - protected $name; - - /** - * @MongoDB\Float - */ - protected $price; - } - - .. code-block:: yaml - - # src/Acme/StoreBundle/Resources/config/doctrine/Product.mongodb.yml - Acme\StoreBundle\Document\Product: - fields: - id: - id: true - name: - type: string - price: - type: float - - .. code-block:: xml - - - - - - - - - - - -*Doctrine* te permite elegir entre una amplia variedad de tipos de campo diferentes, cada uno con sus propias opciones. Para más información sobre los tipos de campo disponibles, consulta la sección :ref:`cb-mongodb-field-types`. - -.. seealso:: - - También puedes consultar la `Documentación de asignación básica`_ de *Doctrine* para todos los detalles sobre la información de asignación. Si utilizas anotaciones, tendrás que prefijar todas tus anotaciones con ``MongoDB\`` (por ejemplo, ``MongoDB\Cadena``), lo cual no se muestra en la documentación de *Doctrine*. También tendrás que incluir la declaración ``use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB;``, la cual *importa* el prefijo ``MongoDB`` para las anotaciones. - -Generando captadores y definidores -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A pesar de que *Doctrine* ya sabe cómo persistir un objeto ``Producto`` a *MongoDB*, la clase en sí en realidad todavía no es útil. Puesto que ``Producto`` es sólo una clase *PHP* regular, es necesario crear métodos captadores y definidores (por ejemplo, ``getNombre()``, ``setNombre()``) para poder acceder a sus propiedades (ya que las propiedades son ``protegidas``). Afortunadamente, *Doctrine* puede hacer esto por ti con la siguiente orden: - -.. code-block:: bash - - php app/console doctrine:mongodb:generate:documents AcmeStoreBundle - -Esta orden se asegura de que se generen todos los captadores y definidores para la clase ``Producto``. Esta es una orden segura --- la puedes ejecutar una y otra vez: sólo genera captadores y definidores que no existen (es decir, no sustituye métodos existentes). - -.. note:: - - A *Doctrine* no le importa si tus propiedades son ``protegidas`` o ``privadas``, o si una propiedad tiene o no una función captadora o definidora. - Aquí, los captadores y definidores se generan sólo porque los necesitarás para interactuar con tu objeto *PHP*. - -Persistiendo objetos a *MongoDB* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora que tienes asignado un documento ``Producto`` completo, con métodos captadores y definidores, estás listo para persistir los datos a *MongoDB*. Desde el interior de un controlador, esto es bastante fácil. Agrega el siguiente método al ``DefaultController`` del paquete: - -.. code-block:: php - :linenos: - - // src/Acme/StoreBundle/Controller/DefaultController.php - use Acme\StoreBundle\Document\Product; - use Symfony\Component\HttpFoundation\Response; - // ... - - public function createAction() - { - $product = new Product(); - $product->setName('A Foo Bar'); - $product->setPrice('19.99'); - - $dm = $this->get('doctrine_mongodb')->getManager(); - $dm->persist($product); - $dm->flush(); - - return new Response('Created product id '.$product->getId()); - } - -.. note:: - - Si estás siguiendo este ejemplo, tendrás que crear una ruta que apunte a esta acción para verla trabajar. - -Vamos a recorrer este ejemplo: - -* **Líneas 8-10** En esta sección, creas una instancia y trabajas con el objeto ``$product`` como cualquier otro objeto *PHP* normal; - -* **Línea 12** Esta línea recupera el objeto *gestor de documentos*, el cual es responsable de manejar el proceso de persistir y recuperar objetos hacia y desde *MongoDB*; - -* **Línea 13** El método ``persist()`` dice a *Doctrine* que «procese» el objeto ``$product``. Esto en realidad no resulta en una consulta que se deba hacer a *MongoDB* (todavía). - -* **Línea 14** Cuando se llama al método ``flush()``, *Doctrine* mira todos los objetos que está gestionando para ver si es necesario persistirlos a *MongoDB*. En este ejemplo, el objeto ``$product`` aún no se ha persistido, por lo que el gestor de documentos hace una consulta a *MongoDB*, la cual añade una nueva entrada. - -.. note:: - - De hecho, ya que *Doctrine* está consciente de todos los objetos gestionados, cuando llamas al método ``flush()``, se calcula un conjunto de cambios y ejecuta la operación más eficiente posible. - -Al crear o actualizar objetos, el flujo de trabajo siempre es el mismo. En la siguiente sección, verás cómo *Doctrine* es lo suficientemente inteligente como para actualizar las entradas, si ya existen en *MongoDB*. - -.. tip:: - - *Doctrine* proporciona una biblioteca que te permite cargar en tu proyecto mediante programación los datos de prueba (es decir, «datos accesorios»). Para más información, consulta :doc:`/bundles/DoctrineFixturesBundle/index`. - -Recuperando objetos desde *MongoDB* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Recuperar un objeto de *MongoDB* incluso es más fácil. Por ejemplo, supongamos que has configurado una ruta para mostrar un ``Producto`` específico en función del valor de su ``id``:: - - public function showAction($id) - { - $product = $this->get('doctrine_mongodb') - ->getRepository('AcmeStoreBundle:Product') - ->find($id); - - if (!$product) { - throw $this->createNotFoundException('No product found for id '.$id); - } - - // haz algo, como pasar el objeto $product a una plantilla - } - -Al consultar por un determinado tipo de objeto, siempre utilizas lo que se conoce como «repositorio». Puedes pensar en un repositorio como una clase *PHP*, cuyo único trabajo consiste en ayudarte a buscar los objetos de una determinada clase. Puedes acceder al objeto repositorio de una clase documento vía:: - - $repository = $this->get('doctrine_mongodb') - ->getManager() - ->getRepository('AcmeStoreBundle:Product'); - -.. note:: - - La cadena ``AcmeStoreBundle:Product`` es un método abreviado que puedes utilizar en cualquier lugar de *Doctrine* en lugar del nombre de clase completo de la entidad (es decir, ``Acme\StoreBundle\Entity\Product``). - Mientras tu documento viva en el espacio de nombres ``Document`` de tu paquete, esto va a funcionar. - -Una vez que tengas tu repositorio, tienes acceso a todo tipo de útiles métodos:: - - // consulta por la clave principal (generalmente "id") - $product = $repository->find($id); - - // nombres de método dinámicos para búsquedas basadas en - // el valor de una columna - $product = $repository->findOneById($id); - $product = $repository->findOneByName('foo'); - - // recupera TODOS los productos - $products = $repository->findAll(); - - // busca un grupo de productos basándose en el - // valor de una columna arbitraria - $products = $repository->findByPrice(19.99); - -.. note:: - - Por supuesto, también puedes realizar consultas complejas, acerca de las cuales aprenderás más en la sección :ref:`book-doctrine-queries`. - -También puedes tomar ventaja de los útiles métodos ``findBy`` y ``findOneBy`` para recuperar objetos fácilmente basándote en varias condiciones:: - - // consulta por un producto que coincide en nombre y precio - $product = $repository->findOneBy(array('name' => 'foo', - 'price' => 19.99)); - - // consulta por todos los productos que coinciden - // con el nombre, y los ordena por precio - $product = $repository->findBy( - array('name' => 'foo'), - array('price', 'ASC') - ); - -Actualizando un objeto -~~~~~~~~~~~~~~~~~~~~~~ - -Una vez que hayas extraído un objeto de *Doctrine*, actualizarlo es relativamente fácil. Supongamos que tienes una ruta que asigna un identificador de producto a una acción de actualización de un controlador:: - - public function updateAction($id) - { - $dm = $this->get('doctrine_mongodb')->getManager(); - $product = $dm->getRepository('AcmeStoreBundle:Product')->find($id); - - if (!$product) { - throw $this->createNotFoundException('No product found for id '.$id); - } - - $product->setName('New product name!'); - $dm->flush(); - - return $this->redirect($this->generateUrl('homepage')); - } - -La actualización de un objeto únicamente consiste de tres pasos: - -1. Recuperar el objeto desde *Doctrine*; -2. Modificar el objeto; -3. Llamar a ``flush()`` en el gestor del documento; - -Ten en cuenta que ``$dm->persist($product)`` no es necesario. Recuerda que este método simplemente dice a *Doctrine* que procese o «vea» el objeto ``$product``. -En este caso, ya que recuperaste el objeto ``$product`` desde *Doctrine*, este ya está gestionado. - -Eliminando un objeto -~~~~~~~~~~~~~~~~~~~~ - -La eliminación de un objeto es muy similar, pero requiere una llamada al método ``remove()`` del gestor de documentos:: - - $dm->remove($product); - $dm->flush(); - -Como es de esperar, el método ``remove()`` notifica a *Doctrine* que deseas eliminar el documento propuesto de *MongoDB*. La operación real de eliminar sin embargo, no se ejecuta efectivamente hasta que invocas al método ``flush()``. - -Consultando por objetos ------------------------ - -Como vimos anteriormente, la clase ``repositorio`` integrada te permite consultar por uno o varios objetos basándote en una serie de diferentes parámetros. Cuando esto es suficiente, esta es la forma más sencilla de consultar documentos. Por supuesto, también puedes crear consultas más complejas. - -Usando el generador de consultas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El *ODM* de *Doctrine* viene con un objeto «Generador» de consultas, el cual te permite construir una consulta para exactamente los documentos que deseas devolver. Si usas un *IDE*, también puedes tomar ventaja del autocompletado a medida que escribes los nombres de métodos. -Desde el interior de un controlador:: - - $products = $this->get('doctrine_mongodb') - ->getManager() - ->createQueryBuilder('AcmeStoreBundle:Product') - ->field('name')->equals('foo') - ->limit(10) - ->sort('price', 'ASC') - ->getQuery() - ->execute() - -En este caso, devuelve 10 productos con el nombre «foo», ordenados de menor a mayor precio. - -El objeto ``QueryBuilder`` contiene todos los métodos necesarios para construir tu consulta. Para más información sobre el generador de consultas de *Doctrine*, consulta la documentación del `Generador de consultas`_ de *Doctrine*. Para una lista de las condiciones disponibles que puedes colocar en la consulta, ve la documentación específica a los `Operadores condicionales`_. - -Repositorio de clases personalizado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En la sección anterior, comenzaste a construir y utilizar consultas más complejas desde el interior de un controlador. A fin de aislar, probar y reutilizar esas consultas, es buena idea crear una clase repositorio personalizada para tu documento y allí agregar métodos con la lógica de la consulta. - -Para ello, agrega el nombre de la clase del repositorio a la definición de asignación. - -.. configuration-block:: - - .. code-block:: php-annotations - - // src/Acme/StoreBundle/Document/Product.php - namespace Acme\StoreBundle\Document; - - use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB; - - /** - * @MongoDB\Document(repositoryClass="Acme\StoreBundle\Repository\ProductRepository") - */ - class Product - { - //... - } - - .. code-block:: yaml - - # src/Acme/StoreBundle/Resources/config/doctrine/Product.mongodb.yml - Acme\StoreBundle\Document\Product: - repositoryClass: Acme\StoreBundle\Repository\ProductRepository - # ... - - .. code-block:: xml - - - - - - - - - - - -*Doctrine* puede generar la clase repositorio para ti ejecutando: - -.. code-block:: bash - - php app/console doctrine:mongodb:generate:repositories AcmeStoreBundle - -A continuación, agrega un nuevo método --- ``findAllOrderedByName()`` --- a la clase repositorio recién generada. Este método deberá consultar por todos los documentos ``Producto``, ordenados alfabéticamente. - -.. code-block:: php - - // src/Acme/StoreBundle/Repository/ProductRepository.php - namespace Acme\StoreBundle\Repository; - - use Doctrine\ODM\MongoDB\DocumentRepository; - - class ProductRepository extends DocumentRepository - { - public function findAllOrderedByName() - { - return $this->createQueryBuilder() - ->sort('name', 'ASC') - ->getQuery() - ->execute(); - } - } - -Puedes utilizar este nuevo método al igual que los métodos de búsqueda predeterminados del repositorio:: - - $products = $this->get('doctrine_mongodb') - ->getManager() - ->getRepository('AcmeStoreBundle:Product') - ->findAllOrderedByName(); - - -.. note:: - - Al utilizar una clase repositorio personalizada, todavía tienes acceso a los métodos de búsqueda predeterminados como ``find()`` y ``findAll()``. - -Extensiones *Doctrine*: ``Timestampable``, ``Sluggable``, etc. --------------------------------------------------------------- - -*Doctrine* es bastante flexible, y dispone de una serie de extensiones de terceros que te permiten realizar fácilmente tareas repetitivas y comunes en tus entidades. -Estas incluyen cosas tales como ``Sluggable``, ``Timestampable``, ``registrable``, ``traducible`` y ``Tree``. - -Para más información sobre cómo encontrar y utilizar estas extensiones, ve el artículo sobre el uso de :doc:`extensiones comunes de Doctrine `. - -.. _cb-mongodb-field-types: - -Referencia de tipos de campo *Doctrine* ---------------------------------------- - -*Doctrine* dispone de una gran cantidad de tipos de campo. Cada uno de estos asigna un tipo de dato *PHP* a un determinado `tipo de MongoDB`_. Los siguientes son sólo *algunos* de los tipos admitidos por *Doctrine*: - -* ``string`` -* ``int`` -* ``float`` -* ``date`` -* ``timestamp`` -* ``boolean`` -* ``file`` - -Para más información, consulta la sección `Asignando tipos`_ en la documentación de *Doctrine*. - -.. index:: - single: Doctrine; Ordenes de consola ODM - single: CLI; ODM de Doctrine - -Ordenes de consola ------------------- - -La integración *ODM* de *Doctrine2* ofrece varias ordenes de consola en el espacio de nombres ``doctrine:mongodb``. Para ver la lista de ordenes puedes ejecutar la consola sin ningún tipo de argumento: - -.. code-block:: bash - - php app/console - -Mostrará una lista con las ordenes disponibles, muchas de las cuales comienzan con el prefijo ``doctrine:mongodb``. Puedes encontrar más información sobre cualquiera de estas ordenes (o cualquier orden de *Symfony*) ejecutando la orden ``help``. -Por ejemplo, para obtener detalles acerca de la tarea ``doctrine:mongodb:query``, ejecuta: - -.. code-block:: bash - - php app/console help doctrine:mongodb:query - -.. note:: - - Para poder cargar accesorios en *MongoDB*, necesitas tener instalado el paquete ``DoctrineFixturesBundle``. Para ver cómo hacerlo, lee el artículo «:doc:`/bundles/DoctrineFixturesBundle/index`» de la documentación. - -.. index:: - single: Configuración; ODM MongoDB de Doctrine - single: Doctrine; Configurando el ODM MongoDB - -Configurando ------------- - -Para información más detallada sobre las opciones de configuración disponibles cuando utilizas el *ODM* de *Doctrine*, consulta la sección :doc:`Referencia MongoDB `. - -Registrando escuchas y suscriptores de eventos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -*Doctrine* te permite registrar escuchas y suscriptores que recibirán una notificación cuando se produzcan diferentes eventos al interior del *ODM Doctrine*. Para más información, consulta la sección `Documentación de eventos`_ de *Doctrine*. - -.. tip:: - - Además de los eventos ``ODM``, también puedes escuchar los eventos de bajo nivel de `` MongoDB``, que encontrarás definidos en la clase :class:`Doctrine\MongoDB\Events`. - -.. note:: - - Cada conexión de *Doctrine* tiene su propio gestor de eventos, el cual se comparte con los gestores de documentos vinculados a esa conexión. Los escuchas y suscriptores pueden estar registrados con todos gestores de eventos o sólo uno (usando el nombre de la conexión). - -En *Symfony*, puedes registrar un escucha o suscriptor creando un :term:`servicio` y, a continuación :ref:`marcarlo ` con una etiqueta específica. - -* **escucha de evento**: Usa la etiqueta ``doctrine_mongodb.odm.event_listener`` para registrar un escucha. El atributo ``event`` es necesario y debe indicar el evento a escuchar. De forma predeterminada, los escuchas serán registrados con los gestores de eventos para todas las conexiones. Para restringir un escucha a una única conexión, especifica su nombre en la etiqueta del atributo ``connection``. - - El atributo ``priority``, el cual de manera predefinida es ``0`` si se omite, se puede utilizar para controlar el orden en que se registran los escuchas. Al igual que el :ref:`despachador de eventos ` de *Symfony2*, un mayor número dará lugar a que el escucha se ejecute primero y los escuchas con la misma prioridad se ejecutan en el orden en que fueron registrados en el gestor de eventos. - - Por último, el atributo ``lazy``, que de manera predeterminada es `false`` si se omite, se puede utilizar para solicitar que gestor del evento cargue al escucha de manera diferida cuando se distribuya el evento. - - .. configuration-block:: - - .. code-block:: yaml - - services: - my_doctrine_listener: - class: Acme\HelloBundle\Listener\MyDoctrineListener - # ... - tags: - - { name: doctrine_mongodb.odm.event_listener, event: postPersist } - - .. code-block:: xml - - - - - . - - .. code-block:: php - - $definition = new Definition('Acme\HelloBundle\Listener\MyDoctrineListener'); - // ... - $definition->addTag('doctrine_mongodb.odm.event_listener', array( - 'event' => 'postPersist', - )); - $container->setDefinition('my_doctrine_listener', $definition); - -* **suscriptor de evento**: Usa la etiqueta ``doctrine_mongodb.odm.event_subscriber`` para registrar un suscriptor. Los suscriptores son responsables de implementar al ``Doctrine\Common\EventSubscriber`` y suplir un método que devuelva los eventos que escuchará. Por esta razón, esta etiqueta no tiene el atributo ``event``; - No obstante, dispone de los atributos ``connection``, ``priority`` y ``lazy``. - -.. note:: - - A diferencia de los escuchas de eventos de *Symfony2*, el gestor de eventos de *Doctrine* espera que cada escucha y suscriptor tenga un nombre de método correspondiente al/los evento(s) observado(s). Por esta razón, las etiquetas antes mencionadas no tienen atributo ``method``. - -Integrando el ``SecurityBundle`` --------------------------------- - -Hay disponible un proveedor de usuarios para tus proyectos *MongoDB*, trabaja exactamente igual que el proveedor de entidades descrito en el :doc:`recetario ` - -.. configuration-block:: - - .. code-block:: yaml - - security: - providers: - my_mongo_provider: - mongodb: {class: Acme\DemoBundle\Document\User, property: username} - - .. code-block:: xml - - - - - - - - -Resumen -------- - -Con *Doctrine*, te puedes enfocar en los objetos y la forma en que son útiles en tu aplicación y en segundo lugar preocuparte de su persistencia a través de *MongoDB*. Esto se debe a que *Doctrine* te permite utilizar cualquier objeto *PHP* para almacenar los datos y confía en la información de asignación de metadatos para asignar los datos de un objeto a una colección *MongoDB*. - -Y aunque *Doctrine* gira en torno a un concepto simple, es increíblemente potente, permitiéndote crear consultas complejas y suscribirte a los eventos que te permiten realizar diferentes acciones conforme los objetos recorren su ciclo de vida en la persistencia. - -Aprende más en el recetario ---------------------------- - -* :doc:`/bundles/DoctrineMongoDBBundle/form` - -.. _`MongoDB`: http://www.mongodb.org/ -.. _`documentación`: http://docs.doctrine-project.org/projects/doctrine-mongodb-odm/en/latest/ -.. _`documentación del esquema`: http://getcomposer.org/doc/04-schema.md#minimum-stability -.. _`Guía de inicio rápido`: http://www.mongodb.org/display/DOCS/Quickstart -.. _`Documentación de asignación básica`: http://www.doctrine-project.org/docs/mongodb_odm/1.0/en/reference/basic-mapping.html -.. _`tipo de MongoDB`: http://us.php.net/manual/en/mongo.types.php -.. _`Asignando tipos`: http://docs.doctrine-project.org/projects/doctrine-mongodb-odm/en/latest/reference/basic-mapping.html#doctrine-mapping-types -.. _`Generador de consultas`: http://www.doctrine-project.org/docs/mongodb_odm/1.0/en/reference/query-builder-api.html -.. _`Operadores condicionales`: http://www.doctrine-project.org/docs/mongodb_odm/1.0/en/reference/query-builder-api.html#conditional-operators -.. _`Documentación de eventos`: http://www.doctrine-project.org/docs/mongodb_odm/1.0/en/reference/events.html diff --git a/_sources/bundles/JMSAopBundle/index.txt b/_sources/bundles/JMSAopBundle/index.txt deleted file mode 100644 index 3aa7010..0000000 --- a/_sources/bundles/JMSAopBundle/index.txt +++ /dev/null @@ -1,250 +0,0 @@ -**************** -``JMSAopBundle`` -**************** - -Este paquete añade capacidades `AOP `_ (``Aspect-oriented programming`` o Programación orientada a aspectos) a *Symfony2*. - -Si todavía no has oído hablar de *AOP*, básicamente te permite separar un asunto omnipresente (por ejemplo, la comprobación de seguridad) en una clase específica, y no tener que repetir ese código en todos los lugares donde se necesite. - -En otras palabras, te permite ejecutar código personalizado antes y después de invocar ciertos métodos en tu capa de servicios o controladores. También puedes optar por omitir la invocación del método original, o simplemente lanzar excepciones. - -Instalando ----------- - -Consigue una copia del código: - -.. code-block:: bash - - - git submodule add https://github.com/schmittjoh/JMSAopBundle.git src/JMS/AopBundle - -Finalmente, registra el paquete en tu núcleo: - -.. code-block:: php - - // en AppKernel::registerBundles() - $bundles = array( - // ... - new JMS\AopBundle\JMSAopBundle(), - // ... - ); - -Este paquete además necesita la biblioteca ``CG`` para generar código: - -.. code-block:: bash - - git submodule add https://github.com/schmittjoh/cg-library.git vendor/cg-library - -Asegúrate de registrar los espacios de nombres en tu cargador automático:: - - // app/autoload.php - $loader->registerNamespaces(array( - // ... - 'JMS' => __DIR__.'/../vendor/bundles', - 'CG' => __DIR__.'/../vendor/cg-library/src', - // ... - )); - - -Configurando ------------- - -.. code-block:: yaml - - jms_aop: - cache_dir: %kernel.cache_dir%/jms_aop - - -Usando ------- - -A fin de ejecutar código personalizado, necesitas dos clases. En primer lugar, necesitas un así llamado :dfn:`punto de corte` (``pointcut``). El propósito de esta clase es tomar la decisión de si cierto interceptor debe capturar una llamada a un método. Esta decisión se tiene que hacer estáticamente sólo en base de la firma del método en sí. - -La segunda clase es el interceptor. Esta clase se llama en lugar del método original. Esta contiene el código personalizado que quieres ejecutar. En este punto, tienes acceso al objeto en el cual es invocado el método, y todos los argumentos suministrados a ese método. - -Ejemplos --------- - -1. Registro cronológico -~~~~~~~~~~~~~~~~~~~~~~~ - -En este ejemplo, implementaremos el registro cronológico de todos los métodos que contienen ``«delete»`` - -Punto de corte -^^^^^^^^^^^^^^ - -:: - - name, 'delete'); - } - } - -:: - - # services.yml - services: - my_logging_pointcut: - class: LoggingPointcut - tags: - - { name: jms_aop.pointcut, interceptor: logging_interceptor } - - -Interceptor de registro -^^^^^^^^^^^^^^^^^^^^^^^ - -:: - - context = $context; - $this->logger = $logger; - } - - public function intercept(MethodInvocation $invocation) - { - $user = $this->context->getToken()->getUsername(); - $this->logger->info(sprintf('User "%s" invoked method "%s".', $user, $invocation->reflection->name)); - - // se asegura de proceder con la invocación, de lo contrario - // el método original nunca se llamará - return $invocation->proceed(); - } - } - -:: - - # services.yml - services: - logging_interceptor: - class: LoggingInterceptor - arguments: [@security.context, @logger] - - -2. Gestionando transacciones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En este ejemplo, añadimos una anotación ``@Transactional``, y automáticamente ajustamos todos los métodos donde se declara esta anotación en una transacción. - -Punto de corte -^^^^^^^^^^^^^^ - -:: - - use Doctrine\Common\Annotations\Reader; - use JMS\AopBundle\Aop\PointcutInterface; - use JMS\DiExtraBundle\Annotation as DI; - - /** - * @DI\Service - * @DI\Tag("jms_aop.pointcut", attributes = {"interceptor" = "aop.transactional_interceptor"}) - * - * @author Johannes M. Schmitt - */ - class TransactionalPointcut implements PointcutInterface - { - private $reader; - - /** - * @DI\InjectParams({ - * "reader" = @DI\Inject("annotation_reader"), - * }) - * @param Reader $reader - */ - public function __construct(Reader $reader) - { - $this->reader = $reader; - } - - public function matchesClass(\ReflectionClass $class) - { - return true; - } - - public function matchesMethod(\ReflectionMethod $method) - { - return null !== $this->reader->getMethodAnnotation($method, 'Annotation\Transactional'); - } - } - -Interceptor -^^^^^^^^^^^ - -:: - - use Symfony\Component\HttpKernel\Log\LoggerInterface; - use Symfony\Component\HttpKernel\Exception\NotFoundHttpException; - use CG\Proxy\MethodInvocation; - use CG\Proxy\MethodInterceptorInterface; - use Doctrine\ORM\EntityManager; - use JMS\DiExtraBundle\Annotation as DI; - - /** - * @DI\Service("aop.transactional_interceptor") - * - * @author Johannes M. Schmitt - */ - class TransactionalInterceptor implements MethodInterceptorInterface - { - private $em; - private $logger; - - /** - * @DI\InjectParams - * @param EntityManager $em - */ - public function __construct(EntityManager $em, LoggerInterface $logger) - { - $this->em = $em; - $this->logger = $logger; - } - - public function intercept(MethodInvocation $invocation) - { - $this->logger->info('Beginning transaction for method "'.$invocation.'")'); - $this->em->getConnection()->beginTransaction(); - try { - $rs = $invocation->proceed(); - - $this->logger->info(sprintf('Comitting transaction for method "%s" (method invocation successful)', $invocation)); - $this->em->getConnection()->commit(); - - return $rs; - } catch (\Exception $ex) { - if ($ex instanceof NotFoundHttpException) { - $this->logger->info(sprintf('Committing transaction for method "%s" (exception thrown, but no rollback)', $invocation)); - $this->em->getConnection()->commit(); - } else { - $this->logger->info(sprintf('Rolling back transaction for method "%s" (exception thrown)', $invocation)); - $this->em->getConnection()->rollBack(); - } - - throw $ex; - } - } - } diff --git a/_sources/bundles/JMSDiExtraBundle/annotations.txt b/_sources/bundles/JMSDiExtraBundle/annotations.txt deleted file mode 100644 index e9adcc2..0000000 --- a/_sources/bundles/JMSDiExtraBundle/annotations.txt +++ /dev/null @@ -1,233 +0,0 @@ -Anotaciones ------------ - -``@Inject`` -~~~~~~~~~~~ - -Esta marca una propiedad o parámetro para inyección: - -.. code-block:: php - - formFactory->create('my_form'); - -.. note :: - - ``@FormType`` implica ``@Service`` si no se definió explícitamente. - -``@DoctrineListener`` o ``@DoctrineMongoDBListener`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Automáticamente, registra la clase dada como un escucha para el *ORM* de *Doctrine* o el *ODM* del *MongoDB* de *Doctrine*: - -.. code-block:: php - - ` proporcionadas en tus controladores que no son servicios; Ningún otro directorio es escaneado. - -Sin embargo, si también quisieras utilizar anotaciones para configurar tus servicios normales, puedes configurar más ubicaciones como se muestra más adelante. - -Configurando ubicaciones ------------------------- - -Si quisieras configurar los servicios en un paquete propio vía anotaciones, o tienes algunos servicios externos a cualquier estructura de paquete tal como en tu directorio :file:`src/`, lo puedes hacer usando las siguientes opciones de configuración, de modo que el paquete las elegirá, y añadirá a tu contenedor de inyección de la dependencias: - -.. configuration-block:: - - .. code-block:: yaml - - jms_di_extra: - locations: - all_bundles: false - bundles: [FooBundle, AcmeBlogBundle] - directories: ["%kernel.root_dir%/../src"] - - .. code-block:: xml - - - - FooBundle - AcmeBlogBundle - - %kernel.root_dir%/../src - - - -.. tip :: - - Para optimo rendimiento de desarrollo (en producción no hay ninguna diferencia de cualquier manera), es recomendable configurar explícitamente los directorios que se tendrían que escanear buscando clases de servicio, y no confiar en la opción de configuración ``all_bundles``. - -Inyectando el controlador automáticamente ------------------------------------------ - -Este paquete te permite configurar la inyección de ciertas propiedades y métodos -de controladores automáticamente. Esto es más útil para servicios necesarios comúnmente, los cuales a partir de entonces no se necesita anotarlos explícitamente. - -.. configuration-block:: - - .. code-block:: yaml - - jms_di_extra: - automatic_controller_injections: - properties: - request: "@request" - router: "@router" - - method_calls: - setRouter: ["@router"] - - .. code-block:: xml - - - - @request - @router - - @router - - - -Si tu controlador tiene alguna de las propiedades o métodos anteriores, entonces nunca más tendrás que añadir una anotacion ``@Inject``, sino que automáticamente se inyectará el servicio que hayas configurado. No obstante, si declaras una anotación ``@Inject``, esta automáticamente sustituye cualquier cosa que hayas configurado en la sección anterior. diff --git a/_sources/bundles/JMSDiExtraBundle/doctrine.txt b/_sources/bundles/JMSDiExtraBundle/doctrine.txt deleted file mode 100644 index a754797..0000000 --- a/_sources/bundles/JMSDiExtraBundle/doctrine.txt +++ /dev/null @@ -1,52 +0,0 @@ -Integrando con *Doctrine* -========================= - -.. versionadded:: 1.1 - Se agregó la integración con *Doctrine*. - -Configuración -------------- - -La integración con *Doctrine* está habilitada de manera predeterminada. Sin embargo, fácilmente puedes la puedes desactivar en tu configuración: - -.. configuration-block:: - - .. code-block:: yaml - - jms_di_extra: - doctrine_integration: false - - .. code-block:: xml - - - - -Inyectando dependencias en repositorios ----------------------------------------- - -Si has habilitado integración de *Doctrine*, ahora puedes inyectar dependencias en repositorios utilizando anotaciones: - -.. code-block:: php - - use JMS\DiExtraBundle\Annotation as DI; - - class MyRepository extends EntityRepository - { - private $uuidGenerator; - - /** - * @DI\InjectParams({ - * "uuidGenerator" = @DI\Inject("my_uuid_generator"), - * }) - */ - public function setUuidGenerator(UUidGenerator $uuidGenerator) - { - $this->uuidGenerator = $uuidGenerator; - } - - // ... - } - -.. note :: - - Si no quieres usar anotaciones, también puedes implementar la ``Symfony\Componente\DependencyInjection\ContainerAwareInterface`` en tus repositorios para recibir el contenedor del servicio entero. \ No newline at end of file diff --git a/_sources/bundles/JMSDiExtraBundle/index.txt b/_sources/bundles/JMSDiExtraBundle/index.txt deleted file mode 100644 index defc5f2..0000000 --- a/_sources/bundles/JMSDiExtraBundle/index.txt +++ /dev/null @@ -1,41 +0,0 @@ -``JMSDiExtraBundle`` -==================== - -Introducción ------------- - -``JMSDiExtraBundle`` añade más potentes características a la inyección de dependencias en *Symfony2*: - -- Configuración de la inyección de dependencias vía anotaciones -- Convención de inyección de dependencias basada en controladores -- Capacidades orientadas a la programación de aspectos para controladores - -Documentación -------------- - -.. toctree:: - :hidden: - - installation - configuration - usage - doctrine - annotations - -- :doc:`Instalando ` -- :doc:`Configurando ` -- :doc:`Usando ` -- :doc:`Integrando con Doctrine ` -- :doc:`Anotaciones ` -- :doc:`Colecciones de servicios diferidos ` - -Licencia --------- - -El código se libera bajo la amigable `licencia empresarial de Apache2`_. - -La documentación está sujeta a la `Licencia de atribución no comercial sin derivaciones 3.0 recíproca`_. - -.. _`licencia empresarial de Apache2`: http://www.apache.org/licenses/LICENSE-2.0.html -.. _`Licencia de atribución no comercial sin derivaciones 3.0 recíproca`: http://creativecommons.org/licenses/by-nc-nd/3.0/ - diff --git a/_sources/bundles/JMSDiExtraBundle/installation.txt b/_sources/bundles/JMSDiExtraBundle/installation.txt deleted file mode 100644 index 89b3f2e..0000000 --- a/_sources/bundles/JMSDiExtraBundle/installation.txt +++ /dev/null @@ -1,43 +0,0 @@ -Instalando -========== - -.. note :: - - Esta versión ya no es compatible con *Symfony 2.0.x*. Por favor utiliza una versión más antigua de este paquete si todavía estás usando las series 2.0. - -``JMSDiExtraBundle`` se puede instalar convenientemente vía ``Composer``. Sólo añada lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: js - - // composer.json - { - // ... - require: { - // ... - "jms/di-extra-bundle": "dev-master" - } - } - -.. note :: - - Por favor sustituye ``dev-master`` en el fragmento anterior con la rama estable más reciente, por ejemplo ``1.0.*``. Además comprueba las etiquetas en *Github* para ver cuales versiones están disponibles. - -Luego, puedes instalar las nuevas dependencias ejecutando la orden ``upgrade`` desde el directorio donde está tu archivo :file:`composer.json`: - -.. code-block:: bash - - $ php composer.phar update - -Ahora, ``Composer`` automáticamente descargará todos los archivos necesarios y los instalará para ti. Todo lo que falta por hacer es actualizar tu archivo :file:`AppKernel.php`` y registrar el nuevo paquete: - -.. code-block:: php - - voters = $voters; - } - - public function isGranted(...) - { - foreach ($this->voters as $voter) { - // hace algo, potencialmente regresa anticipadamente. - } - } - } - -Supón que etiquetas tus votantes en el ``CID`` para permitir que otros paquetes registren servicios. Luego, puedes utilizar el ``LazyServiceSequencePass`` proporcionado el cuál cuidará de recoger los servicios etiquetados, y generará la definición para la secuencia:: - - use JMS\DiExtraBundle\Compiler\LazyServiceSequencePass; - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\HttpKernel\Bundle\Bundle; - - class MyBundle extends Bundle - { - public function build(ContainerBuilder $container) - { - $container->addCompilerPass(new LazyServiceSequencePass('voter', - function(ContainerBuilder $container, Definition $seqDef) { - // Añade la definición de la secuencia como argumento para la clase MyService. - $container->getDefinition('my_service')->addArgument($seqDef); - } - )); - } - } - - - -Mapa de servicios diferidos ---------------------------- - -Por ejemplo, si tienes un mapa de formatos a codificadores correspondientes. Muy probablemente, durante una petición, sólo necesites cargar el codificador para un formato específico. Usando el mapa, la carga de ese codificador se retrasará hasta que sabes qué formato necesitas, y no cargas los codificadores (y sus dependencias) para otros formatos. - -Empieza escribiendo el servicio que consume el mapa:: - - use JMS\DiExtraBundle\Annotation as DI; - use PhpCollection\Map; - - /** @DI\Service("my_service") */ - class MyService - { - private $encoders; - - public function __construct(Map $encoders) - { - $this->encoders = $encoders; - } - - public function useEncoder($format) - { - // El codificador se carga aquí. - $encoder = $this->encoders->get('json')->get(); - } - } - -Luego, añade algunos de los que etiquetaste para permitir que los añadiran otros paquetes también:: - - /** @DI\Service @DI\Tag("encoder", attributes = {"format": "json"}) */ - class JsonEncoder { } - - /** @DI\Service @DI\Tag("encoder", attributes = {"format": "xml"}) */ - class XmlEncoder { } - - -Finalmente, sólo necesitas añadir la definición del mapa de ``ID`` que fue construida por el ``LazyServiceMapPass`` proporcionado como argumento de tu servicio ``my_service``:: - - use JMS\DiExtraBundle\Compiler\LazyServiceMapPass; - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\HttpKernel\Bundle\Bundle; - - class MyBundle extends Bundle - { - public function build(ContainerBuilder $container) - { - $container->addCompilerPass(new LazyServiceMapPass('encoder', 'format', - function(ContainerBuilder $container, Definition $mapDef) { - // Añade la definición del mapa como argumento para la clase MyService. - $container->getDefinition('my_service')->addArgument($mapDef); - } - )); - } - } - - diff --git a/_sources/bundles/JMSDiExtraBundle/usage.txt b/_sources/bundles/JMSDiExtraBundle/usage.txt deleted file mode 100644 index d12d20e..0000000 --- a/_sources/bundles/JMSDiExtraBundle/usage.txt +++ /dev/null @@ -1,97 +0,0 @@ -Usándola -======== - -Clases no controladoras ------------------------ - -Las clases no controladoras están configuradas, y gestionadas por *Symfony DIC* justo como cualquier otro servicio que configuras utilizando *YAML*, *XML* o *PHP*. La única diferencia es que lo puedes hacer a través de anotaciones, lo cual es mucho más conveniente. - -Puedes utilizar estas anotaciones en servicios (para ejemplos, ve más adelante): -``@Service``, ``@Inject``, ``@InjectParams``, ``@Observe``, ``@Tag`` - -Ten en cuenta que no puedes usar la anotación ``@Inject`` en propiedades privadas o protegidas. -Del mismo modo, la anotación ``@InjectParams`` no funciona en métodos protegidos o privados. - -Controladores -------------- - -Los controladores son un tipo de clase especial que también son tratadas especialmente por este paquete. La diferencia más notable es que no es necesario definir estas clases como servicios. Sí, no hay servicios, pero no te preocupes que todavía puedes utilizar todas las características de la ``DIC``, e incluso algunas más. - -Inyectando en el constructor/definidor -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: php - - em = $em; - $this->session = $session; - } - // ... algunas acciones - } - -.. note :: - - La inyección en el constructor no es posible cuándo una definición del padre también define un constructor qué está configurado para inyección. - -Inyectando propiedades -~~~~~~~~~~~~~~~~~~~~~~ - -.. code-block:: php - - getMailer(); - } - } - - /** @DI\LookupMethod("mailer") */ - protected function getMailer() { /* aquí el cuerpo está vacío */ } - } - -Puedes utilizar este tipo de inyección si tienes una dependencia que no siempre se necesita en el controlador, y que es costoso iniciarla, como el ``mailer`` en el ejemplo anterior. diff --git a/_sources/bundles/JMSSecurityExtraBundle/annotations.txt b/_sources/bundles/JMSSecurityExtraBundle/annotations.txt deleted file mode 100644 index 37b4628..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/annotations.txt +++ /dev/null @@ -1,155 +0,0 @@ -Anotaciones ------------ - -``@PreAuthorize`` -~~~~~~~~~~~~~~~~~ - -Esta anotación te permite definir una expresión (ve el párrafo del lenguaje de expresiones) que se ejecutó anteriormente a la invocación de un método: - -.. code-block:: php - - -.. code-block:: php - - myPrivateService->aMethodOnlyToBeInvokedThroughASpecificChannel(); - } - } - -``@SatisfiesParentSecurityPolicy`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Esto lo debes definir en un método que sustituya al método que tiene metadatos de seguridad. -Está ahí para asegurarse de que estás consciente de que la seguridad del método reemplazado no se puede hacer valer más, y que tienes que copiar todas las anotaciones si deseas mantenerlas. diff --git a/_sources/bundles/JMSSecurityExtraBundle/configuration.txt b/_sources/bundles/JMSSecurityExtraBundle/configuration.txt deleted file mode 100644 index cd0d544..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/configuration.txt +++ /dev/null @@ -1,59 +0,0 @@ -Configurando ------------- - -La siguiente es la configuración predefinida: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - jms_security_extra: - # Cuando quieras asegurar todos los servicios (true), o únicamente - # proteger servicios específicos (false); ve más adelante - secure_all_services: false - - # Al activar esta opción se agrega un atributo especial - # "ROLE_IDDQD" adicional. - # especial "IS_IDDQD". Cualquiera con este atributo efectivamente - # evadirá todas las comprobaciones de seguridad. - enable_iddqd_attribute: false - - # Habilita el lenguaje de expresiones - expressions: false - - # Te permite desactivar algunos, o todos los votantes - voters: - disable_authenticated: false - disable_role: false - disable_acl: false - - # Te permite especificar reglas de control de acceso para métodos - # específicos, tal como los controladores de acción - method_access_control: { } - - util: - secure_random: - connection: # el nombre de la conexión a doctrine - table_name: seed_table - seed_provider: # id del servicio de tu propia - # implementación proveedora de semilla - - .. code-block:: xml - - - - - - - - - \ No newline at end of file diff --git a/_sources/bundles/JMSSecurityExtraBundle/cookbook/creating_your_own_expression_function.txt b/_sources/bundles/JMSSecurityExtraBundle/cookbook/creating_your_own_expression_function.txt deleted file mode 100644 index 64b084f..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/cookbook/creating_your_own_expression_function.txt +++ /dev/null @@ -1,48 +0,0 @@ -Creando tus propieas funciones de expresión -=========================================== - -.. versionadded:: 1.3 - ``@DI\SecurityFunction`` fue añadida en 1.3. - -Incluso aunque las expresiones integradas ya te permiten hacer mucho, hay casos donde querrás añadir una función de expresión personalizada. - -Supón que quieres comprobar que un usuario tiene una determinada *IP*, lo podrías hacer usando esta expresión ``container.get("request").getIp() == "127.0.0.1"``. -sin embargo, si duplicas esto en varias acciones, se vuelve en mucho que escribir. Además, ¿qué pasa si quieres añadir otra *IP*? Tendrías que editar todos los sitios donde utilices esta expresión. Por lo tanto, en vez de la expresión anterior, añades otra función ``isLocalUser()``, misma que puedes utilizar en tus expresiones. - -.. code-block:: php - - -.. code-block:: php - - container = $container; - } - - /** @DI\SecurityFunction("isLocalUser") */ - public function isLocalUser() - { - return $this->container->get('request')->getIp() === '127.0.0.1'; - } - } - -.. note:: - - Si estás utilizando anotaciones para configurar el servicio (``@DI\Service``) asegurate de que la ruta a tu archivo es escaneado por el ``JMSDiExtraBundle``. Para más información, por favor, ve `configurando JMSDiExtraBundle `_. diff --git a/_sources/bundles/JMSSecurityExtraBundle/expressions.txt b/_sources/bundles/JMSSecurityExtraBundle/expressions.txt deleted file mode 100644 index 693d91e..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/expressions.txt +++ /dev/null @@ -1,119 +0,0 @@ -Lenguaje de autorización basado en expresiones -############################################## - -Introducción ------------- - -El lenguaje de expresiones es una muy potente alternativa para los atributos simples de los votantes del sistema de seguridad. Te permiten tomar decisiones complejas para controlar el acceso, y debido a que está compiladas hasta *PHP* crudo, son mucho más rápidas que los votantes integrados. Estas además se cargan de manera diferida por naturaleza, así que también ahorrarás algunos recursos, por ejemplo, no tener que iniciar el sistema *ACL* entero en cada petición. - -Uso ---- - -Uso programado -~~~~~~~~~~~~~~ - -Puedes ejecutar expresiones programadas utilizando el método ``isGranted`` del ``SecurityContext``. Algunos ejemplos: - -.. code-block:: php - - -.. code-block:: php - - isGranted(array(new Expression('hasRole("A")'))); - $securityContext->isGranted(array(new Expression('hasRole("A") or (hasRole("B") and hasRole("C"))'))); - $securityContext->isGranted(array(new Expression('hasPermission(object, "VIEW")'), $object)); - $securityContext->isGranted(array(new Expression('token.getUsername() == "Johannes"'))); - -Usando *Twig* -~~~~~~~~~~~~~ - -Puedes comprobar expresiones desde plantillas *Twig* utilizando la función ``is_expr_granted``. Algunos ejemplos: - -.. code-block:: jinja - - is_expr_granted("hasRole('FOO')") - is_expr_granted("hasPermission(object, 'VIEW')", object) - -Usando el control de acceso -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -También puedes usar expresiones en ``access_control``: - -.. configuration-block:: - - .. code-block:: yaml - - security: - access_control: - - { path: ^/foo, access: "hasRole('FOO') and hasRole('BAR')" } - - .. code-block:: xml - - - - - -Usándolo en base a anotaciones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Consulta la anotación ``@PreAuthorize`` en la `Referencia`_. Por favor, recuerda activar las expresiones en tu configuración, de lo contrario obtendrás una excepción al comprobar el acceso. - -Referencia ----------- - -+-----------------------------------+--------------------------------------------------------+ -| Expresión | Descripción | -+===================================+========================================================+ -| hasRole('ROLE') | comprueba si el segmento tiene un determinado rol. | -+-----------------------------------+--------------------------------------------------------+ -| hasAnyRole('ROLE1', 'ROLE2', ...) | Comprueba si el segmento tiene alguno de los roles | -| | proporcionados. | -+-----------------------------------+--------------------------------------------------------+ -| isAnonymous() | Comprueba si el segmento es anónimo. | -+-----------------------------------+--------------------------------------------------------+ -| isRememberMe() | Comprueba si el segmento es del tipo "Recuérdame". | -+-----------------------------------+--------------------------------------------------------+ -| isFullyAuthenticated() | Comprueba si el segmento está completamente | -| | autenticado. | -+-----------------------------------+--------------------------------------------------------+ -| isAuthenticated() | Comprueba si el segmento no es anónimo. | -+-----------------------------------+--------------------------------------------------------+ -| hasPermission(var, 'PERMISSION') | Comprueba si el segmento tiene los permisos | -| | proporcionados para un objeto dado (necesita el | -| | sistema *ACL*). | -+-----------------------------------+--------------------------------------------------------+ -| token | Variable que permite el acceso al segmento que se | -| | encuentra actualmente en el contexto de seguridad. | -+-----------------------------------+--------------------------------------------------------+ -| user | Variable que permite el acceso al usuario que está | -| | actualmente en el contexto de seguridad. | -+-----------------------------------+--------------------------------------------------------+ -| object | Variable que hace referencia al objeto para el cual se | -| | solicita acceso. | -+-----------------------------------+--------------------------------------------------------+ -| #*paramName* | Cualquier identificador prefijado con # se refiere a | -| | un parámetro del mismo nombre pasado al método donde | -| | se usa la expresión | -+-----------------------------------+--------------------------------------------------------+ -| and / && | El operador binario «and» | -+-----------------------------------+--------------------------------------------------------+ -| or / || | El operador binario «or» | -+-----------------------------------+--------------------------------------------------------+ -| == | El operador binario «is equal» | -+-----------------------------------+--------------------------------------------------------+ -| not / ! | Operador de negación | -+-----------------------------------+--------------------------------------------------------+ - -Recursos adicionales --------------------- - -.. toctree :: - :hidden: - - cookbook/creating_your_own_expression_function - -- :doc:`Creando tus propieas funciones de expresión ` diff --git a/_sources/bundles/JMSSecurityExtraBundle/index.txt b/_sources/bundles/JMSSecurityExtraBundle/index.txt deleted file mode 100644 index 0fd0258..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/index.txt +++ /dev/null @@ -1,45 +0,0 @@ -``JMSSecurityExtraBundle`` -========================== - -Resumen -------- - -Este paquete mejora el componente ``Security`` de *Symfony2* añadiendo nuevas características. - -Características: - -- Potente lenguaje de autorización basado en expresiones -- Método de seguridad para autorización -- Configuración de autorización vía anotaciones -- Generador de números aleatorios seguros - -Documentación -------------- - -.. toctree:: - :hidden: - - installation - expressions - configuration - method_security_authorization - annotations - -- :doc:`installation` -- :doc:`configuration` -- :doc:`expressions` -- :doc:`method_security_authorization` -- :doc:`random_number_generator` -- :doc:`annotations` - -Licencia --------- - -El código está liberado bajo la amigable `Licencia de Apache2`_. - -La documentación está sujeta a la `Attribution-NonCommercial-NoDerivs 3.0 Unported -license`_. - -.. _`Licencia de Apache2`: http://www.apache.org/licenses/LICENSE-2.0.html -.. _`Attribution-NonCommercial-NoDerivs 3.0 Unported license`: http://creativecommons.org/licenses/by-nc-nd/3.0/ - diff --git a/_sources/bundles/JMSSecurityExtraBundle/installation.txt b/_sources/bundles/JMSSecurityExtraBundle/installation.txt deleted file mode 100644 index 179820f..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/installation.txt +++ /dev/null @@ -1,123 +0,0 @@ -Instalando ----------- - -1. Usando ``Composer`` (recomendado) ------------------------------------- - -Para instalar ``JMSSecurityExtraBundle`` con ``Composer`` sólo añade lo siguiente al tu archivo ``composer.json``: - -.. code-block:: js - - // composer.json - { - // ... - require: { - // ... - "jms/security-extra-bundle": "dev-master" - } - } - -.. note:: - - Por favor, sustituye ``dev-master`` en el fragmento anterior con la última rama estable, por ejemplo ``1.0.*``. - -Luego, puedes instalar las nuevas dependencias ejecutando la orden ``update`` de ``Composer`` desde el directorio donde tienes tu archivo ``composer.json``: - -.. code-block:: bash - - $ php composer.phar update jms/security-extra-bundle - -Ahora, ``Composer`` automáticamente descargará todos los archivos necesarios y los instalará -por ti. Todo lo que resta por hacer es actualizar el archivo ``AppKernel.php`` y registrar el nuevo paquete: - -.. code-block:: php - - -.. code-block:: php - - registerNamespaces(array( - // ... - // ... - 'JMS' => __DIR__.'/../vendor/bundles', - 'Metadata' => __DIR__.'/../vendor/metadata/src', - 'CG' => __DIR__.'/../vendor/cg-library/src', - // ... - )); - -Ahora usa el programa ``vendors`` para clonar en tu proyecto los repositorios recientemente añadidos: - -.. code-block:: bash - - php bin/vendors install diff --git a/_sources/bundles/JMSSecurityExtraBundle/method_security_authorization.txt b/_sources/bundles/JMSSecurityExtraBundle/method_security_authorization.txt deleted file mode 100644 index 8c7b5dd..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/method_security_authorization.txt +++ /dev/null @@ -1,55 +0,0 @@ -Método de seguridad para autorización -------------------------------------- - -Los métodos de seguridad permiten controlar el acceso con más detalle del que tiene para ofrecer *Symfony2*. - -Generalmente puedes salvaguardar todos los métodos públicos, protegidos que no son estáticos, y no son finales. Los métodos privados no se pueden asegurar. También puedes añadir metadatos para métodos abstractos, o interfaces que entonces serán aplicados automáticamente a sus implementaciones concretas. - -Control de acceso vía configuración ``DI`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes especificar **expresiones** para el control de acceso en la configuración ``DI``: - -.. code-block:: yaml - - # config.yml - jms_security_extra: - method_access_control: - ':loginAction$': 'isAnonymous()' - 'AcmeFooBundle:.*:deleteAction': 'hasRole("ROLE_ADMIN")' - '^MyNamespace\MyService::foo$': 'hasPermission(#user, "VIEW")' - -El patrón es una expresión regular que distingue entre mayúsculas y minúsculas emparejada contra dos notaciones. -Se utiliza la primer coincidencia. - -En primer lugar, tu patrón se compara con la notación de controladores que no son servicios. -Obviamente, esto sólo se hace si tu clase en realidad es un controlador, por ejemplo, ``AcmeFooBundle:Add:new`` para un controlador llamado ``AddController`` y un método denominado ``NewAction`` en un subespacio de nombres ``Controller`` de un paquete llamado ``AcmeFooBundle``. - -Por último, tu patrón se empareja contra la concatenación del nombre de clase, y el nombre del método que está invocando, por ejemplo, ``Mi\Completamente\Cualificado\NombreClase::miNombreMetodo``. - -.. Note:: - - Si quisieras asegurar controladores que no son servicios, en su lugar deberías usar el ``JMSDiExtraBundle``. - -Control de acceso vía anotaciones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si quisieras asegurar un servicio con ``anotaciones``, necesitas habilitar la configuración de ``annotation`` para ese servicio: - -.. configuration-block:: - - .. code-block:: yaml - - services: - foo: - class: Bar - tags: [ { name: "security.secure_service" } ] - - .. code-block:: xml - - - - - - -En caso que quieras configurar todos los servicios vía ``anotaciones``, también puedes poner ``secure_all_services`` a ``true``. Entonces, no necesitas añadir una etiqueta a cada servicio. diff --git a/_sources/bundles/JMSSecurityExtraBundle/random_number_generator.txt b/_sources/bundles/JMSSecurityExtraBundle/random_number_generator.txt deleted file mode 100644 index 04a34f1..0000000 --- a/_sources/bundles/JMSSecurityExtraBundle/random_number_generator.txt +++ /dev/null @@ -1,60 +0,0 @@ -Generador de números aleatorios seguros ---------------------------------------- - -.. versionadded:: 1.2 - Se añadió el generador de números aleatorios seguros. - -Introducción ------------- - -En casi todas las aplicaciones, necesitas generar números aleatorios que un posible atacante no pueda adivinar. Desafortunadamente, *PHP* no proporciona la capacidad para hacerlo de forma consistente en todas las plataformas. - -Este paquete viene con varias implementaciones de proveedores de semillas, y se elige el mejor proveedor posible, dependiendo de tu configuración de *PHP*. - -Configurando ------------- - -Puedes activar el servicio ``«security.secure_random»`` con la siguiente configuración: - -.. configuration-block:: - - .. code-block:: yaml - - jms_security_extra: - util: - secure_random: ~ - - .. code-block:: xml - - - - - - - -También asegúrate de ejecutar ``php app/console doctrine:scheme:update``, o crea una migración equivalente para importar la tabla ``seed``. - -Usándolo --------- - -El generador se activa con el ``id`` de servicio ``security.secure_random``. - -.. code-block:: php - - container->get('security.secure_random'); - $bytes = $generator->nextBytes(16); // número aleatorio de 128-bit - -``$bytes`` en el ejemplo anterior contiene datos binarios. Luego puedes convertir estos datos a un formato que puedas imprimir utilizando una de estas funciones: - -.. code-block:: php - - -.. code-block:: php - - setExpires()`` -``@Cache(smaxage="15")`` ``$response->setSharedMaxAge()`` -``@Cache(maxage="15")`` ``$response->setMaxAge()`` -``@Cache(vary=["Cookie"])`` ```$response->setVary()`` -================================== =================================== - -.. note:: - - El atributo ``expires`` toma cualquier fecha válida entendida por la función ``strtotime()`` de *PHP*. diff --git a/_sources/bundles/SensioFrameworkExtraBundle/annotations/converters.txt b/_sources/bundles/SensioFrameworkExtraBundle/annotations/converters.txt deleted file mode 100644 index 44bf41f..0000000 --- a/_sources/bundles/SensioFrameworkExtraBundle/annotations/converters.txt +++ /dev/null @@ -1,202 +0,0 @@ -``@ParamConverter`` -=================== - -Usando ------- - -La anotación ``@ParamConverter`` llama a ``converters`` para convertir parámetros de la petición a objetos. Estos objetos se almacenan como atributos de la petición y por lo tanto se pueden inyectar en los argumentos del método controlador:: - - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter; - - /** - * @Route("/blog/{id}") - * @ParamConverter("post", class="SensioBlogBundle:Post") - */ - public function showAction(Post $post) - { - } - -Suceden varias cosas bajo el capó: - -* El convertidor intenta obtener un objeto ``SensioBlogBundle:Post`` desde los atributos de la petición (los atributos de la petición provienen de los marcadores de posición de la ruta -- aquí ``id``); - -* Si no se encontró algún objeto ``Post``, se genera una ``respuesta`` ``404``; - -* Si se encuentra un objeto ``Post``, se define un nuevo atributo ``post`` para la ``petición`` (accesible a través de ``$request->attributes->get('post')``); - -* Al igual que cualquier otro atributo de la petición, este se inyecta automáticamente en el controlador cuando está presente en la firma del método. - -Si utilizas el tipo como el del ejemplo anterior, incluso puedes omitir la anotación ``@ParamConverter`` por completo: - -.. code-block:: php - - // automático con firma de método - public function showAction(Post $post) - { - } - -Para detectar qué convertidor está corrido en un parámetro se ejecuta el siguiente proceso : - -* Si se eligió un convertidor explícitamente con ``@ParamConverter(converter="nombre")`` se elige el convertidor con el nombre dado. -* De lo contrario se itera sobre todos los parámetros de convertidores registrados por prioridad. - El método ``supports()`` es invocado para comprobar si un parámetro convertidor puede convertir la petición en el parámetro requerido. Si regresa ``true`` el parámetro ``converter`` es invocado. - -Convertidores integrados ------------------------- - -El paquete tiene dos convertidor integrados, uno es el convertidor *Doctrine* y el otro``DateTime``. - -Convertidor *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~ - -Nombre de convertidor: ``doctrine.orm`` - -El convertidor de *Doctrine* intenta convertir los atributos de la petición a entidades -de recuperadas de la base de datos por *Doctrine*. Hay dos distintos posibles enfoques: - -- Recuperar el objeto por clave primaria -- Recuperar el objeto por uno o varios campos que contienen valores únicos en la base de datos. - -El siguiente algoritmo determina qué operación realizar. - -- Si en la ruta está presente un argumento ``{id}``, busca el objeto por clave primaria. -- Si se configura una opción ``'id'`` y el argumento ruta concuerda, busca el objeto por clave primaria. -- Si no aplican las reglas anteriores, intenta encontrar una entidad emparejando los argumentos de la ruta con los campos de la entidad. Puedes controlar este proceso configurando el argumento ``exclude`` o asignando un atributo al campo llamado ``mapping``. - -De manera predeterminada, el convertidor de *Doctrine* utiliza el valor *predeterminado* del gestor de la entidad. Lo puedes configurar con la opción ``entity_manager``: - -.. code-block:: php - - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter; - - /** - * @Route("/blog/{id}") - * @ParamConverter("post", class="SensioBlogBundle:Post", options={"entity_manager" = "foo"}) - */ - public function showAction(Post $post) - { - } - -Si el marcador de posición no tiene el mismo nombre como clave primaria, pasa la opción ``id``:: - - /** - * @Route("/blog/{post_id}") - * @ParamConverter("post", class="SensioBlogBundle:Post", options={"id" = "post_id"}) - */ - public function showAction(Post $post) - { - } - -Esto también te permite tener múltiples convertidores en una acción:: - - /** - * @Route("/blog/{id}/comments/{comment_id}") - * @ParamConverter("comment", class="SensioBlogBundle:Comment", options={"id" = "comment_id"}) - */ - public function showAction(Post $post, Comment $comment) - { - } - -En el ejemplo anterior, el argumento ``post`` es manejado automáticamente, pero el comentario está configurado con la anotación debido a que ambos no pueden seguir la convención predefinida. - -Si quieres emparejar una entidad usando múltiples campos usa ``mapping``:: - - /** - * @Route("/blog/{date}/{slug}/comments/{comment_slug}") - * @ParamConverter("post", options={"mapping": {"date": "date", "slug": "slug"}}) - * @ParamConverter("comment", options={"mapping": {"comment_slug": "slug"}}) - */ - public function showAction(Post $post, Comment $comment) - { - } - -Si estás emparejando una entidad que utiliza varios campos, pero quieres excluir un -argumento de la ruta para que forme parte de los criterios:: - - /** - * @Route("/blog/{date}/{slug}") - * @ParamConverter("post", options={"exclude": ["date"]}) - */ - public function showAction(Post $post, \DateTime $date) - { - } - -Si quieres especificar el método ``repository`` a utilizar para encontrar la entidad (por ejemplo, para añadir una unión a la consulta), puedes añadir la opción ``repository_method``:: - - /** - * @Route("/blog/{id}") - * @ParamConverter("post", class="SensioBlogBundle:Post", options={"repository_method" = "findWithJoins"}) - */ - public function showAction(Post $post) - { - } - -Convertidor ``DateTime`` -~~~~~~~~~~~~~~~~~~~~~~~~ - -Nombre de convertidor: ``datetime`` - -El convertidor ``datetime`` convierte cualquier ruta o atributo de petición a una instancia de ``datetime``:: - - /** - * @Route("/blog/archive/{start}/{end}") - */ - public function archiveAction(\DateTime $start, \DateTime $end) - { - } - -Por omisión puede analizar cualquier formato de fecha aceptado por el constructor de ``DateTime``. Puedes ser más estricto con la entrada dada a través de las opciones:: - - /** - * @Route("/blog/archive/{start}/{end}") - * @ParamConverter("start", options={"format": "Y-m-d"}) - * @ParamConverter("end", options={"format": "Y-m-d"}) - */ - public function archiveAction(\DateTime $start, \DateTime $end) - { - } - -Creando un convertidor ----------------------- - -Todos los convertidores deben implementar la :class:`Sensio\\Bundle\\FrameworkExtraBundle\\Request\\ParamConverter\\ParamConverterInterface`:: - - namespace Sensio\Bundle\FrameworkExtraBundle\Request\ParamConverter; - - use Sensio\Bundle\FrameworkExtraBundle\Configuration\ConfigurationInterface; - use Symfony\Component\HttpFoundation\Request; - - interface ParamConverterInterface - { - function apply(Request $request, ConfigurationInterface $configuration); - - function supports(ConfigurationInterface $configuration); - } - -El método ``supports()`` debe devolver ``true`` cuando sea capaz de convertir la configuración dada (una instancia de ``ParamConverter``). - -La instancia de ``ParamConverter`` tiene tres piezas de información sobre la anotación: - -* ``name``: El atributo ``name``; -* ``class``: El atributo nombre de clase (puede ser cualquier cadena que represente el nombre de la clase); -* ``options``: Un arreglo de opciones - -El método ``apply()`` se llama cuando una configuración es compatible. Basándonos en los atributos de la petición, debemos establecer un atributo llamado ``$configuration->getName()``, que almacene un objeto de la clase ``$configuration->getClass()``. - -Para registrar tu servicio convertidor tienes que añadir una etiqueta a tu servicio: - -.. configuration-block:: - - .. code-block:: xml - - - - - -Puedes registrar un convertidor por prioridad, por nombre (atributo ``«converter»``) o ambos. Si no especificas una prioridad o nombre el convertidor será añadido a la pila de convertidores con una prioridad de `0`. Para desactiva explícitamente la inscripción por prioridad tienes que ajustar la ``priority="false"`` en la definición de tu etiqueta. - -.. tip:: - - Utiliza la clase ``DoctrineParamConverter`` como plantilla para tus propios convertidores. diff --git a/_sources/bundles/SensioFrameworkExtraBundle/annotations/routing.txt b/_sources/bundles/SensioFrameworkExtraBundle/annotations/routing.txt deleted file mode 100644 index cf51bcf..0000000 --- a/_sources/bundles/SensioFrameworkExtraBundle/annotations/routing.txt +++ /dev/null @@ -1,163 +0,0 @@ -``@Route`` y ``@Method`` -======================== - -Usando ------- - -La anotación ``@Route`` asigna un patrón de ruta a un controlador:: - - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; - - class PostController extends Controller - { - /** - * @Route("/") - */ - public function indexAction() - { - // ... - } - } - -La acción ``index`` del controlador ``Post`` ya está asignada a la dirección ``/``. Esto es equivalente a la siguiente configuración *YAML*: - -.. code-block:: yaml - - blog_home: - pattern: / - defaults: { _controller: SensioBlogBundle:Post:index } - -Al igual que cualquier patrón de ruta, puedes definir marcadores de posición, requisitos y valores predeterminados:: - - /** - * @Route("/{id}", requirements={"id" = "\d+"}, defaults={"id" = 1}) - */ - public function showAction($id) - { - } - -También puedes definir el valor predefinido para un marcador de posición con el valor predeterminado de *PHP*:: - - /** - * @Route("/{id}", requirements={"id" = "\d+"}) - */ - public function showAction($id = 1) - { - } - -También puedes combinar más de una *URL* definiendo una anotación ``@Route`` adicional:: - - /** - * @Route("/", defaults={"id" = 1}) - * @Route("/{id}") - */ - public function showAction($id) - { - } - -Activando ---------- - -Las rutas se deben importar para estar activas como cualquier otro recurso de enrutado (observa el tipo ``annotation``): - -.. code-block:: yaml - - # app/config/routing.yml - - # importa las rutas desde una clase controlador - post: - resource: "@SensioBlogBundle/Controller/PostController.php" - type: annotation - -También puedes importar un directorio completo: - -.. code-block:: yaml - - # importa rutas desde el directorio de controladores - blog: - resource: "@SensioBlogBundle/Controller" - type: annotation - -Como para cualquier otro recurso, puedes «montar» las rutas bajo un determinado prefijo: - -.. code-block:: yaml - - post: - resource: "@SensioBlogBundle/Controller/PostController.php" - prefix: /blog - type: annotation - -Nombre de ruta --------------- - -A una ruta definida con la anotación ``@Route`` se le asigna un nombre predeterminado, el cual está compuesto por el nombre del paquete, el nombre del controlador y el nombre de la acción. En el caso del ejemplo anterior sería -``sensio_blog_post_index``; - -Puedes utilizar el atributo ``name`` para reemplazar este nombre de ruta predeterminado:: - - /** - * @Route("/", name="blog_home") - */ - public function indexAction() - { - // ... - } - -Prefijo de ruta ---------------- - -Una anotación ``@Route`` en una clase controlador define un prefijo para todas las rutas de acción:: - - /** - * @Route("/blog") - */ - class PostController extends Controller - { - /** - * @Route("/{id}") - */ - public function showAction($id) - { - } - } - -La acción ``show`` ahora se asigna al patrón ``/blog/{id}``. - -Método de la ruta ------------------ - -Hay un atajo en la anotación ``@Method`` para especificar el método *HTTP* permitido para la ruta. Para usarlo, importa el espacio de nombres de la anotación ``Method``:: - - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Method; - - /** - * @Route("/blog") - */ - class PostController extends Controller - { - /** - * @Route("/edit/{id}") - * @Method({"GET", "POST"}) - */ - public function editAction($id) - { - } - } - -La acción ``editar`` ahora es asignada al patrón ``/blog/editar/{id}`` si el método *HTTP* utilizado es *GET* o *POST*. - -La anotación ``@Method`` sólo se toma en cuenta cuando una acción se anota con ``@Route``. - -Controlador como servicio -------------------------- - -También puedes utilizar la anotación ``@Route`` en una clase de controlador para asignar la clase controlador a un servicio para que el resolutor de controlador cree una instancia del controlador obteniendo el ``ID`` del contenedor en lugar de llamar a ``new PostController()`` en sí mismo:: - - /** - * @Route(service="my_post_controller_service") - */ - class PostController extends Controller - { - // ... - } diff --git a/_sources/bundles/SensioFrameworkExtraBundle/annotations/view.txt b/_sources/bundles/SensioFrameworkExtraBundle/annotations/view.txt deleted file mode 100644 index 4728207..0000000 --- a/_sources/bundles/SensioFrameworkExtraBundle/annotations/view.txt +++ /dev/null @@ -1,78 +0,0 @@ -``@Template`` -============= - -Usando ------- - -La anotación ``@Template`` asocia un controlador con un nombre de plantilla:: - - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template; - - /** - * @Template("SensioBlogBundle:Post:show.html.twig") - */ - public function showAction($id) - { - // consigue el Post - $post = ...; - - return array('post' => $post); - } - -Cuando utilizas la anotación ``@Template``, el controlador debe regresar un arreglo de parámetros para pasarlo a la vista en lugar de un objeto ``Respuesta``. - -.. tip:: - Si la acción devuelve un objeto ``Respuesta``, la anotación ``@Template`` simplemente se omite. - -Si la plantilla se nombra después del controlador y los nombres de acción, como en el caso del ejemplo anterior, puedes omitir incluso el valor de la anotación:: - - /** - * @Template - */ - public function showAction($id) - { - // consigue el Post - $post = ...; - - return array('post' => $post); - } - -.. note:: - - Si estás utilizando *PHP* como tu sistema de plantillas, necesitas hacerlo explícito:: - - /** - * @Template(engine="php") - */ - public function showAction($id) - { - // ... - } - -Y si los únicos parámetros para pasar a la plantilla son los argumentos del método, puedes utilizar el atributo ``vars`` en lugar de devolver un arreglo. Esto es muy útil en combinación con la :doc:`anotación @ParamConverter `:: - - /** - * @ParamConverter("post", class="SensioBlogBundle:Post") - * @Template("SensioBlogBundle:Post:show.html.twig", vars={"post"}) - */ - public function showAction(Post $post) - { - } - -que, gracias a las convenciones, es equivalente a la siguiente configuración:: - - /** - * @Template(vars={"post"}) - */ - public function showAction(Post $post) - { - } - -Puedes hacer que sea aún más conciso puesto que todos los argumentos del método se pasan automáticamente a la plantilla si el método devuelve ``null`` y no se define el atributo ``vars``:: - - /** - * @Template - */ - public function showAction(Post $post) - { - } diff --git a/_sources/bundles/SensioFrameworkExtraBundle/index.txt b/_sources/bundles/SensioFrameworkExtraBundle/index.txt deleted file mode 100644 index 404c6e5..0000000 --- a/_sources/bundles/SensioFrameworkExtraBundle/index.txt +++ /dev/null @@ -1,140 +0,0 @@ -``SensioFrameworkExtraBundle`` -============================== - -El ``FrameworkBundle`` predeterminado de *Symfony2* implementa una plataforma *MVC*, básica pero robusta y flexible. `SensioFrameworkExtraBundle`_ la extiende añadiendo agradables convenciones y anotaciones. Esto permite controladores más concisos. - -Instalando ----------- - -`Descarga`_ el paquete y ponlo bajo el espacio de nombres ``Sensio\Bundle\``. -Luego, como con cualquier otro paquete, inclúyelo en la clase de tu núcleo: - -.. code-block:: php - - public function registerBundles() - { - $bundles = array( - ... - - new Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle(), - ); - - ... - } - -Configurando ------------- - -Todas las características proporcionadas por el paquete están habilitadas por omisión, cuando registras el paquete en la clase de tu núcleo. - -La configuración predeterminada es la siguiente: - -.. configuration-block:: - - .. code-block:: yaml - - sensio_framework_extra: - router: { annotations: true } - request: { converters: true } - view: { annotations: true } - cache: { annotations: true } - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // Carga el generador de perfiles - $container->loadFromExtension('sensio_framework_extra', array( - 'router' => array('annotations' => true), - 'request' => array('converters' => true), - 'view' => array('annotations' => true), - 'cache' => array('annotations' => true), - )); - -Puedes desactivar algunas anotaciones y convenciones definiendo uno o más valores en ``false``. - -Anotaciones para controladores ------------------------------- - -Las anotaciones son una buena manera de configurar controladores fácilmente, desde las rutas hasta la configuración de la caché. - -Incluso si las anotaciones no son una característica natural de *PHP*, aún tienen varias ventajas sobre los métodos de configuración clásicos de *Symfony2*: - -* El código y la configuración están en el mismo lugar (la clase controlador) -* Fáciles de aprender y usar; -* Concisas para escribirlas; -* Adelgazan tu controlador (puesto que su única responsabilidad es conseguir los datos del modelo). - -.. tip:: - - Si utilizas las clases ``view``, las anotaciones son una buena manera de evitar la creación de clases ``view`` para casos simples y comunes. - -Las siguientes anotaciones están definidas por el paquete: - -.. toctree:: - :maxdepth: 1 - - annotations/routing - annotations/converters - annotations/view - annotations/cache - -Este ejemplo muestra en acción todas las anotaciones disponibles:: - - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Cache; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Method; - - /** - * @Route("/blog") - * @Cache(expires="tomorrow") - */ - class AnnotController extends Controller - { - /** - * @Route("/") - * @Template - */ - public function indexAction() - { - $posts = ...; - - return array('posts' => $posts); - } - - /** - * @Route("/{id}") - * @Method("GET") - * @ParamConverter("post", class="SensioBlogBundle:Post") - * @Template("SensioBlogBundle:Annot:post.html.twig", vars={"post"}) - * @Cache(smaxage="15") - */ - public function showAction(Post $post) - { - } - } - -En la medida en que el método ``showAction`` siga algunas convenciones, puedes omitir algunas anotaciones:: - - /** - * @Route("/{id}") - * @Cache(smaxage="15") - */ - public function showAction(Post $post) - { - } - -Es necesario importar las rutas para activarlas como cualquier otro recurso de enrutado, ve :doc:`Activando anotaciones de enrutado ` para detalles. - -.. _`SensioFrameworkExtraBundle`: https://github.com/sensio/SensioFrameworkExtraBundle -.. _`Descarga`: http://github.com/sensio/SensioFrameworkExtraBundle diff --git a/_sources/bundles/SensioGeneratorBundle/commands/generate_bundle.txt b/_sources/bundles/SensioGeneratorBundle/commands/generate_bundle.txt deleted file mode 100644 index ac92f52..0000000 --- a/_sources/bundles/SensioGeneratorBundle/commands/generate_bundle.txt +++ /dev/null @@ -1,53 +0,0 @@ -Generando la estructura para un nuevo paquete -============================================= - -Usando ------- - -El ``generate:bundle`` genera una estructura para un nuevo paquete y automáticamente lo activa en la aplicación. - -De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre del paquete, ubicación, formato y estructura de configuración predeterminada: - -.. code-block:: bash - - php app/console generate:bundle - -Para desactivar el modo interactivo, utiliza la opción ``--no-interaction`` pero no olvides suministrar todas las opciones necesarias: - -.. code-block:: bash - - php app/console generate:bundle --namespace=Acme/Bundle/BlogBundle --no-interaction - -Opciones disponibles --------------------- - -* ``--namespace``: El espacio de nombres a crear para el paquete. El espacio de nombres debe comenzar con un nombre de «proveedor», tal como el nombre de tu empresa, el nombre de tu proyecto, o el nombre de tu cliente, seguido por uno o más subespacios de nombres para una categoría opcional, el cual debe terminar con el nombre del paquete en sí mismo (debe tener ``Bundle`` como sufijo): - - .. code-block:: bash - - php app/console generate:bundle --namespace=Acme/Bundle/BlogBundle - -* ``--bundle-name``: El nombre opcional del paquete. Esta debe ser una cadena que termine con el sufijo ``Bundle``: - - .. code-block:: bash - - php app/console generate:bundle --bundle-name=AcmeBlogBundle - -* ``--dir``: El directorio en el cual guardar el paquete. Por convención, la orden detecta y utiliza el directorio ``src/`` de tu aplicación: - - .. code-block:: bash - - php app/console generate:bundle --dir=/var/www/miproyecto/src - -* ``--format``: (**annotation**) [valores: ``yml``, ``xml``, ``php`` o ``annotation``] - Determina el formato de enrutado a usar para los archivos de configuración generados. De manera predeterminada, la orden utiliza el formato ``annotation``. Al elegir el formato ``annotation`` se espera que el paquete ``SensioFrameworkExtraBundle`` ya esté instalado: - - .. code-block:: bash - - php app/console generate:bundle --format=annotation - -* ``--structure``: (**no**) [valores: ``yes``|``no``] Cuando o no generar una estructura de directorios completa incluyendo directorios públicos vacíos para documentación, activos *web* y diccionarios de traducción: - - .. code-block:: bash - - php app/console generate:bundle --structure=yes diff --git a/_sources/bundles/SensioGeneratorBundle/commands/generate_controller.txt b/_sources/bundles/SensioGeneratorBundle/commands/generate_controller.txt deleted file mode 100644 index 91c9385..0000000 --- a/_sources/bundles/SensioGeneratorBundle/commands/generate_controller.txt +++ /dev/null @@ -1,50 +0,0 @@ -Generando un nuevo controlador -============================== - -Usando ------- - -La orden ``generate:controller`` genera un nuevo controlador que incluye acciones, pruebas, plantillas y enrutado. - -De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre del paquete, ubicación, formato y estructura de configuración predeterminada: - -.. code-block:: bash - - $ php app/console generate:controller - -La orden se puede ejecutar en modo no interactivo usando la opción ``--non-interaction`` sin olvidar todas las opciones necesarias: - -.. code-block:: bash - - $ php app/console generate:controller --no-interaction --controller=AcmeBlogBundle:Post - -Opciones disponibles --------------------- - -* ``--controller``: El nombre del controlador dado como notación abreviada conteniendo el nombre del proveedor en el cual está ubicado el controlador y el nombre del paquete. Por ejemplo: ``AcmeBlogBundle:Post`` (crea el ``PostController`` en el paquete ``AcmeBlogBundle``): - - .. code-block:: bash - - $ php app/console generate:controller --controller=AcmeBlogBundle:Post - -* ``--actions``: La lista de acciones a generar en la clase controladora. Esta tiene un formato como ``%nombreaccion%:%ruta%:%plantilla%`` (dónde ``:%plantilla%`` es opcional: - - .. code-block:: bash - - $ php app/console generate:controller --actions="showPostAction:/article/{id} getListAction:/_list-posts/{max}:AcmeBlogBundle:Post:list_posts.html.twig" - - # o - $ php app/console generate:controller --actions=showPostAction:/article/{id} --actions=getListAction:/_list-posts/{max}:AcmeBlogBundle:Post:list_posts.html.twig - -* ``--route-format``: (**annotation**) [valores: yml, xml, php o annotation] - Esta opción determina el formato que utilizará el enrutado. De manera predeterminada, la orden utiliza el formato ``annotation``: - - .. code-block:: bash - - $ php app/console generate:controller --route-format=annotation - -* ``--template-format``: (**twig**) [valores: twigo php] Esta opción determina el formato que utilizarán las plantillas. De manera predeterminada, la orden utiliza el formato ``twig``: - - .. code-block:: bash - - $ php app/console generate:controller --template-format=twig diff --git a/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_crud.txt b/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_crud.txt deleted file mode 100644 index 963e156..0000000 --- a/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_crud.txt +++ /dev/null @@ -1,53 +0,0 @@ -Generando un controlador ``CRUD`` basado en una entidad de *Doctrine* -===================================================================== - -Usando ------- - -La orden ``generate:doctrine:crud`` genera un controlador básico para una determinada entidad ubicada en un determinado paquete. Este controlador te permite realizar cinco operaciones básicas en un modelo. - -* Listar todos los registros -* Mostrar un determinado registro identificado por su clave primaria -* Crear un nuevo registro. -* Editar un registro existente. -* Eliminar un registro existente. - -De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre de la entidad, el prefijo de la ruta o cuando o no generar acciones de escritura: - -.. code-block:: bash - - php app/console generate:doctrine:crud - -Para desactivar el modo interactivo, utiliza la opción ``--no-interaction`` pero no olvides suministrar todas las opciones necesarias: - -.. code-block:: bash - - php app/console generate:doctrine:crud --entity=AcmeBlogBundle:Post --format=annotation --with-write --no-interaction - -Opciones disponibles --------------------- - -* ``--entity``: El nombre de la entidad dado en notación de atajo que contiene el nombre del paquete en el que se encuentra la entidad y el nombre de la entidad. Por ejemplo: ``AcmeBlogBundle:Post``: - - .. code-block:: bash - - php app/console generate:doctrine:crud --entity=AcmeBlogBundle:Post - -* ``--route-prefix``: El prefijo que se utilizará para cada ruta que identifica una acción: - - .. code-block:: bash - - php app/console generate:doctrine:crud --route-prefix=acme_post - -* ``--with-write``: (**no**) [valores: ``yes`` | ``no``] Cuando o no generar las acciones ``new``, ``create``, ``edit``, ``update`` y ``delete``: - - .. code-block:: bash - - php app/console generate:doctrine:crud --with-write - -* ``--format``: (**annotation**) [valores: ``yml``, ``xml``, ``php`` o ``annotation``] - Determina el formato de enrutado a usar para los archivos de configuración generados. De manera predeterminada, la orden utiliza el formato ``annotation``. Al elegir el formato ``annotation`` se espera que el paquete ``SensioFrameworkExtraBundle`` ya esté instalado: - - .. code-block:: bash - - php app/console generate:doctrine:crud --format=annotation diff --git a/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_entity.txt b/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_entity.txt deleted file mode 100644 index 306d008..0000000 --- a/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_entity.txt +++ /dev/null @@ -1,46 +0,0 @@ -Generando una nueva entidad para resguardo con *Doctrine* -========================================================= - -Usando ------- - -La orden ``generate:doctrine:entity`` genera una nueva entidad para resguardo con *Doctrine*, incluyendo la definición de asignaciones y propiedades de clase, captadores y definidores. - -De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre del paquete, ubicación, formato y estructura de configuración predeterminada: - -.. code-block:: bash - - php app/console generate:doctrine:entity - -La orden se puede ejecutar en modo no interactivo usando la opción ``--non-interaction`` sin olvidar todas las opciones necesarias: - -.. code-block:: bash - - php app/console generate:doctrine:entity --non-interaction --entity=AcmeBlogBundle:Post --fields="title:string(100) body:text" --format=xml - -Opciones disponibles --------------------- - -* ``--entity``: El nombre de la entidad dado en notación de atajo que contiene el nombre del paquete en el que se encuentra la entidad y el nombre de la entidad. Por ejemplo: ``AcmeBlogBundle:Post``: - - .. code-block:: bash - - php app/console generate:doctrine:entity --entity=AcmeBlogBundle:Post - -* ``--fields``: La lista de campos a generar en la clase entidad: - - .. code-block:: bash - - php app/console generate:doctrine:entity --fields="titulo:string(100) cuerpo:text" - -* ``--format``: (**annotation**) [valores: ``yml``, ``xml``, ``php`` o ``annotation``] Esta opción determina el formato a usar para los archivos de configuración generados como enrutado. De manera predeterminada, la orden utiliza el formato ``anotación``: - - .. code-block:: bash - - php app/console generate:doctrine:entity --format=annotation - -* ``--with-repository``: Esta opción indica si se debe o no generar la clase *Doctrine* relacionada con ``EntityRepository``: - - .. code-block:: bash - - php app/console generate:doctrine:entity --with-repository diff --git a/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_form.txt b/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_form.txt deleted file mode 100644 index ee38233..0000000 --- a/_sources/bundles/SensioGeneratorBundle/commands/generate_doctrine_form.txt +++ /dev/null @@ -1,20 +0,0 @@ -Generando una nueva clase de tipo *Form* basada en una entidad *Doctrine* -========================================================================== - -Usando ------- - -La orden ``generate:doctrine:form`` genera una clase de tipo ``form`` básica usando los metadatos de asignación de una determinada clase ``entidad``: - -.. code-block:: bash - - php app/console generate:doctrine:form AcmeBlogBundle:Post - -Argumentos obligatorios ------------------------ - -* ``entity``: El nombre de la entidad dado en notación de atajo que contiene el nombre del paquete en el que se encuentra la entidad y el nombre de la entidad. Por ejemplo: ``AcmeBlogBundle:Post``: - - .. code-block:: bash - - php app/console generate:doctrine:form AcmeBlogBundle:Post diff --git a/_sources/bundles/SensioGeneratorBundle/index.txt b/_sources/bundles/SensioGeneratorBundle/index.txt deleted file mode 100644 index baac72e..0000000 --- a/_sources/bundles/SensioGeneratorBundle/index.txt +++ /dev/null @@ -1,36 +0,0 @@ -``SensioGeneratorBundle`` -========================= - -El paquete ``SensioGeneratorBundle`` extiende la interfaz predeterminada de la línea de ordenes de *Symfony2*, ofreciendo nuevas ordenes interactivas e intuitivas para generar esqueletos de código como paquetes, clases de formulario o controladores ``CRUD`` basados en un esquema de *Doctrine*. - -Instalando ----------- - -`Descarga`_ el paquete y ponlo bajo el espacio de nombres ``Sensio\Bundle\``. -Luego, como con cualquier otro paquete, inclúyelo en tu clase núcleo:: - - public function registerBundles() - { - $bundles = array( - ... - - new Sensio\Bundle\GeneratorBundle\SensioGeneratorBundle(), - ); - - ... - } - -Lista de ordenes disponibles ----------------------------- - -El paquete ``SensioGeneratorBundle`` viene con cuatro nuevas ordenes que puedes ejecutar en modo interactivo o no. El modo interactivo te hace algunas preguntas para configurar los parámetros para que la orden genere el código definitivo. La lista de nuevas ordenes se enumera a continuación: - -.. toctree:: - :maxdepth: 1 - - commands/generate_bundle - commands/generate_doctrine_crud - commands/generate_doctrine_entity - commands/generate_doctrine_form - -.. _`Descarga`: http://github.com/sensio/SensioGeneratorBundle \ No newline at end of file diff --git a/_sources/bundles/index.txt b/_sources/bundles/index.txt deleted file mode 100644 index c1761f1..0000000 --- a/_sources/bundles/index.txt +++ /dev/null @@ -1,16 +0,0 @@ -Paquetes de la edición estándar de *Symfony* -============================================ - -.. toctree:: - :hidden: - - SensioFrameworkExtraBundle/index - SensioGeneratorBundle/index - JMSAopBundle/index - JMSDiExtraBundle/index - JMSSecurityExtraBundle/index - DoctrineFixturesBundle/index - DoctrineMigrationsBundle/index - DoctrineMongoDBBundle/index - -.. include:: /bundles/map.rst.inc diff --git a/_sources/cmf/bundles/block.txt b/_sources/cmf/bundles/block.txt deleted file mode 100644 index 5764ebf..0000000 --- a/_sources/cmf/bundles/block.txt +++ /dev/null @@ -1,218 +0,0 @@ -``BlockBundle`` -=============== - -El `BlockBundle `_ proporciona integración con ``SonataBlockBundle``. -Este te asiste gestionando fragmentos de contenido, conocidos como bloques. Lo que hace ``BlockBundle`` es similar a lo que hace *Twig*, pero para bloques almacenados en una *BD*. De esta manera, un editor puede modificar los bloques. -Además, el ``BlockBundle`` proporciona la lógica para determinar qué bloque se tendría que dibujar en cuáles páginas. - -El ``BlockBundle`` por sí mismo no proporciona una funcionalidad de edición para bloques. No obstante, puedes encontrar ejemplos de cómo hacer editables los bloques en el `recinto de seguridad del CMF de Symfony `_. - -.. index:: BlockBundle - -Dependencias ------------- - -Este paquete está basado en el `SonataBlockBundle `_ - -.. _bundle-block-configuration: - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_block`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_block: - document_manager_name: default - -.. _bundle-block-document: - -Bloque documento ----------------- - -Antes de que puedas dibujar un bloque, necesitas crear un objeto que represente los datos de tu bloque en el repositorio. -Lo puedes conseguir con el siguiente fragmento de código (ten en cuenta que ``$parentPage`` necesita ser una instancia de una página definida por el `ContentBundle `_): - -.. code-block:: php - - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($parentPage); - $myBlock->setName('sidebarBlock'); - $myBlock->setTitle('My first block'); - $myBlock->setContent('Hello block world!'); - - $documentManager->persist($myBlock); - -Ten en cuenta que ``sidebarBlock`` es el identificador que escogimos para el bloque. Junto con el documento padre del bloque, esto hace único al bloque. Las otras propiedades son específicas de ``Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock``. - -.. note:: - - El sencillo bloque ahora está listo para dibujarlo, ve :ref:`bundle-block-rendering`. - -.. note:: - - Siempre asegúrate de implementar la interfaz ``Sonata\BlockBundle\Model\BlockInterface`` o un bloque de documento existente tal como ``Symfony\Cmf\Bundle\BlockBundle\Document\BaseBlock``. - -.. _bundle-block-service: - -Bloque de servicio ------------------- - -Si miras dentro de la clase ``SimpleBlock``, notarás el método ``getType``. Este define el nombre del servicio de bloque que procesa el bloque al dibujarlo. - -Un bloque de servicio contiene: - -* Un método ``execute`` -* configuración predefinida -* configuración de formulario -* configuración de caché -* activos *js* y *css* por cargar -* un método ``load`` - -Échale un vistazo a los bloques de servicio en ``Symfony\Cmf\Bundle\BlockBundle\Block`` para ver algunos ejemplos. - -.. note:: - - Asegúrate de implementar siempre la interfaz ``Sonata\BlockBundle\Block\BlockServiceInterface`` o un bloque de servicio existente tal como el ``Sonata\BlockBundle\Block\BaseBlockService``. - -.. _bundle-block-execute: - -El método ``execute`` -^^^^^^^^^^^^^^^^^^^^^ - -Este contiene el ``controlador`` lógico. Combina las opciones predefinidas en este método si lo quieres utilizar: - -.. code-block:: php - - // ... - if ($block->getEnabled()) { - // combina las opciones - $settings = array_merge($this->getDefaultSettings(), $block->getSettings()); - - $feed = false; - if ($settings['url']) { - $feed = $this->feedReader->import($block); - } - - return $this->renderResponse($this->getTemplate(), array( - 'feed' => $feed, - 'block' => $block, - 'settings' => $settings - ), $response); - } - // ... - -.. note:: - - Si tienes que usar mucha lógica, la puedes mover a un servicio específico e inyectarlo en el bloque de servicio. Luego usar ese servicio específico en el método ``execute``. - -configuración predefinida -^^^^^^^^^^^^^^^^^^^^^^^^^ - -El método ``getDefaultSettings`` contiene las opciones predefinidas de un bloque. Las opciones después se pueden alterar en múltiples sitios, reflejándose en una cascada como esta: - -* las opciones predefinidas se almacenan en el bloque de servicio -* las opciones se pueden alterar a través de los ayudantes de plantilla: - - .. code-block:: jinja - - {{ sonata_block_render({ - 'type': 'acme_main.block.rss', - 'settings': { - 'title': 'Symfony2 CMF news', - 'url': 'http://cmf.symfony.com/news.rss' - } - }) }} - -* y las opciones también se pueden alterar en un bloque de documento, la ventaja es que las opciones están almacenadas en *PHPCR* y te permiten implementar una interfaz de usuario final o de administración para cambiar algunas o todas las opciones. - -configuración de formulario -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Los métodos ``buildEditForm`` y ``buildCreateForm`` contienen configuración de formulario para editar utilizando una interfaz de usuario final o de administración. El método ``validateBlock`` contiene la configuración de validación. - -configuración de caché -^^^^^^^^^^^^^^^^^^^^^^ - -El método ``getCacheKeys`` contiene las claves utilizadas para el bloque de la memoria caché. - -*js* y *css* -^^^^^^^^^^^^ - -Puedes usar los métodos ``getJavascripts`` y ``getStylesheets`` para definir activos *js* y *css*. Usa los ayudantes de *Twig* ``sonata_block_include_javascripts`` y ``sonata_block_include_stylesheets`` para reproducirlos. - -.. code-block:: jinja - - {{ sonata_block_include_javascripts() }} - {{ sonata_block_include_stylesheets() }} - -.. note:: - - Esto reproducirá los bloques *js* y *css** de todos los bloques cargados en el contenedor de servicios de tu aplicación. - -El método ``load`` -^^^^^^^^^^^^^^^^^^ - -Puedes usar el método ``load`` para cargar datos adicionales. Este se invoca cada vez que se reproduce un bloque y antes de llamar al método ``execute``. - -.. _bundle-block-rendering: - -Dibujando el bloque -------------------- - -Para realmente reproducir el bloque del ejemplo de la sección del bloque documento, solo añade el siguiente código a tu plantilla *Twig*: - -.. code-block:: jinja - - {{ sonata_block_render({'name': 'sidebarBlock'}) }} - -Esto hará que se dibuje el ``BlockBundle`` según el bloque en cada página que tenga un bloque llamado ``'sidebarBlock'``. -Naturalmente, es necesario que la página real sea reproducida por la plantilla que contiene el fragmento anterior. - -Esto pasa al reproducir un bloque, ve las siguientes secciones para más detalles: - -* se carga un documento basándose en el nombre -* si está configurada la memorización en caché, se revisa la caché y si el contenido se encuentra se devuelve -* Cada bloque documento también tiene un servicio ``block``, se invoca al método execute: - - * aquí puedes poner lógica como en un controlador - * esta llama a una plantilla - * el resultado es un objeto Respuesta - -También Puedes :ref:`incorporar bloques en contenido ` utilizando el filtro ``cmf_embed_blocks``. - -Tipos de bloque ---------------- - -El ``BlockBundle`` viene con cuatro bloques de propósito general: - -* SimpleBlock: Un bloque sencillo con nada más que un título y un campo de hipertexto. Este normalmente sería el que un editor modificaría directamente, por ejemplo, la información de contacto -* ``ContainerBlock``: Un bloque que contiene de ``0`` a ``n`` bloques descendientes -* ``ReferenceBlock``: Un bloque que hace referencia a un bloque almacenado en algún otro lugar en el árbol de contenido. Por ejemplo, podrías desear referir partes de la información de contacto desde la página inicial -* ``ActionBlock``: Un bloque que invoca acciones de *Symfony2*. «¿Por qué utilizar esto en vez de llamar a la acción directamente desde mi plantilla?», te podrías preguntar. Bien, imagina el siguiente caso: Provees un bloque que dibuja reflexiones de tus últimas noticias. Sin embargo, no hay ninguna regla de en dónde debería aparecer. En su lugar, tu cliente quiere decidir en qué páginas se mostraría este bloque. Proporcionando un ``ActionBlock`` acorde, permites a tu cliente hacerlo sin llamarte (¡una y otra vez!) para cambiar algunas plantillas. - -Además el ``BlockBundle`` tiene bloques más específicos: - -* ``RssBlock``: Este bloque extiende el ``ActionBlock``: El bloque documento guarda la *url* del alimentador y la acción del controlador recupera elmentos del alimentador. La implementación predefinida utiliza el `EkoFeedBundle `_ para leer elementos del alimentador. - -Ejemplos --------- - -Puedes encontrar ejemplos de uso de este paquete en el `Recinto de seguridad del CMF de Symfony `_. -Dale un vistazo en el ``BlockBundle`` del recinto de seguridad. También te muestra cómo hacer editables los bloques usando el `CreateBundle `_. - -Referencia ----------- - -.. toctree:: - :maxdepth: 1 - :numbered: - - block/types - block/create_your_own_blocks - block/cache - block/relation_to_sonata_block_bundle diff --git a/_sources/cmf/bundles/block/cache.txt b/_sources/cmf/bundles/block/cache.txt deleted file mode 100644 index 7d0050e..0000000 --- a/_sources/cmf/bundles/block/cache.txt +++ /dev/null @@ -1,196 +0,0 @@ -Almacenando en caché -==================== - -El paquete ``BlockBundle`` integra con el `SonataCacheBundle `_ para proporcionar varias soluciones de almacenamiento en caché. Dale un vistazo a los adaptadores disponibles en el ``SonataCacheBundle`` para ver todas las opciones. - -El ``BlockBundle`` además proporciona sus propios adaptadores para: - -* `ESI `_ -* `SSI `_ -* Javascript asíncrono -* Javascript sincrónico - -.. note:: - - Es aconsejable almacenar todas las opciones en el bloque documento al utilizar la memoria caché. - -Dependencias ------------- - -La funcionalidad de memorización en caché es opcional y depende del `SonataCacheBundle `_. - -Instalando ----------- - -La instalación está dividida entre el *SonataCacheBundle*, el *SymfonyCmfBlockBundle* y el *SonataBlockBundle*: - -1. *SonataCacheBundle* - Sigue las instrucciones de instalación de la `documentación del SonataCacheBundle `_. -2. *SymfonyCmfBlockBundle* - Al final de tu archivo de enrutado, añade las siguientes líneas: - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - # ... - # rutas a los adaptadores de caché SymfonyCmfBlockBundle - block_cache: - resource: "@SymfonyCmfBlockBundle/Resources/config/routing/cache.xml" - prefix: / - -3. *SonataBlockBundle* - Utiliza la clave ``sonata_block`` para configurar el adaptador de caché para cada bloque de servicio. - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_block: - # ... - blocks: - symfony_cmf.block.action: - # Usa el id del adaptador del servicio cache - cache: symfony_cmf.block.cache.js_async - -Flujo de trabajo ----------------- - -Lo siguiente sucede al dibujar un bloque la memoria caché: - -* se carga un documento basándose en el nombre -* si está configurada la memorización en caché, se revisa la caché y si se encuentra el contenido se devuelve -* - - * las claves de la caché se componen utilizando: - - * las claves de la caché del bloque de servicio - * las extraCacheKeys pasadas desde la plantilla - - * El adaptador de caché es pedido por un elemento caché - - * los adaptadores *ESI* y *SSI* añaden una etiqueta específica y una *URL* para recuperar el contenido de bloque - * el adaptador *Javascript* añade *javascript* y una *URL* para recuperar el contenido del bloque - - * Si el elemento caché no ha expirado y tiene datos se devuelve -* se dibuja la plantilla: - - * Para *ESI* y *SSI* la *URL* es invocada para recuperar el contenido del bloque - * para *Javascript* el navegador llama una *URL* y reemplaza un marcador de posición con el contenido devuelto del bloque - -.. note:: - - Los adaptadores de caché adicionales del *BlockBundle* siempre regresan la caché encontrada, tiene una apariencia similar a la del método ``has`` de los adaptadores en el *SonataCacheBundle* para ver cómo responden ellos. - -Si caché está marcado y el adaptador de caché indica que ninguna caché se encontró, el flujo de trabajo procede así: - -* each block document also has a block service, the execute method of it is called to render the block and return a response -* if the response is cacheable the configured adapter creates a cache element, it contains - - * the computed cache keys - * the ttl of the response - * the response - * and additional contextual keys - -* the template is rendered - -Cache keys ----------- - -The block service has the responsibility to generate the cache keys, the method ``getCacheKeys`` returns these keys, see -:ref:`bundle-block-service`. - -The block services shipped with the BlockBunde use the ``getCacheKeys`` method of the ``Sonata\BlockBundle\Block\BaseBlockService``, -and return: - -* block_id -* updated_at - -.. note:: - - If block settings need to be persisted between requests it is advised to store them in the block document. Alternatively - they can be added to the cache keys. However be very cautious because, depending on the adapter, the cache keys can be - send to the browser and are not secure. - -Extra cache keys -~~~~~~~~~~~~~~~~ - -The extra cache keys array is used to store metadata along the cache element. The metadata can be used to invalidate a -set of cache elements. - -Contextual keys -~~~~~~~~~~~~~~~ - -The contextual cache array hold the object class and id used inside the template. This contextual cache array is then -added to the extra cache key. - -This feature can be use like this ``$cacheManager->remove(array('objectId' => 'id'))``. - -Of course not all cache adapters support this feature, varnish and mongodb do. - -The BlockBundle also has a cache invalidation listener that calls the ``flush`` method of a cache adapter automatically -when a cached block document is updated or removed. - -Dibujando el bloque -------------------- - -The following parameters can be used in the ``sonata_block_render`` code in your Twig template when using cache: - -* **useCache**: use the configured cache for a block (*default*: true) -* **extraCachekeys**: expects an array with extra cache keys (*default*: empty array) - -.. code-block:: jinja - - {{ sonata_block_render( - { 'name': 'rssBlock' }, - true, - { 'extra_key': 'my_block' } - ) }} - -Adaptadores ------------ - -*ESI* -~~~~~ - -This extends the default EsiCache adapter of the SonataCacheBundle. - -Configurando -"""""""""""" - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_block: - # ... - caches: - esi: - token: a unique security key # a random one is generated by default - servers: - - varnishadm -T 127.0.0.1:2000 {{ COMMAND }} "{{ EXPRESSION }}" - -SSI -~~~ - -This extends the default SsiCache adapter of the SonataCacheBundle. - -Configurando -"""""""""""" - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_block: - # ... - caches: - ssi: - token: una clave de seguridad única # de manera predeterminada se genera una aleatoria - -*JavaScript* -~~~~~~~~~~~~ - -Renders the block using javascript, the page is loaded and not waiting for the block to be finished rendering or -retrieving data. The block is then asynchronously or synchronously loaded and added to the page. \ No newline at end of file diff --git a/_sources/cmf/bundles/block/create_your_own_blocks.txt b/_sources/cmf/bundles/block/create_your_own_blocks.txt deleted file mode 100644 index 2c8c378..0000000 --- a/_sources/cmf/bundles/block/create_your_own_blocks.txt +++ /dev/null @@ -1,95 +0,0 @@ -Creando tus propios bloques -=========================== - -Sigue estos pasos para crear un bloque: - -* Crea un bloque documento -* Crea un bloque servicio y decláralo (opcional) -* create a data object representing your block in the repository, see :ref:`bundle-block-document` -* render the block, see :ref:`bundle-block-rendering` - -Digamos que estás trabajando en un proyecto donde tienes que integrar los datos recibidos de varios alimentadores ``RSS``. -Por supuesto podrías crear un ``ActionBlock`` para cada uno de estos alimentadores, ¿pero no es tonto eso? De hecho todas estas acciones se verían similares: Recibes los datos desde un alimentador, los saneas y los pasas a una plantilla. En su lugar decides crear tu propio bloque, el ``RSSBlock``. - -Creando un bloque documento -^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -La primer cosa que necesitas es un documento que contenga el dato. Es recomendable extender el ``Symfony\Cmf\Bundle\BlockBundle\Document\BaseBlock`` -contenido en este paquete (aun así no estás forzado a hacerlo, siempre y cuando implementes la ``Sonata\BlockBundle\Model\BlockInterface``). En tu documento, necesitas definir el método ``getType`` que únicamente regresa 'acme_main.block.rss'. - -.. code-block:: php - - namespace Acme\MainBundle\Document; - - use Doctrine\ODM\PHPCR\Mapping\Annotations as PHPCRODM; - use Symfony\Cmf\Bundle\BlockBundle\Document\BaseBlock; - - /** - * Rss Block - * - * @PHPCRODM\Document(referenceable=true) - */ - class RssBlock extends BaseBlock - { - public function getType() - { - return 'acme_main.block.rss'; - } - } - -Creando un servicio bloque -^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Podrías elegir utilizar un servicio de bloque existente porque su configuración y lógica ya satisfacen tus necesidades. Para nuestro bloque *rss* creamos un servicio que sabe cómo manejar los ``RSSBlocks``: - -* El método ``getDefaultSettings`` configura un título, una *URL* y la cantidad máxima de elementos - - .. code-block:: php - - // ... - public function getDefaultSettings() - { - return array( - 'url' => false, - 'title' => 'Insert the rss title', - 'maxItems' => 10, - ); - } - // .. - -* the execute method passes the settings to an rss reader service and forwards the feed items to a template, see :ref:`bundle-block-execute` - -Asegúrate de implementar la ``Sonata\BlockBundle\Block\BlockServiceInterface`` o un servicio bloque existente tal cómo ``Sonata\BlockBundle\Block\BaseBlockService``. - -Define el servicio en un archivo de configuración. Es importante etiquetar tu ``BlockService`` con ``'sonata.block'``, de lo contrario el paquete no lo reconocerá. - -.. configuration-block:: - - .. code-block:: yaml - - # services.yml - acme_main.rss_reader: - class: Acme\MainBundle\Feed\SimpleReader - - sandbox_main.block.rss: - class: Acme\MainBundle\Block\RssBlockService - arguments: - - "acme_main.block.rss" - - "@templating" - - "@sonata.block.renderer" - - "@acme_main.rss_reader" - tags: - - {name: "sonata.block"} - - .. code-block:: xml - - - - - - - acme_main.block.rss - - - - \ No newline at end of file diff --git a/_sources/cmf/bundles/block/relation_to_sonata_block_bundle.txt b/_sources/cmf/bundles/block/relation_to_sonata_block_bundle.txt deleted file mode 100644 index d0fdda1..0000000 --- a/_sources/cmf/bundles/block/relation_to_sonata_block_bundle.txt +++ /dev/null @@ -1,10 +0,0 @@ -Relación al paquete ``Block`` de ``Sonata`` -------------------------------------------- - -El ``BlockBundle`` está basado en el `SonataBlockBundle `_. -Este reemplaza componentes del paquete dónde es necesario que sea compatible con *PHPCR*. - -La siguiente imagen muestra dónde utilizamos nuestros propios componentes (azules): - -.. image:: ../../images/bundles/classdiagram.jpg - :align: center \ No newline at end of file diff --git a/_sources/cmf/bundles/block/types.txt b/_sources/cmf/bundles/block/types.txt deleted file mode 100644 index 171387f..0000000 --- a/_sources/cmf/bundles/block/types.txt +++ /dev/null @@ -1,40 +0,0 @@ -Tipos de bloque -=============== - -For each purpose a different block type can be used. The general purpose blocks can be used for several solutions. -The Block Bundle ships with more specific block types. - -RSSBlock --------- - -The RssBlock extends the ActionBlock and allows you to read feed items and display them in a list. - -Create a document: - -.. code-block:: php - - $myRssBlock = new RssBlock(); - $myRssBlock->setParentDocument($parentPage); - $myRssBlock->setName('rssBlock'); - $myRssBlock->setSetting('title', 'Symfony2 CMF news'); - $myRssBlock->setSetting('url', 'http://cmf.symfony.com/news.rss'); - $myRssBlock->setSetting('maxItems', 3); - - $documentManager->persist($myRssBlock); - -Todas las opciones disponibles son: - -* **url**: the url of the rss feed (*required*) -* **title**: the title for the list (*default*: Insert the rss title) -* **maxItems**: the maximum amount of items to return to the template (*default*: 10) -* **template**: the template to render the feed items (*default*: SymfonyCmfBlockBundle:Block:block_rss.html.twig) -* **ItemClass**: La clase utilizada para el objetO elemento pasado a la plantilla (*predefinido*: Symfony\Cmf\Bundle\BlockBundle\Model\FeedItem) - -The controller to get the feed items can also be changed: - -* define a different class for the controller service in your configuration using the DI service parameter ``symfony_cmf_block.rss_controller_class`` -* or set the actionName of your RssBlock document - -.. note:: - - El `Symfony CMF Sandbox `_ contiene un ejemplo del ``RssBlock``. \ No newline at end of file diff --git a/_sources/cmf/bundles/blog.txt b/_sources/cmf/bundles/blog.txt deleted file mode 100644 index ea6e950..0000000 --- a/_sources/cmf/bundles/blog.txt +++ /dev/null @@ -1,135 +0,0 @@ -``BlogBundle`` -============== - -El objetivo de este paquete es proporcionar todo lo que necesitas para crear un *blog* completo o sistema estilo *blog*. También incluye soporte integrado para el paquete ``Sonata Admin`` para ayudarte a levantar y correr rápidamente. - -Características actuales: - -* Host multiple blogs within a single website. -* Place blogs anywhere within your route hierarchy. -* Sonata Admin integration. - -Pending features: - -* Full tag support -* Frontend pagination (using knp-paginator) -* RSS/ATOM feed -* Comments -* User support (FOSUserBundle) - -Dependencias ------------- - -* :doc:`SymfonyCmfRoutingExtraBundle` is used to manage the routing. -* :doc:`PHPCR-ODM` is used to persist the bundles documents. - -Configurando ------------- - -The default configuration will work with the ``cmf-sandbox`` but you will probably -need to cusomize it to fit your own requirements. - -Parameters: - -* **routing_post_controller** - specifies which controller to use for showing posts. -* **routing_post_prefix** - this is the part of the URL which "prefixes" the post slug - e.g. with the default value the following post URL might be generated: ``http://example.com/my-blog/posts/this-is-my-post`` -* **blog_basepath** - *required* Specify the path where the blog content should be placed. -* **routing_basepath** - *required* Specify the basepath for the routing system. - -Ejemplo: - -.. code-block:: yaml - - symfony_cmf_blog: - routing_post_controller: symfony_cmf_blog.blog_controller:viewPost - routing_post_prefix: posts - blog_basepath: /cms/content - routing_basepath: /cms/routes - -.. note:: - - In the BlogBundle the controller is a *service*, and is referenced as such. You can - of course specify a controller using the standard `MyBundle:Controller:action` - syntax. See `controllers as services `_ in the official sf2 docs. - -Enrutando -~~~~~~~~~ - -To enable the routing system to automatically forward requests to the blog -controller when a Blog content is associated with a route, add the following -under the ``controllers_by_class`` section of ``symfony_cmf_routing_extra`` -in ``app/config/config.yml``: - -.. code-block:: yaml - - symfony_cmf_routing_extra: - ... - dynamic: - ... - controllers_by_class: - ... - Symfony\Cmf\Bundle\BlogBundle\Document\Blog: symfony_cmf_blog.blog_controller:listAction - -``Sonata Admin`` -~~~~~~~~~~~~~~~~ - -The ``BlogBundle`` has admin services defined for Sonata Admin, to make the blog -system visible on your dashboard, add the following to the -``sonata_admin`` section: - -.. code-block:: yaml - - sonata_admin: - ... - dashboard: - groups: - ... - blog: - label: blog - items: - - symfony_cmf_blog.admin - - symfony_cmf_post.admin - -Tree Browser Bundle -~~~~~~~~~~~~~~~~~~~ - -If you use the Symfony CMF Tree Browser bundle you can expose the blog routes -to enable blog edition from the tree browser. Expose the routes in the -``fos_js_routing`` section of ``app/config/config.yml``: - -.. code-block:: yaml - - fos_js_routing: - routes_to_expose: - ... - - admin_bundle_blog_blog_create - - admin_bundle_blog_blog_delete - - admin_bundle_blog_blog_edit - -Integration ------------ - -Templating -~~~~~~~~~~ - -The default templates are marked up for `Twitter Bootstrap `_. -But it is easy to completely customize the templates by **overriding** them. - -The one template you will have to override is the default layout, you will need -to change it and make it extend your applications layout. The easiest way to do -this is to create the following file: - -.. code-block:: jinja - - {# /app/Resources/SymfonyCmfBlogBundle/views/default_layout.html.twig #} - - {% extends "MyApplicationBundle::my_layout.html.twig" %} - - {% block content %} - {% endblock %} - -The blog will now use ``MyApplicationBundle::my_layout.html.twig`` instead of -``SymfonyCmfBlogBundle::default_layout.html.twig``. - -See `Overriding Bundle Templates `_ in the Symfony documentation for more information. diff --git a/_sources/cmf/bundles/content.txt b/_sources/cmf/bundles/content.txt deleted file mode 100644 index 62e65a1..0000000 --- a/_sources/cmf/bundles/content.txt +++ /dev/null @@ -1,31 +0,0 @@ -``ContentBundle`` -================= - -Este paquete proporciona un documento para contenido estático y el controlador para dibujarlo. - -Para una introducción ve la sección «Cómo empezar» de la página :doc:`../getting-started/content`. - -.. index:: ContentBundle - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_content`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_content: - admin_class: ~ - document_class: ~ - default_template: ~ - content_basepath: /cms/content - static_basepath: /cms/content/static - use_sonata_admin: auto - multilang: # la sección multilang completa es opcional - admin_class: ~ - document_class: ~ - use_sonata_admin: auto - locales: [] # si usas multilang, tienes que definir por lo menos una región diff --git a/_sources/cmf/bundles/core.txt b/_sources/cmf/bundles/core.txt deleted file mode 100644 index 3a1ca22..0000000 --- a/_sources/cmf/bundles/core.txt +++ /dev/null @@ -1,77 +0,0 @@ -``CoreBundle`` -============== - -Este es el `CoreBundle `_ para el ``CMF`` de *Symfony 2*. Este paquete proporciona funcionalidad común, ayudantes y utilidades para los otros paquetes del ``CMF``. - -Una de las características proporcionadas es una interfaz e implementación de un supervisor del flujo de trabajo para la publicación con una interfaz acompañante en la cual los modelos pueden implementar aquello que quieran apoyar con este supervisor. - -Además, proporciona un ayudante de *Twig* que expone varias funciones útiles para que las plantillas de *Twig* interaccinen con documentos *PHPCR-ODM*. - -.. index:: CoreBundle, PHPCR, ODM, publish workflow - -Configurando ------------- - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_core: - document_manager: default - role: IS_AUTHENTICATED_ANONYMOUSLY # usado por el supervisor del - # flujo de trabajo - # para publicación - -Supervisor del flujo de trabajo para publicación ------------------------------------------------- - -El paquete proporciona un servicio ``symfony_cmf_core.publish_workflow_checker`` que implementa la ``PublishWorkflowCheckerInterface``. Esta interfaz define un solo método ``checkIsPublished()``. - -.. code-block:: php - - $publishWorkflowChecker = $container->get('symfony_cmf_core.publish_workflow_checker'); - $ignoreRole = false // si ignora el rol al momento de decidir si considera - // el documento como publicado - if ($publishWorkflowChecker->checkIsPublished($document, $ignoreRole)) { - .. - } - -Extensión *Twig* ----------------- - -Implementa las siguientes funciones: - -* ``cmf_find``: Encuentra el documento por medio de la ruta y clase proporcionadas -* ``cmf_is_published``: Comprueba si el documento proporcionado está publicado -* ``cmf_prev``: Devuelve el anterior documento publicado examinando los nodos hijos del padre proporcionado -* ``cmf_next``: Devuelve el siguiente documento publicado examinando los nodos hijos del padre proporcionado -* ``cmf_children``: Devuelve un arreglo con todos los documentos hijo de los documentos proporcionados que están publicados -* ``cmf_document_locales``: Obtiene las regiones del documento proporcionado - -.. code-block:: jinja - - {% set page = cmf_find('/alguna/ruta') %} - - {% if cmf_is_published(page) %} - {% set prev = cmf_prev(page) %} - {% if prev %} - prev - {% endif %} - - {% set next = cmf_next(page) %} - {% if next %} - next - {% endif %} - - {% for news in cmf_children(page)|reverse %} -
  • {{ news.title }} ({{ news.publishStartDate | date('Y-m-d') }})
    • - {% endfor %} - - {% if 'de' in cmf_document_locales(page) %} - DE - {% endif %} - {% if 'fr' in cmf_document_locales(page) %} - DE - {% endif %} - {% endif %} diff --git a/_sources/cmf/bundles/create.txt b/_sources/cmf/bundles/create.txt deleted file mode 100644 index fed964c..0000000 --- a/_sources/cmf/bundles/create.txt +++ /dev/null @@ -1,323 +0,0 @@ -``CreateBundle`` -================ - -El `CreateBundle `_ integra a *Symfony 2* las bibliotecas ayudante :file:`create.js` y :file:`createphp`. - -:file:`create.js` es una comprensible interfaz de edición *web* para Sistemas de administración de contenido (*CMS*). Está diseñado para proporcionar un moderno gestor de contenido, totalmente basado en un entorno de navegadores HTML5. Creado para poder adaptarlo para trabajar en casi cualquier interfaz de administración de contenido. -Ve http://createjs.org/ - -``Createphp`` es una biblioteca *PHP* para ayudarte con anotaciones *RDF* en tus entidades/documentos. -Ve la documentación sobre como trabaja en https://github.com/flack/createphp. - -.. index:: CreateBundle - -Dependencias ------------- - -Este paquete incluye :file:`create.js` (el cuál empaca todas sus dependencias como *jquery*, *vie*, *hallo*, *backbone*, etc.) como submódulos *git*. No olvides añadir el guión del controlador de ``composer`` a tu archivo :file:`composer.json` como se describe abajo. - -Las dependencias de *PHP* son manejadas por medio de ``composer``. Utilizamos ``createphp`` así como ``AsseticBundle``, ``FOSRestBundle`` y por inferencia también ``JmsSerializerBundle``. Asegúrate de crear una instancia de todos estos paquetes en tu nucleo y de configurar correctamente el ``assetic``. - -Instalando ----------- - -Este paquete se incluye mejor utilizando ``Composer``. - -Edita el archivo ``composer`` de tu proyecto añadiendo un nuevo requisito para ``symfony-cmf/create-bundle``. -Luego, crea una sección de guiones o añádelo a una existente: - - -.. code-block:: yaml - - { - "scripts": { - "post-install-cmd": [ - "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ], - "post-update-cmd": [ - "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ] - } - } - - -Añade este paquete (y sus dependencias, si aún no están) al núcleo de tu aplicación: - -.. code-block:: php - - // application/ApplicationKernel.php - public function registerBundles() - { - return array( - // ... - new Symfony\Bundle\AsseticBundle\AsseticBundle(), - new JMS\SerializerBundle\JMSSerializerBundle($this), - new FOS\RestBundle\FOSRestBundle(), - new Symfony\Cmf\Bundle\CreateBundle\SymfonyCmfCreateBundle(), - // ... - ); - } - -También necesitas configurar el ``FOSRestBundle`` para manejar *json*: - - -.. code-block:: yaml - - fos_rest: - view: - formats: - json: true - -Concepto --------- - -``Createphp`` usa metadatos *RDF* sobre las clases de tu dominio, tal como *Doctrine* -sabe cómo se almacenan los metadatos de un objeto en la base de datos. Los metadatos son modelados por el tipo de la clase y pueden provenir de cualquier fuente. ``Createphp`` proporciona controladores de metadatos que leen *XML*, arreglos *PHP* y uno que justo introspecciona objetos y crea metadatos no semánticos que serán suficientes para editar con :file:`create.js`. - -El ``RdfMapper`` se usa para traducir entre tu capa de almacenamiento y ``createphp``. -Este es pasado al objeto ``dominio`` y al objeto metadatos pertinente. - -Con los metadatos y el ayudante de *Twig*, el contenido es dibujado con anotaciones *RDF*. :file:`create.js` es cargado y habilitado para editar las entidades. Guarda en la interfaz de administración las operaciones que ocurrieron en llamadas *ajax*. - -El controlador ``REST`` maneja esas llamadas *ajax*, y si quieres ser capaz de cargar imágenes, un controlador de imagen guarda las imágenes cargadas y devuelve la ubicación -de la imagen. - - -Configurando ------------- - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_create: - # cargando metadatos - - # Lista de directorios para buscar metadatos - rdf_config_dirs: - - "%kernel.root_dir%/Resources/rdf-mappings" - # busca asociaciones en /Resources/rdf-mappings - # auto_mapping: true - - # usa una clase diferente para el controlador REST - # rest_controller_class: FQN\Classname - - # manejo de imagen - imagen: - model_class: ~ - controller_class: ~ - - # rol para controlar el acceso para inclusión js, predefinido - # REST y controladores de imagen - # role: IS_AUTHENTICATED_ANONYMOUSLY - - # Habilita el asignador PHPCR-ODM de Doctrine - phpcr_odm: true - - # asociación de tipo rdf name => class nombre usado al añadir ítems a colecciones - map: - rdfname: FQN\Classname - - # url para mejora semántica stanbol, de lo contrario la - # predeterminada es la instalación del demo - # stanbol_url: http://dev.iks-project.eu:8081 - - # fija la barra de edición Hallo en lo alto de la página - # fixed_toolbar: true - - # los tipos RDF para elementos a modificar en texto plano - # plain_text_types: ['dcterms:title'] - - # los tipos RDFa para crear las rutas correspondientes después de - # añadido el contenido de estos tipos con Create.js. Esto no - # es necesario con el SimpleCmsBundle, porque el contenido y las - # rutas están en el mismo árbol del repositorio. - # create_routes_types: ['http://schema.org/NewsArticle'] - -El archivo javascript proporcionado configura :file:`create.js` y el editor «hallo». Activa algunos complementos como el editor de etiquetas para revisar colecciones de -atributos ``skos:related``. Esperamos poder añadir algunas opciones de configuración para modificar la configuración de :file:`create.js` pero también puedes utilizar el archivo como una plantilla y hacer la propia si necesitas mayor personalización. - - -Metadatos -+++++++++ - -:file:`createphp` necesita información de metadatos para cada clase de tu modelo del dominio. Por omisión, ``crea paquete`` usa el controlador de metadatos *XML* y busca los metadatos en los paquetes habilitados en /Resources/rdf-mappings. Si utilizas un paquete que no tiene ninguna asignación ``RDF``, puedes especificar una lista de ``rdf_config_dirs`` que se analizará adicionalmente para buscar metadatos. - -Consulta la documentación de `createphp `_ para el formato de los metadatos *XML*. - - -Controlando el acceso -+++++++++++++++++++++ - -Si utilizas el controlador ``REST`` predefinido, todos pueden editar el contenido una vez activado el ``crea paquete``. Para restringir el acceso, especifica un rol para el paquete que no sea el predefinido -``IS_AUTHENTICATED_ANONYMOUSLY``. -Si especificas un rol diferente, :file:`create.js` sólo se cargará si el usuario tiene ese rol y el controlador ``REST`` (y el controlador de imagen si está habilitado) revisará el rol. - -Si necesitas un control de acceso más fino, busca en el método asignador ``isEditable``. -Puedes extender el asignador a utilizar y sustituir ``isEditable`` para que responda si el objeto dominio que se le pasa es editable. - - -Manejando imágenes -++++++++++++++++++ - -Activa el controlador de imágenes simplista con la configuración ``image > model_class | controller_class``. Este controlador de imagen sólo despacha imágenes existentes en el repositorio ``PHPCR-ODM`` y también las sirve en peticiones. - -Si necesitas un diferente tratamiento de imágenes, puedes sobrescribir ``image.model_class`` y/o ``image.controller_class``, o implementar un servicio personalizado con ``ImageController`` y sustituir el ``symfony_cmf_create.image.controller``. - - -Asignación de peticiones a objetos -++++++++++++++++++++++++++++++++++ - -Por ahora, el paquete sólo proporciona un servicio para asociar al *PHPCR-ODM* de *Doctrine*. Activado al establecer ``phpcr_odm`` en ``true``. Si necesitas algo más, debes proporcionar un servicio ``symfony_cmf_create.object_mapper``. (Si necesitas un contenedor para el *ORM* de *Doctrine*, mira los asignadores de la biblioteca ``createphp`` y haz una petición de extracción en la biblioteca, y otra para exponer el *ORM* como asignador del servicio en el ``crea paquete``). - -Además, ten en cuenta que ``createphp`` apoyaría diferentes asignadores para diferentes tipos de ``RDF``. -Si necesitas esto, escarva un poco en ``createphp`` y ``crea paquete`` y haz una petición de extracción para activar esa característica. - -Para poder crear nuevos objetos, es necesario proporcionar una asociación entre los tipos ``RDF`` y los nombres de clase. (Pendiente: ¿no podemos indexar todas las asignaciones y hacer esto automáticamente?) - - -Enrutando -+++++++++ - -Por último añade la ruta correspondiente a tu configuración: - -.. configuration-block:: - - .. code-block:: yaml - - create: - resource: "@SymfonyCmfCreateBundle/Resources/config/routing/rest.xml" - create_image: - resource: "@SymfonyCmfCreateBundle/Resources/config/routing/image.xml" - - .. code-block:: xml - - - - -.. _bundle-create-usage-embed: - -Usando ------- - -Ajusta tu plantilla para cargar los archivos ``js`` del editor si la sesión actual tiene permitido editar el contenido. - -If you are using Symfony 2.2 or higher: - -.. code-block:: jinja - - {% render(controller("symfony_cmf_create.jsloader.controller:includeJSFilesAction")) with {'_locale': app.request.locale} %} - -For versions prior to 2.2, this will do: - -.. code-block:: jinja - - {% render "symfony_cmf_create.jsloader.controller:includeJSFilesAction" with {'_locale': app.request.locale} %} - -Además, asegúrate de que ``assetic`` está reescribiendo rutas en tus archivos *css*, y luego incluye los archivos *css* base (y personalízalos con tu propio *css* cuando sea necesario) con: - -.. code-block:: jinja - - {% include "SymfonyCmfCreateBundle::includecssfiles.html.twig" %} - -La otra cosa que tienes que hacer es proporcionar asignación ``RDF`` para las clases de tu modelo y ajusta tus plantillas para reproducir con ``createphp`` a modo de que :file:`create.js` sepa cual contenido es editable. - -Crea la asignación de metadatos *XML* en ``/Resources/rdf-mappings/`` o una ruta -a tu ``rdf_config_dirs`` configurado después del nombre completamente cualificado de tus clases del modelo sustituyendo ``\\`` con un punto (``.``), es decir, :file:`Symfony.Cmf.Bundle.SimpleCmsBundle.Document.MultilangPage.xml`. -Para un ejemplo de asociación ve los archivos en el :file:`cmf-sandbox`. La documentación de referencia está en el `repositorio de la biblioteca createphp `_. - -Para dibujar tu modelo, usa la etiqueta ``createphp`` de *Twig*: - -.. code-block:: html+jinja - - {% createphp page as="rdf" %} - {{ rdf|raw }} - {% endcreatephp %} - -O si necesitas más control sobre el *HTML* generado: - -.. code-block:: html+jinja - - {% createphp page as="rdf" %} -
    -

    {{ createphp_content( rdf.title ) }}

    -
    {{ createphp_content( rdf.body ) }}
    -
    - {% endcreatephp %} - - -Editores alternativos -+++++++++++++++++++++ - -You can write your own templates to load a javascript editor. They have to -follow the naming pattern ``SymfonyCmfCreateBundle::includejsfiles-%editor%.html.twig`` -to be loaded. In the includeJSFilesAction, you specify the editor parameter. -(Do not forget to add the ``controller`` call around the controller name inside -``render`` for Symfony 2.2, as in the example above.) - - {% render "symfony_cmf_create.jsloader.controller:includeJSFilesAction" with {'editor': 'aloha', '_locale': app.request.locale } %} - -.. note:: - - Create.js has built in support for Aloha and ckeditor, as well as the - default hallo editor. Those should be supported by the CreateBundle as well. - See these github issue for `ckeditor `_ - and `alhoa `_ integration. - - If you wrote the necessary code for one of those editors, or another editor - that could be useful for others, please send a pull request. - - -Desarrollando el editor ``wysiwyg`` ``hallo`` ---------------------------------------------- - -Puedes desarrollar el editor ``hallo`` dentro del ``Crea paquete``. De manera predefinida, se usa una versión minimizada del ``hallo`` empacada con ``Crea paquete``. Para desarrollar el código real, primero necesitas activar con ``checkout`` el repositorio ``hallo`` completo. Lo puedes hacer ejecutando la siguiente orden desde la línea de ordenes: - -.. code-block:: bash - - app/console cmf:create:init-hallo-devel - - -There is a special template to load the coffee script files. To load this, -just use the ``hallo-coffee`` editor with the includeJSFilesAction. -(Do not forget to add the ``controller`` call around the controller name inside -``render`` for Symfony 2.2, as in the example above.) - -.. code-block:: jinja - - {% render "symfony_cmf_create.jsloader.controller:includeJSFilesAction" with {'editor': 'hallo-coffee', '_locale': app.request.locale } %} - - -The hallo-coffee template uses assetic to load the coffee script files from -``Resources/public/vendor/hallo/src``, rather than the precompiled javascript -from ``Resources/public/vendor/create/deps/hallo-min.js``. This also means that -you need to add a mapping for coffeescript in your assetic configuration and -you need the `coffee compiler set up correctly `_. - -.. configuration-block:: - - .. code-block:: yaml - - assetic: - filters: - cssrewrite: ~ - coffee: - bin: %coffee.bin% - node: %coffee.node% - apply_to: %coffee.extension% - -In the cmf sandbox we did a little hack to not alwas trigger coffee script compiling. -En el archivo :file:`config.yml` hacemos configurable la extensión de ``coffee``. Ahora si :file:`parameters.yml` pone ``coffee.extension`` a ``\.coffee`` el ``coffeescript`` es compilado y el compilador de ``coffee`` debe estar instalado. Si lo pusiste a cualquier otra cosa tal como ``\.nocoffee`` entonces no es necesario tener instalado el compilador de ``coffee``. - -Los valores predefinidos para los tres parámetros son: - -.. configuration-block:: - - .. code-block:: yaml - - coffee.bin: /usr/local/bin/coffee - coffee.node: /usr/local/bin/node - coffee.extension: \.coffee diff --git a/_sources/cmf/bundles/doctrine_phpcr_admin.txt b/_sources/cmf/bundles/doctrine_phpcr_admin.txt deleted file mode 100644 index 7392fca..0000000 --- a/_sources/cmf/bundles/doctrine_phpcr_admin.txt +++ /dev/null @@ -1,41 +0,0 @@ -``SonataDoctrinePhpcrAdminBundle`` -================================== - -El `SonataDoctrinePhpcrAdminBundle `_ proporciona integración con el ``SonataAdminBundle`` para habilitar fácilmente la creación de interfaces de usuario. - -.. index:: TreeBundle - -Dependencias ------------- - -* `SonataAdminBundle `_ -* `TreeBundle `_ - -Configurando ------------- - -.. configuration-block:: - - .. code-block:: yaml - - sonata_doctrine_phpcr_admin: - templates: - form: - - # Predefinido: - - SonataDoctrinePHPCRAdminBundle:Form:form_admin_fields.html.twig - filter: - - # Predefinido: - - SonataDoctrinePHPCRAdminBundle:Form:filter_admin_fields.html.twig - types: - list: - - # Prototipo - name: [] [] - document_tree: - # Prototipo - class: # name of the class - # class names of valid children, manage tree operations for them and hide other children - valid_children: [] - image: \ No newline at end of file diff --git a/_sources/cmf/bundles/menu.txt b/_sources/cmf/bundles/menu.txt deleted file mode 100644 index f1f014d..0000000 --- a/_sources/cmf/bundles/menu.txt +++ /dev/null @@ -1,94 +0,0 @@ -``MenuBundle`` -============== - -El `MenuBundle `_ -proporciona menús desde un gestor de objetos de *Doctrine* con la ayuda de ``KnpMenuBundle``. - -.. index:: MenuBundle - -Dependencias ------------- - -Este paquete se extiende del `KnpMenuBundle `_. - -A menos que cambies los predefinidos y proporciones tus propias implementaciones, este paquete también depende de: - -* ``SymfonyRoutingExtraBundle`` para el servicio de enrutado ``symfony_cmf_routing_extra.dynamic_router``. - Ten en cuenta que necesitas habilitar explícitamente el enrutador dinámico puesto que de manera predeterminada no se carga. - Ve la :doc:`documentación del paquete routing extra ` para saber cómo hacer esto. -* :doc:`PHPCR-ODM ` para cargar documentos de ruta desde el contenido del repositorio - -Configurando ------------- - -Si quieres utilizar las configuraciones predefinidas, no debes cambiar nada. -Los valores son: - -.. configuration-block:: - - .. code-block:: yaml - - symfony_cmf_menu: - menu_basepath: /cms/menu - document_manager_name: default - admin_class: ~ - document_class: ~ - content_url_generator: router - content_key: ~ # (resuelve a DynamicRouter::CONTENT_KEY) - route_name: ~ # las rutas cmf son creadas por el contenido en lugar del nombre - content_basepath: ~ # por omisión a symfony_cmf_core.content_basepath - use_sonata_admin: auto # usa true/false para forzar si usar / no usar - # la administración de sonata - multilang: # la sección multilang completa es opcional - use_sonata_admin: auto # usa true/false para forzar el usar / no usar - # la administración de sonata - admin_class: ~ - document_class: ~ - locales: [] # si usas multilang, tienes que definir por lo menos una región - -Si quieres dibujar el menú desde *Twig*, asegúrate de no desactivar *Twig* en la sección de configuración ``knp_menu``. - -Si añades ``sonata-project/doctrine-phpcr-admin-bundle`` a la sección de requisitos del archivo :file:`composer.json`, los documentos del menú son expuestos en el ``SonataDoctrinePhpcrAdminBundle``. -Para instrucciones sobre cómo configurar este paquete ve :doc:`doctrine_phpcr_admin`. - -De manera predeterminada, ``use_sonata_admin`` se configura automáticamente basándose en si ``SonataDoctrinePhpcrAdminBundle`` está disponible, pero lo puedes desactivar explícitamente al incluirlo si ``sonata`` está habilitado, o habilitarlo explícitamente para obtener un error si se desactiva ``sonata``. - - -Entradas del menú ------------------ - -El documento ``MenuItem`` define entradas del menú. Puedes construir elementos del menú basándote en las rutas de *Symfony*, *url* absolutas o relativas o refiriendo documentos de contenido *PHPCR-ODM*. - -El árbol del menú se construye desde los documentos bajo ``[menu_basepath]/[menuname]``. Puedes utilizar diferentes clases de documento para elementos del menú, siempre y cuando implementen la ``Knp\Menu\NodeInterface`` para integrarse con ``KnpMenuBundle``. The default ``MenuNode`` -document discards children that do not implement this interface. - -La entrada resaltada actualmente es determinada al comprobar si el contenido asociado con un documento menú es igual que el contenido del ``DynamicRouter`` puesto en la petición. - - -Usando ------- - -Ajusta tu plantilla *Twig* para cargar el menú. - -.. code-block:: jinja - - {{ knp_menu_render('simple') }} - -El nombre del menú es el nombre del nodo bajo ``menu_basepath``. Por ejemplo si tu repositorio almacena los nodos del menú bajo ``/cms/menu``, dibujar «principal» significaría dibujar el menú que está en ``/cms/menu/principal`` - - -Cómo usar otros componentes no predefinidos -------------------------------------------- - -Si utilizas el menú del ``cmf`` con *PHPCR-ODM*, solo necesitas almacenar documentos de Ruta bajo ``menu_basepath``. Si utilizas un diferente gestor de objetos, debes asegúrarte que el documento raíz del menú se encuentra con: - -.. code-block:: php - - $dm->find($menu_document_class, $menu_basepath . $menu_name) - -The route document must implement ``Knp\Menu\NodeInterface`` - see -``MenuNode`` document for an example. Probablemente también necesites especificar la clase ``menu_document_class``, puesto que *PHPCR-ODM* sólo puede determinar el documento a partir del contenido en la base de datos. - -Si utilizas el menú ``CMF`` con el ``DynamicRouter``, no necesitas ningún nombre de ruta como el documento de menú, sólo debes proporcionar un campo ``content_key`` en las opciones. -Si quieres utilizar un diferente servicio para generar las *URL*, te debes asegurar de que tus entradas del menú proporcionan información en tu ``content_key`` seleccionada que el generador de la *url* pueda utilizar para generar la *url*. Dependiendo de tu generador, también podrías necesitar especificar un ``route_name``. -Ten en cuenta que si solo quieres generar rutas *Symfony* normales con un menú que está en la base de datos, puedes pasar el servicio de enrutado al núcleo como el ``content_url_generator``, asegúrate que el ``content_key`` nunca coincida y haz que tus documentos de menú proporcionen el nombre de ruta y eventuales ``routeParameters``. \ No newline at end of file diff --git a/_sources/cmf/bundles/phpcr-odm.txt b/_sources/cmf/bundles/phpcr-odm.txt deleted file mode 100644 index b49fb9f..0000000 --- a/_sources/cmf/bundles/phpcr-odm.txt +++ /dev/null @@ -1,758 +0,0 @@ -``DoctrinePHPCRBundle`` -======================= - -El `DoctrinePHPCRBundle `_ proporciona integración con el repositorio de contenido *PHP* y opcionalmente con el *PHPCR-ODM* de *Doctrine* -para proporcionar el gestor de documentos *ODM* en *Symfony*. - -Fuera de la caja, este paquete apoya las siguientes implementaciones *PHPCR*: - -* `Jackalope `_ (ambos transportes jackrabbit y doctrine-dbal) -* `Midgard2 `_ - - -.. index:: DoctrinePHPCRBundle, PHPCR, ODM - -.. tip:: - - Esta referencia sólo explica la integración de *Symfony2* con *PHPCR* y *PHPCR-ODM*. Para aprender cómo utilizar *PHPCR* ve al `sitio web de PHPCR `_ y para la documentación del `PHPCR-ODM `_ de *Doctrine* . - -Este paquete está basado en el ``AbstractDoctrineBundle`` y por lo tanto es similar a la configuración de los paquetes *ORM* y *MongoDB* de *Doctrine*. - -Configurando ------------- - -Ve :doc:`../tutorials/installing-configuring-doctrine-phpcr-odm` - - -Configurando ------------- - -.. tip:: - - Si sólo quieres utilizar el *PHPCR* sencillo sin el *PHPCR-ODM*, sencillamente no configures la sección ``odm`` para evitar que cargue los servicios. Ten en cuenta que muchos paquetes predefinidos del *CMF* usan documentos *PHPCR-ODM* y por ello necesitas habilitar el *ODM*. - - -Configurando la sesión *PHPCR* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La sesión necesita que especifiques una implementación *PHPCR* en la sección ``backend`` para el campo ``type``, junto con opciones de configuración al arranque de la implementación. Actualmente apoyamos ``jackrabbit``, ``doctrinedbal`` y ``midgard2``. -Independientemente de la interfaz de administración, cada sesión *PHPCR* necesita un espacio de trabajo, nombre de usuario y contraseña. - -.. tip:: - - Cada implementación de *PHPCR* debería proporcionar el espacio de trabajo llamado ``«default»``, pero puedes elegir uno diferente. Existe la orden ``doctrine:phpcr:workspace:create`` para iniciar un nuevo espacio de trabajo. See also :ref:`bundle-phpcr-odm-commands`. - -El nombre de usuario y contraseña que especifiques aquí son los utilizados en la capa *PHPCR* en -``PHPCR\SimpleCredentials``. Normalmente serán diferentes del nombre de usuario y contraseña utilizados por *Midgard2* o el *DBAL* de *Doctrine* para conectar al *RDBMS* subyacente donde de hecho se almacenan los datos. - -Si estás utilizando una de las interfaces de administración de ``Jackalope``, también puedes especificar ``opciones``. -Estas serán puestas en la sesión de ``Jackalope``. Actualmente esto se puede ajustar a nodos prerecuperados poniendo ``jackalope.fetch_depth`` a algo más grande que 0. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - # ve abajo cómo configurar la interfaz de administración que elejiste - workspace: default - username: admin - password: admin - ## ajusta opciones para jackrabbit y doctrinedbal (todas las versiones de jackalope) - # options: - # 'jackalope.fetch_depth': 1 - - - -Sesión *PHPCR* con ``Jackalope Jackrabbit`` -""""""""""""""""""""""""""""""""""""""""""" - -Es la única configuración requerida para instalar el ``Jackrabbit`` de apache (ve :ref:`instalando Jackrabbit `). - -La configuración necesita que el parámetro ``url`` apunte a tu ``jackrabbit``. Además puedes afinar algunas otras opciones específicas de ``jackrabbit``, por ejemplo para utilizarlas en la configuración de una carga balanceada o para fallar temprano y aminorar el costo de algunos viajes de ida y vuelta a la interfaz de administración. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: jackrabbit - url: http://localhost:8080/server/ - ## únicamente jackrabbit, opcional. ve https://github.com/jackalope/jackalope/blob/master/src/Jackalope/RepositoryFactoryJackrabbit.php - # default_header: ... - # expect: 'Esperaba: 100-continue' - # habilita si de cualquier manera quieres tener una excepción si - # falla el incio de sesión PHPCR - # check_login_on_server: false - # habilita si experimentas fallos de segmentación mientras - # trabajas con datos binarios en documentos - # disable_stream_wrapper: true - # habilita si no quieres usar transacciones y tampoco quieres - # que el odm use transacciones automáticamente, es altamente - # recomendable NO deshabilitar las transacciones - # disable_transactions: true - -.. _bundle-phpcr-odm-doctrinedbal: - -Sesión *PHPCR* con el ``Jackalope`` y *DBAL* de *Doctrine* -"""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - -Este tipo usa ``Jackalope`` con una abstracción en la capa de transporte de base de datos de *Doctrine* para proporcionar *PHPCR* sin ningún requisito de instalación más allá de cualquiera de los *RDBMS* apoyados por *Doctrine*. - -Necesitas configurar una conexión de *Doctrine* según el *DBAL* elejido en -la `documentación de Doctrine en Symfony2 `_. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - # habilita si quieres tener una excepción inmediatamente si falla - # el inicio de sesión PHPCR - # check_login_on_server: false - # habilita si experimentas fallos de segmentación mientras - # trabajas con datos binarios en documentos - # disable_stream_wrapper: true - # habilita si no quieres usar transacciones y tampoco quieres - # que el odm use transacciones automáticamente, es altamente - # recomendable NO deshabilitar las transacciones - # disable_transactions: true - - -Una vez configurada la conexión, puedes crear la base de datos y *debes* iniciar la base de datos con la orden ``doctrine:phpcr:init:dbal``. - -.. code-block:: bash - - app/console doctrine:database:create - app/console doctrine:phpcr:init:dbal - -.. tip:: - - Naturalmente, también puedes utilizar una diferente conexión en vez de la predefinida. - Es recomendable utilizar una conexión independiente para una base de datos separada si también *Doctrine* usa el acceso a datos del *ORM* o *DBAL* directamente, en lugar de mezclar este dato con las tablas generadas por ``jackalope-doctrine-dbal``. - Si tienes una conexión separada, necesitas pasar el nombre de la conexión alterna a la orden ``doctrine:database:create`` con la opción ``--connection``. Para las ordenes *PHPCR* de *Doctrine*, este parámetro no es necesario al configurar la conexión a utilizar. - - -Sesión *PHPCR* con ``Midgard2`` -""""""""""""""""""""""""""""""" - -``Midgard2`` es una aplicación que proporciona una extensión *PHP* compilada. Esta implementa la *API* de *PHPCR* en lo alto de un *RDBMS* estándar. - -To use the Midgard2 PHPCR provider, you must have both the `midgard2 PHP extension `_ -and `the midgard/phpcr package `_ installed. -The settings here correspond to Midgard2 repository parameters as explained in `the getting started document `_. - -La sesión de configuración de la interfaz de administración es la siguiente: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: midgard2 - db_type: MySQL - db_name: midgard2_test - db_host: "0.0.0.0" - db_port: 3306 - db_username: "" - db_password: "" - db_init: true - blobdir: /tmp/cmf-blobs - -Para más información, por favor, ve la `documentación oficial del PHPCR de Midgard `_. - -.. _bundle-phpcr-odm-configuration: - - -Configurando el *PHPCR-ODM* de *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Esta sección de configuración gestiona el sistema *PHPCR-ODM* de *Doctrine*. Si no configuras ninguna cosa aquí, los servicios *ODM* no serán cargados. - -Si habilitas ``auto_mapping``, puedes colocar tus asociaciones en ``/Resources/config/doctrine/.phpcr.xml`` resp. ``...yml`` para -configurar asociaciones a documentos proporcionadas en el directorio ``/Document``. De lo contrario necesitas configurar manualmente la sección de asignaciones. - -Si ``auto_generate_proxy_classes`` es ``false``, necesitas ejecutar la orden ``cache:warmup`` -para tener las clases delegadas generadas después de que modificaste un documento. También puedes ajustar cómo y dónde generar las clases delegadas con las opciones ``proxy_dir`` y ``proxy_namespace``. Normalmente las predefinidas están bien aquí. - -También puedes habilitar el `almacenamiento de metadatos en caché `_. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - odm: - configuration_id: ~ - auto_mapping: true - mappings: - : - mapping: true - type: ~ - dir: ~ - alias: ~ - prefix: ~ - is_bundle: ~ - auto_generate_proxy_classes: %kernel.debug% - proxy_dir: %kernel.cache_dir%/doctrine/PHPCRProxies - proxy_namespace: PHPCRProxies - - metadata_cache_driver: - type: array - host: ~ - port: ~ - instance_class: ~ - class: ~ - id: ~ - - -.. _bundle-phpcr-odm-multilang-config: - -Configuración de traducción -""""""""""""""""""""""""""" - -.. index:: I18N, Multilanguage - -Si estás utilizando documentos multilingües, necesitas configurar los idiomas disponibles. Para más información en documentos multilingües, ve la `documentación PHPCR-ODM en multilenguaje `_. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - odm: - ... - locales: - en: [en, de, fr] - de: [de, en, fr] - fr: [fr, en, de] - -Este bloque define el orden de regiones alternativas para ver si un documento no está traducido al idioma requerido. - - -Ajustes generales -~~~~~~~~~~~~~~~~~ - -Si ajustas la ruta a ``jackrabbit_jar``, puedes utilizar la orden de consola ``doctrine:phpcr:jackrabbit`` para arrancar y parar el ``jackrabbit``. - -Puedes poner a punto la producción de la orden ``doctrine:phpcr:dump`` con ``dump_max_line_length``. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - jackrabbit_jar: /ruta/a/jackrabbit.jar - dump_max_line_length: 120 - -.. _bundle-phpcr-odm-multiple-phpcr-sessions: - -Configurando múltiples sesiones -------------------------------- - -Si necesitas más de una interfaz de administración *PHPCR*, puedes definir ``sessions`` como hijo de la información de ``session``. Cada sesión tiene un nombre y configuración que puedes utilizar directamente en ``session``. también puedes sobrescribir qué sesión utilizar como ``default_session``. - - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - default_session: ~ - sessions: - : - workspace: ~ # Requerido - username: ~ - password: ~ - backend: - # como arriba - options: - # como arriba - -Si estás utilizando el *ODM*, también querrás configurar múltiples gestores de documento. - -Dentro de la sección *odm*, puedes añadir entradas nombradas en ``document_managers``. -Para utilizar la sesión no predefinida, especifica el atributo ``session``. - -.. configuration-block:: - - .. code-block:: yaml - - odm: - default_document_manager: ~ - document_managers: - : - # mismas claves como directamente en odm, ve arriba. - session: - - -Un ejemplo completo se ve como sigue: - -.. configuration-block:: - - .. code-block:: yaml - - doctrine_phpcr: - # configura las sesiones PHPCR - session: - sessions: - - default: - backend: %phpcr_backend% - workspace: %phpcr_workspace% - username: %phpcr_user% - password: %phpcr_pass% - - website: - backend: - type: jackrabbit - url: %magnolia_url% - workspace: website - username: %magnolia_user% - password: %magnolia_pass% - - dms: - backend: - type: jackrabbit - url: %magnolia_url% - workspace: dms - username: %magnolia_user% - password: %magnolia_pass% - # activa la capa ODM - odm: - document_managers: - default: - session: default - mappings: - SandboxMainBundle: ~ - SymfonyCmfContentBundle: ~ - SymfonyCmfMenuBundle: ~ - SymfonyCmfRoutingExtraBundle: ~ - - website: - session: website - configuration_id: sandbox_magnolia.odm_configuration - mappings: - SandboxMagnoliaBundle: ~ - - dms: - session: dms - configuration_id: sandbox_magnolia.odm_configuration - mappings: - SandboxMagnoliaBundle: ~ - - auto_generate_proxy_classes: %kernel.debug% - -.. tip:: - - Este ejemplo también utiliza diferentes configuraciones par repositorio (ve el atributo ``repository_id``). Este caso se explica en :doc:`../cookbook/phpcr-odm-custom-documentclass-mapper`. - -.. _bundle-phpcr-odm-commands: - - -Servicios ---------- - -Puedes acceder el servicios *PHPCR* con esto: - -.. code-block:: php - - container->get('doctrine_phpcr'); - // instancia de la sesión PHPCR - $session = $this->container->get('doctrine_phpcr.default_session'); - // instancia del gestor del documento ODM de PHPCR - $documentManager = $this->container->get('doctrine_phpcr.odm.default_document_manager'); - } - } - - -Eventos -------- - -You can tag services to listen to Doctrine PHPCR-ODM events. Esto trabaja de la misma manera que en el *ORM* de *Doctrine*. Las únicas diferencias son: - -* Usa la etiqueta ``doctrine_phpcr.event_listener`` resp. ``doctrine_phpcr.event_subscriber`` en vez de ``doctrine.event_listener``. -* expect the argument to be of class ``Doctrine\ODM\PHPCR\Event\LifecycleEventArgs`` rather than in the ORM namespace. - (this is subject to change, as doctrine commons 2.4 provides a common class for this event). - -You can register for the events as described in `the PHPCR-ODM documentation `_. -Or you can tag your services as event listeners resp. event subscribers. - -.. configuration-block:: - - .. code-block:: yaml - - services: - my.listener: - class: Acme\SearchBundle\EventListener\SearchIndexer - tags: - - { name: doctrine_phpcr.event_listener, event: postPersist } - - my.subscriber: - class: Acme\SearchBundle\EventSubscriber\MySubscriber - tags: - - { name: doctrine_phpcr.event_subscriber } - - -.. hint:: - - Doctrine event subscribers (both ORM and PHPCR-ODM) can not - return a flexible array of methods to call like the `Symfony event subscriber `_ - can do. Doctrine event subscribers must return a simple array of the event - names they subscribe to. Doctrine will then expect methods on the subscriber - with the names of the subscribed events, just as when using an event listener. - -More information with PHP code examples for the doctrine event system integration is in -this `Symfony cookbook entry `_. - - -Constraint validator --------------------- - -The bundle provides a ``ValidPhpcrOdm`` constraint validator you can use to -check if your document ``Id`` or ``Nodename`` and ``Parent`` fields are -correct. - - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/BlogBundle/Resources/config/validation.yml - Acme\BlogBundle\Entity\Author: - constraints: - - Doctrine\Bundle\PHPCRBundle\Validator\Constraints\ValidPhpcrOdm - - .. code-block:: php - - // src/Acme/BlogBundle/Entity/Author.php - - // ... - use Doctrine\Bundle\PHPCRBundle\Validator\Constraints as OdmAssert; - - /** - * @OdmAssert\ValidPhpcrOdm - */ - class Author - { - ... - } - - .. code-block:: xml - - - - - - - - - - -Form types ----------- - -The bundle provides a couple of handy form types for PHPCR and PHPCR-ODM specific cases, along with form type guessers. - - -``phpcr_odm_image`` -~~~~~~~~~~~~~~~~~~~ - -The ``phpcr_odm_image`` form maps to a document of type ``Doctrine\ODM\PHPCR\Document\Image`` -and provides a preview of the uploaded image. To use it, you need to include the -`LiipImagineBundle `_ in your project and define an -imagine filter for thumbnails. - -This form type is only available if explicitly enabled in your application configuration -by defining the ``imagine`` section under the ``odm`` section with at least ``enabled: true``. -You can also configure the imagine filter to use for the preview, as well as additional -filters to remove from cache when the image is replaced. If the filter is not specified, -it defaults to ``image_upload_thumbnail``. - -.. configuration-block:: - - .. code-block:: yaml - - doctrine_phpcr: - ... - odm: - imagine: - enabled: true - # filter: image_upload_thumbnail - # extra_filters: - # - imagine_filter_name1 - # - imagine_filter_name2 - - # Imagine Configuration - liip_imagine: - ... - filter_sets: - # define the filter to be used with the image preview - image_upload_thumbnail: - data_loader: phpcr - filters: - thumbnail: { size: [100, 100], mode: outbound } - -Then you can add images to document forms as follows: - -.. code-block:: php - - use Symfony\Component\Form\FormBuilderInterface; - - protected function configureFormFields(FormBuilderInterface $formBuilder) - { - $formBuilder - ->add('image', 'phpcr_odm_image', array('required' => false)) - ; - } - -.. tip:: - - If you set required to true for the image, the user must re-upload a new image - each time he edits the form. If the document must have an image, it makes sense - to require the field when creating a new document, but make it optional when - editing an existing document. - We are `trying to make this automatic `_. - - -Next you will need to add the ``fields.html.twig`` template from the DoctrinePHPCRBundle to the form.resources, -to actually see the preview of the uploaded image in the backend. - -.. configuration-block:: - - .. code-block:: yaml - - # Twig Configuration - twig: - form: - resources: - - 'DoctrinePHPCRBundle:Form:fields.html.twig' - - -The document that should contain the Image document has to implement a setter method. -To profit from the automatic guesser of the form layer, the name in the form element -and this method name have to match: - -.. code-block:: php - - public function setImage($image) - { - if (!$image) { - // Esto es normal y sucede cuándo ninguna nueva imagen se ha cargado - return; - } elseif ($this->image && $this->image->getFile()) { - // PENDIENTE: necesario hasta que se haya corregidi este fallo en PHPCRODM: https://github.com/doctrine/phpcr-odm/pull/262 - $this->image->getFile()->setFileContent($image->getFile()->getFileContent()); - } else { - $this->image = $image; - } - } - - -To delete an image, you need to delete the document containing the image. (There is a proposal -to improve the user experience for that in a `DoctrinePHPCRBundle issue `_.) - -.. note:: - - There is a doctrine listener to invalidate the imagine cache for the - filters you specified. This listener will only operate when an Image is - changed in a web request, but not when a CLI command changes images. When - changing images with commands, you should handle cache invalidation in - the command or manually remove the imagine cache afterwards. - - -phpcr_odm_reference_collection -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -This form type handles editing ``ReferenceMany`` collections on PHPCR-ODM documents. -It is a choice field with an added ``referenced_class`` required option that specifies -the class of the referenced target document. - -To use this form type, you also need to specify the list of possible reference targets as an array of PHPCR-ODM ids or -PHPCR paths. - -The minimal code required to use this type looks as follows: - -.. code-block:: php - - $dataArr = array( - '/some/phpcr/path/item_1' => 'first item', - '/some/phpcr/path/item_2' => 'second item', - ); - - $formMapper - ->with('form.group_general') - ->add('myCollection', 'phpcr_odm_reference_collection', array( - 'choices' => $dataArr, - 'referenced_class' => 'Class\Of\My\Referenced\Documents', - )) - ->end(); - -.. tip:: - - When building an admin interface with :doc:`Sonata Admin` - there is also the ``sonata_type_model`` that is more powerful, allowing to add - to the referenced documents on the fly. Unfortunately it is - `currently broken `_. - - -phpcr_reference -~~~~~~~~~~~~~~~ - -The ``phpcr_reference`` represents a PHPCR Property of type REFERENCE or WEAKREFERENCE within a form. -The input will be rendered as a text field containing either the PATH or the UUID as per the -configuration. The form will resolve the path or id back to a PHPCR node to set the reference. - -This type extends the ``text`` form type. It adds an option ``transformer_type`` that can be set -to either ``path`` or ``uuid``. - - -Fixture loading ---------------- - -To use the ``doctrine:phpcr:fixtures:load`` command, you additionally need to install the -`DoctrineFixturesBundle `_ which brings the -`Doctrine data-fixtures `_ into Symfony2. - -Fixtures work the same way they work for Doctrine ORM. You write fixture classes implementing -``Doctrine\Common\DataFixtures\FixtureInterface``. If you place them in \DataFixtures\PHPCR, -they will be auto detected if you specify no path to the fixture loading command. - -A simple example fixture class looks like this: - -.. code-block:: php - - `_. - -Migration loading ------------------ - -The DoctrinePHPCRBundle also ships with a simple command to run migration scripts. Migrations -should implement the ``Doctrine\Bundle\PHPCRBundle\Migrator\MigratorInterface`` and registered -as a service with a ``doctrine_phpcr.migrator`` tag contains an ``alias`` attribute uniquely -identifying the migrator. There is an optional ``Doctrine\Bundle\PHPCRBundle\Migrator\AbstractMigrator`` -class to use as a basis. To find out available migrations run: - -.. code-block:: bash - - $ php app/console doctrine:phpcr:migrator - -Then pass in the name of the migrator to run it, optionally passing in an ``--identifier``, -``--depth`` or ``--session`` argument. The later argument determines which session name to -set on the migrator, while the first two arguments will simply be passed to the ``migrate()`` -method. You can find an example migrator in the SimpleCmsBundle. - -Órdenes del *PHPCR* de *Doctrine* ---------------------------------- - -Todas las órdenes sobre el *PHPCR* van prefijadas con ``doctrine:phpcr`` y puedes utilizar el argumento ``--session`` para utilizar una sesión distinta a la predefinida si configuraste varias sesiones *PHPCR*. - -Algunas de estas órdenes son específicas a una interfaz de administración o al *ODM*. Esas órdenes -sólo estarán disponibles si tal interfaz de administración está configurada. - -Usa ``app/console help `` para ver todas las opciones que tiene cada orden. - -- ``doctrine:phpcr:workspace:create`` Create a workspace in the configured repository -- ``doctrine:phpcr:workspace:list`` List all available workspaces in the configured repository -- ``doctrine:phpcr:purge`` Remove a subtree or all content from the repository -- ``doctrine:phpcr:repository:init`` Register node types and create base paths -- ``doctrine:phpcr:register-node-types`` Register node types from a .cnd file in the PHPCR repository -- ``doctrine:phpcr:fixtures:load`` Load data fixtures to your PHPCR database. -- ``doctrine:phpcr:import`` Import xml data into the repository, either in JCR system view format or arbitrary xml -- ``doctrine:phpcr:export`` Export nodes from the repository, either to the JCR system view format or the document view format -- ``doctrine:phpcr:dump`` Output all or some content of the repository -- ``doctrine:phpcr:query`` Execute a JCR SQL2 statement -- ``doctrine:phpcr:mapping:info`` Shows basic information about all mapped documents - - -.. note:: - - To use the ``doctrine:phpcr:fixtures:load`` command, you additionally need to install the - `DoctrineFixturesBundle `_ - and its dependencies. Ve su página de documentación para aprender a utilizar los accesorios. - - -Órdenes específicas de ``Jackrabbit`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si estás utilizando ``jackalope-jackrabbit``, también tienes una orden para arrancar y detener el servidor ``jackrabbit``: - -- ``jackalope:run:jackrabbit`` Arranca y detiene el servidor ``Jackrabbit`` - - -Órdenes específicas para el *DBAL* de *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si estás utilizando ``jackalope-doctrine-dbal``, tienes una orden para iniciar la base -de datos: - -- ``jackalope:init:dbal`` Prepara la base de datos para el *DBAL* de *Doctrine* con ``Jackalope`` - -Ten en cuenta que también puedes utilizar la orden *dbal* de *doctrine* para crear la base de datos. - - -Algunas ordenes de ejemplo -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ejecutando `consultas SQL2 `_ contra el repositorio - -.. code-block:: bash - - app/console doctrine:phpcr:query "SELECT title FROM [nt:unstructured] WHERE NAME() = 'home'" - - -Vertiendo nodos bajo /cms/simple incluyendo sus propiedades - -.. code-block:: bash - - app/console doctrine:phpcr:dump /cms/simple --props - - diff --git a/_sources/cmf/bundles/routing-extra.txt b/_sources/cmf/bundles/routing-extra.txt deleted file mode 100644 index f03458a..0000000 --- a/_sources/cmf/bundles/routing-extra.txt +++ /dev/null @@ -1,323 +0,0 @@ -``RoutingExtraBundle`` -====================== - -El `RoutingExtraBundle `_ integra el enrutado dinámico a *Symfony* utilizando :doc:`../components/routing`. - -La ``ChainRouter`` pretende reemplazar el enrutador predefinido de *Symfony*. Todo lo que hace es recoger una lista priorizada de rutas e intenta emparejar peticiones y generar las *URL* con todas ellas. Naturalmente, una de las rutas en esa cadena puede ser la ruta predefinida para que todavía la puedas utilizar de la manera estándar en algunas de tus rutas. - -Además, este paquete entrega útiles implementaciones de enrutado. Actualmente, existe el ``DynamicRouter`` que enruta basándose en una lógica de cargador personalizada para los objetos ``Ruta`` de *Symfony2*. Puedes implementar el proveedor usando una base de datos, por ejemplo con el `PHPCR-ODM`_ de *Doctrine* o el *ORM* de *Doctrine*. Este paquete proporciona una implementación predefinida para el `PHPCR-ODM`_ de *Doctrine*. - -El servicio ``DynamicRouter`` sólo está disponible cuándo se habilita explícitamente en la configuración de la aplicación. - -Finalmente estos paquetes proporcionan documentos de ruta para el `PHPCR-ODM`_ de *Doctrine* y un controlador para redirigir rutas. - -.. index:: RoutingExtraBundle -.. index:: Routing - -Dependencias ------------- - -* `Routing del CMF de Symfony `_ - -``ChainRouter`` ---------------- - -La ``ChainRouter`` puede reemplazar el sistema de enrutado predefinido de *Symfony* con una implementación habilitada en cadena. Esta no enruta nada por sí misma, sino que únicamente recorre todos los enrutadores encadenados. Para manejar las rutas estándar configuradas en *Symfony*, el enrutador predefinido de *Symfony* se puede poner en la cadena. - -Configurando ------------- - -En tu archivo :file:`app/config/config.yml`, puedes especificar cual servicio de enrutado quieres usar. Si no especificas el ``routers_by_id`` asigna todos, de manera predefinida el enrutador encadenado simplemente cargará el enrutador construido en *Symfony*. Cuándo especificas la lista de ``routers_by_id``, necesitas tener una entrada para ``router.default`` si quieres el enrutador de *Symfony2* (aquel que lee las rutas desde :file:`app/config/routing.yml`). - -El formato es ``service_name: priority`` --- el número de prioridad más alto anterior es preguntado a este servicio enrutador para emparejar una ruta o para generar una *url*: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - chain: - routers_by_id: - # activa el DynamicRouter con alta prioridad para redefinir - # el enrutador configurado con contenido - symfony_cmf_routing_extra.dynamic_router: 200 - # activa el enrutador predefinido de symfony con - # baja prioridad - router.default: 100 - # cuando la cadena de enrutadores debe sustituir al enrutador predefinido. por omisión es true - # si lo pones en false, el enrutador sólo estará disponible como servicio - # symfony_cmf_routing_extra.router y debes hacer algo para lanzarlo - # replace_symfony_router: true - -Cargando enrutadores con etiquetado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Tus enrutadores se pueden registrar automáticamente, justo añadiéndolos como servicios etiquetados con `router` y una ``prioridad`` opcional. -Mientras más alta prioridad, más temprano será consultado tu enrutador para emparejar la ruta. Si no especificas la prioridad, tu enrutador vendrá al último. -Si hay varios enrutadores con la misma prioridad, el orden entre ellos es indeterminado. -El servicio etiquetado tendrá esta apariencia: - -.. configuration-block:: - - .. code-block:: yaml - - services: - my_namespace.my_router: - class: %my_namespace.my_router_class% - tags: - - { name: router, priority: 300 } - - .. code-block:: xml - - - - .. - - -Ve también la `documentación oficial de Symfony2 para las etiquetas de inyección de dependencias`_ - -Enrutador dinámico ------------------- - -Esta implementación de un ``enrutador`` utiliza ``NestedMatcher`` el cuál carga rutas de una ``RouteProviderInterface``. La interfaz del proveedor se puede implementar fácilmente con *Doctrine*. - -El ``enrutador`` trabaja con clases extendidas de ``UrlMatcher`` y ``UrlGenerator`` que añaden la carga de rutas desde la base de datos y el concepto de contenido referido. - -El servicio ``NestedMatcher`` está configurado con un proveedor de rutas. Ve cómo cambiar el ``route_repository_service`` en la sección de configuración y la siguiente sección para más detalles de la implementación predeterminada basada en `PHPCR-ODM`_. - -Quzás quieras configurar potenciadores de enrutado para decidir cual controlador usar para manejar la petición, para evitar la codificación directa de los nombres de controlador para enrutar tus documentos. - -La configuración mínima requerida para cargar el enrutador dinámico como un servicio ``symfony_cmf_routing_extra.dynamic_router`` es tenerlo como ``enabled: true`` en tu archivo :file:`config.yml` (El enrutador se activa automáticamente apenas añadas cualquier otra configuración a la entrada ``dynamic``). Sin habilitarlo, el servicio enrutador dinámico no será cargado en absoluto, dejándote utilizar la ``ChainRouter`` con tus propios enrutadores: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - enabled: true - -Integrando *PHPCR-ODM* -~~~~~~~~~~~~~~~~~~~~~~ - -Este paquete viene con una implementación de enrutador con repositorio para `PHPCR-ODM`_. -*PHPCR* es apropiado para la naturaleza del árbol de datos. Si usas `PHPCR-ODM`_ con un documento de ruta como el proporcionado, justo puedes dejar el servicio repositorio como el predefinido. - -El repositorio predefinido carga la ruta desde la ruta en la petición y todas las rutas padre para permitir que algunos de los segmentos de la ruta sigan siendo parámetros. Si necesitas una diferente manera de cargar rutas o, por ejemplo, nunca usar parámetros, puedes escribir tu propia implementación del repositorio para optimizarla (ve en el archivo :file:`cmf_routing.xml` cómo configurar el servicio). - -.. index:: PHPCR, ODM - -Proceso de concordancia -~~~~~~~~~~~~~~~~~~~~~~~ - -La mayoría del proceso de concordancia está descrito en la documentación del `componente enrutador del CMF`_. -La única diferencia es que el paquete colocará el ``contentDocument`` en los atributos de la petición en vez de en la ruta predefinida. - -Tus controladores pueden (y tienen que) declarar el parámetro ``$contentDocument`` en tus métodos ``Action`` si se supone que trabajen con el contenido referido por las rutas. -Ve ``Symfony\Cmf\Bundle\ContentBundle\Controller\ContentController`` para un ejemplo. - -.. _bundle-routing-route-enhancer: - -Configurando -~~~~~~~~~~~~ - -Para configurar qué controlador se utiliza para cuál contenido, puedes especificar potenciadores de ruta. La presencia de cualquiera de los potenciadores en la configuración hace que el contenedor de dependencias inyecte al ``DynamicRouter`` el potenciador respectivo. - -Los posibles potenciadores son (en orden de precedencia): - -* (Controlador explícito): Si existe un ``_controller`` en ``getRouteDefaults()``, ningún potenciador lo sustituye. -* Plantilla explícita: Requiere que el documento de ruta regrese un parámetro ``'_template'`` en ``getRouteDefaults``. El controlador genérico configurado está puesto por el potenciador. -* Controlador por alias: Requiere que el documento de ruta regrese un valor ``'type'`` en ``getRouteDefaults()`` -* Controlador por clase: Requiere que el documento de ruta regrese un objeto para ``getRouteContent()``. The content document is checked for being ``instanceof`` the - class names in the map and if matched that controller is used. - Se utiliza ``instanceof`` en vez de compararlo directamente para trabajar con clases delegadas y extender otras clases. -* Plantilla por clase: Requiere que el documento de ruta regrese un objeto para ``getRouteContent()``. The content document is checked for being ``instanceof`` the - class names in the map and if matched that template will be set as - '_template' in the $defaults and the generic controller used as controller. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - generic_controller: symfony_cmf_content.controller:indexAction - controllers_by_type: - editablestatic: sandbox_main.controller:indexAction - controllers_by_class: - Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: symfony_cmf_content.controller:indexAction - templates_by_class: - Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: SymfonyCmfContentBundle:StaticContent:index.html.twig - - # el proveedor de ruta es responsable de cargar rutas. - manager_registry: doctrine_phpcr - manager_name: default - - # Si usas la ruta predefinida del servicio repositorio de - # Doctrine, puedes usar esto para personalizar la ruta raíz - # para el RouteProvider de PHPCR-ODM. Esta ruta base - # es inyectada por el escucha\IdPrefix - pero sólo para - # las rutas que coincidan con el prefijo, para permitir - # más de una ruta fuente. - routing_repositoryroot: /cms/routes - - # Si deseas reemplazar el proveedor de ruta predefinido - # o tu repositorio de contenido puedes especificar sus - # identificadores de servicio aquí. - route_provider_service_id: my_bundle.provider.endpoint - content_repository_service_id: my_bundle.repository.endpoint - - # Un proveedor orm podría necesitar diferente configuración. - # Ve un ejemplo en cmf_routing.xml si necesitas definir - # tu propio servicio - - -Para ver algunos ejemplos, por favor ve en el `recinto de seguridad del CMF`_, específicamente la carga de accesorios de enrutado. - -.. tip:: - - You can also define your own RouteEnhancer classes for specific use cases. - See :ref:`bundle-routing-customize`. - -.. _bundle-routing-document: - -Usando el documento de ruta *PHPCR-ODM* ---------------------------------------- - -Todas las clases de ruta deben extender la clase ``Route`` del núcleo de *Symfony*. Los documentos tampoco se pueden crear por código (por ejemplo un guión de accesorios) o con una interfaz *web* como la proporcionada para la administración *PHPCR-ODM* de Sonata (ve abajo). - -*PHPCR-ODM* asocia todas las características de la ruta del núcleo al almacenamiento, así que puedes utilizar normalmente los métodos ``setDefault``, ``setRequirement``, ``setOption`` y ``setHostnamePattern``. -Además cuándo creas una ruta, puedes definir si ``.{_format}`` se debería anexar al patrón y configurar con requisitos el ``_format`` requerido. -La otra opción del constructor te permite controlar si la ruta debería anexar una barra inclinada final porque esto no se puede expresar con un nombre *PHPCR*. El predefinido es que no tenga ninguna barra inclinada final. - -Todas las rutas están localizadas bajo una ruta configurada como la raíz, por ejemplo ``'/cms/rutas'``. -Puedes crear una nueva ruta en código *PHP* de la siguiente manera: - -.. code-block:: php - - use Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route; - $route = new Route; - $route->setParent($dm->find(null, '/routes')); - $route->setName('projects'); - // establece el controlador explícitamente (ambas sintaxis trabajan - // servicio y Paquete:Nombre:acción) - $route->setDefault('_controller', 'sandbox_main.controller:specialAction'); - -Sin embargo, el ejemplo anterior probablemente se debería haber hecho como una ruta configurada en un archivo ``xml/yml`` de *Symfony*, a no ser que se suponga que el usuario final cambie la *URL* o el controlador. - -Para enlazar un contenido a esta ruta, sencillamente pon lo siguiente en el documento. - -.. code-block:: php - - $content = new Content('my content'); // el contenido se debe asociar a una clase - $route->setRouteContent($content); - -Esto pondrá el documento en los parámetros de la petición y si tu controlador especifica un parámetro llamado ``$contentDocument``, le será pasado este documento. - -También puedes utilizar patrones variables para la *URL* y definir requisitos y predeterminados. - -.. code-block:: php - - // No olvides la barra inclinada inicial si quieres /proyectos/{id} y no /proyectos{id} - $route->setVariablePattern('/{id}'); - $route->setRequirement('id', '\d+'); - $route->setDefault('id', 1); - -Esto te dará una ruta que empareja con la *URL* ``/proyectos/`` pero también con ``/proyectos`` ya que es el predefinido para el parámetro ``id``. Esta emparejará con ``/proyectos/7`` así como con ``/proyectos`` pero no con ``/proyectos/x-4``. -El documento todavía será almacenado en ``/rutas/proyectos``. Esto trabajará porque, como se mencionó anteriormente, el proveedor de ruta buscará documentos de ruta en todas las rutas posibles y elegirá la primera que coincida. En este ejemplo, si hay un documento de ruta en ``/rutas/proyectos/7`` que coincida (sin más parámetros) será seleccionado. De lo contrario comprobará si ``/rutas/proyectos`` tiene un patrón que coincida. Si no, el documento superior en ``/rutas`` será comprobado. - -Naturalmente también puedes tener varios parámetros, como es normal en las rutas de *Symfony*. La semántica y reglas para patrones, predefinidos y requisitos son exactamente iguales que en las rutas del núcleo. - -Tu controlador puede esperar el parámetro ``$id`` así como el ``$contentDocument`` tal como se -puso un contenido en la ruta. El contenido se podría usar para definir una sección de introducción que sea igual en cada proyecto u otro dato compartido. Si no necesitas contenido, puedes simplemente no ponerlo en el documento. - - -Configurando la administración de ``Sonata`` --------------------------------------------- - -Si añades ``sonata-project/doctrine-phpcr-admin-bundle`` en la sección ``require`` de tu archivo :file:`composer.json` y el ``SonataDoctrinePhpcrAdminBundle`` es cargado en el núcleo de la aplicación, los documentos de ruta son expuestos en el ``SonataDoctrinePhpcrAdminBundle``. -Para instrucciones sobre cómo configurar este paquete ve :doc:`doctrine_phpcr_admin`. - -De manera predefinida, ``use_sonata_admin`` se configura automáticamente basándose en si ``SonataDoctrinePhpcrAdminBundle`` está disponible, pero lo puedes deshabilitar explícitamente no poniéndolo incluso si ``sonata`` está habilitado, o lo puedes habilitar explícitamente para obtener un error si ``sonata`` queda inutilizable. - -Si quieres utilizar el ``admin``, debes configurar la opción ``content_basepath`` para que apunte a la raíz de tus documentos de contenido. - - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - use_sonata_admin: auto # usa true/false para forzar el uso / no uso de - # la administración de sonata - content_basepath: ~ # usado con la administración de sonata para - # manejar el contenido, por omisión a - # symfony_cmf_core.content_basepath - - -El tipo ``form`` ----------------- - -El paquete define un tipo ``form`` que puedes utilizar para la clásica casilla de verificación «aceptar términos» donde colocas las *url* en la etiqueta. Simplemente especifica ``symfony_cmf_routing_extra_terms_form_type`` como el nombre del tipo ``form`` y especifica una etiqueta y un arreglo con ``content_ids`` en las opciones - -.. code-block:: php - - $form->add('terms', - 'symfony_cmf_routing_extra_terms_form_type', - array('label' => 'I have seen the Team and More pages ...', - 'content_ids' => array('%team%' => '/cms/content/static/team', - '%more%' => '/cms/content/static/more') - )); - -El tipo ``form`` automáticamente genera las rutas para el contenido especificado y pasa las rutas al ayudante ``trans`` de *Twig* para sustituirlas en la etiqueta. - -Notas adicionales ------------------ - -Ve la documentación del `componente enrutador del CMF`_ para información sobre la ``RouteObjectInterface``, redirecciones y regiones. - -Notas: - -* RouteObjectInterface: Los documentos proporcionados implementan esta interfaz para asociar contenido a rutas y (opcionalmente) proporcionan un nombre de ruta personalizado en vez del nombre de ruta compatible con el núcleo de *Symfony*. -* Redirecciones: This bundle provides a controller to handle redirections. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - controllers_by_class: - Symfony\Cmf\Component\Routing\RedirectRouteInterface: symfony_cmf_routing_extra.redirect_controller:redirectAction - -.. _bundle-routing-customize: - -Personalizando --------------- - -Puedes añadir más implementaciones de la ``RouteEnhancerInterface`` si tienes un caso no manejado por el proporcionado. Sencillamente define servicios para tus potenciadores y eiquétalos con ``dynamic_router_route_enhancer`` para añadirlos al enrutado. - -Si usas un *ODM/ORM* diferente a `PHPCR-ODM`_, probablemente necesites especificar la clase para la entidad ruta (en `PHPCR-ODM`_, la clase es detectada automáticamente). Para necesidades más específicas, dale una mirada al ``DynamicRouter`` y ve si lo quieres extender. También puedes escribir tus propios enrutadores para engancharlos a la cadena. - -.. _`documentación oficial de Symfony2 para las etiquetas de inyección de dependencias`: http://gitnacho.github.com/symfony-docs-es/reference/dic_tags.html -.. _`recinto de seguridad del CMF`: https://github.com/symfony-cmf/cmf-sandbox -.. _`componente enrutador del CMF`: https://github.com/symfony-cmf/Routing -.. _`PHPCR-ODM`: https://github.com/doctrine/phpcr-odm - -Aprende más en el recetario ---------------------------- - -* :doc:`../cookbook/using-a-custom-route-repository` - -Notas adicionales ------------------ - -Para más información sobre el componente ``Routing`` del ``CMF`` de *Symfony*, por favor, consulta: - -- :doc:`../getting-started/routing` para una guía introductoria al paquete ``Routing`` -- :doc:`../components/routing` para la mayoría de la funcionalidad implementada actualmente -- La página del componente `Routing `_ de *Symfony2*. diff --git a/_sources/cmf/bundles/routing_auto.txt b/_sources/cmf/bundles/routing_auto.txt deleted file mode 100644 index ef61d61..0000000 --- a/_sources/cmf/bundles/routing_auto.txt +++ /dev/null @@ -1,500 +0,0 @@ -RoutingAutoBundle -================= - -The ``RoutingAutoBundle`` allows you to define automatically created routes -for documents. This implies a separation of the ``Route`` and ``Content`` -documents. If your needs are simple this bundle may not be for you and you -should have a look at :doc:`SimpleCmsBundle`. - -For the sake of example, we will imagine a blog application -that has two routeable contents, the blog itself, and the posts for the blog. -We will call these documents ``Blog`` and ``Post``, and we will class them as -*content documents*. - -.. note:: - - In our example we add an auto route for the blog, but in reality, as a blog - is something you create rarely, you will probably want to create routes for - your blog manually, but its up to you. - -If we create a new ``Blog`` with the title "My New Blog" the bundle could automatically -create the route ``/blogs/my-new-blog``. For each new ``Post`` it could create a route -such as ``/blogs/my-new-blog/my-posts-title``. This URL resolves to a special type of -route that we will call the *auto route*. - -By default, when we update a content document that has an auto route the -corresponding auto route will also be updated, when deleting a content document -the corresponding auto route will also be deleted. - -If required, the bundle can also be configured to do extra stuff, like, for example, -leaving a ``RedirectRoute`` when the location of a content document changes or -automatically displaying an index page when an unconfigured intermediate path is -accessed (for example, listing all the children under ``/blogs`` instead of returning -a ``404``). - -Why not simply use a single route? ----------------------------------- - -Of course, our fictional blog application could use a single route with a pattern -``/blogs/my-new-blog/{slug}`` which could be handled by a controller. Why not just -do this? - -1. By having a route for each page in the system the application has a knowledge of - which URLs are accessible, this can be very useful, for example, when specifying - endpoints for menu items are generating a site map. - -2. By separating the route from the content we allow the route to be customized independently - of the content, for example, a blog post may have the same title as another post but might - need a different URL. - -3. Separate route documents are translateable - this means we can have a URL for - *each language*, "/welcome" and "/bienvenue" would each reference - the same document in English and French respectively. This would be difficult if - the slug were embedded in the content document. - -4. By decoupling route and content the application doesn't care *what* is referenced in - the route document. This means that we can easily replace the class of document referenced. - -Anatomy of an automatic URL ---------------------------- - -The diagram below shows a fictional URL for a blog post. The first 6 elements -of the URL are what we will call the *content path*. The last element we will call -the *content name*. - -.. image:: ../_images/bundles/routing_auto_post_schema.png - -The content path is further broken down into *route stacks* and *routes*. A route -stack is a group of routes and routes are simply documents in the PHPCR tree. - -.. note:: - - Although routes in this case can be of any document class, only objects which - extend the :class:`Symfony\\Component\\Routing\\Route` object will be considered when matching a URL. - - The default behavior is to use Generic documents when generating a content path, and - these documents will result in a 404 when accessed directly. - -Internally each route stack is built up by a *builder unit*. Builder units contain -one *path provider* class and two actions classes one action to take if the provided -path exists in the PHPCR tree, the other if it does not. The goal -of each builder unit is to generate a path and then provide a route object for each -element in that path. - -The configuration for the example above could be as follows: - -.. code-block:: yaml - - symfony_cmf_routing_auto: - - auto_route_mapping: - My\Namespace\Bundle\BlogBundle\Document\Post: - content_path: - # corresponds first route stack in diagram: my, blog, my-blog - blog_path: - provider: - name: content_object - method: getBlog - exists_action: - strategy: use - not_exists_action: - strategy: throw_exception - - # corresponds to second route stack: 2013,04,06 - date: - provider: - name: content_datetime - method: getPublishedDate - exists_action: - strategy: use - not_exists_action: - strategy: create - - # corresponds to the content name: My Post Title - content_name: - provider: - name: content_method - method: getTitle - exists_action: - strategy: auto_increment - pattern: -%d - not_exists_action: - strategy: create - - -The ``Post`` document would then need to implement the methods named above as follows:: - - blog; - } - - public function getPublishedDate() - { - return new \DateTime('2013/04/06'); - } - - public function getTitle() - { - return "My post title"; - } - } - -Path Providers --------------- - -Path providers specify a target path which is used by the subsequent path actions to provide -the actual route documents. - -**Base** providers must be the first configured as the first builder in the content path chain. -This is because the paths that they provide correspond directly to an existing path, i.e. they -have an absolute reference. - -specified (base provider) -~~~~~~~~~~~~~~~~~~~~~~~~~ - -This is the most basic path provider and allows you to specify an exact (fixed) path. - -.. code-block:: yaml - - path_provider: - name: specified - path: this/is/a/path - -Options: - - - ``path`` - **required** The path to provide. - -.. note:: - - We never specifiy absolute paths in the auto route system. If the builder unit - is the first content path chain it is understood that it is the base of an absolute - path. - -content_object (base provider) -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -The content object provider will try and provide a path from an object implementing -``RouteAwareInterface`` provided by a designated method on the content document. For -example, if you have a ``Post`` class, which has a ``getBlog`` method, using -this provider you can tell the ``Post`` auto route to use the route of the blog as a -base. - -So basically, if your blog content has a path of ``/this/is/my/blog`` you can use this -path as the base of your ``Post`` auto-route. - -Ejemplo: - -.. code-block:: yaml - - provider: - name: content_object - method: getBlog - -.. note:: - - At the time of writing translated objects are not supported. This isn't hard to do, but well, I just - havn't done it yet. - -Options: - - - ``method``: **required** Method used to return the document whose route path we wish to use. - -content_method -~~~~~~~~~~~~~~ - -The ``content_method`` provider allows the content object (e.g. a blog ``Post``) to specify -a path using one of its methods. This is quite a powerful method as it allows the content -document to do whatever it can to produce the route, the disadvantage is that your content -document will have extra code in it. - -Example 1: - -.. code-block:: yaml - - path_provider: - name: content_method - method: getTitle - -This example will use the existing method "getTitle" of the ``Post`` document to retrieve the -title. By default all strings are *slugified*. - -The method can return the path either as a single string or an array of path elements -as shown in the following example:: - - format()` method. This means that you can specify your date in anyway you like and it will be - automatically slugified, also, by adding path separators in the `date_format` you are effectively creating - routes for each date component as slugify applies to **each element** of the path. - -Options: - - - ``method``: **required** Method used to return the route name / path / path elements. - - ``slugify``: If we should use the slugifier, default is ``true``. - - ``date_format``: Any date format accepted by the `DateTime` class, default ``Y-m-d``. - -Path Exists Actions -------------------- - -These are the default actions available to take if the path provided by a `path_provider` already exists and -so creating a new path would create a conflict. - -auto_increment -~~~~~~~~~~~~~~ - -The ``auto_increment`` action will add a numerical suffix to the path, for example ``my/path`` would first become -``my/path-1`` and if that path *also* exists it will try ``my/path-2``, ``my/path-3`` and so on into infinity until -it finds a path which *doesn't* exist. - -This action should typically be used in the ``content_name`` builder unit to resolve conflicts. Using it in the -``content_path`` builder chain would not make much sense (I can't imagine any use cases at the moment). - -Ejemplo: - -.. code-block:: yaml - - exists_action: - name: auto_increment - -Options: - - - None. - -use -~~~ - -The ``use`` action will simply take the existing path and use it. For example, in our post example the first -builder unit must first determine the blogs path, ``/my/blog``, if this path exists (and it should) then we -will *use* it in the stack. - -This action should typically be used in one of the content path builder units to specify that we should use -the existing route, on the other hand, using this as the content name builder action should cause the old -route to be overwritten. - -Ejemplo: - -.. code-block:: yaml - - exists_action: - name: use - -Options: - - - None. - -Path not exists actions ------------------------ - -These are the default actions available to take if the path provided by a ``path_provider`` does not exist. - -create -~~~~~~ - -The ``create`` action will create the path. **currently** all routes provided by the content path build units -will be created as ``Generic`` documents, whilst the content name route will be created as an ``AutoRoute`` document. - -.. code-block:: yaml - - not_exists_action: - name: create - -Options: - - - None. - -throw_exception -~~~~~~~~~~~~~~~ - -This action will throw an exception if the route provided by the path provider does not exist. You should take -this action if you are sure that the route *should* exist. - -.. code-block:: yaml - - not_exists_action: - name: create - -Options: - - - None. - -Personalizando --------------- - -.. _routingauto_customization_pathproviders: - -Adding Path Providers -~~~~~~~~~~~~~~~~~~~~~ - -The goal of a ``PathProvider`` class is to add one or several path elements to -the route stack. For example, the following provider will add the path "foo/bar" -to the route stack:: - - addPathElements(array('foo', 'bar')); - } - } - -To use the path provider you must register it in the **DIC** and add the -``symfony_cmf_routing_auto.provider`` tag and set the **alias** accordingly. - -.. configuration-block:: - - .. code-block:: xml - - - - - - .. code-block:: yaml - - my_cms.some_bundle.path_provider.foobar: - class: "FoobarProvider" - scope: prototype - tags: - - { name: symfony_cmf_routing_auto.provider, alias: "foobar"} - - .. code-block:: php - - $definition = new Definition('FooBarProvider'); - $definition->addTag('symfony_cmf_routing_auto.provider', array('alias' => 'foobar')); - $definition->setScope('prototype'); - $container->setDefinition('my_cms.some_bundle.path_provider.foobar', $definition); - -The **foobar** path provider is now available as **foobar**. - -.. note:: - - The that both path providers and path actions need to be defined with a - scope of "prototype". This ensures that each time the auto routing system - requests the class a new one is given and we do not have any state problems. - -Adding Path Actions -~~~~~~~~~~~~~~~~~~~ - -In the auto routing system, a "path action" is an action to take if the path provided -by the "path provider" exists or not. - -You can add a path action by extending the ``PathActionInterface`` and registering your -new class correctly in the DI configuration. - -This is a very simple implementation from the bundle - it is used to throw an exception -when a path already exists:: - - getFullPath()); - } - } - -It is registered in the DI configuration as follows: - -.. configuration-block:: - - .. code-block:: xml - - - - - - .. code-block:: yaml - - symfony_cmf_routing_auto.not_exists_action.throw_exception - class: "My\Cms\AutoRoute\PathNotExists\ThrowException" - scope: prototype - tags: - - { name: symfony_cmf_routing_auto.provider, alias: "throw_exception"} - - .. code-block:: php - - $definition = new Definition('My\Cms\AutoRoute\PathNotExists\ThrowException'); - $definition->addTag('symfony_cmf_routing_auto.provider', array('alias' => 'throw_exception')); - $definition->setScope('prototype'); - $container->setDefinition('my_cms.some_bundle.path_provider.throw_exception', $definition); - -Note the following: - -* **Scope**: Must *always* be set to *prototype*; -* **Tag**: The tag registers the service with the auto routing system, it can be one of the following; - * ``symfony_cmf_routing_auto.exists.action`` - if the action is to be used when a path exists; - * ``symfony_cmf_routing_auto.not_exists.action`` - if the action is to be used when a path does not exist; -* **Alias**: The alias of the tag is the name by which you will reference this action in the auto routing schema. diff --git a/_sources/cmf/bundles/search.txt b/_sources/cmf/bundles/search.txt deleted file mode 100644 index 35bac3b..0000000 --- a/_sources/cmf/bundles/search.txt +++ /dev/null @@ -1,30 +0,0 @@ -``SearchBundle`` -================ - -El `SearchBundle `_ proporciona integración con `LiipSearchBundle `_ para proporcionar búsqueda en un sitio completo. - -.. index:: SearchBundle - -Dependencias ------------- - -* `LiipSearchBundle `_ - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_search`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_search: - document_manager_name: default - translation_strategy: child # además se puede configurar como una cadena vacía o atributo - translation_strategy: attribute - search_path: /cms/content - search_fields: - title: title - summary: body \ No newline at end of file diff --git a/_sources/cmf/bundles/simple-cms.txt b/_sources/cmf/bundles/simple-cms.txt deleted file mode 100644 index 267a669..0000000 --- a/_sources/cmf/bundles/simple-cms.txt +++ /dev/null @@ -1,165 +0,0 @@ -``SimpleCmsBundle`` -=================== - -El `SimpleCmsBundle `_ proporciona un *CMS* simplista sobre los componentes y paquetes del ``CMF``. - -Si bien los componentes del núcleo del *CMF* se enfocan en la flexibilidad, el simple *CMS* especula con alguna de esa flexibilidad a favor de la simplicidad. - -El ``SimpleCmsBundle`` proporciona una solución para fácilmente asignar contenido, rutas y elementos del menú basando el repositorio de contenido en una única estructura de árbol. - -Para una sencilla instalación de ejemplo del paquete revisa la `Edición estándar del CMF de Symfony `_ - -Puedes encontrar una introducción al paquete en la sección `Primeros pasos <../getting-started/simplecms>`_. - -El `sitio web de CMF `_ es -otra aplicación que utiliza el ``SimpleCmsBundle``. - -.. index:: SimpleCmsBundle, i18n - -Dependencias ------------- - -Tal como se especifica en el archivo :file:`composer.json` este paquete depende de muchos de los paquetes del *CMF*. - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_simple_cms``. - -La opción ``use_menu`` automáticamente habilita un servicio para proporcionar los menús del simple *CMS* si ``MenuBundle`` está habilitado. También lo puedes desactivar explícitamente si tienes el paquete ``menu`` pero no quieres utilizar el servicio predefinido, o habilitarlo explícitamente para conseguir un error si el paquete ``menu`` se vuelve inasequible. - -La sección de enrutado define cual plantilla o controlador utilizar para una clase de contenido. This is reusing what routing extra does, please see the corresponding -:ref:`routing configuration section `. También explica el ``generic_controller``. - -Ve la sección para soporte multilingüe más adelante. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - use_menu: auto # usa true/false para forzar provisión / no provisión de un menú - use_sonata_admin: auto # use true/false to force using / not using sonata admin - sonata_admin: - sort: false # set to asc|desc to sort children by publication date - document_class: Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page - # controlador a usar para dibujar documentos - # únicamente con plantilla personalizada - generic_controller: symfony_cmf_content.controller:indexAction - # dónde almacenar las páginas en el árbol PHPCR - basepath: /cms/simple - routing: - content_repository_id: symfony_cmf_routing_extra.content_repository - controllers_by_class: - # ... - templates_by_class: - # ... - multilang: - locales: [] - -.. tip:: - - Si tienes habilitada la administración *PHPCR-ODM* de ``Sonata`` pero *NO* quieres mostrar la administración predefinida proporcionada por este paquete, puedes añadir lo siguiente a tu configuración: - - .. configuration-block:: - - .. code-block:: yaml - - symfony_cmf_simple_cms: - use_sonata_admin: false - -Soporte multilingüe -------------------- - -El modo ``multi-language-mode`` se habilita proporcionando la lista de regiones permitidas en el campo ``multilang > locales``. - -En ``multi-language-mode`` el paquete automáticamente utilizará ``Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangPage`` como la ``document_class`` a no ser que explícitamente esté configurada una clase diferente. - -Esta clase de manera predeterminada prefijará todas las rutas con ``/{_locale}``. Este comportamiento se puede desactivar poniendo a ``false`` el segundo parámetro en el constructor del modelo. - -Además, la capa de enrutado será configurada para utilizar ``Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangRouteRepository`` la cuál garantizará que incluso con el prefijo ``locale`` el nodo de contenido correcto será encontrado. Además, automáticamente añade un ``_locale`` el requisito enumerando las regiones actualmente disponibles para la ruta emparejada. - -.. note:: - - Debido a que ``SimpleCmsBundle`` sólo proporciona una sencilla estructura de árbol, todos los nodos tendrán el mismo nombre de nodo para todos los idiomas. Así que una *url* ``http://foo.com/en/bar`` para contenido en inglés se vería cómo ``http://foo.com/de/bar`` para contenido en alemán. A veces puede ser más factible utilizar enteros como nombres de nodo y sencillamente anexarlos al título del nodo en la región dada como una ancla. Así por ejemplo ``http://foo.com/de/1#my title`` y ``http://foo.com/de/1#mein title``. - Si necesitas las *URL* específicas al idioma, quieres usar el enrutado del paquete *CMF* y el paquete de contenido directamente para tener un documento de ruta separado por idioma. - - -Reproduciendo -------------- - -Puedes especificar la plantilla para reproducir una página del ``SimpleCms``, o utilizar un controlador donde luego proporciones el documento de página a la plantilla. Un sencillo ejemplo para tal plantilla es este: - - -.. code-block:: jinja - - {% block content %} - -

    {{ page.title }}

    - -
    {{ page.body|raw }}
    - -
      - {% foreach tag in page.tags %} -
    • {{ tag }}
      • - {% endforeach %} -
    - - {% endblock %} - - -Si tienes habilitado el ``CreateBundle``, también puedes producir el documento con anotaciones *RDF*, permitiéndote editar el contenido así como las etiquetas en la interfaz de usuario. La forma más sencilla es el siguiente bloque de *Twig*: - -.. code-block:: jinja - - {% block content %} - - {% createphp page as="rdf" %} - {{ rdf|raw }} - {% endcreatephp %} - - {% endblock %} - -Si quieres un control más detallado se tendría que mostrar con *RDF*, ve el capítulo :doc:`create`. - -Extendiendo la clase ``Page`` ------------------------------ - -El documento ``Page`` predefinido ``Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page`` es relativamente sencillo, viene con un puñado de las propiedades más comunes para construir una página típica: título, cuerpo, etiquetas, fechas de publicación, etc. - -Si esto no es suficiente para tu proyecto fácilmente puedes proporcionar tu propio documento extendiendo el documento ``Page`` predefinido y colocando los parámetros de configuración explícitamente a tu propia clase ``documento``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - ... - document_class: Acme\DemoBundle\Document\MySuperPage - ... - - -Alternativamente, el documento ``Page`` predefinido contiene una propiedad «extras». Esta almacena una clave --- valor (dónde el valor tiene que ser una cadena o ``null``) el cuál puedes usar para pequeñas adiciones triviales, sin tener que extender el documento ``Page`` predefinido. - -Por ejemplo: - -.. code-block:: php - - $page = new Page(); - - $page->setTitle('Hello World!'); - $page->setBody('Really interesting stuff...'); - - // set extras - $extras = array( - 'subtext' => 'Add CMS functionality to applications built with the Symfony2 PHP framework.', - 'headline-icon' => 'exclamation.png', - ); - - $page->setExtras($extras); - - $documentManager->persist($page); - -Luego, puedes acceder a estas propiedades en tu controlador o plantillas a través de los método ``getExtras()`` o ``getExtra($key)``. diff --git a/_sources/cmf/bundles/tree-browser.txt b/_sources/cmf/bundles/tree-browser.txt deleted file mode 100644 index da999aa..0000000 --- a/_sources/cmf/bundles/tree-browser.txt +++ /dev/null @@ -1,219 +0,0 @@ -``TreeBrowserBundle`` -===================== - -El `TreeBrowserBundle `_ proporciona un árbol de navegación en lo alto de un repositorio *PHPCR*. - -Este paquete consta de dos partes: - - * Árbol de navegación genérico con una ``TreeInterface`` - * Implementación del árbol *PHPCR* e *IGU* para un navegador *PHPCR* - -.. index:: TreeBrowserBundle - -Dependencias ------------- - -* `FOSJsRoutingBundle `_ -* Instala *jQuery*. `SonatajQueryBundle `_ fuertemente recomendado. - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_tree_browser`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_tree_browser: - session: default - -Enrutado --------- - -El paquete creará las rutas para cada implementación del árbol encontrado. In order to make -those routes available you need to include the following in your routing configuration: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - symfony_cmf_tree: - resource: . - type: 'symfony_cmf_tree' - -Usando ------- - -Tienes :file:`select.js` e :file:`init.js` los cuáles son una envoltura para construir un árbol *jQuery*. Úsalos con ``SelectTree.initTree`` ``resp.`` ``AdminTree.initTree`` - - * ``SelectTree`` en :file:`select.js` es un árbol para seleccionar un nodo para poner el ``id`` a un campo - * ``AdminTree`` en :file:`init.js` es para crear un árbol, mover y editar nodos - -Ambos tienen las siguientes opciones al crearlos: - - * config.selector: selector *jQuery* dónde enganchar en el árbol *js* - * config.rootNode: id para el nodo raíz de tu árbol, predefinido a «/» - * config.selected: id del nodo seleccionado - * config.ajax.children_url: *URL* al controlador que proporciona los hijos de un nodo - * config.routing_defaults: array for route parameters (such as _locale etc.) - * config.path.expanded: ruta de árbol donde el árbol se tendría que expandir al momento - * config.path.preloaded: árbol de rutas en el cual se debería precargar el nodo para acelerar la experiencia del usuario - -Solo :file:`select.js` -~~~~~~~~~~~~~~~~~~~~~~ - - * config.output: Dónde escribir el ``id`` del nodo seleccionado - -Solo :file:`init.js` -~~~~~~~~~~~~~~~~~~~~ - - * config.labels: arreglo conteniendo la traducción para las etiquetas del contexto menú (claves ``'createItem'`` y ``'deleteItem'``) - * config.ajax.move_url: *URL* al controlador para mover un hijo (es decir, asignarle un nuevo nodo padre) - * config.ajax.reorder_url: *URL* al controlador para reorganizar hermanos - * config.types: arreglo indexado con los tipos de nodo conteniendo información sobre ``valid_children``, iconos y rutas disponibles, utilizados para crear el contexto del menú y para comprobación durante las operaciones de movimiento. - -Ejemplos --------- - -Ve en las plantillas del paquete de administración de ``Sonata`` los ejemplos sobre cómo construir el árbol: - -* `init.js `_ -* `select.js `_ (busca ``doctrine_phpcr_type_tree_model_widget``) - -En el mismo paquete el `PhpcrOdmTree `_ implementa la interfaz de árbol y da un ejemplo sobre cómo implementar los métodos. - -Aquí tienes algunos consejos comunes sobre la utilización del ``TreeBrowser``: - -Define tree elements -~~~~~~~~~~~~~~~~~~~~ -The first step, is to define all the elements allowed in the tree and their children. -Have a look at the `cmf-sandbox configuration `_, the section document_tree in sonata_doctrine_phpcr_admin. - -This configuration is set for all your application trees regardless their type (admin or select). - -.. configuration-block:: - - .. code-block:: yaml - - sonata_doctrine_phpcr_admin: - document_tree_defaults: [locale] - document_tree: - Doctrine\ODM\PHPCR\Document\Generic: - valid_children: - - all - Symfony\Cmf\Bundle\ContentBundle\Document\MultilangStaticContent: - valid_children: - - Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock - - Symfony\Cmf\Bundle\BlockBundle\Document\ContainerBlock - - Symfony\Cmf\Bundle\BlockBundle\Document\ReferenceBlock - - Symfony\Cmf\Bundle\BlockBundle\Document\ActionBlock - Symfony\Cmf\Bundle\BlockBundle\Document\ReferenceBlock: - valid_children: [] - ... - - -How to add an admin tree to your page -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -This can be done either in an action template or in a custom block. - -You have to specify the tree root and the selected item, this allows you to have different type of content in your tree. - -In this example, we will have the menu elements. - -For Symfony 2.2 and later - -.. configuration-block:: - - .. code-block:: jinja - - {% render(controller('sonata.admin.doctrine_phpcr.tree_controller:treeAction')) with { 'root': websiteId~"/menu", 'selected': menuNodeId, '_locale': app.request.locale } %} - - -For Symfony 2.1 - -.. configuration-block:: - - .. code-block:: jinja - - {% render 'sonata.admin.doctrine_phpcr.tree_controller:treeAction' with { 'root': websiteId~"/menu", 'selected': menuNodeId, '_locale': app.request.locale } %} - - -How to customize the tree behaviour -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The TreeBrowserBundle is based on `jsTree `_. jsTree works with events, dispatched everytime the user does an action. - -A simple way to customize the tree behavior is to bind your actions to those events. - -If you have a look at init.js and select.js, you will notice that actions are already bound to some of the tree events. If the default behavior is not -what you need, JQuery provide the unbind function to solve the problem. - -Here is a simple way to remove the context menu from the admin tree (add the -``controller`` call around the controller name inside ``render`` for Symfony 2.2) : - -.. configuration-block:: - - .. code-block:: jinja - - {% render 'sonata.admin.doctrine_phpcr.tree_controller:treeAction' with { 'root': websiteId~"/menu", 'selected': menuNodeId, '_locale': app.request.locale } %} - - - -By default, the item selection open the edit route of the admin class of the element. This action is bind to the "select_node.jstree". - -If you want to remove it, you just need to call the unbind function on this event : - -.. configuration-block:: - - .. code-block:: jinja - - - -Then you can bind it on another action. - -For example, if your want to open a custom action : - -.. configuration-block:: - - .. code-block:: jinja - - $('#tree').bind("select_node.jstree", function (event, data) { - if ((data.rslt.obj.attr("rel") == 'Symfony_Cmf_Bundle_MenuBundle_Document_MenuNode' - || data.rslt.obj.attr("rel") == 'Symfony_Cmf_Bundle_MenuBundle_Document_MultilangMenuNode') - && data.rslt.obj.attr("id") != '{{ menuNodeId }}' - ) { - var routing_defaults = {'locale': '{{ locale }}', '_locale': '{{ _locale }}'}; - routing_defaults["id"] = data.rslt.obj.attr("url_safe_id"); - window.location = Routing.generate('presta_cms_page_edit', routing_defaults); - } - }); - -Don't forget to add your custom route to the fos_js_routing.routes_to_expose configuration : - -.. configuration-block:: - - .. code-block:: yaml - - fos_js_routing: - routes_to_expose: - - symfony_cmf_tree_browser.phpcr_children - - symfony_cmf_tree_browser.phpcr_move - - sonata.admin.doctrine_phpcr.phpcrodm_children - - sonata.admin.doctrine_phpcr.phpcrodm_move - - presta_cms_page_edit - diff --git a/_sources/cmf/bundles/tree.txt b/_sources/cmf/bundles/tree.txt deleted file mode 100644 index bab3e87..0000000 --- a/_sources/cmf/bundles/tree.txt +++ /dev/null @@ -1,121 +0,0 @@ -``TreeBundle`` -============== - -Este paquete es obsoleto puesto que su contenido se movió al `TreeBrowserBundle `_. - -.. index:: TreeBundle - -Dependencias ------------- - -* Instala *jQuery*. `SonatajQueryBundle `_ fuertemente recomendado. - -Configurando ------------- - -No hay ninguna configuración para este paquete. - -Características ---------------- - - * Expandiendo/colapsando nodos. - * Cargando subárboles relajadamente vía respuestas *JSON* para llamadas *AJAX*. - * Función retrollamada al conmutar un nodo. - -Usando ------- - - * Incluye archivos *CSS* y *JS* en tu plantilla. - * Llama a ``$("#tree").jstree({/* parámetros */})`` --- suponiendo que aquí ``#tree`` es el selector de tu lista. - * Proporciona el valor *url* que apunta a alguna cosa de lado del servidor regresando listas de nodos hijo para cualquier ID de nodo dado. - -El servidor tiene que responder en formato *JSON*, este es un ejemplo: - -.. code-block:: javascript - - [ - {"data":"root","attr":{"id":"root","rel":"folder"},"state":"closed","children": - [ - {"data":"content","attr":{"id":"child1","rel":"folder"},"state":"closed"}, - {"data":"menu","attr":{"id":"child2","rel":"folder"},"state":"closed"}, - {"data":"routes","attr":{"id":"child3","rel":"folder"},"state":"closed"} - ] - } - ] - -Disponemos de más información sobre la configuración en el `sitio web de jsTree `_. - -Ejemplo *HTML* --------------- - -.. code-block:: html - - - - CMF Sandbox - Treeview test - - - - - - - - - - - - -
      -
    - -
    - -
    - - {% block content %} - Hello {{ name }}! - {% endblock %} - - diff --git a/_sources/cmf/components/routing.txt b/_sources/cmf/components/routing.txt deleted file mode 100644 index 148d6ff..0000000 --- a/_sources/cmf/components/routing.txt +++ /dev/null @@ -1,212 +0,0 @@ -Enrutando -========= - -La biblioteca del `componente Routing del CMF de Symfony `_ extiende el componente ``routing`` del núcleo de *Symfony2*. Incluso, aunque este tiene *Symfony* en su nombre, no necesita la plataforma *Symfony2* completa y se puede utilizar en proyectos independientes. Para integrarlo con *Symfony* proporcionamos el :doc:`../bundles/routing-extra`. - -En el núcleo del ``CMF`` de *Symfony* el componente de enrutado es la ``ChainRouter``, que se utiliza en vez del sistema de enrutamiento predefinido de *Symfony2*. La ``ChainRouter`` puede encadenar varias implementaciones de la ``RouterInterface``, una tras otra, para determinar cuál debería manejar cada petición. Puedes añadir a esta cadena el enrutador predeterminado de *Symfony2*, por lo tanto aún puedes utilizar el mecanismo de enrutado estándar. - -Adicionalmente, este componente pretende proporcionar útiles implementaciones de las interfaces de enrutado. Actualmente, proporciona el ``DynamicRouter``, el cuál utiliza una ``RequestMatcherInterface`` para cargar ``Rutas`` dinámicamente, y puede aplicar las estrategías de la ``RouteEnhancerInterface`` con el fin de manipularlas. El ``NestedMatcher`` proporcionado puede recuperar dinámicamente objetos `Route `_ de *Symfony2* -desde una ``RouteProviderInterface``. Estas interfaces abstraen una colección de ``Rutas``, que puedes almacenar en una base de datos, tal como *PHPCR-ODM* de *Doctrine* o el *ORM* de *Doctrine*. El ``DynamicRouter`` también utiliza una instancia del ``UrlGenerator`` para generar rutas y proporciona una implementación de esta bajo el ``ProviderBasedGenerator`` el cual puede generar las rutas cargadas desde una instancia de la ``RouteProviderInterface``, y en lo alto del ``ContentAwareGenerator`` para determinar el objeto ``ruta`` a partir de un objeto ``Contenido``. - -.. note:: - - Para utilizar este componente fuera del contexto de la plataforma *Symfony2*, tienes que ver el componente `Routing `_ en el núcleo de *Symfony2* para entender su fundamento. El enrutador del ``CMF`` justo extiende el comportamiento básico. - -.. index:: Routing - -Dependencias ------------- - -Este componente usa `composer `_. It needs the -Symfony2 Routing component and the Symfony2 HttpKernel (for the logger -interface and cache warm-up interface). - -Para el ``DynamicRouter`` necesitarás algo para implementar la ``RouteProviderInterface``. Se sugiere utilizar *Doctrine* puesto que proporciona una manera fácil de asociar clases a una base de datos. - -``ChainRouter`` ---------------- - -En el núcleo del ``CMF`` de *Symfony* el componente de enrutado es la ``ChainRouter``. -Este se utiliza en vez del sistema de enrutado predefinido de *Symfony2*, y es responsable de determinar los parámetros de cada petición. Típicamente necesitas determinar qué controlador manejará esta petición ---en la pila completa de la plataforma *Symfony2*, este está identificado por el campo ``_controller`` de los parámetros---. - -La ``ChainRouter`` trabaja aceptando un conjunto priorizado de implementaciones de estrategias de enrutado, `RouterInterface `_, generalmente conocidos como ``«Enrutadores»``. - -Al manejar una petición entrante, la ``ChainRouter`` itera sobre los ``enrutadores`` configurados, por su prioridad configurada, hasta que uno de ellos es capaz de `emparejar `_ -la petición y proporcionar sus parámetros. - -Enrutadores ------------ - -La ``ChainRouter`` en sí misma, es incapaz de tomar alguna decisión de enrutado real. -Its sole responsibility is managing the given set of Routers, which are responsible for matching a request and determining its parameters. - -You can easily create your own Routers by implementing -`RouterInterface `_ -but Symfony CMF already includes a powerful route matching system that you can -extend to your needs. - -.. note:: - - Si lo estás utilizando como parte de un proyecto completo con el ``CMF`` de *Symfony*, por favor, revisa el :doc:`../bundles/routing-extra` para instrucciones sobre cómo añadir ``Enrutadores`` a la ``ChainRouter``. De lo contrario, usa el método ``add`` de la ``ChainRouter`` para configurar nuevos ``Enrutadores``. - -Enrutador predefinido de *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El mecanismo de enrutado de *Symfony2* en sí mismo es una implementación de la ``RouterInterface``, lo cual significa que lo puedes utilizar como ``Enrutador`` en la ``ChainRouter``. Esto te permite utilizar las declaraciones del sistema de enrutado predefinido. - -Enrutador dinámico -~~~~~~~~~~~~~~~~~~ - -El ``Enrutador`` predefinido de *Symfony2* se desarrolló para manejar definiciones de ``Rutas`` estáticas, puesto que estas tradicionalmente son declaradas en archivos de configuración, antes de ejecutar la aplicación. -Esto lo vuelve una elección pobre para manejar rutas definidas dinámicamente, y para manejar tales situaciones, este paquete viene con el ``DynamicRouter``. Este es capaz de manejar rutas desde datos fuente más dinámicos, tal como los almacenados en bases de datos, y modificar los parámetros resultantes que utilizan un conjunto de potenciadores que puedes configurar fácilmente, muchos de ellos extendiendo la funcionalidad predefinida de *Symfony2*. - -Emparejador -^^^^^^^^^^^ - -El ``DynamicRouter`` utiliza una instancia de la ``RequestMatcherInterface`` o de la ``UrlMatcherInterface`` para emparejar la ``Petición`` o *URL* recibida, a un arreglo de parámetros, respectivamente. -La lógica de emparejado real depende de la implementación subyacente que elijas. -You can easily use you own matching strategy by passing it to the ``DynamicRouter`` -constructor. Como parte de este paquete, ya proporciona un ``NestedMatcher`` que puedes utilizar inmediatamente, o como referencia para tu propia implementación. - - -Su otra característica son las estrategias utilizadas por la ``RouteEnhancerInterface`` para inferir parámetros de enrutado a partir de la información proporcionada por la ruta coincidente (ve abajo). - -``NestedMatcher`` -^^^^^^^^^^^^^^^^^ - -La implementación de la ``RequestMatcherInterface`` proporcionada es ``NestedMatcher``. -It is suitable for use with ``DynamicRouter``, and it uses a multiple step -matching process to determine the resulting routing parameters from a given -`Request `_. - -Esta utiliza una implementación de la ``RouteProviderInterface``, la cual es capaz de cargar objetos candidatos a `Ruta `_ para una ``Petición`` dinámica desde una fuente de datos. Although it can be used -in other ways, the ``RouteProviderInterface``'s main goal is to be easily -implemented on top of Doctrine PHPCR ODM or a relational database, -effectively allowing you to store and manage routes dynamically from database. - -El ``NestedMatcher`` utiliza un proceso de emparejamiento de 3 pasos para determinar qué ``Ruta`` utilizar al manejar la ``Petición`` actual: - -* Pregunta a la ``RouteProviderInterface`` por la potencial colección de instancias de ``Ruta`` que emparejan la ``Petición`` -* Aplica todas las ``RouteFilterInterface`` para filtrar esa colección -* Permite que la instancia de ``FinalMatcherInterface`` decida la mejor coincidencia entre las restantes instancias de ``Ruta`` y la transforma en el arreglo de parámetros. - -``RouteProviderInterface`` -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Basándose en la ``Petición``, el ``NestedMatcher`` recuperará una colección ordenada de objetos ``Ruta`` desde la ``RouteProviderInterface``. La idea de esta proveedora es proporcionar todas las rutas que potencialmente podrían coincidir, pero **no** para hacer ninguna elaborada operación de emparejamiento todavía ---este es el trabajo de los siguientes pasos---. - -La implementación subyacente de la ``RouteProviderInterface`` no está en el alcance de este paquete. Por favor, revisa la declaración de la interfaz para más información. Para un ejemplo funcionando, ve el `RoutingExtraBundle `_. - -``RouteFilterInterface`` -~~~~~~~~~~~~~~~~~~~~~~~~ - -El ``NestedMatcher`` puede aplicar las implementaciones provistas por el usuario de la ``RouteFilterInterface`` para reducir los objetos ``Ruta`` proporcionados, p. ej. haciendo una negociación de contenido. -Es responsabilidad de cada filtro lanzar la ``ResourceNotFoundException`` si no quedan más rutas en la colección. - -``FinalMatcherInterface`` -~~~~~~~~~~~~~~~~~~~~~~~~~ - -La implementación de la ``FinalMatcherInterface`` tiene que determinar una ``Ruta`` exactamente como la mejor coincidencia o lanzar una excepción si ninguna empareja adecuadamente. La implementación predefinida utiliza el `UrlMatcher `_ -del componente ``Routing`` de *Symfony*. - -.. _component-routing-enhancers: - -Potenciadores de ruta -^^^^^^^^^^^^^^^^^^^^^ - -Optionally, and following the matching process, a set of ``RouteEnhancerInterface`` -instances can be applied by the ``DynamicRouter``. El objetivo de estas es permitirte manipular los parámetros de la ruta emparejada. Puedes utilizarlas, por ejemplo, para asignar dinámicamente un controlador o una plantilla a una ``Ruta`` o para ``convertir`` un parámetro de la ``Petición`` a objeto. Algunos potenciadores sencillos ya vienen incorporados en el paquete, puedes encontrar la documentación dentro de cada archivo de clase. - -Enlazando una ``Ruta`` con un ``Contenido`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Dependiendo de la lógica de tu aplicación, una *URL* solicitada puede tener contenido asociado desde la base de datos. Estas ``Rutas`` deberían implementar la ``RouteObjectInterface``, y opcionalmente pueden regresar una instancia del modelo. Si configuras la ``RouteContentEnhancer``, esta debe incluir ese contenido en el arreglo emparejado, con la clave ``_content``. Ten en cuenta que una ``Ruta`` puede implementar la interfaz mencionada anteriormente pero todavía no regresar ninguna instancia del modelo, en cuyo caso ningún objeto asociado será regresado. - -Además, los enrutadores que implementen esta interfaz también pueden proporcionar un nombre de ruta personalizado. La clave devuelta por ``getRouteKey`` será utilizada como el nombre de ruta en vez del nombre de ruta compatible con el núcleo de *Symfony* y puede contener cualquiera de los caracteres del juego de caracteres actual. Esto te permite, por ejemplo, poner una ruta como el nombre de la ruta. Ambos ``UrlMatchers`` proporcionados con el ``NestedMatcher`` reemplazan la clave ``_route`` con la instancia de la ``ruta`` y ponen el nombre proporcionado a ``_route_name``. - -Todos los enrutadores todavía necesitan extender la clase base ``Symfony\Component\Routing\Route``. - -Redirecciones -^^^^^^^^^^^^^ - -Puedes construir redirecciones implementando la ``RedirectRouteInterface``. -Esta puede redirigir a una *URI* absoluta, a una ``Ruta`` nombrada que puede generar cualquier ``Enrutador`` en la cadena o a otro objeto ``Ruta`` provisto por el enrutador. - -Ten en cuenta que la redirección lógica real no es manejada por el paquete. Deberías implementar tu propia lógica para manejar la redirección. Para un ejemplo implementando esta redirección bajo la pila completa de *Symfony2*, revisa :doc:`../bundles/routing-extra`. - - -Generando *URL* -~~~~~~~~~~~~~~~ - -Aparte de emparejar una petición entrante a un conjunto de parámetros, un ``Enrutador`` también es responsable de generar una *URL* a partir de una ``Ruta`` y sus parámetros. -La ``ChainRouter`` itera sobre sus enrutadores hasta que uno de ellos es capaz de generar una *URL* concordante. - - -Aparte de utilizar una ``RequestMatcherInterface`` o una ``UrlMatcherInterface`` para emparejar una ``Petición``/*URL* a sus parámetros correspondientes, el ``DynamicRouter`` también utiliza una instancia de la ``UrlGeneratorInterface``, misma que te permite generar una *URL* desde una ``Ruta``. - -The included ``ProviderBasedGenerator`` extends Symfony2's default -`UrlGenerator `_ -(which, in turn, implements ``UrlGeneratorInterface``) and - if $name is -not already a ``Route`` object - loads the route from the ``RouteProviderInterface``. -Entonces permite que la lógica del núcleo genere la *URL* de esa ``Ruta``. - -El paquete también incluye el ``ContentAwareGenerator``, el cual extiende el ``ProviderBasedGenerator`` para comprobar si el ``$name`` es un objeto implementando la ``RouteAwareInterface`` y, de ser así, consigue la ``Ruta`` a partir del ``contenido``. -Usando el ``ContentAwareGenerator``, puedes generar direcciones *URL* para tu contenido de tres maneras: - -* O bien, pasa un objeto ``Ruta`` como ``$name`` -* O pasa un objeto ``RouteAwareInterface`` que es tu contenido como ``$name`` -* O proporciona una implementación de la ``ContentRepositoryInterface`` y pasa el ``id`` del objeto ``Contenido`` como el parámetro ``content_id`` y ``null`` como ``$name``. - -.. _component-route-generator-and-locales: - -``ContentAwareGenerator`` y regiones -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes usar el valor predeterminado de ``_locale`` en una ``Ruta`` para crear una ruta por región, todas refiriéndose a la misma instancia del contenido multilingüe. El ``ContentAwareGenerator`` respeta el ``_locale`` al generar rutas a partir de instancias de ``Contenido``. Al resolver la ruta, el ``_locale`` se obtiene desde la petición y es recogido por el sistema regional de *Symfony2*. - -.. note:: - - Bajo *PHPCR-ODM*, las rutas nunca deberían ser documentos traducibles, puesto que un documento de ``Ruta`` representa una *URL* única, y no es recomendable servir varias traducciones bajo la misma *URL*. - - Si necesitas direcciones *URL* traducidas, haz que la región forme parte del nombre de la ruta. - - -Personalizando --------------- - -Los paquetes de enrutado cuentan con muchas opciones de personalización, dependiendo de tus necesidades específicas: - -* Puedes implementar tu propio ``RouteProvider`` para cargar rutas desde una fuente diferente -* Tus parámetros de ``Ruta`` se pueden manipular fácilmente utilizando potenciadores existentes -* También puedes añadir tus propios potenciadores al ``DynamicRouter`` -* Puedes añadir instancias de la ``RouteFilterInterface`` al ``NestedMatcher`` -* El ``DynamicRouter`` o sus componentes se pueden extender para permitir modificaciones -* Puedes implementar tus propios ``Enrutadores`` y añadirlos a la ``ChainRouter`` - -.. note:: - - Si sientes que tu potenciador o ``Enrutador`` específico le puede ser útil a otros, contáctanos e intentaremos incluirlo en el paquete. - -Integrando con *Symfony2* -------------------------- - -Tal como mencioné antes, este paquete fue diseñado para sólo requerir ciertas partes de *Symfony2*. Aun así, si deseas utilizarlo como parte de tu proyecto ``CMF`` de *Symfony*, también hay disponible un paquete de integración. Te recomendamos que le eches un vistazo en :doc:`../bundles/routing-extra`. - -Para una guía introductoria al paquete ``Routing`` y su integración con *Symfony2*, consulta :doc:`../getting-started/routing`. - -We strongly recommend reading Symfony2's -`Routing `__ -component documentation page, as it's the base of this bundle's implementation. - -Autores -------- - -* Filippo De Santis (p16) -* Henrik Bjornskov (henrikbjorn) -* Claudio Beatrice (omissis) -* Lukas Kahwe Smith (lsmith77) -* David Buchmann (dbu) -* Larry Garfield (Crell) -* `Y otros `_ - -El código original para la cadena de enrutadores fue aportado por Magnus Nordlander. diff --git a/_sources/cmf/contributing/code.txt b/_sources/cmf/contributing/code.txt deleted file mode 100644 index 8171cf0..0000000 --- a/_sources/cmf/contributing/code.txt +++ /dev/null @@ -1,15 +0,0 @@ -Colaborando -=========== - -El equipo del ``CMF`` de *Symfony2* sigue todas las reglas y directrices del `proceso de desarrollo `_ que el núcleo de *Symfony2*. - -Recursos / enlaces ------------------- - -* `GitHub `_ -* `Sitio web `_ -* `Wiki `_ -* `Rastreador de fallos `_ -* `Canal IRC `_ -* `Lista de correo para usuarios `_ -* `Lista de correo para desarrolladores `_ diff --git a/_sources/cmf/contributing/license.txt b/_sources/cmf/contributing/license.txt deleted file mode 100644 index e110e98..0000000 --- a/_sources/cmf/contributing/license.txt +++ /dev/null @@ -1,58 +0,0 @@ -Licencia -======== - -El objetivo del ``CMF`` de *Symfony2* es proporcionar licencias de código abierto liberales para su pila completa. - -Código ------- - -La pila del código está cubierta por la `licencia de Apache`_ para ``Jackalope`` y *PHPCR*, el resto de la pila, notablemente el código *Symfony2*, *PHPCR-ODM*, :file:`create.js` y :file:`Hallo.js` está `licenciado bajo MIT`_. Por favor, refiérete a los archivos de LICENCIA pertinentes en la fuente de los paquetes dados. - -Documentación -------------- - -La documentación de *Symfony2* está bajo una licencia `Creative Commons Attribution-Share Alike 3.0 Unported License`_. - -**Estás en libertad:** - -* para *Compartir* — copiar, distribuir y trasmitir públicamente la obra; - -* para *Derivar* — adaptando la obra. - -**Bajo las siguientes condiciones:** - -* *Atribución* — Debes atribuir el trabajo de la manera especificada por - el autor o licenciador (pero de ninguna manera que sugiera que apoya tu - uso de la obra). - -* *Compartir bajo la misma licencia* — Si alteras, transformas, o creas - sobre esta obra, sólo podrás distribuir la obra resultante bajo una - licencia idéntica o similar a esta. - -**En el entendido de:** - -* *Renuncia* — Cualquiera de estas condiciones puede no aplicarse si - obtienes el permiso del titular de los derechos de autor; - -* *Dominio Público* — Cuando la obra o cualquiera de sus elementos es del - dominio público bajo la legislación aplicable, este estatus de ninguna - manera es afectado por la licencia; - -* *Otros Derechos* — De ninguna manera cualquiera de los siguientes derechos - se ve afectado por la licencia: - - * Tu derecho leal o uso justo, u otros derechos de autor excepciones y limitaciones aplicables; - - * Los derechos morales del autor; - - * Otras personas pueden tener derechos ya sea en la propia obra o en la forma en que se utiliza la obra, como los derechos de publicidad o privacidad. - -* *Atención* — Para cualquier reutilización o distribución, debes dejar - claros los términos de la licencia de esta obra. La mejor manera de hacerlo es con un enlace a esta página web. - -Este es un resumen humanamente legible del `Texto legal (Licencia completa)`_. - -.. _`licencia de Apache`: http://en.wikipedia.org/wiki/Apache_license -.. _`licenciado bajo MIT`: http://en.wikipedia.org/wiki/MIT_License -.. _`Creative Commons Attribution-Share Alike 3.0 Unported License`: http://creativecommons.org/licenses/by-sa/3.0/ -.. _`Texto legal (Licencia completa)`: http://creativecommons.org/licenses/by-sa/3.0/legalcode \ No newline at end of file diff --git a/_sources/cmf/cookbook/installing-cmf-sandbox.txt b/_sources/cmf/cookbook/installing-cmf-sandbox.txt deleted file mode 100644 index 7794988..0000000 --- a/_sources/cmf/cookbook/installing-cmf-sandbox.txt +++ /dev/null @@ -1,263 +0,0 @@ -Instalando el recinto de seguridad del ``CMF`` -============================================== - -Esta guía muestra cómo instalar el recinto de seguridad del *CMF* de *Symfony*, una demostración de la plataforma dirigida a exhibir las características básicas de la herramienta corriendo en un entorno ``demo``. -La puedes usar para evaluar la plataforma o para ver código real en acción, ayudándote a entender la herramienta. - -Si bien lo puedes utilizar tal cual, este recinto de seguridad no pretende ser una plataforma de desarrollo. Si estás buscando instrucciones de instalación para una configuración de desarrollo, por favor revisa: - -- la página :doc:`../getting-started/installing-symfony-cmf` para instrucciones sobre cómo instalar rápidamente el *CMF* (recomendado para desarrollo) -- :doc:`../tutorials/installing-cmf-core` para una instalación paso a paso y detalles de configuración (si quieres conocer todos los detalles) - -.. index:: sandbox, instalación, recinto de seguridad - -Requisitos previos ------------------- - -Debido a que el ``CMF`` de *Symfony* está basado en *Symfony2*, deberías asegurarte de que cubres los `Requisitos para que funcione Symfony2 `_. -`Git 1.6+ `_, `Curl `_ y *PHP* ``Intl`` también son necesarios para seguir los pasos de instalación enumerados más adelante. - -If you wish to use Jackalope + Apache JackRabbit as the storage medium (recommended), -you will also need Java (JRE). Para otros mecanismos y sus requisitos, por favor refiérete a sus respectivas secciones. - -Instalando ----------- - -*Apache* ``Jackrabbit`` -~~~~~~~~~~~~~~~~~~~~~~~ - -El recinto de seguridad del ``CMF`` de *Symfony* de manera predeterminada usa ``Jackalope`` con *Apache* ``JackRabbit``. -Puedes configurar métodos de almacenamiento alternativo, pero este es el más probado, y debería ser el más fácil de configurar. - -Puedes conseguir la más reciente versión de *Apache* ``Jackrabbit`` en la página de descarga oficial del `proyecto `_. -Para lanzarlo, usa la siguiente orden: - -.. code-block:: bash - - java -jar jackrabbit-standalone-*.jar - -By default the server is listening on the 8080 port, you can change this -by specifying the port on the command line. - -.. code-block:: bash - - java -jar jackrabbit-standalone-*.jar --port 8888 - -For unix systems, you can get the start-stop script for /etc/init.d `here `_ - -Consiguiendo el código del recinto de seguridad -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El código fuente del recinto de seguridad del ``CMF`` de *Symfony* está disponible en *github*. Para conseguirlo usa: - -.. code-block:: bash - - git clone git://github.com/symfony-cmf/cmf-sandbox.git - -Ve al directorio y copia los archivos de configuración predefinidos: - -.. code-block:: bash - - cd cmf-sandbox - cp app/config/parameters.yml.dist app/config/parameters.yml - cp app/config/phpcr_jackrabbit.yml.dist app/config/phpcr.yml - -These two files include the default configuration parameters for the sandbox -storage mechanism. Los puedes modificar para cubrir mejor tus necesidades. - -.. note:: - - The second configuration file refers to specific jackalope + - jackrabbit configuration. There are other files available for - different stack setups. - -Next, get composer and install and the necessary bundles (this may take a while) - -.. code-block:: bash - - curl -s http://getcomposer.org/installer | php -- - php composer.phar install - -.. note:: - - En Windows necesitas ejecutar el intérprete de ordenes como administrador o editar el archivo :file:`composer.json`y cambiar la línea ``"symfony-assets-install": "symlink"`` a ``"symfony-assets-install": ""``. Si fallas al hacerlo podrías recibir: -.. code-block:: bash - - [Symfony\Component\Filesystem\Exception\IOException] - Imposible crear el enlace simbólico debido al error código 1314: 'El cliente no cuenta con un privilegio requerido'. ¿Tienes el privilegio de administrador requerido? - -Preparando el repositorio *PHPCR* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Now that you have all the code, you need to setup your PHPCR repository. -PHPCR organizes data in workspaces, and sandbox uses the "default" workspace, -which is exists by default in Jackrabbit. If you use other applications that -require Jackrabbit, or if you just wish to change the workspace name, you -can do so in app/config/phpcr.yml. La siguiente orden creará un nuevo espacio de trabajo llamado ``«sandbox»`` en ``Jackrabbit``. Si decides utilizar el espacio de trabajo ``«default»``, la puedes omitir. - -.. code-block:: bash - - app/console doctrine:phpcr:workspace:create sandbox - -Once your workspace is set up, you need to `register the node types `_ for phpcr-odm: - -.. code-block:: bash - - app/console doctrine:phpcr:repository:init - -Import the fixtures -~~~~~~~~~~~~~~~~~~~ - -La interfaz de administración sigue en una etapa temprana. Hasta que mejore, lo más fácil es crear los datos programáticamente. La mejor manera de hacerlo es con los accesorios de *Doctrine*. El ``DoctrinePHPCRBundle`` incluido en el repositorio ``symfony-cmf`` proporciona una orden para cargar accesorios. - -.. code-block:: bash - - app/console -v doctrine:phpcr:fixtures:load - -Ejecuta esta orden para cargar los accesorios desde el ``MainBundle`` del recinto de seguridad, la cual poblará tu repositorio con datos maniquí, es decir, carga las páginas ``demo``. - -Accediendo a tu recinto de seguridad -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El recinto de seguridad ahora debería ser accesible en tu servidor *web*. - -.. code-block:: text - - http://localhost/app_dev.php - -Para ejecutar el recinto de seguridad en modo de producción necesitas generar los delegados de *Doctrine* y volcar los activos de ``assetic``: - -.. code-block:: text - - app/console cache:warmup --env=prod --no-debug - app/console assetic:dump --env=prod --no-debug - - -Mecanismos de almacenamiento alternativo ----------------------------------------- - -El ``CMF`` de *Symfony* y el recinto de seguridad son de almacenamiento agnóstico, lo cual significa que puedes cambiar el mecanismo de almacenamiento sin tener que cambiar tu código. El mecanismo de almacenamiento predefinido para el recinto de seguridad es ``Jackalope`` + *Apache* ``Jackrabbit``, puesto que es la configuración más probada y estable. Sin embargo, hay otras alternativas disponibles. - -``Jackalope`` + *DBAL* de *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. note:: - - De manera predeterminada, cuándo utilizas el *DBAL* de *Doctrine*, los datos se almacenan utilizando una base de datos `Sqlite `_. - Revisa la página del proyecto para instrucciones de instalación. - Si deseas utilizar otros sistemas de base de datos, cambia los parámetros de configuración en el archivo :file:`app/config/parameters.yml`. Consulta la página sobre la `configuración del DBAL de Doctrine en Symfony `_ o la `documentación de Doctrine `_ para más información. - -Ve al directorio del recinto de seguridad y copia el archivo de configuración predefinido para -configurar el *DBAL* de *Doctrine*: - -.. code-block:: bash - - cd cmf-sandbox - cp app/config/phpcr_doctrine_dbal.yml.dist app/config/phpcr.yml - -Next, you need to install the actual Doctrine DBAL bundle required by jackalope: - -.. code-block:: bash - - php composer.phar require jackalope/jackalope-doctrine-dbal:dev-master - -Y crea e inicia tu base de datos: - -.. code-block:: bash - - app/console doctrine:database:create - app/console doctrine:phpcr:init:dbal - -Después de esto, deberías seguir los pasos en `Preparando el repositorio PHPCR`_. - -Memorizando en caché con *Doctrine* -+++++++++++++++++++++++++++++++++++ - -Opcionalmente, para mejorar el rendimiento y habilitar los metadatos, puedes instalar ``LiipDoctrineCacheBundle`` -escribiendo la siguiente orden: - -.. code-block:: bash - - php composer.phar require liip/doctrine-cache-bundle:dev-master - -And adding the following entry to your app/AppKernel.php: - -.. code-block:: php - - // app/AppKernel.php - public function registerBundles() - { - $bundles = array( - // ... - new Liip\DoctrineCacheBundle\LiipDoctrineCacheBundle(), - // ... - ); - } - -Finalmente descomenta las opciones de caché en el archivo :file:`phpcr.yml` así como las de ``liip_doctrine_cache`` en el archivo :file:`config.yml`. - -.. code-block:: yaml - - # app/config/phpcr.yml - caches: - meta: liip_doctrine_cache.ns.meta - nodes: liip_doctrine_cache.ns.nodes - -.. code-block:: yaml - - # app/config/config.yml - - # jackalope doctrine caching - liip_doctrine_cache: - namespaces: - meta: - type: file_system - nodes: - type: file_system - -Proveyendo *PHPCR* para *Midgard2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si quieres correr el recinto de seguridad del ``CMF`` con el proveedor `PHPCR de Midgard2 `_ en vez de ``Jackrabbit``, necesitas instalar la extensión ``midgard2`` de *PHP*. -En sistemas *Debian/Ubuntu* actuales, esto se hace simplemente con: - -.. code-block:: bash - - sudo apt-get install php5-midgard2 - -En *OS X* lo puedes instalar utilizando cualquier `Homebrew `_ con: - -.. code-block:: bash - - brew install midgard2-php - -o `MacPorts `_ con - -.. code-block:: bash - - sudo port install php5-midgard2 - -You also need to download `midgard_tree_node.xml `_ -and `midgard_namespace_registry.xml `_ -schema files, and place them into "/schema" (defaults to "/usr/share/midgard2/schema") - -To have the Midgard2 PHPCR implementation installed run the following additional command: - -.. code-block:: bash - - php composer.phar require midgard/phpcr:dev-master - -Finalmente, cambia uno de los archivos de configuración de ``Midgard2``: - -.. code-block:: bash - - cp app/config/phpcr_midgard_mysql.yml.dist app/config/phpcr.yml - -o - -.. code-block:: bash - - cp app/config/phpcr_midgard_sqlite.yml.dist app/config/phpcr.yml - -After this, your should follow the steps in `Preparing the PHPCR repository`_ -to continue the installation process. \ No newline at end of file diff --git a/_sources/cmf/cookbook/phpcr-odm-custom-documentclass-mapper.txt b/_sources/cmf/cookbook/phpcr-odm-custom-documentclass-mapper.txt deleted file mode 100644 index ebe0fd4..0000000 --- a/_sources/cmf/cookbook/phpcr-odm-custom-documentclass-mapper.txt +++ /dev/null @@ -1,34 +0,0 @@ -Usando una clase documento personalizada asociada con *PHPCR-ODM* -================================================================= - -El asignador predefinido para la clase ``document`` *PHPCR-ODM* utiliza el atributo ``phpcr:class`` para almacenar y recuperar la clase ``documento`` de un nodo. Cuándo accedes a un repositorio *PHPCR* existente, podrías necesitar diferente lógica para decidir en la clase. - -Puedes extender el ``DocumentClassMapper`` o implementar la ``DocumentClassMapperInterface`` desde el principio. Los métodos importantes son ``getClassName`` que se necesita para encontrar el nombre de clase y ``writeMetadata`` que se necesita para garantizar que la clase de un nuevo documento almacenado se puede determinar al cargarlo de nuevo. - -Luego, puedes sustituir el servicio ``doctrine.odm_configuration`` para llamar a ``setDocumentClassMapper`` en él. Un ejemplo del `recinto de seguridad del CMF de Symfony`_ (rama de magnolia_integration): - -.. configuration-block:: - - .. code-block:: yaml - - # Resources/config/services.yml - - # Si quieres sobrescribir la configuración predefinida, de lo contrario utiliza - # un nombre personalizado y pónlo en el bloque de configuración del odm - - doctrine.odm_configuration: - class: %doctrine_phpcr.odm.configuration.class% - calls: - - [ setDocumentClassMapper, [@sandbox_magnolia.odm_mapper] ] - - sandbox_magnolia.odm_mapper: - class: "Sandbox\MagnoliaBundle\Document\MagnoliaDocumentClassMapper" - arguments: - - 'standard-templating-kit:pages/stkSection': 'Sandbox\MagnoliaBundle\Document\Section' - -Aquí creamos una asociación que usa una configuración para leer información del nodo y se asocia a una clase ``documento``. - -Si tienes varios repositorios, puedes usar una configuración por repositorio. -See :ref:`bundle-phpcr-odm-multiple-phpcr-sessions`. - -.. _`recinto de seguridad del CMF de Symfony`: https://github.com/symfony-cmf/cmf-sandbox/tree/magnolia_integration \ No newline at end of file diff --git a/_sources/cmf/cookbook/using-a-custom-route-repository.txt b/_sources/cmf/cookbook/using-a-custom-route-repository.txt deleted file mode 100644 index 2b3666a..0000000 --- a/_sources/cmf/cookbook/using-a-custom-route-repository.txt +++ /dev/null @@ -1,88 +0,0 @@ -Usando un repositorio de rutas personalizado con un enrutador dinámico -====================================================================== - -El enrutador dinámico te permite personalizar la ruta al repositorio (es decir, la clase responsable de recuperar rutas desde la base de datos), y por extensión, los objetos ``Ruta``. - -Creando el repositorio de rutas -------------------------------- - -El repositorio de rutas tiene que implementar la `RouteRepositoryInterface`. La siguiente clase proporciona una solución sencilla que utiliza un repositorio *ODM*. - -.. code-block:: php - - findOneBy(array( - 'url' => $url, - )); - - $pattern = $myDocument->getUrl(); // p. ej. "/esta/es/una/url" - - $collection = new RouteCollection(); - - // crea una nueva ruta y pone nuestro documento como - // predefinido (a modo de que lo podamos recuperar desde la petición) - $route = new SymfonyRoute($ep->getPath(), array( - 'document' => $document, - )); - - // Añade la ruta al RouteCollection usando - // como clave un ID único. - $collection->add('my_route_'.uniqid(), $route); - - return $collection; - } - - // este método se usa para generar URL, p. ej. {{ path('foobar') }} - public function getRouteByName($name, $params = array()) - { - $document = $this->findOneBy(array( - 'name' => $name, - )); - - if ($route) { - $route = new SymfonyRoute($route->getPattern(), array( - 'document' => $document, - )); - } - - return $route; - } - } - -.. tip:: - - Como posiblemente hayas notado regresamos un objeto `RouteCollection` --- ¿porqué no regresamos una sola ``Ruta``? El enrutador dinámico nos permite regresar muchas rutas *candidatas*, en otras palabras, rutas que *podrían* emparejar con la *URL* entrante. Esto es importante para habilitar la posibilidad de emparejar rutas *dinámicas*, `/page/{page_id}/edit` por ejemplo. - En nuestro ejemplo emparejamos las *URL* dadas exactamente y siempre regresar únicamente una sola ``Ruta``. - -Reemplazando el repositorio predefinido del *CMF* -------------------------------------------------- - -Para reemplazar el `RouteRepository` predefinido es necesario modificar tu configuración -de la siguiente manera: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - enabled: true - route_repository_service_id: my_bundle.repository.endpoint - -Donde `my_bundle.repository.endpoint` es el ID del servicio de tu repositorio. -Ve `Creando y configurando servicios en el contenedor `_ para información sobre la creación de servicios personalizados. diff --git a/_sources/cmf/getting-started/content.txt b/_sources/cmf/getting-started/content.txt deleted file mode 100644 index 7fa517d..0000000 --- a/_sources/cmf/getting-started/content.txt +++ /dev/null @@ -1,77 +0,0 @@ -.. index:: - single: Content, SymfonyCmfContentBundle - -Contenido -========= - -Concepto --------- - -El corazón de cada *CMS* está en el contenido, una abstracción que los editores pueden manipular y que más tarde será presentado a los usuarios de la página. La estructura del contenido depende mucho de las necesidades del proyecto, y este debe tener un significativo impacto en el futuro uso y desarrollo de la plataforma. - -La *EE* del ``CMF`` de *Symfony* viene con el ``ContentBundle``: una implementación básica de una estructura de contenido, incluyendo el soporte para múltiples idiomas y el almacenamiento de ``Rutas`` en la base de datos. - -Contenido estático ------------------- - -El ``StaticContent`` declara la estructura básica del contenido. Su estructura es muy similar a las utilizadas en los sistemas *ORM* de *Symfony2*, y la mayoría de sus campos son autoexplicativos, ya que son lo que esperarías de un *CMS* básico: -título, cuerpo, información de publicación y una referencia al padre, para organizar un árbol jerárquico. Este también incluye un bloque de referencia (más sobre esto más adelante). - -Las dos interfaces implementadas revelan dos de las características incluidas en esta implementación: - -- ``RouteAwareInterface`` significa que el contenido tiene ``Rutas`` asociadas. - -- ``PublishWorkflowInterface`` significa que el contenido tiene fechas de publicación y despublicación, las cuales serán manejadas por el núcleo del ``CMF`` de *Symfony* para determinar el acceso. - - -Contenido multilingüe estático ------------------------------- - -The ``MultilangStaticContent`` extends ``StaticContent``, offering the same -functionality with multi language support. Este especifica qué campos son traducidos (``title``, ``body`` y ``tags``) así como una variable para declarar la región. - -También especifica la estrategia de traducción: - -.. configuration-block:: - - .. code-block:: php-annotations - - /** - * @PHPCRODM\Document(translator="child", referenceable=true) - */ - -Para información sobre las estrategias de traducción disponibles, consulta la página -de *Doctrine* relacionada con el `Soporte multilingüe en el PHPCR-ODM `_ - - -Controlador de contenido ------------------------- - -Para manejar ambos tipos de contenido, también incluye un ``Controlador``. Its inner -workings are pretty straightforward: acepta una instancia de ``contenido`` y opcionalmente una plantilla a dibujar. If none is provided, it uses a pre-configured default. -It also takes into account the document's publishing status and multi language. -Ambas instancias de contenido y la plantilla opcional son proporcionadas al ``Controlador`` -por el ``DynamicRouter`` del ``RoutingExtraBundle``. More information on this is -available on the :ref:`Routing system getting started page ` -page. - -Admin Support -------------- - -El último componente necesario para manejar los tipos de contenido incluidos es una interfaz de administración. Symfony CMF can optionally support `SonataDoctrinePHPCRAdminBundle `_ -, a back office generation tool. Para más información sobre esta, por favor consulta la sección de documentación del `paquete `_. - -En ``ContentBundle``, las nterfaces de administración requeridas ya están declaradas en el directorio ``Admin`` y configuradas en el archivo :file:`Resources/config/admin.xml`, y serán cargadas automáticamente si instalas el ``SonataDoctrinePHPCRAdminBundle`` (ve :doc:`../tutorials/creating-cms-using-cmf-and-sonata` para instrucciones sobre esto). - -Configurando ------------- - -El paquete también apoya un conjunto opcional de parámetros de configuración. Consulta :doc:`../bundles/content` para la referencia de configuración completa. - -Consideraciones finales ------------------------ - -Si bien este pequeño paquete incluye algunos componentes vitales para un *CMS* completamente operativo, a menudo no proporciona todo lo que necesitas. The main idea behind it is to -provide developers with a small and easy to understand starting point you can -extend or use as inspiration to develop your own content types, Controllers and -Admin panels. diff --git a/_sources/cmf/getting-started/installing-symfony-cmf.txt b/_sources/cmf/getting-started/installing-symfony-cmf.txt deleted file mode 100644 index 1395aee..0000000 --- a/_sources/cmf/getting-started/installing-symfony-cmf.txt +++ /dev/null @@ -1,168 +0,0 @@ -.. index:: - single: Edición estándar, instalando - -Instalando la edición estándar del ``CMF`` de *Symfony* -======================================================= - -El objetivo de esta guía es instalar todos los componentes del ``CMF`` con la configuración mínima necesaria y algunos muy sencillos ejemplos en una aplicación *Symfony2* en funcionamiento. Esto se suele usar para familiarizarte con el ``CMF`` o para utilizarlo como punto de partida para personalizar una nueva aplicación. - -Si este es tu primer encuentro con el ``CMF`` de *Symfony* sería buena idea darle un vistazo primero a: - -- `El concepto `_ -- La demostración en línea del recinto de seguridad en `cmf.liip.ch `_ - -.. note:: - - Para otras guías de instalación del ``CMF`` de *Symfony*, por favor, consulta: - - - The cookbook entry on :doc:`../cookbook/installing-cmf-sandbox` for instructions on - how to install a more complete demo instance of Symfony CMF. - - :doc:`../tutorials/installing-cmf-core` for step-by-step installation and - configuration details of just the core components into an existing Symfony - application. - -Requisitos previos ------------------- - -Debido a que el ``CMF`` de *Symfony* está basado en *Symfony2*, deberías asegurarte de que cubres los `Requisitos para que funcione Symfony2 `_. -Además, necesitas tener instalada la extensión *PDO* de `SQLite `_ (``pdo_sqlite``), puesto que esta se utiliza como el medio de almacenamiento predeterminado. - -.. note:: - - By default, Symfony CMF uses Jackalope + Doctrine DBAL and SQLite as - the underlying DB. No obstante, el ``CMF`` de *Symfony* es de almacenamiento agnóstico, lo cual significa que puedes utilizar uno de varios mecanismos de almacenamiento de datos disponibles sin tener que reescribir tu código. Para más información en los diferentes mecanismos disponibles y cómo instalarlos y configurarlos, consulta el :doc:`../tutorials/installing-configuring-doctrine-phpcr-odm` - -`Git `_ and `Curl `_ are also -needed to follow the installation steps listed below. - - -Instalando ----------- - -La manera más fácil de instalar el ``CMF`` de *Symfony* es utilizando `Composer `_. -Consíguelo usando: - -.. code-block:: bash - - $ curl -sS https://getcomposer.org/installer | php - $ sudo mv composer.phar /usr/local/bin/composer - -Y luego consigue el código del ``CMF`` de *Symfony* con él (esto puede tomar un buen rato) - -.. code-block:: bash - - $ php composer.phar create-project symfony-cmf/standard-edition --stability=dev - $ cd - -.. note:: - - The path ```` should either inside your web server doc root or - configure a virtual host for ````. - -Esto clonará la edición estándar e instalará todas las dependencias y ejecutará algunas órdenes iniciales. -Estas órdenes requieren permisos de escritura en los directorios :file:`app/cache` y :file:`app/logs`. En caso de que al final las órdenes terminen dando errores de permisos, por favor sigue las `directrices en la documentación oficial `_ para configurar los permisos y luego ejecuta la orden ``composer.phar install`` mencionada abajo. - -Si lo prefieres, también puedes clonar el proyecto directamente: - -.. code-block:: bash - - $ git clone git://github.com/symfony-cmf/symfony-cmf-standard.git - $ cd - -Si ocurrieron problemas durante la orden ``create-project``, o si utilizaste ``git clone`` o si después activaste una versión anterior (con ``checkout``), siempre ejecuta la siguiente orden para actualizar las dependencias: - -.. code-block:: bash - - $ php composer.phar install - -The next step is to setup the database, if you want to use SQLite as your database backend just go -ahead and run the following: - -.. code-block:: bash - - $ php app/console doctrine:database:create - $ php app/console doctrine:phpcr:init:dbal - $ php app/console doctrine:phpcr:repository:init - $ php app/console doctrine:phpcr:fixtures:load - -This will create a file called ``app.sqlite`` inside your app folder, containing the database content. - -El proyecto ahora tendría que estar accesible en tu servidor *web*. Si tienes instalado *PHP 5.4*, alternativamente puedes utilizar el servidor *web* interno de *PHP*: - -.. code-block:: bash - - $ php app/console server:run - -Y entonces accede al ``CMF`` vía: - -.. code-block:: text - - http://localhost:8000 - -Si prefieres utilizar otro servidor de base de datos, por ejemplo *MySQL*, ejecuta el configurador (apunta tu navegador a ``/web/config.php``) o configura tus parámetros de conexión a la base de datos en el archivo :file:`app/config/parameters.yml`. Asegúrate de dejar la propiedad ``database_path`` en ``null`` para utilizar otro controlador distinto a *SQLite*. Dejar el campo en blanco en el configurador *web* lo debería poner a ``null``. - -Descripción ------------ - -Esta guía te ayudará a entender las partes básicas de la edición estándar del ``CMF`` de *Symfony* (*EE*) y cómo trabajan juntas para proporcionar las páginas predefinidas que puedes ver al explorar la instalación de la Edición estándar del ``CMF`` de *Symfony*. - -It assumes you have already installed Symfony CMF SE and have carefully -read `the Symfony2 book `_. - -.. note:: - - Para otras guías de instalación del ``CMF`` de *Symfony*, por favor, consulta: - - - The cookbook entry on :doc:`../cookbook/installing-cmf-sandbox` for instructions on how to - install a more complete demo instance of Symfony CMF. - - :doc:`../tutorials/installing-cmf-core` for step-by-step installation and configuration - details of just the core components into an existing Symfony application. - -``AcmeMainBundle`` y ``SimpleCMSBundle`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La *EE* del ``CMF`` de *Symfony* viene con un ``AcmeMainBundle`` predefinido para ayudarte a empezar, en una manera similar al ``AcmeDemoBundle`` que tiene *Symfony2*, proporcionándote algunas páginas de demostración visibles en tu navegador. Sin embargo, el ``AcmeMainBundle`` no incluye controladores o archivos de configuración, como probablemente esperarías. Este contiene poco más que un archivo *Twig* y datos `Accesorios `_, que fueron cargados a tu base de datos durante la instalación. - -Hay varios paquetes trabajando juntos para convertir los datos accesorios en un sitio web navegable. El proceso global simplificado, es el siguiente: - -- When a request is received, the Symfony CMF :doc:`routing`'s Dynamic Router is used to handle the - incoming request. -- The Dynamic Router is able to match the requested URL with a specific ContentBundle's Content - stored in the database. -- The retrieved content's information is used to determine which controller to pass it on to, and - which template to use. -- As configured, the retrieved content is passed to ContentBundle's ContentController, which will - handle it and render AcmeMainBundle's layout.html.twig. - -Una vez más, esto es un vistazo simplificado de un muy sencillo *CMS* construido en lo alto del ``CMF`` de *Symfony*. -To fully understand all the possibilities of the CMF, a careful look into -each component is needed. - -If you want to review the contents of the PHPCR database you can use the following command: - -.. code-block:: bash - - $ php app/console doctrine:phpcr:dump - -Adding new pages -~~~~~~~~~~~~~~~~ - -Symfony CMF SE does not provide any admin tools to create new pages. If you are interested in adding -an admin UI have a look at :doc:`../tutorials/creating-cms-using-cmf-and-sonata`. However if all you -want is a simple way to add new pages that you can then edit via the inline editing, then you can -use the SimpleCmsBundle ``page`` migrator. The Symfony CMF SE ships with an example yaml file stored -in ``app/Resources/data/pages/test.yml``. The contents of this file can be loaded into the PHPCR -database by calling: - -.. code-block:: bash - - $ php app/console doctrine:phpcr:migrator page --identifier=/cms/simple/test - -Note that the above identifier is mapped to ``app/Resources/data/pages/test.yml`` by stripping -off the ``basepath`` configuration of the SimpleCmsBundle, which defaults to ``/cms/simple``. -Therefore if you want to define a child page ``foo`` for ``/cms/simple/test`` you would need to -create a file ````app/Resources/data/pages/test/foo.yml`` and then run the following command: - -.. code-block:: bash - - $ php app/console doctrine:phpcr:migrator page --identifier=/cms/simple/test/foo diff --git a/_sources/cmf/getting-started/menu.txt b/_sources/cmf/getting-started/menu.txt deleted file mode 100644 index e1c80ac..0000000 --- a/_sources/cmf/getting-started/menu.txt +++ /dev/null @@ -1,152 +0,0 @@ -.. index:: - single: Menu, SymfonyCmfMenuBundle - -Menú -==== - -Concepto --------- - -Ningún sistema *CMS* está completo sin un sistema de menús que permita a los usuarios navegar entre las páginas de contenido y realizar determinadas acciones. Si bien, normalmente asignan el contenido real en una estructura de árbol, los menús a menudo tienen su propia lógica, incluyendo opciones no asignadas al contenido o existentes en múltiples contextos con múltiples opciones, por ello volviéndolos un problema complejo. - - -El sistema de menús del ``CMS`` de *Symfony* --------------------------------------------- - -La *EE* del ``CMF`` de *Symfony* incluye el ``MenuBundle``, una herramienta que te permite definir tus menús dinámicamente. It extends `KnpMenuBundle `_, -with a set of hierarchical, multi language menu elements, along with the tools -to load and store them from/to a database. It also includes the administration -panel definitions and related services needed for integration with -`SonataDoctrinePhpcrAdminBundle `_ - -.. note:: - - El ``MenuBundle`` extiende y en gran medida depende del `KnpMenuBundle `_, por lo tanto tienes que leer cuidadosamente la `documentación del KnpMenuBundle `_. - Para el resto de esta página se supone que has leido dicha documentación, y estás familiarizado con conceptos como proveedores de menús y factorías de menús. - - -Usando -~~~~~~ - -De manera predeterminada el ``MenuBundle`` usa los reproductores y ayudantes del ``KnpMenuBundle`` para imprimir tus menús. Puedes consultar la `página de documentación respectiva `_ para más información sobre el tema, pero una llamada básica sería: - -.. configuration-block:: - - .. code-block:: jinja - - {{ knp_menu_render('simple') }} - - .. code-block:: php - - render('simple') ?> - -El nombre del menú proporcionado será pasado a la implementación de la ``MenuProviderInterface``, la cual lo utilizará para identificar qué menú quieres dibujar en esa sección específica. - -El proveedor -~~~~~~~~~~~~ - -El núcleo del ``MenuBundle`` es ``PHPCRMenuProvider``, una implementación de la ``MenuProviderInterface`` que es responsable de cargar menús dinámicamente desde una base de datos *PHPCR*. The default provider service is configured with a ``menu_basepath`` to -know where in the PHPCR tree it will find menus. The menu ``name`` is given when -rendering the menu and must be a direct child of the menu base path. This allows the -``PHPCRMenuProvider`` to handle several menu hierarchies using a single -storage mechanism. - -To give a concrete example, if we have the configuration as given below and render the -menu ``simple``, the menu root node must be stored at ``/cms/menu/simple``. - -.. configuration-block:: - - .. code-block:: yaml - - symfony_cmf_menu: - menu_basepath: /cms/menu - - .. code-block:: xml - - - /cms/menu - - - .. code-block:: php - - $container->loadFromExtension('symfony_cmf_menu', array( - 'menu_basepath' => '/cms/menu', - )); - -If you need multiple menu roots, you can create further PHPCRMenuProvider instances -and register them with KnpMenu - see the CMF MenuBundle DependencyInjection code -for the details. - -El elemento del menú recuperado usando este proceso se utiliza como el nodo raíz del menú, y sus hijos serán cargados progresivamente conforme el ``MenuFactory`` vaya dibujando la estructura del menú completo. - - -La factoría -~~~~~~~~~~~ - -The ``ContentAwareFactory`` is a ``FactoryInterface`` implementation, which -generates the full ``MenuItem`` hierarchy from the provided MenuNode. Los datos generados de este modo se utilizan más tarde para generar la representación *HTML* real del menú. - -La implementación incluida se enfoca en generar instancias de ``MenuItem`` a partir de instancias de ``NodeInterface``, puesto que esa es la mejor aproximación para manejar estructuras estilo árbol como las utilizadas típicamente por los *CMS*. Other approaches are implemented -in the base classes, and their respective documentation pages can be found -in `KnpMenuBundle`_'s page. - -``ContentAwareFactory`` is responsible for loading the full menu hierarchy -and transforming the ``MenuNode`` instances from the root node it -receives from the ``MenuProviderInterface`` implementation. También es responsable de determinar cuál elemento del menú (si lo hay) está viendo el usuario actualmente. ``KnpMenu`` ya incluye una factoría específica apuntada en el componente de enrutado de *Symfony2*, la cual extiende este paquete, para añadir el soporte necesario para: - -- Databased stored ``Route`` instances (refer to :ref:`RoutingBundle's RouteProvider ` for more details - on this) -- ``Route`` instances with associated content (more on this on respective :ref:`RoutingBundle's section `) - -Como se mencionó antes, la ``ContentAwareFactory`` es responsable de cargar todos los nodos del menú a partir del elemento raíz proporcionado. Los nodos cargados realmente pueden ser de cualquier clase, incluso si son diferentes de la clase del nodo raíz, pero todos tienen que implementar la ``NodeInterface`` para poder incluirlos en el menú generado. - - -Los nodos del menú -~~~~~~~~~~~~~~~~~~ - -Además, incluidos en el ``MenuBundle`` vienen dos tipos de nodos de contenido del menú: ``MenuNode`` y ``MultilangMenuNode``. Si leíste la página de documentación relativa al :doc:`content`, encontrarás un tanto familiar esta implementación. El ``MenuNode`` -Implementa la ``NodeInterface`` mencionada arriba, y mantiene la información relacionada a una sola entrada del menú: Una ``etiqueta`` y una ``uri``, una lista de ``hijos``, tal como esperarías, más algunos ``atributos`` para él y sus -hijos, mismos que te permiten personalizar el proceso de reproducción real. -También incluye un campo ``Route`` y dos referencias al ``Contenido``. Estas se usan para almacenar un objeto ``Route`` asociado, más un elemento (no dos, a pesar del hecho de que existen dos campos) de ``Contenido``. El ``MenuNode`` puede tener una referencia fuerte (garantizando la integridad) o débil (sin garantizar la integridad) al elemento de ``Contenido`` real al que apunta, tu trabajo es elegir la que sea más adecuada en tu escenario. Puedes encontrar más información y referencias en la página de la documentación del `PHPCR de Doctrine `_. - -``MultilangMenuNode`` extiende al ``MenuNode`` con apoyo multilingüe. Añade un campo ``locale`` para identificar qué traducción pertenece a cada menú, más una ``etiqueta`` y una ``uri`` en los campos marcados como ``translated=true``, lo cual significa que diferirán entre traducciones, a diferencia de los otros campos. - -También especifica la estrategia utilizada para almacenar múltiples traducciones en la base de datos: - -.. configuration-block:: - - .. code-block:: php-annotations - - /** - * @PHPCRODM\Document(translator="attribute") - */ - -For information on the available translation strategies, refer to the Doctrine -page regarding `Multi language support in PHPCR-ODM `_ - - -Admin Support -------------- - -``MenuBundle`` also includes the administration panels and respective services -needed for integration with the backend admin tool :doc:`SonataDoctrinePhpcrAdminBundle <../bundles/doctrine_phpcr_admin>` - -The included administration panels will automatically available but need to be -explicitly put on the dashboard if you want to use them. See :doc:`../tutorials/creating-cms-using-cmf-and-sonata` -for instructions on how to install SonataDoctrinePhpcrAdminBundle. - - -Configurando ------------- - -Este paquete se configura usando un conjunto de parámetros, pero todos ellos son opcionales. You can go to the :doc:`../bundles/menu` reference page for the -full configuration options list and additional information. - -Further Notes -------------- - -Para más información sobre el ``MenuBundle`` del ``CMF`` de *Symfony*, por favor consulta: - -- :doc:`../bundles/menu` for advanced details and configuration reference -- `KnpMenuBundle`_ page for information on the bundle on which ``MenuBundle`` relies -- `KnpMenu `_ page for information on the underlying library used by ``KnpMenuBundle`` diff --git a/_sources/cmf/getting-started/overview.txt b/_sources/cmf/getting-started/overview.txt deleted file mode 100644 index 9274697..0000000 --- a/_sources/cmf/getting-started/overview.txt +++ /dev/null @@ -1,27 +0,0 @@ -Información general -=================== - -Esta guía te ayudará a entender las partes básicas de la edición estándar del ``CMF`` de *Symfony* (*EE*) y cómo trabajan juntas para proporcionar las páginas predefinidas que puedes ver al explorar la instalación de la Edición estándar del ``CMF`` de *Symfony*. - -Se supone que ya has instalado la edición estándar del ``CMF`` de *Symfony* y has leído cuidadosamente el libro de *Symfony2*. - -.. note:: - - Para otras guías de instalación del ``CMF`` de *Symfony*, por favor, consulta: - - El artículo :doc:`../cookbook/installing-cmf-sandbox` en el recetario para instrucciones sobre cómo instalar un ejemplo de una demostración más completa del ``CMF`` de *Symfony*. - - :doc:`../tutorials/installing-cmf-core` para instrucciones de instalación paso a paso y detalles de configuración de los componentes necesarios del núcleo en una aplicación de *Symfony* existente. - -``AcmeMainBundle`` y ``SimpleCMSBundle`` ----------------------------------------- - -La *EE* del ``CMF`` de *Symfony* viene con un ``AcmeMainBundle`` predefinido para ayudarte a empezar, en una manera similar al ``AcmeDemoBundle`` que tiene *Symfony2*, proporcionándote algunas páginas de demostración visibles en tu navegador. Sin embargo, el ``AcmeMainBundle`` no incluye controladores o archivos de configuración, como probablemente esperarías. Este contiene poco más que un archivo *Twig* y datos `Accesorios `_, que fueron cargados a tu base de datos durante la instalación. - -Hay varios paquetes trabajando juntos para convertir los datos accesorios en un sitio web navegable. El proceso global simplificado, es el siguiente: - -- Al recibir una petición, :doc:`/components/routing` del ``CMF`` de *Symfony*, el Enrutador dinámico se usa para manejar la petición entrante. -- El Enrutador dinámico es capaz de emparejar la *URL* solicitada con el contenido de un ``ContentBundle`` específico almacenado en la base de datos. -- La información del contenido recuperado se usa para determinar a cuál controlador pasarlo, y qué plantilla utilizar. -- Tal cual esté configurado, el contenido recuperado se pasa al ``ContentController`` del ``ContentBundle``, el cual lo manejará y reproducirá la plantilla :file:`layout.html.twig` del ``AcmeMainBundle``. - - Una vez más, esto es un vistazo simplificado de un muy sencillo *CMS* construido en lo alto del ``CMF`` de *Symfony*. - Para entender completamente todas las posibilidades del ``CMF``, es necesario darle un muy cuidadoso vistazo a cada componente. \ No newline at end of file diff --git a/_sources/cmf/getting-started/routing.txt b/_sources/cmf/getting-started/routing.txt deleted file mode 100644 index d1eea20..0000000 --- a/_sources/cmf/getting-started/routing.txt +++ /dev/null @@ -1,439 +0,0 @@ -.. index:: - single: Routing, SymfonyCmfRoutingExtraBundle - -Enrutando -========= - -Esta es una introducción para entender los conceptos detrás del enrutado del *CMF*. Para la documentación de referencia por favor ve :doc:`../components/routing` y :doc:`../bundles/routing-extra`. - -Concepto --------- - -Why a new Routing Mechanism? -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Los *CMS* son sitios altamente dinámicos, donde la mayoría del contenido lo gestionan los administradores en lugar de los desarrolladores. El número de páginas disponibles fácilmente puede alcanzar miles, lo cual normalmente es multiplicado por el número de traducciones disponibles. Mejor accesibilidad y prácticas *SEO*, así como preferencias de usuario dictan que direcciones *URL* deberían ser definibles por los gestores de contenido. - -El mecanismo de enrutado predefinido de *Symfony2*, con enfoque de archivos de configuración, no es la mejor solución para este problema, puesto que no es apropiado para manejar rutas dinámicas definidas por el usuario, ni escalan bien para un gran número de rutas. - -The Solution -~~~~~~~~~~~~ - -Para afrontar estos problemas, se desarrolló un nuevo sistema de enrutado, este tiene en cuenta las necesidades típicas de enrutado de un *CMS*: - -- User defined URLs; -- Multi-site; -- Multi-language; -- Tree-like structure for easier management; -- Contenido, Menú y separación de ``Rutas`` para flexibilidad adicional. - -Con estos requisitos en mente, fue desarrollado el componente ``Routing`` del ``CMF`` de *Symfony*. - -La ``ChainRouter`` ------------------- - -En el núcleo del ``CMF`` de *Symfony* el componente de enrutado es la ``ChainRouter``. -Esta se utiliza como sustituta para el sistema de enrutado predefinido de *Symfony2* y, como tal, es responsable de determinar cuál ``Controlador`` manejará cada ``petición``. - -The ``ChainRouter`` works by accepting a set of prioritized routing strategies, -:class:`Symfony\\Component\\Routing\\RouterInterface` implementations, -commonly referred to as "Routers". The routers are responsible for matching an -incoming request to an actual Controller and, to do so, the ``ChainRouter`` -iterates over the configured Routers according to their configured priority: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - chain: - routers_by_id: - # enable the DynamicRouter with high priority to allow overwriting - # configured routes with content - symfony_cmf_routing_extra.dynamic_router: 200 - - # activa el enrutador predefinido de symfony con - # baja prioridad - router.default: 100 - - .. code-block:: xml - - - - - - 200 - - - - 100 - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_routing_extra', array( - 'chain' => array( - 'routers_by_id' => array( - 'symfony_cmf_routing_extra.dynamic_router' => 200, - 'router.default' => 100, - ), - ), - )); - -You can also load Routers using tagged services, by using the ``router`` tag -and an optional ``priority``. Mientras más alta prioridad, más temprano será consultado tu enrutador para emparejar la ruta. Si no especificas la prioridad, tu enrutador vendrá al último. Si hay varios enrutadores con la misma prioridad, el orden entre ellos es indeterminado. El servicio etiquetado se verá como este: - -.. configuration-block:: - - .. code-block:: yaml - - services: - my_namespace.my_router: - class: "%my_namespace.my_router_class%" - tags: - - { name: router, priority: 300 } - - .. code-block:: xml - - - - - - - .. code-block:: php - - $container - ->register('my_namespace.my_router', '%my_namespace.my_router_class%') - ->addTag('router', array('priority' => 300)) - ; - -El sistema de enrutado del ``CMF`` de *Symfony* añade un nuevo ``DynamicRouter``, el cual complementa el ``Router`` predefinido de *Symfony2*. - -The Default Symfony2 Router ---------------------------- - -A pesar de que reemplaza el mecanismo de enrutado predefinido, el ``Routing`` del ``CMF`` de *Symfony* te permite seguir utilizando el sistema existente. De hecho, el enrutado predefinido está habilitado por omisión, así que puedes seguir utilizando las rutas que declaraste en tus archivos de configuración, o como fueron declaradas por otros paquetes. - -.. _start-routing-dynamic-router: - -El ``DynamicRouter`` --------------------- - -Este enrutador puede cargar instancias de ``Ruta`` dinámicamente desde un determinado proveedor. Luego usa un proceso para emparejar la petición entrante a una ``Ruta`` específica, la cual en turno suele determinar a qué ``Controlador`` enviar la petición. - -La configuración predefinida del paquete declara que el ``DynamicRouter`` está inhabilitado -por omisión. Para activarlo, sólo añade lo siguiente a tu archivo de configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - enabled: true - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_routing_extra', array( - 'dynamic' => array( - 'enabled' => true, - ), - )); - -Esta es la configuración mínima requirida para cargar el ``DynamicRouter`` como servicio, esta lo capacita para realizar cualquier enrutamiento. De hecho, cuándo exploras las páginas predefinidas que vienen con la *EE* del ``CMF`` de *Symfony*, el ``DynamicRouter`` es el que empareja tus peticiones con los Controladores y Plantillas. - -.. _start-routing-getting-route-object: - -Getting the Route Object -~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes configurar el proveedor a usar para adaptarlo a las necesidades de cada implementación, este debe implementar la ``RouteProviderInterface``. Como parte de este paquete, se proporciona una implementación para el `PHPCR-ODM `_, pero fácilmente puedes crear una propia, puesto que el ``Enrutador`` es de almacenamiento agnóstico. El proveedor predefinido carga la ruta como el camino en la petición y todas las rutas padre permiten que algunos segmentos de la ruta sean parámetros. - -Para información más detallada sobre esta implementación y cómo la puedes personalizar o extender, consulta el :doc:`../bundles/routing-extra`. - -El ``DynamicRouter`` es capaz de emparejar la petición entrante con un objeto ``Ruta`` del proveedor subyacente. Los detalles sobre cómo se lleva a cabo el proceso de emparejamiento se pueden encontrar en :doc:`../components/routing`. - -.. note:: - - Para hacer que el proveedor de rutas encuentre rutas, también necesitas proporcionar los datos en tu almacenamiento. Con *PHPCR-ODM*, esto se hace a través de la interfaz de admininistración (ve más adelante) o con accesorios. - - No obstante, antes de poder explicar cómo hacerlo, necesitas entender cómo trabaja el ``DynamicRouter``. An example will come :ref:`later in this document `. - -.. _start-routing-getting-controller-template: - -Consiguiendo el controlador y la plantilla -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Una ``Ruta`` necesita especificar cuál ``Controlador`` debería manejar una ``Petición`` específica. -El ``DynamicRouter`` utiliza uno de varios métodos posibles para determinarlo (por orden de precedencia): - -- Explicito: The stored Route document itself can explicitly declare the target - Controller by specifying the '_controller' value in ``getRouteDefaults()``. -- Por alias: the Route returns a 'type' value in ``getRouteDefaults()``, - which is then matched against the provided configuration from config.yml -- By class: requires the Route instance to implement ``RouteObjectInterface`` - and return an object for ``getRouteContent()``. The returned class type is - then matched against the provided configuration from config.yml. -- Predefinido: Si está configurado, utilizará un controlador predefinido. - -Apart from this, the ``DynamicRouter`` is also capable of dynamically specifying -which Template will be used, in a similar way to the one used to determine -the Controller (in order of precedence): - -- Explicito: The stored Route document itself can explicitly declare the target - Template in ``getRouteDefaults()``. -- Por clase: requires the Route instance to implement ``RouteObjectInterface`` - and return an object for ``getRouteContent()``. The returned class type is - then matched against the provided configuration from config.yml. - -Aquí tienes un ejemplo sobre cómo configurar las opciones mencionadas anteriormente: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - generic_controller: symfony_cmf_content.controller:indexAction - controllers_by_type: - editablestatic: sandbox_main.controller:indexAction - controllers_by_class: - Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: symfony_cmf_content.controller::indexAction - templates_by_class: - Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: SymfonyCmfContentBundle:StaticContent:index.html.twig - - .. code-block:: xml - - - - - - sandbox_main.controller:indexAction - - - - symfony_cmf_content.controller::indexAction - - - - SymfonyCmfContentBundle:StaticContent:index.html.twig - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_routing_extra', array( - 'dynamic' => array( - 'generic_controller' => 'symfony_cmf_content.controller:indexAction', - 'controllers_by_type' => array( - 'editablestatic' => 'sandbox_main.controller:indexAction', - ), - 'controllers_by_class' => array( - 'Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent' => 'symfony_cmf_content.controller::indexAction', - ), - 'templates_by_class' => array( - 'Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent' => 'SymfonyCmfContentBundle:StaticContent:index.html.twig', - ), - ), - )); - -Ten en cuenta que ``enabled: true`` ya no está presente. It's only required if -no other configuration parameter is provided. The router is automatically -enabled as soon as you add any other configuration to the ``dynamic`` entry. - -.. note:: - - Internamente, el componente ``Routing`` asocia estas opciones de configuración a varias instancias de la ``RouteEnhancerInterface``. El alcance real de estos potenciadores es mucho mayor, y puedes encontrar más información sobre ellos en la página :doc:`../components/routing` de la documentación. - -.. _start-routing-linking-a-route-with-a-model-instance: - -Linking a Route with a Model Instance -------------------------------------- - -Dependiendo de la lógica de tu aplicación, una *URL* solicitada puede tener una instancia -del modelo asociado en la base de datos. Estas ``Rutas`` pueden implementar la ``RouteObjectInterface``, y opcionalmente regresar una instancia del modelo, esta automáticamente será pasada al ``Controlador`` como la variable ``$contentDocument``, si la declaras como parámetro. - -Ten en cuenta que una ``Ruta`` puede implementar la interfaz mencionada anteriormente pero todavía no regresar ninguna instancia del modelo, en cuyo caso ningún objeto asociado será proporcionado. - -Además, las ``Rutas`` que implementen esta interfaz también pueden tener un nombre de ``Ruta`` personalizado, en vez del predefinido compatible con el núcleo de *Symfony*, y pueden contener -cualquier carácter. Esto te permite, por ejemplo, poner una ruta como el nombre de la ruta. - -Redirecciones -------------- - -Puedes construir redirecciones implementando la ``RedirectRouteInterface``. -Si estás utilizando el proveedor de ruta ``PHPCR-ODM`` predefinido, uno listo para usar la implementación es proporcionado en el ``Documento`` ``RedirectRoute``. Este puede redirigir o bien a una *URI* absoluta, a una ``Ruta`` nombrada que puede generar cualquier ``Enrutador`` en la cadena o a otro objeto ``Ruta`` conocido por el proveedor de rutas. La redirección real es manejada por un ``Controlador`` específico, el cual puedes configurar como gustes: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - controllers_by_class: - Symfony\Cmf\Component\Routing\RedirectRouteInterface: symfony_cmf_routing_extra.redirect_controller:redirectAction - - .. code-block:: xml - - - - - symfony_cmf_routing_extra.redirect_controller:redirectAction - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_routing_extra', array( - 'controllers_by_class' => array( - 'Symfony\Cmf\Component\Routing\RedirectRouteInterface' => 'symfony_cmf_routing_extra.redirect_controller:redirectAction', - ), - )); - -.. note:: - - The actual configuration for this association exists as a service, not as part of - a ``config.yml`` file. Como se explicó antes, puedes utilizar cualquier enfoque. - -URL Generation --------------- - -El componente de enrutado del ``CMF`` de *Symfony* utiliza los componentes predefinidos de *Symfony2* para manejar la generación de rutas, así que puedes utilizar los métodos predefinidos para generar tus *url*, con unas cuantas posibilidades añadidas: - -* Pass either an implementation of ``RouteObjectInterface`` or a - ``RouteAwareInterface`` as ``name`` parameter -* Or supply an implementation of ``ContentRepositoryInterface`` and the id of - the model instance as parameter ``content_id`` - -The route generation handles locales as well, see :ref:`component-route-generator-and-locales`. - -.. _start-routing-document: - -The PHPCR-ODM Route Document ----------------------------- - -Como se mencionó arriba, puedes utilizar cualquier proveedor de rutas. El ejemplo en esta sección aplica si utilizas el proveedor de rutas *PHPCR-ODM* predefinido. - -Todas las rutas están localizadas bajo una ruta configurada como la raíz, por ejemplo ``'/cms/rutas'``. -A new route can be created in PHP code as follows:: - - use Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route; - - $route = new Route; - $route->setParent($dm->find(null, '/routes')); - $route->setName('projects'); - - // enlaza un contenido a la ruta - $content = new Content('my content'); - $route->setRouteContent($content); - - // ahora configura algún parámetro, no olvides la barra inclinada inicial si - // quieres /proyectos/{id} y no /proyectos{id} - $route->setVariablePattern('/{id}'); - $route->setRequirement('id', '\d+'); - $route->setDefault('id', 1); - -This will give you a document that matches the URL ``/projects/`` but -also ``/projects`` as there is a default for the id parameter. - -Your controller can expect the ``$id`` parameter as well as the -``$contentDocument`` as we set a content on the route. The content could be -used to define an intro section that is the same for each project or other -shared data. If you don't need content, you can just not set it in the -document. - -For more details, see the :ref:`route document section in the RoutingExtraBundle documentation `. - - -Integrando con *SonataAdmin* ----------------------------- - -Si en la sección ``require`` del archivo :file:`composer.json` añades el ``sonata-project/doctrine-phpcr-admin-bundle``, los documentos de ruta serán expuestos en el ``SonataDoctrinePhpcrAdminBundle``. -Para instrucciones sobre cómo configurar este paquete ve :doc:`../bundles/doctrine_phpcr_admin`. - -De manera predefinida, ``use_sonata_admin`` se pone automáticamente basándose en si ``SonataDoctrinePhpcrAdminBundle`` está disponible pero lo puedes desactivar explícitamente si no tienes habilitado sonata, o activarlo explícitamente para conseguir un error si sonata se vuelve inasequible. - -Tienes un par de opciones de configuración para la administración. El ``content_basepath`` apunta a la raíz de tus documentos de contenido. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - use_sonata_admin: auto # usa true/false para forzar el uso / no uso de - # la administración de sonata - content_basepath: ~ # usado con la administración de sonata para - # manejar el contenido, por omisión a - # symfony_cmf_core.content_basepath - - .. code-block:: xml - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_routing_extra', array( - 'use_sonata_admin' => 'auto', - 'content_basepath' => null, - )); - -Términos del tipo ``Form`` --------------------------- - -El paquete define un tipo ``form`` que puedes utilizar para la clásica casilla de verificación «aceptar términos» donde colocas las *url* en la etiqueta. Simply specify -``symfony_cmf_routing_extra_terms_form_type`` as the form type name and specify -a label and an array with ``content_ids`` in the options:: - - $form->add('terms', 'symfony_cmf_routing_extra_terms_form_type', array( - 'label' => 'I have seen the Team and More pages ...', - 'content_ids' => array( - '%team%' => '/cms/content/static/team', - '%more%' => '/cms/content/static/more' - ), - )); - -El tipo ``form`` automáticamente genera las rutas para el contenido especificado y pasa las rutas al ayudante ``trans`` de *Twig* para sustituirlas en la etiqueta. - -Further Notes -------------- - -Para más información sobre el componente ``Routing`` del ``CMF`` de *Symfony*, por favor, consulta: - -- :doc:`../components/routing` for most of the actual functionality implementation -- :doc:`../bundles/routing-extra` for Symfony2 integration bundle for Routing Bundle -- Symfony2's `Routing `_ component page -- :doc:`../tutorials/handling-multilang-documents` for some notes on multilingual routing diff --git a/_sources/cmf/getting-started/simplecms.txt b/_sources/cmf/getting-started/simplecms.txt deleted file mode 100644 index a889e81..0000000 --- a/_sources/cmf/getting-started/simplecms.txt +++ /dev/null @@ -1,374 +0,0 @@ -.. index:: - single: SimpleCMS, SymfonyCmfSimpleCMSBundle - -SimpleCMS -========= - -Concepto --------- - -In the previous documentation pages all the basic components of Symfony CMF -have been analysed: the :doc:`routing` that allows you to associate URLs -with your :doc:`content`, which users can browse using a :doc:`menu`. - -These three components complement each other but are independent: they work -without each other, allowing you to choose which ones you want to use, extend -or ignore. In some cases, however, you might just want a simple implementation -that gathers all those functionalities in a ready-to-go package. For that -purpose, the ``SimpleCMSBundle`` was created. - - -SimpleCMSBundle ---------------- - -``SimpleCMSBundle`` is implemented on top of most of the other Symfony CMF -Bundles, combining them into a functional CMS. It's a simple solution, but -you will find it very useful when you start implementing your own CMS using -Symfony CMF. Whether you decide to extend or replace it, it's up to you, -but in both cases, it's a good place to start developing your first CMS. - - -Page -~~~~ - -``SimpleCMSBundle`` basic content type is ``Page``. Its class declaration -points out many of the features available: - -- It extends ``Route``, meaning it's not only a ``Content`` instance, but - also a ``Route``. In this case, as declared in ``getRouteContent()``, the - ``Route`` as an associated content, itself. -- It implements ``RouteAwareInterface``, which means it has associated ``Route`` - instances. As expected, and as seen in ``getRoutes()``, it has only one ``Route`` - associated: itself. -- It implements ``NodeInterface``, which means it can be used by ``MenuBundle`` - to generate a menu structure. - - -The class itself is similar to the ``StaticContent`` already described in -the documentation page regarding :doc:`content`, although some key atributes, -like ``parent`` or ``path`` come from the ``Route`` class it extends. - - -Three-in-one -~~~~~~~~~~~~ - -Like explained before, this bundle gathers functionality from three distinct -bundles: :doc:`content`, :doc:`routing` and :doc:`menu`. The routing component -receives a request, that it matches to a ``Route`` instance loaded from database. -That ``Route`` points to a ``Content`` instance: itself. A controller is -also determined by the routing component, that renders the ``Content`` using -a template which, in turn, presents the user with a HTML visualization of -the stored information tree structure, rendered using ``MenuItem`` obtained -from equivalent ``NodeInterface`` instances. - -``SimpleCMSBundle`` simplifies this process: ``Content``, ``Route`` and ``NodeInterface`` -are gathered in one class: ``Page``. This three-in-one approach is the key -concept behind this bundle. - - -MultilangPage -~~~~~~~~~~~~~ - -Like you would expect, a multilanguage version of ``Page`` is also included. -``MultilangPage`` defines a ``locale`` variable and which fields will be -translated (``title``, ``label`` and ``body``). It also includes ``getStaticPrefix()`` -to handle the path prefix of the ``Page``. This is part of the route handling -mechanism, and will be analysed bellow. - - The ``MultilangPage`` uses the ``attribute`` strategy for translation: the - several translations coexist in the same database entry, and the several - translated versions of each field are stored as different attributes in - that same entry. - - As the routing is not separated from the content, it is not possible to - create different routes for different languages. This is one of the biggest - disadvantages of the ``SimpleCmsBundle``. - -Configuring the Content Class -............................. - -By default, ``SimpleCMSBundle`` will use ``Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page`` -as the content class if multilanguage is not enabled (default). If no other -class is chosen, and multilanguage support is enabled, it will automatically -switch to ``Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangPage``. -You can explicitly specify your content class and/or enable multilanguage -support using the configuration parameters: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - document_class: ~ # Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page - multilang: - locales: ~ # defaults to [], declare your locales here to enable multilanguage - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_simple_cms', array( - 'document_class' => null, - 'multilang' => array( - 'locales' => null, - ), - )); - - -SimpleCMSBundle in Detail -------------------------- - -Now that you understand what ``SimpleCMSBundle`` does, we'll detail how it -does it. Several other components are part of this bundle, that change the -default behaviour of its dependencies. - - -The Routing -~~~~~~~~~~~ - -``SimpleCMSBundle`` doesn't add much functionality to the routing part of -Symfony CMF. Instead, it greatly relies on ``RoutingExtraBundle`` and its -set of configurable functionalities to meet its requirements. It declares -an independent ``DynamicRouter``, with it's own specific ``RouteProvider``, -``NestedMatcher``, Enhancers set and other useful services, all of them instances -of the classes bundled with ``RoutingBundle`` and ``RoutingExtraBudle``. -This service declaration duplication allows you to reuse the original ``RoutingExtraBundle`` -configuration options to declare another Router, if you wish to do so. - -The only exception to this is ``RouteProvider``: the ``SimpleCMSBundle`` -has its own strategy to retrieve ``Route`` instances from database. This -is related with the way ``Route`` instances are stored in database by ``RoutingExtraBundle``. -By default, the ``path`` parameter will hold the prefixed full URI, including -the locale identifier. This would mean an independent ``Route`` instance -should exist for each translation of the same ``Content``. However, as we've -seen, ``MultilangPage```stores all translations in the same entry. So, to -avoid duplication, the locale prefix is stripped from the URI prior to persistance, -and ``SimpleCMSBundle`` includes ``MultilangRouteProvider``, which is responsible -for fetching ``Route`` instances taking that into account. - -When rendering the actual URL from ``Route``, the locale prefix needs to be -put back, otherwise the resulting addresses wouldn't specify the locale they -refer to. To do so, ``MultilangPage`` uses the already mentioned ``getStaticPrefix()`` -implementation. - -Exemplifying: An incoming request for ``contact`` would be prefixed with -``/cms/simple`` basepath, and the storage would be queried for ``/cms/simple/contact/``. -However, in a multilanguage setup, the locale is prefixed to the URI, resulting -in a query either for ``/cms/simple/en/contact/`` or ``/cms/simple/de/contact/``, -which would require two independent entries to exist for the same actual -content. With the above mentioned approach, the ``locale`` is stripped from -the URI prior to ``basepath`` prepending, resulting in a query for ``/cms/simple/contact/`` -in both cases. - - -Routes and Redirections -....................... - -``SimpleCMSBundle`` includes ``MultilangRoute`` and ``MultilangRedirectRoute``, -extensions to the ``Route`` and ``RedirectRoute`` found in ``RoutingExtraBudle``, -but with the necessary changes to handle the prefix strategy discussed earlier. - - -Content Handling -~~~~~~~~~~~~~~~~ - -``Route`` instances are responsible for determining which ``Controller`` -will handle the current request. :ref:`start-routing-getting-controller-template` -shows how Symfony CMF SE can determine which ``Controller`` to use when rendering -a certain content, and ``SimpleCMSBundle`` uses these mechanisms to do so. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - generic_controller: ~ # symfony_cmf_content.controller:indexAction - - .. code-block:: xml - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_simple_cms', array( - 'generic_controller' => null, - )); - -By default, it uses the above mentioned service, which instanciates ``ContentController`` -from ``ContentBundle``. The default configuration associates all ``document_class`` -instances with this ``Controller``, and specifies no default template. However, -you can configure several ``controllers_by_class`` and ``templates_by_class`` -rules, which will associate, respectively, ``Controller`` and templates to -a specific Content type. Symfony CMF SE includes an example of both in its -default configuration. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - routing: - templates_by_class: - Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page: SymfonyCmfSimpleCmsBundle:Page:index.html.twig - controllers_by_class: - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute: symfony_cmf_routing_extra.redirect_controller:redirectAction - - .. code-block:: xml - - - - - - SymfonyCmfSimpleCmsBundle:Page:index.html.twig - - symfony_cmf_routing_extra.redirect_controller:redirectAction - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_simple_cms', array( - 'routing' => array( - 'templates_by_class' => array( - 'Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page' => SymfonyCmfSimpleCmsBundle:Page:index.html.twig, - 'Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute' => 'symfony_cmf_routing_extra.redirect_controller:redirectAction', - ), - ), - )); - -These configuration parameters will be used to instantiate :ref:`Route Enhancers `. -More information about them can be found in the :doc:`../components/routing` -component documentation page. - -These specific example determines that content instances of class ``Page`` -will be rendered using the above mentioned template, if no other is explicitly -provided by the associated ``Route`` (which, in this case, is ``Page`` itself). -It also states that all contents that instantiate ``RedirectRoute`` will -be rendered using the mentioned ``Controller`` instead of the default. Again, -the actual ``Route`` can provided a controller, in will take priority over -this one. Both the template and the controller are part of ``SimpleCMSBundle``. - - -Menu Generation -~~~~~~~~~~~~~~~ - -Like mentioned before, ``Page`` implements ``NodeInterface``, which means -it can be used to generate ``MenuItem`` that will, in turn, be rendered into -HTML menus presented to the user. - -To do so, the default ``MenuBundle`` mechanisms are used, only a custom ``basepath`` -is provided to the ``PHPCRMenuProvider`` instance. This is defined in ``SimpleCMSBundle`` -configuration options, and used when handling content storage, to support -functionality as described in :doc:`menu` documentation. This parameter is -optional, can be configured like so: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - use_menu: ~ # defaults to auto , true/false can be used to force providing / not providing a menu - basepath: ~ # /cms/simple - - .. code-block:: xml - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_simple_cms', array( - 'use_menu' => null, - 'basepath' => null, - )); - - -Admin Support -------------- - -``SimpleCMSBundle`` also includes the administration panel and respective -service needed for integration with `SonataDoctrinePHPCRAdminBundle `_, -a backoffice generation tool that can be installed with Symfony CMF. Para más información sobre esta, por favor consulta la sección de documentación del `paquete `_. - -Las interfaces de administración incluidas serán cargadas automáticamente si instalas el ``SonataDoctrinePHPCRAdminBundle`` (consulta :doc:`../tutorials/creating-cms-using-cmf-and-sonata` para instrucciones sobre cómo hacerlo). You can change this behaviour with the -following configuration option: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - use_sonata_admin: ~ # defaults to auto , true/false can be used to using / not using SonataAdmin - - .. code-block:: xml - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('symfony_cmf_simple_cms', array( - 'use_sonata_admin' => null, - )); - - -Fixtures --------- - -``SimpleCMSBundle`` includes a support class for integration with `DoctrineFixturesBundle `_, -aimed at making loading initial data easier. A working example is provided -in Symfony CMF SE, that illustrates how you can easily generate ``MultilangPage`` -and ``MultilangMenuNode`` instances from yml files. - - -Configurando ------------- - -Este paquete se configura usando un conjunto de parámetros, pero todos ellos son opcionales. You can go to the :doc:`../bundles/simple-cms` reference page for the -full configuration options list and aditional information. - -Further Notes -------------- - -For more information on the SimpleCMSBundle, please refer to: - -- :doc:`../bundles/simple-cms` for configuration reference and advanced details - about the bundle. -- :doc:`../getting-started/routing` for information about the routing component - in which ``SimpleCMSBundle`` is based on. -- :doc:`../getting-started/content` for information about the base content - bundle that ``SimpleCMSBundle`` depends on. -- :doc:`../getting-started/menu` for information about the menu system used - by ``SimpleCMSBundle``. diff --git a/_sources/cmf/index.txt b/_sources/cmf/index.txt deleted file mode 100644 index 45e526a..0000000 --- a/_sources/cmf/index.txt +++ /dev/null @@ -1,126 +0,0 @@ -Documentación del ``CMF`` de *Symfony* -====================================== - -Bienvenido a la documentación oficial del `Symfony Content Management Framework`_ (``CMF`` en adelante). - -El proyecto ``CMF`` de *Symfony2* está organizado por la comunidad de *Symfony* y cuenta con muchas compañías patrocinadoras y prominentes líderes del código abierto que implementan la filosofía del `CMS desacoplado`_. Puedes leer y aprender más del proyecto en su página de `información`_. - -Esta documentación actualmente está en desarrollo y todavía muy lejos de completarse. Ve `planificación de la documentación`_ para un vistazo general del trabajo que falta hacer. ¿Quieres ayudar? ¡Gracias, toda ayuda es muy apreciada! -La fuente de `la documentación está alojada en github`_. - -Declaración de misión ---------------------- - - El proyecto ``CMF`` de *Symfony* facilita a los desarrolladores la adición de funcionalidad *CMS* a sus aplicaciones construidas con la plataforma *Symfony2* de *PHP*. Los principios de desarrollo clave para el conjunto de paquetes proporcionados son la escalabilidad, usabilidad, documentación y un completo banco de pruebas. - -¿Por qué otro *CMS*? --------------------- - -De hecho, consideramos que este proyecto es un ``CMF`` (por **content management framework**) un **marco para gestionar contenido**, más que -un *CMS* (sistema de administración de contenido). La razón es que sólo estamos **proporcionando herramientas para construir un CMS personalizado**. Evidentemente hoy día existen muchas soluciones *CMS* disponibles, pero tienden a ser adaptadas en primer lugar hacia usuarios finales y también muchas tienden -a llevar mucho equipaje delegado que las hace menos que **ideales para desarrollar aplicaciones altamente personalizables** tal como es posible con `Symfony2`_. - -¿A quién está dirigido? ------------------------ - -Básicamente hay dos audiencias principales: - -#. Developers that have built an existing custom application with Symfony2 and need a fast - way to add support for content management. Be it sophisticated CMS features like semantic - content, inline editing, multi-channel delivery etc. or just a few content pages for things - like the about/contact pages. - -#. Developers that need to build a highly customized authoring and content delivery - solution that no out-of-the-box CMS can properly provide through customization alone. - - -Cómo empezar ------------- - -¿Empiezas a conocer el ``CMF``? ¿Quieres saber si el ``CMF`` es adecuado para tu proyecto? Comienza aquí. - -.. toctree:: - :maxdepth: 1 - - getting-started/installing-symfony-cmf - getting-started/routing - getting-started/content - getting-started/menu - getting-started/simplecms - - -Guías rápidas -------------- - -¿Quieres saber más sobre el ``CMF`` y cómo puedes configurar cada parte? Hay una guía para cada una de ellas. - -.. toctree:: - :maxdepth: 1 - - tutorials/choosing-a-storage-layer - tutorials/installing-cmf-core - tutorials/installing-configuring-doctrine-phpcr-odm - tutorials/installing-configuring-inline-editing - tutorials/creating-cms-using-cmf-and-sonata - tutorials/using-blockbundle-and-contentbundle - tutorials/handling-multilang-documents - -Paquetes --------- - -¿Buscando algúna información detallada sobre un paquete del ``CMF``? ¿Quieres una lista de todas las opciones de configuración de un paquete? ¿Quiere saber si puedes utilizar un paquete independientemente y cómo hacerlo? En este caso la referencia es el sitio ideal para ti. - -.. toctree:: - :maxdepth: 1 - - bundles/block - bundles/blog - bundles/content - bundles/core - bundles/create - bundles/phpcr-odm - bundles/menu - bundles/routing-extra - bundles/routing_auto - bundles/search - bundles/simple-cms - bundles/doctrine_phpcr_admin - bundles/tree-browser - -Recetario ---------- - -Soluciones específicas para necesidades especiales que van más allá del uso estándar. - -.. toctree:: - :maxdepth: 1 - - cookbook/phpcr-odm-custom-documentclass-mapper - cookbook/using-a-custom-route-repository - cookbook/installing-cmf-sandbox - -Componentes ------------ - -¿Buscando alguna información sobre los componentes de bajo nivel del ``CMF``? - -.. toctree:: - :maxdepth: 1 - - components/routing - -Colaborando ------------ - -.. toctree:: - :maxdepth: 1 - - contributing/code - contributing/license - -.. _`CMS desacoplado`: http://decoupledcms.org -.. _`Symfony2`: http://symfony.com -.. _`información`: http://cmf.symfony.com/about -.. _`planificación de la documentación`: https://github.com/symfony-cmf/symfony-cmf/wiki/Documentation-Planning -.. _`Symfony Content Management Framework`: http://cmf.symfony.com -.. _`la documentación está alojada en github`: https://github.com/symfony-cmf/symfony-cmf-docs diff --git a/_sources/cmf/tutorials/choosing-a-storage-layer.txt b/_sources/cmf/tutorials/choosing-a-storage-layer.txt deleted file mode 100644 index c5bcf89..0000000 --- a/_sources/cmf/tutorials/choosing-a-storage-layer.txt +++ /dev/null @@ -1,85 +0,0 @@ -Eligiendo una capa de almacenamiento -==================================== - -Cuándo construyes un *CMS*, sin duda, la elección para la capa de almacenamiento es una de las decisiones clave a tomar. Tienes que considerar muchos factores, la buena noticia es que con todos los componentes y paquetes en el ``CMF`` nos preocupamos en proporcionar los puntos de extensión necesarios para garantizar que contamos con una **capa de almacenamiento que sigue siendo agnóstica para el CMF**. - -El objetivo de esta guía es explicar las consideraciones y por qué sugerimos `PHPCR `_ y `PHPCR-ODM `_ como la base ideal para un *CMS*. Sin embargo, todos los componentes y paquetes se pueden integrar con otras soluciones con un muy pequeño esfuerzo. - -.. index:: PHPCR, ODM, ORM - -Requisitos para la capa de almacenamiento de un *CMS* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Al nivel más fundamental de un *CMS* está el almacenamiento, por lo tanto el primer requisito de un *CMS* es que debe proporcionar los medios para almacenar contenido con diferentes propiedades. - -Un *CMS* tiene muy diferentes necesidades de almacenamiento que por ejemplo un sistema para procesar órdenes. -Aun así observa que es enteramente posible y de hecho así se pretende que la iniciativa del ``CMF`` habilite a los desarrolladores para combinar el ``CMF`` con un sistema para procesar órdenes. Así por ejemplo, uno podría crear una solución de compra utilizando el ``CMF`` para almacenar el catalogo de productos, mientras utilizas otro sistema para mantener el inventario, datos del cliente y pedidos. Esto da lugar al segundo requisito, *un CMS debe proporcionar los medios para referenciar el contenido*, almacenando ambos dentro del *CMS*, pero también en otros sistemas. - -El contenido real en un *CMS* tiende a estar organizado en una estructura de árbol, imitando un sistema de archivos. Ten en cuenta que los autores de contenido podrían querer utilizar diferentes estructuras para organizar el contenido y para organizar otros aspectos como el menú y el enrutado. -Esto nos lleva al tercer requisito, *un CMS debe proporcionar los medios para representar el contenido como una estructura de árbol*. -Además, un cuarto requisito es que *un CMS debería permitir mantener varias estructuras de árbol independientes*. - -En general, los datos dentro de un *CMS* tienden a no estar estructurados. Si bien, varias páginas dentro del *CMS* podrían ser muy similares, hay una buena posibilidad de que habría muchas permutaciones que necesitarían diferentes campos extra, por lo tanto *un CMS no tiene que aplicar un esquema singular al contenido*. -Dicho esto, a fin de mantener mejor la estructura y contenido de las capas de la interfaz de usuario que genéricamente permiten la visualización de elementos de contenido, es importante ser capaz de expresar reglas opcionales que se deben seguir y que también pueden ayudar a anexar significado semántico adicional. Así que *un CMS debe proporcionar los medios para opcionalmente definir elementos del esquema de contenido*. - -Este requisito en realidad también está relacionado a otra necesidad, en que un *CMS* debe facilitar a los autores de contenido la preparación de una serie de cambios en un entorno de ensayo que luego se tiene que enviar al sitio vivo en un solo paso. Esto significa que es otro requisito en que es necesario que *un CMS debe apoyar el movimiento y exportación de contenido entre estructuras de árbol independientes*. -Ten en cuenta que la exportación puede ser útil también para las copias de seguridad. - -Al realizar cambios en ella sin embargo también sería útil poder versionar los conjuntos cambiados, de manera que permanezcan disponibles para fines históricos, pero también para poder revertirlos cuando sea necesario. Por lo tanto, el siguiente requisito es que un *CMS debería proporcionar la habilidad de versionar el contenido*. - -Puesto que vivimos en un mundo globalizado, los sitios web deben ofrecer contenido en múltiples idiomas abarcando diferentes regiones. No obstante no todas las piezas del contenido se deben traducir y eventualmente sólo algunas se deberían traducir, pero hasta entonces se le debe presentar al usuario el contenido en uno de los idiomas disponibles, por lo que *un CMS debería proporcionar la capacidad de almacenar el contenido en diferentes idiomas, con opcionales reglas alternativas*. - -Puesto que generalmente un *CMS* tiende a almacenar una creciente cantidad de contenido será necesario proporcionar alguna forma para que los usuarios busquen contenido, incluso, cuando el usuario sólo tiene una muy difusa idea sobre el contenido que está buscando, dando lugar al requisito de que *un CMS debe proporcionar completa capacidad de búsqueda de texto*, idealmente, aprovechando tanto la estructura del árbol de contenido como el esquema de datos. - -Otra necesidad popular es limitar la lectura y/o escritura de contenido a usuarios o grupos específicos. Idealmente, esta solución también se podría integrar con la estructura de árbol. Por lo que debería ser útil que *un CMS ofreciera funciones para definir el control de acceso que aproveche la estructura de árbol para gestionar rápidamente el acceso a subárboles completos*. - -Por último, no todos los pasos del proceso de creación de contenido los llevará a cabo la misma persona. -De hecho, puede haber múltiples pasos, todos los cuales no los debería llevar a cabo una sola persona. En cambio algunos de los pasos incluso los podría ejecutar una máquina. Así, por ejemplo un fotógrafo puede cargar una nueva imagen, un autor de contenido puede adjuntar la foto a algún texto, entonces el sistema automáticamente genera miniaturas y optimiza la interpretación en la *web*, y finalmente, un editor decide sobre la publicación final. Por lo tanto *un CMS debe proporcionar la capacidad para ayudar en la gestión del flujo de trabajo*. - -Resumen -------- - -Aquí tienes un resumen de los requisitos anteriores. Ten en cuenta que algunos de los requisitos tienen un *debe*, mientras otros sólo tienen un *debería*. Evidentemente dependiendo de tu caso de uso podrías priorizar las características de manera diferente: - -* Un *CMS* debe proporcionar un medio para almacenar contenido con diferentes propiedades -* Un *CMS* debe proporcionar un medio para referirse al contenido -* Un *CMS* debe proporcionar medio para representar el contenido como una estructura de árbol -* Un *CMS* debe proporcionar completa capacidad de búsqueda de texto -* Un *CMS* no debería aplicar un esquema singular para el contenido -* Un *CMS* debe proporcionar los medios para opcionalmente definir un esquema para elementos del contenido -* Un *CMS* debería permitir mantener varias estructuras de árbol independientes -* Un *CMS* debería ser compatible con el movimiento y exportación de contenido entre estructuras de árbol independientes -* Un *CMS* debería proporcionar la habilidad para tener contenido versionado -* Un *CMS* debería proporcionar la habilidad de almacenar contenido en diferentes idiomas, con opcionales reglas alternativas -* Un *CMS* debe proporcionar la capacidad para definir controles de acceso -* Un *CMS* debería proporcionar la capacidad para asistir en la administración de los flujos de trabajo - -*RDBMS* -~~~~~~~ - -Viendo los requisitos anteriores se pone de manifiesto que fuera de la caja un *RDBMS* es el instrumento adecuado para hacer frente a las necesidades de un *CMS*. Los *RDBMS* nunca tuvieron la intención de almacenar estructuras de árbol de contenido no estructurado. Realmente el único requisito que cubre el *RDBMS* de la lista anterior es la capacidad de almacenar contenido, alguna manera para hacer referencia al contenido, mantener múltiples estructuras de contenido independientes y un nivel básico de control de acceso y disparadores. - -Este no es un defecto del *RDBMS* en el sentido de que fueron diseñados simplemente para un caso de uso diferente: la capacidad de almacenar, manipular y agregar datos estructurados. Esto las hace ideales para el almacenamiento de inventarios y pedidos. - -Lo cual no quiere decir que es imposible construir un sistema en lo alto de un *RDBMS* que se ocupe de algunos o incluso la totalidad de los temas anteriores. Algunos *RDBMS* nativamente soportan consultas recursivas, lo cual puede ser útil para recuperar las estructuras de árbol. Incluso si falta tal soporte nativo, hay algoritmos como camino materializado y conjuntos anidados que pueden permitir un eficiente almacenamiento y recuperación de estructuras de árbol para diferentes casos de uso. - -El punto es, sin embargo, que se requieren estos algoritmos y código en lo alto de un *RDBMS* que también se vinculen a la lógica de negocio con un determinado *RDBMS* y/o algoritmo, aunque algunos de ellos se pueden abstraer. Así que de nuevo usando un *ORM* podrías crear un sistema para gestionar las estructuras de árbol con diferentes algoritmos que impidan la unión de la lógica de negocio del *CMS* a un algoritmo particular. - -Sin embargo hay que decir una vez más, que todos los paquetes y componentes del ``CMF`` se han desarrollado para aceptar cualquier *API* de almacenamiento persistente y damos la bienvenida a las contribuciones para agregar implementaciones para otros sistemas de almacenamiento. Así, por ejemplo actualmente ``RoutingExtraBundle`` sólo ofrece clases de documento para el *ODM* de *PHPCR*, pero las interfaces definidas en el componente de enrutado son de almacenamiento agnóstico y aceptaríamos una contribución para añadir soporte al *ORM* de *Doctrine*. - -*PHPCR* -~~~~~~~ - -Esencialmente *PHPCR* es un conjunto de interfaces para abordar la mayoría de los requisitos de la lista anterior. -Esto significa que *PHPCR* es totalmente independiente del almacenamiento en el sentido de que es posible realmente poner cualquier solución de persistencia detrás de *PHPCR*. Así pues, en la misma forma que un *ORM* puede soportar diferentes algoritmos de almacenamiento de árbol a través de algún complemento, *PHPCR* tiene como objetivo proporcionar una *API* para relajar completamente las necesidades del *CMS*, por lo tanto separando limpiamente toda la lógica del negocio de tu *CMS* a causa de la elección de persistencia. Como asunto natural, la única de las características anteriores no soportada nativamente por *PHPCR* es el apoyo para las traducciones. - -Gracias a la disponibilidad de varias implementaciones de *PHPCR* que apoyan diversos tipos de opciones de persistencia, la creación de un *CMS* en lo alto de *PHPCR* significa que los usuarios finales tienen la capacidad de escoger y elegir lo que funciona mejor para ellos, sus recursos, su experiencia y sus necesidades de escalabilidad. - -Así que para los casos de uso más simples por ejemplo está una solución basada en el *DBAL* de *Doctrine* ofrecida por la implementación *PHPCR* de `Jackalope `_ que puede utilizar el *RDBMS* de *SQLite* que viene con *PHP*. En el otro extremo del espectro ``Jackalope`` también es compatible con `Jackrabbit `_ el cual apoya las agrupaciones y puede manejar eficientemente los datos en cientos de gigabytes. De manera predeterminada ``Jackrabbit`` simplemente utiliza el sistema de archivos para la persistencia, pero también puede utilizar un *RDBMS*. Sin embargo, futuras versiones apoyarán a *MongoDB* y otras soluciones *NoSQL* como *CouchDB* o *Cassandra* es totalmente posible. Una vez más, el cambio de la solución de persistencia no requerirá cambios en el código puesto que la lógica de negocio sólo va unida a las interfaces *PHPCR*. - -Por favor ve :doc:`installing-configuring-doctrine-phpcr-odm` para más detalles sobre las implementaciones *PHPCR* disponibles y sus requisitos y la forma de configurar *Symfony2* con una de ellas. - -*ODM* de *PHPCR* -~~~~~~~~~~~~~~~~ - -Cuando mencione arriba utilizar *PHPCR* no significa renunciar a un *RDBMS*. En muchas maneras, puedes considerar a *PHPCR* una solución *ORM* especializada para *CMS*. No obstante, mientras *PHPCR* trabaja con los así llamados *nodos*, en un *ORM* las personas esperan ser capaces de asignar instancias de clase a una capa de persistencia. Esto, exactamente es lo que proporciona el *ODM* de *PHPCR*. Sigue las mismas clases de interfaz del *ORM* de *Doctrine* al mismo tiempo que expone todas las capacidades adicionales de *PHPCR*, como los árboles y el versionado. Por otra parte, también ofrece soporte nativo para traducciones, que cubren la única omisión del *PHPCR* de la lista de requisitos para una solución de almacenamiento de un *CMS* mencionada anteriormente. diff --git a/_sources/cmf/tutorials/creating-cms-using-cmf-and-sonata.txt b/_sources/cmf/tutorials/creating-cms-using-cmf-and-sonata.txt deleted file mode 100644 index 0936378..0000000 --- a/_sources/cmf/tutorials/creating-cms-using-cmf-and-sonata.txt +++ /dev/null @@ -1,224 +0,0 @@ -Creando un *CMS* con ``CMF`` y *Sonata* -======================================= - -El objetivo de esta guía es crear un sistema de administración de contenido sencillo que utiliza el ``CMF`` así como `SonataAdminBundle `_ y :doc:`../bundles/doctrine_phpcr_admin`. - - -.. index:: Sonata, SonataAdminBundle, SonataDoctrinePHPCRAdminBundle, SonatajQueryBundle, FOSJsRoutingBundle, TreeBundle, TreeBrowserBundle - -Requisitos previos ------------------- - -- :doc:`installing-cmf-core` -- `Symfony SecurityBundle `_ (requerido por las plantillas predefinidas del ``SonataAdminBundle``) - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "sonata-project/doctrine-phpcr-admin-bundle": "1.0.*", - } - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en el archivo :file:`app/AppKernel.php` añadiéndolos al método ``registerBundles``: - -.. code-block:: php - - public function registerBundles() - { - $bundles = array( - // ... - - // soporte para la administración - new Symfony\Cmf\Bundle\TreeBrowserBundle\SymfonyCmfTreeBrowserBundle(), - new Sonata\jQueryBundle\SonatajQueryBundle(), - new Sonata\BlockBundle\SonataBlockBundle(), - new Sonata\AdminBundle\SonataAdminBundle(), - new Sonata\DoctrinePHPCRAdminBundle\SonataDoctrinePHPCRAdminBundle(), - new FOS\JsRoutingBundle\FOSJsRoutingBundle(), - ); - // ... - } - -Configurando ------------- - -Añade los paquetes de ``sonata`` a la configuración de tu aplicación - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_block: - default_contexts: [cms] - blocks: - sonata.admin.block.admin_list: - contexts: [admin] - sonata_admin_doctrine_phpcr.tree_block: - settings: - id: '/cms' - contexts: [admin] - - sonata_admin: - templates: - # plantillas globales predefinidas - ajax: SonataAdminBundle::ajax_layout.html.twig - dashboard: - blocks: - # muestra un bloque panel - - { position: right, type: sonata.admin.block.admin_list } - - { position: left, type: sonata_admin_doctrine_phpcr.tree_block } - - sonata_doctrine_phpcr_admin: - document_tree: - Doctrine\ODM\PHPCR\Document\Generic: - valid_children: - - all - Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page: ~ - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route: - valid_children: - - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route - - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute: - valid_children: [] - Symfony\Cmf\Bundle\MenuBundle\Document\MenuNode: - valid_children: - - Symfony\Cmf\Bundle\MenuBundle\Document\MenuNode - - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuNode - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuNode: - valid_children: - - Symfony\Cmf\Bundle\MenuBundle\Document\MenuNode - - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuNode - - fos_js_routing: - routes_to_expose: - - admin_sandbox_main_editablestaticcontent_create - - admin_sandbox_main_editablestaticcontent_delete - - admin_sandbox_main_editablestaticcontent_edit - - admin_bundle_menu_menunode_create - - admin_bundle_menu_menunode_delete - - admin_bundle_menu_menunode_edit - - admin_bundle_menu_multilangmenunode_create - - admin_bundle_menu_multilangmenunode_delete - - admin_bundle_menu_multilangmenunode_edit - - admin_bundle_content_multilangstaticcontent_create - - admin_bundle_content_multilangstaticcontent_delete - - admin_bundle_content_multilangstaticcontent_edit - - admin_bundle_routingextra_route_create - - admin_bundle_routingextra_route_delete - - admin_bundle_routingextra_route_edit - - admin_bundle_simplecms_page_create - - admin_bundle_simplecms_page_delete - - admin_bundle_simplecms_page_edit - - symfony_cmf_tree_browser.phpcr_children - - symfony_cmf_tree_browser.phpcr_move - - sonata.admin.doctrine_phpcr.phpcrodm_children - - sonata.admin.doctrine_phpcr.phpcrodm_move - -Añade la ruta a la configuración de enrutado: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - admin: - resource: '@SonataAdminBundle/Resources/config/routing/sonata_admin.xml' - prefix: /admin - - sonata_admin: - resource: . - type: sonata_admin - prefix: /admin - - doctrine_phpcr_admin_bundle_odm_browser: - resource: "@SonataDoctrinePHPCRAdminBundle/Resources/config/routing/phpcrodmbrowser.xml" - - fos_js_routing: - resource: "@FOSJsRoutingBundle/Resources/config/routing/routing.xml" - - symfony_cmf_tree: - resource: . - type: 'symfony_cmf_tree' - - -Activos de ``Sonata`` ---------------------- - -.. code-block:: bash - - app/console assets:install --symlink - - -Defining own Admin classes --------------------------- - -The CMF bundles come with predefined admin classes which will be activated -automatically if Sonata PHPCR-ODM Admin is loaded. If you need to write -different admins and do not want to load the defaults, you can deactivate the -loading - see the documentation of the respective bundles. - -To load your own Admin service, you need to declare it as a service, tag with -``sonata.admin`` with ``manager_type="doctrine_phpcr"``. For the admin to work -properly, you need to add a call for method ``setRouteBuilder`` to set it to -the service ``sonata.admin.route.path_info_slashes``, or your Admin will not -work. - -The constructor expects three arguments, code, document class and controller -name. You can pass an empty argument for the code, the document class must be -the fully qualified class name of the document this admin is for and the third -argument can be used to set a custom controller that does additional operations -over the default sonata CRUD controller. - -.. configuration-block:: - - .. code-block:: xml - - - - - %my_bundle.document_class% - SonataAdminBundle:CRUD - - - - - - - -Finalmente ----------- - -Ahora ``Sonata`` está configurado para trabajar con *PHPCR*, puedes acceder al panel vía ``/admin/dashboard`` de tu sitio. - - -Tree Problems -------------- - -If you have not yet added anything to the content repository, the tree view will not load as it -cannot find a root node. To fix this, load some data as fixtures by following this doc: - -- :doc:`using-blockbundle-and-contentbundle` - -Lectura complementaria ----------------------- - -* :doc:`../bundles/doctrine_phpcr_admin` -* :doc:`handling-multilang-documents` diff --git a/_sources/cmf/tutorials/handling-multilang-documents.txt b/_sources/cmf/tutorials/handling-multilang-documents.txt deleted file mode 100644 index a01a4c3..0000000 --- a/_sources/cmf/tutorials/handling-multilang-documents.txt +++ /dev/null @@ -1,210 +0,0 @@ -Gestionando documentos multilingües -=================================== - -The goal of the tutorial is to describe all the steps that are needed -to be taken to use multi-language documents as clearly as possible. - - -Por favor, primero lee esto ---------------------------- - -* Necesitas entender cómo utilizar el *PHPCR-ODM*. Ve la introducción en :doc:`Documentación del paquete PHPCR-ODM de Doctrine <../bundles/phpcr-odm>` - - -Lunetics LocaleBundle ---------------------- - -The CMF recommends to rely on the `LuneticsLocaleBundle `_ -to handle initial locale selection when a user first visits the site, -and to provide a locale switcher. - -To install the bundle, require it in your project with ``./composer.phar require lunetics/locale-bundle`` -and then instantiate ``Lunetics\LocaleBundle\LuneticsLocaleBundle`` in your AppKernel.php. - -You also need the ``intl`` php extension installed and enabled. (Otherwise -composer will tell you it can't find ext-intl.) If you get issues that some -locales can not be loaded, have a look at `this discussion about ICU `_. - -Then configure it in the main application configuration file. As -there are several CMF bundles wanting the list of allowed locales, -we recommend putting them into a parameter ``%locales%``, see the -`cmf-sandbox config.yml file `_ for an example. - -.. tip:: - - Whenever you do a sub-request, for example to call a controller from a twig - template, do not forget to pass the ``app.request.locale`` along or you will - lose the request locale and fall back to the default. - See for example the action to include the create.js javascript files in the - :ref:`create.js reference `. - -PHPCR-ODM multi-language Documents ----------------------------------- - -You can mark any properties as being translatable and have the document manager -store and load the correct language for you. Note that translation always happens -on a document level, not on the individual translatable fields. - -.. code-block:: php - - `_ -and see :ref:`bundle-phpcr-odm-multilang-config` to configure PHPCR-ODM correctly. - -Most of the CMF bundles provide multi-language documents, for example MultilangStaticContent, -MultilangMenuNode or MultilangSimpleBlock. The routing is different, as explained in the next -section. - - -Enrutado --------- - -The DynamicRouter uses a route source to get routes that could match a -request. The concept of the default PHPCR-ODM source is to map the request URL -onto an id, which in PHPCR terms is the repository path to a node. This -allows for a very efficient lookup without needing a full search over the -repository. But a PHPCR node has exactly one path, therefore we need a separate -route document for each locale. The cool thing with this is that we can localize -the URL for each language. Simply create one route document per locale, and -set a default value for _locale to point to the locale of that route. - -As all routes point to the same content, the route generator can handle picking -the correct route for you when you generate the route from the content. -See also :ref:`component-route-generator-and-locales`. - - -Sonata PHPCR-ODM Admin ----------------------- - -This section explains how to make Sonata Admin handle multi-language documents. You should -already have set up Sonata PHPCR-ODM Admin and understand how it works, see -:doc:`Creating a CMS using the CMF and Sonata `. - -.. note:: - - The following assumes that you installed the LuneticsLocaleBundle as explained above. - If you want to use something else or write your own locale handling, first think if - it would not make sense to give the Lunetics bundle a try. If you are still convinced - you will need to adapt the following template examples to your way of building a - locale switcher. - - -The first step is to configure sonata admin. We are going to place the LuneticsLocaleBundle -language switcher in the ``topnav`` bar. -To do this we need to configure the template for the "user_block" as shown below: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_admin: - ... - templates: - user_block: AcmeCoreBundle:Admin:admin_topnav.html.twig - -Y la plantilla se ve como esta - -.. code-block:: jinja - - {# src/Acme/CoreBundle/Resources/views/Admin/admin_topnav.html.twig #} - {% extends 'SonataAdminBundle:Core:user_block.html.twig' %} - - {% block user_block %} - {{ locale_switcher(null, null, 'AcmeCoreBundle:Admin:switcher_links.html.twig') }} - {{ parent() }} - {% endblock %} - -We tell the ``locale_switcher`` to use a custom template to display the links, which looks like this: - -.. code-block:: jinja - - {# src/Acme/CoreBundle/Resources/views/Admin/switcher_links.html.twig #} - Switch to : - {% for locale in locales %} - {% if loop.index > 1 %} | {% endif %}{{ locale.locale_target_language }} - {% endfor %} - - -Now what is left to do is to update the sonata routes to become locale aware: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - - admin_dashboard: - pattern: /{_locale}/admin/ - defaults: - _controller: FrameworkBundle:Redirect:redirect - route: sonata_admin_dashboard - permanent: true # este para 301 - - admin: - resource: '@SonataAdminBundle/Resources/config/routing/sonata_admin.xml' - prefix: /{_locale}/admin - - sonata_admin: - resource: . - type: sonata_admin - prefix: /{_locale}/admin - - # redirige las rutas a las rutas no regionales - admin_without_locale: - pattern: /admin - defaults: - _controller: FrameworkBundle:Redirect:redirect - route: sonata_admin_dashboard - permanent: true # este para 301 - - admin_dashboard_without_locale: - pattern: /admin/dashboard - defaults: - _controller: FrameworkBundle:Redirect:redirect - route: sonata_admin_dashboard - permanent: true # este para 301 - -When we now reload the admin dashboard, the url should be prefixed with our -default locale, for example ``/de/admin/dashboard``. When clicking on the -language switcher the page reloads and displays the correct content for the -requested language. - -The provided sonata admin classes map the locale field of the multi-language -documents to the form. You need to do the same in your admins, in order -to create new translations. Otherwise the language fallback of PHPCR-ODM will -make you update the original language, even when you request a different locale. -With the mapped locale field, the editor can chose if he needs to create a new -language version or updates the loaded one. - -Happy editing. - - -Frontend editing and multi-language ------------------------------------ - -When using the CreateBundle, you do not need to do anything at all to get -multi-language support. PHPCR-ODM will deliver the document in the requested -language, and the callback URL is generated in the request locale, -leading to save the edited document in the same language as it was loaded. - - -.. note:: - - If a translation is missing, language fallback kicks in, both when viewing the - page but also when saving the changes, so you always update the current locale. - - It would make sense to offer the user the choice whether he wants to create - a new translation or update the existing one. There is this `issue `_ - in the CreateBundle issue tracker. diff --git a/_sources/cmf/tutorials/installing-cmf-core.txt b/_sources/cmf/tutorials/installing-cmf-core.txt deleted file mode 100644 index 30a5deb..0000000 --- a/_sources/cmf/tutorials/installing-cmf-core.txt +++ /dev/null @@ -1,126 +0,0 @@ -Instalando y configurando el núcleo del ``CMF`` -=============================================== - -El objetivo de esta guía es instalar los componentes mínimos necesarios (el «núcleo») del ``CMF`` con la mínima configuración requerida. A partir de aquí, puedes empezar a incorporar en tu aplicación la funcionalidad del ``CMF`` que necesites. - -Esta guía está dirigida a usuarios experimentados que quieren conocer todos los -detalles sobre el ``CMF`` de *Symfony*. Si este es tu primer encuentro con el ``CMF`` de *Symfony* es buena idea empezar con: - -- La página :doc:`../getting-started/installing-symfony-cmf` para instrucciones sobre cómo instalar rápidamente el ``CMF`` (recommendada para desarrolladores) -- :doc:`../cookbook/installing-cmf-sandbox` para instrucciones sobre cómo instalar una demostración del recinto de seguridad. - -.. index:: RoutingExtraBundle, CoreBundle, MenuBundle, ContentBundle, SonataBlockBundle, KnpMenuBundle, instalando - -Requisitos previos ------------------- - -- `Instalando Symfony2 `_ (2.1.x) -- :doc:`installing-configuring-doctrine-phpcr-odm` - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "symfony-cmf/symfony-cmf": "1.0.*" - } - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update - - -Iniciando paquetes -~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en :file:`AppKernel.php` añadiéndolos al método ``registerBundles``: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - - new Symfony\Cmf\Bundle\RoutingExtraBundle\SymfonyCmfRoutingExtraBundle(), - new Symfony\Cmf\Bundle\CoreBundle\SymfonyCmfCoreBundle(), - new Symfony\Cmf\Bundle\MenuBundle\SymfonyCmfMenuBundle(), - new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(), - new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(), - - // Dependencias del SymfonyCmfMenuBundle - new Knp\Bundle\MenuBundle\KnpMenuBundle(), - - // Dependencias del SymfonyCmfBlockBundle - new Sonata\BlockBundle\SonataBlockBundle(), - ); - - // ... - } - -.. note:: - - Esto también habilita el *PHPCR-ODM* y dependencias relacionadas; las instrucciones de configuración se pueden encontrar en la documentación dedicada. - - -Configurando ------------- - -Para lograr que tu aplicación funcione, es muy poca la configuración necesaria. - -Configuración mínima -~~~~~~~~~~~~~~~~~~~~ - -Estos pasos son necesarios para garantizar que tu ``AppKernel`` todavía se ejecuta. - -Si no lo has hecho ya, asegúrate de que has seguido estos pasos en :doc:`installing-configuring-doctrine-phpcr-odm`: - - -- Inicia el ``DoctrinePHPCRBundle`` en :file:`app/AppKernel.php` -- Asegúrate que hay una sección ``doctrine_phpcr:`` en :file:`app/config/config.yml` -- Y la línea ``AnnotationRegistry::registerFile`` en :file:`app/autoload.php` - -Configura el ``BlockBundle`` en tu archivo :file:`config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_block: - default_contexts: [cms] - -Configuración adicional -~~~~~~~~~~~~~~~~~~~~~~~ - -Puesto que la mayoría de los componentes del ``CMF`` utilizan el ``DynamicRouter`` del ``RoutingExtraBundle``, el cual de manera predeterminada no se carga, necesitarás habilitarlo de la siguiente manera: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - chain: - routers_by_id: - symfony_cmf_routing_extra.dynamic_router: 200 - router.default: 100 - dynamic: - enabled: true - -Podrías querer configurar más en el enrutador dinámico, es decir escoger automáticamente los controladores basados en contenido. -Ve :doc:`../bundles/routing-extra` para detalles. - -Por ahora esta es la única configuración que necesitamos. Dominar la configuración de los diferentes paquetes será el tema de otras guías. Si estás buscando la configuración de un paquete específico dale un vistazo al :doc:`artículo del paquete <../index>` correspondiente. diff --git a/_sources/cmf/tutorials/installing-configuring-doctrine-phpcr-odm.txt b/_sources/cmf/tutorials/installing-configuring-doctrine-phpcr-odm.txt deleted file mode 100644 index e55865d..0000000 --- a/_sources/cmf/tutorials/installing-configuring-doctrine-phpcr-odm.txt +++ /dev/null @@ -1,335 +0,0 @@ -Instalando y configurando *Doctrine* y *PHPCR-ODM* -================================================== - -El ``CMF`` de *Symfony2* necesita almacenar el contenido en algún lugar. Muchos de los paquetes proporcionan documentos y asignación para el contenido del repositorio *PHP* --- Asignación para el objeto documento (*PHPCR-ODM*), y la documentación que actualmente está basada en torno a la utilización de este. No obstante, también debe ser posible utilizar cualquier otra forma de almacenamiento de contenido, tal como otro *ORM/ODM* o *MongoDB*. - -El objetivo de esta guía es instalar y configurar *Doctrine* y el *PHPCR-ODM*, listo para que empieces con el ``CMF``. - -Para más detalles ve la `documentación del PHPCR-ODM completa `_. -Alguna información adicional se puede encontrar en la referencia del :doc:`../bundles/phpcr-odm`, la cual mayoritariamente imita al `DoctrineBundle `_ estándar. - -Finalmente para información sobre *PHPCR* ve al `sitio web oficial de PHPCR `_. - -.. tip:: - - Si sólo quieres usar el *PHPCR* pero no el *PHPCR-ODM*, puedes omitir el paso sobre el registro de anotaciones y las partes que empiezan con ``odm`` de la sección de configuración. - -.. index:: PHPCR, ODM - -Requisitos previos ------------------- - -- php >= 5.3 -- libxml versión >= 2.7.0 (debido a un error en libxml http://bugs.php.net/bug.php?id=36501) -- phpunit >= 3.6 (si quieres ejecutar las pruebas) -- Symfony2 (versión 2.1.x) - -Instalando ----------- - -Escogiendo un repositorio para el contenido -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La primer cosa a decidir es qué repositorio de contenido utilizar. Un repositorio de contenido esencialmente es una base de datos que será la responsable para almacenar todo el contenido que quieras persistir. Este proporciona una *API* optimizada para las necesidades de un *CMS* (estructuras de árbol, referencias, versionado, completa búsqueda -de texto, etc.). Si bien, cada repositorio de contenido puede tener requisitos y características de rendimiento muy diferentes, la *API* es igual para todos ellos. - -Además, debido a que la *API* define un formato de importación/exportación, siempre puedes cambiar a una -diferente implementación del repositorio de contenido más tarde. - -Estas son las opciones disponibles: - -* **Jackalope con Jackrabbit** (Jackrabbit requiere Java, este puede persistir al sistema de archivos, a una base de datos, etc.) -* **Jackalope con DBAL de Doctrine** (requiere un *RDBMS* como *MySQL*, *PostgreSQL* o *SQLite*) -* **Midgard** (Requiere la extensión ``midgard2`` de *PHP* y un *RDBMS* como *MySQL*, *PostgreSQL* o *SQLite*) - -La siguiente documentación incluye ejemplos para todas las opciones de arriba. - -.. tip:: - - Si justo estás empezando con el ``CMF``, es mejor escoger un repositorio de contenido basado en un motor de almacenamiento con el cual ya estés familiarizado. Por ejemplo, **Jackalope con DBAL de Doctrine** trabajará con tu *RDBMS* existente y no requiere instalar *Java* o la extensión ``midgard2`` de *PHP*. Una vez que tienes una aplicación trabajando debe ser fácil cambiar a otra opción. - - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`, dependiendo del repositorio de contenido que hayas escogido. - -| **Jackalope con Jackrabbit** - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "jackalope/jackalope-jackrabbit": "1.0.*", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -| **Jackalope con Doctrine DBAL** - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "jackalope/jackalope-doctrine-dbal": "dev-master", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -**Midgard** - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "midgard/phpcr": "dev-master", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -.. note:: - - Para todo lo anterior, si también estás utilizando el *ORM* de *Doctrine*, asegúrate de usar ``"doctrine/orm": "2.3.*"``, o de lo contrario ``composer`` no podrá resolver las dependencias cuando *Doctrine* dependa del *PHPCR-ODM* más nuevo de *Doctrine 2.3*. (la edición estándar de *Symfony 2.1* utiliza «2.2.*».) - -Para instalar las dependencias anteriores, ejecuta: - -.. code-block:: bash - - php composer.phar update - -Registrando anotaciones -~~~~~~~~~~~~~~~~~~~~~~~ - -*PHPCR-ODM* usa anotaciones y es necesario registrarlas en tu archivo :file:`app/autoload.php`. Añade la siguiente línea, inmediatamente después de la última línea ``AnnotationRegistry::registerFile``: - -.. code-block:: php - - // app/autoload.php - - // ... - AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php'); - // ... - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en el archivo :file:`app/AppKernel.php` añadiéndolos al método ``registerBundle``: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - - // Doctrine PHPCR - new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(), - - ); - // ... - } - - -Configurando ------------- - -El siguiente paso es configurar los paquetes. - -Sesión *PHPCR* -~~~~~~~~~~~~~~ - -La configuración básica para cada repositorio de contenido se muestra abajo; añade las líneas apropiadas a tu archivo :file:`app/config/config.yml`. Puedes encontrar más información sobre la configuración de este paquete en el capítulo del :doc:`../bundles/phpcr-odm` de la referencia. - -Los parámetros del espacio de trabajo, nombre de usuario y contraseña son para el repositorio *PHPCR* y no los deberías confundir con las posibles credenciales de la base de datos. Estos provienen de la configuración de tu repositorio de contenido. Si quieres utilizar un diferente espacio de trabajo que ``«default»`` primero lo tienes que crear en tu repositorio. - -Si también quieres utilizar el *PHPCR-ODM*, además, ve la siguiente sección. - -**Jackalope con Jackrabbit** - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: jackrabbit - url: http://localhost:8080/server/ - workspace: default - username: admin - password: admin - # configuración del odm ve abajo - -**Jackalope con DBAL de Doctrine** - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - workspace: default - username: admin - password: admin - # configuración del odm ve abajo - -.. note:: - - Además, asegúrate de configurar la sección principal de ``doctrine:`` al *RDBMS* que escogiste. - Si quieres utilizar una diferente conexión en lugar de la predefinida, configúrala en la sección *dbal* y especifícala en el parámetro de conexión. Un ejemplo configuración típica es este: - - doctrine: - dbal: - driver: %database_driver% - host: %database_host% - port: %database_port% - dbname: %database_name% - user: %database_user% - password: %database_password% - charset: UTF8 - - Ve `Bases de datos y Doctrine `_ para más información. - -**Midgard** - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: midgard2 - db_type: MySQL - db_name: midgard2_test - db_host: "0.0.0.0" - db_port: 3306 - db_username: "" - db_password: "" - db_init: true - blobdir: /tmp/cmf-blobs - workspace: default - username: admin - password: admin - # configuración del odm ve abajo - - -*Doctrine* con *PHPCR-ODM* -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cualquiera de las configuraciones anteriores te darán una sesión *PHPCR* válida. Si quieres utilizar el gestor Objeto-Documento, necesitas configurarlo también. Lo más sencillo es poner ``auto_mapping: true`` para hacer que el paquete *PHPCR* reconoce documentos en el directorio ``/Document`` y buscar asociaciones en ``/Resources/config/doctrine/.phpcr.xml`` resp. ``...yml``. De lo contrario necesitas configurar manualmente la sección de asignaciones. See the -:ref:`configuration reference of the PHPCR-ODM bundle ` for details. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - ... - odm: - auto_mapping: true - - -Configurando el repositorio de contenido ----------------------------------------- - -.. _tutorials-installing-phpcr-jackrabbit: - -**Jackalope Jackrabbit** - -.. index:: Jackrabbit - -Estos son los pasos necesarios para instalar *Apache Jackrabbit*: - -- Asegúrate de que tienes instalada en tu caja la máquina virtual de *Java*. Si no, puedes conseguir una aquí: http://www.java.com/en/download/manual.jsp -- Descarga la versión más reciente de `Jackrabbit de la página de descarga `_ -- Ejecuta el servidor. Ve al directorio donde descargaste el archivo ``.jar`` y lánzalo: - -.. code-block:: bash - - java -jar jackrabbit-standalone-*.jar - -Ve a http://localhost:8080/, ahora *Apache* te debería mostrar una página ``Jackrabbit``. - -Puedes encontrar más información sobre cómo `ejecutar un servidor Jackrabbit `_ en el *wiki* de ``Jackalope``. - -.. _tutorials-installing-phpcr-doctrinedbal: - -**Jackalope DBAL de Doctrine** - -.. index:: Doctrine, DBAL, RDBMS - -Ejecuta las siguientes órdenes para crear la base de datos e instalar un esquema predefinido: - -.. code-block:: bash - - app/console doctrine:database:create - app/console doctrine:phpcr:init:dbal - -For more information on how to configure Doctrine DBAL with Symfony2, see the -`Doctrine chapter in the Symfony2 documentation `_ -and the explanations in the :ref:`reference of the PHPCR-ODM bundle `. - -.. _tutorials-installing-phpcr-midgard: - -**Midgard** - -.. index:: Midgard, RDBMS - -*Midgard* es una extensión *C* que implementa la *API* de *PHPCR* en lo alto de un *RDBMS* estándar. - -Ve la `documentación oficial de Midgard PHPCR `_. - -Registrando tipos de nodo del sistema -------------------------------------- - -*PHPCR-ODM* utiliza un `tipo de nodo personalizado `_ para dar seguimiento a la metainformación sin interferir con tu contenido. There is a command that makes it -trivial to register this type and the PHPCR namespace, as well as all base paths of bundles: - -.. code-block:: bash - - php app/console doctrine:phpcr:repository:init - -Usando la restricción de validación ``ValidPhpcrOdm`` ------------------------------------------------------ - -El paquete proporciona la restricción de validación ``ValidPhpcrOdm`` que puedes utilizar para comprobar si los campos ``Id`` o ``Nodename`` y ``Parent`` de tu documento son correctos: - -.. code-block:: php - - `_ y `create.js `_ para proporcionar edición en línea basada en la salida de `RDFa `_. - -Para más información ---por ahora--- ve la documentación del `CreateBundle `_ - -.. index:: VIE.js, CreateBundle, FOSRestBundle, JMSSerializerBundle, RDFa, create.js, hallo.js - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/create-bundle": "1.0.*" - }, - "scripts": { - "post-install-cmd": [ - "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ], - "post-update-cmd": [ - "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ] - }, - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update symfony-cmf/create-bundle - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en el archivo :file:`app/AppKernel.php` añadiéndolos al método ``registerBundles``: - -.. code-block:: php - - public function registerBundles() - { - $bundles = array( - // ... - - new Symfony\Cmf\Bundle\CreateBundle\SymfonyCmfCreateBundle(), - new FOS\RestBundle\FOSRestBundle(), - new JMS\SerializerBundle\JMSSerializerBundle($this), - ); - // ... - } - -Configurando ------------- - -El siguiente paso es configurar los paquetes. - -Configuración básica, añade lo siguiente a la configuración de tu aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_create: - phpcr_odm: true - map: - '': 'Symfony\Cmf\Bundle\MultilangContentBundle\Document\MultilangStaticContent' - image: - model_class: Symfony\Cmf\Bundle\CreateBundle\Document\Image - controller_class: Symfony\Cmf\Bundle\CreateBundle\Controller\PHPCRImageController - -Si tienes tus propios documentos, agregalos a la asignación y coloca la asignación ``RDFa`` en ``Resources/rdf-mappings`` ya sea dentro del directorio ``app`` o dentro de algún paquete. -El nombre de archivo es el nombre de clase completamente cualificado que incluye el espacio de nombres sustituyendo la barra inversa ``\`` con un punto ``(.)``. - - -Referencia ----------- - -Ve el :doc:`../bundles/create` diff --git a/_sources/cmf/tutorials/installing-configuring-simple-cms.txt b/_sources/cmf/tutorials/installing-configuring-simple-cms.txt deleted file mode 100644 index 59dc273..0000000 --- a/_sources/cmf/tutorials/installing-configuring-simple-cms.txt +++ /dev/null @@ -1,82 +0,0 @@ -Instalando y configurando el ``SimpleCmsBundle`` -================================================ - -El objetivo de esta guía es instalar y configurar un sencillo *CMS* con la ayuda del ``SimpleCmsBundle``. - -.. note:: - - Para que trabaje el ``CMF`` se requiere de *Symfony 2.1* (actualmente maestro). - -El ``SimpleCmsBundle`` proporciona una solución para fácilmente asignar contenido, rutas y elementos del menú basando el repositorio de contenido en una única estructura de árbol. - -Para más información ---por ahora--- ve la documentación del `SymfonyCmfSimpleCmsBundle `_ - -Para una sencilla instalación de ejemplo del paquete revisa la `Edición estándar del CMF de Symfony `_ - -El `sitio web de CMF `_ es -otra aplicación que utiliza el ``SimpleCmsBundle``. - - -.. index:: SimpleCmsBundle - -Requisitos previos ------------------- - -- :doc:`installing-cmf-core` - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/simple-cms-bundle": "1.0.*" - } - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update - - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia el paquete en el archivo :file:`app/AppKernel.php` añadiéndolo al método ``registerBundles``. - -.. code-block:: php - - public function registerBundles() - { - $bundles = array( - // ... - - new Symfony\Cmf\Bundle\SimpleCmsBundle\SymfonyCmfSimpleCmsBundle(), - - ); - // ... - } - -Configurando ------------- - -El siguiente paso es configurar los paquetes. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - routing: - templates_by_class: - Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page: SymfonyCmfSimpleCmsBundle:Page:index.html.twig - -Ve la referencia completa de :doc:`../bundles/simple-cms`. diff --git a/_sources/cmf/tutorials/using-blockbundle-and-contentbundle.txt b/_sources/cmf/tutorials/using-blockbundle-and-contentbundle.txt deleted file mode 100644 index 77f8523..0000000 --- a/_sources/cmf/tutorials/using-blockbundle-and-contentbundle.txt +++ /dev/null @@ -1,661 +0,0 @@ -Usando ``BlockBundle`` y ``ContentBundle`` con *PHPCR* -====================================================== - -El objetivo de esta guía es demostrar cómo puedes utilizar el ``CMF`` :doc:`../bundles/block` y :doc:`../bundles/content` como componentes independientes, y mostrarte cómo complementan al *PHPCR*. - -Esta guía demuestra el uso más sencillo posible, para instalarlo y ejecutarlo -rápidamente. Una vez que estés familiarizado con lo básico, la documentación en profundidad de ambos paquetes te -ayudará a adaptar estos ejemplos básicos para servir casos de uso más avanzados. - -Empezarás utilizando únicamente el ``BlockBundle``, con bloques de contenido enlazados directamente al *PHPCR*. -Luego, verás una introducción al ``ContentBundle`` para mostrarte cómo puedes representar contenido en las páginas con bloques. - -.. note:: - - A pesar de que no es un requisito utilizar ``BlockBundle`` o ``ContentBundle``, esta guía también usa `DoctrineFixturesBundle `_. - Esto es porque este proporciona una manera fácil de cargar algún contenido de prueba. - - -Requisitos previos ------------------- - -- `Instalando Symfony2 `_ (2.1.x) -- :doc:`installing-configuring-doctrine-phpcr-odm` - -.. note:: - - Esta guía está basada en la utilización de *PHPCR-ODM* instalado con ``Jackalope``, *DBAL* de *Doctrine* y una base de datos *MySQL*. Debería ser fácil adaptarlo para trabajar con una de las otras opciones *PHPCR* documentadas en :doc:`installing-configuring-doctrine-phpcr-odm`. - - -Creando y configurando la base de datos ---------------------------------------- - -Puedes utilizar una base de datos existente, o crear una ahora para ayudarte a seguir esta guía. Para una nueva base de datos, ejecuta estas órdenes en *MySQL*: - -.. code-block:: sql - - CREATE DATABASE symfony DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci; - CREATE USER 'symfony'@'localhost' IDENTIFIED BY 'UseABetterPassword'; - GRANT ALL ON symfony.* TO 'symfony'@'localhost'; - -Tu archivo :file:`parameters.yml` necesita emparejar lo anterior, por ejemplo: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/parameters.yml - parameters: - database_driver: pdo_mysql - database_host: localhost - database_port: ~ - database_name: symfony - database_user: symfony - database_password: UseABetterPassword - - -Configurando el componente *PHPCR* de *Doctrine* ------------------------------------------------- - -.. note:: - - Si seguiste la guía :doc:`installing-configuring-doctrine-phpcr-odm`, puedes saltarte esta sección. - -Necesitas instalar los componentes del *PHPCR-ODM*. Añade los siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "jackalope/jackalope-jackrabbit": "1.0.*", - "jackalope/jackalope-doctrine-dbal": "dev-master", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -Para instalar lo anterior, ejecuta: - -.. code-block:: bash - - php composer.phar update - -En tu archivo :file:`config.yml`, añade la siguiente configuración para ``doctrine_phpcr``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - workspace: default - odm: - auto_mapping: true - -Añade la siguiente línea al método ``registerBundles()`` en el archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(), - ); - - // ... - } - -Añade la siguiente línea a tu archivo :file:`autoload.php`, inmediatamente después de la -última línea ``AnnotationRegistry::registerFile``: - -.. code-block:: php - - // app/autoload.php - - // ... - AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php'); - // ... - -Crea el esquema de la base de datos y registra el tipo de nodo *PHPCR* usando las siguientes órdenes de consola: - -.. code-block:: bash - - php app/console doctrine:phpcr:init:dbal - php app/console doctrine:phpcr:repository:init - -Ahora deberías tener una serie de tablas en tu base de datos *MySQL* con el prefijo ``phpcr_``. - - -Instala los componentes necesarios del ``CMF`` de *Symfony* ------------------------------------------------------------ - -Añade lo siguiente al archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/block-bundle": "dev-master" - } - -Para instalar las dependencias anteriores, ejecuta: - -.. code-block:: bash - - php composer.phar update - -Añade las siguientes líneas al archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Sonata\BlockBundle\SonataBlockBundle(), - new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(), - ); - - // ... - } - -``SonataBlockBundle`` es una dependencia del ``BlockBundle`` de ``CMF`` y necesitas configurarlas. Añade lo siguiente a tu archivo :file:`config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_block: - default_contexts: [cms] - - -Instala ``DoctrineFixturesBundle`` ----------------------------------- - -.. note:: - - Como mencioné al inicio, este no es un requisito para ``BlockBundle`` o ``ContentBundle``; No obstante, es una buena manera de manejar contenido predefinido o de ejemplo. - -Añade lo siguiente al archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "doctrine/doctrine-fixtures-bundle": "dev-master" - } - -Para instalar las dependencias anteriores, ejecuta: - -.. code-block:: bash - - php composer.phar update - -Añade la siguiente línea al método ``registerBundles()`` en el archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(), - ); - - // ... - } - - -Cargando accesorios -------------------- - -Basándote en la `documentación de DoctrineFixturesBundle `_, necesitarás crear una clase ``fixtures``. - -Para empezar, crea un directorio ``DataFixtures`` dentro de tu propio paquete (p. ej. ``«MainBundle»``), y dentro, crea un directorio llamado ``PHPCR``. Si quieres seguir los ejemplos de más adelante, el ``DoctrineFixturesBundle`` cargará automáticamente las clases ``fixtures`` colocadas allí. - -En el cargador de ``accesorios``, un ejemplo de la creación de un bloque de contenido podría tener esta apariencia: - -.. code-block:: php - - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($parentPage); - $myBlock->setName('sidebarBlock'); - $myBlock->setTitle('My first block'); - $myBlock->setContent('Hello block world!'); - - $documentManager->persist($myBlock); - -Aún así, lo anterior en sí mismo no será suficiente, porque no hay ninguna página padre (``$parentPage``) con la cual enlazar los bloques. Hay varias posibles opciones que puedes utilizar como el padre: - -- Enlaza los bloques directamente al documento raíz (no mostrado) -- Crea un documento del paquete *PHPCR* (mostrado abajo usando el tipo de documento ``Genérico``) -- Crea un documento del ``ContentBundle`` del ``CMF`` (mostrado abajo utilizando el tipo de documento ``StaticContent``) - - -Usando el *PHPCR* ------------------ - -Para almacenar un bloque directamente en el *PHPCR* del ``CMF``, crea la siguiente clase dentro de tu directorio ``DataFixtures/PHPCR``: - -.. code-block:: html+php - - find(null, '/'); - - // Crea un documento PHPCR genérico bajo la raíz, para usarlo - // como el tipo de categoría para los bloques - $document = new Generic(); - $document->setParent($rootDocument); - $document->setNodename('blocks'); - $manager->persist($document); - - // Crea un nuevo SimpleBlock (ve - // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types) - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($document); - $myBlock->setName('testBlock'); - $myBlock->setTitle('CMF BlockBundle only'); - $myBlock->setContent('Block from CMF BlockBundle, parent from the PHPCR (Generic document).'); - $manager->persist($myBlock); - - // Confirma los cambios de $document y $block a la base de datos - $manager->flush(); - } - - public function setContainer(ContainerInterface $container = null) - { - $this->container = $container; - } - } - -Esta clase carga un bloque de contenido de ejemplo que utiliza el ``BlockBundle`` de ``CMF`` (sin necesitar ningún otro paquete del ``CMF``). Para asegurar el bloque tienes un padre en el repositorio, el cargador también crea un documento ``Genérico`` llamado ``'blocks'`` dentro del *PHPCR*. - -Ahora, carga los accesorios usando la consola: - -.. code-block:: bash - - php app/console doctrine:phpcr:fixtures:load - -El contenido en tu base de datos ahora se tendría que ver algo así: - - -.. code-block:: sql - - SELECT path, parent, local_name FROM phpcr_nodes; - -+-------------------+---------+------------+ -| path | parent | local_name | -+===================+=========+============+ -| / | | | -+-------------------+---------+------------+ -| /blocks | / | blocks | -+-------------------+---------+------------+ -| /blocks/testBlock |/ blocks | testBlock | -+-------------------+---------+------------+ - - -Usando el ``ContentBundle`` del ``CMF`` ---------------------------------------- - -Sigue este ejemplo para utilizar ambos componentes ``Block`` y ``Content``. - -The ContentBundle is best used together with the RoutingExtraBundle. Add the -following to ``composer.json``: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/content-bundle": "dev-master", - "symfony-cmf/routing-extra-bundle": "dev-master" - } - -Instala todo de la manera habitual: - -.. code-block:: bash - - php composer.phar update - -Añade la siguiente línea al archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(), - ); - - // ... - } - -Ahora deberías tener todo lo necesario para cargar una página de contenido con un bloque de ejemplo, así que crea la clase ``LoadBlockWithCmfParent.php``: - -.. code-block:: html+php - - getPhpcrSession(); - $basepath = $this->container->getParameter('symfony_cmf_content.static_basepath'); - - // Crea la ruta en el repositorio - NodeHelper::createPath($session, $basepath); - - // Crea un nuevo documento que utiliza StaticContent de ContentBundle del CMF - $document = new StaticContent(); - $document->setPath($basepath . '/blocks'); - $manager->persist($document); - - // Crea un nuevo SimpleBlock (ve - // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types) - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($document); - $myBlock->setName('testBlock'); - $myBlock->setTitle('CMF BlockBundle and ContentBundle'); - $myBlock->setContent('Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent).'); - $manager->persist($myBlock); - - // Confirma los cambios de $document y $block a la base de datos - $manager->flush(); - } - - public function setContainer(ContainerInterface $container = null) - { - $this->container = $container; - } - } - -Esta clase crea una página de contenido de ejemplo que utiliza el ``ContentBundle`` del ``CMF``. Luego, carga el bloque de ejemplo como antes, usando la nueva página de contenido como su padre. - -De manera predeterminada, la ruta base para el contenido es :file:`/cms/content/static`. Para mostrar cómo lo puedes configurar a cualquier ruta, añade la siguiente entrada opcional a tu archivo :file:`config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_content: - static_basepath: /content - -Ahora deberías poder cargar los accesorios anteriores: - -.. code-block:: bash - - php app/console doctrine:phpcr:fixtures:load - -Todo va sobre ruedas, el contenido en tu base de datos se tendría que ver algo así (si también seguiste el ejemplo ``LoadBlockWithPhpcrParent``, todavía deberías tener dos entradas ``/blocks`` también): - -.. code-block:: sql - - SELECT path, parent, local_name FROM phpcr_nodes; - -+---------------------------+-----------------+------------+ -| path | parent | local_name | -+===========================+=================+============+ -| / | | | -+---------------------------+-----------------+------------+ -| /content | / | content | -+---------------------------+-----------------+------------+ -| /content/blocks | /content | blocks | -+---------------------------+-----------------+------------+ -| /content/blocks/testBlock | /content/blocks | testBlock | -+---------------------------+-----------------+------------+ - - -Dibujando los bloques ---------------------- - -Esto lo maneja el ``BlockBundle`` de ``Sonata``. ``sonata_block_render`` ya está registrado como extensión de *Twig* al incluir ``SonataBlockBundle`` en el archivo :file:`AppKernel.php`. Por lo tanto, puedes dibujar cualquier bloque dentro de cualquier plantilla simplemente refiriéndote a su ruta. - -El siguiente código muestra el resultado de ambas instancias de los bloques ``testBlock`` de los ejemplos anteriores. -Si sólo seguiste uno de los ejemplos, asegúrate de incluir únicamente ese bloque: - -.. code-block:: text - - {# src/Acme/Bundle/MainBundle/resources/views/Default/index.html.twig #} - - {# Incluye esto si seguiste el ejemplo BlockBundle con PHPCR #} - {{ sonata_block_render({ - 'name': '/blocks/testBlock' - }) }} - - {# incluye esto si seguiste el ejemplo BlockBundle con ContentBundle #} - {{ sonata_block_render({ - 'name': '/content/blocks/testBlock' - }) }} - -Ahora tu página ``index`` debería mostrar lo siguiente (suponiendo que seguiste ambos ejemplos): - -.. code-block:: text - - CMF BlockBundle only - Block from CMF BlockBundle, parent from the PHPCR (Generic document). - - CMF BlockBundle and ContentBundle - Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent). - -Esto sucede al dibujar un bloque, ve el... index:: ``BlockBundle`` para más detalles: - -- un documento se carga basándose en el nombre -- si está configurada la caché, se comprueba la caché y si se encuentra devuelve el contenido -- cada bloque de documento también tiene un servicio de bloque, llama al método ``execute``: - - - puedes poner aquí la lógica que quieras tal como lo harías en un controlador - - esta llama a una plantilla - - el resultado es un objeto ``Respuesta`` - -.. note:: - - Un bloque también se puede configurar usando opciones, estas te permiten crear bloques más avanzados y reutilizables. Las opciones predefinidas se configuran en el bloque del servicio y se pueden alterar en el ayudante de *Twig* y el bloque del documento. - Un ejemplo es un bloque lector de *RSS*, la *URL* y el título se almacenan en las opciones del bloque del documento, la cantidad -máxima de elementos a mostrar se especifica al llamar a ``sonata_block_render``. - -.. _tutorial-block-embed: - -Embedding blocks in WYSIWYG content ------------------------------------ - -The SymfonyCmfBlockBundle provides a twig filter ``cmf_embed_blocks`` that -looks through the content and looks for special tags to render blocks. To use -the tag, you need to apply the ``cmf_embed_blocks`` filter to your output. -If you can, render your blocks directly in the template. This feature is only a -cheap solution for web editors to place blocks anywhere in their HTML content. -A better solution to build composed pages is to build it from blocks. (There -might be a CMF bundle at some point for this.) - -.. code-block:: jinja - - {# template.twig.html #} - {{ page.content|cmf_embed_blocks }} - -When you apply the filter, your users can use this tag to embed a block in -their HTML content: - -.. code-block:: html - - %block:"/absolute/path/to/block"% - -You can change the prefix and postfix (the parts ``%block:`` and -``%`` to have a different tag for your users. Say you want to write -``%%%block:"/absolute/path"%%%`` then you do: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_block: - twig: - cmf_embed_blocks: - prefix: %%%block: - postfix: %%% - - -.. warning:: - - Currently there is no limitation built into this feature. Only enable it on - content for which you are sure only trusted users may edit it. Restrictions - about what block can be where that are built into an admin interface are - not respected here. - - -Siguientes pasos ----------------- - -Ahora deberías estar listo para usar en tu aplicación el ``BlockBundle`` y/o el ``ContentBundle``, o para explorar los otros paquetes disponibles en el ``CMF``. - -- Ve la documentación de los paquetes :doc:`../bundles/block` y :doc:`../bundles/content` para aprender usos más avanzados de estos paquetes - para ver una manera mejor de cargar accesorios, mira los `accesorios en el recinto de seguridad del CMF `_ -- Dale un vistazo a la `guía PHPCR `_ para entender mejor el repositorio de contenido subyacente - - -Solucionando problemas ----------------------- - -Si tienes problemas, posiblemente sea más fácil empezar con una instalación de *Symfony2* fresca. También puedes probar ejecutando y modificando el código en el ejemplo externo del `recinto de seguridad del bloque del CMF `_. - -**Configuración de Doctrine** - -Si empezaste con la distribución estándar de *Symfony2* (versión 2.1.x), ya deberías tener correctamente configurado tu archivo :file:`config.yml`. Si no, inténtalo usando la siguiente sección: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - dbal: - driver: "%database_driver%" - host: "%database_host%" - port: "%database_port%" - dbname: "%database_name%" - user: "%database_user%" - password: "%database_password%" - charset: UTF8 - orm: - auto_generate_proxy_classes: "%kernel.debug%" - auto_mapping: true - -**"Ninguna orden definida" al cargar accesorios** - -.. code-block:: text - - [InvalidArgumentException] - No hay ninguna orden definida en el espacio de nombres ``doctrine:phpcr:fixtures``. - -Asegúrate de que tu archivo :file:`AppKernel.php` contiene las siguientes líneas: - -.. code-block:: php - - new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(), - new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(), - -**"No configuraste una sesión"** - -.. code-block:: text - - [InvalidArgumentException] - No configuraste una sesión para los gestores de documento - -Asegúrate de que tienes lo siguiente en tu archivo :file:`app/config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - workspace: default - odm: - auto_mapping: true - -**"La anotación no existe"** - -.. code-block:: text - - [Doctrine\Common\Annotations\AnnotationException] - [Error semántico] La anotación «@Doctrine\ODM\PHPCR\Mapping\Annotations\Document» en la clase «Doctrine\ODM\PHPCR\Document\Generic» no existe, o no se puede cargar automáticamente. - -Asegúrate de añadir esta línea a tu archivo :file:`app/autoload.php` (inmediatamente después de la línea ``AnnotationRegistry::registerLoader``): - -.. code-block:: php - - AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php'); - -**no se encuentra la clase SimpleBlock** - -.. code-block:: text - - [Doctrine\Common\Persistence\Mapping\MappingException] - La clase 'Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock' no se encuentra en la cadena de espacios de nombres configurada Doctrine\ODM\PHPCR\Document, Sonata\UserBundle\Document, FOS\UserBundle\Document - -Asegúrate de que está instalado el ``BlockBundle`` del ``CMF`` y de que se carga en el archivo :file:`app/AppKernel.php`: - -.. code-block:: php - - new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(), - -**No se encuentra la RouteAwareInterface** - -.. code-block:: text - - Error fatal: No se encuentra la interfaz 'Symfony\Cmf\Component\Routing\RouteAwareInterface' en /var/www/your-site/vendor/symfony-cmf/content-bundle/Symfony/Cmf/Bundle/ContentBundle/Document/StaticContent.php en la línea 15 - -Si estás utilizando el ``ContentBundle``, asegúrate de instalar el ``RoutingExtraBundle``, también: - -.. code-block:: javascript - - // composer.json - "symfony-cmf/routing-extra-bundle": "dev-master" - -...e instala: - -.. code-block:: bash - - php composer.phar update diff --git a/_sources/components/class_loader.txt b/_sources/components/class_loader.txt deleted file mode 100644 index 8746f80..0000000 --- a/_sources/components/class_loader.txt +++ /dev/null @@ -1,106 +0,0 @@ -.. index:: - pair: Autocargador; Configuración - single: Componentes; ClassLoader - -El componente ``ClassLoader`` -============================= - - El componente ``ClassLoader`` carga automáticamente las clases de tu proyecto si estas siguen algunas convenciones *PHP* estándar. - -Siempre que uses una clase no definida, *PHP* utiliza el mecanismo de carga automática para delegar la carga de un archivo de definición de clase. *Symfony2* proporciona un cargador automático «universal», que es capaz de cargar clases desde los archivos que implementan uno de los siguientes convenios: - -* Los `estándares`_ de interoperabilidad técnica para los espacios de nombres y nombres de clases de *PHP 5.3*; - -* La convención de nomenclatura de clases de `PEAR`_. - -Si tus clases y las bibliotecas de terceros que utilizas en tu proyecto siguen estas normas, el cargador automático de *Symfony2* es el único cargador automático que necesitarás siempre. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/ClassLoader); -* :doc:`Instalándolo vía Composer ` (``symfony/class-loader`` en `Packagist`_). - -Usando ------- - -.. versionadded:: 2.1 - El método ``useIncludePath`` se agregó en *Symfony* 2.1. - -Registrar la clase del cargador automático :class:`Symfony\\Component\\ClassLoader\\UniversalClassLoader` es sencillo:: - - require_once '/ruta/a/src/Symfony/Component/ClassLoader/UniversalClassLoader.php'; - - use Symfony\Component\ClassLoader\UniversalClassLoader; - - $loader = new UniversalClassLoader(); - - // como último recurso busca en include_path. - $loader->useIncludePath(true); - - // ... aquí registra el espacio de nombres y prefijos - // - ve más abajo - - $loader->register(); - -Para una menor ganancia en rendimiento puedes memorizar en caché las rutas de las clases usando *APC*, con sólo registrar la clase :class:`Symfony\\Component\\ClassLoader\\ApcUniversalClassLoader`:: - - require_once '/ruta/a/src/Symfony/Component/ClassLoader/UniversalClassLoader.php'; - require_once '/ruta/a/src/Symfony/Component/ClassLoader/ApcUniversalClassLoader.php'; - - use Symfony\Component\ClassLoader\ApcUniversalClassLoader; - - $loader = new ApcUniversalClassLoader('apc.prefix.'); - $loader->register(); - -El cargador automático es útil sólo si agregas algunas bibliotecas al cargador automático. - -.. note:: - - El autocargador se registra automáticamente en una aplicación *Symfony2* (consulta el ``app/autoload.php``). - -Si las clases a cargar automáticamente utilizan espacios de nombres, utiliza cualquiera de los métodos :method:`Symfony\\Component\\ClassLoader\\UniversalClassLoader::registerNamespace` o :method:`Symfony\\Component\\ClassLoader\\UniversalClassLoader::registerNamespaces`:: - - $loader->registerNamespace('Symfony', __DIR__.'/vendor/symfony/symfony/src'); - - $loader->registerNamespaces(array( - 'Symfony' => __DIR__.'/../vendor/symfony/symfony/src', - 'Monolog' => __DIR__.'/../vendor/monolog/monolog/src', - )); - - $loader->register(); - -Para las clases que siguen la convención de nomenclatura de PEAR, utiliza cualquiera de los métodos :method:`Symfony\\Component\\ClassLoader\\UniversalClassLoader::registerPrefix` o :method:`Symfony\\Component\\ClassLoader\\UniversalClassLoader::registerPrefixes`:: - - $loader->registerPrefix('Twig_', __DIR__.'/vendor/twig/twig/lib'); - - $loader->registerPrefixes(array( - 'Swift_' => __DIR__.'/vendor/swiftmailer/swiftmailer/lib/classes', - 'Twig_' => __DIR__.'/vendor/twig/twig/lib', - )); - - $loader->register(); - -.. note:: - - Algunas bibliotecas también requieren que su ruta de acceso raíz esté registrada en la ruta de include *PHP* (``set_include_path()``). - -Las clases de un subespacio de nombres o una subjerarquía de clases *PEAR* se pueden buscar en una lista de ubicaciones para facilitar la utilización de un subconjunto de clases de terceros en proyectos grandes:: - - $loader->registerNamespaces(array( - 'Doctrine\\Common' => __DIR__.'/vendor/doctrine/common/lib', - 'Doctrine\\DBAL\\Migrations' => __DIR__.'/vendor/doctrine/migrations/lib', - 'Doctrine\\DBAL' => __DIR__.'/vendor/doctrine/dbal/lib', - 'Doctrine' => __DIR__.'/vendor/doctrine/orm/lib', - )); - - $loader->register(); - -En este ejemplo, si intentas utilizar una clase en el espacio de nombres ``Doctrine\Common`` o una de sus hijas, el cargador automático buscará primero la clase en el directorio ``doctrine\common``, y entonces, si no lo encuentra, vuelve al directorio de reserva predeterminado, el último ``Doctrine`` configurado antes de darse por vencido. -El orden de registro es importante en este caso. - -.. _`estándares`: http://symfony.com/PSR0 -.. _`PEAR`: http://pear.php.net/manual/en/standards.php -.. _`Packagist`: https://packagist.org/packages/symfony/class-loader diff --git a/_sources/components/config/caching.txt b/_sources/components/config/caching.txt deleted file mode 100644 index ba4b027..0000000 --- a/_sources/components/config/caching.txt +++ /dev/null @@ -1,44 +0,0 @@ -.. index:: - single: Config; Almacenamiento en caché basado en recursos - -Almacenamiento en caché basado en recursos -========================================== - -Al cargar todos los recursos de configuración, posiblemente desees procesar los valores de configuración y combinarlos en un solo archivo. Este archivo actúa como la memorización en caché. Su contenido no se tiene que regenerar cada vez que ejecutas la aplicación - sólo cuando se modifican los recursos de configuración. - -Por ejemplo, el componente de enrutamiento de Symfony permite cargar todas las rutas, y luego volcar un comparador de URL o un generador de URL basándose en estas rutas. En este caso, cuando uno de los recursos se ha modificado (y estás trabajando en un entorno de desarrollo), debes invalidar el archivo generado y regenerarlo. -Esto se puede lograr usando la clase :class:`Symfony\\Component\\Config\\ConfigCache`. - -El siguiente ejemplo muestra cómo recolectar los recursos, luego generar algún código basado en los recursos que se han cargado, y escribir el código en la memoria caché. La memoria caché también recibe la colección de recursos que se utilizaron para generar el código. Al mirar la marca de tiempo de la «última modificación» de esos recursos, puedes saber si la caché aún está fresca o que debes regenerar su contenido:: - - use Symfony\Component\Config\ConfigCache; - use Symfony\Component\Config\Resource\FileResource; - - $cachePath = __DIR__.'/cache/appUserMatcher.php'; - - // el segundo argumento indica cuando o no deseas usar el modo de depuración - $userMatcherCache = new ConfigCache($cachePath, true); - - if (!$userMatcherCache->isFresh()) { - // llénalo con un arreglo de rutas de los archivos 'users.yml' - $yamlUserFiles = ...; - - $resources = array(); - - foreach ($yamlUserFiles as $yamlUserFile) { - // ver el artículo anterior «Cargando recursos» para - // ver de dónde proviene $delegatingLoader - $delegatingLoader->load($yamlUserFile); - $resources[] = new FileResource($yamlUserFile); - } - - // el código del UserMatcher se genera en otros lugares - $code = ...; - - $userMatcherCache->write($code, $resources); - } - - // posiblemente desees requerir el código almacenado en caché: - require $cachePath; - -En modo de depuración, se creará un archivo ``.meta`` en el mismo directorio que el propio archivo de caché. Este archivo ``.meta`` contiene los recursos serializados, cuya marca de tiempo se utiliza para determinar si la caché todavía está fresca. Cuando no estás en modo de depuración, la caché se considera que es «fresca» tan pronto como existe, y por lo tanto no se generará el archivo ``.meta``. diff --git a/_sources/components/config/definition.txt b/_sources/components/config/definition.txt deleted file mode 100644 index 60df7c5..0000000 --- a/_sources/components/config/definition.txt +++ /dev/null @@ -1,505 +0,0 @@ -.. index:: - single: Config; Definiendo y procesando valores de configuración - -Definiendo y procesando valores de configuración -================================================ - -Validando valores de configuración ----------------------------------- - -Después de cargar los valores de configuración de todo tipo de recursos, los valores y su estructura se pueden validar usando la parte «Definición» del componente ``Config``. Generalmente, se espera que los valores de configuración muestren algún tipo de jerarquía. Además, los valores deben ser de un determinado tipo, estar limitados en número o ser uno de un determinado conjunto de valores. Por ejemplo, la siguiente configuración (en *YAML*) muestra una clara jerarquía y algunas reglas de validación que se deben aplicar (como: «el valor de ``auto_connect`` debe ser un valor booleano»): - -.. code-block:: yaml - - auto_connect: true - default_connection: mysql - connections: - mysql: - host: localhost - driver: mysql - username: user - password: pass - sqlite: - host: localhost - driver: sqlite - memory: true - username: user - password: pass - -Al cargar varios archivos de configuración, debería ser posible combinar y sobrescribir algunos valores. Otros valores no se deben fusionar y quedarse como estaban cuando se encontraron por primera vez. Además, algunas claves sólo están disponibles cuando otra clave tiene un valor específico (en la configuración del ejemplo anterior: la clave ``memory`` sólo tiene sentido cuando ``driver`` es ``sqlite``). - -Definiendo una jerarquía de valores configuración usando el ``TreeBuilder`` ---------------------------------------------------------------------------- - -Puedes definir todas las normas relativas a los valores de configuración usando el :class:`Symfony\\Component\\Config\\Definition\\Builder\\TreeBuilder`. - -Debes devolver una instancia de :class:`Symfony\\Component\\Config\\Definition\\Builder\\TreeBuilder` desde una clase ``Configuration`` personalizada que implemente la :class:`Symfony\\Component\\Config\\Definition\\ConfigurationInterface`:: - - namespace Acme\DatabaseConfiguration; - - use Symfony\Component\Config\Definition\ConfigurationInterface; - use Symfony\Component\Config\Definition\Builder\TreeBuilder; - - class DatabaseConfiguration implements ConfigurationInterface - { - public function getConfigTreeBuilder() - { - $treeBuilder = new TreeBuilder(); - $rootNode = $treeBuilder->root('database'); - - // ... añade definiciones de nodo a la raíz del árbol - - return $treeBuilder; - } - } - -Añadiendo definiciones de nodo al árbol ---------------------------------------- - -Variables de nodo -~~~~~~~~~~~~~~~~~ - -Un árbol contiene definiciones de nodo que se pueden establecer de manera semántica. -Esto significa que, usando la sangría y una sencilla notación, es posible reflejar la estructura real de los valores de configuración:: - - $rootNode - ->children() - ->booleanNode('auto_connect') - ->defaultTrue() - ->end() - ->scalarNode('default_connection') - ->defaultValue('default') - ->end() - ->end() - ; - -El nodo raíz en sí es un arreglo de nodos, y tiene hijos, como el nodo booleano ``auto_connect`` y el nodo escalar ``default_connection``. En general: -después de definir un nodo, una llamada a ``end()`` te lleva un paso más arriba en la jerarquía. - -Tipo «node» -~~~~~~~~~~~ - -Es posible validar el tipo de un valor proporcionado utilizando la definición -de nodo apropiada. El tipo de nodo está disponible para: - -* ``scalar`` -* ``boolean`` -* ``array`` -* ``enum`` (nuevo en 2.1) -* ``integer`` (nuevo en 2.2) -* ``float`` (nuevo en 2.2) -* variable (sin validación) - -y se crean con ``node($nombre, $tipo)`` o su método abreviado asociado -``xxxxNode($nombre)``. - -Restricciones de nodos numéricos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.2 - Los nodos numéricos (``float`` e ``integer``) son nuevos en 2.2 - -Los nodos numéricos (``float`` e ``integer``) proporcionan dos restricciones extra --- -:method:`Symfony\\Component\\Config\\Definition\\Builder::min` y -:method:`Symfony\\Component\\Config\\Definition\\Builder::max` --- que te permiten validar el valor:: - - $rootNode - ->children() - ->integerNode('positive_value') - ->min(0) - ->end() - ->floatNode('big_value') - ->max(5E45) - ->end() - ->integerNode('value_inside_a_range') - ->min(-50)->max(50) - ->end() - ->end() - ; - -Nodos del arreglo -~~~~~~~~~~~~~~~~~ - -Es posible añadir un nivel más profundo a la jerarquía, añadiendo un nodo al arreglo. El arreglo de nodos en sí mismo, puede tener un conjunto predefinido de variables de nodo:: - - $rootNode - ->children() - ->arrayNode('connection') - ->children() - ->scalarNode('driver')->end() - ->scalarNode('host')->end() - ->scalarNode('username')->end() - ->scalarNode('password')->end() - ->end() - ->end() - ->end() - ; - -O puedes definir un prototipo para cada nodo dentro del arreglo de nodos:: - - $rootNode - ->children() - ->arrayNode('connections') - ->prototype('array') - ->children() - ->scalarNode('driver')->end() - ->scalarNode('host')->end() - ->scalarNode('username')->end() - ->scalarNode('password')->end() - ->end() - ->end() - ->end() - ; - -Puedes utilizar un prototipo para añadir una definición la cual se puede repetir muchas veces dentro del nodo actual. De acuerdo con la definición del prototipo en el ejemplo anterior, es posible tener varios arreglos de conexión (conteniendo un ``driver``, ``host``, etc.). - -Opciones del arreglo de nodos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de definir los hijos de un arreglo de nodos, puedes proveer opciones como: - -``useAttributeAsKey()`` - Provee el nombre de un nodo hijo, dónde se debe usar el valor como la clave en el arreglo resultante. -``requiresAtLeastOneElement()`` - Cuando menos debe haber un elemento en el arreglo (únicamente trabaja cuando también se invoca a ``isRequired()``). -``addDefaultsIfNotSet()`` - Si algún nodo hijo tiene valores predefinidos, se utilizan si no proporcionas valores explícitos. - -Un ejemplo de esto:: - - $rootNode - ->children() - ->arrayNode('parameters') - ->isRequired() - ->requiresAtLeastOneElement() - ->useAttributeAsKey('name') - ->prototype('array') - ->children() - ->scalarNode('value')->isRequired()->end() - ->end() - ->end() - ->end() - ->end() - ; - -En *YAML*, la configuración podría tener esta apariencia: - -.. code-block:: yaml - - database: - parameters: - param1: { value: param1val } - -En *XML*, cada nodo ``parameters`` tendría un atributo ``name`` (junto con -``value``), el cual se sacaría y utilizarí como la clave para ese elemento en el -arreglo final. El ``useAttributeAsKey`` es útil para normalizar cómo se especifican los arreglos entre diferentes formatos como *XML* y *YAML*. - -Valores predefinidos y requeridos ---------------------------------- - -Para todos los tipos de nodo, es posible definir valores predeterminados y valores de sustitución en caso de que un nodo tenga un cierto valor: - -``defaultValue()`` - Establece un valor predeterminado -``isRequired()`` - Se debe definir (pero puede estar vacío) -``cannotBeEmpty()`` - No puede contener un valor vacío -``default*()`` - (``null``, ``true``, ``false``), acceso directo para ``defaultValue()`` -``treat*Like()`` - (``null``, ``true``, ``false``), provee un valor sustituto en caso de que el valor sea ``*.`` - -.. code-block:: php - - $rootNode - ->children() - ->arrayNode('connection') - ->children() - ->scalarNode('driver') - ->isRequired() - ->cannotBeEmpty() - ->end() - ->scalarNode('host') - ->defaultValue('localhost') - ->end() - ->scalarNode('username')->end() - ->scalarNode('password')->end() - ->booleanNode('memory') - ->defaultFalse() - ->end() - ->end() - ->end() - ->arrayNode('settings') - ->addDefaultsIfNotSet() - ->children() - ->scalarNode('name') - ->isRequired() - ->cannotBeEmpty() - ->defaultValue('value') - ->end() - ->end() - ->end() - ->end() - ; - -Secciones opcionales --------------------- - -.. versionadded:: 2.2 - Los métodos ``canBeEnabled`` y ``canBeDisabled`` son nuevos en *Symfony 2.2* - -Si tienes secciones enteras que son opcionales y se pueden activar/desactivar, puedes aprovechar los métodos abreviados :method:`Symfony\\Component\\Config\\Definition\\Builder\\ArrayNodeDefinition::canBeEnabled` y -:method:`Symfony\\Component\\Config\\Definition\\Builder\\ArrayNodeDefinition::canBeDisabled`:: - - $arrayNode - ->canBeEnabled() - ; - - // es equivalente a - - $arrayNode - ->treatFalseLike(array('enabled' => false)) - ->treatTrueLike(array('enabled' => true)) - ->treatNullLike(array('enabled' => true)) - ->children() - ->booleanNode('enabled') - ->defaultFalse() - ; - -El método ``canBeDisabled`` se ve igual salvo que de manera predefinida la sección estaría habilitada. - -Combinando opciones -------------------- - -Puedes proporcionar opciones adicionales sobre el proceso de mezcla. Para arreglos: - -``performNoDeepMerging()`` - Cuando también defines el valor en un segundo arreglo de configuración, no se intenta combinar un arreglo, sino que lo sobrescribe por completo. - -Para todos los nodos: - -``cannotBeOverwritten()`` - No permite que otros arreglos de configuración sobrescriban un valor existente de este nodo. - -Anexando secciones ------------------- - -Si tienes una configuración de validación compleja, entonces el árbol puede crecer bastante y posiblemente quieras dividirlo en secciones. Lo puedes conseguir haciendo una sección en un nodo separado y luego anexándolo al árbol principal con ``append()``:: - - public function getConfigTreeBuilder() - { - $treeBuilder = new TreeBuilder(); - $rootNode = $treeBuilder->root('database'); - - $rootNode - ->children() - ->arrayNode('connection') - ->children() - ->scalarNode('driver') - ->isRequired() - ->cannotBeEmpty() - ->end() - ->scalarNode('host') - ->defaultValue('localhost') - ->end() - ->scalarNode('username')->end() - ->scalarNode('password')->end() - ->booleanNode('memory') - ->defaultFalse() - ->end() - ->end() - ->append($this->addParametersNode()) - ->end() - ->end() - ; - - return $treeBuilder; - } - - public function addParametersNode() - { - $builder = new TreeBuilder(); - $node = $builder->root('parameters'); - - $node - ->isRequired() - ->requiresAtLeastOneElement() - ->useAttributeAsKey('name') - ->prototype('array') - ->children() - ->scalarNode('value')->isRequired()->end() - ->end() - ->end() - ; - - return $node; - } - -Esto también es útil para ayudarte a evitar repeticiones si tienes repetida la configuración de esas secciones en diferentes sitios. - -Normalización -------------- - -Cuándo son procesados los archivos de configuración primero se normalizan, luego se fusionan -y finalmente el árbol se usa para validar el arreglo resultante. El proceso de normalización se usa para sacar algunos de las diferencias que resultan de diferentes formatos de configuración, principalmente las diferencias entre *Yaml* y *XML*. - -El separador utilizado en las claves en *Yaml* típicamente es ``_`` y ``-`` en *XML*. Por ejemplo, ``auto_connect`` en *Yaml* y ``auto-connect`` en *XML*. La normalización debería hacer que ambos fueran ``auto_connect``. - -.. caution:: - - La clave destino no será alterada si está mezclada como ``foo-bar_moo`` o si ya existe. - -Otra diferencia entre *Yaml* y *XML* es la manera en que se pueden representar los valores del arreglo. En *Yaml* puedes tener: - -.. code-block:: yaml - - twig: - extensions: ['twig.extension.foo', 'twig.extension.bar'] - -y en *XML*: - -.. code-block:: xml - - - twig.extension.foo - twig.extension.bar - - -Esta diferencia se puede sacar en la normalización pluralizando la clave utilizada -en *XML*. Puedes especificar si deseas que un clave se pluralice de este modo con ``fixXmlConfig()``:: - - $rootNode - ->fixXmlConfig('extension') - ->children() - ->arrayNode('extensions') - ->prototype('scalar')->end() - ->end() - ->end() - ; - -Si es una pluralización irregular puedes especificar el plural a utilizar como -segundo argumento:: - - $rootNode - ->fixXmlConfig('child', 'children') - ->children() - ->arrayNode('children') - ->end() - ; - -Así como se corrigió este, ``fixXmlConfig`` garantiza que solo los elementos -*XML* todavía se convierten en un arreglo. Por lo tanto puedes tener: - -.. code-block:: xml - - default - extra - -y a veces sólo: - -.. code-block:: xml - - default - -De manera predefinida ``connection`` sería un arreglo en el primer caso y una cadena -en el segundo dificultando su validación. Puedes garantizar que siempre sea un arreglo con con ``fixXmlConfig``. - -Puedes controlar el proceso de normalización más allá, de ser necesario. Por ejemplo, posiblemente quieras permitir que se pueda configurar una cadena y utilizarla como una clave particular o que se configuren varias claves explícitamente. De modo que, si todo aparte del ``name`` es opcional en esta configuración: - -.. code-block:: yaml - - connection: - name: my_mysql_connection - host: localhost - driver: mysql - username: user - password: pass - -También puedes permitir lo siguiente: - -.. code-block:: yaml - - connection: my_mysql_connection - -Cambiando el valor de una cadena a un arreglo asociativo con ``name`` como la clave:: - - $rootNode - ->children() - ->arrayNode('connection') - ->beforeNormalization() - ->ifString() - ->then(function($v) { return array('name'=> $v); }) - ->end() - ->children() - ->scalarNode('name')->isRequired() - // ... - ->end() - ->end() - ->end() - ; - -Reglas de validación --------------------- - -Puedes proporcionar reglas de validación más avanzadas utilizando la :class:`Symfony\\Component\\Config\\Definition\\Builder\\ExprBuilder`. Este constructor implementa una interfaz fluida para un bien conocido control de la estructura. -El constructor se utiliza para agregar reglas avanzadas de validación a las definiciones de nodo, como:: - - $rootNode - ->children() - ->arrayNode('connection') - ->children() - ->scalarNode('driver') - ->isRequired() - ->validate() - ->ifNotInArray(array('mysql', 'sqlite', 'mssql')) - ->thenInvalid('Invalid database driver "%s"') - ->end() - ->end() - ->end() - ->end() - ->end() - ; - -Una regla de validación siempre tiene una parte ``«if»``. Puedes especificar esta parte de las siguientes maneras: - -- ``ifTrue()`` -- ``ifString()`` -- ``ifNull()`` -- ``ifArray()`` -- ``ifInArray()`` -- ``ifNotInArray()`` -- ``always()`` - -Una regla de validación también requiere una parte ``«then»``: - -- ``then()`` -- ``thenEmptyArray()`` -- ``thenInvalid()`` -- ``thenUnset()`` - -Normalmente, ``«then»`` es un cierre. Su valor de retorno se utiliza como un nuevo valor para el nodo, en lugar del valor original. - -Procesando valores de configuración ------------------------------------ - -La clase :class:`Symfony\\Component\\Config\\Definition\\Processor` utiliza el árbol que fue construido usando el :class:`Symfony\\Component\\Config\\Definition\\Builder\\TreeBuilder` para procesar múltiples arreglos de valores de configuración que se deben combinar. -Si algún valor no es del tipo esperado, todavía es obligatorio e indefinido, o no se pudo validar de alguna otra manera, será lanzada una excepción. -De lo contrario, el resultado es un arreglo de valores de configuración limpio:: - - use Symfony\Component\Yaml\Yaml; - use Symfony\Component\Config\Definition\Processor; - use Acme\DatabaseConfiguration; - - $config1 = Yaml::parse(__DIR__.'/src/Matthias/config/config.yml'); - $config2 = Yaml::parse(__DIR__.'/src/Matthias/config/config_extra.yml'); - - $configs = array($config1, $config2); - - $processor = new Processor(); - $configuration = new DatabaseConfiguration; - $processedConfiguration = $processor->processConfiguration( - $configuration, - $configs) - ; - diff --git a/_sources/components/config/index.txt b/_sources/components/config/index.txt deleted file mode 100644 index c8a80fa..0000000 --- a/_sources/components/config/index.txt +++ /dev/null @@ -1,10 +0,0 @@ -``Config`` -========== - -.. toctree:: - :maxdepth: 2 - - introduction - resources - caching - definition diff --git a/_sources/components/config/introduction.txt b/_sources/components/config/introduction.txt deleted file mode 100644 index 9d286ef..0000000 --- a/_sources/components/config/introduction.txt +++ /dev/null @@ -1,28 +0,0 @@ -.. index:: - single: Config - single: Componentes; Config - -El componente ``Config`` -======================== - -Introducción ------------- - -El componente ``Config`` proporciona varias clases para ayudarte a encontrar, cargar, combinar, autocompletar y validar los valores de configuración de cualquier tipo, sea cual sea su fuente, puede ser (*YAML*, *XML*, archivos *INI*, o por ejemplo, una base de datos). - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Config); -* :doc:`Instalándolo vía Composer ` (``symfony/config`` en `Packagist`_). - -Secciones ---------- - -* :doc:`/components/config/resources` -* :doc:`/components/config/caching` -* :doc:`/components/config/definition` - -.. _`Packagist`: https://packagist.org/packages/symfony/config \ No newline at end of file diff --git a/_sources/components/config/resources.txt b/_sources/components/config/resources.txt deleted file mode 100644 index 813f59a..0000000 --- a/_sources/components/config/resources.txt +++ /dev/null @@ -1,71 +0,0 @@ -.. index:: - single: Config; Cargando recursos - -Cargando recursos -================= - -Localizando recursos --------------------- - -La carga de la configuración normalmente se inicia con la búsqueda de recursos, en la mayoría de los casos: archivos. Esto se puede hacer con el :class:`Symfony\\Component\\Config\\FileLocator`:: - - use Symfony\Component\Config\FileLocator; - - $configDirectories = array(__DIR__.'/app/config'); - - $locator = new FileLocator($configDirectories); - $yamlUserFiles = $locator->locate('users.yml', null, false); - -El localizador recibe un conjunto de lugares donde se deben buscar los archivos. -El primer argumento de ``locate()`` es el nombre del archivo a buscar. El segundo argumento puede ser la ruta actual y cuando si lo suministras, el localizador primero verá en ese directorio. El tercer argumento indica si el localizador debe devolver el primer archivo encontrado, o un arreglo conteniendo todas las coincidencias. - -Cargadores de recursos ----------------------- - -Debes definir un cargador para cada tipo de recurso (*YAML*, *XML*, anotaciones, etc.). -Cada cargador debe implementar la :class:`Symfony\\Component\\Config\\Loader\\LoaderInterface` o extender la clase abstracta :class:`Symfony\\Component\\Config\\Loader\\FileLoader`, la cual permite la importación recursiva de otros recursos:: - - use Symfony\Component\Config\Loader\FileLoader; - use Symfony\Component\Yaml\Yaml; - - class YamlUserLoader extends FileLoader - { - public function load($resource, $type = null) - { - $configValues = Yaml::parse($resource); - - // ... manipula los valores de configuración - - // tal vez importe algún otro recurso: - - // $this->import('extra_users.yml'); - } - - public function supports($resource, $type = null) - { - return is_string($resource) && 'yml' === pathinfo( - $resource, - PATHINFO_EXTENSION - ); - } - } - -Encontrando el cargador adecuado --------------------------------- - -La clase :class:`Symfony\\Component\\Config\\Loader\\LoaderResolver` recibe como primer argumento el constructor de una colección de cargadores. Cuando se debe cargar un recurso (por ejemplo, un archivo *XML*), este realiza un bucle a través de esta colección de cargadores y devuelve el cargador compatible con ese tipo de recurso en particular. - -La clase :class:`Symfony\\Component\\Config\\Loader\\DelegatingLoader` usa el :class:`Symfony\\Component\\Config\\Loader\\LoaderResolver`. Cuando se le pide que cargue un recurso, delega esta cuestión a la clase :class:`Symfony\\Component\\Config\\Loader\\LoaderResolver`. En caso de que la resolución haya encontrado un cargador adecuado, se le pedirá a ese cargador que cargue el recurso:: - - use Symfony\Component\Config\Loader\LoaderResolver; - use Symfony\Component\Config\Loader\DelegatingLoader; - - $loaderResolver = new LoaderResolver(array(new YamlUserLoader($locator))); - $delegatingLoader = new DelegatingLoader($loaderResolver); - - $delegatingLoader->load(__DIR__.'/users.yml'); - /* - El YamlUserLoader se utiliza para cargar este recurso, - debido a que es compatible con la extensión de archivo - ".yml" - */ diff --git a/_sources/components/console.txt b/_sources/components/console.txt deleted file mode 100644 index 2182b52..0000000 --- a/_sources/components/console.txt +++ /dev/null @@ -1,316 +0,0 @@ -.. index:: - single: Console; CLI - single: Componentes; Console - -El componente ``Console`` -========================= - - El componente ``Console`` facilita la creación de bellas y comprobables interfaces de línea de ordenes. - -El componente ``Console`` te permite crear instrucciones para la línea de ordenes. Tus ordenes de consola se pueden utilizar para cualquier tarea repetitiva, como tareas programadas (``cronjobs``), importaciones, u otros trabajos por lotes. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Console); -* Instalándolo a través de *PEAR* (`pear.symfony.com/Console`); -* Instalándolo vía ``Composer`` (`symfony/console` en Packagist). - -Creando una orden básica ------------------------- - -Para hacer una orden de consola que nos de la bienvenida desde la línea de ordenes, crea el archivo :file:`GreetCommand.php` y agrégale lo siguiente: - -.. code-block:: php - - namespace Acme\DemoBundle\Command; - - use Symfony\Component\Console\Command\Command; - use Symfony\Component\Console\Input\InputArgument; - use Symfony\Component\Console\Input\InputInterface; - use Symfony\Component\Console\Input\InputOption; - use Symfony\Component\Console\Output\OutputInterface; - - class GreetCommand extends Command - { - protected function configure() - { - $this - ->setName('demo:greet') - ->setDescription('Greet someone') - ->addArgument('name', InputArgument::OPTIONAL, 'Who do you want to greet?') - ->addOption('yell', null, InputOption::VALUE_NONE, 'If set, the task will yell in uppercase letters') - ; - } - - protected function execute(InputInterface $input, OutputInterface $output) - { - $name = $input->getArgument('name'); - if ($name) { - $text = 'Hello '.$name; - } else { - $text = 'Hello'; - } - - if ($input->getOption('yell')) { - $text = strtoupper($text); - } - - $output->writeln($text); - } - } - -También necesitas crear el archivo para ejecutar la línea de ordenes, el cual crea una ``Application`` y le agrega ordenes: - -.. code-block:: html+php - - #!/usr/bin/env php - # app/console - add(new GreetCommand); - $application->run(); - -Prueba la nueva consola de ordenes ejecutando lo siguiente - -.. code-block:: bash - - $ app/console demo:greet Fabien - -Esto imprimirá lo siguiente en la línea de ordenes: - -.. code-block:: text - - Hello Fabien - -También puedes utilizar la opción ``--yell`` para convertir todo a mayúsculas: - -.. code-block:: bash - - $ app/console demo:greet Fabien --yell - -Esto imprime:: - - HELLO FABIEN - -Coloreando la salida -~~~~~~~~~~~~~~~~~~~~ - -Cada vez que produces texto, puedes escribir el texto con etiquetas para colorear tu salida. Por ejemplo:: - - // texto verde - $output->writeln('foo'); - - // texto amarillo - $output->writeln('foo'); - - // texto negro sobre fondo cían - $output->writeln('foo'); - - // texto blanco sobre fondo rojo - $output->writeln('foo'); - -Es posible definir tu propio estilo usando la clase :class:`Symfony\\Component\\Console\\Formatter\\OutputFormatterStyle`:: - - $style = new OutputFormatterStyle('red', 'yellow', array('bold', 'blink')); - $output->getFormatter()->setStyle('fire', $style); - $output->writeln('foo'); - -Los colores disponibles para el fondo y primer plano son: ``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``cyan`` y ``white``. - -Y las opciones disponibles son: ``bold``, ``underscore``, ``blink``, ``reverse`` y ``conceal``. - -Utilizando argumentos de ordenes --------------------------------- - -La parte más interesante de las ordenes son los argumentos y opciones que puedes hacer disponibles. Los argumentos son cadenas ---separadas por espacios--- que vienen después del nombre de la orden misma. Ellos están ordenados, y pueden ser opcionales u obligatorios. Por ejemplo, añade un argumento ``last_name`` opcional a la orden y haz que el argumento ``name`` sea obligatorio:: - - $this - // ... - ->addArgument('name', InputArgument::REQUIRED, 'Who do you want to greet?') - ->addArgument('last_name', InputArgument::OPTIONAL, 'Your last name?'); - -Ahora tienes acceso a un argumento ``last_name`` en la orden:: - - if ($lastName = $input->getArgument('last_name')) { - $text .= ' '.$lastName; - } - -Ahora la orden se puede utilizar en cualquiera de las siguientes maneras: - -.. code-block:: bash - - $ app/console demo:greet Fabien - $ app/console demo:greet Fabien Potencier - -Usando las opciones de la orden -------------------------------- - -A diferencia de los argumentos, las opciones no están ordenadas (lo cual significa que las puedes especificar en cualquier orden) y se especifican con dos guiones (por ejemplo, ``--yell`` también puedes declarar un atajo de una letra que puedes invocar con un único guión como ``-y``). Las opciones son: *always* opcional, y se puede configurar para aceptar un valor (por ejemplo, ``dir=src``) o simplemente como una variable lógica sin valor (por ejemplo, ``yell``). - -.. tip:: - - También es posible hacer que un argumento *opcionalmente* acepte un valor (de modo que ``--yell`` o ``yell=loud`` funcione). Las opciones también se pueden configurar para aceptar una matriz de valores. - -Por ejemplo, añadir una nueva opción a la orden que se puede usar para especificar cuántas veces se debe imprimir el mensaje en una fila:: - - $this - // ... - ->addOption('iterations', null, InputOption::VALUE_REQUIRED, 'How many times should the message be printed?', 1); - -A continuación, utilízalo en la orden para imprimir el mensaje varias veces: - -.. code-block:: php - - for ($i = 0; $i < $input->getOption('iterations'); $i++) { - $output->writeln($text); - } - -Ahora, al ejecutar la tarea, si lo deseas, puedes especificar un indicador ``--iterations``: - -.. code-block:: bash - - $ app/console demo:greet Fabien - $ app/console demo:greet Fabien --iterations=5 - -El primer ejemplo sólo se imprimirá una vez, ya que ``iterations`` está vacía y el predeterminado es ``1`` (el último argumento de ``addOption``). El segundo ejemplo se imprimirá cinco veces. - -Recordemos que a las opciones no les preocupa su orden. Por lo tanto, cualquiera de las siguientes trabajará: - -.. code-block:: bash - - $ app/console demo:greet Fabien --iterations=5 --yell - $ app/console demo:greet Fabien --yell --iterations=5 - -Hay 4 variantes de la opción que puedes utilizar: - -=========================== ================================================================================================== -Opción Valor -=========================== ================================================================================================== -InputOption::VALUE_IS_ARRAY Esta opción acepta múltiples valores (por ejemplo: ``--dir=/foo --dir=/bar``) -InputOption::VALUE_NONE No acepta entradas para esta opción (por ejemplo: ``--yell``) -InputOption::VALUE_REQUIRED Este valor es obligatorio (por ejemplo: ``--iterations=5``), la opción es sí misma aún es opcional -InputOption::VALUE_OPTIONAL Esta opción puede o no tener un valor (por ejemplo: ``yell`` o ``yell=loud``) -=========================== ================================================================================================== - -Puedes combinar el VALUE_IS_ARRAY con VALUE_REQUIRED o VALUE_OPTIONAL de la siguiente manera: - -.. code-block:: php - - $this - // ... - ->addOption('iterations', null, InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, 'How many times should the message be printed?', 1); - -Pidiendo información al usuario -------------------------------- - -Al crear ordenes, tienes la capacidad de recopilar más información de los usuarios haciéndoles preguntas. Por ejemplo, supongamos que deseas confirmar una acción antes de llevarla a cabo realmente. Añade lo siguiente a tu orden:: - - $dialog = $this->getHelperSet()->get('dialog'); - if (!$dialog->askConfirmation($output, 'Continue with this action?', false)) { - return; - } - -En este caso, el usuario tendrá que "Continuar con esta acción", y, a menos que responda con ``y``, la tarea se detendrá. El tercer argumento de ``askConfirmation`` es el valor predeterminado que se devuelve si el usuario no introduce algo. - -También puedes hacer preguntas con más que una simple respuesta sí/no. Por ejemplo, si necesitas saber el nombre de algo, puedes hacer lo siguiente:: - - $dialog = $this->getHelperSet()->get('dialog'); - $name = $dialog->ask($output, 'Please enter the name of the widget', 'foo'); - -Probando ordenes ----------------- - -*Symfony2* proporciona varias herramientas para ayudarte a probar las ordenes. La más útil es la clase :class:`Symfony\\Component\\Console\\Tester\\CommandTester`. Esta utiliza clases entrada y salida especiales para facilitar la prueba sin una consola real:: - - use Symfony\Component\Console\Application; - use Symfony\Component\Console\Tester\CommandTester; - use Acme\DemoBundle\Command\GreetCommand; - - class ListCommandTest extends \PHPUnit_Framework_TestCase - { - public function testExecute() - { - $application = new Application(); - $application->add(new GreetCommand()); - - $command = $application->find('demo:greet'); - $commandTester = new CommandTester($command); - $commandTester->execute(array('command' => $command->getName())); - - $this->assertRegExp('/.../', $commandTester->getDisplay()); - - // ... - } - } - -El método :method:`Symfony\\Component\\Console\\Tester\\CommandTester::getDisplay` devuelve lo que se ha exhibido durante una llamada normal de la consola. - -Puedes probar enviando argumentos y opciones a la orden pasándolos como una matriz al método :method:`symfony\\Component\\Console\\Tester\\CommandTester::getDisplay`:: - - use Symfony\Component\Console\Application; - use Symfony\Component\Console\Tester\CommandTester; - use Acme\DemoBundle\Command\GreetCommand; - - class ListCommandTest extends \PHPUnit_Framework_TestCase - { - // ... - - public function testNameIsOutput() - { - $application = new Application(); - $application->add(new GreetCommand()); - - $command = $application->find('demo:greet'); - $commandTester = new CommandTester($command); - $commandTester->execute( - array('command' => $command->getName(), 'name' => 'Fabien') - ); - - $this->assertRegExp('/Fabien/', $commandTester->getDisplay()); - } - } - -.. tip:: - - También puedes probar toda una aplicación de consola utilizando :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`. - -Llamando una orden existente ----------------------------- - -Si una orden depende de que se ejecute otra antes, en lugar de obligar al usuario a recordar el orden de ejecución, puedes llamarla directamente tú mismo. -Esto también es útil si deseas crear una "metaorden" que ejecute un montón de otras ordenes (por ejemplo, todas las ordenes que se deben ejecutar cuando el código del proyecto ha cambiado en los servidores de producción: vaciar la caché, generar delegados *Doctrine2*, volcar activos ``Assetic``, ...). - -Llamar a una orden desde otra es sencillo:: - - protected function execute(InputInterface $input, OutputInterface $output) - { - $command = $this->getApplication()->find('demo:greet'); - - $arguments = array( - 'command' => 'demo:greet', - 'name' => 'Fabien', - '--yell' => true, - ); - - $input = new ArrayInput($arguments); - $returnCode = $command->run($input, $output); - - // ... - } - -En primer lugar, tu :method:`Symfony\\Component\\Console\\Application::find` busca la orden que deseas ejecutar pasando el nombre de la orden. - -Entonces, es necesario crear una nueva clase :class:`Symfony\\Component\\Console\\Input\\ArrayInput` con los argumentos y opciones que desees pasar a la orden. - -Finalmente, invocar al método ``run()`` ejecuta la orden realmente y devuelve el código devuelto de la orden (el valor del método ``execute()``). - -.. note:: - - La mayor parte del tiempo, llamar a una orden desde código que no se ejecuta en la línea de ordenes no es una buena idea por varias razones. En primer lugar, la salida de la orden se ha optimizado para la consola. Pero lo más importante, puedes pensar de una orden como si fuera un controlador; este debe utilizar el modelo para hacer algo y mostrar algún comentario al usuario. Así, en lugar de llamar una orden desde la *Web*, reconstruye tu código y mueve la lógica a una nueva clase. diff --git a/_sources/components/console/events.txt b/_sources/components/console/events.txt deleted file mode 100644 index c1fd20b..0000000 --- a/_sources/components/console/events.txt +++ /dev/null @@ -1,103 +0,0 @@ -.. index:: - single: Console; Eventos - -Usando eventos -============== - -.. versionadded:: 2.3 - Los eventos de consola se añadieron en *Symfony 2.3*. - -La clase ``Application`` del componente ``Console`` te permite engancharla opcionalmente al ciclo de vida de una aplicación de consola a través de eventos. En vez de reinventar la rueda, esta utiliza el componente ``EventDispatcher`` de *Symfony* para hacer el trabajo:: - - use Symfony\Component\Console\Application; - use Symfony\Component\EventDispatcher\EventDispatcher; - - $application = new Application(); - $application->setDispatcher($dispatcher); - $application->run(); - -El evento ``ConsoleEvents::COMMAND`` ------------------------------------- - -**Propósito típico**: Hacer algo antes de ejecutar cualquier orden (tal como registrar qué orden se va a ejecutar), o mostrar algo sobre el evento a ejecutar. - -Justo antes de ejecutar cualquier orden, se despacha el evento ``ConsoleEvents::COMMAND``. Lo escuchas reciben un evento :class:`Symfony\\Component\\Console\\Event\\ConsoleCommandEvent`:: - - use Symfony\Component\Console\Event\ConsoleCommandEvent; - use Symfony\Component\Console\ConsoleEvents; - - $dispatcher->addListener(ConsoleEvents::COMMAND, function (ConsoleCommandEvent $event) { - // consigue la instancia de entrada - $input = $event->getInput(); - - // consigue la instancia de salida - $output = $event->getOutput(); - - // consigue la orden a ejecutar - $command = $event->getCommand(); - - // escribe algo sobre la orden - $output->writeln(sprintf('Before running command %s', $command->getName())); - - // consigue la aplicación - $application = $command->getApplication(); - }); - -El evento ``ConsoleEvents::TERMINATE`` --------------------------------------- - -**Propósito típico**: Para realizar alguna limpieza en las acciones después de ejecutar la orden. - -Después de ejecutar la orden, se despacha el evento``ConsoleEvents::TERMINATE``. Este se puede se puede usar para hacer cualquier acción que se deba ejecutar para todas las -órdenes o para limpiar lo que iniciaste en un escucha de ``ConsoleEvents::COMMAND`` (como enviar registros, cerrar una conexión de base de datos, enviar correos electrónicos, ...). Un escucha también podría cambiar el código de salida. - -Los escuchas reciben un evento :class:`Symfony\\Component\\Console\\Event\\ConsoleTerminateEvent`:: - - use Symfony\Component\Console\Event\ConsoleTerminateEvent; - use Symfony\Component\Console\ConsoleEvents; - - $dispatcher->addListener(ConsoleEvents::TERMINATE, function (ConsoleTerminateEvent $event) { - // consigue la salida - $output = $event->getOutput(); - - // consigue la orden que se ha ejecutado - $command = $event->getCommand(); - - // muestra algo - $output->writeln(sprintf('After running command %s', $command->getName())); - - // cambia el código de salida - $event->setExitCode(128); - }); - -.. tip:: - - Este evento también se despacha cuando la orden lanza una excepción. - Este entonces se despacha justo antes del evento ``ConsoleEvents::EXCEPTION``. - El código de salida recibido en este caso es el código de la excepción. - -El evento ``ConsoleEvents::EXCEPTION`` --------------------------------------- - -**Propósito típico**: manejar excepciones lanzadas durante la ejecución de una orden. - -Siempre que una orden lanza una excepción, se lanza el evento ``ConsoleEvents::EXCEPTION``. Un escucha puede envolver o cambiar la excepción o hacer cualquier cosa útil antes de que la aplicación lance la excepción. - -Los escuchas reciben un evento :class:`Symfony\\Component\\Console\\Event\\ConsoleForExceptionEvent`:: - - use Symfony\Component\Console\Event\ConsoleForExceptionEvent; - use Symfony\Component\Console\ConsoleEvents; - - $dispatcher->addListener(ConsoleEvents::EXCEPTION, function (ConsoleForExceptionEvent $event) { - $output = $event->getOutput(); - - $output->writeln(sprintf('Oops, exception thrown while running command %s', $command->getName())); - - // consigue el código de salida actual (el código de la excepción - // o el código de salida establecido por el evento - // ConsoleEvents::TERMINATE) - $exitCode = $event->getExitCode(); - - // cambia la excepción por otra - $event->setException(new \LogicException('Caught exception', $exitCode, $event->getException())); - }); diff --git a/_sources/components/console/helpers/dialoghelper.txt b/_sources/components/console/helpers/dialoghelper.txt deleted file mode 100644 index 20b7fc8..0000000 --- a/_sources/components/console/helpers/dialoghelper.txt +++ /dev/null @@ -1,152 +0,0 @@ -.. index:: - single: Ayudantes de consola; Ayudantes de diálogo - -Ayudantes de diálogo -==================== - -El clase :class:`Symfony\\Component\\Console\\Helper\\DialogHelper` proporciona -funciones para solicitar más información al usuario. Estos se incluyen en el conjunto de ayudantes predefinido, el cual puedes obtener llamando al método :method:`Symfony\\Component\\Console\\Command\\Command::getHelperSet`:: - - $dialog = $this->getHelperSet()->get('dialog'); - -Todos los métodos dentro de los ayudantes de diálogo tienen una clase :class:`Symfony\\Component\\Console\\Output\\OutputInterface` como primer argumento, la pregunta como segundo argumento y el valor predefinido como último argumento. - -Pidiendo confirmación al usuario --------------------------------- - -Supón que quieres confirmar una acción antes de ejecutarla realmente. Añade lo siguiente a tu orden:: - - // ... - if (!$dialog->askConfirmation( - $output, - 'Continue with this action?', - false - )) { - return; - } - -En este caso, se preguntará al usuario «¿Continúar con esta acción?», y regresará -``true`` si el usuario respondió con ``y`` o ``false`` en cualquier otro caso. El tercer argumento de ``askConfirmation`` es el valor predeterminado que se devuelve si el usuario no introduce algo. - -Pidiendo información al usuario -------------------------------- - -También puedes preguntar algó más complejo que una sencilla respuesta sí/no. Por ejemplo, si quieres saber un nombre de paquete, puedes añadir esto a tu orden:: - - // ... - $bundle = $dialog->ask( - $output, - 'Please enter the name of the bundle', - 'AcmeDemoBundle' - ); - -Se pedirá al usuario «Por favor, introduce el nombre del paquete». El usuario escribe algún nombre, el cual será devuelto por el método ``ask``. Si lo deja vacío, el valor predefinido (``AcmeDemoBundle`` aquí) será regresado. - -Ocultando la respuesta del usuario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.2 - El método ``askHiddenResponse`` se añadió en *Symfony 2.2*. - -Además, puedes hacer una pregunta y ocultar la respuesta. Esto, particularmente es conveniente para contraseñas:: - - $dialog = $this->getHelperSet()->get('dialog'); - $password = $dialog->askHiddenResponse( - $output, - 'What is the database password?', - false - ); - -.. caution:: - - Cuándo pides una respuesta oculta, *Symfony* utilizará o bien un binario, cambiará al modo ``stty`` o utilizará algún otro truco para ocultar la respuesta. Si ninguno está disponible, se replegará y dejará la respuesta visible a no ser que pases ``false`` como tercer argumento tal cómo en el ejemplo anterior. En este caso, lanzará una excepción en tiempo de ejecución (``RuntimeException``). - -Validando la respuesta ----------------------- - -Incluso, puedes validar la respuesta. Por ejemplo, en el último fragmento de código solicitaste el nombre del paquete. Siguiendo las convenciones de nomenclatura de *Symfony2*, se tiene que sufijar con ``Bundle``. Puedes validar esto utilizando el método :method:`Symfony\\Component\\Console\\Helper\\DialogHelper::askAndValidate`:: - - // ... - $bundle = $dialog->askAndValidate( - $output, - 'Please enter the name of the bundle', - function ($answer) { - if ('Bundle' !== substr($answer, -6)) { - throw new \RunTimeException( - 'The name of the bundle should be suffixed with \'Bundle\'' - ); - } - return $answer; - }, - false, - 'AcmeDemoBundle' - ); - -Estos métodos tienen 2 nuevos argumentos, la firma completa es:: - - askAndValidate( - OutputInterface $output, - string|array $question, - callback $validator, - integer $attempts = false, - string $default = null - ) - -El ``$validator`` es una retrollamada que maneja la validación. Este debe lanzar una excepción si hay algo incorrecto. El mensaje de la excepción se muestra en la consola, por lo tanto es una buena práctica poner alguna información útil en él. La función retrollamada también debería regresar el valor ingresado por el usuario si la validación fue satisfactoria. - -Puedes poner el número máximo de veces a preguntar en el argumento ``$attempts``. -Si alcanzas este número máximo utilizas el valor predeterminado, el cual es dado en el último argumento. Utilizar ``false`` significa que la cantidad de intentos es infinita. -El usuario será preguntado mientras proporcione una respuesta nula y sólo será capaz de proceder si su entrada es válida. - -Ocultando la respuesta del usuario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.2 - El método ``askHiddenResponseAndValidate`` se añadió en *Symfony 2.2*. - -También puedes hacer una pregunta y validar una respuesta oculta:: - - $dialog = $this->getHelperSet()->get('dialog'); - - $validator = function ($value) { - if (trim($value) == '') { - throw new \Exception('The password can not be empty'); - } - }; - - $password = $dialog->askHiddenResponseAndValidate( - $output, - 'Please enter the name of the widget', - $validator, - 20, - false - ); - -Si quieres permitir que la respuesta sea visible si ---por alguna razón--- no se puede ocultar, pasa ``true`` como quinto argumento. - -Permitiendo al usuario escoger de una lista de Respuestas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.2 - El método :method:`Symfony\\Component\\Console\\Helper\\DialogHelper::select` se añadió en *Symfony* 2.2. - -Si tienes un conjunto de respuestas predefinido del cual pueda escoger el usuario, podrías utilizar el método ``ask`` descrito anteriormente o, asegurarte de que el usuario proporcionó una respuesta correcta, el método ``askAndValidate``. Ambos tienen la desventaja de que necesitas manejar los valores incorrectos. - -En su lugar, puedes utilizar el método :method:`Symfony\\Component\\Console\\Helper\\DialogHelper::select`, el cual se asegura de que el usuario sólo puede introducir una cadena válida de una lista predefinida:: - - $dialog = $app->getHelperSet()->get('dialog'); - $colors = array('red', 'blue', 'yellow'); - - $color = $dialog->select( - $output, - 'Please select your favorite color (default to red)', - $colors, - 0 - ); - $output->writeln('You have just selected: ' . $colors[$color]); - - // ... hace algo con el color - -La opción que se debería seleccionar por omisión la proporciona el cuarto argumento. El valor predefinido es ``null``, lo cual significa que ninguna opción es la predefinida. - -Si el usuario introduce una cadena no válida, un mensaje de error será mostrado instando al usuario a proporcionar la respuesta de nuevo, hasta que introduzca una cadena válida o alcance el máximo de intentos (el cuál puedes definir con el quinto argumento). El valor predefinido para los intentos es ``false``, lo cual significa que no hay límite en los intentos. Puedes definir tu propio mensaje de error en el sexto argumento. diff --git a/_sources/components/console/helpers/formatterhelper.txt b/_sources/components/console/helpers/formatterhelper.txt deleted file mode 100644 index 75315f7..0000000 --- a/_sources/components/console/helpers/formatterhelper.txt +++ /dev/null @@ -1,48 +0,0 @@ -.. index:: - single: Ayudantes de consola; Ayudante formateador - -Ayudante formateador -==================== - -Los ayudantes formateadores proporcionan funciones para aplicar formato al resultado con colores. -Puedes hacer cosas más avanzadas con este ayudante de las que puedes hacer con :ref:`components-console-coloring`. - -La clase :class:`Symfony\\Component\\Console\\Helper\\FormatterHelper` está incluida en el conjunto de ayudantes predefinido, el cual te puedes conseguir llamando al método :method:`Symfony\\Component\\Console\\Command\\Command::getHelperSet`:: - - $formatter = $this->getHelperSet()->get('formatter'); - -Los métodos regresan una cadena, la cual normalmente dibujas en la consola pasándola al -método :method:`OutputInterface::writeln` - -Imprimiendo mensajes en una sección ------------------------------------ - -*Symfony* ofrece un estilo definido cuándo imprimes un mensaje que pertenece a alguna -«sección». Este imprime la sección en color encerrada entre corchetes y el mensaje real a la derecha de esta. Menos el color, tiene esta apariencia: - -.. code-block:: text - - [SomeSection] Here is some message related to that section - -Para reproducir este estilo, puedes utilizar el método :method:`Symfony\\Component\\Console\\Helper\\FormatterHelper::formatSection`:: - - $formattedLine = $formatter->formatSection( - 'SomeSection', - 'Here is some message related to that section' - ); - $output->writeln($formattedLine); - -Imprimiendo mensajes en un bloque ---------------------------------- - -A veces quieres poder imprimir un bloque de texto entero con un color de fondo. *Symfony* lo usa al imprimir mensajes de error. - -Si imprimes manualmente tu mensaje de error en más de una línea, notarás que el fondo es sólo a lo largo de cada línea individual. Usa el método :method:`Symfony\\Component\\Console\\Helper\\FormatterHelper::formatBlock` para generar una producción de bloque:: - - $errorMessages = array('Error!', 'Something went wrong'); - $formattedBlock = $formatter->formatBlock($errorMessages, 'error'); - $output->writeln($formattedBlock); - -Como puedes ver, al pasar un arreglo de mensajes al método :method:`Symfony\\Component\\Console\\Helper\\FormatterHelper::formatBlock` el método crea el resultado deseado. Si pasas ``true`` como tercer argumento, el bloque será formateado con más relleno (una línea en blanco por encima y debajo de los mensajes y 2 espacios a la izquierda y derecha). - -El «estilo» exacto a utilizar en el bloque depende de ti. En este caso, estás utilizando el estilo de ``error`` predefinido, pero hay otros estilos, o puedes crear el tuyo propio. Ve :ref:`components-console-coloring`. \ No newline at end of file diff --git a/_sources/components/console/helpers/index.txt b/_sources/components/console/helpers/index.txt deleted file mode 100644 index d8a319f..0000000 --- a/_sources/components/console/helpers/index.txt +++ /dev/null @@ -1,17 +0,0 @@ -.. index:: - single: Console; Ayudantes de consola - -Los ayudantes de consola -======================== - -.. toctree:: - :hidden: - - dialoghelper - formatterhelper - progresshelper - tablehelper - -Los componentes de Consola vienen con algunos útiles ayudantes. Estos ayudantes contienen funciones para aligerar algunas tareas comunes. - -.. include:: map.rst.inc diff --git a/_sources/components/console/helpers/progresshelper.txt b/_sources/components/console/helpers/progresshelper.txt deleted file mode 100644 index 41b35d3..0000000 --- a/_sources/components/console/helpers/progresshelper.txt +++ /dev/null @@ -1,71 +0,0 @@ -.. index:: - single: Ayudantes de consola; El ayudante Progress - -El ayudante ``Progress`` -======================== - -.. versionadded:: 2.2 - El ayudante ``progress`` se añadió en *Symfony 2.2*. - -.. versionadded:: 2.3 - El método ``setCurrent`` se añadió en *Symfony 2.3*. - -Cuándo ejecutes órdenes que consumen demasiado tiempo en su ejecución, puede ser útil mostrar información de progreso, la cual se actualiza conforme se ejecuta la orden: - -.. image:: /images/components/console/progress.png - -Para mostrar detalles de progreso, usa la clase :class:`Symfony\\Component\\Console\\Helper\\ProgressHelper`, pasándole el número total de unidades, y adelanta el progreso conforme se ejecute la orden:: - - $progress = $this->getHelperSet()->get('progress'); - - $progress->start($output, 50); - $i = 0; - while ($i++ < 50) { - // ... hace algún trabajo - - // avanza la barra de progreso 1 unidad - $progress->advance(); - } - - $progress->finish(); - -.. tip:: - - Además, puedes ajustar el progreso actual llamando al método :method:`Symfony\\Component\\Console\\Helper\\ProgressHelper::setCurrent`. - -El aspecto de la barra de progreso también se puede personalizar, con una serie -de diferentes niveles de detalle. Cada uno de los cuales muestra los diferentes elementos posibles ---tal cómo porcentaje completado, una barra de progreso en movimiento, o información actual/total (por ejemplo, 10/50):: - - $progress->setFormat(ProgressHelper::FORMAT_QUIET); - $progress->setFormat(ProgressHelper::FORMAT_NORMAL); - $progress->setFormat(ProgressHelper::FORMAT_VERBOSE); - $progress->setFormat(ProgressHelper::FORMAT_QUIET_NOMAX); - // el valor predefinido - $progress->setFormat(ProgressHelper::FORMAT_NORMAL_NOMAX); - $progress->setFormat(ProgressHelper::FORMAT_VERBOSE_NOMAX); - -También puedes controlar los diferentes caracteres y el ancho utilizado por la barra de progreso:: - - // la parte terminada de la barra - $progress->setBarCharacter('='); - // la parte inacabada de la barra - $progress->setEmptyBarCharacter(' '); - $progress->setProgressCharacter('|'); - $progress->setBarWidth(50); - -Para ver otras opciones disponibles, revisa la clase :class:`Symfony\\Component\\Console\\Helper\\ProgressHelper` en la documentación de la *API*. - -.. caution:: - - Por razones de rendimiento, se prudente en no poner la cantidad total de pasos a un número alto. Por ejemplo, si estás iterando sobre una gran cantidad de elementos, considera un número de «paso» más pequeño que se actualizace en algunas iteraciones únicamente:: - - $progress->start($output, 500); - $i = 0; - while ($i++ < 50000) { - // ... hace algún trabajo - - // avanza cada 100 iteraciones - if ($i % 100 == 0) { - $progress->advance(); - } - } diff --git a/_sources/components/console/helpers/tablehelper.txt b/_sources/components/console/helpers/tablehelper.txt deleted file mode 100644 index ac22c1a..0000000 --- a/_sources/components/console/helpers/tablehelper.txt +++ /dev/null @@ -1,53 +0,0 @@ -.. index:: - single: Ayudantes de consola; Ayudante Table - -Ayudante Table -============== - -.. versionadded:: 2.3 - El ayudante ``table`` se añadió en *Symfony 2.3*. - -Cuándo construyes una aplicación de consola puede ser útil mostrar datos tabulares: - -.. image:: /images/components/console/table.png - -Para mostrar una tabla, usa la clase :class:`Symfony\\Component\\Console\\Helper\\TableHelper`, establece las cabeceras, filas y dibújala:: - - $table = $app->getHelperSet()->get('table'); - $table - ->setHeaders(array('ISBN', 'Title', 'Author')) - ->setRows(array( - array('99921-58-10-7', 'Divine Comedy', 'Dante Alighieri'), - array('9971-5-0210-0', 'A Tale of Two Cities', 'Charles Dickens'), - array('960-425-059-0', 'The Lord of the Rings', 'J. R. R. Tolkien'), - array('80-902734-1-6', 'And Then There Were None', 'Agatha Christie'), - )) - ; - $table->render($output); - -El diseño de la tabla se puede personalizar también. Hay dos maneras para personalizar la representación de la tabla: Utilizando diseños nombrados u opciones de representación personalizadas. - -Personalizando el diseño de la tabla usando diseños nombrados -------------------------------------------------------------- - -El ayudante ``table`` viene con dos diseños de tabla preconfigurados: - -* ``TableHelper::LAYOUT_DEFAULT`` - -* ``TableHelper::LAYOUT_BORDERLESS`` - -Puedes configurar el diseño utilizando el método :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setLayout`. - -Personalizando el diseño de la tabla con opciones de dibujo ------------------------------------------------------------ - -También puedes controlar cómo se dibuja la tabla poniendo los valores de la opción de dibujo: - -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setPaddingChar` -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setHorizontalBorderChar` -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setVerticalBorderChar` -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setVrossingChar` -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setVellHeaderFormat` -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setVellRowFormat` -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setBorderFormat` -* :method:`Symfony\\Component\\Console\\Helper\\TableHelper::setPadType` diff --git a/_sources/components/console/index.txt b/_sources/components/console/index.txt deleted file mode 100644 index 796abf7..0000000 --- a/_sources/components/console/index.txt +++ /dev/null @@ -1,11 +0,0 @@ -Consola -======= - -.. toctree:: - :maxdepth: 2 - - introduction - usage - single_command_tool - events - helpers/index diff --git a/_sources/components/console/introduction.txt b/_sources/components/console/introduction.txt deleted file mode 100644 index ae29f55..0000000 --- a/_sources/components/console/introduction.txt +++ /dev/null @@ -1,389 +0,0 @@ -.. index:: - single: Console; CLI - single: Componentes; Console - -El componente ``Console`` -========================= - - El componente ``Console`` facilita la creación de bellas y comprobables interfaces de línea de ordenes. - -El componente ``Console`` te permite crear instrucciones para la línea de ordenes. Tus ordenes de consola se pueden utilizar para cualquier tarea repetitiva, como tareas programadas (``cronjobs``), importaciones, u otros trabajos por lotes. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Console); -* :doc:`Instalándolo vía Composer ` (``symfony/console`` en `Packagist`_). - -.. note:: - - Windows no apoya colores *ANSI* de manera predeterminada así que el componente ``Console`` detecta y deshabilita colores donde Windows no cuenta con soporte. Sin embargo, si Windows no está configurado con un controlador *ANSI* y tus órdenes de consola invocan a otros guiones que emiten secuencias de color *ANSI*, serán mostradas como secuencias de caracteres escapadas. - - Para habilitar el apoyo de color *ANSI* en Windows, debes instalar `ANSICON`_. - -Creando una orden básica ------------------------- - -Para hacer una orden de consola que dé la bienvenida desde la línea de ordenes, crea el archivo :file:`GreetCommand.php` y agrégale lo siguiente:: - - namespace Acme\DemoBundle\Command; - - use Symfony\Component\Console\Command\Command; - use Symfony\Component\Console\Input\InputArgument; - use Symfony\Component\Console\Input\InputInterface; - use Symfony\Component\Console\Input\InputOption; - use Symfony\Component\Console\Output\OutputInterface; - - class GreetCommand extends Command - { - protected function configure() - { - $this - ->setName('demo:greet') - ->setDescription('Greet someone') - ->addArgument( - 'name', - InputArgument::OPTIONAL, - 'Who do you want to greet?' - ) - ->addOption( - 'yell', - null, - InputOption::VALUE_NONE, - 'If set, the task will yell in uppercase letters' - ) - ; - } - - protected function execute(InputInterface $input, OutputInterface $output) - { - $name = $input->getArgument('name'); - if ($name) { - $text = 'Hello '.$name; - } else { - $text = 'Hello'; - } - - if ($input->getOption('yell')) { - $text = strtoupper($text); - } - - $output->writeln($text); - } - } - -También necesitas crear el archivo para ejecutar la línea de ordenes, el cual crea una ``Application`` y le agrega ordenes:: - - #!/usr/bin/env php - add(new GreetCommand); - $application->run(); - -Prueba la nueva consola de ordenes ejecutando lo siguiente: - -.. code-block:: bash - - $ app/console demo:greet Fabien - -Esto imprimirá lo siguiente en la línea de ordenes: - -.. code-block:: text - - Hello Fabien - -También puedes utilizar la opción ``--yell`` para convertir todo a mayúsculas: - -.. code-block:: bash - - $ app/console demo:greet Fabien --yell - -Esto imprime:: - - HELLO FABIEN - -.. _components-console-coloring: - -Coloreando la salida -~~~~~~~~~~~~~~~~~~~~ - -Cada vez que produces texto, puedes escribir el texto con etiquetas para colorear tu salida. Por ejemplo:: - - // texto verde - $output->writeln('foo'); - - // texto amarillo - $output->writeln('foo'); - - // texto negro sobre fondo cían - $output->writeln('foo'); - - // texto blanco sobre fondo rojo - $output->writeln('foo'); - -Es posible definir tu propio estilo usando la clase :class:`Symfony\\Component\\Console\\Formatter\\OutputFormatterStyle`:: - - $style = new OutputFormatterStyle('red', 'yellow', array('bold', 'blink')); - $output->getFormatter()->setStyle('fire', $style); - $output->writeln('foo'); - -Los colores disponibles para el fondo y primer plano son: ``black``, ``red``, ``green``, ``yellow``, ``blue``, ``magenta``, ``cyan`` y ``white``. - -Y las opciones disponibles son: ``bold``, ``underscore``, ``blink``, ``reverse`` y ``conceal``. - -También puedes configurar estos colores y opciones dentro del nombre de la etiqueta:: - - // texto verde - $output->writeln('foo'); - - // texto negro en fondo cian - $output->writeln('foo'); - - // text negro en fondo amarillo - $output->writeln('foo'); - -Niveles de verbosidad -~~~~~~~~~~~~~~~~~~~~~ - -La consola tiene 3 niveles de verbosidad. Estos están definidos en -la clase :class:`Symfony\\Component\\Console\\Output\\OutputInterface`: - -================================== ======================================= -Opción Valor -================================== ======================================= -OutputInterface::VERBOSITY_QUIET No muestra ningún mensaje -OutputInterface::VERBOSITY_NORMAL El nivel de verbosidad predeterminado -OutputInterface::VERBOSITY_VERBOSE Incrementa la verbosidd de los mensajes -================================== ======================================= - -Puedes especificar el nivel de verbosidad tranquilo con la opción ``--quiet`` o ``-q``. La opción ``--verbose`` o ``-v`` se utiliza cuando quieres aumentar el nivel de verbosidad. - -.. tip:: - - La traza completa de la excepción se imprime si utilizas el nivel de verbosidad ``VERBOSITY_VERBOSE``. - -Es posible imprimir un mensaje en una orden para únicamente un nivel de verbosidad -específico. Por ejemplo:: - - if (OutputInterface::VERBOSITY_VERBOSE === $output->getVerbosity()) { - $output->writeln(...); - } - -Cuándo se utiliza el nivel tranquilo, toda la producción es suprimida como la regresa el método predeterminado :method:`Symfony\Component\Console\Output::write` -sin de hecho imprimirla. - -Utilizando argumentos de ordenes --------------------------------- - -La parte más interesante de las ordenes son los argumentos y opciones que puedes hacer disponibles. Los argumentos son cadenas ---separadas por espacios--- que vienen después del nombre de la orden misma. Ellos están ordenados, y pueden ser opcionales u obligatorios. Por ejemplo, añade un argumento ``last_name`` opcional a la orden y haz que el argumento ``name`` sea obligatorio:: - - $this - // ... - ->addArgument( - 'name', - InputArgument::REQUIRED, - 'Who do you want to greet?' - ) - ->addArgument( - 'last_name', - InputArgument::OPTIONAL, - 'Your last name?' - ); - -Ahora tienes acceso a un argumento ``last_name`` en la orden:: - - if ($lastName = $input->getArgument('last_name')) { - $text .= ' '.$lastName; - } - -Ahora la orden se puede utilizar en cualquiera de las siguientes maneras: - -.. code-block:: bash - - $ app/console demo:greet Fabien - $ app/console demo:greet Fabien Potencier - -Usando las opciones de la orden -------------------------------- - -A diferencia de los argumentos, las opciones no están ordenadas (lo cual significa que las puedes especificar en cualquier orden) y se especifican con dos guiones (por ejemplo, ``--yell`` también puedes declarar un atajo de una letra que puedes invocar con un único guión como ``-y``). Las opciones son: *always* opcional, y se puede configurar para aceptar un valor (por ejemplo, ``dir=src``) o simplemente como una variable lógica sin valor (por ejemplo, ``yell``). - -.. tip:: - - También es posible hacer que un argumento *opcionalmente* acepte un valor (de modo que ``--yell`` o ``yell=loud`` funcione). Las opciones también se pueden configurar para aceptar un arreglo de valores. - -Por ejemplo, añadir una nueva opción a la orden que se puede usar para especificar cuántas veces se debe imprimir el mensaje en una fila:: - - $this - // ... - ->addOption( - 'iterations', - null, - InputOption::VALUE_REQUIRED, - 'How many times should the message be printed?', - 1 - ); - -A continuación, utilízalo en la orden para imprimir el mensaje varias veces: - -.. code-block:: php - - for ($i = 0; $i < $input->getOption('iterations'); $i++) { - $output->writeln($text); - } - -Ahora, al ejecutar la tarea, si lo deseas, puedes especificar un indicador ``--iterations``: - -.. code-block:: bash - - $ app/console demo:greet Fabien - $ app/console demo:greet Fabien --iterations=5 - -El primer ejemplo sólo se imprimirá una vez, ya que ``iterations`` está vacía y el predeterminado es ``1`` (el último argumento de ``addOption``). El segundo ejemplo se imprimirá cinco veces. - -Recordemos que a las opciones no les preocupa su orden. Por lo tanto, cualquiera de las siguientes trabajará: - -.. code-block:: bash - - $ app/console demo:greet Fabien --iterations=5 --yell - $ app/console demo:greet Fabien --yell --iterations=5 - -Hay 4 variantes de la opción que puedes utilizar: - -=========================== ================================================================================================== -Opción Valor -=========================== ================================================================================================== -InputOption::VALUE_IS_ARRAY Esta opción acepta múltiples valores (por ejemplo: ``--dir=/foo --dir=/bar``) -InputOption::VALUE_NONE No acepta entradas para esta opción (por ejemplo: ``--yell``) -InputOption::VALUE_REQUIRED Este valor es obligatorio (por ejemplo: ``--iterations=5``), la opción en sí misma aún es opcional -InputOption::VALUE_OPTIONAL Esta opción puede o no tener un valor (por ejemplo: ``yell`` o ``yell=loud``) -=========================== ================================================================================================== - -Puedes combinar el VALUE_IS_ARRAY con VALUE_REQUIRED o VALUE_OPTIONAL de la siguiente manera: - -.. code-block:: php - - $this - // ... - ->addOption( - 'iterations', - null, - InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, - 'How many times should the message be printed?', - 1 - ); - -Ayudantes de consola --------------------- - -El componente ``console`` también contiene un conjunto de «ayudantes» ---pequeñas herramientas capaces de ayudarte con diferentes tareas---: - -* :doc:`/components/console/helpers/dialoghelper`: Pregunta interactivamente determinada información al usuario -* :doc:`/components/console/helpers/formatterhelper`: Personaliza la colorización del resultado :doc:`/components/console/helpers/progresshelper`: Muestra una barra de progreso - -Probando ordenes ----------------- - -*Symfony2* proporciona varias herramientas para ayudarte a probar tus ordenes. La más útil es la clase :class:`Symfony\\Component\\Console\\Tester\\CommandTester`. Esta utiliza clases entrada y salida especiales para facilitar la prueba sin una consola real:: - - use Symfony\Component\Console\Application; - use Symfony\Component\Console\Tester\CommandTester; - use Acme\DemoBundle\Command\GreetCommand; - - class ListCommandTest extends \PHPUnit_Framework_TestCase - { - public function testExecute() - { - $application = new Application(); - $application->add(new GreetCommand()); - - $command = $application->find('demo:greet'); - $commandTester = new CommandTester($command); - $commandTester->execute(array('command' => $command->getName())); - - $this->assertRegExp('/.../', $commandTester->getDisplay()); - - // ... - } - } - -El método :method:`Symfony\\Component\\Console\\Tester\\CommandTester::getDisplay` devuelve lo que se ha exhibido durante una llamada normal de la consola. - -Puedes probar enviando argumentos y opciones a la orden pasándolos como un arreglo al método :method:`Symfony\\Component\\Console\\Tester\\CommandTester::execute`:: - - use Symfony\Component\Console\Application; - use Symfony\Component\Console\Tester\CommandTester; - use Acme\DemoBundle\Command\GreetCommand; - - class ListCommandTest extends \PHPUnit_Framework_TestCase - { - // ... - - public function testNameIsOutput() - { - $application = new Application(); - $application->add(new GreetCommand()); - - $command = $application->find('demo:greet'); - $commandTester = new CommandTester($command); - $commandTester->execute( - array('command' => $command->getName(), 'name' => 'Fabien') - ); - - $this->assertRegExp('/Fabien/', $commandTester->getDisplay()); - } - } - -.. tip:: - - También puedes probar toda una aplicación de consola utilizando :class:`Symfony\\Component\\Console\\Tester\\ApplicationTester`. - -Llamando una orden existente ----------------------------- - -Si una orden depende de que se ejecute otra antes, en lugar de obligar al usuario a recordar el orden de ejecución, la puedes llamar tú mismo directamente. -Esto también es útil si deseas crear una «metaorden» que ejecute un montón de otras ordenes (por ejemplo, todas las ordenes que se deben ejecutar cuando el código del proyecto ha cambiado en los servidores de producción: vaciar la caché, generar delegados *Doctrine2*, volcar activos ``Assetic``, ...). - -Llamar a una orden desde otra es sencillo:: - - protected function execute(InputInterface $input, OutputInterface $output) - { - $command = $this->getApplication()->find('demo:greet'); - - $arguments = array( - 'command' => 'demo:greet', - 'name' => 'Fabien', - '--yell' => true, - ); - - $input = new ArrayInput($arguments); - $returnCode = $command->run($input, $output); - - // ... - } - -En primer lugar, tu :method:`Symfony\\Component\\Console\\Application::find` busca la orden que deseas ejecutar pasando el nombre de la orden. - -Entonces, es necesario crear una nueva clase :class:`Symfony\\Component\\Console\\Input\\ArrayInput` con los argumentos y opciones que desees pasar a la orden. - -Finalmente, invocar al método ``run()`` ejecuta la orden realmente y devuelve el código regresado por la orden (el valor del método ``execute()``). - -.. note:: - - La mayor parte del tiempo, llamar a una orden desde código que no se ejecuta en la línea de ordenes no es una buena idea por varias razones. En primer lugar, la salida de la orden se ha optimizado para la consola. Pero lo más importante, puedes pensar de una orden como si fuera un controlador; este debe utilizar el modelo para hacer algo y mostrar algún comentario al usuario. Así, en lugar de llamar una orden desde la *Web*, reconstruye tu código y mueve la lógica a una nueva clase. - -¡Aprende más! ------------------ - -* :doc:`/components/console/usage` -* :doc:`/components/console/single_command_tool` - -.. _`Packagist`: https://packagist.org/packages/symfony/console -.. _ANSICON: http://adoxa.3eeweb.com/ansicon/ diff --git a/_sources/components/console/single_command_tool.txt b/_sources/components/console/single_command_tool.txt deleted file mode 100644 index 54af899..0000000 --- a/_sources/components/console/single_command_tool.txt +++ /dev/null @@ -1,73 +0,0 @@ -.. index:: - single: Console; Aplicación de una sola orden - -Construyendo una aplicación de una sola orden -============================================= - -Cuándo construyes una herramienta para la línea de ordenes, posiblemente no necesites proporcionar varias órdenes. -En tal caso, tener que pasar el nombre de orden cada vez es tedioso. Afortunadamente, es posible evadir esta necesidad extendiendo la ``application``:: - - namespace Acme\Tool; - - use Symfony\Component\Console\Application; - use Symfony\Component\Console\Input\InputInterface; - - class MyApplication extends Application - { - /** - * Obtiene el nombre de la orden basándose en la entrada. - * - * @param InputInterface $input The input interface - * - * @return string The command name - */ - protected function getCommandName(InputInterface $input) - { - // Esto debería regresar el nombre de tu orden. - return 'my_command'; - } - - /** - * Obtiene las ordenes predefinidas que siempre tendrían que estar disponibles. - * - * @return array An array of default Command instances - */ - protected function getDefaultCommands() - { - // mantiene las ordenes predefinidas del núcleo - // para que tengan el HelpCommand cuál es utilizado cuándo - // se usa la opción --help - $defaultCommands = parent::getDefaultCommands(); - - $defaultCommands[] = new MyCommand(); - - return $defaultCommands; - } - - /** - * Lo sustituye para que la aplicación no espere el nombre - * de la orden como el primer argumento. - */ - public function getDefinition() - { - $inputDefinition = parent::getDefinition(); - // limpia el primer argumento de la salida normal, que es el nombre de la orden - $inputDefinition->setArguments(); - - return $inputDefinition; - } - } - -Cuándo llames a tu guión de consola, entonces siempre se utilizará la orden ``MyCommand``, sin tener que pasar su nombre. - -También puedes simplificar cómo ejecutas la aplicación:: - - #!/usr/bin/env php - run(); - diff --git a/_sources/components/console/usage.txt b/_sources/components/console/usage.txt deleted file mode 100644 index 647c61f..0000000 --- a/_sources/components/console/usage.txt +++ /dev/null @@ -1,131 +0,0 @@ -.. index:: - single: Console; Usando - -Usando órdenes de consola, atajos y órdenes integradas -====================================================== - -Además de las opciones que especifiques para tus órdenes, hay algunas opciones integradas así como un par de órdenes para el componente ``console``. - -.. note:: - - Estos ejemplos suponen que añadiste un archivo :file:`app/console` para ejecutarlo en la interfaz de la línea de ordenes:: - - #!/usr/bin/env php - # app/console - run(); - -Ordenes integradas -~~~~~~~~~~~~~~~~~~ - -Hay una orden ``list`` integrada que produce todas las opciones y ordenes estándar registradas: - -.. code-block:: bash - - $ php app/console list - -También puedes obtener el mismo resultado sin especificar ninguna orden: - -.. code-block:: bash - - $ php app/console - -La orden ``help`` produce toda la información de ayuda para la orden especificada. Por ejemplo, para conseguir ayuda para la orden ``list``: - -.. code-block:: bash - - $ php app/console help list - -Al ejecutar ``help`` sin especificar una orden enumerará las opciones globales: - -.. code-block:: bash - - $ php app/console help - -Opciones globales -~~~~~~~~~~~~~~~~~ - -Puedes conseguir información de ayuda para cualquier orden con la opción ``--help``. Para conseguir ayuda para la orden ``list``: - -.. code-block:: bash - - $ php app/console list --help - $ php app/console list -h - -Puedes suprimir el resultado con: - -.. code-block:: bash - - $ php app/console list --quiet - $ php app/console list -q - -Puedes conseguir mensajes más detallados (si la orden cuenta con tal información) con: - -.. code-block:: bash - - $ php app/console list --verbose - $ php app/console list -v - -Si pusiste los argumentos opcionales para dar a tu aplicación un nombre y versión:: - - $application = new Application('Acme Console Application', '1.2'); - -Entonces puedes usar: - -.. code-block:: bash - - $ php app/console list --version - $ php app/console list -V - -para lograr mostrar esta información: - -.. code-block:: text - - Acme Console Application version 1.2 - -Si no proporcionaste ambos argumentos entonces solo producirá: - -.. code-block:: text - - console tool - -Puedes forzar el coloreado *ANSI* del resultado con: - -.. code-block:: bash - - $ php app/console list --ansi - -O apagarlo con: - -.. code-block:: bash - - $ php app/console list --no-ansi - -Puedes suprimir cualquier pregunta interactiva de la orden que estés ejecutando con: - -.. code-block:: bash - - $ php app/console list --no-interaction - $ php app/console list -n - -Sintaxis de atajos -~~~~~~~~~~~~~~~~~~ - -No tienes que escribir los nombres de las ordenes completos. Sólo escribe el nombre unívoco más corto para ejecutar una orden. Por lo tanto si las ordenes no chocan, entonces puedes ejecutar ``help`` así: - -.. code-block:: bash - - $ php app/console h - -Si tienes ordenes que utilizan ``:`` para un espacio de nombres entonces solo tienes que escribir el texto unívoco más corto para cada parte. Si has creado el ejemplo ``demo:greet`` como muestra :doc:`/components/console/introduction`, entonces lo puedes ejecutar con: - -.. code-block:: bash - - $ php app/console d:g Fabien - -Si escoges una orden demasiado corta y por tanto ambigua (es decir, que más de una orden coincide), entonces ninguna orden será ejecutada y mostrará algunas sugerencias con las posibles ordenes que puedes elegir. diff --git a/_sources/components/css_selector.txt b/_sources/components/css_selector.txt deleted file mode 100644 index 6e8dc45..0000000 --- a/_sources/components/css_selector.txt +++ /dev/null @@ -1,75 +0,0 @@ -.. index:: - single: Selector CSS - single: Componentes; CssSelector - -El componente ``CssSelector`` -============================= - - El componente ``CssSelector`` convierte selectores *CSS* a expresiones ``XPath``. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/CssSelector); -* :doc:`Instalándolo vía via Composer ` (``symfony/css-selector`` en `Packagist`_). - -Usando ------- - -¿Por qué usar selectores *CSS*? -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando estás analizando un archivo *HTML* o un documento *XML*, con mucho, el método más poderoso -es *XPath*. - -Las expresiones *XPath* son increíblemente flexibles, por lo tanto casi siempre hay una expresión *XPath* que encuentra el elemento que necesitas. Desafortunadamente, también puede llegar a ser muy complicado, y la curva de aprendizaje es muy empinada. Incluso operaciones comunes (por ejemplo, la búsqueda de un elemento con una clase en particular) puede requerir expresiones largas y difíciles de manejar. - -Muchos desarrolladores ---particularmente los desarrolladores web--- se sienten más cómodos usando selectores *CSS* para encontrar elementos. Además de trabajar en hojas de estilo, los selectores *CSS* se utilizan en *Javascript* con la función ``querySelectorAll`` y en las bibliotecas populares de *Javascript* como *jQuery*, *Prototype* y *MooTools*. - -Los selectores *CSS* son menos poderosos que *XPath*, pero mucho más fáciles de escribir, leer -y entender. Debido a que son menos poderosos, casi todos los selectores *CSS* se pueden convertir a una expresión *XPath* equivalente. Entonces, puedes utilizar esta expresión *XPath* con otras funciones y clases que utilizan *XPath* para buscar elementos en un documento. - -El componente ``CssSelector`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El único objetivo del componente es el de convertir selectores *CSS* a su *XPath* -equivalente:: - - use Symfony\Component\CssSelector\CssSelector; - - print CssSelector::toXPath('div.item > h4 > a'); - -Esto produce el siguiente resultado: - -.. code-block:: text - - descendant-or-self::div[contains(concat(' ',normalize-space(@class), ' '), ' item ')]/h4/a - -Puedes utilizar esta expresión con, por ejemplo, :phpclass:`DOMXPath` o :phpclass:`SimpleXMLElement` para encontrar elementos en un documento. - -.. tip:: - - El método :method:`Crawler::filter()` utiliza el componente ``CssSelector`` para encontrar elementos basándose en una cadena selectora *CSS*. Ve :doc:`/components/dom_crawler` para más detalles. - -Limitaciones del componente ``cssSelector`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -No todos los selectores *CSS* se pueden convertir a *XPath* equivalentes. - -Hay varios selectores *CSS* que sólo tienen sentido en el contexto de un navegador *web*. - -* estado de selectores de enlace: ``:link``, ``:visited``, ``:target`` -* selectores basados en la acción del usuario: ``:hover``, ``:focus``, ``:active`` -* Estado de selectores de la interfaz del usuario: ``:enabled``, ``:disabled``, ``:indeterminate`` (``however``, ``:checked`` y ``:unchecked`` están disponibles) - -Seudoelementos (``:before``, ``:after``, ``:first-line``, ``:first-letter``) no son compatibles, debido a que seleccionan porciones de texto en lugar de elementos. - -Algunas seudoclases todavía no cuentan con soporte: - -* ``:lang(language)`` -* ``root`` -* ``*:first-of-type``, ``*:last-of-type``, ``*:nth-of-type``, ``*:nth-last-of-type``, ``*:only-of-type``. (Estas funcionan con un elemento nombre (por ejemplo ``li:first-of-type``), pero no con ``*``. - -.. _`Packagist`: https://packagist.org/packages/symfony/css-selector \ No newline at end of file diff --git a/_sources/components/debug.txt b/_sources/components/debug.txt deleted file mode 100644 index 48911d3..0000000 --- a/_sources/components/debug.txt +++ /dev/null @@ -1,74 +0,0 @@ -.. index:: - single: Depuración - single: Componentes; Debug - -El componente ``Debug`` -======================= - - El componente ``Debug`` proporciona herramientas para facilitar la depuración del código PHP. - -.. versionadded:: 2.3 - El componente ``Debug`` es nuevo en *Symfony 2.3*. Anteriormente, las clases se localizaban en el componente ``HttpKernel``. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Debug); -* :doc:`Instalándolo vía Composer ` (``symfony/debug`` en `Packagist`_). - -Usando ------- - -The Debug component provides several tools to help you debug PHP code. -Enabling them all is as easy as it can get:: - - use Symfony\Component\Debug\Debug; - - Debug::enable(); - -The :method:`Symfony\\Component\\Debug\\Debug::enable` method registers an -error handler and an exception handler. If the :doc:`ClassLoader component -` is available, a special class loader is also -registered. - -Read the following sections for more information about the different available -tools. - -.. caution:: - - You should never enable the debug tools in a production environment as - they might disclose sensitive information to the user. - -Enabling the Error Handler --------------------------- - -The :class:`Symfony\\Component\\Debug\\ErrorHandler` class catches PHP errors -and converts them to exceptions (of class :phpclass:`ErrorException` or -:class:`Symfony\\Component\\Debug\\Exception\\FatalErrorException` for PHP -fatal errors):: - - use Symfony\Component\Debug\ErrorHandler; - - ErrorHandler::register(); - -Enabling the Exception Handler ------------------------------- - -The :class:`Symfony\\Component\\Debug\\ExceptionHandler` class catches -uncaught PHP exceptions and converts them to a nice PHP response. It is useful -in debug mode to replace the default PHP/XDebug output with something prettier -and more useful:: - - use Symfony\Component\Debug\ExceptionHandler; - - ExceptionHandler::register(); - -.. note:: - - If the :doc:`HttpFoundation component ` is - available, the handler uses a Symfony Response object; if not, it falls - back to a regular PHP response. - -.. _`Packagist`: https://packagist.org/packages/symfony/debug diff --git a/_sources/components/dependency_injection.txt b/_sources/components/dependency_injection.txt deleted file mode 100644 index 07b6465..0000000 --- a/_sources/components/dependency_injection.txt +++ /dev/null @@ -1,268 +0,0 @@ -.. index:: - single: Inyección de dependencias - -El componente ``Inyección de dependencias`` -=========================================== - - El componente ``Inyección de dependencias``, te permite estandarizar y centralizar la forma en que se construyen los objetos en tu aplicación. - -Para una introducción general a los contenedores de inyección de dependencias y servicios consulta el capítulo :doc:`/book/service_container` del libro. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/DependencyInjection); -* Instalándolo a través de *PEAR* ( `pear.symfony.com/DependencyInjection`); -* Instalándolo vía ``Composer`` (`symfony/dependency-injection` en Packagist). - -Uso básico ----------- - -Tal vez tengas una simple clase ``Mailer`` como la siguiente, la cual quieres hacer disponible como un servicio: - -.. code-block:: php - - class Mailer - { - private $transport; - - public function __construct() - { - $this->transport = 'sendmail'; - } - - // ... - } - -La puedes registrar en el contenedor como un servicio: - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $sc = new ContainerBuilder(); - $sc->register('mailer', 'Mailer'); - -Una mejora a la clase para hacerla más flexible sería permitir que el contenedor establezca el ``transporte`` utilizado. Si cambias la clase para que este sea pasado al constructor: - -.. code-block:: php - - class Mailer - { - private $transport; - - public function __construct($transport) - { - $this->transport = $transport; - } - - // ... - } - -Entonces, puedes configurar la opción de transporte en el contenedor: - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $sc = new ContainerBuilder(); - $sc->register('mailer', 'Mailer') - ->addArgument('sendmail')); - -Esta clase ahora es mucho más flexible puesto que hemos separado la elección del transporte fuera de la implementación y en el contenedor. - -Qué transporte de correo has elegido, puede ser algo sobre lo cual los demás servicios necesitan saber. Puedes evitar tener que cambiarlo en varios lugares volviéndolo un parámetro en el contenedor y luego refiriendo este parámetro como argumento para el constructor del servicio ``Mailer``: - - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $sc = new ContainerBuilder(); - $sc->setParameter('mailer.transport', 'sendmail'); - $sc->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%')); - -Ahora que el servicio ``mailer`` está en el contenedor lo puedes inyectar como una dependencia de otras clases. Si tienes una clase ``NewsletterManager`` como esta: - -.. code-block:: php - - use Mailer; - - class NewsletterManager - { - private $mailer; - - public function __construct(Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -Entonces, también la puedes registrar como un servicio y pasarla a servicio ``mailer``: - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Reference; - - $sc = new ContainerBuilder(); - - $sc->setParameter('mailer.transport', 'sendmail'); - $sc->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%')); - - $sc->register('newsletter_manager', 'NewsletterManager') - ->addArgument(new Reference('mailer')); - -Si el ``NewsletterManager`` no requiere el ``Mailer`` y la inyección sólo era opcional, entonces, puedes utilizar el método definidor para inyectarlo en su lugar: - -.. code-block:: php - - use Mailer; - - class NewsletterManager - { - private $mailer; - - public function setMailer(Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -Ahora puedes optar por no inyectar un ``Mailer`` en el ``NewsletterManager``. -Si quieres, aunque entonces el contenedor puede llamar al método definidor: - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Reference; - - $sc = new ContainerBuilder(); - - $sc->setParameter('mailer.transport', 'sendmail'); - $sc->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%')); - - $sc->register('newsletter_manager', 'NewsletterManager') - ->addMethodCall('setMailer', new Reference('mailer')); - -A continuación, puedes obtener tu servicio ``newsletter_manager`` desde el contenedor de esta manera: - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Reference; - - $sc = new ContainerBuilder(); - - //-- - - $newsletterManager = $sc->get('newsletter_manager'); - -Evitando que tu código sea dependiente en el contenedor -------------------------------------------------------- - -Si bien puedes recuperar los servicios directamente desde el contenedor, lo mejor es minimizar esto. Por ejemplo, en el ``NewsletterManager`` inyectamos el servicio ``Mailer`` en vez de solicitarlo desde el contenedor. -Podríamos haber inyectado el contenedor y recuperar el servicio ``Mailer`` desde ahí, pero entonces, estaría vinculado a este contenedor particular, lo cual dificulta la reutilización de la clase en otro lugar. - -Tendrás que conseguir un servicio desde el contenedor en algún momento, pero esto debe ser tan pocas veces como sea posible en el punto de entrada a tu aplicación. - -Configurando el contenedor con archivos de configuración --------------------------------------------------------- - -Así como la creación de los servicios utilizando *PHP* ---como arriba--- también puedes utilizar archivos de configuración. Para ello además necesitas instalar el componente ``Config``: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Config); -* Instalándolo a través de *PEAR* ( `pear.symfony.com/Config`); -* Instalándolo vía ``Composer`` (`symfony/config` en Packagist). - -Cargando un archivo de configuración *XML*: - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\Config\FileLocator; - use Symfony\Component\DependencyInjection\Loader\XmlFileLoader; - - $sc = new ContainerBuilder(); - $loader = new XmlFileLoader($sc, new FileLocator(__DIR__)); - $loader->load('services.xml'); - -Cargando un archivo de configuración *YAML*: - -.. code-block:: php - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\Config\FileLocator; - use Symfony\Component\DependencyInjection\Loader\YamlFileLoader; - - $sc = new ContainerBuilder(); - $loader = new YamlFileLoader($sc, new FileLocator(__DIR__)); - $loader->load('services.yml'); - -Puedes configurar los servicios ``newsletter_manager`` y ``mailer`` usando archivos de configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/HelloBundle/Resources/config/services.yml - parameters: - # ... - mailer.transport: sendmail - - services: - my_mailer: - class: Mailer - arguments: [@mailer] - newsletter_manager: - class: NewsletterManager - calls: - - [ setMailer, [ @mailer ] ] - - .. code-block:: xml - - - - - sendmail - - - - - %mailer.transport% - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Reference; - - // ... - $sc->setParameter('mailer.transport', 'sendmail'); - $sc->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%')); - - $sc->register('newsletter_manager', 'NewsletterManager') - ->addMethodCall('setMailer', new Reference('mailer')); - - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/service_container/factories` -* :doc:`/cookbook/service_container/parentservices` diff --git a/_sources/components/dependency_injection/advanced.txt b/_sources/components/dependency_injection/advanced.txt deleted file mode 100644 index 9aeb9b1..0000000 --- a/_sources/components/dependency_injection/advanced.txt +++ /dev/null @@ -1,111 +0,0 @@ -.. index:: - single: Inyección de dependencias; Configuración avanzada - -Configuración avanzada del contenedor -===================================== - -Marcando servicios como públicos/privados ------------------------------------------ - -Cuando definas servicios, generalmente, querrás poder acceder a estas definiciones dentro del código de tu aplicación. Estos servicios se llaman ``public``. Por ejemplo, el servicio ``doctrine`` registrado en el contenedor cuando se utiliza ``DoctrineBundle`` es un servicio público al que puedes acceder a través de:: - - $doctrine = $container->get('doctrine'); - -Sin embargo, hay casos de uso cuando no quieres que un servicio sea público. Esto es común cuando sólo se define un servicio, ya que se podría utilizar como argumento para otro servicio. - -.. note:: - - Si utilizas un servicio privado como único argumento para otro servicio, resultará en la creación de ejemplares (por ejemplo. ``new PrivateFooBar()``) dentro de este otro servicio, haciéndolo públicamente inutilizable en tiempo de ejecución. - -Simplemente dice: El servicio será privado cuando no deseas acceder a él directamente desde tu código. - -Aquí está un ejemplo: - -.. configuration-block:: - - .. code-block:: yaml - - services: - foo: - class: Example\Foo - public: false - - .. code-block:: xml - - - - .. code-block:: php - - $definition = new Definition('Example\Foo'); - $definition->setPublic(false); - $container->setDefinition('foo', $definition); - -Ahora que el servicio es privado, *no* puedes llamar a:: - - $container->get('foo'); - -Sin embargo, si has marcado un servicio como privado, todavía puedes asignarle un alias (ve más abajo) para acceder a este servicio (a través del alias). - -.. note:: - - De manera predeterminada los servicios son públicos. - -Apodando --------- - -A veces posiblemente quieras usar atajos para acceder a algunos servicios. Lo puedes hacer por su alias y, además, incluso puedes apodar servicios no públicos. - -.. configuration-block:: - - .. code-block:: yaml - - services: - foo: - class: Example\Foo - bar: - alias: foo - - .. code-block:: xml - - - - - - .. code-block:: php - - $definition = new Definition('Example\Foo'); - $container->setDefinition('foo', $definition); - - $containerBuilder->setAlias('bar', 'foo'); - -Esto significa que cuando utilizas el contenedor directamente, puedes acceder al servicio ``foo`` al pedir el servicio ``bar`` así:: - - $container->get('bar'); // debería devolver el servicio foo - -Requiriendo archivos --------------------- - -Puede haber casos de uso cuando necesites incluir otro archivo justo antes de cargar el servicio en sí. Para ello, puedes utilizar la directiva ``file``. - -.. configuration-block:: - - .. code-block:: yaml - - services: - foo: - class: Example\Foo\Bar - file: "%kernel.root_dir%/src/ruta/al/archivo/foo.php" - - .. code-block:: xml - - - %kernel.root_dir%/src/ruta/al/archivo/foo.php - - - .. code-block:: php - - $definition = new Definition('Example\Foo\Bar'); - $definition->setFile('%kernel.root_dir%/src/ruta/al/archivo/foo.php'); - $container->setDefinition('foo', $definition); - -Ten en cuenta que internamente *Symfony* llama a la función *PHP* ``require_once``, lo cual significa que el archivo se incluirá una sola vez por petición. diff --git a/_sources/components/dependency_injection/compilation.txt b/_sources/components/dependency_injection/compilation.txt deleted file mode 100644 index 7ce902f..0000000 --- a/_sources/components/dependency_injection/compilation.txt +++ /dev/null @@ -1,416 +0,0 @@ -.. index:: - single: Inyección de dependencias; Compilación - -Compilando el contenedor -======================== - -El contenedor de servicios se puede compilar por varios motivos. Estas razones incluyen la comprobación de posibles problemas, tal como referencias circulares y volver más eficiente al contenedor usando la resolución de parámetros y remoción de servicios no utilizados. - -Se compila ejecutando:: - - $container->compile(); - -El método de compilación utiliza «\ ``Compiler Passes``\ » para la compilación. El componente *Inyección de dependencias* viene con varios pases que se registran automáticamente para la compilación. Por ejemplo, la clase :class:`Symfony\\Component\\DependencyInjection\\Compiler\\CheckDefinitionValidityPass` comprueba varios potenciales problemas relacionados con las definiciones que se han establecido en el contenedor. Después de este y varios otros pases que comprueban la validez del contenedor, se utilizan pases adicionales del compilador para optimizar la configuración antes de almacenarla en caché. Por ejemplo, se quitan los servicios privados y abstractos, y se resuelven los alias. - -.. _components-dependency-injection-extension: - -Gestionando la configuración con extensiones --------------------------------------------- - -Así como cargar la configuración directamente en el contenedor como se muestra en :doc:`/components/dependency_injection/introduction`, la puedes gestionar registrando extensiones en el contenedor. El primer paso en el proceso de compilación es cargar en el contenedor la configuración de cualquier clase registrada en la extensión. A diferencia de la configuración cargada directamente, esta sólo se procesa cuándo el contenedor es compilado. Si tu aplicación es modular entonces las extensiones dejan que cada módulo registre y gestione su propio servicio de configuración. - -Las extensiones deben implementar la :class:`Symfony\\Component\\DependencyInjection\\Extension\\ExtensionInterface` y las puedes registrar en el contenedor con:: - - $container->registerExtension($extension); - -El trabajo principal de la extensión se realiza en el método ``load``. En el método ``load`` puedes cargar la configuración desde uno o más archivos de configuración, así como manipular las definiciones del contenedor utilizando los métodos indicados en :doc:`/components/dependency_injection/definitions`. - -Al método ``load`` se le pasa un nuevo contenedor para configurarlo, el cual posteriormente se fusiona en el contenedor con el que se haya registrado. Esto te permite tener varias extensiones para gestionar las definiciones del contenedor de forma independiente. -Las extensiones no agregan configuración a los contenedores cuando se añaden, pero se procesan cuando se llama al método ``compile`` del contenedor. - -Una muy sencilla extensión puede justo cargar al contenedor archivos de configuración:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Loader\XmlFileLoader; - use Symfony\Component\DependencyInjection\Extension\ExtensionInterface; - use Symfony\Component\Config\FileLocator; - - class AcmeDemoExtension implements ExtensionInterface - { - public function load(array $configs, ContainerBuilder $container) - { - $loader = new XmlFileLoader( - $container, - new FileLocator(__DIR__.'/../Resources/config') - ); - $loader->load('services.xml'); - } - - // ... - } - -Esto no mejora mucho comparado a cargar el archivo directamente al construir el contenedor global. Justo deja los archivos para ser divididos entre módulos/paquetes. Para poder afectar la configuración de un módulo desde archivos de configuración externos al módulo/paquete es necesario hacer configurable una aplicación compleja. Esto se puede hacer especificando se carguen secciones de archivos de configuración directamente al contenedor cuando son para una extensión en particular. Estas secciones en la configuración no serán procesadas directamente por el contenedor sino por la extensión pertinente. - -La extensión debe especificar un método ``getAlias`` para implementar la interfaz:: - - // ... - - class AcmeDemoExtension implements ExtensionInterface - { - // ... - - public function getAlias() - { - return 'acme_demo'; - } - } - -Para archivos de configuración *YAML* especificar el alias para la extensión como clave significará que aquellos valores se pasan al método ``load`` de la extensión: - -.. code-block:: yaml - - # ... - acme_demo: - foo: fooValue - bar: barValue - -Si este archivo se carga en la configuración entonces los valores en él sólo son -procesados cuándo el contenedor es compilado en el punto que se cargan las extensiones:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\Config\FileLocator; - use Symfony\Component\DependencyInjection\Loader\YamlFileLoader; - - $container = new ContainerBuilder(); - $container->registerExtension(new AcmeDemoExtension); - - $loader = new YamlFileLoader($container, new FileLocator(__DIR__)); - $loader->load('config.yml'); - - // ... - $container->compile(); - -.. note:: - - Al cargar un archivo de configuración que usa un alias de extensión como clave, la extensión ya se debe haber registrado en el constructor del contenedor o se lanzará una excepción. - -Los valores de esas secciones de los archivos de configuración se pasan en el primer -argumento del método ``load`` de la extensión:: - - public function load(array $configs, ContainerBuilder $container) - { - $foo = $configs[0]['foo']; //fooValue - $bar = $configs[0]['bar']; //barValue - } - -El argumento ``$configs`` es un arreglo conteniendo cada diferente archivo de configuración que se carga en el contenedor. Sólo estás cargando un único archivo de configuración en el ejemplo anterior pero todavía será en un arreglo. El arreglo se verá como este:: - - array( - array( - 'foo' => 'fooValue', - 'bar' => 'barValue', - ), - ) - -Si bien puedes gestionar manualmente la fusión de diferentes archivos, es mucho mejor -utilizar el :doc:`componente Config ` para combinar -y validar los valores de configuración. Usando el procesamiento de configuración podrías acceder a los valores de configuración de la siguiente manera:: - - use Symfony\Component\Config\Definition\Processor; - // ... - - public function load(array $configs, ContainerBuilder $container) - { - $configuration = new Configuration(); - $processor = new Processor(); - $config = $processor->processConfiguration($configuration, $configs); - - $foo = $config['foo']; //fooValue - $bar = $config['bar']; //barValue - - // ... - } - -Aun faltan dos métodos que debes implementar. Uno para regresar el espacio de nombres *XML* de modo que las partes pertinentes de un archivo de configuración *XML* es pasado a la extensión. El otro para especificar la ruta a los archivos *XSD* base para validar la configuración *XML*:: - - public function getXsdValidationBasePath() - { - return __DIR__.'/../Resources/config/'; - } - - public function getNamespace() - { - return 'http://www.ejemplo.com/symfony/schema/'; - } - -.. note:: - - La validación *XSD* es opcional, regresando ``false`` desde el método ``getXsdValidationBasePath`` lo inhabilitará. - -La versión *XML* de la configuración entonces se parecería a esta: - -.. code-block:: xml - - - - - - fooValue - barValue - - - - -.. note:: - - En la plataforma *Symfony2* completa hay una clase ``Extensión`` base que implementa estos métodos así como un acceso directo al método para procesar la configuración. Consulta :doc:`/cookbook/bundles/extension` para más detalles. - -El valor de configuración procesado ahora se puede añadir como parámetro del contenedor como si estuviera enumerado en una sección ``parameters`` del archivo de configuración pero con el beneficio adicional de fusionar y validar múltiples archivos de configuración:: - - public function load(array $configs, ContainerBuilder $container) - { - $configuration = new Configuration(); - $processor = new Processor(); - $config = $processor->processConfiguration($configuration, $configs); - - $container->setParameter('acme_demo.FOO', $config['foo']); - - // ... - } - -Puedes proveer requisitos de configuración más complejos para las clases en la extensión. Por ejemplo, puedes elegir cargar un archivo de configuración de un servicio principal pero también cargar uno secundario sólo si se ajusta un determinado parámetro:: - - public function load(array $configs, ContainerBuilder $container) - { - $configuration = new Configuration(); - $processor = new Processor(); - $config = $processor->processConfiguration($configuration, $configs); - - $loader = new XmlFileLoader( - $container, - new FileLocator(__DIR__.'/../Resources/config') - ); - $loader->load('services.xml'); - - if ($config['advanced']) { - $loader->load('advanced.xml'); - } - } - -.. note:: - - El sólo hecho de registrar una extensión en el contenedor no es suficiente para lograr que se incluya en las extensiones procesadas al compilar el contenedor. - Al cargar la configuración que utiliza el alias de la extensión como clave como en los ejemplos anteriores te aseguras de que estas estensiones sean cargadas. También puedes instruir al constructor del contenedor para que las cargue con su método :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::loadFromExtension`:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $container = new ContainerBuilder(); - $extension = new AcmeDemoExtension(); - $container->registerExtension($extension); - $container->loadFromExtension($extension->getAlias()); - $container->compile(); - - -.. note:: - - Si necesitas manipular la configuración cargada por una extensión, entonces no lo puedes hacer desde otra extensión, ya que esta utiliza un contenedor nuevo. - En su lugar, debes utilizar un pase del compilador que trabaje con el contenedor completo después de haber procesado las extensiones. - -.. _components-dependency-injection-compiler-passes: - -Añadiendo al principio la configuración pasada a la extensión -------------------------------------------------------------- - -.. versionadded:: 2.2 - La habilidad para añadir al principio la configuración de un paquete es nueva en *Symfony 2.2*. - -Una Extensión puede prefijar la configuración de cualquier paquete antes del método ``load()`` llamada al implementar la :class:`Symfony\\Component\\DependencyInjection\\Extension\\PrependExtensionInterface`:: - - use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface; - // ... - - class AcmeDemoExtension implements ExtensionInterface, PrependExtensionInterface - { - // ... - - public function prepend() - { - // ... - - $container->prependExtensionConfig($name, $config); - - // ... - } - } - -Para más detalles, ve :doc:`/cookbook/bundles/prepend_extension`, la cual es específica a la plataforma *Symfony2*, pero contiene más detalles sobre esta característica. - -Creando un pase del compilador ------------------------------- - -También puedes crear y registrar tu propio pase del compilador en el contenedor. -Para crear un pase del compilador tienes que implementar la interfaz :class:`Symfony\\Component\\DependencyInjection\\Compiler\\CompilerPassInterface`. El compilador te brinda la oportunidad de manipular las definiciones de los servicios que se han compilado. Esto puede ser muy poderoso, pero no es algo necesario en el uso cotidiano. - -El pase del compilador debe tener el método ``process`` que se pasa al contenedor compilado:: - - use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface; - use Symfony\Component\DependencyInjection\ContainerBuilder; - - class CustomCompilerPass implements CompilerPassInterface - { - public function process(ContainerBuilder $container) - { - // ... - } - } - -Los parámetros del contenedor y las definiciones se pueden manipular usando los métodos descritos en :doc:`/components/dependency_injection/definitions`. -Una cosa común por hacer en un pase del compilador es buscar todos los servicios que tienen una determinada etiqueta, a fin de procesarla de alguna manera o dinámicamente conectar cada una con algún otro servicio. - -Registrando un pase del compilador ----------------------------------- - -Necesitas registrar tu pase personalizado del compilador en el contenedor. El método ``process`` será llamado al compilar el contenedor:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $container = new ContainerBuilder(); - $container->addCompilerPass(new CustomCompilerPass); - -.. note:: - - Los pases del compilador son registrados de manera diferente si estás usando la pila completa de la plataforma, ve :doc:`/cookbook/service_container/compiler_passes` para más detalles. - -Controlando el orden de los pases -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Los pases predeterminados del compilador se agrupan en pases de optimización y pases de remoción. Los pases de optimización se ejecutan primero e incluyen tareas como la resolución de referencias con las definiciones. Los pases de remoción realizan tareas tales como la eliminación de alias privados y servicios no utilizados. Puedes elegir en qué orden se ejecutará cualquier pase personalizado que añadas. De manera predeterminada, se ejecutará antes de los pases de optimización. - -Puedes utilizar las siguientes constantes como segundo argumento al registrar un pase en el contenedor para controlar en qué orden va: - -* ``PassConfig::TYPE_BEFORE_OPTIMIZATION`` -* ``PassConfig::TYPE_OPTIMIZE`` -* ``PassConfig::TYPE_BEFORE_REMOVING`` -* ``PassConfig::TYPE_REMOVE`` -* ``PassConfig::TYPE_AFTER_REMOVING`` - -Por ejemplo, para correr tu pase personalizado después de quitar el pase predeterminado tienes que ejecutar:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Compiler\PassConfig; - - $container = new ContainerBuilder(); - $container->addCompilerPass( - new CustomCompilerPass, - PassConfig::TYPE_AFTER_REMOVING - ); - -.. _components-dependency-injection-dumping: - -Vertiendo la configuración para mejorar el rendimiento ------------------------------------------------------- - -Puede ser mucho más fácil entender el uso de los archivos de configuración para gestionar el contenedor de servicios que usar *PHP* una vez que hay una gran cantidad de servicios. Esta facilidad tiene un costo, aunque cuando se trata de rendimiento, puesto que los archivos de configuración se tienen que analizar y la configuración de *PHP* construida desde ellos. El proceso de compilación hace más eficiente al contenedor pero toma tiempo su ejecución. Puedes tener lo mejor de ambos mundos aunque usando archivos de configuración y, luego vertiendo y almacenando en caché la configuración resultante. El ``PhpDumper`` fácilmente vierte el contenedor compilado:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Dumper\PhpDumper; - - $file = __DIR__ .'/cache/container.php'; - - if (file_exists($file)) { - require_once $file; - $container = new ProjectServiceContainer(); - } else { - $container = new ContainerBuilder(); - // ... - $container->compile(); - - $dumper = new PhpDumper($container); - file_put_contents($file, $dumper->dump()); - } - -``ProjectServiceContainer`` es el nombre predeterminado aplicado a la clase vertida en el contenedor, aun así, lo puedes cambiar con la opción ``class`` cuándo lo viertes:: - - // ... - $file = __DIR__ .'/cache/container.php'; - - if (file_exists($file)) { - require_once $file; - $container = new MyCachedContainer(); - } else { - $container = new ContainerBuilder(); - // ... - $container->compile(); - - $dumper = new PhpDumper($container); - file_put_contents( - $file, - $dumper->dump(array('class' => 'MyCachedContainer')) - ); - } - -Ahora obtendrás la velocidad del contenedor *PHP* configurado con ---los fáciles de usar--- archivos de configuración. Además verter el contenedor de este modo optimiza aún más la manera en que son creados los servicios por el contenedor. - -En el ejemplo anterior tendrás que borrar los archivos del contenedor memorizados en caché cada vez que hagas algún cambio. Añadir una comprobación por una variable que determina si estás en modo de depuración te permite mantener la velocidad del contenedor memorizado en caché en producción, sino consiguiendo una actualización de la configuración, mientras desarrollas tu aplicación:: - - // ... - - // basándose en algo de tu proyecto - $isDebug = ...; - - $file = __DIR__ .'/cache/container.php'; - - if (!$isDebug && file_exists($file)) { - require_once $file; - $container = new MyCachedContainer(); - } else { - $container = new ContainerBuilder(); - // ... - $container->compile(); - - if (!$isDebug) { - $dumper = new PhpDumper($container); - file_put_contents( - $file, - $dumper->dump(array('class' => 'MyCachedContainer')) - ); - } - } - -Esto se podría mejorar aún más únicamente recompilando el contenedor en modo de depuración cuándo se han hecho cambios a su configuración en lugar de en cada petición. Esto se puede hacer memorizando en caché los archivos de recurso usados para configurar el contenedor de la manera descrita en «:doc:`/components/config/caching`» en la documentación de configuración del componente. - -No necesitas preocuparte de cuál archivo memorizar en caché puesto que el constructor del contenedor mantiene la pista de todos los recursos utilizados para configurarlo, no solo los archivos de configuración sino las clases de extensión y pases del compilador también. Esto significa que cualquier cambio a cualquiera de estos archivos invalidará la caché y provocará la reconstrucción del contenedor. Sólo necesitas preguntar el contenedor por estos recursos y utilizarlos como metadatos para la caché:: - - // ... - - // basándose en algo de tu proyecto - $isDebug = ...; - - $file = __DIR__ .'/cache/container.php'; - $containerConfigCache = new ConfigCache($file, $isDebug); - - if (!$containerConfigCache->isFresh()) { - $containerBuilder = new ContainerBuilder(); - // ... - $containerBuilder->compile(); - - $dumper = new PhpDumper($containerBuilder); - $containerConfigCache->write( - $dumper->dump(array('class' => 'MyCachedContainer')), - $containerBuilder->getResources() - ); - } - - require_once $file; - $container = new MyCachedContainer(); - -Ahora la caché vertida al contenedor se utiliza independientemente de si el modo de depuración está activo o no. -La diferencia es que el ``ConfigCache`` está puesto en modo para depurar con su segundo -argumento del constructor. Cuándo la caché no está en modo de depuración siempre se utilizará el contenedor memorizado en caché, si existe. En modo de depuración, un archivo de metadatos adicional se escribe con la marca de tiempo de todos los archivos de recursos. Entonces, estos se comprueban para ver si los archivos han cambiado, si están en caché se consideran viejos. - -.. note:: - - En la pila completa de la plataforma se tiene cuidado por ti de la compilación y almacenamiento en caché del contenedor. diff --git a/_sources/components/dependency_injection/configurators.txt b/_sources/components/dependency_injection/configurators.txt deleted file mode 100644 index ec34fe0..0000000 --- a/_sources/components/dependency_injection/configurators.txt +++ /dev/null @@ -1,193 +0,0 @@ -.. index:: - single: Inyección de dependencias; Configuradores de servicio - -Configurando servicios con un configurador de servicio -====================================================== - -El configurador de servicios es una característica del contenedor de inyección de dependencias que te permite utilizar una función ejecutable para configurar un servicio después de su creación. - -Puedes especificar un método en otro servicio, una función *PHP* o un método estático en una clase. El servicio ``instance`` se pasa al ejecutable, permitiendo al configurador hacer cualquier cosa necesaria para configurar el servicio después de su creación. - -Puedes utilizar un configurador de servicio, por ejemplo, cuándo tienes un servicio que requiere una configuración compleja basada en opciones de configuración que provienen de diferentes fuentes/servicios. Usando un configurador externo, puedes mantener limpia la implementación del servicio y mantenerla desacoplada de los otros objetos que proporcionan la configuración necesaria. - -Otro interesante caso de uso es cuándo tienes múltiples objetos que comparten una configuración común o que se deberían configurar de manera similar en en tiempo de ejecución. - -Por ejemplo, supón que tienes una aplicación donde envías diferentes tipos de correo electrónico a los usuarios. Los mensajes de correo electrónico se pasan a través de diferentes formateadores que podrían estar habilitados o no dependiendo de algunas opciones dinámicas de la aplicación. Empiezas definiedo una clase ``NewsletterManager`` como esta:: - - class NewsletterManager implements EmailFormatterAwareInterface - { - protected $mailer; - protected $enabledFormatters; - - public function setMailer(Mailer $mailer) - { - $this->mailer = $mailer; - } - - public function setEnabledFormatters(array $enabledFormatters) - { - $this->enabledFormatters = $enabledFormatters; - } - - // ... - } - - -y además una clase ``GreetingCardManager``:: - - class GreetingCardManager implements EmailFormatterAwareInterface - { - protected $mailer; - protected $enabledFormatters; - - public function setMailer(Mailer $mailer) - { - $this->mailer = $mailer; - } - - public function setEnabledFormatters(array $enabledFormatters) - { - $this->enabledFormatters = $enabledFormatters; - } - - // ... - } - - -Como se mencionó antes, el objetivo es configurar los formateadores en tiempo de ejecución dependiendo de la configuración de la aplicación. Para ello, también tienes una clase ``EmailFormatterManager`` que es la responsable de cargar y validar los formateadores habilitados en la aplicación:: - - class EmailFormatterManager - { - protected $enabledFormatters; - - public function loadFormatters() - { - // código para configurar cuales formateadores usar - $enabledFormatters = array(); - // ... - - $this->enabledFormatters = $enabledFormatters; - } - - public function getEnabledFormatters() - { - return $this->enabledFormatters; - } - - // ... - } - -Si tu objetivo es evitar el tener un par de ``NewsletterManager`` y ``GreetingCardManager`` con ``EmailFormatterManager``, entonces podrías desear crear una clase configuradora para ajustar estos casos:: - - class EmailConfigurator - { - private $formatterManager; - - public function __construct(EmailFormatterManager $formatterManager) - { - $this->formatterManager = $formatterManager; - } - - public function configure(EmailFormatterAwareInterface $emailManager) - { - $emailManager->setEnabledFormatters( - $this->formatterManager->getEnabledFormatters() - ); - } - - // ... - } - -El trabajo del ``EmailConfigurator`` es inyectar los filtros habilitados en el ``NewsletterManager`` y ``GreetingCardManager`` porque no están conscientes de donde provienen los filtros habilitados. Por otro lado, el ``EmailFormatterManager`` mantiene el conocimiento sobre los formateadores habilitados y cómo cargarlos, únicamente manteniendo el principio de responsabilidad. - -Configurador del servicio ``Config`` ------------------------------------- - -El servicio ``config`` de las clases anteriores se vería algo así: - -.. configuration-block:: - - .. code-block:: yaml - - services: - my_mailer: - # ... - - email_formatter_manager: - class: EmailFormatterManager - # ... - - email_configurator: - class: EmailConfigurator - arguments: ["@email_formatter_manager"] - # ... - - newsletter_manager: - class: NewsletterManager - calls: - - [setMailer, ["@my_mailer"]] - configurator: ["@email_configurator", configure] - - greeting_card_manager: - class: GreetingCardManager - calls: - - [setMailer, ["@my_mailer"]] - configurator: ["@email_configurator", configure] - - - .. code-block:: xml - - - - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setDefinition('my_mailer', ...); - $container->setDefinition('email_formatter_manager', new Definition( - 'EmailFormatterManager' - )); - $container->setDefinition('email_configurator', new Definition( - 'EmailConfigurator' - )); - $container->setDefinition('newsletter_manager', new Definition( - 'NewsletterManager' - ))->addMethodCall('setMailer', array( - new Reference('my_mailer'), - ))->setConfigurator(array( - new Reference('email_configurator'), - 'configure', - ))); - $container->setDefinition('greeting_card_manager', new Definition( - 'GreetingCardManager' - ))->addMethodCall('setMailer', array( - new Reference('my_mailer'), - ))->setConfigurator(array( - new Reference('email_configurator'), - 'configure', - ))); diff --git a/_sources/components/dependency_injection/definitions.txt b/_sources/components/dependency_injection/definitions.txt deleted file mode 100644 index c784614..0000000 --- a/_sources/components/dependency_injection/definitions.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. index:: - single: Inyección de dependencias; Definiendo servicios - - -Working with Container Service Definitions -========================================== - -Obteniendo y estableciendo definiciones de servicios ----------------------------------------------------- - -There are some helpful methods for working with the service definitions. - -Para saber si hay una definición para un ``ID`` de servicio:: - - $container->hasDefinition($serviceId); - -Esto es útil si sólo quieres hacer algo si existe una definición particular. - -Puedes recuperar una definición con:: - - $container->getDefinition($serviceId); - -o:: - - $container->findDefinition($serviceId); - -que a diferencia de ``getDefinition()`` también resuelve los alias de manera tal que si el argumento ``$serviceId`` es un alias esta recuperará la definición subyacente. - -Las definiciones de servicios en sí mismas son objetos, por tanto, si recuperas una definición de dichos métodos y les haces cambios se verán reflejados en el contenedor. Sin embargo, si estás creando una nueva definición, entonces lo puedes añadir al contenedor usando:: - - $container->setDefinition($id, $definition); - -Trabajando con una definición ------------------------------ - -Creando una nueva definición -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si necesitas crear una nueva definición en lugar de manipular una recuperada desde ese contenedor, entonces la clase de la definición es :class:`Symfony\\Component\\DependencyInjection\\Definition`. - -Clase -~~~~~ - -En primer lugar es la clase de una definición, ésta es la clase del objeto devuelto cuando solicitas el servicio desde el contenedor. - -Para determinar qué clase dicta la definición:: - - $definition->getClass(); - -y para establecer una clase diferente:: - - $definition->setClass($class); // nombre de clase completamente cualificado como cadena - -Argumentos del constructor -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para obtener un arreglo de los argumentos del constructor para una definición puedes usar:: - - $definition->getArguments(); - -o para obtener un solo argumento por posición:: - - $definition->getArgument($index); - // p. ej. $definition->getArguments(0) para el primer argumento - -Puedes agregar un nuevo argumento al final del arreglo de argumentos usando:: - - $definition->addArgument($argument); - -El argumento puede ser una cadena, un arreglo, un parámetro de servicio usando ``%paramater_name%`` o un identificador de servicio usando:: - - use Symfony\Component\DependencyInjection\Reference; - - // ... - - $definition->addArgument(new Reference('service_id')); - -De manera similar puedes sustituir un argumento ya establecido por índice usando:: - - $definition->replaceArgument($index, $argument); - -También puedes reemplazar todos los argumentos (o establecer alguno si no hay) con un arreglo de argumentos:: - - $definition->replaceArguments($arguments); - -Llamadas a método -~~~~~~~~~~~~~~~~~ - -Si el servicio en que estás trabajando usa la inyección de definidores entonces puedes manipular cualquier llamada a método en las definiciones también. - -Puedes obtener un arreglo de todas las llamadas al método con:: - - $definition->getMethodCalls(); - -Añade una llamada al método con:: - - $definition->addMethodCall($method, $arguments); - -Donde ``$method`` es el nombre del método y ``$arguments`` es un arreglo de los argumentos con los cuales llamar al método. Los argumentos pueden ser cadenas, arreglos, parámetros o identificadores de servicio al igual que los argumentos del constructor. - -También puedes sustituir cualquier llamada existente a un método con un arreglo de otras nuevas con:: - - $definition->setMethodCalls($methodCalls); - -.. tip:: - - Hay más ejemplos de maneras específicas de trabajar con definiciones en los bloques de código *PHP* de los ejemplos de configuración en páginas como :doc:`/components/dependency_injection/factories` y :doc:`/components/dependency_injection/parentservices`. - -.. note:: - - The methods here that change service definitions can only be used before - the container is compiled, once the container is compiled you cannot - manipulate service definitions further. To learn more about compiling - the container see :doc:`/components/dependency_injection/compilation`. diff --git a/_sources/components/dependency_injection/factories.txt b/_sources/components/dependency_injection/factories.txt deleted file mode 100644 index 95db394..0000000 --- a/_sources/components/dependency_injection/factories.txt +++ /dev/null @@ -1,190 +0,0 @@ -.. index:: - single: Inyección de dependencias; Factorías - -Usando el patrón factoría para crear servicios -============================================== - -Los contenedores de servicios de *Symfony2* proporcionan una forma eficaz de controlar la creación de objetos, lo cual te permite especificar los argumentos pasados al constructor, así como llamar a los métodos y establecer parámetros. A veces, sin embargo, esto no te proporcionará todo lo necesario para construir tus objetos. -Por esta situación, puedes utilizar una factoría para crear el objeto y decirle al contenedor de servicios que llame a un método en la factoría y no crear directamente una instancia del objeto. - -Supongamos que tienes una factoría que configura y devuelve un nuevo objeto ``NewsletterManager``:: - - class NewsletterFactory - { - public function get() - { - $newsletterManager = new NewsletterManager(); - - // ... - - return $newsletterManager; - } - } - -Para que el objeto ``NewsletterManager`` esté disponible como servicio, puedes configurar el contenedor de servicios para usar la clase factoría ``NewsletterFactory``: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - newsletter_manager.class: NewsletterManager - newsletter_factory.class: NewsletterFactory - services: - newsletter_manager: - class: "%newsletter_manager.class%" - factory_class: "%newsletter_factory.class%" - factory_method: get - - .. code-block:: xml - - - - NewsletterManager - NewsletterFactory - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - - // ... - $container->setParameter('newsletter_manager.class', 'NewsletterManager'); - $container->setParameter('newsletter_factory.class', 'NewsletterFactory'); - - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%' - ))->setFactoryClass( - '%newsletter_factory.class%' - )->setFactoryMethod( - 'get' - ); - -Cuando especificas la clase que utiliza la factoría (a través de ``factory_class``), el método será llamado estáticamente. Si la factoría debe crear una instancia y se llama al método del objeto resultante (como en este ejemplo), configura como servicio la propia factoría: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - newsletter_manager.class: NewsletterManager - newsletter_factory.class: NewsletterFactory - services: - newsletter_factory: - class: "%newsletter_factory.class%" - newsletter_manager: - class: "%newsletter_manager.class%" - factory_service: newsletter_factory - factory_method: get - - .. code-block:: xml - - - - NewsletterManager - NewsletterFactory - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - - // ... - $container->setParameter('newsletter_manager.class', 'NewsletterManager'); - $container->setParameter('newsletter_factory.class', 'NewsletterFactory'); - - $container->setDefinition('newsletter_factory', new Definition( - '%newsletter_factory.class%' - )) - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%' - ))->setFactoryService( - 'newsletter_factory' - )->setFactoryMethod( - 'get' - ); - -.. note:: - - El servicio factoría se especifica por su nombre de ``id`` y no una referencia al propio servicio. Por lo tanto, no es necesario utilizar la sintaxis @. - -Pasando argumentos al método factoría -------------------------------------- - -Si tienes que pasar argumentos al método factoría, puedes utilizar la opción ``arguments`` dentro del contenedor de servicios. Por ejemplo, supongamos que el método ``get`` en el ejemplo anterior tiene el servicio de ``templating`` como argumento: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - newsletter_manager.class: NewsletterManager - newsletter_factory.class: NewsletterFactory - services: - newsletter_factory: - class: "%newsletter_factory.class%" - newsletter_manager: - class: "%newsletter_manager.class%" - factory_service: newsletter_factory - factory_method: get - arguments: - - "@templating" - - .. code-block:: xml - - - - NewsletterManager - NewsletterFactory - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - - // ... - $container->setParameter('newsletter_manager.class', 'NewsletterManager'); - $container->setParameter('newsletter_factory.class', 'NewsletterFactory'); - - $container->setDefinition('newsletter_factory', new Definition( - '%newsletter_factory.class%' - )) - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%', - array(new Reference('templating')) - ))->setFactoryService( - 'newsletter_factory' - )->setFactoryMethod( - 'get' - ); diff --git a/_sources/components/dependency_injection/index.txt b/_sources/components/dependency_injection/index.txt deleted file mode 100644 index 058dc59..0000000 --- a/_sources/components/dependency_injection/index.txt +++ /dev/null @@ -1,18 +0,0 @@ -Inyección de dependencias -========================= - -.. toctree:: - :maxdepth: 2 - - introduction - types - parameters - definitions - compilation - tags - factories - configurators - parentservices - advanced - workflow - diff --git a/_sources/components/dependency_injection/introduction.txt b/_sources/components/dependency_injection/introduction.txt deleted file mode 100644 index 468858f..0000000 --- a/_sources/components/dependency_injection/introduction.txt +++ /dev/null @@ -1,259 +0,0 @@ -.. index:: - single: Inyección de dependencias - single: Componentes; DependencyInjection - -El componente ``Inyección de dependencias`` -=========================================== - - El componente ``Inyección de dependencias``, te permite estandarizar y centralizar la forma en que se construyen los objetos en tu aplicación. - -Para una introducción general a los contenedores de inyección de dependencias y servicios consulta el capítulo :doc:`/book/service_container` del libro. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/DependencyInjection); -* :doc:`Instalándolo vía Composer ` (``symfony/dependency-injection`` en `Packagist`_). - -Uso básico ----------- - -Tal vez tengas una simple clase ``Mailer`` como la siguiente, la cual quieres hacer disponible como un servicio:: - - class Mailer - { - private $transport; - - public function __construct() - { - $this->transport = 'sendmail'; - } - - // ... - } - -La puedes registrar en el contenedor como un servicio:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $container = new ContainerBuilder(); - $container->register('mailer', 'Mailer'); - -Una mejora a la clase para hacerla más flexible sería permitir que el contenedor establezca el ``transporte`` utilizado. Si cambias la clase para que esta sea pasada al constructor:: - - class Mailer - { - private $transport; - - public function __construct($transport) - { - $this->transport = $transport; - } - - // ... - } - -Entonces, puedes configurar la opción de transporte en el contenedor:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $container = new ContainerBuilder(); - $container - ->register('mailer', 'Mailer') - ->addArgument('sendmail'); - -Esta clase ahora es mucho más flexible puesto que separamos la elección del transporte de la implementación y la colocamos en el contenedor. - -Cual transporte de correo has elegido, puede ser algo sobre lo cual los demás servicios necesiten saber. Puedes evitar tener que cambiarlo en varios lugares volviéndolo un parámetro en el contenedor y luego refiriendo este parámetro como argumento en el constructor del servicio ``Mailer``:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $container = new ContainerBuilder(); - $container->setParameter('mailer.transport', 'sendmail'); - $container - ->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%'); - -Ahora que el servicio ``mailer`` está en el contenedor lo puedes inyectar como una dependencia de otras clases. Si tienes una clase ``NewsletterManager`` como esta:: - - class NewsletterManager - { - private $mailer; - - public function __construct(\Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -Entonces, también la puedes registrar como un servicio y pasarla al servicio ``mailer``:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Reference; - - $container = new ContainerBuilder(); - - $container->setParameter('mailer.transport', 'sendmail'); - $container - ->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%'); - - $container - ->register('newsletter_manager', 'NewsletterManager') - ->addArgument(new Reference('mailer')); - -Si el ``NewsletterManager`` no requiere el ``Mailer`` y la inyección sólo era opcional, entonces, en su lugar puedes utilizar el método definidor para inyectarlo:: - - class NewsletterManager - { - private $mailer; - - public function setMailer(\Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -Ahora puedes optar por no inyectar un ``Mailer`` en el ``NewsletterManager``. -Aún así, si quieres entonces el contenedor puede llamar al método definidor:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Reference; - - $container = new ContainerBuilder(); - - $container->setParameter('mailer.transport', 'sendmail'); - $container - ->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%'); - - $container - ->register('newsletter_manager', 'NewsletterManager') - ->addMethodCall('setMailer', array(new Reference('mailer'))); - -A continuación, puedes obtener tu servicio ``newsletter_manager`` desde el contenedor de esta manera:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $container = new ContainerBuilder(); - - // ... - - $newsletterManager = $container->get('newsletter_manager'); - -Evitando que tu código sea dependiente en el contenedor -------------------------------------------------------- - -Si bien puedes recuperar los servicios directamente desde el contenedor, lo mejor es minimizar esto. Por ejemplo, en el ``NewsletterManager`` inyectamos el servicio ``Mailer`` en vez de solicitarlo desde el contenedor. -Podríamos haber inyectado el contenedor y recuperar el servicio ``Mailer`` desde ahí, pero entonces, estaría vinculado a ese contenedor particular, lo cual dificulta la reutilización de la clase en cualquier otro lugar. - -Tendrás que conseguir un servicio desde el contenedor en algún momento, pero esto debe ser tan pocas veces como sea posible en el punto de entrada a tu aplicación. - -.. _components-dependency-injection-loading-config: - -Configurando el contenedor con archivos de configuración --------------------------------------------------------- - -As well as setting up the services using PHP as above you can also use -configuration files. This allows you to use XML or Yaml to write the definitions -for the services rather than using PHP to define the services as in the above -examples. In anything but the smallest applications it make sense to organize -the service definitions by moving them into one or more configuration files. -To do this you also need to install -:doc:`the Config Component`. - -Cargando un archivo de configuración *XML*:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\Config\FileLocator; - use Symfony\Component\DependencyInjection\Loader\XmlFileLoader; - - $container = new ContainerBuilder(); - $loader = new XmlFileLoader($container, new FileLocator(__DIR__)); - $loader->load('services.xml'); - -Cargando un archivo de configuración *YAML*:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\Config\FileLocator; - use Symfony\Component\DependencyInjection\Loader\YamlFileLoader; - - $container = new ContainerBuilder(); - $loader = new YamlFileLoader($container, new FileLocator(__DIR__)); - $loader->load('services.yml'); - -.. note:: - - Si quieres cargar archivos de configuración *YAML* entonces también necesitarás instalar el :doc:`componente YAML `. - -If you *do* want to use PHP to create the services then you can move this -into a separate config file and load it in a similar way:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\Config\FileLocator; - use Symfony\Component\DependencyInjection\Loader\PhpFileLoader; - - $container = new ContainerBuilder(); - $loader = new PhpFileLoader($container, new FileLocator(__DIR__)); - $loader->load('services.php'); - -You can now set up the ``newsletter_manager`` and ``mailer`` services using -config files: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - mailer.transport: sendmail - - services: - mailer: - class: Mailer - arguments: ["%mailer.transport%"] - newsletter_manager: - class: NewsletterManager - calls: - - [setMailer, ["@mailer"]] - - .. code-block:: xml - - - - sendmail - - - - - %mailer.transport% - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter('mailer.transport', 'sendmail'); - $container - ->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%'); - - $container - ->register('newsletter_manager', 'NewsletterManager') - ->addMethodCall('setMailer', array(new Reference('mailer'))); - -.. _`Packagist`: https://packagist.org/packages/symfony/dependency-injection diff --git a/_sources/components/dependency_injection/parameters.txt b/_sources/components/dependency_injection/parameters.txt deleted file mode 100644 index 4d2a357..0000000 --- a/_sources/components/dependency_injection/parameters.txt +++ /dev/null @@ -1,262 +0,0 @@ -.. index:: - single: Inyección de dependencias; Parameters - -Introduction to Parameters -========================== - -You can define parameters in the service container which can then be used -directly or as part of service definitions. This can help to separate out -values that you will want to change more regularly. - -Obteniendo y estableciendo contenedores de parámetros ------------------------------------------------------ - -Working with container parameters is straightforward using the container's -accessor methods for parameters. Puedes comprobar si se ha definido un parámetro en el contenedor con:: - - $container->hasParameter('mailer.transport'); - -You can retrieve a parameter set in the container with:: - - $container->getParameter('mailer.transport'); - -y establecer un parámetro en el contenedor con:: - - $container->setParameter('mailer.transport', 'sendmail'); - -.. note:: - - You can only set a parameter before the container is compiled. To learn - more about compiling the container see - :doc:`/components/dependency_injection/compilation`. - -Parameters in Configuration Files ---------------------------------- - -You can also use the ``parameters`` section of a config file to set parameters: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - mailer.transport: sendmail - - .. code-block:: xml - - - sendmail - - - .. code-block:: php - - $container->setParameter('mailer.transport', 'sendmail'); - -As well as retrieving the parameter values directly from the container you -can use them in the config files. You can refer to parameters elsewhere by -surrounding them with percent (``%``) signs, e.g. ``%mailer.transport%``. -One use for this is to inject the values into your services. This allows -you to configure different versions of services between applications or multiple -services based on the same class but configured differently within a single -application. You could inject the choice of mail transport into the ``Mailer`` -class directly but by making it a parameter. This makes it easier to change -rather than being tied up and hidden with the service definition: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - mailer.transport: sendmail - - services: - mailer: - class: Mailer - arguments: ['%mailer.transport%'] - - .. code-block:: xml - - - sendmail - - - - - %mailer.transport% - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter('mailer.transport', 'sendmail'); - $container - ->register('mailer', 'Mailer') - ->addArgument('%mailer.transport%'); - -If you were using this elsewhere as well, then you would only need to change -the parameter value in one place if needed. - -You can also use the parameters in the service definition, for example, -making the class of a service a parameter: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - mailer.transport: sendmail - mailer.class: Mailer - - services: - mailer: - class: '%mailer.class%' - arguments: ['%mailer.transport%'] - - .. code-block:: xml - - - sendmail - Mailer - - - - - %mailer.transport% - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter('mailer.transport', 'sendmail'); - $container->setParameter('mailer.class', 'Mailer'); - $container - ->register('mailer', '%mailer.class%') - ->addArgument('%mailer.transport%'); - - $container - ->register('newsletter_manager', 'NewsletterManager') - ->addMethodCall('setMailer', array(new Reference('mailer'))); - -.. note:: - - El signo de porcentaje en un parámetro o argumento, como parte de la cadena, se debe escapar con otro signo de porcentaje: - - .. configuration-block:: - - .. code-block:: yaml - - arguments: ['http://symfony.com/?foo=%%s&bar=%%d'] - - .. code-block:: xml - - http://symfony.com/?foo=%%s&bar=%%d - - .. code-block:: php - - ->addArgument('http://symfony.com/?foo=%%s&bar=%%d'); - -.. _component-di-parameters-array: - -Array Parameters ----------------- - -Los parámetros no tienen que ser cadenas planas, sino que también pueden ser arreglos. For the XML -format, you need to use the ``type="collection"`` attribute for all parameters that are -arrays. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - parameters: - my_mailer.gateways: - - mail1 - - mail2 - - mail3 - my_multilang.language_fallback: - en: - - en - - fr - fr: - - fr - - en - - .. code-block:: xml - - - - - mail1 - mail2 - mail3 - - - - en - fr - - - fr - en - - - - - .. code-block:: php - - // app/config/config.php - use Symfony\Component\DependencyInjection\Definition; - - $container->setParameter('my_mailer.gateways', array('mail1', 'mail2', 'mail3')); - $container->setParameter('my_multilang.language_fallback', array( - 'en' => array('en', 'fr'), - 'fr' => array('fr', 'en'), - )); - -.. _component-di-parameters-constants: - -Constants as Parameters ------------------------ - -El contenedor también cuenta con apoyo para fijar constantes *PHP* como parámetros. Para aprovechar esta característica, asigna el nombre de tu constante a un parámetro clave, y define el tipo como ``constant``. - -.. configuration-block:: - - .. code-block:: xml - - - - - - - GLOBAL_CONSTANT - My_Class::CONSTANT_NAME - - - - .. code-block:: php - - $container->setParameter('global.constant.value', GLOBAL_CONSTANT); - $container->setParameter('my_class.constant.value', My_Class::CONSTANT_NAME); - -.. note:: - - This does not works for Yaml configuration. If you're using Yaml, you can - import an XML file to take advantage of this functionality: - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - imports: - - { resource: parameters.xml } diff --git a/_sources/components/dependency_injection/parentservices.txt b/_sources/components/dependency_injection/parentservices.txt deleted file mode 100644 index 810681c..0000000 --- a/_sources/components/dependency_injection/parentservices.txt +++ /dev/null @@ -1,485 +0,0 @@ -.. index:: - single: Inyección de dependencias; Servicios padre - -Gestionando dependencias comunes con servicios padre -==================================================== - -A medida que agregas más funcionalidad a tu aplicación, puedes comenzar a tener clases relacionadas que comparten algunas de las mismas dependencias. Por ejemplo, puedes tener un gestor de ``boletines`` que utiliza inyección para definir sus dependencias:: - - class NewsletterManager - { - protected $mailer; - protected $emailFormatter; - - public function setMailer(Mailer $mailer) - { - $this->mailer = $mailer; - } - - public function setEmailFormatter(EmailFormatter $emailFormatter) - { - $this->emailFormatter = $emailFormatter; - } - - // ... - } - -y también una clase para tus ``Tarjetas de saludo`` que comparte las mismas dependencias:: - - class GreetingCardManager - { - protected $mailer; - protected $emailFormatter; - - public function setMailer(Mailer $mailer) - { - $this->mailer = $mailer; - } - - public function setEmailFormatter(EmailFormatter $emailFormatter) - { - $this->emailFormatter = $emailFormatter; - } - - // ... - } - -La configuración del servicio de estas clases se vería algo como esto: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - newsletter_manager.class: NewsletterManager - greeting_card_manager.class: GreetingCardManager - services: - my_mailer: - # ... - my_email_formatter: - # ... - newsletter_manager: - class: %newsletter_manager.class% - calls: - - [setMailer, ["@my_mailer"]] - - [setEmailFormatter, ["@my_email_formatter"]] - - greeting_card_manager: - class: "%greeting_card_manager.class%" - calls: - - [setMailer, ["@my_mailer"]] - - [setEmailFormatter, ["@my_email_formatter"]] - - .. code-block:: xml - - - - NewsletterManager - GreetingCardManager - - - - - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter('newsletter_manager.class', 'NewsletterManager'); - $container->setParameter('greeting_card_manager.class', 'GreetingCardManager'); - - $container->setDefinition('my_mailer', ...); - $container->setDefinition('my_email_formatter', ...); - $container->setDefinition('newsletter_manager', new Definition( - '%newsletter_manager.class%' - ))->addMethodCall('setMailer', array( - new Reference('my_mailer') - ))->addMethodCall('setEmailFormatter', array( - new Reference('my_email_formatter') - )); - $container->setDefinition('greeting_card_manager', new Definition( - '%greeting_card_manager.class%' - ))->addMethodCall('setMailer', array( - new Reference('my_mailer') - ))->addMethodCall('setEmailFormatter', array( - new Reference('my_email_formatter') - )); - -Hay mucha repetición, tanto en las clases como en la configuración. Esto significa que si cambias, por ejemplo, las clases de correo de la aplicación ``Mailer`` de ``EmailFormatter`` para inyectarlas a través del constructor, tendrías que actualizar la configuración en dos lugares. Del mismo modo, si necesitas hacer cambios en los métodos definidores tendrías que hacerlo en ambas clases. La forma típica de hacer frente a los métodos comunes de estas clases relacionadas es extraerlas en una superclase:: - - abstract class MailManager - { - protected $mailer; - protected $emailFormatter; - - public function setMailer(Mailer $mailer) - { - $this->mailer = $mailer; - } - - public function setEmailFormatter(EmailFormatter $emailFormatter) - { - $this->emailFormatter = $emailFormatter; - } - - // ... - } - -Entonces ``NewsletterManager`` y ``GreetingCardManager`` pueden extender esta -superclase:: - - class NewsletterManager extends MailManager - { - // ... - } - -y:: - - class GreetingCardManager extends MailManager - { - // ... - } - -De manera similar, el contenedor de servicios de *Symfony2* también apoya la extensión de servicios en la configuración por lo que también puedes reducir la repetición especificando un padre para un servicio. - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - newsletter_manager.class: NewsletterManager - greeting_card_manager.class: GreetingCardManager - services: - my_mailer: - # ... - my_email_formatter: - # ... - mail_manager: - abstract: true - calls: - - [setMailer, ["@my_mailer"]] - - [setEmailFormatter, ["@my_email_formatter"]] - - newsletter_manager: - class: "%newsletter_manager.class%" - parent: mail_manager - - greeting_card_manager: - class: "%greeting_card_manager.class%" - parent: mail_manager - - .. code-block:: xml - - - - NewsletterManager - GreetingCardManager - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\DefinitionDecorator; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter('newsletter_manager.class', 'NewsletterManager'); - $container->setParameter('greeting_card_manager.class', 'GreetingCardManager'); - - $container->setDefinition('my_mailer', ...); - $container->setDefinition('my_email_formatter', ...); - $container->setDefinition('mail_manager', new Definition( - ))->setAbstract( - true - )->addMethodCall('setMailer', array( - new Reference('my_mailer') - ))->addMethodCall('setEmailFormatter', array( - new Reference('my_email_formatter') - )); - $container->setDefinition('newsletter_manager', new DefinitionDecorator( - 'mail_manager' - ))->setClass( - '%newsletter_manager.class%' - ); - $container->setDefinition('greeting_card_manager', new DefinitionDecorator( - 'mail_manager' - ))->setClass( - '%greeting_card_manager.class%' - ); - -En este contexto, tener un servicio ``padre`` implica que los argumentos y las llamadas a métodos del servicio padre se deben utilizar en los servicios descendientes. -En concreto, los métodos definidores especificados para el servicio padre serán llamados cuando se crean instancias del servicio descendiente. - -.. note:: - - Si quitas la clave de configuración del ``padre``, el servicio todavía seguirá siendo una instancia, por supuesto, extendiendo la clase ``MailManager``. La diferencia es que la omisión del ``padre`` en la clave de configuración significa que las ``llamadas`` definidas en el servicio ``mail_manager`` no se ejecutarán al crear instancias de los servicios descendientes. - -The parent service is abstract as it should not be directly retrieved from the -container or passed into another service. It exists merely as a "template" that -other services can use. This is why it can have no ``class`` configured which -would cause an exception to be raised for a non-abstract service. - -.. note:: - - In order for parent dependencies to resolve, the ``ContainerBuilder`` must - first be compiled. See :doc:`/components/dependency_injection/compilation` - for more details. - -Sustituyendo dependencias del padre ------------------------------------ - -Puede haber ocasiones en las que deses sustituir cual clase se pasa a una dependencia en un único servicio hijo. Afortunadamente, añadiendo la llamada al método de configuración para el servicio hijo, se sustituyen las dependencias establecidas por la clase principal. Así que si necesitas pasar una dependencia diferente sólo para la clase ``NewsletterManager``, la configuración sería la siguiente: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - newsletter_manager.class: NewsletterManager - greeting_card_manager.class: GreetingCardManager - services: - my_mailer: - # ... - my_alternative_mailer: - # ... - my_email_formatter: - # ... - mail_manager: - abstract: true - calls: - - [setMailer, ["@my_mailer"]] - - [setEmailFormatter, ["@my_email_formatter"]] - - newsletter_manager: - class: "%newsletter_manager.class%" - parent: mail_manager - calls: - - [setMailer, ["@my_alternative_mailer"]] - - greeting_card_manager: - class: "%greeting_card_manager.class%" - parent: mail_manager - - .. code-block:: xml - - - - NewsletterManager - GreetingCardManager - - - - - - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\DefinitionDecorator; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter('newsletter_manager.class', 'NewsletterManager'); - $container->setParameter('greeting_card_manager.class', 'GreetingCardManager'); - - $container->setDefinition('my_mailer', ...); - $container->setDefinition('my_alternative_mailer', ...); - $container->setDefinition('my_email_formatter', ...); - $container->setDefinition('mail_manager', new Definition( - ))->setAbstract( - true - )->addMethodCall('setMailer', array( - new Reference('my_mailer') - ))->addMethodCall('setEmailFormatter', array( - new Reference('my_email_formatter') - )); - $container->setDefinition('newsletter_manager', new DefinitionDecorator( - 'mail_manager' - ))->setClass( - '%newsletter_manager.class%' - )->addMethodCall('setMailer', array( - new Reference('my_alternative_mailer') - )); - $container->setDefinition('greeting_card_manager', new DefinitionDecorator( - 'mail_manager' - ))->setClass( - '%greeting_card_manager.class%' - ); - -El ``GreetingCardManager`` recibirá las mismas dependencias que antes, pero la ``NewsletterManager`` será pasada a ``my_alternative_mailer`` en lugar del servicio ``my_mailer``. - -Colección de dependencias -------------------------- - -Cabe señalar que el método definidor sustituido en el ejemplo anterior en realidad se invoca dos veces --- una vez en la definición del padre y otra más en la definición del hijo. En el ejemplo anterior, esto estaba muy bien, ya que la segunda llamada a ``setMailer`` sustituye al objeto ``mailer`` establecido por la primera llamada. - -En algunos casos, sin embargo, esto puede ser un problema. Por ejemplo, si la sustitución a la llamada al método consiste en añadir algo a una colección, entonces se agregarán dos objetos a la colección. A continuación mostramos tal caso, si la clase padre se parece a esto:: - - abstract class MailManager - { - protected $filters; - - public function setFilter($filter) - { - $this->filters[] = $filter; - } - - // ... - } - -Si tienes la siguiente configuración: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - # ... - newsletter_manager.class: NewsletterManager - services: - my_filter: - # ... - another_filter: - # ... - mail_manager: - abstract: true - calls: - - [setFilter, ["@my_filter"]] - - newsletter_manager: - class: "%newsletter_manager.class%" - parent: mail_manager - calls: - - [setFilter, ["@another_filter"]] - - .. code-block:: xml - - - - NewsletterManager - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\DefinitionDecorator; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setParameter('newsletter_manager.class', 'NewsletterManager'); - $container->setParameter('mail_manager.class', 'MailManager'); - - $container->setDefinition('my_filter', ...); - $container->setDefinition('another_filter', ...); - $container->setDefinition('mail_manager', new Definition( - ))->setAbstract( - true - )->addMethodCall('setFilter', array( - new Reference('my_filter') - )); - $container->setDefinition('newsletter_manager', new DefinitionDecorator( - 'mail_manager' - ))->setClass( - '%newsletter_manager.class%' - )->addMethodCall('setFilter', array( - new Reference('another_filter') - )); - -En este ejemplo, el ``setFilter`` del servicio ``newsletter_manager`` se llamará dos veces, dando lugar a que el array ``$filters`` contenga ambos objetos ``my_filter`` y ``another_filter``. Esto es genial si sólo quieres agregar filtros adicionales para subclases. If you want to replace the filters -passed to the subclass, removing the parent setting from the config will -prevent the base class from calling ``setFilter``. - -.. tip:: - - In the examples shown there is a similar relationship between the parent - and child services and the underlying parent and child classes. This does - not need to be the case though, you can extract common parts of similar - service definitions into a parent service without also inheriting a parent - class. diff --git a/_sources/components/dependency_injection/tags.txt b/_sources/components/dependency_injection/tags.txt deleted file mode 100644 index 680790b..0000000 --- a/_sources/components/dependency_injection/tags.txt +++ /dev/null @@ -1,254 +0,0 @@ -.. index:: - single: Inyección de dependencias; Etiquetas - -Trabajando con servicios etiquetados -==================================== - -Las etiquetas son una cadena genérica (junto con algunas opciones) que puedes aplicar a cualquier servicio. Por sí mismas, las etiquetas en realidad no hacen la funcionalidad de tu servicio en modo alguno. Pero si quieres, puedes pedir al constructor del contenedor que consiga una lista de todos los servicios que estén etiquetados con alguna etiqueta específica. Esto es útil en los pases del compilador donde puedes encontrar estos servicios y usarlos o -modificarlos de alguna manera específica. - -Por ejemplo, si estás usando Swift Mailer te puedes imaginar que quieres implementar una «cadena de transporte», que es una colección de clases que implementan ``\Swift_Transport``. Usando la cadena, querrá que Swift Mailer pruebe varias maneras de transportar el mensaje hasta que una lo consiga. - -En primer lugar, define la clase ``TransportChain``:: - - class TransportChain - { - private $transports; - - public function __construct() - { - $this->transports = array(); - } - - public function addTransport(\Swift_Transport $transport) - { - $this->transports[] = $transport; - } - } - -Entonces, define la cadena como un servicio: - -.. configuration-block:: - - .. code-block:: yaml - - parameters: - acme_mailer.transport_chain.class: TransportChain - - services: - acme_mailer.transport_chain: - class: "%acme_mailer.transport_chain.class%" - - .. code-block:: xml - - - TransportChain - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - - $container->setParameter('acme_mailer.transport_chain.class', 'TransportChain'); - - $container->setDefinition('acme_mailer.transport_chain', new Definition('%acme_mailer.transport_chain.class%')); - -Definiendo servicios con una etiqueta personalizada ---------------------------------------------------- - -Ahora, posiblemente quieras que varias de las clases ``\Swift_Transport`` sean creadas y añadidas automáticamente a la cadena usando el método ``addTransport()``. -Como ejemplo, puedes añadir los siguientes transportes como servicios: - -.. configuration-block:: - - .. code-block:: yaml - - services: - acme_mailer.transport.smtp: - class: \Swift_SmtpTransport - arguments: - - "%mailer_host%" - tags: - - { name: acme_mailer.transport } - acme_mailer.transport.sendmail: - class: \Swift_SendmailTransport - tags: - - { name: acme_mailer.transport } - - .. code-block:: xml - - - %mailer_host% - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - - $definitionSmtp = new Definition('\Swift_SmtpTransport', array('%mailer_host%')); - $definitionSmtp->addTag('acme_mailer.transport'); - $container->setDefinition('acme_mailer.transport.smtp', $definitionSmtp); - - $definitionSendmail = new Definition('\Swift_SendmailTransport'); - $definitionSendmail->addTag('acme_mailer.transport'); - $container->setDefinition('acme_mailer.transport.sendmail', $definitionSendmail); - -Ten en cuenta que a cada uno se le dio una etiqueta llamada ``acme_mailer.transport``. Esta es la etiqueta personalizada que utilizarás en tu pase del compilador. El pase del compilador es lo que da algún «significado» a la etiqueta. - -Crear un ``CompilerPass`` -------------------------- - -Tu pase del compilador ahora puede pedir al contenedor cualquier servicio con la etiqueta personalizada:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface; - use Symfony\Component\DependencyInjection\Reference; - - class TransportCompilerPass implements CompilerPassInterface - { - public function process(ContainerBuilder $container) - { - if (!$container->hasDefinition('acme_mailer.transport_chain')) { - return; - } - - $definition = $container->getDefinition( - 'acme_mailer.transport_chain' - ); - - $taggedServices = $container->findTaggedServiceIds( - 'acme_mailer.transport' - ); - foreach ($taggedServices as $id => $attributes) { - $definition->addMethodCall( - 'addTransport', - array(new Reference($id)) - ); - } - } - } - -El método ``process()`` comprueba la existencia del servicio ``acme_mailer.transport_chain``, a continuación, busca todos los servicios etiquetados cómo ``acme_mailer.transport``. Los añade a la definición del servicio ``acme_mailer.transport_chain`` llamando a ``addTransport()`` por cada servicios ``"acme_mailer.transport"`` que haya encontrado. -El primer argumento de cada una de estas llamadas será el servicio de transporte de correo en sí mismo. - -Registrando el pase en el contenedor ------------------------------------- - -También necesitas registrar el pase en el contenedor, entonces se ejecutará al compilar el contenedor:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - - $container = new ContainerBuilder(); - $container->addCompilerPass(new TransportCompilerPass); - -.. note:: - - Los pases del compilador son registrados de manera diferente si estás usando la pila completa de la plataforma. Ve :doc:`/cookbook/service_container/compiler_passes` para más detalles. - -Añadiendo atributos adicionales en etiquetas --------------------------------------------- - -Algunas veces necesitarás información adicional acerca de cada servicio que se ha marcado con tu etiqueta. -Por ejemplo, posiblemente quieras agregar un alias a cada ``TransportChain``. - -Para empezar, cambia la clase ``TransportChain``:: - - class TransportChain - { - private $transports; - - public function __construct() - { - $this->transports = array(); - } - - public function addTransport(\Swift_Transport $transport, $alias) - { - $this->transports[$alias] = $transport; - } - - public function getTransport($alias) - { - if (array_key_exists($alias, $this->transports)) { - return $this->transports[$alias]; - } - else { - return; - } - } - } - -Como puedes ver, cuando se llama a ``addTransport``, no sólo necesita un objeto ``Swift_Transport``, sino también una cadena con el alias del transporte. Por lo tanto, ¿cómo podemos permitir que cada servicio etiquetado como transporte también suministre un alias? - -Para responder a esto, cambia la declaración del servicio: - -.. configuration-block:: - - .. code-block:: yaml - - services: - acme_mailer.transport.smtp: - class: \Swift_SmtpTransport - arguments: - - "%mailer_host%" - tags: - - { name: acme_mailer.transport, alias: foo } - acme_mailer.transport.sendmail: - class: \Swift_SendmailTransport - tags: - - { name: acme_mailer.transport, alias: bar } - - - .. code-block:: xml - - - %mailer_host% - - - - - - - -Ten en cuenta que agregaste una clave genérica ``alias`` a la etiqueta. Para utilizarla efectivamente, actualiza el compilador:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface; - use Symfony\Component\DependencyInjection\Reference; - - class TransportCompilerPass implements CompilerPassInterface - { - public function process(ContainerBuilder $container) - { - if (!$container->hasDefinition('acme_mailer.transport_chain')) { - return; - } - - $definition = $container->getDefinition( - 'acme_mailer.transport_chain' - ); - - $taggedServices = $container->findTaggedServiceIds( - 'acme_mailer.transport' - ); - foreach ($taggedServices as $id => $tagAttributes) { - foreach ($tagAttributes as $attributes) { - $definition->addMethodCall( - 'addTransport', - array(new Reference($id), $attributes["alias"]) - ); - } - } - } - } - -La parte más complicada es la variable ``$attributes``. Debido a que puedes utilizar la misma etiqueta muchas veces en el mismo servicio (por ejemplo, en teoría, podrías etiquetar el mismo servicio 5 veces con la etiqueta ``acme_mailer.transport``), ``$attributes`` es un arreglo con información de la etiqueta de cada una de las etiquetas en ese servicio. diff --git a/_sources/components/dependency_injection/types.txt b/_sources/components/dependency_injection/types.txt deleted file mode 100644 index d6c2293..0000000 --- a/_sources/components/dependency_injection/types.txt +++ /dev/null @@ -1,196 +0,0 @@ -.. index:: - single: Inyección de dependencias; Tipos de inyección - -Tipos de inyección -================== - -Hacer dependencias de una clase explícita y requerir que se inyecte es una buena manera de hacer una clase más reutilizable, comprobable y desacoplada de las demás. - -Hay varias maneras en que se pueden inyectar dependencias. Cada punto de inyección tiene sus ventajas y desventajas a considerar, así como las diferentes formas de trabajar con ellas cuando se utiliza el contenedor de servicios. - -Inyectando en el constructor ----------------------------- - -La manera más común para inyectar dependencias es a través del constructor de la clase. -Para ello es necesario añadir un argumento a la firma del constructor para aceptar la dependencia:: - - class NewsletterManager - { - protected $mailer; - - public function __construct(\Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -Puedes especificar qué tipo de servicio deseas inyectar en la configuración del contenedor de servicios: - -.. configuration-block:: - - .. code-block:: yaml - - services: - my_mailer: - # ... - newsletter_manager: - class: NewsletterManager - arguments: ["@my_mailer"] - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setDefinition('my_mailer', ...); - $container->setDefinition('newsletter_manager', new Definition( - 'NewsletterManager', - array(new Reference('my_mailer')) - )); - -.. tip:: - - Aludir el tipo de objeto a inyectar significa que puedes estar seguro de haber inyectado la dependencia adecuada. Al aludir el tipo, de inmediato obtendrás un error claro si inyectas una dependencia inadecuada. Al aludir el tipo usando una interfaz en lugar de una clase puedes hacer más flexible la elección de la dependencia. Y suponiendo que sólo utilizas los métodos definidos en la interfaz, te puedes beneficiar de la flexibilidad y seguridad al utilizar el objeto. - -Hay varias ventajas al utilizar la inyección en el constructor: - -* Si la dependencia es un requisito y la clase no puede funcionar sin ella, entonces la inyección a través del constructor garantiza que está presente al utilizar la clase debido a que la clase no se puede construir sin ella. - -* El constructor sólo se invoca una vez cuando se crea el objeto, por lo tanto puedes estar seguro de que la dependencia no va a cambiar durante la vida del objeto. - -Estas ventajas no significan que la inyección en el constructor no sea adecuada para trabajar con dependencias opcionales. Ademas, es más difícil usar en combinación con jerarquías de clase: si una clase utiliza la inyección en el constructor entonces extender y reemplazar el constructor se vuelve problemático. - -Inyectando en un definidor --------------------------- - -Otro posible punto de inyección en una clase es añadiendo un método definidor que acepte la dependencia:: - - class NewsletterManager - { - protected $mailer; - - public function setMailer(\Mailer $mailer) - { - $this->mailer = $mailer; - } - - // ... - } - -.. configuration-block:: - - .. code-block:: yaml - - services: - my_mailer: - # ... - newsletter_manager: - class: NewsletterManager - calls: - - [setMailer, ["@my_mailer"]] - - .. code-block:: xml - - - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setDefinition('my_mailer', ...); - $container->setDefinition('newsletter_manager', new Definition( - 'NewsletterManager' - ))->addMethodCall('setMailer', array(new Reference('my_mailer'))); - -Esta vez las ventajas son: - -* La inyección en el definidor funciona bien con dependencias opcionales. Si no necesitas la dependencia, entonces simplemente no llames al definidor. - -* Puedes llamar al definidor varias veces. Esto es particularmente útil si el método añade la dependencia a una colección. Entonces, puedes tener un número variable de dependencias. - -Las desventajas de la inyección en definidor son: - -* El definidor se puede llamar más que justo al momento de la construcción por lo que no puedes estar seguro de que la dependencia no sea reemplazada durante la vida del objeto (salvo que escribas el definidor de tal manera que compruebe si ya se ha llamado). - -* No puedes estar seguro de que el definidor se llamó y necesitas añadir comprobaciones para verificar que se inyecten las dependencias necesarias. - -Inyectando en propiedades -------------------------- - -Otra posibilidad es sólo configurar campos públicos en la clase directamente:: - - class NewsletterManager - { - public $mailer; - - // ... - } - -.. configuration-block:: - - .. code-block:: yaml - - services: - my_mailer: - # ... - newsletter_manager: - class: RNewsletterManager - properties: - mailer: "@my_mailer" - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - // ... - $container->setDefinition('my_mailer', ...); - $container->setDefinition('newsletter_manager', new Definition( - 'NewsletterManager' - ))->setProperty('mailer', new Reference('my_mailer'))); - - -Hay desventajas, principalmente sólo para usar la inyección de la propiedad, es similar a la inyección del definidor, pero con estos importantes problemas adicionales: - -* No puedes controlar cuando la dependencia se ha fijado del todo, esta puede cambiar en cualquier momento durante la vida del objeto. - -* No puedes usar la alusión de tipo, por lo tanto no puedes estar seguro de cual dependencia se inyecte, salvo que escribas código en la clase para probar explícitamente la clase de la instancia antes de usarla. - -Sin embargo, es útil saber que esto se puede hacer en el contenedor de servicios, sobre todo si trabajas con código que está fuera de tu control, como en una biblioteca de terceros, que utiliza propiedades públicas para sus dependencias. - diff --git a/_sources/components/dependency_injection/workflow.txt b/_sources/components/dependency_injection/workflow.txt deleted file mode 100644 index 16312f5..0000000 --- a/_sources/components/dependency_injection/workflow.txt +++ /dev/null @@ -1,40 +0,0 @@ -.. index:: - single: Inyección de dependencias; Flujo de trabajo; - -Construyendo el flujo de trabajo del contenedor -=============================================== - -En las páginas anteriores de esta sección, ha habido muy poco que decir acerca de donde se deben ubicar los diversos archivos y clases. Esto es porque eso depende de la aplicación, biblioteca o plataforma en la que deseas utilizar el contenedor. En cuanto a la forma de configurar el contenedor y construirlo en la pila completa de la plataforma, *Symfony2* te ayudará a ver cómo encaja todo esto junto, si estás utilizando la pila completa de la plataforma o buscando cómo utilizar el contenedor de servicios en otra aplicación. - -La pila completa de la plataforma usa el componente ``HttpKernel`` para manejar la carga de la configuración del contenedor de servicios desde la aplicación y paquetes, y también se encarga de su compilación y almacenamiento en caché. Incluso si no estás usando el ``HttpKernel``, debería darte una idea de una forma de organizar la configuración en una aplicación modular. - -Trabajando con contenedores en caché ------------------------------------- - -Antes de construrlo, el núcleo comprueba si existe una versión en caché del contenedor. El ``HttpKernel`` tiene un ajuste de depuración y si este es falso, se utiliza la versión en caché si existe. Si ``debug`` es verdadero, entonces el núcleo :doc:`comprueba si la configuración es fresca ` y si lo es, utiliza la versión en caché del contenedor. Si no, entonces el contenedor es construido a partir de la configuración a nivel de la aplicación y la configuración de los paquetes de extensión. - -Revisa :ref:`Volcando la configuración por rendimiento ` para más detalles. - -Configurando a nivel de la aplicación -------------------------------------- - -La configuración a nivel de la aplicación se carga desde el directorio ``app/chonfig``. Se cargan varios archivos, mismos que luego se fusionan al procesar las extensiones. Esto permite una diferente configuración para diferentes entornos, por ejemplo, ``dev``, ``prod``. - -Estos archivos contienen los parámetros y servicios que se cargan directamente en el contenedor de acuerdo a :ref:`Configurando el contenedor con archivos de configuración `. -También contienen configuración que es procesada por extensiones de acuerdo con :ref:`Gestionando la configuración con extensiones `. -Estos se consideran configuración del paquete, ya que cada paquete contiene la extensión de una clase. - -Configuración a nivel de paquete con las extensiones ----------------------------------------------------- - -Por convención, cada paquete contiene la extensión de una clase que se encuentra en directorio ``DependencyInjection`` del paquete. Éstas son registradas con el ``ContainerBuilder`` al arrancar el núcleo. Cuando el ``ContainerBuilder`` es :doc:`compilado `, la configuración a nivel de la aplicación correspondiente a la extensión del paquete se pasa a la extensión que también suele cargar sus propios archivos de configuración, típicamente desde el directorio ``Resources/config``. La configuración a nivel de la aplicación normalmente es procesada con un :doc: `objeto Configuration ` también almacenado en el directorio ``DependencyInjection`` del paquete. - -Pases del compilador para permitir la interacción entre paquetes ----------------------------------------------------------------- - -Los :ref:`pases del compilador ` se utilizan para permitir la interacción entre los diferentes paquetes, ya que estos no pueden afectar a la configuración de las demás clases de la extensión. Uno de sus principales usos es el procesamiento de servicios etiquetados, lo cual permite a los paquetes registrar servicios captados por otros paquetes, tal como registradores de *Monolog*, extensiones *Twig* y Colectores de datos para el generador de perfiles web. Se suele colocar los pases del compilador en el directorio ``DependencyInjection/Compiler``. - -Compilación y almacenamiento en caché -------------------------------------- - -Después de cargar el proceso de compilación los servicios de configuración, extensiones y pases del compilador, se vuelcan para que la memoria caché se pueda utilizar la próxima vez. La versión vertida se utiliza durante las posteriores peticiones, ya que es más eficiente. diff --git a/_sources/components/dom_crawler.txt b/_sources/components/dom_crawler.txt deleted file mode 100644 index d49cd6d..0000000 --- a/_sources/components/dom_crawler.txt +++ /dev/null @@ -1,312 +0,0 @@ -.. index:: - single: DomCrawler - single: Componentes; DomCrawler - -El componente ``DomCrawler`` -============================ - - El componente ``DomCrawler`` facilita la navegación por el *DOM* de documentos *HTML* y *XML*. - -.. note:: - - Aunque es posible, el componente ``DomCrawler`` no está diseñado para manipular el *DOM* o volcar *HTML*/*XML*. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/DomCrawler); -* :doc:`Instalándolo vía Composer ` (``symfony/dom-crawler`` en `Packagist`_). - -Usando ------- - -La clase :class:`Symfony\\Component\\DomCrawler\\Crawler` proporciona métodos para consultar y manipular documentos *HTML* y *XML*. - -Una instancia del rastreador (Crawler) representa un conjunto (:phpclass:`SplObjectStorage`) -de objetos :phpclass:`DOMElement`, los cuales básicamente son nodos que puedes recorrer fácilmente:: - - use Symfony\Component\DomCrawler\Crawler; - - $html = <<<'HTML' - - - -

    Hello World!

    -

    Hello Crawler!

    - - - HTML; - - $crawler = new Crawler($html); - - foreach ($crawler as $domElement) { - print $domElement->nodeName; - } - -Las clases especializadas :class:`Symfony\\Component\\DomCrawler\\Link` y :class:`Symfony\\Component\\DomCrawler\\Form` son útiles para interactuar con enlaces y formularios *html* conforme recorres el árbol *HTML*. - -Filtrando nodos -~~~~~~~~~~~~~~~ - -Usando expresiones *XPath* esto es realmente fácil:: - - $crawler = $crawler->filterXPath('descendant-or-self::body/p'); - -.. tip:: - - ``DOMXPath::query`` se utiliza internamente para llevar a cabo una consulta *XPath* realmente. - -El filtrado incluso es mucho más fácil si tienes instalado el componente ``CssSelector``. -Este te permite utilizar selectores similares a ``jQuery`` para recorrerlos:: - - $crawler = $crawler->filter('body > p'); - -Puedes utilizar funciones anónimas para filtrar con criterios más complejos:: - - $crawler = $crawler->filter('body > p')->reduce(function ($node, $i) { - // filtra nodos pares - return ($i % 2) == 0; - }); - -Para eliminar un nodo la función anónima debe regresar ``false``. - -.. note:: - - Todos los métodos devuelven una nueva instancia de la clase :class:`Symfony\\Component\\DomCrawler\\Crawler` con contenido filtrado. - -Recorriendo nodos -~~~~~~~~~~~~~~~~~ - -Accede al nodo por su posición en la lista:: - - $crawler->filter('body > p')->eq(0); - -Obtiene el primero o último nodo de la selección actual:: - - $crawler->filter('body > p')->first(); - $crawler->filter('body > p')->last(); - -Obtiene los nodos del mismo nivel de la selección actual:: - - $crawler->filter('body > p')->siblings(); - -Obtiene los nodos del mismo nivel después o antes de la selección actual:: - - $crawler->filter('body > p')->nextAll(); - $crawler->filter('body > p')->previousAll(); - -Obtiene todos los nodos hijos o padres:: - - $crawler->filter('body')->children(); - $crawler->filter('body > p')->parents(); - -.. note:: - - Todos los métodos de recorrido devuelven una nueva instancia de la clase :class:`Symfony\\Component\\DomCrawler\\Crawler`. - -Accediendo a valores de nodo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Accede al valor del primer nodo de la selección actual:: - - $message = $crawler->filterXPath('//body/p')->text(); - -Accede al valor del atributo del primer nodo de la selección actual:: - - $class = $crawler->filterXPath('//body/p')->attr('class'); - -Extrae el atributo y/o los valores del nodo desde la lista de nodos:: - - $attributes = $crawler - ->filterXpath('//body/p') - ->extract(array('_text', 'class')) - ; - -.. note:: - - El atributo especial ``_text`` representa el valor de un nodo. - -Invoca a una función anónima en cada nodo de la lista:: - - $nodeValues = $crawler->filter('p')->each(function ($node, $i) { - return $node->nodeValue; - }); - -La función anónima recibe como argumentos la posición y el nodo. -El resultado es un arreglo de valores devueltos por las llamadas a la función anónima. - -Añadiendo contenido -~~~~~~~~~~~~~~~~~~~ - -El ``crawler`` cuenta con soporte para múltiples formas de añadir contenido:: - - $crawler = new Crawler(''); - - $crawler->addHtmlContent(''); - $crawler->addXmlContent(''); - - $crawler->addContent(''); - $crawler->addContent('', 'text/xml'); - - $crawler->add(''); - $crawler->add(''); - -Puesto que la implementación del ``Crawler`` está basada en la extensión *DOM*, esta también puede interactuar con los objetos nativos :phpclass:`DOMDocument`, :phpclass:`DOMNodeList` y :phpclass:`DOMNode`: - -.. code-block:: php - - $document = new \DOMDocument(); - $document->loadXml(''); - $nodeList = $document->getElementsByTagName('node'); - $node = $document->getElementsByTagName('node')->item(0); - - $crawler->addDocument($document); - $crawler->addNodeList($nodeList); - $crawler->addNodes(array($node)); - $crawler->addNode($node); - $crawler->add($document); - -.. sidebar:: Manipulando y volcando un ``Crawler`` - - Estos métodos en el ``Crawler`` inicialmente pretenden poblar tu ``Crawler`` y no intentan usarse más allá de la manipulación del *DOM* (aunque esto es posible). Sin embargo, debido a que el ``Crawler`` es un conjunto de objetos :phpclass:`DOMElement`, puedes utilizar cualquier método o propiedad disponible en :phpclass:`DOMElement`, :phpclass:`DOMNode` o :phpclass:`DOMDocument`. - Por ejemplo, podrías conseguir el *HTML* de un ``Crawler`` con algo como esto:: - - $html = ''; - - foreach ($crawler as $domElement) { - $html .= $domElement->ownerDocument->saveHTML($domElement); - } - -Compatibilidad con formularios y enlaces -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Dentro del árbol del *DOM* los enlaces y formularios reciben un tratamiento especial. - -Enlaces -....... - -Para un enlace por nombre (o una imagen clicable por su atributo ``alt``), usa el método ``selectLink`` en un ``crawler`` existente. Este devuelve una instancia de un rastreador con únicamente el/los enlace(s) seleccionado(s). Al invocar a ``link()`` recibes un objeto especial :class:`Symfony\\Component\\DomCrawler\\Link`:: - - $linksCrawler = $crawler->selectLink('Go elsewhere...'); - $link = $linksCrawler->link(); - - // O haz todo esto de una vez - $link = $crawler->selectLink('Go elsewhere...')->link(); - -El objeto :class:`Symfony\\Component\\DomCrawler\\Link` tiene varios métodos útiles para obtener más información sobre el propio enlace seleccionado:: - - // Devuelve la URI adecuada que puedes utilizar para hacer otra petición - $uri = $link->getUri(); - -.. note:: - - El ``getUri()`` es especialmente útil, ya que limpia el valor de ``href`` y lo transforma a cómo se debe procesar realmente. Por ejemplo, para un enlace con ``href="#foo"``, este devolvería la *URI* completa de la página actual sufijada con ``#foo``. El valor de retorno de``getUri()`` siempre es una *URI* completa en la cual puedes actuar. - -Formularios -........... - -También se dá un trato especial a los formularios. Hay disponible un método ``selectButton()`` en el rastreador, el cual devuelve otro rastreador que coincide con un botón (``input[type=submit]``, ``input[type=image]``, o un ``button``) con el -texto dado. Este método es especialmente útil porque lo puedes utilizar para devolver un objeto :class:`Symfony\\Component\\DomCrawler\\Form` que representa al formulario en el que vive el botón:: - - $form = $crawler->selectButton('validate')->form(); - - // o "llena" los campos del formulario con datos - $form = $crawler->selectButton('validate')->form(array( - 'name' => 'Ryan', - )); - -El objeto :class:`Symfony\\Component\\DomCrawler\\Form` tiene un montón de métodos muy útiles para trabajar con formularios:: - - $uri = $form->getUri(); - - $method = $form->getMethod(); - -El método :method:`Symfony\\Component\\DomCrawler\\Form::getUri` hace más que solo devolver el atributo ``action`` del formulario. Si el método del formulario es ``GET``, entonces imita el comportamiento del navegador y devuelve el atributo ``action`` seguido de una cadena de consulta con todos los valores del formulario. - -Prácticamente puedes configurar y obtener valores en el formulario:: - - // Internamente configura valores en el formulario - $form->setValues(array( - 'registration[username]' => 'symfonyfan', - 'registration[terms]' => 1, - )); - - // recupera un arreglo de valores - en el arreglo 'plano' como el de arriba - $values = $form->getValues(); - - // devuelve los valores como los devolvería PHP, - // donde «registro» de su propio arreglo - $values = $form->getPhpValues(); - -Para trabajar con campos multidimensionales:: - -
    - - - -
    - -Pass an array of values:: - - // Set a single field - $form->setValues(array('multi' => array('value'))); - - // Set multiple fields at once - $form->setValues(array('multi' => array( - 1 => 'value', - 'dimensional' => 'an other value' - ))); - -¡Esto es muy bueno, pero se pone mejor! El objeto ``formulario`` te permite interactuar con tu formulario como un navegador, seleccionando los valores de radio, casillas de verificación marcadas, y archivos cargados:: - - $form['registration[username]']->setValue('symfonyfan'); - - // Activar o desactiva una casilla de verificación - $form['registration[terms]']->tick(); - $form['registration[terms]']->untick(); - - // selecciona una opción - $form['registration[birthday][year]']->select(1984); - - // selecciona varias opciones en una "select o checkboxes" múltiple - $form['registration[interests]']->select(array('symfony', 'cookies')); - - / / Incluso finge una carga de archivo - $form['registration[photo]']->upload('/ruta/a/lucas.jpg'); - -¿Cuál es el punto de hacer todo esto? Si estás probando internamente, puedes tomar la información de tu formulario, como si sólo se hubiera presentado utilizando valores *PHP*:: - - $values = $form->getPhpValues(); - $files = $form->getPhpFiles(); - -Si estás usando un cliente *HTTP* externo, puedes utilizar el formulario para recuperar toda la información que necesites para crear una petición ``POST`` para el formulario:: - - $uri = $form->getUri(); - $method = $form->getMethod(); - $values = $form->getValues(); - $files = $form->getFiles(); - - // Ahora usa un cliente *HTTP* y después utiliza esa información - -Un gran ejemplo de un sistema integrado que utiliza todo esto es `Goutte`_. -``Goutte`` entiende el objeto rastreador de *Symfony* y lo puedes utilizar para enviar formularios -directamente:: - - use Goutte\Client; - - // hace una petición real a un sitio externo - $client = new Client(); - $crawler = $client->request('GET', 'https://github.com/login'); - - // selecciona el formulario y completa algunos valores - $form = $crawler->selectButton('Log in')->form(); - $form['login'] = 'symfonyfan'; - $form['password'] = 'anypass'; - - // envía el formulario - $crawler = $client->submit($form); - -.. _`Goutte`: https://github.com/fabpot/goutte -.. _`Packagist`: https://packagist.org/packages/symfony/dom-crawler diff --git a/_sources/components/event_dispatcher.txt b/_sources/components/event_dispatcher.txt deleted file mode 100644 index 9a583dc..0000000 --- a/_sources/components/event_dispatcher.txt +++ /dev/null @@ -1,376 +0,0 @@ -.. index:: - single: Despachador de evento - -El componente despachador de eventos -==================================== - -Introducción ------------- - -El paradigma orientado a objetos ha recorrido un largo camino para garantizar la extensibilidad del código. Al crear clases que tienen responsabilidades bien definidas, el código se vuelve más flexible y un desarrollador lo puede extender con subclases para modificar su comportamiento. Pero si quieres compartir tus cambios con otros desarrolladores que también han hecho sus propias subclases, es discutible que la herencia de código sea la respuesta. - -Consideremos un ejemplo del mundo real en el que deseas proporcionar un sistema de complementos a tu proyecto. Un complemento debe ser capaz de agregar métodos, o hacer algo antes o después de ejecutar un método, sin interferir con otros complementos. Este no es un problema fácil de resolver con la herencia simple y herencia múltiple (en caso de que fuera posible con *PHP*) tiene sus propios inconvenientes. - -El despachador de eventos de *Symfony2* implementa el patrón `observador`_ en una manera sencilla y efectiva para hacer todo esto posible y para realmente hacer extensibles tus proyectos. - -Tomemos un ejemplo simple desde el `componente HttpKernel de Symfony2`_. Una vez creado un objeto ``Respuesta``, puede ser útil permitir que otros elementos en el sistema lo modifiquen (por ejemplo, añadan algunas cabeceras de caché) antes de utilizarlo realmente. Para hacer esto posible, el núcleo de *Symfony2* lanza un evento ---``kernel.response``---. Así es como funciona: - -* Un *escucha* (objeto *PHP*) le dice a un objeto *despachador* central que quiere escuchar el evento ``kernel.response``; - -* En algún momento, el núcleo de *Symfony2* dice al objeto *despachador* que difunda el evento ``kernel.response``, pasando con este un objeto ``Evento`` que tiene acceso al objeto ``Respuesta``; - -* El despachador notifica a (es decir, llama a un método en) todos los escuchas del evento ``kernel.response``, permitiendo que cada uno de ellos haga modificaciones al objeto ``Respuesta``. - -.. index:: - single: Despachador de evento; Eventos - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/EventDispatcher); -* Instalándolo a través de *PEAR* ( `pear.symfony.com/EventDispatcher`); -* Instalándolo vía ``Composer`` (`symfony/event-dispatcher` en Packagist). - -Usando ------- - -Eventos -~~~~~~~ - -Cuando se envía un evento, es identificado por un nombre único (por ejemplo, ``kernel.response``), al que cualquier cantidad de escuchas podría estar atento. También se crea una instancia de :class:`Symfony\\Component\\EventDispatcher\\Event` y se pasa a todos los escuchas. Como veremos más adelante, el objeto ``Evento`` mismo, a menudo contiene datos sobre cuando se despachó el evento. - -.. index:: - pair: Despachador de evento; Convenciones de nomenclatura - -Convenciones de nomenclatura -............................ - -El nombre único del evento puede ser cualquier cadena, pero opcionalmente sigue una serie de convenciones de nomenclatura simples: - -* Sólo usa letras minúsculas, números, puntos (``.``) y guiones bajos (``_``); - -* Prefija los nombres con un espacio de nombres seguido de un punto (por ejemplo, ``kernel.``); - -* Termina los nombres con un verbo que indica qué acción se está tomando (por ejemplo, ``request``). - -Estos son algunos ejemplos de nombres de evento aceptables: - -* ``kernel.response`` -* ``form.pre_set_data`` - -.. index:: - single: Despachador de evento; Subclases de evento - -Nombres de evento y objetos evento -.................................. - -Cuando el despachador notifica a los escuchas, este pasa un objeto ``Evento`` real a los escuchas. La clase base ``Evento`` es muy simple: contiene un método para detener la :ref:`propagación del evento `, pero no mucho más. - -Muchas veces, los datos acerca de un evento específico se tienen que pasar junto con el objeto ``Evento`` para que los escuchas tengan la información necesaria. En el caso del evento ``kernel.response``, el objeto ``Evento`` creado y pasado a cada escucha realmente es de tipo :class:`Symfony\\Component\\HttpKernel\\Event\\FilterResponseEvent`, una subclase del objeto ``Evento`` base. Esta clase contiene métodos como ``getResponse`` y ``setResponse``, que permiten a los escuchas recibir e incluso sustituir el objeto ``Respuesta``. - -La moraleja de la historia es la siguiente: Cuando creas un escucha para un evento, el objeto ``Evento`` que se pasa al escucha puede ser una subclase especial que tiene métodos adicionales para recuperar información desde y para responder al evento. - -El despachador -~~~~~~~~~~~~~~ - -El despachador es el objeto central del sistema despachador de eventos. En general, se crea un único despachador, el cual mantiene un registro de escuchas. Cuando se difunde un evento a través del despachador, este notifica a todos los escuchas registrados con ese evento. - -.. code-block:: php - - use Symfony\Component\EventDispatcher\EventDispatcher; - - $dispatcher = new EventDispatcher(); - -.. index:: - single: Despachador de evento; Escuchas - -Conectando escuchas -~~~~~~~~~~~~~~~~~~~ - -Para aprovechar las ventajas de un evento existente, es necesario conectar un escucha con el despachador para que pueda ser notificado cuando se despache el evento. Una llamada al método despachador ``addListener()`` asocia cualquier objeto *PHP* ejecutable a un evento: - -.. code-block:: php - - $listener = new AcmeListener(); - $dispatcher->addListener('foo.action', array($listener, 'onFooAction')); - -El método ``addListener()`` toma hasta tres argumentos: - -* El nombre del evento (cadena) que este escucha quiere atender; - -* Un objeto *PHP* ejecutable que será notificado cuando se produzca un evento al que está atento; - -* Un entero de prioridad opcional (mayor es igual a más importante) que determina cuando un escucha se activa frente a otros escuchas (por omisión es ``0``). Si dos escuchas tienen la misma prioridad, se ejecutan en el orden en que se agregaron al despachador. - -.. note:: - - Un `PHP ejecutable`_ es una variable *PHP* que la función ``call_user_func()`` puede utilizar y devuelve ``true`` cuando pasa a la función ``is_callable()``. Esta puede ser una instancia de ``\Closure``, un objeto que implementa un método ``__invoke`` (que es lo que ---de hecho--- hacen los cierres), una cadena que representa una función, o una matriz que representa a un método de un objeto o a un método de clase. - - Hasta ahora, hemos visto cómo los objetos *PHP* se pueden registrar como escuchas. También puedes registrar `Cierres`_ *PHP* como escuchas de eventos: - - .. code-block:: php - - use Symfony\Component\EventDispatcher\Event; - - $dispatcher->addListener('foo.action', function (Event $event) { - // se debe ejecutar al despachar el evento foo.action - }); - -Una vez que se registra el escucha en el despachador, este espera hasta que el evento sea notificado. En el ejemplo anterior, cuando se despacha el evento ``foo.action``, el despachador llama al método ``AcmeListener::onFooAction`` y pasa el objeto ``Evento`` como único argumento: - -.. code-block:: php - - use Symfony\Component\EventDispatcher\Event; - - class AcmeListener - { - // ... - - public function onFooAction(Event $event) - { - // Hace algo - } - } - -En muchos casos, una subclase especial ``Evento`` específica para el evento dado es pasada al escucha. Esto le da al escucha acceso a información especial sobre el evento. Consulta la documentación o la implementación de cada evento para determinar la instancia exacta de ``Symfony\Component\EventDispatcher\Event`` que se ha pasado. Por ejemplo, el evento ``kernel.event`` pasa una instancia de ``Symfony\Component\HttpKernel\Event\FilterResponseEvent``: - -.. code-block:: php - - use Symfony\Component\HttpKernel\Event\FilterResponseEvent - - public function onKernelResponse(FilterResponseEvent $event) - { - $response = $event->getResponse(); - $request = $event->getRequest(); - - // ... - } - -.. _event_dispatcher-closures-as-listeners: - -.. index:: - single: Despachador de evento; Creando y despachando un evento - -Creando y despachando un evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Además de registrar escuchas con eventos existentes, puedes crear y despachar tus propios eventos. Esto es útil cuando creas bibliotecas compartidas y también cuando deseas mantener flexibles y disociados de tu propio sistema diferentes componentes. - -La clase estática ``Events`` -............................ - -Supongamos que deseas crear un nuevo evento ---``store.order``--- el cual se despacha cada vez que es creada una orden dentro de tu aplicación. Para mantener las cosas organizadas, empieza por crear una clase ``StoreEvents`` dentro de tu aplicación que sirva para definir y documentar tu evento: - -.. code-block:: php - - namespace Acme\StoreBundle; - - final class StoreEvents - { - /** - * El evento 'store.order' es lanzado cada vez que se crea una orden - * en el sistema. - * - * El escucha del evento recibe una instancia de - * Acme\StoreBundle\Event\FilterOrderEvent. - * - * @var string - */ - const onStoreOrder = 'store.order'; - } - -Ten en cuenta que esta clase en realidad *no hace* nada. El propósito de la clase ``StoreEvents`` sólo es ser un lugar donde se pueda centralizar la información sobre los eventos comunes. Observa también que se pasará una clase especial ``FilterOrderEvent`` a cada escucha de este evento. - -Creando un objeto ``Evento`` -............................ - -Más tarde, cuando despaches este nuevo evento, debes crear una instancia del ``Evento`` y pasarla al despachador. Entonces el despachador pasa esta misma instancia a cada uno de los escuchas del evento. Si no necesitas pasar alguna información a tus escuchas, puedes utilizar la clase predeterminada ``Symfony\Component\EventDispatcher\Event``. La mayoría de las veces, sin embargo, *necesitarás* pasar información sobre el evento a cada escucha. Para lograrlo, vamos a crear una nueva clase que extiende a ``Symfony\Component\EventDispatcher\Event``. - -En este ejemplo, cada escucha tendrá acceso a algún objeto ``Order``. Crea una clase ``Evento`` que lo hace posible: - -.. code-block:: php - - namespace Acme\StoreBundle\Event; - - use Symfony\Component\EventDispatcher\Event; - use Acme\StoreBundle\Order; - - class FilterOrderEvent extends Event - { - protected $order; - - public function __construct(Order $order) - { - $this->order = $order; - } - - public function getOrder() - { - return $this->order; - } - } - -Ahora, cada escucha tiene acceso al objeto ``Order`` a través del método ``getOrder``. - -Despachando el evento -..................... - -El método :method:`Symfony\\Component\\EventDispatcher\\EventDispatcher::dispatch` notifica a todos los escuchas que el evento ha ocurrido. Este toma dos argumentos: el nombre del evento a despachar, y la instancia del ``Evento`` a pasar a cada escucha de ese evento: - -.. code-block:: php - - use Acme\StoreBundle\StoreEvents; - use Acme\StoreBundle\Order; - use Acme\StoreBundle\Event\FilterOrderEvent; - - // la orden de alguna manera es creada o recuperada - $order = new Order(); - // ... - - // crea el FilterOrderEvent y lo despacha - $event = new FilterOrderEvent($order); - $dispatcher->dispatch(StoreEvents::onStoreOrder, $event); - -Ten en cuenta que el objeto especial ``FilterOrderEvent`` se crea y pasa al método ``dispatch``. Ahora, cualquier escucha del evento ``store.order`` recibirá el ``FilterOrderEvent`` y tendrá acceso al objeto ``Order`` a través del método ``getOrder``: - -.. code-block:: php - - // alguna clase escucha que se ha registrado para onStoreOrder - use Acme\StoreBundle\Event\FilterOrderEvent; - - public function onStoreOrder(FilterOrderEvent $event) - { - $order = $event->getOrder(); - // haz algo para o con la orden - } - -Pasando el objeto despachador de evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si echas un vistazo a la clase ``EventDispatcher``, te darás cuenta de que la clase no actúa como una instancia única (no hay un método estático ``getInstance()``). -Esto es intencional, ya que posiblemente desees tener varios despachadores de eventos simultáneos en una sola petición *PHP*. Pero también significa que necesitas una manera de pasar el despachador a los objetos que necesitan conectar o notificar eventos. - -La mejor práctica consiste en inyectar el objeto despachador de eventos en tus objetos, también conocido como inyección de dependencias. - -Puedes usar la inyección del constructor:: - - use Symfony\Component\EventDispatcher\EventDispatcherInterface; - - class Foo - { - protected $dispatcher = null; - - public function __construct(EventDispatcherInterface $dispatcher) - { - $this->dispatcher = $dispatcher; - } - } - -O inyección en el definidor:: - - use Symfony\Component\EventDispatcher\EventDispatcherInterface; - - class Foo - { - protected $dispatcher = null; - - public function setEventDispatcher(EventDispatcherInterface $dispatcher) - { - $this->dispatcher = $dispatcher; - } - } - -La elección entre los dos realmente es cuestión de gusto. Muchos tienden a preferir el constructor de inyección porque los objetos son totalmente iniciados en tiempo de construcción. Pero cuando tienes una larga lista de dependencias, la inyección de definidores puede ser el camino a seguir, especialmente para dependencias opcionales. - -.. index:: - single: Despachador de evento; Suscriptores de evento - -Usando suscriptores de evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La forma más común para escuchar a un evento es registrar un *escucha de evento* con el despachador. Este escucha puede estar atento a uno o más eventos y ser notificado cada vez que se envían los eventos. - -Otra forma de escuchar eventos es a través de un *suscriptor de eventos*. Un suscriptor de eventos es una clase *PHP* que es capaz de decir al despachador exactamente a cuales eventos debe estar suscrito. Este implementa la interfaz :class:`Symfony\\Component\\EventDispatcher\\EventSubscriberInterface`, que requiere un solo método estático llamado ``getSubscribedEvents``. Considera el siguiente ejemplo de un suscriptor que está inscrito a los eventos ``kernel.response`` y ``store.order``: - -.. code-block:: php - - namespace Acme\StoreBundle\Event; - - use Symfony\Component\EventDispatcher\EventSubscriberInterface; - use Symfony\Component\HttpKernel\Event\FilterResponseEvent; - - class StoreSubscriber implements EventSubscriberInterface - { - static public function getSubscribedEvents() - { - return array( - 'kernel.response' => array( - array('onKernelResponsePre', 10), - array('onKernelResponseMid', 5), - array('onKernelResponsePost', 0), - ), - 'store.order' => array('onStoreOrder', 0), - ); - } - - public function onKernelResponsePre(FilterResponseEvent $event) - { - // ... - } - - public function onKernelResponseMid(FilterResponseEvent $event) - { - // ... - } - - public function onKernelResponsePost(FilterResponseEvent $event) - { - // ... - } - - public function onStoreOrder(FilterOrderEvent $event) - { - // ... - } - } - -Esto es muy similar a una clase escucha, salvo que la propia clase puede decir al despachador cuales eventos debe escuchar. Para registrar un suscriptor al despachador, utiliza el método :method:`Symfony\\Component\\EventDispatcher\\EventDispatcher::addSubscriber`: - -.. code-block:: php - - use Acme\StoreBundle\Event\StoreSubscriber; - - $subscriber = new StoreSubscriber(); - $dispatcher->addSubscriber($subscriber); - -El despachador registrará automáticamente al suscriptor para cada evento devuelto por el método ``getSubscribedEvents``. Este método devuelve una matriz indexada por el nombre del evento y cuyos valores son el nombre del método a llamar o una matriz compuesta por el nombre del método a llamar y la prioridad. El ejemplo anterior muestra cómo registrar varios métodos escucha para el mismo evento en un suscriptor, y, además muestra cómo transmitir la prioridad de cada uno de los métodos escucha. - -.. index:: - single: Despachador de evento; Deteniendo el flujo del evento - -.. _event_dispatcher-event-propagation: - -Deteniendo el flujo/propagación del evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En algunos casos, puede tener sentido que un escucha evite que se llame a otros escuchas. En otras palabras, el escucha tiene que poder decirle al despachador detenga la propagación del evento a todos los escuchas en el futuro (es decir, no notificar a más escuchas). Esto se puede lograr desde el interior de un escucha a través del método :method:`Symfony\\Component\\EventDispatcher\\Event::stopPropagation`: - -.. code-block:: php - - use Acme\StoreBundle\Event\FilterOrderEvent; - - public function onStoreOrder(FilterOrderEvent $event) - { - // ... - - $event->stopPropagation(); - } - -Ahora, cualquier escucha de ``store.order`` que no haya llamado aún, *no* será invocado. - -.. _`observador`: http://en.wikipedia.org/wiki/Observer_pattern -.. _`componente HttpKernel de Symfony2`: https://github.com/symfony/HttpKernel -.. _`Cierres`: http://www.php.net/manual/es/functions.anonymous.php -.. _`PHP ejecutable`: http://www.php.net/manual/es/language.pseudo-types.php#language.types.callback \ No newline at end of file diff --git a/_sources/components/event_dispatcher/container_aware_dispatcher.txt b/_sources/components/event_dispatcher/container_aware_dispatcher.txt deleted file mode 100644 index b009a53..0000000 --- a/_sources/components/event_dispatcher/container_aware_dispatcher.txt +++ /dev/null @@ -1,91 +0,0 @@ -.. index:: - single: Despachador de evento; Contenedor consciente del servicio - -Contenedor consciente del despachador de eventos -================================================ - -.. versionadded:: 2.1 - Esta característica se movió al componente ``EventDispatcher`` en *Symfony 2.1*. - -Introducción ------------- - -La clase :class:`Symfony\\Component\\EventDispatcher\\ContainerAwareEventDispatcher` es una implementación especial del despachador de eventos que es conectada al contenedor del servicio -que forma parte del :doc:`componente de Inyección de dependencias `. -Esto te permite especificar servicios como escuchas de evento volviendo extremadamente potente al despachador de eventos. - -Los servicios se cargan de manera diferida, lo cual significa que los servicios adjuntos como escuchas sólo se crearán si se despacha un evento que requiere de esos escuchas. - -Configurando ------------- - -La instalación es sencilla inyectando una :class:`Symfony\\Component\\DependencyInjection\\ContainerInterface` en :class:`Symfony\\Component\\EventDispatcher\\ContainerAwareEventDispatcher`:: - - use Symfony\Component\DependencyInjection\ContainerBuilder; - use Symfony\Component\EventDispatcher\ContainerAwareEventDispatcher; - - $container = new ContainerBuilder(); - $dispatcher = new ContainerAwareEventDispatcher($container); - -Añadiendo escuchas ------------------- - -El *contenedor consciente del despachador de eventos* puede cargar determinados servicios directamente, o servicios que implementan la :class:`Symfony\\Component\\EventDispatcher\\EventSubscriberInterface`. - -Los siguientes ejemplos asumen que el contenedor de servicios se ha cargado con algunos -servicios ya mencionados. - -.. note:: - - Los servicios se tienen que marcar como públicos en el contenedor. - -Agregando servicios -~~~~~~~~~~~~~~~~~~~ - -Para conectar las definiciones de servicios existentes, usa el método :method:`Symfony\\Component\\EventDispatcher\\ContainerAwareEventDispatcher::addListenerService` dónde ``$callback`` es un arreglo de ``array($serviceId, $methodName)``:: - - $dispatcher->addListenerService($eventName, array('foo', 'logListener')); - -Agregando suscriptores de servicios -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes agregar ``EventSubscribers`` usando el método :method:`Symfony\\Component\\EventDispatcher\\ContainerAwareEventDispatcher::addSubscriberService` dónde el primer argumento es el identificador del suscriptor del servicio, y el segundo argumento es el nombre de la clase del servicio (el cual debe implementar la :class:`Symfony\\Component\\EventDispatcher\\EventSubscriberInterface`) de la siguiente manera:: - - $dispatcher->addSubscriberService( - 'kernel.store_subscriber', - 'StoreSubscriber' - ); - -La ``EventSubscriberInterface`` será exactamente como era de esperar:: - - use Symfony\Component\EventDispatcher\EventSubscriberInterface; - // ... - - class StoreSubscriber implements EventSubscriberInterface - { - public static function getSubscribedEvents() - { - return array( - 'kernel.response' => array( - array('onKernelResponsePre', 10), - array('onKernelResponsePost', 0), - ), - 'store.order' => array('onStoreOrder', 0), - ); - } - - public function onKernelResponsePre(FilterResponseEvent $event) - { - // ... - } - - public function onKernelResponsePost(FilterResponseEvent $event) - { - // ... - } - - public function onStoreOrder(FilterOrderEvent $event) - { - // ... - } - } diff --git a/_sources/components/event_dispatcher/generic_event.txt b/_sources/components/event_dispatcher/generic_event.txt deleted file mode 100644 index 1add79b..0000000 --- a/_sources/components/event_dispatcher/generic_event.txt +++ /dev/null @@ -1,98 +0,0 @@ -.. index:: - single: Despachador de evento - -El objeto evento genérico -========================= - -.. versionadded:: 2.1 - La clase del evento ``GenericEvent`` se añadió en *Symfony 2.1*. - -La clase base :class:`Symfony\\Component\\EventDispatcher\\Event` proporcionada por el componente ``Despachador de eventos`` deliberadamente es escasa para permitir la creación por herencia de la *API* de objetos ``Evento`` específicos usando programación orientada a objetos. Esto permite código elegante y fácil de leer en aplicaciones complejas. - -La clase :class:`Symfony\\Component\\EventDispatcher\\GenericEvent` está disponible por conveniencia para aquellos que quieran utilizar un solo objeto ``Evento`` en toda su aplicación. Este es adecuado para la mayoría de los propósitos fuera de la caja, puesto que sigue el patrón ``observador estándar`` en el que el objeto ``evento`` encapsula el ``tema`` de un ``evento``, pero que adicionalmente tiene argumentos opcionales extra. - -La clase :class:`Symfony\\Component\\EventDispatcher\\GenericEvent` tiene una *API* sencilla, además de la clase base :class:`Symfony\\Component\\EventDispatcher\\Event`: - -* :method:`Symfony\\Component\\EventDispatcher\\GenericEvent::__construct`: - El constructor toma el ``tema`` y argumentos del ``evento``; - -* :method:`Symfony\\Component\\EventDispatcher\\GenericEvent::getSubject`: - Obtiene el ``tema``; - -* :method:`Symfony\\Component\\EventDispatcher\\GenericEvent::setArgument`: - Define un argumento por ``clave``; - -* :method:`Symfony\\Component\\EventDispatcher\\GenericEvent::setArguments`: - Establece el arreglo de argumentos; - -* :method:`Symfony\\Component\\EventDispatcher\\GenericEvent::getArgument`: - Obtiene un argumento por ``clave``; - -* :method:`Symfony\\Component\\EventDispatcher\\GenericEvent::getArguments`: - Captador para todos los argumentos; - -* :method:`Symfony\\Component\\EventDispatcher\\GenericEvent::hasArgument`: - Devuelve ``true`` si existe el argumento ``clave``; - -El ``GenericEvent`` también implementa la clase :phpclass:`ArrayAccess` en los argumentos del evento, lo cual lo hace muy conveniente para pasar argumentos adicionales relacionados al ``tema`` del ``evento``. - -Los siguientes ejemplos muestran casos de uso para darte una idea general de su flexibilidad. -Los ejemplos asumen que los escuchas de eventos se han añadido al despachador. - -Basta con pasar un ``tema`` (``$subject``):: - - use Symfony\Component\EventDispatcher\GenericEvent; - - $event = GenericEvent($subject); - $dispatcher->dispatch('foo', $event); - - class FooListener - { - public function handler(GenericEvent $event) - { - if ($event->getSubject() instanceof Foo) { - // ... - } - } - } - -Pasando y procesando argumentos usando la *API* de :phpclass:`ArrayAccess` para acceder a los argumentos del ``evento``:: - - use Symfony\Component\EventDispatcher\GenericEvent; - - $event = new GenericEvent( - $subject, - array('type' => 'foo', 'counter' => 0) - ); - $dispatcher->dispatch('foo', $event); - - echo $event['counter']; - - class FooListener - { - public function handler(GenericEvent $event) - { - if (isset($event['type']) && $event['type'] === 'foo') { - // ... hace algo - } - - $event['counter']++; - } - } - -Filtrando datos:: - - use Symfony\Component\EventDispatcher\GenericEvent; - - $event = new GenericEvent($subject, array('data' => 'foo')); - $dispatcher->dispatch('foo', $event); - - echo $event['data']; - - class FooListener - { - public function filter(GenericEvent $event) - { - strtolower($event['data']); - } - } diff --git a/_sources/components/event_dispatcher/index.txt b/_sources/components/event_dispatcher/index.txt deleted file mode 100644 index f9fb4db..0000000 --- a/_sources/components/event_dispatcher/index.txt +++ /dev/null @@ -1,9 +0,0 @@ -Despachador de eventos -====================== - -.. toctree:: - :maxdepth: 2 - - introduction - generic_event - container_aware_dispatcher diff --git a/_sources/components/event_dispatcher/introduction.txt b/_sources/components/event_dispatcher/introduction.txt deleted file mode 100644 index ba24e0d..0000000 --- a/_sources/components/event_dispatcher/introduction.txt +++ /dev/null @@ -1,470 +0,0 @@ -.. index:: - single: Despachador de eventos - single: Componentes; EventDispatcher - -El componente despachador de eventos -==================================== - -Introducción ------------- - -El paradigma orientado a objetos ha recorrido un largo camino para garantizar la extensibilidad del código. Al crear clases que tienen responsabilidades bien definidas, el código se vuelve más flexible y un desarrollador lo puede extender con subclases para modificar su comportamiento. Pero si quieres compartir tus cambios con otros desarrolladores que también han hecho sus propias subclases, es discutible que la herencia de código sea la respuesta. - -Consideremos un ejemplo del mundo real en el que deseas proporcionar un sistema de complementos a tu proyecto. Un complemento debe ser capaz de agregar métodos, o hacer algo antes o después de ejecutar un método, sin interferir con otros complementos. Este no es un problema fácil de resolver con la herencia simple y herencia múltiple (en caso de que fuera posible con *PHP*) tiene sus propios inconvenientes. - -El despachador de eventos de *Symfony2* implementa el patrón `observador`_ en una manera sencilla y efectiva para hacer todo esto posible y para realmente hacer extensibles tus proyectos. - -Estudia un sencillo ejemplo desde el :doc:`/components/http_kernel/introduction`. Una vez creado un objeto ``Respuesta``, puede ser útil permitir que otros elementos en el sistema lo modifiquen (por ejemplo, añadan algunas cabeceras de caché) antes de utilizarlo realmente. Para hacer esto posible, el núcleo de *Symfony2* lanza un evento ---``kernel.response``---. Así es como funciona: - -* Un *escucha* (objeto *PHP*) le dice a un objeto *despachador* central que quiere escuchar el evento ``kernel.response``; - -* En algún momento, el núcleo de *Symfony2* dice al objeto *despachador* que difunda el evento ``kernel.response``, pasando con este un objeto ``Evento`` que tiene acceso al objeto ``Respuesta``; - -* El despachador notifica a (es decir, llama a un método en) todos los escuchas del evento ``kernel.response``, permitiendo que cada uno de ellos haga modificaciones al objeto ``Respuesta``. - -.. index:: - single: Despachador de evento; Eventos - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/EventDispatcher); -* :doc:`Instalándolo vía Composer ` (``symfony/event-dispatcher`` en `Packagist`_). - -Usando ------- - -Eventos -~~~~~~~ - -Cuando se envía un evento, es identificado por un nombre único (por ejemplo, ``kernel.response``), al que cualquier cantidad de escuchas podría estar atento. También se crea una instancia de :class:`Symfony\\Component\\EventDispatcher\\Event` y se pasa a todos los escuchas. Como veremos más adelante, el objeto ``Evento`` mismo, a menudo contiene datos sobre cuando se despachó el evento. - -.. index:: - pair: Despachador de evento; Convenciones de nomenclatura - -Convenciones de nomenclatura -............................ - -El nombre único del evento puede ser cualquier cadena, pero opcionalmente sigue una serie de convenciones de nomenclatura simples: - -* Sólo usa letras minúsculas, números, puntos (``.``) y guiones bajos (``_``); - -* Prefija los nombres con un espacio de nombres seguido de un punto (por ejemplo, ``kernel.``); - -* Termina los nombres con un verbo que indica qué acción se está tomando (por ejemplo, ``request``). - -Estos son algunos ejemplos de nombres de evento aceptables: - -* ``kernel.response`` -* ``form.pre_set_data`` - -.. index:: - single: Despachador de evento; Subclases de evento - -Nombres de evento y objetos evento -.................................. - -Cuando el despachador notifica a los escuchas, este pasa un objeto ``Evento`` real a los escuchas. La clase base ``Evento`` es muy simple: contiene un método para detener la :ref:`propagación del evento `, pero no mucho más. - -Muchas veces, los datos acerca de un evento específico se tienen que pasar junto con el objeto ``Evento`` para que los escuchas tengan la información necesaria. En el caso del evento ``kernel.response``, el objeto ``Evento`` creado y pasado a cada escucha realmente es de tipo :class:`Symfony\\Component\\HttpKernel\\Event\\FilterResponseEvent`, una subclase del objeto ``Evento`` base. Esta clase contiene métodos como ``getResponse`` y ``setResponse``, que permiten a los escuchas recibir e incluso sustituir el objeto ``Respuesta``. - -La moraleja de la historia es la siguiente: Cuando creas un escucha para un evento, el objeto ``Evento`` que se pasa al escucha puede ser una subclase especial que tiene métodos adicionales para recuperar información desde y para responder al evento. - -El despachador -~~~~~~~~~~~~~~ - -El despachador es el objeto central del sistema despachador de eventos. En general, se crea un único despachador, el cual mantiene un registro de escuchas. Cuando se difunde un evento a través del despachador, este notifica a todos los escuchas registrados a ese evento:: - - use Symfony\Component\EventDispatcher\EventDispatcher; - - $dispatcher = new EventDispatcher(); - -.. index:: - single: Despachador de evento; Escuchas - -Conectando escuchas -~~~~~~~~~~~~~~~~~~~ - -Para aprovechar las ventajas de un evento existente, es necesario conectar un escucha con el despachador para que pueda ser notificado cuando se despache el evento. Una llamada al método despachador ``addListener()`` asocia cualquier objeto *PHP* ejecutable a un evento:: - - $listener = new AcmeListener(); - $dispatcher->addListener('foo.action', array($listener, 'onFooAction')); - -El método ``addListener()`` toma hasta tres argumentos: - -* El nombre del evento (cadena) que este escucha quiere atender; - -* Un objeto *PHP* ejecutable que será notificado cuando se produzca un evento al que está atento; - -* Un entero de prioridad opcional (mayor es igual a más importante) que determina cuando un escucha se activa frente a otros escuchas (por omisión es ``0``). Si dos escuchas tienen la misma prioridad, se ejecutan en el orden en que se agregaron al despachador. - -.. note:: - - Un `PHP ejecutable`_ es una variable *PHP* que la función ``call_user_func()`` puede utilizar y devuelve ``true`` cuando pasa a la función ``is_callable()``. Esta puede ser una instancia de ``\Closure``, un objeto que implementa un método ``__invoke`` (que es lo que ---de hecho--- hacen los cierres), una cadena que representa una función, o un arreglo que representa a un método de un objeto o a un método de clase. - - Hasta ahora, hemos visto cómo los objetos *PHP* se pueden registrar como escuchas. También puedes registrar `Cierres`_ *PHP* como escuchas de eventos:: - - use Symfony\Component\EventDispatcher\Event; - - $dispatcher->addListener('foo.action', function (Event $event) { - // se debe ejecutar al despachar el evento foo.action - }); - -Una vez que se registra el escucha en el despachador, este espera hasta que el evento sea notificado. En el ejemplo anterior, cuando se despacha el evento ``foo.action``, el despachador llama al método ``AcmeListener::onFooAction`` y le pasa el objeto ``Evento`` como único argumento:: - - use Symfony\Component\EventDispatcher\Event; - - class AcmeListener - { - // ... - - public function onFooAction(Event $event) - { - // ... hace algo - } - } - -En muchos casos, una subclase especial ``Evento`` específica para el evento dado es pasada al escucha. Esto le da al escucha acceso a información especial sobre el evento. Consulta la documentación o la implementación de cada evento para determinar la instancia exacta de ``Symfony\Component\EventDispatcher\Event`` que se ha pasado. Por ejemplo, el evento ``kernel.event`` pasa una instancia de ``Symfony\Component\HttpKernel\Event\FilterResponseEvent``:: - - use Symfony\Component\HttpKernel\Event\FilterResponseEvent; - - public function onKernelResponse(FilterResponseEvent $event) - { - $response = $event->getResponse(); - $request = $event->getRequest(); - - // ... - } - -.. _event_dispatcher-closures-as-listeners: - -.. index:: - single: Despachador de evento; Creando y despachando un evento - -Creando y despachando un evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Además de registrar escuchas con eventos existentes, puedes crear y despachar tus propios eventos. Esto es útil cuando creas bibliotecas compartidas y también cuando deseas mantener flexibles y disociados de tu propio sistema diferentes componentes. - -La clase estática ``Events`` -............................ - -Supongamos que deseas crear un nuevo evento ---``store.order``--- el cual se despacha cada vez que es creada una orden dentro de tu aplicación. Para mantener las cosas organizadas, empieza por crear una clase ``StoreEvents`` dentro de tu aplicación que sirva para definir y documentar tu evento:: - - namespace Acme\StoreBundle; - - final class StoreEvents - { - /** - * El evento «store.order» es lanzado cada vez que se crea una orden - * en el sistema. - * - * El escucha del evento recibe una - * instancia de Acme\StoreBundle\Event\FilterOrderEvent. - * - * @var string - */ - const STORE_ORDER = 'store.order'; - } - -Ten en cuenta que esta clase en realidad *no hace* nada. El propósito de la clase ``StoreEvents`` sólo es ser un lugar donde se pueda centralizar la información sobre los eventos comunes. Observa también que se pasará una clase especial ``FilterOrderEvent`` a cada escucha de este evento. - -Creando un objeto ``Evento`` -............................ - -Más tarde, cuando despaches este nuevo evento, debes crear una instancia del ``Evento`` y pasarla al despachador. Entonces el despachador pasa esta misma instancia a cada uno de los escuchas del evento. Si no necesitas pasar alguna información a tus escuchas, puedes utilizar la clase predeterminada ``Symfony\Component\EventDispatcher\Event``. La mayoría de las veces, sin embargo, *necesitarás* pasar información sobre el evento a cada escucha. Para lograrlo, vamos a crear una nueva clase que extiende a ``Symfony\Component\EventDispatcher\Event``. - -En este ejemplo, cada escucha tendrá acceso a algún objeto ``Order``. Crea una clase ``Evento`` que lo hace posible:: - - namespace Acme\StoreBundle\Event; - - use Symfony\Component\EventDispatcher\Event; - use Acme\StoreBundle\Order; - - class FilterOrderEvent extends Event - { - protected $order; - - public function __construct(Order $order) - { - $this->order = $order; - } - - public function getOrder() - { - return $this->order; - } - } - -Ahora, cada escucha tiene acceso al objeto ``Order`` a través del método ``getOrder``. - -Despachando el evento -..................... - -El método :method:`Symfony\\Component\\EventDispatcher\\EventDispatcher::dispatch` notifica a todos los escuchas que el evento ha ocurrido. Este toma dos argumentos: el nombre del evento a despachar, y la instancia del ``Evento`` a pasar a cada escucha de ese evento:: - - use Acme\StoreBundle\StoreEvents; - use Acme\StoreBundle\Order; - use Acme\StoreBundle\Event\FilterOrderEvent; - - // la orden de alguna manera es creada o recuperada - $order = new Order(); - // ... - - // crea el FilterOrderEvent y lo despacha - $event = new FilterOrderEvent($order); - $dispatcher->dispatch(StoreEvents::STORE_ORDER, $event); - -Ten en cuenta que el objeto especial ``FilterOrderEvent`` se crea y pasa al método ``dispatch``. Ahora, cualquier escucha del evento ``store.order`` recibirá el ``FilterOrderEvent`` y tendrá acceso al objeto ``Order`` a través del método ``getOrder``:: - - // alguna clase escucha registrada al evento "STORE_ORDER" - use Acme\StoreBundle\Event\FilterOrderEvent; - - public function onStoreOrder(FilterOrderEvent $event) - { - $order = $event->getOrder(); - // haz algo para o con la orden - } - -.. index:: - single: Despachador de evento; Suscriptores de evento - -.. _event_dispatcher-using-event-subscribers: - -Usando suscriptores de evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La forma más común para escuchar a un evento es registrar un *escucha de evento* con el despachador. Este escucha puede estar atento a uno o más eventos y ser notificado cada vez que se envían los eventos. - -Otra forma de escuchar eventos es a través de un *suscriptor de eventos*. Un suscriptor de eventos es una clase *PHP* que es capaz de decir al despachador exactamente a cuales eventos debe estar suscrito. Este implementa la interfaz :class:`Symfony\\Component\\EventDispatcher\\EventSubscriberInterface`, que requiere un solo método estático llamado ``getSubscribedEvents``. Considera el siguiente ejemplo de un suscriptor que está inscrito a los eventos ``kernel.response`` y ``store.order``:: - - namespace Acme\StoreBundle\Event; - - use Symfony\Component\EventDispatcher\EventSubscriberInterface; - use Symfony\Component\HttpKernel\Event\FilterResponseEvent; - - class StoreSubscriber implements EventSubscriberInterface - { - public static function getSubscribedEvents() - { - return array( - 'kernel.response' => array( - array('onKernelResponsePre', 10), - array('onKernelResponseMid', 5), - array('onKernelResponsePost', 0), - ), - 'store.order' => array('onStoreOrder', 0), - ); - } - - public function onKernelResponsePre(FilterResponseEvent $event) - { - // ... - } - - public function onKernelResponseMid(FilterResponseEvent $event) - { - // ... - } - - public function onKernelResponsePost(FilterResponseEvent $event) - { - // ... - } - - public function onStoreOrder(FilterOrderEvent $event) - { - // ... - } - } - -Esto es muy similar a una clase escucha, salvo que la propia clase puede decir al despachador cuales eventos debe escuchar. Para registrar un suscriptor al despachador, utiliza el método :method:`Symfony\\Component\\EventDispatcher\\EventDispatcher::addSubscriber`:: - - use Acme\StoreBundle\Event\StoreSubscriber; - - $subscriber = new StoreSubscriber(); - $dispatcher->addSubscriber($subscriber); - -El despachador registrará automáticamente al suscriptor para cada evento devuelto por el método ``getSubscribedEvents``. Este método devuelve un arreglo indexado por el nombre del evento y cuyos valores son el nombre del método a llamar o un arreglo compuesto por el nombre del método a llamar y la prioridad. El ejemplo anterior muestra cómo registrar varios métodos escucha para el mismo evento en un suscriptor, y, además muestra cómo transmitir la prioridad de cada uno de los métodos escucha. -The higher the priority, the earlier the method is called. In the above -example, when the ``kernel.response`` event is triggered, the methods -``onKernelResponsePre``, ``onKernelResponseMid``, and ``onKernelResponsePost`` -are called in that order. - -.. index:: - single: Despachador de evento; Deteniendo el flujo del evento - -.. _event_dispatcher-event-propagation: - -Deteniendo el flujo/propagación del evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En algunos casos, puede tener sentido que un escucha evite que se llame a otros escuchas. En otras palabras, el escucha tiene que poder decirle al despachador detenga la propagación del evento a todos los escuchas en el futuro (es decir, no notificar a más escuchas). Esto se puede lograr desde el interior de un escucha a través del método :method:`Symfony\\Component\\EventDispatcher\\Event::stopPropagation`:: - - use Acme\StoreBundle\Event\FilterOrderEvent; - - public function onStoreOrder(FilterOrderEvent $event) - { - // ... - - $event->stopPropagation(); - } - -Ahora, cualquier escucha de ``store.order`` que no haya llamado aún, *no* será invocado. - -Es posible detectar si un evento fue detenido utilizando el método :method:`Symfony\\Component\\EventDispatcher\\Event::isPropagationStopped` que devuelve un valor booleano:: - - $dispatcher->dispatch('foo.event', $event); - if ($event->isPropagationStopped()) { - // ... - } - -.. index:: - single: Despachador de evento; Despachador de eventos consciente de eventos y escuchas - -.. _event_dispatcher-dispatcher-aware-events: - -El ``EventDispatcher`` está consciente de eventos y escuchas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El objeto ``Event`` contiene una referencia al despachador que lo invocó desde *Symfony 2.1* - -El ``EventDispatcher`` siempre inyecta una referencia a sí mismo en el objeto evento que se le pasa. Esto significa que todos los escuchas tienen acceso directo al objeto ``EventDispatcher`` que notifica al escucha a través del método :method:`Symfony\\Component\\EventDispatcher\\Event::getDispatcher` del objeto ``Event`` transmitido. - -Esto puede llevar a algunas aplicaciones avanzadas del ``EventDispatcher`` incluyendo dejar que los escuchas envíen otros eventos, encadenando eventos o incluso cargando escuchas de manera diferida en el objeto ``Despachador``. Algunos ejemplos: - -Cargando escuchas de manera diferida:: - - - use Symfony\Component\EventDispatcher\Event; - use Acme\StoreBundle\Event\StoreSubscriber; - - class Foo - { - private $started = false; - - public function myLazyListener(Event $event) - { - if (false === $this->started) { - $subscriber = new StoreSubscriber(); - $event->getDispatcher()->addSubscriber($subscriber); - } - - $this->started = true; - - // ... más código - } - } - -Despachando otro event desde un escucha:: - - use Symfony\Component\EventDispatcher\Event; - - class Foo - { - public function myFooListener(Event $event) - { - $event->getDispatcher()->dispatch('log', $event); - - // ... más código - } - } - -Si bien lo anterior es suficiente para la mayoría de los casos, si tu aplicación utiliza múltiples -instancias del ``EventDispatcher``, posiblemente tengas que inyectar específicamente una -instancia conocida del ``EventDispatcher`` en tus escuchas. Esto se podría hacer inyectándolo en el constructor o con un definidor de la siguiente manera: - -Inyección en el constructor:: - - use Symfony\Component\EventDispatcher\EventDispatcherInterface; - - class Foo - { - protected $dispatcher = null; - - public function __construct(EventDispatcherInterface $dispatcher) - { - $this->dispatcher = $dispatcher; - } - } - -O inyección en el definidor:: - - use Symfony\Component\EventDispatcher\EventDispatcherInterface; - - class Foo - { - protected $dispatcher = null; - - public function setEventDispatcher(EventDispatcherInterface $dispatcher) - { - $this->dispatcher = $dispatcher; - } - } - -La elección entre los dos realmente es cuestión de gusto. Muchos tienden a preferir el constructor de inyección porque los objetos son totalmente iniciados en tiempo de construcción. Pero cuando tienes una larga lista de dependencias, la inyección de definidores puede ser el camino a seguir, especialmente para dependencias opcionales. - -.. index:: - single: Despachador de evento; Atajos del despachador - -.. _event_dispatcher-shortcuts: - -Atajos del despachador -~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El método ``EventDispatcher::dispatch()`` devuelve el evento desde *Symfony 2.1*. - -El Método :method:`EventDispatcher::dispatch ` siempre devuelve un objeto :class:`Symfony\\Component\\EventDispatcher\\Event`. Este permite varios atajos. Por ejemplo, si uno no necesita un objeto evento personalizado, simplemente puedes confiar en un simple objeto :class:`Symfony\\Component\\EventDispatcher\\Event`. Ni siquiera lo tienes que pasar al despachador ya que de manera predeterminada creará uno a menos que específicamente le pases uno:: - - $dispatcher->dispatch('foo.event'); - -Por otra parte, el ``EventDispatcher`` siempre devuelve cualquier objeto ``evento`` que le hayas enviado, es decir, ya sea el evento que le hayas pasado o la instancia que internamente haya creado el despachador. Esto da pie a bonitos accesos directos:: - - if (!$dispatcher->dispatch('foo.event')->isPropagationStopped()) { - // ... - } - -O:: - - $barEvent = new BarEvent(); - $bar = $dispatcher->dispatch('bar.event', $barEvent)->getBar(); - -O:: - - $response = $dispatcher->dispatch('bar.event', new BarEvent())->getBar(); - -y así sucesivamente... - -.. index:: - single: Despachador de evento; Inspeccionando el nombre del evento - -.. _event_dispatcher-event-name-introspection: - -introspección el nombre del evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El nombre del evento se añadió al objeto ``Event`` desde *Symfony 2.1* - -Puesto que el ``EventDispatcher`` ya sabe el nombre del evento al despacharlo, el nombre del evento también se inyecta en los objetos :class:`Symfony\\Component\\EventDispatcher\\Event`, poniéndolo a disposición de los escuchas de eventos a través del método :method:`Symfony\\Component\\EventDispatcher\\Event::getName`. - -El nombre del evento, (como con cualquier otro dato en un objeto evento personalizado) se puede utilizar como parte de la lógica de procesamiento del escucha:: - - use Symfony\Component\EventDispatcher\Event; - - class Foo - { - public function myEventListener(Event $event) - { - echo $event->getName(); - } - } - -.. _`observador`: http://en.wikipedia.org/wiki/Observer_pattern -.. _`Cierres`: http://www.php.net/manual/es/functions.anonymous.php -.. _`PHP ejecutable`: http://www.php.net/manual/en/language.pseudo-types.php#language.types.callback -.. _`Packagist`: https://packagist.org/packages/symfony/event-dispatcher diff --git a/_sources/components/filesystem.txt b/_sources/components/filesystem.txt deleted file mode 100644 index 45ccb1a..0000000 --- a/_sources/components/filesystem.txt +++ /dev/null @@ -1,215 +0,0 @@ -.. index:: - single: Filesystem - -El componente ``Filesystem`` -============================ - - El componente ``Filesystem`` proporciona herramientas básicas para el sistema de archivos. - -.. versionadded:: 2.1 - El componente ``Filesystem`` es una novedad en *Symfony 2.1*. Anteriormente, la clase ``Filesystem`` se encontraba en el componente ``HttpKernel``. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Filesystem); -* Instalándolo vía ``Composer`` (``symfony/filesystem`` en `Packagist`_). - -Usando ------- - -La clase :class:`Symfony\\Component\\Filesystem\\Filesystem` es el único punto final para las operaciones del sistema de archivos:: - - use Symfony\Component\Filesystem\Filesystem; - use Symfony\Component\Filesystem\Exception\IOException; - - $fs = new Filesystem(); - - try { - $fs->mkdir('/tmp/random/dir/' . mt_rand()); - } catch (IOException $e) { - echo "An error occurred while creating your directory"; - } - -.. note:: - - Los métodos :method:`Symfony\\Component\\Filesystem\\Filesystem::mkdir`, :method:`Symfony\\Component\\Filesystem\\Filesystem::exists`, :method:`Symfony\\Component\\Filesystem\\Filesystem::touch`, :method:`Symfony\\Component\\Filesystem\\Filesystem::remove`, :method:`Symfony\\Component\\Filesystem\\Filesystem::chmod`, :method:`Symfony\\Component\\Filesystem\\Filesystem::chown` y :method:`Symfony\\Component\\Filesystem\\Filesystem::chgrp` pueden recibir una cadena, un arreglo o cualquier objeto que implemente :phpclass:`Traversable` como el argumento ``destino``. - - -``Mkdir`` -~~~~~~~~~ - -``Mkdir`` crea directorios. En sistemas de archivos *POSIX*, de manera predeterminada los directorios se crean con un valor de `0777` para el modo. Puedes utilizar el segundo argumento para establecer tu propio modo:: - - $fs->mkdir('/tmp/photos', 0700); - -.. note:: - - Puedes pasar como primer argumento un arreglo o cualquier otro objeto :phpclass:`Traversable`. - -``Exists`` -~~~~~~~~~~ - -``Exists`` comprueba la presencia de todos los archivos o directorios y devuelve ``false`` si falta un archivo:: - - // este directorio existe, devuelve true - $fs->exists('/tmp/photos'); - - // rabbit.jpg existe, bottle.png no existe, devuelve false - $fs->exists(array('rabbit.jpg', 'bottle.png')); - -.. note:: - - Puedes pasar como primer argumento un arreglo o cualquier otro objeto :phpclass:`Traversable`. - -``Copy`` -~~~~~~~~ - -Este método se utiliza para copiar archivos. If the target already exists, the file is -copied only if the source modification date is later than the target. Puedes redefinir este comportamiento con el tercer argumento booleano:: - - // sólo funciona si image-ICC.jpg se modificó después de image.jpg - $fs->copy('image-ICC.jpg', 'image.jpg'); - - // image.jpg será reemplazada - $fs->copy('image-ICC.jpg', 'image.jpg', true); - -``Touch`` -~~~~~~~~~ - -``Touch`` establece el acceso y la hora de modificación de un archivo. De manera predeterminada utiliza la hora actual. Puedes configurar la tuya con el segundo argumento. El tercer argumento es la hora de acceso:: - - // establece la hora de modificación a la fecha y hora actual - $fs->touch('file.txt'); - // establece la hora de modificación 10 segundos en el futuro - $fs->touch('file.txt', time() + 10); - // establece la hora de acceso 10 segundos en el pasado - $fs->touch('file.txt', time(), time() - 10); - -.. note:: - - Puedes pasar como primer argumento un arreglo o cualquier otro objeto :phpclass:`Traversable`. - -``Chown`` -~~~~~~~~~ - -Utiliza ``chown`` para cambiar el propietario de un archivo. El tercer argumento es una opción booleana recursiva:: - - // establece el propietario del video lolcat a www-data - $fs->chown('lolcat.mp4', 'www-data'); - // cambia recursivamente el propietario del directorio video - $fs->chown('/video', 'www-data', true); - -.. note:: - - Puedes pasar como primer argumento un arreglo o cualquier otro objeto :phpclass:`Traversable`. - -``Chgrp`` -~~~~~~~~~ - -Utiliza ``chgrp`` para cambiar el grupo de un archivo. El tercer argumento es una opción booleana recursiva:: - - // establecer el grupo del vídeo lolcat a nginx - $fs->chgrp('lolcat.mp4', 'nginx'); - // cambia recursivamente el grupo del directorio video - $fs->chgrp('/video', 'nginx', true); - - -.. note:: - - Puedes pasar como primer argumento un arreglo o cualquier otro objeto :phpclass:`Traversable`. - -``Chmod`` -~~~~~~~~~ - -``Chmod`` se utiliza para cambiar el modo de un archivo. The fourth argument is a boolean -recursive option:: - - // establece el modo de vídeo a 0600 - $fs->chmod('video.ogg', 0600); - // cambia recursivamente el modo del directorio src - $fs->chmod('src', 0700, 0000, true); - -.. note:: - - Puedes pasar como primer argumento un arreglo o cualquier otro objeto :phpclass:`Traversable`. - -``Remove`` -~~~~~~~~~~ - -``Remove`` te permite eliminar fácilmente archivos, enlaces simbólicos y directorios:: - - $fs->remove(array('symlink', '/ruta/al/directorio', 'activity.log')); - -.. note:: - - Puedes pasar como primer argumento un arreglo o cualquier otro objeto :phpclass:`Traversable`. - -``Rename`` -~~~~~~~~~~ - -Utiliza ``rename`` para cambiar el nombre de archivos y directorios:: - - // renombra un archivo - $fs->rename('/tmp/processed_video.ogg', '/ruta/a/tienda/video_647.ogg'); - // renombra un directorio - $fs->rename('/tmp/files', '/ruta/a/tienda/files'); - -``symlink`` -~~~~~~~~~~~ - -Crea un enlace simbólico desde fuente hasta destino. Si el sistema de archivos no es compatible con los enlaces simbólicos, hay disponible un tercer argumento booleano:: - - // crea un enlace simbólico - $fs->symlink('/ruta/a/source', '/ruta/a/destination'); - // duplica el directorio fuente, si el sistema de archivos no - // es compatible con enlaces simbólicos - $fs->symlink('/ruta/a/source', '/ruta/a/destination', true); - -``makePathRelative`` -~~~~~~~~~~~~~~~~~~~~ - -Devuelve la ruta relativa de un directorio dado:: - - // devuelve '../' - $fs->makePathRelative( - '/var/lib/symfony/src/Symfony/', - '/var/lib/symfony/src/Symfony/Component' - ); - // devuelve 'videos' - $fs->makePathRelative('/tmp', '/tmp/videos'); - -``mirror`` -~~~~~~~~~~ - -Refleja un directorio:: - - $fs->mirror('/ruta/a/source', '/ruta/a/target'); - -``isAbsolutePath`` -~~~~~~~~~~~~~~~~~~ - -``isAbsolutePath`` devuelve ``true`` si la ruta especificada es absoluta, ``false`` en caso contrario:: - - // devuelve true - $fs->isAbsolutePath('/tmp'); - // devuelve true - $fs->isAbsolutePath('c:\\Windows'); - // devuelve false - $fs->isAbsolutePath('tmp'); - // devuelve false - $fs->isAbsolutePath('../dir'); - -Manejando errores ------------------ - -Cuando sucede algo malo, se lanza una excepción que implementa la clase -:class:`Symfony\\Component\\Filesystem\\Exception\\ExceptionInterface`. - -.. note:: - - Antes de la versión 2.1, :method:`Symfony\\Component\\Filesystem\\Filesystem::mkdir` devolvía un valor lógico y no lanzaba excepciones. A partir de 2.1, se lanza una :class:`Symfony\\Component\\Filesystem\\Exception\\IOException` si falla la creación del directorio. - -.. _`Packagist`: https://packagist.org/packages/symfony/filesystem diff --git a/_sources/components/finder.txt b/_sources/components/finder.txt deleted file mode 100644 index bb6237b..0000000 --- a/_sources/components/finder.txt +++ /dev/null @@ -1,284 +0,0 @@ -.. index:: - single: Finder - single: Componentes; Finder - -El componente ``Finder`` -======================== - - El componente ``Finder`` busca archivos y directorios a través de una sencilla e intuitiva interfaz. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Finder); -* :doc:`Instalándolo vía Composer ` (``symfony/finder`` en `Packagist`_). - -Usando ------- - -La clase :class:`Symfony\\Component\\Finder\\Finder` busca archivos y/o -directorios:: - - use Symfony\Component\Finder\Finder; - - $finder = new Finder(); - $finder->files()->in(__DIR__); - - foreach ($finder as $file) { - // Imprime la ruta absoluta - print $file->getRealpath()."\n"; - - // Imprime la ruta relativa al archivo, omitiendo el nombre de archivo - print $file->getRelativePath()."\n"; - - // Imprime la ruta relativa para el archivo - print $file->getRelativePathname()."\n"; - } - -``$file`` es una instancia de :class:`Symfony\\Component\\Finder\\SplFileInfo` la cual extiende a :phpclass:`SplFileInfo` para proporcionar métodos para trabajar con rutas relativas. - -El código anterior imprime recursivamente los nombres de todos los archivos en el directorio actual. La clase ``Finder`` utiliza una interfaz fluida, por lo que todos los métodos devuelven la instancia del ``Finder``. - -.. tip:: - - Una instancia del ``Finder`` es un :phpclass:`Iterator` de *PHP*. Por lo tanto, en lugar de iterar sobre el ``Finder`` con ``foreach``, también lo puedes convertir en un arreglo con el método :phpfunction:`iterator_to_array` u obtener el número de elementos con :phpfunction:`iterator_count`. - -.. caution:: - - Al buscar a través de múltiples ubicaciones pasadas al método :method:`Symfony\\Component\\Finder\\Finder::in`, internamente se crea un iterador independiente por cada ubicación. Esto significa que tienes múltiples resultados agregados a uno. - Debido a que :phpfunction:`iterator_to_array` de manera predefinida usa el conjunto de claves del resultado, al convertirlo en arreglo, algunas claves se podrían duplicar y por lo tanto sustituir sus valores. Esto se puede evitar pasando ``false`` como segundo argumento a :phpfunction:`iterator_to_array`. - -Criterios ---------- - -Hay muchas maneras de filtrar y ordenar tu resultado. - -Ubicación -~~~~~~~~~ - -La ubicación es el único criterio obligatorio. Este dice al buscador cual directorio utilizar para la búsqueda:: - - $finder->in(__DIR__); - -Busca en varios lugares encadenando llamadas al método :method:`Symfony\\Component\\Finder\\Finder::in`:: - - $finder->files()->in(__DIR__)->in('/elsewhere'); - -.. versionadded:: 2.2 - El soporte necesario para el comodín se añadió en la versión 2.2. - -Usa caracteres comodín para buscar en los directorios que emparejen un patrón:: - - $finder->in('src/Symfony/*/*/Resources'); - -Cada patrón tiene que resolver cuando menos con una ruta de directorio. - -Excluye directorios coincidentes con el método :method:`Symfony\\Component\\Finder\\Finder::exclude`:: - - $finder->in(__DIR__)->exclude('ruby'); - -Debido a que ``Finder`` utiliza iteradores *PHP*, puedes pasar cualquier *URL* con un `protocolo`_ compatible:: - - $finder->in('ftp://ejemplo.com/pub/'); - -Y también trabaja con flujos definidos por el usuario:: - - use Symfony\Component\Finder\Finder; - - $s3 = new \Zend_Service_Amazon_S3($key, $secret); - $s3->registerStreamWrapper("s3"); - - $finder = new Finder(); - $finder->name('photos*')->size('< 100K')->date('since 1 hour ago'); - foreach ($finder->in('s3://bucket-name') as $file) { - // ... hace algo - - print $file->getFilename()."\n"; - } - -.. note:: - - Lee la documentación de `Flujos`_ para aprender a crear tus propios flujos. - -Archivos o directorios -~~~~~~~~~~~~~~~~~~~~~~ - -De manera predeterminada, ``Finder`` devuelve archivos y directorios; Pero los métodos :method:`Symfony\\Component\\Finder\\Finder::files` y -:method:`Symfony\\Component\\Finder\\Finder::directories` controlan:: - - $finder->files(); - - $finder->directories(); - -Si quieres seguir los enlaces, utiliza el método ``followLinks()``:: - - $finder->files()->followLinks(); - -De forma predeterminada, el iterador ignora archivos VCS populares. Esto se puede cambiar con el método ``ignoreVCS()``:: - - $finder->ignoreVCS(false); - -Ordenación -~~~~~~~~~~ - -Ordena el resultado por nombre o por tipo (primero directorios, luego archivos):: - - $finder->sortByName(); - - $finder->sortByType(); - -.. note:: - - Ten en cuenta que los métodos ``sort*`` necesitan obtener todos los elementos para hacer su trabajo. Para iteradores grandes, es lento. - -También puedes definir tu propio algoritmo de ordenación con el método ``sort()``:: - - $sort = function (\SplFileInfo $a, \SplFileInfo $b) - { - return strcmp($a->getRealpath(), $b->getRealpath()); - }; - - $finder->sort($sort); - -Nombre de archivo -~~~~~~~~~~~~~~~~~ - -Filtra archivos por nombre con el método :method:`Symfony\\Component\\Finder\\Finder::name`:: - - $finder->files()->name('*.php'); - -El método ``name()`` acepta globos, cadenas o expresiones regulares:: - - $finder->files()->name('/\.php$/'); - -El método ``notName()`` excluye archivos coincidentes con un patrón:: - - $finder->files()->notName('*.rb'); - -Contenido del archivo -~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - Los métodos ``contains()`` y ``notContains()`` se añadieron en la versión 2.1 - -Restringiendo el contenido de archivos con el método :method:`Symfony\\Component\\Finder\\Finder::contains`:: - - $finder->files()->contains('lorem ipsum'); - -El método ``contains()`` acepta cadenas o expresiones regulares:: - - $finder->files()->contains('/lorem\s+ipsum$/i'); - -El método ``notContains()`` excluye archivos que contienen un determinado patrón:: - - $finder->files()->notContains('dolor sit amet'); - -``path`` -~~~~~~~~ - -.. versionadded:: 2.2 - Los métodos ``path()`` y ``notPath()`` se añadieron en la versión 2.2. - -Restringe archivos y directorios por ruta con el -método :method:`Symfony\\Component\\Finder\\Finder::path`:: - - $finder->path('some/special/dir'); - -En todos los ambientes se debería usar la barra inclinada (es decir, ``/``) como separador de directorio. - -El el método ``path()`` acepta una cadena o una expresión regular:: - - $finder->path('foo/bar'); - $finder->path('/^foo\/bar/'); - -Internamente, las cadenas se convierten a expresiones regulares escapando las barras invertidas y añadiendo delimitadores: - -.. code-block:: text - - dirname ===> /dirname/ - a/b/c ===> /a\/b\/c/ - -El método :method:`Symfony\\Component\\Finder\\Finder::notPath` excluye archivos por ruta:: - - $finder->notPath('otro/dir'); - -Tamaño de archivo -~~~~~~~~~~~~~~~~~ - -Filtra archivos por tamaño con el método :method:`Symfony\\Component\\Finder\\Finder::size`:: - - $finder->files()->size('< 1.5K'); - -Filtra por rangos de tamaño encadenando llamadas a:: - - $finder->files()->size('>= 1K')->size('<= 2K'); - -El operador de comparación puede ser cualquiera de los siguientes: ``>``, ``>=``, ``<``, ``<=``, -``==``, ``!=``. - -.. versionadded:: 2.1 - El operador ``!=`` se añadió en la versión 2.1. - -El valor destino puede utilizar magnitudes de *kilobytes* (``k``, ``ki``), *megabytes* (``m``, ``mi``), o *gigabytes* (``g``, ``gi``). Los sufijos con una ``i`` usan la versión ``2**n`` adecuada de acuerdo al `estándar IEC`_. - -Fecha de archivo -~~~~~~~~~~~~~~~~ - -Filtra archivos por fecha de última modificación con el método :method:`Symfony\\Component\\Finder\\Finder::date`:: - - $finder->date('since yesterday'); - -El operador de comparación puede ser cualquiera de los siguientes: ``>``, ``>=``, ``<``, ``<=``, -``==``. También puedes utilizar ``since`` o ``after`` como alias para ``>``, y ``until`` o ``before`` como alias para ``<``. - -El valor destino puede ser cualquier fecha compatible con la función `strtotime`_. - -Profundidad de directorio -~~~~~~~~~~~~~~~~~~~~~~~~~ - -De manera predeterminada, ``Finder`` recorre directorios recurrentemente. Filtra la profundidad del recorrido con el método :method:`Symfony\\Component\\Finder\\Finder::depth`:: - - $finder->depth('== 0'); - $finder->depth('< 3'); - -Filtrado personalizado -~~~~~~~~~~~~~~~~~~~~~~ - -Para restringir que el archivo coincida con su propia estrategia, utiliza el método :method:`Symfony\\Component\\Finder\\Finder::filter`:: - - $filter = function (\SplFileInfo $file) - { - if (strlen($file) > 10) { - return false; - } - }; - - $finder->files()->filter($filtro); - -El método ``filter()`` toma un cierre como argumento. Por cada archivo coincidente, este es invocado con el archivo como una instancia de :class:`Symfony\\Component\\Finder\\SplFileInfo`. El archivo se excluye del conjunto de resultados si el cierre devuelve ``false``. - -Leyendo el contenido de los archivos devueltos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El método ``getContents()`` se introdujo en la versión 2.1. - -El contenido devuelto de los archivos se puede leer con el método :method:`Symfony\\Component\\Finder\\SplFileInfo::getContents`:: - - use Symfony\Component\Finder\Finder; - - $finder = new Finder(); - $finder->files()->in(__DIR__); - - foreach ($finder as $file) { - $contents = $file->getContents(); - ... - } - -.. _`strtotime`: http://www.php.net/manual/es/datetime.formats.php -.. _`protocolo`: http://www.php.net/manual/es/wrappers.php -.. _`Flujos`: http://www.php.net/streams -.. _`estándar IEC`: http://physics.nist.gov/cuu/Units/binary.html -.. _`Packagist`: https://packagist.org/packages/symfony/finder diff --git a/_sources/components/http_foundation.txt b/_sources/components/http_foundation.txt deleted file mode 100644 index 03c2e3c..0000000 --- a/_sources/components/http_foundation.txt +++ /dev/null @@ -1,314 +0,0 @@ -.. index:: - single: HTTP - single: HttpFoundation - -El componente ``HttpFoundation`` -================================ - - El componente ``HttpFoundation`` define una capa orientada a objetos para la especificación *HTTP*. - -En *PHP*, la petición está representada por algunas variables globales (``$_GET``, ``$_POST``, ``$_FILE``, ``$_COOKIE``, ``$_SESSION``...) y la respuesta es generada por algunas funciones (``echo``, ``header``, ``setcookie``, ...). - -El componente *HttpFoundation* de *Symfony2* sustituye estas variables globales y funciones de *PHP* por una capa orientada a objetos. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/HttpFoundation); -* Instalándolo a través de *PEAR* (`pear.symfony.com/HttpFoundation`); -* Instalándolo vía ``Composer`` (`symfony/http-foundation` en Packagist). - -Petición --------- - -La manera más común para crear una petición es basándose en las variables globales de *PHP* con -:method:`Symfony\\Component\\HttpFoundation\\Request::createFromGlobals`:: - - use Symfony\Component\HttpFoundation\Request; - - $request = Request::createFromGlobals(); - -que es casi equivalente a la más prolija, pero también más flexible, llamada a -:method:`Symfony\\Component\\HttpFoundation\\Request::__construct`:: - - $request = new Request($_GET, $_POST, array(), $_COOKIE, $_FILES, $_SERVER); - -Accediendo a datos de la ``Petición`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Un objeto ``Petición`` contiene información sobre la petición del cliente. Puedes acceder a esta información a través de muchas propiedades públicas: - -* ``request``: equivalente de ``$_POST``; - -* ``query``: equivalente de ``$_GET`` (``$request->query->get('name')``); - -* ``cookies``: equivalente de ``$_COOKIE``; - -* ``attributes``: sin equivalente --- utilizado por tu aplicación para almacenar otros datos (ve :ref:`más adelante `) - -* ``files``: equivalente de ``$_FILE``; - -* ``server``: equivalente de ``$_SERVER``; - -* ``headers``: en su mayoría equivalente a un subconjunto de ``$_SERVER`` (``$request->headers->get('Content-Type')``). - -Cada propiedad es una instancia de :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` (o una subclase), que es una clase que contiene datos: - -* ``request``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``query``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``cookies``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``attributes``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``files``: :class:`Symfony\\Component\\HttpFoundation\\FileBag`; - -* ``server``: :class:`Symfony\\Component\\HttpFoundation\\ServerBag`; - -* ``headers``: :class:`Symfony\\Component\\HttpFoundation\\HeaderBag`. - -Todas las instancias de la clase :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` tienen métodos para recuperar y actualizar sus datos: - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::all`: Devuelve los parámetros; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::keys`: Devuelve las claves de los parámetros; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::replace`: - Sustituye los parámetros actuales por un nuevo conjunto; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::add`: Añade parámetros; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::get`: Devuelve un parámetro por nombre; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::set`: Establece un parámetro por nombre; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::has`: Devuelve ``true`` si el parámetro está definido; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::remove`: Elimina un parámetro. - -La instancia de :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` también tiene algunos métodos para filtrar los valores introducidos: - -* :method:`Symfony\\Component\\HttpFoundation\\Request::getAlpha`: Devuelve los caracteres alfanuméricos del valor del parámetro; - -* :method:`Symfony\\Component\\HttpFoundation\\Request::getAlnum`: Devuelve los caracteres alfanuméricos y dígitos del valor del parámetro; - -* :method:`Symfony\\Component\\HttpFoundation\\Request::getDigits`: Devuelve los dígitos del valor del parámetro; - -* :method:`Symfony\\Component\\HttpFoundation\\Request::getInt`: Devuelve el valor del parámetro convertido a entero; - -* :method:`Symfony\\Component\\HttpFoundation\\Request::filter`: Filtra el parámetro usando la función ``filter_var()`` de *PHP*. - -Todos los captadores toman hasta tres argumentos: el primero es el nombre del parámetro y el segundo es el valor predeterminado a devolver si el parámetro no existe:: - - // La cadena de consulta es '?foo=bar' - - $request->query->get('foo'); - // devuelve bar - - $request->query->get('bar'); - // devuelve null - - $request->query->get('bar', 'bar'); - // devuelve 'bar' - - -Cuando *PHP* importa la consulta de la petición, manipula los parámetros de la petición como -``foo[bar]=bar`` de una manera especial, ya que crea una matriz. Para que puedas obtener el parámetro ``foo`` y devolver una matriz con un elemento ``bar``. pero a veces, posiblemente quieras obtener el valor por medio del nombre "original" del parámetro: -``foo[bar]``. Esto es posible con todos los captadores de ``ParameterBag`` como -:method:`Symfony\\Component\\HttpFoundation\\Request::get` a través del tercer argumento:: - - // la cadena de consulta es '?foo[bar]=bar' - - $request->query->get('foo'); - // devuelve array('bar' => 'bar') - - $request->query->get('foo[bar]'); - // devuelve null - - $request->query->get('foo[bar]', null, true); - // devuelve 'bar' - -.. _component-foundation-attributes: - -Por último, pero no menos importante, también puedes almacenar más datos en la petición, gracias a la propiedad pública ``attributes``, que también es una instancia de :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`. Casi siempre se usa para adjuntar información que pertenece a la ``Petición`` y que necesitas acceder desde diferentes puntos de tu aplicación. Para información sobre cómo se utiliza en la plataforma *Symfony2*, consulta la :ref:`propiedad pública attributes `. - -Identificando una ``Petición`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En tu aplicación, necesitas una manera de identificar una petición; la mayor parte del tiempo, esto se hace a través de la "información de ruta" de la petición, a la que puedes acceder a través del método :method:`Symfony\\Component\\HttpFoundation\\Request::getPathInfo`:: - - // Para una petición a http://example.com/blog/index.php/post/hello-world - // la información de ruta es "/post/hello-world" - $request->getPathInfo(); - -Simulando una ``Petición`` -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En lugar de crear una petición basada en las variables globales de *PHP*, también puedes simular -una ``Petición``:: - - $request = Request::create('/hello-world', 'GET', array('name' => 'Fabien')); - -El método :method:`Symfony\\Component\\HttpFoundation\\Request::create` crea una petición basándose en la información de una ruta, un método y algunos parámetros (los parámetros de consulta o los de la petición en función del método *HTTP*); y, por supuesto, también puedes sustituir todas las otras variables (de manera predeterminada, *Symfony* crea parámetros predeterminados apropiados para todas las variables globales de *PHP*). - -En base a dicha petición, puedes sustituir las variables globales de *PHP* a través de :method:`Symfony\\Component\\HttpFoundation\\Request::overrideGlobals`:: - - $request->overrideGlobals(); - -.. tip:: - - También puedes duplicar una consulta existente a través del método :method:`Symfony\\Component\\HttpFoundation\\Request::duplicate` o cambiar un montón de parámetros con una sola llamada a :method:`Symfony\\Component\\HttpFoundation\\Request::initialize`. - -Accediendo a la ``Sesión`` -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si tienes una sesión adjunta a la ``Petición``, puedes acceder a ella a través del método :method:`Symfony\\Component\\HttpFoundation\\Request::getSession`; -el método :method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession` te dice si la petición contiene una sesión que se inició en una de las peticiones anteriores. - -Accediendo a otros datos -~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase ``Petición`` tiene muchos otros métodos que puedes utilizar para acceder a la información de la petición. Echa un vistazo a la *API* para más información sobre ellos. - -``Respuesta`` -------------- - -Un objeto :class:`Symfony\\Component\\HttpFoundation\\Response` contiene toda la información que debes enviar de vuelta al cliente desde una determinada ``Petición``. El constructor toma hasta tres argumentos: el contenido de la respuesta, el código de estado, y una serie de cabeceras *HTTP*:: - - - use Symfony\Component\HttpFoundation\Response; - - $response = new Response('Content', - 200, - array('content-type' => 'text/html') - ); - -También puedes manipular esta información después de haber creado la ``Respuesta``:: - - $response->setContent('Hello World'); - - // el atributo público headers es un ResponseHeaderBag - $response->headers->set('Content-Type', 'text/plain'); - - $response->setStatusCode(404); - -Al establecer el ``Content-Type`` de la respuesta, puedes configurar el juego de caracteres, pero es mejor configurarlo a través del método :method:`Symfony\\Component\\HttpFoundation\\Response::setCharset`:: - - $response->setCharset('ISO-8859-1'); - -Ten en cuenta que de manera predeterminada, *Symfony* asume que sus respuestas están codificadas en -*UTF-8*. - -Enviando la ``Respuesta`` -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de enviar la respuesta, te puedes asegurar de que es compatible con la especificación del protocolo *HTTP* llamando al método :method:`Symfony\\Component\\HttpFoundation\\Response::prepare`:: - - $response->prepare($request); - -Enviar la respuesta entonces es tan sencillo cómo invocar al método :method:`Symfony\\Component\\HttpFoundation\\Response::send`:: - - $response->send(); - -Enviando ``Cookies`` -~~~~~~~~~~~~~~~~~~~~ - -Puedes manipular las ``cookies`` de la respuesta por medio del atributo público ``headers``:: - - use Symfony\Component\HttpFoundation\Cookie; - - $response->headers->setCookie(new Cookie('foo', 'bar')); - -El método :method:`Symfony\\Component\\HttpFoundation\\ResponseHeaderBag::setCookie` toma como argumento una instancia de :class:`Symfony\\Component\\HttpFoundation\\Cookie`. - -Puedes borrar una :dfn:`cookie` a través del método :method:`Symfony\\Component\\HttpFoundation\\Response::clearCookie`. - -Gestionando la caché *HTTP* -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\HttpFoundation\\Response` tiene un rico conjunto de métodos para manipular las cabeceras *HTTP* relacionadas con la memoria caché: - -* :method:`Symfony\\Component\\HttpFoundation\\Response::setPublic`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setPrivate`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::expire`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setExpires`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setMaxAge`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setSharedMaxAge`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setTtl`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setClientTtl`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setLastModified`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setVary`; - -Puedes utilizar el método :method:`Symfony\\Component\\HttpFoundation\\Response::setCache` para establecer la información de caché utilizada comúnmente en una llamada al método:: - - $response->setCache(array( - 'etag' => 'abcdef', - 'last_modified' => new \DateTime(), - 'max_age' => 600, - 's_maxage' => 600, - 'private' => false, - 'public' => true, - )); - -Para comprobar si los validadores de la ``Respuesta`` (``ETag``, ``Last-Modified``) coinciden con un valor condicional especificado en la petición del cliente, utiliza el método :method:`Symfony\\Component\\HttpFoundation\\Response::isNotModified`:: - - if ($response->isNotModified($request)) { - $response->send(); - } - -Si la respuesta no se ha modificado, se establece el código de estado a 304 y elimina el contenido real de la respuesta. - -Redirigiendo al usuario -~~~~~~~~~~~~~~~~~~~~~~~ - -Para redirigir al cliente a otra *URL*, puedes utilizar la clase :class:`Symfony\\Component\\HttpFoundation\\RedirectResponse`:: - - use Symfony\Component\HttpFoundation\RedirectResponse; - - $response = new RedirectResponse('http://ejemplo.com/'); - -Transmitiendo una ``Respuesta`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - La compatibilidad a la transmisión de respuestas se añadió en *Symfony 2.1*. - -La clase :class:`Symfony\\Component\\HttpFoundation\\StreamedResponse` te permite transmitir la respuesta de vuelta al cliente. El contenido de la respuesta está representado por una función *PHP* ejecutable en lugar de una cadena:: - - use Symfony\Component\HttpFoundation\StreamedResponse; - - $response = new StreamedResponse(); - $response->setCallback(function () { - echo 'Hello World'; - flush(); - sleep(2); - echo 'Hello World'; - flush(); - }); - $response->send(); - -Descargando archivos -~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El método ``makeDisposition`` fue añadido en *Symfony 2.1*. - -Al cargar un archivo, debes agregar una cabecera ``Content-Disposition`` a tu respuesta. Es fácil crear esta cabecera básica para descargar archivos, utilizando nombres de archivo -no *ASCII* más envolventes. El método :method:`:Symfony\\Component\\HttpFoundation\\Response:makeDisposition` abstrae el trabajo duro detrás de una sencilla *API*: - -.. code-block:: php - - use Symfony\Component\HttpFoundation\ResponseHeaderBag; - - $d = $response->headers->makeDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, 'foo.pdf'); - - $response->headers->set('Content-Disposition', $d); - -``Session`` ------------ - -TBD --- De esta parte no se ha escrito nada, ya que probablemente será reconstruida próximamente en *Symfony 2.1*. diff --git a/_sources/components/http_foundation/index.txt b/_sources/components/http_foundation/index.txt deleted file mode 100644 index 45fcd96..0000000 --- a/_sources/components/http_foundation/index.txt +++ /dev/null @@ -1,11 +0,0 @@ -Fundamento *HTTP* -================= - -.. toctree:: - :maxdepth: 2 - - introduction - sessions - session_configuration - session_testing - trusting_proxies diff --git a/_sources/components/http_foundation/introduction.txt b/_sources/components/http_foundation/introduction.txt deleted file mode 100644 index 29ba376..0000000 --- a/_sources/components/http_foundation/introduction.txt +++ /dev/null @@ -1,439 +0,0 @@ -.. index:: - single: HTTP - single: HttpFoundation - single: Componentes; HttpFoundation - -El componente ``HttpFoundation`` -================================ - - El componente ``HttpFoundation`` define una capa orientada a objetos para la especificación *HTTP*. - -En *PHP*, la petición está representada por algunas variables globales (``$_GET``, ``$_POST``, ``$_FILE``, ``$_COOKIE``, ``$_SESSION``, ...) y la respuesta es generada por algunas funciones (``echo``, ``header``, ``setcookie``, ...). - -El componente *HttpFoundation* de *Symfony2* sustituye estas variables globales y funciones predefinidas en *PHP* por una capa orientada a objetos. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/HttpFoundation); -* :doc:`Instalándolo vía Composer ` (``symfony/http-foundation`` en `Packagist`_). - -Petición --------- - -La manera más común para crear una petición es basándose en las variables globales de *PHP* con -:method:`Symfony\\Component\\HttpFoundation\\Request::createFromGlobals`:: - - use Symfony\Component\HttpFoundation\Request; - - $request = Request::createFromGlobals(); - -que es casi equivalente a la más prolija, pero también más flexible, llamada al método :method:`Symfony\\Component\\HttpFoundation\\Request::__construct`:: - - $request = new Request( - $_GET, - $_POST, - array(), - $_COOKIE, - $_FILES, - $_SERVER - ); - -Accediendo a datos de la ``Petición`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Un objeto ``Petición`` contiene información sobre la petición del cliente. Puedes acceder a esta información a través de muchas propiedades públicas: - -* ``request``: equivalente de ``$_POST``; - -* ``query``: equivalente de ``$_GET`` (``$request->query->get('name')``); - -* ``cookies``: equivalente de ``$_COOKIE``; - -* ``attributes``: sin equivalente --- utilizado por tu aplicación para almacenar otros datos (ve :ref:`más adelante `) - -* ``files``: equivalente de ``$_FILE``; - -* ``server``: equivalente de ``$_SERVER``; - -* ``headers``: en su mayoría equivalente a un subconjunto de ``$_SERVER`` (``$request->headers->get('Content-Type')``). - -Cada propiedad es una instancia de :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` (o una subclase), que es una clase que contiene datos: - -* ``request``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``query``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``cookies``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``attributes``: :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`; - -* ``files``: :class:`Symfony\\Component\\HttpFoundation\\FileBag`; - -* ``server``: :class:`Symfony\\Component\\HttpFoundation\\ServerBag`; - -* ``headers``: :class:`Symfony\\Component\\HttpFoundation\\HeaderBag`. - -Todas las instancias de la clase :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` tienen métodos para recuperar y actualizar sus datos: - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::all`: Devuelve los parámetros; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::keys`: Devuelve las claves de los parámetros; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::replace`: - Sustituye los parámetros actuales por un nuevo conjunto; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::add`: Añade parámetros; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::get`: Devuelve un parámetro por nombre; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::set`: Establece un parámetro por nombre; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::has`: Devuelve ``true`` si el parámetro está definido; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::remove`: Elimina un parámetro. - -La instancia de :class:`Symfony\\Component\\HttpFoundation\\ParameterBag` también tiene algunos métodos para filtrar los valores introducidos: - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getAlpha`: Devuelve los caracteres alfanuméricos del valor del parámetro; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getAlnum`: Devuelve los caracteres alfanuméricos y dígitos del valor del parámetro; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getDigits`: Devuelve los dígitos del valor del parámetro; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::getInt`: Devuelve el valor del parámetro convertido a entero; - -* :method:`Symfony\\Component\\HttpFoundation\\ParameterBag::filter`: Filtra el parámetro usando la función ``filter_var()`` de *PHP*. - -Todos los captadores toman hasta tres argumentos: el primero es el nombre del parámetro y el segundo es el valor predeterminado a devolver si el parámetro no existe:: - - // La cadena de consulta es '?foo=bar' - - $request->query->get('foo'); - // devuelve bar - - $request->query->get('bar'); - // devuelve null - - $request->query->get('bar', 'bar'); - // devuelve 'bar' - - -Cuando *PHP* importa la consulta de la petición, manipula los parámetros de la petición como -``foo[bar]=bar`` de una manera especial, ya que crea un arreglo. Para que puedas obtener el parámetro ``foo`` y devolver un arreglo con un elemento ``bar``. pero a veces, posiblemente quieras obtener el valor por medio del nombre «original» del parámetro: -``foo[bar]``. Esto es posible con todos los captadores de ``ParameterBag`` como -:method:`Symfony\\Component\\HttpFoundation\\Request::get` a través del tercer argumento:: - - // la cadena de consulta es '?foo[bar]=bar' - - $request->query->get('foo'); - // devuelve array('bar' => 'bar') - - $request->query->get('foo[bar]'); - // devuelve null - - $request->query->get('foo[bar]', null, true); - // devuelve 'bar' - -.. _component-foundation-attributes: - -Por último, pero no menos importante, también puedes almacenar datos adicionales en la petición, gracias a la propiedad pública ``attributes``, que también es una instancia de la clase :class:`Symfony\\Component\\HttpFoundation\\ParameterBag`. Casi siempre se usa para adjuntar información que pertenece a la ``Petición`` y que necesitas acceder desde diferentes puntos de tu aplicación. Para información sobre cómo se utiliza en la plataforma *Symfony2*, consulta la :ref:`propiedad pública attributes `. - -Identificando una ``Petición`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En tu aplicación, necesitas una manera de identificar una petición; la mayor parte del tiempo, esto se hace a través de la «información de ruta» de la petición, a la que puedes acceder a través del método :method:`Symfony\\Component\\HttpFoundation\\Request::getPathInfo`:: - - // Para una petición a http://example.com/blog/index.php/post/hello-world - // la información de ruta es "/post/hello-world" - $request->getPathInfo(); - -Simulando una ``Petición`` -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En lugar de crear una petición basada en las variables globales de *PHP*, también puedes simular -una ``Petición``:: - - $request = Request::create( - '/hello-world', - 'GET', - array('name' => 'Fabien') - ); - -El método :method:`Symfony\\Component\\HttpFoundation\\Request::create` crea una petición basándose en la información de una ruta, un método y algunos parámetros (los parámetros de consulta o los de la petición en función del método *HTTP*); and of -course, you can also override all other variables as well (by default, Symfony -creates sensible defaults for all the PHP global variables). - -En base a dicha petición, puedes sustituir las variables globales de *PHP* a través de :method:`Symfony\\Component\\HttpFoundation\\Request::overrideGlobals`:: - - $request->overrideGlobals(); - -.. tip:: - - También puedes duplicar una consulta existente a través del método :method:`Symfony\\Component\\HttpFoundation\\Request::duplicate` o cambiar un montón de parámetros con una sola llamada a :method:`Symfony\\Component\\HttpFoundation\\Request::initialize`. - -Accediendo a la ``Sesión`` -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si tienes una sesión adjunta a la ``Petición``, puedes acceder a ella a través del método :method:`Symfony\\Component\\HttpFoundation\\Request::getSession`; -el método :method:`Symfony\\Component\\HttpFoundation\\Request::hasPreviousSession` te dice si la petición contiene una sesión que se inició en una de las peticiones anteriores. - -Accediendo a los datos de cabeceras `Accept-*` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes acceder fácilmente a los dato básicos extraídos desde las cabeceras ``Accept-*`` utilizando los siguientes métodos: - -* :method:`Symfony\\Component\\HttpFoundation\\Request::getAcceptableContentTypes`: - devuelve la lista de tipos de contenido aceptados ordenados descendentemente por cualidad; - -* :method:`Symfony\\Component\\HttpFoundation\\Request::getLanguages`: - devuelve la lista de idiomas aceptados ordenados descendentemente por cualidad; - -* :method:`Symfony\\Component\\HttpFoundation\\Request::getCharsets`: - devuelve la lista de juegos de caracteres («charsets») aceptados ordenados descendentemente por cualidad; - -.. versionadded:: 2.2 - La clase :class:`Symfony\\Component\\HttpFoundation\\AcceptHeader` es nueva en *Symfony 2.2*. - -Si necesitas conseguir acceso completo a los datos analizados de ``Accept``, ``Accept-Language``, ``Accept-Charset`` o ``Accept-Encoding``, puedes usar la clase utilitaria :class:`Symfony\\Component\\HttpFoundation\\AcceptHeader`:: - - use Symfony\Component\HttpFoundation\AcceptHeader; - - $accept = AcceptHeader::fromString($request->headers->get('Accept')); - if ($accept->has('text/html')) { - $item = $accept->get('html'); - $charset = $item->getAttribute('charset', 'utf-8'); - $quality = $item->getQuality(); - } - - // acepta elementos que están ordenados descendentemente por cualidad - $accepts = AcceptHeader::fromString($request->headers->get('Accept'))->all(); - -Accediendo a otros datos -~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase ``Petición`` tiene muchos otros métodos que puedes utilizar para acceder a la información de la petición. Echa un vistazo a la *API* para más información sobre ellos. - -``Respuesta`` -------------- - -Un objeto :class:`Symfony\\Component\\HttpFoundation\\Response` contiene toda la información que debes enviar de vuelta al cliente desde una determinada ``Petición``. El constructor toma hasta tres argumentos: el contenido de la respuesta, el código de estado, y una serie de cabeceras *HTTP*:: - - - use Symfony\Component\HttpFoundation\Response; - - $response = new Response( - 'Content', - 200, - array('content-type' => 'text/html') - ); - -También puedes manipular esta información después de haber creado la ``Respuesta``:: - - $response->setContent('Hello World'); - - // el atributo público headers es un ResponseHeaderBag - $response->headers->set('Content-Type', 'text/plain'); - - $response->setStatusCode(404); - -Al establecer el ``Content-Type`` de la respuesta, puedes configurar el juego de caracteres, pero es mejor configurarlo a través del método :method:`Symfony\\Component\\HttpFoundation\\Response::setCharset`:: - - $response->setCharset('ISO-8859-1'); - -Ten en cuenta que de manera predeterminada, *Symfony* asume que sus respuestas están codificadas en -*UTF-8*. - -Enviando la ``Respuesta`` -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de enviar la respuesta, te puedes asegurar de que es compatible con la especificación del protocolo *HTTP* llamando al método :method:`Symfony\\Component\\HttpFoundation\\Response::prepare`:: - - $response->prepare($request); - -Enviar la respuesta entonces es tan sencillo cómo invocar al método :method:`Symfony\\Component\\HttpFoundation\\Response::send`:: - - $response->send(); - -Enviando ``Cookies`` -~~~~~~~~~~~~~~~~~~~~ - -Puedes manipular las ``cookies`` de la respuesta por medio del atributo público ``headers``:: - - use Symfony\Component\HttpFoundation\Cookie; - - $response->headers->setCookie(new Cookie('foo', 'bar')); - -El método :method:`Symfony\\Component\\HttpFoundation\\ResponseHeaderBag::setCookie` toma como argumento una instancia de :class:`Symfony\\Component\\HttpFoundation\\Cookie`. - -Puedes borrar una :dfn:`cookie` a través del método :method:`Symfony\\Component\\HttpFoundation\\ResponseHeaderBag::clearCookie`. - -Gestionando la caché *HTTP* -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\HttpFoundation\\Response` tiene un rico conjunto de métodos para manipular las cabeceras *HTTP* relacionadas con la memoria caché: - -* :method:`Symfony\\Component\\HttpFoundation\\Response::setPublic`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setPrivate`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::expire`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setExpires`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setMaxAge`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setSharedMaxAge`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setTtl`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setClientTtl`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setLastModified`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setEtag`; -* :method:`Symfony\\Component\\HttpFoundation\\Response::setVary`; - -Puedes utilizar el método :method:`Symfony\\Component\\HttpFoundation\\Response::setCache` para establecer la información de caché utilizada comúnmente en una llamada al método:: - - $response->setCache(array( - 'etag' => 'abcdef', - 'last_modified' => new \DateTime(), - 'max_age' => 600, - 's_maxage' => 600, - 'private' => false, - 'public' => true, - )); - -Para comprobar si los validadores de la ``Respuesta`` (``ETag``, ``Last-Modified``) coinciden con un valor condicional especificado en la petición del cliente, utiliza el método :method:`Symfony\\Component\\HttpFoundation\\Response::isNotModified`:: - - if ($response->isNotModified($request)) { - $response->send(); - } - -Si la respuesta no se ha modificado, se establece el código de estado a 304 y elimina el contenido real de la respuesta. - -Redirigiendo al usuario -~~~~~~~~~~~~~~~~~~~~~~~ - -Para redirigir al cliente a otra *URL*, puedes utilizar la clase :class:`Symfony\\Component\\HttpFoundation\\RedirectResponse`:: - - use Symfony\Component\HttpFoundation\RedirectResponse; - - $response = new RedirectResponse('http://ejemplo.com/'); - -Transmitiendo una ``Respuesta`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - La compatibilidad a la transmisión de respuestas se añadió en *Symfony 2.1*. - -La clase :class:`Symfony\\Component\\HttpFoundation\\StreamedResponse` te permite transmitir la respuesta de vuelta al cliente. El contenido de la respuesta está representado por una función *PHP* ejecutable en lugar de una cadena:: - - use Symfony\Component\HttpFoundation\StreamedResponse; - - $response = new StreamedResponse(); - $response->setCallback(function () { - echo 'Hello World'; - flush(); - sleep(2); - echo 'Hello World'; - flush(); - }); - $response->send(); - -.. note:: - - The ``flush()`` function does not flush buffering. If ``ob_start()`` has - been called before or the ``output_buffering`` php.ini option is enabled, - you must call ``ob_flush()`` before ``flush()``. - - Additionally, PHP isn't the only layer that can buffer output. Your web - server might also buffer based on its configuration. Even more, if you - use fastcgi, buffering can't be disabled at all. - -.. _component-http-foundation-serving-files: - -Serving Files -~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El método ``makeDisposition`` fue añadido en *Symfony 2.1*. - -When sending a file, you must add a ``Content-Disposition`` header to your -response. Es fácil crear esta cabecera básica para descargar archivos, utilizando nombres de archivo -no *ASCII* más envolventes. El método :method:`Symfony\\Component\\HttpFoundation\\Response::makeDisposition` abstrae el trabajo pesado detrás de una sencilla *API*:: - - use Symfony\Component\HttpFoundation\ResponseHeaderBag; - - $d = $response->headers->makeDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, 'foo.pdf'); - - $response->headers->set('Content-Disposition', $d); - -.. versionadded:: 2.2 - The :class:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse` - class was added in Symfony 2.2. - -Alternatively, if you are serving a static file, you can use a -:class:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse`:: - - use Symfony\Component\HttpFoundation\BinaryFileResponse - - $file = 'path/to/file.txt'; - $response = new BinaryFileResponse($file); - -The ``BinaryFileResponse`` will automatically handle ``Range`` and -``If-Range`` headers from the request. It also supports ``X-Sendfile`` -(see for `Nginx`_ and `Apache`_). To make use of it, you need to determine -whether or not the ``X-Sendfile-Type`` header should be trusted and call -:method:`Symfony\\Component\\HttpFoundation\\BinaryFileResponse::trustXSendfileTypeHeader` -if it should:: - - $response::trustXSendfileTypeHeader(); - -You can still set the ``Content-Type`` of the sent file, or change its ``Content-Disposition``:: - - $response->headers->set('Content-Type', 'text/plain') - $response->setContentDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, 'filename.txt'); - - -.. _component-http-foundation-json-response: - -Creando una respuesta *JSON* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Puedes crear cualquier tipo de respuesta vía la clase :class:`Symfony\\Component\\HttpFoundation\\Response` poniendo las cabeceras y contenido correctos. Una respuesta *JSON* podría tener la siguiente apariencia:: - - use Symfony\Component\HttpFoundation\Response; - - $response = new Response(); - $response->setContent(json_encode(array( - 'data' => 123, - ))); - $response->headers->set('Content-Type', 'application/json'); - -.. versionadded:: 2.1 - The :class:`Symfony\\Component\\HttpFoundation\\JsonResponse` - class was added in Symfony 2.1. - -Además, hay una muy útil clase :class:`Symfony\\Component\\HttpFoundation\\JsonResponse`, la cual incluso, puede hacer esto mucho más fácil:: - - use Symfony\Component\HttpFoundation\JsonResponse; - - $response = new JsonResponse(); - $response->setData(array( - 'data' => 123 - )); - -Esto codifica tu arreglo de datos a *JSON* y pone la cabecera ``Content-Type`` a ``application/json``. Si estás utilizando *JSONP*, puedes especifiar a cual función retrollamada se tendría que pasar el dato:: - - $response->setCallback('handleResponse'); - -En este caso, la cabecera ``Content-Type`` será ``text/javascript`` y el -contenido de respuesta tendrá esta apariencia: - -.. code-block:: javascript - - handleResponse({'data': 123}); - -``Session`` ------------ - -La información de la sesión está en su propio documento: :doc:`/components/http_foundation/sessions`. - -.. _`Packagist`: https://packagist.org/packages/symfony/http-foundation -.. _Nginx: http://wiki.nginx.org/XSendfile -.. _Apache: https://tn123.org/mod_xsendfile/ diff --git a/_sources/components/http_foundation/session_configuration.txt b/_sources/components/http_foundation/session_configuration.txt deleted file mode 100644 index aafc4de..0000000 --- a/_sources/components/http_foundation/session_configuration.txt +++ /dev/null @@ -1,179 +0,0 @@ -.. index:: - single: HTTP - single: HttpFoundation, Sesiones - -Configurando sesiones y controladores de guardado -================================================= - -Esta sección se ocupa de cómo configurar la gestión de sesiones y ajustarla a tus necesidades específicas. Esta documentación incluye los controladores de guardado, que almacenan y recuperan datos de la sesión y configuración del comportamiento de la sesión. - -Controladores de guardado -~~~~~~~~~~~~~~~~~~~~~~~~~ - -El flujo de trabajo en la sesión *PHP* tiene 6 posibles operaciones que pueden ocurrir. El flujo de sesión normal sigue el proceso de ``apertura``, ``lectura``, ``escritura`` y ``cierre``, con la posibilidad de ``destrucción`` y ``gc`` (por ``garbage collection`` o recolección de basura, la cual cerrará todas las sesiones abiertas: la `gc` se invoca aleatoriamente de acuerdo a la configuración de *PHP* y si es llamada directamente, su invocación se difiere hasta después de una operación de ``apertura``). Puedes leer más sobre esto en `php.net/session.customhandler`_ - - -Controladores de guardado nativos de *PHP* ------------------------------------------- - -Los llamados controladores 'nativos', son controladores de guardado que son o bien compilados en *PHP* o proporcionados por extensiones *PHP*, como *PHP SQLite*, *PHP-Memcached*, etc. - -Todos los controladores de guardado nativos son internos a *PHP* y como tal, no tienen enfrente *API* pública. -Ellos deben estar configurados en las directivas ``ini`` de *PHP*, por lo general ``session.save_path`` y potencialmente otros controladores específicos para la directiva. Puedes encontrar los detalles específicos en el bloque de documentación del método ``setOptions()`` de cada clase. - -Mientras los controladores de guardado nativos se pueden activar utilizando directamente ``ini_set('session.save_handler', $nombre);``, *Symfony2* proporciona una manera conveniente de activar estos en la misma forma que los controladores personalizados. - -*Symfony2* proporciona controladores para el siguiente controlador de guardado nativo, por ejemplo: - - * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeFileSessionHandler`; - -Ejemplo de uso:: - - use Symfony\Component\HttpFoundation\Session\Session; - use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage; - use Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeFileSessionHandler; - - $storage = new NativeSessionStorage(array(), new NativeFileSessionHandler()); - $session = new Session($storage); - -.. note:: - - Salvo el controlador ``files`` que está integrado en *PHP* y siempre disponible, la disponibilidad de los otros controladores depende de las extensiones de *PHP* activas en tiempo de ejecución. - -.. note:: - - Los controladores de guardado nativos proporcionan una rápida solución de almacenamiento de sesión, sin embargo, en sistemas complejos donde se necesita más control, los controladores de guardado personalizados pueden proporcionar más libertad y flexibilidad. - *Symfony2* proporciona varias implementaciones que se pueden personalizar aún más según sea necesario. - - -Controladores de guardado personalizados ----------------------------------------- - -Los controladores personalizados son aquellos que sustituyen por completo a los controladores de guardado de sesión integrados en *PHP*, proveyendo seis funciones retrollamadas que *PHP* invoca internamente en varios puntos en el flujo de trabajo de la sesión. - -*HttpFoundation* de *Symfony2*, por omisión, ofrece algunos de estos y fácilmente te pueden servir como -ejemplos, si quieres escribir uno propio. - - * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\PdoSessionHandler` - * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcacheSessionHandler` - * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MemcachedSessionHandler` - * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\MongoDbSessionHandler` - * :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NullSessionHandler` - -Ejemplo de uso:: - - use Symfony\Component\HttpFoundation\Session\Session; - use Symfony\Component\HttpFoundation\Session\Storage\SessionStorage; - use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler; - - $storage = new NativeSessionStorage(array(), new PdoSessionHandler()); - $session = new Session($storage); - - -Configurando sesiones *PHP* -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage` puede ajustar la mayoría de las directivas de configuración de *PHP*, las cuales están documentadas en `php.net/session.configuration`_. - -Para configurar estas opciones, pasa las claves (omitiendo la primera parte ``session.`` de la clave) como un arreglo de clave/valor como el argumento ``$options`` del constructor. -O ajústalas a través del método :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions`. - -En aras de la claridad, algunas de las opciones principales se explican en esta documentación. - -Duración de la ``cookie`` de sesión -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para mayor seguridad, generalmente se recomienda enviar fragmentos de sesión como ``cookies`` de sesión. -Puedes configurar el tiempo de vida de las ``cookies`` de sesión, especificando la duración (en segundos) usando la clave ``cookie_lifetime`` en el argumento ``$options`` del constructor en :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage`. - -Establecer una ``cookie_lifetime`` a ``0`` provocará que la ``cookie`` viva sólo mientras el navegador sigue abierto. En general, ``cookie_lifetime`` se establece en un número de días, semanas o meses relativamente grande. No es raro dejar ``cookies`` durante un año o más, dependiendo de la aplicación. - -Dado que las ``cookies`` de sesión son sólo una muestra del lado del cliente, estas son menos importantes al controlar los detalles de la configuración de seguridad que en última instancia sólo se pueden controlar en el lado del servidor. - -.. note:: - - La opción ``cookie_lifetime`` es el número de segundos que la ``cookie`` debería vivir, esta no es una marca de tiempo Unix. La ``cookie`` de sesión resultante será sellada durante un plazo de ``time()`` + ``cookie_lifetime`` donde el tiempo se toma desde el servidor. - -Configurando la recolección de basura -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando se abre una sesión, *PHP* llama aleatoriamente al controlador ``gc`` de acuerdo a la probabilidad establecida por ``session.gc_probability`` / ``session.gc_divisor``. Por ejemplo, si éstos se establecieron en ``5/100``, respectivamente, significaría una probabilidad del 5%. Del mismo modo, ``3/4`` significaría invocarlo en 3 de cada 4 oportunidades, es decir, un 75%. - -Si se invoca el controlador de recolección de basura, *PHP* pasará el valor almacenado en la directiva ``ini`` ``session.gc_maxlifetime`` de *PHP*. El significado en este contexto es que se debería suprimir cualquier sesión almacenada que se guardó por más de ``maxlifetime``. Esto le permite a uno expirar los registros basándose en el tiempo de inactividad. - -Puedes configurar estas opciones pasando ``gc_probability``, ``gc_divisor`` y ``gc_maxlifetime`` en un arreglo al constructor de :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage` o al método :method:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage::setOptions()`. - -Tiempo de vida de la sesión -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando se crea una nueva sesión, significa que *Symfony2* emite una nueva ``cookie`` de sesión para el cliente, la ``cookie`` será sellada con un tiempo de caducidad. Este se calcula sumando el valor de configuración de ``session.cookie_lifetime`` en *PHP* con la hora actual del servidor. - -.. note:: - - *PHP* sólo emitirá una ``cookie`` una vez. Se espera que el cliente guarde esa ``cookie`` toda la vida. Sólo se otorgará una nueva ``cookie`` cuando la sesión sea destruida, se elimine la ``cookie`` en el navegador, o se vuelva a regenerar el identificador de sesión usando los métodos ``migrate()`` o ``invalidate()`` de la clase ``Session``. - - La duración inicial de la ``cookie`` se puede establecer configurando ``NativeSessionStorage`` utilizando el método ``setOptions(array('cookie_lifetime' => 1234))``. - -.. note:: - - Una ``galeta`` con una vida útil de ``0`` significa que la ``galleta`` expira al cerrar el navegador. - -Tiempo de inactividad/Mantener viva la sesión -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A menudo hay circunstancias en las que posiblemente quieras proteger, o reducir al mínimo el uso no autorizado de una sesión cuando un usuario se aleja de su terminal mientras está conectado destruyendo la sesión después de cierto periodo de tiempo de inactividad. Por ejemplo, es común que las aplicaciones de banca cierren la sesión después de sólo 5 a 10 minutos de inactividad. Ajustar la duración de la ``cookie`` aquí no es apropiado debido a que el cliente la puede manipular, por lo que debemos hacer la expiración de lado del servidor. La forma más fácil es implementarla a través de la recolección de basura la cual se ejecuta con razonable frecuencia. El ``lifetime`` de la ``cookie`` se establece a un valor relativamente alto, y la recolección de basura ``maxlifetime`` se establecería para destruir sesiones en cualquiera que sea el periodo de inactividad deseado. - -La otra opción es comprobar específicamente si una sesión ha caducado después de haber iniciado la sesión. La sesión se puede destruir si es necesario. Este método de procesamiento puede permitir la integración de la expiración de sesiones en la experiencia del usuario, por ejemplo, visualizando un mensaje. - -*Symfony2* registra algunos metadatos básicos acerca de cada sesión para darte completa libertad en este ámbito. - -Metadatos de sesión -~~~~~~~~~~~~~~~~~~~ - -Las sesiones están decoradas con un poco de metadatos básicos para permitirte un control preciso sobre la configuración de seguridad. El objeto ``Sesión`` tiene un captador de metadatos, :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getMetadataBag` que -expone una instancia de :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\MetadataBag`:: - - $session->getMetadataBag()->getCreated(); - $session->getMetadataBag()->getLastUsed(); - -Ambos métodos devuelven una marca de tiempo Unix (relativa al servidor). - -Puedes utilizar estos metadatos para expirar la sesión explícitamente en el acceso, por ejemplo:: - - $session->start(); - if (time() - $session->getMetadataBag()->getLastUsed() > $maxIdleTime) { - $session->invalidate(); - throw new SessionExpired(); // redirige a la página de sesión expirada - } - -También es posible decir cuál es el ``cookie_lifetime`` establecido en una ``cookie`` en particular leyendo el método ``getLifetime()``:: - - $session->getMetadataBag()->getLifetime(); - -Puedes determinar el tiempo de caducidad de la ``cookie`` sumando la fecha y hora de creación y el ``lifetime``. - -Compatibilidad con *PHP 5.4* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A partir de *PHP 5.4.0*, están disponibles :phpclass:`SessionHandler` y :phpclass:`SessionHandlerInterface`. *Symfony 2.1* proporciona compatibilidad para :phpclass:`SessionHandlerInterface` por lo tanto la puedes utilizar en *PHP 5.3*. Esto, gratamente mejora la interoperabilidad con otras bibliotecas. - -:phpclass:`SessionHandler` es una clase interna especial de *PHP* que expone los controladores de guardado nativos para el espacio de usuario de *PHP*. - -Con el fin de proporcionar una solución para aquellos que utilizan *PHP 5.4*, *Symfony2* tiene una clase especial llamada :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeSessionHandler` que bajo *PHP 5.4*, se extiende desde `\SessionHandler` y bajo *PHP 5.3* es sólo una clase base vacía. Esto proporciona interesantes oportunidades para aprovechar la funcionalidad de *PHP 5.4* si está disponible. - -Controladores delegados de guardado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Hay dos tipos de controladores delegados de clases de guardado que heredan de :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\AbstractProxy`: -estas son :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeProxy` y :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\SessionHandlerProxy`. - -La :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\NativeSessionStorage` automáticamente inyecta los controladores de guardado en un controlador de guardado delegado, a menos que ya lo envuelva uno. - -La clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\NativeProxy` se utiliza automáticamente en *PHP 5.3*, cuando los controladores de guardado internos de *PHP* se especifican usando las clases ``Native*SessionHandler``, mientras que la clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\Handler\\SessionHandlerProxy` se utiliza para envolver cualquier controlador de guardado personalizado, esta implementa la :phpclass:`SessionHandlerInterface`. - -En *PHP 5.4* y superior, todos los controladores de sesión implementan la :phpclass:`SessionHandlerInterface` incluyendo las clases ``Native*SessionHandler`` que heredan de :phpclass:`SessionHandler`. - -El mecanismo delegado te permite involucrarte profundamente en las clases controladoras de guardado de sesión. Podrías utilizar un delegado, por ejemplo, para cifrar cualquier transacción de la sesión sin el conocimiento específico del controlador de guardado. - -.. _`php.net/session.customhandler`: http://www.php.net/manual/es/session.customhandler.php -.. _`php.net/session.configuration`: http://dk2.php.net/session.configuration diff --git a/_sources/components/http_foundation/session_testing.txt b/_sources/components/http_foundation/session_testing.txt deleted file mode 100644 index 476e2be..0000000 --- a/_sources/components/http_foundation/session_testing.txt +++ /dev/null @@ -1,43 +0,0 @@ -.. index:: - single: HTTP - single: HttpFoundation, Sesiones - -Probando con sesiones -===================== - -*Symfony2* se diseñó desde el principio con la comprobabilidad de código en mente. Con el fin de hacer que el código que utiliza la sesión sea fácilmente comprobable, disponemos de dos mecanismos de almacenamiento independientes para simular ambas, pruebas unitarias y pruebas funcionales. - -Probar el código usando sesiones reales es difícil porque el estado del flujo de trabajo de *PHP* es global y no es posible tener varias sesiones simultáneas en el mismo proceso *PHP*. - -Los motores de almacenamiento fingido simulan el flujo de trabajo de las sesiones *PHP* sin tener que iniciar una, lo cual te permite probar tu código sin complicaciones. También es posible ejecutar varias instancias en el mismo proceso *PHP*. - -Los controladores de almacenamiento simulado no leen ni escriben las globales del sistema ``session_id()`` o ``session_name()``. Y proporcionan métodos para simularlas de ser necesario: - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::getId`: Recupera el ``id`` de la sesión. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::setId`: Establece el ``id`` de la sesión. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::getName`: Recupera el nombre de la sesión. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionStorageInterface::setName`: Establece el nombre de la sesión. - -Pruebas unitarias ------------------ - -Para las pruebas unitarias donde no es necesario persistir la sesión, simplemente debes intercambiar el motor de almacenamiento predefinido con :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\MockArraySessionStorage`:: - - use Symfony\Component\HttpFoundation\Session\Storage\MockArraySessionStorage; - use Symfony\Component\HttpFoundation\Session\Session; - - $session = new Session(new MockArraySessionStorage()); - -Probando la funcionalidad -------------------------- - -Para las pruebas funcionales donde posiblemente necesites conservar los datos de sesión a través de procesos *PHP* independientes, basta con cambiar el motor de almacenamiento a la clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\\MockFileSessionStorage`:: - - use Symfony\Component\HttpFoundation\Session\Session; - use Symfony\Component\HttpFoundation\Session\Storage\MockFileSessionStorage; - - $session = new Session(new MockFileSessionStorage()); - diff --git a/_sources/components/http_foundation/sessions.txt b/_sources/components/http_foundation/sessions.txt deleted file mode 100644 index 0b1706c..0000000 --- a/_sources/components/http_foundation/sessions.txt +++ /dev/null @@ -1,275 +0,0 @@ -.. index:: - single: HTTP - single: HttpFoundation, Sesiones - -Gestión de la sesión -==================== - -El componente ``HttpFoundation`` de *Symfony2* tiene un subsistema de sesión muy potente y flexible, que está diseñado para proporcionar la gestión de sesiones a través de una sencilla interfaz orientada a objetos, utilizando una variedad de controladores para el almacenamiento de la sesión. - -.. versionadded:: 2.1 - La interfaz :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`, así como una serie de otros cambios, son nuevas a partir de *Symfony 2.1*. - -Las sesiones se utilizan a través de la simple clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Session` que implementa la interfaz :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`. - -Ejemplo rápido:: - - use Symfony\Component\HttpFoundation\Session\Session; - - $session = new Session(); - $session->start(); - - // establece y obtiene atributos de sesión - $session->set('name', 'Drak'); - $session->get('name'); - - // configura mensajes flash - $session->getFlashBag()->add('notice', 'Profile updated'); - - // recupera mensajes - foreach ($session->getFlashBag()->get('notice', array()) as $message) { - echo "
    $message
    "; - } - -.. note:: - - Las sesiones *Symfony* están diseñadas para sustituir varias funciones nativas de *PHP*. - Las aplicaciones deben evitar el uso de ``session_start()``, ``session_regenerate_id()``, `` session_id()``, ``session_name()``, y ``session_destroy()``, y en su lugar usar la *API* en la siguiente sección. - -.. note:: - - Si bien se recomienda empezar una sesión explícitamente, unas sesiones de hecho empezarán bajo demanda, es decir, si se hace alguna petición de sesión para leer/escribir dato de sesión. - -.. caution:: - - Las sesiones de *Symfony* son incompatibles con la directiva ``ini`` ``session.auto_start = 1`` de *PHP*. Esta directiva se debe apagar en ``php.ini``, en las directivas del servidor web o en ``.htaccess``. - -*API* de sesión -~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Session` implementa la interfaz :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionInterface`. - -La clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Session` tiene una *API* sencilla subdividida en un par de grupos. - -Flujo de trabajo en la sesión - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::start`: - Inicia la sesión --- no usa ``session_start()``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::migrate`: - Regenera el ``id`` de la sesión --- no usa ``session_regenerate_id()``---. - Opcionalmente, este método puede cambiar el tiempo de vida de la nueva ``cookie`` que será emitida al llamar a este método. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::invalidate`: - Limpia todos los datos de la sesión y regenera el ``id`` de la sesión. No usa ``session_destroy()``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getId`: Recupera el ``id`` de la sesión. Sin usar ``session_id()``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::setId`: Establece el ``id`` de la sesión. Sin usar ``session_id()``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getName`: Recupera el nombre de la sesión. Sin usar ``session_name()``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::setName`: Establece el nombre de la sesión. Sin usar ``session_name()``. - -Atributos de la sesión - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::set`: - Establece un atributo por su clave; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::get`: - Recupera un atributo por su clave; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::all`: - Recupera todos los atributos como un arreglo de ``clave => valor``; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::has`: - Devuelve ``true`` si el atributo existe; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::keys`: - Devuelve un arreglo de claves de atributo guardadas; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::replace`: - Establece múltiples atributos simultáneamente: toma un arreglo indexado y configura cada pareja ``clave => valor``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::remove`: - Elimina un atributo por clave; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::clear`: - Limpia todos los atributos; - -Internamente los atributos se almacenan en una ``«Bag»`` ('Bolsa', en adelante), un objeto *PHP* que actúa como un arreglo. Unos cuantos métodos existentes para gestionar una ``«Bolsa»``: - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::registerBag`: - Registra una :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface` - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getBag`: - Consigue una :class:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface` por medio del nombre de la «Bolsa». - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getFlashBag`: - Recupera la :class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface`. - Esta, únicamente es un conveniente atajo. - -Metadatos de sesión - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Session::getMetadataBag`: - Obtiene la clase :class:`Symfony\\Component\\HttpFoundation\\Session\\Storage\MetadataBag` la cual contiene información de la sesión. - - -Gestionando datos de sesión -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La gestión de sesiones *PHP* requiere el uso de la superglobal ``$_SESSION``, sin embargo, esto interfiere un poco con la comprobabilidad y encapsulación de código en un paradigma de programación orientado a objetos. Para ayudar a superar esta situación, *Symfony2* usa 'bolsas de sesión' vinculadas a la sesión para encapsular un conjunto de datos específico a los 'atributos' o 'mensajes flash'. - -Este enfoque también mitiga la contaminación del espacio de nombres dentro de la superglobal ``$_SESSION``, porque cada bolsa almacena todos sus datos bajo un único espacio de nombres. -Esto le permite a *Symfony2* coexistir pacíficamente con otras aplicaciones o bibliotecas que puedan usar la superglobal ``$_SESSION`` y todos los datos siguen siendo totalmente compatibles con la gestión de sesiones de *Symfony2*. - -*Symfony2* ofrece 2 tipos de bolsas para almacenamiento, con dos implementaciones independientes. -Todo está escrito contra interfaces para que las puedas ampliar o crear tus propios tipos de bolsa si es necesario. - -:class:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface` tiene la siguiente *API* destinada principalmente para uso interno: - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::getStorageKey`: - Devuelve la clave, que en última instancia es la bolsa que va a almacenar tu arreglo bajo ``$_SESSION``. - En general, puedes dejar este valor en su predefinido y es para uso interno. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::initialize`: - *Symfony2* llama internamente a este método para almacenar clases de sesión con datos para vincularlos a la bolsa de la sesión. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\SessionBagInterface::getName`: - Devuelve el nombre de la bolsa de sesión. - - -``Atributos`` -~~~~~~~~~~~~~ - -El propósito de la implementación de la :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface` de bolsas, es manejar el almacenamiento de los atributos de la sesión. Esto puede incluir cosas como el ``id`` de usuario, y la funcionalidad «recuérdame» en la configuración del inicio de sesión u otra información basada en el estado del usuario. - -* :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBag` Esta es la implementación estándar predeterminada. - -* :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\NamespacedAttributeBag` Esta implementación permite que los atributos sean almacenados en un espacio de nombres estructurado. - -Cualquier sistema de almacenamiento sencillo ``clave => valor`` está limitado en la medida en que se puedan almacenar datos complejos, ya que cada clave debe ser única. Lo puedes lograr introduciendo una convención a la nomenclatura de los espacios de nombres para que las claves sean partes diferentes de tu aplicación lo cual podría funcionar sin colisiones. Por ejemplo, ``modulo1.foo`` y ``modulo2.foo``. Sin embargo, a veces esto no es muy práctico cuando los datos de los atributos están en un arreglo, por ejemplo, un conjunto de iniciales. En este caso, la gestión del arreglo se convierte en una carga porque hay que recuperar el arreglo, luego, procesarlo y almacenarlo de nuevo:: - - $tokens = array('tokens' => array('a' => 'a6c1e0b6', - 'b' => 'f4a7b1f3')); - -Así que cualquier procesamiento de este tipo rápidamente se puede poner feo, aunque sólo añadas un elemento al arreglo:: - - $tokens = $session->get('tokens'); - $tokens['c'] = $value; - $session->set('tokens', $tokens); - -Con el espacio de nombre estructurado, la clave se puede trasladar a la estructura del arreglo tal cual usando un carácter del espacio de nombres (por omisión es ``/``):: - - $session->set('tokens/c', $value); - -De esta manera puedes acceder a una clave dentro del arreglo almacenado directa y fácilmente. - -La :class:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface` cuenta con una *API* sencilla - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::set`: - Establece un atributo por su clave; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::get`: - Recupera un atributo por su clave; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::all`: - Recupera todos los atributos como un arreglo de ``clave => valor``; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::has`: - Devuelve ``true`` si el atributo existe; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::keys`: - Devuelve un arreglo de claves de atributo guardadas; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::replace`: - Establece múltiples atributos simultáneamente: toma un arreglo indexado y configura cada pareja ``clave => valor``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::remove`: - Elimina un atributo por clave; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Attribute\\AttributeBagInterface::clear`: - Vacía la bolsa; - - -Mensajes flash -~~~~~~~~~~~~~~ - -El propósito de la :class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface` es proporcionar una forma de configurar y recuperar mensajes basándose en la sesión. -El flujo de trabajo habitual de los mensajes flash se encuentra en una ``Petición``, y se muestran después de redirigir a una página. Por ejemplo, un usuario envía un formulario que llegará a un controlador de actualización, y después de procesar el controlador redirige al usuario o bien a la página actualizada o a una página de error. Los mensajes flash establecidos en la ``Petición`` de página anterior se muestran inmediatamente al cargar la siguiente página en esa sesión. -Esta, sin embargo, sólo es una aplicación para los mensajes flash. - -* :class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\AutoExpireFlashBag` Esta implementación de mensajes se ajusta al cargar la página para que esté disponible para visualizarlo al cargar la siguiente página. Estos mensajes expirarán automáticamente independientemente de si se recuperan o no. - -* :class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBag` En esta implementación, los mensajes se mantendrán en la sesión hasta que se recuperen o borren explícitamente. Esto hace posible el uso de la caché *ESI*. - -La :class:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface` tiene una sencilla *API* - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::add`: - Añade un mensaje flash a la pila del tipo especificado; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::set`: - Configura mensajes flash por tipo; Este método toma ambos, mensajes como una ``cadena`` o varios mensajes en un ``arreglo``. - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::get`: - Recupera mensajes por tipo y los quita de la bolsa; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::setAll`: - Establece todos los flashes, acepta un arreglo de arreglos indexado ``tipo => array(mensajes)``; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::all`: - Recupera todos los mensajes flash (en forma de arreglo de arreglos indexado) y quita los mensajes de la bolsa; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peek`: - Recupera mensajes flash por tipo (sólo lectura); - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::peekAll`: - Recupera todos los mensajes flash (sólo lectura) como arreglo de arreglos indexado; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::has`: - Devuelve ``true`` si el tipo existe, ``false`` en caso contrario; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::keys`: - Devuelve un arreglo de tipos flash guardados; - -* :method:`Symfony\\Component\\HttpFoundation\\Session\\Flash\\FlashBagInterface::clear`: - Limpia la bolsa; - -Para aplicaciones simples por lo general es suficiente tener un mensaje flash por tipo, por ejemplo, un aviso de confirmación después de enviar un formulario. Sin embargo, los mensajes Flash se almacenan en un arreglo indexado por el ``$tipo`` del flash, lo cual significa que tu aplicación puede emitir varios mensajes de un determinado tipo. Esto te permite utilizar la *API* para mensajes más complejos en tu aplicación. - -Ejemplos de configuración de múltiples mensajes flash:: - - use Symfony\Component\HttpFoundation\Session\Session; - - $session = new Session(); - $session->start(); - - // añade mensajes flash - $session->getFlashBag()->add( - 'warning', - 'Your config file is writable, it should be set read-only' - ); - $session->getFlashBag()->add('error', 'Failed to update name'); - $session->getFlashBag()->add('error', 'Another error'); - -Para exhibir los mensajes flash puedes usar algo como esto: - -Simple, muestra un tipo de mensaje:: - - // muestra advertencias - foreach ($session->getFlashBag()->get('warning', array()) as $message) { - echo "
    $message
    "; - } - - // muestra errores - foreach ($session->getFlashBag()->get('error', array()) as $message) { - echo "
    $message
    "; - } - -Método compacto para procesar la exhibición simultánea de todos los mensajes:: - - foreach ($session->getFlashBag()->all() as $type => $messages) { - foreach ($messages as $message) { - echo "
    $message
    \n"; - } - } diff --git a/_sources/components/http_foundation/trusting_proxies.txt b/_sources/components/http_foundation/trusting_proxies.txt deleted file mode 100644 index 0e7aea4..0000000 --- a/_sources/components/http_foundation/trusting_proxies.txt +++ /dev/null @@ -1,42 +0,0 @@ -.. index:: - single: Petición; Delegados confiables - -Delegados confiables -==================== - -Si te encuentras detrás de alguna clase de delegado ---tal como un balanceador de carga--- entonces cierta información de las cabeceras se te puede enviar usando cabeceras ``X-Forwarded-*`` especiales. Por ejemplo, la cabecera *HTTP* ``Host`` normalmente se utiliza para regresar el servidor solicitado. Pero cuándo estás detrás de un delegado, el verdadero servidor se puede almacenar en una cabecera ``X-Forwarded-Host``. - -Debido a que las cabeceras *HTTP* se pueden suplantar, de manera predeterminada *Symfony2* *no* confía en estas cabeceras de delegados. Si estás detrás de un delegado, tienes que enumerar manualmente tu delegado en una lista blanca:: - - use Symfony\Component\HttpFoundation\Request; - - $request = Request::createFromGlobals(); - // únicamente confía en las cabeceras de delegados que vienen - // de esta dirección IP - $request->setTrustedProxies(array(192.0.0.1)); - -Configurando nombres de cabeceras ---------------------------------- - -De manera predeterminada, las siguientes cabeceras de delegados son confiables: - -* ``X-Forwarded-For`` Usada en :method:`Symfony\\Component\\HttpFoundation\\Request::getClientIp`; -* ``X-Forwarded-Host`` Usada en :method:`Symfony\\Component\\HttpFoundation\\Request::getHost`; -* ``X-Forwarded-Port`` Usada en :method:`Symfony\\Component\\HttpFoundation\\Request::getPort`; -* ``X-Forwarded-Proto`` Usada en :method:`Symfony\\Component\\HttpFoundation\\Request::getScheme` y :method:`Symfony\\Component\\HttpFoundation\\Request::isSecure`; - -Si tu delegado inverso utiliza un nombre de cabecera diferente para cualquiera de estas, puedes configurar el nombre de la cabecera a través del método :method:`Symfony\\Component\\HttpFoundation\\Request::setTrustedHeaderName`:: - - $request->setTrustedHeaderName(Request::HEADER_CLIENT_IP, 'X-Proxy-For'); - $request->setTrustedHeaderName(Request::HEADER_CLIENT_HOST, 'X-Proxy-Host'); - $request->setTrustedHeaderName(Request::HEADER_CLIENT_PORT, 'X-Proxy-Port'); - $request->setTrustedHeaderName(Request::HEADER_CLIENT_PROTO, 'X-Proxy-Proto'); - -Determinadas cabeceras no confiables ------------------------------------- - -De manera predeterminada, si pones en una lista blanca tus direcciones *IP* delegadas, entonces todas tus cabeceras enumeradas arriba serán confiables. Si necesitas confiar en algunas de esas cabeceras pero no en otras, también lo puedes hacer:: - - // desactiva la confianza en la cabecera ``X-Forwarded-Proto``, usa - // la cabecera predefinida - $request->setTrustedHeaderName(Request::HEADER_CLIENT_PROTO, ''); diff --git a/_sources/components/http_kernel/index.txt b/_sources/components/http_kernel/index.txt deleted file mode 100644 index a60c91c..0000000 --- a/_sources/components/http_kernel/index.txt +++ /dev/null @@ -1,7 +0,0 @@ -*HTTP* del núcleo -================= - -.. toctree:: - :maxdepth: 2 - - introduction diff --git a/_sources/components/http_kernel/introduction.txt b/_sources/components/http_kernel/introduction.txt deleted file mode 100644 index 4be51c9..0000000 --- a/_sources/components/http_kernel/introduction.txt +++ /dev/null @@ -1,482 +0,0 @@ -.. index:: - single: HTTP - single: HttpKernel - single: Componentes; HttpKernel - -El componente ``HttpKernel`` -============================ - - El componente ``HttpKernel`` proporciona un proceso estructurado para convertir una ``Petición`` en una ``Respuesta`` usando el despachador de eventos. - Es bastante flexible para crear una plataforma completa (*Symfony*), una microplataforma (*Silex*) o un sistema *CMS* avanzado (*Drupal*). - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/httpkernel); -* :doc:`Instalándolo vía Composer ` (``symfony/http-kernel`` en `Packagist`_). - -El flujo de trabajo de una ``Petición`` ---------------------------------------- - -Cada interacción *web* de *HTTP* empieza con una petición y termina con una respuesta. -Tu trabajo como desarrollador es crear el código *PHP* que lee la información de la petición -(p. ej. la *URL*) y crea y devuelve una respuesta (p. ej. una página *HTML* o una cadena *JSON*). - -.. image:: /images/components/http_kernel/request-response-flow.png - :align: center - -Típicamente, alguna clase de la plataforma o sistema está construida para manejar todas las tareas -repetitivas (p. ej. enrutado, seguridad, etc.) a modo de que un desarrollador pueda fácilmente construir -cada *página* de la aplicación. Exactamente *cómo* están construidos estos sistemas varía mucho. El componente ``HttpKernel`` proporciona una interfaz que formaliza el proceso de empezar con una petición y crear la respuesta apropiada. -El componente pretende ser el corazón de cualquier aplicación o plataforma, no importa qué tanto varíe la arquitectura de ese sistema:: - - namespace Symfony\Component\HttpKernel; - - use Symfony\Component\HttpFoundation\Request; - - interface HttpKernelInterface - { - // ... - - /** - * @return Response Una instancia de Response - */ - public function handle( - Request $request, - $type = self::MASTER_REQUEST, - $catch = true - ); - } - -Internamente, el método :method:`HttpKernel::handle()` --- implementa concretamente el método :method:`HttpKernelInterface::handle()` --- define un flujo de trabajo que inicia con una :class:`Symfony\\Component\\HttpFoundation\\Request` y termina con una :class:`Symfony\\Component\\HttpFoundation\\Response`. - -.. image:: /images/components/http_kernel/01-workflow.png - :align: center - -Los detalles exactos de este flujo de trabajo son la clave para entender cómo trabaja el núcleo (y la plataforma *Symfony* o cualquier otra biblioteca que use el núcleo). - -``HttpKernel``: Conducido por eventos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El método ``HttpKernel::handle()`` internamente trabaja despachando eventos. -Esto hace al método tanto flexible, pero también un poco abstracto, debido a que todo el «trabajo» de una aplicación/plataforma construida con ``HttpKernel`` está hecha con escuchas de eventos. - -Para ayudar a explicar este proceso, este documento mira cada paso del proceso y habla sobre cómo trabaja una implementación específica del ``HttpKernel`` ---la plataforma *Symfony*---. - -Inicialmente, utilizar el :class:`Symfony\\Component\\HttpKernel\\HttpKernel` es realmente sencillo, e implica crear un :doc:`despachador de eventos ` y un :ref:`resolutor de controlador ` (explicado más adelante). Para completar tu núcleo, añadirás más escuchas de eventos para los eventos explicados más adelante:: - - use Symfony\Component\HttpFoundation\Request; - use Symfony\Component\HttpKernel\HttpKernel; - use Symfony\Component\EventDispatcher\EventDispatcher; - use Symfony\Component\HttpKernel\Controller\ControllerResolver; - - // crea el objeto Request - $request = Request::createFromGlobals(); - - $dispatcher = new EventDispatcher(); - // ... añade algunos escuchas de eventos - - // crea tu resolutor de controlador - $resolver = new ControllerResolver(); - // crea una instancia del núcleo - $kernel = new HttpKernel($dispatcher, $resolver); - - // en realidad ejecuta el núcleo, el cuál convierte la petición en una respuesta - // despachando eventos, invocando a un controlador, y devolviendo la respuesta - $response = $kernel->handle($request); - - // difunde el contenido y envía las cabeceras - $response->send(); - - // desencadena el evento kernel.terminate - $kernel->terminate($request, $response); - -Ve «:ref:`http-kernel-working-example`» para más implementaciones concretas. - -Para información general sobre cómo añadir escuchas a los siguientes eventos, ve :ref:`http-kernel-creating-listener`. - -.. tip:: - - Fabien Potencier también escribió una magnífica serie sobre la utilización del componente ``HttpKernel`` y otros componentes de *Symfony2* para crear tu propia plataforma. Ve `Crea tu propia plataforma... en lo alto de los componentes de Symfony2`_. - -.. _component-http-kernel-kernel-request: - -1) El evento ``kernel.request`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Propósito típico**: Añadir más información a la ``Petición``, iniciar partes del sistema, o regresar una ``Respuesta`` si es posible (p. ej. una capa -de seguridad que niega el acceso). - -:ref:`Tabla de información de eventos del núcleo ` - -El primer evento despachado dentro del método :method:`HttpKernel::handle` es ``kernel.request``, el cual puede tener una serie de diferentes escuchas. - -.. image:: /images/components/http_kernel/02-kernel-request.png - :align: center - -Los escuchas de este evento pueden ser bastante diversos. Algunos escuchas ---tal como un escucha de seguridad--- podrían tener suficiente información para crear un objeto ``Respuesta`` inmediatamente. -Por ejemplo, si un escucha de seguridad determinó que un usuario no tiene acceso, ese escucha puede regresar una :class:`Symfony\\Component\\HttpFoundation\\RedirectResponse` a la página de inicio de sesión o una respuesta 403 de «Acceso denegado». - -Si al llegar a este punto regresa una ``Respuesta``, el proceso salta directamente al evento :ref:`kernel.response`. - -.. image:: /images/components/http_kernel/03-kernel-request-response.png - :align: center - -Otros escuchas sencillamente inician cosas o añaden más información a la petición. -Por ejemplo, un escucha podría determinar y poner la región en el objeto ``Petición``. - -Otro escucha común es el de enrutado. Un escucha enrutador puede procesar la ``Petición`` y determinar el controlador que se debería ejecutar (ve la próxima sección). -De hecho, el objeto ``Petición`` tiene una bolsa de «:ref:`atributos `» misma que es un sitio perfecto para almacenar este dato extra, específico de la aplicación sobre la petición. Esto significa que si tu escucha enrutador de alguna manera determina el controlador, lo puedes almacenar en los atributos de la ``Petición`` (los cuáles puede utilizar el resolutor del controlador). - -En general, el propósito del evento ``kernel.request`` es o bien, crear y regresar una ``Respuesta`` directamente, o añadir información a la ``Petición`` (p. ej. poniendo la región o configurando alguna otra información en los atributos de la ``Petición``). - -.. sidebar:: ``kernel.request`` en la plataforma *Symfony* - - El escucha más importante para ``kernel.request`` en la plataforma *Symfony* es el :class:`Symfony\\Component\\HttpKernel\\EventListener\\RouterListener`. - Esta clase ejecuta la capa de enrutado, la cual regresa un *arreglo* de información sobre la petición emparejada, incluyendo el ``_controller`` y cualquier marcador de posición que esté en el patrón de la ruta (p. ej. ``{slug}``). Ve el :doc:`componente Routing `. - - Este arreglo de información está almacenado en el arreglo ``attributes`` del objeto :class:`Symfony\\Component\\HttpFoundation\\Request`. Añadir la información de enrutado aquí no hace nada todavía, pero se utiliza luego al resolver el controlador. - -.. _component-http-kernel-resolve-controller: - -2) Resolviendo el controlador -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Suponiendo que ningún escucha del ``kernel.request`` fuera capaz de crear una ``Respuesta``, el próximo paso en ``HttpKernel`` es determinar y preparar (es decir, resolver) el controlador. El controlador es la parte final del código de la aplicación que es responsable de crear y regresar la ``Respuesta`` para una página específica. -El único requisito es que sea una función *PHP* que se pueda llamar ---es decir, una función o método en un objeto, o un ``Cierre``---. - -Pero *el cómo* determinar el controlador exacto para una petición es responsabilidad enteramente de tu aplicación. Este es el trabajo del «resolutor de controlador» ---una clase que implementa la :class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface` y es uno de los argumentos del constructor del ``HttpKernel``. - -.. image:: /images/components/http_kernel/04-resolve-controller.png - :align: center - -Tu trabajo es crear una clase que implemente la interfaz y rellenar sus dos métodos: ``getController`` y ``getArguments``. De hecho, ya existe una implementación predefinida, la cual puedes utilizar directamente o estudiar para ver cómo trabaja: -:class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolver`. -Esta implementación se explica más en la barra lateral de abajo:: - - namespace Symfony\Component\HttpKernel\Controller; - - use Symfony\Component\HttpFoundation\Request; - - interface ControllerResolverInterface - { - public function getController(Request $request); - - public function getArguments(Request $request, $controller); - } - -Internamente, el ``HttpKernel::handle`` primero llama al método :method:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface::getController` en el resolutor del controlador. Este método es pasado a la ``Petición`` y es el responsable de determinar de alguna manera y regresar un ejecutable *PHP* (el controlador) basándose en la información de la petición. - -El segundo método, :method:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface::getArguments`, será llamado después de lanzado otro evento ---``kernel.controller``---. - -.. sidebar:: Resolviendo el controlador en la plataforma *Symfony2* - - La plataforma *Symfony* utiliza la clase integrada :class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolver` (de hecho, utiliza una subclase, la cual cuenta con alguna funcionalidad extra, mencionada más adelante). Esta clase aprovecha la información colocada en la propiedad ``attributes`` del objeto ``Petición`` durante el ``RouterListener``. - - **getController** - - El ``ControllerResolver`` busca una clave ``_controller`` en la propiedad ``attributes`` del objeto ``Petición`` (recuerda que esta información típicamente se coloca en la ``Petición`` vía el ``RouterListener``). - Esta cadena entonces es transformada a un ejecutable *PHP* haciendo lo siguiente: - - a) El formato del ``AcmeDemoBundle:Default:index`` de la clave ``_controller`` se cambia a otra cadena que contiene la clase completa y nombre del método controlador siguiendo la convención utilizada en *Symfony2* ---p. ej. ``Acme\DemoBundle\Controller\DefaultController::indexAction``---. Esta transformación es específica a la subclase :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\ControllerResolver` utilizada por la plataforma *Symfony2*. - - b) Se crea una nueva instancia de tu clase controlador sin argumentos del constructor. - - c) Si el controlador implementa la :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareInterface`, se llama a ``setContainer`` en el objeto controlador y se pasa al contenedor. Este paso también es específico de la subclase :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\ControllerResolver` utilizada por la plataforma *Symfony2*. - - También hay otras cuantas variaciones más en el proceso anterior (p. ej. si estás registrando tus controladores como servicios). - -3) El evento ``kernel.controller`` ----------------------------------- - -**Propósito típico**: Iniciar cosas o cambiar el controlador justo antes de ejecutarlo. - -:ref:`Tabla de información de eventos del núcleo ` - -Después de haber determinado el controlador a ejecutar, ``HttpKernel::handle`` desencadena el evento ``kernel.controller``. Los escuchas de este evento podrían iniciar alguna parte necesaria del sistema después de determinar ciertas cosas (p. ej. el controlador, información de enrutado) pero antes de ejecutar el controlador. Para algunos ejemplos, ve la sección *Symfony2* abajo. - -.. image:: /images/components/http_kernel/06-kernel-controller.png - :align: center - -Los escuchas de este evento también pueden cambiar completamente el controlador ejecutable llamando al método :method:`FilterControllerEvent::setController` en el objeto ``Evento`` pasado a los escuchas en este evento. - -.. sidebar:: ``kernel.controller`` en la plataforma *Symfony* - - Hay unos cuantos escuchas menores del evento ``kernel.controller`` en la plataforma *Symfony*, y muchos tratan con la recolección de datos del perfilador cuándo está habilitado. - - Un interesante escucha proviene del :doc:`SensioFrameworkExtraBundle `, el cual viene empacado con la *Edición estándar de Symfony*. El escucha :doc:`@ParamConverter ` es la funcionalidad que te permite pasar un objeto completo (p. ej. un objeto ``Post``) a tu controlador en vez de un valor escalar (p. ej. un parámetro ``id`` que venía en tu ruta). El escucha ---``ParamConverterListener``--- usa la reflexión para mirar en cada uno de los argumentos del controlador e intenta utilizar diferentes métodos para convertirlos a objetos, los cuales entonces son almacenados en la propiedad ``attributes`` del objeto ``Petición``. Lee la siguiente sección para ver por qué esto es importante. - -4) Obteniendo los argumentos del controlador --------------------------------------------- - -Luego, ``HttpKernel::handle`` llama al método :method:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface::getArguments`. -Recuerda que el controlador devuelto en ``getController`` es ejecutable. -El propósito de ``getArguments`` es devolver el arreglo de argumentos que se deberían pasar a ese controlador. Exactamente cómo se hace esto es responsabilidad completamente de tu diseño, aunque el :class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolver` incorporado es un buen ejemplo. - -.. image:: /images/components/http_kernel/07-controller-arguments.png - :align: center - -Al llegar a este punto el núcleo tiene un ejecutable *PHP* (el controlador) y un arreglo de argumentos que se debería pasar al llamar al ejecutable. - -.. sidebar:: Obteniendo los argumentos del controlador en la plataforma *Symfony2* - - Ahora que sabes exactamente cuál es el controlador a ejecutar (normalmente un método dentro de un objeto ``Controlador``), el ``ControllerResolver`` usa la `Reflexión`_ en el ejecutable para devolver un arreglo con los *nombres* de cada uno de los argumentos. - Luego, itera sobre cada uno de estos argumentos y utiliza los siguientes trucos para determinar qué valor se debería pasar a cada argumento: - - a) Si la bolsa de atributos de la ``Petición`` contiene una clave que coincide con el nombre del argumento, utiliza ese valor. Por ejemplo, si el primer argumento para un controlador es ``$slug``, y hay una clave ``slug`` en la bolsa de ``atributos`` de la ``Petición``, se utiliza ese valor (y típicamente ese valor provino del ``RouterListener``). - - b) Si el argumento en el controlador cuenta con una insinuación de tipo en el objeto :class:`Symfony\\Component\\HttpFoundation\\Request` de *Symfony*, entonces se pasa la ``Petición`` como el valor. - -.. _component-http-kernel-calling-controller: - -5) Llamando al controlador -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -¡El siguiente paso es sencillo! ``HttpKernel::handle`` ejecuta el controlador. - -.. image:: /images/components/http_kernel/08-call-controller.png - :align: center - -El trabajo del controlador es construir la respuesta para el recurso dado. -Esta podría ser una página *HTML*, una cadena *JSON* o cualquier otra cosa. A diferencia de todas las demás partes del proceso hasta ahora, este paso es implementado por el «desarrollador final», por cada página construida. - -Normalmente, el controlador regresará un objeto ``Respuesta``. Si esto es cierto, ¡entonces el trabajo del núcleo está hecho! En este caso, el próximo paso es el evento :ref:`kernel.response `. - -.. image:: /images/components/http_kernel/09-controller-returns-response.png - :align: center - -Pero si el controlador regresa cualquier otra cosa más alla de una ``Respuesta``, entonces el núcleo tiene que hacer un poco más de trabajo ---:ref:`kernel.view ` (debido a que el objetivo final *siempre* es generar un objeto ``Respuesta``). - -.. note:: - - Un controlador tiene que regresar *algo*. Si un controlador regresa ``null``, inmediatamente se lanzará una excepción. - -.. _component-http-kernel-kernel-view: - -6) El evento ``kernel.view`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Propósito típico**: Transformar en ``Respuesta`` un valor devuelto por un controlador que no es una ``Respuesta``. - -:ref:`Tabla de información de eventos del núcleo ` - -Si el controlador no regresa un objeto ``Respuesta``, entonces el núcleo despacha otro evento ---``kernel.view``---. El trabajo de un escucha de este evento es utilizar el valor devuelto por el controlador (p. ej. un arreglo de datos o un objeto) para crear una ``Respuesta``. - -.. image:: /images/components/http_kernel/10-kernel-view.png - :align: center - -Esto puede ser útil si quieres utilizar una capa para la «vista»: en vez de regresar una ``Respuesta`` desde el controlador, regresas los datos que representan la página. -Un escucha de este evento entonces podría utilizar estos datos para crear una ``Respuesta`` en el formato correcto (p. ej. *HTML*, *json*, etc.). - -En esta etapa, si ningún escucha pone una respuesta en el evento, entonces se lanza una excepción: ya sea un controlador *o* uno de los escuchas de la vista siempre deben regresar una ``Respuesta``. - -.. sidebar:: ``kernel.view`` en la plataforma *Symfony* - - No hay escucha predefinido dentro de la plataforma *Symfony* para el ``kernel.view``. Sin embargo, un paquete del núcleo ---:doc:`SensioFrameworkExtraBundle `--- *añade* un escucha para este evento. Si tu controlador regresa un arreglo, y colocas la anotación :doc:`@Template` encima del controlador, entonces este escucha reproduce una plantilla, pasándo a esa plantilla el arreglo que regresó tu controlador, y crea una ``Respuesta`` con el contenido devuelto por esa plantilla. - - Además, un popular paquete de la comunidad `FOSRestBundle`_ implementa un escucha para este evento cuyo objetivo es darte una robusta capa para la vista capaz de utilizar un solo controlador para regresar muchas respuestas con diferente ``content-type`` (p. ej. *HTML*, *JSON*, *XML*, etc.). - -.. _component-http-kernel-kernel-response: - -7) El evento ``kernel.response`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Propósito típico**: Modificar el objeto ``Respuesta`` justo antes de enviarlo - -:ref:`Tabla de información de eventos del núcleo ` - -El objetivo final del núcleo es transformar una ``Petición`` a una ``Respuesta``. La ``Respuesta`` se podría crear durante el evento :ref:`kernel.request`, regresado del :ref:`controller`, o regresado por uno de los escuchas del evento :ref:`kernel.view`. - -Independientemente de quién creó la ``Respuesta``, otro evento ---``kernel.response``--- es despachado inmediatamente después. Un escucha típico de este evento modificará de alguna manera el objeto ``Respuesta``, tal como modificar cabeceras, añadir ``galletas``, o incluso cambiando el contenido de la ``Respuesta`` él (p. ej. inyectando algún -*JavaScript* antes de la etiqueta ```` final de una respuesta *HTML*). - -Después de despachado este evento, el objeto ``Respuesta`` final es regresado desde el método :method:`Symfony\\Component\\HttpKernel\\HttpKernel::handle`. En el caso de uso más típico, entonces puedes llamar al método :method:`Symfony\\Component\\HttpFoundation\\Response::send`, el cual envía las cabeceras e imprime el contenido de la ``Respuesta``. - -.. sidebar:: ``kernel.response`` en la plataforma *Symfony* - - Hay varios escuchas menores de este evento dentro de la plataforma *Symfony*, y la mayoría modifica la respuesta en alguna manera. Por ejemplo, el :class:`Symfony\\Bundle\\WebProfilerBundle\\EventListener\\WebDebugToolbarListener` inyecta algún *JavaScript* en el fondo de tu página en el entorno ``dev`` lo cual provoca que la barra de depuración web sea mostrada. Otro escucha, :class:`Symfony\\Component\\Security\\Http\\Firewall\\ContextListener` serializa la información del usuario actual en la sesión a modo de que se pueda recargar en la próxima petición. - -8) El evento ``kernel.terminate`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El evento ``kernel.terminate`` es nuevo en *Symfony 2.1*. - -**Propósito típico**: Realizar alguna acción «pesada» después de transmitir la respuesta al usuario. - -:ref:`Tabla de información de eventos del núcleo ` - -The final event of the HttpKernel process is ``kernel.terminate`` and is unique -because it occurs *after* the ``HttpKernel::handle`` method, and after the -response is sent to the user. Recuerda de arriba, entonces que el código que usa el núcleo, acaba así:: - - // difunde el contenido y envía las cabeceras - $response->send(); - - // desencadena el evento kernel.terminate - $kernel->terminate($request, $response); - -Como puedes ver, al llamar al ``$kernel->terminate`` después de enviar la respuesta, desencadenas el evento ``kernel.terminate`` donde puedes llevar a cabo determinadas acciones que puediste haber diferido para regresar la respuesta al cliente tan rápidamente como fuera posible (p. ej. el envío de correo electrónico). - -.. note:: - - Usar el evento ``kernel.terminate`` es opcional, y sólo lo deberías llamar si tu núcleo implementa la :class:`Symfony\\Component\\HttpKernel\\TerminableInterface`. - -.. sidebar:: ``kernel.terminate`` en la plataforma *Symfony* - - Si utilizas el ``SwiftmailerBundle`` con *Symfony2* y usas operaciones simultánea en ``memoria``, entonces la clase :class:`Symfony\\Bundle\\SwiftmailerBundle\\EventListener\\EmailSenderListener` es activada, la cual de hecho entrega cualquier correo electrónico que tengas planificado enviar durante la petición. - -.. _component-http-kernel-kernel-exception: - -Manejando excepciones: el evento ``kernel.exception`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -**Propósito típico**: Manejar algún tipo de excepción y crear una ``Respuesta`` apropiada para que la regrese la excepción. - -:ref:`Tabla de información de eventos del núcleo ` - -Si se desencadena una excepción en cualquier punto dentro del ``HttpKernel::handle``, se lanza otro evento ---``kernel.exception``---. Internamente, el cuerpo de la función ``handle`` está envuelto en un bloque prueba-captura. Al lanzar cualquier excepción, el ``kernel.exception`` es lanzado a modo de que tu sistema pueda responder de alguna manera a la excepción. - -.. image:: /images/components/http_kernel/11-kernel-exception.png - :align: center - -Cada escucha de este evento se pasa a un objeto :class:`Symfony\\Component\\HttpKernel\\Event\\GetResponseForExceptionEvent`, el cual puedes utilizar para acceder a la excepción original vía el método :method:`Symfony\\Component\\HttpKernel\\Event\\GetResponseForExceptionEvent::getException`. Un escucha típico de este evento comprobará algún determinado tipo de excepción y creará una ``Respuesta`` de error apropiada. - -Por ejemplo, para generar una página 404, podrías lanzar un tipo de excepción especial y luego añadir un escucha para este evento que busque esta excepción y genere y regrese una ``Respuesta`` 404. De hecho, el componente ``HttpKernel`` viene con un :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener`, el cual si eliges usarlo, de manera predeterminada hará esto y más (ve la barra lateral abajo para más detalles). - -.. sidebar:: ``kernel.exception`` en la plataforma *Symfony* - - Al utilizar la plataforma *Symfony* hay dos escuchas principales del ``kernel.exception``. - - **ExceptionListener en HttpKernel** - - El primero viene desde el núcleo del componente ``HttpKernel`` y se llama :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener`. - El escucha tiene varios objetivos: - - 1) Al lanzar una excepción esta es convertida a un objeto :class:`Symfony\\Component\\HttpKernel\\Exception\\FlattenException`, la cual contiene toda la información sobre la petición, pero esta se puede imprimir y serializar. - - 2) Si la excepción original implementa la :class:`Symfony\\Component\\HttpKernel\\Exception\\HttpExceptionInterface`, entonces ``getStatusCode`` y ``getHeaders`` son invocados en la excepción y utilizados para poblar las cabeceras y código de estado del objeto ``FlattenException``. La idea es que estos se utilicen en el siguiente paso al crear la respuesta final. - - 3) Un controlador es ejecutado y pasado a la excepción aplanada. El controlador exacto a ejecutar se pasa como argumento del constructor de este escucha. - Este controlador regresará la ``Respuesta`` final para esta página de error. - - **ExceptionListener en Security** - - El otro escucha importante es :class:`Symfony\\Component\\Security\\Http\\Firewall\\ExceptionListener`. - El objetivo de este escucha es manejar excepciones de seguridad y, cuándo sea apropiado, *ayudar* a autentificar al usuario (p. ej. redirigiéndolo a la página de inicio de sesión). - -.. _http-kernel-creating-listener: - -Creando un escucha del evento ------------------------------ - -Como has visto, puedes crear y suscribir escuchas de evento a cualquiera de los eventos despachados durante el ciclo del ``HttpKernel::handle``. Típicamente un escucha es una clase *PHP* con un método retrollamado, pero puede ser cualquier cosa. Para más información sobre la creación y suscripción de escuchas de evento, ve :doc:`/components/event_dispatcher/introduction`. - -El nombre de cada uno de los eventos del «núcleo» está definido como constante en la clase :class:`Symfony\\Component\\HttpKernel\\KernelEvents` Además, a cada escucha de evento se le pasa un único argumento, el cual es alguna subclase de :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`. -Este objeto contiene información sobre el estado actual del sistema y cada evento tiene su propio objeto ``Evento``: - -.. _component-http-kernel-event-table: - -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ -| **Nombre** | **Constante** ``KernelEvents`` | **Argumento pasado al escucha** | -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ -| kernel.request | ``KernelEvents::REQUEST`` | :class:`Symfony\\Component\\HttpKernel\\Event\\GetResponseEvent` | -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ -| kernel.controller | ``KernelEvents::CONTROLLER`` | :class:`Symfony\\Component\\HttpKernel\\Event\\FilterControllerEvent` | -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ -| kernel.view | ``KernelEvents::VIEW`` | :class:`Symfony\\Component\\HttpKernel\\Event\\GetResponseForControllerResultEvent` | -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ -| kernel.response | ``KernelEvents::RESPONSE`` | :class:`Symfony\\Component\\HttpKernel\\Event\\FilterResponseEvent` | -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ -| kernel.terminate | ``KernelEvents::TERMINATE`` | :class:`Symfony\\Component\\HttpKernel\\Event\\PostResponseEvent` | -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ -| kernel.exception | ``KernelEvents::EXCEPTION`` | :class:`Symfony\\Component\\HttpKernel\\Event\\GetResponseForExceptionEvent` | -+-------------------+--------------------------------+-------------------------------------------------------------------------------------+ - -.. _http-kernel-working-example: - -Un ejemplo completo funcionando -------------------------------- - -Cuándo utilizas el componente ``HttpKernel``, eres libre de asociar cualquier escucha a los eventos del núcleo y utilizar cualquier resolutor de controlador que implemente la :class:`Symfony\\Component\\HttpKernel\\Controller\\ControllerResolverInterface`. -No obstante, el componente ``HttpKernel`` viene con algunos escuchas incorporados y un ``ControllerResolver`` que puedes usar para crear un ejemplo que funcione:: - - use Symfony\Component\HttpFoundation\Request; - use Symfony\Component\HttpFoundation\Response; - use Symfony\Component\HttpKernel\HttpKernel; - use Symfony\Component\EventDispatcher\EventDispatcher; - use Symfony\Component\HttpKernel\Controller\ControllerResolver; - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - use Symfony\Component\Routing\Matcher\UrlMatcher; - use Symfony\Component\Routing\RequestContext; - - $routes = new RouteCollection(); - $routes->add('hello', new Route('/hello/{name}', array( - '_controller' => function (Request $request) { - return new Response(sprintf("Hello %s", $request->get('name'))); - } - ), - )); - - $request = Request::createFromGlobals(); - - $matcher = new UrlMatcher($routes, new RequestContext()); - - $dispatcher = new EventDispatcher(); - $dispatcher->addSubscriber(new RouterListener($matcher)); - - $resolver = new ControllerResolver(); - $kernel = new HttpKernel($dispatcher, $resolver); - - $response = $kernel->handle($request); - $response->send(); - - $kernel->terminate($request, $response); - -Subpeticiones -------------- - -Además de la petición «principal» enviada al ``HttpKernel::handle``, también puedes enviar las así llamadas «subpeticiones». Una subpetición se ve y actúa como cualquier otra petición, pero típicamente sirve para reproducir sólo una pequeña porción de una -página en vez de una página completa. Generalmente haces subpeticiones desde tu controlador (o quizás desde dentro de una plantilla, aquella que está reproduciendo tu controlador). - -.. image:: /images/components/http_kernel/sub-request.png - :align: center - -Para ejecutar una subpetición, usa el ``HttpKernel::handle``, pero cambia el segundo argumento de la siguiente manera:: - - use Symfony\Component\HttpFoundation\Request; - use Symfony\Component\HttpKernel\HttpKernelInterface; - - // ... - - // crea alguna otra petición manualmente como se necesaria - $request = new Request(); - // por ejemplo, posiblemente definas este _controller manualmente - $request->attributes->add('_controller', '...'); - - $response = $kernel->handle($request, HttpKernelInterface::SUB_REQUEST); - // hace algo con esta respuesta - -Esto crea otro ciclo petición-respuesta completo donde esta nueva ``Petición`` es transformada en una ``Respuesta``. La única diferencia es que internamente algunos escuchas (p. ej. seguridad) sólo pueden actuar en la petición maestra. A cada escucha se le pasa alguna subclase de :class:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent`, dónde puedes usar el método :method:`Symfony\\Component\\HttpKernel\\Event\\KernelEvent::getRequestType` para determinar si la petición actual es la «maestra» o una «subpetición». - -Por ejemplo, un escucha que únicamente debe actuar en la petición maestra puede tener esta apariencia:: - - use Symfony\Component\HttpKernel\HttpKernelInterface; - // ... - - public function onKernelRequest(GetResponseEvent $event) - { - if (HttpKernelInterface::MASTER_REQUEST !== $event->getRequestType()) { - return; - } - - // ... - } - -.. _`Packagist`: https://packagist.org/packages/symfony/http-kernel -.. _`Reflexión`: http://php.net/manual/en/book.reflection.php -.. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle -.. _`Crea tu propia plataforma... en lo alto de los componentes de Symfony2`: http://fabien.potencier.org/article/50/create-your-own-framework-on-top-of-the-symfony2-components-part-1 diff --git a/_sources/components/index.txt b/_sources/components/index.txt deleted file mode 100644 index fe3d217..0000000 --- a/_sources/components/index.txt +++ /dev/null @@ -1,31 +0,0 @@ -Componentes -=========== - -.. toctree:: - :hidden: - - using_components - class_loader - config/index - console/index - css_selector - debug - dom_crawler - dependency_injection/index - event_dispatcher/index - filesystem - finder - http_foundation/index - http_kernel/index - locale - options_resolver - process - property_access/index - routing/index - security/index - serializer - stopwatch - templating - yaml/index - -.. include:: /components/map.rst.inc diff --git a/_sources/components/locale.txt b/_sources/components/locale.txt deleted file mode 100644 index ac46931..0000000 --- a/_sources/components/locale.txt +++ /dev/null @@ -1,73 +0,0 @@ -.. index:: - single: Locale - single: Componentes; Locale - -El componente ``Locale`` -======================== - - El componente ``Locale`` proporciona el código de reserva para manejar aquellos casos en que falta la extensión ``intl``. - Además esta extiende la implementación de una clase :phpclass:`Locale` nativa con varios métodos útiles. - -Proveyendo el reemplazo de las siguientes funciones y clases: - -* :phpfunction:`intl_is_failure` -* :phpfunction:`intl_get_error_code` -* :phpfunction:`intl_get_error_message` -* :phpclass:`Collator` -* :phpclass:`IntlDateFormatter` -* :phpclass:`Locale` -* :phpclass:`NumberFormatter` - -.. note:: - - La implementación únicamente es compatible con la región "\ ``en``\ ". - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Locale); -* :doc:`Instalándolo vía Composer ` (``symfony/locale`` en `Packagist`_). - -Usando ------- - -Aprovechar el código de reserva incluye requerir funciones cooperantes y añadir clase cooperantes al cargador automático. - -Cuando se utiliza el componente ``ClassLoader`` el siguiente código es suficiente para complementar la extensión ``intl`` faltante: - -.. code-block:: php - - if (!function_exists('intl_get_error_code')) { - require __DIR__.'/ruta/a/src/Symfony/Component/Locale/Resources/stubs/functions.php'; - - $loader->registerPrefixFallbacks( - array(__DIR__.'/ruta/a/src/Symfony/Component/Locale/Resources/stubs') - ); - } - -:class:`Symfony\\Component\\Locale\\Locale` enriquece a la clase nativa :phpclass:`Locale` con características adicionales: - -.. code-block:: php - - use Symfony\Component\Locale\Locale; - - // Obtiene los nombres de países para una región u obtiene todos los códigos de país - $countries = Locale::getDisplayCountries('pl'); - $countryCodes = Locale::getCountries(); - - // Obtiene los nombres de idiomas para una región u obtiene todos los códigos de idioma - $languages = Locale::getDisplayLanguages('fr'); - $languageCodes = Locale::getLanguages(); - - // Obtiene los nombres de configuración regional para un determinado código - // u obtiene todos los códigos de región - $locales = Locale::getDisplayLocales('en'); - $localeCodes = Locale::getLocales(); - - // Obtiene versiones ICU - $icuVersion = Locale::getIntlIcuVersion(); - $icuDataVersion = Locale::getIcuDataVersion(); - -.. _`Packagist`: https://packagist.org/packages/symfony/locale diff --git a/_sources/components/options_resolver.txt b/_sources/components/options_resolver.txt deleted file mode 100644 index c698d38..0000000 --- a/_sources/components/options_resolver.txt +++ /dev/null @@ -1,300 +0,0 @@ -.. index:: - single: Options Resolver - single: Componentes; OptionsResolver - -The OptionsResolver Component -============================= - - The OptionsResolver Component helps you configure objects with option - arrays. It supports default values, option constraints and lazy options. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Use the official Git repository (https://github.com/symfony/OptionsResolver -* :doc:`Install it via Composer` (``symfony/options-resolver`` on `Packagist`_) - -Usando ------- - -Imagine you have a ``Person`` class which has 2 options: ``firstName`` and -``lastName``. These options are going to be handled by the OptionsResolver -Component. - -First, create the ``Person`` class:: - - class Person - { - protected $options; - - public function __construct(array $options = array()) - { - } - } - -You could of course set the ``$options`` value directly on the property. Instead, -use the :class:`Symfony\\Component\\OptionsResolver\\OptionsResolver` class -and let it resolve the options by calling -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::resolve`. -The advantages of doing this will become more obvious as you continue:: - - use Symfony\Component\OptionsResolver\OptionsResolver; - - // ... - public function __construct(array $options = array()) - { - $resolver = new OptionsResolver(); - - $this->options = $resolver->resolve($options); - } - -The ``$options`` property is an instance of -:class:`Symfony\\Component\\OptionsResolver\\Options`, which implements -:phpclass:`ArrayAccess`, :phpclass:`Iterator` and :phpclass:`Countable`. That -means you can handle it just like a normal array:: - - // ... - public function getFirstName() - { - return $this->options['firstName']; - } - - public function getFullName() - { - $name = $this->options['firstName']; - - if (isset($this->options['lastName'])) { - $name .= ' '.$this->options['lastName']; - } - - return $name; - } - -Now, try to actually use the class:: - - $person = new Person(array( - 'firstName' => 'Wouter', - 'lastName' => 'de Jong', - )); - - echo $person->getFirstName(); - -Right now, you'll receive a -:class:`Symfony\\Component\\OptionsResolver\\Exception\\InvalidOptionsException`, -which tells you that the options ``firstName`` and ``lastName`` do not exist. -This is because you need to configure the ``OptionsResolver`` first, so it -knows which options should be resolved. - -.. tip:: - - To check if an option exists, you can use the - :method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::isKnown` - function. - -A best practice is to put the configuration in a method (e.g. -``setDefaultOptions``). You call this method in the constructor to configure -the ``OptionsResolver`` class:: - - use Symfony\Component\OptionsResolver\OptionsResolver; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class Person - { - protected $options; - - public function __construct(array $options = array()) - { - $resolver = new OptionsResolver(); - $this->setDefaultOptions($resolver); - - $this->options = $resolver->resolve($options); - } - - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - // ... configure the resolver, you will learn this in the sections below - } - } - -Required Options ----------------- - -Suppose the ``firstName`` option is required: the class can't work without -it. You can set the required options by calling -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setRequired`:: - - // ... - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setRequired(array('firstName')); - } - -You are now able to use the class without errors:: - - $person = new Person(array( - 'firstName' => 'Wouter', - )); - - echo $person->getFirstName(); // 'Wouter' - -If you don't pass a required option, a -:class:`Symfony\\Component\\OptionsResolver\\Exception\\MissingOptionsException` -will be thrown. - -To determine if an option is required, you can use the -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::isRequired` -method. - -Optional Options ----------------- - -Sometimes, an option can be optional (e.g. the ``lastName`` option in the -``Person`` class). You can configure these options by calling -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setOptional`:: - - // ... - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - // ... - - $resolver->setOptional(array('lastName')); - } - -Set Default Values ------------------- - -Most of the optional options have a default value. You can configure these -options by calling -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setDefaults`:: - - // ... - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - // ... - - $resolver->setDefaults(array( - 'age' => 0, - )); - } - -The default age will be ``0`` now. When the user specifies an age, it gets -replaced. You don't need to configure ``age`` as an optional option. The -``OptionsResolver`` already knows that options with a default value are -optional. - -The ``OptionsResolver`` component also has an -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::replaceDefaults` -method. This can be used to override the previous default value. The closure -that is passed has 2 parameters: - -* ``$options`` (an :class:`Symfony\\Component\\OptionsResolver\\Options` - instance), with all the default options -* ``$value``, the previous set default value - -Default Values that depend on another Option -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Suppose you add a ``gender`` option to the ``Person`` class, whose default -value you guess based on the first name. You can do that easily by using a -Closure as the default value:: - - use Symfony\Component\OptionsResolver\Options; - - // ... - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - // ... - - $resolver->setDefaults(array( - 'gender' => function (Options $options) { - if (GenderGuesser::isMale($options['firstName'])) { - return 'male'; - } - - return 'female'; - }, - )); - } - -.. caution:: - - The first argument of the Closure must be typehinted as ``Options``, - otherwise it is considered as the value. - -Configure allowed Values ------------------------- - -Not all values are valid values for options. For instance, the ``gender`` -option can only be ``female`` or ``male``. You can configure these allowed -values by calling -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setAllowedValues`:: - - // ... - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - // ... - - $resolver->setAllowedValues(array( - 'gender' => array('male', 'female'), - )); - } - -There is also an -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedValues` -method, which you can use if you want to add an allowed value to the previous -set allowed values. - -Configure allowed Types -~~~~~~~~~~~~~~~~~~~~~~~ - -You can also specify allowed types. For instance, the ``firstName`` option can -be anything, but it must be a string. You can configure these types by calling -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::setAllowedTypes`:: - - // ... - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - // ... - - $resolver->setAllowedTypes(array( - 'firstName' => 'string', - )); - } - -Possible types are the one associated with the ``is_*`` php functions or a -class name. You can also pass an array of types as the value. For instance, -``array('null', 'string')`` allows ``firstName`` to be ``null`` or a -``string``. - -There is also an -:method:`Symfony\\Component\\OptionsResolver\\OptionsResolver::addAllowedTypes` -method, which you can use to add an allowed type to the previous allowed types. - -Normalize the Options ---------------------- - -Some values need to be normalized before you can use them. For instance, the -``firstName`` should always start with an uppercase letter. To do that, you can -write normalizers. These Closures will be executed after all options are -passed and return the normalized value. You can configure these normalizers by -calling -:method:`Symfony\\Components\\OptionsResolver\\OptionsResolver::setNormalizers`:: - - // ... - protected function setDefaultOptions(OptionsResolverInterface $resolver) - { - // ... - - $resolver->setNormalizers(array( - 'firstName' => function (Options $options, $value) { - return ucfirst($value); - }, - )); - } - -You see that the closure also get an ``$options`` parameter. Sometimes, you -need to use the other options for normalizing. - -.. _`Packagist`: https://packagist.org/packages/symfony/options-resolver diff --git a/_sources/components/process.txt b/_sources/components/process.txt deleted file mode 100644 index 6c5f331..0000000 --- a/_sources/components/process.txt +++ /dev/null @@ -1,142 +0,0 @@ -.. index:: - single: Process - single: Componentes; Process - -El componente ``Process`` -========================= - - El componente ``Process`` ejecuta ordenes en subprocesos. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Process); -* :doc:`Instalándolo vía Composer ` (``symfony/process`` en `Packagist`_). - -Usando ------- - -La clase :class:`Symfony\\Component\\Process\\Process` te permite ejecutar una orden en un subproceso:: - - use Symfony\Component\Process\Process; - - $process = new Process('ls -lsa'); - $process->run(); - - // executes after the command finishes - if (!$process->isSuccessful()) { - throw new \RuntimeException($process->getErrorOutput()); - } - - print $process->getOutput(); - -The component takes care of the subtle differences between the different platforms -when executing the command. - -.. versionadded:: 2.2 - Los métodos ``getIncrementalOutput()`` y ``getIncrementalErrorOutput()`` fueron añadidos en *Symfony 2.2*. - -El método ``getOutput()`` siempre regresa el contenido entero de la salida estándar de la orden y ``getErrorOutput()`` el contenido de la salida de error. Alternativamente, los métodos :method:`Symfony\\Component\\Process\\Process::getIncrementalOutput` -y :method:`Symfony\\Component\\Process\\Process::getIncrementalErrorOutput` regresan la nueva producción desde la última llamada. - -Cuando se ejecuta una orden que consume demasiado tiempo (tal como la resincronización de archivos con un servidor remoto), puedes retroalimentar en tiempo real al usuario final suministrando una función anónima al método :method:`Symfony\\Component\\Process\\Process::run`:: - - use Symfony\Component\Process\Process; - - $process = new Process('ls -lsa'); - $process->run(function ($type, $buffer) { - if ('err' === $type) { - echo 'ERR > '.$buffer; - } else { - echo 'OUT > '.$buffer; - } - }); - -.. versionadded:: 2.1 - The non-blocking feature was added in 2.1. - -You can also start the subprocess and then let it run asynchronously, retrieving -output and the status in your main process whenever you need it. Use the -:method:`Symfony\\Component\\Process\\Process::start` method to start an asynchronous -process, the :method:`Symfony\\Component\\Process\\Process::isRunning` method -to check if the process is done and the -:method:`Symfony\\Component\\Process\\Process::getOutput` method to get the output:: - - $process = new Process('ls -lsa'); - $process->start(); - - while ($process->isRunning()) { - // waiting for process to finish - } - - echo $process->getOutput(); - -You can also wait for a process to end if you started it asynchronously and -are done doing other stuff:: - - $process = new Process('ls -lsa'); - $process->start(); - - // ... do other things - - $process->wait(function ($type, $buffer) { - if ('err' === $type) { - echo 'ERR > '.$buffer; - } else { - echo 'OUT > '.$buffer; - } - }); - -Si deseas ejecutar algún código *PHP* independiente, en su lugar usa ``PhpProcess``:: - - use Symfony\Component\Process\PhpProcess; - - $process = new PhpProcess(<< - EOF - ); - $process->run(); - -.. versionadded:: 2.1 - The ``ProcessBuilder`` class was added in Symfony 2.1. - -Para hacer que tu código trabaje mejor en todas las plataformas, posiblemente en su lugar quieras usar la clase :class:`Symfony\\Component\\Process\\ProcessBuilder`:: - - use Symfony\Component\Process\ProcessBuilder; - - $builder = new ProcessBuilder(array('ls', '-lsa')); - $builder->getProcess()->run(); - -Process Timeout ---------------- - -You can limit the amount of time a process takes to complete by setting a -timeout (in seconds):: - - use Symfony\Component\Process\Process; - - $process = new Process('ls -lsa'); - $process->setTimeout(3600); - $process->run(); - -If the timeout is reached, a -:class:`Symfony\\Process\\Exception\\RuntimeException` is thrown. - -For long running commands, it is your responsibility to perform the timeout -check regularly:: - - $process->setTimeout(3600); - $process->start(); - - while ($condition) { - // ... - - // check if the timeout is reached - $process->checkTimeout(); - - usleep(200000); - } - -.. _`Packagist`: https://packagist.org/packages/symfony/process diff --git a/_sources/components/property_access/index.txt b/_sources/components/property_access/index.txt deleted file mode 100644 index 8356ecf..0000000 --- a/_sources/components/property_access/index.txt +++ /dev/null @@ -1,7 +0,0 @@ -Propiedad ``Access`` -==================== - -.. toctree:: - :maxdepth: 2 - - introduction diff --git a/_sources/components/property_access/introduction.txt b/_sources/components/property_access/introduction.txt deleted file mode 100644 index 7080a74..0000000 --- a/_sources/components/property_access/introduction.txt +++ /dev/null @@ -1,250 +0,0 @@ -.. index:: - single: PropertyAccess - single: Componentes; PropertyAccess - -El componente ``PropertyAccess`` -================================ - - El componente ``PropertyAccess`` proporciona una función para leer y escribir de/a un objeto o arreglo usando una sencilla notación de cadena. - -.. versionadded:: 2.2 - El componente ``PropertyAccess`` es nuevo para *Symfony 2.2*. Anteriormente, la clase ``PropertyPath`` se localizaba en el componente ``Form``. - -Instalando ----------- - -Puedes instalar el componente en dos diferentes maneras: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/propertyaccess); -* :doc:`Instalándolo vía Composer ` (``symfony/property-access`` en `Packagist`_). - -Usando ------- - -El punto de entrada de este componente es el método fábrica :method:`PropertyAccess::getPropertyAccessor`. Esta fábrica creará una nueva instancia de la clase :class:`Symfony\\Component\\PropertyAccess\\PropertyAccessor` con la configuración predefinida:: - - use Symfony\Component\PropertyAccess\PropertyAccess; - - $accessor = PropertyAccess::getPropertyAccessor(); - -Leyendo desde arreglos ----------------------- - -Puedes leer un arreglo con el método :method:`PropertyAccessor::getValue `. Esto se hace utilizando la notación de índice utilizada en *PHP*:: - - // ... - $person = array( - 'first_name' => 'Wouter', - ); - - echo $accessor->getValue($person, '[first_name]'); // 'Wouter' - echo $accessor->getValue($person, '[age]'); // null - -Como puedes ver, el método regresará ``null`` si el índice no existe. - -También puedes utilizar arreglos multidimensionales:: - - // ... - $persons = array( - array( - 'first_name' => 'Wouter', - ), - array( - 'first_name' => 'Ryan', - ) - ); - - echo $accessor->getValue($persons, '[0][first_name]'); // 'Wouter' - echo $accessor->getValue($persons, '[1][first_name]'); // 'Ryan' - -Leyendo Objetos ---------------- - -El método ``getValue`` es un método muy robusto, y puedes ver todas sus características al trabajar con objetos. - -Accediendo a propiedades públicas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para leer propiedades, usa la notación de «punto»:: - - // ... - $person = new Person(); - $person->firstName = 'Wouter'; - - echo $accessor->getValue($person, 'firstName'); // 'Wouter' - - $child = new Person(); - $child->firstName = 'Bar'; - $person->children = array($child); - - echo $accessor->getValue($person, 'children[0].firstName'); // 'Bar' - -.. caution:: - - Acceder a las propiedades públicas es la última opción utilizada por ``PropertyAccessor``. - Este intenta acceder al valor utilizando los siguientes métodos primero antes de utilizar la propiedad directamente. Por ejemplo, si tienes una propiedad pública que tiene un método captador, lo utiliza. - -Usando Captadores -~~~~~~~~~~~~~~~~~ - -El método ``getValue`` también apoya la lectura utilizando captadores. El método será creado utilizando convenciones de nomenclatura comunes para los captadores. Este intercala mayúsculas en el nombre de la propiedad (``first_name`` se convierte en ``FirstName``) y lo prefija con ``get``. Por lo tanto el método real es ``getFirstName``:: - - // ... - class Person - { - private $firstName = 'Wouter'; - - public function getFirstName() - { - return $this->firstName; - } - } - - $person = new Person(); - - echo $accessor->getValue($person, 'first_name'); // 'Wouter' - -Using Hassers/Issers -~~~~~~~~~~~~~~~~~~~~ - -And it doesn't even stop there. If there is no getter found, the accessor will -look for an isser or hasser. This method is created using the same way as -getters, this means that you can do something like this:: - - // ... - class Person - { - private $author = true; - private $children = array(); - - public function isAuthor() - { - return $this->author; - } - - public function hasChildren() - { - return 0 !== count($this->children); - } - } - - $person = new Person(); - - if ($accessor->getValue($person, 'author')) { - echo 'He is an author'; - } - if ($accessor->getValue($person, 'children')) { - echo 'He has children'; - } - -Esto producirá: ``He is an author`` - -Magic Methods -~~~~~~~~~~~~~ - -At last, ``getValue`` can use the magic ``__get`` method too:: - - // ... - class Person - { - private $children = array( - 'wouter' => array(...), - ); - - public function __get($id) - { - return $this->children[$id]; - } - } - - $person = new Person(); - - echo $accessor->getValue($person, 'Wouter'); // array(...) - -Writing to Arrays ------------------ - -The ``PropertyAccessor`` class can do more than just read an array, it can -also write to an array. This can be achieved using the -:method:`PropertyAccessor::setValue` -method:: - - // ... - $person = array(); - - $accessor->setValue($person, '[first_name]', 'Wouter'); - - echo $accessor->getValue($person, '[first_name]'); // 'Wouter' - // o - // echo $person['first_name']; // 'Wouter' - -Writing to Objects ------------------- - -The ``setValue`` method has the same features as the ``getValue`` method. You -can use setters, the magic ``__set`` or properties to set values:: - - // ... - class Person - { - public $firstName; - private $lastName; - private $children = array(); - - public function setLastName($name) - { - $this->lastName = $name; - } - - public function __set($property, $value) - { - $this->$property = $value; - } - - // ... - } - - $person = new Person(); - - $accessor->setValue($person, 'firstName', 'Wouter'); - $accessor->setValue($person, 'lastName', 'de Jong'); - $accessor->setValue($person, 'children', array(new Person())); - - echo $person->firstName; // 'Wouter' - echo $person->getLastName(); // 'de Jong' - echo $person->children; // array(Person()); - -Mezclando objetos y arreglos ----------------------------- - -también puedes mezcla objetos y arreglos:: - - // ... - class Person - { - public $firstName; - private $children = array(); - - public function setChildren($children) - { - return $this->children; - } - - public function getChildren() - { - return $this->children; - } - } - - $person = new Person(); - - $accessor->setValue($person, 'children[0]', new Person); - // igual que $person->getChildren()[0] = new Person() - - $accessor->setValue($person, 'children[0].firstName', 'Wouter'); - // igual a $person->getChildren()[0]->firstName = 'Wouter' - - echo 'Hello '.$accessor->getValue($person, 'children[0].firstName'); // 'Wouter' - // igual a $person->getChildren()[0]->firstName - -.. _`Packagist`: https://packagist.org/packages/symfony/property-access diff --git a/_sources/components/routing.txt b/_sources/components/routing.txt deleted file mode 100644 index 1fe3e75..0000000 --- a/_sources/components/routing.txt +++ /dev/null @@ -1,273 +0,0 @@ -.. index:: - single: Enrutando - single: Componentes; Routing - -El componente ``Routing`` -========================= - - El componente ``Routing`` asigna una ``petición`` *HTTP* a un conjunto de variables de configuración. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Routing); -* Instalándolo a través de *PEAR* (`pear.symfony.com/Routing`); -* Instalándolo vía ``Composer`` (`symfony/routing` en Packagist) - -Usando ------- - -Con el fin de establecer un sistema de enrutado básico necesitas tres partes: - -* Una clase :class:`Symfony\\Component\\Routing\\RouteCollection`, que contiene las definiciones de las rutas (instancias de la clase :class:`Symfony\\Component\\Routing\\Route`) -* Una clase :class:`Symfony\\Component\\Routing\\RequestContext`, que contiene información sobre la petición -* Una clase :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher`, que realiza la asignación de la petición a una sola ruta - -Veamos un ejemplo rápido. Ten en cuenta que esto supone que ya has configurado el cargador automático para cargar el componente ``Routing``: - -.. code-block:: php - - - use Symfony\Component\Routing\Matcher\UrlMatcher; - use Symfony\Component\Routing\RequestContext; - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $routes = new RouteCollection(); - $routes->add('route_name', new Route('/foo', array('controller' => 'MyController'))); - - $context = new RequestContext($_SERVER['REQUEST_URI']); - - $matcher = new UrlMatcher($routes, $context); - - $parameters = $matcher->match('/foo'); - // array('controller' => 'MyController', '_route' => 'route_name') - -.. note:: - - Ten cuidado al usar ``$_SERVER['REQUEST_URI']``, ya que este puede incluir los parámetros de consulta en la URL, lo cual causará problemas con la ruta coincidente. Una manera fácil de solucionar esto es usando el componente ``HTTPFoundation`` como se explica :ref:`abajo `. - -Puedes agregar tantas rutas como quieras a una clase :class:`Symfony\\Component\\Routing\\RouteCollection`. - -El método :method:`RouteCollection::add()` toma dos argumentos. El primero es el nombre de la ruta. El segundo es un objeto :class:`Symfony\\Component\\Routing\\Route`, que espera una ruta *URL* y algún arreglo de variables personalizadas en su constructor. Este arreglo de variables personalizadas puede ser *cualquier cosa* que tenga significado para tu aplicación, y es devuelto cuando dicha ruta corresponda. - -Si no hay ruta coincidente debe lanzar una :class:`Symfony\\Component\\Routing\\Exception\\ResourceNotFoundException`. - -Además de tu arreglo de variables personalizadas, se añade una clave ``_route``, que contiene el nombre de la ruta buscada. - -Definiendo rutas -~~~~~~~~~~~~~~~~ - -Una definición de la ruta completa puede contener un máximo de cuatro partes: - -1. El patrón de la ruta *URL*. Este se compara con la *URL* pasada al ``RequestContext``, y puede contener comodines marcadores de posición nombrados (por ejemplo, ``{placeholders}``) para que coincidan con elementos dinámicos en la *URL*. - -2. Una matriz de valores predeterminados. Esta contiene un conjunto de valores arbitrarios que serán devueltos cuando la petición coincide con la ruta. - -3. Un arreglo de requisitos. Estos definen las restricciones para los valores de los marcadores de posición como las expresiones regulares. - -4. Un arreglo de opciones. Estas contienen la configuración interna de la ruta y son las menos necesarias comúnmente. - -Veamos la siguiente ruta, que combina varias de estas ideas: - -.. code-block:: php - - $route = new Route( - '/archive/{month}', // ruta - array('controller' => 'showArchive'), // valores predefinidos - array('month' => '[0-9]{4}-[0-9]{2}'), // requisitos - array() // options - ); - - // ... - - $parameters = $matcher->match('/archive/2012-01'); - // array('controller' => 'showArchive', 'month' => '2012-01', '_route' => ...) - - $parameters = $matcher->match('/archive/foo'); - // lanza la ResourceNotFoundException - -En este caso, la ruta coincide con ``/archive/2012-01``, porque el comodín ``{month}`` coincide con el comodín de la expresión regular suministrada. Sin embargo, ``/archive/f oo`` *no* coincide, porque el comodín del mes "foo" no concuerda. - -Además de las restricciones de la expresión regular, hay dos requisitos especiales que puedes definir: - -* el ``_method`` impone un determinado método de la petición *HTTP* (``HEAD``, ``GET``, ``POST``, ...) -* ``_scheme`` impone un determinado esquema *HTTP* (``http``, ``https``) - -Por ejemplo, la siguiente ruta sólo acepta peticiones a ``/foo`` con el método ``POST`` y una conexión segura: - -.. code-block:: php - - $route = new Route('/foo', array(), array('_method' => 'post', '_scheme' => 'https' )); - -.. tip:: - - Si quieres hacer coincidir todas las *URL* que comiencen con una cierta ruta y terminan en un sufijo arbitrario puedes utilizar la siguiente definición de ruta:: - - $route = new Route('/start/{suffix}', array('suffix' => ''), array('suffix' => '.*')); - - -Usando prefijos -~~~~~~~~~~~~~~~ - -Puedes agregar rutas u otras instancias de :class:`Symfony\\Component\\Routing\\RouteCollection` a *otra* colección. -De esta manera puedes construir un árbol de rutas. Además, puedes definir un prefijo, los requisitos predeterminados y las opciones predefinidas para todas las rutas de un subárbol: - -.. code-block:: php - - $rootCollection = new RouteCollection(); - - $subCollection = new RouteCollection(); - $subCollection->add(...); - $subCollection->add(...); - - $rootCollection->addCollection($subCollection, '/prefix', array('_scheme' => 'https')); - -Configurando los parámetros de la Petición -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\Routing\\RequestContext` proporciona información sobre la ``petición`` actual. Puedes definir todos los parámetros de una ``petición`` *HTTP* con esta clase a través de su constructor: - -.. code-block:: php - - public function __construct($baseUrl = '', $method = 'GET', $host = 'localhost', $scheme = 'http', $httpPort = 80, $httpsPort = 443) - -.. _components-routing-http-foundation: - -Normalmente puedes pasar los valores de la variable ``$_SERVER`` para poblar la :class:`Symfony\\Component\\Routing\\RequestContext`. Pero si utilizas el componente :doc:`HttpFoundation , puedes utilizar su :class:`Symfony\\Component\\HttpFoundation\\Request` para alimentar el :class:`Symfony\\Component\\Routing\\RequestContext` en un método abreviado:: - - use Symfony\Component\HttpFoundation\Request; - - $context = new RequestContext(); - $context->fromRequest(Request::createFromGlobals()); - -Generando una URL -~~~~~~~~~~~~~~~~~ - -Si bien la :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher` trata de encontrar una ruta que se adapte a la petición dada, esta también puede construir una *URL* a partir de una ruta determinada: - -.. code-block:: php - - use Symfony\Component\Routing\Generator\UrlGenerator; - - $routes = new RouteCollection(); - $routes->add('show_post', new Route('/show/{slug}')); - - $context = new RequestContext($_SERVER['REQUEST_URI']); - - $generator = new UrlGenerator($routes, $context); - - $url = $generator->generate('show_post', array( - 'slug' => 'my-blog-post' - )); - // /show/my-blog-post - -.. note:: - - Si has definido el requisito ``_scheme``, se genera una *URL* absoluta si el esquema del :class:`Symfony\\Component\\Routing\\RequestContext` actual no coincide con el requisito. - -Cargando rutas desde un archivo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ya hemos visto lo fácil que es añadir rutas a una colección dentro de *PHP*. Pero también puedes cargar rutas de una serie de archivos diferentes. - -El componente de enrutado viene con una serie de clases cargadoras, cada una dotándote de la capacidad para cargar una colección de definiciones de ruta desde un archivo externo en algún formato. -Cada cargador espera una instancia del :class:`Symfony\\Component\\Config\\FileLocator` como argumento del constructor. Puedes utilizar el :class:`Symfony\\Component\\Config\\FileLocator` para definir una serie de rutas en las que el cargador va a buscar los archivos solicitados. -Si se encuentra el archivo, el cargador devuelve una :class:`Symfony\\Component\\Routing\\RouteCollection`. - -Si estás usando el ``YamlFileLoader``, entonces las definiciones de ruta tienen este aspecto: - -.. code-block:: yaml - - # routes.yml - route1: - pattern: /foo - defaults: { controller: 'MyController::fooAction' } - - route2: - pattern: /foo/bar - defaults: { controller: 'MyController::foobarAction' } - -Para cargar este archivo, puedes utilizar el siguiente código. Este asume que tu archivo :file:`routes.yml` está en el mismo directorio que el código de abajo: - -.. code-block:: php - - use Symfony\Component\Config\FileLocator; - use Symfony\Component\Routing\Loader\YamlFileLoader; - - // busca dentro de *este* directorio - $locator = new FileLocator(array(__DIR__)); - $loader = new YamlFileLoader($locator); - $collection = $loader->load('routes.yml'); - -Además del :class:`Symfony\\Component\\Routing\\Loader\\YamlFileLoader` hay otros dos cargadores que funcionan de manera similar: - -* :class:`Symfony\\Component\\Routing\\Loader\\XmlFileLoader` -* :class:`Symfony\\Component\\Routing\\Loader\\PhpFileLoader` - -Si utilizas el :class:`Symfony\\Component\\Routing\\Loader\\PhpFileLoader` debes proporcionar el nombre del un archivo *php* que devuelva una :class:`Symfony\\Component\\Routing\\RouteCollection`: - -.. code-block:: php - - // ProveedorDeRuta.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('route_name', new Route('/foo', array('controller' => 'ExampleController'))); - // ... - - return $collection; - -Rutas como cierres -.................. - -También está el :class:`Symfony\\Component\\Routing\\Loader\\ClosureLoader`, que -llama a un cierre y utiliza el resultado como una :class:`Symfony\\Component\\Routing\\RouteCollection`: - -.. code-block:: php - - use Symfony\Component\Routing\Loader\ClosureLoader; - - $closure = function() { - return new RouteCollection(); - }; - - $loader = new ClosureLoader(); - $collection = $loader->load($closure); - -Rutas como anotaciones -...................... - -Por último, pero no menos importante, están las :class:`Symfony\\Component\\Routing\\Loader\\AnnotationDirectoryLoader` y :class:`Symfony\\Component\\Routing\\Loader\\AnnotationFileLoader` para cargar -definiciones de ruta a partir de las anotaciones de la clase. Los detalles específicos se dejan aquí. - -El ruteador todo en uno -~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\Routing\\Router` es un paquete todo en uno para utilizar rápidamente el componente de enrutado. El constructor espera una instancia del cargador, una ruta a la definición de la ruta principal y algunas otras opciones: - -.. code-block:: php - - public function __construct(LoaderInterface $loader, $resource, array $options = array(), RequestContext $context = null, array $defaults = array()); - -Con la opción ``cache_dir`` puedes habilitar la caché de enrutado (si proporcionas una ruta) o desactivar el almacenamiento en caché (si la configuras a ``null``). El almacenamiento en caché automáticamente se hace en segundo plano si lo quieres usar. Un ejemplo básico de la clase :class:`Symfony\\Component\\Routing\\Router` se vería así: - -.. code-block:: php - - $locator = new FileLocator(array(__DIR__)); - $requestContext = new RequestContext($_SERVER['REQUEST_URI']); - - $router = new Router( - new YamlFileLoader($locator), - "routes.yml", - array('cache_dir' => __DIR__.'/cache'), - $requestContext, - ); - $router->match('/foo/bar'); - -.. note:: - - Si utilizas el almacenamiento en caché, el componente ``Routing`` compilará las nuevas clases guardándolas en ``cache_dir``. Esto significa que el archivo debe tener permisos de escritura en esa ubicación. diff --git a/_sources/components/routing/hostname_pattern.txt b/_sources/components/routing/hostname_pattern.txt deleted file mode 100644 index ab75a79..0000000 --- a/_sources/components/routing/hostname_pattern.txt +++ /dev/null @@ -1,160 +0,0 @@ -.. index:: - single: Enrutando; Reconociendo el nombre del servidor - -Cómo emparejar una ruta basándose en el servidor -================================================ - -.. versionadded:: 2.2 - El soporte necesario para emparejar con el servidor se añadió en *Symfony* 2.2 - -También puedes emparejar con el *host* *HTTP* de la petición entrante. - -.. configuration-block:: - - .. code-block:: yaml - - mobile_homepage: - path: / - host: m.example.com - defaults: { _controller: AcmeDemoBundle:Main:mobileHomepage } - - homepage: - path: / - defaults: { _controller: AcmeDemoBundle:Main:homepage } - - .. code-block:: xml - - - - - - - AcmeDemoBundle:Main:mobileHomepage - - - - AcmeDemoBundle:Main:homepage - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('mobile_homepage', new Route('/', array( - '_controller' => 'AcmeDemoBundle:Main:mobileHomepage', - ), array(), array(), 'm.example.com')); - - $collection->add('homepage', new Route('/', array( - '_controller' => 'AcmeDemoBundle:Main:homepage', - ))); - - return $collection; - -Ambas rutas emparejan con la misma ruta ``/``, aun así la primera sólo emparejará si el servidor es ``m.example.com``. - -Marcadores de posición y requisitos en patrones de nombre del servidor ----------------------------------------------------------------------- - -Si estás utilizando el :doc:`componente DependencyInjection ` (o la plataforma *Symfony2* en su totalidad), entonces puedes utilizar los :ref:`parámetros del contenedor de servicios ` como variables en cualquier lugar en tus rutas. - -Puedes evitar codificar el nombre de dominio usando un marcador de posición y un requisito. -El ``%domain%`` en los requisitos se sustituye por el valor del parámetro ``domain`` en el contenedor de inyección de dependencias. - -.. configuration-block:: - - .. code-block:: yaml - - mobile_homepage: - path: / - host: m.{domain} - defaults: { _controller: AcmeDemoBundle:Main:mobileHomepage } - requirements: - domain: %domain% - - homepage: - path: / - defaults: { _controller: AcmeDemoBundle:Main:homepage } - - .. code-block:: xml - - - - - - - AcmeDemoBundle:Main:mobileHomepage - %domain% - - - - AcmeDemoBundle:Main:homepage - - - - .. code-block:: php - - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add('mobile_homepage', new Route('/', array( - '_controller' => 'AcmeDemoBundle:Main:mobileHomepage', - ), array( - 'domain' => '%domain%', - ), array(), 'm.{domain}')); - - $collection->add('homepage', new Route('/', array( - '_controller' => 'AcmeDemoBundle:Main:homepage', - ))); - - return $collection; - -.. _component-routing-host-imported: - -Añadiendo un servidor a la expresión regular de las rutas importadas --------------------------------------------------------------------- - -Puedes poner una expresión regular para el servidor en las rutas importadas: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - acme_hello: - resource: "@AcmeHelloBundle/Resources/config/routing.yml" - host: "hello.example.com" - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/routing.php - use Symfony\Component\Routing\RouteCollection; - - $collection = new RouteCollection(); - $collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"), '', array(), array(), array(), 'hello.example.com'); - - return $collection; - -El servidor ``hello.example.com`` será puesto en cada ruta cargada desde el nuevo recurso -de enrutado. diff --git a/_sources/components/routing/index.txt b/_sources/components/routing/index.txt deleted file mode 100644 index 9daa4c7..0000000 --- a/_sources/components/routing/index.txt +++ /dev/null @@ -1,8 +0,0 @@ -Enrutando -========= - -.. toctree:: - :maxdepth: 2 - - introduction - hostname_pattern diff --git a/_sources/components/routing/introduction.txt b/_sources/components/routing/introduction.txt deleted file mode 100644 index 3af3d9c..0000000 --- a/_sources/components/routing/introduction.txt +++ /dev/null @@ -1,289 +0,0 @@ -.. index:: - single: Enrutando - single: Componentes; Routing - -El componente ``Routing`` -========================= - - El componente ``Routing`` asocia una ``Petición`` *HTTP* a un conjunto de variables de configuración. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Routing); -* :doc:`Instalándolo vía Composer ` (``symfony/routing`` en `Packagist`_). - -Usando ------- - -Con el fin de establecer un sistema de enrutado básico necesitas tres partes: - -* Una clase :class:`Symfony\\Component\\Routing\\RouteCollection`, que contiene las definiciones de las rutas (instancias de la clase :class:`Symfony\\Component\\Routing\\Route`) -* Una clase :class:`Symfony\\Component\\Routing\\RequestContext`, que contiene información sobre la petición -* Una clase :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher`, que realiza la asignación de la petición a una sola ruta - -Veamos un ejemplo rápido. Ten en cuenta que esto supone que ya has configurado el cargador automático para cargar el componente ``Routing``:: - - use Symfony\Component\Routing\Matcher\UrlMatcher; - use Symfony\Component\Routing\RequestContext; - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $route = new Route('/foo', array('controller' => 'MyController')); - $routes = new RouteCollection(); - $routes->add('route_name', $route); - - $context = new RequestContext($_SERVER['REQUEST_URI']); - - $matcher = new UrlMatcher($routes, $context); - - $parameters = $matcher->match('/foo'); - // array('controller' => 'MyController', '_route' => 'route_name') - -.. note:: - - Ten cuidado al usar ``$_SERVER['REQUEST_URI']``, ya que este puede incluir los parámetros de consulta en la URL, lo cual causará problemas con la ruta coincidente. Una manera fácil de solucionar esto es usando el componente ``HTTPFoundation`` como se explica :ref:`abajo `. - -Puedes agregar tantas rutas como quieras a una clase :class:`Symfony\\Component\\Routing\\RouteCollection`. - -El método :method:`RouteCollection::add()` toma dos argumentos. El primero es el nombre de la ruta. El segundo es un objeto :class:`Symfony\\Component\\Routing\\Route`, que espera una ruta *URL* y algún arreglo de variables personalizadas en su constructor. Este arreglo de variables personalizadas puede ser *cualquier cosa* que tenga significado para tu aplicación, y es devuelto cuando dicha ruta corresponda. - -Si no hay ruta coincidente debe lanzar una :class:`Symfony\\Component\\Routing\\Exception\\ResourceNotFoundException`. - -Además de tu arreglo de variables personalizadas, se añade una clave ``_route``, que contiene el nombre de la ruta buscada. - -Definiendo rutas -~~~~~~~~~~~~~~~~ - -Una definición de ruta completa puede contener hasta siete partes: - -1. El trayecto a la *URL* de la ruta. Este se compara con la *URL* pasada al ``RequestContext``, y puede contener comodines marcadores de posición nombrados (por ejemplo, ``{placeholders}``) para que coincidan con elementos dinámicos en la *URL*. - -2. Un arreglo de valores predeterminados. Esta contiene un conjunto de valores arbitrarios que serán devueltos cuando la petición coincida con la ruta. - -3. Un arreglo de requisitos. Estos definen las restricciones para los valores de los marcadores de posición como las expresiones regulares. - -4. Un arreglo de opciones. Estas contienen la configuración interna de la ruta y comúnmente son las menos necesarias. - -5. Un servidor. Este se empareja contra el servidor de la petición. Ve :doc:`/components/routing/hostname_pattern` para más detalles. - -6. Un arreglo de esquemas. Estos imponen un determinado esquema *HTTP* (``http``, ``https``). - -7. Un arreglo de métodos. Estos fuerzan un determinado método de petición *HTTP* (``HEAD``, ``GET``, ``POST``, ...). - -.. versionadded:: 2.2 - El soporte necesario para emparejar con el servidor se añadió en *Symfony* 2.2 - -Veamos la siguiente ruta, que combina varias de estas ideas:: - - $route = new Route( - '/archive/{month}', // ruta - array('controller' => 'showArchive'), // valores predefinidos - array('month' => '[0-9]{4}-[0-9]{2}', 'subdomain' => 'www|m'), // requisitos - array(), // opciones - '{subdomain}.example.com', // servidor - array(), // esquemas - array() // métodos - ); - - // ... - - $parameters = $matcher->match('/archive/2012-01'); - // array( - // 'controller' => 'showArchive', - // 'month' => '2012-01', - // 'subdomain' => 'www', - // '_route' => ... - // ) - - $parameters = $matcher->match('/archive/foo'); - // lanza la ResourceNotFoundException - -En este caso, la ruta coincide con ``/archive/2012-01``, porque el comodín ``{month}`` coincide con el comodín de la expresión regular suministrada. Sin embargo, ``/archive/f oo`` *no* coincide, porque el comodín del mes «foo» no concuerda. - -.. tip:: - - Si quieres hacer coincidir todas las *URL* que comiencen con una cierta ruta y terminan en un sufijo arbitrario puedes utilizar la siguiente definición de ruta:: - - $route = new Route( - '/start/{suffix}', - array('suffix' => ''), - array('suffix' => '.*') - ); - -Usando prefijos -~~~~~~~~~~~~~~~ - -Puedes agregar rutas u otras instancias de :class:`Symfony\\Component\\Routing\\RouteCollection` a *otra* colección. -De esta manera puedes construir un árbol de rutas. Además, puedes definir un prefijo, requisitos predeterminados, opciones predefinidas y servidores a todas las rutas de un subárbol con el método :method:`Symfony\\Component\\Routing\\RouteCollection::addPrefix`:: - - $rootCollection = new RouteCollection(); - - $subCollection = new RouteCollection(); - $subCollection->add(...); - $subCollection->add(...); - $subCollection->addPrefix( - '/prefix', // prefijo - array(), // requisitos - array(), // opciones - 'admin.example.com', // servidor - array('https') // esquemas - ); - - $rootCollection->addCollection($subCollection); - -.. versionadded:: 2.2 - El método ``addPrefix`` se añadió en *Symfony* 2.2. Este era parte del método ``addCollection`` en versiones anteriores. - -Configurando los parámetros de la Petición -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\Routing\\RequestContext` proporciona información sobre la ``Petición`` actual. Puedes definir todos los parámetros de una ``Petición`` *HTTP* con esta clase a través de su constructor:: - - public function __construct( - $baseUrl = '', - $method = 'GET', - $host = 'localhost', - $scheme = 'http', - $httpPort = 80, - $httpsPort = 443 - ) - -.. _components-routing-http-foundation: - -Normalmente puedes pasar los valores de la variable ``$_SERVER`` para poblar la :class:`Symfony\\Component\\Routing\\RequestContext`. Pero si utilizas el componente :doc:`HttpFoundation `, puedes utilizar su clase :class:`Symfony\\Component\\HttpFoundation\\Request` para alimentar al :class:`Symfony\\Component\\Routing\\RequestContext` en un método abreviado:: - - use Symfony\Component\HttpFoundation\Request; - - $context = new RequestContext(); - $context->fromRequest(Request::createFromGlobals()); - -Generando una URL -~~~~~~~~~~~~~~~~~ - -Si bien la :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher` trata de encontrar una ruta que se adapte a la petición dada, esta también puede construir una *URL* a partir de una ruta determinada:: - - use Symfony\Component\Routing\Generator\UrlGenerator; - - $routes = new RouteCollection(); - $routes->add('show_post', new Route('/show/{slug}')); - - $context = new RequestContext($_SERVER['REQUEST_URI']); - - $generator = new UrlGenerator($routes, $context); - - $url = $generator->generate('show_post', array( - 'slug' => 'my-blog-post', - )); - // /show/my-blog-post - -.. note:: - - Si definiste un esquema, se genera una *URL* absoluta si el esquema de la clase :class:`Symfony\\Component\\Routing\\RequestContext` actual no concuerda con el requisito. - -Cargando rutas desde un archivo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ya hemos visto lo fácil que es añadir rutas a una colección dentro de *PHP*. Pero también puedes cargar rutas de una serie de archivos diferentes. - -El componente de enrutado viene con una serie de clases cargadoras, cada una dotándote de la capacidad para cargar una colección de definiciones de ruta desde un archivo externo en algún formato. -Cada cargador espera una instancia del :class:`Symfony\\Component\\Config\\FileLocator` como argumento del constructor. Puedes utilizar el :class:`Symfony\\Component\\Config\\FileLocator` para definir una serie de rutas en las que el cargador va a buscar los archivos solicitados. -Si se encuentra el archivo, el cargador devuelve una :class:`Symfony\\Component\\Routing\\RouteCollection`. - -Si estás usando el ``YamlFileLoader``, entonces las definiciones de ruta tienen este aspecto: - -.. code-block:: yaml - - # routes.yml - route1: - path: /foo - defaults: { _controller: 'MyController::fooAction' } - - route2: - path: /foo/bar - defaults: { _controller: 'MyController::foobarAction' } - -Para cargar este archivo, puedes utilizar el siguiente código. Este asume que tu archivo :file:`routes.yml` está en el mismo directorio que el código de abajo:: - - use Symfony\Component\Config\FileLocator; - use Symfony\Component\Routing\Loader\YamlFileLoader; - - // busca dentro de *este* directorio - $locator = new FileLocator(array(__DIR__)); - $loader = new YamlFileLoader($locator); - $collection = $loader->load('routes.yml'); - -Además del :class:`Symfony\\Component\\Routing\\Loader\\YamlFileLoader` hay otros dos cargadores que funcionan de manera similar: - -* :class:`Symfony\\Component\\Routing\\Loader\\XmlFileLoader` -* :class:`Symfony\\Component\\Routing\\Loader\\PhpFileLoader` - -Si utilizas el :class:`Symfony\\Component\\Routing\\Loader\\PhpFileLoader` debes proporcionar el nombre del un archivo *php* que devuelva una :class:`Symfony\\Component\\Routing\\RouteCollection`:: - - // ProveedorDeRuta.php - use Symfony\Component\Routing\RouteCollection; - use Symfony\Component\Routing\Route; - - $collection = new RouteCollection(); - $collection->add( - 'route_name', - new Route('/foo', array('controller' => 'ExampleController')) - ); - // ... - - return $collection; - -Rutas como cierres -.................. - -También está el :class:`Symfony\\Component\\Routing\\Loader\\ClosureLoader`, que -llama a un cierre y utiliza el resultado como una :class:`Symfony\\Component\\Routing\\RouteCollection`:: - - use Symfony\Component\Routing\Loader\ClosureLoader; - - $closure = function() { - return new RouteCollection(); - }; - - $loader = new ClosureLoader(); - $collection = $loader->load($closure); - -Rutas como anotaciones -...................... - -Por último, pero no menos importante, están las :class:`Symfony\\Component\\Routing\\Loader\\AnnotationDirectoryLoader` y :class:`Symfony\\Component\\Routing\\Loader\\AnnotationFileLoader` para cargar -definiciones de ruta a partir de las anotaciones de la clase. Los detalles específicos se dejan aquí. - -El ruteador todo en uno -~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\Routing\\Router` es un paquete todo en uno para utilizar rápidamente el componente de enrutado. El constructor espera una instancia del cargador, una ruta a la definición de la ruta principal y algunas otras opciones:: - - public function __construct( - LoaderInterface $loader, - $resource, - array $options = array(), - RequestContext $context = null, - array $defaults = array() - ); - -Con la opción ``cache_dir`` puedes habilitar la caché de enrutado (si proporcionas una ruta) o desactivar el almacenamiento en caché (si la configuras a ``null``). El almacenamiento en caché automáticamente se hace en segundo plano si lo quieres usar. Un ejemplo básico de la clase :class:`Symfony\\Component\\Routing\\Router` se vería así:: - - $locator = new FileLocator(array(__DIR__)); - $requestContext = new RequestContext($_SERVER['REQUEST_URI']); - - $router = new Router( - new YamlFileLoader($locator), - 'routes.yml', - array('cache_dir' => __DIR__.'/cache'), - $requestContext - ); - $router->match('/foo/bar'); - -.. note:: - - Si utilizas el almacenamiento en caché, el componente ``Routing`` compilará las nuevas clases guardándolas en ``cache_dir``. Esto significa que el archivo debe tener permisos de escritura en esa ubicación. - -.. _`Packagist`: https://packagist.org/packages/symfony/routing diff --git a/_sources/components/security/authentication.txt b/_sources/components/security/authentication.txt deleted file mode 100644 index 323f336..0000000 --- a/_sources/components/security/authentication.txt +++ /dev/null @@ -1,180 +0,0 @@ -.. index:: - single: Seguridad, autenticación - -Autenticación -============= - -Cuándo una petición apunta a una área protegida, y uno de los escuchas del -cortafuegos asociado es capaz de extraer las credenciales del usuario desde el objeto :class:`Symfony\\Component\\HttpFoundation\\Request` actual, este debe crear una ficha conteniendo estas credenciales. Lo siguiente que el escucha debería hacer es consultar al gestor de autenticación para validar la ficha dada, y regresar una ficha *autenticada* si resulta que las credenciales suministradas son válidas. -El escucha entonces debería almacenar la ficha autenticada en el contexto de seguridad:: - - use Symfony\Component\Security\Http\Firewall\ListenerInterface; - use Symfony\Component\Security\Core\SecurityContextInterface; - use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface; - use Symfony\Component\HttpKernel\Event\GetResponseEvent; - use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken; - - class SomeAuthenticationListener implements ListenerInterface - { - /** - * @var SecurityContextInterface - */ - private $securityContext; - - /** - * @var AuthenticationManagerInterface - */ - private $authenticationManager; - - /** - * @var string Uniquely identifies the secured area - */ - private $providerKey; - - // ... - - public function handle(GetResponseEvent $event) - { - $request = $event->getRequest(); - - $username = ...; - $password = ...; - - $unauthenticatedToken = new UsernamePasswordToken( - $username, - $password, - $this->providerKey - ); - - $authenticatedToken = $this - ->authenticationManager - ->authenticate($unauthenticatedToken); - - $this->securityContext->setToken($authenticatedToken); - } - } - -.. note:: - - Una ficha puede ser cualquier clase, siempre y cuando implemente la interfaz :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface`. - -El gestor de autenticación --------------------------- - -El gestor de autenticación predefinido es una instancia de la clase :class:`Symfony\\Component\\Security\\Core\\Authentication\\AuthenticationProviderManager`:: - - use Symfony\Component\Security\Core\Authentication\AuthenticationProviderManager; - - // instancias de Symfony\Component\Security\Core\Authentication\AuthenticationProviderInterface - $providers = array(...); - - $authenticationManager = new AuthenticationProviderManager($providers); - - try { - $authenticatedToken = $authenticationManager - ->authenticate($unauthenticatedToken); - } catch (AuthenticationException $failed) { - // falló la autenticación - } - -El ``AuthenticationProviderManager``, al crear una instancia, recibe varios proveedores de autenticación, cada uno compatible a un diferente tipo de señal. - -.. note:: - - Por supuesto, puedes escribir tu propio gestor de autenticación, sólo tienes que implementar la :class:`Symfony\\Component\\Security\\Core\\Authentication\\AuthenticationManagerInterface`. - -.. _authentication_providers: - -Proveedores de autenticación ----------------------------- - -Cada proveedor (debido a que implementan la clase :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface`) tiene un método :method:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface::supports` por medio del cual el ``AuthenticationProviderManager`` puede determinar si es compatible con la ficha dada. Si este es el caso, el gestor, entonces llama al método :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\AuthenticationProviderInterface::authenticate` del proveedor -. -Este método debe devolver una ficha autenticada o lanzar una :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException` (o cualquier otra excepción que extienda esta). - -Autenticando usuarios por nombre de usuario y contraseña -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Un proveedor de autenticación intentará autenticar a un usuario basándose en las credenciales que él proporcionó. Generalmente, se trata de un nombre de usuario y una contraseña. -La mayoría de las aplicaciones *web* guardan el nombre de usuario y una codificación de la contraseña del usuario combinada con una «sal» generada aleatoriamente. Esto significa que la autenticación promedio consistirá en recuperar la sal y la contraseña codificada del almacén de datos del usuario, la contraseña codificada del usuario es proporcionada (por ejemplo, utilizando un formulario de inicio de sesión) con la sal y comparando ambas para determinar si la contraseña dada es válida. - -Esta funcionalidad es ofrecida por el :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider`. -Esta recupera los datos del usuario a partir de una :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`, utilizando una :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface` para crear la codificación de la contraseña y devolver una ficha autenticada si la contraseña es válida:: - - use Symfony\Component\Security\Core\Authentication\Provider\DaoAuthenticationProvider; - use Symfony\Component\Security\Core\User\UserChecker; - use Symfony\Component\Security\Core\User\InMemoryUserProvider; - use Symfony\Component\Security\Core\Encoder\EncoderFactory; - - $userProvider = new InMemoryUserProvider( - array( - 'admin' => array( - // password is "foo" - 'password' => '5FZ2Z8QIkA7UTZ4BYkoC+GsReLf569mSKDsfods6LYQ8t+a8EW9oaircfMpmaLbPBh4FOBiiFyLfuZmTSUwzZg==', - 'roles' => array('ROLE_ADMIN'), - ), - ) - ); - - // para alguna comprobación extra: ¿la cuenta está habilitada, cerrada, expirada, etc.? - $userChecker = new UserChecker(); - - // un arreglo de codificadores de contraseña (ve abajo) - $encoderFactory = new EncoderFactory(...); - - $provider = new DaoAuthenticationProvider( - $userProvider, - $userChecker, - 'secured_area', - $encoderFactory - ); - - $provider->authenticate($unauthenticatedToken); - -.. note:: - - El ejemplo anterior demuestra el uso del proveedor de usuarios «en memoria», pero puedes utilizar cualquier proveedor de usuario, siempre y cuando implemente la :class:`Symfony\\Component\\Security\\Core\\User\\UserProviderInterface`. - También es posible permitir que múltiples proveedores de usuario intenten encontrar los datos del usuario, utilizando la :class:`Symfony\\Component\\Security\\Core\\User\\ChainUserProvider`. - -La factoría codificadora de contraseñas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\Security\\Core\\Authentication\\Provider\\DaoAuthenticationProvider` utiliza una factoría codificadora para crear una contraseña codificada para un determinado tipo de usuario. Esto te permite utilizar diferentes estrategias de codificado para diferentes tipos de usuario. La clase :class:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderFactory` recibe un arreglo de codificadores:: - - use Symfony\Component\Security\Core\Encoder\EncoderFactory; - use Symfony\Component\Security\Core\Encoder\MessageDigestPasswordEncoder; - - $defaultEncoder = new MessageDigestPasswordEncoder('sha512', true, 5000); - $weakEncoder = new MessageDigestPasswordEncoder('md5', true, 1); - - $encoders = array( - 'Symfony\\Component\\Security\\Core\\User\\User' => $defaultEncoder, - 'Acme\\Entity\\LegacyUser' => $weakEncoder, - - // ... - ); - - $encoderFactory = new EncoderFactory($encoders); - -Cada codificador debería implementar la :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface` o ser un arreglo con una clave ``class`` y ``arguments``, lo cual permite a la factoría codificadora construir el codificador sólo cuándo es necesario. - -Codificadores de contraseña -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuándo invocas al método :method:`Symfony\\Component\\Security\\Core\\Encoder\\EncoderFactory::getEncoder` de la factoría codificadora de contraseñas con el objeto ``usuario`` como primer argumento, regresa un codificador de tipo :class:`Symfony\\Component\\Security\\Core\\Encoder\\PasswordEncoderInterface` el cuál deberías usar para codificar la contraseña de ese usuario:: - - // recupera un usuario de tipo Acme\Entity\LegacyUser - $user = ... - - $encoder = $encoderFactory->getEncoder($user); - - // debe regresar $weakEncoder (ve arriba) - - $encodedPassword = $encoder->encodePassword($password, $user->getSalt()); - - // comprueba si la contraseña es válida: - - $validPassword = $encoder->isPasswordValid( - $user->getPassword(), - $password, - $user->getSalt()); diff --git a/_sources/components/security/authorization.txt b/_sources/components/security/authorization.txt deleted file mode 100644 index 375ce81..0000000 --- a/_sources/components/security/authorization.txt +++ /dev/null @@ -1,189 +0,0 @@ -.. index:: - single: Seguridad, autorización - -Autorización -============ - -Cuando alguno de los proveedores de autenticación (ve :ref:`authentication_providers`) ha verificado la ficha no autenticada aún, devolverá una ficha autenticada. El escucha debe configurar la autenticación de esta ficha directamente en la :class:`Symfony\\Component\\Security\\Core\\SecurityContextInterface` utilizando su método :method:`Symfony\\Component\\Security\\Core\\SecurityContextInterface::setToken`. - -A partir de ahí, el usuario está autenticado, es decir, identificado. Ahora, otras partes de la aplicación pueden utilizar la ficha para decidir si o no el usuario puede solicitar una determinada *URI*, o modificar un determinado objeto. Esta decisión la tomará una instancia de la :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManagerInterface`. - -Una decisión de autorización siempre se basará en un par de cosas: - -* La ficha actual - Por ejemplo, puedes utilizar el método :method:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface::getRoles` de la ficha para recuperar las funciones del usuario actual (por ejemplo, ``ROLE_SUPER_ADMIN``), o una decisión puede estar basada en la clase de la ficha. -* Un conjunto de atributos - Cada atributo representa un determinado derecho que el usuario debe tener, por ejemplo, ``ROLE_ADMIN`` para asegurarse de que el usuario es un administrador. -* Un objeto (opcional) - Cualquier objeto con el cual controlar el acceso necesario, como un artículo o un objeto ``Comentario``. - -Gestor de la decisión de acceso -------------------------------- - -Debido que decidir si un usuario está autorizado a realizar una cierta acción puede ser un proceso complicado, la clase :class:`Symfony\\Component\\Security\\Core\\Authorization\\AccessDecisionManager` estándar en sí misma depende de varios votantes, y hace un veredicto final basándose en todos los votos (positivos, negativos o neutros) que ha recibido. Este reconoce varias estrategias: - -* ``affirmative`` (predeterminada) - concede acceso tan pronto como cualquier votante devuelve una respuesta afirmativa; - -* ``consensus`` - concede acceso si son más los votantes que garantizan el acceso de los que lo niegan; - -* ``unanimous`` - permiten el acceso sólo si ninguno de los votantes niega el acceso; - -.. code-block:: php - - use Symfony\Component\Security\Core\Authorization\AccessDecisionManager; - - // instancias de - // Symfony\Component\Security\Core\Authorization\Voter\VoterInterface - $voters = array(...); - - // uno de "affirmative", "consensus", "unanimous" - $strategy = ...; - - // si o no conceder acceso cuando todos los votantes se abstienen - $allowIfAllAbstainDecisions = ...; - - // Si o no conceder el acceso cuándo no hay mayoría - // (aplica sólo a la estrategia de consenso) - $allowIfEqualGrantedDeniedDecisions = ...; - - $accessDecisionManager = new AccessDecisionManager( - $voters, - $strategy, - $allowIfAllAbstainDecisions, - $allowIfEqualGrantedDeniedDecisions - ); - -Votantes --------- - -Los votantes son instancias -de :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface`, lo cual significa que tienen que implementar algunos métodos que permiten los utilice el gestor de decisión: - -* ``supportsAttribute($attribute)`` - se utiliza para comprobar si el votante sabe cómo manejar el atributo dado; - -* ``supportsClass($class)`` - se utiliza para comprobar si el votante es capaz de conceder o denegar el acceso a un objeto de la clase dada; - -* ``vote(TokenInterface $token, $object, array $attributes)`` - Este método hará la votación propiamente dicha y devuelve un valor igual a una de las constantes de la clase :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\VoterInterface`, es decir, ``VoterInterface::ACCESS_GRANTED``, ``VoterInterface::ACCESS_DENIED`` o ``VoterInterface::ACCESS_ABSTAIN``; - -El componente de seguridad contiene algunos votantes estándar que cubren muchos casos de uso: - -``AuthenticatedVoter`` -~~~~~~~~~~~~~~~~~~~~~~ - -La clase votante :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\AuthenticatedVoter` admite los atributos ``IS_AUTHENTICATED_FULLY``, ``IS_AUTHENTICATED_REMEMBERED``, e ``IS_AUTHENTICATED_ANONYMOUSLY`` y garantiza el acceso basado en el nivel de autenticación actual, es decir, ¿el usuario está autenticado completamente, o sólo en base a una ``galleta`` «recuérdame», o incluso autenticado anónimamente? - -.. code-block:: php - - use Symfony\Component\Security\Core\Authentication\AuthenticationTrustResolver; - - $anonymousClass = 'Symfony\Component\Security\Core\Authentication\Token\AnonymousToken'; - $rememberMeClass = 'Symfony\Component\Security\Core\Authentication\Token\RememberMeToken'; - - $trustResolver = new AuthenticationTrustResolver($anonymousClass, $rememberMeClass); - - $authenticatedVoter = new AuthenticatedVoter($trustResolver); - - // instancia de Symfony\Component\Security\Core\Authentication\Token\TokenInterface - $token = ...; - - // algún objeto - $object = ...; - - $vote = $authenticatedVoter->vote($token, $object, array('IS_AUTHENTICATED_FULLY'); - -``RoleVoter`` -~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\RoleVoter` es compatible con atributos que empiezan con ``ROLE_`` y conceden acceso al usuario cuándo todos los atributos ``ROLE_*`` requeridos se pueden encontrar en el arreglo de roles devuelto por el método :method:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\TokenInterface::getRoles`:: - - use Symfony\Component\Security\Core\Authorization\Voter\RoleVoter; - - $roleVoter = new RoleVoter('ROLE_'); - - $roleVoter->vote($token, $object, 'ROLE_ADMIN'); - -``RoleHierarchyVoter`` -~~~~~~~~~~~~~~~~~~~~~~ - -La clase :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\RoleHierarchyVoter` extiende a :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\RoleVoter` y proporciona alguna funcionalidad adicional: Esta sabe cómo manejar una jerarquía de roles. Por ejemplo, un rol ``ROLE_SUPER_ADMIN`` puede tener los subroles ``ROLE_ADMIN`` y ``ROLE_USER``, de modo que cuando un determinado objeto requiere que el usuario tenga el rol ``ROLE_ADMIN``, concede acceso a usuarios que de hecho tienen el rol ``ROLE_ADMIN``, pero también a usuarios que tienen el rol ``ROLE_SUPER_ADMIN``:: - - use Symfony\Component\Security\Core\Authorization\Voter\RoleHierarchyVoter; - use Symfony\Component\Security\Core\Role\RoleHierarchy; - - $hierarchy = array( - 'ROLE_SUPER_ADMIN' => array('ROLE_ADMIN', 'ROLE_USER'), - ); - - $roleHierarchy = new RoleHierarchy($hierarchy); - - $roleHierarchyVoter = new RoleHierarchyVoter($roleHierarchy); - -.. note:: - - Cuándo haces tu propio votante, naturalmente puedes utilizar su constructor para inyectar cualquier dependencia necesaria para tomar una decisión. - -Roles ------ - -Los roles son objetos que expresan un determinado derecho que tiene el usuario. -El único requisito es que implementen la :class:`Symfony\\Component\\Security\\Core\\Role\\RoleInterface`, lo cual significa también que deberían tener un método :method:`Symfony\\Component\\Security\\Core\\Role\\Role\\RoleInterface::getRole` que regrese una cadena representando su rol. La clase :class:`Symfony\\Component\\Security\\Core\\Role\\Role` simplemente devuelve el primer argumento del constructor:: - - use Symfony\Component\Security\Core\Role\Role; - - $role = new Role('ROLE_ADMIN'); - - // hará eco de 'ROLE_ADMIN' - echo $role->getRole(); - -.. note:: - - La mayoría de las fichas de autenticación extienden la clase :class:`Symfony\\Component\\Security\\Core\\Authentication\\Token\\AbstractToken`, lo cual significa que los roles dados a su constructor serán convertidos automáticamente de cadenas a estos sencillos objetos ``Role``. - -Usando el gestor de decisión ----------------------------- - -El escucha de acceso -~~~~~~~~~~~~~~~~~~~~ - -El gestor de decisión de acceso se puede utilizar en cualquier punto en una petición para decidir si o no el usuario actual tiene derecho para acceder a un determinado recurso. Un opcional ---pero útil--- método para restringir el acceso basándose en un patrón de *URL* es el :class:`Symfony\\Component\\Security\\Http\\Firewall\\AccessListener`, el cual es uno de los escuchas del cortafuegos (ve :ref:`firewall_listeners`) que es lanzado en cada petición que coincide con el cortafuegos asociado (ve :ref:`firewall`). - -Este utiliza un mapa de acceso (el cuál debería ser una instancia de la :class:`Symfony\\Component\\Security\\Http\\AccessMapInterface`) que contiene la petición y el conjunto de atributos correspondiente necesarios para que el usuario actual consiga acceso a la aplicación:: - - use Symfony\Component\Security\Http\AccessMap; - use Symfony\Component\HttpFoundation\RequestMatcher; - use Symfony\Component\Security\Http\Firewall\AccessListener; - - $accessMap = new AccessMap(); - $requestMatcher = new RequestMatcher('^/admin'); - $accessMap->add($requestMatcher, array('ROLE_ADMIN')); - - $accessListener = new AccessListener( - $securityContext, - $accessDecisionManager, - $accessMap, - $authenticationManager - ); - -Contexto de seguridad -~~~~~~~~~~~~~~~~~~~~~ - -El gestor de decisión de acceso también está disponible en otras partes de la aplicación vía el método :method:`Symfony\\Component\\Security\\Core\\SecurityContext::isGranted` de la clase :class:`Symfony\\Component\\Security\\Core\\SecurityContext`. -Una llamada a este método delegará la cuestión directamente al gestor de decisión de acceso:: - - use Symfony\Component\Security\SecurityContext; - use Symfony\Component\Security\Core\Exception\AccessDeniedException; - - $securityContext = new SecurityContext( - $authenticationManager, - $accessDecisionManager - ); - - if (!$securityContext->isGranted('ROLE_ADMIN')) { - throw new AccessDeniedException(); - } diff --git a/_sources/components/security/firewall.txt b/_sources/components/security/firewall.txt deleted file mode 100644 index 9fb1a0d..0000000 --- a/_sources/components/security/firewall.txt +++ /dev/null @@ -1,97 +0,0 @@ -.. index:: - single: Seguridad, cortafuegos - -Cortafuegos y el contexto de seguridad -====================================== - -Una parte central del componente de seguridad es el contexto de seguridad, el cual es una instancia de la clase :class:`Symfony\\Component\\Security\\Core\\SecurityContextInterface`. Cuando todos los pasos en el proceso de autenticar al usuario han sido exitosos, puedes preguntar al contexto de seguridad si el usuario autenticado tiene acceso a una determinada acción o recurso de la aplicación:: - - use Symfony\Component\Security\SecurityContext; - use Symfony\Component\Security\Core\Exception\AccessDeniedException; - - $securityContext = new SecurityContext(); - - // ... autentifica al usuario - - if (!$securityContext->isGranted('ROLE_ADMIN')) { - throw new AccessDeniedException(); - } - -.. _firewall: - -Un cortafuegos para peticiones *HTTP* -------------------------------------- - -La autenticación de un usuario se hizo para el cortafuegos. Una aplicación puede tener múltiples áreas protegidas, así que el cortafuegos está configurado utilizando un mapa de estas áreas protegidas. Para cada una de estas áreas, el mapa contiene un emparejador con la petición y una colección de escuchas. El emparejador de petición da al cortafuegos la habilidad de descubrir si la petición actual apunta a una área protegida. -Los escuchas entonces son consultados para ver si se puede usar la petición actual para autenticar al usuario:: - - use Symfony\Component\Security\Http\FirewallMap; - use Symfony\Component\HttpFoundation\RequestMatcher; - use Symfony\Component\Security\Http\Firewall\ExceptionListener; - - $map = new FirewallMap(); - - $requestMatcher = new RequestMatcher('^/secured-area/'); - - // instancias de - // Symfony\Component\Security\Http\Firewall\ListenerInterface - $listeners = array(...); - - $exceptionListener = new ExceptionListener(...); - - $map->add($requestMatcher, $listeners, $exceptionListener); - -El mapa del cortafuegos será asociado al cortafuegos como su primer argumento, junto con el despachador de eventos utilizado por la clase :class:`Symfony\\Component\\HttpKernel\\HttpKernel`:: - - use Symfony\Component\Security\Http\Firewall; - use Symfony\Component\HttpKernel\KernelEvents; - - // el EventDispatcher usado por el HttpKernel - $dispatcher = ...; - - $firewall = new Firewall($map, $dispatcher); - - $dispatcher->addListener(KernelEvents::REQUEST, - array($firewall, - 'onKernelRequest' - )); - -El cortafuegos es registrado para escuchar el evento ``kernel.request`` que será despachado por el ``HttpKernel`` al principio de cada petición procesada. De este modo, el cortafuegos puede impedir al usuario ir más allá de dónde tiene permitido. - -.. _firewall_listeners: - -Escuchas del cortafuegos -~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuándo el cortafuegos es notificado del evento ``kernel.request``, este consulta el mapa del cortafuegos para ver si la petición coincide con una de las áreas protegidas. La primer área protegida que coincide con la petición regresará el correspondiente conjunto de escuchas del cortafuegos (el cual implementa la :class:`Symfony\\Component\\Security\\Http\\Firewall\\ListenerInterface`). -Todos estos escuchas serán consultados para manejar la petición actual. Esto básicamente significa: descubrir si la petición actual contiene alguna información por medio de la cual se podría autenticar al usuario (para casos de autenticación *HTTP* básicos el escucha comprueba si la petición tiene una cabecera llamada ``PHP_AUTH_USER``). - -Escucha de excepciones -~~~~~~~~~~~~~~~~~~~~~~ - -Si cualquiera de los escuchas lanza una :class:`Symfony\\Component\\Security\\Core\\Exception\\AuthenticationException`, el escucha de la excepción proporcionado al añadir las áreas protegidas saltará al mapa del cortafuegos. - -El escucha de la excepción determina qué pasa luego, basándose en los argumentos recibidos al crearlo. Este puede empezar el procedimiento de autenticación, quizás ---nuevamente--- haciendo que el usuario suministre sus credenciales (cuándo sólo ha sido -autenticado basándose en una ``galleta`` «recuérdame»), o transformando la excepción a una clase :class:`Symfony\\Component\\HttpKernel\\Exception\\AccessDeniedHttpException`, la cual finalmente resulta en una «respuesta 403 de *HTTP/1.1*: Acceso denegado». - -Puntos de entrada -~~~~~~~~~~~~~~~~~ - -Cuándo el usuario no es autenticado en absoluto (es decir, cuándo el contexto de seguridad -no tiene ficha todavía), el punto de entrada del cortafuegos será llamado para que «empiece» -el proceso de autenticación. Un punto de entrada debería implementar :class:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface`, la cual sólo tiene un método: :method:`Symfony\\Component\\Security\\Http\\EntryPoint\\AuthenticationEntryPointInterface::start`. -Este método recibe el objeto :class:`Symfony\\Component\\HttpFoundation\\Request` actual y la excepción por la cual el escucha de excepciones fue lanzado. -El método debería regresar un objeto :class:`Symfony\\Component\\HttpFoundation\\Response`. Este podría ser, por ejemplo, la página que contiene el formulario de inicio de sesión o, en el caso de autenticación *HTTP* básica, una respuesta con la cabecera ``WWW-Authenticate``, la cual hará que el usuario suministre su nombre de usuario y contraseña. - -Flujo: cortafuegos, autenticación, autorización ------------------------------------------------ - -Con algo de suerte, ahora puedes ver un poco de cómo «fluye» el trabajo del contexto de seguridad: - -#. El cortafuegos es registrado como escucha en el evento ``kernel.request``; -#. Al principio de la petición, el cortafuegos comprueba el mapa del cortafuegos para ver si algún cortafuegos debería estar activo para esa *URL*; -#. Si se encontró un cortafuegos en el mapa para esta *URL*, sus escuchas son notificados -#. Cada escucha comprueba si la petición actual contiene alguna información de autenticación ---un escucha puede (a) autenticar un usuario, (b) lanzar una ``AuthenticationException``, o (c) no hacer nada (porque no hay información de autenticación en la petición); -#. Una vez autenticado un usuario, utilizarás la :doc:`/components/security/authorization` para denegar el acceso a determinados recursos. - -Lee las siguientes secciones para descubrir más sobre :doc:`/components/security/authentication` y :doc:`/components/security/authorization`. \ No newline at end of file diff --git a/_sources/components/security/index.txt b/_sources/components/security/index.txt deleted file mode 100644 index dc404bb..0000000 --- a/_sources/components/security/index.txt +++ /dev/null @@ -1,10 +0,0 @@ -Seguridad -========= - -.. toctree:: - :maxdepth: 2 - - introduction - firewall - authentication - authorization \ No newline at end of file diff --git a/_sources/components/security/introduction.txt b/_sources/components/security/introduction.txt deleted file mode 100644 index 91a530e..0000000 --- a/_sources/components/security/introduction.txt +++ /dev/null @@ -1,29 +0,0 @@ -.. index:: - single: Seguridad - -El componente ``Security`` -========================== - -Introducción ------------- - -El componente ``Security`` proporciona un sistema de seguridad completo para tu aplicación *web*. Este viene con utilerías para autentificar usando autenticación *HTTP* básica o por medio de suma de comprobación, inicio de sesión interactivo o con certificado X.509, pero también te permite implementar tus propias estrategias de autenticación. -Además, el componente proporciona maneras de autorizar usuarios autenticados -basándose en sus roles, y contiene un avanzado sistema *ACL*. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Security); -* :doc:`Instalándolo vía Composer ` (``symfony/security`` en `Packagist`_). - -Secciones ---------- - -* :doc:`/components/security/firewall` -* :doc:`/components/security/authentication` -* :doc:`/components/security/authorization` - -.. _`Packagist`: https://packagist.org/packages/symfony/security \ No newline at end of file diff --git a/_sources/components/serializer.txt b/_sources/components/serializer.txt deleted file mode 100644 index 23c56f2..0000000 --- a/_sources/components/serializer.txt +++ /dev/null @@ -1,120 +0,0 @@ -.. index:: - single: Serializer - single: Componentes; Serializer - -El componente ``Serializer`` -============================ - - El componente ``Serializer`` se pretende sea utilizado para convertir objetos a un formato específico (*XML*, *JSON*, *Yaml*, ...) y a la inversa. - -Para ello, el componente ``Serializer`` sigue el siguiente sencillo esquema. - -.. _component-serializer-encoders: -.. _component-serializer-normalizers: - -.. image:: /images/components/serializer/serializer_workflow.png - -Como puedes ver en la imagen anterior, se utiliza un arreglo como un hombre en -el medio. De este modo, los codificadores sólo tratarán convirtiendo **formatos** específicos en **arreglos** y viceversa. Del mismo modo, los normalizadores tratarán cambiando **objetos** específicos en **arreglos** y viceversa. - -La serialización es un tema complicado, y a pesar de que este componente no puede trabajar en todos los casos, puede ser una útil herramienta mientras desarrollas herramientas para serializar y deserializar tus objetos. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Serializer); -* :doc:`Install it via Composer ` (``symfony/serializer`` on `Packagist`_). - -Usando ------- - -Utilizar el componente ``Serializer`` es realmente sencillo. Sólo necesitas instalar la clase :class:`Symfony\\Component\\Serializer\\Serializer` especificando qué codificadores y normalizadores van a estar disponibles:: - - use Symfony\Component\Serializer\Serializer; - use Symfony\Component\Serializer\Encoder\XmlEncoder; - use Symfony\Component\Serializer\Encoder\JsonEncoder; - use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer; - - $encoders = array(new XmlEncoder(), new JsonEncoder()); - $normalizers = array(new GetSetMethodNormalizer()); - - $serializer = new Serializer($normalizers, $encoders); - -Serializando un objeto -~~~~~~~~~~~~~~~~~~~~~~ - -Por el bien de este ejemplo, supongamos que la siguiente clase ya existe en tu proyecto:: - - namespace Acme; - - class Person - { - private $age; - private $name; - - // Captadores - public function getName() - { - return $this->name; - } - - public function getAge() - { - return $this->age; - } - - // Definidores - public function setName($name) - { - $this->name = $name; - } - - public function setAge($age) - { - $this->age = $age; - } - } - -Ahora, si queremos serializar este objeto a *JSON*, sólo necesitamos utilizar el servicio ``Serializer`` creado anteriormente:: - - $person = new Acme\Person(); - $person->setName('foo'); - $person->setAge(99); - - $jsonContent = $serializer->serialize($person, 'json'); - - // $jsonContent contains {"name":"foo","age":99} - - echo $jsonContent; // or return it in a Response - -El primer argumento del método :method:`Symfony\\Component\\Serializer\\Serializer::serialize` es el objeto a serializar y el segundo suele escoger el codificador apropiado, en este caso :class:`Symfony\\Component\\Serializer\\Encoder\\JsonEncoder`. - -Deserializando un Objeto -~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora veremos cómo hacer exactamente lo opuesto. Esta vez, la información de la clase ``Personas`` estaría codificada en formato *XML*:: - - $data = << - foo - 99 - - EOF; - - $person = $serializer->deserialize($data,'Acme\Person','xml'); - -En este caso, el método :method:`Symfony\\Component\\Serializer\\Serializer::deserialize` necesita tres argumentos: - -1. La información a descodificar -2. El nombre de la clase a la que esta información será descodificada -3. El codificador a utilizar para convertir esa información a un arreglo - -``JMSSerializer`` ------------------ - -Una popular biblioteca de terceros, `JMS serializer`_, proporciona una solución más sofisticada aunque más compleja. Esta biblioteca incluye la habilidad para configurar cómo se deberían serializar/deserializar tus objetos a través de anotaciones (así como *YML*, *XML* y *PHP*), integrarlos con el *ORM* de *Doctrine*, y manejar otros casos complejos (p. ej. en referencias circulares). - -.. _`JMS serializer`: https://github.com/schmittjoh/serializer -.. _`Packagist`: https://packagist.org/packages/symfony/serializer diff --git a/_sources/components/stopwatch.txt b/_sources/components/stopwatch.txt deleted file mode 100644 index d7c4bdd..0000000 --- a/_sources/components/stopwatch.txt +++ /dev/null @@ -1,95 +0,0 @@ -.. index:: - single: Stopwatch - single: Componentes; Stopwatch - -El componente ``Stopwatch`` -=========================== - - El componente ``Stopwatch`` proporciona una manera para codificar el perfil. - -.. versionadded:: 2.2 - El componente ``Stopwatch`` es nuevo en *Symfony 2.2*. Anteriormente, la clase ``Stopwatch`` estaba localizada en el componente ``HttpKernel`` (y era nueva en 2.1). - -Instalando ----------- - -Puedes instalar el componente en dos diferentes maneras: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Stopwatch); -* :doc:`Instalándolo vía Composer ` (``symfony/stopwatch`` en `Packagist`_). - -Usando ------- - -El el componente ``stopwatch`` proporciona una manera fácil y coherente para medir el tiempo de ejecución de ciertas partes de código a modo de que no tengas que analizar la duración de algo. En cambio, usas la sencilla clase :class:`Symfony\\Component\\Stopwatch\\Stopwatch`:: - - use Symfony\Component\Stopwatch\Stopwatch; - - $stopwatch = new Stopwatch(); - // Inicia el evento llamado 'eventName' - $stopwatch->start('eventName'); - // ... aquí va algún código - $event = $stopwatch->stop('eventName'); - -También puedes proporcionar un nombre de categoría a un evento:: - - $stopwatch->start('eventName', 'categoryName'); - -Puedes considerar a las categorías como una conveniente manera de etiquetar eventos. Por ejemplo, la herramienta del perfilador de *Symfony* usa categorías para codificar coloridamente diferentes eventos. - -Periodos --------- - -Como sabes del mundo real, todos los cronómetros vienen con dos botones. -Uno para arrancar y detener el cronómetro, otro para medir el tiempo transcurrido. -Esto exactamente es lo que hace el método :method:`Symfony\\Component\\Stopwatch\\Stopwatch::lap`:: - - $stopwatch = new Stopwatch(); - // Inicia el evento llamado 'foo' - $stopwatch->start('foo'); - // ... aquí va algún código - $stopwatch->lap('foo'); - // ... aquí va algún código - $stopwatch->lap('foo'); - // ... aquí va algún otro código - $event = $stopwatch->stop('foo'); - -La información del lapso se almacena como «periodos» en el evento. Para obtener dicha información llama a:: - - $event->getPeriods(); - -Además de obtener los periodos, puedes conseguir otra útil información del objeto evento. -Por ejemplo:: - - $event->getCategory(); // Devuelve la categoría en que se inició el evenento - $event->getOrigin(); // Devuelve el lapso transcurrido desde que se inicio - // el evento en milisegundos - $event->ensureStopped(); // Detiene todos los periodos que no se han detenido ya - $event->getStartTime(); // Regresa el inicio del primer periodo - $event->getEndTime(); // Regresa el tiempo final del último periodo - $event->getDuration(); // Obtiene la duración del evento incluyendo todos los - // periodos - $event->getMemory(); // Devuelve el máximo uso de memoria de todos los periodos - -Secciones ---------- - -Las secciones son una manera de dividir lógicamente la cronología en grupos. Puedes ver cómo usa *Symfony* las secciones visualizando agradablemente el ciclo de vida con -la herramienta perfiladora de *Symfony*. Aquí tienes un ejemplo del uso básico de las secciones:: - - $stopwatch = new Stopwatch(); - - $stopwatch->openSection(); - $stopwatch->start('parsing_config_file', 'filesystem_operations'); - $stopwatch->stopSection('routing'); - - $events = $stopwatch->getSectionEvents('routing'); - -You can reopen a closed section by calling the :method:`Symfony\\Component\\Stopwatch\\Stopwatch::openSection`` -method and specifying the id of the section to be reopened:: - - $stopwatch->openSection('routing'); - $stopwatch->start('building_config_tree'); - $stopwatch->stopSection('routing'); - -.. _`Packagist`: https://packagist.org/packages/symfony/stopwatch diff --git a/_sources/components/templating.txt b/_sources/components/templating.txt deleted file mode 100644 index 30710ff..0000000 --- a/_sources/components/templating.txt +++ /dev/null @@ -1,102 +0,0 @@ -.. index:: - single: Templating - single: Componentes; Plantillas - -El componente ``Templating`` -============================ - - El componente ``Templating`` proporciona todas las herramientas necesarias para construir cualquier tipo de sistema de plantillas. - - Este proporciona una infraestructura para cargar los archivos de plantilla y opcionalmente controlar sus cambios. También proporciona una implementación del motor de plantillas concreto usando *PHP* con herramientas adicionales para escapar y separar plantillas en bloques y diseños. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Templating); -* :doc:`Instalándolo vía Composer` (``symfony/templating`` en `Packagist`_). - -Usando ------- - -La clase :class:`Symfony\\Component\\Templating\\PhpEngine` es el punto de entrada del componente. Este necesita un analizador de nombres de plantilla (:class:`Symfony\\Component\\Templating\\TemplateNameParserInterface`) para convertir un nombre de plantilla a una referencia a la plantilla y cargador de plantilla (:class:`Symfony\\Component\\Templating\\Loader\\LoaderInterface`) para encontrar la plantilla asociada a una referencia:: - - use Symfony\Component\Templating\PhpEngine; - use Symfony\Component\Templating\TemplateNameParser; - use Symfony\Component\Templating\Loader\FilesystemLoader; - - $loader = new FilesystemLoader(__DIR__ . '/views/%name%'); - - $view = new PhpEngine(new TemplateNameParser(), $loader); - - echo $view->render('hello.php', array('firstname' => 'Fabien')); - -El método :method:`Symfony\\Component\\Templating\\PhpEngine::render` ejecuta el archivo -:file:`views/hello.php` y devuelve el texto producido. - -.. code-block:: html+php - - - Hello, ! - -Herencia de plantillas con ranuras ----------------------------------- - -La herencia de plantillas está diseñada para compartir diseños con muchas plantillas. - - -.. code-block:: html+php - - - - - <?php $view['slots']->output('title', 'Default title') ?> - - - output('_content') ?> - - - -El método :method:`Symfony\\Component\\Templating\\PhpEngine::extend` es llamado en la subplantilla para definir la plantilla padre. - -.. code-block:: html+php - - - extend('layout.php') ?> - - set('title', $page->title) ?> - -

    - title ?> -

    -

    - body ?> -

    - -Para usar la herencia de plantillas, debes registrar la clase ayudante :class:`Symfony\\Component\\Templating\\Helper\\SlotsHelper`:: - - use Symfony\Component\Templating\Helper\SlotsHelper; - - $view->set(new SlotsHelper()); - - // Retrieve page object - $page = ...; - - echo $view->render('page.php', array('page' => $page)); - -.. note:: - - Es posible la herencia multinivel: un diseño puede extender a otro. - -Mecanismo de escape -------------------- - -Esta documentación todavía se está escribiendo. - -El ayudante ``Asset`` ---------------------- - -Esta documentación todavía se está escribiendo. - -.. _`Packagist`: https://packagist.org/packages/symfony/templating \ No newline at end of file diff --git a/_sources/components/using_components.txt b/_sources/components/using_components.txt deleted file mode 100644 index edecdac..0000000 --- a/_sources/components/using_components.txt +++ /dev/null @@ -1,91 +0,0 @@ -.. index:: - single: Componentes; Instalando - single: Componentes; Usando - -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 :doc:`/components/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: - -.. code-block:: json - - { - "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 :file:`vendor/autoload.php`: - -.. code-block:: bash - - $ 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/'); - - // ... - -.. tip:: - - Si quieres utilizar todos los componentes de *Symfony2*, entonces en vez de añadirlos uno por uno: - - .. code-block:: json - - { - "require": { - "symfony/finder": "2.2.*", - "symfony/dom-crawler": "2.2.*", - "symfony/css-selector": "2.2.*" - } - } - - puedes usar: - - .. code-block:: json - - { - "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! - -.. _Composer: http://getcomposer.org -.. _`Instala composer`: http://getcomposer.org/download/ -.. _packagist.org: https://packagist.org/ \ No newline at end of file diff --git a/_sources/components/yaml.txt b/_sources/components/yaml.txt deleted file mode 100644 index a2f2c78..0000000 --- a/_sources/components/yaml.txt +++ /dev/null @@ -1,430 +0,0 @@ -.. index:: - single: Yaml - single: Componentes; Yaml - -El componente *YAML* -==================== - - El componente *YAML* carga y vuelca archivos *YAML*. - -¿Qué es entonces? ------------------ - -El componente *YAML* de *Symfony2* analiza cadenas *YAML* para convertirlas en arreglos *PHP*. -También es capaz de convertir arreglos *PHP* a cadenas *YAML*. - -`YAML`_, *YAML no es un lenguaje de marcado*, es un estándar para la serialización de datos amigable con los humanos para todos los lenguajes de programación. YAML es un formato ideal para tus archivos de configuración. Los archivos *YAML* son tan expresivos como los archivos *XML* y tan fáciles de leer como los archivos ``INI``. - -El componente *YAML* de *Symfony2* implementa la versión 1.2 de la -especificación *YAML*. - - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Yaml); -* :doc:`Instalándolo vía Composer ` (``symfony/yaml`` en `Packagist`_). - -¿Por qué? ---------- - -Rapidez -~~~~~~~ - -Uno de los objetivos del componente *YAML* de *Symfony* es encontrar el balance adecuado entre características y velocidad. Es compatible con las características necesarias para manipular archivos de configuración. - -Analizador real -~~~~~~~~~~~~~~~ - -Este exporta un analizador real y es capaz de analizar un gran subconjunto de especificaciones *YAML*, para todas tus necesidades de configuración. También significa que el analizador es bastante robusto, fácil de entender, y lo suficientemente simple como para ampliarlo. - -Borrando mensajes de error -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada vez que tienes un problema de sintaxis con tus archivos *YAML*, la biblioteca genera un útil mensaje de ayuda con el nombre y número de línea donde está el problema. Lo cual facilita mucho la depuración. - -Compatibilidad con el volcado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -También es capaz de volcar arreglos de *PHP* a *YAML* con apoyo a objetos, y el nivel de configuración en línea es bastante bueno. - -Compatibilidad de tipos -~~~~~~~~~~~~~~~~~~~~~~~ - -Es compatible con la mayoría de los tipos *YAML* integrados como fechas, números enteros, octales, booleanos, y mucho más... - -Completa compatibilidad con la fusión de claves -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Completa compatibilidad para referencias, alias y completa fusión de claves. No repitas tú mismo haciendo referencia a segmentos de configuración comunes. - -Utilizando el componente *YAML* de *Symfony2* ---------------------------------------------- - -El componente *YAML* de *Symfony2* es muy simple y consiste de dos clases principales: -una analiza cadenas *YAML* (:class:`Symfony\\Component\\Yaml\\Parser`), y la otra -vuelca un array *PHP* en una cadena *YAML* (:class:`Symfony\\Component\\Yaml\\Dumper`). - -Además de estas dos clases, la clase :class:`Symfony\\Component\\Yaml\\Yaml` actúa como un delgado contenedor que simplifica los usos más comunes. - -Leyendo archivos *YAML* -~~~~~~~~~~~~~~~~~~~~~~~ - -El método :method:`Symfony\\Component\\Yaml\\Parser::parse` analiza una cadena *YAML* y la convierte en un arreglo *PHP*: - -.. code-block:: php - - use Symfony\Component\Yaml\Parser; - - $yaml = new Parser(); - - $value = $yaml->parse(file_get_contents('/path/to/file.yml')); - -Si ocurre un error durante el análisis, el analizador lanza una excepción :class:`Symfony\\Component\\Yaml\\Exception\\ParseException` que indica el tipo de error y la línea en la cadena *YAML* original en la que ocurrió el error: - -.. code-block:: php - - use Symfony\Component\Yaml\Exception\ParseException; - - try { - $value = $yaml->parse(file_get_contents('/path/to/file.yml')); - } catch (ParseException $e) { - printf("Unable to parse the YAML string: %s", $e->getMessage()); - } - -.. tip:: - - Debido a que el analizador es reentrante, puedes utilizar el mismo objeto analizador para cargar diferentes cadenas *YAML*. - -Al cargar un archivo *YAML*, a veces es mejor usar el contenedor del método :method:`Symfony\\Component\\Yaml\\Yaml::parse`: - -.. code-block:: php - - use Symfony\Component\Yaml\Yaml; - - $yaml = Yaml::parse('/path/to/file.yml'); - -El método estático :method:`Symfony\\Component\\Yaml\\Yaml::parse` toma una cadena *YAML* o un archivo que contiene *YAML*. Internamente, llama al método :method:`Symfony\\Component\\Yaml\\Parser::parse`, pero mejora el error si algo sale mal, añadiendo el nombre del archivo al mensaje. - -Ejecutando *PHP* dentro de los archivos *YAML* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - El método ``Yaml::enablePhpParsing()`` es nuevo en *Symfony 2.1*. Antes de 2.1, *PHP* *siempre* se ejecuta al llamar a la función ``parse()``. - -De manera predeterminada, si incluyes *PHP* dentro de un archivo *YAML*, no se va a analizar. -Si quiere que *PHP* se analice, debes llamar a ``Yaml::enablePhpParsing()`` antes de analizar el archivo para activar ese modo. Si sólo deseas permitir código *PHP* para un único archivo *YAML*, asegúrate de desactivar el intérprete *PHP* después de analizar ese archivo llamando a ``Yaml::$enablePhpParsing = false;``, (``$enablePhpParsing`` es una propiedad pública). - -Escribiendo archivos *YAML* -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El método :method:`Symfony\\Component\\Yaml\\Dumper::dump` vuelca cualquier arreglo *PHP* en su representación *YAML*: - -.. code-block:: php - - use Symfony\Component\Yaml\Dumper; - - $array = array( - 'foo' => 'bar', - 'bar' => array('foo' => 'bar', 'bar' => 'baz') - ); - - $dumper = new Dumper(); - - $yaml = $dumper->dump($array); - - file_put_contents('/path/to/file.yml', $yaml); - -.. note:: - - Por supuesto, el vertedor *YAML* de *Symfony2* no es capaz de volcar recursos. Por otra parte, aun y cuando el vertedor es capaz de volcar objetos *PHP*, se considera como una función **No** admitida. - -Si ocurre un error durante el volcado, el analizador lanza una excepción :class:`Symfony\\Component\\Yaml\\Exception\\DumpException`. - -Si sólo necesitas volcar un arreglo, puedes utilizar el método estático :method:`Symfony\\Component\\Yaml\\Yaml::dump`: - -.. code-block:: php - - use Symfony\Component\Yaml\Yaml; - - $yaml = Yaml::dump($array, $inline); - -El formato *YAML* admite dos tipos de representación de arreglos, la ampliada, y en línea. Por omisión, el vertedor utiliza la representación en línea: - -.. code-block:: yaml - - { foo: bar, bar: { foo: bar, bar: baz } } - -El segundo argumento del método :method:`Symfony\\Component\\Yaml\\Dumper::dump` personaliza el nivel en el cual el resultado cambia de la representación ampliada a en línea: - -.. code-block:: php - - echo $dumper->dump($array, 1); - -.. code-block:: yaml - - foo: bar - bar: { foo: bar, bar: baz } - -.. code-block:: php - - echo $dumper->dump($array, 2); - -.. code-block:: yaml - - foo: bar - bar: - foo: bar - bar: baz - -El formato *YAML* ------------------ - -El sitio *web* de `YAML`_ dice que es «un estándar para la serialización de datos humanamente legibles para todos los lenguajes de programación». - -Si bien el formato *YAML* puede describir complejas estructuras de datos anidadas, este capítulo sólo describe el conjunto mínimo de características necesarias para usar *YAML* como un formato de archivo de configuración. - -*YAML* es un lenguaje simple que describe datos. Como *PHP*, que tiene una sintaxis para tipos simples, como cadenas, booleanos, números en punto flotante, o enteros. Pero a diferencia de *PHP*, este distingue entre arreglos (secuencias) y ``hashes`` (asignaciones). - -Escalares -~~~~~~~~~ - -La sintaxis para escalares es similar a la sintaxis de *PHP*. - -Cadenas -....... - -.. code-block:: yaml - - Una cadena en YAML - -.. code-block:: yaml - - 'Una cadena entre comillas simples en YAML' - -.. tip:: - - En una cadena entre comillas simples, una comilla simple ``'`` debe ser doble: - - .. code-block:: yaml - - 'Una comilla simple '' en una cadena entre comillas simples' - -.. code-block:: yaml - - "Una cadena entre comillas dobles en YAML\n" - -Los estilos de citado son útiles cuando una cadena empieza o termina con uno o más espacios relevantes. - -.. tip:: - - El estilo entre comillas dobles proporciona una manera de expresar cadenas arbitrarias, utilizando secuencias de escape ``\``. Es muy útil cuando se necesita incrustar un ``\n`` o un carácter Unicode en una cadena. - -Cuando una cadena contiene saltos de línea, puedes usar el estilo literal, indicado por la línea vertical (``|``), para indicar que la cadena abarcará varias líneas. En literales, se conservan los saltos de línea: - -.. code-block:: yaml - - | - \/ /| |\/| | - / / | | | |__ - -Alternativamente, puedes escribir cadenas con el estilo de plegado, denotado por ``>``, en el cual cada salto de línea es sustituido por un espacio: - -.. code-block:: yaml - - > - Esta es una oración muy larga - que se extiende por varias líneas en el YAML - pero que se reproduce como una cadena - sin retornos de carro. - -.. note:: - - Observa los dos espacios antes de cada línea en los ejemplos anteriores. Ellos no aparecen en las cadenas *PHP* resultantes. - -Números -....... - -.. code-block:: yaml - - # un entero - 12 - -.. code-block:: yaml - - # un octal - 014 - -.. code-block:: yaml - - # un hexadecimal - 0xC - -.. code-block:: yaml - - # un float - 13.4 - -.. code-block:: yaml - - # un número exponencial - 1.2e+34 - -.. code-block:: yaml - - # infinito - .inf - -Nulos -..... - -Los nulos en *YAML* se pueden expresar con ``null`` o ``~``. - -Booleanos -......... - -Los booleanos en *YAML* se expresan con ``true`` y ``false``. - -Fechas -...... - -*YAML* utiliza la norma ISO-8601 para expresar fechas: - -.. code-block:: yaml - - 2001-12-14t21:59:43.10-05:00 - -.. code-block:: yaml - - # fecha simple - 2002-12-14 - -Colecciones -~~~~~~~~~~~ - -Rara vez se utiliza un archivo *YAML* para describir un simple escalar. La mayoría de las veces, describe una colección. Una colección puede ser una secuencia o una asignación de elementos. Ambas, secuencias y asignaciones se convierten en arreglos *PHP*. - -Las secuencias usan un guión seguido por un espacio: - -.. code-block:: yaml - - - PHP - - Perl - - Python - -El archivo *YAML* anterior es equivalente al siguiente código *PHP*: - -.. code-block:: php - - array('PHP', 'Perl', 'Python'); - -La asignación utiliza dos puntos seguidos por un espacio (``:`` ) para marcar cada par clave/valor: - -.. code-block:: yaml - - PHP: 5.2 - MySQL: 5.1 - Apache: 2.2.20 - -el cual es equivalente a este código *PHP*: - -.. code-block:: php - - array('PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20'); - -.. note:: - - En una asignación, una clave puede ser cualquier escalar válido. - -El número de espacios entre los dos puntos y el valor no importa: - -.. code-block:: yaml - - PHP: 5.2 - MySQL: 5.1 - Apache: 2.2.20 - -*YAML* utiliza sangría con uno o más espacios para describir colecciones anidadas: - -.. code-block:: yaml - - "symfony 1.0": - PHP: 5.0 - Propel: 1.2 - "symfony 1.2": - PHP: 5.2 - Propel: 1.3 - -El *YAML* anterior es equivalente al siguiente código *PHP*: - -.. code-block:: php - - array( - 'symfony 1.0' => array( - 'PHP' => 5.0, - 'Propel' => 1.2, - ), - 'symfony 1.2' => array( - 'PHP' => 5.2, - 'Propel' => 1.3, - ), - ); - -Hay una cosa importante que tienes que recordar cuando utilices sangría en un archivo *YAML*: *La sangría se debe hacer con uno o más espacios, pero nunca con tabulaciones*. - -Puedes anidar secuencias y asignaciones a tu gusto: - -.. code-block:: yaml - - 'Chapter 1': - - Introduction - - Event Types - 'Chapter 2': - - Introduction - - Helpers - -*YAML* también puede utilizar estilos de flujo para colecciones, utilizando indicadores explícitos en lugar de sangría para denotar el alcance. - -Puedes escribir una secuencia como una lista separada por comas entre corchetes (``[]``): - -.. code-block:: yaml - - [PHP, Perl, Python] - -Una asignación se puede escribir como una lista separada por comas de clave/valores dentro de llaves (``{}``): - -.. code-block:: yaml - - { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 } - -Puedes mezclar y combinar estilos para conseguir mejor legibilidad: - -.. code-block:: yaml - - 'Chapter 1': [Introduction, Event Types] - 'Chapter 2': [Introduction, Helpers] - -.. code-block:: yaml - - "symfony 1.0": { PHP: 5.0, Propel: 1.2 } - "symfony 1.2": { PHP: 5.2, Propel: 1.3 } - -Comentarios -~~~~~~~~~~~ - -En *YAML* puedes añadir comentarios anteponiendo una almohadilla (``#``): - -.. code-block:: yaml - - # Comentario en una línea - "symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comentario al final de una línea - "symfony 1.2": { PHP: 5.2, Propel: 1.3 } - -.. note:: - - Los comentarios simplemente son ignorados por el analizador de *YAML* y no es necesario sangrarlos de acuerdo al nivel de anidamiento actual de una colección. - -.. _YAML: http://yaml.org/ -.. _`Packagist`: https://packagist.org/packages/symfony/yaml diff --git a/_sources/components/yaml/index.txt b/_sources/components/yaml/index.txt deleted file mode 100644 index fecaad9..0000000 --- a/_sources/components/yaml/index.txt +++ /dev/null @@ -1,8 +0,0 @@ -*Yaml* -====== - -.. toctree:: - :maxdepth: 2 - - introduction - yaml_format diff --git a/_sources/components/yaml/introduction.txt b/_sources/components/yaml/introduction.txt deleted file mode 100644 index 4eba55e..0000000 --- a/_sources/components/yaml/introduction.txt +++ /dev/null @@ -1,178 +0,0 @@ -.. index:: - single: Yaml - single: Componentes; Yaml - -El componente *YAML* -==================== - - El componente *YAML* carga y vuelca archivos *YAML*. - -¿Qué es entonces? ------------------ - -El componente *YAML* de *Symfony2* analiza cadenas *YAML* para convertirlas en arreglos *PHP*. -También es capaz de convertir arreglos *PHP* a cadenas *YAML*. - -`YAML`_, *YAML no es un lenguaje de marcado*, es un estándar para la serialización de datos amigable con los humanos para todos los lenguajes de programación. YAML es un formato ideal para tus archivos de configuración. Los archivos *YAML* son tan expresivos como los archivos *XML* y tan fáciles de leer como los archivos ``INI``. - -El componente *YAML* de *Symfony2* implementa la versión 1.2 de la -especificación *YAML*. - - -.. tip:: - - Aprende más sobre el componente *Yaml* en el artículo :doc:`/components/yaml/yaml_format`. - -Instalando ----------- - -Puedes instalar el componente de varias maneras diferentes: - -* Usando el repositorio *Git* oficial (https://github.com/symfony/Yaml); -* :doc:`Instalándolo vía Composer ` (``symfony/yaml`` en `Packagist`_). - -¿Por qué? ---------- - -Rapidez -~~~~~~~ - -Uno de los objetivos del componente *YAML* de *Symfony* es encontrar el balance adecuado entre características y velocidad. Es compatible con las características necesarias para manipular archivos de configuración. - -Analizador real -~~~~~~~~~~~~~~~ - -Este exporta un analizador real y es capaz de analizar un gran subconjunto de especificaciones *YAML*, para todas tus necesidades de configuración. También significa que el analizador es bastante robusto, fácil de entender, y lo suficientemente simple como para ampliarlo. - -Borrando mensajes de error -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada vez que tienes un problema de sintaxis con tus archivos *YAML*, la biblioteca genera un útil mensaje de ayuda con el nombre y número de línea donde está el problema. Lo cual facilita mucho la depuración. - -Compatibilidad con el volcado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -También es capaz de volcar arreglos de *PHP* a *YAML* con apoyo a objetos, y el nivel de configuración en línea es bastante bueno. - -Compatibilidad de tipos -~~~~~~~~~~~~~~~~~~~~~~~ - -Es compatible con la mayoría de los tipos *YAML* integrados como fechas, números enteros, octales, booleanos, y mucho más... - -Completa compatibilidad con la fusión de claves -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Completa compatibilidad para referencias, alias y completa fusión de claves. No repitas tú mismo haciendo referencia a segmentos de configuración comunes. - -Utilizando el componente *YAML* de *Symfony2* ---------------------------------------------- - -El componente *YAML* de *Symfony2* es muy simple y consiste de dos clases principales: -una analiza cadenas *YAML* (:class:`Symfony\\Component\\Yaml\\Parser`), y la otra -vuelca un array *PHP* en una cadena *YAML* (:class:`Symfony\\Component\\Yaml\\Dumper`). - -Además de estas dos clases, la clase :class:`Symfony\\Component\\Yaml\\Yaml` actúa como un delgado contenedor que simplifica los usos más comunes. - -Leyendo archivos *YAML* -~~~~~~~~~~~~~~~~~~~~~~~ - -El método :method:`Symfony\\Component\\Yaml\\Parser::parse` analiza una cadena *YAML* y la convierte en un arreglo *PHP*: - -.. code-block:: php - - use Symfony\Component\Yaml\Parser; - - $yaml = new Parser(); - - $value = $yaml->parse(file_get_contents('/ruta/a/file.yml')); - -Si ocurre un error durante el análisis, el analizador lanza una excepción :class:`Symfony\\Component\\Yaml\\Exception\\ParseException` que indica el tipo de error y la línea en la cadena *YAML* original en la que ocurrió el error: - -.. code-block:: php - - use Symfony\Component\Yaml\Exception\ParseException; - - try { - $value = $yaml->parse(file_get_contents('/ruta/a/file.yml')); - } catch (ParseException $e) { - printf("Unable to parse the YAML string: %s", $e->getMessage()); - } - -.. tip:: - - Debido a que el analizador es reentrante, puedes utilizar el mismo objeto analizador para cargar diferentes cadenas *YAML*. - -Al cargar un archivo *YAML*, a veces es mejor usar el contenedor del método :method:`Symfony\\Component\\Yaml\\Yaml::parse`: - -.. code-block:: php - - use Symfony\Component\Yaml\Yaml; - - $yaml = Yaml::parse('/ruta/a/file.yml'); - -El método estático :method:`Symfony\\Component\\Yaml\\Yaml::parse` toma una cadena *YAML* o un archivo que contiene *YAML*. Internamente, llama al método :method:`Symfony\\Component\\Yaml\\Parser::parse`, pero mejora el error si algo sale mal, añadiendo el nombre del archivo al mensaje. - -Escribiendo archivos *YAML* -~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El método :method:`Symfony\\Component\\Yaml\\Dumper::dump` vuelca cualquier arreglo *PHP* en su representación *YAML*: - -.. code-block:: php - - use Symfony\Component\Yaml\Dumper; - - $array = array( - 'foo' => 'bar', - 'bar' => array('foo' => 'bar', 'bar' => 'baz'), - ); - - $dumper = new Dumper(); - - $yaml = $dumper->dump($array); - - file_put_contents('/ruta/a/file.yml', $yaml); - -.. note:: - - Por supuesto, el vertedor *YAML* de *Symfony2* no es capaz de volcar recursos. Por otra parte, aun y cuando el vertedor es capaz de volcar objetos *PHP*, se considera como una función **No** admitida. - -Si ocurre un error durante el volcado, el analizador lanza una excepción :class:`Symfony\\Component\\Yaml\\Exception\\DumpException`. - -Si sólo necesitas volcar un arreglo, puedes utilizar el método estático :method:`Symfony\\Component\\Yaml\\Yaml::dump`: - -.. code-block:: php - - use Symfony\Component\Yaml\Yaml; - - $yaml = Yaml::dump($array, $inline); - -El formato *YAML* admite dos tipos de representación de arreglos, la ampliada, y en línea. Por omisión, el vertedor utiliza la representación en línea: - -.. code-block:: yaml - - { foo: bar, bar: { foo: bar, bar: baz } } - -El segundo argumento del método :method:`Symfony\\Component\\Yaml\\Dumper::dump` personaliza el nivel en el cual el resultado cambia de la representación ampliada a en línea: - -.. code-block:: php - - echo $dumper->dump($array, 1); - -.. code-block:: yaml - - foo: bar - bar: { foo: bar, bar: baz } - -.. code-block:: php - - echo $dumper->dump($array, 2); - -.. code-block:: yaml - - foo: bar - bar: - foo: bar - bar: baz - -.. _YAML: http://yaml.org/ -.. _`Packagist`: https://packagist.org/packages/symfony/yaml diff --git a/_sources/components/yaml/yaml_format.txt b/_sources/components/yaml/yaml_format.txt deleted file mode 100644 index e6f014a..0000000 --- a/_sources/components/yaml/yaml_format.txt +++ /dev/null @@ -1,251 +0,0 @@ -.. index:: - single: Yaml; Formato YAML - -El formato *YAML* -================= - -El sitio *web* de `YAML`_ dice que es «un estándar para la serialización de datos humanamente legibles para todos los lenguajes de programación». - -Si bien el formato *YAML* puede describir complejas estructuras de datos anidadas, este capítulo sólo describe el conjunto mínimo de características necesarias para usar *YAML* como un formato de archivo de configuración. - -*YAML* es un lenguaje simple que describe datos. Como *PHP*, que tiene una sintaxis para tipos simples, como cadenas, booleanos, números en punto flotante, o enteros. Pero a diferencia de *PHP*, este distingue entre arreglos (secuencias) y ``hashes`` (asignaciones). - -Escalares ---------- - -La sintaxis para escalares es similar a la sintaxis de *PHP*. - -Cadenas -~~~~~~~ - -.. code-block:: yaml - - Una cadena en YAML - -.. code-block:: yaml - - 'Una cadena entre comillas simples en YAML' - -.. tip:: - - En una cadena entre comillas simples, una comilla simple ``'`` debe ser doble: - - .. code-block:: yaml - - 'Una comilla simple '' en una cadena entre comillas simples' - -.. code-block:: yaml - - "Una cadena entre comillas dobles en YAML\n" - -Los estilos de citado son útiles cuando una cadena empieza o termina con uno o más espacios relevantes. - -.. tip:: - - El estilo entre comillas dobles proporciona una manera de expresar cadenas arbitrarias, utilizando secuencias de escape ``\``. Es muy útil cuando se necesita incrustar un ``\n`` o un carácter Unicode en una cadena. - -Cuando una cadena contiene saltos de línea, puedes usar el estilo literal, indicado por la línea vertical (``|``), para indicar que la cadena abarcará varias líneas. En literales, se conservan los saltos de línea: - -.. code-block:: yaml - - | - \/ /| |\/| | - / / | | | |__ - -Alternativamente, puedes escribir cadenas con el estilo de plegado, denotado por ``>``, en el cual cada salto de línea es sustituido por un espacio: - -.. code-block:: yaml - - > - Esta es una oración muy larga - que se extiende por varias líneas en el YAML - pero que se reproduce como una cadena - sin retornos de carro. - -.. note:: - - Observa los dos espacios antes de cada línea en los ejemplos anteriores. Ellos no aparecen en las cadenas *PHP* resultantes. - -Números -~~~~~~~ - -.. code-block:: yaml - - # un entero - 12 - -.. code-block:: yaml - - # un octal - 014 - -.. code-block:: yaml - - # un hexadecimal - 0xC - -.. code-block:: yaml - - # un float - 13.4 - -.. code-block:: yaml - - # un número exponencial - 1.2e+34 - -.. code-block:: yaml - - # infinito - .inf - -Nulos -~~~~~ - -Los nulos en *YAML* se pueden expresar con ``null`` o ``~``. - -Booleanos -~~~~~~~~~ - -Los booleanos en *YAML* se expresan con ``true`` y ``false``. - -Fechas -~~~~~~ - -*YAML* utiliza la norma ISO-8601 para expresar fechas: - -.. code-block:: yaml - - 2001-12-14t21:59:43.10-05:00 - -.. code-block:: yaml - - # fecha simple - 2002-12-14 - -Colecciones -~~~~~~~~~~~ - -Rara vez se utiliza un archivo *YAML* para describir un simple escalar. La mayoría de las veces, describe una colección. Una colección puede ser una secuencia o una asignación de elementos. Ambas, secuencias y asignaciones se convierten en arreglos *PHP*. - -Las secuencias usan un guión seguido por un espacio: - -.. code-block:: yaml - - - PHP - - Perl - - Python - -El archivo *YAML* anterior es equivalente al siguiente código *PHP*: - -.. code-block:: php - - array('PHP', 'Perl', 'Python'); - -La asignación utiliza dos puntos seguidos por un espacio (``:`` ) para marcar cada par clave/valor: - -.. code-block:: yaml - - PHP: 5.2 - MySQL: 5.1 - Apache: 2.2.20 - -el cual es equivalente a este código *PHP*: - -.. code-block:: php - - array('PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20'); - -.. note:: - - En una asignación, una clave puede ser cualquier escalar válido. - -El número de espacios entre los dos puntos y el valor no importa: - -.. code-block:: yaml - - PHP: 5.2 - MySQL: 5.1 - Apache: 2.2.20 - -*YAML* utiliza sangría con uno o más espacios para describir colecciones anidadas: - -.. code-block:: yaml - - "symfony 1.0": - PHP: 5.0 - Propel: 1.2 - "symfony 1.2": - PHP: 5.2 - Propel: 1.3 - -El *YAML* anterior es equivalente al siguiente código *PHP*: - -.. code-block:: php - - array( - 'symfony 1.0' => array( - 'PHP' => 5.0, - 'Propel' => 1.2, - ), - 'symfony 1.2' => array( - 'PHP' => 5.2, - 'Propel' => 1.3, - ), - ); - -Hay una cosa importante que tienes que recordar cuando utilices sangría en un archivo *YAML*: *La sangría se debe hacer con uno o más espacios, pero nunca con tabulaciones*. - -Puedes anidar secuencias y asignaciones a tu gusto: - -.. code-block:: yaml - - 'Chapter 1': - - Introduction - - Event Types - 'Chapter 2': - - Introduction - - Helpers - -*YAML* también puede utilizar estilos de flujo para colecciones, utilizando indicadores explícitos en lugar de sangría para denotar el alcance. - -Puedes escribir una secuencia como una lista separada por comas entre corchetes (``[]``): - -.. code-block:: yaml - - [PHP, Perl, Python] - -Una asignación se puede escribir como una lista separada por comas de clave/valores dentro de llaves (``{}``): - -.. code-block:: yaml - - { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 } - -Puedes mezclar y combinar estilos para conseguir mejor legibilidad: - -.. code-block:: yaml - - 'Chapter 1': [Introduction, Event Types] - 'Chapter 2': [Introduction, Helpers] - -.. code-block:: yaml - - "symfony 1.0": { PHP: 5.0, Propel: 1.2 } - "symfony 1.2": { PHP: 5.2, Propel: 1.3 } - -Comentarios ------------ - -En *YAML* puedes añadir comentarios anteponiendo una almohadilla (``#``): - -.. code-block:: yaml - - # Comentario en una línea - "symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comentario al final de una línea - "symfony 1.2": { PHP: 5.2, Propel: 1.3 } - -.. note:: - - Los comentarios simplemente son ignorados por el analizador de *YAML* y no es necesario sangrarlos de acuerdo al nivel de anidamiento actual de una colección. - -.. _YAML: http://yaml.org/ diff --git a/_sources/contributing/code/bugs.txt b/_sources/contributing/code/bugs.txt deleted file mode 100644 index 88131f6..0000000 --- a/_sources/contributing/code/bugs.txt +++ /dev/null @@ -1,30 +0,0 @@ -Informando de errores -===================== - -Cada vez que encuentres un error en *Symfony2*, te rogamos que lo informes. Nos ayuda a hacer un mejor *Symfony2*. - -.. caution:: - - Si piensas que has encontrado un problema de seguridad, por favor, en su lugar, usa el :doc:`procedimiento ` especial. - -Antes de enviar un error: - -* Revisa cuidadosamente la `documentación`_ oficial para ver si no estás usando incorrectamente la plataforma; - -* Pide ayuda en la `lista de correo de usuarios`_, el `foro`_, o en el `canal IRC`_ *#symfony* si no estás seguro de que el problema realmente sea un error. - -Si tu problema definitivamente se ve como un error, informa el fallo usando el `tracker`_ oficial siguiendo algunas reglas básicas: - -* Utiliza el campo título para describir claramente el problema; - -* Describe los pasos necesarios para reproducir el error con breves ejemplos de código (proporcionando una prueba unitaria que ilustre mejor el error); - -* Indica lo más detalladamente posible tu entorno (sistema operativo, versión de *PHP*, versión de *Symfony*, extensiones habilitadas, ...); - -* *(opcional)* Adjunta un :doc:`parche `. - -.. _`documentación`: http://symfony.com/doc/2.0/ -.. _`lista de correo de usuarios`: http://groups.google.com/group/symfony-users -.. _`foro`: http://forum.symfony-project.org/ -.. _`canal IRC`: irc://irc.freenode.net/symfony -.. _`tracker`: https://github.com/symfony/symfony/issues diff --git a/_sources/contributing/code/conventions.txt b/_sources/contributing/code/conventions.txt deleted file mode 100644 index deb7aa1..0000000 --- a/_sources/contributing/code/conventions.txt +++ /dev/null @@ -1,90 +0,0 @@ -Convenciones -============ - -El documento :doc:`estándares ` describe las normas de codificación de los proyectos *Symfony2* y los paquetes internos de terceros. Este documento describe los estándares de codificación y convenciones utilizadas en la plataforma básica para que sea más consistente y predecible. Las puedes seguir en tu propio código, pero no es necesario. - -Nombres de método ------------------ - -Cuando un objeto tiene una relación «principal» con muchas «cosas» relacionadas (objetos, parámetros, ...), los nombres de los métodos están normalizados: - - * ``get()`` - * ``set()`` - * ``has()`` - * ``all()`` - * ``replace()`` - * ``remove()`` - * ``clear()`` - * ``isEmpty()`` - * ``add()`` - * ``register()`` - * ``count()`` - * ``keys()`` - -El uso de estos métodos sólo se permite cuando es evidente que existe una relación principal: - -* un ``CookieJar`` tiene muchos objetos :dfn:`Cookie`; - -* un ``Contenedor`` de servicios tiene muchos servicios y muchos parámetros (dado que los servicios son la relación principal, utilizamos la convención de nomenclatura para esta relación); - -* una Consola ``Input`` tiene muchos argumentos y muchas opciones. No hay una relación «principal», por lo tanto no aplica la convención de nomenclatura. - -Para muchas relaciones cuando la convención no aplica, en su lugar se deben utilizar los siguientes métodos (donde ``XXX`` es el nombre de aquello relacionado): - -+----------------+-------------------+ -| Relación | Otras relaciones | -| principal | | -+================+===================+ -| ``get()`` | ``getXXX()`` | -+----------------+-------------------+ -| ``set()`` | ``setXXX()`` | -+----------------+-------------------+ -| n/a | ``replaceXXX()`` | -+----------------+-------------------+ -| ``has()`` | ``hasXXX()`` | -+----------------+-------------------+ -| ``all()`` | ``getXXXs()`` | -+----------------+-------------------+ -| ``replace()`` | ``setXXXs()`` | -+----------------+-------------------+ -| ``remove()`` | ``removeXXX()`` | -+----------------+-------------------+ -| ``clear()`` | ``clearXXX()`` | -+----------------+-------------------+ -| ``isEmpty()`` | ``isEmptyXXX()`` | -+----------------+-------------------+ -| ``add()`` | ``addXXX()`` | -+----------------+-------------------+ -| ``register()`` | ``registerXXX()`` | -+----------------+-------------------+ -| ``count()`` | ``countXXX()`` | -+----------------+-------------------+ -| ``keys()`` | n/a | -+----------------+-------------------+ - -.. note:: - - Si bien «setXXX» y «replaceXXX» son muy similares, hay una notable diferencia: «setXXX» puede sustituir o agregar nuevos elementos a la relación. - «replaceXXX», por otro lado, no puede añadir nuevos elementos. Si se pasa una clave no reconocida a «replaceXXX», lanzará una excepción. - -.. _contributing-code-conventions-deprecations: - -Depreciaciones --------------- - -De vez en cuando, algunas clases y/o métodos son depreciados en la plataforma; esto sucede cuando la implementación de una característica no se puede cambiar debido a cuestiones de compatibilidad hacia atrás, pero todavía queremos proponer una mejor «alternativa». En este caso, la antigua implementación sencillamente se puede **depreciar**. - -Una característica es marcada como depreciada añadiendo una anotación ``@deprecated`` de *phpdoc* a las clases, métodos, propiedades, ... pertinentes:: - - /** - * @deprecated Depreciada a partir de la versión 2.X, será removida en 2.Y. En su lugar usa XXX. - */ - -El mensaje de la depreciación debería indicar la versión cuándo el método/clase fue depreciado, la versión cuándo será removido, y siempre que sea posible, cómo sustituir la característica. - -Un error ``E_USER_DEPRECATED`` de *PHP* también será provocado para ayudar a las personas con la migración empezando una o dos versiones menores antes de la versión donde la característica será removida (dependiendo de lo delicado de la extracción):: - - trigger_error( - 'XXX() está depreciada a partir de la versión 2.X, será removida en 2.Y. En su lugar usa XXX.', - E_USER_DEPRECATED - ); diff --git a/_sources/contributing/code/git.txt b/_sources/contributing/code/git.txt deleted file mode 100644 index 7bf8e1c..0000000 --- a/_sources/contributing/code/git.txt +++ /dev/null @@ -1,42 +0,0 @@ -Git -=== - -This document explains some conventions and specificities in the way we manage -the Symfony code with Git. - -Pull Requests -------------- - -Whenever a pull request is merged, all the information contained in the pull -request (including comments) is saved in the repository. - -You can easily spot pull request merges as the commit message always follows -this pattern: - -.. block: text - - merged branch USER_NAME/BRANCH_NAME (PR #1111) - -The PR reference allows you to have a look at the original pull request on -Github: https://github.com/symfony/symfony/pull/1111. But all the information -you can get on Github is also available from the repository itself. - -The merge commit message contains the original message from the author of the -changes. Often, this can help understand what the changes were about and the -reasoning behind the changes. - -Moreover, the full discussion that might have occurred back then is also -stored as a Git note (before March 22 2013, the discussion was part of the -main merge commit message). To get access to these notes, add this line to -your ``.git/config`` file: - -.. block: text - - fetch = +refs/notes/*:refs/notes/* - -After a fetch, getting the Github discussion for a commit is then a matter of -adding ``--show-notes=github-comments`` to the ``git show`` command: - -.. block: text - - git show HEAD --show-notes=github-comments diff --git a/_sources/contributing/code/index.txt b/_sources/contributing/code/index.txt deleted file mode 100644 index a6a4406..0000000 --- a/_sources/contributing/code/index.txt +++ /dev/null @@ -1,14 +0,0 @@ -Aportando código -================ - -.. toctree:: - :maxdepth: 2 - - bugs - patches - security - tests - standards - conventions - git - license diff --git a/_sources/contributing/code/license.txt b/_sources/contributing/code/license.txt deleted file mode 100644 index 9ad850f..0000000 --- a/_sources/contributing/code/license.txt +++ /dev/null @@ -1,40 +0,0 @@ -Licencia *Symfony2* -=================== - -*Symfony2* se libera bajo la licencia *MIT*. - -De acuerdo con `Wikipedia`_: - - "Es una licencia permisiva, lo cual significa que permite la - reutilización dentro de software propietario a condición de que la - licencia se distribuya con el software. Esta también es compatible - con la licencia *GPL*, lo cual significa que la licencia *GPL* - permite la combinación y redistribución, con el software que utiliza - la licencia *MIT*". - -La Licencia ------------ - -Copyright (c) 2004-2013 Fabien Potencier -Copyright (c) 2011-2013 Nacho Pacheco - -Se autoriza, de forma gratuita, a cualquier persona que obtenga una -copia de este software y archivos de documentación asociados (el -"Software"), a trabajar con el Software sin restricción, incluyendo sin -limitación, los derechos para usar, copiar, modificar, fusionar, -publicar, distribuir, sublicenciar y/o vender copias del Software, y a -permitir a las personas a quienes se proporcione el Software a hacerlo, -sujeto a las siguientes condiciones: - -El aviso de copyright anterior y este aviso de autorización se incluirán -en todas las copias o partes sustanciales del Software. - -EL SOFTWARE SE ENTREGA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA -O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE -COMERCIALIZACIÓN, ADECUACIÓN A UN PROPÓSITO PARTICULAR Y NO -INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DEL COPYRIGHT SERÁN -RESPONSABLES DE NINGUNA RECLAMACIÓN, DAÑO U OTRA RESPONSABILIDAD, YA SEA -EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRA, DERIVADA DE, O EN RELACIÓN -CON LA UTILIZACIÓN DEL SOFTWARE U OTRAS OPERACIONES EN EL SOFTWARE. - -.. _Wikipedia: http://en.wikipedia.org/wiki/MIT_License diff --git a/_sources/contributing/code/patches.txt b/_sources/contributing/code/patches.txt deleted file mode 100644 index 7ca2557..0000000 --- a/_sources/contributing/code/patches.txt +++ /dev/null @@ -1,333 +0,0 @@ -Enviando un parche -================== - -Los parches son la mejor manera de proporcionar una corrección de error o de proponer mejoras a *Symfony2*. - -Paso 1: Configura tu entorno ----------------------------- - -Instalando el software necesario -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de trabajar en *Symfony2*, configura un entorno amigable con el siguiente software: - -* *Git*; -* *PHP* version 5.3.3 o más reciente; -* *PHPUnit* 3.6.4 o más reciente. - -Configura *Git* -~~~~~~~~~~~~~~~ - -Configura la información de usuario con tu nombre real y una dirección de correo electrónico operativa: - -.. code-block:: bash - - $ git config --global user.name "Tu nombre" - $ git config --global user.email tu@ejemplo.com - -.. tip:: - - Si eres nuevo en *Git*, es muy recomendable que leas el excelente libro `ProGit`_, que además es gratis. - -.. tip:: - - Si tu *IDE* crea los archivos de configuración dentro del directorio del proyecto, puedes usar el archivo global ``.gitignore`` (para todos los proyectos) o el archivo ``.git/info/exclude`` (por proyecto) para descartarlos. Consulta la `documentación de Github`_. - -.. tip:: - - Usuarios de Windows: al instalar *Git*, se te preguntará qué hacer con los finales de línea y te sugiere reemplazar todos los ``LF`` por ``CRLF``. ¡Esta es la opción incorrecta si deseas contribuir con *Symfony*! Seleccionar el método tal cual es tu mejor opción, puesto que *Git* convertirá tus saltos de línea a los del repositorio. Si ya has instalado *Git*, puedes comprobar el valor de esta opción escribiendo: - - .. code-block:: bash - - $ git config core.autocrlf - - Esto devolverá o bien ``«false»``, ``«input»`` o ``«true»``, ``«true»`` y ``«false»`` son valores incorrectos. Para fijarlo a otro valor, escribe: - - .. code-block:: bash - - $ git config --global core.autocrlf input - - Sustituye ``--global`` por ``--local`` si lo quieres fijar únicamente para el repositorio activo. - -Consigue el código fuente de *Symfony* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Obtén el código fuente de *Symfony2*: - -* Crea una cuenta `GitHub`_ e ingresa; - -* Consigue el `repositorio Symfony2`_ (haz clic en el botón «Fork»); - -* Después de concluida la «acción de bifurcar el núcleo», clona tu bifurcación a nivel local (esto creará un directorio `symfony`): - -.. code-block:: bash - - $ git clone git@github.com:NOMBREUSUARIO/symfony.git - -* Añade el repositorio como remoto de escritura: - -.. code-block:: bash - - $ cd symfony - $ git remote add upstream git://github.com/symfony/symfony.git - -Comprueba que pasa la batería de pruebas actual -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora que *Symfony2* está instalado, comprueba que todas las pruebas unitarias pasan en tu entorno como se explica en el :doc:`documento ` dedicado. - -Paso 2: Trabaja en tu parche ----------------------------- - -La Licencia -~~~~~~~~~~~ - -Antes de empezar, debes saber que todos los parches que envíes se deben liberar bajo la *Licencia MIT*, a menos que explícitamente lo especifiques en tus confirmaciones de cambios. - -Eligiendo la rama adecuada -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Antes de trabajar en tu parche, debes determinar en cual rama necesitas trabajar. La rama debe estar basada en la rama ``master`` si deseas agregar una nueva característica. Pero, si deseas corregir un fallo, utiliza la versión más antigua, pero aún mantenida de *Symfony* donde ocurre el fallo (como ``2.0``). - -.. note:: - - Todas las correcciones de fallos se fusionarán en las ramas de mantenimiento y además se fusionaran regularmente en las ramas más recientes. Por ejemplo, si envías un parche para la rama ``2.0``, el parche también será aplicado por el equipo del núcleo a la rama ``master``. - -Crea una rama para ese asunto -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada vez que desees trabajar en un parche para un fallo o una mejora, crea una rama para ese asunto: - -.. code-block:: bash - - $ git checkout -b NOMBRE_RAMA master - -O, si deseas proporcionar una corrección de fallo para la rama 2.0, en primer lugar, actualiza tu copia local a la rama `2.0`: - -.. code-block:: bash - - $ git checkout -t origin/2.0 - -Luego, crea una nueva rama de la rama 2.0 para trabajar en la corrección del fallo: - -.. code-block:: bash - - $ git checkout -b NOMBRE_RAMA 2.0 - -.. tip:: - - Utiliza un nombre descriptivo para tu rama (``ticket_XXX`` donde ``XXX`` es el número del boleto, esta es una buena convención para la corrección de fallos). - -La orden ``checkout`` anterior, automáticamente cambia el código a la rama recién creada (para ver la rama en que estás trabajando utiliza ``git branch``). - -Trabaja en tu parche -~~~~~~~~~~~~~~~~~~~~ - -Trabaja en el código tanto como quieras y confirma tus cambios tanto como desees; pero ten en cuenta lo siguiente: - -* Lee sobre las :doc:`convenciones ` de *Symfony* y sigue los :doc:`estándares ` de codificación (usa `git diff --check` para verificar los espacios finales -- también lee el consejo de abajo); - -* Añade pruebas unitarias para probar que el fallo se corrigió o que la nueva característica realmente funciona; - -* Esfuérzate para no romper la compatibilidad hacia atrás (si debes hacerlo, trata de proporcionar una capa de compatibilidad para apoyar la manera antigua) --- los parches que rompen la compatibilidad con versiones anteriores tienen menos posibilidades de que se fusionen; - -* Haz confirmaciones atómicas y separadas lógicamente (usa el poder de ``git rebase`` para tener un historial limpio y lógico); - -* Aplana confirmaciones de cambios irrelevantes que estén a punto de comprometer los estándares de codificación o corrigen fallos en tu propio código; - -* No corrijas los estándares de codificación en algún código existente, ya que dificulta la revisión del código; - -* Escribe buenos mensajes de confirmación (ve el consejo más adelante). - -.. tip:: - - Puedes comprobar los estándares de codificación de tu parche ejecutando el siguiente `archivo `_ que puedes conseguir `aquí `_: - - .. code-block:: bash - - $ cd /ruta/a/symfony/src - $ php symfony-cs-fixer.phar fix . Symfony20Finder - -.. tip:: - - Un buen mensaje de confirmación de cambios sustancial está compuesto por un resumen (en la primera línea), seguido opcionalmente por una línea en blanco y una descripción más detallada. El resumen debe comenzar con el componente en el que estás trabajando entre corchetes (``[DependencyInjection]``, ``[FrameworkBundle]``, ...). Utiliza un verbo (``fixed...``, ``added...``, ...) para iniciar el resumen y no agregues un punto al final. - -Prepara tu parche para enviarlo -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cuando tu parche no se trata de una corrección de fallo (cuando agregas una nueva característica o cambias una existente, por ejemplo), además debes incluir lo siguiente: - -* Una explicación de los cambios en el/los archivo(s) ``CHANGELOG`` correspondiente(s) (cuando sea pertinente debes usar los prefijos ``[BC BREAK]`` o ``[DEPRECATION]``); - -* Una explicación sobre cómo actualizar una aplicación existente en el archivo ``UPGRADE`` correspondiente si los cambios rompen la compatibilidad hacia atrás o si depreciaste algo que a la larga rompa la compatibilidad hacia atrás. - -Paso 3: Envía tu parche ------------------------ - -Siempre que sientas que tu parche esté listo para su presentación, sigue los siguientes pasos. - -Reorganiza tu parche -~~~~~~~~~~~~~~~~~~~~ - -Antes de presentar tu revisión, actualiza tu rama (es necesario si te toma cierto tiempo terminar los cambios): - -.. code-block:: bash - - $ git checkout master - $ git fetch upstream - $ git merge upstream/master - $ git checkout NOMBRE_RAMA - $ git rebase master - -.. tip:: - - Sustituye ``master`` con ``2.0`` si estás trabajando en una corrección de fallo - -Al ejecutar la orden ``rebase``, posiblemente tengas que arreglar conflictos de fusión. -``git status`` te mostrará los archivos *sin fusionar*. Resuelve todos los conflictos, y luego continua el rebase: - -.. code-block:: bash - - $ git add ... # Añade archivos resueltos - $ git rebase --continue - -Comprueba que todas las pruebas todavía pasan y envía a tu rama remota: - -.. code-block:: bash - - $ git push origin NOMBRE_RAMA - -Envía una solicitud de atracción -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora puedes hacer una solicitud de atracción en el repositorio ``symfony/synfony`` de *Github*. - -.. tip:: - - Ten cuidado de marcar tu solicitud de atracción para ``symfony:2.1`` si deseas que el equipo del núcleo atraiga una corrección de fallo basada en la rama 2.1. - -Para facilitar el trabajo del equipo del núcleo, siempre incluye los componentes modificados en el mensaje (en inglés) de tu solicitud de atracción, como este: - -.. code-block:: text - - [Yaml] fixed something - [Form] [Validator] [FrameworkBundle] added something - -La descripción de la solicitud de atracción debe incluir la siguiente lista de comprobación en la parte superior para garantizar que las aportaciones se pueden revisar sin la necesidad infinitos ciclos de retroalimentación y que tus aportaciones se pueden incluir a *Symfony2* tan rápidamente como sea posible: - -.. code-block:: text - - | Q | A - | ------------- | --- - | Bug fix? | [yes|no] - | New feature? | [yes|no] - | BC breaks? | [yes|no] - | Deprecations? | [yes|no] - | Tests pass? | [yes|no] - | Fixed tickets | [lista separada por comas de las entradas corregidas por el PR] - | License | MIT - | Doc PR | [Referencia a la documentación del PR, si la hay] - -Un envío de ejemplo ahora se ve de la siguiente manera: - -.. code-block:: text - - | Q | A - | ------------- | --- - | Bug fix? | no - | New feature? | no - | BC breaks? | no - | Deprecations? | no - | Tests pass? | yes - | Fixed tickets | #12, #43 - | License | MIT - | Doc PR | symfony/symfony-docs#123 - -Debes incluir la tabla completa (**no** quites líneas que pienses que no son relevantes). Para errores tipográficos sencillos, cambios menores en la *PHPDocs*, o cambios en los archivos de traducción, usa la versión corta de la lista de comprobación: - -.. code-block:: text - - | Q | A - | ------------- | --- - | Fixed tickets | [lista separada por comas de las entradas corregidas por el PR] - | License | MIT - -Algunas respuestas a cuestiones que provocan algunos requisitos adicionales: - - * Si contestaste ``yes`` a ``«Bug fix?»``, comprueba si el fallo ya está enumerado en los problemas de *Symfony* y proporciona una referencia a la(s) «entrada(s) corregida(s)»; - - * Si contestaste ``yes`` a ``«New feature?»``, debes enviar una solicitud de atracción a la documentación y referirla bajo la sección ``«Doc PR»``; - - * Si contestaste ``yes`` a ``«BC breaks?»``, el parche debe contener actualizaciones a los archivos ``CHANGELOG`` y ``UPGRADE`` pertinentes; - - * Si contestaste ``yes`` a ``«Deprecations?»``, el parche debe contener actualizaciones a los archivos ``CHANGELOG`` y ``UPGRADE`` pertinentes; - - * Si contestaste ``no`` a ``«Tests pass»``, debes añadir un elemento a una lista de pendientes con las acciones que se deben tomar para corregir las pruebas; - - * Si la ``«license»`` no es *MIT*, sólo no envíes la solicitud de atracción puesto que no será aceptada en ningún caso. - -Si no cubres alguno de los requisitos anteriores, crea una lista de pendientes y añade los -elementos pertinentes: - -.. code-block:: text - - - [ ] fix the tests as they have not been updated yet - - [ ] submit changes to the documentation - - [ ] document the BC breaks - -Si el código no está terminado todavía porque no tienes tiempo para acabarlo o porque quieres retroalimentación temprana sobre tu trabajo, añade un elemento a la lista de pendientes: - -.. code-block:: text - - - [ ] finish the code - - [ ] gather feedback my changes - -Mientras tengas elementos en la lista de pendientes, por favor prefija el título de la petición -de atracción con ``«[WIP]»``. - -En la descripción de tu solicitud de atracción, da tantos detalles como sea posible acerca de tus cambios (no dudes en dar ejemplos de código para ilustrar tus puntos). Si tu solicitud de atracción está a punto de añadir una nueva característica o modificar una existente, explica las razones para los cambios. La descripción de la solicitud de atracción ayuda a la revisión del código y sirve como referencia al fusionar el código (la descripción de la solicitud de atracción y todos tus comentarios asociados son parte del mensaje de confirmación de la fusión). - -Además de este ``código`` de la solicitud de atracción, también debes enviar una solicitud de atracción al `repositorio de documentación`_ para actualizar la documentación cuando sea apropiado. - -Revisando tu parche -~~~~~~~~~~~~~~~~~~~ - -Basándote en la retroalimentación sobre tu solicitud de atracción, posiblemente debas volver a trabajar en tu parche. Antes de volver a presentarlo, reorganiza con ``upstream/master`` o ``upstream/2.0``, no lo fusiones; y fuerza el envío al origen: - -.. code-block:: bash - - $ git rebase -f upstream/master - $ git push -f origin NOMBRE_RAMA - -.. note:: - - cuando haces un ``push --force``, **siempre** especifica el nombre de la rama de forma explícita para evitar dañar otras ramas en el repositorio (``--force`` le dice a *Git* que realmente quieres meterte con esas cosas por lo tanto hazlo con mucho cuidado). - -A menudo, los moderadores te pedirán que «aplanes» tus confirmaciones de cambios. Lo cual significa que combines varias confirmaciones de cambios en una sola. Para ello, utiliza la orden ``rebase``: - -.. code-block:: bash - - $ git rebase -i HEAD~3 - $ git push -f origin NOMBRE_RAMA - -Aquí, el número 3 debe ser igual a la cantidad de confirmaciones de cambios en tu rama. Después que escribas esta orden, aparecerá un editor mostrándote la lista de confirmaciones de cambios: - -.. code-block:: text - - pick 1a31be6 first commit - pick 7fc64b4 second commit - pick 7d33018 third commit - -Para revertir todas las confirmaciones de cambios a la primera, elimina la palabra ``«pick»`` antes de la segunda y última confirmación de cambios, y sustitúyela por la palabra ``«squash»`` o simplemente ``«s»``. -Cuando guardes, *Git* iniciará el rebase, y si tiene éxito, te pedirá que -edites el mensaje de confirmación, el cual de manera predefinida es una lista con todos los mensajes de las confirmaciones de cambios. Cuando hayas terminado, ejecuta la orden ``push``. - -.. _`ProGit`: http://git-scm.com/book -.. _`GitHub`: https://github.com/signup/free -.. _`documentación de Github`: https://help.github.com/articles/ignoring-files -.. _`repositorio Symfony2`: https://github.com/symfony/symfony -.. _`lista de correo dev`: http://groups.google.com/group/symfony-devs -.. _travis-ci.org: https://travis-ci.org/ -.. _`icono de estado de travis-ci.org`: http://about.travis-ci.org/docs/user/status-images/ -.. _`guía comenzando con travis-ci.org`: http://about.travis-ci.org/docs/user/getting-started/ -.. _`repositorio de documentación`: https://github.com/symfony/symfony-docs diff --git a/_sources/contributing/code/security.txt b/_sources/contributing/code/security.txt deleted file mode 100644 index df2ddd3..0000000 --- a/_sources/contributing/code/security.txt +++ /dev/null @@ -1,69 +0,0 @@ -Problemas de seguridad -====================== - -Este documento explica cómo maneja el equipo del núcleo de *Symfony* los problemas de seguridad (*Symfony* es el código alojado en el `repositorio Git`_ principal ``symfony/symfony``). - -Informando un problema de seguridad ------------------------------------ - -Si crees que has encontrado un problema de seguridad en *Symfony*, no utilices la lista de correo o el rastreador de fallos y no lo divulgues públicamente. En su lugar, todos los problemas de seguridad se tienen que enviar a **security arroba symfony.com**. Los correos electrónicos enviados a esta dirección se reenvían a la lista de correo privado del equipo del núcleo. - -Proceso de resolución ---------------------- - -Para cada informe, en primer lugar, trata de confirmar la vulnerabilidad. Cuando esté confirmada, el equipo del núcleo trabaja en una solución siguiendo estos pasos: - -1. Envía un reconocimiento al informante; -2. Trabaja en un parche; -3. Obtiene un identificador *CVE* (por ``«Common Vulnerabilities and Exposures»``) de cve.mitre.org; -4. Escribe un anuncio de seguridad para el `blog`_ oficial de *Symfony* sobre la vulnerabilidad. Este comunicado debería contener la siguiente información: - - * Un título que siempre incluya la cadena ``«Security release»``; - * Una descripción de la vulnerabilidad; - * Las versiones afectadas; - * La posible explotación; - * Cómo afecta el parche/actualización/solución del problema a las aplicaciones; - * El identificador *CVE*; - * Créditos. -5. Envia el parche y anuncio al reportero para revisión; -6. Aplica el parche en todas las versiones mantenidas de *Symfony*; -7. Empaca las nuevas versiones para todas las versiones afectadas; -8. Publica un comunicado en el `blog`_ oficial de *Symfony* (también se tiene que añadir a la categoría «`Avisos de seguridad`_»); -9. Actualiza la lista de avisos de seguridad (ve abajo). - -.. note:: - - Versiones que incluyen problemas de seguridad no se tendrían que hacer en sábado o domingo, excepto si la vulnerabilidad se difundió públicamente. - -.. note:: - - Mientras estemos trabajando en un parche, por favor, no reveles el tema públicamente. - -Avisos de seguridad -------------------- - -Estas sección registra en orden cronológico las vulnerabilidades de seguridad que fueron corregidas en las diferentes versiones de *Symfony*, empezando en *Symfony 1.0.0*: - -* Enero 17, 2013: `Emisión de seguridad: Liberados *Symfony* 2.0.22 y 2.1.7 `_ (`CVE-2013-1348 `_ y `CVE-2013-1397 `_) -* Diciembre 20, 2012: `Emisión de seguridad: Symfony 2.0.20 y 2.1.5 `_ (`CVE-2012-6431 `_ y `CVE-2012-6432 `_) -* Noviembre 29, 2012: `Emisión de seguridad: Symfony 2.0.19 y 2.1.4 `_ -* Noviembre 25, 2012: `Emisión de seguridad: Symfony 1.4.20 liberado `_ (`CVE-2012-5574 `_) -* Agosto 28, 2011: `Emisión de seguridad: Symfony 2.0.17 liberado `_ -* Mayo 30, 2012: `Emisión de seguridad: Symfony 1.4.18 liberado `_ (`CVE-2012-2667 `_) -* Febrero 24, 2012: `Emisión de seguridad: Symfony 2.0.11 liberado `_ -* Noviembre 16, 2011: `Emisión de seguridad: Symfony 2.0.6 `_ -* Marzo 21, 2011: `symfony 1.3.10 y 1.4.10: versiones de seguridad `_ -* Junio 29, 2010: `Emisión de seguridad: symfony 1.3.6 y 1.4.6 `_ -* Mayo 31, 2010: `symfony 1.3.5 y 1.4.5 `_ -* Febrero 25, 2010: `Emisión de seguridad: 1.2.12, 1.3.3 y 1.4.3 `_ -* Febrero 13, 2010: `symfony 1.3.2 y 1.4.2 `_ -* Abril 27, 2009: `symfony 1.2.6: Parche de seguridad `_ -* Octubre 3, 2008: `symfony 1.1.4 liberado: Parche de seguridad `_ -* Mayo 14, 2008: `symfony 1.0.16 está fuera `_ -* Abril 01, 2008: `symfony 1.0.13 está fuera `_ -* Marzo 21, 2008: `¡symfony 1.0.12 (finalmente) está fuera! `_ -* Junio 25, 2007: `symfony 1.0.5 publicado (parche de seguridad) `_ - -.. _`repositorio Git`: https://github.com/symfony/symfony -.. _blog: http://symfony.com/blog/ -.. _`Avisos de seguridad`: http://symfony.com/blog/category/security-advisories diff --git a/_sources/contributing/code/standards.txt b/_sources/contributing/code/standards.txt deleted file mode 100644 index 43ed480..0000000 --- a/_sources/contributing/code/standards.txt +++ /dev/null @@ -1,138 +0,0 @@ -Estándares de codificación -========================== - -Cuando aportes código a *Symfony2*, debes seguir sus estándares de codificación. Para no hacer el cuento largo, aquí está la regla de oro: **limítate el código Symfony2 existente**. La mayoría de los Paquetes de código abierto y librerías utilizadas por *Symfony2* también siguen las mismas pautas, y también deberías hacerlo. - -Recuerda que la principal ventaja de los estándares es que cada pieza de código se ve y se siente familiar, no se trata de que esta o esa sea más legible. - -*Symfony* sigue los estándares definidos en los documentos `PSR-0`_, `PSR-1`_ y `PSR-2`_. - -Ya que una imagen ---o algún código--- vale más que mil palabras, he aquí un pequeño ejemplo que contiene la mayoría de las funciones descritas más adelante: - -.. code-block:: html+php - - - * - * For the full copyright and license information, please view the LICENSE - * file that was distributed with this source code. - */ - - namespace Acme; - - /** - * Demostración de estándares de la codificación. - */ - class FooBar - { - const SOME_CONST = 42; - - private $fooBar; - - /** - * @param string $dummy Some argument description - */ - public function __construct($dummy) - { - $this->fooBar = $this->transformText($dummy); - } - - /** - * @param string $dummy Some argument description - * @param array $options - * - * @return string|null Transformed input - */ - private function transformText($dummy, $options = array()) - { - $mergedOptions = array_merge( - $options, - array( - 'some_default' => 'values', - 'another_default' => 'more values', - ) - ); - - if (true === $dummy) { - return; - } - if ('string' === $dummy) { - if ('values' === $mergedOptions['some_default']) { - $dummy = substr($dummy, 0, 5); - } else { - $dummy = ucwords($dummy); - } - } else { - throw new \RuntimeException(sprintf('Unrecognized dummy option "%s"', $dummy)); - } - - return $dummy; - } - } - -Estructura ----------- - -* Añade un solo espacio después de cada delimitador coma; - -* Añade un solo espacio alrededor de los operadores (``==``, ``&&``, ...); - -* Añade una coma después de cada elemento del arreglo en un arreglo multilínea, incluso después del último; - -* Añade una línea en blanco antes de las declaraciones ``return``, a menos que el valor devuelto solo sea dentro de un grupo de declaraciones (tal como una declaración ``if``); - -* Usa llaves para indicar la estructura del cuerpo de control, independientemente del número de declaraciones que contenga; - -* Define una clase por archivo --- esto no se aplica a las clases ayudante privadas, de las cuales no se tiene la intención de crear una instancia desde el exterior y por lo tanto no les preocupa la norma `PSR-0`_; - -* Declara las propiedades de clase antes que los métodos; - -* Declare public methods first, then protected ones and finally private ones; - -* Use parentheses when instantiating classes regardless of the number of - arguments the constructor has; - -* Exception message strings should be concatenated using :phpfunction:`sprintf`. - -Convenciones de nomenclatura ----------------------------- - -* Utiliza mayúsculas intercaladas ---sin guiones bajos--- en nombres de variable, función, método o argumentos; - -* Usa guiones bajos para nombres de opción y nombres de parámetro; - -* Utiliza espacios de nombres para todas las clases; - -* Prefija las clases abstractas con ``Abstract``. Por favor, ten en cuenta que algunas de las primeras clases de *Symfony2* no siguen esta convención y no se han rebautizado por razones de compatibilidad hacia atrás. No obstante, todas las nuevas clases abstractas tienen que seguir esta convención de nomenclatura; - -* Sufija las interfaces con ``Interface``; - -* Sufijo las características con ``Trait``; - -* Sufija las excepciones con ``Exception``; - -* Utiliza caracteres alfanuméricos y guiones bajos para los nombres de archivo; - -* No olvides consultar el documento más detallado :doc:`conventions` para más consideraciones de nomenclatura subjetivas. - -Documentación -------------- - -* Añade bloques *PHPDoc* a todas las clases, métodos y funciones; - -* Omite la etiqueta ``@return`` si el método no devuelve nada; - -* Las anotaciones `@package` y `@subpackage` no se utilizan. - -Licencia --------- - -* *Symfony* se distribuye bajo la licencia *MIT*, y el bloque de la licencia tiene que estar presente en la parte superior de todos los archivos *PHP*, antes del espacio de nombres. - -.. _`PSR-0`: https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md -.. _`PSR-1`: https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md -.. _`PSR-2`: https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md diff --git a/_sources/contributing/code/tests.txt b/_sources/contributing/code/tests.txt deleted file mode 100644 index 3ad455c..0000000 --- a/_sources/contributing/code/tests.txt +++ /dev/null @@ -1,104 +0,0 @@ -Corriendo las pruebas de *Symfony2* -=================================== - -Antes de presentar un :doc:`parche ` para su inclusión, es necesario ejecutar la batería de pruebas de *Symfony2* para comprobar que no ha roto nada. - -*PHPUnit* ---------- - -Para ejecutar la batería de pruebas de *Symfony2*, primero `instala PHPUnit`_ 3.6.4 o superior: - -.. code-block:: bash - - $ pear config-set auto_discover 1 - $ pear install pear.phpunit.de/PHPUnit - -Dependencias (opcional) ------------------------ - -Para ejecutar la batería de pruebas completa, incluyendo las pruebas supeditadas con dependencias externas, *Symfony2* tiene que ser capaz de cargarlas automáticamente. De forma predeterminada, se cargan automáticamente desde :file:`vendor/` en la raíz del directorio principal (consulta la sección :file:`autoload.php.dist`). - -La batería de pruebas necesita las siguientes bibliotecas de terceros: - -* Doctrine -* Swiftmailer -* Twig -* Monolog - -Para instalarlas todas, usa `Composer`_: - -Paso 1: Consigue `Composer`_ - -.. code-block:: bash - - curl -s http://getcomposer.org/installer | php - -Asegúrate de descargar :file:`composer.phar` en el mismo directorio dónde se encuentra el archivo :file:`composer.json`. - -Paso 2: Instala las bibliotecas de terceros - -.. code-block:: bash - - $ php composer.phar --dev install - -.. note:: - - Ten en cuenta que el guión toma algún tiempo para terminar. - -.. note:: - - Si no tienes instalado ``curl``, simplemente puedes descargar manualmente el archivo ``instalador`` de http://getcomposer.org/installer. Coloca ese archivo en tu proyecto y luego ejecuta: - - .. code-block:: bash - - $ php installer - $ php composer.phar --dev install - -Después de la instalación, puedes actualizar los proveedores en cualquier momento con la siguiente orden. - -.. code-block:: bash - - $ php composer.phar --dev update - -Ejecutando ----------- - -En primer lugar, actualiza los proveedores (consulta más arriba). - -A continuación, ejecuta la batería de pruebas desde el directorio raíz de *Symfony2* con la siguiente orden: - -.. code-block:: bash - - $ phpunit - -La salida debe mostrar `OK`. Si no es así, es necesario averiguar qué está pasando y si las pruebas se rompen a causa de tus modificaciones. - -.. tip:: - - Si deseas probar la ruta de un tipo de componente único después de la orden ``phpunit``, por ejemplo: - - .. code-block:: bash - - $ phpunit src/Symfony/Component/Finder/ - -.. tip:: - - Ejecuta la batería de pruebas antes de aplicar las modificaciones para comprobar que funcionan bien en tu configuración. - -Cobertura de código -------------------- - -Si agregas una nueva característica, también necesitas comprobar la cobertura de código usando la opción `coverage-html`: - -.. code-block:: bash - - $ phpunit --coverage-html=cov/ - -Verifica la cobertura de código abriendo en un navegador la página generada ``cov/index.html``. - -.. tip:: - - La cobertura de código sólo funciona si tienes activado *XDebug* e instaladas todas las dependencias. - -.. _`instala PHPUnit`: http://www.phpunit.de/manual/current/en/installation.html -.. _`Composer`: http://getcomposer.org/ diff --git a/_sources/contributing/community/index.txt b/_sources/contributing/community/index.txt deleted file mode 100644 index 62b68ef..0000000 --- a/_sources/contributing/community/index.txt +++ /dev/null @@ -1,9 +0,0 @@ -Comunidad -========= - -.. toctree:: - :maxdepth: 2 - - releases - irc - other diff --git a/_sources/contributing/community/irc.txt b/_sources/contributing/community/irc.txt deleted file mode 100644 index e979786..0000000 --- a/_sources/contributing/community/irc.txt +++ /dev/null @@ -1,40 +0,0 @@ -Reuniones *IRC* -=============== - -El propósito de esta reunión es deliberar temas en tiempo real con muchos de los desarrolladores de *Symfony2*. - -Cualquier persona puede proponer temas en la lista de correo `symfony-dev`_ hasta 24 horas antes de la reunión, idealmente incluyendo también información preparada pertinentemente a través de una *URL*. 24 horas antes de la reunión será publicado un enlace a `doodle`_ con una lista de todos los temas propuestos. Cualquier persona puede votar los temas hasta el comienzo de la reunión para definir su posición en el orden del día. Cada tema tendrá una duración fija de 15 minutos y la sesión dura una hora, dejando tiempo suficiente para por lo menos 4 temas. - -.. caution:: - - Note that it's not the expected goal of the meeting to find final - solutions, but more to ensure that there is a common understanding of the - issue at hand and move the discussion forward in ways which are hard to - achieve with less real time communication tools. - -Las reuniones son cada jueves a las 17:00 CET (+01:00) en el canal #symfony-dev del servidor Freenode IRC. - -Los `registros`_ IRC se publicarán más tarde en el wiki de trac, el cual incluirá un breve resumen de cada uno de los temas. Puedes crear `tickets` para cualquiera de las tareas o problemas identificados durante la reunión y referidas en el resumen. - -Algunas sencillas instrucciones y orientación para participar: - -* Es posible cambiar tu voto hasta el comienzo de la reunión, haciendo clic en «Editar una entrada»; -* *doodle* cerrará la votación al comienzo de la reunión; -* La agenda se define por los temas que tienen el mayor número de votos en *doodle*, o la que se propuso primero en caso de empate; -* En el comienzo de la reunión una persona se identifica a sí misma como moderador(a); -* El moderador se encarga fundamentalmente de velar por el tiempo de 15 minutos para cada tema y garantizar que las tareas están claramente identificadas; -* Por lo general, el moderador se encargará de escribir el resumen y la creación de entradas en el ``trac`` a menos que alguien más lo releve; -* Cualquier persona puede unirse y expresamente está invitado a participar; -* Lo ideal sería que uno se familiarizara con el tema propuesto antes de la reunión; -* Al iniciar un nuevo tema se invita al proponente a empezar con unas cuantas palabras; -* Cualquiera puede comentar como mejor le parezca; -* Dependiendo de cuántas personas participen, potencialmente debes contenerte de enviar un argumento específico muy difícil; -* Recuerda que los `registros`_ IRC serán publicados más tarde, por lo tanto la gente tiene la oportunidad de revisar los comentarios más adelante; -* Animamos a todos a levantar la mano para asumir las tareas definidas en la reunión. - -Aquí está un `ejemplo`_ doodle. - -.. _`symfony-dev`: http://groups.google.com/group/symfony-devs -.. _`doodle`: http://doodle.com -.. _`registros`: http://trac.symfony-project.org/wiki/Symfony2IRCMeetingLogs -.. _`ejemplo`: http://doodle.com/4cnzme7xys3ay53w diff --git a/_sources/contributing/community/other.txt b/_sources/contributing/community/other.txt deleted file mode 100644 index bb93927..0000000 --- a/_sources/contributing/community/other.txt +++ /dev/null @@ -1,14 +0,0 @@ -Otros recursos -============== - -Con el fin de dar seguimiento a lo que está sucediendo en la comunidad pueden ser útiles estos recursos adicionales: - -* Lista de `peticiones de atracción`_ abiertas -* Lista de `envíos`_ recientes -* Lista de `fallos y mejoras`_ abiertas -* Lista de `paquetes`_ de fuente abierta - -.. _`peticiones de atracción`: https://github.com/symfony/symfony/pulls -.. _`envíos`: https://github.com/symfony/symfony/commits/master -.. _`fallos y mejoras`: https://github.com/symfony/symfony/issues -.. _`paquetes`: http://knpbundles.com/ diff --git a/_sources/contributing/community/releases.txt b/_sources/contributing/community/releases.txt deleted file mode 100644 index 95fbb2d..0000000 --- a/_sources/contributing/community/releases.txt +++ /dev/null @@ -1,93 +0,0 @@ -El proceso de versionado -======================== - -Este documento explica el proceso de versionado de *Symfony* (*Symfony* es el código alojado en el `repositorio Git`_ principal ``symfony/symfony``). - -*Symfony* gestiona sus versiones a través de un *modelo basado en tiempo*; *cada seis meses* sale una nueva versión de *Symfony*: una en *Mayo* y otra en *Noviembre*. - -.. note:: - - Este proceso de versionado fue adoptado a partir de *Symfony 2.2*, y todas las «reglas» explicadas en este documento se deben seguir estrictamente a partir de *Symfony 2.4*. - -Desarrollo ----------- - -El periodo de seis meses se divide en dos fases: - -* *Desarrollo*: *Cuatro meses* para agregar nuevas características y mejorar las existentes; - -* *Estabilización*: *Dos meses* para corregir errores, preparar el lanzamiento y esperar a que el ecosistema de *Symfony* en conjunto (bibliotecas de terceros, paquetes y proyectos que utilizan *Symfony*) se pongan al día. - -Durante la fase de desarrollo, cualquier nueva característica se puede revertir si no será terminada a tiempo o si no estará lo suficientemente estable como para ser incluida en la versión final actual. - -Manteniendo ------------ - -Cada versión de *Symfony* se mantiene durante un determinado periodo de tiempo, en función del tipo de la versión. - -Versiones estándar -~~~~~~~~~~~~~~~~~~ - -Una versión estándar se mantiene durante un periodo de *ocho mes*. - -Plazo de apoyo a versiones mayores -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada dos años, se apoya una nueva versión mayor (también conocidas como versiones *LTS* por *Long Term Support Release*) será publicada. Cada versión *LTS* será apoyada por un periodo de *tres años*. - -.. note:: - - El apoyo pagado después de tres años con el apoyo prestado por la comunidad también se puede comprar en `SensioLabs`_. - -Programa --------- - -A continuación se muestra el cronograma de las primeras versiones que utilizan este modelo de edición: - -.. image:: /images/release-process.jpg - :align: center - -* El **amarillo** representa la fase de desarrollo -* El **azul** representa la fase de estabilización -* El **verde** representa el periodo de mantenimiento - -Este se traduce en fechas y periodos de mantenimiento muy predecibles. - -* *(especial)* *Symfony 2.2* será lanzado a finales de Febrero del 2013; -* *(especial)* *Symfony 2.3* (la primer versión *LTS*) se liberará a finales de Mayo del 2013; -* *Symfony 2.4* será lanzado a finales de Noviembre del 2013; -* *Symfony 2.5* será lanzado a finales de Mayo del 2014; -* ... - -Compatibilidad con versiones anteriores ---------------------------------------- - -Después del lanzamiento de *Symfony 2.3*, la compatibilidad hacia atrás se mantendrá a toda costa. Si no es posible, la característica, mejora o corrección de errores -se programará para la siguiente versión principal: *Symfony 3.0*. - -.. note:: - - El trabajo sobre *Symfony 3.0* se iniciará cuando suficientes características principales de compatibilidad con versiones anteriores estén esperando en la lista de pendientes. - -Depreciaciones --------------- - -Cuando la implementación de una característica no se pueda reemplazar con otra mejor sin romper la compatibilidad hacia atrás, todavía existe la posibilidad de depreciar la vieja implementación y añadir una nueva preferida al lado de la otra. Lee el documento con las :ref:`convenciones ` para conocer más sobre el manejo de la depreciación en *Symfony*. - -Justificación -------------- - -Este proceso de liberación se adoptó para dar mayor *predecibilidad* y *transparencia*. Se discutió basándose en los siguientes objetivos: - -* Acortar el ciclo de liberación (permitiendo que los desarrolladores se puedan beneficiar más rápido de las nuevas características); -* Darle más visibilidad a los desarrolladores que están usando la plataforma y a los proyectos de código abierto que utilizan *Symfony*; -* Mejorar la experiencia de los colaboradores del núcleo de *Symfony*: que todo mundo sepa cuando una característica esté disponible en *Symfony*; -* Coordinar el calendario de *Symfony* con proyectos *PHP* populares que funcionan bien con *Symfony* y con proyectos que utilizan *Symfony*; -* Darle tiempo al ecosistema de *Symfony* para ponerse al día con las nuevas versiones (autores de paquete, escritores de documentación, traductores, ...). - -El periodo de seis meses fue elegido para ajustarse a dos lanzamientos en un año. Este también permite un montón de tiempo para trabajar en las nuevas características y permite que las características que no están listas se pospongan para la próxima versión sin tener que esperar demasiado tiempo para el siguiente ciclo. - -El modo de mantenimiento dual se adoptó para hacer feliz a cada usuario de *Symfony*. Moviéndose rápido, a quién quiera trabajar con la última y más reciente, utilizando las versiones estándar: una nueva versión será publicada cada seis meses, y esta cuenta con un periodo de dos meses para actualizarse. Las empresas que deseen una mayor estabilidad pueden utilizar las versiones *LTS*: una nueva versión será publicada cada dos años y cuenta con un año para actualizarse. - -.. _`repositorio Git`: https://github.com/symfony/symfony -.. _SensioLabs: http://sensiolabs.com/ diff --git a/_sources/contributing/documentation/format.txt b/_sources/contributing/documentation/format.txt deleted file mode 100644 index 9b1569c..0000000 --- a/_sources/contributing/documentation/format.txt +++ /dev/null @@ -1,208 +0,0 @@ -Formato de documentación -======================== - -La documentación de *Symfony2* utiliza `reStructuredText`_ como lenguaje de marcado y `Sphinx`_ para generarla (en *HTML*, *PDF*, ...). - -*reStructuredText* ------------------- - -*reStructuredText* «es un sistema analizador y sintaxis de marcado de texto, fácil de leer, lo que ves es lo que obtienes». - -Puedes aprender más acerca de su sintaxis leyendo los `documentos`_ existentes de *Symfony2* o leyendo el `Primer reStructuredText`_ en el sitio web de Sphinx. - -Si estás familiarizado con *Markdown*, ten cuidado que las cosas a veces se ven muy similares, pero son diferentes: - -* Las listas se inician al comienzo de una línea (no se permite sangría); - -* Los bloques de código en línea utilizan comillas dobles (````como estas````). - -Sphinx ------- - -*Sphinx* es un sistema generador que añade algunas herramientas agradables para crear la documentación a partir de documentos *reStructuredText*. Como tal, agrega nuevas directivas e interpreta texto en distintos roles al `marcado`_ *reST* estándar. - -Resaltado de sintaxis -~~~~~~~~~~~~~~~~~~~~~ - -Todo el código de los ejemplos de manera predeterminada utiliza *PHP* como lenguaje a resaltar. Puedes cambiarlo con la directiva ``code-block``: - -.. code-block:: rst - - .. code-block:: yaml - - { foo: bar, bar: { foo: bar, bar: baz } } - -Si el código *PHP* comienza con ``foobar(); ?> - -.. note:: - - Una lista de lenguajes apoyados está disponible en el sitio web de `Pygments`_. - -Bloques de configuración -~~~~~~~~~~~~~~~~~~~~~~~~ - -Cada vez que muestres una configuración, debes utilizar la directiva ``configuration-block`` para mostrar la configuración en todos los formatos de configuración compatibles (*YAML*, *XML* y *PHP*) - -.. code-block:: rst - - .. configuration-block:: - - .. code-block:: yaml - - # Configuración en YAML - - .. code-block:: xml - - - - .. code-block:: php - - // Configuración en PHP - -El fragmento *reST* anterior se dibuja de la siguiente manera: - -.. configuration-block:: - - .. code-block:: yaml - - # Configuración en YAML - - .. code-block:: xml - - - - .. code-block:: php - - // Configuración en PHP - -La lista de formatos apoyados actualmente es la siguiente: - -+----------------------+-------------+ -| Formato de marcado | Muestra | -+======================+=============+ -| html | *HTML* | -+----------------------+-------------+ -| xml | *XML* | -+----------------------+-------------+ -| php | *PHP* | -+----------------------+-------------+ -| yaml | *YAML* | -+----------------------+-------------+ -| jinja | *Twig* | -+----------------------+-------------+ -| html+jinja | *Twig* | -+----------------------+-------------+ -| html+php | *PHP* | -+----------------------+-------------+ -| ini | *INI* | -+----------------------+-------------+ -| php-annotations | Anotaciones | -+----------------------+-------------+ - -Añadiendo enlaces -~~~~~~~~~~~~~~~~~ - -Para añadir enlaces a otras páginas en los documentos utiliza la siguiente sintaxis: - -.. code-block:: rst - - :doc:`/ruta/a/pagina` - -Usando la ruta y nombrearchivo de la página sin extensión, por ejemplo: - -.. code-block:: rst - - :doc:`/book/controller` - - :doc:`/components/event_dispatcher/introduction` - - :doc:`/cookbook/configuration/environments` - -El texto del enlace será el encabezado principal del documento enlazado. También puedes especificar texto alternativo para el enlace: - -.. code-block:: rst - - :doc:`Cola de impresión de correo electrónico     ` - -También puedes añadir enlaces a la documentación de la *API*: - -.. code-block:: rst - - :namespace:`Symfony\\Component\\BrowserKit` - - :class:`Symfony\\Component\\Routing\\Matcher\\ApacheUrlMatcher` - - :method:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle::build` - -y a la documentación de *PHP*: - -.. code-block:: rst - - :phpclass:`SimpleXMLElement` - - :phpmethod:`DateTime::createFromFormat` - - :phpfunction:`iterator_to_array` - -Probando la documentación -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Para probar la documentación antes de enviarla: - -* Instala `Sphinx`_; - -* Ejecuta el programa de `instalación rápida de Sphinx`_; - -* Instala las extensiones de ``Sphinx`` (ve más adelante); - -* Ejecuta ``make html`` y revisa el código *HTML* generado en el directorio ``_build``. - -Instalando las extensiones de ``Sphinx`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -* Descarga las extensiones desde el repositorio `source`_ - -* Copia el directorio ``sensio`` al directorio ``_exts`` bajo tu directorio fuente (donde está ``conf.py``) - -* Agrega lo siguiente al archivo ``conf.py``: - -.. code-block:: py - - # ... - sys.path.append(os.path.abspath('_exts')) - - # añadiendo PhpLexer - from sphinx.highlighting import lexers - from pygments.lexers.web import PhpLexer - - # ... - # añade la extensión a la lista de extensiones - extensions = [..., 'sensio.sphinx.refinclude', - 'sensio.sphinx.configurationblock', - 'sensio.sphinx.phpcode'] - - # habilita el resaltado para el código PHP que no esté - # entre ```` por omisión - lexers['php'] = PhpLexer(startinline=True) - lexers['php-annotations'] = PhpLexer(startinline=True) - - # usa PHP como el dominio primario - primary_domain = 'php' - - # fija la url para los enlaces de la API - api_url = 'http://api.symfony.com/master/%s' - -.. _`reStructuredText`: http://docutils.sourceforge.net/rst.html -.. _`Sphinx`: http://sphinx-doc.org/ -.. _`documentos`: https://github.com/symfony/symfony-docs -.. _`Primer reStructuredText`: http://sphinx-doc.org/rest.html -.. _`marcado`: http://sphinx-doc.org/markup/ -.. _`Pygments`: http://pygments.org/languages/ -.. _source: https://github.com/fabpot/sphinx-php -.. _`instalación rápida de Sphinx`: http://sphinx-doc.org/tutorial.html#setting-up-the-documentation-sources diff --git a/_sources/contributing/documentation/index.txt b/_sources/contributing/documentation/index.txt deleted file mode 100644 index 1774b7f..0000000 --- a/_sources/contributing/documentation/index.txt +++ /dev/null @@ -1,10 +0,0 @@ -Aportando documentación -======================= - -.. toctree:: - :maxdepth: 2 - - overview - format - translations - license diff --git a/_sources/contributing/documentation/license.txt b/_sources/contributing/documentation/license.txt deleted file mode 100644 index 4b5e6a0..0000000 --- a/_sources/contributing/documentation/license.txt +++ /dev/null @@ -1,46 +0,0 @@ -Licencia de la documentación de *Symfony2* -========================================== - -La documentación de *Symfony2* está bajo una licencia Creative Commons Attribution-Share Alike 3.0 Unported `Licencia`_. - -**Estás en libertad:** - -* para *Compartir* — copiar, distribuir y trasmitir públicamente la obra; - -* para *Derivar* — adaptando la obra. - -**Bajo las siguientes condiciones:** - -* *Atribución* — Debes atribuir el trabajo de la manera especificada por - el autor o licenciador (pero de ninguna manera que sugiera que apoya tu - uso de la obra). - -* *Compartir bajo la misma licencia* — Si alteras, transformas, o creas - sobre esta obra, sólo podrás distribuir la obra resultante bajo una - licencia idéntica o similar a esta. - -**En el entendido de:** - -* *Renuncia* — Cualquiera de estas condiciones puede no aplicarse si - obtienes el permiso del titular de los derechos de autor; - -* *Dominio Público* — Cuando la obra o cualquiera de sus elementos es del - dominio público bajo la legislación aplicable, este estatus de ninguna - manera es afectado por la licencia; - -* *Otros Derechos* — De ninguna manera cualquiera de los siguientes derechos - se ve afectado por la licencia: - - * Tu derecho leal o uso justo, u otros derechos de autor excepciones y limitaciones aplicables; - - * Los derechos morales del autor; - - * Otras personas pueden tener derechos ya sea en la propia obra o en la forma en que se utiliza la obra, como los derechos de publicidad o privacidad. - -* *Atención* — Para cualquier reutilización o distribución, debes dejar - claros los términos de la licencia de esta obra. La mejor manera de hacerlo es con un enlace a esta página web. - -Este es un resumen humanamente legible del `Texto legal (Licencia completa)`_. - -.. _`Licencia`: http://creativecommons.org/licenses/by-sa/3.0/ -.. _`Texto legal (Licencia completa)`: http://creativecommons.org/licenses/by-sa/3.0/legalcode diff --git a/_sources/contributing/documentation/overview.txt b/_sources/contributing/documentation/overview.txt deleted file mode 100644 index 9000209..0000000 --- a/_sources/contributing/documentation/overview.txt +++ /dev/null @@ -1,205 +0,0 @@ -Colaborando en la documentación -=============================== - -La documentación es tan importante como el código. Esta sigue exactamente los mismos principios: -una vez y sólo una, pruebas, facilidad de mantenimiento, -extensibilidad, optimización y reconstrucción sólo por nombrar algunos. Y, por supuesto, la documentación tiene errores, errores tipográficos, guías difíciles de leer y mucho más. - -Colaborando ------------ - -Antes de colaborar, necesitas familiarizarte con el :doc:`lenguaje de marcado ` empleado en la documentación. - -La documentación de *Symfony2* se encuentra alojada en *GitHub*: - -.. code-block:: text - - https://github.com/symfony/symfony-docs - -Si deseas enviar un parche `bifurca`_ el repositorio oficial en *GitHub* y luego clona tu bifurcación: - -.. code-block:: bash - - $ git clone git://github.com/TUNOMBRE/symfony-docs.git - -Consistent with Symfony's source code, the documentation repository is split into -multiple branches: ``2.0``, ``2.1``, ``2.2`` corresponding to the different -versions of Symfony itself. The ``master`` branch holds the documentation -for the development branch of the code. - -Unless you're documenting a feature that was introduced *after* Symfony 2.0 -(e.g. in Symfony 2.1), your changes should always be based on the 2.0 branch. -To do this checkout the 2.0 branch before the next step: - -.. code-block:: bash - - $ git checkout 2.0 - -.. tip:: - - Your base branch (e.g. 2.0) will become the "Applies to" in the :ref:`doc-contributing-pr-format` - that you'll use later. - -A continuación, crea una rama dedicada a tus cambios (para mantenerla organizada): - -.. code-block:: bash - - $ git checkout -b improving_foo_and_bar - -Ahora puedes hacer los cambios directamente en esta rama y confirmarlos ahí. Cuando hayas terminado, impulsa esta rama a *tu* *GitHub* e inicia una solicitud de atracción. - -Creando una solicitud de atracción -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Siguiendo el ejemplo, la solicitud de atracción de manera predeterminada debe ser entre tu rama ``improving_foo_and_bar`` y la rama ``master`` de ``symfony-docs``. - -.. image:: /images/docs-pull-request.png - :align: center - -Si has hecho tus cambios basándote en la rama 2.0, entonces necesitas cambiar la rama base para que sea *2.0* en la página anterior: - -.. image:: /images/docs-pull-request-change-base.png - :align: center - -.. note:: - - Todos los cambios hechos a una rama (p. ej. 2.0) serán fusionados en cada «nueva» rama (p. ej. 2.1, maestra, etc.) para la siguiente liberación en una base semanal. - -*GitHub* aborda en detalle el tema de las `solicitudes de atracción`_. - -.. note:: - - La documentación de *Symfony2* está bajo una licencia Creative Commons Attribution-Share Alike 3.0 Unported :doc:`Licencia `. - -You can also prefix the title of your pull request in a few cases: - -* ``[WIP]`` (Work in Progress) is used when you are not yet finished with your - pull request, but you would like it to be reviewed. The pull request won't - be merged until you say it is ready. - -* ``[WCM]`` (Waiting Code Merge) is used when you're documenting a new feature - or change that hasn't been accepted yet into the core code. The pull request - will not be merged until it is merged in the core code (or closed if the - change is rejected). - -.. _doc-contributing-pr-format: - -Formato de la solicitud de atracción -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Unless you're fixing some minor typos, the pull request description **must** -include the following checklist to ensure that contributions may be reviewed -without needless feedback loops and that your contributions can be included -into the documentation as quickly as possible: - -.. code-block:: text - - | Q | A - | ------------- | --- - | Doc fix? | [yes|no] - | New docs? | [yes|no] (PR # si es aplicable en symfony/symfony) - | Applies to | [numero de versiones Symfony a las que es aplicable] - | Fixed tickets | [lista separada por comas de los boletos corregidos por PR] - -Un envío de ejemplo ahora se ve de la siguiente manera: - -.. code-block:: text - - | Q | A - | ------------- | --- - | Doc fix? | yes - | New docs? | yes (symfony/symfony#2500) - | Applies to | all (or 2.1+) - | Fixed tickets | #1075 - -.. tip:: - - Por favor, ten paciencia. Puede tomar desde 15 minutos hasta varios días para que tus cambios aparezcan en el sitio *web* ``symfony.com`` después de que el equipo de documentación fusione tu solicitud de atracción. Puedes comprobar si tus cambios introducen algunas cuestiones sobre el marcado yendo a la página de `Errores en la generación de documentación`_ (esta se actualiza en Francia cada noche a las 3 a.m. cuando el servidor vuelve a generar la documentación). - -Documentando nuevas características o cambios de comportamiento ---------------------------------------------------------------- - -Si estás documentando un nuevo tipo de característica o un cambio que se esté haciendo en *Symfony2*, deberías preceder tu descripción del cambio con una etiqueta ``.. versionadded:: 2.X`` -y una breve descripción: - -.. code-block:: text - - .. versionadded:: 2.2 - El método ``askHiddenResponse`` se añadió en *Symfony 2.2*. - - Además, puedes hacer una pregunta y ocultar la respuesta. Esto particularmente es... - -Si estás documentando un cambio de comportamiento, puedría ser útil describir *brevemente* cómo ha cambiado tal comportamiento. - -.. code-block:: text - - .. versionadded:: 2.2 - La función ``include()`` es una nueva característica de *Twig* que está disponible en *Symfony 2.2*. Anteriormente se utilizaba la etiqueta ``{% include %}``. - -Siempre que se libere una nueva versión menor de *Symfony2* (p. ej. 2.3, 2.4, etc.), se crea una nueva rama de la documentación desde la rama ``maestra``. -En este punto, todas las etiquetas ``versionadded`` para las versiones de *Symfony2* que han alcanzado su fin-de-vida serán eliminadas. Por ejemplo, si *Symfony 2.5* fuera liberado hoy, y *2.2* recientemente alcanzó su fin-de-vida, la etiqueta ``versionadded`` 2.2 sería eliminada de la nueva rama *2.5*. - -Estándares ----------- - -Con el fin de ayudar lo más posible al lector y crear código de ejemplo que se vea y sienta familiar, debes seguir estas reglas: - -* El código sigue los :doc:`Estándares de codificación de Symfony ` así como los `Estándares de codificación de Twig`_; -* Each line should break approximately after the first word that crosses the - 72nd character (so most lines end up being 72-78 characters); -* Para evitar desplazamiento horizontal en bloques de código, preferimos romper una línea correctamente si rebasa el 85º carácter; -* Cuándo pliegues una o más líneas de código, coloca ``...`` en un comentario en el punto del pliegue. Estos comentarios son: ``// ...`` (php), ``# ...`` (yaml/bash), ``{# ... #}`` - (twig), ```` (xml/html), ``; ...`` (ini), ``...`` (texto); -* Cuándo pliegues una parte de una línea, p. ej. un valor variable, coloca ``...`` (sin comentario) en el sitio del pliegue; -* Descripción del código plegado: (opcional) si pliegas varias líneas: la descripción del pliegue se puede colocar después de los ``...``; si sólo pliegas una parte de una línea: la descripción se puede colocar antes de la línea; -* Si se considera útil, un bloque de código ``codeblock`` debe comenzar con un comentario que contenga el nombre del archivo en el bloque de código. No coloques una línea de espacio en blanco después de este comentario, a no ser que la próxima línea también sea un comentario; -* Debes poner un ``$`` delante de cada línea del intérprete; -* El atajo ``::`` es preferible sobre ``.. code-block:: php`` para comenzar un bloque de código *PHP*. -* Deberías utilizar la forma *tú* en vez de *nosotros*. - -Un ejemplo:: - - // src/Foo/Bar.php - - // ... - class Bar - { - // ... - - public function foo($bar) - { - // ajusta foo al valor de bar - $foo = ...; - - // ... comprueba si $bar tiene el valor correcto - - return $foo->baz($bar, ...); - } - } - -.. caution:: - - en *Yaml* debes dejar un espacio después de ``{`` y antes de ``}`` (p. ej. ``{ _controlador: ... }``), - pero esto no lo debes hacer en Twig (p. ej. ``{'hola' : 'valor'}``). - -Informando un problema ----------------------- - -La contribución más sencilla que puedes hacer es reportar algún problema: a typo, a grammar -mistake, a bug in a code example, a missing explanation, and so on. - -Pasos a seguir: - -* Reporta un error en el rastreador de fallos; - -* *(Opcional)* Envía un parche. - -Traduciendo ------------ - -Lee el :doc:`documento dedicado `. - -.. _`bifurca`: https://help.github.com/articles/fork-a-repo -.. _`solicitudes de atracción`: https://help.github.com/articles/using-pull-requests -.. _`Errores en la generación de documentación`: http://symfony.com/doc/build_errors -.. _`Estándares de codificación de Twig`: http://gitnacho.github.com/Twig/coding_standards.html diff --git a/_sources/contributing/documentation/translations.txt b/_sources/contributing/documentation/translations.txt deleted file mode 100644 index c827140..0000000 --- a/_sources/contributing/documentation/translations.txt +++ /dev/null @@ -1,69 +0,0 @@ -Traduciendo -=========== - -La documentación de *Symfony2* está escrita en inglés y hay muchas personas involucradas en el proceso de traducción. - -Colaborando ------------ - -En primer lugar, familiarízate con el :doc:`lenguaje de marcado ` empleado en la documentación. - -A continuación, suscríbete a la `lista de correo de la documentación de Symfony`_, debido a que la colaboración sucede allí. - -Por último, busca el repositorio *maestro* del idioma con el que deseas contribuir. Esta es la lista oficial de los repositorios *maestros*: - -* *Inglés*: https://github.com/symfony/symfony-docs -* *Francés*: https://github.com/symfony-fr/symfony-docs-fr -* *Italiano*: https://github.com/garak/symfony-docs-it -* *Japonés*: https://github.com/symfony-japan/symfony-docs-ja -* *Polaco*: https://github.com/ampluso/symfony-docs-pl -* *Portugués (Brasil)*: https://github.com/andreia/symfony-docs-pt-BR -* *Rumano*: https://github.com/sebio/symfony-docs-ro -* *Ruso*: https://github.com/avalanche123/symfony-docs-ru -* *Español*: https://github.com/gitnacho/symfony-docs-es -* *Turco*: https://github.com/symfony-tr/symfony-docs-tr - -.. note:: - - Si quieres contribuir traducciones para un nuevo idioma, lee la :ref:`sección dedicada `. - -Uniéndote al equipo de traducción ---------------------------------- - -Si quieres ayudar a traducir algunos documentos a tu idioma o corregir algunos errores, considera unirte; es un proceso muy sencillo: - -* Preséntese en la `lista de correo de la documentación de Symfony`_; -* *(Opcional)* Pregunta en cuales documentos puedes trabajar; -* Bifurca el repositorio *master* de tu idioma (haciendo clic en el botón “Fork” en la página de *GitHub*); -* Traduce algún documento; -* Haz una solicitud de atracción (haciendo clic en ``Pull Request`` de tu página en *GitHub*); -* El administrador del equipo acepta tus modificaciones y las combina en el repositorio maestro; -* El sitio web de documentación se actualiza todas las noches desde el repositorio maestro. - -.. _translations-adding-a-new-language: - -Añadiendo un nuevo idioma -------------------------- - -Esta sección ofrece algunas pautas para comenzar la traducción de la documentación de *Symfony2* para un nuevo idioma. - -Debido a que iniciar una traducción conlleva mucho trabajo, habla acerca de tu plan en la `lista de correo de la documentación de Symfony`_ y trata de encontrar personas motivadas dispuestas a ayudar. - -Cuando el grupo esté listo, nomina un administrador del equipo; quién será el responsable del repositorio *maestro*. - -Crea el repositorio y copia los documentos en *Inglés*. - -El equipo ahora puede iniciar el proceso de traducción. - -Cuando el equipo confíe en que el repositorio está en un estado coherente y estable (se ha traducido todo, o los documentos sin traducir se han retirado de los árboles de tablas de contenido ---archivos con el nombre ``index.rst`` y ``map.rst.inc``---), el administrador del equipo puede pedir que el repositorio se añada a la lista *maestra* de repositorios oficiales enviando un correo electrónico a Fabien (fabien arroba symfony.com). - -Manteniendo ------------ - -La traducción no termina cuando se ha traducido todo. La documentación es un ente en continuo movimiento (se agregan nuevos documentos, se corrigen errores, se reorganizan párrafos, ...). El equipo de traducción tiene que seguir de cerca los cambios del repositorio en Inglés y aplicarlos a los documentos traducidos tan pronto como sea posible. - -.. caution:: - - Los idiomas sin mantenimiento se quitan de la lista oficial de repositorios de documentación puesto que la obsolescencia es peligrosa. - -.. _`lista de correo de la documentación de Symfony`: http://groups.google.com/group/symfony-docs diff --git a/_sources/contributing/index.txt b/_sources/contributing/index.txt deleted file mode 100644 index 2e67888..0000000 --- a/_sources/contributing/index.txt +++ /dev/null @@ -1,11 +0,0 @@ -Colaborando -=========== - -.. toctree:: - :hidden: - - code/index - documentation/index - community/index - -.. include:: /contributing/map.rst.inc diff --git a/_sources/cookbook/assetic/apply_to_option.txt b/_sources/cookbook/assetic/apply_to_option.txt deleted file mode 100644 index 590144e..0000000 --- a/_sources/cookbook/assetic/apply_to_option.txt +++ /dev/null @@ -1,165 +0,0 @@ -.. index:: - single: Assetic; Aplicando filtros - -Cómo aplicar un *filtro* ``Assetic`` a una extensión de archivo especifica -========================================================================== - -Los *filtros* ``Assetic`` se pueden aplicar a archivos individuales, grupos de archivos o incluso, como veremos aquí, a archivos que tengan una determinada extensión. Para mostrarte cómo manejar cada opción, vamos a suponer que quieres usar el filtro ``CoffeeScript`` de ``Assetic``, el cual compila archivos de ``CoffeeScript`` en *Javascript*. - -La configuración principal sólo son las rutas a ``coffee`` y ``node``. Estas por omisión son ``/usr/bin/coffee`` y ``/usr/bin/node`` respectivamente: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - coffee: - bin: /usr/bin/coffee - node: /usr/bin/node - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'coffee' => array( - 'bin' => '/usr/bin/coffee', - 'node' => '/usr/bin/node', - ), - ), - )); - -Filtrando un solo archivo -------------------------- - -Ahora puedes servir un solo archivo ``CoffeeScript`` como *JavaScript* dentro de tus plantillas: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/example.coffee' filter='coffee' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array('@AcmeFooBundle/Resources/public/js/example.coffee'), - array('coffee') - ) as $url): ?> - - - -Esto es todo lo que se necesita para compilar este archivo ``CoffeeScript`` y servirlo como *JavaScript* compilado. - -Filtrando múltiples archivos ----------------------------- - -También puedes combinar varios archivos ``CoffeeScript`` y producir un único archivo: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/example.coffee' - '@AcmeFooBundle/Resources/public/js/another.coffee' - filter='coffee' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array( - '@AcmeFooBundle/Resources/public/js/example.coffee', - '@AcmeFooBundle/Resources/public/js/another.coffee', - ), - array('coffee') - ) as $url): ?> - - - -Ahora, ambos archivos se sirven como un solo archivo compilado en *JavaScript* regular. - -.. _cookbook-assetic-apply-to: - -Filtrando en base a la extensión de archivo -------------------------------------------- - -Una de las grandes ventajas de usar ``Assetic`` es minimizar el número de archivos de activos para reducir las peticiones ``HTTP``. Con el fin de usar esto completamente, sería bueno combinar *todos* los archivos *JavaScript* y ``CoffeeScript`` juntos puesto que en última instancia, todo se debe servir como *JavaScript*. Desafortunadamente sólo añadir los archivos *JavaScript* a los archivos combinados como el anterior no funciona puesto que los archivos *JavaScript* regulares no sobrevivirán a la compilación de ``CoffeeScript``. - -Este problema se puede evitar usando la opción ``apply_to`` en la configuración, lo cual te permite especificar que siempre se aplique un *filtro* a las extensiones de archivo en particular. En este caso puedes especificar que el *filtro* ``Coffee`` se aplique a todos los archivos ``.coffee``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - coffee: - bin: /usr/bin/coffee - node: /usr/bin/node - apply_to: "\.coffee$" - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'coffee' => array( - 'bin' => '/usr/bin/coffee', - 'node' => '/usr/bin/node', - 'apply_to' => '\.coffee$', - ), - ), - )); - -Con esto, ya no tendrás que especificar el *filtro* ``coffee`` en la plantilla. -También puedes listar archivos *JavaScript* regulares, los cuales serán combinados y reproducidos como un único archivo *JavaScript* (con sólo ejecutar los archivos ``.coffee`` a través del *filtro* ``CoffeeScript``.) - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/example.coffee' - '@AcmeFooBundle/Resources/public/js/another.coffee' - '@AcmeFooBundle/Resources/public/js/regular.js' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array( - '@AcmeFooBundle/Resources/public/js/example.coffee', - '@AcmeFooBundle/Resources/public/js/another.coffee', - '@AcmeFooBundle/Resources/public/js/regular.js', - ) - ) as $url): ?> - - diff --git a/_sources/cookbook/assetic/asset_management.txt b/_sources/cookbook/assetic/asset_management.txt deleted file mode 100644 index 0716727..0000000 --- a/_sources/cookbook/assetic/asset_management.txt +++ /dev/null @@ -1,385 +0,0 @@ -.. index:: - single: Assetic; Introducción - -Cómo utilizar ``Assetic`` para gestionar activos -================================================ - -``Assetic`` combina dos ideas principales: :ref:`assets` y :ref:`filters`. Los activos son archivos tales como *CSS*, *JavaScript* y archivos de imagen. Los *filtros* son cosas que se pueden aplicar a estos archivos antes de servirlos al navegador. Esto te permite una separación entre los archivos de activos almacenados en tu aplicación y los archivos realmente presentados al usuario. - -Sin ``Assetic``, sólo sirves los archivos que están almacenados directamente en la aplicación: - -.. configuration-block:: - - .. code-block:: html+jinja - - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array('@AcmeFooBundle/Resources/public/js/*') - ) as $url): ?> - - - -.. tip:: - - También puedes incluir hojas de estilo *CSS*: consulta :ref:`cookbook-assetic-including-css`. - -En este ejemplo, se cargan todos los archivos en el directorio ``Resources/public/js/`` del ``AcmeFooBundle`` y se sirven desde un lugar diferente. -En realidad la etiqueta reproducida simplemente podría ser: - -.. code-block:: html - - - -Este es un punto clave: once you let Assetic handle your assets, the files are -served from a different location. This *will* cause problems with CSS files -that reference images by their relative path. See :ref:`cookbook-assetic-cssrewrite`. - -.. _cookbook-assetic-including-css: - -Including CSS Stylesheets -~~~~~~~~~~~~~~~~~~~~~~~~~ - -To bring in CSS stylesheets, you can use the same methodologies seen -above, except with the ``stylesheets`` tag. If you're using the default -block names from the Symfony Standard Distribution, this will usually live -inside a ``stylesheets`` block: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% stylesheets 'bundles/acme_foo/css/*' filter='cssrewrite' %} - - {% endstylesheets %} - - .. code-block:: html+php - - stylesheets( - array('bundles/acme_foo/css/*'), - array('cssrewrite') - ) as $url): ?> - - - -But because Assetic changes the paths to your assets, this *will* break any -background images (or other paths) that uses relative paths, unless you use -the :ref:`cssrewrite` filter. - -.. note:: - - Notice that in the original example that included JavaScript files, you - referred to the files using a path like ``@AcmeFooBundle/Resources/public/file.js``, - but that in this example, you referred to the CSS files using their actual, - publicly-accessible path: ``bundles/acme_foo/css``. You can use either, except - that there is a known issue that causes the ``cssrewrite`` filter to fail - when using the ``@AcmeFooBundle`` syntax for CSS Stylesheets. - -.. _cookbook-assetic-cssrewrite: - -Fixing CSS Paths with the ``cssrewrite`` Filter -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Since Assetic generates new URLs for your assets, any relative paths inside -your CSS files will break. To fix this, make sure to use the ``cssrewrite`` -filter with your ``stylesheets`` tag. This parses your CSS files and corrects -the paths internally to reflect the new location. - -You can see an example in the previous section. - -.. caution:: - - When using the ``cssrewrite`` filter, don't refer to your CSS files using - the ``@AcmeFooBundle``. See the note in the above section for details. - -Combinando activos -~~~~~~~~~~~~~~~~~~ - -One feature of Assetic is that it will combine many files into one. This helps -to reduce the number of HTTP requests, which is great for front end performance. -It also allows you to maintain the files more easily by splitting them into -manageable parts. This can help with re-usability as you can easily split -project-specific files from those which can be used in other applications, -but still serve them as a single file: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts - '@AcmeFooBundle/Resources/public/js/*' - '@AcmeBarBundle/Resources/public/js/form.js' - '@AcmeBarBundle/Resources/public/js/calendar.js' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array( - '@AcmeFooBundle/Resources/public/js/*', - '@AcmeBarBundle/Resources/public/js/form.js', - '@AcmeBarBundle/Resources/public/js/calendar.js', - ) - ) as $url): ?> - - - -In the ``dev`` environment, each file is still served individually, so that -you can debug problems more easily. However, in the ``prod`` environment -(or more specifically, when the ``debug`` flag is ``false``), this will be -rendered as a single ``script`` tag, which contains the contents of all of -the JavaScript files. - -.. tip:: - - Si eres nuevo en ``Assetic`` y tratas de usar la aplicación en el entorno ``prod`` (usando el controlador :file:`app.php`), lo más probable es que se rompan todos tus *CSS* y *JS*. ¡No te preocupes! Esto es a propósito. - For details on using Assetic in the ``prod`` environment, see :ref:`cookbook-assetic-dumping`. - -Y la combinación de archivos no sólo se aplica a *tus* archivos. También puedes usar ``Assetic`` para combinar activos de terceros, como *jQuery*, con tu propio *JavaScript* en un solo archivo: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts - '@AcmeFooBundle/Resources/public/js/thirdparty/jquery.js' - '@AcmeFooBundle/Resources/public/js/*' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array( - '@AcmeFooBundle/Resources/public/js/thirdparty/jquery.js', - '@AcmeFooBundle/Resources/public/js/*', - ) - ) as $url): ?> - - - -.. _cookbook-assetic-filters: - -Filtros -------- - -Una vez que son gestionados por ``Assetic``, puedes aplicar filtros a tus activos antes de servirlos. Esto incluye filtros que comprimen la salida de tus activos a un archivo más pequeño (y mejor optimización en la interfaz de usuario). Otros filtros incluyen la compilación de archivos *JavaScript* desde archivos *CoffeeScript* y *SASS* a *CSS*. -De hecho, ``Assetic`` tiene una larga lista de filtros disponibles. - -Muchos de los filtros no hacen el trabajo directamente, sino que utilizan otras bibliotecas para hacerlo, a menudo, esta es la razón por la que tienes que instalar esos programas también. Esto significa que a menudo tendrás que instalar una biblioteca de terceros para usar un filtro. La gran ventaja de utilizar ``Assetic`` para invocar estas bibliotecas (en lugar de utilizarlas directamente) es que en lugar de tener que ejecutarlo manualmente cuando has trabajado en los archivos, ``Assetic`` se hará cargo de esto por ti y elimina por completo este paso de tu proceso de desarrollo y despliegue. - -Para usar un filtro debes especificarlo en la configuración de ``Assetic``. -Añadir un filtro aquí no quiere decir que se esté utilizando ---sólo significa que está disponible para usarlo (vamos a utilizar el filtro en seguida). - -Por ejemplo, para utilizar el *JavaScript YUI Compressor* debes añadir la siguiente configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - yui_js: - jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar" - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'yui_js' => array( - 'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar', - ), - ), - )); - -Ahora, para realmente *usar* el filtro en un grupo de archivos *JavaScript*, añade esto a tu plantilla: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='yui_js' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array('@AcmeFooBundle/Resources/public/js/*'), - array('yui_js') - ) as $url): ?> - - - -Puedes encontrar una guía más detallada sobre la configuración y uso de filtros ``Assetic`` así como detalles del modo de depuración ``Assetic`` en :doc:`/cookbook/assetic/yuicompressor`. - -Controlando la *URL* utilizada ------------------------------- - -Si quieres, puedes controlar las *URL* que produce *Assetic*. Esto se hace desde la plantilla y es relativo a la raíz del documento público: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/*' output='js/compiled/main.js' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array('@AcmeFooBundle/Resources/public/js/*'), - array(), - array('output' => 'js/compiled/main.js') - ) as $url): ?> - - - -.. note:: - - *Symfony* también contiene un método para caché *rota*, donde la *URL* final generada por ``Assetic`` en el entorno ``prod`` contiene un parámetro de consulta que puedes incrementar por medio de configuración en cada despliegue. Para más información, consulta la opción de configuración :ref:`ref-framework-assets-version`. - -.. _cookbook-assetic-dumping: - -Volcando archivos de activos ----------------------------- - -En el entorno ``dev``, ``Assetic`` genera rutas para los archivos *CSS* y *JavaScript* que no existen físicamente en el ordenador. Pero, sin embargo, los reproduce porque un controlador interno de *Symfony* abre y sirve los archivos volcando el contenido (después de ejecutar todos los filtros). - -Este tipo de servicio dinámico de procesar los activos es muy bueno porque significa que puedes ver inmediatamente el nuevo estado de los archivos de activos que cambies. -Por otro lado es malo, porque puede ser bastante lento. Si estás utilizando una gran cantidad de filtros, puede ser realmente frustrante. - -Afortunadamente, ``Assetic`` proporciona una manera de volcar tus activos a los archivos reales, en lugar de generarlos dinámicamente. - -Volcando archivos de activos en el entorno ``prod`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -En entorno ``prod``, cada uno de tus archivos *JS* y *CSS* está representado por una sola etiqueta. En otras palabras, en lugar de incluir cada archivo *JavaScript* en tu código fuente, probablemente acabes viendo algo como esto: - -.. code-block:: html - - - -Por otra parte, ese archivo **no** existe en realidad, ni es reproducido dinámicamente por *Symfony* (debido a que los archivos de activos se encuentran en el entorno ``dev``). Esto es a propósito ---permitir que *Symfony* genere estos archivos de forma dinámica en un entorno de producción es demasiado lento. - -En cambio, cada vez que utilices tu aplicación en el entorno ``prod`` (y por lo tanto, cada vez que la despliegues), debes ejecutar la siguiente tarea: - -.. code-block:: bash - - $ php app/console assetic:dump --env=prod --no-debug - -Esto va a generar y escribir físicamente todos los archivos que necesitas (por ejemplo ``/js/abcd123.js``). -Si actualizas cualquiera de tus activos, tendrás que ejecutarlo de nuevo para generar el archivo. - -Volcando archivos de activos en el entorno ``dev`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Por omisión, *Symfony* procesa dinámicamente cada ruta de activo generada en el entorno ``dev``. Esto no tiene ninguna desventaja (puedes ver tus cambios inmediatamente), salvo que los activos se pueden cargar notablemente lento. Si sientes que tus activos se cargan demasiado lento, sigue esta guía. - -En primer lugar, dile a *Symfony* que deje de intentar procesar estos archivos de forma dinámica. Haz el siguiente cambio en tu archivo :file:`config_dev.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_dev.yml - assetic: - use_controller: false - - .. code-block:: xml - - - - - .. code-block:: php - - // app/config/config_dev.php - $container->loadFromExtension('assetic', array( - 'use_controller' => false, - )); - -A continuación, debido a que *Symfony* ya no genera estos activos para ti, tendrás que deshacerte de ellos manualmente. Para ello, ejecuta lo siguiente: - -.. code-block:: bash - - $ php app/console assetic:dump - -Esto escribe físicamente todos los archivos de activos que necesita tu entorno ``dev``. La gran desventaja es que necesitas hacerlo manualmente cada vez que actualizas tus activos. Afortunadamente, pasando la opción ``--watch``, la orden regenerará automáticamente tus *activos a medida que cambien*: - -.. code-block:: bash - - $ php app/console assetic:dump --watch - -Debido a que ejecutas esta orden en el entorno ``dev`` puede generar un montón de archivos, por lo general es una buena idea apuntar tus archivos de activos a un directorio aislado (por ejemplo ``/js/compiled``), para mantener las cosas organizadas: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/*' output='js/compiled/main.js' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array('@AcmeFooBundle/Resources/public/js/*'), - array(), - array('output' => 'js/compiled/main.js') - ) as $url): ?> - - diff --git a/_sources/cookbook/assetic/index.txt b/_sources/cookbook/assetic/index.txt deleted file mode 100644 index 19328ef..0000000 --- a/_sources/cookbook/assetic/index.txt +++ /dev/null @@ -1,10 +0,0 @@ -``Assetic`` -=========== - -.. toctree:: - :maxdepth: 2 - - asset_management - yuicompressor - jpeg_optimize - apply_to_option diff --git a/_sources/cookbook/assetic/jpeg_optimize.txt b/_sources/cookbook/assetic/jpeg_optimize.txt deleted file mode 100644 index fb082ab..0000000 --- a/_sources/cookbook/assetic/jpeg_optimize.txt +++ /dev/null @@ -1,243 +0,0 @@ -.. index:: - single: Assetic; Optimizando imágenes - -Cómo utilizar ``Assetic`` para optimizar imágenes con funciones *Twig* -====================================================================== - -Entre sus muchos filtros, ``Assetic`` tiene cuatro filtros que puedes utilizar para optimizar imágenes al vuelo. Esto te permite obtener el beneficio de archivos de menor tamaño sin tener que usar un editor de imágenes para procesar cada imagen. Los resultados se almacenan en caché y se puede vaciar en producción para que no haya impacto en el rendimiento para los usuarios finales. - -Usando *Jpegoptim* ------------------- - -`Jpegoptim`_ es una utilidad para la optimización de archivos JPEG. Para usarlo con ``Assetic``, añade lo siguiente a la configuración de ``Assetic``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - jpegoptim: - bin: ruta/a/jpegoptim - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'jpegoptim' => array( - 'bin' => 'ruta/a/jpegoptim', - ), - ), - )); - -.. note:: - - Ten en cuenta que al usar *jpegoptim*, ya lo debes tener instalado en tu sistema. La opción ``bin`` apunta a la ubicación de los binarios compilados. - -Ahora lo puedes utilizar desde una plantilla: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% image '@AcmeFooBundle/Resources/public/images/example.jpg' - filter='jpegoptim' output='/images/example.jpg' %} - Example - {% endimage %} - - .. code-block:: html+php - - images( - array('@AcmeFooBundle/Resources/public/images/example.jpg'), - array('jpegoptim') - ) as $url): ?> - Example - - -Eliminando todos los datos ``EXIF`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -De manera predeterminada, al ejecutar este filtro sólo eliminas parte de la metainformación almacenada en el archivo. Todos los datos ``EXIF`` ​​y comentarios no se eliminan, pero los puedes quitar usando la opción ``strip_all``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - jpegoptim: - bin: ruta/a/jpegoptim - strip_all: true - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'jpegoptim' => array( - 'bin' => 'path/to/jpegoptim', - 'strip_all' => 'true', - ), - ), - )); - -Reduciendo la calidad máxima -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El nivel de calidad del *JPEG* de manera predeterminada no se ve afectado. Puedes obtener mayor reducción de tamaño del archivo estableciendo la configuración de calidad máxima más baja que el nivel actual de las imágenes. Esto, por supuesto, a expensas de la calidad de la imagen: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - jpegoptim: - bin: ruta/a/jpegoptim - max: 70 - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'jpegoptim' => array( - 'bin' => 'ruta/a/jpegoptim', - 'max' => '70', - ), - ), - )); - -Sintaxis corta: Función *Twig* ------------------------------- - -Si estás utilizando *Twig*, es posible lograr todo esto con una sintaxis más corta habilitando y utilizando una función especial de *Twig*. Comienza por agregar la siguiente configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - jpegoptim: - bin: ruta/a/jpegoptim - twig: - functions: - jpegoptim: ~ - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'jpegoptim' => array( - 'bin' => 'ruta/a/jpegoptim', - ), - ), - 'twig' => array( - 'functions' => array('jpegoptim'), - ), - ), - )); - -Ahora,puedes cambiar la plantilla *Twig* a lo siguiente: - -.. code-block:: html+jinja - - Example - -Puedes especificar el directorio de salida en la configuración de la siguiente manera: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - filters: - jpegoptim: - bin: ruta/a/jpegoptim - twig: - functions: - jpegoptim: { output: images/*.jpg } - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - 'filters' => array( - 'jpegoptim' => array( - 'bin' => 'ruta/a/jpegoptim', - ), - ), - 'twig' => array( - 'functions' => array( - 'jpegoptim' => array( - output => 'images/*.jpg' - ), - ), - ), - )); - -.. _`Jpegoptim`: http://www.kokkonen.net/tjko/projects.html diff --git a/_sources/cookbook/assetic/yuicompressor.txt b/_sources/cookbook/assetic/yuicompressor.txt deleted file mode 100644 index 6e3cc26..0000000 --- a/_sources/cookbook/assetic/yuicompressor.txt +++ /dev/null @@ -1,141 +0,0 @@ -.. index:: - single: Assetic; YUI Compressor - -Cómo minimizar *JavaScript* y hojas de estilo con *YUI Compressor* -================================================================== - -Yahoo! proporciona una excelente utilidad para minimizar (minify) *JavaScript* y hojas de estilo para que viajen más rápido por la red, el `YUI Compressor`_. Gracias a ``Assetic``, puedes tomar ventaja de esta herramienta con mucha facilidad. - -Descargando el *JAR* de *YUI Compressor* ----------------------------------------- - -El *YUI Compressor* está escrito en *Java* y se distribuye como *JAR*. `Descarga el JAR`_ desde el sitio Yahoo! y guárdalo en ``app/Resources/java/yuicompressor.jar``. - -Configurando los filtros de *YUI* ---------------------------------- - -Ahora debes configurar dos *filtros* ``Assetic`` en tu aplicación, uno para minimizar *JavaScript* con el compresor *YUI* y otro para minimizar hojas de estilo: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - assetic: - # java: "/usr/bin/java" - filters: - yui_css: - jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar" - yui_js: - jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar" - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('assetic', array( - // 'java' => '/usr/bin/java', - 'filters' => array( - 'yui_css' => array( - 'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar', - ), - 'yui_js' => array( - 'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar', - ), - ), - )); - -.. note:: - - Los usuarios de Windows se tienen que acordar de actualizar la configuración a la ubicación correcta de Java. - En Windows 7 x64 bits por omisión es ``C:\Archivos de programa (x86)\Java\jre6\bin\java.exe``. - -Ahora tienes acceso a dos nuevos *filtros* ``Assetic`` en tu aplicación: -``yui_css`` y ``yui_js``. Estos utilizan el compresor de *YUI* para minimizar hojas de estilo y *JavaScript*, respectivamente. - -Minimizando tus activos ------------------------ - -Ahora tienes configurado el compresor *YUI*, pero nada va a pasar hasta que apliques uno de estos filtros a un activo. Dado que tus activos son una parte de la capa de la vista, este trabajo se hace en tus plantillas: - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='yui_js' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array('@AcmeFooBundle/Resources/public/js/*'), - array('yui_js') - ) as $url): ?> - - - -.. note:: - - El ejemplo anterior asume que tienes un paquete llamado ``AcmeFooBundle`` y tus archivos *JavaScript* están bajo el directorio ``Resources/public/js`` de tu paquete. No obstante, esto no es importante ---puedes incluir tus archivos *Javascript* sin importar donde se encuentren. - -Con la incorporación del filtro ``yui_js`` a las etiquetas de los activos anteriores, ahora deberías ver llegar mucho más rápido tus *JavaScripts* minimizados a través del cable. Puedes repetir el mismo proceso para minimizar tus hojas de estilo. - -.. configuration-block:: - - .. code-block:: html+jinja - - {% stylesheets '@AcmeFooBundle/Resources/public/css/*' filter='yui_css' %} - - {% endstylesheets %} - - .. code-block:: html+php - - stylesheets( - array('@AcmeFooBundle/Resources/public/css/*'), - array('yui_css') - ) as $url): ?> - - - -Desactivando la minimización en modo de depuración --------------------------------------------------- - -El *JavaScript* y las hojas de estilo minimizadas son muy difíciles de leer, y mucho más de depurar. Debido a esto, ``Assetic`` te permite desactivar un determinado filtro cuando tu aplicación está en modo de depuración. Para ello, puedes prefijar el nombre del filtro en tu plantilla con un signo de interrogación: ``?``. Esto le dice a ``Assetic`` que aplique este filtro sólo cuando el modo de depuración está desactivado. - -.. configuration-block:: - - .. code-block:: html+jinja - - {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='?yui_js' %} - - {% endjavascripts %} - - .. code-block:: html+php - - javascripts( - array('@AcmeFooBundle/Resources/public/js/*'), - array('?yui_js') - ) as $url): ?> - - - - -.. tip:: - - En lugar de añadir el filtro a las etiquetas de activos, también lo puedes activar globalmente añadiendo el atributo ``apply-to`` a la configuración del filtro, por ejemplo, en el filtro ``yui_js apply_to: "\.js$"``. Para aplicar el filtro sólo en producción, agrega esto al archivo ``config_prod`` en lugar de al archivo de configuración común. Para más detalles sobre la aplicación de filtros por extensión de archivo, ve :ref:`cookbook-assetic-apply-to`. - - -.. _`YUI Compressor`: http://developer.yahoo.com/yui/compressor/ -.. _`Descarga el JAR`: http://yuilibrary.com/projects/yuicompressor/ diff --git a/_sources/cookbook/bundles/best_practices.txt b/_sources/cookbook/bundles/best_practices.txt deleted file mode 100644 index 5d1adb6..0000000 --- a/_sources/cookbook/bundles/best_practices.txt +++ /dev/null @@ -1,231 +0,0 @@ -.. index:: - single: Paquete; Buenas prácticas - -Cómo usar las mejores prácticas para estructurar paquetes -========================================================= - -Un paquete es un directorio que tiene una estructura bien definida y puede alojar cualquier cosa, desde clases hasta controladores y recursos web. A pesar de que los paquetes son tan flexibles, se deben seguir algunas recomendaciones si deseas distribuirlos. - -.. index:: - pair: Paquete; Convenciones de nomenclatura - -.. _bundles-naming-conventions: - -Nombre de paquete ------------------ - -Un paquete también es un espacio de nombres *PHP*. El espacio de nombres debe seguir los `estándares`_ de interoperabilidad técnica de los espacios de nombres y nombres de clases de *PHP* 5.3: comienza con un segmento de proveedor, seguido por cero o más segmentos de categoría, y termina con el nombre corto del espacio de nombres, el cual debe terminar con el sufijo ``Bundle``. - -Un espacio de nombres se convierte en un paquete tan pronto como se agrega una clase ``bundle`` al mismo. El nombre de la clase ``bundle`` debe seguir estas sencillas reglas: - -* Solo utiliza caracteres alfanuméricos y guiones bajos; -* Usa mayúsculas intercaladas en el nombre; -* Usa un nombre corto pero descriptivo (de no más de dos palabras); -* Prefija el nombre con la concatenación del proveedor (y, opcionalmente, la categoría del espacio de nombres); -* Sufija el nombre con ``Bundle``. - -Estos son algunos espacios de nombres y nombres de clase ``bundle`` válidos: - -+-----------------------------------+----------------------------+ -| Espacio de nombres | Nombre de clase ``Bundle`` | -+===================================+============================+ -| ``Acme\Bundle\BlogBundle`` | ``AcmeBlogBundle`` | -+-----------------------------------+----------------------------+ -| ``Acme\Bundle\Social\BlogBundle`` | ``AcmeSocialBlogBundle`` | -+-----------------------------------+----------------------------+ -| ``Acme\BlogBundle`` | ``AcmeBlogBundle`` | -+-----------------------------------+----------------------------+ - -Por convención, el método ``getName()`` de la clase ``bundle`` debe devolver el nombre de la clase. - -.. note:: - - Si compartes tu paquete públicamente, debes utilizar el nombre de la clase ``bundle`` como nombre del repositorio (``AcmeBlogBundle`` y no ``BlogBundle`` por ejemplo). - -.. note:: - - Los paquetes del núcleo de *Symfony2* no prefijan la clase ``Bundle`` con ``Symfony`` y siempre agregan un subespacio de nombres ``Bundle``; por ejemplo: - :class:`Symfony\\Bundle\\FrameworkBundle\\FrameworkBundle`. - -Cada paquete tiene un alias, el cual es la versión corta en minúsculas del nombre del paquete con guiones bajos (``acme_hello`` para ``AcmeHelloBundle``, o ``acme_social_blog`` para ``Acme\Social\BlogBundle`` por ejemplo). Este alias se utiliza para forzar la exclusividad dentro de un paquete (ve abajo algunos ejemplos de uso). - -Estructura del directorio -------------------------- - -La estructura básica del directorio del paquete ``HelloBundle`` se debe leer de la siguiente manera: - -.. code-block:: text - - XXX/... - HelloBundle/ - HelloBundle.php - Controller/ - Resources/ - meta/ - LICENSE - config/ - doc/ - index.rst - translations/ - views/ - public/ - Tests/ - -Los directorios ``XXX`` reflejan la estructura del espacio de nombres del paquete. - -Los siguientes archivos son obligatorios: - -* :file:`HelloBundle.php`; -* ``Resources/meta/LICENSE``: La licencia completa para el código; -* ``Resources/doc/index.rst``: El archivo raíz de la documentación del paquete. - -.. note:: - - Estos convenios garantizan que las herramientas automatizadas pueden trabajar confiablemente en esta estructura predeterminada. - -La profundidad de los subdirectorios se debe reducir al mínimo en la mayoría de las clases y archivos utilizados (2 niveles como máximo). Puedes definir más niveles para archivos no estratégicos, los menos utilizados. - -El directorio del paquete es de sólo lectura. Si necesitas escribir archivos temporales, guárdalos en el directorio ``cache/`` o ``log/`` de la aplicación anfitriona. Las herramientas pueden generar archivos en la estructura de directorios del paquete, pero sólo si los archivos generados van a formar parte del repositorio. - -Las siguientes clases y archivos tienen emplazamientos específicos: - -+---------------------------------------+-----------------------------+ -| Tipo | Directorio | -+=======================================+=============================+ -| Ordenes | ``Command/`` | -+---------------------------------------+-----------------------------+ -| Controladores | ``Controller/`` | -+---------------------------------------+-----------------------------+ -| Extensiones contenedoras de servicios | ``DependencyInjection/`` | -+---------------------------------------+-----------------------------+ -| Escuchas de eventos | ``EventListener/`` | -+---------------------------------------+-----------------------------+ -| Configuración | ``Resources/config/`` | -+---------------------------------------+-----------------------------+ -| Recursos *Web* | ``Resources/public/`` | -+---------------------------------------+-----------------------------+ -| Archivos de traducción | ``Resources/translations/`` | -+---------------------------------------+-----------------------------+ -| Plantillas | ``Resources/views/`` | -+---------------------------------------+-----------------------------+ -| Pruebas unitarias y funcionales | ``Tests/`` | -+---------------------------------------+-----------------------------+ - -Clases ------- - -La estructura del directorio de un paquete se utiliza como la jerarquía del espacio de nombres. Por ejemplo, un controlador ``HelloController`` se almacena en ``/HelloBundle/Controller/HelloController.php`` y el nombre de clase completamente cualificado es ``Bundle\HelloBundle\Controller\HelloController``. - -Todas las clases y archivos deben seguir los :doc:`estándares ` de codificación *Symfony2*. - -Algunas clases se deben ver como fachada y deben ser lo más breves posible, al igual que las ordenes, ayudantes, escuchas y controladores. - -Las clases que conectan el Evento al Despachador deben llevar el posfijo ``Listener``. - -Las clases de excepciones se deben almacenar en un subespacio de nombres ``Exception``. - -Terceros --------- - -Un paquete no debe integrar bibliotecas *PHP* de terceros. Se debe confiar en la carga automática estándar de *Symfony2* en su lugar. - -Un paquete no debería integrar bibliotecas de terceros escritas en *JavaScript*, *CSS* o cualquier otro lenguaje. - -Pruebas -------- - -Un paquete debe venir con una batería de pruebas escritas con *PHPUnit* , las cuales se deben almacenar en el directorio ``Test/``. Las pruebas deben seguir los siguientes principios: - -* La batería de pruebas se debe ejecutar con una simple orden ``phpunit`` desde una aplicación de ejemplo; -* Las pruebas funcionales sólo se deben utilizar para probar la respuesta de salida y alguna información de perfilado si tiene alguno; -* Las pruebas por lo menos deben cubrir el 95% del código base. - -.. note:: - Una batería de pruebas no debe contener archivos :file:`AllTests.php`, sino que se debe basar en la existencia de un archivo :file:`phpunit.xml.dist`. - -Documentación -------------- - -Todas las clases y funciones deben venir con *PHPDoc* completo. - -También deberá proporcionar abundante documentación provista en formato :doc:`reStructuredText `, bajo el directorio ``Resources/doc/``; el archivo ``Resources/doc/index.rst`` es el único archivo obligatorio y debe ser el punto de entrada para la documentación. - -Controladores -------------- - -Como práctica recomendada, los controladores en un paquete que está destinado a ser distribuido a otros no debe extender la clase base :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller``. -Puede implementar la :class:`Symfony\\Component\\DependencyInjection\\ContainerAwareInterface` o en su lugar extender la clase :class:`Symfony\\Component\\DependencyInjection\\ContainerAware`. - -.. note:: - - Si echas un vistazo a los métodos de la clase :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller`, podrás ver que sólo son buenos accesos directos para facilitar la curva de aprendizaje. - -Enrutado --------- - -Si el paquete proporciona rutas, estas se deben prefijar con el alias del paquete. -Para un ``AcmeBlogBundle`` por ejemplo, todas las rutas deben llevar el prefijo ``acme_blog_``. - -Plantillas ----------- - -Si un paquete proporciona plantillas, estas deben utilizar *Twig*. Un paquete no debe proporcionar un diseño principal, salvo si ofrece una aplicación completa. - -Archivos de traducción ----------------------- - -Si un paquete proporciona traducción de mensajes, se deben definir en formato *XLIFF*; el dominio se debe mencionar después del nombre del paquete (``bundle.hello``). - -Un paquete no debe reemplazar los mensajes de otro paquete existente. - -Configurando ------------- - -Para proporcionar mayor flexibilidad, un paquete puede proporcionar opciones configurables utilizando los mecanismos integrados de *Symfony2*. - -Para ajustes de configuración simples, confía en los ``parámetros`` predeterminados de la configuración de *Symfony2*. Los parámetros de *Symfony2* simplemente son pares clave/valor; un valor es cualquier valor *PHP* válido. El nombre de cada parámetro debe comenzar con el alias del paquete, aunque esto es sólo una sugerencia de buenas prácticas. El resto del nombre del parámetro utiliza un punto (``.``) para separar las diferentes partes (por ejemplo, ``acme_hello.email.from``). - -El usuario final puede proporcionar valores en cualquier archivo de configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - parameters: - acme_hello.email.from: fabien@example.com - - .. code-block:: xml - - - - fabien@example.com - - - .. code-block:: php - - // app/config/config.php - $container->setParameter('acme_hello.email.from', 'fabien@example.com'); - - .. code-block:: yaml - - ; app/config/config.ini - [parameters] - acme_hello.email.from = fabien@example.com - -Recupera los parámetros de configuración en tu código desde el contenedor:: - - $container->getParameter('acme_hello.email.from'); - -Incluso si este mecanismo es bastante simple, te animamos a usar la configuración semántica descrita en el recetario. - -.. note:: - - Si vas a definir servicios, estos también se deben prefijar con el alias del paquete. - -Aprende más en el recetario ---------------------------- - -* :doc:`/cookbook/bundles/extension` - -.. _`estándares`: http://symfony.com/PSR0 diff --git a/_sources/cookbook/bundles/extension.txt b/_sources/cookbook/bundles/extension.txt deleted file mode 100644 index 8d74469..0000000 --- a/_sources/cookbook/bundles/extension.txt +++ /dev/null @@ -1,497 +0,0 @@ -.. index:: - single: Configuración; Semántica - single: Paquete; Configuración de extensión - -Cómo exponer la configuración semántica de un paquete -===================================================== - -Si abres el archivo de configuración de tu aplicación (por lo general :file:`app/config/config.yml`), puedes encontrar una serie de configuraciones de diferentes «espacios de nombres», como ``framework``, ``twig`` y ``doctrine``. Cada una de estas configura un paquete específico, lo cual te permite configurar las cosas a nivel superior y luego dejar que el paquete haga todo lo de bajo nivel, haciendo los cambios complejos que resulten. - -Por ejemplo, el siguiente fragmento le dice al ``FrameworkBundle`` que habilite la integración de formularios, lo cual implica la definición de unos cuantos servicios, así como la integración de otros componentes relacionados: - -.. configuration-block:: - - .. code-block:: yaml - - framework: - # ... - form: true - - .. code-block:: xml - - - - - - .. code-block:: php - - $container->loadFromExtension('framework', array( - // ... - 'form' => true, - // ... - )); - -Cuando creas un paquete, tienes dos opciones sobre cómo manejar la configuración: - -1. **Configuración normal del servicio** (*fácil*): - - Puedes especificar tus servicios en un archivo de configuración (por ejemplo, :file:`services.yml`) que vive en tu paquete y luego importarlo desde la configuración principal de tu aplicación. Esto es realmente fácil, rápido y completamente eficaz. Si usas :ref:`parámetros `, entonces todavía tienes cierta flexibilidad para personalizar el paquete desde la configuración de tu aplicación. Consulta «:ref:`service-container-imports-directive`» para más detalles. - -2. **Exponiendo la configuración semántica** (*avanzado*): - - Esta es la forma de configuración que se hace con los paquetes básicos (como se describió anteriormente). La idea básica es que, en lugar de permitir al usuario sustituir parámetros individuales, permites al usuario configurar unos cuantos, en concreto la creación de opciones. A medida que desarrollas el paquete, vas analizando la configuración y cargas tus servicios en una clase «Extensión». Con este método, no tendrás que importar ningún recurso de configuración desde la configuración principal de tu aplicación: la clase ``Extension`` puede manejar todo esto. - -La segunda opción ---de la cual aprenderás en este artículo--- es mucho más flexible, pero también requiere más tiempo de configuración. Si te preguntas qué método debes utilizar, probablemente sea una buena idea empezar con el método #1, y más adelante, si es necesario, cambiar al #2. - -El segundo método tiene varias ventajas específicas: - -* Es mucho más poderoso que la simple definición de parámetros: un valor de opción específico podría inducir la creación de muchas definiciones de servicios; - -* La habilidad de tener jerarquías de configuración - -* La fusión inteligente de varios archivos de configuración (por ejemplo, :file:`config_dev.yml` y :file:`config.yml`) sustituye los demás ajustes; - -* Configurando la validación (si utilizas una :ref:`clase Configuración `); - -* Autocompletado en tu *IDE* cuando creas un *XSD* y los desarrolladores del *IDE* utilizan *XML*. - -.. sidebar:: Sustituyendo parámetros del paquete - - Si un paquete proporciona una clase *Extension*, entonces, generalmente *no debes* reemplazar los parámetros del contenedor de servicios de ese paquete. La idea es que si está presente una clase ``Extension``, cada ajuste que deba ser configurable debe estar presente en la configuración disponible en esa clase. En otras palabras, la clase ``Extension`` define cómo dibulgas todas las opciones de configuración apoyadas para las cuales, por mantenimiento, existe compatibilidad hacia atrás. - -.. index:: - single: Paquete; Extensión - single: Inyección de dependencias; Extensión - -Creando una clase ``Extension`` -------------------------------- - -Si eliges exponer una configuración semántica de tu paquete, primero tendrás que crear una nueva clase ``«Extension»``, la cual debe manejar el proceso. -Esta clase debe vivir en el directorio ``DependencyInjection`` de tu paquete y su nombre se debe construir reemplazando el sufijo ``Bundle`` del nombre de la clase del paquete con ``Extension``. Por ejemplo, la clase ``Extension`` de ``AcmeHelloBundle`` se llamaría ``AcmeHelloExtension``:: - - // Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php - namespace Acme\HelloBundle\DependencyInjection; - - use Symfony\Component\HttpKernel\DependencyInjection\Extension; - use Symfony\Component\DependencyInjection\ContainerBuilder; - - class AcmeHelloExtension extends Extension - { - public function load(array $configs, ContainerBuilder $container) - { - // ... aquí se lleva a cabo toda la lógica - } - - public function getXsdValidationBasePath() - { - return __DIR__.'/../Resources/config/'; - } - - public function getNamespace() - { - return 'http://www.ejemplo.com/symfony/schema/'; - } - } - -.. note:: - - Los métodos ``getXsdValidationBasePath`` y ``getNamespace`` sólo son necesarios si el paquete opcional XSD proporciona la configuración. - -La presencia de la clase anterior significa que ahora puedes definir una configuración de espacio de nombres ``acme_hello`` en cualquier archivo de configuración. El espacio de nombres ``acme_hello`` se construyó a partir del nombre en minúsculas de la clase ``Extension`` eliminando la palabra ``Extension``, a continuación un guión bajo y el resto del nombre. En otras palabras, ``AcmeHelloExtension`` se convierte en ``acme_hello``. - -Puedes empezar de inmediato, especificando la configuración en este espacio de nombres: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - acme_hello: ~ - - .. code-block:: xml - - - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('acme_hello', array()); - -.. tip:: - - Si sigues las convenciones de nomenclatura mencionadas anteriormente, entonces el método ``load()`` el cual carga el código de tu extensión es llamado siempre que tu paquete sea registrado en el núcleo. En otras palabras, incluso si el usuario no proporciona ninguna configuración (es decir, la entrada ``acme_hello`` ni siquiera figura), el método ``load()`` será llamado y se le pasará un arreglo ``$configs`` vacío. Todavía puedes proporcionar algunos parámetros predeterminados para tu paquete si lo deseas. - -Analizando el arreglo ``$configs`` ----------------------------------- - -Cada vez que un usuario incluya el espacio de nombres ``acme_hello`` en un archivo de configuración, la configuración bajo este se agrega a un gran arreglo de configuraciones y se pasa al método ``load()`` de tu extensión (*Symfony2* automáticamente convierte *XML* y *YAML* a un arreglo). - -Tomemos la siguiente configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - acme_hello: - foo: fooValue - bar: barValue - - .. code-block:: xml - - - - - - - - barValue - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('acme_hello', array( - 'foo' => 'fooValue', - 'bar' => 'barValue', - )); - -El arreglo pasado a tu método ``load()`` se verá así:: - - array( - array( - 'foo' => 'fooValue', - 'bar' => 'barValue', - ), - ) - -Ten en cuenta que se trata de un *arreglo de arreglos*, y no sólo un único arreglo plano con los valores de configuración. Esto es intencional. Por ejemplo, si ``acme_hello`` aparece en otro archivo de configuración ---digamos en :file:`config_dev.yml`--- con diferentes valores bajo él, entonces el arreglo entrante puede tener este aspecto:: - - array( - array( - 'foo' => 'fooValue', - 'bar' => 'barValue', - ), - array( - 'foo' => 'fooDevValue', - 'baz' => 'newConfigEntry', - ), - ) - -El orden de los dos arreglos depende de cuál es el primer conjunto. - -Entonces, es tu trabajo, decidir cómo se fusionan estas configuraciones. Es posible que, por ejemplo, después tengas que sustituir valores anteriores o alguna combinación de ellos. - -Más tarde, en la sección :ref:`clase Configuración `, aprenderás una forma realmente robusta para manejar esto. Pero por ahora, sólo puedes combinarlos manualmente:: - - public function load(array $configs, ContainerBuilder $container) - { - $config = array(); - foreach ($configs as $subConfig) { - $config = array_merge($config, $subConfig); - } - - // ... ahora usa el arreglo $config plano - } - -.. caution:: - - Asegúrate de que la técnica de fusión anterior tenga sentido para tu paquete. Este es sólo un ejemplo, y debes tener cuidado de no usarlo a ciegas. - -Usando el método ``load()`` ---------------------------- - -Dentro de ``load()``, la variable ``$container`` se refiere a un contenedor que sólo sabe acerca de esta configuración de espacio de nombres (es decir, no contiene información de los servicios cargados por otros paquetes). El objetivo del método ``load()`` es manipular el contenedor, añadir y configurar cualquier método o servicio necesario por tu paquete. - -Cargando la configuración de recursos externos -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Una de las cosas comunes por hacer es cargar un archivo de configuración externo que puede contener la mayor parte de los servicios que necesita tu paquete. Por ejemplo, supongamos que tienes un archivo ``services.xml`` el cual contiene gran parte de la configuración de los servicios en tu paquete:: - - use Symfony\Component\DependencyInjection\Loader\XmlFileLoader; - use Symfony\Component\Config\FileLocator; - - public function load(array $configs, ContainerBuilder $container) - { - // ... prepara tu variable $config - - $loader = new XmlFileLoader( - $container, - new FileLocator(__DIR__.'/../Resources/config') - ); - $loader->load('services.xml'); - } - -Incluso lo podrías hacer condicionalmente, basándote en uno de los valores de configuración. -Por ejemplo, supongamos que sólo deseas cargar un conjunto de servicios si una opción ``habilitado`` es pasada y fijada en ``true``:: - - public function load(array $configs, ContainerBuilder $container) - { - // ... prepara tu variable $config - - $loader = new XmlFileLoader( - $container, - new FileLocator(__DIR__.'/../Resources/config') - ); - - if (isset($config['enabled']) && $config['enabled']) { - $loader->load('services.xml'); - } - } - -Configurando servicios y ajustando parámetros -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Una vez que hayas cargado alguna configuración de servicios, posiblemente necesites modificar la configuración basándote en alguno de los valores entrantes. Por ejemplo, supón que tienes un servicio cuyo primer argumento es algún «tipo» de cadena que se debe utilizar internamente. Quisieras que el usuario del paquete lo configurara fácilmente, por tanto en el archivo de configuración de tu servicio (por ejemplo, ``services.xml``), defines este servicio y utilizas un parámetro en blanco ---``acme_hello.my_service_options``--- como primer argumento: - -.. code-block:: xml - - - - - - - - - - - %acme_hello.my_service_type% - - - - -Pero ¿por qué definir un parámetro vacío y luego pasarlo a tu servicio? -La respuesta es que vas a establecer este parámetro en tu clase ``Extension``, basándote en los valores de configuración entrantes. Supongamos, por ejemplo, que deseas permitir al usuario definir esta opción de *tipo* en una clave denominada ``my_type``. -Para hacerlo agrega lo siguiente al método ``load()``:: - - public function load(array $configs, ContainerBuilder $container) - { - // ... prepara tu variable $config - - $loader = new XmlFileLoader( - $container, - new FileLocator(__DIR__.'/../Resources/config') - ); - $loader->load('services.xml'); - - if (!isset($config['my_type'])) { - throw new \InvalidArgumentException( - 'The "my_type" option must be set' - ); - } - - $container->setParameter( - 'acme_hello.my_service_type', - $config['my_type'] - ); - } - -Ahora, el usuario puede configurar eficientemente el servicio especificando el valor de configuración ``my_type``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - acme_hello: - my_type: foo - # ... - - .. code-block:: xml - - - - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('acme_hello', array( - 'my_type' => 'foo', - ..., - )); - -Parámetros globales -~~~~~~~~~~~~~~~~~~~ - -Cuando configures el contenedor, tienes que estar consciente de que los siguientes parámetros globales están disponibles para que los utilices: - -* ``kernel.name`` -* ``kernel.environment`` -* ``kernel.debug`` -* ``kernel.root_dir`` -* ``kernel.cache_dir`` -* ``kernel.logs_dir`` -* ``kernel.bundle_dirs`` -* ``kernel.bundles`` -* ``kernel.charset`` - -.. caution:: - - Todos los nombres de los parámetros y servicios que comienzan con un guión bajo (``_``) están reservados para la plataforma, y no los debes definir en tus nuevos paquetes. - -.. _cookbook-bundles-extension-config-class: - -Validando y fusionando con una clase configuración --------------------------------------------------- - -Hasta ahora, has fusionado manualmente los arreglos de configuración y los has comprobado por medio de la presencia de los valores de configuración utilizando la función ``isset()`` de *PHP*. También hay disponible un sistema de *configuración* opcional, el cual puede ayudar con la fusión, validación, valores predeterminados y normalización de formato. - -.. note:: - - *Normalización de formato* se refiere al hecho de que ciertos formatos ---en su mayoría *XML*--- resultan en arreglos de configuración ligeramente diferentes, y que estos arreglos se deben «normalizar» para que coincidan con todo lo demás. - -Para aprovechar las ventajas de este sistema, debes crear una clase ``Configuración`` y construir un árbol que define tu configuración en esa clase:: - - // src/Acme/HelloBundle/DependencyInjection/Configuration.php - namespace Acme\HelloBundle\DependencyInjection; - - use Symfony\Component\Config\Definition\Builder\TreeBuilder; - use Symfony\Component\Config\Definition\ConfigurationInterface; - - class Configuration implements ConfigurationInterface - { - public function getConfigTreeBuilder() - { - $treeBuilder = new TreeBuilder(); - $rootNode = $treeBuilder->root('acme_hello'); - - $rootNode - ->children() - ->scalarNode('my_type')->defaultValue('bar')->end() - ->end(); - - return $treeBuilder; - } - } - -Se trata de un ejemplo *muy* sencillo, pero ahora puedes utilizar esta clase en el método ``load()`` para combinar tu configuración y forzar su validación. Si se pasan las demás opciones salvo ``my_type``, el usuario recibirá una notificación con una excepción de que se ha pasado una opción no admitida:: - - public function load(array $configs, ContainerBuilder $container) - { - $configuration = new Configuration(); - - $config = $this->processConfiguration($configuration, $configs); - - // ... - } - -El método ``processConfiguration()`` utiliza el árbol de configuración que has definido en la clase ``Configuración`` para validar, normalizar y fusionar todos los arreglos de configuración. - -La clase ``Configuración`` puede ser mucho más complicada de lo que se muestra aquí, apoyando arreglos de nodos, nodos «prototipo», validación avanzada, normalización *XML* específica y fusión avanzada. Puedes leer más sobre esto en la :doc:`documentación de la configuración del componente `. -También lo puedes ver en acción comprobando alguna de las clases de configuración del núcleo, -como la `configuración del FrameworkBundle`_ o la `configuración del TwigBundle`_. - -Modificando la configuración de otro paquete -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si tienes múltiples paquetes que dependen unos de otros, puede ser útil permitir una clase ``Extension`` para modificar la configuración pasada a la clase ``Extension`` de otro paquete, como si el desarrollador final de hecho haya colocado la configuración en su archivo :file:`app/config/config.yml`. - -Para más detalles, ve :doc:`/cookbook/bundles/prepend_extension`. - -Volcando la configuración predefinida -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - La orden ``config:dump-reference`` se añadió en *Symfony 2.1* - -La orden ``config:dump-reference`` permite volcar a la consola la configuración predefinida de un paquete en formato *YAML*. - -Siempre y cuando la configuración de tu paquete se encuentre en la ubicación estándar (``TuPaquete\DependencyInjection\Configuration``) y no tenga un ``__construct()`` esto funcionará automáticamente. Si tienes algo diferente en tu clase ``Extension`` tendrás que sobrescribir el método :method:`Extension::getConfiguration() ` y devolver una instancia de tu ``Configuration``. - -Puedes añadir comentarios y ejemplos a los nodos de tu configuración usando los métodos -``->info()`` y ``->example()``:: - - // src/Acme/HelloBundle/DependencyExtension/Configuration.php - namespace Acme\HelloBundle\DependencyInjection; - - use Symfony\Component\Config\Definition\Builder\TreeBuilder; - use Symfony\Component\Config\Definition\ConfigurationInterface; - - class Configuration implements ConfigurationInterface - { - public function getConfigTreeBuilder() - { - $treeBuilder = new TreeBuilder(); - $rootNode = $treeBuilder->root('acme_hello'); - - $rootNode - ->children() - ->scalarNode('my_type') - ->defaultValue('bar') - ->info('what my_type configures') - ->example('example setting') - ->end() - ->end() - ; - - return $treeBuilder; - } - } - -Este texto aparece en comentarios *YAML* en el resultado de la orden ``config:dump-reference``. - -.. index:: - pair: Convención; Configuración - -Convenciones de extensión -------------------------- - -Al crear una extensión, sigue estas simples convenciones: - -* La extensión se debe almacenar en el subespacio de nombres ``DependencyInjection``; - -* La extensión se debe nombrar después del nombre del paquete y con el sufijo ``Extension`` (``AcmeHelloExtension`` para ``AcmeHelloBundle``); - -* La extensión debe proporcionar un esquema *XSD*. - -Si sigues estas simples convenciones, *Symfony2* registrará automáticamente las extensiones. De no ser así, sustituye el método :method:`Bundle::build() ` en tu paquete:: - - // ... - use Acme\HelloBundle\DependencyInjection\UnconventionalExtensionClass; - - class AcmeHelloBundle extends Bundle - { - public function build(ContainerBuilder $container) - { - parent::build($container); - - // registra manualmente las extensiones que no siguen las convenciones - $container->registerExtension(new UnconventionalExtensionClass()); - } - } - -En este caso, la clase ``Extension`` también debe implementar un método ``getAlias()`` que devuelva un alias único nombrado después del paquete (por ejemplo, ``acme_hello``). Esto es necesario porque el nombre de clase no sigue la norma de terminar en ``Extension``. - -Además, el método ``load()`` de tu extensión *sólo* se llama si el usuario especifica el alias ``acme_hello`` en por lo menos un archivo de configuración. Una vez más, esto se debe a que la clase ``Extension`` no se ajusta a las normas establecidas anteriormente, por lo tanto nada sucede automáticamente. - -.. _`configuración del FrameworkBundle`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/FrameworkBundle/DependencyInjection/Configuration.php -.. _`configuración del TwigBundle`: https://github.com/symfony/symfony/blob/master/src/Symfony/Bundle/TwigBundle/DependencyInjection/Configuration.php diff --git a/_sources/cookbook/bundles/index.txt b/_sources/cookbook/bundles/index.txt deleted file mode 100644 index 80d549b..0000000 --- a/_sources/cookbook/bundles/index.txt +++ /dev/null @@ -1,13 +0,0 @@ -Paquetes -======== - -.. toctree:: - :maxdepth: 2 - - installation - best_practices - inheritance - override - remove - extension - prepend_extension diff --git a/_sources/cookbook/bundles/inheritance.txt b/_sources/cookbook/bundles/inheritance.txt deleted file mode 100644 index 0a887fc..0000000 --- a/_sources/cookbook/bundles/inheritance.txt +++ /dev/null @@ -1,80 +0,0 @@ -.. index:: - single: Paquete; Herencia - -Cómo utilizar la herencia de paquetes para redefinir partes de un paquete -========================================================================= - -Cuando trabajes con paquetes de terceros, probablemente llegues a una situación en la que desees reemplazar un archivo en ese paquete de terceros con un archivo de uno de tus propios paquetes. *Symfony* te proporciona una forma muy conveniente para sustituir cosas como controladores, plantillas, traducciones, y otros archivos en el directorio ``Resources/`` de los paquetes. - -Por ejemplo, supongamos que estás instalando el `FOSUserBundle`_, pero deseas sustituir su plantilla base ---``layout.html.twig``---, así como uno de sus controladores. Supongamos también que tienes tu propio ``AcmeUserBundle`` donde deseas que vivan los archivos sobrescritos. Para empezar, registra el ``FOSUserBundle`` como el «padre» de tu paquete:: - - // src/Acme/UserBundle/AcmeUserBundle.php - namespace Acme\UserBundle; - - use Symfony\Component\HttpKernel\Bundle\Bundle; - - class AcmeUserBundle extends Bundle - { - public function getParent() - { - return 'FOSUserBundle'; - } - } - -Al hacer este simple cambio, ahora puedes sustituir varias partes del ``FOSUserBundle`` simplemente creando un archivo con el mismo nombre. - -.. note:: - - A pesar del nombre del método, entre paquetes no hay una relación padre/hijo, sólo es una manera de extender y reemplazar un paquete existente. - -Sustituyendo controladores -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Supongamos que deseas añadir alguna funcionalidad al ``RegisterAction`` de ``RegistrationController`` que vive dentro de ``FOSUserBundle``. Para ello, basta con crear tu propio archivo :file:`RegistrationController.php`, reemplaza el método original, y cambia su funcionalidad:: - - // src/Acme/UserBundle/Controller/RegistrationController.php - namespace Acme\UserBundle\Controller; - - use FOS\UserBundle\Controller\RegistrationController as BaseController; - - class RegistrationController extends BaseController - { - public function registerAction() - { - $response = parent::registerAction(); - - // ... haz tus cosas personalizadas - return $response; - } - } - -.. tip:: - - Dependiendo de cuanto necesites cambiar el comportamiento, puedes llamar a ``parent::RegisterAction()`` o sustituir por completo su lógica con la tuya. - -.. note:: - - La sustitución de controladores de esta forma solo funciona si el paquete se refiere al controlador usando la sintaxis estándar ``FOSUserBundle:Registration:register`` en las rutas y plantillas. Esta es la buena práctica. - -Sustituyendo recursos: Plantillas, Enrutado, Validación, etc. -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -También puedes cambiar la mayoría de los recursos, simplemente creando un archivo en la misma ubicación que en el padre de tu paquete. - -Por ejemplo, es muy común que necesites reemplazar la plantilla ``layout.html.twig`` de ``FOSUserBundle`` para que utilice el diseño base de tu aplicación. -Debido a que el archivo vive en ``Resources/views/layout.html.twig`` en ``FOSUserBundle``, puedes crear tu propio archivo en el mismo lugar dentro de ``AcmeUserBundle``. -*Symfony* ignorará el archivo que vive dentro de ``FOSUserBundle`` por completo, y en su lugar utilizará ese archivo. - -Lo mismo ocurre con los archivos de enrutado, la configuración de validación y otros recursos. - -.. note:: - - La sustitución de recursos sólo funciona cuando haces referencia a los recursos con el método ``@FosUserBundle/Resources/config/routing/security.xml``. - Si te refieres a recursos sin utilizar el acceso directo ``@BundleName``, no puedes reemplazar en esta forma. - -.. caution:: - - Los archivos de traducción no funcionan de la misma manera como se describió anteriormente. todos los archivos de traducción se acumulan en un conjunto de «piscinas» (una por cada) dominio. *Symfony*, primero carga los archivos de traducción desde los paquetes (en el orden en que se inician los paquetes) y luego desde tu directorio ``app(Resources``. Si la misma traducción se especifica en dos recursos, gana la traducción de los recursos cargada al último. - -.. _`FOSUserBundle`: https://github.com/friendsofsymfony/fosuserbundle - diff --git a/_sources/cookbook/bundles/installation.txt b/_sources/cookbook/bundles/installation.txt deleted file mode 100644 index 386410d..0000000 --- a/_sources/cookbook/bundles/installation.txt +++ /dev/null @@ -1,146 +0,0 @@ -.. index:: - single: Paquete; Instalando - -How to install 3rd party Bundles -================================ - -Most bundles provide their own installation instructions. However, the -basic steps for installing a bundle are the same. - -Add Composer Dependencies -------------------------- - -Starting from Symfony 2.1, dependencies are managed with Composer. It's -a good idea to learn some basics of Composer in `their documentation`_. - -Before you can use composer to install a bundle, you should look for a -`Packagist`_ package of that bundle. For example, if you search for the popular -`FOSUserBundle`_ you will find a packaged called `friendsofsymfony/user-bundle`_. - -.. note:: - - Packagist is the main archive for Composer. If you are searching - for a bundle, the best thing you can do is check out - `KnpBundles`_, it is the unofficial achive of Symfony Bundles. If - a bundle contains a ``README`` file, it is displayed there and if it - has a Packagist package it shows a link to the package. It's a - really useful site to begin searching for bundles. - -Now that you have the package name, you should determine the version -you want to use. Usually different versions of a bundle correspond to -a particular version of Symfony. This information should be in the ``README`` -file. If it isn't, you can use the version you want. If you choose an incompatible -version, Composer will throw dependency errors when you try to install. If -this happens, you can try a different version. - -In the case of the FOSUserBundle, the ``README`` file has a caution that version -1.2.0 must be used for Symfony 2.0 and 1.3+ for Symfony 2.1+. Packagist displays -example ``require`` statements for all existing versions of a package. The -current development version of FOSUserBundle is ``"friendsofsymfony/user-bundle": "2.0.*@dev"``. - -Now you can add the bundle to your ``composer.json`` file and update the -dependencies. You can do this manually: - -1. **Add it to the composer.json file:** - - .. code-block:: json - - { - ..., - "require": { - ..., - "friendsofsymfony/user-bundle": "2.0.*@dev" - } - } - -2. **Update the dependency:** - - .. code-block:: bash - - $ php composer.phar update friendsofsymfony/user-bundle - - or update all dependencies - - .. code-block:: bash - - $ php composer.phar update - -Or you can do this in one command: - -.. code-block:: bash - - $ php composer.phar require friendsofsymfony/user-bundle:2.0.*@dev - -Enable the Bundle ------------------ - -At this point, the bundle is installed in your Symfony project (in -``vendor/friendsofsymfony/``) and the autoloader recognizes its classes. -The only thing you need to do now is register the bundle in ``AppKernel``:: - - // app/AppKernel.php - - // ... - class AppKernel extends Kernel - { - // ... - - public function registerBundles() - { - $bundles = array( - // ..., - new FOS\UserBundle\FOSUserBundle(), - ); - - // ... - } - } - -Configure the Bundle --------------------- - -Usually a bundle requires some configuration to be added to app's -``app/config/config.yml`` file. The bundle's documentation will likely -describe that configuration. But you can also get a reference of the -bundle's config via the ``config:dump-reference`` command. - -For instance, in order to look the reference of the ``assetic`` config you -can use this: - -.. code-block:: bash - - $ app/console config:dump-reference AsseticBundle - -or this: - -.. code-block:: bash - - $ app/console config:dump-reference assetic - -The output will look like this: - -.. code-block:: text - - assetic: - debug: %kernel.debug% - use_controller: - enabled: %kernel.debug% - profiler: false - read_from: %kernel.root_dir%/../web - write_to: %assetic.read_from% - java: /usr/bin/java - node: /usr/local/bin/node - node_paths: [] - # ... - -Other Setup ------------ - -At this point, check the ``README`` file of your brand new bundle to see -what do to next. - -.. _their documentation: http://getcomposer.org/doc/00-intro.md -.. _`Packagist`: https://packagist.org -.. _FOSUserBundle: https://github.com/FriendsOfSymfony/FOSUserBundle -.. _`friendsofsymfony/user-bundle`: https://packagist.org/packages/friendsofsymfony/user-bundle -.. _KnpBundles: http://knpbundles.com/ diff --git a/_sources/cookbook/bundles/override.txt b/_sources/cookbook/bundles/override.txt deleted file mode 100644 index db6a699..0000000 --- a/_sources/cookbook/bundles/override.txt +++ /dev/null @@ -1,99 +0,0 @@ -.. index:: - single: Paquete; Herencia - -Cómo sustituir cualquier parte de un paquete -============================================ - -Este documento es una referencia rápida sobre la forma de reemplazar las diferentes partes de los paquetes de terceros. - -Plantillas ----------- - -Para más información sobre la sustitución de plantillas, consulta: - -* :ref:`overriding-bundle-templates`. -* :doc:`/cookbook/bundles/inheritance` - -Enrutado --------- - -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. - -Controladores -------------- - -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 :doc:`/cookbook/bundles/inheritance`. - -Servicios y configuración -------------------------- - -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 :file:`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 :file:`Resources/config/translation.xml` en el núcleo de ``FrameworkBundle``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - parameters: - translator.class: Acme\HelloBundle\Translation\Translator - - .. code-block:: xml - - - - Acme\HelloBundle\Translation\Translator - - - .. code-block:: php - - // 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 :doc:`/cookbook/service_container/compiler_passes` 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. - -Entidades y asignación de entidades ------------------------------------ - -En curso... - -Formularios ------------ - -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()); - -Metadatos de validación ------------------------ - -En curso... - -Traducciones ------------- - -En curso... diff --git a/_sources/cookbook/bundles/prepend_extension.txt b/_sources/cookbook/bundles/prepend_extension.txt deleted file mode 100644 index 0ddaa3b..0000000 --- a/_sources/cookbook/bundles/prepend_extension.txt +++ /dev/null @@ -1,116 +0,0 @@ -.. index:: - single: Configuración; Semántica - single: Paquete; Configuración de extensión - -Cómo simplificar la configuración de múltiples paquetes -======================================================= - -Al crear aplicaciones reutilizables y extensibles, los desarrolladores suelen enfrentarse a una elección: o bien crear un gran paquete único o múltiples paquetes más pequeños. La creación de un único paquete tiene la gran desventaja de que le es imposible a los usuarios optar por eliminar funcionalidad que no estén utilizando. La creación de múltiples paquetes tiene la desventaja que la configuración se vuelve más tediosa y los ajustes a menudo se tienen que repetir para varios paquetes. - -Utilizando el enfoque de abajo, es posible eliminar la desventaja del enfoque de múltiples paquetes, permitiendo a una única extensión anteponer los ajustes para cualquier paquete. Puedes utilizar los ajustes definidos en el archivo :file:`app/config/config.yml` anteponiendo los ajustes tal y como si el usuario los hubiera escrito expresamente en la configuración de la aplicación. - -Por ejemplo, esto lo podrías utilizar para configurar el nombre del gestor de entidades a utilizar en múltiples paquetes. O se puede utilizar para activar una función opcional que depende de que otro paquete se cargue también. - -Para dotar a una Extensión con el poder de hacer esto, necesitas implementar la clase :class:`Symfony\\Component\\DependencyInjection\\Extension\\PrependExtensionInterface`:: - - // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php - namespace Acme\HelloBundle\DependencyInjection; - - use Symfony\Component\HttpKernel\DependencyInjection\Extension; - use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface; - use Symfony\Component\DependencyInjection\ContainerBuilder; - - class AcmeHelloExtension extends Extension implements PrependExtensionInterface - { - // ... - - public function prepend(ContainerBuilder $container) - { - // ... - } - } - -Dentro del método :method:`Symfony\\Component\\DependencyInjection\\Extension\\PrependExtensionInterface::prepend`, los desarrolladores tienen acceso completo a la instancia de la clase :class:`Symfony\\Component\\DependencyInjection\\ContainerBuilder` justo antes de llamar al método :method:`Symfony\\Component\\DependencyInjection\\Extension\\ExtensionInterface::load` en cada una de las extensiones registradas en el paquete. Para añadir al principio una configuración los desarrolladores de la extensión del paquete pueden utilizar el método :method:`Symfony\\Component\\DependencyInjection\\ContainerBuilder::prependExtensionConfig` de la instancia de :class:`Symfony\\Component\\DependencyInjection\\ContainerBuilder`. Dado que este método sólo añade la configuracion al principio, cualquier otra opción colocada explícitamente dentro del archivo :file:`app/config/config.yml` debería reemplazar esta configuración antepuesta. - -El siguiente ejemplo muestra cómo añadir al principio una opción de configuración en múltiples paquetes, así como desactivar una bandera en múltiples paquetes en el caso de que otro paquete específico no esté registrado:: - - public function prepend(ContainerBuilder $container) - { - // obtiene todos los paquetes - $bundles = $container->getParameter('kernel.bundles'); - // determina si AcmeGoodbyeBundle está registrado - if (!isset($bundles['AcmeGoodbyeBundle'])) { - // desactiva AcmeGoodbyeBundle en los paquetes - $config = array('use_acme_goodbye' => false); - foreach ($container->getExtensions() as $name => $extension) { - switch ($name) { - case 'acme_something': - case 'acme_other': - // establece use_acme_goodbye a false en la configuración - // de acme_something y acme_other ten en cuenta que - // si el usuario configura manualmente - // use_acme_goodbye a true en app/config/config.yml - // entonces al final el ajuste sería true y no false - $container->prependExtensionConfig($name, $config); - break; - } - } - } - - // procesa la configuración de AcmeHelloExtension - $configs = $container->getExtensionConfig($this->getAlias()); - // usa la clase Configuration para generar un arreglo config - // con los ajustes de ``acme_hello`` - $config = $this->processConfiguration(new Configuration(), $configs); - - // comprueba si entity_manager_name se ajustó en la - // configuración de ``acme_hello`` - if (isset($config['entity_manager_name'])) { - // añade al principio la configuracion de acme_something - // con el entity_manager_name - $config = array('entity_manager_name' => $config['entity_manager_name']); - $container->prependExtensionConfig('acme_something', $config); - } - } - -Lo anterior sería el equivalente de escribir lo siguiente en el archivo :file:`app/config/config.yml` en caso de que ``AcmeGoodbyeBundle`` no se haya registrado y la opcion ``entity_manager_name`` para ``acme_hello`` esté configurada como ``non_default``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - - acme_something: - # ... - use_acme_goodbye: false - entity_manager_name: non_default - - acme_other: - # ... - use_acme_goodbye: false - - .. code-block:: xml - - - - - non_default - - - - - .. code-block:: php - - // app/config/config.php - - $container->loadFromExtension('acme_something', array( - ..., - 'use_acme_goodbye' => false, - 'entity_manager_name' => 'non_default', - )); - $container->loadFromExtension('acme_other', array( - ..., - 'use_acme_goodbye' => false, - )); - diff --git a/_sources/cookbook/bundles/remove.txt b/_sources/cookbook/bundles/remove.txt deleted file mode 100644 index f6828dd..0000000 --- a/_sources/cookbook/bundles/remove.txt +++ /dev/null @@ -1,78 +0,0 @@ -.. index:: - single: Paquete; Eliminando el AcmeDemoBundle - -Cómo eliminar el ``AcmeDemoBundle`` -=================================== - -La *edición estándar de Symfony2* viene con una demo completa que vive dentro de un paquete llamado ``AcmeDemoBundle``. Es un gran texto modelo al cual referirte mientras empiezas un proyecto, pero probablemente quieras eliminarlo finalmente. - -.. tip:: - - Este artículo utiliza el ``AcmeDemoBundle`` como ejemplo, pero puedes utilizar estos pasos para eliminar cualquier paquete. - -1. Desregistrar el paquete en el :file:`AppKernel` --------------------------------------------------- - -Para desconectar el paquete de la plataforma, lo deberías quitar del método ``Appkernel::registerBundles()``. El paquete normalmente se encuentra en el arreglo ``$bundles pero el ``AcmeDemoBundle`` sólo se registra en un entorno de desarrollo y lo puedes encontrar en la siguiente declaración ``if``:: - - // app/AppKernel.php - - // ... - class AppKernel extends Kernel - { - public function registerBundles() - { - $bundles = array(...); - - if (in_array($this->getEnvironment(), array('dev', 'test'))) { - // comenta o elimina esta línea: - // $bundles[] = new Acme\DemoBundle\AcmeDemoBundle(); - // ... - } - } - } - -2. Quita la configuración del paquete -------------------------------------- - -Ahora que *Symfony* no sabe sobre el paquete, necesitas quitar toda su configuración y enrutado dentro del directorio :file:`app/config` que refiera al paquete. - -2.1 Quita el enrutado del paquete -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El enrutado para el ``AcmeDemoBundle`` se puede encontrar en :file:`app/config/routing_dev.yml`. Las rutas son ``_welcome``, ``_demo_secured`` y ``_demo``. Quita esas tres entradas. - -2.2 Quita la configuración del paquete -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Algunos paquetes contienen configuración en uno de los archivos en :file:`app/config/config*.yml`. Asegúrate de sacar la configuración relacionada de esos archivos. Rápidamente puedes determinar la configuración del paquete en el sitio buscando una cadena ``acme_demo`` (o alguna cosa que nombre el paquete, p. ej. ``fos_user`` para el ``FOSUserBundle``) en los archivos de configuración. - -El ``AcmeDemoBundle`` no tiene configuración. Sin embargo, se utiliza el paquete en la configuración del archivo :file:`app/config/security.yml`. Lo puedes utilizar como texto modelo para tu propia seguridad, pero también *puedes* quitar todo: A *Symfony* no le importa si lo quitas o no. - -3. Elimina el paquete del sistema de archivos ---------------------------------------------- - -Ahora que has quitado toda referencia al paquete en tu aplicación, deberías quitar el paquete del *sistema de archivos*. El paquete se localiza en el directorio :file:`src/Acme/DemoBundle`. Deberías quitar ese directorio y también puedes quitar el directorio ``Acme``. - -.. tip:: - - Si no sabes la ubicación de un paquete, puedes utilizar el método :method:`Symfony\\Bundle\\FrameworkBundle\\Bundle\\Bundle::getPath` para conseguir la ruta del paquete:: - - echo $this->container->get('kernel')->getBundle('AcmeDemoBundle')->getPath(); - -4. Quita la integración en otros paquetes ------------------------------------------ - -.. note:: - - Esto no aplica al ``AcmeDemoBundle`` --- ningún otro paquete depende de él, así que puedes omitir este paso. - -Algunos paquetes dependen de otros paquetes, si quitas uno de los dos, el otro probablemente no trabaje. Asegúrate que ningún otro paquete, de terceros o personalizado, dependa del paquete que estás a punto de quitar. - -.. tip:: - - Si un paqute depende de otro, significa que este utiliza algunos servicios del paquete. Buscar una cadena ``acme_demo`` te puede ayudar descubrirlos. - -.. tip:: - - Si un paquete de terceros depende de otro, puedes encontrar ese paquete mencionado en el archivo :file:`composer.json` incluido en el directorio :file:`bundle`. \ No newline at end of file diff --git a/_sources/cookbook/cache/index.txt b/_sources/cookbook/cache/index.txt deleted file mode 100644 index 0cf7122..0000000 --- a/_sources/cookbook/cache/index.txt +++ /dev/null @@ -1,7 +0,0 @@ -Almacenando en caché -==================== - -.. toctree:: - :maxdepth: 2 - - varnish diff --git a/_sources/cookbook/cache/varnish.txt b/_sources/cookbook/cache/varnish.txt deleted file mode 100644 index 855bf92..0000000 --- a/_sources/cookbook/cache/varnish.txt +++ /dev/null @@ -1,78 +0,0 @@ -.. index:: - single: Caché; Varnish - -Cómo utilizar *Varnish* para acelerar mi sitio *web* -==================================================== - -Debido a que la caché de *Symfony2* utiliza las cabeceras de caché *HTTP* estándar, el :ref:`symfony-gateway-cache` se puede sustituir fácilmente por cualquier otro delegado inverso. *Varnish* es un potente acelerador *HTTP*, de código abierto, capaz de servir contenido almacenado en caché de forma rápida y es compatible con :ref:`Inclusión del borde lateral `. - -.. index:: - single: Varnish; Configuración - -Configurando ------------- - -Como vimos anteriormente, *Symfony2* es lo suficientemente inteligente como para detectar si está hablando con un delegado inverso que entiende *ESI* o no. Funciona fuera de la caja cuando utilizas el delegado inverso de *Symfony2*, pero necesita una configuración especial para que funcione con *Varnish*. Afortunadamente, *Symfony2* se basa en otra norma escrita por Akamaï (`Arquitectura límite`_), por lo que el consejo de configuración en este capítulo te puede ser útil incluso si no utilizas *Symfony2*. - -.. note:: - - *Varnish* sólo admite el atributo ``src`` para las etiquetas *ESI* (los atributos ``onerror`` y ``alt`` se omiten). - -En primer lugar, configura *Varnish* para que anuncie su apoyo a *ESI* añadiendo una cabecera ``Surrogate-Capability`` a las peticiones remitidas a la interfaz administrativa de tu aplicación: - -.. code-block:: text - - sub vcl_recv { - set req.http.Surrogate-Capability = "abc=ESI/1.0"; - } - -Entonces, optimiza *Varnish* para que sólo analice el contenido de la respuesta cuando al menos hay una etiqueta *ESI* comprobando la cabecera ``Surrogate-Control`` que *Symfony2* añade automáticamente: - -.. code-block:: text - - sub vcl_fetch { - if (beresp.http.Surrogate-Control ~ "ESI/1.0") { - unset beresp.http.Surrogate-Control; - - // para Varnish >= 3.0 - set beresp.do_esi = true; - // para Varnish < 3.0 - // esi; - } - } - -.. caution:: - - La compresión con *ESI* no cuenta con el apoyo de *Varnish* hasta la versión 3.0 (lee `GZIP y Varnish`_). Si no estás utilizando *Varnish 3.0*, coloca un servidor web frente a *Varnish* para llevar a cabo la compresión. - -.. index:: - single: Varnish; Invalidando - -Invalidando la caché --------------------- - -Nunca debería ser necesario invalidar los datos almacenados en caché porque la invalidación ya se tiene en cuenta de forma nativa en los modelos de caché *HTTP* (consulta :ref:`http-cache-invalidation`). - -Sin embargo, *Varnish* se puede configurar para aceptar un método *HTTP* especial ``PURGE`` que invalida la caché para un determinado recurso: - -.. code-block:: text - - sub vcl_hit { - if (req.request == "PURGE") { - set obj.ttl = 0s; - error 200 "Purged"; - } - } - - sub vcl_miss { - if (req.request == "PURGE") { - error 404 "Not purged"; - } - } - -.. caution:: - - De alguna manera, debes proteger el método ``PURGE`` de *HTTP* para evitar que alguien aleatoriamente purgue los datos memorizados. - -.. _`Arquitectura límite`: http://www.w3.org/TR/edge-arch -.. _`GZIP y Varnish`: https://www.varnish-cache.org/docs/3.0/phk/gzip.html \ No newline at end of file diff --git a/_sources/cookbook/configuration/apache_router.txt b/_sources/cookbook/configuration/apache_router.txt deleted file mode 100644 index fd2a5c2..0000000 --- a/_sources/cookbook/configuration/apache_router.txt +++ /dev/null @@ -1,132 +0,0 @@ -.. index:: - single: Enrutador Apache - -Cómo usar el enrutador de *Apache* -================================== - -Si bien *Symfony2*, es muy rápido fuera de la caja, también proporciona varias maneras de aumentar esa velocidad con unos cuantos ajustes. -Una de esas maneras es dejando que *Apache* maneje el enrutado directamente, en lugar de utilizar *Symfony2* para esta tarea. - -Cambiando los parámetros de configuración del enrutador -------------------------------------------------------- - -Para volcar las rutas de *Apache*, primero debes modificar algunos parámetros de configuración para decirle a *Symfony2* que utilice el ``ApacheUrlMatcher`` en lugar de la opción predeterminada. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_prod.yml - parameters: - router.options.matcher.cache_class: ~ # desactiva la caché de enrutado - router.options.matcher_class: Symfony\Component\Routing\Matcher\ApacheUrlMatcher - - .. code-block:: xml - - - - null - - Symfony\Component\Routing\Matcher\ApacheUrlMatcher - - - - .. code-block:: php - - // app/config/config_prod.php - $container->setParameter('router.options.matcher.cache_class', null); // desactuva la caché de enrutado - $container->setParameter( - 'router.options.matcher_class', - 'Symfony\Component\Routing\Matcher\ApacheUrlMatcher' - ); - -.. tip:: - - Ten en cuenta que :class:`Symfony\\Component\\Routing\\Matcher\\ApacheUrlMatcher` extiende a :class:`Symfony\\Component\\Routing\\Matcher\\UrlMatcher` por lo que incluso si no se regeneran las reglas ``url_rewrite``, todo saldrá bien (porque al final ``ApacheUrlMatcher::match()`` hace una llamada a ``parent::match()``). - -Generando reglas para ``mod_rewrite`` -------------------------------------- - -Para comprobar que está funcionando, vamos a crear una ruta muy básica para el paquete de demostración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - hello: - path: /hello/{name} - defaults: { _controller: AcmeDemoBundle:Demo:hello } - - .. code-block:: xml - - - - AcmeDemoBundle:Demo:hello - - - .. code-block:: php - - // app/config/routing.php - $collection->add('hello', new Route('/hello/{name}', array( - '_controller' => 'AcmeDemoBundle:Demo:hello', - ))); - -Ahora genera las reglas **url_rewrite**: - -.. code-block:: bash - - $ php app/console router:dump-apache -e=prod --no-debug - -Lo cual debe mostrar ---más o menos--- lo siguiente: - -.. code-block:: apache - - # salta peticiones «reales» - RewriteCond %{REQUEST_FILENAME} -f - RewriteRule .* - [QSA,L] - - # hello - RewriteCond %{REQUEST_URI} ^/hello/([^/]+?)$ - RewriteRule .* app.php [QSA,L,E=_ROUTING__route:hello,E=_ROUTING_name:%1,E=_ROUTING__controller:AcmeDemoBundle\:Demo\:hello] - -Ahora puedes volver a escribir ``web/.htaccess`` para utilizar las nuevas reglas, de modo que este ejemplo debería tener el siguiente aspecto: - -.. code-block:: apache - - - RewriteEngine On - - # salta peticiones "reales" - RewriteCond %{REQUEST_FILENAME} -f - RewriteRule .* - [QSA,L] - - # hello - RewriteCond %{REQUEST_URI} ^/hello/([^/]+?)$ - RewriteRule .* app.php [QSA,L,E=_ROUTING__route:hello,E=_ROUTING_name:%1,E=_ROUTING__controller:AcmeDemoBundle\:Demo\:hello] - - -.. note:: - - El procedimiento anterior se debe realizar cada vez que añadas/cambies la ruta si quieres sacar el máximo provecho de esta configuración. - -¡Eso es todo! -Ahora estás listo para usar las reglas de enrutado de *Apache*. - -Ajustes adicionales -------------------- - -Para ahorrar un poco de tiempo en el procesamiento, cambia las ocurrencias de ``Request`` a ``ApacheRequest`` en ``web/app.php``:: - - // web/app.php - - require_once __DIR__.'/../app/bootstrap.php.cache'; - require_once __DIR__.'/../app/AppKernel.php'; - //require_once __DIR__.'/../app/AppCache.php'; - - use Symfony\Component\HttpFoundation\ApacheRequest; - - $kernel = new AppKernel('prod', false); - $kernel->loadClassCache(); - //$kernel = new AppCache($kernel); - $kernel->handle(ApacheRequest::createFromGlobals())->send(); diff --git a/_sources/cookbook/configuration/environments.txt b/_sources/cookbook/configuration/environments.txt deleted file mode 100644 index b366d09..0000000 --- a/_sources/cookbook/configuration/environments.txt +++ /dev/null @@ -1,283 +0,0 @@ -.. index:: - single: Entornos - -Cómo dominar y crear nuevos entornos -==================================== - -Cada aplicación es la combinación de código y un conjunto de configuración que dicta la forma en que el código debería funcionar. La configuración puede definir la base de datos a usar, si o no se debe almacenar en caché, o cómo se debe detallar la anotación cronológica de eventos en la bitácora. En *Symfony2*, la idea de «entornos» es la idea de que el mismo código base se puede ejecutar con varias configuraciones diferentes. Por ejemplo, el entorno ``dev`` debería usar la configuración que facilita el desarrollo y lo hace agradable, mientras que el entorno ``prod`` debe usar un conjunto de configuración optimizado para velocidad. - -.. index:: - single: Entornos; Archivos de configuración - -Diferentes entornos, diferentes archivos de configuración ---------------------------------------------------------- - -Una típica aplicación *Symfony2* comienza con tres entornos: ``dev``, ``prod`` y ``test``. Como se mencionó anteriormente, cada «entorno» simplemente representa una manera de ejecutar el mismo código base con diferente configuración. No debería ser una sorpresa entonces que cada entorno cargue su propio archivo de configuración individual. Si estás utilizando el formato de configuración *YAML*, utiliza los siguientes archivos: - -* para el entorno ``dev``: ``app/config/config_dev.yml`` -* para el entorno ``prod``: ``app/config/config_prod.yml`` -* para el entorno ``test``: ``app/config/config_test.yml`` - -Esto funciona a través de un estándar sencillo que se utiliza por omisión dentro de la clase ``AppKernel``: - -.. code-block:: php - - // app/AppKernel.php - - // ... - - class AppKernel extends Kernel - { - // ... - - public function registerContainerConfiguration(LoaderInterface $loader) - { - $loader->load(__DIR__.'/config/config_'.$this->getEnvironment().'.yml'); - } - } - -Como puedes ver, cuando se carga *Symfony2*, utiliza el entorno especificado para determinar qué archivo de configuración cargar. Esto cumple con el objetivo de múltiples entornos en una manera elegante, potente y transparente. - -Por supuesto, en realidad, cada entorno difiere un poco de los demás. -En general, todos los entornos comparten una gran configuración base común. -Abriendo el archivo de configuración «dev», puedes ver cómo se logra esto fácil y transparentemente: - -.. configuration-block:: - - .. code-block:: yaml - - imports: - - { resource: config.yml } - # ... - - .. code-block:: xml - - - - - - - .. code-block:: php - - $loader->import('config.php'); - // ... - -Para compartir configuración común, el archivo de configuración de cada entorno simplemente importa primero los ajustes más comunes desde un archivo de configuración central (:file:`config.yml`). -El resto del archivo se puede desviar de la configuración predeterminada sustituyendo parámetros individuales. Por ejemplo, de manera predeterminada, la barra de herramientas ``web_profiler`` está desactivada. Sin embargo, en el entorno ``dev``, la barra de herramientas se activa modificando el valor predeterminado en el archivo de configuración ``dev``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_dev.yml - imports: - - { resource: config.yml } - - web_profiler: - toolbar: true - # ... - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - // app/config/config_dev.php - $loader->import('config.php'); - - $container->loadFromExtension('web_profiler', array( - 'toolbar' => true, - - // ... - )); - -.. index:: - single: Entornos; Ejecutando diferentes entornos - -Ejecutando una aplicación en entornos diferentes ------------------------------------------------- - -Para ejecutar la aplicación en cada entorno, carga la aplicación usando como controlador frontal o bien :file:`app.php` (para el entorno ``prod``) o :file:`app_dev.php` (para el entorno ``dev``): - -.. code-block:: text - - http://localhost/app.php -> entorno *prod* - http://localhost/app_dev.php -> entorno *dev* - -.. note:: - - Las *URL* dadas asumen que tu servidor *web* está configurado para utilizar el directorio ``web/`` de la aplicación como su raíz. Lee más en :doc:`Instalando Symfony2`. - -Si abres uno de estos archivos, rápidamente verás que el entorno utilizado por cada uno se fija explícitamente: - -.. code-block:: php - :linenos: - - handle(Request::createFromGlobals())->send(); - -Como puedes ver, la clave ``prod`` especifica que este entorno se ejecutará en el entorno de ``producción``. Una aplicación *Symfony2* se puede ejecutar en cualquier entorno usando este código y simplemente cambiando la cadena de entorno. - -.. note:: - - El entorno ``test`` se utiliza al escribir las pruebas funcionales y no es accesible en el navegador directamente a través de un controlador frontal. En otras palabras, a diferencia de los otros entornos, no hay archivo controlador frontal :file:`app_test.php`. - -.. index:: - single: Configuración; Modo de depuración - -.. sidebar:: Modo de *depuración* - - Importante, pero irrelevante al tema de *entornos* es la clave ``false`` en la línea 8 del controlador frontal anterior. Esto especifica si o no la aplicación se debe ejecutar en «modo de depuración». Independientemente del entorno, una aplicación *Symfony2* se puede ejecutar con el modo de depuración establecido en ``true`` o ``false``. Esto afecta a muchas cosas en la aplicación, tal como cuando o no se deben mostrar los errores o si los archivos de caché se reconstruyen de forma dinámica en cada petición. Aunque no es un requisito, el modo de depuración generalmente se fija a ``true`` para los entornos ``dev`` y ``test`` y ``false`` para el entorno ``prod``. - - Internamente, el valor del modo de depuración viene a ser el parámetro ``kernel.debug`` utilizado en el interior del :doc:`contenedor de servicios `. - Si miras dentro del archivo de configuración de tu aplicación, puedes encontrar el parámetro utilizado, por ejemplo, para activar o desactivar la anotación cronológica de eventos cuando utilizas el *DBAL* de *Doctrine*: - - .. configuration-block:: - - .. code-block:: yaml - - doctrine: - dbal: - logging: "%kernel.debug%" - # ... - - .. code-block:: xml - - - - .. code-block:: php - - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'logging' => '%kernel.debug%', - - // ... - ), - // ... - )); - -.. index:: - single: Entornos; Creando un nuevo entorno - -Creando un nuevo entorno ------------------------- - -De forma predeterminada, una aplicación *Symfony2* tiene tres entornos que se encargan de la mayoría de los casos. Por supuesto, debido a que un entorno no es más que una cadena que corresponde a un conjunto de configuración, la creación de un nuevo entorno es muy fácil. - -Supongamos, por ejemplo, que antes de desplegarla, necesitas medir el rendimiento de tu aplicación. Una forma de medir el rendimiento de la aplicación es usando una configuración cercana a la de producción, pero con el ``web_profiler`` de *Symfony2* habilitado. Esto permite a *Symfony2* registrar información sobre tu aplicación durante la evaluación. - -La mejor manera de lograrlo es a través de un nuevo entorno llamado, por ejemplo, ``benchmark``. Comienza creando un nuevo archivo de configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_benchmark.yml - imports: - - { resource: config_prod.yml } - - framework: - profiler: { only_exceptions: false } - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - // app/config/config_benchmark.php - $loader->import('config_prod.php') - - $container->loadFromExtension('framework', array( - 'profiler' => array('only-exceptions' => false), - )); - -Y con esta simple adición, la aplicación ahora es compatible con un nuevo entorno llamado ``benchmark``. - -Este nuevo archivo de configuración importa la configuración del entorno ``prod`` y la modifica. Esto garantiza que el nuevo entorno es idéntico al entorno ``prod``, a excepción de los cambios echos explícitamente aquí. - -Debido a que deseas que este entorno sea accesible a través de un navegador, también debes crear un controlador frontal para el mismo. Copia el archivo ``web/app.php`` a ``web/app_benchmark.php`` y edita el entorno para que sea ``benchmark``: - -.. code-block:: php - - handle(Request::createFromGlobals())->send(); - -El nuevo entorno ahora es accesible a través de:: - - http://localhost/app_benchmark.php - -.. note:: - - Algunos entornos, como el entorno ``dev``, no están destinados a ser visitados en algún servidor empleado para el público en general. Esto se debe a que ciertos entornos, con fines de depuración, pueden dar demasiada información sobre la aplicación o infraestructura subyacente. Para estar seguros de que estos entornos no son accesibles, se suele proteger al controlador frontal de direcciones *IP* externas a través del siguiente código en la parte superior del controlador: - - .. code-block:: php - - if (!in_array(@$_SERVER['REMOTE_ADDR'], array('127.0.0.1', '::1'))) { - die('You are not allowed to access this file. Check '.basename(__FILE__).' for more information.'); - } - -.. index:: - single: Entornos; Directorio de caché - -Entornos y el directorio de caché ---------------------------------- - -*Symfony2* aprovecha la memorización en caché de muchas maneras: la configuración de la aplicación, la configuración de enrutado, las plantillas *Twig* y más, se memorizan como objetos *PHP* en archivos del sistema de archivos. - -Por omisión, estos archivos se memorizan principalmente en el directorio :file:`app/cache`. -Sin embargo, cada entorno memoriza su propio conjunto de archivos: - -.. code-block:: text - - app/cache/dev --- directorio caché para el entorno *dev* - app/cache/prod --- directorio caché para el entorno *prod* - -A veces, cuando depuramos, puede ser útil inspeccionar un archivo memorizado para entender cómo está funcionando algo. Al hacerlo, recuerda buscar en el directorio del entorno que estás utilizando (comúnmente ``dev`` mientras desarrollas y depuras). Aunque puede variar, el directorio ``app/cache/dev`` incluye lo siguiente: - -* :file:`appDevDebugProjectContainer.php` --- el «contenedor del servicio» memorizado que representa la configuración de la aplicación en caché; - -* :file:`appdevUrlGenerator.php` --- la clase *PHP* generada a partir de la configuración de enrutado y usada cuando genera las *URL*; - -* :file:`appdevUrlMatcher.php` --- la clase *PHP* usada para emparejar rutas --- busca aquí para ver la lógica de las expresiones regulares compiladas utilizadas para concordar las *URL* entrantes con diferentes rutas; - -* ``twig/`` --- este directorio contiene todas las plantillas *Twig* en caché. - -.. note:: - - Fácilmente puedes cambiar la ubicación y nombre del directorio. Para más información lee el artículo :doc:`/cookbook/configuration/override_dir_structure`. - - -Prosigue --------- - -Lee el artículo en :doc:`/cookbook/configuration/external_parameters`. diff --git a/_sources/cookbook/configuration/external_parameters.txt b/_sources/cookbook/configuration/external_parameters.txt deleted file mode 100644 index 2e60e15..0000000 --- a/_sources/cookbook/configuration/external_parameters.txt +++ /dev/null @@ -1,126 +0,0 @@ -.. index:: - single: Entornos; Parámetros externos - -Cómo configurar parámetros externos en el contenedor de servicios -================================================================= - -En el capítulo :doc:`/cookbook/configuration/environments`, aprendiste cómo gestionar la configuración de tu aplicación. A veces, puedes beneficiar a tu aplicación almacenando ciertas credenciales fuera del código de tu proyecto. La configuración de la base de datos es tal ejemplo. La flexibilidad del contenedor de servicios de *Symfony* te permite hacer esto fácilmente. - -Variables de entorno --------------------- - -*Symfony* grabará cualquier variable de entorno con el prefijo ``SYMFONY__`` y lo configurará como parámetro en el contenedor de servicios. Los dobles guiones bajos son reemplazados por un punto, ya que un punto no es un carácter válido en un nombre de variable de entorno. - -Por ejemplo, si estás usando *Apache*, las variables de entorno se pueden fijar usando la siguiente configuración de ``VirtualHost``: - -.. code-block:: apache - - - ServerName Symfony2 - DocumentRoot "/ruta/a/aplic_symfony_2/web" - DirectoryIndex index.php index.html - SetEnv SYMFONY__DATABASE__USER usuario - SetEnv SYMFONY__DATABASE__PASSWORD secreto - - - AllowOverride All - Allow from All - - - -.. note:: - - El ejemplo anterior es una configuración para *Apache*, con la directiva `SetEnv`_. Sin embargo, esta funcionará para cualquier servidor web compatible con la configuración de variables de entorno. - - Además, con el fin de que tu consola trabaje (la cual no utiliza *Apache*), las tienes que exportar como variables del intérprete. En un sistema Unix, puedes ejecutar las siguientes ordenes: - - .. code-block:: bash - - $ export SYMFONY__DATABASE__USER=usuario - $ export SYMFONY__DATABASE__PASSWORD=secreto - -Ahora que has declarado una variable de entorno, estará presente en la variable global ``$_SERVER`` de *PHP*. Entonces *Symfony* automáticamente fijará todas las variables ``$_SERVER`` con el prefijo ``SYMFONY__`` como parámetros en el contenedor de servicios. - -Ahora puedes referirte a estos parámetros donde los necesites. - -.. configuration-block:: - - .. code-block:: yaml - - doctrine: - dbal: - driver pdo_mysql - dbname: symfony2_project - user: "%database.user%" - password: "%database.password%" - - .. code-block:: xml - - - - - - - - - .. code-block:: php - - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'driver' => 'pdo_mysql', - 'dbname' => 'symfony2_project', - 'user' => '%database.user%', - 'password' => '%database.password%', - ) - )); - -Constantes ----------- - -El contenedor también cuenta con apoyo para fijar constantes *PHP* como parámetros. -See :ref:`component-di-parameters-constants` for more details. - -Otra configuración ------------------- - -La directiva ``imports`` se puede utilizar para extraer parámetros almacenados en otro lugar. -Importar un archivo *PHP* te da la flexibilidad de añadir al contenedor lo que sea necesario. La siguiente directiva importa un archivo llamado :file:`parameters.php`. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - imports: - - { resource: parameters.php } - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $loader->import('parameters.php'); - -.. note:: - - Un archivo de recursos puede tener uno de muchos tipos. Los recursos *PHP*, *XML*, *YAML*, *INI* y cierre son compatibles con la directiva ``imports``. - -En :file:`parameters.php`, dile al contenedor de servicios los parámetros que deseas configurar. Esto es útil cuando la configuración importante está en un formato no estándar. El siguiente ejemplo incluye la configuración de una base de datos *Drupal* en el contenedor de servicios de *Symfony*. - -.. code-block:: php - - // app/config/parameters.php - include_once('/ruta/a/drupal/sites/default/settings.php'); - $container->setParameter('drupal.database.url', $db_url); - -.. _`SetEnv`: http://httpd.apache.org/docs/current/env.html diff --git a/_sources/cookbook/configuration/front_controllers_and_kernel.txt b/_sources/cookbook/configuration/front_controllers_and_kernel.txt deleted file mode 100644 index 4a07b93..0000000 --- a/_sources/cookbook/configuration/front_controllers_and_kernel.txt +++ /dev/null @@ -1,171 +0,0 @@ -.. index:: - single: How front controller, ``AppKernel`` and environments - work together - -Understanding how the Front Controller, Kernel and Environments work together -============================================================================= - -The section :doc:`/cookbook/configuration/environments` explained the basics -on how Symfony uses environments to run your application with different configuration -settings. This section will explain a bit more in-depth what happens when -your application is bootstrapped. To hook into this process, you need to understand -three parts that work together: - -* `The Front Controller`_ -* `The Kernel Class`_ -* `The Environments`_ - -.. note:: - - Usually, you will not need to define your own front controller or - ``AppKernel`` class as the `Symfony2 Standard Edition`_ provides - sensible default implementations. - - This documentation section is provided to explain what is going on behind - the scenes. - -The Front Controller --------------------- - -The `front controller`_ is a well-known design pattern; it is a section of -code that *all* requests served by an application run through. - -In the `Symfony2 Standard Edition`_, this role is taken by the `app.php`_ -and `app_dev.php`_ files in the ``web/`` directory. These are the very -first PHP scripts executed when a request is processed. - -The main purpose of the front controller is to create an instance of the -``AppKernel`` (more on that in a second), make it handle the request -and return the resulting response to the browser. - -Because every request is routed through it, the front controller can be -used to perform global initializations prior to setting up the kernel or -to *`decorate`_* the kernel with additional features. Examples include: - -* Configuring the autoloader or adding additional autoloading mechanisms; -* Adding HTTP level caching by wrapping the kernel with an instance of - :ref:`AppCache`; -* Enabling the :doc:`/components/debug`. - -The front controller can be chosen by requesting URLs like: - -.. code-block:: text - - http://localhost/app_dev.php/some/path/... - -As you can see, this URL contains the PHP script to be used as the front -controller. You can use that to easily switch the front controller or use -a custom one by placing it in the ``web/`` directory (e.g. ``app_cache.php``). - -When using Apache and the `RewriteRule shipped with the Standard Edition`_, -you can omit the filename from the URL and the RewriteRule will use ``app.php`` -as the default one. - -.. note:: - - Pretty much every other web server should be able to achieve a - behavior similar to that of the RewriteRule described above. - Check your server documentation for details or see - :doc:`/cookbook/configuration/web_server_configuration`. - -.. note:: - - Make sure you appropriately secure your front controllers against unauthorized - access. For example, you don't want to make a debugging environment - available to arbitrary users in your production environment. - -Technically, the `app/console`_ script used when running Symfony on the command -line is also a front controller, only that is not used for web, but for command -line requests. - -The Kernel Class ----------------- - -The :class:`Symfony\\Component\\HttpKernel\\Kernel` is the core of -Symfony2. It is responsible for setting up all the bundles that make up -your application and providing them with the application's configuration. -It then creates the service container before serving requests in its -:method:`Symfony\\Component\\HttpKernel\\HttpKernelInterface::handle` -method. - -There are two methods declared in the -:class:`Symfony\\Component\\HttpKernel\\KernelInterface` that are -left unimplemented in :class:`Symfony\\Component\\HttpKernel\\Kernel` -and thus serve as `template methods`_: - -* :method:`Symfony\\Component\\HttpKernel\\KernelInterface::registerBundles`, - which must return an array of all bundles needed to run the - application; - -* :method:`Symfony\\Component\\HttpKernel\\KernelInterface::registerContainerConfiguration`, - which loads the application configuration. - -To fill these (small) blanks, your application needs to subclass the -Kernel and implement these methods. The resulting class is conventionally -called the ``AppKernel``. - -Again, the Symfony2 Standard Edition provides an `AppKernel`_ in the ``app/`` -directory. This class uses the name of the environment - which is passed to -the Kernel's :method:`constructor` -method and is available via :method:`Symfony\\Component\\HttpKernel\\Kernel::getEnvironment` - -to decide which bundles to create. The logic for that is in ``registerBundles()``, -a method meant to be extended by you when you start adding bundles to your -application. - -You are, of course, free to create your own, alternative or additional -``AppKernel`` variants. All you need is to adapt your (or add a new) front -controller to make use of the new kernel. - -.. note:: - - The name and location of the ``AppKernel`` is not fixed. When - putting multiple Kernels into a single application, - it might therefore make sense to add additional sub-directories, - for example ``app/admin/AdminKernel.php`` and - ``app/api/ApiKernel.php``. All that matters is that your front - controller is able to create an instance of the appropriate - kernel. - -Having different ``AppKernels`` might be useful to enable different front -controllers (on potentially different servers) to run parts of your application -independently (for example, the admin UI, the frontend UI and database migrations). - -.. note:: - - There's a lot more the ``AppKernel`` can be used for, for example - :doc:`overriding the default directory structure `. - But odds are high that you don't need to change things like this on the - fly by having several ``AppKernel`` implementations. - -The Environments ----------------- - -We just mentioned another method the ``AppKernel`` has to implement - -:method:`Symfony\\Component\\HttpKernel\\KernelInterface::registerContainerConfiguration`. -This method is responsible for loading the application's -configuration from the right *environment*. - -Environments have been covered extensively -:doc:`in the previous chapter`, -and you probably remember that the Standard Edition comes with three -of them - ``dev``, ``prod`` and ``test``. - -More technically, these names are nothing more than strings passed from the -front controller to the ``AppKernel``'s constructor. This name can then be -used in the :method:`Symfony\\Component\\HttpKernel\\KernelInterface::registerContainerConfiguration` -method to decide which configuration files to load. - -The Standard Edition's `AppKernel`_ class implements this method by simply -loading the ``app/config/config_*environment*.yml`` file. You are, of course, -free to implement this method differently if you need a more sophisticated -way of loading your configuration. - -.. _front controller: http://en.wikipedia.org/wiki/Front_Controller_pattern -.. _`edición estándar de Symfony2`: https://github.com/symfony/symfony-standard -.. _app.php: https://github.com/symfony/symfony-standard/blob/master/web/app.php -.. _app_dev.php: https://github.com/symfony/symfony-standard/blob/master/web/app_dev.php -.. _app/console: https://github.com/symfony/symfony-standard/blob/master/app/console -.. _AppKernel: https://github.com/symfony/symfony-standard/blob/master/app/AppKernel.php -.. _decorate: http://en.wikipedia.org/wiki/Decorator_pattern -.. _RewriteRule shipped with the Standard Edition: https://github.com/symfony/symfony-standard/blob/master/web/.htaccess) -.. _template methods: http://en.wikipedia.org/wiki/Template_method_pattern diff --git a/_sources/cookbook/configuration/index.txt b/_sources/cookbook/configuration/index.txt deleted file mode 100644 index 8e2e805..0000000 --- a/_sources/cookbook/configuration/index.txt +++ /dev/null @@ -1,13 +0,0 @@ -Configurando -============ - -.. toctree:: - :maxdepth: 2 - - environments - override_dir_structure - front_controllers_and_kernel - external_parameters - pdo_session_storage - apache_router - web_server_configuration diff --git a/_sources/cookbook/configuration/override_dir_structure.txt b/_sources/cookbook/configuration/override_dir_structure.txt deleted file mode 100644 index 9bac71d..0000000 --- a/_sources/cookbook/configuration/override_dir_structure.txt +++ /dev/null @@ -1,134 +0,0 @@ -.. index:: - single: Sustituyendo Symfony - -Cómo sustituir la estructura de directorios predeterminada de *Symfony* -======================================================================= - -Automáticamente *Symfony* viene con una estructura de directorios predefinida. Fácilmente puedes sustituir esta estructura de directorios para crear la tuya propia. La estructura de directorios predefinida es: - -.. code-block:: text - - app/ - cache/ - config/ - logs/ - ... - src/ - ... - vendor/ - ... - web/ - app.php - ... - -.. _override-cache-dir: - -Sustituyendo el directorio ``cache`` ------------------------------------- - -Puedes sustituir el directorio ``cache`` redefiniendo el método ``getCacheDir`` en la clase ``AppKernel`` de tu aplicación:: - - // app/AppKernel.php - - // ... - class AppKernel extends Kernel - { - // ... - - public function getCacheDir() - { - return $this->rootDir.'/'.$this->environment.'/cache'; - } - } - -``$this->rootDir`` es la ruta absoluta al directorio ``app`` y ``$this->environment`` -es el entorno actual (es decir, ``dev``). En este caso cambiaste la ubicación del directorio ``cache`` a ``app/{environment}/cache``. - -.. caution:: - - Tendrías que mantener un diferente directorio ``cache`` para cada entorno, de lo contrario puede ocurrir algún comportamiento inesperado. Cada entorno genera sus propios archivos de configuración almacenados en caché, y por lo tanto cada cual necesita su propio directorio para almacenar esos archivos en caché. - -.. _override-logs-dir: - -Sustituyendo el directorio ``logs`` ------------------------------------ - -Sustituir el directorio ``logs`` es igual que sustituir el directorio ``cache``, la única diferencia es que necesitas reemplazar el método ``getLogDir``:: - - // app/AppKernel.php - - // ... - class AppKernel extends Kernel - { - // ... - - public function getLogDir() - { - return $this->rootDir.'/'.$this->environment.'/logs'; - } - } - -Aquí cambiaste la ubicación del directorio a ``app/{environment}/logs``. - -Sustituyendo el directorio ``web`` ----------------------------------- - -Si necesitas rebautizar o mover tu directorio ``web``, lo único que necesitas es garantizar que la ruta al directorio ``app`` todavía es la correcta en tus controladores frontales :file:`app.php` y :file:`app_dev.php`. Si sencillamente rebautizas el directorio, está bien. Pero si lo mueves de alguna manera, necesitarás modificar las rutas dentro de esos archivos:: - - require_once __DIR__.'/../Symfony/app/bootstrap.php.cache'; - require_once __DIR__.'/../Symfony/app/AppKernel.php'; - -Since Symfony 2.1 (in which Composer is introduced), you also need to change -the ``extra.symfony-web-dir`` option in the ``composer.json`` file: - -.. code-block:: json - - { - ... - "extra": { - ... - "symfony-web-dir": "my_new_web_dir" - } - } - -.. tip:: - - Algunos servidores compartidos tienen un directorio *web* raíz :file:`public_html`. Al renombrar tu directorio *web* de :file:`web` a :file:`public_html` es una manera para hacer que tu proyecto *Symfony* trabaje en tu servidor compartido. Otra manera es desplegar tu aplicación en un directorio fuera de tu :file:`web` raíz, eliminar tu directorio :file:`public_html`, y luego reemplazarlo con un enlace simbólico al :file:`web` en tu proyecto. - -.. note:: - - Si utilizas el ``AsseticBundle`` necesitas configurar esto, para que este pueda utilizar el directorio :file:`web` correcto: - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - - # ... - assetic: - # ... - read_from: "%kernel.root_dir%/../../public_html" - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - - // ... - $container->loadFromExtension('assetic', array( - // ... - 'read_from' => '%kernel.root_dir%/../../public_html', - )); - - Ahora solo necesitas volcar tus activos de nuevo y tu aplicación debería trabajar: - - .. code-block:: bash - - $ php app/console assetic:dump --env=prod --no-debug diff --git a/_sources/cookbook/configuration/pdo_session_storage.txt b/_sources/cookbook/configuration/pdo_session_storage.txt deleted file mode 100644 index 4d652ae..0000000 --- a/_sources/cookbook/configuration/pdo_session_storage.txt +++ /dev/null @@ -1,199 +0,0 @@ -.. index:: - single: Sesión; Almacenamiento en la base de datos - -Cómo utilizar ``PdoSessionHandler`` para almacenar sesiones en la base de datos -=============================================================================== - -El almacenamiento de sesiones predeterminado de *Symfony2* escribe la información de la sesión en archivo(s). La mayoría desde medianos hasta grandes sitios web utilizan una base de datos para almacenar valores de sesión en lugar de archivos, porque las bases de datos son más fáciles de usar y escalar en un entorno web multiservidor. - -*Symfony2* ha incorporado una solución para el almacenamiento de la sesión en la base de datos denominada :class:`Symfony\\\Component\\HttpFoundation\\SessionStorage\\PdoSessionStorage`. -Para usarla, sólo tienes que cambiar algunos parámetros en :file:`config.yml` (o el formato de configuración de tu elección): - -.. versionadded:: 2.1 - En *Symfony 2.1* la clase y el espacio de nombres se han modificado significativamente. Ahora puedes encontrar las clases de almacenamiento de sesión en el espacio de nombres `Session\\Storage`: - ``Symfony\Component\HttpFoundation\Session\Storage``. Además ten en cuenta que en *Symfony 2.1* debes configurar ``handler_id`` no ``storage_id`` como en *Symfony2.0*. - Abajo, notarás que ya no se utiliza ``%sesión.storage.options%``. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - framework: - session: - # ... - handler_id: session.handler.pdo - - parameters: - pdo.db_options: - db_table: session - db_id_col: session_id - db_data_col: session_value - db_time_col: session_time - - services: - pdo: - class: PDO - arguments: - dsn: "mysql:dbname=mydatabase" - user: myuser - password: mypassword - - session.handler.pdo: - class: Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler - arguments: ["@pdo", "%pdo.db_options%"] - - .. code-block:: xml - - - - - - - - - session - session_id - session_value - session_time - - - - - - mysql:dbname=mydatabase - myuser - mypassword - - - - - %pdo.db_options% - - - - .. code-block:: php - - // app/config/config.php - use Symfony\Component\DependencyInjection\Definition; - use Symfony\Component\DependencyInjection\Reference; - - $container->loadFromExtension('framework', array( - ..., - 'session' => array( - // ..., - 'handler_id' => 'session.handler.pdo', - ), - )); - - $container->setParameter('pdo.db_options', array( - 'db_table' => 'session', - 'db_id_col' => 'session_id', - 'db_data_col' => 'session_value', - 'db_time_col' => 'session_time', - )); - - $pdoDefinition = new Definition('PDO', array( - 'mysql:dbname=mydatabase', - 'myuser', - 'mypassword', - )); - $container->setDefinition('pdo', $pdoDefinition); - - $storageDefinition = new Definition('Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler', array( - new Reference('pdo'), - '%pdo.db_options%', - )); - $container->setDefinition('session.handler.pdo', $storageDefinition); - -* ``db_table``: El nombre de la tabla de sesiones en tu base de datos -* ``db_id_col``: El nombre de la columna ``id`` en la tabla de sesiones (``VARCHAR (255)`` o más grande) -* ``db_data_col``: El nombre de la columna de valores en tu tabla de sesiones (``TEXT`` o ``CLOB``) -* ``db_time_col``: El nombre de la columna de tiempo en tu tabla de sesiones (``INTEGER``) - -Compartiendo información de conexión a tu base de datos -------------------------------------------------------- - -Con la configuración dada, la configuración de conexión de la base de datos únicamente se define para la conexión de almacenamiento de sesión. Esto está bien cuando utilizas una base de datos para los datos de sesión. - -Pero si deseas almacenar los datos de sesión en la misma base que el resto de los datos de tu proyecto, puedes utilizar la configuración de conexión de :file:`parameters.yml` refiriendo los parámetros relacionados con la base de datos definidos allí: - -.. configuration-block:: - - .. code-block:: yaml - - pdo: - class: PDO - arguments: - - "mysql:host=%database_host%;port=%database_port%;dbname=%database_name%" - - "%database_user%" - - "%database_password%" - - .. code-block:: xml - - - mysql:host=%database_host%;port=%database_port%;dbname=%database_name% - %database_user% - %database_password% - - - .. code-block:: php - - $pdoDefinition = new Definition('PDO', array( - 'mysql:host=%database_host%;port=%database_port%;dbname=%database_name%', - '%database_user%', - '%database_password%', - )); - -Instrucciones *SQL* de ejemplo ------------------------------- - -*MySQL* -~~~~~~~ - -La declaración *SQL* necesaria para crear la tabla en la base de datos podría ser similar a la siguiente (*MySQL*): - -.. code-block:: sql - - CREATE TABLE `session` ( - `session_id` varchar(255) NOT NULL, - `session_value` text NOT NULL, - `session_time` int(11) NOT NULL, - PRIMARY KEY (`session_id`) - ) ENGINE=InnoDB DEFAULT CHARSET=utf8; - -*PostgreSQL* -~~~~~~~~~~~~ - -Para *PostgreSQL*, la declaración debe tener este aspecto: - -.. code-block:: sql - - CREATE TABLE session ( - session_id character varying(255) NOT NULL, - session_value text NOT NULL, - session_time integer NOT NULL, - CONSTRAINT session_pkey PRIMARY KEY (session_id) - ); - -«Microsoft SQL Server» -~~~~~~~~~~~~~~~~~~~~~~ - -Para *MSSQL*, la declaración se podría parecer a la siguiente: - -.. code-block:: sql - - CREATE TABLE [dbo].[session]( - [session_id] [nvarchar](255) NOT NULL, - [session_value] [ntext] NOT NULL, - [session_time] [int] NOT NULL, - PRIMARY KEY CLUSTERED( - [session_id] ASC - ) WITH ( - PAD_INDEX = OFF, - STATISTICS_NORECOMPUTE = OFF, - IGNORE_DUP_KEY = OFF, - ALLOW_ROW_LOCKS = ON, - ALLOW_PAGE_LOCKS = ON - ) ON [PRIMARY] - ) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY] diff --git a/_sources/cookbook/configuration/web_server_configuration.txt b/_sources/cookbook/configuration/web_server_configuration.txt deleted file mode 100644 index b498d15..0000000 --- a/_sources/cookbook/configuration/web_server_configuration.txt +++ /dev/null @@ -1,92 +0,0 @@ -.. index:: - single: Web Server - -Configuring a web server -======================== - -The web directory is the home of all of your application's public and static -files. Including images, stylesheets and JavaScript files. It is also where the -front controllers live. For more details, see the :ref:`the-web-directory`. - -The web directory services as the document root when configuring your web -server. In the examples below, this directory is in ``/var/www/project/web/``. - -Apache2 -------- - -For advanced Apache configuration options, see the official `Apache`_ -documentation. The minimum basics to get your application running under Apache2 -are: - -.. code-block:: apache - - - ServerName www.domain.tld - - DocumentRoot /var/www/project/web - - # enable the .htaccess rewrites - AllowOverride All - Order allow,deny - Allow from All - - - ErrorLog /var/log/apache2/project_error.log - CustomLog /var/log/apache2/project_access.log combined - - -.. note:: - - For performance reasons, you will probably want to set - ``AllowOverride None`` and implement the rewrite rules in the ``web/.htaccess`` - into the virtualhost config. - -Nginx ------ - -For advanced Nginx configuration options, see the official `Nginx`_ -documentation. The minimum basics to get your application running under Nginx -are: - -.. code-block:: nginx - - server { - server_name www.domain.tld; - root /var/www/project/web; - - location / { - # try to serve file directly, fallback to rewrite - try_files $uri @rewriteapp; - } - - location @rewriteapp { - # rewrite all to app.php - rewrite ^(.*)$ /app.php/$1 last; - } - - location ~ ^/(app|app_dev)\.php(/|$) { - fastcgi_pass unix:/var/run/php5-fpm.sock; - fastcgi_split_path_info ^(.+\.php)(/.*)$; - include fastcgi_params; - fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; - fastcgi_param HTTPS off; - } - - error_log /var/log/nginx/project_error.log; - access_log /var/log/nginx/project_access.log; - } - -.. note:: - - Depending on your PHP-FPM config, the ``fastcgi_pass`` can also be - ``fastcgi_pass 127.0.0.1:9000``. - -.. tip:: - - This executes **only** ``app.php`` and ``app_dev.php`` in the web directory. - All other files will be served as text. If you have other PHP files in - your web directory, be sure to include them in the ``location`` block - above. - -.. _`Apache`: http://httpd.apache.org/docs/current/mod/core.html#documentroot -.. _`Nginx`: http://wiki.nginx.org/Symfony diff --git a/_sources/cookbook/console/console_command.txt b/_sources/cookbook/console/console_command.txt deleted file mode 100644 index 1788bfd..0000000 --- a/_sources/cookbook/console/console_command.txt +++ /dev/null @@ -1,127 +0,0 @@ -.. index:: - single: Console; Creando ordenes - -Cómo crear una orden de consola -=============================== - -La página ``Console`` de la sección de componentes (:doc:`/components/console/introduction`) trata sobre cómo crear una orden de Consola. Este artículo trata sobre las diferencias cuando creas ordenes de consola en la plataforma *Symfony2*. - -Registrando ordenes automáticamente ------------------------------------ - -Para hacer que las ordenes de consola estén disponibles automáticamente en *Symfony2*, crea un directorio ``Command`` dentro de tu paquete y crea un archivo *PHP* con el sufijo :file:`Command.php` para cada orden que deses proveer. Por ejemplo, si deseas ampliar el ``AcmeDemoBundle`` (disponible en la *edición estándar de Symfony*) para darte la bienvenida desde la línea de ordenes, crea el archivo :file:`GreetCommand.php` y agrégale lo siguiente:: - - // src/Acme/DemoBundle/Command/GreetCommand.php - namespace Acme\DemoBundle\Command; - - use Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand; - use Symfony\Component\Console\Input\InputArgument; - use Symfony\Component\Console\Input\InputInterface; - use Symfony\Component\Console\Input\InputOption; - use Symfony\Component\Console\Output\OutputInterface; - - class GreetCommand extends ContainerAwareCommand - { - protected function configure() - { - $this - ->setName('demo:greet') - ->setDescription('Greet someone') - ->addArgument('name', InputArgument::OPTIONAL, 'Who do you want to greet?') - ->addOption('yell', null, InputOption::VALUE_NONE, 'If set, the task will yell in uppercase letters') - ; - } - - protected function execute(InputInterface $input, OutputInterface $output) - { - $name = $input->getArgument('name'); - if ($name) { - $text = 'Hello '.$name; - } else { - $text = 'Hello'; - } - - if ($input->getOption('yell')) { - $text = strtoupper($text); - } - - $output->writeln($text); - } - } - -Ahora, automáticamente, esta orden estará disponible para funcionar: - -.. code-block:: bash - - $ app/console demo:greet Fabien - -Obteniendo servicios del contenedor de servicios ------------------------------------------------- - -Al usar :class:`Symfony\\Bundle\\FrameworkBundle\\Command\\ContainerAwareCommand` como la clase base para la orden (en lugar de la clase más básica :class:`Symfony\\Component\\Console\\Command\\Command`), tienes acceso al contenedor de servicios. En otras palabras, tienes acceso a cualquier servicio configurado. -Por ejemplo, fácilmente podrías extender la tarea para que sea traducible:: - - protected function execute(InputInterface $input, OutputInterface $output) - { - $name = $input->getArgument('name'); - $translator = $this->getContainer()->get('translator'); - if ($name) { - $output->writeln($translator->trans('Hello %name%!', array('%name%' => $name))); - } else { - $output->writeln($translator->trans('Hello!')); - } - } - -Probando ordenes ----------------- - -Cuando pruebes ordenes utilizadas como parte de la plataforma completa debes utilizar la :class:`Symfony\\Bundle\\FrameworkBundle\\Console\\Application` en lugar de :class:`Symfony\\Component\\Console\\Application`:: - - use Symfony\Component\Console\Tester\CommandTester; - use Symfony\Bundle\FrameworkBundle\Console\Application; - use Acme\DemoBundle\Command\GreetCommand; - - class ListCommandTest extends \PHPUnit_Framework_TestCase - { - public function testExecute() - { - // simula el Kernel o crea uno dependiendo de tus necesidades - $application = new Application($kernel); - $application->add(new GreetCommand()); - - $command = $application->find('demo:greet'); - $commandTester = new CommandTester($command); - $commandTester->execute(array('command' => $command->getName())); - - $this->assertRegExp('/.../', $commandTester->getDisplay()); - - // ... - } - } - -Para poder utilizar plenamente el contenedor del servicios configurado en tus pruebas de consola puedes extender tu prueba de :class:`Symfony\\Bundle\\FrameworkBundle\\Test\\WebTestCase`:: - - use Symfony\Component\Console\Tester\CommandTester; - use Symfony\Bundle\FrameworkBundle\Console\Application; - use Symfony\Bundle\FrameworkBundle\Test\WebTestCase; - use Acme\DemoBundle\Command\GreetCommand; - - class ListCommandTest extends WebTestCase - { - public function testExecute() - { - $kernel = $this->createKernel(); - $kernel->boot(); - - $application = new Application($kernel); - $application->add(new GreetCommand()); - - $command = $application->find('demo:greet'); - $commandTester = new CommandTester($command); - $commandTester->execute(array('command' => $command->getName())); - - $this->assertRegExp('/.../', $commandTester->getDisplay()); - - // ... - } - } diff --git a/_sources/cookbook/console/index.txt b/_sources/cookbook/console/index.txt deleted file mode 100644 index 3298093..0000000 --- a/_sources/cookbook/console/index.txt +++ /dev/null @@ -1,10 +0,0 @@ -Consola -======= - -.. toctree:: - :maxdepth: 2 - - console_command - usage - sending_emails - logging diff --git a/_sources/cookbook/console/logging.txt b/_sources/cookbook/console/logging.txt deleted file mode 100644 index f4f571c..0000000 --- a/_sources/cookbook/console/logging.txt +++ /dev/null @@ -1,228 +0,0 @@ -.. index:: - single: Console; Habilitando el registro cronológico - -Cómo habilitar el registro cronológico en la consola de ordenes -=============================================================== - -El componente ``Console`` no proporciona la capacidad de registro cronológico fuera de la caja. -Normalmente, ejecutas manualmente las ordenes de la consola y observas el resultado, motivo por el cual no se proporciona el registro cronológico. Sin embargo, hay casos en los que puedes necesitar el registro. Por ejemplo, si estás ejecutando ordenes de consola desatendidas, tal como trabajos programados o guiones de despliegue, posiblemente sea más fácil usar las capacidades de registro de *Symfony* en lugar de configurar otras herramientas para reunir el resultado de la consola y procesarlo. Esto puede ser especialmente útil si ya tienes alguna configuración existente para agregar y analizar los registros de *Symfony*. - -Básicamente, hay dos casos de registro que puedes necesitar: - * El registo manual de cierta información de tu orden; - * El registro de excepciones no capturadas. - -Registrando manualmente una orden de consola --------------------------------------------- - -Esto es realmente sencillo. Cuando creas una orden de consola en la plataforma completa, como se describe en «:doc:`/cookbook/console/console_command`», tu orden extiende a :class:`Symfony\\Bundle\\FrameworkBundle\\Command\\ContainerAwareCommand`. -Esto significa que sólo tienes que acceder al servicio de registro estándar a través del contenedor y usarlo para hacer el registro:: - - // src/Acme/DemoBundle/Command/GreetCommand.php - namespace Acme\DemoBundle\Command; - - use Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand; - use Symfony\Component\Console\Input\InputArgument; - use Symfony\Component\Console\Input\InputInterface; - use Symfony\Component\Console\Input\InputOption; - use Symfony\Component\Console\Output\OutputInterface; - use Symfony\Component\HttpKernel\Log\LoggerInterface; - - class GreetCommand extends ContainerAwareCommand - { - // ... - - protected function execute(InputInterface $input, OutputInterface $output) - { - /** @var $logger LoggerInterface */ - $logger = $this->getContainer()->get('logger'); - - $name = $input->getArgument('name'); - if ($name) { - $text = 'Hello '.$name; - } else { - $text = 'Hello'; - } - - if ($input->getOption('yell')) { - $text = strtoupper($text); - $logger->warn('Yelled: '.$text); - } - else { - $logger->info('Greeted: '.$text); - } - - $output->writeln($text); - } - } - -Dependiendo del entorno en el que se ejecuta la orden (y tu configuración de registro cronológico), deberías ver las entradas registradas en :file:`app/logs/dev.log` o :file:`app/logs/prod.log`. - -Habilitando el registro automático de excepciones -------------------------------------------------- - -Para que tu aplicación de consola automáticamente registre las excepciones no capturadas para todas tus órdenes, tendrás que hacer un poco más de trabajo. - -En primer lugar, crea una nueva subclase de :class:`Symfony\\Bundle\\FrameworkBundle\\Console\\Application` y reemplaza su método :method:`Symfony\\Bundle\\FrameworkBundle\\Console\\Application::run`, donde debe suceder el manejo de las excepciones: - -.. caution:: - - Debido a la naturaleza de la clase :class:`Symfony\\Component\\Console\\Application` del núcleo, gran parte del método :method:`run` se tiene que duplicar e incluso reimplementar la propiedad privada ``originalAutoExit``. Esto sirve como ejemplo de lo que *podrías* hacer en tu código, aunque hay un muy alto riesgo de que algo se pueda romper al actualizar a las futuras versiones de *Symfony*. - - -.. code-block:: php - - // src/Acme/DemoBundle/Console/Application.php - namespace Acme\DemoBundle\Console; - - use Symfony\Bundle\FrameworkBundle\Console\Application as BaseApplication; - use Symfony\Component\Console\Input\InputInterface; - use Symfony\Component\Console\Output\OutputInterface; - use Symfony\Component\Console\Output\ConsoleOutputInterface; - use Symfony\Component\HttpKernel\Log\LoggerInterface; - use Symfony\Component\HttpKernel\KernelInterface; - use Symfony\Component\Console\Output\ConsoleOutput; - use Symfony\Component\Console\Input\ArgvInput; - - class Application extends BaseApplication - { - private $originalAutoExit; - - public function __construct(KernelInterface $kernel) - { - parent::__construct($kernel); - $this->originalAutoExit = true; - } - - /** - * Ejecuta la aplicación actual. - * - * @param InputInterface $input un ejemplar de entrada - * @param OutputInterface $output un ejemplar de salida - * - * @return integer 0 si todo salió bien, o un código de error - * - * @throws \Exception cuándo run devuelva una Excepción - * - * @api - */ - public function run(InputInterface $input = null, OutputInterface $output = null) - { - // hace que el padre lance excepciones, para que las puedas registrar - $this->setCatchExceptions(false); - - if (null === $input) { - $input = new ArgvInput(); - } - - if (null === $output) { - $output = new ConsoleOutput(); - } - - try { - $statusCode = parent::run($input, $output); - } catch (\Exception $e) { - - /** @var $logger LoggerInterface */ - $logger = $this->getKernel()->getContainer()->get('logger'); - - $message = sprintf( - '%s: %s (uncaught exception) at %s line %s while running console command `%s`', - get_class($e), - $e->getMessage(), - $e->getFile(), - $e->getLine(), - $this->getCommandName($input) - ); - $logger->crit($message); - - if ($output instanceof ConsoleOutputInterface) { - $this->renderException($e, $output->getErrorOutput()); - } else { - $this->renderException($e, $output); - } - $statusCode = $e->getCode(); - - $statusCode = is_numeric($statusCode) && $statusCode ? $statusCode : 1; - } - - if ($this->originalAutoExit) { - if ($statusCode > 255) { - $statusCode = 255; - } - // @codeCoverageIgnoreStart - exit($statusCode); - // @codeCoverageIgnoreEnd - } - - return $statusCode; - } - - public function setAutoExit($bool) - { - // la propiedad parent es privada, por lo que es necesario - // interceptarla en un definidor - $this->originalAutoExit = (Boolean) $bool; - parent::setAutoExit($bool); - } - - } - -En el código anterior, desactivaste la captura de excepciones para que el padre lance el método ``run`` en todas las excepciones. Cuando se detecta una excepción, simplemente la registras accediendo al servicio ``logger`` del contenedor de servicios y luego manejas el resto de la lógica de la misma manera que lo hace el método ``run`` del padre (específicamente, debido a que el método :method:`run` del padre no se encargará de la representación y manipulación del código de estado de las excepciones cuando ``catchExceptions`` se establezca en false, esto se tiene que hacer en el método redefinido). - -Para que trabaje correctamente la clase aplicación extendida con la consola en modo de intérprete, tienes que hacer un pequeño truco para interceptar el definidor ``autoExit`` y almacenar el valor en una propiedad diferente, ya que la propiedad del padre es privada. - -Ahora, para poder utilizar tu clase ``Aplicación`` extendida es necesario ajustar el guión :file:`app/console` para utilizar la nueva clase en lugar de la predeterminada:: - - // app/console - - // ... - // reemplaza la siguiente línea: - // use Symfony\Bundle\FrameworkBundle\Console\Application; - use Acme\DemoBundle\Console\Application; - - // ... - -¡Eso es todo! Gracias al cargador automático, ahora puedes utilizar tu clase en lugar de la original. - -Registrando estados de salida distintos de 0 --------------------------------------------- - -Las capacidades de registro de la consola se pueden ampliar aún más registrando estados de salida distintos de 0. De esta manera sabrás si alguna orden tuvo algún error, incluso si no se lanzaron excepciones. - -Con el fin de hacerlo, tendrás que modificar el método ``run()`` de tu clase ``Aplicación`` extendida de la siguiente manera:: - - public function run(InputInterface $input = null, - OutputInterface $output = null) - { - // hace que el padre lance excepciones, para que las puedas registrar - $this->setCatchExceptions(false); - - // almacena el valor de autoExit antes de - // restablecerlo - lo necesitarás más adelante - $autoExit = $this->originalAutoExit; - $this->setAutoExit(false); - - // ... - - if ($autoExit) { - if ($statusCode > 255) { - $statusCode = 255; - } - - // registra códigos de salida distintos de 0 junto - // con el nombre de la orden - if ($statusCode !== 0) { - /** @var $logger LoggerInterface */ - $logger = $this->getKernel()->getContainer()->get('logger'); - $logger->warn(sprintf('Command `%s` exited with status code %d', - $this->getCommandName($input), - $statusCode)); - } - - // @codeCoverageIgnoreStart - exit($statusCode); - // @codeCoverageIgnoreEnd - } - - return $statusCode; - } diff --git a/_sources/cookbook/console/sending_emails.txt b/_sources/cookbook/console/sending_emails.txt deleted file mode 100644 index 3df7395..0000000 --- a/_sources/cookbook/console/sending_emails.txt +++ /dev/null @@ -1,101 +0,0 @@ -.. index:: - single: Console; Enviando mensajes de correo electrónico - single: Console; Generando URL - -Cómo generar *URL* y enviar mensajes de correo electrónico desde la consola -=========================================================================== - -Desafortunadamente, el contexto de la línea de ordenes no sabe nada de tu servidor virtual o nombre de dominio. Esto significa que si generas *URL* absolutas dentro de una orden de consola, probablemente terminarás con algo inútil similar a ``http://localhost/foo/bar``. - -Para solucionar este problema, necesitas configurar el «contexto de la petición», que es una caprichosa manera de decir que necesitas configurar el entorno para que sepa qué *URL* debe utilizar al generar direcciones *URL*. - -Hay dos maneras de configurar el contexto de la petición: a nivel de aplicación y por orden. - -Configurando el contexto de la petición a nivel global ------------------------------------------------------- - - -.. versionadded:: 2.1 - Los parámetros ``host`` y ``scheme`` están disponibles a partir de *Symfony 2.1* - -.. versionadded:: 2.2 - El parámetro ``base_url`` está disponible desde *Symfony 2.2* - -Para configurar el contexto de la petición ---el cual utiliza el generador de *URL*--- puedes redefinir los parámetros que utiliza como valores predefinidos para cambiar el servidor (``localhost``) y esquema (``http``) predeterminado. A partir de *Symfony 2.2* también puedes configurar la ruta base siempre y cuando *Symfony* no se esté ejecutando en el directorio raíz. - -Ten en cuenta que esto no impacta directamente en las *URL* generadas a través de peticiones web normales, ya que se sustituyen los valores predeterminados. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/parameters.yml - parameters: - router.request_context.host: example.org - router.request_context.scheme: https - router.request_context.base_url: my/path - - .. code-block:: xml - - - - - - - - example.org - https - my/path - - - - .. code-block:: php - - // app/config/config_test.php - $container->setParameter('router.request_context.host', 'example.org'); - $container->setParameter('router.request_context.scheme', 'https'); - $container->setParameter('router.request_context.base_url', 'my/path'); - -Configurando el contexto de la petición por orden -------------------------------------------------- - -Para cambiarlo sólo en una orden sencillamente puede recuperar el contexto del servicio de la petición y sustituir sus opciones:: - - // src/Acme/DemoBundle/Command/DemoCommand.php - - // ... - class DemoCommand extends ContainerAwareCommand - { - protected function execute(InputInterface $input, OutputInterface $output) - { - $context = $this->getContainer()->get('router')->getContext(); - $context->setHost('example.com'); - $context->setScheme('https'); - $context->setBaseUrl('my/path'); - - // ... tu código aquí - } - } - -Con cola de memoria -------------------- - -El envío de mensajes de correo electrónico en una orden de consola funciona de la misma manera descrita en el artículo :doc:`/cookbook/email/email` del recetario, salvo que esta utiliza memoria de la cola de impresión. - -Cuando se utiliza memoria de la cola (consulta el :doc:`/cookbook/email/spool` del recetario para más información), debes tener en cuenta que debido a la forma en que *Symfony* se maneja de consola de ordenes, los mensajes de correo electrónico no se envían automáticamente. Debes tener cuidado de vaciar tú mismo la cola. Utiliza el siguiente código para enviar mensajes de correo electrónico dentro de tu orden de consola:: - - $container = $this->getContainer(); - $mailer = $container->get('mailer'); - $spool = $mailer->getTransport()->getSpool(); - $transport = $container->get('swiftmailer.transport.real'); - - $spool->flushQueue($transport); - -Otra opción es crear un ambiente que sólo sea utilizado por esa orden de consola y utilizar un método diferente en la cola de impresión. - -.. note:: - - Sólo es necesario tener cuidado de la cola de impresión cuando se utiliza memoria de la cola de impresión. - Si estás utilizando un archivo para la cola (o no utilizas la cola de impresión), no es necesario vaciar manualmente la cola dentro de la orden. - diff --git a/_sources/cookbook/console/usage.txt b/_sources/cookbook/console/usage.txt deleted file mode 100644 index 900abc2..0000000 --- a/_sources/cookbook/console/usage.txt +++ /dev/null @@ -1,52 +0,0 @@ -.. index:: - single: Console; Usando - -Cómo usar la consola -==================== - -La página :doc:`/components/console/usage` de la documentación de los componentes en las opciones globales de la consola. Cuándo utilizas la consola como parte de la pila completa de la plataforma, también dispones de algunas opciones globales adicionales. - -De manera predeterminada, las ordenes de la consola se ejecutan en el entorno ``dev`` y posiblemente lo quieras cambiar en algunas órdenes. Por ejemplo, posiblemente quieras ejecutar algunas órdenes en el entorno ``prod`` por razones de rendimiento. Además, el resultado de algunas órdenes será diferente dependiendo del entorno. Por ejemplo, la orden ``cache:clear`` limpiará y preparará la caché sólo para el entorno especificado. Para limpiar y preparar la caché del entorno ``prod`` debes ejecutar: - -.. code-block:: bash - - $ php app/console cache:clear --env=prod - -o la equivalente: - -.. code-block:: bash - - $ php app/console cache:clear -e=prod - -Además de cambiar el entorno, también puedes elegir desactivar el modo de depuración. -Esto puede ser útil cuándo quieras ejecutar órdenes en el entorno ``dev`` pero evitando el impacto negativo en el rendimiento por la recolección de datos para depuración: - -.. code-block:: bash - - $ php app/console list --no-debug - -hay un intérprete interactivo que te permite introducir órdenes sin tener que especificar cada vez ``php app/console``, el cual es útil si necesitas ejecutar varias órdenes. Para entrar al intérprete ejecuta: - -.. code-block:: bash - - $ php app/console --shell - $ php app/console -s - -Ahora puedes ejecutar órdenes sólo con el nombre de la orden: - -.. code-block:: bash - - Symfony > list - -Cuándo utilizas el intérprete puedes elegir ejecutar cada orden en un proceso separado: - -.. code-block:: bash - - $ php app/console --shell --process-isolation - $ php app/console -s --process-isolation - -Cuándo lo haces, la producción no será coloreada y no cuentas con apoyo para la interactividad por lo tanto necesitarás pasar todos los argumentos para las ordenes explícitamente. - -.. note:: - - A no ser que estés usando procesos separados, limpiar la caché en el intérprete no tendrá efecto en las subsecuentes ordenes que ejecutes. Esto se debe a que todavía se están utilizando los archivos memorizados originalmente. \ No newline at end of file diff --git a/_sources/cookbook/controller/error_pages.txt b/_sources/cookbook/controller/error_pages.txt deleted file mode 100644 index b5a147b..0000000 --- a/_sources/cookbook/controller/error_pages.txt +++ /dev/null @@ -1,70 +0,0 @@ -.. index:: - single: Controlador; Personalizando páginas de error - single: Páginas de error - -Cómo personalizar páginas de error -================================== - -Cuando se lanza alguna excepción en *Symfony2*, la excepción es capturada dentro de la clase del ``núcleo`` y, finalmente, remitida a un controlador especial, ``TwigBundle:Exception:show`` para procesarla. Este controlador, el cual vive dentro del núcleo de ``TwigBundle``, determina cual plantilla de error mostrar y el código de estado que se debe establecer para la excepción dada. - -Puedes personalizar las páginas de error de dos formas diferentes, dependiendo de la cantidad de control que necesites: - -1. Personalizando las plantillas de error de las diferentes páginas de error (se explica más adelante); - -2. Reemplazando el controlador de excepciones ``TwigBundle::Exception:show`` predeterminado con tu propio controlador y procesándolo como quieras (consulta :ref:`exception_controller en la referencia de Twig `); - -.. tip:: - - Personalizar el tratamiento de las excepciones en realidad es mucho más poderoso que lo escrito aquí. Produce un evento interno, ``core.exception``, el cual te permite completo control sobre el manejo de la excepción. Para más información, consulta el :ref:`kernel-kernel.exception`. - -Todas las plantillas de error viven dentro de ``TwigBundle``. Para sustituir las plantillas, simplemente confiamos en el método estándar para reemplazar las plantillas que viven dentro de un paquete. Para más información, consulta :ref:`overriding-bundle-templates`. - -Por ejemplo, para sustituir la plantilla de error predeterminada mostrada al usuario final, crea una nueva plantilla ubicada en ``app/Resources/TwigBundle/views/Exception/error.html.twig``: - -.. code-block:: html+jinja - - - - - - An Error Occurred: {{ status_text }} - - -

    Oops! An Error Occurred

    -

    The server returned a "{{ status_code }} {{ status_text }}".

    - - - -.. caution:: - - **No debes** utilizar ``is_granted`` en tus páginas de error (o diseños utilizados por tus páginas de error), porque el enrutador se ejecuta antes del cortafuegos. Si el enrutador lanza una excepción (por ejemplo, cuándo la ruta no coincide), entonces utilizar ``is_granted`` desencadenará una nueva excepción. You - can use ``is_granted`` safely by saying ``{% if app.user and is_granted('...') %}``. - -.. tip:: - - Si no estás familiarizado con *Twig*, no te preocupes. *Twig* es un sencillo, potente y opcional motor de plantillas que se integra con *Symfony2*. Para más información sobre *Twig* consulta :doc:`/book/templating`. - -Además de la página de error *HTML* estándar, *Symfony* proporciona una página de error predeterminada para muchos de los más comunes formatos de respuesta, como *JSON* (``error.json.twig``), *XML* (``error.xml.twig``) e incluso *Javascript* (``error.js.twig``), sólo por nombrar algunos. Para sustituir cualquiera de estas plantillas, basta con crear un nuevo archivo con el mismo nombre en el directorio ``app/Resources/TwigBundle/views/Exception``. Esta es la manera estándar de sustituir cualquier plantilla que viva dentro de un paquete. - -.. _cookbook-error-pages-by-status-code: - -Personalizando la página 404 y otras páginas de error ------------------------------------------------------ - -También puedes personalizar plantillas de error específicas de acuerdo con el código de estado *HTTP*. Por ejemplo, crea una plantilla ``app/Resources/TwigBundle/views/Exception/error404.html.twig`` para mostrar una página especial para los errores 404 (página no encontrada). - -*Symfony* utiliza el siguiente algoritmo para determinar qué plantilla utilizar: - -* En primer lugar, busca una plantilla para el formato dado y el código de estado (como ``error404.json.twig``); - -* Si no existe, busca una plantilla para el formato propuesto (como ``error.json.twig``); - -* Si no existe, este cae de nuevo a la plantilla *HTML* (como ``error.html.twig``). - -.. tip:: - - Para ver la lista completa de plantillas de error predeterminadas, revisa el directorio ``Resources/views/Exception`` de ``TwigBundle``. En una instalación estándar de *Symfony2*, el ``TwigBundle`` se puede encontrar en ``vendor/symfony/symfony/src/Symfony/Bundle/TwigBundle``. A menudo, la forma más fácil de personalizar una página de error es copiarla de ``TwigBundle`` a ``app/Resources/TwigBundle/views/Exception`` y luego modificarla. - -.. note:: - - El amigable depurador de páginas de excepción muestra al desarrollador cómo, incluso, puede personalizar de la misma manera creando plantillas como ``exception.html.twig`` para la página de excepción *HTML* estándar o ``exception.json.twig`` para la página de excepción *JSON*. diff --git a/_sources/cookbook/controller/index.txt b/_sources/cookbook/controller/index.txt deleted file mode 100644 index 85bd4cf..0000000 --- a/_sources/cookbook/controller/index.txt +++ /dev/null @@ -1,8 +0,0 @@ -Controlador -=========== - -.. toctree:: - :maxdepth: 2 - - error_pages - service diff --git a/_sources/cookbook/controller/service.txt b/_sources/cookbook/controller/service.txt deleted file mode 100644 index 92da95d..0000000 --- a/_sources/cookbook/controller/service.txt +++ /dev/null @@ -1,43 +0,0 @@ -.. index:: - single: Controlador; Como servicio - -Cómo definir controladores como servicios -========================================= - -En el libro, has aprendido lo fácilmente que puedes utilizar un controlador cuando extiende la clase base :class:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller`. Si bien esto funciona estupendamente, los controladores también se pueden especificar como servicios. - -Para referir un controlador que se defina como servicio, utiliza la notación de dos puntos individuales (:). Por ejemplo, supongamos que has definido un servicio llamado ``my_controller`` y ---dentro del servicio--- lo quieres redirigir a un método llamado ``indexAction()``:: - - $this->forward('my_controller:indexAction', array('foo' => $bar)); - -Necesitas usar la misma notación para definir el valor ``_controller`` de la ruta: - -.. code-block:: yaml - - my_controller: - path: / - defaults: { _controller: my_controller:indexAction } - -Para utilizar un controlador de esta manera, este se debe definir en la configuración del contenedor de servicios. Para más información, consulta el capítulo :doc:`Contenedor de servicios `. - -Cuando se utiliza un controlador definido como servicio, lo más probable es no ampliar la clase base ``Controller``. En lugar de confiar en sus métodos de acceso directo, debes interactuar directamente con los servicios que necesitas. Afortunadamente, esto suele ser bastante fácil y la clase base ``Controller`` en sí es una gran fuente sobre la manera de realizar muchas tareas comunes. - -.. note:: - - Especificar un controlador como servicio requiere un poco más de trabajo. La principal ventaja es que el controlador completo o cualquier otro servicio pasado al controlador se puede modificar a través de la configuración del contenedor de servicios. - Esto es útil especialmente cuando desarrollas un paquete de código abierto o cualquier paquete que se pueda utilizar en muchos proyectos diferentes. Así que, aunque no especifiques los controladores como servicios, es probable que veas hacer esto en algunos paquetes de código abierto de *Symfony2*. - -Utilizando anotaciones en enrutado ----------------------------------- - -Cuándo utilizas anotaciones para configurar el enrutado al utilizar un controlador definido como servicio, es necesario especificar tu servicio de la siguiente manera:: - - /** - * @Route("/blog", service="my_bundle.annot_controller") - * @Cache(expires="tomorrow") - */ - class AnnotController extends Controller - { - } - -En este ejemplo, ``my_bundle.annot_controller`` tendría que ser el *id* de la instancia de ``AnnotController`` definida en el contenedor del servicio. Esto está documentado en el capítulo :doc:`/bundles/SensioFrameworkExtraBundle/annotations/routing`. diff --git a/_sources/cookbook/debugging.txt b/_sources/cookbook/debugging.txt deleted file mode 100644 index 4cedd3d..0000000 --- a/_sources/cookbook/debugging.txt +++ /dev/null @@ -1,51 +0,0 @@ -.. index:: - single: Depurando - -Cómo optimizar tu entorno de desarrollo para depuración -======================================================= - -Cuando trabajas en un proyecto de *Symfony* en tu equipo local, debes usar el entorno ``dev`` (con el controlador frontal :file:`app_dev.php`). Esta configuración del entorno se ha optimizado para dos propósitos principales: - -* Proporcionar retroalimentación de desarrollo precisa cada vez que algo sale mal (barra de herramientas de depuración *web*, páginas de excepción agradables, perfiles, ...); - -* Ser lo más parecido posible al entorno de producción para evitar problemas al desplegar el proyecto. - -.. _cookbook-debugging-disable-bootstrap: - -Desactivando el archivo de arranque y la caché de clase -------------------------------------------------------- - -Y para que el entorno de producción sea lo más rápido posible, *Symfony* crea grandes archivos *PHP* en la memoria caché que contienen la agregación de las clases *PHP* que tu proyecto necesita para cada petición. Sin embargo, este comportamiento puede confundir a tu *IDE* o depurador. Esta fórmula muestra cómo puedes ajustar este mecanismo de memorización para que sea más amigable cuando necesitas depurar código que incluye clases de *Symfony*. - -El controlador frontal :file:`app_dev.php` por omisión lee lo siguiente:: - - // ... - - $loader = require_once __DIR__.'/../app/bootstrap.php.cache'; - require_once __DIR__.'/../app/AppKernel.php'; - - $kernel = new AppKernel('dev', true); - $kernel->loadClassCache(); - $request = Request::createFromGlobals(); - -Para contentar a tu depurador, desactiva toda la caché de las clases *PHP* eliminando la llamada a ``loadClassCache()`` y sustituyendo las declaraciones `require` como la siguiente:: - - // ... - - // $loader = require_once __DIR__.'/../app/bootstrap.php.cache'; - $loader = require_once __DIR__.'/../app/autoload.php'; - require_once __DIR__.'/../app/AppKernel.php'; - - use Symfony\Component\HttpFoundation\Request; - - $kernel = new AppKernel('dev', true); - // $kernel->loadClassCache(); - $request = Request::createFromGlobals(); - -.. tip:: - - Si desactivas la caché *PHP*, no olvides reactivarla después de tu sesión de depuración. - -A algunos *IDE* no les gusta el hecho de que algunas clases se almacenen en lugares diferentes. Para evitar problemas, puedes decirle a tu *IDE* que omita los archivos de cache *PHP*, o puedes cambiar la extensión utilizada por *Symfony* para estos archivos:: - - $kernel->loadClassCache('classes', '.php.cache'); diff --git a/_sources/cookbook/deployment-tools.txt b/_sources/cookbook/deployment-tools.txt deleted file mode 100644 index 2bfb514..0000000 --- a/_sources/cookbook/deployment-tools.txt +++ /dev/null @@ -1,163 +0,0 @@ -.. index:: - single: Desplegando - -Cómo desplegar una aplicación *Symfony2* -======================================== - -.. note:: - - El desplegando puede ser una tarea compleja y diversa que depende de tu configuración y necesidades. - Esta sección no trata de explicarlo todo, sino que más bien ofrece la mayoría de los requisitos e ideas comunes para su implementación. - -Fundamentos para desplegar *Symfony2* -------------------------------------- - -Los pasos típicos tomados para desplegar una aplicación *Symfony2* incluyen: - -#. Subir tu código modificado al servidor en producción; -#. Actualizar tus dependencias de proveedores (normalmente esto se realiza a través de ``Composer``, y se puede hacer antes de subir tu código); -#. Ejecutar las migraciones de bases de datos o tareas similares para actualizar la estructura de los datos modificados; -#. Limpiar (y tal vez lo más importante, preparar) tu caché. - -El desplegado también puede incluir otras cosas, tal como: - -* Etiquetar una versión particular del tu código como una versión en tu repositorio de control de código fuente; -* Creación de una zona de estacionamiento temporal para construir la configuración actualizada «fuera de línea»; -* Ejecutar cualquier prueba disponible para garantizar la estabilidad del código y/o el servidor; -* La eliminación de todos los archivos innecesarios del directorio ``web`` para mantener limpio tu entorno de producción; -* Limpieza de los sistemas externos de memoria caché (como `Memcached`_ o `Redis`_). - -Cómo desplegar una aplicación *Symfony2* ----------------------------------------- - -Hay varias maneras en que puedes desplegar una aplicación *Symfony2*. - -Empezarás con algunas estrategias para desplegar básicas y a partir de ahí continuarás. - -Transferencia de archivos básica -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La forma más básica para desplegar una aplicación es copiar los archivos manualmente -via ``ftp/scp`` (o algún otro método similar). Esto tiene sus desventajas, ya que carecen de control sobre el sistema a medida que progresa su actualización. Este método también requiere que tomes algunos pasos manuales después de transferir los archivos (consulta la sección `Tareas habituales posteriores al despliegue`_) - -Usando control de código fuente -------------------------------- - -Si estás utilizando control de código fuente (por ejemplo, ``git`` o ``svn``), puedes simplificar esto teniendo tu instalación en vivo también como una copia en tu repositorio. Cuando estés listo para actualizarlo es tan simple como ir a buscar a las novedades desde tu sistema de control de código fuente. - -Esto *facilita* la actualización de tus archivos, pero todavía te tienes que preocupar de tomar otras medidas de control manualmente (consulta la sección `Tareas habituales posteriores al despliegue`_). - -Usando programas de creación y otras herramientas -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -También hay herramientas de alta calidad para ayudarte a aliviar el dolor de la implantación. Incluso hay unas cuantas herramientas que se han adaptado específicamente a las necesidades de *Symfony2*, y que tienen un cuidado especial para asegurarse de que todo esté correcto antes, durante y después de un despliegue. - -Ve `Las herramientas`_ para obtener una lista de las herramientas que te pueden ayudar con el despliegue. - -Tareas habituales posteriores al despliegue -------------------------------------------- - -Después de implantar el código fuente real, hay una serie de tareas comunes que -tendrás que llevar a cabo: - -A) Configura tu archivo :file:`app/config/parameters.yml` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Este archivo se debe personalizar en cada sistema. Cualquier método que utilices para desplegar tu código fuente *no* debe trasladar este archivo. En su lugar, los debes configurar manualmente (o mediante algún proceso de construcción) en tu servidor. - -B) Actualiza tus proveedores -~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Tus proveedores se pueden actualizar antes de transferir el código fuente (es decir, -actualiza el directorio ``vendor/``, y luego transfierelo, con tu código fuente), o actualízalo en el servidor después de transferir tu código fuente. En cualquier caso, basta con actualizar tus proveedores como lo haces normalmente: - -.. code-block:: bash - - $ php composer.phar install --optimize-autoloader - -.. tip:: - - La bandera ``--optimize-autoloader`` hace que ``Composer`` lleve a cabo una optimización de la carga automática construyendo un «mapa de clases». - -C) Borra la caché de *Symfony* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Asegúrate de limpiar (y preparar) la caché de *Symfony*: - -.. code-block:: bash - - $ php app/console cache:clear --env=prod --no-debug - -D) Vuelca tus activos con *Assetic* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si estás utilizando *Assetic*, también querrás volcar tus activos: - -.. code-block:: bash - - $ php app/console assetic:dump --env=prod --no-debug - -E) ¡Otras cosas! -~~~~~~~~~~~~~~~~ - -Es posible que haya un montón de otras cosas que necesites hacer, dependiendo de tu -configuración: - -* La ejecución de cualquier migración de bases de datos -* Vaciado de tu caché *APC* -* - La ejecución de ``assets:install`` (teniendo cuidado si ya se hizo en ``composer.phar install``) -* Añadir/editar trabajos ``CRON`` -* Empujar activos a un ``CDN`` -* ... - -Ciclo de vida de una aplicación: Integración continua, control de calidad, etc. -------------------------------------------------------------------------------- - -Si bien esta sección corresponde a los detalles técnicos del despliegue, el ciclo de vida completo a partir de tomar el código fuente de desarrollo y trasladarlo a producción puede tener mucho más pasos (creo que desde el despliegue hasta la puesta en escena, control de calidad, ejecución de pruebas, etc.). - -Utilizar la puesta en escena, pruebas, control de calidad, integración continua, migraciones de bases de datos y la capacidad para poder retroceder en caso de fallo, todas son muy recomendables. Hay herramientas simples y complejas y puedes hacer tan fácil (o compleja) la instalación como tu entorno requiera. - -No olvides que el despliegue de tu aplicación también implica la actualización de cualquier dependencia (normalmente a través de ``Composer``), la migración de tu base de datos, vaciar la caché y otras cosas posibles como empujar tus activos a un *CDN* (ve `Tareas habituales posteriores al despliegue`_). - -Las herramientas ----------------- - -`Capifony`_: - - Esta herramienta ofrece un conjunto especializado de herramientas en la parte superior de *Capistrano*, específicamente a la medida de proyectos *Symfony* y *Symfony2*. - -`sf2debpkg`_: - - Esta herramienta te ayuda a construir un paquete nativo de *Debian* para tu proyecto *Symfony2*. - -`Magallanes`_: - - Esta herramienta de despliegue tipo *Capistrano* está construida en *PHP*, y puede ser facilitar a los desarrolladores de *PHP* su extensión para cubrir sus necesidades. - -Paquetes: - - Hay muchos `paquetes que añaden características de despliegue`_ directamente en tu consola *Symfony2*. - -Programación básica: - - Puedes, por supuesto, usar el intérprete de ordenes, `Ant`_, o cualquier otra herramienta para programar el despliegue de tu proyecto. - -El ambiente como proveedor de servicios: - - ``PaaS`` es una forma relativamente nueva para desplegar tu aplicación. Normalmente, un ``PaaS`` utilizará un único archivo de configuración en el directorio raíz de tu proyecto para determinar la forma de construir un ambiente al vuelo que apoye a tu software. - Un proveedor con el apoyo confirmado para *Symfony2* es `PagodaBox`_. - -.. tip:: - - ¿Buscando más? Habla con la comunidad en el `canal IRC de Symfony`_ ``#symfony`` (en freenode) para más información. - -.. _`Capifony`: http://capifony.org/ -.. _`sf2debpkg`: https://github.com/liip/sf2debpkg -.. _`Ant`: http://blog.sznapka.pl/deploying-symfony2-applications-with-ant -.. _`PagodaBox`: https://github.com/jmather/pagoda-symfony-sonata-distribution/blob/master/Boxfile -.. _`Magallanes`: https://github.com/andres-montanez/Magallanes -.. _`paquetes que añaden características de despliegue`: http://knpbundles.com/search?q=deploy -.. _`canal IRC de Symfony`: http://webchat.freenode.net/?channels=symfony -.. _`Memcached`: http://memcached.org/ -.. _`Redis`: http://redis.io/ diff --git a/_sources/cookbook/doctrine/common_extensions.txt b/_sources/cookbook/doctrine/common_extensions.txt deleted file mode 100644 index 934b1e1..0000000 --- a/_sources/cookbook/doctrine/common_extensions.txt +++ /dev/null @@ -1,29 +0,0 @@ -.. index:: - single: Doctrine; Extensiones comunes - -Cómo usar extensiones *Doctrine*: ``Timestampable``, ``Sluggable``, ``Translatable``, etc. -========================================================================================== - -*Doctrine2* es muy flexible, y la comunidad ya ha creado una serie de útiles extensiones *Doctrine* para ayudarte con las tareas habituales relacionadas con entidades. - -Una biblioteca en particular ---la biblioteca `DoctrineExtensions`_--- proporciona funcionalidad de integración con los comportamientos `Sluggable`_, `Translatable`_, `Timestampable`_, `Loggable`_, `Tree`_ y `Sortable`_. - -El uso de cada una de estas extensiones se explica en ese repositorio. - -Sin embargo, para instalar/activar cada extensión debes registrar y activar un -:doc:`escucha de eventos `. -Para ello, tienes dos opciones: - -#. Usar el `StofDoctrineExtensionsBundle`_, que integra la biblioteca de arriba. - -#. Implementar estos servicios directamente siguiendo la documentación para la integración con *Symfony2*: `Instalando extensiones Gedmo de Doctrine2 en Symfony2`_ - -.. _`DoctrineExtensions`: https://github.com/l3pp4rd/DoctrineExtensions -.. _`StofDoctrineExtensionsBundle`: https://github.com/stof/StofDoctrineExtensionsBundle -.. _`Sluggable`: https://github.com/l3pp4rd/DoctrineExtensions/blob/master/doc/sluggable.md -.. _`Translatable`: https://github.com/l3pp4rd/DoctrineExtensions/blob/master/doc/translatable.md -.. _`Timestampable`: https://github.com/l3pp4rd/DoctrineExtensions/blob/master/doc/timestampable.md -.. _`Loggable`: https://github.com/l3pp4rd/DoctrineExtensions/blob/master/doc/loggable.md -.. _`Tree`: https://github.com/l3pp4rd/DoctrineExtensions/blob/master/doc/tree.md -.. _`Sortable`: https://github.com/l3pp4rd/DoctrineExtensions/blob/master/doc/sortable.md -.. _`Instalando extensiones Gedmo de Doctrine2 en Symfony2`: https://github.com/l3pp4rd/DoctrineExtensions/blob/master/doc/symfony2.md \ No newline at end of file diff --git a/_sources/cookbook/doctrine/custom_dql_functions.txt b/_sources/cookbook/doctrine/custom_dql_functions.txt deleted file mode 100644 index ec05aec..0000000 --- a/_sources/cookbook/doctrine/custom_dql_functions.txt +++ /dev/null @@ -1,84 +0,0 @@ -.. index:: - single: Doctrine; Funciones DQL personalizadas - -Cómo registrar funciones *DQL* personalizadas -============================================= - -*Doctrine* te permite especificar funciones *DQL* personalizadas. Para más información sobre este tema, lee el artículo «`Funciones DQL definidas por el usuario`_» de *Doctrine*. - -En *Symfony*, puedes registrar tus funciones *DQL* personalizadas de la siguiente manera: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - orm: - # ... - entity_managers: - default: - # ... - dql: - string_functions: - test_string: Acme\HelloBundle\DQL\StringFunction - second_string: Acme\HelloBundle\DQL\SecondStringFunction - numeric_functions: - test_numeric: Acme\HelloBundle\DQL\NumericFunction - datetime_functions: - test_datetime: Acme\HelloBundle\DQL\DatetimeFunction - - .. code-block:: xml - - - - - - - - - - - Acme\HelloBundle\DQL\SecondStringFunction - Acme\HelloBundle\DQL\DatetimeFunction - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('doctrine', array( - 'orm' => array( - // ... - - 'entity_managers' => array( - 'default' => array( - // ... - - 'dql' => array( - 'string_functions' => array( - 'test_string' => 'Acme\HelloBundle\DQL\StringFunction', - 'second_string' => 'Acme\HelloBundle\DQL\SecondStringFunction', - ), - 'numeric_functions' => array( - 'test_numeric' => 'Acme\HelloBundle\DQL\NumericFunction', - ), - 'datetime_functions' => array( - 'test_datetime' => 'Acme\HelloBundle\DQL\DatetimeFunction', - ), - ), - ), - ), - ), - )); - -.. _`Funciones DQL definidas por el usuario`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/cookbook/dql-user-defined-functions.html diff --git a/_sources/cookbook/doctrine/dbal.txt b/_sources/cookbook/doctrine/dbal.txt deleted file mode 100644 index 6eaeaa2..0000000 --- a/_sources/cookbook/doctrine/dbal.txt +++ /dev/null @@ -1,174 +0,0 @@ -.. index:: - pair: Doctrine; DBAL - -Cómo utiliza *Doctrine* la capa *DBAL* -====================================== - -.. note:: - - Este artículo es sobre la capa *DBAL* de *Doctrine*. Normalmente, vas a trabajar con el nivel superior de la capa *ORM* de *Doctrine*, la cual simplemente utiliza *DBAL* detrás del escenario para comunicarse realmente con la base de datos. Para leer más sobre el *ORM* de *Doctrine*, consulta «:doc:`/book/doctrine`». - -`Doctrine`_ la capa de abstracción de base de datos (*DataBase Abstraction Layer* --- *DBAL*) es una capa que se encuentra en la parte superior de `PDO`_ y ofrece una *API* intuitiva y flexible para comunicarse con las bases de datos relacionales más populares. En otras palabras, la biblioteca *DBAL* facilita la ejecución de consultas y realización de otras acciones de base de datos. - -.. tip:: - - Lee la `documentación oficial de DBAL`_ para conocer todos los detalles y las habilidades de la biblioteca *DBAL* de *Doctrine*. - -Para empezar, configura los parámetros de conexión a la base de datos: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - dbal: - driver: pdo_mysql - dbname: Symfony2 - user: root - password: null - charset: UTF8 - - .. code-block:: xml - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'driver' => 'pdo_mysql', - 'dbname' => 'Symfony2', - 'user' => 'root', - 'password' => null, - ), - )); - -Para ver todas las opciones de configuración *DBAL*, consulta :ref:`reference-dbal-configuration`. - -A continuación, puedes acceder a la conexión *Doctrine DBAL* accediendo al servicio ``database_connection``:: - - class UserController extends Controller - { - public function indexAction() - { - $conn = $this->get('database_connection'); - $users = $conn->fetchAll('SELECT * FROM users'); - - // ... - } - } - -Registrando tipos de asignación personalizados ----------------------------------------------- - -Puedes registrar tipos de asignación personalizados a través de la configuración de *Symfony*. Ellos se sumarán a todas las conexiones configuradas. Para más información sobre los tipos de asignación personalizados, lee la sección `Tipos de asignación personalizados`_ de la documentación de *Doctrine*. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - dbal: - types: - custom_first: Acme\HelloBundle\Type\CustomFirst - custom_second: Acme\HelloBundle\Type\CustomSecond - - .. code-block:: xml - - - - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'types' => array( - 'custom_first' => 'Acme\HelloBundle\Type\CustomFirst', - 'custom_second' => 'Acme\HelloBundle\Type\CustomSecond', - ), - ), - )); - -Registrando tipos de asignación personalizados en *SchemaTool* --------------------------------------------------------------- - -La *SchemaTool* se utiliza al inspeccionar la base de datos para comparar el esquema. Para lograr esta tarea, es necesario saber qué tipo de asignación se debe utilizar para cada tipo de la base de datos. Por medio de la configuración puedes registrar nuevos tipos. - -Vamos a asociar el tipo ``ENUM`` (por omisión no apoyado por *DBAL*) al tipo ``string``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - dbal: - connections: - default: - // otros parámetros de conexión - mapping_types: - enum: string - - .. code-block:: xml - - - - - - - - - string - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'connections' => array( - 'default' => array( - 'mapping_types' => array( - 'enum' => 'string', - ), - ), - ), - ), - )); - -.. _`PDO`: http://www.php.net/pdo -.. _`Doctrine`: http://www.doctrine-project.org -.. _`documentación oficial de DBAL`: http://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/index.html -.. _`Tipos de asignación personalizados`: http://docs.doctrine-project.org/projects/doctrine-dbal/en/latest/reference/types.html#custom-mapping-types diff --git a/_sources/cookbook/doctrine/event_listeners_subscribers.txt b/_sources/cookbook/doctrine/event_listeners_subscribers.txt deleted file mode 100644 index 0038031..0000000 --- a/_sources/cookbook/doctrine/event_listeners_subscribers.txt +++ /dev/null @@ -1,200 +0,0 @@ -.. index:: - single: Doctrine; Escuchas y suscriptores de eventos - -.. _doctrine-event-config: - -Cómo registrar escuchas y suscriptores de eventos -================================================= - -*Doctrine* cuenta con un rico sistema de eventos que lanza eventos en casi todo lo que sucede dentro del sistema. Para ti, esto significa que puedes crear :doc:`servicios ` arbitrarios y decirle a *Doctrine* que notifique a esos objetos cada vez que ocurra una determinada acción (por ejemplo, ``PrePersist``) dentro de *Doctrine*. -Esto podría ser útil, por ejemplo, para crear un índice de búsqueda independiente cuando se guarde un objeto en tu base de datos. - -*Doctrine* define dos tipos de objetos que pueden escuchar los eventos de *Doctrine*: -escuchas y suscriptores. Ambos son muy similares, pero los escuchas son un poco más sencillos. Para más información, consulta el `Sistema de eventos`_ en el sitio web de *Doctrine*. - -The Doctrine website also explains all existing events that can be listened to. - -Configurando escuchas/suscriptores ----------------------------------- - -Para registrar un servicio para que actúe como un escucha o suscriptor de eventos sólo lo tienes que :ref:`etiquetar ` con el nombre apropiado. Dependiendo de tu caso de uso, puedes enganchar un escucha en cada conexión *DBAL* y gestor de entidad *ORM* o simplemente en una conexión *DBAL* específica y todos los gestores de entidad que utilicen esta conexión. - -.. configuration-block:: - - .. code-block:: yaml - - doctrine: - dbal: - default_connection: default - connections: - default: - driver: pdo_sqlite - memory: true - - services: - my.listener: - class: Acme\SearchBundle\EventListener\SearchIndexer - tags: - - { name: doctrine.event_listener, event: postPersist } - my.listener2: - class: Acme\SearchBundle\EventListener\SearchIndexer2 - tags: - - { name: doctrine.event_listener, event: postPersist, connection: default } - my.subscriber: - class: Acme\SearchBundle\EventListener\SearchIndexerSubscriber - tags: - - { name: doctrine.event_subscriber, connection: default } - - .. code-block:: xml - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - use Symfony\Component\DependencyInjection\Definition; - - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'default_connection' => 'default', - 'connections' => array( - 'default' => array( - 'driver' => 'pdo_sqlite', - 'memory' => true, - ), - ), - ), - )); - - $container - ->setDefinition( - 'my.listener', - new Definition('Acme\SearchBundle\EventListener\SearchIndexer') - ) - ->addTag('doctrine.event_listener', array('event' => 'postPersist')) - ; - $container - ->setDefinition( - 'my.listener2', - new Definition('Acme\SearchBundle\EventListener\SearchIndexer2') - ) - ->addTag('doctrine.event_listener', array('event' => 'postPersist', 'connection' => 'default')) - ; - $container - ->setDefinition( - 'my.subscriber', - new Definition('Acme\SearchBundle\EventListener\SearchIndexerSubscriber') - ) - ->addTag('doctrine.event_subscriber', array('connection' => 'default')) - ; - -Creando la clase Escucha ------------------------- - -En el ejemplo anterior, se configuró un servicio ``my.listener`` como un escucha de *Doctrine* del evento ``postPersist``. The class behind that service must have -a ``postPersist`` method, which will be called when the event is dispatched:: - - // src/Acme/SearchBundle/EventListener/SearchIndexer.php - namespace Acme\SearchBundle\EventListener; - - use Doctrine\ORM\Event\LifecycleEventArgs; - use Acme\StoreBundle\Entity\Product; - - class SearchIndexer - { - public function postPersist(LifecycleEventArgs $args) - { - $entity = $args->getEntity(); - $entityManager = $args->getEntityManager(); - - // tal vez sólo quieres actuar en alguna entidad "producto" - if ($entity instanceof Product) { - // ... haz algo con el Producto - } - } - } - -En cada caso, tienes acceso a un objeto ``LifecycleEventArgs``, el cual te da acceso tanto al objeto entidad del evento como al mismo gestor de la entidad. - -Una cosa importante a resaltar es que un escucha debe estar atento a *todas* las entidades en tu aplicación. So, if you're interested in only handling a -specific type of entity (e.g. a ``Product`` entity but not a ``BlogPost`` -entity), you should check for the entity's class type in your method -(as shown above). - -Creating the Subscriber Class ------------------------------ - -A doctrine event subscriber must implement the ``Doctrine\Common\EventSubscriber`` -interface and have an event method for each event it subscribes to:: - - // src/Acme/SearchBundle/EventListener/SearchIndexerSubscriber.php - namespace Acme\SearchBundle\EventListener; - - use Doctrine\Common\EventSubscriber; - use Doctrine\ORM\Event\LifecycleEventArgs; - // for doctrine 2.4: Doctrine\Common\Persistence\Event\LifecycleEventArgs; - use Acme\StoreBundle\Entity\Product; - - class SearchIndexerSubscriber implements EventSubscriber - { - public function getSubscribedEvents() - { - return array( - 'postPersist', - 'postUpdate', - ); - } - - public function postUpdate(LifecycleEventArgs $args) - { - $this->index($args); - } - - public function postPersist(LifecycleEventArgs $args) - { - $this->index($args); - } - - public function index(LifecycleEventArgs $args) - { - $entity = $args->getEntity(); - $entityManager = $args->getEntityManager(); - - // tal vez sólo quieres actuar en alguna entidad "producto" - if ($entity instanceof Product) { - // ... haz algo con el Producto - } - } - } - -.. tip:: - - Doctrine event subscribers can not return a flexible array of methods to - call for the events like the :ref:`Symfony event subscriber ` - can. Doctrine event subscribers must return a simple array of the event - names they subscribe to. Doctrine will then expect methods on the subscriber - with the same name as each subscribed event, just as when using an event listener. - -For a full reference, see chapter `The Event System`_ in the Doctrine documentation. - -.. _`Sistema de eventos`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html diff --git a/_sources/cookbook/doctrine/file_uploads.txt b/_sources/cookbook/doctrine/file_uploads.txt deleted file mode 100644 index 0236339..0000000 --- a/_sources/cookbook/doctrine/file_uploads.txt +++ /dev/null @@ -1,516 +0,0 @@ -.. index:: - single: Doctrine; Subiendo archivos - -Cómo manejar archivos subidos con *Doctrine* -============================================ - -Manejar el envío de archivos con entidades *Doctrine* no es diferente a la manipulación de cualquier otra carga de archivo. En otras palabras, eres libre de mover el archivo en tu controlador después de manipular el envío de un formulario. Para ver ejemplos de cómo hacerlo, consulta el :doc:`/reference/forms/types/file` en la referencia. - -Si lo deseas, también puedes integrar la carga de archivos en el ciclo de vida de tu entidad (es decir, creación, actualización y eliminación). En este caso, ya que tu entidad es creada, actualizada y eliminada desde *Doctrine*, el proceso de carga y remoción de archivos se llevará a cabo de forma automática (sin necesidad de hacer nada en el controlador); - -Para que esto funcione, tendrás que hacerte cargo de una serie de detalles, los cuales serán cubiertos en este artículo del recetario. - -Configuración básica --------------------- - -En primer lugar, crea una sencilla clase Entidad de *Doctrine* con la cual trabajar:: - - // src/Acme/DemoBundle/Entity/Document.php - namespace Acme\DemoBundle\Entity; - - use Doctrine\ORM\Mapping as ORM; - use Symfony\Component\Validator\Constraints as Assert; - - /** - * @ORM\Entity - */ - class Document - { - /** - * @ORM\Id - * @ORM\Column(type="integer") - * @ORM\GeneratedValue(strategy="AUTO") - */ - public $id; - - /** - * @ORM\Column(type="string", length=255) - * @Assert\NotBlank - */ - public $name; - - /** - * @ORM\Column(type="string", length=255, nullable=true) - */ - public $path; - - public function getAbsolutePath() - { - return null === $this->path - ? null - : $this->getUploadRootDir().'/'.$this->path; - } - - public function getWebPath() - { - return null === $this->path - ? null - : $this->getUploadDir().'/'.$this->path; - } - - protected function getUploadRootDir() - { - // la ruta absoluta del directorio donde se deben - // guardar los archivos cargados - return __DIR__.'/../../../../web/'.$this->getUploadDir(); - } - - protected function getUploadDir() - { - // se deshace del __DIR__ para no meter la pata - // al mostrar el documento/imagen cargada en la vista. - return 'uploads/documents'; - } - } - -La entidad ``Documento`` tiene un nombre y está asociado con un archivo. La propiedad ``ruta`` almacena la ruta relativa al archivo y se persiste en la base de datos. -El ``getAbsolutePath()`` es un método útil que devuelve la ruta absoluta al archivo, mientras que ``getWebPath()`` es un conveniente método que devuelve la ruta web, la cual se utiliza en una plantilla para enlazar el archivo cargado. - -.. tip:: - - Si no lo has hecho, probablemente primero deberías leer el tipo :doc:`archivo ` en la documentación para comprender cómo trabaja el proceso de carga básico. - -.. note:: - - Si estás utilizando anotaciones para especificar tus reglas de validación (como muestra este ejemplo), asegúrate de que has habilitado la validación por medio de anotaciones (consulta :ref:`configurando la validación `). - -Para manejar el archivo real subido en el formulario, utiliza un campo ``file`` «virtual». -Por ejemplo, si estás construyendo tu formulario directamente en un controlador, este podría tener el siguiente aspecto:: - - public function uploadAction() - { - // ... - - $form = $this->createFormBuilder($document) - ->add('name') - ->add('file') - ->getForm(); - - // ... - } - -A continuación, crea esta propiedad en tu clase ``Documento`` y agrega algunas reglas de validación:: - - use Symfony\Component\HttpFoundation\File\UploadedFile; - - // ... - class Document - { - /** - * @Assert\File(maxSize="6000000") - */ - private $file; - - /** - * Sets file. - * - * @param UploadedFile $file - */ - public function setFile(UploadedFile $file = null) - { - $this->file = $file; - } - - /** - * Get file. - * - * @return UploadedFile - */ - public function getFile() - { - return $this->file; - } - } - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/DemoBundle/Resources/config/validation.yml - Acme\DemoBundle\Entity\Document: - properties: - file: - - File: - maxSize: 6000000 - - .. code-block:: php-annotations - - // src/Acme/DemoBundle/Entity/Document.php - namespace Acme\DemoBundle\Entity; - - // ... - use Symfony\Component\Validator\Constraints as Assert; - - class Document - { - /** - * @Assert\File(maxSize="6000000") - */ - private $file; - - // ... - } - - .. code-block:: xml - - - - - - - - - - - .. code-block:: php - - // src/Acme/DemoBundle/Entity/Document.php - namespace Acme\DemoBundle\Entity; - - // ... - use Symfony\Component\Validator\Mapping\ClassMetadata; - use Symfony\Component\Validator\Constraints as Assert; - - class Document - { - // ... - - public static function loadValidatorMetadata(ClassMetadata $metadata) - { - $metadata->addPropertyConstraint('file', new Assert\File(array( - 'maxSize' => 6000000, - ))); - } - } - -.. note:: - - Debido a que estás utilizando la restricción ``File``, *Symfony2* automáticamente supone que el campo del formulario es una entrada para cargar un archivo. Es por eso que no lo tienes que establecer explícitamente al crear el formulario anterior (``->add('file')``). - -El siguiente controlador muestra cómo manipular todo el proceso:: - - // ... - use Acme\DemoBundle\Entity\Document; - use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template; - // ... - - /** - * @Template() - */ - public function uploadAction() - { - $document = new Document(); - $form = $this->createFormBuilder($document) - ->add('name') - ->add('file') - ->getForm() - ; - - if ($this->getRequest()->isMethod('POST')) { - $form->bind($this->getRequest()); - if ($form->isValid()) { - $em = $this->getDoctrine()->getManager(); - - $em->persist($document); - $em->flush(); - - return $this->redirect($this->generateUrl(...)); - } - } - - return array('form' => $form->createView()); - } - -.. note:: - - Al escribir la plantilla, no olvides fijar el atributo ``enctype``: - - .. configuration-block:: - - .. code-block:: html+jinja - -

    Upload File

    - -
    - {{ form_widget(form) }} - - -
    - - .. code-block:: html+php - -

    Upload File

    - -
    enctype($form) ?>> - widget($form) ?> - - -
    - -El controlador anterior automáticamente persistirá la entidad ``Documento`` con el nombre presentado, pero no hará nada sobre el archivo y la propiedad ``path`` quedará en blanco. - -Una manera fácil de manejar la carga de archivos es que lo muevas justo antes de que se persista la entidad y a continuación, establece la propiedad ``path`` en consecuencia. Comienza por invocar a un nuevo método ``upload()`` en la clase ``Documento``, el cual deberás crear en un momento para manejar la carga del archivo:: - - if ($form->isValid()) { - $em = $this->getDoctrine()->getManager(); - - $document->upload(); - - $em->persist($document); - $em->flush(); - - return $this->redirect(...); - } - -El método ``upload()`` tomará ventaja del objeto :class:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile`, el cual es lo que devuelve después de que se presenta un campo ``file``:: - - public function upload() - { - // the file property can be empty if the field is not required - if (null === $this->getFile()) { - return; - } - - // aquí usa el nombre de archivo original pero lo debes - // sanear al menos para evitar cualquier problema de seguridad - - // move takes the target directory and then the - // target filename to move to - $this->getFile()->move( - $this->getUploadRootDir(), - $this->getFile()->getClientOriginalName() - ); - - // set the path property to the filename where you've saved the file - $this->path = $this->getFile()->getClientOriginalName(); - - // limpia la propiedad «file» ya que no la necesitas más - $this->file = null; - } - -Usando el ciclo de vida de las retrollamadas --------------------------------------------- - -Incluso si esta implementación trabaja, sufre de un importante defecto: ¿Qué pasa si hay un problema al persistir la entidad? El archivo ya se ha movido a su ubicación final, incluso aunque la propiedad ``path`` de la entidad no se persista correctamente. - -Para evitar estos problemas, debes cambiar la implementación para que la operación de base de datos y el traslado del archivo sean atómicos: si hay un problema al persistir la entidad o si el archivo no se puede mover, entonces, no debe suceder *nada*. - -Para ello, es necesario mover el archivo justo cuando *Doctrine* persista la entidad a la base de datos. Esto se puede lograr enganchando el ciclo de vida de la entidad a una retrollamada:: - - /** - * @ORM\Entity - * @ORM\HasLifecycleCallbacks - */ - class Document - { - } - -A continuación, reconstruye la clase ``Documento`` para que tome ventaja de estas retrollamadas:: - - use Symfony\Component\HttpFoundation\File\UploadedFile; - - /** - * @ORM\Entity - * @ORM\HasLifecycleCallbacks - */ - class Document - { - private $temp; - - /** - * Sets file. - * - * @param UploadedFile $file - */ - public function setFile(UploadedFile $file = null) - { - $this->file = $file; - // check if we have an old image path - if (isset($this->path)) { - // store the old name to delete after the update - $this->temp = $this->path; - $this->path = null; - } else { - $this->path = 'initial'; - } - } - - /** - * @ORM\PrePersist() - * @ORM\PreUpdate() - */ - public function preUpload() - { - if (null !== $this->getFile()) { - // haz lo que quieras para generar un nombre único - $filename = sha1(uniqid(mt_rand(), true)); - $this->path = $filename.'.'.$this->getFile()->guessExtension(); - } - } - - /** - * @ORM\PostPersist() - * @ORM\PostUpdate() - */ - public function upload() - { - if (null === $this->getFile()) { - return; - } - - // si hay un error al mover el archivo, move() automáticamente - // envía una excepción. This will properly prevent - // the entity from being persisted to the database on error - $this->getFile()->move($this->getUploadRootDir(), $this->path); - - // check if we have an old image - if (isset($this->temp)) { - // delete the old image - unlink($this->getUploadRootDir().'/'.$this->temp); - // clear the temp image path - $this->temp = null; - } - $this->file = null; - } - - /** - * @ORM\PostRemove() - */ - public function removeUpload() - { - if ($file = $this->getAbsolutePath()) { - unlink($file); - } - } - } - -La clase ahora hace todo lo que necesitas: genera un nombre de archivo único antes de persistirlo, mueve el archivo después de persistirlo y elimina el archivo si la entidad es eliminada. - -Ahora que la entidad maneja automáticamente el movimiento del archivo, debes quitar del controlador la llamada a ``$document->upload()``:: - - if ($form->isValid()) { - $em = $this->getDoctrine()->getManager(); - - $em->persist($document); - $em->flush(); - - return $this->redirect(...); - } - -.. note:: - - Los eventos retrollamados ``@ORM\PrePersist()`` y ``@ORM\PostPersist()`` se disparan antes y después de almacenar la entidad en la base de datos. Por otro lado, los eventos retrollamados ``@ORM\PreUpdate()`` y ``@ORM\PostUpdate()`` se llaman al actualizar la entidad. - -.. caution:: - - Las retrollamadas ``PreUpdate`` y ``PostUpdate`` sólo se activan si se persiste algún cambio en uno de los campos de la entidad. Esto significa que, de manera predeterminada, si sólo modificas la propiedad ``$file``, estos eventos no se activarán, puesto que esa propiedad no se persiste directamente a través de *Doctrine*. Una solución sería usar un campo ``actualizado`` que *Doctrine* persista, y modificarlo manualmente al cambiar el archivo. - -Usando el ``id`` como nombre de archivo ---------------------------------------- - -Si deseas utilizar el ``id`` como el nombre del archivo, la implementación es un poco diferente conforme sea necesaria para guardar la extensión en la propiedad ``path``, en lugar del nombre de archivo real:: - - use Symfony\Component\HttpFoundation\File\UploadedFile; - - /** - * @ORM\Entity - * @ORM\HasLifecycleCallbacks - */ - class Document - { - private $temp; - - /** - * Sets file. - * - * @param UploadedFile $file - */ - public function setFile(UploadedFile $file = null) - { - $this->file = $file; - // check if we have an old image path - if (is_file($this->getAbsolutePath())) { - // store the old name to delete after the update - $this->temp = $this->getAbsolutePath(); - } else { - $this->path = 'initial'; - } - } - - /** - * @ORM\PrePersist() - * @ORM\PreUpdate() - */ - public function preUpload() - { - if (null !== $this->getFile()) { - $this->path = $this->getFile()->guessExtension(); - } - } - - /** - * @ORM\PostPersist() - * @ORM\PostUpdate() - */ - public function upload() - { - if (null === $this->getFile()) { - return; - } - - // check if we have an old image - if (isset($this->temp)) { - // delete the old image - unlink($this->temp); - // clear the temp image path - $this->temp = null; - } - - // you must throw an exception here if the file cannot be moved - // so that the entity is not persisted to the database - // which the UploadedFile move() method does - $this->getFile()->move( - $this->getUploadRootDir(), - $this->id.'.'.$this->getFile()->guessExtension() - ); - - $this->setFile(null); - } - - /** - * @ORM\PreRemove() - */ - public function storeFilenameForRemove() - { - $this->temp = $this->getAbsolutePath(); - } - - /** - * @ORM\PostRemove() - */ - public function removeUpload() - { - if (isset($this->temp)) { - unlink($this->temp); - } - } - - public function getAbsolutePath() - { - return null === $this->path - ? null - : $this->getUploadRootDir().'/'.$this->id.'.'.$this->path; - } - } - -Habrás notado en este caso que necesitas trabajar un poco más para poder eliminar el archivo. Antes de eliminarlo, debes almacenar la ruta del archivo (puesto que depende del ``id``). Entonces, una vez que el objeto se ha eliminado completamente de la base de datos, puedes eliminar el archivo (en ``PostRemove``). diff --git a/_sources/cookbook/doctrine/index.txt b/_sources/cookbook/doctrine/index.txt deleted file mode 100644 index 5c26c10..0000000 --- a/_sources/cookbook/doctrine/index.txt +++ /dev/null @@ -1,15 +0,0 @@ -*Doctrine* -========== - -.. toctree:: - :maxdepth: 2 - - file_uploads - common_extensions - event_listeners_subscribers - dbal - reverse_engineering - multiple_entity_managers - custom_dql_functions - resolve_target_entity - registration_form diff --git a/_sources/cookbook/doctrine/multiple_entity_managers.txt b/_sources/cookbook/doctrine/multiple_entity_managers.txt deleted file mode 100644 index 0737c3f..0000000 --- a/_sources/cookbook/doctrine/multiple_entity_managers.txt +++ /dev/null @@ -1,214 +0,0 @@ -.. index:: - single: Doctrine; Múltiples gestores de entidad - -Cómo trabajar con múltiples gestores de entidad y conexiones -============================================================ - -Puedes utilizar múltiples gestores de entidad de *Doctrine* o conexiones en una -aplicación *Symfony2*. Esto es necesario si estás utilizando diferentes bases de datos e incluso proveedores con conjuntos de entidades totalmente diferentes. En otras palabras, un gestor de entidad que se conecta a una base de datos deberá administrar algunas entidades, mientras que otro gestor de entidad conectado a otra base de datos puede manejar el resto. - -.. note:: - - Usar varios gestores de entidad es bastante fácil, pero más avanzado y generalmente no se requiere. Asegúrate de que realmente necesitas varios gestores de entidad antes de añadir complejidad a ese nivel. - -El siguiente código de configuración muestra cómo puedes configurar dos gestores de entidad: - -.. configuration-block:: - - .. code-block:: yaml - - doctrine: - dbal: - default_connection: default - connections: - default: - driver: "%database_driver%" - host: "%database_host%" - port: "%database_port%" - dbname: "%database_name%" - user: "%database_user%" - password: "%database_password%" - charset: UTF8 - customer: - driver: "%database_driver2%" - host: "%database_host2%" - port: "%database_port2%" - dbname: "%database_name2%" - user: "%database_user2%" - password: "%database_password2%" - charset: UTF8 - - orm: - default_entity_manager: default - entity_managers: - default: - connection: default - mappings: - AcmeDemoBundle: ~ - AcmeStoreBundle: ~ - customer: - connection: customer - mappings: - AcmeCustomerBundle: ~ - - .. code-block:: xml - - - - - - - - - - - - - - - - - - - - - - - - - - .. code-block:: php - - $container->loadFromExtension('doctrine', array( - 'dbal' => array( - 'default_connection' => 'default', - 'connections' => array( - 'default' => array( - 'driver' => '%database_driver%', - 'host' => '%database_host%', - 'port' => '%database_port%', - 'dbname' => '%database_name%', - 'user' => '%database_user%', - 'password' => '%database_password%', - 'charset' => 'UTF8', - ), - 'customer' => array( - 'driver' => '%database_driver2%', - 'host' => '%database_host2%', - 'port' => '%database_port2%', - 'dbname' => '%database_name2%', - 'user' => '%database_user2%', - 'password' => '%database_password2%', - 'charset' => 'UTF8', - ), - ), - ), - - 'orm' => array( - 'default_entity_manager' => 'default', - 'entity_managers' => array( - 'default' => array( - 'connection' => 'default', - 'mappings' => array( - 'AcmeDemoBundle' => null, - 'AcmeStoreBundle' => null, - ), - ), - 'customer' => array( - 'connection' => 'customer', - 'mappings' => array( - 'AcmeCustomerBundle' => null, - ), - ), - ), - ), - )); - -En este caso, hemos definido dos gestores de entidad y los llamamos ``default`` y ``customer``. El gestor de entidad ``default`` administra cualquier entidad en los paquetes ``AcmeDemoBundle`` y ``AcmeStoreBundle``, mientras que el gestor de entidad ``customer`` gestiona cualquiera en el paquete ``AcmeCustomerBundle``. También definiste dos conexiones, una para cada gestor de entidad. - -.. note:: - - Cuando trabajas con múltiples conexiones y gestores de entidad, debes ser explícito sobre cual configuración deseas. Si *omites* el nombre de la conexión o gestor de entidad, se usa el predeterminado (es decir, ``default``). - -Cuando trabajes con múltiples conexiones para crear tu base de datos: - -.. code-block:: bash - - # Juega sólo con la conexión «default» - $ php app/console doctrine:database:create - - # Juega sólo con la conexión «customer» - $ php app/console doctrine:database:create --connection=customer - -Cuándo trabajas múltiple gestores de entidad para actualizar tu esquema: - -.. code-block:: bash - - # Juega sólo con asociaciones «default» - $ php app/console doctrine:schema:update --force - - # Juega sólo con asociaciones «customer» - $ php app/console doctrine:schema:update --force --em=customer - -Si *omites* el nombre del gestor de la entidad al consultar por él, se devuelve el gestor de entidad predeterminado (es decir, ``default``):: - - class UserController extends Controller - { - public function indexAction() - { - // ambos devuelven el gestor de entidad "predefinido" - $em = $this->get('doctrine')->getManager(); - $em = $this->get('doctrine')->getManager('default'); - - $customerEm = $this->get('doctrine')->getManager('customer'); - } - } - -Ahora puedes utilizar *Doctrine* tal como lo hiciste antes --- con el gestor de entidad ``default`` para persistir y recuperar las entidades que gestiona y el gestor de entidad ``customer`` para persistir y recuperar sus entidades. - -Lo mismo aplica para llamadas al repositorio:: - - class UserController extends Controller - { - public function indexAction() - { - // Recupera un repositorio gestionado por el em 'predefinido' - $products = $this->get('doctrine') - ->getRepository('AcmeStoreBundle:Product') - ->findAll() - ; - - // La manera explícita para tratar con el em 'predefinido' - $products = $this->get('doctrine') - ->getRepository('AcmeStoreBundle:Product', - 'default') - ->findAll(); - - // Recupera un repositorio gestionado por el em 'customer' - $customers = $this->get('doctrine') - ->getRepository('AcmeCustomerBundle:Customer', - 'customer') - ->findAll() - ; - } - } diff --git a/_sources/cookbook/doctrine/registration_form.txt b/_sources/cookbook/doctrine/registration_form.txt deleted file mode 100644 index 838634b..0000000 --- a/_sources/cookbook/doctrine/registration_form.txt +++ /dev/null @@ -1,268 +0,0 @@ -.. index:: - single: Doctrine; Sencillo formulario de registro - single: Formulario; Sencillo formulario de registro - -Cómo implementar un sencillo formulario de registro -=================================================== - -Algunos formularios tienen campos adicionales cuyos valores no se necesita almacenar en la base de datos. Por ejemplo, posiblemente quieras crear un formulario de inscripción con unos cuantos campos adicionales (como un campo de casilla de verificación «términos aceptados») e integrar en el formulario lo que realmente almacena la información de la cuenta. - -El sencillo modelo de usuario ------------------------------ - -Tienes una sencilla entidad ``Usuario`` asignada a la base de datos:: - - // src/Acme/AccountBundle/Entity/User.php - namespace Acme\AccountBundle\Entity; - - use Doctrine\ORM\Mapping as ORM; - use Symfony\Component\Validator\Constraints as Assert; - use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity; - - /** - * @ORM\Entity - * @UniqueEntity(fields="email", message="Email already taken") - */ - class User - { - /** - * @ORM\Id - * @ORM\Column(type="integer") - * @ORM\GeneratedValue(strategy="AUTO") - */ - protected $id; - - /** - * @ORM\Column(type="string", length=255) - * @Assert\NotBlank() - * @Assert\Email() - */ - protected $email; - - /** - * @ORM\Column(type="string", length=255) - * @Assert\NotBlank() - */ - protected $plainPassword; - - public function getId() - { - return $this->id; - } - - public function getEmail() - { - return $this->email; - } - - public function setEmail($email) - { - $this->email = $email; - } - - public function getPlainPassword() - { - return $this->plainPassword; - } - - public function setPlainPassword($password) - { - $this->plainPassword = $password; - } - } - -Esta entidad ``Usuario`` contiene tres campos y dos de ellos (``email`` y ``plainPassword``) se deben mostrar en el formulario. La propiedad ``email`` debe ser única en la base de datos, esto se consigue añadiendo esta validación en la parte superior de la clase. - -.. note:: - - Si deseas integrar este ``Usuario`` en el sistema de seguridad, necesitas implementar la entidad :ref:`UserInterface ` del componente de seguridad. - -Creando un formulario para el modelo ------------------------------------- - -A continuación, crea el formulario para el modelo ``Usuario``:: - - // src/Acme/AccountBundle/Form/Type/UserType.php - namespace Acme\AccountBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class UserType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('email', 'email'); - $builder->add('plainPassword', 'repeated', array( - 'first_name' => 'password', - 'second_name' => 'confirm', - 'type' => 'password', - )); - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\AccountBundle\Entity\User' - )); - } - - public function getName() - { - return 'user'; - } - } - -Sólo hay dos campos: ``email`` y ``plainPassword`` (repetido para confirmar la contraseña introducida). La opción ``data_class`` le dice al formulario el nombre de la clase datos (es decir, la entidad ``usuario``). - -.. tip:: - - Para explorar más cosas sobre el componente ``formulario``, consulta :doc:`/book/forms` en el libro. - -Incorporando el formulario del usuario en un formulario de inscripción ----------------------------------------------------------------------- - -El formulario que vamos a usar para la página de registro no es el mismo que el -formulario para simplemente modificar al ``usuario`` (es decir, ``UserType``). El formulario de inscripción contendrá otros campos, como «Acepto los términos», cuyo valor no se almacena en la base de datos. - -Comienza creando una simple clase que represente la «inscripción»:: - - // src/Acme/AccountBundle/Form/Model/Registration.php - namespace Acme\AccountBundle\Form\Model; - - use Symfony\Component\Validator\Constraints as Assert; - - use Acme\AccountBundle\Entity\User; - - class Registration - { - /** - * @Assert\Type(type="Acme\AccountBundle\Entity\User") - * @Assert\Valid() - */ - protected $user; - - /** - * @Assert\NotBlank() - * @Assert\True() - */ - protected $termsAccepted; - - public function setUser(User $user) - { - $this->user = $user; - } - - public function getUser() - { - return $this->user; - } - - public function getTermsAccepted() - { - return $this->termsAccepted; - } - - public function setTermsAccepted($termsAccepted) - { - $this->termsAccepted = (Boolean) $termsAccepted; - } - } - -Luego, crea el formulario para este modelo ``Registration``:: - - // src/Acme/AccountBundle/Form/Type/RegistrationType.php - namespace Acme\AccountBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - - class RegistrationType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('user', new UserType()); - $builder->add( - 'terms', - 'checkbox', - array('property_path' => 'termsAccepted') - ); - } - - public function getName() - { - return 'registration'; - } - } - -No es necesario utilizar el método especial para incorporar el formulario ``UserType``. -Un formulario es un campo, también --- así que lo puedes agregar como cualquier otro campo, con la expectativa de que la propiedad ``Registration.user`` mantendrá una instancia de la clase ``usuario``. - -Manejando el envío del formulario ---------------------------------- - -Después, necesitas un controlador para manejar el formulario. Comienza creando un simple controlador para mostrar el formulario de inscripción:: - - // src/Acme/AccountBundle/Controller/AccountController.php - namespace Acme\AccountBundle\Controller; - - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - use Symfony\Component\HttpFoundation\Response; - - use Acme\AccountBundle\Form\Type\RegistrationType; - use Acme\AccountBundle\Form\Model\Registration; - - class AccountController extends Controller - { - public function registerAction() - { - $form = $this->createForm( - new RegistrationType(), - new Registration() - ); - - return $this->render( - 'AcmeAccountBundle:Account:register.html.twig', - array('form' => $form->createView()) - ); - } - } - -y su plantilla: - -.. code-block:: html+jinja - - {# src/Acme/AccountBundle/Resources/views/Account/register.html.twig #} -
    - {{ form_widget(form) }} - - -
    - -Finalmente, crea el controlador que maneja el envío del formulario. Esto llevará a cabo la validación y guardará los datos en la base de datos:: - - public function createAction() - { - $em = $this->getDoctrine()->getEntityManager(); - - $form = $this->createForm(new RegistrationType(), new Registration()); - - $form->bind($this->getRequest()); - - if ($form->isValid()) { - $registration = $form->getData(); - - $em->persist($registration->getUser()); - $em->flush(); - - return $this->redirect(...); - } - - return $this->render( - 'AcmeAccountBundle:Account:register.html.twig', - array('form' => $form->createView()) - ); - } - -¡Eso es todo! Tu formulario ahora valida, y te permite guardar en la base de datos el objeto ``Usuario``. La casilla de verificación adicional ``términos `` en la clase ``Registration`` del modelo se utiliza durante la validación, pero en realidad no se utiliza más tarde, cuando se guarda al usuario en la base de datos. diff --git a/_sources/cookbook/doctrine/resolve_target_entity.txt b/_sources/cookbook/doctrine/resolve_target_entity.txt deleted file mode 100644 index daf0870..0000000 --- a/_sources/cookbook/doctrine/resolve_target_entity.txt +++ /dev/null @@ -1,143 +0,0 @@ -.. index:: - single: Doctrine; Resolviendo entidades destino - single: Doctrine; Definiendo relaciones con interfaces y clases abstractas - -Cómo definir relaciones con interfaces y clases abstractas -========================================================== - -.. versionadded:: 2.1 - El ``ResolveTargetEntityListener`` es nuevo para *Doctrine 2.2*, fue empacado por primera vez con *Symfony 2.1*. - -Uno de los objetivos de los paquetes es la creación discreta de paquetes de funcionalidad que no tienen muchas dependencias (o ninguna, en su caso), lo cual te permite utilizar esa funcionalidad en otras aplicaciones sin incluir elementos innecesarios. - -*Doctrine 2.2* incluye una nueva utilidad llamada ``ResolveTargetEntityListener``, con la cual las funciones interceptan llamadas dentro de *Doctrine* y reescriben los parámetros ``targetEntity`` en tu correlación de metadatos en tiempo de ejecución. Esto significa que en tu paquete eres capaz de utilizar una interfaz o una clase abstracta en tus asignaciones y esperar una correcta correlación en una entidad concreta en tiempo de ejecución. - -Esta funcionalidad te permite definir las relaciones entre diferentes entidades sin volverlas dependencias duras. - -Antecedentes ------------- - -Supongamos que tienes un ``InvoiceBundle`` que proporciona la funcionalidad de facturación y un ``CustomerBundle`` que contiene herramientas para la gestión de clientes. Los quieres mantener separados, ya que se pueden utilizar en otros sistemas el uno sin el otro, pero para tu aplicación deseas usarlos juntos. - -En este caso, tiene una entidad factura (``Invoice``) con una relación a un objeto inexistente, un ``InvoiceSubjectInterface``. El objetivo es conseguir que el ``ResolveTargetEntityListener`` reemplace cualquier mención a la interfaz con un objeto real que implemente esa interfaz. - -Configurando ------------- - -Vamos a usar las siguientes entidades básicas (incompletas por razones de brevedad) para explicar cómo configurar y utilizar el ``ResolveTargetEntityListener``. - -Una entidad ``Cliente``:: - - // src/Acme/AppBundle/Entity/Customer.php - - namespace Acme\AppBundle\Entity; - - use Doctrine\ORM\Mapping as ORM; - use Acme\CustomerBundle\Entity\Customer as BaseCustomer; - use Acme\InvoiceBundle\Model\InvoiceSubjectInterface; - - /** - * @ORM\Entity - * @ORM\Table(name="customer") - */ - class Customer extends BaseCustomer implements InvoiceSubjectInterface - { - // En nuestro ejemplo, todos los métodos definidos en la - // InvoiceSubjectInterface ya están implementados en - // BaseCustomer - -La entidad ``Factura``:: - - // src/Acme/InvoiceBundle/Entity/Invoice.php - - namespace Acme\InvoiceBundle\Entity; - - use Doctrine\ORM\Mapping AS ORM; - use Acme\InvoiceBundle\Model\InvoiceSubjectInterface; - - /** - * Representa una ``Factura``. - * - * @ORM\Entity - * @ORM\Table(name="invoice") - */ - class Invoice - { - /** - * @ORM\ManyToOne(targetEntity="Acme\InvoiceBundle\Model\InvoiceSubjectInterface") - * @var InvoiceSubjectInterface - */ - protected $subject; - } - -Una ``InvoiceSubjectInterface``:: - - // src/Acme/InvoiceBundle/Model/InvoiceSubjectInterface.php - - namespace Acme\InvoiceBundle\Model; - - /** - * Una interfaz que debe implementar el objeto súbdito de la factura. - * En la mayoría de los casos, un único objeto debe implementar esta - * interfaz puesto que ResolveTargetEntityListener sólo puede - * cambiar el destino a un único objeto. - */ - interface InvoiceSubjectInterface - { - // Enumera los métodos adicionales que necesita tu InvoiceBundle - // para acceder al súbdito para que puedas garantizar - // que tienes acceso a esos métodos. - - /** - * @return string - */ - public function getName(); - } - -A continuación, tienes que configurar el escucha, el cual informa a ``DoctrineBundle`` acerca de la sustitución: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - # .... - orm: - # .... - resolve_target_entities: - Acme\InvoiceBundle\Model\InvoiceSubjectInterface: Acme\AppBundle\Entity\Customer - - .. code-block:: xml - - - - - - - - Acme\AppBundle\Entity\Customer - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('doctrine', array( - 'orm' => array( - // ... - 'resolve_target_entities' => array( - 'Acme\InvoiceBundle\Model\InvoiceSubjectInterface' => 'Acme\AppBundle\Entity\Customer', - ), - ), - )); - -Consideraciones finales ------------------------ - -Con el ``ResolveTargetEntityListener``, puedes separar tus paquetes, y siguen siendo útiles por sí mismos, pero aún así capaces de definir relaciones entre diferentes objetos. Usando este método, los paquetes terminan siendo más fáciles de mantener de manera independiente. diff --git a/_sources/cookbook/doctrine/reverse_engineering.txt b/_sources/cookbook/doctrine/reverse_engineering.txt deleted file mode 100644 index cc799d2..0000000 --- a/_sources/cookbook/doctrine/reverse_engineering.txt +++ /dev/null @@ -1,146 +0,0 @@ -.. index:: - single: Doctrine; Generando entidades desde una base de datos existe - -Cómo generar entidades desde una base de datos existente -======================================================== - -Cuando empiezas a trabajar en el proyecto de una nueva marca que utiliza una base de datos, es algo natural que sean dos situaciones diferentes. En la mayoría de los casos, el modelo de base de datos se diseña y construye desde cero. A veces, sin embargo, comenzarás con un modelo de base de datos existente y probablemente inmutable. Afortunadamente, *Doctrine* viene con un montón de herramientas para ayudarte a generar las clases del modelo desde tu base de datos existente. - -.. note:: - - Como dicen las `herramientas de documentación de Doctrine`_, la ingeniería inversa es un proceso de una sola vez para empezar a trabajar en un proyecto. *Doctrine* es capaz de convertir aproximadamente el 70-80% de la información asignada basándose en los campos, índices y restricciones de clave externa. *Doctrine* no puede descubrir asociaciones inversas, tipos de herencia, entidades con claves externas como claves principales u operaciones semánticas en asociaciones tales como eventos en cascada o ciclo de vida de los eventos. Posteriormente, será necesario algún trabajo adicional sobre las entidades generadas para diseñar cada una según tus características específicas del modelo de dominio. - -Esta guía asume que estás usando una sencilla aplicación de *blog* con las siguientes dos tablas: ``blog_post`` y ``blog_comment``. Un registro de comentarios está vinculado a un registro de comentario gracias a una restricción de clave externa. - -.. code-block:: sql - - CREATE TABLE `blog_post` ( - `id` bigint(20) NOT NULL AUTO_INCREMENT, - `title` varchar(100) COLLATE utf8_unicode_ci NOT NULL, - `content` longtext COLLATE utf8_unicode_ci NOT NULL, - `created_at` datetime NOT NULL, - PRIMARY KEY (`id`) - ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci; - - CREATE TABLE `blog_comment` ( - `id` bigint(20) NOT NULL AUTO_INCREMENT, - `post_id` bigint(20) NOT NULL, - `autor` varchar(20) COLLATE utf8_unicode_ci NOT NULL, - `contenido` longtext COLLATE utf8_unicode_ci NOT NULL, - `creado_at` datetime NOT NULL, - PRIMARY KEY (`id`), - KEY `blog_comment_post_id_idx` (`post_id`), - CONSTRAINT `blog_post_id` FOREIGN KEY (`post_id`) REFERENCES `blog_post` (`id`) ON DELETE CASCADE - ) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci; - -Antes de zambullirte en la receta, asegúrate de que los parámetros de conexión de tu base de datos están configurados correctamente en el archivo ``app/config/parameters.yml`` (o cualquier otro lugar donde mantienes la configuración de base de datos) y que has iniciado un paquete que será la sede de tu futura clase entidad. Esta guía supone que existe un ``AcmeBlogBundle`` y está localizado bajo el directorio ``src/Acme/BlogBundle``. - -El primer paso para crear las clases de la entidad en una base de datos existente es pedir a *Doctrine* que introspeccione la base de datos y genere los archivos de metadatos correspondientes. Los archivos de metadatos describen la clase de la entidad para generar tablas basándose en los campos. - -.. code-block:: bash - - $ php app/console doctrine:mapping:convert xml ./src/Acme/BlogBundle/Resources/config/doctrine/metadata/orm --from-database --force - -Esta herramienta de línea de ordenes le pide a *Doctrine* que inspeccione la estructura de la base de datos y genere los archivos *XML* de metadatos bajo el directorio :file:`src/Acme/BlogBundle/Resources/config/doctrine/metadata/orm` de tu paquete. - -.. tip:: - - También es posible generar los metadatos de clase en formato *YAML* cambiando el primer argumento a `yml`. - -El archivo de metadatos generado ``BlogPost.dcm.xml`` es el siguiente: - -.. code-block:: xml - - - - - DEFERRED_IMPLICIT - - - - - - - - - - - - - -.. note:: - - Si tienes relaciones ``UnoAMuchos`` entre tus entidades, necesitarás editar los archivos ``xml`` o ``yml`` generados para añadir una sección en las entidades específicas ``UnoAMuchos`` definiendo las piezas ``inversedBy`` y ``mappedBy``. - -Una vez generados los archivos de metadatos, puedes pedir a *Doctrine* que importe el esquema y construya las clases relacionadas con la entidad, ejecutando las dos siguientes ordenes. - -.. code-block:: bash - - $ php app/console doctrine:mapping:import AcmeBlogBundle annotation - $ php app/console doctrine:generate:entities AcmeBlogBundle - -La primer orden genera las clases de entidad con una asignación de anotaciones, pero por supuesto puedes cambiar el argumento ``annotation`` a ``xml`` o ``yml``. -La clase entidad ``BlogComment`` recién creada se ve de la siguiente manera: - -.. code-block:: php - - - - - - - - .. code-block:: php - - // app/config/config_test.php - $container->loadFromExtension('swiftmailer', array( - 'disable_delivery' => "true", - )); - -Si también deseas inhabilitar el envío en el entorno ``dev``, sólo tienes que añadir esta misma configuración en el archivo :file:`config_dev.yml`. - -Enviando a una dirección específica ------------------------------------ - -También puedes optar por hacer que todos los correos sean enviados a una dirección específica, en vez de la dirección real especificada cuando se envía el mensaje. Esto se puede conseguir a través de la opción ``delivery_address``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_dev.yml - swiftmailer: - delivery_address: dev@example.com - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config_dev.php - $container->loadFromExtension('swiftmailer', array( - 'delivery_address' => "dev@example.com", - )); - -Ahora, supongamos que estás enviando un correo electrónico a ``recipient@example.com``. - -.. code-block:: php - - public function indexAction($name) - { - $message = \Swift_Message::newInstance() - ->setSubject('Hello Email') - ->setFrom('send@example.com') - ->setTo('recipient@example.com') - ->setBody( - $this->renderView( - 'HelloBundle:Hello:email.txt.twig', - array('name' => $name) - ) - ) - ; - $this->get('mailer')->send($message); - - return $this->render(...); - } - -En el entorno ``dev``, el correo electrónico será enviado a ``dev@example.com``. -``SwiftMailer`` añadirá una cabecera adicional al correo electrónico, ``X-Swift-To``, conteniendo la dirección reemplazada, por lo tanto todavía serás capaz de ver qué se ha enviado. - -.. note:: - - Además de las direcciones ``para``, también se detendrá el correo electrónico que se envíe a cualquier dirección ``CC`` y ``BCC`` establecida. ``SwiftMailer`` agregará encabezados adicionales al correo electrónico con la dirección reemplazada en ellos. - Estas son ``X-Swift-CC`` y ``X-Swift-CCO`` para las direcciones ``CC`` y ``BCC``, respectivamente. - -Visualizando desde la barra de depuración web ---------------------------------------------- - -Puedes ver cualquier correo electrónico enviado por una respuesta cuando estás en el entorno ``dev`` usando la barra de depuración web. El icono de correo electrónico en la barra de herramientas mostrará cuántos correos electrónicos fueron enviados. Si haces clic en él, se abrirá un informe mostrando los detalles de los mensajes de correo electrónico enviados. - -Si estás enviando un correo electrónico e inmediatamente rediriges a otra página, la barra de herramientas de depuración web no mostrará un icono de correo electrónico o un informe en la siguiente página. - -En su lugar, puedes ajustar la opción ``intercept_redirects`` a ``true`` en el archivo :file:`config_dev.yml`, lo cual provocará que la redirección se detenga y te permitirá abrir el informe con los detalles de los correos enviados. - -.. tip:: - - Como alternativa, puedes abrir el perfilador después de la redirección y buscar la *URL* utilizada en la petición anterior (por ejemplo ``/contact/handle``). - La característica de búsqueda del perfilador te permite cargar información del perfil de peticiones anteriores. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_dev.yml - web_profiler: - intercept_redirects: true - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config_dev.php - $container->loadFromExtension('web_profiler', array( - 'intercept_redirects' => 'true', - )); diff --git a/_sources/cookbook/email/email.txt b/_sources/cookbook/email/email.txt deleted file mode 100644 index 2b37179..0000000 --- a/_sources/cookbook/email/email.txt +++ /dev/null @@ -1,127 +0,0 @@ -.. index:: - single: Emails - -Cómo enviar correo electrónico -============================== - -El envío de correo electrónico es una tarea clásica para cualquier aplicación web, y la cual tiene complicaciones especiales y peligros potenciales. En lugar de reinventar la rueda, una solución para enviar mensajes de correo electrónico es usando el ``SwiftmailerBundle``, el cual aprovecha el poder de la biblioteca `SwiftMailer`_. - -.. note:: - - No olvides activar el paquete en tu núcleo antes de usarlo:: - - public function registerBundles() - { - $bundles = array( - // ... - - new Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle(), - ); - - // ... - } - -.. _swift-mailer-configuration: - -Configurando ------------- - -Antes de usar ``SwiftMailer``, asegúrate de incluir su configuración. El único parámetro de configuración obligatorio es ``transport``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - swiftmailer: - transport: smtp - encryption: ssl - auth_mode: login - host: smtp.gmail.com - username: your_username - password: your_password - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('swiftmailer', array( - 'transport' => "smtp", - 'encryption' => "ssl", - 'auth_mode' => "login", - 'host' => "smtp.gmail.com", - 'username' => "your_username", - 'password' => "your_password", - )); - -La mayoría de los atributos de configuración de ``SwiftMailer`` tratan con la forma en que se deben entregar los mensajes. - -Los atributos de configuración disponibles son los siguientes: - -* ``transport`` (``smtp``, ``mail``, ``sendmail`` o ``gmail``) -* ``username`` -* ``password`` -* ``host`` -* ``port`` -* ``encryption`` (``tls``, o ``ssl``) -* ``auth_mode`` (``plain``, ``login`` o ``cram-md5``) -* ``spool`` - - * ``type`` (cómo a organizar los mensajes, ``file`` o ``memory`` son compatibles, ve :doc:`/cookbook/email/spool`) - * ``path`` (dónde almacenar los mensajes) -* ``delivery_address`` (una dirección de correo electrónico de donde enviar todo el correo electrónico) -* ``disable_delivery`` (``true`` para desactivar la entrega por completo) - -Enviando correo electrónico ---------------------------- - -La biblioteca ``SwiftMailer`` trabaja creando, configurando y luego enviando objetos ``Swift_Message``. El ``«mailer»`` es responsable de la entrega real del mensaje y es accesible a través del servicio ``mailer``. En general, el envío de un correo electrónico es bastante sencillo:: - - public function indexAction($name) - { - $message = \Swift_Message::newInstance() - ->setSubject('Hello Email') - ->setFrom('send@example.com') - ->setTo('recipient@example.com') - ->setBody( - $this->renderView( - 'HelloBundle:Hello:email.txt.twig', - array('name' => $name) - ) - ) - ; - $this->get('mailer')->send($message); - - return $this->render(...); - } - -Para mantener las cosas disociadas, el cuerpo del correo electrónico se ha almacenado en una plantilla y reproducido con el método ``RenderView()``. - -El objeto ``$message`` admite muchas más opciones, como incluir archivos adjuntos, agregar contenido *HTML*, y mucho más. Afortunadamente, ``SwiftMailer`` cubre el tema con gran detalle en `Creando mensajes`_ de su documentación. - -.. tip:: - - Hay disponibles varios artículos en el recetario relacionados con el envío de mensajes de correo electrónico en *Symfony2*: - - * :doc:`gmail` - * :doc:`dev_environment` - * :doc:`spool` - -.. _`Swiftmailer`: http://swiftmailer.org/ -.. _`Creando mensajes`: http://swiftmailer.org/docs/messages.html diff --git a/_sources/cookbook/email/gmail.txt b/_sources/cookbook/email/gmail.txt deleted file mode 100644 index e016592..0000000 --- a/_sources/cookbook/email/gmail.txt +++ /dev/null @@ -1,66 +0,0 @@ -.. index:: - single: Correo electrónico; Gmail - -Cómo utilizar *Gmail* para enviar mensajes de correo electrónico -================================================================ - -Durante el desarrollo, en lugar de utilizar un servidor *SMTP* regular para enviar mensajes de correo electrónico, verás que es más fácil y más práctico utilizar *Gmail*. El paquete ``SwiftMailer`` hace que esto sea muy fácil. - -.. tip:: - - En lugar de utilizar tu cuenta normal de *Gmail*, por supuesto, recomendamos crear una cuenta especial. - -En el archivo de configuración de desarrollo, cambia el ajuste ``transport`` a ``gmail`` y establece el ``username`` y ``password`` a las credenciales de Google: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config_dev.yml - swiftmailer: - transport: gmail - username: tu_nombre_de_usuario_gmail - password: tu_contraseña_gmail - - .. code-block:: xml - - - - - - - - .. code-block:: php - - // app/config/config_dev.php - $container->loadFromExtension('swiftmailer', array( - 'transport' => "gmail", - 'username' => "tu_nombre_de_usuario_gmail", - 'password' => "tu_contraseña_gmail", - )); - -¡Ya está! - -.. tip:: - - Si estás usando la *edición estándar de Symfony*, configura los parámetros en tu archivo :file:`parameters.yml` - - .. code-block:: yaml - - # app/config/parameters.yml - parameters: - ... - mailer_transport: gmail - mailer_host: ~ - mailer_user: tu_nombre_de_usuario_gmail - mailer_password: tu_contraseña_gmail - -.. note:: - - El transporte ``gmail`` simplemente es un acceso directo que utiliza el transporte ``smtp`` y establece ``encryption``, ``auth_mode`` y ``host`` para trabajar con *Gmail*. diff --git a/_sources/cookbook/email/index.txt b/_sources/cookbook/email/index.txt deleted file mode 100644 index 37d973a..0000000 --- a/_sources/cookbook/email/index.txt +++ /dev/null @@ -1,11 +0,0 @@ -``Email`` -========= - -.. toctree:: - :maxdepth: 2 - - email - gmail - dev_environment - spool - testing diff --git a/_sources/cookbook/email/spool.txt b/_sources/cookbook/email/spool.txt deleted file mode 100644 index 2467063..0000000 --- a/_sources/cookbook/email/spool.txt +++ /dev/null @@ -1,114 +0,0 @@ -.. index:: - single: Correo electrónico; Organizando - -Cómo formar en la cola mensajes de correo electrónico -===================================================== - -Cuando estás utilizando el ``SwiftmailerBundle`` para enviar correo electrónico desde una aplicación *Symfony2*, de manera predeterminada el mensaje será enviado inmediatamente. Sin embargo, posiblemente quieras evitar el impacto en el rendimiento de la comunicación entre ``SwiftMailer`` y el transporte de correo electrónico, lo cual podría hacer que el usuario tuviera que esperar la carga de la siguiente página mientras que se envía el correo electrónico. Puedes evitar todo esto eligiendo ``«spool»``, para formar los mensajes en la cola de correo en lugar de enviarlos directamente. Esto significa que ``SwiftMailer`` no intentará enviar el correo electrónico, sino que guardará el mensaje en alguna parte, tal como un archivo. Otro proceso puede leer la cola y hacerse cargo de enviar los correos que están organizados en la cola. Actualmente sólo la organización en archivos o memoria es compatible con ``Swiftmailer``. - -Organizar usando la memoria ---------------------------- - -Cuándo organizas almacenando los mensajes de correo electrónico en memoria, conseguirás enviarlos antes de que el ``núcleo`` termine. Esto significa que el mensaje de correo será enviado si la petición entera se ejecutó sin excepción no controladas o algún error. Para configurar ``swiftmailer`` con la opción de memoria, usa la siguiente configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - swiftmailer: - # ... - spool: { type: memory } - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('swiftmailer', array( - ..., - 'spool' => array('type' => 'memory') - )); - -Organizar usando un archivo ---------------------------- - -Para utilizar la organización con un archivo, usa la siguiente configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - swiftmailer: - # ... - spool: - type: file - path: /ruta/a/spool - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('swiftmailer', array( - // ... - - 'spool' => array( - 'type' => 'file', - 'path' => '/ruta/a/spool', - ), - )); - -.. tip:: - - Si deseas almacenar la cola de correo en algún lugar en el directorio de tu proyecto, recuerda que puedes utilizar el parámetro ``%kernel.root_dir%`` para referirte a la raíz del proyecto: - - .. code-block:: yaml - - path: "%kernel.root_dir%/spool" - -Ahora, cuando tu aplicación envía un correo electrónico, no se enviará realmente, sino que se añade a la cola de correo. El envío de los mensajes desde la cola se hace por separado. -Hay una orden de consola para enviar los mensajes en la cola de correo: - -.. code-block:: bash - - $ php app/console swiftmailer:spool:send --env=prod - -Tiene una opción para limitar el número de mensajes que se enviarán: - -.. code-block:: bash - - $ php app/console swiftmailer:spool:send --message-limit=10 --env=prod - -También puedes establecer el límite de tiempo en segundos: - -.. code-block:: bash - - $ php app/console swiftmailer:spool:send --time-limit=10 --env=prod - -Por supuesto que en realidad no deseas ejecutar esto manualmente. En cambio, la orden de consola la debe activar un trabajo cronometrado o tarea programada y ejecutarse a intervalos regulares. diff --git a/_sources/cookbook/email/testing.txt b/_sources/cookbook/email/testing.txt deleted file mode 100644 index b04942d..0000000 --- a/_sources/cookbook/email/testing.txt +++ /dev/null @@ -1,68 +0,0 @@ -.. index:: - single: Correo electrónico; Probando - -Cómo verificar que se envía un mensaje de correo electrónico en una prueba funcional -==================================================================================== - -Enviar correos electrónicos con *Symfony2* es bastante sencillo gracias al ``SwiftmailerBundle``, el cual aprovecha el poder de la biblioteca `Swiftmailer`_. - -A probar funcionalmente que se envió un correo electrónico, e incluso acertar el asunto del correo electrónico, contenido o cualquiera otra cabecera, puedes utilizar el :ref:`Generador de perfiles de Symfony2 `. - -Empieza con una fácil acción del controlador que envía un correo electrónico:: - - public function sendEmailAction($name) - { - $message = \Swift_Message::newInstance() - ->setSubject('Hello Email') - ->setFrom('send@example.com') - ->setTo('recipient@example.com') - ->setBody('You should see me from the profiler!') - ; - - $this->get('mailer')->send($message); - - return $this->render(...); - } - -.. note:: - - No olvides habilitar el generador de perfiles como se explica en :doc:`/cookbook/testing/profiling`. - -En tu prueba funcional, usa el recolector ``swiftmailer`` en el generador de perfiles para conseguir la información sobre los mensajes enviados en la petición anterior:: - - // src/Acme/DemoBundle/Tests/Controller/MailControllerTest.php - use Symfony\Bundle\FrameworkBundle\Test\WebTestCase; - - class MailControllerTest extends WebTestCase - { - public function testMailIsSentAndContentIsOk() - { - $client = static::createClient(); - - // Habilita el perfilador para la próxima petición - // (no hace nada si el perfilador no está disponible) - $cliente->enableProfiler(); - - $crawler = $client->request('POST', '/path/to/above/action'); - - $mailCollector = $client->getProfile()->getCollector('swiftmailer'); - - // Comprueba que se envió un mensaje de correo electrónico - $this->assertEquals(1, $mailCollector->getMessageCount()); - - $collectedMessages = $mailCollector->getMessages(); - $message = $collectedMessages[0]; - - // Acierta los datos del correo electrónico - $this->assertInstanceOf('Swift_Message', $message); - $this->assertEquals('Hello Email', $message->getSubject()); - $this->assertEquals('send@example.com', key($message->getFrom())); - $this->assertEquals('recipient@example.com', key($message->getTo())); - $this->assertEquals( - 'You should see me from the profiler!', - $message->getBody() - ); - } - } - -.. _Swiftmailer: http://swiftmailer.org/ diff --git a/_sources/cookbook/event_dispatcher/before_after_filters.txt b/_sources/cookbook/event_dispatcher/before_after_filters.txt deleted file mode 100644 index af855f4..0000000 --- a/_sources/cookbook/event_dispatcher/before_after_filters.txt +++ /dev/null @@ -1,255 +0,0 @@ -.. index:: - single: Despachador de evento - -Cómo configurar los filtros ``before`` y ``after`` -================================================== - -Es bastante común en el desarrollo de aplicaciones *web* la necesidad de ejecutar algo de lógica justo antes o justo después de la acción actuando como filtros o ganchos. - -En *symfony1*, esto se consiguió con los métodos ``preExecute`` y ``postExecute``. -La mayoría de las plataformas importantes tienen métodos similares pero no hay tal cosa en *Symfony2*. -La buena noticia es que hay mucho mejor una manera de interferir en el proceso ``Petición -> Respuesta`` usando el :doc:`componente EventDispatcher `. - -Ejemplo de validación de ficha ------------------------------- - -Imagina que necesitas desarrollar una *API* dónde algunos controladores son públicos, pero otros se restringen a uno o algunos clientes. Por estas características particulares, podrías proporcionar una ficha a tus clientes para identificarse. - -Por lo tanto, antes de ejecutar la acción del controlador, necesitas comprobar si la acción está restringida o no. Si está restringida, necesitas validar la ficha proporcionada. - -.. note:: - - Por favor, ten en cuenta que para simplificar esta receta, las fichas se definen en la configuración y no utilizaremos ni configuración de base de datos ni proveedor de autenticación a través del componente ``Security``. - -Filtros «antes» con el evento ``kernel.controller`` ---------------------------------------------------- - -Primero, almacena alguna ficha de configuración básica usando :file:`config.yml` y parámetros clave: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - parameters: - tokens: - client1: pass1 - client2: pass2 - - .. code-block:: xml - - - - - pass1 - pass2 - - - - .. code-block:: php - - // app/config/config.php - $container->setParameter('tokens', array( - 'client1' => 'pass1', - 'client2' => 'pass2', - )); - -Comprobando etiquetas de controladores -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Un escucha del ``kernel.controller`` recibe una notificación en cada petición, justo antes de ejecutar el controlador. Por lo tanto, primero necesitas alguna manera de identificar si el controlador que responde a la petición necesita validar la ficha. - -Una forma limpia y fácil es crear una interfaz vacía y hacer que los controladores la implementen:: - - namespace Acme\DemoBundle\Controller; - - interface TokenAuthenticatedController - { - // ... - } - -Un controlador que implementa esta interfaz es similar al siguiente:: - - namespace Acme\DemoBundle\Controller; - - use Acme\DemoBundle\Controller\TokenAuthenticatedController; - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - - class FooController extends Controller implements TokenAuthenticatedController - { - // una acción que necesita autenticación - public function barAction() - { - // ... - } - } - -Creando un escucha del evento -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -A continuación, tienes que crear un escucha del evento que contenga la lógica que deseas ejecutar antes que tus controladores. Si no estás familiarizado con los escuchas de eventos, puedes aprender más sobre ellos en :doc:`/cookbook/service_container/event_listener`:: - - // src/Acme/DemoBundle/EventListener/TokenListener.php - namespace Acme\DemoBundle\EventListener; - - use Acme\DemoBundle\Controller\TokenAuthenticatedController; - use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException; - use Symfony\Component\HttpKernel\Event\FilterControllerEvent; - - class TokenListener - { - private $tokens; - - public function __construct($tokens) - { - $this->tokens = $tokens; - } - - public function onKernelController(FilterControllerEvent $event) - { - $controller = $event->getController(); - - /* - * el $controller pasado puede ser una clase o un cierre. - * Esto no es habitual en Symfony2 pero puede suceder. - * Si se trata de una clase, viene en formato de arreglo - */ - if (!is_array($controller)) { - return; - } - - if ($controller[0] instanceof TokenAuthenticatedController) { - $token = $event->getRequest()->query->get('token'); - if (!in_array($token, $this->tokens)) { - throw new AccessDeniedHttpException('This action needs a valid token!'); - } - } - } - } - -Registrando el escucha -~~~~~~~~~~~~~~~~~~~~~~ - -Por último, registra tu escucha como un servicio y etiquétalo como un escucha de eventos. -Al escuchar el ``kernel.controller``, le estas diciendo a *Symfony* que deseas que tu escucha sea llamado justo antes de ejecutar cualquier controlador: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml (o en tu services.yml) - services: - demo.tokens.action_listener: - class: Acme\DemoBundle\EventListener\TokenListener - arguments: ["%tokens%"] - tags: - - { name: kernel.event_listener, event: kernel.controller, method: onKernelController } - - .. code-block:: xml - - - - %tokens% - - - - .. code-block:: php - - // app/config/config.php (or inside your services.php) - use Symfony\Component\DependencyInjection\Definition; - - $listener = new Definition('Acme\DemoBundle\EventListener\TokenListener', array('%tokens%')); - $listener->addTag('kernel.event_listener', array( - 'event' => 'kernel.controller', - 'method' => 'onKernelController' - )); - $container->setDefinition('demo.tokens.action_listener', $listener); - -Con esta configuración, tu método ``TokenListener`` del ``onKernelController`` será ejecutado en cada petición. Si el controlador que está a punto de ejecutarse implementa el ``TokenAuthenticatedController``, se aplica la autenticación. Esto te permite tener un filtro «antes» en cualquier controlador que desees. - -Filtros «después» con el evento ``kernel.response`` ---------------------------------------------------- - -Además de tener un gancho que se ejecuta antes que tu controlador, también puedes añadir un gancho que se ejecuté «después» de tu controlador. Para este ejemplo, imagina que quieres agregar un fragmento cifrado con ``sha1`` (con cierta sal que utiliza la ficha) a todas las respuestas a la que se les pase esta ficha de autenticación. - -Otro evento del núcleo de *Symfony* ---llamado ``kernel.response``--- es notificado en cada petición, pero después de que el controlador regresa un objeto ``Respuesta``. Crear un escucha «después» es tan fácil cómo crear una clase escucha y registrarla como servicio en este evento. - -Por ejemplo, tomando el ``TokenListener`` del ejemplo anterior y grabando primero la ficha de autenticación en los atributos de la petición. Esto servirá como indicador básico de que esta petición experimentó la autenticación de la ficha:: - - public function onKernelController(FilterControllerEvent $event) - { - // ... - - if ($controller[0] instanceof TokenAuthenticatedController) { - $token = $event->getRequest()->query->get('token'); - if (!in_array($token, $this->tokens)) { - throw new AccessDeniedHttpException('This action needs a valid token!'); - } - - // marca la petición con autenticación de ficha aprobada - $event->getRequest()->attributes->set('auth_token', $token); - } - } - -Ahora, añade otro método a esta clase ---``onKernelResponse``--- que busque este indicador en el objeto ``Petición`` y de encontrarlo ponga una cabecera personalizada en la respuesta:: - - // Añade la nueva declaración use en la parte superior de tu archivo - use Symfony\Component\HttpKernel\Event\FilterResponseEvent; - - public function onKernelResponse(FilterResponseEvent $event) - { - // comprueba si onKernelController marcó este como una - // petición de ficha autenticada - if (!$token = $event->getRequest()->attributes->get('auth_token')) { - return; - } - - $response = $event->getResponse(); - - // crea un fragmento cifrado y lo pone como cabecera de la respuesta - $hash = sha1($respuesta->getContent().$token); - $response->headers->set('X-CONTENT-HASH', $hash); - } - -Finalmente, es necesaria una segunda «etiqueta» en la definición del servicio para notificar a *Symfony* que el evento ``onKernelResponse`` se tendrá que notificar al evento ``kernel.response``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml (o en tu services.yml) - services: - demo.tokens.action_listener: - class: Acme\DemoBundle\EventListener\TokenListener - arguments: ["%tokens%"] - tags: - - { name: kernel.event_listener, event: kernel.controller, method: onKernelController } - - { name: kernel.event_listener, event: kernel.response, method: onKernelResponse } - - .. code-block:: xml - - - - %tokens% - - - - - .. code-block:: php - - // app/config/config.php (or inside your services.php) - use Symfony\Component\DependencyInjection\Definition; - - $listener = new Definition('Acme\DemoBundle\EventListener\TokenListener', array('%tokens%')); - $listener->addTag('kernel.event_listener', array( - 'event' => 'kernel.controller', - 'method' => 'onKernelController' - )); - $listener->addTag('kernel.event_listener', array( - 'event' => 'kernel.response', - 'method' => 'onKernelResponse' - )); - $container->setDefinition('demo.tokens.action_listener', $listener); - -¡Eso es todo! El evento ``TokenListener`` ahora es notificado antes de ejecutar cada controlador (``onKernelController``) y después de que cada controlador regrese una respuesta (``onKernelResponse``). Al hacer que controladores específicos implementen la interfaz ``TokenAuthenticatedController``, tu escucha sabe cuales controladores deben tomar una acción. -Y almacenando un valor en la bolsa de «atributos» de la petición, el método ``onKernelResponse`` sabe que tiene que añadir la cabecera extra. ¡Que te diviertas! diff --git a/_sources/cookbook/event_dispatcher/class_extension.txt b/_sources/cookbook/event_dispatcher/class_extension.txt deleted file mode 100644 index 8dd2db5..0000000 --- a/_sources/cookbook/event_dispatcher/class_extension.txt +++ /dev/null @@ -1,121 +0,0 @@ -.. index:: - single: Despachador de evento - -Cómo extender una clase sin necesidad de utilizar herencia -========================================================== - -Para permitir que varias clases agreguen métodos a otra, puedes definir el método mágico ``__call()`` de la clase que deseas ampliar de esta manera: - -.. code-block:: php - - class Foo - { - // ... - - public function __call($method, $arguments) - { - // crea un evento llamado 'foo.method_is_not_found' - $event = new HandleUndefinedMethodEvent($this, $method, $arguments); - $this->dispatcher->dispatch('foo.method_is_not_found', $event); - - // ¿ningún escucha es capaz de procesar el evento? El método no existe - if (!$event->isProcessed()) { - throw new \Exception(sprintf('Call to undefined method %s::%s.', get_class($this), $method)); - } - - // regresa el escucha que devolvió el valor - return $event->getReturnValue(); - } - } - -Este utiliza un ``HandleUndefinedMethodEvent`` especial que también se debe crear. Esta es una clase genérica que podrías reutilizar cada vez que necesites usar este modelo para extender clases: - -.. code-block:: php - - use Symfony\Component\EventDispatcher\Event; - - class HandleUndefinedMethodEvent extends Event - { - protected $subject; - protected $method; - protected $arguments; - protected $returnValue; - protected $isProcessed = false; - - public function __construct($subject, $method, $arguments) - { - $this->asunto = $asunto; - $this->metodo = $metodo; - $this->arguments = $arguments; - } - - public function getSubject() - { - return $this->subject; - } - - public function getMethod() - { - return $this->method; - } - - public function getArguments() - { - return $this->arguments; - } - - /** - * Fija el valor a devolver y detiene la notificación a otros escuchas - */ - public function setReturnValue($val) - { - $this->returnValue = $val; - $this->isProcessed = true; - $this->stopPropagation(); - } - - public function getReturnValue($val) - { - return $this->returnValue; - } - - public function isProcessed() - { - return $this->isProcessed; - } - } - -A continuación, crea una clase que debe escuchar el evento ``foo.method_is_not_found`` y *añade* el método ``bar()``: - -.. code-block:: php - - class Bar - { - public function onFooMethodIsNotFound(HandleUndefinedMethodEvent $event) - { - // únicamente responde a las llamadas al método 'bar' - if ('bar' != $event->getMethod()) { - // permite que otro escucha se preocupe del método desconocido - return; - } - - // el objeto subject (la instancia foo) - $foo = $event->getSubject(); - - // los argumentos del método bar - $arguments = $event->getArguments(); - - // ... hace algo - - // fija el valor de retorno - $event->setReturnValue($someValue); - } - } - -Finally, add the new ``bar`` method to the ``Foo`` class by registering an -instance of ``Bar`` with the ``foo.method_is_not_found`` event: - -.. code-block:: php - - $bar = new Bar(); - $dispatcher->addListener('foo.method_is_not_found', array($bar, 'onFooMethodIsNotFound')); diff --git a/_sources/cookbook/event_dispatcher/index.txt b/_sources/cookbook/event_dispatcher/index.txt deleted file mode 100644 index 6859d90..0000000 --- a/_sources/cookbook/event_dispatcher/index.txt +++ /dev/null @@ -1,10 +0,0 @@ -Despachador de eventos -====================== - -.. toctree:: - :maxdepth: 2 - - before_after_filters - class_extension - method_behavior - \ No newline at end of file diff --git a/_sources/cookbook/event_dispatcher/method_behavior.txt b/_sources/cookbook/event_dispatcher/method_behavior.txt deleted file mode 100644 index 70e13b5..0000000 --- a/_sources/cookbook/event_dispatcher/method_behavior.txt +++ /dev/null @@ -1,49 +0,0 @@ -.. index:: - single: Despachador de evento - -Cómo personalizar el comportamiento de un método sin utilizar herencia -====================================================================== - -Haciendo algo antes o después de llamar a un método ---------------------------------------------------- - -Si quieres hacer algo justo antes o justo después de invocar a un método, puedes enviar un evento, al principio o al final del método, respectivamente:: - - class Foo - { - // ... - - public function send($foo, $bar) - { - // hace algo antes que el método - $event = new FilterBeforeSendEvent($foo, $bar); - $this->dispatcher->dispatch('foo.pre_send', $event); - - // obtiene $foo y $bar desde el evento, esto se puede modificar - $foo = $event->getFoo(); - $bar = $event->getBar(); - - // aquí va la implementación real del método - $ret = ...; - - // hace algo después del método - $event = new FilterSendReturnValue($ret); - $this->dispatcher->dispatch('foo.post_send', $event); - - return $event->getReturnValue(); - } - } - -En este ejemplo, se lanzan dos eventos: ``foo.pre_send``, antes de ejecutar el método, y ``foo.post_send`` después de ejecutar el método. Cada uno utiliza una clase Evento personalizada para comunicar información a los escuchas de los dos eventos. Estas clases de evento se tendrían que crear por ti y deben permitir que, en este ejemplo, las variables ``$foo``, ``$bar`` y ``$ret`` sean recuperadas y establecidas por los escuchas. - -Por ejemplo, suponiendo que el ``FilterSendReturnValue`` tiene un método ``setReturnValue``, un escucha puede tener este aspecto: - -.. code-block:: php - - public function onFooPostSend(FilterSendReturnValue $event) - { - $ret = $event->getReturnValue(); - // modifica el valor original de ``$ret`` - - $event->setReturnValue($ret); - } diff --git a/_sources/cookbook/form/create_custom_field_type.txt b/_sources/cookbook/form/create_custom_field_type.txt deleted file mode 100644 index 08db50c..0000000 --- a/_sources/cookbook/form/create_custom_field_type.txt +++ /dev/null @@ -1,300 +0,0 @@ -.. index:: - single: Formulario; Tipo de campo personalizado - -Cómo crear un tipo de campo personalizado para formulario -========================================================= - -*Symfony* viene con un montón de tipos de campos fundamentales para la construcción de formularios. -Sin embargo, hay situaciones en las cuales quieres crear un tipo de campo de formulario personalizado -para un propósito específico. Esta receta asume que necesitas una definición de campo que contiene el género de una persona, basándote en el campo ``choice`` existente. Esta sección explica cómo definir el campo, cómo puedes personalizar su diseño y, por último, cómo lo puedes registrar para usarlo en tu aplicación. - -Definiendo el tipo de campo ---------------------------- - -Con el fin de crear el tipo de campo personalizado, primero tienes que crear la clase que representa el campo. En esta situación, la clase contendrá el tipo de campo que se llamará ``GenderType`` y el archivo se guardará en la ubicación predeterminada para campos de formulario, la cual es ``\Form\Type``. Asegúrate de que el campo se extiende de -:class:`Symfony\\Component\\Form\\AbstractType`:: - - // src/Acme/DemoBundle/Form/Type/GenderType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class GenderType extends AbstractType - { - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'choices' => array( - 'm' => 'Male', - 'f' => 'Female', - ) - )); - } - - public function getParent() - { - return 'choice'; - } - - public function getName() - { - return 'gender'; - } - } - -.. tip:: - - La ubicación de este archivo no es importante - el directorio ``Form\Type`` sólo es una convención. - -En este caso, el valor de retorno de la función ``getParent`` indica que estas extendiendo el tipo de campo ``choice``. Esto significa que, por omisión, heredas toda la lógica y represtación de ese tipo de campo. Para ver algo de la lógica, echa un vistazo a la clase `ChoiceType`_. Hay tres métodos que son particularmente importantes: - -* ``buildForm()`` - Cada tipo de campo tiene un método ``buildForm``, que es donde configuras y construyes cualquier campo(s). Ten en cuenta que este es el mismo método que utilizas para configurar *tus* formularios, y aquí funciona igual. - -* ``buildView()`` - Este método se utiliza para establecer las variables extra que necesitarás al reproducir el campo en una plantilla. Por ejemplo, en `ChoiceType`_, está definida una variable ``multiple`` que se fija y utiliza en la plantilla para establecer (o no un conjunto), el atributo ``multiple`` en el campo ``select``. Ve `Creando una plantilla para el campo`_ para más detalles. - -* ``setDefaultOptions()`` - Define opciones para tu tipo de formulario que puedes utilizar en ``buildForm()`` y ``buildView()``. Hay un montón de opciones comunes a todos los campos (consulta :doc:`/reference/forms/types/form`), pero aquí, puedes crear cualquier otra que necesites. - -.. tip:: - - Si vas a crear un campo que consta de muchos campos, entonces, asegúrate de establecer tu tipo «padre» como ``form`` o algo que extienda a ``form``. - Además, si necesitas modificar la «vista» de cualquiera de tus tipos descendientes de tu tipo padre, usa el método ``finishView()``. - -El método ``getName()`` devuelve un identificador que debe ser único en tu aplicación. Este se utiliza en varios lugares, tales como cuando personalizas cómo será pintado tu tipo de formulario. - -El objetivo de este campo es extender el tipo ``choice`` para habilitar la selección de un género. Esto se consigue fijando las opciones a una lista de posibles géneros. - -Creando una plantilla para el campo ------------------------------------ - -Cada tipo de campo está representado por un fragmento de la plantilla, el cual se determina en parte por el valor de su método ``getName()``. Para más información, consulta :ref:`cookbook-form-customization-form-themes`. - -En este caso, debido a que el campo padre es ``choice``, no *necesitas* hacer ningún trabajo debido a que el tipo de campo personalizado automáticamente lo dibuja como el tipo ``choice``. Pero por el bien de este ejemplo, supón que al «expandir» tu campo (es decir, botones de radio o casillas de verificación, en vez de un campo de selección), lo quieres dibujar siempre en un elemento ``ul``. En la plantilla del tema de tu formulario (consulta el enlace de arriba para más detalles), crea un bloque ``gender_widget`` para manejar esto: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/DemoBundle/Resources/views/Form/fields.html.twig #} - {% block gender_widget %} - {% spaceless %} - {% if expanded %} -
      - {% for child in form %} -
    • - {{ form_widget(child) }} - {{ form_label(child) }} -
      • - {% endfor %} -
    - {% else %} - {# simplemente deja que el elemento gráfico 'choice' reproduzca la etiqueta select #} - {{ block('choice_widget') }} - {% endif %} - {% endspaceless %} - {% endblock %} - - .. code-block:: html+php - - - -
      block($form, 'widget_container_attributes') ?>> - -
    • - widget($child) ?> - label($child) ?> -
      • - -
    - - - renderBlock('choice_widget') ?> - - -.. note:: - - Asegúrate que utilizas el prefijo correcto para el elemento gráfico. En este ejemplo, el nombre debe set ``gender_widget``, de acuerdo con el valor devuelto por ``getName``. - Además, el archivo de configuración principal debe apuntar a la plantilla del formulario personalizado de modo que este se utilice al reproducir todos los formularios. - - .. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - twig: - form: - resources: - - 'AcmeDemoBundle:Form:fields.html.twig' - - .. code-block:: xml - - - - - AcmeDemoBundle:Form:fields.html.twig - - - - .. code-block:: php - - // app/config/config.php - $container->loadFromExtension('twig', array( - 'form' => array( - 'resources' => array( - 'AcmeDemoBundle:Form:fields.html.twig', - ), - ), - )); - -Usando el tipo de campo ------------------------ - -Ahora puedes utilizar el tipo de campo personalizado de inmediato, simplemente creando una nueva instancia del tipo en uno de tus formularios:: - - // src/Acme/DemoBundle/Form/Type/AuthorType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - - class AuthorType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('gender_code', new GenderType(), array( - 'empty_value' => 'Choose a gender', - )); - } - } - -Pero esto sólo funciona porque el ``GenderType()`` es muy sencillo. ¿Qué pasa si los códigos de género se almacena en la configuración o en una base de datos? La siguiente sección se explica cómo resuelven este problema los tipos de campo más complejos. - -.. _form-cookbook-form-field-service: - -Creando tu tipo de campo como un servicio ------------------------------------------ - -Hasta ahora, este artículo ha supuesto que tienes un tipo de campo personalizado muy simple. -Pero si necesitas acceder a la configuración de una conexión base de datos, o a algún otro servicio, entonces querrás registrar tu tipo personalizado como un servicio. Por ejemplo, supón que estas almacenando los parámetros de género en la configuración: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - parameters: - genders: - m: Male - f: Female - - .. code-block:: xml - - - - - Male - Female - - - - .. code-block:: php - - // app/config/config.php - $container->setParameter('genders.m', 'Male'); - $container->setParameter('genders.f', 'Female'); - -Para utilizar el parámetro, define tu tipo de campo personalizado como un servicio, inyectando el valor del parámetro ``genders`` como el primer argumento de la función ``__construct`` que vas a crear: - -.. configuration-block:: - - .. code-block:: yaml - - # src/Acme/DemoBundle/Resources/config/services.yml - services: - acme_demo.form.type.gender: - class: Acme\DemoBundle\Form\Type\GenderType - arguments: - - "%genders%" - tags: - - { name: form.type, alias: gender } - - .. code-block:: xml - - - - %genders% - - - - .. code-block:: php - - // src/Acme/DemoBundle/Resources/config/services.php - use Symfony\Component\DependencyInjection\Definition; - - $container - ->setDefinition('acme_demo.form.type.gender', new Definition( - 'Acme\DemoBundle\Form\Type\GenderType', - array('%genders%') - )) - ->addTag('form.type', array( - 'alias' => 'gender', - )) - ; - -.. tip:: - - Asegúrate de que estás importando el archivo de servicios. Consulta :ref:`service-container-imports-directive` para más detalles. - -Asegúrate de que la etiqueta del atributo ``alias`` corresponde con el valor devuelto por el método ``getName`` definido anteriormente. Verás la importancia de esto en un momento cuando utilices el tipo de campo personalizado. Pero primero, agrega un método ``__construct``, el cual recibe la configuración del género:: - - // src/Acme/DemoBundle/Form/Type/GenderType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - // ... - - // ... - class GenderType extends AbstractType - { - private $genderChoices; - - public function __construct(array $genderChoices) - { - $this->genderChoices = $genderChoices; - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'choices' => $this->genderChoices, - )); - } - - // ... - } - -¡Genial! El ``GenderType`` ahora es impulsado por los parámetros de configuración y está registrado como un servicio. Adicionalmente, debido a que utilizaste el alias ``form.type`` en tu configuración, es mucho más fácil utilizar el campo:: - - // src/Acme/DemoBundle/Form/Type/AuthorType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\FormBuilderInterface; - - // ... - - class AuthorType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('gender_code', 'gender', array( - 'empty_value' => 'Choose a gender', - )); - } - } - -Ten en cuenta que en vez de crear una nueva instancia, puedes simplemente referirte a ella -por el alias utilizado en tu configuración del servicio, ``gender``. ¡Que te diviertas! - -.. _`ChoiceType`: https://github.com/symfony/symfony/blob/master/src/Symfony/Component/Form/Extension/Core/Type/ChoiceType.php -.. _`FieldType`: https://github.com/symfony/symfony/blob/master/src/Symfony/Component/Form/Extension/Core/Type/FieldType.php diff --git a/_sources/cookbook/form/create_form_type_extension.txt b/_sources/cookbook/form/create_form_type_extension.txt deleted file mode 100644 index d471e35..0000000 --- a/_sources/cookbook/form/create_form_type_extension.txt +++ /dev/null @@ -1,279 +0,0 @@ -.. index:: - single: Formulario; Extendiendo el tipo Form - -Cómo crear una extensión del tipo «Form» -======================================== - -Los :doc:`Tipos de campo de formulario personalizados ` son buenos cuando necesitas tipos de campo con un propósito específico, tal como un selector de género, o una entrada de *RFC* (en méxico, Registro Federal de Causantes o *VAT* en los paises europeos). - -Pero a veces, en realidad no necesitas añadir nuevos tipos de campos ---deseas -agregar características en lo alto de tipos existentes---. Aquí es donde entran en juego la extensiones del tipo «Form». - -Las extensiones del tipo «Form» tienen 2 casos de uso principales: - -#. ¿Quieres añadir una **característica genérica a varios tipos** (por ejemplo, añadir un texto de «ayuda» a cada tipo de campo); -#. ¿Quieres añadir una **característica específica a un solo tipo** (tal como la adición de una característica «download» al tipo de campo «file»). - -En ambos casos, puede ser posible lograr tu objetivo personalizando la representación del formulario, o con tipos de campos de formulario personalizados. Pero usar extensiones del tipo «Form» puede ser más limpio (al limitar la cantidad de lógica del negocio en plantillas) y más flexible (puedes agregar varias extensiones de tipo a un solo tipo «form»). - -Las extensiones del tipo «Form» pueden conseguir la mayoría de los tipos de campos personalizados que puedes hacer, pero en vez de ser los tipos de campo propios, **estos se conectan a los tipos existentes**. - -Imagina que administras una entidad ``Media``, y que cada medio se asocia a un archivo. Tu formulaio ``Media`` utiliza un tipo de archivo, pero cuando editas la entidad, -te gustaría ver su imagen dibujada automáticamente junto a la entrada de archivo. - -Por supuesto, lo podrías hacer personalizando la representación de este en una -plantilla. Pero las extensiones de tipo de campo te permiten hacer esto de una manera mucho más agradable. - -Definiendo la extensión del tipo «Form» ---------------------------------------- - -Tu primera tarea será crear la clase de la extensión del tipo «Form». La llamarás ``ImageTypeExtension``. Por norma gemeral, las extensiones de «form» viven en el directorio ``Form\Extension`` de uno de tus paquetes. - -Al crear una extensión del tipo «form», puedes implementar la interfaz :class:`Symfony\\Component\\Form\\FormTypeExtensionInterface` o extender la clase :class:`Symfony\\Component\\Form\\AbstractTypeExtension`. En la mayoría de los casos, es más fácil extender la clase abstracta:: - - // src/Acme/DemoBundle/Form/Extension/ImageTypeExtension.php - namespace Acme\DemoBundle\Form\Extension; - - use Symfony\Component\Form\AbstractTypeExtension; - - class ImageTypeExtension extends AbstractTypeExtension - { - /** - * Devuelve el nombre del tipo que será extendido. - * - * @return string The name of the type being extended - */ - public function getExtendedType() - { - return 'file'; - } - } - -El único método que **necesitas** implementar es la función ``getExtendedType``. -Esta se usa para indicar el nombre del tipo «form» que será extendido -por tu extensión. - -.. tip:: - - El valor que regresas en el método ``getExtendedType`` corresponde al valor devuelto por el método ``getName`` en la clase del tipo «form» que deseas extender. - -Además de la función ``getExtendedType``, probablemente quieras sustituir uno de los siguientes métodos: - -* ``buildForm()`` - -* ``buildView()`` - -* ``setDefaultOptions()`` - -* ``finishView()`` - -Para más información sobre que hacen estos métodos, puedes referirte al artículo -:doc:`Creando tipos de campo personalizados ` en el recetario. - -Registrando como servicio tu extensión del tipo «Form» ------------------------------------------------------- - -El siguiente paso es dar a conocer tu extensión a *Symfony*. Todo lo que tienes que hacer es declararla como un servicio utilizando la etiqueta ``form.type_extension``: - -.. configuration-block:: - - .. code-block:: yaml - - services: - acme_demo_bundle.image_type_extension: - class: Acme\DemoBundle\Form\Extension\ImageTypeExtension - tags: - - { name: form.type_extension, alias: file } - - .. code-block:: xml - - - - - - .. code-block:: php - - $container - ->register( - 'acme_demo_bundle.image_type_extension', - 'Acme\DemoBundle\Form\Extension\ImageTypeExtension' - ) - ->addTag('form.type_extension', array('alias' => 'file')); - -La clave ``alias`` de la etiqueta es el tipo de campo al que esta extensión se debe aplicar. En tu caso, cuando quieras extender el tipo de campo ``file``, utilizarás ``file`` como un alias. - -Añadiendo lógica del negocio a la extensión -------------------------------------------- - -El objetivo de tu extensión es mostrar bonitas imágenes junto a las entradas de archivo (cuándo el modelo subyacente contenga imágenes). Para ese propósito, supón que utilizas un enfoque similar al descrito en artículo -:doc:`Cómo manejar archivos subidos con Doctrine `: -Tienes un modelo de Medios con una propiedad ``file`` (correspondiente al campo de archivo en el formulario) y una propiedad ``path`` (correspondiente a la ruta de la imagen en la base de datos):: - - // src/Acme/DemoBundle/Entity/Media.php - namespace Acme\DemoBundle\Entity; - - use Symfony\Component\Validator\Constraints as Assert; - - class Media - { - // ... - - /** - * @var string The path - typically stored in the database - */ - private $path; - - /** - * @var \Symfony\Component\HttpFoundation\File\UploadedFile - * @Assert\File(maxSize="2M") - */ - public $file; - - // ... - - /** - * Obtiene la url de la imagen - * - * @return null|string - */ - public function getWebPath() - { - // ... $webPath comienza la url completa de la imagen, para utilizarla en plantillas - - return $webPath; - } - } - -Tu clase de la extensión del tipo «form» deberá hacer dos cosas para extender -el tipo ``file`` de «form»: - -#. Sustituye el método ``setDefaultOptions`` con el fin de añadir una opción ``image_path``; -#. Sustituye los métodos ``buildForm`` y ``buildView`` para pasar la *URL* de la imagen a la vista. - -La lógica es la siguiente: cuándo añades un campo de tipo ``file`` al formulario, serás capaz de especificar una nueva opción: ``image_path``. Esta opción dirá al campo ``file`` cómo conseguir la *URL* real de la imagen para mostrarla en la vista:: - - // src/Acme/DemoBundle/Form/Extension/ImageTypeExtension.php - namespace Acme\DemoBundle\Form\Extension; - - use Symfony\Component\Form\AbstractTypeExtension; - use Symfony\Component\Form\FormView; - use Symfony\Component\Form\FormInterface; - use Symfony\Component\PropertyAccess\PropertyAccess; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class ImageTypeExtension extends AbstractTypeExtension - { - /** - * Devuelve el nombre del tipo que será extendido. - * - * @return string The name of the type being extended - */ - public function getExtendedType() - { - return 'file'; - } - - /** - * Añade la opción image_path - * - * @param OptionsResolverInterface $resolver - */ - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setOptional(array('image_path')); - } - - /** - * Pase la URL de la imagen a la vista - * - * @param FormView $view - * @param FormInterface $form - * @param array $options - */ - public function buildView(FormView $view, FormInterface $form, array $options) - { - if (array_key_exists('image_path', $options)) { - $parentData = $form->getParent()->getData(); - - if (null !== $parentData) { - $accessor = PropertyAccess::getPropertyAccessor(); - $imageUrl = $accessor->getValue($parentData, $options['image_path']); - } else { - $imageUrl = null; - } - - // configura una variable "image_url" que debe estar disponible al dibujar este campo - $view->set('image_url', $imageUrl); - } - } - - } - -Sustituye el elemento gráfico del fragmento de plantilla --------------------------------------------------------- - -Cada tipo de campo es dibujado por un fragmento de plantilla. Estos fragmentos de plantilla se pueden sustituir para personalizar la forma de dibujarlo. Para más información, puedes referirte al artículo :ref:`cookbook-form-customization-form-themes`. - -En tu clase de la extensión, añadiste una nueva variable (``image_url``), pero -todavía necesitas aprovechar en tus plantillas esta nueva variable. -Específicamente, necesitas sustituir el bloque ``file_widget``: - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/DemoBundle/Resources/views/Form/fields.html.twig #} - {% extends 'form_div_layout.html.twig' %} - - {% block file_widget %} - {% spaceless %} - - {{ block('form_widget') }} - {% if image_url is not null %} - - {% endif %} - - {% endspaceless %} - {% endblock %} - - .. code-block:: html+php - - - widget($form) ?> - - - - -.. note:: - - Necesitarás cambiar tu archivo «config» o especificar explícitamente cómo quieres tematizar tu formulario a fin de que *Symfony* utilice tu bloque redefinido. Ve :ref:`cookbook-form-customization-form-themes` para más información. - -Usando la extensión del tipo «Form» ------------------------------------ - -De ahora en adelante, cuándo añadas un campo de tipo ``file`` a tu formulario, puedes especificar una opción ``image_path`` que será la imagen a mostrar junto al campo de archivo. Por ejemplo:: - - // src/Acme/DemoBundle/Form/Type/MediaType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - - class MediaType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder - ->add('name', 'text') - ->add('file', 'file', array('image_path' => 'webPath')); - } - - public function getName() - { - return 'media'; - } - } - -Cuándo muestres el formulario, si el modelo subyacente ya fue asociado con una imagen, la verás junto a la entrada de archivo. diff --git a/_sources/cookbook/form/data_transformers.txt b/_sources/cookbook/form/data_transformers.txt deleted file mode 100644 index e89883f..0000000 --- a/_sources/cookbook/form/data_transformers.txt +++ /dev/null @@ -1,317 +0,0 @@ -.. index:: - single: Formulario; Transformadores de datos - -Cómo usar transformadores de datos -================================== - -A menudo te encontrarás con la necesidad de transformar en alguna otra cosa los datos que el usuario introdujo en un formulario para usarlos en tu programa. Lo podrías hacer fácilmente a mano en tu controlador, pero, ¿qué pasa si quieres utilizar ese formulario específico en diferentes sitios? - -Digamos que tienes una relación uno a uno entre una ``Tarea`` y una ``Incidencia``, por ejemplo, una ``Tarea`` opcionalmente está vinculada a una ``Incidencia``. Añadir un cuadro de lista con todas las posibles ``Incidencias`` finalmente te puede conducir a una lista realmente larga en la cual es imposible encontrar algo. En su lugar mejor querrás añadir un cuadro de texto, en el cual el usuario sencillamente puede introducir el número de la incidencia. - -Podrías intentar hacer esto en tu controlador, pero no es la mejor solución. -Sería mejor si esta incidencia se buscara y convirtiera automáticamente a un objeto ``Incidencia``, para usarla en tu acción. -Aquí es donde entran en juego los Transformadores de datos. - -Creando el transformador ------------------------- - -En primer lugar, crea una clase ``IssueToNumberTransformer`` --- esta clase será la responsable de la conversión hacia y desde el número de incidencia y el objeto ``Incidencia``:: - - // src/Acme/TaskBundle/Form/DataTransformer/IssueToNumberTransformer.php - namespace Acme\TaskBundle\Form\DataTransformer; - - use Symfony\Component\Form\DataTransformerInterface; - use Symfony\Component\Form\Exception\TransformationFailedException; - use Doctrine\Common\Persistence\ObjectManager; - use Acme\TaskBundle\Entity\Issue; - - class IssueToNumberTransformer implements DataTransformerInterface - { - /** - * @var ObjectManager - */ - private $om; - - /** - * @param ObjectManager $om - */ - public function __construct(ObjectManager $om) - { - $this->om = $om; - } - - /** - * Transforma un objeto (``issue``) a una cadena (``number``). - * - * @param Issue|null $issue - * @return string - */ - public function transform($issue) - { - if (null === $issue) { - return ""; - } - - return $issue->getNumber(); - } - - /** - * Transforma una cadena (``number``) a un objeto (``issue``). - * - * @param string $number - * - * @return Issue|null - * - * @throws TransformationFailedException si no encuentra el objeto (issue). - */ - public function reverseTransform($number) - { - if (!$number) { - return null; - } - - $issue = $this->om - ->getRepository('AcmeTaskBundle:Issue') - ->findOneBy(array('number' => $number)) - ; - - if (null === $issue) { - throw new TransformationFailedException(sprintf( - 'An issue with number "%s" does not exist!', - $number - )); - } - - return $issue; - } - } - -.. tip:: - - Si quieres crear una nueva incidencia al introducir un número desconocido, puedes crear una nueva instancia en lugar de lanzar una ``TransformationFailedException``. - -Usando el transformador ------------------------ - -Ahora que ya tienes incorporado el transformador, solamente lo tienes que añadir a tu campo ``incidencia`` en algún formulario. - - También puedes utilizar transformadores sin necesidad de crear un nuevo tipo de formulario personalizado llamando a ``addModelTransformer`` (o a ``addViewTransformer`` --- consulta la sección `Transformadores de modelo y vista`_) en cualquier campo del constructor:: - - use Symfony\Component\Form\FormBuilderInterface; - use Acme\TaskBundle\Form\DataTransformer\IssueToNumberTransformer; - - class TaskType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - // ... - - // este asume que el gestor de la entidad se pasó como una - // opción - $entityManager = $options['em']; - $transformer = new IssueToNumberTransformer($entityManager); - - // agrega un campo de texto normal, pero le añade tu transformador - $builder->add( - $builder->create('issue', 'text') - ->addModelTransformer($transformer) - ); - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\TaskBundle\Entity\Task', - )); - - $resolver->setRequired(array( - 'em', - )); - - $resolver->setAllowedTypes(array( - 'em' => 'Doctrine\Common\Persistence\ObjectManager', - )); - - // ... - } - - // ... - } - -Este ejemplo requiere que pases como una opción el gestor de la entidad al crear el formulario. Más tarde, aprenderás cómo puedes crear un tipo de campo ``incidencia`` personalizado para evitar la necesidad de hacer esto en tu controlador:: - - $taskForm = $this->createForm(new TaskType(), $task, array( - 'em' => $this->getDoctrine()->getEntityManager(), - )); - -¡Estupendo, ya está! El usuario será capaz de introducir un número de incidencia en el campo de texto y se transformará en un objeto ``Incidencia``. Esto significa que, después de vincularlo satisfactoriamente, la infraestructura del formulario pasa un objeto ``Incidencia`` real a ``Task::setIssue()`` en vez de el número de incidencia. - -Si no encuentra la incidencia, creará un error en el formulario para ese campo y puedes controlar su mensaje de error con la opción ``invalid_message`` del campo. - -.. caution:: - - Ten en cuenta que al añadir un transformador necesitas usar una sintaxis un poco más complicada cuando agregas el campo. Lo siguiente es **incorrecto**, debido a que puedes aplicar el transformador a todo el formulario, en lugar de sólo a este campo:: - - // ESTE ESTÁ MAL - LA TRANSFORMACIÓN SE APLICARÁ AL - // FORMULARIO COMPLETO - // ve el código correcto en el ejemplo anterior - $builder->add('issue', 'text') - ->addModelTransformer($transformer); - -Transformadores de modelo y vista -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - Los nombres y métodos de los transformadores cambiaron en *Symfony 2.1*. - ``prependNormTransformer`` se convirtió en ``addModelTransformer`` y ``appendClientTransformer`` cambió a ``addViewTransformer``. - -En el ejemplo anterior, el transformador se utilizó como un transformador del ``«modelo»``. -De hecho, hay dos diferentes tipos de transformadores y tres diferentes tipos de datos subyacentes. - -.. image:: /images/cookbook/form/DataTransformersTypes.png - :align: center - -En cualquier formulario, los 3 diferentes tipos de datos son los siguientes: - -1) **Datos del modelo** --- Estos son los datos en el formato que se utiliza en tu aplicación (por ejemplo, un objeto ``Insidencia``). Si llamas a ``Form::getData`` o ``Form::setData``, estás tratando con los datos del «modelo». - -2) **Datos normales** --- Esta es una versión normalizada de los datos, y suelen ser los mismos datos que los de tu «modelo» (aunque no en nuestro ejemplo). Comúnmente no se utiliza directamente. - -3) **Datos de la vista** --- Este es el formato que se utiliza para rellenar los campos del formulario en sí. También es el formato en el que el usuario enviará los datos. Cuando llamas a ``Form::bind($datos)``, los ``$datos`` están en el formato de la «vista». - -Los 2 diferentes tipos de transformadores te ayudan a convertir hacia y desde cada uno de estos tipos de datos: - -**transformadores del modelo**: - --- ``transform``: "datos del modelo" => "datos normales" - --- ``reverseTransform``: "datos normales" => "datos del modelo" - -**Transformadores de la vista**: - --- ``transform``: "datos normales" => "datos de la vista" - --- ``reverseTransform``: "datos de la vista" => "datos normales" - -¿Qué transformador necesitas? depende de tu situación. - -Para utilizar el transformador de la vista, llama a ``addViewTransformer``. - -¿Así que por qué uso el modelo transformador? ---------------------------------------------- - -En este ejemplo, el campo es un campo ``text``, y un campo de texto siempre se espera que sea un sencillo, formato escalar en los formatos ``norm`` y ``view``. Por esta razón, el transformador más adecuado fue el transformador del «modelo» (que se convierte a/desde el formato *normal* --- cadena a número --- al formato del *modelo* --- emisión de objeto). - -La diferencia entre los transformadores es sutil y siempre se debe pensar en lo que deben ser realmente los datos «normales» para un campo. Por ejemplo, los datos «normales» de un campo ``text`` son una cadena, pero es un objeto ``DateTime`` para un campo ``date``. - -Usando transformadores en un tipo de campo personalizado --------------------------------------------------------- - -En el ejemplo anterior, aplicaste el transformador a un campo ``text`` normal. -Esto fue fácil, pero tiene dos inconvenientes: - -1) Necesitas recordar siempre que debes aplicar el transformador cuando vas a añadir un campo de número de incidencia. - -2) Tienes que preocuparte de pasarlo en la opción ``em`` cada vez que creas un formulario que utiliza el transformador. - -Debido a esto, puedes optar por :doc:`crear un tipo de campo personalizado `. -En primer lugar, crea la clase del tipo de campo personalizado:: - - // src/Acme/TaskBundle/Form/Type/IssueSelectorType.php - namespace Acme\TaskBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Acme\TaskBundle\Form\DataTransformer\IssueToNumberTransformer; - use Doctrine\Common\Persistence\ObjectManager; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class IssueSelectorType extends AbstractType - { - /** - * @var ObjectManager - */ - private $om; - - /** - * @param ObjectManager $om - */ - public function __construct(ObjectManager $om) - { - $this->om = $om; - } - - public function buildForm(FormBuilderInterface $builder, array $options) - { - $transformer = new IssueToNumberTransformer($this->om); - $builder->addModelTransformer($transformer); - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'invalid_message' => 'The selected issue does not exist', - )); - } - - public function getParent() - { - return 'text'; - } - - public function getName() - { - return 'issue_selector'; - } - } - -A continuación, registra el tipo como un servicio y etiquétalo con ``form.type``, para que sea reconocido como un tipo de campo personalizado: - -.. configuration-block:: - - .. code-block:: yaml - - services: - acme_demo.type.issue_selector: - class: Acme\TaskBundle\Form\Type\IssueSelectorType - arguments: ["@doctrine.orm.entity_manager"] - tags: - - { name: form.type, alias: issue_selector } - - .. code-block:: xml - - - - - - - .. code-block:: php - - $container - ->setDefinition('acme_demo.type.issue_selector', array( - new Reference('doctrine.orm.entity_manager'), - )) - ->addTag('form.type', array( - 'alias' => 'issue_selector', - )) - ; - -Ahora, cada vez que necesites utilizar tu tipo de campo ``issue_selector`` especial, es muy fácil:: - - // src/Acme/TaskBundle/Form/Type/TaskType.php - namespace Acme\TaskBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - - class TaskType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder - ->add('task') - ->add('dueDate', null, array('widget' => 'single_text')); - ->add('issue', 'issue_selector'); - } - - public function getName() - { - return 'task'; - } - } diff --git a/_sources/cookbook/form/dynamic_form_generation.txt b/_sources/cookbook/form/dynamic_form_generation.txt deleted file mode 100644 index c7b3050..0000000 --- a/_sources/cookbook/form/dynamic_form_generation.txt +++ /dev/null @@ -1,129 +0,0 @@ -.. index:: - single: Formulario; Eventos - -Cómo generar formularios dinámicamente usando eventos del formulario -==================================================================== - -Antes de zambullirte en la generación dinámica de formularios, hagamos una rápida revisión de lo que es una clase formulario desnuda:: - - // src/Acme/DemoBundle/Form/Type/ProductType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - - class ProductType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('name'); - $builder->add('price'); - } - - public function getName() - { - return 'product'; - } - } - -.. note:: - - Si esta sección de código en particular no te es familiar, probablemente necesites dar un paso atrás y revisar en primer lugar el :doc:`Capítulo de Formularios ` antes de continuar. - -Asumiremos por un momento que este formulario utiliza una clase imaginaria ``«Product»`` que únicamente tiene dos propiedades relevantes (``name`` y ``price``). El formulario generado de esta clase a toda costa se verá exactamente igual si estás creando un nuevo Producto o si estás editando un producto existente (p. ej. un producto recuperado de la base de datos). - -Ahora, supongamos que no deseas que el usuario pueda cambiar el valor del ``name`` una vez creado el objeto. Para ello, puedes confiar en el sistema :doc:`Despachador de eventos ` de *Symfony* para analizar los datos en el objeto y modificar el formulario basándose en los datos del objeto ``Producto``. En este artículo, aprenderás cómo añadir este nivel de flexibilidad a tus formularios. - -.. _`cookbook-forms-event-subscriber`: - -Añadiendo un suscriptor de evento a una clase formulario --------------------------------------------------------- - -Por lo tanto, en lugar de añadir directamente el elemento gráfico ``name`` vía tu clase formulario ``ProductType``, vas a delegar la responsabilidad de crear este campo en particular a un suscriptor de evento:: - - // src/Acme/DemoBundle/Form/Type/ProductType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Acme\DemoBundle\Form\EventListener\AddNameFieldSubscriber; - - class ProductType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('price'); - - $builder->addEventSubscriber(new AddNameFieldSubscriber()); - } - - public function getName() - { - return 'product'; - } - } - -.. _`cookbook-forms-inside-subscriber-class`: - -Dentro de la clase suscriptor de eventos ----------------------------------------- - -El objetivo es crear el campo ``«name»`` *únicamente* si el objeto ``Producto`` subyacente es nuevo (por ejemplo, no se ha persistido a la base de datos). Basándose en esto, el suscriptor podría tener la siguiente apariencia: - -.. versionadded:: 2.2 - La habilidad de pasar una cadena al método :method:`FormInterface::add ` se añadió en *Symfony 2.2*. - -.. code-block:: php - - // src/Acme/DemoBundle/Form/EventListener/AddNameFieldSubscriber.php - namespace Acme\DemoBundle\Form\EventListener; - - use Symfony\Component\Form\FormEvent; - use Symfony\Component\Form\FormEvents; - use Symfony\Component\EventDispatcher\EventSubscriberInterface; - - class AddNameFieldSubscriber implements EventSubscriberInterface - { - public static function getSubscribedEvents() - { - // Informa al despachador que deseas escuchar el evento - // form.pre_set_data y se debe llamar al método 'preSetData'. - return array(FormEvents::PRE_SET_DATA => 'preSetData'); - } - - public function preSetData(FormEvent $event) - { - $data = $event->getData(); - $form = $event->getForm(); - - // Durante la creación del formulario setData() es llamado con null como - // argumento por el constructor FormBuilder. Solo te interesa cuando - // setData es llamado con un objeto Entity real (ya sea nuevo, - // o recuperado con Doctrine). Esta declaración 'if' permite evadir - // la condición null. - if (null === $data) { - return; - } - - // comprueba si el objeto producto es "nuevo" - if (!$data->getId()) { - $form->add('name', 'text'); - } - } - } - -.. caution:: - - Es fácil malinterpretar el propósito del segmento ``if (null === $data)`` de este suscriptor de eventos. Para comprender plenamente su papel, también podrías considerar echarle un vistazo a la `clase Form`_ prestando especial atención a donde se llama a ``setData()`` al final del constructor, así como al método ``setData()`` en sí mismo. - -La línea ``FormEvents::PRE_SET_DATA`` en realidad se resuelve en la cadena ``form.pre_set_data``. -La `clase FormEvents`_ sirve a un propósito organizacional. Se trata de una ubicación centralizada en la cual puedes encontrar todos los eventos de formulario disponibles. - -Si bien este ejemplo podría haber utilizado eficientemente el evento ``form.post_set_data``, al usar ``form.pre_set_data`` garantizas que el dato recuperado desde el objeto ``Event`` no tiene manera alguna de ser modificado por ningún otro suscriptor o escucha debido a que ``form.pre_set_data`` es el primer evento remitido por el formulario. - -.. note:: - - Puedes ver la lista completa de eventos de formulario vía la `clase FormEvents`_, del paquete ``form``. - -.. _`clase FormEvents`: https://github.com/symfony/Form/blob/master/FormEvents.php -.. _`clase Form`: https://github.com/symfony/symfony/blob/master/src/Symfony/Component/Form/Form.php diff --git a/_sources/cookbook/form/dynamic_form_modification.txt b/_sources/cookbook/form/dynamic_form_modification.txt deleted file mode 100644 index 61f4f98..0000000 --- a/_sources/cookbook/form/dynamic_form_modification.txt +++ /dev/null @@ -1,609 +0,0 @@ -.. index:: - single: Formulario; Eventos - -How to Dynamically Modify Forms Using Form Events -================================================= - -Often times, a form can't be created statically. In this entry, you'll learn -how to customize your form based on three common use-cases: - -1) :ref:`cookbook-form-events-underlying-data` - -Ejemplo: you have a "Product" form and need to modify/add/remove a field -based on the data on the underlying Product being edited. - -2) :ref:`cookbook-form-events-user-data` - -Ejemplo: you create a "Friend Message" form and need to build a drop-down -that contains only users that are friends with the *current* authenticated -user. - -3) :ref:`cookbook-form-events-submitted-data` - -Ejemplo: on a registration form, you have a "country" field and a "state" -field which should populate dynamically based on the value in the "country" -field. - -.. _cookbook-form-events-underlying-data: - -Customizing your Form based on the underlying Data --------------------------------------------------- - -Antes de zambullirte en la generación dinámica de formularios, hagamos una rápida revisión de lo que es una clase formulario desnuda:: - - // src/Acme/DemoBundle/Form/Type/ProductType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class ProductType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('name'); - $builder->add('price'); - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\DemoBundle\Entity\Product' - )); - } - - public function getName() - { - return 'product'; - } - } - -.. note:: - - Si esta sección de código en particular no te es familiar, probablemente necesites dar un paso atrás y en primer lugar revisar el :doc:`Capítulo de formularios ` antes de continuar. - -Assume for a moment that this form utilizes an imaginary "Product" class -that has only two properties ("name" and "price"). The form generated from -this class will look the exact same regardless if a new Product is being created -or if an existing product is being edited (e.g. a product fetched from the database). - -Ahora, supongamos que no deseas que el usuario pueda cambiar el valor del ``name`` una vez creado el objeto. Para ello, puedes confiar en el sistema :doc:`Despachador de eventos ` de *Symfony* para analizar los datos en el objeto y modificar el formulario basándote en los datos del objeto ``Producto``. En este artículo, aprenderás cómo añadir este nivel de flexibilidad a tus formularios. - -.. _`cookbook-forms-event-subscriber`: - -Adding An Event Subscriber To A Form Class -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Por lo tanto, en lugar de añadir directamente el elemento gráfico ``name`` vía tu clase formulario ``ProductType``, vas a delegar la responsabilidad de crear este campo en particular a un suscriptor de evento:: - - // src/Acme/DemoBundle/Form/Type/ProductType.php - namespace Acme\DemoBundle\Form\Type; - - // ... - use Acme\DemoBundle\Form\EventListener\AddNameFieldSubscriber; - - class ProductType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('price'); - - $builder->addEventSubscriber(new AddNameFieldSubscriber()); - } - - // ... - } - -.. _`cookbook-forms-inside-subscriber-class`: - -Inside the Event Subscriber Class -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El objetivo es crear el campo ``«name»`` *únicamente* si el objeto ``Producto`` subyacente es nuevo (por ejemplo, no se ha persistido a la base de datos). Basándose en esto, el suscriptor podría tener la siguiente apariencia: - -.. versionadded:: 2.2 - La habilidad de pasar una cadena al método :method:`FormInterface::add ` se añadió en *Symfony 2.2*. - -.. code-block:: php - - // src/Acme/DemoBundle/Form/EventListener/AddNameFieldSubscriber.php - namespace Acme\DemoBundle\Form\EventListener; - - use Symfony\Component\Form\FormEvent; - use Symfony\Component\Form\FormEvents; - use Symfony\Component\EventDispatcher\EventSubscriberInterface; - - class AddNameFieldSubscriber implements EventSubscriberInterface - { - public static function getSubscribedEvents() - { - // Informa al despachador que deseas escuchar el evento - // form.pre_set_data y se debe llamar al método 'preSetData'. - return array(FormEvents::PRE_SET_DATA => 'preSetData'); - } - - public function preSetData(FormEvent $event) - { - $data = $event->getData(); - $form = $event->getForm(); - - // check if the product object is "new" - // If you didn't pass any data to the form, the data is "null". - // This should be considered a new "Product" - if (!$data || !$data->getId()) { - $form->add('name', 'text'); - } - } - } - -.. tip:: - - The ``FormEvents::PRE_SET_DATA`` line actually resolves to the string - ``form.pre_set_data``. :class:`Symfony\\Component\\Form\\FormEvents` serves - an organizational purpose. It is a centralized location in which you can - find all of the various form events available. - -.. note:: - - You can view the full list of form events via the :class:`Symfony\\Component\\Form\\FormEvents` - class. - -.. _cookbook-form-events-user-data: - -How to Dynamically Generate Forms based on user Data ----------------------------------------------------- - -Sometimes you want a form to be generated dynamically based not only on data -from the form but also on something else - like some data from the current user. -Suppose you have a social website where a user can only message people who -are his friends on the website. In this case, a "choice list" of whom to message -should only contain users that are the current user's friends. - -Creating the Form Type -~~~~~~~~~~~~~~~~~~~~~~ - -Using an event listener, your form might look like this:: - - // src/Acme/DemoBundle/Form/Type/FriendMessageFormType.php - namespace Acme\DemoBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Symfony\Component\Form\FormEvents; - use Symfony\Component\Form\FormEvent; - use Symfony\Component\Security\Core\SecurityContext; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class FriendMessageFormType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder - ->add('subject', 'text') - ->add('body', 'textarea') - ; - $builder->addEventListener(FormEvents::PRE_SET_DATA, function(FormEvent $event){ - // ... add a choice list of friends of the current application user - }); - } - - public function getName() - { - return 'acme_friend_message'; - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - } - } - -The problem is now to get the current user and create a choice field that -contains only this user's friends. - -Luckily it is pretty easy to inject a service inside of the form. This can be -done in the constructor:: - - private $securityContext; - - public function __construct(SecurityContext $securityContext) - { - $this->securityContext = $securityContext; - } - -.. note:: - - You might wonder, now that you have access to the User (through the security - context), why not just use it directly in ``buildForm`` and omit the - event listener? This is because doing so in the ``buildForm`` method - would result in the whole form type being modified and not just this - one form instance. This may not usually be a problem, but technically - a single form type could be used on a single request to create many forms - or fields. - -Customizing the Form Type -~~~~~~~~~~~~~~~~~~~~~~~~~ - -Now that you have all the basics in place you an take advantage of the ``securityContext`` -and fill in the listener logic:: - - // src/Acme/DemoBundle/FormType/FriendMessageFormType.php - - use Symfony\Component\Security\Core\SecurityContext; - use Doctrine\ORM\EntityRepository; - // ... - - class FriendMessageFormType extends AbstractType - { - private $securityContext; - - public function __construct(SecurityContext $securityContext) - { - $this->securityContext = $securityContext; - } - - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder - ->add('subject', 'text') - ->add('body', 'textarea') - ; - - // grab the user, do a quick sanity check that one exists - $user = $this->securityContext->getToken()->getUser(); - if (!$user) { - throw new \LogicException( - 'The FriendMessageFormType cannot be used without an authenticated user!' - ); - } - - $factory = $builder->getFormFactory(); - - $builder->addEventListener( - FormEvents::PRE_SET_DATA, - function(FormEvent $event) use($user, $factory){ - $form = $event->getForm(); - - $formOptions = array( - 'class' => 'Acme\DemoBundle\Entity\User', - 'multiple' => false, - 'expanded' => false, - 'property' => 'fullName', - 'query_builder' => function(EntityRepository $er) use ($user) { - // build a custom query, or call a method on your repository (even better!) - }, - ); - - // create the field, this is similar the $builder->add() - // field name, field type, data, options - $form->add($factory->createNamed('friend', 'entity', null, $formOptions)); - } - ); - } - - // ... - } - -Using the Form -~~~~~~~~~~~~~~ - -Our form is now ready to use and there are two possible ways to use it inside -of a controller: - -a) create it manually and remember to pass the security context to it; - -o - -b) define it as a service. - -a) Creating the Form manually -............................. - -This is very simple, and is probably the better approach unless you're using -your new form type in many places or embedding it into other forms:: - - class FriendMessageController extends Controller - { - public function newAction(Request $request) - { - $securityContext = $this->container->get('security.context'); - $form = $this->createForm( - new FriendMessageFormType($securityContext) - ); - - // ... - } - } - -b) Defining the Form as a Service -................................. - -To define your form as a service, just create a normal service and then tag -it with :ref:`dic-tags-form-type`. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - services: - acme.form.friend_message: - class: Acme\DemoBundle\Form\Type\FriendMessageFormType - arguments: [@security.context] - tags: - - - name: form.type - alias: acme_friend_message - - .. code-block:: xml - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $definition = new Definition('Acme\DemoBundle\Form\Type\FriendMessageFormType'); - $definition->addTag('form.type', array('alias' => 'acme_friend_message')); - $container->setDefinition( - 'acme.form.friend_message', - $definition, - array('security.context') - ); - -If you wish to create it from within a controller or any other service that has -access to the form factory, you then use:: - - class FriendMessageController extends Controller - { - public function newAction(Request $request) - { - $form = $this->createForm('acme_friend_message'); - - // ... - } - } - -You can also easily embed the form type into another form:: - - // inside some other "form type" class - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('message', 'acme_friend_message'); - } - -.. _cookbook-form-events-submitted-data: - -Dynamic generation for submitted Forms --------------------------------------- - -Another case that can appear is that you want to customize the form specific to -the data that was submitted by the user. For example, imagine you have a registration -form for sports gatherings. Some events will allow you to specify your preferred -position on the field. This would be a ``choice`` field for example. However the -possible choices will depend on each sport. Football will have attack, defense, -goalkeeper etc... Baseball will have a pitcher but will not have goalkeeper. You -will need the correct options to be set in order for validation to pass. - -The meetup is passed as an entity hidden field to the form. So we can access each -sport like this:: - - // src/Acme/DemoBundle/Form/Type/SportMeetupType.php - class SportMeetupType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder - ->add('number_of_people', 'text') - ->add('discount_coupon', 'text') - ; - $factory = $builder->getFormFactory(); - - $builder->addEventListener( - FormEvents::PRE_SET_DATA, - function(FormEvent $event) use($user, $factory){ - $form = $event->getForm(); - - // this would be your entity, i.e. SportMeetup - $data = $event->getData(); - - $positions = $data->getSport()->getAvailablePositions(); - - // ... proceed with customizing the form based on available positions - } - ); - } - } - -When you're building this form to display to the user for the first time, -then this example works perfectly. - -However, things get more difficult when you handle the form submission. This -is be cause the ``PRE_SET_DATA`` event tells us the data that you're starting -with (e.g. an empty ``SportMeetup`` object), *not* the submitted data. - -On a form, we can usually listen to the following events: - -* ``PRE_SET_DATA`` -* ``POST_SET_DATA`` -* ``PRE_BIND`` -* ``BIND`` -* ``POST_BIND`` - -When listening to ``BIND`` and ``POST_BIND``, it's already "too late" to make -changes to the form. Fortunately, ``PRE_BIND`` is perfect for this. There -is, however, a big difference in what ``$event->getData()`` returns for each -of these events. Specifically, in ``PRE_BIND``, ``$event->getData()`` returns -the raw data submitted by the user. - -This can be used to get the ``SportMeetup`` id and retrieve it from the database, -given you have a reference to the object manager (if using doctrine). In -the end, you have an event subscriber that listens to two different events, -requires some external services and customizes the form. In such a situation, -it's probably better to define this as a service rather than using an anonymouse -function as the event listener callback. - -The subscriber would now look like:: - - // src/Acme/DemoBundle/Form/EventListener/RegistrationSportListener.php - namespace Acme\DemoBundle\Form\EventListener; - - use Symfony\Component\Form\FormFactoryInterface; - use Doctrine\ORM\EntityManager; - use Symfony\Component\Form\FormEvent; - - class RegistrationSportListener implements EventSubscriberInterface - { - /** - * @var FormFactoryInterface - */ - private $factory; - - /** - * @var EntityManager - */ - private $om; - - /** - * @param factory FormFactoryInterface - */ - public function __construct(FormFactoryInterface $factory, EntityManager $om) - { - $this->factory = $factory; - $this->om = $om; - } - - public static function getSubscribedEvents() - { - return array( - FormEvents::PRE_BIND => 'preBind', - FormEvents::PRE_SET_DATA => 'preSetData', - ); - } - - /** - * @param event FormEvent - */ - public function preSetData(FormEvent $event) - { - $meetup = $event->getData()->getMeetup(); - - // Before binding the form, the "meetup" will be null - if (null === $meetup) { - return; - } - - $form = $event->getForm(); - $positions = $meetup->getSport()->getPositions(); - - $this->customizeForm($form, $positions); - } - - public function preBind(FormEvent $event) - { - $data = $event->getData(); - $id = $data['event']; - $meetup = $this->om - ->getRepository('AcmeDemoBundle:SportMeetup') - ->find($id); - - if ($meetup === null) { - $msg = 'The event %s could not be found for you registration'; - throw new \Exception(sprintf($msg, $id)); - } - $form = $event->getForm(); - $positions = $meetup->getSport()->getPositions(); - - $this->customizeForm($form, $positions); - } - - protected function customizeForm($form, $positions) - { - // ... customize the form according to the positions - } - } - -You can see that you need to listen on these two events and have different callbacks -only because in two different scenarios, the data that you can use is given in a -different format. Other than that, this class always performs exactly the same -things on a given form. - -Now that you have that setup, register your form and the listener as services: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - acme.form.sport_meetup: - class: Acme\SportBundle\Form\Type\SportMeetupType - arguments: [@acme.form.meetup_registration_listener] - tags: - - { name: form.type, alias: acme_meetup_registration } - acme.form.meetup_registration_listener - class: Acme\SportBundle\Form\EventListener\RegistrationSportListener - arguments: [@form.factory, @doctrine] - - .. code-block:: xml - - - - - - - - - - - - - - .. code-block:: php - - // app/config/config.php - $definition = new Definition('Acme\SportBundle\Form\Type\SportMeetupType'); - $definition->addTag('form.type', array('alias' => 'acme_meetup_registration')); - $container->setDefinition( - 'acme.form.meetup_registration_listener', - $definition, - array('security.context') - ); - $definition = new Definition('Acme\SportBundle\Form\EventListener\RegistrationSportListener'); - $container->setDefinition( - 'acme.form.meetup_registration_listener', - $definition, - array('form.factory', 'doctrine') - ); - -In this setup, the ``RegistrationSportListener`` will be a constructor argument -to ``SportMeetupType``. You can then register it as an event subscriber on -your form:: - - private $registrationSportListener; - - public function __construct(RegistrationSportListener $registrationSportListener) - { - $this->registrationSportListener = $registrationSportListener; - } - - public function buildForm(FormBuilderInterface $builder, array $options) - { - // ... - $subscriber = new AddNameFieldSubscriber($builder->getFormFactory()); - $builder->addEventSubscriber($this->registrationSportListener); - } - -And this should tie everything together. You can now retrieve your form from the -controller, display it to a user, and validate it with the right choice options -set for every possible kind of sport that our users are registering for. - -One piece that may still be missing is the client-side updating of your form -after the sport is selected. This should be handled by making an AJAX call -back to your application. In that controller, you can bind your form, but -instead of processing it, simply use the bound form to render the updated -fields. The response from the AJAX call can then be used to update the view. diff --git a/_sources/cookbook/form/form_collections.txt b/_sources/cookbook/form/form_collections.txt deleted file mode 100644 index f97e0fd..0000000 --- a/_sources/cookbook/form/form_collections.txt +++ /dev/null @@ -1,604 +0,0 @@ -.. index:: - single: Formulario; Integrar colección de formularios - -Cómo integrar una colección de formularios -========================================== - -En este artículo, aprenderás cómo crear un formulario que integra una colección de muchos otros formularios. Esto podría ser útil, por ejemplo, si tienes una clase ``Tarea`` y quieres crear/editar/eliminar muchos objetos ``Etiqueta`` relacionados con esa ``Tarea``, justo dentro del mismo formulario. - -.. note:: - - En este artículo, vagamente asume que estás utilizando *Doctrine* como almacén de base de datos. Pero si no estás usando *Doctrine* (por ejemplo, *Propel* o simplemente una conexión directa a la base de datos), es casi lo mismo. Sólo hay unas cuantas partes de esta guía que realmente se preocupan de la «persistencia». - - Si *estás* utilizando *Doctrine*, tienes que añadir los metadatos de *Doctrine*, incluyendo el asociación ``MuchosAMuchos`` en la definición de asignación en la propiedad ``tags`` de la Tarea. - -Vamos a empezar por ahí: Supongamos que cada ``Tarea`` pertenece a múltiples objetos ``Tags``. Empieza creando una sencilla clase ``Tarea``:: - - // src/Acme/TaskBundle/Entity/Task.php - namespace Acme\TaskBundle\Entity; - - use Doctrine\Common\Collections\ArrayCollection; - - class Task - { - protected $description; - - protected $tags; - - public function __construct() - { - $this->tags = new ArrayCollection(); - } - - public function getDescription() - { - return $this->description; - } - - public function setDescription($description) - { - $this->description = $description; - } - - public function getTags() - { - return $this->tags; - } - - public function setTags(ArrayCollection $tags) - { - $this->tags = $tags; - } - } - -.. note:: - - El ``ArrayCollection`` es específico de *Doctrine* y básicamente es lo mismo que usar un ``arreglo`` (pero este debe ser un ``ArrayCollection``) si estás usando *Doctrine*. - -Ahora, crea una clase ``Etiqueta``. Cómo vimos arriba, una ``Tarea`` puede tener muchos objetos ``Etiqueta``:: - - // src/Acme/TaskBundle/Entity/Tag.php - namespace Acme\TaskBundle\Entity; - - class Tag - { - public $name; - } - -.. tip:: - - Aquí, la propiedad ``name`` es pública, pero fácilmente puede ser protegida o privada (pero entonces necesitaríamos métodos ``getName`` y ``setName``). - -Ahora veamos los formularios. Crea una clase formulario para que el usuario pueda modificar un objeto ``Tag``:: - - // src/Acme/TaskBundle/Form/Type/TagType.php - namespace Acme\TaskBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class TagType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('name'); - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\TaskBundle\Entity\Tag', - )); - } - - public function getName() - { - return 'tag'; - } - } - -Con esto, tienes suficiente para que una etiqueta de formulario se dibuje por sí misma. Pero debido a que el objetivo final es permitir que las etiquetas de una ``Tarea`` sean modificadas directamente dentro del formulario de la tarea en sí mismo, crea un formulario para la clase ``Tarea``. - -Ten en cuenta que integraste una colección de formularios ``TagType`` usando el tipo de campo :doc:`collection `:: - - // src/Acme/TaskBundle/Form/Type/TaskType.php - namespace Acme\TaskBundle\Form\Type; - - use Symfony\Component\Form\AbstractType; - use Symfony\Component\Form\FormBuilderInterface; - use Symfony\Component\OptionsResolver\OptionsResolverInterface; - - class TaskType extends AbstractType - { - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('description'); - - $builder->add('tags', 'collection', array('type' => new TagType())); - } - - public function setDefaultOptions(OptionsResolverInterface $resolver) - { - $resolver->setDefaults(array( - 'data_class' => 'Acme\TaskBundle\Entity\Task', - )); - } - - public function getName() - { - return 'task'; - } - } - -En tu controlador, ahora tendrás que iniciar una nueva instancia de ``TaskType``:: - - // src/Acme/TaskBundle/Controller/TaskController.php - namespace Acme\TaskBundle\Controller; - - use Acme\TaskBundle\Entity\Task; - use Acme\TaskBundle\Entity\Tag; - use Acme\TaskBundle\Form\Type\TaskType; - use Symfony\Component\HttpFoundation\Request; - use Symfony\Bundle\FrameworkBundle\Controller\Controller; - - class TaskController extends Controller - { - public function newAction(Request $request) - { - $task = new Task(); - - // código ficticio - esto está aquí sólo para que la tarea tenga algunas - // etiquetas, de lo contrario, este no sería un ejemplo interesante - $tag1 = new Tag(); - $tag1->name = 'tag1'; - $task->getTags()->add($tag1); - $tag2 = new Tag(); - $tag2->name = 'tag2'; - $task->getTags()->add($tag2); - // termina el código maniquí - - $form = $this->createForm(new TaskType(), $task); - - // procesa el formulario en POST - if ($request->isMethod('POST')) { - $form->bind($request); - if ($form->isValid()) { - // posiblemente hagas algún procesamiento del formulario, - // tal como guardar los objetos Task y Tag - } - } - - return $this->render('AcmeTaskBundle:Task:new.html.twig', array( - 'form' => $form->createView(), - )); - } - } - -La plantilla correspondiente, ahora es capaz de reproducir tanto el campo ``descripción`` del formulario de ``Tarea``, así como todos los formularios ``TagType`` de las etiquetas que ya están relacionados con esta ``Tarea``. En el controlador anterior, agregamos cierto código ficticio para poder ver esto en acción (debido a que una ``tarea`` tiene cero etiquetas al crearla por primera vez). - -.. configuration-block:: - - .. code-block:: html+jinja - - {# src/Acme/TaskBundle/Resources/views/Task/new.html.twig #} - - {# ... #} - -
    - {# reproduce únicamente los campos task: descripción #} - {{ form_row(form.description) }} - -

    Tags

    -
      - {# itera sobre cada etiqueta existente y reproduce su único campo: name #} - {% for tag in form.tags %} -
    • {{ form_row(tag.name) }}
      • - {% endfor %} -
    - - {{ form_rest(form) }} - {# ... #} -
    - - .. code-block:: html+php - - - - - -
    -

    Tags

    -
      - -
    • row($tag['name']) ?>
      • - -
    - - rest($form) ?> -
    - - - -Cuando el usuario envía el formulario, los datos presentados por los campos ``Tag`` se utilizan para construir un ``ArrayCollection`` de los objetos ``Tag``, que luego se establecen en el campo ``tag`` de la instancia ``Tarea``. - -La colección ``Tags``, naturalmente, es accesible a través de ``$task->getTags()`` y se puede persistir en la base de datos o utilizar donde sea necesaria. - -Hasta el momento, esto funciona muy bien, pero aún no te permite agregar dinámicamente nuevas etiquetas o eliminar existentes. Por lo tanto, durante la edición de etiquetas existentes funcionará bien, tu usuario en realidad no puede añadir ninguna nueva etiqueta, todavía. - - -.. caution:: - - En esta entrada, integraste una sola colección, pero de ninguna manera estás limitado a esto. También puedes integrar colecciones anidadas con tantos niveles descendientes como quieras. Pero si utilizas *XDebug* en tu configuración de desarrollo, puedes recibir un error ``La función alcanzó el máximo nivel de anidamiento de «100», ¡abortando!``. - Esto se debe a la opción ``xdebug.max_nesting_level`` de *PHP*, que por omisión es de ``100``. - - Esta directiva limita la recursividad a 100 llamadas que pueden no ser suficientes para reproducir el formulario en la plantilla si pintas todo el formulario de una vez (por ejemplo, ``form_widget(form)``). Para solucionar este problema puedes redefinir esta directiva a un valor más alto (ya sea a través de un archivo ``ini`` de *PHP* o por medio de :phpfunction:`ini_set`, por ejemplo, en ``app/autoload.php``) o pintar cada campo del formulario a mano usando ``form_row``. - -.. _cookbook-form-collections-new-prototype: - -Permitiendo «nuevas» etiquetas con «prototype» ----------------------------------------------- - -Permitir al usuario añadir nuevas etiquetas dinámicamente significa que necesitarás usar algo de *JavaScript*. Anteriormente añadiste dos etiquetas a tu formulario en el controlador. -Now let the user add as many tag forms as he needs directly in the browser. -Esto se hará a través de un poco de *JavaScript*. - -Lo primero que tienes que hacer es darle a conocer la colección del formulario que va a recibir una cantidad desconocida de etiquetas. Hasta ahora, añadiste dos etiquetas y el tipo de formulario espera recibir exactamente dos, de lo contrario lanzará un error: -``Este formulario no debe contener campos adicionales``. Para que esto sea flexible, añade la opción ``allow_add`` a tu campo colección:: - - // src/Acme/TaskBundle/Form/Type/TaskType.php - - // ... - - use Symfony\Component\Form\FormBuilderInterface; - - public function buildForm(FormBuilderInterface $builder, array $options) - { - $builder->add('description'); - - $builder->add('tags', 'collection', array( - 'type' => new TagType(), - 'allow_add' => true, - 'by_reference' => false, - )); - } - -Ten en cuenta que también se añadió ``'by_reference' => false``. Normalmente, la plataforma de formularios modificaría las etiquetas en un objeto ``Tarea`` *sin* llamar en realidad a ``setTags``. Al configurar :ref:`by_reference ` a ``false``, llamará a ``setTags``. Esto, como verás, será muy importante más adelante. - -Además de decirle al campo que acepte cualquier número de objetos presentados, ``allow_add`` también pone a tu disposición una variable «prototipo». Este «prototipo» es como una «plantilla» que contiene todo el código *HTML* necesario para poder pintar cualquier nueva ``etiqueta`` del formulario. Para ello, haz el siguiente cambio en tu plantilla: - -.. configuration-block:: - - .. code-block:: html+jinja - -
      - ... -
    - - .. code-block:: html+php - -
      - ... -
    - -.. note:: - - Si pintas todas tus ``etiquetas`` en subformularios simultáneamente (por ejemplo, ``form_row(form.tags)``), entonces el prototipo estará disponible automáticamente en el ``div`` externo como el atributo ``data-prototype``, similar a lo que ves arriba. - -.. tip:: - - The ``form.tags.vars.prototype`` is a form element that looks and feels just - like the individual ``form_widget(tag)`` elements inside your ``for`` loop. - This means that you can call ``form_widget``, ``form_row`` or ``form_label`` - on it. Incluso, puedes optar por pintar sólo uno de tus campos (por ejemplo, el campo ``nombre``): - - .. code-block:: html+jinja - - {{ form_widget(form.tags.vars.prototype.name)|e }} - -En la página producida, el resultado será muy parecido a este: - -.. code-block:: html - -
      - -El objetivo de esta sección es usar *JavaScript* para leer este atributo y agregar dinámicamente nuevas etiquetas al formulario cuando el usuario haga clic en un enlace «Agregar una etiqueta». -Para simplificar las cosas, este ejemplo usa *jQuery* y supone que lo has incluido en algún lugar de tu página. - -Añade un elemento `` - -.. tip:: - - Si estás reproduciendo la colección entera a la vez, entonces el prototipo automáticamente está disponible en el atributo ``data-prototype`` del elemento (por ejemplo ``div`` o ``table``) que rodea a tu colección. La única diferencia es que la «fila del formulario» entera es dibujada para ti, lo cual significa que no tendrás que envolverla en ningún elemento contenedor como se hizo arriba. - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``type`` -~~~~~~~~ - -**tipo**: ``string`` o :class:`Symfony\\Component\\Form\\FormTypeInterface` **requerido** - -Este es el tipo de campo para cada elemento de esta colección (por ejemplo, ``text``, ``choice``, etc.) Por ejemplo, si tienes un arreglo de direcciones de correo electrónico, debes usar el tipo :doc:`email `. Si quieres integrar una colección de algún otro formulario, crea una nueva instancia de tu tipo formulario y pásala como esta opción. - -``options`` -~~~~~~~~~~~ - -**tipo**: ``array`` **predeterminado**: ``array()`` - -Este es el arreglo que pasaste al tipo formulario especificado en la opción `type`_. Por ejemplo, si utilizaste el tipo :doc:`choice ` como tu opción `type`_ (por ejemplo, para una colección de menús desplegables), entonces necesitarás ---por lo menos--- pasar la opción ``choices`` al tipo subyacente:: - - $builder->add('favorite_cities', 'collection', array( - 'type' => 'choice', - 'options' => array( - 'choices' => array( - 'nashville' => 'Nashville', - 'paris' => 'Paris', - 'berlin' => 'Berlin', - 'london' => 'London', - ), - ), - )); - -``allow_add`` -~~~~~~~~~~~~~ - -**tipo**: ``Boolean`` **predeterminado**: ``false`` - -Si la fijas a ``true``, entonces si envías elementos no reconocidos a la colección, estos se añadirán cómo nuevos elementos. El arreglo final contendrá los elementos existentes así como el nuevo elemento que estaba en el dato entregado. Ve el ejemplo anterior para más detalles. - -Puedes usar la opción `prototype`_ para ayudarte a reproducir un elemento prototipo que puedes utilizar ---con *JavaScript*--- para crear dinámicamente nuevos elementos en el cliente. Para más información, ve el ejemplo anterior y :ref:`cookbook-form-collections-new-prototype`. - -.. caution:: - - Si estás integrando otros formularios enteros para reflejar una relación de base de datos uno-a-muchos, posiblemente necesites asegurarte manualmente que la llave externa de estos nuevos objetos se establece correctamente. Si estás utilizando *Doctrine*, esto no sucederá automáticamente. Ve el enlace anterior para más detalles. - -``allow_delete`` -~~~~~~~~~~~~~~~~ - -**tipo**: ``Boolean`` **predeterminado**: ``false`` - -Si lo fijas a ``true``, entonces si un elemento existente no está contenido en el dato entregado, correctamente estará ausente del arreglo de los elementos finales. Esto significa que puedes implementar un botón «eliminar» vía *JavaScript* el cuál sencillamente quita un elemento del *DOM* del formulario. Cuándo el usuario envía el formulario, la ausencia del dato entregado significará que fue quitado del arreglo final. - -Para más información, ve :ref:`cookbook-form-collections-remove`. - -.. caution:: - - Se prudente cuándo utilices esta opción al integrar una colección de objetos. En este caso, si se retira algún formulario incrustado, este se *debería* olvidar correctamente en el arreglo de objetos final. Aun así, dependiendo de la lógica de tu aplicación, cuándo uno de estos objetos es removido, posiblemente quieras eliminarlo o al menos quitar la referencia de la clave externa del objeto principal. - Nada de esto se maneja automáticamente. Para más información, ve :ref:`cookbook-form-collections-remove`. - -``prototype`` -~~~~~~~~~~~~~ - -**tipo**: ``Boolean`` **predeterminado**: ``true`` - -Esta opción es útil cuando utilizas la opción `allow_add`_. Si es ``true`` (y si además `allow_add`_ también es ``true``), un atributo ``«prototype»`` especial estará disponible a modo de que puedas reproducir una ``«plantilla»`` de ejemplo en la página en que aparecerá un nuevo elemento. El atributo ``name`` dado a este elemento es ``__name__``. Esto te permite añadir un botón «añadir otro» vía *JavaScript* el cuál lee el prototipo, reemplaza ``__name__`` con algún nombre o número único y lo reproduce dentro de tu formulario. Cuándo se envía, este se añade a tu arreglo subyacente gracias a la opción `allow_add`_. - -El campo prototipo se puede pintar vía la variable ``prototype`` del campo ``colección``: - -.. configuration-block:: - - .. code-block:: jinja - - {{ form_row(form.emails.vars.prototype) }} - - .. code-block:: php - - row($form['emails']->vars['prototype']) ?> - -Ten en cuenta que todo lo que realmente necesitas es el «elemento gráfico», pero dependiendo del formulario que estés reproduciendo, puede ser más fácil para ti pintar la «fila del formulario» entera. - -.. tip:: - - Si estás reproduciendo el campo ``colección`` entero a la vez, entonces el prototipo de la fila del formulario automáticamente está disponible en el atributo ``data-prototype`` del elemento (por ejemplo ``div`` o ``table``) que envuelve tu colección. - -Para obtener más información sobre como utilizar esta opción, ve el ejemplo anterior, así como :ref:`cookbook-form-collections-new-prototype`. - -``prototype_name`` -~~~~~~~~~~~~~~~~~~ - -.. versionadded:: 2.1 - La opción ``prototype_name`` se agregó en *Symfony 2.1* - -**tipo**: ``string`` **predefinido**: ``__name__`` - -Si tienes varias colecciones en tu formulario, o peor aún, colecciones anidadas posiblemente quieras cambiar el marcador de posición a modo que los marcadores de posición no relacionados no sean reemplazados con el mismo valor. - -Opciones heredadas ------------------- - -Estas opciones heredan del tipo :doc:`field `. -No todas las opciones figuran en esta lista ---solo las aplicables a este tipo: - -.. include:: /reference/forms/types/options/label.rst.inc - -``error_bubbling`` -~~~~~~~~~~~~~~~~~~ - -**tipo**: ``Boolean`` **predeterminado**: ``true`` - -.. include:: /reference/forms/types/options/_error_bubbling_body.rst.inc - -.. _reference-form-types-by-reference: - -.. include:: /reference/forms/types/options/by_reference.rst.inc - -.. include:: /reference/forms/types/options/empty_data.rst.inc diff --git a/_sources/reference/forms/types/country.txt b/_sources/reference/forms/types/country.txt deleted file mode 100644 index 4cd7eb1..0000000 --- a/_sources/reference/forms/types/country.txt +++ /dev/null @@ -1,58 +0,0 @@ -.. index:: - single: Formularios; Campos: country - -Tipo de campo ``country`` -========================= - -El tipo ``country`` es un subconjunto de ``ChoiceType`` que muestra los países del mundo. Como bono adicional, los nombres de los países se muestran en el idioma del usuario. - -El «valor» para cada país es el código de país de dos letras. - -.. note:: - - La configuración regional del usuario se deduce usando :phpmethod:`Locale::getDefault`. - -A diferencia del tipo ``choice``, no es necesario especificar una opción ``choices`` o ``choice_list`` como el tipo de campo utilizando automáticamente todos los países del mundo. *Puedes* especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo ``choice`` directamente. - -+-------------+-----------------------------------------------------------------------+ -| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`) | -+-------------+-----------------------------------------------------------------------+ -| Inherited | - `multiple`_ | -| options | - `expanded`_ | -| | - `preferred_choices`_ | -| | - `empty_value`_ | -| | - `error_bubbling`_ | -| | - `required`_ | -| | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -+-------------+-----------------------------------------------------------------------+ -| Parent type | :doc:`choice` | -+-------------+-----------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\CountryType` | -+-------------+-----------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`choice`: - -.. include:: /reference/forms/types/options/multiple.rst.inc - -.. include:: /reference/forms/types/options/expanded.rst.inc - -.. include:: /reference/forms/types/options/preferred_choices.rst.inc - -.. include:: /reference/forms/types/options/empty_value.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/csrf.txt b/_sources/reference/forms/types/csrf.txt deleted file mode 100644 index fc000b0..0000000 --- a/_sources/reference/forms/types/csrf.txt +++ /dev/null @@ -1,39 +0,0 @@ -.. index:: - single: Formularios; Campos: csrf - -Tipo de campo ``csrf`` -====================== - -El tipo ``csrf`` es un campo de entrada oculto que contiene un fragmento *CSRF*. - -+----------------+--------------------------------------------------------------------+ -| Dibujado como | campo ``input`` ``hidden`` | -+----------------+--------------------------------------------------------------------+ -| Opciones | - ``csrf_provider`` | -| | - ``intention`` | -| | - ``property_path`` | -+----------------+--------------------------------------------------------------------+ -| Tipo del padre | ``hidden`` | -+----------------+--------------------------------------------------------------------+ -| Clase | :class:`Symfony\\Component\\Form\\Extension\\Csrf\\Type\\CsrfType` | -+----------------+--------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``csrf_provider`` -~~~~~~~~~~~~~~~~~ - -**tipo**: ``Symfony\Component\Form\CsrfProvider\CsrfProviderInterface`` - -El objeto ``CsrfProviderInterface`` que debe generar la ficha *CSRF*. -Si no se establece, el valor predeterminado es el proveedor predeterminado. - -intención -~~~~~~~~~ - -**tipo**: ``string`` - -Un opcional identificador único que se utiliza para generar la ficha *CSRF*. - -.. include:: /reference/forms/types/options/property_path.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/date.txt b/_sources/reference/forms/types/date.txt deleted file mode 100644 index ab5ae8b..0000000 --- a/_sources/reference/forms/types/date.txt +++ /dev/null @@ -1,119 +0,0 @@ -.. index:: - single: Formularios; Campos: date - -Tipo de campo ``date`` -====================== - -Un campo que permite al usuario modificar información de fecha a través de una variedad de diferentes elementos *HTML*. - -Los datos subyacentes utilizados para este tipo de campo pueden ser un objeto ``DateTime``, una cadena, una marca de tiempo o un arreglo. Siempre y cuando la opción `input`_ se configure correctamente, el campo se hará cargo de todos los detalles. - -El campo se puede reproducir como un cuadro de texto, tres cuadros de texto (mes, día y año) o tres cuadros de selección (ve la opción `widget`_). - -+----------------------+-----------------------------------------------------------------------------+ -| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) | -+----------------------+-----------------------------------------------------------------------------+ -| Rendered as | single text box or three select fields | -+----------------------+-----------------------------------------------------------------------------+ -| Options | - `widget`_ | -| | - `input`_ | -| | - `empty_value`_ | -| | - `years`_ | -| | - `months`_ | -| | - `days`_ | -| | - `format`_ | -| | - `data_timezone`_ | -| | - `user_timezone`_ | -+----------------------+-----------------------------------------------------------------------------+ -| Inherited | - `invalid_message`_ | -| options | - `invalid_message_parameters`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `virtual`_ | -+----------------------+-----------------------------------------------------------------------------+ -| Parent type | ``field`` (if text), ``form`` otherwise | -+----------------------+-----------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateType` | -+----------------------+-----------------------------------------------------------------------------+ - -Uso básico ----------- - -Este tipo de campo es altamente configurable, pero fácil de usar. Las opciones más importantes son ``input`` y ``widget``. - -Supongamos que tienes un campo ``publishedAt`` cuya fecha subyacente es un objeto ``DateTime``. El siguiente código configura el tipo ``date`` para ese campo como tres campos de opciones diferentes: - -.. code-block:: php - - $builder->add('publishedAt', 'date', array( - 'input' => 'datetime', - 'widget' => 'choice', - )); - -La opción ``input`` se *debe* cambiar para que coincida con el tipo de dato de la fecha subyacente. Por ejemplo, si los datos del campo ``publishedAt`` eran una marca de tiempo Unix, habría la necesidad de establecer ``input`` a ``timestamp``: - -.. code-block:: php - - $builder->add('publishedAt', 'date', array( - 'input' => 'timestamp', - 'widget' => 'choice', - )); - -El campo también es compatible con ``array`` y ``string`` como valores válidos de la opción ``input``. - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -.. include:: /reference/forms/types/options/date_widget.rst.inc - -.. _form-reference-date-input: - -.. include:: /reference/forms/types/options/date_input.rst.inc - -``empty_value`` -~~~~~~~~~~~~~~~ - -**tipo**: ``string`` o ``array`` - -Si la opción de elemento gráfico se ajusta a ``choice``, entonces este campo se reproduce como una serie de cajas de ``selección``. Puedes utilizar la opción ``empty_value`` para agregar una entrada «en blanco» en la parte superior de cada caja de selección:: - - $builder->add('dueDate', 'date', array( - 'empty_value' => '', - )); - -Alternativamente, puedes especificar una cadena que se mostrará en lugar del valor «en blanco»:: - - $builder->add('dueDate', 'date', array( - 'empty_value' => array('year' => 'Year', 'month' => 'Month', 'day' => 'Day') - )); - -.. include:: /reference/forms/types/options/years.rst.inc - -.. include:: /reference/forms/types/options/months.rst.inc - -.. include:: /reference/forms/types/options/days.rst.inc - -.. _reference-forms-type-date-format: - -.. include:: /reference/forms/types/options/date_format.rst.inc - -.. include:: /reference/forms/types/options/data_timezone.rst.inc - -.. include:: /reference/forms/types/options/user_timezone.rst.inc - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -These options inherit from the :doc:`date` type: - -.. include:: /reference/forms/types/options/virtual.rst.inc diff --git a/_sources/reference/forms/types/datetime.txt b/_sources/reference/forms/types/datetime.txt deleted file mode 100644 index 1efd22c..0000000 --- a/_sources/reference/forms/types/datetime.txt +++ /dev/null @@ -1,113 +0,0 @@ -.. index:: - single: Formularios; Campos: datetime - -Tipo de campo ``datetime`` -========================== - -Este tipo de campo permite al usuario modificar los datos que representan una fecha y hora específica (por ejemplo, ``05/06/2011 12:15:30``). - -Se pueden reproducir como una entrada de texto o etiquetas de selección. El formato subyacente de los datos puede ser un objeto ``DateTime``, una cadena, una marca de tiempo o un arreglo. - -+----------------------+-----------------------------------------------------------------------------+ -| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) | -+----------------------+-----------------------------------------------------------------------------+ -| Rendered as | single text box or three select fields | -+----------------------+-----------------------------------------------------------------------------+ -| Options | - `date_widget`_ | -| | - `time_widget`_ | -| | - `input`_ | -| | - `date_format`_ | -| | - `hours`_ | -| | - `minutes`_ | -| | - `seconds`_ | -| | - `years`_ | -| | - `months`_ | -| | - `days`_ | -| | - `with_seconds`_ | -| | - `data_timezone`_ | -| | - `user_timezone`_ | -+----------------------+-----------------------------------------------------------------------------+ -| Inherited | - `invalid_message`_ | -| options | - `invalid_message_parameters`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `virtual`_ | -+----------------------+-----------------------------------------------------------------------------+ -| Parent type | :doc:`form` | -+----------------------+-----------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\DateTimeType` | -+----------------------+-----------------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``date_widget`` -~~~~~~~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``choice`` - -Define la opción ``widget`` para el tipo :doc:`date ` - -``time_widget`` -~~~~~~~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``choice`` - -Define la opción ``widget`` para el tipo :doc:`time ` - -``input`` -~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``datetime`` - -El formato del dato *input* ---es decir, el formato de la fecha en que se almacena en el objeto subyacente. Los valores válidos son los siguientes: - -* ``string`` (por ejemplo ``2011-06-05 12:15:00``) -* ``datetime`` (un objeto ``DateTime``) -* ``array`` (por ejemplo ``array(2011, 06, 05, 12, 15, 0)``) -* ``timestamp`` (por ejemplo ``1307276100``) - -El valor devuelto por el formulario también se normaliza de nuevo a este formato. - -``date_format`` -~~~~~~~~~~~~~~~ - -**tipo**: ``integer`` o ``string`` **predefinido**: ``IntlDateFormatter::MEDIUM`` - -Define la opción ``format`` que se transmite al campo de fecha. -Consulta la :ref:`opción de formato para el tipo date ` para más detalles. - -.. include:: /reference/forms/types/options/hours.rst.inc - -.. include:: /reference/forms/types/options/minutes.rst.inc - -.. include:: /reference/forms/types/options/seconds.rst.inc - -.. include:: /reference/forms/types/options/years.rst.inc - -.. include:: /reference/forms/types/options/months.rst.inc - -.. include:: /reference/forms/types/options/days.rst.inc - -.. include:: /reference/forms/types/options/with_seconds.rst.inc - -.. include:: /reference/forms/types/options/data_timezone.rst.inc - -.. include:: /reference/forms/types/options/user_timezone.rst.inc - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -These options inherit from the :doc:`date` type: - -.. include:: /reference/forms/types/options/virtual.rst.inc diff --git a/_sources/reference/forms/types/email.txt b/_sources/reference/forms/types/email.txt deleted file mode 100644 index ab4cde0..0000000 --- a/_sources/reference/forms/types/email.txt +++ /dev/null @@ -1,42 +0,0 @@ -.. index:: - single: Formularios; Campos: email - -Tipo de campo ``email`` -======================= - -El campo ``email`` es un campo de texto que se reproduce usando etiquetas *HTML5* ````. - -+-------------+---------------------------------------------------------------------+ -| Rendered as | ``input`` ``email`` field (a text box) | -+-------------+---------------------------------------------------------------------+ -| Inherited | - `max_length`_ | -| options | - `required`_ | -| | - `label`_ | -| | - `trim`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+---------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+---------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\EmailType` | -+-------------+---------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/max_length.rst.inc - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/trim.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/entity.txt b/_sources/reference/forms/types/entity.txt deleted file mode 100644 index bca2755..0000000 --- a/_sources/reference/forms/types/entity.txt +++ /dev/null @@ -1,132 +0,0 @@ -.. index:: - single: Formularios; Campos: Choice - -Tipo de campo ``entity`` -======================== - -Un campo ``choice`` especial que está diseñado para cargar las opciones de una entidad *Doctrine*. Por ejemplo, si tiene una entidad ``Categoria``, puedes utilizar este campo para mostrar un campo ``select`` todos o algunos de los objetos ``Categoria`` de la base de datos. - -+-------------+------------------------------------------------------------------+ -| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`) | -+-------------+------------------------------------------------------------------+ -| Options | - `class`_ | -| | - `property`_ | -| | - `group_by`_ | -| | - `query_builder`_ | -| | - `em`_ | -+-------------+------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | -| | - `multiple`_ | -| | - `expanded`_ | -| | - `preferred_choices`_ | -| | - `empty_value`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+------------------------------------------------------------------+ -| Parent type | :doc:`choice` | -+-------------+------------------------------------------------------------------+ -| Class | :class:`Symfony\\Bridge\\Doctrine\\Form\\Type\\EntityType` | -+-------------+------------------------------------------------------------------+ - -Uso básico ----------- - -El tipo ``entidad`` tiene una sola opción obligatoria: la entidad que debe aparecer dentro del campo de elección:: - - $builder->add('users', 'entity', array( - 'class' => 'AcmeHelloBundle:User', - 'property' => 'username', - )); - -En este caso, todos los objetos ``Usuario`` serán cargados desde la base de datos y representados como etiquetas ``select``, botones de radio o una serie de casillas de verificación (esto depende del valor ``multiple`` y ``expanded``). -Si el objeto entidad no tiene un método ``__toString()`` la opción ``property`` es necesaria. - -Usando una consulta personalizada para las Entidades -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si es necesario especificar una consulta personalizada a utilizar al recuperar las entidades (por ejemplo, sólo deseas devolver algunas entidades, o necesitas ordenarlas), utiliza la opción ``query_builder``. La forma más fácil para utilizar la opción es la siguiente:: - - use Doctrine\ORM\EntityRepository; - // ... - - $builder->add('users', 'entity', array( - 'class' => 'AcmeHelloBundle:User', - 'query_builder' => function(EntityRepository $er) { - return $er->createQueryBuilder('u') - ->orderBy('u.username', 'ASC'); - }, - )); - -.. include:: /reference/forms/types/options/select_how_rendered.rst.inc - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``class`` -~~~~~~~~~ - -**tipo**: ``string`` **required** - -La clase de tu entidad (por ejemplo, ``AcmeStoreBundle:Category``). Este puede ser un nombre de clase completo (por ejemplo, ``Acme\StoreBundle\Entity\Category``) o el nombre del alias corto (como te mostramos anteriormente). - -``property`` -~~~~~~~~~~~~ - -**tipo**: ``string`` - -Esta es la propiedad que se debe utilizar para visualizar las entidades como texto en el elemento *HTML*. Si la dejas en blanco, el objeto entidad será convertido en una cadena y por lo tanto debe tener un método ``__toString()``. - -``group_by`` -~~~~~~~~~~~~ - -**tipo**: ``string`` - -Esta es una propiedad ruta (por ejemplo, ``author.name``) usada para organizar en grupos las opciones disponibles. Sólo funciona cuando se representa como una etiqueta de selección y lo hace añadiendo etiquetas ``optgroup`` en torno a las opciones. Las opciones que no devuelvan un valor para esta propiedad ruta se dibujan directamente debajo de la etiqueta de selección, sin un ``optgroup`` circundante. - -``query_builder`` -~~~~~~~~~~~~~~~~~ - -**tipo**: ``Doctrine\ORM\QueryBuilder`` o un ``Closure`` - -Si lo especificas, se utiliza para consultar el subconjunto de opciones (y el orden) que se debe utilizar para el campo. El valor de esta opción puede ser un objeto ``QueryBuilder`` o un Cierre. Si utilizas un Cierre, este debe tener un sólo argumento, el cual es el ``EntityRepository`` de la entidad. - -``em`` -~~~~~~ - -**tipo**: ``string`` **predefinido**: el gestor de la entidad - -Si lo especificas, el gestor de la entidad especificada se utiliza para cargar las opciones en lugar de las predeterminadas del gestor de la entidad. - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`choice`: - -.. include:: /reference/forms/types/options/multiple.rst.inc - -.. note:: - - If you are working with a collection of Doctrine entities, it will be helpful - to read the documention for the :doc:`/reference/forms/types/collection` - as well. In addition, there is a complete example in the cookbook article - :doc:`/cookbook/form/form_collections`. - -.. include:: /reference/forms/types/options/expanded.rst.inc - -.. include:: /reference/forms/types/options/preferred_choices.rst.inc - -.. include:: /reference/forms/types/options/empty_value.rst.inc - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc diff --git a/_sources/reference/forms/types/field.txt b/_sources/reference/forms/types/field.txt deleted file mode 100644 index e297292..0000000 --- a/_sources/reference/forms/types/field.txt +++ /dev/null @@ -1,8 +0,0 @@ -.. index:: - single: Formularios; Campos: field - -El tipo abstracto ``field`` -=========================== - -A partir de *Symfony 2.1* se desaconseja el uso del tipo ``field`` para formularios. -Por favor, en su lugar usa el :doc:`Tipo field del formulario `. diff --git a/_sources/reference/forms/types/file.txt b/_sources/reference/forms/types/file.txt deleted file mode 100644 index a3ba900..0000000 --- a/_sources/reference/forms/types/file.txt +++ /dev/null @@ -1,89 +0,0 @@ -.. index:: - single: Formularios; Campos: file - -Tipo de campo ``file`` -====================== - -El tipo ``file`` representa una entrada de archivo en tu formulario. - -+-------------+---------------------------------------------------------------------+ -| Rendered as | ``input`` ``file`` field | -+-------------+---------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+---------------------------------------------------------------------+ -| Parent type | :doc:`form` | -+-------------+---------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FileType` | -+-------------+---------------------------------------------------------------------+ - -Uso básico ----------- - -Digamos que tienes esta definición de formulario: - -.. code-block:: php - - $builder->add('attachment', 'file'); - -.. caution:: - - No olvides añadir el atributo ``enctype`` en la etiqueta del formulario: ``
      ``. - -Cuando se envía el formulario, el campo de datos adjuntos (``attchment``) será una instancia de :class:`Symfony\\Component\\HttpFoundation\\File\\UploadedFile`. Este lo puedes utilizar para mover el archivo ``adjunto`` a una ubicación permanente: - -.. code-block:: php - - use Symfony\Component\HttpFoundation\File\UploadedFile; - - public function uploadAction() - { - // ... - - if ($form->isValid()) { - $someNewFilename = ... - - $form['attachment']->getData()->move($dir, $someNewFilename); - - // ... - } - - // ... - } - -El método ``move()`` toma un directorio y un nombre de archivo como argumentos. -Puedes calcular el nombre de archivo en una de las siguientes formas:: - - // usa el nombre de archivo original - $file->move($dir, $file->getClientOriginalName()); - - // calcula un nombre aleatorio e intenta deducir la extensión (más seguro) - $extension = $file->guessExtension(); - if (!$extension) { - // no se puede deducir la extensión - $extension = 'bin'; - } - $file->move($dir, rand(1, 99999).'.'.$extension); - -Usar el nombre original a través de ``getClientOriginalName()`` no es seguro, ya que el usuario final lo podría haber manipulado. Además, puede contener caracteres que no están permitidos en nombres de archivo. Antes de usar el nombre directamente, lo debes desinfectar. - -Lee en el recetario el :doc:`ejemplo ` de cómo manejar la carga de archivos adjuntos con una entidad *Doctrine*. - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/form.txt b/_sources/reference/forms/types/form.txt deleted file mode 100644 index b020596..0000000 --- a/_sources/reference/forms/types/form.txt +++ /dev/null @@ -1,31 +0,0 @@ -.. index:: - single: Formularios; Campos: form - -Tipo de campo ``Form`` -====================== - -Consulta :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\FormType`. - -El tipo ``form`` predefine un par de opciones que luego estarán disponibles en todos los campos. - -.. include:: /reference/forms/types/options/data.rst.inc - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/constraints.rst.inc - -.. include:: /reference/forms/types/options/cascade_validation.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/trim.rst.inc - -.. include:: /reference/forms/types/options/mapped.rst.inc - -.. include:: /reference/forms/types/options/property_path.rst.inc - -.. include:: /reference/forms/types/options/attr.rst.inc - -.. include:: /reference/forms/types/options/translation_domain.rst.inc diff --git a/_sources/reference/forms/types/hidden.txt b/_sources/reference/forms/types/hidden.txt deleted file mode 100644 index 981a0e1..0000000 --- a/_sources/reference/forms/types/hidden.txt +++ /dev/null @@ -1,27 +0,0 @@ -.. index:: - single: Formularios; Campos: hidden - -Tipo de campo ``hidden`` -======================== - -El tipo ``hidden`` representa un campo de entrada oculto. - -+----------------+----------------------------------------------------------------------+ -| Dibujado como | campo ``input`` ``hidden`` | -+----------------+----------------------------------------------------------------------+ -| Opciones | - ``data`` | -| heredadas | - ``property_path`` | -+----------------+----------------------------------------------------------------------+ -| Tipo del padre | :doc:`field` | -+----------------+----------------------------------------------------------------------+ -| Clase | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\HiddenType` | -+----------------+----------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/data.rst.inc - -.. include:: /reference/forms/types/options/property_path.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/integer.txt b/_sources/reference/forms/types/integer.txt deleted file mode 100644 index 9fdbd63..0000000 --- a/_sources/reference/forms/types/integer.txt +++ /dev/null @@ -1,67 +0,0 @@ -.. index:: - single: Formularios; Campos: integer - -Tipo de campo ``integer`` -========================= - -Reproduce un campo de entrada para «número». Básicamente, se trata de un campo de texto que es bueno manejando datos enteros en un formulario. El campo de entrada ``number`` se parece a un cuadro de texto, salvo que ---si el navegador del usuario es compatible con *HTML5*--- tendrá algunas funciones de interfaz adicionales. - -Este campo tiene diferentes opciones sobre cómo manejar los valores de entrada que no son enteros. Por omisión, todos los valores no enteros (por ejemplo 6.78) se redondearán hacia abajo (por ejemplo, 6). - -+-------------+-----------------------------------------------------------------------+ -| Rendered as | ``input`` ``text`` field | -+-------------+-----------------------------------------------------------------------+ -| Options | - `rounding_mode`_ | -| | - `grouping`_ | -+-------------+-----------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -| | - `invalid_message`_ | -| | - `invalid_message_parameters`_ | -+-------------+-----------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+-----------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\IntegerType` | -+-------------+-----------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``rounding_mode`` -~~~~~~~~~~~~~~~~~ - -**tipo**: ``integer`` **predeterminado**: ``IntegerToLocalizedStringTransformer::ROUND_DOWN`` - -Por omisión, si el usuario introduce un número no entero, se redondeará hacia abajo. Hay varios métodos de redondeo, y cada uno es una constante en la clase :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\IntegerToLocalizedStringTransformer`: - -* ``IntegerToLocalizedStringTransformer::ROUND_DOWN`` modo de redondeo para redondear hacia cero. - -* ``IntegerToLocalizedStringTransformer::ROUND_FLOOR`` modo de redondeo para redondear hacia el infinito negativo. - -* ``IntegerToLocalizedStringTransformer::ROUND_UP`` modo de redondeo para redondear alejándose del cero. - -* ``IntegerToLocalizedStringTransformer::ROUND_CEILING`` modo de redondeo para redondear hacia el infinito positivo. - -.. include:: /reference/forms/types/options/grouping.rst.inc - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc diff --git a/_sources/reference/forms/types/language.txt b/_sources/reference/forms/types/language.txt deleted file mode 100644 index a9d2395..0000000 --- a/_sources/reference/forms/types/language.txt +++ /dev/null @@ -1,58 +0,0 @@ -.. index:: - single: Formularios; Campos: language - -Tipo de campo ``language`` -========================== - -El tipo ``lenguaje`` es un subconjunto de ``ChoiceType`` que permite al usuario seleccionar entre una larga lista de idiomas. Como bono adicional, los nombres de idioma se muestran en el idioma del usuario. - -El «valor» para cada región es el *identificador de idioma Unicode* (por ejemplo, ``es`` o ``zh-Hant``). - -.. note:: - - La configuración regional del usuario se deduce usando :phpmethod:`Locale::getDefault`. - -A diferencia del tipo ``choice``, no es necesario especificar una opción ``choice`` o ``choice_list`` ya que el tipo de campo automáticamente utiliza una larga lista de idiomas. *Puedes* especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo ``choice`` directamente. - -+-------------+------------------------------------------------------------------------+ -| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`) | -+-------------+------------------------------------------------------------------------+ -| Inherited | - `multiple`_ | -| options | - `expanded`_ | -| | - `preferred_choices`_ | -| | - `empty_value`_ | -| | - `error_bubbling`_ | -| | - `required`_ | -| | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -+-------------+------------------------------------------------------------------------+ -| Parent type | :doc:`choice` | -+-------------+------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` | -+-------------+------------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`choice`: - -.. include:: /reference/forms/types/options/multiple.rst.inc - -.. include:: /reference/forms/types/options/expanded.rst.inc - -.. include:: /reference/forms/types/options/preferred_choices.rst.inc - -.. include:: /reference/forms/types/options/empty_value.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/locale.txt b/_sources/reference/forms/types/locale.txt deleted file mode 100644 index 02890e7..0000000 --- a/_sources/reference/forms/types/locale.txt +++ /dev/null @@ -1,58 +0,0 @@ -.. index:: - single: Formularios; Campos: locale - -Tipo de campo ``locale`` -======================== - -El tipo ``locale`` es un subconjunto de ``ChoiceType`` que permite al usuario seleccionar entre una larga lista de regiones (idioma + país). Como bono adicional, los nombres regionales se muestran en el idioma del usuario. - -El «valor» de cada región es o bien el del código de *idioma* ISO639-1 de dos letras (por ejemplo, «\ ``es``\ »), o el código de idioma seguido de un guión bajo (``_``), luego el código de *país* ISO3166 (por ejemplo, «\ ``fr_FR``\ » para Francés/Francia). - -.. note:: - - La configuración regional del usuario se deduce usando :phpmethod:`Locale::getDefault`. - -A diferencia del tipo ``choice``, no es necesario especificar una opción ``choices`` o ``choice_list``, ya que el tipo de campo utiliza automáticamente una larga lista de regiones. *Puedes* especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo ``choice`` directamente. - -+-------------+------------------------------------------------------------------------+ -| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`) | -+-------------+------------------------------------------------------------------------+ -| Inherited | - `multiple`_ | -| options | - `expanded`_ | -| | - `preferred_choices`_ | -| | - `empty_value`_ | -| | - `error_bubbling`_ | -| | - `required`_ | -| | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -+-------------+------------------------------------------------------------------------+ -| Parent type | :doc:`choice` | -+-------------+------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\LanguageType` | -+-------------+------------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`choice`: - -.. include:: /reference/forms/types/options/multiple.rst.inc - -.. include:: /reference/forms/types/options/expanded.rst.inc - -.. include:: /reference/forms/types/options/preferred_choices.rst.inc - -.. include:: /reference/forms/types/options/empty_value.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/money.txt b/_sources/reference/forms/types/money.txt deleted file mode 100644 index 2a0fc58..0000000 --- a/_sources/reference/forms/types/money.txt +++ /dev/null @@ -1,87 +0,0 @@ -.. index:: - single: Formularios; Campos: money - -Tipo de campo ``money`` -======================= - -Reproduce un campo de entrada de texto especializado en el manejo de la presentación de datos tipo «moneda». - -Este tipo de campo te permite especificar una moneda, cuyo símbolo se representa al lado del campo de texto. También hay otras opciones para personalizar la forma de la entrada y salida de los datos manipulados. - -+-------------+---------------------------------------------------------------------+ -| Rendered as | ``input`` ``text`` field | -+-------------+---------------------------------------------------------------------+ -| Options | - `currency`_ | -| | - `divisor`_ | -| | - `precision`_ | -| | - `grouping`_ | -+-------------+---------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -| | - `invalid_message`_ | -| | - `invalid_message_parameters`_ | -+-------------+---------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+---------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\MoneyType` | -+-------------+---------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``currency`` -~~~~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``EUR`` - -Especifica la moneda en la cual se especifica el dinero. Esta determina el símbolo de moneda que se debe mostrar en el cuadro de texto. Dependiendo de la moneda --- el símbolo de moneda se puede mostrar antes o después del campo de entrada de texto. - -This can be any `3 letter ISO 4217 code`_. You can also set this to false to -hide the currency symbol. - -``divisor`` -~~~~~~~~~~~ - -**tipo**: ``integer`` **predeterminado**: ``1`` - -Si, por alguna razón, tienes que dividir tu valor inicial por un número antes de reproducirlo para el usuario, puedes utilizar la opción ``divisor``. -Por ejemplo:: - - $builder->add('price', 'money', array( - 'divisor' => 100, - )); - -En este caso, si el campo ``price`` está establecido en ``9900``, entonces en realidad al usuario se le presentará el valor ``99``. Cuando el usuario envía el valor ``99``, este se multiplicará por ``100`` y finalmente se devolverá ``9900`` a tu objeto. - -``precision`` -~~~~~~~~~~~~~~ - -**tipo**: ``integer`` **predeterminado**: ``2`` - -Por alguna razón, si necesitas alguna precisión que no sean dos decimales, puedes modificar este valor. Probablemente no necesitarás hacer esto a menos que, por ejemplo, desees redondear al dólar más cercano (ajustando la precisión a ``0``). - -.. include:: /reference/forms/types/options/grouping.rst.inc - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc - -.. _`3 letter ISO 4217 code`: http://en.wikipedia.org/wiki/ISO_4217 diff --git a/_sources/reference/forms/types/number.txt b/_sources/reference/forms/types/number.txt deleted file mode 100644 index 3d38bf7..0000000 --- a/_sources/reference/forms/types/number.txt +++ /dev/null @@ -1,79 +0,0 @@ -.. index:: - single: Formularios; Campos: number - -Tipo de campo ``number`` -======================== - -Reproduce un campo de entrada de texto y se especializa en el manejo de entradas numéricas. Este tipo ofrece diferentes opciones para precisión, redondeo y agrupamiento que desees utilizar para tu número. - -+-------------+----------------------------------------------------------------------+ -| Rendered as | ``input`` ``text`` field | -+-------------+----------------------------------------------------------------------+ -| Options | - `rounding_mode`_ | -| | - `precision`_ | -| | - `grouping`_ | -+-------------+----------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -| | - `invalid_message`_ | -| | - `invalid_message_parameters`_ | -+-------------+----------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+----------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\NumberType` | -+-------------+----------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``precision`` -~~~~~~~~~~~~~~ - -**tipo**: ``integer`` **predeterminado**: Específico a la región (usualmente alrededor de ``3``) - -Este especifica cuantos decimales se permitirán para redondear el campo al valor presentado (a través de ``rounding_mode``). Por ejemplo, si ``precision`` se establece en ``2``, un valor presentado de ``20.123`` se redondeará a, por ejemplo, ``20.12`` (dependiendo de tu ``rounding_mode``). - -``rounding_mode`` -~~~~~~~~~~~~~~~~~ - -**tipo**: ``integer`` **predeterminado**: ``IntegerToLocalizedStringTransformer::ROUND_HALFUP`` - -Si es necesario redondear un número presentado (basándonos en la opción ``precision``), tienes varias opciones configurables para el redondeo. Cada opción es una constante en :class:`Symfony\\Component\\Form\\Extension\\Core\\DataTransformer\\IntegerToLocalizedStringTransformer`: - -* ``IntegerToLocalizedStringTransformer::ROUND_DOWN`` modo de redondeo para redondear hacia cero. - -* ``IntegerToLocalizedStringTransformer::ROUND_FLOOR`` modo de redondeo para redondear hacia el infinito negativo. - -* ``IntegerToLocalizedStringTransformer::ROUND_UP`` modo de redondeo para redondear alejándose del cero. - -* ``IntegerToLocalizedStringTransformer::ROUND_CEILING`` modo de redondeo para redondear hacia el infinito positivo. - -* ``IntegerToLocalizedStringTransformer::ROUND_HALFDOWN`` El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso se redondea hacia abajo. - -* ``IntegerToLocalizedStringTransformer::ROUND_HALFEVEN`` El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso, se redondea hacia el vecino par. - -* ``IntegerToLocalizedStringTransformer::ROUND_HALFUP`` El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso se redondea hacia arriba. - -.. include:: /reference/forms/types/options/grouping.rst.inc - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc diff --git a/_sources/reference/forms/types/password.txt b/_sources/reference/forms/types/password.txt deleted file mode 100644 index 940313c..0000000 --- a/_sources/reference/forms/types/password.txt +++ /dev/null @@ -1,56 +0,0 @@ -.. index:: - single: Formularios; Campos: password - -Tipo de campo ``password`` -========================== - -El tipo de campo ``password`` reproduce un campo de texto para entrada de contraseñas. - -+-------------+------------------------------------------------------------------------+ -| Rendered as | ``input`` ``password`` field | -+-------------+------------------------------------------------------------------------+ -| Options | - `always_empty`_ | -+-------------+------------------------------------------------------------------------+ -| Inherited | - `max_length`_ | -| options | - `required`_ | -| | - `label`_ | -| | - `trim`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+------------------------------------------------------------------------+ -| Parent type | :doc:`text` | -+-------------+------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PasswordType` | -+-------------+------------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``always_empty`` -~~~~~~~~~~~~~~~~ - -**tipo**: ``Boolean`` **predeterminado**: ``true`` - -Si es ``true``, el campo *siempre* se reproduce en blanco, incluso si el campo correspondiente tiene un valor. Cuando se establece en ``false``, el campo de la contraseña se reproduce con el atributo ``value`` fijado a su valor real. - -En pocas palabras, si por alguna razón deseas reproducir tu campo de contraseña *con* el valor de contraseña ingresado anteriormente en el cuadro, ponlo a ``false``. - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/max_length.rst.inc - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/trim.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc \ No newline at end of file diff --git a/_sources/reference/forms/types/percent.txt b/_sources/reference/forms/types/percent.txt deleted file mode 100644 index 52b386b..0000000 --- a/_sources/reference/forms/types/percent.txt +++ /dev/null @@ -1,74 +0,0 @@ -.. index:: - single: Formularios; Campos: percent - -Tipo de campo ``percent`` -========================= - - -El tipo de campo ``percent`` reproduce un campo de entrada de texto, especializado en el manejo de datos porcentuales. Si los datos porcentuales se almacenan como un decimal (por ejemplo, ``0.95``), puedes utilizar este campo fuera de la caja. Si almacenas tus datos como un número (por ejemplo, ``95``), debes establecer la opción ``type`` a ``integer``. - -Este campo añade un signo de porcentaje «``%``» después del cuadro de entrada. - -+-------------+-----------------------------------------------------------------------+ -| Rendered as | ``input`` ``text`` field | -+-------------+-----------------------------------------------------------------------+ -| Options | - `type`_ | -| | - `precision`_ | -+-------------+-----------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -| | - `invalid_message`_ | -| | - `invalid_message_parameters`_ | -+-------------+-----------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+-----------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\PercentType` | -+-------------+-----------------------------------------------------------------------+ - -Opciones --------- - -``type`` -~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``fractional`` - -Esto controla la forma en que se almacenan tus datos en el objeto. Por ejemplo, en el objeto puedes almacenar un porcentaje correspondiente al «55%» como ``0.55`` o ``55``. Los dos «tipos» manejan estos dos casos: - -* ``fractional`` - Si los datos se almacenan como un decimal (por ejemplo, ``0.55``), usa este tipo. - Los datos se multiplicarán por ``100`` antes de mostrarlos al usuario (por ejemplo, ``55``). Los datos presentados se dividirán por ``100`` al presentar el formulario para almacenar el valor decimal (``0.55``); - -* ``integer`` - Si almacenas tus datos como un entero (por ejemplo, 55), entonces, utiliza esta opción. - El valor crudo (``55``) se muestra al usuario y se almacena en tu objeto. - Ten en cuenta que esto sólo funciona para valores enteros. - -``precision`` -~~~~~~~~~~~~~~ - -**tipo**: ``integer`` **predeterminado**: ``0`` - -De manera predeterminada, los números ingresados se redondean. Para tomar en cuenta más cifras decimales, utiliza esta opción. - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc diff --git a/_sources/reference/forms/types/radio.txt b/_sources/reference/forms/types/radio.txt deleted file mode 100644 index 3d213c1..0000000 --- a/_sources/reference/forms/types/radio.txt +++ /dev/null @@ -1,51 +0,0 @@ -.. index:: - single: Formularios; Campos: radio - -Tipo de campo ``radio`` -======================= - -Crea un solo botón de radio. Si el botón de radio es seleccionado, el campo se establecerá al valor especificado. Los botones de radio no se pueden deseleccionar ---el valor cambia únicamente cuándo seleccionas otro botón de radio con el mismo nombre. - -El tipo ``radio`` no suele usarse directamente. Comúnmente se utiliza internamente por otros tipos, tales como :doc:`choice `. -Si quieres tener un campo booleano, utiliza una :doc:`casilla de verificación `. - -+-------------+---------------------------------------------------------------------+ -| Rendered as | ``input`` ``radio`` field | -+-------------+---------------------------------------------------------------------+ -| Options | - `value`_ | -+-------------+---------------------------------------------------------------------+ -| Inherited | - `required`_ | -| options | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+---------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+---------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RadioType` | -+-------------+---------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``value`` -~~~~~~~~~ - -**tipo**: ``mixed`` **predeterminado**: ``1`` - -El valor utilizado realmente como valor para el botón de radio. Esto no afecta al valor establecido en tu objeto. - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc diff --git a/_sources/reference/forms/types/repeated.txt b/_sources/reference/forms/types/repeated.txt deleted file mode 100644 index 6d0239f..0000000 --- a/_sources/reference/forms/types/repeated.txt +++ /dev/null @@ -1,155 +0,0 @@ -.. index:: - single: Formularios; Campos: repetidos - -Tipo de campo ``repeated`` -========================== - -Este es un campo «grupo» especial, el cual crea dos campos idénticos, cuyos valores deben coincidir (o lanza un error de validación). Se utiliza comúnmente cuando necesitas que el usuario repita su contraseña o correo electrónico para verificar su exactitud. - -+----------------+------------------------------------------------------------------------+ -| Dibujado como | campo ``input`` ``text`` por omisión, pero ve la opción `type`_ | -+----------------+------------------------------------------------------------------------+ -| Opciones | - `type`_ | -| | - `options`_ | -| | - `first_options`_ | -| | - `second_options`_ | -| | - `first_name`_ | -| | - `second_name`_ | -+----------------+------------------------------------------------------------------------+ -| Opciones | - `invalid_message`_ | -| heredadas | - `invalid_message_parameters`_ | -| | - `error_bubbling`_ | -+----------------+------------------------------------------------------------------------+ -| Tipo del padre | :doc:`field` | -+----------------+------------------------------------------------------------------------+ -| Clase | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\RepeatedType` | -+----------------+------------------------------------------------------------------------+ - -Ejemplo de uso --------------- - -.. code-block:: php - - $builder->add('password', 'repeated', array( - 'type' => 'password', - 'invalid_message' => 'The password fields must match.', - 'options' => array('attr' => array('class' => 'password-field')), - 'required' => true, - 'first_options' => array('label' => 'Password'), - 'second_options' => array('label' => 'Repeat Password'), - )); - -Al presentar satisfactoriamente un formulario, el valor ingresado en ambos campos «contraseña» se convierte en los datos de la clave ``password``. En otras palabras, a pesar de que ambos campos efectivamente son reproducidos, sólo el dato final del formulario es el único valor que necesitas (generalmente una cadena). - -La opción más importante es ``type``, la cual puede ser cualquier tipo de campo y determina el tipo real de los dos campos subyacentes. La opción ``options`` se pasa a cada uno de los campos individuales, lo cual significa ---en este ejemplo--- que en este arreglo puedes pasar cualquier opción compatible con el tipo ``password``. - -Rendering -~~~~~~~~~ - -The repeated field type is actually two underlying fields, which you can -render all at once, or individually. To render all at once, use something -like: - -.. configuration-block:: - - .. code-block:: jinja - - {{ form_row(form.password) }} - - .. code-block:: php - - row($form['password']) ?> - -To render each field individually, use something like this: - -.. configuration-block:: - - .. code-block:: jinja - - {{ form_row(form.password.first) }} - {{ form_row(form.password.second) }} - - .. code-block:: php - - row($form['password']['first']) ?> - row($form['password']['second']) ?> - -.. note:: - - The sub-field names are ``first`` and ``second`` by default, but can - be controlled via the `first_name`_ and `second_name`_ options. - -Validando -~~~~~~~~~ - -Una de las características clave del campo ``repeated`` es la validación interna (sin necesidad de hacer nada para configurar esto) el cual obliga a que los dos campos tengan un valor coincidente. Si los dos campos no coinciden, se mostrará un error al usuario. - -El ``invalid_message`` se utiliza para personalizar el error que se mostrará cuando los dos campos no coinciden entre sí. - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``type`` -~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``text`` - -Los dos campos subyacentes serán de este tipo de campo. Por ejemplo, pasando un tipo de ``password`` reproducirá dos campos de contraseña. - -``options`` -~~~~~~~~~~~ - -**tipo**: ``array`` **predeterminado**: ``array()`` - -Este arreglo de opciones se pasará a cada uno de los dos campos subyacentes. En otras palabras, estas son las opciones que personalizan los tipos de campo individualmente. -Por ejemplo, si la opción ``type`` se establece en ``password``, este arreglo puede contener las opciones ``always_empty`` o ``required`` --- ambas opciones son compatibles con el tipo de campo ``password``. - -``first_options`` -~~~~~~~~~~~~~~~~~ - -**tipo**: ``array`` **predeterminado**: ``array()`` - -.. versionadded:: 2.1 - La opción ``first_options`` es nueva en *Symfony 2.1*. - -Las opciones adicionales (se fusionarán en ``opciones`` arriba) estas *sólo* se deben suministrar para el primer campo. Estas son útiles especialmente para personalizar la etiqueta:: - - $builder->add('password', 'repeated', array( - 'first_options' => array('label' => 'Password'), - 'second_options' => array('label' => 'Repeat Password'), - )); - -``second_options`` -~~~~~~~~~~~~~~~~~~ - -**tipo**: ``array`` **predeterminado**: ``array()`` - -.. versionadded:: 2.1 - La opción ``second_options`` es nueva en *Symfony 2.1*. - -Las opciones adicionales (se fusionarán en ``opciones`` arriba) estas *sólo* se deben suministrar para el segundo campo. Estas son útiles especialmente para personalizar la etiqueta (ve las `first_options`_). - -``first_name`` -~~~~~~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``first`` - -Este es el nombre real del campo que se utilizará para el primer campo. Esto sobre todo no tiene sentido, sin embargo, puesto que los datos reales especificados en ambos campos disponibles bajo la clave asignada al campo ``repeated`` en sí mismo (por ejemplo, ``password``). Sin embargo, si no especificas una etiqueta, se utiliza el nombre de este campo para «deducir» la etiqueta por ti. - -``second_name`` -~~~~~~~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``second`` - -Al igual que ``first_name``, pero para el segundo campo. - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc diff --git a/_sources/reference/forms/types/search.txt b/_sources/reference/forms/types/search.txt deleted file mode 100644 index eddf019..0000000 --- a/_sources/reference/forms/types/search.txt +++ /dev/null @@ -1,46 +0,0 @@ -.. index:: - single: Formularios; Campos: search - -Tipo de campo ``search`` -======================== - -Este reproduce un campo ````, el cual es un cuadro de texto con funcionalidad especial apoyada por algunos navegadores. - -Lee sobre el campo de entrada para búsqueda en `DiveIntoHTML5.info`_ - -+-------------+----------------------------------------------------------------------+ -| Rendered as | ``input search`` field | -+-------------+----------------------------------------------------------------------+ -| Inherited | - `max_length`_ | -| options | - `required`_ | -| | - `label`_ | -| | - `trim`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+----------------------------------------------------------------------+ -| Parent type | :doc:`text` | -+-------------+----------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\SearchType` | -+-------------+----------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/max_length.rst.inc - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/trim.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - -.. _`DiveIntoHTML5.info`: http://diveintohtml5.info/forms.html#type-search diff --git a/_sources/reference/forms/types/text.txt b/_sources/reference/forms/types/text.txt deleted file mode 100644 index 3efbd4a..0000000 --- a/_sources/reference/forms/types/text.txt +++ /dev/null @@ -1,43 +0,0 @@ -.. index:: - single: Formularios; Campos: text - -Tipo de campo text -================== - -El campo de texto reproduce el campo de entrada de texto más básico. - -+-------------+--------------------------------------------------------------------+ -| Rendered as | ``input`` ``text`` field | -+-------------+--------------------------------------------------------------------+ -| Inherited | - `max_length`_ | -| options | - `required`_ | -| | - `label`_ | -| | - `trim`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+--------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+--------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TextType` | -+-------------+--------------------------------------------------------------------+ - - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/max_length.rst.inc - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/trim.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc diff --git a/_sources/reference/forms/types/textarea.txt b/_sources/reference/forms/types/textarea.txt deleted file mode 100644 index 0b5a173..0000000 --- a/_sources/reference/forms/types/textarea.txt +++ /dev/null @@ -1,43 +0,0 @@ -.. index:: - single: Formularios; Campos: textarea - -Tipo de campo ``textarea`` -========================== - -Reproduce un elemento ``textarea`` *HTML*. - -+-------------+------------------------------------------------------------------------+ -| Rendered as | ``textarea`` tag | -+-------------+------------------------------------------------------------------------+ -| Inherited | - `max_length`_ | -| options | - `required`_ | -| | - `label`_ | -| | - `trim`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+------------------------------------------------------------------------+ -| Parent type | :doc:`field` | -+-------------+------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TextareaType` | -+-------------+------------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/max_length.rst.inc - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/trim.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc - diff --git a/_sources/reference/forms/types/time.txt b/_sources/reference/forms/types/time.txt deleted file mode 100644 index 0596524..0000000 --- a/_sources/reference/forms/types/time.txt +++ /dev/null @@ -1,118 +0,0 @@ -.. index:: - single: Formularios; Campos: time - -Tipo de campo ``time`` -====================== - -Un campo para capturar entradas horarias. - -Este se puede reproducir como un campo de texto, una serie de campos de texto (por ejemplo, horas, minutos, segundos) o una serie de campos de selección. Los datos subyacentes se pueden almacenar como un objeto ``DateTime``, una cadena, una marca de tiempo (``timestamp``) o un arreglo. - -+----------------------+-----------------------------------------------------------------------------+ -| Underlying Data Type | can be ``DateTime``, string, timestamp, or array (see the ``input`` option) | -+----------------------+-----------------------------------------------------------------------------+ -| Rendered as | can be various tags (see below) | -+----------------------+-----------------------------------------------------------------------------+ -| Options | - `widget`_ | -| | - `input`_ | -| | - `with_seconds`_ | -| | - `hours`_ | -| | - `minutes`_ | -| | - `seconds`_ | -| | - `data_timezone`_ | -| | - `user_timezone`_ | -+----------------------+-----------------------------------------------------------------------------+ -| Inherited | - `invalid_message`_ | -| options | - `invalid_message_parameters`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `virtual`_ | -+----------------------+-----------------------------------------------------------------------------+ -| Parent type | form | -+----------------------+-----------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimeType` | -+----------------------+-----------------------------------------------------------------------------+ - -Uso básico ----------- - -Este tipo de campo es altamente configurable, pero fácil de usar. Las opciones más importantes son ``input`` y ``widget``. - -Supongamos que tienes un campo ``startTime`` cuyo dato de hora subyacente es un objeto ``DateTime``. Lo siguiente configura el tipo ``time`` para ese campo como tres campos de opciones diferentes: - -.. code-block:: php - - $builder->add('startTime', 'time', array( - 'input' => 'datetime', - 'widget' => 'choice', - )); - -La opción ``input`` se *debe* cambiar para que coincida con el tipo de dato de la fecha subyacente. Por ejemplo, si los datos del campo ``startTime`` fueran una marca de tiempo Unix, habría necesidad de establecer la ``entrada`` a ``timestamp``: - -.. code-block:: php - - $builder->add('startTime', 'time', array( - 'input' => 'timestamp', - 'widget' => 'choice', - )); - -El campo también es compatible con ``array`` y ``string`` como valores válidos de la opción ``input``. - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``widget`` -~~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``choice`` - -La forma básica en que se debe reproducir este campo. Puede ser una de las siguientes: - -* ``choice``: pinta dos (o tres si `with_seconds`_ es ``true``) cuadros de selección. - -* ``text``: pinta dos o tres cuadros de texto (horas, minutos, segundos). - -* ``single_text``: pinta un sólo campo de entrada de tipo ``text``. La entrada del usuario se validará contra la forma ``hh:mm`` (o ``hh:mm:ss`` si se utilizan segundos). - -``input`` -~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``datetime`` - -El formato del dato *input* ---es decir, el formato de la fecha en que se almacena en el objeto subyacente. Los valores válidos son los siguientes: - -* ``string`` (por ejemplo ``12:17:26``) -* ``datetime`` (un objeto ``DateTime``) -* ``array`` (por ejemplo ``array('hour' => 12, 'minute' => 17, 'second' => 26)``) -* ``timestamp`` (por ejemplo ``1307232000``) - -El valor devuelto por el formulario también se normaliza de nuevo a este formato. - -.. include:: /reference/forms/types/options/with_seconds.rst.inc - -.. include:: /reference/forms/types/options/hours.rst.inc - -.. include:: /reference/forms/types/options/minutes.rst.inc - -.. include:: /reference/forms/types/options/seconds.rst.inc - -.. include:: /reference/forms/types/options/data_timezone.rst.inc - -.. include:: /reference/forms/types/options/user_timezone.rst.inc - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/invalid_message.rst.inc - -.. include:: /reference/forms/types/options/invalid_message_parameters.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -These options inherit from the :doc:`date` type: - -.. include:: /reference/forms/types/options/virtual.rst.inc diff --git a/_sources/reference/forms/types/timezone.txt b/_sources/reference/forms/types/timezone.txt deleted file mode 100644 index 659c1b2..0000000 --- a/_sources/reference/forms/types/timezone.txt +++ /dev/null @@ -1,54 +0,0 @@ -.. index:: - single: Formularios; Campos: timezone - -Tipo de campo ``timezone`` -========================== - -El tipo ``timezone`` es un subconjunto de ``ChoiceType`` que permite al usuario seleccionar entre todas las posibles zonas horarias. - -El «``valor``» para cada zona horaria es el nombre completo de la zona horaria, por ejemplo ``América/Chicago`` o ``Europa/Estambul``. - -A diferencia del tipo ``choice``, no es necesario especificar una opción ``choices`` o ``choice_list``, ya que el tipo de campo utiliza automáticamente una larga lista de regiones. *Puedes* especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo ``choice`` directamente. - -+-------------+------------------------------------------------------------------------+ -| Rendered as | can be various tags (see :ref:`forms-reference-choice-tags`) | -+-------------+------------------------------------------------------------------------+ -| Inherited | - `multiple`_ | -| options | - `expanded`_ | -| | - `preferred_choices`_ | -| | - `empty_value`_ | -| | - `required`_ | -| | - `label`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+------------------------------------------------------------------------+ -| Parent type | :doc:`choice` | -+-------------+------------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\TimezoneType` | -+-------------+------------------------------------------------------------------------+ - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`choice`: - -.. include:: /reference/forms/types/options/multiple.rst.inc - -.. include:: /reference/forms/types/options/expanded.rst.inc - -.. include:: /reference/forms/types/options/preferred_choices.rst.inc - -.. include:: /reference/forms/types/options/empty_value.rst.inc - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc diff --git a/_sources/reference/forms/types/url.txt b/_sources/reference/forms/types/url.txt deleted file mode 100644 index 9d1f492..0000000 --- a/_sources/reference/forms/types/url.txt +++ /dev/null @@ -1,54 +0,0 @@ -.. index:: - single: Formularios; Campos: url - -Tipo de campo ``url`` -===================== - -El campo ``url`` es un campo de texto que prefija el valor presentado con un determinado protocolo (por ejemplo, ``http://``) si el valor presentado no tiene ya un protocolo. - -+-------------+-------------------------------------------------------------------+ -| Rendered as | ``input url`` field | -+-------------+-------------------------------------------------------------------+ -| Options | - `default_protocol`_ | -+-------------+-------------------------------------------------------------------+ -| Inherited | - `max_length`_ | -| options | - `required`_ | -| | - `label`_ | -| | - `trim`_ | -| | - `read_only`_ | -| | - `disabled`_ | -| | - `error_bubbling`_ | -+-------------+-------------------------------------------------------------------+ -| Parent type | :doc:`text` | -+-------------+-------------------------------------------------------------------+ -| Class | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\UrlType` | -+-------------+-------------------------------------------------------------------+ - -Opciones del campo -~~~~~~~~~~~~~~~~~~ - -``default_protocol`` -~~~~~~~~~~~~~~~~~~~~ - -**tipo**: ``string`` **predefinido**: ``http`` - -Si un valor es presentado que no comience con un protocolo (por ejemplo, ``http://``, ``ftp://``, etc.), se prefija la cadena con este protocolo al vincular los datos al formulario. - -Opciones heredadas ------------------- - -Estas opciones las hereda del tipo :doc:`field `: - -.. include:: /reference/forms/types/options/max_length.rst.inc - -.. include:: /reference/forms/types/options/required.rst.inc - -.. include:: /reference/forms/types/options/label.rst.inc - -.. include:: /reference/forms/types/options/trim.rst.inc - -.. include:: /reference/forms/types/options/read_only.rst.inc - -.. include:: /reference/forms/types/options/disabled.rst.inc - -.. include:: /reference/forms/types/options/error_bubbling.rst.inc diff --git a/_sources/reference/index.txt b/_sources/reference/index.txt deleted file mode 100644 index 7d9b27e..0000000 --- a/_sources/reference/index.txt +++ /dev/null @@ -1,26 +0,0 @@ -Documentos de referencia ------------------------- - -.. toctree:: - :hidden: - - configuration/framework - configuration/assetic - configuration/doctrine - configuration/security - configuration/swiftmailer - configuration/twig - configuration/monolog - configuration/web_profiler - configuration/kernel - - forms/types - forms/twig_reference - - twig_reference - - constraints - dic_tags - requirements - -.. include:: /reference/map.rst.inc diff --git a/_sources/reference/requirements.txt b/_sources/reference/requirements.txt deleted file mode 100644 index 1257c51..0000000 --- a/_sources/reference/requirements.txt +++ /dev/null @@ -1,44 +0,0 @@ -.. index:: - single: Requisitos - -Requisitos para que funcione *Symfony2* -======================================= - -Para ejecutar *Symfony2*, el sistema debe cumplir con una lista de requisitos. Fácilmente puedes ver si el sistema pasa todos los requisitos ejecutando :file:`web/config.php` en tu distribución de *Symfony*. Debido a que la *CLI* (por *Command Line Interface* o Interfaz de la línea de ordenes) a menudo utiliza un archivo de configuración :file:`php.ini` diferente, también es una buena idea revisar tus requisitos desde la línea de ordenes por medio de: - -.. code-block:: bash - - $ php app/check.php - -A continuación mostramos la lista de requisitos obligatorios y opcionales. - -Obligatorio ------------ - -* *PHP* debe ser una versión mínima de *PHP 5.3.3* -* Es necesario habilitar *JSON* -* Es necesario tener habilitado el ``ctype`` -* Tu :file:`PHP.ini` debe tener configurado el valor ``date.timezone`` - -Opcional --------- - -* Necesitas tener instalado el módulo ``PHP-XML`` -* Necesitas tener por lo menos la versión 2.6.21 de ``libxml`` -* Necesitas activar el ``tokenizer`` de *PHP* -* tienes que habilitar las funciones ``mbstring`` -* tienes que activar ``iconv`` -* ``POSIX`` tiene que estar habilitado (únicamente en \*nix) -* Debes tener instalado *Intl* con *ICU 4+* -* *APC 3.0.17+* (u otra caché opcode debe estar instalada) -* Configuración recomendada en :file:`PHP.ini` - - * ``short_open_tag = Off`` - * ``magic_quotes_gpc = Off`` - * ``register_globals = Off`` - * ``session.autostart = Off`` - -*Doctrine* ----------- - -Si deseas utilizar *Doctrine*, necesitarás tener instalado *PDO*. Además, es necesario tener instalado el controlador de *PDO* para el servidor de base de datos que desees utilizar. diff --git a/_sources/reference/twig_reference.txt b/_sources/reference/twig_reference.txt deleted file mode 100644 index a023e37..0000000 --- a/_sources/reference/twig_reference.txt +++ /dev/null @@ -1,187 +0,0 @@ -.. index:: - single: Extensiones Twig de Symfony2 - -Extensiones *Twig* de *Symfony2* -================================ - -*Twig* es el motor de plantillas predeterminado en *Symfony2*. Por sí mismo, ya tiene integradas muchas funciones, filtros, etiquetas y pruebas (`http://gitnacho.github.com/Twig`_ luego desplázate hasta abajo). - -*Symfony2* añade más extensiones personalizadas en lo alto de *Twig* para integrar algunos componentes a las plantillas de *Twig*. Abajo está la información sobre todas las funciones personalizadas, filtros, etiquetas y pruebas añadidas usando el núcleo de la plataforma *Symfony2*. - -También puede haber etiquetas en los paquetes que utilizas comúnmente que no están enumeradas aquí. - -Funciones ---------- - -.. versionadded:: 2.1 - Las funciones ``csrf_token``, ``logout_path`` y ``logout_url`` se agregaron en *Symfony 2.1* - -.. versionadded:: 2.2 - The ``render`` and ``controller`` functions are new in Symfony 2.2. Anteriormente se utilizaba la etiqueta ``{% render %}`` y tenía una firma diferente. - -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| Function Syntax | Usage | -+====================================================+============================================================================================+ -| ``render(uri, options = {})`` | This will render the fragment for the given controller or URL | -| ``render(controller('B:C:a', {params}))`` | For more information, see :ref:`templating-embedding-controller`. | -| ``render(path('route', {params}))`` | :ref:`templating-embedding-controller`. | -| ``render(url('route', {params}))`` | | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``render_esi(controller('B:C:a', {params}))`` | Esta genera una etiqueta *ESI* cuando es posible o de lo contrario vuelve a caer | -| ``render_esi(url('route', {params}))`` | al comportamiento de ``render``. Para más | -| ``render_esi(path('route', {params}))`` | información, ve :ref:`templating-embedding-controller`. | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``render_hinclude(controller(...))`` | Esta genera una etiqueta ``hinclude`` para el controlador o la *URL* | -| ``render_hinclude(url('route', {params}))`` | dada. para más información, ve | -| ``render_hinclude(path('route', {params}))`` | | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``controller(attributes = {}, query = {})`` | Used along with the ``render`` tag to refer to the controller that you want to render. | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``asset(path, packageName = null)`` | Get the public path of the asset, more information in | -| | ":ref:`book-templating-assets`". | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``asset_version(packageName = null)`` | Obtiene la versión actual del paquete, más información en | -| | «:ref:`book-templating-assets`». | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``form_enctype(view)`` | Dibuja el atributo ``enctype="multipart/form-data"`` requerido si el formulario cuando | -| | menos tiene un campo para subir archivos, más información en la | -| | :ref:`Referencia de formularios Twig `. | -| | | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``form_widget(view, variables = {})`` | Dibuja un formulario completo o el HTML del elemento gráfico de un campo específico, más | -| | información en la | -| | :ref:`Referencia de formularios Twig `. | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``form_errors(view)`` | Dibuja cualquier error para el campo dado o los errores «globales», más información en la | -| | :ref:`Referencia de formularios Twig `. | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``form_label(view, label = null, variables = {})`` | Dibuja la etiqueta del campo dado, más información en la | -| | :ref:`Referencia de formularios Twig `. | -| | | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``form_row(view, variables = {})`` | Dibuja la fila (las etiquetas de los campos, errores y elementos gráficos) del campo dado, | -| | más información en la | -| | :ref:`Referencia de formularios Twig `. | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``form_rest(view, variables = {})`` | Dibuja todos los campos que no se han pintado todavía, más información en la | -| | :ref:`Referencia de formularios Twig `. | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``csrf_token(intention)`` | Dibuja un testigo CSRF. Usa esta función si deseas protección *CSRF* sin crear un | -| | formulario | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``is_granted(role, object = null, field = null)`` | Devuelve ``true`` si el usuario actual tiene el rol necesario, más información en | -| | «:ref:`book-security-template`» | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``logout_path(key)`` | Genera la *URL* relativa para cerrar la sesión del cortafuegos dado | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``logout_url(key)`` | Igual a ``logout_path(...)`` pero esta genera una *URL* absoluta | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``path(name, parameters = {})`` | Obtiene una *URL* relativa para la ruta dada, más información en | -| | «:ref:`book-templating-pages`». | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ -| ``url(name, parameters = {})`` | Igual a ``path(...)`` pero esta genera una *URL* absoluta | -+----------------------------------------------------+--------------------------------------------------------------------------------------------+ - -Filtros -------- - -.. versionadded:: 2.1 - El filtro ``humanize`` se añadió en *Symfony 2.1* - -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| Filter Syntax | Usage | -+=================================================================================+===================================================================+ -| ``text|humanize`` | Makes a technical name human readable (replaces underscores by | -| | spaces and capitalizes the string) | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``text|trans(arguments = {}, domain = 'messages', locale = null)`` | This will translate the text into the current language, more | -| | information in . | -| | :ref:`Translation Filters`. | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``text|transchoice(count, arguments = {}, domain = 'messages', locale = null)`` | This will translate the text with pluralization, more information | -| | in :ref:`Translation Filters`. | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``variable|yaml_encode(inline = 0)`` | Transforma el texto de la variable a la sintaxis de YAML. | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``variable|yaml_dump`` | Dibuja una sintaxis yaml con su tipo. | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``classname|abbr_class`` | Dibuja un elemento ``abbr`` con el nombre corto de una clase | -| | *PHP*. | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``methodname|abbr_method`` | Dibuja un método *PHP* dentro de un elemento ``abbr`` (p. ej. | -| | ``Symfony\Component\HttpFoundation\Response::getContent``) | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``arguments|format_args`` | Dibuja una cadena con los argumentos de una función y sus tipos | -| | | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``arguments|format_args_as_text`` | Igual a ``[...]|format_args``, pero le quita las etiquetas. | -| | | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``path|file_excerpt(line)`` | Dibuja un extracto de un archivo de código en torno a una | -| | determinada línea. | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``path|format_file(line, text = null)`` | Dibuja la ruta a un archivo en un enlace. | -| | | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``exceptionMessage|format_file_from_text`` | Igual a ``format_file`` excepto que añade a la cadena de error | -| | predefinida la ruta al archivo (es decir, 'en foo.php en la línea | -| | 45') | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ -| ``path|file_link(line)`` | Dibuja la ruta al archivo correcto (y número de línea) | -+---------------------------------------------------------------------------------+-------------------------------------------------------------------+ - -Etiquetas ---------- - -+---------------------------------------------------+--------------------------------------------------------------------+ -| Tag Syntax | Usage | -+===================================================+====================================================================+ -| ``{% form_theme form 'file' %}`` | This will look inside the given file for overridden form blocks, | -| | more information in :doc:`/cookbook/form/form_customization`. | -+---------------------------------------------------+--------------------------------------------------------------------+ -| ``{% trans with {variables} %}...{% endtrans %}`` | This will translate and render the text, more information in | -| | :ref:`book-translation-tags` | -+---------------------------------------------------+--------------------------------------------------------------------+ -| ``{% transchoice count with {variables} %}`` | This will translate and render the text with pluralization, more | -| ... | information in :ref:`book-translation-tags` | -| ``{% endtranschoice %}`` | | -+---------------------------------------------------+--------------------------------------------------------------------+ -| ``{% trans_default_domain language %}`` | This will set the default domain for message catalogues in the | -| | current template | -+---------------------------------------------------+--------------------------------------------------------------------+ - -Pruebas -------- - -.. versionadded:: 2.1 - La prueba ``selectedchoice`` se añadió en *Symfony 2.1* - -+---------------------------------------------------+------------------------------------------------------------------------------+ -| Sintaxis de la prueba | Uso | -+===================================================+==============================================================================+ -| ``selectedchoice(choice, selectedValue)`` | Devuelve ``true`` si la opción para el valor dado en el formulario | -| | está seleccionada | -+---------------------------------------------------+------------------------------------------------------------------------------+ - -Variables globales ------------------- - -+-------------------------------------------------------+------------------------------------------------------------------------------------+ -| Variable | Uso | -+=======================================================+====================================================================================+ -| ``app`` *Attributes*: ``app.user``, ``app.request`` | La variable ``app`` está disponible en todas partes, y proporciona rápido acceso a | -| ``app.session``, ``app.environment``, ``app.debug`` | muchos objetos necesarios comúnmente. La variable ``app`` es una instancia de | -| ``app.security`` | :class:`Symfony\\Bundle\\FrameworkBundle\\Templating\\GlobalVariables` | -+-------------------------------------------------------+------------------------------------------------------------------------------------+ - -Extensiones de la edición estándar de *Symfony* ------------------------------------------------ - -La edición estándar de *Symfony* añade algunos paquetes al núcleo de la plataforma *Symfony2*. -Dichos paquetes pueden tener otras extensiones de *Twig*: - -* **Extensión de Twig** incluye todas las extensiones que no pertenecen al núcleo de *Twig* pero pueden ser interesantes. Puedes leer más en la `documentación oficial de las Extensiones de Twig`_ -* **Assetic** añade las etiquetas ``{% stylesheets %}``, ``{% javascripts %}`` e ``{% image %}``. Puedes leer más sobre ellas en la :doc:`Documentación de Assetic `; - -.. _`documentación oficial de las Extensiones de Twig`: http://twig.sensiolabs.org/doc/extensions/index.html -.. _`http://gitnacho.github.com/Twig`: http://gitnacho.github.com/Twig/ diff --git a/_static/ajax-loader.gif b/_static/ajax-loader.gif deleted file mode 100644 index 61faf8c..0000000 Binary files a/_static/ajax-loader.gif and /dev/null differ diff --git a/_static/basic.css b/_static/basic.css deleted file mode 100644 index f0379f3..0000000 --- a/_static/basic.css +++ /dev/null @@ -1,540 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/* -- main layout ----------------------------------------------------------- */ - -div.clearer { - clear: both; -} - -/* -- relbar ---------------------------------------------------------------- */ - -div.related { - width: 100%; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -/* -- sidebar --------------------------------------------------------------- */ - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 230px; - margin-left: -100%; - font-size: 90%; -} - -div.sphinxsidebar ul { - list-style: none; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -div.sphinxsidebar input[type="text"] { - width: 170px; -} - -div.sphinxsidebar input[type="submit"] { - width: 30px; -} - -img { - border: 0; -} - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable { - width: 100%; -} - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable dl, table.indextable dd { - margin-top: 0; - margin-bottom: 0; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -div.modindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -/* -- general body styles --------------------------------------------------- */ - -a.headerlink { - visibility: hidden; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -.field-list ul { - padding-left: 1em; -} - -.first { - margin-top: 0 !important; -} - -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -img.align-left, .figure.align-left, object.align-left { - clear: left; - float: left; - margin-right: 1em; -} - -img.align-right, .figure.align-right, object.align-right { - clear: right; - float: right; - margin-left: 1em; -} - -img.align-center, .figure.align-center, object.align-center { - display: block; - margin-left: auto; - margin-right: auto; -} - -.align-left { - text-align: left; -} - -.align-center { - text-align: center; -} - -.align-right { - text-align: right; -} - -/* -- sidebars -------------------------------------------------------------- */ - -div.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px 7px 0 7px; - background-color: #ffe; - width: 40%; - float: right; -} - -p.sidebar-title { - font-weight: bold; -} - -/* -- topics ---------------------------------------------------------------- */ - -div.topic { - border: 1px solid #ccc; - padding: 7px 7px 0 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* -- admonitions ----------------------------------------------------------- */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -div.admonition dl { - margin-bottom: 0; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -/* -- tables ---------------------------------------------------------------- */ - -table.docutils { - border: 0; - border-collapse: collapse; -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 5px; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -table.field-list td, table.field-list th { - border: 0 !important; -} - -table.footnote td, table.footnote th { - border: 0 !important; -} - -th { - text-align: left; - padding-right: 5px; -} - -table.citation { - border-left: solid 1px gray; - margin-left: 1px; -} - -table.citation td { - border-bottom: none; -} - -/* -- other body styles ----------------------------------------------------- */ - -ol.arabic { - list-style: decimal; -} - -ol.loweralpha { - list-style: lower-alpha; -} - -ol.upperalpha { - list-style: upper-alpha; -} - -ol.lowerroman { - list-style: lower-roman; -} - -ol.upperroman { - list-style: upper-roman; -} - -dl { - margin-bottom: 15px; -} - -dd p { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -dt:target, .highlighted { - background-color: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -.refcount { - color: #060; -} - -.optional { - font-size: 1.3em; -} - -.versionmodified { - font-style: italic; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -.footnote:target { - background-color: #ffa; -} - -.line-block { - display: block; - margin-top: 1em; - margin-bottom: 1em; -} - -.line-block .line-block { - margin-top: 0; - margin-bottom: 0; - margin-left: 1.5em; -} - -.guilabel, .menuselection { - font-family: sans-serif; -} - -.accelerator { - text-decoration: underline; -} - -.classifier { - font-style: oblique; -} - -abbr, acronym { - border-bottom: dotted 1px; - cursor: help; -} - -/* -- code displays --------------------------------------------------------- */ - -pre { - overflow: auto; - overflow-y: hidden; /* fixes display issues on Chrome browsers */ -} - -td.linenos pre { - padding: 5px 0px; - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - margin-left: 0.5em; -} - -table.highlighttable td { - padding: 0 0.5em 0 0.5em; -} - -tt.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -tt.descclassname { - background-color: transparent; -} - -tt.xref, a tt { - background-color: transparent; - font-weight: bold; -} - -h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { - background-color: transparent; -} - -.viewcode-link { - float: right; -} - -.viewcode-back { - float: right; - font-family: sans-serif; -} - -div.viewcode-block:target { - margin: -1px -10px; - padding: 0 10px; -} - -/* -- math display ---------------------------------------------------------- */ - -img.math { - vertical-align: middle; -} - -div.body div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -/* -- printout stylesheet --------------------------------------------------- */ - -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0 !important; - width: 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - #top-link { - display: none; - } -} \ No newline at end of file diff --git a/_static/comment-bright.png b/_static/comment-bright.png deleted file mode 100644 index 551517b..0000000 Binary files a/_static/comment-bright.png and /dev/null differ diff --git a/_static/comment-close.png b/_static/comment-close.png deleted file mode 100644 index 09b54be..0000000 Binary files a/_static/comment-close.png and /dev/null differ diff --git a/_static/comment.png b/_static/comment.png deleted file mode 100644 index 92feb52..0000000 Binary files a/_static/comment.png and /dev/null differ diff --git a/_static/configurationblock.css b/_static/configurationblock.css deleted file mode 100644 index c1f987b..0000000 --- a/_static/configurationblock.css +++ /dev/null @@ -1,97 +0,0 @@ -div.configuration-block ul.simple -{ - margin: 0; - padding: 0; - margin-left: 30px; -} - -div.configuration-block ul.simple li -{ - margin: 0 !important; - margin-right: 5px !important; - display: inline; - margin-left: 10px; - padding: 10px; -} - -div.configuration-block em -{ - margin-bottom: 10px; -} - -div.configuration-block li -{ - padding: 5px; -} - -div.configuration-block em -{ - font-style: normal; - font-size: 90%; -} - -div.jsactive -{ - position: relative; -} - -div.jsactive ul -{ - list-style: none; -} - -div.jsactive li -{ - float: left; - list-style: none; - margin-left: 0; - -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; - background-color: #ddd; - margin-right: 5px; -} - -div.jsactive .selected -{ - background-color: #000; -} - -div.jsactive .selected a -{ - color: #fff; - text-decoration: none; -} - -div.jsactive .selected a:hover -{ - color: #fff; - text-decoration: underline; -} - -div.jsactive a -{ - color: #000; - text-decoration: none; -} - -div.jsactive a:hover -{ - color: #000; - text-decoration: underline; -} - -div.jsactive div -{ - position: absolute; - top: 30px; - left: 0; -} - -div.jsactive div div -{ - position: static; -} - -div.jsactive pre -{ - margin: 0; -} diff --git a/_static/configurationblock.js b/_static/configurationblock.js deleted file mode 100644 index 0f708a1..0000000 --- a/_static/configurationblock.js +++ /dev/null @@ -1,34 +0,0 @@ -$(document).ready(function(){ - $('div.configuration-block [class^=highlight-]').hide(); - $('div.configuration-block [class^=highlight-]').width($('div.configuration-block').width()); - - $('div.configuration-block').addClass('jsactive'); - $('div.configuration-block').addClass('clearfix'); - - $('div.configuration-block').each(function (){ - var el = $('[class^=highlight-]:first', $(this)); - el.show(); - el.parents('ul').height(el.height() + 40); - }); - - // Global - $('div.configuration-block li').each(function(){ - var str = $(':first', $(this)).html(); - $(':first ', $(this)).html(''); - $(':first ', $(this)).append('' + str + '') - $(':first', $(this)).bind('click', function(){ - $('[class^=highlight-]', $(this).parents('ul')).hide(); - $('li', $(this).parents('ul')).removeClass('selected'); - $(this).parent().addClass('selected'); - - var block = $('[class^=highlight-]', $(this).parent('li')); - block.show(); - block.parents('ul').height(block.height() + 40); - return false; - }); - }); - - $('div.configuration-block').each(function (){ - $('li:first', $(this)).addClass('selected'); - }); -}); diff --git a/_static/default.css b/_static/default.css deleted file mode 100644 index 1024c0b..0000000 --- a/_static/default.css +++ /dev/null @@ -1,960 +0,0 @@ -/* - * default.css_t - * ~~~~~~~~~~~~~ - * - * Sphinx stylesheet -- default theme. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -@import url("basic.css"); - -div.sphinxsidebar { - width: 300px; -} - -body,div,dl,dt,dd,ul,ol,li,h1,h2,h3,h4,h5,h6,pre,form,fieldset,input,textarea,p,blockquote,th,td,button { margin:0; padding:0; } -ul,li { list-style-type:none; } -select { min-width: 1.5em;} -select > option { padding: 0 2px 0 3px; } -form { margin: 0; padding: 0; } -img { border: 0; } -hr { clear:both; display: none; } -label { display: none; } -fieldset { border: 0; } -q:before,q:after { content:''; } -abbr,acronym { border:0; } - -.reset div, -.reset dl, -.reset dt, -.reset dd, -.reset ul, -.reset ol, -.reset li, -.reset h1, -.reset h2, -.reset h3, -.reset h4, -.reset h5, -.reset h6, -.reset pre, -.reset code, -.reset form, -.reset fieldset, -.reset legend, -.reset input, -.reset textarea, -.reset p, -.reset blockquote, -.reset th, -.reset td{margin:0 !important;padding:0 !important;} -.reset table{border-collapse:collapse !important;border-spacing:0 !important;} -.reset fieldset,.reset img{border:0 !important;} -.reset address, -.reset caption, -.reset cite, -.reset code, -.reset dfn, -.reset em, -.reset strong, -.reset th, -.reset var{font-style:normal !important;font-weight:normal !important;} -.reset li{list-style:none !important;} -.reset caption,.reset th{text-align:left !important;} -.reset h1,.reset h2,.reset h3,.reset h4,.reset h5,.reset h6{font-size:100% !important;font-weight:normal !important;} -.reset q:before,.reset q:after{content:'' !important;} -.reset abbr,.reset acronym {border:0 !important;font-variant:normal !important;} -/* to preserve line-height and selector appearance */ -.reset sup {vertical-align:text-top !important;} -.reset sub {vertical-align:text-bottom !important;} -.reset input,.reset textarea,.reset select{font-family:inherit !important;font-size:inherit !important;font-weight:inherit !important;} -/*to enable resizing for IE*/ -.reset input,.reset textarea,.reset select{*font-size:100% !important;} -/*because legend doesn't inherit in IE */ -.reset legend{color:#000 !important;} - -/* -- page layout ----------------------------------------------------------- */ - -div.document { - margin-right: 30px; -} - -div.documentwrapper { - float: left; - width: 100%; -} - -div.bodywrapper { - margin: 0 0 0 300px; -} - -div.body { - background-color: #ffffff; - color: #000000; -} - -div.footer { - color: #ffffff; - width: 100%; - padding: 9px 0 9px 0; - text-align: center; - font-size: 75%; -} - -div.footer a { - color: #ffffff; - text-decoration: underline; -} - -div.related { - background-color: #ffc; - width: 100%; - font-size: 90%; - margin-top: -40px; - height: 35px; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - float: left; - font-weight: bold; -} - -div.related li.right { - float: right; - margin-right: 5px !important; - margin-left: 5px !important; -} -div.sphinxsidebar { - background: #f2f2f2; -} - -div.sphinxsidebar h3 { - font-family: 'Trebuchet MS', sans-serif; - color: #000000; - font-size: 1.4em; - font-weight: normal; - margin: 0; - padding: 0; - margin-left: 0 !important; -} - -div.sphinxsidebar h3 a { - color: #000000; -} - -div.sphinxsidebar h4 { - font-family: 'Trebuchet MS', sans-serif; - color: #000000; - font-size: 1.3em; - font-weight: normal; - margin: 5px 0 0 0; - padding: 0; - margin-left: 0 !important; -} - -div.sphinxsidebar p { - color: #000000; -} - -div.sphinxsidebar p.topless { - margin: 5px 10px 10px 10px; -} - -div.sphinxsidebar ul { - margin: 0; - padding: 0; - color: #000000; -} - -div.sphinxsidebar ul li { - margin-left: 5px !important; -} - -div.sphinxsidebar a { - color: #000000; - font-weight: bold; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - - - -/* -- hyperlink styles ------------------------------------------------------ */ - -a { - color: #355f7c; - text-decoration: none; -} - -a:visited { - color: #355f7c; - text-decoration: none; -} - -a:hover { - text-decoration: underline; -} - - - -/* -- body styles ----------------------------------------------------------- */ - -div.body h1, -div.body h2, -div.body h3, -div.body h4, -div.body h5, -div.body h6 { - font-family: 'Trebuchet MS', sans-serif; - background-color: #f2f2f2; - font-weight: normal; - color: #20435c; - border-bottom: 1px solid #ccc; - margin: 20px -20px 10px -20px; - padding: 3px 0 3px 10px; -} - -div.body h1 { margin-top: 0; font-size: 200%; } -div.body h2 { font-size: 160%; } -div.body h3 { font-size: 140%; } -div.body h4 { font-size: 120%; } -div.body h5 { font-size: 110%; } -div.body h6 { font-size: 100%; } - -a.headerlink { - color: #c60f0f; - font-size: 0.8em; - padding: 0 4px 0 4px; - text-decoration: none; -} - -a.headerlink:hover { - background-color: #c60f0f; - color: white; -} - -div.body p, div.body dd, div.body li { - text-align: justify; - line-height: 130%; -} - -div.highlight { - margin-left: 30px; -} - -div.highlight pre { - margin-left: 0; -} - -div.admonition p.admonition-title + p { - display: inline; -} - -div.admonition p { - margin-bottom: 5px; -} - -div.admonition pre { - margin-bottom: 5px; -} - -div.admonition ul, div.admonition ol { - margin-bottom: 5px; -} - -div.note { - background-color: #eee; - border: 1px solid #ccc; -} - -div.seealso { - background-color: #ffc; - border: 1px solid #ff6; -} - -div.topic { - background-color: #eee; -} - -div.warning { - background-color: #ffe4e4; - border: 1px solid #f66; -} - -p.admonition-title { - display: inline; -} - -p.admonition-title:after { - content: ":"; -} - -pre { - padding: 5px; - background-color: #eeffcc; - color: #71777E; - line-height: 120%; - border-left: none; - border-right: none; - margin-left: 30px; -} - -tt { - background-color: #ecf0f3; - padding: 0 1px 0 1px; - font-size: 1.4em; -} - -th { - background-color: #ede; -} - -.warning tt { - background: #efc2c2; -} - -.note tt { - background: #d6d6d6; -} - -.viewcode-back { - font-family: sans-serif; -} - -div.viewcode-block:target { - background-color: #f4debf; - border-top: 1px solid #ac9; - border-bottom: 1px solid #ac9; -} - -img -{ - vertical-align: middle; -} - -.js_active -{ - cursor: pointer; - display: inline-block; - background: url(/images/btn-open.png) no-repeat 550px center; -} - -ul.error_list -{ - margin: 0; - list-style: none; - color: #f22; -} - -ul.error_list li -{ - list-style: none; -} - -pre -{ - padding: 0.7em; - background-color: #000; - line-height: 1.3em !important; - font-size: 100%; - color: #fff; -} - -pre code -{ - background-color: #000; -} - -pre.command-line -{ - background-color: #333; - color: #eee; - padding-bottom: 10px; -} - -pre.command-line code -{ - background-color: #333; -} - -blockquote -{ - padding: 2px 20px 5px 45px; - margin: 15px 0; - background-color: #fff; -} - -div.admonition -{ - padding: 2px 20px 5px 45px; - background-color: #fff; - margin-left: 30px; -} - -div.note -{ - background: #fff url(http://www.doctrine-project.org/images/note.png) no-repeat -5px -5px; -} - -div.caution -{ - background: #fff url(http://www.doctrine-project.org/images/caution.png) no-repeat -5px -5px; -} - -div.warning -{ - background: #fff url(http://www.doctrine-project.org/images/caution.png) no-repeat -5px -5px; -} - -div.tip -{ - background: #fff url(http://www.doctrine-project.org/images/tip.png) no-repeat -5px -5px; -} - -div.seealso -{ - background: #fff url(http://www.doctrine-project.org/images/tip.png) no-repeat -5px -5px; -} - -/* Note/Caution/Tip Boxes */ - -/* Note */ - -div.note { - padding: 5px 20px 5px 45px; - margin: 10px 0; - background: #ffd url(http://www.doctrine-project.org/images/note.png) no-repeat 5px 10px; -} - -/* Caution */ - -div.caution, div.warning { - padding: 5px 20px 5px 45px; - margin: 10px 0; - background: #ffd url(http://www.doctrine-project.org/images/caution.png) no-repeat 5px 10px; -} - -/* Tip */ - -div.tip { - padding: 5px 20px 5px 45px; - margin: 10px 0; - background: #ffd url(http://www.doctrine-project.org/images/tip.png) no-repeat 5px 10px; -} - -/* Sidebar */ - -div.seealso { - margin: 10px 0; - padding: 10px; - background: #ccc; -} - -div.seealso ul { - margin: 10px; -} - -div.seealso p.title { - margin: -20px; - margin-bottom: 10px !important; - padding: 10px !important; - background: #aaa; - color: #fff; - font-weight: bold; -} - -/* Shared Styles */ -div.note, div.caution, div.tip, div.seealso, div.warning { - overflow/**/: auto; - margin-left: 30px; - font-weight: normal; - min-height: 40px; - border: 1px solid #ddd; -} - -div.note p, div.caution p, div.tip p, div.seealso p, div.warning p { - margin: 0 !important; - padding: 0 !important; - padding-top: 10px; -} - -.admonition-title -{ - display: none !important; -} - -blockquote.quote -{ - background: #D7CABA; -} - -blockquote.sidebar -{ - padding: 10px; - background: #eee; -} - -blockquote.sidebar p.title -{ - margin: -10px; - margin-bottom: 10px; - padding: 10px; - background: #ddd; - font-style: italic; -} - -.navigation -{ - font-family: Arial, sans-serif; - padding: 10px 15px; - font-size: 0.9em; - text-align:center; - background-color: #e3e3e3; - border: 1px solid #e3e3e3; - -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; -} - -.navigation a -{ - text-decoration: none; -} - -.navigation a:hover -{ - text-decoration: underline; -} - -.navigation .separator -{ - padding: 0 10px; - color: #ccc; -} - -.feedback p -{ - font-family: Arial, sans-serif; - color: #858585; - font-size: 0.8em; -} - -.feedback h3 -{ - border-top: 1px solid #ddd; - font-family: Georgia, "Times New Roman", serif; - margin-top: 10px; - padding-top: 20px; - color: #858585; -} - -.toc -{ - margin-top: 10px; - padding: 10px; - background-color: #f1f1f1; - border: 1px solid #e3e3e3; - -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; - font-family: Arial, sans-serif; -} - -.toc h2 -{ - margin: 0; - padding: 0; -} - -.pages -{ - padding: 10px 0 0 0; -} - -.pages ul.inline -{ - display: inline; - padding: 5px 0 0 0; -} - -.pages .inline li -{ - display: inline; - margin: 0 5px; -} - -#quick-tour ul.simple -{ - padding: 5px 0 0 0; -} - -#quick-tour ul.simple li -{ - margin: 0; - margin-right: 5px; - display: inline; -} - -.toc a -{ - text-decoration: none; - color: #777; -} - -.toc a:hover -{ - text-decoration: underline; -} - -.bd .content .toc li -{ - padding: 2px; - list-style: square; - margin-left: 15px; -} - -.bd .content .toc li.current -{ - font-weight: bold; - background-color: #e3e3e3; -} - -.bd .content .toc ul.inline -{ - padding: 0; - margin: 0; - margin-left: 3px; -} - -.bd .content .toc .inline li -{ - margin: 0; - padding: 0; -} - -.bd .content .toc li.separator -{ - color: #ccc; -} - -#release_info -{ - background-color: #e3e3e3; - border: 1px solid #e3e3e3; - margin-bottom: 15px; - -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; - width: 290px; -} - -#license -{ - margin-top: 40px; - line-height: 1.2em; - font-size: 80%; -} - -#license img -{ - margin-right: 5px; -} - -table.docutils -{ - margin-bottom: 10px; -} - -table.docutils th -{ - font-weight:bold; - background-color: #efefef; -} - -table.docutils td, table.docutils th -{ - padding: 4px 6px; - border: 0; - border-bottom: 1px solid #ddd; - text-align: left; - vertical-align: top; -} - -.menu -{ - float: right; - width: 300px; - margin: 15px; - font-size: 0.7em; - background-color: #fff; - position: relative; - z-index: 999; -} - -#searchform -{ - display: inline; -} - -#search -{ - -webkit-appearance: searchfield; -} - -span.pre -{ - font-size: 85%; -} - -.bd .content .navigation li -{ - margin-left: 0; -} - -a.headerlink -{ - padding: 2px; - color: #ddd; - text-decoration: none; - font-size: 80%; -} - -a.reference em, a.internal em -{ - font-style: normal; -} - -#guides ul ul, #contributing ul ul -{ - display: inline; - padding: 5px 0 0 0; -} - -#guides ul ul li, #contributing ul ul li -{ - display: inline; - margin: 0; -} - -.sidebarbox -{ - margin-top: 10px; - padding: 10px; - background-color: #f1f1f1; - border: 1px solid #e3e3e3; - -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; - font-family: Arial, sans-serif; -} - -.sidebarbox h2 -{ - margin: 0; - padding: 0; -} - -.sidebarbox h3 -{ - margin: 0; - padding: 0; - margin-top: 5px; -} - -#searchbox h3 a.nolink -{ - padding: 0; - text-decoration: none; -} - -#searchbox h3 a.nolink:hover -{ - text-decoration: underline; -} - -div.breadcrumb h3 -{ - display: none; -} - -.bd .content div.breadcrumb ul -{ - margin: 0; - padding: 0; - list-style: none; - margin-top: 5px; -} - -.bd .content div.breadcrumb li -{ - display: inline; - margin: 0; - padding: 0; - line-height: 0.9em; -} - -.bd .content div.breadcrumb li a -{ - color: #777; - text-decoration: none; -} - -.bd .content div.breadcrumb li a:hover -{ - text-decoration: underline; -} - -.p-Indicator -{ - color: #FF8400; -} - -.bd .content ul.search li -{ - margin-left: 0; - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -div.genindex-jumpbox -{ - font-size: 85%; - border: 0; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox -{ - color: #999; -} - -div.genindex-jumpbox strong -{ - font-weight: normal; -} - -div.genindex-jumpbox a -{ - padding: 0 4px; -} - -h2#A, h2#B, h2#C, h2#D, h2#E, h2#F, h2#G, h2#H, h2#I, h2#J, h2#K, h2#L, h2#M, h2#N, h2#O, -h2#P, h2#Q, h2#R, h2#S, h2#T, h2#U, h2#V, h2#W, h2#X, h2#Y, h2#Z -{ - background-color: #eee; - border-bottom: 1px solid #aaa; - font-size: 120%; - font-weight: bold; - margin: 20px 0; - padding: 5px; -} - -.indextable a, div.genindex-jumpbox a -{ - text-decoration: none; -} - -.indextable a:hover, div.genindex-jumpbox a:hover -{ - text-decoration: underline; -} - -div.configuration-block em -{ - margin-bottom: 10px; -} - -.bd .content div.configuration-block li -{ - padding: 5px; -} - -.bd .content div.configuration-block em -{ - font-style: normal; - font-size: 90%; -} - -div.jsactive -{ - position: relative; -} - -.bd .content div.jsactive ul -{ - list-style: none; -} - -.bd .content div.jsactive li -{ - float: left; - list-style: none; - margin-left: 0; - -moz-border-radius: 5px; -webkit-border-radius: 5px; border-radius: 5px; - background-color: #ddd; - margin-right: 5px; -} - -.bd .content div.jsactive .selected -{ - background-color: #000; -} - -.bd .content div.jsactive .selected a -{ - color: #fff; - text-decoration: none; -} - -.bd .content div.jsactive .selected a:hover -{ - color: #fff; - text-decoration: underline; -} - -.bd .content div.jsactive a -{ - color: #000; - text-decoration: none; -} - -.bd .content div.jsactive a:hover -{ - color: #000; - text-decoration: underline; -} - -div.jsactive div -{ - position: absolute; - top: 30px; - left: 0; -} - -div.jsactive div div -{ - position: static; -} - -div.jsactive pre -{ - margin: 0; -} - -.highlight -{ - overflow: auto; - margin-bottom: 10px; -} \ No newline at end of file diff --git a/_static/doctools.js b/_static/doctools.js deleted file mode 100644 index d4619fd..0000000 --- a/_static/doctools.js +++ /dev/null @@ -1,247 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Sphinx JavaScript utilities for all documentation. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - -/** - * make the code below compatible with browsers without - * an installed firebug like debugger -if (!window.console || !console.firebug) { - var names = ["log", "debug", "info", "warn", "error", "assert", "dir", - "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", - "profile", "profileEnd"]; - window.console = {}; - for (var i = 0; i < names.length; ++i) - window.console[names[i]] = function() {}; -} - */ - -/** - * small helper function to urldecode strings - */ -jQuery.urldecode = function(x) { - return decodeURIComponent(x).replace(/\+/g, ' '); -} - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s == 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -}; - -/** - * small function to check if an array contains - * a given item. - */ -jQuery.contains = function(arr, item) { - for (var i = 0; i < arr.length; i++) { - if (arr[i] == item) - return true; - } - return false; -}; - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node) { - if (node.nodeType == 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { - var span = document.createElement("span"); - span.className = className; - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this); - }); - } - } - return this.each(function() { - highlight(this); - }); -}; - -/** - * Small JavaScript module for the documentation. - */ -var Documentation = { - - init : function() { - this.fixFirefoxAnchorBug(); - this.highlightSearchWords(); - this.initIndexTable(); - }, - - /** - * i18n support - */ - TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, - LOCALE : 'unknown', - - // gettext and ngettext don't access this so that the functions - // can safely bound to a different name (_ = Documentation.gettext) - gettext : function(string) { - var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated == 'undefined') - return string; - return (typeof translated == 'string') ? translated : translated[0]; - }, - - ngettext : function(singular, plural, n) { - var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated == 'undefined') - return (n == 1) ? singular : plural; - return translated[Documentation.PLURALEXPR(n)]; - }, - - addTranslations : function(catalog) { - for (var key in catalog.messages) - this.TRANSLATIONS[key] = catalog.messages[key]; - this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); - this.LOCALE = catalog.locale; - }, - - /** - * add context elements like header anchor links - */ - addContextElements : function() { - $('div[id] > :header:first').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this headline')). - appendTo(this); - }); - $('dt[id]').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this definition')). - appendTo(this); - }); - }, - - /** - * workaround a firefox stupidity - */ - fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) - window.setTimeout(function() { - document.location.href += ''; - }, 10); - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords : function() { - var params = $.getQueryParameters(); - var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; - if (terms.length) { - var body = $('div.body'); - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlighted'); - }); - }, 10); - $('

      ' + _('Hide Search Matches') + '

      ') - .appendTo($('#searchbox')); - } - }, - - /** - * init the domain index toggle buttons - */ - initIndexTable : function() { - var togglers = $('img.toggler').click(function() { - var src = $(this).attr('src'); - var idnum = $(this).attr('id').substr(7); - $('tr.cg-' + idnum).toggle(); - if (src.substr(-9) == 'minus.png') - $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); - else - $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); - }).css('display', ''); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { - togglers.click(); - } - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords : function() { - $('#searchbox .highlight-link').fadeOut(300); - $('span.highlighted').removeClass('highlighted'); - }, - - /** - * make the url absolute - */ - makeURL : function(relativeURL) { - return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; - }, - - /** - * get the current relative url - */ - getCurrentURL : function() { - var path = document.location.pathname; - var parts = path.split(/\//); - $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this == '..') - parts.pop(); - }); - var url = parts.join('/'); - return path.substring(url.lastIndexOf('/') + 1, path.length - 1); - } -}; - -// quick alias for translations -_ = Documentation.gettext; - -$(document).ready(function() { - Documentation.init(); -}); diff --git a/_static/down-pressed.png b/_static/down-pressed.png deleted file mode 100644 index 6f7ad78..0000000 Binary files a/_static/down-pressed.png and /dev/null differ diff --git a/_static/down.png b/_static/down.png deleted file mode 100644 index 3003a88..0000000 Binary files a/_static/down.png and /dev/null differ diff --git a/_static/file.png b/_static/file.png deleted file mode 100644 index d18082e..0000000 Binary files a/_static/file.png and /dev/null differ diff --git a/_static/icotnp.ico b/_static/icotnp.ico deleted file mode 100644 index 55dea01..0000000 Binary files a/_static/icotnp.ico and /dev/null differ diff --git a/_static/jquery.js b/_static/jquery.js deleted file mode 100644 index 7c24308..0000000 --- a/_static/jquery.js +++ /dev/null @@ -1,154 +0,0 @@ -/*! - * jQuery JavaScript Library v1.4.2 - * http://jquery.com/ - * - * Copyright 2010, John Resig - * Dual licensed under the MIT or GPL Version 2 licenses. - * http://jquery.org/license - * - * Includes Sizzle.js - * http://sizzlejs.com/ - * Copyright 2010, The Dojo Foundation - * Released under the MIT, BSD, and GPL Licenses. - * - * Date: Sat Feb 13 22:33:48 2010 -0500 - */ -(function(A,w){function ma(){if(!c.isReady){try{s.documentElement.doScroll("left")}catch(a){setTimeout(ma,1);return}c.ready()}}function Qa(a,b){b.src?c.ajax({url:b.src,async:false,dataType:"script"}):c.globalEval(b.text||b.textContent||b.innerHTML||"");b.parentNode&&b.parentNode.removeChild(b)}function X(a,b,d,f,e,j){var i=a.length;if(typeof b==="object"){for(var o in b)X(a,o,b[o],f,e,d);return a}if(d!==w){f=!j&&f&&c.isFunction(d);for(o=0;o)[^>]*$|^#([\w-]+)$/,Ua=/^.[^:#\[\.,]*$/,Va=/\S/, -Wa=/^(\s|\u00A0)+|(\s|\u00A0)+$/g,Xa=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,P=navigator.userAgent,xa=false,Q=[],L,$=Object.prototype.toString,aa=Object.prototype.hasOwnProperty,ba=Array.prototype.push,R=Array.prototype.slice,ya=Array.prototype.indexOf;c.fn=c.prototype={init:function(a,b){var d,f;if(!a)return this;if(a.nodeType){this.context=this[0]=a;this.length=1;return this}if(a==="body"&&!b){this.context=s;this[0]=s.body;this.selector="body";this.length=1;return this}if(typeof a==="string")if((d=Ta.exec(a))&& -(d[1]||!b))if(d[1]){f=b?b.ownerDocument||b:s;if(a=Xa.exec(a))if(c.isPlainObject(b)){a=[s.createElement(a[1])];c.fn.attr.call(a,b,true)}else a=[f.createElement(a[1])];else{a=sa([d[1]],[f]);a=(a.cacheable?a.fragment.cloneNode(true):a.fragment).childNodes}return c.merge(this,a)}else{if(b=s.getElementById(d[2])){if(b.id!==d[2])return T.find(a);this.length=1;this[0]=b}this.context=s;this.selector=a;return this}else if(!b&&/^\w+$/.test(a)){this.selector=a;this.context=s;a=s.getElementsByTagName(a);return c.merge(this, -a)}else return!b||b.jquery?(b||T).find(a):c(b).find(a);else if(c.isFunction(a))return T.ready(a);if(a.selector!==w){this.selector=a.selector;this.context=a.context}return c.makeArray(a,this)},selector:"",jquery:"1.4.2",length:0,size:function(){return this.length},toArray:function(){return R.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this.slice(a)[0]:this[a]},pushStack:function(a,b,d){var f=c();c.isArray(a)?ba.apply(f,a):c.merge(f,a);f.prevObject=this;f.context=this.context;if(b=== -"find")f.selector=this.selector+(this.selector?" ":"")+d;else if(b)f.selector=this.selector+"."+b+"("+d+")";return f},each:function(a,b){return c.each(this,a,b)},ready:function(a){c.bindReady();if(c.isReady)a.call(s,c);else Q&&Q.push(a);return this},eq:function(a){return a===-1?this.slice(a):this.slice(a,+a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(R.apply(this,arguments),"slice",R.call(arguments).join(","))},map:function(a){return this.pushStack(c.map(this, -function(b,d){return a.call(b,d,b)}))},end:function(){return this.prevObject||c(null)},push:ba,sort:[].sort,splice:[].splice};c.fn.init.prototype=c.fn;c.extend=c.fn.extend=function(){var a=arguments[0]||{},b=1,d=arguments.length,f=false,e,j,i,o;if(typeof a==="boolean"){f=a;a=arguments[1]||{};b=2}if(typeof a!=="object"&&!c.isFunction(a))a={};if(d===b){a=this;--b}for(;b
      a"; -var e=d.getElementsByTagName("*"),j=d.getElementsByTagName("a")[0];if(!(!e||!e.length||!j)){c.support={leadingWhitespace:d.firstChild.nodeType===3,tbody:!d.getElementsByTagName("tbody").length,htmlSerialize:!!d.getElementsByTagName("link").length,style:/red/.test(j.getAttribute("style")),hrefNormalized:j.getAttribute("href")==="/a",opacity:/^0.55$/.test(j.style.opacity),cssFloat:!!j.style.cssFloat,checkOn:d.getElementsByTagName("input")[0].value==="on",optSelected:s.createElement("select").appendChild(s.createElement("option")).selected, -parentNode:d.removeChild(d.appendChild(s.createElement("div"))).parentNode===null,deleteExpando:true,checkClone:false,scriptEval:false,noCloneEvent:true,boxModel:null};b.type="text/javascript";try{b.appendChild(s.createTextNode("window."+f+"=1;"))}catch(i){}a.insertBefore(b,a.firstChild);if(A[f]){c.support.scriptEval=true;delete A[f]}try{delete b.test}catch(o){c.support.deleteExpando=false}a.removeChild(b);if(d.attachEvent&&d.fireEvent){d.attachEvent("onclick",function k(){c.support.noCloneEvent= -false;d.detachEvent("onclick",k)});d.cloneNode(true).fireEvent("onclick")}d=s.createElement("div");d.innerHTML="";a=s.createDocumentFragment();a.appendChild(d.firstChild);c.support.checkClone=a.cloneNode(true).cloneNode(true).lastChild.checked;c(function(){var k=s.createElement("div");k.style.width=k.style.paddingLeft="1px";s.body.appendChild(k);c.boxModel=c.support.boxModel=k.offsetWidth===2;s.body.removeChild(k).style.display="none"});a=function(k){var n= -s.createElement("div");k="on"+k;var r=k in n;if(!r){n.setAttribute(k,"return;");r=typeof n[k]==="function"}return r};c.support.submitBubbles=a("submit");c.support.changeBubbles=a("change");a=b=d=e=j=null}})();c.props={"for":"htmlFor","class":"className",readonly:"readOnly",maxlength:"maxLength",cellspacing:"cellSpacing",rowspan:"rowSpan",colspan:"colSpan",tabindex:"tabIndex",usemap:"useMap",frameborder:"frameBorder"};var G="jQuery"+J(),Ya=0,za={};c.extend({cache:{},expando:G,noData:{embed:true,object:true, -applet:true},data:function(a,b,d){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var f=a[G],e=c.cache;if(!f&&typeof b==="string"&&d===w)return null;f||(f=++Ya);if(typeof b==="object"){a[G]=f;e[f]=c.extend(true,{},b)}else if(!e[f]){a[G]=f;e[f]={}}a=e[f];if(d!==w)a[b]=d;return typeof b==="string"?a[b]:a}},removeData:function(a,b){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var d=a[G],f=c.cache,e=f[d];if(b){if(e){delete e[b];c.isEmptyObject(e)&&c.removeData(a)}}else{if(c.support.deleteExpando)delete a[c.expando]; -else a.removeAttribute&&a.removeAttribute(c.expando);delete f[d]}}}});c.fn.extend({data:function(a,b){if(typeof a==="undefined"&&this.length)return c.data(this[0]);else if(typeof a==="object")return this.each(function(){c.data(this,a)});var d=a.split(".");d[1]=d[1]?"."+d[1]:"";if(b===w){var f=this.triggerHandler("getData"+d[1]+"!",[d[0]]);if(f===w&&this.length)f=c.data(this[0],a);return f===w&&d[1]?this.data(d[0]):f}else return this.trigger("setData"+d[1]+"!",[d[0],b]).each(function(){c.data(this, -a,b)})},removeData:function(a){return this.each(function(){c.removeData(this,a)})}});c.extend({queue:function(a,b,d){if(a){b=(b||"fx")+"queue";var f=c.data(a,b);if(!d)return f||[];if(!f||c.isArray(d))f=c.data(a,b,c.makeArray(d));else f.push(d);return f}},dequeue:function(a,b){b=b||"fx";var d=c.queue(a,b),f=d.shift();if(f==="inprogress")f=d.shift();if(f){b==="fx"&&d.unshift("inprogress");f.call(a,function(){c.dequeue(a,b)})}}});c.fn.extend({queue:function(a,b){if(typeof a!=="string"){b=a;a="fx"}if(b=== -w)return c.queue(this[0],a);return this.each(function(){var d=c.queue(this,a,b);a==="fx"&&d[0]!=="inprogress"&&c.dequeue(this,a)})},dequeue:function(a){return this.each(function(){c.dequeue(this,a)})},delay:function(a,b){a=c.fx?c.fx.speeds[a]||a:a;b=b||"fx";return this.queue(b,function(){var d=this;setTimeout(function(){c.dequeue(d,b)},a)})},clearQueue:function(a){return this.queue(a||"fx",[])}});var Aa=/[\n\t]/g,ca=/\s+/,Za=/\r/g,$a=/href|src|style/,ab=/(button|input)/i,bb=/(button|input|object|select|textarea)/i, -cb=/^(a|area)$/i,Ba=/radio|checkbox/;c.fn.extend({attr:function(a,b){return X(this,a,b,true,c.attr)},removeAttr:function(a){return this.each(function(){c.attr(this,a,"");this.nodeType===1&&this.removeAttribute(a)})},addClass:function(a){if(c.isFunction(a))return this.each(function(n){var r=c(this);r.addClass(a.call(this,n,r.attr("class")))});if(a&&typeof a==="string")for(var b=(a||"").split(ca),d=0,f=this.length;d-1)return true;return false},val:function(a){if(a===w){var b=this[0];if(b){if(c.nodeName(b,"option"))return(b.attributes.value||{}).specified?b.value:b.text;if(c.nodeName(b,"select")){var d=b.selectedIndex,f=[],e=b.options;b=b.type==="select-one";if(d<0)return null;var j=b?d:0;for(d=b?d+1:e.length;j=0;else if(c.nodeName(this,"select")){var u=c.makeArray(r);c("option",this).each(function(){this.selected= -c.inArray(c(this).val(),u)>=0});if(!u.length)this.selectedIndex=-1}else this.value=r}})}});c.extend({attrFn:{val:true,css:true,html:true,text:true,data:true,width:true,height:true,offset:true},attr:function(a,b,d,f){if(!a||a.nodeType===3||a.nodeType===8)return w;if(f&&b in c.attrFn)return c(a)[b](d);f=a.nodeType!==1||!c.isXMLDoc(a);var e=d!==w;b=f&&c.props[b]||b;if(a.nodeType===1){var j=$a.test(b);if(b in a&&f&&!j){if(e){b==="type"&&ab.test(a.nodeName)&&a.parentNode&&c.error("type property can't be changed"); -a[b]=d}if(c.nodeName(a,"form")&&a.getAttributeNode(b))return a.getAttributeNode(b).nodeValue;if(b==="tabIndex")return(b=a.getAttributeNode("tabIndex"))&&b.specified?b.value:bb.test(a.nodeName)||cb.test(a.nodeName)&&a.href?0:w;return a[b]}if(!c.support.style&&f&&b==="style"){if(e)a.style.cssText=""+d;return a.style.cssText}e&&a.setAttribute(b,""+d);a=!c.support.hrefNormalized&&f&&j?a.getAttribute(b,2):a.getAttribute(b);return a===null?w:a}return c.style(a,b,d)}});var O=/\.(.*)$/,db=function(a){return a.replace(/[^\w\s\.\|`]/g, -function(b){return"\\"+b})};c.event={add:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){if(a.setInterval&&a!==A&&!a.frameElement)a=A;var e,j;if(d.handler){e=d;d=e.handler}if(!d.guid)d.guid=c.guid++;if(j=c.data(a)){var i=j.events=j.events||{},o=j.handle;if(!o)j.handle=o=function(){return typeof c!=="undefined"&&!c.event.triggered?c.event.handle.apply(o.elem,arguments):w};o.elem=a;b=b.split(" ");for(var k,n=0,r;k=b[n++];){j=e?c.extend({},e):{handler:d,data:f};if(k.indexOf(".")>-1){r=k.split("."); -k=r.shift();j.namespace=r.slice(0).sort().join(".")}else{r=[];j.namespace=""}j.type=k;j.guid=d.guid;var u=i[k],z=c.event.special[k]||{};if(!u){u=i[k]=[];if(!z.setup||z.setup.call(a,f,r,o)===false)if(a.addEventListener)a.addEventListener(k,o,false);else a.attachEvent&&a.attachEvent("on"+k,o)}if(z.add){z.add.call(a,j);if(!j.handler.guid)j.handler.guid=d.guid}u.push(j);c.event.global[k]=true}a=null}}},global:{},remove:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){var e,j=0,i,o,k,n,r,u,z=c.data(a), -C=z&&z.events;if(z&&C){if(b&&b.type){d=b.handler;b=b.type}if(!b||typeof b==="string"&&b.charAt(0)==="."){b=b||"";for(e in C)c.event.remove(a,e+b)}else{for(b=b.split(" ");e=b[j++];){n=e;i=e.indexOf(".")<0;o=[];if(!i){o=e.split(".");e=o.shift();k=new RegExp("(^|\\.)"+c.map(o.slice(0).sort(),db).join("\\.(?:.*\\.)?")+"(\\.|$)")}if(r=C[e])if(d){n=c.event.special[e]||{};for(B=f||0;B=0){a.type= -e=e.slice(0,-1);a.exclusive=true}if(!d){a.stopPropagation();c.event.global[e]&&c.each(c.cache,function(){this.events&&this.events[e]&&c.event.trigger(a,b,this.handle.elem)})}if(!d||d.nodeType===3||d.nodeType===8)return w;a.result=w;a.target=d;b=c.makeArray(b);b.unshift(a)}a.currentTarget=d;(f=c.data(d,"handle"))&&f.apply(d,b);f=d.parentNode||d.ownerDocument;try{if(!(d&&d.nodeName&&c.noData[d.nodeName.toLowerCase()]))if(d["on"+e]&&d["on"+e].apply(d,b)===false)a.result=false}catch(j){}if(!a.isPropagationStopped()&& -f)c.event.trigger(a,b,f,true);else if(!a.isDefaultPrevented()){f=a.target;var i,o=c.nodeName(f,"a")&&e==="click",k=c.event.special[e]||{};if((!k._default||k._default.call(d,a)===false)&&!o&&!(f&&f.nodeName&&c.noData[f.nodeName.toLowerCase()])){try{if(f[e]){if(i=f["on"+e])f["on"+e]=null;c.event.triggered=true;f[e]()}}catch(n){}if(i)f["on"+e]=i;c.event.triggered=false}}},handle:function(a){var b,d,f,e;a=arguments[0]=c.event.fix(a||A.event);a.currentTarget=this;b=a.type.indexOf(".")<0&&!a.exclusive; -if(!b){d=a.type.split(".");a.type=d.shift();f=new RegExp("(^|\\.)"+d.slice(0).sort().join("\\.(?:.*\\.)?")+"(\\.|$)")}e=c.data(this,"events");d=e[a.type];if(e&&d){d=d.slice(0);e=0;for(var j=d.length;e-1?c.map(a.options,function(f){return f.selected}).join("-"):"";else if(a.nodeName.toLowerCase()==="select")d=a.selectedIndex;return d},fa=function(a,b){var d=a.target,f,e;if(!(!da.test(d.nodeName)||d.readOnly)){f=c.data(d,"_change_data");e=Fa(d);if(a.type!=="focusout"||d.type!=="radio")c.data(d,"_change_data", -e);if(!(f===w||e===f))if(f!=null||e){a.type="change";return c.event.trigger(a,b,d)}}};c.event.special.change={filters:{focusout:fa,click:function(a){var b=a.target,d=b.type;if(d==="radio"||d==="checkbox"||b.nodeName.toLowerCase()==="select")return fa.call(this,a)},keydown:function(a){var b=a.target,d=b.type;if(a.keyCode===13&&b.nodeName.toLowerCase()!=="textarea"||a.keyCode===32&&(d==="checkbox"||d==="radio")||d==="select-multiple")return fa.call(this,a)},beforeactivate:function(a){a=a.target;c.data(a, -"_change_data",Fa(a))}},setup:function(){if(this.type==="file")return false;for(var a in ea)c.event.add(this,a+".specialChange",ea[a]);return da.test(this.nodeName)},teardown:function(){c.event.remove(this,".specialChange");return da.test(this.nodeName)}};ea=c.event.special.change.filters}s.addEventListener&&c.each({focus:"focusin",blur:"focusout"},function(a,b){function d(f){f=c.event.fix(f);f.type=b;return c.event.handle.call(this,f)}c.event.special[b]={setup:function(){this.addEventListener(a, -d,true)},teardown:function(){this.removeEventListener(a,d,true)}}});c.each(["bind","one"],function(a,b){c.fn[b]=function(d,f,e){if(typeof d==="object"){for(var j in d)this[b](j,f,d[j],e);return this}if(c.isFunction(f)){e=f;f=w}var i=b==="one"?c.proxy(e,function(k){c(this).unbind(k,i);return e.apply(this,arguments)}):e;if(d==="unload"&&b!=="one")this.one(d,f,e);else{j=0;for(var o=this.length;j0){y=t;break}}t=t[g]}m[q]=y}}}var f=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^[\]]*\]|['"][^'"]*['"]|[^[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, -e=0,j=Object.prototype.toString,i=false,o=true;[0,0].sort(function(){o=false;return 0});var k=function(g,h,l,m){l=l||[];var q=h=h||s;if(h.nodeType!==1&&h.nodeType!==9)return[];if(!g||typeof g!=="string")return l;for(var p=[],v,t,y,S,H=true,M=x(h),I=g;(f.exec(""),v=f.exec(I))!==null;){I=v[3];p.push(v[1]);if(v[2]){S=v[3];break}}if(p.length>1&&r.exec(g))if(p.length===2&&n.relative[p[0]])t=ga(p[0]+p[1],h);else for(t=n.relative[p[0]]?[h]:k(p.shift(),h);p.length;){g=p.shift();if(n.relative[g])g+=p.shift(); -t=ga(g,t)}else{if(!m&&p.length>1&&h.nodeType===9&&!M&&n.match.ID.test(p[0])&&!n.match.ID.test(p[p.length-1])){v=k.find(p.shift(),h,M);h=v.expr?k.filter(v.expr,v.set)[0]:v.set[0]}if(h){v=m?{expr:p.pop(),set:z(m)}:k.find(p.pop(),p.length===1&&(p[0]==="~"||p[0]==="+")&&h.parentNode?h.parentNode:h,M);t=v.expr?k.filter(v.expr,v.set):v.set;if(p.length>0)y=z(t);else H=false;for(;p.length;){var D=p.pop();v=D;if(n.relative[D])v=p.pop();else D="";if(v==null)v=h;n.relative[D](y,v,M)}}else y=[]}y||(y=t);y||k.error(D|| -g);if(j.call(y)==="[object Array]")if(H)if(h&&h.nodeType===1)for(g=0;y[g]!=null;g++){if(y[g]&&(y[g]===true||y[g].nodeType===1&&E(h,y[g])))l.push(t[g])}else for(g=0;y[g]!=null;g++)y[g]&&y[g].nodeType===1&&l.push(t[g]);else l.push.apply(l,y);else z(y,l);if(S){k(S,q,l,m);k.uniqueSort(l)}return l};k.uniqueSort=function(g){if(B){i=o;g.sort(B);if(i)for(var h=1;h":function(g,h){var l=typeof h==="string";if(l&&!/\W/.test(h)){h=h.toLowerCase();for(var m=0,q=g.length;m=0))l||m.push(v);else if(l)h[p]=false;return false},ID:function(g){return g[1].replace(/\\/g,"")},TAG:function(g){return g[1].toLowerCase()}, -CHILD:function(g){if(g[1]==="nth"){var h=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(g[2]==="even"&&"2n"||g[2]==="odd"&&"2n+1"||!/\D/.test(g[2])&&"0n+"+g[2]||g[2]);g[2]=h[1]+(h[2]||1)-0;g[3]=h[3]-0}g[0]=e++;return g},ATTR:function(g,h,l,m,q,p){h=g[1].replace(/\\/g,"");if(!p&&n.attrMap[h])g[1]=n.attrMap[h];if(g[2]==="~=")g[4]=" "+g[4]+" ";return g},PSEUDO:function(g,h,l,m,q){if(g[1]==="not")if((f.exec(g[3])||"").length>1||/^\w/.test(g[3]))g[3]=k(g[3],null,null,h);else{g=k.filter(g[3],h,l,true^q);l||m.push.apply(m, -g);return false}else if(n.match.POS.test(g[0])||n.match.CHILD.test(g[0]))return true;return g},POS:function(g){g.unshift(true);return g}},filters:{enabled:function(g){return g.disabled===false&&g.type!=="hidden"},disabled:function(g){return g.disabled===true},checked:function(g){return g.checked===true},selected:function(g){return g.selected===true},parent:function(g){return!!g.firstChild},empty:function(g){return!g.firstChild},has:function(g,h,l){return!!k(l[3],g).length},header:function(g){return/h\d/i.test(g.nodeName)}, -text:function(g){return"text"===g.type},radio:function(g){return"radio"===g.type},checkbox:function(g){return"checkbox"===g.type},file:function(g){return"file"===g.type},password:function(g){return"password"===g.type},submit:function(g){return"submit"===g.type},image:function(g){return"image"===g.type},reset:function(g){return"reset"===g.type},button:function(g){return"button"===g.type||g.nodeName.toLowerCase()==="button"},input:function(g){return/input|select|textarea|button/i.test(g.nodeName)}}, -setFilters:{first:function(g,h){return h===0},last:function(g,h,l,m){return h===m.length-1},even:function(g,h){return h%2===0},odd:function(g,h){return h%2===1},lt:function(g,h,l){return hl[3]-0},nth:function(g,h,l){return l[3]-0===h},eq:function(g,h,l){return l[3]-0===h}},filter:{PSEUDO:function(g,h,l,m){var q=h[1],p=n.filters[q];if(p)return p(g,l,h,m);else if(q==="contains")return(g.textContent||g.innerText||a([g])||"").indexOf(h[3])>=0;else if(q==="not"){h= -h[3];l=0;for(m=h.length;l=0}},ID:function(g,h){return g.nodeType===1&&g.getAttribute("id")===h},TAG:function(g,h){return h==="*"&&g.nodeType===1||g.nodeName.toLowerCase()===h},CLASS:function(g,h){return(" "+(g.className||g.getAttribute("class"))+" ").indexOf(h)>-1},ATTR:function(g,h){var l=h[1];g=n.attrHandle[l]?n.attrHandle[l](g):g[l]!=null?g[l]:g.getAttribute(l);l=g+"";var m=h[2];h=h[4];return g==null?m==="!=":m=== -"="?l===h:m==="*="?l.indexOf(h)>=0:m==="~="?(" "+l+" ").indexOf(h)>=0:!h?l&&g!==false:m==="!="?l!==h:m==="^="?l.indexOf(h)===0:m==="$="?l.substr(l.length-h.length)===h:m==="|="?l===h||l.substr(0,h.length+1)===h+"-":false},POS:function(g,h,l,m){var q=n.setFilters[h[2]];if(q)return q(g,l,h,m)}}},r=n.match.POS;for(var u in n.match){n.match[u]=new RegExp(n.match[u].source+/(?![^\[]*\])(?![^\(]*\))/.source);n.leftMatch[u]=new RegExp(/(^(?:.|\r|\n)*?)/.source+n.match[u].source.replace(/\\(\d+)/g,function(g, -h){return"\\"+(h-0+1)}))}var z=function(g,h){g=Array.prototype.slice.call(g,0);if(h){h.push.apply(h,g);return h}return g};try{Array.prototype.slice.call(s.documentElement.childNodes,0)}catch(C){z=function(g,h){h=h||[];if(j.call(g)==="[object Array]")Array.prototype.push.apply(h,g);else if(typeof g.length==="number")for(var l=0,m=g.length;l";var l=s.documentElement;l.insertBefore(g,l.firstChild);if(s.getElementById(h)){n.find.ID=function(m,q,p){if(typeof q.getElementById!=="undefined"&&!p)return(q=q.getElementById(m[1]))?q.id===m[1]||typeof q.getAttributeNode!=="undefined"&& -q.getAttributeNode("id").nodeValue===m[1]?[q]:w:[]};n.filter.ID=function(m,q){var p=typeof m.getAttributeNode!=="undefined"&&m.getAttributeNode("id");return m.nodeType===1&&p&&p.nodeValue===q}}l.removeChild(g);l=g=null})();(function(){var g=s.createElement("div");g.appendChild(s.createComment(""));if(g.getElementsByTagName("*").length>0)n.find.TAG=function(h,l){l=l.getElementsByTagName(h[1]);if(h[1]==="*"){h=[];for(var m=0;l[m];m++)l[m].nodeType===1&&h.push(l[m]);l=h}return l};g.innerHTML=""; -if(g.firstChild&&typeof g.firstChild.getAttribute!=="undefined"&&g.firstChild.getAttribute("href")!=="#")n.attrHandle.href=function(h){return h.getAttribute("href",2)};g=null})();s.querySelectorAll&&function(){var g=k,h=s.createElement("div");h.innerHTML="

      ";if(!(h.querySelectorAll&&h.querySelectorAll(".TEST").length===0)){k=function(m,q,p,v){q=q||s;if(!v&&q.nodeType===9&&!x(q))try{return z(q.querySelectorAll(m),p)}catch(t){}return g(m,q,p,v)};for(var l in g)k[l]=g[l];h=null}}(); -(function(){var g=s.createElement("div");g.innerHTML="
      ";if(!(!g.getElementsByClassName||g.getElementsByClassName("e").length===0)){g.lastChild.className="e";if(g.getElementsByClassName("e").length!==1){n.order.splice(1,0,"CLASS");n.find.CLASS=function(h,l,m){if(typeof l.getElementsByClassName!=="undefined"&&!m)return l.getElementsByClassName(h[1])};g=null}}})();var E=s.compareDocumentPosition?function(g,h){return!!(g.compareDocumentPosition(h)&16)}: -function(g,h){return g!==h&&(g.contains?g.contains(h):true)},x=function(g){return(g=(g?g.ownerDocument||g:0).documentElement)?g.nodeName!=="HTML":false},ga=function(g,h){var l=[],m="",q;for(h=h.nodeType?[h]:h;q=n.match.PSEUDO.exec(g);){m+=q[0];g=g.replace(n.match.PSEUDO,"")}g=n.relative[g]?g+"*":g;q=0;for(var p=h.length;q=0===d})};c.fn.extend({find:function(a){for(var b=this.pushStack("","find",a),d=0,f=0,e=this.length;f0)for(var j=d;j0},closest:function(a,b){if(c.isArray(a)){var d=[],f=this[0],e,j= -{},i;if(f&&a.length){e=0;for(var o=a.length;e-1:c(f).is(e)){d.push({selector:i,elem:f});delete j[i]}}f=f.parentNode}}return d}var k=c.expr.match.POS.test(a)?c(a,b||this.context):null;return this.map(function(n,r){for(;r&&r.ownerDocument&&r!==b;){if(k?k.index(r)>-1:c(r).is(a))return r;r=r.parentNode}return null})},index:function(a){if(!a||typeof a=== -"string")return c.inArray(this[0],a?c(a):this.parent().children());return c.inArray(a.jquery?a[0]:a,this)},add:function(a,b){a=typeof a==="string"?c(a,b||this.context):c.makeArray(a);b=c.merge(this.get(),a);return this.pushStack(qa(a[0])||qa(b[0])?b:c.unique(b))},andSelf:function(){return this.add(this.prevObject)}});c.each({parent:function(a){return(a=a.parentNode)&&a.nodeType!==11?a:null},parents:function(a){return c.dir(a,"parentNode")},parentsUntil:function(a,b,d){return c.dir(a,"parentNode", -d)},next:function(a){return c.nth(a,2,"nextSibling")},prev:function(a){return c.nth(a,2,"previousSibling")},nextAll:function(a){return c.dir(a,"nextSibling")},prevAll:function(a){return c.dir(a,"previousSibling")},nextUntil:function(a,b,d){return c.dir(a,"nextSibling",d)},prevUntil:function(a,b,d){return c.dir(a,"previousSibling",d)},siblings:function(a){return c.sibling(a.parentNode.firstChild,a)},children:function(a){return c.sibling(a.firstChild)},contents:function(a){return c.nodeName(a,"iframe")? -a.contentDocument||a.contentWindow.document:c.makeArray(a.childNodes)}},function(a,b){c.fn[a]=function(d,f){var e=c.map(this,b,d);eb.test(a)||(f=d);if(f&&typeof f==="string")e=c.filter(f,e);e=this.length>1?c.unique(e):e;if((this.length>1||gb.test(f))&&fb.test(a))e=e.reverse();return this.pushStack(e,a,R.call(arguments).join(","))}});c.extend({filter:function(a,b,d){if(d)a=":not("+a+")";return c.find.matches(a,b)},dir:function(a,b,d){var f=[];for(a=a[b];a&&a.nodeType!==9&&(d===w||a.nodeType!==1||!c(a).is(d));){a.nodeType=== -1&&f.push(a);a=a[b]}return f},nth:function(a,b,d){b=b||1;for(var f=0;a;a=a[d])if(a.nodeType===1&&++f===b)break;return a},sibling:function(a,b){for(var d=[];a;a=a.nextSibling)a.nodeType===1&&a!==b&&d.push(a);return d}});var Ja=/ jQuery\d+="(?:\d+|null)"/g,V=/^\s+/,Ka=/(<([\w:]+)[^>]*?)\/>/g,hb=/^(?:area|br|col|embed|hr|img|input|link|meta|param)$/i,La=/<([\w:]+)/,ib=/"},F={option:[1,""],legend:[1,"
      ","
      "],thead:[1,"","
      "],tr:[2,"","
      "],td:[3,"","
      "],col:[2,"","
      "],area:[1,"",""],_default:[0,"",""]};F.optgroup=F.option;F.tbody=F.tfoot=F.colgroup=F.caption=F.thead;F.th=F.td;if(!c.support.htmlSerialize)F._default=[1,"div
      ","
      "];c.fn.extend({text:function(a){if(c.isFunction(a))return this.each(function(b){var d= -c(this);d.text(a.call(this,b,d.text()))});if(typeof a!=="object"&&a!==w)return this.empty().append((this[0]&&this[0].ownerDocument||s).createTextNode(a));return c.text(this)},wrapAll:function(a){if(c.isFunction(a))return this.each(function(d){c(this).wrapAll(a.call(this,d))});if(this[0]){var b=c(a,this[0].ownerDocument).eq(0).clone(true);this[0].parentNode&&b.insertBefore(this[0]);b.map(function(){for(var d=this;d.firstChild&&d.firstChild.nodeType===1;)d=d.firstChild;return d}).append(this)}return this}, -wrapInner:function(a){if(c.isFunction(a))return this.each(function(b){c(this).wrapInner(a.call(this,b))});return this.each(function(){var b=c(this),d=b.contents();d.length?d.wrapAll(a):b.append(a)})},wrap:function(a){return this.each(function(){c(this).wrapAll(a)})},unwrap:function(){return this.parent().each(function(){c.nodeName(this,"body")||c(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.appendChild(a)})}, -prepend:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b,this)});else if(arguments.length){var a=c(arguments[0]);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b, -this.nextSibling)});else if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,c(arguments[0]).toArray());return a}},remove:function(a,b){for(var d=0,f;(f=this[d])!=null;d++)if(!a||c.filter(a,[f]).length){if(!b&&f.nodeType===1){c.cleanData(f.getElementsByTagName("*"));c.cleanData([f])}f.parentNode&&f.parentNode.removeChild(f)}return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++)for(b.nodeType===1&&c.cleanData(b.getElementsByTagName("*"));b.firstChild;)b.removeChild(b.firstChild); -return this},clone:function(a){var b=this.map(function(){if(!c.support.noCloneEvent&&!c.isXMLDoc(this)){var d=this.outerHTML,f=this.ownerDocument;if(!d){d=f.createElement("div");d.appendChild(this.cloneNode(true));d=d.innerHTML}return c.clean([d.replace(Ja,"").replace(/=([^="'>\s]+\/)>/g,'="$1">').replace(V,"")],f)[0]}else return this.cloneNode(true)});if(a===true){ra(this,b);ra(this.find("*"),b.find("*"))}return b},html:function(a){if(a===w)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(Ja, -""):null;else if(typeof a==="string"&&!ta.test(a)&&(c.support.leadingWhitespace||!V.test(a))&&!F[(La.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Ka,Ma);try{for(var b=0,d=this.length;b0||e.cacheable||this.length>1?k.cloneNode(true):k)}o.length&&c.each(o,Qa)}return this}});c.fragments={};c.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){c.fn[a]=function(d){var f=[];d=c(d);var e=this.length===1&&this[0].parentNode;if(e&&e.nodeType===11&&e.childNodes.length===1&&d.length===1){d[b](this[0]); -return this}else{e=0;for(var j=d.length;e0?this.clone(true):this).get();c.fn[b].apply(c(d[e]),i);f=f.concat(i)}return this.pushStack(f,a,d.selector)}}});c.extend({clean:function(a,b,d,f){b=b||s;if(typeof b.createElement==="undefined")b=b.ownerDocument||b[0]&&b[0].ownerDocument||s;for(var e=[],j=0,i;(i=a[j])!=null;j++){if(typeof i==="number")i+="";if(i){if(typeof i==="string"&&!jb.test(i))i=b.createTextNode(i);else if(typeof i==="string"){i=i.replace(Ka,Ma);var o=(La.exec(i)||["", -""])[1].toLowerCase(),k=F[o]||F._default,n=k[0],r=b.createElement("div");for(r.innerHTML=k[1]+i+k[2];n--;)r=r.lastChild;if(!c.support.tbody){n=ib.test(i);o=o==="table"&&!n?r.firstChild&&r.firstChild.childNodes:k[1]===""&&!n?r.childNodes:[];for(k=o.length-1;k>=0;--k)c.nodeName(o[k],"tbody")&&!o[k].childNodes.length&&o[k].parentNode.removeChild(o[k])}!c.support.leadingWhitespace&&V.test(i)&&r.insertBefore(b.createTextNode(V.exec(i)[0]),r.firstChild);i=r.childNodes}if(i.nodeType)e.push(i);else e= -c.merge(e,i)}}if(d)for(j=0;e[j];j++)if(f&&c.nodeName(e[j],"script")&&(!e[j].type||e[j].type.toLowerCase()==="text/javascript"))f.push(e[j].parentNode?e[j].parentNode.removeChild(e[j]):e[j]);else{e[j].nodeType===1&&e.splice.apply(e,[j+1,0].concat(c.makeArray(e[j].getElementsByTagName("script"))));d.appendChild(e[j])}return e},cleanData:function(a){for(var b,d,f=c.cache,e=c.event.special,j=c.support.deleteExpando,i=0,o;(o=a[i])!=null;i++)if(d=o[c.expando]){b=f[d];if(b.events)for(var k in b.events)e[k]? -c.event.remove(o,k):Ca(o,k,b.handle);if(j)delete o[c.expando];else o.removeAttribute&&o.removeAttribute(c.expando);delete f[d]}}});var kb=/z-?index|font-?weight|opacity|zoom|line-?height/i,Na=/alpha\([^)]*\)/,Oa=/opacity=([^)]*)/,ha=/float/i,ia=/-([a-z])/ig,lb=/([A-Z])/g,mb=/^-?\d+(?:px)?$/i,nb=/^-?\d/,ob={position:"absolute",visibility:"hidden",display:"block"},pb=["Left","Right"],qb=["Top","Bottom"],rb=s.defaultView&&s.defaultView.getComputedStyle,Pa=c.support.cssFloat?"cssFloat":"styleFloat",ja= -function(a,b){return b.toUpperCase()};c.fn.css=function(a,b){return X(this,a,b,true,function(d,f,e){if(e===w)return c.curCSS(d,f);if(typeof e==="number"&&!kb.test(f))e+="px";c.style(d,f,e)})};c.extend({style:function(a,b,d){if(!a||a.nodeType===3||a.nodeType===8)return w;if((b==="width"||b==="height")&&parseFloat(d)<0)d=w;var f=a.style||a,e=d!==w;if(!c.support.opacity&&b==="opacity"){if(e){f.zoom=1;b=parseInt(d,10)+""==="NaN"?"":"alpha(opacity="+d*100+")";a=f.filter||c.curCSS(a,"filter")||"";f.filter= -Na.test(a)?a.replace(Na,b):b}return f.filter&&f.filter.indexOf("opacity=")>=0?parseFloat(Oa.exec(f.filter)[1])/100+"":""}if(ha.test(b))b=Pa;b=b.replace(ia,ja);if(e)f[b]=d;return f[b]},css:function(a,b,d,f){if(b==="width"||b==="height"){var e,j=b==="width"?pb:qb;function i(){e=b==="width"?a.offsetWidth:a.offsetHeight;f!=="border"&&c.each(j,function(){f||(e-=parseFloat(c.curCSS(a,"padding"+this,true))||0);if(f==="margin")e+=parseFloat(c.curCSS(a,"margin"+this,true))||0;else e-=parseFloat(c.curCSS(a, -"border"+this+"Width",true))||0})}a.offsetWidth!==0?i():c.swap(a,ob,i);return Math.max(0,Math.round(e))}return c.curCSS(a,b,d)},curCSS:function(a,b,d){var f,e=a.style;if(!c.support.opacity&&b==="opacity"&&a.currentStyle){f=Oa.test(a.currentStyle.filter||"")?parseFloat(RegExp.$1)/100+"":"";return f===""?"1":f}if(ha.test(b))b=Pa;if(!d&&e&&e[b])f=e[b];else if(rb){if(ha.test(b))b="float";b=b.replace(lb,"-$1").toLowerCase();e=a.ownerDocument.defaultView;if(!e)return null;if(a=e.getComputedStyle(a,null))f= -a.getPropertyValue(b);if(b==="opacity"&&f==="")f="1"}else if(a.currentStyle){d=b.replace(ia,ja);f=a.currentStyle[b]||a.currentStyle[d];if(!mb.test(f)&&nb.test(f)){b=e.left;var j=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;e.left=d==="fontSize"?"1em":f||0;f=e.pixelLeft+"px";e.left=b;a.runtimeStyle.left=j}}return f},swap:function(a,b,d){var f={};for(var e in b){f[e]=a.style[e];a.style[e]=b[e]}d.call(a);for(e in b)a.style[e]=f[e]}});if(c.expr&&c.expr.filters){c.expr.filters.hidden=function(a){var b= -a.offsetWidth,d=a.offsetHeight,f=a.nodeName.toLowerCase()==="tr";return b===0&&d===0&&!f?true:b>0&&d>0&&!f?false:c.curCSS(a,"display")==="none"};c.expr.filters.visible=function(a){return!c.expr.filters.hidden(a)}}var sb=J(),tb=//gi,ub=/select|textarea/i,vb=/color|date|datetime|email|hidden|month|number|password|range|search|tel|text|time|url|week/i,N=/=\?(&|$)/,ka=/\?/,wb=/(\?|&)_=.*?(&|$)/,xb=/^(\w+:)?\/\/([^\/?#]+)/,yb=/%20/g,zb=c.fn.load;c.fn.extend({load:function(a,b,d){if(typeof a!== -"string")return zb.call(this,a);else if(!this.length)return this;var f=a.indexOf(" ");if(f>=0){var e=a.slice(f,a.length);a=a.slice(0,f)}f="GET";if(b)if(c.isFunction(b)){d=b;b=null}else if(typeof b==="object"){b=c.param(b,c.ajaxSettings.traditional);f="POST"}var j=this;c.ajax({url:a,type:f,dataType:"html",data:b,complete:function(i,o){if(o==="success"||o==="notmodified")j.html(e?c("
      ").append(i.responseText.replace(tb,"")).find(e):i.responseText);d&&j.each(d,[i.responseText,o,i])}});return this}, -serialize:function(){return c.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?c.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||ub.test(this.nodeName)||vb.test(this.type))}).map(function(a,b){a=c(this).val();return a==null?null:c.isArray(a)?c.map(a,function(d){return{name:b.name,value:d}}):{name:b.name,value:a}}).get()}});c.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "), -function(a,b){c.fn[b]=function(d){return this.bind(b,d)}});c.extend({get:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b=null}return c.ajax({type:"GET",url:a,data:b,success:d,dataType:f})},getScript:function(a,b){return c.get(a,null,b,"script")},getJSON:function(a,b,d){return c.get(a,b,d,"json")},post:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b={}}return c.ajax({type:"POST",url:a,data:b,success:d,dataType:f})},ajaxSetup:function(a){c.extend(c.ajaxSettings,a)},ajaxSettings:{url:location.href, -global:true,type:"GET",contentType:"application/x-www-form-urlencoded",processData:true,async:true,xhr:A.XMLHttpRequest&&(A.location.protocol!=="file:"||!A.ActiveXObject)?function(){return new A.XMLHttpRequest}:function(){try{return new A.ActiveXObject("Microsoft.XMLHTTP")}catch(a){}},accepts:{xml:"application/xml, text/xml",html:"text/html",script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},lastModified:{},etag:{},ajax:function(a){function b(){e.success&& -e.success.call(k,o,i,x);e.global&&f("ajaxSuccess",[x,e])}function d(){e.complete&&e.complete.call(k,x,i);e.global&&f("ajaxComplete",[x,e]);e.global&&!--c.active&&c.event.trigger("ajaxStop")}function f(q,p){(e.context?c(e.context):c.event).trigger(q,p)}var e=c.extend(true,{},c.ajaxSettings,a),j,i,o,k=a&&a.context||e,n=e.type.toUpperCase();if(e.data&&e.processData&&typeof e.data!=="string")e.data=c.param(e.data,e.traditional);if(e.dataType==="jsonp"){if(n==="GET")N.test(e.url)||(e.url+=(ka.test(e.url)? -"&":"?")+(e.jsonp||"callback")+"=?");else if(!e.data||!N.test(e.data))e.data=(e.data?e.data+"&":"")+(e.jsonp||"callback")+"=?";e.dataType="json"}if(e.dataType==="json"&&(e.data&&N.test(e.data)||N.test(e.url))){j=e.jsonpCallback||"jsonp"+sb++;if(e.data)e.data=(e.data+"").replace(N,"="+j+"$1");e.url=e.url.replace(N,"="+j+"$1");e.dataType="script";A[j]=A[j]||function(q){o=q;b();d();A[j]=w;try{delete A[j]}catch(p){}z&&z.removeChild(C)}}if(e.dataType==="script"&&e.cache===null)e.cache=false;if(e.cache=== -false&&n==="GET"){var r=J(),u=e.url.replace(wb,"$1_="+r+"$2");e.url=u+(u===e.url?(ka.test(e.url)?"&":"?")+"_="+r:"")}if(e.data&&n==="GET")e.url+=(ka.test(e.url)?"&":"?")+e.data;e.global&&!c.active++&&c.event.trigger("ajaxStart");r=(r=xb.exec(e.url))&&(r[1]&&r[1]!==location.protocol||r[2]!==location.host);if(e.dataType==="script"&&n==="GET"&&r){var z=s.getElementsByTagName("head")[0]||s.documentElement,C=s.createElement("script");C.src=e.url;if(e.scriptCharset)C.charset=e.scriptCharset;if(!j){var B= -false;C.onload=C.onreadystatechange=function(){if(!B&&(!this.readyState||this.readyState==="loaded"||this.readyState==="complete")){B=true;b();d();C.onload=C.onreadystatechange=null;z&&C.parentNode&&z.removeChild(C)}}}z.insertBefore(C,z.firstChild);return w}var E=false,x=e.xhr();if(x){e.username?x.open(n,e.url,e.async,e.username,e.password):x.open(n,e.url,e.async);try{if(e.data||a&&a.contentType)x.setRequestHeader("Content-Type",e.contentType);if(e.ifModified){c.lastModified[e.url]&&x.setRequestHeader("If-Modified-Since", -c.lastModified[e.url]);c.etag[e.url]&&x.setRequestHeader("If-None-Match",c.etag[e.url])}r||x.setRequestHeader("X-Requested-With","XMLHttpRequest");x.setRequestHeader("Accept",e.dataType&&e.accepts[e.dataType]?e.accepts[e.dataType]+", */*":e.accepts._default)}catch(ga){}if(e.beforeSend&&e.beforeSend.call(k,x,e)===false){e.global&&!--c.active&&c.event.trigger("ajaxStop");x.abort();return false}e.global&&f("ajaxSend",[x,e]);var g=x.onreadystatechange=function(q){if(!x||x.readyState===0||q==="abort"){E|| -d();E=true;if(x)x.onreadystatechange=c.noop}else if(!E&&x&&(x.readyState===4||q==="timeout")){E=true;x.onreadystatechange=c.noop;i=q==="timeout"?"timeout":!c.httpSuccess(x)?"error":e.ifModified&&c.httpNotModified(x,e.url)?"notmodified":"success";var p;if(i==="success")try{o=c.httpData(x,e.dataType,e)}catch(v){i="parsererror";p=v}if(i==="success"||i==="notmodified")j||b();else c.handleError(e,x,i,p);d();q==="timeout"&&x.abort();if(e.async)x=null}};try{var h=x.abort;x.abort=function(){x&&h.call(x); -g("abort")}}catch(l){}e.async&&e.timeout>0&&setTimeout(function(){x&&!E&&g("timeout")},e.timeout);try{x.send(n==="POST"||n==="PUT"||n==="DELETE"?e.data:null)}catch(m){c.handleError(e,x,null,m);d()}e.async||g();return x}},handleError:function(a,b,d,f){if(a.error)a.error.call(a.context||a,b,d,f);if(a.global)(a.context?c(a.context):c.event).trigger("ajaxError",[b,a,f])},active:0,httpSuccess:function(a){try{return!a.status&&location.protocol==="file:"||a.status>=200&&a.status<300||a.status===304||a.status=== -1223||a.status===0}catch(b){}return false},httpNotModified:function(a,b){var d=a.getResponseHeader("Last-Modified"),f=a.getResponseHeader("Etag");if(d)c.lastModified[b]=d;if(f)c.etag[b]=f;return a.status===304||a.status===0},httpData:function(a,b,d){var f=a.getResponseHeader("content-type")||"",e=b==="xml"||!b&&f.indexOf("xml")>=0;a=e?a.responseXML:a.responseText;e&&a.documentElement.nodeName==="parsererror"&&c.error("parsererror");if(d&&d.dataFilter)a=d.dataFilter(a,b);if(typeof a==="string")if(b=== -"json"||!b&&f.indexOf("json")>=0)a=c.parseJSON(a);else if(b==="script"||!b&&f.indexOf("javascript")>=0)c.globalEval(a);return a},param:function(a,b){function d(i,o){if(c.isArray(o))c.each(o,function(k,n){b||/\[\]$/.test(i)?f(i,n):d(i+"["+(typeof n==="object"||c.isArray(n)?k:"")+"]",n)});else!b&&o!=null&&typeof o==="object"?c.each(o,function(k,n){d(i+"["+k+"]",n)}):f(i,o)}function f(i,o){o=c.isFunction(o)?o():o;e[e.length]=encodeURIComponent(i)+"="+encodeURIComponent(o)}var e=[];if(b===w)b=c.ajaxSettings.traditional; -if(c.isArray(a)||a.jquery)c.each(a,function(){f(this.name,this.value)});else for(var j in a)d(j,a[j]);return e.join("&").replace(yb,"+")}});var la={},Ab=/toggle|show|hide/,Bb=/^([+-]=)?([\d+-.]+)(.*)$/,W,va=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]];c.fn.extend({show:function(a,b){if(a||a===0)return this.animate(K("show",3),a,b);else{a=0;for(b=this.length;a").appendTo("body");f=e.css("display");if(f==="none")f="block";e.remove();la[d]=f}c.data(this[a],"olddisplay",f)}}a=0;for(b=this.length;a=0;f--)if(d[f].elem===this){b&&d[f](true);d.splice(f,1)}});b||this.dequeue();return this}});c.each({slideDown:K("show",1),slideUp:K("hide",1),slideToggle:K("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"}},function(a,b){c.fn[a]=function(d,f){return this.animate(b,d,f)}});c.extend({speed:function(a,b,d){var f=a&&typeof a==="object"?a:{complete:d||!d&&b||c.isFunction(a)&&a,duration:a,easing:d&&b||b&&!c.isFunction(b)&&b};f.duration=c.fx.off?0:typeof f.duration=== -"number"?f.duration:c.fx.speeds[f.duration]||c.fx.speeds._default;f.old=f.complete;f.complete=function(){f.queue!==false&&c(this).dequeue();c.isFunction(f.old)&&f.old.call(this)};return f},easing:{linear:function(a,b,d,f){return d+f*a},swing:function(a,b,d,f){return(-Math.cos(a*Math.PI)/2+0.5)*f+d}},timers:[],fx:function(a,b,d){this.options=b;this.elem=a;this.prop=d;if(!b.orig)b.orig={}}});c.fx.prototype={update:function(){this.options.step&&this.options.step.call(this.elem,this.now,this);(c.fx.step[this.prop]|| -c.fx.step._default)(this);if((this.prop==="height"||this.prop==="width")&&this.elem.style)this.elem.style.display="block"},cur:function(a){if(this.elem[this.prop]!=null&&(!this.elem.style||this.elem.style[this.prop]==null))return this.elem[this.prop];return(a=parseFloat(c.css(this.elem,this.prop,a)))&&a>-10000?a:parseFloat(c.curCSS(this.elem,this.prop))||0},custom:function(a,b,d){function f(j){return e.step(j)}this.startTime=J();this.start=a;this.end=b;this.unit=d||this.unit||"px";this.now=this.start; -this.pos=this.state=0;var e=this;f.elem=this.elem;if(f()&&c.timers.push(f)&&!W)W=setInterval(c.fx.tick,13)},show:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.show=true;this.custom(this.prop==="width"||this.prop==="height"?1:0,this.cur());c(this.elem).show()},hide:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.hide=true;this.custom(this.cur(),0)},step:function(a){var b=J(),d=true;if(a||b>=this.options.duration+this.startTime){this.now= -this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;for(var f in this.options.curAnim)if(this.options.curAnim[f]!==true)d=false;if(d){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;a=c.data(this.elem,"olddisplay");this.elem.style.display=a?a:this.options.display;if(c.css(this.elem,"display")==="none")this.elem.style.display="block"}this.options.hide&&c(this.elem).hide();if(this.options.hide||this.options.show)for(var e in this.options.curAnim)c.style(this.elem, -e,this.options.orig[e]);this.options.complete.call(this.elem)}return false}else{e=b-this.startTime;this.state=e/this.options.duration;a=this.options.easing||(c.easing.swing?"swing":"linear");this.pos=c.easing[this.options.specialEasing&&this.options.specialEasing[this.prop]||a](this.state,e,0,1,this.options.duration);this.now=this.start+(this.end-this.start)*this.pos;this.update()}return true}};c.extend(c.fx,{tick:function(){for(var a=c.timers,b=0;b
      "; -a.insertBefore(b,a.firstChild);d=b.firstChild;f=d.firstChild;e=d.nextSibling.firstChild.firstChild;this.doesNotAddBorder=f.offsetTop!==5;this.doesAddBorderForTableAndCells=e.offsetTop===5;f.style.position="fixed";f.style.top="20px";this.supportsFixedPosition=f.offsetTop===20||f.offsetTop===15;f.style.position=f.style.top="";d.style.overflow="hidden";d.style.position="relative";this.subtractsBorderForOverflowNotVisible=f.offsetTop===-5;this.doesNotIncludeMarginInBodyOffset=a.offsetTop!==j;a.removeChild(b); -c.offset.initialize=c.noop},bodyOffset:function(a){var b=a.offsetTop,d=a.offsetLeft;c.offset.initialize();if(c.offset.doesNotIncludeMarginInBodyOffset){b+=parseFloat(c.curCSS(a,"marginTop",true))||0;d+=parseFloat(c.curCSS(a,"marginLeft",true))||0}return{top:b,left:d}},setOffset:function(a,b,d){if(/static/.test(c.curCSS(a,"position")))a.style.position="relative";var f=c(a),e=f.offset(),j=parseInt(c.curCSS(a,"top",true),10)||0,i=parseInt(c.curCSS(a,"left",true),10)||0;if(c.isFunction(b))b=b.call(a, -d,e);d={top:b.top-e.top+j,left:b.left-e.left+i};"using"in b?b.using.call(a,d):f.css(d)}};c.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),d=this.offset(),f=/^body|html$/i.test(b[0].nodeName)?{top:0,left:0}:b.offset();d.top-=parseFloat(c.curCSS(a,"marginTop",true))||0;d.left-=parseFloat(c.curCSS(a,"marginLeft",true))||0;f.top+=parseFloat(c.curCSS(b[0],"borderTopWidth",true))||0;f.left+=parseFloat(c.curCSS(b[0],"borderLeftWidth",true))||0;return{top:d.top- -f.top,left:d.left-f.left}},offsetParent:function(){return this.map(function(){for(var a=this.offsetParent||s.body;a&&!/^body|html$/i.test(a.nodeName)&&c.css(a,"position")==="static";)a=a.offsetParent;return a})}});c.each(["Left","Top"],function(a,b){var d="scroll"+b;c.fn[d]=function(f){var e=this[0],j;if(!e)return null;if(f!==w)return this.each(function(){if(j=wa(this))j.scrollTo(!a?f:c(j).scrollLeft(),a?f:c(j).scrollTop());else this[d]=f});else return(j=wa(e))?"pageXOffset"in j?j[a?"pageYOffset": -"pageXOffset"]:c.support.boxModel&&j.document.documentElement[d]||j.document.body[d]:e[d]}});c.each(["Height","Width"],function(a,b){var d=b.toLowerCase();c.fn["inner"+b]=function(){return this[0]?c.css(this[0],d,false,"padding"):null};c.fn["outer"+b]=function(f){return this[0]?c.css(this[0],d,false,f?"margin":"border"):null};c.fn[d]=function(f){var e=this[0];if(!e)return f==null?null:this;if(c.isFunction(f))return this.each(function(j){var i=c(this);i[d](f.call(this,j,i[d]()))});return"scrollTo"in -e&&e.document?e.document.compatMode==="CSS1Compat"&&e.document.documentElement["client"+b]||e.document.body["client"+b]:e.nodeType===9?Math.max(e.documentElement["client"+b],e.body["scroll"+b],e.documentElement["scroll"+b],e.body["offset"+b],e.documentElement["offset"+b]):f===w?c.css(e,d):this.css(d,typeof f==="string"?f:f+"px")}});A.jQuery=A.$=c})(window); diff --git a/_static/minus.png b/_static/minus.png deleted file mode 100644 index da1c562..0000000 Binary files a/_static/minus.png and /dev/null differ diff --git a/_static/normaltnp.png b/_static/normaltnp.png deleted file mode 100644 index 0e73f90..0000000 Binary files a/_static/normaltnp.png and /dev/null differ diff --git a/_static/plus.png b/_static/plus.png deleted file mode 100644 index b3cb374..0000000 Binary files a/_static/plus.png and /dev/null differ diff --git a/_static/pygments.css b/_static/pygments.css deleted file mode 100644 index 1247614..0000000 --- a/_static/pygments.css +++ /dev/null @@ -1,70 +0,0 @@ -.highlight .hll { background-color: #ffffcc } -.highlight { background: #000000; } -.highlight .c { color: #B729D9; font-style: italic } /* Comment */ -.highlight .err { color: #a40000; border: 1px solid #ef2929 } /* Error */ -.highlight .g { color: #ffffff } /* Generic */ -.highlight .k { color: #FF8400 } /* Keyword */ -.highlight .l { color: #ffffff } /* Literal */ -.highlight .n { color: #ffffff } /* Name */ -.highlight .o { color: #E0882F } /* Operator */ -.highlight .x { color: #ffffff } /* Other */ -.highlight .p { color: #999999 } /* Punctuation */ -.highlight .cm { color: #B729D9; font-style: italic } /* Comment.Multiline */ -.highlight .cp { color: #a0a0a0 } /* Comment.Preproc */ -.highlight .c1 { color: #B729D9; font-style: italic } /* Comment.Single */ -.highlight .cs { color: #B729D9; font-style: italic } /* Comment.Special */ -.highlight .gd { color: #a40000 } /* Generic.Deleted */ -.highlight .ge { color: #ffffff; font-style: italic } /* Generic.Emph */ -.highlight .gr { color: #ef2929 } /* Generic.Error */ -.highlight .gh { color: #000080 } /* Generic.Heading */ -.highlight .gi { color: #00A000 } /* Generic.Inserted */ -.highlight .go { color: #808080 } /* Generic.Output */ -.highlight .gp { color: #745334 } /* Generic.Prompt */ -.highlight .gs { color: #ffffff; font-weight: bold } /* Generic.Strong */ -.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ -.highlight .gt { color: #a40000; font-weight: bold } /* Generic.Traceback */ -.highlight .kc { color: #004461 } /* Keyword.Constant */ -.highlight .kd { color: #004461 } /* Keyword.Declaration */ -.highlight .kn { color: #004461 } /* Keyword.Namespace */ -.highlight .kp { color: #004461 } /* Keyword.Pseudo */ -.highlight .kr { color: #004461 } /* Keyword.Reserved */ -.highlight .kt { color: #004461 } /* Keyword.Type */ -.highlight .ld { color: #ffffff } /* Literal.Date */ -.highlight .m { color: #1299DA } /* Literal.Number */ -.highlight .s { color: #56DB3A } /* Literal.String */ -.highlight .na { color: #ffffff } /* Name.Attribute */ -.highlight .nb { color: #ffffff } /* Name.Builtin */ -.highlight .nc { color: #ffffff } /* Name.Class */ -.highlight .no { color: #ffffff } /* Name.Constant */ -.highlight .nd { color: #808080 } /* Name.Decorator */ -.highlight .ni { color: #ce5c00 } /* Name.Entity */ -.highlight .ne { color: #cc0000 } /* Name.Exception */ -.highlight .nf { color: #ffffff } /* Name.Function */ -.highlight .nl { color: #f57900 } /* Name.Label */ -.highlight .nn { color: #ffffff } /* Name.Namespace */ -.highlight .nx { color: #ffffff } /* Name.Other */ -.highlight .py { color: #ffffff } /* Name.Property */ -.highlight .nt { color: #cccccc } /* Name.Tag */ -.highlight .nv { color: #ffffff } /* Name.Variable */ -.highlight .ow { color: #E0882F } /* Operator.Word */ -.highlight .w { color: #f8f8f8; text-decoration: underline } /* Text.Whitespace */ -.highlight .mf { color: #1299DA } /* Literal.Number.Float */ -.highlight .mh { color: #1299DA } /* Literal.Number.Hex */ -.highlight .mi { color: #1299DA } /* Literal.Number.Integer */ -.highlight .mo { color: #1299DA } /* Literal.Number.Oct */ -.highlight .sb { color: #56DB3A } /* Literal.String.Backtick */ -.highlight .sc { color: #56DB3A } /* Literal.String.Char */ -.highlight .sd { color: #B729D9; font-style: italic } /* Literal.String.Doc */ -.highlight .s2 { color: #56DB3A } /* Literal.String.Double */ -.highlight .se { color: #56DB3A } /* Literal.String.Escape */ -.highlight .sh { color: #56DB3A } /* Literal.String.Heredoc */ -.highlight .si { color: #56DB3A } /* Literal.String.Interpol */ -.highlight .sx { color: #56DB3A } /* Literal.String.Other */ -.highlight .sr { color: #56DB3A } /* Literal.String.Regex */ -.highlight .s1 { color: #56DB3A } /* Literal.String.Single */ -.highlight .ss { color: #56DB3A } /* Literal.String.Symbol */ -.highlight .bp { color: #3465a4 } /* Name.Builtin.Pseudo */ -.highlight .vc { color: #ffffff } /* Name.Variable.Class */ -.highlight .vg { color: #ffffff } /* Name.Variable.Global */ -.highlight .vi { color: #ffffff } /* Name.Variable.Instance */ -.highlight .il { color: #1299DA } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/_static/searchtools.js b/_static/searchtools.js deleted file mode 100644 index 663be4c..0000000 --- a/_static/searchtools.js +++ /dev/null @@ -1,560 +0,0 @@ -/* - * searchtools.js_t - * ~~~~~~~~~~~~~~~~ - * - * Sphinx JavaScript utilties for the full-text search. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * helper function to return a node containing the - * search summary for a given text. keywords is a list - * of stemmed words, hlwords is the list of normal, unstemmed - * words. the first one is used to find the occurance, the - * latter for highlighting it. - */ - -jQuery.makeSearchSummary = function(text, keywords, hlwords) { - var textLower = text.toLowerCase(); - var start = 0; - $.each(keywords, function() { - var i = textLower.indexOf(this.toLowerCase()); - if (i > -1) - start = i; - }); - start = Math.max(start - 120, 0); - var excerpt = ((start > 0) ? '...' : '') + - $.trim(text.substr(start, 240)) + - ((start + 240 - text.length) ? '...' : ''); - var rv = $('
      ').text(excerpt); - $.each(hlwords, function() { - rv = rv.highlightText(this, 'highlighted'); - }); - return rv; -} - - -/** - * Porter Stemmer - */ -var Stemmer = function() { - - var step2list = { - ational: 'ate', - tional: 'tion', - enci: 'ence', - anci: 'ance', - izer: 'ize', - bli: 'ble', - alli: 'al', - entli: 'ent', - eli: 'e', - ousli: 'ous', - ization: 'ize', - ation: 'ate', - ator: 'ate', - alism: 'al', - iveness: 'ive', - fulness: 'ful', - ousness: 'ous', - aliti: 'al', - iviti: 'ive', - biliti: 'ble', - logi: 'log' - }; - - var step3list = { - icate: 'ic', - ative: '', - alize: 'al', - iciti: 'ic', - ical: 'ic', - ful: '', - ness: '' - }; - - var c = "[^aeiou]"; // consonant - var v = "[aeiouy]"; // vowel - var C = c + "[^aeiouy]*"; // consonant sequence - var V = v + "[aeiou]*"; // vowel sequence - - var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 - var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 - var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 - var s_v = "^(" + C + ")?" + v; // vowel in stem - - this.stemWord = function (w) { - var stem; - var suffix; - var firstch; - var origword = w; - - if (w.length < 3) - return w; - - var re; - var re2; - var re3; - var re4; - - firstch = w.substr(0,1); - if (firstch == "y") - w = firstch.toUpperCase() + w.substr(1); - - // Step 1a - re = /^(.+?)(ss|i)es$/; - re2 = /^(.+?)([^s])s$/; - - if (re.test(w)) - w = w.replace(re,"$1$2"); - else if (re2.test(w)) - w = w.replace(re2,"$1$2"); - - // Step 1b - re = /^(.+?)eed$/; - re2 = /^(.+?)(ed|ing)$/; - if (re.test(w)) { - var fp = re.exec(w); - re = new RegExp(mgr0); - if (re.test(fp[1])) { - re = /.$/; - w = w.replace(re,""); - } - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1]; - re2 = new RegExp(s_v); - if (re2.test(stem)) { - w = stem; - re2 = /(at|bl|iz)$/; - re3 = new RegExp("([^aeiouylsz])\\1$"); - re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re2.test(w)) - w = w + "e"; - else if (re3.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - else if (re4.test(w)) - w = w + "e"; - } - } - - // Step 1c - re = /^(.+?)y$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(s_v); - if (re.test(stem)) - w = stem + "i"; - } - - // Step 2 - re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step2list[suffix]; - } - - // Step 3 - re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step3list[suffix]; - } - - // Step 4 - re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; - re2 = /^(.+?)(s|t)(ion)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - if (re.test(stem)) - w = stem; - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1] + fp[2]; - re2 = new RegExp(mgr1); - if (re2.test(stem)) - w = stem; - } - - // Step 5 - re = /^(.+?)e$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - re2 = new RegExp(meq1); - re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) - w = stem; - } - re = /ll$/; - re2 = new RegExp(mgr1); - if (re.test(w) && re2.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - - // and turn initial Y back to y - if (firstch == "y") - w = firstch.toLowerCase() + w.substr(1); - return w; - } -} - - -/** - * Search Module - */ -var Search = { - - _index : null, - _queued_query : null, - _pulse_status : -1, - - init : function() { - var params = $.getQueryParameters(); - if (params.q) { - var query = params.q[0]; - $('input[name="q"]')[0].value = query; - this.performSearch(query); - } - }, - - loadIndex : function(url) { - $.ajax({type: "GET", url: url, data: null, success: null, - dataType: "script", cache: true}); - }, - - setIndex : function(index) { - var q; - this._index = index; - if ((q = this._queued_query) !== null) { - this._queued_query = null; - Search.query(q); - } - }, - - hasIndex : function() { - return this._index !== null; - }, - - deferQuery : function(query) { - this._queued_query = query; - }, - - stopPulse : function() { - this._pulse_status = 0; - }, - - startPulse : function() { - if (this._pulse_status >= 0) - return; - function pulse() { - Search._pulse_status = (Search._pulse_status + 1) % 4; - var dotString = ''; - for (var i = 0; i < Search._pulse_status; i++) - dotString += '.'; - Search.dots.text(dotString); - if (Search._pulse_status > -1) - window.setTimeout(pulse, 500); - }; - pulse(); - }, - - /** - * perform a search for something - */ - performSearch : function(query) { - // create the required interface elements - this.out = $('#search-results'); - this.title = $('

      ' + _('Searching') + '

      ').appendTo(this.out); - this.dots = $('').appendTo(this.title); - this.status = $('

      ').appendTo(this.out); - this.output = $('
        ').appendTo(this.out); - - $('#search-progress').text(_('Preparing search...')); - this.startPulse(); - - // index already loaded, the browser was quick! - if (this.hasIndex()) - this.query(query); - else - this.deferQuery(query); - }, - - query : function(query) { - var stopwords = ["and","then","into","it","as","are","in","if","for","no","there","their","was","is","be","to","that","but","they","not","such","with","by","a","on","these","of","will","this","near","the","or","at"]; - - // Stem the searchterms and add them to the correct list - var stemmer = new Stemmer(); - var searchterms = []; - var excluded = []; - var hlterms = []; - var tmp = query.split(/\s+/); - var objectterms = []; - for (var i = 0; i < tmp.length; i++) { - if (tmp[i] != "") { - objectterms.push(tmp[i].toLowerCase()); - } - - if ($u.indexOf(stopwords, tmp[i]) != -1 || tmp[i].match(/^\d+$/) || - tmp[i] == "") { - // skip this "word" - continue; - } - // stem the word - var word = stemmer.stemWord(tmp[i]).toLowerCase(); - // select the correct list - if (word[0] == '-') { - var toAppend = excluded; - word = word.substr(1); - } - else { - var toAppend = searchterms; - hlterms.push(tmp[i].toLowerCase()); - } - // only add if not already in the list - if (!$.contains(toAppend, word)) - toAppend.push(word); - }; - var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); - - // console.debug('SEARCH: searching for:'); - // console.info('required: ', searchterms); - // console.info('excluded: ', excluded); - - // prepare search - var filenames = this._index.filenames; - var titles = this._index.titles; - var terms = this._index.terms; - var fileMap = {}; - var files = null; - // different result priorities - var importantResults = []; - var objectResults = []; - var regularResults = []; - var unimportantResults = []; - $('#search-progress').empty(); - - // lookup as object - for (var i = 0; i < objectterms.length; i++) { - var others = [].concat(objectterms.slice(0,i), - objectterms.slice(i+1, objectterms.length)) - var results = this.performObjectSearch(objectterms[i], others); - // Assume first word is most likely to be the object, - // other words more likely to be in description. - // Therefore put matches for earlier words first. - // (Results are eventually used in reverse order). - objectResults = results[0].concat(objectResults); - importantResults = results[1].concat(importantResults); - unimportantResults = results[2].concat(unimportantResults); - } - - // perform the search on the required terms - for (var i = 0; i < searchterms.length; i++) { - var word = searchterms[i]; - // no match but word was a required one - if ((files = terms[word]) == null) - break; - if (files.length == undefined) { - files = [files]; - } - // create the mapping - for (var j = 0; j < files.length; j++) { - var file = files[j]; - if (file in fileMap) - fileMap[file].push(word); - else - fileMap[file] = [word]; - } - } - - // now check if the files don't contain excluded terms - for (var file in fileMap) { - var valid = true; - - // check if all requirements are matched - if (fileMap[file].length != searchterms.length) - continue; - - // ensure that none of the excluded terms is in the - // search result. - for (var i = 0; i < excluded.length; i++) { - if (terms[excluded[i]] == file || - $.contains(terms[excluded[i]] || [], file)) { - valid = false; - break; - } - } - - // if we have still a valid result we can add it - // to the result list - if (valid) - regularResults.push([filenames[file], titles[file], '', null]); - } - - // delete unused variables in order to not waste - // memory until list is retrieved completely - delete filenames, titles, terms; - - // now sort the regular results descending by title - regularResults.sort(function(a, b) { - var left = a[1].toLowerCase(); - var right = b[1].toLowerCase(); - return (left > right) ? -1 : ((left < right) ? 1 : 0); - }); - - // combine all results - var results = unimportantResults.concat(regularResults) - .concat(objectResults).concat(importantResults); - - // print the results - var resultCount = results.length; - function displayNextItem() { - // results left, load the summary and display it - if (results.length) { - var item = results.pop(); - var listItem = $('
      • '); - if (DOCUMENTATION_OPTIONS.FILE_SUFFIX == '') { - // dirhtml builder - var dirname = item[0] + '/'; - if (dirname.match(/\/index\/$/)) { - dirname = dirname.substring(0, dirname.length-6); - } else if (dirname == 'index/') { - dirname = ''; - } - listItem.append($('').attr('href', - DOCUMENTATION_OPTIONS.URL_ROOT + dirname + - highlightstring + item[2]).html(item[1])); - } else { - // normal html builders - listItem.append($('').attr('href', - item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX + - highlightstring + item[2]).html(item[1])); - } - if (item[3]) { - listItem.append($(' (' + item[3] + ')')); - Search.output.append(listItem); - listItem.slideDown(5, function() { - displayNextItem(); - }); - } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { - $.get(DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + - item[0] + '.txt', function(data) { - if (data != '') { - listItem.append($.makeSearchSummary(data, searchterms, hlterms)); - Search.output.append(listItem); - } - listItem.slideDown(5, function() { - displayNextItem(); - }); - }, "text"); - } else { - // no source available, just display title - Search.output.append(listItem); - listItem.slideDown(5, function() { - displayNextItem(); - }); - } - } - // search finished, update title and status message - else { - Search.stopPulse(); - Search.title.text(_('Search Results')); - if (!resultCount) - Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.')); - else - Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount)); - Search.status.fadeIn(500); - } - } - displayNextItem(); - }, - - performObjectSearch : function(object, otherterms) { - var filenames = this._index.filenames; - var objects = this._index.objects; - var objnames = this._index.objnames; - var titles = this._index.titles; - - var importantResults = []; - var objectResults = []; - var unimportantResults = []; - - for (var prefix in objects) { - for (var name in objects[prefix]) { - var fullname = (prefix ? prefix + '.' : '') + name; - if (fullname.toLowerCase().indexOf(object) > -1) { - var match = objects[prefix][name]; - var objname = objnames[match[1]][2]; - var title = titles[match[0]]; - // If more than one term searched for, we require other words to be - // found in the name/title/description - if (otherterms.length > 0) { - var haystack = (prefix + ' ' + name + ' ' + - objname + ' ' + title).toLowerCase(); - var allfound = true; - for (var i = 0; i < otherterms.length; i++) { - if (haystack.indexOf(otherterms[i]) == -1) { - allfound = false; - break; - } - } - if (!allfound) { - continue; - } - } - var descr = objname + _(', in ') + title; - anchor = match[3]; - if (anchor == '') - anchor = fullname; - else if (anchor == '-') - anchor = objnames[match[1]][1] + '-' + fullname; - result = [filenames[match[0]], fullname, '#'+anchor, descr]; - switch (match[2]) { - case 1: objectResults.push(result); break; - case 0: importantResults.push(result); break; - case 2: unimportantResults.push(result); break; - } - } - } - } - - // sort results descending - objectResults.sort(function(a, b) { - return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); - }); - - importantResults.sort(function(a, b) { - return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); - }); - - unimportantResults.sort(function(a, b) { - return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); - }); - - return [importantResults, objectResults, unimportantResults] - } -} - -$(document).ready(function() { - Search.init(); -}); \ No newline at end of file diff --git a/_static/tnp.css b/_static/tnp.css deleted file mode 100644 index c082339..0000000 --- a/_static/tnp.css +++ /dev/null @@ -1,300 +0,0 @@ -/* - * tnp.css_t - * ~~~~~~~~~~~~ - * - * Sphinx stylesheet -- tnp theme based on nature theme. - * - * :copyright: Copyright 2007-2010 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -@import url("basic.css"); - -/* -- page layout ----------------------------------------------------------- */ - -body { - font-family: 'Georgia', serif; - font-size: 17px; - color: #000; - background: #f7faff; - margin: 0; - padding: 0; -} - -div.imalogo { - width: 700px; - margin:10px auto; -} - -div.imalogo img { - float: left; -} - -div.documentwrapper { - float: left; - width: 100%; -} - -div.bodywrapper { - margin: 40px auto 0 auto; - width: 700px; -} - -hr { - border: 1px solid #B1B4B6; -} - -div.body { - background-color: #f7faff; - color: #3E4349; - padding: 0 30px 30px 30px; -} - -} - -div.footer { - text-align: right; - color: #888; - padding: 10px; - font-size: 14px; - width: 650px; - margin: 0 auto 40px auto; -} - -div.footer a { - color: #888; - text-decoration: underline; -} - -div.related { - line-height: 32px; - color: #888; -} - -div.related ul { - padding: 0 0 0 10px; -} - -div.related a { - color: #004B6B; - text-decoration: none; -} - -div.social { - float: right; -} - -/* -- body styles ----------------------------------------------------------- */ - -a { - color: #004B6B; - text-decoration: underline; -} - -a:hover { - color: #6D4100; - text-decoration: underline; -} - -div.body { - padding-bottom: 40px; /* saved for footer */ -} - -div.body h1, -div.body h2, -div.body h3, -div.body h4, -div.body h5, -div.body h6 { - font-family: 'Garamond', 'Georgia', serif; - font-weight: normal; - margin: 30px 0px 10px 0px; - padding: 0; -} - -div.body h2 { font-size: 180%; } -div.body h3 { font-size: 150%; } -div.body h4 { font-size: 130%; } -div.body h5 { font-size: 100%; } -div.body h6 { font-size: 100%; } - -a.headerlink { - color: white; - padding: 0 4px; - text-decoration: none; -} - -a.headerlink:hover { - color: #444; - background: #eaeaea; -} - -div.body p, div.body dd, div.body li { - line-height: 1.4em; -} - -div.admonition { - background: #fafafa; - margin: 20px -30px; - padding: 10px 30px; - border-top: 1px solid #ccc; - border-bottom: 1px solid #ccc; -} - -div.admonition p.admonition-title { - font-family: 'Garamond', 'Georgia', serif; - font-weight: normal; - font-size: 24px; - margin: 0 0 10px 0; - padding: 0; - line-height: 1; -} - -div.admonition p.last { - margin-bottom: 0; -} - -div.highlight{ - background-color: white; -} - -dt:target, .highlight { - background: #FAF3E8; -} - -div.note { - background-color: #eee; - border: 1px solid #ccc; -} - -div.seealso { - background-color: #ffc; - border: 1px solid #ff6; -} - -div.topic { - background-color: #eee; -} - -div.warning { - background-color: #ffe4e4; - border: 1px solid #f66; -} - -#searchbox { - padding: 82px 10px; -} - -p.admonition-title { - display: inline; -} - -p.admonition-title:after { - content: ":"; -} - -pre, tt { - font-family: 'Consolas', 'Menlo', 'Deja Vu Sans Mono', 'Bitstream Vera Sans Mono', monospace; - font-size: 0.85em; - color: #AEAFB1; -} - -img.screenshot { -} - -tt.descname, tt.descclassname { - font-size: 0.95em; -} - -tt.descname { - padding-right: 0.08em; -} - -img.screenshot { - -moz-box-shadow: 2px 2px 4px #eee; - -webkit-box-shadow: 2px 2px 4px #eee; - box-shadow: 2px 2px 4px #eee; -} - -table.docutils { - border: 1px solid #888; - -moz-box-shadow: 2px 2px 4px #eee; - -webkit-box-shadow: 2px 2px 4px #eee; - box-shadow: 2px 2px 4px #eee; -} - -table.docutils td, table.docutils th { - border: 1px solid #888; - padding: 0.25em 0.7em; -} - -table.field-list, table.footnote { - border: none; - -moz-box-shadow: none; - -webkit-box-shadow: none; - box-shadow: none; -} - -table.footnote { - margin: 15px 0; - width: 100%; - border: 1px solid #eee; -} - -table.field-list th { - padding: 0 0.8em 0 0; -} - -table.field-list td { - padding: 0; -} - -table.footnote td { - padding: 0.5em; -} - -dl { - margin: 0; - padding: 0; -} - -dl dd { - margin-left: 30px; -} - -pre { - padding: 0; - margin: 15px -8px; - padding: 8px; - line-height: 1.3em; - border: 1px solid #676767; - background: #000000; - border-radius: 2px; - -moz-border-radius: 2px; - -webkit-border-radius: 2px; -} - -tt { - background-color: #ecf0f3; - color: #222; - /* padding: 1px 2px; */ -} - -tt.xref, a tt { - background-color: #FBFBFB; -} - -a:hover tt { - background: #EEE; -} - -article[id*=tab] { - width: 47rem; - height: 70rem; - padding: 2rem; - margin: 1rem 1rem 0 3rem; - background:#fcc; - box-shadow: inset 2px 2px 10px #888; - border: 2px solid #777; -} \ No newline at end of file diff --git a/_static/translations.js b/_static/translations.js deleted file mode 100644 index 8ccbc0c..0000000 --- a/_static/translations.js +++ /dev/null @@ -1 +0,0 @@ -Documentation.addTranslations({"locale": "es", "plural_expr": "(n != 1)", "messages": {"Hide Search Matches": "Coincidencias de la b\u00fasqueda", "Permalink to this definition": "Enlazar permanentemente con esta definici\u00f3n", "Expand sidebar": "", "Permalink to this headline": "Enlazar permanentemente con este t\u00edtulo", "Collapse sidebar": ""}}); \ No newline at end of file diff --git a/_static/underscore.js b/_static/underscore.js deleted file mode 100644 index 5d89914..0000000 --- a/_static/underscore.js +++ /dev/null @@ -1,23 +0,0 @@ -// Underscore.js 0.5.5 -// (c) 2009 Jeremy Ashkenas, DocumentCloud Inc. -// Underscore is freely distributable under the terms of the MIT license. -// Portions of Underscore are inspired by or borrowed from Prototype.js, -// Oliver Steele's Functional, and John Resig's Micro-Templating. -// For all details and documentation: -// http://documentcloud.github.com/underscore/ -(function(){var j=this,n=j._,i=function(a){this._wrapped=a},m=typeof StopIteration!=="undefined"?StopIteration:"__break__",b=j._=function(a){return new i(a)};if(typeof exports!=="undefined")exports._=b;var k=Array.prototype.slice,o=Array.prototype.unshift,p=Object.prototype.toString,q=Object.prototype.hasOwnProperty,r=Object.prototype.propertyIsEnumerable;b.VERSION="0.5.5";b.each=function(a,c,d){try{if(a.forEach)a.forEach(c,d);else if(b.isArray(a)||b.isArguments(a))for(var e=0,f=a.length;e=e.computed&&(e={value:f,computed:g})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);var e={computed:Infinity};b.each(a,function(f,g,h){g=c?c.call(d,f,g,h):f;gf?1:0}),"value")};b.sortedIndex=function(a,c,d){d=d||b.identity;for(var e=0,f=a.length;e>1;d(a[g])=0})})};b.zip=function(){for(var a=b.toArray(arguments),c=b.max(b.pluck(a,"length")),d=new Array(c),e=0;e0?f-c:c-f)>=0)return e;e[g++]=f}};b.bind=function(a,c){var d=b.rest(arguments,2);return function(){return a.apply(c||j,d.concat(b.toArray(arguments)))}};b.bindAll=function(a){var c=b.rest(arguments);if(c.length==0)c=b.functions(a);b.each(c,function(d){a[d]=b.bind(a[d],a)}); -return a};b.delay=function(a,c){var d=b.rest(arguments,2);return setTimeout(function(){return a.apply(a,d)},c)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(b.rest(arguments)))};b.wrap=function(a,c){return function(){var d=[a].concat(b.toArray(arguments));return c.apply(c,d)}};b.compose=function(){var a=b.toArray(arguments);return function(){for(var c=b.toArray(arguments),d=a.length-1;d>=0;d--)c=[a[d].apply(this,c)];return c[0]}};b.keys=function(a){if(b.isArray(a))return b.range(0,a.length); -var c=[];for(var d in a)q.call(a,d)&&c.push(d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=function(a){return b.select(b.keys(a),function(c){return b.isFunction(a[c])}).sort()};b.extend=function(a,c){for(var d in c)a[d]=c[d];return a};b.clone=function(a){if(b.isArray(a))return a.slice(0);return b.extend({},a)};b.tap=function(a,c){c(a);return a};b.isEqual=function(a,c){if(a===c)return true;var d=typeof a;if(d!=typeof c)return false;if(a==c)return true;if(!a&&c||a&&!c)return false; -if(a.isEqual)return a.isEqual(c);if(b.isDate(a)&&b.isDate(c))return a.getTime()===c.getTime();if(b.isNaN(a)&&b.isNaN(c))return true;if(b.isRegExp(a)&&b.isRegExp(c))return a.source===c.source&&a.global===c.global&&a.ignoreCase===c.ignoreCase&&a.multiline===c.multiline;if(d!=="object")return false;if(a.length&&a.length!==c.length)return false;d=b.keys(a);var e=b.keys(c);if(d.length!=e.length)return false;for(var f in a)if(!b.isEqual(a[f],c[f]))return false;return true};b.isEmpty=function(a){return b.keys(a).length== -0};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=function(a){return!!(a&&a.concat&&a.unshift)};b.isArguments=function(a){return a&&b.isNumber(a.length)&&!b.isArray(a)&&!r.call(a,"length")};b.isFunction=function(a){return!!(a&&a.constructor&&a.call&&a.apply)};b.isString=function(a){return!!(a===""||a&&a.charCodeAt&&a.substr)};b.isNumber=function(a){return p.call(a)==="[object Number]"};b.isDate=function(a){return!!(a&&a.getTimezoneOffset&&a.setUTCFullYear)};b.isRegExp=function(a){return!!(a&& -a.test&&a.exec&&(a.ignoreCase||a.ignoreCase===false))};b.isNaN=function(a){return b.isNumber(a)&&isNaN(a)};b.isNull=function(a){return a===null};b.isUndefined=function(a){return typeof a=="undefined"};b.noConflict=function(){j._=n;return this};b.identity=function(a){return a};b.breakLoop=function(){throw m;};var s=0;b.uniqueId=function(a){var c=s++;return a?a+c:c};b.template=function(a,c){a=new Function("obj","var p=[],print=function(){p.push.apply(p,arguments);};with(obj){p.push('"+a.replace(/[\r\t\n]/g, -" ").replace(/'(?=[^%]*%>)/g,"\t").split("'").join("\\'").split("\t").join("'").replace(/<%=(.+?)%>/g,"',$1,'").split("<%").join("');").split("%>").join("p.push('")+"');}return p.join('');");return c?a(c):a};b.forEach=b.each;b.foldl=b.inject=b.reduce;b.foldr=b.reduceRight;b.filter=b.select;b.every=b.all;b.some=b.any;b.head=b.first;b.tail=b.rest;b.methods=b.functions;var l=function(a,c){return c?b(a).chain():a};b.each(b.functions(b),function(a){var c=b[a];i.prototype[a]=function(){var d=b.toArray(arguments); -o.call(d,this._wrapped);return l(c.apply(b,d),this._chain)}});b.each(["pop","push","reverse","shift","sort","splice","unshift"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){c.apply(this._wrapped,arguments);return l(this._wrapped,this._chain)}});b.each(["concat","join","slice"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){return l(c.apply(this._wrapped,arguments),this._chain)}});i.prototype.chain=function(){this._chain=true;return this};i.prototype.value=function(){return this._wrapped}})(); diff --git a/_static/up-pressed.png b/_static/up-pressed.png deleted file mode 100644 index 8bd587a..0000000 Binary files a/_static/up-pressed.png and /dev/null differ diff --git a/_static/up.png b/_static/up.png deleted file mode 100644 index b946256..0000000 Binary files a/_static/up.png and /dev/null differ diff --git a/_static/websupport.js b/_static/websupport.js deleted file mode 100644 index e9bd1b8..0000000 --- a/_static/websupport.js +++ /dev/null @@ -1,808 +0,0 @@ -/* - * websupport.js - * ~~~~~~~~~~~~~ - * - * sphinx.websupport utilties for all documentation. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -(function($) { - $.fn.autogrow = function() { - return this.each(function() { - var textarea = this; - - $.fn.autogrow.resize(textarea); - - $(textarea) - .focus(function() { - textarea.interval = setInterval(function() { - $.fn.autogrow.resize(textarea); - }, 500); - }) - .blur(function() { - clearInterval(textarea.interval); - }); - }); - }; - - $.fn.autogrow.resize = function(textarea) { - var lineHeight = parseInt($(textarea).css('line-height'), 10); - var lines = textarea.value.split('\n'); - var columns = textarea.cols; - var lineCount = 0; - $.each(lines, function() { - lineCount += Math.ceil(this.length / columns) || 1; - }); - var height = lineHeight * (lineCount + 1); - $(textarea).css('height', height); - }; -})(jQuery); - -(function($) { - var comp, by; - - function init() { - initEvents(); - initComparator(); - } - - function initEvents() { - $('a.comment-close').live("click", function(event) { - event.preventDefault(); - hide($(this).attr('id').substring(2)); - }); - $('a.vote').live("click", function(event) { - event.preventDefault(); - handleVote($(this)); - }); - $('a.reply').live("click", function(event) { - event.preventDefault(); - openReply($(this).attr('id').substring(2)); - }); - $('a.close-reply').live("click", function(event) { - event.preventDefault(); - closeReply($(this).attr('id').substring(2)); - }); - $('a.sort-option').live("click", function(event) { - event.preventDefault(); - handleReSort($(this)); - }); - $('a.show-proposal').live("click", function(event) { - event.preventDefault(); - showProposal($(this).attr('id').substring(2)); - }); - $('a.hide-proposal').live("click", function(event) { - event.preventDefault(); - hideProposal($(this).attr('id').substring(2)); - }); - $('a.show-propose-change').live("click", function(event) { - event.preventDefault(); - showProposeChange($(this).attr('id').substring(2)); - }); - $('a.hide-propose-change').live("click", function(event) { - event.preventDefault(); - hideProposeChange($(this).attr('id').substring(2)); - }); - $('a.accept-comment').live("click", function(event) { - event.preventDefault(); - acceptComment($(this).attr('id').substring(2)); - }); - $('a.delete-comment').live("click", function(event) { - event.preventDefault(); - deleteComment($(this).attr('id').substring(2)); - }); - $('a.comment-markup').live("click", function(event) { - event.preventDefault(); - toggleCommentMarkupBox($(this).attr('id').substring(2)); - }); - } - - /** - * Set comp, which is a comparator function used for sorting and - * inserting comments into the list. - */ - function setComparator() { - // If the first three letters are "asc", sort in ascending order - // and remove the prefix. - if (by.substring(0,3) == 'asc') { - var i = by.substring(3); - comp = function(a, b) { return a[i] - b[i]; }; - } else { - // Otherwise sort in descending order. - comp = function(a, b) { return b[by] - a[by]; }; - } - - // Reset link styles and format the selected sort option. - $('a.sel').attr('href', '#').removeClass('sel'); - $('a.by' + by).removeAttr('href').addClass('sel'); - } - - /** - * Create a comp function. If the user has preferences stored in - * the sortBy cookie, use those, otherwise use the default. - */ - function initComparator() { - by = 'rating'; // Default to sort by rating. - // If the sortBy cookie is set, use that instead. - if (document.cookie.length > 0) { - var start = document.cookie.indexOf('sortBy='); - if (start != -1) { - start = start + 7; - var end = document.cookie.indexOf(";", start); - if (end == -1) { - end = document.cookie.length; - by = unescape(document.cookie.substring(start, end)); - } - } - } - setComparator(); - } - - /** - * Show a comment div. - */ - function show(id) { - $('#ao' + id).hide(); - $('#ah' + id).show(); - var context = $.extend({id: id}, opts); - var popup = $(renderTemplate(popupTemplate, context)).hide(); - popup.find('textarea[name="proposal"]').hide(); - popup.find('a.by' + by).addClass('sel'); - var form = popup.find('#cf' + id); - form.submit(function(event) { - event.preventDefault(); - addComment(form); - }); - $('#s' + id).after(popup); - popup.slideDown('fast', function() { - getComments(id); - }); - } - - /** - * Hide a comment div. - */ - function hide(id) { - $('#ah' + id).hide(); - $('#ao' + id).show(); - var div = $('#sc' + id); - div.slideUp('fast', function() { - div.remove(); - }); - } - - /** - * Perform an ajax request to get comments for a node - * and insert the comments into the comments tree. - */ - function getComments(id) { - $.ajax({ - type: 'GET', - url: opts.getCommentsURL, - data: {node: id}, - success: function(data, textStatus, request) { - var ul = $('#cl' + id); - var speed = 100; - $('#cf' + id) - .find('textarea[name="proposal"]') - .data('source', data.source); - - if (data.comments.length === 0) { - ul.html('
      • No comments yet.
        • '); - ul.data('empty', true); - } else { - // If there are comments, sort them and put them in the list. - var comments = sortComments(data.comments); - speed = data.comments.length * 100; - appendComments(comments, ul); - ul.data('empty', false); - } - $('#cn' + id).slideUp(speed + 200); - ul.slideDown(speed); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem retrieving the comments.'); - }, - dataType: 'json' - }); - } - - /** - * Add a comment via ajax and insert the comment into the comment tree. - */ - function addComment(form) { - var node_id = form.find('input[name="node"]').val(); - var parent_id = form.find('input[name="parent"]').val(); - var text = form.find('textarea[name="comment"]').val(); - var proposal = form.find('textarea[name="proposal"]').val(); - - if (text == '') { - showError('Please enter a comment.'); - return; - } - - // Disable the form that is being submitted. - form.find('textarea,input').attr('disabled', 'disabled'); - - // Send the comment to the server. - $.ajax({ - type: "POST", - url: opts.addCommentURL, - dataType: 'json', - data: { - node: node_id, - parent: parent_id, - text: text, - proposal: proposal - }, - success: function(data, textStatus, error) { - // Reset the form. - if (node_id) { - hideProposeChange(node_id); - } - form.find('textarea') - .val('') - .add(form.find('input')) - .removeAttr('disabled'); - var ul = $('#cl' + (node_id || parent_id)); - if (ul.data('empty')) { - $(ul).empty(); - ul.data('empty', false); - } - insertComment(data.comment); - var ao = $('#ao' + node_id); - ao.find('img').attr({'src': opts.commentBrightImage}); - if (node_id) { - // if this was a "root" comment, remove the commenting box - // (the user can get it back by reopening the comment popup) - $('#ca' + node_id).slideUp(); - } - }, - error: function(request, textStatus, error) { - form.find('textarea,input').removeAttr('disabled'); - showError('Oops, there was a problem adding the comment.'); - } - }); - } - - /** - * Recursively append comments to the main comment list and children - * lists, creating the comment tree. - */ - function appendComments(comments, ul) { - $.each(comments, function() { - var div = createCommentDiv(this); - ul.append($(document.createElement('li')).html(div)); - appendComments(this.children, div.find('ul.comment-children')); - // To avoid stagnating data, don't store the comments children in data. - this.children = null; - div.data('comment', this); - }); - } - - /** - * After adding a new comment, it must be inserted in the correct - * location in the comment tree. - */ - function insertComment(comment) { - var div = createCommentDiv(comment); - - // To avoid stagnating data, don't store the comments children in data. - comment.children = null; - div.data('comment', comment); - - var ul = $('#cl' + (comment.node || comment.parent)); - var siblings = getChildren(ul); - - var li = $(document.createElement('li')); - li.hide(); - - // Determine where in the parents children list to insert this comment. - for(i=0; i < siblings.length; i++) { - if (comp(comment, siblings[i]) <= 0) { - $('#cd' + siblings[i].id) - .parent() - .before(li.html(div)); - li.slideDown('fast'); - return; - } - } - - // If we get here, this comment rates lower than all the others, - // or it is the only comment in the list. - ul.append(li.html(div)); - li.slideDown('fast'); - } - - function acceptComment(id) { - $.ajax({ - type: 'POST', - url: opts.acceptCommentURL, - data: {id: id}, - success: function(data, textStatus, request) { - $('#cm' + id).fadeOut('fast'); - $('#cd' + id).removeClass('moderate'); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem accepting the comment.'); - } - }); - } - - function deleteComment(id) { - $.ajax({ - type: 'POST', - url: opts.deleteCommentURL, - data: {id: id}, - success: function(data, textStatus, request) { - var div = $('#cd' + id); - if (data == 'delete') { - // Moderator mode: remove the comment and all children immediately - div.slideUp('fast', function() { - div.remove(); - }); - return; - } - // User mode: only mark the comment as deleted - div - .find('span.user-id:first') - .text('[deleted]').end() - .find('div.comment-text:first') - .text('[deleted]').end() - .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id + - ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id) - .remove(); - var comment = div.data('comment'); - comment.username = '[deleted]'; - comment.text = '[deleted]'; - div.data('comment', comment); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem deleting the comment.'); - } - }); - } - - function showProposal(id) { - $('#sp' + id).hide(); - $('#hp' + id).show(); - $('#pr' + id).slideDown('fast'); - } - - function hideProposal(id) { - $('#hp' + id).hide(); - $('#sp' + id).show(); - $('#pr' + id).slideUp('fast'); - } - - function showProposeChange(id) { - $('#pc' + id).hide(); - $('#hc' + id).show(); - var textarea = $('#pt' + id); - textarea.val(textarea.data('source')); - $.fn.autogrow.resize(textarea[0]); - textarea.slideDown('fast'); - } - - function hideProposeChange(id) { - $('#hc' + id).hide(); - $('#pc' + id).show(); - var textarea = $('#pt' + id); - textarea.val('').removeAttr('disabled'); - textarea.slideUp('fast'); - } - - function toggleCommentMarkupBox(id) { - $('#mb' + id).toggle(); - } - - /** Handle when the user clicks on a sort by link. */ - function handleReSort(link) { - var classes = link.attr('class').split(/\s+/); - for (var i=0; iThank you! Your comment will show up ' - + 'once it is has been approved by a moderator.'); - } - // Prettify the comment rating. - comment.pretty_rating = comment.rating + ' point' + - (comment.rating == 1 ? '' : 's'); - // Make a class (for displaying not yet moderated comments differently) - comment.css_class = comment.displayed ? '' : ' moderate'; - // Create a div for this comment. - var context = $.extend({}, opts, comment); - var div = $(renderTemplate(commentTemplate, context)); - - // If the user has voted on this comment, highlight the correct arrow. - if (comment.vote) { - var direction = (comment.vote == 1) ? 'u' : 'd'; - div.find('#' + direction + 'v' + comment.id).hide(); - div.find('#' + direction + 'u' + comment.id).show(); - } - - if (opts.moderator || comment.text != '[deleted]') { - div.find('a.reply').show(); - if (comment.proposal_diff) - div.find('#sp' + comment.id).show(); - if (opts.moderator && !comment.displayed) - div.find('#cm' + comment.id).show(); - if (opts.moderator || (opts.username == comment.username)) - div.find('#dc' + comment.id).show(); - } - return div; - } - - /** - * A simple template renderer. Placeholders such as <%id%> are replaced - * by context['id'] with items being escaped. Placeholders such as <#id#> - * are not escaped. - */ - function renderTemplate(template, context) { - var esc = $(document.createElement('div')); - - function handle(ph, escape) { - var cur = context; - $.each(ph.split('.'), function() { - cur = cur[this]; - }); - return escape ? esc.text(cur || "").html() : cur; - } - - return template.replace(/<([%#])([\w\.]*)\1>/g, function() { - return handle(arguments[2], arguments[1] == '%' ? true : false); - }); - } - - /** Flash an error message briefly. */ - function showError(message) { - $(document.createElement('div')).attr({'class': 'popup-error'}) - .append($(document.createElement('div')) - .attr({'class': 'error-message'}).text(message)) - .appendTo('body') - .fadeIn("slow") - .delay(2000) - .fadeOut("slow"); - } - - /** Add a link the user uses to open the comments popup. */ - $.fn.comment = function() { - return this.each(function() { - var id = $(this).attr('id').substring(1); - var count = COMMENT_METADATA[id]; - var title = count + ' comment' + (count == 1 ? '' : 's'); - var image = count > 0 ? opts.commentBrightImage : opts.commentImage; - var addcls = count == 0 ? ' nocomment' : ''; - $(this) - .append( - $(document.createElement('a')).attr({ - href: '#', - 'class': 'sphinx-comment-open' + addcls, - id: 'ao' + id - }) - .append($(document.createElement('img')).attr({ - src: image, - alt: 'comment', - title: title - })) - .click(function(event) { - event.preventDefault(); - show($(this).attr('id').substring(2)); - }) - ) - .append( - $(document.createElement('a')).attr({ - href: '#', - 'class': 'sphinx-comment-close hidden', - id: 'ah' + id - }) - .append($(document.createElement('img')).attr({ - src: opts.closeCommentImage, - alt: 'close', - title: 'close' - })) - .click(function(event) { - event.preventDefault(); - hide($(this).attr('id').substring(2)); - }) - ); - }); - }; - - var opts = { - processVoteURL: '/_process_vote', - addCommentURL: '/_add_comment', - getCommentsURL: '/_get_comments', - acceptCommentURL: '/_accept_comment', - deleteCommentURL: '/_delete_comment', - commentImage: '/static/_static/comment.png', - closeCommentImage: '/static/_static/comment-close.png', - loadingImage: '/static/_static/ajax-loader.gif', - commentBrightImage: '/static/_static/comment-bright.png', - upArrow: '/static/_static/up.png', - downArrow: '/static/_static/down.png', - upArrowPressed: '/static/_static/up-pressed.png', - downArrowPressed: '/static/_static/down-pressed.png', - voting: false, - moderator: false - }; - - if (typeof COMMENT_OPTIONS != "undefined") { - opts = jQuery.extend(opts, COMMENT_OPTIONS); - } - - var popupTemplate = '\ -
        \ -

        \ - Sort by:\ - best rated\ - newest\ - oldest\ -

        \ -
        Comments
        \ -
        \ - loading comments...
        \ -
          \ -
          \ -

          Add a comment\ - (markup):

          \ -
          \ - reStructured text markup: *emph*, **strong**, \ - ``code``, \ - code blocks: :: and an indented block after blank line
          \ - \ - \ -

          \ - \ - Propose a change ▹\ - \ - \ - Propose a change ▿\ - \ -

          \ - \ - \ - \ - \ - \ -
          \ -
          '; - - var commentTemplate = '\ -
          \ -
          \ -
          \ - \ - \ - \ - \ - \ - \ -
          \ -
          \ - \ - \ - \ - \ - \ - \ -
          \ -
          \ -
          \ -

          \ - <%username%>\ - <%pretty_rating%>\ - <%time.delta%>\ -

          \ -
          <#text#>
          \ -

          \ - \ - reply ▿\ - proposal ▹\ - proposal ▿\ - \ - \ -

          \ - 
          \
-<#proposal_diff#>\
-
          \ -
            \ -
            \ -
            \ -
            \ - '; - - var replyTemplate = '\ -
          • \ -
            \ -
            \ - \ - \ - \ - \ - \ -
            \ -
            \ -
            • '; - - $(document).ready(function() { - init(); - }); -})(jQuery); - -$(document).ready(function() { - // add comment anchors for all paragraphs that are commentable - $('.sphinx-has-comment').comment(); - - // highlight search words in search results - $("div.context").each(function() { - var params = $.getQueryParameters(); - var terms = (params.q) ? params.q[0].split(/\s+/) : []; - var result = $(this); - $.each(terms, function() { - result.highlightText(this.toLowerCase(), 'highlighted'); - }); - }); - - // directly open comment window if requested - var anchor = document.location.hash; - if (anchor.substring(0, 9) == '#comment-') { - $('#ao' + anchor.substring(9)).click(); - document.location.hash = '#s' + anchor.substring(9); - } -}); diff --git a/book/controller.html b/book/controller.html deleted file mode 100644 index 418e945..0000000 --- a/book/controller.html +++ /dev/null @@ -1,690 +0,0 @@ - - - - - - - Controlador — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Controlador

            -

            Un controlador es una función PHP que tú creas, misma que toma información desde la petición HTTP y construye una respuesta HTTP y la devuelve (como un objeto Respuesta de Symfony2). La respuesta podría ser una página HTML, un documento XML, un arreglo JSON serializado, una imagen, una redirección, un error 404 o cualquier otra cosa que se te ocurra. El controlador contiene toda la lógica arbitraria que tu aplicación necesita para reproducir el contenido de la página.

            -

            Ve lo sencillo que es mirando un controlador Symfony2 en acción. -El siguiente controlador reproducirá una página que simplemente imprime Hello world!:

            -
            use Symfony\Component\HttpFoundation\Response;
-
-public function helloAction()
-{
-    return new Response('Hello world!');
-}
-
            -
            -

            El objetivo de un controlador siempre es el mismo: crear y devolver un objeto Respuesta. Al mismo tiempo, este puede leer la información de la petición, cargar un recurso de base de datos, enviar un correo electrónico, o fijar información en la sesión del usuario. -Pero en todos los casos, el controlador eventualmente devuelve el objeto Respuesta que será entregado al cliente.

            -

            ¡No hay magia y ningún otro requisito del cual preocuparse! Aquí tienes unos cuantos ejemplos comunes:

            -
              -
            • Controlador A prepara un objeto Respuesta que reproduce el contenido de la página principal del sitio.
              • -
            • Controlador B lee el parámetro slug de la petición para cargar una entrada del blog desde la base de datos y crear un objeto Respuesta exhibiendo ese blog. Si el slug no se puede encontrar en la base de datos, crea y devuelve un objeto Respuesta con un código de estado 404.
              • -
            • Controlador C procesa la información presentada en un formulario de contacto. Este lee la información del formulario desde la petición, guarda la información del contacto en la base de datos y envía mensajes de correo electrónico con la información de contacto al administrador del sitio web. Por último, crea un objeto Respuesta que redirige al navegador del cliente desde el formulario de contacto a la página de «agradecimiento».
              • -
            -
            -

            Ciclo de vida de la petición, controlador, respuesta

            -

            Cada petición manejada por un proyecto Symfony2 pasa por el mismo ciclo de vida básico. -La plataforma se encarga de las tareas repetitivas y, finalmente, ejecuta el controlador, que contiene el código personalizado de tu aplicación:

            -
              -
            1. Cada petición es manejada por un único archivo controlador frontal (por ejemplo, app.php o app_dev.php) el cual es responsable de arrancar la aplicación;
              2. -
            2. El Enrutador lee la información de la petición (por ejemplo, la URI), encuentra una ruta que coincida con esa información, y lee el parámetro _controller de la ruta;
              3. -
            3. El controlador de la ruta encontrada es ejecutado y el código dentro del controlador crea y devuelve un objeto Respuesta;
              4. -
            4. Las cabeceras HTTP y el contenido del objeto Respuesta se envían de vuelta al cliente.
              5. -
            -

            La creación de una página es tan fácil como crear un controlador (#3) y hacer una ruta que vincula una URL con ese controlador (#2).

            -
            -

            Nota

            -

            A pesar de la similitud en el nombre, un «controlador frontal» es diferente a los «controladores» tratados en este capítulo. Un controlador frontal es un pequeño archivo PHP que vive en tu directorio web raíz y a través del cual se dirigen todas las peticiones. Una aplicación típica tendrá un controlador frontal en producción (por ejemplo, app.php) y un controlador frontal para desarrollo (por ejemplo, app_dev.php). Probablemente nunca necesites editar, ver o preocuparte por los controladores frontales en tu aplicación.

            -
            -
            -
            -

            Un controlador sencillo

            -

            Mientras que un controlador puede ser cualquier ejecutable PHP (una función, un método en un objeto o un Cierre), en Symfony2, un controlador suele ser un único método dentro de un objeto controlador. Los controladores también se conocen como acciones.

            -
             1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
-10
-11
-12
            // src/Acme/HelloBundle/Controller/HelloController.php
-namespace Acme\HelloBundle\Controller;
-
-use Symfony\Component\HttpFoundation\Response;
-
-class HelloController
-{
-    public function indexAction($name)
-    {
-        return new Response('<html><body>Hello '.$name.'!</body></html>');
-    }
-}
-
            -
            -
            -

            Truco

            -

            Ten en cuenta que el controlador es el método indexAction, que vive dentro de una clase controlador (HelloController). No te dejes confundir por la nomenclatura: una clase controlador simplemente es una conveniente forma de agrupar varios controladores/acciones. Generalmente, la clase controlador albergará varios controladores (por ejemplo, updateAction, deleteAction, etc.).

            -
            -

            Este controlador es bastante sencillo:

            -
              -
            • línea 4: Symfony2 toma ventaja de la funcionalidad del espacio de nombres de PHP 5.3 para el espacio de nombres de la clase del controlador completa. La palabra clave use importa la clase Respuesta, la cual devolverá el controlador.
              • -
            • línea 6: El nombre de clase es la concatenación del nombre de la clase controlador (es decir Hello) y la palabra Controller. Esta es una convención que proporciona consistencia a los controladores y permite hacer referencia sólo a la primera parte del nombre (es decir, Hello) en la configuración del enrutador.
              • -
            • línea 8: Cada acción en una clase controlador se sufija con Action y en la configuración de enrutado se refiere con el nombre de la acción (index). -En la siguiente sección, crearás una ruta que asigna una URI a esta acción. -Aprenderás cómo los marcadores de posición de la ruta ({name}) se convierten en argumentos para el método de acción ($name).
              • -
            • línea 10: el controlador crea y devuelve un objeto Respuesta.
              • -
            -
            -
            -

            Asociando una URL a un controlador

            -

            El nuevo controlador devuelve una página HTML simple. Para realmente ver esta página en tu navegador, necesitas crear una ruta, la cual corresponda a un patrón de URL específico para el controlador:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-hello:
-    path:      /hello/{name}
-    defaults:  { _controller: AcmeHelloBundle:Hello:index }
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<route id="hello" path="/hello/{name}">
-    <default key="_controller">AcmeHelloBundle:Hello:index</default>
-</route>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-$collection->add('hello', new Route('/hello/{name}', array(
-    '_controller' => 'AcmeHelloBundle:Hello:index',
-)));
-
              -
              -
              • -
            -
            -

            Yendo ahora a /hello/ryan se ejecuta el controlador HelloController::indexAction() y pasa ryan a la variable $name. Crear una «página» significa simplemente que debes crear un método controlador y una ruta asociada.

            -

            Observa la sintaxis utilizada para referirse al controlador: AcmeHelloBundle:Hello:index. -Symfony2 utiliza una flexible notación de cadena para referirse a diferentes controladores. -Esta es la sintaxis más común y le dice a Symfony2 que busque una clase controlador llamada HelloController dentro de un paquete llamado AcmeHelloBundle. Entonces ejecuta el método indexAction().

            -

            Para más detalles sobre el formato de cadena utilizado para referirte a diferentes controladores, consulta el Patrón de nomenclatura para controladores.

            -
            -

            Nota

            -

            Este ejemplo coloca la configuración de enrutado directamente en el directorio app/config/. Una mejor manera de organizar tus rutas es colocar cada ruta en el paquete al que pertenece. Para más información sobre este tema, consulta Incluyendo recursos de enrutado externos.

            -
            -
            -

            Truco

            -

            Puedes aprender mucho más sobre el sistema de enrutado en el capítulo de enrutado.

            -
            -
            -

            Parámetros de ruta como argumentos para el controlador

            -

            Ya sabes que el parámetro _controller en AcmeHelloBundle:Hello:index se refiere al método HelloController::indexAction() que vive dentro del paquete AcmeHelloBundle. Lo más interesante de esto son los argumentos que se pasan a este método:

            -
            // src/Acme/HelloBundle/Controller/HelloController.php
-namespace Acme\HelloBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class HelloController extends Controller
-{
-    public function indexAction($name)
-    {
-      // ...
-    }
-}
-
            -
            -

            El controlador tiene un solo argumento, $name, el cual corresponde al parámetro {name} de la ruta coincidente (ryan en el ejemplo). De hecho, cuando ejecutas tu controlador, Symfony2 empareja cada argumento del controlador con un parámetro de la ruta coincidente. Ve el siguiente ejemplo:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-hello:
-    path:      /hello/{first_name}/{last_name}
-    defaults:  { _controller: AcmeHelloBundle:Hello:index, color: green }
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<route id="hello" path="/hello/{first_name}/{last_name}">
-    <default key="_controller">AcmeHelloBundle:Hello:index</default>
-    <default key="color">green</default>
-</route>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-$collection->add('hello', new Route('/hello/{first_name}/{last_name}', array(
-    '_controller' => 'AcmeHelloBundle:Hello:index',
-    'color'       => 'green',
-)));
-
              -
              -
              • -
            -
            -

            El controlador para esto puede tomar varios argumentos:

            -
            public function indexAction($first_name, $last_name, $color)
-{
-    // ...
-}
-
            -
            -

            Ten en cuenta que ambas variables marcadoras de posición ({first_name}, {last_name}) así como la variable predeterminada color están disponibles como argumentos en el controlador. Cuando una ruta corresponde, las variables marcadoras de posición se combinan con defaults para hacer que un arreglo esté disponible para tu controlador.

            -

            Asociar parámetros de ruta a los argumentos del controlador es fácil y flexible. Ten muy en cuenta las siguientes pautas mientras desarrollas.

            -
              -

            • El orden de los argumentos del controlador no tiene importancia

              -
              -

              Symfony2 es capaz de igualar los nombres de los parámetros de la ruta con los nombres de las variables en la firma del método controlador. En otras palabras, se da cuenta de que el parámetro {last_name} coincide con el argumento $last_name. -Los argumentos del controlador se pueden reorganizar completamente y aún así siguen funcionando perfectamente:

              -
              public function indexAction($last_name, $color, $first_name)
-{
-    // ...
-}
-
              -
              -
              -
              • -

            • Cada argumento requerido del controlador debe coincidir con un parámetro de enrutado

              -
              -

              Lo siguiente lanzará una RuntimeException porque no hay ningún parámetro foo definido en la ruta:

              -
              public function indexAction($first_name, $last_name, $color, $foo)
-{
-    // ...
-}
-
              -
              -

              Sin embargo, hacer que el argumento sea opcional, es perfectamente legal. El siguiente ejemplo no lanzará una excepción:

              -
              public function indexAction($first_name, $last_name, $color, $foo = 'bar')
-{
-    // ...
-}
-
              -
              -
              -
              • -

            • No todos los parámetros de enrutado deben ser argumentos en tu controlador

              -
              -

              Si por ejemplo, last_name no es tan importante para tu controlador, lo puedes omitir por completo:

              -
              public function indexAction($first_name, $color)
-{
-    // ...
-}
-
              -
              -
              -
              • -
            -
            -

            Truco

            -

            Además, todas las rutas tienen un parámetro _route especial, el cual es igual al nombre de la ruta con la que fue emparejado (por ejemplo, hello). Aunque no suele ser útil, igualmente está disponible como un argumento del controlador.

            -
            -
            -
            -

            La Petición como argumento para el controlador

            -

            Para mayor comodidad, también puedes hacer que Symfony pase el objeto Petición como un argumento a tu controlador. Esto es conveniente especialmente cuando trabajas con formularios, por ejemplo:

            -
            use Symfony\Component\HttpFoundation\Request;
-
-public function updateAction(Request $request)
-{
-    $form = $this->createForm(...);
-
-    $form->bind($request);
-    // ...
-}
-
            -
            -
            -
            -
            -

            Creando páginas estáticas

            -

            Puedes crear una página estática incluso sin crear un controlador (sólo se necesita una ruta -y la plantilla).

            -

            ¡Utilizalo! Ve Cómo dibujar una plantilla sin un controlador personalizado.

            -
            -
            -

            La clase base del controlador

            -

            Para mayor comodidad, Symfony2 viene con una clase Controller base, que te ayuda en algunas de las tareas más comunes del Controlador y proporciona acceso a cualquier recurso que tu clase controlador pueda necesitar. Al extender esta clase Controlador, puedes tomar ventaja de varios métodos ayudantes.

            -

            Agrega la instrucción use en lo alto de la clase Controlador y luego modifica HelloController para extenderla:

            -
            // src/Acme/HelloBundle/Controller/HelloController.php
-namespace Acme\HelloBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Symfony\Component\HttpFoundation\Response;
-
-class HelloController extends Controller
-{
-    public function indexAction($name)
-    {
-        return new Response('<html><body>Hello '.$name.'!</body></html>');
-    }
-}
-
            -
            -

            Esto, en realidad no cambia nada acerca de cómo funciona el controlador. En la siguiente sección, aprenderás acerca de los métodos ayudantes que la clase base del controlador pone a tu disposición. Estos métodos sólo son atajos para utilizar la funcionalidad del núcleo de Symfony2 que está a nuestra disposición, usando o no la clase base Controller. Una buena manera de ver la funcionalidad del núcleo en acción es buscar en la misma clase Symfony\Bundle\FrameworkBundle\Controller\Controller.

            -
            -

            Truco

            -

            Extender la clase base Controller en Symfony es opcional; esta contiene útiles atajos, pero no es obligatorio. También puedes extender la clase Symfony\Component\DependencyInjection\ContainerAware. El objeto contenedor del servicio será accesible a través de la propiedad container.

            -
            -
            -

            Nota

            -

            Puedes definir tus Controladores como Servicios.

            -
            -
            -
            -

            Tareas comunes del controlador

            -

            A pesar de que un controlador puede hacer prácticamente cualquier cosa, la mayoría de los controladores se encargarán de las mismas tareas básicas una y otra vez. Estas tareas, tal como redirigir, procesar plantillas y acceder a servicios básicos, son muy fáciles de manejar en Symfony2.

            -
            -

            Redirigiendo

            -

            Si deseas redirigir al usuario a otra página, utiliza el método redirect():

            -
            public function indexAction()
-{
-    return $this->redirect($this->generateUrl('homepage'));
-}
-
            -
            -

            El método generateUrl() es sólo una función auxiliar que genera la URL de una determinada ruta. Para más información, consulta el capítulo Enrutando.

            -

            Por omisión, el método redirect() produce una redirección 302 (temporal). Para realizar una redirección 301 (permanente), modifica el segundo argumento:

            -
            public function indexAction()
-{
-    return $this->redirect($this->generateUrl('homepage'), 301);
-}
-
            -
            -
            -

            Truco

            -

            El método redirect() simplemente es un atajo que crea un objeto Respuesta que se especializa en redirigir a los usuarios. Es equivalente a:

            -
            use Symfony\Component\HttpFoundation\RedirectResponse;
-
-return new RedirectResponse($this->generateUrl('homepage'));
-
            -
            -
            -
            -
            -

            Reenviando

            -

            Además, fácilmente puedes redirigir internamente hacia a otro controlador con el método forward(). En lugar de redirigir el navegador del usuario, este hace una subpetición interna, y llama el controlador especificado. El método forward() regresa el objeto Respuesta, el cual es devuelto desde el controlador:

            -
            public function indexAction($name)
-{
-    $response = $this->forward('AcmeHelloBundle:Hello:fancy', array(
-        'name'  => $name,
-        'color' => 'green',
-    ));
-
-    // ... adicionalmente modifica la respuesta o la devuelve
-    //     directamente
-
-    return $response;
-}
-
            -
            -

            Ten en cuenta que el método forward() utiliza la misma representación de cadena del controlador utilizada en la configuración de enrutado. En este caso, la clase controlador de destino será HelloController dentro de algún AcmeHelloBundle. -El arreglo pasado al método se convierte en los argumentos del controlador resultante. -Esta misma interfaz se utiliza al incrustar controladores en las plantillas (consulta Integrando controladores). El método del controlador destino debe tener un aspecto como el siguiente:

            -
            public function fancyAction($name, $color)
-{
-    // ... crea y devuelve un objeto Response
-}
-
            -
            -

            Y al igual que al crear un controlador para una ruta, el orden de los argumentos para fancyAction no tiene la menor importancia. Symfony2 empareja las claves nombre con el índice (por ejemplo, name) con el argumento del método (por ejemplo, $name). Si cambias el orden de los argumentos, Symfony2 todavía pasará el valor correcto a cada variable.

            -
            -

            Truco

            -

            Al igual que otros métodos del Controller base, el método forward sólo es un atajo para la funcionalidad del núcleo de Symfony2. Puedes redirigir directamente por medio del servicio http_kernel. Un reenvío devuelve un objeto Respuesta:

            -
            $httpKernel = $this->container->get('http_kernel');
-$response = $httpKernel->forward(
-    'AcmeHelloBundle:Hello:fancy',
-    array(
-        'name'  => $name,
-        'color' => 'green',
-    )
-);
-
            -
            -
            -
            -
            -

            Procesando plantillas

            -

            Aunque no es un requisito, la mayoría de los controladores en última instancia, reproducen una plantilla que es responsable de generar el código HTML (u otro formato) para el controlador. -El método renderView() procesa una plantilla y devuelve su contenido. Puedes usar el contenido de la plantilla para crear un objeto Respuesta:

            -
            use Symfony\Component\HttpFoundation\Response;
-
-$content = $this->renderView(
-    'AcmeHelloBundle:Hello:index.html.twig',
-    array('name' => $name)
-);
-
-return new Response($content);
-
            -
            -

            Incluso puedes hacerlo en un solo paso con el método render(), el cual devuelve un objeto Respuesta con el contenido de la plantilla:

            -
            return $this->render(
-    'AcmeHelloBundle:Hello:index.html.twig',
-    array('name' => $name)
-);
-
            -
            -

            En ambos casos, se reproducirá la plantilla Resources/views/Hello/index.html.twig dentro del AcmeHelloBundle.

            -

            El motor de plantillas de Symfony se explica con gran detalle en el capítulo Plantillas.

            -
            -

            Truco

            -

            Incluso puedes evitar la llamada al método render utilizando la anotación @Template. Consulta la documentación del FrameworkExtraBundle para más detalles.

            -
            -
            -

            Truco

            -

            El método renderView es un atajo para usar el servicio de plantillas. También puedes usar directamente el servicio de plantillas:

            -
            $templating = $this->get('templating');
-$content = $templating->render(
-    'AcmeHelloBundle:Hello:index.html.twig',
-    array('name' => $name)
-);
-
            -
            -
            -
            -

            Nota

            -

            Es posible reproducir las plantillas en subdirectorios más profundos también, no obstante, ten cuidado para evitar caer en la trampa de hacer la estructura de directorios excesivamente elaborada:

            -
            $templating->render(
-    'AcmeHelloBundle:Hello/Greetings:index.html.twig',
-    array('name' => $name)
-);
-// reproduce index.html.twig ubicada en Resources/views/Hello/Greetings.
-
            -
            -
            -
            -
            -

            Accediendo a otros servicios

            -

            Al extender la clase base del controlador, puedes acceder a cualquier servicio de Symfony2 a través del método get(). Aquí hay varios servicios comunes que puedes necesitar:

            -
            $request = $this->getRequest();
-
-$templating = $this->get('templating');
-
-$router = $this->get('router');
-
-$mailer = $this->get('mailer');
-
            -
            -

            Hay un sinnúmero de servicios disponibles y te animamos a definir tus propios servicios. Para listar todos los servicios disponibles, utiliza la orden container:debug de la consola:

            -
            $ php app/console container:debug
-
            -
            -

            Para más información, consulta el capítulo Contenedor de servicios.

            -
            -
            -
            -

            Gestionando errores y páginas 404

            -

            Cuando no se encuentra algo, debes jugar bien con el protocolo HTTP y devolver una respuesta 404. Para ello, debes lanzar un tipo de excepción especial. -Si estás extendiendo la clase base del controlador, haz lo siguiente:

            -
            public function indexAction()
-{
-    // recupera el objeto desde la base de datos
-    $product = ...;
-    if (!$product) {
-        throw $this->createNotFoundException('The product does not exist');
-    }
-
-    return $this->render(...);
-}
-
            -
            -

            El método createNotFoundException() crea un objeto NotFoundHttpException especial, que en última instancia, desencadena una respuesta HTTP 404 en el interior de Symfony.

            -

            Por supuesto, estás en libertad de lanzar cualquier clase de Excepción en tu controlador —Symfony2 automáticamente devolverá una respuesta HTTP con código 500.

            -
            throw new \Exception('Something went wrong!');
-
            -
            -

            En todos los casos, el usuario final ve una página de error estilizada y a los desarrolladores se les muestra una página de depuración de error completa (cuando visualizas la página en modo de depuración). -Puedes personalizar ambas páginas de error. Para más detalles, lee «Cómo personalizar páginas de error» en el recetario.

            -
            -
            -

            Gestionando la sesión

            -

            Symfony2 proporciona un agradable objeto sesión que puedes utilizar para almacenar información sobre el usuario (ya sea una persona real usando un navegador, un robot o un servicio web) entre las peticiones. De manera predeterminada, Symfony2 almacena los atributos de una cookie usando las sesiones nativas de PHP.

            -

            Almacenar y recuperar información de la sesión se puede conseguir fácilmente desde cualquier controlador:

            -
            $session = $this->getRequest()->getSession();
-
-// guarda un atributo para reutilizarlo durante una
-// posterior petición del usuario
-$session->set('foo', 'bar');
-
-// en otro controlador por otra petición
-$foo = $session->get('foo');
-
-// usa un valor predefinido si la clave no existe
-$filters = $session->set('filters', array());
-
            -
            -

            Estos atributos se mantendrán en el usuario por el resto de esa sesión.

            -
            -

            Mensajes flash

            -

            También puedes almacenar pequeños mensajes que se pueden guardar en la sesión del usuario para exactamente una petición adicional. Esto es útil cuando procesas un formulario: -deseas redirigir y proporcionar un mensaje especial que aparezca en la siguiente petición. -Este tipo de mensajes se conocen como mensajes «flash».

            -

            Por ejemplo, imagina que estás procesando el envío de un formulario:

            -
            public function updateAction()
-{
-    $form = $this->createForm(...);
-
-    $form->bind($this->getRequest());
-    if ($form->isValid()) {
-        // hace algún tipo de procesamiento
-
-        $this->get('session')->getFlashBag()->add('notice', 'Your changes were saved!');
-
-        return $this->redirect($this->generateUrl(...));
-    }
-
-    return $this->render(...);
-}
-
            -
            -

            Después de procesar la petición, el controlador establece un mensaje flash notice y luego redirige al usuario. El nombre (aviso) no es significativo —es lo que estás usando para identificar el tipo del mensaje.

            -

            En la siguiente acción de la plantilla, podrías utilizar el siguiente código para reproducir el mensaje de aviso:

            -
            -
              -
            • Twig
              {% for flashMessage in app.session.flashbag.get('notice') %}
-    <div class="flash-notice">
-        {{ flashMessage }}
-    </div>
-{% endfor %}
-
              -
              -
              • -
            • PHP
              <?php foreach ($view['session']->getFlashBag()->get('notice') as $message): ?>
-    <div class="flash-notice">
-        <?php echo "<div class='flash-error'>$message</div>" ?>
-    </div>
-<?php endforeach; ?>
-
              -
              -
              • -
            -
            -

            Por diseño, los mensajes flash están destinados a vivir por exactamente una petición (estos «desaparecen en un flash»). Están diseñados para utilizarlos a través de redirecciones exactamente como lo se hizo en este ejemplo.

            -
            -
            -
            -

            El objeto Respuesta

            -

            El único requisito para un controlador es que devuelva un objeto Respuesta. La clase Symfony\Component\HttpFoundation\Response es una abstracción PHP en torno a la respuesta HTTP —el mensaje de texto, relleno con cabeceras HTTP y el contenido que se envía de vuelta al cliente:

            -
            use Symfony\Component\HttpFoundation\Response;
-
-// crea una simple respuesta con un código de estado 200 (el predeterminado)
-$response = new Response('Hello '.$name, 200);
-
-// crea una respuesta JSON con código de estado 200
-$response = new Response(json_encode(array('name' => $name)));
-$response->headers->set('Content-Type', 'application/json');
-
            -
            -
            -

            Truco

            -

            La propiedad headers es un objeto Symfony\Component\HttpFoundation\HeaderBag con varios métodos útiles para lectura y mutación de las cabeceras del objeto Respuesta. Los nombres de las cabeceras están normalizados para que puedas usar Content-Type y este sea equivalente a content-type, e incluso a content_type.

            -
            -
            -

            Truco

            -

            También hay clases especiales para hacer más fácil ciertas clases de respuestas:

            -
              -
            • Para JSON, está la clase Symfony\Component\HttpFoundation\JsonResponse. -Ve Creando una respuesta JSON.
              • -
            • Para archivos, está la clase Symfony\Component\HttpFoundation\BinaryFileResponse. -Ve Serving Files.
              • -
            -
            -
            -
            -

            El objeto Petición

            -

            Además de los valores de los marcadores de posición de enrutado, el controlador también tiene acceso al objeto Petición al extender la clase base Controlador:

            -
            $request = $this->getRequest();
-
-$request->isXmlHttpRequest(); // ¿es una petición Ajax?
-
-$request->getPreferredLanguage(array('en', 'fr'));
-
-$request->query->get('page'); // obtiene un parámetro $_GET
-
-$request->request->get('page'); // obtiene un parámetro $_POST
-
            -
            -

            Al igual que el objeto Respuesta, las cabeceras de la petición se almacenan en un objeto HeaderBag y son fácilmente accesibles.

            -
            -
            -

            Consideraciones finales

            -

            Siempre que creas una página, en última instancia, tendrás que escribir algún código que contenga la lógica para esa página. En Symfony, a esto se le llama controlador, y es una función PHP que puede hacer cualquier cosa que necesites a fin de devolver el objeto Respuesta que se entregará al usuario final.

            -

            Para facilitarte la vida, puedes optar por extender la clase base Controller, la cual contiene atajos a métodos para muchas tareas de control comunes. Por ejemplo, puesto que no deseas poner el código HTML en tu controlador, puedes usar el método render() para reproducir y devolver el contenido desde una plantilla.

            -

            En otros capítulos, verás cómo puedes usar el controlador para conservar y recuperar objetos desde una base de datos, procesar formularios presentados, manejar el almacenamiento en caché y mucho más.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/doctrine.html b/book/doctrine.html deleted file mode 100644 index 7826c1b..0000000 --- a/book/doctrine.html +++ /dev/null @@ -1,1310 +0,0 @@ - - - - - - - Bases de datos y Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Bases de datos y Doctrine

            -

            Seamos realistas, una de las tareas más comunes y desafiantes para cualquier aplicación involucra la persistencia y lectura de información hacia y desde una base de datos. Afortunadamente, Symfony viene integrado con Doctrine, una biblioteca, cuyo único objetivo es dotarte de poderosas herramientas para facilitarte eso. En este capítulo, aprenderás la filosofía básica detrás de Doctrine y verás lo fácil que puede ser trabajar con una base de datos.

            -
            -

            Nota

            -

            Doctrine está totalmente desconectado de Symfony y utilizarlo es opcional. -Este capítulo trata acerca del ORM de Doctrine, el cual te permite asociar objetos a una base de datos relacional (tal como MySQL, PostgreSQL o Microsoft SQL). Si prefieres utilizar las consultas de base de datos en bruto, es fácil y se explica en el artículo «Cómo utiliza Doctrine la capa DBAL» del recetario.

            -

            También puedes persistir tus datos en MongoDB utilizando la biblioteca ODM de Doctrine. Para más información, lee la documentación en «DoctrineMongoDBBundle».

            -
            -
            -

            Un sencillo ejemplo: Un producto

            -

            La forma más fácil de entender cómo funciona Doctrine es verlo en acción. -En esta sección, configurarás tu base de datos, crearás un objeto Producto, lo persistirás en la base de datos y lo recuperarás de nuevo.

            -
            -

            El código del ejemplo

            -

            Si quieres seguir el ejemplo de este capítulo, crea el paquete AcmeStoreBundle ejecutando la orden:

            -
            $ php app/console generate:bundle --namespace=Acme/StoreBundle
-
            -
            -
            -
            -

            Configurando la base de datos

            -

            Antes de comenzar realmente, tendrás que configurar tu información de conexión a la base de datos. Por convención, esta información se suele configurar en el archivo -app/config/parameters.yml:

            -
            # app/config/parameters.yml
-parameters:
-    database_driver:    pdo_mysql
-    database_host:      localhost
-    database_name:      proyecto_de_prueba
-    database_user:      nombre_de_usuario
-    database_password:  password
-
-# ...
-
            -
            -
            -

            Nota

            -

            Definir la configuración a través de parameters.yml sólo es una convención. -Los parámetros definidos en este archivo son referidos en el archivo de configuración principal al configurar Doctrine:

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine:
-    dbal:
-        driver:   "%database_driver%"
-        host:     "%database_host%"
-        dbname:   "%database_name%"
-        user:     "%database_user%"
-        password: "%database_password%"
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<doctrine:config>
-    <doctrine:dbal
-        driver="%database_driver%"
-        host="%database_host%"
-        dbname="%database_name%"
-        user="%database_user%"
-        password="%database_password%"
-    >
-</doctrine:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$configuration->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'driver'   => '%database_driver%',
-        'host'     => '%database_host%',
-        'dbname'   => '%database_name%',
-        'user'     => '%database_user%',
-        'password' => '%database_password%',
-    ),
-));
-
              -
              -
              • -
            -
            -

            Al separar la información de la base de datos en un archivo independiente, puedes mantener fácilmente diferentes versiones del archivo en cada servidor. Además, fácilmente puedes almacenar la configuración de la base de datos (o cualquier otra información sensible) fuera de tu proyecto, posiblemente dentro de tu configuración de Apache, por ejemplo. Para más información, consulta Cómo configurar parámetros externos en el contenedor de servicios.

            -
            -

            Ahora que Doctrine conoce tu base de datos, posiblemente tenga que crear la base de datos para ti:

            -
            $ php app/console doctrine:database:create
-
            -
            -
            -

            Configura la base de datos para que sea UTF8

            -

            Una equivocación en la cual caen incluso los desarrolladores más experimentados cuándo empiezan un proyecto Symfony2 es olvidar configurar el código de caracteres y cotejamiento en su base de datos, terminando con cotejamientos de tipo latin, los cuales están predefinidos en la mayoría de las bases de datos. -Incluso podrían recordar hacerlo al principio, pero olvidan que todo esto se hace después de ejecutar una orden relativamente común durante el desarrollo:

            -
            $ php app/console doctrine:database:drop --force
-$ php app/console doctrine:database:create
-
            -
            -

            No hay manera de configurar estos valores predeterminados dentro de Doctrine, ya que trata de ser lo más agnóstica posible en términos de configuración del entorno. Una manera de resolver este problema consiste en configurar el nivel predeterminado del servidor.

            -

            La configuración predefinida UTF8 para MySQL es tan simple como añadir unas cuantas líneas a tu archivo de configuración (generalmente my.cnf):

            -
            [mysqld]
-collation-server = utf8_general_ci
-character-set-server = utf8
-
            -
            -
            -
            -

            Nota

            -

            Si quieres usar SQLite como tu base de datos, debes especificar la ruta a donde se debería almacenar tu archivo de base de datos:

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine:
-    dbal:
-        driver: pdo_sqlite
-        path: "%kernel.root_dir%/sqlite.db"
-        charset: UTF8
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<doctrine:config
-    driver="pdo_sqlite"
-    path="%kernel.root_dir%/sqlite.db"
-    charset="UTF-8"
->
-    <!-- ... -->
-</doctrine:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'driver'  => 'pdo_sqlite',
-        'path'    => '%kernel.root_dir%/sqlite.db',
-        'charset' => 'UTF-8',
-    ),
-));
-
              -
              -
              • -
            -
            -
            -
            -
            -

            Creando una clase Entidad

            -

            Supongamos que estás construyendo una aplicación donde necesitas mostrar tus productos. -Sin siquiera pensar en Doctrine o en una base de datos, ya sabes que necesitas un objeto Producto para representar los productos. Crea esta clase en el directorio Entity de tu paquete AcmeStoreBundle:

            -
            // src/Acme/StoreBundle/Entity/Product.php
-namespace Acme\StoreBundle\Entity;
-
-class Product
-{
-    protected $name;
-
-    protected $price;
-
-    protected $description;
-}
-
            -
            -

            La clase —a menudo llamada «entidad», es decir, una clase básica que contiene datos— es simple y ayuda a cumplir con el requisito del negocio de productos que necesita tu aplicación. Sin embargo, esta clase no se puede guardar en una base de datos —es sólo una clase PHP simple.

            -
            -

            Truco

            -

            Una vez que aprendas los conceptos detrás de Doctrine, puedes dejar que Doctrine cree clases de entidad simples por ti:

            -
            $ php app/console doctrine:generate:entity --entity="AcmeStoreBundle:Product" --fields="name:string(255) price:float description:text"
-
            -
            -
            -
            -
            -

            Agregando información de asignación

            -

            Doctrine te permite trabajar con bases de datos de una manera mucho más interesante que solo recuperar filas de una tabla basada en columnas de un arreglo. En cambio, Doctrine te permite persistir objetos completos a la base de datos y recuperar objetos completos desde la base de datos. Esto funciona asociando una clase PHP a una tabla de la base de datos, y las propiedades de esa clase PHP a las columnas de la tabla:

            -../_images/doctrine_image_1_es.png -

            Para que Doctrine sea capaz de hacer esto, sólo hay que crear «metadatos», o la configuración que le dice a Doctrine exactamente cómo debe asociar la clase Producto y sus propiedades a la base de datos. Estos metadatos se pueden especificar en una serie de diferentes formatos, incluyendo YAML, XML o directamente dentro de la clase Producto a través de anotaciones:

            -
            -
              -
            • Annotations
              // src/Acme/StoreBundle/Entity/Product.php
-namespace Acme\StoreBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-
-/**
- * @ORM\Entity
- * @ORM\Table(name="product")
- */
-class Product
-{
-    /**
-     * @ORM\Id
-     * @ORM\Column(type="integer")
-     * @ORM\GeneratedValue(strategy="AUTO")
-     */
-    protected $id;
-
-    /**
-     * @ORM\Column(type="string", length=100)
-     */
-    protected $name;
-
-    /**
-     * @ORM\Column(type="decimal", scale=2)
-     */
-    protected $price;
-
-    /**
-     * @ORM\Column(type="text")
-     */
-    protected $description;
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml
-Acme\StoreBundle\Entity\Product:
-    type: entity
-    table: product
-    id:
-        id:
-            type: integer
-            generator: { strategy: AUTO }
-    fields:
-        name:
-            type: string
-            length: 100
-        price:
-            type: decimal
-            scale: 2
-        description:
-            type: text
-
              -
              -
              • -
            • XML
              <!-- src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.xml -->
-<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
-      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-      xsi:schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping
-                    http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">
-
-    <entity name="Acme\StoreBundle\Entity\Product" table="product">
-        <id name="id" type="integer" column="id">
-            <generator strategy="AUTO" />
-        </id>
-        <field name="name" column="name" type="string" length="100" />
-        <field name="price" column="price" type="decimal" scale="2" />
-        <field name="description" column="description" type="text" />
-    </entity>
-</doctrine-mapping>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Un paquete sólo puede aceptar un formato para definir metadatos. Por ejemplo, no es posible mezclar metadatos para la clase Entidad definidos en YAML con definidos en anotaciones PHP.

            -
            -
            -

            Truco

            -

            El nombre de la tabla es opcional y si la omites, será determinada automáticamente basándose en el nombre de la clase entidad.

            -
            -

            Doctrine te permite elegir entre una amplia variedad de diferentes tipos de campo, cada uno con sus propias opciones. Para obtener información sobre los tipos de campo disponibles, consulta la sección Referencia de tipos de campo Doctrine.

            -
            -

            Ver también

            -

            También puedes consultar la `Documentación de asociación básica`_ de Doctrine para todos los detalles sobre la información de asignación. Si utilizas anotaciones, tendrás que prefijar todas las anotaciones con ORM\ (por ejemplo, ORM\Column(..)), lo cual no se muestra en la documentación de Doctrine. También tendrás que incluir la declaración use Doctrine\ORM\Mapping as ORM; la cual importa el prefijo ORM de las anotaciones.

            -
            -
            -

            Prudencia

            -

            Ten cuidado de que tu nombre de clase y propiedades no estén asignados a un área protegida por palabras clave de SQL (tal como group o user). Por ejemplo, si el nombre de clase de tu entidad es group, entonces, de manera predeterminada, el nombre de la tabla será group, lo cual provocará un error en algunos motores SQL. Consulta la Documentación de palabras clave reservadas por SQL para que sepas cómo escapar correctamente estos nombres. Alternativamente, si estás en libertad de elegir el esquema de tu base de datos, simplemente asigna un diferente nombre de tabla o columna. Ve las Clases persistentes y la Asignación de propiedades en la documentación de Doctrine.

            -
            -
            -

            Nota

            -

            Cuando utilizas otra biblioteca o programa (es decir, Doxygen) que utiliza anotaciones, debes colocar la anotación @IgnoreAnnotation en la clase para indicar que se deben ignorar las anotaciones Symfony.

            -

            Por ejemplo, para evitar que la anotación @fn lance una excepción, añade lo siguiente:

            -
            /**
- * @IgnoreAnnotation("fn")
- */
-class Product
-// ...
-
            -
            -
            -
            -
            -

            Generando captadores y definidores

            -

            A pesar de que Doctrine ahora sabe cómo persistir en la base de datos un objeto Producto, la clase en sí realmente no es útil todavía. Puesto que Producto es sólo una clase PHP regular, es necesario crear métodos captadores y definidores (por ejemplo, getName(), setName()) para poder acceder a sus propiedades (ya que las propiedades son protegidas). Afortunadamente, Doctrine puede hacer esto por ti con la siguiente orden:

            -
            $ php app/console doctrine:generate:entities Acme/StoreBundle/Entity/Product
-
            -
            -

            Esta orden se asegura de que se generen todos los captadores y definidores para la clase Producto. Esta es una orden segura — la puedes ejecutar una y otra vez: sólo genera captadores y definidores que no existen (es decir, no sustituye métodos existentes).

            -
            -

            Prudencia

            -

            Ten en cuenta que el generador de entidades de Doctrine produce captadores/definidores sencillos. -Debes revisar las entidades generadas y ajustar a tus propias necesidades la lógica de los captadores/definidores.

            -
            -
            -

            Más sobre doctrine:generate:entities

            -

            con la orden doctrine:generate:entities puedes:

            -
            -
              -
            • generar captadores y definidores;
              • -
            • generar clases repositorio configuradas con la anotación @ORM\Entity(repositoryClass="..."),
              • -
            • generar el constructor adecuado para relaciones 1:n y n:m.
              • -
            -
            -

            La orden doctrine:generate:entities guarda una copia de seguridad del Producto.php original llamada Producto.php~. En algunos casos, la presencia de este archivo puede provocar un error «No se puede redeclarar la clase». Lo puedes quitar sin problemas.

            -

            Ten en cuenta que no necesitas usar esta orden. Doctrine no se basa en la generación de código. Al igual que con las clases de PHP normales, sólo tienes que asegurarte de que sus propiedades protegidas/privadas tienen métodos captadores y definidores. -Puesto que cuando utilizas Doctrine es algo que tienes que hacer comúnmente, se creó esta orden.

            -
            -

            También puedes generar todas las entidades conocidas (es decir, cualquier clase PHP con información de asignación Doctrine) de un paquete o un espacio de nombres completo:

            -
            $ php app/console doctrine:generate:entities AcmeStoreBundle
-$ php app/console doctrine:generate:entities Acme
-
            -
            -
            -

            Nota

            -

            A Doctrine no le importa si tus propiedades son protegidas o privadas, o si una propiedad tiene o no una función captadora o definidora. -Aquí, los captadores y definidores se generan sólo porque los necesitarás para interactuar con tu objeto PHP.

            -
            -
            -
            -

            Creando tablas/esquema de la base de datos

            -

            Ahora tienes una clase Producto utilizable con información de asignación de modo que Doctrine sabe exactamente cómo persistirla. Por supuesto, en tu base de datos aún no tienes la tabla producto correspondiente. Afortunadamente, Doctrine puede crear automáticamente todas las tablas de la base de datos necesarias para cada entidad conocida en tu aplicación. Para ello, ejecuta:

            -
            $ php app/console doctrine:schema:update --force
-
            -
            -
            -

            Truco

            -

            En realidad, esta orden es increíblemente poderosa. Esta compara cómo se debe ver tu base de datos (en base a la información de asignación de tus entidades) con la forma en que realmente se ve, y genera las declaraciones SQL necesarias para actualizar la base de datos a su verdadera forma. En otras palabras, si agregas una nueva propiedad asignando metadatos a Producto y ejecutas esta tarea de nuevo, vas a generar la declaración alter table necesaria para añadir la nueva columna a la tabla Producto existente.

            -

            Una forma aún mejor para tomar ventaja de esta funcionalidad es a través de las migraciones, las cuales te permiten generar estas instrucciones SQL y almacenarlas en las clases de la migración, mismas que puedes ejecutar sistemáticamente en tu servidor en producción con el fin de seguir la pista y migrar el esquema de la base de datos segura y fiablemente.

            -
            -

            Tu base de datos ahora cuenta con una tabla producto completamente operativa, con columnas que coinciden con los metadatos que has especificado.

            -
            -
            -

            Persistiendo objetos a la base de datos

            -

            Ahora que tienes asignada una entidad Producto y la tabla Producto correspondiente, estás listo para persistir los datos a la base de datos. Desde el interior de un controlador, esto es bastante fácil. Agrega el siguiente método al DefaultController del paquete:

            -
             1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
-10
-11
-12
-13
-14
-15
-16
-17
-18
-19
            // src/Acme/StoreBundle/Controller/DefaultController.php
-
-// ...
-use Acme\StoreBundle\Entity\Product;
-use Symfony\Component\HttpFoundation\Response;
-
-public function createAction()
-{
-    $product = new Product();
-    $product->setName('A Foo Bar');
-    $product->setPrice('19.99');
-    $product->setDescription('Lorem ipsum dolor');
-
-    $em = $this->getDoctrine()->getManager();
-    $em->persist($product);
-    $em->flush();
-
-    return new Response('Created product id '.$product->getId());
-}
-
            -
            -
            -

            Nota

            -

            Si estás siguiendo este ejemplo, tendrás que crear una ruta que apunte a esta acción para verla trabajar.

            -
            -

            Veamos detenidamente el ejemplo anterior:

            -
              -
            • líneas 9-12 En esta sección, creas una instancia y trabajas con el objeto $product como con cualquier otro objeto PHP normal.
              • -
            • línea 14 Esta línea consigue un objeto gestor de entidades de Doctrine, el cual es responsable de manejar el proceso de persistir y recuperar objetos hacia y desde la base de datos.
              • -
            • línea 15 El método persist() dice a Doctrine que «maneje» el objeto $product. Esto en realidad no provoca una consulta que se deba introducir en la base de datos (todavía).
              • -
            • línea 16 Cuando se llama al método flush(), Doctrine examina todos los objetos que está gestionando para ver si es necesario persistirlos en la base de datos. En este ejemplo, el objeto $product aún no se ha persistido, por lo tanto el gestor de la entidad ejecuta una consulta INSERT y crea una fila en la tabla producto.
              • -
            -
            -

            Nota

            -

            De hecho, ya que Doctrine es consciente de todas tus entidades gestionadas, cuando se llama al método flush(), calcula el conjunto de cambios y ejecuta la(s) consulta(s) más eficiente(s) posible(s). Por ejemplo, si persistes un total de 100 objetos Producto y, posteriormente llamas a flush(), Doctrine creará una sola declaración preparada y la volverá a utilizar en cada inserción. Este patrón se conoce como Unidad de trabajo, y se usa porque es rápido y eficiente.

            -
            -

            Al crear o actualizar objetos, el flujo de trabajo siempre es el mismo. En la siguiente sección, verás cómo Doctrine es lo suficientemente inteligente como para emitir automáticamente una consulta UPDATE si el registro ya existe en la base de datos.

            -
            -

            Truco

            -

            Doctrine proporciona una biblioteca que te permite cargar en tu proyecto mediante programación los datos de prueba (es decir, «datos accesorios»). Para más información, consulta DoctrineFixturesBundle.

            -
            -
            -
            -

            Recuperando objetos desde la base de datos

            -

            Recuperar un objeto desde la base de datos es aún más fácil. Por ejemplo, supongamos que has configurado una ruta para mostrar un Producto específico en función del valor de su id:

            -
            public function showAction($id)
-{
-    $product = $this->getDoctrine()
-        ->getRepository('AcmeStoreBundle:Product')
-        ->find($id);
-
-    if (!$product) {
-        throw $this->createNotFoundException(
-            'No product found for id '.$id
-        );
-    }
-
-    // ... haz algo, como pasar el objeto $product a una plantilla
-}
-
            -
            -
            -

            Truco

            -

            Puedes conseguir el equivalente de este sin escribir ningún código utilizando el método abreviado @ParamConverter. Consulta la documentación del FrameworkExtraBundle para más detalles.

            -
            -

            Al consultar un determinado tipo de objeto, siempre utiliza lo que se conoce como «repositorio». Puedes pensar en un repositorio como una clase PHP, cuyo único trabajo consiste en ayudarte a buscar las entidades de una determinada clase. Puedes acceder al objeto repositorio de una clase entidad a través de:

            -
            $repository = $this->getDoctrine()
-    ->getRepository('AcmeStoreBundle:Product');
-
            -
            -
            -

            Nota

            -

            La cadena AcmeStoreBundle:Product es un método abreviado que puedes utilizar en cualquier lugar de Doctrine en lugar del nombre de clase completo de la entidad (es decir, Acme\StoreBundle\Entity\Product). -Mientras que tu entidad viva bajo el espacio de nombres Entity de tu paquete, esto debe funcionar.

            -
            -

            Una vez que tengas tu repositorio, tienes acceso a todo tipo de útiles métodos:

            -
            // consulta por la clave principal (generalmente 'id')
-$product = $repository->find($id);
-
-// nombres dinámicos de métodos para buscar un valor basad en columna
-$product = $repository->findOneById($id);
-$product = $repository->findOneByName('foo');
-
-// recupera TODOS los productos
-$products = $repository->findAll();
-
-// busca un grupo de productos basándose en el valor de una columna arbitraria
-$products = $repository->findByPrice(19.99);
-
            -
            -
            -

            Nota

            -

            Por supuesto, también puedes realizar consultas complejas, acerca de las cuales aprenderás más en la sección Consultando por objetos.

            -
            -

            También puedes tomar ventaja de los útiles métodos findBy y findOneBy para recuperar objetos fácilmente basándote en varias condiciones:

            -
            // consulta por un producto que coincide en nombre y precio
-$product = $repository->findOneBy(array('name'  => 'foo',
-                                        'price' => 19.99));
-
-// consulta para todos los  productos que emparejen el nombre, ordenados por precio
-$products = $repository->findBy(
-    array('name' => 'foo'),
-    array('price' => 'ASC')
-);
-
            -
            -
            -

            Truco

            -

            Cuando reproduces una página, puedes ver, en la esquina inferior derecha de la barra de herramientas de depuración web, cuántas consultas se realizaron.

            -../_images/doctrine_web_debug_toolbar_es.png -

            Si haces clic en el icono, se abrirá el generador de perfiles, mostrando las consultas exactas que se hicieron.

            -
            -
            -
            -

            Actualizando un objeto

            -

            Una vez que hayas extraído un objeto de Doctrine, actualizarlo es relativamente fácil. Supongamos que tienes una ruta que asigna un identificador de producto a una acción de actualización de un controlador:

            -
            public function updateAction($id)
-{
-    $em = $this->getDoctrine()->getManager();
-    $product = $em->getRepository('AcmeStoreBundle:Product')->find($id);
-
-    if (!$product) {
-        throw $this->createNotFoundException(
-            'No product found for id '.$id
-        );
-    }
-
-    $product->setName('New product name!');
-    $em->flush();
-
-    return $this->redirect($this->generateUrl('homepage'));
-}
-
            -
            -

            La actualización de un objeto únicamente consta de tres pasos:

            -
              -
            1. Recuperar el objeto desde Doctrine;
              2. -
            2. Modificar el objeto;
              3. -
            3. Invocar a flush() en el gestor de la entidad;
              4. -
            -

            Ten en cuenta que no es necesario llamar a $em->persist($product). Recuerda que este método simplemente dice a Doctrine que procese o «vea» el objeto $product. -En este caso, ya que recuperaste el objeto $product desde Doctrine, este ya está gestionado.

            -
            -
            -

            Eliminando un objeto

            -

            Eliminar un objeto es muy similar, pero requiere una llamada al método remove() del gestor de la entidad:

            -
            $em->remove($product);
-$em->flush();
-
            -
            -

            Como es de esperar, el método remove() notifica a Doctrine que deseas eliminar la entidad de la base de datos. La consulta DELETE real, sin embargo, no se ejecuta efectivamente hasta que se invoca al método flush().

            -
            -
            -
            -

            Consultando por objetos

            -

            Ya has visto cómo el objeto repositorio te permite ejecutar consultas básicas sin ningún trabajo:

            -
            $repository->find($id);
-
-$repository->findOneByName('Foo');
-
            -
            -

            Por supuesto, Doctrine también te permite escribir consultas más complejas utilizando el lenguaje de consulta Doctrine (DQL por Doctrine Query Language). DQL es similar a SQL, excepto que debes imaginar que estás consultando por uno o más objetos de una clase entidad (por ejemplo, Producto) en lugar de consultar por filas de una tabla (por ejemplo, producto).

            -

            Al consultar en Doctrine, tienes dos opciones: escribir consultas Doctrine puras o utilizar el generador de consultas de Doctrine.

            -
            -

            Consultando objetos con DQL

            -

            Imagina que deseas consultar los productos, pero sólo quieres devolver aquellos que cuestan más de 19.99, ordenados del más barato al más caro. Desde el interior de un controlador, haz lo siguiente:

            -
            $em = $this->getDoctrine()->getManager();
-$query = $em->createQuery(
-    'SELECT p FROM AcmeStoreBundle:Product p WHERE p.price > :price ORDER BY p.price ASC'
-)->setParameter('price', '19.99');
-
-$products = $query->getResult();
-
            -
            -

            Si te sientes cómodo con SQL, entonces debes sentir a DQL muy natural. La más grande diferencia es que necesitas pensar en términos de «objetos» en lugar de filas de una base de datos. Por esta razón, seleccionas from AcmeStoreBundle:Product y luego lo apodas p.

            -

            El método getResult() devuelve un arreglo de resultados. Si estás preguntando por un solo objeto, en su lugar puedes utilizar el método getSingleResult():

            -
            $product = $query->getSingleResult();
-
            -
            -
            -

            Prudencia

            -

            El método getSingleResult() lanza una excepción Doctrine\ORM\NoResultException si no se devuelven resultados y una Doctrine\ORM\NonUniqueResultException si se devuelve más de un resultado. Si utilizas este método, posiblemente tengas que envolverlo en un bloque try-catch y asegurarte de que sólo devuelve un resultado (si estás consultando sobre algo que sea viable podrías regresar más de un resultado):

            -
            $query = $em->createQuery('SELECT ...')
-    ->setMaxResults(1);
-
-try {
-    $product = $query->getSingleResult();
-} catch (\Doctrine\Orm\NoResultException $e) {
-    $product = null;
-}
-// ...
-
            -
            -
            -

            La sintaxis DQL es increíblemente poderosa, permitiéndote unir entidades fácilmente (el tema de las relaciones se describe más adelante), agrupación, etc. Para más información, consulta la documentación oficial de Doctrine Query Language.

            -
            -

            Configurando parámetros

            -

            Toma nota del método setParameter(). Al trabajar con Doctrine, siempre es buena idea establecer cualquier valor externo como «marcador de posición», tal cómo se hizo en la consulta anterior:

            -
            ... WHERE p.price > :price ...
-
            -
            -

            Entonces, puedes establecer el valor del marcador de posición price llamando al método setParameter():

            -
            ->setParameter('price', '19.99')
-
            -
            -

            Utilizar parámetros en lugar de colocar los valores directamente en la cadena de consulta, se hace para prevenir ataques de inyección SQL y siempre se debe hacer. -Si estás utilizando varios parámetros, puedes establecer simultáneamente sus valores usando el método setParameters():

            -
            ->setParameters(array(
-    'price' => '19.99',
-    'name'  => 'Foo',
-))
-
            -
            -
            -
            -
            -

            Usando el generador de consultas de Doctrine

            -

            En lugar de escribir las consultas directamente, también puedes usar el QueryBuilder de Doctrine para hacer el mismo trabajo con una agradable interfaz orientada a objetos. -Si usas un IDE, también puedes tomar ventaja del autocompletado a medida que escribes los nombres de método. Desde el interior de un controlador:

            -
            $repository = $this->getDoctrine()
-    ->getRepository('AcmeStoreBundle:Product');
-
-$query = $repository->createQueryBuilder('p')
-    ->where('p.price > :price')
-    ->setParameter('price', '19.99')
-    ->orderBy('p.price', 'ASC')
-    ->getQuery();
-
-$products = $query->getResult();
-
            -
            -

            El objeto QueryBuilder contiene todos los métodos necesarios para construir tu consulta. Al invocar al método getQuery(), el generador de consultas devuelve un objeto Query normal, el cual es el mismo objeto que construiste directamente en la sección anterior.

            -

            Para más información sobre el generador de consultas de Doctrine, consulta la documentación del Generador de consultas de Doctrine.

            -
            -
            -

            Repositorio de clases personalizado

            -

            En las secciones anteriores, comenzamos a construir y utilizar consultas más complejas desde el interior de un controlador. Con el fin de aislar, probar y volver a usar estas consultas, es buena idea crear una clase repositorio personalizada para tu entidad y agregar métodos con tu lógica de consulta allí.

            -

            Para ello, agrega el nombre de la clase del repositorio a la definición de asignación.

            -
            -
              -
            • Annotations
              // src/Acme/StoreBundle/Entity/Product.php
-namespace Acme\StoreBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-
-/**
- * @ORM\Entity(repositoryClass="Acme\StoreBundle\Entity\ProductRepository")
- */
-class Product
-{
-    //...
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml
-Acme\StoreBundle\Entity\Product:
-    type: entity
-    repositoryClass: Acme\StoreBundle\Entity\ProductRepository
-    # ...
-
              -
              -
              • -
            • XML
              <!-- src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.xml -->
-
-<!-- ... -->
-<doctrine-mapping>
-
-    <entity name="Acme\StoreBundle\Entity\Product"
-            repository-class="Acme\StoreBundle\Entity\ProductRepository">
-            <!-- ... -->
-    </entity>
-</doctrine-mapping>
-
              -
              -
              • -
            -
            -

            Doctrine puede generar la clase repositorio por ti ejecutando la misma orden usada anteriormente para generar los métodos captadores y definidores omitidos:

            -
            $ php app/console doctrine:generate:entities Acme
-
            -
            -

            A continuación, agrega un nuevo método — findAllOrderedByName() — a la clase repositorio recién generada. Este método debe consultar todas las entidades Producto, ordenadas alfabéticamente.

            -
            // src/Acme/StoreBundle/Entity/ProductRepository.php
-namespace Acme\StoreBundle\Entity;
-
-use Doctrine\ORM\EntityRepository;
-
-class ProductRepository extends EntityRepository
-{
-    public function findAllOrderedByName()
-    {
-        return $this->getEntityManager()
-            ->createQuery('SELECT p FROM AcmeStoreBundle:Product p ORDER BY p.name ASC')
-            ->getResult();
-    }
-}
-
            -
            -
            -

            Truco

            -

            Puedes acceder al gestor de la entidad a través de $this->getEntityManager() desde el interior del repositorio.

            -
            -

            Puedes utilizar este nuevo método al igual que los métodos de búsqueda predefinidos del repositorio:

            -
            $em = $this->getDoctrine()->getManager();
-$products = $em->getRepository('AcmeStoreBundle:Product')
-               ->findAllOrderedByName();
-
            -
            -
            -

            Nota

            -

            Al utilizar una clase repositorio personalizada, todavía tienes acceso a los métodos de búsqueda predeterminados como find() y findAll().

            -
            -
            -
            -
            -

            Entidad relaciones/asociaciones

            -

            Supón que los productos en tu aplicación pertenecen exactamente a una «categoría». -En este caso, necesitarás un objeto Categoría y una manera de relacionar un objeto Producto a un objeto Categoría. Empieza por crear la entidad Categoría. -Ya sabes que tarde o temprano tendrás que persistir la clase a través de Doctrine, puedes dejar que Doctrine cree la clase por ti.

            -
            $ php app/console doctrine:generate:entity --entity="AcmeStoreBundle:Category" --fields="name:string(255)"
-
            -
            -

            Esta tarea genera la entidad Categoría para ti, con un campo id, un campo name y las funciones captadoras y definidoras asociadas.

            -
            -

            Relación con la asignación de metadatos

            -

            Para relacionar las entidades Categoría y Producto, empieza por crear una propiedad productos en la clase Categoría:

            -
            -
              -
            • Annotations
              // src/Acme/StoreBundle/Entity/Category.php
-
-// ...
-use Doctrine\Common\Collections\ArrayCollection;
-
-class Category
-{
-    // ...
-
-    /**
-     * @ORM\OneToMany(targetEntity="Product", mappedBy="category")
-     */
-    protected $products;
-
-    public function __construct()
-    {
-        $this->products = new ArrayCollection();
-    }
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/StoreBundle/Resources/config/doctrine/Category.orm.yml
-Acme\StoreBundle\Entity\Category:
-    type: entity
-    # ...
-    oneToMany:
-        products:
-            targetEntity: Product
-            mappedBy: category
-    # no olvides iniciar la colección en el método __construct() de la entidad
-
              -
              -
              • -
            • XML
              <!-- src/Acme/StoreBundle/Resources/config/doctrine/Category.orm.xml -->
-<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping
-                    http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">
-
-    <entity name="Acme\StoreBundle\Entity\Category">
-        <!-- ... -->
-        <one-to-many field="products"
-            target-entity="product"
-            mapped-by="category"
-        />
-
-        <!-- no olvides iniciar la colección en el método __construct() de la entidad -->
-    </entity>
-</doctrine-mapping>
-
              -
              -
              • -
            -
            -

            En primer lugar, ya que un objeto Categoría debe relacionar muchos objetos Producto, agregamos una propiedad Productos para contener esos objetos Producto. -Una vez más, esto no se hace porque lo necesite Doctrine, sino porque tiene sentido en la aplicación para que cada Categoría mantenga una gran variedad de objetos Producto.

            -
            -

            Nota

            -

            El código del método __construct() es importante porque Doctrine requiere que la propiedad $products sea un objeto ArrayCollection. -Este objeto se ve y actúa casi exactamente como un arreglo, pero tiene cierta flexibilidad. Si esto te hace sentir incómodo, no te preocupes. Sólo imagina que es un arreglo y estarás bien.

            -
            -
            -

            Truco

            -

            El valor de targetEntity en el decorador utilizado anteriormente puede hacer referencia a cualquier entidad con un espacio de nombres válido, no sólo a las entidades definidas en la misma clase. Para relacionarlo con una entidad definida en una clase o paquete diferente, escribe un espacio de nombres completo como la targetEntity.

            -
            -

            Después, ya que cada clase Producto se puede relacionar exactamente a un objeto Categoría, podrías desear agregar una propiedad $category a la clase Producto:

            -
            -
              -
            • Annotations
              // src/Acme/StoreBundle/Entity/Product.php
-
-// ...
-class Product
-{
-    // ...
-
-    /**
-     * @ORM\ManyToOne(targetEntity="Category", inversedBy="products")
-     * @ORM\JoinColumn(name="category_id", referencedColumnName="id")
-     */
-    protected $category;
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml
-Acme\StoreBundle\Entity\Product:
-    type: entity
-    # ...
-    manyToOne:
-        category:
-            targetEntity: Category
-            inversedBy: products
-            joinColumn:
-                name: category_id
-                referencedColumnName: id
-
              -
              -
              • -
            • XML
              <!-- src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.xml -->
-<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping
-                    http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">
-
-    <entity name="Acme\StoreBundle\Entity\Product">
-        <!-- ... -->
-        <many-to-one field="category"
-            target-entity="products"
-            join-column="category"
-        >
-            <join-column
-                name="category_id"
-                referenced-column-name="id"
-            />
-        </many-to-one>
-    </entity>
-</doctrine-mapping>
-
              -
              -
              • -
            -
            -

            Por último, ahora que agregaste una nueva propiedad a ambas clases Categoría y Producto, le dices a Doctrine que genere por ti los métodos captadores y definidores omitidos:

            -
            $ php app/console doctrine:generate:entities Acme
-
            -
            -

            No hagas caso de los metadatos de Doctrine por un momento. Ahora tienes dos clases —Categoría y Producto— con una relación natural de uno a muchos. La clase Categoría tiene un arreglo de objetos Producto y el objeto producto puede contener un objeto Categoría. En otras palabras, construiste tus clases de una manera que tiene sentido para tus necesidades. El hecho de que los datos se tienen que persistir en una base de datos, siempre es secundario.

            -

            Ahora, veamos los metadatos sobre la propiedad $category en la clase Producto. Esta información le dice a Doctrine que la clase está relacionada con Categoría y que debe guardar el id del registro de la categoría en un campo category_id que vive en la tabla producto. En otras palabras, el objeto Categoría relacionado se almacenará en la propiedad $category, pero tras bambalinas, Doctrine deberá persistir esta relación almacenando el valor del id de la categoría en una columna category_id de la tabla producto.

            -../_images/doctrine_image_2_es.png -

            Los metadatos sobre la propiedad $products del objeto Categoría son menos importantes, y simplemente dicen a Doctrine que vea la propiedad Product.category para resolver cómo se asigna la relación.

            -

            Antes de continuar, asegúrate de decirle a Doctrine que agregue la nueva tabla categoría, la columna product.category_id y la nueva clave externa:

            -
            $ php app/console doctrine:schema:update --force
-
            -
            -
            -

            Nota

            -

            Esta tarea sólo la deberías utilizar durante el desarrollo. Para un más robusto método de actualización sistemática de tu base de datos en producción, lee sobre las Migraciones de Doctrine.

            -
            -
            -
            -

            Guardando entidades relacionadas

            -

            Ahora, ¡puedes ver este nuevo código en acción! Imagina que estás dentro de un controlador:

            -
            // ...
-
-use Acme\StoreBundle\Entity\Category;
-use Acme\StoreBundle\Entity\Product;
-use Symfony\Component\HttpFoundation\Response;
-
-class DefaultController extends Controller
-{
-    public function createProductAction()
-    {
-        $category = new Category();
-        $category->setName('Main Products');
-
-        $product = new Product();
-        $product->setName('Foo');
-        $product->setPrice(19.99);
-        // relaciona este producto a la categoría
-        $product->setCategory($category);
-
-        $em = $this->getDoctrine()->getManager();
-        $em->persist($category);
-        $em->persist($product);
-        $em->flush();
-
-        return new Response(
-            'Created product id: '.$product->getId().' and category id: '.$category->getId()
-        );
-    }
-}
-
            -
            -

            Ahora, se agrega una sola fila a las tablas categoría y producto. -La columna product.category_id para el nuevo producto se ajusta a algún id de la nueva categoría. Doctrine gestiona la persistencia de esta relación para ti.

            -
            -
            -

            Recuperando objetos relacionados

            -

            Cuando necesites recuperar objetos asociados, tu flujo de trabajo se ve justo como lo hacías antes. En primer lugar, buscas un objeto $product y luego accedes a su Categoría asociada:

            -
            public function showAction($id)
-{
-    $product = $this->getDoctrine()
-        ->getRepository('AcmeStoreBundle:Product')
-        ->find($id);
-
-    $categoryName = $product->getCategory()->getName();
-
-    // ...
-}
-
            -
            -

            En este ejemplo, primero consultas por un objeto Producto basándote en el id del producto. Este emite una consulta solo para los datos del producto e hidrata al objeto $product con esos datos. Más tarde, cuando llames a $product->getCategory()->getName(), Doctrine silenciosamente hace una segunda consulta para encontrar la Categoría que está relacionada con este Producto. Entonces, prepara el objeto $category y te lo devuelve.

            -../_images/doctrine_image_3_es.png -

            Lo importante es el hecho de que tienes fácil acceso a la categoría relacionada con el producto, pero, los datos de la categoría realmente no se recuperan hasta que pides la categoría (es decir, trata de «cargarlos de manera diferida»).

            -

            También puedes consultar en la dirección contraria:

            -
            public function showProductAction($id)
-{
-    $category = $this->getDoctrine()
-        ->getRepository('AcmeStoreBundle:Category')
-        ->find($id);
-
-    $products = $category->getProducts();
-
-    // ...
-}
-
            -
            -

            En este caso, ocurre lo mismo: primero consultas por un único objeto Categoría, y luego Doctrine hace una segunda consulta para recuperar los objetos Producto relacionados, pero sólo una vez/si le preguntas por ellos (es decir, cuando invoques a ->getProducts()). -La variable $products es un arreglo de todos los objetos Producto relacionados con el objeto Categoría propuesto a través de sus valores category_id.

            -
            -

            Relaciones y clases delegadas

            -

            Esta «carga diferida» es posible porque, cuando sea necesario, Doctrine devuelve un objeto «delegado» en lugar del verdadero objeto. Veamos de nuevo el ejemplo anterior:

            -
            $product = $this->getDoctrine()
-    ->getRepository('AcmeStoreBundle:Product')
-    ->find($id);
-
-$category = $product->getCategory();
-
-// imprime 'Proxies\AcmeStoreBundleEntityCategoryProxy'
-echo get_class($category);
-
            -
            -

            Este objeto delegado extiende al verdadero objeto Categoría, y se ve y actúa exactamente igual que él. La diferencia es que, al usar un objeto delegado, Doctrine puede retrasar la consulta de los datos reales de Categoría hasta que efectivamente se necesiten esos datos (por ejemplo, hasta que invoques a $category->getName()).

            -

            Las clases delegadas las genera Doctrine y se almacenan en el directorio cache. -Y aunque probablemente nunca te des cuenta de que tu objeto $category en realidad es un objeto delegado, es importante tenerlo en cuenta.

            -

            En la siguiente sección, al recuperar simultáneamente los datos del producto y la categoría (a través de una unión), Doctrine devolverá el verdadero objeto Categoría, puesto que nada se tiene que cargar de forma diferida.

            -
            -
            -
            -

            Uniendo registros relacionados

            -

            En los ejemplos anteriores, se realizaron dos consultas —una para el objeto original (por ejemplo, una Categoría)— y otra para el/los objetos relacionados (por ejemplo, los objetos Producto).

            -
            -

            Truco

            -

            Recuerda que puedes ver todas las consultas realizadas durante una petición a través de la barra de herramientas de depuración web.

            -
            -

            Por supuesto, si sabes por adelantado que necesitas tener acceso a los objetos, puedes evitar la segunda consulta emitiendo una unión en la consulta original. Agrega el siguiente método a la clase ProductRepository:

            -
            // src/Acme/StoreBundle/Entity/ProductRepository.php
-public function findOneByIdJoinedToCategory($id)
-{
-    $query = $this->getEntityManager()
-        ->createQuery('
-            SELECT p, c FROM AcmeStoreBundle:Product p
-            JOIN p.category c
-            WHERE p.id = :id'
-        )->setParameter('id', $id);
-
-    try {
-        return $query->getSingleResult();
-    } catch (\Doctrine\ORM\NoResultException $e) {
-        return null;
-    }
-}
-
            -
            -

            Ahora, puedes utilizar este método en el controlador para consultar un objeto Producto y su correspondiente Categoría con una sola consulta:

            -
            public function showAction($id)
-{
-    $product = $this->getDoctrine()
-        ->getRepository('AcmeStoreBundle:Product')
-        ->findOneByIdJoinedToCategory($id);
-
-    $category = $product->getCategory();
-
-    // ...
-}
-
            -
            -
            -
            -

            Más información sobre asociaciones

            -

            Esta sección ha sido una introducción a un tipo común de relación entre entidades, la relación uno a muchos. Para obtener detalles más avanzados y ejemplos de cómo utilizar otros tipos de relaciones (por ejemplo, uno a uno, muchos a muchos), consulta la sección Asignando asociaciones en la documentación de Doctrine.

            -
            -

            Nota

            -

            Si estás utilizando anotaciones, tendrás que prefijar todas las anotaciones con ORM\ (por ejemplo, ORM\OneToMany), lo cual no se refleja en la documentación de Doctrine. También tendrás que incluir la declaración use Doctrine\ORM\Mapping as ORM; la cual importa el prefijo ORM de las anotaciones.

            -
            -
            -
            -
            -

            Configurando

            -

            Doctrine es altamente configurable, aunque probablemente nunca tendrás que preocuparte de la mayor parte de sus opciones. Para más información sobre la configuración de Doctrine, consulta la sección Doctrine del Manual de referencia.

            -
            -
            -

            Ciclo de vida de las retrollamadas

            -

            A veces, es necesario realizar una acción justo antes o después de insertar, actualizar o eliminar una entidad. Este tipo de acciones se conoce como «ciclo de vida» de las retrollamadas, ya que son métodos retrollamados que necesitas ejecutar durante las diferentes etapas del ciclo de vida de una entidad (por ejemplo, cuando la entidad es insertada, actualizada, eliminada, etc.)

            -

            Si estás utilizando anotaciones para los metadatos, empieza por permitir el ciclo de vida de las retrollamadas. Esto no es necesario si estás usando YAML o XML para tu asignación:

            -
            /**
- * @ORM\Entity()
- * @ORM\HasLifecycleCallbacks()
- */
-class Product
-{
-    // ...
-}
-
            -
            -

            Ahora, puedes decir a Doctrine que ejecute un método en cualquiera de los eventos del ciclo de vida disponibles. Por ejemplo, supongamos que deseas establecer una columna de fecha created a la fecha actual, sólo cuando se persiste por primera vez la entidad (es decir, se inserta):

            -
            -
              -
            • Annotations
              /**
- * @ORM\PrePersist
- */
-public function setCreatedValue()
-{
-    $this->created = new \DateTime();
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.yml
-Acme\StoreBundle\Entity\Product:
-    type: entity
-    # ...
-    lifecycleCallbacks:
-        prePersist: [setCreatedValue]
-
              -
              -
              • -
            • XML
              <!-- src/Acme/StoreBundle/Resources/config/doctrine/Product.orm.xml -->
-
-<!-- ... -->
-<doctrine-mapping>
-
-    <entity name="Acme\StoreBundle\Entity\Product">
-            <!-- ... -->
-            <lifecycle-callbacks>
-                <lifecycle-callback type="prePersist" method="setCreatedValue" />
-            </lifecycle-callbacks>
-    </entity>
-</doctrine-mapping>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            En el ejemplo anterior se supone que has creado y asignado una propiedad created (no mostrada aquí).

            -
            -

            Ahora, justo antes de persistir la primer entidad, Doctrine automáticamente llamará a este método y establecerá el campo created a la fecha actual.

            -

            Esto se puede repetir en cualquiera de los otros eventos del ciclo de vida, los cuales incluyen a:

            -
              -
            • preRemove
              • -
            • postRemove
              • -
            • prePersist
              • -
            • postPersist
              • -
            • preUpdate
              • -
            • postUpdate
              • -
            • postLoad
              • -
            • loadClassMetadata
              • -
            -

            Para más información sobre qué significan estos eventos y el ciclo de vida de las retrollamadas en general, consulta la sección Ciclo de vida de los eventos en la documentación de Doctrine.

            -
            -

            Ciclo de vida de retrollamada y escuchas de eventos

            -

            Observa que el método setCreatedValue() no recibe argumentos. Este siempre es el caso para el ciclo de vida de las retrollamadas y es intencional: el ciclo de vida de las retrollamadas debe ser un método sencillo que se ocupe de transformar los datos internos de la entidad (por ejemplo, estableciendo un campo a creado/actualizado, generando un valor ficticio).

            -

            Si necesitas hacer alguna tarea más pesada —como llevar la bitácora de eventos o enviar un correo electrónico— debes registrar una clase externa como un escucha o suscriptor de eventos y darle acceso a todos los recursos que necesites. Para más información, consulta Cómo registrar escuchas y suscriptores de eventos.

            -
            -
            -
            -

            Extensiones Doctrine: Timestampable, Sluggable, etc.

            -

            Doctrine es bastante flexible, y dispone de una serie de extensiones de terceros que te permiten realizar fácilmente tareas repetitivas y comunes en tus entidades. -Estas incluyen cosas tales como Sluggable, Timestampable, Loggable, Translatable y Tree.

            -

            Para más información sobre cómo encontrar y utilizar estas extensiones, ve el artículo sobre el uso de extensiones comunes de Doctrine.

            -
            -
            -

            Referencia de tipos de campo Doctrine

            -

            Doctrine dispone de una gran cantidad de tipos de campo. Cada uno de estos asigna un tipo de dato PHP a un tipo de columna específica en cualquier base de datos que estés utilizando. Los siguientes tipos son compatibles con Doctrine:

            -
              -
            • Cadenas
                -
              • string (usado para cadenas cortas)
                • -
              • text (usado para cadenas grandes)
                • -
              -
              • -
            • Números
                -
              • integer
                • -
              • smallint
                • -
              • bigint
                • -
              • decimal
                • -
              • float
                • -
              -
              • -
            • Fechas y horas (usa un objeto DateTime para estos campos en PHP)
                -
              • date
                • -
              • time
                • -
              • datetime
                • -
              -
              • -
            • Otros tipos
                -
              • boolean
                • -
              • object (serializado y almacenado en un campo CLOB)
                • -
              • array (serializado y almacenado en un campo CLOB)
                • -
              -
              • -
            -

            Para más información, consulta la sección Asignando tipos en la documentación de Doctrine.

            -
            -

            Opciones de campo

            -

            Cada campo puede tener un conjunto de opciones aplicables. Las opciones disponibles incluyen type (el predeterminado es string), name, length, unique y nullable. Aquí tienes algunos ejemplos:

            -
            -
              -
            • Annotations
              /**
- * Un campo cadena con una longitud de 255 caracteres que no puede ser nulo
- * (reflejando los valores predefinidos para 'type', 'length'
- * y opciones *nullable*)
- *
- * @ORM\Column()
- */
-protected $name;
-
-/**
- * Un campo cadena de 150 caracteres de longitud que se persiste a una columna «email_address» y tiene un índice único.
- *
- * @ORM\Column(name="email_address", unique=true, length=150)
- */
-protected $email;
-
              -
              -
              • -
            • YAML
              fields:
-    # Un campo cadena de longitud 255 que no puede ser null
-    # (reflejando los valores predefinidos para las opciones 'length' y 'nullable')
-    # el atributo type es necesario en las definiciones yaml
-    name:
-        type: string
-
-    # Un campo cadena de longitud 150 que persiste a una columna 'email_address'
-    # y tiene un índice único.
-    email:
-        type: string
-        column: email_address
-        length: 150
-        unique: true
-
              -
              -
              • -
            • XML
              # Un campo de tipo «string» de longitud 255 que no puede ser nulo
-    # (reflejando los valores predefinidos para las opciones «length» y «nullable»)
-    # el atributo «type» es necesario en las definiciones yaml
-    name:
-<field name="name" type="string" />
-<field name="email"
-    type="string"
-    column="email_address"
-    length="150"
-    unique="true"
-/>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Hay algunas opciones más que no figuran en esta lista. Para más detalles, consulta la sección Asignando propiedades de la documentación de Doctrine.

            -
            -
            -
            -
            -

            Ordenes de consola

            -

            La integración del ORM de Doctrine2 ofrece varias ordenes de consola bajo el espacio de nombres doctrine. Para ver la lista de ordenes puedes ejecutar la consola sin ningún tipo de argumento:

            -
            $ php app/console
-
            -
            -

            Mostrará una lista con las ordenes disponibles, muchas de las cuales comienzan con el prefijo doctrine:. Puedes encontrar más información sobre cualquiera de estas ordenes (o cualquier orden de Symfony) ejecutando la orden help. Por ejemplo, para obtener detalles acerca de la tarea doctrine:database:create, ejecuta:

            -
            $ php app/console help doctrine:database:create
-
            -
            -

            Algunas tareas notables o interesantes son:

            -
              -

            • doctrine:ensure-production-settings — comprueba si el entorno actual está configurado de manera eficiente para producción. Esta siempre se debe ejecutar en el entorno prod:

              -
              $ php app/console doctrine:ensure-production-settings --env=prod
-
              -
              -
              • -

            • doctrine:mapping:import — permite a Doctrine llevar a cabo una introspección a una base de datos existente y crear información de asignación. Para más información, consulta Cómo generar entidades desde una base de datos existente.

              -
              • -

            • doctrine:mapping:info — te dice todas las entidades de las que Doctrine es consciente y si hay algún error básico con la asignación.

              -
              • -

            • doctrine:query:dql y doctrine:query:sql — te permiten ejecutar consultas DQL o SQL directamente desde la línea de ordenes.

              -
              • -
            -
            -

            Nota

            -

            Para poder cargar accesorios a tu base de datos, en su lugar, necesitas tener instalado el paquete DoctrineFixturesBundle. Para aprender cómo hacerlo, lee el artículo «DoctrineFixturesBundle» en la documentación.

            -
            -
            -

            Truco

            -

            Esta página muestra cómo trabajar con Doctrine dentro de un controlador. Posiblemente también quieras trabajar con Doctrine en algún otro lugar en tu aplicación. El método getDoctrine() del controlador regresa el servicio doctrine, puedes trabajar con este de la misma manera que en cualquier otro lugar inyectándolo en tus propios servicios. Consulta Contenedor de servicios para más sobre la creación de tus propios servicios.

            -
            -
            -
            -

            Resumen

            -

            Con Doctrine, puedes centrarte en tus objetos y la forma en que son útiles en tu aplicación y luego preocuparte por su persistencia en la base de datos. Esto se debe a que Doctrine te permite utilizar cualquier objeto PHP para almacenar los datos y se basa en la información de asignación de metadatos para asignar los datos de un objeto a una tabla particular de la base de datos.

            -

            Y aunque Doctrine gira en torno a un concepto simple, es increíblemente poderoso, permitiéndote crear consultas complejas y suscribirte a los eventos que te permiten realizar diferentes acciones conforme los objetos recorren su ciclo de vida en la persistencia.

            -

            Para más información acerca de Doctrine, ve la sección Doctrine del Recetario, que incluye los siguientes artículos:

            - -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/forms.html b/book/forms.html deleted file mode 100644 index 3222c21..0000000 --- a/book/forms.html +++ /dev/null @@ -1,1347 +0,0 @@ - - - - - - - Formularios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Formularios

            -

            Utilizar formularios HTML es una de las más comunes —y desafiantes— tareas para un desarrollador web. Symfony2 integra un componente Form que se ocupa de facilitarnos la utilización de formularios. En este capítulo, construirás un formulario complejo desde el principio, del cual, de paso, aprenderás las características más importantes de la biblioteca de formularios.

            -
            -

            Nota

            -

            El componente Form de Symfony es una biblioteca independiente que puedes utilizar fuera de los proyectos Symfony2. Para más información, consulta el Componente Form de Symfony2 en Github.

            -
            -
            -

            Creando un formulario sencillo

            -

            Supón que estás construyendo una sencilla aplicación de tareas pendientes que necesita mostrar tus «pendientes». Debido a que tus usuarios tendrán que editar y crear tareas, tienes que crear un formulario. Pero antes de empezar, vamos a concentrarnos en la clase genérica Task que representa y almacena los datos para una sola tarea:

            -
            // src/Acme/TaskBundle/Entity/Task.php
-namespace Acme\TaskBundle\Entity;
-
-class Task
-{
-    protected $task;
-
-    protected $dueDate;
-
-    public function getTask()
-    {
-        return $this->task;
-    }
-    public function setTask($task)
-    {
-        $this->task = $task;
-    }
-
-    public function getDueDate()
-    {
-        return $this->dueDate;
-    }
-    public function setDueDate(\DateTime $dueDate = null)
-    {
-        $this->dueDate = $dueDate;
-    }
-}
-
            -
            -
            -

            Nota

            -

            Si estás codificando este ejemplo, primero crea el paquete AcmeTaskBundle ejecutando la siguiente orden (aceptando todas las opciones predeterminadas):

            -
            $ php app/console generate:bundle --namespace=Acme/TaskBundle
-
            -
            -
            -

            Esta clase es un «antiguo objeto PHP sencillo», ya que, hasta ahora, no tiene nada que ver con Symfony o cualquier otra biblioteca. Es simplemente un objeto PHP normal que directamente resuelve un problema dentro de tu aplicación (es decir, la necesidad de representar una tarea pendiente en tu aplicación). Por supuesto, al final de este capítulo, serás capaz de enviar datos a una instancia de Task (a través de un formulario), validar sus datos, y persistirla en una base de datos.

            -
            -

            Construyendo el formulario

            -

            Ahora que has creado una clase Task, el siguiente paso es crear y reproducir el formulario HTML real. En Symfony2, esto se hace construyendo un objeto Form y luego pintándolo en una plantilla. Por ahora, esto se puede hacer en el interior de un controlador:

            -
            // src/Acme/TaskBundle/Controller/DefaultController.php
-namespace Acme\TaskBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Acme\TaskBundle\Entity\Task;
-use Symfony\Component\HttpFoundation\Request;
-
-class DefaultController extends Controller
-{
-    public function newAction(Request $request)
-    {
-        // crea una task y le asigna algunos datos ficticios para este ejemplo
-        $task = new Task();
-        $task->setTask('Write a blog post');
-        $task->setDueDate(new \DateTime('tomorrow'));
-
-        $form = $this->createFormBuilder($task)
-            ->add('task', 'text')
-            ->add('dueDate', 'date')
-            ->getForm();
-
-        return $this->render('AcmeTaskBundle:Default:new.html.twig', array(
-            'form' => $form->createView(),
-        ));
-    }
-}
-
            -
            -
            -

            Truco

            -

            Este ejemplo muestra cómo crear el formulario directamente en el controlador. -Más adelante, en la sección «Creando clases Form», aprenderás cómo construir tu formulario en una clase independiente, lo cual es muy recomendable puesto que vuelve reutilizable tu formulario.

            -
            -

            La creación de un formulario requiere poco código relativamente, porque los objetos form de Symfony2 se construyen con un «generador de formularios». El propósito del generador de formularios es permitirte escribir sencillas «recetas» de formulario, y hacer todo el trabajo pesado de la contrucción de un formulario.

            -

            En este ejemplo, añadiste dos campos al formulario —task y dueDate— que corresponden a las propiedades task y dueDate de la clase Task. -También asignaste a cada uno un «tipo» (por ejemplo, text, date), el cual entre otras cosas, determina qué etiqueta de formulario HTML se dibuja para ese campo.

            -

            Symfony2 viene con muchos tipos integrados que explicaremos en breve (consulta Tipos de campo integrados).

            -
            -
            -

            Reproduciendo el formulario

            -

            Ahora que creaste el formulario, el siguiente paso es dibujarlo. Lo puedes hacer pasando un objeto view especial para formularios a tu plantilla (ten en cuenta la declaración $form->createView() en el controlador de arriba) y usando un conjunto de funciones ayudantes de formulario:

            -
            -
              -
            • Twig
              {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #}
-<form action="{{ path('task_new') }}" method="post" {{ form_enctype(form) }}>
-    {{ form_widget(form) }}
-
-    <input type="submit" />
-</form>
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/TaskBundle/Resources/views/Default/new.html.php -->
-<form action="<?php echo $view['router']->generate('task_new') ?>" method="post" <?php echo $view['form']->enctype($form) ?> >
-    <?php echo $view['form']->widget($form) ?>
-
-    <input type="submit" />
-</form>
-
              -
              -
              • -
            -
            -../_images/form-simple.png -
            -

            Nota

            -

            Este ejemplo asume que has creado una ruta llamada task_new que apunta al controlador AcmeTaskBundle:Default:new creado anteriormente.

            -
            -

            ¡Eso es todo! Al imprimir form_widget(form), se pinta cada campo en el formulario, junto con la etiqueta y un mensaje de error (si lo hay). Tan fácil como esto, aunque no es muy flexible (todavía). Por lo general, querrás reproducir individualmente cada campo del formulario para que puedas controlar la apariencia del formulario. Aprenderás cómo hacerlo en la sección «Reproduciendo un formulario en una plantilla».

            -

            Antes de continuar, observa cómo el campo de entrada task reproducido tiene el valor de la propiedad task del objeto $task (es decir, «Escribe una entrada del blog»). -El primer trabajo de un formulario es: tomar datos de un objeto y traducirlos a un formato idóneo para reproducirlos en un formulario HTML.

            -
            -

            Truco

            -

            El sistema de formularios es lo suficientemente inteligente como para acceder al valor de la propiedad protegida task a través de los métodos getTask() y setTask() de la clase Task. A menos que una propiedad sea pública, debe tener métodos «captadores» y «definidores» para que el componente Form pueda obtener y fijar datos en la propiedad. Para una propiedad booleana, puedes utilizar un método «isser» (por «es servicio», por ejemplo, isPublished()) en lugar de un captador (por ejemplo, getPublished() o getReminder()).

            -

            -Nuevo en la versión 2.1: La compatibilidad para los métodos «hasser» se añadió en Symfony 2.1.

            -
            -
            -
            -

            Procesando el envío del formulario

            -

            El segundo trabajo de un formulario es traducir los datos enviados por el usuario a las propiedades de un objeto. Para lograrlo, los datos presentados por el usuario deben estar vinculados al formulario. Añade la siguiente funcionalidad a tu controlador:

            -
            // ...
-use Symfony\Component\HttpFoundation\Request;
-
-public function newAction(Request $request)
-{
-    // sólo configura un objeto $task fresco (remueve los datos de prueba)
-    $task = new Task();
-
-    $form = $this->createFormBuilder($task)
-        ->add('task', 'text')
-        ->add('dueDate', 'date')
-        ->getForm();
-
-    if ($request->isMethod('POST')) {
-        $form->bind($request);
-
-        if ($form->isValid()) {
-            // realiza alguna acción, tal como guardar la tarea en la base de datos
-
-            return $this->redirect($this->generateUrl('task_success'));
-        }
-    }
-
-    // ...
-}
-
            -
            -

            -Nuevo en la versión 2.1: El método bind se hizo más flexible en Symfony 2.1. Ahora acepta datos del cliente sin procesar (como antes) o un objeto Petición de Symfony. Este es preferible al método depreciado bindRequest.

            -

            Ahora, cuando se presente el formulario, el controlador vincula al formulario los datos presentados, los cuales se traducen en los nuevos datos de las propiedades task y dueDate del objeto $task. Esto sucede a través del método bind().

            -
            -

            Nota

            -

            Tan pronto como se llame a bind(), los datos presentados se transfieren inmediatamente al objeto subyacente. Esto ocurre independientemente de si los datos subyacentes son válidos realmente o no.

            -
            -

            Este controlador sigue un patrón común para el manejo de formularios, y tiene tres posibles rutas:

            -
              -
            1. Inicialmente, cuando se carga el formulario en un navegador, el método de la petición es GET, lo cual significa simplemente que se debe crear y reproducir el formulario;
              2. -
            2. Cuando el usuario envía el formulario (es decir, el método es POST), pero los datos presentados no son válidos (la validación se trata en la siguiente sección), el formulario es vinculado y, a continuación reproducido, esta vez mostrando todos los errores de validación;
              3. -
            3. Cuando el usuario envía el formulario con datos válidos, el formulario es vinculado y en ese momento tienes la oportunidad de realizar algunas acciones usando el objeto $task (por ejemplo, persistirlo a la base de datos) antes de redirigir al usuario a otra página (por ejemplo, una página de «agradecimiento» o «éxito»).
              4. -
            -
            -

            Nota

            -

            Redirigir a un usuario después de un exitoso envío de formulario evita que el usuario pueda hacer clic en «actualizar» y volver a enviar los datos.

            -
            -
            -
            -
            -

            Validando formularios

            -

            En la sección anterior, aprendiste cómo se puede presentar un formulario con datos válidos o no válidos. En Symfony2, la validación se aplica al objeto subyacente (por ejemplo, Task). En otras palabras, la cuestión no es si el «formulario» es válido, sino más bien si el objeto $task es válido después de aplicarle los datos enviados en el formulario. Invocar a $form->isValid() es un atajo que pregunta al objeto $task si tiene datos válidos o no.

            -

            La validación se realiza añadiendo un conjunto de reglas (llamadas restricciones) a una clase. Para ver esto en acción, añade restricciones de validación para que el campo task no pueda estar vacío y el campo dueDate no pueda estar vacío y debe ser un objeto \DateTime válido.

            -
            -
              -
            • YAML
              # Acme/TaskBundle/Resources/config/validation.yml
-Acme\TaskBundle\Entity\Task:
-    properties:
-        task:
-            - NotBlank: ~
-        dueDate:
-            - NotBlank: ~
-            - Type: \DateTime
-
              -
              -
              • -
            • Annotations
              // Acme/TaskBundle/Entity/Task.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Task
-{
-    /**
-     * @Assert\NotBlank()
-     */
-    public $task;
-
-    /**
-     * @Assert\NotBlank()
-     * @Assert\Type("\DateTime")
-     */
-    protected $dueDate;
-}
-
              -
              -
              • -
            • XML
              <!-- Acme/TaskBundle/Resources/config/validation.xml -->
-<class name="Acme\TaskBundle\Entity\Task">
-    <property name="task">
-        <constraint name="NotBlank" />
-    </property>
-    <property name="dueDate">
-        <constraint name="NotBlank" />
-        <constraint name="Type">\DateTime</constraint>
-    </property>
-</class>
-
              -
              -
              • -
            • PHP
              // Acme/TaskBundle/Entity/Task.php
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\NotBlank;
-use Symfony\Component\Validator\Constraints\Type;
-
-class Task
-{
-    // ...
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('task', new NotBlank());
-
-        $metadata->addPropertyConstraint('dueDate', new NotBlank());
-        $metadata->addPropertyConstraint('dueDate', new Type('\DateTime'));
-    }
-}
-
              -
              -
              • -
            -
            -

            ¡Eso es todo! Si vuelves a enviar el formulario con datos no válidos, verás replicados los errores correspondientes en el formulario.

            - -

            La validación es una característica muy poderosa de Symfony2 y tiene su propio capítulo dedicado.

            -
            -

            Validando grupos

            -
            -

            Truco

            -

            Si no estás utilizando la validación de grupos, entonces puedes saltarte esta sección.

            -
            -

            Si tu objeto aprovecha la validación de grupos, tendrás que especificar la validación de grupos que utiliza tu formulario:

            -
            $form = $this->createFormBuilder($users, array(
-    'validation_groups' => array('registration'),
-))->add(...);
-
            -
            -

            Si vas a crear clases form (una buena práctica), entonces tendrás que agregar lo siguiente al método getDefaultOptions():

            -
            use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-public function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    $resolver->setDefaults(array(
-        'validation_groups' => array('registration')
-    ));
-}
-
            -
            -

            En ambos casos, sólo se utilizará el grupo de validación registration para validar el objeto subyacente.

            -
            -
            -

            Grupos basados en datos presentados

            -

            -Nuevo en la versión 2.1: La posibilidad de especificar una retrollamada o Cierre en validation_groups es nueva en la versión 2.1

            -

            Si necesitas alguna lógica avanzada para determinar los grupos de validación (por ejemplo, basándote en datos presentados), puedes poner la opción validation_groups a un arreglo de retrollamadas, o a un Cierre:

            -
            use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-public function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    $resolver->setDefaults(array(
-        'validation_groups' => array('Acme\\AcmeBundle\\Entity\\Client', 'determineValidationGroups'),
-    ));
-}
-
            -
            -

            Esto llamará al método estático determineValidationGroups() en la clase Cliente después de vincular el formulario, pero antes de llevar a cabo la validación. -El objeto formulario se pasa como argumento al método (ve el siguiente ejemplo). -Además puedes definir tu lógica completa en línea usando un Cierre:

            -
            use Symfony\Component\Form\FormInterface;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-public function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    $resolver->setDefaults(array(
-        'validation_groups' => function(FormInterface $form) {
-            $data = $form->getData();
-            if (Entity\Client::TYPE_PERSON == $data->getType()) {
-                return array('person');
-            } else {
-                return array('company');
-            }
-        },
-    ));
-}
-
            -
            -
            -
            -
            -

            Tipos de campo integrados

            -

            Symfony estándar viene con un gran grupo de tipos de campo que cubre todos los campos de formulario comunes y tipos de datos necesarios:

            -
            -

            Campos de texto

            - -
            -
            -

            Campos de elección

            - -
            -
            -

            Campos de fecha y hora

            - -
            -
            -

            Otros campos

            - -
            -
            -

            Campos agrupados

            - -
            -
            -

            Campos ocultos

            - -
            -
            -

            Campos base

            - -

            También puedes crear tus propios tipos de campo personalizados. Este tema se trata en el artículo «Cómo crear un tipo de campo personalizado para formulario» del recetario.

            -
            -
            -

            Opciones del tipo de campo

            -

            Cada tipo de campo tiene una serie de opciones que puedes utilizar para configurarlo. -Por ejemplo, el campo dueDate se está traduciendo como 3 cajas de selección. Sin embargo, puedes configurar el campo de fecha para que sea interpretado como un cuadro de texto (donde el usuario introduce la fecha como una cadena en el cuadro):

            -
            ->add('dueDate', 'date', array('widget' => 'single_text'))
-
            -
            -../_images/form-simple2.png -

            Cada tipo de campo tiene una diferente serie de opciones que le puedes pasar. -Muchas de ellas son específicas para el tipo de campo y puedes encontrar los detalles en la documentación de cada tipo.

            -
            -

            La opción required

            -

            La opción más común es la opción required, la cual puedes aplicar a cualquier campo. De manera predeterminada, la opción required está establecida en true, lo cual significa que los navegadores preparados para HTML5 aplicarán la validación en el cliente si el campo se deja en blanco. Si no deseas este comportamiento, establece la opción required en tu campo a false o desactiva la validación de HTML5.

            -

            También ten en cuenta que al establecer la opción required a true no resultará en aplicar la validación de lado del servidor. En otras palabras, si un usuario envía un valor en blanco para el campo (ya sea con un navegador antiguo o un servicio web, por ejemplo), será aceptado como un valor válido a menos que utilices la validación de restricción NotBlank o NotNull de Symfony.

            -

            En otras palabras, la opción required es «agradable», pero ciertamente siempre se debe utilizar de lado del servidor.

            -
            -
            -

            La opción label

            -

            La etiqueta para el campo form se puede fijar usando la opción label, la cual se puede aplicar a cualquier campo:

            -
            ->add('dueDate', 'date', array(
-    'widget' => 'single_text',
-    'label'  => 'Due Date',
-))
-
            -
            -

            La etiqueta de un campo también se puede configurar al pintar la plantilla del formulario, ve más abajo.

            -
            -
            -
            -
            -

            Deduciendo el tipo de campo

            -

            Ahora que has añadido metadatos de validación a la clase Task, Symfony ya sabe un poco sobre tus campos. Si le permites, Symfony puede «deducir» el tipo de tu campo y configurarlo por ti. En este ejemplo, Symfony lo puede deducir a partir de las reglas de validación de ambos campos, task es un campo de texto normal y dueDate es un campo date:

            -
            public function newAction()
-{
-    $task = new Task();
-
-    $form = $this->createFormBuilder($task)
-        ->add('task')
-        ->add('dueDate', null, array('widget' => 'single_text'))
-        ->getForm();
-}
-
            -
            -

            El «adivino» se activa cuando omites el segundo argumento del método add() (o si le pasas null). Si pasas un arreglo de opciones como tercer argumento (hecho por dueDate arriba), estas opciones se aplican al campo inferido.

            -
            -

            Prudencia

            -

            Si tu formulario utiliza una validación de grupo específica, el adivino del tipo de campo seguirá considerando todas las restricciones de validación cuando infiere el tipo de campo (incluyendo las restricciones que no son parte de la validación de grupo utilizada).

            -
            -
            -

            Opciones para deducir el tipo de campo

            -

            Además de deducir el «tipo» de un campo, Symfony también puede tratar de inferir los valores correctos a partir de una serie de opciones del campo.

            -
            -

            Truco

            -

            Cuando estas opciones están configuradas, el campo se dibujará con los atributos HTML especiales proporcionados para la validación de HTML5 en el cliente. Sin embargo, no genera el equivalente de las restricciones de lado del servidor (por ejemplo, Assert\Length). -Y aunque tendrás que agregar manualmente la validación de lado del servidor, estas opciones del tipo de campo entonces se pueden deducir a partir de esa información.

            -
            -
              -
            • required: La opción required se puede deducir basándose en las reglas de validación (es decir, el campo es NotBlank o NotNull) o los metadatos de Doctrine (es decir, el campo es nullable). Esto es muy útil, ya que tu validación de lado del cliente se ajustará automáticamente a tus reglas de validación.
              • -
            • max_length: Si el campo es una especie de campo de texto, entonces la opción max_length se puede inferir a partir de las restricciones de validación (si utilizas Length o Range) o desde los metadatos de Doctrine (vía la longitud del campo).
              • -
            -
            -

            Nota

            -

            Estas opciones de campo sólo se infieren si estás utilizando Symfony para deducir el tipo de campo (es decir, las omites por completo o pasas null como el segundo argumento de add()).

            -
            -

            Si quieres cambiar uno de los valores inferidos, lo puedes redefinir pasando la opción en el arreglo de opciones del campo:

            -
            ->add('task', null, array('max_length' => 4))
-
            -
            -
            -
            -
            -

            Reproduciendo un formulario en una plantilla

            -

            Hasta ahora, has visto cómo se puede reproducir todo el formulario con una sola línea de código. Por supuesto, generalmente necesitarás mucha más flexibilidad al reproducirlo:

            -
            -
              -
            • Twig
              {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #}
-<form action="{{ path('task_new') }}" method="post" {{ form_enctype(form) }}>
-    {{ form_errors(form) }}
-
-    {{ form_row(form.task) }}
-    {{ form_row(form.dueDate) }}
-
-    {{ form_rest(form) }}
-
-    <input type="submit" />
-</form>
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/TaskBundle/Resources/views/Default/newAction.html.php -->
-<form action="<?php echo $view['router']->generate('task_new') ?>" method="post" <?php echo $view['form']->enctype($form) ?>>
-    <?php echo $view['form']->errors($form) ?>
-
-    <?php echo $view['form']->row($form['task']) ?>
-    <?php echo $view['form']->row($form['dueDate']) ?>
-
-    <?php echo $view['form']->rest($form) ?>
-
-    <input type="submit" />
-</form>
-
              -
              -
              • -
            -
            -

            Échale un vistazo a cada parte:

            -
              -
            • form_enctype(form) — Si por lo menos un campo es para carga de archivos, se reproduce el obligado enctype="multipart/form-data";
              • -
            • form_errors(form) — Dibuja cualquier error global para todo el formulario (los errores específicos al campo se muestran junto a cada campo);
              • -
            • form_row(form.dueDate) — Dibuja la etiqueta, cualquier error, y el elemento gráfico HTML del formulario para el campo en cuestión (por ejemplo, dueDate), por omisión, en el interior de un elemento div;
              • -
            • form_rest(form) — Pinta todos los campos que aún no se han reproducido. -Por lo general es buena idea realizar una llamada a este ayudante en la parte inferior de cada formulario (en caso de haber olvidado sacar un campo o si no quieres preocuparte de reproducir manualmente los campos ocultos). Este ayudante también es útil para tomar ventaja de la Protección CSRF automática.
              • -
            -

            La mayor parte del trabajo la realiza el ayudante form_row, el cual de manera predeterminada reproduce la etiqueta, los errores y el elemento gráfico HTML de cada campo del formulario dentro de una etiqueta div. En la sección Tematizando formularios, aprenderás cómo puedes personalizar form_row en diferentes niveles.

            -
            -

            Truco

            -

            Puedes acceder a los datos reales de tu formulario vía form.vars.value:

            -
            -
              -
            • Twig
              {{ form.vars.value.task }}
-
              -
              -
              • -
            • PHP
              <?php echo $view['form']->get('value')->getTask() ?>
-
              -
              -
              • -
            -
            -
            -
            -

            Reproduciendo cada campo a mano

            -

            El ayudante form_row es magnífico porque rápidamente puedes reproducir cada campo del formulario (y también puedes personalizar el formato utilizado para la «fila»). Pero, puesto que la vida no siempre es tan simple, también puedes dibujar cada campo totalmente a mano. El producto final del siguiente fragmento es el mismo que cuando usas el ayudante form_row:

            -
            -
              -
            • Twig
              {{ form_errors(form) }}
-
-<div>
-    {{ form_label(form.task) }}
-    {{ form_errors(form.task) }}
-    {{ form_widget(form.task) }}
-</div>
-
-<div>
-    {{ form_label(form.dueDate) }}
-    {{ form_errors(form.dueDate) }}
-    {{ form_widget(form.dueDate) }}
-</div>
-
-{{ form_rest(form) }}
-
              -
              -
              • -
            • PHP
              <?php echo $view['form']->errors($form) ?>
-
-<div>
-    <?php echo $view['form']->label($form['task']) ?>
-    <?php echo $view['form']->errors($form['task']) ?>
-    <?php echo $view['form']->widget($form['task']) ?>
-</div>
-
-<div>
-    <?php echo $view['form']->label($form['dueDate']) ?>
-    <?php echo $view['form']->errors($form['dueDate']) ?>
-    <?php echo $view['form']->widget($form['dueDate']) ?>
-</div>
-
-<?php echo $view['form']->rest($form) ?>
-
              -
              -
              • -
            -
            -

            Si la etiqueta generada automáticamente para un campo no es del todo correcta, la puedes especificar explícitamente:

            -
            -
              -
            • Twig
              {{ form_label(form.task, 'Task Description') }}
-
              -
              -
              • -
            • PHP
              <?php echo $view['form']->label($form['task'], 'Task Description') ?>
-
              -
              -
              • -
            -
            -

            Algunos tipos de campo tienen opciones adicionales para su representación que puedes pasar al elemento gráfico. Estas opciones están documentadas con cada tipo, pero una opción común es attr, la cual te permite modificar los atributos en el elemento del formulario. -Lo siguiente debería añadir la clase task_field al campo de entrada de texto reproducido:

            -
            -
              -
            • Twig
              {{ form_widget(form.task, { 'attr': {'class': 'task_field'} }) }}
-
              -
              -
              • -
            • PHP
              <?php echo $view['form']->widget($form['task'], array(
-    'attr' => array('class' => 'task_field'),
-)) ?>
-
              -
              -
              • -
            -
            -

            Si necesitas dibujar campos de formulario «a mano», entonces puedes acceder a los valores individuales de los campos tal como el id nombre y etiqueta. Por ejemplo, para conseguir el id:

            -
            -
              -
            • Twig
              {{ form.task.vars.id }}
-
              -
              -
              • -
            • PHP
              <?php echo $form['task']->get('id') ?>
-
              -
              -
              • -
            -
            -

            Para recuperar el valor utilizado para el atributo nombre del campo en el formulario necesitas utilizar -el valor full_name:

            -
            -
              -
            • Twig
              {{ form.task.vars.full_name }}
-
              -
              -
              • -
            • PHP
              <?php echo $form['task']->get('full_name') ?>
-
              -
              -
              • -
            -
            -
            -
            -

            Referencia de funciones de plantilla Twig

            -

            Si estás utilizando Twig, hay disponible una referencia completa de las funciones de reproducción de formularios en el Manual de referencia. -Estúdiala para conocer todo acerca de los ayudantes y las opciones disponibles que puedes utilizar con cada uno.

            -
            -
            -
            -

            Creando clases Form

            -

            Como viste, puedes crear un formulario y utilizarlo directamente en un controlador. -Sin embargo, una mejor práctica es construir el formulario en una clase separada, independiente de las clases PHP, misma que puedes reutilizar en cualquier lugar de tu aplicación. Crea una nueva clase que albergará la lógica para la construcción del formulario de la tarea:

            -
            // src/Acme/TaskBundle/Form/Type/TaskType.php
-namespace Acme\TaskBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-
-class TaskType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('task');
-        $builder->add('dueDate', null, array('widget' => 'single_text'));
-    }
-
-    public function getName()
-    {
-        return 'task';
-    }
-}
-
            -
            -

            Esta nueva clase contiene todas las indicaciones necesarias para crear el formulario de la tarea (observa que el método getName() devolverá un identificador único para este «tipo» de formulario). La puedes utilizar para construir rápidamente un objeto formulario en el controlador:

            -
            // src/Acme/TaskBundle/Controller/DefaultController.php
-
-// agrega esta nueva declaración use en lo alto de la clase
-use Acme\TaskBundle\Form\Type\TaskType;
-
-public function newAction()
-{
-    $task = ...;
-    $form = $this->createForm(new TaskType(), $task);
-
-    // ...
-}
-
            -
            -

            Colocar la lógica del formulario en su propia clase significa que fácilmente puedes reutilizar el formulario en otra parte del proyecto. Esta es la mejor manera de crear formularios, pero la decisión en última instancia, depende de ti.

            - -
            -

            Truco

            -

            Al asignar formularios a objetos, se asignan todos los campos. Todos los campos del formulario que no existen en el objeto asignado provocarán que se lance una excepción.

            -

            En los casos donde necesites más campos en el formulario (por ejemplo: para una casilla de verificación «Estoy de acuerdo con estos términos») que no se asociará al objeto subyacente, necesitas establecer la opción property_path a false:

            -
            use Symfony\Component\Form\FormBuilderInterface;
-
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    $builder->add('task');
-    $builder->add('dueDate', null, array('mapped' => false));
-}
-
            -
            -

            Además, si hay algunos campos en el formulario que no se incluyen en los datos presentados, esos campos explícitamente se establecerán en null.

            -

            Los datos del campo se pueden acceder en un controlador con:

            -
            $form->get('dueDate')->getData();
-
            -
            -
            -
            -
            -

            Formularios y Doctrine

            -

            El objetivo de un formulario es traducir los datos de un objeto (por ejemplo, Task) a un formulario HTML y luego traducir los datos enviados por el usuario al objeto original. Como tal, el tema de la persistencia del objeto Task a la base de datos es del todo ajeno al tema de los formularios. Pero, si has configurado la clase Task para persistirla a través de Doctrine (es decir, que le has añadido metadatos de asignación), entonces persistirla después de la presentación de un formulario se puede hacer cuando el formulario es válido:

            -
            if ($form->isValid()) {
-    $em = $this->getDoctrine()->getManager();
-    $em->persist($task);
-    $em->flush();
-
-    return $this->redirect($this->generateUrl('task_success'));
-}
-
            -
            -

            Si por alguna razón, no tienes acceso a tu objeto $task original, lo puedes recuperar desde el formulario:

            -
            $task = $form->getData();
-
            -
            -

            Para más información, consulta el capítulo ORM de Doctrine.

            -

            La clave es entender que cuando el formulario está vinculado, los datos presentados inmediatamente se transfieren al objeto subyacente. Si deseas conservar los datos, sólo tendrás que conservar el objeto en sí (el cual ya contiene los datos presentados).

            -
            -
            -

            Integrando formularios

            -

            A menudo, querrás crear un formulario que incluye campos de muchos objetos diferentes. Por ejemplo, un formulario de registro puede contener datos que pertenecen a un objeto User, así como a muchos objetos Address. Afortunadamente, esto es fácil y natural con el componente Form.

            -
            -

            Integrando un solo objeto

            -

            Supongamos que cada Task pertenece a un simple objeto Categoría. Inicia, por supuesto, creando el objeto Categoría:

            -
            // src/Acme/TaskBundle/Entity/Category.php
-namespace Acme\TaskBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Category
-{
-    /**
-     * @Assert\NotBlank()
-     */
-    public $name;
-}
-
            -
            -

            A continuación, añade una nueva propiedad categoría a la clase Task:

            -
            // ...
-
-class Task
-{
-    // ...
-
-    /**
-     * @Assert\Type(type="Acme\TaskBundle\Entity\Category")
-     */
-    protected $category;
-
-    // ...
-
-    public function getCategory()
-    {
-        return $this->category;
-    }
-
-    public function setCategory(Category $category = null)
-    {
-        $this->category = $category;
-    }
-}
-
            -
            -

            Ahora que actualizaste tu aplicación para reflejar las nuevas necesidades, crea una clase formulario para que el usuario pueda modificar un objeto Categoría:

            -
            // src/Acme/TaskBundle/Form/Type/CategoryType.php
-namespace Acme\TaskBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class CategoryType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('name');
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'data_class' => 'Acme\TaskBundle\Entity\Category',
-        ));
-    }
-
-    public function getName()
-    {
-        return 'category';
-    }
-}
-
            -
            -

            El objetivo final es permitir que la Categoría de una Task sea modificada justo dentro del mismo formulario de la tarea. Para lograr esto, añade un campo categoría al objeto TaskType cuyo tipo es una instancia de la nueva clase CategoryType:

            -
            use Symfony\Component\Form\FormBuilderInterface;
-
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    // ...
-
-    $builder->add('category', new CategoryType());
-}
-
            -
            -

            Los campos de CategoryType ahora se pueden reproducir junto a los de la clase TaskType. Para activar la validación en CategoryType, añade la opción cascade_validation como TaskType:

            -
            public function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    $resolver->setDefaults(array(
-        'data_class' => 'Acme\TaskBundle\Entity\Task',
-        'cascade_validation' => true,
-    ));
-}
-
            -
            -

            Reproduce los campos de Categoría de la misma manera que los campos de la Task original:

            -
            -
              -
            • Twig
              {# ... #}
-
-<h3>Category</h3>
-<div class="category">
-    {{ form_row(form.category.name) }}
-</div>
-
-{{ form_rest(form) }}
-{# ... #}
-
              -
              -
              • -
            • PHP
              <!-- ... -->
-
-<h3>Category</h3>
-<div class="category">
-    <?php echo $view['form']->row($form['category']['name']) ?>
-</div>
-
-<?php echo $view['form']->rest($form) ?>
-<!-- ... -->
-
              -
              -
              • -
            -
            -

            Cuando el usuario envía el formulario, los datos presentados para los campos de Categoría se utilizan para construir una instancia de Categoría, que entonces se establece en el campo categoría de la instancia de Task.

            -

            La instancia de Categoría es accesible naturalmente vía $task->getCategory() y la puedes persistir en la base de datos o utilizarla como necesites.

            -
            -
            -

            Integrando una colección de formularios

            -

            Puedes integrar una colección de formularios en un solo formulario (imagina un formulario Categoría con muchos subformularios Producto). Esto se consigue usando el tipo de campo collection.

            -

            Para más información consulta el artículo «Cómo integrar una colección de formularios» del recetario y la referencia del tipo de campo collection.

            -
            -
            -
            -

            Tematizando formularios

            -

            Puedes personalizar cómo se reproduce cada parte de un formulario. Eres libre de cambiar la forma en que se dibuja cada «fila» del formulario, cambiar el formato que sirve para reproducir errores, e incluso personalizar la forma en que se debe reproducir una etiqueta textarea. Nada está fuera de límites, y puedes usar diferentes personalizaciones en diferentes lugares.

            -

            Symfony utiliza plantillas para reproducir todas y cada una de las partes de un formulario, como las etiquetas label, etiquetas input, mensajes de error y todo lo demás.

            -

            En Twig, cada «fragmento» del formulario está representado por un bloque Twig. Para personalizar alguna parte de cómo se reproduce un formulario, sólo hay que reemplazar el bloque adecuado.

            -

            En PHP, cada «fragmento» del formulario se reproduce vía un archivo de plantilla individual. -Para personalizar cualquier parte de cómo se reproduce un formulario, sólo hay que reemplazar la plantilla existente creando una nueva.

            -

            Para entender cómo funciona esto, vamos a personalizar el fragmento form_row añadiendo un atributo «class» al elemento div que envuelve cada fila. Para ello, crea un nuevo archivo de plantilla que almacenará el nuevo marcado:

            -
            -
              -
            • Twig
              {# src/Acme/TaskBundle/Resources/views/Form/fields.html.twig #}
-{% block form_row %}
-{% spaceless %}
-    <div class="form_row">
-        {{ form_label(form) }}
-        {{ form_errors(form) }}
-        {{ form_widget(form) }}
-    </div>
-{% endspaceless %}
-{% endblock form_row %}
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/TaskBundle/Resources/views/Form/form_row.html.php -->
-<div class="form_row">
-    <?php echo $view['form']->label($form, $label) ?>
-    <?php echo $view['form']->errors($form) ?>
-    <?php echo $view['form']->widget($form, $parameters) ?>
-</div>
-
              -
              -
              • -
            -
            -

            El fragmento field_row del formulario se usa cuando al dibujar la mayoría de los campos a través de la función form_row. Para decir al componente Form que utilice tu nuevo fragmento field_row definido anteriormente, añade lo siguiente en la parte superior de la plantilla que dibuja el formulario:

            -
            -
              -
            • Twig
              {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #}
-{% form_theme form 'AcmeTaskBundle:Form:fields.html.twig' %}
-
-{% form_theme form 'AcmeTaskBundle:Form:fields.html.twig'
-                   'AcmeTaskBundle:Form:fields2.html.twig' %}
-
-<form ...>
              -
              -
              • -
            • PHP
              <!-- src/Acme/TaskBundle/Resources/views/Default/new.html.php -->
-<?php $view['form']->setTheme($form, array('AcmeTaskBundle:Form')) ?>
-
-<?php $view['form']->setTheme($form, array('AcmeTaskBundle:Form', 'AcmeTaskBundle:Form')) ?>
-
-<form ...>
              -
              -
              • -
            -
            -

            La etiqueta form_theme (en Twig) «importa» los fragmentos definidos en la plantilla dada y los utiliza al reproducir el formulario. En otras palabras, cuando más adelante en esta plantilla se invoque la función form_row, se utilizará el bloque field_row de tu tema personalizado (en lugar del bloque field_row predefinido suministrado con Symfony).

            -

            Tu tema personalizado no tiene que sustituir todos los bloques. Cuando dibujes un bloque que no se reemplaza en tu tema personalizado, el motor de creación de temas caerá de nuevo en el tema global (definido a nivel del paquete).

            -

            Si hay varios temas personalizados siempre se buscará en el orden listado antes de caer de nuevo al tema global.

            -

            Para personalizar cualquier parte de un formulario, sólo tienes que reemplazar el fragmento apropiado. Saber exactamente qué bloque sustituir es el tema de la siguiente sección.

            -

            -Nuevo en la versión 2.1: Introduce una sintaxis alterna para el form_theme de Twig. Esta acepta cualquier expresión Twig válida (la diferencia más notable es el uso de un arreglo cuando utilizas múltiples temas).

            {# src/Acme/TaskBundle/Resources/views/Default/new.html.twig #}
-
-{% form_theme form with 'AcmeTaskBundle:Form:fields.html.twig' %}
-
-{% form_theme form with ['AcmeTaskBundle:Form:fields.html.twig',
-                         'AcmeTaskBundle:Form:fields2.html.twig'] %}
-
            -
            -

            -

            Para una explicación más extensa, consulta Cómo personalizar la reproducción de un formulario.

            -
            -

            Nombrando fragmentos de formulario

            -

            En Symfony, cada parte de un formulario reproducido —elementos HTML de formulario, errores, -etiquetas, etc.— se definen en base a un tema, el cual es una colección de bloques en Twig y una colección de archivos de plantilla en PHP.

            -

            En Twig, cada bloque necesario se define en un solo archivo de plantilla (form_div_layout.html.twig) que vive dentro del puente Twig. Dentro de este archivo, puedes ver todos los bloques necesarios para reproducir un formulario y cada tipo de campo predeterminado.

            -

            En PHP, los fragmentos son archivos de plantilla individuales. De manera predeterminada se encuentran en el directorio Resources/views/Form del paquete de la plataforma (ver en GitHub).

            -

            El nombre de cada fragmento sigue el mismo patrón básico y se divide en dos partes, separadas por un solo carácter de guión bajo (_). Algunos ejemplos son:

            -
              -
            • form_row — usado por form_row para reproducir la mayoría de los campos;
              • -
            • textarea_widget — usado por form_widget para dibujar un campo de tipo textarea;
              • -
            • form_errors — usado por form_errors para dibujar los errores de un campo;
              • -
            -

            Cada fragmento sigue el mismo patrón básico: type_part. La porción type corresponde al tipo del campo que se está reproduciendo (por ejemplo, textarea, checkbox, date, etc.), mientras que la porción part corresponde a qué se está reproduciendo (por ejemplo, label, widget, errors, etc.). Por omisión, hay cuatro posibles partes de un formulario que puedes pintar:

            - ----- - - - - - - - - - - - - - - - - - - -
            label(p. ej. form_label)dibuja la etiqueta de los campos
            widget(p. ej. form_widget)dibuja la representación HTML de los campos
            errors(p. ej. form_errors)dibuja los errores de los campos
            row(p. ej. form_row)dibuja el renglón completo de los campos (etiqueta, -elemento gráfico y errores)
            -
            -

            Nota

            -

            En realidad, hay otras 3 partes —rows, rest y enctype— pero rara vez o quizá nunca te tengas que preocupar de cómo sustituirlas.

            -
            -

            Al conocer el tipo de campo (por ejemplo, textarea) y cual parte deseas personalizar (por ejemplo, widget), puedes construir el nombre del fragmento que se debe redefinir (por ejemplo, textarea_widget).

            -
            -
            -

            Heredando fragmentos de plantilla

            -

            En algunos casos, parece que falta el fragmento que deseas personalizar. -Por ejemplo, no hay fragmento textarea_errors en los temas predeterminados provistos con Symfony. Entonces, ¿cómo se reproducen los errores de un campo textarea?

            -

            La respuesta es: a través del fragmento field_errors. Cuando Symfony pinta los errores del tipo textarea, primero busca un fragmento textarea_errors antes de caer de nuevo al fragmento form_errors. Cada tipo de campo tiene un tipo padre (el tipo primario del textarea es text, y su padre es el form), y Symfony utiliza el fragmento para el tipo del padre si no existe el fragmento base.

            -

            Por lo tanto, para sustituir sólo los errores de los campos textarea, copia el fragmento form_errors, renómbralo como textarea_errors y personalízalo. Para sustituir la reproducción predeterminada para error de todos los campos, copia y personaliza el fragmento form_errors directamente.

            -
            -

            Truco

            -

            El tipo «padre» de cada tipo de campo está disponible en la referencia del tipo form para cada tipo de campo.

            -
            -
            -
            -

            Tematizando formularios globalmente

            -

            En el ejemplo anterior, utilizaste el ayudante form_theme (en Twig) para «importar» fragmentos de formulario personalizados sólo para ese formulario. También puedes decirle a Symfony que importe formularios personalizados a través de tu proyecto.

            -
            -

            Twig

            -

            Para incluir automáticamente en todas las plantillas los bloques personalizados de la plantilla fields.html.twig creada anteriormente, modifica el archivo de configuración de tu aplicación:

            -
            -
              -
            • YAML
              # app/config/config.yml
-twig:
-    form:
-        resources:
-            - 'AcmeTaskBundle:Form:fields.html.twig'
-    # ...
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<twig:config ...>
-        <twig:form>
-            <resource>AcmeTaskBundle:Form:fields.html.twig</resource>
-        </twig:form>
-        <!-- ... -->
-</twig:config>
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('twig', array(
-    'form' => array(
-        'resources' => array(
-            'AcmeTaskBundle:Form:fields.html.twig',
-        ),
-    ),
-    // ...
-));
-
              -
              -
              • -
            -
            -

            Ahora se utilizan todos los bloques dentro de la plantilla fields.html.twig a nivel global para definir el formulario producido.

            -
            -

            Personalizando toda la salida del formulario en un único archivo con Twig

            -

            En Twig, también puedes personalizar el bloque correcto de un formulario dentro de la plantilla donde se necesita esa personalización:

            -
            {% extends '::base.html.twig' %}
-
-{# importa '_self' como el tema del formulario #}
-{% form_theme form _self %}
-
-{# hace la personalización del fragmento del formulario #}
-{% block form_row %}
-    {# pinta la fila del campo personalizado #}
-{% endblock form_row %}
-
-{% block content %}
-    {# ... #}
-
-    {{ form_row(form.task) }}
-{% endblock %}
-
            -
            -

            La etiqueta {% form_theme form_self %} permite personalizar bloques directamente dentro de la plantilla que utilizará las personalizaciones. Utiliza este método para crear rápidamente formularios personalizados que sólo son necesarios en una sola plantilla.

            -
            -

            Prudencia

            -

            La funcionalidad {% form_theme form _self %} únicamente trabajará si tu plantilla extiende a otra. Si no, debes hacer que form_theme apunte a una plantilla distinta.

            -
            -
            -
            -
            -

            PHP

            -

            Para incluir automáticamente todas las plantillas personalizadas del directorio Acme/TaskBundle/Resources/views/Form creado anteriormente, modifica el archivo de configuración de tu aplicación:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    templating:
-        form:
-            resources:
-                - 'AcmeTaskBundle:Form'
-# ...
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config ...>
-    <framework:templating>
-        <framework:form>
-            <resource>AcmeTaskBundle:Form</resource>
-        </framework:form>
-    </framework:templating>
-    <!-- ... -->
-</framework:config>
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    'templating' => array(
-        'form' => array(
-            'resources' => array(
-                'AcmeTaskBundle:Form',
-            ),
-        ),
-    )
-    // ...
-));
-
              -
              -
              • -
            -
            -

            Cualquier fragmento dentro del directorio Acme/TaskBundle/Resources/views/Form ahora se utiliza globalmente para definir la salida del formulario.

            -
            -
            -
            -
            -

            Protección CSRF

            -

            CSRF (Cross-site request forgery) —o Falsificación de petición en sitios cruzados— es un método por el cual un usuario malintencionado intenta hacer que tus usuarios legítimos, sin saberlo, presenten datos que no tienen la intención de enviar. Afortunadamente, los ataques CSRF se pueden prevenir usando un elemento CSRF dentro de tus formularios.

            -

            La buena nueva es que, por omisión, Symfony integra y valida elementos CSRF automáticamente. Esto significa que puedes aprovechar la protección CSRF sin hacer nada. De hecho, ¡cada formulario en este capítulo se ha aprovechado de la protección CSRF!

            -

            La protección CSRF funciona añadiendo un campo oculto al formulario —por omisión denominado _token— el cual contiene un valor que sólo tú y tu usuario conocen. Esto garantiza que el usuario —y no alguna otra entidad— es el que presenta dichos datos. -Symfony automáticamente valida la presencia y exactitud de este elemento.

            -

            El campo _token es un campo oculto y será reproducido automáticamente si se incluye la función form_rest() de la plantilla, la cual garantiza que se presenten todos los campos producidos.

            -

            El elemento CSRF se puede personalizar formulario por formulario. Por ejemplo:

            -
            use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class TaskType extends AbstractType
-{
-    // ...
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'data_class'      => 'Acme\TaskBundle\Entity\Task',
-            'csrf_protection' => true,
-            'csrf_field_name' => '_token',
-            // una clave única para ayudar generar la ficha secreta
-            'intention'       => 'task_item',
-        ));
-    }
-
-    // ...
-}
-
            -
            -

            Para desactivar la protección CSRF, fija la opción csrf_protection a false. -Las personalizaciones también se pueden hacer a nivel global en tu proyecto. Para más información, consulta la sección referencia de configuración de formularios.

            -
            -

            Nota

            -

            La opción intention es opcional pero mejora considerablemente la seguridad del elemento generado produciendo uno diferente para cada formulario.

            -
            -
            -
            -

            Usando un formulario sin clase

            -

            En la mayoría de los casos, un formulario está ligado a un objeto, y los campos del formulario obtienen y almacenan sus datos en las propiedades de ese objeto. Esto exactamente es lo que has visto hasta ahora en este capítulo con la clase Task.

            -

            Pero a veces, es posible que sólo desees utilizar un formulario sin una clase, y devolver un arreglo de los datos presentados. Esto realmente es muy fácil:

            -
            // asegúrate de importar el espacio de nombres Request antes de la clase
-use Symfony\Component\HttpFoundation\Request;
-// ...
-
-public function contactAction(Request $request)
-{
-    $defaultData = array('message' => 'Type your message here');
-    $form = $this->createFormBuilder($defaultData)
-        ->add('name', 'text')
-        ->add('email', 'email')
-        ->add('message', 'textarea')
-        ->getForm();
-
-        if ($request->isMethod('POST')) {
-            $form->bind($request);
-
-            // data es un arreglo con claves 'name', 'email', y 'message'
-            $data = $form->getData();
-        }
-
-    // ... pinta el formulario
-}
-
            -
            -

            Por omisión, un formulario en realidad asume que deseas trabajar con arreglos de datos, en lugar de con un objeto. Hay exactamente dos maneras en que puedes cambiar este comportamiento y en su lugar enlazar el formulario a un objeto:

            -
              -
            1. Pasa un objeto al crear el formulario (como primer argumento de createFormBuilder o segundo argumento de createForm);
              2. -
            2. Declara la opción data_class en tu formulario.
              3. -
            -

            Si no haces ninguna de estas, entonces el formulario devolverá los datos como un arreglo. En este ejemplo, debido a que $defaultData no es un objeto (y no se ha establecido la opción data_class), en última instancia $form->getData(), devuelve un arreglo.

            -
            -

            Truco

            -

            También puedes acceder a los valores POST (en este caso «name») directamente a través del objeto Petición, de la siguiente manera:

            -
            $this->get('request')->request->get('name');
-
            -
            -

            Ten en cuenta, sin embargo, que en la mayoría de los casos una mejor opción es utilizar el método getData(), ya que devuelve los datos (generalmente un objeto), después de que la infraestructura del formulario los ha transformado.

            -
            -
            -

            Añadiendo validación

            -

            La única pieza faltante es la validación. Por lo general, cuando llamas a $form->isValid(), el objeto es validado leyendo las restricciones que aplicaste a esa clase. Si tu formulario está vinculado a un objeto (es decir, estás utilizando la opción data_class -o pasando un objeto a tu formulario), este casi siempre es el enfoque que quieres usar. Ve Validando para más detalles.

            -

            Pero si no está vinculado a un objeto y en cambio recuperaste un simple arreglo de los datos presentados, ¿cómo puedes agregar restricciones a los datos de tu formulario?

            -

            La respuesta es configurar las restricciones tú mismo, y anexarlas a los campos individuales. El enfoque general está cubierto un poco más en el capítulo de validación, pero aquí está un pequeño ejemplo:

            -

            -Nuevo en la versión 2.1: La opción constraints, que acepta una única restricción o un arreglo de restricciones (antes de 2.1, la opción fue llamada validation_constraint, y sólo acepta una única restricción) es nueva para Symfony 2.1.

            -
            use Symfony\Component\Validator\Constraints\Length;
-use Symfony\Component\Validator\Constraints\NotBlank;
-
-$builder
-   ->add('firstName', 'text', array(
-       'constraints' => new Length(array('min' => 3)),
-   ))
-   ->add('lastName', 'text', array(
-       'constraints' => array(
-           new NotBlank(),
-           new Length(array('min' => 3)),
-       ),
-   ))
-;
-
            -
            -
            -

            Truco

            -

            Si utilizas grupos de validación, necesitas o bien hacer referencia al grupo Default al crear el formulario, o establecer el grupo correcto en la restricción que estás añadiendo.

            -
            -
            new NotBlank(array('groups' => array('create', 'update'))
-
            -
            -
            -
            -
            -

            Consideraciones finales

            -

            Ahora ya conoces todos los bloques de construcción necesarios para elaborar formularios complejos y funcionales para tu aplicación. Cuando construyas formularios, ten en cuenta que el primer objetivo de un formulario es traducir los datos de un objeto (Task) a un formulario HTML para que el usuario pueda modificar esos datos. El segundo objetivo de un formulario es tomar los datos presentados por el usuario y volverlos a aplicar al objeto.

            -

            Todavía hay mucho más que aprender sobre el poderoso mundo de los formularios, tal como la forma de manejar archivos subidos con Doctrine o cómo crear un formulario donde puedes agregar dinámicamente una serie de subformularios (por ejemplo, una lista de tareas donde puedes seguir añadiendo más campos a través de Javascript antes de presentarlos). Consulta el recetario para estos temas. Además, asegúrate de apoyarte en la referencia de tipos de campo, que incluye ejemplos de cómo utilizar cada tipo de campo y sus opciones.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/from_flat_php_to_symfony2.html b/book/from_flat_php_to_symfony2.html deleted file mode 100644 index b63a27f..0000000 --- a/book/from_flat_php_to_symfony2.html +++ /dev/null @@ -1,676 +0,0 @@ - - - - - - - Symfony2 frente a PHP simple — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Symfony2 frente a PHP simple

            -

            ¿Por qué Symfony2 es mejor que sólo abrir un archivo y escribir PHP simple?

            -

            Si nunca has usado una plataforma PHP, no estás familiarizado con la filosofía MVC, o simplemente te preguntas qué es todo ese alboroto en torno a Symfony2, este capítulo es para ti. En vez de decirte que Symfony2 te permite desarrollar software más rápido y mejor que con PHP simple, debes verlo tú mismo.

            -

            En este capítulo, vamos a escribir una aplicación sencilla en PHP simple, y luego la reconstruiremos para que esté mejor organizada. Podrás viajar a través del tiempo, viendo las decisiones de por qué el desarrollo web ha evolucionado en los últimos años hasta donde está ahora.

            -

            Al final, verás cómo Symfony2 te puede rescatar de las tareas cotidianas y te permite recuperar el control de tu código.

            -
            -

            Un sencillo blog en PHP simple

            -

            En este capítulo, crearemos una simbólica aplicación de blog utilizando sólo PHP simple. -Para empezar, crea una página que muestre las entradas del blog que se han persistido en la base de datos. Escribirla en PHP simple es rápido y sucio:

            -
            <?php
-// index.php
-$link = mysql_connect('localhost', 'myuser', 'mypassword');
-mysql_select_db('blog_db', $link);
-
-$result = mysql_query('SELECT id, title FROM post', $link);
-?>
-
-<!DOCTYPE html>
-    <html>
-        <head>
-        <title>List of Posts</title>
-        </head>
-        <body>
-        <h1>List of Posts</h1>
-        <ul>
-            <?php while ($row = mysql_fetch_assoc($result)): ?>
-            <li>
-                <a href="/show.php?id=<?php echo $row['id'] ?>">
-                    <?php echo $row['title'] ?>
-                    </a>
-            </li>
-            <?php endwhile; ?>
-        </ul>
-    </body>
-</html>
-
-<?php
-mysql_close($link);
-?>
-
            -
            -

            Eso es fácil de escribir, se ejecuta rápido, y, cuando tu aplicación crece, imposible de mantener. Hay varios problemas que es necesario abordar:

            -
              -
            • No hay comprobación de errores: ¿Qué sucede si falla la conexión a la base de datos?
              • -
            • Deficiente organización: Si la aplicación crece, este único archivo cada vez será más difícil de mantener, hasta que finalmente sea imposible. ¿Dónde se debe colocar el código para manejar un formulario enviado? ¿Cómo se pueden validar los datos? ¿Dónde debe ir el código para enviar mensajes de correo electrónico?
              • -
            • Es difícil reutilizar el código: Ya que todo está en un archivo, no hay manera de volver a utilizar alguna parte de la aplicación en otras «páginas» del blog.
              • -
            -
            -

            Nota

            -

            Otro problema no mencionado aquí es el hecho de que la base de datos está vinculada a MySQL. Aunque no se ha tratado aquí, Symfony2 integra Doctrine plenamente, una biblioteca dedicada a la abstracción y asignación de bases de datos.

            -
            -

            Trabajaremos en la solución de estos y muchos problemas más.

            -
            -

            Aislando la presentación

            -

            El código inmediatamente se puede beneficiar de la separación entre la «lógica» de la aplicación y el código que prepara la «presentación» HTML:

            -
            <?php
-// index.php
-$link = mysql_connect('localhost', 'myuser', 'mypassword');
-mysql_select_db('blog_db', $link);
-
-$result = mysql_query('SELECT id, title FROM post', $link);
-
-$posts = array();
-while ($row = mysql_fetch_assoc($result)) {
-    $posts[] = $row;
-}
-
-mysql_close($link);
-
-// incluye el código HTML de la presentación
-require 'templates/list.php';
-
            -
            -

            Ahora el código HTML está guardado en un archivo separado (templates/list.php), el cual principalmente es un archivo HTML que utiliza una sintaxis de plantilla tipo PHP:

            -
            <!DOCTYPE html>
-    <html>
-        <head>
-        <title>List of Posts</title>
-        </head>
-        <body>
-        <h1>List of Posts</h1>
-        <ul>
-            <?php foreach ($posts as $post): ?>
-            <li>
-                <a href="/read?id=<?php echo $post['id'] ?>">
-                    <?php echo $post['title'] ?>
-                    </a>
-            </li>
-            <?php endforeach; ?>
-        </ul>
-    </body>
-</html>
-
            -
            -

            Por convención, el archivo que contiene toda la lógica de la aplicación —index.php— se conoce como «controlador». El término controlador es una palabra que se escucha mucho, independientemente del lenguaje o plataforma que utilices. Simplemente se refiere a la zona de tu código que procesa la entrada del usuario y prepara la respuesta.

            -

            En este caso, el controlador prepara los datos de la base de datos y, luego los incluye en una plantilla para presentarlos. Con el controlador aislado, fácilmente podríamos cambiar sólo el archivo de plantilla si es necesario procesar las entradas del blog en algún otro formato (por ejemplo, lista.json.php para el formato JSON).

            -
            -
            -

            Aislando la lógica de la aplicación (el dominio)

            -

            Hasta ahora, la aplicación sólo contiene una página. Pero ¿qué pasa si una segunda página necesita utilizar la misma conexión a la base de datos, e incluso el mismo arreglo de entradas del blog? Reconstruye el código para que el comportamiento de las funciones básicas de acceso a datos de la aplicación esté aislado en un nuevo archivo llamado model.php:

            -
            <?php
-// model.php
-function open_database_connection()
-{
-    $link = mysql_connect('localhost', 'myuser', 'mypassword');
-    mysql_select_db('blog_db', $link);
-
-    return $link;
-}
-
-function close_database_connection($link)
-{
-    mysql_close($link);
-}
-
-function get_all_posts()
-{
-    $link = open_database_connection();
-
-    $result = mysql_query('SELECT id, title FROM post', $link);
-    $posts = array();
-    while ($row = mysql_fetch_assoc($result)) {
-        $posts[] = $row;
-    }
-    close_database_connection($link);
-
-    return $posts;
-}
-
            -
            -
            -

            Truco

            -

            Utilizamos el nombre de archivo model.php debido a que el acceso a la lógica y los datos de una aplicación, tradicionalmente, se conoce como la capa del «modelo». En una aplicación bien organizada, la mayoría del código que representa tu «lógica de negocio» debe vivir en el modelo (en lugar de vivir en un controlador). Y, a diferencia de este ejemplo, sólo una parte (o ninguna) del modelo realmente está interesada en acceder a la base de datos.

            -
            -

            El controlador (index.php) ahora es muy sencillo:

            -
            <?php
-require_once 'model.php';
-
-$posts = get_all_posts();
-
-require 'templates/list.php';
-
            -
            -

            Ahora, la única tarea del controlador es conseguir los datos de la capa del modelo de la aplicación (el modelo) e invocar a una plantilla que reproduce los datos. -Este es un ejemplo muy simple del patrón modelo-vista-controlador.

            -
            -
            -

            Aislando el diseño

            -

            En este punto, reconstruiste la aplicación en tres piezas distintas, mismas que ofrecen varias ventajas y la oportunidad de volver a utilizar casi todo en diferentes páginas.

            -

            La única parte del código que no se puede reutilizar es el diseño de la página. Corregirás esto creando un nuevo archivo base.php:

            -
            <!-- templates/base.php -->
-<!DOCTYPE html>
-    <html>
-        <head>
-        <title><?php echo $title ?></title>
-        </head>
-        <body>
-        <?php echo $content ?>
-    </body>
-</html>
-
            -
            -

            La plantilla (templates/list.php) ahora se puede simplificar para «extender» el diseño:

            -
            <?php $title = 'List of Posts' ?>
-
-<?php ob_start() ?>
-    <h1>List of Posts</h1>
-    <ul>
-        <?php foreach ($posts as $post): ?>
-        <li>
-            <a href="/read?id=<?php echo $post['id'] ?>">
-                <?php echo $post['title'] ?>
-                </a>
-        </li>
-        <?php endforeach; ?>
-    </ul>
-<?php $content = ob_get_clean() ?>
-
-<?php include 'base.php' ?>
-
            -
            -

            Ahora se introdujo una metodología que te permite reutilizar el diseño. Desafortunadamente, para lograrlo, estás obligado a utilizar en la plantilla algunas desagradables funciones de PHP (ob_start(), ob_get_clean()). Symfony2 utiliza un componente Templating que te permite realizar esto limpia y fácilmente. En breve lo verás en acción.

            -
            -
            -
            -

            Agregando una página «show» al blog

            -

            La página «list» del blog se ha rediseñado para que el código esté mejor organizado y sea reutilizable. Para probarlo, añade una página «show» al blog, que muestre una entrada individual del blog identificada por un parámetro de consulta id.

            -

            Para empezar, crea una nueva función en el archivo model.php que recupere un resultado individual del blog basándose en un identificador dado:

            -
            // model.php
-function get_post_by_id($id)
-{
-    $link = open_database_connection();
-
-    $id = intval($id);
-    $query = 'SELECT date, title, body FROM post WHERE id = '.$id;
-    $result = mysql_query($query);
-    $row = mysql_fetch_assoc($result);
-
-    close_database_connection($link);
-
-    return $row;
-}
-
            -
            -

            A continuación, crea un nuevo archivo llamado show.php —el controlador para esta nueva página:

            -
            <?php
-require_once 'model.php';
-
-$post = get_post_by_id($_GET['id']);
-
-require 'templates/show.php';
-
            -
            -

            Por último, crea el nuevo archivo de plantilla —templates/show.php— para reproducir una entrada individual del blog:

            -
            <?php $title = $post['title'] ?>
-
-<?php ob_start() ?>
-    <h1><?php echo $post['title'] ?></h1>
-
-    <div class="date"><?php echo $post['date'] ?></div>
-    <div class="body">
-        <?php echo $post['body'] ?>
-    </div>
-<?php $content = ob_get_clean() ?>
-
-<?php include 'base.php' ?>
-
            -
            -

            Ahora, es muy fácil crear la segunda página y sin duplicar código. Sin embargo, esta página introduce problemas aún más perniciosos que una plataforma puede resolver por ti. Por ejemplo, un parámetro id ilegal u omitido en la consulta hará que la página se bloquee. Sería mejor si esto reprodujera una página 404, pero sin embargo, en realidad esto no se puede hacer fácilmente. Peor aún, si olvidaras desinfectar el parámetro id por medio de la función intval(), tu base de datos estaría en riesgo de un ataque de inyección SQL.

            -

            Otro importante problema es que cada archivo de controlador individual debe incluir al archivo model.php. ¿Qué pasaría si cada archivo de controlador de repente tuviera que incluir un archivo adicional o realizar alguna tarea global (por ejemplo, reforzar la seguridad)? -Tal como está ahora, el código tendría que incluir todos los archivos de los controladores. -Si olvidas incluir algo en un solo archivo, esperemos que no sea alguno relacionado con la seguridad...

            -
            -
            -

            El «controlador frontal» al rescate

            -

            Una mucho mejor solución es usar un controlador frontal: un único archivo PHP a través del cual se procesen todas las peticiones. Con un controlador frontal, la URI de la aplicación cambia un poco, pero se vuelve más flexible:

            -
            Sin controlador frontal
-/index.php          => (ejecuta index.php) la página lista de mensajes.
-/show.php           => (ejecuta show.php)  la página muestra un mensaje particular.
-
-Con index.php como controlador frontal
-/index.php          => (ejecuta index.php) la página lista de mensajes.
-/index.php/show     => (ejecuta index.php) la página muestra un mensaje particular.
-
            -
            -
            -

            Truco

            -

            Puedes quitar la porción index.php de la URI si utilizas las reglas de reescritura de Apache (o equivalentes). En ese caso, la URI resultante de la página show del blog simplemente sería /show.

            -
            -

            Cuando se usa un controlador frontal, un solo archivo PHP (index.php en este caso) procesa todas las peticiones. Para la página show del blog, /index.php/show realmente ejecuta el archivo index.php, que ahora es el responsable de dirigir internamente las peticiones basándose en la URI completa. Como puedes ver, un controlador frontal es una herramienta muy poderosa.

            -
            -

            Creando el controlador frontal

            -

            Estás a punto de dar un gran paso en la aplicación. Con un archivo manejando todas las peticiones, puedes centralizar cosas tales como el manejo de la seguridad, la carga de configuración y enrutado. En esta aplicación, index.php ahora debe ser lo suficientemente inteligente como para reproducir la lista de entradas del blog o mostrar la página de una entrada particular basándose en la URI solicitada:

            -
            <?php
-// index.php
-
-// carga e inicia algunas bibliotecas globales
-require_once 'model.php';
-require_once 'controllers.php';
-
-// encamina la petición internamente
-$uri = $_SERVER['REQUEST_URI'];
-if ('/index.php' == $uri) {
-    list_action();
-} elseif ('/index.php/show' == $uri && isset($_GET['id'])) {
-    show_action($_GET['id']);
-} else {
-    header('Status: 404 Not Found');
-    echo '<html><body><h1>Page Not Found</h1></body></html>';
-}
-
            -
            -

            Por organización, ambos controladores (antes index.php y show.php) son funciones PHP y cada una se ha movido a un archivo separado, controllers.php:

            -
            function list_action()
-{
-    $posts = get_all_posts();
-    require 'templates/list.php';
-}
-
-function show_action($id)
-{
-    $post = get_post_by_id($id);
-    require 'templates/show.php';
-}
-
            -
            -

            Como controlador frontal, index.php ha asumido un papel completamente nuevo, el cual incluye la carga de las bibliotecas del núcleo y encaminar la aplicación para invocar a uno de los dos controladores (las funciones list_action() y show_action()). En realidad, el controlador frontal está empezando a verse y actuar como el mecanismo Symfony2 para la manipulación y enrutado de peticiones.

            -
            -

            Truco

            -

            Otra ventaja del controlador frontal es la flexibilidad de las URL. Ten en cuenta que la URL a la página show del blog se puede cambiar de /show a /read cambiando el código solamente en una única ubicación. Antes, era necesario cambiar todo un archivo para cambiar el nombre. En Symfony2, incluso las URL son más flexibles.

            -
            -

            Por ahora, la aplicación ha evolucionado de un único archivo PHP, a una estructura organizada y permite la reutilización de código. Debes estar feliz, pero aún lejos de estar satisfecho. Por ejemplo, el sistema de «enrutado» es voluble, y no reconoce que la página list (/index.php) también debe ser accesible a través de / (si has agregado las reglas de reescritura de Apache). Además, en lugar de desarrollar el blog, una gran cantidad del tiempo se ha gastado trabajando en la «arquitectura» del código (por ejemplo, el enrutado, invocando controladores, plantillas, etc.) Se tendrá que gastar más tiempo para manejar el envío de formularios, validación de entradas, llevar la bitácora de sucesos y la seguridad. -¿Por qué tienes que reinventar soluciones a todos estos problemas rutinarios?

            -
            -
            -

            Añadiendo un toque Symfony2

            -

            Symfony2 al rescate. Antes de utilizar Symfony2 realmente, necesitas descargarlo. Esto se puede hacer utilizando Composer, el cual cuida de descargar la versión -correcta con todas sus dependencias y proporciona un cargador automático. Un cargador automático es una herramienta que permite empezar a utilizar clases PHP sin incluir explícitamente el archivo que contiene la clase.

            -

            En tu directorio raíz crea un archivo de texto llamado composer.json con el siguiente contenido:

            -
            {
-    "require": {
-        "symfony/symfony": "2.2.*"
-    },
-    "autoload": {
-        "files": ["model.php","controllers.php"]
-    }
-}
            -
            -

            Luego, descarga Composer y entonces ejecuta la siguiente orden, la cual descargará Symfony a un directorio vendor/:

            -
            $ php composer.phar install
-
            -
            -

            Junto con la descarga de tus dependencias, Composer genera un archivo vendor/autoload.php, el cual cuida de cargar automáticamente todos los archivos en la platafomra Symfony así como los archivos mencionados en la sección autoload de tu composer.json.

            -

            La esencia de la filosofía Symfony es la idea de que el trabajo principal de una aplicación es interpretar cada petición y devolver una respuesta. Con este fin, Symfony2 proporciona ambas clases Symfony\Component\HttpFoundation\Request y Symfony\Component\HttpFoundation\Response. Estas clases son representaciones orientadas a objetos de la petición HTTP que se está procesando y la respuesta HTTP que devolverá. Úsalas para mejorar el blog:

            -
            <?php
-// index.php
-require_once 'vendor/autoload.php';
-
-use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\HttpFoundation\Response;
-
-$request = Request::createFromGlobals();
-
-$uri = $request->getPathInfo();
-if ('/' == $uri) {
-    $response = list_action();
-} elseif ('/show' == $uri && $request->query->has('id')) {
-    $response = show_action($request->query->get('id'));
-} else {
-    $html = '<html><body><h1>Page Not Found</h1></body></html>';
-    $response = new Response($html, 404);
-}
-
-// difunde las cabeceras y envía la respuesta
-$response->send();
-
            -
            -

            Los controladores son responsables de devolver un objeto Respuesta. -Para facilitarnos esto, puedes agregar una nueva función render_template(), la cual, por cierto, actúa un poco como el motor de plantillas de Symfony2:

            -
            // controllers.php
-use Symfony\Component\HttpFoundation\Response;
-
-function list_action()
-{
-    $posts = get_all_posts();
-    $html = render_template('templates/list.php', array('posts' => $posts));
-
-    return new Response($html);
-}
-
-function show_action($id)
-{
-    $post = get_post_by_id($id);
-    $html = render_template('templates/show.php', array('post' => $post));
-
-    return new Response($html);
-}
-
-// función ayudante para reproducir plantillas
-function render_template($path, array $args)
-{
-    extract($args);
-    ob_start();
-    require $path;
-    $html = ob_get_clean();
-
-    return $html;
-}
-
            -
            -

            Al reunir una pequeña parte de Symfony2, la aplicación es más flexible y fiable. La Petición proporciona una manera confiable para acceder a información de la petición HTTP. Especialmente, el método getPathInfo() devuelve una URI limpia (siempre devolviendo /show y nunca /index.php/show). -Por lo tanto, incluso si el usuario va a /index.php/show, la aplicación es lo suficientemente inteligente para encaminar la petición hacia show_action().

            -

            El objeto Respuesta proporciona flexibilidad al construir la respuesta HTTP, permitiendo que las cabeceras HTTP y el contenido se agreguen a través de una interfaz orientada a objetos. -Y aunque las respuestas en esta aplicación son simples, esta flexibilidad pagará dividendos en cuanto tu aplicación crezca.

            -
            -
            -

            Aplicación de ejemplo en Symfony2

            -

            El blog ha avanzado, pero todavía contiene una gran cantidad de código para una aplicación tan simple. De paso, también inventamos un sencillo sistema de enrutado y un método utilizando ob_start() y ob_get_clean() para procesar plantillas. Si por alguna razón, necesitas continuar la construcción de esta «plataforma» desde cero, por lo menos puedes usar los componentes independientes Routing y Templating de Symfony, que resuelven estos problemas.

            -

            En lugar de volver a solucionar problemas comunes, puedes dejar que Symfony2 se preocupe de ellos por ti. Aquí está la misma aplicación de ejemplo, ahora construida en Symfony2:

            -
            // src/Acme/BlogBundle/Controller/BlogController.php
-namespace Acme\BlogBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class BlogController extends Controller
-{
-    public function listAction()
-    {
-        $posts = $this->get('doctrine')->getManager()
-            ->createQuery('SELECT p FROM AcmeBlogBundle:Post p')
-            ->execute();
-
-        return $this->render(
-            'AcmeBlogBundle:Blog:list.html.php',
-            array('posts' => $posts)
-        );
-    }
-
-    public function showAction($id)
-    {
-        $post = $this->get('doctrine')
-            ->getManager()
-            ->getRepository('AcmeBlogBundle:Post')
-            ->find($id)
-        ;
-
-        if (!$post) {
-            // provoca que se muestre la página de error 404
-            throw $this->createNotFoundException();
-        }
-
-        return $this->render(
-            'AcmeBlogBundle:Blog:show.html.php',
-            array('post' => $post)
-        );
-    }
-}
-
            -
            -

            Los dos controladores siguen siendo ligeros. Cada uno utiliza la biblioteca ORM de Doctrine para recuperar objetos de la base de datos y el componente Templating para reproducir una plantilla y devolver un objeto Respuesta. La plantilla list ahora es un poco más simple:

            -
            <!-- src/Acme/BlogBundle/Resources/views/Blog/list.html.php -->
-<?php $view->extend('::layout.html.php') ?>
-
-<?php $view['slots']->set('title', 'List of Posts') ?>
-
-<h1>List of Posts</h1>
-<ul>
-    <?php foreach ($posts as $post): ?>
-    <li>
-        <a href="<?php echo $view['router']->generate(
-            'blog_show',
-            array('id' => $post->getId())
-        ) ?>">
-            <?php echo $post->getTitle() ?>
-            </a>
-    </li>
-    <?php endforeach; ?>
-</ul>
-
            -
            -

            El diseño es casi idéntico:

            -
            <!-- app/Resources/views/layout.html.php -->
-<!DOCTYPE html>
-    <html>
-        <head>
-        <title><?php echo $view['slots']->output(
-            'title',
-            'Default title'
-        ) ?></title>
-        </head>
-        <body>
-        <?php echo $view['slots']->output('_content') ?>
-    </body>
-</html>
-
            -
            -
            -

            Nota

            -

            Te vamos a dejar como ejercicio la plantilla show, porque debería ser trivial crearla basándote en la plantilla list.

            -
            -

            Cuando arranca el motor Symfony2 (conocido como el núcleo), necesita un mapa para saber qué controladores ejecutar basándose en la información solicitada. -Un mapa de configuración de enrutado proporciona esta información en formato legible:

            -
            # app/config/routing.yml
-blog_list:
-    path:     /blog
-    defaults: { _controller: AcmeBlogBundle:Blog:list }
-
-blog_show:
-    path:     /blog/show/{id}
-    defaults: { _controller: AcmeBlogBundle:Blog:show }
-
            -
            -

            Ahora que Symfony2 se encarga de todas las tareas rutinarias, el controlador frontal es muy simple. Y debido a que hace tan poco, nunca tienes que volver a tocarlo una vez creado (y si utilizas una distribución Symfony2, ¡ni siquiera tendrás que crearlo!):

            -
            // web/app.php
-require_once __DIR__.'/../app/bootstrap.php';
-require_once __DIR__.'/../app/AppKernel.php';
-
-use Symfony\Component\HttpFoundation\Request;
-
-$kernel = new AppKernel('prod', false);
-$kernel->handle(Request::createFromGlobals())->send();
-
            -
            -

            El único trabajo del controlador frontal es iniciar el motor de Symfony2 (núcleo) y pasarle un objeto Petición para que lo manipule. El núcleo de Symfony2 entonces utiliza el mapa de enrutado para determinar qué controlador invocar. Al igual que antes, el método controlador es el responsable de devolver el objeto Respuesta final. -Realmente no hay mucho más sobre él.

            -

            Para conseguir una representación visual de cómo maneja Symfony2 cada petición, consulta el diagrama de flujo de la petición.

            -
            -
            -

            Qué más ofrece Symfony2

            -

            En los siguientes capítulos, aprenderás más acerca de cómo funciona cada pieza de Symfony y la organización recomendada de un proyecto. Por ahora, vamos a ver cómo, migrar el blog de PHP simple a Symfony2 nos ha mejorado la vida:

            -
              -
            • Tu aplicación cuenta con código claro y organizado consistentemente (aunque Symfony no te obliga a ello). Este promueve la reutilización y permite a los nuevos desarrolladores ser productivos en el proyecto con mayor rapidez.
              • -
            • 100% del código que escribes es para tu aplicación. No necesitas desarrollar o mantener servicios públicos de bajo nivel tal como la carga automática de clases, el enrutado o la reproducción de controladores;
              • -
            • Symfony2 te proporciona acceso a herramientas de código abierto tal como Doctrine, plantillas, seguridad, formularios, validación y componentes de traducción (por nombrar algunos);
              • -
            • La aplicación ahora disfruta de direcciones URL totalmente flexibles gracias al componente Routing;
              • -
            • La arquitectura centrada en HTTP de Symfony2 te da acceso a poderosas herramientas, tal como la memoria caché HTTP impulsadas por la caché HTTP interna de Symfony2 o herramientas más poderosas, tales como Varnish. Esto se trata posteriormente en el capítulo «todo sobre caché».
              • -
            -

            Y lo mejor de todo, utilizando Symfony2, ¡ahora tienes acceso a un conjunto de herramientas de código abierto de alta calidad desarrolladas por la comunidad Symfony2! -Puedes encontrar una buena colección de herramientas comunitarias de Symfony2 en KnpBundles.com.

            -
            -
            -
            -

            Mejores plantillas

            -

            Si decides utilizarlo, Symfony2 de serie viene con un motor de plantillas llamado Twig el cual hace que las plantillas se escriban más rápido y sean más fáciles de leer. -Esto significa que, incluso, ¡la aplicación de ejemplo podría contener mucho menos código! Toma por ejemplo, la plantilla list escrita en Twig:

            -
            {# src/Acme/BlogBundle/Resources/views/Blog/list.html.twig #}
-{% extends "::layout.html.twig" %}
-
-{% block title %}List of Posts{% endblock %}
-
-{% block body %}
-    <h1>List of Posts</h1>
-    <ul>
-        {% for post in posts %}
-        <li>
-            <a href="{{ path('blog_show', {'id': post.id}) }}">
-                {{ post.title }}
-                </a>
-        </li>
-        {% endfor %}
-    </ul>
-{% endblock %}
-
            -
            -

            También es fácil escribir la plantilla layout.html.twig correspondiente:

            -
            {# app/Resources/views/layout.html.twig #}
-<!DOCTYPE html>
-    <html>
-        <head>
-        <title>{% block title %}Default title{% endblock %}</title>
-        </head>
-        <body>
-        {% block body %}{% endblock %}
-    </body>
-</html>
-
            -
            -

            Twig es compatible con Symfony2. Y si bien, las plantillas PHP siempre contarán con el apoyo de Symfony2, vamos a seguir explicando muchas de las ventajas de Twig. Para más información, consulta el capítulo Plantillas.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/http_cache.html b/book/http_cache.html deleted file mode 100644 index 6b1965d..0000000 --- a/book/http_cache.html +++ /dev/null @@ -1,751 +0,0 @@ - - - - - - - Caché HTTP — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Caché HTTP

            -

            La naturaleza de las aplicaciones web ricas significa que son dinámicas. No importa qué tan eficiente sea tu aplicación, cada petición siempre contendrá más sobrecarga que simplemente servir un archivo estático.

            -

            Y para la mayoría de las aplicaciones Web, está bien. Symfony2 es tan rápido como el rayo, a menos que estés haciendo una muy complicada aplicación, cada petición se responderá rápidamente sin poner demasiada tensión a tu servidor.

            -

            Pero cuando tu sitio crezca, la sobrecarga general se puede convertir en un problema. El procesamiento que se realiza normalmente en cada petición se debe hacer sólo una vez. Este exactamente es el objetivo que tiene que consumar la memoria caché.

            -
            -

            La memoria caché en hombros de gigantes

            -

            La manera más efectiva para mejorar el rendimiento de una aplicación es memorizar en caché la salida completa de una página y luego eludir por completo la aplicación en cada petición posterior. Por supuesto, esto no siempre es posible para los sitios web altamente dinámicos, ¿o no? En este capítulo, te mostraremos cómo funciona el sistema de caché Symfony2 y por qué este es el mejor enfoque posible.

            -

            El sistema de cache Symfony2 es diferente porque se basa en la simplicidad y el poder de la caché HTTP tal como está definida en la especificación HTTP. -En lugar de reinventar una metodología de memoria caché, Symfony2 adopta la norma que define la comunicación básica en la Web. Una vez que comprendas los principios fundamentales de los modelos de caducidad y validación de la memoria caché HTTP, estarás listo para dominar el sistema de caché Symfony2.

            -

            Para efectos de aprender cómo guardar en caché con Symfony2, abordaremos el tema en cuatro pasos:

            -
              -
            1. Una pasarela de caché, o delegado inverso («proxy»), es una capa independiente situada frente a tu aplicación. La caché del delegado inverso responde a medida que son devueltas desde tu aplicación y contesta a peticiones con respuestas de la caché antes de que lleguen a tu aplicación. Symfony2 proporciona su propio delegado inverso, pero puedes utilizar cualquier delegado inverso.
              2. -
            2. Las cabeceras de cache HTTP se utilizan para comunicarse con la pasarela de caché y cualquier otra caché entre tu aplicación y el cliente. Symfony2 proporciona parámetros predeterminados y una potente interfaz para interactuar con las cabeceras de caché.
              3. -
            3. La caducidad y validación HTTP son los dos modelos utilizados para determinar si el contenido memorizado en caché es fresco (se puede reutilizar de la memoria caché) u obsoleto (lo debe regenerar la aplicación).
              4. -
            4. Inclusión del borde lateral (Edge Side Includes -ESI) permite que la caché HTTP utilice fragmentos de la página en caché (incluso fragmentos anidados) independientemente. -Con ESI, incluso puedes guardar en caché una página entera durante 60 minutos, pero una barra lateral integrada sólo por 5 minutos.
              5. -
            -

            Dado que la memoria caché HTTP no es exclusiva de Symfony, ya existen muchos artículos sobre el tema. Si eres novato en el tema de la memoria caché HTTP, te recomendamos el artículo de Ryan Tomayko Things Caches Do. Otro recurso que aborda el tema es la Guía de caché de Mark Nottingham.

            -
            -
            -

            Memoria caché con pasarela de caché

            -

            Cuándo memorizar caché con HTTP, la caché está separada de tu aplicación por completo y se sitúa entre tu aplicación y el cliente haciendo la petición.

            -

            El trabajo de la caché es aceptar las peticiones del cliente y pasarlas de nuevo a tu aplicación. La memoria caché también recibirá las respuestas devueltas por tu aplicación y las remitirá al cliente. La caché es el «geniecillo» de la comunicación petición-respuesta entre el cliente y tu aplicación.

            -

            De paso, la memoria caché almacena cada respuesta que se considere «almacenable en caché» (consulta Introducción a la memoria caché HTTP). Si de nuevo se solicita el mismo recurso, la memoria caché envía la respuesta memorizada en caché al cliente, eludiendo tu aplicación por completo.

            -

            Este tipo de caché se conoce como pasarela de caché HTTP y existen muchas como Varnish, Squid en modo delegado inverso y el delegado inverso de Symfony2.

            -
            -

            Tipos de Caché

            -

            Sin embargo, una pasarela de caché no es el único tipo de caché. De hecho, las cabeceras de caché HTTP enviadas por tu aplicación son consumidas e interpretadas por un máximo de tres diferentes tipos de caché:

            -
              -
            • Caché de navegadores: Cada navegador viene con su propia caché local, lo cual es realmente útil para cuando pulsas «atrás» o para imágenes y otros activos. -La caché del navegador es una caché privada, los recursos memorizados en caché no se comparten con nadie más;
              • -
            • Delegados de caché: Un delegado de caché compartida es aquel en el cual muchas personas pueden estar detrás de uno solo. Por lo general instalado por las grandes corporaciones y proveedores de Internet para reducir latencia y tráfico de red;
              • -
            • Pasarela de caché: Al igual que un delegado, también es una caché compartida pero en el lado del servidor. Instalada por los administradores de red, esta tiene sitios web más escalables, confiables y prácticos.
              • -
            -
            -

            Truco

            -

            Las pasarelas de caché a veces también se conocen como delegados inversos de caché, cachés alquiladas o incluso aceleradores HTTP.

            -
            -
            -

            Nota

            -

            La importancia de la caché privada frente a la compartida será más evidente a medida que hablemos de las respuestas en la memoria caché con contenido que es específico para un solo usuario (por ejemplo, información de cuenta).

            -
            -

            Cada respuesta de tu aplicación probablemente vaya a través de uno o los dos primeros tipos de caché. Estas cachés están fuera de tu control, pero siguen las instrucciones de la caché HTTP establecidas en la respuesta.

            -
            -
            -

            Delegado inverso de Symfony2

            -

            Symfony2 viene con un delegado inverso de caché (también conocido como pasarela de caché) escrito en PHP. Que al activarla, inmediatamente puede memorizar en caché respuestas de tu aplicación. La instalación es muy fácil. Cada nueva aplicación Symfony2 viene con una caché preconfigurada en el núcleo (AppCache) que envuelve al predeterminado (AppKernel). El núcleo de la memoria caché es el delegado inverso.

            -

            Para habilitar la memoria caché, modifica el código de un controlador frontal para utilizar la caché del núcleo:

            -
            // web/app.php
-require_once __DIR__.'/../app/bootstrap.php.cache';
-require_once __DIR__.'/../app/AppKernel.php';
-require_once __DIR__.'/../app/AppCache.php';
-
-use Symfony\Component\HttpFoundation\Request;
-
-$kernel = new AppKernel('prod', false);
-$kernel->loadClassCache();
-// envuelve el AppKernel predeterminado con un AppCache
-$kernel = new AppCache($kernel);
-$request = Request::createFromGlobals();
-$response = $kernel->handle($request);
-$response->send();
-$kernel->terminate($request, $response);
-
            -
            -

            La memoria caché del núcleo actúa de inmediato como un delegado inverso —memorizando en caché las respuestas de tu aplicación y devolviéndolas al cliente—.

            -
            -

            Truco

            -

            La caché del núcleo tiene un método especial getLog(), el cual devuelve una cadena que representa lo que sucedió en la capa de la caché. En el entorno de desarrollo, se usa para depurar y validar la estrategia de caché:

            -
            error_log($kernel->getLog());
-
            -
            -
            -

            El objeto AppCache tiene una sensible configuración predeterminada, pero la puedes afinar por medio de un conjunto de opciones que puedes configurar sustituyendo el método getOptions():

            -
            // app/AppCache.php
-use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache;
-
-class AppCache extends HttpCache
-{
-    protected function getOptions()
-    {
-        return array(
-            'debug'                  => false,
-            'default_ttl'            => 0,
-            'private_headers'        => array('Authorization', 'Cookie'),
-            'allow_reload'           => false,
-            'allow_revalidate'       => false,
-            'stale_while_revalidate' => 2,
-            'stale_if_error'         => 60,
-        );
-    }
-}
-
            -
            -
            -

            Truco

            -

            A menos que la sustituyas en getOptions(), la opción debug se establecerá automáticamente al valor de depuración del AppKernel envuelto.

            -
            -

            Aquí está una lista de las principales opciones:

            -
              -
            • default_ttl: El número de segundos que una entrada de caché se debe considerar nueva cuando no hay información fresca proporcionada explícitamente en una respuesta. Las cabeceras explícitas Cache-Control o Expires sustituyen este valor (predeterminado: 0);
              • -
            • private_headers: Conjunto de cabeceras de la petición que desencadenan el comportamiento Cache-Control «privado» en las respuestas en que no son clasificadas explícitamente como públicas o privadas vía una directiva Cache-Control. -(default: Authorization y cookie);
              • -
            • allow_reload: Especifica si el cliente puede forzar una recarga desde caché incluyendo una directiva Cache-Control «no-cache» en la petición. Selecciona true para cumplir con la RFC 2616 (por omisión: false);
              • -
            • allow_revalidate: Especifica si el cliente puede forzar una revalidación de caché incluyendo una directiva Cache-Control max-age = 0 en la petición. Ponla en true para cumplir con la RFC 2616 (por omisión: false);
              • -
            • stale_while_revalidate: Especifica el número de segundos predeterminado (la granularidad es el segundo puesto que la precisión de respuesta TTL es un segundo) durante el cual la memoria caché puede regresar inmediatamente una respuesta obsoleta mientras que revalida en segundo plano (por omisión: 2); este ajuste lo reemplaza stale-while-revalidate de la extensión HTTP Cache-Control (consulta la RFC 5.861);
              • -
            • stale_if_error: Especifica el número de segundos predeterminado (la granularidad es el segundo) durante el cual la caché puede servir una respuesta obsoleta cuando se detecta un error (por omisión: 60). Este valor lo reemplaza stale-if-error de la extensión HTTP Cache-Control (consulta la RFC 5861).
              • -
            -

            Si debug es true, Symfony2 automáticamente agrega una cabecera X-Symfony-Cache a la respuesta que contiene información útil acerca de aciertos y errores de caché.

            -
            -

            Cambiando de un delegado inverso a otro

            -

            El delegado inverso de Symfony2 es una gran herramienta a utilizar en el desarrollo de tu sitio web o al desplegar tu web en un servidor compartido donde no puedes instalar nada más allá que código PHP. Pero está escrito en PHP, y por lo tanto no puede ser tan rápido como un delegado escrito en C. Es por eso que recomendamos —de ser posible— usar Varnish o Squid en tus servidores de producción. La buena nueva es que el cambio de un servidor delegado a otro es fácil y transparente, sin modificar el código necesario en tu aplicación. Comienza fácilmente con el delegado inverso de Symfony2 y actualiza a Varnish cuando aumente el tráfico.

            -

            Para más información sobre el uso de Varnish con Symfony2, consulta el capítulo Cómo usar Varnish en el recetario.

            -
            -
            -

            Nota

            -

            El rendimiento del delegado inverso de Symfony2 es independiente de la complejidad de tu aplicación. Eso es porque el núcleo de tu aplicación sólo se inicia cuando la petición se debe remitir a ella.

            -
            -
            -
            -
            -

            Introducción a la memoria caché HTTP

            -

            Para aprovechar las ventajas de las capas de memoria caché disponibles, tu aplicación se debe poder comunicar con las respuestas que son memorizables y las reglas que rigen cuándo y cómo la caché será obsoleta. Esto se hace ajustando las cabeceras de caché HTTP en la respuesta.

            -
            -

            Truco

            -

            Ten en cuenta que HTTP no es más que el lenguaje (un lenguaje de texto simple) que los clientes web (navegadores, por ejemplo) y los servidores web utilizan para comunicarse entre sí. Cuando hablamos de la memoria caché HTTP, estamos hablando de la parte de ese lenguaje que permite a los clientes y servidores intercambiar información relacionada con la memoria caché.

            -
            -

            HTTP especifica cuatro cabeceras de caché para respuestas en las que estamos interesados aquí:

            -
              -
            • Cache-Control
              • -
            • Expires
              • -
            • ETag
              • -
            • Last-Modified
              • -
            -

            La cabecera más importante y versátil es la cabecera Cache-Control, la cual en realidad es una colección de variada información de caché.

            -
            -

            Nota

            -

            Cada una de las cabeceras se explica en detalle en la sección Caducidad y validación HTTP.

            -
            -
            -

            La cabecera Cache-Control

            -

            La cabecera Cache-Control es la única que no contiene una, sino varias piezas de información sobre la memoria caché de una respuesta. Cada pieza de información está separada por una coma:

            -
            Cache-Control: private, max-age=0, must-revalidate
-
-Cache-Control: max-age=3600, must-revalidate
-
            -
            -

            Symfony proporciona una abstracción de la cabecera Cache-Control para hacer más manejable su creación:

            -
            // ...
-
-use Symfony\Component\HttpFoundation\Response;
-
-$response = new Response();
-
-// marca la respuesta como pública o privada
-$response->setPublic();
-$response->setPrivate();
-
-// fija la edad máxima de privado o compartido
-$response->setMaxAge(600);
-$response->setSharedMaxAge(600);
-
-// fija una directiva Cache-Control personalizada
-$response->headers->addCacheControlDirective('must-revalidate', true);
-
            -
            -
            -
            -

            Respuestas públicas frente a privadas

            -

            Ambas, la pasarela de caché y el delegado de caché, son considerados como cachés «compartidas» debido a que el contenido memorizado en caché se comparte con más de un usuario. Si cada vez equivocadamente una memoria caché compartida almacena una respuesta específica al usuario, posteriormente la puede devolver a cualquier cantidad de usuarios diferentes. ¡Imagina si la información de tu cuenta se memoriza en caché y luego la regresa a todos los usuarios posteriores que soliciten la página de su cuenta!

            -

            Para manejar esta situación, cada respuesta se puede fijar para que sea pública o privada:

            -
              -
            • public: Indica que la respuesta se puede memorizar en caché por ambas cachés privadas y compartidas;
              • -
            • private: Indica que la totalidad o parte del mensaje de la respuesta es para un solo usuario y no se debe memorizar en caché en una caché compartida.
              • -
            -

            Por omisión, Symfony conservadoramente fija cada respuesta para que sea privada. Para aprovechar las ventajas de las cachés compartidas (como el delegado inverso de Symfony2), explícitamente deberás fijar la respuesta como pública.

            -
            -
            -

            Métodos seguros

            -

            La memoria caché HTTP sólo funciona para métodos HTTP «seguros» (como GET y HEAD). Estar seguro significa que nunca cambia de estado la aplicación en el servidor al servir la petición (por supuesto puedes registrar información, datos de la caché, etc.) -Esto tiene dos consecuencias muy razonables:

            -
              -
            • Nunca debes cambiar el estado de tu aplicación al responder a una petición GET o HEAD. Incluso si no utilizas una pasarela caché, la presencia del delegado de caché significa que alguna petición GET o HEAD puede o no llegar a tu servidor;
              • -
            • No esperes que haya métodos PUT, POST o DELETE en caché. Estos métodos están diseñados para utilizarse al mutar el estado de tu aplicación (por ejemplo, borrar una entrada de blog). La memoria caché debe impedir que determinadas peticiones toquen y muten tu aplicación.
              • -
            -
            -
            -

            Reglas de caché y valores predeterminados

            -

            HTTP 1.1 por omisión, permite memorizar en caché cualquier cosa a menos que haya una cabecera Cache-Control explícita. En la práctica, la mayoría de las cachés no hacen nada cuando las peticiones tienen una galleta, una cabecera de autorización, utilizan un método no seguro (es decir, PUT, POST, DELETE), o cuando las respuestas tienen código de redirección de estado.

            -

            Symfony2 automáticamente establece una sensible y conservadora cabecera Cache-Control cuando esta no está definida por el desarrollador, siguiendo estas reglas:

            -
              -
            • Si no has definido cabecera caché (Cache-Control, Expires, ETag o Last-Modified), Cache-Control es establecida en no-cache, lo cual significa que la respuesta no se guarda en caché;
              • -
            • Si Cache-Control está vacía (pero una de las otras cabeceras de caché está presente), su valor se establece en private, must-revalidate;
              • -
            • Pero si por lo menos una directiva Cache-Control está establecida, y no se han añadido directivas public o private de forma explícita, Symfony2 agrega la directiva private automáticamente (excepto cuando s-maxage está establecida).
              • -
            -
            -
            -
            -

            Caducidad y validación HTTP

            -

            La especificación HTTP define dos modelos de memoria caché:

            -
              -
            • Con el modelo de caducidad, sólo tienes que especificar el tiempo en que la respuesta se debe considerar «fresca» incluyendo una cabecera Cache-Control y/o una Expires. Las cachés que entienden de expiración no harán la misma petición hasta que la versión en caché alcance el límite de caducidad y se vuelva «obsoleta»;
              • -
            • Cuando las páginas realmente son dinámicas (es decir, su representación cambia con mucha frecuencia), a menudo es necesario el modelo de validación. Con este modelo, la memoria caché memoriza la respuesta, pero, pregunta al servidor en cada petición si la respuesta memorizada sigue siendo válida. La aplicación utiliza un identificador de respuesta único (la cabecera Etag) y/o una marca de tiempo (la cabecera Last-Modified) para comprobar si la página ha cambiado desde su memorización en caché.
              • -
            -

            El objetivo de ambos modelos es nunca generar la misma respuesta en dos ocasiones dependiendo de una caché para almacenar y devolver respuestas «frescas».

            -
            -

            Leyendo la especificación HTTP

            -

            La especificación HTTP define un sencillo pero potente lenguaje con el cual clientes y servidores se pueden comunicar. Como desarrollador web, el modelo petición-respuesta de la especificación domina tu trabajo. Lamentablemente, el documento de la especificación real —RFC 2616— puede ser difícil de leer.

            -

            Hay un esfuerzo en curso (HTTP Bis) para reescribir la RFC 2616. Este no describe una nueva versión de HTTP, sino sobre todo aclara la especificación HTTP original. La organización también se ha mejorado ya que la especificación se divide en siete partes; todo lo relacionado con la caché HTTP se puede encontrar en dos partes dedicadas (P4 - Petición condicional y P6 - Caché: Navegador y caché intermedia).

            -

            Como desarrollador web, estás invitado a leer la especificación. Su claridad y poder —incluso más de diez años después de su creación— tiene un valor incalculable. No te desanimes por la apariencia de la especificación —su contenido es mucho más bello que la cubierta—.

            -
            -
            -

            Caducidad

            -

            El modelo de caducidad es el más eficiente y simple de los dos modelos de memoria caché y se debe utilizar siempre que sea posible. Cuando una respuesta se memoriza en caché con una caducidad, la caché memorizará la respuesta y la enviará directamente sin tocar a la aplicación hasta que esta caduque.

            -

            El modelo de caducidad se puede lograr usando una de dos, casi idénticas, cabeceras HTTP: Expires o Cache-Control.

            -
            -
            -

            Caducidad con la cabecera Expires

            -

            De acuerdo con la especificación HTTP «el campo de la cabecera Expires da la fecha/hora después de la cual se considera que la respuesta es vieja». La cabecera Expires se puede establecer con el método setExpires() de la Respuesta. Esta necesita una instancia de DateTime como argumento:

            -
            $fecha = new DateTime();
-$date->modify('+600 seconds');
-
-$response->setExpires($date);
-
            -
            -

            La cabecera HTTP resultante se ve de la siguiente manera:

            -
            Expires: Thu, 01 Mar 2011 16:00:00 GMT
-
            -
            -
            -

            Nota

            -

            El método setExpires() automáticamente convierte la fecha a la zona horaria GMT como lo requiere la especificación.

            -
            -

            Ten en cuenta que en las versiones de HTTP anteriores a la 1.1 el servidor origen no estaba obligado a enviar la cabecera Date. En consecuencia, la memoria caché (por ejemplo el navegador) podría -necesitar de contar en su reloj local para evaluar la cabecera Expires tomando el cálculo de la vida vulnerable para desviaciones del reloj. Otra limitación de la cabecera Expires es que la especificación establece que «Los servidores HTTP/1.1 no deben enviar fechas de más de un año en el futuro en Expires».

            -
            -
            -

            Caducidad con la cabecera Cache-Control

            -

            Debido a las limitaciones de la cabecera Expires, la mayor parte del tiempo, debes usar la cabecera Cache-Control en su lugar. Recordemos que la cabecera Cache-Control se utiliza para especificar muchas directivas de caché diferentes. Para caducidad, hay dos directivas, max-age y s-maxage. La primera la utilizan todas las cachés, mientras que la segunda sólo se tiene en cuenta por las cachés compartidas:

            -
            // Establece el número de segundos después de que la
-// respuesta ya no se debe considerar fresca
-$response->setMaxAge(600);
-
-// Lo mismo que la anterior pero sólo para cachés compartidas
-$response->setSharedMaxAge(600);
-
            -
            -

            La cabecera Cache-Control debería tener el siguiente formato (esta puede tener directivas adicionales):

            -
            Cache-Control: max-age=600, s-maxage=600
-
            -
            -
            -
            -

            Validando

            -

            Cuando un recurso se tiene que actualizar tan pronto como se realiza un cambio en los datos subyacentes, el modelo de caducidad se queda corto. Con el modelo de caducidad, no se pedirá a la aplicación que devuelva la respuesta actualizada hasta que la caché finalmente se convierta en obsoleta.

            -

            El modelo de validación soluciona este problema. Bajo este modelo, la memoria caché sigue almacenando las respuestas. La diferencia es que, por cada petición, la caché pregunta a la aplicación cuando o no la respuesta memorizada sigue siendo válida. Si la caché todavía es válida, tu aplicación debe devolver un código de estado 304 y no el contenido. Esto le dice a la caché que está bien devolver la respuesta memorizada.

            -

            Bajo este modelo, sobre todo ahorras ancho de banda ya que la representación no se envía dos veces al mismo cliente (en su lugar se envía una respuesta 304). Pero si diseñas cuidadosamente tu aplicación, es posible que puedas obtener los datos mínimos necesarios para enviar una respuesta 304 y ahorrar CPU también (más abajo puedes ver una implementación de ejemplo).

            -
            -

            Truco

            -

            El código de estado 304 significa «No Modificado». Es importante porque este código de estado no tiene el contenido real solicitado. -En cambio, la respuesta simplemente es un ligero conjunto de instrucciones que indican a la caché que se debe utilizar la versión almacenada.

            -
            -

            Al igual que con la caducidad, hay dos diferentes cabeceras HTTP que puedes utilizar para implementar el modelo de validación: Etag y Last-Modified.

            -
            -
            -

            Validando con la cabecera ETag

            -

            La cabecera ETag es una cabecera de cadena (llamada «entidad-etiqueta») que identifica unívocamente una representación del recurso destino. Este es generado completamente y establecido por tu aplicación de modo que puedes decir, por ejemplo, si el recurso memorizado /sobre está al día con el que tu aplicación iba a devolver. Una ETag es como una huella digital y se utiliza para comparar rápidamente si dos versiones diferentes de un recurso son equivalentes. Como las huellas digitales, cada ETag debe ser única en todas las representaciones de un mismo recurso.

            -

            Para ver una sencilla implementación, genera la ETag como el md5 del contenido:

            -
            public function indexAction()
-{
-    $response = $this->render('MyBundle:Main:index.html.twig');
-    $response->setETag(md5($response->getContent()));
-    $response->setPublic(); // verifica que la respuesta es púbica/susceptible de guardar en caché
-    $response->isNotModified($this->getRequest());
-
-    return $response;
-}
-
            -
            -

            El método isNotModified() compara la ETag enviada en la Petición con la configurada en la Respuesta. Si ambas coinciden, el método automáticamente establece el código de estado de la Respuesta a 304.

            -

            Este algoritmo es bastante simple y muy genérico, pero es necesario crear la Respuesta completa antes de ser capaz de calcular la ETag, lo cual es subóptimo. -En otras palabras, esta ahorra ancho de banda, pero no ciclos de la CPU.

            -

            En la sección Optimizando tu código con validación, te mostraré cómo puedes utilizar la validación de manera más inteligente para determinar la validez de una caché sin hacer tanto trabajo.

            -
            -

            Truco

            -

            Symfony2 también apoya ETags débiles pasando true como segundo argumento del método setETag().

            -
            -
            -
            -

            Validando con la cabecera Last-Modified

            -

            La cabecera Last-Modified es la segunda forma de validación. De acuerdo con la especificación HTTP, «El campo de la cabecera Last-Modified indica la fecha y hora en que el servidor origen considera que la representación fue modificada por última vez». En otras palabras, la aplicación decide si o no el contenido memorizado se ha actualizado en función de sí o no se ha actualizado desde que la respuesta entró en caché.

            -

            Por ejemplo, puedes utilizar la última fecha de actualización de todos los objetos necesarios para calcular la representación del recurso como valor para el valor de la cabecera Last-Modified:

            -
            public function showAction($articleSlug)
-{
-    // ...
-
-    $articleDate = new \DateTime($article->getUpdatedAt());
-    $authorDate = new \DateTime($author->getUpdatedAt());
-
-    $date = $authorDate > $articleDate ? $authorDate : $articleDate;
-
-    $response->setLastModified($date);
-    // Ajusta la respuesta como pública. De lo contrario será privada por omisión.
-    $response->setPublic();
-
-    if ($response->isNotModified($this->getRequest())) {
-        return $response;
-    }
-
-    // ... hace más trabajo para poblar la respuesta con el contenido completo
-
-    return $response;
-}
-
            -
            -

            El método isNotModified() compara la cabecera If-Modified-Since enviada por la petición con la cabecera Last-Modified configurada en la respuesta. Si son equivalentes, la Respuesta establecerá un código de estado 304.

            -
            -

            Nota

            -

            La cabecera If-Modified-Since de la petición es igual a la cabecera Last-Modified de la última respuesta enviada al cliente por ese recurso en particular. -Así es como se comunican el cliente y el servidor entre ellos y deciden si el recurso se ha actualizado desde que se memorizó.

            -
            -
            -
            -

            Optimizando tu código con validación

            -

            El objetivo principal de cualquier estrategia de memoria caché es aligerar la carga de la aplicación. -Dicho de otra manera, cuanto menos hagas en tu aplicación para devolver una respuesta 304, mejor. El método Response::isNotModified() hace exactamente eso al exponer un patrón simple y eficiente:

            -
            use Symfony\Component\HttpFoundation\Response;
-
-public function showAction($articleSlug)
-{
-    // Obtiene la mínima información para calcular la ETag
-    // o el valor de Last-Modified (basado en la petición,
-    // los datos se recuperan de una base de datos o un par
-    // clave-valor guardado, por ejemplo)
-    $article = ...;
-
-    // crea una respuesta con una cabecera ETag y/o Last-Modified
-    $response = new Response();
-    $response->setETag($article->computeETag());
-    $response->setLastModified($article->getPublishedAt());
-
-    // Ajusta la respuesta como pública. De lo contrario será privada por omisión.
-    $response->setPublic();
-
-    // verifica que la respuesta no se ha modificado para la petición dada
-    if ($response->isNotModified($this->getRequest())) {
-        // devuelve la instancia de la aplicación
-        return $response;
-    } else {
-        // aquí haz algo más - como recuperar más datos
-        $comments = ...;
-
-        // o reproduce una plantilla con la $response que acabas de iniciar
-        return $this->render(
-            'MyBundle:MyController:article.html.twig',
-            array('article' => $article, 'comments' => $comments),
-            $response
-        );
-    }
-}
-
            -
            -

            Cuando la Respuesta no es modificada, el isNotModified() automáticamente fija el código de estado de la respuesta a 304, remueve el contenido, y remueve algunas cabeceras que no deben estar presentes en respuestas 304 (consulta -setNotModified()).

            -
            -
            -

            Variando la respuesta

            -

            Hasta ahora, asumiste que cada URI tiene exactamente una representación del recurso destino. De forma predeterminada, la caché HTTP se memoriza usando la URI del recurso como la clave de la caché. Si dos personas solicitan la misma URI de un recurso memorizable, la segunda persona recibirá la versión en caché.

            -

            A veces esto no es suficiente y se necesita memorizar en caché diferentes versiones de la misma URI basándose en uno o más valores de las cabeceras de la petición. Por ejemplo, si comprimes las páginas cuando el cliente lo permite, cualquier URI tiene dos representaciones: -una cuando el cliente es compatible con la compresión, y otra cuando no. Esta determinación se hace por el valor de la cabecera Accept-Encoding de la petición.

            -

            En este caso, necesitas que la memoria almacene una versión comprimida y otra sin comprimir de la respuesta para la URI particular y devolverlas basándose en el valor de la cabecera Accept-Encoding. Esto se hace usando la cabecera Vary de la respuesta, la cual es una lista separada por comas de diferentes cabeceras cuyos valores lanzan una diferente representación de los recursos solicitados:

            -
            Vary: Accept-Encoding, User-Agent
-
            -
            -
            -

            Truco

            -

            Esta cabecera Vary particular debería memorizar diferentes versiones de cada recurso en base a la URI y el valor de las cabeceras Accept-Encoding y User-Agent de la petición.

            -
            -

            El objeto Respuesta ofrece una interfaz limpia para gestionar la cabecera Vary:

            -
            // establece una cabecera vary
-$response->setVary('Accept-Encoding');
-
-// establece múltiples cabeceras vary
-$response->setVary(array('Accept-Encoding', 'User-Agent'));
-
            -
            -

            El método setVary() toma un nombre de cabecera o un arreglo de nombres de cabecera de cual respuesta varía.

            -
            -
            -

            Caducidad y validación

            -

            Por supuesto, puedes utilizar tanto la caducidad como la validación de la misma Respuesta. -La caducidad gana a la validación, te puedes beneficiar de lo mejor de ambos mundos. En otras palabras, utilizando tanto la caducidad como la validación, puedes instruir a la caché para que sirva el contenido memorizado, mientras que revisas de nuevo algún intervalo (de caducidad) para verificar que el contenido sigue siendo válido.

            -
            -
            -

            Más métodos de respuesta

            -

            La clase Respuesta proporciona muchos métodos más relacionados con la caché. Estos son los más útiles:

            -
            // Marca la respuesta como obsoleta
-$response->expire();
-
-// Fuerza a la respuesta a devolver una adecuada respuesta 304 sin contenido
-$response->setNotModified();
-
            -
            -

            Adicionalmente, puedes configurar muchas de las cabeceras HTTP relacionadas con la caché a través del único método setCache():

            -
            // Establece la configuración de caché en una llamada
-$response->setCache(array(
-    'etag'          => $etag,
-    'last_modified' => $date,
-    'max_age'       => 10,
-    's_maxage'      => 10,
-    'public'        => true,
-    // 'private'    => true,
-));
-
            -
            -
            -
            -
            -

            Usando inclusión del borde lateral

            -

            Las pasarelas de caché son una excelente forma de hacer que tu sitio web tenga un mejor desempeño. Pero tienen una limitación: sólo pueden memorizar páginas enteras. Si no puedes memorizar todas las páginas o si partes de una página tienen «más» elementos dinámicos, se te acabó la suerte. Afortunadamente, Symfony2 ofrece una solución para estos casos, basada ​​en una tecnología llamada ESI, o Inclusión de bordes laterales («Edge Side Includes»). Akamaï escribió esta especificación hace casi 10 años, y esta permite que partes específicas de una página tengan una estrategia de memorización diferente a la de la página principal.

            -

            La especificación ESI describe las etiquetas que puedes incrustar en tus páginas para comunicarte con la pasarela de caché. Symfony2 sólo implementa una etiqueta, include, ya que es la única útil fuera del contexto de Akamaï:

            -
            <!DOCTYPE html>
-    <html>
-        <body>
-        <!-- ... algún contenido -->
-
-        <!-- Aquí incluye el contenido de otra página -->
-        <esi:include src="http://..." />
-
-        <!-- ... más contenido -->
-    </body>
-</html>
-
            -
            -
            -

            Nota

            -

            Observa que en el ejemplo cada etiqueta ESI tiene una URL completamente cualificada. -Una etiqueta ESI representa un fragmento de página que se puede recuperar a través de la URL.

            -
            -

            Cuando se maneja una petición, la pasarela de caché obtiene toda la página de su caché o la pide a partir de la interfaz de administración de tu aplicación. Si la respuesta contiene una o más etiquetas ESI, estas se procesan de la misma manera. En otras palabras, la pasarela caché o bien, recupera el fragmento de página incluida en su caché o de nuevo pide el fragmento de página desde la interfaz de administración de tu aplicación. Cuando se han resuelto todas las etiquetas ESI, la pasarela caché une cada una en la página principal y envía el contenido final al cliente.

            -

            Todo esto sucede de forma transparente a nivel de la pasarela caché (es decir, fuera de tu aplicación). Como verás, si decides tomar ventaja de las etiquetas ESI, Symfony2 hace que el proceso de incluirlas sea casi sin esfuerzo.

            -
            -

            Usando ESI en Symfony2

            -

            Primero, para usar ESI, asegúrate de activarlo en la configuración de tu aplicación:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    # ...
-    esi: { enabled: true }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config ...>
-    <!-- ... -->
-    <framework:esi enabled="true" />
-</framework:config>
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    // ...
-    'esi'    => array('enabled' => true),
-));
-
              -
              -
              • -
            -
            -

            Ahora, supongamos que tenemos una página que es relativamente estática, salvo por un teletipo de noticias en la parte inferior del contenido. Con ESI, puedes memorizar el teletipo de noticias independientemente del resto de la página.

            -
            public function indexAction()
-{
-    $response = $this->render('MyBundle:MyController:index.html.twig');
-    // Pone el tiempo compartido máximo - el cual además marca la respuesta como pública
-    $response->setSharedMaxAge(600);
-
-    return $response;
-}
-
            -
            -

            En este ejemplo, la caché de la página completa tiene un tiempo de vida de diez minutos. -En seguida, incluirás el teletipo de noticias en la plantilla incorporando una acción. -Esto se hace a través del ayudante render (Consulta Integrando controladores para más detalles).

            -

            Como el contenido integrado viene de otra página (o controlador en este caso), Symfony2 utiliza el ayudante render estándar para configurar las etiquetas ESI:

            -
            -
              -
            • Twig
              {# puedes usar una referencia al controlador #}
-{{ render_esi(controller('...:news', { 'max': 5 })) }}
-
-{# ... o una URL #}
-{{ render_esi(url('latest_news', { 'max': 5 })) }}
-
              -
              -
              • -
            • PHP
              <?php echo $view['actions']->render(
-    new ControllerReference('...:news', array('max' => 5)),
-    array('renderer' => 'esi'))
-?>
-
-<?php echo $view['actions']->render(
-    $view['router']->generate('latest_news', array('max' => 5), true),
-    array('renderer' => 'esi'),
-) ?>
-
              -
              -
              • -
            -
            -

            Al utilizar el esi reproducido (vía la función render_esi de Twig), le dices a Symfony2 que la acción se debería reproducir como una etiqueta ESI. Te podrías estar preguntando por qué querrías utilizar un ayudante en vez de sólo escribir la etiqueta ESI directamente. Esto se debe a que al utilizar un ayudante haces que tu aplicación trabaje incluso si no tienes instalada ninguna pasarela de caché.

            -

            Al utilizar la función render predefinida (o configurar la estrategia a inline), Symfony2 fusiona el contenido de la página incluida con la principal antes de enviar la respuesta al cliente. Pero si utilizas la estrategia esi (es decir, llamas a render_esi), y si Symfony2 detecta que está hablando con una pasarela de caché que cuenta con soporte ESI, genera una etiqueta que incluye ESI. Pero si no hay ninguna pasarela de caché o si no cuenta con soporte ESI, Symfony2 sólo fusionará el contenido de la página incluida dentro de la principal tal como lo haría si hubieras utilizado render.

            -
            -

            Nota

            -

            Symfony2 detecta si una pasarela caché admite ESI a través de otra especificación Akamaï que fuera de la caja es compatible con el delegado inverso de Symfony2.

            -
            -

            La acción integrada ahora puede especificar sus propias reglas de caché, totalmente independientes de la página principal.

            -
            public function newsAction($max)
-{
-    // ...
-
-    $response->setSharedMaxAge(60);
-}
-
            -
            -

            Con ESI, la caché de la página completa será válida durante 600 segundos, pero la caché del componente de noticias sólo dura 60 segundos.

            -

            Cuándo utilizas una referencia al controlador, la etiqueta ESI se debe referir a la acción incorporada como una URL accesible a modo de que la pasarela de caché la pueda recuperar independientemente del resto de la página. Symfony2 cuida de generar una URL única para cualquier referencia de controlador y es capaz de enrutarla correctamente gracias a un escucha que debes habilitar en tu configuración:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    # ...
-    fragments: { path: /_fragment }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config>
-    <framework:fragments path="/_fragment" />
-</framework:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    // ...
-    'fragments' => array('path' => '/_fragment'),
-));
-
              -
              -
              • -
            -
            -

            Una gran ventaja de estrategia ESI es que puedes hacer tu aplicación tan dinámica como sea necesario y al mismo tiempo, tocar la aplicación lo menos posible.

            -
            -

            Truco

            -

            El escucha sólo responde a direcciones IP locales o a delegados inversos confiables.

            -
            -
            -

            Nota

            -

            Una vez que comiences a usar ESI, recuerda usar siempre la directiva s-maxage en lugar de max-age. Como el navegador nunca recibe recursos agregados, no es consciente del subcomponente, y por lo tanto obedecerá la directiva max-age y memorizará la página completa. Y no quieres eso.

            -
            -

            El ayudante render_esi apoya otras dos útiles opciones:

            -
              -
            • alt: utilizada como el atributo alt en la etiqueta ESI, el cual te permite especificar una URL alternativa para utilizarla si no se puede encontrar src;
              • -
            • ignore_errors: si la fijas a true, se agrega un atributo onerror a la ESI con un valor de continue indicando que, en caso de una falla, la pasarela caché simplemente debe eliminar la etiqueta ESI silenciosamente.
              • -
            -
            -
            -
            -

            Invalidando la caché

            -
            -
            «Sólo hay dos cosas difíciles en Ciencias de la Computación: Invalidación de caché y nombrar cosas» –Phil Karlton
            -

            Nunca debería ser necesario invalidar los datos memorizados en caché porque la invalidación ya se tiene en cuenta de forma nativa en los modelos de caché HTTP. Si utilizas la validación, por definición, no será necesario invalidar ninguna cosa; y si utilizas la caducidad y necesitas invalidar un recurso, significa que estableciste la fecha de caducidad muy adelante en el futuro.

            -
            -

            Nota

            -

            Debido a que la invalidación es un tema específico de cada tipo de delegado inverso, si no te preocupa la invalidación, puedes cambiar entre los delegados inversos sin cambiar nada en el código de tu aplicación.

            -
            -

            En realidad, todos los delegados inversas proporcionan una manera de purgar datos almacenados en caché, pero lo debes evitar tanto como sea posible. La forma más habitual es purgar la caché de una URL dada solicitándola con el método especial PURGE de HTTP.

            -

            Aquí está cómo puedes configurar la caché del delegado inverso de Symfony2 para apoyar el método PURGE de HTTP:

            -
            // app/AppCache.php
-
-// ...
-use Symfony\Bundle\FrameworkBundle\HttpCache\HttpCache;
-use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\HttpFoundation\Response;
-
-class AppCache extends HttpCache
-{
-    protected function invalidate(Request $request, $catch = false)
-    {
-        if ('PURGE' !== $request->getMethod()) {
-            return parent::invalidate($request, $catch);
-        }
-
-        $response = new Response();
-        if (!$this->getStore()->purge($request->getUri())) {
-            $response->setStatusCode(404, 'Not purged');
-        } else {
-            $response->setStatusCode(200, 'Purged');
-        }
-
-        return $response;
-    }
-}
-
            -
            -
            -

            Prudencia

            -

            De alguna manera, debes proteger el método PURGE de HTTP para evitar que alguien aleatoriamente purgue los datos memorizados.

            -
            -
            -
            -

            Resumen

            -

            Symfony2 fue diseñado para seguir las reglas probadas de la carretera: HTTP. El almacenamiento en caché no es una excepción. Dominar el sistema caché de Symfony2 significa familiarizarse con los modelos de caché HTTP y usarlos eficientemente. Esto significa que, en lugar de confiar sólo en la documentación de Symfony2 y ejemplos de código, tienes acceso a un mundo de conocimientos relacionados con la memorización en caché HTTP y la pasarela caché, tal como Varnish.

            -
            -
            -

            Aprende más en el recetario

            - -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/http_fundamentals.html b/book/http_fundamentals.html deleted file mode 100644 index df90759..0000000 --- a/book/http_fundamentals.html +++ /dev/null @@ -1,457 +0,0 @@ - - - - - - - Symfony2 y fundamentos HTTP — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Symfony2 y fundamentos HTTP

            -

            ¡Enhorabuena! Al aprender acerca de Symfony2, vas bien en tu camino para llegar a ser un más productivo, bien enfocado y popular desarrollador web (en realidad, en la última parte, estás por tu cuenta). Symfony2 está diseñado para volver a lo básico: las herramientas de desarrollo que te permiten desarrollar más rápido y construir aplicaciones más robustas, mientras que permanece fuera de tu camino. Symfony está basado en las mejores ideas de muchas tecnologías: las herramientas y conceptos que estás a punto de aprender representan el esfuerzo de miles de personas, durante muchos años. En otras palabras, no estás aprendiendo «Symfony», estás aprendiendo los fundamentos de la web, buenas prácticas de desarrollo, y cómo utilizar muchas nuevas y asombrosas bibliotecas PHP, dentro o independientemente de Symfony2. Por lo tanto, ¡prepárate!

            -

            Fiel a la filosofía Symfony2, este capítulo comienza explicando el concepto fundamental común para el desarrollo web: HTTP. Independientemente de tus antecedentes o lenguaje de programación preferido, este capítulo es una lectura obligada para todo mundo.

            -
            -

            HTTP es Simple

            -

            HTTP («HyperText Transfer Protocol» para los apasionados y, en Español Protocolo de transferencia hipertexto) es un lenguaje de texto que permite a dos máquinas comunicarse entre sí. ¡Eso es todo! Por ejemplo, al comprobar las últimas noticias acerca de cómica xkcd, la siguiente conversación (aproximadamente) se lleva a cabo:

            -../_images/http-xkcd_es.png -

            Y aunque el lenguaje real utilizado es un poco más formal, sigue siendo bastante simple. -HTTP es el término utilizado para describir este lenguaje simple basado en texto. Y no importa cómo desarrolles en la web, el objetivo de tu servidor siempre es entender las peticiones de texto simple, y devolver respuestas en texto simple.

            -

            Symfony2 está construido basado en torno a esa realidad. Ya sea que te des cuenta o no, HTTP es algo que usas todos los días. Con Symfony2, aprenderás a dominarlo.

            -
            -

            Paso 1: El cliente envía una petición

            -

            Todas las conversaciones en la web comienzan con una petición. La petición es un mensaje de texto creado por un cliente (por ejemplo un navegador, una aplicación para el iPhone, etc.) en un formato especial conocido como HTTP. El cliente envía la petición a un servidor, y luego espera la respuesta.

            -

            Echa un vistazo a la primera parte de la interacción (la petición) entre un navegador y el servidor web xkcd:

            -../_images/http-xkcd-request_es.png -

            Hablando en HTTP, esta petición HTTP en realidad se vería algo parecida a esto:

            -
            GET / HTTP/1.1
-Host: xkcd.com
-Accept: text/html
-User-Agent: Mozilla/5.0 (Macintosh)
-
            -
            -

            Este sencillo mensaje comunica todo lo necesario sobre qué recursos exactamente solicita el cliente. La primera línea de una petición HTTP es la más importante y contiene dos cosas: la URI y el método HTTP.

            -

            La URI (por ejemplo, /, /contact, etc.) es la dirección o ubicación que identifica unívocamente al recurso que el cliente quiere. El método HTTP (por ejemplo, GET) define lo que quieres hacer con el recurso. Los métodos HTTP son los verbos de la petición y definen las pocas formas más comunes en que puedes actuar sobre el recurso:

            - ---- - - - - - - - - - - - - - - -
            GETRecupera el recurso desde el servidor
            POSTCrea un recurso en el servidor
            PUTActualiza el recurso en el servidor
            DELETEElimina el recurso del servidor
            -

            Con esto en mente, te puedes imaginar que una petición HTTP podría ser similar a eliminar una entrada de blog específica, por ejemplo:

            -
            DELETE /blog/15 HTTP/1.1
-
            -
            -
            -

            Nota

            -

            En realidad, hay nueve métodos HTTP definidos por la especificación HTTP, pero muchos de ellos no se utilizan o apoyan ampliamente. En realidad, muchos navegadores modernos no apoyan los métodos PUT y DELETE.

            -
            -

            Además de la primera línea, una petición HTTP invariablemente contiene otras líneas de información conocidas como cabeceras de petición. Las cabeceras pueden suministrar una amplia gama de información como el servidor (o host) solicitado, los formatos de respuesta que acepta el cliente (Accept) y la aplicación que utiliza el cliente para realizar la petición (User-Agent). Existen muchas otras cabeceras y se pueden encontrar en el artículo Lista de campos de las cabeceras HTTP en la Wikipedia.

            -
            -
            -

            Paso 2: El servidor devuelve una respuesta

            -

            Una vez que un servidor ha recibido la petición, sabe exactamente qué recursos necesita el cliente (a través de la URI) y lo que el cliente quiere hacer con ese recurso (a través del método). Por ejemplo, en el caso de una petición GET, el servidor prepara el recurso y lo devuelve en una respuesta HTTP. Considera la respuesta del servidor web, xkcd:

            -../_images/http-xkcd_es.png -

            Traducida a HTTP, la respuesta enviada de vuelta al navegador se verá algo similar a esto:

            -
            HTTP/1.1 200 OK
-Date: Sat, 02 Apr 2011 21:05:05 GMT
-Server: lighttpd/1.4.19
-Content-Type: text/html
-
-    <html>
-  <!-- ... HTML para xkcd comic -->
-</html>
-
            -
            -

            La respuesta HTTP contiene el recurso solicitado (contenido HTML en este caso), así como otra información acerca de la respuesta. La primera línea es especialmente importante y contiene el código de estado HTTP (200 en este caso) de la respuesta. El código de estado comunica el resultado global de la petición devuelta al cliente. ¿Tuvo éxito la petición? ¿Hubo algún error? Existen diferentes códigos de estado que indican éxito, un error o qué más se necesita hacer con el cliente (por ejemplo, redirigirlo a otra página). La lista completa se puede encontrar en el artículo Lista de códigos de estado HTTP en la Wikipedia.

            -

            Al igual que la petición, una respuesta HTTP contiene datos adicionales conocidos como cabeceras HTTP. Por ejemplo, una importante cabecera de la respuesta HTTP es Content-Type. El cuerpo del mismo recurso se puede devolver en varios formatos diferentes, incluyendo HTML, XML o JSON y la cabecera Content-Type utiliza Internet Media Types como text/html para decirle al cliente cual formato se ha devuelto. Puedes encontrar una lista completa en el artículo Lista de tipos de medios comunes en la Wikipedia.

            -

            Existen muchas otras cabeceras, algunas de las cuales son muy poderosas. Por ejemplo, puedes usar ciertas cabeceras para crear un poderoso sistema de memoria caché.

            -
            -
            -

            Peticiones, respuestas y desarrollo Web

            -

            Esta conversación petición-respuesta es el proceso fundamental que impulsa toda la comunicación en la web. Y tan importante y poderoso como es este proceso, inevitablemente es simple.

            -

            El hecho más importante es el siguiente: independientemente del lenguaje que utilices, el tipo de aplicación que construyas (web, móvil, API JSON), o la filosofía de desarrollo que sigas, el objetivo final de una aplicación siempre es entender cada petición y crear y devolver la respuesta adecuada.

            -

            Symfony está diseñado para adaptarse a esta realidad.

            -
            -

            Truco

            -

            Para más información acerca de la especificación HTTP, lee la referencia original HTTP 1.1 RFC o HTTP Bis, el cual es un esfuerzo activo para aclarar la especificación original. Una gran herramienta para comprobar tanto la petición como las cabeceras de la respuesta mientras navegas es la extensión Cabeceras HTTP en vivo (Live HTTP Headers) para Firefox.

            -
            -
            -
            -
            -

            Peticiones y respuestas en PHP

            -

            Entonces ¿cómo interactúas con la «petición» y creas una «respuesta» utilizando PHP? En realidad, PHP te abstrae un poco de todo el proceso:

            -
            $uri = $_SERVER['REQUEST_URI'];
-$foo = $_GET['foo'];
-
-header('Content-type: text/html');
-echo 'La URI solicitada es: '.$uri;
-echo 'El valor del parámetro "foo" es: '.$foo;
-
            -
            -

            Por extraño que parezca, esta pequeña aplicación, de hecho, está tomando información de la petición HTTP y la utiliza para crear una respuesta HTTP. En lugar de analizar el mensaje HTTP de la petición, PHP prepara variables superglobales tales como $_SERVER y $_GET que contienen toda la información de la petición. Del mismo modo, en lugar de devolver la respuesta HTTP con formato de texto, puedes usar la función header() para crear las cabeceras de la respuesta y simplemente imprimir el contenido real que será la porción que contiene el mensaje de la respuesta. PHP creará una verdadera respuesta HTTP y la devolverá al cliente:

            -
            HTTP/1.1 200 OK
-Date: Sat, 03 Apr 2011 02:14:33 GMT
-Server: Apache/2.2.17 (Unix)
-Content-Type: text/html
-
-La URI solicitada es: /testing?foo=symfony
-El valor del parámetro "foo" es: symfony
-
            -
            -
            -
            -

            Peticiones y respuestas en Symfony

            -

            Symfony ofrece una alternativa al enfoque de PHP a través de dos clases que te permiten interactuar con la petición HTTP y la respuesta de una manera más fácil. -La clase Symfony\Component\HttpFoundation\Request es una sencilla representación orientada a objetos del mensaje de la petición HTTP. Con ella, tienes toda la información a tu alcance:

            -
            use Symfony\Component\HttpFoundation\Request;
-
-$request = Request::createFromGlobals();
-
-// la URI solicitada (p. ej. /sobre) menos algunos parámetros de la consulta
-$request->getPathInfo();
-
-// recupera las variables GET y POST respectivamente
-$request->query->get('foo');
-$request->request->get('bar', 'default value if bar does not exist');
-
-// recupera las variables de SERVER
-$request->server->get('HTTP_HOST');
-
-// recupera una instancia del archivo subido identificado por foo
-$request->files->get('foo');
-
-// recupera un valor de COOKIE
-$request->cookies->get('PHPSESSID');
-
-// recupera una cabecera HTTP de la petición, normalizada, con índices en minúscula
-$request->headers->get('host');
-$request->headers->get('content_type');
-
-$request->getMethod();          // GET, POST, PUT, DELETE, HEAD
-$request->getLanguages();       // un arreglo de idiomas aceptados por el cliente
-
            -
            -

            Como bono adicional, en el fondo la clase Petición hace un montón de trabajo del cual nunca tendrás que preocuparte. Por ejemplo, el método isSecure() comprueba tres diferentes valores en PHP que pueden indicar si el usuario está conectado a través de una conexión segura (es decir, https).

            -
            -

            ParameterBags y atributos de la petición

            -

            Como vimos anteriormente, las variables $_GET y $_POST son accesibles a través de las propiedades query y request, respectivamente. Cada uno de estos objetos es un objeto de la Symfony\Component\HttpFoundation\ParameterBag, la cual cuenta con métodos cómo: -get(), -has(), -all() entre otros. -De hecho, todas las propiedades públicas utilizadas en el ejemplo anterior son un ejemplo del ParameterBag.

            -

            La clase Petición también tiene una propiedad pública attributes, que tiene datos especiales relacionados en cómo funciona internamente la aplicación. Para la plataforma Symfony2, attibutes mantiene los valores devueltos por la ruta buscada, tal como _controller, id (por lo tanto si tienes un comodín {id}), e incluso el nombre de la ruta buscada (_route). La propiedad attributes existe enteramente para ser un lugar donde se pueda preparar y almacenar información del contexto específico de la petición.

            -
            -

            Symfony también proporciona una clase Respuesta: una simple representación PHP de un mensaje de respuesta HTTP. Esto permite que tu aplicación utilice una interfaz orientada a objetos para construir la respuesta que será devuelta al cliente:

            -
            use Symfony\Component\HttpFoundation\Response;
-$response = new Response();
-
-$response->setContent('<html><body><h1>Hello world!</h1></body></html>');
-$response->setStatusCode(200);
-$response->headers->set('Content-Type', 'text/html');
-
-// imprime las cabeceras HTTP seguidas por el contenido
-$response->send();
-
            -
            -

            Si Symfony no ofreciera nada más, ya tendrías un conjunto de herramientas para acceder fácilmente a la información de la petición y una interfaz orientada a objetos para crear la respuesta. Incluso, a medida que aprendas muchas de las poderosas características de Symfony, nunca olvides que el objetivo de tu aplicación es interpretar una petición y crear la respuesta adecuada basada en la lógica de tu aplicación.

            -
            -

            Truco

            -

            Las clases Respuesta y Petición forman parte de un componente independiente incluido en Symfony llamado HttpFoundation. Este componente se puede utilizar completamente independiente de Symfony y también proporciona clases para manejar sesiones y subir archivos.

            -
            -
            -
            -

            El viaje desde la petición hasta la respuesta

            -

            Al igual que el mismo HTTP, los objetos Petición y Respuesta son bastante simples. -La parte difícil de la construcción de una aplicación es escribir lo que viene en el medio. -En otras palabras, el verdadero trabajo viene al escribir el código que interpreta la información de la petición y crea la respuesta.

            -

            Tu aplicación probablemente hace muchas cosas, como enviar correo electrónico, manejar los formularios presentados, guardar cosas en una base de datos, reproducir las páginas HTML y proteger el contenido con seguridad. ¿Cómo puedes manejar todo esto y todavía mantener tu código organizado y fácil de mantener?

            -

            Symfony fue creado para resolver estos problemas para que no tengas que hacerlo personalmente.

            -
            -

            El controlador frontal

            -

            Tradicionalmente, las aplicaciones eran construidas de modo que cada «página» de un sitio tenía su propio archivo físico:

            -
            index.php
-contacto.php
-blog.php
-
            -
            -

            Hay varios problemas con este enfoque, incluyendo la falta de flexibilidad de las URL (¿qué pasa si quieres cambiar blog.php a noticias.php sin romper todos tus enlaces?) y el hecho de que cada archivo debe incluir manualmente un conjunto de archivos básicos para la seguridad, conexiones a base de datos y que el «aspecto» del sitio pueda permanecer constante.

            -

            Una mucho mejor solución es usar un controlador frontal: un solo archivo PHP que se encargue de todas las peticiones que llegan a tu aplicación. Por ejemplo:

            - ---- - - - - - - - - - - - -
            /index.phpejecuta index.php
            /index.php/contactejecuta index.php
            /index.php/blogejecuta index.php
            -
            -

            Truco

            -

            Usando mod_rewrite de Apache (o equivalente con otros servidores web), las URL se pueden limpiar fácilmente hasta ser sólo /, /contact y /blog.

            -
            -

            Ahora, cada petición se maneja de la misma manera exactamente. En lugar de URL individuales ejecutando diferentes archivos PHP, el controlador frontal siempre se ejecuta, y el enrutado de diferentes URL a diferentes partes de tu aplicación se realiza internamente. Esto resuelve los problemas del enfoque original. -Casi todas las aplicaciones web modernas lo hacen —incluyendo aplicaciones como WordPress.

            -
            -
            -

            Mantente organizado

            -

            Dentro de tu controlador frontal, tienes que averiguar qué código se debe ejecutar y cual contenido se debe regresar. Para resolver esto, necesitas comprobar la URI entrante y ejecutar diferentes partes de tu código dependiendo de ese valor. Esto se puede poner feo rápidamente:

            -
            // index.php
-use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\HttpFoundation\Response;
-$request = Request::createFromGlobals();
-$path = $request->getPathInfo(); // La ruta URI solicitada
-
-if (in_array($path, array('', '/'))) {
-    $response = new Response('Welcome to the homepage.');
-} elseif ($path == '/contact') {
-    $response = new Response('Contact us');
-} else {
-    $response = new Response('Page not found.', 404);
-}
-$response->send();
-
            -
            -

            La solución a este problema puede ser difícil. Afortunadamente esto es exactamente para lo que Symfony está diseñado.

            -
            -
            -

            El flujo de las aplicaciones Symfony

            -

            Cuando dejas que Symfony controle cada petición, la vida es mucho más fácil. Symfony sigue el mismo patrón simple en cada petición:

            -
            -Flujo de la petición en Symfony2 -

            Las peticiones entrantes son interpretadas por el enrutador y pasadas a las funciones controladoras que regresan objetos Respuesta.

            -
            -

            Cada «página» de tu sitio está definida en un archivo de configuración de enrutado que asigna las diferentes URL a diferentes funciones PHP. El trabajo de cada función PHP conocida como controlador, es utilizar la información de la petición —junto con muchas otras herramientas que Symfony pone a tu disposición— para crear y devolver un objeto Respuesta. En otras palabras, el controlador es donde está tu código: ahí es dónde se interpreta la petición y crea una respuesta.

            -

            ¡Así de fácil! Repasemos:

            -
              -
            • Cada petición ejecuta un archivo controlador frontal;
              • -
            • El sistema de enrutado determina cual función PHP se debe ejecutar en base a la información de la petición y la configuración de enrutado que creaste;
              • -
            • La función PHP correcta se ejecuta, donde tu código crea y devuelve el objeto Respuesta adecuado.
              • -
            -
            -
            -

            Una petición Symfony en acción

            -

            Sin bucear demasiado en los detalles, veamos este proceso en acción. Supongamos que deseas agregar una página /contact a tu aplicación Symfony. En primer lugar, empezamos agregando una entrada /contact a tu archivo de configuración de enrutado:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-contact:
-    path:     /contact
-    defaults: { _controller: AcmeDemoBundle:Main:contact }
-
              -
              -
              • -
            • XML
              <route id="contact" path="/contact">
-    <default key="_controller">AcmeBlogBundle:Main:contact</default>
-</route>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('contact', new Route('/contact', array(
-    '_controller' => 'AcmeBlogBundle:Main:contact',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Este ejemplo utiliza YAML para definir la configuración de enrutado. La configuración de enrutado también se puede escribir en otros formatos, tal como XML o PHP.

            -
            -

            Cuando alguien visita la página /contact, esta ruta coincide, y se ejecuta el controlador especificado. Como veremos en el capítulo Enrutando, la cadena AcmeDemoBundle:Main:contact es una sintaxis corta que apunta hacia el método PHP contactAction dentro de una clase llamada MainController:

            -
            // src/Acme/DemoBundle/Controller/MainController.php
-use Symfony\Component\HttpFoundation\Response;
-
-class MainController
-{
-    public function contactAction()
-    {
-        return new Response('<h1>Contact us!</h1>');
-    }
-}
-
            -
            -

            En este muy simple ejemplo, el controlador sencillamente crea un objeto Symfony\Component\HttpFoundation\Response con el código HTML «<h1>Contact us!</h1>». En el capítulo Controlador, aprenderás cómo un controlador puede reproducir plantillas, permitiendo que tu código de «presentación» (es decir, algo que en realidad escribe HTML) viva en un archivo de plantilla separado. Esto libera al controlador de preocuparse sólo de las cosas difíciles: la interacción con la base de datos, la manipulación de los datos presentados o el envío de mensajes de correo electrónico.

            -
            -
            -
            -

            Symfony2: Construye tu aplicación, no tus herramientas.

            -

            Ahora sabemos que el objetivo de cualquier aplicación es interpretar cada petición entrante y crear una respuesta adecuada. Cuando una aplicación crece, es más difícil mantener organizado tu código y que a la vez sea fácil darle mantenimiento. Invariablemente, las mismas tareas complejas siguen viniendo una y otra vez: la persistencia de cosas a la base de datos, procesamiento y reutilización de plantillas, manejo de formularios presentados, envío de mensajes de correo electrónico, validación de entradas del usuario y administración de la seguridad.

            -

            La buena nueva es que ninguno de estos problemas es único. Symfony proporciona una plataforma completa, con herramientas que te permiten construir tu aplicación, no tus herramientas. Con Symfony2, nada se te impone: eres libre de usar la plataforma Symfony completa, o simplemente una pieza de Symfony por sí misma.

            -
            -

            Herramientas independientes: Componentes de Symfony2

            -

            Entonces, ¿qué es Symfony2? En primer lugar, Symfony2 es una colección de más de veinte bibliotecas independientes que se pueden utilizar dentro de cualquier proyecto PHP. Estas bibliotecas, llamadas componentes de Symfony2, contienen algo útil para casi cualquier situación, independientemente de cómo desarrolles tu proyecto. Para nombrar algunas:

            -
              -
            • HttpFoundation — Contiene las clases Petición y Respuesta, así como otras clases para manejar sesiones y cargar archivos;
              • -
            • Enrutando — Potente y rápido sistema de enrutamiento que te permite asociar una URI específica (por ejemplo /contacto) a cierta información acerca de cómo se debe manejar esa petición (por ejemplo, ejecutando el método contactoAction());
              • -
            • Form — Una completa y flexible plataforma para crear formularios y procesar los datos presentados en ellos;
              • -
            • Validator Un sistema para crear reglas sobre datos y entonces, cuando el usuario presenta los datos comprobar si son válidos o no siguiendo esas reglas;
              • -
            • ClassLoader Una biblioteca de carga automática que permite utilizar clases PHP sin necesidad de require los archivos que contienen esas clases manualmente;
              • -
            • Plantillas Un juego de herramientas para reproducir plantillas, manejar la herencia de plantillas (es decir, una plantilla es decorada con un diseño) y realizar otras tareas comunes de las plantillas;
              • -
            • Security — Una poderosa biblioteca para manejar todo tipo de seguridad dentro de una aplicación;
              • -
            • Translation Una plataforma para traducir cadenas en tu aplicación.
              • -
            -

            Todos y cada uno de estos componentes se desacoplan y se pueden utilizar en cualquier proyecto PHP, independientemente de si utilizas la plataforma Symfony2. -Cada parte está hecha para utilizarla si es conveniente y sustituirse cuando sea necesario.

            -
            -
            -

            La solución completa: La plataforma Symfony2

            -

            Entonces, ¿qué es la plataforma Symfony2? La plataforma Symfony2 es una biblioteca PHP que realiza dos distintas tareas:

            -
              -
            1. Proporciona una selección de componentes (es decir, los componentes de Symfony2) y bibliotecas de terceros (por ejemplo, SwiftMailer para enviar mensajes de correo electrónico);
              2. -
            2. Proporciona configuración sensible y el «pegamento» que une la biblioteca con todas estas piezas.
              3. -
            -

            El objetivo de la plataforma es integrar muchas herramientas independientes con el fin de proporcionar una experiencia coherente al desarrollador. Incluso la propia plataforma es un paquete Symfony2 (es decir, un complemento) que puedes configurar o sustituir completamente.

            -

            Symfony2 proporciona un potente conjunto de herramientas para desarrollar aplicaciones web rápidamente sin imponerse en tu aplicación. Los usuarios normales rápidamente pueden comenzar el desarrollo usando una distribución Symfony2, que proporciona un esqueleto del proyecto con parámetros predeterminados. Para los usuarios más avanzados, el cielo es el límite.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/index.html b/book/index.html deleted file mode 100644 index b82065f..0000000 --- a/book/index.html +++ /dev/null @@ -1,151 +0,0 @@ - - - - - - - Libro — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - - - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/installation.html b/book/installation.html deleted file mode 100644 index 6fe6a35..0000000 --- a/book/installation.html +++ /dev/null @@ -1,323 +0,0 @@ - - - - - - - Instalando y configurando Symfony — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Instalando y configurando Symfony

            -

            El objetivo de este capítulo es empezar a trabajar con una aplicación funcionando incorporada en lo alto de Symfony. Afortunadamente, Symfony dispone de «distribuciones», que son proyectos Symfony funcionales desde el «arranque», los cuales puedes descargar y comenzar a desarrollar inmediatamente.

            -
            -

            Truco

            -

            Si estás buscando instrucciones sobre la mejor manera de crear un nuevo proyecto y guardarlo vía el control de código fuente, consulta Usando control de código fuente.

            -
            -
            -

            Instalando una distribución de Symfony2

            -
            -

            Truco

            -

            En primer lugar, comprueba que tienes instalado y configurado un servidor web (como Apache) con PHP 5.3.8 o superior. Para más información sobre los requisitos de Symfony2, consulta los requisitos en la referencia.

            -
            -

            Los paquetes de las «distribuciones» de Symfony2, son aplicaciones totalmente funcionales que incluyen las bibliotecas del núcleo de Symfony2, una selección de útiles paquetes, una sensible estructura de directorios y alguna configuración predeterminada. Al descargar una distribución Symfony2, estás descargando la estructura de una aplicación operativa que puedes utilizar inmediatamente para comenzar a desarrollar tu aplicación.

            -

            Empieza por visitar la página de descarga de Symfony2 en http://symfony.com/download. -En esta página, puedes encontrar la edición estándar de Symfony, que es la distribución principal de Symfony2. Hay 2 maneras en las que puedes iniciar tu proyecto:

            -
            -

            Opción 1) Composer

            -

            Composer es una biblioteca de administración de dependencias para PHP, la cual puedes utilizar para descargar la Edición estándar de Symfony2.

            -

            Comienza descargando Composer en algún lugar de tu ordenador local. Si tienes instalado curl, es tan fácil como:

            -
            % curl -s https://getcomposer.org/installer | php
-
            -
            -
            -

            Nota

            -

            Si tu ordenador no está listo para utilizar Composer, verás algunas recomendaciones cuándo ejecutes esta orden. Sigue las recomendaciones hasta lograr que Composer trabaje correctamente.

            -
            -

            Composer es un archivo PHAR ejecutable, el cual puedes utilizar para descargar la distribución estándar:

            -
            php composer.phar create-project symfony/framework-standard-edition /ruta/al/directorio/web-raiz/Symfony 2.2.0
-
            -
            -
            -

            Truco

            -

            Para una versión exacta, reemplaza 2.2.0 con la más reciente versión de Symfony (p. ej. 2.2.1). Para detalles, ve la Página de instalación de Symfony

            -
            -
            -

            Truco

            -

            Para descargar más rápido los archivos de proveedores, añade la opción --prefer-dist al final de cualquier orden de Composer.

            -
            -

            Esta orden puede tardar varios minutos en su ejecución puesto que composer descarga la Distribución estándar junto con todas las bibliotecas de proveedores que necesita. Cuando termine, tendrás un directorio parecido a este:

            -
            ruta/al/directorio/web-raiz/ <- tu directorio raíz del servidor web
-    Symfony/ <- el archivo extraído
-        app/
-            cache/
-            config/
-            logs/
-        src/
-            ...
-        vendor/
-            ...
-        web/
-            app.php
-            ...
-
            -
            -
            -
            -

            Opción 2) Descarga un archivo

            -

            También puedes descargar un archivo de la Edición estándar. En este caso, necesitas hacer dos elecciones:

            -
              -
            • Descargar o bien un archivo .tgz o .zip — ambos son equivalentes, descarga aquel con el que te sientas más cómodo—;
              • -
            • Descargar la distribución con o sin vendors. Si estás planeando utilizar más bibliotecas o paquetes de terceros y gestionarlas vía Composer, probablemente tienes que descarga la versión «sin vendors».
              • -
            -

            Descarga uno de los archivos en algún lugar bajo el directorio raíz de tu servidor web local y descomprímelo. Desde una línea de ordenes de UNIX, esto se puede hacer con una de las siguientes ordenes (sustituye ### con el nombre del archivo real):

            -
            # para un archivo .tgz
-$ tar zxvf Symfony_Standard_Vendors_2.2.###.tgz
-
-# para un archivo .zip
-$ unzip Symfony_Standard_Vendors_2.2.###.zip
-
            -
            -

            Si descargaste el archivo «sin vendors», definitivamente necesitarás leer la siguiente sección.

            -
            -

            Nota

            -

            Fácilmente puedes sustituir la estructura de directorios predefinida. Consulta Cómo sustituir la estructura de directorios predeterminada de Symfony para más información.

            -
            -
            -
            -

            Actualizando vendors

            -

            Al llegar a este punto, has descargado un proyecto Symfony completamente operativo en el cual puedes comenzar a desarrollar tu propia aplicación. Un proyecto Symfony depende de una serie de bibliotecas externas. Estas se han descargado al directorio vendor/ de tu proyecto vía una biblioteca llamada Composer.

            -

            Dependiendo de cómo descargaste Symfony, ahora posiblemente o no necesites actualizar tus proveedores. Pero, actualizar tus proveedores siempre es seguro, y garantiza que tienes todas las bibliotecas de proveedores necesarias.

            -

            Paso 1: Consigue Composer (El nuevo gran sistema de empacado PHP)

            -
            curl -s http://getcomposer.org/installer | php
-
            -
            -

            Asegúrate de descargar composer.phar en el mismo directorio dónde se encuentra el archivo composer.json (este, por omisión, es el directorio raíz de tu proyecto Symfony).

            -

            Paso 2: Instala las bibliotecas de terceros

            -
            $ php composer.phar install
-
            -
            -

            Esta orden descarga todas las bibliotecas de terceros necesarias —incluyendo al mismo Symfony— en el directorio vendor/.

            -
            -

            Nota

            -

            Si no tienes instalado curl, simplemente puedes descargar manualmente el archivo instalador de http://getcomposer.org/installer. Coloca ese archivo en tu proyecto y luego ejecuta:

            -
            php installer
-php composer.phar install
-
            -
            -
            -
            -

            Truco

            -

            Cuando ejecutes php composer.phar install o php composer.phar update, composer ejecutará las ordenes postinstalación/postactualización para limpiar la caché e instalar los activos. De manera predeterminada, los activos se copiarán a tu directorio web.

            -

            En vez de copiar tus activos Symfony, puedes crear enlaces simbólicos si tu sistema operativo los apoya. Para crear enlaces simbólicos, añade una entrada en el nodo extra de tu archivo composer.json` con la clave symfony-assets-install y el valor symlink:

            -
            "extra": {
-    "symfony-app-dir": "app",
-    "symfony-web-dir": "web",
-    "symfony-assets-install": "symlink"
-}
            -
            -

            Al suministrar relative en lugar de symlink a symfony-assets-install, la orden generará enlaces simbólicos relativos.

            -
            -
            -
            -

            Instalando y configurando

            -

            En este punto, todas las bibliotecas de terceros necesarias ahora viven en el directorio vendor/. También tienes una instalación predeterminada de la aplicación en app/ y algunos ejemplos de código dentro de src/.

            -

            Symfony2 viene con una interfaz visual para probar la configuración del servidor, muy útil para ayudarte a solucionar problemas relacionados con la configuración de tu servidor web y PHP para utilizar Symfony. Usa la siguiente URL para examinar tu configuración:

            -
            http://localhost/config.php
-
            -
            -

            Si hay algún problema, corrígelo antes de continuar.

            -
            -

            Configurando permisos

            -

            Un problema común es que ambos directorios app/cache y app/logs deben tener permiso de escritura, tanto para el servidor web cómo para la línea de ordenes del usuario. En un sistema UNIX, si el usuario del servidor web es diferente de tu usuario de la línea de ordenes, puedes ejecutar las siguientes ordenes una sola vez en el proyecto para garantizar que los permisos se configuran correctamente.

            -

            Ten en cuenta que no todos los servidores web corren como el usuario www-data como en los ejemplos de abajo. En su lugar, revisa qué usuario está corriendo tu servidor web y úsalo en lugar de www-data.

            -

            En un sistema UNIX, esto se puede hacer con una de las siguientes órdenes:

            -
            $ ps aux | grep httpd
-
            -
            -

            o

            -
            $ ps aux | grep apache
-
            -
            -

            1. Usando ACL en un sistema que admite chmod +a

            -

            Muchos sistemas te permiten utilizar la orden chmod +a. Intenta esta orden primero, y si se produce un error — intenta el siguiente método: Asegurate de cambiar www-data por el usuario de tu servidor web en la primer orden chmod:

            -
            $ rm -rf app/cache/*
-$ rm -rf app/logs/*
-
-$ sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs
-$ sudo chmod +a "`whoami` allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs
-
            -
            -

            2. Usando ACL en un sistema que no es compatible con chmod +a

            -

            Algunos sistemas, no son compatibles con chmod +a, pero son compatibles con otra utilidad llamada setfacl. Posiblemente tengas que habilitar la compatibilidad con ACL en tu partición e instalar setfacl antes de usarlo (como es el caso de Ubuntu), de esta manera:

            -
            $ sudo setfacl -R -m u:www-data:rwX -m u:`whoami`:rwX app/cache app/logs
-$ sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs
-
            -
            -

            3. Sin usar ACL

            -

            Si no tienes acceso para modificar los directorios ACL, tendrás que cambiar la umask para que los directorios cache/ y logs/ se puedan escribir por el grupo o por cualquiera (dependiendo de si el usuario del servidor web y el usuario de la línea de ordenes están en el mismo grupo o no). Para ello, pon la siguiente línea al comienzo de los archivos app/console, web/app.php y web/app_dev.php:

            -
            umask(0002); // Esto permitirá que los permisos sean 0775
-
-// o
-
-umask(0000); // Esto permitirá que los permisos sean 0777
-
            -
            -

            Ten en cuenta que el uso de ACL se recomienda cuando tienes acceso a ellos en el servidor porque cambiar la umask no es seguro en subprocesos.

            -
            -

            Cuando todo esté listo, haz clic en el enlace «Visita la página de Bienvenida» para ver tu primer aplicación «real» en Symfony2:

            -
            http://localhost/app_dev.php/
-
            -
            -

            ¡Symfony2 debería darte la bienvenida y felicitarte por tu arduo trabajo hasta el momento!

            -../_images/welcome.png -
            -

            Truco

            -

            Para conseguir bonitas y breves URL deberías apuntar el documento raíz de tu servidor web o servidor virtual al directorio Symfony/web/. Aunque esto no es necesario para el desarrollo, es recomendable al momento de desplegar tu aplicación en producción cuando todo el sistema y archivos de configuración se vuelven inaccesibles a los clientes. Para información sobre cómo configurar el directorio raíz de tu servidor web, lee Configuring a web server o consulta la documentación oficial de tu servidor web: -Apache | Nginx .

            -
            -
            -
            -
            -

            Empezando a desarrollar

            -

            Ahora que tienes una aplicación Symfony2 completamente operativa, ¡puedes empezar a desarrollarla! Tu distribución puede contener algún código de ejemplo — revisa el archivo README.md incluido con la distribución (abrelo como archivo de texto) para ver qué código de ejemplo incluye tu distribución.

            -

            Si es tu primer contacto con Symfony, alcánzanos en «Creando páginas en Symfony2», donde aprenderás a crear páginas, cambiar la configuración, y todo lo que necesitarás en tu nueva aplicación.

            -

            Además, asegúrate de revisar el Recetario, el cual contiene una amplia variedad de artículos que solucionan problemas específicos con Symfony.

            -
            -

            Nota

            -

            Si quieres eliminar el código de ejemplo de tu distribución, dale un vistazo a este artículo en el recetario: «Cómo eliminar el AcmeDemoBundle»

            -
            -
            -
            -

            Usando control de código fuente

            -

            Si estás utilizando un sistema de control de versiones como Git o Subversion, puedes configurar tu sistema de control de versiones y empezar a confirmar cambios al proyecto normalmente. La edición estándar de Symfony es el punto de partida para tu nuevo proyecto.

            -

            Para instrucciones específicas sobre la mejor manera de configurar el proyecto para almacenarlo en git, consulta Cómo crear y guardar un proyecto Symfony2 en git.

            -
            -

            Ignorando el directorio vendor/

            -

            Si has descargado el archivo sin proveedores, puedes omitir todo el directorio vendor/ y no confirmarlo al control de versiones. Con Git, esto se logra creando un archivo .gitignore y añadiendo lo siguiente:

            -
            /vendor/
-
            -
            -

            Ahora, el directorio de proveedores no será confirmado al control de versiones. Esto está muy bien (en realidad, ¡es genial!) porque cuando alguien más clone o coteje el proyecto, él/ella simplemente puede ejecutar el archivo php composer.phar install para descargar todas las bibliotecas de proveedores necesarias.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/internals.html b/book/internals.html deleted file mode 100644 index 4cd6d8d..0000000 --- a/book/internals.html +++ /dev/null @@ -1,577 +0,0 @@ - - - - - - - Funcionamiento interno — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Funcionamiento interno

            -

            Parece que quieres entender cómo funciona y cómo extender Symfony2. -¡Eso me hace muy feliz! Esta sección es una explicación en profundidad de Symfony2 desde dentro.

            -
            -

            Nota

            -

            Necesitas leer esta sección sólo si quieres entender cómo funciona Symfony2 detrás de la escena, o si deseas extender Symfony2.

            -
            -
            -

            Descripción

            -

            El código Symfony2 está hecho de varias capas independientes. Cada capa está construida en lo alto de la anterior.

            -
            -

            Truco

            -

            La carga automática no la gestiona la plataforma directamente; Esto se hace utilizando el cargador automático de Composer (vendor/autoload.php), el cual está incluido en el archivo src/autoload.php.

            -
            -
            -

            Componente HttpFoundation

            -

            Al nivel más profundo está el componente HttpFoundation. HttpFoundation proporciona los principales objetos necesarios para hacer frente a HTTP. -Es una abstracción orientada a objetos de algunas funciones y variables nativas de PHP:

            -
              -
            • La clase Symfony\Component\HttpFoundation\Request resume las principales variables globales de PHP, tales como $_GET, $_POST, $_COOKIE, $_FILES y $_SERVER;
              • -
            • La clase Symfony\Component\HttpFoundation\Response abstrae algunas funciones PHP como header(), setcookie() y echo;
              • -
            • La clase Symfony\Component\HttpFoundation\Session y la interfaz Symfony\Component\HttpFoundation\SessionStorage\SessionStorageInterface, abstraen la gestión de sesiones y las funciones session_*().
              • -
            -
            -
            -

            Componente HttpKernel

            -

            En lo alto de HttpFoundation está el componente HttpKernel. HttpKernel se encarga de la parte dinámica de HTTP; es una fina capa en la parte superior de las clases Petición y Respuesta para estandarizar la forma en que se manejan las peticiones. Este, también proporciona puntos de extensión y herramientas que lo convierten en el punto de partida ideal para crear una plataforma Web sin demasiado trabajo.

            -

            Además, opcionalmente añade configurabilidad y extensibilidad, gracias al componente de inyección de dependencias y un potente sistema de complementos (paquetes).

            -
            -

            Ver también

            -

            Lee más sobre la Inyección de dependencias y los Paquetes.

            -
            -
            -
            -

            Paquete FrameworkBundle

            -

            El paquete FrameworkBundle es el paquete que une los principales componentes y bibliotecas para hacer una plataforma MVC ligera y rápida. Este viene con una sensible configuración predeterminada y convenios para suavizar la curva de aprendizaje.

            -
            -
            -
            -

            El núcleo

            -

            La clase Symfony\Component\HttpKernel\HttpKernel es la clase central de Symfony2 y es responsable de procesar las peticiones del cliente. Su objetivo principal es «convertir» un objeto Symfony\Component\HttpFoundation\Request a un objeto Symfony\Component\HttpFoundation\Response.

            -

            Cada núcleo de Symfony2 implementa Symfony\Component\HttpKernel\HttpKernelInterface:

            -
            function handle(Request $request, $type = self::MASTER_REQUEST, $catch = true)
-
            -
            -
            -

            Controladores

            -

            Para convertir una Petición a una Respuesta, el núcleo cuenta con un «Controlador». Un controlador puede ser cualquier PHP ejecutable válido.

            -

            El núcleo delega la selección de cual controlador se debe ejecutar a una implementación de Symfony\Component\HttpKernel\Controller\ControllerResolverInterface:

            -
            public function getController(Request $request);
-
-public function getArguments(Request $request, $controller);
-
            -
            -

            El método getController() devuelve el controlador (un PHP ejecutable) asociado a la petición dada. La implementación predeterminada de (Symfony\Component\HttpKernel\Controller\ControllerResolver) busca un atributo _controller en la petición que representa el nombre del controlador (una cadena «class::method», cómo Bundle\BlogBundle\PostController:indexAction).

            -
            -

            Truco

            -

            La implementación predeterminada utiliza la clase Symfony\Bundle\FrameworkBundle\EventListener\RouterListener para definir el atributo _controller de la petición (consulta el Evento kernel.request).

            -
            -

            El método getArguments() devuelve un arreglo de argumentos para pasarlo al Controlador ejecutable. La implementación predeterminada automáticamente resuelve los argumentos del método, basándose en los atributos de la Petición.

            -
            -

            Emparejando los argumentos del método Controlador desde los atributos de la Petición

            -

            Por cada argumento del método, Symfony2 trata de obtener el valor de un atributo de la Petición con el mismo nombre. Si no se proporciona, el valor predeterminado es el argumento utilizado de estar definido:

            -
            // Symfony2 debe buscar un atributo 'id' (obligatorio)
-//  y un 'admin' (opcional)
-public function showAction($id, $admin = true)
-{
-    // ...
-}
-
            -
            -
            -
            -
            -

            Procesando peticiones

            -

            El método handle() toma una Petición y siempre devuelve una Respuesta. Para convertir la Petición, handle() confía en el mecanismo de resolución y una cadena ordenada de notificaciones de evento (consulta la siguiente sección para más información acerca de cada evento):

            -
              -
            1. Antes de hacer cualquier otra cosa, difunde el evento kernel.request —si alguno de los escuchas devuelve una Respuesta, salta directamente al paso 8;
              2. -
            2. El mecanismo de resolución es llamado para determinar el controlador a ejecutar;
              3. -
            3. Los escuchas del evento kernel.controller ahora pueden manipular el controlador ejecutable como quieras (cambiarlo, envolverlo, ...);
              4. -
            4. El núcleo verifica que el controlador en realidad es un PHP ejecutable válido;
              5. -
            5. Se llama al mecanismo de resolución para determinar los argumentos a pasar al controlador;
              6. -
            6. El núcleo llama al controlador;
              7. -
            7. Si el controlador no devuelve una Respuesta, los escuchas del evento kernel.view pueden convertir en Respuesta el valor devuelto por el Controlador;
              8. -
            8. Los escuchas del evento kernel.response pueden manipular la Respuesta (contenido y cabeceras);
              9. -
            9. Devuelve la respuesta.
              10. -
            -

            Si se produce una Excepción durante el procesamiento, difunde la kernel.exception y se da la oportunidad a los escuchas de convertir la excepción en una Respuesta. Si esto funciona, se difunde el evento kernel.response; si no, se vuelve a lanzar la excepción.

            -

            Si no deseas que se capturen las Excepciones (para peticiones incrustadas, por ejemplo), desactiva el evento kernel.exception pasando false como tercer argumento del método handle().

            -
            -
            -

            Funcionamiento interno de las peticiones

            -

            En cualquier momento durante el manejo de una petición (la ‘maestra’ uno), puede manejar una subpetición. Puedes pasar el tipo de petición al método handle() (su segundo argumento):

            -
              -
            • HttpKernelInterface::MASTER_REQUEST;
              • -
            • HttpKernelInterface::SUB_REQUEST.
              • -
            -

            El tipo se pasa a todos los eventos y los escuchas pueden actuar en consecuencia (algún procesamiento sólo debe ocurrir en la petición maestra).

            -
            -
            -

            Eventos

            -

            Cada evento lanzado por el núcleo es una subclase de Symfony\Component\HttpKernel\Event\KernelEvent. Esto significa que cada evento tiene acceso a la misma información básica:

            -
              -
            • getRequestType() — devuelve el tipo de la petición (HttpKernelInterface::MASTER_REQUEST o HttpKernelInterface::SUB_REQUEST);
              • -
            • getKernel() — devuelve el núcleo que está procesando la petición;
              • -
            • getRequest() — devuelve la Petición procesada actualmente.
              • -
            -
            -

            getRequestType()

            -

            El método getRequestType() permite a los escuchas conocer el tipo de la petición. Por ejemplo, si un escucha sólo debe estar atento a las peticiones maestras, agrega el siguiente código al principio de tu método escucha:

            -
            use Symfony\Component\HttpKernel\HttpKernelInterface;
-
-if (HttpKernelInterface::MASTER_REQUEST !== $event->getRequestType()) {
-    // regresa inmediatamente
-    return;
-}
-
            -
            -
            -

            Truco

            -

            Si todavía no estás familiarizado con el Despachador de eventos de Symfony2, primero lee la sección del Componente despachador de eventos.

            -
            -
            -
            -

            Evento kernel.request

            -

            Clase del evento: Symfony\Component\HttpKernel\Event\GetResponseEvent

            -

            El objetivo de este evento es devolver inmediatamente un objeto Respuesta o variables de configuración para poder invocar un controlador después del evento. Cualquier escucha puede devolver un objeto Respuesta a través del método setResponse() en el evento. En este caso, todos los otros escuchas no serán llamados.

            -

            Este evento lo utiliza el FrameworkBundle para llenar el atributo _controller de la Petición, a través de Symfony\Bundle\FrameworkBundle\EventListener\RouterListener. RequestListener usa un objeto Symfony\Component\Routing\RouterInterface para emparejar la Petición y determinar el nombre del controlador (guardado en el atributo _controller de la Petición).

            -
            -
            -

            Evento kernel.controller

            -

            Clase del evento: Symfony\Component\HttpKernel\Event\FilterControllerEvent

            -

            Este evento no lo utiliza el FrameworkBundle, pero puede ser un punto de entrada para modificar el controlador que se debe ejecutar:

            -
            use Symfony\Component\HttpKernel\Event\FilterControllerEvent;
-
-public function onKernelController(FilterControllerEvent $event)
-{
-    $controller = $event->getController();
-    // ...
-
-    // el controlador se puede cambiar a cualquier PHP ejecutable
-    $event->setController($controller);
-}
-
            -
            -
            -
            -

            Evento kernel.view

            -

            Clase del evento: Symfony\Component\HttpKernel\Event\GetResponseForControllerResultEvent

            -

            Este evento no lo utiliza el FrameworkBundle, pero lo puedes usar para implementar un subsistema de vistas. Este evento se llama sólo si el controlador no devuelve un objeto Respuesta. El propósito del evento es permitir que algún otro valor de retorno se convierta en una Respuesta.

            -

            El valor devuelto por el controlador es accesible a través del método getControllerResult:

            -
            use Symfony\Component\HttpKernel\Event\GetResponseForControllerResultEvent;
-use Symfony\Component\HttpFoundation\Response;
-
-public function onKernelView(GetResponseForControllerResultEvent $event)
-{
-    $val = $event->getControllerResult();
-    $response = new Response();
-
-    // ... de alguna manera modifica la Respuesta desde el valor de retorno
-
-    $event->setResponse($response);
-}
-
            -
            -
            -
            -

            Evento kernel.response

            -

            Clase del evento: Symfony\Component\HttpKernel\Event\FilterResponseEvent

            -

            El propósito de este evento es permitir que otros sistemas modifiquen o sustituyan el objeto Respuesta después de su creación:

            -
            public function onKernelResponse(FilterResponseEvent $event)
-{
-    $response = $event->getResponse();
-
-    // ... modifica el objeto Respuesta
-}
-
            -
            -

            El FrameworkBundle registra varios escuchas:

            -
              -
            • Symfony\Component\HttpKernel\EventListener\ProfilerListener: -recoge los datos de la petición actual;
              • -
            • Symfony\Bundle\WebProfilerBundle\EventListener\WebDebugToolbarListener: -inyecta la barra de herramientas de depuración web;
              • -
            • Symfony\Component\HttpKernel\EventListener\ResponseListener: fija el Content-Type de la respuesta basándose en el formato de la petición;
              • -
            • Symfony\Component\HttpKernel\EventListener\EsiListener: agrega una cabecera HTTP Surrogate-Control cuando es necesario analizar etiquetas ESI en la respuesta.
              • -
            -
            -
            -

            Evento kernel.exception

            -

            Clase del evento: Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent

            -

            FrameworkBundle registra un Symfony\Component\HttpKernel\EventListener\ExceptionListener el cual remite la Petición a un determinado controlador (el valor del parámetro exception_listener.controller —debe estar en notación clase::método—).

            -

            Un escucha de este evento puede crear y configurar un objeto Respuesta, crear y establecer un nuevo objeto Excepción, o simplemente no hacer nada:

            -
            use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent;
-use Symfony\Component\HttpFoundation\Response;
-
-public function onKernelException(GetResponseForExceptionEvent $event)
-{
-    $exception = $event->getException();
-    $response = new Response();
-    // configura el objeto respuesta basándose en la excepción capturada
-    $event->setResponse($response);
-
-    // alternativamente puedes establecer una nueva excepción
-    // $exception = new \Exception('Some special exception');
-    // $event->setException($exception);
-}
-
            -
            -
            -

            Nota

            -

            Debido a que Symfony se asegura de que el código de estado de la Respuesta se ajusta al más adecuado dependiendo de la excepción, establecer el estado de la respuesta no funcionará. Si quieres reescribir el código de estado (no deberías, sin una buena razón), configurar la cabecera X-Status-Code:

            -
            return new Response('Error', 404 /* ignored */, array('X-Status-Code' => 200));
-
            -
            -
            -
            -
            -
            -
            -

            El despachador de eventos

            -

            El despachador de eventos es un componente independiente y es el responsable de mucha de la lógica y flujo subyacente detrás de una petición Symfony. Para más información consulta la documentación del Componente despachador de eventos.

            -
            -
            -

            Generador de perfiles

            -

            Cuando se activa, el generador de perfiles de Symfony2 recoge información útil sobre cada petición presentada a tu aplicación y la almacena para su posterior análisis. Utiliza el generador de perfiles en el entorno de desarrollo para que te ayude a depurar tu código y mejorar el rendimiento; úsalo en el entorno de producción para explorar problemas después del hecho.

            -

            Rara vez tienes que lidiar con el generador de perfiles directamente puesto que Symfony2 proporciona herramientas de visualización como la barra de herramientas de depuración web y el generador de perfiles web. Si utilizas la edición estándar de Symfony2, el generador de perfiles, la barra de herramientas de depuración web, y el generador de perfiles web, ya están configurados con ajustes razonables.

            -
            -

            Nota

            -

            El generador de perfiles recopila información para todas las peticiones (peticiones simples, redirecciones, excepciones, peticiones Ajax, peticiones ESI; y para todos los métodos HTTP y todos los formatos). Esto significa que para una única URL, puedes tener varios perfiles de datos asociados (un par petición/respuesta externa).

            -
            -
            -

            Visualizando perfiles de datos

            -
            -

            Usando la barra de depuración web

            -

            En el entorno de desarrollo, la barra de depuración web está disponible en la parte inferior de todas las páginas. Esta muestra un buen resumen de los datos perfilados que te da acceso instantáneo a una gran cantidad de información útil cuando algo no funciona como esperabas.

            -

            Si el resumen presentado por las herramientas de la barra de depuración web no es suficiente, haz clic en el enlace simbólico (una cadena compuesta de 13 caracteres aleatorios) para acceder al generador de perfiles web.

            -
            -

            Nota

            -

            Si no se puede hacer clic en el enlace, significa que las rutas del generador de perfiles no están registradas (más adelante hay información de configuración).

            -
            -
            -
            -

            Analizando datos del perfil con el generador de perfiles web

            -

            El generador de perfiles web es una herramienta de visualización para perfilar datos que puedes utilizar en desarrollo para depurar tu código y mejorar el rendimiento; pero también lo puedes utilizar para explorar problemas que ocurren en producción. Este expone toda la información recogida por el generador de perfiles en una interfaz web.

            -
            -
            -

            Accediendo a información del generador de perfiles

            -

            No es necesario utilizar el visualizador predeterminado para acceder a la información de perfiles. Pero ¿cómo se puede recuperar información del perfil de una petición específica después del hecho? Cuando el generador de perfiles almacena datos sobre una Petición, también le asocia una ficha; esta ficha está disponible en la cabecera HTTP X-Debug-Token de la Respuesta:

            -
            $profile = $container->get('profiler')->loadProfileFromResponse($response);
-
-$profile = $container->get('profiler')->loadProfile($token);
-
            -
            -
            -

            Truco

            -

            Cuando el generador de perfiles está habilitado pero no la barra de herramientas de depuración web, o cuando desees obtener la ficha de una petición Ajax, utiliza una herramienta como Firebug para obtener el valor de la cabecera HTTP X-Debug-Token.

            -
            -

            Usa el método find() para acceder a elementos basándose en algún criterio:

            -
            // consigue las 10 últimas fichas
-$tokens = $container->get('profiler')->find('', '', 10);
-
-// consigue las 10 últimas fichas de todas las URL que contienen /admin/
-$tokens = $container->get('profiler')->find('', '/admin/', 10);
-
-// consigue las 10 últimas fichas de peticiones locales
-$tokens = $container->get('profiler')->find('127.0.0.1', '', 10);
-
            -
            -

            Si deseas manipular los datos del perfil en una máquina diferente a la que generó la información, utiliza los métodos export() e import():

            -
            // en la máquina en producción
-$profile = $container->get('profiler')->loadProfile($token);
-$data = $profiler->export($profile);
-
-// en la máquina de desarrollo
-$profiler->import($data);
-
            -
            -
            -
            -

            Configurando

            -

            La configuración predeterminada de Symfony2 viene con ajustes razonables para el generador de perfiles, la barra de herramientas de depuración web, y el generador de perfiles web. Aquí está por ejemplo la configuración para el entorno de desarrollo:

            -
            -
              -
            • YAML
              # carga el generador de perfiles
-framework:
-    profiler: { only_exceptions: false }
-
-# activa el generador de perfiles web
-web_profiler:
-    toolbar: true
-    intercept_redirects: true
-
              -
              -
              • -
            • XML
              <!-- xmlns:webprofiler="http://symfony.com/schema/dic/webprofiler" -->
-<!-- xsi:schemaLocation="http://symfony.com/schema/dic/webprofiler http://symfony.com/schema/dic/webprofiler/webprofiler-1.0.xsd"> -->
-
-<!-- carga el generador de perfiles -->
-<framework:config>
-    <framework:profiler only-exceptions="false" />
-</framework:config>
-
-<!-- activa el generador de perfiles web -->
-<webprofiler:config
-    toolbar="true"
-    intercept-redirects="true"
-    verbose="true"
-/>
-
              -
              -
              • -
            • PHP
              // carga el generador de perfiles
-$container->loadFromExtension('framework', array(
-    'profiler' => array('only-exceptions' => false),
-));
-
-// activa el generador de perfiles web
-$container->loadFromExtension('web_profiler', array(
-    'toolbar'             => true,
-    'intercept-redirects' => true,
-    'verbose'             => true,
-));
-
              -
              -
              • -
            -
            -

            Cuando only-exceptions se establece a true, el generador de perfiles sólo recoge datos cuando tu aplicación lanza una excepción.

            -

            Cuando intercept-redirects está establecido en true, el generador de perfiles web intercepta las redirecciones y te da la oportunidad de analizar los datos recogidos antes de seguir la redirección.

            -

            Si activas el generador de perfiles web, también es necesario montar las rutas de los perfiles:

            -
            -
              -
            • YAML
              _profiler:
-    resource: @WebProfilerBundle/Resources/config/routing/profiler.xml
-    prefix:   /_profiler
              -
              -
              • -
            • XML
              <import resource="@WebProfilerBundle/Resources/config/routing/profiler.xml" prefix="/_profiler" />
-
              -
              -
              • -
            • PHP
              $collection->addCollection($loader->import("@WebProfilerBundle/Resources/config/routing/profiler.xml"), '/_profiler');
-
              -
              -
              • -
            -
            -

            Dado que el generador de perfiles añade algo de sobrecarga, posiblemente desees activarlo sólo bajo ciertas circunstancias en el entorno de producción. La configuración only-exceptions limita al generador de perfiles a 500 páginas, ¿pero si quieres obtener información cuando la IP cliente proviene de una dirección específica, o para una porción limitada del sitio web? Puedes utilizar una emparejadora de petición:

            -
            -
              -
            • YAML
              # activa el generador de perfiles sólo para peticiones entrantes de la red 192.168.0.0
-framework:
-    profiler:
-        matcher: { ip: 192.168.0.0/24 }
-
-# activa el generador de perfiles sólo para las URL /admin
-framework:
-    profiler:
-        matcher: { path: "^/admin/" }
-
-# combina reglas
-framework:
-    profiler:
-        matcher: { ip: 192.168.0.0/24, path: "^/admin/" }
-
-# usa una instancia emparejadora personalizada definida en el servicio 'custom_matcher'
-framework:
-    profiler:
-        matcher: { service: custom_matcher }
-
              -
              -
              • -
            • XML
              <!-- activa el generador de perfiles sólo para peticiones entrantes de la red 192.168.0.0 -->
-<framework:config>
-    <framework:profiler>
-        <framework:matcher ip="192.168.0.0/24" />
-    </framework:profiler>
-</framework:config>
-
-<!-- activa el generador de perfiles sólo para las URL /admin -->
-<framework:config>
-    <framework:profiler>
-        <framework:matcher path="^/admin/" />
-    </framework:profiler>
-</framework:config>
-
-<!-- combina reglas -->
-<framework:config>
-    <framework:profiler>
-        <framework:matcher ip="192.168.0.0/24" path="^/admin/" />
-    </framework:profiler>
-</framework:config>
-
-<!-- usa una instancia emparejadora personalizada definida en el servicio "custom_matcher" -->
-<framework:config>
-    <framework:profiler>
-        <framework:matcher service="custom_matcher" />
-    </framework:profiler>
-</framework:config>
-
              -
              -
              • -
            • PHP
              // activa el generador de perfiles sólo para peticiones entrantes de la red 192.168.0.0
-$container->loadFromExtension('framework', array(
-    'profiler' => array(
-        'matcher' => array('ip' => '192.168.0.0/24'),
-    ),
-));
-
-// activa el generador de perfiles sólo para las URL /admin
-$container->loadFromExtension('framework', array(
-    'profiler' => array(
-        'matcher' => array('path' => '^/admin/'),
-    ),
-));
-
-// combina reglas
-$container->loadFromExtension('framework', array(
-    'profiler' => array(
-        'matcher' => array('ip' => '192.168.0.0/24', 'path' => '^/admin/'),
-    ),
-));
-
-# usa una instancia emparejadora personalizada definida en el servicio 'custom_matcher'
-$container->loadFromExtension('framework', array(
-    'profiler' => array(
-        'matcher' => array('service' => 'custom_matcher'),
-    ),
-));
-
              -
              -
              • -
            -
            -
            -
            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/page_creation.html b/book/page_creation.html deleted file mode 100644 index fdea75c..0000000 --- a/book/page_creation.html +++ /dev/null @@ -1,828 +0,0 @@ - - - - - - - Creando páginas en Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Creando páginas en Symfony2

            -

            Crear una nueva página en Symfony2 es un sencillo proceso de dos pasos:

            -
              -
            • Crea una ruta: Una ruta define la URL de tu página (por ejemplo /sobre) y especifica un controlador (el cual es una función PHP) que Symfony2 debe ejecutar cuando la URL de una petición entrante coincida con el patrón de la ruta;
              • -
            • Crea un controlador: Un controlador es una función PHP que toma la petición entrante y la transforma en el objeto Respuesta de Symfony2 que es devuelto al usuario.
              • -
            -

            Nos encanta este enfoque simple porque coincide con la forma en que funciona la Web. -Cada interacción en la Web se inicia con una petición HTTP. El trabajo de la aplicación simplemente es interpretar la petición y devolver la respuesta HTTP adecuada.

            -

            Symfony2 sigue esta filosofía y te proporciona las herramientas y convenios para mantener organizada tu aplicación a medida que crece en usuarios y complejidad.

            -
            -

            La página «¡Hola Symfony!»

            -

            Vamos a empezar construyendo un subproducto de la clásica aplicación «¡Hola Mundo!». Cuando hayamos terminado, el usuario podrá recibir un saludo personal (por ejemplo, «Hola Symfony») al ir a la siguiente URL:

            -
            http://localhost/app_dev.php/hello/Symfony
-
            -
            -

            En realidad, serás capaz de sustituir Symfony con cualquier otro nombre al cual darle la bienvenida. Para crear la página, sigue el simple proceso de dos pasos.

            -
            -

            Nota

            -

            La guía asume que ya has descargado Symfony2 y configurado tu servidor web. En la URL anterior se supone que localhost apunta al directorio web, de tu nuevo proyecto Symfony2. Para información más detallada sobre este proceso, consulta la documentación del servidor web que estás usando. -Aquí están las páginas de la documentación pertinente para algunos servidores web que podrías estar utilizando:

            - -
            -
            -

            Antes de empezar: Crea el paquete

            -

            Antes de empezar, tendrás que crear un bundle (paquete en adelante). En Symfony2, un paquete es como un complemento (o plugin, para los puristas), salvo que todo el código de tu aplicación debe vivir dentro de un paquete.

            -

            Un paquete no es más que un directorio que alberga todo lo relacionado con una función específica, incluyendo clases PHP, configuración, e incluso hojas de estilo y archivos de Javascript (consulta El sistema de paquetes).

            -

            Para crear un paquete llamado AcmeHelloBundle (el paquete de ejemplo que vamos a construir en este capítulo), ejecuta la siguiente orden y sigue las instrucciones en pantalla (usa todas las opciones predeterminadas):

            -
            $ php app/console generate:bundle --namespace=Acme/HelloBundle --format=yml
-
            -
            -

            Detrás del escenario, se crea un directorio para el paquete en src/Acme/HelloBundle. -Además, automáticamente agrega una línea al archivo app/AppKernel.php para registrar el paquete en el núcleo:

            -
            // app/AppKernel.php
-public function registerBundles()
-{
-    $bundles = array(
-        ...,
-        new Acme\HelloBundle\AcmeHelloBundle(),
-    );
-    // ...
-
-    return $bundles;
-}
-
            -
            -

            Ahora que ya está configurado el paquete, puedes comenzar a construir tu aplicación dentro del paquete.

            -
            -
            -

            Paso 1: Creando la ruta

            -

            De manera predeterminada, el archivo de configuración de enrutado en una aplicación Symfony2 se encuentra en app/config/routing.yml. Al igual que toda la configuración en Symfony2, fuera de la caja también puedes optar por utilizar XML o PHP para configurar tus rutas.

            -

            Si te fijas en el archivo de enrutado principal, verás que Symfony ya ha agregado una entrada al generar el AcmeHelloBundle:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-acme_hello:
-    resource: "@AcmeHelloBundle/Resources/config/routing.yml"
-    prefix:   /
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <import resource="@AcmeHelloBundle/Resources/config/routing.xml" prefix="/" />
-</routes>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->addCollection(
-    $loader->import('@AcmeHelloBundle/Resources/config/routing.php'),
-    '/',
-);
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Esta entrada es bastante básica: le dice a Symfony que cargue la configuración de enrutado del archivo Resources/config/routing.yml que reside en el interior del AcmeHelloBundle. -Esto significa que colocas la configuración de enrutado directamente en app/config/routing.yml u organizas tus rutas a través de tu aplicación, y las importas desde ahí.

            -

            Ahora que el archivo routing.yml es importado desde el paquete, añade la nueva ruta que define la URL de la página que estás a punto de crear:

            -
            -
              -
            • YAML
              # src/Acme/HelloBundle/Resources/config/routing.yml
-hello:
-    path:     /hello/{name}
-    defaults: { _controller: AcmeHelloBundle:Hello:index }
-
              -
              -
              • -
            • XML
              <!-- src/Acme/HelloBundle/Resources/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="hello" path="/hello/{name}">
-        <default key="_controller">AcmeHelloBundle:Hello:index</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              // src/Acme/HelloBundle/Resources/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('hello', new Route('/hello/{name}', array(
-    '_controller' => 'AcmeHelloBundle:Hello:index',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            La ruta se compone de dos piezas básicas: path, que es la URL con la que esta ruta debe coincidir, y un arreglo defaults, que especifica el controlador que se debe ejecutar. La sintaxis del marcador de posición ({name}) en la ruta es un comodín. Significa que /hello/Ryan, /hello/Fabien o cualquier otra URI similar coincidirá con esta ruta. El parámetro marcador de posición {name} también se pasará al controlador, de manera que podamos utilizar su valor para saludar personalmente al usuario.

            -
            -

            Nota

            -

            El sistema de enrutado tiene muchas más características para crear estructuras URI flexibles y potentes en tu aplicación. Para más detalles, consulta el capítulo Enrutando.

            -
            -
            -
            -

            Paso 2: Creando el controlador

            -

            Cuando una URL como /hello/Ryan es manejada por la aplicación, la ruta hello corresponde con el controlador AcmeHelloBundle:Hello:index el cual es ejecutado por la plataforma. El segundo paso del proceso de creación de páginas es precisamente la creación de ese controlador.

            -

            El controlador — AcmeHelloBundle:Hello:index es el nombre lógico del controlador, el cual se asigna al método indexAction de una clase PHP llamada Acme\HelloBundle\Controller\HelloController. Empieza creando este archivo dentro de tu AcmeHelloBundle:

            -
            // src/Acme/HelloBundle/Controller/HelloController.php
-namespace Acme\HelloBundle\Controller;
-
-class HelloController
-{
-}
-
            -
            -

            En realidad, el controlador no es más que un método PHP que tú creas y Symfony ejecuta. Aquí es donde el código utiliza la información de la petición para construir y preparar el recurso solicitado. Salvo en algunos casos avanzados, el producto final de un controlador siempre es el mismo: un objeto Respuesta de Symfony2.

            -

            Crea el método indexAction que Symfony ejecutará cuando concuerde la ruta hello:

            -
            // src/Acme/HelloBundle/Controller/HelloController.php
-namespace Acme\HelloBundle\Controller;
-
-use Symfony\Component\HttpFoundation\Response;
-
-class HelloController
-{
-    public function indexAction($name)
-    {
-        return new Response('<html><body>Hello '.$name.'!</body></html>');
-    }
-}
-
            -
            -

            El controlador es simple: este crea un nuevo objeto Respuesta, cuyo primer argumento es el contenido que se debe utilizar para la respuesta (una pequeña página HTML en este ejemplo).

            -

            ¡Enhorabuena! Después de crear solamente una ruta y un controlador ¡ya tienes una página completamente operativa! Si todo lo has configurado correctamente, la aplicación debe darte la bienvenida:

            -
            http://localhost/app_dev.php/hello/Ryan
-
            -
            -
            -

            Truco

            -

            También puedes ver tu aplicación en el entorno «prod» visitando:

            -
            http://localhost/app.php/hello/Ryan
-
            -
            -

            Si se produce un error, probablemente sea porque necesitas vaciar la caché ejecutando:

            -
            $ php app/console cache:clear --env=prod --no-debug
-
            -
            -
            -

            Un opcional, pero frecuente, tercer paso en el proceso es crear una plantilla.

            -
            -

            Nota

            -

            Los controladores son el punto de entrada principal a tu código y un ingrediente clave en la creación de páginas. Puedes encontrar mucho más información en el capítulo Controlador.

            -
            -
            -
            -

            Paso 3 opcional: Creando la plantilla

            -

            Las plantillas te permiten mover toda la presentación (por ejemplo, el código HTML) a un archivo separado y reutilizar diferentes partes del diseño de la página. En vez de escribir el código HTML dentro del controlador, en su lugar reproduce una plantilla:

            -
             1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
-10
-11
-12
-13
-14
-15
-16
-17
-18
-19
-20
-21
            // src/Acme/HelloBundle/Controller/HelloController.php
-namespace Acme\HelloBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class HelloController extends Controller
-{
-    public function indexAction($name)
-    {
-        return $this->render(
-            'AcmeHelloBundle:Hello:index.html.twig',
-            array('name' => $name)
-        );
-
-        // dibuja una plantilla PHP en su lugar
-        // return $this->render(
-        //     'AcmeHelloBundle:Hello:index.html.php',
-        //     array('name' => $name)
-        // );
-    }
-}
-
            -
            -
            -

            Nota

            -

            Para poder usar el método render(), tu controlador debe extender la clase Symfony\Bundle\FrameworkBundle\Controller\Controller que añade atajos para las tareas comunes en los controladores. Esto se hace en el ejemplo anterior añadiendo la declaración use en la línea 4 y luego extendiendo el Controlador en la línea 6.

            -
            -

            El método render() crea un objeto Respuesta poblado con el contenido propuesto, y reproduce la plantilla. Como cualquier otro controlador, en última instancia vas a devolver ese objeto Respuesta.

            -

            Ten en cuenta que hay dos ejemplos diferentes para procesar la plantilla. -De forma predeterminada, Symfony2 admite dos diferentes lenguajes de plantillas: las clásicas plantillas PHP y las breves pero poderosas plantillas Twig. No te espantes —eres libre de optar por una o, incluso, ambas en el mismo proyecto.

            -

            El controlador procesa la plantilla AcmeHelloBundle:Hello:index.html.twig, utilizando la siguiente convención de nomenclatura:

            -
            -
            NombrePaquete:NombreControlador:NombrePlantilla
            -

            Este es el nombre lógico de la plantilla, el cual se asigna a una ubicación física usando la siguiente convención.

            -
            -
            /ruta/a/NombrePaquete/Resources/views/NombreControlador/NombrePlantilla
            -

            En este caso, AcmeHelloBundle es el nombre del paquete, Hello es el controlador e index.html.twig la plantilla:

            -
            -
              -
            • Twig
              1
-2
-3
-4
-5
-6
               {# src/Acme/HelloBundle/Resources/views/Hello/index.html.twig #}
- {% extends '::base.html.twig' %}
-
- {% block body %}
-     Hello {{ name }}!
- {% endblock %}
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/HelloBundle/Resources/views/Hello/index.html.php -->
-<?php $view->extend('::base.html.php') ?>
-
-Hello <?php echo $view->escape($name) ?>!
-
              -
              -
              • -
            -
            -

            Veamos la situación a través de la plantilla Twig línea por línea:

            -
              -
            • línea 2: La etiqueta extends define una plantilla padre. La plantilla define explícitamente un archivo con el diseño dentro del cual será colocada.
              • -
            • línea 4: La etiqueta block dice que todo el interior se debe colocar dentro de un bloque llamado body. Como verás, es responsabilidad de la plantilla padre (base.html.twig) reproducir, en última instancia, el bloque llamado body.
              • -
            -

            La plantilla padre, ::base.html.twig, omite ambas porciones de su nombre tanto NombrePaquete como NombreControlador (de ahí los dobles dos puntos (::) al principio). Esto significa que la plantilla vive fuera de cualquier paquete, en el directorio app:

            -
            -
              -
            • Twig
              {# app/Resources/views/base.html.twig #}
-<!DOCTYPE html>
-    <html>
-        <head>
-        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-        <title>{% block title %}Welcome!{% endblock %}</title>
-        {% block stylesheets %}{% endblock %}
-        <link rel="shortcut icon" href="{{ asset('favicon.ico') }}" />
-        </head>
-        <body>
-        {% block body %}{% endblock %}
-        {% block javascripts %}{% endblock %}
-    </body>
-</html>
-
              -
              -
              • -
            • PHP
              <!-- app/Resources/views/base.html.php -->
-<!DOCTYPE html>
-    <html>
-        <head>
-        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-        <title><?php $view['slots']->output('title', 'Welcome!') ?></title>
-        <?php $view['slots']->output('stylesheets') ?>
-        <link rel="shortcut icon" href="<?php echo $view['assets']->getUrl('favicon.ico') ?>" />
-        </head>
-        <body>
-        <?php $view['slots']->output('_content') ?>
-        <?php $view['slots']->output('javascripts') ?>
-    </body>
-</html>
-
              -
              -
              • -
            -
            -

            El archivo de la plantilla base define el diseño HTML y reproduce el bloque body que definiste en la plantilla index.html.twig. Además reproduce el bloque title, el cual puedes optar por definir en la plantilla index.html.twig. -Dado que no has definido el bloque title en la plantilla derivada, el valor predeterminado es «Welcome!».

            -

            Las plantillas son una poderosa manera de reproducir y organizar el contenido de tu página. Una plantilla puede reproducir cualquier cosa, desde el marcado HTML, al código CSS, o cualquier otra cosa que el controlador posiblemente tenga que devolver.

            -

            En el ciclo de vida del manejo de una petición, el motor de plantillas simplemente es una herramienta opcional. Recuerda que el objetivo de cada controlador es devolver un objeto Respuesta. Las plantillas son una poderosa, pero opcional, herramienta para crear el contenido de ese objeto Respuesta.

            -
            -
            -
            -

            La estructura de directorios

            -

            Después de unas cortas secciones, ya entiendes la filosofía detrás de la creación y procesamiento de páginas en Symfony2. También has comenzado a ver cómo están estructurados y organizados los proyectos Symfony2. Al final de esta sección, sabrás dónde encontrar y colocar diferentes tipos de archivos y por qué.

            -

            Aunque totalmente flexible, por omisión, cada aplicación Symfony tiene la misma estructura de directorios básica y recomendada:

            -
              -
            • app/: Este directorio contiene la configuración de la aplicación;
              • -
            • src/: Todo el código PHP del proyecto se almacena en este directorio;
              • -
            • vendor/: Por convención aquí se coloca cualquier biblioteca de terceros;
              • -
            • web/: Este es el directorio web raíz y contiene todos los archivos de acceso público;
              • -
            -
            -

            El directorio web

            -

            El directorio raíz del servidor web, es el hogar de todos los archivos públicos y estáticos tales como imágenes, hojas de estilo y archivos JavaScript. También es el lugar donde vive cada controlador frontal:

            -
            // web/app.php
-require_once __DIR__.'/../app/bootstrap.php.cache';
-require_once __DIR__.'/../app/AppKernel.php';
-
-use Symfony\Component\HttpFoundation\Request;
-
-$kernel = new AppKernel('prod', false);
-$kernel->loadClassCache();
-$kernel->handle(Request::createFromGlobals())->send();
-
            -
            -

            El archivo del controlador frontal (app.php en este ejemplo) es el archivo PHP que realmente se ejecuta cuando utilizas una aplicación Symfony2 y su trabajo consiste en utilizar una clase del núcleo, AppKernel, para arrancar la aplicación.

            -
            -

            Truco

            -

            Tener un controlador frontal significa que se utilizan diferentes y más flexibles URL que en una aplicación PHP típica. Cuando usamos un controlador frontal, las URL se formatean de la siguiente manera:

            -
            http://localhost/app.php/hello/Ryan
-
            -
            -

            El controlador frontal, app.php, se ejecuta y la URL «interna»: /hello/Ryan es encaminada internamente con la configuración de enrutado. -Al utilizar las reglas mod_rewrite de Apache, puedes forzar la ejecución del archivo app.php sin necesidad de especificarlo en la URL:

            -
            http://localhost/hello/Ryan
-
            -
            -
            -

            Aunque los controladores frontales son esenciales en el manejo de cada petición, rara vez los tendrás que modificar o incluso pensar en ellos. Los vamos a mencionar brevemente de nuevo en la sección de Entornos.

            -
            -
            -

            El directorio de la aplicación (app)

            -

            Como vimos en el controlador frontal, la clase AppKernel es el punto de entrada principal de la aplicación y es la responsable de toda la configuración. Como tal, se almacena en el directorio app/.

            -

            Esta clase debe implementar dos métodos que definen todo lo que Symfony necesita saber acerca de tu aplicación. Ni siquiera tienes que preocuparte de estos métodos durante el arranque —Symfony los llena por ti con parámetros predeterminados.

            -
              -
            • registerBundles(): Devuelve un arreglo con todos los paquetes necesarios para ejecutar la aplicación (consulta El sistema de paquetes);
              • -
            • registerContainerConfiguration(): Carga el archivo de configuración de recursos principal de la aplicación (consulta la sección Configurando la aplicación);
              • -
            -

            En el desarrollo del día a día, generalmente vas a utilizar el directorio app/ para modificar la configuración y los archivos de enrutado en el directorio app/config/ (consulta la sección Configurando la aplicación). Este también contiene el directorio caché de la aplicación (app/cache), un directorio de registro (app/logs) y un directorio para archivos de recursos a nivel de la aplicación, tal como plantillas (app/Resources). -Aprenderás más sobre cada uno de estos directorios en capítulos posteriores.

            - -
            -
            -

            El directorio fuente (src)

            -

            En pocas palabras, el directorio src/ contiene todo el código real (código PHP, plantillas, archivos de configuración, estilo, etc.) que impulsa a tu aplicación. -De hecho, cuando desarrollas, la gran mayoría de tu trabajo se llevará a cabo dentro de uno o más paquetes creados en este directorio.

            -

            Pero, ¿qué es exactamente un paquete?

            -
            -
            -
            -

            El sistema de paquetes

            -

            Un paquete es similar a un complemento en otro software, pero aún mejor. La diferencia clave es que en Symfony2 todo es un paquete, incluyendo tanto la funcionalidad básica de la plataforma como el código escrito para tu aplicación. -Los paquetes son ciudadanos de primera clase en Symfony2. Esto te proporciona la flexibilidad para utilizar las características preconstruidas envasadas en paquetes de terceros o para distribuir tus propios paquetes. Además, facilita la selección y elección de las características por habilitar en tu aplicación y optimizarlas en la forma que desees.

            -
            -

            Nota

            -

            Si bien, aquí vamos a cubrir lo básico, hay un capítulo dedicado completamente al tema de los paquetes.

            -
            -

            Un paquete simplemente es un conjunto estructurado de archivos en un directorio que implementa una sola característica. Puedes crear un BlogBundle, un ForoBundle o un paquete para gestionar usuarios (muchos de ellos ya existen como paquetes de código abierto). Cada directorio contiene todo lo relacionado con esa característica, incluyendo archivos PHP, plantillas, hojas de estilo, archivos Javascript, pruebas y cualquier otra cosa necesaria. -Cada aspecto de una característica existe en un paquete y cada característica vive en un paquete.

            -

            Una aplicación se compone de paquetes tal como está definido en el método registerBundles() de la clase AppKernel:

            -
            // app/AppKernel.php
-public function registerBundles()
-{
-    $bundles = array(
-        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
-        new Symfony\Bundle\SecurityBundle\SecurityBundle(),
-        new Symfony\Bundle\TwigBundle\TwigBundle(),
-        new Symfony\Bundle\MonologBundle\MonologBundle(),
-        new Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle(),
-        new Symfony\Bundle\DoctrineBundle\DoctrineBundle(),
-        new Symfony\Bundle\AsseticBundle\AsseticBundle(),
-        new Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle(),
-        new JMS\SecurityExtraBundle\JMSSecurityExtraBundle(),
-    );
-
-    if (in_array($this->getEnvironment(), array('dev', 'test'))) {
-        $bundles[] = new Acme\DemoBundle\AcmeDemoBundle();
-        $bundles[] = new Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
-        $bundles[] = new Sensio\Bundle\DistributionBundle\SensioDistributionBundle();
-        $bundles[] = new Sensio\Bundle\GeneratorBundle\SensioGeneratorBundle();
-    }
-
-    return $bundles;
-}
-
            -
            -

            Con el método registerBundles(), tienes el control total sobre cuales paquetes utiliza tu aplicación (incluyendo los paquetes del núcleo de Symfony).

            -
            -

            Truco

            -

            Un paquete puede vivir en cualquier lugar siempre y cuando Symfony2 lo pueda cargar automáticamente (vía el autocargador configurado en app/autoload.php).

            -
            -
            -

            Creando un paquete

            -

            La edición estándar de Symfony viene con una práctica tarea que crea un paquete totalmente operativo para ti. Por supuesto, la creación manual de un paquete también es muy fácil.

            -

            Para mostrarte lo sencillo que es el sistema de paquetes, vamos a crear y activar un nuevo paquete llamado AcmeTestBundle.

            -
            -

            Truco

            -

            La parte Acme es sólo un nombre ficticio que debes sustituir por un «proveedor» que represente tu nombre u organización (por ejemplo, ABCTestBundle por alguna empresa llamada ABC).

            -
            -

            En primer lugar, crea un directorio src/Acme/TestBundle/ y añade un nuevo archivo llamado AcmeTestBundle.php:

            -
            // src/Acme/TestBundle/AcmeTestBundle.php
-namespace Acme\TestBundle;
-
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
-
-class AcmeTestBundle extends Bundle
-{
-}
-
            -
            -
            -

            Truco

            -

            El nombre AcmeTestBundle sigue las convenciones de nomenclatura de paquetes estándar. -También puedes optar por acortar el nombre del paquete simplemente a TestBundle al nombrar esta clase TestBundle (y el nombre del archivo TestBundle.php).

            -
            -

            Esta clase vacía es la única pieza que necesitamos para crear nuestro nuevo paquete. Aunque comúnmente está vacía, esta clase es poderosa y se puede utilizar para personalizar el comportamiento del paquete.

            -

            Ahora que creaste tu paquete, tienes que activarlo a través de la clase AppKernel:

            -
            // app/AppKernel.php
-public function registerBundles()
-{
-    $bundles = array(
-        ...,
-        // registra tus paquetes
-        new Acme\TestBundle\AcmeTestBundle(),
-    );
-    // ...
-
-    return $bundles;
-}
-
            -
            -

            Y si bien AcmeTestBundle aún no hace nada, está listo para utilizarlo.

            -

            Y aunque esto es bastante fácil, Symfony también proporciona una interfaz de línea de ordenes para generar una estructura de paquete básica:

            -
            $ php app/console generate:bundle --namespace=Acme/TestBundle
-
            -
            -

            Esto genera el esqueleto del paquete con un controlador básico, la plantilla y recursos de enrutado que se pueden personalizar. Aprenderás más sobre la línea de ordenes de las herramientas de Symfony2 más tarde.

            -
            -

            Truco

            -

            Cuando quieras crear un nuevo paquete o uses un paquete de terceros, siempre asegúrate de habilitar el paquete en registerBundles(). Cuando usas la orden generate:bundle, hace esto para ti.

            -
            -
            -
            -

            Estructura de directorios de un paquete

            -

            La estructura de directorios de un paquete es simple y flexible. De forma predeterminada, el sistema de paquetes sigue una serie de convenciones que ayudan a mantener el código consistente entre todos los paquetes Symfony2. Echa un vistazo a AcmeHelloBundle, ya que contiene algunos de los elementos más comunes de un paquete:

            -
              -
            • Controller/ Contiene los controladores del paquete (por ejemplo, HelloController.php);
              • -
            • DependencyInjection/ mantiene ciertas extensiones para las clases de inyección de dependencias, qué configuración puede importar el servicio, registra uno o más pases del compilador (este directorio no es necesario);
              • -
            • Resources/config/ Contiene la configuración, incluyendo la configuración de enrutado (por ejemplo, routing.yml);
              • -
            • Resources/views/ Contiene las plantillas organizadas por nombre de controlador (por ejemplo, Hello/index.html.twig);
              • -
            • Resources/public/ Contiene recursos web (imágenes, hojas de estilo, etc.) y es copiado o enlazado simbólicamente al directorio web/ del proyecto vía la orden de consola assets:install;
              • -
            • Tests/ Tiene todas las pruebas para el paquete.
              • -
            -

            Un paquete puede ser tan pequeño o tan grande como la característica que implementa. Este contiene sólo los archivos que necesita y nada más.

            -

            A medida que avances en el libro, aprenderás cómo persistir objetos a una base de datos, crear y validar formularios, crear traducciones para tu aplicación, escribir pruebas y mucho más. Cada uno de estos tiene su propio lugar y rol dentro del paquete.

            -
            -
            -
            -

            Configurando la aplicación

            -

            La aplicación consiste de una colección de paquetes que representan todas las características y capacidades de tu aplicación. Cada paquete se puede personalizar a través de archivos de configuración escritos en YAML, XML o PHP. De forma predeterminada, el archivo de configuración principal vive en el directorio app/config/ y se llama config.yml, config.xml o config.php en función del formato que prefieras:

            -
            -
              -
            • YAML
              # app/config/config.yml
-imports:
-    - { resource: parameters.yml }
-    - { resource: security.yml }
-
-framework:
-    secret:          "%secret%"
-    router:          { resource: "%kernel.root_dir%/config/routing.yml" }
-    # ...
-
-# Twig Configuration
-twig:
-    debug:            "%kernel.debug%"
-    strict_variables: "%kernel.debug%"
-
-# ...
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<imports>
-    <import resource="parameters.yml" />
-    <import resource="security.yml" />
-</imports>
-
-<framework:config secret="%secret%">
-    <framework:router resource="%kernel.root_dir%/config/routing.xml" />
-    <!-- ... -->
-</framework:config>
-
-<!-- Twig Configuration -->
-<twig:config debug="%kernel.debug%" strict-variables="%kernel.debug%" />
-
-<!-- ... -->
-
              -
              -
              • -
            • PHP
              $this->import('parameters.yml');
-$this->import('security.yml');
-
-$container->loadFromExtension('framework', array(
-    'secret'          => '%secret%',
-    'router'          => array('resource' => '%kernel.root_dir%/config/routing.php'),
-    // ...
-    ),
-));
-
-// Configuración Twig
-$container->loadFromExtension('twig', array(
-    'debug'            => '%kernel.debug%',
-    'strict_variables' => '%kernel.debug%',
-));
-
-// ...
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Aprenderás exactamente cómo cargar cada archivo/formato en la siguiente sección, Entornos.

            -
            -

            Cada entrada de nivel superior como framework o twig define la configuración de un paquete específico. Por ejemplo, la clave framework define la configuración para el núcleo de Symfony FrameworkBundle e incluye la configuración de enrutado, plantillas, y otros sistemas del núcleo.

            -

            Por ahora, no te preocupes por las opciones de configuración específicas de cada sección. -El archivo de configuración viene con parámetros predeterminados. A medida que leas y explores más cada parte de Symfony2, aprenderás sobre las opciones de configuración específicas de cada característica.

            -
            -

            Formatos de configuración

            -

            A lo largo de los capítulos, todos los ejemplos de configuración muestran los tres formatos (YAML, XML y PHP). Cada uno tiene sus propias ventajas y desventajas. Tú eliges cual utilizar:

            -
              -
            • YAML: Sencillo, limpio y legible (aprende más sobre yaml en «El formato YAML»);
              • -
            • XML: Más poderoso que YAML a veces y es compatible con el autocompletado del IDE;
              • -
            • PHP: Muy potente, pero menos fácil de leer que los formatos de configuración estándar.
              • -
            -
            -
            -

            Volcando la configuración predefinida

            -

            -Nuevo en la versión 2.1: La orden config:dump-reference se añadió en Symfony 2.1

            -

            Puedes volcar a la consola la configuración predefinida en YAML de un paquete usando la orden config:dump-reference. He aquí un ejemplo del volcado de la configuración predefinida del FrameworkBundle:

            -
            app/console config:dump-reference FrameworkBundle
-
            -
            -

            También puedes usar el alias de la extensión (la clave en el archivo de configuración):

            -
            app/console config:dump-reference framework
-
            -
            -
            -

            Nota

            -

            Revisa el artículo del recetario: Cómo exponer la configuración semántica de un paquete para información sobre cómo añadir configuración a tus propios paquetes.

            -
            -
            -
            -
            -

            Entornos

            -

            Una aplicación puede funcionar en diversos entornos. Los diferentes entornos comparten el mismo código PHP (aparte del controlador frontal), pero usan diferente configuración. Por ejemplo, un entorno de desarrollo dev registrará las advertencias y errores, mientras que un entorno de producción prod sólo registra los errores. Algunos archivos se vuelven a generar en cada petición en el entorno dev (para mayor comodidad de los desarrolladores), pero se memorizan en caché en el entorno prod. Todos los entornos viven juntos en la misma máquina y ejecutan la misma aplicación.

            -

            Un proyecto Symfony2 generalmente comienza con tres entornos (dev, test y prod), aunque la creación de nuevos entornos es fácil. Puedes ver tu aplicación en diferentes entornos con sólo cambiar el controlador frontal en tu navegador. Para ver la aplicación en el entorno dev, accede a la aplicación a través del controlador frontal de desarrollo:

            -
            http://localhost/app_dev.php/hello/Ryan
-
            -
            -

            Si deseas ver cómo se comportará tu aplicación en el entorno de producción, en su lugar, llama al controlador frontal prod:

            -
            http://localhost/app.php/hello/Ryan
-
            -
            -

            Puesto que el entorno prod está optimizado para velocidad; la configuración, el enrutado y las plantillas Twig se compilan en clases PHP simples y se guardan en caché. -Cuando veas los cambios en el entorno prod, tendrás que borrar estos archivos memorizados en caché y así permitir su reconstrucción:

            -
            $ php app/console cache:clear --env=prod --no-debug
-
            -
            -
            -

            Nota

            -

            Si abres el archivo web/app.php, encontrarás que está configurado explícitamente para usar el entorno prod:

            -
            $kernel = new AppKernel('prod', false);
-
            -
            -

            Puedes crear un nuevo controlador frontal para un nuevo entorno copiando el archivo y cambiando prod por algún otro valor.

            -
            -
            -

            Nota

            -

            El entorno test se utiliza cuando se ejecutan pruebas automáticas y no se puede acceder directamente a través del navegador. Consulta el capítulo Probando para más detalles.

            -
            -
            -

            Configurando entornos

            -

            La clase AppKernel es responsable de cargar realmente el archivo de configuración de tu elección:

            -
            // app/AppKernel.php
-public function registerContainerConfiguration(LoaderInterface $loader)
-{
-    $loader->load(
-        __DIR__.'/config/config_'.$this->getEnvironment().'.yml'
-    );
-}
-
            -
            -

            Ya sabes que la extensión .yml se puede cambiar a .xml o .php si prefieres usar XML o PHP para escribir tu configuración. -Además, observa que cada entorno carga su propio archivo de configuración. Considera el archivo de configuración para el entorno dev.

            -
            -
              -
            • YAML
              # app/config/config_dev.yml
-imports:
-    - { resource: config.yml }
-
-framework:
-    router:   { resource: "%kernel.root_dir%/config/routing_dev.yml" }
-    profiler: { only_exceptions: false }
-
-# ...
-
              -
              -
              • -
            • XML
              <!-- app/config/config_dev.xml -->
-<imports>
-    <import resource="config.xml" />
-</imports>
-
-<framework:config>
-    <framework:router resource="%kernel.root_dir%/config/routing_dev.xml" />
-    <framework:profiler only-exceptions="false" />
-</framework:config>
-
-<!-- ... -->
-
              -
              -
              • -
            • PHP
              // app/config/config_dev.php
-$loader->import('config.php');
-
-$container->loadFromExtension('framework', array(
-    'router'   => array('resource' => '%kernel.root_dir%/config/routing_dev.php'),
-    'profiler' => array('only-exceptions' => false),
-));
-
-// ...
-
              -
              -
              • -
            -
            -

            La clave imports es similar a una declaración include PHP y garantiza que en primer lugar se carga el archivo de configuración principal (config.yml). El resto del archivo de configuración predeterminado aumenta el registro en la bitácora de eventos y otros ajustes conducentes a un entorno de desarrollo.

            -

            Ambos entornos prod y test siguen el mismo modelo: cada uno importa el archivo de configuración básico y luego modifica sus valores de configuración para adaptarlos a las necesidades específicas del entorno. Esto es sólo una convención, pero te permite reutilizar la mayor parte de tu configuración y personalizar sólo piezas puntuales entre entornos.

            -
            -
            -
            -

            Resumen

            -

            ¡Enhorabuena! Ahora has visto todos los aspectos fundamentales de Symfony2 y afortunadamente descubriste lo fácil y flexible que puede ser. Y si bien aún hay muchas características por venir, asegúrate de tener en cuenta los siguientes puntos básicos:

            -
              -
            • La creación de una página es un proceso de tres pasos que involucran una ruta, un controlador y (opcionalmente) una plantilla;
              • -
            • Cada proyecto sólo contiene unos cuantos directorios principales: web/ (recursos web y controladores frontales), app/ (configuración), src/ (tus paquetes), y vendor/ (código de terceros) (también hay un directorio bin/ que se utiliza para ayudarte a actualizar las bibliotecas de proveedores);
              • -
            • Cada característica en Symfony2 (incluyendo el núcleo de la plataforma Symfony2) está organizada en un paquete, el cual es un conjunto estructurado de archivos para esa característica;
              • -
            • La configuración de cada paquete vive en el directorio Resources/config del paquete y se puede especificar en YAML, XML o PHP;
              • -
            • La configuración global de la aplicación vive en el directorio app/config/;
              • -
            • Cada entorno es accesible a través de un diferente controlador frontal (por ejemplo, app.php y app_dev.php) el cual carga un archivo de configuración diferente.
              • -
            -

            A partir de aquí, cada capítulo te dará a conocer más y más potentes herramientas y conceptos avanzados. Cuanto más sepas sobre Symfony2, tanto más apreciarás la flexibilidad de su arquitectura y el poder que te proporciona para desarrollar aplicaciones rápidamente.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/performance.html b/book/performance.html deleted file mode 100644 index b08a2a7..0000000 --- a/book/performance.html +++ /dev/null @@ -1,199 +0,0 @@ - - - - - - - Rendimiento — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Rendimiento

            -

            Symfony2 es rápido, desde que lo sacas de la caja. Por supuesto, si realmente necesitas velocidad, hay muchas maneras en las cuales puedes hacer que Symfony sea aún más rápido. En este capítulo, podrás explorar muchas de las formas más comunes y potentes para hacer que tu aplicación Symfony sea aún más rápida.

            -
            -

            Utilizando una caché de código de bytes (p. ej. APC)

            -

            Una de las mejores (y más fáciles) cosas que debes hacer para mejorar el rendimiento es utilizar una «caché de código de bytes». La idea de una caché de código de bytes es eliminar la necesidad de constantemente tener que volver a compilar el código fuente PHP. Hay disponible una serie de cachés de código de bytes, algunas de las cuales son de código abierto. Probablemente, la caché de código de bytes más utilizada sea APC

            -

            Usar una caché de código de bytes realmente no tiene ningún inconveniente, y Symfony2 se ha diseñado para desempeñarse muy bien en este tipo de entorno.

            -
            -

            Optimización adicional

            -

            La caché de código de bytes, por lo general, comprueba los cambios de los archivos fuente. Esto garantiza que si cambias un archivo fuente, el código de bytes se vuelve a compilar automáticamente. -Esto es muy conveniente, pero, obviamente, implica una sobrecarga.

            -

            Por esta razón, algunas cachés de código de bytes ofrecen una opción para desactivar esa comprobación. -Obviamente, cuando desactivas esta comprobación, será responsabilidad del administrador del servidor asegurarse de que la caché se borra cada vez que cambia un archivo fuente. De lo contrario, no se verán los cambios realizados.

            -

            Por ejemplo, para desactivar estos controles en APC, sólo tienes que añadir la opción apc.stat=0 en tu archivo de configuración php.ini.

            -
            -
            -
            -

            Usa la funcionalidad de asociación de clases de Composer

            -

            De manera predeterminada, la edición estándar de Symfony2 utiliza el autocargador en el archivo autoload.php. Este autocargador es fácil de usar, ya que automáticamente encontrará cualquier nueva clase que hayas colocado en los directorios registrados.

            -

            Desafortunadamente, esto tiene un costo, puesto que el cargador itera en todos los espacios de nombres configurados para encontrar un archivo, haciendo llamadas a file_exists hasta que finalmente encuentra el archivo que estás buscando.

            -

            La solución más sencilla es decirle a Composer que construya un «mapa de clases» (es decir, un gran arreglo con la ubicación de todas las clases). Esto se puede hacer desde la línea de ordenes, y se podría convertir en parte de tu proceso de despliegue:

            -
            php composer.phar dump-autoload --optimize
-
            -
            -

            Internamente, esto construye el gran arreglo con el mapa de clases en vendor/composer/autoload_namespaces.php.

            -
            -
            -

            Memorizando en caché el autocargador con APC

            -

            Otra solución es memorizar en caché la ubicación de cada clase después de localizarla -por primera vez. Symfony viene con una clase —Symfony\Component\ClassLoader\ApcClassLoader— que hace eso exactamente. Para usarla, sólo adapta tu archivo del controlador frontal. -Si estás utilizando la distribución estándar, este código ya debe estar disponible como comentarios en este archivo:

            -
            // app.php
-// ...
-
-$loader = require_once __DIR__.'/../app/bootstrap.php.cache';
-
-// Usa APC para mejorar el rendimiento de la carga automática
-// Cambia 'sf2' por el prefijo que desees a fin de evitar
-// conflictos de clave con otra aplicación.
-/*
-$loader = new ApcClassLoader('sf2', $loader);
-$loader->register(true);
-*/
-
-// ...
-
            -
            -
            -

            Nota

            -

            Al utilizar el cargador automático APC, si agregas nuevas clases, las encontrará automáticamente y todo funcionará igual que antes (es decir, no hay razón para «limpiar» la caché). Sin embargo, si cambias la ubicación de un determinado espacio de nombres o prefijo, tendrás que limpiar tu caché APC. De lo contrario, el cargador aún buscará en la ubicación anterior todas las clases dentro de ese espacio de nombres.

            -
            -
            -
            -

            Utilizando archivos de arranque

            -

            Para garantizar una óptima flexibilidad y reutilización de código, las aplicaciones de Symfony2 aprovechan una variedad de clases y componentes de terceros. Pero cargar todas estas clases desde archivos separados en cada petición puede dar lugar a alguna sobrecarga. Para reducir esta sobrecarga, la edición estándar de Symfony2 proporciona un guión para generar lo que se conoce como archivo de arranque, el cual contiene la definición de múltiples clases en un solo archivo. Al incluir este archivo (el cual contiene una copia de muchas de las clases del núcleo), Symfony ya no tiene que incluir algunos de los archivos de código fuente que contienen las clases. Esto reducirá bastante la E/S del disco.

            -

            Si estás utilizando la edición estándar de Symfony2, entonces probablemente ya estás utilizando el archivo de arranque. Para estar seguro, abre el controlador frontal (por lo general app.php) y asegúrate de que existe la siguiente línea:

            -
            require_once __DIR__.'/../app/bootstrap.php.cache';
-
            -
            -

            Ten en cuenta que hay dos desventajas cuando utilizas un archivo de arranque:

            -
              -
            • El archivo se tiene que regenerar cada vez que cambia alguna de las fuentes original (es decir, cuando actualizas el código fuente de Symfony2 o las bibliotecas de proveedores);
              • -
            • En la depuración, será necesario colocar puntos de interrupción dentro del archivo de arranque.
              • -
            -

            Si estás utilizando la edición estándar de Symfony2, los archivos de arranque se reconstruyen automáticamente después de actualizar las bibliotecas de proveedores a través de la orden php composer.phar install.

            -
            -

            Archivos de arranque y caché de código de bytes

            -

            Incluso cuando utilizas código de bytes en caché, el rendimiento mejorará cuando utilices un archivo de arranque ya que habrá menos archivos en los cuales supervisar cambios. Por supuesto, si esta función está desactivada en la caché del código de bytes (por ejemplo, apc.stat = 0 en APC), no existe una razón para utilizar un archivo de arranque.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/propel.html b/book/propel.html deleted file mode 100644 index fa28ef9..0000000 --- a/book/propel.html +++ /dev/null @@ -1,493 +0,0 @@ - - - - - - - Bases de datos y Propel — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Bases de datos y Propel

            -

            Seamos realistas, una de las tareas más comunes y desafiantes para cualquier aplicación involucra la persistencia y lectura de información hacia y desde una base de datos. Symfony2 no viene integrado con ningún ORM, pero integrar Propel es relativamente fácil. -Para instalar Propel, lee Trabajando Con Symfony2 en la documentación de Propel.

            -
            -

            Un sencillo ejemplo: Un producto

            -

            En esta sección, configurarás tu base de datos, crearás un objeto Producto, lo persistirás en la base de datos y lo recuperarás de nuevo.

            -
            -

            El código del ejemplo

            -

            Si quieres seguir el ejemplo de este capítulo, crea el paquete AcmeStoreBundle ejecutando la orden:

            -
            $ php app/console generate:bundle --namespace=Acme/StoreBundle
-
            -
            -
            -
            -

            Configurando la base de datos

            -

            Antes de poder comenzar realmente, tendrás que establecer tu información para la conexión a la base de datos. Por convención, esta información se suele configurar en el archivo -app/config/parameters.yml:

            -
            # app/config/parameters.yml
-parameters:
-    database_driver:   mysql
-    database_host:     localhost
-    database_name:     proyecto_de_prueba
-    database_user:     nombre_de_usuario
-    database_password: password
-    database_charset:  UTF8
-
            -
            -
            -

            Nota

            -

            Definir la configuración a través de parameters.yml sólo es una convención. Los parámetros definidos en este archivo son referidos en el archivo de configuración principal al ajustar Propel:

            -
            -

            Estos parámetros definidos en parameters.yml ahora se pueden incluir en el archivo de configuración (config.yml):

            -
            propel:
-    dbal:
-        driver:     "%database_driver%"
-        user:       "%database_user%"
-        password:   "%database_password%"
-        dsn:        "%database_driver%:host=%database_host%;dbname=%database_name%;charset=%database_charset%"
-
            -
            -

            Ahora que Propel está consciente de tu base de datos, posiblemente tenga que crear la base de datos para ti:

            -
            $ php app/console propel:database:create
-
            -
            -
            -

            Nota

            -

            En este ejemplo, tienes configurada una conexión, denominada default. Si quieres configurar más de una conexión, consulta la sección de configuración del PropelBundle.

            -
            -
            -
            -

            Creando una clase Modelo

            -

            En el mundo de Propel, las clases ActiveRecord son conocidas como modelos debido a que las clases generadas por Propel contienen alguna lógica del negocio.

            -
            -

            Nota

            -

            Para la gente que usa Symfony2 with Doctrine2, los modelos son equivalentes a entidades.

            -
            -

            Supongamos que estás construyendo una aplicación donde necesitas mostrar tus productos. -Primero, crea un archivo schema.xml en el directorio Resources/config de tu paquete AcmeStoreBundle:

            -
            <?xml version="1.0" encoding="UTF-8"?>
-<database name="default"
-    namespace="Acme\StoreBundle\Model"
-    defaultIdMethod="native"
->
-    <table name="product">
-        <column name="id"
-            type="integer"
-            required="true"
-            primaryKey="true"
-            autoIncrement="true"
-        />
-        <column name="name"
-            type="varchar"
-            primaryString="true"
-            size="100"
-        />
-        <column name="price"
-            type="decimal"
-        />
-        <column name="description"
-            type="longvarchar"
-        />
-    </table>
-</database>
-
            -
            -
            -
            -

            Construyendo el modelo

            -

            Después de crear tu archivo schema.xml, genera tu modelo ejecutando:

            -
            $ php app/console propel:model:build
-
            -
            -

            Esto genera todas las clases del modelo en el directorio Model/ del paquete AcmeStoreBundle para que desarrolles rápidamente tu aplicación.

            -
            -
            -

            Creando tablas/esquema de la base de datos

            -

            Ahora tienes una clase Producto utilizable con todo lo que necesitas para persistirla. Por supuesto, en tu base de datos aún no tienes la tabla producto correspondiente. Afortunadamente, Propel puede crear automáticamente todas las tablas de la base de datos necesarias para cada modelo conocido en tu aplicación. Para ello, ejecuta:

            -
            $ php app/console propel:sql:build
-$ php app/console propel:sql:insert --force
-
            -
            -

            Tu base de datos ahora cuenta con una tabla producto completamente operativa, con columnas que coinciden con el esquema que has especificado.

            -
            -

            Truco

            -

            Puedes combinar las tres últimas ordenes ejecutando la siguiente orden: php app/console propel:build --insert-sql.

            -
            -
            -
            -

            Persistiendo objetos a la base de datos

            -

            Ahora que tienes un objeto Producto y la tabla producto correspondiente, estás listo para persistir la información a la base de datos. Desde el interior de un controlador, esto es bastante fácil. Agrega el siguiente método al DefaultController del paquete:

            -
            // src/Acme/StoreBundle/Controller/DefaultController.php
-
-// ...
-use Acme\StoreBundle\Model\Product;
-use Symfony\Component\HttpFoundation\Response;
-
-public function createAction()
-{
-    $product = new Product();
-    $product->setName('A Foo Bar');
-    $product->setPrice(19.99);
-    $product->setDescription('Lorem ipsum dolor');
-
-    $product->save();
-
-    return new Response('Created product id '.$product->getId());
-}
-
            -
            -

            En esta pieza de código, creas y trabajas con una instancia del objeto $product. -Al invocar al método save(), la persistes a la base de datos. No tienes que usar otros servicios, el objeto sabe cómo persistirse a sí mismo.

            -
            -

            Nota

            -

            Si estás siguiendo este ejemplo, necesitas crear una ruta que apunte a este método para verlo en acción.

            -
            -
            -
            -

            Recuperando objetos desde la base de datos

            -

            Recuperar un objeto desde la base de datos es aún más fácil. Por ejemplo, supongamos que has configurado una ruta para mostrar un Producto específico en función del valor de su id:

            -
            // ...
-use Acme\StoreBundle\Model\ProductQuery;
-
-public function showAction($id)
-{
-    $product = ProductQuery::create()
-        ->findPk($id);
-
-    if (!$product) {
-        throw $this->createNotFoundException(
-            'No product found for id '.$id
-        );
-    }
-
-    // ... haz algo, como pasar el objeto $product a una plantilla
-}
-
            -
            -
            -
            -

            Actualizando un objeto

            -

            Una vez que hayas recuperado un objeto de Propel, actualizarlo es relativamente fácil. Supongamos que tienes una ruta que asigna un identificador de producto a una acción de actualización en un controlador:

            -
            // ...
-use Acme\StoreBundle\Model\ProductQuery;
-
-public function updateAction($id)
-{
-    $product = ProductQuery::create()
-        ->findPk($id);
-
-    if (!$product) {
-        throw $this->createNotFoundException(
-            'No product found for id '.$id
-        );
-    }
-
-    $product->setName('New product name!');
-    $product->save();
-
-    return $this->redirect($this->generateUrl('homepage'));
-}
-
            -
            -

            La actualización de un objeto únicamente consta de tres pasos:

            -
              -
            1. recuperar el objeto desde Propel (línea 6 - 13);
              2. -
            2. modificar el objeto (línea 15);
              3. -
            3. guardarlo (línea 16).
              4. -
            -
            -
            -

            Eliminando un objeto

            -

            Eliminar un objeto es muy similar, pero requiere una llamada al método delete() del objeto:

            -
            $product->delete();
-
            -
            -
            -
            -
            -

            Consultando por objetos

            -

            Propel provee clases Query generadas para ejecutar ambas consultas, básicas y complejas sin mayor esfuerzo:

            -
            \Acme\StoreBundle\Model\ProductQuery::create()->findPk($id);
-
-\Acme\StoreBundle\Model\ProductQuery::create()
-    ->filterByName('Foo')
-    ->findOne();
-
            -
            -

            Imagina que deseas consultar los productos, pero sólo quieres devolver aquellos que cuestan más de 19.99, ordenados del más barato al más caro. Desde el interior de un controlador, haz lo siguiente:

            -
            $products = \Acme\StoreBundle\Model\ProductQuery::create()
-    ->filterByPrice(array('min' => 19.99))
-    ->orderByPrice()
-    ->find();
-
            -
            -

            En una línea, recuperas tus productos en una potente manera orientada a objetos. No necesitas gastar tu tiempo con SQL o ninguna otra cosa, Symfony2 ofrece programación completamente orientada a objetos y Propel respeta la misma filosofía proveyendo una impresionante capa de abstracción.

            -

            Si quieres reutilizar algunas consultas, puedes añadir tus propios métodos a la clase ProductQuery:

            -
            // src/Acme/StoreBundle/Model/ProductQuery.php
-class ProductQuery extends BaseProductQuery
-{
-    public function filterByExpensivePrice()
-    {
-        return $this
-            ->filterByPrice(array('min' => 1000));
-    }
-}
-
            -
            -

            Pero, ten en cuenta que Propel genera una serie de métodos por ti y puedes escribir un sencillo findAllOrderedByName() sin ningún esfuerzo:

            -
            \Acme\StoreBundle\Model\ProductQuery::create()
-    ->orderByName()
-    ->find();
-
            -
            -
            -
            -

            Relaciones/Asociaciones

            -

            Supón que los productos en tu aplicación pertenecen exactamente a una «categoría». En este caso, necesitarás un objeto Categoría y una manera de relacionar un objeto Producto a un objeto Categoría.

            -

            Comienza agregando la definición de categoría en tu archivo schema.xml:

            -
            <database name="default" namespace="Acme\StoreBundle\Model" defaultIdMethod="native">
-    <table name="product">
-        <column name="id" type="integer" required="true" primaryKey="true" autoIncrement="true" />
-        <column name="name" type="varchar" primaryString="true" size="100" />
-        <column name="price" type="decimal" />
-        <column name="description" type="longvarchar" />
-
-        <column name="category_id" type="integer" />
-        <foreign-key foreignTable="category">
-            <reference local="category_id" foreign="id" />
-        </foreign-key>
-    </table>
-
-    <table name="category">
-        <column name="id" type="integer" required="true" primaryKey="true" autoIncrement="true" />
-        <column name="name" type="varchar" primaryString="true" size="100" />
-   </table>
-</database>
-
            -
            -

            Crea las clases:

            -
            $ php app/console propel:model:build
-
            -
            -

            Asumiendo que tienes productos en tu base de datos, no los querrás perder. Gracias a las migraciones, Propel es capaz de actualizar tu base de datos sin perder la información existente.

            -
            $ php app/console propel:migration:generate-diff
-$ php app/console propel:migration:migrate
-
            -
            -

            Tu base de datos se ha actualizado, puedes continuar escribiendo tu aplicación.

            -
            -

            Guardando objetos relacionados

            -

            Ahora, veamos el código en acción. Imagina que estás dentro de un controlador:

            -
            // ...
-use Acme\StoreBundle\Model\Category;
-use Acme\StoreBundle\Model\Product;
-use Symfony\Component\HttpFoundation\Response;
-
-class DefaultController extends Controller
-{
-    public function createProductAction()
-    {
-        $category = new Category();
-        $category->setName('Main Products');
-
-        $product = new Product();
-        $product->setName('Foo');
-        $product->setPrice(19.99);
-        // relaciona este producto a la categoría
-        $product->setCategory($category);
-
-        // guarda todo
-        $product->save();
-
-        return new Response(
-            'Created product id: '.$product->getId().' and category id: '.$category->getId()
-        );
-    }
-}
-
            -
            -

            Ahora, se agrega una sola fila en ambas tablas categoría y producto. La columna product.category_id para el nuevo producto se ajusta al id de la nueva categoría. Propel maneja la persistencia de las relaciones por ti.

            -
            -
            -

            Recuperando objetos relacionados

            -

            Cuando necesites recuperar objetos asociados, tu flujo de trabajo se ve justo como lo hacías antes. En primer lugar, buscas un objeto $product y luego accedes a su Categoría asociada:

            -
            // ...
-use Acme\StoreBundle\Model\ProductQuery;
-
-public function showAction($id)
-{
-    $product = ProductQuery::create()
-        ->joinWithCategory()
-        ->findPk($id);
-
-    $categoryName = $product->getCategory()->getName();
-
-    // ...
-}
-
            -
            -

            Ten en cuenta que en el ejemplo anterior, únicamente hicimos una consulta.

            -
            -
            -

            Más información sobre asociaciones

            -

            Encontrarás más información sobre las relaciones leyendo el capítulo dedicado a las -relaciones.

            -
            -
            -
            -

            Ciclo de vida de las retrollamadas

            -

            A veces, es necesario realizar una acción justo antes o después de insertar, actualizar o eliminar un objeto. Este tipo de acciones se conoce como «ciclo de vida» de las retrollamadas o hooks (en adelante «ganchos»), ya que son métodos retrollamados que necesitas ejecutar durante las diferentes etapas del ciclo de vida de un objeto (por ejemplo, cuando insertas, actualizas, eliminas, etc., un objeto)

            -

            Para añadir un gancho, solo tenemos que añadir un método a la clase del objeto:

            -
            // src/Acme/StoreBundle/Model/Product.php
-
-// ...
-class Product extends BaseProduct
-{
-    public function preInsert(\PropelPDO $con = null)
-    {
-        // hace algo antes de insertar el objeto
-    }
-}
-
            -
            -

            Propel ofrece los siguientes ganchos:

            -
              -
            • preInsert() código ejecutado antes de insertar un nuevo objeto
              • -
            • postInsert() código ejecutado después de insertar un nuevo objeto
              • -
            • preUpdate() código ejecutado antes de actualizar un objeto existente
              • -
            • postUpdate() código ejecutado después de actualizar un objeto existente
              • -
            • preSave() código ejecutado antes de guardar un objeto (nuevo o existente)
              • -
            • postSave() código ejecutado después de guardar un objeto (nuevo o existente)
              • -
            • preDelete() código ejecutado antes de borrar un objeto
              • -
            • postDelete() código ejecutado después de borrar un objeto
              • -
            -
            -
            -

            Comportamientos

            -

            Todo los comportamientos empacados en Propel trabajan con Symfony2. Para conseguir más información sobre cómo utiliza Propel los comportamientos, consulta la sección de referencia de comportamientos.

            -
            -
            -

            Ordenes

            -

            Debes leer la sección dedicada a las Ordenes de Propel en Symfony2.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/routing.html b/book/routing.html deleted file mode 100644 index b2e40a8..0000000 --- a/book/routing.html +++ /dev/null @@ -1,1191 +0,0 @@ - - - - - - - Enrutando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Enrutando

            -

            Las URL bonitas absolutamente son una necesidad para cualquier aplicación web seria. Esto significa dejar atrás las URL feas como index.php?article_id=57 en favor de algo así como /leer/intro-a-symfony.

            -

            Tener tal flexibilidad es más importante aún. ¿Qué pasa si necesitas cambiar la URL de una página de /blog a /noticias? ¿Cuántos enlaces necesitas cazar y actualizar para hacer el cambio? Si estás utilizando el enrutador de Symfony, el cambio es sencillo.

            -

            El enrutador de Symfony2 te permite definir URL creativas que se asignan a diferentes áreas de la aplicación. Al final de este capítulo, serás capaz de:

            -
              -
            • Crear rutas complejas asignadas a controladores
              • -
            • Generar URL que contienen plantillas y controladores
              • -
            • Cargar recursos de enrutado desde paquetes (o de cualquier otro lugar)
              • -
            • Depurar tus rutas
              • -
            -
            -

            Enrutador en acción

            -

            Una ruta es un mapa desde la trayectoria de una URL hasta un controlador. Por ejemplo, supongamos que deseas adaptar cualquier URL como /blog/mi-post o /blog/todo-sobre-symfony y enviarla a un controlador que puede buscar y reproducir esta entrada del blog. -La ruta es simple:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-blog_show:
-    path:      /blog/{slug}
-    defaults:  { _controller: AcmeBlogBundle:Blog:show }
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog_show" path="/blog/{slug}">
-        <default key="_controller">AcmeBlogBundle:Blog:show</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog_show', new Route('/blog/{slug}', array(
-    '_controller' => 'AcmeBlogBundle:Blog:show',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            -Nuevo en la versión 2.2: La opción path es nueva en Symfony 2.2, en versiones anteriores se utilizaba pattern.

            -

            La ruta definida por blog_show actúa como /blog/* donde al comodín se le da el nombre de slug. Para la URL /blog/my-blog-post, la variable slug obtiene un valor de my-blog-post, que está disponible para usarlo en el controlador (sigue leyendo).

            -

            El parámetro _controller es una clave especial que le dice a Symfony qué controlador se debe ejecutar cuando una URL coincida con esta ruta. La cadena _controller se conoce como el nombre lógico. Esta sigue un patrón que apunta a una clase y método PHP específicos:

            -
            // src/Acme/BlogBundle/Controller/BlogController.php
-namespace Acme\BlogBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class BlogController extends Controller
-{
-    public function showAction($slug)
-    {
-        // usa la variable $slug para consultar la base de datos
-        $blog = ...;
-
-        return $this->render('AcmeBlogBundle:Blog:show.html.twig', array(
-            'blog' => $blog,
-        ));
-    }
-}
-
            -
            -

            ¡Enhorabuena! Acabas de crear tu primera ruta y la conectaste a un controlador. Ahora, cuando visites /blog/my-post, el controlador showAction será ejecutado y la variable $slug será igual a my-post.

            -

            Este es el objetivo del enrutador de Symfony2: asignar la URL de una petición a un controlador. De paso, aprenderás todo tipo de trucos que incluso facilitan la asignación de URL complejas.

            -
            -
            -

            Enrutando: Bajo el capó

            -

            Cuando se hace una petición a tu aplicación, esta contiene una dirección al «recurso» exacto que solicitó el cliente. Esta dirección se conoce como URL (o URI), y podría ser /contact, /blog/read-me, o cualquier otra cosa. Tomemos la siguiente petición HTTP, por ejemplo:

            -
            GET /blog/my-blog-post
-
            -
            -

            El objetivo del sistema de enrutado de Symfony2 es analizar esta URL y determinar qué controlador se debe ejecutar. Todo el proceso es el siguiente:

            -
              -
            1. La petición es manejada por el controlador frontal de Symfony2 (por ejemplo, app.php);
              2. -
            2. El núcleo de Symfony2 (es decir, el Kernel) pregunta al enrutador que examine la petición;
              3. -
            3. El enrutador busca la URL entrante para emparejarla con una ruta específica y devuelve información sobre la ruta, incluyendo el controlador que se debe ejecutar;
              4. -
            4. El núcleo de Symfony2 ejecuta el controlador, que en última instancia, devuelve un objeto Respuesta.
              5. -
            -
            -Flujo de la petición en Symfony2 -

            La capa del enrutador es una herramienta que traduce la URL entrante a un controlador específico a ejecutar.

            -
            -
            -
            -

            Creando rutas

            -

            Symfony carga todas las rutas de tu aplicación desde un archivo de configuración de enrutado. El archivo usualmente es app/config/routing.yml, pero lo puedes configurar para que sea cualquier otro (incluyendo un archivo XML o PHP) vía el archivo de configuración de la aplicación:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    # ...
-    router:        { resource: "%kernel.root_dir%/config/routing.yml" }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config ...>
-    <!-- ... -->
-    <framework:router resource="%kernel.root_dir%/config/routing.xml" />
-</framework:config>
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    // ...
-    'router' => array('resource' => '%kernel.root_dir%/config/routing.php'),
-));
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            A pesar de que todas las rutas se cargan desde un solo archivo, es práctica común incluir recursos de enrutado adicionales. Para ello, sólo indica en el archivo de configuración de enrutado principal cuáles archivos externos se tendrían que incluir. -Consulta la sección Incluyendo recursos de enrutado externos para más información.

            -
            -
            -

            Configuración básica de rutas

            -

            Definir una ruta es fácil, y una aplicación típica tendrá un montón de rutas. -Una ruta básica consta de dos partes: el path a emparejar y un arreglo defaults:

            -
            -
              -
            • YAML
              _welcome:
-    path:      /
-    defaults:  { _controller: AcmeDemoBundle:Main:homepage }
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="_welcome" path="/">
-        <default key="_controller">AcmeDemoBundle:Main:homepage</default>
-    </route>
-
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('_welcome', new Route('/', array(
-    '_controller' => 'AcmeDemoBundle:Main:homepage',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Esta ruta coincide con la página de inicio (/) y la asigna al controlador de la página principal AcmeDemoBundle:Main:homepage. Symfony2 convierte la cadena _controller en una función PHP real y la ejecuta. Este proceso será explicado en breve en la sección Patrón de nomenclatura para controladores.

            -
            -
            -

            Enrutando con marcadores de posición

            -

            Por supuesto, el sistema de enrutado es compatible con rutas mucho más interesantes. Muchas rutas contienen uno o más «comodines» llamados marcadores de posición:

            -
            -
              -
            • YAML
              blog_show:
-    path:      /blog/{slug}
-    defaults:  { _controller: AcmeBlogBundle:Blog:show }
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog_show" path="/blog/{slug}">
-        <default key="_controller">AcmeBlogBundle:Blog:show</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog_show', new Route('/blog/{slug}', array(
-    '_controller' => 'AcmeBlogBundle:Blog:show',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            La ruta emparejará con cualquier cosa que se parezca a /blog/*. Aún mejor, el valor coincide con el marcador de posición {slug} que estará disponible dentro de tu controlador. En otras palabras, si la URL es /blog/hello-world, una variable $slug, con un valor de hello-world, estará disponible en el controlador. -Esta se puede usar, por ejemplo, para cargar la entrada en el blog coincidente con esa cadena.

            -

            La ruta no debe, sin embargo, emparejar con un /blog sencillo. Eso es porque, por omisión, todos los marcadores de posición son obligatorios. Esto se puede cambiar agregando un valor marcador de posición al arreglo defaults.

            -
            -
            -

            Marcadores de posición obligatorios y opcionales

            -

            Para hacer las cosas más emocionantes, añade una nueva ruta que muestre una lista de todas las entradas del ‘blog’ para la petición imaginaria ‘blog’:

            -
            -
              -
            • YAML
              blog:
-    path:      /blog
-    defaults:  { _controller: AcmeBlogBundle:Blog:index }
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog" path="/blog">
-        <default key="_controller">AcmeBlogBundle:Blog:index</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog', new Route('/blog', array(
-    '_controller' => 'AcmeBlogBundle:Blog:index',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Hasta el momento, esta ruta es tan simple como es posible — no contiene marcadores de posición y sólo coincidirá con la URL exacta /blog. ¿Pero si necesitamos que esta ruta sea compatible con paginación, donde /blog/2 muestra la segunda página de las entradas del blog? Actualiza la ruta para que tenga un nuevo marcador de posición {page}:

            -
            -
              -
            • YAML
              blog:
-    path:      /blog/{page}
-    defaults:  { _controller: AcmeBlogBundle:Blog:index }
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog" path="/blog/{page}">
-        <default key="_controller">AcmeBlogBundle:Blog:index</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog', new Route('/blog/{page}', array(
-    '_controller' => 'AcmeBlogBundle:Blog:index',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Al igual que el marcador de posición {slug} anterior, el valor coincidente con {page} estará disponible dentro de tu controlador. Puedes utilizar su valor para determinar cual conjunto de entradas del blog muestra determinada página.

            -

            ¡Pero espera! Puesto que los marcadores de posición de forma predeterminada son obligatorios, esta ruta ya no coincidirá con /blog simplemente. En su lugar, para ver la página 1 del blog, ¡habrá la necesidad de utilizar la URL /blog/1! Debido a que esa no es la manera en que se comporta una aplicación web rica, debes modificar la ruta para que el parámetro {page} sea opcional. -Esto se consigue incluyéndolo en la colección defaults:

            -
            -
              -
            • YAML
              blog:
-    path:      /blog/{page}
-    defaults:  { _controller: AcmeBlogBundle:Blog:index, page: 1 }
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog" path="/blog/{page}">
-        <default key="_controller">AcmeBlogBundle:Blog:index</default>
-        <default key="page">1</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog', new Route('/blog/{page}', array(
-    '_controller' => 'AcmeBlogBundle:Blog:index',
-    'page'        => 1,
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Agregando page a la clave defaults, el marcador de posición {page} ya no es necesario. La URL /blog coincidirá con esta ruta y el valor del parámetro page se fijará en 1. La URL /blog/2 también coincide, dando al parámetro page un valor de 2. Perfecto.

            - ---- - - - - - - - - - - - -
            /blog{page} = 1
            /blog/1{page} = 1
            /blog/2{page} = 2
            -
            -

            Truco

            -

            Las rutas con parámetros opcionales al final no coincidirán con peticiones con una barra inclinada final (es decir, /blog/ no coincidirá, en cambio /blog concordará).

            -
            -
            -
            -

            Agregando requisitos

            -

            Echa un vistazo a las rutas que hemos creado hasta ahora:

            -
            -
              -
            • YAML
              blog:
-    path:      /blog/{page}
-    defaults:  { _controller: AcmeBlogBundle:Blog:index, page: 1 }
-
-blog_show:
-    path:      /blog/{slug}
-    defaults:  { _controller: AcmeBlogBundle:Blog:show }
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog" path="/blog/{page}">
-        <default key="_controller">AcmeBlogBundle:Blog:index</default>
-        <default key="page">1</default>
-    </route>
-
-    <route id="blog_show" path="/blog/{slug}">
-        <default key="_controller">AcmeBlogBundle:Blog:show</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog', new Route('/blog/{page}', array(
-    '_controller' => 'AcmeBlogBundle:Blog:index',
-    'page'        => 1,
-)));
-
-$collection->add('blog_show', new Route('/blog/{show}', array(
-    '_controller' => 'AcmeBlogBundle:Blog:show',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            ¿Puedes ver el problema? Ten en cuenta que ambas rutas tienen patrones que coinciden con las URL que se parezcan a /blog/*. El enrutador de Symfony siempre elegirá la primera ruta coincidente que encuentre. En otras palabras, la ruta blog_show nunca corresponderá. En cambio, una URL como /blog/my-blog-post coincidirá con la primera ruta (blog) y devolverá un valor sin sentido de my-blog-post para el parámetro {page}.

            - ----- - - - - - - - - - - - - - - - - -
            URLrutaparámetros
            /blog/2blog{page} = 2
            /blog/mi-entrada-del-blogblog{page} = mi-entrada-del-blog
            -

            La respuesta al problema es añadir requisitos a la ruta. Las rutas en este ejemplo funcionarán perfectamente si el patrón /blog/{page} sólo concuerda con una URL dónde la parte {page} sea un número entero. Afortunadamente, se puede agregar fácilmente una expresión regular de requisitos para cada parámetro. Por ejemplo:

            -
            -
              -
            • YAML
              blog:
-    path:      /blog/{page}
-    defaults:  { _controller: AcmeBlogBundle:Blog:index, page: 1 }
-    requirements:
-        page:  \d+
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog" path="/blog/{page}">
-        <default key="_controller">AcmeBlogBundle:Blog:index</default>
-        <default key="page">1</default>
-        <requirement key="page">\d+</requirement>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog', new Route('/blog/{page}', array(
-    '_controller' => 'AcmeBlogBundle:Blog:index',
-    'page'        => 1,
-), array(
-    'page' => '\d+',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            El requisito \d+ es una expresión regular diciendo que el valor del parámetro {page} debe ser un dígito (es decir, un número). La ruta blog todavía coincide con una URL como /blog/2 (porque 2 es un número), pero ya no concuerda con una URL como /blog/my-blog-pos (porque my-blog-post no es un número).

            -

            Como resultado, una URL como /blog/my-blog-post ahora coincide correctamente con la ruta blog_show.

            - ----- - - - - - - - - - - - - - - - - -
            URLrutaparámetros
            /blog/2blog{page} = 2
            /blog/mi-entrada-del-blogblog_show{ficha} = mi-entrada-del-blog
            -
            -

            Las primeras rutas siempre ganan

            -

            ¿Qué significa todo eso de que el orden de las rutas es muy importante? -Si la ruta blog_show se coloca por encima de la ruta blog, la URL /blog/2 coincidiría con blog_show en lugar de blog ya que el parámetro {slug} de blog_show no tiene ningún requisito. Usando el orden adecuado y requisitos claros, puedes lograr casi cualquier cosa.

            -
            -

            Puesto que el parámetro requirements consiste de expresiones regulares, la complejidad y flexibilidad de cada requisito es totalmente tuya. Supongamos que la página principal de tu aplicación está disponible en dos diferentes idiomas, basándose en la URL:

            -
            -
              -
            • YAML
              homepage:
-    path:      /{_locale}
-    defaults:  { _controller: AcmeDemoBundle:Main:homepage, _locale: en }
-    requirements:
-        _locale:  en|fr
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="homepage" path="/{culture}">
-        <default key="_controller">AcmeDemoBundle:Main:homepage</default>
-        <default key="_locale">en</default>
-        <requirement key="_locale">en|fr</requirement>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('homepage', new Route('/{culture}', array(
-    '_controller' => 'AcmeDemoBundle:Main:homepage',
-    'culture'     => 'en',
-), array(
-    'culture' => 'en|fr',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Para las peticiones entrantes, la porción {_locale} de la dirección se compara con la expresión regular (en|es).

            - ---- - - - - - - - - - - - - - - -
            /{_locale} = es
            /en{_locale} = en
            /es{_locale} = es
            /frno coincidirá con esta ruta
            -
            -
            -

            Agregando requisitos de método HTTP

            -

            Además de la URL, también puedes coincidir con el método de la petición entrante (es decir, GET, HEAD, POST, PUT, DELETE). Supongamos que tienes un formulario de contacto con dos controladores —uno para mostrar el formulario (en una petición GET) y uno para procesar el formulario una vez presentado (en una petición POST). Esto se puede lograr con la siguiente configuración de ruta:

            -
            -
              -
            • YAML
              contact:
-    path:     /contact
-    defaults: { _controller: AcmeDemoBundle:Main:contact }
-    methods:  [GET]
-
-contact_process:
-    path:     /contact
-    defaults: { _controller: AcmeDemoBundle:Main:contactProcess }
-    methods:  [POST]
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="contact" path="/contact" methods="GET">
-        <default key="_controller">AcmeDemoBundle:Main:contact</default>
-    </route>
-
-    <route id="contact_process" path="/contact" methods="POST">
-        <default key="_controller">AcmeDemoBundle:Main:contactProcess</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('contact', new Route('/contact', array(
-    '_controller' => 'AcmeDemoBundle:Main:contact',
-), array(), array(), '', array(), array('GET')));
-
-$collection->add('contact_process', new Route('/contact', array(
-    '_controller' => 'AcmeDemoBundle:Main:contactProcess',
-), array(), array(), '', array(), array('POST')));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            -Nuevo en la versión 2.2: La opción methods se añadió en Symfony 2.2. Usa el requisito _method en versiones anteriores.

            -

            A pesar del hecho de que estas dos rutas tienen patrones idénticos (/contact), la primera ruta sólo coincidirá con las peticiones GET y la segunda sólo coincidirá con las peticiones POST. Esto significa que puedes mostrar y enviar el formulario a través de la misma URL, mientras usas controladores distintos para las dos acciones.

            -
            -

            Nota

            -

            Si no especifícas ningún método, la ruta emparejará con todos los métodos.

            -
            -
            -
            -

            Añadiendo un servidor

            -

            -Nuevo en la versión 2.2: El soporte necesario para emparejar con el servidor se añadió en Symfony 2.2

            -

            También puedes emparejar con el host HTTP de la petición entrante. Para más información, consulta el Cómo emparejar una ruta basándose en el servidor en la documentación del componente Routing.

            -
            -
            -

            Ejemplo de enrutado avanzado

            -

            En este punto, tienes todo lo necesario para crear una poderosa estructura de enrutado Symfony. El siguiente es un ejemplo de cuán flexible puede ser el sistema de enrutado:

            -
            -
              -
            • YAML
              article_show:
-  path:     /articles/{_locale}/{year}/{title}.{_format}
-  defaults: { _controller: AcmeDemoBundle:Article:show, _format: html }
-  requirements:
-      _locale:  en|fr
-      _format:  html|rss
-      year:     \d+
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="article_show" path="/articles/{culture}/{year}/{title}.{_format}">
-        <default key="_controller">AcmeDemoBundle:Article:show</default>
-        <default key="_format">html</default>
-        <requirement key="_locale">en|fr</requirement>
-        <requirement key="_format">html|rss</requirement>
-        <requirement key="year">\d+</requirement>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('homepage', new Route('/articles/{culture}/{year}/{title}.{_format}', array(
-    '_controller' => 'AcmeDemoBundle:Article:show',
-    '_format'     => 'html',
-), array(
-    'culture' => 'en|fr',
-    '_format' => 'html|rss',
-    'year'    => '\d+',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Como hemos visto, esta ruta sólo coincide si la porción {_locale} de la URL es o bien «en» o «fr» y si {year} es un número. Esta ruta también muestra cómo puedes utilizar un punto entre los marcadores de posición en lugar de una barra inclinada. Las URL que coinciden con esta ruta se podrían ver como las siguientes:

            -
              -
            • /articles/en/2010/my-post
              • -
            • /articles/fr/2010/my-post.rss
              • -
            • /articles/en/2013/my-latest-post.html
              • -
            - -
            -

            Nota

            -

            A veces quieres hacer configurables globalmente ciertas partes de tus rutas. -Symfony 2.1 te proporciona una manera de hacer esto aprovechando los parámetros del contenedor de servicios. Lee más sobre esto en «Cómo utilizar parámetros del contenedor de servicios en tus rutas».

            -
            -
            -
            -

            Parámetros de enrutado especiales

            -

            Como has visto, cada parámetro de enrutado o valor predeterminado finalmente está disponible como un argumento en el método controlador. Adicionalmente, hay tres parámetros que son especiales: cada uno añade una única pieza de funcionalidad a tu aplicación:

            -
              -
            • _controller: Como hemos visto, este parámetro se utiliza para determinar qué controlador se ejecuta cuando la ruta concuerda;
              • -
            • _format: Se utiliza para establecer el formato de la petición (Leer más);
              • -
            • _locale: Se utiliza para establecer la configuración regional en la petición (Leer más);
              • -
            -
            -

            Truco

            -

            Si utilizas el parámetro _locale en una ruta, ese valor también se almacenará en la sesión para las subsecuentes peticiones lo cual evita guardar la misma región.

            -
            -
            -
            -
            -

            Patrón de nomenclatura para controladores

            -

            Cada ruta debe tener un parámetro _controller, el cual determina qué controlador se debe ejecutar cuando dicha ruta concuerde. Este parámetro utiliza un patrón de cadena simple llamado el nombre lógico del controlador, que Symfony asigna a un método y clase PHP específico. El patrón consta de tres partes, cada una separada por dos puntos:

            -
            -
            paquete:controlador:acción
            -

            Por ejemplo, un valor _controller de AcmeBlogBundle:Blog:show significa:

            - ----- - - - - - - - - - - - - -
            PaqueteClase de controladorNombre método
            AcmeBlogBundleBlogControllershowAction
            -

            El controlador podría tener este aspecto:

            -
            // src/Acme/BlogBundle/Controller/BlogController.php
-namespace Acme\BlogBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class BlogController extends Controller
-{
-    public function showAction($slug)
-    {
-        // ...
-    }
-}
-
            -
            -

            Ten en cuenta que Symfony añade la cadena Controller al nombre de la clase (Blog -=> BlogController) y Action al nombre del método (show => showAction).

            -

            También podrías referirte a este controlador utilizando su nombre de clase y método completamente cualificado: Acme\BlogBundle\Controller\BlogController::showAction. -Pero si sigues algunas simples convenciones, el nombre lógico es más conciso y permite mayor flexibilidad.

            -
            -

            Nota

            -

            Además de utilizar el nombre lógico o el nombre de clase completamente cualificado, Symfony es compatible con una tercera forma de referirse a un controlador. Este método utiliza un solo separador de dos puntos (por ejemplo, service_name:indexAction) y hace referencia al controlador como un servicio (consulta Cómo definir controladores como servicios).

            -
            -
            -
            -

            Parámetros de ruta y argumentos del controlador

            -

            Los parámetros de ruta (por ejemplo, {slug}) son especialmente importantes porque cada uno se pone a disposición como argumento para el método controlador:

            -
            public function showAction($slug)
-{
-  // ...
-}
-
            -
            -

            En realidad, toda la colección defaults se combina con los valores del parámetro para formar un solo arreglo. Cada clave de ese arreglo está disponible como un argumento en el controlador.

            -

            En otras palabras, por cada argumento de tu método controlador, Symfony busca un parámetro de ruta con ese nombre y asigna su valor a ese argumento. -En el ejemplo avanzado anterior, podrías utilizar cualquier combinación (en cualquier orden) de las siguientes variables como argumentos para el método showAction():

            -
              -
            • $_locale
              • -
            • $year
              • -
            • $title
              • -
            • $_format
              • -
            • $_controller
              • -
            -

            Dado que los marcadores de posición y los valores de la colección defaults se combinan, incluso la variable $_controller está disponible. Para una explicación más detallada, consulta Parámetros de ruta como argumentos para el controlador.

            -
            -

            Truco

            -

            También puedes utilizar una variable especial $_route, que se fija al nombre de la ruta que concordó.

            -
            -
            -
            -

            Incluyendo recursos de enrutado externos

            -

            Todas las rutas se cargan a través de un único archivo de configuración —usualmente app/config/routing.yml (consulta Creando rutas más arriba). Por lo general, sin embargo, deseas cargar rutas para otros lugares, como un archivo de enrutado que vive dentro de un paquete. Esto se puede hacer «importando» ese archivo:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-acme_hello:
-    resource: "@AcmeHelloBundle/Resources/config/routing.yml"
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <import resource="@AcmeHelloBundle/Resources/config/routing.xml" />
-</routes>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-
-$collection = new RouteCollection();
-$collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"));
-
-return $collection;
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Cuando importas recursos desde YAML, la clave (por ejemplo, acme_hello) no tiene sentido. -Sólo asegúrate de que es única para que no haya otras líneas que reemplazar.

            -
            -

            La clave resource carga el recurso de la ruta dada. En este ejemplo, el recurso es la ruta completa a un archivo, donde la sintaxis contextual del atajo @AcmeHelloBundle se resuelve en la ruta a ese paquete. El archivo importado podría tener este aspecto:

            -
            -
              -
            • YAML
               # src/Acme/HelloBundle/Resources/config/routing.yml
-acme_hello:
-     path:     /hello/{name}
-     defaults: { _controller: AcmeHelloBundle:Hello:index }
-
              -
              -
              • -
            • XML
              <!-- src/Acme/HelloBundle/Resources/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="acme_hello" path="/hello/{name}">
-        <default key="_controller">AcmeHelloBundle:Hello:index</default>
-    </route>
-</routes>
-
              -
              -
              • -
            • PHP
              // src/Acme/HelloBundle/Resources/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('acme_hello', new Route('/hello/{name}', array(
-    '_controller' => 'AcmeHelloBundle:Hello:index',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Las rutas de este archivo se analizan y cargan en la misma forma que el archivo de enrutado principal.

            -
            -

            Prefijando rutas importadas

            -

            También puedes optar por proporcionar un «prefijo» para las rutas importadas. Por ejemplo, supongamos que deseas que la ruta acme_hello tenga una ruta final de /admin/hello/{name} en lugar de simplemente /hello/{name}:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-acme_hello:
-    resource: "@AcmeHelloBundle/Resources/config/routing.yml"
-    prefix:   /admin
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <import resource="@AcmeHelloBundle/Resources/config/routing.xml" prefix="/admin" />
-</routes>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-
-$collection = new RouteCollection();
-$collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"), '/admin');
-
-return $collection;
-
              -
              -
              • -
            -
            -

            La cadena /admin ahora será prefijada a la trayectoria de cada ruta cargada del nuevo recurso de enrutado.

            -
            -

            Truco

            -

            Además puedes definir rutas usando anotaciones. Consulta la documentación del FrameworkExtraBundle para ver cómo hacerlo.

            -
            -
            -
            -
            -

            Añadiendo un servidor a la expresión regular de las rutas importadas

            -

            -Nuevo en la versión 2.2: El soporte necesario para emparejar con el servidor se añadió en Symfony 2.2

            -

            Puedes poner el servidor en la expresión regular de las rutas importadas. Para más información, ve Añadiendo un servidor a la expresión regular de las rutas importadas.

            -
            -
            -

            Visualizando y depurando rutas

            -

            Si bien agregar y personalizar rutas, es útil para poder visualizar y obtener información detallada sobre tus rutas. Una buena manera de ver todas las rutas en tu aplicación es a través de la orden de consola router:debug. Ejecuta la siguiente orden desde la raíz de tu proyecto.

            -
            $ php app/console router:debug
-
            -
            -

            Esta orden imprimirá una útil lista de todas las rutas configuradas en tu aplicación:

            -
            homepage              ANY       /
-contact               GET       /contact
-contact_process       POST      /contact
-article_show          ANY       /articles/{_locale}/{year}/{title}.{_format}
-blog                  ANY       /blog/{page}
-blog_show             ANY       /blog/{slug}
-
            -
            -

            También puedes obtener información muy específica de una sola ruta incluyendo el nombre de la ruta después de la orden:

            -
            $ php app/console router:debug article_show
-
            -
            -

            Asímismo, si deseas probar acuál ruta coincide con una trayectoria dada, puedes usar la orden de consola router:match:

            -
            $ php app/console router:match /blog/my-latest-post
-
            -
            -

            Esta orden imprimirá la ruta de la URL coincidente.

            -
            Route "blog_show" matches
-
            -
            -
            -
            -

            Generando URL

            -

            El sistema de enrutado también se debe utilizar para generar URL. En realidad, el enrutado es un sistema bidireccional: asignando la URL a un controlador+parámetros y la ruta+parámetros a una URL. Los métodos match() y generate() de este sistema bidireccional. Tomando la ruta blog_show del ejemplo anterior:

            -
            $params = $this->get('router')->match('/blog/my-blog-post');
-// array(
-//     'slug'        => 'my-blog-post',
-//     '_controller' => 'AcmeBlogBundle:Blog:show',
-// )
-
-$uri = $this->get('router')->generate('blog_show', array('slug' => 'my-blog-post'));
-// /blog/my-blog-post
-
            -
            -

            Para generar una URL, debes especificar el nombre de la ruta (por ejemplo, blog_show) y cualquier comodín (por ejemplo, slug = my-blog-post) usado en el patrón de esa ruta. Con esta información, fácilmente puedes generar cualquier URL:

            -
            class MainController extends Controller
-{
-    public function showAction($slug)
-    {
-        // ...
-
-        $url = $this->generateUrl(
-            'blog_show',
-            array('slug' => 'my-blog-post')
-        );
-    }
-}
-
            -
            -
            -

            Nota

            -

            En los controladores que extienden la clase base Symfony\Bundle\FrameworkBundle\Controller\Controller de Symfony, puedes utilizar el método generateUrl(), el cual llama al método generate() del servicio enrutador.

            -
            -

            En una sección posterior, aprenderás cómo generar URL desde el interior de tus plantillas.

            -
            -

            Truco

            -

            Si la interfaz de tu aplicación utiliza peticiones AJAX, posiblemente desees poder generar las direcciones URL en JavaScript basándote en tu configuración de enrutado. -Usando el FOSJsRoutingBundle, puedes hacer eso exactamente:

            -
            var url = Routing.generate(
-    'blog_show',
-    {"slug": 'my-blog-post'}
-);
-
            -
            -

            Para más información, consulta la documentación del paquete.

            -
            -
            -

            Generando URL absolutas

            -

            De forma predeterminada, el enrutador va a generar URL relativas (por ejemplo /blog). Para generar una URL absoluta, sólo tienes que pasar true como tercer argumento del método generate():

            -
            $router->generate('blog_show', array('slug' => 'my-blog-post'), true);
-// http://www.example.com/blog/my-blog-post
-
            -
            -
            -

            Nota

            -

            El servidor utilizado al generar una URL absoluta es el anfitrión del objeto Petición actual. Este se detercta automática basándose en la información del servidor suministrada por PHP. Al generar direcciones URL absolutas para archivos ejecutables desde la línea de ordenes, debes configurar manualmente el servidor que desees en el objeto RequestContext:

            -
            $router->getContext()->setHost('www.example.com');
-
            -
            -
            -
            -
            -

            Generando URL con cadena de consulta

            -

            El método generate toma un arreglo de valores comodín para generar la URI. -Pero si pasas adicionales, se añadirán a la URI como cadena de consulta:

            -
            $router->generate('blog', array('page' => 2, 'category' => 'Symfony'));
-// /blog/2?category=Symfony
-
            -
            -
            -
            -

            Generando URL desde una plantilla

            -

            El lugar más común para generar una URL es dentro de una plantilla cuando creas enlaces entre las páginas de tu aplicación. Esto se hace igual que antes, pero utilizando una función ayudante de plantilla:

            -
            -
              -
            • Twig
              <a href="{{ path('blog_show', {'slug': 'my-blog-post'}) }}">
-  Read this blog post.
-    </a>
-
              -
              -
              • -
            • PHP
              <a href="<?php echo $view['router']->generate('blog_show', array('slug' => 'my-blog-post')) ?>">
-    Read this blog post.
-    </a>
-
              -
              -
              • -
            -
            -

            También puedes generar URL absolutas.

            -
            -
              -
            • Twig
              <a href="{{ url('blog_show', {'slug': 'my-blog-post'}) }}">
-  Read this blog post.
-    </a>
-
              -
              -
              • -
            • PHP
              <a href="<?php echo $view['router']->generate('blog_show', array('slug' => 'my-blog-post'), true) ?>">
-    Read this blog post.
-    </a>
-
              -
              -
              • -
            -
            -
            -
            -
            -

            Resumen

            -

            El enrutado es un sistema para asignar la dirección de las peticiones entrantes a la función controladora que se debe llamar para procesar la petición. Este permite especificar ambas URL bonitas y mantiene la funcionalidad de tu aplicación disociada de las URL. El enrutado es un mecanismo de dos vías, lo cual significa que también lo debes usar para generar tus direcciones URL.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/security.html b/book/security.html deleted file mode 100644 index 6bad5b2..0000000 --- a/book/security.html +++ /dev/null @@ -1,1794 +0,0 @@ - - - - - - - Seguridad — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Seguridad

            -

            La seguridad es un proceso de dos etapas, cuyo objetivo es evitar que un usuario acceda a un recurso al cual no debería tener acceso.

            -

            En el primer paso del proceso, el sistema de seguridad identifica quién es el usuario obligándolo a presentar algún tipo de identificación. Esto se llama autenticación, y significa que el sistema está tratando de determinar quién eres.

            -

            Una vez que el sistema sabe quien eres, el siguiente paso es determinar si deberías tener acceso a un determinado recurso. Esta parte del proceso se llama autorización, y significa que el sistema está comprobando si tienes suficientes privilegios para realizar una determinada acción.

            -../_images/security_authentication_authorization_es.png -

            Puesto que la mejor manera de aprender es viendo un ejemplo, empieza asegurando tu aplicación con autenticación HTTP básica.

            -
            -

            Nota

            -

            El componente Security de Symfony está disponible como una biblioteca PHP independiente para usarla en cualquier proyecto PHP.

            -
            -
            -

            Ejemplo básico: Autenticación HTTP

            -

            Puedes ajustar el componente de seguridad a través de la configuración de tu aplicación. -De hecho, la mayoría de las opciones de seguridad estándar son sólo cuestión de usar los ajustes correctos. La siguiente configuración le dice a Symfony que proteja cualquier URL coincidente con /admin/* y pida al usuario sus credenciales mediante autenticación HTTP básica (es decir, el cuadro de dialogo a la vieja escuela: nombre de usuario/contraseña):

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    firewalls:
-        secured_area:
-            pattern:    ^/
-            anonymous: ~
-            http_basic:
-                realm: "Secured Demo Area"
-
-    access_control:
-        - { path: ^/admin, roles: ROLE_ADMIN }
-
-    providers:
-        in_memory:
-            memory:
-                users:
-                    ryan:  { password: ryanpass, roles: 'ROLE_USER' }
-                    admin: { password: kitten, roles: 'ROLE_ADMIN' }
-
-    encoders:
-        Symfony\Component\Security\Core\User\User: plaintext
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8"?>
-
-<srv:container xmlns="http://symfony.com/schema/dic/security"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:srv="http://symfony.com/schema/dic/services"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
-
-    <!-- app/config/security.xml -->
-
-    <config>
-        <firewall name="secured_area" pattern="^/">
-            <anonymous />
-            <http-basic realm="Secured Demo Area" />
-        </firewall>
-
-        <access-control>
-            <rule path="^/admin" role="ROLE_ADMIN" />
-        </access-control>
-
-        <provider name="in_memory">
-            <memory>
-                <user name="ryan" password="ryanpass" roles="ROLE_USER" />
-                <user name="admin" password="kitten" roles="ROLE_ADMIN" />
-            </memory>
-        </provider>
-
-        <encoder class="Symfony\Component\Security\Core\User\User" algorithm="plaintext" />
-    </config>
-</srv:container>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'secured_area' => array(
-            'pattern'    => '^/',
-            'anonymous'  => array(),
-            'http_basic' => array(
-                'realm'  => 'Secured Demo Area',
-            ),
-        ),
-    ),
-    'access_control' => array(
-        array('path' => '^/admin', 'role' => 'ROLE_ADMIN'),
-    ),
-    'providers' => array(
-        'in_memory' => array(
-            'memory' => array(
-                'users' => array(
-                    'ryan' => array('password' => 'ryanpass', 'roles' => 'ROLE_USER'),
-                    'admin' => array('password' => 'kitten', 'roles' => 'ROLE_ADMIN'),
-                ),
-            ),
-        ),
-    ),
-    'encoders' => array(
-        'Symfony\Component\Security\Core\User\User' => 'plaintext',
-    ),
-));
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Una distribución estándar de Symfony separa la configuración de seguridad en un archivo independiente (por ejemplo, app/config/security.yml). Si no tienes un archivo de seguridad autónomo, puedes poner la configuración directamente en el archivo de configuración principal (por ejemplo, app/config/config.yml).

            -
            -

            El resultado final de esta configuración es un sistema de seguridad totalmente operativo que tiene el siguiente aspecto:

            -
              -
            • Hay dos usuarios en el sistema (ryan y admin);
              • -
            • Los usuarios se autentican a través de la autenticación HTTP básica del sistema;
              • -
            • Cualquier URL que coincida con /admin/* está protegida, y sólo el usuario admin puede acceder a ellas;
              • -
            • Todas las URL que no coincidan con /admin/* son accesibles para todos los usuarios (y nunca se pide al usuario que se registre).
              • -
            -

            Veamos brevemente cómo funciona la seguridad y cómo entra en juego cada parte de la configuración.

            -
            -
            -

            Cómo funciona la seguridad: autenticación y autorización

            -

            El sistema de seguridad de Symfony trabaja identificando a un usuario (es decir, la autenticación) y comprobando si ese usuario debe tener acceso a una URL o recurso específico.

            -
            -

            Cortafuegos (autenticación)

            -

            Cuando un usuario hace una petición a una URL que está protegida por un cortafuegos, se activa el sistema de seguridad. El trabajo del cortafuegos es determinar si el usuario necesita estar autenticado, y si lo hace, enviar una respuesta al usuario para iniciar el proceso de autenticación.

            -

            Un cortafuegos se activa cuando la URL de una petición entrante concuerda con el patrón de la expresión regular configurada en el valor config del cortafuegos. En este ejemplo el patrón (^/) concordará con cada petición entrante. El hecho de que el cortafuegos esté activado no significa, sin embargo, que el nombre de usuario de autenticación HTTP y el cuadro de diálogo de la contraseña se muestre en cada URL. Por ejemplo, cualquier usuario puede acceder a /foo sin que se le pida se autentique.

            -../_images/security_anonymous_user_access_es.png -

            Esto funciona en primer lugar porque el cortafuegos permite usuarios anónimos a través del parámetro de configuración anonymous. En otras palabras, el cortafuegos no requiere que el usuario se autentique plenamente de inmediato. Y puesto que no hay rol especial necesario para acceder a /foo (bajo la sección access_control), la petición se puede llevar a cabo sin solicitar al usuario se autentique.

            -

            Si eliminas la clave anonymous, el cortafuegos siempre hará que un usuario se autentique inmediatamente.

            -
            -
            -

            Control de acceso (autorización)

            -

            Si un usuario solicita /admin/foo, sin embargo, el proceso se comporta de manera diferente. -Esto se debe a la sección de configuración access_control la cual dice que cualquier URL coincidente con el patrón de la expresión regular ^/admin (es decir, /admin o cualquier cosa coincidente con /admin/*) requiere el rol ROLE_ADMIN. Los roles son la base para la mayor parte de la autorización: el usuario puede acceder a /admin/foo sólo si cuenta con el rol ROLE_ADMIN.

            -../_images/security_anonymous_user_denied_authorization_es.png -

            Como antes, cuando el usuario hace la petición originalmente, el cortafuegos no solicita ningún tipo de identificación. Sin embargo, tan pronto como la capa de control de acceso niega el acceso a los usuarios (ya que el usuario anónimo no tiene el rol ROLE_ADMIN), el servidor de seguridad entra en acción e inicia el proceso de autenticación). -El proceso de autenticación depende del mecanismo de autenticación que utilices. Por ejemplo, si estás utilizando el método de autenticación con formulario de acceso, el usuario será redirigido a la página de inicio de sesión. Si estás utilizando autenticación HTTP, se enviará al usuario una respuesta HTTP 401 para que el usuario vea el cuadro de diálogo de nombre de usuario y contraseña.

            -

            Ahora el usuario de nuevo tiene la posibilidad de presentar sus credenciales a la aplicación. -Si las credenciales son válidas, se puede intentar de nuevo la petición original.

            -../_images/security_ryan_no_role_admin_access_es.png -

            En este ejemplo, el usuario ryan se autentica correctamente con el cortafuegos. -Pero como ryan no cuenta con el rol ROLE_ADMIN, se le sigue negando el acceso a /admin/foo. En última instancia, esto significa que el usuario debe ver algún tipo de mensaje indicándole que se le ha denegado el acceso.

            -
            -

            Truco

            -

            Cuando Symfony niega el acceso al usuario, él verá una pantalla de error y recibe un código de estado HTTP 403 (Prohibido). Puedes personalizar la pantalla de error, acceso denegado, siguiendo las instrucciones de las Páginas de error en el artículo para personalizar la página de error 403 del recetario.

            -
            -

            Por último, si el usuario admin solicita /admin/foo, se lleva a cabo un proceso similar, excepto que ahora, después de haberse autenticado, la capa de control de acceso le permitirá pasar a través de la petición:

            -../_images/security_admin_role_access_es.png -

            El flujo de la petición cuando un usuario solicita un recurso protegido es sencillo, pero increíblemente flexible. Como verás más adelante, la autenticación se puede realizar de varias maneras, incluyendo a través de un formulario de acceso, certificados X.509 o la autenticación del usuario a través de Twitter. Independientemente del método de autenticación, el flujo de la petición siempre es el mismo:

            -
              -
            1. Un usuario accede a un recurso protegido;
              2. -
            2. La aplicación redirige al usuario al formulario de acceso;
              3. -
            3. El usuario presenta sus credenciales (por ejemplo nombre de usuario/contraseña);
              4. -
            4. El cortafuegos autentica al usuario;
              5. -
            5. El nuevo usuario autenticado intenta de nuevo la petición original.
              6. -
            -
            -

            Nota

            -

            El proceso exacto realmente depende un poco en el mecanismo de autenticación utilizado. Por ejemplo, cuando utilizas el formulario de acceso, el usuario presenta sus credenciales a una URL que procesa el formulario (por ejemplo /login_check) y luego es redirigido a la dirección solicitada originalmente (por ejemplo /admin/foo). -Pero con la autenticación HTTP, el usuario envía sus credenciales directamente a la URL original (por ejemplo /admin/foo) y luego la página se devuelve al usuario en la misma petición (es decir, sin redirección).

            -

            Este tipo de idiosincrasia no debería causar ningún problema, pero es bueno tenerla en cuenta.

            -
            -
            -

            Truco

            -

            También aprenderás más adelante cómo puedes proteger cualquier cosa en Symfony2, incluidos controladores específicos, objetos, e incluso métodos PHP.

            -
            -
            -
            -
            -

            Usando un formulario de acceso tradicional

            -
            -

            Truco

            -

            En esta sección, aprenderás cómo crear un formulario de acceso básico que continúa usando los usuarios definidos en el código del archivo security.yml.

            -

            Para cargar usuarios desde la base de datos, por favor consulta Cómo cargar usuarios desde la base de datos con seguridad (el Proveedor de entidad). -Al leer este artículo y esta sección, puedes crear un sistema de formularios de acceso completo que carga usuarios desde la base de datos.

            -
            -

            Hasta ahora, hemos visto cómo cubrir tu aplicación bajo un cortafuegos y proteger el acceso a determinadas zonas con roles. Al usar la autenticación HTTP, puedes aprovechar sin esfuerzo, el cuadro de diálogo nativo nombre de usuario/contraseña que ofrecen todos los navegadores. Sin embargo, fuera de la caja, Symfony es compatible con múltiples mecanismos de autenticación. Para información detallada sobre todos ellos, consulta la Referencia para afinar el sistema de seguridad.

            -

            En esta sección, vamos a mejorar este proceso permitiendo la autenticación del usuario a través de un formulario de acceso HTML tradicional.

            -

            En primer lugar, activa el formulario de acceso en el cortafuegos:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    firewalls:
-        secured_area:
-            pattern:    ^/
-            anonymous: ~
-            form_login:
-                login_path:  login
-                check_path:  login_check
-
              -
              -
              • -
            • XML
              <?xml version="1.0" encoding="UTF-8"?>
-
-<srv:container xmlns="http://symfony.com/schema/dic/security"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:srv="http://symfony.com/schema/dic/services"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
-
-    <!-- app/config/security.xml -->
-
-    <config>
-        <firewall name="secured_area" pattern="^/">
-            <anonymous />
-            <form-login login_path="login" check_path="login_check" />
-        </firewall>
-    </config>
-</srv:container>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'secured_area' => array(
-            'pattern'    => '^/',
-            'anonymous'  => array(),
-            'form_login' => array(
-                'login_path' => 'login',
-                'check_path' => 'login_check',
-            ),
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Si no necesitas personalizar tus valores login_path o check_path (los valores utilizados aquí son los valores predeterminados), puedes acortar tu configuración:

            -
            -
              -
            • YAML
              form_login: ~
-
              -
              -
              • -
            • XML
              <form-login />
-
              -
              -
              • -
            • PHP
              'form_login' => array(),
-
              -
              -
              • -
            -
            -
            -

            Ahora, cuando el sistema de seguridad inicia el proceso de autenticación, redirige al usuario al formulario de acceso (predeterminado a /login). La implementación visual de este formulario de acceso es tu trabajo. Primero, crea las dos rutas que utilizarás en la configuración de seguridad: La ruta login mostrará el formulario de inicio de sesión (es decir /login) y la ruta login_check procesará el formulario enviado (es decir /login_check):

            -
            -
              -
            • YAML
              # app/config/routing.yml
-login:
-    pattern:   /login
-    defaults:  { _controller: AcmeSecurityBundle:Security:login }
-login_check:
-    pattern:   /login_check
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="login" pattern="/login">
-        <default key="_controller">AcmeSecurityBundle:Security:login</default>
-    </route>
-    <route id="login_check" pattern="/login_check" />
-
-</routes>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('login', new Route('/login', array(
-    '_controller' => 'AcmeDemoBundle:Security:login',
-)));
-$collection->add('login_check', new Route('/login_check', array()));
-
-return $collection;
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            No necesitas implementar un controlador para la URL /login_check ya que el cortafuegos automáticamente captura y procesa cualquier formulario enviado a esta URL.

            -
            -

            -Nuevo en la versión 2.1: A partir de Symfony 2.1, debes tener configuradas las rutas para tus claves login_path, check_path y logout. Estas claves pueden ser nombres de ruta (tal como muestra este ejemplo) o las URL que tienen rutas configuradas para ello.

            -

            Ten en cuenta que el nombre de la ruta login coincide con el valor login_path configurado, a donde el sistema de seguridad redirigirá a los usuarios que necesiten ingresar.

            -

            A continuación, crea el controlador que mostrará el formulario de acceso:

            -
            // src/Acme/SecurityBundle/Controller/SecurityController.php;
-namespace Acme\SecurityBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Symfony\Component\Security\Core\SecurityContext;
-
-class SecurityController extends Controller
-{
-    public function loginAction()
-    {
-        $request = $this->getRequest();
-        $session = $request->getSession();
-
-        // obtiene el error de inicio de sesión si lo hay
-        if ($request->attributes->has(SecurityContext::AUTHENTICATION_ERROR)) {
-            $error = $request->attributes->get(
-                SecurityContext::AUTHENTICATION_ERROR
-            );
-        } else {
-            $error = $session->get(SecurityContext::AUTHENTICATION_ERROR);
-            $session->remove(SecurityContext::AUTHENTICATION_ERROR);
-        }
-
-        return $this->render(
-            'AcmeSecurityBundle:Security:login.html.twig',
-            array(
-                // último nombre de usuario ingresado
-                'last_username' => $session->get(SecurityContext::LAST_USERNAME),
-                'error'         => $error,
-            )
-        );
-    }
-}
-
            -
            -

            No dejes que este controlador te confunda. Como veremos en un momento, cuando el usuario envía el formulario, el sistema de seguridad automáticamente se encarga de procesar la recepción del formulario por ti. Si el usuario ha presentado un nombre de usuario o contraseña no válidos, este controlador lee el error del formulario enviado desde el sistema de seguridad de modo que se pueda mostrar al usuario.

            -

            En otras palabras, tu trabajo es mostrar el formulario al usuario y los errores de ingreso que puedan haber ocurrido, pero, el propio sistema de seguridad se encarga de verificar el nombre de usuario y contraseña y la autenticación del usuario.

            -

            Por último, crea la plantilla correspondiente:

            -
            -
              -
            • Twig
              {# src/Acme/SecurityBundle/Resources/views/Security/login.html.twig #}
-{% if error %}
-    <div>{{ error.message }}</div>
-{% endif %}
-
-<form action="{{ path('login_check') }}" method="post">
-    <label for="username">Username:</label>
-    <input type="text" id="username" name="_username" value="{{ last_username }}" />
-
-    <label for="password">Password:</label>
-    <input type="password" id="password" name="_password" />
-
-    {#
-        Si deseas controlar la URL a la que rediriges al
-        usuario en caso de éxito (más detalles abajo)
-        <input type="hidden" name="_target_path" value="/account" />
-    #}
-
-    <button type="submit">login</button>
-</form>
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/SecurityBundle/Resources/views/Security/login.html.php -->
-<?php if ($error): ?>
-    <div><?php echo $error->getMessage() ?></div>
-<?php endif; ?>
-
-<form action="<?php echo $view['router']->generate('login_check') ?>" method="post">
-    <label for="username">Username:</label>
-    <input type="text" id="username" name="_username" value="<?php echo $last_username ?>" />
-
-    <label for="password">Password:</label>
-    <input type="password" id="password" name="_password" />
-
-    <!--
-        Si deseas controlar la URL a la que rediriges al usuario en caso de éxito (más detalles abajo)
-        <input type="hidden" name="_target_path" value="/account" />
-    -->
-
-    <button type="submit">login</button>
-</form>
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            La variable error pasada a la plantilla es una instancia de Symfony\Component\Security\Core\Exception\AuthenticationException. -Esta puede contener más información —o incluso información confidencial— sobre el fallo de autenticación, ¡por lo tanto utilízala prudentemente!

            -
            -

            El formulario tiene muy pocos requisitos. En primer lugar, presentando el formulario a /login_check (a ​​través de la ruta login_check), el sistema de seguridad debe interceptar el envío del formulario y procesarlo automáticamente. En segundo lugar, el sistema de seguridad espera que los campos presentados se llamen _username y _password (estos nombres de campo se pueden configurar).

            -

            ¡Y eso es todo! Cuando envías el formulario, el sistema de seguridad automáticamente comprobará las credenciales del usuario y, o bien autenticará al usuario o lo enviará al formulario de acceso donde se puede mostrar el error.

            -

            Revisemos todo el proceso:

            -
              -
            1. El usuario intenta acceder a un recurso que está protegido;
              2. -
            2. El cortafuegos inicia el proceso de autenticación redirigiendo al usuario al formulario de acceso (/login);
              3. -
            3. La página /login reproduce el formulario de acceso a través de la ruta y el controlador creado en este ejemplo;
              4. -
            4. El usuario envía el formulario de acceso a /login_check;
              5. -
            5. El sistema de seguridad intercepta la petición, comprueba las credenciales presentadas por el usuario, autentica al usuario si todo está correcto, y si no, envía al usuario de nuevo al formulario de acceso.
              6. -
            -

            Por omisión, si las credenciales presentadas son correctas, el usuario será redirigido a la página solicitada originalmente (por ejemplo /admin/foo). Si originalmente el usuario fue directo a la página de inicio de sesión, será redirigido a la página principal. -Esto puede ser altamente personalizado, lo cual te permite, por ejemplo, redirigir al usuario a una URL específica.

            -

            Para más detalles sobre esto y cómo personalizar el proceso de entrada en general, consulta Cómo personalizar el formulario de acceso.

            - -
            -
            -

            Autorizando

            -

            El primer paso en la seguridad siempre es la autenticación: el proceso de verificar quién es el usuario. Con Symfony, la autenticación se puede hacer de cualquier manera —a través de un formulario de acceso, autenticación básica HTTP, e incluso a través de Facebook.

            -

            Una vez que el usuario se ha autenticado, comienza la autorización. La autorización proporciona una forma estándar y potente para decidir si un usuario puede acceder a algún recurso (una URL, un modelo de objetos, una llamada a un método, ...). Esto funciona asignando roles específicos a cada usuario y, a continuación, requiriendo diferentes roles para diferentes recursos.

            -

            El proceso de autorización tiene dos lados diferentes:

            -
              -
            1. El usuario tiene un conjunto de roles específico;
              2. -
            2. Un recurso requiere un rol específico a fin de tener acceso.
              3. -
            -

            En esta sección, nos centraremos en cómo proteger diferentes recursos (por ejemplo, URL, llamadas a métodos, etc.) con diferentes roles. Más tarde, aprenderás más sobre cómo crear y asignar roles a los usuarios.

            -
            -

            Protegiendo patrones de URL específicas

            -

            La forma más básica para proteger parte de tu aplicación es asegurar un patrón de URL completo. Ya lo viste en el primer ejemplo de este capítulo, cómo algo que coincide con el patrón de la expresión regular ^/admin requiere el rol ROLE_ADMIN.

            -
            -

            Prudencia

            -

            Entender exactamente cómo trabaja access_control es muy importante para garantizar que tu aplicación está protegida correctamente. Ve más adelante Entendiendo cómo trabaja access_control para información detallada.

            -
            -

            Puedes definir tantos patrones URL como necesites —cada uno es una expresión regular—.

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    # ...
-    access_control:
-        - { path: ^/admin/users, roles: ROLE_SUPER_ADMIN }
-        - { path: ^/admin, roles: ROLE_ADMIN }
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <!-- ... -->
-    <rule path="^/admin/users" role="ROLE_SUPER_ADMIN" />
-    <rule path="^/admin" role="ROLE_ADMIN" />
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    // ...
-    'access_control' => array(
-        array('path' => '^/admin/users', 'role' => 'ROLE_SUPER_ADMIN'),
-        array('path' => '^/admin', 'role' => 'ROLE_ADMIN'),
-    ),
-));
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Al prefijar la ruta con ^ te aseguras que sólo coinciden las URL que comienzan con ese patrón. Por ejemplo, una ruta de simplemente /admin (sin el ^) correctamente coincidirá con /admin/foo pero también coincide con la URL /foo/admin.

            -
            -
            -
            -

            Entendiendo cómo trabaja access_control

            -

            Por cada petición entrante, Symfony2 comprueba cada opción access_control para encontrar una que concuerde con la petición actual. Tan pronto como encuentra una entrada access_control coincidente, se detiene —únicamente si el primer access_control concordante se usa para forzar el acceso—.

            -

            Cada access_control tiene varias opciones que configuran dos diferentes cosas: (a) la petición entrante emparejada debe tener esta entrada de control de acceso y (b) una vez emparejada, debe tener algún tipo de restricción de acceso aplicable:

            -

            (a) Emparejando Opciones

            -

            Symfony2 crea una instancia de Symfony\Component\HttpFoundation\RequestMatcher para cada entrada access_control, la cual determina si o no se debería usar un determinado control de acceso en esa petición. Las siguientes opciones de access_control se utilizan para emparejar:

            -
              -
            • path
              • -
            • ip
              • -
            • host
              • -
            • methods
              • -
            -

            Toma las siguientes entradas de access_control como ejemplo:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    # ...
-    access_control:
-        - { path: ^/admin, roles: ROLE_USER_IP, ip: 127.0.0.1 }
-        - { path: ^/admin, roles: ROLE_USER_HOST, host: symfony.com }
-        - { path: ^/admin, roles: ROLE_USER_METHOD, methods: [POST, PUT] }
-        - { path: ^/admin, roles: ROLE_USER }
-
              -
              -
              • -
            • XML
              <access-control>
-    <rule path="^/admin" role="ROLE_USER_IP" ip="127.0.0.1" />
-    <rule path="^/admin" role="ROLE_USER_HOST" host="symfony.com" />
-    <rule path="^/admin" role="ROLE_USER_METHOD" method="POST, PUT" />
-    <rule path="^/admin" role="ROLE_USER" />
-</access-control>
-
              -
              -
              • -
            • PHP
              'access_control' => array(
-    array('path' => '^/admin', 'role' => 'ROLE_USER_IP', 'ip' => '127.0.0.1'),
-    array('path' => '^/admin', 'role' => 'ROLE_USER_HOST', 'host' => 'symfony.com'),
-    array('path' => '^/admin', 'role' => 'ROLE_USER_METHOD', 'method' => 'POST, PUT'),
-    array('path' => '^/admin', 'role' => 'ROLE_USER'),
-),
-
              -
              -
              • -
            -
            -

            Para cada petición entrante, Symfony debe decidir cuál access_control utilizar basándose en la URI, la dirección IP del cliente, el nombre del servidor entrante, y el método de la petición. Recuerda, se usa la primera regla que coincida, y si para una entrada no se especifican ip, host o method, ese access_control emparejará con cualquier ip, host o method:

            - -------- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            URIIPHOSTMETHODaccess_control¿Porqué?
            /admin/user127.0.0.1example.comGETregla #1 (ROLE_USER_IP)La URI empareja con path y la IP con ip.
            /admin/user127.0.0.1symfony.comGETregla #1 (ROLE_USER_IP)path e ip todavía concuerdan. Esta además debería -emparejar con la entrada ROLE_USER_HOST, pero sólo si se -usa el primer access_control coincidente.
            /admin/user168.0.0.1symfony.comGETregla #2 (ROLE_USER_HOST)La ip no concuerda con la primera regla, por lo tanto se -usa la segunda regla (la cual concuerda).
            /admin/user168.0.0.1symfony.comPOSTregla #2 (ROLE_USER_HOST)La segunda regla todavía concuerda. Esta además debería -emparejar con la tercera regla (ROLE_USER_METHOD), pero -solo si se usa la primer access_control coincidente.
            /admin/user168.0.0.1example.comPOSTregla #3 (ROLE_USER_METHOD)La ip y host no concuerdan con las primeras dos -entradas, pero la tercera —ROLE_USER_METHOD— concuerda -y se usa.
            /admin/user168.0.0.1example.comGETregla #4 (ROLE_USER)La ip, host y method evitan que las primeras tres -entradas concuerden. Pero debido a que la URI concuerda con -el patrón path de la entrada ROLE_USER, esta se usa.
            /foo127.0.0.1symfony.comPOSTno hay entradas concordantesEsta no concuerda con ninguna regla access_control, debido -a que la URI no concuerda con los valores de path.
            -

            (b) Forzando el acceso

            -

            Una vez que Symfony2 ha decidido cuál entrada access_control concuerda (si la hay), entonces aplica las restricciones de acceso basándose en las opciones roles y requires_channel:

            -
              -
            • role Si el usuario no tiene determinado rol o roles, entonces el acceso es denegado (internamente, se lanza una Symfony\Component\Security\Core\Exception\AccessDeniedException);
              • -
            • requires_channel Si el canal de la petición entrante (p. ej. http) no concuerda con este valor (p. ej. https), el usuario será redirigido (p. ej. redirigido de http a https, o viceversa).
              • -
            -
            -

            Truco

            -

            Si el acceso es denegado, el sistema intentará autenticar al usuario si aún no lo está (p. ej. redirigiendo al usuario a la página de inicio de sesión). Si el usuario ya inició sesión, se mostrará la página del error 403 «acceso denegado». Consulta Cómo personalizar páginas de error para más información.

            -
            -
            -
            -

            Protegiendo por IP

            -

            En algunas situaciones puede surgir la necesidad de restringir el acceso a una determinada ruta basándose en la IP. Esto es importante particularmente en el caso de la Inclusión del borde lateral (ESI), por ejemplo. Cuándo ESI está habilitada, es recomendable proteger el acceso a direcciones URL ESI. De hecho, algunas ESI pueden contener algo de contenido privado tal como la información del usuario actual. Para impedir cualquier acceso directo a estos recursos desde un navegador web (deduciendo el patrón ESI de la URL), la ruta ESI se debe asegurar para que únicamente sea visible desde la caché de un delegado inverso de confianza.

            -

            Aquí tienes un ejemplo de cómo podrías proteger todas las rutas ESI que empiezan con un determinado prefijo, /esi, para que no se accedan desde el exterior:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    # ...
-    access_control:
-        - { path: ^/esi, roles: IS_AUTHENTICATED_ANONYMOUSLY, ip: 127.0.0.1 }
-        - { path: ^/esi, roles: ROLE_NO_ACCESS }
-
              -
              -
              • -
            • XML
              <access-control>
-    <rule path="^/esi" role="IS_AUTHENTICATED_ANONYMOUSLY" ip="127.0.0.1" />
-    <rule path="^/esi" role="ROLE_NO_ACCESS" />
-</access-control>
-
              -
              -
              • -
            • PHP
              'access_control' => array(
-    array('path' => '^/esi', 'role' => 'IS_AUTHENTICATED_ANONYMOUSLY', 'ip' => '127.0.0.1'),
-    array('path' => '^/esi', 'role' => 'ROLE_NO_ACCESS'),
-),
-
              -
              -
              • -
            -
            -

            Así es como trabaja cuándo la ruta es /esi/algo proveniente de la IP 10.0.0.1:

            -
              -
            • La primera regla del control de acceso es ignorada debido a que path concuerda pero la ip no;
              • -
            • La segunda regla de control de acceso se activa (la única restricción sigue siendo path y concuerda): Puesto que el usuario no puede tener el rol ROLE_NO_ACCESS cuando no está definido, el acceso es denegado (el rol ROLE_NO_ACCESS puede ser cualquier cosa que no empareje con un rol existente, solo sirve como un truco para negar el acceso siempre).
              • -
            -

            Ahora, si la misma petición proviene de 127.0.0.1:

            -
              -
            • Ahora, se activa la primera regla del control de acceso porque ambas path e ip concuerdan: El acceso es permitido debido a que el usuario siempre tiene el rol IS_AUTHENTICATED_ANONYMOUSLY.
              • -
            • La segunda regla de acceso no se examina debido a que la primera regla concordó.
              • -
            -
            -
            -

            Protegiendo por canal

            -

            También puedes requerir que un usuario acceda a una URL vía SSL; Sólo utiliza el argumento requires_channel en cualquier entrada del access_control:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    # ...
-    access_control:
-        - { path: ^/cart/checkout, roles: IS_AUTHENTICATED_ANONYMOUSLY, requires_channel: https }
-
              -
              -
              • -
            • XML
              <access-control>
-    <rule path="^/cart/checkout" role="IS_AUTHENTICATED_ANONYMOUSLY" requires_channel="https" />
-</access-control>
-
              -
              -
              • -
            • PHP
              'access_control' => array(
-    array('path' => '^/cart/checkout', 'role' => 'IS_AUTHENTICATED_ANONYMOUSLY', 'requires_channel' => 'https'),
-),
-
              -
              -
              • -
            -
            -
            -
            -

            Protegiendo un controlador

            -

            Proteger tu aplicación basándote en los patrones URL es fácil, pero, en algunos casos, puede no estar suficientemente bien ajustado. Cuando sea necesario, fácilmente puedes forzar la autorización desde un controlador:

            -
            // ...
-use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-
-public function helloAction($name)
-{
-    if (false === $this->get('security.context')->isGranted('ROLE_ADMIN')) {
-        throw new AccessDeniedException();
-    }
-
-    // ...
-}
-
            -
            -

            También puedes optar por instalar y utilizar el opcional JMSSecurityExtraBundle, con el cual puedes asegurar tu controlador usando anotaciones:

            -
            // ...
-use JMS\SecurityExtraBundle\Annotation\Secure;
-
-/**
- * @Secure(roles="ROLE_ADMIN")
- */
-public function helloAction($name)
-{
-    // ...
-}
-
            -
            -

            Para más información, consulta la documentación de JMSSecurityExtraBundle. Si estás usando la distribución estándar de Symfony, este paquete está disponible de forma predeterminada. -Si no es así, lo puedes descargar e instalar.

            -
            -
            -

            Protegiendo otros servicios

            -

            De hecho, en Symfony puedes proteger cualquier cosa utilizando una estrategia similar a la observada en la sección anterior. Por ejemplo, supongamos que tienes un servicio (es decir, una clase PHP), cuyo trabajo consiste en enviar mensajes de correo electrónico de un usuario a otro. -Puedes restringir el uso de esta clase —no importa dónde se esté utilizando— a los usuarios que tienen un rol específico.

            -

            Para más información sobre cómo utilizar el componente de seguridad para proteger diferentes servicios y métodos en tu aplicación, consulta Cómo proteger cualquier servicio o método de tu aplicación.

            -
            -
            -

            Listas de control de acceso (ACL): Protegiendo objetos individuales de base de datos

            -

            Imagina que estás diseñando un sistema de blog donde los usuarios pueden comentar tus entradas. Ahora, deseas que un usuario pueda editar sus propios comentarios, pero no los de otros usuarios. Además, como usuario admin, quieres tener la posibilidad de editar todos los comentarios.

            -

            El componente de seguridad viene con un sistema opcional de lista de control de acceso (ACL) que puedes utilizar cuando sea necesario para controlar el acceso a instancias individuales de un objeto en el sistema. Sin ACL, puedes proteger tu sistema para que sólo determinados usuarios puedan editar los comentarios del blog en general. Pero con ACL, puedes restringir o permitir el acceso en base a comentario por comentario.

            -

            Para más información, consulta el artículo del recetario: Cómo usar las listas para el control de acceso (ACL).

            -
            -
            -
            -

            Usuarios

            -

            En las secciones anteriores, aprendiste cómo puedes proteger diferentes recursos que requieren un conjunto de roles para un recurso. En esta sección vamos a explorar el otro lado de la autorización: los usuarios.

            -
            -

            ¿De dónde provienen los usuarios? (Proveedores de usuarios)

            -

            Durante la autenticación, el usuario envía un conjunto de credenciales (por lo general un nombre de usuario y contraseña). El trabajo del sistema de autenticación es concordar esas credenciales contra una piscina de usuarios. Entonces, ¿de dónde viene esta lista de usuarios?

            -

            En Symfony2, los usuarios pueden venir de cualquier parte —un archivo de configuración, una tabla de base de datos, un servicio web, o cualquier otra cosa que se te ocurra. Todo lo que proporcione uno o más usuarios al sistema de autenticación se conoce como «proveedor de usuario». -Symfony2 de serie viene con los dos proveedores de usuario más comunes: uno que carga los usuarios de un archivo de configuración y otro que carga usuarios de una tabla de la base de datos.

            -
            -

            Especificando usuarios en un archivo de configuración

            -

            La forma más fácil para especificar usuarios es directamente en un archivo de configuración. -De hecho, ya lo has visto en algunos ejemplos de este capítulo.

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    # ...
-    providers:
-        default_provider:
-            memory:
-                users:
-                    ryan:  { password: ryanpass, roles: 'ROLE_USER' }
-                    admin: { password: kitten, roles: 'ROLE_ADMIN' }
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <!-- ... -->
-    <provider name="default_provider">
-        <memory>
-            <user name="ryan" password="ryanpass" roles="ROLE_USER" />
-            <user name="admin" password="kitten" roles="ROLE_ADMIN" />
-        </memory>
-    </provider>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    // ...
-    'providers' => array(
-        'default_provider' => array(
-            'memory' => array(
-                'users' => array(
-                    'ryan' => array('password' => 'ryanpass', 'roles' => 'ROLE_USER'),
-                    'admin' => array('password' => 'kitten', 'roles' => 'ROLE_ADMIN'),
-                ),
-            ),
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            Este proveedor de usuario se denomina proveedor de usuario «en memoria», ya que los usuarios no se almacenan en alguna parte de una base de datos. El objeto usuario en realidad lo proporciona Symfony (Symfony\Component\Security\Core\User\User).

            -
            -

            Truco

            -

            Cualquier proveedor de usuario puede cargar usuarios directamente desde la configuración especificando el parámetro de configuración users y la lista de usuarios debajo de él.

            -
            -
            -

            Prudencia

            -

            Si tu nombre de usuario es completamente numérico (por ejemplo, 77) o contiene un guión (por ejemplo, user-name), debes utilizar la sintaxis alterna al especificar usuarios en YAML:

            -
            users:
-        - { name: 77, password: pass, roles: 'ROLE_USER' }
-        - { name: user-name, password: pass, roles: 'ROLE_USER' }
-
            -
            -
            -

            Para sitios pequeños, este método es rápido y fácil de configurar. Para sistemas más complejos, querrás cargar usuarios desde la base de datos.

            -
            -
            -

            Cargando usuarios de la base de datos

            -

            Si deseas cargar tus usuarios a través del ORM de Doctrine, lo puedes hacer creando una clase User y configurando el proveedor entity.

            -
            -

            Truco

            -

            Hay disponible un paquete de código abierto de alta calidad, el cual te permite almacenar tus usuarios a través del ORM u ODM de Doctrine. Lee más acerca del FOSUserBundle en GitHub.

            -
            -

            Con este enfoque, primero crea tu propia clase User, la cual se almacenará en la base de datos.

            -
            // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Security\Core\User\UserInterface;
-use Doctrine\ORM\Mapping as ORM;
-
-/**
- * @ORM\Entity
- */
-class User implements UserInterface
-{
-    /**
-     * @ORM\Column(type="string", length=255)
-     */
-    protected $username;
-
-    // ...
-}
-
            -
            -

            En cuanto al sistema de seguridad se refiere, el único requisito para tu clase Usuario personalizada es que implemente la interfaz Symfony\Component\Security\Core\User\UserInterface. Esto significa que el concepto de un «usuario» puede ser cualquier cosa, siempre y cuando implemente esta interfaz.

            -

            -Nuevo en la versión 2.1: En Symfony 2.1, se removió el método equals de la UserInterface. -Si necesitas sustituir la implementación predeterminada de la lógica de comparación, implementa la nueva interfaz Symfony\Component\Security\Core\User\EquatableInterface.

            -
            -

            Nota

            -

            El objeto User se debe serializar y guardar en la sesión entre peticiones, por lo tanto se recomienda que implementes la interfaz Serializable en tu objeto que representa al usuario. Esto es especialmente importante si tu clase User tiene una clase padre con propiedades privadas.

            -
            -

            A continuación, configura una entidad proveedora de usuario, y apúntala a tu clase User:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    providers:
-        main:
-            entity: { class: Acme\UserBundle\Entity\User, property: username }
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <provider name="main">
-        <entity class="Acme\UserBundle\Entity\User" property="username" />
-    </provider>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'providers' => array(
-        'main' => array(
-            'entity' => array('class' => 'Acme\UserBundle\Entity\User', 'property' => 'username'),
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            Con la introducción de este nuevo proveedor, el sistema de autenticación intenta cargar un objeto User de la base de datos utilizando el campo username de esa clase.

            -
            -

            Nota

            -

            Este ejemplo sólo intenta mostrar la idea básica detrás del proveedor entity. Para ver un ejemplo completo funcionando, consulta Cómo cargar usuarios desde la base de datos con seguridad (el Proveedor de entidad).

            -
            -

            Para más información sobre cómo crear tu propio proveedor personalizado (por ejemplo, si necesitas cargar usuarios a través de un servicio Web), consulta Cómo crear un proveedor de usuario personalizado.

            -
            -
            -
            -

            Codificando la contraseña del usuario

            -

            Hasta ahora, por simplicidad, todos los ejemplos tienen las contraseñas de los usuarios almacenadas en texto plano (si los usuarios se almacenan en un archivo de configuración o en alguna base de datos). Por supuesto, en una aplicación real, por razones de seguridad, desearás codificar las contraseñas de los usuarios. Esto se logra fácilmente asignando la clase Usuario a una de las varias integradas en encoders. Por ejemplo, para almacenar los usuarios en memoria, pero ocultar sus contraseñas a través de sha1, haz lo siguiente:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    # ...
-    providers:
-        in_memory:
-            memory:
-                users:
-                    ryan:  { password: bb87a29949f3a1ee0559f8a57357487151281386, roles: 'ROLE_USER' }
-                    admin: { password: 74913f5cd5f61ec0bcfdb775414c2fb3d161b620, roles: 'ROLE_ADMIN' }
-
-    encoders:
-        Symfony\Component\Security\Core\User\User:
-            algorithm:   sha1
-            iterations: 1
-            encode_as_base64: false
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <!-- ... -->
-    <provider name="in_memory">
-        <memory>
-            <user name="ryan" password="bb87a29949f3a1ee0559f8a57357487151281386" roles="ROLE_USER" />
-            <user name="admin" password="74913f5cd5f61ec0bcfdb775414c2fb3d161b620" roles="ROLE_ADMIN" />
-        </memory>
-    </provider>
-
-    <encoder class="Symfony\Component\Security\Core\User\User" algorithm="sha1" iterations="1" encode_as_base64="false" />
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    // ...
-    'providers' => array(
-        'in_memory' => array(
-            'memory' => array(
-                'users' => array(
-                    'ryan' => array('password' => 'bb87a29949f3a1ee0559f8a57357487151281386', 'roles' => 'ROLE_USER'),
-                    'admin' => array('password' => '74913f5cd5f61ec0bcfdb775414c2fb3d161b620', 'roles' => 'ROLE_ADMIN'),
-                ),
-            ),
-        ),
-    ),
-    'encoders' => array(
-        'Symfony\Component\Security\Core\User\User' => array(
-            'algorithm'         => 'sha1',
-            'iterations'        => 1,
-            'encode_as_base64'  => false,
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            Al establecer las iterations a 1 y encode_as_base64 en false, la contraseña simplemente se corre una vez a través del algoritmo sha1 y sin ninguna codificación adicional. Ahora puedes calcular el hash de la contraseña mediante programación (por ejemplo, hash('sha1', 'ryanpass')) o a través de alguna herramienta en línea como functions-online.com

            -

            Si vas a crear tus usuarios dinámicamente (y almacenarlos en una base de datos), puedes utilizar algoritmos hash aún más difíciles y, luego confiar en un objeto codificador de clave real para ayudarte a codificar las contraseñas. Por ejemplo, supongamos que tu objeto usuario es Acme\UserBundle\Entity\User (como en el ejemplo anterior). Primero, configura el codificador para ese usuario:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    # ...
-
-    encoders:
-        Acme\UserBundle\Entity\User: sha512
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <!-- ... -->
-
-    <encoder class="Acme\UserBundle\Entity\User" algorithm="sha512" />
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    // ...
-    'encoders' => array(
-        'Acme\UserBundle\Entity\User' => 'sha512',
-    ),
-));
-
              -
              -
              • -
            -
            -

            En este caso, estás utilizando el algoritmo SHA512 fuerte. Además, puesto que hemos especificado simplemente el algoritmo (sha512) como una cadena, el sistema de manera predeterminada revuelve tu contraseña 5000 veces en una fila y luego la codifica como base64. En otras palabras, la contraseña ha sido fuertemente ofuscada por lo tanto la contraseña revuelta no se puede decodificar (es decir, no se puede determinar la contraseña desde la contraseña ofuscada).

            -

            -Nuevo en la versión 2.2: A partir de Symfony 2.2 también puedes utilizar los codificadores de contraseña PBKDF2 y BCrypt.

            -
            -

            Determinando la contraseña codificada

            -

            Si tienes algún formulario de registro para los usuarios, necesitas poder determinar el algoritmo de codificación utilizado en la contraseña, para que lo puedas usar en tu usuario. No importa qué algoritmo configures para tu objeto usuario, desde un controlador siempre puedes determinar el algoritmo de codificación de la contraseña de la siguiente manera:

            -
            $factory = $this->get('security.encoder_factory');
-$user = new Acme\UserBundle\Entity\User();
-
-$encoder = $factory->getEncoder($user);
-$password = $encoder->encodePassword('ryanpass', $user->getSalt());
-$user->setPassword($password);
-
            -
            -
            -
            -
            -

            Recuperando el objeto usuario

            -

            Después de la autenticación, el objeto Usuario del usuario actual se puede acceder a través del servicio security.context. Desde el interior de un controlador, este se verá así:

            -
            public function indexAction()
-{
-    $user = $this->get('security.context')->getToken()->getUser();
-}
-
            -
            -

            En un controlador existe un atajo para esto:

            -
            public function indexAction()
-{
-    $user = $this->getUser();
-}
-
            -
            -
            -

            Nota

            -

            Los usuarios anónimos técnicamente están autenticados, lo cual significa que el método isAuthenticated() de un objeto usuario anónimo devolverá true. Para comprobar si el usuario está autenticado realmente, verifica el rol IS_AUTHENTICATED_FULLY.

            -
            -

            En una plantilla Twig puedes acceder a este objeto a través de la clave app.user, la cual llama al método GlobalVariables::getUser():

            -
            -
              -
            • Twig
              <p>Username: {{ app.user.username }}</p>
-
              -
              -
              • -
            • PHP
              <p>Username: <?php echo $app->getUser()->getUsername() ?></p>
-
              -
              -
              • -
            -
            -
            -
            -

            Usando múltiples proveedores de usuario

            -

            Cada mecanismo de autenticación (por ejemplo, la autenticación HTTP, formulario de acceso, etc.) utiliza exactamente un proveedor de usuario, y de forma predeterminada utilizará el primer proveedor de usuario declarado. Pero, si deseas especificar unos cuantos usuarios a través de la configuración y el resto de los usuarios en la base de datos? Esto es posible creando un nuevo proveedor que encadene los dos:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    providers:
-        chain_provider:
-            chain:
-                providers: [in_memory, user_db]
-        in_memory:
-            memory:
-                users:
-                    foo: { password: test }
-        user_db:
-            entity: { class: Acme\UserBundle\Entity\User, property: username }
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <provider name="chain_provider">
-        <chain>
-            <provider>in_memory</provider>
-            <provider>user_db</provider>
-        </chain>
-    </provider>
-    <provider name="in_memory">
-        <memory>
-            <user name="foo" password="test" />
-        </memory>
-    </provider>
-    <provider name="user_db">
-        <entity class="Acme\UserBundle\Entity\User" property="username" />
-    </provider>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'providers' => array(
-        'chain_provider' => array(
-            'chain' => array(
-                'providers' => array('in_memory', 'user_db'),
-            ),
-        ),
-        'in_memory' => array(
-            'memory' => array(
-               'users' => array(
-                   'foo' => array('password' => 'test'),
-               ),
-            ),
-        ),
-        'user_db' => array(
-            'entity' => array('class' => 'Acme\UserBundle\Entity\User', 'property' => 'username'),
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            Ahora, todos los mecanismos de autenticación utilizan el chain_provider, puesto que es el primero especificado. El chain_provider, a su vez, intenta cargar el usuario, tanto el proveedor in_memory cómo USER_DB.

            -
            -

            Truco

            -

            Si no tienes razones para separar a tus usuarios in_memory de tus usuarios user_db, lo puedes hacer aún más fácil combinando las dos fuentes en un único proveedor:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    providers:
-        main_provider:
-            memory:
-                users:
-                    foo: { password: test }
-            entity:
-                class: Acme\UserBundle\Entity\User,
-                property: username
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <provider name=="main_provider">
-        <memory>
-            <user name="foo" password="test" />
-        </memory>
-        <entity class="Acme\UserBundle\Entity\User" property="username" />
-    </provider>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'providers' => array(
-        'main_provider' => array(
-            'memory' => array(
-                'users' => array(
-                    'foo' => array('password' => 'test'),
-                ),
-            ),
-            'entity' => array('class' => 'Acme\UserBundle\Entity\User', 'property' => 'username'),
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -
            -

            También puedes configurar el cortafuegos o mecanismos de autenticación individuales para utilizar un proveedor específico. Una vez más, a menos que explícitamente especifiques un proveedor, siempre se utiliza el primer proveedor:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    firewalls:
-        secured_area:
-            # ...
-            provider: user_db
-            http_basic:
-                realm: "Secured Demo Area"
-                provider: in_memory
-            form_login: ~
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <firewall name="secured_area" pattern="^/" provider="user_db">
-        <!-- ... -->
-        <http-basic realm="Secured Demo Area" provider="in_memory" />
-        <form-login />
-    </firewall>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'secured_area' => array(
-            // ...
-            'provider' => 'user_db',
-            'http_basic' => array(
-                // ...
-                'provider' => 'in_memory',
-            ),
-            'form_login' => array(),
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            En este ejemplo, si un usuario intenta acceder a través de autenticación HTTP, el sistema de autenticación debe utilizar el proveedor de usuario in_memory. Pero si el usuario intenta acceder a través del formulario de acceso, utilizará el proveedor USER_DB (ya que es el valor predeterminado para el servidor de seguridad en su conjunto).

            -

            Para más información acerca de los proveedores de usuario y la configuración del cortafuegos, consulta la Referencia de configuración de Security.

            -
            -
            -
            -

            Roles

            -

            La idea de un «rol» es clave para el proceso de autorización. Cada usuario tiene asignado un conjunto de roles y cada recurso requiere uno o más roles. Si el usuario tiene los roles necesarios, se le concede acceso. En caso contrario se deniega el acceso.

            -

            Los roles son bastante simples, y básicamente son cadenas que puedes inventar y utilizar cuando sea necesario (aunque los roles son objetos internos). Por ejemplo, si necesitas comenzar a limitar el acceso a la sección admin del blog de tu sitio web, puedes proteger esa sección con un rol llamado ROLE_BLOG_ADMIN. Este rol no necesita estar definido en ningún lugar —puedes comenzar a usarlo.

            -
            -

            Nota

            -

            Todos los roles deben comenzar con el prefijo ROLE_ el cual será gestionado por Symfony2. Si defines tus propios roles con una clase Role dedicada (más avanzada), no utilices el prefijo ROLE_.

            -
            -
            -

            Roles jerárquicos

            -

            En lugar de asociar muchos roles a los usuarios, puedes definir reglas de herencia creando una jerarquía de roles:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    role_hierarchy:
-        ROLE_ADMIN:       ROLE_USER
-        ROLE_SUPER_ADMIN: [ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH]
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <role id="ROLE_ADMIN">ROLE_USER</role>
-    <role id="ROLE_SUPER_ADMIN">ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH</role>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'role_hierarchy' => array(
-        'ROLE_ADMIN'       => 'ROLE_USER',
-        'ROLE_SUPER_ADMIN' => array('ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH'),
-    ),
-));
-
              -
              -
              • -
            -
            -

            En la configuración anterior, los usuarios con rol ROLE_ADMIN también tendrán el rol de ROLE_USER. El rol ROLE_SUPER_ADMIN tiene ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH y ROLE_USER (heredado de ROLE_ADMIN).

            -
            -
            -
            -

            Cerrando sesión

            -

            Por lo general, también quieres que tus usuarios puedan salir. Afortunadamente, el cortafuegos puede manejar esto automáticamente cuando activas el parámetro de configuración logout:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    firewalls:
-        secured_area:
-            # ...
-            logout:
-                path:   /logout
-                target: /
-    # ...
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <firewall name="secured_area" pattern="^/">
-        <!-- ... -->
-        <logout path="/logout" target="/" />
-    </firewall>
-    <!-- ... -->
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'secured_area' => array(
-            // ...
-            'logout' => array('path' => 'logout', 'target' => '/'),
-        ),
-    ),
-    // ...
-));
-
              -
              -
              • -
            -
            -

            Una vez lo hayas configurado en tu cortafuegos, enviar a un usuario a /logout (o cualquiera que sea tu path configurada), desautenticará al usuario actual. El usuario será enviado a la página de inicio (el valor definido por el parámetro target). Ambos parámetros path y target por omisión se configuran a lo que esté especificado aquí. En otras palabras, a menos que necesites personalizarlos, los puedes omitir por completo y abreviar tu configuración:

            -
            -
              -
            • YAML
              logout: ~
-
              -
              -
              • -
            • XML
              <logout />
-
              -
              -
              • -
            • PHP
              'logout' => array(),
-
              -
              -
              • -
            -
            -

            Ten en cuenta que no es necesario implementar un controlador para la URL /logout porque el cortafuegos se encarga de todo. Sin embargo, posiblemente necesites crear una ruta para que la puedas utilizar para generar la URL:

            -
            -

            Prudencia

            -

            A partir de Symfony 2.1 debes tener una ruta que corresponda a la ruta para cerrar la sesión. Sin esta ruta, el cierre de sesión no trabajará.

            -
            -
            -
              -
            • YAML
              # app/config/routing.yml
-logout:
-    path:   /logout
-
              -
              -
              • -
            • XML
              <!-- app/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="logout" path="/logout" />
-
-</routes>
-
              -
              -
              • -
            • PHP
              // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('logout', new Route('/logout', array()));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Una vez que el usuario ha cerrado la sesión, será redirigido a cualquier ruta definida por el parámetro target anterior (por ejemplo, la página principal). Para más información sobre cómo configurar el cierre de sesión, consulta la Referencia para afinar el sistema de seguridad.

            -
            -
            -

            Controlando el acceso en plantillas

            -

            Si dentro de una plantilla deseas comprobar si el usuario actual tiene un rol, utiliza la función ayudante incorporada:

            -
            -
              -
            • Twig
              {% if is_granted('ROLE_ADMIN') %}
-    <a href="...">Delete</a>
-{% endif %}
-
              -
              -
              • -
            • PHP
              <?php if ($view['security']->isGranted('ROLE_ADMIN')): ?>
-    <a href="...">Delete</a>
-<?php endif; ?>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Si utilizas esta función y no estás en una URL donde haya un cortafuegos activo, se lanzará una excepción. Una vez más, casi siempre es buena idea tener un cortafuegos principal que cubra todas las URL (como hemos mostrado en este capítulo).

            -
            -
            -
            -

            Controlando el acceso en controladores

            -

            Si deseas comprobar en tu controlador si el usuario actual tiene un rol, utiliza el método isGranted() del contexto de seguridad:

            -
            public function indexAction()
-{
-    // a los usuarios 'admin' les muestra diferente contenido
-    if ($this->get('security.context')->isGranted('ROLE_ADMIN')) {
-        // ... aquí carga el contenido 'admin'
-    }
-
-    // ... aquí carga otro contenido regular
-}
-
            -
            -
            -

            Nota

            -

            Debe haber un cortafuegos activo o al llamar al método isGranted se producirá una excepción. Ve la nota anterior acerca de las plantillas para más detalles.

            -
            -
            -
            -

            Suplantando a un usuario

            -

            A veces, es útil poder cambiar de un usuario a otro sin tener que iniciar sesión de nuevo (por ejemplo, cuando depuras o tratas de entender un error que un usuario ve y que no se puede reproducir). Esto se puede hacer fácilmente activando el escucha switch_user del cortafuegos:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    firewalls:
-        main:
-            # ...
-            switch_user: true
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <!-- ... -->
-        <switch-user />
-    </firewall>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main'=> array(
-            // ...
-            'switch_user' => true
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            Para cambiar a otro usuario, sólo tienes que añadir una cadena de consulta con el parámetro _switch_user y el nombre de usuario como el valor de la dirección actual:

            -
            http://ejemplo.com/somewhere?_switch_user=thomas
-
            -
            -

            Para volver al usuario original, utiliza el nombre de usuario especial _exit:

            -
            http://ejemplo.com/somewhere?_switch_user=_exit
-
            -
            -

            Durante la suplantación, el usuario está provisto con una función de rol especial -llamada ROLE_PREVIOUS_ADMIN. En una plantilla, por ejemplo, este rol se puede usar para mostrar un enlace para salir de la suplantación:

            -
            -
              -
            • Twig
              {% if is_granted('ROLE_PREVIOUS_ADMIN') %}
-    <a href="{{ path('homepage', {_switch_user: '_exit'}) }}">Exit impersonation</a>
-{% endif %}
              -
              -
              • -
            • PHP
              <?php if ($view['security']->isGranted('ROLE_PREVIOUS_ADMIN')): ?>
-    <a
-        href="<?php echo $view['router']->generate('homepage', array('_switch_user' => '_exit') ?>"
-    >
-        Exit impersonation
-    </a>
-<?php endif; ?>
-
              -
              -
              • -
            -
            -

            Por supuesto, esta función se debe poner a disposición de un pequeño grupo de usuarios. -De forma predeterminada, el acceso está restringido a usuarios que tienen el rol ROLE_ALLOWED_TO_SWITCH. El nombre de esta función se puede modificar a través de la configuración role. Para mayor seguridad, también puedes cambiar el nombre del parámetro de consulta a través de la configuración parameter:

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    firewalls:
-        main:
-            # ...
-            switch_user: { role: ROLE_ADMIN, parameter: _want_to_be_this_user }
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <!-- ... -->
-        <switch-user role="ROLE_ADMIN" parameter="_want_to_be_this_user" />
-    </firewall>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main'=> array(
-            // ...
-            'switch_user' => array('role' => 'ROLE_ADMIN', 'parameter' => '_want_to_be_this_user'),
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -
            -
            -

            Autenticación apátrida

            -

            De forma predeterminada, Symfony2 confía en una cookie (la Sesión) para persistir el contexto de seguridad del usuario. Pero si utilizas certificados o autenticación HTTP, por ejemplo, la persistencia no es necesaria ya que están disponibles las credenciales para cada petición. En ese caso, y si no es necesario almacenar cualquier otra cosa entre peticiones, puedes activar la autenticación apátrida (lo cual significa que Symfony2 jamás creará una cookie):

            -
            -
              -
            • YAML
              # app/config/security.yml
-security:
-    firewalls:
-        main:
-            http_basic: ~
-            stateless:  true
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <firewall stateless="true">
-        <http-basic />
-    </firewall>
-</config>
-
              -
              -
              • -
            • PHP
              // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main' => array('http_basic' => array(), 'stateless' => true),
-    ),
-));
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Si utilizas un formulario de acceso, Symfony2 creará una cookie, incluso si estableces stateless a true.

            -
            -
            -
            -

            Utilerías

            -

            -Nuevo en la versión 2.2: Las clases StringUtils y SecureRandom se añadieron en Symfony 2.2

            -

            El componente de seguridad de Symfony viene con una colección de agradables utilidades relacionadas con la seguridad. Estas utilidades las usa Symfony, pero también las deberías utilizar si quieres solucionar los problemas a que están destinadas.

            -
            -

            Comparando cadenas

            -

            El tiempo que tome comparar dos cadenas depende de sus diferencias. Este lo puede utilizar un atacante cuándo las dos cadenas representan una contraseña por ejemplo; Este se conoce como Ataque temporizado.

            -

            Internamente, al comparar dos contraseñas, Symfony utiliza un algoritmo de tiempo -constante; Puedes utilizar la misma estrategia en tu propio código gracias a la clase Symfony\Component\Security\Core\Util\StringUtils:

            -
            use Symfony\Component\Security\Core\Util\StringUtils;
-
-// ¿es igual la contraseña1 a la contraseña2?
-$bool = StringUtils::equals($password1, $password2);
-
            -
            -
            -
            -

            Generando aleatoriamente un número seguro

            -

            Siempre que necesites generar un número aleatorio seguro, te -animamos a utilizar la clase Symfony\Component\Security\Core\Util\SecureRandom de Symfony:

            -
            use Symfony\Component\Security\Core\Util\SecureRandom;
-
-$generator = new SecureRandom();
-$random = $generator->nextBytes(10);
-
            -
            -

            El método nextBytes() -regresa una cadena aleatoria compuesta del número de caracteres pasados como argumento (10 en el ejemplo anterior).

            -

            La clase SecureRandom trabaja mejor cuándo está instalado OpenSSL pero cuándo no -está disponible, recae en un algoritmo interno, el cual necesita un archivo de semilla -para trabajar correctamente. Sólo suministra un nombre de archivo para habilitarlo:

            -
            $generator = new SecureRandom('/alguna/ruta/para/guardar/la/semilla.txt');
-$random = $generator->nextBytes(10);
-
            -
            -
            -

            Nota

            -

            También puedes acceder a una instancia aleatoria segura directamente desde el contenedor de inyección de dependencias de Symfony; Su nombre es security.secure_random.

            -
            -
            -
            -
            -

            Palabras finales

            -

            La seguridad puede ser un tema profundo y complejo para resolverlo correctamente en tu aplicación. -Afortunadamente, el componente de seguridad de Symfony sigue un modelo de seguridad bien probado en torno a la autenticación y autorización. La autenticación, siempre sucede en primer lugar, está a cargo de un cortafuegos, cuyo trabajo es determinar la identidad del usuario a través de varios métodos diferentes (por ejemplo, la autenticación HTTP, formulario de acceso, etc.) En el recetario, encontrarás ejemplos de otros métodos para manejar la autenticación, incluyendo la manera de implementar una funcionalidad «recuérdame» por medio de cookie.

            -

            Una vez que un usuario se autentica, la capa de autorización puede determinar si el usuario debe tener acceso a un recurso específico. Por lo general, los roles se aplican a URL, clases o métodos y si el usuario actual no tiene ese rol, se le niega el acceso. La capa de autorización, sin embargo, es mucho más profunda, y sigue un sistema de «voto» para que varias partes puedan determinar si el usuario actual debe tener acceso a un determinado recurso. -Para saber más sobre este y otros temas busca en el recetario.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/service_container.html b/book/service_container.html deleted file mode 100644 index 2b11573..0000000 --- a/book/service_container.html +++ /dev/null @@ -1,806 +0,0 @@ - - - - - - - Contenedor de servicios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Contenedor de servicios

            -

            Una aplicación PHP moderna está llena de objetos. Un objeto te puede facilitar la entrega de mensajes de correo electrónico, mientras que otro te puede permitir mantener información en una base de datos. En tu aplicación, puedes crear un objeto que gestione tu inventario de productos, y otro objeto que procese los datos de una API de terceros. El punto es que una aplicación moderna hace muchas cosas y está organizada en muchos objetos que se encargan de cada tarea.

            -

            Este capítulo es sobre un objeto PHP especial en Symfony2 que te ayuda a crear instancias, organizar y recuperar los muchos objetos de tu aplicación. -Este objeto, llamado contenedor de servicios, te permitirá estandarizar y centralizar la forma en que se construyen los objetos en tu aplicación. El contenedor te facilita la vida, es superveloz, y enfatiza una arquitectura que promueve el código reutilizable y disociado. Y debido a que todas las clases de Symfony2 básicas usan el contenedor, aprenderás cómo ampliar, configurar y utilizar cualquier objeto en Symfony2. En gran parte, el contenedor de servicios es el mayor contribuyente a la velocidad y extensibilidad de Symfony2.

            -

            Por último, configurar y usar el contenedor de servicios es fácil. Al final de este capítulo, te sentirás cómodo creando tus propios objetos y personalizando objetos de cualquier paquete de terceros a través del contenedor. Empezarás a escribir código más reutilizable, comprobable y disociado, simplemente porque el contenedor de servicios facilita la escritura de buen código.

            -
            -

            Truco

            -

            Si quieres conocer un poco más después de leer este capítulo, revisa la Documentación del componente de inyección de dependencias.

            -
            -
            -

            ¿Qué es un servicio?

            -

            En pocas palabras, un Servicio es cualquier objeto PHP que realiza algún tipo de tarea «global». Es un nombre genérico que se utiliza a propósito en informática para describir un objeto creado para un propósito específico (por ejemplo, la entrega de mensajes de correo electrónico). Cada servicio se utiliza en toda tu aplicación cada vez que necesites la funcionalidad específica que proporciona. No tienes que hacer nada especial para hacer un servicio: simplemente escribe una clase PHP con algo de código que realice una tarea específica. ¡Felicidades, acabas de crear un servicio!

            -
            -

            Nota

            -

            Por regla general, un objeto PHP es un servicio si se utiliza a nivel global en tu aplicación. Utilizamos un solo servicio Mailer a nivel global para enviar mensajes de correo electrónico mientras que muchos objetos Mensaje que este entrega no son servicios. Del mismo modo, un objeto Producto no es un servicio, pero un objeto que persiste objetos Producto a una base de datos es un servicio.

            -
            -

            Entonces, ¿cuál es la ventaja? La ventaja de pensar en «servicios» es que comienzas a pensar en la separación de cada parte de la funcionalidad de tu aplicación como una serie de servicios. Puesto que cada servicio se limita a un trabajo, puedes acceder fácilmente a cada servicio y usar su funcionalidad siempre que la necesites. Cada servicio también se puede probar y configurar muy fácilmente, ya que está separado de la otra funcionalidad de tu aplicación. Esta idea se llama arquitectura orientada a servicios y no es única de Symfony2 e incluso de PHP. Estructurando tu aplicación en torno a un conjunto de clases Servicio independientes es una bien conocida y confiable práctica mejor orientada a objetos. Estas habilidades son clave para ser un buen desarrollador en casi cualquier lenguaje.

            -
            -
            -

            ¿Qué es un contenedor de servicios?

            -

            Un Contenedor de servicios (o contenedor de inyección de dependencias) simplemente es un objeto PHP que gestiona la creación de instancias de servicios (es decir, objetos).

            -

            Por ejemplo, supongamos que tienes una simple clase PHP que envía mensajes de correo electrónico. -Sin un contenedor de servicios, debes crear manualmente el objeto cada vez que lo necesites:

            -
            use Acme\HelloBundle\Mailer;
-
-$mailer = new Mailer('sendmail');
-$mailer->send('ryan@foobar.net', ...);
-
            -
            -

            Esto es bastante fácil. La clase imaginaria Mailer te permite configurar el método utilizado para entregar los mensajes de correo electrónico (por ejemplo, sendmail, smtp, etc.). -Pero, ¿si quisieras utilizar el servicio mailer en algún otro lugar? Desde luego, no quieres repetir la configuración del mailer cada vez que necesites utilizar el objeto Mailer. Qué pasa si necesitas cambiar el transporte de sendmail a smtp en toda tu aplicación? Tendrías que cazar cada sitio en que creas un servicio Mailer y cambiarlo.

            -
            -
            -

            Creando/configurando servicios en el contenedor

            -

            Una mejor respuesta es dejar que el contenedor de servicios cree el objeto Mailer para ti. Para que esto funcione, debes enseñar al contenedor cómo crear el servicio Mailer. Esto se hace a través de configuración, la cual se puede especificar en YAML, XML o PHP:

            -
            -
              -
            • YAML
              # app/config/config.yml
-services:
-    my_mailer:
-        class:        Acme\HelloBundle\Mailer
-        arguments:    [sendmail]
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-    <services>
-    <service id="my_mailer" class="Acme\HelloBundle\Mailer">
-        <argument>sendmail</argument>
-    </service>
-    </services>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container->setDefinition('my_mailer', new Definition(
-    'Acme\HelloBundle\Mailer',
-    array('sendmail')
-));
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Cuando se inicia, por omisión Symfony2 construye el contenedor de servicios usando la configuración de (app/config/config.yml). El archivo exacto que se carga es dictado por el método AppKernel::registerContainerConfiguration(), el cual carga un archivo de configuración específico al entorno (por ejemplo, config_dev.yml para el entorno dev o config_prod.yml para prod).

            -
            -

            Una instancia del objeto Acme\HelloBundle\Mailer ahora está disponible a través del contenedor de servicios. El contenedor está disponible en cualquier controlador tradicional de Symfony2, donde puedes acceder al servicio del contenedor a través del método get():

            -
            class HelloController extends Controller
-{
-    // ...
-
-    public function sendEmailAction()
-    {
-        // ...
-        $mailer = $this->get('my_mailer');
-        $mailer->send('ryan@foobar.net', ...);
-    }
-}
-
            -
            -

            Cuando solicites el servicio my_mailer desde el contenedor, el contenedor construye el objeto y te lo devuelve. Esta es otra de las principales ventajas de utilizar el contenedor de servicios. Es decir, un servicio nunca se construye hasta que es necesario. Si defines un servicio y no lo utilizas en una petición, el servicio no se crea. Esto ahorra memoria y aumenta la velocidad de tu aplicación. -Esto también significa que la sanción en rendimiento por definir muchos servicios es mínima o inexistente. Los servicios que nunca se usan nunca se construyen.

            -

            Como bono adicional, el servicio Mailer se crea sólo una vez y esa misma instancia se vuelve a utilizar cada vez que solicites el servicio. Este es el comportamiento que —casi siempre— necesitarás (el cual es más flexible y potente), pero, más adelante aprenderás cómo puedes configurar un servicio que tiene varias instancias en el artículo «Cómo trabajar con ámbitos» del recetario.

            -
            -
            -

            Parámetros del servicio

            -

            La creación de nuevos servicios (es decir, objetos) a través del contenedor es bastante sencilla. Los parámetros provocan que al definir los servicios estén más organizados y sean más flexibles:

            -
            -
              -
            • YAML
              # app/config/config.yml
-parameters:
-    my_mailer.class:      Acme\HelloBundle\Mailer
-    my_mailer.transport:  sendmail
-
-services:
-    my_mailer:
-        class:        "%my_mailer.class%"
-        arguments:    ["%my_mailer.transport%"]
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<parameters>
-    <parameter key="my_mailer.class">Acme\HelloBundle\Mailer</parameter>
-    <parameter key="my_mailer.transport">sendmail</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" class="%my_mailer.class%">
-        <argument>%my_mailer.transport%</argument>
-    </service>
-    </services>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container->setParameter('my_mailer.class', 'Acme\HelloBundle\Mailer');
-$container->setParameter('my_mailer.transport', 'sendmail');
-
-$container->setDefinition('my_mailer', new Definition(
-    '%my_mailer.class%',
-    array('%my_mailer.transport%')
-));
-
              -
              -
              • -
            -
            -

            El resultado final es exactamente el mismo que antes —la diferencia sólo está en cómo defines el servicio—. Al rodear las cadenas my_mailer.class y my_mailer.transport entre signos de porcentaje (%), el contenedor sabe que tiene que buscar los parámetros con esos nombres. Cuando se construye el contenedor, este busca el valor de cada parámetro y lo utiliza en la definición del servicio.

            -

            -Nuevo en la versión 2.1: Escapar el carácter @ en los valores de parámetros YAML es nuevo en Symfony 2.1.9 y Symfony 2.2.1.

            -
            -

            Nota

            -

            Si quieres utilizar una cadena que comience con un signo de @ como valor del parámetro (es decir, una muy segura contraseña de correo) en un archivo yaml, necesitas escaparlo añadiendo otra @ (Esto sólo aplica al formato YAML):

            -
            # app/config/parameters.yml
-parameters:
-    # Esto será analizado como la cadena "@clavesegura"
-    mailer_password: "@@clavesegura"
-
            -
            -
            -
            -

            Nota

            -

            El signo de porcentaje en un parámetro o argumento, como parte de la cadena, se debe escapar con otro signo de porcentaje:

            -
            <argument type="string">http://symfony.com/?foo=%%s&bar=%%d</argument>
            -
            -
            -
            -

            Prudencia

            -

            Puedes recibir una Symfony\Component\DependencyInjection\Exception\ScopeWideningInjectionException al pasar el servicio request como argumento. Para entender este mejor problema y aprender cómo solucionarlo, consulta el artículo Cómo trabajar con ámbitos en el recetario.

            -
            -

            El propósito de los parámetros es alimentar información a los servicios. Por supuesto, no hay nada malo en definir el servicio sin utilizar ningún parámetro. -Los parámetros, sin embargo, tienen varias ventajas:

            -
              -
            • Separan y organizan todo el servicio en «opciones» bajo una sola clave parameters;
              • -
            • Los valores del parámetro se pueden utilizar en la definición de múltiples servicios;
              • -
            • Cuando creas un servicio en un paquete (mostrado en breve), el uso de parámetros facilita la personalización del servicio en tu aplicación.
              • -
            -

            La opción de usar o no parámetros depende de ti. Los paquetes de terceros de alta calidad siempre usan parámetros, ya que producen servicios más configurables almacenados en el contenedor. Para los servicios de tu aplicación, sin embargo, posiblemente no necesites la flexibilidad de los parámetros.

            -
            -

            Arreglo de parámetros

            -

            Los parámetros también pueden contener arreglos como valores. Ve Array Parameters.

            -
            -
            -
            -

            Importando la configuración de recursos desde otros contenedores

            -
            -

            Truco

            -

            En esta sección, nos referiremos a los archivos de configuración de servicios como recursos. -Esto es para resaltar el hecho de que, si bien la mayoría de la configuración de recursos debe estar en archivos (por ejemplo, YAML, XML, PHP), Symfony2 es tan flexible que la configuración se puede cargar desde cualquier lugar (por ejemplo, una base de datos e incluso a través de un servicio web externo).

            -
            -

            El contenedor de servicios se construye usando un recurso de configuración simple (app/config/config.yml por omisión). Toda la configuración de otros servicios (incluido el núcleo de Symfony2 y la configuración de paquetes de terceros) se debe importar desde el interior de este archivo de una u otra manera. Esto proporciona absoluta flexibilidad sobre los servicios en tu aplicación.

            -

            La configuración externa de servicios se puede importar de dos diferentes maneras. La primera — y el método más común— es vía la directiva imports. Más tarde, veremos el segundo método, el cual es el método más flexible y preferido -para importar la configuración de servicios desde paquetes de terceros.

            -
            -

            Importando configuración con imports

            -

            Hasta ahora, has puesto tu definición del contenedor del servicios my_mailer directamente en el archivo de configuración de la aplicación (por ejemplo, app/config/config.yml). Por supuesto, debido a que la clase Mailer vive dentro de AcmeHelloBundle, también tiene más sentido poner la definición del contenedor de my_mailer en el paquete.

            -

            En primer lugar, mueve la definición del contenedor de my_mailer a un nuevo archivo contenedor de recursos dentro de AcmeHelloBundle. Si los directorios Resources y Resources/config no existen, créalos.

            -
            -
              -
            • YAML
              # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    my_mailer.class:      Acme\HelloBundle\Mailer
-    my_mailer.transport:  sendmail
-
-services:
-    my_mailer:
-        class:        "%my_mailer.class%"
-        arguments:    ["%my_mailer.transport%"]
-
              -
              -
              • -
            • XML
              <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <parameter key="my_mailer.class">Acme\HelloBundle\Mailer</parameter>
-    <parameter key="my_mailer.transport">sendmail</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" class="%my_mailer.class%">
-        <argument>%my_mailer.transport%</argument>
-    </service>
-    </services>
-
              -
              -
              • -
            • PHP
              // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container->setParameter('my_mailer.class', 'Acme\HelloBundle\Mailer');
-$container->setParameter('my_mailer.transport', 'sendmail');
-
-$container->setDefinition('my_mailer', new Definition(
-    '%my_mailer.class%',
-    array('%my_mailer.transport%')
-));
-
              -
              -
              • -
            -
            -

            La propia definición no ha cambiado, sólo su ubicación. Por supuesto, el contenedor de servicios no sabe sobre el nuevo archivo de recursos. Afortunadamente, es fácil importar el archivo de recursos utilizando la clave imports en la configuración de la aplicación.

            -
            -
              -
            • YAML
              # app/config/config.yml
-imports:
-    - { resource: "@AcmeHelloBundle/Resources/config/services.yml" }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<imports>
-    <import resource="@AcmeHelloBundle/Resources/config/services.xml"/>
-</imports>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$this->import('@AcmeHelloBundle/Resources/config/services.php');
-
              -
              -
              • -
            -
            -

            La directiva imports permite a tu aplicación incluir recursos de configuración del contenedor de servicios desde cualquier otro lugar (comúnmente desde paquetes). -La ubicación de resources, para archivos, es la ruta absoluta al archivo de recursos. La sintaxis especial @AcmeHello resuelve la ruta al directorio del paquete AcmeHelloBundle. Esto te ayuda a especificar la ruta a los recursos sin tener que preocuparte más adelante de si se mueve el AcmeHelloBundle a un directorio diferente.

            -
            -
            -

            Importando configuración vía el contenedor de extensiones

            -

            Cuando desarrollas en Symfony2, comúnmente debes usar la directiva imports para importar la configuración del contenedor desde los paquetes que has creado específicamente para tu aplicación. La configuración del contenedor de paquetes de terceros, incluyendo los servicios básicos de Symfony2, normalmente se carga con cualquier otro método que sea más flexible y fácil de configurar en tu aplicación.

            -

            Así es como funciona. Internamente, cada paquete define sus servicios de manera muy parecida a lo que has visto hasta ahora. Es decir, un paquete utiliza uno o más archivos de configuración de recursos (por lo general XML) para especificar los parámetros y servicios para ese paquete. Sin embargo, en lugar de importar cada uno de estos recursos directamente desde la configuración de tu aplicación utilizando la directiva imports, sólo tienes que invocar una extensión contenedora de servicios dentro del paquete, la cual hace el trabajo por ti. Una extensión del contenedor de servicios es una clase PHP creada por el autor del paquete para lograr dos cosas:

            -
              -
            • Importar todos los recursos del contenedor de servicios necesarios para configurar los servicios del paquete;
              • -
            • Permitir una configuración semántica y directa para poder ajustar el paquete sin interactuar con los parámetros planos de configuración del paquete contenedor del servicio.
              • -
            -

            En otras palabras, una extensión del contenedor de servicios configura los servicios para un paquete en tu nombre. Y como veremos en un momento, la extensión proporciona una interfaz sensible y de alto nivel para configurar el paquete.

            -

            Tomemos el FrameworkBundle —el núcleo de la plataforma Symfony2— como ejemplo. La presencia del siguiente código en la configuración de tu aplicación invoca a la extensión FrameworkBundle en el interior del contenedor de servicios:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    secret:          xxxxxxxxxx
-    form:            true
-    csrf_protection: true
-    router:        { resource: "%kernel.root_dir%/config/routing.yml" }
-    # ...
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config secret="xxxxxxxxxx">
-    <framework:form />
-    <framework:csrf-protection />
-    <framework:router resource="%kernel.root_dir%/config/routing.xml" />
-    <!-- ... -->
-</framework>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    'secret'          => 'xxxxxxxxxx',
-    'form'            => array(),
-    'csrf-protection' => array(),
-    'router'          => array('resource' => '%kernel.root_dir%/config/routing.php'),
-
-    // ...
-));
-
              -
              -
              • -
            -
            -

            Cuando se analiza la configuración, el contenedor busca una extensión que pueda manejar la directiva de configuración framework. La extensión en cuestión, que vive en el FrameworkBundle, es invocada y cargada la configuración del servicio para el FrameworkBundle. Si quitas por completo la clave framework del archivo de configuración de tu aplicación, no se cargarán los servicios básicos de Symfony2. El punto es que tú tienes el control: la plataforma Symfony2 no contiene ningún tipo de magia ni realiza alguna acción en que tú no tengas el control.

            -

            Por supuesto, puedes hacer mucho más sencilla la «activación» de la extensión FrameworkBundle en el contenedor de servicios. Cada extensión te permite personalizar fácilmente el paquete, sin tener que preocuparte acerca de cómo se definen los servicios internos.

            -

            En este caso, la extensión te permite personalizar la configuración de error_handler, csrf_protection, router y mucho más. Internamente, el FrameworkBundle utiliza las opciones especificadas aquí para definir y configurar los servicios específicos del mismo. El paquete se encarga de crear todos los parámetros y servicios necesarios para el contenedor de servicios, mientras permite que la mayor parte de la configuración se pueda personalizar fácilmente. Como bono adicional, la mayoría de las extensiones del contenedor de servicios también son lo suficientemente inteligentes como para realizar la validación —notificándote opciones omitidas o datos de tipo incorrecto.

            -

            Al instalar o configurar un paquete, consulta la documentación del paquete sobre cómo se deben instalar y configurar sus servicios. Las opciones disponibles para los paquetes básicos se pueden encontrar dentro de la Guía de Referencia.

            -
            -

            Nota

            -

            Nativamente, el contenedor de servicios sólo reconoce las directivas parameters, services e imports. Cualquier otra directiva es manejada por una extensión del contenedor de servicios.

            -
            -

            Si quieres exponer la configuración fácil en tus propios paquetes, lee -«Cómo exponer la configuración semántica de un paquete» del recetario.

            -
            -
            -
            -

            Refiriendo (inyectando) servicios

            -

            Hasta el momento, nuestro servicio original my_mailer es simple: sólo toma un argumento en su constructor, el cual es fácilmente configurable. Como verás, el poder real del contenedor se lleva a cabo cuando es necesario crear un servicio que depende de uno o varios otros servicios en el contenedor.

            -

            Por ejemplo, supongamos que tienes un nuevo servicio, NewsletterManager, que ayuda a gestionar la preparación y entrega de un mensaje de correo electrónico a una colección de direcciones. Por supuesto el servicio my_mailer ciertamente ya es bueno en la entrega de mensajes de correo electrónico, así que lo usaremos dentro de NewsletterManager para manejar la entrega real de los mensajes. Se pretende que esta clase pudiera ser algo como esto:

            -
            // src/Acme/HelloBundle/Newsletter/NewsletterManager.php
-namespace Acme\HelloBundle\Newsletter;
-
-use Acme\HelloBundle\Mailer;
-
-class NewsletterManager
-{
-    protected $mailer;
-
-    public function __construct(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
            -
            -

            Sin utilizar el contenedor de servicios, podemos crear un nuevo NewsletterManager muy fácilmente desde el interior de un controlador:

            -
            use Acme\HelloBundle\Newsletter\NewsletterManager;
-
-// ...
-
-public function sendNewsletterAction()
-{
-    $mailer = $this->get('my_mailer');
-    $newsletter = new NewsletterManager($mailer);
-    // ...
-}
-
            -
            -

            Este enfoque está bien, pero, ¿si más adelante decides que la clase NewsletterManager necesita un segundo o tercer argumento constructor? ¿Y si decides reconstruir tu código y cambiar el nombre de la clase? En ambos casos, habría que encontrar todos los lugares donde se crea una instancia de NewsletterManager y modificarla. Por supuesto, el contenedor de servicios te da una opción mucho más atractiva:

            -
            -
              -
            • YAML
              # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager
-
-services:
-    my_mailer:
-        # ...
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        arguments: ["@my_mailer"]
              -
              -
              • -
            • XML
              <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Newsletter\NewsletterManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ...>
-      <!-- ... -->
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%">
-        <argument type="service" id="my_mailer"/>
-    </service>
-    </services>
              -
              -
              • -
            • PHP
              // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter(
-    'newsletter_manager.class',
-    'Acme\HelloBundle\Newsletter\NewsletterManager'
-);
-
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%',
-    array(new Reference('my_mailer'))
-));
-
              -
              -
              • -
            -
            -

            En YAML, la sintaxis especial @my_mailer le dice al contenedor que busque un servicio llamado my_mailer y pase ese objeto al constructor de NewsletterManager. En este caso, sin embargo, el servicio especificado my_mailer debe existir. Si no es así, lanzará una excepción. Puedes marcar tus dependencias como opcionales — explicaremos esto en la siguiente sección.

            -

            La utilización de referencias es una herramienta muy poderosa que te permite crear clases de servicios independientes con dependencias bien definidas. En este ejemplo, el servicio newsletter_manager necesita del servicio my_mailer para poder funcionar. Al definir esta dependencia en el contenedor de servicios, el contenedor se encarga de todo el trabajo de crear instancias de objetos.

            -
            -

            Dependencias opcionales: Inyección del definidor

            -

            Inyectar dependencias en el constructor de esta manera es una excelente manera de asegurarte que la dependencia está disponible para usarla. Si tienes dependencias opcionales para una clase, entonces, la «inyección del definidor» puede ser una mejor opción. Esto significa inyectar la dependencia usando una llamada a método en lugar de a través del constructor. La clase se vería así:

            -
            namespace Acme\HelloBundle\Newsletter;
-
-use Acme\HelloBundle\Mailer;
-
-class NewsletterManager
-{
-    protected $mailer;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
            -
            -

            La inyección de la dependencia por medio del método definidor sólo necesita un cambio de sintaxis:

            -
            -
              -
            • YAML
              # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager
-
-services:
-    my_mailer:
-        # ...
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        calls:
-            - [setMailer, ["@my_mailer"]]
              -
              -
              • -
            • XML
              <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Newsletter\NewsletterManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ...>
-      <!-- ... -->
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-    </service>
-    </services>
              -
              -
              • -
            • PHP
              // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter(
-    'newsletter_manager.class',
-    'Acme\HelloBundle\Newsletter\NewsletterManager'
-);
-
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%'
-))->addMethodCall('setMailer', array(
-    new Reference('my_mailer'),
-));
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Los enfoques presentados en esta sección se llaman «inyección de constructor» e «inyección de definidor». El contenedor de servicios de Symfony2 también es compatible con la «inyección de propiedad».

            -
            -
            -
            -
            -

            Haciendo que las referencias sean opcionales

            -

            A veces, uno de tus servicios puede tener una dependencia opcional, lo cual significa que la dependencia no es necesaria para que el servicio funcione correctamente. En el ejemplo anterior, el servicio my_mailer debe existir, si no, será lanzada una excepción. Al modificar la definición del servicio newsletter_manager, puedes hacer opcional esta referencia. Entonces, el contenedor será inyectado si es que existe y no hace nada si no:

            -
            -
              -
            • YAML
              # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-
-services:
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        arguments: ["@?my_mailer"]
              -
              -
              • -
            • XML
              <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-
-    <services>
-    <service id="my_mailer" ...>
-      <!-- ... -->
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%">
-        <argument type="service" id="my_mailer" on-invalid="ignore" />
-    </service>
-    </services>
              -
              -
              • -
            • PHP
              // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-
-// ...
-$container->setParameter(
-    'newsletter_manager.class',
-    'Acme\HelloBundle\Newsletter\NewsletterManager'
-);
-
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%',
-    array(
-        new Reference(
-            'my_mailer',
-            ContainerInterface::IGNORE_ON_INVALID_REFERENCE
-        )
-    )
-));
-
              -
              -
              • -
            -
            -

            En YAML, la sintaxis especial @? le dice al contenedor de servicios que la dependencia es opcional. Por supuesto, también debes escribir NewsletterManager para que permita una dependencia opcional:

            -
            public function __construct(Mailer $mailer = null)
-{
-    // ...
-}
-
            -
            -
            -
            -

            El núcleo de Symfony y servicios en paquetes de terceros

            -

            Puesto que Symfony2 y todos los paquetes de terceros configuran y recuperan sus servicios a través del contenedor, puedes acceder fácilmente a ellos e incluso utilizarlos en tus propios servicios. Para mantener las cosas simples, de manera predeterminada Symfony2 no requiere que los controladores se definan como servicios. Además Symfony2 inyecta el contenedor de servicios completo en el controlador. Por ejemplo, para manejar el almacenamiento de información sobre la sesión de un usuario, Symfony2 proporciona un servicio sesión, al cual se puede acceder dentro de un controlador estándar de la siguiente manera:

            -
            public function indexAction($bar)
-{
-    $session = $this->get('session');
-    $session->set('foo', $bar);
-
-    // ...
-}
-
            -
            -

            En Symfony2, constantemente vas a utilizar los servicios prestados por el núcleo de Symfony o paquetes de terceros para realizar tareas como la reproducción de plantillas (templating), el envío de mensajes de correo electrónico (mailer), o para acceder a información sobre la petición.

            -

            Puedes dar un paso más allá usando estos servicios dentro de los servicios que has creado para tu aplicación. Empieza modificando el NewsletterManager para usar el gestor de correo real de Symfony2, el servicio mailer (en vez del pretendido my_mailer). -También vamos a pasar el servicio del motor de plantillas al NewsletterManager para que puedas generar el contenido del correo electrónico a través de una plantilla:

            -
            namespace Acme\HelloBundle\Newsletter;
-
-use Symfony\Component\Templating\EngineInterface;
-
-class NewsletterManager
-{
-    protected $mailer;
-
-    protected $templating;
-
-    public function __construct(\Swift_Mailer $mailer, EngineInterface $templating)
-    {
-        $this->mailer = $mailer;
-        $this->templating = $templating;
-    }
-
-    // ...
-}
-
            -
            -

            Configurar el contenedor de servicios es fácil:

            -
            -
              -
            • YAML
              services:
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        arguments: ["@mailer", "@templating"]
              -
              -
              • -
            • XML
              <service id="newsletter_manager" class="%newsletter_manager.class%">
-    <argument type="service" id="mailer"/>
-    <argument type="service" id="templating"/>
-</service>
-
              -
              -
              • -
            • PHP
              $container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%',
-    array(
-        new Reference('mailer'),
-        new Reference('templating'),
-    )
-));
-
              -
              -
              • -
            -
            -

            El servicio newsletter_manager ahora tiene acceso a los servicios del núcleo mailer y templating. Esta es una forma común de crear servicios específicos para tu aplicación que aprovechan el poder de los distintos servicios en la plataforma.

            -
            -

            Truco

            -

            Asegúrate que la clave swiftmailer aparece en la configuración de tu aplicación. Como se mencionó en Importando configuración vía el contenedor de extensiones, la clave SwiftMailer invoca a la extensión de servicio desde el SwiftmailerBundle, el cual registra el servicio mailer.

            -
            -
            -
            -

            Etiquetas

            -

            De la misma manera que en la Web una entrada de blog se puede etiquetar con cosas tales como «Symfony» o «PHP», los servicios configurados en el contenedor también se pueden etiquetar. En el contenedor de servicios, una etiqueta implica que el servicio está destinado a usarse para un propósito específico. Tomemos el siguiente ejemplo:

            -
            -
              -
            • YAML
              services:
-    foo.twig.extension:
-        class: Acme\HelloBundle\Extension\FooExtension
-        tags:
-            -  { name: twig.extension }
-
              -
              -
              • -
            • XML
              <service id="foo.twig.extension" class="Acme\HelloBundle\Extension\FooExtension">
-    <tag name="twig.extension" />
-</service>
-
              -
              -
              • -
            • PHP
              $definition = new Definition('Acme\HelloBundle\Extension\FooExtension');
-$definition->addTag('twig.extension');
-$container->setDefinition('foo.twig.extension', $definition);
-
              -
              -
              • -
            -
            -

            La etiqueta twig.extension es una etiqueta especial que TwigBundle usa -durante la configuración. Al dar al servicio esta etiqueta twig.extension, el paquete sabe que el servicio foo.twig.extension se debe registrar como una extensión Twig con Twig. En otras palabras, Twig encuentra todos los servicios con la etiqueta twig.extension y automáticamente los registra como extensiones.

            -

            Las etiquetas, entonces, son una manera de decirle a Symfony2 u otros paquetes de terceros que el paquete se debe registrar o utilizar de alguna forma especial.

            -

            La siguiente es una lista de etiquetas disponibles con los paquetes del núcleo de Symfony2. -Cada una de ellas tiene un efecto diferente en tu servicio y muchas etiquetas requieren argumentos adicionales (más allá de sólo el parámetro name).

            -

            Para una lista de todas las etiquetas disponibles en el núcleo de la plataforma Symfony, revisa las Etiquetas de inyección de dependencias.

            -
            -
            -

            Depurando servicios

            -

            Puedes descubrir los servicios que están registrados con el contenedor utilizando la consola. Para mostrar todos los servicios y la clase de cada servicio, ejecuta:

            -
            $ php app/console container:debug
-
            -
            -

            De manera predefinida únicamente se muestran los servicios públicos, pero también puedes ver servicios privados:

            -
            $ php app/console container:debug --show-private
-
            -
            -

            Puedes conseguir información más detallada sobre un servicio particular especificando su id:

            -
            $ php app/console container:debug my_mailer
-
            -
            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/stable_api.html b/book/stable_api.html deleted file mode 100644 index 195944d..0000000 --- a/book/stable_api.html +++ /dev/null @@ -1,164 +0,0 @@ - - - - - - - API estable de Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            API estable de Symfony2

            -

            La API estable de Symfony2 es un subconjunto de todos los métodos públicos de Symfony2 (componentes y paquetes básicos) que comparten las siguientes propiedades:

            -
              -
            • El espacio de nombres y nombre de la clase no van a cambiar;
              • -
            • El nombre del método no va a cambiar;
              • -
            • La firma del método (el tipo de los argumentos y del valor de retorno) no va a cambiar;
              • -
            • La semántica de lo que hace el método no va a cambiar.
              • -
            -

            Sin embargo, la imprementación en sí misma puede cambiar. El único caso válido para un cambio en la API estable es con el fin de corregir algún problema de seguridad.

            -

            La API estable se basa en una lista blanca, marcada con @api. Por lo tanto, todo lo no etiquetado explícitamente no es parte de la API estable.

            -
            -

            Truco

            -

            Cualquier paquete de terceros también deberá publicar su propia API estable.

            -
            -

            A partir de Symfony 2.0, los siguientes componentes tienen una API etiquetada pública:

            -
              -
            • BrowserKit
              • -
            • ClassLoader
              • -
            • Console
              • -
            • CssSelector
              • -
            • DependencyInjection
              • -
            • DomCrawler
              • -
            • EventDispatcher
              • -
            • Finder
              • -
            • HttpFoundation
              • -
            • HttpKernel
              • -
            • Locale
              • -
            • Process
              • -
            • Routing
              • -
            • Templating
              • -
            • Translation
              • -
            • Validator
              • -
            • Yaml
              • -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/templating.html b/book/templating.html deleted file mode 100644 index 54cebc0..0000000 --- a/book/templating.html +++ /dev/null @@ -1,1250 +0,0 @@ - - - - - - - Creando y usando plantillas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Creando y usando plantillas

            -

            Como sabes, el Controlador es responsable de manejar cada petición entrante en una aplicación Symfony2. En realidad, el controlador delega la mayor parte del trabajo pesado ​​a otros lugares para que el código se pueda probar y volver a utilizar. Cuando un controlador necesita generar HTML, CSS o cualquier otro contenido, que maneje el trabajo fuera del motor de plantillas. -En este capítulo, aprenderás cómo escribir potentes plantillas que puedes utilizar para devolver contenido al usuario, rellenar el cuerpo de correo electrónico y mucho más. Aprenderás métodos abreviados, formas inteligentes para extender las plantillas y cómo reutilizar código de plantilla.

            -
            -

            Nota

            -

            El tema de cómo reproducir plantillas se aborda en la página controlador del libro.

            -
            -
            -

            Plantillas

            -

            Una plantilla simplemente es un archivo de texto que puede generar cualquier formato basado en texto (HTML, XML, CSV, LaTeX...). El tipo de plantilla más familiar es una plantilla PHP — un archivo de texto interpretado por PHP que contiene una mezcla de texto y código PHP:

            -
            <!DOCTYPE html>
-    <html>
-        <head>
-        <title>Welcome to Symfony!</title>
-        </head>
-        <body>
-        <h1><?php echo $page_title ?></h1>
-
-        <ul id="navigation">
-            <?php foreach ($navigation as $item): ?>
-                <li>
-                    <a href="<?php echo $item->getHref() ?>">
-                        <?php echo $item->getCaption() ?>
-                        </a>
-                </li>
-            <?php endforeach; ?>
-        </ul>
-    </body>
-</html>
-
            -
            -

            Pero Symfony2 contiene un lenguaje de plantillas aún más potente llamado Twig. -Twig te permite escribir plantillas concisas y fáciles de leer que son más amigables para los diseñadores web y, de varias maneras, más poderosas que las plantillas PHP:

            -
            <!DOCTYPE html>
-    <html>
-        <head>
-        <title>Welcome to Symfony!</title>
-        </head>
-        <body>
-        <h1>{{ page_title }}</h1>
-
-        <ul id="navigation">
-            {% for item in navigation %}
-                <li><a href="{{ item.href }}">{{ item.caption }}</a></li>
-            {% endfor %}
-        </ul>
-    </body>
-</html>
-
            -
            -

            Twig define dos tipos de sintaxis especial:

            -
              -
            • {{ ... }}: «Dice algo»: imprime una variable o el resultado de una expresión a la plantilla;
              • -
            • {% ... %}: «Hace algo»: una etiqueta que controla la lógica de la plantilla; se utiliza para declaraciones if y ejecutar bucles for, por ejemplo.
              • -
            -
            -

            Nota

            -

            Hay una tercer sintaxis utilizada para crear comentarios: {# esto es un comentario #}. -Esta sintaxis se puede utilizar en múltiples líneas como la sintaxis /* comentario */ equivalente de PHP.

            -
            -

            Twig también contiene filtros, los cuales modifican el contenido antes de reproducirlo. -El siguiente fragmento convierte a mayúsculas la variable title antes de reproducirla:

            -
            {{ title|upper }}
-
            -
            -

            Twig viene con una larga lista de etiquetas y filtros que están disponibles de forma predeterminada. Incluso puedes agregar tus propias extensiones a Twig, según sea necesario.

            -
            -

            Truco

            -

            Registrar una extensión Twig es tan fácil como crear un nuevo servicio y etiquetarlo con twig.extension.

            -
            -

            Como verás a través de la documentación, Twig también es compatible con funciones y fácilmente puedes añadir nuevas. Por ejemplo, la siguiente función, utiliza una etiqueta for estándar y la función cycle para imprimir diez etiquetas div, alternando entre clases par e impar:

            -
            {% for i in 0..10 %}
-    <div class="{{ cycle(['odd', 'even'], i) }}">
-      <!-- some HTML here -->
-    </div>
-{% endfor %}
-
            -
            -

            A lo largo de este capítulo, mostraremos las plantillas de ejemplo en ambos formatos Twig y PHP.

            -
            -

            Truco

            -

            Si decides no utilizar Twig y lo desactivas, tendrás que implementar tu propio controlador de excepciones a través del evento kernel.exception.

            -
            -
            -

            ¿Porqué Twig?

            -

            Las plantillas Twig están destinadas a ser simples y no procesar etiquetas PHP. Esto es por diseño: el sistema de plantillas Twig está destinado a expresar la presentación, no la lógica del programa. Cuanto más utilices Twig, más apreciarás y te beneficiarás de esta distinción. Y, por supuesto, todos los diseñadores web las amarán.

            -

            Twig también puede hacer cosas que PHP no puede, como controlar el espacio en blanco, cuenta con un recinto de seguridad, escape de salida automático y contextual e incluye funciones personalizadas y filtros que sólo afectan a las plantillas. Twig contiene pequeñas características que facilitan la escritura de plantillas y estas son más concisas. Tomemos el siguiente ejemplo, el cual combina un bucle con una declaración if lógica:

            -
            <ul>
-    {% for user in users if user.active %}
-        <li>{{ user.username }}</li>
-    {% else %}
-        <li>No users found</li>
-    {% endfor %}
-</ul>
-
            -
            -
            -
            -

            Guardando en caché plantillas Twig

            -

            Twig es rápido. Cada plantilla Twig se compila hasta una clase PHP nativa que se reproduce en tiempo de ejecución. Las clases compiladas se encuentran en el directorio app/cache/{entorno}/twig (donde {entorno} es el entorno, tal como dev o prod) y, en algunos casos, pueden ser útiles mientras depuras. Consulta la sección Entornos para más información sobre los entornos.

            -

            Cuando está habilitado el modo debug (comúnmente en el entorno dev) al realizar cambios a una plantilla Twig, esta se vuelve a compilar automáticamente. Esto significa que durante el desarrollo, felizmente, puedes realizar cambios en una plantilla Twig e inmediatamente ver las modificaciones sin tener que preocuparte de limpiar ninguna caché.

            -

            Cuando el modo debug está desactivado (comúnmente en el entorno prod), sin embargo, debes borrar el directorio de caché para regenerar las plantillas. Recuerda hacer esto al desplegar tu aplicación.

            -
            -
            -
            -

            Plantillas, herencia y diseño

            -

            A menudo, las plantillas en un proyecto comparten elementos comunes, como el encabezado, pie de página, barra lateral o más. En Symfony2, nos gusta pensar en este problema de forma diferente: una plantilla se puede decorar con otra. Esto funciona exactamente igual que las clases PHP: la herencia de plantillas nos permite crear un «diseño» de plantilla base que contiene todos los elementos comunes de tu sitio definidos como bloques (piensa en «clases PHP con métodos base»). Una plantilla hija puede extender el diseño base y reemplazar cualquiera de sus bloques (piensa en las «subclases PHP que sustituyen determinados métodos de su clase padre»).

            -

            En primer lugar, crea un archivo con tu diseño base:

            -
            -
              -
            • Twig
              {# app/Resources/views/base.html.twig #}
-<!DOCTYPE html>
-    <html>
-        <head>
-        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-        <title>{% block title %}Test Application{% endblock %}</title>
-        </head>
-        <body>
-        <div id="sidebar">
-            {% block sidebar %}
-            <ul>
-                <li><a href="/">Home</a></li>
-                <li><a href="/blog">Blog</a></li>
-            </ul>
-            {% endblock %}
-        </div>
-
-        <div id="contenido">
-            {% block body %}{% endblock %}
-        </div>
-    </body>
-</html>
-
              -
              -
              • -
            • PHP
              <!-- app/Resources/views/base.html.php -->
-<!DOCTYPE html>
-    <html>
-        <head>
-        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-        <title><?php $view['slots']->output('title', 'Test Application') ?></title>
-        </head>
-        <body>
-        <div id="sidebar">
-            <?php if ($view['slots']->has('sidebar')): ?>
-                <?php $view['slots']->output('sidebar') ?>
-            <?php else: ?>
-                <ul>
-                    <li><a href="/">Home</a></li>
-                    <li><a href="/blog">Blog</a></li>
-                </ul>
-            <?php endif; ?>
-        </div>
-
-        <div id="contenido">
-            <?php $view['slots']->output('body') ?>
-        </div>
-    </body>
-</html>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Aunque la explicación sobre la herencia de plantillas será en términos de Twig, la filosofía es la misma entre plantillas Twig y PHP.

            -
            -

            Esta plantilla define el esqueleto del documento HTML base de una simple página de dos columnas. En este ejemplo, se definen tres áreas {% block %} (title, sidebar y body). Una plantilla hija puede sustituir cada uno de los bloques o dejarlos con su implementación predeterminada. Esta plantilla también se podría reproducir directamente. En este caso, los bloques title, sidebar y body simplemente mantienen los valores predeterminados usados en esta plantilla.

            -

            Una plantilla hija podría tener este aspecto:

            -
            -
              -
            • Twig
              {# src/Acme/BlogBundle/Resources/views/Blog/index.html.twig #}
-{% extends '::base.html.twig' %}
-
-{% block title %}My cool blog posts{% endblock %}
-
-{% block body %}
-    {% for entry in blog_entries %}
-        <h2>{{ entry.title }}</h2>
-        <p>{{ entry.body }}</p>
-    {% endfor %}
-{% endblock %}
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/BlogBundle/Resources/views/Blog/index.html.php -->
-<?php $view->extend('::base.html.php') ?>
-
-<?php $view['slots']->set('title', 'My cool blog posts') ?>
-
-<?php $view['slots']->start('body') ?>
-    <?php foreach ($blog_entries as $entry): ?>
-        <h2><?php echo $entry->getTitle() ?></h2>
-        <p><?php echo $entry->getBody() ?></p>
-    <?php endforeach; ?>
-<?php $view['slots']->stop() ?>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            La plantilla padre se identifica mediante una sintaxis de cadena especial (::base.html.twig) la cual indica que la plantilla vive en el directorio app/Resources/views del proyecto. Esta convención de nomenclatura se explica completamente en Nomenclatura y ubicación de plantillas.

            -
            -

            La clave para la herencia de plantillas es la etiqueta {% extends %}. Esta le indica al motor de plantillas que primero evalúe la plantilla base, la cual establece el diseño y define varios bloques. Luego reproduce la plantilla hija, en ese momento, los bloques title y body del padre son reemplazados por los de la hija. Dependiendo del valor de blog_entries, el resultado sería algo como esto:

            -
            <!DOCTYPE html>
-    <html>
-        <head>
-        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-        <title>My cool blog posts</title>
-        </head>
-        <body>
-        <div id="sidebar">
-            <ul>
-                <li><a href="/">Home</a></li>
-                <li><a href="/blog">Blog</a></li>
-            </ul>
-        </div>
-
-        <div id="contenido">
-            <h2>My first post</h2>
-            <p>The body of the first post.</p>
-
-            <h2>Another post</h2>
-            <p>The body of the second post.</p>
-        </div>
-    </body>
-</html>
-
            -
            -

            Ten en cuenta que como en la plantilla hija no has definido un bloque sidebar, en su lugar, se utiliza el valor de la plantilla padre. Una plantilla padre, de forma predeterminada, siempre utiliza una etiqueta {% block %} para el contenido.

            -

            Puedes utilizar tantos niveles de herencia como quieras. En la siguiente sección, explicaremos un modelo común de tres niveles de herencia junto con la forma en que se organizan las plantillas dentro de un proyecto Symfony2.

            -

            Cuando trabajes con la herencia de plantillas, ten en cuenta los siguientes consejos:

            -
              -

            • Si utilizas {% extends %} en una plantilla, esta debe ser la primer etiqueta en esa plantilla;

              -
              • -

            • Mientras más etiquetas {% block %} tengas en tu plantilla base, mejor. -Recuerda, las plantillas hijas no tienen que definir todos los bloques de los padres, por lo tanto crea tantos bloques en tus plantillas base como desees y dale a cada uno un razonable valor predeterminado. Mientras más bloques tengan tus plantillas base, más flexible será tu diseño;

              -
              • -

            • Si te encuentras duplicando contenido en una serie de plantillas, muy probablemente significa que debes mover el contenido a un {% block %} en una plantilla padre. -En algunos casos, una mejor solución podría ser mover el contenido a una nueva plantilla e incluirla con include (consulta Incluyendo otras plantillas);

              -
              • -

            • Si necesitas conseguir el contenido de un bloque desde la plantilla padre, puedes usar la función {{ parent() }}. Esta es útil si deseas añadir algo al contenido de un bloque padre en vez de reemplazarlo por completo:

              -
              -
              {% block sidebar %}
-    <h3>Table of Contents</h3>
-
-    {# ... #}
-
-    {{ parent() }}
-{% endblock %}
-
              -
              -
              -
              • -
            -
            -
            -

            Nomenclatura y ubicación de plantillas

            -

            -Nuevo en la versión 2.2: El soporte necesario para rutas en el espacio de nombres se añadió en 2.2, permitiendo nombres de plantilla tal como @AcmeDemo/layout.html.twig. Consulta Cómo utilizar y rutas Twig con espacios de nombres para más detalles.

            -

            De forma predeterminada, las plantillas pueden vivir en dos diferentes lugares:

            -
              -
            • app/Resources/views/: El directorio de las vistas de la aplicación puede contener todas las plantillas base de la aplicación (es decir, los diseños de tu aplicación), así como plantillas que sustituyen a plantillas de paquetes (consulta Sustituyendo plantillas del paquete);
              • -
            • ruta/al/paquete/Resources/views/ Cada paquete contiene sus plantillas en su directorio (y subdirectorios) Resources/views. La mayoría de las plantillas viven dentro de un paquete.
              • -
            -

            Symfony2 utiliza una sintaxis de cadena paquete:controlador:plantilla para las plantillas. Esto permite diferentes tipos de plantilla, dónde cada una vive en un lugar específico:

            -
              -

            • AcmeBlogBundle:Blog:index.html.twig: Esta sintaxis se utiliza para especificar una plantilla para una página específica. Las tres partes de la cadena, cada una separada por dos puntos (:), significan lo siguiente:

              -
              -
                -
              • AcmeBlogBundle: (paquete) la plantilla vive dentro de AcmeBlogBundle (por ejemplo, src/Acme/BlogBundle);
                • -
              • Blog: (controlador) indica que la plantilla vive dentro del subdirectorio Blog de Resources/views;
                • -
              • index.html.twig: (plantilla) el nombre real del archivo es index.html.twig.
                • -
              -
              -

              Suponiendo que AcmeBlogBundle vive en src/Acme/BlogBundle, la ruta final para el diseño debería ser src/Acme/BlogBundle/Resources/views/Blog/index.html.twig.

              -
              • -

            • AcmeBlogBundle::layout.html.twig: Esta sintaxis se refiere a una plantilla base que es específica para AcmeBlogBundle. Puesto que falta la porción central, «controlador» (por ejemplo, Blog), la plantilla vive en Resources/views/layout.html.twig dentro de AcmeBlogBundle.

              -
              • -

            • ::base.html.twig: Esta sintaxis se refiere a una plantilla o diseño base de la aplicación. Observa que la cadena comienza con dobles dos puntos (::), lo cual significa que faltan ambas porciones paquete y controlador. Esto quiere decir que la plantilla no se encuentra en ningún paquete, sino en el directorio raíz de la aplicación app/Resources/views/.

              -
              • -
            -

            En la sección Sustituyendo plantillas del paquete, encontrarás cómo puedes sustituir cada plantilla que vive dentro de AcmeBlogBundle, por ejemplo, colocando una plantilla del mismo nombre en el directorio app/Resources/AcmeBlog/views/. Esto nos da el poder para sustituir plantillas de cualquier paquete de terceros.

            -
            -

            Truco

            -

            Esperemos que la sintaxis de nomenclatura de plantilla te resulte familiar —es la misma convención de nomenclatura utilizada para referirse al Patrón de nomenclatura para controladores.

            -
            -
            -

            Sufijo de plantilla

            -

            El formato paquete:controlador:plantilla de cada plantilla, especifica dónde se encuentra el archivo de plantilla. Cada nombre de plantilla también cuenta con dos extensiones que especifican el formato y motor de esa plantilla.

            -
              -
            • AcmeBlogBundle:Blog:index.html.twig — formato HTML, motor Twig
              • -
            • AcmeBlogBundle:Blog:index.html.php — formato HTML, motor PHP
              • -
            • AcmeBlogBundle:Blog:index.css.twig — formato CSS, motor Twig
              • -
            -

            De forma predeterminada, cualquier plantilla Symfony2 se puede escribir en Twig o PHP, y la última parte de la extensión (por ejemplo .twig o .php) especifica cuál de los dos motores se debe utilizar. La primera parte de la extensión, (por ejemplo .html, .css, etc.) es el formato final que la plantilla debe generar. A diferencia del motor, el cual determina cómo procesa Symfony2 la plantilla, esta simplemente es una táctica de organización utilizada en caso de que el mismo recurso se tenga que reproducir como HTML (index.html.twig), XML (index.xml.twig), o cualquier otro formato. Para más información, lee la sección Depurando.

            -
            -

            Nota

            -

            Los «motores» disponibles se pueden configurar e incluso agregar nuevos motores. -Consulta Configuración de plantillas para más detalles.

            -
            -
            -
            -
            -

            Etiquetas y ayudantes

            -

            Ya entendiste los conceptos básicos de las plantillas, cómo son denominadas y cómo utilizar la herencia en plantillas. Las partes más difíciles ya quedaron atrás. En esta sección, aprenderás acerca de un amplio grupo de herramientas disponibles para ayudarte a realizar las tareas de plantilla más comunes, como la inclusión de otras plantillas, enlazar páginas e incluir imágenes.

            -

            Symfony2 viene con varias etiquetas Twig especializadas y funciones que facilitan la labor del diseñador de la plantilla. En PHP, el sistema de plantillas extensible ofrece un sistema de ayudantes que proporciona funciones útiles en el contexto de la plantilla.

            -

            Ya hemos visto algunas etiquetas integradas en Twig ({% block %} y {% extends %}), así como un ejemplo de un ayudante PHP (consulta $view['slot']). Aquí aprenderás un poco más.

            -
            -

            Incluyendo otras plantillas

            -

            A menudo querrás incluir la misma plantilla o fragmento de código en varias páginas diferentes. Por ejemplo, en una aplicación con «artículos de noticias», el código de la plantilla que muestra un artículo se puede utilizar en la página de detalles del artículo, en una página que muestra los artículos más populares, o en una lista de los artículos más recientes.

            -

            Cuando necesitas volver a utilizar un trozo de código PHP, normalmente mueves el código a una nueva clase o función PHP. Lo mismo es cierto para las plantillas. Al mover el código de la plantilla a su propia plantilla, este se puede incluir en cualquier otra plantilla. En primer lugar, crea la plantilla que tendrás que volver a usar.

            -
            -
              -
            • Twig
              {# src/Acme/ArticleBundle/Resources/views/Article/articleDetails.html.twig #}
-<h2>{{ article.title }}</h2>
-<h3 class="byline">by {{ article.authorName }}</h3>
-
-<p>
-    {{ article.body }}
-</p>
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/ArticleBundle/Resources/views/Article/articleDetails.html.php -->
-<h2><?php echo $article->getTitle() ?></h2>
-<h3 class="byline">by <?php echo $article->getAuthorName() ?></h3>
-
-<p>
-    <?php echo $article->getBody() ?>
-</p>
-
              -
              -
              • -
            -
            -

            Incluir esta plantilla en cualquier otra plantilla es sencillo:

            -
            -
              -
            • Twig
              {# src/Acme/ArticleBundle/Resources/views/Article/list.html.twig #}
-{% extends 'AcmeArticleBundle::layout.html.twig' %}
-
-{% block body %}
-    <h1>Recent Articles<h1>
-
-    {% for article in articles %}
-        {{ include('AcmeArticleBundle:Article:articleDetails.html.twig', {'article': article}) }}
-    {% endfor %}
-{% endblock %}
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/ArticleBundle/Resources/Article/list.html.php -->
-<?php $view->extend('AcmeArticleBundle::layout.html.php') ?>
-
-<?php $view['slots']->start('body') ?>
-    <h1>Recent Articles</h1>
-
-    <?php foreach ($articles as $article): ?>
-        <?php echo $view->render(
-            'AcmeArticleBundle:Article:articleDetails.html.php',
-            array('article' => $article)
-        ) ?>
-    <?php endforeach; ?>
-<?php $view['slots']->stop() ?>
-
              -
              -
              • -
            -
            -

            La plantilla se incluye utilizando la función {{ include() }}. Observa que el nombre de la plantilla sigue la misma convención típica. La plantilla articleDetails.html.twig utiliza una variable article. Esta es proporcionada por la plantilla list.html.twig utilizando la orden with.

            -
            -

            Truco

            -

            {'article': article} es la sintaxis de asignación estándar de Twig (es decir, un arreglo con claves nombradas). Si tuviéramos que pasar varios elementos, se vería así: {'foo': foo, 'bar': bar}.

            -
            -

            -Nuevo en la versión 2.2: La función include() es una nueva característica de Twig que está disponible en Symfony 2.2. Anteriormente se utilizaba la etiqueta {% include %}.

            -
            -
            -

            Integrando controladores

            -

            En algunos casos, es necesario hacer algo más que incluir una simple plantilla. Supongamos que en tu diseño tienes una barra lateral, la cual contiene los tres artículos más recientes. -Recuperar los tres artículos puede incluir consultar la base de datos o realizar otra pesada lógica ​​que no se puede hacer desde dentro de una plantilla.

            -

            La solución es simplemente insertar el resultado de un controlador en tu plantilla entera. En primer lugar, crea un controlador que reproduzca una cierta cantidad de artículos recientes:

            -
            // src/Acme/ArticleBundle/Controller/ArticleController.php
-class ArticleController extends Controller
-{
-    public function recentArticlesAction($max = 3)
-    {
-        // hace una llamada a la base de datos u otra lógica
-        // para obtener los "$max" artículos más recientes
-        $articles = ...;
-
-        return $this->render(
-            'AcmeArticleBundle:Article:recentList.html.twig',
-            array('articles' => $articles)
-        );
-    }
-}
-
            -
            -

            La plantilla recentList es perfectamente clara:

            -
            -
              -
            • Twig
              {# src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig #}
-{% for article in articles %}
-    <a href="/article/{{ article.slug }}">
-        {{ article.title }}
-        </a>
-{% endfor %}
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/ArticleBundle/Resources/views/Article/recentList.html.php -->
-<?php foreach ($articles as $article): ?>
-    <a href="/article/<?php echo $article->getSlug() ?>">
-        <?php echo $article->getTitle() ?>
-        </a>
-<?php endforeach; ?>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Ten en cuenta que la URL del artículo está directamente en el código en este ejemplo -(p. ej. /article/*slug*). Esta es una mala práctica. En la siguiente sección, aprenderás cómo hacer esto correctamente.

            -
            -

            Para incluir el controlador, tendrás que referirte a él utilizando la sintaxis de cadena estándar para controladores (es decir, paquete:controlador:acción):

            -
            -
              -
            • Twig
              {# app/Resources/views/base.html.twig #}
-
-{# ... #}
-<div id="sidebar">
-    {{ render(controller('AcmeArticleBundle:Article:recentArticles', { 'max': 3 })) }}
-</div>
-
              -
              -
              • -
            • PHP
              <!-- app/Resources/views/base.html.php -->
-
-<!-- ... -->
-<div id="sidebar">
-    <?php echo $view['actions']->render(
-        new ControllerReference('AcmeArticleBundle:Article:recentArticles', array('max' => 3))
-    ) ?>
-</div>
-
              -
              -
              • -
            -
            -

            Cada vez que te encuentres necesitando una variable o una pieza de información a la que una plantilla no tiene acceso, considera reproducir un controlador. -Los controladores se ejecutan rápidamente y promueven la buena organización y reutilización de código.

            -
            -
            -

            Contenido asíncrono con hinclude.js

            -

            -Nuevo en la versión 2.1: La compatibilidad con hinclude.js se añadió en Symfony 2.1

            -

            Los controladores se pueden incorporar asincrónicamente usando la biblioteca JavaScript hinclude.js. -Debido a que el contenido integrado proviene de otra página (o controlador para el caso), Symfony2 utiliza el ayudante render estándar para configurar las etiquetas hinclude:

            -
            -
              -
            • Twig
              {% render url('...') with {}, {'standalone': 'js'} %}
-
              -
              -
              • -
            • PHP
              <?php echo $view['actions']->render(
-    new ControllerReference('...'),
-    array('renderer' => 'hinclude')
-) ?>
-
-<?php echo $view['actions']->render(
-    $view['router']->generate('...'),
-    array('renderer' => 'hinclude')
-) ?>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Para que trabaje, debes incluir hinclude.js en tu página.

            -
            -
            -

            Nota

            -

            Al utilizar un controlador en vez de una URL, debes habilitar la configuración de fragmentos de Symfony:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    # ...
-    fragments: { path: /_fragment }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config>
-    <framework:fragments path="/_fragment" />
-</framework:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    // ...
-    'fragments' => array('path' => '/_fragment'),
-));
-
              -
              -
              • -
            -
            -
            -

            Puedes especificar globalmente el contenido predeterminado (al cargar o si JavaScript está desactivado) en la configuración de tu aplicación:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    # ...
-    templating:
-        hinclude_default_template: AcmeDemoBundle::hinclude.html.twig
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config>
-    <framework:templating hinclude-default-template="AcmeDemoBundle::hinclude.html.twig" />
-</framework:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    // ...
-    'templating'      => array(
-        'hinclude_default_template' => array('AcmeDemoBundle::hinclude.html.twig'),
-    ),
-));
-
              -
              -
              • -
            -
            -

            -Nuevo en la versión 2.2: Las plantillas default para la función render se añadieron en Symfony 2.2

            -

            Puedes definir plantillas default para la función render (lo cuál sustituye cualquier plantilla default global que esté definida):

            -
            -
              -
            • Twig
              {{ render_hinclude(controller('...'),  {'default': 'AcmeDemoBundle:Default:content.html.twig'}) }}
-
              -
              -
              • -
            • PHP
              <?php echo $view['actions']->render(
-    new ControllerReference('...'),
-    array(
-        'renderer' => 'hinclude',
-        'default' => 'AcmeDemoBundle:Default:content.html.twig',
-    )
-) ?>
-
              -
              -
              • -
            -
            -

            O puedes especificar además, una cadena que se mostrará como el contenido predefinido:

            -
            -
              -
            • Twig
              {{ render_hinclude(controller('...'), {'default': 'Loading...'}) }}
-
              -
              -
              • -
            • PHP
              <?php echo $view['actions']->render(
-    new ControllerReference('...'),
-    array(
-        'renderer' => 'hinclude',
-        'default' => 'Loading...',
-    )
-) ?>
-
              -
              -
              • -
            -
            -
            -
            -

            Enlazando páginas

            -

            La creación de enlaces a otras páginas en tu aplicación es uno de los trabajos más comunes de una plantilla. En lugar de codificar las URL en las plantillas, utiliza la función path de Twig (o el ayudante router en PHP) para generar URL basadas en la configuración de enrutado. Más tarde, si deseas modificar la URL de una página en particular, todo lo que tienes que hacer es cambiar la configuración de enrutado; las plantillas automáticamente generarán la nueva URL.

            -

            En primer lugar, crea el enlace a la página «_welcome», la cual es accesible a través de la siguiente configuración de enrutado:

            -
            -
              -
            • YAML
              _welcome:
-    path:     /
-    defaults: { _controller: AcmeDemoBundle:Welcome:index }
-
              -
              -
              • -
            • XML
              <route id="_welcome" path="/">
-    <default key="_controller">AcmeDemoBundle:Welcome:index</default>
-</route>
-
              -
              -
              • -
            • PHP
              $collection = new RouteCollection();
-$collection->add('_welcome', new Route('/', array(
-    '_controller' => 'AcmeDemoBundle:Welcome:index',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Para enlazar a la página, sólo tienes que utilizar la función path de Twig y referir la ruta:

            -
            -
              -
            • Twig
              <a href="{{ path('_welcome') }}">Home</a>
-
              -
              -
              • -
            • PHP
              <a href="<?php echo $view['router']->generate('_welcome') ?>">Home</a>
-
              -
              -
              • -
            -
            -

            Como era de esperar, esto genera la URL /. Ahora para una ruta más complicada:

            -
            -
              -
            • YAML
              article_show:
-    path:     /article/{slug}
-    defaults: { _controller: AcmeArticleBundle:Article:show }
-
              -
              -
              • -
            • XML
              <route id="article_show" path="/article/{slug}">
-    <default key="_controller">AcmeArticleBundle:Article:show</default>
-</route>
-
              -
              -
              • -
            • PHP
              $collection = new RouteCollection();
-$collection->add('article_show', new Route('/article/{slug}', array(
-    '_controller' => 'AcmeArticleBundle:Article:show',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            En este caso, es necesario especificar el nombre de la ruta (article_show) y un valor para el parámetro {slug}. Usando esta ruta, revisemos la plantilla recentList de la sección anterior y enlacemos los artículos correctamente:

            -
            -
              -
            • Twig
              {# src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig #}
-{% for article in articles %}
-    <a href="{{ path('article_show', {'slug': article.slug}) }}">
-        {{ article.title }}
-        </a>
-{% endfor %}
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/ArticleBundle/Resources/views/Article/recentList.html.php -->
-<?php foreach ($articles in $article): ?>
-    <a href="<?php echo $view['router']->generate('article_show', array('slug' => $article->getSlug()) ?>">
-        <?php echo $article->getTitle() ?>
-        </a>
-<?php endforeach; ?>
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            También puedes generar una URL absoluta utilizando la función url de Twig:

            -
            <a href="{{ url('_welcome') }}">Home</a>
-
            -
            -

            Lo mismo se puede hacer en plantillas PHP pasando un tercer argumento al método generate():

            -
            <a href="<?php echo $view['router']->generate(
-    '_welcome',
-    array(),
-    true
-) ?>">Home</a>
-
            -
            -
            -
            -
            -

            Enlazando activos

            -

            Las plantillas también se refieren comúnmente a imágenes, JavaScript, hojas de estilo y otros activos. Por supuesto, puedes codificar la ruta de estos activos (por ejemplo /images/logo.png), pero Symfony2 ofrece una opción más dinámica a través de la función asset de Twig:

            -
            -
              -
            • Twig
              <img src="{{ asset('images/logo.png') }}" alt="Symfony!" />
-
-<link href="{{ asset('css/blog.css') }}" rel="stylesheet" type="text/css" />
-
              -
              -
              • -
            • PHP
              <img src="<?php echo $view['assets']->getUrl('images/logo.png') ?>" alt="Symfony!" />
-
-<link href="<?php echo $view['assets']->getUrl('css/blog.css') ?>" rel="stylesheet" type="text/css" />
-
              -
              -
              • -
            -
            -

            El propósito principal de la función asset es hacer más portátil tu aplicación. -Si tu aplicación vive en la raíz de tu servidor (por ejemplo, http://ejemplo.com), entonces las rutas reproducidas deben ser /images/logo.png. Pero si tu aplicación vive en un subdirectorio (por ejemplo, http://ejemplo.com/mi_aplic), cada ruta de activo debe reproducir el subdirectorio (por ejemplo /mi_aplic/images/logo.png). La función asset se encarga de esto determinando cómo se está utilizando tu aplicación y generando las rutas correctas en consecuencia.

            -

            Además, si utilizas la función asset, Symfony automáticamente puede añadir una cadena de consulta a tu activo, con el fin de garantizar que los activos estáticos actualizados no se almacenen en caché al desplegar tu aplicación. Por ejemplo, /images/logo.png podría ser /images/logo.png?v2. Para más información, consulta la opción de configuración assets_version.

            -
            -
            -
            -

            Incluyendo hojas de estilo y JavaScript en Twig

            -

            Ningún sitio estaría completo sin incluir archivos de JavaScript y hojas de estilo. -En Symfony, la inclusión de estos activos se maneja elegantemente, aprovechando la herencia de plantillas de Symfony.

            -
            -

            Truco

            -

            Esta sección te enseñará la filosofía detrás de la inclusión de activos como hojas de estilo y Javascript en Symfony. Symfony también empaca otra biblioteca, llamada Assetic, la cual sigue esta filosofía, pero te permite hacer cosas mucho más interesantes con esos activos. Para más información sobre el uso de Assetic consulta Cómo utilizar Assetic para gestionar activos.

            -
            -

            Comienza agregando dos bloques a la plantilla base que mantendrá tus activos: -uno llamado stylesheet dentro de la etiqueta head y otro llamado javascript justo por encima de la etiqueta de cierre body. Estos bloques deben contener todas las hojas de estilo y archivos Javascript que necesitas en tu sitio:

            -
            {# app/Resources/views/base.html.twig #}
-    <html>
-        <head>
-        {# ... #}
-
-        {% block stylesheets %}
-            <link href="{{ asset('/css/main.css') }}" type="text/css" rel="stylesheet" />
-        {% endblock %}
-        </head>
-        <body>
-        {# ... #}
-
-        {% block javascripts %}
-            <script src="{{ asset('/js/main.js') }}" type="text/javascript"></script>
-        {% endblock %}
-    </body>
-</html>
-
            -
            -

            ¡Eso es bastante fácil! Pero ¿y si es necesario incluir una hoja de estilo extra o archivos Javascript desde una plantilla hija? Por ejemplo, supongamos que tienes una página de contacto y necesitas incluir una hoja de estilo contact.css sólo en esa página. Desde dentro de la plantilla de la página de contacto, haz lo siguiente:

            -
            {# src/Acme/DemoBundle/Resources/views/Contact/contact.html.twig #}
-{% extends '::base.html.twig' %}
-
-{% block stylesheets %}
-    {{ parent() }}
-
-    <link href="{{ asset('/css/contact.css') }}" type="text/css" rel="stylesheet" />
-{% endblock %}
-
-{# ... #}
-
            -
            -

            En la plantilla hija, sólo tienes que reemplazar el bloque stylesheets y poner tu nueva etiqueta de hoja de estilo dentro de ese bloque. Por supuesto, debido a que la quieres añadir al contenido del bloque padre (y no cambiarla en realidad), debes usar la función parent() de Twig para incluir todo, desde el bloque stylesheets de la plantilla base.

            -

            Además, puedes incluir activos ubicados en el directorio Resources/public de tus paquetes. -Deberás ejecutar la orden php app/console assets:install destino [--symlink], la cual mueve (o enlaza simbólicamente) tus archivos a la ubicación correcta. (destino por omisión es «web»).

            -
            <link href="{{ asset('bundles/acmedemo/css/contact.css') }}" type="text/css" rel="stylesheet" />
-
            -
            -

            El resultado final es una página que incluye ambas hojas de estilo main.css y contact.css.

            -
            -
            -

            Variables de plantilla globales

            -

            En cada petición, Symfony2 debe configurar una variable de plantilla global app en ambos motores de plantilla predefinidos Twig y PHP. La variable app es una instancia de Symfony\Bundle\FrameworkBundle\Templating\GlobalVariables que automáticamente te proporciona acceso a algunas variables específicas de la aplicación:

            -
              -
            • app.security - El contexto de seguridad.
              • -
            • app.user - El objeto Usuario actual.
              • -
            • app.request - El objeto Petición.
              • -
            • app.session - El objeto Sesión.
              • -
            • app.environment - El entorno actual («dev», «prod», etc.)
              • -
            • app.debug - True si está en modo de depuración. False en caso contrario.
              • -
            -
            -
              -
            • Twig
              <p>Username: {{ app.user.username }}</p>
-{% if app.debug %}
-    <p>Request method: {{ app.request.method }}</p>
-    <p>Application Environment: {{ app.environment }}</p>
-{% endif %}
-
              -
              -
              • -
            • PHP
              <p>Username: <?php echo $app->getUser()->getUsername() ?></p>
-<?php if ($app->getDebug()): ?>
-    <p>Request method: <?php echo $app->getRequest()->getMethod() ?></p>
-    <p>Application Environment: <?php echo $app->getEnvironment() ?></p>
-<?php endif; ?>
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Puedes agregar tus propias variables de plantilla globales. Ve el ejemplo de variables globales en el recetario.

            -
            -
            -
            -

            Configurando y usando el servicio plantilla

            -

            El corazón del sistema de plantillas en Symfony2 es el motor de plantillas. -Este objeto especial es el encargado de reproducir las plantillas y devolver su contenido. Cuando reproduces una plantilla en un controlador, por ejemplo, en realidad estás usando el motor del servicio de plantillas. Por ejemplo:

            -
            return $this->render('AcmeArticleBundle:Article:index.html.twig');
-
            -
            -

            es equivalente a:

            -
            use Symfony\Component\HttpFoundation\Response;
-
-$engine = $this->container->get('templating');
-$content = $engine->render('AcmeArticleBundle:Article:index.html.twig');
-
-return $response = new Response($content);
-
            -
            -

            El motor de plantillas (o «servicio») está configurado para funcionar automáticamente al interior de Symfony2. Por supuesto, puedes configurar más en el archivo de configuración de la aplicación:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    # ...
-    templating: { engines: ['twig'] }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:templating>
-    <framework:engine id="twig" />
-</framework:templating>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    // ...
-
-    'templating' => array(
-        'engines' => array('twig'),
-    ),
-));
-
              -
              -
              • -
            -
            -

            Disponemos de muchas opciones de configuración y están cubiertas en el Apéndice Configurando.

            -
            -

            Nota

            -

            En el motor de twig es obligatorio el uso del webprofiler (así como muchos otros paquetes de terceros).

            -
            -
            -
            -

            Sustituyendo plantillas del paquete

            -

            La comunidad de Symfony2 se enorgullece de crear y mantener paquetes de alta calidad (consulta KnpBundles.com) para ver la gran cantidad de diferentes características. -Una vez que utilizas un paquete de terceros, probablemente necesites redefinir y personalizar una o más de sus plantillas.

            -

            Supongamos que hemos incluido el paquete imaginario AcmeBlogBundle de código abierto en el proyecto (por ejemplo, en el directorio src/Acme/BlogBundle). Y si bien estás muy contento con todo, deseas sustituir la página «lista» del blog para personalizar el marcado específicamente para tu aplicación. Al excavar en el controlador del Blog de AcmeBlogBundle, encuentras lo siguiente:

            -
            public function indexAction()
-{
-    // alguna lógica para recuperar artículos
-    $blogs = ...;
-
-    $this->render(
-        'AcmeBlogBundle:Blog:index.html.twig',
-        array('blogs' => $blogs)
-    );
-}
-
            -
            -

            Al reproducir AcmeBlogBundle:Blog:index.html.twig, en realidad Symfony2 busca la plantilla en dos diferentes lugares:

            -
              -
            1. app/Resources/AcmeBlogBundle/views/Blog/index.html.twig
              2. -
            2. src/Acme/BlogBundle/Resources/views/Blog/index.html.twig
              3. -
            -

            Para sustituir la plantilla del paquete, sólo tienes que copiar la plantilla index.html.twig del paquete a app/Resources/AcmeBlogBundle/views/Blog/index.html.twig (el directorio app/Resources/AcmeBlogBundle no existe, por lo tanto tendrás que crearlo). Ahora eres libre de personalizar la plantilla para tu aplicación.

            -
            -

            Prudencia

            -

            Si agregas una plantilla en una nueva ubicación, posiblemente tengas que vaciar la caché (con php app/consola cache:clear), incluso si estás en modo de depuración.

            -
            -

            Esta lógica también aplica a las plantillas base del paquete. Supongamos también que cada plantilla en AcmeBlogBundle hereda de una plantilla base llamada AcmeBlogBundle::layout.html.twig. Al igual que antes, Symfony2 buscará la plantilla en los dos siguientes lugares:

            -
              -
            1. app/Resources/AcmeBlogBundle/views/layout.html.twig
              2. -
            2. src/Acme/BlogBundle/Resources/views/layout.html.twig
              3. -
            -

            Una vez más, para sustituir la plantilla, sólo tienes que copiarla desde el paquete a app/Resources/AcmeBlogBundle/views/layout.html.twig. Ahora estás en libertad de personalizar esta copia como mejor te parezca.

            -

            Si retrocedes un paso, verás que Symfony2 siempre empieza a buscar una plantilla en el directorio app/Resources/{NOMBRE_PAQUETE}/views/. Si la plantilla no existe allí, continúa buscando dentro del directorio Resources/views del propio paquete. Esto significa que todas las plantillas del paquete se pueden sustituir colocándolas en el subdirectorio app/Resources correcto.

            -
            -

            Nota

            -

            También puedes reemplazar las plantillas de un paquete usando la herencia de paquetes. Para más información, consulta Cómo utilizar la herencia de paquetes para redefinir partes de un paquete.

            -
            -
            -

            Sustituyendo plantillas del núcleo

            -

            Puesto que la plataforma Symfony2 en sí misma sólo es un paquete, las plantillas del núcleo se pueden sustituir de la misma manera. Por ejemplo, el núcleo de TwigBundle contiene una serie de diferentes plantillas para «excepción» y «error» que puedes sustituir copiando cada una del directorio Resources/views/Exception del TwigBundle a... ¡adivinaste! el directorio app/Resources/TwigBundle/views/Exception.

            -
            -
            -
            -

            Herencia de tres niveles

            -

            Una manera común de usar la herencia es utilizar un enfoque de tres niveles. Este método funciona a la perfección con los tres diferentes tipos de plantilla que acabamos de cubrir:

            -
              -

            • Crea un archivo app/Resources/views/base.html.twig que contenga el diseño principal para tu aplicación (como en el ejemplo anterior). Internamente, esta plantilla se llama ::base.html.twig;

              -
              • -

            • Crea una plantilla para cada «sección» de tu sitio. Por ejemplo, AcmeBlogBundle, tendría una plantilla llamada AcmeBlogBundle::layout.html.twig que sólo contiene los elementos específicos de la sección blog;

              -
              {# src/Acme/BlogBundle/Resources/views/layout.html.twig #}
-{% extends '::base.html.twig' %}
-
-{% block body %}
-    <h1>Blog Application</h1>
-
-    {% block content %}{% endblock %}
-{% endblock %}
-
              -
              -
              • -

            • Crea plantillas individuales para cada página y haz que cada una extienda la plantilla de la sección adecuada. Por ejemplo, la página «index» se llama algo parecido a AcmeBlogBundle:Blog:index.html.twig y enumera las entradas del blog real.

              -
              {# src/Acme/BlogBundle/Resources/views/Blog/index.html.twig #}
-{% extends 'AcmeBlogBundle::layout.html.twig' %}
-
-{% block content %}
-    {% for entry in blog_entries %}
-        <h2>{{ entry.title }}</h2>
-        <p>{{ entry.body }}</p>
-    {% endfor %}
-{% endblock %}
-
              -
              -
              • -
            -

            Ten en cuenta que esta plantilla extiende la plantilla de la sección — (AcmeBlogBundle::layout.html.twig), que a su vez, extiende el diseño base de la aplicación (::base.html.twig). -Este es el modelo común de la herencia de tres niveles.

            -

            Cuando construyas tu aplicación, podrás optar por este método o, simplemente, hacer que cada plantilla de página extienda directamente la plantilla base de tu aplicación (por ejemplo, {% extends '::base.html.twig' %}). El modelo de plantillas de tres niveles es un método de las buenas prácticas utilizadas por los paquetes de proveedores a fin de que la plantilla base de un paquete se pueda sustituir fácilmente para extender correctamente el diseño base de tu aplicación.

            -
            -
            -

            Mecanismo de escape

            -

            Cuando generas HTML a partir de una plantilla, siempre existe el riesgo de que una variable de plantilla pueda producir HTML involuntario o código peligroso de lado del cliente. El resultado es que el contenido dinámico puede romper el código HTML de la página resultante o permitir a un usuario malicioso realizar un ataque de Explotación de vulnerabilidades del sistema (Cross Site Scripting XSS). Considera este ejemplo clásico:

            -
            -
              -
            • Twig
              Hello {{ name }}
-
              -
              -
              • -
            • PHP
              Hello <?php echo $name ?>
-
              -
              -
              • -
            -
            -

            Imagina que el usuario introduce el siguiente código como su nombre:

            -
            <script>alert('hello!')</script>
-
            -
            -

            Sin ningún tipo de mecanismo de escape, la plantilla resultante provocaría que aparezca un cuadro de alerta JavaScript:

            -
            Hello <script>alert('hello!')</script>
-
            -
            -

            Y aunque esto parece inofensivo, si un usuario puede llegar hasta aquí, ese mismo usuario también será capaz de escribir código JavaScript malicioso que subrepticiamente realice acciones dentro de la zona segura de un usuario legítimo.

            -

            La respuesta al problema es el mecanismo de escape. Con el mecanismo de escape, reproduces la misma plantilla sin causar daño alguno, y literalmente, imprimes en pantalla la etiqueta script:

            -
            Hello &lt;script&gt;alert(&#39;helloe&#39;)&lt;/script&gt;
-
            -
            -

            Twig y los sistemas de plantillas PHP abordan el problema de diferentes maneras. -Si estás utilizando Twig, el mecanismo de escape por omisión está activado y tu aplicación está protegida. -En PHP, el mecanismo de escape no es automático, lo cual significa que, de ser necesario, necesitas escapar todo manualmente.

            -
            -

            Mecanismo de escape en Twig

            -

            Si estás utilizando las plantillas de Twig, entonces el mecanismo de escape está activado por omisión. Esto significa que estás protegido fuera de la caja de las consecuencias no intencionales del código presentado por los usuarios. De forma predeterminada, el mecanismo de escape asume que el contenido se escapó para salida HTML.

            -

            En algunos casos, tendrás que desactivar el mecanismo de escape cuando estás reproduciendo una variable de confianza y marcado que no se debe escapar. -Supongamos que los usuarios administrativos están autorizados para escribir artículos que contengan código HTML. De forma predeterminada, Twig debe escapar el cuerpo del artículo.

            -

            Para reproducirlo normalmente, agrega el filtro raw:

            -
            {{ article.body|raw }}
-
            -
            -

            También puedes desactivar el mecanismo de escape dentro de una área {% block %} o para una plantilla completa. Para más información, consulta la documentación de Twig sobre el Mecanismo de escape.

            -
            -
            -

            Mecanismo de escape en PHP

            -

            El mecanismo de escape no es automático cuando utilizas plantillas PHP. Esto significa que a menos que escapes una variable expresamente, no estás protegido. Para utilizar el mecanismo de escape, usa el método especial de la vista escape():

            -
            Hello <?php echo $view->escape($name) ?>
-
            -
            -

            De forma predeterminada, el método escape() asume que la variable se está reproduciendo en un contexto HTML (y por tanto la variable se escapa para que sea HTML seguro). -El segundo argumento te permite cambiar el contexto. Por ejemplo, para mostrar algo en una cadena JavaScript, utiliza el contexto js:

            -
            var myMsg = 'Hello <?php echo $view->escape($name, 'js') ?>';
-
            -
            -
            -
            -
            -

            Depurando

            -

            -Nuevo en la versión 2.0.9: Esta característica está disponible desde Twig 1.5.x, que se adoptó por primera vez en Symfony 2.0.9.

            -

            Cuando utilizas PHP, puedes usar var_dump() si necesitas encontrar rápidamente el valor de una variable proporcionada. Esto es útil, por ejemplo, dentro de tu controlador. -Lo mismo puedes lograr cuando utilizas Twig usando la extensión de depuración (debug). Necesitas activarla en la configuración:

            -
            -
              -
            • YAML
              # app/config/config.yml
-services:
-    acme_hello.twig.extension.debug:
-        class:        Twig_Extension_Debug
-        tags:
-                 - { name: 'twig.extension' }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-    <services>
-    <service id="acme_hello.twig.extension.debug" class="Twig_Extension_Debug">
-        <tag name="twig.extension" />
-    </service>
-    </services>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$definition = new Definition('Twig_Extension_Debug');
-$definition->addTag('twig.extension');
-$container->setDefinition('acme_hello.twig.extension.debug', $definition);
-
              -
              -
              • -
            -
            -

            Puedes descargar los parámetros de plantilla utilizando la función dump:

            -
            {# src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig #}
-{{ dump(articles) }}
-
-{% for article in articles %}
-    <a href="/article/{{ article.slug }}">
-        {{ article.title }}
-        </a>
-{% endfor %}
-
            -
            -

            Las variables serán descargadas si configuras a Twig (en config.yml) con debug a true. De manera predeterminada, esto significa que las variables serán descargadas en el entorno dev, pero no el entorno prod.

            -
            -
            -

            Comprobando la sintaxis

            -

            -Nuevo en la versión 2.1: La orden twig:lint fue añadida en Symfony 2.1

            -

            Puedes localizar errores de sintaxis en plantillas Twig utilizando la orden de consola twig:lint:

            -
            # Puedes buscar por nombre de archivo:
-$ php app/console twig:lint src/Acme/ArticleBundle/Resources/views/Article/recentList.html.twig
-
-# o por directorio:
-$ php app/console twig:lint src/Acme/ArticleBundle/Resources/views
-
-# o usando el nombre del paquete:
-$ php app/console twig:lint @AcmeArticleBundle
-
            -
            -
            -
            -

            Formato de plantillas

            -

            Las plantillas son una manera genérica para reproducir contenido en cualquier formato. Y, aunque en la mayoría de los casos debes utilizar plantillas para reproducir contenido HTML, una plantilla fácilmente puede generar JavaScript, CSS, XML o cualquier otro formato que puedas soñar.

            -

            Por ejemplo, el mismo «recurso» a menudo se reproduce en varios formatos diferentes. -Para reproducir una página índice de artículos en formato XML, basta con incluir el formato en el nombre de la plantilla:

            -
              -
            • nombre de plantilla XML: AcmeArticleBundle:Article:index.xml.twig
              • -
            • nombre del archivo de plantilla XML: index.xml.twig
              • -
            -

            Ciertamente, esto no es más que una convención de nomenclatura y la plantilla realmente no se reproduce de manera diferente en función de ese formato.

            -

            En muchos casos, posiblemente quieras permitir que un solo controlador reproduzca múltiples formatos basándose en el «formato de la petición». Por esa razón, un patrón común es hacer lo siguiente:

            -
            public function indexAction()
-{
-    $format = $this->getRequest()->getRequestFormat();
-
-    return $this->render('AcmeBlogBundle:Blog:index.'.$format.'.twig');
-}
-
            -
            -

            El getRequestFormat en el objeto Petición por omisión es HTML, pero lo puedes devolver en cualquier otro formato basándote en el formato solicitado por el usuario. -El formato de la petición muy frecuentemente es gestionado por el enrutador, donde puedes configurar una ruta para que /contact establezca el formato html de la petición, mientras que /contact.xml establezca al formato xml. Para más información, consulta el ejemplo avanzado en el capítulo de Enrutado.

            -

            Para crear enlaces que incluyan el parámetro de formato, agrega una clave _format en el parámetro hash:

            -
            -
              -
            • Twig
              <a href="{{ path('article_show', {'id': 123, '_format': 'pdf'}) }}">
-    PDF Version
-</a>
-
              -
              -
              • -
            • PHP
              <a href="<?php echo $view['router']->generate('article_show', array('id' => 123, '_format' => 'pdf')) ?>">
-    PDF Version
-</a>
-
              -
              -
              • -
            -
            -
            -
            -

            Consideraciones finales

            -

            El motor de plantillas de Symfony es una poderosa herramienta que puedes utilizar cada vez que necesites generar contenido de presentación en HTML, XML o cualquier otro formato. -Y aunque las plantillas son una manera común de generar contenido en un controlador, su uso no es obligatorio. El objeto Respuesta devuelto por un controlador se puede crear usando o sin usar una plantilla:

            -
            // crea un objeto Respuesta donde el contenido reproduce la plantilla
-$response = $this->render('AcmeArticleBundle:Article:index.html.twig');
-
-// crea un objeto Respuesta cuyo contenido es texto simple
-$response = new Response('response content');
-
            -
            -

            El motor de plantillas de Symfony es muy flexible y de manera predeterminada disponemos de dos diferentes reproductores de plantilla: las tradicionales plantillas PHP y las elegantes y potentes plantillas Twig. Ambas apoyan una jerarquía de plantillas y vienen empacadas con un rico conjunto de funciones auxiliares capaces de realizar las tareas más comunes.

            -

            En general, el tema de las plantillas se debe pensar como una poderosa herramienta que está a tu disposición. En algunos casos, posiblemente no necesites reproducir una plantilla, y en Symfony2, eso está absolutamente bien.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/testing.html b/book/testing.html deleted file mode 100644 index 2d6573e..0000000 --- a/book/testing.html +++ /dev/null @@ -1,793 +0,0 @@ - - - - - - - Probando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Probando

            -

            Cada vez que escribes una nueva línea de código, potencialmente, añades nuevos errores también. -Para construir mejores y más confiables aplicaciones, debes probar tu código usando ambas pruebas, unitarias y funcionales.

            -
            -

            La plataforma de pruebas PHPUnit

            -

            Symfony2 integra una biblioteca independiente —llamada PHPUnit— para proporcionarte una rica plataforma de pruebas. Esta parte no cubre PHPUnit en sí mismo, puesto que la biblioteca cuenta con su propia y excelente documentación.

            -
            -

            Nota

            -

            Symfony2 trabaja con PHPUnit 3.5.11 o posterior, aunque se necesita la versión 3.6.4 para probar el código del núcleo de Symfony.

            -
            -

            Cada prueba —si se trata de una prueba unitaria o una prueba funcional— es una clase PHP que debe vivir en el subdirectorio Tests/ de tus paquetes. Si sigues esta regla, entonces puedes ejecutar todas las pruebas de tu aplicación con la siguiente orden:

            -
            # especifica la configuración del directorio en la línea de ordenes
-$ phpunit -c app/
-
            -
            -

            La opción -c le dice a PHPUnit que busque el archivo de configuración en el directorio app/. Si tienes curiosidad sobre qué significan las opciones de PHPUnit, dale un vistazo al archivo app/phpunit.xml.dist.

            -
            -

            Truco

            -

            La cobertura de código se puede generar con la opción --coverage-html.

            -
            -
            -
            -

            Pruebas unitarias

            -

            Una prueba unitaria normalmente es una prueba contra una clase PHP específica. Si deseas probar el comportamiento de tu aplicación en conjunto, ve la sección sobre las Pruebas funcionales.

            -

            Escribir pruebas unitarias en Symfony2 no es diferente a escribir pruebas unitarias PHPUnit normales. Supongamos, por ejemplo, que tienes una clase increíblemente simple llamada Calculator en el directorio Utility/ de tu paquete:

            -
            // src/Acme/DemoBundle/Utility/Calculator.php
-namespace Acme\DemoBundle\Utility;
-
-class Calculator
-{
-    public function add($a, $b)
-    {
-        return $a + $b;
-    }
-}
-
            -
            -

            Para probarla, crea un archivo CalculatorTest en el directorio Tests/Utility de tu paquete:

            -
            // src/Acme/DemoBundle/Tests/Utility/CalculatorTest.php
-namespace Acme\DemoBundle\Tests\Utility;
-
-use Acme\DemoBundle\Utility\Calculator;
-
-class CalculatorTest extends \PHPUnit_Framework_TestCase
-{
-    public function testAdd()
-    {
-        $calc = new Calculator();
-        $result = $calc->add(30, 12);
-
-        // ¡acierta que nuestra calculadora suma dos números correctamente!
-        $this->assertEquals(42, $result);
-    }
-}
-
            -
            -
            -

            Nota

            -

            Por convención, el subdirectorio Tests/ debería replicar al directorio de tu paquete. Por lo tanto, si estás probando una clase en el directorio Utility/ de tu paquete, pon tus pruebas en el directorio Tests/Utility.

            -
            -

            Al igual que en tu aplicación real —el archivo bootstrap.php.cache— automáticamente activa el autocargador (como si lo hubieras configurado por omisión en el archivo phpunit.xml.dist).

            -

            Correr las pruebas de un determinado archivo o directorio también es muy fácil:

            -
            # ejecuta todas las pruebas en el directorio 'Utility'
-$ phpunit -c app src/Acme/DemoBundle/Tests/Utility/
-
-# corre las pruebas para la clase Calculator
-$ phpunit -c app src/Acme/DemoBundle/Tests/Utility/CalculatorTest.php
-
-# corre todas las pruebas del paquete entero
-$ phpunit -c app src/Acme/DemoBundle/
-
            -
            -
            -
            -

            Pruebas funcionales

            -

            Las pruebas funcionales verifican la integración de las diferentes capas de una aplicación (desde el enrutado hasta la vista). Ellas no son diferentes de las pruebas unitarias en cuanto a PHPUnit se refiere, pero tienen un flujo de trabajo muy específico:

            -
              -
            • Envían una petición;
              • -
            • Prueban la respuesta;
              • -
            • Hacen clic en un enlace o envían un formulario;
              • -
            • Prueban la respuesta;
              • -
            • Enjuagan y repiten.
              • -
            -
            -

            Tu primera prueba funcional

            -

            Las pruebas funcionales son simples archivos PHP que suelen vivir en el directorio Tests/Controller de tu paquete. Si deseas probar las páginas a cargo de tu clase DemoController, empieza creando un nuevo archivo DemoControllerTest.php que extiende una clase WebTestCase especial.

            -

            Por ejemplo, la edición estándar de Symfony2 proporciona una sencilla prueba funcional para DemoController (DemoControllerTest) que dice lo siguiente:

            -
            // src/Acme/DemoBundle/Tests/Controller/DemoControllerTest.php
-namespace Acme\DemoBundle\Tests\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-
-class DemoControllerTest extends WebTestCase
-{
-    public function testIndex()
-    {
-        $client = static::createClient();
-
-        $crawler = $client->request('GET', '/demo/hello/Fabien');
-
-        $this->assertGreaterThan(
-            0,
-            $crawler->filter('html:contains("Hello Fabien")')->count()
-        );
-    }
-}
-
            -
            -
            -

            Truco

            -

            Para ejecutar tus pruebas funcionales, la clase WebTestCase arranca el núcleo de tu aplicación. En la mayoría de los casos, esto sucede automáticamente. -Sin embargo, si tu núcleo se encuentra en un directorio no estándar, deberás modificar tu archivo phpunit.xml.dist para ajustar la variable de entorno KERNEL_DIR al directorio de tu núcleo:

            -
            <phpunit>
-    <!-- ... -->
-    <php>
-        <server name="KERNEL_DIR" value="/ruta/a/tu/app/" />
-    </php>
-    <!-- ... -->
-</phpunit>
-
            -
            -
            -

            El método createClient() devuelve un cliente, el cual es como un navegador que debes usar para explorar tu sitio:

            -
            $crawler = $client->request('GET', '/demo/hello/Fabien');
-
            -
            -

            El método request() (consulta más sobre el método request) devuelve un objeto Symfony\Component\DomCrawler\Crawler que puedes utilizar para seleccionar elementos en la respuesta, hacer clic en enlaces, y enviar formularios.

            -
            -

            Truco

            -

            El Crawler únicamente trabaja cuando la respuesta es XML o un documento HTML. -Para conseguir el contenido crudo de la respuesta, llama a $client->getResponse()->getContent().

            -
            -

            Haz clic en un enlace seleccionándolo primero con el Crawler utilizando una expresión XPath o un selector CSS, luego utiliza el cliente para hacer clic en él. Por ejemplo, el siguiente código buscará todos los enlaces con el texto Greet, a continuación, selecciona el segundo, y en última instancia, hace clic en él:

            -
            $link = $crawler->filter('a:contains("Greet")')->eq(1)->link();
-
-$crawler = $client->click($link);
-
            -
            -

            El envío de un formulario es muy similar; selecciona un botón del formulario, opcionalmente sustituye algunos valores del formulario, y ​​envía el formulario correspondiente:

            -
            $form = $crawler->selectButton('submit')->form();
-
-// sustituye algunos valores
-$form['name'] = 'Lucas';
-$form['form_name[subject]'] = 'Hey there!';
-
-// envía el formulario
-$crawler = $client->submit($form);
-
            -
            -
            -

            Truco

            -

            El formulario también puede manejar archivos subidos y contiene métodos para llenar los diferentes tipos de campos del formulario (por ejemplo, select() y tick()). Para más detalles, consulta la sección Formularios más adelante.

            -
            -

            Ahora que puedes navegar fácilmente a través de una aplicación, utiliza las aserciones para probar que en realidad hace lo que se espera. Utiliza el Crawler para hacer aserciones sobre el DOM:

            -
            // Afirma que la respuesta concuerda con un determinado selector CSS.
-$this->assertGreaterThan(0, $crawler->filter('h1')->count());
-
            -
            -

            O bien, prueba contra el contenido de la respuesta directamente si lo que deseas es acertar que el contenido contiene algún texto, o si la respuesta no es un documento XML o HTML:

            -
            $this->assertRegExp(
-    '/Hello Fabien/',
-    $client->getResponse()->getContent()
-);
-
            -
            - - -
            -
            -
            -

            Trabajando con el Cliente de pruebas

            -

            El Cliente de pruebas simula un cliente HTTP tal como un navegador y hace peticiones a tu aplicación Symfony2:

            -
            $crawler = $client->request('GET', '/hello/Fabien');
-
            -
            -

            El método request() toma el método HTTP y una URL como argumentos y devuelve una instancia de Crawler.

            -

            Utiliza el rastreador para encontrar elementos del DOM en la respuesta. Puedes utilizar estos elementos para hacer clic en los enlaces y presentar formularios:

            -
            $link = $crawler->selectLink('Go elsewhere...')->link();
-$crawler = $client->click($link);
-
-$form = $crawler->selectButton('validate')->form();
-$crawler = $client->submit($form, array('name' => 'Fabien'));
-
            -
            -

            Ambos métodos click() y submit() devuelven un objeto Crawler. -Estos métodos son la mejor manera para navegar por tu aplicación permitiéndole se preocupe de un montón de detalles por ti, tal como detectar el método HTTP de un formulario y proporcionándote una buena API para cargar archivos.

            -
            -

            Truco

            -

            Aprenderás más sobre los objetos Link y Form más adelante en la sección Crawler.

            -
            -

            También puedes usar el método request para simular el envío de formularios directamente o realizar peticiones más complejas:

            -
            // envía un formulario directamente (¡Pero es más fácil usando el 'Crawler'!)
-$client->request('POST', '/submit', array('name' => 'Fabien'));
-
-// Envía una simple cadena JSON en el cuerpo de la petición
-$client->request(
-    'POST',
-    '/submit',
-    array(),
-    array(),
-    array('CONTENT_TYPE' => 'application/json'),
-    '{"name":"Fabien"}'
-);
-
-// envía un formulario con un campo para subir un archivo
-use Symfony\Component\HttpFoundation\File\UploadedFile;
-
-$photo = new UploadedFile(
-    '/ruta/a/foto.jpg',
-    'foto.jpg',
-    'image/jpeg',
-    123
-);
-$client->request(
-    'POST',
-    '/submit',
-    array('name' => 'Fabien'),
-    array('photo' => $photo)
-);
-
-// Realiza una petición DELETE, y pasa las cabeceras HTTP
-$client->request(
-    'DELETE',
-    '/post/12',
-    array(),
-    array(),
-    array('PHP_AUTH_USER' => 'username', 'PHP_AUTH_PW' => 'pa$$word')
-);
-
            -
            -

            Por último pero no menos importante, puedes hacer que cada petición se ejecute en su propio proceso PHP para evitar efectos secundarios cuando se trabaja con varios clientes en el mismo archivo:

            -
            $client->insulate();
-
            -
            - -
            -

            Accediendo a objetos internos

            -

            Si utilizas el cliente para probar tu aplicación, posiblemente quieras acceder a los objetos internos del cliente:

            -
            $history   = $client->getHistory();
-$cookieJar = $client->getCookieJar();
-
            -
            -

            También puedes obtener los objetos relacionados con la última petición:

            -
            $request  = $client->getRequest();
-$response = $client->getResponse();
-$crawler  = $client->getCrawler();
-
            -
            -

            Si tus peticiones no son aisladas, también puedes acceder al Contenedor y al núcleo:

            -
            $container = $client->getContainer();
-$kernel    = $client->getKernel();
-
            -
            -
            -
            -

            Accediendo al contenedor

            -

            Es altamente recomendable que una prueba funcional sólo pruebe la respuesta. Sin embargo, bajo ciertas circunstancias muy raras, posiblemente desees acceder a algunos objetos internos para escribir aserciones. En tales casos, puedes acceder al contenedor de inyección de dependencias:

            -
            $container = $client->getContainer();
-
            -
            -

            Ten en cuenta que esto no tiene efecto si aíslas el cliente o si utilizas una capa HTTP. Para listar todos los servicios disponibles en tu aplicación, utiliza la orden container:debug de la consola.

            -
            -

            Truco

            -

            Si la información que necesitas comprobar está disponible desde el generador de perfiles, úsala en su lugar.

            -
            -
            -
            -

            Accediendo a los datos del perfil

            -

            En cada petición, puedes habilitar el perfilador de Symfony para recolectar datos sobre el -manejo interno de esa petición. Por ejemplo, podrías usar el perfilador para verificar que una determinada página ejecuta menos de un cierto número de consultas a la base de datos al cargarla.

            -

            Para obtener el generador de perfiles de la última petición, haz lo siguiente:

            -
            // habilita el perfilador para la próxima petición
-$client->enableProfiler();
-
-$crawler = $client->request('GET', '/profiler');
-
-// consigue el perfil
-$profile = $client->getProfile();
-
            -
            -

            Para detalles específicos en el uso del generador de perfiles en una prueba, consulta el artículo Cómo utilizar el generador de perfiles en una prueba funcional en el recetario.

            -
            -
            -

            Redirigiendo

            -

            Cuando una petición devuelve una respuesta de redirección, el cliente no la sigue automáticamente. Puedes examinar la Respuesta y después forzar la redirección con el método followRedirect():

            -
            $crawler = $client->followRedirect();
-
            -
            -

            Si quieres que el cliente siga todos los cambios de dirección automáticamente, lo puedes forzar con el método followRedirects():

            -
            $client->followRedirects();
-
            -
            -
            -
            -
            -

            El Crawler

            -

            Cada vez que hagas una petición con el cliente devolverá una instancia del Crawler. -Este nos permite recorrer documentos HTML, seleccionar nodos, encontrar enlaces y formularios.

            -
            -

            Recorriendo

            -

            Al igual que jQuery, el Crawler tiene métodos para recorrer el DOM de un documento HTML/XML: Por ejemplo, el siguiente fragmento encuentra todos los elementos input[type=submit], selecciona el último en la página, y luego selecciona el elemento padre inmediato:

            -
            $newCrawler = $crawler->filter('input[type=submit]')
-    ->last()
-    ->parents()
-    ->first()
-;
-
            -
            -

            Disponemos de muchos otros métodos:

            - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            MétodoDescripción
            filter('h1.title')Nodos que coinciden con el selector CSS
            filterXpath('h1')Nodos que coinciden con la expresión XPath
            eq(1)Nodo para el índice especificado
            first()Primer nodo
            last()Último nodo
            siblings()Hermanos
            nextAll()Todos los hermanos siguientes
            previousAll()Todos los hermanos precedentes
            parents()Devuelve los nodos padre
            children()Devuelve los nodos hijo
            reduce($lambda)Nodos para los cuales el ejecutable no devuelve -false
            -

            Debido a que cada uno de estos métodos devuelve una nueva instancia del Crawler, puedes reducir tu selección de nodos encadenando las llamadas al método:

            -
            $crawler
-    ->filter('h1')
-    ->reduce(function ($node, $i)
-    {
-        if (!$node->getAttribute('class')) {
-                return false;
-        }
-    })
-    ->first();
-
            -
            -
            -

            Truco

            -

            Usa la función count() para obtener el número de nodos almacenados en un Crawler: -count($crawler)

            -
            -
            -
            -

            Extrayendo información

            -

            El Crawler puede extraer información de los nodos:

            -
            // Devuelve el valor del atributo del primer nodo
-$crawler->attr('class');
-
-// Devuelve el valor del nodo para el primer nodo
-$crawler->text();
-
-// Extrae un arreglo de atributos de todos los nodos
-// (_text devuelve el valor del nodo)
-// devuelve un arreglo de cada elemento en 'crawler',
-// cada cual con su valor y href
-$info = $crawler->extract(array('_text', 'href'));
-
-// Ejecuta una función anónima por cada nodo y
-// devuelve un arreglo de resultados
-$data = $crawler->each(function ($node, $i)
-{
-    return $node->attr('href');
-});
-
            -
            -
            -
            -

            Enlaces

            -

            Para seleccionar enlaces, puedes usar los métodos de recorrido anteriores o el conveniente atajo selectLink():

            -
            $crawler->selectLink('Click here');
-
            -
            -

            Este selecciona todos los enlaces que contienen el texto dado, o hace clic en las imágenes en que el atributo alt contiene el texto dado. Al igual que los otros métodos de filtrado, devuelve otro objeto Crawler.

            -

            Una vez seleccionado un enlace, tienes acceso al objeto especial Link, el cual tiene útiles métodos específicos para enlaces (tal como getMethod() y -getUri()). Para hacer clic en el enlace, usa el método click() del cliente suministrando un objeto Link:

            -
            $link = $crawler->selectLink('Click here')->link();
-
-$client->click($link);
-
            -
            -
            -
            -

            Formularios

            -

            Al igual que con cualquier otro enlace, seleccionas el formulario con el método selectButton():

            -
            $buttonCrawlerNode = $crawler->selectButton('submit');
-
            -
            -
            -

            Nota

            -

            Ten en cuenta que seleccionamos botones del formulario y no el formulario porque un formulario puede tener varios botones; si utilizas la API para recorrerlos, ten en cuenta que debes buscar un botón.

            -
            -

            El método selectButton() puede seleccionar etiquetas button y etiquetas input de envío. Este usa diferentes partes de los botones para encontrarlos:

            -
              -
            • El valor del atributo value;
              • -
            • El valor del atributo id o alt de imágenes;
              • -
            • El valor del atributo id o name de las etiquetas button.
              • -
            -

            Una vez que tienes un Crawler que representa un botón, invoca al método form() para obtener la instancia del Formulario del nodo del formulario que envuelve al botón:

            -
            $form = $buttonCrawlerNode->form();
-
            -
            -

            Cuando llamas al método form(), también puedes pasar un arreglo de valores de campo que sustituyan los valores predeterminados:

            -
            $form = $buttonCrawlerNode->form(array(
-    'name'              => 'Fabien',
-    'my_form[subject]'  => 'Symfony rocks!',
-));
-
            -
            -

            Y si quieres simular un método HTTP específico del formulario, pásalo como segundo argumento:

            -
            $form = $buttonCrawlerNode->form(array(), 'DELETE');
-
            -
            -

            El cliente puede enviar instancias de Form:

            -
            $client->submit($form);
-
            -
            -

            Los valores del campo también se pueden pasar como segundo argumento del método submit():

            -
            $client->submit($form, array(
-    'name'              => 'Fabien',
-    'my_form[subject]'  => 'Symfony rocks!',
-));
-
            -
            -

            Para situaciones más complejas, utiliza la instancia de Form como un arreglo para establecer el valor de cada campo individualmente:

            -
            // Cambia el valor de un campo
-$form['name'] = 'Fabien';
-$form['my_form[subject]'] = 'Symfony rocks!';
-
            -
            -

            También hay una buena API para manipular los valores de los campos de acuerdo a su tipo:

            -
            // selecciona una opción o un botón de radio
-$form['country']->select('France');
-
-// marca una casilla de verificación (checkbox)
-$form['like_symfony']->tick();
-
-// carga un archivo
-$form['photo']->upload('/ruta/a/lucas.jpg');
-
            -
            -
            -

            Truco

            -

            Puedes conseguir los valores que se enviarán llamando al método getValues() del objeto Form. Los archivos subidos están disponibles en un arreglo separado devuelto por getFiles(). Los métodos getPhpValues() y getPhpFiles() también devuelven los valores enviados, pero en formato PHP (este convierte las claves en notación con paréntesis cuadrados —por ejemplo, my_form[subject]— a arreglos PHP).

            -
            -
            -
            -
            -

            Probando la configuración

            -

            El cliente utilizado por las pruebas funcionales crea un núcleo que se ejecuta en un entorno de prueba especial. Debido a que Symfony carga el app/config/config_test.yml -en el entorno test, puedes ajustar cualquiera de las opciones de tu aplicación específicamente para pruebas.

            -

            Por ejemplo, por omisión, el swiftmailer está configurado para que en el entorno test no se entregue realmente el correo electrónico. Lo puedes ver bajo la opción de configuración swiftmailer.

            -
            -
              -
            • YAML
              # app/config/config_test.yml
-
-# ...
-swiftmailer:
-    disable_delivery: true
-
              -
              -
              • -
            • XML
              <!-- app/config/config_test.xml -->
-<container>
-    <!-- ... -->
-    <swiftmailer:config disable-delivery="true" />
-</container>
-
              -
              -
              • -
            • PHP
              // app/config/config_test.php
-
-// ...
-$container->loadFromExtension('swiftmailer', array(
-    'disable_delivery' => true,
-));
-
              -
              -
              • -
            -
            -

            Además, puedes usar un entorno completamente diferente, o redefinir el modo de depuración predeterminado (true) pasando cada opción al método createClient():

            -
            $client = static::createClient(array(
-    'environment' => 'my_test_env',
-    'debug'       => false,
-));
-
            -
            -

            Si tu aplicación se comporta de acuerdo a algunas cabeceras HTTP, pásalas como segundo argumento de createClient():

            -
            $client = static::createClient(array(), array(
-    'HTTP_HOST'       => 'en.example.com',
-    'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
-));
-
            -
            -

            También puedes reemplazar cabeceras HTTP en base a la petición:

            -
            $client->request('GET', '/', array(), array(), array(
-    'HTTP_HOST'       => 'en.example.com',
-    'HTTP_USER_AGENT' => 'MySuperBrowser/1.0',
-));
-
            -
            -
            -

            Truco

            -

            El cliente de prueba está disponible como un servicio en el contenedor del entorno test (o cuando está habilitada la opción framework.test). Esto significa que —de ser necesario— puedes redefinir el servicio completamente.

            -
            -
            -

            Configuración de PHPUnit

            -

            Cada aplicación tiene su propia configuración de PHPUnit, almacenada en el archivo phpunit.xml.dist. Puedes editar este archivo para cambiar los valores predeterminados o crear un archivo phpunit.xml para modificar la configuración de tu máquina local.

            -
            -

            Truco

            -

            Guarda el archivo phpunit.xml.dist en tu repositorio de código, e ignora el archivo phpunit.xml.

            -
            -

            De forma predeterminada, la orden PHPUnit sólo ejecuta las pruebas almacenadas en los paquetes «estándar» (las pruebas estándar están en el directorio src/*/Bundle/Tests o src/*/Bundle/*Bundle/Tests), pero fácilmente puedes añadir más directorios. Por ejemplo, la siguiente configuración añade las pruebas de los paquetes de terceros que has instalado:

            -
            <!-- hello/phpunit.xml.dist -->
-<testsuites>
-    <testsuite name="Batería de pruebas del proyecto">
-        <directory>../src/*/*Bundle/Tests</directory>
-        <directory>../src/Acme/Bundle/*Bundle/Tests</directory>
-    </testsuite>
-</testsuites>
-
            -
            -

            Para incluir otros directorios en la cobertura de código, también edita la sección <filter>:

            -
            <!-- ... -->
-<filter>
-    <whitelist>
-        <directory>../src</directory>
-        <exclude>
-            <directory>../src/*/*Bundle/Resources</directory>
-            <directory>../src/*/*Bundle/Tests</directory>
-            <directory>../src/Acme/Bundle/*Bundle/Resources</directory>
-            <directory>../src/Acme/Bundle/*Bundle/Tests</directory>
-        </exclude>
-    </whitelist>
-</filter>
-
            -
            -
            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/translation.html b/book/translation.html deleted file mode 100644 index dd12e0f..0000000 --- a/book/translation.html +++ /dev/null @@ -1,871 +0,0 @@ - - - - - - - Traduciendo — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Traduciendo

            -

            El término «internacionalización» (frecuentemente abreviado como i18n) se refiere al proceso de abstraer cadenas y otros elementos específicos de la configuración regional de tu aplicación a una capa donde se puedan traducir y convertir basándose en la configuración regional del usuario (es decir, idioma y país). Para el texto, esto significa envolver cada uno con una función capaz de traducir el texto (o «mensaje») al idioma del usuario:

            -
            // el texto *siempre* se imprime en Inglés
-echo 'Hello World';
-
-// el texto se puede traducir al idioma del
-// usuario final o predeterminado en Inglés
-echo $translator->trans('Hello World');
-
            -
            -
            -

            Nota

            -

            El término locale se refiere más o menos al lenguaje y país del usuario. Este puede ser cualquier cadena que tu aplicación utilice para manejar las traducciones y otras diferencias de formato (por ejemplo, el formato de moneda). Recomendamos el código de idioma ISO639-1, un guión bajo (_), luego el código de país ISO3166 Alpha-2 (p. ej. fr_FR para Francés/Francia).

            -
            -

            En este capítulo, aprenderas cómo preparar una aplicación para apoyar varias configuraciones regionales, y luego, cómo crear traducciones para múltiples regiones. En general, el proceso tiene varios pasos comunes:

            -
              -
            1. Habilitar y configurar el componente Translation de Symfony;
              2. -
            2. Abstraer cadenas (es decir, «mensajes») envolviéndolas en llamadas al Traductor;
              3. -
            3. Crear recursos de traducción para cada configuración regional compatible, la cual traduce cada mensaje en la aplicación;
              4. -
            4. Determinar, establecer y administrar la configuración regional del usuario para la petición y, opcionalmente, la sesión entera.
              5. -
            -
            -

            Configurando

            -

            La traducción está a cargo de un servicio Traductor que utiliza la configuración regional del usuario para buscar y devolver mensajes traducidos. Antes de usarlo, habilita el Traductor en tu configuración:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    translator: { fallback: en }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config>
-    <framework:translator fallback="en" />
-</framework:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    'translator' => array('fallback' => 'en'),
-));
-
              -
              -
              • -
            -
            -

            La opción fallback define la configuración regional de reserva cuando la traducción no existe en la configuración regional del usuario.

            -
            -

            Truco

            -

            Cuando la traducción no existe para una configuración regional, el traductor primero intenta encontrar la traducción para el idioma («es» si la región es «es_MX» por ejemplo). Si esto también falla, busca una traducción utilizando la configuración regional de reserva.

            -
            -

            La región utilizada en las traducciones es la almacenada en la petición. Esta, normalmente se establece en el atributo _locale de tus rutas (ve Locale y la URL).

            -
            -
            -

            Traducción básica

            -

            La traducción de texto se hace a través del servicio traductor (Symfony\Component\Translation\Translator). Para traducir un bloque de texto (llamado un mensaje), utiliza el método trans(). Supongamos, por ejemplo, que estás traduciendo un simple mensaje desde el interior de un controlador:

            -
            // ...
-use Symfony\Component\HttpFoundation\Response;
-
-public function indexAction()
-{
-    $t = $this->get('translator')->trans('Symfony2 is great');
-
-    return new Response($t);
-}
-
            -
            -

            Al ejecutar este código, Symfony2 tratará de traducir el mensaje «Symfony2 is great», basándose en la variable locale del usuario. Para que esto funcione, tenemos que decirle a Symfony2 la manera de traducir el mensaje a través de un «recurso de traducción», el cual es una colección de mensajes traducidos para una determinada configuración regional. -Este «diccionario» de traducciones se puede crear en varios formatos diferentes, XLIFF es el formato recomendado:

            -
            -
              -
            • XML
              <!-- messages.fr.xliff -->
-<?xml version="1.0"?>
-<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-    <file source-language="en" datatype="plaintext" original="file.ext">
-            <body>
-            <trans-unit id="1">
-                <source>Symfony2 is great</source>
-                <target>J'aime Symfony2</target>
-            </trans-unit>
-        </body>
-    </file>
-</xliff>
-
              -
              -
              • -
            • PHP
              // messages.fr.php
-return array(
-    'Symfony2 is great' => 'J\'aime Symfony2',
-);
-
              -
              -
              • -
            • YAML
              # messages.fr.yml
-Symfony2 is great: J'aime Symfony2
-
              -
              -
              • -
            -
            -

            Ahora, si el idioma de la configuración regional del usuario es el Francés (por ejemplo, fr_FR o fr_BE), el mensaje será traducido a J'aime Symfony2.

            -
            -

            El proceso de traducción

            -

            Para empezar a traducir el mensaje, Symfony2 utiliza un sencillo proceso:

            -
              -
            • Determina la región del usuario actual, la cual está almacenada en la petición (o almacenada como locale en la sesión del usuario);
              • -
            • Carga un catálogo de mensajes traducidos desde los recursos de traducción definidos para la configuración de locale (por ejemplo, fr_FR). Los mensajes de la configuración regional de reserva también se cargan y se agregan al catálogo si no existen ya. El resultado final es un gran «diccionario» de traducciones. Consulta Catálogos de mensajes para más detalles;
              • -
            • Si se encuentra el mensaje en el catálogo, devuelve la traducción. En caso contrario, el traductor devuelve el mensaje original.
              • -
            -

            Cuando se usa el método trans(), Symfony2 busca la cadena exacta dentro del catálogo de mensajes apropiado y la devuelve (si existe).

            -
            -
            -

            Marcadores de posición en mensajes

            -

            A veces, debes traducir un mensaje que contiene una variable:

            -
            // ...
-use Symfony\Component\HttpFoundation\Response;
-
-public function indexAction($name)
-{
-    $t = $this->get('translator')->trans('Hello '.$name);
-
-    return new Response($t);
-}
-
            -
            -

            Sin embargo, la creación de una traducción de esta cadena es imposible, ya que el traductor tratará de buscar el mensaje exacto, incluyendo las porciones variables (por ejemplo, «Hello Ryan» o «Hello Fabien»). En lugar de escribir una traducción de cada posible iteración de la variable $name, podemos reemplazar la variable con un «marcador de posición»:

            -
            // ...
-use Symfony\Component\HttpFoundation\Response;
-
-public function indexAction($name)
-{
-    $t = $this->get('translator')->trans(
-        'Hello %name%',
-        array('%name%' => $name)
-    );
-
-    return new Response($t);
-}
-
            -
            -

            Symfony2 ahora busca una traducción del mensaje en bruto (Hello %name%) y después reemplaza los marcadores de posición con sus valores. La creación de una traducción se hace igual que antes:

            -
            -
              -
            • XML
              <!-- messages.fr.xliff -->
-<?xml version="1.0"?>
-<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-    <file source-language="en" datatype="plaintext" original="file.ext">
-            <body>
-            <trans-unit id="1">
-                <source>Hello %name%</source>
-                <target>Bonjour %name%</target>
-            </trans-unit>
-        </body>
-    </file>
-</xliff>
-
              -
              -
              • -
            • PHP
              // messages.fr.php
-return array(
-    'Hello %name%' => 'Bonjour %name%',
-);
-
              -
              -
              • -
            • YAML
              # messages.fr.yml
-'Hello %name%': Bonjour %name%
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Los marcadores de posición pueden tomar cualquier forma, el mensaje completo se reconstruye usando la función strtr de PHP. Sin embargo, se requiere la notación %var% cuando se traduce en plantillas Twig, y en general es un convenio razonable a seguir.

            -
            -

            Como ya viste, la creación de una traducción es un proceso de dos pasos:

            -
              -
            1. Abstraer el mensaje que se necesita traducir procesándolo con el Traductor.
              2. -
            2. Crear una traducción del mensaje para cada región que elijas apoyar.
              3. -
            -

            El segundo paso se realiza creando catálogos de mensajes que definen las traducciones para cualquier número de regiones diferentes.

            -
            -
            -
            -

            Catálogos de mensajes

            -

            Cuando se traduce un mensaje, Symfony2 compila un catálogo de mensajes para la configuración regional del usuario y busca en ese una traducción del mensaje. Un catálogo de mensajes es como un diccionario de traducciones para una configuración regional específica. Por ejemplo, el catálogo de la configuración regional fr_FR podría contener la siguiente traducción:

            -
            Symfony2 is Great => J'aime Symfony2
-
            -
            -

            Es responsabilidad del desarrollador (o traductor) de una aplicación internacionalizada crear estas traducciones. Las traducciones son almacenadas en el sistema de archivos y descubiertas por Symfony, gracias a algunos convenios.

            -
            -

            Truco

            -

            Cada vez que creas un nuevo recurso de traducción (o instalas un paquete que incluye un recurso de traducción), para que Symfony pueda descubrir el nuevo recurso de traducción, asegúrate de borrar la caché con la siguiente orden:

            -
            $ php app/console cache:clear
-
            -
            -
            -
            -

            Ubicación de traducción y convenciones de nomenclatura

            -

            Symfony2 busca archivos de mensajes (es decir, traducciones) en los siguientes lugares:

            -
              -
            • el <directorio raíz del núcleo>/Resources/translations;
              • -
            • el <directorio raíz del núcleo>/Resources/<nombre paquete>/translations;
              • -
            • el directorio Resources/translations/ del paquete.
              • -
            -

            Las ubicaciones están enumeradas basándose en su prioridad. Por lo tanto puedes -redefinir la traducción de los mensajes de un paquete en cualquiera de los 2 directorios superiores.

            -

            El mecanismo de sustitución trabaja a nivel de claves: sólo es necesario enumerar las claves remplazadas en un archivo de mensajes de alta prioridad. Cuando una clave no se encuentra en un archivo de mensajes, el traductor automáticamente vuelve a los archivos de mensajes de reserva de menor prioridad.

            -

            El nombre del archivo de las traducciones también es importante ya que Symfony2 utiliza una convención para determinar los detalles sobre las traducciones. Cada archivo de mensaje se tiene que denominar de acuerdo a la siguiente ruta: dominio.región.cargador:

            -
              -
            • dominio: Una forma opcional para organizar los mensajes en grupos (por ejemplo, admin, navigation o el valor predeterminado messages) — consulta Usando el dominio de los mensajes;
              • -
            • región: La región para la cual son las traducciones (por ejemplo, «en_GB», «en», etc.);
              • -
            • cargador: ¿Cómo debe cargar y analizar el archivo Symfony2 (por ejemplo, XLIFF, php o yml).
              • -
            -

            El cargador puede ser el nombre de cualquier gestor registrado. De manera predeterminada, Symfony incluye los siguientes cargadores:

            -
              -
            • xliff: archivo XLIFF;
              • -
            • php: archivo PHP;
              • -
            • yml: archivo YAML.
              • -
            -

            La elección del cargador a utilizar es totalmente tuya y es una cuestión de gusto.

            -
            -

            Nota

            -

            También puedes almacenar las traducciones en una base de datos, o cualquier otro almacenamiento, proporcionando una clase personalizada que implemente la interfaz Symfony\Component\Translation\Loader\LoaderInterface.

            -
            -
            -
            -

            Creando traducciones

            -
            -
            El acto de crear archivos de traducción es una parte importante de la «localización» (a menudo abreviado L10n). Los archivos de traducción constan de una serie de pares Identificador-traducción para un determinado dominio y configuración regional.
            -
            La fuente es el identificador para la traducción individual, y puede ser el mensaje en la región principal (por ejemplo «Symfony is great») de tu aplicación o un identificador único (por ejemplo, «symfony2.great» —ve la barra lateral más abajo—):
            -
            -
            -
              -
            • XML
              <!-- src/Acme/DemoBundle/Resources/translations/messages.fr.xliff -->
-<?xml version="1.0"?>
-<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-    <file source-language="en" datatype="plaintext" original="file.ext">
-            <body>
-            <trans-unit id="1">
-                <source>Symfony2 is great</source>
-                <target>J'aime Symfony2</target>
-            </trans-unit>
-            <trans-unit id="2">
-                <source>symfony2.great</source>
-                <target>J'aime Symfony2</target>
-            </trans-unit>
-        </body>
-    </file>
-</xliff>
-
              -
              -
              • -
            • PHP
              // src/Acme/DemoBundle/Resources/translations/messages.fr.php
-return array(
-    'Symfony2 is great' => 'J\'aime Symfony2',
-    'symfony2.great'    => 'J\'aime Symfony2',
-);
-
              -
              -
              • -
            • YAML
              # src/Acme/DemoBundle/Resources/translations/messages.fr.yml
-Symfony2 is great: J'aime Symfony2
-symfony2.great:    J'aime Symfony2
-
              -
              -
              • -
            -
            -

            Symfony2 descubrirá estos archivos y los utilizará cuando traduce o bien «Symfony2 is great» o «symfony2.great» en un idioma regional de Francés (por ejemplo, fr_FR o fr_BE).

            -
            -

            Usar mensajes reales o palabras clave

            -

            Este ejemplo ilustra las dos diferentes filosofías cuando creas mensajes a traducir:

            -
            $t = $translator->trans('Symfony2 is great');
-
-$t = $translator->trans('symfony2.great');
-
            -
            -

            En el primer método, los mensajes están escritos en el idioma de la región predeterminada (Inglés en este caso). Ese mensaje se utiliza entonces como el «id» al crear traducciones.

            -

            En el segundo método, los mensajes en realidad son «palabras clave» que transmiten la idea del mensaje. Entonces, la palabra clave del mensaje se utiliza como el «id» para las traducciones. En este caso, la traducción se debe hacer para la región predeterminada (es decir, para traducir symfony2.great a Symfony2 is great).

            -

            El segundo método es útil porque la clave del mensaje no se tendrá que cambiar en cada archivo de la traducción si decides que el mensaje en realidad debería decir «Ciertamente Symfony2 es magnífico» en la región predeterminada.

            -

            La elección del método a utilizar es totalmente tuya, pero a menudo se recomienda el formato de «palabra clave».

            -

            Además, es compatible con archivos anidados en formato php y yaml para evitar repetir siempre lo mismo si utilizas palabras clave en lugar de texto real para tus identificadores:

            -
            -
              -
            • YAML
              symfony2:
-    is:
-        great: Symfony2 is great
-        amazing: Symfony2 is amazing
-    has:
-        bundles: Symfony2 has bundles
-user:
-    login: Login
-
              -
              -
              • -
            • PHP
              return array(
-    'symfony2' => array(
-        'is' => array(
-            'great'   => 'Symfony2 is great',
-            'amazing' => 'Symfony2 is amazing',
-        ),
-        'has' => array(
-            'bundles' => 'Symfony2 has bundles',
-        ),
-    ),
-    'user' => array(
-        'login' => 'Login',
-    ),
-);
-
              -
              -
              • -
            -
            -

            Los niveles múltiples se acoplan en pares de id/traducción añadiendo un punto (.) entre cada nivel, por lo tanto los ejemplos anteriores son equivalentes a los siguientes:

            -
            -
              -
            • YAML
              symfony2.is.great: Symfony2 is great
-symfony2.is.amazing: Symfony2 is amazing
-symfony2.has.bundles: Symfony2 has bundles
-user.login: Login
-
              -
              -
              • -
            • PHP
              return array(
-    'symfony2.is.great' => 'Symfony2 is great',
-    'symfony2.is.amazing' => 'Symfony2 is amazing',
-    'symfony2.has.bundles' => 'Symfony2 has bundles',
-    'user.login' => 'Login',
-);
-
              -
              -
              • -
            -
            -
            -
            -
            -
            -

            Usando el dominio de los mensajes

            -

            Como ya viste, los archivos de mensajes se organizan en las diferentes regiones en que se traducirán. Los archivos de mensajes también se pueden organizar en «dominios». -Al crear archivos de mensajes, el dominio es la primera porción del nombre de archivo. -El dominio predeterminado es messages. Por ejemplo, supongamos que, por organización, las traducciones se dividieron en tres diferentes dominios: messages, admin -y navigation. La traducción española debe tener los siguientes archivos de mensaje:

            -
              -
            • messages.es.xliff
              • -
            • admin.es.xliff
              • -
            • navigation.es.xliff
              • -
            -

            Al traducir las cadenas que no están en el dominio predeterminado (messages), debes especificar el dominio como tercer argumento de trans():

            -
            $this->get('translator')->trans('Symfony2 is great', array(), 'admin');
-
            -
            -

            Symfony2 ahora buscará el mensaje en el dominio admin de la configuración regional del usuario.

            -
            -
            -

            Manejando la configuración regional del usuario

            -

            La configuración regional del usuario actual se almacena en la petición y se puede acceder a través del objeto Petición:

            -
            // accede al objeto request en un controlador estándar
-$request = $this->getRequest();
-
-$locale = $request->getLocale();
-
-$request->setLocale('en_US');
-
            -
            -

            También es posible almacenar la región en la sesión en lugar de en base a cada petición. Si lo haces, cada subsecuente petición tendrá esa región.

            -
            $this->get('session')->set('_locale', 'en_US');
-
            -
            -

            En la sección Locale y la URL, más adelante, puedes ver cómo configurar la región a través del enrutado.

            -
            -

            Configuración regional predeterminada y reserva

            -

            Si la configuración regional no se ha establecido explícitamente en la sesión, el parámetro de configuración fallback_locale será utilizado por el Traductor. El valor predeterminado del parámetro es «en» (consulta la sección Configurando).

            -

            Alternativamente, puedes garantizar que hay una región establecida en cada petición definiendo una opción default_locale en la clave framework:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    default_locale: en
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config>
-    <framework:default-locale>en</framework:default-locale>
-</framework:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    'default_locale' => 'en',
-));
-
              -
              -
              • -
            -
            -

            -Nuevo en la versión 2.1: El parámetro default_locale originalmente se definía bajo la clave session, sin embargo, se movió en la versión 2.1. Esto se debe a que la región ahora se establece en la petición en lugar de en la sesión.

            -
            -
            -

            Locale y la URL

            -

            Dado que la configuración regional del usuario se almacena en la sesión, puede ser tentador utilizar la misma URL para mostrar un recurso en muchos idiomas diferentes en función de la región del usuario. Por ejemplo, http://www.ejemplo.com/contact podría mostrar el contenido en Inglés para un usuario y en Francés para otro. Por desgracia, esto viola una norma fundamental de la Web: que una URL particular devuelve el mismo recurso, independientemente del usuario. Para acabar de enturbiar el problema, ¿cual sería la versión del contenido indexado por los motores de búsqueda?

            -

            Una mejor política es incluir la configuración regional en la URL. Esto es totalmente compatible con el sistema de enrutado mediante el parámetro especial _locale:

            -
            -
              -
            • YAML
              contact:
-    path:      /{_locale}/contact
-    defaults:  { _controller: AcmeDemoBundle:Contact:index, _locale: en }
-    requirements:
-        _locale: en|fr|de
-
              -
              -
              • -
            • XML
              <route id="contact" path="/{_locale}/contact">
-    <default key="_controller">AcmeDemoBundle:Contact:index</default>
-    <default key="_locale">en</default>
-    <requirement key="_locale">en|fr|de</requirement>
-</route>
-
              -
              -
              • -
            • PHP
              use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('contact', new Route('/{_locale}/contact', array(
-    '_controller' => 'AcmeDemoBundle:Contact:index',
-    '_locale'     => 'en',
-), array(
-    '_locale'     => 'en|fr|de',
-)));
-
-return $collection;
-
              -
              -
              • -
            -
            -

            Cuando utilizas el parámetro especial _locale en una ruta, la configuración regional emparejada automáticamente se establece en la sesión del usuario. En otras palabras, si un usuario visita la URI /es/contact, la región «es» se ajustará automáticamente según la configuración regional de la sesión del usuario.

            -

            Ahora puedes utilizar la configuración regional del usuario para crear rutas hacia otras páginas traducidas en tu aplicación.

            -
            -
            -
            -

            Pluralizando

            -

            La pluralización de mensajes es un tema difícil puesto que las reglas pueden ser bastante complejas. Por ejemplo, aquí tienes la representación matemática de las reglas de pluralización de Rusia:

            -
            (($number % 10 == 1) && ($number % 100 != 11))
-    ? 0
-    : ((($number % 10 >= 2)
-        && ($number % 10 <= 4)
-        && (($number % 100 < 10)
-        || ($number % 100 >= 20)))
-            ? 1
-            : 2
-);
-
            -
            -

            Como puedes ver, en Ruso, puedes tener tres formas diferentes del plural, dando a cada una un índice de 0, 1 o 2. Para todas las formas, el plural es diferente, por lo que la traducción también es diferente.

            -

            Cuando una traducción tiene diferentes formas debido a la pluralización, puedes proporcionar todas las formas como una cadena separada por una línea vertical (|):

            -
            'Hay una manzana|Hay %count% manzanas'
-
            -
            -

            Para traducir mensajes pluralizados, utiliza el método transChoice():

            -
            $t = $this->get('translator')->transChoice(
-    'There is one apple|There are %count% apples',
-    10,
-    array('%count%' => 10)
-);
-
            -
            -

            El segundo argumento (10 en este ejemplo), es el número de objetos descrito y se utiliza para determinar cual traducción usar y también para rellenar el marcador de posición %count%.

            -

            En base al número dado, el traductor elige la forma plural adecuada. -En Inglés, la mayoría de las palabras tienen una forma singular cuando hay exactamente un objeto y una forma plural para todos los otros números (0, 2, 3...). Así pues, si count es 1, el traductor utilizará la primera cadena (Hay una manzana) como la traducción. De lo contrario, utilizará Hay %count% manzanas.

            -

            Aquí está la traducción al Francés:

            -
            'Il y a %count% pomme|Il y a %count% pommes'
-
            -
            -

            Incluso si la cadena tiene una apariencia similar (se compone de dos subcadenas separadas por una línea vertical), las reglas francesas son diferentes: la primera forma (no plural) se utiliza cuando count es 0 o 1. Por lo tanto, el traductor utilizará automáticamente la primera cadena (Il y a %count% pomme) cuando count es 0 o 1.

            -

            Cada región tiene su propio conjunto de reglas, con algunas que tienen hasta seis formas diferentes de plural con reglas complejas detrás de las cuales los números asignan a tal forma plural. -Las reglas son bastante simples para Inglés y Francés, pero para el Ruso, puedes querer una pista para saber qué regla coincide con qué cadena. Para ayudar a los traductores, puedes «etiquetar» cada cadena:

            -
            'one: There is one apple|some: There are %count% apples'
-
-'none_or_one: Il y a %count% pomme|some: Il y a %count% pommes'
-
            -
            -

            Las etiquetas realmente son pistas sólo para los traductores y no afectan a la lógica utilizada para determinar qué forma plural usar. Las etiquetas pueden ser cualquier cadena descriptiva que termine con dos puntos (:). Las etiquetas además no necesitan ser las mismas en el mensaje original cómo en la traducción.

            -
            -

            Truco

            -

            Como las etiquetas son opcionales, el traductor no las utiliza (el traductor únicamente obtendrá una cadena basada en su posición en la cadena).

            -
            -
            -

            Intervalo explícito de pluralización

            -

            La forma más fácil de pluralizar un mensaje es dejar que Symfony2 utilice su lógica interna para elegir qué cadena se utiliza en base a un número dado. A veces, tendrás más control o quieres una traducción diferente para casos específicos (por 0, o cuando el número es negativo, por ejemplo). Para estos casos, puedes utilizar intervalos matemáticos explícitos:

            -
            '{0} There are no apples|{1} There is one apple|]1,19] There are %count% apples|[20,Inf] There are many apples'
-
            -
            -

            Los intervalos siguen la notación ISO 31-11. La cadena anterior especifica cuatro intervalos diferentes: exactamente 0, exactamente 1, 2-19 y 20 y superior.

            -

            También puedes mezclar reglas matemáticas explícitas y estándar. En este caso, si la cuenta no corresponde con un intervalo específico, las reglas estándar entran en vigor después de remover las reglas explícitas:

            -
            '{0} There are no apples|[20,Inf] There are many apples|There is one apple|a_few: There are %count% apples'
-
            -
            -

            Por ejemplo, para 1 apple, la regla estándar There is one apple será utilizada. Para 2-19 apples, la segunda regla estándar There are %count% -apples será seleccionada.

            -

            Un Symfony\Component\Translation\Interval puede representar un conjunto finito de números:

            -
            {1,2,3,4}
-
            -
            -

            O números entre otros dos números:

            -
            [1, +Inf[
-]-1,2[
-
            -
            -

            El delimitador izquierdo puede ser [ (inclusive) o ] (exclusivo). El delimitador derecho puede ser [ (exclusivo) o ] (inclusive). Más allá de los números, puedes usar -Inf y +Inf para el infinito.

            -
            -
            -
            -

            Traducciones en plantillas

            -

            La mayoría de las veces, la traducción ocurre en las plantillas. Symfony2 proporciona apoyo nativo para ambas plantillas Twig y PHP.

            -
            -

            Plantillas Twig

            -

            Symfony2 proporciona etiquetas Twig especializadas (trans y transchoice) para ayudar con la traducción de los mensajes de bloques de texto estático:

            -
            {% trans %}Hello %name%{% endtrans %}
-
-{% transchoice count %}
-    {0} There are no apples|{1} There is one apple|]1,Inf] There are %count% apples
-{% endtranschoice %}
-
            -
            -

            La etiqueta transchoice obtiene automáticamente la variable %count% a partir del contexto actual y la pasa al traductor. Este mecanismo sólo funciona cuando se utiliza un marcador de posición después del patrón %var%.

            -
            -

            Truco

            -

            Si necesitas utilizar el carácter de porcentaje (%) en una cadena, lo tienes que escapar duplicando el siguiente: {% trans %}Porcentaje: %percent%%%{% endtrans %}

            -
            -

            También puedes especificar el dominio del mensaje y pasar algunas variables adicionales:

            -
            {% trans with {'%name%': 'Fabien'} from "app" %}Hello %name%{% endtrans %}
-
-{% trans with {'%name%': 'Fabien'} from "app" into "fr" %}Hello %name%{% endtrans %}
-
-{% transchoice count with {'%name%': 'Fabien'} from "app" %}
-    {0} %name%, there are no apples|{1} %name%, there is one apple|]1,Inf] %name%, there are %count% apples
-{% endtranschoice %}
-
            -
            -

            Los filtros trans y transchoice se pueden utilizar para traducir texto variable y expresiones complejas:

            -
            {{ message|trans }}
-
-{{ message|transchoice(5) }}
-
-{{ message|trans({'%name%': 'Fabien'}, "app") }}
-
-{{ message|transchoice(5, {'%name%': 'Fabien'}, 'app') }}
-
            -
            -
            -

            Truco

            -

            Usar etiquetas de traducción o filtros tiene el mismo efecto, pero con una sutil diferencia: la salida escapada automáticamente sólo se aplica a las traducciones usando un filtro. En otras palabras, si necesitas garantizar que tu traducción no se escape en la salida, debes aplicar el filtro raw después del filtro de traducción:

            -
            {# el texto traducido entre etiquetas nunca se escapa #}
-{% trans %}
-    <h3>foo</h3>
-{% endtrans %}
-
-{% set message = '<h3>foo</h3>' %}
-
-{# Las cadenas y variables traducidas vía un filtro se escapan por omisión #}
-{{ message|trans|raw }}
-{{ '<h3>bar</h3>'|trans|raw }}
-
            -
            -
            -
            -

            Truco

            -

            Puedes establecer el ámbito de traducción para una plantilla Twig entera con una sola etiqueta:

            -
            {% trans_default_domain "app" %}
-
            -
            -

            Ten en cuenta que esto sólo influye en la plantilla actual, no en las plantillas «incluidas» (con el fin de evitar efectos secundarios).

            -
            -

            -Nuevo en la versión 2.1: La etiqueta trans_default_domain es nueva en Symfony2.1

            -
            -
            -

            Plantillas PHP

            -

            El servicio traductor es accesible en plantillas PHP a través del ayudante translator:

            -
            <?php echo $view['translator']->trans('Symfony2 is great') ?>
-
-<?php echo $view['translator']->transChoice(
-    '{0} There is no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-    10,
-    array('%count%' => 10)
-) ?>
-
            -
            -
            -
            -
            -

            Forzando la configuración regional del traductor

            -

            Al traducir un mensaje, Symfony2 utiliza la configuración regional de la petición o la configuración regional de reserva si es necesario. También puedes especificar manualmente la configuración regional utilizada para la traducción:

            -
            $this->get('translator')->trans(
-    'Symfony2 is great',
-    array(),
-    'messages',
-    'fr_FR'
-);
-
-$this->get('translator')->transChoice(
-    '{0} There are no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
-    10,
-    array('%count%' => 10),
-    'messages',
-    'fr_FR'
-);
-
            -
            -
            -
            -

            Traduciendo contenido de base de datos

            -

            La traducción del contenido de la base de datos la debe manejar Doctrine a través de la Extensión Translatable. Para más información, consulta la documentación de la biblioteca.

            -
            -
            -

            Traduciendo mensajes de restricción

            -

            La mejor manera de entender la traducción de las restricciones es verla en acción. Para empezar, supongamos que creaste un sencillo objeto PHP el cual en algún lugar tiene que utilizar tu aplicación:

            -
            // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-class Author
-{
-    public $name;
-}
-
            -
            -

            Añade las restricciones con cualquiera de los métodos admitidos. Configura la opción de mensaje al texto fuente traducido. Por ejemplo, para garantizar que la propiedad $name no esté vacía, agrega lo siguiente:

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        name:
-            - NotBlank: { message: "author.name.not_blank" }
-
              -
              -
              • -
            • Annotations
              // src/Acme/BlogBundle/Entity/Author.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\NotBlank(message = "author.name.not_blank")
-     */
-    public $name;
-}
-
              -
              -
              • -
            • XML
              <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-    <class name="Acme\BlogBundle\Entity\Author">
-        <property name="name">
-            <constraint name="NotBlank">
-                <option name="message">author.name.not_blank</option>
-            </constraint>
-        </property>
-    </class>
-</constraint-mapping>
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\NotBlank;
-
-class Autor
-{
-    public $name;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('name', new NotBlank(array(
-            'message' => 'author.name.not_blank',
-        )));
-    }
-}
-
              -
              -
              • -
            -
            -

            Crea un archivo de traducción bajo el catálogo validators para los mensajes de restricción, por lo general en el directorio Resources/translations/ del paquete. Consulta Catálogos de mensajes para más detalles;

            -
            -
              -
            • XML
              <!-- validators.en.xliff -->
-<?xml version="1.0"?>
-<xliff version="1.2" xmlns="urn:oasis:names:tc:xliff:document:1.2">
-    <file source-language="en" datatype="plaintext" original="file.ext">
-            <body>
-            <trans-unit id="1">
-                <source>author.name.not_blank</source>
-                <target>Por favor, ingresa un nombre de autor.</target>
-            </trans-unit>
-        </body>
-    </file>
-</xliff>
-
              -
              -
              • -
            • PHP
              // validators.en.php
-return array(
-    'author.name.not_blank' => 'Por favor, ingresa un nombre de autor.',
-);
-
              -
              -
              • -
            • YAML
              # validators.en.yml
-author.name.not_blank: Por favor, ingresa un nombre de autor..
-
              -
              -
              • -
            -
            -
            -
            -

            Resumen

            -

            Con el componente Translation de Symfony2, la creación de una aplicación internacionalizada ya no tiene que ser un proceso doloroso y se reduce a sólo algunos pasos básicos:

            -
              -
            • Abstrae los mensajes en tu aplicación envolviendo cada uno en el método trans() o transChoice();
              • -
            • Traduce cada mensaje en varias configuraciones regionales creando archivos de mensajes traducidos. Symfony2 descubre y procesa cada archivo porque su nombre sigue una convención específica;
              • -
            • Gestiona la región del usuario, la cual está almacenada en la petición, pero también se puede poner en la sesión del usuario.
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/book/validation.html b/book/validation.html deleted file mode 100644 index f198da2..0000000 --- a/book/validation.html +++ /dev/null @@ -1,900 +0,0 @@ - - - - - - - Validando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Validando

            -

            La validación es una tarea muy común en aplicaciones web. Los datos introducidos en formularios se tienen que validar. Los datos también se deben validar antes de escribirlos en una base de datos o pasarlos a un servicio web.

            -

            Symfony2 viene con un componente Validator que facilita y transparenta esta tarea. Este componente está basado en la especificación de validación Bean JSR303.

            -
            -

            Fundamentos de la validación

            -

            La mejor manera de entender la validación es verla en acción. Para empezar, supongamos que creaste un objeto PHP plano el cual en algún lugar tiene que utilizar tu aplicación:

            -
            // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-class Author
-{
-    public $name;
-}
-
            -
            -

            Hasta ahora, esto es sólo una clase ordinaria que sirve a algún propósito dentro de tu aplicación. El objetivo de la validación es decir si o no los datos de un objeto son válidos. Para que esto funcione, debes configurar una lista de reglas (llamada constraints —en adelante: restricciones—) que el objeto debe seguir para ser válido. Estas reglas se pueden especificar a través de una serie de diferentes formatos (YAML, XML, anotaciones o PHP).

            -

            Por ejemplo, para garantizar que la propiedad $name no esté vacía, agrega lo siguiente:

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        name:
-            - NotBlank: ~
-
              -
              -
              • -
            • Annotations
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\NotBlank()
-     */
-    public $name;
-}
-
              -
              -
              • -
            • XML
              <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-    <class name="Acme\BlogBundle\Entity\Author">
-        <property name="name">
-            <constraint name="NotBlank" />
-        </property>
-    </class>
-</constraint-mapping>
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\NotBlank;
-
-class Autor
-{
-    public $name;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('name', new NotBlank());
-    }
-}
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Las propiedades protegidas y privadas también se pueden validar, así como los métodos «get» (consulta la sección Objetivos de restricción).

            -
            -
            -

            Usando el servicio validador

            -

            A continuación, para validar realmente un objeto Author, utiliza el método validate del servicio validador (clase Symfony\Component\Validator\Validator). -El trabajo del validador es fácil: lee las restricciones (es decir, las reglas) de una clase y comprueba si los datos en el objeto satisfacen esas restricciones. Si la validación falla, devuelve un arreglo de errores. Toma este sencillo ejemplo desde el interior de un controlador:

            -
            // ...
-use Symfony\Component\HttpFoundation\Response;
-use Acme\BlogBundle\Entity\Author;
-
-public function indexAction()
-{
-    $author = new Author();
-    // ... hace algo con el objeto $author
-
-    $validator = $this->get('validator');
-    $errors = $validator->validate($author);
-
-    if (count($errors) > 0) {
-        return new Response(print_r($errors, true));
-    } else {
-        return new Response('The author is valid! Yes!');
-    }
-}
-
            -
            -

            Si la propiedad $name está vacía, verás el siguiente mensaje de error:

            -
            Acme\BlogBundle\Author.name:
-    This value should not be blank
-
            -
            -

            Si insertas un valor en la propiedad name, aparecerá el satisfactorio mensaje de éxito.

            -
            -

            Truco

            -

            La mayor parte del tiempo, no interactúas directamente con el servicio validador o necesitas preocuparte por imprimir los errores. La mayoría de las veces, vas a utilizar la validación indirectamente al manejar los datos de formularios presentados. Para más información, consulta la sección Validación y formularios.

            -
            -

            También puedes pasar la colección de errores a una plantilla.

            -
            if (count($errors) > 0) {
-    return $this->render('AcmeBlogBundle:Author:validate.html.twig', array(
-        'errors' => $errors,
-    ));
-} else {
-    // ...
-}
-
            -
            -

            Dentro de la plantilla, puedes sacar la lista de errores exactamente como la necesites:

            -
            -
              -
            • Twig
              {# src/Acme/BlogBundle/Resources/views/Autor/validate.html.twig #}
-<h3>The author has the following errors</h3>
-<ul>
-{% for error in errors %}
-    <li>{{ error.message }}</li>
-{% endfor %}
-</ul>
-
              -
              -
              • -
            • PHP
              <!-- src/Acme/BlogBundle/Resources/views/Autor/validar.html.php -->
-<h3>The author has the following errors</h3>
-<ul>
-<?php foreach ($errors as $error): ?>
-    <li><?php echo $error->getMessage() ?></li>
-<?php endforeach; ?>
-</ul>
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            Cada error de validación (conocido cómo «violación de restricción»), está representado por un objeto Symfony\Component\Validator\ConstraintViolation.

            -
            -
            -
            -

            Validación y formularios

            -

            Puedes utilizar el servicio validator en cualquier momento para validar cualquier objeto. -En realidad, sin embargo, por lo general al trabajar con formularios vas a trabajar con el validador indirectamente. La biblioteca de formularios de Symfony utiliza internamente el servicio validador para validar el objeto subyacente después de que los valores se han presentado y vinculado. Las violaciones de restricción en el objeto se convierten en objetos FieldError los cuales puedes mostrar fácilmente en tu formulario. El flujo de trabajo típico en la presentación del formulario se parece al siguiente visto desde el interior de un controlador:

            -
            // ...
-use Acme\BlogBundle\Entity\Author;
-use Acme\BlogBundle\Form\AuthorType;
-use Symfony\Component\HttpFoundation\Request;
-
-public function updateAction(Request $request)
-{
-    $author = new Author();
-    $form = $this->createForm(new AuthorType(), $author);
-
-    if ($request->isMethod('POST')) {
-        $form->bind($request);
-
-        if ($form->isValid()) {
-            // validación superada, haz algo con el objeto $author
-
-            return $this->redirect($this->generateUrl(...));
-        }
-    }
-
-    return $this->render('BlogBundle:Author:form.html.twig', array(
-        'form' => $form->createView(),
-    ));
-}
-
            -
            -
            -

            Nota

            -

            Este ejemplo utiliza un formulario de la clase AutorType, el cual no mostramos aquí.

            -
            -

            Para más información, consulta el capítulo Formularios.

            -
            -
            -
            -

            Configurando

            -

            El validador de Symfony2 está activado por omisión, pero debes habilitar explícitamente las anotaciones si estás utilizando el método de anotación para especificar tus restricciones:

            -
            -
              -
            • YAML
              # app/config/config.yml
-framework:
-    validation: { enable_annotations: true }
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<framework:config>
-    <framework:validation enable-annotations="true" />
-</framework:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('framework', array(
-    'validation' => array(
-        'enable_annotations' => true,
-    ),
-));
-
              -
              -
              • -
            -
            -
            -
            -

            Restricciones

            -

            El validador está diseñado para validar objetos contra restricciones (es decir, reglas). A fin de validar un objeto, basta con asignar una o más restricciones a tu clase y luego pasarla al servicio validador.

            -

            Detrás del escenario, una restricción simplemente es un objeto PHP que hace una declaración asertiva. En la vida real, una restricción podría ser: «El pastel no se debe quemar». -En Symfony2, las restricciones son similares: son aserciones de que una condición es verdadera. Dado un valor, una restricción te dirá si o no el valor se adhiere a las reglas de tu restricción.

            -
            -

            Restricciones compatibles

            -

            Symfony2 viene con un gran número de las más comunes restricciones necesarias.

            -
            -
            -

            Restricciones básicas

            -

            Estas son las restricciones básicas: utilízalas para afirmar cosas muy básicas sobre el valor de las propiedades o el valor de retorno de los métodos en tu objeto.

            - -
            -
            -

            Restricciones de cadena

            - -
            -
            -

            Restricciones de número

            - -
            -
            -

            Restricciones de fecha

            - -
            -
            -

            Restricciones de colección

            - -
            -
            -

            Restricciones de archivo

            - -
            -
            -

            Restricciones financieras

            - -
            -
            -

            Otras restricciones

            - -

            También puedes crear tus propias restricciones personalizadas. Este tema se trata en el artículo «Cómo crear una restricción de validación personalizada» del recetario.

            -
            -
            -

            Configurando restricciones

            -

            Algunas restricciones, como NotBlank, son simples, mientras que otras, como la restricción Choice, tienen varias opciones de configuración disponibles. Supongamos que la clase Autor tiene otra propiedad, género que se puede configurar como «masculino» o «femenino»:

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        gender:
-            - Choice: { choices: [male, female], message: Choose a valid gender. }
-
              -
              -
              • -
            • Annotations
              // src/Acme/BlogBundle/Entity/Author.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Choice(
-     *     choices = { "male", "female" },
-     *     message = "Choose a valid gender."
-     * )
-     */
-    public $gender;
-}
-
              -
              -
              • -
            • XML
              <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-    <class name="Acme\BlogBundle\Entity\Author">
-        <property name="gender">
-            <constraint name="Choice">
-                <option name="choices">
-                    <value>male</value>
-                    <value>female</value>
-                </option>
-                <option name="message">Choose a valid gender.</option>
-            </constraint>
-        </property>
-    </class>
-</constraint-mapping>
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\Choice;
-
-class Autor
-{
-    public $gender;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('gender', new Choice(array(
-            'choices' => array('male', 'female'),
-            'message' => 'Choose a valid gender.',
-        )));
-    }
-}
-
              -
              -
              • -
            -
            -

            Las opciones de una restricción siempre se pueden pasar como un arreglo. Algunas restricciones, sin embargo, también te permiten pasar el valor de una opción «predeterminada», en lugar del arreglo. En el caso de la restricción Choice, las opciones se pueden especificar de esta manera:

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        gender:
-            - Choice: [male, female]
-
              -
              -
              • -
            • Annotations
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Choice({"male", "female"})
-     */
-    protected $gender;
-}
-
              -
              -
              • -
            • XML
              <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-    <class name="Acme\BlogBundle\Entity\Author">
-        <property name="gender">
-            <constraint name="Choice">
-                <value>male</value>
-                <value>female</value>
-            </constraint>
-        </property>
-    </class>
-</constraint-mapping>
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\Choice;
-
-class Autor
-{
-    protected $gender;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint(
-            'gender',
-            new Choice(array('male', 'female'))
-        );
-    }
-}
-
              -
              -
              • -
            -
            -

            Esto, simplemente está destinado a hacer que la configuración de las opciones más comunes de una restricción sea más breve y rápida.

            -

            Si alguna vez no estás seguro de cómo especificar una opción, o bien consulta la documentación de la API por la restricción o juega a lo seguro pasando siempre las opciones en un arreglo (el primer método se muestra más arriba).

            -
            -
            -
            -

            Traduciendo mensajes de restricción

            -

            Para más información sobre la traducción de los mensajes de restricción, consulta Traduciendo mensajes de restricción.

            -
            -
            -

            Objetivos de restricción

            -

            Las restricciones se pueden aplicar a una propiedad de clase (por ejemplo, name) o a un método captador público (por ejemplo getFullName). El primero es el más común y fácil de usar, pero el segundo te permite especificar reglas de validación más complejas.

            -
            -

            Propiedades

            -

            La validación de propiedades de clase es la técnica de validación más básica. Symfony2 te permite validar propiedades privadas, protegidas o públicas. El siguiente listado muestra cómo configurar la propiedad $firstName de una clase Author para que por lo menos tenga 3 caracteres.

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        firstName:
-            - NotBlank: ~
-            - Length:
-                min: 3
-
              -
              -
              • -
            • Annotations
              // Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\NotBlank()
-     * @Assert\Length(min = "3")
-     */
-    private $firstName;
-}
-
              -
              -
              • -
            • XML
              <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="firstName">
-        <constraint name="NotBlank" />
-        <constraint name="Length">
-            <option name="min">3</option>
-        </constraint>
-    </property>
-</class>
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\NotBlank;
-use Symfony\Component\Validator\Constraints\Length;
-
-class Autor
-{
-    private $firstName;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', new NotBlank());
-        $metadata->addPropertyConstraint(
-            'firstName',
-            new Length(array("min" => 3)));
-    }
-}
-
              -
              -
              • -
            -
            -
            -
            -

            Captadores

            -

            Las restricciones también se pueden aplicar al valor devuelto por un método. Symfony2 te permite agregar una restricción a cualquier método público cuyo nombre comience con get o is. En esta guía, ambos métodos de este tipo son conocidos como «captadores» o getters.

            -

            La ventaja de esta técnica es que te permite validar el objeto de forma dinámica. Por ejemplo, supongamos que quieres asegurarte de que un campo de contraseña no coincide con el nombre del usuario (por razones de seguridad). Puedes hacerlo creando un método isPasswordLegal, a continuación, acertar que este método debe devolver true:

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    getters:
-        passwordLegal:
-            - "True": { message: "The password cannot match your first name" }
-
              -
              -
              • -
            • Annotations
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\True(message = "The password cannot match your first name")
-     */
-    public function isPasswordLegal()
-    {
-        // devuelve 'true' o 'false'
-    }
-}
-
              -
              -
              • -
            • XML
              <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <getter property="passwordLegal">
-        <constraint name="True">
-            <option name="message">The password cannot match your first name</option>
-        </constraint>
-    </getter>
-</class>
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\True;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addGetterConstraint('passwordLegal', new True(array(
-            'message' => 'The password cannot match your first name',
-        )));
-    }
-}
-
              -
              -
              • -
            -
            -

            Ahora, crea el método isPasswordLegal() e incluye la lógica que necesites:

            -
            public function isPasswordLegal()
-{
-    return ($this->firstName != $this->password);
-}
-
            -
            -
            -

            Nota

            -

            El ojo perspicaz se habrá dado cuenta de que el prefijo del captador (get o is) se omite en la asignación. Esto te permite mover la restricción a una propiedad con el mismo nombre más adelante (o viceversa) sin cambiar la lógica de validación.

            -
            -
            -
            -

            Clases

            -

            Algunas restricciones se aplican a toda la clase que se va a validar. Por ejemplo, la restricción Retrollamada es una restricción que se aplica a la clase en sí misma: Cuando se valide esa clase, los métodos especificados por esta restricción se ejecutarán simplemente para que cada uno pueda proporcionar una validación más personalizada.

            -
            -
            -
            -

            Validando grupos

            -

            Hasta ahora, hemos sido capaces de agregar restricciones a una clase y consultar si o no esa clase pasa todas las restricciones definidas. En algunos casos, sin embargo, tendrás que validar un objeto contra únicamente algunas restricciones de esa clase. Para ello, puedes organizar cada restricción en uno o más «grupos de validación», y luego aplicar la validación contra un solo grupo de restricciones.

            -

            Por ejemplo, supongamos que tienes una clase Usuario, la cual se usa más adelante tanto cuando un usuario se registra como cuando un usuario actualiza su información de contacto:

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\User:
-    properties:
-        email:
-            - Email: { groups: [registration] }
-        password:
-            - NotBlank: { groups: [registration] }
-            - Length: { min: 7, groups: [registration] }
-        city:
-            - Length:
-                min: 2
-
              -
              -
              • -
            • Annotations
              // src/Acme/BlogBundle/Entity/User.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Security\Core\User\UserInterface;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User implements UserInterface
-{
-    /**
-    * @Assert\Email(groups={"registration"})
-    */
-    private $email;
-
-    /**
-    * @Assert\NotBlank(groups={"registration"})
-    * @Assert\Length(min=7, groups={"registration"})
-    */
-    private $password;
-
-    /**
-    * @Assert\Length(min = "2")
-    */
-    private $city;
-}
-
              -
              -
              • -
            • XML
              <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\User">
-    <property name="email">
-        <constraint name="Email">
-            <option name="groups">
-                <value>registration</value>
-            </option>
-        </constraint>
-    </property>
-    <property name="password">
-        <constraint name="NotBlank">
-            <option name="groups">
-                <value>registration</value>
-            </option>
-        </constraint>
-        <constraint name="Length">
-            <option name="min">7</option>
-            <option name="groups">
-                <value>registration</value>
-            </option>
-        </constraint>
-    </property>
-    <property name="city">
-        <constraint name="Length">
-            <option name="min">7</option>
-        </constraint>
-    </property>
-</class>
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/User.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\Email;
-use Symfony\Component\Validator\Constraints\NotBlank;
-use Symfony\Component\Validator\Constraints\Length;
-
-class User
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('email', new Email(array(
-            'groups' => array('registration'),
-        )));
-
-        $metadata->addPropertyConstraint('password', new NotBlank(array(
-            'groups' => array('registration'),
-        )));
-        $metadata->addPropertyConstraint('password', new Length(array(
-            'min'  => 7,
-            'groups' => array('registration')
-        )));
-
-        $metadata->addPropertyConstraint(
-            'city',
-            Length(array("min" => 3)));
-    }
-}
-
              -
              -
              • -
            -
            -

            Con esta configuración, hay dos grupos de validación:

            -
              -
            • contiene las restricciones no asignadas a algún otro grupo;
              • -
            • contiene restricciones sólo en los campos de email y password.
              • -
            -

            Para decir al validador que use un grupo específico, pasa uno o más nombres de grupo como segundo argumento al método validate():

            -
            $errors = $validator->validate($author, array('registration'));
-
            -
            -

            Por supuesto, por lo general vas a trabajar con la validación indirectamente a través de la biblioteca de formularios. Para obtener información sobre cómo utilizar la validación de grupos dentro de los formularios, consulta Validando grupos.

            -
            -
            -

            Validando valores y arreglos

            -

            Hasta ahora, hemos visto cómo puedes validar objetos completos. Pero a veces, sólo deseas validar un único valor —como verificar que una cadena es una dirección de correo electrónico válida—. Esto realmente es muy fácil de hacer. Desde el interior de un controlador, se ve así:

            -
            use Symfony\Component\Validator\Constraints\Email;
-// ...
-
-public function addEmailAction($email)
-{
-    $emailConstraint = new Email();
-    // puedes fijar todas las "opciones" de restricción de esta manera
-    $emailConstraint->message = 'Invalid email address';
-
-    // usa el validador para validar el valor
-    $errorList = $this->get('validator')->validateValue(
-        $email,
-        $emailConstraint
-    );
-
-    if (count($errorList) == 0) {
-        // esta ES una dirección de correo válida, haz algo
-    } else {
-        // esta *no* es una dirección de correo electrónico válida
-        $errorMessage = $errorList[0]->getMessage();
-
-        // ... haz algo con el error
-    }
-
-    // ...
-}
-
            -
            -

            Al llamar a validateValue en el validador, puedes pasar un valor en bruto y el objeto restricción contra el cual deseas validar el valor. Una lista completa de restricciones disponibles —así como el nombre de clase completo para cada restricción— está disponible en la sección referencia de restricciones.

            -

            El método validateValue devuelve un objeto Symfony\Component\Validator\ConstraintViolationList, que actúa como un arreglo de errores. Cada error de la colección es un objeto Symfony\Component\Validator\ConstraintViolation, que contiene el mensaje de error en su método getMessage.

            -
            -
            -

            Consideraciones finales

            -

            El validador de Symfony2 es una herramienta poderosa que puedes aprovechar para garantizar que los datos de cualquier objeto son «válidos». El poder detrás de la validación radica en las «restricciones», las cuales son reglas que se pueden aplicar a propiedades o métodos captadores de tu objeto. Y mientras más utilices la plataforma de validación indirectamente cuando uses formularios, recordarás que puedes utilizarla en cualquier lugar para validar cualquier objeto.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/DoctrineFixturesBundle/index.html b/bundles/DoctrineFixturesBundle/index.html deleted file mode 100644 index 5ef7d7e..0000000 --- a/bundles/DoctrineFixturesBundle/index.html +++ /dev/null @@ -1,396 +0,0 @@ - - - - - - - DoctrineFixturesBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            DoctrineFixturesBundle

            -

            Los accesorios se utilizan para cargar en una base de datos un juego de datos controlado. Puedes utilizar estos datos para pruebas o podrían ser los datos iniciales necesarios para ejecutar la aplicación sin problemas. Symfony2 no tiene integrada forma alguna de administrar accesorios, pero Doctrine2 cuenta con una biblioteca para ayudarte a escribir accesorios para el ORM u ODM de Doctrine.

            -
            -

            Instalando y configurando

            -

            Los accesorios de Doctrine para Symfony se mantienen en el `DoctrineMigrationsBundle`_. -El paquete utiliza la biblioteca externa de Datos accesorios de Doctrine.

            -

            Sigue estos pasos para instalar el paquete y la biblioteca en la edición estándar de Symfony. Añade lo siguiente a tu archivo composer.json:

            -
            {
-    "require": {
-        "doctrine/doctrine-fixtures-bundle": "dev-master"
-    }
-}
            -
            -

            Actualiza las bibliotecas de proveedores:

            -
            $ php composer.phar update
-
            -
            -

            Si todo va bien, el DoctrineFixturesBundle ahora se puede encontrar en vendor/doctrine/doctrine-fixtures-bundle.

            -
            -

            Nota

            -

            DoctrineFixturesBundle instala la biblioteca de Datos accesorios de Doctrine. La biblioteca se puede encontrar en vendor/doctrine/data-fixtures.

            -
            -

            Por último, registra el paquete DoctrineFixturesBundle en app/AppKernel.php.

            -
            // ...
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(),
-        // ...
-    );
-    // ...
-}
-
            -
            -
            -
            -

            Escribiendo accesorios sencillos

            -

            Los accesorios de Doctrine2 son clases PHP que pueden crear y persistir objetos a la base de datos. Al igual que todas las clases en Symfony2, los accesorios deben vivir dentro de uno de los paquetes de tu aplicación.

            -

            Para un paquete situado en src/Acme/HelloBundle, las clases accesorio deben vivir dentro de src/Acme/HelloBundle/DataFixtures/ORM o src/Acme/HelloBundle/DataFixtures/MongoDB, para ORM y ODM respectivamente, esta guía asume que estás utilizando el ORM — pero, los accesorios se pueden agregar con la misma facilidad si estás utilizando ODM.

            -

            Imagina que tienes una clase User, y te gustaría cargar un nuevo Usuario:

            -
            // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserData.php
-
-namespace Acme\HelloBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\FixtureInterface;
-use Doctrine\Common\Persistence\ObjectManager;
-use Acme\HelloBundle\Entity\User;
-
-class LoadUserData implements FixtureInterface
-{
-    /**
-     * {@inheritDoc}
-     */
-    public function load(ObjectManager $manager)
-    {
-        $userAdmin = new User();
-        $userAdmin->setUsername('admin');
-        $userAdmin->setPassword('test');
-
-        $manager->persist($userAdmin);
-        $manager->flush();
-    }
-}
-
            -
            -

            En Doctrine2, los accesorios sólo son objetos en los que cargas datos interactuando con tus entidades como lo haces normalmente. Esto te permite crear el accesorio exacto que necesitas para tu aplicación.

            -

            La limitación más importante es que no puedes compartir objetos entre accesorios. -Más adelante, veremos la manera de superar esta limitación.

            -
            -
            -

            Ejecutando accesorios

            -

            Una vez que has escrito tus accesorios, los puedes cargar a través de la línea de ordenes usando la orden doctrine:fixtures:load

            -
            php app/console doctrine:fixtures:load
-
            -
            -

            Si estás utilizando ODM, en su lugar usa la orden doctrine:mongodb:fixtures:load:

            -
            php app/console doctrine:mongodb:fixtures:load
-
            -
            -

            La tarea verá dentro del directorio DataFixtures/ORM (o DataFixtures/MongoDB para ODM) de cada paquete y ejecutará cada clase que implemente la FixtureInterface.

            -

            Ambas ordenes vienen con unas cuantas opciones:

            -
              -
            • --fixtures=/ruta/al/accesorio — Usa esta opción para especificar manualmente el directorio de donde se deben cargar las clases accesorio;
              • -
            • --append — Utiliza esta opción para añadir datos en lugar de eliminarlos antes de cargarlos (borrar primero es el comportamiento predeterminado);
              • -
            • --em=manager_name — Especifica manualmente el gestor de la entidad a utilizar para cargar los datos.
              • -
            -
            -

            Nota

            -

            Si utilizas la tarea doctrine:mongodb:fixtures:load, reemplaza la opción --em= con --dm= para especificar manualmente el gestor de documentos.

            -
            -

            Un ejemplo de uso completo podría tener este aspecto:

            -
            php app/console doctrine:fixtures:load --fixtures=/ruta/al/accesorio1 --fixtures=/ruta/al/accesorio2 --append --em=gestor_foo
-
            -
            -
            -
            -

            Compartiendo objetos entre accesorios

            -

            Escribir un accesorio básico es sencillo. Pero, ¿si tienes varias clases de accesorios y quieres poder referirte a los datos cargados en otras clases accesorio? -Por ejemplo, ¿qué pasa si cargas un objeto Usuario en un accesorio, y luego quieres mencionar una referencia a un accesorio diferente con el fin de asignar dicho usuario a un grupo particular?

            -

            La biblioteca de accesorios de Doctrine maneja esto fácilmente permitiéndote especificar el orden en que se cargan los accesorios.

            -
            // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserData.php
-namespace Acme\HelloBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\AbstractFixture;
-use Doctrine\Common\DataFixtures\OrderedFixtureInterface;
-use Doctrine\Common\Persistence\ObjectManager;
-use Acme\HelloBundle\Entity\User;
-
-class LoadUserData extends AbstractFixture implements OrderedFixtureInterface
-{
-    /**
-     * {@inheritDoc}
-     */
-    public function load(ObjectManager $manager)
-    {
-        $userAdmin = new User();
-        $userAdmin->setUsername('admin');
-        $userAdmin->setPassword('test');
-
-        $manager->persist($userAdmin);
-        $manager->flush();
-
-        $this->addReference('admin-user', $userAdmin);
-    }
-
-    /**
-     * {@inheritDoc}
-     */
-    public function getOrder()
-    {
-        return 1; // el orden en el cual serán cargados los accesorios
-    }
-}
-
            -
            -

            La clase accesorio ahora implementa la OrderedFixtureInterface, la cual dice a Doctrine que deseas controlar el orden de tus accesorios. Crea otra clase accesorio y haz que se cargue después de LoadUserData devolviendo un orden de 2:

            -
            // src/Acme/HelloBundle/DataFixtures/ORM/LoadGroupData.php
-
-namespace Acme\HelloBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\AbstractFixture;
-use Doctrine\Common\DataFixtures\OrderedFixtureInterface;
-use Doctrine\Common\Persistence\ObjectManager;
-use Acme\HelloBundle\Entity\Group;
-
-class LoadGroupData extends AbstractFixture implements OrderedFixtureInterface
-{
-    /**
-     * {@inheritDoc}
-     */
-    public function load(ObjectManager $manager)
-    {
-        $groupAdmin = new Group();
-        $groupAdmin->setGroupName('admin');
-
-        $manager->persist($groupAdmin);
-        $manager->flush();
-
-        $this->addReference('admin-group', $groupAdmin);
-    }
-
-    /**
-     * {@inheritDoc}
-     */
-    public function getOrder()
-    {
-        return 2; // el orden en el cual serán cargados los accesorios
-    }
-}
-
            -
            -

            Ambas clases accesorio extienden AbstractFixture, lo cual te permite crear objetos y luego ponerlos como referencias para que se puedan utilizar posteriormente en otros accesorios. Por ejemplo, más tarde puedes referirte a los objetos $userAdmin y $groupAdmin a través de las referencias admin-user y admin-group:

            -
            // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserGroupData.php
-
-namespace Acme\HelloBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\AbstractFixture;
-use Doctrine\Common\DataFixtures\OrderedFixtureInterface;
-use Doctrine\Common\Persistence\ObjectManager;
-use Acme\HelloBundle\Entity\UserGroup;
-
-class LoadUserGroupData extends AbstractFixture implements OrderedFixtureInterface
-{
-    /**
-     * {@inheritDoc}
-     */
-    public function load(ObjectManager $manager)
-    {
-        $userGroupAdmin = new UserGroup();
-        $userGroupAdmin->setUser($this->getReference('admin-user'));
-        $userGroupAdmin->setGroup($this->getReference('admin-group'));
-
-        $manager->persist($userGroupAdmin);
-        $manager->flush();
-    }
-
-    /**
-     * {@inheritDoc}
-     */
-    public function getOrder()
-    {
-        return 3;
-    }
-}
-
            -
            -

            Los accesorios ahora se ejecutan en el orden ascendente del valor devuelto por getOrder(). Cualquier objeto que se establece con el método setReference() se puede acceder a través de getReference() en las clases accesorio que tienen un orden superior.

            -

            Los accesorios te permiten crear cualquier tipo de dato que necesites a través de la interfaz normal de PHP para crear y persistir objetos. Al controlar el orden de los accesorios y establecer referencias, puedes manejar casi todo por medio de accesorios.

            -
            -
            -

            Usando el contenedor en los accesorios

            -

            En algunos casos necesitarás acceder a algunos servicios para cargar los accesorios. -Symfony2 hace esto realmente fácil. El contenedor se inyectará en todas las clases accesorio que implementen la Symfony\Component\DependencyInjection\ContainerAwareInterface.

            -

            Vamos a rescribir el primer accesorio para codificar la contraseña antes de almacenarla en la base de datos (una muy buena práctica). Esto utilizará el generador de codificadores para codificar la contraseña, garantizando que está codificada en la misma forma que la utiliza el componente de seguridad al efectuar la verificación:

            -
            // src/Acme/HelloBundle/DataFixtures/ORM/LoadUserData.php
-
-namespace Acme\HelloBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\FixtureInterface;
-use Symfony\Component\DependencyInjection\ContainerAwareInterface;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-use Acme\HelloBundle\Entity\User;
-
-class LoadUserData implements FixtureInterface, ContainerAwareInterface
-{
-    /**
-     * @var ContainerInterface
-     */
-    private $container;
-
-    /**
-     * {@inheritDoc}
-     */
-    public function setContainer(ContainerInterface $container = null)
-    {
-        $this->container = $container;
-    }
-
-    /**
-     * {@inheritDoc}
-     */
-    public function load(ObjectManager $manager)
-    {
-        $user = new User();
-        $user->setUsername('admin');
-        $user->setSalt(md5(uniqid()));
-
-        $encoder = $this->container
-            ->get('security.encoder_factory')
-            ->getEncoder($user)
-        ;
-        $user->setPassword($encoder->encodePassword('secret', $user->getSalt()));
-
-        $manager->persist($user);
-        $manager->flush();
-    }
-}
-
            -
            -

            Como puedes ver, todo lo que necesitas hacer es agregar Symfony\Component\DependencyInjection\ContainerAwareInterface a la clase y luego crear un nuevo método setContainer() que implemente esa interfaz. Antes de ejecutar el accesorio, Symfony automáticamente llamará al método setContainer(). Siempre y cuando guardes el contenedor como una propiedad en la clase (como se muestra arriba), puedes acceder a él en el método load().

            -
            -

            Nota

            -

            Si te da flojera implementar el método necesario setContainer(), entonces, puedes extender tu clase con Symfony\Component\DependencyInjection\ContainerAware.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/DoctrineMigrationsBundle/index.html b/bundles/DoctrineMigrationsBundle/index.html deleted file mode 100644 index 600aa49..0000000 --- a/bundles/DoctrineMigrationsBundle/index.html +++ /dev/null @@ -1,337 +0,0 @@ - - - - - - - DoctrineMigrationsBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            DoctrineMigrationsBundle

            -

            La funcionalidad de migración de base de datos, es una extensión de la capa de abstracción de bases de datos y te ofrece la posibilidad de desplegar programáticamente nuevas versiones del esquema de la base de datos de forma segura y estandarizada.

            -
            -

            Truco

            -

            Puedes leer más sobre las migraciones de base de datos de Doctrine en la documentación del proyecto.

            -
            -
            -

            Instalando

            -

            Las migraciones de Doctrine para Symfony se mantienen en el DoctrineMigrationsBundle. -El paquete usa la biblioteca Migraciones de Base de datos de Doctrine.

            -

            Sigue estos pasos para instalar el paquete y la biblioteca en la edición estándar de Symfony. Añade lo siguiente a tu archivo composer.json:

            -
            {
-    "require": {
-        "doctrine/doctrine-migrations-bundle": "dev-master"
-    }
-}
            -
            -

            Actualiza las bibliotecas de proveedores:

            -
            $ php composer.phar update
-
            -
            -

            Si todo funciona, ahora puedes encontrar la biblioteca DoctrineMigrationsBundle en vendor/doctrine/doctrine-migrations-bundle.

            -
            -

            Nota

            -

            DoctrineMigrationsBundle instala la biblioteca Migraciones de Base de datos de Doctrine. Puedes encontrar la biblioteca en vendor/doctrine/migrations.

            -
            -

            Por último, asegúrate de activar el paquete en AppKernel.php incluyendo lo siguiente:

            -
            // app/AppKernel.php
-public function registerBundles()
-{
-    $bundles = array(
-        //...
-        new Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle(),
-    );
-}
-
            -
            -
            -
            -

            Usando

            -

            Toda la funcionalidad de las migraciones se encuentra en unas cuantas ordenes de consola:

            -
            doctrine:migrations
-  :diff     Genera una migración comparando tu base de datos actual
-            a tu información asignada.
-  :execute  Ejecuta manualmente una sola versión de migración hacia
-            arriba o abajo.
-  :generate Genera una clase de migración en blanco.
-  :migrate  Ejecuta una migración a una determinada versión o, a la
-            última versión disponible.
-  :status   Ve el estado de un conjunto de migraciones.
-  :version  Añade y elimina versiones de migración manualmente desde
-            la tabla de versiones.
-
            -
            -

            Empieza consiguiendo la situación de las migraciones en tu aplicación ejecutando la orden status:

            -
            php app/console doctrine:migrations:status
-
- == Configuration
-
-    >> Name:                                               Application Migrations
-    >> Configuration Source:                               manually configured
-    >> Version Table Name:                                 migration_versions
-    >> Migrations Namespace:                               Application\Migrations
-    >> Migrations Directory:                               /ruta/a/proyecto/app/DoctrineMigrations
-    >> Current Version:                                    0
-    >> Latest Version:                                     0
-    >> Executed Migrations:                                0
-    >> Available Migrations:                               0
-    >> New Migrations:                                     0
-
            -
            -

            Ahora, podemos empezar a trabajar con las migraciones generando una nueva clase de migración en blanco. Más adelante, aprenderás cómo puedes generar migraciones automáticamente con Doctrine.

            -
            php app/console doctrine:migrations:generate
-Nueva clase migración generada para "/ruta/a/tu/proyecto/app/DoctrineMigrations/Version20100621140655.php"
-
            -
            -

            Echa un vistazo a la clase migración recién generada y verás algo como lo siguiente:

            -
            namespace Application\Migrations;
-
-use Doctrine\DBAL\Migrations\AbstractMigration,
-    Doctrine\DBAL\Schema\Schema;
-
-class Version20100621140655 extends AbstractMigration
-{
-    public function up(Schema $schema)
-    {
-
-    }
-
-    public function down(Schema $schema)
-    {
-
-    }
-}
-
            -
            -

            Si ahora ejecutas la orden status te mostrará que tienes una nueva migración por ejecutar:

            -
            php app/console doctrine:migrations:status
-
- == Configuration
-
-   >> Name:                                               Application Migrations
-   >> Configuration Source:                               manually configured
-   >> Version Table Name:                                 migration_versions
-   >> Migrations Namespace:                               Application\Migrations
-   >> Migrations Directory:                               /ruta/a/proyecto/app/DoctrineMigrations
-   >> Current Version:                                    0
-   >> Latest Version:                                     2010-06-21 14:06:55 (20100621140655)
-   >> Executed Migrations:                                0
-   >> Available Migrations:                               1
-   >> New Migrations:                                     1
-
-== Versiones de migración
-
-   >> 2011-06-21 14:06:55 (20110621140655)                no migrada
-
            -
            -

            Ahora puedes agregar algo de código de migración a los métodos up() y down(), y finalmente cuando estés listo migrar:

            -
            php app/console doctrine:migrations:migrate
-
            -
            -

            Para más información sobre cómo escribir migraciones en sí mismas (es decir, la manera de rellenar los métodos up() y down()), consulta la documentación oficial de las Migraciones de Doctrine.

            -
            -

            Ejecutando migraciones al desplegar tu aplicación

            -

            Por supuesto, el objetivo final al escribir migraciones es poder utilizarlas para actualizar de manera fiable la estructura de tu base de datos cuando despliegues tu aplicación. -Al ejecutar las migraciones localmente (o en un servidor de pruebas), puedes asegurarte de que las migraciones trabajan según lo previsto.

            -

            Cuando finalmente despliegues tu aplicación, sólo tienes que recordar ejecutar la orden doctrine:migrations:migrate. Internamente, Doctrine crea una tabla migration_versions dentro de la base de datos y allí lleva a cabo el seguimiento de las migraciones que se han ejecutado. Por lo tanto, no importa cuantas migraciones hayas creado y ejecutado localmente, cuando se ejecuta la orden durante el despliegue, Doctrine sabrá exactamente qué migraciones no se han ejecutado todavía mirando la tabla migration_versions de tu base de datos en producción. Independientemente de qué servidor esté activado, siempre puedes ejecutar esta orden de forma segura para realizar sólo las migraciones que todavía no se han llevado a cabo en esa base de datos particular.

            -
            -
            -
            -

            Generando migraciones automáticamente

            -

            En realidad, no deberías tener que escribir migraciones manualmente, puesto que la biblioteca de migraciones puede generar las clases de la migración automáticamente comparando tu información asignada a Doctrine (es decir, cómo se debe ver tu base de datos) con la estructura de la base de datos actual.

            -

            Por ejemplo, supongamos que creas una nueva entidad Usuario y agregas información asignándola al ORM de Doctrine:

            -
            -
              -
            • Annotations
              // src/Acme/HelloBundle/Entity/User.php
-namespace Acme\HelloBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-
-/**
- * @ORM\Entity
- * @ORM\Table(name="hello_user")
- */
-class User
-{
-    /**
-     * @ORM\Id
-     * @ORM\Column(type="integer")
-     * @ORM\GeneratedValue(strategy="AUTO")
-     */
-    protected $id;
-
-    /**
-     * @ORM\Column(type="string", length="255")
-     */
-    protected $name;
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/HelloBundle/Resources/config/doctrine/User.orm.yml
-Acme\HelloBundle\Entity\User:
-    type: entity
-    table: hello_user
-    id:
-        id:
-            type: integer
-            generator:
-                strategy: AUTO
-    fields:
-        name:
-            type: string
-            length: 255
-
              -
              -
              • -
            • XML
              <!-- src/Acme/HelloBundle/Resources/config/doctrine/User.orm.xml -->
-<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
-      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-      xsi:schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping
-                    http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">
-
-    <entity name="Acme\HelloBundle\Entity\User" table="hello_user">
-        <id name="id" type="integer" column="id">
-            <generator strategy="AUTO"/>
-        </id>
-        <field name="name" column="name" type="string" length="255" />
-    </entity>
-
-</doctrine-mapping>
-
              -
              -
              • -
            -
            -

            Con esta información, Doctrine ya está listo para ayudarte a persistir tu nuevo objeto Usuario hacia y desde la tabla hello_user. Por supuesto, ¡esta tabla no existe aún! Genera una nueva migración para esta tabla automáticamente ejecutando la siguiente orden:

            -
            php app/console doctrine:migrations:diff
-
            -
            -

            Deberás ver un mensaje informando que se ha generado una nueva clase migración basada en las diferencias del esquema. Si abres ese archivo, encontrarás que tiene el código SQL necesario para crear la tabla hello_user. A continuación, ejecuta la migración para agregar la tabla a tu base de datos:

            -
            php app/console doctrine:migrations:migrate
-
            -
            -

            La moraleja de la historia es la siguiente: después de cada cambio que realices en tu información de asignación a Doctrine, ejecuta la orden doctrine:migrations:diff para generar automáticamente las clases de la migración.

            -

            Si lo haces desde el principio de tu proyecto (es decir, de modo que incluso las primeras tablas fueran cargadas a través de una clase migración), siempre podrás crear una base de datos actualizada y ejecutar las migraciones a fin de tener tu esquema de base de datos totalmente actualizado. De hecho, este es un flujo de trabajo fácil y confiable para tu proyecto.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/DoctrineMongoDBBundle/config.html b/bundles/DoctrineMongoDBBundle/config.html deleted file mode 100644 index 6b75526..0000000 --- a/bundles/DoctrineMongoDBBundle/config.html +++ /dev/null @@ -1,356 +0,0 @@ - - - - - - - Configurando DoctrineMongoDBBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Configurando DoctrineMongoDBBundle

            -
            -

            Configuración de ejemplo

            -
            # app/config/config.yml
-doctrine_mongodb:
-    connections:
-        default:
-            server: mongodb://localhost:27017
-            options: {}
-    default_database: hello_%kernel.environment%
-    document_managers:
-        default:
-            mappings:
-                AcmeDemoBundle: ~
-            filters:
-                filter-name:
-                    class: Class\Example\Filter\ODM\ExampleFilter
-                    enabled: true
-            metadata_cache_driver: array # array, apc, xcache, memcache
-
            -
            -

            Si deseas utilizar memcache para memorizar tus metadatos, es necesario configurar la instancia Memcache; por ejemplo, puedes hacer lo siguiente:

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_mongodb:
-    default_database: hello_%kernel.environment%
-    connections:
-        default:
-            server: mongodb://localhost:27017
-            options: {}
-    document_managers:
-        default:
-            mappings:
-                AcmeDemoBundle: ~
-            metadata_cache_driver:
-                type: memcache
-                class: Doctrine\Common\Cache\MemcacheCache
-                host: localhost
-                port: 11211
-                instance_class: Memcache
-
              -
              -
              • -
            • XML
              <?xml version="1.0" ?>
-
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:doctrine_mongodb="http://symfony.com/schema/dic/doctrine/odm/mongodb"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/doctrine/odm/mongodb http://symfony.com/schema/dic/doctrine/odm/mongodb/mongodb-1.0.xsd">
-
-    <doctrine_mongodb:config default-database="hello_%kernel.environment%">
-        <doctrine_mongodb:document-manager id="default">
-            <doctrine_mongodb:mapping name="AcmeDemoBundle" />
-            <doctrine_mongodb:metadata-cache-driver type="memcache">
-                <doctrine_mongodb:class>Doctrine\Common\Cache\MemcacheCache</doctrine_mongodb:class>
-                <doctrine_mongodb:host>localhost</doctrine_mongodb:host>
-                <doctrine_mongodb:port>11211</doctrine_mongodb:port>
-                <doctrine_mongodb:instance-class>Memcache</doctrine_mongodb:instance-class>
-            </doctrine_mongodb:metadata-cache-driver>
-        </doctrine_mongodb:document-manager>
-        <doctrine_mongodb:connection id="default" server="mongodb://localhost:27017">
-            <doctrine_mongodb:options>
-            </doctrine_mongodb:options>
-        </doctrine_mongodb:connection>
-    </doctrine_mongodb:config>
-</container>
-
              -
              -
              • -
            -
            -
            -

            Configurando la asignación

            -

            La definición explícita de todos los documentos asignados es la única configuración necesaria para ODM y hay varias opciones de configuración que puedes controlar. Existen las siguientes opciones de configuración para una asignación:

            -
              -
            • type Uno de annotations, xml, yml, php o staticphp. -Esta especifica cual tipo de metadatos usa el tipo de tu asignación.
              • -
            • dir Ruta a los archivos de entidad o asignación (dependiendo del controlador). Si esta ruta es relativa, se supone que es relativa a la raíz del paquete. Esto sólo funciona si el nombre de tu asignación es un nombre de paquete. Si deseas utilizar esta opción para especificar rutas absolutas debes prefijar la ruta con los parámetros del núcleo existentes en el DIC (por ejemplo %kernel.root_dir%).
              • -
            • prefix Un prefijo de espacio de nombres común que comparten todos los documentos de esta asignación. Este prefijo no debe entrar en conflicto con otros prefijos definidos por otras asignaciones, de otra manera Doctrine no podrá encontrar algunos de tus documentos. Esta opción, por omisión, es el espacio de nombres del paquete + Document, por ejemplo, para un paquete de la aplicación llamada AcmeHelloBundle, el prefijo sería Acme\HelloBundle\Document.
              • -
            • alias Doctrine ofrece una forma simple para rebautizar el espacio de nombres de los documentos, los nombres más cortos se utilizan en las consultas o para acceder al repositorio.
              • -
            -
              -
            • is_bundle Esta opción es un valor derivado de dir y por omisión se establece en true si dir es relativo provisto por un file_exists() verifica que devuelve false. Este es false si al comprobar la existencia devuelve true. En este caso has especificado una ruta absoluta y es más probable que los archivos de metadatos estén en un directorio fuera del paquete.
              • -
            -

            Para evitar tener que configurar un montón de información para tus asignaciones, debes seguir los siguientes convenios:

            -
              -
            1. Pon todos tus documentos en un directorio Document/ dentro de tu paquete. Por ejemplo Acme/HelloBundle/Document/.
              2. -
            2. Si estás usando asignación xml, php o yml coloca todos tus archivos de configuración en el directorio Resources/config/doctrine/ con el sufijo mongodb.xml, mongodb.yml o mongodb.php respectivamente.
              3. -
            3. Asume anotaciones si es un Document/ pero no se encuentra el directorio Resources/config/doctrine/.
              4. -
            -

            La siguiente configuración muestra un montón de ejemplos de asignación:

            -
            doctrine_mongodb:
-    document_managers:
-        default:
-            mappings:
-                MyBundle1: ~
-                MyBundle2: yml
-                MyBundle3: { type: annotation, dir: Documents/ }
-                MyBundle4: { type: xml, dir: Resources/config/doctrine/mapping }
-                MyBundle5:
-                    type: yml
-                    dir: my-bundle-mappings-dir
-                    alias: BundleAlias
-                doctrine_extensions:
-                    type: xml
-                    dir: %kernel.root_dir%/../src/vendor/DoctrineExtensions/lib/DoctrineExtensions/Documents
-                    prefix: DoctrineExtensions\Documents\
-                    alias: DExt
            -
            -
            -
            -

            Filtros

            -

            Fácilmente puedes añadir filtros a un gestor de documentos utilizando la siguiente sintaxis:

            -
            doctrine_mongodb:
-    document_managers:
-        default:
-            filters:
-                filter-one:
-                    class: Class\ExampleOne\Filter\ODM\ExampleFilter
-                    enabled: true
-                filter-two:
-                    class: Class\ExampleTwo\Filter\ODM\ExampleFilter
-                    enabled: false
-
            -
            -

            Los filtros se usan para añadir condiciones al queryBuilder sin tener en cuenta dónde se generó la consulta.

            -
            -
            -

            Múltiples conexiones

            -

            Si necesitas múltiples conexiones y gestores de documentos puedes utilizar la siguiente sintaxis:

            -

            Ahora puedes recuperar los servicios configurados conectando servicios:

            -
            $conn1 = $container->get('doctrine_mongodb.odm.conn1_connection');
-$conn2 = $container->get('doctrine_mongodb.odm.conn2_connection');
-
            -
            -

            Y también puedes recuperar los gestores de servicios de documentos configurados que utilizan la conexión de servicios anterior:

            -
            $dm1 = $container->get('doctrine_mongodb.odm.dm1_document_manager');
-$dm2 = $container->get('doctrine_mongodb.odm.dm2_document_manager');
-
            -
            -
            -
            -

            Conectando un grupo de servidores mongodb en 1 conexión

            -

            Es posible conectarse a varios servidores mongodb en una conexión si utilizas un conjunto de réplicas haciendo una lista de todos los servidores dentro de la cadena de conexión como una lista separada por comas.

            -
            -
              -
            • YAML
              doctrine_mongodb:
-    # ...
-    connections:
-        default:
-            server: 'mongodb://mongodb-01:27017,mongodb-02:27017,mongodb-03:27017'
-
              -
              -
              • -
            -
            -

            Dónde mongodb-01, mongodb-02 y mongodb-03 son los nombres de las máquinas anfitrionas. También puedes utilizar direcciones IP, si lo prefiere.

            -
            -
            -

            Volviendo a intentar conexiones y sonsultas

            -

            MongoDB de Doctrine automáticamente es compatible con reintentos de conexión y consultas despues de encontrar una excepción, lo cual es útil cuando tratas con situaciones como conjunto de réplicas para la recuperación de fallos. Esto alivia mucha de la necesidad de capturar las excepciones del controlador MongoDB de PHP en la aplicación y volver a intentar esas operaciones manualmente.

            -

            Puedes especificar el número de veces en que se reintentarán las conexiones y consultas a través de las opciones retry_connect y retry_query en la configuración del gestor de documentos. -Estas opciones de manerea predeterminada están en cero, lo cual significa que ninguna operación se volverá a intentar.

            -
            -
            -
            -

            Configuración predeterminada completa

            -
            -
              -
            • YAML
              doctrine_mongodb:
-    document_managers:
-
-        # Prototype
-        id:
-            connection:           ~
-            database:             ~
-            logging:              true
-            auto_mapping:         false
-            retry_connect:        0
-            retry_query:          0
-            metadata_cache_driver:
-                type:                 ~
-                class:                ~
-                host:                 ~
-                port:                 ~
-                instance_class:       ~
-            mappings:
-
-                # Prototipo
-            name:                 []
-                    mapping:              true
-                    type:                 ~
-                    dir:                  ~
-                    prefix:               ~
-                    alias:                ~
-                    is_bundle:            ~
-    connections:
-
-        # Prototype
-        id:
-            server:               ~
-            options:
-                connect:              ~
-                persist:              ~
-                timeout:              ~
-                replicaSet:           ~
-                username:             ~
-                password:             ~
-    proxy_namespace:      MongoDBODMProxies
-    proxy_dir:            %kernel.cache_dir%/doctrine/odm/mongodb/Proxies
-    auto_generate_proxy_classes:  false
-    hydrator_namespace:   Hydrators
-    hydrator_dir:         %kernel.cache_dir%/doctrine/odm/mongodb/Hydrators
-    auto_generate_hydrator_classes:  false
-    default_document_manager:  ~
-    default_connection:   ~
-    default_database:     default
              -
              -
              • -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/DoctrineMongoDBBundle/form.html b/bundles/DoctrineMongoDBBundle/form.html deleted file mode 100644 index 21d8353..0000000 --- a/bundles/DoctrineMongoDBBundle/form.html +++ /dev/null @@ -1,371 +0,0 @@ - - - - - - - Cómo implementar un sencillo formulario de inscripción con MongoDB — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Cómo implementar un sencillo formulario de inscripción con MongoDB

            -

            Algunos formularios tienen campos adicionales cuyos valores no es necesario almacenar en la base de datos. En este ejemplo, crearás un formulario de registro con algunos campos adicionales, además, incluirás en el formulario un campo «términos aceptados» (como casilla de verificación), el cual en realidad no se almacena en la información de la cuenta. Vamos a utilizar MongoDB para almacenar los datos.

            -
            -

            El modelo de Usuario simple

            -

            Por lo tanto, en esta guía comenzarás con el modelo para un documento Usuario:

            -
            // src/Acme/AccountBundle/Document/User.php
-namespace Acme\AccountBundle\Document;
-
-use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB;
-use Symfony\Component\Validator\Constraints as Assert;
-use Doctrine\Bundle\MongoDBBundle\Validator\Constraints\Unique as MongoDBUnique;
-
-/**
- * @MongoDB\Document(collection="users")
- * @MongoDBUnique(fields="email")
- */
-class User
-{
-    /**
-     * @MongoDB\Id
-     */
-    protected $id;
-
-    /**
-     * @MongoDB\Field(type="string")
-     * @Assert\NotBlank()
-     * @Assert\Email()
-     */
-    protected $email;
-
-    /**
-     * @MongoDB\Field(type="string")
-     * @Assert\NotBlank()
-     */
-    protected $password;
-
-    public function getId()
-    {
-        return $this->id;
-    }
-
-    public function getEmail()
-    {
-        return $this->email;
-    }
-
-    public function setEmail($email)
-    {
-        $this->email = $email;
-    }
-
-    public function getPassword()
-    {
-        return $this->password;
-    }
-
-    // encriptado estúpidamente simple (¡por favor no copies esto!)
-    public function setPassword($password)
-    {
-        $this->password = sha1($password);
-    }
-}
-
            -
            -

            Este documento Usuario contiene tres campos y dos de ellos (correo y contraseña) se deben mostrar en el formulario. La propiedad correo debe ser única en la base de datos, por lo tanto añadimos esta validación en lo alto de la clase.

            -
            -

            Nota

            -

            Si deseas integrar este Usuario en el sistema de seguridad, es necesario implementar la Interfaz de usuario del componente de Seguridad.

            -
            -
            -
            -

            Creando un formulario para el modelo

            -

            A continuación, crea el formulario para el modelo Usuario:

            -
            // src/Acme/AccountBundle/Form/Type/UserType.php
-namespace Acme\AccountBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\Extension\Core\Type\RepeatedType;
-use Symfony\Component\Form\FormBuilder;
-
-class UserType extends AbstractType
-{
-    public function buildForm(FormBuilder $builder, array $options)
-    {
-        $builder->add('email', 'email');
-        $builder->add('password', 'repeated', array(
-           'first_name' => 'password',
-           'second_name' => 'confirm',
-           'type' => 'password'
-        ));
-    }
-
-    public function getDefaultOptions(array $options)
-    {
-        return array('data_class' => 'Acme\AccountBundle\Document\User');
-    }
-
-    public function getName()
-    {
-        return 'user';
-    }
-}
-
            -
            -

            Acabamos de añadir dos campos: correo y contraseña (repetido para confirmar la contraseña introducida). La opción data_class le indica al formulario el nombre de la clase de los datos (es decir, el documento Usuario).

            -
            -

            Truco

            -

            Para explorar más cosas sobre el componente Formulario, lee esta documentación.

            -
            -
            -
            -

            Incorporando el formulario Usuario en un formulario de inscripción

            -

            El formulario que vamos a usar para la página de registro no es el mismo que el formulario utilizado para simplemente modificar al Usuario (es decir, UserType). El formulario de registro contiene más campos como «acepto las condiciones», cuyo valor no se almacenará en la base de datos.

            -

            En otras palabras, creas un segundo formulario de inscripción, el cual incorpora el formulario Usuario y añades el campo extra necesario. Empecemos creando una clase simple que representa la «inscripción»:

            -
            // src/Acme/AccountBundle/Form/Model/Registration.php
-namespace Acme\AccountBundle\Form\Model;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-use Acme\AccountBundle\Document\User;
-
-class Registration
-{
-    /**
-     * @Assert\Type(type="Acme\AccountBundle\Document\User")
-     */
-    protected $user;
-
-    /**
-     * @Assert\NotBlank()
-     * @Assert\True()
-     */
-    protected $termsAccepted;
-
-    public function setUser(User $user)
-    {
-        $this->usuario = $usuario;
-    }
-
-    public function getUser()
-    {
-        return $this->user;
-    }
-
-    public function getTermsAccepted()
-    {
-        return $this->termsAccepted;
-    }
-
-    public function setTermsAccepted($termsAccepted)
-    {
-        $this->termsAccepted = (boolean)$termsAccepted;
-    }
-}
-
            -
            -

            A continuación, crea el formulario para el modelo Registro:

            -
            // src/Acme/AccountBundle/Form/Type/RegistrationType.php
-namespace Acme\AccountBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\Extension\Core\Type\RepeatedType;
-use Symfony\Component\Form\FormBuilder;
-
-class RegistrationType extends AbstractType
-{
-    public function buildForm(FormBuilder $builder, array $options)
-    {
-        $builder->add('user', new UserType());
-        $builder->add('terms', 'checkbox', array('property_path' => 'termsAccepted'));
-    }
-
-    public function getName()
-    {
-        return 'registration';
-    }
-}
-
            -
            -

            No necesitas utilizar métodos especiales para integrar el UserType en el formulario. -Un formulario es un campo, también — por lo tanto lo puedes añadir como cualquier otro campo, con la expectativa de que la propiedad Usuario correspondiente mantendrá una instancia de la clase UserType.

            -
            -
            -

            Manejando el envío del formulario

            -

            A continuación, necesitas un controlador para manejar el formulario. Comienza creando un controlador simple para mostrar el formulario de inscripción:

            -
            // src/Acme/AccountBundle/Controller/AccountController.php
-namespace Acme\AccountBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Symfony\Component\HttpFoundation\Response;
-
-use Acme\AccountBundle\Form\Type\RegistrationType;
-use Acme\AccountBundle\Form\Model\Registration;
-
-class AccountController extends Controller
-{
-    public function registerAction()
-    {
-        $form = $this->createForm(new RegistrationType(), new Registration());
-
-        return $this->render('AcmeAccountBundle:Account:register.html.twig', array('form' => $form->createView()));
-    }
-}
-
            -
            -

            y su plantilla:

            -
            {# src/Acme/AccountBundle/Resources/views/Account/register.html.twig #}
-
-<form action="{{ path('create')}}" method="post" {{ form_enctype(form) }}>
-    {{ form_widget(form) }}
-
-    <input type="submit" />
-</form>
-
            -
            -

            Finalmente, crea el controlador que maneja el envío del formulario. Esto realiza la validación y guarda los datos en MongoDB:

            -
            public function createAction()
-{
-    $dm = $this->get('doctrine_mongodb')->getManager();
-
-    $form = $this->createForm(new RegistrationType(), new Registration());
-
-    $form->bindRequest($this->getRequest());
-
-    if ($form->isValid()) {
-        $registration = $form->getData();
-
-        $dm->persist($registration->getUser());
-        $dm->flush();
-
-        return $this->redirect(...);
-    }
-
-    return $this->render('AcmeAccountBundle:Account:register.html.twig', array('form' => $form->createView()));
-}
-
            -
            -

            ¡Eso es todo! Tu formulario ahora valida, y te permite guardar el objeto Usuario a MongoDB.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/DoctrineMongoDBBundle/index.html b/bundles/DoctrineMongoDBBundle/index.html deleted file mode 100644 index 5ec8f7f..0000000 --- a/bundles/DoctrineMongoDBBundle/index.html +++ /dev/null @@ -1,708 +0,0 @@ - - - - - - - DoctrineMongoDBBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            DoctrineMongoDBBundle

            -
            -
            -

            El asignador de objeto a documento MongoDB (ODM por Object Document Mapper) es muy similar al ORM de Doctrine2 en su filosofía y funcionamiento. En otras palabras, similar al ORM de Doctrine2, con el ODM de Doctrine, sólo tratas con objetos PHP simples, los cuales luego se persisten de forma transparente hacia y desde MongoDB.

            -
            -

            Truco

            -

            Puedes leer más acerca del ODM de Doctrine MongoDB en la documentación del proyecto.

            -
            -

            Está disponible el paquete que integra el ODM MongoDB de Doctrine en Symfony, por lo tanto es fácil configurarlo y usarlo.

            -
            -

            Nota

            -

            Este capítulo lo debes de sentir muy parecido al capítulo ORM de Doctrine2, que habla de cómo puedes utilizar el ORM de Doctrine para guardar los datos en bases de datos relacionales (por ejemplo, MySQL). Esto es a propósito — si persistes en una base de datos relacional por medio del ORM o a través del ODM MongoDB, las filosofías son muy parecidas.

            -
            -
            -

            Instalando

            -

            Para utilizar el ODM MongoDB, necesitarás dos bibliotecas proporcionadas por Doctrine y un paquete que las integra en Symfony.

            -
            -

            Instalando el paquete con Composer

            -

            Para instalar DoctrineMongoDBBundle con Composer sólo tienes que añadir lo siguiente a tu archivo composer.json:

            -
            {
-    "require": {
-        "doctrine/mongodb-odm-bundle": "3.0.*"
-    },
-    "minimum-stability": "dev"
-}
-
            -
            -

            La definición de minimum-stability es necesaria hasta que una versión no beta del paquete esté disponible. Dependiendo de las necesidades de tu proyecto, puedes utilizar valores distintos a dev, lo cual se explica en la documentación del esquema Composer.

            -

            Ahora puedes instalar las nuevas dependencias ejecutando la orden update de Composer desde el directorio donde se encuentra el archivo composer.json:

            -
            php composer.phar update
-
            -
            -

            Ahora, Composer automáticamente descargará todos los archivos necesarios y los instalará por ti.

            -
            -
            -

            Registrando las anotaciones y el paquete

            -

            Luego, registra la biblioteca de anotaciones añadiendo lo siguiente al cargador automático (bajo la línea AnnotationRegistry::registerLoader existente):

            -
            // app/autoload.php
-use Doctrine\ODM\MongoDB\Mapping\Driver\AnnotationDriver;
-AnnotationDriver::registerAnnotationClasses();
-
            -
            -

            Todo lo que resta por hacer es actualizar tu archivo AppKernel.php, y registrar el nuevo paquete:

            -
            // app/AppKernel.php
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Doctrine\Bundle\MongoDBBundle\DoctrineMongoDBBundle(),
-    );
-
-    // ...
-}
-
            -
            -

            ¡Enhorabuena! Estás listo para empezar a trabajar.

            -
            -
            -
            -

            Configurando

            -

            Para empezar, necesitarás una estructura básica que configure el gestor de documentos. La forma más fácil es habilitar el auto_mapping, el cual activará al ODM MongoDB a través de tu aplicación:

            -
            # app/config/config.yml
-doctrine_mongodb:
-    connections:
-        default:
-            server: mongodb://localhost:27017
-            options: {}
-    default_database: test_database
-    document_managers:
-        default:
-            auto_mapping: true
-
            -
            -
            -

            Nota

            -

            Por supuesto, también te tienes que asegurar de que el servidor MongoDB se ejecute en segundo plano. Para más información, consulta la Guía de inicio rápido de MongoDB.

            -
            -
            -
            -

            Un sencillo ejemplo: Un producto

            -

            La mejor manera de entender el ODM de Doctrine MongoDB es verlo en acción. -En esta sección, recorreremos cada paso necesario para empezar a persistir documentos hacia y desde MongoDB.

            -
            -

            El código del ejemplo

            -

            Si quieres seguir el ejemplo de este capítulo, crea el paquete AcmeStoreBundle ejecutando la orden:

            -
            php app/console generate:bundle --namespace=Acme/StoreBundle
-
            -
            -
            -
            -

            Creando una clase Documento

            -

            Supongamos que estás construyendo una aplicación donde necesitas mostrar tus productos. -Sin siquiera pensar en Doctrine o MongoDB, ya sabes que necesitas un objeto Producto para representar los productos. Crea esta clase en el directorio Document de tu AcmeStoreBundle:

            -
            // src/Acme/StoreBundle/Document/Product.php
-namespace Acme\StoreBundle\Document;
-
-class Product
-{
-    protected $name;
-
-    protected $price;
-}
-
            -
            -

            La clase — a menudo llamada «documento», es decir, una clase básica que contiene los datos — es simple y ayuda a cumplir con el requisito del negocio de que tu aplicación necesita productos. Esta clase, todavía no se puede persistir a Doctrine MongoDB — es sólo una clase PHP simple.

            -
            -
            -

            Agregando información de asignación

            -

            Doctrine te permite trabajar con MongoDB de una manera mucho más interesante que solo recuperar datos de un lado a otro como una matriz. En cambio, Doctrine te permite persistir objetos completos a MongoDB y recuperar objetos enteros desde MongoDB. Esto funciona asignando una clase PHP y sus propiedades a las entradas de una colección MongoDB.

            -

            Para que Doctrine sea capaz de hacer esto, sólo tienes que crear «metadatos», o la configuración que le dice a Doctrine exactamente cómo se deben asignar a MongoDB la clase Producto y sus propiedades. Estos metadatos se pueden especificar en una variedad de formatos diferentes, incluyendo YAML, XML o directamente dentro de la clase Producto a través de anotaciones:

            -
            -
              -
            • Annotations
              // src/Acme/StoreBundle/Document/Product.php
-namespace Acme\StoreBundle\Document;
-
-use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB;
-
-/**
- * @MongoDB\Document
- */
-class Product
-{
-    /**
-     * @MongoDB\Id
-     */
-    protected $id;
-
-    /**
-     * @MongoDB\String
-     */
-    protected $name;
-
-    /**
-     * @MongoDB\Float
-     */
-    protected $price;
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/StoreBundle/Resources/config/doctrine/Product.mongodb.yml
-Acme\StoreBundle\Document\Product:
-    fields:
-        id:
-            id:  true
-        name:
-            type: string
-        price:
-            type: float
-
              -
              -
              • -
            • XML
              <!-- src/Acme/StoreBundle/Resources/config/doctrine/Product.mongodb.xml -->
-<doctrine-mongo-mapping xmlns="http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping"
-      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-      xsi:schemaLocation="http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping
-                    http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping.xsd">
-
-    <documenté name="Acme\StoreBundle\Document\Product">
-        <field fieldName="id" id="true" />
-        <field fieldName="name" type="string" />
-        <field fieldName="price" type="float" />
-    </document>
-</doctrine-mongo-mapping>
              -
              -
              • -
            -
            -

            Doctrine te permite elegir entre una amplia variedad de tipos de campo diferentes, cada uno con sus propias opciones. Para más información sobre los tipos de campo disponibles, consulta la sección Referencia de tipos de campo Doctrine.

            -
            -

            Ver también

            -

            También puedes consultar la Documentación de asignación básica de Doctrine para todos los detalles sobre la información de asignación. Si utilizas anotaciones, tendrás que prefijar todas tus anotaciones con MongoDB\ (por ejemplo, MongoDB\Cadena), lo cual no se muestra en la documentación de Doctrine. También tendrás que incluir la declaración use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB;, la cual importa el prefijo MongoDB para las anotaciones.

            -
            -
            -
            -

            Generando captadores y definidores

            -

            A pesar de que Doctrine ya sabe cómo persistir un objeto Producto a MongoDB, la clase en sí en realidad todavía no es útil. Puesto que Producto es sólo una clase PHP regular, es necesario crear métodos captadores y definidores (por ejemplo, getNombre(), setNombre()) para poder acceder a sus propiedades (ya que las propiedades son protegidas). Afortunadamente, Doctrine puede hacer esto por ti con la siguiente orden:

            -
            php app/console doctrine:mongodb:generate:documents AcmeStoreBundle
-
            -
            -

            Esta orden se asegura de que se generen todos los captadores y definidores para la clase Producto. Esta es una orden segura — la puedes ejecutar una y otra vez: sólo genera captadores y definidores que no existen (es decir, no sustituye métodos existentes).

            -
            -

            Nota

            -

            A Doctrine no le importa si tus propiedades son protegidas o privadas, o si una propiedad tiene o no una función captadora o definidora. -Aquí, los captadores y definidores se generan sólo porque los necesitarás para interactuar con tu objeto PHP.

            -
            -
            -
            -

            Persistiendo objetos a MongoDB

            -

            Ahora que tienes asignado un documento Producto completo, con métodos captadores y definidores, estás listo para persistir los datos a MongoDB. Desde el interior de un controlador, esto es bastante fácil. Agrega el siguiente método al DefaultController del paquete:

            -
             1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
-10
-11
-12
-13
-14
-15
-16
-17
            // src/Acme/StoreBundle/Controller/DefaultController.php
-use Acme\StoreBundle\Document\Product;
-use Symfony\Component\HttpFoundation\Response;
-// ...
-
-public function createAction()
-{
-    $product = new Product();
-    $product->setName('A Foo Bar');
-    $product->setPrice('19.99');
-
-    $dm = $this->get('doctrine_mongodb')->getManager();
-    $dm->persist($product);
-    $dm->flush();
-
-    return new Response('Created product id '.$product->getId());
-}
-
            -
            -
            -

            Nota

            -

            Si estás siguiendo este ejemplo, tendrás que crear una ruta que apunte a esta acción para verla trabajar.

            -
            -

            Vamos a recorrer este ejemplo:

            -
              -
            • Líneas 8-10 En esta sección, creas una instancia y trabajas con el objeto $product como cualquier otro objeto PHP normal;
              • -
            • Línea 12 Esta línea recupera el objeto gestor de documentos, el cual es responsable de manejar el proceso de persistir y recuperar objetos hacia y desde MongoDB;
              • -
            • Línea 13 El método persist() dice a Doctrine que «procese» el objeto $product. Esto en realidad no resulta en una consulta que se deba hacer a MongoDB (todavía).
              • -
            • Línea 14 Cuando se llama al método flush(), Doctrine mira todos los objetos que está gestionando para ver si es necesario persistirlos a MongoDB. En este ejemplo, el objeto $product aún no se ha persistido, por lo que el gestor de documentos hace una consulta a MongoDB, la cual añade una nueva entrada.
              • -
            -
            -

            Nota

            -

            De hecho, ya que Doctrine está consciente de todos los objetos gestionados, cuando llamas al método flush(), se calcula un conjunto de cambios y ejecuta la operación más eficiente posible.

            -
            -

            Al crear o actualizar objetos, el flujo de trabajo siempre es el mismo. En la siguiente sección, verás cómo Doctrine es lo suficientemente inteligente como para actualizar las entradas, si ya existen en MongoDB.

            -
            -

            Truco

            -

            Doctrine proporciona una biblioteca que te permite cargar en tu proyecto mediante programación los datos de prueba (es decir, «datos accesorios»). Para más información, consulta DoctrineFixturesBundle.

            -
            -
            -
            -

            Recuperando objetos desde MongoDB

            -

            Recuperar un objeto de MongoDB incluso es más fácil. Por ejemplo, supongamos que has configurado una ruta para mostrar un Producto específico en función del valor de su id:

            -
            public function showAction($id)
-{
-    $product = $this->get('doctrine_mongodb')
-        ->getRepository('AcmeStoreBundle:Product')
-        ->find($id);
-
-    if (!$product) {
-        throw $this->createNotFoundException('No product found for id '.$id);
-    }
-
-    // haz algo, como pasar el objeto $product a una plantilla
-}
-
            -
            -

            Al consultar por un determinado tipo de objeto, siempre utilizas lo que se conoce como «repositorio». Puedes pensar en un repositorio como una clase PHP, cuyo único trabajo consiste en ayudarte a buscar los objetos de una determinada clase. Puedes acceder al objeto repositorio de una clase documento vía:

            -
            $repository = $this->get('doctrine_mongodb')
-    ->getManager()
-    ->getRepository('AcmeStoreBundle:Product');
-
            -
            -
            -

            Nota

            -

            La cadena AcmeStoreBundle:Product es un método abreviado que puedes utilizar en cualquier lugar de Doctrine en lugar del nombre de clase completo de la entidad (es decir, Acme\StoreBundle\Entity\Product). -Mientras tu documento viva en el espacio de nombres Document de tu paquete, esto va a funcionar.

            -
            -

            Una vez que tengas tu repositorio, tienes acceso a todo tipo de útiles métodos:

            -
            // consulta por la clave principal (generalmente "id")
-$product = $repository->find($id);
-
-// nombres de método dinámicos para búsquedas basadas en
-// el valor de una columna
-$product = $repository->findOneById($id);
-$product = $repository->findOneByName('foo');
-
-// recupera TODOS los productos
-$products = $repository->findAll();
-
-// busca un grupo de productos basándose en el
-// valor de una columna arbitraria
-$products = $repository->findByPrice(19.99);
-
            -
            -
            -

            Nota

            -

            Por supuesto, también puedes realizar consultas complejas, acerca de las cuales aprenderás más en la sección Consultando por objetos.

            -
            -

            También puedes tomar ventaja de los útiles métodos findBy y findOneBy para recuperar objetos fácilmente basándote en varias condiciones:

            -
            // consulta por un producto que coincide en nombre y precio
-$product = $repository->findOneBy(array('name'  => 'foo',
-                                        'price' => 19.99));
-
-// consulta por todos los productos que coinciden
-// con el nombre, y los ordena por precio
-$product = $repository->findBy(
-    array('name' => 'foo'),
-    array('price', 'ASC')
-);
-
            -
            -
            -
            -

            Actualizando un objeto

            -

            Una vez que hayas extraído un objeto de Doctrine, actualizarlo es relativamente fácil. Supongamos que tienes una ruta que asigna un identificador de producto a una acción de actualización de un controlador:

            -
            public function updateAction($id)
-{
-    $dm = $this->get('doctrine_mongodb')->getManager();
-    $product = $dm->getRepository('AcmeStoreBundle:Product')->find($id);
-
-    if (!$product) {
-        throw $this->createNotFoundException('No product found for id '.$id);
-    }
-
-    $product->setName('New product name!');
-    $dm->flush();
-
-    return $this->redirect($this->generateUrl('homepage'));
-}
-
            -
            -

            La actualización de un objeto únicamente consiste de tres pasos:

            -
              -
            1. Recuperar el objeto desde Doctrine;
              2. -
            2. Modificar el objeto;
              3. -
            3. Llamar a flush() en el gestor del documento;
              4. -
            -

            Ten en cuenta que $dm->persist($product) no es necesario. Recuerda que este método simplemente dice a Doctrine que procese o «vea» el objeto $product. -En este caso, ya que recuperaste el objeto $product desde Doctrine, este ya está gestionado.

            -
            -
            -

            Eliminando un objeto

            -

            La eliminación de un objeto es muy similar, pero requiere una llamada al método remove() del gestor de documentos:

            -
            $dm->remove($product);
-$dm->flush();
-
            -
            -

            Como es de esperar, el método remove() notifica a Doctrine que deseas eliminar el documento propuesto de MongoDB. La operación real de eliminar sin embargo, no se ejecuta efectivamente hasta que invocas al método flush().

            -
            -
            -
            -

            Consultando por objetos

            -

            Como vimos anteriormente, la clase repositorio integrada te permite consultar por uno o varios objetos basándote en una serie de diferentes parámetros. Cuando esto es suficiente, esta es la forma más sencilla de consultar documentos. Por supuesto, también puedes crear consultas más complejas.

            -
            -

            Usando el generador de consultas

            -

            El ODM de Doctrine viene con un objeto «Generador» de consultas, el cual te permite construir una consulta para exactamente los documentos que deseas devolver. Si usas un IDE, también puedes tomar ventaja del autocompletado a medida que escribes los nombres de métodos. -Desde el interior de un controlador:

            -
            $products = $this->get('doctrine_mongodb')
-    ->getManager()
-    ->createQueryBuilder('AcmeStoreBundle:Product')
-    ->field('name')->equals('foo')
-    ->limit(10)
-    ->sort('price', 'ASC')
-    ->getQuery()
-    ->execute()
-
            -
            -

            En este caso, devuelve 10 productos con el nombre «foo», ordenados de menor a mayor precio.

            -

            El objeto QueryBuilder contiene todos los métodos necesarios para construir tu consulta. Para más información sobre el generador de consultas de Doctrine, consulta la documentación del Generador de consultas de Doctrine. Para una lista de las condiciones disponibles que puedes colocar en la consulta, ve la documentación específica a los Operadores condicionales.

            -
            -
            -

            Repositorio de clases personalizado

            -

            En la sección anterior, comenzaste a construir y utilizar consultas más complejas desde el interior de un controlador. A fin de aislar, probar y reutilizar esas consultas, es buena idea crear una clase repositorio personalizada para tu documento y allí agregar métodos con la lógica de la consulta.

            -

            Para ello, agrega el nombre de la clase del repositorio a la definición de asignación.

            -
            -
              -
            • Annotations
              // src/Acme/StoreBundle/Document/Product.php
-namespace Acme\StoreBundle\Document;
-
-use Doctrine\ODM\MongoDB\Mapping\Annotations as MongoDB;
-
-/**
- * @MongoDB\Document(repositoryClass="Acme\StoreBundle\Repository\ProductRepository")
- */
-class Product
-{
-    //...
-}
-
              -
              -
              • -
            • YAML
              # src/Acme/StoreBundle/Resources/config/doctrine/Product.mongodb.yml
-Acme\StoreBundle\Document\Product:
-    repositoryClass: Acme\StoreBundle\Repository\ProductRepository
-    # ...
-
              -
              -
              • -
            • XML
              <!-- src/Acme/StoreBundle/Resources/config/doctrine/Product.mongodb.xml -->
-<!-- ... -->
-<doctrine-mongo-mapping xmlns="http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping"
-      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-      xsi:schemaLocation="http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping
-                    http://doctrine-project.org/schemas/odm/doctrine-mongo-mapping.xsd">
-
-    <document name="Acme\StoreBundle\Document\Product"
-            repository-class="Acme\StoreBundle\Repository\ProductRepository">
-        <!-- ... -->
-    </document>
-
-</doctrine-mong-mapping>
-
              -
              -
              • -
            -
            -

            Doctrine puede generar la clase repositorio para ti ejecutando:

            -
            php app/console doctrine:mongodb:generate:repositories AcmeStoreBundle
-
            -
            -

            A continuación, agrega un nuevo método — findAllOrderedByName() — a la clase repositorio recién generada. Este método deberá consultar por todos los documentos Producto, ordenados alfabéticamente.

            -
            // src/Acme/StoreBundle/Repository/ProductRepository.php
-namespace Acme\StoreBundle\Repository;
-
-use Doctrine\ODM\MongoDB\DocumentRepository;
-
-class ProductRepository extends DocumentRepository
-{
-    public function findAllOrderedByName()
-    {
-        return $this->createQueryBuilder()
-            ->sort('name', 'ASC')
-            ->getQuery()
-            ->execute();
-    }
-}
-
            -
            -

            Puedes utilizar este nuevo método al igual que los métodos de búsqueda predeterminados del repositorio:

            -
            $products = $this->get('doctrine_mongodb')
-    ->getManager()
-    ->getRepository('AcmeStoreBundle:Product')
-    ->findAllOrderedByName();
-
            -
            -
            -

            Nota

            -

            Al utilizar una clase repositorio personalizada, todavía tienes acceso a los métodos de búsqueda predeterminados como find() y findAll().

            -
            -
            -
            -
            -

            Extensiones Doctrine: Timestampable, Sluggable, etc.

            -

            Doctrine es bastante flexible, y dispone de una serie de extensiones de terceros que te permiten realizar fácilmente tareas repetitivas y comunes en tus entidades. -Estas incluyen cosas tales como Sluggable, Timestampable, registrable, traducible y Tree.

            -

            Para más información sobre cómo encontrar y utilizar estas extensiones, ve el artículo sobre el uso de extensiones comunes de Doctrine.

            -
            -
            -

            Referencia de tipos de campo Doctrine

            -

            Doctrine dispone de una gran cantidad de tipos de campo. Cada uno de estos asigna un tipo de dato PHP a un determinado tipo de MongoDB. Los siguientes son sólo algunos de los tipos admitidos por Doctrine:

            -
              -
            • string
              • -
            • int
              • -
            • float
              • -
            • date
              • -
            • timestamp
              • -
            • boolean
              • -
            • file
              • -
            -

            Para más información, consulta la sección Asignando tipos en la documentación de Doctrine.

            -
            -
            -

            Ordenes de consola

            -

            La integración ODM de Doctrine2 ofrece varias ordenes de consola en el espacio de nombres doctrine:mongodb. Para ver la lista de ordenes puedes ejecutar la consola sin ningún tipo de argumento:

            -
            php app/console
-
            -
            -

            Mostrará una lista con las ordenes disponibles, muchas de las cuales comienzan con el prefijo doctrine:mongodb. Puedes encontrar más información sobre cualquiera de estas ordenes (o cualquier orden de Symfony) ejecutando la orden help. -Por ejemplo, para obtener detalles acerca de la tarea doctrine:mongodb:query, ejecuta:

            -
            php app/console help doctrine:mongodb:query
-
            -
            -
            -

            Nota

            -

            Para poder cargar accesorios en MongoDB, necesitas tener instalado el paquete DoctrineFixturesBundle. Para ver cómo hacerlo, lee el artículo «DoctrineFixturesBundle» de la documentación.

            -
            -
            -
            -

            Configurando

            -

            Para información más detallada sobre las opciones de configuración disponibles cuando utilizas el ODM de Doctrine, consulta la sección Referencia MongoDB.

            -
            -

            Registrando escuchas y suscriptores de eventos

            -

            Doctrine te permite registrar escuchas y suscriptores que recibirán una notificación cuando se produzcan diferentes eventos al interior del ODM Doctrine. Para más información, consulta la sección Documentación de eventos de Doctrine.

            -
            -

            Truco

            -

            Además de los eventos ODM, también puedes escuchar los eventos de bajo nivel de `` MongoDB``, que encontrarás definidos en la clase DoctrineMongoDBEvents.

            -
            -
            -

            Nota

            -

            Cada conexión de Doctrine tiene su propio gestor de eventos, el cual se comparte con los gestores de documentos vinculados a esa conexión. Los escuchas y suscriptores pueden estar registrados con todos gestores de eventos o sólo uno (usando el nombre de la conexión).

            -
            -

            En Symfony, puedes registrar un escucha o suscriptor creando un servicio y, a continuación marcarlo con una etiqueta específica.

            -
              -

            • escucha de evento: Usa la etiqueta doctrine_mongodb.odm.event_listener para registrar un escucha. El atributo event es necesario y debe indicar el evento a escuchar. De forma predeterminada, los escuchas serán registrados con los gestores de eventos para todas las conexiones. Para restringir un escucha a una única conexión, especifica su nombre en la etiqueta del atributo connection.

              -

              El atributo priority, el cual de manera predefinida es 0 si se omite, se puede utilizar para controlar el orden en que se registran los escuchas. Al igual que el despachador de eventos de Symfony2, un mayor número dará lugar a que el escucha se ejecute primero y los escuchas con la misma prioridad se ejecutan en el orden en que fueron registrados en el gestor de eventos.

              -

              Por último, el atributo lazy, que de manera predeterminada es false` si se omite, se puede utilizar para solicitar que gestor del evento cargue al escucha de manera diferida cuando se distribuya el evento.

              -
              -
                -
              • YAML
                services:
-    my_doctrine_listener:
-        class:   Acme\HelloBundle\Listener\MyDoctrineListener
-        # ...
-        tags:
-            -  { name: doctrine_mongodb.odm.event_listener, event: postPersist }
-
                -
                -
                • -
              • XML
                <service id="my_doctrine_listener" class="Acme\HelloBundle\Listener\MyDoctrineListener">
-    <!-- ... -->
-    <tag name="doctrine_mongodb.odm.event_listener" event="postPersist" />
-</service>.
-
                -
                -
                • -
              • PHP
                $definition = new Definition('Acme\HelloBundle\Listener\MyDoctrineListener');
-// ...
-$definition->addTag('doctrine_mongodb.odm.event_listener', array(
-    'event' => 'postPersist',
-));
-$container->setDefinition('my_doctrine_listener', $definition);
-
                -
                -
                • -
              -
              -
              • -

            • suscriptor de evento: Usa la etiqueta doctrine_mongodb.odm.event_subscriber para registrar un suscriptor. Los suscriptores son responsables de implementar al Doctrine\Common\EventSubscriber y suplir un método que devuelva los eventos que escuchará. Por esta razón, esta etiqueta no tiene el atributo event; -No obstante, dispone de los atributos connection, priority y lazy.

              -
              • -
            -
            -

            Nota

            -

            A diferencia de los escuchas de eventos de Symfony2, el gestor de eventos de Doctrine espera que cada escucha y suscriptor tenga un nombre de método correspondiente al/los evento(s) observado(s). Por esta razón, las etiquetas antes mencionadas no tienen atributo method.

            -
            -
            -
            -
            -

            Integrando el SecurityBundle

            -

            Hay disponible un proveedor de usuarios para tus proyectos MongoDB, trabaja exactamente igual que el proveedor de entidades descrito en el recetario

            -
            -
              -
            • YAML
              security:
-    providers:
-        my_mongo_provider:
-            mongodb: {class: Acme\DemoBundle\Document\User, property: username}
-
              -
              -
              • -
            • XML
              <!-- app/config/security.xml -->
-<config>
-    <provider name="my_mongo_provider">
-        <mongodb class="Acme\DemoBundle\Document\User" property="username" />
-    </provider>
-</config>
-
              -
              -
              • -
            -
            -
            -
            -

            Resumen

            -

            Con Doctrine, te puedes enfocar en los objetos y la forma en que son útiles en tu aplicación y en segundo lugar preocuparte de su persistencia a través de MongoDB. Esto se debe a que Doctrine te permite utilizar cualquier objeto PHP para almacenar los datos y confía en la información de asignación de metadatos para asignar los datos de un objeto a una colección MongoDB.

            -

            Y aunque Doctrine gira en torno a un concepto simple, es increíblemente potente, permitiéndote crear consultas complejas y suscribirte a los eventos que te permiten realizar diferentes acciones conforme los objetos recorren su ciclo de vida en la persistencia.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSAopBundle/index.html b/bundles/JMSAopBundle/index.html deleted file mode 100644 index 74e6092..0000000 --- a/bundles/JMSAopBundle/index.html +++ /dev/null @@ -1,352 +0,0 @@ - - - - - - - JMSAopBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            JMSAopBundle

            -

            Este paquete añade capacidades AOP (Aspect-oriented programming o Programación orientada a aspectos) a Symfony2.

            -

            Si todavía no has oído hablar de AOP, básicamente te permite separar un asunto omnipresente (por ejemplo, la comprobación de seguridad) en una clase específica, y no tener que repetir ese código en todos los lugares donde se necesite.

            -

            En otras palabras, te permite ejecutar código personalizado antes y después de invocar ciertos métodos en tu capa de servicios o controladores. También puedes optar por omitir la invocación del método original, o simplemente lanzar excepciones.

            -
            -

            Instalando

            -

            Consigue una copia del código:

            -
            git submodule add https://github.com/schmittjoh/JMSAopBundle.git src/JMS/AopBundle
-
            -
            -

            Finalmente, registra el paquete en tu núcleo:

            -
            // en AppKernel::registerBundles()
-$bundles = array(
-    // ...
-    new JMS\AopBundle\JMSAopBundle(),
-    // ...
-);
-
            -
            -

            Este paquete además necesita la biblioteca CG para generar código:

            -
            git submodule add https://github.com/schmittjoh/cg-library.git vendor/cg-library
-
            -
            -

            Asegúrate de registrar los espacios de nombres en tu cargador automático:

            -
            // app/autoload.php
-$loader->registerNamespaces(array(
-    // ...
-    'JMS'              => __DIR__.'/../vendor/bundles',
-    'CG'               => __DIR__.'/../vendor/cg-library/src',
-    // ...
-));
-
            -
            -
            -
            -

            Configurando

            -
            jms_aop:
-    cache_dir: %kernel.cache_dir%/jms_aop
            -
            -
            -
            -

            Usando

            -

            A fin de ejecutar código personalizado, necesitas dos clases. En primer lugar, necesitas un así llamado punto de corte (pointcut). El propósito de esta clase es tomar la decisión de si cierto interceptor debe capturar una llamada a un método. Esta decisión se tiene que hacer estáticamente sólo en base de la firma del método en sí.

            -

            La segunda clase es el interceptor. Esta clase se llama en lugar del método original. Esta contiene el código personalizado que quieres ejecutar. En este punto, tienes acceso al objeto en el cual es invocado el método, y todos los argumentos suministrados a ese método.

            -
            -
            -

            Ejemplos

            -
            -

            1. Registro cronológico

            -

            En este ejemplo, implementaremos el registro cronológico de todos los métodos que contienen «delete»

            -
            -

            Punto de corte

            -
            <?php
-
-use JMS\AopBundle\Aop\PointcutInterface;
-
-class LoggingPointcut implements PointcutInterface
-{
-    public function matchesClass(\ReflectionClass $class)
-    {
-        return true;
-    }
-
-    public function matchesMethod(\ReflectionMethod $method)
-    {
-        return false !== strpos($method->name, 'delete');
-    }
-}
-
            -
            -
            # services.yml
-services:
-    my_logging_pointcut:
-        class: LoggingPointcut
-        tags:
-                - { name: jms_aop.pointcut, interceptor: logging_interceptor }
-
            -
            -
            -
            -

            Interceptor de registro

            -
            <?php
-
-use CG\Proxy\MethodInterceptorInterface;
-use CG\Proxy\MethodInvocation;
-use Symfony\Component\HttpKernel\Log\LoggerInterface;
-use Symfony\Component\Security\Core\SecurityContextInterface;
-
-class LoggingInterceptor implements MethodInterceptorInterface
-{
-    private $context;
-    private $logger;
-
-    public function __construct(SecurityContextInterface $context,
-                                LoggerInterface $logger)
-    {
-        $this->context = $context;
-        $this->logger = $logger;
-    }
-
-    public function intercept(MethodInvocation $invocation)
-    {
-        $user = $this->context->getToken()->getUsername();
-        $this->logger->info(sprintf('User "%s" invoked method "%s".', $user, $invocation->reflection->name));
-
-        // se asegura de proceder con la invocación, de lo contrario
-        // el método original nunca se llamará
-        return $invocation->proceed();
-    }
-}
-
            -
            -
            # services.yml
-services:
-    logging_interceptor:
-        class: LoggingInterceptor
-        arguments: [@security.context, @logger]
-
            -
            -
            -
            -
            -

            2. Gestionando transacciones

            -

            En este ejemplo, añadimos una anotación @Transactional, y automáticamente ajustamos todos los métodos donde se declara esta anotación en una transacción.

            -
            -

            Punto de corte

            -
            use Doctrine\Common\Annotations\Reader;
-use JMS\AopBundle\Aop\PointcutInterface;
-use JMS\DiExtraBundle\Annotation as DI;
-
-/**
- * @DI\Service
- * @DI\Tag("jms_aop.pointcut", attributes = {"interceptor" = "aop.transactional_interceptor"})
- *
- * @author Johannes M. Schmitt <schmittjoh@gmail.com>
- */
-class TransactionalPointcut implements PointcutInterface
-{
-    private $reader;
-
-    /**
-     * @DI\InjectParams({
-     *     "reader" = @DI\Inject("annotation_reader"),
-     * })
-     * @param Reader $reader
-     */
-    public function __construct(Reader $reader)
-    {
-        $this->reader = $reader;
-    }
-
-    public function matchesClass(\ReflectionClass $class)
-    {
-        return true;
-    }
-
-    public function matchesMethod(\ReflectionMethod $method)
-    {
-        return null !== $this->reader->getMethodAnnotation($method, 'Annotation\Transactional');
-    }
-}
-
            -
            -
            -
            -

            Interceptor

            -
            use Symfony\Component\HttpKernel\Log\LoggerInterface;
-use Symfony\Component\HttpKernel\Exception\NotFoundHttpException;
-use CG\Proxy\MethodInvocation;
-use CG\Proxy\MethodInterceptorInterface;
-use Doctrine\ORM\EntityManager;
-use JMS\DiExtraBundle\Annotation as DI;
-
-/**
- * @DI\Service("aop.transactional_interceptor")
- *
- * @author Johannes M. Schmitt <schmittjoh@gmail.com>
- */
-class TransactionalInterceptor implements MethodInterceptorInterface
-{
-    private $em;
-    private $logger;
-
-    /**
-     * @DI\InjectParams
-     * @param EntityManager $em
-     */
-    public function __construct(EntityManager $em, LoggerInterface $logger)
-    {
-        $this->em = $em;
-        $this->logger = $logger;
-    }
-
-    public function intercept(MethodInvocation $invocation)
-    {
-        $this->logger->info('Beginning transaction for method "'.$invocation.'")');
-        $this->em->getConnection()->beginTransaction();
-        try {
-            $rs = $invocation->proceed();
-
-            $this->logger->info(sprintf('Comitting transaction for method "%s" (method invocation successful)', $invocation));
-            $this->em->getConnection()->commit();
-
-            return $rs;
-        } catch (\Exception $ex) {
-            if ($ex instanceof NotFoundHttpException) {
-                $this->logger->info(sprintf('Committing transaction for method "%s" (exception thrown, but no rollback)', $invocation));
-                $this->em->getConnection()->commit();
-            } else {
-                $this->logger->info(sprintf('Rolling back transaction for method "%s" (exception thrown)', $invocation));
-                $this->em->getConnection()->rollBack();
-            }
-
-            throw $ex;
-        }
-    }
-}
-
            -
            -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSDiExtraBundle/annotations.html b/bundles/JMSDiExtraBundle/annotations.html deleted file mode 100644 index 6f4f188..0000000 --- a/bundles/JMSDiExtraBundle/annotations.html +++ /dev/null @@ -1,343 +0,0 @@ - - - - - - - Anotaciones — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Anotaciones

            -
            -

            @Inject

            -

            Esta marca una propiedad o parámetro para inyección:

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\Inject;
-
-class Controller
-{
-    /**
-     * @Inject("security.context", required = false)
-     */
-    private $securityContext;
-
-    /**
-     * @Inject("request", strict = false)
-     */
-    private $request;
-
-    /**
-     * @Inject("%kernel.cache_dir%")
-     */
-    private $cacheDir;
-
-    /**
-     * @Inject
-     */
-    private $session;
-}
-
            -
            -
            -

            Truco

            -

            Si no especificas el servicio explícitamente, intentaremos deducirlo basándonos en el nombre de la propiedad o parámetro.

            -

            La opción «strict» se puede pasar a false para evitar excepciones de tipo Symfony\Component\DependencyInjection\Exception\ScopeCrossingInjectionException, si el aámbito del servicio inyectado es diferente del actual (por ejemplo, request o prototype).

            -
            -
            -
            -

            @InjectParams

            -

            Esta marca los parámetros de un método para inyección:

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\Inject;
-use JMS\DiExtraBundle\Annotation\InjectParams;
-use JMS\DiExtraBundle\Annotation\Service;
-
-/**
- * @Service
- */
-class Listener
-{
-    /**
-     * @InjectParams({
-     *     "em" = @Inject("doctrine.entity_manager")
-     * })
-     */
-    public function __construct(EntityManager $em, Session $session)
-    {
-        // ...
-    }
-}
-
            -
            -

            Si no defines todos los parámetros en la asignación de parámetros, trataremos de adivinar cuáles servicios se deben inyectar basándonos en el nombre de los demás parámetros.

            -
            -
            -

            @Service

            -

            Marca una clase como un servicio:

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\Service;
-
-/**
- * @Service("some.service.id", parent="another.service.id", public=false)
- */
-class Listener
-{
-}
-
            -
            -

            Si no defines explícitamente un identificador del servicio, entonces se generará uno predeterminado basado en el nombre completamente cualificado de la clase.

            -
            -
            -

            @Tag

            -

            Añade una etiqueta al servicio:

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\Service;
-use JMS\DiExtraBundle\Annotation\Tag;
-
-/**
- * @Service
- * @Tag("doctrine.event_listener", attributes = {"event" = "postGenerateSchema", lazy=true})
- */
-class Listener
-{
-    // ...
-}
-
            -
            -
            -
            -

            @Observe

            -

            Automáticamente registra un método como escucha de un determinado evento:

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\Observe;
-use JMS\DiExtraBundle\Annotation\Service;
-
-/**
- * @Service
- */
-class RequestListener
-{
-    /**
-     * @Observe("kernel.request", priority = 255)
-     */
-    public function onKernelRequest()
-    {
-        // ...
-    }
-}
-
            -
            -
            -
            -

            @Validator

            -

            Automáticamente registra la clase como restricción de validación para el componente Validador:

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\Validator;
-use Symfony\Component\Validator\Constraint;
-use Symfony\Component\Validator\ConstraintValidator;
-
-/**
- * @Validator("my_alias")
- */
-class MyValidator extends ConstraintValidator
-{
-    // ...
-}
-
-class MyConstraint extends Constraint
-{
-    // ...
-    public function validatedBy()
-    {
-        return 'my_alias';
-    }
-}
-
            -
            -

            La anotación @Validator además implica la anotación @Service, si no la especificas explícitamente. -Los alias que se pasan a la anotación @Validator deben coincidir con la cadena devuelta desde el método validatedBy de tu restricción.

            -
            -
            -

            @FormType

            -

            Automáticamente registra la clase suministrada como un tipo form en el componente Form de Symfony2.

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\FormType;
-use Symfony\Component\Form\AbstractType;
-
-/**
- * @FormType
- */
-class MyFormType extends AbstractType
-{
-    // ...
-
-    public function getName()
-    {
-        return 'my_form';
-    }
-}
-
-// Controller.php
-$form = $this->formFactory->create('my_form');
-
            -
            -
            -

            Nota

            -

            @FormType implica @Service si no se definió explícitamente.

            -
            -
            -
            -

            @DoctrineListener o @DoctrineMongoDBListener

            -

            Automáticamente, registra la clase dada como un escucha para el ORM de Doctrine o el ODM del MongoDB de Doctrine:

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation\DoctrineListener;
-
-/**
- * @DoctrineListener(
- *     events = {"prePersist", "preUpdate"},
- *     connection = "default",
- *     lazy = true,
- *     priority = 0,
- * )
-class MyListener
-{
-    // ...
-}
-
            -
            -
            -

            Nota

            -

            @DoctrineListener implica @Service si no se definió explícitamente.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSDiExtraBundle/configuration.html b/bundles/JMSDiExtraBundle/configuration.html deleted file mode 100644 index 7bf3035..0000000 --- a/bundles/JMSDiExtraBundle/configuration.html +++ /dev/null @@ -1,201 +0,0 @@ - - - - - - - Configurando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Configurando

            -
            -

            Introducción

            -

            De manera predeterminada, sólo puedes utilizar las anotaciones proporcionadas en tus controladores que no son servicios; Ningún otro directorio es escaneado.

            -

            Sin embargo, si también quisieras utilizar anotaciones para configurar tus servicios normales, puedes configurar más ubicaciones como se muestra más adelante.

            -
            -
            -

            Configurando ubicaciones

            -

            Si quisieras configurar los servicios en un paquete propio vía anotaciones, o tienes algunos servicios externos a cualquier estructura de paquete tal como en tu directorio src/, lo puedes hacer usando las siguientes opciones de configuración, de modo que el paquete las elegirá, y añadirá a tu contenedor de inyección de la dependencias:

            -
            -
              -
            • YAML
              jms_di_extra:
-    locations:
-        all_bundles: false
-        bundles: [FooBundle, AcmeBlogBundle]
-        directories: ["%kernel.root_dir%/../src"]
-
              -
              -
              • -
            • XML
              <jms-di-extra>
-    <locations all-bundles="false">
-        <bundle>FooBundle</bundle>
-        <bundle>AcmeBlogBundle</bundle>
-
-        <directory>%kernel.root_dir%/../src</directory>
-    </locations>
-</jms-di-extra>
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Para optimo rendimiento de desarrollo (en producción no hay ninguna diferencia de cualquier manera), es recomendable configurar explícitamente los directorios que se tendrían que escanear buscando clases de servicio, y no confiar en la opción de configuración all_bundles.

            -
            -
            -
            -

            Inyectando el controlador automáticamente

            -

            Este paquete te permite configurar la inyección de ciertas propiedades y métodos -de controladores automáticamente. Esto es más útil para servicios necesarios comúnmente, los cuales a partir de entonces no se necesita anotarlos explícitamente.

            -
            -
              -
            • YAML
              jms_di_extra:
-    automatic_controller_injections:
-        properties:
-            request: "@request"
-            router: "@router"
-
-        method_calls:
-            setRouter: ["@router"]
-
              -
              -
              • -
            • XML
              <jms-di-extra>
-    <automatic-controller-injections>
-        <property name="request">@request</property>
-        <property name="router">@router</property>
-
-        <method-call name="setRouter">@router</method-call>
-    </automatic-controller-injections>
-</jms-di-extra>
-
              -
              -
              • -
            -
            -

            Si tu controlador tiene alguna de las propiedades o métodos anteriores, entonces nunca más tendrás que añadir una anotacion @Inject, sino que automáticamente se inyectará el servicio que hayas configurado. No obstante, si declaras una anotación @Inject, esta automáticamente sustituye cualquier cosa que hayas configurado en la sección anterior.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSDiExtraBundle/doctrine.html b/bundles/JMSDiExtraBundle/doctrine.html deleted file mode 100644 index df36657..0000000 --- a/bundles/JMSDiExtraBundle/doctrine.html +++ /dev/null @@ -1,180 +0,0 @@ - - - - - - - Integrando con Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Integrando con Doctrine

            -

            -Nuevo en la versión 1.1: Se agregó la integración con Doctrine.

            -
            -

            Configuración

            -

            La integración con Doctrine está habilitada de manera predeterminada. Sin embargo, fácilmente puedes la puedes desactivar en tu configuración:

            -
            -
              -
            • YAML
              jms_di_extra:
-    doctrine_integration: false
-
              -
              -
              • -
            • XML
              <jms-di-extra doctrine-integration="false" />
-
              -
              -
              • -
            -
            -
            -
            -

            Inyectando dependencias en repositorios

            -

            Si has habilitado integración de Doctrine, ahora puedes inyectar dependencias en repositorios utilizando anotaciones:

            -
            use JMS\DiExtraBundle\Annotation as DI;
-
-class MyRepository extends EntityRepository
-{
-    private $uuidGenerator;
-
-    /**
-     * @DI\InjectParams({
-     *     "uuidGenerator" = @DI\Inject("my_uuid_generator"),
-     * })
-     */
-    public function setUuidGenerator(UUidGenerator $uuidGenerator)
-    {
-        $this->uuidGenerator = $uuidGenerator;
-    }
-
-    // ...
-}
-
            -
            -
            -

            Nota

            -

            Si no quieres usar anotaciones, también puedes implementar la Symfony\Componente\DependencyInjection\ContainerAwareInterface en tus repositorios para recibir el contenedor del servicio entero.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSDiExtraBundle/index.html b/bundles/JMSDiExtraBundle/index.html deleted file mode 100644 index 5837778..0000000 --- a/bundles/JMSDiExtraBundle/index.html +++ /dev/null @@ -1,158 +0,0 @@ - - - - - - - JMSDiExtraBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            JMSDiExtraBundle

            -
            -

            Introducción

            -

            JMSDiExtraBundle añade más potentes características a la inyección de dependencias en Symfony2:

            -
              -
            • Configuración de la inyección de dependencias vía anotaciones
              • -
            • Convención de inyección de dependencias basada en controladores
              • -
            • Capacidades orientadas a la programación de aspectos para controladores
              • -
            -
            - -
            -

            Licencia

            -

            El código se libera bajo la amigable licencia empresarial de Apache2.

            -

            La documentación está sujeta a la Licencia de atribución no comercial sin derivaciones 3.0 recíproca.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSDiExtraBundle/installation.html b/bundles/JMSDiExtraBundle/installation.html deleted file mode 100644 index ccb76c0..0000000 --- a/bundles/JMSDiExtraBundle/installation.html +++ /dev/null @@ -1,168 +0,0 @@ - - - - - - - Instalando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Instalando

            -
            -

            Nota

            -

            Esta versión ya no es compatible con Symfony 2.0.x. Por favor utiliza una versión más antigua de este paquete si todavía estás usando las series 2.0.

            -
            -

            JMSDiExtraBundle se puede instalar convenientemente vía Composer. Sólo añada lo siguiente a tu archivo composer.json:

            -
            // composer.json
-{
-    // ...
-    require: {
-        // ...
-        "jms/di-extra-bundle": "dev-master"
-    }
-}
-
            -
            -
            -

            Nota

            -

            Por favor sustituye dev-master en el fragmento anterior con la rama estable más reciente, por ejemplo 1.0.*. Además comprueba las etiquetas en Github para ver cuales versiones están disponibles.

            -
            -

            Luego, puedes instalar las nuevas dependencias ejecutando la orden upgrade desde el directorio donde está tu archivo composer.json:

            -
            $ php composer.phar update
-
            -
            -

            Ahora, Composer automáticamente descargará todos los archivos necesarios y los instalará para ti. Todo lo que falta por hacer es actualizar tu archivo AppKernel.php` y registrar el nuevo paquete:

            -
            <?php
-
-// en AppKernel::registerBundles()
-$bundles = array(
-    // ...
-    new JMS\DiExtraBundle\JMSDiExtraBundle($this),
-    new JMS\AopBundle\JMSAopBundle(),
-    // ...
-);
-
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSDiExtraBundle/lazy_service_collections.html b/bundles/JMSDiExtraBundle/lazy_service_collections.html deleted file mode 100644 index e7841cd..0000000 --- a/bundles/JMSDiExtraBundle/lazy_service_collections.html +++ /dev/null @@ -1,215 +0,0 @@ - - - - - - - Colección de servicios diferidos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Colección de servicios diferidos

            -

            Este paquete proporciona un mapa/secuencia genérica de servicios diferidos. La puedes utilizar cuando tienes un mapa, o una lista de servicios donde únicamente necesitas iniciar unos cuantos servicios específicos durante una sóla petición.

            -
            -

            Secuencia de servicio diferido

            -

            A menudo tienes una lista de servicios en la cuál iteras hasta que un servicio es capaz de manejar tu petición. En Symfony2, un ejemplo podría ser el gestor de decisiones de acceso que itera sobre los votantes hasta que encuentra uno que es capaz de hacer una llamada si se debería o no conceder acceso, y luego potencialmente detenerlo. En tal caso, cualquiera de los otros votantes, y sus dependencias no son necesarios, y no se deberían iniciar.

            -

            El servicio de secuencia diferida garantiza que la iniciación se retrasa hasta que de hecho un servicio es necesario. Empieza escribiendo el servicio que consume la secuencia:

            -
            use JMS\DiExtraBundle\Annotation as DI;
-use PhpCollection\Sequence;
-
-class MyService
-{
-    private $voters;
-
-    public function __construct(Sequence $voters)
-    {
-        $this->voters = $voters;
-    }
-
-    public function isGranted(...)
-    {
-        foreach ($this->voters as $voter) {
-            // hace algo, potencialmente regresa anticipadamente.
-        }
-    }
-}
-
            -
            -

            Supón que etiquetas tus votantes en el CID para permitir que otros paquetes registren servicios. Luego, puedes utilizar el LazyServiceSequencePass proporcionado el cuál cuidará de recoger los servicios etiquetados, y generará la definición para la secuencia:

            -
            use JMS\DiExtraBundle\Compiler\LazyServiceSequencePass;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\HttpKernel\Bundle\Bundle;
-
-class MyBundle extends Bundle
-{
-    public function build(ContainerBuilder $container)
-    {
-        $container->addCompilerPass(new LazyServiceSequencePass('voter',
-            function(ContainerBuilder $container, Definition $seqDef) {
-                // Añade la definición de la secuencia como argumento para la clase MyService.
-                $container->getDefinition('my_service')->addArgument($seqDef);
-            }
-        ));
-    }
-}
-
            -
            -
            -
            -

            Mapa de servicios diferidos

            -

            Por ejemplo, si tienes un mapa de formatos a codificadores correspondientes. Muy probablemente, durante una petición, sólo necesites cargar el codificador para un formato específico. Usando el mapa, la carga de ese codificador se retrasará hasta que sabes qué formato necesitas, y no cargas los codificadores (y sus dependencias) para otros formatos.

            -

            Empieza escribiendo el servicio que consume el mapa:

            -
            use JMS\DiExtraBundle\Annotation as DI;
-use PhpCollection\Map;
-
-/** @DI\Service("my_service") */
-class MyService
-{
-    private $encoders;
-
-    public function __construct(Map $encoders)
-    {
-        $this->encoders = $encoders;
-    }
-
-    public function useEncoder($format)
-    {
-        // El codificador se carga aquí.
-        $encoder = $this->encoders->get('json')->get();
-    }
-}
-
            -
            -

            Luego, añade algunos de los que etiquetaste para permitir que los añadiran otros paquetes también:

            -
            /** @DI\Service @DI\Tag("encoder", attributes = {"format": "json"}) */
-class JsonEncoder { }
-
-/** @DI\Service @DI\Tag("encoder", attributes = {"format": "xml"}) */
-class XmlEncoder { }
-
            -
            -

            Finalmente, sólo necesitas añadir la definición del mapa de ID que fue construida por el LazyServiceMapPass proporcionado como argumento de tu servicio my_service:

            -
            use JMS\DiExtraBundle\Compiler\LazyServiceMapPass;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\HttpKernel\Bundle\Bundle;
-
-class MyBundle extends Bundle
-{
-    public function build(ContainerBuilder $container)
-    {
-        $container->addCompilerPass(new LazyServiceMapPass('encoder', 'format',
-            function(ContainerBuilder $container, Definition $mapDef) {
-                // Añade la definición del mapa como argumento para la clase MyService.
-                $container->getDefinition('my_service')->addArgument($mapDef);
-            }
-        ));
-    }
-}
-
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSDiExtraBundle/usage.html b/bundles/JMSDiExtraBundle/usage.html deleted file mode 100644 index 521de88..0000000 --- a/bundles/JMSDiExtraBundle/usage.html +++ /dev/null @@ -1,220 +0,0 @@ - - - - - - - Usándola — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Usándola

            -
            -

            Clases no controladoras

            -

            Las clases no controladoras están configuradas, y gestionadas por Symfony DIC justo como cualquier otro servicio que configuras utilizando YAML, XML o PHP. La única diferencia es que lo puedes hacer a través de anotaciones, lo cual es mucho más conveniente.

            -

            Puedes utilizar estas anotaciones en servicios (para ejemplos, ve más adelante): -@Service, @Inject, @InjectParams, @Observe, @Tag

            -

            Ten en cuenta que no puedes usar la anotación @Inject en propiedades privadas o protegidas. -Del mismo modo, la anotación @InjectParams no funciona en métodos protegidos o privados.

            -
            -
            -

            Controladores

            -

            Los controladores son un tipo de clase especial que también son tratadas especialmente por este paquete. La diferencia más notable es que no es necesario definir estas clases como servicios. Sí, no hay servicios, pero no te preocupes que todavía puedes utilizar todas las características de la DIC, e incluso algunas más.

            -
            -

            Inyectando en el constructor/definidor

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation as DI;
-
-class Controller
-{
-    private $em;
-    private $session;
-
-    /**
-     * @DI\InjectParams({
-     *     "em" = @DI\Inject("doctrine.orm.entity_manager"),
-     *     "session" = @DI\Inject("session")
-     * })
-     */
-    public function __construct($em, $session)
-    {
-        $this->em = $em;
-        $this->session = $session;
-    }
-    // ... algunas acciones
-}
-
            -
            -
            -

            Nota

            -

            La inyección en el constructor no es posible cuándo una definición del padre también define un constructor qué está configurado para inyección.

            -
            -
            -
            -

            Inyectando propiedades

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation as DI;
-
-class Controller
-{
-    /** @DI\Inject("doctrine.orm.entity_manager") */
-    private $em;
-
-    /** @DI\Inject("session") */
-    private $session;
-}
-
            -
            -
            -

            Nota

            -

            Inyectar propiedades privadas o protegidas sólo es compatible en controladores.

            -
            -
            -
            -

            Inyectando en método/captador

            -
            <?php
-
-use JMS\DiExtraBundle\Annotation as DI;
-
-class Controller
-{
-    public function myAction()
-    {
-        // ...
-        if ($condition) {
-            $mailer = $this->getMailer();
-        }
-    }
-
-    /** @DI\LookupMethod("mailer") */
-    protected function getMailer() { /* aquí el cuerpo está vacío */ }
-}
-
            -
            -

            Puedes utilizar este tipo de inyección si tienes una dependencia que no siempre se necesita en el controlador, y que es costoso iniciarla, como el mailer en el ejemplo anterior.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/annotations.html b/bundles/JMSSecurityExtraBundle/annotations.html deleted file mode 100644 index cbb9523..0000000 --- a/bundles/JMSSecurityExtraBundle/annotations.html +++ /dev/null @@ -1,274 +0,0 @@ - - - - - - - Anotaciones — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Anotaciones

            -
            -

            @PreAuthorize

            -

            Esta anotación te permite definir una expresión (ve el párrafo del lenguaje de expresiones) que se ejecutó anteriormente a la invocación de un método:

            -
            -
            -
            -
            <?php
-
-use JMS\SecurityExtraBundle\Annotation\PreAuthorize;
-
-class MyService
-{
-    /** @PreAuthorize("hasRole('A') or (hasRole('B') and hasRole('C'))") */
-    public function secureMethod()
-    {
-        // ...
-    }
-}
-
            -
            -
            -

            Truco

            -

            Si quieres asegurar todas las acciones del controlador con la misma regla, también puedes especificar @PreAuthorize en la misma clase. Aun así ten cuidado, esta regla sólo se aplica a los métodos declarados en la clase.

            -
            -
            -
            -

            @Secure

            -

            Esta anotación te permite definir quién está autorizado a invocar un método:

            -
            -
            -
            -
            <?php
-
-use JMS\SecurityExtraBundle\Annotation\Secure;
-
-class MyService
-{
-    /**
-     * @Secure(roles="ROLE_USER, ROLE_FOO, ROLE_ADMIN")
-     */
-    public function secureMethod()
-    {
-        // ...
-    }
-}
-
            -
            -
            -
            -

            @SecureParam

            -

            Esta anotación te permite definir restricciones para los parámetros que se le pasan al método. Esto sólo es útil si los parámetros son objetos del dominio:

            -
            -
            -
            -
            <?php
-
-use JMS\SecurityExtraBundle\Annotation\SecureParam;
-
-class MyService
-{
-    /**
-     * @SecureParam(name="comment", permissions="EDIT, DELETE")
-     * @SecureParam(name="post", permissions="OWNER")
-     */
-    public function secureMethod($comment, $post)
-    {
-        // ...
-    }
-}
-
            -
            -
            -
            -

            @SecureReturn

            -

            Esta anotación te permite definir restricciones para el valor que devuelve el método. Esto también es útil sólo si el valor devuelto es un objeto del dominio:

            -
            -
            -
            -
            <?php
-
-use JMS\SecurityExtraBundle\Annotation\SecureReturn;
-
-class MyService
-{
-    /**
-     * @SecureReturn(permissions="VIEW")
-     */
-    public function secureMethod()
-    {
-        // ...
-
-        return $domainObject;
-    }
-}
-
            -
            -
            -
            -

            @RunAs

            -

            Esta anotación te permite especificar los roles que se añadirán sólo mientras subsista la invocación del método. Estos roles no serán tomados en consideración antes o después de las decisiones de acceso en la invocación.

            -

            Este se suele utilizar para implementar una capa de dos niveles para el servicio, donde tienes servicios públicos y privados, y los servicios privados únicamente son invocados a través de un servicio público específico:

            -
            -
            -
            -
            <?php
-
-use JMS\SecurityExtraBundle\Annotation\Secure;
-use JMS\SecurityExtraBundle\Annotation\RunAs;
-
-class MyPrivateService
-{
-    /**
-     * @Secure(roles="ROLE_PRIVATE_SERVICE")
-     */
-    public function aMethodOnlyToBeInvokedThroughASpecificChannel()
-    {
-        // ...
-    }
-}
-
-class MyPublicService
-{
-    protected $myPrivateService;
-
-    /**
-     * @Secure(roles="ROLE_USER")
-     * @RunAs(roles="ROLE_PRIVATE_SERVICE")
-     */
-    public function canBeInvokedFromOtherServices()
-    {
-        return $this->myPrivateService->aMethodOnlyToBeInvokedThroughASpecificChannel();
-    }
-}
-
            -
            -
            -
            -

            @SatisfiesParentSecurityPolicy

            -

            Esto lo debes definir en un método que sustituya al método que tiene metadatos de seguridad. -Está ahí para asegurarse de que estás consciente de que la seguridad del método reemplazado no se puede hacer valer más, y que tienes que copiar todas las anotaciones si deseas mantenerlas.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/configuration.html b/bundles/JMSSecurityExtraBundle/configuration.html deleted file mode 100644 index f94a6ea..0000000 --- a/bundles/JMSSecurityExtraBundle/configuration.html +++ /dev/null @@ -1,191 +0,0 @@ - - - - - - - Configurando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Configurando

            -

            La siguiente es la configuración predefinida:

            -
            -
              -
            • YAML
              # app/config/config.yml
-jms_security_extra:
-    # Cuando quieras asegurar todos los servicios (true), o únicamente
-# proteger servicios específicos (false); ve más adelante
-secure_all_services: false
-
-    # Al activar esta opción se agrega un atributo especial
-    # "ROLE_IDDQD" adicional.
-    # especial "IS_IDDQD". Cualquiera con este atributo efectivamente
-# evadirá todas las comprobaciones de seguridad.
-    enable_iddqd_attribute: false
-
-# Habilita el lenguaje de expresiones
-expressions: false
-
-    # Te permite desactivar algunos, o todos los votantes
-    voters:
-        disable_authenticated: false
-    disable_role:          false
-    disable_acl:           false
-
-    # Te permite especificar reglas de control de acceso para métodos
-    # específicos, tal como los controladores de acción
-    method_access_control: { }
-
-    util:
-        secure_random:
-            connection: # el nombre de la conexión a doctrine
-            table_name: seed_table
-            seed_provider: # id del servicio de tu propia
-                       # implementación proveedora de semilla
-
              -
              -
              • -
            • XML
              <jms-security-extra
-    secure-all-services="false"
-    enable-iddqd-attribute="false"
-    expressions="false">
-
-    <voters disable-authenticated="false"
-            disable-role="false"
-            disable-acl="false" />
-
-    <util>
-        <secure-random
-            connection="default"
-            table-name="seed-table"
-            seed-provider="some-service-id" />
-    </util>
-</jms-security-extra>
-
              -
              -
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/cookbook/creating_your_own_expression_function.html b/bundles/JMSSecurityExtraBundle/cookbook/creating_your_own_expression_function.html deleted file mode 100644 index 6f6ea0e..0000000 --- a/bundles/JMSSecurityExtraBundle/cookbook/creating_your_own_expression_function.html +++ /dev/null @@ -1,177 +0,0 @@ - - - - - - - Creando tus propieas funciones de expresión — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Creando tus propieas funciones de expresión

            -

            -Nuevo en la versión 1.3: @DI\SecurityFunction fue añadida en 1.3.

            -

            Incluso aunque las expresiones integradas ya te permiten hacer mucho, hay casos donde querrás añadir una función de expresión personalizada.

            -

            Supón que quieres comprobar que un usuario tiene una determinada IP, lo podrías hacer usando esta expresión container.get("request").getIp() == "127.0.0.1". -sin embargo, si duplicas esto en varias acciones, se vuelve en mucho que escribir. Además, ¿qué pasa si quieres añadir otra IP? Tendrías que editar todos los sitios donde utilices esta expresión. Por lo tanto, en vez de la expresión anterior, añades otra función isLocalUser(), misma que puedes utilizar en tus expresiones.

            -
            -
            -
            -
            <?php
-
-namespace Acme\DemoBundle\Security;
-
-use Symfony\Component\DependencyInjection\ContainerInterface;
-use JMS\DiExtraBundle\Annotation as DI;
-
-/** @DI\Service */
-class RequestAccessEvaluator
-{
-    private $container;
-
-    /**
-     * @DI\InjectParams({
-     *     "container" = @DI\Inject("service_container"),
-     * })
-     */
-    public function __construct(ContainerInterface $container)
-    {
-        $this->container = $container;
-    }
-
-    /** @DI\SecurityFunction("isLocalUser") */
-    public function isLocalUser()
-    {
-        return $this->container->get('request')->getIp() === '127.0.0.1';
-    }
-}
-
            -
            -
            -

            Nota

            -

            Si estás utilizando anotaciones para configurar el servicio (@DI\Service) asegurate de que la ruta a tu archivo es escaneado por el JMSDiExtraBundle. Para más información, por favor, ve configurando JMSDiExtraBundle.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/expressions.html b/bundles/JMSSecurityExtraBundle/expressions.html deleted file mode 100644 index 2c855bf..0000000 --- a/bundles/JMSSecurityExtraBundle/expressions.html +++ /dev/null @@ -1,267 +0,0 @@ - - - - - - - Lenguaje de autorización basado en expresiones — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Lenguaje de autorización basado en expresiones

            -
            -

            Introducción

            -

            El lenguaje de expresiones es una muy potente alternativa para los atributos simples de los votantes del sistema de seguridad. Te permiten tomar decisiones complejas para controlar el acceso, y debido a que está compiladas hasta PHP crudo, son mucho más rápidas que los votantes integrados. Estas además se cargan de manera diferida por naturaleza, así que también ahorrarás algunos recursos, por ejemplo, no tener que iniciar el sistema ACL entero en cada petición.

            -
            -
            -

            Uso

            -
            -

            Uso programado

            -

            Puedes ejecutar expresiones programadas utilizando el método isGranted del SecurityContext. Algunos ejemplos:

            -
            -
            -
            -
            <?php
-
-use JMS\SecurityExtraBundle\Security\Authorization\Expression\Expression;
-
-$securityContext->isGranted(array(new Expression('hasRole("A")')));
-$securityContext->isGranted(array(new Expression('hasRole("A") or (hasRole("B") and hasRole("C"))')));
-$securityContext->isGranted(array(new Expression('hasPermission(object, "VIEW")'), $object));
-$securityContext->isGranted(array(new Expression('token.getUsername() == "Johannes"')));
-
            -
            -
            -
            -

            Usando Twig

            -

            Puedes comprobar expresiones desde plantillas Twig utilizando la función is_expr_granted. Algunos ejemplos:

            -
            is_expr_granted("hasRole('FOO')")
-is_expr_granted("hasPermission(object, 'VIEW')", object)
-
            -
            -
            -
            -

            Usando el control de acceso

            -

            También puedes usar expresiones en access_control:

            -
            -
              -
            • YAML
              security:
-    access_control:
-        - { path: ^/foo, access: "hasRole('FOO') and hasRole('BAR')" }
-
              -
              -
              • -
            • XML
              <security>
-    <rule path="^/foo" access="hasRole('FOO') and hasRole('BAR')" />
-</security>
-
              -
              -
              • -
            -
            -
            -
            -

            Usándolo en base a anotaciones

            -

            Consulta la anotación @PreAuthorize en la Referencia. Por favor, recuerda activar las expresiones en tu configuración, de lo contrario obtendrás una excepción al comprobar el acceso.

            -
            -
            -
            -

            Referencia

            - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
            ExpresiónDescripción
            hasRole(‘ROLE’)comprueba si el segmento tiene un determinado rol.
            hasAnyRole(‘ROLE1’, ‘ROLE2’, ...)Comprueba si el segmento tiene alguno de los roles -proporcionados.
            isAnonymous()Comprueba si el segmento es anónimo.
            isRememberMe()Comprueba si el segmento es del tipo “Recuérdame”.
            isFullyAuthenticated()Comprueba si el segmento está completamente -autenticado.
            isAuthenticated()Comprueba si el segmento no es anónimo.
            hasPermission(var, ‘PERMISSION’)Comprueba si el segmento tiene los permisos -proporcionados para un objeto dado (necesita el -sistema ACL).
            tokenVariable que permite el acceso al segmento que se -encuentra actualmente en el contexto de seguridad.
            userVariable que permite el acceso al usuario que está -actualmente en el contexto de seguridad.
            objectVariable que hace referencia al objeto para el cual se -solicita acceso.
            #*paramName*Cualquier identificador prefijado con # se refiere a -un parámetro del mismo nombre pasado al método donde -se usa la expresión
            and / &&El operador binario «and»
            or / ||El operador binario «or»
            ==El operador binario «is equal»
            not / !Operador de negación
            -
            -
            -

            Recursos adicionales

            -
            -
            - -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/index.html b/bundles/JMSSecurityExtraBundle/index.html deleted file mode 100644 index ac631a3..0000000 --- a/bundles/JMSSecurityExtraBundle/index.html +++ /dev/null @@ -1,161 +0,0 @@ - - - - - - - JMSSecurityExtraBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            JMSSecurityExtraBundle

            -
            -

            Resumen

            -

            Este paquete mejora el componente Security de Symfony2 añadiendo nuevas características.

            -

            Características:

            -
              -
            • Potente lenguaje de autorización basado en expresiones
              • -
            • Método de seguridad para autorización
              • -
            • Configuración de autorización vía anotaciones
              • -
            • Generador de números aleatorios seguros
              • -
            -
            - -
            -

            Licencia

            -

            El código está liberado bajo la amigable Licencia de Apache2.

            -

            La documentación está sujeta a la Attribution-NonCommercial-NoDerivs 3.0 Unported -license.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/installation.html b/bundles/JMSSecurityExtraBundle/installation.html deleted file mode 100644 index 880b2db..0000000 --- a/bundles/JMSSecurityExtraBundle/installation.html +++ /dev/null @@ -1,240 +0,0 @@ - - - - - - - Instalando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Instalando

            -
            -
            -

            1. Usando Composer (recomendado)

            -

            Para instalar JMSSecurityExtraBundle con Composer sólo añade lo siguiente al tu archivo composer.json:

            -
            // composer.json
-{
-    // ...
-    require: {
-        // ...
-        "jms/security-extra-bundle": "dev-master"
-    }
-}
-
            -
            -
            -

            Nota

            -

            Por favor, sustituye dev-master en el fragmento anterior con la última rama estable, por ejemplo 1.0.*.

            -
            -

            Luego, puedes instalar las nuevas dependencias ejecutando la orden update de Composer desde el directorio donde tienes tu archivo composer.json:

            -
            $ php composer.phar update jms/security-extra-bundle
-
            -
            -

            Ahora, Composer automáticamente descargará todos los archivos necesarios y los instalará -por ti. Todo lo que resta por hacer es actualizar el archivo AppKernel.php y registrar el nuevo paquete:

            -
            -
            -
            -
            <?php
-
-// en AppKernel::registerBundles()
-$bundles = array(
-    // ...
-    new JMS\AopBundle\JMSAopBundle(),
-    new JMS\SecurityExtraBundle\JMSSecurityExtraBundle(),
-    new JMS\DiExtraBundle\JMSDiExtraBundle($this),
-    // ...
-);
-
            -
            -
            -
            -

            2. Usando el archivo deps (Symfony 2.0.x)

            -

            En primer lugar consigue una copia del código. Sólo tienes que añadir lo siguiente al archivo deps de tu distribución estándar de Symfony:

            -
            [JMSSecurityExtraBundle]
-    git=https://github.com/schmittjoh/JMSSecurityExtraBundle.git
-    target=/bundles/JMS/SecurityExtraBundle
-
-; Dependencias:
-;--------------
-[metadata]
-    git=https://github.com/schmittjoh/metadata.git
-    version=1.1.0 ; <- asegúrate de conseguir 1.1, no 1.0
-
-; ve https://github.com/schmittjoh/JMSAopBundle/blob/master/Resources/doc/index.rst
-[JMSAopBundle]
-    git=https://github.com/schmittjoh/JMSAopBundle.git
-    target=/bundles/JMS/AopBundle
-
-[cg-library]
-    git=https://github.com/schmittjoh/cg-library.git
-
-; Esta dependencia es opcional (la necesitas si no estás usando
-; servicios como controladores):
-; Consulta https://github.com/schmittjoh/JMSDiExtraBundle/blob/master/Resources/doc/index.rst
-
-[JMSDiExtraBundle]
-    git=https://github.com/schmittjoh/JMSDiExtraBundle.git
-    target=/bundles/JMS/DiExtraBundle
-
            -
            -

            Luego registra el paquete en tu núcleo:

            -
            -
            -
            -
            <?php
-
-// en AppKernel::registerBundles()
-$bundles = array(
-    // ...
-    new JMS\AopBundle\JMSAopBundle(),
-    new JMS\SecurityExtraBundle\JMSSecurityExtraBundle(),
-    new JMS\DiExtraBundle\JMSDiExtraBundle($this),
-    // ...
-);
-
            -
            -

            Asegúrate de registrar los espacios de nombres en tu cargador automático:

            -
            -
            -
            -
            <?php
-
-// app/autoload.php
-$loader->registerNamespaces(array(
-    // ...
-    // ...
-    'JMS'              => __DIR__.'/../vendor/bundles',
-    'Metadata'         => __DIR__.'/../vendor/metadata/src',
-    'CG'               => __DIR__.'/../vendor/cg-library/src',
-    // ...
-));
-
            -
            -

            Ahora usa el programa vendors para clonar en tu proyecto los repositorios recientemente añadidos:

            -
            php bin/vendors install
-
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/method_security_authorization.html b/bundles/JMSSecurityExtraBundle/method_security_authorization.html deleted file mode 100644 index 8b6cb17..0000000 --- a/bundles/JMSSecurityExtraBundle/method_security_authorization.html +++ /dev/null @@ -1,178 +0,0 @@ - - - - - - - Método de seguridad para autorización — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Método de seguridad para autorización

            -

            Los métodos de seguridad permiten controlar el acceso con más detalle del que tiene para ofrecer Symfony2.

            -

            Generalmente puedes salvaguardar todos los métodos públicos, protegidos que no son estáticos, y no son finales. Los métodos privados no se pueden asegurar. También puedes añadir metadatos para métodos abstractos, o interfaces que entonces serán aplicados automáticamente a sus implementaciones concretas.

            -
            -

            Control de acceso vía configuración DI

            -

            Puedes especificar expresiones para el control de acceso en la configuración DI:

            -
            # config.yml
-jms_security_extra:
-    method_access_control:
-        ':loginAction$': 'isAnonymous()'
-        'AcmeFooBundle:.*:deleteAction': 'hasRole("ROLE_ADMIN")'
-        '^MyNamespace\MyService::foo$': 'hasPermission(#user, "VIEW")'
-
            -
            -

            El patrón es una expresión regular que distingue entre mayúsculas y minúsculas emparejada contra dos notaciones. -Se utiliza la primer coincidencia.

            -

            En primer lugar, tu patrón se compara con la notación de controladores que no son servicios. -Obviamente, esto sólo se hace si tu clase en realidad es un controlador, por ejemplo, AcmeFooBundle:Add:new para un controlador llamado AddController y un método denominado NewAction en un subespacio de nombres Controller de un paquete llamado AcmeFooBundle.

            -

            Por último, tu patrón se empareja contra la concatenación del nombre de clase, y el nombre del método que está invocando, por ejemplo, Mi\Completamente\Cualificado\NombreClase::miNombreMetodo.

            -
            -

            Nota

            -

            Si quisieras asegurar controladores que no son servicios, en su lugar deberías usar el JMSDiExtraBundle.

            -
            -
            -
            -

            Control de acceso vía anotaciones

            -

            Si quisieras asegurar un servicio con anotaciones, necesitas habilitar la configuración de annotation para ese servicio:

            -
            -
              -
            • YAML
              services:
-    foo:
-        class: Bar
-        tags: [ { name: "security.secure_service" } ]
-
              -
              -
              • -
            • XML
              <service id="foo" class="Bar">
-    <tag name="security.secure_service"/>
-</service>
-
              -
              -
              • -
            -
            -

            En caso que quieras configurar todos los servicios vía anotaciones, también puedes poner secure_all_services a true. Entonces, no necesitas añadir una etiqueta a cada servicio.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/JMSSecurityExtraBundle/random_number_generator.html b/bundles/JMSSecurityExtraBundle/random_number_generator.html deleted file mode 100644 index 032ea5c..0000000 --- a/bundles/JMSSecurityExtraBundle/random_number_generator.html +++ /dev/null @@ -1,165 +0,0 @@ - - - - - - - Generador de números aleatorios seguros — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Generador de números aleatorios seguros

            -

            -Nuevo en la versión 1.2: Se añadió el generador de números aleatorios seguros.

            -
            -
            -

            Introducción

            -

            En casi todas las aplicaciones, necesitas generar números aleatorios que un posible atacante no pueda adivinar. Desafortunadamente, PHP no proporciona la capacidad para hacerlo de forma consistente en todas las plataformas.

            -

            Este paquete viene con varias implementaciones de proveedores de semillas, y se elige el mejor proveedor posible, dependiendo de tu configuración de PHP.

            -
            -
            -

            Configurando

            -

            Puedes activar el servicio «security.secure_random» con la siguiente configuración:

            -
            -
              -
            • YAML
              jms_security_extra:
-    util:
-        secure_random: ~
-
              -
              -
              • -
            • XML
              <jms-security-extra>
-    <util>
-        <secure-random />
-    </util>
-</jms-security-extra>
-
              -
              -
              • -
            -
            -

            También asegúrate de ejecutar php app/console doctrine:scheme:update, o crea una migración equivalente para importar la tabla seed.

            -
            -
            -

            Usándolo

            -

            El generador se activa con el id de servicio security.secure_random.

            -
            <?php
-
-$generator = $this->container->get('security.secure_random');
-$bytes = $generator->nextBytes(16); // número aleatorio de 128-bit
-
            -
            -

            $bytes en el ejemplo anterior contiene datos binarios. Luego puedes convertir estos datos a un formato que puedas imprimir utilizando una de estas funciones:

            -
            -
            -
            -
            <?php
-
-$base64Encoded = base64_encode($bytes); // número en base 64
-$hexEncoded = bin2hex($bytes); // número en base 16
-$decEncoded = bindec($bytes); // número en base 10
-
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioFrameworkExtraBundle/annotations/cache.html b/bundles/SensioFrameworkExtraBundle/annotations/cache.html deleted file mode 100644 index 4c2c066..0000000 --- a/bundles/SensioFrameworkExtraBundle/annotations/cache.html +++ /dev/null @@ -1,204 +0,0 @@ - - - - - - - @Cache — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            @Cache

            -
            -

            Usando

            -

            La anotación @cache facilita la definición del almacenamiento en caché HTTP:

            -
            use Sensio\Bundle\FrameworkExtraBundle\Configuration\Cache;
-
-/**
- * @Cache(expires="tomorrow")
- */
-public function indexAction()
-{
-}
-
            -
            -

            También puedes utilizar la anotación en una clase para definir el almacenamiento en caché para todos sus métodos:

            -
            /**
- * @Cache(expires="tomorrow")
- */
-class BlogController extends Controller
-{
-}
-
            -
            -

            Cuando hay un conflicto entre la configuración de la clase y la configuración del método, esta última reemplaza a la anterior:

            -
            /**
- * @Cache(expires="tomorrow")
- */
-class BlogController extends Controller
-{
-    /**
-     * @Cache(expires="+2 days")
-     */
-    public function indexAction()
-    {
-    }
-}
-
            -
            -
            -
            -

            Atributos

            -

            Aquí está una lista de los atributos aceptados y su encabezado HTTP equivalente:

            - ---- - - - - - - - - - - - - - - - - - - - -
            AnotaciónMétodo de respuesta
            @Cache(expires="tomorrow")$response->setExpires()
            @Cache(smaxage="15")$response->setSharedMaxAge()
            @Cache(maxage="15")$response->setMaxAge()
            @Cache(vary=["Cookie"])`$response->setVary()
            -
            -

            Nota

            -

            El atributo expires toma cualquier fecha válida entendida por la función strtotime() de PHP.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioFrameworkExtraBundle/annotations/converters.html b/bundles/SensioFrameworkExtraBundle/annotations/converters.html deleted file mode 100644 index e6725ec..0000000 --- a/bundles/SensioFrameworkExtraBundle/annotations/converters.html +++ /dev/null @@ -1,320 +0,0 @@ - - - - - - - @ParamConverter — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            @ParamConverter

            -
            -

            Usando

            -

            La anotación @ParamConverter llama a converters para convertir parámetros de la petición a objetos. Estos objetos se almacenan como atributos de la petición y por lo tanto se pueden inyectar en los argumentos del método controlador:

            -
            use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
-
-/**
- * @Route("/blog/{id}")
- * @ParamConverter("post", class="SensioBlogBundle:Post")
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -

            Suceden varias cosas bajo el capó:

            -
              -
            • El convertidor intenta obtener un objeto SensioBlogBundle:Post desde los atributos de la petición (los atributos de la petición provienen de los marcadores de posición de la ruta – aquí id);
              • -
            • Si no se encontró algún objeto Post, se genera una respuesta 404;
              • -
            • Si se encuentra un objeto Post, se define un nuevo atributo post para la petición (accesible a través de $request->attributes->get('post'));
              • -
            • Al igual que cualquier otro atributo de la petición, este se inyecta automáticamente en el controlador cuando está presente en la firma del método.
              • -
            -

            Si utilizas el tipo como el del ejemplo anterior, incluso puedes omitir la anotación @ParamConverter por completo:

            -
            // automático con firma de método
-public function showAction(Post $post)
-{
-}
-
            -
            -

            Para detectar qué convertidor está corrido en un parámetro se ejecuta el siguiente proceso :

            -
              -
            • Si se eligió un convertidor explícitamente con @ParamConverter(converter="nombre") se elige el convertidor con el nombre dado.
              • -
            • De lo contrario se itera sobre todos los parámetros de convertidores registrados por prioridad. -El método supports() es invocado para comprobar si un parámetro convertidor puede convertir la petición en el parámetro requerido. Si regresa true el parámetro converter es invocado.
              • -
            -
            -
            -

            Convertidores integrados

            -

            El paquete tiene dos convertidor integrados, uno es el convertidor Doctrine y el otro``DateTime``.

            -
            -

            Convertidor Doctrine

            -

            Nombre de convertidor: doctrine.orm

            -

            El convertidor de Doctrine intenta convertir los atributos de la petición a entidades -de recuperadas de la base de datos por Doctrine. Hay dos distintos posibles enfoques:

            -
              -
            • Recuperar el objeto por clave primaria
              • -
            • Recuperar el objeto por uno o varios campos que contienen valores únicos en la base de datos.
              • -
            -

            El siguiente algoritmo determina qué operación realizar.

            -
              -
            • Si en la ruta está presente un argumento {id}, busca el objeto por clave primaria.
              • -
            • Si se configura una opción 'id' y el argumento ruta concuerda, busca el objeto por clave primaria.
              • -
            • Si no aplican las reglas anteriores, intenta encontrar una entidad emparejando los argumentos de la ruta con los campos de la entidad. Puedes controlar este proceso configurando el argumento exclude o asignando un atributo al campo llamado mapping.
              • -
            -

            De manera predeterminada, el convertidor de Doctrine utiliza el valor predeterminado del gestor de la entidad. Lo puedes configurar con la opción entity_manager:

            -
            use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
-
-/**
- * @Route("/blog/{id}")
- * @ParamConverter("post", class="SensioBlogBundle:Post", options={"entity_manager" = "foo"})
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -

            Si el marcador de posición no tiene el mismo nombre como clave primaria, pasa la opción id:

            -
            /**
- * @Route("/blog/{post_id}")
- * @ParamConverter("post", class="SensioBlogBundle:Post", options={"id" = "post_id"})
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -

            Esto también te permite tener múltiples convertidores en una acción:

            -
            /**
- * @Route("/blog/{id}/comments/{comment_id}")
- * @ParamConverter("comment", class="SensioBlogBundle:Comment", options={"id" = "comment_id"})
- */
-public function showAction(Post $post, Comment $comment)
-{
-}
-
            -
            -

            En el ejemplo anterior, el argumento post es manejado automáticamente, pero el comentario está configurado con la anotación debido a que ambos no pueden seguir la convención predefinida.

            -

            Si quieres emparejar una entidad usando múltiples campos usa mapping:

            -
            /**
- * @Route("/blog/{date}/{slug}/comments/{comment_slug}")
- * @ParamConverter("post", options={"mapping": {"date": "date", "slug": "slug"}})
- * @ParamConverter("comment", options={"mapping": {"comment_slug": "slug"}})
- */
-public function showAction(Post $post, Comment $comment)
-{
-}
-
            -
            -

            Si estás emparejando una entidad que utiliza varios campos, pero quieres excluir un -argumento de la ruta para que forme parte de los criterios:

            -
            /**
- * @Route("/blog/{date}/{slug}")
- * @ParamConverter("post", options={"exclude": ["date"]})
- */
-public function showAction(Post $post, \DateTime $date)
-{
-}
-
            -
            -

            Si quieres especificar el método repository a utilizar para encontrar la entidad (por ejemplo, para añadir una unión a la consulta), puedes añadir la opción repository_method:

            -
            /**
- * @Route("/blog/{id}")
- * @ParamConverter("post", class="SensioBlogBundle:Post", options={"repository_method" = "findWithJoins"})
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -
            -
            -

            Convertidor DateTime

            -

            Nombre de convertidor: datetime

            -

            El convertidor datetime convierte cualquier ruta o atributo de petición a una instancia de datetime:

            -
            /**
- * @Route("/blog/archive/{start}/{end}")
- */
-public function archiveAction(\DateTime $start, \DateTime $end)
-{
-}
-
            -
            -

            Por omisión puede analizar cualquier formato de fecha aceptado por el constructor de DateTime. Puedes ser más estricto con la entrada dada a través de las opciones:

            -
            /**
- * @Route("/blog/archive/{start}/{end}")
- * @ParamConverter("start", options={"format": "Y-m-d"})
- * @ParamConverter("end", options={"format": "Y-m-d"})
- */
-public function archiveAction(\DateTime $start, \DateTime $end)
-{
-}
-
            -
            -
            -
            -
            -

            Creando un convertidor

            -

            Todos los convertidores deben implementar la Sensio\Bundle\FrameworkExtraBundle\Request\ParamConverter\ParamConverterInterface:

            -
            namespace Sensio\Bundle\FrameworkExtraBundle\Request\ParamConverter;
-
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\ConfigurationInterface;
-use Symfony\Component\HttpFoundation\Request;
-
-interface ParamConverterInterface
-{
-    function apply(Request $request, ConfigurationInterface $configuration);
-
-    function supports(ConfigurationInterface $configuration);
-}
-
            -
            -

            El método supports() debe devolver true cuando sea capaz de convertir la configuración dada (una instancia de ParamConverter).

            -

            La instancia de ParamConverter tiene tres piezas de información sobre la anotación:

            -
              -
            • name: El atributo name;
              • -
            • class: El atributo nombre de clase (puede ser cualquier cadena que represente el nombre de la clase);
              • -
            • options: Un arreglo de opciones
              • -
            -

            El método apply() se llama cuando una configuración es compatible. Basándonos en los atributos de la petición, debemos establecer un atributo llamado $configuration->getName(), que almacene un objeto de la clase $configuration->getClass().

            -

            Para registrar tu servicio convertidor tienes que añadir una etiqueta a tu servicio:

            -
            -
              -
            • XML
              <service id="my_converter" class="MyBundle/Request/ParamConverter/MyConverter">
-    <tag name="request.param_converter" priority="-2" converter="my_converter" />
-</service>
-
              -
              -
              • -
            -
            -

            Puedes registrar un convertidor por prioridad, por nombre (atributo «converter») o ambos. Si no especificas una prioridad o nombre el convertidor será añadido a la pila de convertidores con una prioridad de 0. Para desactiva explícitamente la inscripción por prioridad tienes que ajustar la priority="false" en la definición de tu etiqueta.

            -
            -

            Truco

            -

            Utiliza la clase DoctrineParamConverter como plantilla para tus propios convertidores.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioFrameworkExtraBundle/annotations/routing.html b/bundles/SensioFrameworkExtraBundle/annotations/routing.html deleted file mode 100644 index 238338b..0000000 --- a/bundles/SensioFrameworkExtraBundle/annotations/routing.html +++ /dev/null @@ -1,282 +0,0 @@ - - - - - - - @Route y @Method — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            @Route y @Method

            -
            -

            Usando

            -

            La anotación @Route asigna un patrón de ruta a un controlador:

            -
            use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-
-class PostController extends Controller
-{
-    /**
-     * @Route("/")
-     */
-    public function indexAction()
-    {
-        // ...
-    }
-}
-
            -
            -

            La acción index del controlador Post ya está asignada a la dirección /. Esto es equivalente a la siguiente configuración YAML:

            -
            blog_home:
-    pattern:  /
-    defaults: { _controller: SensioBlogBundle:Post:index }
-
            -
            -

            Al igual que cualquier patrón de ruta, puedes definir marcadores de posición, requisitos y valores predeterminados:

            -
            /**
- * @Route("/{id}", requirements={"id" = "\d+"}, defaults={"id" = 1})
- */
-public function showAction($id)
-{
-}
-
            -
            -

            También puedes definir el valor predefinido para un marcador de posición con el valor predeterminado de PHP:

            -
            /**
- * @Route("/{id}", requirements={"id" = "\d+"})
- */
-public function showAction($id = 1)
-{
-}
-
            -
            -

            También puedes combinar más de una URL definiendo una anotación @Route adicional:

            -
            /**
- * @Route("/", defaults={"id" = 1})
- * @Route("/{id}")
- */
-public function showAction($id)
-{
-}
-
            -
            -
            -
            -

            Activando

            -

            Las rutas se deben importar para estar activas como cualquier otro recurso de enrutado (observa el tipo annotation):

            -
            # app/config/routing.yml
-
-# importa las rutas desde una clase controlador
-post:
-    resource: "@SensioBlogBundle/Controller/PostController.php"
-    type:     annotation
-
            -
            -

            También puedes importar un directorio completo:

            -
            # importa rutas desde el directorio de controladores
-blog:
-    resource: "@SensioBlogBundle/Controller"
-    type:     annotation
-
            -
            -

            Como para cualquier otro recurso, puedes «montar» las rutas bajo un determinado prefijo:

            -
            post:
-    resource: "@SensioBlogBundle/Controller/PostController.php"
-    prefix:   /blog
-    type:     annotation
-
            -
            -
            -
            -

            Nombre de ruta

            -

            A una ruta definida con la anotación @Route se le asigna un nombre predeterminado, el cual está compuesto por el nombre del paquete, el nombre del controlador y el nombre de la acción. En el caso del ejemplo anterior sería -sensio_blog_post_index;

            -

            Puedes utilizar el atributo name para reemplazar este nombre de ruta predeterminado:

            -
            /**
- * @Route("/", name="blog_home")
- */
-public function indexAction()
-{
-    // ...
-}
-
            -
            -
            -
            -

            Prefijo de ruta

            -

            Una anotación @Route en una clase controlador define un prefijo para todas las rutas de acción:

            -
            /**
- * @Route("/blog")
- */
-class PostController extends Controller
-{
-    /**
-     * @Route("/{id}")
-     */
-    public function showAction($id)
-    {
-    }
-}
-
            -
            -

            La acción show ahora se asigna al patrón /blog/{id}.

            -
            -
            -

            Método de la ruta

            -

            Hay un atajo en la anotación @Method para especificar el método HTTP permitido para la ruta. Para usarlo, importa el espacio de nombres de la anotación Method:

            -
            use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Method;
-
-/**
- * @Route("/blog")
- */
-class PostController extends Controller
-{
-    /**
-     * @Route("/edit/{id}")
-     * @Method({"GET", "POST"})
-     */
-    public function editAction($id)
-    {
-    }
-}
-
            -
            -

            La acción editar ahora es asignada al patrón /blog/editar/{id} si el método HTTP utilizado es GET o POST.

            -

            La anotación @Method sólo se toma en cuenta cuando una acción se anota con @Route.

            -
            -
            -

            Controlador como servicio

            -

            También puedes utilizar la anotación @Route en una clase de controlador para asignar la clase controlador a un servicio para que el resolutor de controlador cree una instancia del controlador obteniendo el ID del contenedor en lugar de llamar a new PostController() en sí mismo:

            -
            /**
- * @Route(service="my_post_controller_service")
- */
-class PostController extends Controller
-{
-    // ...
-}
-
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioFrameworkExtraBundle/annotations/view.html b/bundles/SensioFrameworkExtraBundle/annotations/view.html deleted file mode 100644 index 746798b..0000000 --- a/bundles/SensioFrameworkExtraBundle/annotations/view.html +++ /dev/null @@ -1,210 +0,0 @@ - - - - - - - @Template — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            @Template

            -
            -

            Usando

            -

            La anotación @Template asocia un controlador con un nombre de plantilla:

            -
            use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-
-/**
- * @Template("SensioBlogBundle:Post:show.html.twig")
- */
-public function showAction($id)
-{
-    // consigue el Post
-    $post = ...;
-
-    return array('post' => $post);
-}
-
            -
            -

            Cuando utilizas la anotación @Template, el controlador debe regresar un arreglo de parámetros para pasarlo a la vista en lugar de un objeto Respuesta.

            -
            -

            Truco

            -

            Si la acción devuelve un objeto Respuesta, la anotación @Template simplemente se omite.

            -
            -

            Si la plantilla se nombra después del controlador y los nombres de acción, como en el caso del ejemplo anterior, puedes omitir incluso el valor de la anotación:

            -
            /**
- * @Template
- */
-public function showAction($id)
-{
-    // consigue el Post
-    $post = ...;
-
-    return array('post' => $post);
-}
-
            -
            -
            -

            Nota

            -

            Si estás utilizando PHP como tu sistema de plantillas, necesitas hacerlo explícito:

            -
            /**
- * @Template(engine="php")
- */
-public function showAction($id)
-{
-    // ...
-}
-
            -
            -
            -

            Y si los únicos parámetros para pasar a la plantilla son los argumentos del método, puedes utilizar el atributo vars en lugar de devolver un arreglo. Esto es muy útil en combinación con la anotación @ParamConverter:

            -
            /**
- * @ParamConverter("post", class="SensioBlogBundle:Post")
- * @Template("SensioBlogBundle:Post:show.html.twig", vars={"post"})
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -

            que, gracias a las convenciones, es equivalente a la siguiente configuración:

            -
            /**
- * @Template(vars={"post"})
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -

            Puedes hacer que sea aún más conciso puesto que todos los argumentos del método se pasan automáticamente a la plantilla si el método devuelve null y no se define el atributo vars:

            -
            /**
- * @Template
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioFrameworkExtraBundle/index.html b/bundles/SensioFrameworkExtraBundle/index.html deleted file mode 100644 index 406f8df..0000000 --- a/bundles/SensioFrameworkExtraBundle/index.html +++ /dev/null @@ -1,259 +0,0 @@ - - - - - - - SensioFrameworkExtraBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            SensioFrameworkExtraBundle

            -

            El FrameworkBundle predeterminado de Symfony2 implementa una plataforma MVC, básica pero robusta y flexible. SensioFrameworkExtraBundle la extiende añadiendo agradables convenciones y anotaciones. Esto permite controladores más concisos.

            -
            -

            Instalando

            -

            Descarga el paquete y ponlo bajo el espacio de nombres Sensio\Bundle\. -Luego, como con cualquier otro paquete, inclúyelo en la clase de tu núcleo:

            -
            public function registerBundles()
-{
-    $bundles = array(
-        ...
-
-        new Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle(),
-    );
-
-    ...
-}
-
            -
            -
            -
            -

            Configurando

            -

            Todas las características proporcionadas por el paquete están habilitadas por omisión, cuando registras el paquete en la clase de tu núcleo.

            -

            La configuración predeterminada es la siguiente:

            -
            -
              -
            • YAML
              sensio_framework_extra:
-    router:  { annotations: true }
-    request: { converters: true }
-    view:    { annotations: true }
-    cache:   { annotations: true }
-
              -
              -
              • -
            • XML
              <!-- xmlns:sensio-framework-extra="http://symfony.com/schema/dic/symfony_extra" -->
-<sensio-framework-extra:config>
-    <router annotations="true" />
-    <request converters="true" />
-    <view annotations="true" />
-    <cache annotations="true" />
-</sensio-framework-extra:config>
-
              -
              -
              • -
            • PHP
              // Carga el generador de perfiles
-$container->loadFromExtension('sensio_framework_extra', array(
-    'router'  => array('annotations' => true),
-    'request' => array('converters' => true),
-    'view'    => array('annotations' => true),
-    'cache'   => array('annotations' => true),
-));
-
              -
              -
              • -
            -
            -

            Puedes desactivar algunas anotaciones y convenciones definiendo uno o más valores en false.

            -
            -
            -

            Anotaciones para controladores

            -

            Las anotaciones son una buena manera de configurar controladores fácilmente, desde las rutas hasta la configuración de la caché.

            -

            Incluso si las anotaciones no son una característica natural de PHP, aún tienen varias ventajas sobre los métodos de configuración clásicos de Symfony2:

            -
              -
            • El código y la configuración están en el mismo lugar (la clase controlador)
              • -
            • Fáciles de aprender y usar;
              • -
            • Concisas para escribirlas;
              • -
            • Adelgazan tu controlador (puesto que su única responsabilidad es conseguir los datos del modelo).
              • -
            -
            -

            Truco

            -

            Si utilizas las clases view, las anotaciones son una buena manera de evitar la creación de clases view para casos simples y comunes.

            -
            -

            Las siguientes anotaciones están definidas por el paquete:

            -
            - -
            -

            Este ejemplo muestra en acción todas las anotaciones disponibles:

            -
            use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Cache;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\ParamConverter;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Method;
-
-/**
- * @Route("/blog")
- * @Cache(expires="tomorrow")
- */
-class AnnotController extends Controller
-{
-    /**
-     * @Route("/")
-     * @Template
-     */
-    public function indexAction()
-    {
-        $posts = ...;
-
-        return array('posts' => $posts);
-    }
-
-    /**
-     * @Route("/{id}")
-     * @Method("GET")
-     * @ParamConverter("post", class="SensioBlogBundle:Post")
-     * @Template("SensioBlogBundle:Annot:post.html.twig", vars={"post"})
-     * @Cache(smaxage="15")
-     */
-    public function showAction(Post $post)
-    {
-    }
-}
-
            -
            -

            En la medida en que el método showAction siga algunas convenciones, puedes omitir algunas anotaciones:

            -
            /**
- * @Route("/{id}")
- * @Cache(smaxage="15")
- */
-public function showAction(Post $post)
-{
-}
-
            -
            -

            Es necesario importar las rutas para activarlas como cualquier otro recurso de enrutado, ve Activando anotaciones de enrutado para detalles.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioGeneratorBundle/commands/generate_bundle.html b/bundles/SensioGeneratorBundle/commands/generate_bundle.html deleted file mode 100644 index 786f3a6..0000000 --- a/bundles/SensioGeneratorBundle/commands/generate_bundle.html +++ /dev/null @@ -1,184 +0,0 @@ - - - - - - - Generando la estructura para un nuevo paquete — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Generando la estructura para un nuevo paquete

            -
            -

            Usando

            -

            El generate:bundle genera una estructura para un nuevo paquete y automáticamente lo activa en la aplicación.

            -

            De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre del paquete, ubicación, formato y estructura de configuración predeterminada:

            -
            php app/console generate:bundle
-
            -
            -

            Para desactivar el modo interactivo, utiliza la opción --no-interaction pero no olvides suministrar todas las opciones necesarias:

            -
            php app/console generate:bundle --namespace=Acme/Bundle/BlogBundle --no-interaction
-
            -
            -
            -
            -

            Opciones disponibles

            -
              -

            • --namespace: El espacio de nombres a crear para el paquete. El espacio de nombres debe comenzar con un nombre de «proveedor», tal como el nombre de tu empresa, el nombre de tu proyecto, o el nombre de tu cliente, seguido por uno o más subespacios de nombres para una categoría opcional, el cual debe terminar con el nombre del paquete en sí mismo (debe tener Bundle como sufijo):

              -
              php app/console generate:bundle --namespace=Acme/Bundle/BlogBundle
-
              -
              -
              • -

            • --bundle-name: El nombre opcional del paquete. Esta debe ser una cadena que termine con el sufijo Bundle:

              -
              -
              php app/console generate:bundle --bundle-name=AcmeBlogBundle
-
              -
              -
              -
              • -

            • --dir: El directorio en el cual guardar el paquete. Por convención, la orden detecta y utiliza el directorio src/ de tu aplicación:

              -
              -
              php app/console generate:bundle --dir=/var/www/miproyecto/src
-
              -
              -
              -
              • -

            • --format: (annotation) [valores: yml, xml, php o annotation] -Determina el formato de enrutado a usar para los archivos de configuración generados. De manera predeterminada, la orden utiliza el formato annotation. Al elegir el formato annotation se espera que el paquete SensioFrameworkExtraBundle ya esté instalado:

              -
              -
              php app/console generate:bundle --format=annotation
-
              -
              -
              -
              • -

            • --structure: (no) [valores: yes``|``no] Cuando o no generar una estructura de directorios completa incluyendo directorios públicos vacíos para documentación, activos web y diccionarios de traducción:

              -
              -
              php app/console generate:bundle --structure=yes
-
              -
              -
              -
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioGeneratorBundle/commands/generate_controller.html b/bundles/SensioGeneratorBundle/commands/generate_controller.html deleted file mode 100644 index 49e78fd..0000000 --- a/bundles/SensioGeneratorBundle/commands/generate_controller.html +++ /dev/null @@ -1,163 +0,0 @@ - - - - - - - Generando un nuevo controlador — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Generando un nuevo controlador

            -
            -

            Usando

            -

            La orden generate:controller genera un nuevo controlador que incluye acciones, pruebas, plantillas y enrutado.

            -

            De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre del paquete, ubicación, formato y estructura de configuración predeterminada:

            -
            $ php app/console generate:controller
-
            -
            -

            La orden se puede ejecutar en modo no interactivo usando la opción --non-interaction sin olvidar todas las opciones necesarias:

            -
            $ php app/console generate:controller --no-interaction --controller=AcmeBlogBundle:Post
-
            -
            -
            -
            -

            Opciones disponibles

            -
              -

            • --controller: El nombre del controlador dado como notación abreviada conteniendo el nombre del proveedor en el cual está ubicado el controlador y el nombre del paquete. Por ejemplo: AcmeBlogBundle:Post (crea el PostController en el paquete AcmeBlogBundle):

              -
              -
              $ php app/console generate:controller --controller=AcmeBlogBundle:Post
-
              -
              -
              -
              • -

            • --actions: La lista de acciones a generar en la clase controladora. Esta tiene un formato como %nombreaccion%:%ruta%:%plantilla% (dónde :%plantilla% es opcional:

              -
              -
              $ php app/console generate:controller --actions="showPostAction:/article/{id} getListAction:/_list-posts/{max}:AcmeBlogBundle:Post:list_posts.html.twig"
-
-# o
-$ php app/console generate:controller --actions=showPostAction:/article/{id} --actions=getListAction:/_list-posts/{max}:AcmeBlogBundle:Post:list_posts.html.twig
-
              -
              -
              -
              • -

            • --route-format: (annotation) [valores: yml, xml, php o annotation] -Esta opción determina el formato que utilizará el enrutado. De manera predeterminada, la orden utiliza el formato annotation:

              -
              -
              $ php app/console generate:controller --route-format=annotation
-
              -
              -
              -
              • -

            • --template-format: (twig) [valores: twigo php] Esta opción determina el formato que utilizarán las plantillas. De manera predeterminada, la orden utiliza el formato twig:

              -
              -
              $ php app/console generate:controller --template-format=twig
-
              -
              -
              -
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioGeneratorBundle/commands/generate_doctrine_crud.html b/bundles/SensioGeneratorBundle/commands/generate_doctrine_crud.html deleted file mode 100644 index c3dab5f..0000000 --- a/bundles/SensioGeneratorBundle/commands/generate_doctrine_crud.html +++ /dev/null @@ -1,186 +0,0 @@ - - - - - - - Generando un controlador CRUD basado en una entidad de Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Generando un controlador CRUD basado en una entidad de Doctrine

            -
            -

            Usando

            -

            La orden generate:doctrine:crud genera un controlador básico para una determinada entidad ubicada en un determinado paquete. Este controlador te permite realizar cinco operaciones básicas en un modelo.

            -
              -
            • Listar todos los registros
              • -
            • Mostrar un determinado registro identificado por su clave primaria
              • -
            • Crear un nuevo registro.
              • -
            • Editar un registro existente.
              • -
            • Eliminar un registro existente.
              • -
            -

            De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre de la entidad, el prefijo de la ruta o cuando o no generar acciones de escritura:

            -
            php app/console generate:doctrine:crud
-
            -
            -

            Para desactivar el modo interactivo, utiliza la opción --no-interaction pero no olvides suministrar todas las opciones necesarias:

            -
            php app/console generate:doctrine:crud --entity=AcmeBlogBundle:Post --format=annotation --with-write --no-interaction
-
            -
            -
            -
            -

            Opciones disponibles

            -
              -

            • --entity: El nombre de la entidad dado en notación de atajo que contiene el nombre del paquete en el que se encuentra la entidad y el nombre de la entidad. Por ejemplo: AcmeBlogBundle:Post:

              -
              -
              php app/console generate:doctrine:crud --entity=AcmeBlogBundle:Post
-
              -
              -
              -
              • -

            • --route-prefix: El prefijo que se utilizará para cada ruta que identifica una acción:

              -
              -
              php app/console generate:doctrine:crud --route-prefix=acme_post
-
              -
              -
              -
              • -

            • --with-write: (no) [valores: yes | no] Cuando o no generar las acciones new, create, edit, update y delete:

              -
              -
              php app/console generate:doctrine:crud --with-write
-
              -
              -
              -
              • -

            • --format: (annotation) [valores: yml, xml, php o annotation] -Determina el formato de enrutado a usar para los archivos de configuración generados. De manera predeterminada, la orden utiliza el formato annotation. Al elegir el formato annotation se espera que el paquete SensioFrameworkExtraBundle ya esté instalado:

              -
              -
              php app/console generate:doctrine:crud --format=annotation
-
              -
              -
              -
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioGeneratorBundle/commands/generate_doctrine_entity.html b/bundles/SensioGeneratorBundle/commands/generate_doctrine_entity.html deleted file mode 100644 index f8356fa..0000000 --- a/bundles/SensioGeneratorBundle/commands/generate_doctrine_entity.html +++ /dev/null @@ -1,178 +0,0 @@ - - - - - - - Generando una nueva entidad para resguardo con Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Generando una nueva entidad para resguardo con Doctrine

            -
            -

            Usando

            -

            La orden generate:doctrine:entity genera una nueva entidad para resguardo con Doctrine, incluyendo la definición de asignaciones y propiedades de clase, captadores y definidores.

            -

            De manera predeterminada, la orden se ejecuta en modo interactivo y hace preguntas para determinar el nombre del paquete, ubicación, formato y estructura de configuración predeterminada:

            -
            php app/console generate:doctrine:entity
-
            -
            -

            La orden se puede ejecutar en modo no interactivo usando la opción --non-interaction sin olvidar todas las opciones necesarias:

            -
            php app/console generate:doctrine:entity --non-interaction --entity=AcmeBlogBundle:Post --fields="title:string(100) body:text" --format=xml
-
            -
            -
            -
            -

            Opciones disponibles

            -
              -

            • --entity: El nombre de la entidad dado en notación de atajo que contiene el nombre del paquete en el que se encuentra la entidad y el nombre de la entidad. Por ejemplo: AcmeBlogBundle:Post:

              -
              -
              php app/console generate:doctrine:entity --entity=AcmeBlogBundle:Post
-
              -
              -
              -
              • -

            • --fields: La lista de campos a generar en la clase entidad:

              -
              -
              php app/console generate:doctrine:entity --fields="titulo:string(100) cuerpo:text"
-
              -
              -
              -
              • -

            • --format: (annotation) [valores: yml, xml, php o annotation] Esta opción determina el formato a usar para los archivos de configuración generados como enrutado. De manera predeterminada, la orden utiliza el formato anotación:

              -
              -
              php app/console generate:doctrine:entity --format=annotation
-
              -
              -
              -
              • -

            • --with-repository: Esta opción indica si se debe o no generar la clase Doctrine relacionada con EntityRepository:

              -
              -
              php app/console generate:doctrine:entity --with-repository
-
              -
              -
              -
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioGeneratorBundle/commands/generate_doctrine_form.html b/bundles/SensioGeneratorBundle/commands/generate_doctrine_form.html deleted file mode 100644 index 9a707a4..0000000 --- a/bundles/SensioGeneratorBundle/commands/generate_doctrine_form.html +++ /dev/null @@ -1,152 +0,0 @@ - - - - - - - Generando una nueva clase de tipo Form basada en una entidad Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Generando una nueva clase de tipo Form basada en una entidad Doctrine

            -
            -

            Usando

            -

            La orden generate:doctrine:form genera una clase de tipo form básica usando los metadatos de asignación de una determinada clase entidad:

            -
            php app/console generate:doctrine:form AcmeBlogBundle:Post
-
            -
            -
            -
            -

            Argumentos obligatorios

            -
              -

            • entity: El nombre de la entidad dado en notación de atajo que contiene el nombre del paquete en el que se encuentra la entidad y el nombre de la entidad. Por ejemplo: AcmeBlogBundle:Post:

              -
              -
              php app/console generate:doctrine:form AcmeBlogBundle:Post
-
              -
              -
              -
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - - - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/SensioGeneratorBundle/index.html b/bundles/SensioGeneratorBundle/index.html deleted file mode 100644 index d03bed8..0000000 --- a/bundles/SensioGeneratorBundle/index.html +++ /dev/null @@ -1,161 +0,0 @@ - - - - - - - SensioGeneratorBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            SensioGeneratorBundle

            -

            El paquete SensioGeneratorBundle extiende la interfaz predeterminada de la línea de ordenes de Symfony2, ofreciendo nuevas ordenes interactivas e intuitivas para generar esqueletos de código como paquetes, clases de formulario o controladores CRUD basados en un esquema de Doctrine.

            -
            -

            Instalando

            -

            Descarga el paquete y ponlo bajo el espacio de nombres Sensio\Bundle\. -Luego, como con cualquier otro paquete, inclúyelo en tu clase núcleo:

            -
            public function registerBundles()
-{
-    $bundles = array(
-        ...
-
-        new Sensio\Bundle\GeneratorBundle\SensioGeneratorBundle(),
-    );
-
-    ...
-}
-
            -
            -
            -
            -

            Lista de ordenes disponibles

            -

            El paquete SensioGeneratorBundle viene con cuatro nuevas ordenes que puedes ejecutar en modo interactivo o no. El modo interactivo te hace algunas preguntas para configurar los parámetros para que la orden genere el código definitivo. La lista de nuevas ordenes se enumera a continuación:

            -
            - -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 11, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/bundles/index.html b/bundles/index.html deleted file mode 100644 index cc711c4..0000000 --- a/bundles/index.html +++ /dev/null @@ -1,141 +0,0 @@ - - - - - - - Paquetes de la edición estándar de Symfony — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - - - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/block.html b/cmf/bundles/block.html deleted file mode 100644 index 9fe82a3..0000000 --- a/cmf/bundles/block.html +++ /dev/null @@ -1,317 +0,0 @@ - - - - - - - BlockBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            BlockBundle

            -

            El BlockBundle proporciona integración con SonataBlockBundle. -Este te asiste gestionando fragmentos de contenido, conocidos como bloques. Lo que hace BlockBundle es similar a lo que hace Twig, pero para bloques almacenados en una BD. De esta manera, un editor puede modificar los bloques. -Además, el BlockBundle proporciona la lógica para determinar qué bloque se tendría que dibujar en cuáles páginas.

            -

            El BlockBundle por sí mismo no proporciona una funcionalidad de edición para bloques. No obstante, puedes encontrar ejemplos de cómo hacer editables los bloques en el recinto de seguridad del CMF de Symfony.

            -
            -

            Dependencias

            -

            Este paquete está basado en el SonataBlockBundle

            -
            -
            -

            Configurando

            -

            La clave de configuración para este paquete es symfony_cmf_block

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_block:
-    document_manager_name:  default
-
              -
              -
              • -
            -
            -
            -
            -

            Bloque documento

            -

            Antes de que puedas dibujar un bloque, necesitas crear un objeto que represente los datos de tu bloque en el repositorio. -Lo puedes conseguir con el siguiente fragmento de código (ten en cuenta que $parentPage necesita ser una instancia de una página definida por el ContentBundle):

            -
            $myBlock = new SimpleBlock();
-$myBlock->setParentDocument($parentPage);
-$myBlock->setName('sidebarBlock');
-$myBlock->setTitle('My first block');
-$myBlock->setContent('Hello block world!');
-
-$documentManager->persist($myBlock);
-
            -
            -

            Ten en cuenta que sidebarBlock es el identificador que escogimos para el bloque. Junto con el documento padre del bloque, esto hace único al bloque. Las otras propiedades son específicas de Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock.

            -
            -

            Nota

            -

            El sencillo bloque ahora está listo para dibujarlo, ve Dibujando el bloque.

            -
            -
            -

            Nota

            -

            Siempre asegúrate de implementar la interfaz Sonata\BlockBundle\Model\BlockInterface o un bloque de documento existente tal como Symfony\Cmf\Bundle\BlockBundle\Document\BaseBlock.

            -
            -
            -
            -

            Bloque de servicio

            -

            Si miras dentro de la clase SimpleBlock, notarás el método getType. Este define el nombre del servicio de bloque que procesa el bloque al dibujarlo.

            -

            Un bloque de servicio contiene:

            -
              -
            • Un método execute
              • -
            • configuración predefinida
              • -
            • configuración de formulario
              • -
            • configuración de caché
              • -
            • activos js y css por cargar
              • -
            • un método load
              • -
            -

            Échale un vistazo a los bloques de servicio en Symfony\Cmf\Bundle\BlockBundle\Block para ver algunos ejemplos.

            -
            -

            Nota

            -

            Asegúrate de implementar siempre la interfaz Sonata\BlockBundle\Block\BlockServiceInterface o un bloque de servicio existente tal como el Sonata\BlockBundle\Block\BaseBlockService.

            -
            -
            -

            El método execute

            -

            Este contiene el controlador lógico. Combina las opciones predefinidas en este método si lo quieres utilizar:

            -
            // ...
-if ($block->getEnabled()) {
-    // combina las opciones
-    $settings = array_merge($this->getDefaultSettings(), $block->getSettings());
-
-    $feed = false;
-    if ($settings['url']) {
-        $feed = $this->feedReader->import($block);
-    }
-
-    return $this->renderResponse($this->getTemplate(), array(
-        'feed' => $feed,
-        'block' => $block,
-        'settings' => $settings
-    ), $response);
-}
-// ...
-
            -
            -
            -

            Nota

            -

            Si tienes que usar mucha lógica, la puedes mover a un servicio específico e inyectarlo en el bloque de servicio. Luego usar ese servicio específico en el método execute.

            -
            -
            -
            -

            configuración predefinida

            -

            El método getDefaultSettings contiene las opciones predefinidas de un bloque. Las opciones después se pueden alterar en múltiples sitios, reflejándose en una cascada como esta:

            -
              -

            • las opciones predefinidas se almacenan en el bloque de servicio

              -
              • -

            • las opciones se pueden alterar a través de los ayudantes de plantilla:

              -
              {{ sonata_block_render({
-  'type': 'acme_main.block.rss',
-  'settings': {
-      'title': 'Symfony2 CMF news',
-      'url': 'http://cmf.symfony.com/news.rss'
-  }
-}) }}
-
              -
              -
              • -

            • y las opciones también se pueden alterar en un bloque de documento, la ventaja es que las opciones están almacenadas en PHPCR y te permiten implementar una interfaz de usuario final o de administración para cambiar algunas o todas las opciones.

              -
              • -
            -
            -
            -

            configuración de formulario

            -

            Los métodos buildEditForm y buildCreateForm contienen configuración de formulario para editar utilizando una interfaz de usuario final o de administración. El método validateBlock contiene la configuración de validación.

            -
            -
            -

            configuración de caché

            -

            El método getCacheKeys contiene las claves utilizadas para el bloque de la memoria caché.

            -
            -
            -

            js y css

            -

            Puedes usar los métodos getJavascripts y getStylesheets para definir activos js y css. Usa los ayudantes de Twig sonata_block_include_javascripts y sonata_block_include_stylesheets para reproducirlos.

            -
            {{ sonata_block_include_javascripts() }}
-{{ sonata_block_include_stylesheets() }}
-
            -
            -
            -

            Nota

            -

            Esto reproducirá los bloques js y css* de todos los bloques cargados en el contenedor de servicios de tu aplicación.

            -
            -
            -
            -

            El método load

            -

            Puedes usar el método load para cargar datos adicionales. Este se invoca cada vez que se reproduce un bloque y antes de llamar al método execute.

            -
            -
            -
            -

            Dibujando el bloque

            -

            Para realmente reproducir el bloque del ejemplo de la sección del bloque documento, solo añade el siguiente código a tu plantilla Twig:

            -
            {{ sonata_block_render({'name': 'sidebarBlock'}) }}
-
            -
            -

            Esto hará que se dibuje el BlockBundle según el bloque en cada página que tenga un bloque llamado 'sidebarBlock'. -Naturalmente, es necesario que la página real sea reproducida por la plantilla que contiene el fragmento anterior.

            -

            Esto pasa al reproducir un bloque, ve las siguientes secciones para más detalles:

            -
              -
            • se carga un documento basándose en el nombre
              • -
            • si está configurada la memorización en caché, se revisa la caché y si el contenido se encuentra se devuelve
              • -
            • Cada bloque documento también tiene un servicio block, se invoca al método execute:
                -
              • aquí puedes poner lógica como en un controlador
                • -
              • esta llama a una plantilla
                • -
              • el resultado es un objeto Respuesta
                • -
              -
              • -
            -

            También Puedes incorporar bloques en contenido utilizando el filtro cmf_embed_blocks.

            -
            -
            -

            Tipos de bloque

            -

            El BlockBundle viene con cuatro bloques de propósito general:

            -
              -
            • SimpleBlock: Un bloque sencillo con nada más que un título y un campo de hipertexto. Este normalmente sería el que un editor modificaría directamente, por ejemplo, la información de contacto
              • -
            • ContainerBlock: Un bloque que contiene de 0 a n bloques descendientes
              • -
            • ReferenceBlock: Un bloque que hace referencia a un bloque almacenado en algún otro lugar en el árbol de contenido. Por ejemplo, podrías desear referir partes de la información de contacto desde la página inicial
              • -
            • ActionBlock: Un bloque que invoca acciones de Symfony2. «¿Por qué utilizar esto en vez de llamar a la acción directamente desde mi plantilla?», te podrías preguntar. Bien, imagina el siguiente caso: Provees un bloque que dibuja reflexiones de tus últimas noticias. Sin embargo, no hay ninguna regla de en dónde debería aparecer. En su lugar, tu cliente quiere decidir en qué páginas se mostraría este bloque. Proporcionando un ActionBlock acorde, permites a tu cliente hacerlo sin llamarte (¡una y otra vez!) para cambiar algunas plantillas.
              • -
            -

            Además el BlockBundle tiene bloques más específicos:

            -
              -
            • RssBlock: Este bloque extiende el ActionBlock: El bloque documento guarda la url del alimentador y la acción del controlador recupera elmentos del alimentador. La implementación predefinida utiliza el EkoFeedBundle para leer elementos del alimentador.
              • -
            -
            -
            -

            Ejemplos

            -

            Puedes encontrar ejemplos de uso de este paquete en el Recinto de seguridad del CMF de Symfony. -Dale un vistazo en el BlockBundle del recinto de seguridad. También te muestra cómo hacer editables los bloques usando el CreateBundle.

            -
            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/block/cache.html b/cmf/bundles/block/cache.html deleted file mode 100644 index d05ab3f..0000000 --- a/cmf/bundles/block/cache.html +++ /dev/null @@ -1,330 +0,0 @@ - - - - - - - 3. Almacenando en caché — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            3. Almacenando en caché

            -

            El paquete BlockBundle integra con el SonataCacheBundle para proporcionar varias soluciones de almacenamiento en caché. Dale un vistazo a los adaptadores disponibles en el SonataCacheBundle para ver todas las opciones.

            -

            El BlockBundle además proporciona sus propios adaptadores para:

            -
              -
            • ESI
              • -
            • SSI
              • -
            • Javascript asíncrono
              • -
            • Javascript sincrónico
              • -
            -
            -

            Nota

            -

            Es aconsejable almacenar todas las opciones en el bloque documento al utilizar la memoria caché.

            -
            -
            -

            3.1. Dependencias

            -

            La funcionalidad de memorización en caché es opcional y depende del SonataCacheBundle.

            -
            -
            -

            3.2. Instalando

            -

            La instalación está dividida entre el SonataCacheBundle, el SymfonyCmfBlockBundle y el SonataBlockBundle:

            -
              -
            1. SonataCacheBundle - Sigue las instrucciones de instalación de la documentación del SonataCacheBundle.
              2. -
            2. SymfonyCmfBlockBundle - Al final de tu archivo de enrutado, añade las siguientes líneas:
              3. -
            -
            -
            -
              -
            • YAML
              # app/config/routing.yml
-# ...
-# rutas a los adaptadores de caché SymfonyCmfBlockBundle
-block_cache:
-    resource: "@SymfonyCmfBlockBundle/Resources/config/routing/cache.xml"
-    prefix: /
-
              -
              -
              • -
            -
            -
            -
              -
            1. SonataBlockBundle - Utiliza la clave sonata_block para configurar el adaptador de caché para cada bloque de servicio.
              2. -
            -
            -
            -
              -
            • YAML
              # app/config/config.yml
-sonata_block:
-# ...
-    blocks:
-        symfony_cmf.block.action:
-            # Usa el id del adaptador del servicio cache
-            cache: symfony_cmf.block.cache.js_async
-
              -
              -
              • -
            -
            -
            -
            -
            -

            3.3. Flujo de trabajo

            -

            Lo siguiente sucede al dibujar un bloque la memoria caché:

            -
              -
            • se carga un documento basándose en el nombre
              • -
            • si está configurada la memorización en caché, se revisa la caché y si se encuentra el contenido se devuelve
              • -
              • -
              • las claves de la caché se componen utilizando:
                  -
                • las claves de la caché del bloque de servicio
                  • -
                • las extraCacheKeys pasadas desde la plantilla
                  • -
                -
                • -
              • El adaptador de caché es pedido por un elemento caché
                  -
                • los adaptadores ESI y SSI añaden una etiqueta específica y una URL para recuperar el contenido de bloque
                  • -
                • el adaptador Javascript añade javascript y una URL para recuperar el contenido del bloque
                  • -
                -
                • -
              • Si el elemento caché no ha expirado y tiene datos se devuelve
                • -
              -
              • -
            • se dibuja la plantilla:
                -
              • Para ESI y SSI la URL es invocada para recuperar el contenido del bloque
                • -
              • para Javascript el navegador llama una URL y reemplaza un marcador de posición con el contenido devuelto del bloque
                • -
              -
              • -
            -
            -

            Nota

            -

            Los adaptadores de caché adicionales del BlockBundle siempre regresan la caché encontrada, tiene una apariencia similar a la del método has de los adaptadores en el SonataCacheBundle para ver cómo responden ellos.

            -
            -

            Si caché está marcado y el adaptador de caché indica que ninguna caché se encontró, el flujo de trabajo procede así:

            -
              -
            • each block document also has a block service, the execute method of it is called to render the block and return a response
              • -
            • if the response is cacheable the configured adapter creates a cache element, it contains
                -
              • the computed cache keys
                • -
              • the ttl of the response
                • -
              • the response
                • -
              • and additional contextual keys
                • -
              -
              • -
            • the template is rendered
              • -
            -
            -
            -

            3.4. Cache keys

            -

            The block service has the responsibility to generate the cache keys, the method getCacheKeys returns these keys, see -Bloque de servicio.

            -

            The block services shipped with the BlockBunde use the getCacheKeys method of the Sonata\BlockBundle\Block\BaseBlockService, -and return:

            -
              -
            • block_id
              • -
            • updated_at
              • -
            -
            -

            Nota

            -

            If block settings need to be persisted between requests it is advised to store them in the block document. Alternatively -they can be added to the cache keys. However be very cautious because, depending on the adapter, the cache keys can be -send to the browser and are not secure.

            -
            -
            -

            3.4.1. Extra cache keys

            -

            The extra cache keys array is used to store metadata along the cache element. The metadata can be used to invalidate a -set of cache elements.

            -
            -
            -

            3.4.2. Contextual keys

            -

            The contextual cache array hold the object class and id used inside the template. This contextual cache array is then -added to the extra cache key.

            -

            This feature can be use like this $cacheManager->remove(array('objectId' => 'id')).

            -

            Of course not all cache adapters support this feature, varnish and mongodb do.

            -

            The BlockBundle also has a cache invalidation listener that calls the flush method of a cache adapter automatically -when a cached block document is updated or removed.

            -
            -
            -
            -

            3.5. Dibujando el bloque

            -

            The following parameters can be used in the sonata_block_render code in your Twig template when using cache:

            -
              -
            • useCache: use the configured cache for a block (default: true)
              • -
            • extraCachekeys: expects an array with extra cache keys (default: empty array)
              • -
            -
            {{ sonata_block_render(
-    { 'name': 'rssBlock' },
-    true,
-    { 'extra_key': 'my_block' }
-) }}
-
            -
            -
            -
            -

            3.6. Adaptadores

            -
            -

            3.6.1. ESI

            -

            This extends the default EsiCache adapter of the SonataCacheBundle.

            -
            -

            3.6.1.1. Configurando

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_block:
-    # ...
-    caches:
-        esi:
-            token: a unique security key # a random one is generated by default
-            servers:
-                - varnishadm -T 127.0.0.1:2000 {{ COMMAND }} "{{ EXPRESSION }}"
-
              -
              -
              • -
            -
            -
            -
            -
            -

            3.6.2. SSI

            -

            This extends the default SsiCache adapter of the SonataCacheBundle.

            -
            -

            3.6.2.1. Configurando

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_block:
-    # ...
-    caches:
-        ssi:
-           token: una clave de seguridad única # de manera predeterminada se genera una aleatoria
-
              -
              -
              • -
            -
            -
            -
            -
            -

            3.6.3. JavaScript

            -

            Renders the block using javascript, the page is loaded and not waiting for the block to be finished rendering or -retrieving data. The block is then asynchronously or synchronously loaded and added to the page.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/block/create_your_own_blocks.html b/cmf/bundles/block/create_your_own_blocks.html deleted file mode 100644 index 7301d1e..0000000 --- a/cmf/bundles/block/create_your_own_blocks.html +++ /dev/null @@ -1,223 +0,0 @@ - - - - - - - 2. Creando tus propios bloques — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            2. Creando tus propios bloques

            -

            Sigue estos pasos para crear un bloque:

            -
              -
            • Crea un bloque documento
              • -
            • Crea un bloque servicio y decláralo (opcional)
              • -
            • create a data object representing your block in the repository, see Bloque documento
              • -
            • render the block, see Dibujando el bloque
              • -
            -

            Digamos que estás trabajando en un proyecto donde tienes que integrar los datos recibidos de varios alimentadores RSS. -Por supuesto podrías crear un ActionBlock para cada uno de estos alimentadores, ¿pero no es tonto eso? De hecho todas estas acciones se verían similares: Recibes los datos desde un alimentador, los saneas y los pasas a una plantilla. En su lugar decides crear tu propio bloque, el RSSBlock.

            -
            -

            2.1. Creando un bloque documento

            -

            La primer cosa que necesitas es un documento que contenga el dato. Es recomendable extender el Symfony\Cmf\Bundle\BlockBundle\Document\BaseBlock -contenido en este paquete (aun así no estás forzado a hacerlo, siempre y cuando implementes la Sonata\BlockBundle\Model\BlockInterface). En tu documento, necesitas definir el método getType que únicamente regresa ‘acme_main.block.rss’.

            -
            namespace Acme\MainBundle\Document;
-
-use Doctrine\ODM\PHPCR\Mapping\Annotations as PHPCRODM;
-use Symfony\Cmf\Bundle\BlockBundle\Document\BaseBlock;
-
-/**
- * Rss Block
- *
- * @PHPCRODM\Document(referenceable=true)
- */
-class RssBlock extends BaseBlock
-{
-    public function getType()
-    {
-        return 'acme_main.block.rss';
-    }
-}
-
            -
            -
            -
            -

            2.2. Creando un servicio bloque

            -

            Podrías elegir utilizar un servicio de bloque existente porque su configuración y lógica ya satisfacen tus necesidades. Para nuestro bloque rss creamos un servicio que sabe cómo manejar los RSSBlocks:

            -
              -

            • El método getDefaultSettings configura un título, una URL y la cantidad máxima de elementos

              -
              // ...
-public function getDefaultSettings()
-{
-    return array(
-        'url'      => false,
-        'title'    => 'Insert the rss title',
-        'maxItems' => 10,
-    );
-}
-// ..
-
              -
              -
              • -

            • the execute method passes the settings to an rss reader service and forwards the feed items to a template, see El método execute

              -
              • -
            -

            Asegúrate de implementar la Sonata\BlockBundle\Block\BlockServiceInterface o un servicio bloque existente tal cómo Sonata\BlockBundle\Block\BaseBlockService.

            -

            Define el servicio en un archivo de configuración. Es importante etiquetar tu BlockService con 'sonata.block', de lo contrario el paquete no lo reconocerá.

            -
            -
              -
            • YAML
              # services.yml
-acme_main.rss_reader:
-    class: Acme\MainBundle\Feed\SimpleReader
-
-sandbox_main.block.rss:
-    class: Acme\MainBundle\Block\RssBlockService
-    arguments:
-        - "acme_main.block.rss"
-        - "@templating"
-        - "@sonata.block.renderer"
-        - "@acme_main.rss_reader"
-    tags:
-        - {name: "sonata.block"}
-
              -
              -
              • -
            • XML
              <!-- services.xml -->
-<service id="acme_main.rss_reader" class="Acme\MainBundle\Feed\SimpleReader" />
-
-<service id="sandbox_main.block.rss" class="Acme\MainBundle\Block\RssBlockService">
-    <tag name="sonata.block" />
-    <argument>acme_main.block.rss</argument>
-    <argument type="service" id="templating" />
-    <argument type="service" id="sonata.block.renderer" />
-    <argument type="service" id="acme_main.block.rss_reader" />
-</service>
-
              -
              -
              • -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/block/relation_to_sonata_block_bundle.html b/cmf/bundles/block/relation_to_sonata_block_bundle.html deleted file mode 100644 index 74ce50c..0000000 --- a/cmf/bundles/block/relation_to_sonata_block_bundle.html +++ /dev/null @@ -1,137 +0,0 @@ - - - - - - - 4. Relación al paquete Block de Sonata — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            4. Relación al paquete Block de Sonata

            -

            El BlockBundle está basado en el SonataBlockBundle. -Este reemplaza componentes del paquete dónde es necesario que sea compatible con PHPCR.

            -

            La siguiente imagen muestra dónde utilizamos nuestros propios componentes (azules):

            -../../../_images/classdiagram.jpg -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/block/types.html b/cmf/bundles/block/types.html deleted file mode 100644 index 3bd4cc4..0000000 --- a/cmf/bundles/block/types.html +++ /dev/null @@ -1,167 +0,0 @@ - - - - - - - 1. Tipos de bloque — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            1. Tipos de bloque

            -

            For each purpose a different block type can be used. The general purpose blocks can be used for several solutions. -The Block Bundle ships with more specific block types.

            -
            -

            1.1. RSSBlock

            -

            The RssBlock extends the ActionBlock and allows you to read feed items and display them in a list.

            -

            Create a document:

            -
            $myRssBlock = new RssBlock();
-$myRssBlock->setParentDocument($parentPage);
-$myRssBlock->setName('rssBlock');
-$myRssBlock->setSetting('title', 'Symfony2 CMF news');
-$myRssBlock->setSetting('url', 'http://cmf.symfony.com/news.rss');
-$myRssBlock->setSetting('maxItems', 3);
-
-$documentManager->persist($myRssBlock);
-
            -
            -

            Todas las opciones disponibles son:

            -
              -
            • url: the url of the rss feed (required)
              • -
            • title: the title for the list (default: Insert the rss title)
              • -
            • maxItems: the maximum amount of items to return to the template (default: 10)
              • -
            • template: the template to render the feed items (default: SymfonyCmfBlockBundle:Block:block_rss.html.twig)
              • -
            • ItemClass: La clase utilizada para el objetO elemento pasado a la plantilla (predefinido: SymfonyCmfBundleBlockBundleModelFeedItem)
              • -
            -

            The controller to get the feed items can also be changed:

            -
              -
            • define a different class for the controller service in your configuration using the DI service parameter symfony_cmf_block.rss_controller_class
              • -
            • or set the actionName of your RssBlock document
              • -
            -
            -

            Nota

            -

            El Symfony CMF Sandbox contiene un ejemplo del RssBlock.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/blog.html b/cmf/bundles/blog.html deleted file mode 100644 index 63d99e5..0000000 --- a/cmf/bundles/blog.html +++ /dev/null @@ -1,257 +0,0 @@ - - - - - - - BlogBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            BlogBundle

            -

            El objetivo de este paquete es proporcionar todo lo que necesitas para crear un blog completo o sistema estilo blog. También incluye soporte integrado para el paquete Sonata Admin para ayudarte a levantar y correr rápidamente.

            -

            Características actuales:

            -
              -
            • Host multiple blogs within a single website.
              • -
            • Place blogs anywhere within your route hierarchy.
              • -
            • Sonata Admin integration.
              • -
            -

            Pending features:

            -
              -
            • Full tag support
              • -
            • Frontend pagination (using knp-paginator)
              • -
            • RSS/ATOM feed
              • -
            • Comments
              • -
            • User support (FOSUserBundle)
              • -
            -
            -

            Dependencias

            - -
            -
            -

            Configurando

            -

            The default configuration will work with the cmf-sandbox but you will probably -need to cusomize it to fit your own requirements.

            -

            Parameters:

            -
              -

            • routing_post_controller - specifies which controller to use for showing posts.

              -
              • -
            • -
              routing_post_prefix - this is the part of the URL which “prefixes” the post slug
              -

              e.g. with the default value the following post URL might be generated: http://example.com/my-blog/posts/this-is-my-post

              -
              -
              -
              • -

            • blog_basepath - required Specify the path where the blog content should be placed.

              -
              • -

            • routing_basepath - required Specify the basepath for the routing system.

              -
              • -
            -

            Ejemplo:

            -
            symfony_cmf_blog:
-    routing_post_controller: symfony_cmf_blog.blog_controller:viewPost
-    routing_post_prefix: posts
-    blog_basepath: /cms/content
-    routing_basepath: /cms/routes
-
            -
            -
            -

            Nota

            -

            In the BlogBundle the controller is a service, and is referenced as such. You can -of course specify a controller using the standard MyBundle:Controller:action -syntax. See controllers as services in the official sf2 docs.

            -
            -
            -

            Enrutando

            -

            To enable the routing system to automatically forward requests to the blog -controller when a Blog content is associated with a route, add the following -under the controllers_by_class section of symfony_cmf_routing_extra -in app/config/config.yml:

            -
            symfony_cmf_routing_extra:
-    ...
-    dynamic:
-        ...
-        controllers_by_class:
-            ...
-            Symfony\Cmf\Bundle\BlogBundle\Document\Blog: symfony_cmf_blog.blog_controller:listAction
-
            -
            -
            -
            -

            Sonata Admin

            -

            The BlogBundle has admin services defined for Sonata Admin, to make the blog -system visible on your dashboard, add the following to the -sonata_admin section:

            -
            sonata_admin:
-    ...
-    dashboard:
-        groups:
-            ...
-            blog:
-                label: blog
-                items:
-                    - symfony_cmf_blog.admin
-                    - symfony_cmf_post.admin
-
            -
            -
            -
            -

            Tree Browser Bundle

            -

            If you use the Symfony CMF Tree Browser bundle you can expose the blog routes -to enable blog edition from the tree browser. Expose the routes in the -fos_js_routing section of app/config/config.yml:

            -
            fos_js_routing:
-    routes_to_expose:
-        ...
-        - admin_bundle_blog_blog_create
-        - admin_bundle_blog_blog_delete
-        - admin_bundle_blog_blog_edit
-
            -
            -
            -
            -
            -

            Integration

            -
            -

            Templating

            -

            The default templates are marked up for Twitter Bootstrap. -But it is easy to completely customize the templates by overriding them.

            -

            The one template you will have to override is the default layout, you will need -to change it and make it extend your applications layout. The easiest way to do -this is to create the following file:

            -
            {# /app/Resources/SymfonyCmfBlogBundle/views/default_layout.html.twig #}
-
-{% extends "MyApplicationBundle::my_layout.html.twig" %}
-
-{% block content %}
-{% endblock %}
-
            -
            -

            The blog will now use MyApplicationBundle::my_layout.html.twig instead of -SymfonyCmfBlogBundle::default_layout.html.twig.

            -

            See Overriding Bundle Templates in the Symfony documentation for more information.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/content.html b/cmf/bundles/content.html deleted file mode 100644 index 877d1d5..0000000 --- a/cmf/bundles/content.html +++ /dev/null @@ -1,157 +0,0 @@ - - - - - - - ContentBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            ContentBundle

            -

            Este paquete proporciona un documento para contenido estático y el controlador para dibujarlo.

            -

            Para una introducción ve la sección «Cómo empezar» de la página Contenido.

            -
            -

            Configurando

            -

            La clave de configuración para este paquete es symfony_cmf_content

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_content:
-    admin_class:          ~
-    document_class:       ~
-    default_template:     ~
-    content_basepath:     /cms/content
-    static_basepath:      /cms/content/static
-    use_sonata_admin:     auto
-    multilang:                # la sección multilang completa es opcional
-        admin_class:          ~
-        document_class:       ~
-        use_sonata_admin:     auto
-        locales:              [] # si usas multilang, tienes que definir por lo menos una región
-
              -
              -
              • -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/core.html b/cmf/bundles/core.html deleted file mode 100644 index 1a461ad..0000000 --- a/cmf/bundles/core.html +++ /dev/null @@ -1,200 +0,0 @@ - - - - - - - CoreBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            CoreBundle

            -

            Este es el CoreBundle para el CMF de Symfony 2. Este paquete proporciona funcionalidad común, ayudantes y utilidades para los otros paquetes del CMF.

            -

            Una de las características proporcionadas es una interfaz e implementación de un supervisor del flujo de trabajo para la publicación con una interfaz acompañante en la cual los modelos pueden implementar aquello que quieran apoyar con este supervisor.

            -

            Además, proporciona un ayudante de Twig que expone varias funciones útiles para que las plantillas de Twig interaccinen con documentos PHPCR-ODM.

            -
            -

            Configurando

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_core:
-    document_manager: default
-    role: IS_AUTHENTICATED_ANONYMOUSLY # usado por el supervisor del
-                                         # flujo de trabajo
-                                         # para publicación
-
              -
              -
              • -
            -
            -
            -
            -

            Supervisor del flujo de trabajo para publicación

            -

            El paquete proporciona un servicio symfony_cmf_core.publish_workflow_checker que implementa la PublishWorkflowCheckerInterface. Esta interfaz define un solo método checkIsPublished().

            -
            $publishWorkflowChecker = $container->get('symfony_cmf_core.publish_workflow_checker');
-$ignoreRole = false // si ignora el rol al momento de decidir si considera
-                    // el documento como publicado
-if ($publishWorkflowChecker->checkIsPublished($document, $ignoreRole)) {
-    ..
-}
-
            -
            -
            -
            -

            Extensión Twig

            -

            Implementa las siguientes funciones:

            -
              -
            • cmf_find: Encuentra el documento por medio de la ruta y clase proporcionadas
              • -
            • cmf_is_published: Comprueba si el documento proporcionado está publicado
              • -
            • cmf_prev: Devuelve el anterior documento publicado examinando los nodos hijos del padre proporcionado
              • -
            • cmf_next: Devuelve el siguiente documento publicado examinando los nodos hijos del padre proporcionado
              • -
            • cmf_children: Devuelve un arreglo con todos los documentos hijo de los documentos proporcionados que están publicados
              • -
            • cmf_document_locales: Obtiene las regiones del documento proporcionado
              • -
            -
            {% set page = cmf_find('/alguna/ruta') %}
-
-{% if cmf_is_published(page) %}
-    {% set prev = cmf_prev(page) %}
-    {% if prev %}
-        <a href="{{ path(prev) }}">prev</a>
-    {% endif %}
-
-    {% set next = cmf_next(page) %}
-    {% if next %}
-        <span style="float: right; padding-right: 40px;"><a href="{{ path(next) }}">next</a></span>
-    {% endif %}
-
-    {% for news in cmf_children(page)|reverse %}
-        <li><a href="{{ path(news) }}">{{ news.title }}</a> ({{ news.publishStartDate | date('Y-m-d')  }})</li>
-    {% endfor %}
-
-    {% if 'de' in cmf_document_locales(page) %}
-        <a href="{{ path(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')|merge(app.request.query.all)|merge({'_locale': 'de'})) }}">DE</a>
-    {% endif %}
-    {% if 'fr' in cmf_document_locales(page) %}
-        <a href="{{ path(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')|merge(app.request.query.all)|merge({'_locale': 'fr'})) }}">DE</a>
-    {% endif %}
-{% endif %}
-
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/create.html b/cmf/bundles/create.html deleted file mode 100644 index 752363e..0000000 --- a/cmf/bundles/create.html +++ /dev/null @@ -1,393 +0,0 @@ - - - - - - - CreateBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            CreateBundle

            -

            El CreateBundle integra a Symfony 2 las bibliotecas ayudante create.js y createphp.

            -

            create.js es una comprensible interfaz de edición web para Sistemas de administración de contenido (CMS). Está diseñado para proporcionar un moderno gestor de contenido, totalmente basado en un entorno de navegadores HTML5. Creado para poder adaptarlo para trabajar en casi cualquier interfaz de administración de contenido. -Ve http://createjs.org/

            -

            Createphp es una biblioteca PHP para ayudarte con anotaciones RDF en tus entidades/documentos. -Ve la documentación sobre como trabaja en https://github.com/flack/createphp.

            -
            -

            Dependencias

            -

            Este paquete incluye create.js (el cuál empaca todas sus dependencias como jquery, vie, hallo, backbone, etc.) como submódulos git. No olvides añadir el guión del controlador de composer a tu archivo composer.json como se describe abajo.

            -

            Las dependencias de PHP son manejadas por medio de composer. Utilizamos createphp así como AsseticBundle, FOSRestBundle y por inferencia también JmsSerializerBundle. Asegúrate de crear una instancia de todos estos paquetes en tu nucleo y de configurar correctamente el assetic.

            -
            -
            -

            Instalando

            -

            Este paquete se incluye mejor utilizando Composer.

            -

            Edita el archivo composer de tu proyecto añadiendo un nuevo requisito para symfony-cmf/create-bundle. -Luego, crea una sección de guiones o añádelo a una existente:

            -
            {
-    "scripts": {
-        "post-install-cmd": [
-            "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules",
-            ...
-        ],
-        "post-update-cmd": [
-            "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules",
-            ...
-        ]
-    }
-}
-
            -
            -

            Añade este paquete (y sus dependencias, si aún no están) al núcleo de tu aplicación:

            -
            // application/ApplicationKernel.php
-public function registerBundles()
-{
-    return array(
-        // ...
-        new Symfony\Bundle\AsseticBundle\AsseticBundle(),
-        new JMS\SerializerBundle\JMSSerializerBundle($this),
-        new FOS\RestBundle\FOSRestBundle(),
-        new Symfony\Cmf\Bundle\CreateBundle\SymfonyCmfCreateBundle(),
-        // ...
-    );
-}
-
            -
            -

            También necesitas configurar el FOSRestBundle para manejar json:

            -
            fos_rest:
-    view:
-        formats:
-            json: true
-
            -
            -
            -
            -

            Concepto

            -

            Createphp usa metadatos RDF sobre las clases de tu dominio, tal como Doctrine -sabe cómo se almacenan los metadatos de un objeto en la base de datos. Los metadatos son modelados por el tipo de la clase y pueden provenir de cualquier fuente. Createphp proporciona controladores de metadatos que leen XML, arreglos PHP y uno que justo introspecciona objetos y crea metadatos no semánticos que serán suficientes para editar con create.js.

            -

            El RdfMapper se usa para traducir entre tu capa de almacenamiento y createphp. -Este es pasado al objeto dominio y al objeto metadatos pertinente.

            -

            Con los metadatos y el ayudante de Twig, el contenido es dibujado con anotaciones RDF. create.js es cargado y habilitado para editar las entidades. Guarda en la interfaz de administración las operaciones que ocurrieron en llamadas ajax.

            -

            El controlador REST maneja esas llamadas ajax, y si quieres ser capaz de cargar imágenes, un controlador de imagen guarda las imágenes cargadas y devuelve la ubicación -de la imagen.

            -
            -
            -

            Configurando

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_create:
-    # cargando metadatos
-
-    # Lista de directorios para buscar metadatos
-    rdf_config_dirs:
-        - "%kernel.root_dir%/Resources/rdf-mappings"
-    # busca asociaciones en <Paquete>/Resources/rdf-mappings
-    # auto_mapping: true
-
-    # usa una clase diferente para el controlador REST
-    # rest_controller_class: FQN\Classname
-
-    # manejo de imagen
-    imagen:
-        model_class: ~
-        controller_class: ~
-
-    # rol para controlar el acceso para inclusión js, predefinido
-    # REST y controladores de imagen
-    # role: IS_AUTHENTICATED_ANONYMOUSLY
-
-    # Habilita el asignador PHPCR-ODM de Doctrine
-    phpcr_odm: true
-
-    # asociación de tipo rdf name => class nombre usado al añadir ítems a colecciones
-    map:
-        rdfname: FQN\Classname
-
-    # url para mejora semántica stanbol, de lo contrario la
-    # predeterminada es la instalación del demo
-    # stanbol_url: http://dev.iks-project.eu:8081
-
-    # fija la barra de edición Hallo en lo alto de la página
-    # fixed_toolbar: true
-
-    # los tipos RDF para elementos a modificar en texto plano
-    # plain_text_types: ['dcterms:title']
-
-    # los tipos RDFa para crear las rutas correspondientes después de
-    # añadido el contenido de estos tipos con Create.js. Esto no
-    # es necesario con el SimpleCmsBundle, porque el contenido y las
-    # rutas están en el mismo árbol del repositorio.
-    # create_routes_types: ['http://schema.org/NewsArticle']
-
              -
              -
              • -
            -
            -

            El archivo javascript proporcionado configura create.js y el editor «hallo». Activa algunos complementos como el editor de etiquetas para revisar colecciones de -atributos skos:related. Esperamos poder añadir algunas opciones de configuración para modificar la configuración de create.js pero también puedes utilizar el archivo como una plantilla y hacer la propia si necesitas mayor personalización.

            -
            -

            Metadatos

            -

            createphp necesita información de metadatos para cada clase de tu modelo del dominio. Por omisión, crea paquete usa el controlador de metadatos XML y busca los metadatos en los paquetes habilitados en <Paquete>/Resources/rdf-mappings. Si utilizas un paquete que no tiene ninguna asignación RDF, puedes especificar una lista de rdf_config_dirs que se analizará adicionalmente para buscar metadatos.

            -

            Consulta la documentación de createphp para el formato de los metadatos XML.

            -
            -
            -

            Controlando el acceso

            -

            Si utilizas el controlador REST predefinido, todos pueden editar el contenido una vez activado el crea paquete. Para restringir el acceso, especifica un rol para el paquete que no sea el predefinido -IS_AUTHENTICATED_ANONYMOUSLY. -Si especificas un rol diferente, create.js sólo se cargará si el usuario tiene ese rol y el controlador REST (y el controlador de imagen si está habilitado) revisará el rol.

            -

            Si necesitas un control de acceso más fino, busca en el método asignador isEditable. -Puedes extender el asignador a utilizar y sustituir isEditable para que responda si el objeto dominio que se le pasa es editable.

            -
            -
            -

            Manejando imágenes

            -

            Activa el controlador de imágenes simplista con la configuración image > model_class | controller_class. Este controlador de imagen sólo despacha imágenes existentes en el repositorio PHPCR-ODM y también las sirve en peticiones.

            -

            Si necesitas un diferente tratamiento de imágenes, puedes sobrescribir image.model_class y/o image.controller_class, o implementar un servicio personalizado con ImageController y sustituir el symfony_cmf_create.image.controller.

            -
            -
            -

            Asignación de peticiones a objetos

            -

            Por ahora, el paquete sólo proporciona un servicio para asociar al PHPCR-ODM de Doctrine. Activado al establecer phpcr_odm en true. Si necesitas algo más, debes proporcionar un servicio symfony_cmf_create.object_mapper. (Si necesitas un contenedor para el ORM de Doctrine, mira los asignadores de la biblioteca createphp y haz una petición de extracción en la biblioteca, y otra para exponer el ORM como asignador del servicio en el crea paquete).

            -

            Además, ten en cuenta que createphp apoyaría diferentes asignadores para diferentes tipos de RDF. -Si necesitas esto, escarva un poco en createphp y crea paquete y haz una petición de extracción para activar esa característica.

            -

            Para poder crear nuevos objetos, es necesario proporcionar una asociación entre los tipos RDF y los nombres de clase. (Pendiente: ¿no podemos indexar todas las asignaciones y hacer esto automáticamente?)

            -
            -
            -

            Enrutando

            -

            Por último añade la ruta correspondiente a tu configuración:

            -
            -
              -
            • YAML
              create:
-    resource: "@SymfonyCmfCreateBundle/Resources/config/routing/rest.xml"
-create_image:
-    resource: "@SymfonyCmfCreateBundle/Resources/config/routing/image.xml"
-
              -
              -
              • -
            • XML
              <import resource="@SymfonyCmfCreateBundle/Resources/config/routing/rest.xml" type="rest" />
-<import resource="@SymfonyCmfCreateBundle/Resources/config/routing/image.xml" type="rest" />
-
              -
              -
              • -
            -
            -
            -
            -
            -

            Usando

            -

            Ajusta tu plantilla para cargar los archivos js del editor si la sesión actual tiene permitido editar el contenido.

            -

            If you are using Symfony 2.2 or higher:

            -
            {% render(controller("symfony_cmf_create.jsloader.controller:includeJSFilesAction"))  with {'_locale': app.request.locale} %}
-
            -
            -

            For versions prior to 2.2, this will do:

            -
            {% render "symfony_cmf_create.jsloader.controller:includeJSFilesAction" with {'_locale': app.request.locale} %}
-
            -
            -

            Además, asegúrate de que assetic está reescribiendo rutas en tus archivos css, y luego incluye los archivos css base (y personalízalos con tu propio css cuando sea necesario) con:

            -
            {% include "SymfonyCmfCreateBundle::includecssfiles.html.twig" %}
-
            -
            -

            La otra cosa que tienes que hacer es proporcionar asignación RDF para las clases de tu modelo y ajusta tus plantillas para reproducir con createphp a modo de que create.js sepa cual contenido es editable.

            -

            Crea la asignación de metadatos XML en <Paquete>/Resources/rdf-mappings/ o una ruta -a tu rdf_config_dirs configurado después del nombre completamente cualificado de tus clases del modelo sustituyendo \\ con un punto (.), es decir, Symfony.Cmf.Bundle.SimpleCmsBundle.Document.MultilangPage.xml. -Para un ejemplo de asociación ve los archivos en el cmf-sandbox. La documentación de referencia está en el repositorio de la biblioteca createphp.

            -

            Para dibujar tu modelo, usa la etiqueta createphp de Twig:

            -
            {% createphp page as="rdf" %}
-{{ rdf|raw }}
-{% endcreatephp %}
-
            -
            -

            O si necesitas más control sobre el HTML generado:

            -
            {% createphp page as="rdf" %}
-<div {{ createphp_attributes(rdf) }}>
-    <h1 class="my-title" {{ createphp_attributes( rdf.title ) }}>{{ createphp_content( rdf.title ) }}</h1>
-    <div {{ createphp_attributes( rdf.body ) }}>{{ createphp_content( rdf.body ) }}</div>
-</div>
-{% endcreatephp %}
-
            -
            -
            -

            Editores alternativos

            -

            You can write your own templates to load a javascript editor. They have to -follow the naming pattern SymfonyCmfCreateBundle::includejsfiles-%editor%.html.twig -to be loaded. In the includeJSFilesAction, you specify the editor parameter. -(Do not forget to add the controller call around the controller name inside -render for Symfony 2.2, as in the example above.)

            -
            -
            {% render “symfony_cmf_create.jsloader.controller:includeJSFilesAction” with {‘editor’: ‘aloha’, ‘_locale’: app.request.locale } %}
            -
            -

            Nota

            -

            Create.js has built in support for Aloha and ckeditor, as well as the -default hallo editor. Those should be supported by the CreateBundle as well. -See these github issue for ckeditor -and alhoa integration.

            -

            If you wrote the necessary code for one of those editors, or another editor -that could be useful for others, please send a pull request.

            -
            -
            -
            -
            -

            Desarrollando el editor wysiwyg hallo

            -

            Puedes desarrollar el editor hallo dentro del Crea paquete. De manera predefinida, se usa una versión minimizada del hallo empacada con Crea paquete. Para desarrollar el código real, primero necesitas activar con checkout el repositorio hallo completo. Lo puedes hacer ejecutando la siguiente orden desde la línea de ordenes:

            -
            app/console cmf:create:init-hallo-devel
-
            -
            -

            There is a special template to load the coffee script files. To load this, -just use the hallo-coffee editor with the includeJSFilesAction. -(Do not forget to add the controller call around the controller name inside -render for Symfony 2.2, as in the example above.)

            -
            {% render "symfony_cmf_create.jsloader.controller:includeJSFilesAction" with {'editor': 'hallo-coffee', '_locale': app.request.locale } %}
-
            -
            -

            The hallo-coffee template uses assetic to load the coffee script files from -Resources/public/vendor/hallo/src, rather than the precompiled javascript -from Resources/public/vendor/create/deps/hallo-min.js. This also means that -you need to add a mapping for coffeescript in your assetic configuration and -you need the coffee compiler set up correctly.

            -
            -
              -
            • YAML
              assetic:
-    filters:
-        cssrewrite: ~
-        coffee:
-            bin: %coffee.bin%
-            node: %coffee.node%
-            apply_to: %coffee.extension%
              -
              -
              • -
            -
            -

            In the cmf sandbox we did a little hack to not alwas trigger coffee script compiling. -En el archivo config.yml hacemos configurable la extensión de coffee. Ahora si parameters.yml pone coffee.extension a \.coffee el coffeescript es compilado y el compilador de coffee debe estar instalado. Si lo pusiste a cualquier otra cosa tal como \.nocoffee entonces no es necesario tener instalado el compilador de coffee.

            -

            Los valores predefinidos para los tres parámetros son:

            -
            -
              -
            • YAML
              coffee.bin: /usr/local/bin/coffee
-coffee.node: /usr/local/bin/node
-coffee.extension: \.coffee
-
              -
              -
              • -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/doctrine_phpcr_admin.html b/cmf/bundles/doctrine_phpcr_admin.html deleted file mode 100644 index 8ad58a1..0000000 --- a/cmf/bundles/doctrine_phpcr_admin.html +++ /dev/null @@ -1,170 +0,0 @@ - - - - - - - SonataDoctrinePhpcrAdminBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            SonataDoctrinePhpcrAdminBundle

            -

            El SonataDoctrinePhpcrAdminBundle proporciona integración con el SonataAdminBundle para habilitar fácilmente la creación de interfaces de usuario.

            -
            -

            Dependencias

            - -
            -
            -

            Configurando

            -
            -
              -
            • YAML
              sonata_doctrine_phpcr_admin:
-    templates:
-        form:
-
-            # Predefinido:
-            - SonataDoctrinePHPCRAdminBundle:Form:form_admin_fields.html.twig
-        filter:
-
-            # Predefinido:
-            - SonataDoctrinePHPCRAdminBundle:Form:filter_admin_fields.html.twig
-        types:
-            list:
-
-                # Prototipo
-            name:                 []                 []
-    document_tree:
-        # Prototipo
-        class: # name of the class
-            # class names of valid children, manage tree operations for them and hide other children
-            valid_children:       []
-            image:
-
              -
              -
              • -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/menu.html b/cmf/bundles/menu.html deleted file mode 100644 index 8887040..0000000 --- a/cmf/bundles/menu.html +++ /dev/null @@ -1,204 +0,0 @@ - - - - - - - MenuBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - - - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/phpcr-odm.html b/cmf/bundles/phpcr-odm.html deleted file mode 100644 index 5be4f19..0000000 --- a/cmf/bundles/phpcr-odm.html +++ /dev/null @@ -1,803 +0,0 @@ - - - - - - - DoctrinePHPCRBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            DoctrinePHPCRBundle

            -

            El DoctrinePHPCRBundle proporciona integración con el repositorio de contenido PHP y opcionalmente con el PHPCR-ODM de Doctrine -para proporcionar el gestor de documentos ODM en Symfony.

            -

            Fuera de la caja, este paquete apoya las siguientes implementaciones PHPCR:

            - -
            -

            Truco

            -

            Esta referencia sólo explica la integración de Symfony2 con PHPCR y PHPCR-ODM. Para aprender cómo utilizar PHPCR ve al sitio web de PHPCR y para la documentación del PHPCR-ODM de Doctrine .

            -
            -

            Este paquete está basado en el AbstractDoctrineBundle y por lo tanto es similar a la configuración de los paquetes ORM y MongoDB de Doctrine.

            - -
            -

            Configurando

            -
            -

            Truco

            -

            Si sólo quieres utilizar el PHPCR sencillo sin el PHPCR-ODM, sencillamente no configures la sección odm para evitar que cargue los servicios. Ten en cuenta que muchos paquetes predefinidos del CMF usan documentos PHPCR-ODM y por ello necesitas habilitar el ODM.

            -
            -
            -

            Configurando la sesión PHPCR

            -

            La sesión necesita que especifiques una implementación PHPCR en la sección backend para el campo type, junto con opciones de configuración al arranque de la implementación. Actualmente apoyamos jackrabbit, doctrinedbal y midgard2. -Independientemente de la interfaz de administración, cada sesión PHPCR necesita un espacio de trabajo, nombre de usuario y contraseña.

            -
            -

            Truco

            -

            Cada implementación de PHPCR debería proporcionar el espacio de trabajo llamado «default», pero puedes elegir uno diferente. Existe la orden doctrine:phpcr:workspace:create para iniciar un nuevo espacio de trabajo. See also Servicios.

            -
            -

            El nombre de usuario y contraseña que especifiques aquí son los utilizados en la capa PHPCR en -PHPCR\SimpleCredentials. Normalmente serán diferentes del nombre de usuario y contraseña utilizados por Midgard2 o el DBAL de Doctrine para conectar al RDBMS subyacente donde de hecho se almacenan los datos.

            -

            Si estás utilizando una de las interfaces de administración de Jackalope, también puedes especificar opciones. -Estas serán puestas en la sesión de Jackalope. Actualmente esto se puede ajustar a nodos prerecuperados poniendo jackalope.fetch_depth a algo más grande que 0.

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            # ve abajo cómo configurar la interfaz de administración que elejiste
-        workspace: default
-        username: admin
-        password: admin
-        ## ajusta opciones para jackrabbit y doctrinedbal (todas las versiones de jackalope)
-        # options:
-        #    'jackalope.fetch_depth': 1
-
              -
              -
              • -
            -
            -
            -

            Sesión PHPCR con Jackalope Jackrabbit

            -

            Es la única configuración requerida para instalar el Jackrabbit de apache (ve instalando Jackrabbit).

            -

            La configuración necesita que el parámetro url apunte a tu jackrabbit. Además puedes afinar algunas otras opciones específicas de jackrabbit, por ejemplo para utilizarlas en la configuración de una carga balanceada o para fallar temprano y aminorar el costo de algunos viajes de ida y vuelta a la interfaz de administración.

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: jackrabbit
-            url: http://localhost:8080/server/
-            ## únicamente jackrabbit, opcional. ve https://github.com/jackalope/jackalope/blob/master/src/Jackalope/RepositoryFactoryJackrabbit.php
-            # default_header: ...
-            # expect: 'Esperaba: 100-continue'
-            # habilita si de cualquier manera quieres tener una excepción si
-            # falla el incio de sesión PHPCR
-            # check_login_on_server: false
-            # habilita si experimentas fallos de segmentación mientras
-            # trabajas con datos binarios en documentos
-            # disable_stream_wrapper: true
-            # habilita si no quieres usar transacciones y tampoco quieres
-            # que el odm use transacciones automáticamente, es altamente
-            # recomendable NO deshabilitar las transacciones
-            # disable_transactions: true
-
              -
              -
              • -
            -
            -
            -
            -

            Sesión PHPCR con el Jackalope y DBAL de Doctrine

            -

            Este tipo usa Jackalope con una abstracción en la capa de transporte de base de datos de Doctrine para proporcionar PHPCR sin ningún requisito de instalación más allá de cualquiera de los RDBMS apoyados por Doctrine.

            -

            Necesitas configurar una conexión de Doctrine según el DBAL elejido en -la documentación de Doctrine en Symfony2.

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-            # habilita si quieres tener una excepción inmediatamente si falla
-            # el inicio de sesión PHPCR
-            # check_login_on_server: false
-            # habilita si experimentas fallos de segmentación mientras
-            # trabajas con datos binarios en documentos
-            # disable_stream_wrapper: true
-            # habilita si no quieres usar transacciones y tampoco quieres
-            # que el odm use transacciones automáticamente, es altamente
-            # recomendable NO deshabilitar las transacciones
-            # disable_transactions: true
-
              -
              -
              • -
            -
            -

            Una vez configurada la conexión, puedes crear la base de datos y debes iniciar la base de datos con la orden doctrine:phpcr:init:dbal.

            -
            app/console doctrine:database:create
-app/console doctrine:phpcr:init:dbal
-
            -
            -
            -

            Truco

            -

            Naturalmente, también puedes utilizar una diferente conexión en vez de la predefinida. -Es recomendable utilizar una conexión independiente para una base de datos separada si también Doctrine usa el acceso a datos del ORM o DBAL directamente, en lugar de mezclar este dato con las tablas generadas por jackalope-doctrine-dbal. -Si tienes una conexión separada, necesitas pasar el nombre de la conexión alterna a la orden doctrine:database:create con la opción --connection. Para las ordenes PHPCR de Doctrine, este parámetro no es necesario al configurar la conexión a utilizar.

            -
            -
            -
            -

            Sesión PHPCR con Midgard2

            -

            Midgard2 es una aplicación que proporciona una extensión PHP compilada. Esta implementa la API de PHPCR en lo alto de un RDBMS estándar.

            -

            To use the Midgard2 PHPCR provider, you must have both the midgard2 PHP extension -and the midgard/phpcr package installed. -The settings here correspond to Midgard2 repository parameters as explained in the getting started document.

            -

            La sesión de configuración de la interfaz de administración es la siguiente:

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: midgard2
-            db_type: MySQL
-            db_name: midgard2_test
-            db_host: "0.0.0.0"
-            db_port: 3306
-            db_username: ""
-            db_password: ""
-            db_init: true
-            blobdir: /tmp/cmf-blobs
-
              -
              -
              • -
            -
            -

            Para más información, por favor, ve la documentación oficial del PHPCR de Midgard.

            -
            -
            -
            -

            Configurando el PHPCR-ODM de Doctrine

            -

            Esta sección de configuración gestiona el sistema PHPCR-ODM de Doctrine. Si no configuras ninguna cosa aquí, los servicios ODM no serán cargados.

            -

            Si habilitas auto_mapping, puedes colocar tus asociaciones en <Paquete>/Resources/config/doctrine/<Document>.phpcr.xml resp. ...yml para -configurar asociaciones a documentos proporcionadas en el directorio <Paquete>/Document. De lo contrario necesitas configurar manualmente la sección de asignaciones.

            -

            Si auto_generate_proxy_classes es false, necesitas ejecutar la orden cache:warmup -para tener las clases delegadas generadas después de que modificaste un documento. También puedes ajustar cómo y dónde generar las clases delegadas con las opciones proxy_dir y proxy_namespace. Normalmente las predefinidas están bien aquí.

            -

            También puedes habilitar el almacenamiento de metadatos en caché.

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    odm:
-        configuration_id:     ~
-        auto_mapping: true
-        mappings:
-            <name>:
-                mapping:              true
-                type:                 ~
-                dir:                  ~
-                alias:                ~
-                prefix:               ~
-                is_bundle:            ~
-        auto_generate_proxy_classes: %kernel.debug%
-        proxy_dir:            %kernel.cache_dir%/doctrine/PHPCRProxies
-        proxy_namespace:      PHPCRProxies
-
-        metadata_cache_driver:
-            type:                 array
-            host:                 ~
-            port:                 ~
-            instance_class:       ~
-            class:                ~
-            id:                   ~
              -
              -
              • -
            -
            -
            -

            Configuración de traducción

            -

            Si estás utilizando documentos multilingües, necesitas configurar los idiomas disponibles. Para más información en documentos multilingües, ve la documentación PHPCR-ODM en multilenguaje.

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    odm:
-        ...
-        locales:
-            en: [en, de, fr]
-            de: [de, en, fr]
-            fr: [fr, en, de]
-
              -
              -
              • -
            -
            -

            Este bloque define el orden de regiones alternativas para ver si un documento no está traducido al idioma requerido.

            -
            -
            -
            -

            Ajustes generales

            -

            Si ajustas la ruta a jackrabbit_jar, puedes utilizar la orden de consola doctrine:phpcr:jackrabbit para arrancar y parar el jackrabbit.

            -

            Puedes poner a punto la producción de la orden doctrine:phpcr:dump con dump_max_line_length.

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    jackrabbit_jar:       /ruta/a/jackrabbit.jar
-    dump_max_line_length:  120
-
              -
              -
              • -
            -
            -
            -
            -
            -

            Configurando múltiples sesiones

            -

            Si necesitas más de una interfaz de administración PHPCR, puedes definir sessions como hijo de la información de session. Cada sesión tiene un nombre y configuración que puedes utilizar directamente en session. también puedes sobrescribir qué sesión utilizar como default_session.

            -
            -
              -
            • YAML
              # app/config/config.yml
-doctrine_phpcr:
-    session:
-        default_session:      ~
-        sessions:
-            <name>:
-                workspace:            ~ # Requerido
-                username:             ~
-                password:             ~
-                backend:
-                    # como arriba
-                options:
-                    # como arriba
-
              -
              -
              • -
            -
            -

            Si estás utilizando el ODM, también querrás configurar múltiples gestores de documento.

            -

            Dentro de la sección odm, puedes añadir entradas nombradas en document_managers. -Para utilizar la sesión no predefinida, especifica el atributo session.

            -
            -
              -
            • YAML
              odm:
-    default_document_manager:  ~
-    document_managers:
-        <name>:
-            # mismas claves como directamente en odm, ve arriba.
-            session: <sessionname>
-
              -
              -
              • -
            -
            -

            Un ejemplo completo se ve como sigue:

            -
            -
              -
            • YAML
              doctrine_phpcr:
-    # configura las sesiones PHPCR
-    session:
-        sessions:
-
-            default:
-                backend: %phpcr_backend%
-                workspace: %phpcr_workspace%
-                username: %phpcr_user%
-                password: %phpcr_pass%
-
-            website:
-                backend:
-                    type: jackrabbit
-                    url: %magnolia_url%
-                workspace: website
-                username: %magnolia_user%
-                password: %magnolia_pass%
-
-            dms:
-                backend:
-                    type: jackrabbit
-                    url: %magnolia_url%
-                workspace: dms
-                username: %magnolia_user%
-                password: %magnolia_pass%
-    # activa la capa ODM
-    odm:
-        document_managers:
-            default:
-                session: default
-                mappings:
-                    SandboxMainBundle: ~
-                    SymfonyCmfContentBundle: ~
-                    SymfonyCmfMenuBundle: ~
-                    SymfonyCmfRoutingExtraBundle: ~
-
-            website:
-                session: website
-                configuration_id: sandbox_magnolia.odm_configuration
-                mappings:
-                    SandboxMagnoliaBundle: ~
-
-            dms:
-                session: dms
-                configuration_id: sandbox_magnolia.odm_configuration
-                mappings:
-                    SandboxMagnoliaBundle: ~
-
-        auto_generate_proxy_classes: %kernel.debug%
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Este ejemplo también utiliza diferentes configuraciones par repositorio (ve el atributo repository_id). Este caso se explica en Usando una clase documento personalizada asociada con PHPCR-ODM.

            -
            -
            -
            -

            Servicios

            -

            Puedes acceder el servicios PHPCR con esto:

            -
            <?php
-
-namespace Acme\DemoBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class DefaultController extends Controller
-{
-    public function indexAction()
-    {
-        // ManagerRegistry instance with references to all sessions and document manager instances
-        $registry = $this->container->get('doctrine_phpcr');
-        // instancia de la sesión PHPCR
-        $session = $this->container->get('doctrine_phpcr.default_session');
-        // instancia del gestor del documento ODM de PHPCR
-        $documentManager = $this->container->get('doctrine_phpcr.odm.default_document_manager');
-    }
-}
-
            -
            -
            -
            -

            Eventos

            -

            You can tag services to listen to Doctrine PHPCR-ODM events. Esto trabaja de la misma manera que en el ORM de Doctrine. Las únicas diferencias son:

            -
              -
            • Usa la etiqueta doctrine_phpcr.event_listener resp. doctrine_phpcr.event_subscriber en vez de doctrine.event_listener.
              • -
            • expect the argument to be of class Doctrine\ODM\PHPCR\Event\LifecycleEventArgs rather than in the ORM namespace. -(this is subject to change, as doctrine commons 2.4 provides a common class for this event).
              • -
            -

            You can register for the events as described in the PHPCR-ODM documentation. -Or you can tag your services as event listeners resp. event subscribers.

            -
            -
              -
            • YAML
              services:
-    my.listener:
-        class: Acme\SearchBundle\EventListener\SearchIndexer
-            tags:
-                    - { name: doctrine_phpcr.event_listener, event: postPersist }
-
-    my.subscriber:
-        class: Acme\SearchBundle\EventSubscriber\MySubscriber
-            tags:
-                    - { name: doctrine_phpcr.event_subscriber }
-
              -
              -
              • -
            -
            -
            -

            Consejo

            -

            Doctrine event subscribers (both ORM and PHPCR-ODM) can not -return a flexible array of methods to call like the Symfony event subscriber -can do. Doctrine event subscribers must return a simple array of the event -names they subscribe to. Doctrine will then expect methods on the subscriber -with the names of the subscribed events, just as when using an event listener.

            -
            -

            More information with PHP code examples for the doctrine event system integration is in -this Symfony cookbook entry.

            -
            -
            -

            Constraint validator

            -

            The bundle provides a ValidPhpcrOdm constraint validator you can use to -check if your document Id or Nodename and Parent fields are -correct.

            -
            -
              -
            • YAML
              # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    constraints:
-        - Doctrine\Bundle\PHPCRBundle\Validator\Constraints\ValidPhpcrOdm
-
              -
              -
              • -
            • PHP
              // src/Acme/BlogBundle/Entity/Author.php
-
-// ...
-use Doctrine\Bundle\PHPCRBundle\Validator\Constraints as OdmAssert;
-
-/**
- * @OdmAssert\ValidPhpcrOdm
- */
-class Author
-{
-   ...
-}
-
              -
              -
              • -
            • XML
              <!-- Resources/config/validation.xml -->
-<?xml version="1.0" ?>
-<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping
-        http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-    <class name="Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route">
-        <constraint name="Doctrine\Bundle\PHPCRBundle\Validator\Constraints\ValidPhpcrOdm" />
-    </class>
-</constraint-mapping>
-
              -
              -
              • -
            -
            -
            -
            -

            Form types

            -

            The bundle provides a couple of handy form types for PHPCR and PHPCR-ODM specific cases, along with form type guessers.

            -
            -

            phpcr_odm_image

            -

            The phpcr_odm_image form maps to a document of type Doctrine\ODM\PHPCR\Document\Image -and provides a preview of the uploaded image. To use it, you need to include the -LiipImagineBundle in your project and define an -imagine filter for thumbnails.

            -

            This form type is only available if explicitly enabled in your application configuration -by defining the imagine section under the odm section with at least enabled: true. -You can also configure the imagine filter to use for the preview, as well as additional -filters to remove from cache when the image is replaced. If the filter is not specified, -it defaults to image_upload_thumbnail.

            -
            -
              -
            • YAML
              doctrine_phpcr:
-    ...
-    odm:
-        imagine:
-            enabled: true
-            # filter: image_upload_thumbnail
-            # extra_filters:
-            #    - imagine_filter_name1
-            #    - imagine_filter_name2
-
-# Imagine Configuration
-liip_imagine:
-    ...
-    filter_sets:
-        # define the filter to be used with the image preview
-        image_upload_thumbnail:
-            data_loader: phpcr
-            filters:
-                thumbnail: { size: [100, 100], mode: outbound }
-
              -
              -
              • -
            -
            -

            Then you can add images to document forms as follows:

            -
            use Symfony\Component\Form\FormBuilderInterface;
-
-protected function configureFormFields(FormBuilderInterface $formBuilder)
-{
-     $formBuilder
-        ->add('image', 'phpcr_odm_image', array('required' => false))
-     ;
-}
-
            -
            -
            -

            Truco

            -

            If you set required to true for the image, the user must re-upload a new image -each time he edits the form. If the document must have an image, it makes sense -to require the field when creating a new document, but make it optional when -editing an existing document. -We are trying to make this automatic.

            -
            -

            Next you will need to add the fields.html.twig template from the DoctrinePHPCRBundle to the form.resources, -to actually see the preview of the uploaded image in the backend.

            -
            -
              -
            • YAML
              # Twig Configuration
-twig:
-    form:
-        resources:
-            - 'DoctrinePHPCRBundle:Form:fields.html.twig'
-
              -
              -
              • -
            -
            -

            The document that should contain the Image document has to implement a setter method. -To profit from the automatic guesser of the form layer, the name in the form element -and this method name have to match:

            -
            public function setImage($image)
-{
-    if (!$image) {
-        // Esto es normal y sucede cuándo ninguna nueva imagen se ha cargado
-        return;
-    } elseif ($this->image && $this->image->getFile()) {
-        // PENDIENTE: necesario hasta que se haya corregidi este fallo en PHPCRODM: https://github.com/doctrine/phpcr-odm/pull/262
-        $this->image->getFile()->setFileContent($image->getFile()->getFileContent());
-    } else {
-        $this->image = $image;
-    }
-}
-
            -
            -

            To delete an image, you need to delete the document containing the image. (There is a proposal -to improve the user experience for that in a DoctrinePHPCRBundle issue.)

            -
            -

            Nota

            -

            There is a doctrine listener to invalidate the imagine cache for the -filters you specified. This listener will only operate when an Image is -changed in a web request, but not when a CLI command changes images. When -changing images with commands, you should handle cache invalidation in -the command or manually remove the imagine cache afterwards.

            -
            -
            -
            -

            phpcr_odm_reference_collection

            -

            This form type handles editing ReferenceMany collections on PHPCR-ODM documents. -It is a choice field with an added referenced_class required option that specifies -the class of the referenced target document.

            -

            To use this form type, you also need to specify the list of possible reference targets as an array of PHPCR-ODM ids or -PHPCR paths.

            -

            The minimal code required to use this type looks as follows:

            -
            $dataArr = array(
-    '/some/phpcr/path/item_1' => 'first item',
-    '/some/phpcr/path/item_2' => 'second item',
-);
-
-$formMapper
-    ->with('form.group_general')
-        ->add('myCollection', 'phpcr_odm_reference_collection', array(
-            'choices'   => $dataArr,
-            'referenced_class'  => 'Class\Of\My\Referenced\Documents',
-        ))
-    ->end();
-
            -
            -
            -

            Truco

            -

            When building an admin interface with Sonata Admin -there is also the sonata_type_model that is more powerful, allowing to add -to the referenced documents on the fly. Unfortunately it is -currently broken.

            -
            -
            -
            -

            phpcr_reference

            -

            The phpcr_reference represents a PHPCR Property of type REFERENCE or WEAKREFERENCE within a form. -The input will be rendered as a text field containing either the PATH or the UUID as per the -configuration. The form will resolve the path or id back to a PHPCR node to set the reference.

            -

            This type extends the text form type. It adds an option transformer_type that can be set -to either path or uuid.

            -
            -
            -
            -

            Fixture loading

            -

            To use the doctrine:phpcr:fixtures:load command, you additionally need to install the -DoctrineFixturesBundle which brings the -Doctrine data-fixtures into Symfony2.

            -

            Fixtures work the same way they work for Doctrine ORM. You write fixture classes implementing -Doctrine\Common\DataFixtures\FixtureInterface. If you place them in <Bundle>DataFixturesPHPCR, -they will be auto detected if you specify no path to the fixture loading command.

            -

            A simple example fixture class looks like this:

            -
            <?php
-
-namespace MyBundle\DataFixtures\PHPCR;
-
-use Doctrine\Common\Persistence\ObjectManager;
-use Doctrine\Common\DataFixtures\FixtureInterface;
-
-class LoadMyData implements FixtureInterface
-{
-    public function load(ObjectManager $manager)
-    {
-        // Create and persist your data here...
-    }
-}
-
            -
            -

            For more on fixtures, see the documentation of the DoctrineFixturesBundle.

            -
            -
            -

            Migration loading

            -

            The DoctrinePHPCRBundle also ships with a simple command to run migration scripts. Migrations -should implement the Doctrine\Bundle\PHPCRBundle\Migrator\MigratorInterface and registered -as a service with a doctrine_phpcr.migrator tag contains an alias attribute uniquely -identifying the migrator. There is an optional Doctrine\Bundle\PHPCRBundle\Migrator\AbstractMigrator -class to use as a basis. To find out available migrations run:

            -
            $ php app/console doctrine:phpcr:migrator
-
            -
            -

            Then pass in the name of the migrator to run it, optionally passing in an --identifier, ---depth or --session argument. The later argument determines which session name to -set on the migrator, while the first two arguments will simply be passed to the migrate() -method. You can find an example migrator in the SimpleCmsBundle.

            -
            -
            -

            Órdenes del PHPCR de Doctrine

            -

            Todas las órdenes sobre el PHPCR van prefijadas con doctrine:phpcr y puedes utilizar el argumento --session para utilizar una sesión distinta a la predefinida si configuraste varias sesiones PHPCR.

            -

            Algunas de estas órdenes son específicas a una interfaz de administración o al ODM. Esas órdenes -sólo estarán disponibles si tal interfaz de administración está configurada.

            -

            Usa app/console help <orden> para ver todas las opciones que tiene cada orden.

            -
              -
            • doctrine:phpcr:workspace:create Create a workspace in the configured repository
              • -
            • doctrine:phpcr:workspace:list List all available workspaces in the configured repository
              • -
            • doctrine:phpcr:purge Remove a subtree or all content from the repository
              • -
            • doctrine:phpcr:repository:init Register node types and create base paths
              • -
            • doctrine:phpcr:register-node-types Register node types from a .cnd file in the PHPCR repository
              • -
            • doctrine:phpcr:fixtures:load Load data fixtures to your PHPCR database.
              • -
            • doctrine:phpcr:import Import xml data into the repository, either in JCR system view format or arbitrary xml
              • -
            • doctrine:phpcr:export Export nodes from the repository, either to the JCR system view format or the document view format
              • -
            • doctrine:phpcr:dump Output all or some content of the repository
              • -
            • doctrine:phpcr:query Execute a JCR SQL2 statement
              • -
            • doctrine:phpcr:mapping:info Shows basic information about all mapped documents
              • -
            -
            -

            Nota

            -

            To use the doctrine:phpcr:fixtures:load command, you additionally need to install the -DoctrineFixturesBundle -and its dependencies. Ve su página de documentación para aprender a utilizar los accesorios.

            -
            -
            -

            Órdenes específicas de Jackrabbit

            -

            Si estás utilizando jackalope-jackrabbit, también tienes una orden para arrancar y detener el servidor jackrabbit:

            -
              -
            • jackalope:run:jackrabbit Arranca y detiene el servidor Jackrabbit
              • -
            -
            -
            -

            Órdenes específicas para el DBAL de Doctrine

            -

            Si estás utilizando jackalope-doctrine-dbal, tienes una orden para iniciar la base -de datos:

            -
              -
            • jackalope:init:dbal Prepara la base de datos para el DBAL de Doctrine con Jackalope
              • -
            -

            Ten en cuenta que también puedes utilizar la orden dbal de doctrine para crear la base de datos.

            -
            -
            -

            Algunas ordenes de ejemplo

            -

            Ejecutando consultas SQL2 contra el repositorio

            -
            app/console doctrine:phpcr:query "SELECT title FROM [nt:unstructured] WHERE NAME() = 'home'"
-
            -
            -

            Vertiendo nodos bajo /cms/simple incluyendo sus propiedades

            -
            app/console doctrine:phpcr:dump /cms/simple --props
-
            -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/routing-extra.html b/cmf/bundles/routing-extra.html deleted file mode 100644 index 8b55597..0000000 --- a/cmf/bundles/routing-extra.html +++ /dev/null @@ -1,413 +0,0 @@ - - - - - - - RoutingExtraBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            RoutingExtraBundle

            -

            El RoutingExtraBundle integra el enrutado dinámico a Symfony utilizando Enrutando.

            -

            La ChainRouter pretende reemplazar el enrutador predefinido de Symfony. Todo lo que hace es recoger una lista priorizada de rutas e intenta emparejar peticiones y generar las URL con todas ellas. Naturalmente, una de las rutas en esa cadena puede ser la ruta predefinida para que todavía la puedas utilizar de la manera estándar en algunas de tus rutas.

            -

            Además, este paquete entrega útiles implementaciones de enrutado. Actualmente, existe el DynamicRouter que enruta basándose en una lógica de cargador personalizada para los objetos Ruta de Symfony2. Puedes implementar el proveedor usando una base de datos, por ejemplo con el PHPCR-ODM de Doctrine o el ORM de Doctrine. Este paquete proporciona una implementación predefinida para el PHPCR-ODM de Doctrine.

            -

            El servicio DynamicRouter sólo está disponible cuándo se habilita explícitamente en la configuración de la aplicación.

            -

            Finalmente estos paquetes proporcionan documentos de ruta para el PHPCR-ODM de Doctrine y un controlador para redirigir rutas.

            -
            -

            Dependencias

            - -
            -
            -

            ChainRouter

            -

            La ChainRouter puede reemplazar el sistema de enrutado predefinido de Symfony con una implementación habilitada en cadena. Esta no enruta nada por sí misma, sino que únicamente recorre todos los enrutadores encadenados. Para manejar las rutas estándar configuradas en Symfony, el enrutador predefinido de Symfony se puede poner en la cadena.

            -
            -
            -

            Configurando

            -

            En tu archivo app/config/config.yml, puedes especificar cual servicio de enrutado quieres usar. Si no especificas el routers_by_id asigna todos, de manera predefinida el enrutador encadenado simplemente cargará el enrutador construido en Symfony. Cuándo especificas la lista de routers_by_id, necesitas tener una entrada para router.default si quieres el enrutador de Symfony2 (aquel que lee las rutas desde app/config/routing.yml).

            -

            El formato es service_name: priority — el número de prioridad más alto anterior es preguntado a este servicio enrutador para emparejar una ruta o para generar una url:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    chain:
-        routers_by_id:
-            # activa el DynamicRouter con alta prioridad para redefinir
-            # el enrutador configurado con contenido
-            symfony_cmf_routing_extra.dynamic_router: 200
-            # activa el enrutador predefinido de symfony con
-            # baja prioridad
-            router.default: 100
-        # cuando la cadena de enrutadores debe sustituir al enrutador predefinido. por omisión es true
-        # si lo pones en false, el enrutador sólo estará disponible como servicio
-        # symfony_cmf_routing_extra.router y debes hacer algo para lanzarlo
-        # replace_symfony_router: true
-
              -
              -
              • -
            -
            -
            -

            Cargando enrutadores con etiquetado

            -

            Tus enrutadores se pueden registrar automáticamente, justo añadiéndolos como servicios etiquetados con router y una prioridad opcional. -Mientras más alta prioridad, más temprano será consultado tu enrutador para emparejar la ruta. Si no especificas la prioridad, tu enrutador vendrá al último. -Si hay varios enrutadores con la misma prioridad, el orden entre ellos es indeterminado. -El servicio etiquetado tendrá esta apariencia:

            -
            -
              -
            • YAML
              services:
-    my_namespace.my_router:
-        class: %my_namespace.my_router_class%
-        tags:
-                - { name: router, priority: 300 }
              -
              -
              • -
            • XML
              <service id="my_namespace.my_router" class="%my_namespace.my_router_class%">
-    <tag name="router" priority="300" />
-    ..
-</service>
-
              -
              -
              • -
            -
            -

            Ve también la documentación oficial de Symfony2 para las etiquetas de inyección de dependencias

            -
            -
            -
            -

            Enrutador dinámico

            -

            Esta implementación de un enrutador utiliza NestedMatcher el cuál carga rutas de una RouteProviderInterface. La interfaz del proveedor se puede implementar fácilmente con Doctrine.

            -

            El enrutador trabaja con clases extendidas de UrlMatcher y UrlGenerator que añaden la carga de rutas desde la base de datos y el concepto de contenido referido.

            -

            El servicio NestedMatcher está configurado con un proveedor de rutas. Ve cómo cambiar el route_repository_service en la sección de configuración y la siguiente sección para más detalles de la implementación predeterminada basada en PHPCR-ODM.

            -

            Quzás quieras configurar potenciadores de enrutado para decidir cual controlador usar para manejar la petición, para evitar la codificación directa de los nombres de controlador para enrutar tus documentos.

            -

            La configuración mínima requerida para cargar el enrutador dinámico como un servicio symfony_cmf_routing_extra.dynamic_router es tenerlo como enabled: true en tu archivo config.yml (El enrutador se activa automáticamente apenas añadas cualquier otra configuración a la entrada dynamic). Sin habilitarlo, el servicio enrutador dinámico no será cargado en absoluto, dejándote utilizar la ChainRouter con tus propios enrutadores:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        enabled: true
-
              -
              -
              • -
            -
            -
            -

            Integrando PHPCR-ODM

            -

            Este paquete viene con una implementación de enrutador con repositorio para PHPCR-ODM. -PHPCR es apropiado para la naturaleza del árbol de datos. Si usas PHPCR-ODM con un documento de ruta como el proporcionado, justo puedes dejar el servicio repositorio como el predefinido.

            -

            El repositorio predefinido carga la ruta desde la ruta en la petición y todas las rutas padre para permitir que algunos de los segmentos de la ruta sigan siendo parámetros. Si necesitas una diferente manera de cargar rutas o, por ejemplo, nunca usar parámetros, puedes escribir tu propia implementación del repositorio para optimizarla (ve en el archivo cmf_routing.xml cómo configurar el servicio).

            -
            -
            -

            Proceso de concordancia

            -

            La mayoría del proceso de concordancia está descrito en la documentación del componente enrutador del CMF. -La única diferencia es que el paquete colocará el contentDocument en los atributos de la petición en vez de en la ruta predefinida.

            -

            Tus controladores pueden (y tienen que) declarar el parámetro $contentDocument en tus métodos Action si se supone que trabajen con el contenido referido por las rutas. -Ve Symfony\Cmf\Bundle\ContentBundle\Controller\ContentController para un ejemplo.

            -
            -
            -

            Configurando

            -

            Para configurar qué controlador se utiliza para cuál contenido, puedes especificar potenciadores de ruta. La presencia de cualquiera de los potenciadores en la configuración hace que el contenedor de dependencias inyecte al DynamicRouter el potenciador respectivo.

            -

            Los posibles potenciadores son (en orden de precedencia):

            -
              -

            • (Controlador explícito): Si existe un _controller en getRouteDefaults(), ningún potenciador lo sustituye.

              -
              • -

            • Plantilla explícita: Requiere que el documento de ruta regrese un parámetro '_template' en getRouteDefaults. El controlador genérico configurado está puesto por el potenciador.

              -
              • -

            • Controlador por alias: Requiere que el documento de ruta regrese un valor 'type' en getRouteDefaults()

              -
              • -
            • -
              Controlador por clase: Requiere que el documento de ruta regrese un objeto para getRouteContent(). The content document is checked for being instanceof the
              -

              class names in the map and if matched that controller is used. -Se utiliza instanceof en vez de compararlo directamente para trabajar con clases delegadas y extender otras clases.

              -
              -
              -
              • -
            • -
              Plantilla por clase: Requiere que el documento de ruta regrese un objeto para getRouteContent(). The content document is checked for being instanceof the
              -

              class names in the map and if matched that template will be set as -‘_template’ in the $defaults and the generic controller used as controller.

              -
              -
              -
              • -
            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        generic_controller: symfony_cmf_content.controller:indexAction
-        controllers_by_type:
-            editablestatic: sandbox_main.controller:indexAction
-        controllers_by_class:
-            Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: symfony_cmf_content.controller:indexAction
-        templates_by_class:
-            Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: SymfonyCmfContentBundle:StaticContent:index.html.twig
-
-        # el proveedor de ruta es responsable de cargar rutas.
-        manager_registry: doctrine_phpcr
-        manager_name: default
-
-        # Si usas la ruta predefinida del servicio repositorio de
-        # Doctrine, puedes usar esto para personalizar la ruta raíz
-        # para el RouteProvider de PHPCR-ODM. Esta ruta base
-        # es inyectada por el escucha\IdPrefix - pero sólo para
-        # las rutas que coincidan con el prefijo, para permitir
-        # más de una ruta fuente.
-        routing_repositoryroot: /cms/routes
-
-        # Si deseas reemplazar el proveedor de ruta predefinido
-        # o tu repositorio de contenido puedes especificar sus
-        # identificadores de servicio aquí.
-        route_provider_service_id: my_bundle.provider.endpoint
-        content_repository_service_id: my_bundle.repository.endpoint
-
-        # Un proveedor orm podría necesitar diferente configuración.
-        # Ve un ejemplo en cmf_routing.xml si necesitas definir
-        # tu propio servicio
-
              -
              -
              • -
            -
            -

            Para ver algunos ejemplos, por favor ve en el recinto de seguridad del CMF, específicamente la carga de accesorios de enrutado.

            -
            -

            Truco

            -

            You can also define your own RouteEnhancer classes for specific use cases. -See Personalizando.

            -
            -
            -
            -
            -

            Usando el documento de ruta PHPCR-ODM

            -

            Todas las clases de ruta deben extender la clase Route del núcleo de Symfony. Los documentos tampoco se pueden crear por código (por ejemplo un guión de accesorios) o con una interfaz web como la proporcionada para la administración PHPCR-ODM de Sonata (ve abajo).

            -

            PHPCR-ODM asocia todas las características de la ruta del núcleo al almacenamiento, así que puedes utilizar normalmente los métodos setDefault, setRequirement, setOption y setHostnamePattern. -Además cuándo creas una ruta, puedes definir si .{_format} se debería anexar al patrón y configurar con requisitos el _format requerido. -La otra opción del constructor te permite controlar si la ruta debería anexar una barra inclinada final porque esto no se puede expresar con un nombre PHPCR. El predefinido es que no tenga ninguna barra inclinada final.

            -

            Todas las rutas están localizadas bajo una ruta configurada como la raíz, por ejemplo '/cms/rutas'. -Puedes crear una nueva ruta en código PHP de la siguiente manera:

            -
            use Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route;
-$route = new Route;
-$route->setParent($dm->find(null, '/routes'));
-$route->setName('projects');
-// establece el controlador explícitamente (ambas sintaxis trabajan
-// servicio y Paquete:Nombre:acción)
-$route->setDefault('_controller', 'sandbox_main.controller:specialAction');
-
            -
            -

            Sin embargo, el ejemplo anterior probablemente se debería haber hecho como una ruta configurada en un archivo xml/yml de Symfony, a no ser que se suponga que el usuario final cambie la URL o el controlador.

            -

            Para enlazar un contenido a esta ruta, sencillamente pon lo siguiente en el documento.

            -
            $content = new Content('my content'); // el contenido se debe asociar a una clase
-$route->setRouteContent($content);
-
            -
            -

            Esto pondrá el documento en los parámetros de la petición y si tu controlador especifica un parámetro llamado $contentDocument, le será pasado este documento.

            -

            También puedes utilizar patrones variables para la URL y definir requisitos y predeterminados.

            -
            // No olvides la barra inclinada inicial si quieres /proyectos/{id} y no /proyectos{id}
-$route->setVariablePattern('/{id}');
-$route->setRequirement('id', '\d+');
-$route->setDefault('id', 1);
-
            -
            -

            Esto te dará una ruta que empareja con la URL /proyectos/<número> pero también con /proyectos ya que es el predefinido para el parámetro id. Esta emparejará con /proyectos/7 así como con /proyectos pero no con /proyectos/x-4. -El documento todavía será almacenado en /rutas/proyectos. Esto trabajará porque, como se mencionó anteriormente, el proveedor de ruta buscará documentos de ruta en todas las rutas posibles y elegirá la primera que coincida. En este ejemplo, si hay un documento de ruta en /rutas/proyectos/7 que coincida (sin más parámetros) será seleccionado. De lo contrario comprobará si /rutas/proyectos tiene un patrón que coincida. Si no, el documento superior en /rutas será comprobado.

            -

            Naturalmente también puedes tener varios parámetros, como es normal en las rutas de Symfony. La semántica y reglas para patrones, predefinidos y requisitos son exactamente iguales que en las rutas del núcleo.

            -

            Tu controlador puede esperar el parámetro $id así como el $contentDocument tal como se -puso un contenido en la ruta. El contenido se podría usar para definir una sección de introducción que sea igual en cada proyecto u otro dato compartido. Si no necesitas contenido, puedes simplemente no ponerlo en el documento.

            -
            -
            -

            Configurando la administración de Sonata

            -

            Si añades sonata-project/doctrine-phpcr-admin-bundle en la sección require de tu archivo composer.json y el SonataDoctrinePhpcrAdminBundle es cargado en el núcleo de la aplicación, los documentos de ruta son expuestos en el SonataDoctrinePhpcrAdminBundle. -Para instrucciones sobre cómo configurar este paquete ve SonataDoctrinePhpcrAdminBundle.

            -

            De manera predefinida, use_sonata_admin se configura automáticamente basándose en si SonataDoctrinePhpcrAdminBundle está disponible, pero lo puedes deshabilitar explícitamente no poniéndolo incluso si sonata está habilitado, o lo puedes habilitar explícitamente para obtener un error si sonata queda inutilizable.

            -

            Si quieres utilizar el admin, debes configurar la opción content_basepath para que apunte a la raíz de tus documentos de contenido.

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    use_sonata_admin: auto # usa true/false para forzar el uso / no uso de
-                           # la administración de sonata
-    content_basepath: ~ # usado con la administración de sonata para
-                        # manejar el contenido, por omisión a
-                        # symfony_cmf_core.content_basepath
-
              -
              -
              • -
            -
            -
            -
            -

            El tipo form

            -

            El paquete define un tipo form que puedes utilizar para la clásica casilla de verificación «aceptar términos» donde colocas las url en la etiqueta. Simplemente especifica symfony_cmf_routing_extra_terms_form_type como el nombre del tipo form y especifica una etiqueta y un arreglo con content_ids en las opciones

            -
            $form->add('terms',
-           'symfony_cmf_routing_extra_terms_form_type',
-           array('label' => 'I have seen the <a href="%team%">Team</a> and <a href="%more%">More</a> pages ...',
-                 'content_ids' => array('%team%' => '/cms/content/static/team',
-                                        '%more%' => '/cms/content/static/more')
-));
-
            -
            -

            El tipo form automáticamente genera las rutas para el contenido especificado y pasa las rutas al ayudante trans de Twig para sustituirlas en la etiqueta.

            -
            -
            -

            Notas adicionales

            -

            Ve la documentación del componente enrutador del CMF para información sobre la RouteObjectInterface, redirecciones y regiones.

            -

            Notas:

            -
              -
            • RouteObjectInterface: Los documentos proporcionados implementan esta interfaz para asociar contenido a rutas y (opcionalmente) proporcionan un nombre de ruta personalizado en vez del nombre de ruta compatible con el núcleo de Symfony.
              • -
            • Redirecciones: This bundle provides a controller to handle redirections.
              • -
            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    controllers_by_class:
-        Symfony\Cmf\Component\Routing\RedirectRouteInterface:  symfony_cmf_routing_extra.redirect_controller:redirectAction
-
              -
              -
              • -
            -
            -
            -
            -

            Personalizando

            -

            Puedes añadir más implementaciones de la RouteEnhancerInterface si tienes un caso no manejado por el proporcionado. Sencillamente define servicios para tus potenciadores y eiquétalos con dynamic_router_route_enhancer para añadirlos al enrutado.

            -

            Si usas un ODM/ORM diferente a PHPCR-ODM, probablemente necesites especificar la clase para la entidad ruta (en PHPCR-ODM, la clase es detectada automáticamente). Para necesidades más específicas, dale una mirada al DynamicRouter y ve si lo quieres extender. También puedes escribir tus propios enrutadores para engancharlos a la cadena.

            -
            - -
            -

            Notas adicionales

            -

            Para más información sobre el componente Routing del CMF de Symfony, por favor, consulta:

            -
              -
            • Enrutando para una guía introductoria al paquete Routing
              • -
            • Enrutando para la mayoría de la funcionalidad implementada actualmente
              • -
            • La página del componente Routing de Symfony2.
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/routing_auto.html b/cmf/bundles/routing_auto.html deleted file mode 100644 index c7a45ee..0000000 --- a/cmf/bundles/routing_auto.html +++ /dev/null @@ -1,602 +0,0 @@ - - - - - - - RoutingAutoBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            RoutingAutoBundle

            -

            The RoutingAutoBundle allows you to define automatically created routes -for documents. This implies a separation of the Route and Content -documents. If your needs are simple this bundle may not be for you and you -should have a look at SimpleCmsBundle.

            -

            For the sake of example, we will imagine a blog application -that has two routeable contents, the blog itself, and the posts for the blog. -We will call these documents Blog and Post, and we will class them as -content documents.

            -
            -

            Nota

            -

            In our example we add an auto route for the blog, but in reality, as a blog -is something you create rarely, you will probably want to create routes for -your blog manually, but its up to you.

            -
            -

            If we create a new Blog with the title “My New Blog” the bundle could automatically -create the route /blogs/my-new-blog. For each new Post it could create a route -such as /blogs/my-new-blog/my-posts-title. This URL resolves to a special type of -route that we will call the auto route.

            -

            By default, when we update a content document that has an auto route the -corresponding auto route will also be updated, when deleting a content document -the corresponding auto route will also be deleted.

            -

            If required, the bundle can also be configured to do extra stuff, like, for example, -leaving a RedirectRoute when the location of a content document changes or -automatically displaying an index page when an unconfigured intermediate path is -accessed (for example, listing all the children under /blogs instead of returning -a 404).

            -
            -

            Why not simply use a single route?

            -

            Of course, our fictional blog application could use a single route with a pattern -/blogs/my-new-blog/{slug} which could be handled by a controller. Why not just -do this?

            -
              -
            1. By having a route for each page in the system the application has a knowledge of -which URLs are accessible, this can be very useful, for example, when specifying -endpoints for menu items are generating a site map.
              2. -
            2. By separating the route from the content we allow the route to be customized independently -of the content, for example, a blog post may have the same title as another post but might -need a different URL.
              3. -
            3. Separate route documents are translateable - this means we can have a URL for -each language, “/welcome” and “/bienvenue” would each reference -the same document in English and French respectively. This would be difficult if -the slug were embedded in the content document.
              4. -
            4. By decoupling route and content the application doesn’t care what is referenced in -the route document. This means that we can easily replace the class of document referenced.
              5. -
            -
            -
            -

            Anatomy of an automatic URL

            -

            The diagram below shows a fictional URL for a blog post. The first 6 elements -of the URL are what we will call the content path. The last element we will call -the content name.

            -../../_images/routing_auto_post_schema.png -

            The content path is further broken down into route stacks and routes. A route -stack is a group of routes and routes are simply documents in the PHPCR tree.

            -
            -

            Nota

            -

            Although routes in this case can be of any document class, only objects which -extend the Symfony\Component\Routing\Route object will be considered when matching a URL.

            -

            The default behavior is to use Generic documents when generating a content path, and -these documents will result in a 404 when accessed directly.

            -
            -

            Internally each route stack is built up by a builder unit. Builder units contain -one path provider class and two actions classes one action to take if the provided -path exists in the PHPCR tree, the other if it does not. The goal -of each builder unit is to generate a path and then provide a route object for each -element in that path.

            -

            The configuration for the example above could be as follows:

            -
            symfony_cmf_routing_auto:
-
-    auto_route_mapping:
-        My\Namespace\Bundle\BlogBundle\Document\Post:
-            content_path:
-                # corresponds first route stack in diagram: my, blog, my-blog
-                blog_path:
-                    provider:
-                        name: content_object
-                        method: getBlog
-                    exists_action:
-                        strategy: use
-                    not_exists_action:
-                        strategy: throw_exception
-
-                # corresponds to second route stack: 2013,04,06
-                date:
-                    provider:
-                        name: content_datetime
-                        method: getPublishedDate
-                    exists_action:
-                        strategy: use
-                    not_exists_action:
-                        strategy: create
-
-            # corresponds to the content name: My Post Title
-            content_name:
-                provider:
-                    name: content_method
-                    method: getTitle
-                exists_action:
-                    strategy: auto_increment
-                    pattern: -%d
-                not_exists_action:
-                    strategy: create
-
            -
            -

            The Post document would then need to implement the methods named above as follows:

            -
            <?php
-
-class Post
-{
-    public function getBlog()
-    {
-        // return the blog object associated with the post
-        return $this->blog;
-    }
-
-    public function getPublishedDate()
-    {
-        return new \DateTime('2013/04/06');
-    }
-
-    public function getTitle()
-    {
-        return "My post title";
-    }
-}
-
            -
            -
            -
            -

            Path Providers

            -

            Path providers specify a target path which is used by the subsequent path actions to provide -the actual route documents.

            -

            Base providers must be the first configured as the first builder in the content path chain. -This is because the paths that they provide correspond directly to an existing path, i.e. they -have an absolute reference.

            -
            -

            specified (base provider)

            -

            This is the most basic path provider and allows you to specify an exact (fixed) path.

            -
            path_provider:
-    name: specified
-    path: this/is/a/path
-
            -
            -

            Options:

            -
            -
              -
            • path - required The path to provide.
              • -
            -
            -
            -

            Nota

            -

            We never specifiy absolute paths in the auto route system. If the builder unit -is the first content path chain it is understood that it is the base of an absolute -path.

            -
            -
            -
            -

            content_object (base provider)

            -

            The content object provider will try and provide a path from an object implementing -RouteAwareInterface provided by a designated method on the content document. For -example, if you have a Post class, which has a getBlog method, using -this provider you can tell the Post auto route to use the route of the blog as a -base.

            -

            So basically, if your blog content has a path of /this/is/my/blog you can use this -path as the base of your Post auto-route.

            -

            Ejemplo:

            -
            provider:
-    name: content_object
-    method: getBlog
-
            -
            -
            -

            Nota

            -

            At the time of writing translated objects are not supported. This isn’t hard to do, but well, I just -havn’t done it yet.

            -
            -

            Options:

            -
            -
              -
            • method: required Method used to return the document whose route path we wish to use.
              • -
            -
            -
            -
            -

            content_method

            -

            The content_method provider allows the content object (e.g. a blog Post) to specify -a path using one of its methods. This is quite a powerful method as it allows the content -document to do whatever it can to produce the route, the disadvantage is that your content -document will have extra code in it.

            -

            Example 1:

            -
            path_provider:
-    name: content_method
-    method: getTitle
-
            -
            -

            This example will use the existing method “getTitle” of the Post document to retrieve the -title. By default all strings are slugified.

            -

            The method can return the path either as a single string or an array of path elements -as shown in the following example:

            -
            <?php
-
-class Post
-{
-     public function getTitle()
-     {
-        return "This is a post";
-     }
-
-     public function getPathElements()
-     {
-        return array('this', 'is', 'a', 'path');
-     }
-}
-
            -
            -

            Options:

            -
            -
              -
            • method: required Method used to return the route name / path / path elements.
              • -
            • slugify: If we should use the slugifier, default is true.
              • -
            -
            -
            -
            -

            content_datetime

            -

            The content_datettime provider will provide a path from a DateTime object provided by a designated -method on the content document.

            -

            Example 1:

            -
            provider:
-    name: content_datetime
-    method: getDate
-
            -
            -

            Example 2:

            -
            provider:
-    name: content_datetime
-    method: getDate
-    date_format: Y/m/d
-
            -
            -
            -

            Nota

            -

            This method extends content_method and inherits the slugify feature. Internally we return a string using -the DateTime->format() method. This means that you can specify your date in anyway you like and it will be -automatically slugified, also, by adding path separators in the date_format you are effectively creating -routes for each date component as slugify applies to each element of the path.

            -
            -

            Options:

            -
            -
              -
            • method: required Method used to return the route name / path / path elements.
              • -
            • slugify: If we should use the slugifier, default is true.
              • -
            • date_format: Any date format accepted by the DateTime class, default Y-m-d.
              • -
            -
            -
            -
            -
            -

            Path Exists Actions

            -

            These are the default actions available to take if the path provided by a path_provider already exists and -so creating a new path would create a conflict.

            -
            -

            auto_increment

            -

            The auto_increment action will add a numerical suffix to the path, for example my/path would first become -my/path-1 and if that path also exists it will try my/path-2, my/path-3 and so on into infinity until -it finds a path which doesn’t exist.

            -

            This action should typically be used in the content_name builder unit to resolve conflicts. Using it in the -content_path builder chain would not make much sense (I can’t imagine any use cases at the moment).

            -

            Ejemplo:

            -
            exists_action:
-    name: auto_increment
-
            -
            -

            Options:

            -
            -
              -
            • None.
              • -
            -
            -
            -
            -

            use

            -

            The use action will simply take the existing path and use it. For example, in our post example the first -builder unit must first determine the blogs path, /my/blog, if this path exists (and it should) then we -will use it in the stack.

            -

            This action should typically be used in one of the content path builder units to specify that we should use -the existing route, on the other hand, using this as the content name builder action should cause the old -route to be overwritten.

            -

            Ejemplo:

            -
            exists_action:
-    name: use
-
            -
            -

            Options:

            -
            -
              -
            • None.
              • -
            -
            -
            -
            -
            -

            Path not exists actions

            -

            These are the default actions available to take if the path provided by a path_provider does not exist.

            -
            -

            create

            -

            The create action will create the path. currently all routes provided by the content path build units -will be created as Generic documents, whilst the content name route will be created as an AutoRoute document.

            -
            not_exists_action:
-    name: create
-
            -
            -

            Options:

            -
            -
              -
            • None.
              • -
            -
            -
            -
            -

            throw_exception

            -

            This action will throw an exception if the route provided by the path provider does not exist. You should take -this action if you are sure that the route should exist.

            -
            not_exists_action:
-    name: create
-
            -
            -

            Options:

            -
            -
              -
            • None.
              • -
            -
            -
            -
            -
            -

            Personalizando

            -
            -

            Adding Path Providers

            -

            The goal of a PathProvider class is to add one or several path elements to -the route stack. For example, the following provider will add the path “foo/bar” -to the route stack:

            -
            <?php
-
-use Symfony\Cmf\Bundle\RoutingAutoBundle\AutoRoute\PathProviderInterface;
-use Symfony\Cmf\Bundle\RoutingAutoBundle\AutoRoute\RouteStack;
-
-class FoobarProvider implements PathProviderInterface
-{
-    public function providePath(RouteStack $routeStack)
-    {
-        $routeStack->addPathElements(array('foo', 'bar'));
-    }
-}
-
            -
            -

            To use the path provider you must register it in the DIC and add the -symfony_cmf_routing_auto.provider tag and set the alias accordingly.

            -
            -
              -
            • XML
              <service
-    id="my_cms.some_bundle.path_provider.foobar"
-    class="FoobarProvider"
-    scope="prototype"
->
-    <tag name="symfony_cmf_routing_auto.provider" alias="foobar"/>
-</service>
-
              -
              -
              • -
            • YAML
              my_cms.some_bundle.path_provider.foobar:
-    class: "FoobarProvider"
-    scope: prototype
-    tags:
-            - { name: symfony_cmf_routing_auto.provider, alias: "foobar"}
-
              -
              -
              • -
            • PHP
              $definition = new Definition('FooBarProvider');
-$definition->addTag('symfony_cmf_routing_auto.provider', array('alias' => 'foobar'));
-$definition->setScope('prototype');
-$container->setDefinition('my_cms.some_bundle.path_provider.foobar', $definition);
-
              -
              -
              • -
            -
            -

            The foobar path provider is now available as foobar.

            -
            -

            Nota

            -

            The that both path providers and path actions need to be defined with a -scope of “prototype”. This ensures that each time the auto routing system -requests the class a new one is given and we do not have any state problems.

            -
            -
            -
            -

            Adding Path Actions

            -

            In the auto routing system, a “path action” is an action to take if the path provided -by the “path provider” exists or not.

            -

            You can add a path action by extending the PathActionInterface and registering your -new class correctly in the DI configuration.

            -

            This is a very simple implementation from the bundle - it is used to throw an exception -when a path already exists:

            -
            <?php
-
-namespace Symfony\Cmf\Bundle\RoutingAutoBundle\AutoRoute\PathNotExists;
-
-use Symfony\Cmf\Bundle\RoutingAutoBundle\AutoRoute\PathActionInterface;
-use Symfony\Cmf\Bundle\RoutingAutoBundle\AutoRoute\Exception\CouldNotFindRouteException;
-use Symfony\Cmf\Bundle\RoutingAutoBundle\AutoRoute\RouteStack;
-
-class ThrowException implements PathActionInterface
-{
-    public function init(array $options)
-    {
-    }
-
-    public function execute(RouteStack $routeStack)
-    {
-        throw new CouldNotFindRouteException('/'.$routeStack->getFullPath());
-    }
-}
-
            -
            -

            It is registered in the DI configuration as follows:

            -
            -
              -
            • XML
              <service
-    id="my_cms.not_exists_action.throw_exception"
-    class="My\Cms\AutoRoute\PathNotExists\ThrowException"
-    scope="prototype"
-    >
-    <tag name="symfony_cmf_routing_auto.not_exists_action" alias="throw_exception"/>
-</service>
-
              -
              -
              • -
            • YAML
              symfony_cmf_routing_auto.not_exists_action.throw_exception
-    class: "My\Cms\AutoRoute\PathNotExists\ThrowException"
-    scope: prototype
-    tags:
-            - { name: symfony_cmf_routing_auto.provider, alias: "throw_exception"}
              -
              -
              • -
            • PHP
              $definition = new Definition('My\Cms\AutoRoute\PathNotExists\ThrowException');
-$definition->addTag('symfony_cmf_routing_auto.provider', array('alias' => 'throw_exception'));
-$definition->setScope('prototype');
-$container->setDefinition('my_cms.some_bundle.path_provider.throw_exception', $definition);
-
              -
              -
              • -
            -
            -

            Note the following:

            -
              -

            • Scope: Must always be set to prototype;

              -
              • -
            • -
              Tag: The tag registers the service with the auto routing system, it can be one of the following;
              -
                -
              • symfony_cmf_routing_auto.exists.action - if the action is to be used when a path exists;
                • -
              • symfony_cmf_routing_auto.not_exists.action - if the action is to be used when a path does not exist;
                • -
              -
              -
              -
              • -

            • Alias: The alias of the tag is the name by which you will reference this action in the auto routing schema.

              -
              • -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/search.html b/cmf/bundles/search.html deleted file mode 100644 index bbb3c4c..0000000 --- a/cmf/bundles/search.html +++ /dev/null @@ -1,158 +0,0 @@ - - - - - - - SearchBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            SearchBundle

            -

            El SearchBundle proporciona integración con LiipSearchBundle para proporcionar búsqueda en un sitio completo.

            -
            -

            Dependencias

            - -
            -
            -

            Configurando

            -

            La clave de configuración para este paquete es symfony_cmf_search

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_search:
-    document_manager_name:  default
-    translation_strategy: child # además se puede configurar como una cadena vacía o atributo
-    translation_strategy: attribute
-    search_path: /cms/content
-    search_fields:
-        title: title
-        summary: body
-
              -
              -
              • -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/simple-cms.html b/cmf/bundles/simple-cms.html deleted file mode 100644 index 5e50708..0000000 --- a/cmf/bundles/simple-cms.html +++ /dev/null @@ -1,268 +0,0 @@ - - - - - - - SimpleCmsBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            SimpleCmsBundle

            -

            El SimpleCmsBundle proporciona un CMS simplista sobre los componentes y paquetes del CMF.

            -

            Si bien los componentes del núcleo del CMF se enfocan en la flexibilidad, el simple CMS especula con alguna de esa flexibilidad a favor de la simplicidad.

            -

            El SimpleCmsBundle proporciona una solución para fácilmente asignar contenido, rutas y elementos del menú basando el repositorio de contenido en una única estructura de árbol.

            -

            Para una sencilla instalación de ejemplo del paquete revisa la Edición estándar del CMF de Symfony

            -

            Puedes encontrar una introducción al paquete en la sección Primeros pasos.

            -

            El sitio web de CMF es -otra aplicación que utiliza el SimpleCmsBundle.

            -
            -

            Dependencias

            -

            Tal como se especifica en el archivo composer.json este paquete depende de muchos de los paquetes del CMF.

            -
            -
            -

            Configurando

            -

            La clave de configuración para este paquete es symfony_cmf_simple_cms.

            -

            La opción use_menu automáticamente habilita un servicio para proporcionar los menús del simple CMS si MenuBundle está habilitado. También lo puedes desactivar explícitamente si tienes el paquete menu pero no quieres utilizar el servicio predefinido, o habilitarlo explícitamente para conseguir un error si el paquete menu se vuelve inasequible.

            -

            La sección de enrutado define cual plantilla o controlador utilizar para una clase de contenido. This is reusing what routing extra does, please see the corresponding -routing configuration section. También explica el generic_controller.

            -

            Ve la sección para soporte multilingüe más adelante.

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_simple_cms:
-    use_menu:             auto # usa true/false para forzar provisión / no provisión de un menú
-    use_sonata_admin:     auto # use true/false to force using / not using sonata admin
-    sonata_admin:
-        sort:             false # set to asc|desc to sort children by publication date
-    document_class:       Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page
-                            # controlador a usar para dibujar documentos
-                            # únicamente con plantilla personalizada
-    generic_controller:   symfony_cmf_content.controller:indexAction
-    # dónde almacenar las páginas en el árbol PHPCR
-    basepath:             /cms/simple
-    routing:
-        content_repository_id:  symfony_cmf_routing_extra.content_repository
-        controllers_by_class:
-            # ...
-        templates_by_class:
-            # ...
-    multilang:
-        locales:              []
-
              -
              -
              • -
            -
            -
            -

            Truco

            -

            Si tienes habilitada la administración PHPCR-ODM de Sonata pero NO quieres mostrar la administración predefinida proporcionada por este paquete, puedes añadir lo siguiente a tu configuración:

            -
            -
              -
            • YAML
              symfony_cmf_simple_cms:
-    use_sonata_admin: false
-
              -
              -
              • -
            -
            -
            -
            -
            -

            Soporte multilingüe

            -

            El modo multi-language-mode se habilita proporcionando la lista de regiones permitidas en el campo multilang > locales.

            -

            En multi-language-mode el paquete automáticamente utilizará Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangPage como la document_class a no ser que explícitamente esté configurada una clase diferente.

            -

            Esta clase de manera predeterminada prefijará todas las rutas con /{_locale}. Este comportamiento se puede desactivar poniendo a false el segundo parámetro en el constructor del modelo.

            -

            Además, la capa de enrutado será configurada para utilizar Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangRouteRepository la cuál garantizará que incluso con el prefijo locale el nodo de contenido correcto será encontrado. Además, automáticamente añade un _locale el requisito enumerando las regiones actualmente disponibles para la ruta emparejada.

            -
            -

            Nota

            -

            Debido a que SimpleCmsBundle sólo proporciona una sencilla estructura de árbol, todos los nodos tendrán el mismo nombre de nodo para todos los idiomas. Así que una url http://foo.com/en/bar para contenido en inglés se vería cómo http://foo.com/de/bar para contenido en alemán. A veces puede ser más factible utilizar enteros como nombres de nodo y sencillamente anexarlos al título del nodo en la región dada como una ancla. Así por ejemplo http://foo.com/de/1#my title y http://foo.com/de/1#mein title. -Si necesitas las URL específicas al idioma, quieres usar el enrutado del paquete CMF y el paquete de contenido directamente para tener un documento de ruta separado por idioma.

            -
            -
            -
            -

            Reproduciendo

            -

            Puedes especificar la plantilla para reproducir una página del SimpleCms, o utilizar un controlador donde luego proporciones el documento de página a la plantilla. Un sencillo ejemplo para tal plantilla es este:

            -
            {% block content %}
-
-    <h1>{{ page.title }}</h1>
-
-    <div>{{ page.body|raw }}</div>
-
-    <ul>
-    {% foreach tag in page.tags %}
-        <li>{{ tag }}</li>
-    {% endforeach %}
-    </ul>
-
-{% endblock %}
-
            -
            -

            Si tienes habilitado el CreateBundle, también puedes producir el documento con anotaciones RDF, permitiéndote editar el contenido así como las etiquetas en la interfaz de usuario. La forma más sencilla es el siguiente bloque de Twig:

            -
            {% block content %}
-
-    {% createphp page as="rdf" %}
-        {{ rdf|raw }}
-    {% endcreatephp %}
-
-{% endblock %}
-
            -
            -

            Si quieres un control más detallado se tendría que mostrar con RDF, ve el capítulo CreateBundle.

            -
            -
            -

            Extendiendo la clase Page

            -

            El documento Page predefinido Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page es relativamente sencillo, viene con un puñado de las propiedades más comunes para construir una página típica: título, cuerpo, etiquetas, fechas de publicación, etc.

            -

            Si esto no es suficiente para tu proyecto fácilmente puedes proporcionar tu propio documento extendiendo el documento Page predefinido y colocando los parámetros de configuración explícitamente a tu propia clase documento:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_simple_cms:
-    ...
-    document_class:       Acme\DemoBundle\Document\MySuperPage
-    ...
-
              -
              -
              • -
            -
            -

            Alternativamente, el documento Page predefinido contiene una propiedad «extras». Esta almacena una clave — valor (dónde el valor tiene que ser una cadena o null) el cuál puedes usar para pequeñas adiciones triviales, sin tener que extender el documento Page predefinido.

            -

            Por ejemplo:

            -
            $page = new Page();
-
-$page->setTitle('Hello World!');
-$page->setBody('Really interesting stuff...');
-
-// set extras
-$extras = array(
-    'subtext' => 'Add CMS functionality to applications built with the Symfony2 PHP framework.',
-    'headline-icon' => 'exclamation.png',
-);
-
-$page->setExtras($extras);
-
-$documentManager->persist($page);
-
            -
            -

            Luego, puedes acceder a estas propiedades en tu controlador o plantillas a través de los método getExtras() o getExtra($key).

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/tree-browser.html b/cmf/bundles/tree-browser.html deleted file mode 100644 index fdc66c1..0000000 --- a/cmf/bundles/tree-browser.html +++ /dev/null @@ -1,353 +0,0 @@ - - - - - - - TreeBrowserBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            TreeBrowserBundle

            -

            El TreeBrowserBundle proporciona un árbol de navegación en lo alto de un repositorio PHPCR.

            -

            Este paquete consta de dos partes:

            -
            -
              -
            • Árbol de navegación genérico con una TreeInterface
              • -
            • Implementación del árbol PHPCR e IGU para un navegador PHPCR
              • -
            -
            -
            -

            Dependencias

            - -
            -
            -

            Configurando

            -

            La clave de configuración para este paquete es symfony_cmf_tree_browser

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_tree_browser:
-    session:  default
-
              -
              -
              • -
            -
            -
            -
            -

            Enrutado

            -

            El paquete creará las rutas para cada implementación del árbol encontrado. In order to make -those routes available you need to include the following in your routing configuration:

            -
            -
              -
            • YAML
              # app/config/routing.yml
-symfony_cmf_tree:
-    resource: .
-    type: 'symfony_cmf_tree'
-
              -
              -
              • -
            -
            -
            -
            -

            Usando

            -

            Tienes select.js e init.js los cuáles son una envoltura para construir un árbol jQuery. Úsalos con SelectTree.initTree resp. AdminTree.initTree

            -
            -
              -
            • SelectTree en select.js es un árbol para seleccionar un nodo para poner el id a un campo
              • -
            • AdminTree en init.js es para crear un árbol, mover y editar nodos
              • -
            -
            -

            Ambos tienen las siguientes opciones al crearlos:

            -
            -
              -
            • config.selector: selector jQuery dónde enganchar en el árbol js
              • -
            • config.rootNode: id para el nodo raíz de tu árbol, predefinido a «/»
              • -
            • config.selected: id del nodo seleccionado
              • -
            • config.ajax.children_url: URL al controlador que proporciona los hijos de un nodo
              • -
            • config.routing_defaults: array for route parameters (such as _locale etc.)
              • -
            • config.path.expanded: ruta de árbol donde el árbol se tendría que expandir al momento
              • -
            • config.path.preloaded: árbol de rutas en el cual se debería precargar el nodo para acelerar la experiencia del usuario
              • -
            -
            -
            -

            Solo select.js

            -
            -
              -
            • config.output: Dónde escribir el id del nodo seleccionado
              • -
            -
            -
            -
            -

            Solo init.js

            -
            -
              -
            • config.labels: arreglo conteniendo la traducción para las etiquetas del contexto menú (claves 'createItem' y 'deleteItem')
              • -
            • config.ajax.move_url: URL al controlador para mover un hijo (es decir, asignarle un nuevo nodo padre)
              • -
            • config.ajax.reorder_url: URL al controlador para reorganizar hermanos
              • -
            • config.types: arreglo indexado con los tipos de nodo conteniendo información sobre valid_children, iconos y rutas disponibles, utilizados para crear el contexto del menú y para comprobación durante las operaciones de movimiento.
              • -
            -
            -
            -
            -
            -

            Ejemplos

            -

            Ve en las plantillas del paquete de administración de Sonata los ejemplos sobre cómo construir el árbol:

            - -

            En el mismo paquete el PhpcrOdmTree implementa la interfaz de árbol y da un ejemplo sobre cómo implementar los métodos.

            -

            Aquí tienes algunos consejos comunes sobre la utilización del TreeBrowser:

            -
            -

            Define tree elements

            -

            The first step, is to define all the elements allowed in the tree and their children. -Have a look at the cmf-sandbox configuration, the section document_tree in sonata_doctrine_phpcr_admin.

            -

            This configuration is set for all your application trees regardless their type (admin or select).

            -
            -
              -
            • YAML
              sonata_doctrine_phpcr_admin:
-    document_tree_defaults: [locale]
-    document_tree:
-        Doctrine\ODM\PHPCR\Document\Generic:
-            valid_children:
-                - all
-        Symfony\Cmf\Bundle\ContentBundle\Document\MultilangStaticContent:
-            valid_children:
-                - Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock
-                - Symfony\Cmf\Bundle\BlockBundle\Document\ContainerBlock
-                - Symfony\Cmf\Bundle\BlockBundle\Document\ReferenceBlock
-                - Symfony\Cmf\Bundle\BlockBundle\Document\ActionBlock
-        Symfony\Cmf\Bundle\BlockBundle\Document\ReferenceBlock:
-            valid_children: []
-        ...
-
              -
              -
              • -
            -
            -
            -
            -

            How to add an admin tree to your page

            -

            This can be done either in an action template or in a custom block.

            -

            You have to specify the tree root and the selected item, this allows you to have different type of content in your tree.

            -

            In this example, we will have the menu elements.

            -

            For Symfony 2.2 and later

            -
            -
              -
            • Twig
              {% render(controller('sonata.admin.doctrine_phpcr.tree_controller:treeAction')) with { 'root': websiteId~"/menu", 'selected': menuNodeId, '_locale': app.request.locale } %}
-
              -
              -
              • -
            -
            -

            For Symfony 2.1

            -
            -
              -
            • Twig
              {% render 'sonata.admin.doctrine_phpcr.tree_controller:treeAction' with { 'root': websiteId~"/menu", 'selected': menuNodeId, '_locale': app.request.locale } %}
-
              -
              -
              • -
            -
            -
            -
            -

            How to customize the tree behaviour

            -

            The TreeBrowserBundle is based on jsTree. jsTree works with events, dispatched everytime the user does an action.

            -

            A simple way to customize the tree behavior is to bind your actions to those events.

            -

            If you have a look at init.js and select.js, you will notice that actions are already bound to some of the tree events. If the default behavior is not -what you need, JQuery provide the unbind function to solve the problem.

            -

            Here is a simple way to remove the context menu from the admin tree (add the -controller call around the controller name inside render for Symfony 2.2) :

            -
            -
              -
            • Twig
              {% render 'sonata.admin.doctrine_phpcr.tree_controller:treeAction' with { 'root': websiteId~"/menu", 'selected': menuNodeId, '_locale': app.request.locale } %}
-<script type="text/javascript">
-    $(document).ready(function() {
-        $('#tree').bind("before.jstree", function (e, data) {
-            if (data.plugin === "contextmenu") {
-                e.stopImmediatePropagation();
-                    return false;
-            }
-        });
-    });
-</script>
-
              -
              -
              • -
            -
            -

            By default, the item selection open the edit route of the admin class of the element. This action is bind to the “select_node.jstree”.

            -

            If you want to remove it, you just need to call the unbind function on this event :

            -
            -
              -
            • Twig
              <script type="text/javascript">
-    $(document).ready(function() {
-        $('#tree').unbind('select_node.jstree');
-    });
-</script>
-
              -
              -
              • -
            -
            -

            Then you can bind it on another action.

            -

            For example, if your want to open a custom action :

            -
            -
              -
            • Twig
              $('#tree').bind("select_node.jstree", function (event, data) {
-    if ((data.rslt.obj.attr("rel") == 'Symfony_Cmf_Bundle_MenuBundle_Document_MenuNode'
-        || data.rslt.obj.attr("rel") == 'Symfony_Cmf_Bundle_MenuBundle_Document_MultilangMenuNode')
-        && data.rslt.obj.attr("id") != '{{ menuNodeId }}'
-    ) {
-        var routing_defaults = {'locale': '{{ locale }}', '_locale': '{{ _locale }}'};
-        routing_defaults["id"] = data.rslt.obj.attr("url_safe_id");
-        window.location = Routing.generate('presta_cms_page_edit', routing_defaults);
-    }
-});
              -
              -
              • -
            -
            -

            Don’t forget to add your custom route to the fos_js_routing.routes_to_expose configuration :

            -
            -
              -
            • YAML
              fos_js_routing:
-    routes_to_expose:
-        - symfony_cmf_tree_browser.phpcr_children
-        - symfony_cmf_tree_browser.phpcr_move
-        - sonata.admin.doctrine_phpcr.phpcrodm_children
-        - sonata.admin.doctrine_phpcr.phpcrodm_move
-        - presta_cms_page_edit
-
              -
              -
              • -
            -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/bundles/tree.html b/cmf/bundles/tree.html deleted file mode 100644 index e0cc400..0000000 --- a/cmf/bundles/tree.html +++ /dev/null @@ -1,249 +0,0 @@ - - - - - - - TreeBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            TreeBundle

            -

            Este paquete es obsoleto puesto que su contenido se movió al TreeBrowserBundle.

            -
            -

            Dependencias

            - -
            -
            -

            Configurando

            -

            No hay ninguna configuración para este paquete.

            -
            -
            -

            Características

            -
            -
              -
            • Expandiendo/colapsando nodos.
              • -
            • Cargando subárboles relajadamente vía respuestas JSON para llamadas AJAX.
              • -
            • Función retrollamada al conmutar un nodo.
              • -
            -
            -
            -
            -

            Usando

            -
            -
              -
            • Incluye archivos CSS y JS en tu plantilla.
              • -
            • Llama a $("#tree").jstree({/* parámetros */}) — suponiendo que aquí #tree es el selector de tu lista.
              • -
            • Proporciona el valor url que apunta a alguna cosa de lado del servidor regresando listas de nodos hijo para cualquier ID de nodo dado.
              • -
            -
            -

            El servidor tiene que responder en formato JSON, este es un ejemplo:

            -
            [
-    {"data":"root","attr":{"id":"root","rel":"folder"},"state":"closed","children":
-        [
-            {"data":"content","attr":{"id":"child1","rel":"folder"},"state":"closed"},
-            {"data":"menu","attr":{"id":"child2","rel":"folder"},"state":"closed"},
-            {"data":"routes","attr":{"id":"child3","rel":"folder"},"state":"closed"}
-        ]
-    }
-]
-
            -
            -

            Disponemos de más información sobre la configuración en el sitio web de jsTree.

            -
            -
            -

            Ejemplo HTML

            -
                <html>
-        <head>
-        <title>CMF Sandbox - Treeview test</title>
-
-        <link href="/bundles/symfonycmftree/css/jquery.treeview.css" media="screen" type="text/css" rel="stylesheet" />
-
-        <script src="/bundles/sonatajquery/jquery-1.7.1.js" type="text/javascript"></script>
-
-        <script src="{{ asset('bundles/symfonycmftree/js/jstree/jquery.jstree.js') }}" type="text/javascript"></script>
-
-        <script type="text/javascript">
-            function initTrees() {
-
-                jQuery("#tree").jstree({
-                    "plugins" :     [ "themes", "types", "ui", "json_data" ],
-                    "json_data": {
-                        "ajax": {
-                            url:    "subtree.php",
-                            data:   function (node) {
-                                return { 'root' : jQuery(node).attr('id') };
-                            }
-                        }
-                    },
-                    "types": {
-                        "max_depth":        -2,
-                        "max_children":     -2,
-                        "valid_children":  [ "folder" ],
-                        "types": {
-                            "default": {
-                                "valid_children": "none",
-                                "icon": {
-                                    "image": "/images/document.png"
-                                }
-                            },
-                            "folder": {
-                                "valid_children": [ "default", "folder" ],
-                                "icon": {
-                                    "image": "/images/folder.png"
-                                }
-                            }
-                        }
-                    }
-                })
-                .bind("select_node.jstree", function (event, data) {
-                    window.location = "edit.php?id=" + data.rslt.obj.attr("id");
-                })
-                .delegate("a", "click", function (event, data) { event.preventDefault(); });
-            }
-            $(document).ready(function(){
-                initTrees();
-
-            });
-        </script>
-
-        </head>
-        <body>
-
-        <ul id="tree">
-        </ul>
-
-        <table border="1" id="properties"></table>
-
-        <hr/>
-
-        {% block content %}
-            Hello {{ name }}!
-        {% endblock %}
-    </body>
-</html>
-
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 24, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/components/routing.html b/cmf/components/routing.html deleted file mode 100644 index 97de680..0000000 --- a/cmf/components/routing.html +++ /dev/null @@ -1,297 +0,0 @@ - - - - - - - Enrutando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Enrutando

            -

            La biblioteca del componente Routing del CMF de Symfony extiende el componente routing del núcleo de Symfony2. Incluso, aunque este tiene Symfony en su nombre, no necesita la plataforma Symfony2 completa y se puede utilizar en proyectos independientes. Para integrarlo con Symfony proporcionamos el RoutingExtraBundle.

            -

            En el núcleo del CMF de Symfony el componente de enrutado es la ChainRouter, que se utiliza en vez del sistema de enrutamiento predefinido de Symfony2. La ChainRouter puede encadenar varias implementaciones de la RouterInterface, una tras otra, para determinar cuál debería manejar cada petición. Puedes añadir a esta cadena el enrutador predeterminado de Symfony2, por lo tanto aún puedes utilizar el mecanismo de enrutado estándar.

            -

            Adicionalmente, este componente pretende proporcionar útiles implementaciones de las interfaces de enrutado. Actualmente, proporciona el DynamicRouter, el cuál utiliza una RequestMatcherInterface para cargar Rutas dinámicamente, y puede aplicar las estrategías de la RouteEnhancerInterface con el fin de manipularlas. El NestedMatcher proporcionado puede recuperar dinámicamente objetos Route de Symfony2 -desde una RouteProviderInterface. Estas interfaces abstraen una colección de Rutas, que puedes almacenar en una base de datos, tal como PHPCR-ODM de Doctrine o el ORM de Doctrine. El DynamicRouter también utiliza una instancia del UrlGenerator para generar rutas y proporciona una implementación de esta bajo el ProviderBasedGenerator el cual puede generar las rutas cargadas desde una instancia de la RouteProviderInterface, y en lo alto del ContentAwareGenerator para determinar el objeto ruta a partir de un objeto Contenido.

            -
            -

            Nota

            -

            Para utilizar este componente fuera del contexto de la plataforma Symfony2, tienes que ver el componente Routing en el núcleo de Symfony2 para entender su fundamento. El enrutador del CMF justo extiende el comportamiento básico.

            -
            -
            -

            Dependencias

            -

            Este componente usa composer. It needs the -Symfony2 Routing component and the Symfony2 HttpKernel (for the logger -interface and cache warm-up interface).

            -

            Para el DynamicRouter necesitarás algo para implementar la RouteProviderInterface. Se sugiere utilizar Doctrine puesto que proporciona una manera fácil de asociar clases a una base de datos.

            -
            -
            -

            ChainRouter

            -

            En el núcleo del CMF de Symfony el componente de enrutado es la ChainRouter. -Este se utiliza en vez del sistema de enrutado predefinido de Symfony2, y es responsable de determinar los parámetros de cada petición. Típicamente necesitas determinar qué controlador manejará esta petición —en la pila completa de la plataforma Symfony2, este está identificado por el campo _controller de los parámetros—.

            -

            La ChainRouter trabaja aceptando un conjunto priorizado de implementaciones de estrategias de enrutado, RouterInterface, generalmente conocidos como «Enrutadores».

            -

            Al manejar una petición entrante, la ChainRouter itera sobre los enrutadores configurados, por su prioridad configurada, hasta que uno de ellos es capaz de emparejar -la petición y proporcionar sus parámetros.

            -
            -
            -

            Enrutadores

            -

            La ChainRouter en sí misma, es incapaz de tomar alguna decisión de enrutado real. -Its sole responsibility is managing the given set of Routers, which are responsible for matching a request and determining its parameters.

            -

            You can easily create your own Routers by implementing -RouterInterface -but Symfony CMF already includes a powerful route matching system that you can -extend to your needs.

            -
            -

            Nota

            -

            Si lo estás utilizando como parte de un proyecto completo con el CMF de Symfony, por favor, revisa el RoutingExtraBundle para instrucciones sobre cómo añadir Enrutadores a la ChainRouter. De lo contrario, usa el método add de la ChainRouter para configurar nuevos Enrutadores.

            -
            -
            -

            Enrutador predefinido de Symfony2

            -

            El mecanismo de enrutado de Symfony2 en sí mismo es una implementación de la RouterInterface, lo cual significa que lo puedes utilizar como Enrutador en la ChainRouter. Esto te permite utilizar las declaraciones del sistema de enrutado predefinido.

            -
            -
            -

            Enrutador dinámico

            -

            El Enrutador predefinido de Symfony2 se desarrolló para manejar definiciones de Rutas estáticas, puesto que estas tradicionalmente son declaradas en archivos de configuración, antes de ejecutar la aplicación. -Esto lo vuelve una elección pobre para manejar rutas definidas dinámicamente, y para manejar tales situaciones, este paquete viene con el DynamicRouter. Este es capaz de manejar rutas desde datos fuente más dinámicos, tal como los almacenados en bases de datos, y modificar los parámetros resultantes que utilizan un conjunto de potenciadores que puedes configurar fácilmente, muchos de ellos extendiendo la funcionalidad predefinida de Symfony2.

            -
            -

            Emparejador

            -

            El DynamicRouter utiliza una instancia de la RequestMatcherInterface o de la UrlMatcherInterface para emparejar la Petición o URL recibida, a un arreglo de parámetros, respectivamente. -La lógica de emparejado real depende de la implementación subyacente que elijas. -You can easily use you own matching strategy by passing it to the DynamicRouter -constructor. Como parte de este paquete, ya proporciona un NestedMatcher que puedes utilizar inmediatamente, o como referencia para tu propia implementación.

            -

            Su otra característica son las estrategias utilizadas por la RouteEnhancerInterface para inferir parámetros de enrutado a partir de la información proporcionada por la ruta coincidente (ve abajo).

            -
            -
            -

            NestedMatcher

            -

            La implementación de la RequestMatcherInterface proporcionada es NestedMatcher. -It is suitable for use with DynamicRouter, and it uses a multiple step -matching process to determine the resulting routing parameters from a given -Request.

            -

            Esta utiliza una implementación de la RouteProviderInterface, la cual es capaz de cargar objetos candidatos a Ruta para una Petición dinámica desde una fuente de datos. Although it can be used -in other ways, the RouteProviderInterface‘s main goal is to be easily -implemented on top of Doctrine PHPCR ODM or a relational database, -effectively allowing you to store and manage routes dynamically from database.

            -

            El NestedMatcher utiliza un proceso de emparejamiento de 3 pasos para determinar qué Ruta utilizar al manejar la Petición actual:

            -
              -
            • Pregunta a la RouteProviderInterface por la potencial colección de instancias de Ruta que emparejan la Petición
              • -
            • Aplica todas las RouteFilterInterface para filtrar esa colección
              • -
            • Permite que la instancia de FinalMatcherInterface decida la mejor coincidencia entre las restantes instancias de Ruta y la transforma en el arreglo de parámetros.
              • -
            -
            -
            -
            -

            RouteProviderInterface

            -

            Basándose en la Petición, el NestedMatcher recuperará una colección ordenada de objetos Ruta desde la RouteProviderInterface. La idea de esta proveedora es proporcionar todas las rutas que potencialmente podrían coincidir, pero no para hacer ninguna elaborada operación de emparejamiento todavía —este es el trabajo de los siguientes pasos—.

            -

            La implementación subyacente de la RouteProviderInterface no está en el alcance de este paquete. Por favor, revisa la declaración de la interfaz para más información. Para un ejemplo funcionando, ve el RoutingExtraBundle.

            -
            -
            -

            RouteFilterInterface

            -

            El NestedMatcher puede aplicar las implementaciones provistas por el usuario de la RouteFilterInterface para reducir los objetos Ruta proporcionados, p. ej. haciendo una negociación de contenido. -Es responsabilidad de cada filtro lanzar la ResourceNotFoundException si no quedan más rutas en la colección.

            -
            -
            -

            FinalMatcherInterface

            -

            La implementación de la FinalMatcherInterface tiene que determinar una Ruta exactamente como la mejor coincidencia o lanzar una excepción si ninguna empareja adecuadamente. La implementación predefinida utiliza el UrlMatcher -del componente Routing de Symfony.

            -
            -

            Potenciadores de ruta

            -

            Optionally, and following the matching process, a set of RouteEnhancerInterface -instances can be applied by the DynamicRouter. El objetivo de estas es permitirte manipular los parámetros de la ruta emparejada. Puedes utilizarlas, por ejemplo, para asignar dinámicamente un controlador o una plantilla a una Ruta o para convertir un parámetro de la Petición a objeto. Algunos potenciadores sencillos ya vienen incorporados en el paquete, puedes encontrar la documentación dentro de cada archivo de clase.

            -
            -
            -

            Enlazando una Ruta con un Contenido

            -

            Dependiendo de la lógica de tu aplicación, una URL solicitada puede tener contenido asociado desde la base de datos. Estas Rutas deberían implementar la RouteObjectInterface, y opcionalmente pueden regresar una instancia del modelo. Si configuras la RouteContentEnhancer, esta debe incluir ese contenido en el arreglo emparejado, con la clave _content. Ten en cuenta que una Ruta puede implementar la interfaz mencionada anteriormente pero todavía no regresar ninguna instancia del modelo, en cuyo caso ningún objeto asociado será regresado.

            -

            Además, los enrutadores que implementen esta interfaz también pueden proporcionar un nombre de ruta personalizado. La clave devuelta por getRouteKey será utilizada como el nombre de ruta en vez del nombre de ruta compatible con el núcleo de Symfony y puede contener cualquiera de los caracteres del juego de caracteres actual. Esto te permite, por ejemplo, poner una ruta como el nombre de la ruta. Ambos UrlMatchers proporcionados con el NestedMatcher reemplazan la clave _route con la instancia de la ruta y ponen el nombre proporcionado a _route_name.

            -

            Todos los enrutadores todavía necesitan extender la clase base Symfony\Component\Routing\Route.

            -
            -
            -

            Redirecciones

            -

            Puedes construir redirecciones implementando la RedirectRouteInterface. -Esta puede redirigir a una URI absoluta, a una Ruta nombrada que puede generar cualquier Enrutador en la cadena o a otro objeto Ruta provisto por el enrutador.

            -

            Ten en cuenta que la redirección lógica real no es manejada por el paquete. Deberías implementar tu propia lógica para manejar la redirección. Para un ejemplo implementando esta redirección bajo la pila completa de Symfony2, revisa RoutingExtraBundle.

            -
            -
            -
            -

            Generando URL

            -

            Aparte de emparejar una petición entrante a un conjunto de parámetros, un Enrutador también es responsable de generar una URL a partir de una Ruta y sus parámetros. -La ChainRouter itera sobre sus enrutadores hasta que uno de ellos es capaz de generar una URL concordante.

            -

            Aparte de utilizar una RequestMatcherInterface o una UrlMatcherInterface para emparejar una Petición/URL a sus parámetros correspondientes, el DynamicRouter también utiliza una instancia de la UrlGeneratorInterface, misma que te permite generar una URL desde una Ruta.

            -

            The included ProviderBasedGenerator extends Symfony2’s default -UrlGenerator -(which, in turn, implements UrlGeneratorInterface) and - if $name is -not already a Route object - loads the route from the RouteProviderInterface. -Entonces permite que la lógica del núcleo genere la URL de esa Ruta.

            -

            El paquete también incluye el ContentAwareGenerator, el cual extiende el ProviderBasedGenerator para comprobar si el $name es un objeto implementando la RouteAwareInterface y, de ser así, consigue la Ruta a partir del contenido. -Usando el ContentAwareGenerator, puedes generar direcciones URL para tu contenido de tres maneras:

            -
              -
            • O bien, pasa un objeto Ruta como $name
              • -
            • O pasa un objeto RouteAwareInterface que es tu contenido como $name
              • -
            • O proporciona una implementación de la ContentRepositoryInterface y pasa el id del objeto Contenido como el parámetro content_id y null como $name.
              • -
            -
            -
            -

            ContentAwareGenerator y regiones

            -

            Puedes usar el valor predeterminado de _locale en una Ruta para crear una ruta por región, todas refiriéndose a la misma instancia del contenido multilingüe. El ContentAwareGenerator respeta el _locale al generar rutas a partir de instancias de Contenido. Al resolver la ruta, el _locale se obtiene desde la petición y es recogido por el sistema regional de Symfony2.

            -
            -

            Nota

            -

            Bajo PHPCR-ODM, las rutas nunca deberían ser documentos traducibles, puesto que un documento de Ruta representa una URL única, y no es recomendable servir varias traducciones bajo la misma URL.

            -

            Si necesitas direcciones URL traducidas, haz que la región forme parte del nombre de la ruta.

            -
            -
            -
            -
            -

            Personalizando

            -

            Los paquetes de enrutado cuentan con muchas opciones de personalización, dependiendo de tus necesidades específicas:

            -
              -
            • Puedes implementar tu propio RouteProvider para cargar rutas desde una fuente diferente
              • -
            • Tus parámetros de Ruta se pueden manipular fácilmente utilizando potenciadores existentes
              • -
            • También puedes añadir tus propios potenciadores al DynamicRouter
              • -
            • Puedes añadir instancias de la RouteFilterInterface al NestedMatcher
              • -
            • El DynamicRouter o sus componentes se pueden extender para permitir modificaciones
              • -
            • Puedes implementar tus propios Enrutadores y añadirlos a la ChainRouter
              • -
            -
            -

            Nota

            -

            Si sientes que tu potenciador o Enrutador específico le puede ser útil a otros, contáctanos e intentaremos incluirlo en el paquete.

            -
            -
            -
            -

            Integrando con Symfony2

            -

            Tal como mencioné antes, este paquete fue diseñado para sólo requerir ciertas partes de Symfony2. Aun así, si deseas utilizarlo como parte de tu proyecto CMF de Symfony, también hay disponible un paquete de integración. Te recomendamos que le eches un vistazo en RoutingExtraBundle.

            -

            Para una guía introductoria al paquete Routing y su integración con Symfony2, consulta Enrutando.

            -

            We strongly recommend reading Symfony2’s -Routing -component documentation page, as it’s the base of this bundle’s implementation.

            -
            -
            -

            Autores

            -
              -
            • Filippo De Santis (p16)
              • -
            • Henrik Bjornskov (henrikbjorn)
              • -
            • Claudio Beatrice (omissis)
              • -
            • Lukas Kahwe Smith (lsmith77)
              • -
            • David Buchmann (dbu)
              • -
            • Larry Garfield (Crell)
              • -
            • Y otros
              • -
            -

            El código original para la cadena de enrutadores fue aportado por Magnus Nordlander.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/contributing/code.html b/cmf/contributing/code.html deleted file mode 100644 index f20737f..0000000 --- a/cmf/contributing/code.html +++ /dev/null @@ -1,144 +0,0 @@ - - - - - - - Colaborando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Colaborando

            -

            El equipo del CMF de Symfony2 sigue todas las reglas y directrices del proceso de desarrollo que el núcleo de Symfony2.

            - -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/contributing/license.html b/cmf/contributing/license.html deleted file mode 100644 index 8aa1072..0000000 --- a/cmf/contributing/license.html +++ /dev/null @@ -1,178 +0,0 @@ - - - - - - - Licencia — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Licencia

            -

            El objetivo del CMF de Symfony2 es proporcionar licencias de código abierto liberales para su pila completa.

            -
            -

            Código

            -

            La pila del código está cubierta por la licencia de Apache para Jackalope y PHPCR, el resto de la pila, notablemente el código Symfony2, PHPCR-ODM, create.js y Hallo.js está licenciado bajo MIT. Por favor, refiérete a los archivos de LICENCIA pertinentes en la fuente de los paquetes dados.

            -
            -
            -

            Documentación

            -

            La documentación de Symfony2 está bajo una licencia Creative Commons Attribution-Share Alike 3.0 Unported License.

            -

            Estás en libertad:

            -
              -
            • para Compartir — copiar, distribuir y trasmitir públicamente la obra;
              • -
            • para Derivar — adaptando la obra.
              • -
            -

            Bajo las siguientes condiciones:

            -
              -
            • Atribución — Debes atribuir el trabajo de la manera especificada por -el autor o licenciador (pero de ninguna manera que sugiera que apoya tu -uso de la obra).
              • -
            • Compartir bajo la misma licencia — Si alteras, transformas, o creas -sobre esta obra, sólo podrás distribuir la obra resultante bajo una -licencia idéntica o similar a esta.
              • -
            -

            En el entendido de:

            -
              -

            • Renuncia — Cualquiera de estas condiciones puede no aplicarse si -obtienes el permiso del titular de los derechos de autor;

              -
              • -

            • Dominio Público — Cuando la obra o cualquiera de sus elementos es del -dominio público bajo la legislación aplicable, este estatus de ninguna -manera es afectado por la licencia;

              -
              • -

            • Otros Derechos — De ninguna manera cualquiera de los siguientes derechos -se ve afectado por la licencia:

              -
              -
                -
              • Tu derecho leal o uso justo, u otros derechos de autor excepciones y limitaciones aplicables;
                • -
              • Los derechos morales del autor;
                • -
              • Otras personas pueden tener derechos ya sea en la propia obra o en la forma en que se utiliza la obra, como los derechos de publicidad o privacidad.
                • -
              -
              -
              • -

            • Atención — Para cualquier reutilización o distribución, debes dejar -claros los términos de la licencia de esta obra. La mejor manera de hacerlo es con un enlace a esta página web.

              -
              • -
            -

            Este es un resumen humanamente legible del Texto legal (Licencia completa).

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/cookbook/installing-cmf-sandbox.html b/cmf/cookbook/installing-cmf-sandbox.html deleted file mode 100644 index 4d806a4..0000000 --- a/cmf/cookbook/installing-cmf-sandbox.html +++ /dev/null @@ -1,333 +0,0 @@ - - - - - - - Instalando el recinto de seguridad del CMF — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Instalando el recinto de seguridad del CMF

            -

            Esta guía muestra cómo instalar el recinto de seguridad del CMF de Symfony, una demostración de la plataforma dirigida a exhibir las características básicas de la herramienta corriendo en un entorno demo. -La puedes usar para evaluar la plataforma o para ver código real en acción, ayudándote a entender la herramienta.

            -

            Si bien lo puedes utilizar tal cual, este recinto de seguridad no pretende ser una plataforma de desarrollo. Si estás buscando instrucciones de instalación para una configuración de desarrollo, por favor revisa:

            - -
            -

            Requisitos previos

            -

            Debido a que el CMF de Symfony está basado en Symfony2, deberías asegurarte de que cubres los Requisitos para que funcione Symfony2. -Git 1.6+, Curl y PHP Intl también son necesarios para seguir los pasos de instalación enumerados más adelante.

            -

            If you wish to use Jackalope + Apache JackRabbit as the storage medium (recommended), -you will also need Java (JRE). Para otros mecanismos y sus requisitos, por favor refiérete a sus respectivas secciones.

            -
            -
            -

            Instalando

            -
            -

            Apache Jackrabbit

            -

            El recinto de seguridad del CMF de Symfony de manera predeterminada usa Jackalope con Apache JackRabbit. -Puedes configurar métodos de almacenamiento alternativo, pero este es el más probado, y debería ser el más fácil de configurar.

            -

            Puedes conseguir la más reciente versión de Apache Jackrabbit en la página de descarga oficial del proyecto. -Para lanzarlo, usa la siguiente orden:

            -
            java -jar jackrabbit-standalone-*.jar
-
            -
            -

            By default the server is listening on the 8080 port, you can change this -by specifying the port on the command line.

            -
            java -jar jackrabbit-standalone-*.jar --port 8888
-
            -
            -

            For unix systems, you can get the start-stop script for /etc/init.d here

            -
            -
            -

            Consiguiendo el código del recinto de seguridad

            -

            El código fuente del recinto de seguridad del CMF de Symfony está disponible en github. Para conseguirlo usa:

            -
            git clone git://github.com/symfony-cmf/cmf-sandbox.git
-
            -
            -

            Ve al directorio y copia los archivos de configuración predefinidos:

            -
            cd cmf-sandbox
-cp app/config/parameters.yml.dist app/config/parameters.yml
-cp app/config/phpcr_jackrabbit.yml.dist app/config/phpcr.yml
-
            -
            -

            These two files include the default configuration parameters for the sandbox -storage mechanism. Los puedes modificar para cubrir mejor tus necesidades.

            -
            -

            Nota

            -

            The second configuration file refers to specific jackalope + -jackrabbit configuration. There are other files available for -different stack setups.

            -
            -

            Next, get composer and install and the necessary bundles (this may take a while)

            -
            curl -s http://getcomposer.org/installer | php --
-php composer.phar install
-
            -
            -
            -

            Nota

            -

            En Windows necesitas ejecutar el intérprete de ordenes como administrador o editar el archivo composer.json`y cambiar la línea `“symfony-assets-install”: “symlink”`` a "symfony-assets-install": "". Si fallas al hacerlo podrías recibir:

            -
            -
            [Symfony\Component\Filesystem\Exception\IOException]
-Imposible crear el enlace simbólico debido al error código 1314: 'El cliente no cuenta con un privilegio requerido'. ¿Tienes el privilegio de administrador requerido?
-
            -
            -
            -
            -

            Preparando el repositorio PHPCR

            -

            Now that you have all the code, you need to setup your PHPCR repository. -PHPCR organizes data in workspaces, and sandbox uses the “default” workspace, -which is exists by default in Jackrabbit. If you use other applications that -require Jackrabbit, or if you just wish to change the workspace name, you -can do so in app/config/phpcr.yml. La siguiente orden creará un nuevo espacio de trabajo llamado «sandbox» en Jackrabbit. Si decides utilizar el espacio de trabajo «default», la puedes omitir.

            -
            app/console doctrine:phpcr:workspace:create sandbox
-
            -
            -

            Once your workspace is set up, you need to register the node types for phpcr-odm:

            -
            app/console doctrine:phpcr:repository:init
-
            -
            -
            -
            -

            Import the fixtures

            -

            La interfaz de administración sigue en una etapa temprana. Hasta que mejore, lo más fácil es crear los datos programáticamente. La mejor manera de hacerlo es con los accesorios de Doctrine. El DoctrinePHPCRBundle incluido en el repositorio symfony-cmf proporciona una orden para cargar accesorios.

            -
            app/console -v doctrine:phpcr:fixtures:load
-
            -
            -

            Ejecuta esta orden para cargar los accesorios desde el MainBundle del recinto de seguridad, la cual poblará tu repositorio con datos maniquí, es decir, carga las páginas demo.

            -
            -
            -

            Accediendo a tu recinto de seguridad

            -

            El recinto de seguridad ahora debería ser accesible en tu servidor web.

            -
            http://localhost/app_dev.php
-
            -
            -

            Para ejecutar el recinto de seguridad en modo de producción necesitas generar los delegados de Doctrine y volcar los activos de assetic:

            -
            app/console cache:warmup --env=prod --no-debug
-app/console assetic:dump --env=prod --no-debug
-
            -
            -
            -
            -
            -

            Mecanismos de almacenamiento alternativo

            -

            El CMF de Symfony y el recinto de seguridad son de almacenamiento agnóstico, lo cual significa que puedes cambiar el mecanismo de almacenamiento sin tener que cambiar tu código. El mecanismo de almacenamiento predefinido para el recinto de seguridad es Jackalope + Apache Jackrabbit, puesto que es la configuración más probada y estable. Sin embargo, hay otras alternativas disponibles.

            -
            -

            Jackalope + DBAL de Doctrine

            -
            -

            Nota

            -

            De manera predeterminada, cuándo utilizas el DBAL de Doctrine, los datos se almacenan utilizando una base de datos Sqlite. -Revisa la página del proyecto para instrucciones de instalación. -Si deseas utilizar otros sistemas de base de datos, cambia los parámetros de configuración en el archivo app/config/parameters.yml. Consulta la página sobre la configuración del DBAL de Doctrine en Symfony o la documentación de Doctrine para más información.

            -
            -

            Ve al directorio del recinto de seguridad y copia el archivo de configuración predefinido para -configurar el DBAL de Doctrine:

            -
            cd cmf-sandbox
-cp app/config/phpcr_doctrine_dbal.yml.dist app/config/phpcr.yml
-
            -
            -

            Next, you need to install the actual Doctrine DBAL bundle required by jackalope:

            -
            php composer.phar require jackalope/jackalope-doctrine-dbal:dev-master
-
            -
            -

            Y crea e inicia tu base de datos:

            -
            app/console doctrine:database:create
-app/console doctrine:phpcr:init:dbal
-
            -
            -

            Después de esto, deberías seguir los pasos en Preparando el repositorio PHPCR.

            -
            -

            Memorizando en caché con Doctrine

            -

            Opcionalmente, para mejorar el rendimiento y habilitar los metadatos, puedes instalar LiipDoctrineCacheBundle -escribiendo la siguiente orden:

            -
            php composer.phar require liip/doctrine-cache-bundle:dev-master
-
            -
            -

            And adding the following entry to your app/AppKernel.php:

            -
            // app/AppKernel.php
-public function registerBundles()
-{
-  $bundles = array(
-      // ...
-      new Liip\DoctrineCacheBundle\LiipDoctrineCacheBundle(),
-      // ...
-  );
-}
-
            -
            -

            Finalmente descomenta las opciones de caché en el archivo phpcr.yml así como las de liip_doctrine_cache en el archivo config.yml.

            -
            # app/config/phpcr.yml
-caches:
-    meta: liip_doctrine_cache.ns.meta
-    nodes: liip_doctrine_cache.ns.nodes
-
            -
            -
            # app/config/config.yml
-
-# jackalope doctrine caching
-liip_doctrine_cache:
-    namespaces:
-        meta:
-            type: file_system
-        nodes:
-            type: file_system
-
            -
            -
            -
            -
            -

            Proveyendo PHPCR para Midgard2

            -

            Si quieres correr el recinto de seguridad del CMF con el proveedor PHPCR de Midgard2 en vez de Jackrabbit, necesitas instalar la extensión midgard2 de PHP. -En sistemas Debian/Ubuntu actuales, esto se hace simplemente con:

            -
            sudo apt-get install php5-midgard2
-
            -
            -

            En OS X lo puedes instalar utilizando cualquier Homebrew con:

            -
            brew install midgard2-php
-
            -
            -

            o MacPorts con

            -
            sudo port install php5-midgard2
-
            -
            -

            You also need to download midgard_tree_node.xml -and midgard_namespace_registry.xml -schema files, and place them into “<your-midgard2-folder>/schema” (defaults to “/usr/share/midgard2/schema”)

            -

            To have the Midgard2 PHPCR implementation installed run the following additional command:

            -
            php composer.phar require midgard/phpcr:dev-master
-
            -
            -

            Finalmente, cambia uno de los archivos de configuración de Midgard2:

            -
            cp app/config/phpcr_midgard_mysql.yml.dist app/config/phpcr.yml
-
            -
            -

            o

            -
            cp app/config/phpcr_midgard_sqlite.yml.dist app/config/phpcr.yml
-
            -
            -

            After this, your should follow the steps in `Preparing the PHPCR repository`_ -to continue the installation process.

            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/cookbook/phpcr-odm-custom-documentclass-mapper.html b/cmf/cookbook/phpcr-odm-custom-documentclass-mapper.html deleted file mode 100644 index 4c4cf55..0000000 --- a/cmf/cookbook/phpcr-odm-custom-documentclass-mapper.html +++ /dev/null @@ -1,157 +0,0 @@ - - - - - - - Usando una clase documento personalizada asociada con PHPCR-ODM — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Usando una clase documento personalizada asociada con PHPCR-ODM

            -

            El asignador predefinido para la clase document PHPCR-ODM utiliza el atributo phpcr:class para almacenar y recuperar la clase documento de un nodo. Cuándo accedes a un repositorio PHPCR existente, podrías necesitar diferente lógica para decidir en la clase.

            -

            Puedes extender el DocumentClassMapper o implementar la DocumentClassMapperInterface desde el principio. Los métodos importantes son getClassName que se necesita para encontrar el nombre de clase y writeMetadata que se necesita para garantizar que la clase de un nuevo documento almacenado se puede determinar al cargarlo de nuevo.

            -

            Luego, puedes sustituir el servicio doctrine.odm_configuration para llamar a setDocumentClassMapper en él. Un ejemplo del recinto de seguridad del CMF de Symfony (rama de magnolia_integration):

            -
            -
              -
            • YAML
              # Resources/config/services.yml
-
-# Si quieres sobrescribir la configuración predefinida, de lo contrario utiliza
-# un nombre personalizado y pónlo en el bloque de configuración del odm
-
-doctrine.odm_configuration:
-    class: %doctrine_phpcr.odm.configuration.class%
-    calls:
-        - [ setDocumentClassMapper, [@sandbox_magnolia.odm_mapper] ]
-
-sandbox_magnolia.odm_mapper:
-    class: "Sandbox\MagnoliaBundle\Document\MagnoliaDocumentClassMapper"
-    arguments:
-        - 'standard-templating-kit:pages/stkSection': 'Sandbox\MagnoliaBundle\Document\Section'
              -
              -
              • -
            -
            -

            Aquí creamos una asociación que usa una configuración para leer información del nodo y se asocia a una clase documento.

            -

            Si tienes varios repositorios, puedes usar una configuración por repositorio. -See Configurando múltiples sesiones.

            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/cookbook/using-a-custom-route-repository.html b/cmf/cookbook/using-a-custom-route-repository.html deleted file mode 100644 index 22cb170..0000000 --- a/cmf/cookbook/using-a-custom-route-repository.html +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - Usando un repositorio de rutas personalizado con un enrutador dinámico — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Usando un repositorio de rutas personalizado con un enrutador dinámico

            -

            El enrutador dinámico te permite personalizar la ruta al repositorio (es decir, la clase responsable de recuperar rutas desde la base de datos), y por extensión, los objetos Ruta.

            -
            -

            Creando el repositorio de rutas

            -

            El repositorio de rutas tiene que implementar la RouteRepositoryInterface. La siguiente clase proporciona una solución sencilla que utiliza un repositorio ODM.

            -
            <?php
-
-namespace MyVendor\Bundle\MyBundle\Repository;
-use Doctrine\ODM\PHPCR\DocumentRepository;
-use Symfony\Cmf\Component\Routing\RouteRepositoryInterface;
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route as SymfonyRoute;
-
-class RouteRepository extends DocumentRepository implements RouteRepositoryInterface
-
-{
-    // Este método se usa para encontrar las rutas que coinciden con la URL dada
-    public function findManyByUrl($url)
-    {
-        // por simplicidad recuperamos una ruta
-        $myDocument = $this->findOneBy(array(
-            'url' => $url,
-        ));
-
-        $pattern = $myDocument->getUrl(); // p. ej. "/esta/es/una/url"
-
-        $collection = new RouteCollection();
-
-        // crea una nueva ruta y pone nuestro documento como
-        // predefinido (a modo de que lo podamos recuperar desde la petición)
-        $route = new SymfonyRoute($ep->getPath(), array(
-            'document' => $document,
-        ));
-
-        // Añade la ruta al RouteCollection usando
-        // como clave un ID único.
-        $collection->add('my_route_'.uniqid(), $route);
-
-        return $collection;
-    }
-
-    // este método se usa para generar URL, p. ej. {{ path('foobar') }}
-    public function getRouteByName($name, $params = array())
-    {
-        $document = $this->findOneBy(array(
-            'name' => $name,
-        ));
-
-        if ($route) {
-            $route = new SymfonyRoute($route->getPattern(), array(
-                'document' => $document,
-            ));
-        }
-
-        return $route;
-    }
-}
-
            -
            -
            -

            Truco

            -

            Como posiblemente hayas notado regresamos un objeto RouteCollection — ¿porqué no regresamos una sola Ruta? El enrutador dinámico nos permite regresar muchas rutas candidatas, en otras palabras, rutas que podrían emparejar con la URL entrante. Esto es importante para habilitar la posibilidad de emparejar rutas dinámicas, /page/{page_id}/edit por ejemplo. -En nuestro ejemplo emparejamos las URL dadas exactamente y siempre regresar únicamente una sola Ruta.

            -
            -
            -
            -

            Reemplazando el repositorio predefinido del CMF

            -

            Para reemplazar el RouteRepository predefinido es necesario modificar tu configuración -de la siguiente manera:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        enabled: true
-        route_repository_service_id: my_bundle.repository.endpoint
-
              -
              -
              • -
            -
            -

            Donde my_bundle.repository.endpoint es el ID del servicio de tu repositorio. -Ve Creando y configurando servicios en el contenedor para información sobre la creación de servicios personalizados.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/getting-started/content.html b/cmf/getting-started/content.html deleted file mode 100644 index 64c314f..0000000 --- a/cmf/getting-started/content.html +++ /dev/null @@ -1,191 +0,0 @@ - - - - - - - Contenido — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Contenido

            -
            -

            Concepto

            -

            El corazón de cada CMS está en el contenido, una abstracción que los editores pueden manipular y que más tarde será presentado a los usuarios de la página. La estructura del contenido depende mucho de las necesidades del proyecto, y este debe tener un significativo impacto en el futuro uso y desarrollo de la plataforma.

            -

            La EE del CMF de Symfony viene con el ContentBundle: una implementación básica de una estructura de contenido, incluyendo el soporte para múltiples idiomas y el almacenamiento de Rutas en la base de datos.

            -
            -
            -

            Contenido estático

            -

            El StaticContent declara la estructura básica del contenido. Su estructura es muy similar a las utilizadas en los sistemas ORM de Symfony2, y la mayoría de sus campos son autoexplicativos, ya que son lo que esperarías de un CMS básico: -título, cuerpo, información de publicación y una referencia al padre, para organizar un árbol jerárquico. Este también incluye un bloque de referencia (más sobre esto más adelante).

            -

            Las dos interfaces implementadas revelan dos de las características incluidas en esta implementación:

            -
              -
            • RouteAwareInterface significa que el contenido tiene Rutas asociadas.
              • -
            • PublishWorkflowInterface significa que el contenido tiene fechas de publicación y despublicación, las cuales serán manejadas por el núcleo del CMF de Symfony para determinar el acceso.
              • -
            -
            -
            -

            Contenido multilingüe estático

            -

            The MultilangStaticContent extends StaticContent, offering the same -functionality with multi language support. Este especifica qué campos son traducidos (title, body y tags) así como una variable para declarar la región.

            -

            También especifica la estrategia de traducción:

            -
            -
              -
            • Annotations
              /**
- * @PHPCRODM\Document(translator="child", referenceable=true)
- */
-
              -
              -
              • -
            -
            -

            Para información sobre las estrategias de traducción disponibles, consulta la página -de Doctrine relacionada con el Soporte multilingüe en el PHPCR-ODM

            -
            -
            -

            Controlador de contenido

            -

            Para manejar ambos tipos de contenido, también incluye un Controlador. Its inner -workings are pretty straightforward: acepta una instancia de contenido y opcionalmente una plantilla a dibujar. If none is provided, it uses a pre-configured default. -It also takes into account the document’s publishing status and multi language. -Ambas instancias de contenido y la plantilla opcional son proporcionadas al Controlador -por el DynamicRouter del RoutingExtraBundle. More information on this is -available on the Routing system getting started page -page.

            -
            -
            -

            Admin Support

            -

            El último componente necesario para manejar los tipos de contenido incluidos es una interfaz de administración. Symfony CMF can optionally support SonataDoctrinePHPCRAdminBundle -, a back office generation tool. Para más información sobre esta, por favor consulta la sección de documentación del paquete.

            -

            En ContentBundle, las nterfaces de administración requeridas ya están declaradas en el directorio Admin y configuradas en el archivo Resources/config/admin.xml, y serán cargadas automáticamente si instalas el SonataDoctrinePHPCRAdminBundle (ve Creando un CMS con CMF y Sonata para instrucciones sobre esto).

            -
            -
            -

            Configurando

            -

            El paquete también apoya un conjunto opcional de parámetros de configuración. Consulta ContentBundle para la referencia de configuración completa.

            -
            -
            -

            Consideraciones finales

            -

            Si bien este pequeño paquete incluye algunos componentes vitales para un CMS completamente operativo, a menudo no proporciona todo lo que necesitas. The main idea behind it is to -provide developers with a small and easy to understand starting point you can -extend or use as inspiration to develop your own content types, Controllers and -Admin panels.

            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/getting-started/installing-symfony-cmf.html b/cmf/getting-started/installing-symfony-cmf.html deleted file mode 100644 index 2437abb..0000000 --- a/cmf/getting-started/installing-symfony-cmf.html +++ /dev/null @@ -1,265 +0,0 @@ - - - - - - - Instalando la edición estándar del CMF de Symfony — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Instalando la edición estándar del CMF de Symfony

            -

            El objetivo de esta guía es instalar todos los componentes del CMF con la configuración mínima necesaria y algunos muy sencillos ejemplos en una aplicación Symfony2 en funcionamiento. Esto se suele usar para familiarizarte con el CMF o para utilizarlo como punto de partida para personalizar una nueva aplicación.

            -

            Si este es tu primer encuentro con el CMF de Symfony sería buena idea darle un vistazo primero a:

            - -
            -

            Nota

            -

            Para otras guías de instalación del CMF de Symfony, por favor, consulta:

            - -
            -
            -

            Requisitos previos

            -

            Debido a que el CMF de Symfony está basado en Symfony2, deberías asegurarte de que cubres los Requisitos para que funcione Symfony2. -Además, necesitas tener instalada la extensión PDO de SQLite (pdo_sqlite), puesto que esta se utiliza como el medio de almacenamiento predeterminado.

            -
            -

            Nota

            -

            By default, Symfony CMF uses Jackalope + Doctrine DBAL and SQLite as -the underlying DB. No obstante, el CMF de Symfony es de almacenamiento agnóstico, lo cual significa que puedes utilizar uno de varios mecanismos de almacenamiento de datos disponibles sin tener que reescribir tu código. Para más información en los diferentes mecanismos disponibles y cómo instalarlos y configurarlos, consulta el Instalando y configurando Doctrine y PHPCR-ODM

            -
            -

            Git and Curl are also -needed to follow the installation steps listed below.

            -
            -
            -

            Instalando

            -

            La manera más fácil de instalar el CMF de Symfony es utilizando Composer. -Consíguelo usando:

            -
            $ curl -sS https://getcomposer.org/installer | php
-$ sudo mv composer.phar /usr/local/bin/composer
-
            -
            -

            Y luego consigue el código del CMF de Symfony con él (esto puede tomar un buen rato)

            -
            $ php composer.phar create-project symfony-cmf/standard-edition <path-to-install> --stability=dev
-$ cd <path-to-install>
-
            -
            -
            -

            Nota

            -

            The path <path-to-install> should either inside your web server doc root or -configure a virtual host for <path-to-install>.

            -
            -

            Esto clonará la edición estándar e instalará todas las dependencias y ejecutará algunas órdenes iniciales. -Estas órdenes requieren permisos de escritura en los directorios app/cache y app/logs. En caso de que al final las órdenes terminen dando errores de permisos, por favor sigue las directrices en la documentación oficial para configurar los permisos y luego ejecuta la orden composer.phar install mencionada abajo.

            -

            Si lo prefieres, también puedes clonar el proyecto directamente:

            -
            $ git clone git://github.com/symfony-cmf/symfony-cmf-standard.git <dir-name>
-$ cd <dir-name>
-
            -
            -

            Si ocurrieron problemas durante la orden create-project, o si utilizaste git clone o si después activaste una versión anterior (con checkout), siempre ejecuta la siguiente orden para actualizar las dependencias:

            -
            $ php composer.phar install
-
            -
            -

            The next step is to setup the database, if you want to use SQLite as your database backend just go -ahead and run the following:

            -
            $ php app/console doctrine:database:create
-$ php app/console doctrine:phpcr:init:dbal
-$ php app/console doctrine:phpcr:repository:init
-$ php app/console doctrine:phpcr:fixtures:load
-
            -
            -

            This will create a file called app.sqlite inside your app folder, containing the database content.

            -

            El proyecto ahora tendría que estar accesible en tu servidor web. Si tienes instalado PHP 5.4, alternativamente puedes utilizar el servidor web interno de PHP:

            -
            $ php app/console server:run
-
            -
            -

            Y entonces accede al CMF vía:

            -
            http://localhost:8000
-
            -
            -

            Si prefieres utilizar otro servidor de base de datos, por ejemplo MySQL, ejecuta el configurador (apunta tu navegador a /web/config.php) o configura tus parámetros de conexión a la base de datos en el archivo app/config/parameters.yml. Asegúrate de dejar la propiedad database_path en null para utilizar otro controlador distinto a SQLite. Dejar el campo en blanco en el configurador web lo debería poner a null.

            -
            -
            -

            Descripción

            -

            Esta guía te ayudará a entender las partes básicas de la edición estándar del CMF de Symfony (EE) y cómo trabajan juntas para proporcionar las páginas predefinidas que puedes ver al explorar la instalación de la Edición estándar del CMF de Symfony.

            -

            It assumes you have already installed Symfony CMF SE and have carefully -read the Symfony2 book.

            -
            -

            Nota

            -

            Para otras guías de instalación del CMF de Symfony, por favor, consulta:

            - -
            -
            -

            AcmeMainBundle y SimpleCMSBundle

            -

            La EE del CMF de Symfony viene con un AcmeMainBundle predefinido para ayudarte a empezar, en una manera similar al AcmeDemoBundle que tiene Symfony2, proporcionándote algunas páginas de demostración visibles en tu navegador. Sin embargo, el AcmeMainBundle no incluye controladores o archivos de configuración, como probablemente esperarías. Este contiene poco más que un archivo Twig y datos Accesorios, que fueron cargados a tu base de datos durante la instalación.

            -

            Hay varios paquetes trabajando juntos para convertir los datos accesorios en un sitio web navegable. El proceso global simplificado, es el siguiente:

            -
              -
            • When a request is received, the Symfony CMF Enrutando‘s Dynamic Router is used to handle the -incoming request.
              • -
            • The Dynamic Router is able to match the requested URL with a specific ContentBundle’s Content -stored in the database.
              • -
            • The retrieved content’s information is used to determine which controller to pass it on to, and -which template to use.
              • -
            • As configured, the retrieved content is passed to ContentBundle’s ContentController, which will -handle it and render AcmeMainBundle’s layout.html.twig.
              • -
            -

            Una vez más, esto es un vistazo simplificado de un muy sencillo CMS construido en lo alto del CMF de Symfony. -To fully understand all the possibilities of the CMF, a careful look into -each component is needed.

            -

            If you want to review the contents of the PHPCR database you can use the following command:

            -
            $ php app/console doctrine:phpcr:dump
-
            -
            -
            -
            -

            Adding new pages

            -

            Symfony CMF SE does not provide any admin tools to create new pages. If you are interested in adding -an admin UI have a look at Creando un CMS con CMF y Sonata. However if all you -want is a simple way to add new pages that you can then edit via the inline editing, then you can -use the SimpleCmsBundle page migrator. The Symfony CMF SE ships with an example yaml file stored -in app/Resources/data/pages/test.yml. The contents of this file can be loaded into the PHPCR -database by calling:

            -
            $ php app/console doctrine:phpcr:migrator page --identifier=/cms/simple/test
-
            -
            -

            Note that the above identifier is mapped to app/Resources/data/pages/test.yml by stripping -off the basepath configuration of the SimpleCmsBundle, which defaults to /cms/simple. -Therefore if you want to define a child page foo for /cms/simple/test you would need to -create a file ``app/Resources/data/pages/test/foo.yml and then run the following command:

            -
            $ php app/console doctrine:phpcr:migrator page --identifier=/cms/simple/test/foo
-
            -
            -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/getting-started/menu.html b/cmf/getting-started/menu.html deleted file mode 100644 index 2cdc8bc..0000000 --- a/cmf/getting-started/menu.html +++ /dev/null @@ -1,260 +0,0 @@ - - - - - - - Menú — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - - - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/getting-started/overview.html b/cmf/getting-started/overview.html deleted file mode 100644 index 1ab314c..0000000 --- a/cmf/getting-started/overview.html +++ /dev/null @@ -1,136 +0,0 @@ - - - - - - - Información general — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Información general

            -

            Esta guía te ayudará a entender las partes básicas de la edición estándar del CMF de Symfony (EE) y cómo trabajan juntas para proporcionar las páginas predefinidas que puedes ver al explorar la instalación de la Edición estándar del CMF de Symfony.

            -

            Se supone que ya has instalado la edición estándar del CMF de Symfony y has leído cuidadosamente el libro de Symfony2.

            -
            -

            Nota

            -

            Para otras guías de instalación del CMF de Symfony, por favor, consulta: -- El artículo Instalando el recinto de seguridad del CMF en el recetario para instrucciones sobre cómo instalar un ejemplo de una demostración más completa del CMF de Symfony. -- Instalando y configurando el núcleo del CMF para instrucciones de instalación paso a paso y detalles de configuración de los componentes necesarios del núcleo en una aplicación de Symfony existente.

            -
            -
            -

            AcmeMainBundle y SimpleCMSBundle

            -

            La EE del CMF de Symfony viene con un AcmeMainBundle predefinido para ayudarte a empezar, en una manera similar al AcmeDemoBundle que tiene Symfony2, proporcionándote algunas páginas de demostración visibles en tu navegador. Sin embargo, el AcmeMainBundle no incluye controladores o archivos de configuración, como probablemente esperarías. Este contiene poco más que un archivo Twig y datos Accesorios, que fueron cargados a tu base de datos durante la instalación.

            -

            Hay varios paquetes trabajando juntos para convertir los datos accesorios en un sitio web navegable. El proceso global simplificado, es el siguiente:

            -
              -
            • Al recibir una petición, El componente Routing del CMF de Symfony, el Enrutador dinámico se usa para manejar la petición entrante.
              • -
            • El Enrutador dinámico es capaz de emparejar la URL solicitada con el contenido de un ContentBundle específico almacenado en la base de datos.
              • -
            • La información del contenido recuperado se usa para determinar a cuál controlador pasarlo, y qué plantilla utilizar.
              • -
            • Tal cual esté configurado, el contenido recuperado se pasa al ContentController del ContentBundle, el cual lo manejará y reproducirá la plantilla layout.html.twig del AcmeMainBundle.
              • -
            -
            -
            Una vez más, esto es un vistazo simplificado de un muy sencillo CMS construido en lo alto del CMF de Symfony. -Para entender completamente todas las posibilidades del CMF, es necesario darle un muy cuidadoso vistazo a cada componente.
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 18, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/getting-started/routing.html b/cmf/getting-started/routing.html deleted file mode 100644 index e276acf..0000000 --- a/cmf/getting-started/routing.html +++ /dev/null @@ -1,535 +0,0 @@ - - - - - - - Enrutando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            Enrutando

            -

            Esta es una introducción para entender los conceptos detrás del enrutado del CMF. Para la documentación de referencia por favor ve Enrutando y RoutingExtraBundle.

            -
            -

            Concepto

            -
            -

            Why a new Routing Mechanism?

            -

            Los CMS son sitios altamente dinámicos, donde la mayoría del contenido lo gestionan los administradores en lugar de los desarrolladores. El número de páginas disponibles fácilmente puede alcanzar miles, lo cual normalmente es multiplicado por el número de traducciones disponibles. Mejor accesibilidad y prácticas SEO, así como preferencias de usuario dictan que direcciones URL deberían ser definibles por los gestores de contenido.

            -

            El mecanismo de enrutado predefinido de Symfony2, con enfoque de archivos de configuración, no es la mejor solución para este problema, puesto que no es apropiado para manejar rutas dinámicas definidas por el usuario, ni escalan bien para un gran número de rutas.

            -
            -
            -

            The Solution

            -

            Para afrontar estos problemas, se desarrolló un nuevo sistema de enrutado, este tiene en cuenta las necesidades típicas de enrutado de un CMS:

            -
              -
            • User defined URLs;
              • -
            • Multi-site;
              • -
            • Multi-language;
              • -
            • Tree-like structure for easier management;
              • -
            • Contenido, Menú y separación de Rutas para flexibilidad adicional.
              • -
            -

            Con estos requisitos en mente, fue desarrollado el componente Routing del CMF de Symfony.

            -
            -
            -
            -

            La ChainRouter

            -

            En el núcleo del CMF de Symfony el componente de enrutado es la ChainRouter. -Esta se utiliza como sustituta para el sistema de enrutado predefinido de Symfony2 y, como tal, es responsable de determinar cuál Controlador manejará cada petición.

            -

            The ChainRouter works by accepting a set of prioritized routing strategies, -Symfony\Component\Routing\RouterInterface implementations, -commonly referred to as “Routers”. The routers are responsible for matching an -incoming request to an actual Controller and, to do so, the ChainRouter -iterates over the configured Routers according to their configured priority:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    chain:
-        routers_by_id:
-            # enable the DynamicRouter with high priority to allow overwriting
-            # configured routes with content
-            symfony_cmf_routing_extra.dynamic_router: 200
-
-            # activa el enrutador predefinido de symfony con
-            # baja prioridad
-            router.default: 100
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-routing-extra:config>
-    <symfony-cmf-routing-extra:chain>
-        <symfony-cmf-routing-extra:routers-by-id
-            id="symfony-cmf-routing-extra.dynamic-router">
-            200
-        </symfony-cmf-routing-extra:routers-by-id>
-
-        <symfony-cmf-routing-extra:routers-by-id
-            id="router.default">
-            100
-        </symfony-cmf-routing-extra:routers-by-id>
-    </symfony-cmf-routing-extra:chain>
-</symfony-cmf-routing-extra:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_routing_extra', array(
-    'chain' => array(
-        'routers_by_id' => array(
-            'symfony_cmf_routing_extra.dynamic_router' => 200,
-            'router.default'                           => 100,
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            You can also load Routers using tagged services, by using the router tag -and an optional priority. Mientras más alta prioridad, más temprano será consultado tu enrutador para emparejar la ruta. Si no especificas la prioridad, tu enrutador vendrá al último. Si hay varios enrutadores con la misma prioridad, el orden entre ellos es indeterminado. El servicio etiquetado se verá como este:

            -
            -
              -
            • YAML
              services:
-    my_namespace.my_router:
-        class: "%my_namespace.my_router_class%"
-        tags:
-                - { name: router, priority: 300 }
-
              -
              -
              • -
            • XML
              <service id="my_namespace.my_router" class="%my_namespace.my_router_class%">
-    <tag name="router" priority="300" />
-    <!-- ... -->
-</service>
-
              -
              -
              • -
            • PHP
              $container
-    ->register('my_namespace.my_router', '%my_namespace.my_router_class%')
-    ->addTag('router', array('priority' => 300))
-;
-
              -
              -
              • -
            -
            -

            El sistema de enrutado del CMF de Symfony añade un nuevo DynamicRouter, el cual complementa el Router predefinido de Symfony2.

            -
            -
            -

            The Default Symfony2 Router

            -

            A pesar de que reemplaza el mecanismo de enrutado predefinido, el Routing del CMF de Symfony te permite seguir utilizando el sistema existente. De hecho, el enrutado predefinido está habilitado por omisión, así que puedes seguir utilizando las rutas que declaraste en tus archivos de configuración, o como fueron declaradas por otros paquetes.

            -
            -
            -

            El DynamicRouter

            -

            Este enrutador puede cargar instancias de Ruta dinámicamente desde un determinado proveedor. Luego usa un proceso para emparejar la petición entrante a una Ruta específica, la cual en turno suele determinar a qué Controlador enviar la petición.

            -

            La configuración predefinida del paquete declara que el DynamicRouter está inhabilitado -por omisión. Para activarlo, sólo añade lo siguiente a tu archivo de configuración:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        enabled: true
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-routing-extra:config>
-    <symfony-cmf-routing-extra:dynamic enabled="true" />
-</symfony-cmf-routing-extra:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_routing_extra', array(
-    'dynamic' => array(
-        'enabled' => true,
-    ),
-));
-
              -
              -
              • -
            -
            -

            Esta es la configuración mínima requirida para cargar el DynamicRouter como servicio, esta lo capacita para realizar cualquier enrutamiento. De hecho, cuándo exploras las páginas predefinidas que vienen con la EE del CMF de Symfony, el DynamicRouter es el que empareja tus peticiones con los Controladores y Plantillas.

            -
            -

            Getting the Route Object

            -

            Puedes configurar el proveedor a usar para adaptarlo a las necesidades de cada implementación, este debe implementar la RouteProviderInterface. Como parte de este paquete, se proporciona una implementación para el PHPCR-ODM, pero fácilmente puedes crear una propia, puesto que el Enrutador es de almacenamiento agnóstico. El proveedor predefinido carga la ruta como el camino en la petición y todas las rutas padre permiten que algunos segmentos de la ruta sean parámetros.

            -

            Para información más detallada sobre esta implementación y cómo la puedes personalizar o extender, consulta el RoutingExtraBundle.

            -

            El DynamicRouter es capaz de emparejar la petición entrante con un objeto Ruta del proveedor subyacente. Los detalles sobre cómo se lleva a cabo el proceso de emparejamiento se pueden encontrar en Enrutando.

            -
            -

            Nota

            -

            Para hacer que el proveedor de rutas encuentre rutas, también necesitas proporcionar los datos en tu almacenamiento. Con PHPCR-ODM, esto se hace a través de la interfaz de admininistración (ve más adelante) o con accesorios.

            -

            No obstante, antes de poder explicar cómo hacerlo, necesitas entender cómo trabaja el DynamicRouter. An example will come later in this document.

            -
            -
            -
            -

            Consiguiendo el controlador y la plantilla

            -

            Una Ruta necesita especificar cuál Controlador debería manejar una Petición específica. -El DynamicRouter utiliza uno de varios métodos posibles para determinarlo (por orden de precedencia):

            -
              -
            • Explicito: The stored Route document itself can explicitly declare the target -Controller by specifying the ‘_controller’ value in getRouteDefaults().
              • -
            • Por alias: the Route returns a ‘type’ value in getRouteDefaults(), -which is then matched against the provided configuration from config.yml
              • -
            • By class: requires the Route instance to implement RouteObjectInterface -and return an object for getRouteContent(). The returned class type is -then matched against the provided configuration from config.yml.
              • -
            • Predefinido: Si está configurado, utilizará un controlador predefinido.
              • -
            -

            Apart from this, the DynamicRouter is also capable of dynamically specifying -which Template will be used, in a similar way to the one used to determine -the Controller (in order of precedence):

            -
              -
            • Explicito: The stored Route document itself can explicitly declare the target -Template in getRouteDefaults().
              • -
            • Por clase: requires the Route instance to implement RouteObjectInterface -and return an object for getRouteContent(). The returned class type is -then matched against the provided configuration from config.yml.
              • -
            -

            Aquí tienes un ejemplo sobre cómo configurar las opciones mencionadas anteriormente:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        generic_controller: symfony_cmf_content.controller:indexAction
-        controllers_by_type:
-            editablestatic: sandbox_main.controller:indexAction
-        controllers_by_class:
-            Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: symfony_cmf_content.controller::indexAction
-        templates_by_class:
-            Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: SymfonyCmfContentBundle:StaticContent:index.html.twig
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-routing-extra:config>
-    <symfony-cmf-routing-extra:dynamic
-        generic-controller="symfony_cmf_content.controllerindexAction"
-    >
-        <symfony-cmf-routing-extra:controllers-by-type
-            type="editablestatic"
-        >
-            sandbox_main.controller:indexAction
-        </symfony-cmf-routing-extra:controllers-by-type>
-
-        <symfony-cmf-routing-extra:controllers-by-class
-            class="Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent"
-        >
-            symfony_cmf_content.controller::indexAction
-        </symfony-cmf-routing-extra:controllers-by-class>
-
-        <symfony-cmf-routing-extra:templates-by-class
-            alias="Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent"
-        >
-            SymfonyCmfContentBundle:StaticContent:index.html.twig
-        </symfony-cmf-routing-extra:templates-by-class>
-    </symfony-cmf-routing-extra:dynamic>
-</symfony-cmf-routing-extra:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_routing_extra', array(
-    'dynamic' => array(
-        'generic_controller' => 'symfony_cmf_content.controller:indexAction',
-        'controllers_by_type' => array(
-            'editablestatic' => 'sandbox_main.controller:indexAction',
-        ),
-        'controllers_by_class' => array(
-            'Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent' => 'symfony_cmf_content.controller::indexAction',
-        ),
-        'templates_by_class' => array(
-            'Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent' => 'SymfonyCmfContentBundle:StaticContent:index.html.twig',
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            Ten en cuenta que enabled: true ya no está presente. It’s only required if -no other configuration parameter is provided. The router is automatically -enabled as soon as you add any other configuration to the dynamic entry.

            -
            -

            Nota

            -

            Internamente, el componente Routing asocia estas opciones de configuración a varias instancias de la RouteEnhancerInterface. El alcance real de estos potenciadores es mucho mayor, y puedes encontrar más información sobre ellos en la página Enrutando de la documentación.

            -
            -
            -
            -
            -

            Linking a Route with a Model Instance

            -

            Dependiendo de la lógica de tu aplicación, una URL solicitada puede tener una instancia -del modelo asociado en la base de datos. Estas Rutas pueden implementar la RouteObjectInterface, y opcionalmente regresar una instancia del modelo, esta automáticamente será pasada al Controlador como la variable $contentDocument, si la declaras como parámetro.

            -

            Ten en cuenta que una Ruta puede implementar la interfaz mencionada anteriormente pero todavía no regresar ninguna instancia del modelo, en cuyo caso ningún objeto asociado será proporcionado.

            -

            Además, las Rutas que implementen esta interfaz también pueden tener un nombre de Ruta personalizado, en vez del predefinido compatible con el núcleo de Symfony, y pueden contener -cualquier carácter. Esto te permite, por ejemplo, poner una ruta como el nombre de la ruta.

            -
            -
            -

            Redirecciones

            -

            Puedes construir redirecciones implementando la RedirectRouteInterface. -Si estás utilizando el proveedor de ruta PHPCR-ODM predefinido, uno listo para usar la implementación es proporcionado en el Documento RedirectRoute. Este puede redirigir o bien a una URI absoluta, a una Ruta nombrada que puede generar cualquier Enrutador en la cadena o a otro objeto Ruta conocido por el proveedor de rutas. La redirección real es manejada por un Controlador específico, el cual puedes configurar como gustes:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    controllers_by_class:
-        Symfony\Cmf\Component\Routing\RedirectRouteInterface:  symfony_cmf_routing_extra.redirect_controller:redirectAction
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-routing-extra:config>
-    <symfony-cmf-routing-extra:controllers-by-class
-        class="Symfony\Cmf\Component\Routing\RedirectRouteInterface">
-        symfony_cmf_routing_extra.redirect_controller:redirectAction
-    </symfony-cmf-routing-extra:controllers-by-class>
-</symfony-cmf-routing-extra:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_routing_extra', array(
-    'controllers_by_class' => array(
-        'Symfony\Cmf\Component\Routing\RedirectRouteInterface' => 'symfony_cmf_routing_extra.redirect_controller:redirectAction',
-    ),
-));
-
              -
              -
              • -
            -
            -
            -

            Nota

            -

            The actual configuration for this association exists as a service, not as part of -a config.yml file. Como se explicó antes, puedes utilizar cualquier enfoque.

            -
            -
            -
            -

            URL Generation

            -

            El componente de enrutado del CMF de Symfony utiliza los componentes predefinidos de Symfony2 para manejar la generación de rutas, así que puedes utilizar los métodos predefinidos para generar tus url, con unas cuantas posibilidades añadidas:

            -
              -
            • Pass either an implementation of RouteObjectInterface or a -RouteAwareInterface as name parameter
              • -
            • Or supply an implementation of ContentRepositoryInterface and the id of -the model instance as parameter content_id
              • -
            -

            The route generation handles locales as well, see ContentAwareGenerator y regiones.

            -
            -
            -

            The PHPCR-ODM Route Document

            -

            Como se mencionó arriba, puedes utilizar cualquier proveedor de rutas. El ejemplo en esta sección aplica si utilizas el proveedor de rutas PHPCR-ODM predefinido.

            -

            Todas las rutas están localizadas bajo una ruta configurada como la raíz, por ejemplo '/cms/rutas'. -A new route can be created in PHP code as follows:

            -
            use Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route;
-
-$route = new Route;
-$route->setParent($dm->find(null, '/routes'));
-$route->setName('projects');
-
-// enlaza un contenido a la ruta
-$content = new Content('my content');
-$route->setRouteContent($content);
-
-// ahora configura algún parámetro, no olvides la barra inclinada inicial si
-// quieres /proyectos/{id} y no /proyectos{id}
-$route->setVariablePattern('/{id}');
-$route->setRequirement('id', '\d+');
-$route->setDefault('id', 1);
-
            -
            -

            This will give you a document that matches the URL /projects/<number> but -also /projects as there is a default for the id parameter.

            -

            Your controller can expect the $id parameter as well as the -$contentDocument as we set a content on the route. The content could be -used to define an intro section that is the same for each project or other -shared data. If you don’t need content, you can just not set it in the -document.

            -

            For more details, see the route document section in the RoutingExtraBundle documentation.

            -
            -
            -

            Integrando con SonataAdmin

            -

            Si en la sección require del archivo composer.json añades el sonata-project/doctrine-phpcr-admin-bundle, los documentos de ruta serán expuestos en el SonataDoctrinePhpcrAdminBundle. -Para instrucciones sobre cómo configurar este paquete ve SonataDoctrinePhpcrAdminBundle.

            -

            De manera predefinida, use_sonata_admin se pone automáticamente basándose en si SonataDoctrinePhpcrAdminBundle está disponible pero lo puedes desactivar explícitamente si no tienes habilitado sonata, o activarlo explícitamente para conseguir un error si sonata se vuelve inasequible.

            -

            Tienes un par de opciones de configuración para la administración. El content_basepath apunta a la raíz de tus documentos de contenido.

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_routing_extra:
-    use_sonata_admin: auto # usa true/false para forzar el uso / no uso de
-                           # la administración de sonata
-    content_basepath: ~ # usado con la administración de sonata para
-                        # manejar el contenido, por omisión a
-                        # symfony_cmf_core.content_basepath
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-routing-extra:config
-    use-sonata-admin="auto"
-    content-basepath="null"
-/>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_routing_extra', array(
-    'use_sonata_admin' => 'auto',
-    'content_basepath' => null,
-));
-
              -
              -
              • -
            -
            -
            -
            -

            Términos del tipo Form

            -

            El paquete define un tipo form que puedes utilizar para la clásica casilla de verificación «aceptar términos» donde colocas las url en la etiqueta. Simply specify -symfony_cmf_routing_extra_terms_form_type as the form type name and specify -a label and an array with content_ids in the options:

            -
            $form->add('terms', 'symfony_cmf_routing_extra_terms_form_type', array(
-    'label' => 'I have seen the <a href="%team%">Team</a> and <a href="%more%">More</a> pages ...',
-    'content_ids' => array(
-        '%team%' => '/cms/content/static/team',
-        '%more%' => '/cms/content/static/more'
-    ),
-));
-
            -
            -

            El tipo form automáticamente genera las rutas para el contenido especificado y pasa las rutas al ayudante trans de Twig para sustituirlas en la etiqueta.

            -
            -
            -

            Further Notes

            -

            Para más información sobre el componente Routing del CMF de Symfony, por favor, consulta:

            - -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/getting-started/simplecms.html b/cmf/getting-started/simplecms.html deleted file mode 100644 index bce16f6..0000000 --- a/cmf/getting-started/simplecms.html +++ /dev/null @@ -1,484 +0,0 @@ - - - - - - - SimpleCMS — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
            -
            -
            -
            - -
            -

            SimpleCMS

            -
            -

            Concepto

            -

            In the previous documentation pages all the basic components of Symfony CMF -have been analysed: the Enrutando that allows you to associate URLs -with your Contenido, which users can browse using a Menú.

            -

            These three components complement each other but are independent: they work -without each other, allowing you to choose which ones you want to use, extend -or ignore. In some cases, however, you might just want a simple implementation -that gathers all those functionalities in a ready-to-go package. For that -purpose, the SimpleCMSBundle was created.

            -
            -
            -

            SimpleCMSBundle

            -

            SimpleCMSBundle is implemented on top of most of the other Symfony CMF -Bundles, combining them into a functional CMS. It’s a simple solution, but -you will find it very useful when you start implementing your own CMS using -Symfony CMF. Whether you decide to extend or replace it, it’s up to you, -but in both cases, it’s a good place to start developing your first CMS.

            -
            -

            Page

            -

            SimpleCMSBundle basic content type is Page. Its class declaration -points out many of the features available:

            -
              -
            • -
              It extends Route, meaning it’s not only a Content instance, but
              -

              also a Route. In this case, as declared in getRouteContent(), the -Route as an associated content, itself.

              -
              -
              -
              • -
            • -
              It implements RouteAwareInterface, which means it has associated Route
              -

              instances. As expected, and as seen in getRoutes(), it has only one Route -associated: itself.

              -
              -
              -
              • -
            • -
              It implements NodeInterface, which means it can be used by MenuBundle
              -

              to generate a menu structure.

              -
              -
              -
              • -
            -

            The class itself is similar to the StaticContent already described in -the documentation page regarding Contenido, although some key atributes, -like parent or path come from the Route class it extends.

            -
            -
            -

            Three-in-one

            -

            Like explained before, this bundle gathers functionality from three distinct -bundles: Contenido, Enrutando and Menú. The routing component -receives a request, that it matches to a Route instance loaded from database. -That Route points to a Content instance: itself. A controller is -also determined by the routing component, that renders the Content using -a template which, in turn, presents the user with a HTML visualization of -the stored information tree structure, rendered using MenuItem obtained -from equivalent NodeInterface instances.

            -

            SimpleCMSBundle simplifies this process: Content, Route and NodeInterface -are gathered in one class: Page. This three-in-one approach is the key -concept behind this bundle.

            -
            -
            -

            MultilangPage

            -

            Like you would expect, a multilanguage version of Page is also included. -MultilangPage defines a locale variable and which fields will be -translated (title, label and body). It also includes getStaticPrefix() -to handle the path prefix of the Page. This is part of the route handling -mechanism, and will be analysed bellow.

            -
            -

            The MultilangPage uses the attribute strategy for translation: the -several translations coexist in the same database entry, and the several -translated versions of each field are stored as different attributes in -that same entry.

            -

            As the routing is not separated from the content, it is not possible to -create different routes for different languages. This is one of the biggest -disadvantages of the SimpleCmsBundle.

            -
            -
            -

            Configuring the Content Class

            -

            By default, SimpleCMSBundle will use Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page -as the content class if multilanguage is not enabled (default). If no other -class is chosen, and multilanguage support is enabled, it will automatically -switch to Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangPage. -You can explicitly specify your content class and/or enable multilanguage -support using the configuration parameters:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_simple_cms:
-    document_class: ~  # Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page
-    multilang:
-        locales: ~  # defaults to [], declare your locales here to enable multilanguage
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-simple-cms:config
-    document-class="null"
->
-    <symfony-cmf-simple-cms:multilang>
-        <symfony-cmf-simple-cms:locales></symfony-cmf-simple-cms:locales>
-    </symfony-cmf-simple-cms:multilang>
-</symfony-cmf-simple-cms:config>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_simple_cms', array(
-    'document_class' => null,
-    'multilang'      => array(
-        'locales' => null,
-    ),
-));
-
              -
              -
              • -
            -
            -
            -
            -
            -
            -

            SimpleCMSBundle in Detail

            -

            Now that you understand what SimpleCMSBundle does, we’ll detail how it -does it. Several other components are part of this bundle, that change the -default behaviour of its dependencies.

            -
            -

            The Routing

            -

            SimpleCMSBundle doesn’t add much functionality to the routing part of -Symfony CMF. Instead, it greatly relies on RoutingExtraBundle and its -set of configurable functionalities to meet its requirements. It declares -an independent DynamicRouter, with it’s own specific RouteProvider, -NestedMatcher, Enhancers set and other useful services, all of them instances -of the classes bundled with RoutingBundle and RoutingExtraBudle. -This service declaration duplication allows you to reuse the original RoutingExtraBundle -configuration options to declare another Router, if you wish to do so.

            -

            The only exception to this is RouteProvider: the SimpleCMSBundle -has its own strategy to retrieve Route instances from database. This -is related with the way Route instances are stored in database by RoutingExtraBundle. -By default, the path parameter will hold the prefixed full URI, including -the locale identifier. This would mean an independent Route instance -should exist for each translation of the same Content. However, as we’ve -seen, MultilangPage```stores all translations in the same entry. So, to -avoid duplication, the locale prefix is stripped from the URI prior to persistance, -and ``SimpleCMSBundle includes MultilangRouteProvider, which is responsible -for fetching Route instances taking that into account.

            -

            When rendering the actual URL from Route, the locale prefix needs to be -put back, otherwise the resulting addresses wouldn’t specify the locale they -refer to. To do so, MultilangPage uses the already mentioned getStaticPrefix() -implementation.

            -

            Exemplifying: An incoming request for contact would be prefixed with -/cms/simple basepath, and the storage would be queried for /cms/simple/contact/. -However, in a multilanguage setup, the locale is prefixed to the URI, resulting -in a query either for /cms/simple/en/contact/ or /cms/simple/de/contact/, -which would require two independent entries to exist for the same actual -content. With the above mentioned approach, the locale is stripped from -the URI prior to basepath prepending, resulting in a query for /cms/simple/contact/ -in both cases.

            -
            -

            Routes and Redirections

            -

            SimpleCMSBundle includes MultilangRoute and MultilangRedirectRoute, -extensions to the Route and RedirectRoute found in RoutingExtraBudle, -but with the necessary changes to handle the prefix strategy discussed earlier.

            -
            -
            -
            -

            Content Handling

            -

            Route instances are responsible for determining which Controller -will handle the current request. Consiguiendo el controlador y la plantilla -shows how Symfony CMF SE can determine which Controller to use when rendering -a certain content, and SimpleCMSBundle uses these mechanisms to do so.

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_simple_cms:
-    generic_controller: ~  # symfony_cmf_content.controller:indexAction
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-simple-cms:config
-    generic-controller="null"
-/>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_simple_cms', array(
-    'generic_controller' => null,
-));
-
              -
              -
              • -
            -
            -

            By default, it uses the above mentioned service, which instanciates ContentController -from ContentBundle. The default configuration associates all document_class -instances with this Controller, and specifies no default template. However, -you can configure several controllers_by_class and templates_by_class -rules, which will associate, respectively, Controller and templates to -a specific Content type. Symfony CMF SE includes an example of both in its -default configuration.

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_simple_cms:
-    routing:
-        templates_by_class:
-            Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page:  SymfonyCmfSimpleCmsBundle:Page:index.html.twig
-        controllers_by_class:
-            Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute:  symfony_cmf_routing_extra.redirect_controller:redirectAction
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-simple-cms:config>
-    <symfony-cmf-simple-cms:routing>
-        <symfony-cmf-simple-cms:templates-by-class
-            alias="Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page">
-            SymfonyCmfSimpleCmsBundle:Page:index.html.twig
-        </symfony-cmf-simple-cms:templates-by-class
-
-        <symfony-cmf-simple-cms:controllers-by-class
-            alias="Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute">
-            symfony_cmf_routing_extra.redirect_controller:redirectAction
-        </symfony-cmf-simple-cms:templates-by-class
-    </symfony-cmf-simple-cms:routing>
-</symfony-cmf-simple-cms:config>
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_simple_cms', array(
-    'routing' => array(
-        'templates_by_class' => array(
-            'Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page'             => SymfonyCmfSimpleCmsBundle:Page:index.html.twig,
-            'Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute' => 'symfony_cmf_routing_extra.redirect_controller:redirectAction',
-        ),
-    ),
-));
-
              -
              -
              • -
            -
            -

            These configuration parameters will be used to instantiate Route Enhancers. -More information about them can be found in the Enrutando -component documentation page.

            -

            These specific example determines that content instances of class Page -will be rendered using the above mentioned template, if no other is explicitly -provided by the associated Route (which, in this case, is Page itself). -It also states that all contents that instantiate RedirectRoute will -be rendered using the mentioned Controller instead of the default. Again, -the actual Route can provided a controller, in will take priority over -this one. Both the template and the controller are part of SimpleCMSBundle.

            -
            - -
            -
            -

            Admin Support

            -

            SimpleCMSBundle also includes the administration panel and respective -service needed for integration with SonataDoctrinePHPCRAdminBundle, -a backoffice generation tool that can be installed with Symfony CMF. Para más información sobre esta, por favor consulta la sección de documentación del paquete.

            -

            Las interfaces de administración incluidas serán cargadas automáticamente si instalas el SonataDoctrinePHPCRAdminBundle (consulta Creando un CMS con CMF y Sonata para instrucciones sobre cómo hacerlo). You can change this behaviour with the -following configuration option:

            -
            -
              -
            • YAML
              # app/config/config.yml
-symfony_cmf_simple_cms:
-    use_sonata_admin: ~  # defaults to auto , true/false can be used to using / not using SonataAdmin
-
              -
              -
              • -
            • XML
              <!-- app/config/config.xml -->
-<symfony-cmf-simple-cms:config
-    use-sonata-admin="null"
-/>
-
              -
              -
              • -
            • PHP
              // app/config/config.php
-$container->loadFromExtension('symfony_cmf_simple_cms', array(
-    'use_sonata_admin' => null,
-));
-
              -
              -
              • -
            -
            -
            -
            -

            Fixtures

            -

            SimpleCMSBundle includes a support class for integration with DoctrineFixturesBundle, -aimed at making loading initial data easier. A working example is provided -in Symfony CMF SE, that illustrates how you can easily generate MultilangPage -and MultilangMenuNode instances from yml files.

            -
            -
            -

            Configurando

            -

            Este paquete se configura usando un conjunto de parámetros, pero todos ellos son opcionales. You can go to the SimpleCmsBundle reference page for the -full configuration options list and aditional information.

            -
            -
            -

            Further Notes

            -

            For more information on the SimpleCMSBundle, please refer to:

            -
              -
            • SimpleCmsBundle for configuration reference and advanced details -about the bundle.
              • -
            • Enrutando for information about the routing component -in which SimpleCMSBundle is based on.
              • -
            • Contenido for information about the base content -bundle that SimpleCMSBundle depends on.
              • -
            • Menú for information about the menu system used -by SimpleCMSBundle.
              • -
            -
            -
            - - -
            -
            -
            -
            -
            - Bifúrcame en GitHub - -
            -
            -

            Navegación

            - -
            -
            - - -
            -
            - -
            - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
            -
            - - - - - \ No newline at end of file diff --git a/cmf/html/.buildinfo b/cmf/html/.buildinfo deleted file mode 100644 index e5e7a00..0000000 --- a/cmf/html/.buildinfo +++ /dev/null @@ -1,4 +0,0 @@ -# Sphinx build info version 1 -# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 91d01e1e12edbe8509ce7b99320f32c5 -tags: fbb0d17656682115ca4d033fb2f83ba1 diff --git a/cmf/html/_images/classdiagram.jpg b/cmf/html/_images/classdiagram.jpg deleted file mode 100644 index 8f0d017..0000000 Binary files a/cmf/html/_images/classdiagram.jpg and /dev/null differ diff --git a/cmf/html/_sources/bundles/block.txt b/cmf/html/_sources/bundles/block.txt deleted file mode 100644 index 318c472..0000000 --- a/cmf/html/_sources/bundles/block.txt +++ /dev/null @@ -1,93 +0,0 @@ -``BlockBundle`` -=============== - -El `BlockBundle `_ proporciona integración con ``SonataBlockBundle``. -Este te asiste gestionando fragmentos de contenido, conocidos como bloques. Lo que hace ``BlockBundle`` es similar a lo que hace *Twig*, pero para bloques almacenados en una *BD*. De esta manera, un editor puede modificar los bloques. -Además, el ``BlockBundle`` proporciona la lógica para determinar qué bloque se tendría que dibujar en cuáles páginas. - -El ``BlockBundle`` por sí mismo no proporciona una funcionalidad de edición para bloques. No obstante, puedes encontrar ejemplos de cómo hacer editables los bloques en el `recinto de seguridad del CMF de Symfony `_. - -.. index:: BlockBundle - -Dependencias ------------- - -Este paquete está basado en el `SonataBlockBundle `_ - - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_block`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_block: - document_manager_name: default - -Dibujando el bloque -------------------- - -Antes de que puedas dibujar un bloque, necesitas crear un objeto que represente los datos de tu bloque en el repositorio. -Lo puedes conseguir con el siguiente fragmento de código (ten en cuenta que ``$parentPage`` necesita ser una instancia de una página definida por el `ContentBundle `_): - -.. code-block:: php - - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($parentPage); - $myBlock->setName('sidebarBlock'); - $myBlock->setTitle('My first block'); - $myBlock->setContent('Hello block world!'); - - $documentManager->persist($myBlock); - -Ten en cuenta que el ``sidebarBlock`` es el identificador que escogimos para el bloque. Junto con el documento padre del bloque, esto hace único al bloque. Las otras propiedades son específicas a ``Simpleblock``. -Ahora para realmente dibujar este bloque, justo añade el siguiente código a tu plantilla de *Twig*: - -.. code-block:: jinja - - {{ sonata_block_render({'name': 'sidebarBlock'}) }} - -Esto hará que se dibuje el ``BlockBundle`` según el bloque en cada página que tenga un bloque llamado ``'sidebarBlock'``. Naturalmente, es necesario que la página real sea reproducida por la plantilla que contiene el fragmento anterior. - -Tipos de bloque ---------------- - -El ``BlockBundle`` viene con cuatro bloques de propósito general: - * SimpleBlock: Un bloque sencillo con nada más que un título y un campo de hipertexto. Este normalmente sería el que un editor modificaría directamente, por ejemplo, la información de contacto - * ``ContainerBlock``: Un bloque que contiene de ``0`` a ``n`` bloques descendientes - * ``ReferenceBlock``: Un bloque que hace referencia a un bloque almacenado en algún otro lugar en el árbol de contenido. Por ejemplo, podrías querer referir partes de la información de contacto desde la página inicial - * ``ActionBlock``: Un bloque que invoca acciones de *Symfony2*. «¿Por qué utilizar esto en vez de llamar a la acción directamente desde mi plantilla?», te podrías preguntar. Bien, imagina el siguiente caso: Provees un bloque que dibuja reflexiones de tus últimas noticias. Sin embargo, no hay ninguna regla de en dónde tendría que aparecer. En cambio, tu cliente quiere decidir en qué páginas sería mostrado este bloque. Proporcionando un ``ActionBlock`` acorde, tu cliente te permite hacerlo sin llamarle (¡una y otra vez!) para cambiar algunas plantillas. - -Crea tus propios bloques ------------------------- - -Digamos que estás trabajando en un proyecto donde tienes que integrar los datos recibidos de varios alimentadores ``RSS``. -Por supuesto podrías crear un ``ActionBlock`` para cada uno de estos alimentadores, ¿pero no es tonto esto? De hecho todas estas acciones se verían similares: Recibes los datos desde un alimentador, los saneas y pasas los datos a una plantilla. De este modo decides crear tu propio bloque, el ``RSSBlock``. - -Lo primero que necesitas es una entidad que contenga los datos. Es recomendable extender el contenido desde el ``BaseBlock`` de este paquete (aun así no es forzoso hacerlo, siempre y cuando implementes la ``Sonata\BlockBundle\Model\BlockInterface``). En tu entidad, añades dos propiedades, ``'feedURL'`` y ``'templateName'``, así como captadores y definidores para ellas. Además, necesitas definir el método ``getType`` que sólo regresa el ``'my_bundle.block.rss'``. - -La segunda cosa necesaria es un servicio que ``RSSBlocks`` sabe cómo manejar. En el caso del ``RSSBlock`` sería esto: Recuperar los datos desde dónde estén almacenados en ``'feedURL'``, sanearlos, y pasarlos a la plantilla almacenada en ``'templateName'``. De nuevo, puedes extender el ``Sonata\BlockBundle\Block\BaseBlockService``. -Es importante, denominar la propiedad ``'name'`` del servicio ``'my_bundle.block.rss'`` (Esto garantiza que se pueda encontrar la relación entre la entidad y el servicio). - -La última cosa que necesitas para definir el servicio es un archivo :file:`config`. Es importante etiquetar tu ``BlockService`` con ``'sonata.block'``, de lo contrario no lo reconocerá el paquete. - -Ejemplos --------- - -Puedes encontrar ejemplos de uso de este paquete en el `Recinto de seguridad del CMF de Symfony `_. -Dale un vistazo en el ``BlockBundle`` del recinto de seguridad. También te muestra cómo hacer editables los bloques usando el `CreateBundle `_. - -Relación al paquete ``Block`` ------------------------------ - -El ``BlockBundle`` está basado en el `SonataBlockBundle `_. -Este reemplaza componentes del paquete dónde sea necesario que sea compatible con *PHPCR*. - -La siguiente imagen muestra dónde utilizamos nuestros propios componentes (azules): - -.. image:: ../images/bundles/classdiagram.jpg - :align: center \ No newline at end of file diff --git a/cmf/html/_sources/bundles/content.txt b/cmf/html/_sources/bundles/content.txt deleted file mode 100644 index af01dca..0000000 --- a/cmf/html/_sources/bundles/content.txt +++ /dev/null @@ -1,31 +0,0 @@ -``ContentBundle`` -================= - -Este paquete proporciona un documento para contenido estático y el controlador para dibujarlo. - -Para más información ---por ahora--- ve la documentación del `ContentBundle `_ - -.. index:: ContentBundle - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_content`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_content: - admin_class: ~ - document_class: ~ - default_template: ~ - content_basepath: /cms/content - static_basepath: /cms/content/static - use_sonata_admin: auto - multilang: - admin_class: ~ - document_class: ~ - use_sonata_admin: auto - locales: [] diff --git a/cmf/html/_sources/bundles/core.txt b/cmf/html/_sources/bundles/core.txt deleted file mode 100644 index 9d20547..0000000 --- a/cmf/html/_sources/bundles/core.txt +++ /dev/null @@ -1,77 +0,0 @@ -``CoreBundle`` -============== - -Este es el `CoreBundle `_ para el ``CMF`` de *Symfony 2*. Este paquete proporciona funcionalidad común, ayudantes y utilidades para los otros paquetes del ``CMF``. - -Una de las características proporcionadas es una interfaz e implementación de un supervisor del flujo de trabajo para la publicación con una interfaz acompañante en la cual los modelos pueden implementar aquello que quieran apoyar con este supervisor. - -Además, proporciona un ayudante de *Twig* que expone varias funciones útiles para que las plantillas de *Twig* interaccinen con documentos *PHPCR-ODM*. - -.. index:: CoreBundle, PHPCR, ODM, publish workflow - -Configurando ------------- - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_core: - document_manager: default - role``: IS_AUTHENTICATED_ANONYMOUSLY # usado por el supervisor del - # flujo de trabajo - # para publicación - -Supervisor del flujo de trabajo para publicación ------------------------------------------------- - -El paquete proporciona un servicio ``symfony_cmf_core.publish_workflow_checker`` que implementa la ``PublishWorkflowCheckerInterface``. Esta interfaz define un solo método ``checkIsPublished()``. - -.. code-block:: php - - $publishWorkflowChecker = $container->get('symfony_cmf_core.publish_workflow_checker'); - $ignoreRole = false // si ignora el rol al momento de decidir si considera - // el documento como publicado - if ($publishWorkflowChecker->checkIsPublished($document, $ignoreRole)) { - .. - } - -Extensión *Twig* ----------------- - -Implementa las siguientes funciones: - -* ``cmf_find``: Encuentra el documento por medio de la ruta y clase proporcionadas -* ``cmf_is_published``: Comprueba si el documento proporcionado está publicado -* ``cmf_prev``: Devuelve el anterior documento publicado examinando los nodos hijos del padre proporcionado -* ``cmf_next``: Devuelve el siguiente documento publicado examinando los nodos hijos del padre proporcionado -* ``cmf_children``: Devuelve un arreglo con todos los documentos hijo de los documentos proporcionados que están publicados -* ``cmf_document_locales``: Obtiene las regiones del documento proporcionado - -.. code-block:: jinja - - {% set page = cmf_find('/alguna/ruta') %} - - {% if cmf_is_published(page) %} - {% set prev = cmf_prev(page) %} - {% if prev %} - prev - {% endif %} - - {% set next = cmf_next(page) %} - {% if next %} - next - {% endif %} - - {% for news in cmf_children(page)|reverse %} -
          • {{ news.title }} ({{ news.publishStartDate | date('Y-m-d') }})
            • - {% endfor %} - - {% if 'de' in cmf_document_locales(page) %} - DE - {% endif %} - {% if 'fr' in cmf_document_locales(page) %} - DE - {% endif %} - {% endif %} diff --git a/cmf/html/_sources/bundles/create.txt b/cmf/html/_sources/bundles/create.txt deleted file mode 100644 index 4a86391..0000000 --- a/cmf/html/_sources/bundles/create.txt +++ /dev/null @@ -1,291 +0,0 @@ -``CreateBundle`` -================ - -El `CreateBundle `_ integra a *Symfony 2* las bibliotecas ayudante :file:`create.js` y :file:`createphp`. - -:file:`create.js` es una comprensible interfaz de edición *web* para Sistemas de administración de contenido (*CMS*). Está diseñado para proporcionar un moderno gestor de contenido, totalmente basado en un entorno de navegadores HTML5. Creado para poder adaptarlo para trabajar en casi cualquier interfaz de administración de contenido. -Ve http://createjs.org/ - -``Createphp`` es una biblioteca *PHP* para ayudarte con anotaciones *RDF* en tus entidades/documentos. -Ve la documentación sobre como trabaja en https://github.com/flack/createphp. - -.. index:: CreateBundle - -Dependencias ------------- - -Este paquete incluye :file:`create.js` (el cuál empaca todas sus dependencias como *jquery*, *vie*, *hallo*, *backbone*, etc.) como submódulos *git*. No olvides añadir el guión del controlador de ``composer`` a tu archivo :file:`composer.json` como se describe abajo. - -Las dependencias de *PHP* son manejadas por medio de ``composer``. Utilizamos ``createphp`` así como ``AsseticBundle``, ``FOSRestBundle`` y por inferencia también ``JmsSerializerBundle``. Asegúrate de crear una instancia de todos estos paquetes en tu nucleo y de configurar correctamente el ``assetic``. - -Instalando ----------- - -Este paquete se incluye mejor utilizando ``Composer``. - -Edita el archivo ``composer`` de tu proyecto añadiendo un nuevo requisito para ``symfony-cmf/create-bundle``. -Luego, crea una sección de guiones o añádelo a una existente: - - -.. code-block:: yaml - - { - "scripts": { - "post-install-cmd": [ - "Symfony\\Cmf\\Bundle\\SymfonyCmfCreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ], - "post-update-cmd": [ - "Symfony\\Cmf\\Bundle\\SymfonyCmfCreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ] - } - } - - -Añade este paquete (y sus dependencias, si aún no están) al núcleo de tu aplicación: - -.. code-block:: php - - // application/ApplicationKernel.php - public function registerBundles() - { - return array( - // ... - new Symfony\Bundle\AsseticBundle\AsseticBundle(), - new JMS\SerializerBundle\JMSSerializerBundle($this), - new FOS\RestBundle\FOSRestBundle(), - new Symfony\Cmf\Bundle\SymfonyCmfCreateBundle\SymfonyCmfCreateBundle(), - // ... - ); - } - -También necesitas configurar el ``FOSRestBundle`` para manejar *json*: - - -.. code-block:: yaml - - fos_rest: - view: - formats: - json: true - -Concepto --------- - -``Createphp`` usa metadatos *RDF* sobre las clases de tu dominio, tal como *Doctrine* -sabe cómo se almacenan los metadatos de un objeto en la base de datos. Los metadatos son modelados por el tipo de la clase y pueden provenir de cualquier fuente. ``Createphp`` proporciona controladores de metadatos que leen *XML*, arreglos *PHP* y uno que justo introspecciona objetos y crea metadatos no semánticos que serán suficientes para editar con :file:`create.js`. - -El ``RdfMapper`` se usa para traducir entre tu capa de almacenamiento y ``createphp``. -Este es pasado al objeto ``dominio`` y al objeto metadatos pertinente. - -Con los metadatos y el ayudante de *Twig*, el contenido es dibujado con anotaciones *RDF*. :file:`create.js` es cargado y habilitado para editar las entidades. Guarda en la interfaz de administración las operaciones que ocurrieron en llamadas *ajax*. - -El controlador ``REST`` maneja esas llamadas *ajax*, y si quieres ser capaz de cargar imágenes, un controlador de imagen guarda las imágenes cargadas y devuelve la ubicación -de la imagen. - - -Configurando ------------- - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_create: - # cargando metadatos - - # Lista de directorios para buscar metadatos - rdf_config_dirs: - - "%kernel.root_dir%/Resources/rdf-mappings" - # busca asociaciones en /Resources/rdf-mappings - # auto_mapping: true - - # usa una clase diferente para el controlador REST - # rest_controller_class: FQN\Classname - # Habilita el modo de desarrollo 'hallo' (ve al final de este capítulo) - # use_coffee: false - - # manejo de imagen - imagen: - model_class: ~ - controller_class: ~ - - # rol para controlar el acceso para inclusión js, predefinido - # REST y controladores de imagen - # role: IS_AUTHENTICATED_ANONYMOUSLY - - # Habilita el asignador PHPCR-ODM de Doctrine - phpcr_odm: true - - # asociación de tipo rdf name => class nombre usado al añadir ítems a colecciones - map: - rdfname: FQN\Classname - - # url para mejora semántica stanbol, de lo contrario la - # predeterminada es la instalación del demo - # stanbol_url: http://dev.iks-project.eu:8081 - - # fija la barra de edición Hallo en lo alto de la página - # fixed_toolbar: true - - # los tipos RDF para elementos a modificar en texto plano - # plain_text_types: ['dcterms:title'] - -El archivo javascript proporcionado configura :file:`create.js` y el editor «hallo». Activa algunos complementos como el editor de etiquetas para revisar colecciones de -atributos ``skos:related``. Esperamos poder añadir algunas opciones de configuración para modificar la configuración de :file:`create.js` pero también puedes utilizar el archivo como una plantilla y hacer la propia si necesitas mayor personalización. - - -Metadatos -+++++++++ - -:file:`createphp` necesita información de metadatos para cada clase de tu modelo del dominio. Por omisión, ``crea paquete`` usa el controlador de metadatos *XML* y busca los metadatos en los paquetes habilitados en /Resources/rdf-mappings. Si utilizas un paquete que no tiene ninguna asignación ``RDF``, puedes especificar una lista de ``rdf_config_dirs`` que se analizará adicionalmente para buscar metadatos. - -Consulta la documentación de `createphp `_ para el formato de los metadatos *XML*. - - -Controlando el acceso -+++++++++++++++++++++ - -Si utilizas el controlador ``REST`` predefinido, todos pueden editar el contenido una vez activado el ``crea paquete``. Para restringir el acceso, especifica un rol para el paquete que no sea el predefinido -``IS_AUTHENTICATED_ANONYMOUSLY``. -Si especificas un rol diferente, :file:`create.js` sólo se cargará si el usuario tiene ese rol y el controlador ``REST`` (y el controlador de imagen si está habilitado) revisará el rol. - -Si necesitas un control de acceso más fino, busca en el método asignador ``isEditable``. -Puedes extender el asignador a utilizar y sustituir ``isEditable`` para que responda si el objeto dominio que se le pasa es editable. - - -Manejando imágenes -++++++++++++++++++ - -Activa el controlador de imágenes simplista con la configuración ``image > model_class | controller_class``. Este controlador de imagen sólo despacha imágenes existentes en el repositorio ``PHPCR-ODM`` y también las sirve en peticiones. - -Si necesitas un diferente tratamiento de imágenes, puedes sobrescribir ``image.model_class`` y/o ``image.controller_class``, o implementar un servicio personalizado con ``ImageController`` y sustituir el ``symfony_cmf_create.image.controller``. - - -Asignación de peticiones a objetos -++++++++++++++++++++++++++++++++++ - -Por ahora, el paquete sólo proporciona un servicio para asociar al *PHPCR-ODM* de *Doctrine*. Activado al establecer ``phpcr_odm`` en ``true``. Si necesitas algo más, debes proporcionar un servicio ``symfony_cmf_create.object_mapper``. (Si necesitas un contenedor para el *ORM* de *Doctrine*, mira los asignadores de la biblioteca ``createphp`` y haz una petición de extracción en la biblioteca, y otra para exponer el *ORM* como asignador del servicio en el ``crea paquete``). - -Además, ten en cuenta que ``createphp`` apoyaría diferentes asignadores para diferentes tipos de ``RDF``. -Si necesitas esto, escarva un poco en ``createphp`` y ``crea paquete`` y haz una petición de extracción para activar esa característica. - -Para poder crear nuevos objetos, es necesario proporcionar una asociación entre los tipos ``RDF`` y los nombres de clase. (Pendiente: ¿no podemos indexar todas las asignaciones y hacer esto automáticamente?) - - -Enrutando -+++++++++ - -Por último añade la ruta correspondiente a tu configuración: - -.. configuration-block:: - - .. code-block:: yaml - - create: - resource: "@SymfonyCmfCreateBundle/Resources/config/routing/rest.xml" - create_image: - resource: "@SymfonyCmfCreateBundle/Resources/config/routing/image.xml" - - .. code-block:: xml - - - - - -Alternativas: Editor ``Aloha`` -++++++++++++++++++++++++++++++ - -Opcional: El editor ``Aloha`` (:file:`create.js` viene con el editor ``hallo``, pero si lo prefieres, también puedes utilizar el ``aloha``) - - Para usar el editor ``Aloha``, descarga los archivos aqui: https://github.com/alohaeditor/Aloha-Editor/downloads/ - - Descomprime el contenido del subdirectorio «aloha» en el archivo «zip» como un directorio en ``vendor/symfony-cmf/create-bundle/Symfony/CMF/Bundle/CreateBundle/vendor/aloha`` - - Asegúrate de tener un sólo directorio ``aloha`` con el ``js``, no ``aloha/aloha/...`` ---debes tener ``vendor/symfony-cmf/create-bundle/Symfony/CMF/Bundle/CreateBundle/vendor/aloha/aloha.js`` - - -Usando ------- - -Ajusta tu plantilla para cargar los archivos ``js`` del editor si la sesión actual tiene permitido editar el contenido. - -.. code-block:: jinja - - {% render "symfony_cmf_create.jsloader.controller:includeJSFilesAction" %} - -Además, asegúrate de que ``assetic`` está reescribiendo rutas en tus archivos *css*, y luego incluye los archivos *css* base (y personalízalos con tu propio *css* cuando sea necesario) con: - -.. code-block:: jinja - - {% include "SymfonyCmfCreateBundle::includecssfiles.html.twig" %} - -La otra cosa que tienes que hacer es proporcionar asignación ``RDF`` para las clases de tu modelo y ajusta tus plantillas para reproducir con ``createphp`` a modo de que :file:`create.js` sepa cual contenido es editable. - -Crea la asignación de metadatos *XML* en ``/Resources/rdf-mappings/`` o una ruta -a tu ``rdf_config_dirs`` configurado después del nombre completamente cualificado de tus clases del modelo sustituyendo ``\\`` con un punto (``.``), es decir, :file:`Symfony.Cmf.Bundle.SimpleCmsBundle.Document.MultilangPage.xml`. -Para un ejemplo de asociación ve los archivos en el :file:`cmf-sandbox`. La documentación de referencia está en el `repositorio de la biblioteca createphp `_. - -Para dibujar tu modelo, usa la etiqueta ``createphp`` de *Twig*: - -.. code-block:: html+jinja - - {% createphp page as="rdf" %} - {{ rdf|raw }} - {% endcreatephp %} - -O si necesitas más control sobre el *HTML* generado: - -.. code-block:: html+jinja - - {% createphp page as="rdf" %} -
            -

            {{ createphp_content( rdf.title ) }}

            -
            {{ createphp_content( rdf.body ) }}
            -
            - {% endcreatephp %} - - -Desarrollando el editor ``wysiwyg`` ``hallo`` ---------------------------------------------- - -Puedes desarrollar el editor ``hallo`` dentro del ``Crea paquete``. De manera predefinida, se usa una versión minimizada del ``hallo`` empacada con ``Crea paquete``. Para desarrollar el código real, primero necesitas activar con ``checkout`` el repositorio ``hallo`` completo. Lo puedes hacer ejecutando la siguiente orden desde la línea de ordenes: - -.. code-block:: bash - - app/console cmf:create:init-hallo-devel - -Luego, ajusta la opción ``symfony_cmf_create > use_coffee`` a ``true`` en el archivo :file:`config.yml`. Esto le dice al ``jsloader`` que incluya los archivos del guión ``coffee`` desde ``Resources/public/vendor/hallo/src`` con ``assetic``, en lugar del *javascript* precompilado en :file:`Resources/public/vendor/create/deps/hallo-min.js`. -Esto también significa que necesitas añadir una asociación para ``coffeescript`` en tu -configuración de ``assetic`` y necesitas tener instalado y configurado correctamente el `compilador de coffee `_. - -.. configuration-block:: - - .. code-block:: yaml - - assetic: - filters: - cssrewrite: ~ - coffee: - bin: %coffee.bin% - node: %coffee.node% - apply_to: %coffee.extension% - - symfony_cmf_create: - # pónlo a true si quieres desarrollar hallo y editar los archivos de coffee - use_coffee: true|false - -En el recinto de seguridad del ``cmf`` hacemos una pequeña trampa para no provocar la compilación del guión de ``coffee``. -En el archivo :file:`config.yml` hacemos configurable la extensión de ``coffee``. Ahora si :file:`parameters.yml` pone ``coffee.extension`` a ``\.coffee`` el ``coffeescript`` es compilado y el compilador de ``coffee`` debe estar instalado. Si lo pusiste a cualquier otra cosa tal como ``\.nocoffee`` entonces no es necesario tener instalado el compilador de ``coffee``. - -Los valores predefinidos para los tres parámetros son: - -.. configuration-block:: - - .. code-block:: yaml - - coffee.bin: /usr/local/bin/coffee - coffee.node: /usr/local/bin/node - coffee.extension: \.coffee diff --git a/cmf/html/_sources/bundles/doctrine_phpcr_admin.txt b/cmf/html/_sources/bundles/doctrine_phpcr_admin.txt deleted file mode 100644 index 95ca6a1..0000000 --- a/cmf/html/_sources/bundles/doctrine_phpcr_admin.txt +++ /dev/null @@ -1,40 +0,0 @@ -``SonataDoctrinePhpcrAdminBundle`` -================================== - -El `SonataDoctrinePhpcrAdminBundle `_ proporciona integración con el ``SonataAdminBundle`` para habilitar fácilmente la creación de interfaces de usuario. - -.. index:: TreeBundle - -Dependencias ------------- - -* `SonataAdminBundle `_ -* `TreeBundle `_ - -Configurando ------------- - -.. configuration-block:: - - .. code-block:: yaml - - sonata_doctrine_phpcr_admin: - templates: - form: - - # Predefinido: - - SonataDoctrinePHPCRAdminBundle:Form:form_admin_fields.html.twig - filter: - - # Predefinido: - - SonataDoctrinePHPCRAdminBundle:Form:filter_admin_fields.html.twig - types: - list: - - # Prototipo - name: [] [] - document_tree: - # Prototipo - class: # nombre de la clase - valid_children: [] - image: \ No newline at end of file diff --git a/cmf/html/_sources/bundles/menu.txt b/cmf/html/_sources/bundles/menu.txt deleted file mode 100644 index 1ba741a..0000000 --- a/cmf/html/_sources/bundles/menu.txt +++ /dev/null @@ -1,92 +0,0 @@ -``MenuBundle`` -============== - -El `MenuBundle `_ -proporciona menús desde un gestor de objetos de *Doctrine* con la ayuda de ``KnpMenuBundle``. - -.. index:: MenuBundle - -Dependencias ------------- - -Este paquete se extiende del `KnpMenuBundle `_. - -A menos que cambies los predefinidos y proporciones tus propias implementaciones, este paquete también depende de: - -* ``SymfonyRoutingExtraBundle`` para el servicio de enrutado ``symfony_cmf_routing_extra.dynamic_router``. - Ten en cuenta que necesitas habilitar explícitamente el enrutador dinámico puesto que de manera predeterminada no se carga. - Ve la :doc:`documentación del paquete routing extra ` para saber cómo hacer esto. -* :doc:`PHPCR-ODM ` para cargar documentos de ruta desde el contenido del repositorio - -Configurando ------------- - -Si quieres utilizar las configuraciones predefinidas, no debes cambiar nada. -Los valores son: - -.. configuration-block:: - - .. code-block:: yaml - - symfony_cmf_menu: - menu_basepath: /cms/menu - document_manager_name: default - admin_class: ~ - document_class: ~ - content_url_generator: router - content_key: ~ # (resuelve a DynamicRouter::CONTENT_KEY) - route_name: ~ # las rutas cmf son creadas por el contenido en lugar del nombre - content_basepath: ~ # por omisión a symfony_cmf_core.content_basepath - use_sonata_admin: auto # usa true/false para forzar si usar / no usar - # la administración de sonata - multilang: - use_sonata_admin: auto # usa true/false para forzar el usar / no usar - # la administración de sonata - admin_class: ~ - document_class: ~ - locales: [] - -Si quieres dibujar el menú desde *Twig*, asegúrate de no desactivar *Twig* en la sección de configuración ``knp_menu``. - -Si añades ``sonata-project/doctrine-phpcr-admin-bundle`` a la sección de requisitos del archivo :file:`composer.json`, los documentos del menú son expuestos en el ``SonataDoctrinePhpcrAdminBundle``. -Para instrucciones sobre cómo configurar este paquete ve :doc:`doctrine_phpcr_admin`. - -De manera predeterminada, ``use_sonata_admin`` se configura automáticamente basándose en si ``SonataDoctrinePhpcrAdminBundle`` está disponible, pero lo puedes desactivar explícitamente al incluirlo si ``sonata`` está habilitado, o habilitarlo explícitamente para obtener un error si se desactiva ``sonata``. - - -Entradas del menú ------------------ - -``Document\MenuItem`` definen entradas del menú. Puedes construir elementos del menú basándote en las rutas de *Symfony*, *url* absolutas o relativas o refiriendo documentos de contenido *PHPCR-ODM*. - -El árbol del menú se construye desde los documentos bajo ``[menu_basepath]/[menuname]``. Puedes utilizar diferentes clases de documento para elementos del menú, siempre y cuando implementen la ``Knp\Menu\NodeInterface`` para integrarse con ``KnpMenuBundle``. El documento ``MenuItem`` predefinido descarta hijos que no implementen esta interfaz. - -La entrada resaltada actualmente es determinada al comprobar si el contenido asociado con un documento menú es igual que el contenido del ``DynamicRouter`` puesto en la petición. - - -Usando ------- - -Ajusta tu plantilla *Twig* para cargar el menú. - -.. code-block:: jinja - - {{ knp_menu_render('simple') }} - -El nombre del menú es el nombre del nodo bajo ``menu_basepath``. Por ejemplo si tu repositorio almacena los nodos del menú bajo ``/cms/menu``, dibujar «principal» significaría dibujar el menú que está en ``/cms/menu/principal`` - - -Cómo usar otros componentes no predefinidos -------------------------------------------- - -Si utilizas el menú del ``cmf`` con *PHPCR-ODM*, solo necesitas almacenar documentos de Ruta bajo ``menu_basepath``. Si utilizas un diferente gestor de objetos, debes asegúrarte que el documento raíz del menú se encuentra con: - -.. code-block:: php - - $dm->find($menu_document_class, $menu_basepath . $menu_name) - -El documento de ruta tiene que implementar la ``Knp\Menu\NodeInterface`` --- ve el archivo :file:`Document/MenuItem.php` para un ejemplo. Probablemente también necesites especificar la clase ``menu_document_class``, puesto que *PHPCR-ODM* sólo puede determinar el documento a partir del contenido en la base de datos. - -Si utilizas el menú ``CMF`` con el ``DynamicRouter``, no necesitas ningún nombre de ruta como el documento de menú, sólo debes proporcionar un campo ``content_key`` en las opciones. -Si quieres utilizar un diferente servicio para generar las *URL*, te debes asegurar de que tus entradas del menú proporcionan información en tu ``content_key`` seleccionada que el generador de la *url* pueda utilizar para generar la *url*. Dependiendo de tu generador, también podrías necesitar especificar un ``route_name``. -Ten en cuenta que si solo quieres generar rutas *Symfony* normales con un menú que está en la base de datos, puedes pasar el servicio de enrutado al núcleo como el ``content_url_generator``, asegúrate que el ``content_key`` nunca coincida y haz que tus documentos de menú proporcionen el nombre de ruta y eventuales ``routeParameters``. \ No newline at end of file diff --git a/cmf/html/_sources/bundles/phpcr-odm.txt b/cmf/html/_sources/bundles/phpcr-odm.txt deleted file mode 100644 index 28eadfe..0000000 --- a/cmf/html/_sources/bundles/phpcr-odm.txt +++ /dev/null @@ -1,385 +0,0 @@ -``DoctrinePHPCRBundle`` -======================= - -El `DoctrinePHPCRBundle `_ proporciona integración con el repositorio de contenido *PHP* y opcionalmente con el *PHPCR-ODM* de *Doctrine* -para proporcionar el gestor de documentos *ODM* en *Symfony*. - -.. index:: DoctrinePHPCRBundle, PHPCR, ODM - -.. tip:: - - Esta referencia sólo explica la integración de *Symfony2* con *PHPCR* y *PHPCR-ODM*. Para aprender cómo utilizar *PHPCR* ve al `sitio web de PHPCR `_ y para la documentación del `PHPCR-ODM `_ de *Doctrine* . - - -Configurando ------------- - -Ve :doc:`../tutorials/installing-configuring-doctrine-phpcr-odm` - - -Configurando ------------- - -.. tip:: - - Si sólo quieres utilizar el *PHPCR* sencillo sin el *PHPCR-ODM*, sencillamente no configures la sección ``odm`` para evitar que cargue los servicios. Ten en cuenta que muchos paquetes del ``CMF`` de manera predefinida usan documentos *PHPCR-ODM*. - - - -Configurando la sesión *PHPCR* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La sesión necesita que especifiques una implementación *PHPCR* en la sección ``backend`` para el campo ``type``, junto con opciones de configuración al arranque de la implementación. Actualmente apoyamos *jackrabbit*, *doctrinedbal* y *midgard2*. -Independientemente de la interfaz de administración, cada sesión *PHPCR* necesita un espacio de trabajo, nombre de usuario y contraseña. - -.. tip:: - - Cada implementación de *PHPCR* tendría que proporcionar el espacio de trabajo predefinido, pero puedes escoger uno diferente. Existe la orden ``doctrine:phpcr:workspace:create`` para iniciar un nuevo espacio de trabajo. Ve también las :ref:`reference-phpcr-commands`. - -Este nombre de usuario y contraseña es el que se está usando en la capa *PHPCR* en -el ``PHPCR\SimpleCredentials``. Normalmente serán diferentes del nombre de usuario y contraseña utilizados por ``midgard`` o el *DBAL* de *Doctrine* para conectarse al *RDBMS* subyacente donde de hecho se almacenó el dato. - -Si estás utilizando una de las interfaces de administración de ``Jackalope``, también puedes especificar ``opciones``. -Estas serán puestas en la sesión de ``Jackalope``. Actualmente esto se puede ajustar a nodos prerecuperados poniendo ``jackalope.fetch_depth`` a algo más grande que 0. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - # ve abajo cómo configurar la interfaz de administración que elejiste - workspace: default - username: admin - password: admin - # opciones: - # key: valor - - -Sesión *PHPCR* con ``Jackalope Jackrabbit`` -""""""""""""""""""""""""""""""""""""""""""" - -Es la única configuración requerida para instalar el ``Jackrabbit`` de apache (ve :ref:`instalando Jackrabbit `). - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: jackrabbit - url: http://localhost:8080/server/ - -.. _reference-phpcr-doctrinedbal: - -Sesión *PHPCR* con el ``Jackalope`` y *DBAL* de *Doctrine* -"""""""""""""""""""""""""""""""""""""""""""""""""""""""""" - -Este tipo usa ``Jackalope`` con una abstracción en la capa de transporte de base de datos de *Doctrine* para proporcionar *PHPCR* sin ningún requisito de instalación más allá de cualquiera de los *RDBMS* apoyados por *Doctrine*. - -Necesitas configurar una conexión de *Doctrine* según el *DBAL* elejido en -la `documentación de Doctrine en Symfony2 `_. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - -Una vez configurada la conexión, puedes crear la base de datos y *debes* iniciar la base de datos con la orden ``doctrine:phpcr:init:dbal``. - -.. code-block:: bash - - app/console doctrine:database:create - app/console doctrine:phpcr:init:dbal - -.. tip:: - - Naturalmente, también puedes utilizar una diferente conexión en vez de la predefinida. - Es recomendable utilizar una conexión independiente para una base de datos separada si también *Doctrine* usa el acceso a datos del *ORM* o *DBAL* directamente, en lugar de mezclar este dato con las tablas generadas por ``jackalope-doctrine-dbal``. - Si tienes una conexión separada, necesitas pasar el nombre de la conexión alterna a la orden ``doctrine:database:create`` con la opción ``--connection``. Para las ordenes *PHPCR* de *Doctrine*, este parámetro no es necesario al configurar la conexión a utilizar. - - -Sesión *PHPCR* con ``Midgard2`` -""""""""""""""""""""""""""""""" - -``Midgard2`` es una aplicación que proporciona una extensión *PHP* compilada. Esta implementa la *API* de *PHPCR* en lo alto de un *RDBMS* estándar. - -Para instalación, significado exacto y valores soportados en las opciones -de configuración, ve la `documentación oficial de Midgard con PHPCR `_ - - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: midgard2 - db_type: MySQL - db_name: midgard2_test - db_host: "0.0.0.0" - db_port: 3306 - db_username: "" - db_password: "" - db_init: true - blobdir: /tmp/cmf-blobs - - -Configurando el *PHPCR-ODM* de *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Esta sección de configuración gestiona el sistema *PHPCR-ODM* de *Doctrine*. Si no configuras ninguna cosa aquí, los servicios *ODM* no serán cargados. - -Si habilitas el ``auto_mapping``, puedes colocar tus asociaciones en ``/Resources/config/doctrine/.phpcr.xml`` ``resp. .yml`` para configurar las asociaciones a documentos proporcionadas en el directorio ``/Document``. De lo contrario necesitas configurar manualmente la sección de asignaciones. - -Si ``auto_generate_proxy_classes`` es ``false``, necesitas ejecutar la orden ``cache:warmup`` -para tener las clases delegadas generadas después de que modificaste un documento. También puedes ajustar cómo y dónde generar las clases delegadas con las opciones ``proxy_dir`` y ``proxy_namespace``. Normalmente las predefinidas están bien aquí. - -También puedes habilitar el `almacenamiento de metadatos en caché `_. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - odm: - configuration_id: ~ - auto_mapping: true - mappings: - : - mapping: true - type: ~ - dir: ~ - alias: ~ - prefix: ~ - is_bundle: ~ - auto_generate_proxy_classes: %kernel.debug% - proxy_dir: %kernel.cache_dir%/doctrine/PHPCRProxies - proxy_namespace: PHPCRProxies - - metadata_cache_driver: - type: array - host: ~ - port: ~ - instance_class: ~ - class: ~ - id: ~ - - - -Configuración de traducción -""""""""""""""""""""""""""" - -.. index:: I18N, Multilanguage - -Si estás utilizando documentos multilingües, necesitas configurar los idiomas disponibles. Para más información en documentos multilingües, ve la `documentación PHPCR-ODM en multilenguaje `_. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - odm: - locales: - en: [de, fr] - de: [en, fr] - fr: [en, de] - -Este bloque define el orden de regiones alternativas para ver si un documento no está traducido al idioma requerido. - - -Ajustes generales -~~~~~~~~~~~~~~~~~ - -Si ajustas la ruta a ``jackrabbit_jar``, puedes utilizar la orden de consola ``doctrine:phpcr:jackrabbit`` para arrancar y parar el ``jackrabbit``. - -Puedes poner a punto la producción de la orden ``doctrine:phpcr:dump`` con ``dump_max_line_length``. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - jackrabbit_jar: /ruta/a/jackrabbit.jar - dump_max_line_length: 120 - -.. _multiple-phpcr-sessions: - -Configurando múltiples sesiones -------------------------------- - -Si necesitas más de una interfaz de administración *PHPCR*, puedes definir ``sessions`` como hijo de la información de ``session``. Cada sesión tiene un nombre y configuración que puedes utilizar directamente en ``session``. también puedes sobrescribir qué sesión utilizar como ``default_session``. - - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - default_session: ~ - sessions: - : - workspace: ~ # Requerido - username: ~ - password: ~ - backend: - # como arriba - options: - # como arriba - -Si estás utilizando el *ODM*, también querrás configurar múltiples gestores de documento. - -Dentro de la sección *odm*, puedes añadir entradas nombradas en ``document_managers``. -Para utilizar la sesión no predefinida, especifica el atributo ``session``. - -.. configuration-block:: - - .. code-block:: yaml - - odm: - default_document_manager: ~ - document_managers: - : - # mismas opciones que directamente en odm, ve arriba. - session: - - -Un ejemplo completo se ve como sigue: - -.. configuration-block:: - - .. code-block:: yaml - - doctrine_phpcr: - # configura las sesiones PHPCR - session: - sessions: - - default: - backend: %phpcr_backend% - workspace: %phpcr_workspace% - username: %phpcr_user% - password: %phpcr_pass% - - website: - backend: - type: jackrabbit - url: %magnolia_url% - workspace: website - username: %magnolia_user% - password: %magnolia_pass% - - dms: - backend: - type: jackrabbit - url: %magnolia_url% - workspace: dms - username: %magnolia_user% - password: %magnolia_pass% - # activa la capa ODM - odm: - document_managers: - default: - session: default - mappings: - SandboxMainBundle: ~ - SymfonyCmfContentBundle: ~ - SymfonyCmfMenuBundle: ~ - SymfonyCmfRoutingExtraBundle: ~ - - website: - session: website - configuration_id: sandbox_magnolia.odm_configuration - mappings: - SandboxMagnoliaBundle: ~ - - dms: - session: dms - configuration_id: sandbox_magnolia.odm_configuration - mappings: - SandboxMagnoliaBundle: ~ - - auto_generate_proxy_classes: %kernel.debug% - -.. tip:: - - Este ejemplo también utiliza diferentes configuraciones par repositorio (ve el atributo ``repository_id``). Este caso se explica en :doc:`../cookbook/phpcr-odm-custom-documentclass-mapper`. - -.. _reference-phpcr-commands: - -Órdenes del *PHPCR* de *Doctrine* ---------------------------------- - -Todas las órdenes sobre el *PHPCR* van prefijadas con ``doctrine:phpcr`` y puedes utilizar el argumento ``--session`` para utilizar una sesión distinta a la predefinida si configuraste varias sesiones *PHPCR*. - -Algunas de estas órdenes son específicas a una interfaz de administración o al *ODM*. Esas órdenes -sólo estarán disponibles si tal interfaz de administración está configurada. - -Usa ``app/console help `` para ver todas las opciones que tiene cada orden. - -- ``doctrine:phpcr:workspace:create`` Crea un espacio de trabajo en el repositorio configurado -- ``doctrine:phpcr:workspace:list`` Enumera todos los espacios de trabajo configurados en el repositorio -- ``doctrine:phpcr:purge`` Elimina todo el contenido del repositorio -- ``doctrine:phpcr:register-system-node-types`` Registra el sistema del tipo de nodo en el repositorio *PHPCR* -- ``doctrine:phpcr:register-node-types`` Registra el tipo de nodos en el repositorio *PHPCR* -- ``doctrine:phpcr:fixtures:load`` Carga accesorios a tu base de datos *PHPCR*. -- ``doctrine:phpcr:import`` Importa datos *xml* al repositorio, ya sea en el sistema de visualización *JCR* o *XML* arbitrario -- ``doctrine:phpcr:export`` Exporta nodos desde el repositorio, bien al sistema de visualización *JCR* o al formato de visualización de documento -- ``doctrine:phpcr:dump`` vacía el contenido del repositorio -- ``doctrine:phpcr:query`` Executa una declaración *SQL2* de *JCR* -- ``doctrine:phpcr:mapping:info`` Muestra información básica sobre todos los documentos asociados - - -Órdenes específicas de ``Jackrabbit`` -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si estás utilizando ``jackalope-jackrabbit``, también tienes una orden para arrancar y detener el servidor ``jackrabbit``: - -- ``jackalope:run:jackrabbit`` Arranca y detiene el servidor ``Jackrabbit`` - - -Órdenes específicas para el *DBAL* de *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si estás utilizando ``jackalope-doctrine-dbal``, tienes una orden para iniciar la base -de datos: - -- ``jackalope:init:dbal`` Prepara la base de datos para el *DBAL* de *Doctrine* con ``Jackalope`` - -Ten en cuenta que también puedes utilizar la orden *dbal* de *doctrine* para crear la base de datos. - - -Algunas ordenes de ejemplo -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ejecutando `consultas SQL2 `_ contra el repositorio - -.. code-block:: bash - - app/console doctrine:phpcr:query "SELECT title FROM [nt:unstructured] WHERE NAME() = 'home'" - - -Vertiendo nodos bajo /cms/simple incluyendo sus propiedades - -.. code-block:: bash - - app/console doctrine:phpcr:dump /cms/simple --props=yes - - diff --git a/cmf/html/_sources/bundles/routing-extra.txt b/cmf/html/_sources/bundles/routing-extra.txt deleted file mode 100644 index 157af2f..0000000 --- a/cmf/html/_sources/bundles/routing-extra.txt +++ /dev/null @@ -1,244 +0,0 @@ -``RoutingExtraBundle`` -====================== - -El `RoutingExtraBundle `_ integra el enrutado dinámico a *Symfony* utilizando :doc:`../components/routing`. - -El ``ChainRouter`` pretende reemplazar el enrutador predefinido de *Symfony*. Todo lo que hace es recoger una lista priorizada de rutas e intenta emparejar peticiones y generar las *url* con todas ellas. Naturalmente, una de las rutas en esa cadena puede ser la ruta predefinida para que todavía la puedas utilizar de la manera estándar en algunas de tus rutas. - -Además, este paquete entrega útiles implementaciones de enrutado. Actualmente, existe el ``DynamicRouter`` que enruta basándose en una implementación de repositorio que proporciona objetos ``Route`` de *Symfony2*. El repositorio se puede implementar utilizando una base de datos, por ejemplo con el `PHPCR-ODM`_ de *Doctrine* o el *ORM* de *Doctrine*. El paquete proporciona una implementación predefinida para el `PHPCR-ODM`_ de *Doctrine*. - -El servicio *DynamicRouter* sólo está disponible cuándo se habilita explícitamente en la configuración de la aplicación. - -Finalmente estos paquetes proporcionan documentos de ruta para el `PHPCR-ODM`_ de *Doctrine* y un controlador para redirigir rutas. - -.. index:: RoutingExtraBundle -.. index:: Routing - -Dependencias ------------- - -* `Routing del CMF de Symfony `_ - -``ChainRouter`` ---------------- - -El ``ChainRouter`` puede reemplazar el sistema de enrutado predefinido de *Symfony* con una implementación habilitada en cadena. Esta no enruta nada por sí misma, sino que únicamente recorre todos los enrutadores encadenados. Para manejar las rutas estándar configuradas en *Symfony*, el enrutador predefinido de *Symfony* se puede poner en la cadena. - -Configurando ------------- - -En tu archivo :file:`app/config/config.yml`, puedes especificar cual servicio de enrutado quieres usar. Si no especificas el ``routers_by_id`` asigna todos, de manera predefinida el enrutador encadenado simplemente cargará el enrutador construido en *Symfony*. Cuándo especificas la lista de ``routers_by_id``, necesitas tener una entrada para ``router.default`` si quieres el enrutador de *Symfony2* (aquel que lee las rutas desde :file:`app/config/routing.yml`). - -El formato es ``service_name: priority`` --- el número de prioridad más alto anterior es preguntado a este servicio enrutador para emparejar una ruta o para generar una *url*: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - chain: - routers_by_id: - # activa el DynamicRouter con alta prioridad para redefinir el enrutador configurado con contenido - symfony_cmf_routing_extra.dynamic_router: 200 - # activa el enrutador predefinido de symfony con baja prioridad - router.default: 100 - # cuando la cadena de enrutadores debe sustituir al enrutador predefinido. por omisión es true - # si lo pones en false, el enrutador sólo estará disponible como servicio - # symfony_cmf_routing_extra.router y debes hacer algo para lanzarlo - # replace_symfony_router: true - -Cargando enrutadores con etiquetado -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Tus enrutadores se pueden registrar automáticamente, justo añadiéndolos como servicios etiquetados con `router` y una ``prioridad`` opcional. -Mientras más alta prioridad, más temprano será consultado tu enrutador para emparejar la ruta. Si no especificas la prioridad, tu enrutador vendrá al último. -Si hay varios enrutadores con la misma prioridad, el orden entre ellos es indeterminado. -El servicio etiquetado tendrá esta apariencia: - -.. configuration-block:: - - .. code-block:: yaml - - services: - my_namespace.my_router: - class: %my_namespace.my_router_class% - tags: - - { name: router, priority: 300 } - - .. code-block:: xml - - - - .. - - -Ve también la `documentación oficial de Symfony2 para las etiquetas de inyección de dependencias`_ - -Enrutador dinámico ------------------- - -Esta implementación de un enrutador carga rutas de una ``RouteRepositoryInterface``. -Esta interfaz se puede implementar fácilmente con *Doctrine*. - -El enrutador trabaja con las clases base ``UrlMatcher`` y ``UrlGenerator`` y sólo añade la carga de rutas desde la base de datos y el concepto de contenido referido. - -El servicio ``DynamicRouter`` está instalado con un repositorio. Ve en la sección de configuración cómo cambiar el ``route_repository_service`` y la siguiente sección para más detalles sobre la implementación predefinida basada en `PHPCR-ODM`_. - -Querrás configurar el controlador de asignación que decide cuál controlador debe manejar la petición, para evitar codificar nombres de controlador en tus documentos de ruta. - -La configuración mínima requerida para cargar el enrutador dinámico como un servicio ``symfony_cmf_routing_extra.dynamic_router`` es tenerlo como ``enabled: true`` en tu archivo :file:`config.yml` (El enrutador se activa automáticamente apenas añadas cualquier otra configuración a la entrada ``dynamic``). Sin habilitarlo, el servicio enrutador dinámico no será cargado en absoluto, dejándote utilizar el ``ChainRouter`` con tus propios enrutadores: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - enabled: true - -Integrando *PHPCR-ODM* -~~~~~~~~~~~~~~~~~~~~~~ - -Este paquete viene con una implementación de enrutador con repositorio para `PHPCR-ODM`_. -*PHPCR* es apropiado para la naturaleza del árbol de datos. Si usas `PHPCR-ODM`_ con un documento de ruta como el proporcionado, justo puedes dejar el servicio repositorio como el predefinido. - -El repositorio predefinido carga la ruta desde la ruta en la petición y todas las rutas padre para permitir que algunos de los segmentos de la ruta sigan siendo parámetros. Si necesitas una diferente manera de cargar rutas o, por ejemplo, nunca usar parámetros, puedes escribir tu propia implementación del repositorio para optimizarla (ve en el archivo :file:`cmf_routing.xml` cómo configurar el servicio). - -.. index:: PHPCR, ODM - -Proceso de concordancia -~~~~~~~~~~~~~~~~~~~~~~~ - -La mayoría del proceso de concordancia está descrito en la documentación del `componente enrutador del CMF`_. -La única diferencia es que el paquete colocará el ``contentDocument`` en los atributos de la petición en vez de en la ruta predefinida. - -Tus controladores pueden (y tienen que) declarar el parámetro ``$contentDocument`` en tus métodos ``Action`` si se supone que trabajen con el contenido referido por las rutas. -Ve ``Symfony\Cmf\Bundle\ContentBundle\Controller\ContentController`` para un ejemplo. - -.. _routing-controller-mapper: - -Configurando -~~~~~~~~~~~~ - -Para configurar el ``ControllerMappers``, puedes especificar asignaciones. La presencia de cada asignación hace que el contenedor de inyección de dependencias inyecte la respectiva asociación al ``DynamicRouter``. - -Las posibles asociaciones son (por orden de precedencia): - -* (Controlador explícito): Si hay un controlador configurado en ``getRouteDefaults()``, se utiliza y no se pregunta por ninguna asociación. -* Plantilla explícita: Requiere que el documento de ruta regrese un parámetro ``'_template'`` en ``getRouteDefaults``. El controlador genérico configurado es regresado por la asociación. -* Controlador por alias: Requiere que el documento de ruta regrese un valor ``'type'`` en ``getRouteDefaults()`` -* Controlador por clase: Requiere que el documento de ruta regrese un objeto para ``getRouteContent()``. El documento contenido se comprueba que sea una instancia de los nombres de clase en la asociación y si coincide, regresa el controlador. - Se utiliza ``instanceof`` en vez de buscar directamente para trabajar con clases delegadas. -* Plantilla por clase: Requiere que el documento de ruta regrese un objeto para ``getRouteContent()``. Se comprueba que el documento contenido sea una instancia de los nombres de clase en la asociación y si coincide la plantilla será configurada como ``'_template'`` en ``$defaults`` y regresa el controlador genérico configurado: - - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - generic_controller: symfony_cmf_content.controller:indexAction - controllers_by_alias: - editablestatic: sandbox_main.controller:indexAction - controllers_by_class: - Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: symfony_cmf_content.controller::indexAction - templates_by_class: - Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: SymfonyCmfContentBundle:StaticContent:index.html.twig - - # el repositorio es responsable de cargar las rutas - # por PHPCR-ODM, principalmente los usamos porque puede asociar la url a una ruta del repositorio - # un repositorio orm posiblemente necesite diferente lógica. ve el cmf_routing.xml para un ejemplo si - # necesitas definir tu propio servicio - manager_registry: doctrine_phpcr - manager_name: default - - # Si usas la ruta predefinida del servicio repositorio de Doctrine, lo puedes usar para personalizar - # la ruta raíz para el PHPCR-ODM RouteRepository - # esta ruta base será inyectada por el Listener\IdPrefix - pero sólo a las rutas que - # emparejen el prefijo, para permitirte más de una ruta fuente. - routing_repositoryroot: /cms/routes - - # Si quieres reemplazar la ruta predefinida o contenido de los repositorios - # aquí puedes especificar los IDs de tu servicio. - route_repository_service_id: my_bundle.repository.endpoint - content_repository_service_id: my_bundle.repository.endpoint - -Para ver algunos ejemplos, por favor ve en el `recinto de seguridad del CMF`_ y específicamente la carga de accesorios de enrutado. - - -Configurando la administración de ``Sonata`` -"""""""""""""""""""""""""""""""""""""""""""" - -Si en la sección ``require`` del archivo :file:`composer.json` añades el ``sonata-project/doctrine-phpcr-admin-bundle``, los documentos de ruta serán expuestos en el ``SonataDoctrinePhpcrAdminBundle``. -Para instrucciones sobre cómo configurar este paquete ve :doc:`doctrine_phpcr_admin`. - -De manera predefinida, ``use_sonata_admin`` se pone automáticamente basándose en si ``SonataDoctrinePhpcrAdminBundle`` está disponible pero lo puedes desactivar explícitamente si no tienes habilitado sonata, o activarlo explícitamente para conseguir un error si sonata se vuelve inasequible. - -Tienes un par de opciones de configuración para la administración. El ``content_basepath`` apunta a la raíz de tus documentos de contenido. - - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - use_sonata_admin: auto # usa true/false para forzar el uso / no uso de la administración de sonata - content_basepath: ~ # usado con la administración de sonata para manejar el contenido, por omisión a symfony_cmf_core.content_basepath - - -El tipo ``form`` ----------------- - -El paquete define un tipo ``form`` que puedes utilizar para la clásica casilla de verificación «aceptar términos» donde colocas las *url* en la etiqueta. Simplemente especifica ``symfony_cmf_routing_extra_terms_form_type`` como el nombre del tipo ``form`` y especifica una etiqueta y un arreglo con ``content_ids`` en las opciones - -.. code-block:: php - - $form->add('terms', 'symfony_cmf_routing_extra_terms_form_type', array( - 'label' => 'I have seen the Team and More pages ...', - 'content_ids' => array('%team%' => '/cms/content/static/team', '%more%' => '/cms/content/static/more') - )); - -El tipo ``form`` automáticamente genera las rutas para el contenido especificado y pasa las rutas al ayudante ``trans`` de *Twig* para sustituirlas en la etiqueta. - -Notas adicionales ------------------ - -Ve la documentación del `componente enrutador del CMF`_ para información sobre la ``RouteObjectInterface``, redirecciones y regiones. - -Notas: - -* RouteObjectInterface: Los documentos proporcionados implementan esta interfaz para asociar contenido a rutas y (opcionalmente) proporcionan un nombre de ruta personalizado en vez del nombre de ruta compatible con el núcleo de *Symfony*. -* Redirecciones: Este paquete proporciona un ``RedirectController``. - -Pendiente: Ve ``DependencyInjection/Configuration.php`` de este paquete. No podría representar cómo poner esta asociación como la asignación predefinida. Entretanto, para hacer redirecciones, necesitas añadir una entrada a tu asociación en la configuración de tu proyecto: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - controllers_by_class: - Symfony\Cmf\Component\Routing\RedirectRouteInterface: symfony_cmf_routing_extra.redirect_controller:redirectAction - -Personalizando --------------- - -Puedes añadir más implementaciones ``ControllerMapperInterface`` si tienes un caso no manejado por las proporcionadas. - -Si usas un *ODM/ORM* diferente a `PHPCR-ODM`_, probablemente necesites especificar la clase para la entidad ruta (en `PHPCR-ODM`_, la clase es detectada automáticamente). Para necesidades más específicas, dale una mirada al ``DynamicRouter`` y ve si lo quieres extender. También puedes escribir tus propios enrutadores para engancharlos a la cadena. - -.. _`documentación oficial de Symfony2 para las etiquetas de inyección de dependencias`: http://gitnacho.github.com/symfony-docs-es/reference/dic_tags.html -.. _`recinto de seguridad del CMF`: https://github.com/symfony-cmf/cmf-sandbox -.. _`componente enrutador del CMF`: https://github.com/symfony-cmf/Routing -.. _`PHPCR-ODM`: https://github.com/doctrine/phpcr-odm - -Aprende más en el recetario ---------------------------- - -* :doc:`../cookbook/using-a-custom-route-repository` diff --git a/cmf/html/_sources/bundles/search.txt b/cmf/html/_sources/bundles/search.txt deleted file mode 100644 index 470719e..0000000 --- a/cmf/html/_sources/bundles/search.txt +++ /dev/null @@ -1,30 +0,0 @@ -``SearchBundle`` -================ - -El `SearchBundle `_ proporciona integración con ``LiipSearchBundle`` para manejar la búsqueda en un sitio grande. - -.. index:: SearchBundle - -Dependencias ------------- - -* `LiipSearchBundle `_ - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_search`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_search: - document_manager_name: default - translation_strategy: child # además se puede configurar como una cadena vacía o atributo - translation_strategy: attribute - search_path: /cms/content - search_fields: - title: title - summary: body \ No newline at end of file diff --git a/cmf/html/_sources/bundles/simple-cms.txt b/cmf/html/_sources/bundles/simple-cms.txt deleted file mode 100644 index dfd4d86..0000000 --- a/cmf/html/_sources/bundles/simple-cms.txt +++ /dev/null @@ -1,111 +0,0 @@ -``SimpleCmsBundle`` -=================== - -El `SimpleCmsBundle `_ proporciona un *CMS* simplista sobre los componentes y paquetes del ``CMF``. - -Si bien los componentes del núcleo del *CMF* se enfocan en la flexibilidad, el simple *CMS* especula con alguna de esa flexibilidad a favor de la simplicidad. - -.. index:: SimpleCmsBundle, i18n - -Dependencias ------------- - -Tal como se especifica en el archivo :file:`composer.json` este paquete depende de muchos de los paquetes del *CMF*. - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_simple_cms``. - -La opción ``use_menu`` automáticamente habilita un servicio para proporcionar los menús del simple *CMS* si ``MenuBundle`` está habilitado. También lo puedes desactivar explícitamente si tienes el paquete ``menu`` pero no quieres utilizar el servicio predefinido, o habilitarlo explícitamente para conseguir un error si el paquete ``menu`` se vuelve inasequible. - -En la sección de enrutado está establecido cual plantilla o controlador utilizar para una clase de contenido. Esta reutiliza lo que hace el enrutado extra, por favor, ve la sección correspondiente en :ref:`configurando el enrutado `. También explica el ``generic_controller``. - -Ve la sección para soporte multiidioma más adelante. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - use_menu: auto # usa true/false para forzar provisión / no provisión de un menú - use_sonata_admin: auto # usa true/false para forzar el uso / no uso de la administración de sonata - document_class: Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page - # controlador a usar para dibujar documentos únicamente con plantilla personalizada - generic_controller: symfony_cmf_content.controller:indexAction - # dónde almacenar las páginas en el árbol PHPCR - basepath: /cms/simple - routing: - content_repository_id: symfony_cmf_routing_extra.content_repository - controllers_by_class: - # ... - templates_by_class: - # ... - multilang: - locales: [] - -.. tip:: - - Si tienes habilitada la administración *PHPCR-ODM* de ``Sonata`` pero *NO* quieres mostrar la administración predefinida proporcionada por este paquete, puedes añadir lo siguiente a tu configuración: - - .. configuration-block:: - - .. code-block:: yaml - - symfony_cmf_simple_cms: - use_sonata_admin: false - -Soporte multiidioma -------------------- - -El modo ``multi-language-mode`` se habilita proporcionando la lista de regiones permitidas en el campo ``multilang > locales``. - -En ``multi-language-mode`` el paquete automáticamente utilizará ``Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangPage`` como la ``document_class`` a no ser que explícitamente esté configurada una clase diferente. - -Esta clase de manera predeterminada prefijará todas las rutas con ``/{_locale}``. Este comportamiento se puede desactivar poniendo a ``false`` el segundo parámetro en el constructor del modelo. - -Además, la capa de enrutado será configurada para utilizar ``Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangRouteRepository`` la cuál garantizará que incluso con el prefijo ``locale`` el nodo de contenido correcto será encontrado. Además, automáticamente añade un ``_locale`` el requisito enumerando las regiones actualmente disponibles para la ruta emparejada. - -.. note:: - - Debido a que ``SimpleCmsBundle`` sólo proporciona una sencilla estructura de árbol, todos los nodos tendrán el mismo nombre de nodo para todos los idiomas. Así que una *url* ``http://foo.com/en/bar`` para contenido en inglés se vería cómo ``http://foo.com/de/bar`` para contenido en alemán. A veces puede ser más factible utilizar enteros como nombres de nodo y sencillamente anexarlos al título del nodo en la región dada como una ancla. Así por ejemplo ``http://foo.com/de/1#my title`` y ``http://foo.com/de/1#mein title``. - Si necesitas las *URL* específicas al idioma, quieres usar el enrutado del paquete *CMF* y el paquete de contenido directamente para tener un documento de ruta separado por idioma. - - -Reproduciendo -------------- - -Puedes especificar la plantilla para reproducir una página del ``SimpleCms``, o utilizar un controlador donde luego proporciones el documento de página a la plantilla. Un sencillo ejemplo para tal plantilla es este: - - -.. code-block:: jinja - - {% block content %} - -

            {{ page.title }}

            - -
            {{ page.body|raw }}
            - -
              - {% foreach tag in page.tags %} -
            • {{ tag }}
              • - {% endforeach %} -
            - - {% endblock %} - - -Si tienes habilitado el ``CreateBundle``, también puedes producir el documento con anotaciones *RDF*, permitiéndote editar el contenido así como las etiquetas en la interfaz de usuario. La forma más sencilla es el siguiente bloque de *Twig*: - -.. code-block:: jinja - - {% block content %} - - {% createphp page as="rdf" %} - {{ rdf|raw }} - {% endcreatephp %} - - {% endblock %} - -Si quieres un control más detallado se tendría que mostrar con *RDF*, ve el capítulo :doc:`create`. diff --git a/cmf/html/_sources/bundles/tree-browser.txt b/cmf/html/_sources/bundles/tree-browser.txt deleted file mode 100644 index 313af4e..0000000 --- a/cmf/html/_sources/bundles/tree-browser.txt +++ /dev/null @@ -1,66 +0,0 @@ -``TreeBrowserBundle`` -===================== - -El `TreeBrowserBundle `_ -proporciona integración con :doc:`tree` para proporcionar un árbol de navegación en lo alto de un repositorio *PHPCR*. - -Este paquete consta de dos partes: - - * Árbol de navegación genérico con una ``TreeInterface`` - * Implementación del árbol *PHPCR* e *IGU* para un navegador *PHPCR* - -.. index:: TreeBrowserBundle - -Dependencias ------------- - -* `TreeBundle `_ - -Configurando ------------- - -La clave de configuración para este paquete es ``symfony_cmf_tree_browser`` - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_tree_browser: - session: default - -Usando ------- - -Tienes :file:`select.js` e :file:`init.js` los cuáles son una envoltura para construir un árbol *jQuery*. Úsalos con ``SelectTree.initTree`` ``resp.`` ``AdminTree.initTree`` - - * ``SelectTree`` en :file:`select.js` es un árbol para seleccionar un nodo para poner su ID a un campo - * ``AdminTree`` en :file:`init.js` es para crear un árbol, mover y editar nodos - -Ambos tienen las siguientes opciones al crearlos: - - * config.rootNode: id para el nodo raíz de tu árbol, predefinido a "/" - * config.path.expanded: ruta de árbol donde el árbol se tendría que expandir al momento - * config.path.preloaded: ruta del árbol hacia qué nodo se tendría que precargar para una experiencia de usuario más rápida - * config.ajax.children_url: *URL* al controlador que proporciona los hijos de un nodo - * config.selector: Selector *jQuery* dónde enganchar en el árbol *js* - -Solo :file:`select.js` -~~~~~~~~~~~~~~~~~~~~~~ - - * config.output: Dónde escribir el Id del nodo seleccionado - -Solo :file:`init.js` -~~~~~~~~~~~~~~~~~~~~ - - * config.ajax.move_url: *URL* al controlador que maneja la operación de movimiento - * config.doctypes: arreglo para manejar la creación de nuevos nodos - * config.routecollection: arreglo indexado con el atributo ``className`` de los nodos más ``.routes.edit`` y ``.routes.delete`` asociadas a rutas para las operaciones de edición y remoción. - -Ejemplos --------- - -Ve en las plantillas del paquete de administración de ``Sonata`` los ejemplos sobre cómo construir el árbol: - -* `init.js `_ -* `select.js `_ (busca ``doctrine_phpcr_type_tree_model_widget``) \ No newline at end of file diff --git a/cmf/html/_sources/bundles/tree.txt b/cmf/html/_sources/bundles/tree.txt deleted file mode 100644 index d1494a3..0000000 --- a/cmf/html/_sources/bundles/tree.txt +++ /dev/null @@ -1,121 +0,0 @@ -``TreeBundle`` -============== - -El `TreeBundle `_ proporciona integración con el árbol *jQuery*. - -.. index:: TreeBundle - -Dependencias ------------- - -* Instala *jQuery*. `SonatajQueryBundle `_ fuertemente recomendado. - -Configurando ------------- - -No hay ninguna configuración para este paquete. - -Características ---------------- - - * Expandiendo/colapsando nodos. - * Cargando subárboles relajadamente vía respuestas *JSON* para llamadas *AJAX*. - * Función retrollamada al conmutar un nodo. - -Usando ------- - - * Incluye archivos *CSS* y *JS* en tu plantilla. - * Llama a ``$("#tree").jstree({/* parámetros */})`` --- suponiendo que aquí ``#tree`` es el selector de tu lista. - * Proporciona el valor *url* que apunta a alguna cosa de lado del servidor regresando listas de nodos hijo para cualquier ID de nodo dado. - -El servidor tiene que responder en formato *JSON*, este es un ejemplo: - -.. code-block:: javascript - - [ - {"data":"root","attr":{"id":"root","rel":"folder"},"state":"closed","children": - [ - {"data":"content","attr":{"id":"child1","rel":"folder"},"state":"closed"}, - {"data":"menu","attr":{"id":"child2","rel":"folder"},"state":"closed"}, - {"data":"routes","attr":{"id":"child3","rel":"folder"},"state":"closed"} - ] - } - ] - -Disponemos de más información sobre la configuración en el `sitio web de jsTree `_. - -Ejemplo *HTML* --------------- - -.. code-block:: html - - - - CMF Sandbox - Treeview test - - - - - - - - - - - - -
              -
            - -
            - -
            - - {% block content %} - Hello {{ name }}! - {% endblock %} - - \ No newline at end of file diff --git a/cmf/html/_sources/components/routing.txt b/cmf/html/_sources/components/routing.txt deleted file mode 100644 index d0ffb0d..0000000 --- a/cmf/html/_sources/components/routing.txt +++ /dev/null @@ -1,148 +0,0 @@ -El componente ``Routing`` -========================= - -La biblioteca del `componente Routing del CMF de Symfony `_ extiende el componente ``routing`` del núcleo de *Symfony2*. Incluso, aunque este tiene *Symfony* en su nombre, no necesita la plataforma *Symfony2* completa y se puede utilizar en proyectos independientes. Para integración con *Symfony* proporcionamos :doc:`../bundles/routing-extra`. - -En el núcleo del ``CMF`` de *Symfony* el componente de enrutado es el ``ChainRouter``, que se utiliza en vez del sistema de enrutamiento predeterminado de *Symfony2*. El ``ChainRouter`` puede encadenar varias implementaciones de ``RouterInterface``, una tras otra, para determinar cuál tendría que manejar cada petición. Puedes añadir a esta cadena el enrutador predeterminado de *Symfony2*, por lo tanto aún puedes utilizar el mecanismo de enrutado estándar. - -Además, este componente se pretende que proporcione útiles implementaciones de la ``RouterInterface``. Actualmente, proporciona ``DynamicRouter`` que es capaz de recuperar dinámicamente un objeto ``Ruta`` de *Symfony2* desde un repositorio. El repositorio se puede implementar utilizando una base de datos, por ejemplo con el *PHPCR-ODM* de *Doctrine* o el *ORM* de *Doctrine*. - -.. note:: - - Para usar este componente fuera del contexto de la plataforma *Symfony2*, tienes que darle un vistazo al componente `Routing `_ del núcleo de *Symfony2* para conseguir un entendimiento fundamental del componente. El enrutador del ``CMF`` justo extiende el comportamiento básico. - -.. index:: Routing - -Dependencias ------------- - -Este componente usa `composer `_. Necesita los componentes ``Routing`` y ``HttpKernel`` de *Symfony2* (para la interfaz del registro cronológico e iniciar la memoria caché). - -Para el ``DynamicRouter`` necesitarás algo para implementar la ``RouteRepositoryInterface``. Te sugerimos utilizar *Doctrine* puesto que te permite asociar cualquier clase a una base de datos. - -``ChainRouter`` ---------------- - -En el núcleo del ``CMF`` de *Symfony* el componente de enrutado es el ``ChainRouter``. -Este se utiliza en vez del sistema de enrutado predeterminado de *Symfony2*, y es el responsable de determinar cuál controlador manejará cada petición. - -El ``ChainRouter`` trabaja aceptando un conjunto priorizado de implementaciones de estrategias de enrutado, `RouterInterface `_, generalmente referidas como ``«Enrutadores»``. - -Al manejar una petición entrante, itera sobre los ``enrutadores`` configurados, por su prioridad establecida, hasta que uno de ellos es capaz de `emparejar `_ -la petición y asignarla a un determinado ``Controlador``. - -Enrutadores ------------ - -El ``ChainRouter`` es incapaz ---por sí mismo--- de hacer ningún encaminamiento real. -Su única responsabilidad es gestionar el conjunto de ``Enrutadores`` dado, los cuales son los verdaderos responsables de emparejar una ``Petición`` a un ``Controlador``. - -Fácilmente puedes crear tus propios ``Enrutadores`` implementando la `RouterInterface `_ pero, por omisión, el ``CMF`` de *Symfony* ya incluye algunos mecanismos de encaminamiento básicos para ayudarte a empezar. - -.. note:: - - Si estás utilizando este como parte de un proyecto completo con el ``CMF`` de *Symfony*, por favor, revisa el :doc:`../bundles/routing-extra` para instrucciones sobre cómo añadir ``Enrutadores`` al ``ChainRouter``. De lo contrario, usa el método ``add`` del ``ChainRouter`` para configurar nuevos ``Enrutadores``. - -Enrutador predefinido de *Symfony2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El mecanismo de enrutado de *Symfony2* en sí mismo es una implementación de ``RouterInterface``, lo cual significa que lo puedes utilizar como ``Enrutador`` en el ``ChainRouter``. Esto te permite utilizar las declaraciones del sistema de enrutado predefinido. - -Enrutador dinámico -~~~~~~~~~~~~~~~~~~ - -El ``DynamicRouter`` es capaz de cargar dinámicamente `objetos Ruta `_ desde una fuente determinada de datos proporcionada al ``Enrutador`` tal como una implementación de ``RouteRepositoryInterface``. A pesar de que lo puedes utilizar de otras maneras, el principal objetivo de la ``RouteRepositoryInterface`` es facilitar eficientemente la implementación del *PHPCR* en lo alto del *ODM* de *Doctrine*, permitiéndote almacenar y gestionar rutas dinámicamente desde una base de datos. - -Procesando la petición -^^^^^^^^^^^^^^^^^^^^^^ - -La petición entrante es manejada por el método ``match`` del ``DynamicRouter`` usando el siguiente flujo de trabajo: - -* El ``DynamicRouter`` utiliza la ``RouteRepositoryInterface`` para recuperar un conjunto de instancias ``Ruta`` -* Luego utiliza el ``UrlMatcher`` en conjunto devuelto para encontrar una sola ``Ruta`` coincidente -* Aplica un conjunto opcional de ``RouteEnhancers`` a la ``Ruta`` - -La recuperación -""""""""""""""" - -Basado en la *URL* solicitada, el ``DynamicRouter`` recuperará un conjunto ordenado de objetos ``Ruta`` desde la ``RouteRepositoryInterface``. - -La implementación subyacente de la interfaz ``RouteRepositoryInterface`` no es parte del alcance de este paquete. Consulta la declaración de interfaz para más información. Para un ejemplo funcional, ve el `RoutingExtraBundle `_. - -La igualación -""""""""""""" - -El ``DynamicRouter`` usa el método `UrlMatcher `_ del componente ``Routing`` de *Symfony* al iterar sobre los objetos ``Ruta`` recuperados, para determinar cuál de ellos utilizar. - -Los potenciadores -""""""""""""""""" - -Opcionalmente, puedes declarar un conjunto de instancias de la ``RouteEnhancerInterface`` y asociarlas al ``DynamicRouter``. El objetivo de esto es permitirte manipular la ``Ruta`` y sus parámetros asociados. Estos se pueden utilizar, por ejemplo, para asignar dinámicamente un controlador o una plantilla a una ``Ruta``. Algunos sencillos potenciadores ya vienen integrados con el paquete, puedes encontrar la documentación dentro de cada archivo de clase. - -Enlazando una ``Ruta`` con un ``Contenido`` -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -Dependiendo de la lógica de tu aplicación, una *URL* solicitada puede tener asociado contenido desde la base de datos. Estas ``Rutas`` deberían implementar la ``RouteObjectInterface``, y opcionalmente pueden regresar una instancia del modelo, la cual será vinculada al arreglo devuelto, en la clave ``_content``. Ten en cuenta que una ``Ruta`` puede implementar la interfaz mencionada anteriormente pero todavía no regresar ninguna instancia del modelo, en cuyo caso ningún objeto asociado será regresado. - -Además, los enrutadores que implementen esta interfaz también pueden proporcionar un nombre de ruta personalizado. La clave devuelta por ``getRouteKey`` será utilizada como el nombre de ruta en vez del nombre de ruta compatible con el núcleo de *Symfony* y puede contener cualquiera de los caracteres del juego de caracteres actual. Esto te permite, por ejemplo, poner una ruta como el nombre de la ruta. - -Todos los enrutadores todavía necesitan extender la clase base ``Symfony\Component\Routing\Route``. - -Redirecciones -^^^^^^^^^^^^^ - -Puedes construir redirecciones implementando la ``RedirectRouteInterface``. -Esta bien puede redirigir a una *URI* absoluta, a una ``Ruta`` nombrada que puede -generar cualquier ``Enrutador`` en la cadena o a otro objeto ``Ruta`` en el repositorio. - -Ten en cuenta que la redirección lógica real no es manejada por el paquete. Deberías implementar tu propia lógica para manejar la redirección real. Para un ejemplo implementando esta redirección bajo la pila completa de *Symfony2*, consulta el :doc:`../bundles/routing-extra`. - -Rutas e idiomas -^^^^^^^^^^^^^^^^ - -Puedes utilizar el valor predefinido de ``_locale`` en una ``Ruta`` para crear una ``Ruta`` por región, todas refiriendose a la misma instancia del modelo multilingüe. El ``DynamicRouter`` respeta el valor de ``_locale`` al generar rutas de instancias del modelo. Al resolver la ruta, el ``_locale`` se obtiene desde la petición y es recogido por el sistema regional de *Symfony2*. - -.. note:: - - Bajo *PHPCR-ODM*, las rutas nunca deberían ser documentos traducibles, puesto que un documento de ``Ruta`` representa una *URL* única, y no es recomendable servir varias traducciones bajo la misma *URL*. - - -Generando *URL* -^^^^^^^^^^^^^^^ - -``DynamicRouter`` usa el `UrlGenerator `_ predefinido de *Symfony2* para manejar la generación de *URL*. Puedes generar *URL* para tu contenido en tres distintas maneras: - -* Ya sea pasando una implementación de ``RouteObjectInterface`` como el parámetro ``route`` -* O pasando un ejemplar del modelo como el parámetro ``content`` -* O supliendo una implementación de ``ContentRepositoryInterface`` y el ``id`` del ejemplar del modelo como el parámetro ``content_id`` - -Personalizando --------------- - -Los paquetes de enrutado permiten varias opciones de personalización, dependiendo de tus necesidades específicas: - -* Tus parámetros de ``Ruta`` se pueden manipular fácilmente utilizando los potenciadores existentes -* También puedes añadir tu propio potenciador a la lógica del ``Enrutador``. -* El ``DynamicRouter`` o sus componentes se pueden extender para permitir modificaciones -* Puedes implementar tus propios ``Enrutadores`` y añadirlos al ``ChainRouter`` - -.. note:: - - Si sientes que tu potenciador o ``Enrutador`` específico le puede ser útil a otros, contáctanos e intentaremos incluirlo en el paquete. - -Integrando con *Symfony2* -------------------------- - -Tal como mencioné antes, este paquete fue diseñado para sólo requerir ciertas partes de *Symfony2*. Aun así, si deseas utilizarlo como parte de tu proyecto ``CMF`` de *Symfony*, también hay disponible un paquete de integración. Te recomendamos que le eches un vistazo en :doc:`../bundles/routing-extra`. - -Autores -------- - -* Filippo De Santis (p16) -* Henrik Bjornskov (henrikbjorn) -* Claudio Beatrice (omissis) -* Lukas Kahwe Smith (lsmith77) -* David Buchmann (dbu) -* `Y otros `_ - -El código original para la cadena de enrutadores fue aportado por Magnus Nordlander. diff --git a/cmf/html/_sources/contributing/code.txt b/cmf/html/_sources/contributing/code.txt deleted file mode 100644 index 8171cf0..0000000 --- a/cmf/html/_sources/contributing/code.txt +++ /dev/null @@ -1,15 +0,0 @@ -Colaborando -=========== - -El equipo del ``CMF`` de *Symfony2* sigue todas las reglas y directrices del `proceso de desarrollo `_ que el núcleo de *Symfony2*. - -Recursos / enlaces ------------------- - -* `GitHub `_ -* `Sitio web `_ -* `Wiki `_ -* `Rastreador de fallos `_ -* `Canal IRC `_ -* `Lista de correo para usuarios `_ -* `Lista de correo para desarrolladores `_ diff --git a/cmf/html/_sources/contributing/license.txt b/cmf/html/_sources/contributing/license.txt deleted file mode 100644 index e110e98..0000000 --- a/cmf/html/_sources/contributing/license.txt +++ /dev/null @@ -1,58 +0,0 @@ -Licencia -======== - -El objetivo del ``CMF`` de *Symfony2* es proporcionar licencias de código abierto liberales para su pila completa. - -Código ------- - -La pila del código está cubierta por la `licencia de Apache`_ para ``Jackalope`` y *PHPCR*, el resto de la pila, notablemente el código *Symfony2*, *PHPCR-ODM*, :file:`create.js` y :file:`Hallo.js` está `licenciado bajo MIT`_. Por favor, refiérete a los archivos de LICENCIA pertinentes en la fuente de los paquetes dados. - -Documentación -------------- - -La documentación de *Symfony2* está bajo una licencia `Creative Commons Attribution-Share Alike 3.0 Unported License`_. - -**Estás en libertad:** - -* para *Compartir* — copiar, distribuir y trasmitir públicamente la obra; - -* para *Derivar* — adaptando la obra. - -**Bajo las siguientes condiciones:** - -* *Atribución* — Debes atribuir el trabajo de la manera especificada por - el autor o licenciador (pero de ninguna manera que sugiera que apoya tu - uso de la obra). - -* *Compartir bajo la misma licencia* — Si alteras, transformas, o creas - sobre esta obra, sólo podrás distribuir la obra resultante bajo una - licencia idéntica o similar a esta. - -**En el entendido de:** - -* *Renuncia* — Cualquiera de estas condiciones puede no aplicarse si - obtienes el permiso del titular de los derechos de autor; - -* *Dominio Público* — Cuando la obra o cualquiera de sus elementos es del - dominio público bajo la legislación aplicable, este estatus de ninguna - manera es afectado por la licencia; - -* *Otros Derechos* — De ninguna manera cualquiera de los siguientes derechos - se ve afectado por la licencia: - - * Tu derecho leal o uso justo, u otros derechos de autor excepciones y limitaciones aplicables; - - * Los derechos morales del autor; - - * Otras personas pueden tener derechos ya sea en la propia obra o en la forma en que se utiliza la obra, como los derechos de publicidad o privacidad. - -* *Atención* — Para cualquier reutilización o distribución, debes dejar - claros los términos de la licencia de esta obra. La mejor manera de hacerlo es con un enlace a esta página web. - -Este es un resumen humanamente legible del `Texto legal (Licencia completa)`_. - -.. _`licencia de Apache`: http://en.wikipedia.org/wiki/Apache_license -.. _`licenciado bajo MIT`: http://en.wikipedia.org/wiki/MIT_License -.. _`Creative Commons Attribution-Share Alike 3.0 Unported License`: http://creativecommons.org/licenses/by-sa/3.0/ -.. _`Texto legal (Licencia completa)`: http://creativecommons.org/licenses/by-sa/3.0/legalcode \ No newline at end of file diff --git a/cmf/html/_sources/cookbook/installing-cmf-sandbox.txt b/cmf/html/_sources/cookbook/installing-cmf-sandbox.txt deleted file mode 100644 index 2aadefd..0000000 --- a/cmf/html/_sources/cookbook/installing-cmf-sandbox.txt +++ /dev/null @@ -1,253 +0,0 @@ -Instalando el recinto de seguridad del ``CMF`` -============================================== - -Esta guía muestra cómo instalar el recinto de seguridad del *CMF* de *Symfony*, una demostración de la plataforma dirigida a exhibir las características básicas de la herramienta corriendo en un entorno ``demo``. -La puedes usar para evaluar la plataforma o para ver código real en acción, ayudándote a entender la herramienta. - -Si bien lo puedes utilizar tal cual, este recinto de seguridad no pretende ser una plataforma de desarrollo. Si estás buscando instrucciones de instalación para una configuración de desarrollo, por favor revisa: - -- la página :doc:`../getting-started/installing-symfony-cmf` para instrucciones sobre cómo instalar rápidamente el *CMF* (recomendado para desarrollo) -- :doc:`../tutorials/installing-cmf-core` para una instalación paso a paso y detalles de configuración (si quieres conocer todos los detalles) - -.. index:: sandbox, instalación, recinto de seguridad - -Requisitos previos ------------------- - -Debido a que el ``CMF`` de *Symfony* está basado en *Symfony2*, deberías asegurarte de que cubres los `Requisitos para que funcione Symfony2 `_. -`Git 1.6+ `_, `Curl `_ y *PHP* ``Intl`` también son necesarios para seguir los pasos de instalación enumerados más adelante. - -Si deseas utilizar ``Jackalope`` + *Apache* ``JackRabbit`` como el medio de almacenamiento (recomendable), -también necesitas el *Java* (*JRE*). Para otros mecanismos y sus requisitos, por favor refiérete a sus respectivas secciones. - -Instalando ----------- - -*Apache* ``Jackrabbit`` -~~~~~~~~~~~~~~~~~~~~~~~ - -El recinto de seguridad del ``CMF`` de *Symfony* de manera predeterminada usa ``Jackalope`` con *Apache* ``JackRabbit``. -Puedes configurar métodos de almacenamiento alternativo, pero este es el más probado, y debería ser el más fácil de configurar. - -Puedes conseguir la más reciente versión de *Apache* ``Jackrabbit`` en la página de descarga oficial del `proyecto `_. -Para lanzarlo, usa la siguiente orden: - -.. code-block:: bash - - java -jar jackrabbit-standalone-*.jar - -De manera predefinida el servidor escucha en el puerto 8080, puedes cambiar esto especificando el puerto en la línea de ordenes. - -.. code-block:: bash - - java -jar jackrabbit-standalone-*.jar --port 8888 - -Para sistemas *unix*, puedes conseguir el guión de arranque/detención para el archivo :file:`/etc/init.d` `aquí `_ - -Consiguiendo el código del recinto de seguridad -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El código fuente del recinto de seguridad del ``CMF`` de *Symfony* está disponible en *github*. Para conseguirlo usa: - -.. code-block:: bash - - git clone git://github.com/symfony-cmf/cmf-sandbox.git - -Ve al directorio y copia los archivos de configuración predefinidos: - -.. code-block:: bash - - cd cmf-sandbox - cp app/config/parameters.yml.dist app/config/parameters.yml - cp app/config/phpcr_jackrabbit.yml.dist app/config/phpcr.yml - -Estos dos archivos incluyen los parámetros de configuración predefinidos para el mecanismo de almacenamiento del recinto de seguridad. Los puedes modificar para cubrir mejor tus necesidades. - -.. note:: - - El segundo archivo de configuración se refiere específicamente a la configuración de ``jackalope`` + ``jackrabbit``. Hay otros archivos disponibles para diferentes pilas de configuración. - -Luego, consigue ``composer`` e instala los paquetes necesarios (esto puede tomar un rato). - -.. code-block:: bash - - curl -s http://getcomposer.org/installer | php -- - php composer.phar install - -.. note:: - - En Windows necesitas ejecutar el intérprete de ordenes como administrador o editar el archivo :file:`composer.json`y cambiar la línea ``"symfony-assets-install": "symlink"`` a ``"symfony-assets-install": ""``. Si fallas al hacerlo podrías recibir: -.. code-block:: bash - - [Symfony\Component\Filesystem\Exception\IOException] - Imposible crear el enlace simbólico debido al error código 1314: 'El cliente no cuenta con un privilegio requerido'. ¿Tienes el privilegio de administrador requerido? - -Preparando el repositorio *PHPCR* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Ahora que tienes todo el código, necesitas configurar tu repositorio *PHPRC*. -*PHPRC* organiza los datos en espacios de trabajo, y el recinto de seguridad utiliza el espacio de trabajo ``«default»``, el cual existe por omisión en ``Jackrabbit``. Si utilizas otras aplicaciones que requieren ``Jackrabbit``, o si solo deseas cambiar el nombre del espacio de trabajo, lo puedes hacer en el archivo :file:`app/config/phpcr.yml`. La siguiente orden creará un nuevo espacio de trabajo llamado ``«sandbox»`` en ``Jackrabbit``. Si decides utilizar el espacio de trabajo ``«default»``, la puedes omitir. - -.. code-block:: bash - - app/console doctrine:phpcr:workspace:create sandbox - -Una vez configurado tu espacio de trabajo, debes `registrar los tipos de nodo `_ para el *phpcr-odm*: - -.. code-block:: bash - - app/console doctrine:phpcr:register-system-node-types - -Importando accesorios -~~~~~~~~~~~~~~~~~~~~~ - -La interfaz de administración sigue en una etapa temprana. Hasta que mejore, lo más fácil es crear los datos programáticamente. La mejor manera de hacerlo es con los accesorios de *Doctrine*. El ``DoctrinePHPCRBundle`` incluido en el repositorio ``symfony-cmf`` proporciona una orden para cargar accesorios. - -.. code-block:: bash - - app/console -v doctrine:phpcr:fixtures:load - -Ejecuta esta orden para cargar los accesorios desde el ``MainBundle`` del recinto de seguridad, la cual poblará tu repositorio con datos maniquí, es decir, carga las páginas ``demo``. - -Accediendo a tu recinto de seguridad -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -El recinto de seguridad ahora debería ser accesible en tu servidor *web*. - -.. code-block:: text - - http://localhost/app_dev.php - -Para ejecutar el recinto de seguridad en modo de producción necesitas generar los delegados de *Doctrine* y volcar los activos de ``assetic``: - -.. code-block:: text - - app/console cache:warmup --env=prod --no-debug - app/console assetic:dump --env=prod --no-debug - - -Mecanismos de almacenamiento alternativo ----------------------------------------- - -El ``CMF`` de *Symfony* y el recinto de seguridad son de almacenamiento agnóstico, lo cual significa que puedes cambiar el mecanismo de almacenamiento sin tener que cambiar tu código. El mecanismo de almacenamiento predefinido para el recinto de seguridad es ``Jackalope`` + *Apache* ``Jackrabbit``, puesto que es la configuración más probada y estable. Sin embargo, hay otras alternativas disponibles. - -``Jackalope`` + *DBAL* de *Doctrine* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -.. note:: - - De manera predeterminada, cuándo utilizas el *DBAL* de *Doctrine*, los datos se almacenan utilizando una base de datos `Sqlite `_. - Revisa la página del proyecto para instrucciones de instalación. - Si deseas utilizar otros sistemas de base de datos, cambia los parámetros de configuración en el archivo :file:`app/config/parameters.yml`. Consulta la página sobre la `configuración del DBAL de Doctrine en Symfony `_ o la `documentación de Doctrine `_ para más información. - -Ve al directorio del recinto de seguridad y copia el archivo de configuración predefinido para -configurar el *DBAL* de *Doctrine*: - -.. code-block:: bash - - cd cmf-sandbox - cp app/config/phpcr_doctrine_dbal.yml.dist app/config/phpcr.yml - -Luego, debes instalar el paquete *DBAL* de *Doctrine* real requerido por ``jackalope``: - -.. code-block:: bash - - php composer.phar require jackalope/jackalope-doctrine-dbal:dev-master - -Y crea e inicia tu base de datos: - -.. code-block:: bash - - app/console doctrine:database:create - app/console doctrine:phpcr:init:dbal - -Después de esto, deberías seguir los pasos en `Preparando el repositorio PHPCR`_. - -Memorizando en caché con *Doctrine* -+++++++++++++++++++++++++++++++++++ - -Opcionalmente, para mejorar el rendimiento y habilitar los metadatos, puedes instalar ``LiipDoctrineCacheBundle`` -escribiendo la siguiente orden: - -.. code-block:: bash - - php composer.phar require liip/doctrine-cache-bundle:dev-master - -Y añade la siguiente entrada a tu archivo :file:`app/AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - public function registerBundles() - { - $bundles = array( - // ... - new Liip\DoctrineCacheBundle\LiipDoctrineCacheBundle(), - // ... - ); - } - -Finalmente descomenta las opciones de caché en el archivo :file:`phpcr.yml` así como las de ``liip_doctrine_cache`` en el archivo :file:`config.yml`. - -.. code-block:: yaml - - # app/config/phpcr.yml - caches: - meta: liip_doctrine_cache.ns.meta - nodes: liip_doctrine_cache.ns.nodes - -.. code-block:: yaml - - # app/config/config.yml - - # memorización con jackalope en doctrine - liip_doctrine_cache: - namespaces: - meta: - type: file_system - nodes: - type: file_system - -Proveyendo *PHPCR* para *Midgard2* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Si quieres correr el recinto de seguridad del ``CMF`` con el proveedor `PHPCR de Midgard2 `_ en vez de ``Jackrabbit``, necesitas instalar la extensión ``midgard2`` de *PHP*. -En sistemas *Debian/Ubuntu* actuales, esto se hace simplemente con: - -.. code-block:: bash - - sudo apt-get install php5-midgard2 - -En *OS X* lo puedes instalar utilizando cualquier `Homebrew `_ con: - -.. code-block:: bash - - brew install midgard2-php - -o `MacPorts `_ con - -.. code-block:: bash - - sudo port install php5-midgard2 - -También necesitas descargar los archivos de esquema `midgard_tree_node.xml `_ y `midgard_namespace_registry.xml `_, y colocarlos en «/schema» (por omisión en ``«/usr/share/midgard2/schema»``). - -Para instalar la implementación del *phpcr* de ``midgard`` ejecuta la siguiente orden adicional: - -.. code-block:: bash - - php composer.phar require midgard/phpcr:dev-master - -Finalmente, cambia uno de los archivos de configuración de ``Midgard2``: - -.. code-block:: bash - - cp app/config/phpcr_midgard_mysql.yml.dist app/config/phpcr.yml - -o - -.. code-block:: bash - - cp app/config/phpcr_midgard_sqlite.yml.dist app/config/phpcr.yml - -Después de esto, deberías seguir los pasos en `Preparando el repositorio PHPCR`_ para continuar el proceso de instalación. \ No newline at end of file diff --git a/cmf/html/_sources/cookbook/phpcr-odm-custom-documentclass-mapper.txt b/cmf/html/_sources/cookbook/phpcr-odm-custom-documentclass-mapper.txt deleted file mode 100644 index dfe994f..0000000 --- a/cmf/html/_sources/cookbook/phpcr-odm-custom-documentclass-mapper.txt +++ /dev/null @@ -1,34 +0,0 @@ -Usando una clase documento personalizada asociada con *PHPCR-ODM* -================================================================= - -El asignador predefinido para la clase ``document`` *PHPCR-ODM* utiliza el atributo ``phpcr:class`` para almacenar y recuperar la clase ``documento`` de un nodo. Cuándo accedes a un repositorio *PHPCR* existente, podrías necesitar diferente lógica para decidir en la clase. - -Puedes extender el ``DocumentClassMapper`` o implementar la ``DocumentClassMapperInterface`` desde el principio. Los métodos importantes son ``getClassName`` que se necesita para encontrar el nombre de clase y ``writeMetadata`` que se necesita para garantizar que la clase de un nuevo documento almacenado se puede determinar al cargarlo de nuevo. - -Luego, puedes sustituir el servicio ``doctrine.odm_configuration`` para llamar a ``setDocumentClassMapper`` en él. Un ejemplo del `recinto de seguridad del CMF de Symfony`_ (rama de magnolia_integration): - -.. configuration-block:: - - .. code-block:: yaml - - # Resources/config/services.yml - - # Si quieres sobrescribir la configuración predefinida, de lo contrario utiliza - # un nombre personalizado y pónlo en el bloque de configuración del odm - - doctrine.odm_configuration: - class: %doctrine_phpcr.odm.configuration.class% - calls: - - [ setDocumentClassMapper, [@sandbox_magnolia.odm_mapper] ] - - sandbox_magnolia.odm_mapper: - class: "Sandbox\MagnoliaBundle\Document\MagnoliaDocumentClassMapper" - arguments: - - 'standard-templating-kit:pages/stkSection': 'Sandbox\MagnoliaBundle\Document\Section' - -Aquí creamos una asociación que usa una configuración para leer información del nodo y se asocia a una clase ``documento``. - -Si tienes varios repositorios, puedes usar una configuración por repositorio. -Ve :ref:`multiple-phpcr-sessions`. - -.. _`recinto de seguridad del CMF de Symfony`: https://github.com/symfony-cmf/cmf-sandbox/tree/magnolia_integration \ No newline at end of file diff --git a/cmf/html/_sources/cookbook/using-a-custom-route-repository.txt b/cmf/html/_sources/cookbook/using-a-custom-route-repository.txt deleted file mode 100644 index 2b3666a..0000000 --- a/cmf/html/_sources/cookbook/using-a-custom-route-repository.txt +++ /dev/null @@ -1,88 +0,0 @@ -Usando un repositorio de rutas personalizado con un enrutador dinámico -====================================================================== - -El enrutador dinámico te permite personalizar la ruta al repositorio (es decir, la clase responsable de recuperar rutas desde la base de datos), y por extensión, los objetos ``Ruta``. - -Creando el repositorio de rutas -------------------------------- - -El repositorio de rutas tiene que implementar la `RouteRepositoryInterface`. La siguiente clase proporciona una solución sencilla que utiliza un repositorio *ODM*. - -.. code-block:: php - - findOneBy(array( - 'url' => $url, - )); - - $pattern = $myDocument->getUrl(); // p. ej. "/esta/es/una/url" - - $collection = new RouteCollection(); - - // crea una nueva ruta y pone nuestro documento como - // predefinido (a modo de que lo podamos recuperar desde la petición) - $route = new SymfonyRoute($ep->getPath(), array( - 'document' => $document, - )); - - // Añade la ruta al RouteCollection usando - // como clave un ID único. - $collection->add('my_route_'.uniqid(), $route); - - return $collection; - } - - // este método se usa para generar URL, p. ej. {{ path('foobar') }} - public function getRouteByName($name, $params = array()) - { - $document = $this->findOneBy(array( - 'name' => $name, - )); - - if ($route) { - $route = new SymfonyRoute($route->getPattern(), array( - 'document' => $document, - )); - } - - return $route; - } - } - -.. tip:: - - Como posiblemente hayas notado regresamos un objeto `RouteCollection` --- ¿porqué no regresamos una sola ``Ruta``? El enrutador dinámico nos permite regresar muchas rutas *candidatas*, en otras palabras, rutas que *podrían* emparejar con la *URL* entrante. Esto es importante para habilitar la posibilidad de emparejar rutas *dinámicas*, `/page/{page_id}/edit` por ejemplo. - En nuestro ejemplo emparejamos las *URL* dadas exactamente y siempre regresar únicamente una sola ``Ruta``. - -Reemplazando el repositorio predefinido del *CMF* -------------------------------------------------- - -Para reemplazar el `RouteRepository` predefinido es necesario modificar tu configuración -de la siguiente manera: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - dynamic: - enabled: true - route_repository_service_id: my_bundle.repository.endpoint - -Donde `my_bundle.repository.endpoint` es el ID del servicio de tu repositorio. -Ve `Creando y configurando servicios en el contenedor `_ para información sobre la creación de servicios personalizados. diff --git a/cmf/html/_sources/getting-started/installing-symfony-cmf.txt b/cmf/html/_sources/getting-started/installing-symfony-cmf.txt deleted file mode 100644 index 76c96fb..0000000 --- a/cmf/html/_sources/getting-started/installing-symfony-cmf.txt +++ /dev/null @@ -1,96 +0,0 @@ -Instalando la edición estándar del ``CMF`` de *Symfony* -======================================================= - -El objetivo de esta guía es instalar todos los componentes del ``CMF`` con la configuración mínima necesaria y algunos muy sencillos ejemplos en una aplicación *Symfony2* en funcionamiento. Esto se suele usar para familiarizarte con el ``CMF`` o para utilizarlo como punto de partida para personalizar una nueva aplicación. - -Si este es tu primer encuentro con el ``CMF`` de *Symfony* sería buena idea darle un vistazo primero a: - -- `El concepto `_ -- La demostración en línea del recinto de seguridad en `cmf.liip.ch `_ - -.. note:: - - Para otras guías de instalación del ``CMF`` de *Symfony*, por favor, consulta: - - El artículo :doc:`../cookbook/installing-cmf-sandbox` en el recetario para instrucciones sobre cómo instalar un ejemplo de una demostración más completa del ``CMF`` de *Symfony*. - - :doc:`../tutorials/installing-cmf-core` para instrucciones de instalación paso a paso y detalles de configuración de los componentes necesarios del núcleo en una aplicación de *Symfony* existente. - -.. index:: Edición estándar, instalando - -Requisitos previos ------------------- - -Debido a que el ``CMF`` de *Symfony* está basado en *Symfony2*, deberías asegurarte de que cubres los `Requisitos para que funcione Symfony2 `_. -Además, necesitas tener instalada la extensión *PDO* de `SQLite `_ (``pdo_sqlite``), puesto que esta se utiliza como el medio de almacenamiento predeterminado. - -.. note:: - - De manera predeterminada, el ``CMF`` de *Symfony* utiliza *Jackalope* + *DBAL* de *Doctrine* y *SQLite* como *BD* subyacente. No obstante, el ``CMF`` de *Symfony* es de almacenamiento agnóstico, lo cual significa que puedes utilizar uno de varios mecanismos de almacenamiento de datos disponibles sin tener que reescribir tu código. Para más información en los diferentes mecanismos disponibles y cómo instalarlos y configurarlos, consulta el :doc:`../tutorials/installing-configuring-doctrine-phpcr-odm` - -`Git `_ y `Curl `_ también son necesarios para seguir los pasos de instalación enumerados más adelante. - - -Instalando ----------- - -La manera más fácil de instalar el ``CMF`` de *Symfony* es utilizando `Composer `_. -Consíguelo usando: - -.. code-block:: bash - - curl -s http://getcomposer.org/installer | php -- - -Y luego consigue el código del ``CMF`` de *Symfony* con él (esto puede tomar un buen rato) - -.. code-block:: bash - - php composer.phar create-project symfony-cmf/standard-edition ↓ - --stability=dev - mv composer.phar /. - cd - -.. note:: - - En realidad es recomendable mover :file:`composer.phar` al directorio :file:`bin` de tu sistema de archivos, con el fin de que puedas acceder a la orden desde cualquier directorio. - -La ```` debe estar dentro del directorio raíz de tu servidor *web* o tienes que configurar un anfitrión virtual para ````. - -Esto clonará la edición estándar e instalará todas las dependencias y ejecutará algunas órdenes iniciales. -Estas órdenes requieren permisos de escritura en los directorios :file:`app/cache` y :file:`app/logs`. En caso de que al final las órdenes terminen dando errores de permisos, por favor sigue las `directrices en la documentación oficial `_ para configurar los permisos y luego ejecuta la orden ``composer.phar install`` mencionada abajo. - -Si lo prefieres, también puedes clonar el proyecto directamente: - -.. code-block:: bash - - git clone git://github.com/symfony-cmf/symfony-cmf-standard.git - cd - -Si ocurrieron problemas durante la orden ``create-project``, o si utilizaste ``git clone`` o si después activaste una versión anterior (con ``checkout``), siempre ejecuta la siguiente orden para actualizar las dependencias: - -.. code-block:: bash - - php composer.phar install - -El siguiente paso es configurar la base de datos, si quieres usar *SQLite* como tu servidor de base de datos sólo continúa y ejecuta las siguientes ordenes: - -.. code-block:: bash - - app/console doctrine:database:create - app/console doctrine:phpcr:init:dbal - app/console doctrine:phpcr:register-system-node-types - app/console doctrine:phpcr:fixtures:load - -Esto creará un archivo llamado :file:`app.sqlite` dentro de tu directorio :file:`app`, el cual contiene la base de datos. - -El proyecto ahora tendría que estar accesible en tu servidor *web*. Si tienes instalado *PHP 5.4*, alternativamente puedes utilizar el servidor *web* interno de *PHP*: - -.. code-block:: bash - - app/console server:run - -Y entonces accede al ``CMF`` vía: - -.. code-block:: text - - http://localhost:8000 - -Si prefieres utilizar otro servidor de base de datos, por ejemplo *MySQL*, ejecuta el configurador (apunta tu navegador a ``/web/config.php``) o configura tus parámetros de conexión a la base de datos en el archivo :file:`app/config/parameters.yml`. Asegúrate de dejar la propiedad ``database_path`` en ``null`` para utilizar otro controlador distinto a *SQLite*. Dejar el campo en blanco en el configurador *web* lo debería poner a ``null``. diff --git a/cmf/html/_sources/getting-started/overview.txt b/cmf/html/_sources/getting-started/overview.txt deleted file mode 100644 index cce2759..0000000 --- a/cmf/html/_sources/getting-started/overview.txt +++ /dev/null @@ -1,21 +0,0 @@ -Información general -=================== - -Esta guía te ayudará a entender las partes básicas del ``CMF`` de *Symfony* y cómo trabajan juntas para proporcionar las páginas predefinidas que puedes ver al explorar la instalación de la Edición estándar del ``CMF`` de *Symfony* (*EE*). - -Esta asume que ya has instalado el ``CMF`` de *Symfony* y leído cuidadosamente el libro de *Symfony2*. - -``AcmeMainBundle`` y ``SimpleCMSBundle`` ----------------------------------------- - -La *EE* del ``CMF`` de *Symfony* viene con un ``AcmeMainBundle`` predefinido para ayudarte a empezar, en una manera similar al ``AcmeDemoBundle`` que tiene *Symfony2*, proporcionándote algunas páginas de demostración visibles en tu navegador. Sin embargo, el ``AcmeMainBundle`` no incluye controladores o archivos de configuración, como probablemente esperarías. Este contiene poco más que un archivo *Twig* y datos `Accesorios `_, que fueron cargados a tu base de datos durante la instalación. - -Hay varios paquetes trabajando juntos para convertir los datos accesorios en un sitio web navegable. El proceso global simplificado, es el siguiente: - -- Al recibir una petición, :doc:`/components/routing` del ``CMF`` de *Symfony*, el Enrutador dinámico se usa para manejar la petición entrante. -- El Enrutador dinámico es capaz de emparejar la *URL* solicitada con el contenido de un ``ContentBundle`` específico almacenado en la base de datos. -- La información del contenido recuperado se usa para determinar a cuál controlador pasarlo, y qué plantilla utilizar. -- Tal cual esté configurado, el contenido recuperado se pasa al ``ContentController`` del ``ContentBundle``, el cual lo manejará y reproducirá la plantilla :file:`layout.html.twig` del ``AcmeMainBundle``. - - Una vez más, esto es un vistazo simplificado de un muy sencillo *CMS* construido en lo alto del ``CMF`` de *Symfony*. - Para entender completamente todas las posibilidades del ``CMF``, es necesario darle un muy cuidadoso vistazo a cada componente. \ No newline at end of file diff --git a/cmf/html/_sources/index.txt b/cmf/html/_sources/index.txt deleted file mode 100644 index 351e0a3..0000000 --- a/cmf/html/_sources/index.txt +++ /dev/null @@ -1,118 +0,0 @@ -Documentación del ``CMF`` de *Symfony* -====================================== - -Bienvenido a la documentación oficial del `Symfony Content Management Framework`_ (``CMF`` en adelante). - -El proyecto ``CMF`` de *Symfony2* está organizado por la comunidad de *Symfony* y cuenta con muchas compañías patrocinadoras y prominentes líderes del código abierto que implementan la filosofía del `CMS desacoplado`_. Puedes leer y aprender más del proyecto en su página de `información`_. - -Esta documentación actualmente está en desarrollo y todavía muy lejos de completarse. Ve `planificación de la documentación`_ para un vistazo general del trabajo que falta hacer. ¿Quieres ayudar? ¡Gracias, toda ayuda es muy apreciada! -La fuente de `la documentación está alojada en github`_. - -Declaración de misión ---------------------- - - El proyecto ``CMF`` de *Symfony* facilita a los desarrolladores la adición de funcionalidad *CMS* a sus aplicaciones construidas con la plataforma *Symfony2* de *PHP*. Los principios de desarrollo clave para el conjunto de paquetes proporcionados son la escalabilidad, usabilidad, documentación y un completo banco de pruebas. - -¿Por qué otro *CMS*? --------------------- - -De hecho, consideramos que este proyecto es un ``CMF`` (por **content management framework**) un **marco para gestionar contenido**, más que -un *CMS* (sistema de administración de contenido). La razón es que sólo estamos **proporcionando herramientas para construir un CMS personalizado**. Evidentemente hoy día existen muchas soluciones *CMS* disponibles, pero tienden a ser adaptadas en primer lugar hacia usuarios finales y también muchas tienden -a llevar mucho equipaje delegado que las hace menos que **ideales para desarrollar aplicaciones altamente personalizables** tal como es posible con `Symfony2`_. - -¿A quién está destinado? ------------------------------------ - -Básicamente está destinado a las siguientes audiencias principalmente: - -#. Desarrolladores que están construyendo una aplicación personalizada con *Symfony2* y además necesitan compatibilidad para la administración de contenido. Con sofisticadas características del *CMS* tal como contenido semántico, edición en línea, entrega en multicanal, etc., o unas cuantas páginas de contenido para cosas como las páginas de contacto o información adicional. - -#. Desarrolladores que necesitan construir una solución de autoría y etrega de contenido altamente personalizada que ningún *CMS* fuera de la caja puede proporcionar correctamente a través de personalización. - - -Cómo empezar ------------- - -¿Empiezas a conocer el ``CMF``? ¿Quieres saber si el ``CMF`` es adecuado para tu proyecto? Comienza aquí. - -.. toctree:: - :maxdepth: 1 - - getting-started/installing-symfony-cmf - getting-started/overview - - -Guías rápidas -------------- - -¿Quieres saber más sobre el ``CMF`` y cómo puedes configurar cada parte? Hay una guía para cada una de ellas. - -.. toctree:: - :maxdepth: 1 - - tutorials/installing-cmf-core - tutorials/choosing-a-storage-layer - tutorials/installing-configuring-doctrine-phpcr-odm - tutorials/installing-configuring-simple-cms - tutorials/installing-configuring-inline-editing - tutorials/creating-cms-using-cmf-and-sonata - tutorials/using-blockbundle-and-contentbundle - -Paquetes --------- - -¿Buscando algúna información detallada sobre un paquete del ``CMF``? ¿Quieres una lista de todas las opciones de configuración de un paquete? ¿Quiere saber si puedes utilizar un paquete independientemente y cómo hacerlo? La referencia es el sitio correcto para encontrarlo. - -.. toctree:: - :maxdepth: 1 - - bundles/block - bundles/content - bundles/core - bundles/create - bundles/phpcr-odm - bundles/menu - bundles/routing-extra - bundles/search - bundles/simple-cms - bundles/doctrine_phpcr_admin - bundles/tree - bundles/tree-browser - -Recetario ---------- - -Soluciones específicas para necesidades especiales que van más allá del uso estándar. - -.. toctree:: - :maxdepth: 1 - - cookbook/phpcr-odm-custom-documentclass-mapper - cookbook/using-a-custom-route-repository - cookbook/installing-cmf-sandbox - -Componentes ------------ - -¿Buscando alguna información sobre los componentes de bajo nivel del ``CMF``? - -.. toctree:: - :maxdepth: 1 - - components/routing - -Colaborando ------------ - -.. toctree:: - :maxdepth: 1 - - contributing/code - contributing/license - -.. _`CMS desacoplado`: http://http://decoupledcms.org -.. _`Symfony2`: http://symfony.com -.. _`información`: http://cmf.symfony.com/about -.. _`planificación de la documentación`: https://github.com/symfony-cmf/symfony-cmf/wiki/Documentation-Planning -.. _`Symfony Content Management Framework`: http://cmf.symfony.com -.. _`la documentación está alojada en github`: https://github.com/symfony-cmf/symfony-cmf-docs diff --git a/cmf/html/_sources/tutorials/choosing-a-storage-layer.txt b/cmf/html/_sources/tutorials/choosing-a-storage-layer.txt deleted file mode 100644 index 2b84751..0000000 --- a/cmf/html/_sources/tutorials/choosing-a-storage-layer.txt +++ /dev/null @@ -1,85 +0,0 @@ -Eligiendo una capa de almacenamiento -==================================== - -Cuándo construyes un *CMS*, sin duda, la elección para la capa de almacenamiento es una de las decisiones clave a tomar. Tienes que considerar muchos factores, la buena noticia es que con todos los componentes y paquetes en el ``CMF`` nos preocupamos en proporcionar los puntos de extensión necesarios para garantizar que contamos con una **capa de almacenamiento que sigue siendo agnóstica para el CMF**. - -El objetivo de esta guía es explicar las consideraciones y por qué sugerimos `PHPCR `_ y `PHPCR-ODM `_ como la base ideal para un *CMS*. Sin embargo, todos los componentes y paquetes se pueden integrar con otras soluciones con un muy pequeño esfuerzo. - -.. index:: PHPCR, ODM, ORM - -Requisitos para la capa de almacenamiento de un *CMS* -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -Al nivel más fundamental de un *CMS* está el almacenamiento, por lo tanto el primer requisito de un *CMS* es que debe proporcionar los medios para almacenar contenido con diferentes propiedades. - -Un *CMS* tiene muy diferentes necesidades de almacenamiento que por ejemplo un sistema para procesar órdenes. -Aun así observa que es enteramente posible y de hecho así se pretende que la iniciativa del ``CMF`` habilite a los desarrolladores para combinar el ``CMF`` con un sistema para procesar órdenes. Así por ejemplo, uno podría crear una solución de compra utilizando el ``CMF`` para almacenar el catalogo de productos, mientras utilizas otro sistema para mantener el inventario, datos del cliente y pedidos. Esto da lugar al segundo requisito, *un CMS debe proporcionar los medios para referenciar el contenido*, almacenando ambos dentro del *CMS*, pero también en otros sistemas. - -El contenido real en un *CMS* tiende a estar organizado en una estructura de árbol, imitando un sistema de archivos. Ten en cuenta que los autores de contenido podrían querer utilizar diferentes estructuras para organizar el contenido y para organizar otros aspectos como el menú y el enrutado. -Esto nos lleva al tercer requisito, *un CMS debe proporcionar los medios para representar el contenido como una estructura de árbol*. -Además, un cuarto requisito es que *un CMS debería permitir mantener varias estructuras de árbol independientes*. - -En general, los datos dentro de un *CMS* tienden a no estar estructurados. Si bien, varias páginas dentro del *CMS* podrían ser muy similares, hay una buena posibilidad de que habría muchas permutaciones que necesitarían diferentes campos extra, por lo tanto *un CMS no tiene que aplicar un esquema singular al contenido*. -Dicho esto, a fin de mantener mejor la estructura y contenido de las capas de la interfaz de usuario que genéricamente permiten la visualización de elementos de contenido, es importante ser capaz de expresar reglas opcionales que se deben seguir y que también pueden ayudar a anexar significado semántico adicional. Así que *un CMS debe proporcionar los medios para opcionalmente definir elementos del esquema de contenido*. - -Este requisito en realidad también está relacionado a otra necesidad, en que un *CMS* debe facilitar a los autores de contenido la preparación de una serie de cambios en un entorno de ensayo que luego se tiene que enviar al sitio vivo en un solo paso. Esto significa que es otro requisito en que es necesario que *un CMS debe apoyar el movimiento y exportación de contenido entre estructuras de árbol independientes*. -Ten en cuenta que la exportación puede ser útil también para las copias de seguridad. - -Al realizar cambios en ella sin embargo también sería útil poder versionar los conjuntos cambiados, de manera que permanezcan disponibles para fines históricos, pero también para poder revertirlos cuando sea necesario. Por lo tanto, el siguiente requisito es que un *CMS debería proporcionar la habilidad de versionar el contenido*. - -Puesto que vivimos en un mundo globalizado, los sitios web deben ofrecer contenido en múltiples idiomas abarcando diferentes regiones. No obstante no todas las piezas del contenido se deben traducir y eventualmente sólo algunas se deberían traducir, pero hasta entonces se le debe presentar al usuario el contenido en uno de los idiomas disponibles, por lo que *un CMS debería proporcionar la capacidad de almacenar el contenido en diferentes idiomas, con opcionales reglas alternativas*. - -Puesto que generalmente un *CMS* tiende a almacenar una creciente cantidad de contenido será necesario proporcionar alguna forma para que los usuarios busquen contenido, incluso, cuando el usuario sólo tiene una muy difusa idea sobre el contenido que está buscando, dando lugar al requisito de que *un CMS debe proporcionar completa capacidad de búsqueda de texto*, idealmente, aprovechando tanto la estructura del árbol de contenido como el esquema de datos. - -Otra necesidad popular es limitar la lectura y/o escritura de contenido a usuarios o grupos específicos. Idealmente, esta solución también se podría integrar con la estructura de árbol. Por lo que debería ser útil que *un CMS ofreciera funciones para definir el control de acceso que aproveche la estructura de árbol para gestionar rápidamente el acceso a subárboles completos*. - -Por último, no todos los pasos del proceso de creación de contenido los llevará a cabo la misma persona. -De hecho, puede haber múltiples pasos, todos los cuales no los debería llevar a cabo una sola persona. En cambio algunos de los pasos incluso los podría ejecutar una máquina. Así, por ejemplo un fotógrafo puede cargar una nueva imagen, un autor de contenido puede adjuntar la foto a algún texto, entonces el sistema automáticamente genera miniaturas y optimiza la interpretación en la *web*, y finalmente, un editor decide sobre la publicación final. Por lo tanto *un CMS debe proporcionar la capacidad para ayudar en la gestión del flujo de trabajo*. - -Resumen -------- - -Aquí tienes un resumen de los requisitos anteriores. Ten en cuenta que algunos de los requisitos tienen un *debe*, mientras otros sólo tienen un *debería*. Evidentemente dependiendo de tu caso de uso podrías priorizar las características de manera diferente: - -* Un *CMS* debe proporcionar un medio para almacenar contenido con diferentes propiedades -* Un *CMS* debe proporcionar un medio para referirse al contenido -* Un *CMS* debe proporcionar un medio para representar el contenido como una estructura de árbol -* Un *CMS* debe proporcionar completa capacidad de búsqueda de texto -* Un *CMS* no debería aplicar un esquema singular para el contenido -* Un *CMS* debe proporcionar los medios para opcionalmente definir un esquema para elementos del contenido -* Un *CMS* debería permitir mantener varias estructuras de árbol independientes -* Un *CMS* debería ser compatible con el movimiento y exportación de contenido entre estructuras de árbol independientes -* Un *CMS* debería proporcionar la habilidad para tener contenido versionado -* Un *CMS* debería proporcionar la habilidad de almacenar contenido en diferentes idiomas, con opcionales reglas alternativas -* Un *CMS* debe proporcionar la capacidad para definir controles de acceso -* Un *CMS* debería proporcionar la capacidad para asistir en la administración de los flujos de trabajo - -*RDBMS* -~~~~~~~ - -Viendo los requisitos anteriores se pone de manifiesto que fuera de la caja un *RDBMS* es el instrumento adecuado para hacer frente a las necesidades de un *CMS*. Los *RDBMS* nunca tuvieron la intención de almacenar estructuras de árbol de contenido no estructurado. Realmente el único requisito que cubre el *RDBMS* de la lista anterior es la capacidad de almacenar contenido, alguna manera para hacer referencia al contenido, mantener múltiples estructuras de contenido independientes y un nivel básico de control de acceso y disparadores. - -Este no es un defecto del *RDBMS* en el sentido de que fueron diseñados simplemente para un caso de uso diferente: la capacidad de almacenar, manipular y agregar datos estructurados. Esto las hace ideales para el almacenamiento de inventarios y pedidos. - -Lo cual no quiere decir que es imposible construir un sistema en lo alto de un *RDBMS* que se ocupe de algunos o incluso la totalidad de los temas anteriores. Algunos *RDBMS* nativamente soportan consultas recursivas, lo cual puede ser útil para recuperar las estructuras de árbol. Incluso si falta tal soporte nativo, hay algoritmos como camino materializado y conjuntos anidados que pueden permitir un eficiente almacenamiento y recuperación de estructuras de árbol para diferentes casos de uso. - -El punto es, sin embargo, que se requieren estos algoritmos y código en lo alto de un *RDBMS* que también se vinculen a la lógica de negocio con un determinado *RDBMS* y/o algoritmo, aunque algunos de ellos se pueden abstraer. Así que de nuevo usando un *ORM* podrías crear un sistema para gestionar las estructuras de árbol con diferentes algoritmos que impidan la unión de la lógica de negocio del *CMS* a un algoritmo particular. - -Sin embargo hay que decir una vez más, que todos los paquetes y componentes del ``CMF`` se han desarrollado para aceptar cualquier *API* de almacenamiento persistente y damos la bienvenida a las contribuciones para agregar implementaciones para otros sistemas de almacenamiento. Así, por ejemplo actualmente ``RoutingExtraBundle`` sólo ofrece clases de documento para el *ODM* de *PHPCR*, pero las interfaces definidas en el componente de enrutado son de almacenamiento agnóstico y aceptaríamos una contribución para añadir soporte al *ORM* de *Doctrine*. - -*PHPCR* -~~~~~~~ - -Esencialmente *PHPCR* es un conjunto de interfaces para abordar la mayoría de los requisitos de la lista anterior. -Esto significa que *PHPCR* es totalmente independiente del almacenamiento en el sentido de que es posible realmente poner cualquier solución de persistencia detrás de *PHPCR*. Así pues, en la misma forma que un *ORM* puede soportar diferentes algoritmos de almacenamiento de árbol a través de algún complemento, *PHPCR* tiene como objetivo proporcionar una *API* para relajar completamente las necesidades del *CMS*, por lo tanto separando limpiamente toda la lógica del negocio de tu *CMS* a causa de la elección de persistencia. Como asunto natural, la única de las características anteriores no soportada nativamente por *PHPCR* es el apoyo para las traducciones. - -Gracias a la disponibilidad de varias implementaciones de *PHPCR* que apoyan diversos tipos de opciones de persistencia, la creación de un *CMS* en lo alto de *PHPCR* significa que los usuarios finales tienen la capacidad de escoger y elegir lo que funciona mejor para ellos, sus recursos, su experiencia y sus necesidades de escalabilidad. - -Así que para los casos de uso más simples por ejemplo está una solución basada en el *DBAL* de *Doctrine* ofrecida por la implementación *PHPCR* de `Jackalope `_ que puede utilizar el *RDBMS* de *SQLite* que viene con *PHP*. En el otro extremo del espectro ``Jackalope`` también es compatible con `Jackrabbit `_ el cual apoya las agrupaciones y puede manejar eficientemente los datos en cientos de gigabytes. De manera predeterminada ``Jackrabbit`` simplemente utiliza el sistema de archivos para la persistencia, pero también puede utilizar un *RDBMS*. Sin embargo, futuras versiones apoyarán a *MongoDB* y otras soluciones *NoSQL* como *CouchDB* o *Cassandra* es totalmente posible. Una vez más, el cambio de la solución de persistencia no requerirá cambios en el código puesto que la lógica de negocio sólo va unida a las interfaces *PHPCR*. - -Por favor ve :doc:`installing-configuring-doctrine-phpcr-odm` para más detalles sobre las implementaciones *PHPCR* disponibles y sus requisitos y la forma de configurar *Symfony2* con una de ellas. - -*ODM* de *PHPCR* -~~~~~~~~~~~~~~~~ - -Cuando mencione arriba utilizar *PHPCR* no significa renunciar a un *RDBMS*. En muchas maneras, puedes considerar a *PHPCR* una solución *ORM* especializada para *CMS*. No obstante, mientras *PHPCR* trabaja con los así llamados *nodos*, en un *ORM* las personas esperan ser capaces de asignar instancias de clase a una capa de persistencia. Esto, exactamente es lo que proporciona el *ODM* de *PHPCR*. Sigue las mismas clases de interfaz del *ORM* de *Doctrine* al mismo tiempo que expone todas las capacidades adicionales de *PHPCR*, como los árboles y el versionado. Por otra parte, también ofrece soporte nativo para traducciones, que cubren la única omisión del *PHPCR* de la lista de requisitos para una solución de almacenamiento de un *CMS* mencionada anteriormente. diff --git a/cmf/html/_sources/tutorials/creating-cms-using-cmf-and-sonata.txt b/cmf/html/_sources/tutorials/creating-cms-using-cmf-and-sonata.txt deleted file mode 100644 index b9df170..0000000 --- a/cmf/html/_sources/tutorials/creating-cms-using-cmf-and-sonata.txt +++ /dev/null @@ -1,161 +0,0 @@ -Creando un *CMS* con ``CMF`` y *Sonata* -======================================= - -El objetivo de esta guía es crear un sistema de administración de contenido sencillo que utiliza el ``CMF`` así como `SonataAdminBundle `_ y :doc:`../bundles/doctrine_phpcr_admin`. - - -.. index:: Sonata, SonataAdminBundle, SonataDoctrinePHPCRAdminBundle, SonatajQueryBundle, FOSJsRoutingBundle, TreeBundle, TreeBrowserBundle - -Requisitos previos ------------------- - -- :doc:`installing-cmf-core` - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "sonata-project/doctrine-phpcr-admin-bundle": "1.0.*", - } - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en el archivo :file:`app/AppKernel.php` añadiéndolos al método ``registerBundles``: - -.. code-block:: php - - public function registerBundles() - { - $bundles = array( - // ... - - // soporte para el admin - new Symfony\Cmf\Bundle\TreeBundle\SymfonyCmfTreeBundle(), - new Symfony\Cmf\Bundle\TreeBrowserBundle\SymfonyCmfTreeBrowserBundle(), - new Sonata\jQueryBundle\SonatajQueryBundle(), - new Sonata\AdminBundle\SonataAdminBundle(), - new Sonata\BlockBundle\SonataBlockBundle(), - new Sonata\DoctrinePHPCRAdminBundle\SonataDoctrinePHPCRAdminBundle(), - new FOS\JsRoutingBundle\FOSJsRoutingBundle(), - ); - // ... - } - -Configurando ------------- - -Añade los paquetes de ``sonata`` a la configuración de tu aplicación - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_block: - default_contexts: [cms] - blocks: - sonata.admin.block.admin_list: - contexts: [admin] - sonata_admin_doctrine_phpcr.tree_block: - settings: - id: '/cms' - contexts: [admin] - - sonata_admin: - templates: - # plantillas globales predefinidas - ajax: SonataAdminBundle::ajax_layout.html.twig - dashboard: - blocks: - # muestra un bloque panel - - { position: right, type: sonata.admin.block.admin_list } - - { position: left, type: sonata_admin_doctrine_phpcr.tree_block } - - sonata_doctrine_phpcr_admin: - document_tree: - Doctrine\PHPCR\Odm\Document\Generic: - valid_children: - - all - Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page: ~ - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route: - valid_children: - - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route - - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute: - valid_children: [] - Symfony\Cmf\Bundle\MenuBundle\Document\MenuItem: - valid_children: - - Symfony\Cmf\Bundle\MenuBundle\Document\MenuItem - - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuItem - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuItem: - valid_children: - - Symfony\Cmf\Bundle\MenuBundle\Document\MenuItem - - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuItem - - fos_js_routing: - routes_to_expose: - - admin_sandbox_main_editablestaticcontent_create - - admin_sandbox_main_editablestaticcontent_delete - - admin_sandbox_main_editablestaticcontent_edit - - admin_bundle_menu_menuitem_create - - admin_bundle_menu_menuitem_delete - - admin_bundle_menu_menuitem_edit - - admin_bundle_menu_multilangmenuitem_create - - admin_bundle_menu_multilangmenuitem_delete - - admin_bundle_menu_multilangmenuitem_edit - - admin_bundle_content_multilangstaticcontent_create - - admin_bundle_content_multilangstaticcontent_delete - - admin_bundle_content_multilangstaticcontent_edit - - admin_bundle_routingextra_route_create - - admin_bundle_routingextra_route_delete - - admin_bundle_routingextra_route_edit - - admin_bundle_simplecms_page_create - - admin_bundle_simplecms_page_delete - - admin_bundle_simplecms_page_edit - - symfony_cmf_tree_browser.phpcr_children - - symfony_cmf_tree_browser.phpcr_move - - sonata.admin.doctrine_phpcr.phpcrodm_children - - sonata.admin.doctrine_phpcr.phpcrodm_move - -Añade la ruta a la configuración de enrutado: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/routing.yml - admin: - resource: '@SonataAdminBundle/Resources/config/routing/sonata_admin.xml' - prefix: /admin - - _sonata_admin: - resource: . - type: sonata_admin - prefix: /admin - - fos_js_routing: - resource: "@FOSJsRoutingBundle/Resources/config/routing/routing.xml" - - phpcrbrowser: - resource: @SymfonyCmfTreeBrowserBundle/Resources/config/routing/phpcrbrowser.xml - prefix: /admin/browser - - phpcrodmbrowser: - resource: @SonataDoctrinePHPCRAdminBundle/Resources/config/routing/phpcrodmbrowser.xml - prefix: /admin/browser - diff --git a/cmf/html/_sources/tutorials/installing-cmf-core.txt b/cmf/html/_sources/tutorials/installing-cmf-core.txt deleted file mode 100644 index 30a5deb..0000000 --- a/cmf/html/_sources/tutorials/installing-cmf-core.txt +++ /dev/null @@ -1,126 +0,0 @@ -Instalando y configurando el núcleo del ``CMF`` -=============================================== - -El objetivo de esta guía es instalar los componentes mínimos necesarios (el «núcleo») del ``CMF`` con la mínima configuración requerida. A partir de aquí, puedes empezar a incorporar en tu aplicación la funcionalidad del ``CMF`` que necesites. - -Esta guía está dirigida a usuarios experimentados que quieren conocer todos los -detalles sobre el ``CMF`` de *Symfony*. Si este es tu primer encuentro con el ``CMF`` de *Symfony* es buena idea empezar con: - -- La página :doc:`../getting-started/installing-symfony-cmf` para instrucciones sobre cómo instalar rápidamente el ``CMF`` (recommendada para desarrolladores) -- :doc:`../cookbook/installing-cmf-sandbox` para instrucciones sobre cómo instalar una demostración del recinto de seguridad. - -.. index:: RoutingExtraBundle, CoreBundle, MenuBundle, ContentBundle, SonataBlockBundle, KnpMenuBundle, instalando - -Requisitos previos ------------------- - -- `Instalando Symfony2 `_ (2.1.x) -- :doc:`installing-configuring-doctrine-phpcr-odm` - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "symfony-cmf/symfony-cmf": "1.0.*" - } - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update - - -Iniciando paquetes -~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en :file:`AppKernel.php` añadiéndolos al método ``registerBundles``: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - - new Symfony\Cmf\Bundle\RoutingExtraBundle\SymfonyCmfRoutingExtraBundle(), - new Symfony\Cmf\Bundle\CoreBundle\SymfonyCmfCoreBundle(), - new Symfony\Cmf\Bundle\MenuBundle\SymfonyCmfMenuBundle(), - new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(), - new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(), - - // Dependencias del SymfonyCmfMenuBundle - new Knp\Bundle\MenuBundle\KnpMenuBundle(), - - // Dependencias del SymfonyCmfBlockBundle - new Sonata\BlockBundle\SonataBlockBundle(), - ); - - // ... - } - -.. note:: - - Esto también habilita el *PHPCR-ODM* y dependencias relacionadas; las instrucciones de configuración se pueden encontrar en la documentación dedicada. - - -Configurando ------------- - -Para lograr que tu aplicación funcione, es muy poca la configuración necesaria. - -Configuración mínima -~~~~~~~~~~~~~~~~~~~~ - -Estos pasos son necesarios para garantizar que tu ``AppKernel`` todavía se ejecuta. - -Si no lo has hecho ya, asegúrate de que has seguido estos pasos en :doc:`installing-configuring-doctrine-phpcr-odm`: - - -- Inicia el ``DoctrinePHPCRBundle`` en :file:`app/AppKernel.php` -- Asegúrate que hay una sección ``doctrine_phpcr:`` en :file:`app/config/config.yml` -- Y la línea ``AnnotationRegistry::registerFile`` en :file:`app/autoload.php` - -Configura el ``BlockBundle`` en tu archivo :file:`config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_block: - default_contexts: [cms] - -Configuración adicional -~~~~~~~~~~~~~~~~~~~~~~~ - -Puesto que la mayoría de los componentes del ``CMF`` utilizan el ``DynamicRouter`` del ``RoutingExtraBundle``, el cual de manera predeterminada no se carga, necesitarás habilitarlo de la siguiente manera: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_routing_extra: - chain: - routers_by_id: - symfony_cmf_routing_extra.dynamic_router: 200 - router.default: 100 - dynamic: - enabled: true - -Podrías querer configurar más en el enrutador dinámico, es decir escoger automáticamente los controladores basados en contenido. -Ve :doc:`../bundles/routing-extra` para detalles. - -Por ahora esta es la única configuración que necesitamos. Dominar la configuración de los diferentes paquetes será el tema de otras guías. Si estás buscando la configuración de un paquete específico dale un vistazo al :doc:`artículo del paquete <../index>` correspondiente. diff --git a/cmf/html/_sources/tutorials/installing-configuring-doctrine-phpcr-odm.txt b/cmf/html/_sources/tutorials/installing-configuring-doctrine-phpcr-odm.txt deleted file mode 100644 index 5ad61cb..0000000 --- a/cmf/html/_sources/tutorials/installing-configuring-doctrine-phpcr-odm.txt +++ /dev/null @@ -1,266 +0,0 @@ -Instalando y configurando *Doctrine* y *PHPCR-ODM* -================================================== - -El ``CMF`` de *Symfony2* necesita almacenar el contenido en algún lugar. Muchos de los paquetes proporcionan documentos y asignación para el contenido del repositorio *PHP* --- Asignación para el objeto documento (*PHPCR-ODM*), y la documentación que actualmente está basada en torno a la utilización de este. Aun así, también tiene que ser posible utilizar otra forma de almacenamiento para el contenido, como otro *ORM/ODM* o *MongoDB*. - -El objetivo de esta guía es instalar y configurar *Doctrina* y *PHPCR-ODM*, listo para que empieces -con el ``CMF``. - -Para más detalles ve la `documentación oficial de PHPCR-ODM `_. -Puedes encontrar alguna información adicional en el `repositorio git del proyecto DoctrinePhpcrBundle `_, el cual mayoritariamente imita al `DoctrineBundle `_ estándar. - -Finalmente para información sobre *PHPCR* ve el `sitio web oficial PHPCR `_. - -.. index:: PHPCR, ODM - -Requisitos previos ------------------- - -- php >= 5.3 -- libxml versión >= 2.7.0 (debido a un error en libxml http://bugs.php.net/bug.php?id=36501) -- phpunit >= 3.6 (si quieres ejecutar las pruebas) -- Symfony2 (versión 2.1.x) - -Instalando ----------- - -Escogiendo un repositorio para el contenido -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La primer cosa a decidir es qué repositorio de contenido utilizar. Un repositorio de contenido esencialmente es una base de datos que será la responsable para almacenar todo el contenido que quieras persistir. Este proporciona una *API* optimizada para las necesidades de un *CMS* (estructuras de árbol, referencias, versionado, completa búsqueda -de texto, etc.). Si bien, cada repositorio de contenido puede tener requisitos y características de rendimiento muy diferentes, la *API* es igual para todos ellos. - -Además, debido a que la *API* define un formato de importación/exportación, siempre puedes cambiar a una -diferente implementación del repositorio de contenido más tarde. - -Estas son las opciones disponibles: - -* **Jackalope con Jackrabbit** (Jackrabbit requiere Java, este puede persistir al sistema de archivos, a una base de datos, etc.) -* **Jackalope con DBAL de Doctrine** (requiere un *RDBMS* como *MySQL*, *PostgreSQL* o *SQLite*) -* **Midgard** (Requiere la extensión ``midgard2`` de *PHP* y un *RDBMS* como *MySQL*, *PostgreSQL* o *SQLite*) - -La siguiente documentación incluye ejemplos para todas las opciones de arriba. - -.. tip:: - - Si justo estás empezando con el ``CMF``, es mejor escoger un repositorio de contenido basado en un motor de almacenamiento con el cual ya estés familiarizado. Por ejemplo, **Jackalope con DBAL de Doctrine** trabajará con tu *RDBMS* existente y no requiere instalar *Java* o la extensión ``midgard2`` de *PHP*. Una vez que tienes una aplicación trabajando debe ser fácil cambiar a otra opción. - - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`, dependiendo del repositorio de contenido que hayas escogido. - -| **Jackalope con Jackrabbit** - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "jackalope/jackalope-jackrabbit": "1.0.*", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -| **Jackalope con Doctrine DBAL** - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "jackalope/jackalope-doctrine-dbal": "dev-master", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -**Midgard** - -.. code-block:: javascript - - "minimum-stability": "dev", - "require": { - ... - "midgard/phpcr": "dev-master", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -.. note:: - - Para todo lo anterior, si también estás utilizando el *ORM* de *Doctrine*, asegúrate de usar ``"doctrine/orm": "2.3.*"``, o de lo contrario ``composer`` no podrá resolver las dependencias cuando *Doctrine* dependa del *PHPCR-ODM* más nuevo de *Doctrine 2.3*. (la edición estándar de *Symfony 2.1* utiliza «2.2.*».) - -Para instalar las dependencias anteriores, ejecuta: - -.. code-block:: bash - - php composer.phar update - -Registrando anotaciones -~~~~~~~~~~~~~~~~~~~~~~~ - -*PHPCR-ODM* usa anotaciones y es necesario registrarlas en tu archivo :file:`app/autoload.php`. Añade la siguiente línea, inmediatamente después de la última línea ``AnnotationRegistry::registerFile``: - -.. code-block:: php - - // app/autoload.php - - // ... - AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php'); - // ... - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en el archivo :file:`app/AppKernel.php` añadiéndolos al método ``registerBundle``: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - - // Doctrine PHPCR - new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(), - - ); - // ... - } - - -Configurando ------------- - -El siguiente paso es configurar los paquetes. - -*Doctrine* con *PHPCR-ODM* -~~~~~~~~~~~~~~~~~~~~~~~~~~ - -La configuración básica para cada repositorio de contenido se muestra abajo; añade las líneas apropiadas a tu archivo :file:`app/config/config.yml`. Más información sobre la configuración de este paquete se puede encontrar `en la página del proyecto Doctrine PHPCR `_. - -**Jackalope con Jackrabbit** - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: jackrabbit - url: http://localhost:8080/server/ - workspace: default - username: admin - password: admin - odm: - auto_mapping: true - -**Jackalope con DBAL de Doctrine** - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - workspace: default - username: admin - password: admin - odm: - auto_mapping: true - -.. note:: - - Asegúrate también de configurar la sección principal de ``doctrine:`` al *RDBMS* que escogiste. - Ve `Bases de datos y Doctrine `_. - -**Midgard** - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: midgard2 - db_type: MySQL - db_name: midgard2_test - db_host: "0.0.0.0" - db_port: 3306 - db_username: "" - db_password: "" - db_init: true - blobdir: /tmp/cmf-blobs - workspace: default - username: admin - password: admin - odm: - auto_mapping: true - -Configurando el repositorio de contenido ----------------------------------------- - -.. _tutorials-installing-phpcr-jackrabbit: - -**Jackalope Jackrabbit** - -.. index:: Jackrabbit - -Estos son los pasos necesarios para instalar *Apache Jackrabbit*: - -- Asegúrate de que tienes instalada en tu caja la máquina virtual de *Java*. Si no, puedes conseguir una aquí: http://www.java.com/en/download/manual.jsp -- Descarga la versión más reciente de `Jackrabbit de la página de descarga `_ -- Ejecuta el servidor. Ve al directorio donde descargaste el archivo ``.jar`` y lánzalo: - -.. code-block:: bash - - java -jar jackrabbit-standalone-*.jar - -Ve a http://localhost:8080/, ahora *Apache* te debería mostrar una página ``Jackrabbit``. - -Puedes encontrar más información sobre cómo `ejecutar un servidor Jackrabbit `_ en el *wiki* de ``Jackalope``. - -.. _tutorials-installing-phpcr-doctrinedbal: - -**Jackalope DBAL de Doctrine** - -.. index:: Doctrine, DBAL, RDBMS - -Ejecuta las siguientes órdenes para crear la base de datos e instalar un esquema predefinido: - -.. code-block:: bash - - app/console doctrine:database:create - app/console doctrine:phpcr:init:dbal - -Para más información sobre cómo configurar el *DBAL* de *Doctrine* en *Symfony2*, ve el `capítulo de Doctrine en la documentación de Symfony2 `_ y las explicaciones en el :ref:`capítulo de referencia de PHPCR `. - -.. _tutorials-installing-phpcr-midgard: - -**Midgard** - -.. index:: Midgard, RDBMS - -*Midgard* es una extensión *C* que implementa la *API* de *PHPCR* en lo alto de un *RDBMS* estándar. - -Ve la `documentación oficial de Midgard PHPCR `_. - -Registrando tipos de nodo del sistema -------------------------------------- - -*PHPCR-ODM* utiliza un `tipo de nodo personalizado `_ para dar seguimiento a la metainformación sin interferir con tu contenido. Hay una orden que hace trivial el registro de este tipo y el espacio de nombres *PHPCR*: - -.. code-block:: bash - - php app/console doctrine:phpcr:register-system-node-types diff --git a/cmf/html/_sources/tutorials/installing-configuring-inline-editing.txt b/cmf/html/_sources/tutorials/installing-configuring-inline-editing.txt deleted file mode 100644 index 0a9e331..0000000 --- a/cmf/html/_sources/tutorials/installing-configuring-inline-editing.txt +++ /dev/null @@ -1,93 +0,0 @@ -Instalando y configurando la edición en línea -============================================= - -El objetivo de esta guía es instalar y configurar el apoyo para la edición en línea. - -.. note:: - - Para que trabaje el ``CMF`` se requiere de *Symfony 2.1* (actualmente maestro). - -Este proporciona una solución fácil de integrar con `VIE.js `_ y `create.js `_ para proporcionar edición en línea basada en la salida de `RDFa `_. - -Para más información ---por ahora--- ve la documentación del `CreateBundle `_ - -.. index:: VIE.js, CreateBundle, FOSRestBundle, JMSSerializerBundle, RDFa, create.js, hallo.js - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/create-bundle": "1.0.*" - }, - "scripts": { - "post-install-cmd": [ - "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ], - "post-update-cmd": [ - "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules", - ... - ] - }, - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update symfony-cmf/create-bundle - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia los paquetes en el archivo :file:`app/AppKernel.php` añadiéndolos al método ``registerBundles``: - -.. code-block:: php - - public function registerBundles() - { - $bundles = array( - // ... - - new Symfony\Cmf\Bundle\CreateBundle\SymfonyCmfCreateBundle(), - new FOS\RestBundle\FOSRestBundle(), - new JMS\SerializerBundle\JMSSerializerBundle($this), - ); - // ... - } - -Configurando ------------- - -El siguiente paso es configurar los paquetes. - -Configuración básica, añade lo siguiente a la configuración de tu aplicación: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_create: - phpcr_odm: true - map: - '': 'Symfony\Cmf\Bundle\MultilangContentBundle\Document\MultilangStaticContent' - image: - model_class: Symfony\Cmf\Bundle\CreateBundle\Document\Image - controller_class: Symfony\Cmf\Bundle\CreateBundle\Controller\PHPCRImageController - -Si tienes tus propios documentos, agregalos a la asignación y coloca la asignación ``RDFa`` en ``Resources/rdf-mappings`` ya sea dentro del directorio ``app`` o dentro de algún paquete. -El nombre de archivo es el nombre de clase completamente cualificado que incluye el espacio de nombres sustituyendo la barra inversa ``\`` con un punto ``(.)``. - - -Referencia ----------- - -Ve el :doc:`../bundles/create` diff --git a/cmf/html/_sources/tutorials/installing-configuring-simple-cms.txt b/cmf/html/_sources/tutorials/installing-configuring-simple-cms.txt deleted file mode 100644 index 59dc273..0000000 --- a/cmf/html/_sources/tutorials/installing-configuring-simple-cms.txt +++ /dev/null @@ -1,82 +0,0 @@ -Instalando y configurando el ``SimpleCmsBundle`` -================================================ - -El objetivo de esta guía es instalar y configurar un sencillo *CMS* con la ayuda del ``SimpleCmsBundle``. - -.. note:: - - Para que trabaje el ``CMF`` se requiere de *Symfony 2.1* (actualmente maestro). - -El ``SimpleCmsBundle`` proporciona una solución para fácilmente asignar contenido, rutas y elementos del menú basando el repositorio de contenido en una única estructura de árbol. - -Para más información ---por ahora--- ve la documentación del `SymfonyCmfSimpleCmsBundle `_ - -Para una sencilla instalación de ejemplo del paquete revisa la `Edición estándar del CMF de Symfony `_ - -El `sitio web de CMF `_ es -otra aplicación que utiliza el ``SimpleCmsBundle``. - - -.. index:: SimpleCmsBundle - -Requisitos previos ------------------- - -- :doc:`installing-cmf-core` - -Instalando ----------- - -Descarga los paquetes -~~~~~~~~~~~~~~~~~~~~~ - -Añade lo siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/simple-cms-bundle": "1.0.*" - } - -Y luego ejecuta: - -.. code-block:: bash - - php composer.phar update - - -Iniciando los paquetes -~~~~~~~~~~~~~~~~~~~~~~ - -Luego, inicia el paquete en el archivo :file:`app/AppKernel.php` añadiéndolo al método ``registerBundles``. - -.. code-block:: php - - public function registerBundles() - { - $bundles = array( - // ... - - new Symfony\Cmf\Bundle\SimpleCmsBundle\SymfonyCmfSimpleCmsBundle(), - - ); - // ... - } - -Configurando ------------- - -El siguiente paso es configurar los paquetes. - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_simple_cms: - routing: - templates_by_class: - Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page: SymfonyCmfSimpleCmsBundle:Page:index.html.twig - -Ve la referencia completa de :doc:`../bundles/simple-cms`. diff --git a/cmf/html/_sources/tutorials/using-blockbundle-and-contentbundle.txt b/cmf/html/_sources/tutorials/using-blockbundle-and-contentbundle.txt deleted file mode 100644 index 23cd8a0..0000000 --- a/cmf/html/_sources/tutorials/using-blockbundle-and-contentbundle.txt +++ /dev/null @@ -1,597 +0,0 @@ -Usando ``BlockBundle`` y ``ContentBundle`` con *PHPCR* -====================================================== - -El objetivo de esta guía es demostrar cómo puedes utilizar el ``CMF`` :doc:`../bundles/block` y :doc:`../bundles/content` como componentes independientes, y mostrarte cómo complementan al *PHPCR*. - -Esta guía demuestra el uso más sencillo posible, para instalarlo y ejecutarlo -rápidamente. Una vez que estés familiarizado con lo básico, la documentación en profundidad de ambos paquetes te -ayudará a adaptar estos ejemplos básicos para servir casos de uso más avanzados. - -Empezaremos utilizando únicamente el ``BlockBundle``, con bloques de contenido enlazados directamente al *PHPCR*. -Luego, introduciremos el ``ContentBundle`` para mostrarte cómo puedes representar contenido en las páginas con bloques. - -.. note:: - - A pesar de que no es un requisito utilizar ``BlockBundle`` o ``ContentBundle``, esta guía también usa `DoctrineFixturesBundle `_. - Esto es porque este proporciona una manera fácil de cargar algún contenido de prueba. - - -Requisitos previos ------------------- - -- `Instalando Symfony2 `_ (2.1.x) -- :doc:`installing-configuring-doctrine-phpcr-odm` - -.. note:: - - Esta guía está basada en la utilización de *PHPCR-ODM* instalado con ``Jackalope``, *DBAL* de *Doctrine* y una base de datos *MySQL*. Debería ser fácil adaptarlo para trabajar con una de las otras opciones *PHPCR* documentadas en :doc:`installing-configuring-doctrine-phpcr-odm`. - - -Creando y configurando la base de datos ---------------------------------------- - -Puedes utilizar una base de datos existente, o crear una ahora para ayudarte a seguir esta guía. Para una nueva base de datos, ejecuta estas órdenes en *MySQL*: - -.. code-block:: sql - - CREATE DATABASE symfony DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci; - CREATE USER 'symfony'@'localhost' IDENTIFIED BY 'UseABetterPassword'; - GRANT ALL ON symfony.* TO 'symfony'@'localhost'; - -Tu archivo :file:`parameters.yml` necesita emparejar lo anterior, por ejemplo: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/parameters.yml - parameters: - database_driver: pdo_mysql - database_host: localhost - database_port: ~ - database_name: symfony - database_user: symfony - database_password: UseABetterPassword - - -Configurando el componente *PHPCR* de *Doctrine* ------------------------------------------------- - -.. note:: - - Si seguiste la guía :doc:`installing-configuring-doctrine-phpcr-odm`, puedes saltarte esta sección. - -Necesitas instalar los componentes del *PHPCR-ODM*. Añade los siguiente a tu archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "jackalope/jackalope-jackrabbit": "1.0.*", - "jackalope/jackalope-doctrine-dbal": "dev-master", - "doctrine/phpcr-bundle": "1.0.*", - "doctrine/phpcr-odm": "1.0.*" - } - -Para instalar lo anterior, ejecuta: - -.. code-block:: bash - - php composer.phar update - -En tu archivo :file:`config.yml`, añade la siguiente configuración para ``doctrine_phpcr``: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - workspace: default - odm: - auto_mapping: true - -Añade la siguiente línea al método ``registerBundles()`` en el archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(), - ); - - // ... - } - -Añade la siguiente línea a tu archivo :file:`autoload.php`, inmediatamente después de la -última línea ``AnnotationRegistry::registerFile``: - -.. code-block:: php - - // app/autoload.php - - // ... - AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php'); - // ... - -Crea el esquema de la base de datos y registra el tipo de nodo *PHPCR* usando las siguientes órdenes de consola: - -.. code-block:: bash - - php app/console doctrine:phpcr:init:dbal - php app/console doctrine:phpcr:register-system-node-types - -Ahora deberías tener una serie de tablas en tu base de datos *MySQL* con el prefijo ``phpcr_``. - - -Instala los componentes necesarios del ``CMF`` de *Symfony* ------------------------------------------------------------ - -Añade lo siguiente al archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/block-bundle": "dev-master" - } - -Para instalar las dependencias anteriores, ejecuta: - -.. code-block:: bash - - php composer.phar update - -Añade las siguientes líneas al archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Sonata\BlockBundle\SonataBlockBundle(), - new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(), - ); - - // ... - } - -``SonataBlockBundle`` es una dependencia del ``BlockBundle`` de ``CMF`` y necesitas configurarlas. Añade lo siguiente a tu archivo :file:`config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - sonata_block: - default_contexts: [cms] - - -Instala ``DoctrineFixturesBundle`` ----------------------------------- - -.. note:: - - Como mencioné al inicio, este no es un requisito para ``BlockBundle`` o ``ContentBundle``; No obstante, es una buena manera de manejar contenido predefinido o de ejemplo. - -Añade lo siguiente al archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "doctrine/doctrine-fixtures-bundle": "dev-master" - } - -Para instalar las dependencias anteriores, ejecuta: - -.. code-block:: bash - - php composer.phar update - -Añade la siguiente línea al método ``registerBundles()`` en el archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(), - ); - - // ... - } - - -Cargando accesorios -------------------- - -Basándote en la `documentación de DoctrineFixturesBundle `_, necesitarás crear una clase ``fixtures``. - -Para empezar, crea un directorio ``DataFixtures`` dentro de tu propio paquete (p. ej. ``«MainBundle»``), y dentro, crea un directorio llamado ``PHPCR``. Si quieres seguir los ejemplos de más adelante, el ``DoctrineFixturesBundle`` cargará automáticamente las clases ``fixtures`` colocadas allí. - -En el cargador de ``accesorios``, un ejemplo de la creación de un bloque de contenido podría tener esta apariencia: - -.. code-block:: php - - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($parentPage); - $myBlock->setName('sidebarBlock'); - $myBlock->setTitle('My first block'); - $myBlock->setContent('Hello block world!'); - - $documentManager->persist($myBlock); - -Aún así, lo anterior en sí mismo no será suficiente, porque no hay ninguna página padre (``$parentPage``) con la cual enlazar los bloques. Hay varias posibles opciones que puedes utilizar como el padre: - -- Enlaza los bloques directamente al documento raíz (no mostrado) -- Crea un documento del paquete *PHPCR* (mostrado abajo usando el tipo de documento ``Genérico``) -- Crea un documento del ``ContentBundle`` del ``CMF`` (mostrado abajo utilizando el tipo de documento ``StaticContent``) - - -Usando el *PHPCR* ------------------ - -Para almacenar un bloque directamente en el *PHPCR* del ``CMF``, crea la siguiente clase dentro de tu directorio ``DataFixtures/PHPCR``: - -.. code-block:: html+php - - find(null, '/'); - - // Crea un documento PHPCR genérico bajo la raíz, para usarlo - // como el tipo de categoría para los bloques - $document = new Generic(); - $document->setParent($rootDocument); - $document->setNodename('blocks'); - $manager->persist($document); - - // Crea un nuevo SimpleBlock (ve - // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types) - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($document); - $myBlock->setName('testBlock'); - $myBlock->setTitle('CMF BlockBundle only'); - $myBlock->setContent('Block from CMF BlockBundle, parent from the PHPCR (Generic document).'); - $manager->persist($myBlock); - - // Confirma los cambios de $document y $block a la base de datos - $manager->flush(); - } - - public function setContainer(ContainerInterface $container = null) - { - $this->container = $container; - } - } - -Esta clase carga un bloque de contenido de ejemplo que utiliza el ``BlockBundle`` de ``CMF`` (sin necesitar ningún otro paquete del ``CMF``). Para asegurar el bloque tienes un padre en el repositorio, el cargador también crea un documento ``Genérico`` llamado ``'blocks'`` dentro del *PHPCR*. - -Ahora, carga los accesorios usando la consola: - -.. code-block:: bash - - php app/console doctrine:phpcr:fixtures:load - -El contenido en tu base de datos ahora se tendría que ver algo así: - - -.. code-block:: sql - - SELECT path, parent, local_name FROM phpcr_nodes; - -+-------------------+---------+------------+ -| path | parent | local_name | -+===================+=========+============+ -| / | | | -+-------------------+---------+------------+ -| /blocks | / | blocks | -+-------------------+---------+------------+ -| /blocks/testBlock |/ blocks | testBlock | -+-------------------+---------+------------+ - - -Usando el ``ContentBundle`` del ``CMF`` ---------------------------------------- - -Sigue este ejemplo para utilizar ambos componentes ``Block`` y ``Content``. - -El paquete ``ContentBundle`` también requiere del ``RoutingExtraBundle``, así que para ahorrar tiempo puedes instalar ambos. -Añade lo siguiente al archivo :file:`composer.json`: - -.. code-block:: javascript - - "require": { - ... - "symfony-cmf/content-bundle": "dev-master", - "symfony-cmf/routing-extra-bundle": "dev-master" - } - -Instala todo de la manera habitual: - -.. code-block:: bash - - php composer.phar update - -Añade la siguiente línea al archivo :file:`AppKernel.php`: - -.. code-block:: php - - // app/AppKernel.php - - public function registerBundles() - { - $bundles = array( - // ... - new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(), - ); - - // ... - } - -Ahora deberías tener todo lo necesario para cargar una página de contenido con un bloque de ejemplo, así que crea la clase ``LoadBlockWithCmfParent.php``: - -.. code-block:: html+php - - getPhpcrSession(); - $basepath = $this->container->getParameter('symfony_cmf_content.static_basepath'); - - // Crea la ruta en el repositorio - NodeHelper::createPath($session, $basepath); - - // Crea un nuevo documento que utiliza StaticContent de ContentBundle del CMF - $document = new StaticContent(); - $document->setPath($basepath . '/blocks'); - $manager->persist($document); - - // Crea un nuevo SimpleBlock (ve - // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types) - $myBlock = new SimpleBlock(); - $myBlock->setParentDocument($document); - $myBlock->setName('testBlock'); - $myBlock->setTitle('CMF BlockBundle and ContentBundle'); - $myBlock->setContent('Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent).'); - $manager->persist($myBlock); - - // Confirma los cambios de $document y $block a la base de datos - $manager->flush(); - } - - public function setContainer(ContainerInterface $container = null) - { - $this->container = $container; - } - } - -Esta clase crea una página de contenido de ejemplo que utiliza el ``ContentBundle`` del ``CMF``. Luego, carga el bloque de ejemplo como antes, usando la nueva página de contenido como su padre. - -De manera predeterminada, la ruta base para el contenido es :file:`/cms/content/static`. Para mostrar cómo lo puedes configurar a cualquier ruta, añade la siguiente entrada opcional a tu archivo :file:`config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - symfony_cmf_content: - static_basepath: /content - -Ahora deberías poder cargar los accesorios anteriores: - -.. code-block:: bash - - php app/console doctrine:phpcr:fixtures:load - -Todo va sobre ruedas, el contenido en tu base de datos se tendría que ver algo así (si también seguiste el ejemplo ``LoadBlockWithPhpcrParent``, todavía deberías tener dos entradas ``/blocks`` también): - -.. code-block:: sql - - SELECT path, parent, local_name FROM phpcr_nodes; - -+---------------------------+-----------------+------------+ -| path | parent | local_name | -+===========================+=================+============+ -| / | | | -+---------------------------+-----------------+------------+ -| /content | / | content | -+---------------------------+-----------------+------------+ -| /content/blocks | /content | blocks | -+---------------------------+-----------------+------------+ -| /content/blocks/testBlock | /content/blocks | testBlock | -+---------------------------+-----------------+------------+ - - -Dibujando los bloques ---------------------- - -Esto lo maneja el ``BlockBundle`` de ``Sonata``. ``sonata_block_render`` ya está registrado como extensión de *Twig* al incluir ``SonataBlockBundle`` en el archivo :file:`AppKernel.php`. Por lo tanto, puedes dibujar cualquier bloque dentro de cualquier plantilla simplemente refiriéndote a su ruta. - -El siguiente código muestra el resultado de ambas instancias de los bloques ``testBlock`` de los ejemplos anteriores. -Si sólo seguiste uno de los ejemplos, asegúrate de incluir únicamente ese bloque: - -.. code-block:: text - - {# src/Acme/Bundle/MainBundle/resources/views/Default/index.html.twig #} - - {# Incluye esto si seguiste el ejemplo BlockBundle con PHPCR #} - {{ sonata_block_render({ - 'name': '/blocks/testBlock' - }) }} - - {# incluye esto si seguiste el ejemplo BlockBundle con ContentBundle #} - {{ sonata_block_render({ - 'name': '/content/blocks/testBlock' - }) }} - -Ahora tu página ``index`` debería mostrar lo siguiente (suponiendo que seguiste ambos ejemplos): - -.. code-block:: text - - CMF BlockBundle only - Block from CMF BlockBundle, parent from the PHPCR (Generic document). - - CMF BlockBundle and ContentBundle - Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent). - - -Siguientes pasos ----------------- - -Ahora deberías estar listo para usar en tu aplicación el ``BlockBundle`` y/o el ``ContentBundle``, o para explorar los otros paquetes disponibles en el ``CMF``. - -- Ve la documentación de los paquetes :doc:`../bundles/block` y :doc:`../bundles/content` para aprender usos más avanzados de estos paquetes - para ver una manera mejor de cargar accesorios, mira los `accesorios en el recinto de seguridad del CMF `_ -- Dale un vistazo a la `guía PHPCR `_ para entender mejor el repositorio de contenido subyacente - - -Solucionando problemas ----------------------- - -Si tienes problemas, posiblemente sea más fácil empezar con una instalación de *Symfony2* fresca. También puedes probar ejecutando y modificando el código en el ejemplo externo del `recinto de seguridad del bloque del CMF `_. - -**Configuración de Doctrine** - -Si empezaste con la distribución estándar de *Symfony2* (versión 2.1.x), ya deberías tener correctamente configurado tu archivo :file:`config.yml`. Si no, inténtalo usando la siguiente sección: - -.. configuration-block:: - - .. code-block:: yaml - - # app/config/config.yml - doctrine: - dbal: - driver: "%database_driver%" - host: "%database_host%" - port: "%database_port%" - dbname: "%database_name%" - user: "%database_user%" - password: "%database_password%" - charset: UTF8 - orm: - auto_generate_proxy_classes: "%kernel.debug%" - auto_mapping: true - -**"Ninguna orden definida" al cargar accesorios** - -.. code-block:: text - - [InvalidArgumentException] - No hay ninguna orden definida en el espacio de nombres ``doctrine:phpcr:fixtures``. - -Asegúrate de que tu archivo :file:`AppKernel.php` contiene las siguientes líneas: - -.. code-block:: php - - new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(), - new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(), - -**"No configuraste una sesión"** - -.. code-block:: text - - [InvalidArgumentException] - No configuraste una sesión para los gestores de documento - -Asegúrate de que tienes lo siguiente en tu archivo :file:`app/config.yml`: - -.. configuration-block:: - - .. code-block:: yaml - - doctrine_phpcr: - session: - backend: - type: doctrinedbal - connection: doctrine.dbal.default_connection - workspace: default - odm: - auto_mapping: true - -**"La anotación no existe"** - -.. code-block:: text - - [Doctrine\Common\Annotations\AnnotationException] - [Error semántico] La anotación «@Doctrine\ODM\PHPCR\Mapping\Annotations\Document» en la clase «Doctrine\ODM\PHPCR\Document\Generic» no existe, o no se puede cargar automáticamente. - -Asegúrate de añadir esta línea a tu archivo :file:`app/autoload.php` (inmediatamente después de la línea ``AnnotationRegistry::registerLoader``): - -.. code-block:: php - - AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php'); - -**no se encuentra la clase SimpleBlock** - -.. code-block:: text - - [Doctrine\Common\Persistence\Mapping\MappingException] - La clase 'Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock' no se encuentra en la cadena de espacios de nombres configurada Doctrine\ODM\PHPCR\Document, Sonata\UserBundle\Document, FOS\UserBundle\Document - -Asegúrate de que está instalado el ``BlockBundle`` del ``CMF`` y de que se carga en el archivo :file:`app/AppKernel.php`: - -.. code-block:: php - - new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(), - -**No se encuentra la RouteAwareInterface** - -.. code-block:: text - - Error fatal: No se encuentra la interfaz 'Symfony\Cmf\Component\Routing\RouteAwareInterface' en /var/www/your-site/vendor/symfony-cmf/content-bundle/Symfony/Cmf/Bundle/ContentBundle/Document/StaticContent.php en la línea 15 - -Si estás utilizando el ``ContentBundle``, asegúrate de instalar el ``RoutingExtraBundle``, también: - -.. code-block:: javascript - - // composer.json - "symfony-cmf/routing-extra-bundle": "dev-master" - -...e instala: - -.. code-block:: bash - - php composer.phar update diff --git a/cmf/html/_static/ajax-loader.gif b/cmf/html/_static/ajax-loader.gif deleted file mode 100644 index 61faf8c..0000000 Binary files a/cmf/html/_static/ajax-loader.gif and /dev/null differ diff --git a/cmf/html/_static/basic.css b/cmf/html/_static/basic.css deleted file mode 100644 index 43e8baf..0000000 --- a/cmf/html/_static/basic.css +++ /dev/null @@ -1,540 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/* -- main layout ----------------------------------------------------------- */ - -div.clearer { - clear: both; -} - -/* -- relbar ---------------------------------------------------------------- */ - -div.related { - width: 100%; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -/* -- sidebar --------------------------------------------------------------- */ - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 230px; - margin-left: -100%; - font-size: 90%; -} - -div.sphinxsidebar ul { - list-style: none; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -div.sphinxsidebar #searchbox input[type="text"] { - width: 170px; -} - -div.sphinxsidebar #searchbox input[type="submit"] { - width: 30px; -} - -img { - border: 0; -} - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable { - width: 100%; -} - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable dl, table.indextable dd { - margin-top: 0; - margin-bottom: 0; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -div.modindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -/* -- general body styles --------------------------------------------------- */ - -a.headerlink { - visibility: hidden; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink { - visibility: visible; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -.field-list ul { - padding-left: 1em; -} - -.first { - margin-top: 0 !important; -} - -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -img.align-left, .figure.align-left, object.align-left { - clear: left; - float: left; - margin-right: 1em; -} - -img.align-right, .figure.align-right, object.align-right { - clear: right; - float: right; - margin-left: 1em; -} - -img.align-center, .figure.align-center, object.align-center { - display: block; - margin-left: auto; - margin-right: auto; -} - -.align-left { - text-align: left; -} - -.align-center { - text-align: center; -} - -.align-right { - text-align: right; -} - -/* -- sidebars -------------------------------------------------------------- */ - -div.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px 7px 0 7px; - background-color: #ffe; - width: 40%; - float: right; -} - -p.sidebar-title { - font-weight: bold; -} - -/* -- topics ---------------------------------------------------------------- */ - -div.topic { - border: 1px solid #ccc; - padding: 7px 7px 0 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* -- admonitions ----------------------------------------------------------- */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -div.admonition dl { - margin-bottom: 0; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -/* -- tables ---------------------------------------------------------------- */ - -table.docutils { - border: 0; - border-collapse: collapse; -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 5px; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -table.field-list td, table.field-list th { - border: 0 !important; -} - -table.footnote td, table.footnote th { - border: 0 !important; -} - -th { - text-align: left; - padding-right: 5px; -} - -table.citation { - border-left: solid 1px gray; - margin-left: 1px; -} - -table.citation td { - border-bottom: none; -} - -/* -- other body styles ----------------------------------------------------- */ - -ol.arabic { - list-style: decimal; -} - -ol.loweralpha { - list-style: lower-alpha; -} - -ol.upperalpha { - list-style: upper-alpha; -} - -ol.lowerroman { - list-style: lower-roman; -} - -ol.upperroman { - list-style: upper-roman; -} - -dl { - margin-bottom: 15px; -} - -dd p { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -dt:target, .highlighted { - background-color: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -.refcount { - color: #060; -} - -.optional { - font-size: 1.3em; -} - -.versionmodified { - font-style: italic; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -.footnote:target { - background-color: #ffa; -} - -.line-block { - display: block; - margin-top: 1em; - margin-bottom: 1em; -} - -.line-block .line-block { - margin-top: 0; - margin-bottom: 0; - margin-left: 1.5em; -} - -.guilabel, .menuselection { - font-family: sans-serif; -} - -.accelerator { - text-decoration: underline; -} - -.classifier { - font-style: oblique; -} - -abbr, acronym { - border-bottom: dotted 1px; - cursor: help; -} - -/* -- code displays --------------------------------------------------------- */ - -pre { - overflow: auto; - overflow-y: hidden; /* fixes display issues on Chrome browsers */ -} - -td.linenos pre { - padding: 5px 0px; - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - margin-left: 0.5em; -} - -table.highlighttable td { - padding: 0 0.5em 0 0.5em; -} - -tt.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -tt.descclassname { - background-color: transparent; -} - -tt.xref, a tt { - background-color: transparent; - font-weight: bold; -} - -h1 tt, h2 tt, h3 tt, h4 tt, h5 tt, h6 tt { - background-color: transparent; -} - -.viewcode-link { - float: right; -} - -.viewcode-back { - float: right; - font-family: sans-serif; -} - -div.viewcode-block:target { - margin: -1px -10px; - padding: 0 10px; -} - -/* -- math display ---------------------------------------------------------- */ - -img.math { - vertical-align: middle; -} - -div.body div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -/* -- printout stylesheet --------------------------------------------------- */ - -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0 !important; - width: 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - #top-link { - display: none; - } -} \ No newline at end of file diff --git a/cmf/html/_static/comment-bright.png b/cmf/html/_static/comment-bright.png deleted file mode 100644 index 551517b..0000000 Binary files a/cmf/html/_static/comment-bright.png and /dev/null differ diff --git a/cmf/html/_static/comment-close.png b/cmf/html/_static/comment-close.png deleted file mode 100644 index 09b54be..0000000 Binary files a/cmf/html/_static/comment-close.png and /dev/null differ diff --git a/cmf/html/_static/comment.png b/cmf/html/_static/comment.png deleted file mode 100644 index 92feb52..0000000 Binary files a/cmf/html/_static/comment.png and /dev/null differ diff --git a/cmf/html/_static/default.css b/cmf/html/_static/default.css deleted file mode 100644 index 21f3f50..0000000 --- a/cmf/html/_static/default.css +++ /dev/null @@ -1,256 +0,0 @@ -/* - * default.css_t - * ~~~~~~~~~~~~~ - * - * Sphinx stylesheet -- default theme. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -@import url("basic.css"); - -/* -- page layout ----------------------------------------------------------- */ - -body { - font-family: sans-serif; - font-size: 100%; - background-color: #11303d; - color: #000; - margin: 0; - padding: 0; -} - -div.document { - background-color: #1c4e63; -} - -div.documentwrapper { - float: left; - width: 100%; -} - -div.bodywrapper { - margin: 0 0 0 230px; -} - -div.body { - background-color: #ffffff; - color: #000000; - padding: 0 20px 30px 20px; -} - -div.footer { - color: #ffffff; - width: 100%; - padding: 9px 0 9px 0; - text-align: center; - font-size: 75%; -} - -div.footer a { - color: #ffffff; - text-decoration: underline; -} - -div.related { - background-color: #133f52; - line-height: 30px; - color: #ffffff; -} - -div.related a { - color: #ffffff; -} - -div.sphinxsidebar { -} - -div.sphinxsidebar h3 { - font-family: 'Trebuchet MS', sans-serif; - color: #ffffff; - font-size: 1.4em; - font-weight: normal; - margin: 0; - padding: 0; -} - -div.sphinxsidebar h3 a { - color: #ffffff; -} - -div.sphinxsidebar h4 { - font-family: 'Trebuchet MS', sans-serif; - color: #ffffff; - font-size: 1.3em; - font-weight: normal; - margin: 5px 0 0 0; - padding: 0; -} - -div.sphinxsidebar p { - color: #ffffff; -} - -div.sphinxsidebar p.topless { - margin: 5px 10px 10px 10px; -} - -div.sphinxsidebar ul { - margin: 10px; - padding: 0; - color: #ffffff; -} - -div.sphinxsidebar a { - color: #98dbcc; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - - - -/* -- hyperlink styles ------------------------------------------------------ */ - -a { - color: #355f7c; - text-decoration: none; -} - -a:visited { - color: #355f7c; - text-decoration: none; -} - -a:hover { - text-decoration: underline; -} - - - -/* -- body styles ----------------------------------------------------------- */ - -div.body h1, -div.body h2, -div.body h3, -div.body h4, -div.body h5, -div.body h6 { - font-family: 'Trebuchet MS', sans-serif; - background-color: #f2f2f2; - font-weight: normal; - color: #20435c; - border-bottom: 1px solid #ccc; - margin: 20px -20px 10px -20px; - padding: 3px 0 3px 10px; -} - -div.body h1 { margin-top: 0; font-size: 200%; } -div.body h2 { font-size: 160%; } -div.body h3 { font-size: 140%; } -div.body h4 { font-size: 120%; } -div.body h5 { font-size: 110%; } -div.body h6 { font-size: 100%; } - -a.headerlink { - color: #c60f0f; - font-size: 0.8em; - padding: 0 4px 0 4px; - text-decoration: none; -} - -a.headerlink:hover { - background-color: #c60f0f; - color: white; -} - -div.body p, div.body dd, div.body li { - text-align: justify; - line-height: 130%; -} - -div.admonition p.admonition-title + p { - display: inline; -} - -div.admonition p { - margin-bottom: 5px; -} - -div.admonition pre { - margin-bottom: 5px; -} - -div.admonition ul, div.admonition ol { - margin-bottom: 5px; -} - -div.note { - background-color: #eee; - border: 1px solid #ccc; -} - -div.seealso { - background-color: #ffc; - border: 1px solid #ff6; -} - -div.topic { - background-color: #eee; -} - -div.warning { - background-color: #ffe4e4; - border: 1px solid #f66; -} - -p.admonition-title { - display: inline; -} - -p.admonition-title:after { - content: ":"; -} - -pre { - padding: 5px; - background-color: #eeffcc; - color: #333333; - line-height: 120%; - border: 1px solid #ac9; - border-left: none; - border-right: none; -} - -tt { - background-color: #ecf0f3; - padding: 0 1px 0 1px; - font-size: 0.95em; -} - -th { - background-color: #ede; -} - -.warning tt { - background: #efc2c2; -} - -.note tt { - background: #d6d6d6; -} - -.viewcode-back { - font-family: sans-serif; -} - -div.viewcode-block:target { - background-color: #f4debf; - border-top: 1px solid #ac9; - border-bottom: 1px solid #ac9; -} \ No newline at end of file diff --git a/cmf/html/_static/doctools.js b/cmf/html/_static/doctools.js deleted file mode 100644 index d4619fd..0000000 --- a/cmf/html/_static/doctools.js +++ /dev/null @@ -1,247 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Sphinx JavaScript utilities for all documentation. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - -/** - * make the code below compatible with browsers without - * an installed firebug like debugger -if (!window.console || !console.firebug) { - var names = ["log", "debug", "info", "warn", "error", "assert", "dir", - "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", - "profile", "profileEnd"]; - window.console = {}; - for (var i = 0; i < names.length; ++i) - window.console[names[i]] = function() {}; -} - */ - -/** - * small helper function to urldecode strings - */ -jQuery.urldecode = function(x) { - return decodeURIComponent(x).replace(/\+/g, ' '); -} - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s == 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -}; - -/** - * small function to check if an array contains - * a given item. - */ -jQuery.contains = function(arr, item) { - for (var i = 0; i < arr.length; i++) { - if (arr[i] == item) - return true; - } - return false; -}; - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node) { - if (node.nodeType == 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && !jQuery(node.parentNode).hasClass(className)) { - var span = document.createElement("span"); - span.className = className; - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this); - }); - } - } - return this.each(function() { - highlight(this); - }); -}; - -/** - * Small JavaScript module for the documentation. - */ -var Documentation = { - - init : function() { - this.fixFirefoxAnchorBug(); - this.highlightSearchWords(); - this.initIndexTable(); - }, - - /** - * i18n support - */ - TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return n == 1 ? 0 : 1; }, - LOCALE : 'unknown', - - // gettext and ngettext don't access this so that the functions - // can safely bound to a different name (_ = Documentation.gettext) - gettext : function(string) { - var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated == 'undefined') - return string; - return (typeof translated == 'string') ? translated : translated[0]; - }, - - ngettext : function(singular, plural, n) { - var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated == 'undefined') - return (n == 1) ? singular : plural; - return translated[Documentation.PLURALEXPR(n)]; - }, - - addTranslations : function(catalog) { - for (var key in catalog.messages) - this.TRANSLATIONS[key] = catalog.messages[key]; - this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); - this.LOCALE = catalog.locale; - }, - - /** - * add context elements like header anchor links - */ - addContextElements : function() { - $('div[id] > :header:first').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this headline')). - appendTo(this); - }); - $('dt[id]').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this definition')). - appendTo(this); - }); - }, - - /** - * workaround a firefox stupidity - */ - fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) - window.setTimeout(function() { - document.location.href += ''; - }, 10); - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords : function() { - var params = $.getQueryParameters(); - var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; - if (terms.length) { - var body = $('div.body'); - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlighted'); - }); - }, 10); - $('

            ' + _('Hide Search Matches') + '

            ') - .appendTo($('#searchbox')); - } - }, - - /** - * init the domain index toggle buttons - */ - initIndexTable : function() { - var togglers = $('img.toggler').click(function() { - var src = $(this).attr('src'); - var idnum = $(this).attr('id').substr(7); - $('tr.cg-' + idnum).toggle(); - if (src.substr(-9) == 'minus.png') - $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); - else - $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); - }).css('display', ''); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { - togglers.click(); - } - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords : function() { - $('#searchbox .highlight-link').fadeOut(300); - $('span.highlighted').removeClass('highlighted'); - }, - - /** - * make the url absolute - */ - makeURL : function(relativeURL) { - return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; - }, - - /** - * get the current relative url - */ - getCurrentURL : function() { - var path = document.location.pathname; - var parts = path.split(/\//); - $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this == '..') - parts.pop(); - }); - var url = parts.join('/'); - return path.substring(url.lastIndexOf('/') + 1, path.length - 1); - } -}; - -// quick alias for translations -_ = Documentation.gettext; - -$(document).ready(function() { - Documentation.init(); -}); diff --git a/cmf/html/_static/down-pressed.png b/cmf/html/_static/down-pressed.png deleted file mode 100644 index 6f7ad78..0000000 Binary files a/cmf/html/_static/down-pressed.png and /dev/null differ diff --git a/cmf/html/_static/down.png b/cmf/html/_static/down.png deleted file mode 100644 index 3003a88..0000000 Binary files a/cmf/html/_static/down.png and /dev/null differ diff --git a/cmf/html/_static/file.png b/cmf/html/_static/file.png deleted file mode 100644 index d18082e..0000000 Binary files a/cmf/html/_static/file.png and /dev/null differ diff --git a/cmf/html/_static/jquery.js b/cmf/html/_static/jquery.js deleted file mode 100644 index 7c24308..0000000 --- a/cmf/html/_static/jquery.js +++ /dev/null @@ -1,154 +0,0 @@ -/*! - * jQuery JavaScript Library v1.4.2 - * http://jquery.com/ - * - * Copyright 2010, John Resig - * Dual licensed under the MIT or GPL Version 2 licenses. - * http://jquery.org/license - * - * Includes Sizzle.js - * http://sizzlejs.com/ - * Copyright 2010, The Dojo Foundation - * Released under the MIT, BSD, and GPL Licenses. - * - * Date: Sat Feb 13 22:33:48 2010 -0500 - */ -(function(A,w){function ma(){if(!c.isReady){try{s.documentElement.doScroll("left")}catch(a){setTimeout(ma,1);return}c.ready()}}function Qa(a,b){b.src?c.ajax({url:b.src,async:false,dataType:"script"}):c.globalEval(b.text||b.textContent||b.innerHTML||"");b.parentNode&&b.parentNode.removeChild(b)}function X(a,b,d,f,e,j){var i=a.length;if(typeof b==="object"){for(var o in b)X(a,o,b[o],f,e,d);return a}if(d!==w){f=!j&&f&&c.isFunction(d);for(o=0;o)[^>]*$|^#([\w-]+)$/,Ua=/^.[^:#\[\.,]*$/,Va=/\S/, -Wa=/^(\s|\u00A0)+|(\s|\u00A0)+$/g,Xa=/^<(\w+)\s*\/?>(?:<\/\1>)?$/,P=navigator.userAgent,xa=false,Q=[],L,$=Object.prototype.toString,aa=Object.prototype.hasOwnProperty,ba=Array.prototype.push,R=Array.prototype.slice,ya=Array.prototype.indexOf;c.fn=c.prototype={init:function(a,b){var d,f;if(!a)return this;if(a.nodeType){this.context=this[0]=a;this.length=1;return this}if(a==="body"&&!b){this.context=s;this[0]=s.body;this.selector="body";this.length=1;return this}if(typeof a==="string")if((d=Ta.exec(a))&& -(d[1]||!b))if(d[1]){f=b?b.ownerDocument||b:s;if(a=Xa.exec(a))if(c.isPlainObject(b)){a=[s.createElement(a[1])];c.fn.attr.call(a,b,true)}else a=[f.createElement(a[1])];else{a=sa([d[1]],[f]);a=(a.cacheable?a.fragment.cloneNode(true):a.fragment).childNodes}return c.merge(this,a)}else{if(b=s.getElementById(d[2])){if(b.id!==d[2])return T.find(a);this.length=1;this[0]=b}this.context=s;this.selector=a;return this}else if(!b&&/^\w+$/.test(a)){this.selector=a;this.context=s;a=s.getElementsByTagName(a);return c.merge(this, -a)}else return!b||b.jquery?(b||T).find(a):c(b).find(a);else if(c.isFunction(a))return T.ready(a);if(a.selector!==w){this.selector=a.selector;this.context=a.context}return c.makeArray(a,this)},selector:"",jquery:"1.4.2",length:0,size:function(){return this.length},toArray:function(){return R.call(this,0)},get:function(a){return a==null?this.toArray():a<0?this.slice(a)[0]:this[a]},pushStack:function(a,b,d){var f=c();c.isArray(a)?ba.apply(f,a):c.merge(f,a);f.prevObject=this;f.context=this.context;if(b=== -"find")f.selector=this.selector+(this.selector?" ":"")+d;else if(b)f.selector=this.selector+"."+b+"("+d+")";return f},each:function(a,b){return c.each(this,a,b)},ready:function(a){c.bindReady();if(c.isReady)a.call(s,c);else Q&&Q.push(a);return this},eq:function(a){return a===-1?this.slice(a):this.slice(a,+a+1)},first:function(){return this.eq(0)},last:function(){return this.eq(-1)},slice:function(){return this.pushStack(R.apply(this,arguments),"slice",R.call(arguments).join(","))},map:function(a){return this.pushStack(c.map(this, -function(b,d){return a.call(b,d,b)}))},end:function(){return this.prevObject||c(null)},push:ba,sort:[].sort,splice:[].splice};c.fn.init.prototype=c.fn;c.extend=c.fn.extend=function(){var a=arguments[0]||{},b=1,d=arguments.length,f=false,e,j,i,o;if(typeof a==="boolean"){f=a;a=arguments[1]||{};b=2}if(typeof a!=="object"&&!c.isFunction(a))a={};if(d===b){a=this;--b}for(;b
            a"; -var e=d.getElementsByTagName("*"),j=d.getElementsByTagName("a")[0];if(!(!e||!e.length||!j)){c.support={leadingWhitespace:d.firstChild.nodeType===3,tbody:!d.getElementsByTagName("tbody").length,htmlSerialize:!!d.getElementsByTagName("link").length,style:/red/.test(j.getAttribute("style")),hrefNormalized:j.getAttribute("href")==="/a",opacity:/^0.55$/.test(j.style.opacity),cssFloat:!!j.style.cssFloat,checkOn:d.getElementsByTagName("input")[0].value==="on",optSelected:s.createElement("select").appendChild(s.createElement("option")).selected, -parentNode:d.removeChild(d.appendChild(s.createElement("div"))).parentNode===null,deleteExpando:true,checkClone:false,scriptEval:false,noCloneEvent:true,boxModel:null};b.type="text/javascript";try{b.appendChild(s.createTextNode("window."+f+"=1;"))}catch(i){}a.insertBefore(b,a.firstChild);if(A[f]){c.support.scriptEval=true;delete A[f]}try{delete b.test}catch(o){c.support.deleteExpando=false}a.removeChild(b);if(d.attachEvent&&d.fireEvent){d.attachEvent("onclick",function k(){c.support.noCloneEvent= -false;d.detachEvent("onclick",k)});d.cloneNode(true).fireEvent("onclick")}d=s.createElement("div");d.innerHTML="";a=s.createDocumentFragment();a.appendChild(d.firstChild);c.support.checkClone=a.cloneNode(true).cloneNode(true).lastChild.checked;c(function(){var k=s.createElement("div");k.style.width=k.style.paddingLeft="1px";s.body.appendChild(k);c.boxModel=c.support.boxModel=k.offsetWidth===2;s.body.removeChild(k).style.display="none"});a=function(k){var n= -s.createElement("div");k="on"+k;var r=k in n;if(!r){n.setAttribute(k,"return;");r=typeof n[k]==="function"}return r};c.support.submitBubbles=a("submit");c.support.changeBubbles=a("change");a=b=d=e=j=null}})();c.props={"for":"htmlFor","class":"className",readonly:"readOnly",maxlength:"maxLength",cellspacing:"cellSpacing",rowspan:"rowSpan",colspan:"colSpan",tabindex:"tabIndex",usemap:"useMap",frameborder:"frameBorder"};var G="jQuery"+J(),Ya=0,za={};c.extend({cache:{},expando:G,noData:{embed:true,object:true, -applet:true},data:function(a,b,d){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var f=a[G],e=c.cache;if(!f&&typeof b==="string"&&d===w)return null;f||(f=++Ya);if(typeof b==="object"){a[G]=f;e[f]=c.extend(true,{},b)}else if(!e[f]){a[G]=f;e[f]={}}a=e[f];if(d!==w)a[b]=d;return typeof b==="string"?a[b]:a}},removeData:function(a,b){if(!(a.nodeName&&c.noData[a.nodeName.toLowerCase()])){a=a==A?za:a;var d=a[G],f=c.cache,e=f[d];if(b){if(e){delete e[b];c.isEmptyObject(e)&&c.removeData(a)}}else{if(c.support.deleteExpando)delete a[c.expando]; -else a.removeAttribute&&a.removeAttribute(c.expando);delete f[d]}}}});c.fn.extend({data:function(a,b){if(typeof a==="undefined"&&this.length)return c.data(this[0]);else if(typeof a==="object")return this.each(function(){c.data(this,a)});var d=a.split(".");d[1]=d[1]?"."+d[1]:"";if(b===w){var f=this.triggerHandler("getData"+d[1]+"!",[d[0]]);if(f===w&&this.length)f=c.data(this[0],a);return f===w&&d[1]?this.data(d[0]):f}else return this.trigger("setData"+d[1]+"!",[d[0],b]).each(function(){c.data(this, -a,b)})},removeData:function(a){return this.each(function(){c.removeData(this,a)})}});c.extend({queue:function(a,b,d){if(a){b=(b||"fx")+"queue";var f=c.data(a,b);if(!d)return f||[];if(!f||c.isArray(d))f=c.data(a,b,c.makeArray(d));else f.push(d);return f}},dequeue:function(a,b){b=b||"fx";var d=c.queue(a,b),f=d.shift();if(f==="inprogress")f=d.shift();if(f){b==="fx"&&d.unshift("inprogress");f.call(a,function(){c.dequeue(a,b)})}}});c.fn.extend({queue:function(a,b){if(typeof a!=="string"){b=a;a="fx"}if(b=== -w)return c.queue(this[0],a);return this.each(function(){var d=c.queue(this,a,b);a==="fx"&&d[0]!=="inprogress"&&c.dequeue(this,a)})},dequeue:function(a){return this.each(function(){c.dequeue(this,a)})},delay:function(a,b){a=c.fx?c.fx.speeds[a]||a:a;b=b||"fx";return this.queue(b,function(){var d=this;setTimeout(function(){c.dequeue(d,b)},a)})},clearQueue:function(a){return this.queue(a||"fx",[])}});var Aa=/[\n\t]/g,ca=/\s+/,Za=/\r/g,$a=/href|src|style/,ab=/(button|input)/i,bb=/(button|input|object|select|textarea)/i, -cb=/^(a|area)$/i,Ba=/radio|checkbox/;c.fn.extend({attr:function(a,b){return X(this,a,b,true,c.attr)},removeAttr:function(a){return this.each(function(){c.attr(this,a,"");this.nodeType===1&&this.removeAttribute(a)})},addClass:function(a){if(c.isFunction(a))return this.each(function(n){var r=c(this);r.addClass(a.call(this,n,r.attr("class")))});if(a&&typeof a==="string")for(var b=(a||"").split(ca),d=0,f=this.length;d-1)return true;return false},val:function(a){if(a===w){var b=this[0];if(b){if(c.nodeName(b,"option"))return(b.attributes.value||{}).specified?b.value:b.text;if(c.nodeName(b,"select")){var d=b.selectedIndex,f=[],e=b.options;b=b.type==="select-one";if(d<0)return null;var j=b?d:0;for(d=b?d+1:e.length;j=0;else if(c.nodeName(this,"select")){var u=c.makeArray(r);c("option",this).each(function(){this.selected= -c.inArray(c(this).val(),u)>=0});if(!u.length)this.selectedIndex=-1}else this.value=r}})}});c.extend({attrFn:{val:true,css:true,html:true,text:true,data:true,width:true,height:true,offset:true},attr:function(a,b,d,f){if(!a||a.nodeType===3||a.nodeType===8)return w;if(f&&b in c.attrFn)return c(a)[b](d);f=a.nodeType!==1||!c.isXMLDoc(a);var e=d!==w;b=f&&c.props[b]||b;if(a.nodeType===1){var j=$a.test(b);if(b in a&&f&&!j){if(e){b==="type"&&ab.test(a.nodeName)&&a.parentNode&&c.error("type property can't be changed"); -a[b]=d}if(c.nodeName(a,"form")&&a.getAttributeNode(b))return a.getAttributeNode(b).nodeValue;if(b==="tabIndex")return(b=a.getAttributeNode("tabIndex"))&&b.specified?b.value:bb.test(a.nodeName)||cb.test(a.nodeName)&&a.href?0:w;return a[b]}if(!c.support.style&&f&&b==="style"){if(e)a.style.cssText=""+d;return a.style.cssText}e&&a.setAttribute(b,""+d);a=!c.support.hrefNormalized&&f&&j?a.getAttribute(b,2):a.getAttribute(b);return a===null?w:a}return c.style(a,b,d)}});var O=/\.(.*)$/,db=function(a){return a.replace(/[^\w\s\.\|`]/g, -function(b){return"\\"+b})};c.event={add:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){if(a.setInterval&&a!==A&&!a.frameElement)a=A;var e,j;if(d.handler){e=d;d=e.handler}if(!d.guid)d.guid=c.guid++;if(j=c.data(a)){var i=j.events=j.events||{},o=j.handle;if(!o)j.handle=o=function(){return typeof c!=="undefined"&&!c.event.triggered?c.event.handle.apply(o.elem,arguments):w};o.elem=a;b=b.split(" ");for(var k,n=0,r;k=b[n++];){j=e?c.extend({},e):{handler:d,data:f};if(k.indexOf(".")>-1){r=k.split("."); -k=r.shift();j.namespace=r.slice(0).sort().join(".")}else{r=[];j.namespace=""}j.type=k;j.guid=d.guid;var u=i[k],z=c.event.special[k]||{};if(!u){u=i[k]=[];if(!z.setup||z.setup.call(a,f,r,o)===false)if(a.addEventListener)a.addEventListener(k,o,false);else a.attachEvent&&a.attachEvent("on"+k,o)}if(z.add){z.add.call(a,j);if(!j.handler.guid)j.handler.guid=d.guid}u.push(j);c.event.global[k]=true}a=null}}},global:{},remove:function(a,b,d,f){if(!(a.nodeType===3||a.nodeType===8)){var e,j=0,i,o,k,n,r,u,z=c.data(a), -C=z&&z.events;if(z&&C){if(b&&b.type){d=b.handler;b=b.type}if(!b||typeof b==="string"&&b.charAt(0)==="."){b=b||"";for(e in C)c.event.remove(a,e+b)}else{for(b=b.split(" ");e=b[j++];){n=e;i=e.indexOf(".")<0;o=[];if(!i){o=e.split(".");e=o.shift();k=new RegExp("(^|\\.)"+c.map(o.slice(0).sort(),db).join("\\.(?:.*\\.)?")+"(\\.|$)")}if(r=C[e])if(d){n=c.event.special[e]||{};for(B=f||0;B=0){a.type= -e=e.slice(0,-1);a.exclusive=true}if(!d){a.stopPropagation();c.event.global[e]&&c.each(c.cache,function(){this.events&&this.events[e]&&c.event.trigger(a,b,this.handle.elem)})}if(!d||d.nodeType===3||d.nodeType===8)return w;a.result=w;a.target=d;b=c.makeArray(b);b.unshift(a)}a.currentTarget=d;(f=c.data(d,"handle"))&&f.apply(d,b);f=d.parentNode||d.ownerDocument;try{if(!(d&&d.nodeName&&c.noData[d.nodeName.toLowerCase()]))if(d["on"+e]&&d["on"+e].apply(d,b)===false)a.result=false}catch(j){}if(!a.isPropagationStopped()&& -f)c.event.trigger(a,b,f,true);else if(!a.isDefaultPrevented()){f=a.target;var i,o=c.nodeName(f,"a")&&e==="click",k=c.event.special[e]||{};if((!k._default||k._default.call(d,a)===false)&&!o&&!(f&&f.nodeName&&c.noData[f.nodeName.toLowerCase()])){try{if(f[e]){if(i=f["on"+e])f["on"+e]=null;c.event.triggered=true;f[e]()}}catch(n){}if(i)f["on"+e]=i;c.event.triggered=false}}},handle:function(a){var b,d,f,e;a=arguments[0]=c.event.fix(a||A.event);a.currentTarget=this;b=a.type.indexOf(".")<0&&!a.exclusive; -if(!b){d=a.type.split(".");a.type=d.shift();f=new RegExp("(^|\\.)"+d.slice(0).sort().join("\\.(?:.*\\.)?")+"(\\.|$)")}e=c.data(this,"events");d=e[a.type];if(e&&d){d=d.slice(0);e=0;for(var j=d.length;e-1?c.map(a.options,function(f){return f.selected}).join("-"):"";else if(a.nodeName.toLowerCase()==="select")d=a.selectedIndex;return d},fa=function(a,b){var d=a.target,f,e;if(!(!da.test(d.nodeName)||d.readOnly)){f=c.data(d,"_change_data");e=Fa(d);if(a.type!=="focusout"||d.type!=="radio")c.data(d,"_change_data", -e);if(!(f===w||e===f))if(f!=null||e){a.type="change";return c.event.trigger(a,b,d)}}};c.event.special.change={filters:{focusout:fa,click:function(a){var b=a.target,d=b.type;if(d==="radio"||d==="checkbox"||b.nodeName.toLowerCase()==="select")return fa.call(this,a)},keydown:function(a){var b=a.target,d=b.type;if(a.keyCode===13&&b.nodeName.toLowerCase()!=="textarea"||a.keyCode===32&&(d==="checkbox"||d==="radio")||d==="select-multiple")return fa.call(this,a)},beforeactivate:function(a){a=a.target;c.data(a, -"_change_data",Fa(a))}},setup:function(){if(this.type==="file")return false;for(var a in ea)c.event.add(this,a+".specialChange",ea[a]);return da.test(this.nodeName)},teardown:function(){c.event.remove(this,".specialChange");return da.test(this.nodeName)}};ea=c.event.special.change.filters}s.addEventListener&&c.each({focus:"focusin",blur:"focusout"},function(a,b){function d(f){f=c.event.fix(f);f.type=b;return c.event.handle.call(this,f)}c.event.special[b]={setup:function(){this.addEventListener(a, -d,true)},teardown:function(){this.removeEventListener(a,d,true)}}});c.each(["bind","one"],function(a,b){c.fn[b]=function(d,f,e){if(typeof d==="object"){for(var j in d)this[b](j,f,d[j],e);return this}if(c.isFunction(f)){e=f;f=w}var i=b==="one"?c.proxy(e,function(k){c(this).unbind(k,i);return e.apply(this,arguments)}):e;if(d==="unload"&&b!=="one")this.one(d,f,e);else{j=0;for(var o=this.length;j0){y=t;break}}t=t[g]}m[q]=y}}}var f=/((?:\((?:\([^()]+\)|[^()]+)+\)|\[(?:\[[^[\]]*\]|['"][^'"]*['"]|[^[\]'"]+)+\]|\\.|[^ >+~,(\[\\]+)+|[>+~])(\s*,\s*)?((?:.|\r|\n)*)/g, -e=0,j=Object.prototype.toString,i=false,o=true;[0,0].sort(function(){o=false;return 0});var k=function(g,h,l,m){l=l||[];var q=h=h||s;if(h.nodeType!==1&&h.nodeType!==9)return[];if(!g||typeof g!=="string")return l;for(var p=[],v,t,y,S,H=true,M=x(h),I=g;(f.exec(""),v=f.exec(I))!==null;){I=v[3];p.push(v[1]);if(v[2]){S=v[3];break}}if(p.length>1&&r.exec(g))if(p.length===2&&n.relative[p[0]])t=ga(p[0]+p[1],h);else for(t=n.relative[p[0]]?[h]:k(p.shift(),h);p.length;){g=p.shift();if(n.relative[g])g+=p.shift(); -t=ga(g,t)}else{if(!m&&p.length>1&&h.nodeType===9&&!M&&n.match.ID.test(p[0])&&!n.match.ID.test(p[p.length-1])){v=k.find(p.shift(),h,M);h=v.expr?k.filter(v.expr,v.set)[0]:v.set[0]}if(h){v=m?{expr:p.pop(),set:z(m)}:k.find(p.pop(),p.length===1&&(p[0]==="~"||p[0]==="+")&&h.parentNode?h.parentNode:h,M);t=v.expr?k.filter(v.expr,v.set):v.set;if(p.length>0)y=z(t);else H=false;for(;p.length;){var D=p.pop();v=D;if(n.relative[D])v=p.pop();else D="";if(v==null)v=h;n.relative[D](y,v,M)}}else y=[]}y||(y=t);y||k.error(D|| -g);if(j.call(y)==="[object Array]")if(H)if(h&&h.nodeType===1)for(g=0;y[g]!=null;g++){if(y[g]&&(y[g]===true||y[g].nodeType===1&&E(h,y[g])))l.push(t[g])}else for(g=0;y[g]!=null;g++)y[g]&&y[g].nodeType===1&&l.push(t[g]);else l.push.apply(l,y);else z(y,l);if(S){k(S,q,l,m);k.uniqueSort(l)}return l};k.uniqueSort=function(g){if(B){i=o;g.sort(B);if(i)for(var h=1;h":function(g,h){var l=typeof h==="string";if(l&&!/\W/.test(h)){h=h.toLowerCase();for(var m=0,q=g.length;m=0))l||m.push(v);else if(l)h[p]=false;return false},ID:function(g){return g[1].replace(/\\/g,"")},TAG:function(g){return g[1].toLowerCase()}, -CHILD:function(g){if(g[1]==="nth"){var h=/(-?)(\d*)n((?:\+|-)?\d*)/.exec(g[2]==="even"&&"2n"||g[2]==="odd"&&"2n+1"||!/\D/.test(g[2])&&"0n+"+g[2]||g[2]);g[2]=h[1]+(h[2]||1)-0;g[3]=h[3]-0}g[0]=e++;return g},ATTR:function(g,h,l,m,q,p){h=g[1].replace(/\\/g,"");if(!p&&n.attrMap[h])g[1]=n.attrMap[h];if(g[2]==="~=")g[4]=" "+g[4]+" ";return g},PSEUDO:function(g,h,l,m,q){if(g[1]==="not")if((f.exec(g[3])||"").length>1||/^\w/.test(g[3]))g[3]=k(g[3],null,null,h);else{g=k.filter(g[3],h,l,true^q);l||m.push.apply(m, -g);return false}else if(n.match.POS.test(g[0])||n.match.CHILD.test(g[0]))return true;return g},POS:function(g){g.unshift(true);return g}},filters:{enabled:function(g){return g.disabled===false&&g.type!=="hidden"},disabled:function(g){return g.disabled===true},checked:function(g){return g.checked===true},selected:function(g){return g.selected===true},parent:function(g){return!!g.firstChild},empty:function(g){return!g.firstChild},has:function(g,h,l){return!!k(l[3],g).length},header:function(g){return/h\d/i.test(g.nodeName)}, -text:function(g){return"text"===g.type},radio:function(g){return"radio"===g.type},checkbox:function(g){return"checkbox"===g.type},file:function(g){return"file"===g.type},password:function(g){return"password"===g.type},submit:function(g){return"submit"===g.type},image:function(g){return"image"===g.type},reset:function(g){return"reset"===g.type},button:function(g){return"button"===g.type||g.nodeName.toLowerCase()==="button"},input:function(g){return/input|select|textarea|button/i.test(g.nodeName)}}, -setFilters:{first:function(g,h){return h===0},last:function(g,h,l,m){return h===m.length-1},even:function(g,h){return h%2===0},odd:function(g,h){return h%2===1},lt:function(g,h,l){return hl[3]-0},nth:function(g,h,l){return l[3]-0===h},eq:function(g,h,l){return l[3]-0===h}},filter:{PSEUDO:function(g,h,l,m){var q=h[1],p=n.filters[q];if(p)return p(g,l,h,m);else if(q==="contains")return(g.textContent||g.innerText||a([g])||"").indexOf(h[3])>=0;else if(q==="not"){h= -h[3];l=0;for(m=h.length;l=0}},ID:function(g,h){return g.nodeType===1&&g.getAttribute("id")===h},TAG:function(g,h){return h==="*"&&g.nodeType===1||g.nodeName.toLowerCase()===h},CLASS:function(g,h){return(" "+(g.className||g.getAttribute("class"))+" ").indexOf(h)>-1},ATTR:function(g,h){var l=h[1];g=n.attrHandle[l]?n.attrHandle[l](g):g[l]!=null?g[l]:g.getAttribute(l);l=g+"";var m=h[2];h=h[4];return g==null?m==="!=":m=== -"="?l===h:m==="*="?l.indexOf(h)>=0:m==="~="?(" "+l+" ").indexOf(h)>=0:!h?l&&g!==false:m==="!="?l!==h:m==="^="?l.indexOf(h)===0:m==="$="?l.substr(l.length-h.length)===h:m==="|="?l===h||l.substr(0,h.length+1)===h+"-":false},POS:function(g,h,l,m){var q=n.setFilters[h[2]];if(q)return q(g,l,h,m)}}},r=n.match.POS;for(var u in n.match){n.match[u]=new RegExp(n.match[u].source+/(?![^\[]*\])(?![^\(]*\))/.source);n.leftMatch[u]=new RegExp(/(^(?:.|\r|\n)*?)/.source+n.match[u].source.replace(/\\(\d+)/g,function(g, -h){return"\\"+(h-0+1)}))}var z=function(g,h){g=Array.prototype.slice.call(g,0);if(h){h.push.apply(h,g);return h}return g};try{Array.prototype.slice.call(s.documentElement.childNodes,0)}catch(C){z=function(g,h){h=h||[];if(j.call(g)==="[object Array]")Array.prototype.push.apply(h,g);else if(typeof g.length==="number")for(var l=0,m=g.length;l";var l=s.documentElement;l.insertBefore(g,l.firstChild);if(s.getElementById(h)){n.find.ID=function(m,q,p){if(typeof q.getElementById!=="undefined"&&!p)return(q=q.getElementById(m[1]))?q.id===m[1]||typeof q.getAttributeNode!=="undefined"&& -q.getAttributeNode("id").nodeValue===m[1]?[q]:w:[]};n.filter.ID=function(m,q){var p=typeof m.getAttributeNode!=="undefined"&&m.getAttributeNode("id");return m.nodeType===1&&p&&p.nodeValue===q}}l.removeChild(g);l=g=null})();(function(){var g=s.createElement("div");g.appendChild(s.createComment(""));if(g.getElementsByTagName("*").length>0)n.find.TAG=function(h,l){l=l.getElementsByTagName(h[1]);if(h[1]==="*"){h=[];for(var m=0;l[m];m++)l[m].nodeType===1&&h.push(l[m]);l=h}return l};g.innerHTML=""; -if(g.firstChild&&typeof g.firstChild.getAttribute!=="undefined"&&g.firstChild.getAttribute("href")!=="#")n.attrHandle.href=function(h){return h.getAttribute("href",2)};g=null})();s.querySelectorAll&&function(){var g=k,h=s.createElement("div");h.innerHTML="

            ";if(!(h.querySelectorAll&&h.querySelectorAll(".TEST").length===0)){k=function(m,q,p,v){q=q||s;if(!v&&q.nodeType===9&&!x(q))try{return z(q.querySelectorAll(m),p)}catch(t){}return g(m,q,p,v)};for(var l in g)k[l]=g[l];h=null}}(); -(function(){var g=s.createElement("div");g.innerHTML="
            ";if(!(!g.getElementsByClassName||g.getElementsByClassName("e").length===0)){g.lastChild.className="e";if(g.getElementsByClassName("e").length!==1){n.order.splice(1,0,"CLASS");n.find.CLASS=function(h,l,m){if(typeof l.getElementsByClassName!=="undefined"&&!m)return l.getElementsByClassName(h[1])};g=null}}})();var E=s.compareDocumentPosition?function(g,h){return!!(g.compareDocumentPosition(h)&16)}: -function(g,h){return g!==h&&(g.contains?g.contains(h):true)},x=function(g){return(g=(g?g.ownerDocument||g:0).documentElement)?g.nodeName!=="HTML":false},ga=function(g,h){var l=[],m="",q;for(h=h.nodeType?[h]:h;q=n.match.PSEUDO.exec(g);){m+=q[0];g=g.replace(n.match.PSEUDO,"")}g=n.relative[g]?g+"*":g;q=0;for(var p=h.length;q=0===d})};c.fn.extend({find:function(a){for(var b=this.pushStack("","find",a),d=0,f=0,e=this.length;f0)for(var j=d;j0},closest:function(a,b){if(c.isArray(a)){var d=[],f=this[0],e,j= -{},i;if(f&&a.length){e=0;for(var o=a.length;e-1:c(f).is(e)){d.push({selector:i,elem:f});delete j[i]}}f=f.parentNode}}return d}var k=c.expr.match.POS.test(a)?c(a,b||this.context):null;return this.map(function(n,r){for(;r&&r.ownerDocument&&r!==b;){if(k?k.index(r)>-1:c(r).is(a))return r;r=r.parentNode}return null})},index:function(a){if(!a||typeof a=== -"string")return c.inArray(this[0],a?c(a):this.parent().children());return c.inArray(a.jquery?a[0]:a,this)},add:function(a,b){a=typeof a==="string"?c(a,b||this.context):c.makeArray(a);b=c.merge(this.get(),a);return this.pushStack(qa(a[0])||qa(b[0])?b:c.unique(b))},andSelf:function(){return this.add(this.prevObject)}});c.each({parent:function(a){return(a=a.parentNode)&&a.nodeType!==11?a:null},parents:function(a){return c.dir(a,"parentNode")},parentsUntil:function(a,b,d){return c.dir(a,"parentNode", -d)},next:function(a){return c.nth(a,2,"nextSibling")},prev:function(a){return c.nth(a,2,"previousSibling")},nextAll:function(a){return c.dir(a,"nextSibling")},prevAll:function(a){return c.dir(a,"previousSibling")},nextUntil:function(a,b,d){return c.dir(a,"nextSibling",d)},prevUntil:function(a,b,d){return c.dir(a,"previousSibling",d)},siblings:function(a){return c.sibling(a.parentNode.firstChild,a)},children:function(a){return c.sibling(a.firstChild)},contents:function(a){return c.nodeName(a,"iframe")? -a.contentDocument||a.contentWindow.document:c.makeArray(a.childNodes)}},function(a,b){c.fn[a]=function(d,f){var e=c.map(this,b,d);eb.test(a)||(f=d);if(f&&typeof f==="string")e=c.filter(f,e);e=this.length>1?c.unique(e):e;if((this.length>1||gb.test(f))&&fb.test(a))e=e.reverse();return this.pushStack(e,a,R.call(arguments).join(","))}});c.extend({filter:function(a,b,d){if(d)a=":not("+a+")";return c.find.matches(a,b)},dir:function(a,b,d){var f=[];for(a=a[b];a&&a.nodeType!==9&&(d===w||a.nodeType!==1||!c(a).is(d));){a.nodeType=== -1&&f.push(a);a=a[b]}return f},nth:function(a,b,d){b=b||1;for(var f=0;a;a=a[d])if(a.nodeType===1&&++f===b)break;return a},sibling:function(a,b){for(var d=[];a;a=a.nextSibling)a.nodeType===1&&a!==b&&d.push(a);return d}});var Ja=/ jQuery\d+="(?:\d+|null)"/g,V=/^\s+/,Ka=/(<([\w:]+)[^>]*?)\/>/g,hb=/^(?:area|br|col|embed|hr|img|input|link|meta|param)$/i,La=/<([\w:]+)/,ib=/"},F={option:[1,""],legend:[1,"
            ","
            "],thead:[1,"","
            "],tr:[2,"","
            "],td:[3,"","
            "],col:[2,"","
            "],area:[1,"",""],_default:[0,"",""]};F.optgroup=F.option;F.tbody=F.tfoot=F.colgroup=F.caption=F.thead;F.th=F.td;if(!c.support.htmlSerialize)F._default=[1,"div
            ","
            "];c.fn.extend({text:function(a){if(c.isFunction(a))return this.each(function(b){var d= -c(this);d.text(a.call(this,b,d.text()))});if(typeof a!=="object"&&a!==w)return this.empty().append((this[0]&&this[0].ownerDocument||s).createTextNode(a));return c.text(this)},wrapAll:function(a){if(c.isFunction(a))return this.each(function(d){c(this).wrapAll(a.call(this,d))});if(this[0]){var b=c(a,this[0].ownerDocument).eq(0).clone(true);this[0].parentNode&&b.insertBefore(this[0]);b.map(function(){for(var d=this;d.firstChild&&d.firstChild.nodeType===1;)d=d.firstChild;return d}).append(this)}return this}, -wrapInner:function(a){if(c.isFunction(a))return this.each(function(b){c(this).wrapInner(a.call(this,b))});return this.each(function(){var b=c(this),d=b.contents();d.length?d.wrapAll(a):b.append(a)})},wrap:function(a){return this.each(function(){c(this).wrapAll(a)})},unwrap:function(){return this.parent().each(function(){c.nodeName(this,"body")||c(this).replaceWith(this.childNodes)}).end()},append:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.appendChild(a)})}, -prepend:function(){return this.domManip(arguments,true,function(a){this.nodeType===1&&this.insertBefore(a,this.firstChild)})},before:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b,this)});else if(arguments.length){var a=c(arguments[0]);a.push.apply(a,this.toArray());return this.pushStack(a,"before",arguments)}},after:function(){if(this[0]&&this[0].parentNode)return this.domManip(arguments,false,function(b){this.parentNode.insertBefore(b, -this.nextSibling)});else if(arguments.length){var a=this.pushStack(this,"after",arguments);a.push.apply(a,c(arguments[0]).toArray());return a}},remove:function(a,b){for(var d=0,f;(f=this[d])!=null;d++)if(!a||c.filter(a,[f]).length){if(!b&&f.nodeType===1){c.cleanData(f.getElementsByTagName("*"));c.cleanData([f])}f.parentNode&&f.parentNode.removeChild(f)}return this},empty:function(){for(var a=0,b;(b=this[a])!=null;a++)for(b.nodeType===1&&c.cleanData(b.getElementsByTagName("*"));b.firstChild;)b.removeChild(b.firstChild); -return this},clone:function(a){var b=this.map(function(){if(!c.support.noCloneEvent&&!c.isXMLDoc(this)){var d=this.outerHTML,f=this.ownerDocument;if(!d){d=f.createElement("div");d.appendChild(this.cloneNode(true));d=d.innerHTML}return c.clean([d.replace(Ja,"").replace(/=([^="'>\s]+\/)>/g,'="$1">').replace(V,"")],f)[0]}else return this.cloneNode(true)});if(a===true){ra(this,b);ra(this.find("*"),b.find("*"))}return b},html:function(a){if(a===w)return this[0]&&this[0].nodeType===1?this[0].innerHTML.replace(Ja, -""):null;else if(typeof a==="string"&&!ta.test(a)&&(c.support.leadingWhitespace||!V.test(a))&&!F[(La.exec(a)||["",""])[1].toLowerCase()]){a=a.replace(Ka,Ma);try{for(var b=0,d=this.length;b0||e.cacheable||this.length>1?k.cloneNode(true):k)}o.length&&c.each(o,Qa)}return this}});c.fragments={};c.each({appendTo:"append",prependTo:"prepend",insertBefore:"before",insertAfter:"after",replaceAll:"replaceWith"},function(a,b){c.fn[a]=function(d){var f=[];d=c(d);var e=this.length===1&&this[0].parentNode;if(e&&e.nodeType===11&&e.childNodes.length===1&&d.length===1){d[b](this[0]); -return this}else{e=0;for(var j=d.length;e0?this.clone(true):this).get();c.fn[b].apply(c(d[e]),i);f=f.concat(i)}return this.pushStack(f,a,d.selector)}}});c.extend({clean:function(a,b,d,f){b=b||s;if(typeof b.createElement==="undefined")b=b.ownerDocument||b[0]&&b[0].ownerDocument||s;for(var e=[],j=0,i;(i=a[j])!=null;j++){if(typeof i==="number")i+="";if(i){if(typeof i==="string"&&!jb.test(i))i=b.createTextNode(i);else if(typeof i==="string"){i=i.replace(Ka,Ma);var o=(La.exec(i)||["", -""])[1].toLowerCase(),k=F[o]||F._default,n=k[0],r=b.createElement("div");for(r.innerHTML=k[1]+i+k[2];n--;)r=r.lastChild;if(!c.support.tbody){n=ib.test(i);o=o==="table"&&!n?r.firstChild&&r.firstChild.childNodes:k[1]===""&&!n?r.childNodes:[];for(k=o.length-1;k>=0;--k)c.nodeName(o[k],"tbody")&&!o[k].childNodes.length&&o[k].parentNode.removeChild(o[k])}!c.support.leadingWhitespace&&V.test(i)&&r.insertBefore(b.createTextNode(V.exec(i)[0]),r.firstChild);i=r.childNodes}if(i.nodeType)e.push(i);else e= -c.merge(e,i)}}if(d)for(j=0;e[j];j++)if(f&&c.nodeName(e[j],"script")&&(!e[j].type||e[j].type.toLowerCase()==="text/javascript"))f.push(e[j].parentNode?e[j].parentNode.removeChild(e[j]):e[j]);else{e[j].nodeType===1&&e.splice.apply(e,[j+1,0].concat(c.makeArray(e[j].getElementsByTagName("script"))));d.appendChild(e[j])}return e},cleanData:function(a){for(var b,d,f=c.cache,e=c.event.special,j=c.support.deleteExpando,i=0,o;(o=a[i])!=null;i++)if(d=o[c.expando]){b=f[d];if(b.events)for(var k in b.events)e[k]? -c.event.remove(o,k):Ca(o,k,b.handle);if(j)delete o[c.expando];else o.removeAttribute&&o.removeAttribute(c.expando);delete f[d]}}});var kb=/z-?index|font-?weight|opacity|zoom|line-?height/i,Na=/alpha\([^)]*\)/,Oa=/opacity=([^)]*)/,ha=/float/i,ia=/-([a-z])/ig,lb=/([A-Z])/g,mb=/^-?\d+(?:px)?$/i,nb=/^-?\d/,ob={position:"absolute",visibility:"hidden",display:"block"},pb=["Left","Right"],qb=["Top","Bottom"],rb=s.defaultView&&s.defaultView.getComputedStyle,Pa=c.support.cssFloat?"cssFloat":"styleFloat",ja= -function(a,b){return b.toUpperCase()};c.fn.css=function(a,b){return X(this,a,b,true,function(d,f,e){if(e===w)return c.curCSS(d,f);if(typeof e==="number"&&!kb.test(f))e+="px";c.style(d,f,e)})};c.extend({style:function(a,b,d){if(!a||a.nodeType===3||a.nodeType===8)return w;if((b==="width"||b==="height")&&parseFloat(d)<0)d=w;var f=a.style||a,e=d!==w;if(!c.support.opacity&&b==="opacity"){if(e){f.zoom=1;b=parseInt(d,10)+""==="NaN"?"":"alpha(opacity="+d*100+")";a=f.filter||c.curCSS(a,"filter")||"";f.filter= -Na.test(a)?a.replace(Na,b):b}return f.filter&&f.filter.indexOf("opacity=")>=0?parseFloat(Oa.exec(f.filter)[1])/100+"":""}if(ha.test(b))b=Pa;b=b.replace(ia,ja);if(e)f[b]=d;return f[b]},css:function(a,b,d,f){if(b==="width"||b==="height"){var e,j=b==="width"?pb:qb;function i(){e=b==="width"?a.offsetWidth:a.offsetHeight;f!=="border"&&c.each(j,function(){f||(e-=parseFloat(c.curCSS(a,"padding"+this,true))||0);if(f==="margin")e+=parseFloat(c.curCSS(a,"margin"+this,true))||0;else e-=parseFloat(c.curCSS(a, -"border"+this+"Width",true))||0})}a.offsetWidth!==0?i():c.swap(a,ob,i);return Math.max(0,Math.round(e))}return c.curCSS(a,b,d)},curCSS:function(a,b,d){var f,e=a.style;if(!c.support.opacity&&b==="opacity"&&a.currentStyle){f=Oa.test(a.currentStyle.filter||"")?parseFloat(RegExp.$1)/100+"":"";return f===""?"1":f}if(ha.test(b))b=Pa;if(!d&&e&&e[b])f=e[b];else if(rb){if(ha.test(b))b="float";b=b.replace(lb,"-$1").toLowerCase();e=a.ownerDocument.defaultView;if(!e)return null;if(a=e.getComputedStyle(a,null))f= -a.getPropertyValue(b);if(b==="opacity"&&f==="")f="1"}else if(a.currentStyle){d=b.replace(ia,ja);f=a.currentStyle[b]||a.currentStyle[d];if(!mb.test(f)&&nb.test(f)){b=e.left;var j=a.runtimeStyle.left;a.runtimeStyle.left=a.currentStyle.left;e.left=d==="fontSize"?"1em":f||0;f=e.pixelLeft+"px";e.left=b;a.runtimeStyle.left=j}}return f},swap:function(a,b,d){var f={};for(var e in b){f[e]=a.style[e];a.style[e]=b[e]}d.call(a);for(e in b)a.style[e]=f[e]}});if(c.expr&&c.expr.filters){c.expr.filters.hidden=function(a){var b= -a.offsetWidth,d=a.offsetHeight,f=a.nodeName.toLowerCase()==="tr";return b===0&&d===0&&!f?true:b>0&&d>0&&!f?false:c.curCSS(a,"display")==="none"};c.expr.filters.visible=function(a){return!c.expr.filters.hidden(a)}}var sb=J(),tb=//gi,ub=/select|textarea/i,vb=/color|date|datetime|email|hidden|month|number|password|range|search|tel|text|time|url|week/i,N=/=\?(&|$)/,ka=/\?/,wb=/(\?|&)_=.*?(&|$)/,xb=/^(\w+:)?\/\/([^\/?#]+)/,yb=/%20/g,zb=c.fn.load;c.fn.extend({load:function(a,b,d){if(typeof a!== -"string")return zb.call(this,a);else if(!this.length)return this;var f=a.indexOf(" ");if(f>=0){var e=a.slice(f,a.length);a=a.slice(0,f)}f="GET";if(b)if(c.isFunction(b)){d=b;b=null}else if(typeof b==="object"){b=c.param(b,c.ajaxSettings.traditional);f="POST"}var j=this;c.ajax({url:a,type:f,dataType:"html",data:b,complete:function(i,o){if(o==="success"||o==="notmodified")j.html(e?c("
            ").append(i.responseText.replace(tb,"")).find(e):i.responseText);d&&j.each(d,[i.responseText,o,i])}});return this}, -serialize:function(){return c.param(this.serializeArray())},serializeArray:function(){return this.map(function(){return this.elements?c.makeArray(this.elements):this}).filter(function(){return this.name&&!this.disabled&&(this.checked||ub.test(this.nodeName)||vb.test(this.type))}).map(function(a,b){a=c(this).val();return a==null?null:c.isArray(a)?c.map(a,function(d){return{name:b.name,value:d}}):{name:b.name,value:a}}).get()}});c.each("ajaxStart ajaxStop ajaxComplete ajaxError ajaxSuccess ajaxSend".split(" "), -function(a,b){c.fn[b]=function(d){return this.bind(b,d)}});c.extend({get:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b=null}return c.ajax({type:"GET",url:a,data:b,success:d,dataType:f})},getScript:function(a,b){return c.get(a,null,b,"script")},getJSON:function(a,b,d){return c.get(a,b,d,"json")},post:function(a,b,d,f){if(c.isFunction(b)){f=f||d;d=b;b={}}return c.ajax({type:"POST",url:a,data:b,success:d,dataType:f})},ajaxSetup:function(a){c.extend(c.ajaxSettings,a)},ajaxSettings:{url:location.href, -global:true,type:"GET",contentType:"application/x-www-form-urlencoded",processData:true,async:true,xhr:A.XMLHttpRequest&&(A.location.protocol!=="file:"||!A.ActiveXObject)?function(){return new A.XMLHttpRequest}:function(){try{return new A.ActiveXObject("Microsoft.XMLHTTP")}catch(a){}},accepts:{xml:"application/xml, text/xml",html:"text/html",script:"text/javascript, application/javascript",json:"application/json, text/javascript",text:"text/plain",_default:"*/*"}},lastModified:{},etag:{},ajax:function(a){function b(){e.success&& -e.success.call(k,o,i,x);e.global&&f("ajaxSuccess",[x,e])}function d(){e.complete&&e.complete.call(k,x,i);e.global&&f("ajaxComplete",[x,e]);e.global&&!--c.active&&c.event.trigger("ajaxStop")}function f(q,p){(e.context?c(e.context):c.event).trigger(q,p)}var e=c.extend(true,{},c.ajaxSettings,a),j,i,o,k=a&&a.context||e,n=e.type.toUpperCase();if(e.data&&e.processData&&typeof e.data!=="string")e.data=c.param(e.data,e.traditional);if(e.dataType==="jsonp"){if(n==="GET")N.test(e.url)||(e.url+=(ka.test(e.url)? -"&":"?")+(e.jsonp||"callback")+"=?");else if(!e.data||!N.test(e.data))e.data=(e.data?e.data+"&":"")+(e.jsonp||"callback")+"=?";e.dataType="json"}if(e.dataType==="json"&&(e.data&&N.test(e.data)||N.test(e.url))){j=e.jsonpCallback||"jsonp"+sb++;if(e.data)e.data=(e.data+"").replace(N,"="+j+"$1");e.url=e.url.replace(N,"="+j+"$1");e.dataType="script";A[j]=A[j]||function(q){o=q;b();d();A[j]=w;try{delete A[j]}catch(p){}z&&z.removeChild(C)}}if(e.dataType==="script"&&e.cache===null)e.cache=false;if(e.cache=== -false&&n==="GET"){var r=J(),u=e.url.replace(wb,"$1_="+r+"$2");e.url=u+(u===e.url?(ka.test(e.url)?"&":"?")+"_="+r:"")}if(e.data&&n==="GET")e.url+=(ka.test(e.url)?"&":"?")+e.data;e.global&&!c.active++&&c.event.trigger("ajaxStart");r=(r=xb.exec(e.url))&&(r[1]&&r[1]!==location.protocol||r[2]!==location.host);if(e.dataType==="script"&&n==="GET"&&r){var z=s.getElementsByTagName("head")[0]||s.documentElement,C=s.createElement("script");C.src=e.url;if(e.scriptCharset)C.charset=e.scriptCharset;if(!j){var B= -false;C.onload=C.onreadystatechange=function(){if(!B&&(!this.readyState||this.readyState==="loaded"||this.readyState==="complete")){B=true;b();d();C.onload=C.onreadystatechange=null;z&&C.parentNode&&z.removeChild(C)}}}z.insertBefore(C,z.firstChild);return w}var E=false,x=e.xhr();if(x){e.username?x.open(n,e.url,e.async,e.username,e.password):x.open(n,e.url,e.async);try{if(e.data||a&&a.contentType)x.setRequestHeader("Content-Type",e.contentType);if(e.ifModified){c.lastModified[e.url]&&x.setRequestHeader("If-Modified-Since", -c.lastModified[e.url]);c.etag[e.url]&&x.setRequestHeader("If-None-Match",c.etag[e.url])}r||x.setRequestHeader("X-Requested-With","XMLHttpRequest");x.setRequestHeader("Accept",e.dataType&&e.accepts[e.dataType]?e.accepts[e.dataType]+", */*":e.accepts._default)}catch(ga){}if(e.beforeSend&&e.beforeSend.call(k,x,e)===false){e.global&&!--c.active&&c.event.trigger("ajaxStop");x.abort();return false}e.global&&f("ajaxSend",[x,e]);var g=x.onreadystatechange=function(q){if(!x||x.readyState===0||q==="abort"){E|| -d();E=true;if(x)x.onreadystatechange=c.noop}else if(!E&&x&&(x.readyState===4||q==="timeout")){E=true;x.onreadystatechange=c.noop;i=q==="timeout"?"timeout":!c.httpSuccess(x)?"error":e.ifModified&&c.httpNotModified(x,e.url)?"notmodified":"success";var p;if(i==="success")try{o=c.httpData(x,e.dataType,e)}catch(v){i="parsererror";p=v}if(i==="success"||i==="notmodified")j||b();else c.handleError(e,x,i,p);d();q==="timeout"&&x.abort();if(e.async)x=null}};try{var h=x.abort;x.abort=function(){x&&h.call(x); -g("abort")}}catch(l){}e.async&&e.timeout>0&&setTimeout(function(){x&&!E&&g("timeout")},e.timeout);try{x.send(n==="POST"||n==="PUT"||n==="DELETE"?e.data:null)}catch(m){c.handleError(e,x,null,m);d()}e.async||g();return x}},handleError:function(a,b,d,f){if(a.error)a.error.call(a.context||a,b,d,f);if(a.global)(a.context?c(a.context):c.event).trigger("ajaxError",[b,a,f])},active:0,httpSuccess:function(a){try{return!a.status&&location.protocol==="file:"||a.status>=200&&a.status<300||a.status===304||a.status=== -1223||a.status===0}catch(b){}return false},httpNotModified:function(a,b){var d=a.getResponseHeader("Last-Modified"),f=a.getResponseHeader("Etag");if(d)c.lastModified[b]=d;if(f)c.etag[b]=f;return a.status===304||a.status===0},httpData:function(a,b,d){var f=a.getResponseHeader("content-type")||"",e=b==="xml"||!b&&f.indexOf("xml")>=0;a=e?a.responseXML:a.responseText;e&&a.documentElement.nodeName==="parsererror"&&c.error("parsererror");if(d&&d.dataFilter)a=d.dataFilter(a,b);if(typeof a==="string")if(b=== -"json"||!b&&f.indexOf("json")>=0)a=c.parseJSON(a);else if(b==="script"||!b&&f.indexOf("javascript")>=0)c.globalEval(a);return a},param:function(a,b){function d(i,o){if(c.isArray(o))c.each(o,function(k,n){b||/\[\]$/.test(i)?f(i,n):d(i+"["+(typeof n==="object"||c.isArray(n)?k:"")+"]",n)});else!b&&o!=null&&typeof o==="object"?c.each(o,function(k,n){d(i+"["+k+"]",n)}):f(i,o)}function f(i,o){o=c.isFunction(o)?o():o;e[e.length]=encodeURIComponent(i)+"="+encodeURIComponent(o)}var e=[];if(b===w)b=c.ajaxSettings.traditional; -if(c.isArray(a)||a.jquery)c.each(a,function(){f(this.name,this.value)});else for(var j in a)d(j,a[j]);return e.join("&").replace(yb,"+")}});var la={},Ab=/toggle|show|hide/,Bb=/^([+-]=)?([\d+-.]+)(.*)$/,W,va=[["height","marginTop","marginBottom","paddingTop","paddingBottom"],["width","marginLeft","marginRight","paddingLeft","paddingRight"],["opacity"]];c.fn.extend({show:function(a,b){if(a||a===0)return this.animate(K("show",3),a,b);else{a=0;for(b=this.length;a").appendTo("body");f=e.css("display");if(f==="none")f="block";e.remove();la[d]=f}c.data(this[a],"olddisplay",f)}}a=0;for(b=this.length;a=0;f--)if(d[f].elem===this){b&&d[f](true);d.splice(f,1)}});b||this.dequeue();return this}});c.each({slideDown:K("show",1),slideUp:K("hide",1),slideToggle:K("toggle",1),fadeIn:{opacity:"show"},fadeOut:{opacity:"hide"}},function(a,b){c.fn[a]=function(d,f){return this.animate(b,d,f)}});c.extend({speed:function(a,b,d){var f=a&&typeof a==="object"?a:{complete:d||!d&&b||c.isFunction(a)&&a,duration:a,easing:d&&b||b&&!c.isFunction(b)&&b};f.duration=c.fx.off?0:typeof f.duration=== -"number"?f.duration:c.fx.speeds[f.duration]||c.fx.speeds._default;f.old=f.complete;f.complete=function(){f.queue!==false&&c(this).dequeue();c.isFunction(f.old)&&f.old.call(this)};return f},easing:{linear:function(a,b,d,f){return d+f*a},swing:function(a,b,d,f){return(-Math.cos(a*Math.PI)/2+0.5)*f+d}},timers:[],fx:function(a,b,d){this.options=b;this.elem=a;this.prop=d;if(!b.orig)b.orig={}}});c.fx.prototype={update:function(){this.options.step&&this.options.step.call(this.elem,this.now,this);(c.fx.step[this.prop]|| -c.fx.step._default)(this);if((this.prop==="height"||this.prop==="width")&&this.elem.style)this.elem.style.display="block"},cur:function(a){if(this.elem[this.prop]!=null&&(!this.elem.style||this.elem.style[this.prop]==null))return this.elem[this.prop];return(a=parseFloat(c.css(this.elem,this.prop,a)))&&a>-10000?a:parseFloat(c.curCSS(this.elem,this.prop))||0},custom:function(a,b,d){function f(j){return e.step(j)}this.startTime=J();this.start=a;this.end=b;this.unit=d||this.unit||"px";this.now=this.start; -this.pos=this.state=0;var e=this;f.elem=this.elem;if(f()&&c.timers.push(f)&&!W)W=setInterval(c.fx.tick,13)},show:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.show=true;this.custom(this.prop==="width"||this.prop==="height"?1:0,this.cur());c(this.elem).show()},hide:function(){this.options.orig[this.prop]=c.style(this.elem,this.prop);this.options.hide=true;this.custom(this.cur(),0)},step:function(a){var b=J(),d=true;if(a||b>=this.options.duration+this.startTime){this.now= -this.end;this.pos=this.state=1;this.update();this.options.curAnim[this.prop]=true;for(var f in this.options.curAnim)if(this.options.curAnim[f]!==true)d=false;if(d){if(this.options.display!=null){this.elem.style.overflow=this.options.overflow;a=c.data(this.elem,"olddisplay");this.elem.style.display=a?a:this.options.display;if(c.css(this.elem,"display")==="none")this.elem.style.display="block"}this.options.hide&&c(this.elem).hide();if(this.options.hide||this.options.show)for(var e in this.options.curAnim)c.style(this.elem, -e,this.options.orig[e]);this.options.complete.call(this.elem)}return false}else{e=b-this.startTime;this.state=e/this.options.duration;a=this.options.easing||(c.easing.swing?"swing":"linear");this.pos=c.easing[this.options.specialEasing&&this.options.specialEasing[this.prop]||a](this.state,e,0,1,this.options.duration);this.now=this.start+(this.end-this.start)*this.pos;this.update()}return true}};c.extend(c.fx,{tick:function(){for(var a=c.timers,b=0;b
            "; -a.insertBefore(b,a.firstChild);d=b.firstChild;f=d.firstChild;e=d.nextSibling.firstChild.firstChild;this.doesNotAddBorder=f.offsetTop!==5;this.doesAddBorderForTableAndCells=e.offsetTop===5;f.style.position="fixed";f.style.top="20px";this.supportsFixedPosition=f.offsetTop===20||f.offsetTop===15;f.style.position=f.style.top="";d.style.overflow="hidden";d.style.position="relative";this.subtractsBorderForOverflowNotVisible=f.offsetTop===-5;this.doesNotIncludeMarginInBodyOffset=a.offsetTop!==j;a.removeChild(b); -c.offset.initialize=c.noop},bodyOffset:function(a){var b=a.offsetTop,d=a.offsetLeft;c.offset.initialize();if(c.offset.doesNotIncludeMarginInBodyOffset){b+=parseFloat(c.curCSS(a,"marginTop",true))||0;d+=parseFloat(c.curCSS(a,"marginLeft",true))||0}return{top:b,left:d}},setOffset:function(a,b,d){if(/static/.test(c.curCSS(a,"position")))a.style.position="relative";var f=c(a),e=f.offset(),j=parseInt(c.curCSS(a,"top",true),10)||0,i=parseInt(c.curCSS(a,"left",true),10)||0;if(c.isFunction(b))b=b.call(a, -d,e);d={top:b.top-e.top+j,left:b.left-e.left+i};"using"in b?b.using.call(a,d):f.css(d)}};c.fn.extend({position:function(){if(!this[0])return null;var a=this[0],b=this.offsetParent(),d=this.offset(),f=/^body|html$/i.test(b[0].nodeName)?{top:0,left:0}:b.offset();d.top-=parseFloat(c.curCSS(a,"marginTop",true))||0;d.left-=parseFloat(c.curCSS(a,"marginLeft",true))||0;f.top+=parseFloat(c.curCSS(b[0],"borderTopWidth",true))||0;f.left+=parseFloat(c.curCSS(b[0],"borderLeftWidth",true))||0;return{top:d.top- -f.top,left:d.left-f.left}},offsetParent:function(){return this.map(function(){for(var a=this.offsetParent||s.body;a&&!/^body|html$/i.test(a.nodeName)&&c.css(a,"position")==="static";)a=a.offsetParent;return a})}});c.each(["Left","Top"],function(a,b){var d="scroll"+b;c.fn[d]=function(f){var e=this[0],j;if(!e)return null;if(f!==w)return this.each(function(){if(j=wa(this))j.scrollTo(!a?f:c(j).scrollLeft(),a?f:c(j).scrollTop());else this[d]=f});else return(j=wa(e))?"pageXOffset"in j?j[a?"pageYOffset": -"pageXOffset"]:c.support.boxModel&&j.document.documentElement[d]||j.document.body[d]:e[d]}});c.each(["Height","Width"],function(a,b){var d=b.toLowerCase();c.fn["inner"+b]=function(){return this[0]?c.css(this[0],d,false,"padding"):null};c.fn["outer"+b]=function(f){return this[0]?c.css(this[0],d,false,f?"margin":"border"):null};c.fn[d]=function(f){var e=this[0];if(!e)return f==null?null:this;if(c.isFunction(f))return this.each(function(j){var i=c(this);i[d](f.call(this,j,i[d]()))});return"scrollTo"in -e&&e.document?e.document.compatMode==="CSS1Compat"&&e.document.documentElement["client"+b]||e.document.body["client"+b]:e.nodeType===9?Math.max(e.documentElement["client"+b],e.body["scroll"+b],e.documentElement["scroll"+b],e.body["offset"+b],e.documentElement["offset"+b]):f===w?c.css(e,d):this.css(d,typeof f==="string"?f:f+"px")}});A.jQuery=A.$=c})(window); diff --git a/cmf/html/_static/minus.png b/cmf/html/_static/minus.png deleted file mode 100644 index da1c562..0000000 Binary files a/cmf/html/_static/minus.png and /dev/null differ diff --git a/cmf/html/_static/plus.png b/cmf/html/_static/plus.png deleted file mode 100644 index b3cb374..0000000 Binary files a/cmf/html/_static/plus.png and /dev/null differ diff --git a/cmf/html/_static/pygments.css b/cmf/html/_static/pygments.css deleted file mode 100644 index 1a14f2a..0000000 --- a/cmf/html/_static/pygments.css +++ /dev/null @@ -1,62 +0,0 @@ -.highlight .hll { background-color: #ffffcc } -.highlight { background: #eeffcc; } -.highlight .c { color: #408090; font-style: italic } /* Comment */ -.highlight .err { border: 1px solid #FF0000 } /* Error */ -.highlight .k { color: #007020; font-weight: bold } /* Keyword */ -.highlight .o { color: #666666 } /* Operator */ -.highlight .cm { color: #408090; font-style: italic } /* Comment.Multiline */ -.highlight .cp { color: #007020 } /* Comment.Preproc */ -.highlight .c1 { color: #408090; font-style: italic } /* Comment.Single */ -.highlight .cs { color: #408090; background-color: #fff0f0 } /* Comment.Special */ -.highlight .gd { color: #A00000 } /* Generic.Deleted */ -.highlight .ge { font-style: italic } /* Generic.Emph */ -.highlight .gr { color: #FF0000 } /* Generic.Error */ -.highlight .gh { color: #000080; font-weight: bold } /* Generic.Heading */ -.highlight .gi { color: #00A000 } /* Generic.Inserted */ -.highlight .go { color: #303030 } /* Generic.Output */ -.highlight .gp { color: #c65d09; font-weight: bold } /* Generic.Prompt */ -.highlight .gs { font-weight: bold } /* Generic.Strong */ -.highlight .gu { color: #800080; font-weight: bold } /* Generic.Subheading */ -.highlight .gt { color: #0040D0 } /* Generic.Traceback */ -.highlight .kc { color: #007020; font-weight: bold } /* Keyword.Constant */ -.highlight .kd { color: #007020; font-weight: bold } /* Keyword.Declaration */ -.highlight .kn { color: #007020; font-weight: bold } /* Keyword.Namespace */ -.highlight .kp { color: #007020 } /* Keyword.Pseudo */ -.highlight .kr { color: #007020; font-weight: bold } /* Keyword.Reserved */ -.highlight .kt { color: #902000 } /* Keyword.Type */ -.highlight .m { color: #208050 } /* Literal.Number */ -.highlight .s { color: #4070a0 } /* Literal.String */ -.highlight .na { color: #4070a0 } /* Name.Attribute */ -.highlight .nb { color: #007020 } /* Name.Builtin */ -.highlight .nc { color: #0e84b5; font-weight: bold } /* Name.Class */ -.highlight .no { color: #60add5 } /* Name.Constant */ -.highlight .nd { color: #555555; font-weight: bold } /* Name.Decorator */ -.highlight .ni { color: #d55537; font-weight: bold } /* Name.Entity */ -.highlight .ne { color: #007020 } /* Name.Exception */ -.highlight .nf { color: #06287e } /* Name.Function */ -.highlight .nl { color: #002070; font-weight: bold } /* Name.Label */ -.highlight .nn { color: #0e84b5; font-weight: bold } /* Name.Namespace */ -.highlight .nt { color: #062873; font-weight: bold } /* Name.Tag */ -.highlight .nv { color: #bb60d5 } /* Name.Variable */ -.highlight .ow { color: #007020; font-weight: bold } /* Operator.Word */ -.highlight .w { color: #bbbbbb } /* Text.Whitespace */ -.highlight .mf { color: #208050 } /* Literal.Number.Float */ -.highlight .mh { color: #208050 } /* Literal.Number.Hex */ -.highlight .mi { color: #208050 } /* Literal.Number.Integer */ -.highlight .mo { color: #208050 } /* Literal.Number.Oct */ -.highlight .sb { color: #4070a0 } /* Literal.String.Backtick */ -.highlight .sc { color: #4070a0 } /* Literal.String.Char */ -.highlight .sd { color: #4070a0; font-style: italic } /* Literal.String.Doc */ -.highlight .s2 { color: #4070a0 } /* Literal.String.Double */ -.highlight .se { color: #4070a0; font-weight: bold } /* Literal.String.Escape */ -.highlight .sh { color: #4070a0 } /* Literal.String.Heredoc */ -.highlight .si { color: #70a0d0; font-style: italic } /* Literal.String.Interpol */ -.highlight .sx { color: #c65d09 } /* Literal.String.Other */ -.highlight .sr { color: #235388 } /* Literal.String.Regex */ -.highlight .s1 { color: #4070a0 } /* Literal.String.Single */ -.highlight .ss { color: #517918 } /* Literal.String.Symbol */ -.highlight .bp { color: #007020 } /* Name.Builtin.Pseudo */ -.highlight .vc { color: #bb60d5 } /* Name.Variable.Class */ -.highlight .vg { color: #bb60d5 } /* Name.Variable.Global */ -.highlight .vi { color: #bb60d5 } /* Name.Variable.Instance */ -.highlight .il { color: #208050 } /* Literal.Number.Integer.Long */ \ No newline at end of file diff --git a/cmf/html/_static/searchtools.js b/cmf/html/_static/searchtools.js deleted file mode 100644 index 663be4c..0000000 --- a/cmf/html/_static/searchtools.js +++ /dev/null @@ -1,560 +0,0 @@ -/* - * searchtools.js_t - * ~~~~~~~~~~~~~~~~ - * - * Sphinx JavaScript utilties for the full-text search. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * helper function to return a node containing the - * search summary for a given text. keywords is a list - * of stemmed words, hlwords is the list of normal, unstemmed - * words. the first one is used to find the occurance, the - * latter for highlighting it. - */ - -jQuery.makeSearchSummary = function(text, keywords, hlwords) { - var textLower = text.toLowerCase(); - var start = 0; - $.each(keywords, function() { - var i = textLower.indexOf(this.toLowerCase()); - if (i > -1) - start = i; - }); - start = Math.max(start - 120, 0); - var excerpt = ((start > 0) ? '...' : '') + - $.trim(text.substr(start, 240)) + - ((start + 240 - text.length) ? '...' : ''); - var rv = $('
            ').text(excerpt); - $.each(hlwords, function() { - rv = rv.highlightText(this, 'highlighted'); - }); - return rv; -} - - -/** - * Porter Stemmer - */ -var Stemmer = function() { - - var step2list = { - ational: 'ate', - tional: 'tion', - enci: 'ence', - anci: 'ance', - izer: 'ize', - bli: 'ble', - alli: 'al', - entli: 'ent', - eli: 'e', - ousli: 'ous', - ization: 'ize', - ation: 'ate', - ator: 'ate', - alism: 'al', - iveness: 'ive', - fulness: 'ful', - ousness: 'ous', - aliti: 'al', - iviti: 'ive', - biliti: 'ble', - logi: 'log' - }; - - var step3list = { - icate: 'ic', - ative: '', - alize: 'al', - iciti: 'ic', - ical: 'ic', - ful: '', - ness: '' - }; - - var c = "[^aeiou]"; // consonant - var v = "[aeiouy]"; // vowel - var C = c + "[^aeiouy]*"; // consonant sequence - var V = v + "[aeiou]*"; // vowel sequence - - var mgr0 = "^(" + C + ")?" + V + C; // [C]VC... is m>0 - var meq1 = "^(" + C + ")?" + V + C + "(" + V + ")?$"; // [C]VC[V] is m=1 - var mgr1 = "^(" + C + ")?" + V + C + V + C; // [C]VCVC... is m>1 - var s_v = "^(" + C + ")?" + v; // vowel in stem - - this.stemWord = function (w) { - var stem; - var suffix; - var firstch; - var origword = w; - - if (w.length < 3) - return w; - - var re; - var re2; - var re3; - var re4; - - firstch = w.substr(0,1); - if (firstch == "y") - w = firstch.toUpperCase() + w.substr(1); - - // Step 1a - re = /^(.+?)(ss|i)es$/; - re2 = /^(.+?)([^s])s$/; - - if (re.test(w)) - w = w.replace(re,"$1$2"); - else if (re2.test(w)) - w = w.replace(re2,"$1$2"); - - // Step 1b - re = /^(.+?)eed$/; - re2 = /^(.+?)(ed|ing)$/; - if (re.test(w)) { - var fp = re.exec(w); - re = new RegExp(mgr0); - if (re.test(fp[1])) { - re = /.$/; - w = w.replace(re,""); - } - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1]; - re2 = new RegExp(s_v); - if (re2.test(stem)) { - w = stem; - re2 = /(at|bl|iz)$/; - re3 = new RegExp("([^aeiouylsz])\\1$"); - re4 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re2.test(w)) - w = w + "e"; - else if (re3.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - else if (re4.test(w)) - w = w + "e"; - } - } - - // Step 1c - re = /^(.+?)y$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(s_v); - if (re.test(stem)) - w = stem + "i"; - } - - // Step 2 - re = /^(.+?)(ational|tional|enci|anci|izer|bli|alli|entli|eli|ousli|ization|ation|ator|alism|iveness|fulness|ousness|aliti|iviti|biliti|logi)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step2list[suffix]; - } - - // Step 3 - re = /^(.+?)(icate|ative|alize|iciti|ical|ful|ness)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - suffix = fp[2]; - re = new RegExp(mgr0); - if (re.test(stem)) - w = stem + step3list[suffix]; - } - - // Step 4 - re = /^(.+?)(al|ance|ence|er|ic|able|ible|ant|ement|ment|ent|ou|ism|ate|iti|ous|ive|ize)$/; - re2 = /^(.+?)(s|t)(ion)$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - if (re.test(stem)) - w = stem; - } - else if (re2.test(w)) { - var fp = re2.exec(w); - stem = fp[1] + fp[2]; - re2 = new RegExp(mgr1); - if (re2.test(stem)) - w = stem; - } - - // Step 5 - re = /^(.+?)e$/; - if (re.test(w)) { - var fp = re.exec(w); - stem = fp[1]; - re = new RegExp(mgr1); - re2 = new RegExp(meq1); - re3 = new RegExp("^" + C + v + "[^aeiouwxy]$"); - if (re.test(stem) || (re2.test(stem) && !(re3.test(stem)))) - w = stem; - } - re = /ll$/; - re2 = new RegExp(mgr1); - if (re.test(w) && re2.test(w)) { - re = /.$/; - w = w.replace(re,""); - } - - // and turn initial Y back to y - if (firstch == "y") - w = firstch.toLowerCase() + w.substr(1); - return w; - } -} - - -/** - * Search Module - */ -var Search = { - - _index : null, - _queued_query : null, - _pulse_status : -1, - - init : function() { - var params = $.getQueryParameters(); - if (params.q) { - var query = params.q[0]; - $('input[name="q"]')[0].value = query; - this.performSearch(query); - } - }, - - loadIndex : function(url) { - $.ajax({type: "GET", url: url, data: null, success: null, - dataType: "script", cache: true}); - }, - - setIndex : function(index) { - var q; - this._index = index; - if ((q = this._queued_query) !== null) { - this._queued_query = null; - Search.query(q); - } - }, - - hasIndex : function() { - return this._index !== null; - }, - - deferQuery : function(query) { - this._queued_query = query; - }, - - stopPulse : function() { - this._pulse_status = 0; - }, - - startPulse : function() { - if (this._pulse_status >= 0) - return; - function pulse() { - Search._pulse_status = (Search._pulse_status + 1) % 4; - var dotString = ''; - for (var i = 0; i < Search._pulse_status; i++) - dotString += '.'; - Search.dots.text(dotString); - if (Search._pulse_status > -1) - window.setTimeout(pulse, 500); - }; - pulse(); - }, - - /** - * perform a search for something - */ - performSearch : function(query) { - // create the required interface elements - this.out = $('#search-results'); - this.title = $('

            ' + _('Searching') + '

            ').appendTo(this.out); - this.dots = $('').appendTo(this.title); - this.status = $('

            ').appendTo(this.out); - this.output = $('
              ').appendTo(this.out); - - $('#search-progress').text(_('Preparing search...')); - this.startPulse(); - - // index already loaded, the browser was quick! - if (this.hasIndex()) - this.query(query); - else - this.deferQuery(query); - }, - - query : function(query) { - var stopwords = ["and","then","into","it","as","are","in","if","for","no","there","their","was","is","be","to","that","but","they","not","such","with","by","a","on","these","of","will","this","near","the","or","at"]; - - // Stem the searchterms and add them to the correct list - var stemmer = new Stemmer(); - var searchterms = []; - var excluded = []; - var hlterms = []; - var tmp = query.split(/\s+/); - var objectterms = []; - for (var i = 0; i < tmp.length; i++) { - if (tmp[i] != "") { - objectterms.push(tmp[i].toLowerCase()); - } - - if ($u.indexOf(stopwords, tmp[i]) != -1 || tmp[i].match(/^\d+$/) || - tmp[i] == "") { - // skip this "word" - continue; - } - // stem the word - var word = stemmer.stemWord(tmp[i]).toLowerCase(); - // select the correct list - if (word[0] == '-') { - var toAppend = excluded; - word = word.substr(1); - } - else { - var toAppend = searchterms; - hlterms.push(tmp[i].toLowerCase()); - } - // only add if not already in the list - if (!$.contains(toAppend, word)) - toAppend.push(word); - }; - var highlightstring = '?highlight=' + $.urlencode(hlterms.join(" ")); - - // console.debug('SEARCH: searching for:'); - // console.info('required: ', searchterms); - // console.info('excluded: ', excluded); - - // prepare search - var filenames = this._index.filenames; - var titles = this._index.titles; - var terms = this._index.terms; - var fileMap = {}; - var files = null; - // different result priorities - var importantResults = []; - var objectResults = []; - var regularResults = []; - var unimportantResults = []; - $('#search-progress').empty(); - - // lookup as object - for (var i = 0; i < objectterms.length; i++) { - var others = [].concat(objectterms.slice(0,i), - objectterms.slice(i+1, objectterms.length)) - var results = this.performObjectSearch(objectterms[i], others); - // Assume first word is most likely to be the object, - // other words more likely to be in description. - // Therefore put matches for earlier words first. - // (Results are eventually used in reverse order). - objectResults = results[0].concat(objectResults); - importantResults = results[1].concat(importantResults); - unimportantResults = results[2].concat(unimportantResults); - } - - // perform the search on the required terms - for (var i = 0; i < searchterms.length; i++) { - var word = searchterms[i]; - // no match but word was a required one - if ((files = terms[word]) == null) - break; - if (files.length == undefined) { - files = [files]; - } - // create the mapping - for (var j = 0; j < files.length; j++) { - var file = files[j]; - if (file in fileMap) - fileMap[file].push(word); - else - fileMap[file] = [word]; - } - } - - // now check if the files don't contain excluded terms - for (var file in fileMap) { - var valid = true; - - // check if all requirements are matched - if (fileMap[file].length != searchterms.length) - continue; - - // ensure that none of the excluded terms is in the - // search result. - for (var i = 0; i < excluded.length; i++) { - if (terms[excluded[i]] == file || - $.contains(terms[excluded[i]] || [], file)) { - valid = false; - break; - } - } - - // if we have still a valid result we can add it - // to the result list - if (valid) - regularResults.push([filenames[file], titles[file], '', null]); - } - - // delete unused variables in order to not waste - // memory until list is retrieved completely - delete filenames, titles, terms; - - // now sort the regular results descending by title - regularResults.sort(function(a, b) { - var left = a[1].toLowerCase(); - var right = b[1].toLowerCase(); - return (left > right) ? -1 : ((left < right) ? 1 : 0); - }); - - // combine all results - var results = unimportantResults.concat(regularResults) - .concat(objectResults).concat(importantResults); - - // print the results - var resultCount = results.length; - function displayNextItem() { - // results left, load the summary and display it - if (results.length) { - var item = results.pop(); - var listItem = $('
            • '); - if (DOCUMENTATION_OPTIONS.FILE_SUFFIX == '') { - // dirhtml builder - var dirname = item[0] + '/'; - if (dirname.match(/\/index\/$/)) { - dirname = dirname.substring(0, dirname.length-6); - } else if (dirname == 'index/') { - dirname = ''; - } - listItem.append($('').attr('href', - DOCUMENTATION_OPTIONS.URL_ROOT + dirname + - highlightstring + item[2]).html(item[1])); - } else { - // normal html builders - listItem.append($('').attr('href', - item[0] + DOCUMENTATION_OPTIONS.FILE_SUFFIX + - highlightstring + item[2]).html(item[1])); - } - if (item[3]) { - listItem.append($(' (' + item[3] + ')')); - Search.output.append(listItem); - listItem.slideDown(5, function() { - displayNextItem(); - }); - } else if (DOCUMENTATION_OPTIONS.HAS_SOURCE) { - $.get(DOCUMENTATION_OPTIONS.URL_ROOT + '_sources/' + - item[0] + '.txt', function(data) { - if (data != '') { - listItem.append($.makeSearchSummary(data, searchterms, hlterms)); - Search.output.append(listItem); - } - listItem.slideDown(5, function() { - displayNextItem(); - }); - }, "text"); - } else { - // no source available, just display title - Search.output.append(listItem); - listItem.slideDown(5, function() { - displayNextItem(); - }); - } - } - // search finished, update title and status message - else { - Search.stopPulse(); - Search.title.text(_('Search Results')); - if (!resultCount) - Search.status.text(_('Your search did not match any documents. Please make sure that all words are spelled correctly and that you\'ve selected enough categories.')); - else - Search.status.text(_('Search finished, found %s page(s) matching the search query.').replace('%s', resultCount)); - Search.status.fadeIn(500); - } - } - displayNextItem(); - }, - - performObjectSearch : function(object, otherterms) { - var filenames = this._index.filenames; - var objects = this._index.objects; - var objnames = this._index.objnames; - var titles = this._index.titles; - - var importantResults = []; - var objectResults = []; - var unimportantResults = []; - - for (var prefix in objects) { - for (var name in objects[prefix]) { - var fullname = (prefix ? prefix + '.' : '') + name; - if (fullname.toLowerCase().indexOf(object) > -1) { - var match = objects[prefix][name]; - var objname = objnames[match[1]][2]; - var title = titles[match[0]]; - // If more than one term searched for, we require other words to be - // found in the name/title/description - if (otherterms.length > 0) { - var haystack = (prefix + ' ' + name + ' ' + - objname + ' ' + title).toLowerCase(); - var allfound = true; - for (var i = 0; i < otherterms.length; i++) { - if (haystack.indexOf(otherterms[i]) == -1) { - allfound = false; - break; - } - } - if (!allfound) { - continue; - } - } - var descr = objname + _(', in ') + title; - anchor = match[3]; - if (anchor == '') - anchor = fullname; - else if (anchor == '-') - anchor = objnames[match[1]][1] + '-' + fullname; - result = [filenames[match[0]], fullname, '#'+anchor, descr]; - switch (match[2]) { - case 1: objectResults.push(result); break; - case 0: importantResults.push(result); break; - case 2: unimportantResults.push(result); break; - } - } - } - } - - // sort results descending - objectResults.sort(function(a, b) { - return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); - }); - - importantResults.sort(function(a, b) { - return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); - }); - - unimportantResults.sort(function(a, b) { - return (a[1] > b[1]) ? -1 : ((a[1] < b[1]) ? 1 : 0); - }); - - return [importantResults, objectResults, unimportantResults] - } -} - -$(document).ready(function() { - Search.init(); -}); \ No newline at end of file diff --git a/cmf/html/_static/sidebar.js b/cmf/html/_static/sidebar.js deleted file mode 100644 index a45e192..0000000 --- a/cmf/html/_static/sidebar.js +++ /dev/null @@ -1,151 +0,0 @@ -/* - * sidebar.js - * ~~~~~~~~~~ - * - * This script makes the Sphinx sidebar collapsible. - * - * .sphinxsidebar contains .sphinxsidebarwrapper. This script adds - * in .sphixsidebar, after .sphinxsidebarwrapper, the #sidebarbutton - * used to collapse and expand the sidebar. - * - * When the sidebar is collapsed the .sphinxsidebarwrapper is hidden - * and the width of the sidebar and the margin-left of the document - * are decreased. When the sidebar is expanded the opposite happens. - * This script saves a per-browser/per-session cookie used to - * remember the position of the sidebar among the pages. - * Once the browser is closed the cookie is deleted and the position - * reset to the default (expanded). - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -$(function() { - // global elements used by the functions. - // the 'sidebarbutton' element is defined as global after its - // creation, in the add_sidebar_button function - var bodywrapper = $('.bodywrapper'); - var sidebar = $('.sphinxsidebar'); - var sidebarwrapper = $('.sphinxsidebarwrapper'); - - // for some reason, the document has no sidebar; do not run into errors - if (!sidebar.length) return; - - // original margin-left of the bodywrapper and width of the sidebar - // with the sidebar expanded - var bw_margin_expanded = bodywrapper.css('margin-left'); - var ssb_width_expanded = sidebar.width(); - - // margin-left of the bodywrapper and width of the sidebar - // with the sidebar collapsed - var bw_margin_collapsed = '.8em'; - var ssb_width_collapsed = '.8em'; - - // colors used by the current theme - var dark_color = $('.related').css('background-color'); - var light_color = $('.document').css('background-color'); - - function sidebar_is_collapsed() { - return sidebarwrapper.is(':not(:visible)'); - } - - function toggle_sidebar() { - if (sidebar_is_collapsed()) - expand_sidebar(); - else - collapse_sidebar(); - } - - function collapse_sidebar() { - sidebarwrapper.hide(); - sidebar.css('width', ssb_width_collapsed); - bodywrapper.css('margin-left', bw_margin_collapsed); - sidebarbutton.css({ - 'margin-left': '0', - 'height': bodywrapper.height() - }); - sidebarbutton.find('span').text('»'); - sidebarbutton.attr('title', _('Expand sidebar')); - document.cookie = 'sidebar=collapsed'; - } - - function expand_sidebar() { - bodywrapper.css('margin-left', bw_margin_expanded); - sidebar.css('width', ssb_width_expanded); - sidebarwrapper.show(); - sidebarbutton.css({ - 'margin-left': ssb_width_expanded-12, - 'height': bodywrapper.height() - }); - sidebarbutton.find('span').text('«'); - sidebarbutton.attr('title', _('Collapse sidebar')); - document.cookie = 'sidebar=expanded'; - } - - function add_sidebar_button() { - sidebarwrapper.css({ - 'float': 'left', - 'margin-right': '0', - 'width': ssb_width_expanded - 28 - }); - // create the button - sidebar.append( - '
              «
              ' - ); - var sidebarbutton = $('#sidebarbutton'); - light_color = sidebarbutton.css('background-color'); - // find the height of the viewport to center the '<<' in the page - var viewport_height; - if (window.innerHeight) - viewport_height = window.innerHeight; - else - viewport_height = $(window).height(); - sidebarbutton.find('span').css({ - 'display': 'block', - 'margin-top': (viewport_height - sidebar.position().top - 20) / 2 - }); - - sidebarbutton.click(toggle_sidebar); - sidebarbutton.attr('title', _('Collapse sidebar')); - sidebarbutton.css({ - 'color': '#FFFFFF', - 'border-left': '1px solid ' + dark_color, - 'font-size': '1.2em', - 'cursor': 'pointer', - 'height': bodywrapper.height(), - 'padding-top': '1px', - 'margin-left': ssb_width_expanded - 12 - }); - - sidebarbutton.hover( - function () { - $(this).css('background-color', dark_color); - }, - function () { - $(this).css('background-color', light_color); - } - ); - } - - function set_position_from_cookie() { - if (!document.cookie) - return; - var items = document.cookie.split(';'); - for(var k=0; k=e.computed&&(e={value:f,computed:g})});return e.value};b.min=function(a,c,d){if(!c&&b.isArray(a))return Math.min.apply(Math,a);var e={computed:Infinity};b.each(a,function(f,g,h){g=c?c.call(d,f,g,h):f;gf?1:0}),"value")};b.sortedIndex=function(a,c,d){d=d||b.identity;for(var e=0,f=a.length;e>1;d(a[g])=0})})};b.zip=function(){for(var a=b.toArray(arguments),c=b.max(b.pluck(a,"length")),d=new Array(c),e=0;e0?f-c:c-f)>=0)return e;e[g++]=f}};b.bind=function(a,c){var d=b.rest(arguments,2);return function(){return a.apply(c||j,d.concat(b.toArray(arguments)))}};b.bindAll=function(a){var c=b.rest(arguments);if(c.length==0)c=b.functions(a);b.each(c,function(d){a[d]=b.bind(a[d],a)}); -return a};b.delay=function(a,c){var d=b.rest(arguments,2);return setTimeout(function(){return a.apply(a,d)},c)};b.defer=function(a){return b.delay.apply(b,[a,1].concat(b.rest(arguments)))};b.wrap=function(a,c){return function(){var d=[a].concat(b.toArray(arguments));return c.apply(c,d)}};b.compose=function(){var a=b.toArray(arguments);return function(){for(var c=b.toArray(arguments),d=a.length-1;d>=0;d--)c=[a[d].apply(this,c)];return c[0]}};b.keys=function(a){if(b.isArray(a))return b.range(0,a.length); -var c=[];for(var d in a)q.call(a,d)&&c.push(d);return c};b.values=function(a){return b.map(a,b.identity)};b.functions=function(a){return b.select(b.keys(a),function(c){return b.isFunction(a[c])}).sort()};b.extend=function(a,c){for(var d in c)a[d]=c[d];return a};b.clone=function(a){if(b.isArray(a))return a.slice(0);return b.extend({},a)};b.tap=function(a,c){c(a);return a};b.isEqual=function(a,c){if(a===c)return true;var d=typeof a;if(d!=typeof c)return false;if(a==c)return true;if(!a&&c||a&&!c)return false; -if(a.isEqual)return a.isEqual(c);if(b.isDate(a)&&b.isDate(c))return a.getTime()===c.getTime();if(b.isNaN(a)&&b.isNaN(c))return true;if(b.isRegExp(a)&&b.isRegExp(c))return a.source===c.source&&a.global===c.global&&a.ignoreCase===c.ignoreCase&&a.multiline===c.multiline;if(d!=="object")return false;if(a.length&&a.length!==c.length)return false;d=b.keys(a);var e=b.keys(c);if(d.length!=e.length)return false;for(var f in a)if(!b.isEqual(a[f],c[f]))return false;return true};b.isEmpty=function(a){return b.keys(a).length== -0};b.isElement=function(a){return!!(a&&a.nodeType==1)};b.isArray=function(a){return!!(a&&a.concat&&a.unshift)};b.isArguments=function(a){return a&&b.isNumber(a.length)&&!b.isArray(a)&&!r.call(a,"length")};b.isFunction=function(a){return!!(a&&a.constructor&&a.call&&a.apply)};b.isString=function(a){return!!(a===""||a&&a.charCodeAt&&a.substr)};b.isNumber=function(a){return p.call(a)==="[object Number]"};b.isDate=function(a){return!!(a&&a.getTimezoneOffset&&a.setUTCFullYear)};b.isRegExp=function(a){return!!(a&& -a.test&&a.exec&&(a.ignoreCase||a.ignoreCase===false))};b.isNaN=function(a){return b.isNumber(a)&&isNaN(a)};b.isNull=function(a){return a===null};b.isUndefined=function(a){return typeof a=="undefined"};b.noConflict=function(){j._=n;return this};b.identity=function(a){return a};b.breakLoop=function(){throw m;};var s=0;b.uniqueId=function(a){var c=s++;return a?a+c:c};b.template=function(a,c){a=new Function("obj","var p=[],print=function(){p.push.apply(p,arguments);};with(obj){p.push('"+a.replace(/[\r\t\n]/g, -" ").replace(/'(?=[^%]*%>)/g,"\t").split("'").join("\\'").split("\t").join("'").replace(/<%=(.+?)%>/g,"',$1,'").split("<%").join("');").split("%>").join("p.push('")+"');}return p.join('');");return c?a(c):a};b.forEach=b.each;b.foldl=b.inject=b.reduce;b.foldr=b.reduceRight;b.filter=b.select;b.every=b.all;b.some=b.any;b.head=b.first;b.tail=b.rest;b.methods=b.functions;var l=function(a,c){return c?b(a).chain():a};b.each(b.functions(b),function(a){var c=b[a];i.prototype[a]=function(){var d=b.toArray(arguments); -o.call(d,this._wrapped);return l(c.apply(b,d),this._chain)}});b.each(["pop","push","reverse","shift","sort","splice","unshift"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){c.apply(this._wrapped,arguments);return l(this._wrapped,this._chain)}});b.each(["concat","join","slice"],function(a){var c=Array.prototype[a];i.prototype[a]=function(){return l(c.apply(this._wrapped,arguments),this._chain)}});i.prototype.chain=function(){this._chain=true;return this};i.prototype.value=function(){return this._wrapped}})(); diff --git a/cmf/html/_static/up-pressed.png b/cmf/html/_static/up-pressed.png deleted file mode 100644 index 8bd587a..0000000 Binary files a/cmf/html/_static/up-pressed.png and /dev/null differ diff --git a/cmf/html/_static/up.png b/cmf/html/_static/up.png deleted file mode 100644 index b946256..0000000 Binary files a/cmf/html/_static/up.png and /dev/null differ diff --git a/cmf/html/_static/websupport.js b/cmf/html/_static/websupport.js deleted file mode 100644 index e9bd1b8..0000000 --- a/cmf/html/_static/websupport.js +++ /dev/null @@ -1,808 +0,0 @@ -/* - * websupport.js - * ~~~~~~~~~~~~~ - * - * sphinx.websupport utilties for all documentation. - * - * :copyright: Copyright 2007-2011 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -(function($) { - $.fn.autogrow = function() { - return this.each(function() { - var textarea = this; - - $.fn.autogrow.resize(textarea); - - $(textarea) - .focus(function() { - textarea.interval = setInterval(function() { - $.fn.autogrow.resize(textarea); - }, 500); - }) - .blur(function() { - clearInterval(textarea.interval); - }); - }); - }; - - $.fn.autogrow.resize = function(textarea) { - var lineHeight = parseInt($(textarea).css('line-height'), 10); - var lines = textarea.value.split('\n'); - var columns = textarea.cols; - var lineCount = 0; - $.each(lines, function() { - lineCount += Math.ceil(this.length / columns) || 1; - }); - var height = lineHeight * (lineCount + 1); - $(textarea).css('height', height); - }; -})(jQuery); - -(function($) { - var comp, by; - - function init() { - initEvents(); - initComparator(); - } - - function initEvents() { - $('a.comment-close').live("click", function(event) { - event.preventDefault(); - hide($(this).attr('id').substring(2)); - }); - $('a.vote').live("click", function(event) { - event.preventDefault(); - handleVote($(this)); - }); - $('a.reply').live("click", function(event) { - event.preventDefault(); - openReply($(this).attr('id').substring(2)); - }); - $('a.close-reply').live("click", function(event) { - event.preventDefault(); - closeReply($(this).attr('id').substring(2)); - }); - $('a.sort-option').live("click", function(event) { - event.preventDefault(); - handleReSort($(this)); - }); - $('a.show-proposal').live("click", function(event) { - event.preventDefault(); - showProposal($(this).attr('id').substring(2)); - }); - $('a.hide-proposal').live("click", function(event) { - event.preventDefault(); - hideProposal($(this).attr('id').substring(2)); - }); - $('a.show-propose-change').live("click", function(event) { - event.preventDefault(); - showProposeChange($(this).attr('id').substring(2)); - }); - $('a.hide-propose-change').live("click", function(event) { - event.preventDefault(); - hideProposeChange($(this).attr('id').substring(2)); - }); - $('a.accept-comment').live("click", function(event) { - event.preventDefault(); - acceptComment($(this).attr('id').substring(2)); - }); - $('a.delete-comment').live("click", function(event) { - event.preventDefault(); - deleteComment($(this).attr('id').substring(2)); - }); - $('a.comment-markup').live("click", function(event) { - event.preventDefault(); - toggleCommentMarkupBox($(this).attr('id').substring(2)); - }); - } - - /** - * Set comp, which is a comparator function used for sorting and - * inserting comments into the list. - */ - function setComparator() { - // If the first three letters are "asc", sort in ascending order - // and remove the prefix. - if (by.substring(0,3) == 'asc') { - var i = by.substring(3); - comp = function(a, b) { return a[i] - b[i]; }; - } else { - // Otherwise sort in descending order. - comp = function(a, b) { return b[by] - a[by]; }; - } - - // Reset link styles and format the selected sort option. - $('a.sel').attr('href', '#').removeClass('sel'); - $('a.by' + by).removeAttr('href').addClass('sel'); - } - - /** - * Create a comp function. If the user has preferences stored in - * the sortBy cookie, use those, otherwise use the default. - */ - function initComparator() { - by = 'rating'; // Default to sort by rating. - // If the sortBy cookie is set, use that instead. - if (document.cookie.length > 0) { - var start = document.cookie.indexOf('sortBy='); - if (start != -1) { - start = start + 7; - var end = document.cookie.indexOf(";", start); - if (end == -1) { - end = document.cookie.length; - by = unescape(document.cookie.substring(start, end)); - } - } - } - setComparator(); - } - - /** - * Show a comment div. - */ - function show(id) { - $('#ao' + id).hide(); - $('#ah' + id).show(); - var context = $.extend({id: id}, opts); - var popup = $(renderTemplate(popupTemplate, context)).hide(); - popup.find('textarea[name="proposal"]').hide(); - popup.find('a.by' + by).addClass('sel'); - var form = popup.find('#cf' + id); - form.submit(function(event) { - event.preventDefault(); - addComment(form); - }); - $('#s' + id).after(popup); - popup.slideDown('fast', function() { - getComments(id); - }); - } - - /** - * Hide a comment div. - */ - function hide(id) { - $('#ah' + id).hide(); - $('#ao' + id).show(); - var div = $('#sc' + id); - div.slideUp('fast', function() { - div.remove(); - }); - } - - /** - * Perform an ajax request to get comments for a node - * and insert the comments into the comments tree. - */ - function getComments(id) { - $.ajax({ - type: 'GET', - url: opts.getCommentsURL, - data: {node: id}, - success: function(data, textStatus, request) { - var ul = $('#cl' + id); - var speed = 100; - $('#cf' + id) - .find('textarea[name="proposal"]') - .data('source', data.source); - - if (data.comments.length === 0) { - ul.html('
            • No comments yet.
              • '); - ul.data('empty', true); - } else { - // If there are comments, sort them and put them in the list. - var comments = sortComments(data.comments); - speed = data.comments.length * 100; - appendComments(comments, ul); - ul.data('empty', false); - } - $('#cn' + id).slideUp(speed + 200); - ul.slideDown(speed); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem retrieving the comments.'); - }, - dataType: 'json' - }); - } - - /** - * Add a comment via ajax and insert the comment into the comment tree. - */ - function addComment(form) { - var node_id = form.find('input[name="node"]').val(); - var parent_id = form.find('input[name="parent"]').val(); - var text = form.find('textarea[name="comment"]').val(); - var proposal = form.find('textarea[name="proposal"]').val(); - - if (text == '') { - showError('Please enter a comment.'); - return; - } - - // Disable the form that is being submitted. - form.find('textarea,input').attr('disabled', 'disabled'); - - // Send the comment to the server. - $.ajax({ - type: "POST", - url: opts.addCommentURL, - dataType: 'json', - data: { - node: node_id, - parent: parent_id, - text: text, - proposal: proposal - }, - success: function(data, textStatus, error) { - // Reset the form. - if (node_id) { - hideProposeChange(node_id); - } - form.find('textarea') - .val('') - .add(form.find('input')) - .removeAttr('disabled'); - var ul = $('#cl' + (node_id || parent_id)); - if (ul.data('empty')) { - $(ul).empty(); - ul.data('empty', false); - } - insertComment(data.comment); - var ao = $('#ao' + node_id); - ao.find('img').attr({'src': opts.commentBrightImage}); - if (node_id) { - // if this was a "root" comment, remove the commenting box - // (the user can get it back by reopening the comment popup) - $('#ca' + node_id).slideUp(); - } - }, - error: function(request, textStatus, error) { - form.find('textarea,input').removeAttr('disabled'); - showError('Oops, there was a problem adding the comment.'); - } - }); - } - - /** - * Recursively append comments to the main comment list and children - * lists, creating the comment tree. - */ - function appendComments(comments, ul) { - $.each(comments, function() { - var div = createCommentDiv(this); - ul.append($(document.createElement('li')).html(div)); - appendComments(this.children, div.find('ul.comment-children')); - // To avoid stagnating data, don't store the comments children in data. - this.children = null; - div.data('comment', this); - }); - } - - /** - * After adding a new comment, it must be inserted in the correct - * location in the comment tree. - */ - function insertComment(comment) { - var div = createCommentDiv(comment); - - // To avoid stagnating data, don't store the comments children in data. - comment.children = null; - div.data('comment', comment); - - var ul = $('#cl' + (comment.node || comment.parent)); - var siblings = getChildren(ul); - - var li = $(document.createElement('li')); - li.hide(); - - // Determine where in the parents children list to insert this comment. - for(i=0; i < siblings.length; i++) { - if (comp(comment, siblings[i]) <= 0) { - $('#cd' + siblings[i].id) - .parent() - .before(li.html(div)); - li.slideDown('fast'); - return; - } - } - - // If we get here, this comment rates lower than all the others, - // or it is the only comment in the list. - ul.append(li.html(div)); - li.slideDown('fast'); - } - - function acceptComment(id) { - $.ajax({ - type: 'POST', - url: opts.acceptCommentURL, - data: {id: id}, - success: function(data, textStatus, request) { - $('#cm' + id).fadeOut('fast'); - $('#cd' + id).removeClass('moderate'); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem accepting the comment.'); - } - }); - } - - function deleteComment(id) { - $.ajax({ - type: 'POST', - url: opts.deleteCommentURL, - data: {id: id}, - success: function(data, textStatus, request) { - var div = $('#cd' + id); - if (data == 'delete') { - // Moderator mode: remove the comment and all children immediately - div.slideUp('fast', function() { - div.remove(); - }); - return; - } - // User mode: only mark the comment as deleted - div - .find('span.user-id:first') - .text('[deleted]').end() - .find('div.comment-text:first') - .text('[deleted]').end() - .find('#cm' + id + ', #dc' + id + ', #ac' + id + ', #rc' + id + - ', #sp' + id + ', #hp' + id + ', #cr' + id + ', #rl' + id) - .remove(); - var comment = div.data('comment'); - comment.username = '[deleted]'; - comment.text = '[deleted]'; - div.data('comment', comment); - }, - error: function(request, textStatus, error) { - showError('Oops, there was a problem deleting the comment.'); - } - }); - } - - function showProposal(id) { - $('#sp' + id).hide(); - $('#hp' + id).show(); - $('#pr' + id).slideDown('fast'); - } - - function hideProposal(id) { - $('#hp' + id).hide(); - $('#sp' + id).show(); - $('#pr' + id).slideUp('fast'); - } - - function showProposeChange(id) { - $('#pc' + id).hide(); - $('#hc' + id).show(); - var textarea = $('#pt' + id); - textarea.val(textarea.data('source')); - $.fn.autogrow.resize(textarea[0]); - textarea.slideDown('fast'); - } - - function hideProposeChange(id) { - $('#hc' + id).hide(); - $('#pc' + id).show(); - var textarea = $('#pt' + id); - textarea.val('').removeAttr('disabled'); - textarea.slideUp('fast'); - } - - function toggleCommentMarkupBox(id) { - $('#mb' + id).toggle(); - } - - /** Handle when the user clicks on a sort by link. */ - function handleReSort(link) { - var classes = link.attr('class').split(/\s+/); - for (var i=0; iThank you! Your comment will show up ' - + 'once it is has been approved by a moderator.'); - } - // Prettify the comment rating. - comment.pretty_rating = comment.rating + ' point' + - (comment.rating == 1 ? '' : 's'); - // Make a class (for displaying not yet moderated comments differently) - comment.css_class = comment.displayed ? '' : ' moderate'; - // Create a div for this comment. - var context = $.extend({}, opts, comment); - var div = $(renderTemplate(commentTemplate, context)); - - // If the user has voted on this comment, highlight the correct arrow. - if (comment.vote) { - var direction = (comment.vote == 1) ? 'u' : 'd'; - div.find('#' + direction + 'v' + comment.id).hide(); - div.find('#' + direction + 'u' + comment.id).show(); - } - - if (opts.moderator || comment.text != '[deleted]') { - div.find('a.reply').show(); - if (comment.proposal_diff) - div.find('#sp' + comment.id).show(); - if (opts.moderator && !comment.displayed) - div.find('#cm' + comment.id).show(); - if (opts.moderator || (opts.username == comment.username)) - div.find('#dc' + comment.id).show(); - } - return div; - } - - /** - * A simple template renderer. Placeholders such as <%id%> are replaced - * by context['id'] with items being escaped. Placeholders such as <#id#> - * are not escaped. - */ - function renderTemplate(template, context) { - var esc = $(document.createElement('div')); - - function handle(ph, escape) { - var cur = context; - $.each(ph.split('.'), function() { - cur = cur[this]; - }); - return escape ? esc.text(cur || "").html() : cur; - } - - return template.replace(/<([%#])([\w\.]*)\1>/g, function() { - return handle(arguments[2], arguments[1] == '%' ? true : false); - }); - } - - /** Flash an error message briefly. */ - function showError(message) { - $(document.createElement('div')).attr({'class': 'popup-error'}) - .append($(document.createElement('div')) - .attr({'class': 'error-message'}).text(message)) - .appendTo('body') - .fadeIn("slow") - .delay(2000) - .fadeOut("slow"); - } - - /** Add a link the user uses to open the comments popup. */ - $.fn.comment = function() { - return this.each(function() { - var id = $(this).attr('id').substring(1); - var count = COMMENT_METADATA[id]; - var title = count + ' comment' + (count == 1 ? '' : 's'); - var image = count > 0 ? opts.commentBrightImage : opts.commentImage; - var addcls = count == 0 ? ' nocomment' : ''; - $(this) - .append( - $(document.createElement('a')).attr({ - href: '#', - 'class': 'sphinx-comment-open' + addcls, - id: 'ao' + id - }) - .append($(document.createElement('img')).attr({ - src: image, - alt: 'comment', - title: title - })) - .click(function(event) { - event.preventDefault(); - show($(this).attr('id').substring(2)); - }) - ) - .append( - $(document.createElement('a')).attr({ - href: '#', - 'class': 'sphinx-comment-close hidden', - id: 'ah' + id - }) - .append($(document.createElement('img')).attr({ - src: opts.closeCommentImage, - alt: 'close', - title: 'close' - })) - .click(function(event) { - event.preventDefault(); - hide($(this).attr('id').substring(2)); - }) - ); - }); - }; - - var opts = { - processVoteURL: '/_process_vote', - addCommentURL: '/_add_comment', - getCommentsURL: '/_get_comments', - acceptCommentURL: '/_accept_comment', - deleteCommentURL: '/_delete_comment', - commentImage: '/static/_static/comment.png', - closeCommentImage: '/static/_static/comment-close.png', - loadingImage: '/static/_static/ajax-loader.gif', - commentBrightImage: '/static/_static/comment-bright.png', - upArrow: '/static/_static/up.png', - downArrow: '/static/_static/down.png', - upArrowPressed: '/static/_static/up-pressed.png', - downArrowPressed: '/static/_static/down-pressed.png', - voting: false, - moderator: false - }; - - if (typeof COMMENT_OPTIONS != "undefined") { - opts = jQuery.extend(opts, COMMENT_OPTIONS); - } - - var popupTemplate = '\ -
              \ -

              \ - Sort by:\ - best rated\ - newest\ - oldest\ -

              \ -
              Comments
              \ -
              \ - loading comments...
              \ -
                \ -
                \ -

                Add a comment\ - (markup):

                \ -
                \ - reStructured text markup: *emph*, **strong**, \ - ``code``, \ - code blocks: :: and an indented block after blank line
                \ -
                \ - \ -

                \ - \ - Propose a change ▹\ - \ - \ - Propose a change ▿\ - \ -

                \ - \ - \ - \ - \ -
                \ -
                \ -
                '; - - var commentTemplate = '\ -
                \ -
                \ -
                \ - \ - \ - \ - \ - \ - \ -
                \ -
                \ - \ - \ - \ - \ - \ - \ -
                \ -
                \ -
                \ -

                \ - <%username%>\ - <%pretty_rating%>\ - <%time.delta%>\ -

                \ -
                <#text#>
                \ -

                \ - \ - reply ▿\ - proposal ▹\ - proposal ▿\ - \ - \ -

                \ - 
                \
-<#proposal_diff#>\
-
                \ -
                  \ -
                  \ -
                  \ -
                  \ - '; - - var replyTemplate = '\ -
                • \ -
                  \ -
                  \ - \ - \ - \ - \ - \ -
                  \ -
                  \ -
                  • '; - - $(document).ready(function() { - init(); - }); -})(jQuery); - -$(document).ready(function() { - // add comment anchors for all paragraphs that are commentable - $('.sphinx-has-comment').comment(); - - // highlight search words in search results - $("div.context").each(function() { - var params = $.getQueryParameters(); - var terms = (params.q) ? params.q[0].split(/\s+/) : []; - var result = $(this); - $.each(terms, function() { - result.highlightText(this.toLowerCase(), 'highlighted'); - }); - }); - - // directly open comment window if requested - var anchor = document.location.hash; - if (anchor.substring(0, 9) == '#comment-') { - $('#ao' + anchor.substring(9)).click(); - document.location.hash = '#s' + anchor.substring(9); - } -}); diff --git a/cmf/html/bundles/block.html b/cmf/html/bundles/block.html deleted file mode 100644 index 249a070..0000000 --- a/cmf/html/bundles/block.html +++ /dev/null @@ -1,198 +0,0 @@ - - - - - - - - - - BlockBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  BlockBundle

                  -

                  El BlockBundle proporciona integración con SonataBlockBundle. -Este te asiste gestionando fragmentos de contenido, conocidos como bloques. Lo que hace BlockBundle es similar a lo que hace Twig, pero para bloques almacenados en una BD. De esta manera, un editor puede modificar los bloques. -Además, el BlockBundle proporciona la lógica para determinar qué bloque se tendría que dibujar en cuáles páginas.

                  -

                  El BlockBundle por sí mismo no proporciona una funcionalidad de edición para bloques. No obstante, puedes encontrar ejemplos de cómo hacer editables los bloques en el recinto de seguridad del CMF de Symfony.

                  -
                  -

                  Dependencias

                  -

                  Este paquete está basado en el SonataBlockBundle

                  -
                  -
                  -

                  Configurando

                  -

                  La clave de configuración para este paquete es symfony_cmf_block

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_block:
-    document_manager_name:  default
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Dibujando el bloque

                  -

                  Antes de que puedas dibujar un bloque, necesitas crear un objeto que represente los datos de tu bloque en el repositorio. -Lo puedes conseguir con el siguiente fragmento de código (ten en cuenta que $parentPage necesita ser una instancia de una página definida por el ContentBundle):

                  -
                  $myBlock = new SimpleBlock();
-$myBlock->setParentDocument($parentPage);
-$myBlock->setName('sidebarBlock');
-$myBlock->setTitle('My first block');
-$myBlock->setContent('Hello block world!');
-
-$documentManager->persist($myBlock);
-
                  -
                  -

                  Ten en cuenta que el sidebarBlock es el identificador que escogimos para el bloque. Junto con el documento padre del bloque, esto hace único al bloque. Las otras propiedades son específicas a Simpleblock. -Ahora para realmente dibujar este bloque, justo añade el siguiente código a tu plantilla de Twig:

                  -
                  {{ sonata_block_render({'name': 'sidebarBlock'}) }}
-
                  -
                  -

                  Esto hará que se dibuje el BlockBundle según el bloque en cada página que tenga un bloque llamado 'sidebarBlock'. Naturalmente, es necesario que la página real sea reproducida por la plantilla que contiene el fragmento anterior.

                  -
                  -
                  -

                  Tipos de bloque

                  -
                  -
                  El BlockBundle viene con cuatro bloques de propósito general:
                  -
                    -
                  • SimpleBlock: Un bloque sencillo con nada más que un título y un campo de hipertexto. Este normalmente sería el que un editor modificaría directamente, por ejemplo, la información de contacto
                    • -
                  • ContainerBlock: Un bloque que contiene de 0 a n bloques descendientes
                    • -
                  • ReferenceBlock: Un bloque que hace referencia a un bloque almacenado en algún otro lugar en el árbol de contenido. Por ejemplo, podrías querer referir partes de la información de contacto desde la página inicial
                    • -
                  • ActionBlock: Un bloque que invoca acciones de Symfony2. «¿Por qué utilizar esto en vez de llamar a la acción directamente desde mi plantilla?», te podrías preguntar. Bien, imagina el siguiente caso: Provees un bloque que dibuja reflexiones de tus últimas noticias. Sin embargo, no hay ninguna regla de en dónde tendría que aparecer. En cambio, tu cliente quiere decidir en qué páginas sería mostrado este bloque. Proporcionando un ActionBlock acorde, tu cliente te permite hacerlo sin llamarle (¡una y otra vez!) para cambiar algunas plantillas.
                    • -
                  -
                  -
                  -
                  -
                  -

                  Crea tus propios bloques

                  -

                  Digamos que estás trabajando en un proyecto donde tienes que integrar los datos recibidos de varios alimentadores RSS. -Por supuesto podrías crear un ActionBlock para cada uno de estos alimentadores, ¿pero no es tonto esto? De hecho todas estas acciones se verían similares: Recibes los datos desde un alimentador, los saneas y pasas los datos a una plantilla. De este modo decides crear tu propio bloque, el RSSBlock.

                  -

                  Lo primero que necesitas es una entidad que contenga los datos. Es recomendable extender el contenido desde el BaseBlock de este paquete (aun así no es forzoso hacerlo, siempre y cuando implementes la Sonata\BlockBundle\Model\BlockInterface). En tu entidad, añades dos propiedades, 'feedURL' y 'templateName', así como captadores y definidores para ellas. Además, necesitas definir el método getType que sólo regresa el 'my_bundle.block.rss'.

                  -

                  La segunda cosa necesaria es un servicio que RSSBlocks sabe cómo manejar. En el caso del RSSBlock sería esto: Recuperar los datos desde dónde estén almacenados en 'feedURL', sanearlos, y pasarlos a la plantilla almacenada en 'templateName'. De nuevo, puedes extender el Sonata\BlockBundle\Block\BaseBlockService. -Es importante, denominar la propiedad 'name' del servicio 'my_bundle.block.rss' (Esto garantiza que se pueda encontrar la relación entre la entidad y el servicio).

                  -

                  La última cosa que necesitas para definir el servicio es un archivo config. Es importante etiquetar tu BlockService con 'sonata.block', de lo contrario no lo reconocerá el paquete.

                  -
                  -
                  -

                  Ejemplos

                  -

                  Puedes encontrar ejemplos de uso de este paquete en el Recinto de seguridad del CMF de Symfony. -Dale un vistazo en el BlockBundle del recinto de seguridad. También te muestra cómo hacer editables los bloques usando el CreateBundle.

                  -
                  -
                  -

                  Relación al paquete Block

                  -

                  El BlockBundle está basado en el SonataBlockBundle. -Este reemplaza componentes del paquete dónde sea necesario que sea compatible con PHPCR.

                  -

                  La siguiente imagen muestra dónde utilizamos nuestros propios componentes (azules):

                  -../_images/classdiagram.jpg -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Usando BlockBundle y ContentBundle con PHPCR

                  -

                  Próximo tema

                  -

                  ContentBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/content.html b/cmf/html/bundles/content.html deleted file mode 100644 index a0d6d01..0000000 --- a/cmf/html/bundles/content.html +++ /dev/null @@ -1,142 +0,0 @@ - - - - - - - - - - ContentBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  ContentBundle

                  -

                  Este paquete proporciona un documento para contenido estático y el controlador para dibujarlo.

                  -

                  Para más información —por ahora— ve la documentación del ContentBundle

                  -
                  -

                  Configurando

                  -

                  La clave de configuración para este paquete es symfony_cmf_content

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_content:
-    admin_class:          ~
-    document_class:       ~
-    default_template:     ~
-    content_basepath:     /cms/content
-    static_basepath:      /cms/content/static
-    use_sonata_admin:     auto
-    multilang:
-        admin_class:          ~
-        document_class:       ~
-        use_sonata_admin:     auto
-        locales:              []
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  BlockBundle

                  -

                  Próximo tema

                  -

                  CoreBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/core.html b/cmf/html/bundles/core.html deleted file mode 100644 index 23ca79b..0000000 --- a/cmf/html/bundles/core.html +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - - - - CoreBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  CoreBundle

                  -

                  Este es el CoreBundle para el CMF de Symfony 2. Este paquete proporciona funcionalidad común, ayudantes y utilidades para los otros paquetes del CMF.

                  -

                  Una de las características proporcionadas es una interfaz e implementación de un supervisor del flujo de trabajo para la publicación con una interfaz acompañante en la cual los modelos pueden implementar aquello que quieran apoyar con este supervisor.

                  -

                  Además, proporciona un ayudante de Twig que expone varias funciones útiles para que las plantillas de Twig interaccinen con documentos PHPCR-ODM.

                  -
                  -

                  Configurando

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_core:
-    document_manager: default
-    role``: IS_AUTHENTICATED_ANONYMOUSLY # usado por el supervisor del
-                                         # flujo de trabajo
-                                         # para publicación
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Supervisor del flujo de trabajo para publicación

                  -

                  El paquete proporciona un servicio symfony_cmf_core.publish_workflow_checker que implementa la PublishWorkflowCheckerInterface. Esta interfaz define un solo método checkIsPublished().

                  -
                  $publishWorkflowChecker = $container->get('symfony_cmf_core.publish_workflow_checker');
-$ignoreRole = false // si ignora el rol al momento de decidir si considera
-                    // el documento como publicado
-if ($publishWorkflowChecker->checkIsPublished($document, $ignoreRole)) {
-    ..
-}
-
                  -
                  -
                  -
                  -

                  Extensión Twig

                  -

                  Implementa las siguientes funciones:

                  -
                    -
                  • cmf_find: Encuentra el documento por medio de la ruta y clase proporcionadas
                    • -
                  • cmf_is_published: Comprueba si el documento proporcionado está publicado
                    • -
                  • cmf_prev: Devuelve el anterior documento publicado examinando los nodos hijos del padre proporcionado
                    • -
                  • cmf_next: Devuelve el siguiente documento publicado examinando los nodos hijos del padre proporcionado
                    • -
                  • cmf_children: Devuelve un arreglo con todos los documentos hijo de los documentos proporcionados que están publicados
                    • -
                  • cmf_document_locales: Obtiene las regiones del documento proporcionado
                    • -
                  -
                  {% set page = cmf_find('/alguna/ruta') %}
-
-{% if cmf_is_published(page) %}
-    {% set prev = cmf_prev(page) %}
-    {% if prev %}
-        <a href="{{ path(prev) }}">prev</a>
-    {% endif %}
-
-    {% set next = cmf_next(page) %}
-    {% if next %}
-        <span style="float: right; padding-right: 40px;"><a href="{{ path(next) }}">next</a></span>
-    {% endif %}
-
-    {% for news in cmf_children(page)|reverse %}
-        <li><a href="{{ path(news) }}">{{ news.title }}</a> ({{ news.publishStartDate | date('Y-m-d')  }})</li>
-    {% endfor %}
-
-    {% if 'de' in cmf_document_locales(page) %}
-        <a href="{{ path(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')|merge(app.request.query.all)|merge({'_locale': 'de'})) }}">DE</a>
-    {% endif %}
-    {% if 'fr' in cmf_document_locales(page) %}
-        <a href="{{ path(app.request.attributes.get('_route'), app.request.attributes.get('_route_params')|merge(app.request.query.all)|merge({'_locale': 'fr'})) }}">DE</a>
-    {% endif %}
-{% endif %}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  ContentBundle

                  -

                  Próximo tema

                  -

                  CreateBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/create.html b/cmf/html/bundles/create.html deleted file mode 100644 index 0ed9c41..0000000 --- a/cmf/html/bundles/create.html +++ /dev/null @@ -1,367 +0,0 @@ - - - - - - - - - - CreateBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  CreateBundle

                  -

                  El CreateBundle integra a Symfony 2 las bibliotecas ayudante create.js y createphp.

                  -

                  create.js es una comprensible interfaz de edición web para Sistemas de administración de contenido (CMS). Está diseñado para proporcionar un moderno gestor de contenido, totalmente basado en un entorno de navegadores HTML5. Creado para poder adaptarlo para trabajar en casi cualquier interfaz de administración de contenido. -Ve http://createjs.org/

                  -

                  Createphp es una biblioteca PHP para ayudarte con anotaciones RDF en tus entidades/documentos. -Ve la documentación sobre como trabaja en https://github.com/flack/createphp.

                  -
                  -

                  Dependencias

                  -

                  Este paquete incluye create.js (el cuál empaca todas sus dependencias como jquery, vie, hallo, backbone, etc.) como submódulos git. No olvides añadir el guión del controlador de composer a tu archivo composer.json como se describe abajo.

                  -

                  Las dependencias de PHP son manejadas por medio de composer. Utilizamos createphp así como AsseticBundle, FOSRestBundle y por inferencia también JmsSerializerBundle. Asegúrate de crear una instancia de todos estos paquetes en tu nucleo y de configurar correctamente el assetic.

                  -
                  -
                  -

                  Instalando

                  -

                  Este paquete se incluye mejor utilizando Composer.

                  -

                  Edita el archivo composer de tu proyecto añadiendo un nuevo requisito para symfony-cmf/create-bundle. -Luego, crea una sección de guiones o añádelo a una existente:

                  -
                  {
-    "scripts": {
-        "post-install-cmd": [
-            "Symfony\\Cmf\\Bundle\\SymfonyCmfCreateBundle\\Composer\\ScriptHandler::initSubmodules",
-            ...
-        ],
-        "post-update-cmd": [
-            "Symfony\\Cmf\\Bundle\\SymfonyCmfCreateBundle\\Composer\\ScriptHandler::initSubmodules",
-            ...
-        ]
-    }
-}
-
                  -
                  -

                  Añade este paquete (y sus dependencias, si aún no están) al núcleo de tu aplicación:

                  -
                  // application/ApplicationKernel.php
-public function registerBundles()
-{
-    return array(
-        // ...
-        new Symfony\Bundle\AsseticBundle\AsseticBundle(),
-        new JMS\SerializerBundle\JMSSerializerBundle($this),
-        new FOS\RestBundle\FOSRestBundle(),
-        new Symfony\Cmf\Bundle\SymfonyCmfCreateBundle\SymfonyCmfCreateBundle(),
-        // ...
-    );
-}
-
                  -
                  -

                  También necesitas configurar el FOSRestBundle para manejar json:

                  -
                  fos_rest:
-    view:
-        formats:
-            json: true
-
                  -
                  -
                  -
                  -

                  Concepto

                  -

                  Createphp usa metadatos RDF sobre las clases de tu dominio, tal como Doctrine -sabe cómo se almacenan los metadatos de un objeto en la base de datos. Los metadatos son modelados por el tipo de la clase y pueden provenir de cualquier fuente. Createphp proporciona controladores de metadatos que leen XML, arreglos PHP y uno que justo introspecciona objetos y crea metadatos no semánticos que serán suficientes para editar con create.js.

                  -

                  El RdfMapper se usa para traducir entre tu capa de almacenamiento y createphp. -Este es pasado al objeto dominio y al objeto metadatos pertinente.

                  -

                  Con los metadatos y el ayudante de Twig, el contenido es dibujado con anotaciones RDF. create.js es cargado y habilitado para editar las entidades. Guarda en la interfaz de administración las operaciones que ocurrieron en llamadas ajax.

                  -

                  El controlador REST maneja esas llamadas ajax, y si quieres ser capaz de cargar imágenes, un controlador de imagen guarda las imágenes cargadas y devuelve la ubicación -de la imagen.

                  -
                  -
                  -

                  Configurando

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_create:
-    # cargando metadatos
-
-    # Lista de directorios para buscar metadatos
-    rdf_config_dirs:
-        - "%kernel.root_dir%/Resources/rdf-mappings"
-    # busca asociaciones en <Paquete>/Resources/rdf-mappings
-    # auto_mapping: true
-
-    # usa una clase diferente para el controlador REST
-    # rest_controller_class: FQN\Classname
-    # Habilita el modo de desarrollo 'hallo' (ve al final de este capítulo)
-    # use_coffee: false
-
-    # manejo de imagen
-    imagen:
-        model_class: ~
-        controller_class: ~
-
-    # rol para controlar el acceso para inclusión js, predefinido
-    # REST y controladores de imagen
-    # role: IS_AUTHENTICATED_ANONYMOUSLY
-
-    # Habilita el asignador PHPCR-ODM de Doctrine
-    phpcr_odm: true
-
-    # asociación de tipo rdf name => class nombre usado al añadir ítems a colecciones
-    map:
-        rdfname: FQN\Classname
-
-    # url para mejora semántica stanbol, de lo contrario la
-    # predeterminada es la instalación del demo
-    # stanbol_url: http://dev.iks-project.eu:8081
-
-    # fija la barra de edición Hallo en lo alto de la página
-    # fixed_toolbar: true
-
-    # los tipos RDF para elementos a modificar en texto plano
-    # plain_text_types: ['dcterms:title']
-
                    -
                    -
                    • -
                  -
                  -

                  El archivo javascript proporcionado configura create.js y el editor «hallo». Activa algunos complementos como el editor de etiquetas para revisar colecciones de -atributos skos:related. Esperamos poder añadir algunas opciones de configuración para modificar la configuración de create.js pero también puedes utilizar el archivo como una plantilla y hacer la propia si necesitas mayor personalización.

                  -
                  -

                  Metadatos

                  -

                  createphp necesita información de metadatos para cada clase de tu modelo del dominio. Por omisión, crea paquete usa el controlador de metadatos XML y busca los metadatos en los paquetes habilitados en <Paquete>/Resources/rdf-mappings. Si utilizas un paquete que no tiene ninguna asignación RDF, puedes especificar una lista de rdf_config_dirs que se analizará adicionalmente para buscar metadatos.

                  -

                  Consulta la documentación de createphp para el formato de los metadatos XML.

                  -
                  -
                  -

                  Controlando el acceso

                  -

                  Si utilizas el controlador REST predefinido, todos pueden editar el contenido una vez activado el crea paquete. Para restringir el acceso, especifica un rol para el paquete que no sea el predefinido -IS_AUTHENTICATED_ANONYMOUSLY. -Si especificas un rol diferente, create.js sólo se cargará si el usuario tiene ese rol y el controlador REST (y el controlador de imagen si está habilitado) revisará el rol.

                  -

                  Si necesitas un control de acceso más fino, busca en el método asignador isEditable. -Puedes extender el asignador a utilizar y sustituir isEditable para que responda si el objeto dominio que se le pasa es editable.

                  -
                  -
                  -

                  Manejando imágenes

                  -

                  Activa el controlador de imágenes simplista con la configuración image > model_class | controller_class. Este controlador de imagen sólo despacha imágenes existentes en el repositorio PHPCR-ODM y también las sirve en peticiones.

                  -

                  Si necesitas un diferente tratamiento de imágenes, puedes sobrescribir image.model_class y/o image.controller_class, o implementar un servicio personalizado con ImageController y sustituir el symfony_cmf_create.image.controller.

                  -
                  -
                  -

                  Asignación de peticiones a objetos

                  -

                  Por ahora, el paquete sólo proporciona un servicio para asociar al PHPCR-ODM de Doctrine. Activado al establecer phpcr_odm en true. Si necesitas algo más, debes proporcionar un servicio symfony_cmf_create.object_mapper. (Si necesitas un contenedor para el ORM de Doctrine, mira los asignadores de la biblioteca createphp y haz una petición de extracción en la biblioteca, y otra para exponer el ORM como asignador del servicio en el crea paquete).

                  -

                  Además, ten en cuenta que createphp apoyaría diferentes asignadores para diferentes tipos de RDF. -Si necesitas esto, escarva un poco en createphp y crea paquete y haz una petición de extracción para activar esa característica.

                  -

                  Para poder crear nuevos objetos, es necesario proporcionar una asociación entre los tipos RDF y los nombres de clase. (Pendiente: ¿no podemos indexar todas las asignaciones y hacer esto automáticamente?)

                  -
                  -
                  -

                  Enrutando

                  -

                  Por último añade la ruta correspondiente a tu configuración:

                  -
                  -
                    -
                  • YAML
                    create:
-    resource: "@SymfonyCmfCreateBundle/Resources/config/routing/rest.xml"
-create_image:
-    resource: "@SymfonyCmfCreateBundle/Resources/config/routing/image.xml"
-
                    -
                    -
                    • -
                  • XML
                    <import resource="@SymfonyCmfCreateBundle/Resources/config/routing/rest.xml" type="rest" />
-<import resource="@SymfonyCmfCreateBundle/Resources/config/routing/image.xml" type="rest" />
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Alternativas: Editor Aloha

                  -

                  Opcional: El editor Aloha (create.js viene con el editor hallo, pero si lo prefieres, también puedes utilizar el aloha)

                  -
                  -

                  Para usar el editor Aloha, descarga los archivos aqui: https://github.com/alohaeditor/Aloha-Editor/downloads/

                  -

                  Descomprime el contenido del subdirectorio «aloha» en el archivo «zip» como un directorio en vendor/symfony-cmf/create-bundle/Symfony/CMF/Bundle/CreateBundle/vendor/aloha

                  -

                  Asegúrate de tener un sólo directorio aloha con el js, no aloha/aloha/... —debes tener vendor/symfony-cmf/create-bundle/Symfony/CMF/Bundle/CreateBundle/vendor/aloha/aloha.js

                  -
                  -
                  -
                  -
                  -

                  Usando

                  -

                  Ajusta tu plantilla para cargar los archivos js del editor si la sesión actual tiene permitido editar el contenido.

                  -
                  {% render "symfony_cmf_create.jsloader.controller:includeJSFilesAction" %}
-
                  -
                  -

                  Además, asegúrate de que assetic está reescribiendo rutas en tus archivos css, y luego incluye los archivos css base (y personalízalos con tu propio css cuando sea necesario) con:

                  -
                  {% include "SymfonyCmfCreateBundle::includecssfiles.html.twig" %}
-
                  -
                  -

                  La otra cosa que tienes que hacer es proporcionar asignación RDF para las clases de tu modelo y ajusta tus plantillas para reproducir con createphp a modo de que create.js sepa cual contenido es editable.

                  -

                  Crea la asignación de metadatos XML en <Paquete>/Resources/rdf-mappings/ o una ruta -a tu rdf_config_dirs configurado después del nombre completamente cualificado de tus clases del modelo sustituyendo \\ con un punto (.), es decir, Symfony.Cmf.Bundle.SimpleCmsBundle.Document.MultilangPage.xml. -Para un ejemplo de asociación ve los archivos en el cmf-sandbox. La documentación de referencia está en el repositorio de la biblioteca createphp.

                  -

                  Para dibujar tu modelo, usa la etiqueta createphp de Twig:

                  -
                  {% createphp page as="rdf" %}
-{{ rdf|raw }}
-{% endcreatephp %}
-
                  -
                  -

                  O si necesitas más control sobre el HTML generado:

                  -
                  {% createphp page as="rdf" %}
-<div {{ createphp_attributes(rdf) }}>
-    <h1 class="my-title" {{ createphp_attributes( rdf.title ) }}>{{ createphp_content( rdf.title ) }}</h1>
-    <div {{ createphp_attributes( rdf.body ) }}>{{ createphp_content( rdf.body ) }}</div>
-</div>
-{% endcreatephp %}
-
                  -
                  -
                  -
                  -

                  Desarrollando el editor wysiwyg hallo

                  -

                  Puedes desarrollar el editor hallo dentro del Crea paquete. De manera predefinida, se usa una versión minimizada del hallo empacada con Crea paquete. Para desarrollar el código real, primero necesitas activar con checkout el repositorio hallo completo. Lo puedes hacer ejecutando la siguiente orden desde la línea de ordenes:

                  -
                  app/console cmf:create:init-hallo-devel
-
                  -
                  -

                  Luego, ajusta la opción symfony_cmf_create > use_coffee a true en el archivo config.yml. Esto le dice al jsloader que incluya los archivos del guión coffee desde Resources/public/vendor/hallo/src con assetic, en lugar del javascript precompilado en Resources/public/vendor/create/deps/hallo-min.js. -Esto también significa que necesitas añadir una asociación para coffeescript en tu -configuración de assetic y necesitas tener instalado y configurado correctamente el compilador de coffee.

                  -
                  -
                    -
                  • YAML
                    assetic:
-    filters:
-        cssrewrite: ~
-        coffee:
-            bin: %coffee.bin%
-            node: %coffee.node%
-            apply_to: %coffee.extension%
-
-symfony_cmf_create:
-    # pónlo a true si  quieres desarrollar hallo y editar los archivos de coffee
-    use_coffee: true|false
                    -
                    -
                    • -
                  -
                  -

                  En el recinto de seguridad del cmf hacemos una pequeña trampa para no provocar la compilación del guión de coffee. -En el archivo config.yml hacemos configurable la extensión de coffee. Ahora si parameters.yml pone coffee.extension a \.coffee el coffeescript es compilado y el compilador de coffee debe estar instalado. Si lo pusiste a cualquier otra cosa tal como \.nocoffee entonces no es necesario tener instalado el compilador de coffee.

                  -

                  Los valores predefinidos para los tres parámetros son:

                  -
                  -
                    -
                  • YAML
                    coffee.bin: /usr/local/bin/coffee
-coffee.node: /usr/local/bin/node
-coffee.extension: \.coffee
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  CoreBundle

                  -

                  Próximo tema

                  -

                  DoctrinePHPCRBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/doctrine_phpcr_admin.html b/cmf/html/bundles/doctrine_phpcr_admin.html deleted file mode 100644 index e759d3a..0000000 --- a/cmf/html/bundles/doctrine_phpcr_admin.html +++ /dev/null @@ -1,155 +0,0 @@ - - - - - - - - - - SonataDoctrinePhpcrAdminBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  SonataDoctrinePhpcrAdminBundle

                  -

                  El SonataDoctrinePhpcrAdminBundle proporciona integración con el SonataAdminBundle para habilitar fácilmente la creación de interfaces de usuario.

                  -
                  -

                  Dependencias

                  - -
                  -
                  -

                  Configurando

                  -
                  -
                    -
                  • YAML
                    sonata_doctrine_phpcr_admin:
-    templates:
-        form:
-
-            # Predefinido:
-            - SonataDoctrinePHPCRAdminBundle:Form:form_admin_fields.html.twig
-        filter:
-
-            # Predefinido:
-            - SonataDoctrinePHPCRAdminBundle:Form:filter_admin_fields.html.twig
-        types:
-            list:
-
-                # Prototipo
-            name:                 []                 []
-    document_tree:
-        # Prototipo
-        class: # nombre de la clase
-            valid_children:       []
-            image:
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  SimpleCmsBundle

                  -

                  Próximo tema

                  -

                  TreeBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/menu.html b/cmf/html/bundles/menu.html deleted file mode 100644 index b7381a4..0000000 --- a/cmf/html/bundles/menu.html +++ /dev/null @@ -1,191 +0,0 @@ - - - - - - - - - - MenuBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  DoctrinePHPCRBundle

                  -

                  Próximo tema

                  -

                  RoutingExtraBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/phpcr-odm.html b/cmf/html/bundles/phpcr-odm.html deleted file mode 100644 index c80e26f..0000000 --- a/cmf/html/bundles/phpcr-odm.html +++ /dev/null @@ -1,478 +0,0 @@ - - - - - - - - - - DoctrinePHPCRBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  DoctrinePHPCRBundle

                  -

                  El DoctrinePHPCRBundle proporciona integración con el repositorio de contenido PHP y opcionalmente con el PHPCR-ODM de Doctrine -para proporcionar el gestor de documentos ODM en Symfony.

                  -
                  -

                  Truco

                  -

                  Esta referencia sólo explica la integración de Symfony2 con PHPCR y PHPCR-ODM. Para aprender cómo utilizar PHPCR ve al sitio web de PHPCR y para la documentación del PHPCR-ODM de Doctrine .

                  -
                  - -
                  -

                  Configurando

                  -
                  -

                  Truco

                  -

                  Si sólo quieres utilizar el PHPCR sencillo sin el PHPCR-ODM, sencillamente no configures la sección odm para evitar que cargue los servicios. Ten en cuenta que muchos paquetes del CMF de manera predefinida usan documentos PHPCR-ODM.

                  -
                  -
                  -

                  Configurando la sesión PHPCR

                  -

                  La sesión necesita que especifiques una implementación PHPCR en la sección backend para el campo type, junto con opciones de configuración al arranque de la implementación. Actualmente apoyamos jackrabbit, doctrinedbal y midgard2. -Independientemente de la interfaz de administración, cada sesión PHPCR necesita un espacio de trabajo, nombre de usuario y contraseña.

                  -
                  -

                  Truco

                  -

                  Cada implementación de PHPCR tendría que proporcionar el espacio de trabajo predefinido, pero puedes escoger uno diferente. Existe la orden doctrine:phpcr:workspace:create para iniciar un nuevo espacio de trabajo. Ve también las Órdenes del PHPCR de Doctrine.

                  -
                  -

                  Este nombre de usuario y contraseña es el que se está usando en la capa PHPCR en -el PHPCR\SimpleCredentials. Normalmente serán diferentes del nombre de usuario y contraseña utilizados por midgard o el DBAL de Doctrine para conectarse al RDBMS subyacente donde de hecho se almacenó el dato.

                  -

                  Si estás utilizando una de las interfaces de administración de Jackalope, también puedes especificar opciones. -Estas serán puestas en la sesión de Jackalope. Actualmente esto se puede ajustar a nodos prerecuperados poniendo jackalope.fetch_depth a algo más grande que 0.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            # ve abajo cómo configurar la interfaz de administración que elejiste
-        workspace: default
-        username: admin
-        password: admin
-        # opciones:
-        #    key: valor
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Sesión PHPCR con Jackalope Jackrabbit

                  -

                  Es la única configuración requerida para instalar el Jackrabbit de apache (ve instalando Jackrabbit).

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: jackrabbit
-            url: http://localhost:8080/server/
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Sesión PHPCR con el Jackalope y DBAL de Doctrine

                  -

                  Este tipo usa Jackalope con una abstracción en la capa de transporte de base de datos de Doctrine para proporcionar PHPCR sin ningún requisito de instalación más allá de cualquiera de los RDBMS apoyados por Doctrine.

                  -

                  Necesitas configurar una conexión de Doctrine según el DBAL elejido en -la documentación de Doctrine en Symfony2.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-
                    -
                    -
                    • -
                  -
                  -

                  Una vez configurada la conexión, puedes crear la base de datos y debes iniciar la base de datos con la orden doctrine:phpcr:init:dbal.

                  -
                  app/console doctrine:database:create
-app/console doctrine:phpcr:init:dbal
-
                  -
                  -
                  -

                  Truco

                  -

                  Naturalmente, también puedes utilizar una diferente conexión en vez de la predefinida. -Es recomendable utilizar una conexión independiente para una base de datos separada si también Doctrine usa el acceso a datos del ORM o DBAL directamente, en lugar de mezclar este dato con las tablas generadas por jackalope-doctrine-dbal. -Si tienes una conexión separada, necesitas pasar el nombre de la conexión alterna a la orden doctrine:database:create con la opción --connection. Para las ordenes PHPCR de Doctrine, este parámetro no es necesario al configurar la conexión a utilizar.

                  -
                  -
                  -
                  -

                  Sesión PHPCR con Midgard2

                  -

                  Midgard2 es una aplicación que proporciona una extensión PHP compilada. Esta implementa la API de PHPCR en lo alto de un RDBMS estándar.

                  -

                  Para instalación, significado exacto y valores soportados en las opciones -de configuración, ve la documentación oficial de Midgard con PHPCR

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: midgard2
-            db_type: MySQL
-            db_name: midgard2_test
-            db_host: "0.0.0.0"
-            db_port: 3306
-            db_username: ""
-            db_password: ""
-            db_init: true
-            blobdir: /tmp/cmf-blobs
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Configurando el PHPCR-ODM de Doctrine

                  -

                  Esta sección de configuración gestiona el sistema PHPCR-ODM de Doctrine. Si no configuras ninguna cosa aquí, los servicios ODM no serán cargados.

                  -

                  Si habilitas el auto_mapping, puedes colocar tus asociaciones en <Paquete>/Resources/config/doctrine/<Documento>.phpcr.xml resp. .yml para configurar las asociaciones a documentos proporcionadas en el directorio <Paquete>/Document. De lo contrario necesitas configurar manualmente la sección de asignaciones.

                  -

                  Si auto_generate_proxy_classes es false, necesitas ejecutar la orden cache:warmup -para tener las clases delegadas generadas después de que modificaste un documento. También puedes ajustar cómo y dónde generar las clases delegadas con las opciones proxy_dir y proxy_namespace. Normalmente las predefinidas están bien aquí.

                  -

                  También puedes habilitar el almacenamiento de metadatos en caché.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    odm:
-        configuration_id:     ~
-        auto_mapping: true
-        mappings:
-            <name>:
-                mapping:              true
-                type:                 ~
-                dir:                  ~
-                alias:                ~
-                prefix:               ~
-                is_bundle:            ~
-        auto_generate_proxy_classes: %kernel.debug%
-        proxy_dir:            %kernel.cache_dir%/doctrine/PHPCRProxies
-        proxy_namespace:      PHPCRProxies
-
-        metadata_cache_driver:
-            type:                 array
-            host:                 ~
-            port:                 ~
-            instance_class:       ~
-            class:                ~
-            id:                   ~
                    -
                    -
                    • -
                  -
                  -
                  -

                  Configuración de traducción

                  -

                  Si estás utilizando documentos multilingües, necesitas configurar los idiomas disponibles. Para más información en documentos multilingües, ve la documentación PHPCR-ODM en multilenguaje.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    odm:
-        locales:
-            en: [de, fr]
-            de: [en, fr]
-            fr: [en, de]
-
                    -
                    -
                    • -
                  -
                  -

                  Este bloque define el orden de regiones alternativas para ver si un documento no está traducido al idioma requerido.

                  -
                  -
                  -
                  -

                  Ajustes generales

                  -

                  Si ajustas la ruta a jackrabbit_jar, puedes utilizar la orden de consola doctrine:phpcr:jackrabbit para arrancar y parar el jackrabbit.

                  -

                  Puedes poner a punto la producción de la orden doctrine:phpcr:dump con dump_max_line_length.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    jackrabbit_jar:       /ruta/a/jackrabbit.jar
-    dump_max_line_length:  120
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Configurando múltiples sesiones

                  -

                  Si necesitas más de una interfaz de administración PHPCR, puedes definir sessions como hijo de la información de session. Cada sesión tiene un nombre y configuración que puedes utilizar directamente en session. también puedes sobrescribir qué sesión utilizar como default_session.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        default_session:      ~
-        sessions:
-            <name>:
-                workspace:            ~ # Requerido
-                username:             ~
-                password:             ~
-                backend:
-                    # como arriba
-                options:
-                    # como arriba
-
                    -
                    -
                    • -
                  -
                  -

                  Si estás utilizando el ODM, también querrás configurar múltiples gestores de documento.

                  -

                  Dentro de la sección odm, puedes añadir entradas nombradas en document_managers. -Para utilizar la sesión no predefinida, especifica el atributo session.

                  -
                  -
                    -
                  • YAML
                    odm:
-    default_document_manager:  ~
-    document_managers:
-        <name>:
-            # mismas opciones que directamente en odm, ve arriba.
-            session: <sessionname>
-
                    -
                    -
                    • -
                  -
                  -

                  Un ejemplo completo se ve como sigue:

                  -
                  -
                    -
                  • YAML
                    doctrine_phpcr:
-    # configura las sesiones PHPCR
-    session:
-        sessions:
-
-            default:
-                backend: %phpcr_backend%
-                workspace: %phpcr_workspace%
-                username: %phpcr_user%
-                password: %phpcr_pass%
-
-            website:
-                backend:
-                    type: jackrabbit
-                    url: %magnolia_url%
-                workspace: website
-                username: %magnolia_user%
-                password: %magnolia_pass%
-
-            dms:
-                backend:
-                    type: jackrabbit
-                    url: %magnolia_url%
-                workspace: dms
-                username: %magnolia_user%
-                password: %magnolia_pass%
-    # activa la capa ODM
-    odm:
-        document_managers:
-            default:
-                session: default
-                mappings:
-                    SandboxMainBundle: ~
-                    SymfonyCmfContentBundle: ~
-                    SymfonyCmfMenuBundle: ~
-                    SymfonyCmfRoutingExtraBundle: ~
-
-            website:
-                session: website
-                configuration_id: sandbox_magnolia.odm_configuration
-                mappings:
-                    SandboxMagnoliaBundle: ~
-
-            dms:
-                session: dms
-                configuration_id: sandbox_magnolia.odm_configuration
-                mappings:
-                    SandboxMagnoliaBundle: ~
-
-        auto_generate_proxy_classes: %kernel.debug%
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Este ejemplo también utiliza diferentes configuraciones par repositorio (ve el atributo repository_id). Este caso se explica en Usando una clase documento personalizada asociada con PHPCR-ODM.

                  -
                  -
                  -
                  -

                  Órdenes del PHPCR de Doctrine

                  -

                  Todas las órdenes sobre el PHPCR van prefijadas con doctrine:phpcr y puedes utilizar el argumento --session para utilizar una sesión distinta a la predefinida si configuraste varias sesiones PHPCR.

                  -

                  Algunas de estas órdenes son específicas a una interfaz de administración o al ODM. Esas órdenes -sólo estarán disponibles si tal interfaz de administración está configurada.

                  -

                  Usa app/console help <orden> para ver todas las opciones que tiene cada orden.

                  -
                    -
                  • doctrine:phpcr:workspace:create Crea un espacio de trabajo en el repositorio configurado
                    • -
                  • doctrine:phpcr:workspace:list Enumera todos los espacios de trabajo configurados en el repositorio
                    • -
                  • doctrine:phpcr:purge Elimina todo el contenido del repositorio
                    • -
                  • doctrine:phpcr:register-system-node-types Registra el sistema del tipo de nodo en el repositorio PHPCR
                    • -
                  • doctrine:phpcr:register-node-types Registra el tipo de nodos en el repositorio PHPCR
                    • -
                  • doctrine:phpcr:fixtures:load Carga accesorios a tu base de datos PHPCR.
                    • -
                  • doctrine:phpcr:import Importa datos xml al repositorio, ya sea en el sistema de visualización JCR o XML arbitrario
                    • -
                  • doctrine:phpcr:export Exporta nodos desde el repositorio, bien al sistema de visualización JCR o al formato de visualización de documento
                    • -
                  • doctrine:phpcr:dump vacía el contenido del repositorio
                    • -
                  • doctrine:phpcr:query Executa una declaración SQL2 de JCR
                    • -
                  • doctrine:phpcr:mapping:info Muestra información básica sobre todos los documentos asociados
                    • -
                  -
                  -

                  Órdenes específicas de Jackrabbit

                  -

                  Si estás utilizando jackalope-jackrabbit, también tienes una orden para arrancar y detener el servidor jackrabbit:

                  -
                    -
                  • jackalope:run:jackrabbit Arranca y detiene el servidor Jackrabbit
                    • -
                  -
                  -
                  -

                  Órdenes específicas para el DBAL de Doctrine

                  -

                  Si estás utilizando jackalope-doctrine-dbal, tienes una orden para iniciar la base -de datos:

                  -
                    -
                  • jackalope:init:dbal Prepara la base de datos para el DBAL de Doctrine con Jackalope
                    • -
                  -

                  Ten en cuenta que también puedes utilizar la orden dbal de doctrine para crear la base de datos.

                  -
                  -
                  -

                  Algunas ordenes de ejemplo

                  -

                  Ejecutando consultas SQL2 contra el repositorio

                  -
                  app/console doctrine:phpcr:query "SELECT title FROM [nt:unstructured] WHERE NAME() = 'home'"
-
                  -
                  -

                  Vertiendo nodos bajo /cms/simple incluyendo sus propiedades

                  -
                  app/console doctrine:phpcr:dump /cms/simple --props=yes
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  CreateBundle

                  -

                  Próximo tema

                  -

                  MenuBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/routing-extra.html b/cmf/html/bundles/routing-extra.html deleted file mode 100644 index 960d002..0000000 --- a/cmf/html/bundles/routing-extra.html +++ /dev/null @@ -1,350 +0,0 @@ - - - - - - - - - - RoutingExtraBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  RoutingExtraBundle

                  -

                  El RoutingExtraBundle integra el enrutado dinámico a Symfony utilizando El componente Routing.

                  -

                  El ChainRouter pretende reemplazar el enrutador predefinido de Symfony. Todo lo que hace es recoger una lista priorizada de rutas e intenta emparejar peticiones y generar las url con todas ellas. Naturalmente, una de las rutas en esa cadena puede ser la ruta predefinida para que todavía la puedas utilizar de la manera estándar en algunas de tus rutas.

                  -

                  Además, este paquete entrega útiles implementaciones de enrutado. Actualmente, existe el DynamicRouter que enruta basándose en una implementación de repositorio que proporciona objetos Route de Symfony2. El repositorio se puede implementar utilizando una base de datos, por ejemplo con el PHPCR-ODM de Doctrine o el ORM de Doctrine. El paquete proporciona una implementación predefinida para el PHPCR-ODM de Doctrine.

                  -

                  El servicio DynamicRouter sólo está disponible cuándo se habilita explícitamente en la configuración de la aplicación.

                  -

                  Finalmente estos paquetes proporcionan documentos de ruta para el PHPCR-ODM de Doctrine y un controlador para redirigir rutas.

                  -
                  -

                  Dependencias

                  - -
                  -
                  -

                  ChainRouter

                  -

                  El ChainRouter puede reemplazar el sistema de enrutado predefinido de Symfony con una implementación habilitada en cadena. Esta no enruta nada por sí misma, sino que únicamente recorre todos los enrutadores encadenados. Para manejar las rutas estándar configuradas en Symfony, el enrutador predefinido de Symfony se puede poner en la cadena.

                  -
                  -
                  -

                  Configurando

                  -

                  En tu archivo app/config/config.yml, puedes especificar cual servicio de enrutado quieres usar. Si no especificas el routers_by_id asigna todos, de manera predefinida el enrutador encadenado simplemente cargará el enrutador construido en Symfony. Cuándo especificas la lista de routers_by_id, necesitas tener una entrada para router.default si quieres el enrutador de Symfony2 (aquel que lee las rutas desde app/config/routing.yml).

                  -

                  El formato es service_name: priority — el número de prioridad más alto anterior es preguntado a este servicio enrutador para emparejar una ruta o para generar una url:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    chain:
-        routers_by_id:
-            # activa el DynamicRouter con alta prioridad para redefinir el enrutador configurado con contenido
-            symfony_cmf_routing_extra.dynamic_router: 200
-            # activa el enrutador predefinido de symfony con baja prioridad
-            router.default: 100
-        # cuando la cadena de enrutadores debe sustituir al enrutador predefinido. por omisión es true
-        # si lo pones en false, el enrutador sólo estará disponible como servicio
-        # symfony_cmf_routing_extra.router y debes hacer algo para lanzarlo
-        # replace_symfony_router: true
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Cargando enrutadores con etiquetado

                  -

                  Tus enrutadores se pueden registrar automáticamente, justo añadiéndolos como servicios etiquetados con router y una prioridad opcional. -Mientras más alta prioridad, más temprano será consultado tu enrutador para emparejar la ruta. Si no especificas la prioridad, tu enrutador vendrá al último. -Si hay varios enrutadores con la misma prioridad, el orden entre ellos es indeterminado. -El servicio etiquetado tendrá esta apariencia:

                  -
                  -
                    -
                  • YAML
                    services:
-    my_namespace.my_router:
-        class: %my_namespace.my_router_class%
-        tags:
-                - { name: router, priority: 300 }
                    -
                    -
                    • -
                  • XML
                    <service id="my_namespace.my_router" class="%my_namespace.my_router_class%">
-    <tag name="router" priority="300" />
-    ..
-</service>
-
                    -
                    -
                    • -
                  -
                  -

                  Ve también la documentación oficial de Symfony2 para las etiquetas de inyección de dependencias

                  -
                  -
                  -
                  -

                  Enrutador dinámico

                  -

                  Esta implementación de un enrutador carga rutas de una RouteRepositoryInterface. -Esta interfaz se puede implementar fácilmente con Doctrine.

                  -

                  El enrutador trabaja con las clases base UrlMatcher y UrlGenerator y sólo añade la carga de rutas desde la base de datos y el concepto de contenido referido.

                  -

                  El servicio DynamicRouter está instalado con un repositorio. Ve en la sección de configuración cómo cambiar el route_repository_service y la siguiente sección para más detalles sobre la implementación predefinida basada en PHPCR-ODM.

                  -

                  Querrás configurar el controlador de asignación que decide cuál controlador debe manejar la petición, para evitar codificar nombres de controlador en tus documentos de ruta.

                  -

                  La configuración mínima requerida para cargar el enrutador dinámico como un servicio symfony_cmf_routing_extra.dynamic_router es tenerlo como enabled: true en tu archivo config.yml (El enrutador se activa automáticamente apenas añadas cualquier otra configuración a la entrada dynamic). Sin habilitarlo, el servicio enrutador dinámico no será cargado en absoluto, dejándote utilizar el ChainRouter con tus propios enrutadores:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        enabled: true
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Integrando PHPCR-ODM

                  -

                  Este paquete viene con una implementación de enrutador con repositorio para PHPCR-ODM. -PHPCR es apropiado para la naturaleza del árbol de datos. Si usas PHPCR-ODM con un documento de ruta como el proporcionado, justo puedes dejar el servicio repositorio como el predefinido.

                  -

                  El repositorio predefinido carga la ruta desde la ruta en la petición y todas las rutas padre para permitir que algunos de los segmentos de la ruta sigan siendo parámetros. Si necesitas una diferente manera de cargar rutas o, por ejemplo, nunca usar parámetros, puedes escribir tu propia implementación del repositorio para optimizarla (ve en el archivo cmf_routing.xml cómo configurar el servicio).

                  -
                  -
                  -

                  Proceso de concordancia

                  -

                  La mayoría del proceso de concordancia está descrito en la documentación del componente enrutador del CMF. -La única diferencia es que el paquete colocará el contentDocument en los atributos de la petición en vez de en la ruta predefinida.

                  -

                  Tus controladores pueden (y tienen que) declarar el parámetro $contentDocument en tus métodos Action si se supone que trabajen con el contenido referido por las rutas. -Ve Symfony\Cmf\Bundle\ContentBundle\Controller\ContentController para un ejemplo.

                  -
                  -
                  -

                  Configurando

                  -

                  Para configurar el ControllerMappers, puedes especificar asignaciones. La presencia de cada asignación hace que el contenedor de inyección de dependencias inyecte la respectiva asociación al DynamicRouter.

                  -

                  Las posibles asociaciones son (por orden de precedencia):

                  -
                    -

                  • (Controlador explícito): Si hay un controlador configurado en getRouteDefaults(), se utiliza y no se pregunta por ninguna asociación.

                    -
                    • -

                  • Plantilla explícita: Requiere que el documento de ruta regrese un parámetro '_template' en getRouteDefaults. El controlador genérico configurado es regresado por la asociación.

                    -
                    • -

                  • Controlador por alias: Requiere que el documento de ruta regrese un valor 'type' en getRouteDefaults()

                    -
                    • -
                  • -
                    Controlador por clase: Requiere que el documento de ruta regrese un objeto para getRouteContent(). El documento contenido se comprueba que sea una instancia de los nombres de clase en la asociación y si coincide, regresa el controlador.
                    -

                    Se utiliza instanceof en vez de buscar directamente para trabajar con clases delegadas.

                    -
                    -
                    -
                    • -

                  • Plantilla por clase: Requiere que el documento de ruta regrese un objeto para getRouteContent(). Se comprueba que el documento contenido sea una instancia de los nombres de clase en la asociación y si coincide la plantilla será configurada como '_template' en $defaults y regresa el controlador genérico configurado:

                    -
                    • -
                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        generic_controller: symfony_cmf_content.controller:indexAction
-        controllers_by_alias:
-            editablestatic: sandbox_main.controller:indexAction
-        controllers_by_class:
-            Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: symfony_cmf_content.controller::indexAction
-        templates_by_class:
-            Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent: SymfonyCmfContentBundle:StaticContent:index.html.twig
-
-        # el repositorio es responsable de cargar las rutas
-        # por PHPCR-ODM, principalmente los usamos porque puede asociar la url a una ruta del repositorio
-        # un repositorio orm posiblemente necesite diferente lógica. ve el cmf_routing.xml para un ejemplo si
-        # necesitas definir tu propio servicio
-        manager_registry: doctrine_phpcr
-        manager_name: default
-
-        # Si usas la ruta predefinida del servicio repositorio de Doctrine, lo puedes usar para personalizar
-        # la ruta raíz para el PHPCR-ODM RouteRepository
-        # esta ruta base será inyectada por el Listener\IdPrefix - pero sólo a las rutas que
-        # emparejen el prefijo, para permitirte más de una ruta fuente.
-        routing_repositoryroot: /cms/routes
-
-        # Si quieres reemplazar la ruta predefinida o contenido de los repositorios
-        # aquí puedes especificar los IDs de tu servicio.
-        route_repository_service_id: my_bundle.repository.endpoint
-        content_repository_service_id: my_bundle.repository.endpoint
-
                    -
                    -
                    • -
                  -
                  -

                  Para ver algunos ejemplos, por favor ve en el recinto de seguridad del CMF y específicamente la carga de accesorios de enrutado.

                  -
                  -

                  Configurando la administración de Sonata

                  -

                  Si en la sección require del archivo composer.json añades el sonata-project/doctrine-phpcr-admin-bundle, los documentos de ruta serán expuestos en el SonataDoctrinePhpcrAdminBundle. -Para instrucciones sobre cómo configurar este paquete ve SonataDoctrinePhpcrAdminBundle.

                  -

                  De manera predefinida, use_sonata_admin se pone automáticamente basándose en si SonataDoctrinePhpcrAdminBundle está disponible pero lo puedes desactivar explícitamente si no tienes habilitado sonata, o activarlo explícitamente para conseguir un error si sonata se vuelve inasequible.

                  -

                  Tienes un par de opciones de configuración para la administración. El content_basepath apunta a la raíz de tus documentos de contenido.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    use_sonata_admin: auto # usa true/false para forzar el uso / no uso de la administración de sonata
-    content_basepath: ~ # usado con la administración de sonata para manejar el contenido, por omisión a symfony_cmf_core.content_basepath
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -
                  -

                  El tipo form

                  -

                  El paquete define un tipo form que puedes utilizar para la clásica casilla de verificación «aceptar términos» donde colocas las url en la etiqueta. Simplemente especifica symfony_cmf_routing_extra_terms_form_type como el nombre del tipo form y especifica una etiqueta y un arreglo con content_ids en las opciones

                  -
                  $form->add('terms', 'symfony_cmf_routing_extra_terms_form_type', array(
-    'label' => 'I have seen the <a href="%team%">Team</a> and <a href="%more%">More</a> pages ...',
-    'content_ids' => array('%team%' => '/cms/content/static/team', '%more%' => '/cms/content/static/more')
-));
-
                  -
                  -

                  El tipo form automáticamente genera las rutas para el contenido especificado y pasa las rutas al ayudante trans de Twig para sustituirlas en la etiqueta.

                  -
                  -
                  -

                  Notas adicionales

                  -

                  Ve la documentación del componente enrutador del CMF para información sobre la RouteObjectInterface, redirecciones y regiones.

                  -

                  Notas:

                  -
                    -
                  • RouteObjectInterface: Los documentos proporcionados implementan esta interfaz para asociar contenido a rutas y (opcionalmente) proporcionan un nombre de ruta personalizado en vez del nombre de ruta compatible con el núcleo de Symfony.
                    • -
                  • Redirecciones: Este paquete proporciona un RedirectController.
                    • -
                  -

                  Pendiente: Ve DependencyInjection/Configuration.php de este paquete. No podría representar cómo poner esta asociación como la asignación predefinida. Entretanto, para hacer redirecciones, necesitas añadir una entrada a tu asociación en la configuración de tu proyecto:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    controllers_by_class:
-        Symfony\Cmf\Component\Routing\RedirectRouteInterface:  symfony_cmf_routing_extra.redirect_controller:redirectAction
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Personalizando

                  -

                  Puedes añadir más implementaciones ControllerMapperInterface si tienes un caso no manejado por las proporcionadas.

                  -

                  Si usas un ODM/ORM diferente a PHPCR-ODM, probablemente necesites especificar la clase para la entidad ruta (en PHPCR-ODM, la clase es detectada automáticamente). Para necesidades más específicas, dale una mirada al DynamicRouter y ve si lo quieres extender. También puedes escribir tus propios enrutadores para engancharlos a la cadena.

                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  MenuBundle

                  -

                  Próximo tema

                  -

                  SearchBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/search.html b/cmf/html/bundles/search.html deleted file mode 100644 index 428bef1..0000000 --- a/cmf/html/bundles/search.html +++ /dev/null @@ -1,144 +0,0 @@ - - - - - - - - - - SearchBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  SearchBundle

                  -

                  El SearchBundle proporciona integración con LiipSearchBundle para manejar la búsqueda en un sitio grande.

                  -
                  -

                  Dependencias

                  - -
                  -
                  -

                  Configurando

                  -

                  La clave de configuración para este paquete es symfony_cmf_search

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_search:
-    document_manager_name:  default
-    translation_strategy: child # además se puede configurar como una cadena vacía o atributo
-    translation_strategy: attribute
-    search_path: /cms/content
-    search_fields:
-        title: title
-        summary: body
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  RoutingExtraBundle

                  -

                  Próximo tema

                  -

                  SimpleCmsBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/simple-cms.html b/cmf/html/bundles/simple-cms.html deleted file mode 100644 index 058b044..0000000 --- a/cmf/html/bundles/simple-cms.html +++ /dev/null @@ -1,211 +0,0 @@ - - - - - - - - - - SimpleCmsBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  SimpleCmsBundle

                  -

                  El SimpleCmsBundle proporciona un CMS simplista sobre los componentes y paquetes del CMF.

                  -

                  Si bien los componentes del núcleo del CMF se enfocan en la flexibilidad, el simple CMS especula con alguna de esa flexibilidad a favor de la simplicidad.

                  -
                  -

                  Dependencias

                  -

                  Tal como se especifica en el archivo composer.json este paquete depende de muchos de los paquetes del CMF.

                  -
                  -
                  -

                  Configurando

                  -

                  La clave de configuración para este paquete es symfony_cmf_simple_cms.

                  -

                  La opción use_menu automáticamente habilita un servicio para proporcionar los menús del simple CMS si MenuBundle está habilitado. También lo puedes desactivar explícitamente si tienes el paquete menu pero no quieres utilizar el servicio predefinido, o habilitarlo explícitamente para conseguir un error si el paquete menu se vuelve inasequible.

                  -

                  En la sección de enrutado está establecido cual plantilla o controlador utilizar para una clase de contenido. Esta reutiliza lo que hace el enrutado extra, por favor, ve la sección correspondiente en configurando el enrutado. También explica el generic_controller.

                  -

                  Ve la sección para soporte multiidioma más adelante.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_simple_cms:
-    use_menu:             auto # usa true/false para forzar provisión / no provisión de un menú
-    use_sonata_admin:     auto # usa true/false para forzar el uso / no uso de la administración de sonata
-    document_class:       Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page
-    # controlador a usar para dibujar documentos únicamente con plantilla personalizada
-    generic_controller:   symfony_cmf_content.controller:indexAction
-    # dónde almacenar las páginas en el árbol PHPCR
-    basepath:             /cms/simple
-    routing:
-        content_repository_id:  symfony_cmf_routing_extra.content_repository
-        controllers_by_class:
-            # ...
-        templates_by_class:
-            # ...
-    multilang:
-        locales:              []
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Si tienes habilitada la administración PHPCR-ODM de Sonata pero NO quieres mostrar la administración predefinida proporcionada por este paquete, puedes añadir lo siguiente a tu configuración:

                  -
                  -
                    -
                  • YAML
                    symfony_cmf_simple_cms:
-    use_sonata_admin: false
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Soporte multiidioma

                  -

                  El modo multi-language-mode se habilita proporcionando la lista de regiones permitidas en el campo multilang > locales.

                  -

                  En multi-language-mode el paquete automáticamente utilizará Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangPage como la document_class a no ser que explícitamente esté configurada una clase diferente.

                  -

                  Esta clase de manera predeterminada prefijará todas las rutas con /{_locale}. Este comportamiento se puede desactivar poniendo a false el segundo parámetro en el constructor del modelo.

                  -

                  Además, la capa de enrutado será configurada para utilizar Symfony\Cmf\Bundle\SimpleCmsBundle\Document\MultilangRouteRepository la cuál garantizará que incluso con el prefijo locale el nodo de contenido correcto será encontrado. Además, automáticamente añade un _locale el requisito enumerando las regiones actualmente disponibles para la ruta emparejada.

                  -
                  -

                  Nota

                  -

                  Debido a que SimpleCmsBundle sólo proporciona una sencilla estructura de árbol, todos los nodos tendrán el mismo nombre de nodo para todos los idiomas. Así que una url http://foo.com/en/bar para contenido en inglés se vería cómo http://foo.com/de/bar para contenido en alemán. A veces puede ser más factible utilizar enteros como nombres de nodo y sencillamente anexarlos al título del nodo en la región dada como una ancla. Así por ejemplo http://foo.com/de/1#my title y http://foo.com/de/1#mein title. -Si necesitas las URL específicas al idioma, quieres usar el enrutado del paquete CMF y el paquete de contenido directamente para tener un documento de ruta separado por idioma.

                  -
                  -
                  -
                  -

                  Reproduciendo

                  -

                  Puedes especificar la plantilla para reproducir una página del SimpleCms, o utilizar un controlador donde luego proporciones el documento de página a la plantilla. Un sencillo ejemplo para tal plantilla es este:

                  -
                  {% block content %}
-
-    <h1>{{ page.title }}</h1>
-
-    <div>{{ page.body|raw }}</div>
-
-    <ul>
-    {% foreach tag in page.tags %}
-        <li>{{ tag }}</li>
-    {% endforeach %}
-    </ul>
-
-{% endblock %}
-
                  -
                  -

                  Si tienes habilitado el CreateBundle, también puedes producir el documento con anotaciones RDF, permitiéndote editar el contenido así como las etiquetas en la interfaz de usuario. La forma más sencilla es el siguiente bloque de Twig:

                  -
                  {% block content %}
-
-    {% createphp page as="rdf" %}
-        {{ rdf|raw }}
-    {% endcreatephp %}
-
-{% endblock %}
-
                  -
                  -

                  Si quieres un control más detallado se tendría que mostrar con RDF, ve el capítulo CreateBundle.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  SearchBundle

                  -

                  Próximo tema

                  -

                  SonataDoctrinePhpcrAdminBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/tree-browser.html b/cmf/html/bundles/tree-browser.html deleted file mode 100644 index 1cfe578..0000000 --- a/cmf/html/bundles/tree-browser.html +++ /dev/null @@ -1,198 +0,0 @@ - - - - - - - - - - TreeBrowserBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  TreeBrowserBundle

                  -

                  El TreeBrowserBundle -proporciona integración con TreeBundle para proporcionar un árbol de navegación en lo alto de un repositorio PHPCR.

                  -

                  Este paquete consta de dos partes:

                  -
                  -
                    -
                  • Árbol de navegación genérico con una TreeInterface
                    • -
                  • Implementación del árbol PHPCR e IGU para un navegador PHPCR
                    • -
                  -
                  -
                  -

                  Dependencias

                  - -
                  -
                  -

                  Configurando

                  -

                  La clave de configuración para este paquete es symfony_cmf_tree_browser

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_tree_browser:
-    session:  default
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Usando

                  -

                  Tienes select.js e init.js los cuáles son una envoltura para construir un árbol jQuery. Úsalos con SelectTree.initTree resp. AdminTree.initTree

                  -
                  -
                    -
                  • SelectTree en select.js es un árbol para seleccionar un nodo para poner su ID a un campo
                    • -
                  • AdminTree en init.js es para crear un árbol, mover y editar nodos
                    • -
                  -
                  -

                  Ambos tienen las siguientes opciones al crearlos:

                  -
                  -
                    -
                  • config.rootNode: id para el nodo raíz de tu árbol, predefinido a “/”
                    • -
                  • config.path.expanded: ruta de árbol donde el árbol se tendría que expandir al momento
                    • -
                  • config.path.preloaded: ruta del árbol hacia qué nodo se tendría que precargar para una experiencia de usuario más rápida
                    • -
                  • config.ajax.children_url: URL al controlador que proporciona los hijos de un nodo
                    • -
                  • config.selector: Selector jQuery dónde enganchar en el árbol js
                    • -
                  -
                  -
                  -

                  Solo select.js

                  -
                  -
                    -
                  • config.output: Dónde escribir el Id del nodo seleccionado
                    • -
                  -
                  -
                  -
                  -

                  Solo init.js

                  -
                  -
                    -
                  • config.ajax.move_url: URL al controlador que maneja la operación de movimiento
                    • -
                  • config.doctypes: arreglo para manejar la creación de nuevos nodos
                    • -
                  • config.routecollection: arreglo indexado con el atributo className de los nodos más .routes.edit y .routes.delete asociadas a rutas para las operaciones de edición y remoción.
                    • -
                  -
                  -
                  -
                  -
                  -

                  Ejemplos

                  -

                  Ve en las plantillas del paquete de administración de Sonata los ejemplos sobre cómo construir el árbol:

                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  TreeBundle

                  -

                  Próximo tema

                  -

                  Usando una clase documento personalizada asociada con PHPCR-ODM

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/bundles/tree.html b/cmf/html/bundles/tree.html deleted file mode 100644 index cdb91d0..0000000 --- a/cmf/html/bundles/tree.html +++ /dev/null @@ -1,238 +0,0 @@ - - - - - - - - - - TreeBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  TreeBundle

                  -

                  El TreeBundle proporciona integración con el árbol jQuery.

                  -
                  -

                  Dependencias

                  - -
                  -
                  -

                  Configurando

                  -

                  No hay ninguna configuración para este paquete.

                  -
                  -
                  -

                  Características

                  -
                  -
                    -
                  • Expandiendo/colapsando nodos.
                    • -
                  • Cargando subárboles relajadamente vía respuestas JSON para llamadas AJAX.
                    • -
                  • Función retrollamada al conmutar un nodo.
                    • -
                  -
                  -
                  -
                  -

                  Usando

                  -
                  -
                    -
                  • Incluye archivos CSS y JS en tu plantilla.
                    • -
                  • Llama a $("#tree").jstree({/* parámetros */}) — suponiendo que aquí #tree es el selector de tu lista.
                    • -
                  • Proporciona el valor url que apunta a alguna cosa de lado del servidor regresando listas de nodos hijo para cualquier ID de nodo dado.
                    • -
                  -
                  -

                  El servidor tiene que responder en formato JSON, este es un ejemplo:

                  -
                  [
-    {"data":"root","attr":{"id":"root","rel":"folder"},"state":"closed","children":
-        [
-            {"data":"content","attr":{"id":"child1","rel":"folder"},"state":"closed"},
-            {"data":"menu","attr":{"id":"child2","rel":"folder"},"state":"closed"},
-            {"data":"routes","attr":{"id":"child3","rel":"folder"},"state":"closed"}
-        ]
-    }
-]
-
                  -
                  -

                  Disponemos de más información sobre la configuración en el sitio web de jsTree.

                  -
                  -
                  -

                  Ejemplo HTML

                  -
                      <html>
-        <head>
-        <title>CMF Sandbox - Treeview test</title>
-
-        <link href="/bundles/symfonycmftree/css/jquery.treeview.css" media="screen" type="text/css" rel="stylesheet" />
-
-        <script src="/bundles/sonatajquery/jquery-1.7.1.js" type="text/javascript"></script>
-
-        <script src="{{ asset('bundles/symfonycmftree/js/jstree/jquery.jstree.js') }}" type="text/javascript"></script>
-
-        <script type="text/javascript">
-            function initTrees() {
-
-                jQuery("#tree").jstree({
-                    "plugins" :     [ "themes", "types", "ui", "json_data" ],
-                    "json_data": {
-                        "ajax": {
-                            url:    "subtree.php",
-                            data:   function (node) {
-                                return { 'root' : jQuery(node).attr('id') };
-                            }
-                        }
-                    },
-                    "types": {
-                        "max_depth":        -2,
-                        "max_children":     -2,
-                        "valid_children":  [ "folder" ],
-                        "types": {
-                            "default": {
-                                "valid_children": "none",
-                                "icon": {
-                                    "image": "/images/document.png"
-                                }
-                            },
-                            "folder": {
-                                "valid_children": [ "default", "folder" ],
-                                "icon": {
-                                    "image": "/images/folder.png"
-                                }
-                            }
-                        }
-                    }
-                })
-                .bind("select_node.jstree", function (event, data) {
-                    window.location = "edit.php?id=" + data.rslt.obj.attr("id");
-                })
-                .delegate("a", "click", function (event, data) { event.preventDefault(); });
-            }
-            $(document).ready(function(){
-                initTrees();
-
-            });
-        </script>
-
-        </head>
-        <body>
-
-        <ul id="tree">
-        </ul>
-
-        <table border="1" id="properties"></table>
-
-        <hr/>
-
-        {% block content %}
-            Hello {{ name }}!
-        {% endblock %}
-    </body>
-</html>
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  SonataDoctrinePhpcrAdminBundle

                  -

                  Próximo tema

                  -

                  TreeBrowserBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/components/routing.html b/cmf/html/components/routing.html deleted file mode 100644 index a173a4c..0000000 --- a/cmf/html/components/routing.html +++ /dev/null @@ -1,257 +0,0 @@ - - - - - - - - - - El componente Routing — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Routing

                  -

                  La biblioteca del componente Routing del CMF de Symfony extiende el componente routing del núcleo de Symfony2. Incluso, aunque este tiene Symfony en su nombre, no necesita la plataforma Symfony2 completa y se puede utilizar en proyectos independientes. Para integración con Symfony proporcionamos RoutingExtraBundle.

                  -

                  En el núcleo del CMF de Symfony el componente de enrutado es el ChainRouter, que se utiliza en vez del sistema de enrutamiento predeterminado de Symfony2. El ChainRouter puede encadenar varias implementaciones de RouterInterface, una tras otra, para determinar cuál tendría que manejar cada petición. Puedes añadir a esta cadena el enrutador predeterminado de Symfony2, por lo tanto aún puedes utilizar el mecanismo de enrutado estándar.

                  -

                  Además, este componente se pretende que proporcione útiles implementaciones de la RouterInterface. Actualmente, proporciona DynamicRouter que es capaz de recuperar dinámicamente un objeto Ruta de Symfony2 desde un repositorio. El repositorio se puede implementar utilizando una base de datos, por ejemplo con el PHPCR-ODM de Doctrine o el ORM de Doctrine.

                  -
                  -

                  Nota

                  -

                  Para usar este componente fuera del contexto de la plataforma Symfony2, tienes que darle un vistazo al componente Routing del núcleo de Symfony2 para conseguir un entendimiento fundamental del componente. El enrutador del CMF justo extiende el comportamiento básico.

                  -
                  -
                  -

                  Dependencias

                  -

                  Este componente usa composer. Necesita los componentes Routing y HttpKernel de Symfony2 (para la interfaz del registro cronológico e iniciar la memoria caché).

                  -

                  Para el DynamicRouter necesitarás algo para implementar la RouteRepositoryInterface. Te sugerimos utilizar Doctrine puesto que te permite asociar cualquier clase a una base de datos.

                  -
                  -
                  -

                  ChainRouter

                  -

                  En el núcleo del CMF de Symfony el componente de enrutado es el ChainRouter. -Este se utiliza en vez del sistema de enrutado predeterminado de Symfony2, y es el responsable de determinar cuál controlador manejará cada petición.

                  -

                  El ChainRouter trabaja aceptando un conjunto priorizado de implementaciones de estrategias de enrutado, RouterInterface, generalmente referidas como «Enrutadores».

                  -

                  Al manejar una petición entrante, itera sobre los enrutadores configurados, por su prioridad establecida, hasta que uno de ellos es capaz de emparejar -la petición y asignarla a un determinado Controlador.

                  -
                  -
                  -

                  Enrutadores

                  -

                  El ChainRouter es incapaz —por sí mismo— de hacer ningún encaminamiento real. -Su única responsabilidad es gestionar el conjunto de Enrutadores dado, los cuales son los verdaderos responsables de emparejar una Petición a un Controlador.

                  -

                  Fácilmente puedes crear tus propios Enrutadores implementando la RouterInterface pero, por omisión, el CMF de Symfony ya incluye algunos mecanismos de encaminamiento básicos para ayudarte a empezar.

                  -
                  -

                  Nota

                  -

                  Si estás utilizando este como parte de un proyecto completo con el CMF de Symfony, por favor, revisa el RoutingExtraBundle para instrucciones sobre cómo añadir Enrutadores al ChainRouter. De lo contrario, usa el método add del ChainRouter para configurar nuevos Enrutadores.

                  -
                  -
                  -

                  Enrutador predefinido de Symfony2

                  -

                  El mecanismo de enrutado de Symfony2 en sí mismo es una implementación de RouterInterface, lo cual significa que lo puedes utilizar como Enrutador en el ChainRouter. Esto te permite utilizar las declaraciones del sistema de enrutado predefinido.

                  -
                  -
                  -

                  Enrutador dinámico

                  -

                  El DynamicRouter es capaz de cargar dinámicamente objetos Ruta desde una fuente determinada de datos proporcionada al Enrutador tal como una implementación de RouteRepositoryInterface. A pesar de que lo puedes utilizar de otras maneras, el principal objetivo de la RouteRepositoryInterface es facilitar eficientemente la implementación del PHPCR en lo alto del ODM de Doctrine, permitiéndote almacenar y gestionar rutas dinámicamente desde una base de datos.

                  -
                  -

                  Procesando la petición

                  -

                  La petición entrante es manejada por el método match del DynamicRouter usando el siguiente flujo de trabajo:

                  -
                    -
                  • El DynamicRouter utiliza la RouteRepositoryInterface para recuperar un conjunto de instancias Ruta
                    • -
                  • Luego utiliza el UrlMatcher en conjunto devuelto para encontrar una sola Ruta coincidente
                    • -
                  • Aplica un conjunto opcional de RouteEnhancers a la Ruta
                    • -
                  -
                  -
                  La recuperación
                  -

                  Basado en la URL solicitada, el DynamicRouter recuperará un conjunto ordenado de objetos Ruta desde la RouteRepositoryInterface.

                  -

                  La implementación subyacente de la interfaz RouteRepositoryInterface no es parte del alcance de este paquete. Consulta la declaración de interfaz para más información. Para un ejemplo funcional, ve el RoutingExtraBundle.

                  -
                  -
                  -
                  La igualación
                  -

                  El DynamicRouter usa el método UrlMatcher del componente Routing de Symfony al iterar sobre los objetos Ruta recuperados, para determinar cuál de ellos utilizar.

                  -
                  -
                  -
                  Los potenciadores
                  -

                  Opcionalmente, puedes declarar un conjunto de instancias de la RouteEnhancerInterface y asociarlas al DynamicRouter. El objetivo de esto es permitirte manipular la Ruta y sus parámetros asociados. Estos se pueden utilizar, por ejemplo, para asignar dinámicamente un controlador o una plantilla a una Ruta. Algunos sencillos potenciadores ya vienen integrados con el paquete, puedes encontrar la documentación dentro de cada archivo de clase.

                  -
                  -
                  -
                  -

                  Enlazando una Ruta con un Contenido

                  -

                  Dependiendo de la lógica de tu aplicación, una URL solicitada puede tener asociado contenido desde la base de datos. Estas Rutas deberían implementar la RouteObjectInterface, y opcionalmente pueden regresar una instancia del modelo, la cual será vinculada al arreglo devuelto, en la clave _content. Ten en cuenta que una Ruta puede implementar la interfaz mencionada anteriormente pero todavía no regresar ninguna instancia del modelo, en cuyo caso ningún objeto asociado será regresado.

                  -

                  Además, los enrutadores que implementen esta interfaz también pueden proporcionar un nombre de ruta personalizado. La clave devuelta por getRouteKey será utilizada como el nombre de ruta en vez del nombre de ruta compatible con el núcleo de Symfony y puede contener cualquiera de los caracteres del juego de caracteres actual. Esto te permite, por ejemplo, poner una ruta como el nombre de la ruta.

                  -

                  Todos los enrutadores todavía necesitan extender la clase base Symfony\Component\Routing\Route.

                  -
                  -
                  -

                  Redirecciones

                  -

                  Puedes construir redirecciones implementando la RedirectRouteInterface. -Esta bien puede redirigir a una URI absoluta, a una Ruta nombrada que puede -generar cualquier Enrutador en la cadena o a otro objeto Ruta en el repositorio.

                  -

                  Ten en cuenta que la redirección lógica real no es manejada por el paquete. Deberías implementar tu propia lógica para manejar la redirección real. Para un ejemplo implementando esta redirección bajo la pila completa de Symfony2, consulta el RoutingExtraBundle.

                  -
                  -
                  -

                  Rutas e idiomas

                  -

                  Puedes utilizar el valor predefinido de _locale en una Ruta para crear una Ruta por región, todas refiriendose a la misma instancia del modelo multilingüe. El DynamicRouter respeta el valor de _locale al generar rutas de instancias del modelo. Al resolver la ruta, el _locale se obtiene desde la petición y es recogido por el sistema regional de Symfony2.

                  -
                  -

                  Nota

                  -

                  Bajo PHPCR-ODM, las rutas nunca deberían ser documentos traducibles, puesto que un documento de Ruta representa una URL única, y no es recomendable servir varias traducciones bajo la misma URL.

                  -
                  -
                  -
                  -

                  Generando URL

                  -

                  DynamicRouter usa el UrlGenerator predefinido de Symfony2 para manejar la generación de URL. Puedes generar URL para tu contenido en tres distintas maneras:

                  -
                    -
                  • Ya sea pasando una implementación de RouteObjectInterface como el parámetro route
                    • -
                  • O pasando un ejemplar del modelo como el parámetro content
                    • -
                  • O supliendo una implementación de ContentRepositoryInterface y el id del ejemplar del modelo como el parámetro content_id
                    • -
                  -
                  -
                  -
                  -
                  -

                  Personalizando

                  -

                  Los paquetes de enrutado permiten varias opciones de personalización, dependiendo de tus necesidades específicas:

                  -
                    -
                  • Tus parámetros de Ruta se pueden manipular fácilmente utilizando los potenciadores existentes
                    • -
                  • También puedes añadir tu propio potenciador a la lógica del Enrutador.
                    • -
                  • El DynamicRouter o sus componentes se pueden extender para permitir modificaciones
                    • -
                  • Puedes implementar tus propios Enrutadores y añadirlos al ChainRouter
                    • -
                  -
                  -

                  Nota

                  -

                  Si sientes que tu potenciador o Enrutador específico le puede ser útil a otros, contáctanos e intentaremos incluirlo en el paquete.

                  -
                  -
                  -
                  -

                  Integrando con Symfony2

                  -

                  Tal como mencioné antes, este paquete fue diseñado para sólo requerir ciertas partes de Symfony2. Aun así, si deseas utilizarlo como parte de tu proyecto CMF de Symfony, también hay disponible un paquete de integración. Te recomendamos que le eches un vistazo en RoutingExtraBundle.

                  -
                  -
                  -

                  Autores

                  -
                    -
                  • Filippo De Santis (p16)
                    • -
                  • Henrik Bjornskov (henrikbjorn)
                    • -
                  • Claudio Beatrice (omissis)
                    • -
                  • Lukas Kahwe Smith (lsmith77)
                    • -
                  • David Buchmann (dbu)
                    • -
                  • Y otros
                    • -
                  -

                  El código original para la cadena de enrutadores fue aportado por Magnus Nordlander.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Instalando el recinto de seguridad del CMF

                  -

                  Próximo tema

                  -

                  Colaborando

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/contributing/code.html b/cmf/html/contributing/code.html deleted file mode 100644 index d803301..0000000 --- a/cmf/html/contributing/code.html +++ /dev/null @@ -1,129 +0,0 @@ - - - - - - - - - - Colaborando — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Colaborando

                  -

                  El equipo del CMF de Symfony2 sigue todas las reglas y directrices del proceso de desarrollo que el núcleo de Symfony2.

                  - -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  El componente Routing

                  -

                  Próximo tema

                  -

                  Licencia

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/contributing/license.html b/cmf/html/contributing/license.html deleted file mode 100644 index bbe1d0a..0000000 --- a/cmf/html/contributing/license.html +++ /dev/null @@ -1,154 +0,0 @@ - - - - - - - - - - Licencia — Symblog - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Licencia

                  -

                  El objetivo del CMF de Symfony2 es proporcionar licencias de código abierto liberales para su pila completa.

                  -
                  -

                  Código

                  -

                  La pila del código está cubierta por la licencia de Apache para Jackalope y PHPCR, el resto de la pila, notablemente el código Symfony2, PHPCR-ODM, create.js y Hallo.js está licenciado bajo MIT. Por favor, refiérete a los archivos de LICENCIA pertinentes en la fuente de los paquetes dados.

                  -
                  -
                  -

                  Documentación

                  -

                  La documentación de Symfony2 está bajo una licencia Creative Commons Attribution-Share Alike 3.0 Unported License.

                  -

                  Estás en libertad:

                  -
                    -
                  • para Compartir — copiar, distribuir y trasmitir públicamente la obra;
                    • -
                  • para Derivar — adaptando la obra.
                    • -
                  -

                  Bajo las siguientes condiciones:

                  -
                    -
                  • Atribución — Debes atribuir el trabajo de la manera especificada por -el autor o licenciador (pero de ninguna manera que sugiera que apoya tu -uso de la obra).
                    • -
                  • Compartir bajo la misma licencia — Si alteras, transformas, o creas -sobre esta obra, sólo podrás distribuir la obra resultante bajo una -licencia idéntica o similar a esta.
                    • -
                  -

                  En el entendido de:

                  -
                    -

                  • Renuncia — Cualquiera de estas condiciones puede no aplicarse si -obtienes el permiso del titular de los derechos de autor;

                    -
                    • -

                  • Dominio Público — Cuando la obra o cualquiera de sus elementos es del -dominio público bajo la legislación aplicable, este estatus de ninguna -manera es afectado por la licencia;

                    -
                    • -

                  • Otros Derechos — De ninguna manera cualquiera de los siguientes derechos -se ve afectado por la licencia:

                    -
                    -
                      -
                    • Tu derecho leal o uso justo, u otros derechos de autor excepciones y limitaciones aplicables;
                      • -
                    • Los derechos morales del autor;
                      • -
                    • Otras personas pueden tener derechos ya sea en la propia obra o en la forma en que se utiliza la obra, como los derechos de publicidad o privacidad.
                      • -
                    -
                    -
                    • -

                  • Atención — Para cualquier reutilización o distribución, debes dejar -claros los términos de la licencia de esta obra. La mejor manera de hacerlo es con un enlace a esta página web.

                    -
                    • -
                  -

                  Este es un resumen humanamente legible del Texto legal (Licencia completa).

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Colaborando

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/cookbook/installing-cmf-sandbox.html b/cmf/html/cookbook/installing-cmf-sandbox.html deleted file mode 100644 index ac74a40..0000000 --- a/cmf/html/cookbook/installing-cmf-sandbox.html +++ /dev/null @@ -1,324 +0,0 @@ - - - - - - - - - - Instalando el recinto de seguridad del CMF — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando el recinto de seguridad del CMF

                  -

                  Esta guía muestra cómo instalar el recinto de seguridad del CMF de Symfony, una demostración de la plataforma dirigida a exhibir las características básicas de la herramienta corriendo en un entorno demo. -La puedes usar para evaluar la plataforma o para ver código real en acción, ayudándote a entender la herramienta.

                  -

                  Si bien lo puedes utilizar tal cual, este recinto de seguridad no pretende ser una plataforma de desarrollo. Si estás buscando instrucciones de instalación para una configuración de desarrollo, por favor revisa:

                  - -
                  -

                  Requisitos previos

                  -

                  Debido a que el CMF de Symfony está basado en Symfony2, deberías asegurarte de que cubres los Requisitos para que funcione Symfony2. -Git 1.6+, Curl y PHP Intl también son necesarios para seguir los pasos de instalación enumerados más adelante.

                  -

                  Si deseas utilizar Jackalope + Apache JackRabbit como el medio de almacenamiento (recomendable), -también necesitas el Java (JRE). Para otros mecanismos y sus requisitos, por favor refiérete a sus respectivas secciones.

                  -
                  -
                  -

                  Instalando

                  -
                  -

                  Apache Jackrabbit

                  -

                  El recinto de seguridad del CMF de Symfony de manera predeterminada usa Jackalope con Apache JackRabbit. -Puedes configurar métodos de almacenamiento alternativo, pero este es el más probado, y debería ser el más fácil de configurar.

                  -

                  Puedes conseguir la más reciente versión de Apache Jackrabbit en la página de descarga oficial del proyecto. -Para lanzarlo, usa la siguiente orden:

                  -
                  java -jar jackrabbit-standalone-*.jar
-
                  -
                  -

                  De manera predefinida el servidor escucha en el puerto 8080, puedes cambiar esto especificando el puerto en la línea de ordenes.

                  -
                  java -jar jackrabbit-standalone-*.jar --port 8888
-
                  -
                  -

                  Para sistemas unix, puedes conseguir el guión de arranque/detención para el archivo /etc/init.d aquí

                  -
                  -
                  -

                  Consiguiendo el código del recinto de seguridad

                  -

                  El código fuente del recinto de seguridad del CMF de Symfony está disponible en github. Para conseguirlo usa:

                  -
                  git clone git://github.com/symfony-cmf/cmf-sandbox.git
-
                  -
                  -

                  Ve al directorio y copia los archivos de configuración predefinidos:

                  -
                  cd cmf-sandbox
-cp app/config/parameters.yml.dist app/config/parameters.yml
-cp app/config/phpcr_jackrabbit.yml.dist app/config/phpcr.yml
-
                  -
                  -

                  Estos dos archivos incluyen los parámetros de configuración predefinidos para el mecanismo de almacenamiento del recinto de seguridad. Los puedes modificar para cubrir mejor tus necesidades.

                  -
                  -

                  Nota

                  -

                  El segundo archivo de configuración se refiere específicamente a la configuración de jackalope + jackrabbit. Hay otros archivos disponibles para diferentes pilas de configuración.

                  -
                  -

                  Luego, consigue composer e instala los paquetes necesarios (esto puede tomar un rato).

                  -
                  curl -s http://getcomposer.org/installer | php --
-php composer.phar install
-
                  -
                  -
                  -

                  Nota

                  -

                  En Windows necesitas ejecutar el intérprete de ordenes como administrador o editar el archivo composer.json`y cambiar la línea `“symfony-assets-install”: “symlink”`` a "symfony-assets-install": "". Si fallas al hacerlo podrías recibir:

                  -
                  -
                  [Symfony\Component\Filesystem\Exception\IOException]
-Imposible crear el enlace simbólico debido al error código 1314: 'El cliente no cuenta con un privilegio requerido'. ¿Tienes el privilegio de administrador requerido?
-
                  -
                  -
                  -
                  -

                  Preparando el repositorio PHPCR

                  -

                  Ahora que tienes todo el código, necesitas configurar tu repositorio PHPRC. -PHPRC organiza los datos en espacios de trabajo, y el recinto de seguridad utiliza el espacio de trabajo «default», el cual existe por omisión en Jackrabbit. Si utilizas otras aplicaciones que requieren Jackrabbit, o si solo deseas cambiar el nombre del espacio de trabajo, lo puedes hacer en el archivo app/config/phpcr.yml. La siguiente orden creará un nuevo espacio de trabajo llamado «sandbox» en Jackrabbit. Si decides utilizar el espacio de trabajo «default», la puedes omitir.

                  -
                  app/console doctrine:phpcr:workspace:create sandbox
-
                  -
                  -

                  Una vez configurado tu espacio de trabajo, debes registrar los tipos de nodo para el phpcr-odm:

                  -
                  app/console doctrine:phpcr:register-system-node-types
-
                  -
                  -
                  -
                  -

                  Importando accesorios

                  -

                  La interfaz de administración sigue en una etapa temprana. Hasta que mejore, lo más fácil es crear los datos programáticamente. La mejor manera de hacerlo es con los accesorios de Doctrine. El DoctrinePHPCRBundle incluido en el repositorio symfony-cmf proporciona una orden para cargar accesorios.

                  -
                  app/console -v doctrine:phpcr:fixtures:load
-
                  -
                  -

                  Ejecuta esta orden para cargar los accesorios desde el MainBundle del recinto de seguridad, la cual poblará tu repositorio con datos maniquí, es decir, carga las páginas demo.

                  -
                  -
                  -

                  Accediendo a tu recinto de seguridad

                  -

                  El recinto de seguridad ahora debería ser accesible en tu servidor web.

                  -
                  http://localhost/app_dev.php
-
                  -
                  -

                  Para ejecutar el recinto de seguridad en modo de producción necesitas generar los delegados de Doctrine y volcar los activos de assetic:

                  -
                  app/console cache:warmup --env=prod --no-debug
-app/console assetic:dump --env=prod --no-debug
-
                  -
                  -
                  -
                  -
                  -

                  Mecanismos de almacenamiento alternativo

                  -

                  El CMF de Symfony y el recinto de seguridad son de almacenamiento agnóstico, lo cual significa que puedes cambiar el mecanismo de almacenamiento sin tener que cambiar tu código. El mecanismo de almacenamiento predefinido para el recinto de seguridad es Jackalope + Apache Jackrabbit, puesto que es la configuración más probada y estable. Sin embargo, hay otras alternativas disponibles.

                  -
                  -

                  Jackalope + DBAL de Doctrine

                  -
                  -

                  Nota

                  -

                  De manera predeterminada, cuándo utilizas el DBAL de Doctrine, los datos se almacenan utilizando una base de datos Sqlite. -Revisa la página del proyecto para instrucciones de instalación. -Si deseas utilizar otros sistemas de base de datos, cambia los parámetros de configuración en el archivo app/config/parameters.yml. Consulta la página sobre la configuración del DBAL de Doctrine en Symfony o la documentación de Doctrine para más información.

                  -
                  -

                  Ve al directorio del recinto de seguridad y copia el archivo de configuración predefinido para -configurar el DBAL de Doctrine:

                  -
                  cd cmf-sandbox
-cp app/config/phpcr_doctrine_dbal.yml.dist app/config/phpcr.yml
-
                  -
                  -

                  Luego, debes instalar el paquete DBAL de Doctrine real requerido por jackalope:

                  -
                  php composer.phar require jackalope/jackalope-doctrine-dbal:dev-master
-
                  -
                  -

                  Y crea e inicia tu base de datos:

                  -
                  app/console doctrine:database:create
-app/console doctrine:phpcr:init:dbal
-
                  -
                  -

                  Después de esto, deberías seguir los pasos en Preparando el repositorio PHPCR.

                  -
                  -

                  Memorizando en caché con Doctrine

                  -

                  Opcionalmente, para mejorar el rendimiento y habilitar los metadatos, puedes instalar LiipDoctrineCacheBundle -escribiendo la siguiente orden:

                  -
                  php composer.phar require liip/doctrine-cache-bundle:dev-master
-
                  -
                  -

                  Y añade la siguiente entrada a tu archivo app/AppKernel.php:

                  -
                  // app/AppKernel.php
-public function registerBundles()
-{
-  $bundles = array(
-      // ...
-      new Liip\DoctrineCacheBundle\LiipDoctrineCacheBundle(),
-      // ...
-  );
-}
-
                  -
                  -

                  Finalmente descomenta las opciones de caché en el archivo phpcr.yml así como las de liip_doctrine_cache en el archivo config.yml.

                  -
                  # app/config/phpcr.yml
-caches:
-    meta: liip_doctrine_cache.ns.meta
-    nodes: liip_doctrine_cache.ns.nodes
-
                  -
                  -
                  # app/config/config.yml
-
-# memorización con jackalope en doctrine
-liip_doctrine_cache:
-    namespaces:
-        meta:
-            type: file_system
-        nodes:
-            type: file_system
-
                  -
                  -
                  -
                  -
                  -

                  Proveyendo PHPCR para Midgard2

                  -

                  Si quieres correr el recinto de seguridad del CMF con el proveedor PHPCR de Midgard2 en vez de Jackrabbit, necesitas instalar la extensión midgard2 de PHP. -En sistemas Debian/Ubuntu actuales, esto se hace simplemente con:

                  -
                  sudo apt-get install php5-midgard2
-
                  -
                  -

                  En OS X lo puedes instalar utilizando cualquier Homebrew con:

                  -
                  brew install midgard2-php
-
                  -
                  -

                  o MacPorts con

                  -
                  sudo port install php5-midgard2
-
                  -
                  -

                  También necesitas descargar los archivos de esquema midgard_tree_node.xml y midgard_namespace_registry.xml, y colocarlos en «<tu-directorio-midgard2>/schema» (por omisión en «/usr/share/midgard2/schema»).

                  -

                  Para instalar la implementación del phpcr de midgard ejecuta la siguiente orden adicional:

                  -
                  php composer.phar require midgard/phpcr:dev-master
-
                  -
                  -

                  Finalmente, cambia uno de los archivos de configuración de Midgard2:

                  -
                  cp app/config/phpcr_midgard_mysql.yml.dist app/config/phpcr.yml
-
                  -
                  -

                  o

                  -
                  cp app/config/phpcr_midgard_sqlite.yml.dist app/config/phpcr.yml
-
                  -
                  -

                  Después de esto, deberías seguir los pasos en Preparando el repositorio PHPCR para continuar el proceso de instalación.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Usando un repositorio de rutas personalizado con un enrutador dinámico

                  -

                  Próximo tema

                  -

                  El componente Routing

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/cookbook/phpcr-odm-custom-documentclass-mapper.html b/cmf/html/cookbook/phpcr-odm-custom-documentclass-mapper.html deleted file mode 100644 index d1d065d..0000000 --- a/cmf/html/cookbook/phpcr-odm-custom-documentclass-mapper.html +++ /dev/null @@ -1,134 +0,0 @@ - - - - - - - - - - Usando una clase documento personalizada asociada con PHPCR-ODM — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Usando una clase documento personalizada asociada con PHPCR-ODM

                  -

                  El asignador predefinido para la clase document PHPCR-ODM utiliza el atributo phpcr:class para almacenar y recuperar la clase documento de un nodo. Cuándo accedes a un repositorio PHPCR existente, podrías necesitar diferente lógica para decidir en la clase.

                  -

                  Puedes extender el DocumentClassMapper o implementar la DocumentClassMapperInterface desde el principio. Los métodos importantes son getClassName que se necesita para encontrar el nombre de clase y writeMetadata que se necesita para garantizar que la clase de un nuevo documento almacenado se puede determinar al cargarlo de nuevo.

                  -

                  Luego, puedes sustituir el servicio doctrine.odm_configuration para llamar a setDocumentClassMapper en él. Un ejemplo del recinto de seguridad del CMF de Symfony (rama de magnolia_integration):

                  -
                  -
                    -
                  • YAML
                    # Resources/config/services.yml
-
-# Si quieres sobrescribir la configuración predefinida, de lo contrario utiliza
-# un nombre personalizado y pónlo en el bloque de configuración del odm
-
-doctrine.odm_configuration:
-    class: %doctrine_phpcr.odm.configuration.class%
-    calls:
-        - [ setDocumentClassMapper, [@sandbox_magnolia.odm_mapper] ]
-
-sandbox_magnolia.odm_mapper:
-    class: "Sandbox\MagnoliaBundle\Document\MagnoliaDocumentClassMapper"
-    arguments:
-        - 'standard-templating-kit:pages/stkSection': 'Sandbox\MagnoliaBundle\Document\Section'
                    -
                    -
                    • -
                  -
                  -

                  Aquí creamos una asociación que usa una configuración para leer información del nodo y se asocia a una clase documento.

                  -

                  Si tienes varios repositorios, puedes usar una configuración por repositorio. -Ve Configurando múltiples sesiones.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Tema anterior

                  -

                  TreeBrowserBundle

                  -

                  Próximo tema

                  -

                  Usando un repositorio de rutas personalizado con un enrutador dinámico

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/cookbook/using-a-custom-route-repository.html b/cmf/html/cookbook/using-a-custom-route-repository.html deleted file mode 100644 index cc7e34d..0000000 --- a/cmf/html/cookbook/using-a-custom-route-repository.html +++ /dev/null @@ -1,200 +0,0 @@ - - - - - - - - - - Usando un repositorio de rutas personalizado con un enrutador dinámico — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Usando un repositorio de rutas personalizado con un enrutador dinámico

                  -

                  El enrutador dinámico te permite personalizar la ruta al repositorio (es decir, la clase responsable de recuperar rutas desde la base de datos), y por extensión, los objetos Ruta.

                  -
                  -

                  Creando el repositorio de rutas

                  -

                  El repositorio de rutas tiene que implementar la RouteRepositoryInterface. La siguiente clase proporciona una solución sencilla que utiliza un repositorio ODM.

                  -
                  <?php
-
-namespace MyVendor\Bundle\MyBundle\Repository;
-use Doctrine\ODM\PHPCR\DocumentRepository;
-use Symfony\Cmf\Component\Routing\RouteRepositoryInterface;
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route as SymfonyRoute;
-
-class RouteRepository extends DocumentRepository implements RouteRepositoryInterface
-
-{
-    // Este método se usa para encontrar las rutas que coinciden con la URL dada
-    public function findManyByUrl($url)
-    {
-        // por simplicidad recuperamos una ruta
-        $myDocument = $this->findOneBy(array(
-            'url' => $url,
-        ));
-
-        $pattern = $myDocument->getUrl(); // p. ej. "/esta/es/una/url"
-
-        $collection = new RouteCollection();
-
-        // crea una nueva ruta y pone nuestro documento como
-        // predefinido (a modo de que lo podamos recuperar desde la petición)
-        $route = new SymfonyRoute($ep->getPath(), array(
-            'document' => $document,
-        ));
-
-        // Añade la ruta al RouteCollection usando
-        // como clave un ID único.
-        $collection->add('my_route_'.uniqid(), $route);
-
-        return $collection;
-    }
-
-    // este método se usa para generar URL, p. ej. {{ path('foobar') }}
-    public function getRouteByName($name, $params = array())
-    {
-        $document = $this->findOneBy(array(
-            'name' => $name,
-        ));
-
-        if ($route) {
-            $route = new SymfonyRoute($route->getPattern(), array(
-                'document' => $document,
-            ));
-        }
-
-        return $route;
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Como posiblemente hayas notado regresamos un objeto RouteCollection — ¿porqué no regresamos una sola Ruta? El enrutador dinámico nos permite regresar muchas rutas candidatas, en otras palabras, rutas que podrían emparejar con la URL entrante. Esto es importante para habilitar la posibilidad de emparejar rutas dinámicas, /page/{page_id}/edit por ejemplo. -En nuestro ejemplo emparejamos las URL dadas exactamente y siempre regresar únicamente una sola Ruta.

                  -
                  -
                  -
                  -

                  Reemplazando el repositorio predefinido del CMF

                  -

                  Para reemplazar el RouteRepository predefinido es necesario modificar tu configuración -de la siguiente manera:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    dynamic:
-        enabled: true
-        route_repository_service_id: my_bundle.repository.endpoint
-
                    -
                    -
                    • -
                  -
                  -

                  Donde my_bundle.repository.endpoint es el ID del servicio de tu repositorio. -Ve Creando y configurando servicios en el contenedor para información sobre la creación de servicios personalizados.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Usando una clase documento personalizada asociada con PHPCR-ODM

                  -

                  Próximo tema

                  -

                  Instalando el recinto de seguridad del CMF

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/genindex.html b/cmf/html/genindex.html deleted file mode 100644 index 9e2b92a..0000000 --- a/cmf/html/genindex.html +++ /dev/null @@ -1,398 +0,0 @@ - - - - - - - - - - - - Índice — Symblog - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - - -

                  Índice

                  - -
                  - B - | C - | D - | E - | F - | H - | I - | J - | K - | M - | O - | P - | R - | S - | T - | V - -
                  -

                  B

                  - - -
                  - -
                  BlockBundle -
                  - -
                  - -

                  C

                  - - - -
                  - -
                  ContentBundle, [1] -
                  - - -
                  CoreBundle, [1] -
                  - -
                  - -
                  create.js -
                  - - -
                  CreateBundle, [1] -
                  - -
                  - -

                  D

                  - - - -
                  - -
                  DBAL -
                  - - -
                  Doctrine -
                  - -
                  - -
                  DoctrinePHPCRBundle -
                  - -
                  - -

                  E

                  - - -
                  - -
                  Edición estándar -
                  - -
                  - -

                  F

                  - - - -
                  - -
                  FOSJsRoutingBundle -
                  - -
                  - -
                  FOSRestBundle -
                  - -
                  - -

                  H

                  - - -
                  - -
                  hallo.js -
                  - -
                  - -

                  I

                  - - - -
                  - -
                  I18N -
                  - - -
                  i18n -
                  - -
                  - -
                  instalación -
                  - - -
                  instalando, [1] -
                  - -
                  - -

                  J

                  - - - -
                  - -
                  Jackrabbit -
                  - -
                  - -
                  JMSSerializerBundle -
                  - -
                  - -

                  K

                  - - -
                  - -
                  KnpMenuBundle -
                  - -
                  - -

                  M

                  - - - -
                  - -
                  MenuBundle, [1] -
                  - - -
                  Midgard -
                  - -
                  - -
                  Multilanguage -
                  - -
                  - -

                  O

                  - - - -
                  - -
                  ODM, [1], [2], [3], [4] -
                  - -
                  - -
                  ORM -
                  - -
                  - -

                  P

                  - - - -
                  - -
                  PHPCR, [1], [2], [3], [4] -
                  - -
                  - -
                  publish workflow -
                  - -
                  - -

                  R

                  - - - -
                  - -
                  RDBMS, [1] -
                  - - -
                  RDFa -
                  - - -
                  recinto de seguridad -
                  - -
                  - -
                  Routing, [1] -
                  - - -
                  RoutingExtraBundle, [1] -
                  - -
                  - -

                  S

                  - - - -
                  - -
                  sandbox -
                  - - -
                  SearchBundle -
                  - - -
                  SimpleCmsBundle, [1] -
                  - - -
                  Sonata -
                  - -
                  - -
                  SonataAdminBundle -
                  - - -
                  SonataBlockBundle -
                  - - -
                  SonataDoctrinePHPCRAdminBundle -
                  - - -
                  SonatajQueryBundle -
                  - -
                  - -

                  T

                  - - - -
                  - -
                  TreeBrowserBundle, [1] -
                  - -
                  - -
                  TreeBundle, [1], [2] -
                  - -
                  - -

                  V

                  - - -
                  - -
                  VIE.js -
                  - -
                  - - - -
                  -
                  -
                  -
                  -
                  - - - - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/getting-started/installing-symfony-cmf.html b/cmf/html/getting-started/installing-symfony-cmf.html deleted file mode 100644 index 38aa02e..0000000 --- a/cmf/html/getting-started/installing-symfony-cmf.html +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - - - - Instalando la edición estándar del CMF de Symfony — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando la edición estándar del CMF de Symfony

                  -

                  El objetivo de esta guía es instalar todos los componentes del CMF con la configuración mínima necesaria y algunos muy sencillos ejemplos en una aplicación Symfony2 en funcionamiento. Esto se suele usar para familiarizarte con el CMF o para utilizarlo como punto de partida para personalizar una nueva aplicación.

                  -

                  Si este es tu primer encuentro con el CMF de Symfony sería buena idea darle un vistazo primero a:

                  - -
                  -

                  Nota

                  -

                  Para otras guías de instalación del CMF de Symfony, por favor, consulta: -- El artículo Instalando el recinto de seguridad del CMF en el recetario para instrucciones sobre cómo instalar un ejemplo de una demostración más completa del CMF de Symfony. -- Instalando y configurando el núcleo del CMF para instrucciones de instalación paso a paso y detalles de configuración de los componentes necesarios del núcleo en una aplicación de Symfony existente.

                  -
                  -
                  -

                  Requisitos previos

                  -

                  Debido a que el CMF de Symfony está basado en Symfony2, deberías asegurarte de que cubres los Requisitos para que funcione Symfony2. -Además, necesitas tener instalada la extensión PDO de SQLite (pdo_sqlite), puesto que esta se utiliza como el medio de almacenamiento predeterminado.

                  -
                  -

                  Nota

                  -

                  De manera predeterminada, el CMF de Symfony utiliza Jackalope + DBAL de Doctrine y SQLite como BD subyacente. No obstante, el CMF de Symfony es de almacenamiento agnóstico, lo cual significa que puedes utilizar uno de varios mecanismos de almacenamiento de datos disponibles sin tener que reescribir tu código. Para más información en los diferentes mecanismos disponibles y cómo instalarlos y configurarlos, consulta el Instalando y configurando Doctrine y PHPCR-ODM

                  -
                  -

                  Git y Curl también son necesarios para seguir los pasos de instalación enumerados más adelante.

                  -
                  -
                  -

                  Instalando

                  -

                  La manera más fácil de instalar el CMF de Symfony es utilizando Composer. -Consíguelo usando:

                  -
                  curl -s http://getcomposer.org/installer | php --
-
                  -
                  -

                  Y luego consigue el código del CMF de Symfony con él (esto puede tomar un buen rato)

                  -
                  php composer.phar create-project symfony-cmf/standard-edition ↓
-                  <ruta-de-instalación> --stability=dev
-mv composer.phar <ruta-de-instalación>/.
-cd <ruta-de-instalación>
-
                  -
                  -
                  -

                  Nota

                  -

                  En realidad es recomendable mover composer.phar al directorio bin de tu sistema de archivos, con el fin de que puedas acceder a la orden desde cualquier directorio.

                  -
                  -

                  La <ruta-de-instalación> debe estar dentro del directorio raíz de tu servidor web o tienes que configurar un anfitrión virtual para <ruta-de-instalación>.

                  -

                  Esto clonará la edición estándar e instalará todas las dependencias y ejecutará algunas órdenes iniciales. -Estas órdenes requieren permisos de escritura en los directorios app/cache y app/logs. En caso de que al final las órdenes terminen dando errores de permisos, por favor sigue las directrices en la documentación oficial para configurar los permisos y luego ejecuta la orden composer.phar install mencionada abajo.

                  -

                  Si lo prefieres, también puedes clonar el proyecto directamente:

                  -
                  git clone git://github.com/symfony-cmf/symfony-cmf-standard.git <nombre-dir>
-cd <nombre-dir>
-
                  -
                  -

                  Si ocurrieron problemas durante la orden create-project, o si utilizaste git clone o si después activaste una versión anterior (con checkout), siempre ejecuta la siguiente orden para actualizar las dependencias:

                  -
                  php composer.phar install
-
                  -
                  -

                  El siguiente paso es configurar la base de datos, si quieres usar SQLite como tu servidor de base de datos sólo continúa y ejecuta las siguientes ordenes:

                  -
                  app/console doctrine:database:create
-app/console doctrine:phpcr:init:dbal
-app/console doctrine:phpcr:register-system-node-types
-app/console doctrine:phpcr:fixtures:load
-
                  -
                  -

                  Esto creará un archivo llamado app.sqlite dentro de tu directorio app, el cual contiene la base de datos.

                  -

                  El proyecto ahora tendría que estar accesible en tu servidor web. Si tienes instalado PHP 5.4, alternativamente puedes utilizar el servidor web interno de PHP:

                  -
                  app/console server:run
-
                  -
                  -

                  Y entonces accede al CMF vía:

                  -
                  http://localhost:8000
-
                  -
                  -

                  Si prefieres utilizar otro servidor de base de datos, por ejemplo MySQL, ejecuta el configurador (apunta tu navegador a /web/config.php) o configura tus parámetros de conexión a la base de datos en el archivo app/config/parameters.yml. Asegúrate de dejar la propiedad database_path en null para utilizar otro controlador distinto a SQLite. Dejar el campo en blanco en el configurador web lo debería poner a null.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Documentación del CMF de Symfony

                  -

                  Próximo tema

                  -

                  Información general

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/getting-started/overview.html b/cmf/html/getting-started/overview.html deleted file mode 100644 index 58bc6c6..0000000 --- a/cmf/html/getting-started/overview.html +++ /dev/null @@ -1,132 +0,0 @@ - - - - - - - - - - Información general — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Información general

                  -

                  Esta guía te ayudará a entender las partes básicas del CMF de Symfony y cómo trabajan juntas para proporcionar las páginas predefinidas que puedes ver al explorar la instalación de la Edición estándar del CMF de Symfony (EE).

                  -

                  Esta asume que ya has instalado el CMF de Symfony y leído cuidadosamente el libro de Symfony2.

                  -
                  -

                  AcmeMainBundle y SimpleCMSBundle

                  -

                  La EE del CMF de Symfony viene con un AcmeMainBundle predefinido para ayudarte a empezar, en una manera similar al AcmeDemoBundle que tiene Symfony2, proporcionándote algunas páginas de demostración visibles en tu navegador. Sin embargo, el AcmeMainBundle no incluye controladores o archivos de configuración, como probablemente esperarías. Este contiene poco más que un archivo Twig y datos Accesorios, que fueron cargados a tu base de datos durante la instalación.

                  -

                  Hay varios paquetes trabajando juntos para convertir los datos accesorios en un sitio web navegable. El proceso global simplificado, es el siguiente:

                  -
                    -
                  • Al recibir una petición, El componente Routing del CMF de Symfony, el Enrutador dinámico se usa para manejar la petición entrante.
                    • -
                  • El Enrutador dinámico es capaz de emparejar la URL solicitada con el contenido de un ContentBundle específico almacenado en la base de datos.
                    • -
                  • La información del contenido recuperado se usa para determinar a cuál controlador pasarlo, y qué plantilla utilizar.
                    • -
                  • Tal cual esté configurado, el contenido recuperado se pasa al ContentController del ContentBundle, el cual lo manejará y reproducirá la plantilla layout.html.twig del AcmeMainBundle.
                    • -
                  -
                  -
                  Una vez más, esto es un vistazo simplificado de un muy sencillo CMS construido en lo alto del CMF de Symfony. -Para entender completamente todas las posibilidades del CMF, es necesario darle un muy cuidadoso vistazo a cada componente.
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Instalando la edición estándar del CMF de Symfony

                  -

                  Próximo tema

                  -

                  Instalando y configurando el núcleo del CMF

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/index.html b/cmf/html/index.html deleted file mode 100644 index 98446e1..0000000 --- a/cmf/html/index.html +++ /dev/null @@ -1,223 +0,0 @@ - - - - - - - - - - Documentación del CMF de Symfony — Symblog - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Documentación del CMF de Symfony

                  -

                  Bienvenido a la documentación oficial del Symfony Content Management Framework (CMF en adelante).

                  -

                  El proyecto CMF de Symfony2 está organizado por la comunidad de Symfony y cuenta con muchas compañías patrocinadoras y prominentes líderes del código abierto que implementan la filosofía del CMS desacoplado. Puedes leer y aprender más del proyecto en su página de información.

                  -

                  Esta documentación actualmente está en desarrollo y todavía muy lejos de completarse. Ve planificación de la documentación para un vistazo general del trabajo que falta hacer. ¿Quieres ayudar? ¡Gracias, toda ayuda es muy apreciada! -La fuente de la documentación está alojada en github.

                  -
                  -

                  Declaración de misión

                  -
                  -
                  El proyecto CMF de Symfony facilita a los desarrolladores la adición de funcionalidad CMS a sus aplicaciones construidas con la plataforma Symfony2 de PHP. Los principios de desarrollo clave para el conjunto de paquetes proporcionados son la escalabilidad, usabilidad, documentación y un completo banco de pruebas.
                  -
                  -
                  -

                  ¿Por qué otro CMS?

                  -

                  De hecho, consideramos que este proyecto es un CMF (por content management framework) un marco para gestionar contenido, más que -un CMS (sistema de administración de contenido). La razón es que sólo estamos proporcionando herramientas para construir un CMS personalizado. Evidentemente hoy día existen muchas soluciones CMS disponibles, pero tienden a ser adaptadas en primer lugar hacia usuarios finales y también muchas tienden -a llevar mucho equipaje delegado que las hace menos que ideales para desarrollar aplicaciones altamente personalizables tal como es posible con Symfony2.

                  -
                  -
                  -

                  ¿A quién está destinado?

                  -

                  Básicamente está destinado a las siguientes audiencias principalmente:

                  -
                    -
                  1. Desarrolladores que están construyendo una aplicación personalizada con Symfony2 y además necesitan compatibilidad para la administración de contenido. Con sofisticadas características del CMS tal como contenido semántico, edición en línea, entrega en multicanal, etc., o unas cuantas páginas de contenido para cosas como las páginas de contacto o información adicional.
                    2. -
                  2. Desarrolladores que necesitan construir una solución de autoría y etrega de contenido altamente personalizada que ningún CMS fuera de la caja puede proporcionar correctamente a través de personalización.
                    3. -
                  -
                  -
                  -

                  Cómo empezar

                  -

                  ¿Empiezas a conocer el CMF? ¿Quieres saber si el CMF es adecuado para tu proyecto? Comienza aquí.

                  -
                  - -
                  -
                  - -
                  -

                  Paquetes

                  -

                  ¿Buscando algúna información detallada sobre un paquete del CMF? ¿Quieres una lista de todas las opciones de configuración de un paquete? ¿Quiere saber si puedes utilizar un paquete independientemente y cómo hacerlo? La referencia es el sitio correcto para encontrarlo.

                  -
                  - -
                  -
                  - -
                  -

                  Componentes

                  -

                  ¿Buscando alguna información sobre los componentes de bajo nivel del CMF?

                  -
                  - -
                  -
                  -
                  -

                  Colaborando

                  -
                  - -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Próximo tema

                  -

                  Instalando la edición estándar del CMF de Symfony

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/objects.inv b/cmf/html/objects.inv deleted file mode 100644 index 44c9a35..0000000 Binary files a/cmf/html/objects.inv and /dev/null differ diff --git a/cmf/html/search.html b/cmf/html/search.html deleted file mode 100644 index 47d0312..0000000 --- a/cmf/html/search.html +++ /dev/null @@ -1,100 +0,0 @@ - - - - - - - - - - Búsqueda — Symblog - - - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -

                  Búsqueda

                  -
                  - -

                  - Please activate JavaScript to enable the search - functionality. -

                  -
                  -

                  - From here you can search these documents. Enter your search - words into the box below and click "search". Note that the search - function will automatically search for all of the words. Pages - containing fewer words won't appear in the result list. -

                  -
                  - - - -
                  - -
                  - -
                  - -
                  -
                  -
                  -
                  -
                  -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/searchindex.js b/cmf/html/searchindex.js deleted file mode 100644 index 703e724..0000000 --- a/cmf/html/searchindex.js +++ /dev/null @@ -1 +0,0 @@ -Search.setIndex({objects:{},terms:{"_rout":17,four:[],prefix:[12,3],rdf_config_dir:1,documentmanag:[24,25],agrupacion:13,dist:22,consider:[],otro:[9,10,2,22,24,18,25,13,17,5,14],"seg\u00fan":[24,12],desactiva:10,"compa\u00f1\u00eda":9,service_nam:0,otra:[0,22,1,2,24,18,25,13,19,20,5,14,16],aun:[24,2,14,13],segmento:0,under:[],"soluci\u00f3n":[9,20,11,13,19],documentrepositori:19,integrado:2,everi:[],mydocu:19,fuent:[0,9,1,2,22,18],suponiendo:[25,8],reproduciendo:21,enganchar:7,appar:[],ajust:12,prefijada:12,decidir:[24,23,17,14],cmf:[0,1,2,3,5,6,8,9,10,11,12,13,14,21,16,17,18,19,20,15,22,23,24,25],cmd:[1,11],upload:[],elegir:13,admin_bundle_simplecms_page_edit:3,db_init:[12,14],correctament:[9,1,25],blockservic:24,database_host:25,fuera:[9,2,13],bienvenido:9,bienvenida:13,ejemplo:[0,23,10,1,2,24,12,25,13,19,20,8,5,21,7,14],factibl:21,redirectcontrol:0,implementen:[10,2],second:[],entr:[0,24,1,13],aggreg:[],"sub\u00e1rbol":[8,13],ill:[],blue:[],tipo:[0,22,1,24,12,25,13,14],routingextrabundl:[0,9,2,3,25,13,16],introspect:[],metadato:[12,1,22],instance_class:12,"new":[22,17,1,11,3,24,25,19,20,14,16],net:14,ever:[],metadata:[],"tendr\u00e1n":21,manejo:1,subtre:8,cambiar:[0,22,10,24,14],dominio:[18,1],preguntado:0,"par\u00e1metro":[0,22,1,2,12,5,21,8],explorar:[15,25],henrik:2,maneja:[1,7,25],here:[],content_repositori:21,activo:22,interno:5,"cap\u00edtulo":[21,1,14],createbundl:[24,9,21,1,11],path:[19,17,7,25],inici:24,activa:[0,12,1],sonata_block_rend:[24,25],establecido:21,"implementaci\u00f3n":[0,22,17,2,12,13,7,14],use_sonata_admin:[0,21,10,26],rssblock:24,"visualizaci\u00f3n":[12,13],establecida:2,envoltura:7,relacionada:16,resto:18,permit:[24,19,2],simplecm:21,controllers_by_class:[0,21],ejecutando:[12,1,25],unix:22,moral:18,cualificado:[1,11],proporcionado:[0,9,17,1],instalando:[9,1,11,3,12,25,13,20,5,22,14,16],nodehelp:25,highli:[],forzoso:24,exacto:12,describ:1,would:[],espacio:[12,25,11,14,22],scripthandl:[1,11],henrikbjorn:2,call:23,asset:[22,1,8],recommend:[],type:[0,22,1,3,12,25,4,8,5,14],tell:[],uniqid:19,funciona:13,saber:[9,10],apena:0,relat:1,notic:[],symfonycmfblockbundl:[25,16],prioridad:[0,2],significado:[12,13],word:[],enrutando:1,translation_strategi:27,setup:[],concepto:[0,1,5],itself:[],instala:[22,25,8],examinando:17,resumen:[18,13],overrid:[],modificacion:2,"creaci\u00f3n":[19,4,7,13,25],empieza:9,give:[],arrancar:12,finalment:[0,22,13,14],sandbox_main:0,etiqueta:[0,21,1],absoluto:0,estatu:18,acmedemobundl:15,colocada:25,absoluta:[10,2],supliendo:2,consideracion:13,construy:[10,13],end:[],objeto:[0,10,1,2,24,19,14],titular:18,disparador:13,hoi:9,"podr\u00edan":[19,13],how:[],env:22,answer:[],"memorizaci\u00f3n":22,config:[0,22,23,17,1,11,3,24,12,25,26,19,20,5,27,21,7,14,16],updat:[1,11,3,25,20,14,16],symfonycmfroutingextrabundl:[12,16],fosjsroutingbundl:3,routes_to_expos:3,after:[],recuperado:[15,2],befor:[],"proporcion\u00e1ndot":15,recetario:[0,9,5],containerblock:24,cambiado:13,estrategia:2,especializada:13,demonstr:[],orden:[0,22,1,12,25,5,14],third:[],cargarlo:23,registerfil:[25,14,16],"trabajar\u00e1":14,menu_basepath:10,"sesi\u00f3n":[12,1,25],hasta:[22,2,13],naturaleza:0,adjuntar:13,environ:[],menubundl:[9,21,10,16,3],incorpor:[],useabetterpassword:25,order:[],oper:[],frontend:[],integrando:[0,2],document_class:[21,10,26],"atenci\u00f3n":18,offici:[],becaus:[],clave:[9,2,24,13,19,26,27,21,7],sandboxmainbundl:12,setdocumentclassmapp:23,flexibl:[],mayor:1,edita:1,fit:[],better:[],minimizada:1,persist:[24,25],comprehens:[],crea:[22,1,24,12,18,25,19],fin:[13,5],easier:[],comprobar:10,proporcion:[21,10,2],them:[],thei:[],fragment:[],promin:[],restbundl:[1,11],sessionnam:12,configurado:[0,22,1,2,12,25,15],db_name:[12,14],"prop\u00f3sito":24,mucho:[9,21,13,14,12],configurada:[0,12,21,25],"instanceof":0,choic:[],db_type:[12,14],incluyen:22,abordar:13,representa:2,incorporar:16,debug:[12,25,22],"hist\u00f3rico":13,side:[],mean:[],generando:2,ioexcept:22,baseblockservic:24,funcionamiento:5,proporcionamo:2,cargado:[0,12,15,1],cargada:1,permitirt:[0,2],newli:[],"colocar\u00e1":0,content:[0,9,2,27,25,26,21,8],rewrit:[],adapt:[],personalizar:[0,19,5],foto:13,navig:[],"aplicaci\u00f3n":[0,9,1,2,3,12,25,20,5,16,14,11],correcto:[9,21],"planificaci\u00f3n":9,denominar:24,omiss:[],standard:[23,5],findmanybyurl:19,activast:5,adaptando:18,precompil:[],controllers_by_alia:0,sigan:0,createj:1,regresa:[0,24],moment:[],modificast:12,filter:[4,1],"gui\u00f3n":[22,1],unabl:[],onto:[],licens:18,liip:[22,5],completars:9,"est\u00e1":[0,9,10,1,2,22,24,12,18,25,13,17,5,21,14,16],render:1,organiza:22,sonata_admin:3,symfonycmftreebundl:3,liipdoctrinecachebundl:22,independ:[],patrocinadora:9,correspondient:[21,1,16],system:[12,22,25,14,5],restrict:[],hook:[],instruct:[],alreadi:[],agregar:13,adicionalment:1,basada:[0,25,11,14,13],escogist:14,is_authenticated_anonym:[17,1],top:[],master:[22,25,14],too:[],cmf_find:17,listen:0,consol:[22,1,12,25,5,14],segundo:[22,21,13],controllermapperinterfac:0,namespac:[19,25,22],tool:[],basando:20,db_port:[12,14],phpcrimagecontrol:11,"a\u00f1\u00e1delo":1,database_driv:25,alimentador:24,admin_sandbox_main_editablestaticcontent_edit:3,sugerimo:[2,13],silli:[],target:[],warmup:[12,22],provid:[],habilita:[0,12,21,1,16],campo:[10,24,12,13,5,21,7],tree:8,max_depth:8,project:[0,5,1,10,3],matter:[],haya:[19,14],entri:[],database_password:25,treeview:8,aceptar:[0,13],esta:[0,9,10,2,3,22,12,18,25,13,19,20,17,24,5,21,16,15,14,11],obtien:[17,18,2,25],modern:[],spectrum:[],manualment:12,raw:[21,1],seen:0,doctyp:7,sitio:[9,27,12,13,20,14,6,15,8],phpcr_jackrabbit:22,person:[],comportamiento:[21,2],containerinterfac:25,contact:[],personalizando:[0,2],licenciado:18,"provisi\u00f3n":21,vinculada:2,even:[],"cargar\u00e1":[0,1,25],though:[],usernam:[12,14],introduciremo:25,object:[],"m\u00e1quina":[13,14],geturl:19,simplic:[],sidebarblock:[24,25],mybundl:19,doc:25,multilangcontentbundl:11,doe:[],repositorio:[0,9,23,10,1,2,22,24,12,25,19,20,7,14],dummi:[],producir:21,declar:[],referido:0,place:[],referida:2,compatibilidad:9,cambia:22,dot:[],"utilizar\u00e1":21,admin_bundle_content_multilangstaticcontent_delet:3,"id\u00e9ntica":18,bajo:[9,10,2,12,18,25],testblock:25,hacemo:1,abl:[],emparejada:21,comprueba:[0,17],object_mapp:1,enumera:12,delegada:[0,12],"funci\u00f3n":8,layout:15,"ayud\u00e1ndot":22,document_tre:[4,3],explain:[],configur:[0,12,23,1],apach:[12,18,14,22],delegado:[9,22],theme:8,busi:[],totalment:[1,13],folder:8,potenciador:2,"f\u00e1cilment":[0,4,20,2],apropiada:14,empacada:1,applicationkernel:1,foremost:[],exporta:12,sustituir:[0,23,1],opcionalment:[0,12,2,13,22],independientement:[9,12],nordland:2,bar:21,"public":[22,1,11,3,25,19,20,14,16],cleanli:[],auto_map:[12,1,25,14],dependiendo:[10,2,14,13],simplista:[21,1],idioma:[12,21,2,13],respond:8,"aseg\u00farart":10,ofrecida:13,phpcrbrowser:3,padr:[0,24,17,25],structur:[],respons:[0,19,2,14],ahorrar:25,default_document_manag:12,best:[],expertis:[],said:[],routeparamet:10,"men\u00fa":[21,10,13,20],databas:[12,22,25,14,5],"publicaci\u00f3n":[17,13],figur:[],simplest:[],awai:[],irc:6,mui:[9,13,5,15,14,16],attribut:[27,17,18],accord:[],includejsfilesact:1,compartir:18,extend:[0,23,1,2,24,25,19],debe:[0,22,10,1,12,18,13,5,14],were:[],"sem\u00e1ntica":1,"_control":[],extens:1,lazi:[],html5:1,"m\u00ednimo":16,subfold:[],eventualment:13,idprefix:0,contentcontrol:[0,15],expos:[],demostrar:25,howev:[],ahora:[22,1,11,24,25,26,20,5,14,16],against:[],una:[0,1,2,5,7,14,9,11,12,13,15,16,17,18,19,20,21,22,23,24,25,27],logic:[],seri:[25,13],com:[22,1,25,5,21,14],"com\u00fan":17,con:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,27],redirectrout:3,foobar:19,entendimiento:2,loader:[],permut:[],dedicada:16,privacidad:18,guid:[],assum:[],alia:[0,12],hijo:[12,17,10,7,8],cuidadoso:15,"a\u00f1ad":[0,22,10,1,11,3,24,25,19,20,21,14,16],predeterminada:[22,10,1,25,13,5,21,16],three:[],atribuir:18,much:[],entonc:[1,13,5],basic:[],retrollamada:8,quickli:[],contamo:13,rather:[],recomend:[24,12,22,2,5],"d\u00eda":9,procesando:2,pueden:[0,17,1,2,18,13,16],usado:[0,17,1],argument:23,"apoyar\u00e1n":13,rootnod:7,"subm\u00f3dulo":1,child:27,setpath:25,cambi:10,"a\u00f1adirlo":2,ant:[24,2,25],expon:[17,1,13],magnolia_integr:23,servic:[0,23],properti:8,aim:[],encontrar:[23,2,24,19,14,16],dashboard:3,servir:[2,25],anchor:[],bin:[1,5],getphpcrsess:25,applic:1,igual:[10,14],libxml:14,phpcr_user:12,sever:[],default_context:[16,25,3],inventori:[],perform:[],suggest:[],make:[],couchdb:13,who:[],max_children:8,diferencia:0,cassandra:13,colaborando:[6,9],selecttre:7,complet:[],ello:[0,2,14,13],memoria:2,buscando:[9,22,13,16],ella:[0,9,24,13],fosrestbundl:[1,11],kit:23,podamo:19,fairli:[],aprovechando:13,tune:[],hacer:[0,9,10,1,2,22,24,13],dado:[18,2,8],"a\u00fan":[1,2,25],aplicars:18,thu:[],dada:[19,21],quieren:16,etrega:9,client:[24,22,13],relacionado:13,thi:[19,1,11,25],endif:17,everyth:[],trabajando:[24,15,14],left:3,identifi:25,just:[],transforma:18,photo:[],consiguiendo:22,copiar:18,"operaci\u00f3n":7,materializado:13,multilangmenuitem:3,"espec\u00edfico":[15,2,13,16],languag:21,treebrowserbundl:[9,7,3],hai:[0,9,2,22,24,25,13,14,15,8,16],candidata:19,characterist:[],easi:[],configurando:[0,1,3,4,5,7,8,9,10,11,12,13,14,21,16,17,19,20,22,23,24,25,26,27],recurso:[6,13],"mencion\u00e9":[2,25],haz:[10,1],macport:22,invalidargumentexcept:25,mencionada:[2,13,5],els:[],"refi\u00e9ret":[22,18],save:[],trabajen:0,sanit:[],findonebi:19,arranqu:[12,22],"espec\u00edfica":[0,9,2,24,12,21],clonar:5,invoca:24,capa:[9,21,1,13,12],simplecredenti:12,specif:[],arbitrari:[],manual:14,"configuraci\u00f3n":[0,9,23,10,1,11,3,24,12,25,26,15,19,8,5,27,21,22,7,14,16],"cont\u00e1ctano":2,fixed_toolbar:1,"atribuci\u00f3n":18,ninguna:[0,1,2,24,12,18,25,8],coincida:10,docutil:[0,9,10,1,2,3,24,12,25,20,27,4,17,26,5,21,22,7,8,16],documento:[0,9,23,10,1,2,24,12,25,13,19,17,26,21,14,11],"uni\u00f3n":13,underli:[],www:[25,14],right:[17,3],root_dir:1,"secci\u00f3n":[0,10,1,12,25,21,14,16],intern:[],"d\u00f3nde":[24,12,21,7],default_sess:12,ancla:21,interf:[],precompilado:1,esquema:[22,13,14,25],total:[],cmf_children:17,getroutecont:0,tracker:[],rdfa:11,multiidioma:21,entretanto:0,foo:21,localhost:[12,22,25,14,5],core:[],plu:[],"b\u00fasqueda":[27,13,14],"reconocer\u00e1":24,trivial:14,dibujando:[24,25],repositori:[0,19],post:[1,11],habilitar:[12,4,10,22,19],chapter:[],postgresql:14,esperan:13,sepa:1,descarga:[22,1,11,3,20,14,16],"ser\u00e1n":[0,12,1],controller_class:[1,11],algo:[0,12,1,2,25],generador:10,"informaci\u00f3n":[0,9,23,10,1,2,22,24,12,26,19,20,8,5,15,14,11],commit:[],determinado:[2,13],plain_text_typ:1,"instalaci\u00f3n":[22,1,12,25,20,5,15],encuentra:[17,10,25],cualquier:[0,22,1,2,18,25,13,5,8],regist:[12,22,25,14,5],admin_list:3,"float":17,encuentro:[16,5],bound:[],son:[0,9,23,10,1,2,22,24,12,13,5,7,14,16],creativ:18,doctrina:14,"r\u00e1pida":[9,7],indeterminado:0,vuelv:[0,21],storag:[],search_field:27,facilita:9,hallo:[18,1],git:[22,1,14,5],simplicidad:[19,21],colocarlo:22,anexarlo:21,support:[],existen:9,"class":[0,1,2,3,4,5,7,8,9,10,12,21,16,17,19,20,22,23,24,25,26,27],"inyecci\u00f3n":0,recommendada:16,editor:[24,1,13],dynamicrout:[0,10,2,16],lsmith77:2,solicitada:[15,2],accesorio:[0,12,15,25,22],head:8,medium:[],form:[0,4],forc:[],phpcrodm_children:3,"adici\u00f3n":9,sustituyendo:[1,11],exactament:[19,13],disponemo:8,seguir:[22,25,13,5],utilizast:5,ensayo:13,requerida:[0,12,16],mirada:0,"true":[0,10,1,11,12,25,19,21,14,16],attr:8,asignacion:[0,12,1],plataforma:[9,2,22],vivo:13,ayudant:[0,17,1],trabajo:[9,17,2,22,12,18,13],fundament:[2,13],sampl:[],"anfitri\u00f3n":5,featur:[],liberal:18,phpcr_midgard_mysql:22,lleva:13,hardcod:[],"abstract":[],moderno:1,fuertement:8,admin_sandbox_main_editablestaticcontent_cr:3,"dise\u00f1ado":[1,2,13],archivo:[0,22,10,1,2,3,24,18,25,13,20,8,5,21,16,15,14,11],entero:21,ship:[],check:[],propia:[0,18,10,1,2],junto:[24,12,15],leer:[9,23],continuar:22,eventual:10,meanwhil:[],proporcionando:[24,9,21],when:[],junta:15,asegurar:[10,25],inasequ:[0,21],role:[17,1],test:8,page:[0,23,17,1,3,19,20,21],utilidad:17,node:[22,1,12,25,14,5,8],intend:[],database_port:25,dependencyinject:[0,25],nodo:[22,23,10,12,25,13,17,14,21,7,8],enumerado:[22,5],siguient:[0,9,17,1,2,3,24,18,25,13,15,19,22,20,5,21,16,7,14,11],seccion:22,modelo:[21,17,1,2],consid:[],itera:2,naveg:15,receiv:[],faster:[],furthermor:[],adminbundl:3,humanament:18,ignor:[],time:[],nucleo:1,incluido:22,concept:[],rol:[17,1],chain:[0,16],skip:[],global:[15,3],content_url_gener:10,actualizar:5,especifiqu:12,primer:[9,16,13,14,5],"dej\u00e1ndot":0,"im\u00e1gen":1,decid:[0,22,24,13],depend:[21,10],salida:11,comunidad:9,vez:[0,22,1,2,24,12,25,13,15,14],proporcionen:10,cach:[12,22,5],annotationexcept:25,sonata_block:[16,25,3],decir:[19,22,1,13,16],decis:[],getparamet:25,must:[],imagecontrol:1,child1:8,child2:8,sourc:[],string:[],none:8,feasibl:[],previo:[22,3,25,20,5,14,16],jackalop:[22,12,18,25,13,5,14],exact:[],prod:22,"cons\u00edguelo":5,administr:[],level:[],did:[],gui:[],dig:[],item:[],querer:[24,13,16],team:0,especifica:[0,12,21,1],div:[21,1],flexibilidad:21,dir:[12,5],prevent:[],regres:0,work:[],createphp_attribut:1,cosa:[9,1,24,12,14,8],phpcr_workspac:12,"deber\u00edan":[2,13],"bas\u00e1ndot":[10,25],sigu:[22,12,25,13,5,6],phpunit:14,comienza:9,cubren:13,port:[12,25,22],"raz\u00f3n":9,"aseg\u00far":[10,1,25,5,14,16],habilitado:[0,21,10,1],appear:[],repli:[],manejar:[0,1,2,24,25,13,27,15,7],"l\u00f3gica":[0,24,23,2,13],carga:[0,22,10,12,25,16],current:[],"m\u00e9todo":[0,22,23,17,1,11,3,24,25,19,20,16,14,2],cargu:12,"40px":17,operacion:[1,7],gener:[9,3,24,25,13,15],vario:[0,24,15,23,5],pregunta:0,enumerando:21,derivar:18,address:[],jackrabbit_jar:12,along:[],box:[],root:8,step:[],alta:0,"acompa\u00f1ant":17,"acci\u00f3n":[24,22],midgard_namespace_registri:22,rslt:8,"revisar\u00e1":1,anotacion:[21,1,14],semant:[],regardless:[],extra:[21,10,25,13],tweak:[],filter_admin_field:4,prefer:[],evaluar:22,ejecuta:[22,11,3,25,20,5,14,16],"expl\u00edcitament":[0,21,10],default_templ:26,visibl:15,instal:[22,1,11,5],should:[],mejora:1,staticcont:[0,25],app_dev:22,prove:24,duda:13,pero:[0,9,10,1,2,22,24,12,18,13,21],todai:[],cuarto:13,database_us:25,stylesheet:8,handler:[],santi:2,suppos:[],prev:17,checkout:[1,5],utilizando:[0,22,1,2,12,25,13,5,14],tightli:[],admin_bundle_menu_multilangmenuitem_edit:3,priorizada:0,aplica:2,minim:[],peopl:[],priorizado:2,persistir:14,cuanta:9,accept:[],examin:[],soportada:13,obj:8,easiest:[],routeenhancerinterfac:2,myvendor:19,prepar:[],pretend:[0,22,2,13],uniqu:[],odm_mapp:23,minimum:[14,16],can:[],purpos:[],facilitar:[2,13],unavail:[],want:[],directorio:[22,1,11,12,25,5,14],funcionalidad:[24,9,17,16],jackrabbit:[12,25,13,14,22],backslash:[],baseblock:24,topic:[],pone:[0,19,1,13],coincident:2,apunta:[0,8,5],symfony2:[0,9,2,22,24,12,18,25,13,5,6,15,14,16],menu_nam:10,enlaza:25,contribut:[],alwai:[],cargando:[0,1,25,8],multipl:[],fos_js_rout:3,colocar:12,charset:25,aquel:0,doctrine_phpcr_type_tree_model_widget:7,viendo:13,write:[],setnodenam:25,purg:12,foreach:21,fourth:[],maestro:[20,11],determinada:[10,2],map:[12,1,11,14,25],product:[],misma:[0,12,18,2,13],clone:[22,5],getpath:19,mismo:[24,21,2,13,25],dato:[0,22,10,1,2,24,12,25,13,19,5,15,14],scratch:[],date:17,sonata_admin_doctrine_phpcr:3,varia:[12,17,2,13,25],data:8,controlar:1,sonatajqueri:8,explicit:[],aportado:2,truco:[12,21,14,19],inform:[],sandbox:[22,23,1,8],preced:[],combin:[],blockinterfac:24,utiliza:[0,22,23,10,1,2,3,12,18,25,13,19,20,5,14],sonataadminbundl:[4,3],manera:[0,22,10,1,2,24,12,18,25,13,19,5,21,15,16],adaptarlo:[1,25],hacia:[9,7],still:[],mainli:[],dynam:[0,19,16],entiti:[],symfony_cmf_simple_cm:[21,20],forma:[21,18,13,14],group:[],thank:[],children_url:7,precondit:[],yaml:[0,23,10,1,11,3,24,12,25,20,19,4,17,26,27,21,7,14,16],window:[22,8],establec:1,instancia:[0,1,2,24,25,13],notablement:18,mail:[],"asignaci\u00f3n":[0,1,11,14],main:[],entrada:[0,12,10,25,22],non:[],vienen:2,initi:[],hace:[0,9,22,24,13,21,14],nuestro:[24,19],fqn:1,now:[],my_router_class:0,symfony_cmf_cont:[0,21,25,26],term:0,name:[0,1,24,12,25,19,4,8],executa:12,determinar:[24,15,10,2,23],revers:17,admintre:7,integrar:[24,11,13],separ:[],collaps:[],compil:[],dispon:[0,9,10,2,22,12,25,13,5,21,14],domain:[],distinto:5,distinta:[12,2],replac:[],continu:[],recibir:[22,15],sponsor:[],organizar:13,resourc:[23,1,11,3,12,25],happen:[],contentrepositoryinterfac:2,flujo:[17,2,13],shown:[],"omisi\u00f3n":[0,22,10,1,2,13],alojada:9,"producci\u00f3n":[12,22],arbitrario:12,poco:[15,1],condicion:18,phpcr_doctrine_db:22,rootdocu:25,poca:16,"\u00fasalo":7,asistir:13,earlier:[],consta:7,"_content":2,tienen:[0,7,13],asignarla:2,resuelv:10,ajax:[1,7,8,3],orm:[0,1,2,12,25,13,14],templates_by_class:[0,21,20],org:[22,1,11,5],"ubicaci\u00f3n":1,care:[],recog:0,chose:[],luego:[22,23,1,11,3,25,13,20,5,21,16,14,2],empezando:14,catalog:[],captador:24,thing:[],registrar:[0,22],ejemplar:2,router:[0,10,16],principl:[],imposs:[],first:[24,25],origin:2,mucha:[9,13,19],doctrine_phpcr:[0,23,3,12,25,14,16],directli:[],carri:[],onc:[],arrai:[0,22,1,11,3,12,25,19,20,14,16],simpleblock:[24,25],yourself:[],fija:1,"ser\u00eda":[24,13,5],documentclassmapperinterfac:23,open:[],actionblock:24,avail:[],given:[],negocio:13,agregalo:11,relajar:13,"est\u00e1n":[9,17,1,12],routerepositori:[0,19],checker:[],basado:[22,1,2,24,5,14,16],createphp_cont:1,ajustar:12,temprana:22,copi:[],temprano:0,specifi:[],"p\u00fablicament":18,baja:0,than:[],png:8,serv:[],wide:[],"n\u00famero":0,instanc:[],redefinir:0,aceptando:2,exampl:[],controlando:1,futura:13,posit:3,garantiza:24,parentpag:[24,25],browser:3,pre:[0,9,10,1,2,3,24,12,25,20,27,4,17,26,5,21,22,7,8,16],local_nam:25,sai:[],bootstrap:[],"_local":[21,17,2],ayudart:[15,1,2,25],siendo:[0,13],ani:[],vertiendo:12,almacenando:13,arreglo:[0,17,1,2,7],"qui\u00e9n":9,construida:9,nombrada:[12,2],deliv:[],construido:[0,15],digamo:24,mostrart:25,collat:25,phpcr_backend:12,engin:[],precargar:7,enlazando:2,note:[],ideal:[9,13],maintain:[],nota:[0,22,11,25,20,5,21,16,14,2],take:[],wonder:[],noth:[],channel:[],funcion:[22,17,2,13,5,16],therefor:[],begin:[],sure:[],normal:10,track:[],dibujar:[24,21,10,1,25],blobdir:[12,14],fallo:6,doctrinefixturesbundl:25,rdfname:1,homepag:[],falla:22,limpiament:13,icon:8,alguno:[0,1,2,13,5],interferir:14,usuario:[9,1,12,13,4,6,21,7,16],"verificaci\u00f3n":0,alguna:[0,9,17,1,24,12,13,8,5,21,15,14],later:[],enviar:13,templatenam:24,"ser\u00e1":[0,2,25,13,21,14,16],compilador:1,model_class:[1,11],puesta:12,translat:[],shop:[],multilingu:[],inmediatament:[25,14],newer:[],abstraer:13,show:[],german:[],permiso:[18,5],phpcr_pass:12,rendit:[],permiss:[],hack:[],flack:1,plantilla:[0,10,1,2,3,24,25,15,17,21,7,8],"bas\u00e1ndos":[0,10],xml:[0,12,22,1,3],interaccinen:17,onli:25,explicitli:[],dice:1,licencia:[9,18],behind:[],indexado:7,imitando:13,"s\u00f3lo":[0,9,10,1,2,24,12,18,25,13,5,21],enfocan:21,tienden:[9,13],desea:[22,2],over:[],info:12,prueba:[9,25,14],variou:[],get:[22,17],genera:[0,13],autoload:[25,14,16],tailor:[],"alem\u00e1n":21,admin_bundle_routingextra_route_cr:3,abarcando:13,ofreciera:13,requir:[0,22,11,3,25,20,14,16],referir:24,mapper:[],serializerbundl:[1,11],multilangrouterepositori:21,privileg:[],where:12,summari:27,wiki:[6,14],kernel:[12,1,25],especificando:22,dbal:[22,12,25,13,5,14],"multiling\u00fc":[12,2],proxy_dir:12,referirs:13,referenceblock:24,use_menu:21,indexar:1,dirigida:[22,16],relativa:10,requerido:[12,22],memorizando:22,getroutedefault:0,descarta:10,prototipo:4,detect:[],escogimo:24,contenido:[0,9,10,1,2,3,24,12,25,13,20,26,21,15,14,16],manejada:[1,2],label:0,biblioteca:[1,2],ambo:[7,13,25],estar:[1,25,13,5],between:[],"import":[12,1],imita:14,mappingexcept:25,amba:25,pusist:1,apoyamo:12,magnu:2,parent:25,screen:8,renunciar:13,punto:[12,1,11,13,5],como:[0,9,10,1,2,3,24,12,18,25,13,19,17,5,27,21,22,15,14],escalabilidad:[9,13],symfonycmftre:8,come:[],seguido:16,admin_bundle_menu_multilangmenuitem_cr:3,buchmann:2,region:[0,17,2,12,13,21],quier:[0,9,23,10,1,22,24,12,25,13,5,21,14],empezar:[9,15,25,2,16],audienc:[],tutori:[],db_host:[12,14],asignador:[23,1],mani:[],seguridad:[0,9,23,1,22,24,25,13,5,16],publishstartd:17,overview:[],por:[0,9,23,10,1,2,22,24,12,18,25,13,19,20,17,26,5,21,16,14,11],considera:17,publish_workflow_check:17,emparejar:[0,19,15,2,25],afectado:18,codificar:0,recomendamo:2,twig:[0,10,1,3,24,25,20,4,17,21,15],contrario:[23,1,2,24,12,14],tercer:13,"caracter\u00edstica":[9,17,1,22,13,14,8],coupl:[],symfony_cmf_block:24,iterar:2,classic:[],breath:[],barra:[1,11],seguimiento:14,dibuj:24,addit:[],buscar:[0,1],partida:5,manager_nam:0,"redirecci\u00f3n":2,valor:[0,10,1,2,12,8],"c\u00f3digo":[9,1,2,22,24,18,25,13,5],necesita:[0,22,23,10,1,2,24,12,25,5,21,14],workspac:[12,25,14,22],observa:13,those:[],"clonar\u00e1":5,"case":[],rueda:25,propio:[0,1,2,24,25,11],annotationregistri:[25,14,16],caso:[0,2,24,12,25,13,5],casi:1,"t\u00edtulo":[24,21],traducir:[1,13],entrega:[0,9],exist:[0,12,25,22],activar:1,buen:5,atributo:[0,23,1,27,12,7],incluyendo:12,permiten:[2,13],setparentdocu:[24,25],conocido:24,cluster:[],ofrec:13,good:[],uncom:[],"reutilizaci\u00f3n":18,usarlo:25,consulta:[22,1,2,12,13,5],"f\u00e1cil":[22,25,11,14,5],conseguir:[0,22,2,24,21,14],par:[0,12],develop:[],author:[],media:8,same:[],"requerir\u00e1":13,html:[0,1,3,25,4,20,15,8],pad:17,hecho:[24,9,16,13,12],eventu:[],persona:[18,13],derecho:18,utf8:25,nest:[],assist:[],driver:25,capabl:[],improv:[],extern:[],directric:[6,5],"ayudar\u00e1":[15,25],appropri:[],choos:[],adicion:[9,22,13,14,16],"utilizaci\u00f3n":[25,14],dependencia:[0,10,1,2,24,25,27,4,8,5,21,7,14,16],sencillo:[2,3,24,12,25,20,5,21,15],implementa:[12,17,14],without:[],conoc:[9,22,16],model:24,inyectada:0,"ingl\u00e9":21,publishworkflowcheckerinterfac:17,execut:[],symfony_cmf_routing_extra:[0,19,21,10,16],resp:[12,7],registerbundl:[22,1,11,3,25,20,14,16],rest:1,route_repository_service_id:[0,19],altament:9,aspect:[],encontrado:21,"aceptar\u00edamo":13,tenerlo:0,utilizada:2,"anotaci\u00f3n":25,complemento:[1,13],"apoyar\u00eda":1,trigger:[],utilizado:12,except:22,littl:[],pila:[22,18,2],parar:12,blob:[12,14],"__dir__":[25,14],familiarizart:5,principalment:[0,9],earli:[],around:[],read:[],cuando:[0,10,1,24,18,13,14],lado:8,leen:1,darl:[15,2,5],aspecto:13,world:[24,25],file_system:22,admin_bundle_content_multilangstaticcontent_edit:3,"t\u00e9rmino":[0,18],knp_menu_rend:10,procesar:13,integ:[],server:[12,14,5],contribucion:13,either:[],output:7,gestor:[12,10,1,25],precedencia:0,deliveri:[],"le\u00eddo":15,imagen:[24,1,13],administrador:22,pieza:13,bigger:[],servicio:[0,23,10,1,24,12,19,17,21],definir:[0,12,24,13],mecanismo:[22,2,5],legal:18,"din\u00e1micament":2,sugiera:18,equipaj:9,proporcionan:[0,10,14],inject:[],notabl:[],alternativament:5,refer:[],pdo_sqlit:5,each:[],"adem\u00e1":[0,9,17,1,2,24,13,27,5,21,14],fulli:[],abstractfixtur:25,"throw":[],enrutado:[0,10,2,3,13,21],"intenci\u00f3n":13,greatli:[],generado:1,generada:12,representar:[0,25,13],acm:25,indexact:[0,21],inferencia:1,stand:[],endforeach:21,"demostraci\u00f3n":[22,15,16,5],encadenado:0,"estar\u00e1n":12,trabajan:15,effici:[],medio:[22,17,1,13,5],reflexion:24,cssrewrit:1,instrumento:13,ayuda:[9,20,10],hipertexto:24,your:25,trabajar:[0,1,25],compon:[0,19,25,2,22],prepara:12,log:5,"a\u00f1ada":0,setpar:25,interfaz:[0,22,10,1,2,12,25,13,17,21],overwrit:[],"expl\u00edcita":0,start:[],interfac:[12,4,13],low:[],lot:[],checkispublish:17,"expl\u00edcito":0,completa:[2,18,13,20,5,14],zip:1,enough:[],modificar:[24,19,1,22],bundl:[0,22,10,1,11,3,25,19,20,8,21,14,16],completo:[9,1,2,13,12],"\u00faltima":[24,25,14],sonatajquerybundl:[8,3],"\u00faltimo":[0,1,13],realli:[],phpcrbundl:[25,14],pull:[],enlac:[6,18,22],seleccionar:7,possibl:[],"default":[0,22,10,24,12,25,27,17,14,7,8,16],controllerclassmapp:[],connect:[12,25,14],crear:[22,1,2,3,24,12,25,13,7,14],dcterm:1,creat:[22,1,11,12,18,25,5,14],sanea:24,encadenar:2,mundo:13,resultant:18,strongli:[],generar:[0,22,10,2,12,19],dicho:13,file:[],caracter:2,himself:[],refiriendos:2,tenga:24,link:8,feedurl:24,again:[],igu:7,intentaremo:2,field:[],wai:[],rdbm:[12,13,14],generic_control:[0,21],alohaeditor:1,you:[],db_usernam:[12,14],registro:[2,14],respuesta:8,proporciona:[0,22,10,1,2,24,12,20,25,13,19,4,17,8,26,27,21,7,14,11],versionar:13,registra:[12,25],busquen:13,important:[24,19,23,13],grupo:13,restringir:1,unless:[],knp_menu:10,requerir:2,fos_rest:1,significa:[22,1,2,13,5],admin_bundle_simplecms_page_delet:3,directori:[],mimic:[],"p\u00e1gina":[9,1,22,24,18,25,13,21,15,14,16],"todav\u00eda":[0,9,25,2,16],"analizar\u00e1":1,routeawareinterfac:25,nunca:[0,10,2,13],represent:24,all:[17,25,3],priorit:[],jsloader:1,forget:[],claro:18,correr:22,correo:6,multilangpag:[21,1],code:[],abil:[],follow:[],mezclar:12,children:8,admin_bundle_menu_menuitem_cr:3,"metainformaci\u00f3n":14,content_kei:10,redirect_control:0,estructura:[21,20,13,14],aplicar:13,dibujado:1,queri:[12,17],colapsando:8,introduc:[],libertad:18,liter:[0,9,10,1,2,3,24,12,25,20,27,4,17,26,5,21,22,7,8,16],habilit:13,fals:[0,10,1,12,17,21],establ:22,symfonyrout:19,routecollect:[19,7],util:25,"inclusi\u00f3n":1,mechan:[],desactivar:[0,21,10],veri:[],"nombresesi\u00f3n":[],peticion:[0,1],"gu\u00eda":[9,11,3,25,13,20,5,15,22,14,16],"integraci\u00f3n":[2,24,12,27,4,7,8],creando:[9,19,25,3],emparejamo:19,list:[12,4],descomprim:1,content_repository_service_id:0,adjust:[],plain:[],small:[],manifiesto:13,corriendo:22,pasa:[0,24,15,1],ten:[10,1,2,24,12,13],routerepositoryinterfac:[0,19,2],incluya:1,"poblar\u00e1":22,paso:[22,11,25,13,20,5,14,16],esfuerzo:13,design:[],pass:[],definida:[24,25,13],further:[],addition:[],what:[],favor:[0,22,2,18,13,5,21],section:23,verdadero:2,usamo:0,doctrinephpcrbundl:[9,22,12,25,14,16],ayudar:[9,13],replace_symfony_rout:0,delet:7,version:13,fetch_depth:12,modelado:1,destinado:9,method:[],"a\u00f1adi\u00e9ndolo":[0,11,3,20,14,16],detectada:0,full:[],component:[0,9,10,2,24,25,13,5,21,15,16],sophist:[],"podr\u00e1":[18,14],behaviour:[],aquello:17,"edici\u00f3n":[9,1,11,22,24,20,5,15,7,14,16],ver:[0,12,15,25,22],reproducida:24,modifi:[],valu:[],algoritmo:13,expresar:13,creamo:23,search:[],ahead:[],instruccion:[0,22,10,2,5,16],torno:14,db_password:[12,14],evitar:[0,12],amount:[],base:[0,22,10,1,2,12,25,13,19,5,15,14],miniatura:13,phpcr:[0,9,23,10,1,2,3,24,12,18,25,13,19,17,5,21,22,7,14,16],pick:[],action:0,gestiona:12,jre:22,via:[],document_manag:[12,17],vie:[1,11],experimentado:16,texto:[18,1,13,14],ask:[],href:[0,17,8],"administraci\u00f3n":[0,9,10,1,3,12,13,22,21,7],json_data:8,select:[12,7,25],inyect:0,"alg\u00fana":9,"filosof\u00eda":9,objectmanag:25,beatric:2,phpcr_children:3,liber:[],provocar:1,objetivo:[11,3,18,25,13,20,5,16,14,2],two:[],trabaja:[0,1,2,13],demo:[22,1],basi:[],page_id:19,mejorar:22,toggl:[],more:0,realizar:13,homebrew:22,hundr:[],mira:[1,25],omissi:2,incluir:25,particular:13,known:[],compani:[],descargar:22,correctli:[],guarda:1,endpoint:[0,19],dep:1,optimizarla:0,dev:[22,1,25,5,14,16],remain:[],del:[0,1,2,3,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26],"fot\u00f3grafo":13,"simb\u00f3lico":22,learn:[],probar:25,almacenan:[22,1],iniciar:[12,2],share:[22,18],"m\u00faltipl":[12,23,13],templat:[4,23,3],phpcrodm_mov:3,azul:24,subdirectorio:1,explor:[],lograr:16,actualment:[0,9,10,2,12,13,20,21,14,11],content_basepath:[0,10,26],almacenar:[23,10,2,25,13,21,14],recursiva:13,cours:[],mai:[],goal:[],respectiva:[0,22],programmat:[],anoth:[],renuncia:18,snippet:[],simpl:[12,21,10,13,20],css:[1,8],redirigir:[0,2],referenc:[],distribuir:18,simplecmsbundl:[9,1,3,20,21,15],sistema:[0,9,1,2,3,12,13,5,22,14],datafixtur:25,plano:1,associ:[],"\u00fatil":[2,13],stabil:[16,14,5],github:[22,1,9,25,5,6],registrado:25,anexar:13,refiriendo:10,"reproducir\u00e1":15,recuperamo:19,dentro:[1,11,12,25,13,5,2],callback:[],cmf_prev:17,urlmatch:[0,2],argumento:12,incapaz:2,escucha:22,gestionando:24,checkbox:[],help:12,phprc:22,hypertext:[],mission:[],"har\u00e1":24,trade:[],held:[],through:[],"recuperaci\u00f3n":[2,13],multilang:[21,10,26],paramet:[22,1,25,5],fallback:[],style:17,asignar:[20,2,13],controlador:[0,1,2,15,26,5,21,7,16],dbname:25,idealment:13,might:[],wouldn:[],vece:21,"return":[19,1,8],"personal\u00edzalo":1,mientra:[0,13],consigu:[22,5],"opci\u00f3n":[12,21,1,14],excepcion:18,static_basepath:[25,26],framework:9,eficientement:[2,13],cargador:25,"as\u00ed":[22,1,2,3,24,25,13,21,14],document:[0,23,10,1,11,3,12,25,19,20,17,21,8],troubleshoot:[],pedido:13,easili:[],sandboxmagnoliabundl:12,aplicacion:[9,22],habitu:25,found:[],admin_class:[10,26],cubrir:22,entendido:18,desarrollado:13,haber:13,hard:[],idea:[16,13,5],seguist:25,toda:[0,9,1,2,24,12,13,5,6,21,15,14],expect:[],entorno:[22,1,13],apply_to:1,posiblement:[0,19,25],beyond:[],todo:[0,22,17,1,2,12,25,13,5,21,14,16],event:8,mostrado:[24,25],controllermapp:0,asociado:[12,10,2],"all\u00e1":[9,12],rendimiento:[22,14],"all\u00ed":25,asociada:[9,23,7,12],publish:[],symfony_cmf_search:27,arranca:12,"\u00f3rdene":[12,25,13,14,5],"regi\u00f3n":[21,2],"peque\u00f1o":13,proxi:[],adecuado:[9,13],redirectact:0,"cl\u00e1sica":0,magnolia_us:12,like:[],reason:[],imagina:24,put:[],empezast:25,symfony_cmf_routing_extra_terms_form_typ:0,pasado:1,symfony_cmf_menu:10,"maniqu\u00ed":22,my_bundl:[0,19,24],database_path:5,includecssfil:1,launch:[],advanc:[],feed:[],route_nam:10,inventario:13,propiedad:[24,12,13,5],persistencia:13,defecto:13,ciento:13,number:[],esperamo:1,cada:[0,9,1,2,24,12,15,14],done:[],dond:[0,24,12,19,21,7,14],blank:[],magnolia_url:12,stabl:[],miss:[],differ:[],decoupl:[],inicial:5,script:[1,11,8],interact:[],gestionar:[9,2,13],terminen:5,contra:12,notado:19,statement:[],ignorerol:17,store:[],schema:22,descargast:14,option:12,para:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25,26,27],dynamic_rout:[0,10,16],selector:[7,8],getter:[],claudio:2,mencion:13,routerinterfac:2,publishworkflowcheck:17,simplist:[],whenev:[],remov:[],posibl:[0,9,13,14,25],"versi\u00f3n":[22,1,25,14,5],jqueri:[1,7,8],sandbox_magnolia:[12,23],reus:[],resourcenotfoundexcept:[],toward:[],ejecutarlo:25,revisar:1,deleg:8,confirma:25,necesit:[0,10,16],phar:[22,11,3,25,20,5,14,16],direct:[],packag:[],traduc:2,"program\u00e1ticament":22,dedic:[],"null":[25,5],simplificado:15,configurar:[0,9,10,1,2,22,27,12,25,13,20,5,16,14,11],imagin:[],poner:[0,2,12,13,5,7],built:[],lib:[25,14],blanco:5,"a\u00f1adir":[0,1,2,12,25,13,21],configurador:5,also:[],route_repository_servic:0,separada:12,pasar:[12,10],build:[],separado:21,organizado:[9,13],nivel:[9,13],fresca:25,apoyar:[17,13],distribut:[],desarrollando:1,copia:[22,13],filesystem:22,most:[],jsp:14,plan:[],diferent:[0,22,23,10,1,12,13,5,21,14,16],apoyan:13,phpdoc:[],phpcrproxi:12,prefijo:[0,21,25],requisito:[22,10,1,3,12,25,13,20,5,21,14,16],especificada:18,recogido:2,reproducir:[21,1],init:[22,1,12,25,5,7,14],"garantizar\u00e1":21,forzar:[0,21,10],coinciden:19,part:[9,2,24,13,15,7],latest:[],proporcionada:[0,12,21,17,2],suficient:[1,25],personalizado:[0,9,23,1,2,19,14],treeinterfac:7,tener:[0,22,1,2,12,18,25,13,5,21,14],personalizada:[9,21,23,12],licenciador:18,habilitada:[0,21],session:[12,7,14,25],fino:1,publicado:17,doctrineannot:[25,14],fine:13,find:[10,25],referencia:[9,1,11,24,12,13,20,14],nosql:13,setnam:[24,25],solut:[],manipul:[],prefier:[1,5],coloca:[0,11],modificando:25,factor:13,yml:[0,22,23,17,1,11,3,24,12,25,26,19,20,5,27,21,7,14,16],"alg\u00fan":[24,25,11,14,13],sql2:12,express:[],kind:[],nativ:[],opcional:13,tratamiento:1,necesitar:[23,10,25],encontrarlo:9,common:[18,25],anteriorment:[2,13],set:[17,25,3],ser:[0,9,1,2,22,24,25,13,21,14],dump:[12,22],contentbundl:[0,9,24,25,26,15,16],containerawareinterfac:25,treebundl:[9,4,7,8,3],see:[],nativament:13,sea:[0,1,2,24,12,18,25,13,11],close:8,aunqu:[2,13],odm_configur:[12,23],lee:0,"elecci\u00f3n":13,habilidad:13,"contrase\u00f1a":12,someth:[],juego:2,difusa:13,symfonycmfmenubundl:[12,16],cuidadosament:15,dominar:16,"estar\u00e1":0,enterament:13,"gen\u00e9rico":[0,7,25],experi:[],altern:[],solo:[22,17,10,7,13],appreci:[],admin_bundle_routingextra_route_edit:3,javascript:[1,8],"porqu\u00e9":19,sola:[19,2,13],catalogo:13,classnam:[1,7],"\u00e1rbole":13,popul:[],magnoliabundl:23,both:[],last:[],necesario:[22,1,24,12,25,13,19,5,15,14,16],necesaria:[24,16,5],considerar:13,asunto:13,pdo:5,"_templat":0,undetermin:[],context:3,generalment:[2,13],load:[12,22,25,5],reescribiendo:1,"c\u00f3mo":[0,9,10,1,2,15,24,12,25,5,21,22,7,14,16],point:[],instanti:[],utf8_general_ci:25,mayoritariament:14,cierta:2,detal:[0,22,13,5,14,16],"agn\u00f3stica":13,param:19,suppli:[],tonto:24,coincid:0,"agn\u00f3stico":[22,13,5],backend:[12,25,14],definidor:24,java:[22,14],due:[],empti:[],conjunto:[9,2,13],damo:13,symfony_cmf_cr:[1,11],alto:[0,1,2,12,13,15,7,14],esto:[0,22,10,1,2,24,12,25,13,19,5,15,14,16],"conexi\u00f3n":[12,5],imag:[4,1,11,8],abajo:[12,1,25,14,5],deten:12,understand:[],asegurart:[22,5],instalado:[0,15,1,25,5],instalada:[14,5],recuperar:[24,19,23,2,13],sko:1,content_repository_id:21,wysiwyg:1,introspecciona:1,look:[],regla:[24,6,13],formato:[0,12,1,8,14],histor:[],"while":[],fue:2,sobr:[0,9,10,1,2,22,12,18,25,13,19,8,5,21,7,14,16],error:[0,22,10,25,5,21,14],enlazado:25,fixtur:[12,22,25,5],loop:[],abierto:[9,18],declarar:[0,2],real:[24,22,1,2,13],reutiliza:21,conten:2,readi:8,noticia:[24,13],busca:[1,7],userbundl:25,abov:[],liipsearchbundl:27,importa:12,my_rout:0,use_coffe:1,grant:25,coffeescript:1,ruta:[0,9,10,1,2,3,12,25,19,20,17,5,21,7],fueron:[15,13],"din\u00e1mico":[0,9,10,2,19,15,16],grand:[27,12],"din\u00e1mica":19,importando:22,higher:[],phpcr_:25,optim:[],"necesitar\u00e1":[25,2,16],doctrinedb:[12,25,14],"_route_param":17,user:25,configuracion:[12,10],"categor\u00eda":25,stack:[],lower:[],pendient:[0,1],"navegaci\u00f3n":7,"l\u00eddere":9,conseguirlo:22,endfor:17,writemetadata:23,knp:[10,16],explan:[],referenciar:13,cubierta:18,incluso:[21,2,13],normalment:[24,12],preocupamo:13,alternativo:22,emparejen:0,"remoci\u00f3n":7,preparando:22,mysql:[12,25,14,5],alternativa:[12,1,13,22],combinar:13,create_imag:1,respeta:2,aloha:1,puesto:[22,10,2,13,5,16],multilenguaj:12,reemplazando:19,arriba:[12,13,14],"abstracci\u00f3n":12,cmf_rout:0,"tendr\u00e1":0,predeterminado:[2,5],tomar:[22,13,5],marco:9,vendor:[1,25,14],format:1,saltart:25,big:[],"r\u00e1pidament":[22,25,13,16],expandiendo:8,independient:[12,2,13,25],rest_controller_class:1,is_bundl:12,accion:24,globalizado:13,pertinent:[18,1],recinto:[0,9,23,1,22,24,25,5,16],convertir:15,relajadament:8,resolv:[2,14],websit:12,collect:19,princip:[10,2,14],ignora:17,baggag:[],popular:13,my_namespac:0,pasarlo:[24,15],encount:[],palabra:19,blockbundl:[24,9,16,25,3],creation:[],some:[],reescribir:5,"autor\u00eda":9,"ver\u00edan":24,permitir:[0,2,13],doctrin:[0,9,23,10,1,2,3,12,25,13,19,5,22,14,16],bloqu:[23,3,24,12,25,21],obra:18,gracia:[9,13],sonatadoctrinephpcradminbundl:[0,9,4,10,3],fragmento:24,mostrar:[21,25,14],decision:13,per:[],prop:12,sonata_doctrine_phpcr_admin:[4,3],inicio:25,inicia:[22,11,3,20,14,16],ajusta:[12,10,1],contacto:[24,9],rdfmapper:1,machin:[],previou:[],run:[12,5],"permiti\u00e9ndot":[21,2],llamar:[24,23],nuevo:[22,23,1,2,24,12,25,13,7,14],unport:18,olvid:1,editablestat:0,magnolia_pass:12,requier:[0,20,11,14,25],activado:1,impos:[22,13],nueva:[19,25,13,5],"contin\u00faa":5,utilizarlo:[2,5],materi:[],select_nod:8,justo:[0,1,2,24,18,14],manag:[9,25],uso:[0,9,24,18,25,13,21],"est\u00e1tico":26,block:[24,21,25,8,3],configurarlo:5,anterior:[0,17,24,25,13,5,14],volcar:22,david:2,getroutekei:2,estructurado:13,intl:22,within:[],soportar:13,soportan:13,ensur:[],sobrescribir:[12,23,1],cabo:13,canal:6,everybodi:[],inclus:[],configurarla:25,span:[0,9,10,1,2,3,24,12,25,20,27,4,17,26,5,21,22,7,8,16],metadata_cache_driv:12,incluy:[1,2,25,14,15,8,11],almacena:10,enabl:[0,19,16],admin_bundle_simplecms_page_cr:3,live:[],"long":[],custom:[],doubt:[],includ:1,suit:[],poder:[1,25,13],entir:[],properli:[],evidentement:[9,13],accediendo:22,redirectrouteinterfac:[0,2],habilitarlo:[0,21,10,16],desarrollador:[6,16,13,9],loadblockwithphpcrpar:25,despacha:1,line:[],"interpretaci\u00f3n":13,"detenci\u00f3n":22,bjornskov:2,asum:15,consist:[],"prefijar\u00e1":21,move_url:7,highlight:[],similar:[24,15,18,13],definen:10,supervisor:17,initsubmodul:[1,11],cover:[],flush:25,implementan:[0,9],navegador:[15,1,7,5],repres:[],implementar:[0,23,17,1,2,19,10],behavior:[],diverso:13,curl:[22,5],muestra:[22,3,24,12,25,14],"est\u00e9":[21,15,14,25],jcr:12,"generaci\u00f3n":2,preguntar:24,cuenta:[9,10,1,2,22,24,12,13],tard:14,"art\u00edculo":[16,5],cambio:[24,25,13],librari:[],"mayor\u00eda":[0,13,16],"almacen\u00f3":12,"llevar\u00e1":13,dale:[0,24,25,16],gigabyt:13,mongodb:[13,14],totalidad:13,createphp:[21,1],vivimo:13,inversa:11,enhanc:[],problema:[25,5],elemento:[18,20,10,1,13],algorithm:[],manten:13,"traducci\u00f3n":12,"l\u00ednea":[9,1,11,22,25,5,14,16],asseticbundl:1,p16:2,teaser:[],"b\u00e1sica":[12,15,11,14,22],depth:[],far:[],fresh:[],"tendr\u00eda":[2,24,12,25,5,21,7],hello:[24,25,8],"l\u00e1nzalo":14,"b\u00e1sico":[2,13,25],escogido:14,pluggabl:[],activarlo:0,soportado:12,symfonycmftreebrowserbundl:3,publicidad:18,completament:[15,1,11,13],cargar:[0,22,10,1,2,25,13],apoyado:12,leal:18,focu:[],instalarlo:[25,5],reemplaza:24,child3:8,conectars:12,optimiza:13,documentmenuitem:[],routeenhanc:2,"contribuci\u00f3n":13,"\u00e1rbol":[0,10,24,13,20,14,21,7,8],sens:[],manejando:1,fatal:25,ofici:[0,9,22,12,5,14],eligiendo:[9,13],"extensi\u00f3n":[22,17,1,12,25,13,19,5,14],unzip:[],aprend:[0,9,25,12],searchbundl:[27,9],alik:18,llama:8,dando:[13,5],"declaraci\u00f3n":[9,2,12],debido:[22,21,14,5],relev:[],apreciada:9,tra:2,disponibilidad:13,tre:[1,2],"try":[],recib:24,pued:[0,9,23,10,1,2,22,24,12,18,25,13,27,5,21,15,14,16],"petici\u00f3n":[0,10,1,2,19,15],phpcr_midgard_sqlit:22,"m\u00ednima":[0,16,5],integra:[0,1],pleas:[],preload:7,contenga:24,setcont:[24,25],natur:13,extiend:[10,2],"v\u00eda":[8,5],segunda:24,priorizar:13,privilegio:22,odm:[0,9,23,10,1,2,3,12,18,25,13,19,17,5,21,22,14,16],urlgener:[0,2],download:[1,14],doctrinephpcradminbundl:3,click:8,append:[],compat:[0,24,2,13],index:[0,20,25],porqu:[0,25],usando:[0,9,23,10,1,2,24,12,25,13,19,5,7,8],han:13,acceso:[12,1,13],access:[],ocurrieron:[1,5],detien:12,"recuperar\u00e1":2,whatev:[],endcreatephp:[21,1],construyendo:9,hacerlo:[24,9,18,22],"p\u00fablico":18,iniciativa:13,httpkernel:2,bodi:[27,21,1,8],sino:0,let:[],extremo:13,ubuntu:22,limitar:13,becom:[],sinc:[],content_id:[0,2],producto:13,until:[],larger:[],"ver\u00eda":21,asist:24,symfonyroutingextrabundl:10,phpcrodmbrows:3,rdf:[21,1,11],menu:[21,10,8],existent:[23,1,2,25,5,14],chang:[],descrito:0,chanc:[],isedit:1,although:[],auto_generate_proxy_class:[12,25],app:[0,22,17,1,11,3,24,12,25,26,19,20,5,27,21,7,14,16],submodul:[],apt:22,estamo:9,creado:1,api:[12,13,14],sirv:1,optimizada:14,motor:14,usar:[0,22,23,10,1,2,25,5,21,14],pesar:[2,25],form_admin_field:4,creada:10,dejar:[0,18,5],subyacent:[12,25,2,5],from:[12,25],cantidad:13,usa:[0,22,23,10,1,2,12,25,19,21,15,14],commun:[],"crear\u00e1":[22,5],pue:13,registerload:25,next:17,chainrout:[0,2],few:[],meno:[9,10],usr:[22,1],cualquiera:[12,18,2],symfonycmfcreatebundl:[1,11],sesion:[12,23],implementando:2,stage:[],construir:[9,10,2,13,7],"personalizaci\u00f3n":[9,1,2],sudo:22,recomendado:[22,8],src:[1,25,8],alcanc:2,demuestra:25,actual:[22,1,2],rato:[22,5],almacenado:[24,15,23],retriev:[],scalabl:[],provenir:1,almacenada:24,supon:0,obvious:[],enruta:0,meet:[],fetch:[],sabe:[24,1],control:[0,21,1,11,13],getroutebynam:19,sqlite:[22,13,14,5],"n\u00facleo":[0,9,10,1,2,3,20,5,6,21,22,16],process:[],liip_doctrine_cach:22,permanezcan:13,regresado:[0,2],high:[],admin_bundle_routingextra_route_delet:3,tag:[0,21],proceso:[0,6,15,13,22],nativo:13,onlin:[],tal:[9,1,2,22,12,13,21,15],expandir:7,phpcr_odm:[1,11],lejo:9,soon:[],tanto:[2,13,25],mein:21,especificar:[0,12,21,10,1],aprovech:13,escribiendo:22,cual:[0,22,17,1,2,25,13,5,21,15,14,16],instead:[],nodeinterfac:10,llamarl:24,refier:22,especial:9,tien:[0,22,23,10,1,2,15,24,12,25,13,19,8,5,21,7,14,11],falta:[9,13],reposititori:[],stop:[],luka:2,espectro:13,omitir:22,philosophi:[],"esperar\u00eda":15,essenti:[],backup:[],"\u00fanicament":[0,19,21,25],correspond:[],element:[],issu:[],symfonycmfcorebundl:16,allow:[],unida:13,elejist:12,primero:[24,1,5],ocup:13,routers_by_id:[0,16],loadblockwithcmfpar:25,getcompos:[22,5],predefinido:[0,22,23,10,1,2,15,12,25,19,4,21,7,14],predefinida:[0,22,23,10,1,3,12,21,15],traduccion:[2,13],"necesitar\u00edan":13,"tambi\u00e9n":[0,9,10,1,2,22,24,12,25,13,5,21,14,16],chosen:[],settitl:[24,25],detallada:9,my_route_:19,puerto:22,getclassnam:23,detallado:21,implementacion:[0,10,2,13],handl:[],auto:[0,21,10,26],nada:[0,24,10],camino:13,configuration_id:12,devel:1,mention:[],dar:14,"qu\u00e9":[9,24,12,13,15,7,14],"significar\u00eda":10,"_sonata_admin":3,acord:24,anyth:[],edit:[1,24,19,5,7,8],tran:0,sin:[0,22,24,12,25,13,5,15,14],"b\u00e1sicament":9,permitida:21,permitido:1,modo:[24,19,21,1,22],adelant:[9,21,22,25,5],"habr\u00eda":13,buena:[16,25,13,5],"cu\u00e1ndo":[0,22,23,13],documentclassmapp:23,meta:22,"static":[0,25,26],apoya:[18,13],annot:[25,14],our:[],sioc:11,apoyo:[11,13],almacenamiento:[9,1,22,12,13,5,14],special:[],probablement:[0,15,10],magnoliadocumentclassmapp:23,sient:2,anidado:13,singular:13,jquerybundl:3,categori:[],suitabl:[],rel:8,causa:13,"int\u00e9rpret":22,leverag:[],lectura:13,necesitan:[9,2],doctrinecachebundl:22,insid:[],workflow:[],proxy_namespac:12,"importaci\u00f3n":14,"ejecutar\u00e1":5,ech:2,standalon:[22,14],que:[0,1,2,3,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19,20,21,22,23,24,25],usabl:[],compra:13,"preparaci\u00f3n":13,organ:[],obstant:[24,25,13,5],sentido:13,prerecuperado:12,could:[],asociarla:2,keep:[],frent:13,enforc:[],trabaj:[20,11],outsid:[],manager_registri:0,naturalment:[0,12,24],dependa:14,probado:22,probada:22,eficient:13,instalar:[22,11,12,25,20,5,14,16],getpattern:19,regresamo:19,"detr\u00e1":13,knpmenubundl:[10,16],prioriti:0,"\u00fanico":[24,19,13],editar:[22,21,1,7],quieran:17,elimina:12,"\u00fanica":[0,2,12,13,20,16],capac:13,wrapper:[],phpcr_node:25,attach:[],capaz:[15,1,2,13],"cu\u00e1l":[0,1,2,24,7,21,15],tree_block:3,"final":[9,1,13,5],configura:[12,16,10,1,5],shell:[],dibujarlo:26,fuzzi:[],descendient:24,listo:[25,14],cache_dir:12,accompani:[],document_manager_nam:[24,27,10],necesitamo:16,enlazar:25,exactli:[],lista:[0,9,1,13,6,21,8],haven:[],rss:24,"int\u00e9ntalo":25,photograph:[],sanearlo:24,"ra\u00edz":[0,10,7,25,5],garantizar:[23,13,16],myblock:[24,25],apropiado:0,charact:25,llevar:[9,13],bind:8,regresando:8,contenedor:[0,19,1],corebundl:[9,17,16],exhibir:22,proveyendo:22,cmf_document_local:17,basepath:[21,25],fail:[],admin_bundle_menu_multilangmenuitem_delet:3,have:0,tabl:8,need:[],simplement:[0,22,25,13],etiquetado:0,border:8,"vac\u00eda":[27,12],permutacion:13,presencia:0,realidad:[13,5],paquet:[0,1,2,3,7,8,9,10,11,12,13,14,15,16,17,18,20,21,22,24,25,26,27],min:1,"despu\u00e9":[22,1,12,25,5,14],rout:[0,9,10,1,2,3,25,15,19,20,21,7,8],"switch":[],servidor:[12,22,8,14,5],mix:[],alterna:12,which:[],engancharlo:0,registrarla:14,mit:18,singl:[],posibilidad:[19,15,13],lugar:[9,10,1,24,12,13,14],crearlo:7,aparec:24,mimick:[],"trav\u00e9":[9,13],clase:[0,9,23,10,1,2,12,25,13,19,4,17,21,11],search_path:27,compilado:1,explicar:13,dump_max_line_length:12,audiencia:9,conmutar:8,segment:[],why:[],compilada:12,adaptar:25,url:[0,10,1,2,15,12,19,8,21,7,14],request:17,uri:2,usabilidad:9,determin:[],brew:22,trampa:1,fact:[],seleccionada:10,text:8,seleccionado:7,principio:[9,23],dbu:2,setter:[],redirect:[],repository_id:12,durant:[15,5],locat:8,jar:[12,14,22],bien:[22,2,24,12,13,21,14],jstree:8,manipular:[2,13],local:[12,21,10,1,26],libro:15,hope:[],appkernel:[22,11,3,25,20,14,16],meant:[],escarva:1,move:[],gettyp:24,familiar:[],suel:5,elejido:12,autor:[18,2,13],acces:[22,5],cubr:[22,13,5],guion:1,increas:[],admin_bundle_menu_menuitem_edit:3,symfony_cmf_cor:[0,17,10],"aqu\u00ed":[0,9,23,22,12,13,14,8,16],unstructur:12,vien:[0,24,15,1,13],gitnacho:25,ordenado:2,partir:[10,16],integr:[],contain:[17,25],menuitem:[10,3],grab:[],view:[1,25],concordancia:0,legaci:[],solucionando:25,complementan:25,preventdefault:8,"sem\u00e1ntico":[9,1,25,13],ajax_layout:3,fixturesbundl:25,reemplazar:[0,19],"extracci\u00f3n":1,empaca:1,nombr:[0,22,23,10,1,2,12,25,4,5,21,14,11],devuelto:2,"cach\u00e9":[12,2,22],devuelta:2,pattern:19,createpath:25,"modificar\u00eda":24,tend:[],tuvieron:13,llamada:[1,8],state:8,caja:[9,13,14],entrant:[19,15,2],thumbnail:[],llamado:[24,22,25,13,5],entidad:[0,24,1],limitacion:18,kei:12,asociacion:[0,12,1],manejado:0,"est\u00e1ndar":[0,9,2,22,12,25,20,5,15,14,16],experiencia:[7,13],midgard:[12,14,22],jsroutingbundl:3,opcion:[0,9,10,1,2,22,12,25,13,7,14],consideramo:9,altera:18,lanzarlo:[0,22],"querr\u00e1":[0,12],aqui:1,plugin:8,admin:[0,12,10,14,3],identificador:24,utilizan:16,utilizar:[0,9,10,1,2,22,24,12,25,13,5,21,15,14],etc:[9,1,14,22],sencilla:[19,21,20],grain:[],expand:7,proyecto:[0,9,1,2,22,24,5,14],ejecutar:[12,13,14,22],rama:23,escritura:[13,5],comment:[],"vendr\u00e1":0,incluirlo:[10,2],guidelin:[],doctrinebundl:14,apariencia:[0,25],proveedor:22,respect:[],tabla:[12,25],tiend:13,sonatablockbundl:[24,16,25,3],acced:[23,5],cmf_next:17,platform:[],entend:[22,15,25],redireccion:[0,2],kahw:2,trasmitir:18,compos:[0,22,10,1,2,3,25,20,5,21,16,14,11],"est\u00e9n":24,json:[0,22,10,1,11,3,25,20,8,21,14,16],immedi:[],responda:1,equipo:6,revertirlo:13,capacidad:13,filippo:2,presenc:[],empezaremo:25,expuesto:[0,10],togeth:[],general:12,podemo:1,menu_document_class:10,present:[],symfony_cmf_tree_brows:[7,3],resaltada:10,intenta:0,multi:21,default_connect:[12,25,14],solucion:[9,13],multilangstaticcont:11,empiec:14,escribir:[0,7],contentdocu:0,defin:[0,12,17,14],externo:25,contexto:2,setcontain:25,escog:[12,13,14,16],encaminamiento:2,endblock:[21,8],deben:13,layer:[],responsabilidad:2,helper:[],almost:[],alon:[],site:25,"autom\u00e1ticament":[0,10,1,25,13,21,16],movimiento:[7,13],midgard2_test:[12,14],impidan:13,incom:[],esencialment:[13,14],stksection:23,mover:[7,5],welcom:[],"\u00fatile":[0,17,2],"gen\u00e9ricament":13,"legislaci\u00f3n":18,infer:[],tiempo:[25,13],http:[22,1,11,12,25,5,21,14],"asociaci\u00f3n":[0,23,1],siempr:[24,19,10,14,5],"deber\u00eda":[22,2,25,13,5,14],supuesto:24,coffe:1,never:[],php:[0,9,10,1,11,3,12,25,13,19,20,8,5,22,14,16],asocia:23,resultado:25,profundidad:25,nevertheless:[],admin_bundle_menu_menuitem_delet:3,well:[],"manejar\u00e1":[15,2],enrutador:[0,9,10,2,19,15,16],command:[],especificado:0,english:[],"igualaci\u00f3n":2,uno:[22,1,2,24,12,25,13,5],usual:[],pdo_mysql:25,sonata:[0,9,10,3,24,25,21,7,16],less:[],symfonycmfcontentbundl:[0,12,25,16],"gesti\u00f3n":13,utilizamo:[24,1],momento:[17,7],virtual:[14,5],desarrollar:[9,1],"compilaci\u00f3n":1,especula:21,simpli:[],consola:[12,25],web:[22,1,12,18,13,20,8,5,6,15,14],comprens:1,configurast:[12,25],versionado:[13,14],personaliz:9,smith:2,quiera:14,add:[0,19,2],"distribuci\u00f3n":[18,25],dibuja:24,lookup:[],logger:[],match:2,"podr\u00eda":[0,22,23,10,24,25,13,16],candid:[],vistazo:[9,2,24,25,5,15,16],admin_bundle_content_multilangstaticcontent_cr:3,agnost:[],piec:[],symfoni:[0,9,23,10,1,2,3,22,12,25,19,20,17,24,5,21,16,15,14,11],know:[],desd:[0,22,23,10,1,2,24,12,25,19,5],somewher:[],password:[12,25,14],recurs:[],prominent:9,desarrollo:[6,22,1,9],backbon:1,separando:13,"espec\u00edficament":[0,22],necessari:[],routing_repositoryroot:0,"instalar\u00e1":5,regresar:[19,2],titl:[17,1,27,12,21,8],presentar:13,revert:[],documentada:25,necesidad:[0,9,2,22,13,14],"export":12,soport:[21,13,3],home:12,transport:12,tmp:[12,14],adicional:[0,13],est:[0,1,2,5,7,8,9,10,11,12,13,14,15,16,17,18,19,21,22,24,25,26,27],lead:[],avoid:[],devuelv:[17,1],inittre:[7,8],leav:[],esa:[0,12,21,1],stanbol_url:1,nocoffe:1,leader:[],valid_children:[4,8,3],mode:21,desacoplado:9,"p\u00f3nlo":[23,1],usan:12,realment:[24,13],pueda:[0,24,10,5],familiarizado:[25,14],usag:[],midgard_tree_nod:22,symlink:22,host:[12,25],casilla:0,asigna:0,cmf_is_publish:17,panel:3,about:[],menunam:10,cadena:[0,27,2,25],iniciando:[20,16,11,14,3],symfonycmfsimplecmsbundl:20,constructor:21,discard:[],revisa:[22,20,2],disabl:[],declaracion:2,obten:10,own:[],absolut:[],stanbol:1,automat:[],"cronol\u00f3gico":2,sustituirla:0,"relaci\u00f3n":24,banco:9,merg:17,poniendo:[12,21],van:[9,12],herramienta:[9,22],pictur:[],legibl:18,"refiri\u00e9ndot":25,registrando:14,contien:[24,15,25,5],etiquetar:24,"var":25,proporcionar:[9,10,1,11,15,12,18,13,21,7,2],explica:[12,21],"function":[22,1,11,3,25,19,20,14,8,16],vinculen:13,rastreador:6,"a\u00f1adiendo":1,multican:9,midgard2:[12,14,22],mainbundl:[22,25],inlin:[],bug:14,embargo:[24,22,15,13],made:[],recorr:0,whether:[],wish:[],cuyo:2,displai:[],recient:[22,14],descomenta:22,below:[],limit:[],tema:[13,16],otherwis:[],problem:[],acmemainbundl:15,explicacion:14,routeobjectinterfac:[0,2],cuatro:24,etapa:22,evalu:[],dure:[],filenam:[],"exportaci\u00f3n":[13,14],implement:[24,19,25],mejor:[22,1,18,25,13,14],"\u00edtem":1,probabl:[],"peque\u00f1a":1,aplic:18,directament:[0,24,12,25,5,21],traducido:12,detail:[],requieren:[22,13,5],phpcr_move:3,avanzado:25,other:[],integrars:10,futur:[],branch:[],multilanguag:[],php5:22,out:[],jmsserializerbundl:[1,11],database_nam:25,escogiendo:14,pasando:2,adaptada:9,"documentaci\u00f3n":[0,9,10,1,2,22,12,18,25,26,20,5,16,14,11],sencillament:[12,21],crecient:13,sofisticada:9,admin_sandbox_main_editablestaticcontent_delet:3,debian:22,consultado:0,experienc:[],recibido:24,"ning\u00fan":[25,9,10,2,12],persistent:13,rule:[],"misi\u00f3n":9,cookbook:[],coleccion:1,asociar:[0,1,2],enrutamiento:2},objtypes:{},titles:["RoutingExtraBundle","CreateBundle","El componente Routing","Creando un CMS con CMF y Sonata","SonataDoctrinePhpcrAdminBundle","Instalando la edici\u00f3n est\u00e1ndar del CMF de Symfony","Colaborando","TreeBrowserBundle","TreeBundle","Documentaci\u00f3n del CMF de Symfony","MenuBundle","Instalando y configurando la edici\u00f3n en l\u00ednea","DoctrinePHPCRBundle","Eligiendo una capa de almacenamiento","Instalando y configurando Doctrine y PHPCR-ODM","Informaci\u00f3n general","Instalando y configurando el n\u00facleo del CMF","CoreBundle","Licencia","Usando un repositorio de rutas personalizado con un enrutador din\u00e1mico","Instalando y configurando el SimpleCmsBundle","SimpleCmsBundle","Instalando el recinto de seguridad del CMF","Usando una clase documento personalizada asociada con PHPCR-ODM","BlockBundle","Usando BlockBundle y ContentBundle con PHPCR","ContentBundle","SearchBundle"],objnames:{},filenames:["bundles/routing-extra","bundles/create","components/routing","tutorials/creating-cms-using-cmf-and-sonata","bundles/doctrine_phpcr_admin","getting-started/installing-symfony-cmf","contributing/code","bundles/tree-browser","bundles/tree","index","bundles/menu","tutorials/installing-configuring-inline-editing","bundles/phpcr-odm","tutorials/choosing-a-storage-layer","tutorials/installing-configuring-doctrine-phpcr-odm","getting-started/overview","tutorials/installing-cmf-core","bundles/core","contributing/license","cookbook/using-a-custom-route-repository","tutorials/installing-configuring-simple-cms","bundles/simple-cms","cookbook/installing-cmf-sandbox","cookbook/phpcr-odm-custom-documentclass-mapper","bundles/block","tutorials/using-blockbundle-and-contentbundle","bundles/content","bundles/search"]}) \ No newline at end of file diff --git a/cmf/html/tutorials/choosing-a-storage-layer.html b/cmf/html/tutorials/choosing-a-storage-layer.html deleted file mode 100644 index 9344212..0000000 --- a/cmf/html/tutorials/choosing-a-storage-layer.html +++ /dev/null @@ -1,181 +0,0 @@ - - - - - - - - - - Eligiendo una capa de almacenamiento — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Eligiendo una capa de almacenamiento

                  -

                  Cuándo construyes un CMS, sin duda, la elección para la capa de almacenamiento es una de las decisiones clave a tomar. Tienes que considerar muchos factores, la buena noticia es que con todos los componentes y paquetes en el CMF nos preocupamos en proporcionar los puntos de extensión necesarios para garantizar que contamos con una capa de almacenamiento que sigue siendo agnóstica para el CMF.

                  -

                  El objetivo de esta guía es explicar las consideraciones y por qué sugerimos PHPCR y PHPCR-ODM como la base ideal para un CMS. Sin embargo, todos los componentes y paquetes se pueden integrar con otras soluciones con un muy pequeño esfuerzo.

                  -
                  -

                  Requisitos para la capa de almacenamiento de un CMS

                  -

                  Al nivel más fundamental de un CMS está el almacenamiento, por lo tanto el primer requisito de un CMS es que debe proporcionar los medios para almacenar contenido con diferentes propiedades.

                  -

                  Un CMS tiene muy diferentes necesidades de almacenamiento que por ejemplo un sistema para procesar órdenes. -Aun así observa que es enteramente posible y de hecho así se pretende que la iniciativa del CMF habilite a los desarrolladores para combinar el CMF con un sistema para procesar órdenes. Así por ejemplo, uno podría crear una solución de compra utilizando el CMF para almacenar el catalogo de productos, mientras utilizas otro sistema para mantener el inventario, datos del cliente y pedidos. Esto da lugar al segundo requisito, un CMS debe proporcionar los medios para referenciar el contenido, almacenando ambos dentro del CMS, pero también en otros sistemas.

                  -

                  El contenido real en un CMS tiende a estar organizado en una estructura de árbol, imitando un sistema de archivos. Ten en cuenta que los autores de contenido podrían querer utilizar diferentes estructuras para organizar el contenido y para organizar otros aspectos como el menú y el enrutado. -Esto nos lleva al tercer requisito, un CMS debe proporcionar los medios para representar el contenido como una estructura de árbol. -Además, un cuarto requisito es que un CMS debería permitir mantener varias estructuras de árbol independientes.

                  -

                  En general, los datos dentro de un CMS tienden a no estar estructurados. Si bien, varias páginas dentro del CMS podrían ser muy similares, hay una buena posibilidad de que habría muchas permutaciones que necesitarían diferentes campos extra, por lo tanto un CMS no tiene que aplicar un esquema singular al contenido. -Dicho esto, a fin de mantener mejor la estructura y contenido de las capas de la interfaz de usuario que genéricamente permiten la visualización de elementos de contenido, es importante ser capaz de expresar reglas opcionales que se deben seguir y que también pueden ayudar a anexar significado semántico adicional. Así que un CMS debe proporcionar los medios para opcionalmente definir elementos del esquema de contenido.

                  -

                  Este requisito en realidad también está relacionado a otra necesidad, en que un CMS debe facilitar a los autores de contenido la preparación de una serie de cambios en un entorno de ensayo que luego se tiene que enviar al sitio vivo en un solo paso. Esto significa que es otro requisito en que es necesario que un CMS debe apoyar el movimiento y exportación de contenido entre estructuras de árbol independientes. -Ten en cuenta que la exportación puede ser útil también para las copias de seguridad.

                  -

                  Al realizar cambios en ella sin embargo también sería útil poder versionar los conjuntos cambiados, de manera que permanezcan disponibles para fines históricos, pero también para poder revertirlos cuando sea necesario. Por lo tanto, el siguiente requisito es que un CMS debería proporcionar la habilidad de versionar el contenido.

                  -

                  Puesto que vivimos en un mundo globalizado, los sitios web deben ofrecer contenido en múltiples idiomas abarcando diferentes regiones. No obstante no todas las piezas del contenido se deben traducir y eventualmente sólo algunas se deberían traducir, pero hasta entonces se le debe presentar al usuario el contenido en uno de los idiomas disponibles, por lo que un CMS debería proporcionar la capacidad de almacenar el contenido en diferentes idiomas, con opcionales reglas alternativas.

                  -

                  Puesto que generalmente un CMS tiende a almacenar una creciente cantidad de contenido será necesario proporcionar alguna forma para que los usuarios busquen contenido, incluso, cuando el usuario sólo tiene una muy difusa idea sobre el contenido que está buscando, dando lugar al requisito de que un CMS debe proporcionar completa capacidad de búsqueda de texto, idealmente, aprovechando tanto la estructura del árbol de contenido como el esquema de datos.

                  -

                  Otra necesidad popular es limitar la lectura y/o escritura de contenido a usuarios o grupos específicos. Idealmente, esta solución también se podría integrar con la estructura de árbol. Por lo que debería ser útil que un CMS ofreciera funciones para definir el control de acceso que aproveche la estructura de árbol para gestionar rápidamente el acceso a subárboles completos.

                  -

                  Por último, no todos los pasos del proceso de creación de contenido los llevará a cabo la misma persona. -De hecho, puede haber múltiples pasos, todos los cuales no los debería llevar a cabo una sola persona. En cambio algunos de los pasos incluso los podría ejecutar una máquina. Así, por ejemplo un fotógrafo puede cargar una nueva imagen, un autor de contenido puede adjuntar la foto a algún texto, entonces el sistema automáticamente genera miniaturas y optimiza la interpretación en la web, y finalmente, un editor decide sobre la publicación final. Por lo tanto un CMS debe proporcionar la capacidad para ayudar en la gestión del flujo de trabajo.

                  -
                  -

                  Resumen

                  -

                  Aquí tienes un resumen de los requisitos anteriores. Ten en cuenta que algunos de los requisitos tienen un debe, mientras otros sólo tienen un debería. Evidentemente dependiendo de tu caso de uso podrías priorizar las características de manera diferente:

                  -
                    -
                  • Un CMS debe proporcionar un medio para almacenar contenido con diferentes propiedades
                    • -
                  • Un CMS debe proporcionar un medio para referirse al contenido
                    • -
                  • Un CMS debe proporcionar un medio para representar el contenido como una estructura de árbol
                    • -
                  • Un CMS debe proporcionar completa capacidad de búsqueda de texto
                    • -
                  • Un CMS no debería aplicar un esquema singular para el contenido
                    • -
                  • Un CMS debe proporcionar los medios para opcionalmente definir un esquema para elementos del contenido
                    • -
                  • Un CMS debería permitir mantener varias estructuras de árbol independientes
                    • -
                  • Un CMS debería ser compatible con el movimiento y exportación de contenido entre estructuras de árbol independientes
                    • -
                  • Un CMS debería proporcionar la habilidad para tener contenido versionado
                    • -
                  • Un CMS debería proporcionar la habilidad de almacenar contenido en diferentes idiomas, con opcionales reglas alternativas
                    • -
                  • Un CMS debe proporcionar la capacidad para definir controles de acceso
                    • -
                  • Un CMS debería proporcionar la capacidad para asistir en la administración de los flujos de trabajo
                    • -
                  -
                  -
                  -
                  -

                  RDBMS

                  -

                  Viendo los requisitos anteriores se pone de manifiesto que fuera de la caja un RDBMS es el instrumento adecuado para hacer frente a las necesidades de un CMS. Los RDBMS nunca tuvieron la intención de almacenar estructuras de árbol de contenido no estructurado. Realmente el único requisito que cubre el RDBMS de la lista anterior es la capacidad de almacenar contenido, alguna manera para hacer referencia al contenido, mantener múltiples estructuras de contenido independientes y un nivel básico de control de acceso y disparadores.

                  -

                  Este no es un defecto del RDBMS en el sentido de que fueron diseñados simplemente para un caso de uso diferente: la capacidad de almacenar, manipular y agregar datos estructurados. Esto las hace ideales para el almacenamiento de inventarios y pedidos.

                  -

                  Lo cual no quiere decir que es imposible construir un sistema en lo alto de un RDBMS que se ocupe de algunos o incluso la totalidad de los temas anteriores. Algunos RDBMS nativamente soportan consultas recursivas, lo cual puede ser útil para recuperar las estructuras de árbol. Incluso si falta tal soporte nativo, hay algoritmos como camino materializado y conjuntos anidados que pueden permitir un eficiente almacenamiento y recuperación de estructuras de árbol para diferentes casos de uso.

                  -

                  El punto es, sin embargo, que se requieren estos algoritmos y código en lo alto de un RDBMS que también se vinculen a la lógica de negocio con un determinado RDBMS y/o algoritmo, aunque algunos de ellos se pueden abstraer. Así que de nuevo usando un ORM podrías crear un sistema para gestionar las estructuras de árbol con diferentes algoritmos que impidan la unión de la lógica de negocio del CMS a un algoritmo particular.

                  -

                  Sin embargo hay que decir una vez más, que todos los paquetes y componentes del CMF se han desarrollado para aceptar cualquier API de almacenamiento persistente y damos la bienvenida a las contribuciones para agregar implementaciones para otros sistemas de almacenamiento. Así, por ejemplo actualmente RoutingExtraBundle sólo ofrece clases de documento para el ODM de PHPCR, pero las interfaces definidas en el componente de enrutado son de almacenamiento agnóstico y aceptaríamos una contribución para añadir soporte al ORM de Doctrine.

                  -
                  -
                  -

                  PHPCR

                  -

                  Esencialmente PHPCR es un conjunto de interfaces para abordar la mayoría de los requisitos de la lista anterior. -Esto significa que PHPCR es totalmente independiente del almacenamiento en el sentido de que es posible realmente poner cualquier solución de persistencia detrás de PHPCR. Así pues, en la misma forma que un ORM puede soportar diferentes algoritmos de almacenamiento de árbol a través de algún complemento, PHPCR tiene como objetivo proporcionar una API para relajar completamente las necesidades del CMS, por lo tanto separando limpiamente toda la lógica del negocio de tu CMS a causa de la elección de persistencia. Como asunto natural, la única de las características anteriores no soportada nativamente por PHPCR es el apoyo para las traducciones.

                  -

                  Gracias a la disponibilidad de varias implementaciones de PHPCR que apoyan diversos tipos de opciones de persistencia, la creación de un CMS en lo alto de PHPCR significa que los usuarios finales tienen la capacidad de escoger y elegir lo que funciona mejor para ellos, sus recursos, su experiencia y sus necesidades de escalabilidad.

                  -

                  Así que para los casos de uso más simples por ejemplo está una solución basada en el DBAL de Doctrine ofrecida por la implementación PHPCR de Jackalope que puede utilizar el RDBMS de SQLite que viene con PHP. En el otro extremo del espectro Jackalope también es compatible con Jackrabbit el cual apoya las agrupaciones y puede manejar eficientemente los datos en cientos de gigabytes. De manera predeterminada Jackrabbit simplemente utiliza el sistema de archivos para la persistencia, pero también puede utilizar un RDBMS. Sin embargo, futuras versiones apoyarán a MongoDB y otras soluciones NoSQL como CouchDB o Cassandra es totalmente posible. Una vez más, el cambio de la solución de persistencia no requerirá cambios en el código puesto que la lógica de negocio sólo va unida a las interfaces PHPCR.

                  -

                  Por favor ve Instalando y configurando Doctrine y PHPCR-ODM para más detalles sobre las implementaciones PHPCR disponibles y sus requisitos y la forma de configurar Symfony2 con una de ellas.

                  -
                  -
                  -

                  ODM de PHPCR

                  -

                  Cuando mencione arriba utilizar PHPCR no significa renunciar a un RDBMS. En muchas maneras, puedes considerar a PHPCR una solución ORM especializada para CMS. No obstante, mientras PHPCR trabaja con los así llamados nodos, en un ORM las personas esperan ser capaces de asignar instancias de clase a una capa de persistencia. Esto, exactamente es lo que proporciona el ODM de PHPCR. Sigue las mismas clases de interfaz del ORM de Doctrine al mismo tiempo que expone todas las capacidades adicionales de PHPCR, como los árboles y el versionado. Por otra parte, también ofrece soporte nativo para traducciones, que cubren la única omisión del PHPCR de la lista de requisitos para una solución de almacenamiento de un CMS mencionada anteriormente.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Instalando y configurando el núcleo del CMF

                  -

                  Próximo tema

                  -

                  Instalando y configurando Doctrine y PHPCR-ODM

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/tutorials/creating-cms-using-cmf-and-sonata.html b/cmf/html/tutorials/creating-cms-using-cmf-and-sonata.html deleted file mode 100644 index 7316d55..0000000 --- a/cmf/html/tutorials/creating-cms-using-cmf-and-sonata.html +++ /dev/null @@ -1,272 +0,0 @@ - - - - - - - - - - Creando un CMS con CMF y Sonata — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Creando un CMS con CMF y Sonata

                  -

                  El objetivo de esta guía es crear un sistema de administración de contenido sencillo que utiliza el CMF así como SonataAdminBundle y SonataDoctrinePhpcrAdminBundle.

                  - -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "sonata-project/doctrine-phpcr-admin-bundle": "1.0.*",
-}
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia los paquetes en el archivo app/AppKernel.php añadiéndolos al método registerBundles:

                  -
                  public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        // soporte para el admin
-        new Symfony\Cmf\Bundle\TreeBundle\SymfonyCmfTreeBundle(),
-        new Symfony\Cmf\Bundle\TreeBrowserBundle\SymfonyCmfTreeBrowserBundle(),
-        new Sonata\jQueryBundle\SonatajQueryBundle(),
-        new Sonata\AdminBundle\SonataAdminBundle(),
-        new Sonata\BlockBundle\SonataBlockBundle(),
-        new Sonata\DoctrinePHPCRAdminBundle\SonataDoctrinePHPCRAdminBundle(),
-        new FOS\JsRoutingBundle\FOSJsRoutingBundle(),
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  Añade los paquetes de sonata a la configuración de tu aplicación

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-sonata_block:
-    default_contexts: [cms]
-    blocks:
-        sonata.admin.block.admin_list:
-            contexts:   [admin]
-        sonata_admin_doctrine_phpcr.tree_block:
-            settings:
-                id: '/cms'
-            contexts:   [admin]
-
-sonata_admin:
-    templates:
-        # plantillas globales predefinidas
-        ajax:    SonataAdminBundle::ajax_layout.html.twig
-    dashboard:
-        blocks:
-            # muestra un bloque panel
-            - { position: right, type: sonata.admin.block.admin_list }
-            - { position: left, type: sonata_admin_doctrine_phpcr.tree_block }
-
-sonata_doctrine_phpcr_admin:
-    document_tree:
-        Doctrine\PHPCR\Odm\Document\Generic:
-            valid_children:
-                - all
-        Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page: ~
-        Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route:
-            valid_children:
-                - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route
-                - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute
-        Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute:
-            valid_children: []
-        Symfony\Cmf\Bundle\MenuBundle\Document\MenuItem:
-            valid_children:
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MenuItem
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuItem
-        Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuItem:
-            valid_children:
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MenuItem
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuItem
-
-fos_js_routing:
-    routes_to_expose:
-        - admin_sandbox_main_editablestaticcontent_create
-        - admin_sandbox_main_editablestaticcontent_delete
-        - admin_sandbox_main_editablestaticcontent_edit
-        - admin_bundle_menu_menuitem_create
-        - admin_bundle_menu_menuitem_delete
-        - admin_bundle_menu_menuitem_edit
-        - admin_bundle_menu_multilangmenuitem_create
-        - admin_bundle_menu_multilangmenuitem_delete
-        - admin_bundle_menu_multilangmenuitem_edit
-        - admin_bundle_content_multilangstaticcontent_create
-        - admin_bundle_content_multilangstaticcontent_delete
-        - admin_bundle_content_multilangstaticcontent_edit
-        - admin_bundle_routingextra_route_create
-        - admin_bundle_routingextra_route_delete
-        - admin_bundle_routingextra_route_edit
-        - admin_bundle_simplecms_page_create
-        - admin_bundle_simplecms_page_delete
-        - admin_bundle_simplecms_page_edit
-        - symfony_cmf_tree_browser.phpcr_children
-        - symfony_cmf_tree_browser.phpcr_move
-        - sonata.admin.doctrine_phpcr.phpcrodm_children
-        - sonata.admin.doctrine_phpcr.phpcrodm_move
-
                    -
                    -
                    • -
                  -
                  -

                  Añade la ruta a la configuración de enrutado:

                  -
                  -
                    -
                  • YAML
                    # app/config/routing.yml
-admin:
-    resource: '@SonataAdminBundle/Resources/config/routing/sonata_admin.xml'
-    prefix: /admin
-
-_sonata_admin:
-    resource: .
-    type: sonata_admin
-    prefix: /admin
-
-fos_js_routing:
-    resource: "@FOSJsRoutingBundle/Resources/config/routing/routing.xml"
-
-phpcrbrowser:
-    resource: @SymfonyCmfTreeBrowserBundle/Resources/config/routing/phpcrbrowser.xml
-    prefix: /admin/browser
-
-phpcrodmbrowser:
-    resource: @SonataDoctrinePHPCRAdminBundle/Resources/config/routing/phpcrodmbrowser.xml
-    prefix: /admin/browser
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Instalando y configurando la edición en línea

                  -

                  Próximo tema

                  -

                  Usando BlockBundle y ContentBundle con PHPCR

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/tutorials/installing-cmf-core.html b/cmf/html/tutorials/installing-cmf-core.html deleted file mode 100644 index 97bacae..0000000 --- a/cmf/html/tutorials/installing-cmf-core.html +++ /dev/null @@ -1,237 +0,0 @@ - - - - - - - - - - Instalando y configurando el núcleo del CMF — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando el núcleo del CMF

                  -

                  El objetivo de esta guía es instalar los componentes mínimos necesarios (el «núcleo») del CMF con la mínima configuración requerida. A partir de aquí, puedes empezar a incorporar en tu aplicación la funcionalidad del CMF que necesites.

                  -

                  Esta guía está dirigida a usuarios experimentados que quieren conocer todos los -detalles sobre el CMF de Symfony. Si este es tu primer encuentro con el CMF de Symfony es buena idea empezar con:

                  - - -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "symfony-cmf/symfony-cmf": "1.0.*"
-}
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Iniciando paquetes

                  -

                  Luego, inicia los paquetes en AppKernel.php añadiéndolos al método registerBundles:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        new Symfony\Cmf\Bundle\RoutingExtraBundle\SymfonyCmfRoutingExtraBundle(),
-        new Symfony\Cmf\Bundle\CoreBundle\SymfonyCmfCoreBundle(),
-        new Symfony\Cmf\Bundle\MenuBundle\SymfonyCmfMenuBundle(),
-        new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(),
-        new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(),
-
-        // Dependencias del SymfonyCmfMenuBundle
-        new Knp\Bundle\MenuBundle\KnpMenuBundle(),
-
-        // Dependencias del SymfonyCmfBlockBundle
-        new Sonata\BlockBundle\SonataBlockBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Esto también habilita el PHPCR-ODM y dependencias relacionadas; las instrucciones de configuración se pueden encontrar en la documentación dedicada.

                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  Para lograr que tu aplicación funcione, es muy poca la configuración necesaria.

                  -
                  -

                  Configuración mínima

                  -

                  Estos pasos son necesarios para garantizar que tu AppKernel todavía se ejecuta.

                  -

                  Si no lo has hecho ya, asegúrate de que has seguido estos pasos en Instalando y configurando Doctrine y PHPCR-ODM:

                  -
                    -
                  • Inicia el DoctrinePHPCRBundle en app/AppKernel.php
                    • -
                  • Asegúrate que hay una sección doctrine_phpcr: en app/config/config.yml
                    • -
                  • Y la línea AnnotationRegistry::registerFile en app/autoload.php
                    • -
                  -

                  Configura el BlockBundle en tu archivo config.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-sonata_block:
-    default_contexts: [cms]
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Configuración adicional

                  -

                  Puesto que la mayoría de los componentes del CMF utilizan el DynamicRouter del RoutingExtraBundle, el cual de manera predeterminada no se carga, necesitarás habilitarlo de la siguiente manera:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    chain:
-        routers_by_id:
-            symfony_cmf_routing_extra.dynamic_router: 200
-            router.default: 100
-    dynamic:
-        enabled: true
-
                    -
                    -
                    • -
                  -
                  -

                  Podrías querer configurar más en el enrutador dinámico, es decir escoger automáticamente los controladores basados en contenido. -Ve RoutingExtraBundle para detalles.

                  -

                  Por ahora esta es la única configuración que necesitamos. Dominar la configuración de los diferentes paquetes será el tema de otras guías. Si estás buscando la configuración de un paquete específico dale un vistazo al artículo del paquete correspondiente.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Información general

                  -

                  Próximo tema

                  -

                  Eligiendo una capa de almacenamiento

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/tutorials/installing-configuring-doctrine-phpcr-odm.html b/cmf/html/tutorials/installing-configuring-doctrine-phpcr-odm.html deleted file mode 100644 index 4772bef..0000000 --- a/cmf/html/tutorials/installing-configuring-doctrine-phpcr-odm.html +++ /dev/null @@ -1,350 +0,0 @@ - - - - - - - - - - Instalando y configurando Doctrine y PHPCR-ODM — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando Doctrine y PHPCR-ODM

                  -

                  El CMF de Symfony2 necesita almacenar el contenido en algún lugar. Muchos de los paquetes proporcionan documentos y asignación para el contenido del repositorio PHP — Asignación para el objeto documento (PHPCR-ODM), y la documentación que actualmente está basada en torno a la utilización de este. Aun así, también tiene que ser posible utilizar otra forma de almacenamiento para el contenido, como otro ORM/ODM o MongoDB.

                  -

                  El objetivo de esta guía es instalar y configurar Doctrina y PHPCR-ODM, listo para que empieces -con el CMF.

                  -

                  Para más detalles ve la documentación oficial de PHPCR-ODM. -Puedes encontrar alguna información adicional en el repositorio git del proyecto DoctrinePhpcrBundle, el cual mayoritariamente imita al DoctrineBundle estándar.

                  -

                  Finalmente para información sobre PHPCR ve el sitio web oficial PHPCR.

                  -
                  -

                  Requisitos previos

                  -
                    -
                  • php >= 5.3
                    • -
                  • libxml versión >= 2.7.0 (debido a un error en libxml http://bugs.php.net/bug.php?id=36501)
                    • -
                  • phpunit >= 3.6 (si quieres ejecutar las pruebas)
                    • -
                  • Symfony2 (versión 2.1.x)
                    • -
                  -
                  -
                  -

                  Instalando

                  -
                  -

                  Escogiendo un repositorio para el contenido

                  -

                  La primer cosa a decidir es qué repositorio de contenido utilizar. Un repositorio de contenido esencialmente es una base de datos que será la responsable para almacenar todo el contenido que quieras persistir. Este proporciona una API optimizada para las necesidades de un CMS (estructuras de árbol, referencias, versionado, completa búsqueda -de texto, etc.). Si bien, cada repositorio de contenido puede tener requisitos y características de rendimiento muy diferentes, la API es igual para todos ellos.

                  -

                  Además, debido a que la API define un formato de importación/exportación, siempre puedes cambiar a una -diferente implementación del repositorio de contenido más tarde.

                  -

                  Estas son las opciones disponibles:

                  -
                    -
                  • Jackalope con Jackrabbit (Jackrabbit requiere Java, este puede persistir al sistema de archivos, a una base de datos, etc.)
                    • -
                  • Jackalope con DBAL de Doctrine (requiere un RDBMS como MySQL, PostgreSQL o SQLite)
                    • -
                  • Midgard (Requiere la extensión midgard2 de PHP y un RDBMS como MySQL, PostgreSQL o SQLite)
                    • -
                  -

                  La siguiente documentación incluye ejemplos para todas las opciones de arriba.

                  -
                  -

                  Truco

                  -

                  Si justo estás empezando con el CMF, es mejor escoger un repositorio de contenido basado en un motor de almacenamiento con el cual ya estés familiarizado. Por ejemplo, Jackalope con DBAL de Doctrine trabajará con tu RDBMS existente y no requiere instalar Java o la extensión midgard2 de PHP. Una vez que tienes una aplicación trabajando debe ser fácil cambiar a otra opción.

                  -
                  -
                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json, dependiendo del repositorio de contenido que hayas escogido.

                  -
                  -
                  Jackalope con Jackrabbit
                  -
                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "jackalope/jackalope-jackrabbit": "1.0.*",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -
                  -
                  Jackalope con Doctrine DBAL
                  -
                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "jackalope/jackalope-doctrine-dbal": "dev-master",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -

                  Midgard

                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "midgard/phpcr": "dev-master",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Para todo lo anterior, si también estás utilizando el ORM de Doctrine, asegúrate de usar "doctrine/orm": "2.3.*", o de lo contrario composer no podrá resolver las dependencias cuando Doctrine dependa del PHPCR-ODM más nuevo de Doctrine 2.3. (la edición estándar de Symfony 2.1 utiliza «2.2.*».)

                  -
                  -

                  Para instalar las dependencias anteriores, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Registrando anotaciones

                  -

                  PHPCR-ODM usa anotaciones y es necesario registrarlas en tu archivo app/autoload.php. Añade la siguiente línea, inmediatamente después de la última línea AnnotationRegistry::registerFile:

                  -
                     // app/autoload.php
-
-   // ...
-AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php');
-   // ...
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia los paquetes en el archivo app/AppKernel.php añadiéndolos al método registerBundle:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        // Doctrine PHPCR
-        new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(),
-
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  El siguiente paso es configurar los paquetes.

                  -
                  -

                  Doctrine con PHPCR-ODM

                  -

                  La configuración básica para cada repositorio de contenido se muestra abajo; añade las líneas apropiadas a tu archivo app/config/config.yml. Más información sobre la configuración de este paquete se puede encontrar en la página del proyecto Doctrine PHPCR.

                  -

                  Jackalope con Jackrabbit

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: jackrabbit
-            url: http://localhost:8080/server/
-        workspace: default
-        username: admin
-        password: admin
-    odm:
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -

                  Jackalope con DBAL de Doctrine

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-        workspace: default
-        username: admin
-        password: admin
-odm:
-    auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Asegúrate también de configurar la sección principal de doctrine: al RDBMS que escogiste. -Ve Bases de datos y Doctrine.

                  -
                  -

                  Midgard

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: midgard2
-            db_type: MySQL
-            db_name: midgard2_test
-            db_host: "0.0.0.0"
-            db_port: 3306
-            db_username: ""
-            db_password: ""
-            db_init: true
-            blobdir: /tmp/cmf-blobs
-        workspace: default
-        username: admin
-        password: admin
-odm:
-    auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Configurando el repositorio de contenido

                  -

                  Jackalope Jackrabbit

                  -

                  Estos son los pasos necesarios para instalar Apache Jackrabbit:

                  - -
                  java -jar jackrabbit-standalone-*.jar
-
                  -
                  -

                  Ve a http://localhost:8080/, ahora Apache te debería mostrar una página Jackrabbit.

                  -

                  Puedes encontrar más información sobre cómo ejecutar un servidor Jackrabbit en el wiki de Jackalope.

                  -

                  Jackalope DBAL de Doctrine

                  -

                  Ejecuta las siguientes órdenes para crear la base de datos e instalar un esquema predefinido:

                  -
                  app/console doctrine:database:create
-app/console doctrine:phpcr:init:dbal
-
                  -
                  -

                  Para más información sobre cómo configurar el DBAL de Doctrine en Symfony2, ve el capítulo de Doctrine en la documentación de Symfony2 y las explicaciones en el capítulo de referencia de PHPCR.

                  -

                  Midgard

                  -

                  Midgard es una extensión C que implementa la API de PHPCR en lo alto de un RDBMS estándar.

                  -

                  Ve la documentación oficial de Midgard PHPCR.

                  -
                  -
                  -

                  Registrando tipos de nodo del sistema

                  -

                  PHPCR-ODM utiliza un tipo de nodo personalizado para dar seguimiento a la metainformación sin interferir con tu contenido. Hay una orden que hace trivial el registro de este tipo y el espacio de nombres PHPCR:

                  -
                  php app/console doctrine:phpcr:register-system-node-types
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Eligiendo una capa de almacenamiento

                  -

                  Próximo tema

                  -

                  Instalando y configurando el SimpleCmsBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/tutorials/installing-configuring-inline-editing.html b/cmf/html/tutorials/installing-configuring-inline-editing.html deleted file mode 100644 index a5db563..0000000 --- a/cmf/html/tutorials/installing-configuring-inline-editing.html +++ /dev/null @@ -1,199 +0,0 @@ - - - - - - - - - - Instalando y configurando la edición en línea — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando la edición en línea

                  -

                  El objetivo de esta guía es instalar y configurar el apoyo para la edición en línea.

                  -
                  -

                  Nota

                  -

                  Para que trabaje el CMF se requiere de Symfony 2.1 (actualmente maestro).

                  -
                  -

                  Este proporciona una solución fácil de integrar con VIE.js y create.js para proporcionar edición en línea basada en la salida de RDFa.

                  -

                  Para más información —por ahora— ve la documentación del CreateBundle

                  -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/create-bundle": "1.0.*"
-},
-"scripts": {
-    "post-install-cmd": [
-        "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules",
-        ...
-    ],
-    "post-update-cmd": [
-        "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules",
-        ...
-    ]
-},
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update symfony-cmf/create-bundle
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia los paquetes en el archivo app/AppKernel.php añadiéndolos al método registerBundles:

                  -
                  public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        new Symfony\Cmf\Bundle\CreateBundle\SymfonyCmfCreateBundle(),
-        new FOS\RestBundle\FOSRestBundle(),
-        new JMS\SerializerBundle\JMSSerializerBundle($this),
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  El siguiente paso es configurar los paquetes.

                  -

                  Configuración básica, añade lo siguiente a la configuración de tu aplicación:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_create:
-    phpcr_odm: true
-    map:
-        '<http://rdfs.org/sioc/ns#Post>': 'Symfony\Cmf\Bundle\MultilangContentBundle\Document\MultilangStaticContent'
-    image:
-        model_class: Symfony\Cmf\Bundle\CreateBundle\Document\Image
-        controller_class: Symfony\Cmf\Bundle\CreateBundle\Controller\PHPCRImageController
-
                    -
                    -
                    • -
                  -
                  -

                  Si tienes tus propios documentos, agregalos a la asignación y coloca la asignación RDFa en Resources/rdf-mappings ya sea dentro del directorio app o dentro de algún paquete. -El nombre de archivo es el nombre de clase completamente cualificado que incluye el espacio de nombres sustituyendo la barra inversa \ con un punto (.).

                  -
                  -
                  -

                  Referencia

                  -

                  Ve el CreateBundle

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Instalando y configurando el SimpleCmsBundle

                  -

                  Próximo tema

                  -

                  Creando un CMS con CMF y Sonata

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/tutorials/installing-configuring-simple-cms.html b/cmf/html/tutorials/installing-configuring-simple-cms.html deleted file mode 100644 index 91c4bbd..0000000 --- a/cmf/html/tutorials/installing-configuring-simple-cms.html +++ /dev/null @@ -1,188 +0,0 @@ - - - - - - - - - - Instalando y configurando el SimpleCmsBundle — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando el SimpleCmsBundle

                  -

                  El objetivo de esta guía es instalar y configurar un sencillo CMS con la ayuda del SimpleCmsBundle.

                  -
                  -

                  Nota

                  -

                  Para que trabaje el CMF se requiere de Symfony 2.1 (actualmente maestro).

                  -
                  -

                  El SimpleCmsBundle proporciona una solución para fácilmente asignar contenido, rutas y elementos del menú basando el repositorio de contenido en una única estructura de árbol.

                  -

                  Para más información —por ahora— ve la documentación del SymfonyCmfSimpleCmsBundle

                  -

                  Para una sencilla instalación de ejemplo del paquete revisa la Edición estándar del CMF de Symfony

                  -

                  El sitio web de CMF es -otra aplicación que utiliza el SimpleCmsBundle.

                  - -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/simple-cms-bundle": "1.0.*"
-}
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia el paquete en el archivo app/AppKernel.php añadiéndolo al método registerBundles.

                  -
                  public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        new Symfony\Cmf\Bundle\SimpleCmsBundle\SymfonyCmfSimpleCmsBundle(),
-
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  El siguiente paso es configurar los paquetes.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_simple_cms:
-    routing:
-        templates_by_class:
-            Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page:  SymfonyCmfSimpleCmsBundle:Page:index.html.twig
-
                    -
                    -
                    • -
                  -
                  -

                  Ve la referencia completa de SimpleCmsBundle.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Instalando y configurando Doctrine y PHPCR-ODM

                  -

                  Próximo tema

                  -

                  Instalando y configurando la edición en línea

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/html/tutorials/using-blockbundle-and-contentbundle.html b/cmf/html/tutorials/using-blockbundle-and-contentbundle.html deleted file mode 100644 index ae6d7d0..0000000 --- a/cmf/html/tutorials/using-blockbundle-and-contentbundle.html +++ /dev/null @@ -1,672 +0,0 @@ - - - - - - - - - - Usando BlockBundle y ContentBundle con PHPCR — Symblog - - - - - - - - - - - - - - -
                  -

                  Navegación

                  - -
                  - -
                  -
                  -
                  -
                  - -
                  -

                  Usando BlockBundle y ContentBundle con PHPCR

                  -

                  El objetivo de esta guía es demostrar cómo puedes utilizar el CMF BlockBundle y ContentBundle como componentes independientes, y mostrarte cómo complementan al PHPCR.

                  -

                  Esta guía demuestra el uso más sencillo posible, para instalarlo y ejecutarlo -rápidamente. Una vez que estés familiarizado con lo básico, la documentación en profundidad de ambos paquetes te -ayudará a adaptar estos ejemplos básicos para servir casos de uso más avanzados.

                  -

                  Empezaremos utilizando únicamente el BlockBundle, con bloques de contenido enlazados directamente al PHPCR. -Luego, introduciremos el ContentBundle para mostrarte cómo puedes representar contenido en las páginas con bloques.

                  -
                  -

                  Nota

                  -

                  A pesar de que no es un requisito utilizar BlockBundle o ContentBundle, esta guía también usa DoctrineFixturesBundle. -Esto es porque este proporciona una manera fácil de cargar algún contenido de prueba.

                  -
                  -
                  -

                  Requisitos previos

                  - -
                  -

                  Nota

                  -

                  Esta guía está basada en la utilización de PHPCR-ODM instalado con Jackalope, DBAL de Doctrine y una base de datos MySQL. Debería ser fácil adaptarlo para trabajar con una de las otras opciones PHPCR documentadas en Instalando y configurando Doctrine y PHPCR-ODM.

                  -
                  -
                  -
                  -

                  Creando y configurando la base de datos

                  -

                  Puedes utilizar una base de datos existente, o crear una ahora para ayudarte a seguir esta guía. Para una nueva base de datos, ejecuta estas órdenes en MySQL:

                  -
                  CREATE DATABASE symfony DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
-CREATE USER 'symfony'@'localhost' IDENTIFIED BY 'UseABetterPassword';
-GRANT ALL ON symfony.* TO 'symfony'@'localhost';
-
                  -
                  -

                  Tu archivo parameters.yml necesita emparejar lo anterior, por ejemplo:

                  -
                  -
                    -
                  • YAML
                    # app/config/parameters.yml
-parameters:
-    database_driver:   pdo_mysql
-    database_host:     localhost
-    database_port:     ~
-    database_name:     symfony
-    database_user:     symfony
-    database_password: UseABetterPassword
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Configurando el componente PHPCR de Doctrine

                  -
                  -

                  Nota

                  -

                  Si seguiste la guía Instalando y configurando Doctrine y PHPCR-ODM, puedes saltarte esta sección.

                  -
                  -

                  Necesitas instalar los componentes del PHPCR-ODM. Añade los siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "jackalope/jackalope-jackrabbit": "1.0.*",
-    "jackalope/jackalope-doctrine-dbal": "dev-master",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -

                  Para instalar lo anterior, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -

                  En tu archivo config.yml, añade la siguiente configuración para doctrine_phpcr:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-        workspace: default
-    odm:
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -

                  Añade la siguiente línea al método registerBundles() en el archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -

                  Añade la siguiente línea a tu archivo autoload.php, inmediatamente después de la -última línea AnnotationRegistry::registerFile:

                  -
                     // app/autoload.php
-
-   // ...
-AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php');
-   // ...
-
                  -
                  -

                  Crea el esquema de la base de datos y registra el tipo de nodo PHPCR usando las siguientes órdenes de consola:

                  -
                  php app/console doctrine:phpcr:init:dbal
-php app/console doctrine:phpcr:register-system-node-types
-
                  -
                  -

                  Ahora deberías tener una serie de tablas en tu base de datos MySQL con el prefijo phpcr_.

                  -
                  -
                  -

                  Instala los componentes necesarios del CMF de Symfony

                  -

                  Añade lo siguiente al archivo composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/block-bundle": "dev-master"
-}
-
                  -
                  -

                  Para instalar las dependencias anteriores, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -

                  Añade las siguientes líneas al archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Sonata\BlockBundle\SonataBlockBundle(),
-        new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -

                  SonataBlockBundle es una dependencia del BlockBundle de CMF y necesitas configurarlas. Añade lo siguiente a tu archivo config.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-sonata_block:
-    default_contexts: [cms]
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Instala DoctrineFixturesBundle

                  -
                  -

                  Nota

                  -

                  Como mencioné al inicio, este no es un requisito para BlockBundle o ContentBundle; No obstante, es una buena manera de manejar contenido predefinido o de ejemplo.

                  -
                  -

                  Añade lo siguiente al archivo composer.json:

                  -
                  "require": {
-    ...
-    "doctrine/doctrine-fixtures-bundle": "dev-master"
-}
-
                  -
                  -

                  Para instalar las dependencias anteriores, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -

                  Añade la siguiente línea al método registerBundles() en el archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Cargando accesorios

                  -

                  Basándote en la documentación de DoctrineFixturesBundle, necesitarás crear una clase fixtures.

                  -

                  Para empezar, crea un directorio DataFixtures dentro de tu propio paquete (p. ej. «MainBundle»), y dentro, crea un directorio llamado PHPCR. Si quieres seguir los ejemplos de más adelante, el DoctrineFixturesBundle cargará automáticamente las clases fixtures colocadas allí.

                  -

                  En el cargador de accesorios, un ejemplo de la creación de un bloque de contenido podría tener esta apariencia:

                  -
                  $myBlock = new SimpleBlock();
-$myBlock->setParentDocument($parentPage);
-$myBlock->setName('sidebarBlock');
-$myBlock->setTitle('My first block');
-$myBlock->setContent('Hello block world!');
-
-$documentManager->persist($myBlock);
-
                  -
                  -

                  Aún así, lo anterior en sí mismo no será suficiente, porque no hay ninguna página padre ($parentPage) con la cual enlazar los bloques. Hay varias posibles opciones que puedes utilizar como el padre:

                  -
                    -
                  • Enlaza los bloques directamente al documento raíz (no mostrado)
                    • -
                  • Crea un documento del paquete PHPCR (mostrado abajo usando el tipo de documento Genérico)
                    • -
                  • Crea un documento del ContentBundle del CMF (mostrado abajo utilizando el tipo de documento StaticContent)
                    • -
                  -
                  -
                  -

                  Usando el PHPCR

                  -

                  Para almacenar un bloque directamente en el PHPCR del CMF, crea la siguiente clase dentro de tu directorio DataFixtures/PHPCR:

                  -
                  <?php
-// src/Acme/MainBundle/DataFixtures/PHPCR/LoadBlockWithPhpcrParent.php
-namespace Acme\MainBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\AbstractFixture;
-use Doctrine\Common\Persistence\ObjectManager;
-use Doctrine\ODM\PHPCR\Document\Generic;
-use Symfony\Component\DependencyInjection\ContainerAwareInterface;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-use Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock;
-
-class LoadBlockWithPhpcrParent extends AbstractFixture implements ContainerAwareInterface
-{
-    public function load(ObjectManager $manager)
-    {
-        // obtiene el documento raíz desde el PHPCR
-        $rootDocument = $manager->find(null, '/');
-
-        // Crea un documento PHPCR genérico bajo la raíz, para usarlo
-        // como el tipo de categoría para los bloques
-        $document = new Generic();
-        $document->setParent($rootDocument);
-        $document->setNodename('blocks');
-        $manager->persist($document);
-
-        // Crea un nuevo SimpleBlock (ve
-        // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types)
-        $myBlock = new SimpleBlock();
-        $myBlock->setParentDocument($document);
-        $myBlock->setName('testBlock');
-        $myBlock->setTitle('CMF BlockBundle only');
-        $myBlock->setContent('Block from CMF BlockBundle, parent from the PHPCR (Generic document).');
-        $manager->persist($myBlock);
-
-        // Confirma los cambios de $document y $block a la base de datos
-        $manager->flush();
-    }
-
-    public function setContainer(ContainerInterface $container = null)
-    {
-        $this->container = $container;
-    }
-}
-
                  -
                  -

                  Esta clase carga un bloque de contenido de ejemplo que utiliza el BlockBundle de CMF (sin necesitar ningún otro paquete del CMF). Para asegurar el bloque tienes un padre en el repositorio, el cargador también crea un documento Genérico llamado 'blocks' dentro del PHPCR.

                  -

                  Ahora, carga los accesorios usando la consola:

                  -
                  php app/console doctrine:phpcr:fixtures:load
-
                  -
                  -

                  El contenido en tu base de datos ahora se tendría que ver algo así:

                  -
                  SELECT path, parent, local_name FROM phpcr_nodes;
-
                  -
                  - ----- - - - - - - - - - - - - - - - - - - - - -
                  pathparentlocal_name
                  /  
                  /blocks/blocks
                  /blocks/testBlock/ blockstestBlock
                  -
                  -
                  -

                  Usando el ContentBundle del CMF

                  -

                  Sigue este ejemplo para utilizar ambos componentes Block y Content.

                  -

                  El paquete ContentBundle también requiere del RoutingExtraBundle, así que para ahorrar tiempo puedes instalar ambos. -Añade lo siguiente al archivo composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/content-bundle": "dev-master",
-    "symfony-cmf/routing-extra-bundle": "dev-master"
-}
-
                  -
                  -

                  Instala todo de la manera habitual:

                  -
                  php composer.phar update
-
                  -
                  -

                  Añade la siguiente línea al archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -

                  Ahora deberías tener todo lo necesario para cargar una página de contenido con un bloque de ejemplo, así que crea la clase LoadBlockWithCmfParent.php:

                  -
                  <?php
-// src/Acme/Bundle/MainBundle/DataFixtures/PHPCR/LoadBlockWithCmfParent.php
-namespace Acme\MainBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\AbstractFixture;
-use Doctrine\Common\Persistence\ObjectManager;
-use Symfony\Component\DependencyInjection\ContainerAwareInterface;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-use PHPCR\Util\NodeHelper;
-use Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock;
-use Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent;
-
-class LoadBlockWithCmfParent extends AbstractFixture implements ContainerAwareInterface
-{
-    public function load(ObjectManager $manager)
-    {
-        // Obtiene el nombre de la ruta base a utilizar en la configuración
-        $session = $manager->getPhpcrSession();
-        $basepath = $this->container->getParameter('symfony_cmf_content.static_basepath');
-
-        // Crea la ruta en el repositorio
-        NodeHelper::createPath($session, $basepath);
-
-        // Crea un nuevo documento que utiliza StaticContent de ContentBundle del CMF
-        $document = new StaticContent();
-        $document->setPath($basepath . '/blocks');
-        $manager->persist($document);
-
-        // Crea un nuevo SimpleBlock (ve
-        // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types)
-        $myBlock = new SimpleBlock();
-        $myBlock->setParentDocument($document);
-        $myBlock->setName('testBlock');
-        $myBlock->setTitle('CMF BlockBundle and ContentBundle');
-        $myBlock->setContent('Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent).');
-        $manager->persist($myBlock);
-
-        // Confirma los cambios de $document y $block a la base de datos
-        $manager->flush();
-    }
-
-    public function setContainer(ContainerInterface $container = null)
-    {
-        $this->container = $container;
-    }
-}
-
                  -
                  -

                  Esta clase crea una página de contenido de ejemplo que utiliza el ContentBundle del CMF. Luego, carga el bloque de ejemplo como antes, usando la nueva página de contenido como su padre.

                  -

                  De manera predeterminada, la ruta base para el contenido es /cms/content/static. Para mostrar cómo lo puedes configurar a cualquier ruta, añade la siguiente entrada opcional a tu archivo config.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_content:
-    static_basepath: /content
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora deberías poder cargar los accesorios anteriores:

                  -
                  php app/console doctrine:phpcr:fixtures:load
-
                  -
                  -

                  Todo va sobre ruedas, el contenido en tu base de datos se tendría que ver algo así (si también seguiste el ejemplo LoadBlockWithPhpcrParent, todavía deberías tener dos entradas /blocks también):

                  -
                  SELECT path, parent, local_name FROM phpcr_nodes;
-
                  -
                  - ----- - - - - - - - - - - - - - - - - - - - - - - - - -
                  pathparentlocal_name
                  /  
                  /content/content
                  /content/blocks/contentblocks
                  /content/blocks/testBlock/content/blockstestBlock
                  -
                  -
                  -

                  Dibujando los bloques

                  -

                  Esto lo maneja el BlockBundle de Sonata. sonata_block_render ya está registrado como extensión de Twig al incluir SonataBlockBundle en el archivo AppKernel.php. Por lo tanto, puedes dibujar cualquier bloque dentro de cualquier plantilla simplemente refiriéndote a su ruta.

                  -

                  El siguiente código muestra el resultado de ambas instancias de los bloques testBlock de los ejemplos anteriores. -Si sólo seguiste uno de los ejemplos, asegúrate de incluir únicamente ese bloque:

                  -
                  {# src/Acme/Bundle/MainBundle/resources/views/Default/index.html.twig #}
-
-{# Incluye esto si seguiste el ejemplo BlockBundle con PHPCR #}
-{{ sonata_block_render({
-    'name': '/blocks/testBlock'
-}) }}
-
-{# incluye esto si seguiste el ejemplo BlockBundle con ContentBundle #}
-{{ sonata_block_render({
-    'name': '/content/blocks/testBlock'
-}) }}
-
                  -
                  -

                  Ahora tu página index debería mostrar lo siguiente (suponiendo que seguiste ambos ejemplos):

                  -
                  CMF BlockBundle only
-Block from CMF BlockBundle, parent from the PHPCR (Generic document).
-
-CMF BlockBundle and ContentBundle
-Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent).
-
                  -
                  -
                  -
                  -

                  Siguientes pasos

                  -

                  Ahora deberías estar listo para usar en tu aplicación el BlockBundle y/o el ContentBundle, o para explorar los otros paquetes disponibles en el CMF.

                  - -
                  -
                  -

                  Solucionando problemas

                  -

                  Si tienes problemas, posiblemente sea más fácil empezar con una instalación de Symfony2 fresca. También puedes probar ejecutando y modificando el código en el ejemplo externo del recinto de seguridad del bloque del CMF.

                  -

                  Configuración de Doctrine

                  -

                  Si empezaste con la distribución estándar de Symfony2 (versión 2.1.x), ya deberías tener correctamente configurado tu archivo config.yml. Si no, inténtalo usando la siguiente sección:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine:
-    dbal:
-        driver:   "%database_driver%"
-        host:     "%database_host%"
-        port:     "%database_port%"
-        dbname:   "%database_name%"
-        user:     "%database_user%"
-        password: "%database_password%"
-        charset:  UTF8
-    orm:
-        auto_generate_proxy_classes: "%kernel.debug%"
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -

                  “Ninguna orden definida” al cargar accesorios

                  -
                  [InvalidArgumentException]
-No hay ninguna orden definida en el espacio de nombres ``doctrine:phpcr:fixtures``.
-
                  -
                  -

                  Asegúrate de que tu archivo AppKernel.php contiene las siguientes líneas:

                  -
                  new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(),
-new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(),
-
                  -
                  -

                  “No configuraste una sesión”

                  -
                  [InvalidArgumentException]
-No configuraste una sesión para los gestores de documento
-
                  -
                  -

                  Asegúrate de que tienes lo siguiente en tu archivo app/config.yml:

                  -
                  -
                    -
                  • YAML
                    doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-        workspace: default
-    odm:
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -

                  “La anotación no existe”

                  -
                  [Doctrine\Common\Annotations\AnnotationException]
-[Error semántico] La anotación «@Doctrine\ODM\PHPCR\Mapping\Annotations\Document» en la clase «Doctrine\ODM\PHPCR\Document\Generic» no existe, o no se puede cargar automáticamente.
-
                  -
                  -

                  Asegúrate de añadir esta línea a tu archivo app/autoload.php (inmediatamente después de la línea AnnotationRegistry::registerLoader):

                  -
                  AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php');
-
                  -
                  -

                  no se encuentra la clase SimpleBlock

                  -
                  [Doctrine\Common\Persistence\Mapping\MappingException]
-La clase 'Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock' no se encuentra en la cadena de espacios de nombres configurada Doctrine\ODM\PHPCR\Document, Sonata\UserBundle\Document, FOS\UserBundle\Document
-
                  -
                  -

                  Asegúrate de que está instalado el BlockBundle del CMF y de que se carga en el archivo app/AppKernel.php:

                  -
                  new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(),
-
                  -
                  -

                  No se encuentra la RouteAwareInterface

                  -
                  Error fatal: No se encuentra la interfaz 'Symfony\Cmf\Component\Routing\RouteAwareInterface' en /var/www/your-site/vendor/symfony-cmf/content-bundle/Symfony/Cmf/Bundle/ContentBundle/Document/StaticContent.php en la línea 15
-
                  -
                  -

                  Si estás utilizando el ContentBundle, asegúrate de instalar el RoutingExtraBundle, también:

                  -
                  // composer.json
-"symfony-cmf/routing-extra-bundle": "dev-master"
-
                  -
                  -

                  ...e instala:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  -

                  Contenidos

                  - - -

                  Tema anterior

                  -

                  Creando un CMS con CMF y Sonata

                  -

                  Próximo tema

                  -

                  BlockBundle

                  - - -
                  -
                  -
                  -
                  -
                  -

                  Navegación

                  - -
                  -
                  - © Copyright 2012, Comunidad CMF de Symfony Traducido al español por Nacho Pacheco. - Creado con Sphinx 1.1.3. -
                  - - \ No newline at end of file diff --git a/cmf/index.html b/cmf/index.html deleted file mode 100644 index f5a92a2..0000000 --- a/cmf/index.html +++ /dev/null @@ -1,233 +0,0 @@ - - - - - - - Documentación del CMF de Symfony — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Documentación del CMF de Symfony

                  -

                  Bienvenido a la documentación oficial del Symfony Content Management Framework (CMF en adelante).

                  -

                  El proyecto CMF de Symfony2 está organizado por la comunidad de Symfony y cuenta con muchas compañías patrocinadoras y prominentes líderes del código abierto que implementan la filosofía del CMS desacoplado. Puedes leer y aprender más del proyecto en su página de información.

                  -

                  Esta documentación actualmente está en desarrollo y todavía muy lejos de completarse. Ve planificación de la documentación para un vistazo general del trabajo que falta hacer. ¿Quieres ayudar? ¡Gracias, toda ayuda es muy apreciada! -La fuente de la documentación está alojada en github.

                  -
                  -

                  Declaración de misión

                  -
                  -
                  El proyecto CMF de Symfony facilita a los desarrolladores la adición de funcionalidad CMS a sus aplicaciones construidas con la plataforma Symfony2 de PHP. Los principios de desarrollo clave para el conjunto de paquetes proporcionados son la escalabilidad, usabilidad, documentación y un completo banco de pruebas.
                  -
                  -
                  -

                  ¿Por qué otro CMS?

                  -

                  De hecho, consideramos que este proyecto es un CMF (por content management framework) un marco para gestionar contenido, más que -un CMS (sistema de administración de contenido). La razón es que sólo estamos proporcionando herramientas para construir un CMS personalizado. Evidentemente hoy día existen muchas soluciones CMS disponibles, pero tienden a ser adaptadas en primer lugar hacia usuarios finales y también muchas tienden -a llevar mucho equipaje delegado que las hace menos que ideales para desarrollar aplicaciones altamente personalizables tal como es posible con Symfony2.

                  -
                  -
                  -

                  ¿A quién está dirigido?

                  -

                  Básicamente hay dos audiencias principales:

                  -
                    -
                  1. Developers that have built an existing custom application with Symfony2 and need a fast -way to add support for content management. Be it sophisticated CMS features like semantic -content, inline editing, multi-channel delivery etc. or just a few content pages for things -like the about/contact pages.
                    2. -
                  2. Developers that need to build a highly customized authoring and content delivery -solution that no out-of-the-box CMS can properly provide through customization alone.
                    3. -
                  -
                  -
                  -

                  Cómo empezar

                  -

                  ¿Empiezas a conocer el CMF? ¿Quieres saber si el CMF es adecuado para tu proyecto? Comienza aquí.

                  -
                  - -
                  -
                  - -
                  -

                  Paquetes

                  -

                  ¿Buscando algúna información detallada sobre un paquete del CMF? ¿Quieres una lista de todas las opciones de configuración de un paquete? ¿Quiere saber si puedes utilizar un paquete independientemente y cómo hacerlo? En este caso la referencia es el sitio ideal para ti.

                  -
                  - -
                  -
                  - -
                  -

                  Componentes

                  -

                  ¿Buscando alguna información sobre los componentes de bajo nivel del CMF?

                  -
                  - -
                  -
                  -
                  -

                  Colaborando

                  -
                  - -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/choosing-a-storage-layer.html b/cmf/tutorials/choosing-a-storage-layer.html deleted file mode 100644 index cb51242..0000000 --- a/cmf/tutorials/choosing-a-storage-layer.html +++ /dev/null @@ -1,190 +0,0 @@ - - - - - - - Eligiendo una capa de almacenamiento — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Eligiendo una capa de almacenamiento

                  -

                  Cuándo construyes un CMS, sin duda, la elección para la capa de almacenamiento es una de las decisiones clave a tomar. Tienes que considerar muchos factores, la buena noticia es que con todos los componentes y paquetes en el CMF nos preocupamos en proporcionar los puntos de extensión necesarios para garantizar que contamos con una capa de almacenamiento que sigue siendo agnóstica para el CMF.

                  -

                  El objetivo de esta guía es explicar las consideraciones y por qué sugerimos PHPCR y PHPCR-ODM como la base ideal para un CMS. Sin embargo, todos los componentes y paquetes se pueden integrar con otras soluciones con un muy pequeño esfuerzo.

                  -
                  -

                  Requisitos para la capa de almacenamiento de un CMS

                  -

                  Al nivel más fundamental de un CMS está el almacenamiento, por lo tanto el primer requisito de un CMS es que debe proporcionar los medios para almacenar contenido con diferentes propiedades.

                  -

                  Un CMS tiene muy diferentes necesidades de almacenamiento que por ejemplo un sistema para procesar órdenes. -Aun así observa que es enteramente posible y de hecho así se pretende que la iniciativa del CMF habilite a los desarrolladores para combinar el CMF con un sistema para procesar órdenes. Así por ejemplo, uno podría crear una solución de compra utilizando el CMF para almacenar el catalogo de productos, mientras utilizas otro sistema para mantener el inventario, datos del cliente y pedidos. Esto da lugar al segundo requisito, un CMS debe proporcionar los medios para referenciar el contenido, almacenando ambos dentro del CMS, pero también en otros sistemas.

                  -

                  El contenido real en un CMS tiende a estar organizado en una estructura de árbol, imitando un sistema de archivos. Ten en cuenta que los autores de contenido podrían querer utilizar diferentes estructuras para organizar el contenido y para organizar otros aspectos como el menú y el enrutado. -Esto nos lleva al tercer requisito, un CMS debe proporcionar los medios para representar el contenido como una estructura de árbol. -Además, un cuarto requisito es que un CMS debería permitir mantener varias estructuras de árbol independientes.

                  -

                  En general, los datos dentro de un CMS tienden a no estar estructurados. Si bien, varias páginas dentro del CMS podrían ser muy similares, hay una buena posibilidad de que habría muchas permutaciones que necesitarían diferentes campos extra, por lo tanto un CMS no tiene que aplicar un esquema singular al contenido. -Dicho esto, a fin de mantener mejor la estructura y contenido de las capas de la interfaz de usuario que genéricamente permiten la visualización de elementos de contenido, es importante ser capaz de expresar reglas opcionales que se deben seguir y que también pueden ayudar a anexar significado semántico adicional. Así que un CMS debe proporcionar los medios para opcionalmente definir elementos del esquema de contenido.

                  -

                  Este requisito en realidad también está relacionado a otra necesidad, en que un CMS debe facilitar a los autores de contenido la preparación de una serie de cambios en un entorno de ensayo que luego se tiene que enviar al sitio vivo en un solo paso. Esto significa que es otro requisito en que es necesario que un CMS debe apoyar el movimiento y exportación de contenido entre estructuras de árbol independientes. -Ten en cuenta que la exportación puede ser útil también para las copias de seguridad.

                  -

                  Al realizar cambios en ella sin embargo también sería útil poder versionar los conjuntos cambiados, de manera que permanezcan disponibles para fines históricos, pero también para poder revertirlos cuando sea necesario. Por lo tanto, el siguiente requisito es que un CMS debería proporcionar la habilidad de versionar el contenido.

                  -

                  Puesto que vivimos en un mundo globalizado, los sitios web deben ofrecer contenido en múltiples idiomas abarcando diferentes regiones. No obstante no todas las piezas del contenido se deben traducir y eventualmente sólo algunas se deberían traducir, pero hasta entonces se le debe presentar al usuario el contenido en uno de los idiomas disponibles, por lo que un CMS debería proporcionar la capacidad de almacenar el contenido en diferentes idiomas, con opcionales reglas alternativas.

                  -

                  Puesto que generalmente un CMS tiende a almacenar una creciente cantidad de contenido será necesario proporcionar alguna forma para que los usuarios busquen contenido, incluso, cuando el usuario sólo tiene una muy difusa idea sobre el contenido que está buscando, dando lugar al requisito de que un CMS debe proporcionar completa capacidad de búsqueda de texto, idealmente, aprovechando tanto la estructura del árbol de contenido como el esquema de datos.

                  -

                  Otra necesidad popular es limitar la lectura y/o escritura de contenido a usuarios o grupos específicos. Idealmente, esta solución también se podría integrar con la estructura de árbol. Por lo que debería ser útil que un CMS ofreciera funciones para definir el control de acceso que aproveche la estructura de árbol para gestionar rápidamente el acceso a subárboles completos.

                  -

                  Por último, no todos los pasos del proceso de creación de contenido los llevará a cabo la misma persona. -De hecho, puede haber múltiples pasos, todos los cuales no los debería llevar a cabo una sola persona. En cambio algunos de los pasos incluso los podría ejecutar una máquina. Así, por ejemplo un fotógrafo puede cargar una nueva imagen, un autor de contenido puede adjuntar la foto a algún texto, entonces el sistema automáticamente genera miniaturas y optimiza la interpretación en la web, y finalmente, un editor decide sobre la publicación final. Por lo tanto un CMS debe proporcionar la capacidad para ayudar en la gestión del flujo de trabajo.

                  -
                  -

                  Resumen

                  -

                  Aquí tienes un resumen de los requisitos anteriores. Ten en cuenta que algunos de los requisitos tienen un debe, mientras otros sólo tienen un debería. Evidentemente dependiendo de tu caso de uso podrías priorizar las características de manera diferente:

                  -
                    -
                  • Un CMS debe proporcionar un medio para almacenar contenido con diferentes propiedades
                    • -
                  • Un CMS debe proporcionar un medio para referirse al contenido
                    • -
                  • Un CMS debe proporcionar medio para representar el contenido como una estructura de árbol
                    • -
                  • Un CMS debe proporcionar completa capacidad de búsqueda de texto
                    • -
                  • Un CMS no debería aplicar un esquema singular para el contenido
                    • -
                  • Un CMS debe proporcionar los medios para opcionalmente definir un esquema para elementos del contenido
                    • -
                  • Un CMS debería permitir mantener varias estructuras de árbol independientes
                    • -
                  • Un CMS debería ser compatible con el movimiento y exportación de contenido entre estructuras de árbol independientes
                    • -
                  • Un CMS debería proporcionar la habilidad para tener contenido versionado
                    • -
                  • Un CMS debería proporcionar la habilidad de almacenar contenido en diferentes idiomas, con opcionales reglas alternativas
                    • -
                  • Un CMS debe proporcionar la capacidad para definir controles de acceso
                    • -
                  • Un CMS debería proporcionar la capacidad para asistir en la administración de los flujos de trabajo
                    • -
                  -
                  -
                  -
                  -

                  RDBMS

                  -

                  Viendo los requisitos anteriores se pone de manifiesto que fuera de la caja un RDBMS es el instrumento adecuado para hacer frente a las necesidades de un CMS. Los RDBMS nunca tuvieron la intención de almacenar estructuras de árbol de contenido no estructurado. Realmente el único requisito que cubre el RDBMS de la lista anterior es la capacidad de almacenar contenido, alguna manera para hacer referencia al contenido, mantener múltiples estructuras de contenido independientes y un nivel básico de control de acceso y disparadores.

                  -

                  Este no es un defecto del RDBMS en el sentido de que fueron diseñados simplemente para un caso de uso diferente: la capacidad de almacenar, manipular y agregar datos estructurados. Esto las hace ideales para el almacenamiento de inventarios y pedidos.

                  -

                  Lo cual no quiere decir que es imposible construir un sistema en lo alto de un RDBMS que se ocupe de algunos o incluso la totalidad de los temas anteriores. Algunos RDBMS nativamente soportan consultas recursivas, lo cual puede ser útil para recuperar las estructuras de árbol. Incluso si falta tal soporte nativo, hay algoritmos como camino materializado y conjuntos anidados que pueden permitir un eficiente almacenamiento y recuperación de estructuras de árbol para diferentes casos de uso.

                  -

                  El punto es, sin embargo, que se requieren estos algoritmos y código en lo alto de un RDBMS que también se vinculen a la lógica de negocio con un determinado RDBMS y/o algoritmo, aunque algunos de ellos se pueden abstraer. Así que de nuevo usando un ORM podrías crear un sistema para gestionar las estructuras de árbol con diferentes algoritmos que impidan la unión de la lógica de negocio del CMS a un algoritmo particular.

                  -

                  Sin embargo hay que decir una vez más, que todos los paquetes y componentes del CMF se han desarrollado para aceptar cualquier API de almacenamiento persistente y damos la bienvenida a las contribuciones para agregar implementaciones para otros sistemas de almacenamiento. Así, por ejemplo actualmente RoutingExtraBundle sólo ofrece clases de documento para el ODM de PHPCR, pero las interfaces definidas en el componente de enrutado son de almacenamiento agnóstico y aceptaríamos una contribución para añadir soporte al ORM de Doctrine.

                  -
                  -
                  -

                  PHPCR

                  -

                  Esencialmente PHPCR es un conjunto de interfaces para abordar la mayoría de los requisitos de la lista anterior. -Esto significa que PHPCR es totalmente independiente del almacenamiento en el sentido de que es posible realmente poner cualquier solución de persistencia detrás de PHPCR. Así pues, en la misma forma que un ORM puede soportar diferentes algoritmos de almacenamiento de árbol a través de algún complemento, PHPCR tiene como objetivo proporcionar una API para relajar completamente las necesidades del CMS, por lo tanto separando limpiamente toda la lógica del negocio de tu CMS a causa de la elección de persistencia. Como asunto natural, la única de las características anteriores no soportada nativamente por PHPCR es el apoyo para las traducciones.

                  -

                  Gracias a la disponibilidad de varias implementaciones de PHPCR que apoyan diversos tipos de opciones de persistencia, la creación de un CMS en lo alto de PHPCR significa que los usuarios finales tienen la capacidad de escoger y elegir lo que funciona mejor para ellos, sus recursos, su experiencia y sus necesidades de escalabilidad.

                  -

                  Así que para los casos de uso más simples por ejemplo está una solución basada en el DBAL de Doctrine ofrecida por la implementación PHPCR de Jackalope que puede utilizar el RDBMS de SQLite que viene con PHP. En el otro extremo del espectro Jackalope también es compatible con Jackrabbit el cual apoya las agrupaciones y puede manejar eficientemente los datos en cientos de gigabytes. De manera predeterminada Jackrabbit simplemente utiliza el sistema de archivos para la persistencia, pero también puede utilizar un RDBMS. Sin embargo, futuras versiones apoyarán a MongoDB y otras soluciones NoSQL como CouchDB o Cassandra es totalmente posible. Una vez más, el cambio de la solución de persistencia no requerirá cambios en el código puesto que la lógica de negocio sólo va unida a las interfaces PHPCR.

                  -

                  Por favor ve Instalando y configurando Doctrine y PHPCR-ODM para más detalles sobre las implementaciones PHPCR disponibles y sus requisitos y la forma de configurar Symfony2 con una de ellas.

                  -
                  -
                  -

                  ODM de PHPCR

                  -

                  Cuando mencione arriba utilizar PHPCR no significa renunciar a un RDBMS. En muchas maneras, puedes considerar a PHPCR una solución ORM especializada para CMS. No obstante, mientras PHPCR trabaja con los así llamados nodos, en un ORM las personas esperan ser capaces de asignar instancias de clase a una capa de persistencia. Esto, exactamente es lo que proporciona el ODM de PHPCR. Sigue las mismas clases de interfaz del ORM de Doctrine al mismo tiempo que expone todas las capacidades adicionales de PHPCR, como los árboles y el versionado. Por otra parte, también ofrece soporte nativo para traducciones, que cubren la única omisión del PHPCR de la lista de requisitos para una solución de almacenamiento de un CMS mencionada anteriormente.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/creating-cms-using-cmf-and-sonata.html b/cmf/tutorials/creating-cms-using-cmf-and-sonata.html deleted file mode 100644 index 89845b0..0000000 --- a/cmf/tutorials/creating-cms-using-cmf-and-sonata.html +++ /dev/null @@ -1,340 +0,0 @@ - - - - - - - Creando un CMS con CMF y Sonata — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Creando un CMS con CMF y Sonata

                  -

                  El objetivo de esta guía es crear un sistema de administración de contenido sencillo que utiliza el CMF así como SonataAdminBundle y SonataDoctrinePhpcrAdminBundle.

                  -
                  -

                  Requisitos previos

                  - -
                  -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "sonata-project/doctrine-phpcr-admin-bundle": "1.0.*",
-}
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia los paquetes en el archivo app/AppKernel.php añadiéndolos al método registerBundles:

                  -
                  public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        // soporte para la administración
-        new Symfony\Cmf\Bundle\TreeBrowserBundle\SymfonyCmfTreeBrowserBundle(),
-        new Sonata\jQueryBundle\SonatajQueryBundle(),
-        new Sonata\BlockBundle\SonataBlockBundle(),
-        new Sonata\AdminBundle\SonataAdminBundle(),
-        new Sonata\DoctrinePHPCRAdminBundle\SonataDoctrinePHPCRAdminBundle(),
-        new FOS\JsRoutingBundle\FOSJsRoutingBundle(),
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  Añade los paquetes de sonata a la configuración de tu aplicación

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-sonata_block:
-    default_contexts: [cms]
-    blocks:
-        sonata.admin.block.admin_list:
-            contexts:   [admin]
-        sonata_admin_doctrine_phpcr.tree_block:
-            settings:
-                id: '/cms'
-            contexts:   [admin]
-
-sonata_admin:
-    templates:
-        # plantillas globales predefinidas
-        ajax:    SonataAdminBundle::ajax_layout.html.twig
-    dashboard:
-        blocks:
-            # muestra un bloque panel
-            - { position: right, type: sonata.admin.block.admin_list }
-            - { position: left, type: sonata_admin_doctrine_phpcr.tree_block }
-
-sonata_doctrine_phpcr_admin:
-    document_tree:
-        Doctrine\ODM\PHPCR\Document\Generic:
-            valid_children:
-                - all
-        Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page: ~
-        Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route:
-            valid_children:
-                - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\Route
-                - Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute
-        Symfony\Cmf\Bundle\RoutingExtraBundle\Document\RedirectRoute:
-            valid_children: []
-        Symfony\Cmf\Bundle\MenuBundle\Document\MenuNode:
-            valid_children:
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MenuNode
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuNode
-        Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuNode:
-            valid_children:
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MenuNode
-                - Symfony\Cmf\Bundle\MenuBundle\Document\MultilangMenuNode
-
-fos_js_routing:
-    routes_to_expose:
-        - admin_sandbox_main_editablestaticcontent_create
-        - admin_sandbox_main_editablestaticcontent_delete
-        - admin_sandbox_main_editablestaticcontent_edit
-        - admin_bundle_menu_menunode_create
-        - admin_bundle_menu_menunode_delete
-        - admin_bundle_menu_menunode_edit
-        - admin_bundle_menu_multilangmenunode_create
-        - admin_bundle_menu_multilangmenunode_delete
-        - admin_bundle_menu_multilangmenunode_edit
-        - admin_bundle_content_multilangstaticcontent_create
-        - admin_bundle_content_multilangstaticcontent_delete
-        - admin_bundle_content_multilangstaticcontent_edit
-        - admin_bundle_routingextra_route_create
-        - admin_bundle_routingextra_route_delete
-        - admin_bundle_routingextra_route_edit
-        - admin_bundle_simplecms_page_create
-        - admin_bundle_simplecms_page_delete
-        - admin_bundle_simplecms_page_edit
-        - symfony_cmf_tree_browser.phpcr_children
-        - symfony_cmf_tree_browser.phpcr_move
-        - sonata.admin.doctrine_phpcr.phpcrodm_children
-        - sonata.admin.doctrine_phpcr.phpcrodm_move
-
                    -
                    -
                    • -
                  -
                  -

                  Añade la ruta a la configuración de enrutado:

                  -
                  -
                    -
                  • YAML
                    # app/config/routing.yml
-admin:
-    resource: '@SonataAdminBundle/Resources/config/routing/sonata_admin.xml'
-    prefix: /admin
-
-sonata_admin:
-    resource: .
-    type: sonata_admin
-    prefix: /admin
-
-doctrine_phpcr_admin_bundle_odm_browser:
-    resource: "@SonataDoctrinePHPCRAdminBundle/Resources/config/routing/phpcrodmbrowser.xml"
-
-fos_js_routing:
-    resource: "@FOSJsRoutingBundle/Resources/config/routing/routing.xml"
-
-symfony_cmf_tree:
-    resource: .
-    type: 'symfony_cmf_tree'
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Activos de Sonata

                  -
                  app/console assets:install --symlink
-
                  -
                  -
                  -
                  -

                  Defining own Admin classes

                  -

                  The CMF bundles come with predefined admin classes which will be activated -automatically if Sonata PHPCR-ODM Admin is loaded. If you need to write -different admins and do not want to load the defaults, you can deactivate the -loading - see the documentation of the respective bundles.

                  -

                  To load your own Admin service, you need to declare it as a service, tag with -sonata.admin with manager_type="doctrine_phpcr". For the admin to work -properly, you need to add a call for method setRouteBuilder to set it to -the service sonata.admin.route.path_info_slashes, or your Admin will not -work.

                  -

                  The constructor expects three arguments, code, document class and controller -name. You can pass an empty argument for the code, the document class must be -the fully qualified class name of the document this admin is for and the third -argument can be used to set a custom controller that does additional operations -over the default sonata CRUD controller.

                  -
                  -
                    -
                  • XML
                    <service id="my_bundle.admin" class="%my_bundle.admin_class%">
-    <tag name="sonata.admin" manager_type="doctrine_phpcr" group="dashboard.group_content" label_catalogue="MyBundle" label="dashboard.label_my_admin" label_translator_strategy="sonata.admin.label.strategy.underscore" />
-    <argument/>
-    <argument>%my_bundle.document_class%</argument>
-    <argument>SonataAdminBundle:CRUD</argument>
-
-    <call method="setRouteBuilder">
-        <argument type="service" id="sonata.admin.route.path_info_slashes" />
-    </call>
-</service>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Finalmente

                  -

                  Ahora Sonata está configurado para trabajar con PHPCR, puedes acceder al panel vía /admin/dashboard de tu sitio.

                  -
                  -
                  -

                  Tree Problems

                  -

                  If you have not yet added anything to the content repository, the tree view will not load as it -cannot find a root node. To fix this, load some data as fixtures by following this doc:

                  - -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/handling-multilang-documents.html b/cmf/tutorials/handling-multilang-documents.html deleted file mode 100644 index d1deb74..0000000 --- a/cmf/tutorials/handling-multilang-documents.html +++ /dev/null @@ -1,313 +0,0 @@ - - - - - - - Gestionando documentos multilingües — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Gestionando documentos multilingües

                  -

                  The goal of the tutorial is to describe all the steps that are needed -to be taken to use multi-language documents as clearly as possible.

                  -
                  -

                  Por favor, primero lee esto

                  - -
                  -
                  -

                  Lunetics LocaleBundle

                  -

                  The CMF recommends to rely on the LuneticsLocaleBundle -to handle initial locale selection when a user first visits the site, -and to provide a locale switcher.

                  -

                  To install the bundle, require it in your project with ./composer.phar require lunetics/locale-bundle -and then instantiate Lunetics\LocaleBundle\LuneticsLocaleBundle in your AppKernel.php.

                  -

                  You also need the intl php extension installed and enabled. (Otherwise -composer will tell you it can’t find ext-intl.) If you get issues that some -locales can not be loaded, have a look at this discussion about ICU.

                  -

                  Then configure it in the main application configuration file. As -there are several CMF bundles wanting the list of allowed locales, -we recommend putting them into a parameter %locales%, see the -cmf-sandbox config.yml file for an example.

                  -
                  -

                  Truco

                  -

                  Whenever you do a sub-request, for example to call a controller from a twig -template, do not forget to pass the app.request.locale along or you will -lose the request locale and fall back to the default. -See for example the action to include the create.js javascript files in the -create.js reference.

                  -
                  -
                  -
                  -

                  PHPCR-ODM multi-language Documents

                  -

                  You can mark any properties as being translatable and have the document manager -store and load the correct language for you. Note that translation always happens -on a document level, not on the individual translatable fields.

                  -
                  <?php
-/**
- * @PHPCRODM\Document(translator="attribute")
- */
-class MyPersistentClass
-{
-    /**
-     * Translated property
-     * @String(translated=true)
-     */
-    private $topic;
-
                  -
                  -

                  Read more about multi-language documents in the PHPCR-ODM documentation on multi-language -and see Configuración de traducción to configure PHPCR-ODM correctly.

                  -

                  Most of the CMF bundles provide multi-language documents, for example MultilangStaticContent, -MultilangMenuNode or MultilangSimpleBlock. The routing is different, as explained in the next -section.

                  -
                  -
                  -

                  Enrutado

                  -

                  The DynamicRouter uses a route source to get routes that could match a -request. The concept of the default PHPCR-ODM source is to map the request URL -onto an id, which in PHPCR terms is the repository path to a node. This -allows for a very efficient lookup without needing a full search over the -repository. But a PHPCR node has exactly one path, therefore we need a separate -route document for each locale. The cool thing with this is that we can localize -the URL for each language. Simply create one route document per locale, and -set a default value for _locale to point to the locale of that route.

                  -

                  As all routes point to the same content, the route generator can handle picking -the correct route for you when you generate the route from the content. -See also ContentAwareGenerator y regiones.

                  -
                  -
                  -

                  Sonata PHPCR-ODM Admin

                  -

                  This section explains how to make Sonata Admin handle multi-language documents. You should -already have set up Sonata PHPCR-ODM Admin and understand how it works, see -Creating a CMS using the CMF and Sonata.

                  -
                  -

                  Nota

                  -

                  The following assumes that you installed the LuneticsLocaleBundle as explained above. -If you want to use something else or write your own locale handling, first think if -it would not make sense to give the Lunetics bundle a try. If you are still convinced -you will need to adapt the following template examples to your way of building a -locale switcher.

                  -
                  -

                  The first step is to configure sonata admin. We are going to place the LuneticsLocaleBundle -language switcher in the topnav bar. -To do this we need to configure the template for the “user_block” as shown below:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-sonata_admin:
-    ...
-    templates:
-            user_block: AcmeCoreBundle:Admin:admin_topnav.html.twig
-
                    -
                    -
                    • -
                  -
                  -

                  Y la plantilla se ve como esta

                  -
                  {# src/Acme/CoreBundle/Resources/views/Admin/admin_topnav.html.twig #}
-{% extends 'SonataAdminBundle:Core:user_block.html.twig' %}
-
-{% block user_block %}
-    {{ locale_switcher(null, null, 'AcmeCoreBundle:Admin:switcher_links.html.twig') }}
-    {{ parent() }}
-{% endblock %}
-
                  -
                  -

                  We tell the locale_switcher to use a custom template to display the links, which looks like this:

                  -
                  {# src/Acme/CoreBundle/Resources/views/Admin/switcher_links.html.twig #}
-Switch to :
-{% for locale in locales %}
-    {% if loop.index > 1 %} | {% endif %}<a href="{{ locale.link }}" title="{{ locale.locale_target_language }}">{{ locale.locale_target_language }}</a>
-{% endfor %}
-
                  -
                  -

                  Now what is left to do is to update the sonata routes to become locale aware:

                  -
                  -
                    -
                  • YAML
                    # app/config/routing.yml
-
-admin_dashboard:
-    pattern: /{_locale}/admin/
-    defaults:
-        _controller: FrameworkBundle:Redirect:redirect
-        route: sonata_admin_dashboard
-        permanent: true # este para 301
-
-admin:
-    resource: '@SonataAdminBundle/Resources/config/routing/sonata_admin.xml'
-    prefix: /{_locale}/admin
-
-sonata_admin:
-    resource: .
-    type: sonata_admin
-    prefix: /{_locale}/admin
-
-# redirige las rutas a las rutas no regionales
-admin_without_locale:
-    pattern: /admin
-    defaults:
-        _controller: FrameworkBundle:Redirect:redirect
-        route: sonata_admin_dashboard
-        permanent: true # este para 301
-
-admin_dashboard_without_locale:
-    pattern: /admin/dashboard
-    defaults:
-        _controller: FrameworkBundle:Redirect:redirect
-        route: sonata_admin_dashboard
-        permanent: true # este para 301
-
                    -
                    -
                    • -
                  -
                  -

                  When we now reload the admin dashboard, the url should be prefixed with our -default locale, for example /de/admin/dashboard. When clicking on the -language switcher the page reloads and displays the correct content for the -requested language.

                  -

                  The provided sonata admin classes map the locale field of the multi-language -documents to the form. You need to do the same in your admins, in order -to create new translations. Otherwise the language fallback of PHPCR-ODM will -make you update the original language, even when you request a different locale. -With the mapped locale field, the editor can chose if he needs to create a new -language version or updates the loaded one.

                  -

                  Happy editing.

                  -
                  -
                  -

                  Frontend editing and multi-language

                  -

                  When using the CreateBundle, you do not need to do anything at all to get -multi-language support. PHPCR-ODM will deliver the document in the requested -language, and the callback URL is generated in the request locale, -leading to save the edited document in the same language as it was loaded.

                  -
                  -

                  Nota

                  -

                  If a translation is missing, language fallback kicks in, both when viewing the -page but also when saving the changes, so you always update the current locale.

                  -

                  It would make sense to offer the user the choice whether he wants to create -a new translation or update the existing one. There is this issue -in the CreateBundle issue tracker.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/installing-cmf-core.html b/cmf/tutorials/installing-cmf-core.html deleted file mode 100644 index 7d125a9..0000000 --- a/cmf/tutorials/installing-cmf-core.html +++ /dev/null @@ -1,242 +0,0 @@ - - - - - - - Instalando y configurando el núcleo del CMF — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando el núcleo del CMF

                  -

                  El objetivo de esta guía es instalar los componentes mínimos necesarios (el «núcleo») del CMF con la mínima configuración requerida. A partir de aquí, puedes empezar a incorporar en tu aplicación la funcionalidad del CMF que necesites.

                  -

                  Esta guía está dirigida a usuarios experimentados que quieren conocer todos los -detalles sobre el CMF de Symfony. Si este es tu primer encuentro con el CMF de Symfony es buena idea empezar con:

                  - - -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "symfony-cmf/symfony-cmf": "1.0.*"
-}
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Iniciando paquetes

                  -

                  Luego, inicia los paquetes en AppKernel.php añadiéndolos al método registerBundles:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        new Symfony\Cmf\Bundle\RoutingExtraBundle\SymfonyCmfRoutingExtraBundle(),
-        new Symfony\Cmf\Bundle\CoreBundle\SymfonyCmfCoreBundle(),
-        new Symfony\Cmf\Bundle\MenuBundle\SymfonyCmfMenuBundle(),
-        new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(),
-        new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(),
-
-        // Dependencias del SymfonyCmfMenuBundle
-        new Knp\Bundle\MenuBundle\KnpMenuBundle(),
-
-        // Dependencias del SymfonyCmfBlockBundle
-        new Sonata\BlockBundle\SonataBlockBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Esto también habilita el PHPCR-ODM y dependencias relacionadas; las instrucciones de configuración se pueden encontrar en la documentación dedicada.

                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  Para lograr que tu aplicación funcione, es muy poca la configuración necesaria.

                  -
                  -

                  Configuración mínima

                  -

                  Estos pasos son necesarios para garantizar que tu AppKernel todavía se ejecuta.

                  -

                  Si no lo has hecho ya, asegúrate de que has seguido estos pasos en Instalando y configurando Doctrine y PHPCR-ODM:

                  -
                    -
                  • Inicia el DoctrinePHPCRBundle en app/AppKernel.php
                    • -
                  • Asegúrate que hay una sección doctrine_phpcr: en app/config/config.yml
                    • -
                  • Y la línea AnnotationRegistry::registerFile en app/autoload.php
                    • -
                  -

                  Configura el BlockBundle en tu archivo config.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-sonata_block:
-    default_contexts: [cms]
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Configuración adicional

                  -

                  Puesto que la mayoría de los componentes del CMF utilizan el DynamicRouter del RoutingExtraBundle, el cual de manera predeterminada no se carga, necesitarás habilitarlo de la siguiente manera:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_routing_extra:
-    chain:
-        routers_by_id:
-            symfony_cmf_routing_extra.dynamic_router: 200
-            router.default: 100
-    dynamic:
-        enabled: true
-
                    -
                    -
                    • -
                  -
                  -

                  Podrías querer configurar más en el enrutador dinámico, es decir escoger automáticamente los controladores basados en contenido. -Ve RoutingExtraBundle para detalles.

                  -

                  Por ahora esta es la única configuración que necesitamos. Dominar la configuración de los diferentes paquetes será el tema de otras guías. Si estás buscando la configuración de un paquete específico dale un vistazo al artículo del paquete correspondiente.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/installing-configuring-doctrine-phpcr-odm.html b/cmf/tutorials/installing-configuring-doctrine-phpcr-odm.html deleted file mode 100644 index 9e1483a..0000000 --- a/cmf/tutorials/installing-configuring-doctrine-phpcr-odm.html +++ /dev/null @@ -1,423 +0,0 @@ - - - - - - - Instalando y configurando Doctrine y PHPCR-ODM — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando Doctrine y PHPCR-ODM

                  -

                  El CMF de Symfony2 necesita almacenar el contenido en algún lugar. Muchos de los paquetes proporcionan documentos y asignación para el contenido del repositorio PHP — Asignación para el objeto documento (PHPCR-ODM), y la documentación que actualmente está basada en torno a la utilización de este. No obstante, también debe ser posible utilizar cualquier otra forma de almacenamiento de contenido, tal como otro ORM/ODM o MongoDB.

                  -

                  El objetivo de esta guía es instalar y configurar Doctrine y el PHPCR-ODM, listo para que empieces con el CMF.

                  -

                  Para más detalles ve la documentación del PHPCR-ODM completa. -Alguna información adicional se puede encontrar en la referencia del DoctrinePHPCRBundle, la cual mayoritariamente imita al DoctrineBundle estándar.

                  -

                  Finalmente para información sobre PHPCR ve al sitio web oficial de PHPCR.

                  -
                  -

                  Truco

                  -

                  Si sólo quieres usar el PHPCR pero no el PHPCR-ODM, puedes omitir el paso sobre el registro de anotaciones y las partes que empiezan con odm de la sección de configuración.

                  -
                  -
                  -

                  Requisitos previos

                  -
                    -
                  • php >= 5.3
                    • -
                  • libxml versión >= 2.7.0 (debido a un error en libxml http://bugs.php.net/bug.php?id=36501)
                    • -
                  • phpunit >= 3.6 (si quieres ejecutar las pruebas)
                    • -
                  • Symfony2 (versión 2.1.x)
                    • -
                  -
                  -
                  -

                  Instalando

                  -
                  -

                  Escogiendo un repositorio para el contenido

                  -

                  La primer cosa a decidir es qué repositorio de contenido utilizar. Un repositorio de contenido esencialmente es una base de datos que será la responsable para almacenar todo el contenido que quieras persistir. Este proporciona una API optimizada para las necesidades de un CMS (estructuras de árbol, referencias, versionado, completa búsqueda -de texto, etc.). Si bien, cada repositorio de contenido puede tener requisitos y características de rendimiento muy diferentes, la API es igual para todos ellos.

                  -

                  Además, debido a que la API define un formato de importación/exportación, siempre puedes cambiar a una -diferente implementación del repositorio de contenido más tarde.

                  -

                  Estas son las opciones disponibles:

                  -
                    -
                  • Jackalope con Jackrabbit (Jackrabbit requiere Java, este puede persistir al sistema de archivos, a una base de datos, etc.)
                    • -
                  • Jackalope con DBAL de Doctrine (requiere un RDBMS como MySQL, PostgreSQL o SQLite)
                    • -
                  • Midgard (Requiere la extensión midgard2 de PHP y un RDBMS como MySQL, PostgreSQL o SQLite)
                    • -
                  -

                  La siguiente documentación incluye ejemplos para todas las opciones de arriba.

                  -
                  -

                  Truco

                  -

                  Si justo estás empezando con el CMF, es mejor escoger un repositorio de contenido basado en un motor de almacenamiento con el cual ya estés familiarizado. Por ejemplo, Jackalope con DBAL de Doctrine trabajará con tu RDBMS existente y no requiere instalar Java o la extensión midgard2 de PHP. Una vez que tienes una aplicación trabajando debe ser fácil cambiar a otra opción.

                  -
                  -
                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json, dependiendo del repositorio de contenido que hayas escogido.

                  -
                  -
                  Jackalope con Jackrabbit
                  -
                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "jackalope/jackalope-jackrabbit": "1.0.*",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -
                  -
                  Jackalope con Doctrine DBAL
                  -
                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "jackalope/jackalope-doctrine-dbal": "dev-master",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -

                  Midgard

                  -
                  "minimum-stability": "dev",
-"require": {
-    ...
-    "midgard/phpcr": "dev-master",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Para todo lo anterior, si también estás utilizando el ORM de Doctrine, asegúrate de usar "doctrine/orm": "2.3.*", o de lo contrario composer no podrá resolver las dependencias cuando Doctrine dependa del PHPCR-ODM más nuevo de Doctrine 2.3. (la edición estándar de Symfony 2.1 utiliza «2.2.*».)

                  -
                  -

                  Para instalar las dependencias anteriores, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Registrando anotaciones

                  -

                  PHPCR-ODM usa anotaciones y es necesario registrarlas en tu archivo app/autoload.php. Añade la siguiente línea, inmediatamente después de la última línea AnnotationRegistry::registerFile:

                  -
                     // app/autoload.php
-
-   // ...
-AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php');
-   // ...
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia los paquetes en el archivo app/AppKernel.php añadiéndolos al método registerBundle:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        // Doctrine PHPCR
-        new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(),
-
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  El siguiente paso es configurar los paquetes.

                  -
                  -

                  Sesión PHPCR

                  -

                  La configuración básica para cada repositorio de contenido se muestra abajo; añade las líneas apropiadas a tu archivo app/config/config.yml. Puedes encontrar más información sobre la configuración de este paquete en el capítulo del DoctrinePHPCRBundle de la referencia.

                  -

                  Los parámetros del espacio de trabajo, nombre de usuario y contraseña son para el repositorio PHPCR y no los deberías confundir con las posibles credenciales de la base de datos. Estos provienen de la configuración de tu repositorio de contenido. Si quieres utilizar un diferente espacio de trabajo que «default» primero lo tienes que crear en tu repositorio.

                  -

                  Si también quieres utilizar el PHPCR-ODM, además, ve la siguiente sección.

                  -

                  Jackalope con Jackrabbit

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: jackrabbit
-            url: http://localhost:8080/server/
-        workspace: default
-        username: admin
-        password: admin
-    # configuración del odm ve abajo
-
                    -
                    -
                    • -
                  -
                  -

                  Jackalope con DBAL de Doctrine

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-        workspace: default
-        username: admin
-        password: admin
-    # configuración del odm ve abajo
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Además, asegúrate de configurar la sección principal de doctrine: al RDBMS que escogiste. -Si quieres utilizar una diferente conexión en lugar de la predefinida, configúrala en la sección dbal y especifícala en el parámetro de conexión. Un ejemplo configuración típica es este:

                  -
                  -
                  -
                  -
                  doctrine:
                  -
                  -
                  dbal:
                  -
                  driver: %database_driver% -host: %database_host% -port: %database_port% -dbname: %database_name% -user: %database_user% -password: %database_password% -charset: UTF8
                  -
                  -
                  -
                  -
                  -

                  Ve Bases de datos y Doctrine para más información.

                  -
                  -
                  -

                  Midgard

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: midgard2
-            db_type: MySQL
-            db_name: midgard2_test
-            db_host: "0.0.0.0"
-            db_port: 3306
-            db_username: ""
-            db_password: ""
-            db_init: true
-            blobdir: /tmp/cmf-blobs
-        workspace: default
-        username: admin
-        password: admin
-    # configuración del odm ve abajo
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Doctrine con PHPCR-ODM

                  -

                  Cualquiera de las configuraciones anteriores te darán una sesión PHPCR válida. Si quieres utilizar el gestor Objeto-Documento, necesitas configurarlo también. Lo más sencillo es poner auto_mapping: true para hacer que el paquete PHPCR reconoce documentos en el directorio <Paquete>/Document y buscar asociaciones en <Paquete>/Resources/config/doctrine/<Document>.phpcr.xml resp. ...yml. De lo contrario necesitas configurar manualmente la sección de asignaciones. See the -configuration reference of the PHPCR-ODM bundle for details.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        ...
-    odm:
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Configurando el repositorio de contenido

                  -

                  Jackalope Jackrabbit

                  -

                  Estos son los pasos necesarios para instalar Apache Jackrabbit:

                  - -
                  java -jar jackrabbit-standalone-*.jar
-
                  -
                  -

                  Ve a http://localhost:8080/, ahora Apache te debería mostrar una página Jackrabbit.

                  -

                  Puedes encontrar más información sobre cómo ejecutar un servidor Jackrabbit en el wiki de Jackalope.

                  -

                  Jackalope DBAL de Doctrine

                  -

                  Ejecuta las siguientes órdenes para crear la base de datos e instalar un esquema predefinido:

                  -
                  app/console doctrine:database:create
-app/console doctrine:phpcr:init:dbal
-
                  -
                  -

                  For more information on how to configure Doctrine DBAL with Symfony2, see the -Doctrine chapter in the Symfony2 documentation -and the explanations in the reference of the PHPCR-ODM bundle.

                  -

                  Midgard

                  -

                  Midgard es una extensión C que implementa la API de PHPCR en lo alto de un RDBMS estándar.

                  -

                  Ve la documentación oficial de Midgard PHPCR.

                  -
                  -
                  -

                  Registrando tipos de nodo del sistema

                  -

                  PHPCR-ODM utiliza un tipo de nodo personalizado para dar seguimiento a la metainformación sin interferir con tu contenido. There is a command that makes it -trivial to register this type and the PHPCR namespace, as well as all base paths of bundles:

                  -
                  php app/console doctrine:phpcr:repository:init
-
                  -
                  -
                  -
                  -

                  Usando la restricción de validación ValidPhpcrOdm

                  -

                  El paquete proporciona la restricción de validación ValidPhpcrOdm que puedes utilizar para comprobar si los campos Id o Nodename y Parent de tu documento son correctos:

                  -
                  <?php
-
-namespace Acme\DemoBundle\Document;
-
-use Doctrine\ODM\PHPCR\Mapping\Annotations as PHPCRODM;
-use Doctrine\Bundle\PHPCRBundle\Validator\Constraints as Assert;
-
-/**
- * @PHPCRODM\Document
- * @Assert\ValidPhpcrOdm
- */
-class MyDocument
-{
-    /** @PHPCRODM\Id(strategy="parent") */
-    protected $id;
-
-    /** @PHPCRODM\Nodename */
-    protected $name;
-
-    /** @PHPCRODM\ParentDocument */
-    protected $parent;
-
-    ...
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/installing-configuring-inline-editing.html b/cmf/tutorials/installing-configuring-inline-editing.html deleted file mode 100644 index 5b62158..0000000 --- a/cmf/tutorials/installing-configuring-inline-editing.html +++ /dev/null @@ -1,204 +0,0 @@ - - - - - - - Instalando y configurando la edición en línea — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando la edición en línea

                  -

                  El objetivo de esta guía es instalar y configurar el apoyo para la edición en línea.

                  -

                  Este proporciona una solución fácil de integrar con VIE.js y create.js para proporcionar edición en línea basada en la salida de RDFa.

                  -

                  Para más información —por ahora— ve la documentación del CreateBundle

                  -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/create-bundle": "1.0.*"
-},
-"scripts": {
-    "post-install-cmd": [
-        "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules",
-        ...
-    ],
-    "post-update-cmd": [
-        "Symfony\\Cmf\\Bundle\\CreateBundle\\Composer\\ScriptHandler::initSubmodules",
-        ...
-    ]
-},
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update symfony-cmf/create-bundle
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia los paquetes en el archivo app/AppKernel.php añadiéndolos al método registerBundles:

                  -
                  public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        new Symfony\Cmf\Bundle\CreateBundle\SymfonyCmfCreateBundle(),
-        new FOS\RestBundle\FOSRestBundle(),
-        new JMS\SerializerBundle\JMSSerializerBundle($this),
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  El siguiente paso es configurar los paquetes.

                  -

                  Configuración básica, añade lo siguiente a la configuración de tu aplicación:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_create:
-    phpcr_odm: true
-    map:
-        '<http://rdfs.org/sioc/ns#Post>': 'Symfony\Cmf\Bundle\MultilangContentBundle\Document\MultilangStaticContent'
-    image:
-        model_class: Symfony\Cmf\Bundle\CreateBundle\Document\Image
-        controller_class: Symfony\Cmf\Bundle\CreateBundle\Controller\PHPCRImageController
-
                    -
                    -
                    • -
                  -
                  -

                  Si tienes tus propios documentos, agregalos a la asignación y coloca la asignación RDFa en Resources/rdf-mappings ya sea dentro del directorio app o dentro de algún paquete. -El nombre de archivo es el nombre de clase completamente cualificado que incluye el espacio de nombres sustituyendo la barra inversa \ con un punto (.).

                  -
                  -
                  -

                  Referencia

                  -

                  Ve el CreateBundle

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/installing-configuring-simple-cms.html b/cmf/tutorials/installing-configuring-simple-cms.html deleted file mode 100644 index ccec46b..0000000 --- a/cmf/tutorials/installing-configuring-simple-cms.html +++ /dev/null @@ -1,180 +0,0 @@ - - - - - - - Instalando y configurando el SimpleCmsBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Instalando y configurando el SimpleCmsBundle

                  -

                  El objetivo de esta guía es instalar y configurar un sencillo CMS con la ayuda del SimpleCmsBundle.

                  -
                  -

                  Nota

                  -

                  Para que trabaje el CMF se requiere de Symfony 2.1 (actualmente maestro).

                  -
                  -

                  El SimpleCmsBundle proporciona una solución para fácilmente asignar contenido, rutas y elementos del menú basando el repositorio de contenido en una única estructura de árbol.

                  -

                  Para más información —por ahora— ve la documentación del SymfonyCmfSimpleCmsBundle

                  -

                  Para una sencilla instalación de ejemplo del paquete revisa la Edición estándar del CMF de Symfony

                  -

                  El sitio web de CMF es -otra aplicación que utiliza el SimpleCmsBundle.

                  - -
                  -

                  Instalando

                  -
                  -

                  Descarga los paquetes

                  -

                  Añade lo siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/simple-cms-bundle": "1.0.*"
-}
-
                  -
                  -

                  Y luego ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  -

                  Iniciando los paquetes

                  -

                  Luego, inicia el paquete en el archivo app/AppKernel.php añadiéndolo al método registerBundles.

                  -
                  public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        new Symfony\Cmf\Bundle\SimpleCmsBundle\SymfonyCmfSimpleCmsBundle(),
-
-    );
-    // ...
-}
-
                  -
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  El siguiente paso es configurar los paquetes.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_simple_cms:
-    routing:
-        templates_by_class:
-            Symfony\Cmf\Bundle\SimpleCmsBundle\Document\Page:  SymfonyCmfSimpleCmsBundle:Page:index.html.twig
-
                    -
                    -
                    • -
                  -
                  -

                  Ve la referencia completa de SimpleCmsBundle.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 18, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cmf/tutorials/using-blockbundle-and-contentbundle.html b/cmf/tutorials/using-blockbundle-and-contentbundle.html deleted file mode 100644 index 7f0e993..0000000 --- a/cmf/tutorials/using-blockbundle-and-contentbundle.html +++ /dev/null @@ -1,735 +0,0 @@ - - - - - - - Usando BlockBundle y ContentBundle con PHPCR — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Usando BlockBundle y ContentBundle con PHPCR

                  -

                  El objetivo de esta guía es demostrar cómo puedes utilizar el CMF BlockBundle y ContentBundle como componentes independientes, y mostrarte cómo complementan al PHPCR.

                  -

                  Esta guía demuestra el uso más sencillo posible, para instalarlo y ejecutarlo -rápidamente. Una vez que estés familiarizado con lo básico, la documentación en profundidad de ambos paquetes te -ayudará a adaptar estos ejemplos básicos para servir casos de uso más avanzados.

                  -

                  Empezarás utilizando únicamente el BlockBundle, con bloques de contenido enlazados directamente al PHPCR. -Luego, verás una introducción al ContentBundle para mostrarte cómo puedes representar contenido en las páginas con bloques.

                  -
                  -

                  Nota

                  -

                  A pesar de que no es un requisito utilizar BlockBundle o ContentBundle, esta guía también usa DoctrineFixturesBundle. -Esto es porque este proporciona una manera fácil de cargar algún contenido de prueba.

                  -
                  -
                  -

                  Requisitos previos

                  - -
                  -

                  Nota

                  -

                  Esta guía está basada en la utilización de PHPCR-ODM instalado con Jackalope, DBAL de Doctrine y una base de datos MySQL. Debería ser fácil adaptarlo para trabajar con una de las otras opciones PHPCR documentadas en Instalando y configurando Doctrine y PHPCR-ODM.

                  -
                  -
                  -
                  -

                  Creando y configurando la base de datos

                  -

                  Puedes utilizar una base de datos existente, o crear una ahora para ayudarte a seguir esta guía. Para una nueva base de datos, ejecuta estas órdenes en MySQL:

                  -
                  CREATE DATABASE symfony DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_general_ci;
-CREATE USER 'symfony'@'localhost' IDENTIFIED BY 'UseABetterPassword';
-GRANT ALL ON symfony.* TO 'symfony'@'localhost';
-
                  -
                  -

                  Tu archivo parameters.yml necesita emparejar lo anterior, por ejemplo:

                  -
                  -
                    -
                  • YAML
                    # app/config/parameters.yml
-parameters:
-    database_driver:   pdo_mysql
-    database_host:     localhost
-    database_port:     ~
-    database_name:     symfony
-    database_user:     symfony
-    database_password: UseABetterPassword
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Configurando el componente PHPCR de Doctrine

                  -
                  -

                  Nota

                  -

                  Si seguiste la guía Instalando y configurando Doctrine y PHPCR-ODM, puedes saltarte esta sección.

                  -
                  -

                  Necesitas instalar los componentes del PHPCR-ODM. Añade los siguiente a tu archivo composer.json:

                  -
                  "require": {
-    ...
-    "jackalope/jackalope-jackrabbit": "1.0.*",
-    "jackalope/jackalope-doctrine-dbal": "dev-master",
-    "doctrine/phpcr-bundle": "1.0.*",
-    "doctrine/phpcr-odm": "1.0.*"
-}
-
                  -
                  -

                  Para instalar lo anterior, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -

                  En tu archivo config.yml, añade la siguiente configuración para doctrine_phpcr:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-        workspace: default
-    odm:
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -

                  Añade la siguiente línea al método registerBundles() en el archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -

                  Añade la siguiente línea a tu archivo autoload.php, inmediatamente después de la -última línea AnnotationRegistry::registerFile:

                  -
                     // app/autoload.php
-
-   // ...
-AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php');
-   // ...
-
                  -
                  -

                  Crea el esquema de la base de datos y registra el tipo de nodo PHPCR usando las siguientes órdenes de consola:

                  -
                  php app/console doctrine:phpcr:init:dbal
-php app/console doctrine:phpcr:repository:init
-
                  -
                  -

                  Ahora deberías tener una serie de tablas en tu base de datos MySQL con el prefijo phpcr_.

                  -
                  -
                  -

                  Instala los componentes necesarios del CMF de Symfony

                  -

                  Añade lo siguiente al archivo composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/block-bundle": "dev-master"
-}
-
                  -
                  -

                  Para instalar las dependencias anteriores, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -

                  Añade las siguientes líneas al archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Sonata\BlockBundle\SonataBlockBundle(),
-        new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -

                  SonataBlockBundle es una dependencia del BlockBundle de CMF y necesitas configurarlas. Añade lo siguiente a tu archivo config.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-sonata_block:
-    default_contexts: [cms]
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Instala DoctrineFixturesBundle

                  -
                  -

                  Nota

                  -

                  Como mencioné al inicio, este no es un requisito para BlockBundle o ContentBundle; No obstante, es una buena manera de manejar contenido predefinido o de ejemplo.

                  -
                  -

                  Añade lo siguiente al archivo composer.json:

                  -
                  "require": {
-    ...
-    "doctrine/doctrine-fixtures-bundle": "dev-master"
-}
-
                  -
                  -

                  Para instalar las dependencias anteriores, ejecuta:

                  -
                  php composer.phar update
-
                  -
                  -

                  Añade la siguiente línea al método registerBundles() en el archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Cargando accesorios

                  -

                  Basándote en la documentación de DoctrineFixturesBundle, necesitarás crear una clase fixtures.

                  -

                  Para empezar, crea un directorio DataFixtures dentro de tu propio paquete (p. ej. «MainBundle»), y dentro, crea un directorio llamado PHPCR. Si quieres seguir los ejemplos de más adelante, el DoctrineFixturesBundle cargará automáticamente las clases fixtures colocadas allí.

                  -

                  En el cargador de accesorios, un ejemplo de la creación de un bloque de contenido podría tener esta apariencia:

                  -
                  $myBlock = new SimpleBlock();
-$myBlock->setParentDocument($parentPage);
-$myBlock->setName('sidebarBlock');
-$myBlock->setTitle('My first block');
-$myBlock->setContent('Hello block world!');
-
-$documentManager->persist($myBlock);
-
                  -
                  -

                  Aún así, lo anterior en sí mismo no será suficiente, porque no hay ninguna página padre ($parentPage) con la cual enlazar los bloques. Hay varias posibles opciones que puedes utilizar como el padre:

                  -
                    -
                  • Enlaza los bloques directamente al documento raíz (no mostrado)
                    • -
                  • Crea un documento del paquete PHPCR (mostrado abajo usando el tipo de documento Genérico)
                    • -
                  • Crea un documento del ContentBundle del CMF (mostrado abajo utilizando el tipo de documento StaticContent)
                    • -
                  -
                  -
                  -

                  Usando el PHPCR

                  -

                  Para almacenar un bloque directamente en el PHPCR del CMF, crea la siguiente clase dentro de tu directorio DataFixtures/PHPCR:

                  -
                  <?php
-// src/Acme/MainBundle/DataFixtures/PHPCR/LoadBlockWithPhpcrParent.php
-namespace Acme\MainBundle\DataFixtures\ORM;
-
-use Doctrine\Common\DataFixtures\AbstractFixture;
-use Doctrine\Common\Persistence\ObjectManager;
-use Doctrine\ODM\PHPCR\Document\Generic;
-use Symfony\Component\DependencyInjection\ContainerAwareInterface;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-use Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock;
-
-class LoadBlockWithPhpcrParent extends AbstractFixture implements ContainerAwareInterface
-{
-    public function load(ObjectManager $manager)
-    {
-        // obtiene el documento raíz desde el PHPCR
-        $rootDocument = $manager->find(null, '/');
-
-        // Crea un documento PHPCR genérico bajo la raíz, para usarlo
-        // como el tipo de categoría para los bloques
-        $document = new Generic();
-        $document->setParent($rootDocument);
-        $document->setNodename('blocks');
-        $manager->persist($document);
-
-        // Crea un nuevo SimpleBlock (ve
-        // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types)
-        $myBlock = new SimpleBlock();
-        $myBlock->setParentDocument($document);
-        $myBlock->setName('testBlock');
-        $myBlock->setTitle('CMF BlockBundle only');
-        $myBlock->setContent('Block from CMF BlockBundle, parent from the PHPCR (Generic document).');
-        $manager->persist($myBlock);
-
-        // Confirma los cambios de $document y $block a la base de datos
-        $manager->flush();
-    }
-
-    public function setContainer(ContainerInterface $container = null)
-    {
-        $this->container = $container;
-    }
-}
-
                  -
                  -

                  Esta clase carga un bloque de contenido de ejemplo que utiliza el BlockBundle de CMF (sin necesitar ningún otro paquete del CMF). Para asegurar el bloque tienes un padre en el repositorio, el cargador también crea un documento Genérico llamado 'blocks' dentro del PHPCR.

                  -

                  Ahora, carga los accesorios usando la consola:

                  -
                  php app/console doctrine:phpcr:fixtures:load
-
                  -
                  -

                  El contenido en tu base de datos ahora se tendría que ver algo así:

                  -
                  SELECT path, parent, local_name FROM phpcr_nodes;
-
                  -
                  - ----- - - - - - - - - - - - - - - - - - - - - -
                  pathparentlocal_name
                  /  
                  /blocks/blocks
                  /blocks/testBlock/ blockstestBlock
                  -
                  -
                  -

                  Usando el ContentBundle del CMF

                  -

                  Sigue este ejemplo para utilizar ambos componentes Block y Content.

                  -

                  The ContentBundle is best used together with the RoutingExtraBundle. Add the -following to composer.json:

                  -
                  "require": {
-    ...
-    "symfony-cmf/content-bundle": "dev-master",
-    "symfony-cmf/routing-extra-bundle": "dev-master"
-}
-
                  -
                  -

                  Instala todo de la manera habitual:

                  -
                  php composer.phar update
-
                  -
                  -

                  Añade la siguiente línea al archivo AppKernel.php:

                  -
                  // app/AppKernel.php
-
-public function registerBundles()
-{
-    $bundles = array(
-        // ...
-        new Symfony\Cmf\Bundle\ContentBundle\SymfonyCmfContentBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -

                  Ahora deberías tener todo lo necesario para cargar una página de contenido con un bloque de ejemplo, así que crea la clase LoadBlockWithCmfParent.php:

                  -
                  <?php
-// src/Acme/Bundle/MainBundle/DataFixtures/PHPCR/LoadBlockWithCmfParent.php
-namespace Acme\MainBundle\DataFixtures\PHPCR;
-
-use Doctrine\Common\DataFixtures\AbstractFixture;
-use Doctrine\Common\Persistence\ObjectManager;
-use Symfony\Component\DependencyInjection\ContainerAwareInterface;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-use PHPCR\Util\NodeHelper;
-use Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock;
-use Symfony\Cmf\Bundle\ContentBundle\Document\StaticContent;
-
-class LoadBlockWithCmfParent extends AbstractFixture implements ContainerAwareInterface
-{
-    public function load(ObjectManager $manager)
-    {
-        // Obtiene el nombre de la ruta base a utilizar en la configuración
-        $session = $manager->getPhpcrSession();
-        $basepath = $this->container->getParameter('symfony_cmf_content.static_basepath');
-
-        // Crea la ruta en el repositorio
-        NodeHelper::createPath($session, $basepath);
-
-        // Crea un nuevo documento que utiliza StaticContent de ContentBundle del CMF
-        $document = new StaticContent();
-        $document->setPath($basepath . '/blocks');
-        $manager->persist($document);
-
-        // Crea un nuevo SimpleBlock (ve
-        // http://gitnacho.github.com/symfony-doc-es/cmf/bundles/block.html#block-types)
-        $myBlock = new SimpleBlock();
-        $myBlock->setParentDocument($document);
-        $myBlock->setName('testBlock');
-        $myBlock->setTitle('CMF BlockBundle and ContentBundle');
-        $myBlock->setContent('Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent).');
-        $manager->persist($myBlock);
-
-        // Confirma los cambios de $document y $block a la base de datos
-        $manager->flush();
-    }
-
-    public function setContainer(ContainerInterface $container = null)
-    {
-        $this->container = $container;
-    }
-}
-
                  -
                  -

                  Esta clase crea una página de contenido de ejemplo que utiliza el ContentBundle del CMF. Luego, carga el bloque de ejemplo como antes, usando la nueva página de contenido como su padre.

                  -

                  De manera predeterminada, la ruta base para el contenido es /cms/content/static. Para mostrar cómo lo puedes configurar a cualquier ruta, añade la siguiente entrada opcional a tu archivo config.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_content:
-    static_basepath: /content
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora deberías poder cargar los accesorios anteriores:

                  -
                  php app/console doctrine:phpcr:fixtures:load
-
                  -
                  -

                  Todo va sobre ruedas, el contenido en tu base de datos se tendría que ver algo así (si también seguiste el ejemplo LoadBlockWithPhpcrParent, todavía deberías tener dos entradas /blocks también):

                  -
                  SELECT path, parent, local_name FROM phpcr_nodes;
-
                  -
                  - ----- - - - - - - - - - - - - - - - - - - - - - - - - -
                  pathparentlocal_name
                  /  
                  /content/content
                  /content/blocks/contentblocks
                  /content/blocks/testBlock/content/blockstestBlock
                  -
                  -
                  -

                  Dibujando los bloques

                  -

                  Esto lo maneja el BlockBundle de Sonata. sonata_block_render ya está registrado como extensión de Twig al incluir SonataBlockBundle en el archivo AppKernel.php. Por lo tanto, puedes dibujar cualquier bloque dentro de cualquier plantilla simplemente refiriéndote a su ruta.

                  -

                  El siguiente código muestra el resultado de ambas instancias de los bloques testBlock de los ejemplos anteriores. -Si sólo seguiste uno de los ejemplos, asegúrate de incluir únicamente ese bloque:

                  -
                  {# src/Acme/Bundle/MainBundle/resources/views/Default/index.html.twig #}
-
-{# Incluye esto si seguiste el ejemplo BlockBundle con PHPCR #}
-{{ sonata_block_render({
-    'name': '/blocks/testBlock'
-}) }}
-
-{# incluye esto si seguiste el ejemplo BlockBundle con ContentBundle #}
-{{ sonata_block_render({
-    'name': '/content/blocks/testBlock'
-}) }}
-
                  -
                  -

                  Ahora tu página index debería mostrar lo siguiente (suponiendo que seguiste ambos ejemplos):

                  -
                  CMF BlockBundle only
-Block from CMF BlockBundle, parent from the PHPCR (Generic document).
-
-CMF BlockBundle and ContentBundle
-Block from CMF BlockBundle, parent from CMF ContentBundle (StaticContent).
-
                  -
                  -

                  Esto sucede al dibujar un bloque, ve el... index:: BlockBundle para más detalles:

                  -
                    -
                  • un documento se carga basándose en el nombre
                    • -
                  • si está configurada la caché, se comprueba la caché y si se encuentra devuelve el contenido
                    • -
                  • cada bloque de documento también tiene un servicio de bloque, llama al método execute:
                      -
                    • puedes poner aquí la lógica que quieras tal como lo harías en un controlador
                      • -
                    • esta llama a una plantilla
                      • -
                    • el resultado es un objeto Respuesta
                      • -
                    -
                    • -
                  -
                  -

                  Nota

                  -

                  Un bloque también se puede configurar usando opciones, estas te permiten crear bloques más avanzados y reutilizables. Las opciones predefinidas se configuran en el bloque del servicio y se pueden alterar en el ayudante de Twig y el bloque del documento. -Un ejemplo es un bloque lector de RSS, la URL y el título se almacenan en las opciones del bloque del documento, la cantidad

                  -
                  -

                  máxima de elementos a mostrar se especifica al llamar a sonata_block_render.

                  -
                  -
                  -

                  Embedding blocks in WYSIWYG content

                  -

                  The SymfonyCmfBlockBundle provides a twig filter cmf_embed_blocks that -looks through the content and looks for special tags to render blocks. To use -the tag, you need to apply the cmf_embed_blocks filter to your output. -If you can, render your blocks directly in the template. This feature is only a -cheap solution for web editors to place blocks anywhere in their HTML content. -A better solution to build composed pages is to build it from blocks. (There -might be a CMF bundle at some point for this.)

                  -
                  {# template.twig.html #}
-{{ page.content|cmf_embed_blocks }}
-
                  -
                  -

                  When you apply the filter, your users can use this tag to embed a block in -their HTML content:

                  -
                  <span>%block:"/absolute/path/to/block"%</span>
-
                  -
                  -

                  You can change the prefix and postfix (the parts <span>%block: and -%</span> to have a different tag for your users. Say you want to write -%%%block:"/absolute/path"%%% then you do:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-symfony_cmf_block:
-    twig:
-        cmf_embed_blocks:
-            prefix: %%%block:
-            postfix: %%%
                    -
                    -
                    • -
                  -
                  -
                  -

                  Advertencia

                  -

                  Currently there is no limitation built into this feature. Only enable it on -content for which you are sure only trusted users may edit it. Restrictions -about what block can be where that are built into an admin interface are -not respected here.

                  -
                  -
                  -
                  -

                  Siguientes pasos

                  -

                  Ahora deberías estar listo para usar en tu aplicación el BlockBundle y/o el ContentBundle, o para explorar los otros paquetes disponibles en el CMF.

                  - -
                  -
                  -

                  Solucionando problemas

                  -

                  Si tienes problemas, posiblemente sea más fácil empezar con una instalación de Symfony2 fresca. También puedes probar ejecutando y modificando el código en el ejemplo externo del recinto de seguridad del bloque del CMF.

                  -

                  Configuración de Doctrine

                  -

                  Si empezaste con la distribución estándar de Symfony2 (versión 2.1.x), ya deberías tener correctamente configurado tu archivo config.yml. Si no, inténtalo usando la siguiente sección:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine:
-    dbal:
-        driver:   "%database_driver%"
-        host:     "%database_host%"
-        port:     "%database_port%"
-        dbname:   "%database_name%"
-        user:     "%database_user%"
-        password: "%database_password%"
-        charset:  UTF8
-    orm:
-        auto_generate_proxy_classes: "%kernel.debug%"
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -

                  “Ninguna orden definida” al cargar accesorios

                  -
                  [InvalidArgumentException]
-No hay ninguna orden definida en el espacio de nombres ``doctrine:phpcr:fixtures``.
-
                  -
                  -

                  Asegúrate de que tu archivo AppKernel.php contiene las siguientes líneas:

                  -
                  new Doctrine\Bundle\FixturesBundle\DoctrineFixturesBundle(),
-new Doctrine\Bundle\PHPCRBundle\DoctrinePHPCRBundle(),
-
                  -
                  -

                  “No configuraste una sesión”

                  -
                  [InvalidArgumentException]
-No configuraste una sesión para los gestores de documento
-
                  -
                  -

                  Asegúrate de que tienes lo siguiente en tu archivo app/config.yml:

                  -
                  -
                    -
                  • YAML
                    doctrine_phpcr:
-    session:
-        backend:
-            type: doctrinedbal
-            connection: doctrine.dbal.default_connection
-        workspace: default
-    odm:
-        auto_mapping: true
-
                    -
                    -
                    • -
                  -
                  -

                  “La anotación no existe”

                  -
                  [Doctrine\Common\Annotations\AnnotationException]
-[Error semántico] La anotación «@Doctrine\ODM\PHPCR\Mapping\Annotations\Document» en la clase «Doctrine\ODM\PHPCR\Document\Generic» no existe, o no se puede cargar automáticamente.
-
                  -
                  -

                  Asegúrate de añadir esta línea a tu archivo app/autoload.php (inmediatamente después de la línea AnnotationRegistry::registerLoader):

                  -
                  AnnotationRegistry::registerFile(__DIR__.'/../vendor/doctrine/phpcr-odm/lib/Doctrine/ODM/PHPCR/Mapping/Annotations/DoctrineAnnotations.php');
-
                  -
                  -

                  no se encuentra la clase SimpleBlock

                  -
                  [Doctrine\Common\Persistence\Mapping\MappingException]
-La clase 'Symfony\Cmf\Bundle\BlockBundle\Document\SimpleBlock' no se encuentra en la cadena de espacios de nombres configurada Doctrine\ODM\PHPCR\Document, Sonata\UserBundle\Document, FOS\UserBundle\Document
-
                  -
                  -

                  Asegúrate de que está instalado el BlockBundle del CMF y de que se carga en el archivo app/AppKernel.php:

                  -
                  new Symfony\Cmf\Bundle\BlockBundle\SymfonyCmfBlockBundle(),
-
                  -
                  -

                  No se encuentra la RouteAwareInterface

                  -
                  Error fatal: No se encuentra la interfaz 'Symfony\Cmf\Component\Routing\RouteAwareInterface' en /var/www/your-site/vendor/symfony-cmf/content-bundle/Symfony/Cmf/Bundle/ContentBundle/Document/StaticContent.php en la línea 15
-
                  -
                  -

                  Si estás utilizando el ContentBundle, asegúrate de instalar el RoutingExtraBundle, también:

                  -
                  // composer.json
-"symfony-cmf/routing-extra-bundle": "dev-master"
-
                  -
                  -

                  ...e instala:

                  -
                  php composer.phar update
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/class_loader.html b/components/class_loader.html deleted file mode 100644 index 9fe8d0a..0000000 --- a/components/class_loader.html +++ /dev/null @@ -1,222 +0,0 @@ - - - - - - - El componente ClassLoader — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente ClassLoader

                  -
                  -
                  El componente ClassLoader carga automáticamente las clases de tu proyecto si estas siguen algunas convenciones PHP estándar.
                  -

                  Siempre que uses una clase no definida, PHP utiliza el mecanismo de carga automática para delegar la carga de un archivo de definición de clase. Symfony2 proporciona un cargador automático «universal», que es capaz de cargar clases desde los archivos que implementan uno de los siguientes convenios:

                  -
                    -
                  • Los estándares de interoperabilidad técnica para los espacios de nombres y nombres de clases de PHP 5.3;
                    • -
                  • La convención de nomenclatura de clases de PEAR.
                    • -
                  -

                  Si tus clases y las bibliotecas de terceros que utilizas en tu proyecto siguen estas normas, el cargador automático de Symfony2 es el único cargador automático que necesitarás siempre.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  -Nuevo en la versión 2.1: El método useIncludePath se agregó en Symfony 2.1.

                  -

                  Registrar la clase del cargador automático Symfony\Component\ClassLoader\UniversalClassLoader es sencillo:

                  -
                  require_once '/ruta/a/src/Symfony/Component/ClassLoader/UniversalClassLoader.php';
-
-use Symfony\Component\ClassLoader\UniversalClassLoader;
-
-$loader = new UniversalClassLoader();
-
-// como último recurso busca en include_path.
-$loader->useIncludePath(true);
-
-// ... aquí registra el espacio de nombres y prefijos
-// - ve más abajo
-
-$loader->register();
-
                  -
                  -

                  Para una menor ganancia en rendimiento puedes memorizar en caché las rutas de las clases usando APC, con sólo registrar la clase Symfony\Component\ClassLoader\ApcUniversalClassLoader:

                  -
                  require_once '/ruta/a/src/Symfony/Component/ClassLoader/UniversalClassLoader.php';
-require_once '/ruta/a/src/Symfony/Component/ClassLoader/ApcUniversalClassLoader.php';
-
-use Symfony\Component\ClassLoader\ApcUniversalClassLoader;
-
-$loader = new ApcUniversalClassLoader('apc.prefix.');
-$loader->register();
-
                  -
                  -

                  El cargador automático es útil sólo si agregas algunas bibliotecas al cargador automático.

                  -
                  -

                  Nota

                  -

                  El autocargador se registra automáticamente en una aplicación Symfony2 (consulta el app/autoload.php).

                  -
                  -

                  Si las clases a cargar automáticamente utilizan espacios de nombres, utiliza cualquiera de los métodos registerNamespace() o registerNamespaces():

                  -
                  $loader->registerNamespace('Symfony', __DIR__.'/vendor/symfony/symfony/src');
-
-$loader->registerNamespaces(array(
-    'Symfony' => __DIR__.'/../vendor/symfony/symfony/src',
-    'Monolog' => __DIR__.'/../vendor/monolog/monolog/src',
-));
-
-$loader->register();
-
                  -
                  -

                  Para las clases que siguen la convención de nomenclatura de PEAR, utiliza cualquiera de los métodos registerPrefix() o registerPrefixes():

                  -
                  $loader->registerPrefix('Twig_', __DIR__.'/vendor/twig/twig/lib');
-
-$loader->registerPrefixes(array(
-    'Swift_' => __DIR__.'/vendor/swiftmailer/swiftmailer/lib/classes',
-    'Twig_'  => __DIR__.'/vendor/twig/twig/lib',
-));
-
-$loader->register();
-
                  -
                  -
                  -

                  Nota

                  -

                  Algunas bibliotecas también requieren que su ruta de acceso raíz esté registrada en la ruta de include PHP (set_include_path()).

                  -
                  -

                  Las clases de un subespacio de nombres o una subjerarquía de clases PEAR se pueden buscar en una lista de ubicaciones para facilitar la utilización de un subconjunto de clases de terceros en proyectos grandes:

                  -
                  $loader->registerNamespaces(array(
-    'Doctrine\\Common'           => __DIR__.'/vendor/doctrine/common/lib',
-    'Doctrine\\DBAL\\Migrations' => __DIR__.'/vendor/doctrine/migrations/lib',
-    'Doctrine\\DBAL'             => __DIR__.'/vendor/doctrine/dbal/lib',
-    'Doctrine'                   => __DIR__.'/vendor/doctrine/orm/lib',
-));
-
-$loader->register();
-
                  -
                  -

                  En este ejemplo, si intentas utilizar una clase en el espacio de nombres Doctrine\Common o una de sus hijas, el cargador automático buscará primero la clase en el directorio doctrine\common, y entonces, si no lo encuentra, vuelve al directorio de reserva predeterminado, el último Doctrine configurado antes de darse por vencido. -El orden de registro es importante en este caso.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/config/caching.html b/components/config/caching.html deleted file mode 100644 index 900b2bd..0000000 --- a/components/config/caching.html +++ /dev/null @@ -1,169 +0,0 @@ - - - - - - - Almacenamiento en caché basado en recursos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Almacenamiento en caché basado en recursos

                  -

                  Al cargar todos los recursos de configuración, posiblemente desees procesar los valores de configuración y combinarlos en un solo archivo. Este archivo actúa como la memorización en caché. Su contenido no se tiene que regenerar cada vez que ejecutas la aplicación - sólo cuando se modifican los recursos de configuración.

                  -

                  Por ejemplo, el componente de enrutamiento de Symfony permite cargar todas las rutas, y luego volcar un comparador de URL o un generador de URL basándose en estas rutas. En este caso, cuando uno de los recursos se ha modificado (y estás trabajando en un entorno de desarrollo), debes invalidar el archivo generado y regenerarlo. -Esto se puede lograr usando la clase Symfony\Component\Config\ConfigCache.

                  -

                  El siguiente ejemplo muestra cómo recolectar los recursos, luego generar algún código basado en los recursos que se han cargado, y escribir el código en la memoria caché. La memoria caché también recibe la colección de recursos que se utilizaron para generar el código. Al mirar la marca de tiempo de la «última modificación» de esos recursos, puedes saber si la caché aún está fresca o que debes regenerar su contenido:

                  -
                  use Symfony\Component\Config\ConfigCache;
-use Symfony\Component\Config\Resource\FileResource;
-
-$cachePath = __DIR__.'/cache/appUserMatcher.php';
-
-// el segundo argumento indica cuando o no deseas usar el modo de depuración
-$userMatcherCache = new ConfigCache($cachePath, true);
-
-if (!$userMatcherCache->isFresh()) {
-    // llénalo con un arreglo de rutas de los archivos 'users.yml'
-    $yamlUserFiles = ...;
-
-    $resources = array();
-
-    foreach ($yamlUserFiles as $yamlUserFile) {
-        // ver el artículo anterior «Cargando recursos» para
-        // ver de dónde proviene $delegatingLoader
-        $delegatingLoader->load($yamlUserFile);
-        $resources[] = new FileResource($yamlUserFile);
-    }
-
-    // el código del UserMatcher se genera en otros lugares
-    $code = ...;
-
-    $userMatcherCache->write($code, $resources);
-}
-
-// posiblemente desees requerir el código almacenado en caché:
-require $cachePath;
-
                  -
                  -

                  En modo de depuración, se creará un archivo .meta en el mismo directorio que el propio archivo de caché. Este archivo .meta contiene los recursos serializados, cuya marca de tiempo se utiliza para determinar si la caché todavía está fresca. Cuando no estás en modo de depuración, la caché se considera que es «fresca» tan pronto como existe, y por lo tanto no se generará el archivo .meta.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/config/definition.html b/components/config/definition.html deleted file mode 100644 index b476c1a..0000000 --- a/components/config/definition.html +++ /dev/null @@ -1,601 +0,0 @@ - - - - - - - Definiendo y procesando valores de configuración — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Definiendo y procesando valores de configuración

                  -
                  -

                  Validando valores de configuración

                  -

                  Después de cargar los valores de configuración de todo tipo de recursos, los valores y su estructura se pueden validar usando la parte «Definición» del componente Config. Generalmente, se espera que los valores de configuración muestren algún tipo de jerarquía. Además, los valores deben ser de un determinado tipo, estar limitados en número o ser uno de un determinado conjunto de valores. Por ejemplo, la siguiente configuración (en YAML) muestra una clara jerarquía y algunas reglas de validación que se deben aplicar (como: «el valor de auto_connect debe ser un valor booleano»):

                  -
                  auto_connect: true
-default_connection: mysql
-connections:
-    mysql:
-        host: localhost
-        driver: mysql
-        username: user
-        password: pass
-    sqlite:
-        host: localhost
-        driver: sqlite
-        memory: true
-        username: user
-        password: pass
-
                  -
                  -

                  Al cargar varios archivos de configuración, debería ser posible combinar y sobrescribir algunos valores. Otros valores no se deben fusionar y quedarse como estaban cuando se encontraron por primera vez. Además, algunas claves sólo están disponibles cuando otra clave tiene un valor específico (en la configuración del ejemplo anterior: la clave memory sólo tiene sentido cuando driver es sqlite).

                  -
                  -
                  -

                  Definiendo una jerarquía de valores configuración usando el TreeBuilder

                  -

                  Puedes definir todas las normas relativas a los valores de configuración usando el Symfony\Component\Config\Definition\Builder\TreeBuilder.

                  -

                  Debes devolver una instancia de Symfony\Component\Config\Definition\Builder\TreeBuilder desde una clase Configuration personalizada que implemente la Symfony\Component\Config\Definition\ConfigurationInterface:

                  -
                  namespace Acme\DatabaseConfiguration;
-
-use Symfony\Component\Config\Definition\ConfigurationInterface;
-use Symfony\Component\Config\Definition\Builder\TreeBuilder;
-
-class DatabaseConfiguration implements ConfigurationInterface
-{
-    public function getConfigTreeBuilder()
-    {
-        $treeBuilder = new TreeBuilder();
-        $rootNode = $treeBuilder->root('database');
-
-        // ... añade definiciones de nodo a la raíz del árbol
-
-        return $treeBuilder;
-    }
-}
-
                  -
                  -
                  -
                  -

                  Añadiendo definiciones de nodo al árbol

                  -
                  -

                  Variables de nodo

                  -

                  Un árbol contiene definiciones de nodo que se pueden establecer de manera semántica. -Esto significa que, usando la sangría y una sencilla notación, es posible reflejar la estructura real de los valores de configuración:

                  -
                  $rootNode
-    ->children()
-        ->booleanNode('auto_connect')
-            ->defaultTrue()
-        ->end()
-        ->scalarNode('default_connection')
-            ->defaultValue('default')
-        ->end()
-    ->end()
-;
-
                  -
                  -

                  El nodo raíz en sí es un arreglo de nodos, y tiene hijos, como el nodo booleano auto_connect y el nodo escalar default_connection. En general: -después de definir un nodo, una llamada a end() te lleva un paso más arriba en la jerarquía.

                  -
                  -
                  -

                  Tipo «node»

                  -

                  Es posible validar el tipo de un valor proporcionado utilizando la definición -de nodo apropiada. El tipo de nodo está disponible para:

                  -
                    -
                  • scalar
                    • -
                  • boolean
                    • -
                  • array
                    • -
                  • enum (nuevo en 2.1)
                    • -
                  • integer (nuevo en 2.2)
                    • -
                  • float (nuevo en 2.2)
                    • -
                  • variable (sin validación)
                    • -
                  -

                  y se crean con node($nombre, $tipo) o su método abreviado asociado -xxxxNode($nombre).

                  -
                  -
                  -

                  Restricciones de nodos numéricos

                  -

                  -Nuevo en la versión 2.2: Los nodos numéricos (float e integer) son nuevos en 2.2

                  -

                  Los nodos numéricos (float e integer) proporcionan dos restricciones extra — -min() y -max() — que te permiten validar el valor:

                  -
                  $rootNode
-    ->children()
-        ->integerNode('positive_value')
-            ->min(0)
-        ->end()
-        ->floatNode('big_value')
-            ->max(5E45)
-        ->end()
-        ->integerNode('value_inside_a_range')
-            ->min(-50)->max(50)
-        ->end()
-    ->end()
-;
-
                  -
                  -
                  -
                  -

                  Nodos del arreglo

                  -

                  Es posible añadir un nivel más profundo a la jerarquía, añadiendo un nodo al arreglo. El arreglo de nodos en sí mismo, puede tener un conjunto predefinido de variables de nodo:

                  -
                  $rootNode
-    ->children()
-        ->arrayNode('connection')
-            ->children()
-                ->scalarNode('driver')->end()
-                ->scalarNode('host')->end()
-                ->scalarNode('username')->end()
-                ->scalarNode('password')->end()
-            ->end()
-        ->end()
-    ->end()
-;
-
                  -
                  -

                  O puedes definir un prototipo para cada nodo dentro del arreglo de nodos:

                  -
                  $rootNode
-    ->children()
-        ->arrayNode('connections')
-            ->prototype('array')
-            ->children()
-                ->scalarNode('driver')->end()
-                ->scalarNode('host')->end()
-                ->scalarNode('username')->end()
-                ->scalarNode('password')->end()
-            ->end()
-        ->end()
-    ->end()
-;
-
                  -
                  -

                  Puedes utilizar un prototipo para añadir una definición la cual se puede repetir muchas veces dentro del nodo actual. De acuerdo con la definición del prototipo en el ejemplo anterior, es posible tener varios arreglos de conexión (conteniendo un driver, host, etc.).

                  -
                  -
                  -

                  Opciones del arreglo de nodos

                  -

                  Antes de definir los hijos de un arreglo de nodos, puedes proveer opciones como:

                  -
                  -
                  useAttributeAsKey()
                  -
                  Provee el nombre de un nodo hijo, dónde se debe usar el valor como la clave en el arreglo resultante.
                  -
                  requiresAtLeastOneElement()
                  -
                  Cuando menos debe haber un elemento en el arreglo (únicamente trabaja cuando también se invoca a isRequired()).
                  -
                  addDefaultsIfNotSet()
                  -
                  Si algún nodo hijo tiene valores predefinidos, se utilizan si no proporcionas valores explícitos.
                  -
                  -

                  Un ejemplo de esto:

                  -
                  $rootNode
-    ->children()
-        ->arrayNode('parameters')
-            ->isRequired()
-            ->requiresAtLeastOneElement()
-            ->useAttributeAsKey('name')
-            ->prototype('array')
-                ->children()
-                    ->scalarNode('value')->isRequired()->end()
-                ->end()
-            ->end()
-        ->end()
-    ->end()
-;
-
                  -
                  -

                  En YAML, la configuración podría tener esta apariencia:

                  -
                  database:
-    parameters:
-        param1: { value: param1val }
-
                  -
                  -

                  En XML, cada nodo parameters tendría un atributo name (junto con -value), el cual se sacaría y utilizarí como la clave para ese elemento en el -arreglo final. El useAttributeAsKey es útil para normalizar cómo se especifican los arreglos entre diferentes formatos como XML y YAML.

                  -
                  -
                  -
                  -

                  Valores predefinidos y requeridos

                  -

                  Para todos los tipos de nodo, es posible definir valores predeterminados y valores de sustitución en caso de que un nodo tenga un cierto valor:

                  -
                  -
                  defaultValue()
                  -
                  Establece un valor predeterminado
                  -
                  isRequired()
                  -
                  Se debe definir (pero puede estar vacío)
                  -
                  cannotBeEmpty()
                  -
                  No puede contener un valor vacío
                  -
                  default*()
                  -
                  (null, true, false), acceso directo para defaultValue()
                  -
                  treat*Like()
                  -
                  (null, true, false), provee un valor sustituto en caso de que el valor sea *.
                  -
                  -
                  $rootNode
-    ->children()
-        ->arrayNode('connection')
-            ->children()
-                ->scalarNode('driver')
-                    ->isRequired()
-                    ->cannotBeEmpty()
-                ->end()
-                ->scalarNode('host')
-                    ->defaultValue('localhost')
-                ->end()
-                ->scalarNode('username')->end()
-                ->scalarNode('password')->end()
-                ->booleanNode('memory')
-                    ->defaultFalse()
-                ->end()
-            ->end()
-        ->end()
-        ->arrayNode('settings')
-            ->addDefaultsIfNotSet()
-            ->children()
-                ->scalarNode('name')
-                    ->isRequired()
-                    ->cannotBeEmpty()
-                    ->defaultValue('value')
-                ->end()
-            ->end()
-        ->end()
-    ->end()
-;
-
                  -
                  -
                  -
                  -

                  Secciones opcionales

                  -

                  -Nuevo en la versión 2.2: Los métodos canBeEnabled y canBeDisabled son nuevos en Symfony 2.2

                  -

                  Si tienes secciones enteras que son opcionales y se pueden activar/desactivar, puedes aprovechar los métodos abreviados canBeEnabled() y -canBeDisabled():

                  -
                  $arrayNode
-    ->canBeEnabled()
-;
-
-// es equivalente a
-
-$arrayNode
-    ->treatFalseLike(array('enabled' => false))
-    ->treatTrueLike(array('enabled' => true))
-    ->treatNullLike(array('enabled' => true))
-    ->children()
-        ->booleanNode('enabled')
-            ->defaultFalse()
-;
-
                  -
                  -

                  El método canBeDisabled se ve igual salvo que de manera predefinida la sección estaría habilitada.

                  -
                  -
                  -

                  Combinando opciones

                  -

                  Puedes proporcionar opciones adicionales sobre el proceso de mezcla. Para arreglos:

                  -
                  -
                  performNoDeepMerging()
                  -
                  Cuando también defines el valor en un segundo arreglo de configuración, no se intenta combinar un arreglo, sino que lo sobrescribe por completo.
                  -
                  -

                  Para todos los nodos:

                  -
                  -
                  cannotBeOverwritten()
                  -
                  No permite que otros arreglos de configuración sobrescriban un valor existente de este nodo.
                  -
                  -
                  -
                  -

                  Anexando secciones

                  -

                  Si tienes una configuración de validación compleja, entonces el árbol puede crecer bastante y posiblemente quieras dividirlo en secciones. Lo puedes conseguir haciendo una sección en un nodo separado y luego anexándolo al árbol principal con append():

                  -
                  public function getConfigTreeBuilder()
-{
-    $treeBuilder = new TreeBuilder();
-    $rootNode = $treeBuilder->root('database');
-
-    $rootNode
-        ->children()
-            ->arrayNode('connection')
-                ->children()
-                    ->scalarNode('driver')
-                        ->isRequired()
-                        ->cannotBeEmpty()
-                    ->end()
-                    ->scalarNode('host')
-                        ->defaultValue('localhost')
-                    ->end()
-                    ->scalarNode('username')->end()
-                    ->scalarNode('password')->end()
-                    ->booleanNode('memory')
-                        ->defaultFalse()
-                    ->end()
-                ->end()
-                ->append($this->addParametersNode())
-            ->end()
-        ->end()
-    ;
-
-    return $treeBuilder;
-}
-
-public function addParametersNode()
-{
-    $builder = new TreeBuilder();
-    $node = $builder->root('parameters');
-
-    $node
-        ->isRequired()
-        ->requiresAtLeastOneElement()
-        ->useAttributeAsKey('name')
-        ->prototype('array')
-            ->children()
-                ->scalarNode('value')->isRequired()->end()
-            ->end()
-        ->end()
-    ;
-
-    return $node;
-}
-
                  -
                  -

                  Esto también es útil para ayudarte a evitar repeticiones si tienes repetida la configuración de esas secciones en diferentes sitios.

                  -
                  -
                  -

                  Normalización

                  -

                  Cuándo son procesados los archivos de configuración primero se normalizan, luego se fusionan -y finalmente el árbol se usa para validar el arreglo resultante. El proceso de normalización se usa para sacar algunos de las diferencias que resultan de diferentes formatos de configuración, principalmente las diferencias entre Yaml y XML.

                  -

                  El separador utilizado en las claves en Yaml típicamente es _ y - en XML. Por ejemplo, auto_connect en Yaml y auto-connect en XML. La normalización debería hacer que ambos fueran auto_connect.

                  -
                  -

                  Prudencia

                  -

                  La clave destino no será alterada si está mezclada como foo-bar_moo o si ya existe.

                  -
                  -

                  Otra diferencia entre Yaml y XML es la manera en que se pueden representar los valores del arreglo. En Yaml puedes tener:

                  -
                  twig:
-    extensions: ['twig.extension.foo', 'twig.extension.bar']
-
                  -
                  -

                  y en XML:

                  -
                  <twig:config>
-    <twig:extension>twig.extension.foo</twig:extension>
-    <twig:extension>twig.extension.bar</twig:extension>
-</twig:config>
-
                  -
                  -

                  Esta diferencia se puede sacar en la normalización pluralizando la clave utilizada -en XML. Puedes especificar si deseas que un clave se pluralice de este modo con fixXmlConfig():

                  -
                  $rootNode
-    ->fixXmlConfig('extension')
-    ->children()
-        ->arrayNode('extensions')
-            ->prototype('scalar')->end()
-        ->end()
-    ->end()
-;
-
                  -
                  -

                  Si es una pluralización irregular puedes especificar el plural a utilizar como -segundo argumento:

                  -
                  $rootNode
-    ->fixXmlConfig('child', 'children')
-    ->children()
-        ->arrayNode('children')
-    ->end()
-;
-
                  -
                  -

                  Así como se corrigió este, fixXmlConfig garantiza que solo los elementos -XML todavía se convierten en un arreglo. Por lo tanto puedes tener:

                  -
                  <connection>default</connection>
-<connection>extra</connection>
-
                  -
                  -

                  y a veces sólo:

                  -
                  <connection>default</connection>
-
                  -
                  -

                  De manera predefinida connection sería un arreglo en el primer caso y una cadena -en el segundo dificultando su validación. Puedes garantizar que siempre sea un arreglo con con fixXmlConfig.

                  -

                  Puedes controlar el proceso de normalización más allá, de ser necesario. Por ejemplo, posiblemente quieras permitir que se pueda configurar una cadena y utilizarla como una clave particular o que se configuren varias claves explícitamente. De modo que, si todo aparte del name es opcional en esta configuración:

                  -
                  connection:
-    name: my_mysql_connection
-    host: localhost
-    driver: mysql
-    username: user
-    password: pass
-
                  -
                  -

                  También puedes permitir lo siguiente:

                  -
                  connection: my_mysql_connection
-
                  -
                  -

                  Cambiando el valor de una cadena a un arreglo asociativo con name como la clave:

                  -
                  $rootNode
-    ->children()
-        ->arrayNode('connection')
-            ->beforeNormalization()
-            ->ifString()
-                ->then(function($v) { return array('name'=> $v); })
-            ->end()
-            ->children()
-                ->scalarNode('name')->isRequired()
-                // ...
-            ->end()
-        ->end()
-    ->end()
-;
-
                  -
                  -
                  -
                  -

                  Reglas de validación

                  -

                  Puedes proporcionar reglas de validación más avanzadas utilizando la Symfony\Component\Config\Definition\Builder\ExprBuilder. Este constructor implementa una interfaz fluida para un bien conocido control de la estructura. -El constructor se utiliza para agregar reglas avanzadas de validación a las definiciones de nodo, como:

                  -
                  $rootNode
-    ->children()
-        ->arrayNode('connection')
-            ->children()
-                ->scalarNode('driver')
-                    ->isRequired()
-                    ->validate()
-                    ->ifNotInArray(array('mysql', 'sqlite', 'mssql'))
-                        ->thenInvalid('Invalid database driver "%s"')
-                    ->end()
-                ->end()
-            ->end()
-        ->end()
-    ->end()
-;
-
                  -
                  -

                  Una regla de validación siempre tiene una parte «if». Puedes especificar esta parte de las siguientes maneras:

                  -
                    -
                  • ifTrue()
                    • -
                  • ifString()
                    • -
                  • ifNull()
                    • -
                  • ifArray()
                    • -
                  • ifInArray()
                    • -
                  • ifNotInArray()
                    • -
                  • always()
                    • -
                  -

                  Una regla de validación también requiere una parte «then»:

                  -
                    -
                  • then()
                    • -
                  • thenEmptyArray()
                    • -
                  • thenInvalid()
                    • -
                  • thenUnset()
                    • -
                  -

                  Normalmente, «then» es un cierre. Su valor de retorno se utiliza como un nuevo valor para el nodo, en lugar del valor original.

                  -
                  -
                  -

                  Procesando valores de configuración

                  -

                  La clase Symfony\Component\Config\Definition\Processor utiliza el árbol que fue construido usando el Symfony\Component\Config\Definition\Builder\TreeBuilder para procesar múltiples arreglos de valores de configuración que se deben combinar. -Si algún valor no es del tipo esperado, todavía es obligatorio e indefinido, o no se pudo validar de alguna otra manera, será lanzada una excepción. -De lo contrario, el resultado es un arreglo de valores de configuración limpio:

                  -
                  use Symfony\Component\Yaml\Yaml;
-use Symfony\Component\Config\Definition\Processor;
-use Acme\DatabaseConfiguration;
-
-$config1 = Yaml::parse(__DIR__.'/src/Matthias/config/config.yml');
-$config2 = Yaml::parse(__DIR__.'/src/Matthias/config/config_extra.yml');
-
-$configs = array($config1, $config2);
-
-$processor = new Processor();
-$configuration = new DatabaseConfiguration;
-$processedConfiguration = $processor->processConfiguration(
-    $configuration,
-    $configs)
-;
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/config/index.html b/components/config/index.html deleted file mode 100644 index c419649..0000000 --- a/components/config/index.html +++ /dev/null @@ -1,161 +0,0 @@ - - - - - - - Config — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/config/introduction.html b/components/config/introduction.html deleted file mode 100644 index 6ad4892..0000000 --- a/components/config/introduction.html +++ /dev/null @@ -1,153 +0,0 @@ - - - - - - - El componente Config — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Config

                  -
                  -

                  Introducción

                  -

                  El componente Config proporciona varias clases para ayudarte a encontrar, cargar, combinar, autocompletar y validar los valores de configuración de cualquier tipo, sea cual sea su fuente, puede ser (YAML, XML, archivos INI, o por ejemplo, una base de datos).

                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/config/resources.html b/components/config/resources.html deleted file mode 100644 index c8e3c8c..0000000 --- a/components/config/resources.html +++ /dev/null @@ -1,197 +0,0 @@ - - - - - - - Cargando recursos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cargando recursos

                  -
                  -

                  Localizando recursos

                  -

                  La carga de la configuración normalmente se inicia con la búsqueda de recursos, en la mayoría de los casos: archivos. Esto se puede hacer con el Symfony\Component\Config\FileLocator:

                  -
                  use Symfony\Component\Config\FileLocator;
-
-$configDirectories = array(__DIR__.'/app/config');
-
-$locator = new FileLocator($configDirectories);
-$yamlUserFiles = $locator->locate('users.yml', null, false);
-
                  -
                  -

                  El localizador recibe un conjunto de lugares donde se deben buscar los archivos. -El primer argumento de locate() es el nombre del archivo a buscar. El segundo argumento puede ser la ruta actual y cuando si lo suministras, el localizador primero verá en ese directorio. El tercer argumento indica si el localizador debe devolver el primer archivo encontrado, o un arreglo conteniendo todas las coincidencias.

                  -
                  -
                  -

                  Cargadores de recursos

                  -

                  Debes definir un cargador para cada tipo de recurso (YAML, XML, anotaciones, etc.). -Cada cargador debe implementar la Symfony\Component\Config\Loader\LoaderInterface o extender la clase abstracta Symfony\Component\Config\Loader\FileLoader, la cual permite la importación recursiva de otros recursos:

                  -
                  use Symfony\Component\Config\Loader\FileLoader;
-use Symfony\Component\Yaml\Yaml;
-
-class YamlUserLoader extends FileLoader
-{
-    public function load($resource, $type = null)
-    {
-        $configValues = Yaml::parse($resource);
-
-        // ... manipula los valores de configuración
-
-        // tal vez importe algún otro recurso:
-
-        // $this->import('extra_users.yml');
-    }
-
-    public function supports($resource, $type = null)
-    {
-        return is_string($resource) && 'yml' === pathinfo(
-            $resource,
-            PATHINFO_EXTENSION
-        );
-    }
-}
-
                  -
                  -
                  -
                  -

                  Encontrando el cargador adecuado

                  -

                  La clase Symfony\Component\Config\Loader\LoaderResolver recibe como primer argumento el constructor de una colección de cargadores. Cuando se debe cargar un recurso (por ejemplo, un archivo XML), este realiza un bucle a través de esta colección de cargadores y devuelve el cargador compatible con ese tipo de recurso en particular.

                  -

                  La clase Symfony\Component\Config\Loader\DelegatingLoader usa el Symfony\Component\Config\Loader\LoaderResolver. Cuando se le pide que cargue un recurso, delega esta cuestión a la clase Symfony\Component\Config\Loader\LoaderResolver. En caso de que la resolución haya encontrado un cargador adecuado, se le pedirá a ese cargador que cargue el recurso:

                  -
                  use Symfony\Component\Config\Loader\LoaderResolver;
-use Symfony\Component\Config\Loader\DelegatingLoader;
-
-$loaderResolver = new LoaderResolver(array(new YamlUserLoader($locator)));
-$delegatingLoader = new DelegatingLoader($loaderResolver);
-
-$delegatingLoader->load(__DIR__.'/users.yml');
-/*
-El YamlUserLoader se utiliza para cargar este recurso,
-debido a que es compatible con la extensión de archivo
-".yml"
-*/
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console.html b/components/console.html deleted file mode 100644 index 37b784b..0000000 --- a/components/console.html +++ /dev/null @@ -1,408 +0,0 @@ - - - - - - - El componente Console — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Console

                  -
                  -
                  El componente Console facilita la creación de bellas y comprobables interfaces de línea de ordenes.
                  -

                  El componente Console te permite crear instrucciones para la línea de ordenes. Tus ordenes de consola se pueden utilizar para cualquier tarea repetitiva, como tareas programadas (cronjobs), importaciones, u otros trabajos por lotes.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  -
                    -
                  • Usando el repositorio Git oficial (https://github.com/symfony/Console);
                    • -
                  • Instalándolo a través de PEAR (pear.symfony.com/Console);
                    • -
                  • Instalándolo vía Composer (symfony/console en Packagist).
                    • -
                  -
                  -
                  -

                  Creando una orden básica

                  -

                  Para hacer una orden de consola que nos de la bienvenida desde la línea de ordenes, crea el archivo GreetCommand.php y agrégale lo siguiente:

                  -
                  namespace Acme\DemoBundle\Command;
-
-use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\Input\InputArgument;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Input\InputOption;
-use Symfony\Component\Console\Output\OutputInterface;
-
-class GreetCommand extends Command
-{
-    protected function configure()
-    {
-        $this
-            ->setName('demo:greet')
-            ->setDescription('Greet someone')
-            ->addArgument('name', InputArgument::OPTIONAL, 'Who do you want to greet?')
-            ->addOption('yell', null, InputOption::VALUE_NONE, 'If set, the task will yell in uppercase letters')
-        ;
-    }
-
-    protected function execute(InputInterface $input, OutputInterface $output)
-    {
-        $name = $input->getArgument('name');
-        if ($name) {
-            $text = 'Hello '.$name;
-        } else {
-            $text = 'Hello';
-        }
-
-        if ($input->getOption('yell')) {
-            $text = strtoupper($text);
-        }
-
-        $output->writeln($text);
-    }
-}
-
                  -
                  -

                  También necesitas crear el archivo para ejecutar la línea de ordenes, el cual crea una Application y le agrega ordenes:

                  -
                  #!/usr/bin/env php
-# app/console
-<?php
-
-use Acme\DemoBundle\Command\GreetCommand;
-use Symfony\Component\Console\Application;
-
-$application = new Application();
-$application->add(new GreetCommand);
-$application->run();
-
                  -
                  -

                  Prueba la nueva consola de ordenes ejecutando lo siguiente

                  -
                  $ app/console demo:greet Fabien
-
                  -
                  -

                  Esto imprimirá lo siguiente en la línea de ordenes:

                  -
                  Hello Fabien
-
                  -
                  -

                  También puedes utilizar la opción --yell para convertir todo a mayúsculas:

                  -
                  $ app/console demo:greet Fabien --yell
-
                  -
                  -

                  Esto imprime:

                  -
                  HELLO FABIEN
-
                  -
                  -
                  -

                  Coloreando la salida

                  -

                  Cada vez que produces texto, puedes escribir el texto con etiquetas para colorear tu salida. Por ejemplo:

                  -
                  // texto verde
-$output->writeln('<info>foo</info>');
-
-// texto amarillo
-$output->writeln('<comment>foo</comment>');
-
-// texto negro sobre fondo cían
-$output->writeln('<question>foo</question>');
-
-// texto blanco sobre fondo rojo
-$output->writeln('<error>foo</error>');
-
                  -
                  -

                  Es posible definir tu propio estilo usando la clase Symfony\Component\Console\Formatter\OutputFormatterStyle:

                  -
                  $style = new OutputFormatterStyle('red', 'yellow', array('bold', 'blink'));
-$output->getFormatter()->setStyle('fire', $style);
-$output->writeln('<fire>foo</fire>');
-
                  -
                  -

                  Los colores disponibles para el fondo y primer plano son: black, red, green, yellow, blue, magenta, cyan y white.

                  -

                  Y las opciones disponibles son: bold, underscore, blink, reverse y conceal.

                  -
                  -
                  -
                  -

                  Utilizando argumentos de ordenes

                  -

                  La parte más interesante de las ordenes son los argumentos y opciones que puedes hacer disponibles. Los argumentos son cadenas —separadas por espacios— que vienen después del nombre de la orden misma. Ellos están ordenados, y pueden ser opcionales u obligatorios. Por ejemplo, añade un argumento last_name opcional a la orden y haz que el argumento name sea obligatorio:

                  -
                  $this
-    // ...
-    ->addArgument('name', InputArgument::REQUIRED, 'Who do you want to greet?')
-    ->addArgument('last_name', InputArgument::OPTIONAL, 'Your last name?');
-
                  -
                  -

                  Ahora tienes acceso a un argumento last_name en la orden:

                  -
                  if ($lastName = $input->getArgument('last_name')) {
-    $text .= ' '.$lastName;
-}
-
                  -
                  -

                  Ahora la orden se puede utilizar en cualquiera de las siguientes maneras:

                  -
                  $ app/console demo:greet Fabien
-$ app/console demo:greet Fabien Potencier
-
                  -
                  -
                  -
                  -

                  Usando las opciones de la orden

                  -

                  A diferencia de los argumentos, las opciones no están ordenadas (lo cual significa que las puedes especificar en cualquier orden) y se especifican con dos guiones (por ejemplo, --yell también puedes declarar un atajo de una letra que puedes invocar con un único guión como -y). Las opciones son: always opcional, y se puede configurar para aceptar un valor (por ejemplo, dir=src) o simplemente como una variable lógica sin valor (por ejemplo, yell).

                  -
                  -

                  Truco

                  -

                  También es posible hacer que un argumento opcionalmente acepte un valor (de modo que --yell o yell=loud funcione). Las opciones también se pueden configurar para aceptar una matriz de valores.

                  -
                  -

                  Por ejemplo, añadir una nueva opción a la orden que se puede usar para especificar cuántas veces se debe imprimir el mensaje en una fila:

                  -
                  $this
-    // ...
-    ->addOption('iterations', null, InputOption::VALUE_REQUIRED, 'How many times should the message be printed?', 1);
-
                  -
                  -

                  A continuación, utilízalo en la orden para imprimir el mensaje varias veces:

                  -
                  for ($i = 0; $i < $input->getOption('iterations'); $i++) {
-    $output->writeln($text);
-}
-
                  -
                  -

                  Ahora, al ejecutar la tarea, si lo deseas, puedes especificar un indicador --iterations:

                  -
                  $ app/console demo:greet Fabien
-$ app/console demo:greet Fabien --iterations=5
-
                  -
                  -

                  El primer ejemplo sólo se imprimirá una vez, ya que iterations está vacía y el predeterminado es 1 (el último argumento de addOption). El segundo ejemplo se imprimirá cinco veces.

                  -

                  Recordemos que a las opciones no les preocupa su orden. Por lo tanto, cualquiera de las siguientes trabajará:

                  -
                  $ app/console demo:greet Fabien --iterations=5 --yell
-$ app/console demo:greet Fabien --yell --iterations=5
-
                  -
                  -

                  Hay 4 variantes de la opción que puedes utilizar:

                  - ---- - - - - - - - - - - - - - - - - - - - -
                  OpciónValor
                  InputOption::VALUE_IS_ARRAYEsta opción acepta múltiples valores (por ejemplo: --dir=/foo --dir=/bar)
                  InputOption::VALUE_NONENo acepta entradas para esta opción (por ejemplo: --yell)
                  InputOption::VALUE_REQUIREDEste valor es obligatorio (por ejemplo: --iterations=5), la opción es sí misma aún es opcional
                  InputOption::VALUE_OPTIONALEsta opción puede o no tener un valor (por ejemplo: yell o yell=loud)
                  -

                  Puedes combinar el VALUE_IS_ARRAY con VALUE_REQUIRED o VALUE_OPTIONAL de la siguiente manera:

                  -
                  $this
-    // ...
-    ->addOption('iterations', null, InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY, 'How many times should the message be printed?', 1);
-
                  -
                  -
                  -
                  -

                  Pidiendo información al usuario

                  -

                  Al crear ordenes, tienes la capacidad de recopilar más información de los usuarios haciéndoles preguntas. Por ejemplo, supongamos que deseas confirmar una acción antes de llevarla a cabo realmente. Añade lo siguiente a tu orden:

                  -
                  $dialog = $this->getHelperSet()->get('dialog');
-if (!$dialog->askConfirmation($output, '<question>Continue with this action?</question>', false)) {
-    return;
-}
-
                  -
                  -

                  En este caso, el usuario tendrá que “Continuar con esta acción”, y, a menos que responda con y, la tarea se detendrá. El tercer argumento de askConfirmation es el valor predeterminado que se devuelve si el usuario no introduce algo.

                  -

                  También puedes hacer preguntas con más que una simple respuesta sí/no. Por ejemplo, si necesitas saber el nombre de algo, puedes hacer lo siguiente:

                  -
                  $dialog = $this->getHelperSet()->get('dialog');
-$name = $dialog->ask($output, 'Please enter the name of the widget', 'foo');
-
                  -
                  -
                  -
                  -

                  Probando ordenes

                  -

                  Symfony2 proporciona varias herramientas para ayudarte a probar las ordenes. La más útil es la clase Symfony\Component\Console\Tester\CommandTester. Esta utiliza clases entrada y salida especiales para facilitar la prueba sin una consola real:

                  -
                  use Symfony\Component\Console\Application;
-use Symfony\Component\Console\Tester\CommandTester;
-use Acme\DemoBundle\Command\GreetCommand;
-
-class ListCommandTest extends \PHPUnit_Framework_TestCase
-{
-    public function testExecute()
-    {
-        $application = new Application();
-        $application->add(new GreetCommand());
-
-        $command = $application->find('demo:greet');
-        $commandTester = new CommandTester($command);
-        $commandTester->execute(array('command' => $command->getName()));
-
-        $this->assertRegExp('/.../', $commandTester->getDisplay());
-
-        // ...
-    }
-}
-
                  -
                  -

                  El método getDisplay() devuelve lo que se ha exhibido durante una llamada normal de la consola.

                  -

                  Puedes probar enviando argumentos y opciones a la orden pasándolos como una matriz al método getDisplay():

                  -
                  use Symfony\Component\Console\Application;
-use Symfony\Component\Console\Tester\CommandTester;
-use Acme\DemoBundle\Command\GreetCommand;
-
-class ListCommandTest extends \PHPUnit_Framework_TestCase
-{
-    // ...
-
-    public function testNameIsOutput()
-    {
-        $application = new Application();
-        $application->add(new GreetCommand());
-
-        $command = $application->find('demo:greet');
-        $commandTester = new CommandTester($command);
-        $commandTester->execute(
-            array('command' => $command->getName(), 'name' => 'Fabien')
-        );
-
-        $this->assertRegExp('/Fabien/', $commandTester->getDisplay());
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  También puedes probar toda una aplicación de consola utilizando Symfony\Component\Console\Tester\ApplicationTester.

                  -
                  -
                  -
                  -

                  Llamando una orden existente

                  -

                  Si una orden depende de que se ejecute otra antes, en lugar de obligar al usuario a recordar el orden de ejecución, puedes llamarla directamente tú mismo. -Esto también es útil si deseas crear una “metaorden” que ejecute un montón de otras ordenes (por ejemplo, todas las ordenes que se deben ejecutar cuando el código del proyecto ha cambiado en los servidores de producción: vaciar la caché, generar delegados Doctrine2, volcar activos Assetic, ...).

                  -

                  Llamar a una orden desde otra es sencillo:

                  -
                  protected function execute(InputInterface $input, OutputInterface $output)
-{
-    $command = $this->getApplication()->find('demo:greet');
-
-    $arguments = array(
-        'command' => 'demo:greet',
-        'name'    => 'Fabien',
-        '--yell'  => true,
-    );
-
-    $input = new ArrayInput($arguments);
-    $returnCode = $command->run($input, $output);
-
-    // ...
-}
-
                  -
                  -

                  En primer lugar, tu find() busca la orden que deseas ejecutar pasando el nombre de la orden.

                  -

                  Entonces, es necesario crear una nueva clase Symfony\Component\Console\Input\ArrayInput con los argumentos y opciones que desees pasar a la orden.

                  -

                  Finalmente, invocar al método run() ejecuta la orden realmente y devuelve el código devuelto de la orden (el valor del método execute()).

                  -
                  -

                  Nota

                  -

                  La mayor parte del tiempo, llamar a una orden desde código que no se ejecuta en la línea de ordenes no es una buena idea por varias razones. En primer lugar, la salida de la orden se ha optimizado para la consola. Pero lo más importante, puedes pensar de una orden como si fuera un controlador; este debe utilizar el modelo para hacer algo y mostrar algún comentario al usuario. Así, en lugar de llamar una orden desde la Web, reconstruye tu código y mueve la lógica a una nueva clase.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/events.html b/components/console/events.html deleted file mode 100644 index 2165880..0000000 --- a/components/console/events.html +++ /dev/null @@ -1,225 +0,0 @@ - - - - - - - Usando eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Usando eventos

                  -

                  -Nuevo en la versión 2.3: Los eventos de consola se añadieron en Symfony 2.3.

                  -

                  La clase Application del componente Console te permite engancharla opcionalmente al ciclo de vida de una aplicación de consola a través de eventos. En vez de reinventar la rueda, esta utiliza el componente EventDispatcher de Symfony para hacer el trabajo:

                  -
                  use Symfony\Component\Console\Application;
-use Symfony\Component\EventDispatcher\EventDispatcher;
-
-$application = new Application();
-$application->setDispatcher($dispatcher);
-$application->run();
-
                  -
                  -
                  -

                  El evento ConsoleEvents::COMMAND

                  -

                  Propósito típico: Hacer algo antes de ejecutar cualquier orden (tal como registrar qué orden se va a ejecutar), o mostrar algo sobre el evento a ejecutar.

                  -

                  Justo antes de ejecutar cualquier orden, se despacha el evento ConsoleEvents::COMMAND. Lo escuchas reciben un evento Symfony\Component\Console\Event\ConsoleCommandEvent:

                  -
                  use Symfony\Component\Console\Event\ConsoleCommandEvent;
-use Symfony\Component\Console\ConsoleEvents;
-
-$dispatcher->addListener(ConsoleEvents::COMMAND, function (ConsoleCommandEvent $event) {
-    // consigue la instancia de entrada
-    $input = $event->getInput();
-
-    // consigue la instancia de salida
-    $output = $event->getOutput();
-
-    // consigue la orden a ejecutar
-    $command = $event->getCommand();
-
-    // escribe algo sobre la orden
-    $output->writeln(sprintf('Before running command <info>%s</info>', $command->getName()));
-
-    // consigue la aplicación
-    $application = $command->getApplication();
-});
-
                  -
                  -
                  -
                  -

                  El evento ConsoleEvents::TERMINATE

                  -

                  Propósito típico: Para realizar alguna limpieza en las acciones después de ejecutar la orden.

                  -

                  Después de ejecutar la orden, se despacha el evento``ConsoleEvents::TERMINATE``. Este se puede se puede usar para hacer cualquier acción que se deba ejecutar para todas las -órdenes o para limpiar lo que iniciaste en un escucha de ConsoleEvents::COMMAND (como enviar registros, cerrar una conexión de base de datos, enviar correos electrónicos, ...). Un escucha también podría cambiar el código de salida.

                  -

                  Los escuchas reciben un evento Symfony\Component\Console\Event\ConsoleTerminateEvent:

                  -
                  use Symfony\Component\Console\Event\ConsoleTerminateEvent;
-use Symfony\Component\Console\ConsoleEvents;
-
-$dispatcher->addListener(ConsoleEvents::TERMINATE, function (ConsoleTerminateEvent $event) {
-    // consigue la salida
-    $output = $event->getOutput();
-
-    // consigue la orden que se ha ejecutado
-    $command = $event->getCommand();
-
-    // muestra algo
-    $output->writeln(sprintf('After running command <info>%s</info>', $command->getName()));
-
-    // cambia el código de salida
-    $event->setExitCode(128);
-});
-
                  -
                  -
                  -

                  Truco

                  -

                  Este evento también se despacha cuando la orden lanza una excepción. -Este entonces se despacha justo antes del evento ConsoleEvents::EXCEPTION. -El código de salida recibido en este caso es el código de la excepción.

                  -
                  -
                  -
                  -

                  El evento ConsoleEvents::EXCEPTION

                  -

                  Propósito típico: manejar excepciones lanzadas durante la ejecución de una orden.

                  -

                  Siempre que una orden lanza una excepción, se lanza el evento ConsoleEvents::EXCEPTION. Un escucha puede envolver o cambiar la excepción o hacer cualquier cosa útil antes de que la aplicación lance la excepción.

                  -

                  Los escuchas reciben un evento Symfony\Component\Console\Event\ConsoleForExceptionEvent:

                  -
                  use Symfony\Component\Console\Event\ConsoleForExceptionEvent;
-use Symfony\Component\Console\ConsoleEvents;
-
-$dispatcher->addListener(ConsoleEvents::EXCEPTION, function (ConsoleForExceptionEvent $event) {
-    $output = $event->getOutput();
-
-    $output->writeln(sprintf('Oops, exception thrown while running command <info>%s</info>', $command->getName()));
-
-    // consigue el código de salida actual (el código de la excepción
-    // o el código de salida establecido por el evento
-    // ConsoleEvents::TERMINATE)
-    $exitCode = $event->getExitCode();
-
-    // cambia la excepción por otra
-    $event->setException(new \LogicException('Caught exception', $exitCode, $event->getException()));
-});
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/helpers/dialoghelper.html b/components/console/helpers/dialoghelper.html deleted file mode 100644 index 6437915..0000000 --- a/components/console/helpers/dialoghelper.html +++ /dev/null @@ -1,270 +0,0 @@ - - - - - - - Ayudantes de diálogo — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/helpers/formatterhelper.html b/components/console/helpers/formatterhelper.html deleted file mode 100644 index 26ddfe4..0000000 --- a/components/console/helpers/formatterhelper.html +++ /dev/null @@ -1,171 +0,0 @@ - - - - - - - Ayudante formateador — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Ayudante formateador

                  -

                  Los ayudantes formateadores proporcionan funciones para aplicar formato al resultado con colores. -Puedes hacer cosas más avanzadas con este ayudante de las que puedes hacer con Coloreando la salida.

                  -

                  La clase Symfony\Component\Console\Helper\FormatterHelper está incluida en el conjunto de ayudantes predefinido, el cual te puedes conseguir llamando al método getHelperSet():

                  -
                  $formatter = $this->getHelperSet()->get('formatter');
-
                  -
                  -

                  Los métodos regresan una cadena, la cual normalmente dibujas en la consola pasándola al -método OutputInterface::writeln

                  -
                  -

                  Imprimiendo mensajes en una sección

                  -

                  Symfony ofrece un estilo definido cuándo imprimes un mensaje que pertenece a alguna -«sección». Este imprime la sección en color encerrada entre corchetes y el mensaje real a la derecha de esta. Menos el color, tiene esta apariencia:

                  -
                  [SomeSection] Here is some message related to that section
-
                  -
                  -

                  Para reproducir este estilo, puedes utilizar el método formatSection():

                  -
                  $formattedLine = $formatter->formatSection(
-    'SomeSection',
-    'Here is some message related to that section'
-);
-$output->writeln($formattedLine);
-
                  -
                  -
                  -
                  -

                  Imprimiendo mensajes en un bloque

                  -

                  A veces quieres poder imprimir un bloque de texto entero con un color de fondo. Symfony lo usa al imprimir mensajes de error.

                  -

                  Si imprimes manualmente tu mensaje de error en más de una línea, notarás que el fondo es sólo a lo largo de cada línea individual. Usa el método formatBlock() para generar una producción de bloque:

                  -
                  $errorMessages = array('Error!', 'Something went wrong');
-$formattedBlock = $formatter->formatBlock($errorMessages, 'error');
-$output->writeln($formattedBlock);
-
                  -
                  -

                  Como puedes ver, al pasar un arreglo de mensajes al método formatBlock() el método crea el resultado deseado. Si pasas true como tercer argumento, el bloque será formateado con más relleno (una línea en blanco por encima y debajo de los mensajes y 2 espacios a la izquierda y derecha).

                  -

                  El «estilo» exacto a utilizar en el bloque depende de ti. En este caso, estás utilizando el estilo de error predefinido, pero hay otros estilos, o puedes crear el tuyo propio. Ve Coloreando la salida.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/helpers/index.html b/components/console/helpers/index.html deleted file mode 100644 index 15d773e..0000000 --- a/components/console/helpers/index.html +++ /dev/null @@ -1,142 +0,0 @@ - - - - - - - Los ayudantes de consola — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Los ayudantes de consola

                  -
                  -
                  -

                  Los componentes de Consola vienen con algunos útiles ayudantes. Estos ayudantes contienen funciones para aligerar algunas tareas comunes.

                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/helpers/progresshelper.html b/components/console/helpers/progresshelper.html deleted file mode 100644 index 9389763..0000000 --- a/components/console/helpers/progresshelper.html +++ /dev/null @@ -1,197 +0,0 @@ - - - - - - - El ayudante Progress — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El ayudante Progress

                  -

                  -Nuevo en la versión 2.2: El ayudante progress se añadió en Symfony 2.2.

                  -

                  -Nuevo en la versión 2.3: El método setCurrent se añadió en Symfony 2.3.

                  -

                  Cuándo ejecutes órdenes que consumen demasiado tiempo en su ejecución, puede ser útil mostrar información de progreso, la cual se actualiza conforme se ejecuta la orden:

                  -../../../_images/progress.png -

                  Para mostrar detalles de progreso, usa la clase Symfony\Component\Console\Helper\ProgressHelper, pasándole el número total de unidades, y adelanta el progreso conforme se ejecute la orden:

                  -
                  $progress = $this->getHelperSet()->get('progress');
-
-$progress->start($output, 50);
-$i = 0;
-while ($i++ < 50) {
-    // ... hace algún trabajo
-
-    // avanza la barra de progreso 1 unidad
-    $progress->advance();
-}
-
-$progress->finish();
-
                  -
                  -
                  -

                  Truco

                  -

                  Además, puedes ajustar el progreso actual llamando al método setCurrent().

                  -
                  -

                  El aspecto de la barra de progreso también se puede personalizar, con una serie -de diferentes niveles de detalle. Cada uno de los cuales muestra los diferentes elementos posibles —tal cómo porcentaje completado, una barra de progreso en movimiento, o información actual/total (por ejemplo, 10/50):

                  -
                  $progress->setFormat(ProgressHelper::FORMAT_QUIET);
-$progress->setFormat(ProgressHelper::FORMAT_NORMAL);
-$progress->setFormat(ProgressHelper::FORMAT_VERBOSE);
-$progress->setFormat(ProgressHelper::FORMAT_QUIET_NOMAX);
-// el valor predefinido
-$progress->setFormat(ProgressHelper::FORMAT_NORMAL_NOMAX);
-$progress->setFormat(ProgressHelper::FORMAT_VERBOSE_NOMAX);
-
                  -
                  -

                  También puedes controlar los diferentes caracteres y el ancho utilizado por la barra de progreso:

                  -
                  // la parte terminada de la barra
-$progress->setBarCharacter('<comment>=</comment>');
-// la parte inacabada de la barra
-$progress->setEmptyBarCharacter(' ');
-$progress->setProgressCharacter('|');
-$progress->setBarWidth(50);
-
                  -
                  -

                  Para ver otras opciones disponibles, revisa la clase Symfony\Component\Console\Helper\ProgressHelper en la documentación de la API.

                  -
                  -

                  Prudencia

                  -

                  Por razones de rendimiento, se prudente en no poner la cantidad total de pasos a un número alto. Por ejemplo, si estás iterando sobre una gran cantidad de elementos, considera un número de «paso» más pequeño que se actualizace en algunas iteraciones únicamente:

                  -
                  $progress->start($output, 500);
-$i = 0;
-while ($i++ < 50000) {
-    // ... hace algún trabajo
-
-    // avanza cada 100 iteraciones
-    if ($i % 100 == 0) {
-        $progress->advance();
-    }
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/helpers/tablehelper.html b/components/console/helpers/tablehelper.html deleted file mode 100644 index 3df8764..0000000 --- a/components/console/helpers/tablehelper.html +++ /dev/null @@ -1,177 +0,0 @@ - - - - - - - Ayudante Table — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Ayudante Table

                  -

                  -Nuevo en la versión 2.3: El ayudante table se añadió en Symfony 2.3.

                  -

                  Cuándo construyes una aplicación de consola puede ser útil mostrar datos tabulares:

                  -../../../_images/table.png -

                  Para mostrar una tabla, usa la clase Symfony\Component\Console\Helper\TableHelper, establece las cabeceras, filas y dibújala:

                  -
                  $table = $app->getHelperSet()->get('table');
-$table
-    ->setHeaders(array('ISBN', 'Title', 'Author'))
-    ->setRows(array(
-        array('99921-58-10-7', 'Divine Comedy', 'Dante Alighieri'),
-        array('9971-5-0210-0', 'A Tale of Two Cities', 'Charles Dickens'),
-        array('960-425-059-0', 'The Lord of the Rings', 'J. R. R. Tolkien'),
-        array('80-902734-1-6', 'And Then There Were None', 'Agatha Christie'),
-    ))
-;
-$table->render($output);
-
                  -
                  -

                  El diseño de la tabla se puede personalizar también. Hay dos maneras para personalizar la representación de la tabla: Utilizando diseños nombrados u opciones de representación personalizadas.

                  -
                  -

                  Personalizando el diseño de la tabla usando diseños nombrados

                  -

                  El ayudante table viene con dos diseños de tabla preconfigurados:

                  -
                    -
                  • TableHelper::LAYOUT_DEFAULT
                    • -
                  • TableHelper::LAYOUT_BORDERLESS
                    • -
                  -

                  Puedes configurar el diseño utilizando el método setLayout().

                  -
                  -
                  -

                  Personalizando el diseño de la tabla con opciones de dibujo

                  -

                  También puedes controlar cómo se dibuja la tabla poniendo los valores de la opción de dibujo:

                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/index.html b/components/console/index.html deleted file mode 100644 index ac396a6..0000000 --- a/components/console/index.html +++ /dev/null @@ -1,162 +0,0 @@ - - - - - - - Consola — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/introduction.html b/components/console/introduction.html deleted file mode 100644 index 04ccfc3..0000000 --- a/components/console/introduction.html +++ /dev/null @@ -1,511 +0,0 @@ - - - - - - - El componente Console — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Console

                  -
                  -
                  El componente Console facilita la creación de bellas y comprobables interfaces de línea de ordenes.
                  -

                  El componente Console te permite crear instrucciones para la línea de ordenes. Tus ordenes de consola se pueden utilizar para cualquier tarea repetitiva, como tareas programadas (cronjobs), importaciones, u otros trabajos por lotes.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -

                  Nota

                  -

                  Windows no apoya colores ANSI de manera predeterminada así que el componente Console detecta y deshabilita colores donde Windows no cuenta con soporte. Sin embargo, si Windows no está configurado con un controlador ANSI y tus órdenes de consola invocan a otros guiones que emiten secuencias de color ANSI, serán mostradas como secuencias de caracteres escapadas.

                  -

                  Para habilitar el apoyo de color ANSI en Windows, debes instalar ANSICON.

                  -
                  -
                  -
                  -

                  Creando una orden básica

                  -

                  Para hacer una orden de consola que dé la bienvenida desde la línea de ordenes, crea el archivo GreetCommand.php y agrégale lo siguiente:

                  -
                  namespace Acme\DemoBundle\Command;
-
-use Symfony\Component\Console\Command\Command;
-use Symfony\Component\Console\Input\InputArgument;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Input\InputOption;
-use Symfony\Component\Console\Output\OutputInterface;
-
-class GreetCommand extends Command
-{
-    protected function configure()
-    {
-        $this
-            ->setName('demo:greet')
-            ->setDescription('Greet someone')
-            ->addArgument(
-                'name',
-                InputArgument::OPTIONAL,
-                'Who do you want to greet?'
-            )
-            ->addOption(
-               'yell',
-               null,
-               InputOption::VALUE_NONE,
-               'If set, the task will yell in uppercase letters'
-            )
-        ;
-    }
-
-    protected function execute(InputInterface $input, OutputInterface $output)
-    {
-        $name = $input->getArgument('name');
-        if ($name) {
-            $text = 'Hello '.$name;
-        } else {
-            $text = 'Hello';
-        }
-
-        if ($input->getOption('yell')) {
-            $text = strtoupper($text);
-        }
-
-        $output->writeln($text);
-    }
-}
-
                  -
                  -

                  También necesitas crear el archivo para ejecutar la línea de ordenes, el cual crea una Application y le agrega ordenes:

                  -
                  #!/usr/bin/env php
-<?php
-// app/console
-
-use Acme\DemoBundle\Command\GreetCommand;
-use Symfony\Component\Console\Application;
-
-$application = new Application();
-$application->add(new GreetCommand);
-$application->run();
-
                  -
                  -

                  Prueba la nueva consola de ordenes ejecutando lo siguiente:

                  -
                  $ app/console demo:greet Fabien
-
                  -
                  -

                  Esto imprimirá lo siguiente en la línea de ordenes:

                  -
                  Hello Fabien
-
                  -
                  -

                  También puedes utilizar la opción --yell para convertir todo a mayúsculas:

                  -
                  $ app/console demo:greet Fabien --yell
-
                  -
                  -

                  Esto imprime:

                  -
                  HELLO FABIEN
-
                  -
                  -
                  -

                  Coloreando la salida

                  -

                  Cada vez que produces texto, puedes escribir el texto con etiquetas para colorear tu salida. Por ejemplo:

                  -
                  // texto verde
-$output->writeln('<info>foo</info>');
-
-// texto amarillo
-$output->writeln('<comment>foo</comment>');
-
-// texto negro sobre fondo cían
-$output->writeln('<question>foo</question>');
-
-// texto blanco sobre fondo rojo
-$output->writeln('<error>foo</error>');
-
                  -
                  -

                  Es posible definir tu propio estilo usando la clase Symfony\Component\Console\Formatter\OutputFormatterStyle:

                  -
                  $style = new OutputFormatterStyle('red', 'yellow', array('bold', 'blink'));
-$output->getFormatter()->setStyle('fire', $style);
-$output->writeln('<fire>foo</fire>');
-
                  -
                  -

                  Los colores disponibles para el fondo y primer plano son: black, red, green, yellow, blue, magenta, cyan y white.

                  -

                  Y las opciones disponibles son: bold, underscore, blink, reverse y conceal.

                  -

                  También puedes configurar estos colores y opciones dentro del nombre de la etiqueta:

                  -
                  // texto verde
-$output->writeln('<fg=green>foo</fg=green>');
-
-// texto negro en fondo cian
-$output->writeln('<fg=black;bg=cyan>foo</fg=black;bg=cyan>');
-
-// text negro en fondo amarillo
-$output->writeln('<bg=yellow;options=bold>foo</bg=yellow;options=bold>');
-
                  -
                  -
                  -
                  -

                  Niveles de verbosidad

                  -

                  La consola tiene 3 niveles de verbosidad. Estos están definidos en -la clase Symfony\Component\Console\Output\OutputInterface:

                  - ---- - - - - - - - - - - - - - - - - -
                  OpciónValor
                  OutputInterface::VERBOSITY_QUIETNo muestra ningún mensaje
                  OutputInterface::VERBOSITY_NORMALEl nivel de verbosidad predeterminado
                  OutputInterface::VERBOSITY_VERBOSEIncrementa la verbosidd de los mensajes
                  -

                  Puedes especificar el nivel de verbosidad tranquilo con la opción --quiet o -q. La opción --verbose o -v se utiliza cuando quieres aumentar el nivel de verbosidad.

                  -
                  -

                  Truco

                  -

                  La traza completa de la excepción se imprime si utilizas el nivel de verbosidad VERBOSITY_VERBOSE.

                  -
                  -

                  Es posible imprimir un mensaje en una orden para únicamente un nivel de verbosidad -específico. Por ejemplo:

                  -
                  if (OutputInterface::VERBOSITY_VERBOSE === $output->getVerbosity()) {
-    $output->writeln(...);
-}
-
                  -
                  -

                  Cuándo se utiliza el nivel tranquilo, toda la producción es suprimida como la regresa el método predeterminado SymfonyComponentConsoleOutput::write -sin de hecho imprimirla.

                  -
                  -
                  -
                  -

                  Utilizando argumentos de ordenes

                  -

                  La parte más interesante de las ordenes son los argumentos y opciones que puedes hacer disponibles. Los argumentos son cadenas —separadas por espacios— que vienen después del nombre de la orden misma. Ellos están ordenados, y pueden ser opcionales u obligatorios. Por ejemplo, añade un argumento last_name opcional a la orden y haz que el argumento name sea obligatorio:

                  -
                  $this
-    // ...
-    ->addArgument(
-        'name',
-        InputArgument::REQUIRED,
-        'Who do you want to greet?'
-    )
-    ->addArgument(
-        'last_name',
-        InputArgument::OPTIONAL,
-        'Your last name?'
-    );
-
                  -
                  -

                  Ahora tienes acceso a un argumento last_name en la orden:

                  -
                  if ($lastName = $input->getArgument('last_name')) {
-    $text .= ' '.$lastName;
-}
-
                  -
                  -

                  Ahora la orden se puede utilizar en cualquiera de las siguientes maneras:

                  -
                  $ app/console demo:greet Fabien
-$ app/console demo:greet Fabien Potencier
-
                  -
                  -
                  -
                  -

                  Usando las opciones de la orden

                  -

                  A diferencia de los argumentos, las opciones no están ordenadas (lo cual significa que las puedes especificar en cualquier orden) y se especifican con dos guiones (por ejemplo, --yell también puedes declarar un atajo de una letra que puedes invocar con un único guión como -y). Las opciones son: always opcional, y se puede configurar para aceptar un valor (por ejemplo, dir=src) o simplemente como una variable lógica sin valor (por ejemplo, yell).

                  -
                  -

                  Truco

                  -

                  También es posible hacer que un argumento opcionalmente acepte un valor (de modo que --yell o yell=loud funcione). Las opciones también se pueden configurar para aceptar un arreglo de valores.

                  -
                  -

                  Por ejemplo, añadir una nueva opción a la orden que se puede usar para especificar cuántas veces se debe imprimir el mensaje en una fila:

                  -
                  $this
-    // ...
-    ->addOption(
-        'iterations',
-        null,
-        InputOption::VALUE_REQUIRED,
-        'How many times should the message be printed?',
-        1
-    );
-
                  -
                  -

                  A continuación, utilízalo en la orden para imprimir el mensaje varias veces:

                  -
                  for ($i = 0; $i < $input->getOption('iterations'); $i++) {
-    $output->writeln($text);
-}
-
                  -
                  -

                  Ahora, al ejecutar la tarea, si lo deseas, puedes especificar un indicador --iterations:

                  -
                  $ app/console demo:greet Fabien
-$ app/console demo:greet Fabien --iterations=5
-
                  -
                  -

                  El primer ejemplo sólo se imprimirá una vez, ya que iterations está vacía y el predeterminado es 1 (el último argumento de addOption). El segundo ejemplo se imprimirá cinco veces.

                  -

                  Recordemos que a las opciones no les preocupa su orden. Por lo tanto, cualquiera de las siguientes trabajará:

                  -
                  $ app/console demo:greet Fabien --iterations=5 --yell
-$ app/console demo:greet Fabien --yell --iterations=5
-
                  -
                  -

                  Hay 4 variantes de la opción que puedes utilizar:

                  - ---- - - - - - - - - - - - - - - - - - - - -
                  OpciónValor
                  InputOption::VALUE_IS_ARRAYEsta opción acepta múltiples valores (por ejemplo: --dir=/foo --dir=/bar)
                  InputOption::VALUE_NONENo acepta entradas para esta opción (por ejemplo: --yell)
                  InputOption::VALUE_REQUIREDEste valor es obligatorio (por ejemplo: --iterations=5), la opción en sí misma aún es opcional
                  InputOption::VALUE_OPTIONALEsta opción puede o no tener un valor (por ejemplo: yell o yell=loud)
                  -

                  Puedes combinar el VALUE_IS_ARRAY con VALUE_REQUIRED o VALUE_OPTIONAL de la siguiente manera:

                  -
                  $this
-    // ...
-    ->addOption(
-        'iterations',
-        null,
-        InputOption::VALUE_REQUIRED | InputOption::VALUE_IS_ARRAY,
-        'How many times should the message be printed?',
-        1
-    );
-
                  -
                  -
                  -
                  -

                  Ayudantes de consola

                  -

                  El componente console también contiene un conjunto de «ayudantes» —pequeñas herramientas capaces de ayudarte con diferentes tareas—:

                  - -
                  -
                  -

                  Probando ordenes

                  -

                  Symfony2 proporciona varias herramientas para ayudarte a probar tus ordenes. La más útil es la clase Symfony\Component\Console\Tester\CommandTester. Esta utiliza clases entrada y salida especiales para facilitar la prueba sin una consola real:

                  -
                  use Symfony\Component\Console\Application;
-use Symfony\Component\Console\Tester\CommandTester;
-use Acme\DemoBundle\Command\GreetCommand;
-
-class ListCommandTest extends \PHPUnit_Framework_TestCase
-{
-    public function testExecute()
-    {
-        $application = new Application();
-        $application->add(new GreetCommand());
-
-        $command = $application->find('demo:greet');
-        $commandTester = new CommandTester($command);
-        $commandTester->execute(array('command' => $command->getName()));
-
-        $this->assertRegExp('/.../', $commandTester->getDisplay());
-
-        // ...
-    }
-}
-
                  -
                  -

                  El método getDisplay() devuelve lo que se ha exhibido durante una llamada normal de la consola.

                  -

                  Puedes probar enviando argumentos y opciones a la orden pasándolos como un arreglo al método execute():

                  -
                  use Symfony\Component\Console\Application;
-use Symfony\Component\Console\Tester\CommandTester;
-use Acme\DemoBundle\Command\GreetCommand;
-
-class ListCommandTest extends \PHPUnit_Framework_TestCase
-{
-    // ...
-
-    public function testNameIsOutput()
-    {
-        $application = new Application();
-        $application->add(new GreetCommand());
-
-        $command = $application->find('demo:greet');
-        $commandTester = new CommandTester($command);
-        $commandTester->execute(
-            array('command' => $command->getName(), 'name' => 'Fabien')
-        );
-
-        $this->assertRegExp('/Fabien/', $commandTester->getDisplay());
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  También puedes probar toda una aplicación de consola utilizando Symfony\Component\Console\Tester\ApplicationTester.

                  -
                  -
                  -
                  -

                  Llamando una orden existente

                  -

                  Si una orden depende de que se ejecute otra antes, en lugar de obligar al usuario a recordar el orden de ejecución, la puedes llamar tú mismo directamente. -Esto también es útil si deseas crear una «metaorden» que ejecute un montón de otras ordenes (por ejemplo, todas las ordenes que se deben ejecutar cuando el código del proyecto ha cambiado en los servidores de producción: vaciar la caché, generar delegados Doctrine2, volcar activos Assetic, ...).

                  -

                  Llamar a una orden desde otra es sencillo:

                  -
                  protected function execute(InputInterface $input, OutputInterface $output)
-{
-    $command = $this->getApplication()->find('demo:greet');
-
-    $arguments = array(
-        'command' => 'demo:greet',
-        'name'    => 'Fabien',
-        '--yell'  => true,
-    );
-
-    $input = new ArrayInput($arguments);
-    $returnCode = $command->run($input, $output);
-
-    // ...
-}
-
                  -
                  -

                  En primer lugar, tu find() busca la orden que deseas ejecutar pasando el nombre de la orden.

                  -

                  Entonces, es necesario crear una nueva clase Symfony\Component\Console\Input\ArrayInput con los argumentos y opciones que desees pasar a la orden.

                  -

                  Finalmente, invocar al método run() ejecuta la orden realmente y devuelve el código regresado por la orden (el valor del método execute()).

                  -
                  -

                  Nota

                  -

                  La mayor parte del tiempo, llamar a una orden desde código que no se ejecuta en la línea de ordenes no es una buena idea por varias razones. En primer lugar, la salida de la orden se ha optimizado para la consola. Pero lo más importante, puedes pensar de una orden como si fuera un controlador; este debe utilizar el modelo para hacer algo y mostrar algún comentario al usuario. Así, en lugar de llamar una orden desde la Web, reconstruye tu código y mueve la lógica a una nueva clase.

                  -
                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/single_command_tool.html b/components/console/single_command_tool.html deleted file mode 100644 index 343e423..0000000 --- a/components/console/single_command_tool.html +++ /dev/null @@ -1,199 +0,0 @@ - - - - - - - Construyendo una aplicación de una sola orden — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Construyendo una aplicación de una sola orden

                  -

                  Cuándo construyes una herramienta para la línea de ordenes, posiblemente no necesites proporcionar varias órdenes. -En tal caso, tener que pasar el nombre de orden cada vez es tedioso. Afortunadamente, es posible evadir esta necesidad extendiendo la application:

                  -
                  namespace Acme\Tool;
-
-use Symfony\Component\Console\Application;
-use Symfony\Component\Console\Input\InputInterface;
-
-class MyApplication extends Application
-{
-    /**
-     * Obtiene el nombre de la orden basándose en la entrada.
-     *
-     * @param InputInterface $input The input interface
-     *
-     * @return string The command name
-     */
-    protected function getCommandName(InputInterface $input)
-    {
-        // Esto debería regresar el nombre de tu orden.
-        return 'my_command';
-    }
-
-    /**
-     * Obtiene las ordenes predefinidas que siempre tendrían que estar disponibles.
-     *
-     * @return array An array of default Command instances
-     */
-    protected function getDefaultCommands()
-    {
-        // mantiene las ordenes predefinidas del núcleo
-        // para que tengan el HelpCommand cuál es utilizado cuándo
-        // se usa la opción --help
-        $defaultCommands = parent::getDefaultCommands();
-
-        $defaultCommands[] = new MyCommand();
-
-        return $defaultCommands;
-    }
-
-    /**
-     * Lo sustituye para que la aplicación no espere el nombre
-     * de la orden como el primer argumento.
-     */
-    public function getDefinition()
-    {
-        $inputDefinition = parent::getDefinition();
-        // limpia el primer argumento de la salida normal, que es el nombre de la orden
-        $inputDefinition->setArguments();
-
-        return $inputDefinition;
-    }
-}
-
                  -
                  -

                  Cuándo llames a tu guión de consola, entonces siempre se utilizará la orden MyCommand, sin tener que pasar su nombre.

                  -

                  También puedes simplificar cómo ejecutas la aplicación:

                  -
                  #!/usr/bin/env php
-<?php
-// command.php
-
-use Acme\Tool\MyApplication;
-
-$application = new MyApplication();
-$application->run();
-
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/console/usage.html b/components/console/usage.html deleted file mode 100644 index f4c4fdc..0000000 --- a/components/console/usage.html +++ /dev/null @@ -1,228 +0,0 @@ - - - - - - - Usando órdenes de consola, atajos y órdenes integradas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Usando órdenes de consola, atajos y órdenes integradas

                  -

                  Además de las opciones que especifiques para tus órdenes, hay algunas opciones integradas así como un par de órdenes para el componente console.

                  -
                  -

                  Nota

                  -

                  Estos ejemplos suponen que añadiste un archivo app/console para ejecutarlo en la interfaz de la línea de ordenes:

                  -
                  #!/usr/bin/env php
-# app/console
-<?php
-
-use Symfony\Component\Console\Application;
-
-$application = new Application();
-// ...
-$application->run();
-
                  -
                  -
                  -
                  -

                  Ordenes integradas

                  -

                  Hay una orden list integrada que produce todas las opciones y ordenes estándar registradas:

                  -
                  $ php app/console list
-
                  -
                  -

                  También puedes obtener el mismo resultado sin especificar ninguna orden:

                  -
                  $ php app/console
-
                  -
                  -

                  La orden help produce toda la información de ayuda para la orden especificada. Por ejemplo, para conseguir ayuda para la orden list:

                  -
                  $ php app/console help list
-
                  -
                  -

                  Al ejecutar help sin especificar una orden enumerará las opciones globales:

                  -
                  $ php app/console help
-
                  -
                  -
                  -
                  -

                  Opciones globales

                  -

                  Puedes conseguir información de ayuda para cualquier orden con la opción --help. Para conseguir ayuda para la orden list:

                  -
                  $ php app/console list --help
-$ php app/console list -h
-
                  -
                  -

                  Puedes suprimir el resultado con:

                  -
                  $ php app/console list --quiet
-$ php app/console list -q
-
                  -
                  -

                  Puedes conseguir mensajes más detallados (si la orden cuenta con tal información) con:

                  -
                  $ php app/console list --verbose
-$ php app/console list -v
-
                  -
                  -

                  Si pusiste los argumentos opcionales para dar a tu aplicación un nombre y versión:

                  -
                  $application = new Application('Acme Console Application', '1.2');
-
                  -
                  -

                  Entonces puedes usar:

                  -
                  $ php app/console list --version
-$ php app/console list -V
-
                  -
                  -

                  para lograr mostrar esta información:

                  -
                  Acme Console Application version 1.2
-
                  -
                  -

                  Si no proporcionaste ambos argumentos entonces solo producirá:

                  -
                  console tool
-
                  -
                  -

                  Puedes forzar el coloreado ANSI del resultado con:

                  -
                  $ php app/console list --ansi
-
                  -
                  -

                  O apagarlo con:

                  -
                  $ php app/console list --no-ansi
-
                  -
                  -

                  Puedes suprimir cualquier pregunta interactiva de la orden que estés ejecutando con:

                  -
                  $ php app/console list --no-interaction
-$ php app/console list -n
-
                  -
                  -
                  -
                  -

                  Sintaxis de atajos

                  -

                  No tienes que escribir los nombres de las ordenes completos. Sólo escribe el nombre unívoco más corto para ejecutar una orden. Por lo tanto si las ordenes no chocan, entonces puedes ejecutar help así:

                  -
                  $ php app/console h
-
                  -
                  -

                  Si tienes ordenes que utilizan : para un espacio de nombres entonces solo tienes que escribir el texto unívoco más corto para cada parte. Si has creado el ejemplo demo:greet como muestra El componente Console, entonces lo puedes ejecutar con:

                  -
                  $ php app/console d:g Fabien
-
                  -
                  -

                  Si escoges una orden demasiado corta y por tanto ambigua (es decir, que más de una orden coincide), entonces ninguna orden será ejecutada y mostrará algunas sugerencias con las posibles ordenes que puedes elegir.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/css_selector.html b/components/css_selector.html deleted file mode 100644 index de5e076..0000000 --- a/components/css_selector.html +++ /dev/null @@ -1,189 +0,0 @@ - - - - - - - El componente CssSelector — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente CssSelector

                  -
                  -
                  El componente CssSelector convierte selectores CSS a expresiones XPath.
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -
                  -

                  ¿Por qué usar selectores CSS?

                  -

                  Cuando estás analizando un archivo HTML o un documento XML, con mucho, el método más poderoso -es XPath.

                  -

                  Las expresiones XPath son increíblemente flexibles, por lo tanto casi siempre hay una expresión XPath que encuentra el elemento que necesitas. Desafortunadamente, también puede llegar a ser muy complicado, y la curva de aprendizaje es muy empinada. Incluso operaciones comunes (por ejemplo, la búsqueda de un elemento con una clase en particular) puede requerir expresiones largas y difíciles de manejar.

                  -

                  Muchos desarrolladores —particularmente los desarrolladores web— se sienten más cómodos usando selectores CSS para encontrar elementos. Además de trabajar en hojas de estilo, los selectores CSS se utilizan en Javascript con la función querySelectorAll y en las bibliotecas populares de Javascript como jQuery, Prototype y MooTools.

                  -

                  Los selectores CSS son menos poderosos que XPath, pero mucho más fáciles de escribir, leer -y entender. Debido a que son menos poderosos, casi todos los selectores CSS se pueden convertir a una expresión XPath equivalente. Entonces, puedes utilizar esta expresión XPath con otras funciones y clases que utilizan XPath para buscar elementos en un documento.

                  -
                  -
                  -

                  El componente CssSelector

                  -

                  El único objetivo del componente es el de convertir selectores CSS a su XPath -equivalente:

                  -
                  use Symfony\Component\CssSelector\CssSelector;
-
-print CssSelector::toXPath('div.item > h4 > a');
-
                  -
                  -

                  Esto produce el siguiente resultado:

                  -
                  descendant-or-self::div[contains(concat(' ',normalize-space(@class), ' '), ' item ')]/h4/a
-
                  -
                  -

                  Puedes utilizar esta expresión con, por ejemplo, DOMXPath o SimpleXMLElement para encontrar elementos en un documento.

                  -
                  -

                  Truco

                  -

                  El método Crawler::filter() utiliza el componente CssSelector para encontrar elementos basándose en una cadena selectora CSS. Ve El componente DomCrawler para más detalles.

                  -
                  -
                  -
                  -

                  Limitaciones del componente cssSelector

                  -

                  No todos los selectores CSS se pueden convertir a XPath equivalentes.

                  -

                  Hay varios selectores CSS que sólo tienen sentido en el contexto de un navegador web.

                  -
                    -
                  • estado de selectores de enlace: :link, :visited, :target
                    • -
                  • selectores basados en la acción del usuario: :hover, :focus, :active
                    • -
                  • Estado de selectores de la interfaz del usuario: :enabled, :disabled, :indeterminate (however, :checked y :unchecked están disponibles)
                    • -
                  -

                  Seudoelementos (:before, :after, :first-line, :first-letter) no son compatibles, debido a que seleccionan porciones de texto en lugar de elementos.

                  -

                  Algunas seudoclases todavía no cuentan con soporte:

                  -
                    -
                  • :lang(language)
                    • -
                  • root
                    • -
                  • *:first-of-type, *:last-of-type, *:nth-of-type, *:nth-last-of-type, *:only-of-type. (Estas funcionan con un elemento nombre (por ejemplo li:first-of-type), pero no con *.
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/debug.html b/components/debug.html deleted file mode 100644 index a0cb048..0000000 --- a/components/debug.html +++ /dev/null @@ -1,193 +0,0 @@ - - - - - - - El componente Debug — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Debug

                  -
                  -
                  El componente Debug proporciona herramientas para facilitar la depuración del código PHP.
                  -

                  -Nuevo en la versión 2.3: El componente Debug es nuevo en Symfony 2.3. Anteriormente, las clases se localizaban en el componente HttpKernel.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  The Debug component provides several tools to help you debug PHP code. -Enabling them all is as easy as it can get:

                  -
                  use Symfony\Component\Debug\Debug;
-
-Debug::enable();
-
                  -
                  -

                  The enable() method registers an -error handler and an exception handler. If the ClassLoader component is available, a special class loader is also -registered.

                  -

                  Read the following sections for more information about the different available -tools.

                  -
                  -

                  Prudencia

                  -

                  You should never enable the debug tools in a production environment as -they might disclose sensitive information to the user.

                  -
                  -
                  -
                  -

                  Enabling the Error Handler

                  -

                  The Symfony\Component\Debug\ErrorHandler class catches PHP errors -and converts them to exceptions (of class ErrorException or -Symfony\Component\Debug\Exception\FatalErrorException for PHP -fatal errors):

                  -
                  use Symfony\Component\Debug\ErrorHandler;
-
-ErrorHandler::register();
-
                  -
                  -
                  -
                  -

                  Enabling the Exception Handler

                  -

                  The Symfony\Component\Debug\ExceptionHandler class catches -uncaught PHP exceptions and converts them to a nice PHP response. It is useful -in debug mode to replace the default PHP/XDebug output with something prettier -and more useful:

                  -
                  use Symfony\Component\Debug\ExceptionHandler;
-
-ExceptionHandler::register();
-
                  -
                  -
                  -

                  Nota

                  -

                  If the HttpFoundation component is -available, the handler uses a Symfony Response object; if not, it falls -back to a regular PHP response.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection.html b/components/dependency_injection.html deleted file mode 100644 index c78527a..0000000 --- a/components/dependency_injection.html +++ /dev/null @@ -1,348 +0,0 @@ - - - - - - - El componente Inyección de dependencias — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Inyección de dependencias

                  -
                  -
                  El componente Inyección de dependencias, te permite estandarizar y centralizar la forma en que se construyen los objetos en tu aplicación.
                  -

                  Para una introducción general a los contenedores de inyección de dependencias y servicios consulta el capítulo Contenedor de servicios del libro.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  -
                    -
                  • Usando el repositorio Git oficial (https://github.com/symfony/DependencyInjection);
                    • -
                  • Instalándolo a través de PEAR ( pear.symfony.com/DependencyInjection);
                    • -
                  • Instalándolo vía Composer (symfony/dependency-injection en Packagist).
                    • -
                  -
                  -
                  -

                  Uso básico

                  -

                  Tal vez tengas una simple clase Mailer como la siguiente, la cual quieres hacer disponible como un servicio:

                  -
                  class Mailer
-{
-    private $transport;
-
-    public function __construct()
-    {
-        $this->transport = 'sendmail';
-    }
-
-    // ...
-}
-
                  -
                  -

                  La puedes registrar en el contenedor como un servicio:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$sc = new ContainerBuilder();
-$sc->register('mailer', 'Mailer');
-
                  -
                  -

                  Una mejora a la clase para hacerla más flexible sería permitir que el contenedor establezca el transporte utilizado. Si cambias la clase para que este sea pasado al constructor:

                  -
                  class Mailer
-{
-    private $transport;
-
-    public function __construct($transport)
-    {
-        $this->transport = $transport;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Entonces, puedes configurar la opción de transporte en el contenedor:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$sc = new ContainerBuilder();
-$sc->register('mailer', 'Mailer')
-    ->addArgument('sendmail'));
-
                  -
                  -

                  Esta clase ahora es mucho más flexible puesto que hemos separado la elección del transporte fuera de la implementación y en el contenedor.

                  -

                  Qué transporte de correo has elegido, puede ser algo sobre lo cual los demás servicios necesitan saber. Puedes evitar tener que cambiarlo en varios lugares volviéndolo un parámetro en el contenedor y luego refiriendo este parámetro como argumento para el constructor del servicio Mailer:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$sc = new ContainerBuilder();
-$sc->setParameter('mailer.transport', 'sendmail');
-$sc->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%'));
-
                  -
                  -

                  Ahora que el servicio mailer está en el contenedor lo puedes inyectar como una dependencia de otras clases. Si tienes una clase NewsletterManager como esta:

                  -
                  use Mailer;
-
-class NewsletterManager
-{
-    private $mailer;
-
-    public function __construct(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Entonces, también la puedes registrar como un servicio y pasarla a servicio mailer:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Reference;
-
-$sc = new ContainerBuilder();
-
-$sc->setParameter('mailer.transport', 'sendmail');
-$sc->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%'));
-
-$sc->register('newsletter_manager', 'NewsletterManager')
-    ->addArgument(new Reference('mailer'));
-
                  -
                  -

                  Si el NewsletterManager no requiere el Mailer y la inyección sólo era opcional, entonces, puedes utilizar el método definidor para inyectarlo en su lugar:

                  -
                  use Mailer;
-
-class NewsletterManager
-{
-    private $mailer;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Ahora puedes optar por no inyectar un Mailer en el NewsletterManager. -Si quieres, aunque entonces el contenedor puede llamar al método definidor:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Reference;
-
-$sc = new ContainerBuilder();
-
-$sc->setParameter('mailer.transport', 'sendmail');
-$sc->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%'));
-
-$sc->register('newsletter_manager', 'NewsletterManager')
-    ->addMethodCall('setMailer', new Reference('mailer'));
-
                  -
                  -

                  A continuación, puedes obtener tu servicio newsletter_manager desde el contenedor de esta manera:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Reference;
-
-$sc = new ContainerBuilder();
-
-//--
-
-$newsletterManager = $sc->get('newsletter_manager');
-
                  -
                  -
                  -
                  -

                  Evitando que tu código sea dependiente en el contenedor

                  -

                  Si bien puedes recuperar los servicios directamente desde el contenedor, lo mejor es minimizar esto. Por ejemplo, en el NewsletterManager inyectamos el servicio Mailer en vez de solicitarlo desde el contenedor. -Podríamos haber inyectado el contenedor y recuperar el servicio Mailer desde ahí, pero entonces, estaría vinculado a este contenedor particular, lo cual dificulta la reutilización de la clase en otro lugar.

                  -

                  Tendrás que conseguir un servicio desde el contenedor en algún momento, pero esto debe ser tan pocas veces como sea posible en el punto de entrada a tu aplicación.

                  -
                  -
                  -

                  Configurando el contenedor con archivos de configuración

                  -

                  Así como la creación de los servicios utilizando PHP —como arriba— también puedes utilizar archivos de configuración. Para ello además necesitas instalar el componente Config:

                  -
                    -
                  • Usando el repositorio Git oficial (https://github.com/symfony/Config);
                    • -
                  • Instalándolo a través de PEAR ( pear.symfony.com/Config);
                    • -
                  • Instalándolo vía Composer (symfony/config en Packagist).
                    • -
                  -

                  Cargando un archivo de configuración XML:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\Config\FileLocator;
-use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
-
-$sc = new ContainerBuilder();
-$loader = new XmlFileLoader($sc, new FileLocator(__DIR__));
-$loader->load('services.xml');
-
                  -
                  -

                  Cargando un archivo de configuración YAML:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\Config\FileLocator;
-use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
-
-$sc = new ContainerBuilder();
-$loader = new YamlFileLoader($sc, new FileLocator(__DIR__));
-$loader->load('services.yml');
-
                  -
                  -

                  Puedes configurar los servicios newsletter_manager y mailer usando archivos de configuración:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    mailer.transport: sendmail
-
-services:
-    my_mailer:
-        class:     Mailer
-        arguments: [@mailer]
-    newsletter_manager:
-        class:     NewsletterManager
-        calls:
-            - [ setMailer, [ @mailer ] ]
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="mailer.transport">sendmail</parameter>
-</parameters>
-
-    <services>
-    <service id="mailer" class="Mailer">
-        <argument>%mailer.transport%</argument>
-    </service>
-
-    <service id="newsletter_manager" class="NewsletterManager">
-        <call method="setMailer">
-             <argument type="service" id="mailer" />
-        </call>
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$sc->setParameter('mailer.transport', 'sendmail');
-$sc->register('mailer', 'Mailer')
-   ->addArgument('%mailer.transport%'));
-
-$sc->register('newsletter_manager', 'NewsletterManager')
-   ->addMethodCall('setMailer', new Reference('mailer'));
-
                    -
                    -
                    • -
                  -
                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/advanced.html b/components/dependency_injection/advanced.html deleted file mode 100644 index 1680542..0000000 --- a/components/dependency_injection/advanced.html +++ /dev/null @@ -1,238 +0,0 @@ - - - - - - - Configuración avanzada del contenedor — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configuración avanzada del contenedor

                  -
                  -

                  Marcando servicios como públicos/privados

                  -

                  Cuando definas servicios, generalmente, querrás poder acceder a estas definiciones dentro del código de tu aplicación. Estos servicios se llaman public. Por ejemplo, el servicio doctrine registrado en el contenedor cuando se utiliza DoctrineBundle es un servicio público al que puedes acceder a través de:

                  -
                  $doctrine = $container->get('doctrine');
-
                  -
                  -

                  Sin embargo, hay casos de uso cuando no quieres que un servicio sea público. Esto es común cuando sólo se define un servicio, ya que se podría utilizar como argumento para otro servicio.

                  -
                  -

                  Nota

                  -

                  Si utilizas un servicio privado como único argumento para otro servicio, resultará en la creación de ejemplares (por ejemplo. new PrivateFooBar()) dentro de este otro servicio, haciéndolo públicamente inutilizable en tiempo de ejecución.

                  -
                  -

                  Simplemente dice: El servicio será privado cuando no deseas acceder a él directamente desde tu código.

                  -

                  Aquí está un ejemplo:

                  -
                  -
                    -
                  • YAML
                    services:
-   foo:
-     class: Example\Foo
-     public: false
-
                    -
                    -
                    • -
                  • XML
                    <service id="foo" class="Example\Foo" public="false" />
-
                    -
                    -
                    • -
                  • PHP
                    $definition = new Definition('Example\Foo');
-$definition->setPublic(false);
-$container->setDefinition('foo', $definition);
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora que el servicio es privado, no puedes llamar a:

                  -
                  $container->get('foo');
-
                  -
                  -

                  Sin embargo, si has marcado un servicio como privado, todavía puedes asignarle un alias (ve más abajo) para acceder a este servicio (a través del alias).

                  -
                  -

                  Nota

                  -

                  De manera predeterminada los servicios son públicos.

                  -
                  -
                  -
                  -

                  Apodando

                  -

                  A veces posiblemente quieras usar atajos para acceder a algunos servicios. Lo puedes hacer por su alias y, además, incluso puedes apodar servicios no públicos.

                  -
                  -
                    -
                  • YAML
                    services:
-   foo:
-     class: Example\Foo
-   bar:
-     alias: foo
-
                    -
                    -
                    • -
                  • XML
                    <service id="foo" class="Example\Foo"/>
-
-<service id="bar" alias="foo" />
-
                    -
                    -
                    • -
                  • PHP
                    $definition = new Definition('Example\Foo');
-$container->setDefinition('foo', $definition);
-
-$containerBuilder->setAlias('bar', 'foo');
-
                    -
                    -
                    • -
                  -
                  -

                  Esto significa que cuando utilizas el contenedor directamente, puedes acceder al servicio foo al pedir el servicio bar así:

                  -
                  $container->get('bar'); // debería devolver el servicio foo
-
                  -
                  -
                  -
                  -

                  Requiriendo archivos

                  -

                  Puede haber casos de uso cuando necesites incluir otro archivo justo antes de cargar el servicio en sí. Para ello, puedes utilizar la directiva file.

                  -
                  -
                    -
                  • YAML
                    services:
-   foo:
-     class: Example\Foo\Bar
-     file: "%kernel.root_dir%/src/ruta/al/archivo/foo.php"
-
                    -
                    -
                    • -
                  • XML
                    <service id="foo" class="Example\Foo\Bar">
-    <file>%kernel.root_dir%/src/ruta/al/archivo/foo.php</file>
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $definition = new Definition('Example\Foo\Bar');
-$definition->setFile('%kernel.root_dir%/src/ruta/al/archivo/foo.php');
-$container->setDefinition('foo', $definition);
-
                    -
                    -
                    • -
                  -
                  -

                  Ten en cuenta que internamente Symfony llama a la función PHP require_once, lo cual significa que el archivo se incluirá una sola vez por petición.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/compilation.html b/components/dependency_injection/compilation.html deleted file mode 100644 index 76c315d..0000000 --- a/components/dependency_injection/compilation.html +++ /dev/null @@ -1,520 +0,0 @@ - - - - - - - Compilando el contenedor — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Compilando el contenedor

                  -

                  El contenedor de servicios se puede compilar por varios motivos. Estas razones incluyen la comprobación de posibles problemas, tal como referencias circulares y volver más eficiente al contenedor usando la resolución de parámetros y remoción de servicios no utilizados.

                  -

                  Se compila ejecutando:

                  -
                  $container->compile();
-
                  -
                  -

                  El método de compilación utiliza «Compiler Passes» para la compilación. El componente Inyección de dependencias viene con varios pases que se registran automáticamente para la compilación. Por ejemplo, la clase Symfony\Component\DependencyInjection\Compiler\CheckDefinitionValidityPass comprueba varios potenciales problemas relacionados con las definiciones que se han establecido en el contenedor. Después de este y varios otros pases que comprueban la validez del contenedor, se utilizan pases adicionales del compilador para optimizar la configuración antes de almacenarla en caché. Por ejemplo, se quitan los servicios privados y abstractos, y se resuelven los alias.

                  -
                  -

                  Gestionando la configuración con extensiones

                  -

                  Así como cargar la configuración directamente en el contenedor como se muestra en El componente Inyección de dependencias, la puedes gestionar registrando extensiones en el contenedor. El primer paso en el proceso de compilación es cargar en el contenedor la configuración de cualquier clase registrada en la extensión. A diferencia de la configuración cargada directamente, esta sólo se procesa cuándo el contenedor es compilado. Si tu aplicación es modular entonces las extensiones dejan que cada módulo registre y gestione su propio servicio de configuración.

                  -

                  Las extensiones deben implementar la Symfony\Component\DependencyInjection\Extension\ExtensionInterface y las puedes registrar en el contenedor con:

                  -
                  $container->registerExtension($extension);
-
                  -
                  -

                  El trabajo principal de la extensión se realiza en el método load. En el método load puedes cargar la configuración desde uno o más archivos de configuración, así como manipular las definiciones del contenedor utilizando los métodos indicados en Working with Container Service Definitions.

                  -

                  Al método load se le pasa un nuevo contenedor para configurarlo, el cual posteriormente se fusiona en el contenedor con el que se haya registrado. Esto te permite tener varias extensiones para gestionar las definiciones del contenedor de forma independiente. -Las extensiones no agregan configuración a los contenedores cuando se añaden, pero se procesan cuando se llama al método compile del contenedor.

                  -

                  Una muy sencilla extensión puede justo cargar al contenedor archivos de configuración:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
-use Symfony\Component\DependencyInjection\Extension\ExtensionInterface;
-use Symfony\Component\Config\FileLocator;
-
-class AcmeDemoExtension implements ExtensionInterface
-{
-    public function load(array $configs, ContainerBuilder $container)
-    {
-        $loader = new XmlFileLoader(
-            $container,
-            new FileLocator(__DIR__.'/../Resources/config')
-        );
-        $loader->load('services.xml');
-    }
-
-    // ...
-}
-
                  -
                  -

                  Esto no mejora mucho comparado a cargar el archivo directamente al construir el contenedor global. Justo deja los archivos para ser divididos entre módulos/paquetes. Para poder afectar la configuración de un módulo desde archivos de configuración externos al módulo/paquete es necesario hacer configurable una aplicación compleja. Esto se puede hacer especificando se carguen secciones de archivos de configuración directamente al contenedor cuando son para una extensión en particular. Estas secciones en la configuración no serán procesadas directamente por el contenedor sino por la extensión pertinente.

                  -

                  La extensión debe especificar un método getAlias para implementar la interfaz:

                  -
                  // ...
-
-class AcmeDemoExtension implements ExtensionInterface
-{
-    // ...
-
-    public function getAlias()
-    {
-        return 'acme_demo';
-    }
-}
-
                  -
                  -

                  Para archivos de configuración YAML especificar el alias para la extensión como clave significará que aquellos valores se pasan al método load de la extensión:

                  -
                  # ...
-acme_demo:
-    foo: fooValue
-    bar: barValue
-
                  -
                  -

                  Si este archivo se carga en la configuración entonces los valores en él sólo son -procesados cuándo el contenedor es compilado en el punto que se cargan las extensiones:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\Config\FileLocator;
-use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
-
-$container = new ContainerBuilder();
-$container->registerExtension(new AcmeDemoExtension);
-
-$loader = new YamlFileLoader($container, new FileLocator(__DIR__));
-$loader->load('config.yml');
-
-// ...
-$container->compile();
-
                  -
                  -
                  -

                  Nota

                  -

                  Al cargar un archivo de configuración que usa un alias de extensión como clave, la extensión ya se debe haber registrado en el constructor del contenedor o se lanzará una excepción.

                  -
                  -

                  Los valores de esas secciones de los archivos de configuración se pasan en el primer -argumento del método load de la extensión:

                  -
                  public function load(array $configs, ContainerBuilder $container)
-{
-    $foo = $configs[0]['foo']; //fooValue
-    $bar = $configs[0]['bar']; //barValue
-}
-
                  -
                  -

                  El argumento $configs es un arreglo conteniendo cada diferente archivo de configuración que se carga en el contenedor. Sólo estás cargando un único archivo de configuración en el ejemplo anterior pero todavía será en un arreglo. El arreglo se verá como este:

                  -
                  array(
-    array(
-        'foo' => 'fooValue',
-        'bar' => 'barValue',
-    ),
-)
-
                  -
                  -

                  Si bien puedes gestionar manualmente la fusión de diferentes archivos, es mucho mejor -utilizar el componente Config para combinar -y validar los valores de configuración. Usando el procesamiento de configuración podrías acceder a los valores de configuración de la siguiente manera:

                  -
                  use Symfony\Component\Config\Definition\Processor;
-// ...
-
-public function load(array $configs, ContainerBuilder $container)
-{
-    $configuration = new Configuration();
-    $processor = new Processor();
-    $config = $processor->processConfiguration($configuration, $configs);
-
-    $foo = $config['foo']; //fooValue
-    $bar = $config['bar']; //barValue
-
-    // ...
-}
-
                  -
                  -

                  Aun faltan dos métodos que debes implementar. Uno para regresar el espacio de nombres XML de modo que las partes pertinentes de un archivo de configuración XML es pasado a la extensión. El otro para especificar la ruta a los archivos XSD base para validar la configuración XML:

                  -
                  public function getXsdValidationBasePath()
-{
-    return __DIR__.'/../Resources/config/';
-}
-
-public function getNamespace()
-{
-    return 'http://www.ejemplo.com/symfony/schema/';
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  La validación XSD es opcional, regresando false desde el método getXsdValidationBasePath lo inhabilitará.

                  -
                  -

                  La versión XML de la configuración entonces se parecería a esta:

                  -
                  <?xml version="1.0" ?>
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:acme_demo="http://www.example.com/symfony/schema/"
-    xsi:schemaLocation="http://www.example.com/symfony/schema/ http://www.example.com/symfony/schema/hello-1.0.xsd">
-
-    <acme_demo:config>
-        <acme_demo:foo>fooValue</acme_hello:foo>
-        <acme_demo:bar>barValue</acme_demo:bar>
-    </acme_demo:config>
-
-</container>
-
                  -
                  -
                  -

                  Nota

                  -

                  En la plataforma Symfony2 completa hay una clase Extensión base que implementa estos métodos así como un acceso directo al método para procesar la configuración. Consulta Cómo exponer la configuración semántica de un paquete para más detalles.

                  -
                  -

                  El valor de configuración procesado ahora se puede añadir como parámetro del contenedor como si estuviera enumerado en una sección parameters del archivo de configuración pero con el beneficio adicional de fusionar y validar múltiples archivos de configuración:

                  -
                  public function load(array $configs, ContainerBuilder $container)
-{
-    $configuration = new Configuration();
-    $processor = new Processor();
-    $config = $processor->processConfiguration($configuration, $configs);
-
-    $container->setParameter('acme_demo.FOO', $config['foo']);
-
-    // ...
-}
-
                  -
                  -

                  Puedes proveer requisitos de configuración más complejos para las clases en la extensión. Por ejemplo, puedes elegir cargar un archivo de configuración de un servicio principal pero también cargar uno secundario sólo si se ajusta un determinado parámetro:

                  -
                  public function load(array $configs, ContainerBuilder $container)
-{
-    $configuration = new Configuration();
-    $processor = new Processor();
-    $config = $processor->processConfiguration($configuration, $configs);
-
-    $loader = new XmlFileLoader(
-        $container,
-        new FileLocator(__DIR__.'/../Resources/config')
-    );
-    $loader->load('services.xml');
-
-    if ($config['advanced']) {
-        $loader->load('advanced.xml');
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  El sólo hecho de registrar una extensión en el contenedor no es suficiente para lograr que se incluya en las extensiones procesadas al compilar el contenedor. -Al cargar la configuración que utiliza el alias de la extensión como clave como en los ejemplos anteriores te aseguras de que estas estensiones sean cargadas. También puedes instruir al constructor del contenedor para que las cargue con su método loadFromExtension():

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$container = new ContainerBuilder();
-$extension = new AcmeDemoExtension();
-$container->registerExtension($extension);
-$container->loadFromExtension($extension->getAlias());
-$container->compile();
-
                  -
                  -
                  -
                  -

                  Nota

                  -

                  Si necesitas manipular la configuración cargada por una extensión, entonces no lo puedes hacer desde otra extensión, ya que esta utiliza un contenedor nuevo. -En su lugar, debes utilizar un pase del compilador que trabaje con el contenedor completo después de haber procesado las extensiones.

                  -
                  -
                  -
                  -

                  Añadiendo al principio la configuración pasada a la extensión

                  -

                  -Nuevo en la versión 2.2: La habilidad para añadir al principio la configuración de un paquete es nueva en Symfony 2.2.

                  -

                  Una Extensión puede prefijar la configuración de cualquier paquete antes del método load() llamada al implementar la Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface:

                  -
                  use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface;
-// ...
-
-class AcmeDemoExtension implements ExtensionInterface, PrependExtensionInterface
-{
-    // ...
-
-    public function prepend()
-    {
-        // ...
-
-        $container->prependExtensionConfig($name, $config);
-
-        // ...
-    }
-}
-
                  -
                  -

                  Para más detalles, ve Cómo simplificar la configuración de múltiples paquetes, la cual es específica a la plataforma Symfony2, pero contiene más detalles sobre esta característica.

                  -
                  -
                  -

                  Creando un pase del compilador

                  -

                  También puedes crear y registrar tu propio pase del compilador en el contenedor. -Para crear un pase del compilador tienes que implementar la interfaz Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface. El compilador te brinda la oportunidad de manipular las definiciones de los servicios que se han compilado. Esto puede ser muy poderoso, pero no es algo necesario en el uso cotidiano.

                  -

                  El pase del compilador debe tener el método process que se pasa al contenedor compilado:

                  -
                  use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-class CustomCompilerPass implements CompilerPassInterface
-{
-    public function process(ContainerBuilder $container)
-    {
-       // ...
-    }
-}
-
                  -
                  -

                  Los parámetros del contenedor y las definiciones se pueden manipular usando los métodos descritos en Working with Container Service Definitions. -Una cosa común por hacer en un pase del compilador es buscar todos los servicios que tienen una determinada etiqueta, a fin de procesarla de alguna manera o dinámicamente conectar cada una con algún otro servicio.

                  -
                  -
                  -

                  Registrando un pase del compilador

                  -

                  Necesitas registrar tu pase personalizado del compilador en el contenedor. El método process será llamado al compilar el contenedor:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$container = new ContainerBuilder();
-$container->addCompilerPass(new CustomCompilerPass);
-
                  -
                  -
                  -

                  Nota

                  -

                  Los pases del compilador son registrados de manera diferente si estás usando la pila completa de la plataforma, ve Cómo trabajan los pases del compilador en los paquetes para más detalles.

                  -
                  -
                  -

                  Controlando el orden de los pases

                  -

                  Los pases predeterminados del compilador se agrupan en pases de optimización y pases de remoción. Los pases de optimización se ejecutan primero e incluyen tareas como la resolución de referencias con las definiciones. Los pases de remoción realizan tareas tales como la eliminación de alias privados y servicios no utilizados. Puedes elegir en qué orden se ejecutará cualquier pase personalizado que añadas. De manera predeterminada, se ejecutará antes de los pases de optimización.

                  -

                  Puedes utilizar las siguientes constantes como segundo argumento al registrar un pase en el contenedor para controlar en qué orden va:

                  -
                    -
                  • PassConfig::TYPE_BEFORE_OPTIMIZATION
                    • -
                  • PassConfig::TYPE_OPTIMIZE
                    • -
                  • PassConfig::TYPE_BEFORE_REMOVING
                    • -
                  • PassConfig::TYPE_REMOVE
                    • -
                  • PassConfig::TYPE_AFTER_REMOVING
                    • -
                  -

                  Por ejemplo, para correr tu pase personalizado después de quitar el pase predeterminado tienes que ejecutar:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Compiler\PassConfig;
-
-$container = new ContainerBuilder();
-$container->addCompilerPass(
-    new CustomCompilerPass,
-    PassConfig::TYPE_AFTER_REMOVING
-);
-
                  -
                  -
                  -
                  -
                  -

                  Vertiendo la configuración para mejorar el rendimiento

                  -

                  Puede ser mucho más fácil entender el uso de los archivos de configuración para gestionar el contenedor de servicios que usar PHP una vez que hay una gran cantidad de servicios. Esta facilidad tiene un costo, aunque cuando se trata de rendimiento, puesto que los archivos de configuración se tienen que analizar y la configuración de PHP construida desde ellos. El proceso de compilación hace más eficiente al contenedor pero toma tiempo su ejecución. Puedes tener lo mejor de ambos mundos aunque usando archivos de configuración y, luego vertiendo y almacenando en caché la configuración resultante. El PhpDumper fácilmente vierte el contenedor compilado:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Dumper\PhpDumper;
-
-$file = __DIR__ .'/cache/container.php';
-
-if (file_exists($file)) {
-    require_once $file;
-    $container = new ProjectServiceContainer();
-} else {
-    $container = new ContainerBuilder();
-    // ...
-    $container->compile();
-
-    $dumper = new PhpDumper($container);
-    file_put_contents($file, $dumper->dump());
-}
-
                  -
                  -

                  ProjectServiceContainer es el nombre predeterminado aplicado a la clase vertida en el contenedor, aun así, lo puedes cambiar con la opción class cuándo lo viertes:

                  -
                  // ...
-$file = __DIR__ .'/cache/container.php';
-
-if (file_exists($file)) {
-    require_once $file;
-    $container = new MyCachedContainer();
-} else {
-    $container = new ContainerBuilder();
-    // ...
-    $container->compile();
-
-    $dumper = new PhpDumper($container);
-    file_put_contents(
-        $file,
-        $dumper->dump(array('class' => 'MyCachedContainer'))
-    );
-}
-
                  -
                  -

                  Ahora obtendrás la velocidad del contenedor PHP configurado con —los fáciles de usar— archivos de configuración. Además verter el contenedor de este modo optimiza aún más la manera en que son creados los servicios por el contenedor.

                  -

                  En el ejemplo anterior tendrás que borrar los archivos del contenedor memorizados en caché cada vez que hagas algún cambio. Añadir una comprobación por una variable que determina si estás en modo de depuración te permite mantener la velocidad del contenedor memorizado en caché en producción, sino consiguiendo una actualización de la configuración, mientras desarrollas tu aplicación:

                  -
                  // ...
-
-// basándose en algo de tu proyecto
-$isDebug = ...;
-
-$file = __DIR__ .'/cache/container.php';
-
-if (!$isDebug && file_exists($file)) {
-    require_once $file;
-    $container = new MyCachedContainer();
-} else {
-    $container = new ContainerBuilder();
-    // ...
-    $container->compile();
-
-    if (!$isDebug) {
-        $dumper = new PhpDumper($container);
-        file_put_contents(
-            $file,
-            $dumper->dump(array('class' => 'MyCachedContainer'))
-        );
-    }
-}
-
                  -
                  -

                  Esto se podría mejorar aún más únicamente recompilando el contenedor en modo de depuración cuándo se han hecho cambios a su configuración en lugar de en cada petición. Esto se puede hacer memorizando en caché los archivos de recurso usados para configurar el contenedor de la manera descrita en «Almacenamiento en caché basado en recursos» en la documentación de configuración del componente.

                  -

                  No necesitas preocuparte de cuál archivo memorizar en caché puesto que el constructor del contenedor mantiene la pista de todos los recursos utilizados para configurarlo, no solo los archivos de configuración sino las clases de extensión y pases del compilador también. Esto significa que cualquier cambio a cualquiera de estos archivos invalidará la caché y provocará la reconstrucción del contenedor. Sólo necesitas preguntar el contenedor por estos recursos y utilizarlos como metadatos para la caché:

                  -
                  // ...
-
-// basándose en algo de tu proyecto
-$isDebug = ...;
-
-$file = __DIR__ .'/cache/container.php';
-$containerConfigCache = new ConfigCache($file, $isDebug);
-
-if (!$containerConfigCache->isFresh()) {
-    $containerBuilder = new ContainerBuilder();
-    // ...
-    $containerBuilder->compile();
-
-    $dumper = new PhpDumper($containerBuilder);
-    $containerConfigCache->write(
-        $dumper->dump(array('class' => 'MyCachedContainer')),
-        $containerBuilder->getResources()
-    );
-}
-
-require_once $file;
-$container = new MyCachedContainer();
-
                  -
                  -

                  Ahora la caché vertida al contenedor se utiliza independientemente de si el modo de depuración está activo o no. -La diferencia es que el ConfigCache está puesto en modo para depurar con su segundo -argumento del constructor. Cuándo la caché no está en modo de depuración siempre se utilizará el contenedor memorizado en caché, si existe. En modo de depuración, un archivo de metadatos adicional se escribe con la marca de tiempo de todos los archivos de recursos. Entonces, estos se comprueban para ver si los archivos han cambiado, si están en caché se consideran viejos.

                  -
                  -

                  Nota

                  -

                  En la pila completa de la plataforma se tiene cuidado por ti de la compilación y almacenamiento en caché del contenedor.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/configurators.html b/components/dependency_injection/configurators.html deleted file mode 100644 index d15c50a..0000000 --- a/components/dependency_injection/configurators.html +++ /dev/null @@ -1,313 +0,0 @@ - - - - - - - Configurando servicios con un configurador de servicio — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configurando servicios con un configurador de servicio

                  -

                  El configurador de servicios es una característica del contenedor de inyección de dependencias que te permite utilizar una función ejecutable para configurar un servicio después de su creación.

                  -

                  Puedes especificar un método en otro servicio, una función PHP o un método estático en una clase. El servicio instance se pasa al ejecutable, permitiendo al configurador hacer cualquier cosa necesaria para configurar el servicio después de su creación.

                  -

                  Puedes utilizar un configurador de servicio, por ejemplo, cuándo tienes un servicio que requiere una configuración compleja basada en opciones de configuración que provienen de diferentes fuentes/servicios. Usando un configurador externo, puedes mantener limpia la implementación del servicio y mantenerla desacoplada de los otros objetos que proporcionan la configuración necesaria.

                  -

                  Otro interesante caso de uso es cuándo tienes múltiples objetos que comparten una configuración común o que se deberían configurar de manera similar en en tiempo de ejecución.

                  -

                  Por ejemplo, supón que tienes una aplicación donde envías diferentes tipos de correo electrónico a los usuarios. Los mensajes de correo electrónico se pasan a través de diferentes formateadores que podrían estar habilitados o no dependiendo de algunas opciones dinámicas de la aplicación. Empiezas definiedo una clase NewsletterManager como esta:

                  -
                  class NewsletterManager implements EmailFormatterAwareInterface
-{
-    protected $mailer;
-    protected $enabledFormatters;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEnabledFormatters(array $enabledFormatters)
-    {
-        $this->enabledFormatters = $enabledFormatters;
-    }
-
-    // ...
-}
-
                  -
                  -

                  y además una clase GreetingCardManager:

                  -
                  class GreetingCardManager implements EmailFormatterAwareInterface
-{
-    protected $mailer;
-    protected $enabledFormatters;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEnabledFormatters(array $enabledFormatters)
-    {
-        $this->enabledFormatters = $enabledFormatters;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Como se mencionó antes, el objetivo es configurar los formateadores en tiempo de ejecución dependiendo de la configuración de la aplicación. Para ello, también tienes una clase EmailFormatterManager que es la responsable de cargar y validar los formateadores habilitados en la aplicación:

                  -
                  class EmailFormatterManager
-{
-    protected $enabledFormatters;
-
-    public function loadFormatters()
-    {
-        // código para configurar cuales formateadores usar
-        $enabledFormatters = array();
-        // ...
-
-        $this->enabledFormatters = $enabledFormatters;
-    }
-
-    public function getEnabledFormatters()
-    {
-        return $this->enabledFormatters;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Si tu objetivo es evitar el tener un par de NewsletterManager y GreetingCardManager con EmailFormatterManager, entonces podrías desear crear una clase configuradora para ajustar estos casos:

                  -
                  class EmailConfigurator
-{
-    private $formatterManager;
-
-    public function __construct(EmailFormatterManager $formatterManager)
-    {
-        $this->formatterManager = $formatterManager;
-    }
-
-    public function configure(EmailFormatterAwareInterface $emailManager)
-    {
-        $emailManager->setEnabledFormatters(
-            $this->formatterManager->getEnabledFormatters()
-        );
-    }
-
-    // ...
-}
-
                  -
                  -

                  El trabajo del EmailConfigurator es inyectar los filtros habilitados en el NewsletterManager y GreetingCardManager porque no están conscientes de donde provienen los filtros habilitados. Por otro lado, el EmailFormatterManager mantiene el conocimiento sobre los formateadores habilitados y cómo cargarlos, únicamente manteniendo el principio de responsabilidad.

                  -
                  -

                  Configurador del servicio Config

                  -

                  El servicio config de las clases anteriores se vería algo así:

                  -
                  -
                    -
                  • YAML
                    services:
-    my_mailer:
-        # ...
-
-    email_formatter_manager:
-        class:     EmailFormatterManager
-        # ...
-
-    email_configurator:
-        class:     EmailConfigurator
-        arguments: ["@email_formatter_manager"]
-        # ...
-
-    newsletter_manager:
-        class:     NewsletterManager
-        calls:
-            - [setMailer, ["@my_mailer"]]
-        configurator: ["@email_configurator", configure]
-
-    greeting_card_manager:
-        class:     GreetingCardManager
-        calls:
-            - [setMailer, ["@my_mailer"]]
-        configurator: ["@email_configurator", configure]
-
                    -
                    -
                    • -
                  • XML
                    <services>
-<service id="my_mailer" ...>
-  <!-- ... -->
-</service>
-<service id="email_formatter_manager" class="EmailFormatterManager">
-  <!-- ... -->
-</service>
-<service id="email_configurator" class="EmailConfigurator">
-    <argument type="service" id="email_formatter_manager" />
-  <!-- ... -->
-</service>
-<service id="newsletter_manager" class="NewsletterManager">
-    <call method="setMailer">
-         <argument type="service" id="my_mailer" />
-    </call>
-    <configurator service="email_configurator" method="configure" />
-</service>
-<service id="greeting_card_manager" class="GreetingCardManager">
-    <call method="setMailer">
-         <argument type="service" id="my_mailer" />
-    </call>
-    <configurator service="email_configurator" method="configure" />
-</service>
-</services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('email_formatter_manager', new Definition(
-    'EmailFormatterManager'
-));
-$container->setDefinition('email_configurator', new Definition(
-    'EmailConfigurator'
-));
-$container->setDefinition('newsletter_manager', new Definition(
-    'NewsletterManager'
-))->addMethodCall('setMailer', array(
-    new Reference('my_mailer'),
-))->setConfigurator(array(
-    new Reference('email_configurator'),
-    'configure',
-)));
-$container->setDefinition('greeting_card_manager', new Definition(
-    'GreetingCardManager'
-))->addMethodCall('setMailer', array(
-    new Reference('my_mailer'),
-))->setConfigurator(array(
-    new Reference('email_configurator'),
-    'configure',
-)));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/definitions.html b/components/dependency_injection/definitions.html deleted file mode 100644 index 2b4e194..0000000 --- a/components/dependency_injection/definitions.html +++ /dev/null @@ -1,234 +0,0 @@ - - - - - - - Working with Container Service Definitions — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Working with Container Service Definitions

                  -
                  -

                  Obteniendo y estableciendo definiciones de servicios

                  -

                  There are some helpful methods for working with the service definitions.

                  -

                  Para saber si hay una definición para un ID de servicio:

                  -
                  $container->hasDefinition($serviceId);
-
                  -
                  -

                  Esto es útil si sólo quieres hacer algo si existe una definición particular.

                  -

                  Puedes recuperar una definición con:

                  -
                  $container->getDefinition($serviceId);
-
                  -
                  -

                  o:

                  -
                  $container->findDefinition($serviceId);
-
                  -
                  -

                  que a diferencia de getDefinition() también resuelve los alias de manera tal que si el argumento $serviceId es un alias esta recuperará la definición subyacente.

                  -

                  Las definiciones de servicios en sí mismas son objetos, por tanto, si recuperas una definición de dichos métodos y les haces cambios se verán reflejados en el contenedor. Sin embargo, si estás creando una nueva definición, entonces lo puedes añadir al contenedor usando:

                  -
                  $container->setDefinition($id, $definition);
-
                  -
                  -
                  -
                  -

                  Trabajando con una definición

                  -
                  -

                  Creando una nueva definición

                  -

                  Si necesitas crear una nueva definición en lugar de manipular una recuperada desde ese contenedor, entonces la clase de la definición es Symfony\Component\DependencyInjection\Definition.

                  -
                  -
                  -

                  Clase

                  -

                  En primer lugar es la clase de una definición, ésta es la clase del objeto devuelto cuando solicitas el servicio desde el contenedor.

                  -

                  Para determinar qué clase dicta la definición:

                  -
                  $definition->getClass();
-
                  -
                  -

                  y para establecer una clase diferente:

                  -
                  $definition->setClass($class); // nombre de clase completamente cualificado como cadena
-
                  -
                  -
                  -
                  -

                  Argumentos del constructor

                  -

                  Para obtener un arreglo de los argumentos del constructor para una definición puedes usar:

                  -
                  $definition->getArguments();
-
                  -
                  -

                  o para obtener un solo argumento por posición:

                  -
                  $definition->getArgument($index);
-// p. ej. $definition->getArguments(0) para el primer argumento
-
                  -
                  -

                  Puedes agregar un nuevo argumento al final del arreglo de argumentos usando:

                  -
                  $definition->addArgument($argument);
-
                  -
                  -

                  El argumento puede ser una cadena, un arreglo, un parámetro de servicio usando %paramater_name% o un identificador de servicio usando:

                  -
                  use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-
-$definition->addArgument(new Reference('service_id'));
-
                  -
                  -

                  De manera similar puedes sustituir un argumento ya establecido por índice usando:

                  -
                  $definition->replaceArgument($index, $argument);
-
                  -
                  -

                  También puedes reemplazar todos los argumentos (o establecer alguno si no hay) con un arreglo de argumentos:

                  -
                  $definition->replaceArguments($arguments);
-
                  -
                  -
                  -
                  -

                  Llamadas a método

                  -

                  Si el servicio en que estás trabajando usa la inyección de definidores entonces puedes manipular cualquier llamada a método en las definiciones también.

                  -

                  Puedes obtener un arreglo de todas las llamadas al método con:

                  -
                  $definition->getMethodCalls();
-
                  -
                  -

                  Añade una llamada al método con:

                  -
                  $definition->addMethodCall($method, $arguments);
-
                  -
                  -

                  Donde $method es el nombre del método y $arguments es un arreglo de los argumentos con los cuales llamar al método. Los argumentos pueden ser cadenas, arreglos, parámetros o identificadores de servicio al igual que los argumentos del constructor.

                  -

                  También puedes sustituir cualquier llamada existente a un método con un arreglo de otras nuevas con:

                  -
                  $definition->setMethodCalls($methodCalls);
-
                  -
                  -
                  -

                  Truco

                  -

                  Hay más ejemplos de maneras específicas de trabajar con definiciones en los bloques de código PHP de los ejemplos de configuración en páginas como Usando el patrón factoría para crear servicios y Gestionando dependencias comunes con servicios padre.

                  -
                  -
                  -

                  Nota

                  -

                  The methods here that change service definitions can only be used before -the container is compiled, once the container is compiled you cannot -manipulate service definitions further. To learn more about compiling -the container see Compilando el contenedor.

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/factories.html b/components/dependency_injection/factories.html deleted file mode 100644 index a7ba74a..0000000 --- a/components/dependency_injection/factories.html +++ /dev/null @@ -1,320 +0,0 @@ - - - - - - - Usando el patrón factoría para crear servicios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Usando el patrón factoría para crear servicios

                  -

                  Los contenedores de servicios de Symfony2 proporcionan una forma eficaz de controlar la creación de objetos, lo cual te permite especificar los argumentos pasados al constructor, así como llamar a los métodos y establecer parámetros. A veces, sin embargo, esto no te proporcionará todo lo necesario para construir tus objetos. -Por esta situación, puedes utilizar una factoría para crear el objeto y decirle al contenedor de servicios que llame a un método en la factoría y no crear directamente una instancia del objeto.

                  -

                  Supongamos que tienes una factoría que configura y devuelve un nuevo objeto NewsletterManager:

                  -
                  class NewsletterFactory
-{
-    public function get()
-    {
-        $newsletterManager = new NewsletterManager();
-
-        // ...
-
-        return $newsletterManager;
-    }
-}
-
                  -
                  -

                  Para que el objeto NewsletterManager esté disponible como servicio, puedes configurar el contenedor de servicios para usar la clase factoría NewsletterFactory:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    newsletter_manager.class: NewsletterManager
-    newsletter_factory.class: NewsletterFactory
-services:
-    newsletter_manager:
-        class:          "%newsletter_manager.class%"
-        factory_class:  "%newsletter_factory.class%"
-        factory_method: get
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">NewsletterManager</parameter>
-    <parameter key="newsletter_factory.class">NewsletterFactory</parameter>
-</parameters>
-
-    <services>
-    <service id="newsletter_manager"
-             class="%newsletter_manager.class%"
-             factory-class="%newsletter_factory.class%"
-             factory-method="get"
-    />
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'NewsletterManager');
-$container->setParameter('newsletter_factory.class', 'NewsletterFactory');
-
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%'
-))->setFactoryClass(
-    '%newsletter_factory.class%'
-)->setFactoryMethod(
-    'get'
-);
-
                    -
                    -
                    • -
                  -
                  -

                  Cuando especificas la clase que utiliza la factoría (a través de factory_class), el método será llamado estáticamente. Si la factoría debe crear una instancia y se llama al método del objeto resultante (como en este ejemplo), configura como servicio la propia factoría:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    newsletter_manager.class: NewsletterManager
-    newsletter_factory.class: NewsletterFactory
-services:
-    newsletter_factory:
-        class:            "%newsletter_factory.class%"
-    newsletter_manager:
-        class:            "%newsletter_manager.class%"
-        factory_service:  newsletter_factory
-        factory_method:   get
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">NewsletterManager</parameter>
-    <parameter key="newsletter_factory.class">NewsletterFactory</parameter>
-</parameters>
-
-    <services>
-    <service id="newsletter_factory" class="%newsletter_factory.class%"/>
-    <service id="newsletter_manager"
-             class="%newsletter_manager.class%"
-             factory-service="newsletter_factory"
-             factory-method="get"
-    />
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'NewsletterManager');
-$container->setParameter('newsletter_factory.class', 'NewsletterFactory');
-
-$container->setDefinition('newsletter_factory', new Definition(
-    '%newsletter_factory.class%'
-))
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%'
-))->setFactoryService(
-    'newsletter_factory'
-)->setFactoryMethod(
-    'get'
-);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  El servicio factoría se especifica por su nombre de id y no una referencia al propio servicio. Por lo tanto, no es necesario utilizar la sintaxis @.

                  -
                  -
                  -

                  Pasando argumentos al método factoría

                  -

                  Si tienes que pasar argumentos al método factoría, puedes utilizar la opción arguments dentro del contenedor de servicios. Por ejemplo, supongamos que el método get en el ejemplo anterior tiene el servicio de templating como argumento:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    newsletter_manager.class: NewsletterManager
-    newsletter_factory.class: NewsletterFactory
-services:
-    newsletter_factory:
-        class:            "%newsletter_factory.class%"
-    newsletter_manager:
-        class:            "%newsletter_manager.class%"
-        factory_service:  newsletter_factory
-        factory_method:   get
-        arguments:
-            - "@templating"
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">NewsletterManager</parameter>
-    <parameter key="newsletter_factory.class">NewsletterFactory</parameter>
-</parameters>
-
-    <services>
-    <service id="newsletter_factory" class="%newsletter_factory.class%"/>
-    <service id="newsletter_manager"
-             class="%newsletter_manager.class%"
-             factory-service="newsletter_factory"
-             factory-method="get"
-    >
-        <argument type="service" id="templating" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'NewsletterManager');
-$container->setParameter('newsletter_factory.class', 'NewsletterFactory');
-
-$container->setDefinition('newsletter_factory', new Definition(
-    '%newsletter_factory.class%'
-))
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%',
-    array(new Reference('templating'))
-))->setFactoryService(
-    'newsletter_factory'
-)->setFactoryMethod(
-    'get'
-);
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/index.html b/components/dependency_injection/index.html deleted file mode 100644 index f0cba66..0000000 --- a/components/dependency_injection/index.html +++ /dev/null @@ -1,202 +0,0 @@ - - - - - - - Inyección de dependencias — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Inyección de dependencias

                  -
                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/introduction.html b/components/dependency_injection/introduction.html deleted file mode 100644 index 273b3d4..0000000 --- a/components/dependency_injection/introduction.html +++ /dev/null @@ -1,378 +0,0 @@ - - - - - - - El componente Inyección de dependencias — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Inyección de dependencias

                  -
                  -
                  El componente Inyección de dependencias, te permite estandarizar y centralizar la forma en que se construyen los objetos en tu aplicación.
                  -

                  Para una introducción general a los contenedores de inyección de dependencias y servicios consulta el capítulo Contenedor de servicios del libro.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Uso básico

                  -

                  Tal vez tengas una simple clase Mailer como la siguiente, la cual quieres hacer disponible como un servicio:

                  -
                  class Mailer
-{
-    private $transport;
-
-    public function __construct()
-    {
-        $this->transport = 'sendmail';
-    }
-
-    // ...
-}
-
                  -
                  -

                  La puedes registrar en el contenedor como un servicio:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$container = new ContainerBuilder();
-$container->register('mailer', 'Mailer');
-
                  -
                  -

                  Una mejora a la clase para hacerla más flexible sería permitir que el contenedor establezca el transporte utilizado. Si cambias la clase para que esta sea pasada al constructor:

                  -
                  class Mailer
-{
-    private $transport;
-
-    public function __construct($transport)
-    {
-        $this->transport = $transport;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Entonces, puedes configurar la opción de transporte en el contenedor:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$container = new ContainerBuilder();
-$container
-    ->register('mailer', 'Mailer')
-    ->addArgument('sendmail');
-
                  -
                  -

                  Esta clase ahora es mucho más flexible puesto que separamos la elección del transporte de la implementación y la colocamos en el contenedor.

                  -

                  Cual transporte de correo has elegido, puede ser algo sobre lo cual los demás servicios necesiten saber. Puedes evitar tener que cambiarlo en varios lugares volviéndolo un parámetro en el contenedor y luego refiriendo este parámetro como argumento en el constructor del servicio Mailer:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$container = new ContainerBuilder();
-$container->setParameter('mailer.transport', 'sendmail');
-$container
-    ->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%');
-
                  -
                  -

                  Ahora que el servicio mailer está en el contenedor lo puedes inyectar como una dependencia de otras clases. Si tienes una clase NewsletterManager como esta:

                  -
                  class NewsletterManager
-{
-    private $mailer;
-
-    public function __construct(\Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Entonces, también la puedes registrar como un servicio y pasarla al servicio mailer:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Reference;
-
-$container = new ContainerBuilder();
-
-$container->setParameter('mailer.transport', 'sendmail');
-$container
-    ->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%');
-
-$container
-    ->register('newsletter_manager', 'NewsletterManager')
-    ->addArgument(new Reference('mailer'));
-
                  -
                  -

                  Si el NewsletterManager no requiere el Mailer y la inyección sólo era opcional, entonces, en su lugar puedes utilizar el método definidor para inyectarlo:

                  -
                  class NewsletterManager
-{
-    private $mailer;
-
-    public function setMailer(\Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Ahora puedes optar por no inyectar un Mailer en el NewsletterManager. -Aún así, si quieres entonces el contenedor puede llamar al método definidor:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Reference;
-
-$container = new ContainerBuilder();
-
-$container->setParameter('mailer.transport', 'sendmail');
-$container
-    ->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%');
-
-$container
-    ->register('newsletter_manager', 'NewsletterManager')
-    ->addMethodCall('setMailer', array(new Reference('mailer')));
-
                  -
                  -

                  A continuación, puedes obtener tu servicio newsletter_manager desde el contenedor de esta manera:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$container = new ContainerBuilder();
-
-// ...
-
-$newsletterManager = $container->get('newsletter_manager');
-
                  -
                  -
                  -
                  -

                  Evitando que tu código sea dependiente en el contenedor

                  -

                  Si bien puedes recuperar los servicios directamente desde el contenedor, lo mejor es minimizar esto. Por ejemplo, en el NewsletterManager inyectamos el servicio Mailer en vez de solicitarlo desde el contenedor. -Podríamos haber inyectado el contenedor y recuperar el servicio Mailer desde ahí, pero entonces, estaría vinculado a ese contenedor particular, lo cual dificulta la reutilización de la clase en cualquier otro lugar.

                  -

                  Tendrás que conseguir un servicio desde el contenedor en algún momento, pero esto debe ser tan pocas veces como sea posible en el punto de entrada a tu aplicación.

                  -
                  -
                  -

                  Configurando el contenedor con archivos de configuración

                  -

                  As well as setting up the services using PHP as above you can also use -configuration files. This allows you to use XML or Yaml to write the definitions -for the services rather than using PHP to define the services as in the above -examples. In anything but the smallest applications it make sense to organize -the service definitions by moving them into one or more configuration files. -To do this you also need to install -the Config Component.

                  -

                  Cargando un archivo de configuración XML:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\Config\FileLocator;
-use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
-
-$container = new ContainerBuilder();
-$loader = new XmlFileLoader($container, new FileLocator(__DIR__));
-$loader->load('services.xml');
-
                  -
                  -

                  Cargando un archivo de configuración YAML:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\Config\FileLocator;
-use Symfony\Component\DependencyInjection\Loader\YamlFileLoader;
-
-$container = new ContainerBuilder();
-$loader = new YamlFileLoader($container, new FileLocator(__DIR__));
-$loader->load('services.yml');
-
                  -
                  -
                  -

                  Nota

                  -

                  Si quieres cargar archivos de configuración YAML entonces también necesitarás instalar el componente YAML.

                  -
                  -

                  If you do want to use PHP to create the services then you can move this -into a separate config file and load it in a similar way:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\Config\FileLocator;
-use Symfony\Component\DependencyInjection\Loader\PhpFileLoader;
-
-$container = new ContainerBuilder();
-$loader = new PhpFileLoader($container, new FileLocator(__DIR__));
-$loader->load('services.php');
-
                  -
                  -

                  You can now set up the newsletter_manager and mailer services using -config files:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    mailer.transport: sendmail
-
-services:
-    mailer:
-        class:     Mailer
-        arguments: ["%mailer.transport%"]
-    newsletter_manager:
-        class:     NewsletterManager
-        calls:
-            - [setMailer, ["@mailer"]]
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="mailer.transport">sendmail</parameter>
-</parameters>
-
-    <services>
-    <service id="mailer" class="Mailer">
-        <argument>%mailer.transport%</argument>
-    </service>
-
-    <service id="newsletter_manager" class="NewsletterManager">
-        <call method="setMailer">
-             <argument type="service" id="mailer" />
-        </call>
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('mailer.transport', 'sendmail');
-$container
-    ->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%');
-
-$container
-    ->register('newsletter_manager', 'NewsletterManager')
-    ->addMethodCall('setMailer', array(new Reference('mailer')));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/parameters.html b/components/dependency_injection/parameters.html deleted file mode 100644 index fe7d56a..0000000 --- a/components/dependency_injection/parameters.html +++ /dev/null @@ -1,392 +0,0 @@ - - - - - - - Introduction to Parameters — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Introduction to Parameters

                  -

                  You can define parameters in the service container which can then be used -directly or as part of service definitions. This can help to separate out -values that you will want to change more regularly.

                  -
                  -

                  Obteniendo y estableciendo contenedores de parámetros

                  -

                  Working with container parameters is straightforward using the container’s -accessor methods for parameters. Puedes comprobar si se ha definido un parámetro en el contenedor con:

                  -
                  $container->hasParameter('mailer.transport');
-
                  -
                  -

                  You can retrieve a parameter set in the container with:

                  -
                  $container->getParameter('mailer.transport');
-
                  -
                  -

                  y establecer un parámetro en el contenedor con:

                  -
                  $container->setParameter('mailer.transport', 'sendmail');
-
                  -
                  -
                  -

                  Nota

                  -

                  You can only set a parameter before the container is compiled. To learn -more about compiling the container see -Compilando el contenedor.

                  -
                  -
                  -
                  -

                  Parameters in Configuration Files

                  -

                  You can also use the parameters section of a config file to set parameters:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    mailer.transport: sendmail
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <parameter key="mailer.transport">sendmail</parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    $container->setParameter('mailer.transport', 'sendmail');
-
                    -
                    -
                    • -
                  -
                  -

                  As well as retrieving the parameter values directly from the container you -can use them in the config files. You can refer to parameters elsewhere by -surrounding them with percent (%) signs, e.g. %mailer.transport%. -One use for this is to inject the values into your services. This allows -you to configure different versions of services between applications or multiple -services based on the same class but configured differently within a single -application. You could inject the choice of mail transport into the Mailer -class directly but by making it a parameter. This makes it easier to change -rather than being tied up and hidden with the service definition:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    mailer.transport: sendmail
-
-services:
-    mailer:
-        class:     Mailer
-        arguments: ['%mailer.transport%']
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <parameter key="mailer.transport">sendmail</parameter>
-</parameters>
-
-    <services>
-    <service id="mailer" class="Mailer">
-        <argument>%mailer.transport%</argument>
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('mailer.transport', 'sendmail');
-$container
-    ->register('mailer', 'Mailer')
-    ->addArgument('%mailer.transport%');
-
                    -
                    -
                    • -
                  -
                  -

                  If you were using this elsewhere as well, then you would only need to change -the parameter value in one place if needed.

                  -

                  You can also use the parameters in the service definition, for example, -making the class of a service a parameter:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    mailer.transport: sendmail
-    mailer.class: Mailer
-
-services:
-    mailer:
-        class:     '%mailer.class%'
-        arguments: ['%mailer.transport%']
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <parameter key="mailer.transport">sendmail</parameter>
-    <parameter key="mailer.class">Mailer</parameter>
-</parameters>
-
-    <services>
-    <service id="mailer" class="%mailer.class%">
-        <argument>%mailer.transport%</argument>
-    </service>
-
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('mailer.transport', 'sendmail');
-$container->setParameter('mailer.class', 'Mailer');
-$container
-    ->register('mailer', '%mailer.class%')
-    ->addArgument('%mailer.transport%');
-
-$container
-    ->register('newsletter_manager', 'NewsletterManager')
-    ->addMethodCall('setMailer', array(new Reference('mailer')));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  El signo de porcentaje en un parámetro o argumento, como parte de la cadena, se debe escapar con otro signo de porcentaje:

                  -
                  -
                    -
                  • YAML
                    arguments: ['http://symfony.com/?foo=%%s&bar=%%d']
-
                    -
                    -
                    • -
                  • XML
                    <argument type="string">http://symfony.com/?foo=%%s&bar=%%d</argument>
                    -
                    -
                    • -
                  • PHP
                    ->addArgument('http://symfony.com/?foo=%%s&bar=%%d');
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Array Parameters

                  -

                  Los parámetros no tienen que ser cadenas planas, sino que también pueden ser arreglos. For the XML -format, you need to use the type="collection" attribute for all parameters that are -arrays.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-parameters:
-    my_mailer.gateways:
-        - mail1
-        - mail2
-        - mail3
-    my_multilang.language_fallback:
-        en:
-            - en
-            - fr
-        fr:
-            - fr
-            - en
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<parameters>
-    <parameter key="my_mailer.gateways" type="collection">
-        <parameter>mail1</parameter>
-        <parameter>mail2</parameter>
-        <parameter>mail3</parameter>
-    </parameter>
-    <parameter key="my_multilang.language_fallback" type="collection">
-        <parameter key="en" type="collection">
-            <parameter>en</parameter>
-            <parameter>fr</parameter>
-        </parameter>
-        <parameter key="fr" type="collection">
-            <parameter>fr</parameter>
-            <parameter>en</parameter>
-        </parameter>
-    </parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container->setParameter('my_mailer.gateways', array('mail1', 'mail2', 'mail3'));
-$container->setParameter('my_multilang.language_fallback', array(
-    'en' => array('en', 'fr'),
-    'fr' => array('fr', 'en'),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Constants as Parameters

                  -

                  El contenedor también cuenta con apoyo para fijar constantes PHP como parámetros. Para aprovechar esta característica, asigna el nombre de tu constante a un parámetro clave, y define el tipo como constant.

                  -
                  -
                    -
                  • XML
                    <?xml version="1.0" encoding="UTF-8"?>
-
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-
-    <parameters>
-        <parameter key="global.constant.value" type="constant">GLOBAL_CONSTANT</parameter>
-        <parameter key="my_class.constant.value" type="constant">My_Class::CONSTANT_NAME</parameter>
-    </parameters>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    $container->setParameter('global.constant.value', GLOBAL_CONSTANT);
-$container->setParameter('my_class.constant.value', My_Class::CONSTANT_NAME);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  This does not works for Yaml configuration. If you’re using Yaml, you can -import an XML file to take advantage of this functionality:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-imports:
-    - { resource: parameters.xml }
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/parentservices.html b/components/dependency_injection/parentservices.html deleted file mode 100644 index cda1235..0000000 --- a/components/dependency_injection/parentservices.html +++ /dev/null @@ -1,607 +0,0 @@ - - - - - - - Gestionando dependencias comunes con servicios padre — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Gestionando dependencias comunes con servicios padre

                  -

                  A medida que agregas más funcionalidad a tu aplicación, puedes comenzar a tener clases relacionadas que comparten algunas de las mismas dependencias. Por ejemplo, puedes tener un gestor de boletines que utiliza inyección para definir sus dependencias:

                  -
                  class NewsletterManager
-{
-    protected $mailer;
-    protected $emailFormatter;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEmailFormatter(EmailFormatter $emailFormatter)
-    {
-        $this->emailFormatter = $emailFormatter;
-    }
-
-    // ...
-}
-
                  -
                  -

                  y también una clase para tus Tarjetas de saludo que comparte las mismas dependencias:

                  -
                  class GreetingCardManager
-{
-    protected $mailer;
-    protected $emailFormatter;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEmailFormatter(EmailFormatter $emailFormatter)
-    {
-        $this->emailFormatter = $emailFormatter;
-    }
-
-    // ...
-}
-
                  -
                  -

                  La configuración del servicio de estas clases se vería algo como esto:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    newsletter_manager.class: NewsletterManager
-    greeting_card_manager.class: GreetingCardManager
-services:
-    my_mailer:
-        # ...
-    my_email_formatter:
-        # ...
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        calls:
-            - [setMailer, ["@my_mailer"]]
-            - [setEmailFormatter, ["@my_email_formatter"]]
-
-    greeting_card_manager:
-        class:     "%greeting_card_manager.class%"
-        calls:
-            - [setMailer, ["@my_mailer"]]
-            - [setEmailFormatter, ["@my_email_formatter"]]
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">NewsletterManager</parameter>
-    <parameter key="greeting_card_manager.class">GreetingCardManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ...>
-      <!-- ... -->
-    </service>
-    <service id="my_email_formatter" ...>
-      <!-- ... -->
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    <service id="greeting_card_manager" class="%greeting_card_manager.class%">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'NewsletterManager');
-$container->setParameter('greeting_card_manager.class', 'GreetingCardManager');
-
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('my_email_formatter', ...);
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%'
-))->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-$container->setDefinition('greeting_card_manager', new Definition(
-    '%greeting_card_manager.class%'
-))->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Hay mucha repetición, tanto en las clases como en la configuración. Esto significa que si cambias, por ejemplo, las clases de correo de la aplicación Mailer de EmailFormatter para inyectarlas a través del constructor, tendrías que actualizar la configuración en dos lugares. Del mismo modo, si necesitas hacer cambios en los métodos definidores tendrías que hacerlo en ambas clases. La forma típica de hacer frente a los métodos comunes de estas clases relacionadas es extraerlas en una superclase:

                  -
                  abstract class MailManager
-{
-    protected $mailer;
-    protected $emailFormatter;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEmailFormatter(EmailFormatter $emailFormatter)
-    {
-        $this->emailFormatter = $emailFormatter;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Entonces NewsletterManager y GreetingCardManager pueden extender esta -superclase:

                  -
                  class NewsletterManager extends MailManager
-{
-    // ...
-}
-
                  -
                  -

                  y:

                  -
                  class GreetingCardManager extends MailManager
-{
-    // ...
-}
-
                  -
                  -

                  De manera similar, el contenedor de servicios de Symfony2 también apoya la extensión de servicios en la configuración por lo que también puedes reducir la repetición especificando un padre para un servicio.

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    newsletter_manager.class: NewsletterManager
-    greeting_card_manager.class: GreetingCardManager
-services:
-    my_mailer:
-        # ...
-    my_email_formatter:
-        # ...
-    mail_manager:
-        abstract:  true
-        calls:
-            - [setMailer, ["@my_mailer"]]
-            - [setEmailFormatter, ["@my_email_formatter"]]
-
-    newsletter_manager:
-        class:     "%newsletter_manager.class%"
-        parent: mail_manager
-
-    greeting_card_manager:
-        class:     "%greeting_card_manager.class%"
-        parent: mail_manager
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">NewsletterManager</parameter>
-    <parameter key="greeting_card_manager.class">GreetingCardManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ...>
-      <!-- ... -->
-    </service>
-    <service id="my_email_formatter" ...>
-      <!-- ... -->
-    </service>
-    <service id="mail_manager" abstract="true">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%" parent="mail_manager"/>
-    <service id="greeting_card_manager" class="%greeting_card_manager.class%" parent="mail_manager"/>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\DefinitionDecorator;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'NewsletterManager');
-$container->setParameter('greeting_card_manager.class', 'GreetingCardManager');
-
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('my_email_formatter', ...);
-$container->setDefinition('mail_manager', new Definition(
-))->setAbstract(
-    true
-)->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-$container->setDefinition('newsletter_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%newsletter_manager.class%'
-);
-$container->setDefinition('greeting_card_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%greeting_card_manager.class%'
-);
-
                    -
                    -
                    • -
                  -
                  -

                  En este contexto, tener un servicio padre implica que los argumentos y las llamadas a métodos del servicio padre se deben utilizar en los servicios descendientes. -En concreto, los métodos definidores especificados para el servicio padre serán llamados cuando se crean instancias del servicio descendiente.

                  -
                  -

                  Nota

                  -

                  Si quitas la clave de configuración del padre, el servicio todavía seguirá siendo una instancia, por supuesto, extendiendo la clase MailManager. La diferencia es que la omisión del padre en la clave de configuración significa que las llamadas definidas en el servicio mail_manager no se ejecutarán al crear instancias de los servicios descendientes.

                  -
                  -

                  The parent service is abstract as it should not be directly retrieved from the -container or passed into another service. It exists merely as a “template” that -other services can use. This is why it can have no class configured which -would cause an exception to be raised for a non-abstract service.

                  -
                  -

                  Nota

                  -

                  In order for parent dependencies to resolve, the ContainerBuilder must -first be compiled. See Compilando el contenedor -for more details.

                  -
                  -
                  -

                  Sustituyendo dependencias del padre

                  -

                  Puede haber ocasiones en las que deses sustituir cual clase se pasa a una dependencia en un único servicio hijo. Afortunadamente, añadiendo la llamada al método de configuración para el servicio hijo, se sustituyen las dependencias establecidas por la clase principal. Así que si necesitas pasar una dependencia diferente sólo para la clase NewsletterManager, la configuración sería la siguiente:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    newsletter_manager.class: NewsletterManager
-    greeting_card_manager.class: GreetingCardManager
-services:
-    my_mailer:
-        # ...
-    my_alternative_mailer:
-        # ...
-    my_email_formatter:
-        # ...
-    mail_manager:
-        abstract:  true
-        calls:
-            - [setMailer, ["@my_mailer"]]
-            - [setEmailFormatter, ["@my_email_formatter"]]
-
-    newsletter_manager:
-        class:     "%newsletter_manager.class%"
-        parent: mail_manager
-        calls:
-            - [setMailer, ["@my_alternative_mailer"]]
-
-    greeting_card_manager:
-        class:     "%greeting_card_manager.class%"
-        parent: mail_manager
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">NewsletterManager</parameter>
-    <parameter key="greeting_card_manager.class">GreetingCardManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ...>
-      <!-- ... -->
-    </service>
-    <service id="my_alternative_mailer" ...>
-      <!-- ... -->
-    </service>
-    <service id="my_email_formatter" ...>
-      <!-- ... -->
-    </service>
-    <service id="mail_manager" abstract="true">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%" parent="mail_manager">
-         <call method="setMailer">
-             <argument type="service" id="my_alternative_mailer" />
-        </call>
-    </service>
-    <service id="greeting_card_manager" class="%greeting_card_manager.class%" parent="mail_manager"/>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\DefinitionDecorator;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'NewsletterManager');
-$container->setParameter('greeting_card_manager.class', 'GreetingCardManager');
-
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('my_alternative_mailer', ...);
-$container->setDefinition('my_email_formatter', ...);
-$container->setDefinition('mail_manager', new Definition(
-))->setAbstract(
-    true
-)->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-$container->setDefinition('newsletter_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%newsletter_manager.class%'
-)->addMethodCall('setMailer', array(
-    new Reference('my_alternative_mailer')
-));
-$container->setDefinition('greeting_card_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%greeting_card_manager.class%'
-);
-
                    -
                    -
                    • -
                  -
                  -

                  El GreetingCardManager recibirá las mismas dependencias que antes, pero la NewsletterManager será pasada a my_alternative_mailer en lugar del servicio my_mailer.

                  -
                  -
                  -

                  Colección de dependencias

                  -

                  Cabe señalar que el método definidor sustituido en el ejemplo anterior en realidad se invoca dos veces — una vez en la definición del padre y otra más en la definición del hijo. En el ejemplo anterior, esto estaba muy bien, ya que la segunda llamada a setMailer sustituye al objeto mailer establecido por la primera llamada.

                  -

                  En algunos casos, sin embargo, esto puede ser un problema. Por ejemplo, si la sustitución a la llamada al método consiste en añadir algo a una colección, entonces se agregarán dos objetos a la colección. A continuación mostramos tal caso, si la clase padre se parece a esto:

                  -
                  abstract class MailManager
-{
-    protected $filters;
-
-    public function setFilter($filter)
-    {
-        $this->filters[] = $filter;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Si tienes la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    # ...
-    newsletter_manager.class: NewsletterManager
-services:
-    my_filter:
-        # ...
-    another_filter:
-        # ...
-    mail_manager:
-        abstract:  true
-        calls:
-            - [setFilter, ["@my_filter"]]
-
-    newsletter_manager:
-        class:     "%newsletter_manager.class%"
-        parent: mail_manager
-        calls:
-            - [setFilter, ["@another_filter"]]
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">NewsletterManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_filter" ...>
-      <!-- ... -->
-    </service>
-    <service id="another_filter" ...>
-      <!-- ... -->
-    </service>
-    <service id="mail_manager" abstract="true">
-        <call method="setFilter">
-             <argument type="service" id="my_filter" />
-        </call>
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%" parent="mail_manager">
-         <call method="setFilter">
-             <argument type="service" id="another_filter" />
-        </call>
-    </service>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\DefinitionDecorator;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'NewsletterManager');
-$container->setParameter('mail_manager.class', 'MailManager');
-
-$container->setDefinition('my_filter', ...);
-$container->setDefinition('another_filter', ...);
-$container->setDefinition('mail_manager', new Definition(
-))->setAbstract(
-    true
-)->addMethodCall('setFilter', array(
-    new Reference('my_filter')
-));
-$container->setDefinition('newsletter_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%newsletter_manager.class%'
-)->addMethodCall('setFilter', array(
-    new Reference('another_filter')
-));
-
                    -
                    -
                    • -
                  -
                  -

                  En este ejemplo, el setFilter del servicio newsletter_manager se llamará dos veces, dando lugar a que el array $filters contenga ambos objetos my_filter y another_filter. Esto es genial si sólo quieres agregar filtros adicionales para subclases. If you want to replace the filters -passed to the subclass, removing the parent setting from the config will -prevent the base class from calling setFilter.

                  -
                  -

                  Truco

                  -

                  In the examples shown there is a similar relationship between the parent -and child services and the underlying parent and child classes. This does -not need to be the case though, you can extract common parts of similar -service definitions into a parent service without also inheriting a parent -class.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/tags.html b/components/dependency_injection/tags.html deleted file mode 100644 index 3006d10..0000000 --- a/components/dependency_injection/tags.html +++ /dev/null @@ -1,377 +0,0 @@ - - - - - - - Trabajando con servicios etiquetados — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Trabajando con servicios etiquetados

                  -

                  Las etiquetas son una cadena genérica (junto con algunas opciones) que puedes aplicar a cualquier servicio. Por sí mismas, las etiquetas en realidad no hacen la funcionalidad de tu servicio en modo alguno. Pero si quieres, puedes pedir al constructor del contenedor que consiga una lista de todos los servicios que estén etiquetados con alguna etiqueta específica. Esto es útil en los pases del compilador donde puedes encontrar estos servicios y usarlos o -modificarlos de alguna manera específica.

                  -

                  Por ejemplo, si estás usando Swift Mailer te puedes imaginar que quieres implementar una «cadena de transporte», que es una colección de clases que implementan \Swift_Transport. Usando la cadena, querrá que Swift Mailer pruebe varias maneras de transportar el mensaje hasta que una lo consiga.

                  -

                  En primer lugar, define la clase TransportChain:

                  -
                  class TransportChain
-{
-    private $transports;
-
-    public function __construct()
-    {
-        $this->transports = array();
-    }
-
-    public function addTransport(\Swift_Transport  $transport)
-    {
-        $this->transports[] = $transport;
-    }
-}
-
                  -
                  -

                  Entonces, define la cadena como un servicio:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    acme_mailer.transport_chain.class: TransportChain
-
-services:
-    acme_mailer.transport_chain:
-        class: "%acme_mailer.transport_chain.class%"
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <parameter key="acme_mailer.transport_chain.class">TransportChain</parameter>
-</parameters>
-
-    <services>
-    <service id="acme_mailer.transport_chain" class="%acme_mailer.transport_chain.class%" />
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-
-$container->setParameter('acme_mailer.transport_chain.class', 'TransportChain');
-
-$container->setDefinition('acme_mailer.transport_chain', new Definition('%acme_mailer.transport_chain.class%'));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Definiendo servicios con una etiqueta personalizada

                  -

                  Ahora, posiblemente quieras que varias de las clases \Swift_Transport sean creadas y añadidas automáticamente a la cadena usando el método addTransport(). -Como ejemplo, puedes añadir los siguientes transportes como servicios:

                  -
                  -
                    -
                  • YAML
                    services:
-    acme_mailer.transport.smtp:
-        class: \Swift_SmtpTransport
-        arguments:
-            - "%mailer_host%"
-        tags:
-            -  { name: acme_mailer.transport }
-    acme_mailer.transport.sendmail:
-        class: \Swift_SendmailTransport
-        tags:
-            -  { name: acme_mailer.transport }
-
                    -
                    -
                    • -
                  • XML
                    <service id="acme_mailer.transport.smtp" class="\Swift_SmtpTransport">
-    <argument>%mailer_host%</argument>
-    <tag name="acme_mailer.transport" />
-</service>
-
-<service id="acme_mailer.transport.sendmail" class="\Swift_SendmailTransport">
-    <tag name="acme_mailer.transport" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-
-$definitionSmtp = new Definition('\Swift_SmtpTransport', array('%mailer_host%'));
-$definitionSmtp->addTag('acme_mailer.transport');
-$container->setDefinition('acme_mailer.transport.smtp', $definitionSmtp);
-
-$definitionSendmail = new Definition('\Swift_SendmailTransport');
-$definitionSendmail->addTag('acme_mailer.transport');
-$container->setDefinition('acme_mailer.transport.sendmail', $definitionSendmail);
-
                    -
                    -
                    • -
                  -
                  -

                  Ten en cuenta que a cada uno se le dio una etiqueta llamada acme_mailer.transport. Esta es la etiqueta personalizada que utilizarás en tu pase del compilador. El pase del compilador es lo que da algún «significado» a la etiqueta.

                  -
                  -
                  -

                  Crear un CompilerPass

                  -

                  Tu pase del compilador ahora puede pedir al contenedor cualquier servicio con la etiqueta personalizada:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
-use Symfony\Component\DependencyInjection\Reference;
-
-class TransportCompilerPass implements CompilerPassInterface
-{
-    public function process(ContainerBuilder $container)
-    {
-        if (!$container->hasDefinition('acme_mailer.transport_chain')) {
-            return;
-        }
-
-        $definition = $container->getDefinition(
-            'acme_mailer.transport_chain'
-        );
-
-        $taggedServices = $container->findTaggedServiceIds(
-            'acme_mailer.transport'
-        );
-        foreach ($taggedServices as $id => $attributes) {
-            $definition->addMethodCall(
-                'addTransport',
-                array(new Reference($id))
-            );
-        }
-    }
-}
-
                  -
                  -

                  El método process() comprueba la existencia del servicio acme_mailer.transport_chain, a continuación, busca todos los servicios etiquetados cómo acme_mailer.transport. Los añade a la definición del servicio acme_mailer.transport_chain llamando a addTransport() por cada servicios "acme_mailer.transport" que haya encontrado. -El primer argumento de cada una de estas llamadas será el servicio de transporte de correo en sí mismo.

                  -
                  -
                  -

                  Registrando el pase en el contenedor

                  -

                  También necesitas registrar el pase en el contenedor, entonces se ejecutará al compilar el contenedor:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-$container = new ContainerBuilder();
-$container->addCompilerPass(new TransportCompilerPass);
-
                  -
                  -
                  -

                  Nota

                  -

                  Los pases del compilador son registrados de manera diferente si estás usando la pila completa de la plataforma. Ve Cómo trabajan los pases del compilador en los paquetes para más detalles.

                  -
                  -
                  -
                  -

                  Añadiendo atributos adicionales en etiquetas

                  -

                  Algunas veces necesitarás información adicional acerca de cada servicio que se ha marcado con tu etiqueta. -Por ejemplo, posiblemente quieras agregar un alias a cada TransportChain.

                  -

                  Para empezar, cambia la clase TransportChain:

                  -
                  class TransportChain
-{
-    private $transports;
-
-    public function __construct()
-    {
-        $this->transports = array();
-    }
-
-    public function addTransport(\Swift_Transport $transport, $alias)
-    {
-        $this->transports[$alias] = $transport;
-    }
-
-    public function getTransport($alias)
-    {
-        if (array_key_exists($alias, $this->transports)) {
-           return $this->transports[$alias];
-        }
-        else {
-           return;
-        }
-    }
-}
-
                  -
                  -

                  Como puedes ver, cuando se llama a addTransport, no sólo necesita un objeto Swift_Transport, sino también una cadena con el alias del transporte. Por lo tanto, ¿cómo podemos permitir que cada servicio etiquetado como transporte también suministre un alias?

                  -

                  Para responder a esto, cambia la declaración del servicio:

                  -
                  -
                    -
                  • YAML
                    services:
-    acme_mailer.transport.smtp:
-        class: \Swift_SmtpTransport
-        arguments:
-            - "%mailer_host%"
-        tags:
-            -  { name: acme_mailer.transport, alias: foo }
-    acme_mailer.transport.sendmail:
-        class: \Swift_SendmailTransport
-        tags:
-            -  { name: acme_mailer.transport, alias: bar }
-
                    -
                    -
                    • -
                  • XML
                    <service id="acme_mailer.transport.smtp" class="\Swift_SmtpTransport">
-    <argument>%mailer_host%</argument>
-    <tag name="acme_mailer.transport" alias="foo" />
-</service>
-
-<service id="acme_mailer.transport.sendmail" class="\Swift_SendmailTransport">
-    <tag name="acme_mailer.transport" alias="bar" />
-</service>
-
                    -
                    -
                    • -
                  -
                  -

                  Ten en cuenta que agregaste una clave genérica alias a la etiqueta. Para utilizarla efectivamente, actualiza el compilador:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
-use Symfony\Component\DependencyInjection\Reference;
-
-class TransportCompilerPass implements CompilerPassInterface
-{
-    public function process(ContainerBuilder $container)
-    {
-        if (!$container->hasDefinition('acme_mailer.transport_chain')) {
-            return;
-        }
-
-        $definition = $container->getDefinition(
-            'acme_mailer.transport_chain'
-        );
-
-        $taggedServices = $container->findTaggedServiceIds(
-            'acme_mailer.transport'
-        );
-        foreach ($taggedServices as $id => $tagAttributes) {
-            foreach ($tagAttributes as $attributes) {
-                $definition->addMethodCall(
-                    'addTransport',
-                    array(new Reference($id), $attributes["alias"])
-                );
-            }
-        }
-    }
-}
-
                  -
                  -

                  La parte más complicada es la variable $attributes. Debido a que puedes utilizar la misma etiqueta muchas veces en el mismo servicio (por ejemplo, en teoría, podrías etiquetar el mismo servicio 5 veces con la etiqueta acme_mailer.transport), $attributes es un arreglo con información de la etiqueta de cada una de las etiquetas en ese servicio.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/types.html b/components/dependency_injection/types.html deleted file mode 100644 index 74ced7f..0000000 --- a/components/dependency_injection/types.html +++ /dev/null @@ -1,316 +0,0 @@ - - - - - - - Tipos de inyección — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipos de inyección

                  -

                  Hacer dependencias de una clase explícita y requerir que se inyecte es una buena manera de hacer una clase más reutilizable, comprobable y desacoplada de las demás.

                  -

                  Hay varias maneras en que se pueden inyectar dependencias. Cada punto de inyección tiene sus ventajas y desventajas a considerar, así como las diferentes formas de trabajar con ellas cuando se utiliza el contenedor de servicios.

                  -
                  -

                  Inyectando en el constructor

                  -

                  La manera más común para inyectar dependencias es a través del constructor de la clase. -Para ello es necesario añadir un argumento a la firma del constructor para aceptar la dependencia:

                  -
                  class NewsletterManager
-{
-    protected $mailer;
-
-    public function __construct(\Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Puedes especificar qué tipo de servicio deseas inyectar en la configuración del contenedor de servicios:

                  -
                  -
                    -
                  • YAML
                    services:
-     my_mailer:
-         # ...
-     newsletter_manager:
-         class:     NewsletterManager
-         arguments: ["@my_mailer"]
-
                    -
                    -
                    • -
                  • XML
                    <services>
-<service id="my_mailer" ... >
-  <!-- ... -->
-</service>
-<service id="newsletter_manager" class="NewsletterManager">
-    <argument type="service" id="my_mailer"/>
-</service>
-</services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('newsletter_manager', new Definition(
-    'NewsletterManager',
-    array(new Reference('my_mailer'))
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Aludir el tipo de objeto a inyectar significa que puedes estar seguro de haber inyectado la dependencia adecuada. Al aludir el tipo, de inmediato obtendrás un error claro si inyectas una dependencia inadecuada. Al aludir el tipo usando una interfaz en lugar de una clase puedes hacer más flexible la elección de la dependencia. Y suponiendo que sólo utilizas los métodos definidos en la interfaz, te puedes beneficiar de la flexibilidad y seguridad al utilizar el objeto.

                  -
                  -

                  Hay varias ventajas al utilizar la inyección en el constructor:

                  -
                    -
                  • Si la dependencia es un requisito y la clase no puede funcionar sin ella, entonces la inyección a través del constructor garantiza que está presente al utilizar la clase debido a que la clase no se puede construir sin ella.
                    • -
                  • El constructor sólo se invoca una vez cuando se crea el objeto, por lo tanto puedes estar seguro de que la dependencia no va a cambiar durante la vida del objeto.
                    • -
                  -

                  Estas ventajas no significan que la inyección en el constructor no sea adecuada para trabajar con dependencias opcionales. Ademas, es más difícil usar en combinación con jerarquías de clase: si una clase utiliza la inyección en el constructor entonces extender y reemplazar el constructor se vuelve problemático.

                  -
                  -
                  -

                  Inyectando en un definidor

                  -

                  Otro posible punto de inyección en una clase es añadiendo un método definidor que acepte la dependencia:

                  -
                  class NewsletterManager
-{
-    protected $mailer;
-
-    public function setMailer(\Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    // ...
-}
-
                  -
                  -
                  -
                    -
                  • YAML
                    services:
-     my_mailer:
-         # ...
-     newsletter_manager:
-         class:     NewsletterManager
-         calls:
-             - [setMailer, ["@my_mailer"]]
-
                    -
                    -
                    • -
                  • XML
                    <services>
-<service id="my_mailer" ... >
-  <!-- ... -->
-</service>
-<service id="newsletter_manager" class="NewsletterManager">
-    <call method="setMailer">
-         <argument type="service" id="my_mailer" />
-    </call>
-</service>
-</services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('newsletter_manager', new Definition(
-    'NewsletterManager'
-))->addMethodCall('setMailer', array(new Reference('my_mailer')));
-
                    -
                    -
                    • -
                  -
                  -

                  Esta vez las ventajas son:

                  -
                    -
                  • La inyección en el definidor funciona bien con dependencias opcionales. Si no necesitas la dependencia, entonces simplemente no llames al definidor.
                    • -
                  • Puedes llamar al definidor varias veces. Esto es particularmente útil si el método añade la dependencia a una colección. Entonces, puedes tener un número variable de dependencias.
                    • -
                  -

                  Las desventajas de la inyección en definidor son:

                  -
                    -
                  • El definidor se puede llamar más que justo al momento de la construcción por lo que no puedes estar seguro de que la dependencia no sea reemplazada durante la vida del objeto (salvo que escribas el definidor de tal manera que compruebe si ya se ha llamado).
                    • -
                  • No puedes estar seguro de que el definidor se llamó y necesitas añadir comprobaciones para verificar que se inyecten las dependencias necesarias.
                    • -
                  -
                  -
                  -

                  Inyectando en propiedades

                  -

                  Otra posibilidad es sólo configurar campos públicos en la clase directamente:

                  -
                  class NewsletterManager
-{
-    public $mailer;
-
-    // ...
-}
-
                  -
                  -
                  -
                    -
                  • YAML
                    services:
-     my_mailer:
-         # ...
-     newsletter_manager:
-         class:     RNewsletterManager
-         properties:
-             mailer: "@my_mailer"
-
                    -
                    -
                    • -
                  • XML
                    <services>
-<service id="my_mailer" ... >
-  <!-- ... -->
-</service>
-<service id="newsletter_manager" class="NewsletterManager">
-    <property name="mailer" type="service" id="my_mailer" />
-</service>
-</services>
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setDefinition('my_mailer', ...);
-$container->setDefinition('newsletter_manager', new Definition(
-    'NewsletterManager'
-))->setProperty('mailer', new Reference('my_mailer')));
-
                    -
                    -
                    • -
                  -
                  -

                  Hay desventajas, principalmente sólo para usar la inyección de la propiedad, es similar a la inyección del definidor, pero con estos importantes problemas adicionales:

                  -
                    -
                  • No puedes controlar cuando la dependencia se ha fijado del todo, esta puede cambiar en cualquier momento durante la vida del objeto.
                    • -
                  • No puedes usar la alusión de tipo, por lo tanto no puedes estar seguro de cual dependencia se inyecte, salvo que escribas código en la clase para probar explícitamente la clase de la instancia antes de usarla.
                    • -
                  -

                  Sin embargo, es útil saber que esto se puede hacer en el contenedor de servicios, sobre todo si trabajas con código que está fuera de tu control, como en una biblioteca de terceros, que utiliza propiedades públicas para sus dependencias.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dependency_injection/workflow.html b/components/dependency_injection/workflow.html deleted file mode 100644 index ab9b241..0000000 --- a/components/dependency_injection/workflow.html +++ /dev/null @@ -1,159 +0,0 @@ - - - - - - - Construyendo el flujo de trabajo del contenedor — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Construyendo el flujo de trabajo del contenedor

                  -

                  En las páginas anteriores de esta sección, ha habido muy poco que decir acerca de donde se deben ubicar los diversos archivos y clases. Esto es porque eso depende de la aplicación, biblioteca o plataforma en la que deseas utilizar el contenedor. En cuanto a la forma de configurar el contenedor y construirlo en la pila completa de la plataforma, Symfony2 te ayudará a ver cómo encaja todo esto junto, si estás utilizando la pila completa de la plataforma o buscando cómo utilizar el contenedor de servicios en otra aplicación.

                  -

                  La pila completa de la plataforma usa el componente HttpKernel para manejar la carga de la configuración del contenedor de servicios desde la aplicación y paquetes, y también se encarga de su compilación y almacenamiento en caché. Incluso si no estás usando el HttpKernel, debería darte una idea de una forma de organizar la configuración en una aplicación modular.

                  -
                  -

                  Trabajando con contenedores en caché

                  -

                  Antes de construrlo, el núcleo comprueba si existe una versión en caché del contenedor. El HttpKernel tiene un ajuste de depuración y si este es falso, se utiliza la versión en caché si existe. Si debug es verdadero, entonces el núcleo comprueba si la configuración es fresca y si lo es, utiliza la versión en caché del contenedor. Si no, entonces el contenedor es construido a partir de la configuración a nivel de la aplicación y la configuración de los paquetes de extensión.

                  -

                  Revisa Volcando la configuración por rendimiento para más detalles.

                  -
                  -
                  -

                  Configurando a nivel de la aplicación

                  -

                  La configuración a nivel de la aplicación se carga desde el directorio app/chonfig. Se cargan varios archivos, mismos que luego se fusionan al procesar las extensiones. Esto permite una diferente configuración para diferentes entornos, por ejemplo, dev, prod.

                  -

                  Estos archivos contienen los parámetros y servicios que se cargan directamente en el contenedor de acuerdo a Configurando el contenedor con archivos de configuración. -También contienen configuración que es procesada por extensiones de acuerdo con Gestionando la configuración con extensiones. -Estos se consideran configuración del paquete, ya que cada paquete contiene la extensión de una clase.

                  -
                  -
                  -

                  Configuración a nivel de paquete con las extensiones

                  -

                  Por convención, cada paquete contiene la extensión de una clase que se encuentra en directorio DependencyInjection del paquete. Éstas son registradas con el ContainerBuilder al arrancar el núcleo. Cuando el ContainerBuilder es compilado, la configuración a nivel de la aplicación correspondiente a la extensión del paquete se pasa a la extensión que también suele cargar sus propios archivos de configuración, típicamente desde el directorio Resources/config. La configuración a nivel de la aplicación normalmente es procesada con un :doc: objeto Configuration </components/config/definition> también almacenado en el directorio DependencyInjection del paquete.

                  -
                  -
                  -

                  Pases del compilador para permitir la interacción entre paquetes

                  -

                  Los pases del compilador se utilizan para permitir la interacción entre los diferentes paquetes, ya que estos no pueden afectar a la configuración de las demás clases de la extensión. Uno de sus principales usos es el procesamiento de servicios etiquetados, lo cual permite a los paquetes registrar servicios captados por otros paquetes, tal como registradores de Monolog, extensiones Twig y Colectores de datos para el generador de perfiles web. Se suele colocar los pases del compilador en el directorio DependencyInjection/Compiler.

                  -
                  -
                  -

                  Compilación y almacenamiento en caché

                  -

                  Después de cargar el proceso de compilación los servicios de configuración, extensiones y pases del compilador, se vuelcan para que la memoria caché se pueda utilizar la próxima vez. La versión vertida se utiliza durante las posteriores peticiones, ya que es más eficiente.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/dom_crawler.html b/components/dom_crawler.html deleted file mode 100644 index 956c247..0000000 --- a/components/dom_crawler.html +++ /dev/null @@ -1,427 +0,0 @@ - - - - - - - El componente DomCrawler — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente DomCrawler

                  -
                  -
                  El componente DomCrawler facilita la navegación por el DOM de documentos HTML y XML.
                  -
                  -

                  Nota

                  -

                  Aunque es posible, el componente DomCrawler no está diseñado para manipular el DOM o volcar HTML/XML.

                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  La clase Symfony\Component\DomCrawler\Crawler proporciona métodos para consultar y manipular documentos HTML y XML.

                  -

                  Una instancia del rastreador (Crawler) representa un conjunto (SplObjectStorage) -de objetos DOMElement, los cuales básicamente son nodos que puedes recorrer fácilmente:

                  -
                  use Symfony\Component\DomCrawler\Crawler;
-
-$html = <<<'HTML'
-<!DOCTYPE html>
-    <html>
-        <body>
-        <p class="message">Hello World!</p>
-        <p>Hello Crawler!</p>
-    </body>
-</html>
-HTML;
-
-$crawler = new Crawler($html);
-
-foreach ($crawler as $domElement) {
-    print $domElement->nodeName;
-}
-
                  -
                  -

                  Las clases especializadas Symfony\Component\DomCrawler\Link y Symfony\Component\DomCrawler\Form son útiles para interactuar con enlaces y formularios html conforme recorres el árbol HTML.

                  -
                  -

                  Filtrando nodos

                  -

                  Usando expresiones XPath esto es realmente fácil:

                  -
                  $crawler = $crawler->filterXPath('descendant-or-self::body/p');
-
                  -
                  -
                  -

                  Truco

                  -

                  DOMXPath::query se utiliza internamente para llevar a cabo una consulta XPath realmente.

                  -
                  -

                  El filtrado incluso es mucho más fácil si tienes instalado el componente CssSelector. -Este te permite utilizar selectores similares a jQuery para recorrerlos:

                  -
                  $crawler = $crawler->filter('body > p');
-
                  -
                  -

                  Puedes utilizar funciones anónimas para filtrar con criterios más complejos:

                  -
                  $crawler = $crawler->filter('body > p')->reduce(function ($node, $i) {
-    // filtra nodos pares
-    return ($i % 2) == 0;
-});
-
                  -
                  -

                  Para eliminar un nodo la función anónima debe regresar false.

                  -
                  -

                  Nota

                  -

                  Todos los métodos devuelven una nueva instancia de la clase Symfony\Component\DomCrawler\Crawler con contenido filtrado.

                  -
                  -
                  -
                  -

                  Recorriendo nodos

                  -

                  Accede al nodo por su posición en la lista:

                  -
                  $crawler->filter('body > p')->eq(0);
-
                  -
                  -

                  Obtiene el primero o último nodo de la selección actual:

                  -
                  $crawler->filter('body > p')->first();
-$crawler->filter('body > p')->last();
-
                  -
                  -

                  Obtiene los nodos del mismo nivel de la selección actual:

                  -
                  $crawler->filter('body > p')->siblings();
-
                  -
                  -

                  Obtiene los nodos del mismo nivel después o antes de la selección actual:

                  -
                  $crawler->filter('body > p')->nextAll();
-$crawler->filter('body > p')->previousAll();
-
                  -
                  -

                  Obtiene todos los nodos hijos o padres:

                  -
                  $crawler->filter('body')->children();
-$crawler->filter('body > p')->parents();
-
                  -
                  -
                  -

                  Nota

                  -

                  Todos los métodos de recorrido devuelven una nueva instancia de la clase Symfony\Component\DomCrawler\Crawler.

                  -
                  -
                  -
                  -

                  Accediendo a valores de nodo

                  -

                  Accede al valor del primer nodo de la selección actual:

                  -
                  $message = $crawler->filterXPath('//body/p')->text();
-
                  -
                  -

                  Accede al valor del atributo del primer nodo de la selección actual:

                  -
                  $class = $crawler->filterXPath('//body/p')->attr('class');
-
                  -
                  -

                  Extrae el atributo y/o los valores del nodo desde la lista de nodos:

                  -
                  $attributes = $crawler
-    ->filterXpath('//body/p')
-    ->extract(array('_text', 'class'))
-;
-
                  -
                  -
                  -

                  Nota

                  -

                  El atributo especial _text representa el valor de un nodo.

                  -
                  -

                  Invoca a una función anónima en cada nodo de la lista:

                  -
                  $nodeValues = $crawler->filter('p')->each(function ($node, $i) {
-    return $node->nodeValue;
-});
-
                  -
                  -

                  La función anónima recibe como argumentos la posición y el nodo. -El resultado es un arreglo de valores devueltos por las llamadas a la función anónima.

                  -
                  -
                  -

                  Añadiendo contenido

                  -

                  El crawler cuenta con soporte para múltiples formas de añadir contenido:

                  -
                  $crawler = new Crawler('<html><body /></html>');
-
-$crawler->addHtmlContent('<html><body /></html>');
-$crawler->addXmlContent('<root><node /></root>');
-
-$crawler->addContent('<html><body /></html>');
-$crawler->addContent('<root><node /></root>', 'text/xml');
-
-$crawler->add('<html><body /></html>');
-$crawler->add('<root><node /></root>');
-
                  -
                  -

                  Puesto que la implementación del Crawler está basada en la extensión DOM, esta también puede interactuar con los objetos nativos DOMDocument, DOMNodeList y DOMNode:

                  -
                  $document = new \DOMDocument();
-$document->loadXml('<root><node /><node /></root>');
-$nodeList = $document->getElementsByTagName('node');
-$node = $document->getElementsByTagName('node')->item(0);
-
-$crawler->addDocument($document);
-$crawler->addNodeList($nodeList);
-$crawler->addNodes(array($node));
-$crawler->addNode($node);
-$crawler->add($document);
-
                  -
                  -
                  -

                  Manipulando y volcando un Crawler

                  -

                  Estos métodos en el Crawler inicialmente pretenden poblar tu Crawler y no intentan usarse más allá de la manipulación del DOM (aunque esto es posible). Sin embargo, debido a que el Crawler es un conjunto de objetos DOMElement, puedes utilizar cualquier método o propiedad disponible en DOMElement, DOMNode o DOMDocument. -Por ejemplo, podrías conseguir el HTML de un Crawler con algo como esto:

                  -
                  $html = '';
-
-foreach ($crawler as $domElement) {
-    $html .= $domElement->ownerDocument->saveHTML($domElement);
-}
-
                  -
                  -
                  -
                  -
                  -

                  Compatibilidad con formularios y enlaces

                  -

                  Dentro del árbol del DOM los enlaces y formularios reciben un tratamiento especial.

                  -
                  -

                  Enlaces

                  -

                  Para un enlace por nombre (o una imagen clicable por su atributo alt), usa el método selectLink en un crawler existente. Este devuelve una instancia de un rastreador con únicamente el/los enlace(s) seleccionado(s). Al invocar a link() recibes un objeto especial Symfony\Component\DomCrawler\Link:

                  -
                  $linksCrawler = $crawler->selectLink('Go elsewhere...');
-$link = $linksCrawler->link();
-
-// O haz todo esto de una vez
-$link = $crawler->selectLink('Go elsewhere...')->link();
-
                  -
                  -

                  El objeto Symfony\Component\DomCrawler\Link tiene varios métodos útiles para obtener más información sobre el propio enlace seleccionado:

                  -
                  // Devuelve la URI adecuada que puedes utilizar para hacer otra petición
-$uri = $link->getUri();
-
                  -
                  -
                  -

                  Nota

                  -

                  El getUri() es especialmente útil, ya que limpia el valor de href y lo transforma a cómo se debe procesar realmente. Por ejemplo, para un enlace con href="#foo", este devolvería la URI completa de la página actual sufijada con #foo. El valor de retorno de``getUri()`` siempre es una URI completa en la cual puedes actuar.

                  -
                  -
                  -
                  -

                  Formularios

                  -

                  También se dá un trato especial a los formularios. Hay disponible un método selectButton() en el rastreador, el cual devuelve otro rastreador que coincide con un botón (input[type=submit], input[type=image], o un button) con el -texto dado. Este método es especialmente útil porque lo puedes utilizar para devolver un objeto Symfony\Component\DomCrawler\Form que representa al formulario en el que vive el botón:

                  -
                  $form = $crawler->selectButton('validate')->form();
-
-// o "llena" los campos del formulario con datos
-$form = $crawler->selectButton('validate')->form(array(
-    'name' => 'Ryan',
-));
-
                  -
                  -

                  El objeto Symfony\Component\DomCrawler\Form tiene un montón de métodos muy útiles para trabajar con formularios:

                  -
                  $uri = $form->getUri();
-
-$method = $form->getMethod();
-
                  -
                  -

                  El método getUri() hace más que solo devolver el atributo action del formulario. Si el método del formulario es GET, entonces imita el comportamiento del navegador y devuelve el atributo action seguido de una cadena de consulta con todos los valores del formulario.

                  -

                  Prácticamente puedes configurar y obtener valores en el formulario:

                  -
                  // Internamente configura valores en el formulario
-$form->setValues(array(
-    'registration[username]' => 'symfonyfan',
-    'registration[terms]'    => 1,
-));
-
-// recupera un arreglo de valores - en el arreglo 'plano' como el de arriba
-$values = $form->getValues();
-
-// devuelve los valores como los devolvería PHP,
-// donde «registro» de su propio arreglo
-$values = $form->getPhpValues();
-
                  -
                  -

                  Para trabajar con campos multidimensionales:

                  -
                  <form>
-    <input name="multi[]" />
-    <input name="multi[]" />
-    <input name="multi[dimensional]" />
-</form>
-
                  -
                  -

                  Pass an array of values:

                  -
                  // Set a single field
-$form->setValues(array('multi' => array('value')));
-
-// Set multiple fields at once
-$form->setValues(array('multi' => array(
-    1             => 'value',
-    'dimensional' => 'an other value'
-)));
-
                  -
                  -

                  ¡Esto es muy bueno, pero se pone mejor! El objeto formulario te permite interactuar con tu formulario como un navegador, seleccionando los valores de radio, casillas de verificación marcadas, y archivos cargados:

                  -
                  $form['registration[username]']->setValue('symfonyfan');
-
-// Activar o desactiva una casilla de verificación
-$form['registration[terms]']->tick();
-$form['registration[terms]']->untick();
-
-// selecciona una opción
-$form['registration[birthday][year]']->select(1984);
-
-// selecciona varias opciones en una "select o checkboxes" múltiple
-$form['registration[interests]']->select(array('symfony', 'cookies'));
-
-/ / Incluso finge una carga de archivo
-$form['registration[photo]']->upload('/ruta/a/lucas.jpg');
-
                  -
                  -

                  ¿Cuál es el punto de hacer todo esto? Si estás probando internamente, puedes tomar la información de tu formulario, como si sólo se hubiera presentado utilizando valores PHP:

                  -
                  $values = $form->getPhpValues();
-$files = $form->getPhpFiles();
-
                  -
                  -

                  Si estás usando un cliente HTTP externo, puedes utilizar el formulario para recuperar toda la información que necesites para crear una petición POST para el formulario:

                  -
                  $uri = $form->getUri();
-$method = $form->getMethod();
-$values = $form->getValues();
-$files = $form->getFiles();
-
-// Ahora usa un cliente *HTTP* y después utiliza esa información
-
                  -
                  -

                  Un gran ejemplo de un sistema integrado que utiliza todo esto es Goutte. -Goutte entiende el objeto rastreador de Symfony y lo puedes utilizar para enviar formularios -directamente:

                  -
                  use Goutte\Client;
-
-// hace una petición real a un sitio externo
-$client = new Client();
-$crawler = $client->request('GET', 'https://github.com/login');
-
-// selecciona el formulario y completa algunos valores
-$form = $crawler->selectButton('Log in')->form();
-$form['login'] = 'symfonyfan';
-$form['password'] = 'anypass';
-
-// envía el formulario
-$crawler = $client->submit($form);
-
                  -
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/event_dispatcher.html b/components/event_dispatcher.html deleted file mode 100644 index d55a8f0..0000000 --- a/components/event_dispatcher.html +++ /dev/null @@ -1,408 +0,0 @@ - - - - - - - El componente despachador de eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente despachador de eventos

                  -
                  -

                  Introducción

                  -

                  El paradigma orientado a objetos ha recorrido un largo camino para garantizar la extensibilidad del código. Al crear clases que tienen responsabilidades bien definidas, el código se vuelve más flexible y un desarrollador lo puede extender con subclases para modificar su comportamiento. Pero si quieres compartir tus cambios con otros desarrolladores que también han hecho sus propias subclases, es discutible que la herencia de código sea la respuesta.

                  -

                  Consideremos un ejemplo del mundo real en el que deseas proporcionar un sistema de complementos a tu proyecto. Un complemento debe ser capaz de agregar métodos, o hacer algo antes o después de ejecutar un método, sin interferir con otros complementos. Este no es un problema fácil de resolver con la herencia simple y herencia múltiple (en caso de que fuera posible con PHP) tiene sus propios inconvenientes.

                  -

                  El despachador de eventos de Symfony2 implementa el patrón observador en una manera sencilla y efectiva para hacer todo esto posible y para realmente hacer extensibles tus proyectos.

                  -

                  Tomemos un ejemplo simple desde el componente HttpKernel de Symfony2. Una vez creado un objeto Respuesta, puede ser útil permitir que otros elementos en el sistema lo modifiquen (por ejemplo, añadan algunas cabeceras de caché) antes de utilizarlo realmente. Para hacer esto posible, el núcleo de Symfony2 lanza un evento —kernel.response—. Así es como funciona:

                  -
                    -
                  • Un escucha (objeto PHP) le dice a un objeto despachador central que quiere escuchar el evento kernel.response;
                    • -
                  • En algún momento, el núcleo de Symfony2 dice al objeto despachador que difunda el evento kernel.response, pasando con este un objeto Evento que tiene acceso al objeto Respuesta;
                    • -
                  • El despachador notifica a (es decir, llama a un método en) todos los escuchas del evento kernel.response, permitiendo que cada uno de ellos haga modificaciones al objeto Respuesta.
                    • -
                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  -
                    -
                  • Usando el repositorio Git oficial (https://github.com/symfony/EventDispatcher);
                    • -
                  • Instalándolo a través de PEAR ( pear.symfony.com/EventDispatcher);
                    • -
                  • Instalándolo vía Composer (symfony/event-dispatcher en Packagist).
                    • -
                  -
                  -
                  -

                  Usando

                  -
                  -

                  Eventos

                  -

                  Cuando se envía un evento, es identificado por un nombre único (por ejemplo, kernel.response), al que cualquier cantidad de escuchas podría estar atento. También se crea una instancia de Symfony\Component\EventDispatcher\Event y se pasa a todos los escuchas. Como veremos más adelante, el objeto Evento mismo, a menudo contiene datos sobre cuando se despachó el evento.

                  -
                  -

                  Convenciones de nomenclatura

                  -

                  El nombre único del evento puede ser cualquier cadena, pero opcionalmente sigue una serie de convenciones de nomenclatura simples:

                  -
                    -
                  • Sólo usa letras minúsculas, números, puntos (.) y guiones bajos (_);
                    • -
                  • Prefija los nombres con un espacio de nombres seguido de un punto (por ejemplo, kernel.);
                    • -
                  • Termina los nombres con un verbo que indica qué acción se está tomando (por ejemplo, request).
                    • -
                  -

                  Estos son algunos ejemplos de nombres de evento aceptables:

                  -
                    -
                  • kernel.response
                    • -
                  • form.pre_set_data
                    • -
                  -
                  -
                  -

                  Nombres de evento y objetos evento

                  -

                  Cuando el despachador notifica a los escuchas, este pasa un objeto Evento real a los escuchas. La clase base Evento es muy simple: contiene un método para detener la propagación del evento, pero no mucho más.

                  -

                  Muchas veces, los datos acerca de un evento específico se tienen que pasar junto con el objeto Evento para que los escuchas tengan la información necesaria. En el caso del evento kernel.response, el objeto Evento creado y pasado a cada escucha realmente es de tipo Symfony\Component\HttpKernel\Event\FilterResponseEvent, una subclase del objeto Evento base. Esta clase contiene métodos como getResponse y setResponse, que permiten a los escuchas recibir e incluso sustituir el objeto Respuesta.

                  -

                  La moraleja de la historia es la siguiente: Cuando creas un escucha para un evento, el objeto Evento que se pasa al escucha puede ser una subclase especial que tiene métodos adicionales para recuperar información desde y para responder al evento.

                  -
                  -
                  -
                  -

                  El despachador

                  -

                  El despachador es el objeto central del sistema despachador de eventos. En general, se crea un único despachador, el cual mantiene un registro de escuchas. Cuando se difunde un evento a través del despachador, este notifica a todos los escuchas registrados con ese evento.

                  -
                  use Symfony\Component\EventDispatcher\EventDispatcher;
-
-$dispatcher = new EventDispatcher();
-
                  -
                  -
                  -
                  -

                  Conectando escuchas

                  -

                  Para aprovechar las ventajas de un evento existente, es necesario conectar un escucha con el despachador para que pueda ser notificado cuando se despache el evento. Una llamada al método despachador addListener() asocia cualquier objeto PHP ejecutable a un evento:

                  -
                  $listener = new AcmeListener();
-$dispatcher->addListener('foo.action', array($listener, 'onFooAction'));
-
                  -
                  -

                  El método addListener() toma hasta tres argumentos:

                  -
                    -
                  • El nombre del evento (cadena) que este escucha quiere atender;
                    • -
                  • Un objeto PHP ejecutable que será notificado cuando se produzca un evento al que está atento;
                    • -
                  • Un entero de prioridad opcional (mayor es igual a más importante) que determina cuando un escucha se activa frente a otros escuchas (por omisión es 0). Si dos escuchas tienen la misma prioridad, se ejecutan en el orden en que se agregaron al despachador.
                    • -
                  -
                  -

                  Nota

                  -

                  Un PHP ejecutable es una variable PHP que la función call_user_func() puede utilizar y devuelve true cuando pasa a la función is_callable(). Esta puede ser una instancia de \Closure, un objeto que implementa un método __invoke (que es lo que —de hecho— hacen los cierres), una cadena que representa una función, o una matriz que representa a un método de un objeto o a un método de clase.

                  -

                  Hasta ahora, hemos visto cómo los objetos PHP se pueden registrar como escuchas. También puedes registrar Cierres PHP como escuchas de eventos:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-
-$dispatcher->addListener('foo.action', function (Event $event) {
-    // se debe ejecutar al despachar el evento foo.action
-});
-
                  -
                  -
                  -

                  Una vez que se registra el escucha en el despachador, este espera hasta que el evento sea notificado. En el ejemplo anterior, cuando se despacha el evento foo.action, el despachador llama al método AcmeListener::onFooAction y pasa el objeto Evento como único argumento:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-
-class AcmeListener
-{
-    // ...
-
-    public function onFooAction(Event $event)
-    {
-        // Hace algo
-    }
-}
-
                  -
                  -

                  En muchos casos, una subclase especial Evento específica para el evento dado es pasada al escucha. Esto le da al escucha acceso a información especial sobre el evento. Consulta la documentación o la implementación de cada evento para determinar la instancia exacta de Symfony\Component\EventDispatcher\Event que se ha pasado. Por ejemplo, el evento kernel.event pasa una instancia de Symfony\Component\HttpKernel\Event\FilterResponseEvent:

                  -
                  use Symfony\Component\HttpKernel\Event\FilterResponseEvent
-
-public function onKernelResponse(FilterResponseEvent $event)
-{
-    $response = $event->getResponse();
-    $request = $event->getRequest();
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Creando y despachando un evento

                  -

                  Además de registrar escuchas con eventos existentes, puedes crear y despachar tus propios eventos. Esto es útil cuando creas bibliotecas compartidas y también cuando deseas mantener flexibles y disociados de tu propio sistema diferentes componentes.

                  -
                  -

                  La clase estática Events

                  -

                  Supongamos que deseas crear un nuevo evento —store.order— el cual se despacha cada vez que es creada una orden dentro de tu aplicación. Para mantener las cosas organizadas, empieza por crear una clase StoreEvents dentro de tu aplicación que sirva para definir y documentar tu evento:

                  -
                  namespace Acme\StoreBundle;
-
-final class StoreEvents
-{
-    /**
-     * El evento 'store.order' es lanzado cada vez que se crea una orden
-     * en el sistema.
-     *
-     * El escucha del evento recibe una instancia de
-     * Acme\StoreBundle\Event\FilterOrderEvent.
-     *
-     * @var string
-     */
-    const onStoreOrder = 'store.order';
-}
-
                  -
                  -

                  Ten en cuenta que esta clase en realidad no hace nada. El propósito de la clase StoreEvents sólo es ser un lugar donde se pueda centralizar la información sobre los eventos comunes. Observa también que se pasará una clase especial FilterOrderEvent a cada escucha de este evento.

                  -
                  -
                  -

                  Creando un objeto Evento

                  -

                  Más tarde, cuando despaches este nuevo evento, debes crear una instancia del Evento y pasarla al despachador. Entonces el despachador pasa esta misma instancia a cada uno de los escuchas del evento. Si no necesitas pasar alguna información a tus escuchas, puedes utilizar la clase predeterminada Symfony\Component\EventDispatcher\Event. La mayoría de las veces, sin embargo, necesitarás pasar información sobre el evento a cada escucha. Para lograrlo, vamos a crear una nueva clase que extiende a Symfony\Component\EventDispatcher\Event.

                  -

                  En este ejemplo, cada escucha tendrá acceso a algún objeto Order. Crea una clase Evento que lo hace posible:

                  -
                  namespace Acme\StoreBundle\Event;
-
-use Symfony\Component\EventDispatcher\Event;
-use Acme\StoreBundle\Order;
-
-class FilterOrderEvent extends Event
-{
-    protected $order;
-
-    public function __construct(Order $order)
-    {
-        $this->order = $order;
-    }
-
-    public function getOrder()
-    {
-        return $this->order;
-    }
-}
-
                  -
                  -

                  Ahora, cada escucha tiene acceso al objeto Order a través del método getOrder.

                  -
                  -
                  -

                  Despachando el evento

                  -

                  El método dispatch() notifica a todos los escuchas que el evento ha ocurrido. Este toma dos argumentos: el nombre del evento a despachar, y la instancia del Evento a pasar a cada escucha de ese evento:

                  -
                  use Acme\StoreBundle\StoreEvents;
-use Acme\StoreBundle\Order;
-use Acme\StoreBundle\Event\FilterOrderEvent;
-
-// la orden de alguna manera es creada o recuperada
-$order = new Order();
-// ...
-
-// crea el FilterOrderEvent y lo despacha
-$event = new FilterOrderEvent($order);
-$dispatcher->dispatch(StoreEvents::onStoreOrder, $event);
-
                  -
                  -

                  Ten en cuenta que el objeto especial FilterOrderEvent se crea y pasa al método dispatch. Ahora, cualquier escucha del evento store.order recibirá el FilterOrderEvent y tendrá acceso al objeto Order a través del método getOrder:

                  -
                  // alguna clase escucha que se ha registrado para onStoreOrder
-use Acme\StoreBundle\Event\FilterOrderEvent;
-
-public function onStoreOrder(FilterOrderEvent $event)
-{
-    $order = $event->getOrder();
-    // haz algo para o con la orden
-}
-
                  -
                  -
                  -
                  -
                  -

                  Pasando el objeto despachador de evento

                  -

                  Si echas un vistazo a la clase EventDispatcher, te darás cuenta de que la clase no actúa como una instancia única (no hay un método estático getInstance()). -Esto es intencional, ya que posiblemente desees tener varios despachadores de eventos simultáneos en una sola petición PHP. Pero también significa que necesitas una manera de pasar el despachador a los objetos que necesitan conectar o notificar eventos.

                  -

                  La mejor práctica consiste en inyectar el objeto despachador de eventos en tus objetos, también conocido como inyección de dependencias.

                  -

                  Puedes usar la inyección del constructor:

                  -
                  use Symfony\Component\EventDispatcher\EventDispatcherInterface;
-
-class Foo
-{
-    protected $dispatcher = null;
-
-    public function __construct(EventDispatcherInterface $dispatcher)
-    {
-        $this->dispatcher = $dispatcher;
-    }
-}
-
                  -
                  -

                  O inyección en el definidor:

                  -
                  use Symfony\Component\EventDispatcher\EventDispatcherInterface;
-
-class Foo
-{
-    protected $dispatcher = null;
-
-    public function setEventDispatcher(EventDispatcherInterface $dispatcher)
-    {
-        $this->dispatcher = $dispatcher;
-    }
-}
-
                  -
                  -

                  La elección entre los dos realmente es cuestión de gusto. Muchos tienden a preferir el constructor de inyección porque los objetos son totalmente iniciados en tiempo de construcción. Pero cuando tienes una larga lista de dependencias, la inyección de definidores puede ser el camino a seguir, especialmente para dependencias opcionales.

                  -
                  -
                  -

                  Usando suscriptores de evento

                  -

                  La forma más común para escuchar a un evento es registrar un escucha de evento con el despachador. Este escucha puede estar atento a uno o más eventos y ser notificado cada vez que se envían los eventos.

                  -

                  Otra forma de escuchar eventos es a través de un suscriptor de eventos. Un suscriptor de eventos es una clase PHP que es capaz de decir al despachador exactamente a cuales eventos debe estar suscrito. Este implementa la interfaz Symfony\Component\EventDispatcher\EventSubscriberInterface, que requiere un solo método estático llamado getSubscribedEvents. Considera el siguiente ejemplo de un suscriptor que está inscrito a los eventos kernel.response y store.order:

                  -
                  namespace Acme\StoreBundle\Event;
-
-use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-use Symfony\Component\HttpKernel\Event\FilterResponseEvent;
-
-class StoreSubscriber implements EventSubscriberInterface
-{
-    static public function getSubscribedEvents()
-    {
-        return array(
-            'kernel.response' => array(
-                array('onKernelResponsePre', 10),
-                array('onKernelResponseMid', 5),
-                array('onKernelResponsePost', 0),
-            ),
-            'store.order'     => array('onStoreOrder', 0),
-        );
-    }
-
-    public function onKernelResponsePre(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onKernelResponseMid(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onKernelResponsePost(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onStoreOrder(FilterOrderEvent $event)
-    {
-        // ...
-    }
-}
-
                  -
                  -

                  Esto es muy similar a una clase escucha, salvo que la propia clase puede decir al despachador cuales eventos debe escuchar. Para registrar un suscriptor al despachador, utiliza el método addSubscriber():

                  -
                  use Acme\StoreBundle\Event\StoreSubscriber;
-
-$subscriber = new StoreSubscriber();
-$dispatcher->addSubscriber($subscriber);
-
                  -
                  -

                  El despachador registrará automáticamente al suscriptor para cada evento devuelto por el método getSubscribedEvents. Este método devuelve una matriz indexada por el nombre del evento y cuyos valores son el nombre del método a llamar o una matriz compuesta por el nombre del método a llamar y la prioridad. El ejemplo anterior muestra cómo registrar varios métodos escucha para el mismo evento en un suscriptor, y, además muestra cómo transmitir la prioridad de cada uno de los métodos escucha.

                  -
                  -
                  -

                  Deteniendo el flujo/propagación del evento

                  -

                  En algunos casos, puede tener sentido que un escucha evite que se llame a otros escuchas. En otras palabras, el escucha tiene que poder decirle al despachador detenga la propagación del evento a todos los escuchas en el futuro (es decir, no notificar a más escuchas). Esto se puede lograr desde el interior de un escucha a través del método stopPropagation():

                  -
                  use Acme\StoreBundle\Event\FilterOrderEvent;
-
-public function onStoreOrder(FilterOrderEvent $event)
-{
-    // ...
-
-    $event->stopPropagation();
-}
-
                  -
                  -

                  Ahora, cualquier escucha de store.order que no haya llamado aún, no será invocado.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/event_dispatcher/container_aware_dispatcher.html b/components/event_dispatcher/container_aware_dispatcher.html deleted file mode 100644 index 51d1681..0000000 --- a/components/event_dispatcher/container_aware_dispatcher.html +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - Contenedor consciente del despachador de eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Contenedor consciente del despachador de eventos

                  -

                  -Nuevo en la versión 2.1: Esta característica se movió al componente EventDispatcher en Symfony 2.1.

                  -
                  -

                  Introducción

                  -

                  La clase Symfony\Component\EventDispatcher\ContainerAwareEventDispatcher es una implementación especial del despachador de eventos que es conectada al contenedor del servicio -que forma parte del componente de Inyección de dependencias. -Esto te permite especificar servicios como escuchas de evento volviendo extremadamente potente al despachador de eventos.

                  -

                  Los servicios se cargan de manera diferida, lo cual significa que los servicios adjuntos como escuchas sólo se crearán si se despacha un evento que requiere de esos escuchas.

                  -
                  -
                  -

                  Configurando

                  -

                  La instalación es sencilla inyectando una Symfony\Component\DependencyInjection\ContainerInterface en Symfony\Component\EventDispatcher\ContainerAwareEventDispatcher:

                  -
                  use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\EventDispatcher\ContainerAwareEventDispatcher;
-
-$container = new ContainerBuilder();
-$dispatcher = new ContainerAwareEventDispatcher($container);
-
                  -
                  -
                  -
                  -

                  Añadiendo escuchas

                  -

                  El contenedor consciente del despachador de eventos puede cargar determinados servicios directamente, o servicios que implementan la Symfony\Component\EventDispatcher\EventSubscriberInterface.

                  -

                  Los siguientes ejemplos asumen que el contenedor de servicios se ha cargado con algunos -servicios ya mencionados.

                  -
                  -

                  Nota

                  -

                  Los servicios se tienen que marcar como públicos en el contenedor.

                  -
                  -
                  -

                  Agregando servicios

                  -

                  Para conectar las definiciones de servicios existentes, usa el método addListenerService() dónde $callback es un arreglo de array($serviceId, $methodName):

                  -
                  $dispatcher->addListenerService($eventName, array('foo', 'logListener'));
-
                  -
                  -
                  -
                  -

                  Agregando suscriptores de servicios

                  -

                  Puedes agregar EventSubscribers usando el método addSubscriberService() dónde el primer argumento es el identificador del suscriptor del servicio, y el segundo argumento es el nombre de la clase del servicio (el cual debe implementar la Symfony\Component\EventDispatcher\EventSubscriberInterface) de la siguiente manera:

                  -
                  $dispatcher->addSubscriberService(
-    'kernel.store_subscriber',
-    'StoreSubscriber'
-);
-
                  -
                  -

                  La EventSubscriberInterface será exactamente como era de esperar:

                  -
                  use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-// ...
-
-class StoreSubscriber implements EventSubscriberInterface
-{
-    public static function getSubscribedEvents()
-    {
-        return array(
-            'kernel.response' => array(
-                array('onKernelResponsePre', 10),
-                array('onKernelResponsePost', 0),
-            ),
-            'store.order'     => array('onStoreOrder', 0),
-        );
-    }
-
-    public function onKernelResponsePre(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onKernelResponsePost(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onStoreOrder(FilterOrderEvent $event)
-    {
-        // ...
-    }
-}
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/event_dispatcher/generic_event.html b/components/event_dispatcher/generic_event.html deleted file mode 100644 index 66ddf47..0000000 --- a/components/event_dispatcher/generic_event.html +++ /dev/null @@ -1,215 +0,0 @@ - - - - - - - El objeto evento genérico — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El objeto evento genérico

                  -

                  -Nuevo en la versión 2.1: La clase del evento GenericEvent se añadió en Symfony 2.1.

                  -

                  La clase base Symfony\Component\EventDispatcher\Event proporcionada por el componente Despachador de eventos deliberadamente es escasa para permitir la creación por herencia de la API de objetos Evento específicos usando programación orientada a objetos. Esto permite código elegante y fácil de leer en aplicaciones complejas.

                  -

                  La clase Symfony\Component\EventDispatcher\GenericEvent está disponible por conveniencia para aquellos que quieran utilizar un solo objeto Evento en toda su aplicación. Este es adecuado para la mayoría de los propósitos fuera de la caja, puesto que sigue el patrón observador estándar en el que el objeto evento encapsula el tema de un evento, pero que adicionalmente tiene argumentos opcionales extra.

                  -

                  La clase Symfony\Component\EventDispatcher\GenericEvent tiene una API sencilla, además de la clase base Symfony\Component\EventDispatcher\Event:

                  - -

                  El GenericEvent también implementa la clase ArrayAccess en los argumentos del evento, lo cual lo hace muy conveniente para pasar argumentos adicionales relacionados al tema del evento.

                  -

                  Los siguientes ejemplos muestran casos de uso para darte una idea general de su flexibilidad. -Los ejemplos asumen que los escuchas de eventos se han añadido al despachador.

                  -

                  Basta con pasar un tema ($subject):

                  -
                  use Symfony\Component\EventDispatcher\GenericEvent;
-
-$event = GenericEvent($subject);
-$dispatcher->dispatch('foo', $event);
-
-class FooListener
-{
-    public function handler(GenericEvent $event)
-    {
-        if ($event->getSubject() instanceof Foo) {
-            // ...
-        }
-    }
-}
-
                  -
                  -

                  Pasando y procesando argumentos usando la API de ArrayAccess para acceder a los argumentos del evento:

                  -
                  use Symfony\Component\EventDispatcher\GenericEvent;
-
-$event = new GenericEvent(
-    $subject,
-    array('type' => 'foo', 'counter' => 0)
-);
-$dispatcher->dispatch('foo', $event);
-
-echo $event['counter'];
-
-class FooListener
-{
-    public function handler(GenericEvent $event)
-    {
-        if (isset($event['type']) && $event['type'] === 'foo') {
-            // ... hace algo
-        }
-
-        $event['counter']++;
-    }
-}
-
                  -
                  -

                  Filtrando datos:

                  -
                  use Symfony\Component\EventDispatcher\GenericEvent;
-
-$event = new GenericEvent($subject, array('data' => 'foo'));
-$dispatcher->dispatch('foo', $event);
-
-echo $event['data'];
-
-class FooListener
-{
-    public function filter(GenericEvent $event)
-    {
-        strtolower($event['data']);
-    }
-}
-
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/event_dispatcher/index.html b/components/event_dispatcher/index.html deleted file mode 100644 index 418136b..0000000 --- a/components/event_dispatcher/index.html +++ /dev/null @@ -1,148 +0,0 @@ - - - - - - - Despachador de eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/event_dispatcher/introduction.html b/components/event_dispatcher/introduction.html deleted file mode 100644 index 807a232..0000000 --- a/components/event_dispatcher/introduction.html +++ /dev/null @@ -1,520 +0,0 @@ - - - - - - - El componente despachador de eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente despachador de eventos

                  -
                  -

                  Introducción

                  -

                  El paradigma orientado a objetos ha recorrido un largo camino para garantizar la extensibilidad del código. Al crear clases que tienen responsabilidades bien definidas, el código se vuelve más flexible y un desarrollador lo puede extender con subclases para modificar su comportamiento. Pero si quieres compartir tus cambios con otros desarrolladores que también han hecho sus propias subclases, es discutible que la herencia de código sea la respuesta.

                  -

                  Consideremos un ejemplo del mundo real en el que deseas proporcionar un sistema de complementos a tu proyecto. Un complemento debe ser capaz de agregar métodos, o hacer algo antes o después de ejecutar un método, sin interferir con otros complementos. Este no es un problema fácil de resolver con la herencia simple y herencia múltiple (en caso de que fuera posible con PHP) tiene sus propios inconvenientes.

                  -

                  El despachador de eventos de Symfony2 implementa el patrón observador en una manera sencilla y efectiva para hacer todo esto posible y para realmente hacer extensibles tus proyectos.

                  -

                  Estudia un sencillo ejemplo desde el El componente HttpKernel. Una vez creado un objeto Respuesta, puede ser útil permitir que otros elementos en el sistema lo modifiquen (por ejemplo, añadan algunas cabeceras de caché) antes de utilizarlo realmente. Para hacer esto posible, el núcleo de Symfony2 lanza un evento —kernel.response—. Así es como funciona:

                  -
                    -
                  • Un escucha (objeto PHP) le dice a un objeto despachador central que quiere escuchar el evento kernel.response;
                    • -
                  • En algún momento, el núcleo de Symfony2 dice al objeto despachador que difunda el evento kernel.response, pasando con este un objeto Evento que tiene acceso al objeto Respuesta;
                    • -
                  • El despachador notifica a (es decir, llama a un método en) todos los escuchas del evento kernel.response, permitiendo que cada uno de ellos haga modificaciones al objeto Respuesta.
                    • -
                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -
                  -

                  Eventos

                  -

                  Cuando se envía un evento, es identificado por un nombre único (por ejemplo, kernel.response), al que cualquier cantidad de escuchas podría estar atento. También se crea una instancia de Symfony\Component\EventDispatcher\Event y se pasa a todos los escuchas. Como veremos más adelante, el objeto Evento mismo, a menudo contiene datos sobre cuando se despachó el evento.

                  -
                  -

                  Convenciones de nomenclatura

                  -

                  El nombre único del evento puede ser cualquier cadena, pero opcionalmente sigue una serie de convenciones de nomenclatura simples:

                  -
                    -
                  • Sólo usa letras minúsculas, números, puntos (.) y guiones bajos (_);
                    • -
                  • Prefija los nombres con un espacio de nombres seguido de un punto (por ejemplo, kernel.);
                    • -
                  • Termina los nombres con un verbo que indica qué acción se está tomando (por ejemplo, request).
                    • -
                  -

                  Estos son algunos ejemplos de nombres de evento aceptables:

                  -
                    -
                  • kernel.response
                    • -
                  • form.pre_set_data
                    • -
                  -
                  -
                  -

                  Nombres de evento y objetos evento

                  -

                  Cuando el despachador notifica a los escuchas, este pasa un objeto Evento real a los escuchas. La clase base Evento es muy simple: contiene un método para detener la propagación del evento, pero no mucho más.

                  -

                  Muchas veces, los datos acerca de un evento específico se tienen que pasar junto con el objeto Evento para que los escuchas tengan la información necesaria. En el caso del evento kernel.response, el objeto Evento creado y pasado a cada escucha realmente es de tipo Symfony\Component\HttpKernel\Event\FilterResponseEvent, una subclase del objeto Evento base. Esta clase contiene métodos como getResponse y setResponse, que permiten a los escuchas recibir e incluso sustituir el objeto Respuesta.

                  -

                  La moraleja de la historia es la siguiente: Cuando creas un escucha para un evento, el objeto Evento que se pasa al escucha puede ser una subclase especial que tiene métodos adicionales para recuperar información desde y para responder al evento.

                  -
                  -
                  -
                  -

                  El despachador

                  -

                  El despachador es el objeto central del sistema despachador de eventos. En general, se crea un único despachador, el cual mantiene un registro de escuchas. Cuando se difunde un evento a través del despachador, este notifica a todos los escuchas registrados a ese evento:

                  -
                  use Symfony\Component\EventDispatcher\EventDispatcher;
-
-$dispatcher = new EventDispatcher();
-
                  -
                  -
                  -
                  -

                  Conectando escuchas

                  -

                  Para aprovechar las ventajas de un evento existente, es necesario conectar un escucha con el despachador para que pueda ser notificado cuando se despache el evento. Una llamada al método despachador addListener() asocia cualquier objeto PHP ejecutable a un evento:

                  -
                  $listener = new AcmeListener();
-$dispatcher->addListener('foo.action', array($listener, 'onFooAction'));
-
                  -
                  -

                  El método addListener() toma hasta tres argumentos:

                  -
                    -
                  • El nombre del evento (cadena) que este escucha quiere atender;
                    • -
                  • Un objeto PHP ejecutable que será notificado cuando se produzca un evento al que está atento;
                    • -
                  • Un entero de prioridad opcional (mayor es igual a más importante) que determina cuando un escucha se activa frente a otros escuchas (por omisión es 0). Si dos escuchas tienen la misma prioridad, se ejecutan en el orden en que se agregaron al despachador.
                    • -
                  -
                  -

                  Nota

                  -

                  Un PHP ejecutable es una variable PHP que la función call_user_func() puede utilizar y devuelve true cuando pasa a la función is_callable(). Esta puede ser una instancia de \Closure, un objeto que implementa un método __invoke (que es lo que —de hecho— hacen los cierres), una cadena que representa una función, o un arreglo que representa a un método de un objeto o a un método de clase.

                  -

                  Hasta ahora, hemos visto cómo los objetos PHP se pueden registrar como escuchas. También puedes registrar Cierres PHP como escuchas de eventos:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-
-$dispatcher->addListener('foo.action', function (Event $event) {
-    // se debe ejecutar al despachar el evento foo.action
-});
-
                  -
                  -
                  -

                  Una vez que se registra el escucha en el despachador, este espera hasta que el evento sea notificado. En el ejemplo anterior, cuando se despacha el evento foo.action, el despachador llama al método AcmeListener::onFooAction y le pasa el objeto Evento como único argumento:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-
-class AcmeListener
-{
-    // ...
-
-    public function onFooAction(Event $event)
-    {
-        // ... hace algo
-    }
-}
-
                  -
                  -

                  En muchos casos, una subclase especial Evento específica para el evento dado es pasada al escucha. Esto le da al escucha acceso a información especial sobre el evento. Consulta la documentación o la implementación de cada evento para determinar la instancia exacta de Symfony\Component\EventDispatcher\Event que se ha pasado. Por ejemplo, el evento kernel.event pasa una instancia de Symfony\Component\HttpKernel\Event\FilterResponseEvent:

                  -
                  use Symfony\Component\HttpKernel\Event\FilterResponseEvent;
-
-public function onKernelResponse(FilterResponseEvent $event)
-{
-    $response = $event->getResponse();
-    $request = $event->getRequest();
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Creando y despachando un evento

                  -

                  Además de registrar escuchas con eventos existentes, puedes crear y despachar tus propios eventos. Esto es útil cuando creas bibliotecas compartidas y también cuando deseas mantener flexibles y disociados de tu propio sistema diferentes componentes.

                  -
                  -

                  La clase estática Events

                  -

                  Supongamos que deseas crear un nuevo evento —store.order— el cual se despacha cada vez que es creada una orden dentro de tu aplicación. Para mantener las cosas organizadas, empieza por crear una clase StoreEvents dentro de tu aplicación que sirva para definir y documentar tu evento:

                  -
                  namespace Acme\StoreBundle;
-
-final class StoreEvents
-{
-    /**
-     * El evento «store.order» es lanzado cada vez que se crea una orden
-     * en el sistema.
-     *
-     * El escucha del evento recibe una
-     * instancia de Acme\StoreBundle\Event\FilterOrderEvent.
-     *
-     * @var string
-     */
-    const STORE_ORDER = 'store.order';
-}
-
                  -
                  -

                  Ten en cuenta que esta clase en realidad no hace nada. El propósito de la clase StoreEvents sólo es ser un lugar donde se pueda centralizar la información sobre los eventos comunes. Observa también que se pasará una clase especial FilterOrderEvent a cada escucha de este evento.

                  -
                  -
                  -

                  Creando un objeto Evento

                  -

                  Más tarde, cuando despaches este nuevo evento, debes crear una instancia del Evento y pasarla al despachador. Entonces el despachador pasa esta misma instancia a cada uno de los escuchas del evento. Si no necesitas pasar alguna información a tus escuchas, puedes utilizar la clase predeterminada Symfony\Component\EventDispatcher\Event. La mayoría de las veces, sin embargo, necesitarás pasar información sobre el evento a cada escucha. Para lograrlo, vamos a crear una nueva clase que extiende a Symfony\Component\EventDispatcher\Event.

                  -

                  En este ejemplo, cada escucha tendrá acceso a algún objeto Order. Crea una clase Evento que lo hace posible:

                  -
                  namespace Acme\StoreBundle\Event;
-
-use Symfony\Component\EventDispatcher\Event;
-use Acme\StoreBundle\Order;
-
-class FilterOrderEvent extends Event
-{
-    protected $order;
-
-    public function __construct(Order $order)
-    {
-        $this->order = $order;
-    }
-
-    public function getOrder()
-    {
-        return $this->order;
-    }
-}
-
                  -
                  -

                  Ahora, cada escucha tiene acceso al objeto Order a través del método getOrder.

                  -
                  -
                  -

                  Despachando el evento

                  -

                  El método dispatch() notifica a todos los escuchas que el evento ha ocurrido. Este toma dos argumentos: el nombre del evento a despachar, y la instancia del Evento a pasar a cada escucha de ese evento:

                  -
                  use Acme\StoreBundle\StoreEvents;
-use Acme\StoreBundle\Order;
-use Acme\StoreBundle\Event\FilterOrderEvent;
-
-// la orden de alguna manera es creada o recuperada
-$order = new Order();
-// ...
-
-// crea el FilterOrderEvent y lo despacha
-$event = new FilterOrderEvent($order);
-$dispatcher->dispatch(StoreEvents::STORE_ORDER, $event);
-
                  -
                  -

                  Ten en cuenta que el objeto especial FilterOrderEvent se crea y pasa al método dispatch. Ahora, cualquier escucha del evento store.order recibirá el FilterOrderEvent y tendrá acceso al objeto Order a través del método getOrder:

                  -
                  // alguna clase escucha registrada al evento "STORE_ORDER"
-use Acme\StoreBundle\Event\FilterOrderEvent;
-
-public function onStoreOrder(FilterOrderEvent $event)
-{
-    $order = $event->getOrder();
-    // haz algo para o con la orden
-}
-
                  -
                  -
                  -
                  -
                  -

                  Usando suscriptores de evento

                  -

                  La forma más común para escuchar a un evento es registrar un escucha de evento con el despachador. Este escucha puede estar atento a uno o más eventos y ser notificado cada vez que se envían los eventos.

                  -

                  Otra forma de escuchar eventos es a través de un suscriptor de eventos. Un suscriptor de eventos es una clase PHP que es capaz de decir al despachador exactamente a cuales eventos debe estar suscrito. Este implementa la interfaz Symfony\Component\EventDispatcher\EventSubscriberInterface, que requiere un solo método estático llamado getSubscribedEvents. Considera el siguiente ejemplo de un suscriptor que está inscrito a los eventos kernel.response y store.order:

                  -
                  namespace Acme\StoreBundle\Event;
-
-use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-use Symfony\Component\HttpKernel\Event\FilterResponseEvent;
-
-class StoreSubscriber implements EventSubscriberInterface
-{
-    public static function getSubscribedEvents()
-    {
-        return array(
-            'kernel.response' => array(
-                array('onKernelResponsePre', 10),
-                array('onKernelResponseMid', 5),
-                array('onKernelResponsePost', 0),
-            ),
-            'store.order'     => array('onStoreOrder', 0),
-        );
-    }
-
-    public function onKernelResponsePre(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onKernelResponseMid(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onKernelResponsePost(FilterResponseEvent $event)
-    {
-        // ...
-    }
-
-    public function onStoreOrder(FilterOrderEvent $event)
-    {
-        // ...
-    }
-}
-
                  -
                  -

                  Esto es muy similar a una clase escucha, salvo que la propia clase puede decir al despachador cuales eventos debe escuchar. Para registrar un suscriptor al despachador, utiliza el método addSubscriber():

                  -
                  use Acme\StoreBundle\Event\StoreSubscriber;
-
-$subscriber = new StoreSubscriber();
-$dispatcher->addSubscriber($subscriber);
-
                  -
                  -

                  El despachador registrará automáticamente al suscriptor para cada evento devuelto por el método getSubscribedEvents. Este método devuelve un arreglo indexado por el nombre del evento y cuyos valores son el nombre del método a llamar o un arreglo compuesto por el nombre del método a llamar y la prioridad. El ejemplo anterior muestra cómo registrar varios métodos escucha para el mismo evento en un suscriptor, y, además muestra cómo transmitir la prioridad de cada uno de los métodos escucha. -The higher the priority, the earlier the method is called. In the above -example, when the kernel.response event is triggered, the methods -onKernelResponsePre, onKernelResponseMid, and onKernelResponsePost -are called in that order.

                  -
                  -
                  -

                  Deteniendo el flujo/propagación del evento

                  -

                  En algunos casos, puede tener sentido que un escucha evite que se llame a otros escuchas. En otras palabras, el escucha tiene que poder decirle al despachador detenga la propagación del evento a todos los escuchas en el futuro (es decir, no notificar a más escuchas). Esto se puede lograr desde el interior de un escucha a través del método stopPropagation():

                  -
                  use Acme\StoreBundle\Event\FilterOrderEvent;
-
-public function onStoreOrder(FilterOrderEvent $event)
-{
-    // ...
-
-    $event->stopPropagation();
-}
-
                  -
                  -

                  Ahora, cualquier escucha de store.order que no haya llamado aún, no será invocado.

                  -

                  Es posible detectar si un evento fue detenido utilizando el método isPropagationStopped() que devuelve un valor booleano:

                  -
                  $dispatcher->dispatch('foo.event', $event);
-if ($event->isPropagationStopped()) {
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  El EventDispatcher está consciente de eventos y escuchas

                  -

                  -Nuevo en la versión 2.1: El objeto Event contiene una referencia al despachador que lo invocó desde Symfony 2.1

                  -

                  El EventDispatcher siempre inyecta una referencia a sí mismo en el objeto evento que se le pasa. Esto significa que todos los escuchas tienen acceso directo al objeto EventDispatcher que notifica al escucha a través del método getDispatcher() del objeto Event transmitido.

                  -

                  Esto puede llevar a algunas aplicaciones avanzadas del EventDispatcher incluyendo dejar que los escuchas envíen otros eventos, encadenando eventos o incluso cargando escuchas de manera diferida en el objeto Despachador. Algunos ejemplos:

                  -

                  Cargando escuchas de manera diferida:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-use Acme\StoreBundle\Event\StoreSubscriber;
-
-class Foo
-{
-    private $started = false;
-
-    public function myLazyListener(Event $event)
-    {
-        if (false === $this->started) {
-            $subscriber = new StoreSubscriber();
-            $event->getDispatcher()->addSubscriber($subscriber);
-        }
-
-        $this->started = true;
-
-        // ... más código
-    }
-}
-
                  -
                  -

                  Despachando otro event desde un escucha:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-
-class Foo
-{
-    public function myFooListener(Event $event)
-    {
-        $event->getDispatcher()->dispatch('log', $event);
-
-        // ... más código
-    }
-}
-
                  -
                  -

                  Si bien lo anterior es suficiente para la mayoría de los casos, si tu aplicación utiliza múltiples -instancias del EventDispatcher, posiblemente tengas que inyectar específicamente una -instancia conocida del EventDispatcher en tus escuchas. Esto se podría hacer inyectándolo en el constructor o con un definidor de la siguiente manera:

                  -

                  Inyección en el constructor:

                  -
                  use Symfony\Component\EventDispatcher\EventDispatcherInterface;
-
-class Foo
-{
-    protected $dispatcher = null;
-
-    public function __construct(EventDispatcherInterface $dispatcher)
-    {
-        $this->dispatcher = $dispatcher;
-    }
-}
-
                  -
                  -

                  O inyección en el definidor:

                  -
                  use Symfony\Component\EventDispatcher\EventDispatcherInterface;
-
-class Foo
-{
-    protected $dispatcher = null;
-
-    public function setEventDispatcher(EventDispatcherInterface $dispatcher)
-    {
-        $this->dispatcher = $dispatcher;
-    }
-}
-
                  -
                  -

                  La elección entre los dos realmente es cuestión de gusto. Muchos tienden a preferir el constructor de inyección porque los objetos son totalmente iniciados en tiempo de construcción. Pero cuando tienes una larga lista de dependencias, la inyección de definidores puede ser el camino a seguir, especialmente para dependencias opcionales.

                  -
                  -
                  -

                  Atajos del despachador

                  -

                  -Nuevo en la versión 2.1: El método EventDispatcher::dispatch() devuelve el evento desde Symfony 2.1.

                  -

                  El Método EventDispatcher::dispatch siempre devuelve un objeto Symfony\Component\EventDispatcher\Event. Este permite varios atajos. Por ejemplo, si uno no necesita un objeto evento personalizado, simplemente puedes confiar en un simple objeto Symfony\Component\EventDispatcher\Event. Ni siquiera lo tienes que pasar al despachador ya que de manera predeterminada creará uno a menos que específicamente le pases uno:

                  -
                  $dispatcher->dispatch('foo.event');
-
                  -
                  -

                  Por otra parte, el EventDispatcher siempre devuelve cualquier objeto evento que le hayas enviado, es decir, ya sea el evento que le hayas pasado o la instancia que internamente haya creado el despachador. Esto da pie a bonitos accesos directos:

                  -
                  if (!$dispatcher->dispatch('foo.event')->isPropagationStopped()) {
-    // ...
-}
-
                  -
                  -

                  O:

                  -
                  $barEvent = new BarEvent();
-$bar = $dispatcher->dispatch('bar.event', $barEvent)->getBar();
-
                  -
                  -

                  O:

                  -
                  $response = $dispatcher->dispatch('bar.event', new BarEvent())->getBar();
-
                  -
                  -

                  y así sucesivamente...

                  -
                  -
                  -

                  introspección el nombre del evento

                  -

                  -Nuevo en la versión 2.1: El nombre del evento se añadió al objeto Event desde Symfony 2.1

                  -

                  Puesto que el EventDispatcher ya sabe el nombre del evento al despacharlo, el nombre del evento también se inyecta en los objetos Symfony\Component\EventDispatcher\Event, poniéndolo a disposición de los escuchas de eventos a través del método getName().

                  -

                  El nombre del evento, (como con cualquier otro dato en un objeto evento personalizado) se puede utilizar como parte de la lógica de procesamiento del escucha:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-
-class Foo
-{
-    public function myEventListener(Event $event)
-    {
-        echo $event->getName();
-    }
-}
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/filesystem.html b/components/filesystem.html deleted file mode 100644 index 7248105..0000000 --- a/components/filesystem.html +++ /dev/null @@ -1,335 +0,0 @@ - - - - - - - El componente Filesystem — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Filesystem

                  -
                  -
                  El componente Filesystem proporciona herramientas básicas para el sistema de archivos.
                  -

                  -Nuevo en la versión 2.1: El componente Filesystem es una novedad en Symfony 2.1. Anteriormente, la clase Filesystem se encontraba en el componente HttpKernel.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  La clase Symfony\Component\Filesystem\Filesystem es el único punto final para las operaciones del sistema de archivos:

                  -
                  use Symfony\Component\Filesystem\Filesystem;
-use Symfony\Component\Filesystem\Exception\IOException;
-
-$fs = new Filesystem();
-
-try {
-    $fs->mkdir('/tmp/random/dir/' . mt_rand());
-} catch (IOException $e) {
-    echo "An error occurred while creating your directory";
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Los métodos mkdir(), exists(), touch(), remove(), chmod(), chown() y chgrp() pueden recibir una cadena, un arreglo o cualquier objeto que implemente Traversable como el argumento destino.

                  -
                  -
                  -

                  Mkdir

                  -

                  Mkdir crea directorios. En sistemas de archivos POSIX, de manera predeterminada los directorios se crean con un valor de 0777 para el modo. Puedes utilizar el segundo argumento para establecer tu propio modo:

                  -
                  $fs->mkdir('/tmp/photos', 0700);
-
                  -
                  -
                  -

                  Nota

                  -

                  Puedes pasar como primer argumento un arreglo o cualquier otro objeto Traversable.

                  -
                  -
                  -
                  -

                  Exists

                  -

                  Exists comprueba la presencia de todos los archivos o directorios y devuelve false si falta un archivo:

                  -
                  // este directorio existe, devuelve true
-$fs->exists('/tmp/photos');
-
-// rabbit.jpg existe, bottle.png no existe, devuelve false
-$fs->exists(array('rabbit.jpg', 'bottle.png'));
-
                  -
                  -
                  -

                  Nota

                  -

                  Puedes pasar como primer argumento un arreglo o cualquier otro objeto Traversable.

                  -
                  -
                  -
                  -

                  Copy

                  -

                  Este método se utiliza para copiar archivos. If the target already exists, the file is -copied only if the source modification date is later than the target. Puedes redefinir este comportamiento con el tercer argumento booleano:

                  -
                  // sólo funciona si image-ICC.jpg se modificó después de image.jpg
-$fs->copy('image-ICC.jpg', 'image.jpg');
-
-// image.jpg será reemplazada
-$fs->copy('image-ICC.jpg', 'image.jpg', true);
-
                  -
                  -
                  -
                  -

                  Touch

                  -

                  Touch establece el acceso y la hora de modificación de un archivo. De manera predeterminada utiliza la hora actual. Puedes configurar la tuya con el segundo argumento. El tercer argumento es la hora de acceso:

                  -
                  // establece la hora de modificación a la fecha y hora actual
-$fs->touch('file.txt');
-// establece la hora de modificación 10 segundos en el futuro
-$fs->touch('file.txt', time() + 10);
-// establece la hora de acceso 10 segundos en el pasado
-$fs->touch('file.txt', time(), time() - 10);
-
                  -
                  -
                  -

                  Nota

                  -

                  Puedes pasar como primer argumento un arreglo o cualquier otro objeto Traversable.

                  -
                  -
                  -
                  -

                  Chown

                  -

                  Utiliza chown para cambiar el propietario de un archivo. El tercer argumento es una opción booleana recursiva:

                  -
                  // establece el propietario del video lolcat a www-data
-$fs->chown('lolcat.mp4', 'www-data');
-// cambia recursivamente el propietario del directorio video
-$fs->chown('/video', 'www-data', true);
-
                  -
                  -
                  -

                  Nota

                  -

                  Puedes pasar como primer argumento un arreglo o cualquier otro objeto Traversable.

                  -
                  -
                  -
                  -

                  Chgrp

                  -

                  Utiliza chgrp para cambiar el grupo de un archivo. El tercer argumento es una opción booleana recursiva:

                  -
                  // establecer el grupo del vídeo lolcat a nginx
-$fs->chgrp('lolcat.mp4', 'nginx');
-// cambia recursivamente el grupo del directorio video
-$fs->chgrp('/video', 'nginx', true);
-
                  -
                  -
                  -

                  Nota

                  -

                  Puedes pasar como primer argumento un arreglo o cualquier otro objeto Traversable.

                  -
                  -
                  -
                  -

                  Chmod

                  -

                  Chmod se utiliza para cambiar el modo de un archivo. The fourth argument is a boolean -recursive option:

                  -
                  // establece el modo de vídeo a 0600
-$fs->chmod('video.ogg', 0600);
-// cambia recursivamente el modo del directorio src
-$fs->chmod('src', 0700, 0000, true);
-
                  -
                  -
                  -

                  Nota

                  -

                  Puedes pasar como primer argumento un arreglo o cualquier otro objeto Traversable.

                  -
                  -
                  -
                  -

                  Remove

                  -

                  Remove te permite eliminar fácilmente archivos, enlaces simbólicos y directorios:

                  -
                  $fs->remove(array('symlink', '/ruta/al/directorio', 'activity.log'));
-
                  -
                  -
                  -

                  Nota

                  -

                  Puedes pasar como primer argumento un arreglo o cualquier otro objeto Traversable.

                  -
                  -
                  -
                  -

                  Rename

                  -

                  Utiliza rename para cambiar el nombre de archivos y directorios:

                  -
                  // renombra un archivo
-$fs->rename('/tmp/processed_video.ogg', '/ruta/a/tienda/video_647.ogg');
-// renombra un directorio
-$fs->rename('/tmp/files', '/ruta/a/tienda/files');
-
                  -
                  -
                  - -
                  -

                  makePathRelative

                  -

                  Devuelve la ruta relativa de un directorio dado:

                  -
                  // devuelve '../'
-$fs->makePathRelative(
-    '/var/lib/symfony/src/Symfony/',
-    '/var/lib/symfony/src/Symfony/Component'
-);
-// devuelve 'videos'
-$fs->makePathRelative('/tmp', '/tmp/videos');
-
                  -
                  -
                  -
                  -

                  mirror

                  -

                  Refleja un directorio:

                  -
                  $fs->mirror('/ruta/a/source', '/ruta/a/target');
-
                  -
                  -
                  -
                  -

                  isAbsolutePath

                  -

                  isAbsolutePath devuelve true si la ruta especificada es absoluta, false en caso contrario:

                  -
                  // devuelve true
-$fs->isAbsolutePath('/tmp');
-// devuelve true
-$fs->isAbsolutePath('c:\\Windows');
-// devuelve false
-$fs->isAbsolutePath('tmp');
-// devuelve false
-$fs->isAbsolutePath('../dir');
-
                  -
                  -
                  -
                  -
                  -

                  Manejando errores

                  -

                  Cuando sucede algo malo, se lanza una excepción que implementa la clase -Symfony\Component\Filesystem\Exception\ExceptionInterface.

                  -
                  -

                  Nota

                  -

                  Antes de la versión 2.1, mkdir() devolvía un valor lógico y no lanzaba excepciones. A partir de 2.1, se lanza una Symfony\Component\Filesystem\Exception\IOException si falla la creación del directorio.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/finder.html b/components/finder.html deleted file mode 100644 index 733cf49..0000000 --- a/components/finder.html +++ /dev/null @@ -1,386 +0,0 @@ - - - - - - - El componente Finder — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Finder

                  -
                  -
                  El componente Finder busca archivos y directorios a través de una sencilla e intuitiva interfaz.
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  La clase Symfony\Component\Finder\Finder busca archivos y/o -directorios:

                  -
                  use Symfony\Component\Finder\Finder;
-
-$finder = new Finder();
-$finder->files()->in(__DIR__);
-
-foreach ($finder as $file) {
-    // Imprime la ruta absoluta
-    print $file->getRealpath()."\n";
-
-    // Imprime la ruta relativa al archivo, omitiendo el nombre de archivo
-    print $file->getRelativePath()."\n";
-
-    // Imprime la ruta relativa para el archivo
-    print $file->getRelativePathname()."\n";
-}
-
                  -
                  -

                  $file es una instancia de Symfony\Component\Finder\SplFileInfo la cual extiende a SplFileInfo para proporcionar métodos para trabajar con rutas relativas.

                  -

                  El código anterior imprime recursivamente los nombres de todos los archivos en el directorio actual. La clase Finder utiliza una interfaz fluida, por lo que todos los métodos devuelven la instancia del Finder.

                  -
                  -

                  Truco

                  -

                  Una instancia del Finder es un Iterator de PHP. Por lo tanto, en lugar de iterar sobre el Finder con foreach, también lo puedes convertir en un arreglo con el método iterator_to_array u obtener el número de elementos con iterator_count.

                  -
                  -
                  -

                  Prudencia

                  -

                  Al buscar a través de múltiples ubicaciones pasadas al método in(), internamente se crea un iterador independiente por cada ubicación. Esto significa que tienes múltiples resultados agregados a uno. -Debido a que iterator_to_array de manera predefinida usa el conjunto de claves del resultado, al convertirlo en arreglo, algunas claves se podrían duplicar y por lo tanto sustituir sus valores. Esto se puede evitar pasando false como segundo argumento a iterator_to_array.

                  -
                  -
                  -
                  -

                  Criterios

                  -

                  Hay muchas maneras de filtrar y ordenar tu resultado.

                  -
                  -

                  Ubicación

                  -

                  La ubicación es el único criterio obligatorio. Este dice al buscador cual directorio utilizar para la búsqueda:

                  -
                  $finder->in(__DIR__);
-
                  -
                  -

                  Busca en varios lugares encadenando llamadas al método in():

                  -
                  $finder->files()->in(__DIR__)->in('/elsewhere');
-
                  -
                  -

                  -Nuevo en la versión 2.2: El soporte necesario para el comodín se añadió en la versión 2.2.

                  -

                  Usa caracteres comodín para buscar en los directorios que emparejen un patrón:

                  -
                  $finder->in('src/Symfony/*/*/Resources');
-
                  -
                  -

                  Cada patrón tiene que resolver cuando menos con una ruta de directorio.

                  -

                  Excluye directorios coincidentes con el método exclude():

                  -
                  $finder->in(__DIR__)->exclude('ruby');
-
                  -
                  -

                  Debido a que Finder utiliza iteradores PHP, puedes pasar cualquier URL con un protocolo compatible:

                  -
                  $finder->in('ftp://ejemplo.com/pub/');
-
                  -
                  -

                  Y también trabaja con flujos definidos por el usuario:

                  -
                  use Symfony\Component\Finder\Finder;
-
-$s3 = new \Zend_Service_Amazon_S3($key, $secret);
-$s3->registerStreamWrapper("s3");
-
-$finder = new Finder();
-$finder->name('photos*')->size('< 100K')->date('since 1 hour ago');
-foreach ($finder->in('s3://bucket-name') as $file) {
-    // ... hace algo
-
-    print $file->getFilename()."\n";
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Lee la documentación de Flujos para aprender a crear tus propios flujos.

                  -
                  -
                  -
                  -

                  Archivos o directorios

                  -

                  De manera predeterminada, Finder devuelve archivos y directorios; Pero los métodos files() y -directories() controlan:

                  -
                  $finder->files();
-
-$finder->directories();
-
                  -
                  -

                  Si quieres seguir los enlaces, utiliza el método followLinks():

                  -
                  $finder->files()->followLinks();
-
                  -
                  -

                  De forma predeterminada, el iterador ignora archivos VCS populares. Esto se puede cambiar con el método ignoreVCS():

                  -
                  $finder->ignoreVCS(false);
-
                  -
                  -
                  -
                  -

                  Ordenación

                  -

                  Ordena el resultado por nombre o por tipo (primero directorios, luego archivos):

                  -
                  $finder->sortByName();
-
-$finder->sortByType();
-
                  -
                  -
                  -

                  Nota

                  -

                  Ten en cuenta que los métodos sort* necesitan obtener todos los elementos para hacer su trabajo. Para iteradores grandes, es lento.

                  -
                  -

                  También puedes definir tu propio algoritmo de ordenación con el método sort():

                  -
                  $sort = function (\SplFileInfo $a, \SplFileInfo $b)
-{
-    return strcmp($a->getRealpath(), $b->getRealpath());
-};
-
-$finder->sort($sort);
-
                  -
                  -
                  -
                  -

                  Nombre de archivo

                  -

                  Filtra archivos por nombre con el método name():

                  -
                  $finder->files()->name('*.php');
-
                  -
                  -

                  El método name() acepta globos, cadenas o expresiones regulares:

                  -
                  $finder->files()->name('/\.php$/');
-
                  -
                  -

                  El método notName() excluye archivos coincidentes con un patrón:

                  -
                  $finder->files()->notName('*.rb');
-
                  -
                  -
                  -
                  -

                  Contenido del archivo

                  -

                  -Nuevo en la versión 2.1: Los métodos contains() y notContains() se añadieron en la versión 2.1

                  -

                  Restringiendo el contenido de archivos con el método contains():

                  -
                  $finder->files()->contains('lorem ipsum');
-
                  -
                  -

                  El método contains() acepta cadenas o expresiones regulares:

                  -
                  $finder->files()->contains('/lorem\s+ipsum$/i');
-
                  -
                  -

                  El método notContains() excluye archivos que contienen un determinado patrón:

                  -
                  $finder->files()->notContains('dolor sit amet');
-
                  -
                  -
                  -
                  -

                  path

                  -

                  -Nuevo en la versión 2.2: Los métodos path() y notPath() se añadieron en la versión 2.2.

                  -

                  Restringe archivos y directorios por ruta con el -método path():

                  -
                  $finder->path('some/special/dir');
-
                  -
                  -

                  En todos los ambientes se debería usar la barra inclinada (es decir, /) como separador de directorio.

                  -

                  El el método path() acepta una cadena o una expresión regular:

                  -
                  $finder->path('foo/bar');
-$finder->path('/^foo\/bar/');
-
                  -
                  -

                  Internamente, las cadenas se convierten a expresiones regulares escapando las barras invertidas y añadiendo delimitadores:

                  -
                  dirname    ===>    /dirname/
-a/b/c      ===>    /a\/b\/c/
-
                  -
                  -

                  El método notPath() excluye archivos por ruta:

                  -
                  $finder->notPath('otro/dir');
-
                  -
                  -
                  -
                  -

                  Tamaño de archivo

                  -

                  Filtra archivos por tamaño con el método size():

                  -
                  $finder->files()->size('< 1.5K');
-
                  -
                  -

                  Filtra por rangos de tamaño encadenando llamadas a:

                  -
                  $finder->files()->size('>= 1K')->size('<= 2K');
-
                  -
                  -

                  El operador de comparación puede ser cualquiera de los siguientes: >, >=, <, <=, -==, !=.

                  -

                  -Nuevo en la versión 2.1: El operador != se añadió en la versión 2.1.

                  -

                  El valor destino puede utilizar magnitudes de kilobytes (k, ki), megabytes (m, mi), o gigabytes (g, gi). Los sufijos con una i usan la versión 2**n adecuada de acuerdo al estándar IEC.

                  -
                  -
                  -

                  Fecha de archivo

                  -

                  Filtra archivos por fecha de última modificación con el método date():

                  -
                  $finder->date('since yesterday');
-
                  -
                  -

                  El operador de comparación puede ser cualquiera de los siguientes: >, >=, <, <=, -==. También puedes utilizar since o after como alias para >, y until o before como alias para <.

                  -

                  El valor destino puede ser cualquier fecha compatible con la función strtotime.

                  -
                  -
                  -

                  Profundidad de directorio

                  -

                  De manera predeterminada, Finder recorre directorios recurrentemente. Filtra la profundidad del recorrido con el método depth():

                  -
                  $finder->depth('== 0');
-$finder->depth('< 3');
-
                  -
                  -
                  -
                  -

                  Filtrado personalizado

                  -

                  Para restringir que el archivo coincida con su propia estrategia, utiliza el método filter():

                  -
                  $filter = function (\SplFileInfo $file)
-{
-    if (strlen($file) > 10) {
-            return false;
-    }
-};
-
-$finder->files()->filter($filtro);
-
                  -
                  -

                  El método filter() toma un cierre como argumento. Por cada archivo coincidente, este es invocado con el archivo como una instancia de Symfony\Component\Finder\SplFileInfo. El archivo se excluye del conjunto de resultados si el cierre devuelve false.

                  -
                  -
                  -

                  Leyendo el contenido de los archivos devueltos

                  -

                  -Nuevo en la versión 2.1: El método getContents() se introdujo en la versión 2.1.

                  -

                  El contenido devuelto de los archivos se puede leer con el método getContents():

                  -
                  use Symfony\Component\Finder\Finder;
-
-$finder = new Finder();
-$finder->files()->in(__DIR__);
-
-foreach ($finder as $file) {
-    $contents = $file->getContents();
-    ...
-}
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_foundation.html b/components/http_foundation.html deleted file mode 100644 index db79a4c..0000000 --- a/components/http_foundation.html +++ /dev/null @@ -1,380 +0,0 @@ - - - - - - - El componente HttpFoundation — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente HttpFoundation

                  -
                  -
                  El componente HttpFoundation define una capa orientada a objetos para la especificación HTTP.
                  -

                  En PHP, la petición está representada por algunas variables globales ($_GET, $_POST, $_FILE, $_COOKIE, $_SESSION...) y la respuesta es generada por algunas funciones (echo, header, setcookie, ...).

                  -

                  El componente HttpFoundation de Symfony2 sustituye estas variables globales y funciones de PHP por una capa orientada a objetos.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  -
                    -
                  • Usando el repositorio Git oficial (https://github.com/symfony/HttpFoundation);
                    • -
                  • Instalándolo a través de PEAR (pear.symfony.com/HttpFoundation);
                    • -
                  • Instalándolo vía Composer (symfony/http-foundation en Packagist).
                    • -
                  -
                  -
                  -

                  Petición

                  -

                  La manera más común para crear una petición es basándose en las variables globales de PHP con -createFromGlobals():

                  -
                  use Symfony\Component\HttpFoundation\Request;
-
-$request = Request::createFromGlobals();
-
                  -
                  -

                  que es casi equivalente a la más prolija, pero también más flexible, llamada a -__construct():

                  -
                  $request = new Request($_GET, $_POST, array(), $_COOKIE, $_FILES, $_SERVER);
-
                  -
                  -
                  -

                  Accediendo a datos de la Petición

                  -

                  Un objeto Petición contiene información sobre la petición del cliente. Puedes acceder a esta información a través de muchas propiedades públicas:

                  -
                    -
                  • request: equivalente de $_POST;
                    • -
                  • query: equivalente de $_GET ($request->query->get('name'));
                    • -
                  • cookies: equivalente de $_COOKIE;
                    • -
                  • attributes: sin equivalente — utilizado por tu aplicación para almacenar otros datos (ve más adelante)
                    • -
                  • files: equivalente de $_FILE;
                    • -
                  • server: equivalente de $_SERVER;
                    • -
                  • headers: en su mayoría equivalente a un subconjunto de $_SERVER ($request->headers->get('Content-Type')).
                    • -
                  -

                  Cada propiedad es una instancia de Symfony\Component\HttpFoundation\ParameterBag (o una subclase), que es una clase que contiene datos:

                  -
                    -
                  • request: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • query: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • cookies: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • attributes: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • files: Symfony\Component\HttpFoundation\FileBag;
                    • -
                  • server: Symfony\Component\HttpFoundation\ServerBag;
                    • -
                  • headers: Symfony\Component\HttpFoundation\HeaderBag.
                    • -
                  -

                  Todas las instancias de la clase Symfony\Component\HttpFoundation\ParameterBag tienen métodos para recuperar y actualizar sus datos:

                  -
                    -
                  • all(): Devuelve los parámetros;
                    • -
                  • keys(): Devuelve las claves de los parámetros;
                    • -
                  • replace(): -Sustituye los parámetros actuales por un nuevo conjunto;
                    • -
                  • add(): Añade parámetros;
                    • -
                  • get(): Devuelve un parámetro por nombre;
                    • -
                  • set(): Establece un parámetro por nombre;
                    • -
                  • has(): Devuelve true si el parámetro está definido;
                    • -
                  • remove(): Elimina un parámetro.
                    • -
                  -

                  La instancia de Symfony\Component\HttpFoundation\ParameterBag también tiene algunos métodos para filtrar los valores introducidos:

                  -
                    -
                  • getAlpha(): Devuelve los caracteres alfanuméricos del valor del parámetro;
                    • -
                  • getAlnum(): Devuelve los caracteres alfanuméricos y dígitos del valor del parámetro;
                    • -
                  • getDigits(): Devuelve los dígitos del valor del parámetro;
                    • -
                  • getInt(): Devuelve el valor del parámetro convertido a entero;
                    • -
                  • filter(): Filtra el parámetro usando la función filter_var() de PHP.
                    • -
                  -

                  Todos los captadores toman hasta tres argumentos: el primero es el nombre del parámetro y el segundo es el valor predeterminado a devolver si el parámetro no existe:

                  -
                  // La cadena de consulta es '?foo=bar'
-
-$request->query->get('foo');
-// devuelve bar
-
-$request->query->get('bar');
-// devuelve null
-
-$request->query->get('bar', 'bar');
-// devuelve 'bar'
-
                  -
                  -

                  Cuando PHP importa la consulta de la petición, manipula los parámetros de la petición como -foo[bar]=bar de una manera especial, ya que crea una matriz. Para que puedas obtener el parámetro foo y devolver una matriz con un elemento bar. pero a veces, posiblemente quieras obtener el valor por medio del nombre “original” del parámetro: -foo[bar]. Esto es posible con todos los captadores de ParameterBag como -get() a través del tercer argumento:

                  -
                  // la cadena de consulta es '?foo[bar]=bar'
-
-$request->query->get('foo');
-// devuelve array('bar' => 'bar')
-
-$request->query->get('foo[bar]');
-// devuelve null
-
-$request->query->get('foo[bar]', null, true);
-// devuelve 'bar'
-
                  -
                  -

                  Por último, pero no menos importante, también puedes almacenar más datos en la petición, gracias a la propiedad pública attributes, que también es una instancia de Symfony\Component\HttpFoundation\ParameterBag. Casi siempre se usa para adjuntar información que pertenece a la Petición y que necesitas acceder desde diferentes puntos de tu aplicación. Para información sobre cómo se utiliza en la plataforma Symfony2, consulta la propiedad pública attributes.

                  -
                  -
                  -

                  Identificando una Petición

                  -

                  En tu aplicación, necesitas una manera de identificar una petición; la mayor parte del tiempo, esto se hace a través de la “información de ruta” de la petición, a la que puedes acceder a través del método getPathInfo():

                  -
                  // Para una petición a http://example.com/blog/index.php/post/hello-world
-// la información de ruta es "/post/hello-world"
-$request->getPathInfo();
-
                  -
                  -
                  -
                  -

                  Simulando una Petición

                  -

                  En lugar de crear una petición basada en las variables globales de PHP, también puedes simular -una Petición:

                  -
                  $request = Request::create('/hello-world', 'GET', array('name' => 'Fabien'));
-
                  -
                  -

                  El método create() crea una petición basándose en la información de una ruta, un método y algunos parámetros (los parámetros de consulta o los de la petición en función del método HTTP); y, por supuesto, también puedes sustituir todas las otras variables (de manera predeterminada, Symfony crea parámetros predeterminados apropiados para todas las variables globales de PHP).

                  -

                  En base a dicha petición, puedes sustituir las variables globales de PHP a través de overrideGlobals():

                  -
                  $request->overrideGlobals();
-
                  -
                  -
                  -

                  Truco

                  -

                  También puedes duplicar una consulta existente a través del método duplicate() o cambiar un montón de parámetros con una sola llamada a initialize().

                  -
                  -
                  -
                  -

                  Accediendo a la Sesión

                  -

                  Si tienes una sesión adjunta a la Petición, puedes acceder a ella a través del método getSession(); -el método hasPreviousSession() te dice si la petición contiene una sesión que se inició en una de las peticiones anteriores.

                  -
                  -
                  -

                  Accediendo a otros datos

                  -

                  La clase Petición tiene muchos otros métodos que puedes utilizar para acceder a la información de la petición. Echa un vistazo a la API para más información sobre ellos.

                  -
                  -
                  -
                  -

                  Respuesta

                  -

                  Un objeto Symfony\Component\HttpFoundation\Response contiene toda la información que debes enviar de vuelta al cliente desde una determinada Petición. El constructor toma hasta tres argumentos: el contenido de la respuesta, el código de estado, y una serie de cabeceras HTTP:

                  -
                  use Symfony\Component\HttpFoundation\Response;
-
-$response = new Response('Content',
-                         200,
-                         array('content-type' => 'text/html')
-                );
-
                  -
                  -

                  También puedes manipular esta información después de haber creado la Respuesta:

                  -
                  $response->setContent('Hello World');
-
-// el atributo público headers es un ResponseHeaderBag
-$response->headers->set('Content-Type', 'text/plain');
-
-$response->setStatusCode(404);
-
                  -
                  -

                  Al establecer el Content-Type de la respuesta, puedes configurar el juego de caracteres, pero es mejor configurarlo a través del método setCharset():

                  -
                  $response->setCharset('ISO-8859-1');
-
                  -
                  -

                  Ten en cuenta que de manera predeterminada, Symfony asume que sus respuestas están codificadas en -UTF-8.

                  -
                  -

                  Enviando la Respuesta

                  -

                  Antes de enviar la respuesta, te puedes asegurar de que es compatible con la especificación del protocolo HTTP llamando al método prepare():

                  -
                  $response->prepare($request);
-
                  -
                  -

                  Enviar la respuesta entonces es tan sencillo cómo invocar al método send():

                  -
                  $response->send();
-
                  -
                  -
                  -
                  -

                  Enviando Cookies

                  -

                  Puedes manipular las cookies de la respuesta por medio del atributo público headers:

                  -
                  use Symfony\Component\HttpFoundation\Cookie;
-
-$response->headers->setCookie(new Cookie('foo', 'bar'));
-
                  -
                  -

                  El método setCookie() toma como argumento una instancia de Symfony\Component\HttpFoundation\Cookie.

                  -

                  Puedes borrar una cookie a través del método clearCookie().

                  -
                  -
                  -

                  Gestionando la caché HTTP

                  -

                  La clase Symfony\Component\HttpFoundation\Response tiene un rico conjunto de métodos para manipular las cabeceras HTTP relacionadas con la memoria caché:

                  - -

                  Puedes utilizar el método setCache() para establecer la información de caché utilizada comúnmente en una llamada al método:

                  -
                  $response->setCache(array(
-    'etag'          => 'abcdef',
-    'last_modified' => new \DateTime(),
-    'max_age'       => 600,
-    's_maxage'      => 600,
-    'private'       => false,
-    'public'        => true,
-));
-
                  -
                  -

                  Para comprobar si los validadores de la Respuesta (ETag, Last-Modified) coinciden con un valor condicional especificado en la petición del cliente, utiliza el método isNotModified():

                  -
                  if ($response->isNotModified($request)) {
-    $response->send();
-}
-
                  -
                  -

                  Si la respuesta no se ha modificado, se establece el código de estado a 304 y elimina el contenido real de la respuesta.

                  -
                  -
                  -

                  Redirigiendo al usuario

                  -

                  Para redirigir al cliente a otra URL, puedes utilizar la clase Symfony\Component\HttpFoundation\RedirectResponse:

                  -
                  use Symfony\Component\HttpFoundation\RedirectResponse;
-
-$response = new RedirectResponse('http://ejemplo.com/');
-
                  -
                  -
                  -
                  -

                  Transmitiendo una Respuesta

                  -

                  -Nuevo en la versión 2.1: La compatibilidad a la transmisión de respuestas se añadió en Symfony 2.1.

                  -

                  La clase Symfony\Component\HttpFoundation\StreamedResponse te permite transmitir la respuesta de vuelta al cliente. El contenido de la respuesta está representado por una función PHP ejecutable en lugar de una cadena:

                  -
                  use Symfony\Component\HttpFoundation\StreamedResponse;
-
-$response = new StreamedResponse();
-$response->setCallback(function () {
-    echo 'Hello World';
-    flush();
-    sleep(2);
-    echo 'Hello World';
-    flush();
-});
-$response->send();
-
                  -
                  -
                  -
                  -

                  Descargando archivos

                  -

                  -Nuevo en la versión 2.1: El método makeDisposition fue añadido en Symfony 2.1.

                  -

                  Al cargar un archivo, debes agregar una cabecera Content-Disposition a tu respuesta. Es fácil crear esta cabecera básica para descargar archivos, utilizando nombres de archivo -no ASCII más envolventes. El método Symfony\Component\HttpFoundation\Response:makeDisposition() abstrae el trabajo duro detrás de una sencilla API:

                  -
                  use Symfony\Component\HttpFoundation\ResponseHeaderBag;
-
-$d = $response->headers->makeDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, 'foo.pdf');
-
-$response->headers->set('Content-Disposition', $d);
-
                  -
                  -
                  -
                  -
                  -

                  Session

                  -

                  TBD — De esta parte no se ha escrito nada, ya que probablemente será reconstruida próximamente en Symfony 2.1.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_foundation/index.html b/components/http_foundation/index.html deleted file mode 100644 index b30621b..0000000 --- a/components/http_foundation/index.html +++ /dev/null @@ -1,171 +0,0 @@ - - - - - - - Fundamento HTTP — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_foundation/introduction.html b/components/http_foundation/introduction.html deleted file mode 100644 index 444b8b2..0000000 --- a/components/http_foundation/introduction.html +++ /dev/null @@ -1,508 +0,0 @@ - - - - - - - El componente HttpFoundation — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente HttpFoundation

                  -
                  -
                  El componente HttpFoundation define una capa orientada a objetos para la especificación HTTP.
                  -

                  En PHP, la petición está representada por algunas variables globales ($_GET, $_POST, $_FILE, $_COOKIE, $_SESSION, ...) y la respuesta es generada por algunas funciones (echo, header, setcookie, ...).

                  -

                  El componente HttpFoundation de Symfony2 sustituye estas variables globales y funciones predefinidas en PHP por una capa orientada a objetos.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Petición

                  -

                  La manera más común para crear una petición es basándose en las variables globales de PHP con -createFromGlobals():

                  -
                  use Symfony\Component\HttpFoundation\Request;
-
-$request = Request::createFromGlobals();
-
                  -
                  -

                  que es casi equivalente a la más prolija, pero también más flexible, llamada al método __construct():

                  -
                  $request = new Request(
-    $_GET,
-    $_POST,
-    array(),
-    $_COOKIE,
-    $_FILES,
-    $_SERVER
-);
-
                  -
                  -
                  -

                  Accediendo a datos de la Petición

                  -

                  Un objeto Petición contiene información sobre la petición del cliente. Puedes acceder a esta información a través de muchas propiedades públicas:

                  -
                    -
                  • request: equivalente de $_POST;
                    • -
                  • query: equivalente de $_GET ($request->query->get('name'));
                    • -
                  • cookies: equivalente de $_COOKIE;
                    • -
                  • attributes: sin equivalente — utilizado por tu aplicación para almacenar otros datos (ve más adelante)
                    • -
                  • files: equivalente de $_FILE;
                    • -
                  • server: equivalente de $_SERVER;
                    • -
                  • headers: en su mayoría equivalente a un subconjunto de $_SERVER ($request->headers->get('Content-Type')).
                    • -
                  -

                  Cada propiedad es una instancia de Symfony\Component\HttpFoundation\ParameterBag (o una subclase), que es una clase que contiene datos:

                  -
                    -
                  • request: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • query: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • cookies: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • attributes: Symfony\Component\HttpFoundation\ParameterBag;
                    • -
                  • files: Symfony\Component\HttpFoundation\FileBag;
                    • -
                  • server: Symfony\Component\HttpFoundation\ServerBag;
                    • -
                  • headers: Symfony\Component\HttpFoundation\HeaderBag.
                    • -
                  -

                  Todas las instancias de la clase Symfony\Component\HttpFoundation\ParameterBag tienen métodos para recuperar y actualizar sus datos:

                  -
                    -
                  • all(): Devuelve los parámetros;
                    • -
                  • keys(): Devuelve las claves de los parámetros;
                    • -
                  • replace(): -Sustituye los parámetros actuales por un nuevo conjunto;
                    • -
                  • add(): Añade parámetros;
                    • -
                  • get(): Devuelve un parámetro por nombre;
                    • -
                  • set(): Establece un parámetro por nombre;
                    • -
                  • has(): Devuelve true si el parámetro está definido;
                    • -
                  • remove(): Elimina un parámetro.
                    • -
                  -

                  La instancia de Symfony\Component\HttpFoundation\ParameterBag también tiene algunos métodos para filtrar los valores introducidos:

                  -
                    -
                  • getAlpha(): Devuelve los caracteres alfanuméricos del valor del parámetro;
                    • -
                  • getAlnum(): Devuelve los caracteres alfanuméricos y dígitos del valor del parámetro;
                    • -
                  • getDigits(): Devuelve los dígitos del valor del parámetro;
                    • -
                  • getInt(): Devuelve el valor del parámetro convertido a entero;
                    • -
                  • filter(): Filtra el parámetro usando la función filter_var() de PHP.
                    • -
                  -

                  Todos los captadores toman hasta tres argumentos: el primero es el nombre del parámetro y el segundo es el valor predeterminado a devolver si el parámetro no existe:

                  -
                  // La cadena de consulta es '?foo=bar'
-
-$request->query->get('foo');
-// devuelve bar
-
-$request->query->get('bar');
-// devuelve null
-
-$request->query->get('bar', 'bar');
-// devuelve 'bar'
-
                  -
                  -

                  Cuando PHP importa la consulta de la petición, manipula los parámetros de la petición como -foo[bar]=bar de una manera especial, ya que crea un arreglo. Para que puedas obtener el parámetro foo y devolver un arreglo con un elemento bar. pero a veces, posiblemente quieras obtener el valor por medio del nombre «original» del parámetro: -foo[bar]. Esto es posible con todos los captadores de ParameterBag como -get() a través del tercer argumento:

                  -
                  // la cadena de consulta es '?foo[bar]=bar'
-
-$request->query->get('foo');
-// devuelve array('bar' => 'bar')
-
-$request->query->get('foo[bar]');
-// devuelve null
-
-$request->query->get('foo[bar]', null, true);
-// devuelve 'bar'
-
                  -
                  -

                  Por último, pero no menos importante, también puedes almacenar datos adicionales en la petición, gracias a la propiedad pública attributes, que también es una instancia de la clase Symfony\Component\HttpFoundation\ParameterBag. Casi siempre se usa para adjuntar información que pertenece a la Petición y que necesitas acceder desde diferentes puntos de tu aplicación. Para información sobre cómo se utiliza en la plataforma Symfony2, consulta la propiedad pública attributes.

                  -
                  -
                  -

                  Identificando una Petición

                  -

                  En tu aplicación, necesitas una manera de identificar una petición; la mayor parte del tiempo, esto se hace a través de la «información de ruta» de la petición, a la que puedes acceder a través del método getPathInfo():

                  -
                  // Para una petición a http://example.com/blog/index.php/post/hello-world
-// la información de ruta es "/post/hello-world"
-$request->getPathInfo();
-
                  -
                  -
                  -
                  -

                  Simulando una Petición

                  -

                  En lugar de crear una petición basada en las variables globales de PHP, también puedes simular -una Petición:

                  -
                  $request = Request::create(
-    '/hello-world',
-    'GET',
-    array('name' => 'Fabien')
-);
-
                  -
                  -

                  El método create() crea una petición basándose en la información de una ruta, un método y algunos parámetros (los parámetros de consulta o los de la petición en función del método HTTP); and of -course, you can also override all other variables as well (by default, Symfony -creates sensible defaults for all the PHP global variables).

                  -

                  En base a dicha petición, puedes sustituir las variables globales de PHP a través de overrideGlobals():

                  -
                  $request->overrideGlobals();
-
                  -
                  -
                  -

                  Truco

                  -

                  También puedes duplicar una consulta existente a través del método duplicate() o cambiar un montón de parámetros con una sola llamada a initialize().

                  -
                  -
                  -
                  -

                  Accediendo a la Sesión

                  -

                  Si tienes una sesión adjunta a la Petición, puedes acceder a ella a través del método getSession(); -el método hasPreviousSession() te dice si la petición contiene una sesión que se inició en una de las peticiones anteriores.

                  -
                  -
                  -

                  Accediendo a los datos de cabeceras Accept-*

                  -

                  Puedes acceder fácilmente a los dato básicos extraídos desde las cabeceras Accept-* utilizando los siguientes métodos:

                  -
                    -
                  • getAcceptableContentTypes(): -devuelve la lista de tipos de contenido aceptados ordenados descendentemente por cualidad;
                    • -
                  • getLanguages(): -devuelve la lista de idiomas aceptados ordenados descendentemente por cualidad;
                    • -
                  • getCharsets(): -devuelve la lista de juegos de caracteres («charsets») aceptados ordenados descendentemente por cualidad;
                    • -
                  -

                  -Nuevo en la versión 2.2: La clase Symfony\Component\HttpFoundation\AcceptHeader es nueva en Symfony 2.2.

                  -

                  Si necesitas conseguir acceso completo a los datos analizados de Accept, Accept-Language, Accept-Charset o Accept-Encoding, puedes usar la clase utilitaria Symfony\Component\HttpFoundation\AcceptHeader:

                  -
                  use Symfony\Component\HttpFoundation\AcceptHeader;
-
-$accept = AcceptHeader::fromString($request->headers->get('Accept'));
-if ($accept->has('text/html')) {
-    $item = $accept->get('html');
-    $charset = $item->getAttribute('charset', 'utf-8');
-    $quality = $item->getQuality();
-}
-
-// acepta elementos que están ordenados descendentemente por cualidad
-$accepts = AcceptHeader::fromString($request->headers->get('Accept'))->all();
-
                  -
                  -
                  -
                  -

                  Accediendo a otros datos

                  -

                  La clase Petición tiene muchos otros métodos que puedes utilizar para acceder a la información de la petición. Echa un vistazo a la API para más información sobre ellos.

                  -
                  -
                  -
                  -

                  Respuesta

                  -

                  Un objeto Symfony\Component\HttpFoundation\Response contiene toda la información que debes enviar de vuelta al cliente desde una determinada Petición. El constructor toma hasta tres argumentos: el contenido de la respuesta, el código de estado, y una serie de cabeceras HTTP:

                  -
                  use Symfony\Component\HttpFoundation\Response;
-
-$response = new Response(
-    'Content',
-    200,
-    array('content-type' => 'text/html')
-);
-
                  -
                  -

                  También puedes manipular esta información después de haber creado la Respuesta:

                  -
                  $response->setContent('Hello World');
-
-// el atributo público headers es un ResponseHeaderBag
-$response->headers->set('Content-Type', 'text/plain');
-
-$response->setStatusCode(404);
-
                  -
                  -

                  Al establecer el Content-Type de la respuesta, puedes configurar el juego de caracteres, pero es mejor configurarlo a través del método setCharset():

                  -
                  $response->setCharset('ISO-8859-1');
-
                  -
                  -

                  Ten en cuenta que de manera predeterminada, Symfony asume que sus respuestas están codificadas en -UTF-8.

                  -
                  -

                  Enviando la Respuesta

                  -

                  Antes de enviar la respuesta, te puedes asegurar de que es compatible con la especificación del protocolo HTTP llamando al método prepare():

                  -
                  $response->prepare($request);
-
                  -
                  -

                  Enviar la respuesta entonces es tan sencillo cómo invocar al método send():

                  -
                  $response->send();
-
                  -
                  -
                  -
                  -

                  Enviando Cookies

                  -

                  Puedes manipular las cookies de la respuesta por medio del atributo público headers:

                  -
                  use Symfony\Component\HttpFoundation\Cookie;
-
-$response->headers->setCookie(new Cookie('foo', 'bar'));
-
                  -
                  -

                  El método setCookie() toma como argumento una instancia de Symfony\Component\HttpFoundation\Cookie.

                  -

                  Puedes borrar una cookie a través del método clearCookie().

                  -
                  -
                  -

                  Gestionando la caché HTTP

                  -

                  La clase Symfony\Component\HttpFoundation\Response tiene un rico conjunto de métodos para manipular las cabeceras HTTP relacionadas con la memoria caché:

                  - -

                  Puedes utilizar el método setCache() para establecer la información de caché utilizada comúnmente en una llamada al método:

                  -
                  $response->setCache(array(
-    'etag'          => 'abcdef',
-    'last_modified' => new \DateTime(),
-    'max_age'       => 600,
-    's_maxage'      => 600,
-    'private'       => false,
-    'public'        => true,
-));
-
                  -
                  -

                  Para comprobar si los validadores de la Respuesta (ETag, Last-Modified) coinciden con un valor condicional especificado en la petición del cliente, utiliza el método isNotModified():

                  -
                  if ($response->isNotModified($request)) {
-    $response->send();
-}
-
                  -
                  -

                  Si la respuesta no se ha modificado, se establece el código de estado a 304 y elimina el contenido real de la respuesta.

                  -
                  -
                  -

                  Redirigiendo al usuario

                  -

                  Para redirigir al cliente a otra URL, puedes utilizar la clase Symfony\Component\HttpFoundation\RedirectResponse:

                  -
                  use Symfony\Component\HttpFoundation\RedirectResponse;
-
-$response = new RedirectResponse('http://ejemplo.com/');
-
                  -
                  -
                  -
                  -

                  Transmitiendo una Respuesta

                  -

                  -Nuevo en la versión 2.1: La compatibilidad a la transmisión de respuestas se añadió en Symfony 2.1.

                  -

                  La clase Symfony\Component\HttpFoundation\StreamedResponse te permite transmitir la respuesta de vuelta al cliente. El contenido de la respuesta está representado por una función PHP ejecutable en lugar de una cadena:

                  -
                  use Symfony\Component\HttpFoundation\StreamedResponse;
-
-$response = new StreamedResponse();
-$response->setCallback(function () {
-    echo 'Hello World';
-    flush();
-    sleep(2);
-    echo 'Hello World';
-    flush();
-});
-$response->send();
-
                  -
                  -
                  -

                  Nota

                  -

                  The flush() function does not flush buffering. If ob_start() has -been called before or the output_buffering php.ini option is enabled, -you must call ob_flush() before flush().

                  -

                  Additionally, PHP isn’t the only layer that can buffer output. Your web -server might also buffer based on its configuration. Even more, if you -use fastcgi, buffering can’t be disabled at all.

                  -
                  -
                  -
                  -

                  Serving Files

                  -

                  -Nuevo en la versión 2.1: El método makeDisposition fue añadido en Symfony 2.1.

                  -

                  When sending a file, you must add a Content-Disposition header to your -response. Es fácil crear esta cabecera básica para descargar archivos, utilizando nombres de archivo -no ASCII más envolventes. El método makeDisposition() abstrae el trabajo pesado detrás de una sencilla API:

                  -
                  use Symfony\Component\HttpFoundation\ResponseHeaderBag;
-
-$d = $response->headers->makeDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, 'foo.pdf');
-
-$response->headers->set('Content-Disposition', $d);
-
                  -
                  -

                  -Nuevo en la versión 2.2: The Symfony\Component\HttpFoundation\BinaryFileResponse -class was added in Symfony 2.2.

                  -

                  Alternatively, if you are serving a static file, you can use a -Symfony\Component\HttpFoundation\BinaryFileResponse:

                  -
                  use Symfony\Component\HttpFoundation\BinaryFileResponse
-
-$file = 'path/to/file.txt';
-$response = new BinaryFileResponse($file);
-
                  -
                  -

                  The BinaryFileResponse will automatically handle Range and -If-Range headers from the request. It also supports X-Sendfile -(see for Nginx and Apache). To make use of it, you need to determine -whether or not the X-Sendfile-Type header should be trusted and call -trustXSendfileTypeHeader() -if it should:

                  -
                  $response::trustXSendfileTypeHeader();
-
                  -
                  -

                  You can still set the Content-Type of the sent file, or change its Content-Disposition:

                  -
                  $response->headers->set('Content-Type', 'text/plain')
-$response->setContentDisposition(ResponseHeaderBag::DISPOSITION_ATTACHMENT, 'filename.txt');
-
                  -
                  -
                  -
                  -

                  Creando una respuesta JSON

                  -

                  Puedes crear cualquier tipo de respuesta vía la clase Symfony\Component\HttpFoundation\Response poniendo las cabeceras y contenido correctos. Una respuesta JSON podría tener la siguiente apariencia:

                  -
                  use Symfony\Component\HttpFoundation\Response;
-
-$response = new Response();
-$response->setContent(json_encode(array(
-    'data' => 123,
-)));
-$response->headers->set('Content-Type', 'application/json');
-
                  -
                  -

                  -Nuevo en la versión 2.1: The Symfony\Component\HttpFoundation\JsonResponse -class was added in Symfony 2.1.

                  -

                  Además, hay una muy útil clase Symfony\Component\HttpFoundation\JsonResponse, la cual incluso, puede hacer esto mucho más fácil:

                  -
                  use Symfony\Component\HttpFoundation\JsonResponse;
-
-$response = new JsonResponse();
-$response->setData(array(
-    'data' => 123
-));
-
                  -
                  -

                  Esto codifica tu arreglo de datos a JSON y pone la cabecera Content-Type a application/json. Si estás utilizando JSONP, puedes especifiar a cual función retrollamada se tendría que pasar el dato:

                  -
                  $response->setCallback('handleResponse');
-
                  -
                  -

                  En este caso, la cabecera Content-Type será text/javascript y el -contenido de respuesta tendrá esta apariencia:

                  -
                  handleResponse({'data': 123});
-
                  -
                  -
                  -
                  -
                  -

                  Session

                  -

                  La información de la sesión está en su propio documento: Gestión de la sesión.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_foundation/session_configuration.html b/components/http_foundation/session_configuration.html deleted file mode 100644 index 02e1c7a..0000000 --- a/components/http_foundation/session_configuration.html +++ /dev/null @@ -1,274 +0,0 @@ - - - - - - - Configurando sesiones y controladores de guardado — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configurando sesiones y controladores de guardado

                  -

                  Esta sección se ocupa de cómo configurar la gestión de sesiones y ajustarla a tus necesidades específicas. Esta documentación incluye los controladores de guardado, que almacenan y recuperan datos de la sesión y configuración del comportamiento de la sesión.

                  -
                  -

                  Controladores de guardado

                  -

                  El flujo de trabajo en la sesión PHP tiene 6 posibles operaciones que pueden ocurrir. El flujo de sesión normal sigue el proceso de apertura, lectura, escritura y cierre, con la posibilidad de destrucción y gc (por garbage collection o recolección de basura, la cual cerrará todas las sesiones abiertas: la gc se invoca aleatoriamente de acuerdo a la configuración de PHP y si es llamada directamente, su invocación se difiere hasta después de una operación de apertura). Puedes leer más sobre esto en php.net/session.customhandler

                  -
                  -

                  Controladores de guardado nativos de PHP

                  -

                  Los llamados controladores ‘nativos’, son controladores de guardado que son o bien compilados en PHP o proporcionados por extensiones PHP, como PHP SQLite, PHP-Memcached, etc.

                  -

                  Todos los controladores de guardado nativos son internos a PHP y como tal, no tienen enfrente API pública. -Ellos deben estar configurados en las directivas ini de PHP, por lo general session.save_path y potencialmente otros controladores específicos para la directiva. Puedes encontrar los detalles específicos en el bloque de documentación del método setOptions() de cada clase.

                  -

                  Mientras los controladores de guardado nativos se pueden activar utilizando directamente ini_set('session.save_handler', $nombre);, Symfony2 proporciona una manera conveniente de activar estos en la misma forma que los controladores personalizados.

                  -

                  Symfony2 proporciona controladores para el siguiente controlador de guardado nativo, por ejemplo:

                  -
                  -
                    -
                  • Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeFileSessionHandler;
                    • -
                  -
                  -

                  Ejemplo de uso:

                  -
                  use Symfony\Component\HttpFoundation\Session\Session;
-use Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage;
-use Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeFileSessionHandler;
-
-$storage = new NativeSessionStorage(array(), new NativeFileSessionHandler());
-$session = new Session($storage);
-
                  -
                  -
                  -

                  Nota

                  -

                  Salvo el controlador files que está integrado en PHP y siempre disponible, la disponibilidad de los otros controladores depende de las extensiones de PHP activas en tiempo de ejecución.

                  -
                  -
                  -

                  Nota

                  -

                  Los controladores de guardado nativos proporcionan una rápida solución de almacenamiento de sesión, sin embargo, en sistemas complejos donde se necesita más control, los controladores de guardado personalizados pueden proporcionar más libertad y flexibilidad. -Symfony2 proporciona varias implementaciones que se pueden personalizar aún más según sea necesario.

                  -
                  -
                  -
                  -

                  Controladores de guardado personalizados

                  -

                  Los controladores personalizados son aquellos que sustituyen por completo a los controladores de guardado de sesión integrados en PHP, proveyendo seis funciones retrollamadas que PHP invoca internamente en varios puntos en el flujo de trabajo de la sesión.

                  -

                  HttpFoundation de Symfony2, por omisión, ofrece algunos de estos y fácilmente te pueden servir como -ejemplos, si quieres escribir uno propio.

                  -
                  -
                    -
                  • Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler
                    • -
                  • Symfony\Component\HttpFoundation\Session\Storage\Handler\MemcacheSessionHandler
                    • -
                  • Symfony\Component\HttpFoundation\Session\Storage\Handler\MemcachedSessionHandler
                    • -
                  • Symfony\Component\HttpFoundation\Session\Storage\Handler\MongoDbSessionHandler
                    • -
                  • Symfony\Component\HttpFoundation\Session\Storage\Handler\NullSessionHandler
                    • -
                  -
                  -

                  Ejemplo de uso:

                  -
                  use Symfony\Component\HttpFoundation\Session\Session;
-use Symfony\Component\HttpFoundation\Session\Storage\SessionStorage;
-use Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler;
-
-$storage = new NativeSessionStorage(array(), new PdoSessionHandler());
-$session = new Session($storage);
-
                  -
                  -
                  -
                  -
                  -

                  Configurando sesiones PHP

                  -

                  La clase Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage puede ajustar la mayoría de las directivas de configuración de PHP, las cuales están documentadas en php.net/session.configuration.

                  -

                  Para configurar estas opciones, pasa las claves (omitiendo la primera parte session. de la clave) como un arreglo de clave/valor como el argumento $options del constructor. -O ajústalas a través del método setOptions().

                  -

                  En aras de la claridad, algunas de las opciones principales se explican en esta documentación.

                  -
                  - -
                  -

                  Configurando la recolección de basura

                  -

                  Cuando se abre una sesión, PHP llama aleatoriamente al controlador gc de acuerdo a la probabilidad establecida por session.gc_probability / session.gc_divisor. Por ejemplo, si éstos se establecieron en 5/100, respectivamente, significaría una probabilidad del 5%. Del mismo modo, 3/4 significaría invocarlo en 3 de cada 4 oportunidades, es decir, un 75%.

                  -

                  Si se invoca el controlador de recolección de basura, PHP pasará el valor almacenado en la directiva ini session.gc_maxlifetime de PHP. El significado en este contexto es que se debería suprimir cualquier sesión almacenada que se guardó por más de maxlifetime. Esto le permite a uno expirar los registros basándose en el tiempo de inactividad.

                  -

                  Puedes configurar estas opciones pasando gc_probability, gc_divisor y gc_maxlifetime en un arreglo al constructor de Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage o al método setOptions()().

                  -
                  -
                  -

                  Tiempo de vida de la sesión

                  -

                  Cuando se crea una nueva sesión, significa que Symfony2 emite una nueva cookie de sesión para el cliente, la cookie será sellada con un tiempo de caducidad. Este se calcula sumando el valor de configuración de session.cookie_lifetime en PHP con la hora actual del servidor.

                  -
                  -

                  Nota

                  -

                  PHP sólo emitirá una cookie una vez. Se espera que el cliente guarde esa cookie toda la vida. Sólo se otorgará una nueva cookie cuando la sesión sea destruida, se elimine la cookie en el navegador, o se vuelva a regenerar el identificador de sesión usando los métodos migrate() o invalidate() de la clase Session.

                  -

                  La duración inicial de la cookie se puede establecer configurando NativeSessionStorage utilizando el método setOptions(array('cookie_lifetime' => 1234)).

                  -
                  -
                  -

                  Nota

                  -

                  Una galeta con una vida útil de 0 significa que la galleta expira al cerrar el navegador.

                  -
                  -
                  -
                  -

                  Tiempo de inactividad/Mantener viva la sesión

                  -

                  A menudo hay circunstancias en las que posiblemente quieras proteger, o reducir al mínimo el uso no autorizado de una sesión cuando un usuario se aleja de su terminal mientras está conectado destruyendo la sesión después de cierto periodo de tiempo de inactividad. Por ejemplo, es común que las aplicaciones de banca cierren la sesión después de sólo 5 a 10 minutos de inactividad. Ajustar la duración de la cookie aquí no es apropiado debido a que el cliente la puede manipular, por lo que debemos hacer la expiración de lado del servidor. La forma más fácil es implementarla a través de la recolección de basura la cual se ejecuta con razonable frecuencia. El lifetime de la cookie se establece a un valor relativamente alto, y la recolección de basura maxlifetime se establecería para destruir sesiones en cualquiera que sea el periodo de inactividad deseado.

                  -

                  La otra opción es comprobar específicamente si una sesión ha caducado después de haber iniciado la sesión. La sesión se puede destruir si es necesario. Este método de procesamiento puede permitir la integración de la expiración de sesiones en la experiencia del usuario, por ejemplo, visualizando un mensaje.

                  -

                  Symfony2 registra algunos metadatos básicos acerca de cada sesión para darte completa libertad en este ámbito.

                  -
                  -
                  -

                  Metadatos de sesión

                  -

                  Las sesiones están decoradas con un poco de metadatos básicos para permitirte un control preciso sobre la configuración de seguridad. El objeto Sesión tiene un captador de metadatos, getMetadataBag() que -expone una instancia de Symfony\Component\HttpFoundation\Session\Storage\MetadataBag:

                  -
                  $session->getMetadataBag()->getCreated();
-$session->getMetadataBag()->getLastUsed();
-
                  -
                  -

                  Ambos métodos devuelven una marca de tiempo Unix (relativa al servidor).

                  -

                  Puedes utilizar estos metadatos para expirar la sesión explícitamente en el acceso, por ejemplo:

                  -
                  $session->start();
-if (time() - $session->getMetadataBag()->getLastUsed() > $maxIdleTime) {
-    $session->invalidate();
-    throw new SessionExpired(); // redirige a la página de sesión expirada
-}
-
                  -
                  -

                  También es posible decir cuál es el cookie_lifetime establecido en una cookie en particular leyendo el método getLifetime():

                  -
                  $session->getMetadataBag()->getLifetime();
-
                  -
                  -

                  Puedes determinar el tiempo de caducidad de la cookie sumando la fecha y hora de creación y el lifetime.

                  -
                  -
                  -

                  Compatibilidad con PHP 5.4

                  -

                  A partir de PHP 5.4.0, están disponibles SessionHandler y SessionHandlerInterface. Symfony 2.1 proporciona compatibilidad para SessionHandlerInterface por lo tanto la puedes utilizar en PHP 5.3. Esto, gratamente mejora la interoperabilidad con otras bibliotecas.

                  -

                  SessionHandler es una clase interna especial de PHP que expone los controladores de guardado nativos para el espacio de usuario de PHP.

                  -

                  Con el fin de proporcionar una solución para aquellos que utilizan PHP 5.4, Symfony2 tiene una clase especial llamada Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeSessionHandler que bajo PHP 5.4, se extiende desde SessionHandler y bajo PHP 5.3 es sólo una clase base vacía. Esto proporciona interesantes oportunidades para aprovechar la funcionalidad de PHP 5.4 si está disponible.

                  -
                  -
                  -

                  Controladores delegados de guardado

                  -

                  Hay dos tipos de controladores delegados de clases de guardado que heredan de Symfony\Component\HttpFoundation\Session\Storage\Handler\AbstractProxy: -estas son Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeProxy y Symfony\Component\HttpFoundation\Session\Storage\Handler\SessionHandlerProxy.

                  -

                  La Symfony\Component\HttpFoundation\Session\Storage\NativeSessionStorage automáticamente inyecta los controladores de guardado en un controlador de guardado delegado, a menos que ya lo envuelva uno.

                  -

                  La clase Symfony\Component\HttpFoundation\Session\Storage\Handler\NativeProxy se utiliza automáticamente en PHP 5.3, cuando los controladores de guardado internos de PHP se especifican usando las clases Native*SessionHandler, mientras que la clase Symfony\Component\HttpFoundation\Session\Storage\Handler\SessionHandlerProxy se utiliza para envolver cualquier controlador de guardado personalizado, esta implementa la SessionHandlerInterface.

                  -

                  En PHP 5.4 y superior, todos los controladores de sesión implementan la SessionHandlerInterface incluyendo las clases Native*SessionHandler que heredan de SessionHandler.

                  -

                  El mecanismo delegado te permite involucrarte profundamente en las clases controladoras de guardado de sesión. Podrías utilizar un delegado, por ejemplo, para cifrar cualquier transacción de la sesión sin el conocimiento específico del controlador de guardado.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_foundation/session_testing.html b/components/http_foundation/session_testing.html deleted file mode 100644 index 4445902..0000000 --- a/components/http_foundation/session_testing.html +++ /dev/null @@ -1,163 +0,0 @@ - - - - - - - Probando con sesiones — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Probando con sesiones

                  -

                  Symfony2 se diseñó desde el principio con la comprobabilidad de código en mente. Con el fin de hacer que el código que utiliza la sesión sea fácilmente comprobable, disponemos de dos mecanismos de almacenamiento independientes para simular ambas, pruebas unitarias y pruebas funcionales.

                  -

                  Probar el código usando sesiones reales es difícil porque el estado del flujo de trabajo de PHP es global y no es posible tener varias sesiones simultáneas en el mismo proceso PHP.

                  -

                  Los motores de almacenamiento fingido simulan el flujo de trabajo de las sesiones PHP sin tener que iniciar una, lo cual te permite probar tu código sin complicaciones. También es posible ejecutar varias instancias en el mismo proceso PHP.

                  -

                  Los controladores de almacenamiento simulado no leen ni escriben las globales del sistema session_id() o session_name(). Y proporcionan métodos para simularlas de ser necesario:

                  -
                    -
                  • getId(): Recupera el id de la sesión.
                    • -
                  • setId(): Establece el id de la sesión.
                    • -
                  • getName(): Recupera el nombre de la sesión.
                    • -
                  • setName(): Establece el nombre de la sesión.
                    • -
                  -
                  -

                  Pruebas unitarias

                  -

                  Para las pruebas unitarias donde no es necesario persistir la sesión, simplemente debes intercambiar el motor de almacenamiento predefinido con Symfony\Component\HttpFoundation\Session\Storage\MockArraySessionStorage:

                  -
                  use Symfony\Component\HttpFoundation\Session\Storage\MockArraySessionStorage;
-use Symfony\Component\HttpFoundation\Session\Session;
-
-$session = new Session(new MockArraySessionStorage());
-
                  -
                  -
                  -
                  -

                  Probando la funcionalidad

                  -

                  Para las pruebas funcionales donde posiblemente necesites conservar los datos de sesión a través de procesos PHP independientes, basta con cambiar el motor de almacenamiento a la clase Symfony\Component\HttpFoundation\Session\Storage\MockFileSessionStorage:

                  -
                  use Symfony\Component\HttpFoundation\Session\Session;
-use Symfony\Component\HttpFoundation\Session\Storage\MockFileSessionStorage;
-
-$session = new Session(new MockFileSessionStorage());
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_foundation/sessions.html b/components/http_foundation/sessions.html deleted file mode 100644 index 60f7abd..0000000 --- a/components/http_foundation/sessions.html +++ /dev/null @@ -1,353 +0,0 @@ - - - - - - - Gestión de la sesión — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Gestión de la sesión

                  -

                  El componente HttpFoundation de Symfony2 tiene un subsistema de sesión muy potente y flexible, que está diseñado para proporcionar la gestión de sesiones a través de una sencilla interfaz orientada a objetos, utilizando una variedad de controladores para el almacenamiento de la sesión.

                  -

                  -Nuevo en la versión 2.1: La interfaz Symfony\Component\HttpFoundation\Session\SessionInterface, así como una serie de otros cambios, son nuevas a partir de Symfony 2.1.

                  -

                  Las sesiones se utilizan a través de la simple clase Symfony\Component\HttpFoundation\Session\Session que implementa la interfaz Symfony\Component\HttpFoundation\Session\SessionInterface.

                  -

                  Ejemplo rápido:

                  -
                  use Symfony\Component\HttpFoundation\Session\Session;
-
-$session = new Session();
-$session->start();
-
-// establece y obtiene atributos de sesión
-$session->set('name', 'Drak');
-$session->get('name');
-
-// configura mensajes flash
-$session->getFlashBag()->add('notice', 'Profile updated');
-
-// recupera mensajes
-foreach ($session->getFlashBag()->get('notice', array()) as $message) {
-    echo "<div class='flash-notice'>$message</div>";
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Las sesiones Symfony están diseñadas para sustituir varias funciones nativas de PHP. -Las aplicaciones deben evitar el uso de session_start(), session_regenerate_id(), `` session_id()``, session_name(), y session_destroy(), y en su lugar usar la API en la siguiente sección.

                  -
                  -
                  -

                  Nota

                  -

                  Si bien se recomienda empezar una sesión explícitamente, unas sesiones de hecho empezarán bajo demanda, es decir, si se hace alguna petición de sesión para leer/escribir dato de sesión.

                  -
                  -
                  -

                  Prudencia

                  -

                  Las sesiones de Symfony son incompatibles con la directiva ini session.auto_start = 1 de PHP. Esta directiva se debe apagar en php.ini, en las directivas del servidor web o en .htaccess.

                  -
                  -
                  -

                  API de sesión

                  -

                  La clase Symfony\Component\HttpFoundation\Session\Session implementa la interfaz Symfony\Component\HttpFoundation\Session\SessionInterface.

                  -

                  La clase Symfony\Component\HttpFoundation\Session\Session tiene una API sencilla subdividida en un par de grupos.

                  -

                  Flujo de trabajo en la sesión

                  -
                    -
                  • start(): -Inicia la sesión — no usa session_start().
                    • -
                  • migrate(): -Regenera el id de la sesión — no usa session_regenerate_id()—. -Opcionalmente, este método puede cambiar el tiempo de vida de la nueva cookie que será emitida al llamar a este método.
                    • -
                  • invalidate(): -Limpia todos los datos de la sesión y regenera el id de la sesión. No usa session_destroy().
                    • -
                  • getId(): Recupera el id de la sesión. Sin usar session_id().
                    • -
                  • setId(): Establece el id de la sesión. Sin usar session_id().
                    • -
                  • getName(): Recupera el nombre de la sesión. Sin usar session_name().
                    • -
                  • setName(): Establece el nombre de la sesión. Sin usar session_name().
                    • -
                  -

                  Atributos de la sesión

                  -
                    -
                  • set(): -Establece un atributo por su clave;
                    • -
                  • get(): -Recupera un atributo por su clave;
                    • -
                  • all(): -Recupera todos los atributos como un arreglo de clave => valor;
                    • -
                  • has(): -Devuelve true si el atributo existe;
                    • -
                  • keys(): -Devuelve un arreglo de claves de atributo guardadas;
                    • -
                  • replace(): -Establece múltiples atributos simultáneamente: toma un arreglo indexado y configura cada pareja clave => valor.
                    • -
                  • remove(): -Elimina un atributo por clave;
                    • -
                  • clear(): -Limpia todos los atributos;
                    • -
                  -

                  Internamente los atributos se almacenan en una «Bag» (‘Bolsa’, en adelante), un objeto PHP que actúa como un arreglo. Unos cuantos métodos existentes para gestionar una «Bolsa»:

                  -
                    -
                  • registerBag(): -Registra una Symfony\Component\HttpFoundation\Session\SessionBagInterface
                    • -
                  • getBag(): -Consigue una Symfony\Component\HttpFoundation\Session\SessionBagInterface por medio del nombre de la «Bolsa».
                    • -
                  • getFlashBag(): -Recupera la Symfony\Component\HttpFoundation\Session\Flash\FlashBagInterface. -Esta, únicamente es un conveniente atajo.
                    • -
                  -

                  Metadatos de sesión

                  -
                    -
                  • getMetadataBag(): -Obtiene la clase Symfony\Component\HttpFoundation\Session\StorageMetadataBag la cual contiene información de la sesión.
                    • -
                  -
                  -
                  -

                  Gestionando datos de sesión

                  -

                  La gestión de sesiones PHP requiere el uso de la superglobal $_SESSION, sin embargo, esto interfiere un poco con la comprobabilidad y encapsulación de código en un paradigma de programación orientado a objetos. Para ayudar a superar esta situación, Symfony2 usa ‘bolsas de sesión’ vinculadas a la sesión para encapsular un conjunto de datos específico a los ‘atributos’ o ‘mensajes flash’.

                  -

                  Este enfoque también mitiga la contaminación del espacio de nombres dentro de la superglobal $_SESSION, porque cada bolsa almacena todos sus datos bajo un único espacio de nombres. -Esto le permite a Symfony2 coexistir pacíficamente con otras aplicaciones o bibliotecas que puedan usar la superglobal $_SESSION y todos los datos siguen siendo totalmente compatibles con la gestión de sesiones de Symfony2.

                  -

                  Symfony2 ofrece 2 tipos de bolsas para almacenamiento, con dos implementaciones independientes. -Todo está escrito contra interfaces para que las puedas ampliar o crear tus propios tipos de bolsa si es necesario.

                  -

                  Symfony\Component\HttpFoundation\Session\SessionBagInterface tiene la siguiente API destinada principalmente para uso interno:

                  -
                    -
                  • getStorageKey(): -Devuelve la clave, que en última instancia es la bolsa que va a almacenar tu arreglo bajo $_SESSION. -En general, puedes dejar este valor en su predefinido y es para uso interno.
                    • -
                  • initialize(): -Symfony2 llama internamente a este método para almacenar clases de sesión con datos para vincularlos a la bolsa de la sesión.
                    • -
                  • getName(): -Devuelve el nombre de la bolsa de sesión.
                    • -
                  -
                  -
                  -

                  Atributos

                  -

                  El propósito de la implementación de la Symfony\Component\HttpFoundation\Session\Attribute\AttributeBagInterface de bolsas, es manejar el almacenamiento de los atributos de la sesión. Esto puede incluir cosas como el id de usuario, y la funcionalidad «recuérdame» en la configuración del inicio de sesión u otra información basada en el estado del usuario.

                  -
                    -
                  • Symfony\Component\HttpFoundation\Session\Attribute\AttributeBag Esta es la implementación estándar predeterminada.
                    • -
                  • Symfony\Component\HttpFoundation\Session\Attribute\NamespacedAttributeBag Esta implementación permite que los atributos sean almacenados en un espacio de nombres estructurado.
                    • -
                  -

                  Cualquier sistema de almacenamiento sencillo clave => valor está limitado en la medida en que se puedan almacenar datos complejos, ya que cada clave debe ser única. Lo puedes lograr introduciendo una convención a la nomenclatura de los espacios de nombres para que las claves sean partes diferentes de tu aplicación lo cual podría funcionar sin colisiones. Por ejemplo, modulo1.foo y modulo2.foo. Sin embargo, a veces esto no es muy práctico cuando los datos de los atributos están en un arreglo, por ejemplo, un conjunto de iniciales. En este caso, la gestión del arreglo se convierte en una carga porque hay que recuperar el arreglo, luego, procesarlo y almacenarlo de nuevo:

                  -
                  $tokens = array('tokens' => array('a' => 'a6c1e0b6',
-                                  'b' => 'f4a7b1f3'));
-
                  -
                  -

                  Así que cualquier procesamiento de este tipo rápidamente se puede poner feo, aunque sólo añadas un elemento al arreglo:

                  -
                  $tokens = $session->get('tokens');
-$tokens['c'] = $value;
-$session->set('tokens', $tokens);
-
                  -
                  -

                  Con el espacio de nombre estructurado, la clave se puede trasladar a la estructura del arreglo tal cual usando un carácter del espacio de nombres (por omisión es /):

                  -
                  $session->set('tokens/c', $value);
-
                  -
                  -

                  De esta manera puedes acceder a una clave dentro del arreglo almacenado directa y fácilmente.

                  -

                  La Symfony\Component\HttpFoundation\Session\Attribute\AttributeBagInterface cuenta con una API sencilla

                  -
                    -
                  • set(): -Establece un atributo por su clave;
                    • -
                  • get(): -Recupera un atributo por su clave;
                    • -
                  • all(): -Recupera todos los atributos como un arreglo de clave => valor;
                    • -
                  • has(): -Devuelve true si el atributo existe;
                    • -
                  • keys(): -Devuelve un arreglo de claves de atributo guardadas;
                    • -
                  • replace(): -Establece múltiples atributos simultáneamente: toma un arreglo indexado y configura cada pareja clave => valor.
                    • -
                  • remove(): -Elimina un atributo por clave;
                    • -
                  • clear(): -Vacía la bolsa;
                    • -
                  -
                  -
                  -

                  Mensajes flash

                  -

                  El propósito de la Symfony\Component\HttpFoundation\Session\Flash\FlashBagInterface es proporcionar una forma de configurar y recuperar mensajes basándose en la sesión. -El flujo de trabajo habitual de los mensajes flash se encuentra en una Petición, y se muestran después de redirigir a una página. Por ejemplo, un usuario envía un formulario que llegará a un controlador de actualización, y después de procesar el controlador redirige al usuario o bien a la página actualizada o a una página de error. Los mensajes flash establecidos en la Petición de página anterior se muestran inmediatamente al cargar la siguiente página en esa sesión. -Esta, sin embargo, sólo es una aplicación para los mensajes flash.

                  -
                    -
                  • Symfony\Component\HttpFoundation\Session\Flash\AutoExpireFlashBag Esta implementación de mensajes se ajusta al cargar la página para que esté disponible para visualizarlo al cargar la siguiente página. Estos mensajes expirarán automáticamente independientemente de si se recuperan o no.
                    • -
                  • Symfony\Component\HttpFoundation\Session\Flash\FlashBag En esta implementación, los mensajes se mantendrán en la sesión hasta que se recuperen o borren explícitamente. Esto hace posible el uso de la caché ESI.
                    • -
                  -

                  La Symfony\Component\HttpFoundation\Session\Flash\FlashBagInterface tiene una sencilla API

                  -
                    -
                  • add(): -Añade un mensaje flash a la pila del tipo especificado;
                    • -
                  • set(): -Configura mensajes flash por tipo; Este método toma ambos, mensajes como una cadena o varios mensajes en un arreglo.
                    • -
                  • get(): -Recupera mensajes por tipo y los quita de la bolsa;
                    • -
                  • setAll(): -Establece todos los flashes, acepta un arreglo de arreglos indexado tipo => array(mensajes);
                    • -
                  • all(): -Recupera todos los mensajes flash (en forma de arreglo de arreglos indexado) y quita los mensajes de la bolsa;
                    • -
                  • peek(): -Recupera mensajes flash por tipo (sólo lectura);
                    • -
                  • peekAll(): -Recupera todos los mensajes flash (sólo lectura) como arreglo de arreglos indexado;
                    • -
                  • has(): -Devuelve true si el tipo existe, false en caso contrario;
                    • -
                  • keys(): -Devuelve un arreglo de tipos flash guardados;
                    • -
                  • clear(): -Limpia la bolsa;
                    • -
                  -

                  Para aplicaciones simples por lo general es suficiente tener un mensaje flash por tipo, por ejemplo, un aviso de confirmación después de enviar un formulario. Sin embargo, los mensajes Flash se almacenan en un arreglo indexado por el $tipo del flash, lo cual significa que tu aplicación puede emitir varios mensajes de un determinado tipo. Esto te permite utilizar la API para mensajes más complejos en tu aplicación.

                  -

                  Ejemplos de configuración de múltiples mensajes flash:

                  -
                  use Symfony\Component\HttpFoundation\Session\Session;
-
-$session = new Session();
-$session->start();
-
-// añade mensajes flash
-$session->getFlashBag()->add(
-    'warning',
-    'Your config file is writable, it should be set read-only'
-);
-$session->getFlashBag()->add('error', 'Failed to update name');
-$session->getFlashBag()->add('error', 'Another error');
-
                  -
                  -

                  Para exhibir los mensajes flash puedes usar algo como esto:

                  -

                  Simple, muestra un tipo de mensaje:

                  -
                  // muestra advertencias
-foreach ($session->getFlashBag()->get('warning', array()) as $message) {
-    echo "<div class='flash-warning'>$message</div>";
-}
-
-// muestra errores
-foreach ($session->getFlashBag()->get('error', array()) as $message) {
-    echo "<div class='flash-error'>$message</div>";
-}
-
                  -
                  -

                  Método compacto para procesar la exhibición simultánea de todos los mensajes:

                  -
                  foreach ($session->getFlashBag()->all() as $type => $messages) {
-    foreach ($messages as $message) {
-        echo "<div class='flash-$type'>$message</div>\n";
-    }
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_foundation/trusting_proxies.html b/components/http_foundation/trusting_proxies.html deleted file mode 100644 index 9658f71..0000000 --- a/components/http_foundation/trusting_proxies.html +++ /dev/null @@ -1,169 +0,0 @@ - - - - - - - Delegados confiables — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Delegados confiables

                  -

                  Si te encuentras detrás de alguna clase de delegado —tal como un balanceador de carga— entonces cierta información de las cabeceras se te puede enviar usando cabeceras X-Forwarded-* especiales. Por ejemplo, la cabecera HTTP Host normalmente se utiliza para regresar el servidor solicitado. Pero cuándo estás detrás de un delegado, el verdadero servidor se puede almacenar en una cabecera X-Forwarded-Host.

                  -

                  Debido a que las cabeceras HTTP se pueden suplantar, de manera predeterminada Symfony2 no confía en estas cabeceras de delegados. Si estás detrás de un delegado, tienes que enumerar manualmente tu delegado en una lista blanca:

                  -
                  use Symfony\Component\HttpFoundation\Request;
-
-$request = Request::createFromGlobals();
-// únicamente confía en las cabeceras de delegados que vienen
-// de esta dirección IP
-$request->setTrustedProxies(array(192.0.0.1));
-
                  -
                  -
                  -

                  Configurando nombres de cabeceras

                  -

                  De manera predeterminada, las siguientes cabeceras de delegados son confiables:

                  - -

                  Si tu delegado inverso utiliza un nombre de cabecera diferente para cualquiera de estas, puedes configurar el nombre de la cabecera a través del método setTrustedHeaderName():

                  -
                  $request->setTrustedHeaderName(Request::HEADER_CLIENT_IP, 'X-Proxy-For');
-$request->setTrustedHeaderName(Request::HEADER_CLIENT_HOST, 'X-Proxy-Host');
-$request->setTrustedHeaderName(Request::HEADER_CLIENT_PORT, 'X-Proxy-Port');
-$request->setTrustedHeaderName(Request::HEADER_CLIENT_PROTO, 'X-Proxy-Proto');
-
                  -
                  -
                  -
                  -

                  Determinadas cabeceras no confiables

                  -

                  De manera predeterminada, si pones en una lista blanca tus direcciones IP delegadas, entonces todas tus cabeceras enumeradas arriba serán confiables. Si necesitas confiar en algunas de esas cabeceras pero no en otras, también lo puedes hacer:

                  -
                  // desactiva la confianza en la cabecera ``X-Forwarded-Proto``, usa
-// la cabecera predefinida
-$request->setTrustedHeaderName(Request::HEADER_CLIENT_PROTO, '');
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_kernel/index.html b/components/http_kernel/index.html deleted file mode 100644 index 4e4c0c2..0000000 --- a/components/http_kernel/index.html +++ /dev/null @@ -1,145 +0,0 @@ - - - - - - - HTTP del núcleo — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/http_kernel/introduction.html b/components/http_kernel/introduction.html deleted file mode 100644 index d5d203f..0000000 --- a/components/http_kernel/introduction.html +++ /dev/null @@ -1,518 +0,0 @@ - - - - - - - El componente HttpKernel — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente HttpKernel

                  -
                  -
                  El componente HttpKernel proporciona un proceso estructurado para convertir una Petición en una Respuesta usando el despachador de eventos. -Es bastante flexible para crear una plataforma completa (Symfony), una microplataforma (Silex) o un sistema CMS avanzado (Drupal).
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  El flujo de trabajo de una Petición

                  -

                  Cada interacción web de HTTP empieza con una petición y termina con una respuesta. -Tu trabajo como desarrollador es crear el código PHP que lee la información de la petición -(p. ej. la URL) y crea y devuelve una respuesta (p. ej. una página HTML o una cadena JSON).

                  -../../_images/request-response-flow.png -

                  Típicamente, alguna clase de la plataforma o sistema está construida para manejar todas las tareas -repetitivas (p. ej. enrutado, seguridad, etc.) a modo de que un desarrollador pueda fácilmente construir -cada página de la aplicación. Exactamente cómo están construidos estos sistemas varía mucho. El componente HttpKernel proporciona una interfaz que formaliza el proceso de empezar con una petición y crear la respuesta apropiada. -El componente pretende ser el corazón de cualquier aplicación o plataforma, no importa qué tanto varíe la arquitectura de ese sistema:

                  -
                  namespace Symfony\Component\HttpKernel;
-
-use Symfony\Component\HttpFoundation\Request;
-
-interface HttpKernelInterface
-{
-    // ...
-
-    /**
-     * @return Response Una instancia de Response
-     */
-    public function handle(
-        Request $request,
-        $type = self::MASTER_REQUEST,
-        $catch = true
-    );
-}
-
                  -
                  -

                  Internamente, el método HttpKernel::handle() — implementa concretamente el método HttpKernelInterface::handle() — define un flujo de trabajo que inicia con una Symfony\Component\HttpFoundation\Request y termina con una Symfony\Component\HttpFoundation\Response.

                  -../../_images/01-workflow.png -

                  Los detalles exactos de este flujo de trabajo son la clave para entender cómo trabaja el núcleo (y la plataforma Symfony o cualquier otra biblioteca que use el núcleo).

                  -
                  -

                  HttpKernel: Conducido por eventos

                  -

                  El método HttpKernel::handle() internamente trabaja despachando eventos. -Esto hace al método tanto flexible, pero también un poco abstracto, debido a que todo el «trabajo» de una aplicación/plataforma construida con HttpKernel está hecha con escuchas de eventos.

                  -

                  Para ayudar a explicar este proceso, este documento mira cada paso del proceso y habla sobre cómo trabaja una implementación específica del HttpKernel —la plataforma Symfony—.

                  -

                  Inicialmente, utilizar el Symfony\Component\HttpKernel\HttpKernel es realmente sencillo, e implica crear un despachador de eventos y un resolutor de controlador (explicado más adelante). Para completar tu núcleo, añadirás más escuchas de eventos para los eventos explicados más adelante:

                  -
                  use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\HttpKernel\HttpKernel;
-use Symfony\Component\EventDispatcher\EventDispatcher;
-use Symfony\Component\HttpKernel\Controller\ControllerResolver;
-
-// crea el objeto Request
-$request = Request::createFromGlobals();
-
-$dispatcher = new EventDispatcher();
-// ... añade algunos escuchas de eventos
-
-// crea tu resolutor de  controlador
-$resolver = new ControllerResolver();
-// crea una instancia del núcleo
-$kernel = new HttpKernel($dispatcher, $resolver);
-
-// en realidad ejecuta el núcleo, el cuál convierte la petición en una respuesta
-// despachando eventos, invocando a un controlador, y devolviendo la respuesta
-$response = $kernel->handle($request);
-
-// difunde el contenido y envía las cabeceras
-$response->send();
-
-// desencadena el evento kernel.terminate
-$kernel->terminate($request, $response);
-
                  -
                  -

                  Ve «Un ejemplo completo funcionando» para más implementaciones concretas.

                  -

                  Para información general sobre cómo añadir escuchas a los siguientes eventos, ve Creando un escucha del evento.

                  -
                  -

                  Truco

                  -

                  Fabien Potencier también escribió una magnífica serie sobre la utilización del componente HttpKernel y otros componentes de Symfony2 para crear tu propia plataforma. Ve Crea tu propia plataforma... en lo alto de los componentes de Symfony2.

                  -
                  -
                  -
                  -

                  1) El evento kernel.request

                  -

                  Propósito típico: Añadir más información a la Petición, iniciar partes del sistema, o regresar una Respuesta si es posible (p. ej. una capa -de seguridad que niega el acceso).

                  -

                  Tabla de información de eventos del núcleo

                  -

                  El primer evento despachado dentro del método HttpKernel::handle es kernel.request, el cual puede tener una serie de diferentes escuchas.

                  -../../_images/02-kernel-request.png -

                  Los escuchas de este evento pueden ser bastante diversos. Algunos escuchas —tal como un escucha de seguridad— podrían tener suficiente información para crear un objeto Respuesta inmediatamente. -Por ejemplo, si un escucha de seguridad determinó que un usuario no tiene acceso, ese escucha puede regresar una Symfony\Component\HttpFoundation\RedirectResponse a la página de inicio de sesión o una respuesta 403 de «Acceso denegado».

                  -

                  Si al llegar a este punto regresa una Respuesta, el proceso salta directamente al evento kernel.response.

                  -../../_images/03-kernel-request-response.png -

                  Otros escuchas sencillamente inician cosas o añaden más información a la petición. -Por ejemplo, un escucha podría determinar y poner la región en el objeto Petición.

                  -

                  Otro escucha común es el de enrutado. Un escucha enrutador puede procesar la Petición y determinar el controlador que se debería ejecutar (ve la próxima sección). -De hecho, el objeto Petición tiene una bolsa de «atributos» misma que es un sitio perfecto para almacenar este dato extra, específico de la aplicación sobre la petición. Esto significa que si tu escucha enrutador de alguna manera determina el controlador, lo puedes almacenar en los atributos de la Petición (los cuáles puede utilizar el resolutor del controlador).

                  -

                  En general, el propósito del evento kernel.request es o bien, crear y regresar una Respuesta directamente, o añadir información a la Petición (p. ej. poniendo la región o configurando alguna otra información en los atributos de la Petición).

                  -
                  -

                  kernel.request en la plataforma Symfony

                  -

                  El escucha más importante para kernel.request en la plataforma Symfony es el Symfony\Component\HttpKernel\EventListener\RouterListener. -Esta clase ejecuta la capa de enrutado, la cual regresa un arreglo de información sobre la petición emparejada, incluyendo el _controller y cualquier marcador de posición que esté en el patrón de la ruta (p. ej. {slug}). Ve el componente Routing.

                  -

                  Este arreglo de información está almacenado en el arreglo attributes del objeto Symfony\Component\HttpFoundation\Request. Añadir la información de enrutado aquí no hace nada todavía, pero se utiliza luego al resolver el controlador.

                  -
                  -
                  -
                  -

                  2) Resolviendo el controlador

                  -

                  Suponiendo que ningún escucha del kernel.request fuera capaz de crear una Respuesta, el próximo paso en HttpKernel es determinar y preparar (es decir, resolver) el controlador. El controlador es la parte final del código de la aplicación que es responsable de crear y regresar la Respuesta para una página específica. -El único requisito es que sea una función PHP que se pueda llamar —es decir, una función o método en un objeto, o un Cierre—.

                  -

                  Pero el cómo determinar el controlador exacto para una petición es responsabilidad enteramente de tu aplicación. Este es el trabajo del «resolutor de controlador» —una clase que implementa la Symfony\Component\HttpKernel\Controller\ControllerResolverInterface y es uno de los argumentos del constructor del HttpKernel.

                  -../../_images/04-resolve-controller.png -

                  Tu trabajo es crear una clase que implemente la interfaz y rellenar sus dos métodos: getController y getArguments. De hecho, ya existe una implementación predefinida, la cual puedes utilizar directamente o estudiar para ver cómo trabaja: -Symfony\Component\HttpKernel\Controller\ControllerResolver. -Esta implementación se explica más en la barra lateral de abajo:

                  -
                  namespace Symfony\Component\HttpKernel\Controller;
-
-use Symfony\Component\HttpFoundation\Request;
-
-interface ControllerResolverInterface
-{
-    public function getController(Request $request);
-
-    public function getArguments(Request $request, $controller);
-}
-
                  -
                  -

                  Internamente, el HttpKernel::handle primero llama al método getController() en el resolutor del controlador. Este método es pasado a la Petición y es el responsable de determinar de alguna manera y regresar un ejecutable PHP (el controlador) basándose en la información de la petición.

                  -

                  El segundo método, getArguments(), será llamado después de lanzado otro evento —kernel.controller—.

                  -
                  -

                  Resolviendo el controlador en la plataforma Symfony2

                  -

                  La plataforma Symfony utiliza la clase integrada Symfony\Component\HttpKernel\Controller\ControllerResolver (de hecho, utiliza una subclase, la cual cuenta con alguna funcionalidad extra, mencionada más adelante). Esta clase aprovecha la información colocada en la propiedad attributes del objeto Petición durante el RouterListener.

                  -

                  getController

                  -

                  El ControllerResolver busca una clave _controller en la propiedad attributes del objeto Petición (recuerda que esta información típicamente se coloca en la Petición vía el RouterListener). -Esta cadena entonces es transformada a un ejecutable PHP haciendo lo siguiente:

                  -
                    -
                  1. El formato del AcmeDemoBundle:Default:index de la clave _controller se cambia a otra cadena que contiene la clase completa y nombre del método controlador siguiendo la convención utilizada en Symfony2 —p. ej. Acme\DemoBundle\Controller\DefaultController::indexAction—. Esta transformación es específica a la subclase Symfony\Bundle\FrameworkBundle\Controller\ControllerResolver utilizada por la plataforma Symfony2.
                    2. -
                  2. Se crea una nueva instancia de tu clase controlador sin argumentos del constructor.
                    3. -
                  3. Si el controlador implementa la Symfony\Component\DependencyInjection\ContainerAwareInterface, se llama a setContainer en el objeto controlador y se pasa al contenedor. Este paso también es específico de la subclase Symfony\Bundle\FrameworkBundle\Controller\ControllerResolver utilizada por la plataforma Symfony2.
                    4. -
                  -

                  También hay otras cuantas variaciones más en el proceso anterior (p. ej. si estás registrando tus controladores como servicios).

                  -
                  -
                  -
                  -
                  -

                  3) El evento kernel.controller

                  -

                  Propósito típico: Iniciar cosas o cambiar el controlador justo antes de ejecutarlo.

                  -

                  Tabla de información de eventos del núcleo

                  -

                  Después de haber determinado el controlador a ejecutar, HttpKernel::handle desencadena el evento kernel.controller. Los escuchas de este evento podrían iniciar alguna parte necesaria del sistema después de determinar ciertas cosas (p. ej. el controlador, información de enrutado) pero antes de ejecutar el controlador. Para algunos ejemplos, ve la sección Symfony2 abajo.

                  -../../_images/06-kernel-controller.png -

                  Los escuchas de este evento también pueden cambiar completamente el controlador ejecutable llamando al método FilterControllerEvent::setController en el objeto Evento pasado a los escuchas en este evento.

                  -
                  -

                  kernel.controller en la plataforma Symfony

                  -

                  Hay unos cuantos escuchas menores del evento kernel.controller en la plataforma Symfony, y muchos tratan con la recolección de datos del perfilador cuándo está habilitado.

                  -

                  Un interesante escucha proviene del SensioFrameworkExtraBundle, el cual viene empacado con la Edición estándar de Symfony. El escucha @ParamConverter es la funcionalidad que te permite pasar un objeto completo (p. ej. un objeto Post) a tu controlador en vez de un valor escalar (p. ej. un parámetro id que venía en tu ruta). El escucha —ParamConverterListener— usa la reflexión para mirar en cada uno de los argumentos del controlador e intenta utilizar diferentes métodos para convertirlos a objetos, los cuales entonces son almacenados en la propiedad attributes del objeto Petición. Lee la siguiente sección para ver por qué esto es importante.

                  -
                  -
                  -
                  -

                  4) Obteniendo los argumentos del controlador

                  -

                  Luego, HttpKernel::handle llama al método getArguments(). -Recuerda que el controlador devuelto en getController es ejecutable. -El propósito de getArguments es devolver el arreglo de argumentos que se deberían pasar a ese controlador. Exactamente cómo se hace esto es responsabilidad completamente de tu diseño, aunque el Symfony\Component\HttpKernel\Controller\ControllerResolver incorporado es un buen ejemplo.

                  -../../_images/07-controller-arguments.png -

                  Al llegar a este punto el núcleo tiene un ejecutable PHP (el controlador) y un arreglo de argumentos que se debería pasar al llamar al ejecutable.

                  -
                  -

                  Obteniendo los argumentos del controlador en la plataforma Symfony2

                  -

                  Ahora que sabes exactamente cuál es el controlador a ejecutar (normalmente un método dentro de un objeto Controlador), el ControllerResolver usa la Reflexión en el ejecutable para devolver un arreglo con los nombres de cada uno de los argumentos. -Luego, itera sobre cada uno de estos argumentos y utiliza los siguientes trucos para determinar qué valor se debería pasar a cada argumento:

                  -
                    -
                  1. Si la bolsa de atributos de la Petición contiene una clave que coincide con el nombre del argumento, utiliza ese valor. Por ejemplo, si el primer argumento para un controlador es $slug, y hay una clave slug en la bolsa de atributos de la Petición, se utiliza ese valor (y típicamente ese valor provino del RouterListener).
                    2. -
                  2. Si el argumento en el controlador cuenta con una insinuación de tipo en el objeto Symfony\Component\HttpFoundation\Request de Symfony, entonces se pasa la Petición como el valor.
                    3. -
                  -
                  -
                  -

                  5) Llamando al controlador

                  -

                  ¡El siguiente paso es sencillo! HttpKernel::handle ejecuta el controlador.

                  -../../_images/08-call-controller.png -

                  El trabajo del controlador es construir la respuesta para el recurso dado. -Esta podría ser una página HTML, una cadena JSON o cualquier otra cosa. A diferencia de todas las demás partes del proceso hasta ahora, este paso es implementado por el «desarrollador final», por cada página construida.

                  -

                  Normalmente, el controlador regresará un objeto Respuesta. Si esto es cierto, ¡entonces el trabajo del núcleo está hecho! En este caso, el próximo paso es el evento kernel.response.

                  -../../_images/09-controller-returns-response.png -

                  Pero si el controlador regresa cualquier otra cosa más alla de una Respuesta, entonces el núcleo tiene que hacer un poco más de trabajo —kernel.view (debido a que el objetivo final siempre es generar un objeto Respuesta).

                  -
                  -

                  Nota

                  -

                  Un controlador tiene que regresar algo. Si un controlador regresa null, inmediatamente se lanzará una excepción.

                  -
                  -
                  -
                  -

                  6) El evento kernel.view

                  -

                  Propósito típico: Transformar en Respuesta un valor devuelto por un controlador que no es una Respuesta.

                  -

                  Tabla de información de eventos del núcleo

                  -

                  Si el controlador no regresa un objeto Respuesta, entonces el núcleo despacha otro evento —kernel.view—. El trabajo de un escucha de este evento es utilizar el valor devuelto por el controlador (p. ej. un arreglo de datos o un objeto) para crear una Respuesta.

                  -../../_images/10-kernel-view.png -

                  Esto puede ser útil si quieres utilizar una capa para la «vista»: en vez de regresar una Respuesta desde el controlador, regresas los datos que representan la página. -Un escucha de este evento entonces podría utilizar estos datos para crear una Respuesta en el formato correcto (p. ej. HTML, json, etc.).

                  -

                  En esta etapa, si ningún escucha pone una respuesta en el evento, entonces se lanza una excepción: ya sea un controlador o uno de los escuchas de la vista siempre deben regresar una Respuesta.

                  -
                  -

                  kernel.view en la plataforma Symfony

                  -

                  No hay escucha predefinido dentro de la plataforma Symfony para el kernel.view. Sin embargo, un paquete del núcleo —SensioFrameworkExtraBundle— añade un escucha para este evento. Si tu controlador regresa un arreglo, y colocas la anotación @Template encima del controlador, entonces este escucha reproduce una plantilla, pasándo a esa plantilla el arreglo que regresó tu controlador, y crea una Respuesta con el contenido devuelto por esa plantilla.

                  -

                  Además, un popular paquete de la comunidad FOSRestBundle implementa un escucha para este evento cuyo objetivo es darte una robusta capa para la vista capaz de utilizar un solo controlador para regresar muchas respuestas con diferente content-type (p. ej. HTML, JSON, XML, etc.).

                  -
                  -
                  -
                  -

                  7) El evento kernel.response

                  -

                  Propósito típico: Modificar el objeto Respuesta justo antes de enviarlo

                  -

                  Tabla de información de eventos del núcleo

                  -

                  El objetivo final del núcleo es transformar una Petición a una Respuesta. La Respuesta se podría crear durante el evento kernel.request, regresado del controller, o regresado por uno de los escuchas del evento kernel.view.

                  -

                  Independientemente de quién creó la Respuesta, otro evento —kernel.response— es despachado inmediatamente después. Un escucha típico de este evento modificará de alguna manera el objeto Respuesta, tal como modificar cabeceras, añadir galletas, o incluso cambiando el contenido de la Respuesta él (p. ej. inyectando algún -JavaScript antes de la etiqueta </body> final de una respuesta HTML).

                  -

                  Después de despachado este evento, el objeto Respuesta final es regresado desde el método handle(). En el caso de uso más típico, entonces puedes llamar al método send(), el cual envía las cabeceras e imprime el contenido de la Respuesta.

                  -
                  -

                  kernel.response en la plataforma Symfony

                  -

                  Hay varios escuchas menores de este evento dentro de la plataforma Symfony, y la mayoría modifica la respuesta en alguna manera. Por ejemplo, el Symfony\Bundle\WebProfilerBundle\EventListener\WebDebugToolbarListener inyecta algún JavaScript en el fondo de tu página en el entorno dev lo cual provoca que la barra de depuración web sea mostrada. Otro escucha, Symfony\Component\Security\Http\Firewall\ContextListener serializa la información del usuario actual en la sesión a modo de que se pueda recargar en la próxima petición.

                  -
                  -
                  -
                  -

                  8) El evento kernel.terminate

                  -

                  -Nuevo en la versión 2.1: El evento kernel.terminate es nuevo en Symfony 2.1.

                  -

                  Propósito típico: Realizar alguna acción «pesada» después de transmitir la respuesta al usuario.

                  -

                  Tabla de información de eventos del núcleo

                  -

                  The final event of the HttpKernel process is kernel.terminate and is unique -because it occurs after the HttpKernel::handle method, and after the -response is sent to the user. Recuerda de arriba, entonces que el código que usa el núcleo, acaba así:

                  -
                  // difunde el contenido y envía las cabeceras
-$response->send();
-
-// desencadena el evento kernel.terminate
-$kernel->terminate($request, $response);
-
                  -
                  -

                  Como puedes ver, al llamar al $kernel->terminate después de enviar la respuesta, desencadenas el evento kernel.terminate donde puedes llevar a cabo determinadas acciones que puediste haber diferido para regresar la respuesta al cliente tan rápidamente como fuera posible (p. ej. el envío de correo electrónico).

                  -
                  -

                  Nota

                  -

                  Usar el evento kernel.terminate es opcional, y sólo lo deberías llamar si tu núcleo implementa la Symfony\Component\HttpKernel\TerminableInterface.

                  -
                  -
                  -

                  kernel.terminate en la plataforma Symfony

                  -

                  Si utilizas el SwiftmailerBundle con Symfony2 y usas operaciones simultánea en memoria, entonces la clase Symfony\Bundle\SwiftmailerBundle\EventListener\EmailSenderListener es activada, la cual de hecho entrega cualquier correo electrónico que tengas planificado enviar durante la petición.

                  -
                  -
                  -
                  -

                  Manejando excepciones: el evento kernel.exception

                  -

                  Propósito típico: Manejar algún tipo de excepción y crear una Respuesta apropiada para que la regrese la excepción.

                  -

                  Tabla de información de eventos del núcleo

                  -

                  Si se desencadena una excepción en cualquier punto dentro del HttpKernel::handle, se lanza otro evento —kernel.exception—. Internamente, el cuerpo de la función handle está envuelto en un bloque prueba-captura. Al lanzar cualquier excepción, el kernel.exception es lanzado a modo de que tu sistema pueda responder de alguna manera a la excepción.

                  -../../_images/11-kernel-exception.png -

                  Cada escucha de este evento se pasa a un objeto Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent, el cual puedes utilizar para acceder a la excepción original vía el método getException(). Un escucha típico de este evento comprobará algún determinado tipo de excepción y creará una Respuesta de error apropiada.

                  -

                  Por ejemplo, para generar una página 404, podrías lanzar un tipo de excepción especial y luego añadir un escucha para este evento que busque esta excepción y genere y regrese una Respuesta 404. De hecho, el componente HttpKernel viene con un Symfony\Component\HttpKernel\EventListener\ExceptionListener, el cual si eliges usarlo, de manera predeterminada hará esto y más (ve la barra lateral abajo para más detalles).

                  -
                  -

                  kernel.exception en la plataforma Symfony

                  -

                  Al utilizar la plataforma Symfony hay dos escuchas principales del kernel.exception.

                  -

                  ExceptionListener en HttpKernel

                  -

                  El primero viene desde el núcleo del componente HttpKernel y se llama Symfony\Component\HttpKernel\EventListener\ExceptionListener. -El escucha tiene varios objetivos:

                  -
                    -
                  1. Al lanzar una excepción esta es convertida a un objeto Symfony\Component\HttpKernel\Exception\FlattenException, la cual contiene toda la información sobre la petición, pero esta se puede imprimir y serializar.
                    2. -
                  2. Si la excepción original implementa la Symfony\Component\HttpKernel\Exception\HttpExceptionInterface, entonces getStatusCode y getHeaders son invocados en la excepción y utilizados para poblar las cabeceras y código de estado del objeto FlattenException. La idea es que estos se utilicen en el siguiente paso al crear la respuesta final.
                    3. -
                  -

                  3) Un controlador es ejecutado y pasado a la excepción aplanada. El controlador exacto a ejecutar se pasa como argumento del constructor de este escucha. -Este controlador regresará la Respuesta final para esta página de error.

                  -

                  ExceptionListener en Security

                  -

                  El otro escucha importante es Symfony\Component\Security\Http\Firewall\ExceptionListener. -El objetivo de este escucha es manejar excepciones de seguridad y, cuándo sea apropiado, ayudar a autentificar al usuario (p. ej. redirigiéndolo a la página de inicio de sesión).

                  -
                  -
                  -
                  -
                  -

                  Creando un escucha del evento

                  -

                  Como has visto, puedes crear y suscribir escuchas de evento a cualquiera de los eventos despachados durante el ciclo del HttpKernel::handle. Típicamente un escucha es una clase PHP con un método retrollamado, pero puede ser cualquier cosa. Para más información sobre la creación y suscripción de escuchas de evento, ve El componente despachador de eventos.

                  -

                  El nombre de cada uno de los eventos del «núcleo» está definido como constante en la clase Symfony\Component\HttpKernel\KernelEvents Además, a cada escucha de evento se le pasa un único argumento, el cual es alguna subclase de Symfony\Component\HttpKernel\Event\KernelEvent. -Este objeto contiene información sobre el estado actual del sistema y cada evento tiene su propio objeto Evento:

                  - ----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  NombreConstante KernelEventsArgumento pasado al escucha
                  kernel.requestKernelEvents::REQUESTSymfony\Component\HttpKernel\Event\GetResponseEvent
                  kernel.controllerKernelEvents::CONTROLLERSymfony\Component\HttpKernel\Event\FilterControllerEvent
                  kernel.viewKernelEvents::VIEWSymfony\Component\HttpKernel\Event\GetResponseForControllerResultEvent
                  kernel.responseKernelEvents::RESPONSESymfony\Component\HttpKernel\Event\FilterResponseEvent
                  kernel.terminateKernelEvents::TERMINATESymfony\Component\HttpKernel\Event\PostResponseEvent
                  kernel.exceptionKernelEvents::EXCEPTIONSymfony\Component\HttpKernel\Event\GetResponseForExceptionEvent
                  -
                  -
                  -

                  Un ejemplo completo funcionando

                  -

                  Cuándo utilizas el componente HttpKernel, eres libre de asociar cualquier escucha a los eventos del núcleo y utilizar cualquier resolutor de controlador que implemente la Symfony\Component\HttpKernel\Controller\ControllerResolverInterface. -No obstante, el componente HttpKernel viene con algunos escuchas incorporados y un ControllerResolver que puedes usar para crear un ejemplo que funcione:

                  -
                  use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\HttpFoundation\Response;
-use Symfony\Component\HttpKernel\HttpKernel;
-use Symfony\Component\EventDispatcher\EventDispatcher;
-use Symfony\Component\HttpKernel\Controller\ControllerResolver;
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-use Symfony\Component\Routing\Matcher\UrlMatcher;
-use Symfony\Component\Routing\RequestContext;
-
-$routes = new RouteCollection();
-$routes->add('hello', new Route('/hello/{name}', array(
-        '_controller' => function (Request $request) {
-            return new Response(sprintf("Hello %s", $request->get('name')));
-        }
-    ),
-));
-
-$request = Request::createFromGlobals();
-
-$matcher = new UrlMatcher($routes, new RequestContext());
-
-$dispatcher = new EventDispatcher();
-$dispatcher->addSubscriber(new RouterListener($matcher));
-
-$resolver = new ControllerResolver();
-$kernel = new HttpKernel($dispatcher, $resolver);
-
-$response = $kernel->handle($request);
-$response->send();
-
-$kernel->terminate($request, $response);
-
                  -
                  -
                  -
                  -

                  Subpeticiones

                  -

                  Además de la petición «principal» enviada al HttpKernel::handle, también puedes enviar las así llamadas «subpeticiones». Una subpetición se ve y actúa como cualquier otra petición, pero típicamente sirve para reproducir sólo una pequeña porción de una -página en vez de una página completa. Generalmente haces subpeticiones desde tu controlador (o quizás desde dentro de una plantilla, aquella que está reproduciendo tu controlador).

                  -../../_images/sub-request.png -

                  Para ejecutar una subpetición, usa el HttpKernel::handle, pero cambia el segundo argumento de la siguiente manera:

                  -
                  use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\HttpKernel\HttpKernelInterface;
-
-// ...
-
-// crea alguna otra petición manualmente como se necesaria
-$request = new Request();
-// por ejemplo, posiblemente definas este _controller manualmente
-$request->attributes->add('_controller', '...');
-
-$response = $kernel->handle($request, HttpKernelInterface::SUB_REQUEST);
-// hace algo con esta respuesta
-
                  -
                  -

                  Esto crea otro ciclo petición-respuesta completo donde esta nueva Petición es transformada en una Respuesta. La única diferencia es que internamente algunos escuchas (p. ej. seguridad) sólo pueden actuar en la petición maestra. A cada escucha se le pasa alguna subclase de Symfony\Component\HttpKernel\Event\KernelEvent, dónde puedes usar el método getRequestType() para determinar si la petición actual es la «maestra» o una «subpetición».

                  -

                  Por ejemplo, un escucha que únicamente debe actuar en la petición maestra puede tener esta apariencia:

                  -
                  use Symfony\Component\HttpKernel\HttpKernelInterface;
-// ...
-
-public function onKernelRequest(GetResponseEvent $event)
-{
-    if (HttpKernelInterface::MASTER_REQUEST !== $event->getRequestType()) {
-        return;
-    }
-
-    // ...
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/index.html b/components/index.html deleted file mode 100644 index 23d337c..0000000 --- a/components/index.html +++ /dev/null @@ -1,249 +0,0 @@ - - - - - - - Componentes — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Componentes

                  -
                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/locale.html b/components/locale.html deleted file mode 100644 index 6cb9f1a..0000000 --- a/components/locale.html +++ /dev/null @@ -1,191 +0,0 @@ - - - - - - - El componente Locale — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Locale

                  -
                  -
                  El componente Locale proporciona el código de reserva para manejar aquellos casos en que falta la extensión intl. -Además esta extiende la implementación de una clase Locale nativa con varios métodos útiles.
                  -

                  Proveyendo el reemplazo de las siguientes funciones y clases:

                  - -
                  -

                  Nota

                  -

                  La implementación únicamente es compatible con la región “en”.

                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  Aprovechar el código de reserva incluye requerir funciones cooperantes y añadir clase cooperantes al cargador automático.

                  -

                  Cuando se utiliza el componente ClassLoader el siguiente código es suficiente para complementar la extensión intl faltante:

                  -
                  if (!function_exists('intl_get_error_code')) {
-    require __DIR__.'/ruta/a/src/Symfony/Component/Locale/Resources/stubs/functions.php';
-
-    $loader->registerPrefixFallbacks(
-        array(__DIR__.'/ruta/a/src/Symfony/Component/Locale/Resources/stubs')
-    );
-}
-
                  -
                  -

                  Symfony\Component\Locale\Locale enriquece a la clase nativa Locale con características adicionales:

                  -
                  use Symfony\Component\Locale\Locale;
-
-// Obtiene los nombres de países para una región u obtiene todos los códigos de país
-$countries = Locale::getDisplayCountries('pl');
-$countryCodes = Locale::getCountries();
-
-// Obtiene los nombres de idiomas para una región u obtiene todos los códigos de idioma
-$languages = Locale::getDisplayLanguages('fr');
-$languageCodes = Locale::getLanguages();
-
-// Obtiene los nombres de configuración regional para un determinado código
-// u obtiene todos los códigos de región
-$locales = Locale::getDisplayLocales('en');
-$localeCodes = Locale::getLocales();
-
-// Obtiene versiones ICU
-$icuVersion = Locale::getIntlIcuVersion();
-$icuDataVersion = Locale::getIcuDataVersion();
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/options_resolver.html b/components/options_resolver.html deleted file mode 100644 index c1840d2..0000000 --- a/components/options_resolver.html +++ /dev/null @@ -1,414 +0,0 @@ - - - - - - - The OptionsResolver Component — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  The OptionsResolver Component

                  -
                  -
                  The OptionsResolver Component helps you configure objects with option -arrays. It supports default values, option constraints and lazy options.
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  Imagine you have a Person class which has 2 options: firstName and -lastName. These options are going to be handled by the OptionsResolver -Component.

                  -

                  First, create the Person class:

                  -
                  class Person
-{
-    protected $options;
-
-    public function __construct(array $options = array())
-    {
-    }
-}
-
                  -
                  -

                  You could of course set the $options value directly on the property. Instead, -use the Symfony\Component\OptionsResolver\OptionsResolver class -and let it resolve the options by calling -resolve(). -The advantages of doing this will become more obvious as you continue:

                  -
                  use Symfony\Component\OptionsResolver\OptionsResolver;
-
-// ...
-public function __construct(array $options = array())
-{
-    $resolver = new OptionsResolver();
-
-    $this->options = $resolver->resolve($options);
-}
-
                  -
                  -

                  The $options property is an instance of -Symfony\Component\OptionsResolver\Options, which implements -ArrayAccess, Iterator and Countable. That -means you can handle it just like a normal array:

                  -
                  // ...
-public function getFirstName()
-{
-    return $this->options['firstName'];
-}
-
-public function getFullName()
-{
-    $name = $this->options['firstName'];
-
-    if (isset($this->options['lastName'])) {
-        $name .= ' '.$this->options['lastName'];
-    }
-
-    return $name;
-}
-
                  -
                  -

                  Now, try to actually use the class:

                  -
                  $person = new Person(array(
-    'firstName' => 'Wouter',
-    'lastName'  => 'de Jong',
-));
-
-echo $person->getFirstName();
-
                  -
                  -

                  Right now, you’ll receive a -Symfony\Component\OptionsResolver\Exception\InvalidOptionsException, -which tells you that the options firstName and lastName do not exist. -This is because you need to configure the OptionsResolver first, so it -knows which options should be resolved.

                  -
                  -

                  Truco

                  -

                  To check if an option exists, you can use the -isKnown() -function.

                  -
                  -

                  A best practice is to put the configuration in a method (e.g. -setDefaultOptions). You call this method in the constructor to configure -the OptionsResolver class:

                  -
                  use Symfony\Component\OptionsResolver\OptionsResolver;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class Person
-{
-    protected $options;
-
-    public function __construct(array $options = array())
-    {
-        $resolver = new OptionsResolver();
-        $this->setDefaultOptions($resolver);
-
-        $this->options = $resolver->resolve($options);
-    }
-
-    protected function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        // ... configure the resolver, you will learn this in the sections below
-    }
-}
-
                  -
                  -
                  -
                  -

                  Required Options

                  -

                  Suppose the firstName option is required: the class can’t work without -it. You can set the required options by calling -setRequired():

                  -
                  // ...
-protected function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    $resolver->setRequired(array('firstName'));
-}
-
                  -
                  -

                  You are now able to use the class without errors:

                  -
                  $person = new Person(array(
-    'firstName' => 'Wouter',
-));
-
-echo $person->getFirstName(); // 'Wouter'
-
                  -
                  -

                  If you don’t pass a required option, a -Symfony\Component\OptionsResolver\Exception\MissingOptionsException -will be thrown.

                  -

                  To determine if an option is required, you can use the -isRequired() -method.

                  -
                  -
                  -

                  Optional Options

                  -

                  Sometimes, an option can be optional (e.g. the lastName option in the -Person class). You can configure these options by calling -setOptional():

                  -
                  // ...
-protected function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    // ...
-
-    $resolver->setOptional(array('lastName'));
-}
-
                  -
                  -
                  -
                  -

                  Set Default Values

                  -

                  Most of the optional options have a default value. You can configure these -options by calling -setDefaults():

                  -
                  // ...
-protected function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    // ...
-
-    $resolver->setDefaults(array(
-        'age' => 0,
-    ));
-}
-
                  -
                  -

                  The default age will be 0 now. When the user specifies an age, it gets -replaced. You don’t need to configure age as an optional option. The -OptionsResolver already knows that options with a default value are -optional.

                  -

                  The OptionsResolver component also has an -replaceDefaults() -method. This can be used to override the previous default value. The closure -that is passed has 2 parameters:

                  -
                    -
                  • $options (an Symfony\Component\OptionsResolver\Options -instance), with all the default options
                    • -
                  • $value, the previous set default value
                    • -
                  -
                  -

                  Default Values that depend on another Option

                  -

                  Suppose you add a gender option to the Person class, whose default -value you guess based on the first name. You can do that easily by using a -Closure as the default value:

                  -
                  use Symfony\Component\OptionsResolver\Options;
-
-// ...
-protected function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    // ...
-
-    $resolver->setDefaults(array(
-        'gender' => function (Options $options) {
-            if (GenderGuesser::isMale($options['firstName'])) {
-                return 'male';
-            }
-
-            return 'female';
-        },
-    ));
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  The first argument of the Closure must be typehinted as Options, -otherwise it is considered as the value.

                  -
                  -
                  -
                  -
                  -

                  Configure allowed Values

                  -

                  Not all values are valid values for options. For instance, the gender -option can only be female or male. You can configure these allowed -values by calling -setAllowedValues():

                  -
                  // ...
-protected function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    // ...
-
-    $resolver->setAllowedValues(array(
-        'gender' => array('male', 'female'),
-    ));
-}
-
                  -
                  -

                  There is also an -addAllowedValues() -method, which you can use if you want to add an allowed value to the previous -set allowed values.

                  -
                  -

                  Configure allowed Types

                  -

                  You can also specify allowed types. For instance, the firstName option can -be anything, but it must be a string. You can configure these types by calling -setAllowedTypes():

                  -
                  // ...
-protected function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    // ...
-
-    $resolver->setAllowedTypes(array(
-        'firstName' => 'string',
-    ));
-}
-
                  -
                  -

                  Possible types are the one associated with the is_* php functions or a -class name. You can also pass an array of types as the value. For instance, -array('null', 'string') allows firstName to be null or a -string.

                  -

                  There is also an -addAllowedTypes() -method, which you can use to add an allowed type to the previous allowed types.

                  -
                  -
                  -
                  -

                  Normalize the Options

                  -

                  Some values need to be normalized before you can use them. For instance, the -firstName should always start with an uppercase letter. To do that, you can -write normalizers. These Closures will be executed after all options are -passed and return the normalized value. You can configure these normalizers by -calling -setNormalizers():

                  -
                  // ...
-protected function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    // ...
-
-    $resolver->setNormalizers(array(
-        'firstName' => function (Options $options, $value) {
-            return ucfirst($value);
-        },
-    ));
-}
-
                  -
                  -

                  You see that the closure also get an $options parameter. Sometimes, you -need to use the other options for normalizing.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/process.html b/components/process.html deleted file mode 100644 index d8f02b7..0000000 --- a/components/process.html +++ /dev/null @@ -1,259 +0,0 @@ - - - - - - - El componente Process — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Process

                  -
                  -
                  El componente Process ejecuta ordenes en subprocesos.
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  La clase Symfony\Component\Process\Process te permite ejecutar una orden en un subproceso:

                  -
                  use Symfony\Component\Process\Process;
-
-$process = new Process('ls -lsa');
-$process->run();
-
-// executes after the command finishes
-if (!$process->isSuccessful()) {
-    throw new \RuntimeException($process->getErrorOutput());
-}
-
-print $process->getOutput();
-
                  -
                  -

                  The component takes care of the subtle differences between the different platforms -when executing the command.

                  -

                  -Nuevo en la versión 2.2: Los métodos getIncrementalOutput() y getIncrementalErrorOutput() fueron añadidos en Symfony 2.2.

                  -

                  El método getOutput() siempre regresa el contenido entero de la salida estándar de la orden y getErrorOutput() el contenido de la salida de error. Alternativamente, los métodos getIncrementalOutput() -y getIncrementalErrorOutput() regresan la nueva producción desde la última llamada.

                  -

                  Cuando se ejecuta una orden que consume demasiado tiempo (tal como la resincronización de archivos con un servidor remoto), puedes retroalimentar en tiempo real al usuario final suministrando una función anónima al método run():

                  -
                  use Symfony\Component\Process\Process;
-
-$process = new Process('ls -lsa');
-$process->run(function ($type, $buffer) {
-    if ('err' === $type) {
-        echo 'ERR > '.$buffer;
-    } else {
-        echo 'OUT > '.$buffer;
-    }
-});
-
                  -
                  -

                  -Nuevo en la versión 2.1: The non-blocking feature was added in 2.1.

                  -

                  You can also start the subprocess and then let it run asynchronously, retrieving -output and the status in your main process whenever you need it. Use the -start() method to start an asynchronous -process, the isRunning() method -to check if the process is done and the -getOutput() method to get the output:

                  -
                  $process = new Process('ls -lsa');
-$process->start();
-
-while ($process->isRunning()) {
-    // waiting for process to finish
-}
-
-echo $process->getOutput();
-
                  -
                  -

                  You can also wait for a process to end if you started it asynchronously and -are done doing other stuff:

                  -
                  $process = new Process('ls -lsa');
-$process->start();
-
-// ... do other things
-
-$process->wait(function ($type, $buffer) {
-    if ('err' === $type) {
-        echo 'ERR > '.$buffer;
-    } else {
-        echo 'OUT > '.$buffer;
-    }
-});
-
                  -
                  -

                  Si deseas ejecutar algún código PHP independiente, en su lugar usa PhpProcess:

                  -
                  use Symfony\Component\Process\PhpProcess;
-
-$process = new PhpProcess(<<<EOF
-    <?php echo 'Hello World'; ?>
-EOF
-);
-$process->run();
-
                  -
                  -

                  -Nuevo en la versión 2.1: The ProcessBuilder class was added in Symfony 2.1.

                  -

                  Para hacer que tu código trabaje mejor en todas las plataformas, posiblemente en su lugar quieras usar la clase Symfony\Component\Process\ProcessBuilder:

                  -
                  use Symfony\Component\Process\ProcessBuilder;
-
-$builder = new ProcessBuilder(array('ls', '-lsa'));
-$builder->getProcess()->run();
-
                  -
                  -
                  -
                  -

                  Process Timeout

                  -

                  You can limit the amount of time a process takes to complete by setting a -timeout (in seconds):

                  -
                  use Symfony\Component\Process\Process;
-
-$process = new Process('ls -lsa');
-$process->setTimeout(3600);
-$process->run();
-
                  -
                  -

                  If the timeout is reached, a -Symfony\Process\Exception\RuntimeException is thrown.

                  -

                  For long running commands, it is your responsibility to perform the timeout -check regularly:

                  -
                  $process->setTimeout(3600);
-$process->start();
-
-while ($condition) {
-    // ...
-
-    // check if the timeout is reached
-    $process->checkTimeout();
-
-    usleep(200000);
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/property_access/index.html b/components/property_access/index.html deleted file mode 100644 index 9e6e93e..0000000 --- a/components/property_access/index.html +++ /dev/null @@ -1,145 +0,0 @@ - - - - - - - Propiedad Access — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/property_access/introduction.html b/components/property_access/introduction.html deleted file mode 100644 index 29f9cb0..0000000 --- a/components/property_access/introduction.html +++ /dev/null @@ -1,371 +0,0 @@ - - - - - - - El componente PropertyAccess — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente PropertyAccess

                  -
                  -
                  El componente PropertyAccess proporciona una función para leer y escribir de/a un objeto o arreglo usando una sencilla notación de cadena.
                  -

                  -Nuevo en la versión 2.2: El componente PropertyAccess es nuevo para Symfony 2.2. Anteriormente, la clase PropertyPath se localizaba en el componente Form.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente en dos diferentes maneras:

                  - -
                  -
                  -

                  Usando

                  -

                  El punto de entrada de este componente es el método fábrica PropertyAccess::getPropertyAccessor. Esta fábrica creará una nueva instancia de la clase Symfony\Component\PropertyAccess\PropertyAccessor con la configuración predefinida:

                  -
                  use Symfony\Component\PropertyAccess\PropertyAccess;
-
-$accessor = PropertyAccess::getPropertyAccessor();
-
                  -
                  -
                  -
                  -

                  Leyendo desde arreglos

                  -

                  Puedes leer un arreglo con el método PropertyAccessor::getValue. Esto se hace utilizando la notación de índice utilizada en PHP:

                  -
                  // ...
-$person = array(
-    'first_name' => 'Wouter',
-);
-
-echo $accessor->getValue($person, '[first_name]'); // 'Wouter'
-echo $accessor->getValue($person, '[age]'); // null
-
                  -
                  -

                  Como puedes ver, el método regresará null si el índice no existe.

                  -

                  También puedes utilizar arreglos multidimensionales:

                  -
                  // ...
-$persons = array(
-    array(
-        'first_name' => 'Wouter',
-    ),
-    array(
-        'first_name' => 'Ryan',
-    )
-);
-
-echo $accessor->getValue($persons, '[0][first_name]'); // 'Wouter'
-echo $accessor->getValue($persons, '[1][first_name]'); // 'Ryan'
-
                  -
                  -
                  -
                  -

                  Leyendo Objetos

                  -

                  El método getValue es un método muy robusto, y puedes ver todas sus características al trabajar con objetos.

                  -
                  -

                  Accediendo a propiedades públicas

                  -

                  Para leer propiedades, usa la notación de «punto»:

                  -
                  // ...
-$person = new Person();
-$person->firstName = 'Wouter';
-
-echo $accessor->getValue($person, 'firstName'); // 'Wouter'
-
-$child = new Person();
-$child->firstName = 'Bar';
-$person->children = array($child);
-
-echo $accessor->getValue($person, 'children[0].firstName'); // 'Bar'
-
                  -
                  -
                  -

                  Prudencia

                  -

                  Acceder a las propiedades públicas es la última opción utilizada por PropertyAccessor. -Este intenta acceder al valor utilizando los siguientes métodos primero antes de utilizar la propiedad directamente. Por ejemplo, si tienes una propiedad pública que tiene un método captador, lo utiliza.

                  -
                  -
                  -
                  -

                  Usando Captadores

                  -

                  El método getValue también apoya la lectura utilizando captadores. El método será creado utilizando convenciones de nomenclatura comunes para los captadores. Este intercala mayúsculas en el nombre de la propiedad (first_name se convierte en FirstName) y lo prefija con get. Por lo tanto el método real es getFirstName:

                  -
                  // ...
-class Person
-{
-    private $firstName = 'Wouter';
-
-    public function getFirstName()
-    {
-        return $this->firstName;
-    }
-}
-
-$person = new Person();
-
-echo $accessor->getValue($person, 'first_name'); // 'Wouter'
-
                  -
                  -
                  -
                  -

                  Using Hassers/Issers

                  -

                  And it doesn’t even stop there. If there is no getter found, the accessor will -look for an isser or hasser. This method is created using the same way as -getters, this means that you can do something like this:

                  -
                  // ...
-class Person
-{
-    private $author = true;
-    private $children = array();
-
-    public function isAuthor()
-    {
-        return $this->author;
-    }
-
-    public function hasChildren()
-    {
-        return 0 !== count($this->children);
-    }
-}
-
-$person = new Person();
-
-if ($accessor->getValue($person, 'author')) {
-    echo 'He is an author';
-}
-if ($accessor->getValue($person, 'children')) {
-    echo 'He has children';
-}
-
                  -
                  -

                  Esto producirá: He is an author

                  -
                  -
                  -

                  Magic Methods

                  -

                  At last, getValue can use the magic __get method too:

                  -
                  // ...
-class Person
-{
-    private $children = array(
-        'wouter' => array(...),
-    );
-
-    public function __get($id)
-    {
-        return $this->children[$id];
-    }
-}
-
-$person = new Person();
-
-echo $accessor->getValue($person, 'Wouter'); // array(...)
-
                  -
                  -
                  -
                  -
                  -

                  Writing to Arrays

                  -

                  The PropertyAccessor class can do more than just read an array, it can -also write to an array. This can be achieved using the -PropertyAccessor::setValue -method:

                  -
                  // ...
-$person = array();
-
-$accessor->setValue($person, '[first_name]', 'Wouter');
-
-echo $accessor->getValue($person, '[first_name]'); // 'Wouter'
-// o
-// echo $person['first_name']; // 'Wouter'
-
                  -
                  -
                  -
                  -

                  Writing to Objects

                  -

                  The setValue method has the same features as the getValue method. You -can use setters, the magic __set or properties to set values:

                  -
                  // ...
-class Person
-{
-    public $firstName;
-    private $lastName;
-    private $children = array();
-
-    public function setLastName($name)
-    {
-        $this->lastName = $name;
-    }
-
-    public function __set($property, $value)
-    {
-        $this->$property = $value;
-    }
-
-    // ...
-}
-
-$person = new Person();
-
-$accessor->setValue($person, 'firstName', 'Wouter');
-$accessor->setValue($person, 'lastName', 'de Jong');
-$accessor->setValue($person, 'children', array(new Person()));
-
-echo $person->firstName; // 'Wouter'
-echo $person->getLastName(); // 'de Jong'
-echo $person->children; // array(Person());
-
                  -
                  -
                  -
                  -

                  Mezclando objetos y arreglos

                  -

                  también puedes mezcla objetos y arreglos:

                  -
                  // ...
-class Person
-{
-    public $firstName;
-    private $children = array();
-
-    public function setChildren($children)
-    {
-        return $this->children;
-    }
-
-    public function getChildren()
-    {
-        return $this->children;
-    }
-}
-
-$person = new Person();
-
-$accessor->setValue($person, 'children[0]', new Person);
-// igual que $person->getChildren()[0] = new Person()
-
-$accessor->setValue($person, 'children[0].firstName', 'Wouter');
-// igual a $person->getChildren()[0]->firstName = 'Wouter'
-
-echo 'Hello '.$accessor->getValue($person, 'children[0].firstName'); // 'Wouter'
-// igual a $person->getChildren()[0]->firstName
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/routing.html b/components/routing.html deleted file mode 100644 index 3b9762f..0000000 --- a/components/routing.html +++ /dev/null @@ -1,343 +0,0 @@ - - - - - - - El componente Routing — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Routing

                  -
                  -
                  El componente Routing asigna una petición HTTP a un conjunto de variables de configuración.
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  -
                    -
                  • Usando el repositorio Git oficial (https://github.com/symfony/Routing);
                    • -
                  • Instalándolo a través de PEAR (pear.symfony.com/Routing);
                    • -
                  • Instalándolo vía Composer (symfony/routing en Packagist)
                    • -
                  -
                  -
                  -

                  Usando

                  -

                  Con el fin de establecer un sistema de enrutado básico necesitas tres partes:

                  -
                    -
                  • Una clase Symfony\Component\Routing\RouteCollection, que contiene las definiciones de las rutas (instancias de la clase Symfony\Component\Routing\Route)
                    • -
                  • Una clase Symfony\Component\Routing\RequestContext, que contiene información sobre la petición
                    • -
                  • Una clase Symfony\Component\Routing\Matcher\UrlMatcher, que realiza la asignación de la petición a una sola ruta
                    • -
                  -

                  Veamos un ejemplo rápido. Ten en cuenta que esto supone que ya has configurado el cargador automático para cargar el componente Routing:

                  -
                  use Symfony\Component\Routing\Matcher\UrlMatcher;
-use Symfony\Component\Routing\RequestContext;
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$routes = new RouteCollection();
-$routes->add('route_name', new Route('/foo', array('controller' => 'MyController')));
-
-$context = new RequestContext($_SERVER['REQUEST_URI']);
-
-$matcher = new UrlMatcher($routes, $context);
-
-$parameters = $matcher->match('/foo');
-// array('controller' => 'MyController', '_route' => 'route_name')
-
                  -
                  -
                  -

                  Nota

                  -

                  Ten cuidado al usar $_SERVER['REQUEST_URI'], ya que este puede incluir los parámetros de consulta en la URL, lo cual causará problemas con la ruta coincidente. Una manera fácil de solucionar esto es usando el componente HTTPFoundation como se explica abajo.

                  -
                  -

                  Puedes agregar tantas rutas como quieras a una clase Symfony\Component\Routing\RouteCollection.

                  -

                  El método RouteCollection::add() toma dos argumentos. El primero es el nombre de la ruta. El segundo es un objeto Symfony\Component\Routing\Route, que espera una ruta URL y algún arreglo de variables personalizadas en su constructor. Este arreglo de variables personalizadas puede ser cualquier cosa que tenga significado para tu aplicación, y es devuelto cuando dicha ruta corresponda.

                  -

                  Si no hay ruta coincidente debe lanzar una Symfony\Component\Routing\Exception\ResourceNotFoundException.

                  -

                  Además de tu arreglo de variables personalizadas, se añade una clave _route, que contiene el nombre de la ruta buscada.

                  -
                  -

                  Definiendo rutas

                  -

                  Una definición de la ruta completa puede contener un máximo de cuatro partes:

                  -
                    -
                  1. El patrón de la ruta URL. Este se compara con la URL pasada al RequestContext, y puede contener comodines marcadores de posición nombrados (por ejemplo, {placeholders}) para que coincidan con elementos dinámicos en la URL.
                    2. -
                  2. Una matriz de valores predeterminados. Esta contiene un conjunto de valores arbitrarios que serán devueltos cuando la petición coincide con la ruta.
                    3. -
                  3. Un arreglo de requisitos. Estos definen las restricciones para los valores de los marcadores de posición como las expresiones regulares.
                    4. -
                  4. Un arreglo de opciones. Estas contienen la configuración interna de la ruta y son las menos necesarias comúnmente.
                    5. -
                  -

                  Veamos la siguiente ruta, que combina varias de estas ideas:

                  -
                  $route = new Route(
-    '/archive/{month}',                    // ruta
-    array('controller' => 'showArchive'),  // valores predefinidos
-    array('month' => '[0-9]{4}-[0-9]{2}'), // requisitos
-    array() // options
-);
-
-// ...
-
-$parameters = $matcher->match('/archive/2012-01');
-// array('controller' => 'showArchive', 'month' => '2012-01', '_route' => ...)
-
-$parameters = $matcher->match('/archive/foo');
-// lanza la ResourceNotFoundException
-
                  -
                  -

                  En este caso, la ruta coincide con /archive/2012-01, porque el comodín {month} coincide con el comodín de la expresión regular suministrada. Sin embargo, /archive/f oo no coincide, porque el comodín del mes “foo” no concuerda.

                  -

                  Además de las restricciones de la expresión regular, hay dos requisitos especiales que puedes definir:

                  -
                    -
                  • el _method impone un determinado método de la petición HTTP (HEAD, GET, POST, ...)
                    • -
                  • _scheme impone un determinado esquema HTTP (http, https)
                    • -
                  -

                  Por ejemplo, la siguiente ruta sólo acepta peticiones a /foo con el método POST y una conexión segura:

                  -
                  $route = new Route('/foo', array(), array('_method' => 'post', '_scheme' => 'https' ));
-
                  -
                  -
                  -

                  Truco

                  -

                  Si quieres hacer coincidir todas las URL que comiencen con una cierta ruta y terminan en un sufijo arbitrario puedes utilizar la siguiente definición de ruta:

                  -
                  $route = new Route('/start/{suffix}', array('suffix' => ''), array('suffix' => '.*'));
-
                  -
                  -
                  -
                  -
                  -

                  Usando prefijos

                  -

                  Puedes agregar rutas u otras instancias de Symfony\Component\Routing\RouteCollection a otra colección. -De esta manera puedes construir un árbol de rutas. Además, puedes definir un prefijo, los requisitos predeterminados y las opciones predefinidas para todas las rutas de un subárbol:

                  -
                  $rootCollection = new RouteCollection();
-
-$subCollection = new RouteCollection();
-$subCollection->add(...);
-$subCollection->add(...);
-
-$rootCollection->addCollection($subCollection, '/prefix', array('_scheme' => 'https'));
-
                  -
                  -
                  -
                  -

                  Configurando los parámetros de la Petición

                  -

                  La clase Symfony\Component\Routing\RequestContext proporciona información sobre la petición actual. Puedes definir todos los parámetros de una petición HTTP con esta clase a través de su constructor:

                  -
                  public function __construct($baseUrl = '', $method = 'GET', $host = 'localhost', $scheme = 'http', $httpPort = 80, $httpsPort = 443)
-
                  -
                  -

                  Normalmente puedes pasar los valores de la variable $_SERVER para poblar la Symfony\Component\Routing\RequestContext. Pero si utilizas el componente HttpFoundation </components/http_foundation/index>, puedes utilizar su :class:`Symfony\Component\HttpFoundation\Request para alimentar el Symfony\Component\Routing\RequestContext en un método abreviado:

                  -
                  use Symfony\Component\HttpFoundation\Request;
-
-$context = new RequestContext();
-$context->fromRequest(Request::createFromGlobals());
-
                  -
                  -
                  -
                  -

                  Generando una URL

                  -

                  Si bien la Symfony\Component\Routing\Matcher\UrlMatcher trata de encontrar una ruta que se adapte a la petición dada, esta también puede construir una URL a partir de una ruta determinada:

                  -
                  use Symfony\Component\Routing\Generator\UrlGenerator;
-
-$routes = new RouteCollection();
-$routes->add('show_post', new Route('/show/{slug}'));
-
-$context = new RequestContext($_SERVER['REQUEST_URI']);
-
-$generator = new UrlGenerator($routes, $context);
-
-$url = $generator->generate('show_post', array(
-    'slug' => 'my-blog-post'
-));
-// /show/my-blog-post
-
                  -
                  -
                  -

                  Nota

                  -

                  Si has definido el requisito _scheme, se genera una URL absoluta si el esquema del Symfony\Component\Routing\RequestContext actual no coincide con el requisito.

                  -
                  -
                  -
                  -

                  Cargando rutas desde un archivo

                  -

                  Ya hemos visto lo fácil que es añadir rutas a una colección dentro de PHP. Pero también puedes cargar rutas de una serie de archivos diferentes.

                  -

                  El componente de enrutado viene con una serie de clases cargadoras, cada una dotándote de la capacidad para cargar una colección de definiciones de ruta desde un archivo externo en algún formato. -Cada cargador espera una instancia del Symfony\Component\Config\FileLocator como argumento del constructor. Puedes utilizar el Symfony\Component\Config\FileLocator para definir una serie de rutas en las que el cargador va a buscar los archivos solicitados. -Si se encuentra el archivo, el cargador devuelve una Symfony\Component\Routing\RouteCollection.

                  -

                  Si estás usando el YamlFileLoader, entonces las definiciones de ruta tienen este aspecto:

                  -
                  # routes.yml
-route1:
-    pattern: /foo
-    defaults: { controller: 'MyController::fooAction' }
-
-route2:
-    pattern: /foo/bar
-    defaults: { controller: 'MyController::foobarAction' }
-
                  -
                  -

                  Para cargar este archivo, puedes utilizar el siguiente código. Este asume que tu archivo routes.yml está en el mismo directorio que el código de abajo:

                  -
                  use Symfony\Component\Config\FileLocator;
-use Symfony\Component\Routing\Loader\YamlFileLoader;
-
-// busca dentro de *este* directorio
-$locator = new FileLocator(array(__DIR__));
-$loader = new YamlFileLoader($locator);
-$collection = $loader->load('routes.yml');
-
                  -
                  -

                  Además del Symfony\Component\Routing\Loader\YamlFileLoader hay otros dos cargadores que funcionan de manera similar:

                  -
                    -
                  • Symfony\Component\Routing\Loader\XmlFileLoader
                    • -
                  • Symfony\Component\Routing\Loader\PhpFileLoader
                    • -
                  -

                  Si utilizas el Symfony\Component\Routing\Loader\PhpFileLoader debes proporcionar el nombre del un archivo php que devuelva una Symfony\Component\Routing\RouteCollection:

                  -
                  // ProveedorDeRuta.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('route_name', new Route('/foo', array('controller' => 'ExampleController')));
-// ...
-
-return $collection;
-
                  -
                  -
                  -

                  Rutas como cierres

                  -

                  También está el Symfony\Component\Routing\Loader\ClosureLoader, que -llama a un cierre y utiliza el resultado como una Symfony\Component\Routing\RouteCollection:

                  -
                  use Symfony\Component\Routing\Loader\ClosureLoader;
-
-$closure = function() {
-    return new RouteCollection();
-};
-
-$loader = new ClosureLoader();
-$collection = $loader->load($closure);
-
                  -
                  -
                  -
                  -

                  Rutas como anotaciones

                  -

                  Por último, pero no menos importante, están las Symfony\Component\Routing\Loader\AnnotationDirectoryLoader y Symfony\Component\Routing\Loader\AnnotationFileLoader para cargar -definiciones de ruta a partir de las anotaciones de la clase. Los detalles específicos se dejan aquí.

                  -
                  -
                  -
                  -

                  El ruteador todo en uno

                  -

                  La clase Symfony\Component\Routing\Router es un paquete todo en uno para utilizar rápidamente el componente de enrutado. El constructor espera una instancia del cargador, una ruta a la definición de la ruta principal y algunas otras opciones:

                  -
                  public function __construct(LoaderInterface $loader, $resource, array $options = array(), RequestContext $context = null, array $defaults = array());
-
                  -
                  -

                  Con la opción cache_dir puedes habilitar la caché de enrutado (si proporcionas una ruta) o desactivar el almacenamiento en caché (si la configuras a null). El almacenamiento en caché automáticamente se hace en segundo plano si lo quieres usar. Un ejemplo básico de la clase Symfony\Component\Routing\Router se vería así:

                  -
                  $locator = new FileLocator(array(__DIR__));
-$requestContext = new RequestContext($_SERVER['REQUEST_URI']);
-
-$router = new Router(
-    new YamlFileLoader($locator),
-    "routes.yml",
-    array('cache_dir' => __DIR__.'/cache'),
-    $requestContext,
-);
-$router->match('/foo/bar');
-
                  -
                  -
                  -

                  Nota

                  -

                  Si utilizas el almacenamiento en caché, el componente Routing compilará las nuevas clases guardándolas en cache_dir. Esto significa que el archivo debe tener permisos de escritura en esa ubicación.

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/routing/hostname_pattern.html b/components/routing/hostname_pattern.html deleted file mode 100644 index d4646ef..0000000 --- a/components/routing/hostname_pattern.html +++ /dev/null @@ -1,284 +0,0 @@ - - - - - - - Cómo emparejar una ruta basándose en el servidor — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo emparejar una ruta basándose en el servidor

                  -

                  -Nuevo en la versión 2.2: El soporte necesario para emparejar con el servidor se añadió en Symfony 2.2

                  -

                  También puedes emparejar con el host HTTP de la petición entrante.

                  -
                  -
                    -
                  • YAML
                    mobile_homepage:
-    path:     /
-    host:     m.example.com
-    defaults: { _controller: AcmeDemoBundle:Main:mobileHomepage }
-
-homepage:
-    path:     /
-    defaults: { _controller: AcmeDemoBundle:Main:homepage }
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing
-        http://symfony.com/schema/routing/routing-1.0.xsd"
->
-
-    <route id="mobile_homepage" path="/" host="m.example.com">
-        <default key="_controller">AcmeDemoBundle:Main:mobileHomepage</default>
-    </route>
-
-    <route id="homepage" path="/">
-        <default key="_controller">AcmeDemoBundle:Main:homepage</default>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('mobile_homepage', new Route('/', array(
-    '_controller' => 'AcmeDemoBundle:Main:mobileHomepage',
-), array(), array(), 'm.example.com'));
-
-$collection->add('homepage', new Route('/', array(
-    '_controller' => 'AcmeDemoBundle:Main:homepage',
-)));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  Ambas rutas emparejan con la misma ruta /, aun así la primera sólo emparejará si el servidor es m.example.com.

                  -
                  -

                  Marcadores de posición y requisitos en patrones de nombre del servidor

                  -

                  Si estás utilizando el componente DependencyInjection (o la plataforma Symfony2 en su totalidad), entonces puedes utilizar los parámetros del contenedor de servicios como variables en cualquier lugar en tus rutas.

                  -

                  Puedes evitar codificar el nombre de dominio usando un marcador de posición y un requisito. -El %domain% en los requisitos se sustituye por el valor del parámetro domain en el contenedor de inyección de dependencias.

                  -
                  -
                    -
                  • YAML
                    mobile_homepage:
-    path:     /
-    host:     m.{domain}
-    defaults: { _controller: AcmeDemoBundle:Main:mobileHomepage }
-    requirements:
-        domain: %domain%
-
-homepage:
-    path:  /
-    defaults: { _controller: AcmeDemoBundle:Main:homepage }
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="mobile_homepage" path="/" host="m.example.com">
-        <default key="_controller">AcmeDemoBundle:Main:mobileHomepage</default>
-        <requirement key="domain">%domain%</requirement>
-    </route>
-
-    <route id="homepage" path="/">
-        <default key="_controller">AcmeDemoBundle:Main:homepage</default>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('mobile_homepage', new Route('/', array(
-    '_controller' => 'AcmeDemoBundle:Main:mobileHomepage',
-), array(
-    'domain' => '%domain%',
-), array(), 'm.{domain}'));
-
-$collection->add('homepage', new Route('/', array(
-    '_controller' => 'AcmeDemoBundle:Main:homepage',
-)));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Añadiendo un servidor a la expresión regular de las rutas importadas

                  -

                  Puedes poner una expresión regular para el servidor en las rutas importadas:

                  -
                  -
                    -
                  • YAML
                    # app/config/routing.yml
-acme_hello:
-    resource: "@AcmeHelloBundle/Resources/config/routing.yml"
-    host:     "hello.example.com"
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/routing.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <import resource="@AcmeHelloBundle/Resources/config/routing.xml" host="hello.example.com" />
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-
-$collection = new RouteCollection();
-$collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"), '', array(), array(), array(), 'hello.example.com');
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  El servidor hello.example.com será puesto en cada ruta cargada desde el nuevo recurso -de enrutado.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/routing/index.html b/components/routing/index.html deleted file mode 100644 index 900e0c2..0000000 --- a/components/routing/index.html +++ /dev/null @@ -1,145 +0,0 @@ - - - - - - - Enrutando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/routing/introduction.html b/components/routing/introduction.html deleted file mode 100644 index 8ed5d36..0000000 --- a/components/routing/introduction.html +++ /dev/null @@ -1,395 +0,0 @@ - - - - - - - El componente Routing — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Routing

                  -
                  -
                  El componente Routing asocia una Petición HTTP a un conjunto de variables de configuración.
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  Con el fin de establecer un sistema de enrutado básico necesitas tres partes:

                  -
                    -
                  • Una clase Symfony\Component\Routing\RouteCollection, que contiene las definiciones de las rutas (instancias de la clase Symfony\Component\Routing\Route)
                    • -
                  • Una clase Symfony\Component\Routing\RequestContext, que contiene información sobre la petición
                    • -
                  • Una clase Symfony\Component\Routing\Matcher\UrlMatcher, que realiza la asignación de la petición a una sola ruta
                    • -
                  -

                  Veamos un ejemplo rápido. Ten en cuenta que esto supone que ya has configurado el cargador automático para cargar el componente Routing:

                  -
                  use Symfony\Component\Routing\Matcher\UrlMatcher;
-use Symfony\Component\Routing\RequestContext;
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$route = new Route('/foo', array('controller' => 'MyController'));
-$routes = new RouteCollection();
-$routes->add('route_name', $route);
-
-$context = new RequestContext($_SERVER['REQUEST_URI']);
-
-$matcher = new UrlMatcher($routes, $context);
-
-$parameters = $matcher->match('/foo');
-// array('controller' => 'MyController', '_route' => 'route_name')
-
                  -
                  -
                  -

                  Nota

                  -

                  Ten cuidado al usar $_SERVER['REQUEST_URI'], ya que este puede incluir los parámetros de consulta en la URL, lo cual causará problemas con la ruta coincidente. Una manera fácil de solucionar esto es usando el componente HTTPFoundation como se explica abajo.

                  -
                  -

                  Puedes agregar tantas rutas como quieras a una clase Symfony\Component\Routing\RouteCollection.

                  -

                  El método RouteCollection::add() toma dos argumentos. El primero es el nombre de la ruta. El segundo es un objeto Symfony\Component\Routing\Route, que espera una ruta URL y algún arreglo de variables personalizadas en su constructor. Este arreglo de variables personalizadas puede ser cualquier cosa que tenga significado para tu aplicación, y es devuelto cuando dicha ruta corresponda.

                  -

                  Si no hay ruta coincidente debe lanzar una Symfony\Component\Routing\Exception\ResourceNotFoundException.

                  -

                  Además de tu arreglo de variables personalizadas, se añade una clave _route, que contiene el nombre de la ruta buscada.

                  -
                  -

                  Definiendo rutas

                  -

                  Una definición de ruta completa puede contener hasta siete partes:

                  -
                    -
                  1. El trayecto a la URL de la ruta. Este se compara con la URL pasada al RequestContext, y puede contener comodines marcadores de posición nombrados (por ejemplo, {placeholders}) para que coincidan con elementos dinámicos en la URL.
                    2. -
                  2. Un arreglo de valores predeterminados. Esta contiene un conjunto de valores arbitrarios que serán devueltos cuando la petición coincida con la ruta.
                    3. -
                  3. Un arreglo de requisitos. Estos definen las restricciones para los valores de los marcadores de posición como las expresiones regulares.
                    4. -
                  4. Un arreglo de opciones. Estas contienen la configuración interna de la ruta y comúnmente son las menos necesarias.
                    5. -
                  5. Un servidor. Este se empareja contra el servidor de la petición. Ve Cómo emparejar una ruta basándose en el servidor para más detalles.
                    6. -
                  6. Un arreglo de esquemas. Estos imponen un determinado esquema HTTP (http, https).
                    7. -
                  7. Un arreglo de métodos. Estos fuerzan un determinado método de petición HTTP (HEAD, GET, POST, ...).
                    8. -
                  -

                  -Nuevo en la versión 2.2: El soporte necesario para emparejar con el servidor se añadió en Symfony 2.2

                  -

                  Veamos la siguiente ruta, que combina varias de estas ideas:

                  -
                  $route = new Route(
-    '/archive/{month}', // ruta
-    array('controller' => 'showArchive'), // valores predefinidos
-    array('month' => '[0-9]{4}-[0-9]{2}', 'subdomain' => 'www|m'), // requisitos
-    array(), // opciones
-    '{subdomain}.example.com', // servidor
-    array(), // esquemas
-    array() // métodos
-);
-
-// ...
-
-$parameters = $matcher->match('/archive/2012-01');
-// array(
-//     'controller' => 'showArchive',
-//     'month' => '2012-01',
-//     'subdomain' => 'www',
-//     '_route' => ...
-//  )
-
-$parameters = $matcher->match('/archive/foo');
-// lanza la ResourceNotFoundException
-
                  -
                  -

                  En este caso, la ruta coincide con /archive/2012-01, porque el comodín {month} coincide con el comodín de la expresión regular suministrada. Sin embargo, /archive/f oo no coincide, porque el comodín del mes «foo» no concuerda.

                  -
                  -

                  Truco

                  -

                  Si quieres hacer coincidir todas las URL que comiencen con una cierta ruta y terminan en un sufijo arbitrario puedes utilizar la siguiente definición de ruta:

                  -
                  $route = new Route(
-    '/start/{suffix}',
-    array('suffix' => ''),
-    array('suffix' => '.*')
-);
-
                  -
                  -
                  -
                  -
                  -

                  Usando prefijos

                  -

                  Puedes agregar rutas u otras instancias de Symfony\Component\Routing\RouteCollection a otra colección. -De esta manera puedes construir un árbol de rutas. Además, puedes definir un prefijo, requisitos predeterminados, opciones predefinidas y servidores a todas las rutas de un subárbol con el método addPrefix():

                  -
                  $rootCollection = new RouteCollection();
-
-$subCollection = new RouteCollection();
-$subCollection->add(...);
-$subCollection->add(...);
-$subCollection->addPrefix(
-    '/prefix', // prefijo
-    array(), // requisitos
-    array(), // opciones
-    'admin.example.com', // servidor
-    array('https') // esquemas
-);
-
-$rootCollection->addCollection($subCollection);
-
                  -
                  -

                  -Nuevo en la versión 2.2: El método addPrefix se añadió en Symfony 2.2. Este era parte del método addCollection en versiones anteriores.

                  -
                  -
                  -

                  Configurando los parámetros de la Petición

                  -

                  La clase Symfony\Component\Routing\RequestContext proporciona información sobre la Petición actual. Puedes definir todos los parámetros de una Petición HTTP con esta clase a través de su constructor:

                  -
                  public function __construct(
-    $baseUrl = '',
-    $method = 'GET',
-    $host = 'localhost',
-    $scheme = 'http',
-    $httpPort = 80,
-    $httpsPort = 443
-)
-
                  -
                  -

                  Normalmente puedes pasar los valores de la variable $_SERVER para poblar la Symfony\Component\Routing\RequestContext. Pero si utilizas el componente HttpFoundation, puedes utilizar su clase Symfony\Component\HttpFoundation\Request para alimentar al Symfony\Component\Routing\RequestContext en un método abreviado:

                  -
                  use Symfony\Component\HttpFoundation\Request;
-
-$context = new RequestContext();
-$context->fromRequest(Request::createFromGlobals());
-
                  -
                  -
                  -
                  -

                  Generando una URL

                  -

                  Si bien la Symfony\Component\Routing\Matcher\UrlMatcher trata de encontrar una ruta que se adapte a la petición dada, esta también puede construir una URL a partir de una ruta determinada:

                  -
                  use Symfony\Component\Routing\Generator\UrlGenerator;
-
-$routes = new RouteCollection();
-$routes->add('show_post', new Route('/show/{slug}'));
-
-$context = new RequestContext($_SERVER['REQUEST_URI']);
-
-$generator = new UrlGenerator($routes, $context);
-
-$url = $generator->generate('show_post', array(
-    'slug' => 'my-blog-post',
-));
-// /show/my-blog-post
-
                  -
                  -
                  -

                  Nota

                  -

                  Si definiste un esquema, se genera una URL absoluta si el esquema de la clase Symfony\Component\Routing\RequestContext actual no concuerda con el requisito.

                  -
                  -
                  -
                  -

                  Cargando rutas desde un archivo

                  -

                  Ya hemos visto lo fácil que es añadir rutas a una colección dentro de PHP. Pero también puedes cargar rutas de una serie de archivos diferentes.

                  -

                  El componente de enrutado viene con una serie de clases cargadoras, cada una dotándote de la capacidad para cargar una colección de definiciones de ruta desde un archivo externo en algún formato. -Cada cargador espera una instancia del Symfony\Component\Config\FileLocator como argumento del constructor. Puedes utilizar el Symfony\Component\Config\FileLocator para definir una serie de rutas en las que el cargador va a buscar los archivos solicitados. -Si se encuentra el archivo, el cargador devuelve una Symfony\Component\Routing\RouteCollection.

                  -

                  Si estás usando el YamlFileLoader, entonces las definiciones de ruta tienen este aspecto:

                  -
                  # routes.yml
-route1:
-    path:     /foo
-    defaults: { _controller: 'MyController::fooAction' }
-
-route2:
-    path:     /foo/bar
-    defaults: { _controller: 'MyController::foobarAction' }
-
                  -
                  -

                  Para cargar este archivo, puedes utilizar el siguiente código. Este asume que tu archivo routes.yml está en el mismo directorio que el código de abajo:

                  -
                  use Symfony\Component\Config\FileLocator;
-use Symfony\Component\Routing\Loader\YamlFileLoader;
-
-// busca dentro de *este* directorio
-$locator = new FileLocator(array(__DIR__));
-$loader = new YamlFileLoader($locator);
-$collection = $loader->load('routes.yml');
-
                  -
                  -

                  Además del Symfony\Component\Routing\Loader\YamlFileLoader hay otros dos cargadores que funcionan de manera similar:

                  -
                    -
                  • Symfony\Component\Routing\Loader\XmlFileLoader
                    • -
                  • Symfony\Component\Routing\Loader\PhpFileLoader
                    • -
                  -

                  Si utilizas el Symfony\Component\Routing\Loader\PhpFileLoader debes proporcionar el nombre del un archivo php que devuelva una Symfony\Component\Routing\RouteCollection:

                  -
                  // ProveedorDeRuta.php
-use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add(
-    'route_name',
-    new Route('/foo', array('controller' => 'ExampleController'))
-);
-// ...
-
-return $collection;
-
                  -
                  -
                  -

                  Rutas como cierres

                  -

                  También está el Symfony\Component\Routing\Loader\ClosureLoader, que -llama a un cierre y utiliza el resultado como una Symfony\Component\Routing\RouteCollection:

                  -
                  use Symfony\Component\Routing\Loader\ClosureLoader;
-
-$closure = function() {
-    return new RouteCollection();
-};
-
-$loader = new ClosureLoader();
-$collection = $loader->load($closure);
-
                  -
                  -
                  -
                  -

                  Rutas como anotaciones

                  -

                  Por último, pero no menos importante, están las Symfony\Component\Routing\Loader\AnnotationDirectoryLoader y Symfony\Component\Routing\Loader\AnnotationFileLoader para cargar -definiciones de ruta a partir de las anotaciones de la clase. Los detalles específicos se dejan aquí.

                  -
                  -
                  -
                  -

                  El ruteador todo en uno

                  -

                  La clase Symfony\Component\Routing\Router es un paquete todo en uno para utilizar rápidamente el componente de enrutado. El constructor espera una instancia del cargador, una ruta a la definición de la ruta principal y algunas otras opciones:

                  -
                  public function __construct(
-    LoaderInterface $loader,
-    $resource,
-    array $options = array(),
-    RequestContext $context = null,
-    array $defaults = array()
-);
-
                  -
                  -

                  Con la opción cache_dir puedes habilitar la caché de enrutado (si proporcionas una ruta) o desactivar el almacenamiento en caché (si la configuras a null). El almacenamiento en caché automáticamente se hace en segundo plano si lo quieres usar. Un ejemplo básico de la clase Symfony\Component\Routing\Router se vería así:

                  -
                  $locator = new FileLocator(array(__DIR__));
-$requestContext = new RequestContext($_SERVER['REQUEST_URI']);
-
-$router = new Router(
-    new YamlFileLoader($locator),
-    'routes.yml',
-    array('cache_dir' => __DIR__.'/cache'),
-    $requestContext
-);
-$router->match('/foo/bar');
-
                  -
                  -
                  -

                  Nota

                  -

                  Si utilizas el almacenamiento en caché, el componente Routing compilará las nuevas clases guardándolas en cache_dir. Esto significa que el archivo debe tener permisos de escritura en esa ubicación.

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/security/authentication.html b/components/security/authentication.html deleted file mode 100644 index 7216c99..0000000 --- a/components/security/authentication.html +++ /dev/null @@ -1,302 +0,0 @@ - - - - - - - Autenticación — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Autenticación

                  -

                  Cuándo una petición apunta a una área protegida, y uno de los escuchas del -cortafuegos asociado es capaz de extraer las credenciales del usuario desde el objeto Symfony\Component\HttpFoundation\Request actual, este debe crear una ficha conteniendo estas credenciales. Lo siguiente que el escucha debería hacer es consultar al gestor de autenticación para validar la ficha dada, y regresar una ficha autenticada si resulta que las credenciales suministradas son válidas. -El escucha entonces debería almacenar la ficha autenticada en el contexto de seguridad:

                  -
                  use Symfony\Component\Security\Http\Firewall\ListenerInterface;
-use Symfony\Component\Security\Core\SecurityContextInterface;
-use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
-use Symfony\Component\HttpKernel\Event\GetResponseEvent;
-use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
-
-class SomeAuthenticationListener implements ListenerInterface
-{
-    /**
-     * @var SecurityContextInterface
-     */
-    private $securityContext;
-
-    /**
-     * @var AuthenticationManagerInterface
-     */
-    private $authenticationManager;
-
-    /**
-     * @var string Uniquely identifies the secured area
-     */
-    private $providerKey;
-
-    // ...
-
-    public function handle(GetResponseEvent $event)
-    {
-        $request = $event->getRequest();
-
-        $username = ...;
-        $password = ...;
-
-        $unauthenticatedToken = new UsernamePasswordToken(
-            $username,
-            $password,
-            $this->providerKey
-        );
-
-        $authenticatedToken = $this
-            ->authenticationManager
-            ->authenticate($unauthenticatedToken);
-
-        $this->securityContext->setToken($authenticatedToken);
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Una ficha puede ser cualquier clase, siempre y cuando implemente la interfaz Symfony\Component\Security\Core\Authentication\Token\TokenInterface.

                  -
                  -
                  -

                  El gestor de autenticación

                  -

                  El gestor de autenticación predefinido es una instancia de la clase Symfony\Component\Security\Core\Authentication\AuthenticationProviderManager:

                  -
                  use Symfony\Component\Security\Core\Authentication\AuthenticationProviderManager;
-
-// instancias de Symfony\Component\Security\Core\Authentication\AuthenticationProviderInterface
-$providers = array(...);
-
-$authenticationManager = new AuthenticationProviderManager($providers);
-
-try {
-    $authenticatedToken = $authenticationManager
-        ->authenticate($unauthenticatedToken);
-} catch (AuthenticationException $failed) {
-    // falló la autenticación
-}
-
                  -
                  -

                  El AuthenticationProviderManager, al crear una instancia, recibe varios proveedores de autenticación, cada uno compatible a un diferente tipo de señal.

                  -
                  -

                  Nota

                  -

                  Por supuesto, puedes escribir tu propio gestor de autenticación, sólo tienes que implementar la Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface.

                  -
                  -
                  -
                  -

                  Proveedores de autenticación

                  -

                  Cada proveedor (debido a que implementan la clase Symfony\Component\Security\Core\Authentication\Provider\AuthenticationProviderInterface) tiene un método supports() por medio del cual el AuthenticationProviderManager puede determinar si es compatible con la ficha dada. Si este es el caso, el gestor, entonces llama al método Symfony\Component\Security\Core\Authentication\Provider\AuthenticationProviderInterface::authenticate del proveedor -. -Este método debe devolver una ficha autenticada o lanzar una Symfony\Component\Security\Core\Exception\AuthenticationException (o cualquier otra excepción que extienda esta).

                  -
                  -

                  Autenticando usuarios por nombre de usuario y contraseña

                  -

                  Un proveedor de autenticación intentará autenticar a un usuario basándose en las credenciales que él proporcionó. Generalmente, se trata de un nombre de usuario y una contraseña. -La mayoría de las aplicaciones web guardan el nombre de usuario y una codificación de la contraseña del usuario combinada con una «sal» generada aleatoriamente. Esto significa que la autenticación promedio consistirá en recuperar la sal y la contraseña codificada del almacén de datos del usuario, la contraseña codificada del usuario es proporcionada (por ejemplo, utilizando un formulario de inicio de sesión) con la sal y comparando ambas para determinar si la contraseña dada es válida.

                  -

                  Esta funcionalidad es ofrecida por el Symfony\Component\Security\Core\Authentication\Provider\DaoAuthenticationProvider. -Esta recupera los datos del usuario a partir de una Symfony\Component\Security\Core\User\UserProviderInterface, utilizando una Symfony\Component\Security\Core\Encoder\PasswordEncoderInterface para crear la codificación de la contraseña y devolver una ficha autenticada si la contraseña es válida:

                  -
                  use Symfony\Component\Security\Core\Authentication\Provider\DaoAuthenticationProvider;
-use Symfony\Component\Security\Core\User\UserChecker;
-use Symfony\Component\Security\Core\User\InMemoryUserProvider;
-use Symfony\Component\Security\Core\Encoder\EncoderFactory;
-
-$userProvider = new InMemoryUserProvider(
-    array(
-        'admin' => array(
-            // password is "foo"
-            'password' => '5FZ2Z8QIkA7UTZ4BYkoC+GsReLf569mSKDsfods6LYQ8t+a8EW9oaircfMpmaLbPBh4FOBiiFyLfuZmTSUwzZg==',
-            'roles'    => array('ROLE_ADMIN'),
-        ),
-    )
-);
-
-// para alguna comprobación extra: ¿la cuenta está habilitada, cerrada, expirada, etc.?
-$userChecker = new UserChecker();
-
-// un arreglo de codificadores de contraseña (ve abajo)
-$encoderFactory = new EncoderFactory(...);
-
-$provider = new DaoAuthenticationProvider(
-    $userProvider,
-    $userChecker,
-    'secured_area',
-    $encoderFactory
-);
-
-$provider->authenticate($unauthenticatedToken);
-
                  -
                  -
                  -

                  Nota

                  -

                  El ejemplo anterior demuestra el uso del proveedor de usuarios «en memoria», pero puedes utilizar cualquier proveedor de usuario, siempre y cuando implemente la Symfony\Component\Security\Core\User\UserProviderInterface. -También es posible permitir que múltiples proveedores de usuario intenten encontrar los datos del usuario, utilizando la Symfony\Component\Security\Core\User\ChainUserProvider.

                  -
                  -
                  -
                  -

                  La factoría codificadora de contraseñas

                  -

                  La clase Symfony\Component\Security\Core\Authentication\Provider\DaoAuthenticationProvider utiliza una factoría codificadora para crear una contraseña codificada para un determinado tipo de usuario. Esto te permite utilizar diferentes estrategias de codificado para diferentes tipos de usuario. La clase Symfony\Component\Security\Core\Encoder\EncoderFactory recibe un arreglo de codificadores:

                  -
                  use Symfony\Component\Security\Core\Encoder\EncoderFactory;
-use Symfony\Component\Security\Core\Encoder\MessageDigestPasswordEncoder;
-
-$defaultEncoder = new MessageDigestPasswordEncoder('sha512', true, 5000);
-$weakEncoder = new MessageDigestPasswordEncoder('md5', true, 1);
-
-$encoders = array(
-    'Symfony\\Component\\Security\\Core\\User\\User' => $defaultEncoder,
-    'Acme\\Entity\\LegacyUser'                       => $weakEncoder,
-
-    // ...
-);
-
-$encoderFactory = new EncoderFactory($encoders);
-
                  -
                  -

                  Cada codificador debería implementar la Symfony\Component\Security\Core\Encoder\PasswordEncoderInterface o ser un arreglo con una clave class y arguments, lo cual permite a la factoría codificadora construir el codificador sólo cuándo es necesario.

                  -
                  -
                  -

                  Codificadores de contraseña

                  -

                  Cuándo invocas al método getEncoder() de la factoría codificadora de contraseñas con el objeto usuario como primer argumento, regresa un codificador de tipo Symfony\Component\Security\Core\Encoder\PasswordEncoderInterface el cuál deberías usar para codificar la contraseña de ese usuario:

                  -
                  // recupera un usuario de tipo Acme\Entity\LegacyUser
-$user = ...
-
-$encoder = $encoderFactory->getEncoder($user);
-
-// debe regresar $weakEncoder (ve arriba)
-
-$encodedPassword = $encoder->encodePassword($password, $user->getSalt());
-
-// comprueba si la contraseña es válida:
-
-$validPassword = $encoder->isPasswordValid(
-    $user->getPassword(),
-    $password,
-    $user->getSalt());
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/security/authorization.html b/components/security/authorization.html deleted file mode 100644 index c6408fc..0000000 --- a/components/security/authorization.html +++ /dev/null @@ -1,342 +0,0 @@ - - - - - - - Autorización — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Autorización

                  -

                  Cuando alguno de los proveedores de autenticación (ve Proveedores de autenticación) ha verificado la ficha no autenticada aún, devolverá una ficha autenticada. El escucha debe configurar la autenticación de esta ficha directamente en la Symfony\Component\Security\Core\SecurityContextInterface utilizando su método setToken().

                  -

                  A partir de ahí, el usuario está autenticado, es decir, identificado. Ahora, otras partes de la aplicación pueden utilizar la ficha para decidir si o no el usuario puede solicitar una determinada URI, o modificar un determinado objeto. Esta decisión la tomará una instancia de la Symfony\Component\Security\Core\Authorization\AccessDecisionManagerInterface.

                  -

                  Una decisión de autorización siempre se basará en un par de cosas:

                  -
                    -
                  • -
                    La ficha actual
                    -

                    Por ejemplo, puedes utilizar el método getRoles() de la ficha para recuperar las funciones del usuario actual (por ejemplo, ROLE_SUPER_ADMIN), o una decisión puede estar basada en la clase de la ficha.

                    -
                    -
                    -
                    • -
                  • -
                    Un conjunto de atributos
                    -

                    Cada atributo representa un determinado derecho que el usuario debe tener, por ejemplo, ROLE_ADMIN para asegurarse de que el usuario es un administrador.

                    -
                    -
                    -
                    • -
                  • -
                    Un objeto (opcional)
                    -

                    Cualquier objeto con el cual controlar el acceso necesario, como un artículo o un objeto Comentario.

                    -
                    -
                    -
                    • -
                  -
                  -

                  Gestor de la decisión de acceso

                  -

                  Debido que decidir si un usuario está autorizado a realizar una cierta acción puede ser un proceso complicado, la clase Symfony\Component\Security\Core\Authorization\AccessDecisionManager estándar en sí misma depende de varios votantes, y hace un veredicto final basándose en todos los votos (positivos, negativos o neutros) que ha recibido. Este reconoce varias estrategias:

                  -
                    -
                  • -
                    affirmative (predeterminada)
                    -

                    concede acceso tan pronto como cualquier votante devuelve una respuesta afirmativa;

                    -
                    -
                    -
                    • -
                  • -
                    consensus
                    -

                    concede acceso si son más los votantes que garantizan el acceso de los que lo niegan;

                    -
                    -
                    -
                    • -
                  • -
                    unanimous
                    -

                    permiten el acceso sólo si ninguno de los votantes niega el acceso;

                    -
                    -
                    -
                    • -
                  -
                  use Symfony\Component\Security\Core\Authorization\AccessDecisionManager;
-
-// instancias de
-// Symfony\Component\Security\Core\Authorization\Voter\VoterInterface
-$voters = array(...);
-
-// uno de "affirmative", "consensus", "unanimous"
-$strategy = ...;
-
-// si o no conceder acceso cuando todos los votantes se abstienen
-$allowIfAllAbstainDecisions = ...;
-
-// Si o no conceder el acceso cuándo no hay mayoría
-// (aplica sólo a la estrategia de consenso)
-$allowIfEqualGrantedDeniedDecisions = ...;
-
-$accessDecisionManager = new AccessDecisionManager(
-    $voters,
-    $strategy,
-    $allowIfAllAbstainDecisions,
-    $allowIfEqualGrantedDeniedDecisions
-);
-
                  -
                  -
                  -
                  -

                  Votantes

                  -

                  Los votantes son instancias -de Symfony\Component\Security\Core\Authorization\Voter\VoterInterface, lo cual significa que tienen que implementar algunos métodos que permiten los utilice el gestor de decisión:

                  -
                    -
                  • -
                    supportsAttribute($attribute)
                    -

                    se utiliza para comprobar si el votante sabe cómo manejar el atributo dado;

                    -
                    -
                    -
                    • -
                  • -
                    supportsClass($class)
                    -

                    se utiliza para comprobar si el votante es capaz de conceder o denegar el acceso a un objeto de la clase dada;

                    -
                    -
                    -
                    • -
                  • -
                    vote(TokenInterface $token, $object, array $attributes)
                    -

                    Este método hará la votación propiamente dicha y devuelve un valor igual a una de las constantes de la clase Symfony\Component\Security\Core\Authorization\Voter\VoterInterface, es decir, VoterInterface::ACCESS_GRANTED, VoterInterface::ACCESS_DENIED o VoterInterface::ACCESS_ABSTAIN;

                    -
                    -
                    -
                    • -
                  -

                  El componente de seguridad contiene algunos votantes estándar que cubren muchos casos de uso:

                  -
                  -

                  AuthenticatedVoter

                  -

                  La clase votante Symfony\Component\Security\Core\Authorization\Voter\AuthenticatedVoter admite los atributos IS_AUTHENTICATED_FULLY, IS_AUTHENTICATED_REMEMBERED, e IS_AUTHENTICATED_ANONYMOUSLY y garantiza el acceso basado en el nivel de autenticación actual, es decir, ¿el usuario está autenticado completamente, o sólo en base a una galleta «recuérdame», o incluso autenticado anónimamente?

                  -
                  use Symfony\Component\Security\Core\Authentication\AuthenticationTrustResolver;
-
-$anonymousClass = 'Symfony\Component\Security\Core\Authentication\Token\AnonymousToken';
-$rememberMeClass = 'Symfony\Component\Security\Core\Authentication\Token\RememberMeToken';
-
-$trustResolver = new AuthenticationTrustResolver($anonymousClass, $rememberMeClass);
-
-$authenticatedVoter = new AuthenticatedVoter($trustResolver);
-
-// instancia de Symfony\Component\Security\Core\Authentication\Token\TokenInterface
-$token = ...;
-
-// algún objeto
-$object = ...;
-
-$vote = $authenticatedVoter->vote($token, $object, array('IS_AUTHENTICATED_FULLY');
-
                  -
                  -
                  -
                  -

                  RoleVoter

                  -

                  La clase Symfony\Component\Security\Core\Authorization\Voter\RoleVoter es compatible con atributos que empiezan con ROLE_ y conceden acceso al usuario cuándo todos los atributos ROLE_* requeridos se pueden encontrar en el arreglo de roles devuelto por el método getRoles():

                  -
                  use Symfony\Component\Security\Core\Authorization\Voter\RoleVoter;
-
-$roleVoter = new RoleVoter('ROLE_');
-
-$roleVoter->vote($token, $object, 'ROLE_ADMIN');
-
                  -
                  -
                  -
                  -

                  RoleHierarchyVoter

                  -

                  La clase Symfony\Component\Security\Core\Authorization\Voter\RoleHierarchyVoter extiende a Symfony\Component\Security\Core\Authorization\Voter\RoleVoter y proporciona alguna funcionalidad adicional: Esta sabe cómo manejar una jerarquía de roles. Por ejemplo, un rol ROLE_SUPER_ADMIN puede tener los subroles ROLE_ADMIN y ROLE_USER, de modo que cuando un determinado objeto requiere que el usuario tenga el rol ROLE_ADMIN, concede acceso a usuarios que de hecho tienen el rol ROLE_ADMIN, pero también a usuarios que tienen el rol ROLE_SUPER_ADMIN:

                  -
                  use Symfony\Component\Security\Core\Authorization\Voter\RoleHierarchyVoter;
-use Symfony\Component\Security\Core\Role\RoleHierarchy;
-
-$hierarchy = array(
-    'ROLE_SUPER_ADMIN' => array('ROLE_ADMIN', 'ROLE_USER'),
-);
-
-$roleHierarchy = new RoleHierarchy($hierarchy);
-
-$roleHierarchyVoter = new RoleHierarchyVoter($roleHierarchy);
-
                  -
                  -
                  -

                  Nota

                  -

                  Cuándo haces tu propio votante, naturalmente puedes utilizar su constructor para inyectar cualquier dependencia necesaria para tomar una decisión.

                  -
                  -
                  -
                  -
                  -

                  Roles

                  -

                  Los roles son objetos que expresan un determinado derecho que tiene el usuario. -El único requisito es que implementen la Symfony\Component\Security\Core\Role\RoleInterface, lo cual significa también que deberían tener un método getRole() que regrese una cadena representando su rol. La clase Symfony\Component\Security\Core\Role\Role simplemente devuelve el primer argumento del constructor:

                  -
                  use Symfony\Component\Security\Core\Role\Role;
-
-$role = new Role('ROLE_ADMIN');
-
-// hará eco de 'ROLE_ADMIN'
-echo $role->getRole();
-
                  -
                  -
                  -

                  Nota

                  -

                  La mayoría de las fichas de autenticación extienden la clase Symfony\Component\Security\Core\Authentication\Token\AbstractToken, lo cual significa que los roles dados a su constructor serán convertidos automáticamente de cadenas a estos sencillos objetos Role.

                  -
                  -
                  -
                  -

                  Usando el gestor de decisión

                  -
                  -

                  El escucha de acceso

                  -

                  El gestor de decisión de acceso se puede utilizar en cualquier punto en una petición para decidir si o no el usuario actual tiene derecho para acceder a un determinado recurso. Un opcional —pero útil— método para restringir el acceso basándose en un patrón de URL es el Symfony\Component\Security\Http\Firewall\AccessListener, el cual es uno de los escuchas del cortafuegos (ve Escuchas del cortafuegos) que es lanzado en cada petición que coincide con el cortafuegos asociado (ve Un cortafuegos para peticiones HTTP).

                  -

                  Este utiliza un mapa de acceso (el cuál debería ser una instancia de la Symfony\Component\Security\Http\AccessMapInterface) que contiene la petición y el conjunto de atributos correspondiente necesarios para que el usuario actual consiga acceso a la aplicación:

                  -
                  use Symfony\Component\Security\Http\AccessMap;
-use Symfony\Component\HttpFoundation\RequestMatcher;
-use Symfony\Component\Security\Http\Firewall\AccessListener;
-
-$accessMap = new AccessMap();
-$requestMatcher = new RequestMatcher('^/admin');
-$accessMap->add($requestMatcher, array('ROLE_ADMIN'));
-
-$accessListener = new AccessListener(
-    $securityContext,
-    $accessDecisionManager,
-    $accessMap,
-    $authenticationManager
-);
-
                  -
                  -
                  -
                  -

                  Contexto de seguridad

                  -

                  El gestor de decisión de acceso también está disponible en otras partes de la aplicación vía el método isGranted() de la clase Symfony\Component\Security\Core\SecurityContext. -Una llamada a este método delegará la cuestión directamente al gestor de decisión de acceso:

                  -
                  use Symfony\Component\Security\SecurityContext;
-use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-
-$securityContext = new SecurityContext(
-    $authenticationManager,
-    $accessDecisionManager
-);
-
-if (!$securityContext->isGranted('ROLE_ADMIN')) {
-    throw new AccessDeniedException();
-}
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/security/firewall.html b/components/security/firewall.html deleted file mode 100644 index d8f96fb..0000000 --- a/components/security/firewall.html +++ /dev/null @@ -1,215 +0,0 @@ - - - - - - - Cortafuegos y el contexto de seguridad — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cortafuegos y el contexto de seguridad

                  -

                  Una parte central del componente de seguridad es el contexto de seguridad, el cual es una instancia de la clase Symfony\Component\Security\Core\SecurityContextInterface. Cuando todos los pasos en el proceso de autenticar al usuario han sido exitosos, puedes preguntar al contexto de seguridad si el usuario autenticado tiene acceso a una determinada acción o recurso de la aplicación:

                  -
                  use Symfony\Component\Security\SecurityContext;
-use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-
-$securityContext = new SecurityContext();
-
-// ... autentifica al usuario
-
-if (!$securityContext->isGranted('ROLE_ADMIN')) {
-    throw new AccessDeniedException();
-}
-
                  -
                  -
                  -

                  Un cortafuegos para peticiones HTTP

                  -

                  La autenticación de un usuario se hizo para el cortafuegos. Una aplicación puede tener múltiples áreas protegidas, así que el cortafuegos está configurado utilizando un mapa de estas áreas protegidas. Para cada una de estas áreas, el mapa contiene un emparejador con la petición y una colección de escuchas. El emparejador de petición da al cortafuegos la habilidad de descubrir si la petición actual apunta a una área protegida. -Los escuchas entonces son consultados para ver si se puede usar la petición actual para autenticar al usuario:

                  -
                  use Symfony\Component\Security\Http\FirewallMap;
-use Symfony\Component\HttpFoundation\RequestMatcher;
-use Symfony\Component\Security\Http\Firewall\ExceptionListener;
-
-$map = new FirewallMap();
-
-$requestMatcher = new RequestMatcher('^/secured-area/');
-
-// instancias de
-// Symfony\Component\Security\Http\Firewall\ListenerInterface
-$listeners = array(...);
-
-$exceptionListener = new ExceptionListener(...);
-
-$map->add($requestMatcher, $listeners, $exceptionListener);
-
                  -
                  -

                  El mapa del cortafuegos será asociado al cortafuegos como su primer argumento, junto con el despachador de eventos utilizado por la clase Symfony\Component\HttpKernel\HttpKernel:

                  -
                  use Symfony\Component\Security\Http\Firewall;
-use Symfony\Component\HttpKernel\KernelEvents;
-
-// el EventDispatcher usado por el HttpKernel
-$dispatcher = ...;
-
-$firewall = new Firewall($map, $dispatcher);
-
-$dispatcher->addListener(KernelEvents::REQUEST,
-                         array($firewall,
-                               'onKernelRequest'
-             ));
-
                  -
                  -

                  El cortafuegos es registrado para escuchar el evento kernel.request que será despachado por el HttpKernel al principio de cada petición procesada. De este modo, el cortafuegos puede impedir al usuario ir más allá de dónde tiene permitido.

                  -
                  -

                  Escuchas del cortafuegos

                  -

                  Cuándo el cortafuegos es notificado del evento kernel.request, este consulta el mapa del cortafuegos para ver si la petición coincide con una de las áreas protegidas. La primer área protegida que coincide con la petición regresará el correspondiente conjunto de escuchas del cortafuegos (el cual implementa la Symfony\Component\Security\Http\Firewall\ListenerInterface). -Todos estos escuchas serán consultados para manejar la petición actual. Esto básicamente significa: descubrir si la petición actual contiene alguna información por medio de la cual se podría autenticar al usuario (para casos de autenticación HTTP básicos el escucha comprueba si la petición tiene una cabecera llamada PHP_AUTH_USER).

                  -
                  -
                  -

                  Escucha de excepciones

                  -

                  Si cualquiera de los escuchas lanza una Symfony\Component\Security\Core\Exception\AuthenticationException, el escucha de la excepción proporcionado al añadir las áreas protegidas saltará al mapa del cortafuegos.

                  -

                  El escucha de la excepción determina qué pasa luego, basándose en los argumentos recibidos al crearlo. Este puede empezar el procedimiento de autenticación, quizás —nuevamente— haciendo que el usuario suministre sus credenciales (cuándo sólo ha sido -autenticado basándose en una galleta «recuérdame»), o transformando la excepción a una clase Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException, la cual finalmente resulta en una «respuesta 403 de HTTP/1.1: Acceso denegado».

                  -
                  -
                  -

                  Puntos de entrada

                  -

                  Cuándo el usuario no es autenticado en absoluto (es decir, cuándo el contexto de seguridad -no tiene ficha todavía), el punto de entrada del cortafuegos será llamado para que «empiece» -el proceso de autenticación. Un punto de entrada debería implementar Symfony\Component\Security\Http\EntryPoint\AuthenticationEntryPointInterface, la cual sólo tiene un método: start(). -Este método recibe el objeto Symfony\Component\HttpFoundation\Request actual y la excepción por la cual el escucha de excepciones fue lanzado. -El método debería regresar un objeto Symfony\Component\HttpFoundation\Response. Este podría ser, por ejemplo, la página que contiene el formulario de inicio de sesión o, en el caso de autenticación HTTP básica, una respuesta con la cabecera WWW-Authenticate, la cual hará que el usuario suministre su nombre de usuario y contraseña.

                  -
                  -
                  -
                  -

                  Flujo: cortafuegos, autenticación, autorización

                  -

                  Con algo de suerte, ahora puedes ver un poco de cómo «fluye» el trabajo del contexto de seguridad:

                  -
                    -
                  1. El cortafuegos es registrado como escucha en el evento kernel.request;
                    2. -
                  2. Al principio de la petición, el cortafuegos comprueba el mapa del cortafuegos para ver si algún cortafuegos debería estar activo para esa URL;
                    3. -
                  3. Si se encontró un cortafuegos en el mapa para esta URL, sus escuchas son notificados
                    4. -
                  4. Cada escucha comprueba si la petición actual contiene alguna información de autenticación —un escucha puede (a) autenticar un usuario, (b) lanzar una AuthenticationException, o (c) no hacer nada (porque no hay información de autenticación en la petición);
                    5. -
                  5. Una vez autenticado un usuario, utilizarás la Autorización para denegar el acceso a determinados recursos.
                    6. -
                  -

                  Lee las siguientes secciones para descubrir más sobre Autenticación y Autorización.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/security/index.html b/components/security/index.html deleted file mode 100644 index fc06510..0000000 --- a/components/security/index.html +++ /dev/null @@ -1,158 +0,0 @@ - - - - - - - Seguridad — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/security/introduction.html b/components/security/introduction.html deleted file mode 100644 index 2d89637..0000000 --- a/components/security/introduction.html +++ /dev/null @@ -1,155 +0,0 @@ - - - - - - - El componente Security — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Security

                  -
                  -

                  Introducción

                  -

                  El componente Security proporciona un sistema de seguridad completo para tu aplicación web. Este viene con utilerías para autentificar usando autenticación HTTP básica o por medio de suma de comprobación, inicio de sesión interactivo o con certificado X.509, pero también te permite implementar tus propias estrategias de autenticación. -Además, el componente proporciona maneras de autorizar usuarios autenticados -basándose en sus roles, y contiene un avanzado sistema ACL.

                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/serializer.html b/components/serializer.html deleted file mode 100644 index ca4fc78..0000000 --- a/components/serializer.html +++ /dev/null @@ -1,233 +0,0 @@ - - - - - - - El componente Serializer — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Serializer

                  -
                  -
                  El componente Serializer se pretende sea utilizado para convertir objetos a un formato específico (XML, JSON, Yaml, ...) y a la inversa.
                  -

                  Para ello, el componente Serializer sigue el siguiente sencillo esquema.

                  -../_images/serializer_workflow.png -

                  Como puedes ver en la imagen anterior, se utiliza un arreglo como un hombre en -el medio. De este modo, los codificadores sólo tratarán convirtiendo formatos específicos en arreglos y viceversa. Del mismo modo, los normalizadores tratarán cambiando objetos específicos en arreglos y viceversa.

                  -

                  La serialización es un tema complicado, y a pesar de que este componente no puede trabajar en todos los casos, puede ser una útil herramienta mientras desarrollas herramientas para serializar y deserializar tus objetos.

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  Utilizar el componente Serializer es realmente sencillo. Sólo necesitas instalar la clase Symfony\Component\Serializer\Serializer especificando qué codificadores y normalizadores van a estar disponibles:

                  -
                  use Symfony\Component\Serializer\Serializer;
-use Symfony\Component\Serializer\Encoder\XmlEncoder;
-use Symfony\Component\Serializer\Encoder\JsonEncoder;
-use Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer;
-
-$encoders = array(new XmlEncoder(), new JsonEncoder());
-$normalizers = array(new GetSetMethodNormalizer());
-
-$serializer = new Serializer($normalizers, $encoders);
-
                  -
                  -
                  -

                  Serializando un objeto

                  -

                  Por el bien de este ejemplo, supongamos que la siguiente clase ya existe en tu proyecto:

                  -
                  namespace Acme;
-
-class Person
-{
-    private $age;
-    private $name;
-
-    // Captadores
-    public function getName()
-    {
-        return $this->name;
-    }
-
-    public function getAge()
-    {
-        return $this->age;
-    }
-
-    // Definidores
-    public function setName($name)
-    {
-        $this->name = $name;
-    }
-
-    public function setAge($age)
-    {
-        $this->age = $age;
-    }
-}
-
                  -
                  -

                  Ahora, si queremos serializar este objeto a JSON, sólo necesitamos utilizar el servicio Serializer creado anteriormente:

                  -
                  $person = new Acme\Person();
-$person->setName('foo');
-$person->setAge(99);
-
-$jsonContent = $serializer->serialize($person, 'json');
-
-// $jsonContent contains {"name":"foo","age":99}
-
-echo $jsonContent; // or return it in a Response
-
                  -
                  -

                  El primer argumento del método serialize() es el objeto a serializar y el segundo suele escoger el codificador apropiado, en este caso Symfony\Component\Serializer\Encoder\JsonEncoder.

                  -
                  -
                  -

                  Deserializando un Objeto

                  -

                  Ahora veremos cómo hacer exactamente lo opuesto. Esta vez, la información de la clase Personas estaría codificada en formato XML:

                  -
                  $data = <<<EOF
-<person>
-    <name>foo</name>
-    <age>99</age>
-</person>
-EOF;
-
-$person = $serializer->deserialize($data,'Acme\Person','xml');
-
                  -
                  -

                  En este caso, el método deserialize() necesita tres argumentos:

                  -
                    -
                  1. La información a descodificar
                    2. -
                  2. El nombre de la clase a la que esta información será descodificada
                    3. -
                  3. El codificador a utilizar para convertir esa información a un arreglo
                    4. -
                  -
                  -
                  -
                  -

                  JMSSerializer

                  -

                  Una popular biblioteca de terceros, JMS serializer, proporciona una solución más sofisticada aunque más compleja. Esta biblioteca incluye la habilidad para configurar cómo se deberían serializar/deserializar tus objetos a través de anotaciones (así como YML, XML y PHP), integrarlos con el ORM de Doctrine, y manejar otros casos complejos (p. ej. en referencias circulares).

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/stopwatch.html b/components/stopwatch.html deleted file mode 100644 index bd9253d..0000000 --- a/components/stopwatch.html +++ /dev/null @@ -1,216 +0,0 @@ - - - - - - - El componente Stopwatch — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Stopwatch

                  -
                  -
                  El componente Stopwatch proporciona una manera para codificar el perfil.
                  -

                  -Nuevo en la versión 2.2: El componente Stopwatch es nuevo en Symfony 2.2. Anteriormente, la clase Stopwatch estaba localizada en el componente HttpKernel (y era nueva en 2.1).

                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente en dos diferentes maneras:

                  - -
                  -
                  -

                  Usando

                  -

                  El el componente stopwatch proporciona una manera fácil y coherente para medir el tiempo de ejecución de ciertas partes de código a modo de que no tengas que analizar la duración de algo. En cambio, usas la sencilla clase Symfony\Component\Stopwatch\Stopwatch:

                  -
                  use Symfony\Component\Stopwatch\Stopwatch;
-
-$stopwatch = new Stopwatch();
-// Inicia el evento llamado 'eventName'
-$stopwatch->start('eventName');
-// ... aquí va algún código
-$event = $stopwatch->stop('eventName');
-
                  -
                  -

                  También puedes proporcionar un nombre de categoría a un evento:

                  -
                  $stopwatch->start('eventName', 'categoryName');
-
                  -
                  -

                  Puedes considerar a las categorías como una conveniente manera de etiquetar eventos. Por ejemplo, la herramienta del perfilador de Symfony usa categorías para codificar coloridamente diferentes eventos.

                  -
                  -
                  -

                  Periodos

                  -

                  Como sabes del mundo real, todos los cronómetros vienen con dos botones. -Uno para arrancar y detener el cronómetro, otro para medir el tiempo transcurrido. -Esto exactamente es lo que hace el método lap():

                  -
                  $stopwatch = new Stopwatch();
-// Inicia el evento llamado 'foo'
-$stopwatch->start('foo');
-// ... aquí va algún código
-$stopwatch->lap('foo');
-// ... aquí va algún código
-$stopwatch->lap('foo');
-// ... aquí va algún otro código
-$event = $stopwatch->stop('foo');
-
                  -
                  -

                  La información del lapso se almacena como «periodos» en el evento. Para obtener dicha información llama a:

                  -
                  $event->getPeriods();
-
                  -
                  -

                  Además de obtener los periodos, puedes conseguir otra útil información del objeto evento. -Por ejemplo:

                  -
                  $event->getCategory();      // Devuelve la categoría en que se inició el evenento
-$event->getOrigin();        // Devuelve el lapso transcurrido desde que se inicio
-// el evento en milisegundos
-$event->ensureStopped();    // Detiene todos los periodos que no se han detenido ya
-$event->getStartTime();     // Regresa el inicio del primer periodo
-$event->getEndTime();       // Regresa el tiempo final del último periodo
-$event->getDuration();      // Obtiene la duración del evento incluyendo todos los
-// periodos
-$event->getMemory();        // Devuelve el máximo uso de memoria de todos los periodos
-
                  -
                  -
                  -
                  -

                  Secciones

                  -

                  Las secciones son una manera de dividir lógicamente la cronología en grupos. Puedes ver cómo usa Symfony las secciones visualizando agradablemente el ciclo de vida con -la herramienta perfiladora de Symfony. Aquí tienes un ejemplo del uso básico de las secciones:

                  -
                  $stopwatch = new Stopwatch();
-
-$stopwatch->openSection();
-$stopwatch->start('parsing_config_file', 'filesystem_operations');
-$stopwatch->stopSection('routing');
-
-$events = $stopwatch->getSectionEvents('routing');
-
                  -
                  -

                  You can reopen a closed section by calling the openSection`() -method and specifying the id of the section to be reopened:

                  -
                  $stopwatch->openSection('routing');
-$stopwatch->start('building_config_tree');
-$stopwatch->stopSection('routing');
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/templating.html b/components/templating.html deleted file mode 100644 index f7e2e16..0000000 --- a/components/templating.html +++ /dev/null @@ -1,216 +0,0 @@ - - - - - - - El componente Templating — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente Templating

                  -
                  -

                  El componente Templating proporciona todas las herramientas necesarias para construir cualquier tipo de sistema de plantillas.

                  -

                  Este proporciona una infraestructura para cargar los archivos de plantilla y opcionalmente controlar sus cambios. También proporciona una implementación del motor de plantillas concreto usando PHP con herramientas adicionales para escapar y separar plantillas en bloques y diseños.

                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  Usando

                  -

                  La clase Symfony\Component\Templating\PhpEngine es el punto de entrada del componente. Este necesita un analizador de nombres de plantilla (Symfony\Component\Templating\TemplateNameParserInterface) para convertir un nombre de plantilla a una referencia a la plantilla y cargador de plantilla (Symfony\Component\Templating\Loader\LoaderInterface) para encontrar la plantilla asociada a una referencia:

                  -
                  use Symfony\Component\Templating\PhpEngine;
-use Symfony\Component\Templating\TemplateNameParser;
-use Symfony\Component\Templating\Loader\FilesystemLoader;
-
-$loader = new FilesystemLoader(__DIR__ . '/views/%name%');
-
-$view = new PhpEngine(new TemplateNameParser(), $loader);
-
-echo $view->render('hello.php', array('firstname' => 'Fabien'));
-
                  -
                  -

                  El método render() ejecuta el archivo -views/hello.php y devuelve el texto producido.

                  -
                  <!-- views/hello.php -->
-Hello, <?php echo $firstname ?>!
-
                  -
                  -
                  -
                  -

                  Herencia de plantillas con ranuras

                  -

                  La herencia de plantillas está diseñada para compartir diseños con muchas plantillas.

                  -
                  <!-- views/layout.php -->
-    <html>
-        <head>
-        <title><?php $view['slots']->output('title', 'Default title') ?></title>
-        </head>
-        <body>
-        <?php $view['slots']->output('_content') ?>
-    </body>
-</html>
-
                  -
                  -

                  El método extend() es llamado en la subplantilla para definir la plantilla padre.

                  -
                  <!-- views/page.php -->
-<?php $view->extend('layout.php') ?>
-
-<?php $view['slots']->set('title', $page->title) ?>
-
-<h1>
-    <?php echo $page->title ?>
-</h1>
-<p>
-    <?php echo $page->body ?>
-</p>
-
                  -
                  -

                  Para usar la herencia de plantillas, debes registrar la clase ayudante Symfony\Component\Templating\Helper\SlotsHelper:

                  -
                  use Symfony\Component\Templating\Helper\SlotsHelper;
-
-$view->set(new SlotsHelper());
-
-// Retrieve page object
-$page = ...;
-
-echo $view->render('page.php', array('page' => $page));
-
                  -
                  -
                  -

                  Nota

                  -

                  Es posible la herencia multinivel: un diseño puede extender a otro.

                  -
                  -
                  -
                  -

                  Mecanismo de escape

                  -

                  Esta documentación todavía se está escribiendo.

                  -
                  -
                  -

                  El ayudante Asset

                  -

                  Esta documentación todavía se está escribiendo.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/using_components.html b/components/using_components.html deleted file mode 100644 index 3ffa010..0000000 --- a/components/using_components.html +++ /dev/null @@ -1,196 +0,0 @@ - - - - - - - Cómo instalar y usar componentes de Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  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!

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/yaml.html b/components/yaml.html deleted file mode 100644 index db4dde3..0000000 --- a/components/yaml.html +++ /dev/null @@ -1,467 +0,0 @@ - - - - - - - El componente YAML — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente YAML

                  -
                  -
                  El componente YAML carga y vuelca archivos YAML.
                  -
                  -

                  ¿Qué es entonces?

                  -

                  El componente YAML de Symfony2 analiza cadenas YAML para convertirlas en arreglos PHP. -También es capaz de convertir arreglos PHP a cadenas YAML.

                  -

                  YAML, YAML no es un lenguaje de marcado, es un estándar para la serialización de datos amigable con los humanos para todos los lenguajes de programación. YAML es un formato ideal para tus archivos de configuración. Los archivos YAML son tan expresivos como los archivos XML y tan fáciles de leer como los archivos INI.

                  -

                  El componente YAML de Symfony2 implementa la versión 1.2 de la -especificación YAML.

                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  ¿Por qué?

                  -
                  -

                  Rapidez

                  -

                  Uno de los objetivos del componente YAML de Symfony es encontrar el balance adecuado entre características y velocidad. Es compatible con las características necesarias para manipular archivos de configuración.

                  -
                  -
                  -

                  Analizador real

                  -

                  Este exporta un analizador real y es capaz de analizar un gran subconjunto de especificaciones YAML, para todas tus necesidades de configuración. También significa que el analizador es bastante robusto, fácil de entender, y lo suficientemente simple como para ampliarlo.

                  -
                  -
                  -

                  Borrando mensajes de error

                  -

                  Cada vez que tienes un problema de sintaxis con tus archivos YAML, la biblioteca genera un útil mensaje de ayuda con el nombre y número de línea donde está el problema. Lo cual facilita mucho la depuración.

                  -
                  -
                  -

                  Compatibilidad con el volcado

                  -

                  También es capaz de volcar arreglos de PHP a YAML con apoyo a objetos, y el nivel de configuración en línea es bastante bueno.

                  -
                  -
                  -

                  Compatibilidad de tipos

                  -

                  Es compatible con la mayoría de los tipos YAML integrados como fechas, números enteros, octales, booleanos, y mucho más...

                  -
                  -
                  -

                  Completa compatibilidad con la fusión de claves

                  -

                  Completa compatibilidad para referencias, alias y completa fusión de claves. No repitas tú mismo haciendo referencia a segmentos de configuración comunes.

                  -
                  -
                  -
                  -

                  Utilizando el componente YAML de Symfony2

                  -

                  El componente YAML de Symfony2 es muy simple y consiste de dos clases principales: -una analiza cadenas YAML (Symfony\Component\Yaml\Parser), y la otra -vuelca un array PHP en una cadena YAML (Symfony\Component\Yaml\Dumper).

                  -

                  Además de estas dos clases, la clase Symfony\Component\Yaml\Yaml actúa como un delgado contenedor que simplifica los usos más comunes.

                  -
                  -

                  Leyendo archivos YAML

                  -

                  El método parse() analiza una cadena YAML y la convierte en un arreglo PHP:

                  -
                  use Symfony\Component\Yaml\Parser;
-
-$yaml = new Parser();
-
-$value = $yaml->parse(file_get_contents('/path/to/file.yml'));
-
                  -
                  -

                  Si ocurre un error durante el análisis, el analizador lanza una excepción Symfony\Component\Yaml\Exception\ParseException que indica el tipo de error y la línea en la cadena YAML original en la que ocurrió el error:

                  -
                  use Symfony\Component\Yaml\Exception\ParseException;
-
-try {
-    $value = $yaml->parse(file_get_contents('/path/to/file.yml'));
-} catch (ParseException $e) {
-    printf("Unable to parse the YAML string: %s", $e->getMessage());
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Debido a que el analizador es reentrante, puedes utilizar el mismo objeto analizador para cargar diferentes cadenas YAML.

                  -
                  -

                  Al cargar un archivo YAML, a veces es mejor usar el contenedor del método parse():

                  -
                  use Symfony\Component\Yaml\Yaml;
-
-$yaml = Yaml::parse('/path/to/file.yml');
-
                  -
                  -

                  El método estático parse() toma una cadena YAML o un archivo que contiene YAML. Internamente, llama al método parse(), pero mejora el error si algo sale mal, añadiendo el nombre del archivo al mensaje.

                  -
                  -
                  -

                  Ejecutando PHP dentro de los archivos YAML

                  -

                  -Nuevo en la versión 2.1: El método Yaml::enablePhpParsing() es nuevo en Symfony 2.1. Antes de 2.1, PHP siempre se ejecuta al llamar a la función parse().

                  -

                  De manera predeterminada, si incluyes PHP dentro de un archivo YAML, no se va a analizar. -Si quiere que PHP se analice, debes llamar a Yaml::enablePhpParsing() antes de analizar el archivo para activar ese modo. Si sólo deseas permitir código PHP para un único archivo YAML, asegúrate de desactivar el intérprete PHP después de analizar ese archivo llamando a Yaml::$enablePhpParsing = false;, ($enablePhpParsing es una propiedad pública).

                  -
                  -
                  -

                  Escribiendo archivos YAML

                  -

                  El método dump() vuelca cualquier arreglo PHP en su representación YAML:

                  -
                  use Symfony\Component\Yaml\Dumper;
-
-$array = array(
-    'foo' => 'bar',
-    'bar' => array('foo' => 'bar', 'bar' => 'baz')
-);
-
-$dumper = new Dumper();
-
-$yaml = $dumper->dump($array);
-
-file_put_contents('/path/to/file.yml', $yaml);
-
                  -
                  -
                  -

                  Nota

                  -

                  Por supuesto, el vertedor YAML de Symfony2 no es capaz de volcar recursos. Por otra parte, aun y cuando el vertedor es capaz de volcar objetos PHP, se considera como una función No admitida.

                  -
                  -

                  Si ocurre un error durante el volcado, el analizador lanza una excepción Symfony\Component\Yaml\Exception\DumpException.

                  -

                  Si sólo necesitas volcar un arreglo, puedes utilizar el método estático dump():

                  -
                  use Symfony\Component\Yaml\Yaml;
-
-$yaml = Yaml::dump($array, $inline);
-
                  -
                  -

                  El formato YAML admite dos tipos de representación de arreglos, la ampliada, y en línea. Por omisión, el vertedor utiliza la representación en línea:

                  -
                  { foo: bar, bar: { foo: bar, bar: baz } }
-
                  -
                  -

                  El segundo argumento del método dump() personaliza el nivel en el cual el resultado cambia de la representación ampliada a en línea:

                  -
                  echo $dumper->dump($array, 1);
-
                  -
                  -
                  foo: bar
-bar: { foo: bar, bar: baz }
-
                  -
                  -
                  echo $dumper->dump($array, 2);
-
                  -
                  -
                  foo: bar
-bar:
-    foo: bar
-    bar: baz
-
                  -
                  -
                  -
                  -
                  -

                  El formato YAML

                  -

                  El sitio web de YAML dice que es «un estándar para la serialización de datos humanamente legibles para todos los lenguajes de programación».

                  -

                  Si bien el formato YAML puede describir complejas estructuras de datos anidadas, este capítulo sólo describe el conjunto mínimo de características necesarias para usar YAML como un formato de archivo de configuración.

                  -

                  YAML es un lenguaje simple que describe datos. Como PHP, que tiene una sintaxis para tipos simples, como cadenas, booleanos, números en punto flotante, o enteros. Pero a diferencia de PHP, este distingue entre arreglos (secuencias) y hashes (asignaciones).

                  -
                  -

                  Escalares

                  -

                  La sintaxis para escalares es similar a la sintaxis de PHP.

                  -
                  -

                  Cadenas

                  -
                  Una cadena en YAML
-
                  -
                  -
                  'Una cadena entre comillas simples en YAML'
-
                  -
                  -
                  -

                  Truco

                  -

                  En una cadena entre comillas simples, una comilla simple ' debe ser doble:

                  -
                  'Una comilla simple '' en una cadena entre comillas simples'
-
                  -
                  -
                  -
                  "Una cadena entre comillas dobles en YAML\n"
-
                  -
                  -

                  Los estilos de citado son útiles cuando una cadena empieza o termina con uno o más espacios relevantes.

                  -
                  -

                  Truco

                  -

                  El estilo entre comillas dobles proporciona una manera de expresar cadenas arbitrarias, utilizando secuencias de escape \. Es muy útil cuando se necesita incrustar un \n o un carácter Unicode en una cadena.

                  -
                  -

                  Cuando una cadena contiene saltos de línea, puedes usar el estilo literal, indicado por la línea vertical (|), para indicar que la cadena abarcará varias líneas. En literales, se conservan los saltos de línea:

                  -
                  |
-  \/ /| |\/| |
-  / / | |  | |__
-
                  -
                  -

                  Alternativamente, puedes escribir cadenas con el estilo de plegado, denotado por >, en el cual cada salto de línea es sustituido por un espacio:

                  -
                  >
-  Esta es una oración muy larga
-  que se extiende por varias líneas en el YAML
-  pero que se reproduce como una cadena
-  sin retornos de carro.
-
                  -
                  -
                  -

                  Nota

                  -

                  Observa los dos espacios antes de cada línea en los ejemplos anteriores. Ellos no aparecen en las cadenas PHP resultantes.

                  -
                  -
                  -
                  -

                  Números

                  -
                  # un entero
-12
-
                  -
                  -
                  # un octal
-014
-
                  -
                  -
                  # un hexadecimal
-0xC
-
                  -
                  -
                  # un float
-13.4
-
                  -
                  -
                  # un número exponencial
-1.2e+34
-
                  -
                  -
                  # infinito
-.inf
-
                  -
                  -
                  -
                  -

                  Nulos

                  -

                  Los nulos en YAML se pueden expresar con null o ~.

                  -
                  -
                  -

                  Booleanos

                  -

                  Los booleanos en YAML se expresan con true y false.

                  -
                  -
                  -

                  Fechas

                  -

                  YAML utiliza la norma ISO-8601 para expresar fechas:

                  -
                  2001-12-14t21:59:43.10-05:00
-
                  -
                  -
                  # fecha simple
-2002-12-14
-
                  -
                  -
                  -
                  -
                  -

                  Colecciones

                  -

                  Rara vez se utiliza un archivo YAML para describir un simple escalar. La mayoría de las veces, describe una colección. Una colección puede ser una secuencia o una asignación de elementos. Ambas, secuencias y asignaciones se convierten en arreglos PHP.

                  -

                  Las secuencias usan un guión seguido por un espacio:

                  -
                  - PHP
-- Perl
-- Python
-
                  -
                  -

                  El archivo YAML anterior es equivalente al siguiente código PHP:

                  -
                  array('PHP', 'Perl', 'Python');
-
                  -
                  -

                  La asignación utiliza dos puntos seguidos por un espacio (: ) para marcar cada par clave/valor:

                  -
                  PHP: 5.2
-MySQL: 5.1
-Apache: 2.2.20
-
                  -
                  -

                  el cual es equivalente a este código PHP:

                  -
                  array('PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20');
-
                  -
                  -
                  -

                  Nota

                  -

                  En una asignación, una clave puede ser cualquier escalar válido.

                  -
                  -

                  El número de espacios entre los dos puntos y el valor no importa:

                  -
                  PHP:    5.2
-MySQL:  5.1
-Apache: 2.2.20
-
                  -
                  -

                  YAML utiliza sangría con uno o más espacios para describir colecciones anidadas:

                  -
                  "symfony 1.0":
-  PHP:    5.0
-  Propel: 1.2
-"symfony 1.2":
-  PHP:    5.2
-  Propel: 1.3
-
                  -
                  -

                  El YAML anterior es equivalente al siguiente código PHP:

                  -
                  array(
-  'symfony 1.0' => array(
-    'PHP'    => 5.0,
-    'Propel' => 1.2,
-  ),
-  'symfony 1.2' => array(
-    'PHP'    => 5.2,
-    'Propel' => 1.3,
-  ),
-);
-
                  -
                  -

                  Hay una cosa importante que tienes que recordar cuando utilices sangría en un archivo YAML: La sangría se debe hacer con uno o más espacios, pero nunca con tabulaciones.

                  -

                  Puedes anidar secuencias y asignaciones a tu gusto:

                  -
                  'Chapter 1':
-  - Introduction
-  - Event Types
-'Chapter 2':
-  - Introduction
-  - Helpers
-
                  -
                  -

                  YAML también puede utilizar estilos de flujo para colecciones, utilizando indicadores explícitos en lugar de sangría para denotar el alcance.

                  -

                  Puedes escribir una secuencia como una lista separada por comas entre corchetes ([]):

                  -
                  [PHP, Perl, Python]
-
                  -
                  -

                  Una asignación se puede escribir como una lista separada por comas de clave/valores dentro de llaves ({}):

                  -
                  { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
-
                  -
                  -

                  Puedes mezclar y combinar estilos para conseguir mejor legibilidad:

                  -
                  'Chapter 1': [Introduction, Event Types]
-'Chapter 2': [Introduction, Helpers]
-
                  -
                  -
                  "symfony 1.0": { PHP: 5.0, Propel: 1.2 }
-"symfony 1.2": { PHP: 5.2, Propel: 1.3 }
-
                  -
                  -
                  -
                  -

                  Comentarios

                  -

                  En YAML puedes añadir comentarios anteponiendo una almohadilla (#):

                  -
                  # Comentario en una línea
-"symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comentario al final de una línea
-"symfony 1.2": { PHP: 5.2, Propel: 1.3 }
-
                  -
                  -
                  -

                  Nota

                  -

                  Los comentarios simplemente son ignorados por el analizador de YAML y no es necesario sangrarlos de acuerdo al nivel de anidamiento actual de una colección.

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 24, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/yaml/index.html b/components/yaml/index.html deleted file mode 100644 index 5043904..0000000 --- a/components/yaml/index.html +++ /dev/null @@ -1,147 +0,0 @@ - - - - - - - Yaml — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/yaml/introduction.html b/components/yaml/introduction.html deleted file mode 100644 index 7446382..0000000 --- a/components/yaml/introduction.html +++ /dev/null @@ -1,271 +0,0 @@ - - - - - - - El componente YAML — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El componente YAML

                  -
                  -
                  El componente YAML carga y vuelca archivos YAML.
                  -
                  -

                  ¿Qué es entonces?

                  -

                  El componente YAML de Symfony2 analiza cadenas YAML para convertirlas en arreglos PHP. -También es capaz de convertir arreglos PHP a cadenas YAML.

                  -

                  YAML, YAML no es un lenguaje de marcado, es un estándar para la serialización de datos amigable con los humanos para todos los lenguajes de programación. YAML es un formato ideal para tus archivos de configuración. Los archivos YAML son tan expresivos como los archivos XML y tan fáciles de leer como los archivos INI.

                  -

                  El componente YAML de Symfony2 implementa la versión 1.2 de la -especificación YAML.

                  -
                  -

                  Truco

                  -

                  Aprende más sobre el componente Yaml en el artículo El formato YAML.

                  -
                  -
                  -
                  -

                  Instalando

                  -

                  Puedes instalar el componente de varias maneras diferentes:

                  - -
                  -
                  -

                  ¿Por qué?

                  -
                  -

                  Rapidez

                  -

                  Uno de los objetivos del componente YAML de Symfony es encontrar el balance adecuado entre características y velocidad. Es compatible con las características necesarias para manipular archivos de configuración.

                  -
                  -
                  -

                  Analizador real

                  -

                  Este exporta un analizador real y es capaz de analizar un gran subconjunto de especificaciones YAML, para todas tus necesidades de configuración. También significa que el analizador es bastante robusto, fácil de entender, y lo suficientemente simple como para ampliarlo.

                  -
                  -
                  -

                  Borrando mensajes de error

                  -

                  Cada vez que tienes un problema de sintaxis con tus archivos YAML, la biblioteca genera un útil mensaje de ayuda con el nombre y número de línea donde está el problema. Lo cual facilita mucho la depuración.

                  -
                  -
                  -

                  Compatibilidad con el volcado

                  -

                  También es capaz de volcar arreglos de PHP a YAML con apoyo a objetos, y el nivel de configuración en línea es bastante bueno.

                  -
                  -
                  -

                  Compatibilidad de tipos

                  -

                  Es compatible con la mayoría de los tipos YAML integrados como fechas, números enteros, octales, booleanos, y mucho más...

                  -
                  -
                  -

                  Completa compatibilidad con la fusión de claves

                  -

                  Completa compatibilidad para referencias, alias y completa fusión de claves. No repitas tú mismo haciendo referencia a segmentos de configuración comunes.

                  -
                  -
                  -
                  -

                  Utilizando el componente YAML de Symfony2

                  -

                  El componente YAML de Symfony2 es muy simple y consiste de dos clases principales: -una analiza cadenas YAML (Symfony\Component\Yaml\Parser), y la otra -vuelca un array PHP en una cadena YAML (Symfony\Component\Yaml\Dumper).

                  -

                  Además de estas dos clases, la clase Symfony\Component\Yaml\Yaml actúa como un delgado contenedor que simplifica los usos más comunes.

                  -
                  -

                  Leyendo archivos YAML

                  -

                  El método parse() analiza una cadena YAML y la convierte en un arreglo PHP:

                  -
                  use Symfony\Component\Yaml\Parser;
-
-$yaml = new Parser();
-
-$value = $yaml->parse(file_get_contents('/ruta/a/file.yml'));
-
                  -
                  -

                  Si ocurre un error durante el análisis, el analizador lanza una excepción Symfony\Component\Yaml\Exception\ParseException que indica el tipo de error y la línea en la cadena YAML original en la que ocurrió el error:

                  -
                  use Symfony\Component\Yaml\Exception\ParseException;
-
-try {
-    $value = $yaml->parse(file_get_contents('/ruta/a/file.yml'));
-} catch (ParseException $e) {
-    printf("Unable to parse the YAML string: %s", $e->getMessage());
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Debido a que el analizador es reentrante, puedes utilizar el mismo objeto analizador para cargar diferentes cadenas YAML.

                  -
                  -

                  Al cargar un archivo YAML, a veces es mejor usar el contenedor del método parse():

                  -
                  use Symfony\Component\Yaml\Yaml;
-
-$yaml = Yaml::parse('/ruta/a/file.yml');
-
                  -
                  -

                  El método estático parse() toma una cadena YAML o un archivo que contiene YAML. Internamente, llama al método parse(), pero mejora el error si algo sale mal, añadiendo el nombre del archivo al mensaje.

                  -
                  -
                  -

                  Escribiendo archivos YAML

                  -

                  El método dump() vuelca cualquier arreglo PHP en su representación YAML:

                  -
                  use Symfony\Component\Yaml\Dumper;
-
-$array = array(
-    'foo' => 'bar',
-    'bar' => array('foo' => 'bar', 'bar' => 'baz'),
-);
-
-$dumper = new Dumper();
-
-$yaml = $dumper->dump($array);
-
-file_put_contents('/ruta/a/file.yml', $yaml);
-
                  -
                  -
                  -

                  Nota

                  -

                  Por supuesto, el vertedor YAML de Symfony2 no es capaz de volcar recursos. Por otra parte, aun y cuando el vertedor es capaz de volcar objetos PHP, se considera como una función No admitida.

                  -
                  -

                  Si ocurre un error durante el volcado, el analizador lanza una excepción Symfony\Component\Yaml\Exception\DumpException.

                  -

                  Si sólo necesitas volcar un arreglo, puedes utilizar el método estático dump():

                  -
                  use Symfony\Component\Yaml\Yaml;
-
-$yaml = Yaml::dump($array, $inline);
-
                  -
                  -

                  El formato YAML admite dos tipos de representación de arreglos, la ampliada, y en línea. Por omisión, el vertedor utiliza la representación en línea:

                  -
                  { foo: bar, bar: { foo: bar, bar: baz } }
-
                  -
                  -

                  El segundo argumento del método dump() personaliza el nivel en el cual el resultado cambia de la representación ampliada a en línea:

                  -
                  echo $dumper->dump($array, 1);
-
                  -
                  -
                  foo: bar
-bar: { foo: bar, bar: baz }
-
                  -
                  -
                  echo $dumper->dump($array, 2);
-
                  -
                  -
                  foo: bar
-bar:
-    foo: bar
-    bar: baz
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/components/yaml/yaml_format.html b/components/yaml/yaml_format.html deleted file mode 100644 index 936e1b2..0000000 --- a/components/yaml/yaml_format.html +++ /dev/null @@ -1,325 +0,0 @@ - - - - - - - El formato YAML — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El formato YAML

                  -

                  El sitio web de YAML dice que es «un estándar para la serialización de datos humanamente legibles para todos los lenguajes de programación».

                  -

                  Si bien el formato YAML puede describir complejas estructuras de datos anidadas, este capítulo sólo describe el conjunto mínimo de características necesarias para usar YAML como un formato de archivo de configuración.

                  -

                  YAML es un lenguaje simple que describe datos. Como PHP, que tiene una sintaxis para tipos simples, como cadenas, booleanos, números en punto flotante, o enteros. Pero a diferencia de PHP, este distingue entre arreglos (secuencias) y hashes (asignaciones).

                  -
                  -

                  Escalares

                  -

                  La sintaxis para escalares es similar a la sintaxis de PHP.

                  -
                  -

                  Cadenas

                  -
                  Una cadena en YAML
-
                  -
                  -
                  'Una cadena entre comillas simples en YAML'
-
                  -
                  -
                  -

                  Truco

                  -

                  En una cadena entre comillas simples, una comilla simple ' debe ser doble:

                  -
                  'Una comilla simple '' en una cadena entre comillas simples'
-
                  -
                  -
                  -
                  "Una cadena entre comillas dobles en YAML\n"
-
                  -
                  -

                  Los estilos de citado son útiles cuando una cadena empieza o termina con uno o más espacios relevantes.

                  -
                  -

                  Truco

                  -

                  El estilo entre comillas dobles proporciona una manera de expresar cadenas arbitrarias, utilizando secuencias de escape \. Es muy útil cuando se necesita incrustar un \n o un carácter Unicode en una cadena.

                  -
                  -

                  Cuando una cadena contiene saltos de línea, puedes usar el estilo literal, indicado por la línea vertical (|), para indicar que la cadena abarcará varias líneas. En literales, se conservan los saltos de línea:

                  -
                  |
-  \/ /| |\/| |
-  / / | |  | |__
-
                  -
                  -

                  Alternativamente, puedes escribir cadenas con el estilo de plegado, denotado por >, en el cual cada salto de línea es sustituido por un espacio:

                  -
                  >
-  Esta es una oración muy larga
-  que se extiende por varias líneas en el YAML
-  pero que se reproduce como una cadena
-  sin retornos de carro.
-
                  -
                  -
                  -

                  Nota

                  -

                  Observa los dos espacios antes de cada línea en los ejemplos anteriores. Ellos no aparecen en las cadenas PHP resultantes.

                  -
                  -
                  -
                  -

                  Números

                  -
                  # un entero
-12
-
                  -
                  -
                  # un octal
-014
-
                  -
                  -
                  # un hexadecimal
-0xC
-
                  -
                  -
                  # un float
-13.4
-
                  -
                  -
                  # un número exponencial
-1.2e+34
-
                  -
                  -
                  # infinito
-.inf
-
                  -
                  -
                  -
                  -

                  Nulos

                  -

                  Los nulos en YAML se pueden expresar con null o ~.

                  -
                  -
                  -

                  Booleanos

                  -

                  Los booleanos en YAML se expresan con true y false.

                  -
                  -
                  -

                  Fechas

                  -

                  YAML utiliza la norma ISO-8601 para expresar fechas:

                  -
                  2001-12-14t21:59:43.10-05:00
-
                  -
                  -
                  # fecha simple
-2002-12-14
-
                  -
                  -
                  -
                  -

                  Colecciones

                  -

                  Rara vez se utiliza un archivo YAML para describir un simple escalar. La mayoría de las veces, describe una colección. Una colección puede ser una secuencia o una asignación de elementos. Ambas, secuencias y asignaciones se convierten en arreglos PHP.

                  -

                  Las secuencias usan un guión seguido por un espacio:

                  -
                  - PHP
-- Perl
-- Python
-
                  -
                  -

                  El archivo YAML anterior es equivalente al siguiente código PHP:

                  -
                  array('PHP', 'Perl', 'Python');
-
                  -
                  -

                  La asignación utiliza dos puntos seguidos por un espacio (: ) para marcar cada par clave/valor:

                  -
                  PHP: 5.2
-MySQL: 5.1
-Apache: 2.2.20
-
                  -
                  -

                  el cual es equivalente a este código PHP:

                  -
                  array('PHP' => 5.2, 'MySQL' => 5.1, 'Apache' => '2.2.20');
-
                  -
                  -
                  -

                  Nota

                  -

                  En una asignación, una clave puede ser cualquier escalar válido.

                  -
                  -

                  El número de espacios entre los dos puntos y el valor no importa:

                  -
                  PHP:    5.2
-MySQL:  5.1
-Apache: 2.2.20
-
                  -
                  -

                  YAML utiliza sangría con uno o más espacios para describir colecciones anidadas:

                  -
                  "symfony 1.0":
-  PHP:    5.0
-  Propel: 1.2
-"symfony 1.2":
-  PHP:    5.2
-  Propel: 1.3
-
                  -
                  -

                  El YAML anterior es equivalente al siguiente código PHP:

                  -
                  array(
-  'symfony 1.0' => array(
-    'PHP'    => 5.0,
-    'Propel' => 1.2,
-  ),
-  'symfony 1.2' => array(
-    'PHP'    => 5.2,
-    'Propel' => 1.3,
-  ),
-);
-
                  -
                  -

                  Hay una cosa importante que tienes que recordar cuando utilices sangría en un archivo YAML: La sangría se debe hacer con uno o más espacios, pero nunca con tabulaciones.

                  -

                  Puedes anidar secuencias y asignaciones a tu gusto:

                  -
                  'Chapter 1':
-  - Introduction
-  - Event Types
-'Chapter 2':
-  - Introduction
-  - Helpers
-
                  -
                  -

                  YAML también puede utilizar estilos de flujo para colecciones, utilizando indicadores explícitos en lugar de sangría para denotar el alcance.

                  -

                  Puedes escribir una secuencia como una lista separada por comas entre corchetes ([]):

                  -
                  [PHP, Perl, Python]
-
                  -
                  -

                  Una asignación se puede escribir como una lista separada por comas de clave/valores dentro de llaves ({}):

                  -
                  { PHP: 5.2, MySQL: 5.1, Apache: 2.2.20 }
-
                  -
                  -

                  Puedes mezclar y combinar estilos para conseguir mejor legibilidad:

                  -
                  'Chapter 1': [Introduction, Event Types]
-'Chapter 2': [Introduction, Helpers]
-
                  -
                  -
                  "symfony 1.0": { PHP: 5.0, Propel: 1.2 }
-"symfony 1.2": { PHP: 5.2, Propel: 1.3 }
-
                  -
                  -
                  -
                  -
                  -

                  Comentarios

                  -

                  En YAML puedes añadir comentarios anteponiendo una almohadilla (#):

                  -
                  # Comentario en una línea
-"symfony 1.0": { PHP: 5.0, Propel: 1.2 } # Comentario al final de una línea
-"symfony 1.2": { PHP: 5.2, Propel: 1.3 }
-
                  -
                  -
                  -

                  Nota

                  -

                  Los comentarios simplemente son ignorados por el analizador de YAML y no es necesario sangrarlos de acuerdo al nivel de anidamiento actual de una colección.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/bugs.html b/contributing/code/bugs.html deleted file mode 100644 index 02599ff..0000000 --- a/contributing/code/bugs.html +++ /dev/null @@ -1,150 +0,0 @@ - - - - - - - Informando de errores — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Informando de errores

                  -

                  Cada vez que encuentres un error en Symfony2, te rogamos que lo informes. Nos ayuda a hacer un mejor Symfony2.

                  -
                  -

                  Prudencia

                  -

                  Si piensas que has encontrado un problema de seguridad, por favor, en su lugar, usa el procedimiento especial.

                  -
                  -

                  Antes de enviar un error:

                  - -

                  Si tu problema definitivamente se ve como un error, informa el fallo usando el tracker oficial siguiendo algunas reglas básicas:

                  -
                    -
                  • Utiliza el campo título para describir claramente el problema;
                    • -
                  • Describe los pasos necesarios para reproducir el error con breves ejemplos de código (proporcionando una prueba unitaria que ilustre mejor el error);
                    • -
                  • Indica lo más detalladamente posible tu entorno (sistema operativo, versión de PHP, versión de Symfony, extensiones habilitadas, ...);
                    • -
                  • (opcional) Adjunta un parche.
                    • -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/conventions.html b/contributing/code/conventions.html deleted file mode 100644 index c137eec..0000000 --- a/contributing/code/conventions.html +++ /dev/null @@ -1,237 +0,0 @@ - - - - - - - Convenciones — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Convenciones

                  -

                  El documento estándares describe las normas de codificación de los proyectos Symfony2 y los paquetes internos de terceros. Este documento describe los estándares de codificación y convenciones utilizadas en la plataforma básica para que sea más consistente y predecible. Las puedes seguir en tu propio código, pero no es necesario.

                  -
                  -

                  Nombres de método

                  -

                  Cuando un objeto tiene una relación «principal» con muchas «cosas» relacionadas (objetos, parámetros, ...), los nombres de los métodos están normalizados:

                  -
                  -
                    -
                  • get()
                    • -
                  • set()
                    • -
                  • has()
                    • -
                  • all()
                    • -
                  • replace()
                    • -
                  • remove()
                    • -
                  • clear()
                    • -
                  • isEmpty()
                    • -
                  • add()
                    • -
                  • register()
                    • -
                  • count()
                    • -
                  • keys()
                    • -
                  -
                  -

                  El uso de estos métodos sólo se permite cuando es evidente que existe una relación principal:

                  -
                    -
                  • un CookieJar tiene muchos objetos Cookie;
                    • -
                  • un Contenedor de servicios tiene muchos servicios y muchos parámetros (dado que los servicios son la relación principal, utilizamos la convención de nomenclatura para esta relación);
                    • -
                  • una Consola Input tiene muchos argumentos y muchas opciones. No hay una relación «principal», por lo tanto no aplica la convención de nomenclatura.
                    • -
                  -

                  Para muchas relaciones cuando la convención no aplica, en su lugar se deben utilizar los siguientes métodos (donde XXX es el nombre de aquello relacionado):

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  Relación -principalOtras relaciones
                  get()getXXX()
                  set()setXXX()
                  n/areplaceXXX()
                  has()hasXXX()
                  all()getXXXs()
                  replace()setXXXs()
                  remove()removeXXX()
                  clear()clearXXX()
                  isEmpty()isEmptyXXX()
                  add()addXXX()
                  register()registerXXX()
                  count()countXXX()
                  keys()n/a
                  -
                  -

                  Nota

                  -

                  Si bien «setXXX» y «replaceXXX» son muy similares, hay una notable diferencia: «setXXX» puede sustituir o agregar nuevos elementos a la relación. -«replaceXXX», por otro lado, no puede añadir nuevos elementos. Si se pasa una clave no reconocida a «replaceXXX», lanzará una excepción.

                  -
                  -
                  -
                  -

                  Depreciaciones

                  -

                  De vez en cuando, algunas clases y/o métodos son depreciados en la plataforma; esto sucede cuando la implementación de una característica no se puede cambiar debido a cuestiones de compatibilidad hacia atrás, pero todavía queremos proponer una mejor «alternativa». En este caso, la antigua implementación sencillamente se puede depreciar.

                  -

                  Una característica es marcada como depreciada añadiendo una anotación @deprecated de phpdoc a las clases, métodos, propiedades, ... pertinentes:

                  -
                  /**
- * @deprecated Depreciada a partir de la versión 2.X, será removida en 2.Y. En su lugar usa XXX.
- */
-
                  -
                  -

                  El mensaje de la depreciación debería indicar la versión cuándo el método/clase fue depreciado, la versión cuándo será removido, y siempre que sea posible, cómo sustituir la característica.

                  -

                  Un error E_USER_DEPRECATED de PHP también será provocado para ayudar a las personas con la migración empezando una o dos versiones menores antes de la versión donde la característica será removida (dependiendo de lo delicado de la extracción):

                  -
                  trigger_error(
-    'XXX() está depreciada a partir de la versión 2.X, será removida en 2.Y. En su lugar usa XXX.',
-    E_USER_DEPRECATED
-);
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/git.html b/contributing/code/git.html deleted file mode 100644 index 59bdba7..0000000 --- a/contributing/code/git.html +++ /dev/null @@ -1,154 +0,0 @@ - - - - - - - Git — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Git

                  -

                  This document explains some conventions and specificities in the way we manage -the Symfony code with Git.

                  -
                  -

                  Pull Requests

                  -

                  Whenever a pull request is merged, all the information contained in the pull -request (including comments) is saved in the repository.

                  -

                  You can easily spot pull request merges as the commit message always follows -this pattern:

                  -

                  The PR reference allows you to have a look at the original pull request on -Github: https://github.com/symfony/symfony/pull/1111. But all the information -you can get on Github is also available from the repository itself.

                  -

                  The merge commit message contains the original message from the author of the -changes. Often, this can help understand what the changes were about and the -reasoning behind the changes.

                  -

                  Moreover, the full discussion that might have occurred back then is also -stored as a Git note (before March 22 2013, the discussion was part of the -main merge commit message). To get access to these notes, add this line to -your .git/config file:

                  -

                  After a fetch, getting the Github discussion for a commit is then a matter of -adding --show-notes=github-comments to the git show command:

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/index.html b/contributing/code/index.html deleted file mode 100644 index e60227b..0000000 --- a/contributing/code/index.html +++ /dev/null @@ -1,175 +0,0 @@ - - - - - - - Aportando código — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/license.html b/contributing/code/license.html deleted file mode 100644 index 14aa241..0000000 --- a/contributing/code/license.html +++ /dev/null @@ -1,163 +0,0 @@ - - - - - - - Licencia Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Licencia Symfony2

                  -

                  Symfony2 se libera bajo la licencia MIT.

                  -

                  De acuerdo con Wikipedia:

                  -
                  -
                  “Es una licencia permisiva, lo cual significa que permite la -reutilización dentro de software propietario a condición de que la -licencia se distribuya con el software. Esta también es compatible -con la licencia GPL, lo cual significa que la licencia GPL -permite la combinación y redistribución, con el software que utiliza -la licencia MIT”.
                  -
                  -

                  La Licencia

                  -

                  Copyright (c) 2004-2013 Fabien Potencier -Copyright (c) 2011-2013 Nacho Pacheco

                  -

                  Se autoriza, de forma gratuita, a cualquier persona que obtenga una -copia de este software y archivos de documentación asociados (el -“Software”), a trabajar con el Software sin restricción, incluyendo sin -limitación, los derechos para usar, copiar, modificar, fusionar, -publicar, distribuir, sublicenciar y/o vender copias del Software, y a -permitir a las personas a quienes se proporcione el Software a hacerlo, -sujeto a las siguientes condiciones:

                  -

                  El aviso de copyright anterior y este aviso de autorización se incluirán -en todas las copias o partes sustanciales del Software.

                  -

                  EL SOFTWARE SE ENTREGA “TAL CUAL”, SIN GARANTÍA DE NINGÚN TIPO, EXPRESA -O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE -COMERCIALIZACIÓN, ADECUACIÓN A UN PROPÓSITO PARTICULAR Y NO -INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DEL COPYRIGHT SERÁN -RESPONSABLES DE NINGUNA RECLAMACIÓN, DAÑO U OTRA RESPONSABILIDAD, YA SEA -EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRA, DERIVADA DE, O EN RELACIÓN -CON LA UTILIZACIÓN DEL SOFTWARE U OTRAS OPERACIONES EN EL SOFTWARE.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/patches.html b/contributing/code/patches.html deleted file mode 100644 index c5331aa..0000000 --- a/contributing/code/patches.html +++ /dev/null @@ -1,393 +0,0 @@ - - - - - - - Enviando un parche — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Enviando un parche

                  -

                  Los parches son la mejor manera de proporcionar una corrección de error o de proponer mejoras a Symfony2.

                  -
                  -

                  Paso 1: Configura tu entorno

                  -
                  -

                  Instalando el software necesario

                  -

                  Antes de trabajar en Symfony2, configura un entorno amigable con el siguiente software:

                  -
                    -
                  • Git;
                    • -
                  • PHP version 5.3.3 o más reciente;
                    • -
                  • PHPUnit 3.6.4 o más reciente.
                    • -
                  -
                  -
                  -

                  Configura Git

                  -

                  Configura la información de usuario con tu nombre real y una dirección de correo electrónico operativa:

                  -
                  $ git config --global user.name "Tu nombre"
-$ git config --global user.email tu@ejemplo.com
-
                  -
                  -
                  -

                  Truco

                  -

                  Si eres nuevo en Git, es muy recomendable que leas el excelente libro ProGit, que además es gratis.

                  -
                  -
                  -

                  Truco

                  -

                  Si tu IDE crea los archivos de configuración dentro del directorio del proyecto, puedes usar el archivo global .gitignore (para todos los proyectos) o el archivo .git/info/exclude (por proyecto) para descartarlos. Consulta la documentación de Github.

                  -
                  -
                  -

                  Truco

                  -

                  Usuarios de Windows: al instalar Git, se te preguntará qué hacer con los finales de línea y te sugiere reemplazar todos los LF por CRLF. ¡Esta es la opción incorrecta si deseas contribuir con Symfony! Seleccionar el método tal cual es tu mejor opción, puesto que Git convertirá tus saltos de línea a los del repositorio. Si ya has instalado Git, puedes comprobar el valor de esta opción escribiendo:

                  -
                  $ git config core.autocrlf
-
                  -
                  -

                  Esto devolverá o bien «false», «input» o «true», «true» y «false» son valores incorrectos. Para fijarlo a otro valor, escribe:

                  -
                  $ git config --global core.autocrlf input
-
                  -
                  -

                  Sustituye --global por --local si lo quieres fijar únicamente para el repositorio activo.

                  -
                  -
                  -
                  -

                  Consigue el código fuente de Symfony

                  -

                  Obtén el código fuente de Symfony2:

                  -
                    -
                  • Crea una cuenta GitHub e ingresa;
                    • -
                  • Consigue el repositorio Symfony2 (haz clic en el botón «Fork»);
                    • -
                  • Después de concluida la «acción de bifurcar el núcleo», clona tu bifurcación a nivel local (esto creará un directorio symfony):
                    • -
                  -
                  $ git clone git@github.com:NOMBREUSUARIO/symfony.git
-
                  -
                  -
                    -
                  • Añade el repositorio como remoto de escritura:
                    • -
                  -
                  $ cd symfony
-$ git remote add upstream git://github.com/symfony/symfony.git
-
                  -
                  -
                  -
                  -

                  Comprueba que pasa la batería de pruebas actual

                  -

                  Ahora que Symfony2 está instalado, comprueba que todas las pruebas unitarias pasan en tu entorno como se explica en el documento dedicado.

                  -
                  -
                  -
                  -

                  Paso 2: Trabaja en tu parche

                  -
                  -

                  La Licencia

                  -

                  Antes de empezar, debes saber que todos los parches que envíes se deben liberar bajo la Licencia MIT, a menos que explícitamente lo especifiques en tus confirmaciones de cambios.

                  -
                  -
                  -

                  Eligiendo la rama adecuada

                  -

                  Antes de trabajar en tu parche, debes determinar en cual rama necesitas trabajar. La rama debe estar basada en la rama master si deseas agregar una nueva característica. Pero, si deseas corregir un fallo, utiliza la versión más antigua, pero aún mantenida de Symfony donde ocurre el fallo (como 2.0).

                  -
                  -

                  Nota

                  -

                  Todas las correcciones de fallos se fusionarán en las ramas de mantenimiento y además se fusionaran regularmente en las ramas más recientes. Por ejemplo, si envías un parche para la rama 2.0, el parche también será aplicado por el equipo del núcleo a la rama master.

                  -
                  -
                  -
                  -

                  Crea una rama para ese asunto

                  -

                  Cada vez que desees trabajar en un parche para un fallo o una mejora, crea una rama para ese asunto:

                  -
                  $ git checkout -b NOMBRE_RAMA master
-
                  -
                  -

                  O, si deseas proporcionar una corrección de fallo para la rama 2.0, en primer lugar, actualiza tu copia local a la rama 2.0:

                  -
                  $ git checkout -t origin/2.0
-
                  -
                  -

                  Luego, crea una nueva rama de la rama 2.0 para trabajar en la corrección del fallo:

                  -
                  $ git checkout -b NOMBRE_RAMA 2.0
-
                  -
                  -
                  -

                  Truco

                  -

                  Utiliza un nombre descriptivo para tu rama (ticket_XXX donde XXX es el número del boleto, esta es una buena convención para la corrección de fallos).

                  -
                  -

                  La orden checkout anterior, automáticamente cambia el código a la rama recién creada (para ver la rama en que estás trabajando utiliza git branch).

                  -
                  -
                  -

                  Trabaja en tu parche

                  -

                  Trabaja en el código tanto como quieras y confirma tus cambios tanto como desees; pero ten en cuenta lo siguiente:

                  -
                    -
                  • Lee sobre las convenciones de Symfony y sigue los estándares de codificación (usa git diff –check para verificar los espacios finales – también lee el consejo de abajo);
                    • -
                  • Añade pruebas unitarias para probar que el fallo se corrigió o que la nueva característica realmente funciona;
                    • -
                  • Esfuérzate para no romper la compatibilidad hacia atrás (si debes hacerlo, trata de proporcionar una capa de compatibilidad para apoyar la manera antigua) — los parches que rompen la compatibilidad con versiones anteriores tienen menos posibilidades de que se fusionen;
                    • -
                  • Haz confirmaciones atómicas y separadas lógicamente (usa el poder de git rebase para tener un historial limpio y lógico);
                    • -
                  • Aplana confirmaciones de cambios irrelevantes que estén a punto de comprometer los estándares de codificación o corrigen fallos en tu propio código;
                    • -
                  • No corrijas los estándares de codificación en algún código existente, ya que dificulta la revisión del código;
                    • -
                  • Escribe buenos mensajes de confirmación (ve el consejo más adelante).
                    • -
                  -
                  -

                  Truco

                  -

                  Puedes comprobar los estándares de codificación de tu parche ejecutando el siguiente archivo que puedes conseguir aquí:

                  -
                  $ cd /ruta/a/symfony/src
-$ php symfony-cs-fixer.phar fix . Symfony20Finder
-
                  -
                  -
                  -
                  -

                  Truco

                  -

                  Un buen mensaje de confirmación de cambios sustancial está compuesto por un resumen (en la primera línea), seguido opcionalmente por una línea en blanco y una descripción más detallada. El resumen debe comenzar con el componente en el que estás trabajando entre corchetes ([DependencyInjection], [FrameworkBundle], ...). Utiliza un verbo (fixed..., added..., ...) para iniciar el resumen y no agregues un punto al final.

                  -
                  -
                  -
                  -

                  Prepara tu parche para enviarlo

                  -

                  Cuando tu parche no se trata de una corrección de fallo (cuando agregas una nueva característica o cambias una existente, por ejemplo), además debes incluir lo siguiente:

                  -
                    -
                  • Una explicación de los cambios en el/los archivo(s) CHANGELOG correspondiente(s) (cuando sea pertinente debes usar los prefijos [BC BREAK] o [DEPRECATION]);
                    • -
                  • Una explicación sobre cómo actualizar una aplicación existente en el archivo UPGRADE correspondiente si los cambios rompen la compatibilidad hacia atrás o si depreciaste algo que a la larga rompa la compatibilidad hacia atrás.
                    • -
                  -
                  -
                  -
                  -

                  Paso 3: Envía tu parche

                  -

                  Siempre que sientas que tu parche esté listo para su presentación, sigue los siguientes pasos.

                  -
                  -

                  Reorganiza tu parche

                  -

                  Antes de presentar tu revisión, actualiza tu rama (es necesario si te toma cierto tiempo terminar los cambios):

                  -
                  $ git checkout master
-$ git fetch upstream
-$ git merge upstream/master
-$ git checkout NOMBRE_RAMA
-$ git rebase master
-
                  -
                  -
                  -

                  Truco

                  -

                  Sustituye master con 2.0 si estás trabajando en una corrección de fallo

                  -
                  -

                  Al ejecutar la orden rebase, posiblemente tengas que arreglar conflictos de fusión. -git status te mostrará los archivos sin fusionar. Resuelve todos los conflictos, y luego continua el rebase:

                  -
                  $ git add ... # Añade archivos resueltos
-$ git rebase --continue
-
                  -
                  -

                  Comprueba que todas las pruebas todavía pasan y envía a tu rama remota:

                  -
                  $ git push origin NOMBRE_RAMA
-
                  -
                  -
                  -
                  -

                  Envía una solicitud de atracción

                  -

                  Ahora puedes hacer una solicitud de atracción en el repositorio symfony/synfony de Github.

                  -
                  -

                  Truco

                  -

                  Ten cuidado de marcar tu solicitud de atracción para symfony:2.1 si deseas que el equipo del núcleo atraiga una corrección de fallo basada en la rama 2.1.

                  -
                  -

                  Para facilitar el trabajo del equipo del núcleo, siempre incluye los componentes modificados en el mensaje (en inglés) de tu solicitud de atracción, como este:

                  -
                  [Yaml] fixed something
-[Form] [Validator] [FrameworkBundle] added something
-
                  -
                  -

                  La descripción de la solicitud de atracción debe incluir la siguiente lista de comprobación en la parte superior para garantizar que las aportaciones se pueden revisar sin la necesidad infinitos ciclos de retroalimentación y que tus aportaciones se pueden incluir a Symfony2 tan rápidamente como sea posible:

                  -
                  | Q             | A
-| ------------- | ---
-| Bug fix?      | [yes|no]
-| New feature?  | [yes|no]
-| BC breaks?    | [yes|no]
-| Deprecations? | [yes|no]
-| Tests pass?   | [yes|no]
-| Fixed tickets | [lista separada por comas de las entradas corregidas por el PR]
-| License       | MIT
-| Doc PR        | [Referencia a la documentación del PR, si la hay]
-
                  -
                  -

                  Un envío de ejemplo ahora se ve de la siguiente manera:

                  -
                  | Q             | A
-| ------------- | ---
-| Bug fix?      | no
-| New feature?  | no
-| BC breaks?    | no
-| Deprecations? | no
-| Tests pass?   | yes
-| Fixed tickets | #12, #43
-| License       | MIT
-| Doc PR        | symfony/symfony-docs#123
-
                  -
                  -

                  Debes incluir la tabla completa (no quites líneas que pienses que no son relevantes). Para errores tipográficos sencillos, cambios menores en la PHPDocs, o cambios en los archivos de traducción, usa la versión corta de la lista de comprobación:

                  -
                  | Q             | A
-| ------------- | ---
-| Fixed tickets | [lista separada por comas de las entradas corregidas por el PR]
-| License       | MIT
-
                  -
                  -

                  Algunas respuestas a cuestiones que provocan algunos requisitos adicionales:

                  -
                  -
                    -
                  • Si contestaste yes a «Bug fix?», comprueba si el fallo ya está enumerado en los problemas de Symfony y proporciona una referencia a la(s) «entrada(s) corregida(s)»;
                    • -
                  • Si contestaste yes a «New feature?», debes enviar una solicitud de atracción a la documentación y referirla bajo la sección «Doc PR»;
                    • -
                  • Si contestaste yes a «BC breaks?», el parche debe contener actualizaciones a los archivos CHANGELOG y UPGRADE pertinentes;
                    • -
                  • Si contestaste yes a «Deprecations?», el parche debe contener actualizaciones a los archivos CHANGELOG y UPGRADE pertinentes;
                    • -
                  • Si contestaste no a «Tests pass», debes añadir un elemento a una lista de pendientes con las acciones que se deben tomar para corregir las pruebas;
                    • -
                  • Si la «license» no es MIT, sólo no envíes la solicitud de atracción puesto que no será aceptada en ningún caso.
                    • -
                  -
                  -

                  Si no cubres alguno de los requisitos anteriores, crea una lista de pendientes y añade los -elementos pertinentes:

                  -
                  - [ ] fix the tests as they have not been updated yet
-- [ ] submit changes to the documentation
-- [ ] document the BC breaks
-
                  -
                  -

                  Si el código no está terminado todavía porque no tienes tiempo para acabarlo o porque quieres retroalimentación temprana sobre tu trabajo, añade un elemento a la lista de pendientes:

                  -
                  - [ ] finish the code
-- [ ] gather feedback my changes
-
                  -
                  -

                  Mientras tengas elementos en la lista de pendientes, por favor prefija el título de la petición -de atracción con «[WIP]».

                  -

                  En la descripción de tu solicitud de atracción, da tantos detalles como sea posible acerca de tus cambios (no dudes en dar ejemplos de código para ilustrar tus puntos). Si tu solicitud de atracción está a punto de añadir una nueva característica o modificar una existente, explica las razones para los cambios. La descripción de la solicitud de atracción ayuda a la revisión del código y sirve como referencia al fusionar el código (la descripción de la solicitud de atracción y todos tus comentarios asociados son parte del mensaje de confirmación de la fusión).

                  -

                  Además de este código de la solicitud de atracción, también debes enviar una solicitud de atracción al repositorio de documentación para actualizar la documentación cuando sea apropiado.

                  -
                  -
                  -

                  Revisando tu parche

                  -

                  Basándote en la retroalimentación sobre tu solicitud de atracción, posiblemente debas volver a trabajar en tu parche. Antes de volver a presentarlo, reorganiza con upstream/master o upstream/2.0, no lo fusiones; y fuerza el envío al origen:

                  -
                  $ git rebase -f upstream/master
-$ git push -f origin NOMBRE_RAMA
-
                  -
                  -
                  -

                  Nota

                  -

                  cuando haces un push --force, siempre especifica el nombre de la rama de forma explícita para evitar dañar otras ramas en el repositorio (--force le dice a Git que realmente quieres meterte con esas cosas por lo tanto hazlo con mucho cuidado).

                  -
                  -

                  A menudo, los moderadores te pedirán que «aplanes» tus confirmaciones de cambios. Lo cual significa que combines varias confirmaciones de cambios en una sola. Para ello, utiliza la orden rebase:

                  -
                  $ git rebase -i HEAD~3
-$ git push -f origin NOMBRE_RAMA
-
                  -
                  -

                  Aquí, el número 3 debe ser igual a la cantidad de confirmaciones de cambios en tu rama. Después que escribas esta orden, aparecerá un editor mostrándote la lista de confirmaciones de cambios:

                  -
                  pick 1a31be6 first commit
-pick 7fc64b4 second commit
-pick 7d33018 third commit
-
                  -
                  -

                  Para revertir todas las confirmaciones de cambios a la primera, elimina la palabra «pick» antes de la segunda y última confirmación de cambios, y sustitúyela por la palabra «squash» o simplemente «s». -Cuando guardes, Git iniciará el rebase, y si tiene éxito, te pedirá que -edites el mensaje de confirmación, el cual de manera predefinida es una lista con todos los mensajes de las confirmaciones de cambios. Cuando hayas terminado, ejecuta la orden push.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/security.html b/contributing/code/security.html deleted file mode 100644 index 26b15a7..0000000 --- a/contributing/code/security.html +++ /dev/null @@ -1,195 +0,0 @@ - - - - - - - Problemas de seguridad — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Problemas de seguridad

                  -

                  Este documento explica cómo maneja el equipo del núcleo de Symfony los problemas de seguridad (Symfony es el código alojado en el repositorio Git principal symfony/symfony).

                  -
                  -

                  Informando un problema de seguridad

                  -

                  Si crees que has encontrado un problema de seguridad en Symfony, no utilices la lista de correo o el rastreador de fallos y no lo divulgues públicamente. En su lugar, todos los problemas de seguridad se tienen que enviar a security arroba symfony.com. Los correos electrónicos enviados a esta dirección se reenvían a la lista de correo privado del equipo del núcleo.

                  -
                  -
                  -

                  Proceso de resolución

                  -

                  Para cada informe, en primer lugar, trata de confirmar la vulnerabilidad. Cuando esté confirmada, el equipo del núcleo trabaja en una solución siguiendo estos pasos:

                  -
                    -
                  1. Envía un reconocimiento al informante;
                    2. -
                  2. Trabaja en un parche;
                    3. -
                  3. Obtiene un identificador CVE (por «Common Vulnerabilities and Exposures») de cve.mitre.org;
                    4. -
                  4. Escribe un anuncio de seguridad para el blog oficial de Symfony sobre la vulnerabilidad. Este comunicado debería contener la siguiente información:
                      -
                    • Un título que siempre incluya la cadena «Security release»;
                      • -
                    • Una descripción de la vulnerabilidad;
                      • -
                    • Las versiones afectadas;
                      • -
                    • La posible explotación;
                      • -
                    • Cómo afecta el parche/actualización/solución del problema a las aplicaciones;
                      • -
                    • El identificador CVE;
                      • -
                    • Créditos.
                      • -
                    -
                    5. -
                  5. Envia el parche y anuncio al reportero para revisión;
                    6. -
                  6. Aplica el parche en todas las versiones mantenidas de Symfony;
                    7. -
                  7. Empaca las nuevas versiones para todas las versiones afectadas;
                    8. -
                  8. Publica un comunicado en el blog oficial de Symfony (también se tiene que añadir a la categoría «Avisos de seguridad»);
                    9. -
                  9. Actualiza la lista de avisos de seguridad (ve abajo).
                    10. -
                  -
                  -

                  Nota

                  -

                  Versiones que incluyen problemas de seguridad no se tendrían que hacer en sábado o domingo, excepto si la vulnerabilidad se difundió públicamente.

                  -
                  -
                  -

                  Nota

                  -

                  Mientras estemos trabajando en un parche, por favor, no reveles el tema públicamente.

                  -
                  -
                  -
                  -

                  Avisos de seguridad

                  -

                  Estas sección registra en orden cronológico las vulnerabilidades de seguridad que fueron corregidas en las diferentes versiones de Symfony, empezando en Symfony 1.0.0:

                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/standards.html b/contributing/code/standards.html deleted file mode 100644 index 93252b2..0000000 --- a/contributing/code/standards.html +++ /dev/null @@ -1,245 +0,0 @@ - - - - - - - Estándares de codificación — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Estándares de codificación

                  -

                  Cuando aportes código a Symfony2, debes seguir sus estándares de codificación. Para no hacer el cuento largo, aquí está la regla de oro: limítate el código Symfony2 existente. La mayoría de los Paquetes de código abierto y librerías utilizadas por Symfony2 también siguen las mismas pautas, y también deberías hacerlo.

                  -

                  Recuerda que la principal ventaja de los estándares es que cada pieza de código se ve y se siente familiar, no se trata de que esta o esa sea más legible.

                  -

                  Symfony sigue los estándares definidos en los documentos PSR-0, PSR-1 y PSR-2.

                  -

                  Ya que una imagen —o algún código— vale más que mil palabras, he aquí un pequeño ejemplo que contiene la mayoría de las funciones descritas más adelante:

                  -
                  <?php
-
-/*
- * This file is part of the Symfony package.
- *
- * (c) Fabien Potencier <fabien@symfony.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-
-namespace Acme;
-
-/**
- * Demostración de estándares de la codificación.
- */
-class FooBar
-{
-    const SOME_CONST = 42;
-
-    private $fooBar;
-
-    /**
-     * @param string $dummy Some argument description
-     */
-    public function __construct($dummy)
-    {
-        $this->fooBar = $this->transformText($dummy);
-    }
-
-    /**
-     * @param string $dummy Some argument description
-     * @param array $options
-     *
-     * @return string|null Transformed input
-     */
-    private function transformText($dummy, $options = array())
-    {
-        $mergedOptions = array_merge(
-            $options,
-            array(
-                'some_default' => 'values',
-                'another_default' => 'more values',
-            )
-        );
-
-        if (true === $dummy) {
-            return;
-        }
-        if ('string' === $dummy) {
-            if ('values' === $mergedOptions['some_default']) {
-                $dummy = substr($dummy, 0, 5);
-            } else {
-                $dummy = ucwords($dummy);
-            }
-        } else {
-            throw new \RuntimeException(sprintf('Unrecognized dummy option "%s"', $dummy));
-        }
-
-        return $dummy;
-    }
-}
-
                  -
                  -
                  -

                  Estructura

                  -
                    -
                  • Añade un solo espacio después de cada delimitador coma;
                    • -
                  • Añade un solo espacio alrededor de los operadores (==, &&, ...);
                    • -
                  • Añade una coma después de cada elemento del arreglo en un arreglo multilínea, incluso después del último;
                    • -
                  • Añade una línea en blanco antes de las declaraciones return, a menos que el valor devuelto solo sea dentro de un grupo de declaraciones (tal como una declaración if);
                    • -
                  • Usa llaves para indicar la estructura del cuerpo de control, independientemente del número de declaraciones que contenga;
                    • -
                  • Define una clase por archivo — esto no se aplica a las clases ayudante privadas, de las cuales no se tiene la intención de crear una instancia desde el exterior y por lo tanto no les preocupa la norma PSR-0;
                    • -
                  • Declara las propiedades de clase antes que los métodos;
                    • -
                  • Declare public methods first, then protected ones and finally private ones;
                    • -
                  • Use parentheses when instantiating classes regardless of the number of -arguments the constructor has;
                    • -
                  • Exception message strings should be concatenated using sprintf.
                    • -
                  -
                  -
                  -

                  Convenciones de nomenclatura

                  -
                    -
                  • Utiliza mayúsculas intercaladas —sin guiones bajos— en nombres de variable, función, método o argumentos;
                    • -
                  • Usa guiones bajos para nombres de opción y nombres de parámetro;
                    • -
                  • Utiliza espacios de nombres para todas las clases;
                    • -
                  • Prefija las clases abstractas con Abstract. Por favor, ten en cuenta que algunas de las primeras clases de Symfony2 no siguen esta convención y no se han rebautizado por razones de compatibilidad hacia atrás. No obstante, todas las nuevas clases abstractas tienen que seguir esta convención de nomenclatura;
                    • -
                  • Sufija las interfaces con Interface;
                    • -
                  • Sufijo las características con Trait;
                    • -
                  • Sufija las excepciones con Exception;
                    • -
                  • Utiliza caracteres alfanuméricos y guiones bajos para los nombres de archivo;
                    • -
                  • No olvides consultar el documento más detallado Convenciones para más consideraciones de nomenclatura subjetivas.
                    • -
                  -
                  -
                  -

                  Documentación

                  -
                    -
                  • Añade bloques PHPDoc a todas las clases, métodos y funciones;
                    • -
                  • Omite la etiqueta @return si el método no devuelve nada;
                    • -
                  • Las anotaciones @package y @subpackage no se utilizan.
                    • -
                  -
                  -
                  -

                  Licencia

                  -
                    -
                  • Symfony se distribuye bajo la licencia MIT, y el bloque de la licencia tiene que estar presente en la parte superior de todos los archivos PHP, antes del espacio de nombres.
                    • -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/code/tests.html b/contributing/code/tests.html deleted file mode 100644 index 8ca5d84..0000000 --- a/contributing/code/tests.html +++ /dev/null @@ -1,211 +0,0 @@ - - - - - - - Corriendo las pruebas de Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Corriendo las pruebas de Symfony2

                  -

                  Antes de presentar un parche para su inclusión, es necesario ejecutar la batería de pruebas de Symfony2 para comprobar que no ha roto nada.

                  -
                  -

                  PHPUnit

                  -

                  Para ejecutar la batería de pruebas de Symfony2, primero instala PHPUnit 3.6.4 o superior:

                  -
                  $ pear config-set auto_discover 1
-$ pear install pear.phpunit.de/PHPUnit
-
                  -
                  -
                  -
                  -

                  Dependencias (opcional)

                  -

                  Para ejecutar la batería de pruebas completa, incluyendo las pruebas supeditadas con dependencias externas, Symfony2 tiene que ser capaz de cargarlas automáticamente. De forma predeterminada, se cargan automáticamente desde vendor/ en la raíz del directorio principal (consulta la sección autoload.php.dist).

                  -

                  La batería de pruebas necesita las siguientes bibliotecas de terceros:

                  -
                    -
                  • Doctrine
                    • -
                  • Swiftmailer
                    • -
                  • Twig
                    • -
                  • Monolog
                    • -
                  -

                  Para instalarlas todas, usa Composer:

                  -

                  Paso 1: Consigue Composer

                  -
                  curl -s http://getcomposer.org/installer | php
-
                  -
                  -

                  Asegúrate de descargar composer.phar en el mismo directorio dónde se encuentra el archivo composer.json.

                  -

                  Paso 2: Instala las bibliotecas de terceros

                  -
                  $ php composer.phar --dev install
-
                  -
                  -
                  -

                  Nota

                  -

                  Ten en cuenta que el guión toma algún tiempo para terminar.

                  -
                  -
                  -

                  Nota

                  -

                  Si no tienes instalado curl, simplemente puedes descargar manualmente el archivo instalador de http://getcomposer.org/installer. Coloca ese archivo en tu proyecto y luego ejecuta:

                  -
                  $ php installer
-$ php composer.phar --dev install
-
                  -
                  -
                  -

                  Después de la instalación, puedes actualizar los proveedores en cualquier momento con la siguiente orden.

                  -
                  $ php composer.phar --dev update
-
                  -
                  -
                  -
                  -

                  Ejecutando

                  -

                  En primer lugar, actualiza los proveedores (consulta más arriba).

                  -

                  A continuación, ejecuta la batería de pruebas desde el directorio raíz de Symfony2 con la siguiente orden:

                  -
                  $ phpunit
-
                  -
                  -

                  La salida debe mostrar OK. Si no es así, es necesario averiguar qué está pasando y si las pruebas se rompen a causa de tus modificaciones.

                  -
                  -

                  Truco

                  -

                  Si deseas probar la ruta de un tipo de componente único después de la orden phpunit, por ejemplo:

                  -
                  $ phpunit src/Symfony/Component/Finder/
-
                  -
                  -
                  -
                  -

                  Truco

                  -

                  Ejecuta la batería de pruebas antes de aplicar las modificaciones para comprobar que funcionan bien en tu configuración.

                  -
                  -
                  -
                  -

                  Cobertura de código

                  -

                  Si agregas una nueva característica, también necesitas comprobar la cobertura de código usando la opción coverage-html:

                  -
                  $ phpunit --coverage-html=cov/
-
                  -
                  -

                  Verifica la cobertura de código abriendo en un navegador la página generada cov/index.html.

                  -
                  -

                  Truco

                  -

                  La cobertura de código sólo funciona si tienes activado XDebug e instaladas todas las dependencias.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/community/index.html b/contributing/community/index.html deleted file mode 100644 index f1ffb86..0000000 --- a/contributing/community/index.html +++ /dev/null @@ -1,146 +0,0 @@ - - - - - - - Comunidad — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/community/irc.html b/contributing/community/irc.html deleted file mode 100644 index 7ffc295..0000000 --- a/contributing/community/irc.html +++ /dev/null @@ -1,161 +0,0 @@ - - - - - - - Reuniones IRC — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Reuniones IRC

                  -

                  El propósito de esta reunión es deliberar temas en tiempo real con muchos de los desarrolladores de Symfony2.

                  -

                  Cualquier persona puede proponer temas en la lista de correo symfony-dev hasta 24 horas antes de la reunión, idealmente incluyendo también información preparada pertinentemente a través de una URL. 24 horas antes de la reunión será publicado un enlace a doodle con una lista de todos los temas propuestos. Cualquier persona puede votar los temas hasta el comienzo de la reunión para definir su posición en el orden del día. Cada tema tendrá una duración fija de 15 minutos y la sesión dura una hora, dejando tiempo suficiente para por lo menos 4 temas.

                  -
                  -

                  Prudencia

                  -

                  Note that it’s not the expected goal of the meeting to find final -solutions, but more to ensure that there is a common understanding of the -issue at hand and move the discussion forward in ways which are hard to -achieve with less real time communication tools.

                  -
                  -

                  Las reuniones son cada jueves a las 17:00 CET (+01:00) en el canal #symfony-dev del servidor Freenode IRC.

                  -

                  Los registros IRC se publicarán más tarde en el wiki de trac, el cual incluirá un breve resumen de cada uno de los temas. Puedes crear tickets para cualquiera de las tareas o problemas identificados durante la reunión y referidas en el resumen.

                  -

                  Algunas sencillas instrucciones y orientación para participar:

                  -
                    -
                  • Es posible cambiar tu voto hasta el comienzo de la reunión, haciendo clic en «Editar una entrada»;
                    • -
                  • doodle cerrará la votación al comienzo de la reunión;
                    • -
                  • La agenda se define por los temas que tienen el mayor número de votos en doodle, o la que se propuso primero en caso de empate;
                    • -
                  • En el comienzo de la reunión una persona se identifica a sí misma como moderador(a);
                    • -
                  • El moderador se encarga fundamentalmente de velar por el tiempo de 15 minutos para cada tema y garantizar que las tareas están claramente identificadas;
                    • -
                  • Por lo general, el moderador se encargará de escribir el resumen y la creación de entradas en el trac a menos que alguien más lo releve;
                    • -
                  • Cualquier persona puede unirse y expresamente está invitado a participar;
                    • -
                  • Lo ideal sería que uno se familiarizara con el tema propuesto antes de la reunión;
                    • -
                  • Al iniciar un nuevo tema se invita al proponente a empezar con unas cuantas palabras;
                    • -
                  • Cualquiera puede comentar como mejor le parezca;
                    • -
                  • Dependiendo de cuántas personas participen, potencialmente debes contenerte de enviar un argumento específico muy difícil;
                    • -
                  • Recuerda que los registros IRC serán publicados más tarde, por lo tanto la gente tiene la oportunidad de revisar los comentarios más adelante;
                    • -
                  • Animamos a todos a levantar la mano para asumir las tareas definidas en la reunión.
                    • -
                  -

                  Aquí está un ejemplo doodle.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/community/other.html b/contributing/community/other.html deleted file mode 100644 index 103e95f..0000000 --- a/contributing/community/other.html +++ /dev/null @@ -1,133 +0,0 @@ - - - - - - - Otros recursos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Otros recursos

                  -

                  Con el fin de dar seguimiento a lo que está sucediendo en la comunidad pueden ser útiles estos recursos adicionales:

                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/community/releases.html b/contributing/community/releases.html deleted file mode 100644 index 89cbb4a..0000000 --- a/contributing/community/releases.html +++ /dev/null @@ -1,208 +0,0 @@ - - - - - - - El proceso de versionado — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El proceso de versionado

                  -

                  Este documento explica el proceso de versionado de Symfony (Symfony es el código alojado en el repositorio Git principal symfony/symfony).

                  -

                  Symfony gestiona sus versiones a través de un modelo basado en tiempo; cada seis meses sale una nueva versión de Symfony: una en Mayo y otra en Noviembre.

                  -
                  -

                  Nota

                  -

                  Este proceso de versionado fue adoptado a partir de Symfony 2.2, y todas las «reglas» explicadas en este documento se deben seguir estrictamente a partir de Symfony 2.4.

                  -
                  -
                  -

                  Desarrollo

                  -

                  El periodo de seis meses se divide en dos fases:

                  -
                    -
                  • Desarrollo: Cuatro meses para agregar nuevas características y mejorar las existentes;
                    • -
                  • Estabilización: Dos meses para corregir errores, preparar el lanzamiento y esperar a que el ecosistema de Symfony en conjunto (bibliotecas de terceros, paquetes y proyectos que utilizan Symfony) se pongan al día.
                    • -
                  -

                  Durante la fase de desarrollo, cualquier nueva característica se puede revertir si no será terminada a tiempo o si no estará lo suficientemente estable como para ser incluida en la versión final actual.

                  -
                  -
                  -

                  Manteniendo

                  -

                  Cada versión de Symfony se mantiene durante un determinado periodo de tiempo, en función del tipo de la versión.

                  -
                  -

                  Versiones estándar

                  -

                  Una versión estándar se mantiene durante un periodo de ocho mes.

                  -
                  -
                  -

                  Plazo de apoyo a versiones mayores

                  -

                  Cada dos años, se apoya una nueva versión mayor (también conocidas como versiones LTS por Long Term Support Release) será publicada. Cada versión LTS será apoyada por un periodo de tres años.

                  -
                  -

                  Nota

                  -

                  El apoyo pagado después de tres años con el apoyo prestado por la comunidad también se puede comprar en SensioLabs.

                  -
                  -
                  -
                  -
                  -

                  Programa

                  -

                  A continuación se muestra el cronograma de las primeras versiones que utilizan este modelo de edición:

                  -../../_images/release-process.jpg -
                    -
                  • El amarillo representa la fase de desarrollo
                    • -
                  • El azul representa la fase de estabilización
                    • -
                  • El verde representa el periodo de mantenimiento
                    • -
                  -

                  Este se traduce en fechas y periodos de mantenimiento muy predecibles.

                  -
                    -
                  • (especial) Symfony 2.2 será lanzado a finales de Febrero del 2013;
                    • -
                  • (especial) Symfony 2.3 (la primer versión LTS) se liberará a finales de Mayo del 2013;
                    • -
                  • Symfony 2.4 será lanzado a finales de Noviembre del 2013;
                    • -
                  • Symfony 2.5 será lanzado a finales de Mayo del 2014;
                    • -
                  • ...
                    • -
                  -
                  -
                  -

                  Compatibilidad con versiones anteriores

                  -

                  Después del lanzamiento de Symfony 2.3, la compatibilidad hacia atrás se mantendrá a toda costa. Si no es posible, la característica, mejora o corrección de errores -se programará para la siguiente versión principal: Symfony 3.0.

                  -
                  -

                  Nota

                  -

                  El trabajo sobre Symfony 3.0 se iniciará cuando suficientes características principales de compatibilidad con versiones anteriores estén esperando en la lista de pendientes.

                  -
                  -
                  -
                  -

                  Depreciaciones

                  -

                  Cuando la implementación de una característica no se pueda reemplazar con otra mejor sin romper la compatibilidad hacia atrás, todavía existe la posibilidad de depreciar la vieja implementación y añadir una nueva preferida al lado de la otra. Lee el documento con las convenciones para conocer más sobre el manejo de la depreciación en Symfony.

                  -
                  -
                  -

                  Justificación

                  -

                  Este proceso de liberación se adoptó para dar mayor predecibilidad y transparencia. Se discutió basándose en los siguientes objetivos:

                  -
                    -
                  • Acortar el ciclo de liberación (permitiendo que los desarrolladores se puedan beneficiar más rápido de las nuevas características);
                    • -
                  • Darle más visibilidad a los desarrolladores que están usando la plataforma y a los proyectos de código abierto que utilizan Symfony;
                    • -
                  • Mejorar la experiencia de los colaboradores del núcleo de Symfony: que todo mundo sepa cuando una característica esté disponible en Symfony;
                    • -
                  • Coordinar el calendario de Symfony con proyectos PHP populares que funcionan bien con Symfony y con proyectos que utilizan Symfony;
                    • -
                  • Darle tiempo al ecosistema de Symfony para ponerse al día con las nuevas versiones (autores de paquete, escritores de documentación, traductores, ...).
                    • -
                  -

                  El periodo de seis meses fue elegido para ajustarse a dos lanzamientos en un año. Este también permite un montón de tiempo para trabajar en las nuevas características y permite que las características que no están listas se pospongan para la próxima versión sin tener que esperar demasiado tiempo para el siguiente ciclo.

                  -

                  El modo de mantenimiento dual se adoptó para hacer feliz a cada usuario de Symfony. Moviéndose rápido, a quién quiera trabajar con la última y más reciente, utilizando las versiones estándar: una nueva versión será publicada cada seis meses, y esta cuenta con un periodo de dos meses para actualizarse. Las empresas que deseen una mayor estabilidad pueden utilizar las versiones LTS: una nueva versión será publicada cada dos años y cuenta con un año para actualizarse.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/documentation/format.html b/contributing/documentation/format.html deleted file mode 100644 index 0bd262b..0000000 --- a/contributing/documentation/format.html +++ /dev/null @@ -1,322 +0,0 @@ - - - - - - - Formato de documentación — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Formato de documentación

                  -

                  La documentación de Symfony2 utiliza reStructuredText como lenguaje de marcado y Sphinx para generarla (en HTML, PDF, ...).

                  -
                  -

                  reStructuredText

                  -

                  reStructuredText «es un sistema analizador y sintaxis de marcado de texto, fácil de leer, lo que ves es lo que obtienes».

                  -

                  Puedes aprender más acerca de su sintaxis leyendo los documentos existentes de Symfony2 o leyendo el Primer reStructuredText en el sitio web de Sphinx.

                  -

                  Si estás familiarizado con Markdown, ten cuidado que las cosas a veces se ven muy similares, pero son diferentes:

                  -
                    -
                  • Las listas se inician al comienzo de una línea (no se permite sangría);
                    • -
                  • Los bloques de código en línea utilizan comillas dobles (``como estas``).
                    • -
                  -
                  -
                  -

                  Sphinx

                  -

                  Sphinx es un sistema generador que añade algunas herramientas agradables para crear la documentación a partir de documentos reStructuredText. Como tal, agrega nuevas directivas e interpreta texto en distintos roles al marcado reST estándar.

                  -
                  -

                  Resaltado de sintaxis

                  -

                  Todo el código de los ejemplos de manera predeterminada utiliza PHP como lenguaje a resaltar. Puedes cambiarlo con la directiva code-block:

                  -
                  .. code-block:: yaml
-
-    { foo: bar, bar: { foo: bar, bar: baz } }
-
                  -
                  -

                  Si el código PHP comienza con <?php, entonces necesitas usar html+php como pseudolenguaje a resaltar:

                  -
                  .. code-block:: html+php
-
-    <?php echo $this->foobar(); ?>
-
                  -
                  -
                  -

                  Nota

                  -

                  Una lista de lenguajes apoyados está disponible en el sitio web de Pygments.

                  -
                  -
                  -
                  -

                  Bloques de configuración

                  -

                  Cada vez que muestres una configuración, debes utilizar la directiva configuration-block para mostrar la configuración en todos los formatos de configuración compatibles (YAML, XML y PHP)

                  -
                  .. configuration-block::
-
-    .. code-block:: yaml
-
-        # Configuración en YAML
-
-    .. code-block:: xml
-
-        <!-- Configuración en XML //-->
-
-    .. code-block:: php
-
-        // Configuración en PHP
-
                  -
                  -

                  El fragmento reST anterior se dibuja de la siguiente manera:

                  -
                  -
                    -
                  • YAML
                    # Configuración en YAML
-
                    -
                    -
                    • -
                  • XML
                    <!-- Configuración en XML //-->
-
                    -
                    -
                    • -
                  • PHP
                    // Configuración en PHP
-
                    -
                    -
                    • -
                  -
                  -

                  La lista de formatos apoyados actualmente es la siguiente:

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  Formato de marcadoMuestra
                  htmlHTML
                  xmlXML
                  phpPHP
                  yamlYAML
                  jinjaTwig
                  html+jinjaTwig
                  html+phpPHP
                  iniINI
                  php-annotationsAnotaciones
                  -
                  -
                  -

                  Añadiendo enlaces

                  -

                  Para añadir enlaces a otras páginas en los documentos utiliza la siguiente sintaxis:

                  -
                  :doc:`/ruta/a/pagina`
-
                  -
                  -

                  Usando la ruta y nombrearchivo de la página sin extensión, por ejemplo:

                  -
                  :doc:`/book/controller`
-
-:doc:`/components/event_dispatcher/introduction`
-
-:doc:`/cookbook/configuration/environments`
-
                  -
                  -

                  El texto del enlace será el encabezado principal del documento enlazado. También puedes especificar texto alternativo para el enlace:

                  -
                  :doc:`Cola de impresión de correo electrónico </cookbook/email/spool>`
-
                  -
                  -

                  También puedes añadir enlaces a la documentación de la API:

                  -
                  :namespace:`Symfony\\Component\\BrowserKit`
-
-:class:`Symfony\\Component\\Routing\\Matcher\\ApacheUrlMatcher`
-
-:method:`Symfony\\Component\\HttpKernel\\Bundle\\Bundle::build`
-
                  -
                  -

                  y a la documentación de PHP:

                  -
                  :phpclass:`SimpleXMLElement`
-
-:phpmethod:`DateTime::createFromFormat`
-
-:phpfunction:`iterator_to_array`
-
                  -
                  -
                  -
                  -

                  Probando la documentación

                  -

                  Para probar la documentación antes de enviarla:

                  -
                    -
                  • Instala Sphinx;
                    • -
                  • Ejecuta el programa de instalación rápida de Sphinx;
                    • -
                  • Instala las extensiones de Sphinx (ve más adelante);
                    • -
                  • Ejecuta make html y revisa el código HTML generado en el directorio _build.
                    • -
                  -
                  -
                  -

                  Instalando las extensiones de Sphinx

                  -
                    -
                  • Descarga las extensiones desde el repositorio source
                    • -
                  • Copia el directorio sensio al directorio _exts bajo tu directorio fuente (donde está conf.py)
                    • -
                  • Agrega lo siguiente al archivo conf.py:
                    • -
                  -
                  # ...
-sys.path.append(os.path.abspath('_exts'))
-
-# añadiendo PhpLexer
-from sphinx.highlighting import lexers
-from pygments.lexers.web import PhpLexer
-
-# ...
-# añade la extensión a la lista de extensiones
-extensions = [..., 'sensio.sphinx.refinclude',
-                   'sensio.sphinx.configurationblock',
-                   'sensio.sphinx.phpcode']
-
-# habilita el resaltado para el código PHP que no esté
-# entre ``<?php ... ?>`` por omisión
-lexers['php'] = PhpLexer(startinline=True)
-lexers['php-annotations'] = PhpLexer(startinline=True)
-
-# usa PHP como el dominio primario
-primary_domain = 'php'
-
-# fija la url para los enlaces de la API
-api_url = 'http://api.symfony.com/master/%s'
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/documentation/index.html b/contributing/documentation/index.html deleted file mode 100644 index cffb4a6..0000000 --- a/contributing/documentation/index.html +++ /dev/null @@ -1,156 +0,0 @@ - - - - - - - Aportando documentación — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/documentation/license.html b/contributing/documentation/license.html deleted file mode 100644 index 7a8d4d6..0000000 --- a/contributing/documentation/license.html +++ /dev/null @@ -1,172 +0,0 @@ - - - - - - - Licencia de la documentación de Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Licencia de la documentación de Symfony2

                  -

                  La documentación de Symfony2 está bajo una licencia Creative Commons Attribution-Share Alike 3.0 Unported Licencia.

                  -

                  Estás en libertad:

                  -
                    -
                  • para Compartir — copiar, distribuir y trasmitir públicamente la obra;
                    • -
                  • para Derivar — adaptando la obra.
                    • -
                  -

                  Bajo las siguientes condiciones:

                  -
                    -
                  • Atribución — Debes atribuir el trabajo de la manera especificada por -el autor o licenciador (pero de ninguna manera que sugiera que apoya tu -uso de la obra).
                    • -
                  • Compartir bajo la misma licencia — Si alteras, transformas, o creas -sobre esta obra, sólo podrás distribuir la obra resultante bajo una -licencia idéntica o similar a esta.
                    • -
                  -

                  En el entendido de:

                  -
                    -

                  • Renuncia — Cualquiera de estas condiciones puede no aplicarse si -obtienes el permiso del titular de los derechos de autor;

                    -
                    • -

                  • Dominio Público — Cuando la obra o cualquiera de sus elementos es del -dominio público bajo la legislación aplicable, este estatus de ninguna -manera es afectado por la licencia;

                    -
                    • -

                  • Otros Derechos — De ninguna manera cualquiera de los siguientes derechos -se ve afectado por la licencia:

                    -
                    -
                      -
                    • Tu derecho leal o uso justo, u otros derechos de autor excepciones y limitaciones aplicables;
                      • -
                    • Los derechos morales del autor;
                      • -
                    • Otras personas pueden tener derechos ya sea en la propia obra o en la forma en que se utiliza la obra, como los derechos de publicidad o privacidad.
                      • -
                    -
                    -
                    • -

                  • Atención — Para cualquier reutilización o distribución, debes dejar -claros los términos de la licencia de esta obra. La mejor manera de hacerlo es con un enlace a esta página web.

                    -
                    • -
                  -

                  Este es un resumen humanamente legible del Texto legal (Licencia completa).

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/documentation/overview.html b/contributing/documentation/overview.html deleted file mode 100644 index 026f976..0000000 --- a/contributing/documentation/overview.html +++ /dev/null @@ -1,297 +0,0 @@ - - - - - - - Colaborando en la documentación — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Colaborando en la documentación

                  -

                  La documentación es tan importante como el código. Esta sigue exactamente los mismos principios: -una vez y sólo una, pruebas, facilidad de mantenimiento, -extensibilidad, optimización y reconstrucción sólo por nombrar algunos. Y, por supuesto, la documentación tiene errores, errores tipográficos, guías difíciles de leer y mucho más.

                  -
                  -

                  Colaborando

                  -

                  Antes de colaborar, necesitas familiarizarte con el lenguaje de marcado empleado en la documentación.

                  -

                  La documentación de Symfony2 se encuentra alojada en GitHub:

                  -
                  https://github.com/symfony/symfony-docs
-
                  -
                  -

                  Si deseas enviar un parche bifurca el repositorio oficial en GitHub y luego clona tu bifurcación:

                  -
                  $ git clone git://github.com/TUNOMBRE/symfony-docs.git
-
                  -
                  -

                  Consistent with Symfony’s source code, the documentation repository is split into -multiple branches: 2.0, 2.1, 2.2 corresponding to the different -versions of Symfony itself. The master branch holds the documentation -for the development branch of the code.

                  -

                  Unless you’re documenting a feature that was introduced after Symfony 2.0 -(e.g. in Symfony 2.1), your changes should always be based on the 2.0 branch. -To do this checkout the 2.0 branch before the next step:

                  -
                  $ git checkout 2.0
-
                  -
                  -
                  -

                  Truco

                  -

                  Your base branch (e.g. 2.0) will become the “Applies to” in the Formato de la solicitud de atracción -that you’ll use later.

                  -
                  -

                  A continuación, crea una rama dedicada a tus cambios (para mantenerla organizada):

                  -
                  $ git checkout -b improving_foo_and_bar
-
                  -
                  -

                  Ahora puedes hacer los cambios directamente en esta rama y confirmarlos ahí. Cuando hayas terminado, impulsa esta rama a tu GitHub e inicia una solicitud de atracción.

                  -
                  -

                  Creando una solicitud de atracción

                  -

                  Siguiendo el ejemplo, la solicitud de atracción de manera predeterminada debe ser entre tu rama improving_foo_and_bar y la rama master de symfony-docs.

                  -../../_images/docs-pull-request.png -

                  Si has hecho tus cambios basándote en la rama 2.0, entonces necesitas cambiar la rama base para que sea 2.0 en la página anterior:

                  -../../_images/docs-pull-request-change-base.png -
                  -

                  Nota

                  -

                  Todos los cambios hechos a una rama (p. ej. 2.0) serán fusionados en cada «nueva» rama (p. ej. 2.1, maestra, etc.) para la siguiente liberación en una base semanal.

                  -
                  -

                  GitHub aborda en detalle el tema de las solicitudes de atracción.

                  -
                  -

                  Nota

                  -

                  La documentación de Symfony2 está bajo una licencia Creative Commons Attribution-Share Alike 3.0 Unported Licencia.

                  -
                  -

                  You can also prefix the title of your pull request in a few cases:

                  -
                    -
                  • [WIP] (Work in Progress) is used when you are not yet finished with your -pull request, but you would like it to be reviewed. The pull request won’t -be merged until you say it is ready.
                    • -
                  • [WCM] (Waiting Code Merge) is used when you’re documenting a new feature -or change that hasn’t been accepted yet into the core code. The pull request -will not be merged until it is merged in the core code (or closed if the -change is rejected).
                    • -
                  -
                  -
                  -

                  Formato de la solicitud de atracción

                  -

                  Unless you’re fixing some minor typos, the pull request description must -include the following checklist to ensure that contributions may be reviewed -without needless feedback loops and that your contributions can be included -into the documentation as quickly as possible:

                  -
                  | Q             | A
-| ------------- | ---
-| Doc fix?      | [yes|no]
-| New docs?     | [yes|no] (PR # si es aplicable en symfony/symfony)
-| Applies to    | [numero de versiones Symfony a las que es aplicable]
-| Fixed tickets | [lista separada por comas de los boletos corregidos por PR]
-
                  -
                  -

                  Un envío de ejemplo ahora se ve de la siguiente manera:

                  -
                  | Q             | A
-| ------------- | ---
-| Doc fix?      | yes
-| New docs?     | yes (symfony/symfony#2500)
-| Applies to    | all (or 2.1+)
-| Fixed tickets | #1075
-
                  -
                  -
                  -

                  Truco

                  -

                  Por favor, ten paciencia. Puede tomar desde 15 minutos hasta varios días para que tus cambios aparezcan en el sitio web symfony.com después de que el equipo de documentación fusione tu solicitud de atracción. Puedes comprobar si tus cambios introducen algunas cuestiones sobre el marcado yendo a la página de Errores en la generación de documentación (esta se actualiza en Francia cada noche a las 3 a.m. cuando el servidor vuelve a generar la documentación).

                  -
                  -
                  -
                  -
                  -

                  Documentando nuevas características o cambios de comportamiento

                  -

                  Si estás documentando un nuevo tipo de característica o un cambio que se esté haciendo en Symfony2, deberías preceder tu descripción del cambio con una etiqueta .. versionadded:: 2.X -y una breve descripción:

                  -
                  .. versionadded:: 2.2
-    El método ``askHiddenResponse`` se añadió en *Symfony 2.2*.
-
-Además, puedes hacer una pregunta y ocultar la respuesta. Esto particularmente es...
-
                  -
                  -

                  Si estás documentando un cambio de comportamiento, puedría ser útil describir brevemente cómo ha cambiado tal comportamiento.

                  -
                  .. versionadded:: 2.2
-    La función ``include()`` es una nueva característica de *Twig* que está disponible en *Symfony 2.2*. Anteriormente se utilizaba la etiqueta ``{% include %}``.
-
                  -
                  -

                  Siempre que se libere una nueva versión menor de Symfony2 (p. ej. 2.3, 2.4, etc.), se crea una nueva rama de la documentación desde la rama maestra. -En este punto, todas las etiquetas versionadded para las versiones de Symfony2 que han alcanzado su fin-de-vida serán eliminadas. Por ejemplo, si Symfony 2.5 fuera liberado hoy, y 2.2 recientemente alcanzó su fin-de-vida, la etiqueta versionadded 2.2 sería eliminada de la nueva rama 2.5.

                  -
                  -
                  -

                  Estándares

                  -

                  Con el fin de ayudar lo más posible al lector y crear código de ejemplo que se vea y sienta familiar, debes seguir estas reglas:

                  -
                    -
                  • El código sigue los Estándares de codificación de Symfony así como los Estándares de codificación de Twig;
                    • -
                  • Each line should break approximately after the first word that crosses the -72nd character (so most lines end up being 72-78 characters);
                    • -
                  • Para evitar desplazamiento horizontal en bloques de código, preferimos romper una línea correctamente si rebasa el 85º carácter;
                    • -
                  • Cuándo pliegues una o más líneas de código, coloca ... en un comentario en el punto del pliegue. Estos comentarios son: // ... (php), # ... (yaml/bash), {# ... #} -(twig), <!-- ... --> (xml/html), ; ... (ini), ... (texto);
                    • -
                  • Cuándo pliegues una parte de una línea, p. ej. un valor variable, coloca ... (sin comentario) en el sitio del pliegue;
                    • -
                  • Descripción del código plegado: (opcional) si pliegas varias líneas: la descripción del pliegue se puede colocar después de los ...; si sólo pliegas una parte de una línea: la descripción se puede colocar antes de la línea;
                    • -
                  • Si se considera útil, un bloque de código codeblock debe comenzar con un comentario que contenga el nombre del archivo en el bloque de código. No coloques una línea de espacio en blanco después de este comentario, a no ser que la próxima línea también sea un comentario;
                    • -
                  • Debes poner un $ delante de cada línea del intérprete;
                    • -
                  • El atajo :: es preferible sobre .. code-block:: php para comenzar un bloque de código PHP.
                    • -
                  • Deberías utilizar la forma tú en vez de nosotros.
                    • -
                  -

                  Un ejemplo:

                  -
                  // src/Foo/Bar.php
-
-// ...
-class Bar
-{
-    // ...
-
-    public function foo($bar)
-    {
-        // ajusta foo al valor de bar
-        $foo = ...;
-
-        // ... comprueba si $bar tiene el valor correcto
-
-        return $foo->baz($bar, ...);
-    }
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  en Yaml debes dejar un espacio después de { y antes de } (p. ej. { _controlador: ... }), -pero esto no lo debes hacer en Twig (p. ej. {'hola' : 'valor'}).

                  -
                  -
                  -
                  -

                  Informando un problema

                  -

                  La contribución más sencilla que puedes hacer es reportar algún problema: a typo, a grammar -mistake, a bug in a code example, a missing explanation, and so on.

                  -

                  Pasos a seguir:

                  -
                    -
                  • Reporta un error en el rastreador de fallos;
                    • -
                  • (Opcional) Envía un parche.
                    • -
                  -
                  -
                  -

                  Traduciendo

                  -

                  Lee el documento dedicado.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/documentation/translations.html b/contributing/documentation/translations.html deleted file mode 100644 index 80e4d82..0000000 --- a/contributing/documentation/translations.html +++ /dev/null @@ -1,186 +0,0 @@ - - - - - - - Traduciendo — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Traduciendo

                  -

                  La documentación de Symfony2 está escrita en inglés y hay muchas personas involucradas en el proceso de traducción.

                  -
                  -

                  Colaborando

                  -

                  En primer lugar, familiarízate con el lenguaje de marcado empleado en la documentación.

                  -

                  A continuación, suscríbete a la lista de correo de la documentación de Symfony, debido a que la colaboración sucede allí.

                  -

                  Por último, busca el repositorio maestro del idioma con el que deseas contribuir. Esta es la lista oficial de los repositorios maestros:

                  - -
                  -

                  Nota

                  -

                  Si quieres contribuir traducciones para un nuevo idioma, lee la sección dedicada.

                  -
                  -
                  -
                  -

                  Uniéndote al equipo de traducción

                  -

                  Si quieres ayudar a traducir algunos documentos a tu idioma o corregir algunos errores, considera unirte; es un proceso muy sencillo:

                  -
                    -
                  • Preséntese en la lista de correo de la documentación de Symfony;
                    • -
                  • (Opcional) Pregunta en cuales documentos puedes trabajar;
                    • -
                  • Bifurca el repositorio master de tu idioma (haciendo clic en el botón “Fork” en la página de GitHub);
                    • -
                  • Traduce algún documento;
                    • -
                  • Haz una solicitud de atracción (haciendo clic en Pull Request de tu página en GitHub);
                    • -
                  • El administrador del equipo acepta tus modificaciones y las combina en el repositorio maestro;
                    • -
                  • El sitio web de documentación se actualiza todas las noches desde el repositorio maestro.
                    • -
                  -
                  -
                  -

                  Añadiendo un nuevo idioma

                  -

                  Esta sección ofrece algunas pautas para comenzar la traducción de la documentación de Symfony2 para un nuevo idioma.

                  -

                  Debido a que iniciar una traducción conlleva mucho trabajo, habla acerca de tu plan en la lista de correo de la documentación de Symfony y trata de encontrar personas motivadas dispuestas a ayudar.

                  -

                  Cuando el grupo esté listo, nomina un administrador del equipo; quién será el responsable del repositorio maestro.

                  -

                  Crea el repositorio y copia los documentos en Inglés.

                  -

                  El equipo ahora puede iniciar el proceso de traducción.

                  -

                  Cuando el equipo confíe en que el repositorio está en un estado coherente y estable (se ha traducido todo, o los documentos sin traducir se han retirado de los árboles de tablas de contenido —archivos con el nombre index.rst y map.rst.inc—), el administrador del equipo puede pedir que el repositorio se añada a la lista maestra de repositorios oficiales enviando un correo electrónico a Fabien (fabien arroba symfony.com).

                  -
                  -
                  -

                  Manteniendo

                  -

                  La traducción no termina cuando se ha traducido todo. La documentación es un ente en continuo movimiento (se agregan nuevos documentos, se corrigen errores, se reorganizan párrafos, ...). El equipo de traducción tiene que seguir de cerca los cambios del repositorio en Inglés y aplicarlos a los documentos traducidos tan pronto como sea posible.

                  -
                  -

                  Prudencia

                  -

                  Los idiomas sin mantenimiento se quitan de la lista oficial de repositorios de documentación puesto que la obsolescencia es peligrosa.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/contributing/index.html b/contributing/index.html deleted file mode 100644 index 379fa2b..0000000 --- a/contributing/index.html +++ /dev/null @@ -1,156 +0,0 @@ - - - - - - - Colaborando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/assetic/apply_to_option.html b/cookbook/assetic/apply_to_option.html deleted file mode 100644 index 059dc66..0000000 --- a/cookbook/assetic/apply_to_option.html +++ /dev/null @@ -1,291 +0,0 @@ - - - - - - - Cómo aplicar un filtro Assetic a una extensión de archivo especifica — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo aplicar un filtro Assetic a una extensión de archivo especifica

                  -

                  Los filtros Assetic se pueden aplicar a archivos individuales, grupos de archivos o incluso, como veremos aquí, a archivos que tengan una determinada extensión. Para mostrarte cómo manejar cada opción, vamos a suponer que quieres usar el filtro CoffeeScript de Assetic, el cual compila archivos de CoffeeScript en Javascript.

                  -

                  La configuración principal sólo son las rutas a coffee y node. Estas por omisión son /usr/bin/coffee y /usr/bin/node respectivamente:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        coffee:
-            bin: /usr/bin/coffee
-            node: /usr/bin/node
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="coffee"
-        bin="/usr/bin/coffee"
-        node="/usr/bin/node" />
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'coffee' => array(
-            'bin'  => '/usr/bin/coffee',
-            'node' => '/usr/bin/node',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Filtrando un solo archivo

                  -

                  Ahora puedes servir un solo archivo CoffeeScript como JavaScript dentro de tus plantillas:

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/example.coffee' filter='coffee' %}
-    <script src="{{ asset_url }}" type="text/javascript"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array('@AcmeFooBundle/Resources/public/js/example.coffee'),
-    array('coffee')
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>" type="text/javascript"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -

                  Esto es todo lo que se necesita para compilar este archivo CoffeeScript y servirlo como JavaScript compilado.

                  -
                  -
                  -

                  Filtrando múltiples archivos

                  -

                  También puedes combinar varios archivos CoffeeScript y producir un único archivo:

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/example.coffee'
-               '@AcmeFooBundle/Resources/public/js/another.coffee'
-    filter='coffee' %}
-    <script src="{{ asset_url }}" type="text/javascript"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array(
-        '@AcmeFooBundle/Resources/public/js/example.coffee',
-        '@AcmeFooBundle/Resources/public/js/another.coffee',
-    ),
-    array('coffee')
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>" type="text/javascript"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, ambos archivos se sirven como un solo archivo compilado en JavaScript regular.

                  -
                  -
                  -

                  Filtrando en base a la extensión de archivo

                  -

                  Una de las grandes ventajas de usar Assetic es minimizar el número de archivos de activos para reducir las peticiones HTTP. Con el fin de usar esto completamente, sería bueno combinar todos los archivos JavaScript y CoffeeScript juntos puesto que en última instancia, todo se debe servir como JavaScript. Desafortunadamente sólo añadir los archivos JavaScript a los archivos combinados como el anterior no funciona puesto que los archivos JavaScript regulares no sobrevivirán a la compilación de CoffeeScript.

                  -

                  Este problema se puede evitar usando la opción apply_to en la configuración, lo cual te permite especificar que siempre se aplique un filtro a las extensiones de archivo en particular. En este caso puedes especificar que el filtro Coffee se aplique a todos los archivos .coffee:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        coffee:
-            bin: /usr/bin/coffee
-            node: /usr/bin/node
-            apply_to: "\.coffee$"
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="coffee"
-        bin="/usr/bin/coffee"
-        node="/usr/bin/node"
-        apply_to="\.coffee$" />
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'coffee' => array(
-            'bin'      => '/usr/bin/coffee',
-            'node'     => '/usr/bin/node',
-            'apply_to' => '\.coffee$',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Con esto, ya no tendrás que especificar el filtro coffee en la plantilla. -También puedes listar archivos JavaScript regulares, los cuales serán combinados y reproducidos como un único archivo JavaScript (con sólo ejecutar los archivos .coffee a través del filtro CoffeeScript.)

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/example.coffee'
-               '@AcmeFooBundle/Resources/public/js/another.coffee'
-               '@AcmeFooBundle/Resources/public/js/regular.js' %}
-    <script src="{{ asset_url }}" type="text/javascript"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array(
-        '@AcmeFooBundle/Resources/public/js/example.coffee',
-        '@AcmeFooBundle/Resources/public/js/another.coffee',
-        '@AcmeFooBundle/Resources/public/js/regular.js',
-    )
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>" type="text/javascript"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/assetic/asset_management.html b/cookbook/assetic/asset_management.html deleted file mode 100644 index 7a7e566..0000000 --- a/cookbook/assetic/asset_management.html +++ /dev/null @@ -1,481 +0,0 @@ - - - - - - - Cómo utilizar Assetic para gestionar activos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar Assetic para gestionar activos

                  -

                  Assetic combina dos ideas principales: assets y filters. Los activos son archivos tales como CSS, JavaScript y archivos de imagen. Los filtros son cosas que se pueden aplicar a estos archivos antes de servirlos al navegador. Esto te permite una separación entre los archivos de activos almacenados en tu aplicación y los archivos realmente presentados al usuario.

                  -

                  Sin Assetic, sólo sirves los archivos que están almacenados directamente en la aplicación:

                  -
                  -
                    -
                  • Twig
                    <script src="{{ asset('js/script.js') }}" type="text/javascript" />
-
                    -
                    -
                    • -
                  • PHP
                    <script src="<?php echo $view['assets']->getUrl('js/script.js') ?>" type="text/javascript" />
-
                    -
                    -
                    • -
                  -
                  -

                  Sin embargo, con Assetic, puedes manipular estos activos como quieras (o cargarlos desde cualquier lugar) antes de servirlos. Esto significa que puedes:

                  -
                    -
                  • Minimizarlos con minify y combinar todos tus archivos CSS y JS
                    • -
                  • Ejecutar todos (o algunos) de tus archivos CSS o JS a través de algún tipo de compilador, como LESS, SASS o CoffeeScript
                    • -
                  • Ejecutar la optimización de imagen en tus imágenes
                    • -
                  -
                  -

                  Activos

                  -

                  Assetic ofrece muchas ventajas sobre los archivos que sirves directamente. -Los archivos no se tienen que almacenar dónde son servidos y se pueden obtener de diversas fuentes, tal como desde dentro de un paquete:

                  -

                  Puedes utilizar Assetic para procesar ambos Hojas de estilo CSS -y archivos JavaScript. La filosofía detrás de añadir cualquiera básicamente la misma, pero con una sintaxis ligeramente diferente.

                  -
                  -

                  Incluyendo archivos JavaScript

                  -

                  Para incluir archivos JavaScript, usa la etiqueta javascript en cualquier plantilla. -Este generalmente vive en el bloque javascripts, si estás utilizando los nombres de bloque predefinidos de la Edición estándar de Symfony:

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/*' %}
-    <script type="text/javascript" src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array('@AcmeFooBundle/Resources/public/js/*')
-) as $url): ?>
-    <script type="text/javascript" src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  También puedes incluir hojas de estilo CSS: consulta Including CSS Stylesheets.

                  -
                  -

                  En este ejemplo, se cargan todos los archivos en el directorio Resources/public/js/ del AcmeFooBundle y se sirven desde un lugar diferente. -En realidad la etiqueta reproducida simplemente podría ser:

                  -
                  <script src="/app_dev.php/js/abcd123.js"></script>
-
                  -
                  -

                  Este es un punto clave: once you let Assetic handle your assets, the files are -served from a different location. This will cause problems with CSS files -that reference images by their relative path. See Fixing CSS Paths with the cssrewrite Filter.

                  -
                  -
                  -

                  Including CSS Stylesheets

                  -

                  To bring in CSS stylesheets, you can use the same methodologies seen -above, except with the stylesheets tag. If you’re using the default -block names from the Symfony Standard Distribution, this will usually live -inside a stylesheets block:

                  -
                  -
                    -
                  • Twig
                    {% stylesheets 'bundles/acme_foo/css/*' filter='cssrewrite' %}
-    <link rel="stylesheet" href="{{ asset_url }}" />
-{% endstylesheets %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->stylesheets(
-    array('bundles/acme_foo/css/*'),
-    array('cssrewrite')
-) as $url): ?>
-    <link rel="stylesheet" href="<?php echo $view->escape($url) ?>" />
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -

                  But because Assetic changes the paths to your assets, this will break any -background images (or other paths) that uses relative paths, unless you use -the cssrewrite filter.

                  -
                  -

                  Nota

                  -

                  Notice that in the original example that included JavaScript files, you -referred to the files using a path like @AcmeFooBundle/Resources/public/file.js, -but that in this example, you referred to the CSS files using their actual, -publicly-accessible path: bundles/acme_foo/css. You can use either, except -that there is a known issue that causes the cssrewrite filter to fail -when using the @AcmeFooBundle syntax for CSS Stylesheets.

                  -
                  -
                  -
                  -

                  Fixing CSS Paths with the cssrewrite Filter

                  -

                  Since Assetic generates new URLs for your assets, any relative paths inside -your CSS files will break. To fix this, make sure to use the cssrewrite -filter with your stylesheets tag. This parses your CSS files and corrects -the paths internally to reflect the new location.

                  -

                  You can see an example in the previous section.

                  -
                  -

                  Prudencia

                  -

                  When using the cssrewrite filter, don’t refer to your CSS files using -the @AcmeFooBundle. See the note in the above section for details.

                  -
                  -
                  -
                  -

                  Combinando activos

                  -

                  One feature of Assetic is that it will combine many files into one. This helps -to reduce the number of HTTP requests, which is great for front end performance. -It also allows you to maintain the files more easily by splitting them into -manageable parts. This can help with re-usability as you can easily split -project-specific files from those which can be used in other applications, -but still serve them as a single file:

                  -
                  -
                    -
                  • Twig
                    {% javascripts
-    '@AcmeFooBundle/Resources/public/js/*'
-    '@AcmeBarBundle/Resources/public/js/form.js'
-    '@AcmeBarBundle/Resources/public/js/calendar.js' %}
-    <script src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array(
-        '@AcmeFooBundle/Resources/public/js/*',
-        '@AcmeBarBundle/Resources/public/js/form.js',
-        '@AcmeBarBundle/Resources/public/js/calendar.js',
-    )
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -

                  In the dev environment, each file is still served individually, so that -you can debug problems more easily. However, in the prod environment -(or more specifically, when the debug flag is false), this will be -rendered as a single script tag, which contains the contents of all of -the JavaScript files.

                  -
                  -

                  Truco

                  -

                  Si eres nuevo en Assetic y tratas de usar la aplicación en el entorno prod (usando el controlador app.php), lo más probable es que se rompan todos tus CSS y JS. ¡No te preocupes! Esto es a propósito. -For details on using Assetic in the prod environment, see Volcando archivos de activos.

                  -
                  -

                  Y la combinación de archivos no sólo se aplica a tus archivos. También puedes usar Assetic para combinar activos de terceros, como jQuery, con tu propio JavaScript en un solo archivo:

                  -
                  -
                    -
                  • Twig
                    {% javascripts
-    '@AcmeFooBundle/Resources/public/js/thirdparty/jquery.js'
-    '@AcmeFooBundle/Resources/public/js/*' %}
-    <script src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array(
-        '@AcmeFooBundle/Resources/public/js/thirdparty/jquery.js',
-        '@AcmeFooBundle/Resources/public/js/*',
-    )
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Filtros

                  -

                  Una vez que son gestionados por Assetic, puedes aplicar filtros a tus activos antes de servirlos. Esto incluye filtros que comprimen la salida de tus activos a un archivo más pequeño (y mejor optimización en la interfaz de usuario). Otros filtros incluyen la compilación de archivos JavaScript desde archivos CoffeeScript y SASS a CSS. -De hecho, Assetic tiene una larga lista de filtros disponibles.

                  -

                  Muchos de los filtros no hacen el trabajo directamente, sino que utilizan otras bibliotecas para hacerlo, a menudo, esta es la razón por la que tienes que instalar esos programas también. Esto significa que a menudo tendrás que instalar una biblioteca de terceros para usar un filtro. La gran ventaja de utilizar Assetic para invocar estas bibliotecas (en lugar de utilizarlas directamente) es que en lugar de tener que ejecutarlo manualmente cuando has trabajado en los archivos, Assetic se hará cargo de esto por ti y elimina por completo este paso de tu proceso de desarrollo y despliegue.

                  -

                  Para usar un filtro debes especificarlo en la configuración de Assetic. -Añadir un filtro aquí no quiere decir que se esté utilizando —sólo significa que está disponible para usarlo (vamos a utilizar el filtro en seguida).

                  -

                  Por ejemplo, para utilizar el JavaScript YUI Compressor debes añadir la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        yui_js:
-            jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar"
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="yui_js"
-        jar="%kernel.root_dir%/Resources/java/yuicompressor.jar" />
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'yui_js' => array(
-            'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, para realmente usar el filtro en un grupo de archivos JavaScript, añade esto a tu plantilla:

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='yui_js' %}
-    <script src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array('@AcmeFooBundle/Resources/public/js/*'),
-    array('yui_js')
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -

                  Puedes encontrar una guía más detallada sobre la configuración y uso de filtros Assetic así como detalles del modo de depuración Assetic en Cómo minimizar JavaScript y hojas de estilo con YUI Compressor.

                  -
                  -
                  -

                  Controlando la URL utilizada

                  -

                  Si quieres, puedes controlar las URL que produce Assetic. Esto se hace desde la plantilla y es relativo a la raíz del documento público:

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/*' output='js/compiled/main.js' %}
-    <script src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array('@AcmeFooBundle/Resources/public/js/*'),
-    array(),
-    array('output' => 'js/compiled/main.js')
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Symfony también contiene un método para caché rota, donde la URL final generada por Assetic en el entorno prod contiene un parámetro de consulta que puedes incrementar por medio de configuración en cada despliegue. Para más información, consulta la opción de configuración assets_version.

                  -
                  -
                  -
                  -

                  Volcando archivos de activos

                  -

                  En el entorno dev, Assetic genera rutas para los archivos CSS y JavaScript que no existen físicamente en el ordenador. Pero, sin embargo, los reproduce porque un controlador interno de Symfony abre y sirve los archivos volcando el contenido (después de ejecutar todos los filtros).

                  -

                  Este tipo de servicio dinámico de procesar los activos es muy bueno porque significa que puedes ver inmediatamente el nuevo estado de los archivos de activos que cambies. -Por otro lado es malo, porque puede ser bastante lento. Si estás utilizando una gran cantidad de filtros, puede ser realmente frustrante.

                  -

                  Afortunadamente, Assetic proporciona una manera de volcar tus activos a los archivos reales, en lugar de generarlos dinámicamente.

                  -
                  -

                  Volcando archivos de activos en el entorno prod

                  -

                  En entorno prod, cada uno de tus archivos JS y CSS está representado por una sola etiqueta. En otras palabras, en lugar de incluir cada archivo JavaScript en tu código fuente, probablemente acabes viendo algo como esto:

                  -
                  <script src="/app_dev.php/js/abcd123.js"></script>
-
                  -
                  -

                  Por otra parte, ese archivo no existe en realidad, ni es reproducido dinámicamente por Symfony (debido a que los archivos de activos se encuentran en el entorno dev). Esto es a propósito —permitir que Symfony genere estos archivos de forma dinámica en un entorno de producción es demasiado lento.

                  -

                  En cambio, cada vez que utilices tu aplicación en el entorno prod (y por lo tanto, cada vez que la despliegues), debes ejecutar la siguiente tarea:

                  -
                  $ php app/console assetic:dump --env=prod --no-debug
-
                  -
                  -

                  Esto va a generar y escribir físicamente todos los archivos que necesitas (por ejemplo /js/abcd123.js). -Si actualizas cualquiera de tus activos, tendrás que ejecutarlo de nuevo para generar el archivo.

                  -
                  -
                  -

                  Volcando archivos de activos en el entorno dev

                  -

                  Por omisión, Symfony procesa dinámicamente cada ruta de activo generada en el entorno dev. Esto no tiene ninguna desventaja (puedes ver tus cambios inmediatamente), salvo que los activos se pueden cargar notablemente lento. Si sientes que tus activos se cargan demasiado lento, sigue esta guía.

                  -

                  En primer lugar, dile a Symfony que deje de intentar procesar estos archivos de forma dinámica. Haz el siguiente cambio en tu archivo config_dev.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_dev.yml
-assetic:
-    use_controller: false
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_dev.xml -->
-<assetic:config use-controller="false" />
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_dev.php
-$container->loadFromExtension('assetic', array(
-    'use_controller' => false,
-));
-
                    -
                    -
                    • -
                  -
                  -

                  A continuación, debido a que Symfony ya no genera estos activos para ti, tendrás que deshacerte de ellos manualmente. Para ello, ejecuta lo siguiente:

                  -
                  $ php app/console assetic:dump
-
                  -
                  -

                  Esto escribe físicamente todos los archivos de activos que necesita tu entorno dev. La gran desventaja es que necesitas hacerlo manualmente cada vez que actualizas tus activos. Afortunadamente, pasando la opción --watch, la orden regenerará automáticamente tus activos a medida que cambien:

                  -
                  $ php app/console assetic:dump --watch
-
                  -
                  -

                  Debido a que ejecutas esta orden en el entorno dev puede generar un montón de archivos, por lo general es una buena idea apuntar tus archivos de activos a un directorio aislado (por ejemplo /js/compiled), para mantener las cosas organizadas:

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/*' output='js/compiled/main.js' %}
-    <script src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array('@AcmeFooBundle/Resources/public/js/*'),
-    array(),
-    array('output' => 'js/compiled/main.js')
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/assetic/index.html b/cookbook/assetic/index.html deleted file mode 100644 index 58a99f0..0000000 --- a/cookbook/assetic/index.html +++ /dev/null @@ -1,160 +0,0 @@ - - - - - - - Assetic — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/assetic/jpeg_optimize.html b/cookbook/assetic/jpeg_optimize.html deleted file mode 100644 index 59bc849..0000000 --- a/cookbook/assetic/jpeg_optimize.html +++ /dev/null @@ -1,372 +0,0 @@ - - - - - - - Cómo utilizar Assetic para optimizar imágenes con funciones Twig — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar Assetic para optimizar imágenes con funciones Twig

                  -

                  Entre sus muchos filtros, Assetic tiene cuatro filtros que puedes utilizar para optimizar imágenes al vuelo. Esto te permite obtener el beneficio de archivos de menor tamaño sin tener que usar un editor de imágenes para procesar cada imagen. Los resultados se almacenan en caché y se puede vaciar en producción para que no haya impacto en el rendimiento para los usuarios finales.

                  -
                  -

                  Usando Jpegoptim

                  -

                  Jpegoptim es una utilidad para la optimización de archivos JPEG. Para usarlo con Assetic, añade lo siguiente a la configuración de Assetic:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        jpegoptim:
-            bin: ruta/a/jpegoptim
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="jpegoptim"
-        bin="ruta/a/jpegoptim" />
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'jpegoptim' => array(
-            'bin' => 'ruta/a/jpegoptim',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Ten en cuenta que al usar jpegoptim, ya lo debes tener instalado en tu sistema. La opción bin apunta a la ubicación de los binarios compilados.

                  -
                  -

                  Ahora lo puedes utilizar desde una plantilla:

                  -
                  -
                    -
                  • Twig
                    {% image '@AcmeFooBundle/Resources/public/images/example.jpg'
-    filter='jpegoptim' output='/images/example.jpg' %}
-    <img src="{{ asset_url }}" alt="Example"/>
-{% endimage %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->images(
-    array('@AcmeFooBundle/Resources/public/images/example.jpg'),
-    array('jpegoptim')
-) as $url): ?>
-    <img src="<?php echo $view->escape($url) ?>" alt="Example"/>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Eliminando todos los datos EXIF

                  -

                  De manera predeterminada, al ejecutar este filtro sólo eliminas parte de la metainformación almacenada en el archivo. Todos los datos EXIF ​​y comentarios no se eliminan, pero los puedes quitar usando la opción strip_all:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        jpegoptim:
-            bin: ruta/a/jpegoptim
-            strip_all: true
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="jpegoptim"
-        bin="ruta/a/jpegoptim"
-        strip_all="true" />
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'jpegoptim' => array(
-            'bin'       => 'path/to/jpegoptim',
-            'strip_all' => 'true',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Reduciendo la calidad máxima

                  -

                  El nivel de calidad del JPEG de manera predeterminada no se ve afectado. Puedes obtener mayor reducción de tamaño del archivo estableciendo la configuración de calidad máxima más baja que el nivel actual de las imágenes. Esto, por supuesto, a expensas de la calidad de la imagen:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        jpegoptim:
-            bin: ruta/a/jpegoptim
-            max: 70
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="jpegoptim"
-        bin="ruta/a/jpegoptim"
-        max="70" />
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'jpegoptim' => array(
-            'bin' => 'ruta/a/jpegoptim',
-            'max' => '70',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Sintaxis corta: Función Twig

                  -

                  Si estás utilizando Twig, es posible lograr todo esto con una sintaxis más corta habilitando y utilizando una función especial de Twig. Comienza por agregar la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        jpegoptim:
-            bin: ruta/a/jpegoptim
-    twig:
-        functions:
-            jpegoptim: ~
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="jpegoptim"
-        bin="ruta/a/jpegoptim" />
-    <assetic:twig>
-        <assetic:twig_function
-            name="jpegoptim" />
-    </assetic:twig>
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'jpegoptim' => array(
-            'bin' => 'ruta/a/jpegoptim',
-        ),
-    ),
-    'twig' => array(
-        'functions' => array('jpegoptim'),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora,puedes cambiar la plantilla Twig a lo siguiente:

                  -
                  <img src="{{ jpegoptim('@AcmeFooBundle/Resources/public/images/example.jpg') }}" alt="Example"/>
-
                  -
                  -

                  Puedes especificar el directorio de salida en la configuración de la siguiente manera:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    filters:
-        jpegoptim:
-            bin: ruta/a/jpegoptim
-    twig:
-        functions:
-            jpegoptim: { output: images/*.jpg }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="jpegoptim"
-        bin="ruta/a/jpegoptim" />
-    <assetic:twig>
-        <assetic:twig_function
-            name="jpegoptim"
-            output="images/*.jpg" />
-    </assetic:twig>
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    'filters' => array(
-        'jpegoptim' => array(
-            'bin' => 'ruta/a/jpegoptim',
-        ),
-    ),
-    'twig' => array(
-        'functions' => array(
-            'jpegoptim' => array(
-                output => 'images/*.jpg'
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/assetic/yuicompressor.html b/cookbook/assetic/yuicompressor.html deleted file mode 100644 index a43240a..0000000 --- a/cookbook/assetic/yuicompressor.html +++ /dev/null @@ -1,265 +0,0 @@ - - - - - - - Cómo minimizar JavaScript y hojas de estilo con YUI Compressor — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo minimizar JavaScript y hojas de estilo con YUI Compressor

                  -

                  Yahoo! proporciona una excelente utilidad para minimizar (minify) JavaScript y hojas de estilo para que viajen más rápido por la red, el YUI Compressor. Gracias a Assetic, puedes tomar ventaja de esta herramienta con mucha facilidad.

                  -
                  -

                  Descargando el JAR de YUI Compressor

                  -

                  El YUI Compressor está escrito en Java y se distribuye como JAR. Descarga el JAR desde el sitio Yahoo! y guárdalo en app/Resources/java/yuicompressor.jar.

                  -
                  -
                  -

                  Configurando los filtros de YUI

                  -

                  Ahora debes configurar dos filtros Assetic en tu aplicación, uno para minimizar JavaScript con el compresor YUI y otro para minimizar hojas de estilo:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-assetic:
-    # java: "/usr/bin/java"
-    filters:
-        yui_css:
-            jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar"
-        yui_js:
-            jar: "%kernel.root_dir%/Resources/java/yuicompressor.jar"
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<assetic:config>
-    <assetic:filter
-        name="yui_css"
-        jar="%kernel.root_dir%/Resources/java/yuicompressor.jar" />
-    <assetic:filter
-        name="yui_js"
-        jar="%kernel.root_dir%/Resources/java/yuicompressor.jar" />
-</assetic:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('assetic', array(
-    // 'java' => '/usr/bin/java',
-    'filters' => array(
-        'yui_css' => array(
-            'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar',
-        ),
-        'yui_js' => array(
-            'jar' => '%kernel.root_dir%/Resources/java/yuicompressor.jar',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Los usuarios de Windows se tienen que acordar de actualizar la configuración a la ubicación correcta de Java. -En Windows 7 x64 bits por omisión es C:\Archivos de programa (x86)\Java\jre6\bin\java.exe.

                  -
                  -

                  Ahora tienes acceso a dos nuevos filtros Assetic en tu aplicación: -yui_css y yui_js. Estos utilizan el compresor de YUI para minimizar hojas de estilo y JavaScript, respectivamente.

                  -
                  -
                  -

                  Minimizando tus activos

                  -

                  Ahora tienes configurado el compresor YUI, pero nada va a pasar hasta que apliques uno de estos filtros a un activo. Dado que tus activos son una parte de la capa de la vista, este trabajo se hace en tus plantillas:

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='yui_js' %}
-    <script src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array('@AcmeFooBundle/Resources/public/js/*'),
-    array('yui_js')
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  El ejemplo anterior asume que tienes un paquete llamado AcmeFooBundle y tus archivos JavaScript están bajo el directorio Resources/public/js de tu paquete. No obstante, esto no es importante —puedes incluir tus archivos Javascript sin importar donde se encuentren.

                  -
                  -

                  Con la incorporación del filtro yui_js a las etiquetas de los activos anteriores, ahora deberías ver llegar mucho más rápido tus JavaScripts minimizados a través del cable. Puedes repetir el mismo proceso para minimizar tus hojas de estilo.

                  -
                  -
                    -
                  • Twig
                    {% stylesheets '@AcmeFooBundle/Resources/public/css/*' filter='yui_css' %}
-    <link rel="stylesheet" type="text/css" media="screen" href="{{ asset_url }}" />
-{% endstylesheets %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->stylesheets(
-    array('@AcmeFooBundle/Resources/public/css/*'),
-    array('yui_css')
-) as $url): ?>
-    <link rel="stylesheet" type="text/css" media="screen" href="<?php echo $view->escape($url) ?>" />
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Desactivando la minimización en modo de depuración

                  -

                  El JavaScript y las hojas de estilo minimizadas son muy difíciles de leer, y mucho más de depurar. Debido a esto, Assetic te permite desactivar un determinado filtro cuando tu aplicación está en modo de depuración. Para ello, puedes prefijar el nombre del filtro en tu plantilla con un signo de interrogación: ?. Esto le dice a Assetic que aplique este filtro sólo cuando el modo de depuración está desactivado.

                  -
                  -
                    -
                  • Twig
                    {% javascripts '@AcmeFooBundle/Resources/public/js/*' filter='?yui_js' %}
-    <script src="{{ asset_url }}"></script>
-{% endjavascripts %}
-
                    -
                    -
                    • -
                  • PHP
                    <?php foreach ($view['assetic']->javascripts(
-    array('@AcmeFooBundle/Resources/public/js/*'),
-    array('?yui_js')
-) as $url): ?>
-    <script src="<?php echo $view->escape($url) ?>"></script>
-<?php endforeach; ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  En lugar de añadir el filtro a las etiquetas de activos, también lo puedes activar globalmente añadiendo el atributo apply-to a la configuración del filtro, por ejemplo, en el filtro yui_js apply_to: "\.js$". Para aplicar el filtro sólo en producción, agrega esto al archivo config_prod en lugar de al archivo de configuración común. Para más detalles sobre la aplicación de filtros por extensión de archivo, ve Filtrando en base a la extensión de archivo.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/best_practices.html b/cookbook/bundles/best_practices.html deleted file mode 100644 index 7053f64..0000000 --- a/cookbook/bundles/best_practices.html +++ /dev/null @@ -1,357 +0,0 @@ - - - - - - - Cómo usar las mejores prácticas para estructurar paquetes — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar las mejores prácticas para estructurar paquetes

                  -

                  Un paquete es un directorio que tiene una estructura bien definida y puede alojar cualquier cosa, desde clases hasta controladores y recursos web. A pesar de que los paquetes son tan flexibles, se deben seguir algunas recomendaciones si deseas distribuirlos.

                  -
                  -

                  Nombre de paquete

                  -

                  Un paquete también es un espacio de nombres PHP. El espacio de nombres debe seguir los estándares de interoperabilidad técnica de los espacios de nombres y nombres de clases de PHP 5.3: comienza con un segmento de proveedor, seguido por cero o más segmentos de categoría, y termina con el nombre corto del espacio de nombres, el cual debe terminar con el sufijo Bundle.

                  -

                  Un espacio de nombres se convierte en un paquete tan pronto como se agrega una clase bundle al mismo. El nombre de la clase bundle debe seguir estas sencillas reglas:

                  -
                    -
                  • Solo utiliza caracteres alfanuméricos y guiones bajos;
                    • -
                  • Usa mayúsculas intercaladas en el nombre;
                    • -
                  • Usa un nombre corto pero descriptivo (de no más de dos palabras);
                    • -
                  • Prefija el nombre con la concatenación del proveedor (y, opcionalmente, la categoría del espacio de nombres);
                    • -
                  • Sufija el nombre con Bundle.
                    • -
                  -

                  Estos son algunos espacios de nombres y nombres de clase bundle válidos:

                  - ---- - - - - - - - - - - - - - - - - -
                  Espacio de nombresNombre de clase Bundle
                  Acme\Bundle\BlogBundleAcmeBlogBundle
                  Acme\Bundle\Social\BlogBundleAcmeSocialBlogBundle
                  Acme\BlogBundleAcmeBlogBundle
                  -

                  Por convención, el método getName() de la clase bundle debe devolver el nombre de la clase.

                  -
                  -

                  Nota

                  -

                  Si compartes tu paquete públicamente, debes utilizar el nombre de la clase bundle como nombre del repositorio (AcmeBlogBundle y no BlogBundle por ejemplo).

                  -
                  -
                  -

                  Nota

                  -

                  Los paquetes del núcleo de Symfony2 no prefijan la clase Bundle con Symfony y siempre agregan un subespacio de nombres Bundle; por ejemplo: -Symfony\Bundle\FrameworkBundle\FrameworkBundle.

                  -
                  -

                  Cada paquete tiene un alias, el cual es la versión corta en minúsculas del nombre del paquete con guiones bajos (acme_hello para AcmeHelloBundle, o acme_social_blog para Acme\Social\BlogBundle por ejemplo). Este alias se utiliza para forzar la exclusividad dentro de un paquete (ve abajo algunos ejemplos de uso).

                  -
                  -
                  -

                  Estructura del directorio

                  -

                  La estructura básica del directorio del paquete HelloBundle se debe leer de la siguiente manera:

                  -
                  XXX/...
-    HelloBundle/
-        HelloBundle.php
-        Controller/
-        Resources/
-            meta/
-                LICENSE
-            config/
-            doc/
-                index.rst
-            translations/
-            views/
-            public/
-        Tests/
-
                  -
                  -

                  Los directorios XXX reflejan la estructura del espacio de nombres del paquete.

                  -

                  Los siguientes archivos son obligatorios:

                  -
                    -
                  • HelloBundle.php;
                    • -
                  • Resources/meta/LICENSE: La licencia completa para el código;
                    • -
                  • Resources/doc/index.rst: El archivo raíz de la documentación del paquete.
                    • -
                  -
                  -

                  Nota

                  -

                  Estos convenios garantizan que las herramientas automatizadas pueden trabajar confiablemente en esta estructura predeterminada.

                  -
                  -

                  La profundidad de los subdirectorios se debe reducir al mínimo en la mayoría de las clases y archivos utilizados (2 niveles como máximo). Puedes definir más niveles para archivos no estratégicos, los menos utilizados.

                  -

                  El directorio del paquete es de sólo lectura. Si necesitas escribir archivos temporales, guárdalos en el directorio cache/ o log/ de la aplicación anfitriona. Las herramientas pueden generar archivos en la estructura de directorios del paquete, pero sólo si los archivos generados van a formar parte del repositorio.

                  -

                  Las siguientes clases y archivos tienen emplazamientos específicos:

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  TipoDirectorio
                  OrdenesCommand/
                  ControladoresController/
                  Extensiones contenedoras de serviciosDependencyInjection/
                  Escuchas de eventosEventListener/
                  ConfiguraciónResources/config/
                  Recursos WebResources/public/
                  Archivos de traducciónResources/translations/
                  PlantillasResources/views/
                  Pruebas unitarias y funcionalesTests/
                  -
                  -
                  -

                  Clases

                  -

                  La estructura del directorio de un paquete se utiliza como la jerarquía del espacio de nombres. Por ejemplo, un controlador HelloController se almacena en /HelloBundle/Controller/HelloController.php y el nombre de clase completamente cualificado es Bundle\HelloBundle\Controller\HelloController.

                  -

                  Todas las clases y archivos deben seguir los estándares de codificación Symfony2.

                  -

                  Algunas clases se deben ver como fachada y deben ser lo más breves posible, al igual que las ordenes, ayudantes, escuchas y controladores.

                  -

                  Las clases que conectan el Evento al Despachador deben llevar el posfijo Listener.

                  -

                  Las clases de excepciones se deben almacenar en un subespacio de nombres Exception.

                  -
                  -
                  -

                  Terceros

                  -

                  Un paquete no debe integrar bibliotecas PHP de terceros. Se debe confiar en la carga automática estándar de Symfony2 en su lugar.

                  -

                  Un paquete no debería integrar bibliotecas de terceros escritas en JavaScript, CSS o cualquier otro lenguaje.

                  -
                  -
                  -

                  Pruebas

                  -

                  Un paquete debe venir con una batería de pruebas escritas con PHPUnit , las cuales se deben almacenar en el directorio Test/. Las pruebas deben seguir los siguientes principios:

                  -
                    -
                  • La batería de pruebas se debe ejecutar con una simple orden phpunit desde una aplicación de ejemplo;
                    • -
                  • Las pruebas funcionales sólo se deben utilizar para probar la respuesta de salida y alguna información de perfilado si tiene alguno;
                    • -
                  • Las pruebas por lo menos deben cubrir el 95% del código base.
                    • -
                  -
                  -

                  Nota

                  -

                  Una batería de pruebas no debe contener archivos AllTests.php, sino que se debe basar en la existencia de un archivo phpunit.xml.dist.

                  -
                  -
                  -
                  -

                  Documentación

                  -

                  Todas las clases y funciones deben venir con PHPDoc completo.

                  -

                  También deberá proporcionar abundante documentación provista en formato reStructuredText, bajo el directorio Resources/doc/; el archivo Resources/doc/index.rst es el único archivo obligatorio y debe ser el punto de entrada para la documentación.

                  -
                  -
                  -

                  Controladores

                  -

                  Como práctica recomendada, los controladores en un paquete que está destinado a ser distribuido a otros no debe extender la clase base Symfony\Bundle\FrameworkBundle\Controller\Controller`. -Puede implementar la Symfony\Component\DependencyInjection\ContainerAwareInterface o en su lugar extender la clase Symfony\Component\DependencyInjection\ContainerAware.

                  -
                  -

                  Nota

                  -

                  Si echas un vistazo a los métodos de la clase Symfony\Bundle\FrameworkBundle\Controller\Controller, podrás ver que sólo son buenos accesos directos para facilitar la curva de aprendizaje.

                  -
                  -
                  -
                  -

                  Enrutado

                  -

                  Si el paquete proporciona rutas, estas se deben prefijar con el alias del paquete. -Para un AcmeBlogBundle por ejemplo, todas las rutas deben llevar el prefijo acme_blog_.

                  -
                  -
                  -

                  Plantillas

                  -

                  Si un paquete proporciona plantillas, estas deben utilizar Twig. Un paquete no debe proporcionar un diseño principal, salvo si ofrece una aplicación completa.

                  -
                  -
                  -

                  Archivos de traducción

                  -

                  Si un paquete proporciona traducción de mensajes, se deben definir en formato XLIFF; el dominio se debe mencionar después del nombre del paquete (bundle.hello).

                  -

                  Un paquete no debe reemplazar los mensajes de otro paquete existente.

                  -
                  -
                  -

                  Configurando

                  -

                  Para proporcionar mayor flexibilidad, un paquete puede proporcionar opciones configurables utilizando los mecanismos integrados de Symfony2.

                  -

                  Para ajustes de configuración simples, confía en los parámetros predeterminados de la configuración de Symfony2. Los parámetros de Symfony2 simplemente son pares clave/valor; un valor es cualquier valor PHP válido. El nombre de cada parámetro debe comenzar con el alias del paquete, aunque esto es sólo una sugerencia de buenas prácticas. El resto del nombre del parámetro utiliza un punto (.) para separar las diferentes partes (por ejemplo, acme_hello.email.from).

                  -

                  El usuario final puede proporcionar valores en cualquier archivo de configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-parameters:
-    acme_hello.email.from: fabien@example.com
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<parameters>
-    <parameter key="acme_hello.email.from">fabien@example.com</parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->setParameter('acme_hello.email.from', 'fabien@example.com');
-
                    -
                    -
                    • -
                  • YAML
                    ; app/config/config.ini
-[parameters]
-acme_hello.email.from = fabien@example.com
-
                    -
                    -
                    • -
                  -
                  -

                  Recupera los parámetros de configuración en tu código desde el contenedor:

                  -
                  $container->getParameter('acme_hello.email.from');
-
                  -
                  -

                  Incluso si este mecanismo es bastante simple, te animamos a usar la configuración semántica descrita en el recetario.

                  -
                  -

                  Nota

                  -

                  Si vas a definir servicios, estos también se deben prefijar con el alias del paquete.

                  -
                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/extension.html b/cookbook/bundles/extension.html deleted file mode 100644 index ed6a809..0000000 --- a/cookbook/bundles/extension.html +++ /dev/null @@ -1,593 +0,0 @@ - - - - - - - Cómo exponer la configuración semántica de un paquete — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo exponer la configuración semántica de un paquete

                  -

                  Si abres el archivo de configuración de tu aplicación (por lo general app/config/config.yml), puedes encontrar una serie de configuraciones de diferentes «espacios de nombres», como framework, twig y doctrine. Cada una de estas configura un paquete específico, lo cual te permite configurar las cosas a nivel superior y luego dejar que el paquete haga todo lo de bajo nivel, haciendo los cambios complejos que resulten.

                  -

                  Por ejemplo, el siguiente fragmento le dice al FrameworkBundle que habilite la integración de formularios, lo cual implica la definición de unos cuantos servicios, así como la integración de otros componentes relacionados:

                  -
                  -
                    -
                  • YAML
                    framework:
-    # ...
-    form: true
-
                    -
                    -
                    • -
                  • XML
                    <framework:config>
-    <framework:form />
-</framework:config>
-
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('framework', array(
-    // ...
-    'form' => true,
-    // ...
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Cuando creas un paquete, tienes dos opciones sobre cómo manejar la configuración:

                  -
                    -

                  1. Configuración normal del servicio (fácil):

                    -
                    -

                    Puedes especificar tus servicios en un archivo de configuración (por ejemplo, services.yml) que vive en tu paquete y luego importarlo desde la configuración principal de tu aplicación. Esto es realmente fácil, rápido y completamente eficaz. Si usas parámetros, entonces todavía tienes cierta flexibilidad para personalizar el paquete desde la configuración de tu aplicación. Consulta «Importando configuración con imports» para más detalles.

                    -
                    -
                    2. -

                  2. Exponiendo la configuración semántica (avanzado):

                    -
                    -

                    Esta es la forma de configuración que se hace con los paquetes básicos (como se describió anteriormente). La idea básica es que, en lugar de permitir al usuario sustituir parámetros individuales, permites al usuario configurar unos cuantos, en concreto la creación de opciones. A medida que desarrollas el paquete, vas analizando la configuración y cargas tus servicios en una clase «Extensión». Con este método, no tendrás que importar ningún recurso de configuración desde la configuración principal de tu aplicación: la clase Extension puede manejar todo esto.

                    -
                    -
                    3. -
                  -

                  La segunda opción —de la cual aprenderás en este artículo— es mucho más flexible, pero también requiere más tiempo de configuración. Si te preguntas qué método debes utilizar, probablemente sea una buena idea empezar con el método #1, y más adelante, si es necesario, cambiar al #2.

                  -

                  El segundo método tiene varias ventajas específicas:

                  -
                    -
                  • Es mucho más poderoso que la simple definición de parámetros: un valor de opción específico podría inducir la creación de muchas definiciones de servicios;
                    • -
                  • La habilidad de tener jerarquías de configuración
                    • -
                  • La fusión inteligente de varios archivos de configuración (por ejemplo, config_dev.yml y config.yml) sustituye los demás ajustes;
                    • -
                  • Configurando la validación (si utilizas una clase Configuración);
                    • -
                  • Autocompletado en tu IDE cuando creas un XSD y los desarrolladores del IDE utilizan XML.
                    • -
                  -
                  -

                  Sustituyendo parámetros del paquete

                  -

                  Si un paquete proporciona una clase Extension, entonces, generalmente no debes reemplazar los parámetros del contenedor de servicios de ese paquete. La idea es que si está presente una clase Extension, cada ajuste que deba ser configurable debe estar presente en la configuración disponible en esa clase. En otras palabras, la clase Extension define cómo dibulgas todas las opciones de configuración apoyadas para las cuales, por mantenimiento, existe compatibilidad hacia atrás.

                  -
                  -
                  -

                  Creando una clase Extension

                  -

                  Si eliges exponer una configuración semántica de tu paquete, primero tendrás que crear una nueva clase «Extension», la cual debe manejar el proceso. -Esta clase debe vivir en el directorio DependencyInjection de tu paquete y su nombre se debe construir reemplazando el sufijo Bundle del nombre de la clase del paquete con Extension. Por ejemplo, la clase Extension de AcmeHelloBundle se llamaría AcmeHelloExtension:

                  -
                  // Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
-namespace Acme\HelloBundle\DependencyInjection;
-
-use Symfony\Component\HttpKernel\DependencyInjection\Extension;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-class AcmeHelloExtension extends Extension
-{
-    public function load(array $configs, ContainerBuilder $container)
-    {
-        // ... aquí se lleva a cabo toda la lógica
-    }
-
-    public function getXsdValidationBasePath()
-    {
-        return __DIR__.'/../Resources/config/';
-    }
-
-    public function getNamespace()
-    {
-        return 'http://www.ejemplo.com/symfony/schema/';
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Los métodos getXsdValidationBasePath y getNamespace sólo son necesarios si el paquete opcional XSD proporciona la configuración.

                  -
                  -

                  La presencia de la clase anterior significa que ahora puedes definir una configuración de espacio de nombres acme_hello en cualquier archivo de configuración. El espacio de nombres acme_hello se construyó a partir del nombre en minúsculas de la clase Extension eliminando la palabra Extension, a continuación un guión bajo y el resto del nombre. En otras palabras, AcmeHelloExtension se convierte en acme_hello.

                  -

                  Puedes empezar de inmediato, especificando la configuración en este espacio de nombres:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-acme_hello: ~
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<?xml version="1.0" ?>
-
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:acme_hello="http://www.ejemplo.com/symfony/schema/"
-    xsi:schemaLocation="http://www.ejemplo.com/symfony/schema/ http://www.ejemplo.com/symfony/schema/hello-1.0.xsd">
-
-   <acme_hello:config />
-
-   <!-- ... -->
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('acme_hello', array());
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Si sigues las convenciones de nomenclatura mencionadas anteriormente, entonces el método load() el cual carga el código de tu extensión es llamado siempre que tu paquete sea registrado en el núcleo. En otras palabras, incluso si el usuario no proporciona ninguna configuración (es decir, la entrada acme_hello ni siquiera figura), el método load() será llamado y se le pasará un arreglo $configs vacío. Todavía puedes proporcionar algunos parámetros predeterminados para tu paquete si lo deseas.

                  -
                  -
                  -
                  -

                  Analizando el arreglo $configs

                  -

                  Cada vez que un usuario incluya el espacio de nombres acme_hello en un archivo de configuración, la configuración bajo este se agrega a un gran arreglo de configuraciones y se pasa al método load() de tu extensión (Symfony2 automáticamente convierte XML y YAML a un arreglo).

                  -

                  Tomemos la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-acme_hello:
-    foo: fooValue
-    bar: barValue
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<?xml version="1.0" ?>
-
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:acme_hello="http://www.ejemplo.com/symfony/schema/"
-    xsi:schemaLocation="http://www.ejemplo.com/symfony/schema/ http://www.ejemplo.com/symfony/schema/hello-1.0.xsd">
-
-    <acme_hello:config foo="fooValue">
-        <acme_hello:bar>barValue</acme_hello:bar>
-    </acme_hello:config>
-
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('acme_hello', array(
-    'foo' => 'fooValue',
-    'bar' => 'barValue',
-));
-
                    -
                    -
                    • -
                  -
                  -

                  El arreglo pasado a tu método load() se verá así:

                  -
                  array(
-    array(
-        'foo' => 'fooValue',
-        'bar' => 'barValue',
-    ),
-)
-
                  -
                  -

                  Ten en cuenta que se trata de un arreglo de arreglos, y no sólo un único arreglo plano con los valores de configuración. Esto es intencional. Por ejemplo, si acme_hello aparece en otro archivo de configuración —digamos en config_dev.yml— con diferentes valores bajo él, entonces el arreglo entrante puede tener este aspecto:

                  -
                  array(
-    array(
-        'foo' => 'fooValue',
-        'bar' => 'barValue',
-    ),
-    array(
-        'foo' => 'fooDevValue',
-        'baz' => 'newConfigEntry',
-    ),
-)
-
                  -
                  -

                  El orden de los dos arreglos depende de cuál es el primer conjunto.

                  -

                  Entonces, es tu trabajo, decidir cómo se fusionan estas configuraciones. Es posible que, por ejemplo, después tengas que sustituir valores anteriores o alguna combinación de ellos.

                  -

                  Más tarde, en la sección clase Configuración, aprenderás una forma realmente robusta para manejar esto. Pero por ahora, sólo puedes combinarlos manualmente:

                  -
                  public function load(array $configs, ContainerBuilder $container)
-{
-    $config = array();
-    foreach ($configs as $subConfig) {
-        $config = array_merge($config, $subConfig);
-    }
-
-    // ... ahora usa el arreglo $config plano
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  Asegúrate de que la técnica de fusión anterior tenga sentido para tu paquete. Este es sólo un ejemplo, y debes tener cuidado de no usarlo a ciegas.

                  -
                  -
                  -
                  -

                  Usando el método load()

                  -

                  Dentro de load(), la variable $container se refiere a un contenedor que sólo sabe acerca de esta configuración de espacio de nombres (es decir, no contiene información de los servicios cargados por otros paquetes). El objetivo del método load() es manipular el contenedor, añadir y configurar cualquier método o servicio necesario por tu paquete.

                  -
                  -

                  Cargando la configuración de recursos externos

                  -

                  Una de las cosas comunes por hacer es cargar un archivo de configuración externo que puede contener la mayor parte de los servicios que necesita tu paquete. Por ejemplo, supongamos que tienes un archivo services.xml el cual contiene gran parte de la configuración de los servicios en tu paquete:

                  -
                  use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
-use Symfony\Component\Config\FileLocator;
-
-public function load(array $configs, ContainerBuilder $container)
-{
-    // ... prepara tu variable $config
-
-    $loader = new XmlFileLoader(
-        $container,
-        new FileLocator(__DIR__.'/../Resources/config')
-    );
-    $loader->load('services.xml');
-}
-
                  -
                  -

                  Incluso lo podrías hacer condicionalmente, basándote en uno de los valores de configuración. -Por ejemplo, supongamos que sólo deseas cargar un conjunto de servicios si una opción habilitado es pasada y fijada en true:

                  -
                  public function load(array $configs, ContainerBuilder $container)
-{
-    // ... prepara tu variable $config
-
-    $loader = new XmlFileLoader(
-        $container,
-        new FileLocator(__DIR__.'/../Resources/config')
-    );
-
-    if (isset($config['enabled']) && $config['enabled']) {
-        $loader->load('services.xml');
-    }
-}
-
                  -
                  -
                  -
                  -

                  Configurando servicios y ajustando parámetros

                  -

                  Una vez que hayas cargado alguna configuración de servicios, posiblemente necesites modificar la configuración basándote en alguno de los valores entrantes. Por ejemplo, supón que tienes un servicio cuyo primer argumento es algún «tipo» de cadena que se debe utilizar internamente. Quisieras que el usuario del paquete lo configurara fácilmente, por tanto en el archivo de configuración de tu servicio (por ejemplo, services.xml), defines este servicio y utilizas un parámetro en blanco —acme_hello.my_service_options— como primer argumento:

                  -
                  <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
-
-    <parameters>
-        <parameter key="acme_hello.my_service_type" />
-    </parameters>
-
-        <services>
-        <service id="acme_hello.my_service" class="Acme\HelloBundle\MyService">
-            <argument>%acme_hello.my_service_type%</argument>
-        </service>
-        </services>
-</container>
-
                  -
                  -

                  Pero ¿por qué definir un parámetro vacío y luego pasarlo a tu servicio? -La respuesta es que vas a establecer este parámetro en tu clase Extension, basándote en los valores de configuración entrantes. Supongamos, por ejemplo, que deseas permitir al usuario definir esta opción de tipo en una clave denominada my_type. -Para hacerlo agrega lo siguiente al método load():

                  -
                  public function load(array $configs, ContainerBuilder $container)
-{
-    // ... prepara tu variable $config
-
-    $loader = new XmlFileLoader(
-        $container,
-        new FileLocator(__DIR__.'/../Resources/config')
-    );
-    $loader->load('services.xml');
-
-    if (!isset($config['my_type'])) {
-        throw new \InvalidArgumentException(
-            'The "my_type" option must be set'
-        );
-    }
-
-    $container->setParameter(
-        'acme_hello.my_service_type',
-        $config['my_type']
-    );
-}
-
                  -
                  -

                  Ahora, el usuario puede configurar eficientemente el servicio especificando el valor de configuración my_type:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-acme_hello:
-    my_type: foo
-    # ...
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<?xml version="1.0" ?>
-
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:acme_hello="http://www.ejemplo.com/symfony/schema/"
-    xsi:schemaLocation="http://www.ejemplo.com/symfony/schema/ http://www.ejemplo.com/symfony/schema/hello-1.0.xsd">
-
-    <acme_hello:config my_type="foo">
-        <!-- ... -->
-    </acme_hello:config>
-
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('acme_hello', array(
-    'my_type' => 'foo',
-    ...,
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Parámetros globales

                  -

                  Cuando configures el contenedor, tienes que estar consciente de que los siguientes parámetros globales están disponibles para que los utilices:

                  -
                    -
                  • kernel.name
                    • -
                  • kernel.environment
                    • -
                  • kernel.debug
                    • -
                  • kernel.root_dir
                    • -
                  • kernel.cache_dir
                    • -
                  • kernel.logs_dir
                    • -
                  • kernel.bundle_dirs
                    • -
                  • kernel.bundles
                    • -
                  • kernel.charset
                    • -
                  -
                  -

                  Prudencia

                  -

                  Todos los nombres de los parámetros y servicios que comienzan con un guión bajo (_) están reservados para la plataforma, y no los debes definir en tus nuevos paquetes.

                  -
                  -
                  -
                  -
                  -

                  Validando y fusionando con una clase configuración

                  -

                  Hasta ahora, has fusionado manualmente los arreglos de configuración y los has comprobado por medio de la presencia de los valores de configuración utilizando la función isset() de PHP. También hay disponible un sistema de configuración opcional, el cual puede ayudar con la fusión, validación, valores predeterminados y normalización de formato.

                  -
                  -

                  Nota

                  -

                  Normalización de formato se refiere al hecho de que ciertos formatos —en su mayoría XML— resultan en arreglos de configuración ligeramente diferentes, y que estos arreglos se deben «normalizar» para que coincidan con todo lo demás.

                  -
                  -

                  Para aprovechar las ventajas de este sistema, debes crear una clase Configuración y construir un árbol que define tu configuración en esa clase:

                  -
                  // src/Acme/HelloBundle/DependencyInjection/Configuration.php
-namespace Acme\HelloBundle\DependencyInjection;
-
-use Symfony\Component\Config\Definition\Builder\TreeBuilder;
-use Symfony\Component\Config\Definition\ConfigurationInterface;
-
-class Configuration implements ConfigurationInterface
-{
-    public function getConfigTreeBuilder()
-    {
-        $treeBuilder = new TreeBuilder();
-        $rootNode = $treeBuilder->root('acme_hello');
-
-        $rootNode
-            ->children()
-            ->scalarNode('my_type')->defaultValue('bar')->end()
-            ->end();
-
-        return $treeBuilder;
-    }
-}
-
                  -
                  -

                  Se trata de un ejemplo muy sencillo, pero ahora puedes utilizar esta clase en el método load() para combinar tu configuración y forzar su validación. Si se pasan las demás opciones salvo my_type, el usuario recibirá una notificación con una excepción de que se ha pasado una opción no admitida:

                  -
                  public function load(array $configs, ContainerBuilder $container)
-{
-    $configuration = new Configuration();
-
-    $config = $this->processConfiguration($configuration, $configs);
-
-    // ...
-}
-
                  -
                  -

                  El método processConfiguration() utiliza el árbol de configuración que has definido en la clase Configuración para validar, normalizar y fusionar todos los arreglos de configuración.

                  -

                  La clase Configuración puede ser mucho más complicada de lo que se muestra aquí, apoyando arreglos de nodos, nodos «prototipo», validación avanzada, normalización XML específica y fusión avanzada. Puedes leer más sobre esto en la documentación de la configuración del componente. -También lo puedes ver en acción comprobando alguna de las clases de configuración del núcleo, -como la configuración del FrameworkBundle o la configuración del TwigBundle.

                  -
                  -

                  Modificando la configuración de otro paquete

                  -

                  Si tienes múltiples paquetes que dependen unos de otros, puede ser útil permitir una clase Extension para modificar la configuración pasada a la clase Extension de otro paquete, como si el desarrollador final de hecho haya colocado la configuración en su archivo app/config/config.yml.

                  -

                  Para más detalles, ve Cómo simplificar la configuración de múltiples paquetes.

                  -
                  -
                  -

                  Volcando la configuración predefinida

                  -

                  -Nuevo en la versión 2.1: La orden config:dump-reference se añadió en Symfony 2.1

                  -

                  La orden config:dump-reference permite volcar a la consola la configuración predefinida de un paquete en formato YAML.

                  -

                  Siempre y cuando la configuración de tu paquete se encuentre en la ubicación estándar (TuPaquete\DependencyInjection\Configuration) y no tenga un __construct() esto funcionará automáticamente. Si tienes algo diferente en tu clase Extension tendrás que sobrescribir el método Extension::getConfiguration() y devolver una instancia de tu Configuration.

                  -

                  Puedes añadir comentarios y ejemplos a los nodos de tu configuración usando los métodos -->info() y ->example():

                  -
                  // src/Acme/HelloBundle/DependencyExtension/Configuration.php
-namespace Acme\HelloBundle\DependencyInjection;
-
-use Symfony\Component\Config\Definition\Builder\TreeBuilder;
-use Symfony\Component\Config\Definition\ConfigurationInterface;
-
-class Configuration implements ConfigurationInterface
-{
-    public function getConfigTreeBuilder()
-    {
-        $treeBuilder = new TreeBuilder();
-        $rootNode = $treeBuilder->root('acme_hello');
-
-        $rootNode
-            ->children()
-                ->scalarNode('my_type')
-                    ->defaultValue('bar')
-                    ->info('what my_type configures')
-                    ->example('example setting')
-                ->end()
-            ->end()
-        ;
-
-        return $treeBuilder;
-    }
-}
-
                  -
                  -

                  Este texto aparece en comentarios YAML en el resultado de la orden config:dump-reference.

                  -
                  -
                  -
                  -

                  Convenciones de extensión

                  -

                  Al crear una extensión, sigue estas simples convenciones:

                  -
                    -
                  • La extensión se debe almacenar en el subespacio de nombres DependencyInjection;
                    • -
                  • La extensión se debe nombrar después del nombre del paquete y con el sufijo Extension (AcmeHelloExtension para AcmeHelloBundle);
                    • -
                  • La extensión debe proporcionar un esquema XSD.
                    • -
                  -

                  Si sigues estas simples convenciones, Symfony2 registrará automáticamente las extensiones. De no ser así, sustituye el método Bundle::build() en tu paquete:

                  -
                  // ...
-use Acme\HelloBundle\DependencyInjection\UnconventionalExtensionClass;
-
-class AcmeHelloBundle extends Bundle
-{
-    public function build(ContainerBuilder $container)
-    {
-        parent::build($container);
-
-        // registra manualmente las extensiones que no siguen las convenciones
-        $container->registerExtension(new UnconventionalExtensionClass());
-    }
-}
-
                  -
                  -

                  En este caso, la clase Extension también debe implementar un método getAlias() que devuelva un alias único nombrado después del paquete (por ejemplo, acme_hello). Esto es necesario porque el nombre de clase no sigue la norma de terminar en Extension.

                  -

                  Además, el método load() de tu extensión sólo se llama si el usuario especifica el alias acme_hello en por lo menos un archivo de configuración. Una vez más, esto se debe a que la clase Extension no se ajusta a las normas establecidas anteriormente, por lo tanto nada sucede automáticamente.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/index.html b/cookbook/bundles/index.html deleted file mode 100644 index 79e886b..0000000 --- a/cookbook/bundles/index.html +++ /dev/null @@ -1,189 +0,0 @@ - - - - - - - Paquetes — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/inheritance.html b/cookbook/bundles/inheritance.html deleted file mode 100644 index ba0f95e..0000000 --- a/cookbook/bundles/inheritance.html +++ /dev/null @@ -1,200 +0,0 @@ - - - - - - - Cómo utilizar la herencia de paquetes para redefinir partes de un paquete — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar la herencia de paquetes para redefinir partes de un paquete

                  -

                  Cuando trabajes con paquetes de terceros, probablemente llegues a una situación en la que desees reemplazar un archivo en ese paquete de terceros con un archivo de uno de tus propios paquetes. Symfony te proporciona una forma muy conveniente para sustituir cosas como controladores, plantillas, traducciones, y otros archivos en el directorio Resources/ de los paquetes.

                  -

                  Por ejemplo, supongamos que estás instalando el FOSUserBundle, pero deseas sustituir su plantilla base —layout.html.twig—, así como uno de sus controladores. Supongamos también que tienes tu propio AcmeUserBundle donde deseas que vivan los archivos sobrescritos. Para empezar, registra el FOSUserBundle como el «padre» de tu paquete:

                  -
                  // src/Acme/UserBundle/AcmeUserBundle.php
-namespace Acme\UserBundle;
-
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
-
-class AcmeUserBundle extends Bundle
-{
-    public function getParent()
-    {
-        return 'FOSUserBundle';
-    }
-}
-
                  -
                  -

                  Al hacer este simple cambio, ahora puedes sustituir varias partes del FOSUserBundle simplemente creando un archivo con el mismo nombre.

                  -
                  -

                  Nota

                  -

                  A pesar del nombre del método, entre paquetes no hay una relación padre/hijo, sólo es una manera de extender y reemplazar un paquete existente.

                  -
                  -
                  -

                  Sustituyendo controladores

                  -

                  Supongamos que deseas añadir alguna funcionalidad al RegisterAction de RegistrationController que vive dentro de FOSUserBundle. Para ello, basta con crear tu propio archivo RegistrationController.php, reemplaza el método original, y cambia su funcionalidad:

                  -
                  // src/Acme/UserBundle/Controller/RegistrationController.php
-namespace Acme\UserBundle\Controller;
-
-    use FOS\UserBundle\Controller\RegistrationController as BaseController;
-
-class RegistrationController extends BaseController
-{
-    public function registerAction()
-    {
-        $response = parent::registerAction();
-
-        // ... haz tus cosas personalizadas
-        return $response;
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Dependiendo de cuanto necesites cambiar el comportamiento, puedes llamar a parent::RegisterAction() o sustituir por completo su lógica con la tuya.

                  -
                  -
                  -

                  Nota

                  -

                  La sustitución de controladores de esta forma solo funciona si el paquete se refiere al controlador usando la sintaxis estándar FOSUserBundle:Registration:register en las rutas y plantillas. Esta es la buena práctica.

                  -
                  -
                  -
                  -

                  Sustituyendo recursos: Plantillas, Enrutado, Validación, etc.

                  -

                  También puedes cambiar la mayoría de los recursos, simplemente creando un archivo en la misma ubicación que en el padre de tu paquete.

                  -

                  Por ejemplo, es muy común que necesites reemplazar la plantilla layout.html.twig de FOSUserBundle para que utilice el diseño base de tu aplicación. -Debido a que el archivo vive en Resources/views/layout.html.twig en FOSUserBundle, puedes crear tu propio archivo en el mismo lugar dentro de AcmeUserBundle. -Symfony ignorará el archivo que vive dentro de FOSUserBundle por completo, y en su lugar utilizará ese archivo.

                  -

                  Lo mismo ocurre con los archivos de enrutado, la configuración de validación y otros recursos.

                  -
                  -

                  Nota

                  -

                  La sustitución de recursos sólo funciona cuando haces referencia a los recursos con el método @FosUserBundle/Resources/config/routing/security.xml. -Si te refieres a recursos sin utilizar el acceso directo @BundleName, no puedes reemplazar en esta forma.

                  -
                  -
                  -

                  Prudencia

                  -

                  Los archivos de traducción no funcionan de la misma manera como se describió anteriormente. todos los archivos de traducción se acumulan en un conjunto de «piscinas» (una por cada) dominio. Symfony, primero carga los archivos de traducción desde los paquetes (en el orden en que se inician los paquetes) y luego desde tu directorio app(Resources. Si la misma traducción se especifica en dos recursos, gana la traducción de los recursos cargada al último.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/installation.html b/cookbook/bundles/installation.html deleted file mode 100644 index 2e57905..0000000 --- a/cookbook/bundles/installation.html +++ /dev/null @@ -1,249 +0,0 @@ - - - - - - - How to install 3rd party Bundles — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  How to install 3rd party Bundles

                  -

                  Most bundles provide their own installation instructions. However, the -basic steps for installing a bundle are the same.

                  -
                  -

                  Add Composer Dependencies

                  -

                  Starting from Symfony 2.1, dependencies are managed with Composer. It’s -a good idea to learn some basics of Composer in their documentation.

                  -

                  Before you can use composer to install a bundle, you should look for a -Packagist package of that bundle. For example, if you search for the popular -FOSUserBundle you will find a packaged called friendsofsymfony/user-bundle.

                  -
                  -

                  Nota

                  -

                  Packagist is the main archive for Composer. If you are searching -for a bundle, the best thing you can do is check out -KnpBundles, it is the unofficial achive of Symfony Bundles. If -a bundle contains a README file, it is displayed there and if it -has a Packagist package it shows a link to the package. It’s a -really useful site to begin searching for bundles.

                  -
                  -

                  Now that you have the package name, you should determine the version -you want to use. Usually different versions of a bundle correspond to -a particular version of Symfony. This information should be in the README -file. If it isn’t, you can use the version you want. If you choose an incompatible -version, Composer will throw dependency errors when you try to install. If -this happens, you can try a different version.

                  -

                  In the case of the FOSUserBundle, the README file has a caution that version -1.2.0 must be used for Symfony 2.0 and 1.3+ for Symfony 2.1+. Packagist displays -example require statements for all existing versions of a package. The -current development version of FOSUserBundle is "friendsofsymfony/user-bundle": "2.0.*@dev".

                  -

                  Now you can add the bundle to your composer.json file and update the -dependencies. You can do this manually:

                  -
                    -

                  1. Add it to the composer.json file:

                    -
                    {
-    ...,
-    "require": {
-        ...,
-        "friendsofsymfony/user-bundle": "2.0.*@dev"
-    }
-}
                    -
                    -
                    2. -

                  2. Update the dependency:

                    -
                    $ php composer.phar update friendsofsymfony/user-bundle
-
                    -
                    -

                    or update all dependencies

                    -
                    $ php composer.phar update
-
                    -
                    -
                    3. -
                  -

                  Or you can do this in one command:

                  -
                  $ php composer.phar require friendsofsymfony/user-bundle:2.0.*@dev
-
                  -
                  -
                  -
                  -

                  Enable the Bundle

                  -

                  At this point, the bundle is installed in your Symfony project (in -vendor/friendsofsymfony/) and the autoloader recognizes its classes. -The only thing you need to do now is register the bundle in AppKernel:

                  -
                  // app/AppKernel.php
-
-// ...
-class AppKernel extends Kernel
-{
-    // ...
-
-    public function registerBundles()
-    {
-        $bundles = array(
-            // ...,
-            new FOS\UserBundle\FOSUserBundle(),
-        );
-
-        // ...
-    }
-}
-
                  -
                  -
                  -
                  -

                  Configure the Bundle

                  -

                  Usually a bundle requires some configuration to be added to app’s -app/config/config.yml file. The bundle’s documentation will likely -describe that configuration. But you can also get a reference of the -bundle’s config via the config:dump-reference command.

                  -

                  For instance, in order to look the reference of the assetic config you -can use this:

                  -
                  $ app/console config:dump-reference AsseticBundle
-
                  -
                  -

                  or this:

                  -
                  $ app/console config:dump-reference assetic
-
                  -
                  -

                  The output will look like this:

                  -
                  assetic:
-    debug:                %kernel.debug%
-    use_controller:
-        enabled:              %kernel.debug%
-        profiler:             false
-    read_from:            %kernel.root_dir%/../web
-    write_to:             %assetic.read_from%
-    java:                 /usr/bin/java
-    node:                 /usr/local/bin/node
-    node_paths:           []
-    # ...
-
                  -
                  -
                  -
                  -

                  Other Setup

                  -

                  At this point, check the README file of your brand new bundle to see -what do to next.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/override.html b/cookbook/bundles/override.html deleted file mode 100644 index 31467ff..0000000 --- a/cookbook/bundles/override.html +++ /dev/null @@ -1,219 +0,0 @@ - - - - - - - Cómo sustituir cualquier parte de un paquete — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo sustituir cualquier parte de un paquete

                  -

                  Este documento es una referencia rápida sobre la forma de reemplazar las diferentes partes de los paquetes de terceros.

                  -
                  -

                  Plantillas

                  -

                  Para más información sobre la sustitución de plantillas, consulta:

                  - -
                  -
                  -

                  Enrutado

                  -

                  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.

                  -
                  -
                  -

                  Controladores

                  -

                  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.

                  -
                  -
                  -

                  Servicios y configuración

                  -

                  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:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-parameters:
-    translator.class:      Acme\HelloBundle\Translation\Translator
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<parameters>
-    <parameter key="translator.class">Acme\HelloBundle\Translation\Translator</parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    // 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.

                  -
                  -
                  -

                  Entidades y asignación de entidades

                  -

                  En curso...

                  -
                  -
                  -

                  Formularios

                  -

                  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());
-
                  -
                  -
                  -
                  -

                  Metadatos de validación

                  -

                  En curso...

                  -
                  -
                  -

                  Traducciones

                  -

                  En curso...

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/prepend_extension.html b/cookbook/bundles/prepend_extension.html deleted file mode 100644 index 8c27f29..0000000 --- a/cookbook/bundles/prepend_extension.html +++ /dev/null @@ -1,239 +0,0 @@ - - - - - - - Cómo simplificar la configuración de múltiples paquetes — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo simplificar la configuración de múltiples paquetes

                  -

                  Al crear aplicaciones reutilizables y extensibles, los desarrolladores suelen enfrentarse a una elección: o bien crear un gran paquete único o múltiples paquetes más pequeños. La creación de un único paquete tiene la gran desventaja de que le es imposible a los usuarios optar por eliminar funcionalidad que no estén utilizando. La creación de múltiples paquetes tiene la desventaja que la configuración se vuelve más tediosa y los ajustes a menudo se tienen que repetir para varios paquetes.

                  -

                  Utilizando el enfoque de abajo, es posible eliminar la desventaja del enfoque de múltiples paquetes, permitiendo a una única extensión anteponer los ajustes para cualquier paquete. Puedes utilizar los ajustes definidos en el archivo app/config/config.yml anteponiendo los ajustes tal y como si el usuario los hubiera escrito expresamente en la configuración de la aplicación.

                  -

                  Por ejemplo, esto lo podrías utilizar para configurar el nombre del gestor de entidades a utilizar en múltiples paquetes. O se puede utilizar para activar una función opcional que depende de que otro paquete se cargue también.

                  -

                  Para dotar a una Extensión con el poder de hacer esto, necesitas implementar la clase Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface:

                  -
                  // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
-namespace Acme\HelloBundle\DependencyInjection;
-
-use Symfony\Component\HttpKernel\DependencyInjection\Extension;
-use Symfony\Component\DependencyInjection\Extension\PrependExtensionInterface;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-class AcmeHelloExtension extends Extension implements PrependExtensionInterface
-{
-    // ...
-
-    public function prepend(ContainerBuilder $container)
-    {
-        // ...
-    }
-}
-
                  -
                  -

                  Dentro del método prepend(), los desarrolladores tienen acceso completo a la instancia de la clase Symfony\Component\DependencyInjection\ContainerBuilder justo antes de llamar al método load() en cada una de las extensiones registradas en el paquete. Para añadir al principio una configuración los desarrolladores de la extensión del paquete pueden utilizar el método prependExtensionConfig() de la instancia de Symfony\Component\DependencyInjection\ContainerBuilder. Dado que este método sólo añade la configuracion al principio, cualquier otra opción colocada explícitamente dentro del archivo app/config/config.yml debería reemplazar esta configuración antepuesta.

                  -

                  El siguiente ejemplo muestra cómo añadir al principio una opción de configuración en múltiples paquetes, así como desactivar una bandera en múltiples paquetes en el caso de que otro paquete específico no esté registrado:

                  -
                  public function prepend(ContainerBuilder $container)
-{
-    // obtiene todos los paquetes
-    $bundles = $container->getParameter('kernel.bundles');
-    // determina si AcmeGoodbyeBundle está registrado
-    if (!isset($bundles['AcmeGoodbyeBundle'])) {
-        // desactiva AcmeGoodbyeBundle en los paquetes
-        $config = array('use_acme_goodbye' => false);
-        foreach ($container->getExtensions() as $name => $extension) {
-            switch ($name) {
-                case 'acme_something':
-                case 'acme_other':
-                    // establece use_acme_goodbye a false en la configuración
-                    // de acme_something y acme_other ten en cuenta que
-                    // si el usuario configura manualmente
-                    // use_acme_goodbye a true en app/config/config.yml
-                    // entonces al final el ajuste sería true y no false
-                    $container->prependExtensionConfig($name, $config);
-                    break;
-            }
-        }
-    }
-
-    // procesa la configuración de AcmeHelloExtension
-    $configs = $container->getExtensionConfig($this->getAlias());
-    // usa la clase Configuration para generar un arreglo config
-    // con los ajustes de ``acme_hello``
-    $config = $this->processConfiguration(new Configuration(), $configs);
-
-    // comprueba si entity_manager_name se ajustó en la
-    // configuración de ``acme_hello``
-    if (isset($config['entity_manager_name'])) {
-        // añade al principio la configuracion de acme_something
-        // con el entity_manager_name
-        $config = array('entity_manager_name' => $config['entity_manager_name']);
-        $container->prependExtensionConfig('acme_something', $config);
-    }
-}
-
                  -
                  -

                  Lo anterior sería el equivalente de escribir lo siguiente en el archivo app/config/config.yml en caso de que AcmeGoodbyeBundle no se haya registrado y la opcion entity_manager_name para acme_hello esté configurada como non_default:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-
-acme_something:
-    # ...
-    use_acme_goodbye: false
-    entity_manager_name: non_default
-
-acme_other:
-    # ...
-    use_acme_goodbye: false
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-
-<acme-something:config use-acme-goodbye="false">
-    <acme-something:entity-manager-name>non_default</acme-something:entity-manager-name>
-</acme-something:config>
-
-<acme-other:config use-acme-goodbye="false" />
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-
-$container->loadFromExtension('acme_something', array(
-    ...,
-    'use_acme_goodbye' => false,
-    'entity_manager_name' => 'non_default',
-));
-$container->loadFromExtension('acme_other', array(
-    ...,
-    'use_acme_goodbye' => false,
-));
-
                    -
                    -
                    • -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/bundles/remove.html b/cookbook/bundles/remove.html deleted file mode 100644 index 567e7b7..0000000 --- a/cookbook/bundles/remove.html +++ /dev/null @@ -1,200 +0,0 @@ - - - - - - - Cómo eliminar el AcmeDemoBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo eliminar el AcmeDemoBundle

                  -

                  La edición estándar de Symfony2 viene con una demo completa que vive dentro de un paquete llamado AcmeDemoBundle. Es un gran texto modelo al cual referirte mientras empiezas un proyecto, pero probablemente quieras eliminarlo finalmente.

                  -
                  -

                  Truco

                  -

                  Este artículo utiliza el AcmeDemoBundle como ejemplo, pero puedes utilizar estos pasos para eliminar cualquier paquete.

                  -
                  -
                  -

                  1. Desregistrar el paquete en el AppKernel

                  -

                  Para desconectar el paquete de la plataforma, lo deberías quitar del método Appkernel::registerBundles(). El paquete normalmente se encuentra en el arreglo $bundles pero el ``AcmeDemoBundle sólo se registra en un entorno de desarrollo y lo puedes encontrar en la siguiente declaración if:

                  -
                  // app/AppKernel.php
-
-// ...
-class AppKernel extends Kernel
-{
-    public function registerBundles()
-    {
-        $bundles = array(...);
-
-        if (in_array($this->getEnvironment(), array('dev', 'test'))) {
-            // comenta o elimina esta línea:
-            // $bundles[] = new Acme\DemoBundle\AcmeDemoBundle();
-            // ...
-        }
-    }
-}
-
                  -
                  -
                  -
                  -

                  2. Quita la configuración del paquete

                  -

                  Ahora que Symfony no sabe sobre el paquete, necesitas quitar toda su configuración y enrutado dentro del directorio app/config que refiera al paquete.

                  -
                  -

                  2.1 Quita el enrutado del paquete

                  -

                  El enrutado para el AcmeDemoBundle se puede encontrar en app/config/routing_dev.yml. Las rutas son _welcome, _demo_secured y _demo. Quita esas tres entradas.

                  -
                  -
                  -

                  2.2 Quita la configuración del paquete

                  -

                  Algunos paquetes contienen configuración en uno de los archivos en app/config/config*.yml. Asegúrate de sacar la configuración relacionada de esos archivos. Rápidamente puedes determinar la configuración del paquete en el sitio buscando una cadena acme_demo (o alguna cosa que nombre el paquete, p. ej. fos_user para el FOSUserBundle) en los archivos de configuración.

                  -

                  El AcmeDemoBundle no tiene configuración. Sin embargo, se utiliza el paquete en la configuración del archivo app/config/security.yml. Lo puedes utilizar como texto modelo para tu propia seguridad, pero también puedes quitar todo: A Symfony no le importa si lo quitas o no.

                  -
                  -
                  -
                  -

                  3. Elimina el paquete del sistema de archivos

                  -

                  Ahora que has quitado toda referencia al paquete en tu aplicación, deberías quitar el paquete del sistema de archivos. El paquete se localiza en el directorio src/Acme/DemoBundle. Deberías quitar ese directorio y también puedes quitar el directorio Acme.

                  -
                  -

                  Truco

                  -

                  Si no sabes la ubicación de un paquete, puedes utilizar el método getPath() para conseguir la ruta del paquete:

                  -
                  echo $this->container->get('kernel')->getBundle('AcmeDemoBundle')->getPath();
-
                  -
                  -
                  -
                  -
                  -

                  4. Quita la integración en otros paquetes

                  -
                  -

                  Nota

                  -

                  Esto no aplica al AcmeDemoBundle — ningún otro paquete depende de él, así que puedes omitir este paso.

                  -
                  -

                  Algunos paquetes dependen de otros paquetes, si quitas uno de los dos, el otro probablemente no trabaje. Asegúrate que ningún otro paquete, de terceros o personalizado, dependa del paquete que estás a punto de quitar.

                  -
                  -

                  Truco

                  -

                  Si un paqute depende de otro, significa que este utiliza algunos servicios del paquete. Buscar una cadena acme_demo te puede ayudar descubrirlos.

                  -
                  -
                  -

                  Truco

                  -

                  Si un paquete de terceros depende de otro, puedes encontrar ese paquete mencionado en el archivo composer.json incluido en el directorio bundle.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/cache/index.html b/cookbook/cache/index.html deleted file mode 100644 index 5bf222b..0000000 --- a/cookbook/cache/index.html +++ /dev/null @@ -1,140 +0,0 @@ - - - - - - - Almacenando en caché — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/cache/varnish.html b/cookbook/cache/varnish.html deleted file mode 100644 index db68918..0000000 --- a/cookbook/cache/varnish.html +++ /dev/null @@ -1,188 +0,0 @@ - - - - - - - Cómo utilizar Varnish para acelerar mi sitio web — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar Varnish para acelerar mi sitio web

                  -

                  Debido a que la caché de Symfony2 utiliza las cabeceras de caché HTTP estándar, el Delegado inverso de Symfony2 se puede sustituir fácilmente por cualquier otro delegado inverso. Varnish es un potente acelerador HTTP, de código abierto, capaz de servir contenido almacenado en caché de forma rápida y es compatible con Inclusión del borde lateral.

                  -
                  -

                  Configurando

                  -

                  Como vimos anteriormente, Symfony2 es lo suficientemente inteligente como para detectar si está hablando con un delegado inverso que entiende ESI o no. Funciona fuera de la caja cuando utilizas el delegado inverso de Symfony2, pero necesita una configuración especial para que funcione con Varnish. Afortunadamente, Symfony2 se basa en otra norma escrita por Akamaï (Arquitectura límite), por lo que el consejo de configuración en este capítulo te puede ser útil incluso si no utilizas Symfony2.

                  -
                  -

                  Nota

                  -

                  Varnish sólo admite el atributo src para las etiquetas ESI (los atributos onerror y alt se omiten).

                  -
                  -

                  En primer lugar, configura Varnish para que anuncie su apoyo a ESI añadiendo una cabecera Surrogate-Capability a las peticiones remitidas a la interfaz administrativa de tu aplicación:

                  -
                  sub vcl_recv {
-    set req.http.Surrogate-Capability = "abc=ESI/1.0";
-}
-
                  -
                  -

                  Entonces, optimiza Varnish para que sólo analice el contenido de la respuesta cuando al menos hay una etiqueta ESI comprobando la cabecera Surrogate-Control que Symfony2 añade automáticamente:

                  -
                  sub vcl_fetch {
-    if (beresp.http.Surrogate-Control ~ "ESI/1.0") {
-        unset beresp.http.Surrogate-Control;
-
-        // para Varnish >= 3.0
-        set beresp.do_esi = true;
-        // para Varnish < 3.0
-        // esi;
-    }
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  La compresión con ESI no cuenta con el apoyo de Varnish hasta la versión 3.0 (lee GZIP y Varnish). Si no estás utilizando Varnish 3.0, coloca un servidor web frente a Varnish para llevar a cabo la compresión.

                  -
                  -
                  -
                  -

                  Invalidando la caché

                  -

                  Nunca debería ser necesario invalidar los datos almacenados en caché porque la invalidación ya se tiene en cuenta de forma nativa en los modelos de caché HTTP (consulta Invalidando la caché).

                  -

                  Sin embargo, Varnish se puede configurar para aceptar un método HTTP especial PURGE que invalida la caché para un determinado recurso:

                  -
                  sub vcl_hit {
-    if (req.request == "PURGE") {
-        set obj.ttl = 0s;
-        error 200 "Purged";
-    }
-}
-
-sub vcl_miss {
-    if (req.request == "PURGE") {
-        error 404 "Not purged";
-    }
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  De alguna manera, debes proteger el método PURGE de HTTP para evitar que alguien aleatoriamente purgue los datos memorizados.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/apache_router.html b/cookbook/configuration/apache_router.html deleted file mode 100644 index 46b34af..0000000 --- a/cookbook/configuration/apache_router.html +++ /dev/null @@ -1,251 +0,0 @@ - - - - - - - Cómo usar el enrutador de Apache — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar el enrutador de Apache

                  -

                  Si bien Symfony2, es muy rápido fuera de la caja, también proporciona varias maneras de aumentar esa velocidad con unos cuantos ajustes. -Una de esas maneras es dejando que Apache maneje el enrutado directamente, en lugar de utilizar Symfony2 para esta tarea.

                  -
                  -

                  Cambiando los parámetros de configuración del enrutador

                  -

                  Para volcar las rutas de Apache, primero debes modificar algunos parámetros de configuración para decirle a Symfony2 que utilice el ApacheUrlMatcher en lugar de la opción predeterminada.

                  -
                  -
                    -
                  • YAML
                    # app/config/config_prod.yml
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_prod.xml -->
-<parameters>
-    <parameter key="router.options.matcher.cache_class">null</parameter> <!-- disable router cache -->
-    <parameter key="router.options.matcher_class">
-        Symfony\Component\Routing\Matcher\ApacheUrlMatcher
-    </parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_prod.php
-$container->setParameter('router.options.matcher.cache_class', null); // desactuva la caché de enrutado
-$container->setParameter(
-    'router.options.matcher_class',
-    'Symfony\Component\Routing\Matcher\ApacheUrlMatcher'
-);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Ten en cuenta que Symfony\Component\Routing\Matcher\ApacheUrlMatcher extiende a Symfony\Component\Routing\Matcher\UrlMatcher por lo que incluso si no se regeneran las reglas url_rewrite, todo saldrá bien (porque al final ApacheUrlMatcher::match() hace una llamada a parent::match()).

                  -
                  -
                  -
                  -

                  Generando reglas para mod_rewrite

                  -

                  Para comprobar que está funcionando, vamos a crear una ruta muy básica para el paquete de demostración:

                  -
                  -
                    -
                  • YAML
                    # app/config/routing.yml
-hello:
-    path:  /hello/{name}
-    defaults: { _controller: AcmeDemoBundle:Demo:hello }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/routing.xml -->
-<route id="hello" path="/hello/{name}">
-    <default key="_controller">AcmeDemoBundle:Demo:hello</default>
-</route>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/routing.php
-$collection->add('hello', new Route('/hello/{name}', array(
-    '_controller' => 'AcmeDemoBundle:Demo:hello',
-)));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora genera las reglas url_rewrite:

                  -
                  $ php app/console router:dump-apache -e=prod --no-debug
-
                  -
                  -

                  Lo cual debe mostrar —más o menos— lo siguiente:

                  -
                  # salta peticiones «reales»
-RewriteCond %{REQUEST_FILENAME} -f
-RewriteRule .* - [QSA,L]
-
-# hello
-RewriteCond %{REQUEST_URI} ^/hello/([^/]+?)$
-RewriteRule .* app.php [QSA,L,E=_ROUTING__route:hello,E=_ROUTING_name:%1,E=_ROUTING__controller:AcmeDemoBundle\:Demo\:hello]
-
                  -
                  -

                  Ahora puedes volver a escribir web/.htaccess para utilizar las nuevas reglas, de modo que este ejemplo debería tener el siguiente aspecto:

                  -
                  <IfModule mod_rewrite.c>
-    RewriteEngine On
-
-    # salta peticiones "reales"
-    RewriteCond %{REQUEST_FILENAME} -f
-    RewriteRule .* - [QSA,L]
-
-    # hello
-    RewriteCond %{REQUEST_URI} ^/hello/([^/]+?)$
-    RewriteRule .* app.php [QSA,L,E=_ROUTING__route:hello,E=_ROUTING_name:%1,E=_ROUTING__controller:AcmeDemoBundle\:Demo\:hello]
-</IfModule>
-
                  -
                  -
                  -

                  Nota

                  -

                  El procedimiento anterior se debe realizar cada vez que añadas/cambies la ruta si quieres sacar el máximo provecho de esta configuración.

                  -
                  -

                  ¡Eso es todo! -Ahora estás listo para usar las reglas de enrutado de Apache.

                  -
                  -
                  -

                  Ajustes adicionales

                  -

                  Para ahorrar un poco de tiempo en el procesamiento, cambia las ocurrencias de Request a ApacheRequest en web/app.php:

                  -
                  // web/app.php
-
-require_once __DIR__.'/../app/bootstrap.php.cache';
-require_once __DIR__.'/../app/AppKernel.php';
-//require_once __DIR__.'/../app/AppCache.php';
-
-use Symfony\Component\HttpFoundation\ApacheRequest;
-
-$kernel = new AppKernel('prod', false);
-$kernel->loadClassCache();
-//$kernel = new AppCache($kernel);
-$kernel->handle(ApacheRequest::createFromGlobals())->send();
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/environments.html b/cookbook/configuration/environments.html deleted file mode 100644 index 8d799ae..0000000 --- a/cookbook/configuration/environments.html +++ /dev/null @@ -1,383 +0,0 @@ - - - - - - - Cómo dominar y crear nuevos entornos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo dominar y crear nuevos entornos

                  -

                  Cada aplicación es la combinación de código y un conjunto de configuración que dicta la forma en que el código debería funcionar. La configuración puede definir la base de datos a usar, si o no se debe almacenar en caché, o cómo se debe detallar la anotación cronológica de eventos en la bitácora. En Symfony2, la idea de «entornos» es la idea de que el mismo código base se puede ejecutar con varias configuraciones diferentes. Por ejemplo, el entorno dev debería usar la configuración que facilita el desarrollo y lo hace agradable, mientras que el entorno prod debe usar un conjunto de configuración optimizado para velocidad.

                  -
                  -

                  Diferentes entornos, diferentes archivos de configuración

                  -

                  Una típica aplicación Symfony2 comienza con tres entornos: dev, prod y test. Como se mencionó anteriormente, cada «entorno» simplemente representa una manera de ejecutar el mismo código base con diferente configuración. No debería ser una sorpresa entonces que cada entorno cargue su propio archivo de configuración individual. Si estás utilizando el formato de configuración YAML, utiliza los siguientes archivos:

                  -
                    -
                  • para el entorno dev: app/config/config_dev.yml
                    • -
                  • para el entorno prod: app/config/config_prod.yml
                    • -
                  • para el entorno test: app/config/config_test.yml
                    • -
                  -

                  Esto funciona a través de un estándar sencillo que se utiliza por omisión dentro de la clase AppKernel:

                  -
                  // app/AppKernel.php
-
-// ...
-
-class AppKernel extends Kernel
-{
-    // ...
-
-    public function registerContainerConfiguration(LoaderInterface $loader)
-    {
-        $loader->load(__DIR__.'/config/config_'.$this->getEnvironment().'.yml');
-    }
-}
-
                  -
                  -

                  Como puedes ver, cuando se carga Symfony2, utiliza el entorno especificado para determinar qué archivo de configuración cargar. Esto cumple con el objetivo de múltiples entornos en una manera elegante, potente y transparente.

                  -

                  Por supuesto, en realidad, cada entorno difiere un poco de los demás. -En general, todos los entornos comparten una gran configuración base común. -Abriendo el archivo de configuración «dev», puedes ver cómo se logra esto fácil y transparentemente:

                  -
                  -
                    -
                  • YAML
                    imports:
-    - { resource: config.yml }
-# ...
-
                    -
                    -
                    • -
                  • XML
                    <imports>
-    <import resource="config.xml" />
-</imports>
-<!-- ... -->
-
                    -
                    -
                    • -
                  • PHP
                    $loader->import('config.php');
-// ...
-
                    -
                    -
                    • -
                  -
                  -

                  Para compartir configuración común, el archivo de configuración de cada entorno simplemente importa primero los ajustes más comunes desde un archivo de configuración central (config.yml). -El resto del archivo se puede desviar de la configuración predeterminada sustituyendo parámetros individuales. Por ejemplo, de manera predeterminada, la barra de herramientas web_profiler está desactivada. Sin embargo, en el entorno dev, la barra de herramientas se activa modificando el valor predeterminado en el archivo de configuración dev:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_dev.yml
-imports:
-    - { resource: config.yml }
-
-web_profiler:
-    toolbar: true
-    # ...
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_dev.xml -->
-<imports>
-    <import resource="config.xml" />
-</imports>
-
-<webprofiler:config
-    toolbar="true"
-    ... />
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_dev.php
-$loader->import('config.php');
-
-$container->loadFromExtension('web_profiler', array(
-    'toolbar' => true,
-
-    // ...
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Ejecutando una aplicación en entornos diferentes

                  -

                  Para ejecutar la aplicación en cada entorno, carga la aplicación usando como controlador frontal o bien app.php (para el entorno prod) o app_dev.php (para el entorno dev):

                  -
                  http://localhost/app.php      -> entorno *prod*
-http://localhost/app_dev.php  -> entorno *dev*
-
                  -
                  -
                  -

                  Nota

                  -

                  Las URL dadas asumen que tu servidor web está configurado para utilizar el directorio web/ de la aplicación como su raíz. Lee más en Instalando Symfony2.

                  -
                  -

                  Si abres uno de estos archivos, rápidamente verás que el entorno utilizado por cada uno se fija explícitamente:

                  -
                  1
-2
-3
-4
-5
-6
-7
-8
-9
                   <?php
-
- require_once __DIR__.'/../app/bootstrap_cache.php';
- require_once __DIR__.'/../app/AppCache.php';
-
- use Symfony\Component\HttpFoundation\Request;
-
- $kernel = new AppCache(new AppKernel('prod', false));
- $kernel->handle(Request::createFromGlobals())->send();
-
                  -
                  -

                  Como puedes ver, la clave prod especifica que este entorno se ejecutará en el entorno de producción. Una aplicación Symfony2 se puede ejecutar en cualquier entorno usando este código y simplemente cambiando la cadena de entorno.

                  -
                  -

                  Nota

                  -

                  El entorno test se utiliza al escribir las pruebas funcionales y no es accesible en el navegador directamente a través de un controlador frontal. En otras palabras, a diferencia de los otros entornos, no hay archivo controlador frontal app_test.php.

                  -
                  - -
                  -
                  -

                  Creando un nuevo entorno

                  -

                  De forma predeterminada, una aplicación Symfony2 tiene tres entornos que se encargan de la mayoría de los casos. Por supuesto, debido a que un entorno no es más que una cadena que corresponde a un conjunto de configuración, la creación de un nuevo entorno es muy fácil.

                  -

                  Supongamos, por ejemplo, que antes de desplegarla, necesitas medir el rendimiento de tu aplicación. Una forma de medir el rendimiento de la aplicación es usando una configuración cercana a la de producción, pero con el web_profiler de Symfony2 habilitado. Esto permite a Symfony2 registrar información sobre tu aplicación durante la evaluación.

                  -

                  La mejor manera de lograrlo es a través de un nuevo entorno llamado, por ejemplo, benchmark. Comienza creando un nuevo archivo de configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_benchmark.yml
-imports:
-    - { resource: config_prod.yml }
-
-framework:
-    profiler: { only_exceptions: false }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_benchmark.xml -->
-<imports>
-    <import resource="config_prod.xml" />
-</imports>
-
-<framework:config>
-    <framework:profiler only-exceptions="false" />
-</framework:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_benchmark.php
-$loader->import('config_prod.php')
-
-$container->loadFromExtension('framework', array(
-    'profiler' => array('only-exceptions' => false),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Y con esta simple adición, la aplicación ahora es compatible con un nuevo entorno llamado benchmark.

                  -

                  Este nuevo archivo de configuración importa la configuración del entorno prod y la modifica. Esto garantiza que el nuevo entorno es idéntico al entorno prod, a excepción de los cambios echos explícitamente aquí.

                  -

                  Debido a que deseas que este entorno sea accesible a través de un navegador, también debes crear un controlador frontal para el mismo. Copia el archivo web/app.php a web/app_benchmark.php y edita el entorno para que sea benchmark:

                  -
                  <?php
-
-require_once __DIR__.'/../app/bootstrap.php';
-require_once __DIR__.'/../app/AppKernel.php';
-
-use Symfony\Component\HttpFoundation\Request;
-
-$kernel = new AppKernel('benchmark', false);
-$kernel->handle(Request::createFromGlobals())->send();
-
                  -
                  -

                  El nuevo entorno ahora es accesible a través de:

                  -
                  http://localhost/app_benchmark.php
-
                  -
                  -
                  -

                  Nota

                  -

                  Algunos entornos, como el entorno dev, no están destinados a ser visitados en algún servidor empleado para el público en general. Esto se debe a que ciertos entornos, con fines de depuración, pueden dar demasiada información sobre la aplicación o infraestructura subyacente. Para estar seguros de que estos entornos no son accesibles, se suele proteger al controlador frontal de direcciones IP externas a través del siguiente código en la parte superior del controlador:

                  -
                  -
                  if (!in_array(@$_SERVER['REMOTE_ADDR'], array('127.0.0.1', '::1'))) {
-    die('You are not allowed to access this file. Check '.basename(__FILE__).' for more information.');
-}
-
                  -
                  -
                  -
                  -
                  -
                  -

                  Entornos y el directorio de caché

                  -

                  Symfony2 aprovecha la memorización en caché de muchas maneras: la configuración de la aplicación, la configuración de enrutado, las plantillas Twig y más, se memorizan como objetos PHP en archivos del sistema de archivos.

                  -

                  Por omisión, estos archivos se memorizan principalmente en el directorio app/cache. -Sin embargo, cada entorno memoriza su propio conjunto de archivos:

                  -
                  app/cache/dev   --- directorio caché para el entorno *dev*
-app/cache/prod  --- directorio caché para el entorno *prod*
-
                  -
                  -

                  A veces, cuando depuramos, puede ser útil inspeccionar un archivo memorizado para entender cómo está funcionando algo. Al hacerlo, recuerda buscar en el directorio del entorno que estás utilizando (comúnmente dev mientras desarrollas y depuras). Aunque puede variar, el directorio app/cache/dev incluye lo siguiente:

                  -
                    -
                  • appDevDebugProjectContainer.php — el «contenedor del servicio» memorizado que representa la configuración de la aplicación en caché;
                    • -
                  • appdevUrlGenerator.php — la clase PHP generada a partir de la configuración de enrutado y usada cuando genera las URL;
                    • -
                  • appdevUrlMatcher.php — la clase PHP usada para emparejar rutas — busca aquí para ver la lógica de las expresiones regulares compiladas utilizadas para concordar las URL entrantes con diferentes rutas;
                    • -
                  • twig/ — este directorio contiene todas las plantillas Twig en caché.
                    • -
                  -
                  -

                  Nota

                  -

                  Fácilmente puedes cambiar la ubicación y nombre del directorio. Para más información lee el artículo Cómo sustituir la estructura de directorios predeterminada de Symfony.

                  -
                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/external_parameters.html b/cookbook/configuration/external_parameters.html deleted file mode 100644 index dc8dc8e..0000000 --- a/cookbook/configuration/external_parameters.html +++ /dev/null @@ -1,244 +0,0 @@ - - - - - - - Cómo configurar parámetros externos en el contenedor de servicios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo configurar parámetros externos en el contenedor de servicios

                  -

                  En el capítulo Cómo dominar y crear nuevos entornos, aprendiste cómo gestionar la configuración de tu aplicación. A veces, puedes beneficiar a tu aplicación almacenando ciertas credenciales fuera del código de tu proyecto. La configuración de la base de datos es tal ejemplo. La flexibilidad del contenedor de servicios de Symfony te permite hacer esto fácilmente.

                  -
                  -

                  Variables de entorno

                  -

                  Symfony grabará cualquier variable de entorno con el prefijo SYMFONY__ y lo configurará como parámetro en el contenedor de servicios. Los dobles guiones bajos son reemplazados por un punto, ya que un punto no es un carácter válido en un nombre de variable de entorno.

                  -

                  Por ejemplo, si estás usando Apache, las variables de entorno se pueden fijar usando la siguiente configuración de VirtualHost:

                  -
                  <VirtualHost *:80>
-    ServerName      Symfony2
-    DocumentRoot    "/ruta/a/aplic_symfony_2/web"
-    DirectoryIndex  index.php index.html
-    SetEnv          SYMFONY__DATABASE__USER usuario
-    SetEnv          SYMFONY__DATABASE__PASSWORD secreto
-
-    <Directory "/ruta/a/aplic_symfony_2/web">
-        AllowOverride All
-        Allow from All
-    </Directory>
-</VirtualHost>
-
                  -
                  -
                  -

                  Nota

                  -

                  El ejemplo anterior es una configuración para Apache, con la directiva SetEnv. Sin embargo, esta funcionará para cualquier servidor web compatible con la configuración de variables de entorno.

                  -

                  Además, con el fin de que tu consola trabaje (la cual no utiliza Apache), las tienes que exportar como variables del intérprete. En un sistema Unix, puedes ejecutar las siguientes ordenes:

                  -
                  $ export SYMFONY__DATABASE__USER=usuario
-$ export SYMFONY__DATABASE__PASSWORD=secreto
-
                  -
                  -
                  -

                  Ahora que has declarado una variable de entorno, estará presente en la variable global $_SERVER de PHP. Entonces Symfony automáticamente fijará todas las variables $_SERVER con el prefijo SYMFONY__ como parámetros en el contenedor de servicios.

                  -

                  Ahora puedes referirte a estos parámetros donde los necesites.

                  -
                  -
                    -
                  • YAML
                    doctrine:
-    dbal:
-        driver    pdo_mysql
-        dbname:   symfony2_project
-        user:     "%database.user%"
-        password: "%database.password%"
-
                    -
                    -
                    • -
                  • XML
                    <!-- xmlns:doctrine="http://symfony.com/schema/dic/doctrine" -->
-<!-- xsi:schemaLocation="http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd"> -->
-
-<doctrine:config>
-    <doctrine:dbal
-        driver="pdo_mysql"
-        dbname="symfony2_project"
-        user="%database.user%"
-        password="%database.password%"
-    />
-</doctrine:config>
-
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'driver'   => 'pdo_mysql',
-        'dbname'   => 'symfony2_project',
-        'user'     => '%database.user%',
-        'password' => '%database.password%',
-    )
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Constantes

                  -

                  El contenedor también cuenta con apoyo para fijar constantes PHP como parámetros. -See Constants as Parameters for more details.

                  -
                  -
                  -

                  Otra configuración

                  -

                  La directiva imports se puede utilizar para extraer parámetros almacenados en otro lugar. -Importar un archivo PHP te da la flexibilidad de añadir al contenedor lo que sea necesario. La siguiente directiva importa un archivo llamado parameters.php.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-imports:
-    - { resource: parameters.php }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<imports>
-    <import resource="parameters.php" />
-</imports>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$loader->import('parameters.php');
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Un archivo de recursos puede tener uno de muchos tipos. Los recursos PHP, XML, YAML, INI y cierre son compatibles con la directiva imports.

                  -
                  -

                  En parameters.php, dile al contenedor de servicios los parámetros que deseas configurar. Esto es útil cuando la configuración importante está en un formato no estándar. El siguiente ejemplo incluye la configuración de una base de datos Drupal en el contenedor de servicios de Symfony.

                  -
                  // app/config/parameters.php
-include_once('/ruta/a/drupal/sites/default/settings.php');
-$container->setParameter('drupal.database.url', $db_url);
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/front_controllers_and_kernel.html b/cookbook/configuration/front_controllers_and_kernel.html deleted file mode 100644 index 364ce42..0000000 --- a/cookbook/configuration/front_controllers_and_kernel.html +++ /dev/null @@ -1,269 +0,0 @@ - - - - - - - Understanding how the Front Controller, Kernel and Environments work together — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Understanding how the Front Controller, Kernel and Environments work together

                  -

                  The section Cómo dominar y crear nuevos entornos explained the basics -on how Symfony uses environments to run your application with different configuration -settings. This section will explain a bit more in-depth what happens when -your application is bootstrapped. To hook into this process, you need to understand -three parts that work together:

                  - -
                  -

                  Nota

                  -

                  Usually, you will not need to define your own front controller or -AppKernel class as the `Symfony2 Standard Edition`_ provides -sensible default implementations.

                  -

                  This documentation section is provided to explain what is going on behind -the scenes.

                  -
                  -
                  -

                  The Front Controller

                  -

                  The front controller is a well-known design pattern; it is a section of -code that all requests served by an application run through.

                  -

                  In the `Symfony2 Standard Edition`_, this role is taken by the app.php -and app_dev.php files in the web/ directory. These are the very -first PHP scripts executed when a request is processed.

                  -

                  The main purpose of the front controller is to create an instance of the -AppKernel (more on that in a second), make it handle the request -and return the resulting response to the browser.

                  -

                  Because every request is routed through it, the front controller can be -used to perform global initializations prior to setting up the kernel or -to `decorate`_ the kernel with additional features. Examples include:

                  -
                    -
                  • Configuring the autoloader or adding additional autoloading mechanisms;
                    • -
                  • Adding HTTP level caching by wrapping the kernel with an instance of -AppCache;
                    • -
                  • Enabling the El componente Debug.
                    • -
                  -

                  The front controller can be chosen by requesting URLs like:

                  -
                  http://localhost/app_dev.php/some/path/...
-
                  -
                  -

                  As you can see, this URL contains the PHP script to be used as the front -controller. You can use that to easily switch the front controller or use -a custom one by placing it in the web/ directory (e.g. app_cache.php).

                  -

                  When using Apache and the RewriteRule shipped with the Standard Edition, -you can omit the filename from the URL and the RewriteRule will use app.php -as the default one.

                  -
                  -

                  Nota

                  -

                  Pretty much every other web server should be able to achieve a -behavior similar to that of the RewriteRule described above. -Check your server documentation for details or see -Configuring a web server.

                  -
                  -
                  -

                  Nota

                  -

                  Make sure you appropriately secure your front controllers against unauthorized -access. For example, you don’t want to make a debugging environment -available to arbitrary users in your production environment.

                  -
                  -

                  Technically, the app/console script used when running Symfony on the command -line is also a front controller, only that is not used for web, but for command -line requests.

                  -
                  -
                  -

                  The Kernel Class

                  -

                  The Symfony\Component\HttpKernel\Kernel is the core of -Symfony2. It is responsible for setting up all the bundles that make up -your application and providing them with the application’s configuration. -It then creates the service container before serving requests in its -handle() -method.

                  -

                  There are two methods declared in the -Symfony\Component\HttpKernel\KernelInterface that are -left unimplemented in Symfony\Component\HttpKernel\Kernel -and thus serve as template methods:

                  - -

                  To fill these (small) blanks, your application needs to subclass the -Kernel and implement these methods. The resulting class is conventionally -called the AppKernel.

                  -

                  Again, the Symfony2 Standard Edition provides an AppKernel in the app/ -directory. This class uses the name of the environment - which is passed to -the Kernel’s constructor -method and is available via getEnvironment() - -to decide which bundles to create. The logic for that is in registerBundles(), -a method meant to be extended by you when you start adding bundles to your -application.

                  -

                  You are, of course, free to create your own, alternative or additional -AppKernel variants. All you need is to adapt your (or add a new) front -controller to make use of the new kernel.

                  -
                  -

                  Nota

                  -

                  The name and location of the AppKernel is not fixed. When -putting multiple Kernels into a single application, -it might therefore make sense to add additional sub-directories, -for example app/admin/AdminKernel.php and -app/api/ApiKernel.php. All that matters is that your front -controller is able to create an instance of the appropriate -kernel.

                  -
                  -

                  Having different AppKernels might be useful to enable different front -controllers (on potentially different servers) to run parts of your application -independently (for example, the admin UI, the frontend UI and database migrations).

                  -
                  -

                  Nota

                  -

                  There’s a lot more the AppKernel can be used for, for example -overriding the default directory structure. -But odds are high that you don’t need to change things like this on the -fly by having several AppKernel implementations.

                  -
                  -
                  -
                  -

                  The Environments

                  -

                  We just mentioned another method the AppKernel has to implement - -registerContainerConfiguration(). -This method is responsible for loading the application’s -configuration from the right environment.

                  -

                  Environments have been covered extensively -in the previous chapter, -and you probably remember that the Standard Edition comes with three -of them - dev, prod and test.

                  -

                  More technically, these names are nothing more than strings passed from the -front controller to the AppKernel‘s constructor. This name can then be -used in the registerContainerConfiguration() -method to decide which configuration files to load.

                  -

                  The Standard Edition’s AppKernel class implements this method by simply -loading the app/config/config_*environment*.yml file. You are, of course, -free to implement this method differently if you need a more sophisticated -way of loading your configuration.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/index.html b/cookbook/configuration/index.html deleted file mode 100644 index 890b853..0000000 --- a/cookbook/configuration/index.html +++ /dev/null @@ -1,177 +0,0 @@ - - - - - - - Configurando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/override_dir_structure.html b/cookbook/configuration/override_dir_structure.html deleted file mode 100644 index c77e04f..0000000 --- a/cookbook/configuration/override_dir_structure.html +++ /dev/null @@ -1,251 +0,0 @@ - - - - - - - Cómo sustituir la estructura de directorios predeterminada de Symfony — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo sustituir la estructura de directorios predeterminada de Symfony

                  -

                  Automáticamente Symfony viene con una estructura de directorios predefinida. Fácilmente puedes sustituir esta estructura de directorios para crear la tuya propia. La estructura de directorios predefinida es:

                  -
                  app/
-    cache/
-    config/
-    logs/
-    ...
-src/
-    ...
-vendor/
-    ...
-web/
-    app.php
-    ...
-
                  -
                  -
                  -

                  Sustituyendo el directorio cache

                  -

                  Puedes sustituir el directorio cache redefiniendo el método getCacheDir en la clase AppKernel de tu aplicación:

                  -
                  // app/AppKernel.php
-
-// ...
-class AppKernel extends Kernel
-{
-    // ...
-
-    public function getCacheDir()
-    {
-        return $this->rootDir.'/'.$this->environment.'/cache';
-    }
-}
-
                  -
                  -

                  $this->rootDir es la ruta absoluta al directorio app y $this->environment -es el entorno actual (es decir, dev). En este caso cambiaste la ubicación del directorio cache a app/{environment}/cache.

                  -
                  -

                  Prudencia

                  -

                  Tendrías que mantener un diferente directorio cache para cada entorno, de lo contrario puede ocurrir algún comportamiento inesperado. Cada entorno genera sus propios archivos de configuración almacenados en caché, y por lo tanto cada cual necesita su propio directorio para almacenar esos archivos en caché.

                  -
                  -
                  -
                  -

                  Sustituyendo el directorio logs

                  -

                  Sustituir el directorio logs es igual que sustituir el directorio cache, la única diferencia es que necesitas reemplazar el método getLogDir:

                  -
                  // app/AppKernel.php
-
-// ...
-class AppKernel extends Kernel
-{
-    // ...
-
-    public function getLogDir()
-    {
-        return $this->rootDir.'/'.$this->environment.'/logs';
-    }
-}
-
                  -
                  -

                  Aquí cambiaste la ubicación del directorio a app/{environment}/logs.

                  -
                  -
                  -

                  Sustituyendo el directorio web

                  -

                  Si necesitas rebautizar o mover tu directorio web, lo único que necesitas es garantizar que la ruta al directorio app todavía es la correcta en tus controladores frontales app.php y app_dev.php. Si sencillamente rebautizas el directorio, está bien. Pero si lo mueves de alguna manera, necesitarás modificar las rutas dentro de esos archivos:

                  -
                  require_once __DIR__.'/../Symfony/app/bootstrap.php.cache';
-require_once __DIR__.'/../Symfony/app/AppKernel.php';
-
                  -
                  -

                  Since Symfony 2.1 (in which Composer is introduced), you also need to change -the extra.symfony-web-dir option in the composer.json file:

                  -
                  {
-    ...
-    "extra": {
-        ...
-        "symfony-web-dir": "my_new_web_dir"
-    }
-}
                  -
                  -
                  -

                  Truco

                  -

                  Algunos servidores compartidos tienen un directorio web raíz public_html. Al renombrar tu directorio web de web a public_html es una manera para hacer que tu proyecto Symfony trabaje en tu servidor compartido. Otra manera es desplegar tu aplicación en un directorio fuera de tu web raíz, eliminar tu directorio public_html, y luego reemplazarlo con un enlace simbólico al web en tu proyecto.

                  -
                  -
                  -

                  Nota

                  -

                  Si utilizas el AsseticBundle necesitas configurar esto, para que este pueda utilizar el directorio web correcto:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-
-# ...
-assetic:
-    # ...
-    read_from: "%kernel.root_dir%/../../public_html"
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-
-<!-- ... -->
-<assetic:config read-from="%kernel.root_dir%/../../public_html" />
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-
-// ...
-$container->loadFromExtension('assetic', array(
-    // ...
-    'read_from' => '%kernel.root_dir%/../../public_html',
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora solo necesitas volcar tus activos de nuevo y tu aplicación debería trabajar:

                  -
                  $ php app/console assetic:dump --env=prod --no-debug
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/pdo_session_storage.html b/cookbook/configuration/pdo_session_storage.html deleted file mode 100644 index ec55f97..0000000 --- a/cookbook/configuration/pdo_session_storage.html +++ /dev/null @@ -1,321 +0,0 @@ - - - - - - - Cómo utilizar PdoSessionHandler para almacenar sesiones en la base de datos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar PdoSessionHandler para almacenar sesiones en la base de datos

                  -

                  El almacenamiento de sesiones predeterminado de Symfony2 escribe la información de la sesión en archivo(s). La mayoría desde medianos hasta grandes sitios web utilizan una base de datos para almacenar valores de sesión en lugar de archivos, porque las bases de datos son más fáciles de usar y escalar en un entorno web multiservidor.

                  -

                  Symfony2 ha incorporado una solución para el almacenamiento de la sesión en la base de datos denominada Symfony\Component\HttpFoundation\SessionStorage\PdoSessionStorage. -Para usarla, sólo tienes que cambiar algunos parámetros en config.yml (o el formato de configuración de tu elección):

                  -

                  -Nuevo en la versión 2.1: En Symfony 2.1 la clase y el espacio de nombres se han modificado significativamente. Ahora puedes encontrar las clases de almacenamiento de sesión en el espacio de nombres Session\Storage: -Symfony\Component\HttpFoundation\Session\Storage. Además ten en cuenta que en Symfony 2.1 debes configurar handler_id no storage_id como en Symfony2.0. -Abajo, notarás que ya no se utiliza %sesión.storage.options%.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-framework:
-    session:
-        # ...
-        handler_id:     session.handler.pdo
-
-parameters:
-    pdo.db_options:
-        db_table:    session
-        db_id_col:   session_id
-        db_data_col: session_value
-        db_time_col: session_time
-
-services:
-    pdo:
-        class: PDO
-        arguments:
-            dsn:      "mysql:dbname=mydatabase"
-            user:     myuser
-            password: mypassword
-
-    session.handler.pdo:
-        class:     Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler
-        arguments: ["@pdo", "%pdo.db_options%"]
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<framework:config>
-    <framework:session handler-id="session.handler.pdo" cookie-lifetime="3600" auto-start="true"/>
-</framework:config>
-
-<parameters>
-    <parameter key="pdo.db_options" type="collection">
-        <parameter key="db_table">session</parameter>
-        <parameter key="db_id_col">session_id</parameter>
-        <parameter key="db_data_col">session_value</parameter>
-        <parameter key="db_time_col">session_time</parameter>
-    </parameter>
-</parameters>
-
-    <services>
-    <service id="pdo" class="PDO">
-        <argument>mysql:dbname=mydatabase</argument>
-        <argument>myuser</argument>
-        <argument>mypassword</argument>
-    </service>
-
-    <service id="session.handler.pdo" class="Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler">
-        <argument type="service" id="pdo" />
-        <argument>%pdo.db_options%</argument>
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-$container->loadFromExtension('framework', array(
-    ...,
-    'session' => array(
-        // ...,
-        'handler_id' => 'session.handler.pdo',
-    ),
-));
-
-$container->setParameter('pdo.db_options', array(
-    'db_table'      => 'session',
-    'db_id_col'     => 'session_id',
-    'db_data_col'   => 'session_value',
-    'db_time_col'   => 'session_time',
-));
-
-$pdoDefinition = new Definition('PDO', array(
-    'mysql:dbname=mydatabase',
-    'myuser',
-    'mypassword',
-));
-$container->setDefinition('pdo', $pdoDefinition);
-
-$storageDefinition = new Definition('Symfony\Component\HttpFoundation\Session\Storage\Handler\PdoSessionHandler', array(
-    new Reference('pdo'),
-    '%pdo.db_options%',
-));
-$container->setDefinition('session.handler.pdo', $storageDefinition);
-
                    -
                    -
                    • -
                  -
                  -
                    -
                  • db_table: El nombre de la tabla de sesiones en tu base de datos
                    • -
                  • db_id_col: El nombre de la columna id en la tabla de sesiones (VARCHAR (255) o más grande)
                    • -
                  • db_data_col: El nombre de la columna de valores en tu tabla de sesiones (TEXT o CLOB)
                    • -
                  • db_time_col: El nombre de la columna de tiempo en tu tabla de sesiones (INTEGER)
                    • -
                  -
                  -

                  Compartiendo información de conexión a tu base de datos

                  -

                  Con la configuración dada, la configuración de conexión de la base de datos únicamente se define para la conexión de almacenamiento de sesión. Esto está bien cuando utilizas una base de datos para los datos de sesión.

                  -

                  Pero si deseas almacenar los datos de sesión en la misma base que el resto de los datos de tu proyecto, puedes utilizar la configuración de conexión de parameters.yml refiriendo los parámetros relacionados con la base de datos definidos allí:

                  -
                  -
                    -
                  • YAML
                    pdo:
-    class: PDO
-    arguments:
-        - "mysql:host=%database_host%;port=%database_port%;dbname=%database_name%"
-        - "%database_user%"
-        - "%database_password%"
-
                    -
                    -
                    • -
                  • XML
                    <service id="pdo" class="PDO">
-    <argument>mysql:host=%database_host%;port=%database_port%;dbname=%database_name%</argument>
-    <argument>%database_user%</argument>
-    <argument>%database_password%</argument>
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $pdoDefinition = new Definition('PDO', array(
-    'mysql:host=%database_host%;port=%database_port%;dbname=%database_name%',
-    '%database_user%',
-    '%database_password%',
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Instrucciones SQL de ejemplo

                  -
                  -

                  MySQL

                  -

                  La declaración SQL necesaria para crear la tabla en la base de datos podría ser similar a la siguiente (MySQL):

                  -
                  CREATE TABLE `session` (
-    `session_id` varchar(255) NOT NULL,
-    `session_value` text NOT NULL,
-    `session_time` int(11) NOT NULL,
-    PRIMARY KEY (`session_id`)
-) ENGINE=InnoDB DEFAULT CHARSET=utf8;
-
                  -
                  -
                  -
                  -

                  PostgreSQL

                  -

                  Para PostgreSQL, la declaración debe tener este aspecto:

                  -
                  CREATE TABLE session (
-    session_id character varying(255) NOT NULL,
-    session_value text NOT NULL,
-    session_time integer NOT NULL,
-    CONSTRAINT session_pkey PRIMARY KEY (session_id)
-);
-
                  -
                  -
                  -
                  -

                  «Microsoft SQL Server»

                  -

                  Para MSSQL, la declaración se podría parecer a la siguiente:

                  -
                  CREATE TABLE [dbo].[session](
-    [session_id] [nvarchar](255) NOT NULL,
-    [session_value] [ntext] NOT NULL,
-    [session_time] [int] NOT NULL,
-    PRIMARY KEY CLUSTERED(
-        [session_id] ASC
-    ) WITH (
-        PAD_INDEX  = OFF,
-        STATISTICS_NORECOMPUTE  = OFF,
-        IGNORE_DUP_KEY = OFF,
-        ALLOW_ROW_LOCKS  = ON,
-        ALLOW_PAGE_LOCKS  = ON
-    ) ON [PRIMARY]
-) ON [PRIMARY] TEXTIMAGE_ON [PRIMARY]
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/configuration/web_server_configuration.html b/cookbook/configuration/web_server_configuration.html deleted file mode 100644 index 7e14c7c..0000000 --- a/cookbook/configuration/web_server_configuration.html +++ /dev/null @@ -1,211 +0,0 @@ - - - - - - - Configuring a web server — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configuring a web server

                  -

                  The web directory is the home of all of your application’s public and static -files. Including images, stylesheets and JavaScript files. It is also where the -front controllers live. For more details, see the El directorio web.

                  -

                  The web directory services as the document root when configuring your web -server. In the examples below, this directory is in /var/www/project/web/.

                  -
                  -

                  Apache2

                  -

                  For advanced Apache configuration options, see the official Apache -documentation. The minimum basics to get your application running under Apache2 -are:

                  -
                  <VirtualHost *:80>
-    ServerName www.domain.tld
-
-    DocumentRoot /var/www/project/web
-    <Directory /var/www/project/web>
-        # enable the .htaccess rewrites
-        AllowOverride All
-        Order allow,deny
-        Allow from All
-    </Directory>
-
-    ErrorLog /var/log/apache2/project_error.log
-    CustomLog /var/log/apache2/project_access.log combined
-</VirtualHost>
-
                  -
                  -
                  -

                  Nota

                  -

                  For performance reasons, you will probably want to set -AllowOverride None and implement the rewrite rules in the web/.htaccess -into the virtualhost config.

                  -
                  -
                  -
                  -

                  Nginx

                  -

                  For advanced Nginx configuration options, see the official Nginx -documentation. The minimum basics to get your application running under Nginx -are:

                  -
                  server {
-    server_name www.domain.tld;
-    root /var/www/project/web;
-
-    location / {
-        # try to serve file directly, fallback to rewrite
-        try_files $uri @rewriteapp;
-    }
-
-    location @rewriteapp {
-        # rewrite all to app.php
-        rewrite ^(.*)$ /app.php/$1 last;
-    }
-
-    location ~ ^/(app|app_dev)\.php(/|$) {
-        fastcgi_pass unix:/var/run/php5-fpm.sock;
-        fastcgi_split_path_info ^(.+\.php)(/.*)$;
-        include fastcgi_params;
-        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
-        fastcgi_param HTTPS off;
-    }
-
-    error_log /var/log/nginx/project_error.log;
-    access_log /var/log/nginx/project_access.log;
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Depending on your PHP-FPM config, the fastcgi_pass can also be -fastcgi_pass 127.0.0.1:9000.

                  -
                  -
                  -

                  Truco

                  -

                  This executes only app.php and app_dev.php in the web directory. -All other files will be served as text. If you have other PHP files in -your web directory, be sure to include them in the location block -above.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/console/console_command.html b/cookbook/console/console_command.html deleted file mode 100644 index cf51c68..0000000 --- a/cookbook/console/console_command.html +++ /dev/null @@ -1,252 +0,0 @@ - - - - - - - Cómo crear una orden de consola — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear una orden de consola

                  -

                  La página Console de la sección de componentes (El componente Console) trata sobre cómo crear una orden de Consola. Este artículo trata sobre las diferencias cuando creas ordenes de consola en la plataforma Symfony2.

                  -
                  -

                  Registrando ordenes automáticamente

                  -

                  Para hacer que las ordenes de consola estén disponibles automáticamente en Symfony2, crea un directorio Command dentro de tu paquete y crea un archivo PHP con el sufijo Command.php para cada orden que deses proveer. Por ejemplo, si deseas ampliar el AcmeDemoBundle (disponible en la edición estándar de Symfony) para darte la bienvenida desde la línea de ordenes, crea el archivo GreetCommand.php y agrégale lo siguiente:

                  -
                  // src/Acme/DemoBundle/Command/GreetCommand.php
-namespace Acme\DemoBundle\Command;
-
-use Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand;
-use Symfony\Component\Console\Input\InputArgument;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Input\InputOption;
-use Symfony\Component\Console\Output\OutputInterface;
-
-class GreetCommand extends ContainerAwareCommand
-{
-    protected function configure()
-    {
-        $this
-            ->setName('demo:greet')
-            ->setDescription('Greet someone')
-            ->addArgument('name', InputArgument::OPTIONAL, 'Who do you want to greet?')
-            ->addOption('yell', null, InputOption::VALUE_NONE, 'If set, the task will yell in uppercase letters')
-        ;
-    }
-
-    protected function execute(InputInterface $input, OutputInterface $output)
-    {
-        $name = $input->getArgument('name');
-        if ($name) {
-            $text = 'Hello '.$name;
-        } else {
-            $text = 'Hello';
-        }
-
-        if ($input->getOption('yell')) {
-            $text = strtoupper($text);
-        }
-
-        $output->writeln($text);
-    }
-}
-
                  -
                  -

                  Ahora, automáticamente, esta orden estará disponible para funcionar:

                  -
                  $ app/console demo:greet Fabien
-
                  -
                  -
                  -
                  -

                  Obteniendo servicios del contenedor de servicios

                  -

                  Al usar Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand como la clase base para la orden (en lugar de la clase más básica Symfony\Component\Console\Command\Command), tienes acceso al contenedor de servicios. En otras palabras, tienes acceso a cualquier servicio configurado. -Por ejemplo, fácilmente podrías extender la tarea para que sea traducible:

                  -
                  protected function execute(InputInterface $input, OutputInterface $output)
-{
-    $name = $input->getArgument('name');
-    $translator = $this->getContainer()->get('translator');
-    if ($name) {
-        $output->writeln($translator->trans('Hello %name%!', array('%name%' => $name)));
-    } else {
-        $output->writeln($translator->trans('Hello!'));
-    }
-}
-
                  -
                  -
                  -
                  -

                  Probando ordenes

                  -

                  Cuando pruebes ordenes utilizadas como parte de la plataforma completa debes utilizar la Symfony\Bundle\FrameworkBundle\Console\Application en lugar de Symfony\Component\Console\Application:

                  -
                  use Symfony\Component\Console\Tester\CommandTester;
-use Symfony\Bundle\FrameworkBundle\Console\Application;
-use Acme\DemoBundle\Command\GreetCommand;
-
-class ListCommandTest extends \PHPUnit_Framework_TestCase
-{
-    public function testExecute()
-    {
-        // simula el Kernel o crea uno dependiendo de tus necesidades
-        $application = new Application($kernel);
-        $application->add(new GreetCommand());
-
-        $command = $application->find('demo:greet');
-        $commandTester = new CommandTester($command);
-        $commandTester->execute(array('command' => $command->getName()));
-
-        $this->assertRegExp('/.../', $commandTester->getDisplay());
-
-        // ...
-    }
-}
-
                  -
                  -

                  Para poder utilizar plenamente el contenedor del servicios configurado en tus pruebas de consola puedes extender tu prueba de Symfony\Bundle\FrameworkBundle\Test\WebTestCase:

                  -
                  use Symfony\Component\Console\Tester\CommandTester;
-use Symfony\Bundle\FrameworkBundle\Console\Application;
-use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-use Acme\DemoBundle\Command\GreetCommand;
-
-class ListCommandTest extends WebTestCase
-{
-    public function testExecute()
-    {
-        $kernel = $this->createKernel();
-        $kernel->boot();
-
-        $application = new Application($kernel);
-        $application->add(new GreetCommand());
-
-        $command = $application->find('demo:greet');
-        $commandTester = new CommandTester($command);
-        $commandTester->execute(array('command' => $command->getName()));
-
-        $this->assertRegExp('/.../', $commandTester->getDisplay());
-
-        // ...
-    }
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/console/index.html b/cookbook/console/index.html deleted file mode 100644 index 17aed61..0000000 --- a/cookbook/console/index.html +++ /dev/null @@ -1,154 +0,0 @@ - - - - - - - Consola — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/console/logging.html b/cookbook/console/logging.html deleted file mode 100644 index fb835d9..0000000 --- a/cookbook/console/logging.html +++ /dev/null @@ -1,350 +0,0 @@ - - - - - - - Cómo habilitar el registro cronológico en la consola de ordenes — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo habilitar el registro cronológico en la consola de ordenes

                  -

                  El componente Console no proporciona la capacidad de registro cronológico fuera de la caja. -Normalmente, ejecutas manualmente las ordenes de la consola y observas el resultado, motivo por el cual no se proporciona el registro cronológico. Sin embargo, hay casos en los que puedes necesitar el registro. Por ejemplo, si estás ejecutando ordenes de consola desatendidas, tal como trabajos programados o guiones de despliegue, posiblemente sea más fácil usar las capacidades de registro de Symfony en lugar de configurar otras herramientas para reunir el resultado de la consola y procesarlo. Esto puede ser especialmente útil si ya tienes alguna configuración existente para agregar y analizar los registros de Symfony.

                  -
                  -
                  Básicamente, hay dos casos de registro que puedes necesitar:
                  -
                    -
                  • El registo manual de cierta información de tu orden;
                    • -
                  • El registro de excepciones no capturadas.
                    • -
                  -
                  -
                  -
                  -

                  Registrando manualmente una orden de consola

                  -

                  Esto es realmente sencillo. Cuando creas una orden de consola en la plataforma completa, como se describe en «Cómo crear una orden de consola», tu orden extiende a Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand. -Esto significa que sólo tienes que acceder al servicio de registro estándar a través del contenedor y usarlo para hacer el registro:

                  -
                  // src/Acme/DemoBundle/Command/GreetCommand.php
-namespace Acme\DemoBundle\Command;
-
-use Symfony\Bundle\FrameworkBundle\Command\ContainerAwareCommand;
-use Symfony\Component\Console\Input\InputArgument;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Input\InputOption;
-use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\HttpKernel\Log\LoggerInterface;
-
-class GreetCommand extends ContainerAwareCommand
-{
-    // ...
-
-    protected function execute(InputInterface $input, OutputInterface $output)
-    {
-        /** @var $logger LoggerInterface */
-        $logger = $this->getContainer()->get('logger');
-
-        $name = $input->getArgument('name');
-        if ($name) {
-            $text = 'Hello '.$name;
-        } else {
-            $text = 'Hello';
-        }
-
-        if ($input->getOption('yell')) {
-            $text = strtoupper($text);
-            $logger->warn('Yelled: '.$text);
-        }
-        else {
-            $logger->info('Greeted: '.$text);
-        }
-
-        $output->writeln($text);
-    }
-}
-
                  -
                  -

                  Dependiendo del entorno en el que se ejecuta la orden (y tu configuración de registro cronológico), deberías ver las entradas registradas en app/logs/dev.log o app/logs/prod.log.

                  -
                  -
                  -

                  Habilitando el registro automático de excepciones

                  -

                  Para que tu aplicación de consola automáticamente registre las excepciones no capturadas para todas tus órdenes, tendrás que hacer un poco más de trabajo.

                  -

                  En primer lugar, crea una nueva subclase de Symfony\Bundle\FrameworkBundle\Console\Application y reemplaza su método run(), donde debe suceder el manejo de las excepciones:

                  -
                  -

                  Prudencia

                  -

                  Debido a la naturaleza de la clase Symfony\Component\Console\Application del núcleo, gran parte del método run se tiene que duplicar e incluso reimplementar la propiedad privada originalAutoExit. Esto sirve como ejemplo de lo que podrías hacer en tu código, aunque hay un muy alto riesgo de que algo se pueda romper al actualizar a las futuras versiones de Symfony.

                  -
                  -
                  // src/Acme/DemoBundle/Console/Application.php
-namespace Acme\DemoBundle\Console;
-
-use Symfony\Bundle\FrameworkBundle\Console\Application as BaseApplication;
-use Symfony\Component\Console\Input\InputInterface;
-use Symfony\Component\Console\Output\OutputInterface;
-use Symfony\Component\Console\Output\ConsoleOutputInterface;
-use Symfony\Component\HttpKernel\Log\LoggerInterface;
-use Symfony\Component\HttpKernel\KernelInterface;
-use Symfony\Component\Console\Output\ConsoleOutput;
-use Symfony\Component\Console\Input\ArgvInput;
-
-class Application extends BaseApplication
-{
-    private $originalAutoExit;
-
-    public function __construct(KernelInterface $kernel)
-    {
-        parent::__construct($kernel);
-        $this->originalAutoExit = true;
-    }
-
-    /**
-     * Ejecuta la aplicación actual.
-     *
-     * @param InputInterface  $input  un ejemplar de entrada
-     * @param OutputInterface $output un ejemplar de salida
-     *
-     * @return integer 0 si todo salió bien, o un código de error
-     *
-     * @throws \Exception cuándo run devuelva una Excepción
-     *
-     * @api
-     */
-    public function run(InputInterface $input = null, OutputInterface $output = null)
-    {
-        // hace que el padre lance excepciones, para que las puedas registrar
-        $this->setCatchExceptions(false);
-
-        if (null === $input) {
-            $input = new ArgvInput();
-        }
-
-        if (null === $output) {
-            $output = new ConsoleOutput();
-        }
-
-        try {
-            $statusCode = parent::run($input, $output);
-        } catch (\Exception $e) {
-
-            /** @var $logger LoggerInterface */
-            $logger = $this->getKernel()->getContainer()->get('logger');
-
-            $message = sprintf(
-                '%s: %s (uncaught exception) at %s line %s while running console command `%s`',
-                get_class($e),
-                $e->getMessage(),
-                $e->getFile(),
-                $e->getLine(),
-                $this->getCommandName($input)
-            );
-            $logger->crit($message);
-
-            if ($output instanceof ConsoleOutputInterface) {
-                $this->renderException($e, $output->getErrorOutput());
-            } else {
-                $this->renderException($e, $output);
-            }
-            $statusCode = $e->getCode();
-
-            $statusCode = is_numeric($statusCode) && $statusCode ? $statusCode : 1;
-        }
-
-        if ($this->originalAutoExit) {
-            if ($statusCode > 255) {
-                $statusCode = 255;
-            }
-            // @codeCoverageIgnoreStart
-            exit($statusCode);
-            // @codeCoverageIgnoreEnd
-        }
-
-        return $statusCode;
-    }
-
-    public function setAutoExit($bool)
-    {
-        // la propiedad parent es privada, por lo que es necesario
-        // interceptarla en un definidor
-        $this->originalAutoExit = (Boolean) $bool;
-        parent::setAutoExit($bool);
-    }
-
-}
-
                  -
                  -

                  En el código anterior, desactivaste la captura de excepciones para que el padre lance el método run en todas las excepciones. Cuando se detecta una excepción, simplemente la registras accediendo al servicio logger del contenedor de servicios y luego manejas el resto de la lógica de la misma manera que lo hace el método run del padre (específicamente, debido a que el método run del padre no se encargará de la representación y manipulación del código de estado de las excepciones cuando catchExceptions se establezca en false, esto se tiene que hacer en el método redefinido).

                  -

                  Para que trabaje correctamente la clase aplicación extendida con la consola en modo de intérprete, tienes que hacer un pequeño truco para interceptar el definidor autoExit y almacenar el valor en una propiedad diferente, ya que la propiedad del padre es privada.

                  -

                  Ahora, para poder utilizar tu clase Aplicación extendida es necesario ajustar el guión app/console para utilizar la nueva clase en lugar de la predeterminada:

                  -
                  // app/console
-
-// ...
-// reemplaza la siguiente línea:
-// use Symfony\Bundle\FrameworkBundle\Console\Application;
-use Acme\DemoBundle\Console\Application;
-
-// ...
-
                  -
                  -

                  ¡Eso es todo! Gracias al cargador automático, ahora puedes utilizar tu clase en lugar de la original.

                  -
                  -
                  -

                  Registrando estados de salida distintos de 0

                  -

                  Las capacidades de registro de la consola se pueden ampliar aún más registrando estados de salida distintos de 0. De esta manera sabrás si alguna orden tuvo algún error, incluso si no se lanzaron excepciones.

                  -

                  Con el fin de hacerlo, tendrás que modificar el método run() de tu clase Aplicación extendida de la siguiente manera:

                  -
                  public function run(InputInterface $input = null,
-                    OutputInterface $output = null)
-{
-    // hace que el padre lance excepciones, para que las puedas registrar
-    $this->setCatchExceptions(false);
-
-    // almacena el valor de autoExit antes de
-    // restablecerlo - lo necesitarás más adelante
-    $autoExit = $this->originalAutoExit;
-    $this->setAutoExit(false);
-
-    // ...
-
-    if ($autoExit) {
-        if ($statusCode > 255) {
-            $statusCode = 255;
-        }
-
-        // registra códigos de salida distintos de 0 junto
-        // con el nombre de la orden
-        if ($statusCode !== 0) {
-            /** @var $logger LoggerInterface */
-            $logger = $this->getKernel()->getContainer()->get('logger');
-            $logger->warn(sprintf('Command `%s` exited with status code %d',
-                                  $this->getCommandName($input),
-                                  $statusCode));
-        }
-
-        // @codeCoverageIgnoreStart
-        exit($statusCode);
-        // @codeCoverageIgnoreEnd
-    }
-
-    return $statusCode;
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/console/sending_emails.html b/cookbook/console/sending_emails.html deleted file mode 100644 index aae87a5..0000000 --- a/cookbook/console/sending_emails.html +++ /dev/null @@ -1,219 +0,0 @@ - - - - - - - Cómo generar URL y enviar mensajes de correo electrónico desde la consola — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo generar URL y enviar mensajes de correo electrónico desde la consola

                  -

                  Desafortunadamente, el contexto de la línea de ordenes no sabe nada de tu servidor virtual o nombre de dominio. Esto significa que si generas URL absolutas dentro de una orden de consola, probablemente terminarás con algo inútil similar a http://localhost/foo/bar.

                  -

                  Para solucionar este problema, necesitas configurar el «contexto de la petición», que es una caprichosa manera de decir que necesitas configurar el entorno para que sepa qué URL debe utilizar al generar direcciones URL.

                  -

                  Hay dos maneras de configurar el contexto de la petición: a nivel de aplicación y por orden.

                  -
                  -

                  Configurando el contexto de la petición a nivel global

                  -

                  -Nuevo en la versión 2.1: Los parámetros host y scheme están disponibles a partir de Symfony 2.1

                  -

                  -Nuevo en la versión 2.2: El parámetro base_url está disponible desde Symfony 2.2

                  -

                  Para configurar el contexto de la petición —el cual utiliza el generador de URL— puedes redefinir los parámetros que utiliza como valores predefinidos para cambiar el servidor (localhost) y esquema (http) predeterminado. A partir de Symfony 2.2 también puedes configurar la ruta base siempre y cuando Symfony no se esté ejecutando en el directorio raíz.

                  -

                  Ten en cuenta que esto no impacta directamente en las URL generadas a través de peticiones web normales, ya que se sustituyen los valores predeterminados.

                  -
                  -
                    -
                  • YAML
                    # app/config/parameters.yml
-parameters:
-    router.request_context.host: example.org
-    router.request_context.scheme: https
-    router.request_context.base_url: my/path
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/parameters.xml -->
-<?xml version="1.0" encoding="UTF-8"?>
-
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
-
-    <parameters>
-        <parameter key="router.request_context.host">example.org</parameter>
-        <parameter key="router.request_context.scheme">https</parameter>
-        <parameter key="router.request_context.base_url">my/path</parameter>
-    </parameters>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_test.php
-$container->setParameter('router.request_context.host', 'example.org');
-$container->setParameter('router.request_context.scheme', 'https');
-$container->setParameter('router.request_context.base_url', 'my/path');
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Configurando el contexto de la petición por orden

                  -

                  Para cambiarlo sólo en una orden sencillamente puede recuperar el contexto del servicio de la petición y sustituir sus opciones:

                  -
                  // src/Acme/DemoBundle/Command/DemoCommand.php
-
-// ...
-class DemoCommand extends ContainerAwareCommand
-{
-    protected function execute(InputInterface $input, OutputInterface $output)
-    {
-        $context = $this->getContainer()->get('router')->getContext();
-        $context->setHost('example.com');
-        $context->setScheme('https');
-        $context->setBaseUrl('my/path');
-
-        // ... tu código aquí
-    }
-}
-
                  -
                  -
                  -
                  -

                  Con cola de memoria

                  -

                  El envío de mensajes de correo electrónico en una orden de consola funciona de la misma manera descrita en el artículo Cómo enviar correo electrónico del recetario, salvo que esta utiliza memoria de la cola de impresión.

                  -

                  Cuando se utiliza memoria de la cola (consulta el Cómo formar en la cola mensajes de correo electrónico del recetario para más información), debes tener en cuenta que debido a la forma en que Symfony se maneja de consola de ordenes, los mensajes de correo electrónico no se envían automáticamente. Debes tener cuidado de vaciar tú mismo la cola. Utiliza el siguiente código para enviar mensajes de correo electrónico dentro de tu orden de consola:

                  -
                  $container = $this->getContainer();
-$mailer = $container->get('mailer');
-$spool = $mailer->getTransport()->getSpool();
-$transport = $container->get('swiftmailer.transport.real');
-
-$spool->flushQueue($transport);
-
                  -
                  -

                  Otra opción es crear un ambiente que sólo sea utilizado por esa orden de consola y utilizar un método diferente en la cola de impresión.

                  -
                  -

                  Nota

                  -

                  Sólo es necesario tener cuidado de la cola de impresión cuando se utiliza memoria de la cola de impresión. -Si estás utilizando un archivo para la cola (o no utilizas la cola de impresión), no es necesario vaciar manualmente la cola dentro de la orden.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/console/usage.html b/cookbook/console/usage.html deleted file mode 100644 index 4a44820..0000000 --- a/cookbook/console/usage.html +++ /dev/null @@ -1,166 +0,0 @@ - - - - - - - Cómo usar la consola — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar la consola

                  -

                  La página Usando órdenes de consola, atajos y órdenes integradas de la documentación de los componentes en las opciones globales de la consola. Cuándo utilizas la consola como parte de la pila completa de la plataforma, también dispones de algunas opciones globales adicionales.

                  -

                  De manera predeterminada, las ordenes de la consola se ejecutan en el entorno dev y posiblemente lo quieras cambiar en algunas órdenes. Por ejemplo, posiblemente quieras ejecutar algunas órdenes en el entorno prod por razones de rendimiento. Además, el resultado de algunas órdenes será diferente dependiendo del entorno. Por ejemplo, la orden cache:clear limpiará y preparará la caché sólo para el entorno especificado. Para limpiar y preparar la caché del entorno prod debes ejecutar:

                  -
                  $ php app/console cache:clear --env=prod
-
                  -
                  -

                  o la equivalente:

                  -
                  $ php app/console cache:clear -e=prod
-
                  -
                  -

                  Además de cambiar el entorno, también puedes elegir desactivar el modo de depuración. -Esto puede ser útil cuándo quieras ejecutar órdenes en el entorno dev pero evitando el impacto negativo en el rendimiento por la recolección de datos para depuración:

                  -
                  $ php app/console list --no-debug
-
                  -
                  -

                  hay un intérprete interactivo que te permite introducir órdenes sin tener que especificar cada vez php app/console, el cual es útil si necesitas ejecutar varias órdenes. Para entrar al intérprete ejecuta:

                  -
                  $ php app/console --shell
-$ php app/console -s
-
                  -
                  -

                  Ahora puedes ejecutar órdenes sólo con el nombre de la orden:

                  -
                  Symfony > list
-
                  -
                  -

                  Cuándo utilizas el intérprete puedes elegir ejecutar cada orden en un proceso separado:

                  -
                  $ php app/console --shell --process-isolation
-$ php app/console -s --process-isolation
-
                  -
                  -

                  Cuándo lo haces, la producción no será coloreada y no cuentas con apoyo para la interactividad por lo tanto necesitarás pasar todos los argumentos para las ordenes explícitamente.

                  -
                  -

                  Nota

                  -

                  A no ser que estés usando procesos separados, limpiar la caché en el intérprete no tendrá efecto en las subsecuentes ordenes que ejecutes. Esto se debe a que todavía se están utilizando los archivos memorizados originalmente.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/controller/error_pages.html b/cookbook/controller/error_pages.html deleted file mode 100644 index 5e275ad..0000000 --- a/cookbook/controller/error_pages.html +++ /dev/null @@ -1,186 +0,0 @@ - - - - - - - Cómo personalizar páginas de error — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo personalizar páginas de error

                  -

                  Cuando se lanza alguna excepción en Symfony2, la excepción es capturada dentro de la clase del núcleo y, finalmente, remitida a un controlador especial, TwigBundle:Exception:show para procesarla. Este controlador, el cual vive dentro del núcleo de TwigBundle, determina cual plantilla de error mostrar y el código de estado que se debe establecer para la excepción dada.

                  -

                  Puedes personalizar las páginas de error de dos formas diferentes, dependiendo de la cantidad de control que necesites:

                  -
                    -
                  1. Personalizando las plantillas de error de las diferentes páginas de error (se explica más adelante);
                    2. -
                  2. Reemplazando el controlador de excepciones TwigBundle::Exception:show predeterminado con tu propio controlador y procesándolo como quieras (consulta exception_controller en la referencia de Twig);
                    3. -
                  -
                  -

                  Truco

                  -

                  Personalizar el tratamiento de las excepciones en realidad es mucho más poderoso que lo escrito aquí. Produce un evento interno, core.exception, el cual te permite completo control sobre el manejo de la excepción. Para más información, consulta el Evento kernel.exception.

                  -
                  -

                  Todas las plantillas de error viven dentro de TwigBundle. Para sustituir las plantillas, simplemente confiamos en el método estándar para reemplazar las plantillas que viven dentro de un paquete. Para más información, consulta Sustituyendo plantillas del paquete.

                  -

                  Por ejemplo, para sustituir la plantilla de error predeterminada mostrada al usuario final, crea una nueva plantilla ubicada en app/Resources/TwigBundle/views/Exception/error.html.twig:

                  -
                  <!DOCTYPE html>
-    <html>
-    <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title>An Error Occurred: {{ status_text }}</title>
-    </head>
-    <body>
-    <h1>Oops! An Error Occurred</h1>
-    <h2>The server returned a "{{ status_code }} {{ status_text }}".</h2>
-</body>
-</html>
-
                  -
                  -
                  -

                  Prudencia

                  -

                  No debes utilizar is_granted en tus páginas de error (o diseños utilizados por tus páginas de error), porque el enrutador se ejecuta antes del cortafuegos. Si el enrutador lanza una excepción (por ejemplo, cuándo la ruta no coincide), entonces utilizar is_granted desencadenará una nueva excepción. You -can use is_granted safely by saying {% if app.user and is_granted('...') %}.

                  -
                  -
                  -

                  Truco

                  -

                  Si no estás familiarizado con Twig, no te preocupes. Twig es un sencillo, potente y opcional motor de plantillas que se integra con Symfony2. Para más información sobre Twig consulta Creando y usando plantillas.

                  -
                  -

                  Además de la página de error HTML estándar, Symfony proporciona una página de error predeterminada para muchos de los más comunes formatos de respuesta, como JSON (error.json.twig), XML (error.xml.twig) e incluso Javascript (error.js.twig), sólo por nombrar algunos. Para sustituir cualquiera de estas plantillas, basta con crear un nuevo archivo con el mismo nombre en el directorio app/Resources/TwigBundle/views/Exception. Esta es la manera estándar de sustituir cualquier plantilla que viva dentro de un paquete.

                  -
                  -

                  Personalizando la página 404 y otras páginas de error

                  -

                  También puedes personalizar plantillas de error específicas de acuerdo con el código de estado HTTP. Por ejemplo, crea una plantilla app/Resources/TwigBundle/views/Exception/error404.html.twig para mostrar una página especial para los errores 404 (página no encontrada).

                  -

                  Symfony utiliza el siguiente algoritmo para determinar qué plantilla utilizar:

                  -
                    -
                  • En primer lugar, busca una plantilla para el formato dado y el código de estado (como error404.json.twig);
                    • -
                  • Si no existe, busca una plantilla para el formato propuesto (como error.json.twig);
                    • -
                  • Si no existe, este cae de nuevo a la plantilla HTML (como error.html.twig).
                    • -
                  -
                  -

                  Truco

                  -

                  Para ver la lista completa de plantillas de error predeterminadas, revisa el directorio Resources/views/Exception de TwigBundle. En una instalación estándar de Symfony2, el TwigBundle se puede encontrar en vendor/symfony/symfony/src/Symfony/Bundle/TwigBundle. A menudo, la forma más fácil de personalizar una página de error es copiarla de TwigBundle a app/Resources/TwigBundle/views/Exception y luego modificarla.

                  -
                  -
                  -

                  Nota

                  -

                  El amigable depurador de páginas de excepción muestra al desarrollador cómo, incluso, puede personalizar de la misma manera creando plantillas como exception.html.twig para la página de excepción HTML estándar o exception.json.twig para la página de excepción JSON.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/controller/index.html b/cookbook/controller/index.html deleted file mode 100644 index ab83d18..0000000 --- a/cookbook/controller/index.html +++ /dev/null @@ -1,143 +0,0 @@ - - - - - - - Controlador — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/controller/service.html b/cookbook/controller/service.html deleted file mode 100644 index fef9aae..0000000 --- a/cookbook/controller/service.html +++ /dev/null @@ -1,165 +0,0 @@ - - - - - - - Cómo definir controladores como servicios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo definir controladores como servicios

                  -

                  En el libro, has aprendido lo fácilmente que puedes utilizar un controlador cuando extiende la clase base Symfony\Bundle\FrameworkBundle\Controller\Controller. Si bien esto funciona estupendamente, los controladores también se pueden especificar como servicios.

                  -

                  Para referir un controlador que se defina como servicio, utiliza la notación de dos puntos individuales (:). Por ejemplo, supongamos que has definido un servicio llamado my_controller y —dentro del servicio— lo quieres redirigir a un método llamado indexAction():

                  -
                  $this->forward('my_controller:indexAction', array('foo' => $bar));
-
                  -
                  -

                  Necesitas usar la misma notación para definir el valor _controller de la ruta:

                  -
                  my_controller:
-    path:   /
-    defaults:  { _controller: my_controller:indexAction }
-
                  -
                  -

                  Para utilizar un controlador de esta manera, este se debe definir en la configuración del contenedor de servicios. Para más información, consulta el capítulo Contenedor de servicios.

                  -

                  Cuando se utiliza un controlador definido como servicio, lo más probable es no ampliar la clase base Controller. En lugar de confiar en sus métodos de acceso directo, debes interactuar directamente con los servicios que necesitas. Afortunadamente, esto suele ser bastante fácil y la clase base Controller en sí es una gran fuente sobre la manera de realizar muchas tareas comunes.

                  -
                  -

                  Nota

                  -

                  Especificar un controlador como servicio requiere un poco más de trabajo. La principal ventaja es que el controlador completo o cualquier otro servicio pasado al controlador se puede modificar a través de la configuración del contenedor de servicios. -Esto es útil especialmente cuando desarrollas un paquete de código abierto o cualquier paquete que se pueda utilizar en muchos proyectos diferentes. Así que, aunque no especifiques los controladores como servicios, es probable que veas hacer esto en algunos paquetes de código abierto de Symfony2.

                  -
                  -
                  -

                  Utilizando anotaciones en enrutado

                  -

                  Cuándo utilizas anotaciones para configurar el enrutado al utilizar un controlador definido como servicio, es necesario especificar tu servicio de la siguiente manera:

                  -
                  /**
- * @Route("/blog", service="my_bundle.annot_controller")
- * @Cache(expires="tomorrow")
- */
-class AnnotController extends Controller
-{
-}
-
                  -
                  -

                  En este ejemplo, my_bundle.annot_controller tendría que ser el id de la instancia de AnnotController definida en el contenedor del servicio. Esto está documentado en el capítulo @Route y @Method.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/debugging.html b/cookbook/debugging.html deleted file mode 100644 index 740e393..0000000 --- a/cookbook/debugging.html +++ /dev/null @@ -1,173 +0,0 @@ - - - - - - - Cómo optimizar tu entorno de desarrollo para depuración — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo optimizar tu entorno de desarrollo para depuración

                  -

                  Cuando trabajas en un proyecto de Symfony en tu equipo local, debes usar el entorno dev (con el controlador frontal app_dev.php). Esta configuración del entorno se ha optimizado para dos propósitos principales:

                  -
                    -
                  • Proporcionar retroalimentación de desarrollo precisa cada vez que algo sale mal (barra de herramientas de depuración web, páginas de excepción agradables, perfiles, ...);
                    • -
                  • Ser lo más parecido posible al entorno de producción para evitar problemas al desplegar el proyecto.
                    • -
                  -
                  -

                  Desactivando el archivo de arranque y la caché de clase

                  -

                  Y para que el entorno de producción sea lo más rápido posible, Symfony crea grandes archivos PHP en la memoria caché que contienen la agregación de las clases PHP que tu proyecto necesita para cada petición. Sin embargo, este comportamiento puede confundir a tu IDE o depurador. Esta fórmula muestra cómo puedes ajustar este mecanismo de memorización para que sea más amigable cuando necesitas depurar código que incluye clases de Symfony.

                  -

                  El controlador frontal app_dev.php por omisión lee lo siguiente:

                  -
                  // ...
-
-$loader = require_once __DIR__.'/../app/bootstrap.php.cache';
-require_once __DIR__.'/../app/AppKernel.php';
-
-$kernel = new AppKernel('dev', true);
-$kernel->loadClassCache();
-$request = Request::createFromGlobals();
-
                  -
                  -

                  Para contentar a tu depurador, desactiva toda la caché de las clases PHP eliminando la llamada a loadClassCache() y sustituyendo las declaraciones require como la siguiente:

                  -
                  // ...
-
-// $loader = require_once __DIR__.'/../app/bootstrap.php.cache';
-$loader = require_once __DIR__.'/../app/autoload.php';
-require_once __DIR__.'/../app/AppKernel.php';
-
-use Symfony\Component\HttpFoundation\Request;
-
-$kernel = new AppKernel('dev', true);
-// $kernel->loadClassCache();
-$request = Request::createFromGlobals();
-
                  -
                  -
                  -

                  Truco

                  -

                  Si desactivas la caché PHP, no olvides reactivarla después de tu sesión de depuración.

                  -
                  -

                  A algunos IDE no les gusta el hecho de que algunas clases se almacenen en lugares diferentes. Para evitar problemas, puedes decirle a tu IDE que omita los archivos de cache PHP, o puedes cambiar la extensión utilizada por Symfony para estos archivos:

                  -
                  $kernel->loadClassCache('classes', '.php.cache');
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/deployment-tools.html b/cookbook/deployment-tools.html deleted file mode 100644 index ae78c77..0000000 --- a/cookbook/deployment-tools.html +++ /dev/null @@ -1,254 +0,0 @@ - - - - - - - Cómo desplegar una aplicación Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo desplegar una aplicación Symfony2

                  -
                  -

                  Nota

                  -

                  El desplegando puede ser una tarea compleja y diversa que depende de tu configuración y necesidades. -Esta sección no trata de explicarlo todo, sino que más bien ofrece la mayoría de los requisitos e ideas comunes para su implementación.

                  -
                  -
                  -

                  Fundamentos para desplegar Symfony2

                  -

                  Los pasos típicos tomados para desplegar una aplicación Symfony2 incluyen:

                  -
                    -
                  1. Subir tu código modificado al servidor en producción;
                    2. -
                  2. Actualizar tus dependencias de proveedores (normalmente esto se realiza a través de Composer, y se puede hacer antes de subir tu código);
                    3. -
                  3. Ejecutar las migraciones de bases de datos o tareas similares para actualizar la estructura de los datos modificados;
                    4. -
                  4. Limpiar (y tal vez lo más importante, preparar) tu caché.
                    5. -
                  -

                  El desplegado también puede incluir otras cosas, tal como:

                  -
                    -
                  • Etiquetar una versión particular del tu código como una versión en tu repositorio de control de código fuente;
                    • -
                  • Creación de una zona de estacionamiento temporal para construir la configuración actualizada «fuera de línea»;
                    • -
                  • Ejecutar cualquier prueba disponible para garantizar la estabilidad del código y/o el servidor;
                    • -
                  • La eliminación de todos los archivos innecesarios del directorio web para mantener limpio tu entorno de producción;
                    • -
                  • Limpieza de los sistemas externos de memoria caché (como Memcached o Redis).
                    • -
                  -
                  -
                  -

                  Cómo desplegar una aplicación Symfony2

                  -

                  Hay varias maneras en que puedes desplegar una aplicación Symfony2.

                  -

                  Empezarás con algunas estrategias para desplegar básicas y a partir de ahí continuarás.

                  -
                  -

                  Transferencia de archivos básica

                  -

                  La forma más básica para desplegar una aplicación es copiar los archivos manualmente -via ftp/scp (o algún otro método similar). Esto tiene sus desventajas, ya que carecen de control sobre el sistema a medida que progresa su actualización. Este método también requiere que tomes algunos pasos manuales después de transferir los archivos (consulta la sección Tareas habituales posteriores al despliegue)

                  -
                  -
                  -
                  -

                  Usando control de código fuente

                  -

                  Si estás utilizando control de código fuente (por ejemplo, git o svn), puedes simplificar esto teniendo tu instalación en vivo también como una copia en tu repositorio. Cuando estés listo para actualizarlo es tan simple como ir a buscar a las novedades desde tu sistema de control de código fuente.

                  -

                  Esto facilita la actualización de tus archivos, pero todavía te tienes que preocupar de tomar otras medidas de control manualmente (consulta la sección Tareas habituales posteriores al despliegue).

                  -
                  -

                  Usando programas de creación y otras herramientas

                  -

                  También hay herramientas de alta calidad para ayudarte a aliviar el dolor de la implantación. Incluso hay unas cuantas herramientas que se han adaptado específicamente a las necesidades de Symfony2, y que tienen un cuidado especial para asegurarse de que todo esté correcto antes, durante y después de un despliegue.

                  -

                  Ve Las herramientas para obtener una lista de las herramientas que te pueden ayudar con el despliegue.

                  -
                  -
                  -
                  -

                  Tareas habituales posteriores al despliegue

                  -

                  Después de implantar el código fuente real, hay una serie de tareas comunes que -tendrás que llevar a cabo:

                  -
                  -

                  A) Configura tu archivo app/config/parameters.yml

                  -

                  Este archivo se debe personalizar en cada sistema. Cualquier método que utilices para desplegar tu código fuente no debe trasladar este archivo. En su lugar, los debes configurar manualmente (o mediante algún proceso de construcción) en tu servidor.

                  -
                  -
                  -

                  B) Actualiza tus proveedores

                  -

                  Tus proveedores se pueden actualizar antes de transferir el código fuente (es decir, -actualiza el directorio vendor/, y luego transfierelo, con tu código fuente), o actualízalo en el servidor después de transferir tu código fuente. En cualquier caso, basta con actualizar tus proveedores como lo haces normalmente:

                  -
                  $ php composer.phar install --optimize-autoloader
-
                  -
                  -
                  -

                  Truco

                  -

                  La bandera --optimize-autoloader hace que Composer lleve a cabo una optimización de la carga automática construyendo un «mapa de clases».

                  -
                  -
                  -
                  -

                  C) Borra la caché de Symfony

                  -

                  Asegúrate de limpiar (y preparar) la caché de Symfony:

                  -
                  $ php app/console cache:clear --env=prod --no-debug
-
                  -
                  -
                  -
                  -

                  D) Vuelca tus activos con Assetic

                  -

                  Si estás utilizando Assetic, también querrás volcar tus activos:

                  -
                  $ php app/console assetic:dump --env=prod --no-debug
-
                  -
                  -
                  -
                  -

                  E) ¡Otras cosas!

                  -

                  Es posible que haya un montón de otras cosas que necesites hacer, dependiendo de tu -configuración:

                  -
                    -
                  • La ejecución de cualquier migración de bases de datos
                    • -
                  • Vaciado de tu caché APC
                    • -
                  • La ejecución de assets:install (teniendo cuidado si ya se hizo en composer.phar install)
                    • -
                  • Añadir/editar trabajos CRON
                    • -
                  • Empujar activos a un CDN
                    • -
                  • ...
                    • -
                  -
                  -
                  -
                  -

                  Ciclo de vida de una aplicación: Integración continua, control de calidad, etc.

                  -

                  Si bien esta sección corresponde a los detalles técnicos del despliegue, el ciclo de vida completo a partir de tomar el código fuente de desarrollo y trasladarlo a producción puede tener mucho más pasos (creo que desde el despliegue hasta la puesta en escena, control de calidad, ejecución de pruebas, etc.).

                  -

                  Utilizar la puesta en escena, pruebas, control de calidad, integración continua, migraciones de bases de datos y la capacidad para poder retroceder en caso de fallo, todas son muy recomendables. Hay herramientas simples y complejas y puedes hacer tan fácil (o compleja) la instalación como tu entorno requiera.

                  -

                  No olvides que el despliegue de tu aplicación también implica la actualización de cualquier dependencia (normalmente a través de Composer), la migración de tu base de datos, vaciar la caché y otras cosas posibles como empujar tus activos a un CDN (ve Tareas habituales posteriores al despliegue).

                  -
                  -
                  -

                  Las herramientas

                  -

                  Capifony:

                  -
                  -
                  Esta herramienta ofrece un conjunto especializado de herramientas en la parte superior de Capistrano, específicamente a la medida de proyectos Symfony y Symfony2.
                  -

                  sf2debpkg:

                  -
                  -
                  Esta herramienta te ayuda a construir un paquete nativo de Debian para tu proyecto Symfony2.
                  -

                  Magallanes:

                  -
                  -
                  Esta herramienta de despliegue tipo Capistrano está construida en PHP, y puede ser facilitar a los desarrolladores de PHP su extensión para cubrir sus necesidades.
                  -

                  Paquetes:

                  -
                  -
                  Hay muchos paquetes que añaden características de despliegue directamente en tu consola Symfony2.
                  -

                  Programación básica:

                  -
                  -
                  Puedes, por supuesto, usar el intérprete de ordenes, Ant, o cualquier otra herramienta para programar el despliegue de tu proyecto.
                  -

                  El ambiente como proveedor de servicios:

                  -
                  -
                  PaaS es una forma relativamente nueva para desplegar tu aplicación. Normalmente, un PaaS utilizará un único archivo de configuración en el directorio raíz de tu proyecto para determinar la forma de construir un ambiente al vuelo que apoye a tu software. -Un proveedor con el apoyo confirmado para Symfony2 es PagodaBox.
                  -
                  -

                  Truco

                  -

                  ¿Buscando más? Habla con la comunidad en el canal IRC de Symfony #symfony (en freenode) para más información.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/common_extensions.html b/cookbook/doctrine/common_extensions.html deleted file mode 100644 index dea0777..0000000 --- a/cookbook/doctrine/common_extensions.html +++ /dev/null @@ -1,143 +0,0 @@ - - - - - - - Cómo usar extensiones Doctrine: Timestampable, Sluggable, Translatable, etc. — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar extensiones Doctrine: Timestampable, Sluggable, Translatable, etc.

                  -

                  Doctrine2 es muy flexible, y la comunidad ya ha creado una serie de útiles extensiones Doctrine para ayudarte con las tareas habituales relacionadas con entidades.

                  -

                  Una biblioteca en particular —la biblioteca DoctrineExtensions— proporciona funcionalidad de integración con los comportamientos Sluggable, Translatable, Timestampable, Loggable, Tree y Sortable.

                  -

                  El uso de cada una de estas extensiones se explica en ese repositorio.

                  -

                  Sin embargo, para instalar/activar cada extensión debes registrar y activar un -escucha de eventos. -Para ello, tienes dos opciones:

                  -
                    -
                  1. Usar el StofDoctrineExtensionsBundle, que integra la biblioteca de arriba.
                    2. -
                  2. Implementar estos servicios directamente siguiendo la documentación para la integración con Symfony2: Instalando extensiones Gedmo de Doctrine2 en Symfony2
                    3. -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/custom_dql_functions.html b/cookbook/doctrine/custom_dql_functions.html deleted file mode 100644 index 76188e0..0000000 --- a/cookbook/doctrine/custom_dql_functions.html +++ /dev/null @@ -1,209 +0,0 @@ - - - - - - - Cómo registrar funciones DQL personalizadas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo registrar funciones DQL personalizadas

                  -

                  Doctrine te permite especificar funciones DQL personalizadas. Para más información sobre este tema, lee el artículo «Funciones DQL definidas por el usuario» de Doctrine.

                  -

                  En Symfony, puedes registrar tus funciones DQL personalizadas de la siguiente manera:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine:
-    orm:
-        # ...
-        entity_managers:
-            default:
-                # ...
-                dql:
-                    string_functions:
-                        test_string: Acme\HelloBundle\DQL\StringFunction
-                        second_string: Acme\HelloBundle\DQL\SecondStringFunction
-                    numeric_functions:
-                        test_numeric: Acme\HelloBundle\DQL\NumericFunction
-                    datetime_functions:
-                        test_datetime: Acme\HelloBundle\DQL\DatetimeFunction
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
-
-    <doctrine:config>
-        <doctrine:orm>
-            <!-- ... -->
-            <doctrine:entity-manager name="default">
-                <!-- ... -->
-                <doctrine:dql>
-                    <doctrine:string-function name="test_string>Acme\HelloBundle\DQL\StringFunction</doctrine:string-function>
-                    <doctrine:string-function name="second_string>Acme\HelloBundle\DQL\SecondStringFunction</doctrine:string-function>
-                    <doctrine:numeric-function name="test_numeric>Acme\HelloBundle\DQL\NumericFunction</doctrine:numeric-function>
-                    <doctrine:datetime-function name="test_datetime>Acme\HelloBundle\DQL\DatetimeFunction</doctrine:datetime-function>
-                </doctrine:dql>
-            </doctrine:entity-manager>
-        </doctrine:orm>
-    </doctrine:config>
-</container>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('doctrine', array(
-    'orm' => array(
-        // ...
-
-        'entity_managers' => array(
-            'default' => array(
-                // ...
-
-                'dql' => array(
-                    'string_functions' => array(
-                        'test_string'   => 'Acme\HelloBundle\DQL\StringFunction',
-                        'second_string' => 'Acme\HelloBundle\DQL\SecondStringFunction',
-                    ),
-                    'numeric_functions' => array(
-                        'test_numeric' => 'Acme\HelloBundle\DQL\NumericFunction',
-                    ),
-                    'datetime_functions' => array(
-                        'test_datetime' => 'Acme\HelloBundle\DQL\DatetimeFunction',
-                    ),
-                ),
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/dbal.html b/cookbook/doctrine/dbal.html deleted file mode 100644 index bd521e2..0000000 --- a/cookbook/doctrine/dbal.html +++ /dev/null @@ -1,297 +0,0 @@ - - - - - - - Cómo utiliza Doctrine la capa DBAL — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utiliza Doctrine la capa DBAL

                  -
                  -

                  Nota

                  -

                  Este artículo es sobre la capa DBAL de Doctrine. Normalmente, vas a trabajar con el nivel superior de la capa ORM de Doctrine, la cual simplemente utiliza DBAL detrás del escenario para comunicarse realmente con la base de datos. Para leer más sobre el ORM de Doctrine, consulta «Bases de datos y Doctrine».

                  -
                  -

                  Doctrine la capa de abstracción de base de datos (DataBase Abstraction Layer — DBAL) es una capa que se encuentra en la parte superior de PDO y ofrece una API intuitiva y flexible para comunicarse con las bases de datos relacionales más populares. En otras palabras, la biblioteca DBAL facilita la ejecución de consultas y realización de otras acciones de base de datos.

                  -
                  -

                  Truco

                  -

                  Lee la documentación oficial de DBAL para conocer todos los detalles y las habilidades de la biblioteca DBAL de Doctrine.

                  -
                  -

                  Para empezar, configura los parámetros de conexión a la base de datos:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine:
-    dbal:
-        driver:   pdo_mysql
-        dbname:   Symfony2
-        user:     root
-        password: null
-        charset:  UTF8
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<doctrine:config>
-    <doctrine:dbal
-        name="default"
-        dbname="Symfony2"
-        user="root"
-        password="null"
-        driver="pdo_mysql"
-    />
-</doctrine:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'driver'    => 'pdo_mysql',
-        'dbname'    => 'Symfony2',
-        'user'      => 'root',
-        'password'  => null,
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Para ver todas las opciones de configuración DBAL, consulta Configurando DBAL de Doctrine.

                  -

                  A continuación, puedes acceder a la conexión Doctrine DBAL accediendo al servicio database_connection:

                  -
                  class UserController extends Controller
-{
-    public function indexAction()
-    {
-        $conn = $this->get('database_connection');
-        $users = $conn->fetchAll('SELECT * FROM users');
-
-        // ...
-    }
-}
-
                  -
                  -
                  -

                  Registrando tipos de asignación personalizados

                  -

                  Puedes registrar tipos de asignación personalizados a través de la configuración de Symfony. Ellos se sumarán a todas las conexiones configuradas. Para más información sobre los tipos de asignación personalizados, lee la sección Tipos de asignación personalizados de la documentación de Doctrine.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine:
-    dbal:
-        types:
-            custom_first: Acme\HelloBundle\Type\CustomFirst
-            custom_second: Acme\HelloBundle\Type\CustomSecond
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
-
-    <doctrine:config>
-        <doctrine:dbal>
-            <doctrine:type name="custom_first" class="Acme\HelloBundle\Type\CustomFirst" />
-            <doctrine:type name="custom_second" class="Acme\HelloBundle\Type\CustomSecond" />
-        </doctrine:dbal>
-    </doctrine:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'types' => array(
-            'custom_first'  => 'Acme\HelloBundle\Type\CustomFirst',
-            'custom_second' => 'Acme\HelloBundle\Type\CustomSecond',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Registrando tipos de asignación personalizados en SchemaTool

                  -

                  La SchemaTool se utiliza al inspeccionar la base de datos para comparar el esquema. Para lograr esta tarea, es necesario saber qué tipo de asignación se debe utilizar para cada tipo de la base de datos. Por medio de la configuración puedes registrar nuevos tipos.

                  -

                  Vamos a asociar el tipo ENUM (por omisión no apoyado por DBAL) al tipo string:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine:
-    dbal:
-        connections:
-            default:
-                // otros parámetros de conexión
-                mapping_types:
-                    enum: string
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
-
-    <doctrine:config>
-        <doctrine:dbal>
-        <doctrine:dbal default-connection="default">
-            <doctrine:connection>
-                <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
-            </doctrine:connection>
-        </doctrine:dbal>
-    </doctrine:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'connections' => array(
-            'default' => array(
-                'mapping_types' => array(
-                    'enum'  => 'string',
-                ),
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/event_listeners_subscribers.html b/cookbook/doctrine/event_listeners_subscribers.html deleted file mode 100644 index e015b0d..0000000 --- a/cookbook/doctrine/event_listeners_subscribers.html +++ /dev/null @@ -1,319 +0,0 @@ - - - - - - - Cómo registrar escuchas y suscriptores de eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo registrar escuchas y suscriptores de eventos

                  -

                  Doctrine cuenta con un rico sistema de eventos que lanza eventos en casi todo lo que sucede dentro del sistema. Para ti, esto significa que puedes crear servicios arbitrarios y decirle a Doctrine que notifique a esos objetos cada vez que ocurra una determinada acción (por ejemplo, PrePersist) dentro de Doctrine. -Esto podría ser útil, por ejemplo, para crear un índice de búsqueda independiente cuando se guarde un objeto en tu base de datos.

                  -

                  Doctrine define dos tipos de objetos que pueden escuchar los eventos de Doctrine: -escuchas y suscriptores. Ambos son muy similares, pero los escuchas son un poco más sencillos. Para más información, consulta el Sistema de eventos en el sitio web de Doctrine.

                  -

                  The Doctrine website also explains all existing events that can be listened to.

                  -
                  -

                  Configurando escuchas/suscriptores

                  -

                  Para registrar un servicio para que actúe como un escucha o suscriptor de eventos sólo lo tienes que etiquetar con el nombre apropiado. Dependiendo de tu caso de uso, puedes enganchar un escucha en cada conexión DBAL y gestor de entidad ORM o simplemente en una conexión DBAL específica y todos los gestores de entidad que utilicen esta conexión.

                  -
                  -
                    -
                  • YAML
                    doctrine:
-    dbal:
-        default_connection: default
-        connections:
-            default:
-                driver: pdo_sqlite
-                memory: true
-
-services:
-    my.listener:
-        class: Acme\SearchBundle\EventListener\SearchIndexer
-        tags:
-                - { name: doctrine.event_listener, event: postPersist }
-    my.listener2:
-        class: Acme\SearchBundle\EventListener\SearchIndexer2
-        tags:
-                - { name: doctrine.event_listener, event: postPersist, connection: default }
-    my.subscriber:
-        class: Acme\SearchBundle\EventListener\SearchIndexerSubscriber
-        tags:
-                - { name: doctrine.event_subscriber, connection: default }
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" ?>
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:doctrine="http://symfony.com/schema/dic/doctrine">
-
-    <doctrine:config>
-        <doctrine:dbal default-connection="default">
-            <doctrine:connection driver="pdo_sqlite" memory="true" />
-        </doctrine:dbal>
-    </doctrine:config>
-
-        <services>
-        <service id="my.listener" class="Acme\SearchBundle\EventListener\SearchIndexer">
-            <tag name="doctrine.event_listener" event="postPersist" />
-        </service>
-        <service id="my.listener2" class="Acme\SearchBundle\EventListener\SearchIndexer2">
-            <tag name="doctrine.event_listener" event="postPersist" connection="default" />
-        </service>
-        <service id="my.subscriber" class="Acme\SearchBundle\EventListener\SearchIndexerSubscriber">
-            <tag name="doctrine.event_subscriber" connection="default" />
-        </service>
-        </services>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-
-$container->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'default_connection' => 'default',
-        'connections' => array(
-            'default' => array(
-                'driver' => 'pdo_sqlite',
-                'memory' => true,
-            ),
-        ),
-    ),
-));
-
-$container
-    ->setDefinition(
-        'my.listener',
-        new Definition('Acme\SearchBundle\EventListener\SearchIndexer')
-    )
-    ->addTag('doctrine.event_listener', array('event' => 'postPersist'))
-;
-$container
-    ->setDefinition(
-        'my.listener2',
-        new Definition('Acme\SearchBundle\EventListener\SearchIndexer2')
-    )
-    ->addTag('doctrine.event_listener', array('event' => 'postPersist', 'connection' => 'default'))
-;
-$container
-    ->setDefinition(
-        'my.subscriber',
-        new Definition('Acme\SearchBundle\EventListener\SearchIndexerSubscriber')
-    )
-    ->addTag('doctrine.event_subscriber', array('connection' => 'default'))
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Creando la clase Escucha

                  -

                  En el ejemplo anterior, se configuró un servicio my.listener como un escucha de Doctrine del evento postPersist. The class behind that service must have -a postPersist method, which will be called when the event is dispatched:

                  -
                  // src/Acme/SearchBundle/EventListener/SearchIndexer.php
-namespace Acme\SearchBundle\EventListener;
-
-use Doctrine\ORM\Event\LifecycleEventArgs;
-use Acme\StoreBundle\Entity\Product;
-
-class SearchIndexer
-{
-    public function postPersist(LifecycleEventArgs $args)
-    {
-        $entity = $args->getEntity();
-        $entityManager = $args->getEntityManager();
-
-        // tal vez sólo quieres actuar en alguna entidad "producto"
-        if ($entity instanceof Product) {
-            // ... haz algo con el Producto
-        }
-    }
-}
-
                  -
                  -

                  En cada caso, tienes acceso a un objeto LifecycleEventArgs, el cual te da acceso tanto al objeto entidad del evento como al mismo gestor de la entidad.

                  -

                  Una cosa importante a resaltar es que un escucha debe estar atento a todas las entidades en tu aplicación. So, if you’re interested in only handling a -specific type of entity (e.g. a Product entity but not a BlogPost -entity), you should check for the entity’s class type in your method -(as shown above).

                  -
                  -
                  -

                  Creating the Subscriber Class

                  -

                  A doctrine event subscriber must implement the Doctrine\Common\EventSubscriber -interface and have an event method for each event it subscribes to:

                  -
                  // src/Acme/SearchBundle/EventListener/SearchIndexerSubscriber.php
-namespace Acme\SearchBundle\EventListener;
-
-use Doctrine\Common\EventSubscriber;
-use Doctrine\ORM\Event\LifecycleEventArgs;
-// for doctrine 2.4: Doctrine\Common\Persistence\Event\LifecycleEventArgs;
-use Acme\StoreBundle\Entity\Product;
-
-class SearchIndexerSubscriber implements EventSubscriber
-{
-    public function getSubscribedEvents()
-    {
-        return array(
-            'postPersist',
-            'postUpdate',
-        );
-    }
-
-    public function postUpdate(LifecycleEventArgs $args)
-    {
-        $this->index($args);
-    }
-
-    public function postPersist(LifecycleEventArgs $args)
-    {
-        $this->index($args);
-    }
-
-    public function index(LifecycleEventArgs $args)
-    {
-        $entity = $args->getEntity();
-        $entityManager = $args->getEntityManager();
-
-        // tal vez sólo quieres actuar en alguna entidad "producto"
-        if ($entity instanceof Product) {
-            // ... haz algo con el Producto
-        }
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Doctrine event subscribers can not return a flexible array of methods to -call for the events like the Symfony event subscriber -can. Doctrine event subscribers must return a simple array of the event -names they subscribe to. Doctrine will then expect methods on the subscriber -with the same name as each subscribed event, just as when using an event listener.

                  -
                  -

                  For a full reference, see chapter `The Event System`_ in the Doctrine documentation.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/file_uploads.html b/cookbook/doctrine/file_uploads.html deleted file mode 100644 index 6d2208f..0000000 --- a/cookbook/doctrine/file_uploads.html +++ /dev/null @@ -1,639 +0,0 @@ - - - - - - - Cómo manejar archivos subidos con Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo manejar archivos subidos con Doctrine

                  -

                  Manejar el envío de archivos con entidades Doctrine no es diferente a la manipulación de cualquier otra carga de archivo. En otras palabras, eres libre de mover el archivo en tu controlador después de manipular el envío de un formulario. Para ver ejemplos de cómo hacerlo, consulta el Tipo de campo file en la referencia.

                  -

                  Si lo deseas, también puedes integrar la carga de archivos en el ciclo de vida de tu entidad (es decir, creación, actualización y eliminación). En este caso, ya que tu entidad es creada, actualizada y eliminada desde Doctrine, el proceso de carga y remoción de archivos se llevará a cabo de forma automática (sin necesidad de hacer nada en el controlador);

                  -

                  Para que esto funcione, tendrás que hacerte cargo de una serie de detalles, los cuales serán cubiertos en este artículo del recetario.

                  -
                  -

                  Configuración básica

                  -

                  En primer lugar, crea una sencilla clase Entidad de Doctrine con la cual trabajar:

                  -
                  // src/Acme/DemoBundle/Entity/Document.php
-namespace Acme\DemoBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-use Symfony\Component\Validator\Constraints as Assert;
-
-/**
- * @ORM\Entity
- */
-class Document
-{
-    /**
-     * @ORM\Id
-     * @ORM\Column(type="integer")
-     * @ORM\GeneratedValue(strategy="AUTO")
-     */
-    public $id;
-
-    /**
-     * @ORM\Column(type="string", length=255)
-     * @Assert\NotBlank
-     */
-    public $name;
-
-    /**
-     * @ORM\Column(type="string", length=255, nullable=true)
-     */
-    public $path;
-
-    public function getAbsolutePath()
-    {
-        return null === $this->path
-            ? null
-            : $this->getUploadRootDir().'/'.$this->path;
-    }
-
-    public function getWebPath()
-    {
-        return null === $this->path
-            ? null
-            : $this->getUploadDir().'/'.$this->path;
-    }
-
-    protected function getUploadRootDir()
-    {
-        // la ruta absoluta del directorio donde se deben
-        // guardar los archivos cargados
-        return __DIR__.'/../../../../web/'.$this->getUploadDir();
-    }
-
-    protected function getUploadDir()
-    {
-        // se deshace del __DIR__ para no meter la pata
-        // al mostrar el documento/imagen cargada en la vista.
-        return 'uploads/documents';
-    }
-}
-
                  -
                  -

                  La entidad Documento tiene un nombre y está asociado con un archivo. La propiedad ruta almacena la ruta relativa al archivo y se persiste en la base de datos. -El getAbsolutePath() es un método útil que devuelve la ruta absoluta al archivo, mientras que getWebPath() es un conveniente método que devuelve la ruta web, la cual se utiliza en una plantilla para enlazar el archivo cargado.

                  -
                  -

                  Truco

                  -

                  Si no lo has hecho, probablemente primero deberías leer el tipo archivo en la documentación para comprender cómo trabaja el proceso de carga básico.

                  -
                  -
                  -

                  Nota

                  -

                  Si estás utilizando anotaciones para especificar tus reglas de validación (como muestra este ejemplo), asegúrate de que has habilitado la validación por medio de anotaciones (consulta configurando la validación).

                  -
                  -

                  Para manejar el archivo real subido en el formulario, utiliza un campo file «virtual». -Por ejemplo, si estás construyendo tu formulario directamente en un controlador, este podría tener el siguiente aspecto:

                  -
                  public function uploadAction()
-{
-    // ...
-
-    $form = $this->createFormBuilder($document)
-        ->add('name')
-        ->add('file')
-        ->getForm();
-
-    // ...
-}
-
                  -
                  -

                  A continuación, crea esta propiedad en tu clase Documento y agrega algunas reglas de validación:

                  -
                  use Symfony\Component\HttpFoundation\File\UploadedFile;
-
-// ...
-class Document
-{
-    /**
-     * @Assert\File(maxSize="6000000")
-     */
-    private $file;
-
-    /**
-     * Sets file.
-     *
-     * @param UploadedFile $file
-     */
-    public function setFile(UploadedFile $file = null)
-    {
-        $this->file = $file;
-    }
-
-    /**
-     * Get file.
-     *
-     * @return UploadedFile
-     */
-    public function getFile()
-    {
-        return $this->file;
-    }
-}
-
                  -
                  -
                  -
                    -
                  • YAML
                    # src/Acme/DemoBundle/Resources/config/validation.yml
-Acme\DemoBundle\Entity\Document:
-    properties:
-        file:
-            - File:
-                maxSize: 6000000
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/DemoBundle/Entity/Document.php
-namespace Acme\DemoBundle\Entity;
-
-// ...
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Document
-{
-    /**
-     * @Assert\File(maxSize="6000000")
-     */
-    private $file;
-
-    // ...
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/DemoBundle/Resources/config/validation.yml -->
-<class name="Acme\DemoBundle\Entity\Document">
-    <property name="file">
-        <constraint name="File">
-            <option name="maxSize">6000000</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/DemoBundle/Entity/Document.php
-namespace Acme\DemoBundle\Entity;
-
-// ...
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Document
-{
-    // ...
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('file', new Assert\File(array(
-            'maxSize' => 6000000,
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Debido a que estás utilizando la restricción File, Symfony2 automáticamente supone que el campo del formulario es una entrada para cargar un archivo. Es por eso que no lo tienes que establecer explícitamente al crear el formulario anterior (->add('file')).

                  -
                  -

                  El siguiente controlador muestra cómo manipular todo el proceso:

                  -
                  // ...
-use Acme\DemoBundle\Entity\Document;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-// ...
-
-/**
- * @Template()
- */
-public function uploadAction()
-{
-    $document = new Document();
-    $form = $this->createFormBuilder($document)
-        ->add('name')
-        ->add('file')
-        ->getForm()
-    ;
-
-    if ($this->getRequest()->isMethod('POST')) {
-        $form->bind($this->getRequest());
-        if ($form->isValid()) {
-            $em = $this->getDoctrine()->getManager();
-
-            $em->persist($document);
-            $em->flush();
-
-            return $this->redirect($this->generateUrl(...));
-        }
-    }
-
-    return array('form' => $form->createView());
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Al escribir la plantilla, no olvides fijar el atributo enctype:

                  -
                  -
                    -
                  • Twig
                    <h1>Upload File</h1>
-
-<form action="#" method="post" {{ form_enctype(form) }}>
-    {{ form_widget(form) }}
-
-    <input type="submit" value="Upload Document" />
-</form>
-
                    -
                    -
                    • -
                  • PHP
                    <h1>Upload File</h1>
-
-<form action="#" method="post" <?php echo $view['form']->enctype($form) ?>>
-    <?php echo $view['form']->widget($form) ?>
-
-    <input type="submit" value="Upload Document" />
-</form>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  El controlador anterior automáticamente persistirá la entidad Documento con el nombre presentado, pero no hará nada sobre el archivo y la propiedad path quedará en blanco.

                  -

                  Una manera fácil de manejar la carga de archivos es que lo muevas justo antes de que se persista la entidad y a continuación, establece la propiedad path en consecuencia. Comienza por invocar a un nuevo método upload() en la clase Documento, el cual deberás crear en un momento para manejar la carga del archivo:

                  -
                  if ($form->isValid()) {
-    $em = $this->getDoctrine()->getManager();
-
-    $document->upload();
-
-    $em->persist($document);
-    $em->flush();
-
-    return $this->redirect(...);
-}
-
                  -
                  -

                  El método upload() tomará ventaja del objeto Symfony\Component\HttpFoundation\File\UploadedFile, el cual es lo que devuelve después de que se presenta un campo file:

                  -
                  public function upload()
-{
-    // the file property can be empty if the field is not required
-    if (null === $this->getFile()) {
-        return;
-    }
-
-    // aquí usa el nombre de archivo original pero lo debes
-    // sanear al menos para evitar cualquier problema de seguridad
-
-    // move takes the target directory and then the
-    // target filename to move to
-    $this->getFile()->move(
-        $this->getUploadRootDir(),
-        $this->getFile()->getClientOriginalName()
-    );
-
-    // set the path property to the filename where you've saved the file
-    $this->path = $this->getFile()->getClientOriginalName();
-
-    // limpia la propiedad «file» ya que no la necesitas más
-    $this->file = null;
-}
-
                  -
                  -
                  -
                  -

                  Usando el ciclo de vida de las retrollamadas

                  -

                  Incluso si esta implementación trabaja, sufre de un importante defecto: ¿Qué pasa si hay un problema al persistir la entidad? El archivo ya se ha movido a su ubicación final, incluso aunque la propiedad path de la entidad no se persista correctamente.

                  -

                  Para evitar estos problemas, debes cambiar la implementación para que la operación de base de datos y el traslado del archivo sean atómicos: si hay un problema al persistir la entidad o si el archivo no se puede mover, entonces, no debe suceder nada.

                  -

                  Para ello, es necesario mover el archivo justo cuando Doctrine persista la entidad a la base de datos. Esto se puede lograr enganchando el ciclo de vida de la entidad a una retrollamada:

                  -
                  /**
- * @ORM\Entity
- * @ORM\HasLifecycleCallbacks
- */
-class Document
-{
-}
-
                  -
                  -

                  A continuación, reconstruye la clase Documento para que tome ventaja de estas retrollamadas:

                  -
                  use Symfony\Component\HttpFoundation\File\UploadedFile;
-
-/**
- * @ORM\Entity
- * @ORM\HasLifecycleCallbacks
- */
-class Document
-{
-    private $temp;
-
-    /**
-     * Sets file.
-     *
-     * @param UploadedFile $file
-     */
-    public function setFile(UploadedFile $file = null)
-    {
-        $this->file = $file;
-        // check if we have an old image path
-        if (isset($this->path)) {
-            // store the old name to delete after the update
-            $this->temp = $this->path;
-            $this->path = null;
-        } else {
-            $this->path = 'initial';
-        }
-    }
-
-    /**
-     * @ORM\PrePersist()
-     * @ORM\PreUpdate()
-     */
-    public function preUpload()
-    {
-        if (null !== $this->getFile()) {
-            // haz lo que quieras para generar un nombre único
-            $filename = sha1(uniqid(mt_rand(), true));
-            $this->path = $filename.'.'.$this->getFile()->guessExtension();
-        }
-    }
-
-    /**
-     * @ORM\PostPersist()
-     * @ORM\PostUpdate()
-     */
-    public function upload()
-    {
-        if (null === $this->getFile()) {
-            return;
-        }
-
-        // si hay un error al mover el archivo, move() automáticamente
-        // envía una excepción. This will properly prevent
-        // the entity from being persisted to the database on error
-        $this->getFile()->move($this->getUploadRootDir(), $this->path);
-
-        // check if we have an old image
-        if (isset($this->temp)) {
-            // delete the old image
-            unlink($this->getUploadRootDir().'/'.$this->temp);
-            // clear the temp image path
-            $this->temp = null;
-        }
-        $this->file = null;
-    }
-
-    /**
-     * @ORM\PostRemove()
-     */
-    public function removeUpload()
-    {
-        if ($file = $this->getAbsolutePath()) {
-            unlink($file);
-        }
-    }
-}
-
                  -
                  -

                  La clase ahora hace todo lo que necesitas: genera un nombre de archivo único antes de persistirlo, mueve el archivo después de persistirlo y elimina el archivo si la entidad es eliminada.

                  -

                  Ahora que la entidad maneja automáticamente el movimiento del archivo, debes quitar del controlador la llamada a $document->upload():

                  -
                  if ($form->isValid()) {
-    $em = $this->getDoctrine()->getManager();
-
-    $em->persist($document);
-    $em->flush();
-
-    return $this->redirect(...);
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Los eventos retrollamados @ORM\PrePersist() y @ORM\PostPersist() se disparan antes y después de almacenar la entidad en la base de datos. Por otro lado, los eventos retrollamados @ORM\PreUpdate() y @ORM\PostUpdate() se llaman al actualizar la entidad.

                  -
                  -
                  -

                  Prudencia

                  -

                  Las retrollamadas PreUpdate y PostUpdate sólo se activan si se persiste algún cambio en uno de los campos de la entidad. Esto significa que, de manera predeterminada, si sólo modificas la propiedad $file, estos eventos no se activarán, puesto que esa propiedad no se persiste directamente a través de Doctrine. Una solución sería usar un campo actualizado que Doctrine persista, y modificarlo manualmente al cambiar el archivo.

                  -
                  -
                  -
                  -

                  Usando el id como nombre de archivo

                  -

                  Si deseas utilizar el id como el nombre del archivo, la implementación es un poco diferente conforme sea necesaria para guardar la extensión en la propiedad path, en lugar del nombre de archivo real:

                  -
                  use Symfony\Component\HttpFoundation\File\UploadedFile;
-
-/**
- * @ORM\Entity
- * @ORM\HasLifecycleCallbacks
- */
-class Document
-{
-    private $temp;
-
-    /**
-     * Sets file.
-     *
-     * @param UploadedFile $file
-     */
-    public function setFile(UploadedFile $file = null)
-    {
-        $this->file = $file;
-        // check if we have an old image path
-        if (is_file($this->getAbsolutePath())) {
-            // store the old name to delete after the update
-            $this->temp = $this->getAbsolutePath();
-        } else {
-            $this->path = 'initial';
-        }
-    }
-
-    /**
-     * @ORM\PrePersist()
-     * @ORM\PreUpdate()
-     */
-    public function preUpload()
-    {
-        if (null !== $this->getFile()) {
-            $this->path = $this->getFile()->guessExtension();
-        }
-    }
-
-    /**
-     * @ORM\PostPersist()
-     * @ORM\PostUpdate()
-     */
-    public function upload()
-    {
-        if (null === $this->getFile()) {
-            return;
-        }
-
-        // check if we have an old image
-        if (isset($this->temp)) {
-            // delete the old image
-            unlink($this->temp);
-            // clear the temp image path
-            $this->temp = null;
-        }
-
-        // you must throw an exception here if the file cannot be moved
-        // so that the entity is not persisted to the database
-        // which the UploadedFile move() method does
-        $this->getFile()->move(
-            $this->getUploadRootDir(),
-            $this->id.'.'.$this->getFile()->guessExtension()
-        );
-
-        $this->setFile(null);
-    }
-
-    /**
-     * @ORM\PreRemove()
-     */
-    public function storeFilenameForRemove()
-    {
-        $this->temp = $this->getAbsolutePath();
-    }
-
-    /**
-     * @ORM\PostRemove()
-     */
-    public function removeUpload()
-    {
-        if (isset($this->temp)) {
-            unlink($this->temp);
-        }
-    }
-
-    public function getAbsolutePath()
-    {
-        return null === $this->path
-            ? null
-            : $this->getUploadRootDir().'/'.$this->id.'.'.$this->path;
-    }
-}
-
                  -
                  -

                  Habrás notado en este caso que necesitas trabajar un poco más para poder eliminar el archivo. Antes de eliminarlo, debes almacenar la ruta del archivo (puesto que depende del id). Entonces, una vez que el objeto se ha eliminado completamente de la base de datos, puedes eliminar el archivo (en PostRemove).

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/index.html b/cookbook/doctrine/index.html deleted file mode 100644 index 0e642dc..0000000 --- a/cookbook/doctrine/index.html +++ /dev/null @@ -1,169 +0,0 @@ - - - - - - - Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/multiple_entity_managers.html b/cookbook/doctrine/multiple_entity_managers.html deleted file mode 100644 index 5b425a6..0000000 --- a/cookbook/doctrine/multiple_entity_managers.html +++ /dev/null @@ -1,336 +0,0 @@ - - - - - - - Cómo trabajar con múltiples gestores de entidad y conexiones — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo trabajar con múltiples gestores de entidad y conexiones

                  -

                  Puedes utilizar múltiples gestores de entidad de Doctrine o conexiones en una -aplicación Symfony2. Esto es necesario si estás utilizando diferentes bases de datos e incluso proveedores con conjuntos de entidades totalmente diferentes. En otras palabras, un gestor de entidad que se conecta a una base de datos deberá administrar algunas entidades, mientras que otro gestor de entidad conectado a otra base de datos puede manejar el resto.

                  -
                  -

                  Nota

                  -

                  Usar varios gestores de entidad es bastante fácil, pero más avanzado y generalmente no se requiere. Asegúrate de que realmente necesitas varios gestores de entidad antes de añadir complejidad a ese nivel.

                  -
                  -

                  El siguiente código de configuración muestra cómo puedes configurar dos gestores de entidad:

                  -
                  -
                    -
                  • YAML
                    doctrine:
-    dbal:
-        default_connection:   default
-        connections:
-            default:
-                driver:   "%database_driver%"
-                host:     "%database_host%"
-                port:     "%database_port%"
-                dbname:   "%database_name%"
-                user:     "%database_user%"
-                password: "%database_password%"
-                charset:  UTF8
-            customer:
-                driver:   "%database_driver2%"
-                host:     "%database_host2%"
-                port:     "%database_port2%"
-                dbname:   "%database_name2%"
-                user:     "%database_user2%"
-                password: "%database_password2%"
-                charset:  UTF8
-
-    orm:
-        default_entity_manager:   default
-        entity_managers:
-            default:
-                connection:       default
-                mappings:
-                    AcmeDemoBundle: ~
-                    AcmeStoreBundle: ~
-            customer:
-                connection:       customer
-                mappings:
-                    AcmeCustomerBundle: ~
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8"?>
-
-<srv:container xmlns="http://symfony.com/schema/dic/doctrine"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:srv="http://symfony.com/schema/dic/services"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
-
-    <config>
-        <dbal default-connection="default">
-            <connection name="default"
-                driver="%database_driver%"
-                host="%database_host%"
-                port="%database_port%"
-                dbname="%database_name%"
-                user="%database_user%"
-                password="%database_password%"
-                charset="UTF8"
-            />
-
-            <connection name="customer"
-                driver="%database_driver2%"
-                host="%database_host2%"
-                port="%database_port2%"
-                dbname="%database_name2%"
-                user="%database_user2%"
-                password="%database_password2%"
-                charset="UTF8"
-            />
-        </dbal>
-
-        <orm default-entity-manager="default">
-            <entity-manager name="default" connection="default">
-                <mapping name="AcmeDemoBundle" />
-                <mapping name="AcmeStoreBundle" />
-            </entity-manager>
-
-            <entity-manager name="customer" connection="customer">
-                <mapping name="AcmeCustomerBundle" />
-            </entity-manager>
-        </orm>
-    </config>
-</srv:container>
-
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('doctrine', array(
-    'dbal' => array(
-        'default_connection' => 'default',
-        'connections' => array(
-            'default' => array(
-                'driver'   => '%database_driver%',
-                'host'     => '%database_host%',
-                'port'     => '%database_port%',
-                'dbname'   => '%database_name%',
-                'user'     => '%database_user%',
-                'password' => '%database_password%',
-                'charset'  => 'UTF8',
-            ),
-            'customer' => array(
-                'driver'   => '%database_driver2%',
-                'host'     => '%database_host2%',
-                'port'     => '%database_port2%',
-                'dbname'   => '%database_name2%',
-                'user'     => '%database_user2%',
-                'password' => '%database_password2%',
-                'charset'  => 'UTF8',
-            ),
-        ),
-    ),
-
-    'orm' => array(
-        'default_entity_manager' => 'default',
-        'entity_managers' => array(
-            'default' => array(
-                'connection' => 'default',
-                'mappings'   => array(
-                    'AcmeDemoBundle'  => null,
-                    'AcmeStoreBundle' => null,
-                ),
-            ),
-            'customer' => array(
-                'connection' => 'customer',
-                'mappings'   => array(
-                    'AcmeCustomerBundle' => null,
-                ),
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  En este caso, hemos definido dos gestores de entidad y los llamamos default y customer. El gestor de entidad default administra cualquier entidad en los paquetes AcmeDemoBundle y AcmeStoreBundle, mientras que el gestor de entidad customer gestiona cualquiera en el paquete AcmeCustomerBundle. También definiste dos conexiones, una para cada gestor de entidad.

                  -
                  -

                  Nota

                  -

                  Cuando trabajas con múltiples conexiones y gestores de entidad, debes ser explícito sobre cual configuración deseas. Si omites el nombre de la conexión o gestor de entidad, se usa el predeterminado (es decir, default).

                  -
                  -

                  Cuando trabajes con múltiples conexiones para crear tu base de datos:

                  -
                  # Juega sólo con la conexión «default»
-$ php app/console doctrine:database:create
-
-# Juega sólo con la conexión «customer»
-$ php app/console doctrine:database:create --connection=customer
-
                  -
                  -

                  Cuándo trabajas múltiple gestores de entidad para actualizar tu esquema:

                  -
                  # Juega sólo con asociaciones «default»
-$ php app/console doctrine:schema:update --force
-
-# Juega sólo con asociaciones «customer»
-$ php app/console doctrine:schema:update --force --em=customer
-
                  -
                  -

                  Si omites el nombre del gestor de la entidad al consultar por él, se devuelve el gestor de entidad predeterminado (es decir, default):

                  -
                  class UserController extends Controller
-{
-    public function indexAction()
-    {
-        // ambos devuelven el gestor de entidad "predefinido"
-        $em = $this->get('doctrine')->getManager();
-        $em = $this->get('doctrine')->getManager('default');
-
-        $customerEm =  $this->get('doctrine')->getManager('customer');
-    }
-}
-
                  -
                  -

                  Ahora puedes utilizar Doctrine tal como lo hiciste antes — con el gestor de entidad default para persistir y recuperar las entidades que gestiona y el gestor de entidad customer para persistir y recuperar sus entidades.

                  -

                  Lo mismo aplica para llamadas al repositorio:

                  -
                  class UserController extends Controller
-{
-    public function indexAction()
-    {
-        // Recupera un repositorio gestionado por el em 'predefinido'
-        $products = $this->get('doctrine')
-                         ->getRepository('AcmeStoreBundle:Product')
-                         ->findAll()
-        ;
-
-        // La manera explícita para tratar con el em 'predefinido'
-        $products = $this->get('doctrine')
-                         ->getRepository('AcmeStoreBundle:Product',
-                               'default')
-                         ->findAll();
-
-        // Recupera un repositorio gestionado por el em 'customer'
-        $customers = $this->get('doctrine')
-                          ->getRepository('AcmeCustomerBundle:Customer',
-                                'customer')
-                          ->findAll()
-        ;
-    }
-}
-
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/registration_form.html b/cookbook/doctrine/registration_form.html deleted file mode 100644 index 4bdd9dc..0000000 --- a/cookbook/doctrine/registration_form.html +++ /dev/null @@ -1,387 +0,0 @@ - - - - - - - Cómo implementar un sencillo formulario de registro — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo implementar un sencillo formulario de registro

                  -

                  Algunos formularios tienen campos adicionales cuyos valores no se necesita almacenar en la base de datos. Por ejemplo, posiblemente quieras crear un formulario de inscripción con unos cuantos campos adicionales (como un campo de casilla de verificación «términos aceptados») e integrar en el formulario lo que realmente almacena la información de la cuenta.

                  -
                  -

                  El sencillo modelo de usuario

                  -

                  Tienes una sencilla entidad Usuario asignada a la base de datos:

                  -
                  // src/Acme/AccountBundle/Entity/User.php
-namespace Acme\AccountBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-use Symfony\Component\Validator\Constraints as Assert;
-use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
-
-/**
- * @ORM\Entity
- * @UniqueEntity(fields="email", message="Email already taken")
- */
-class User
-{
-    /**
-     * @ORM\Id
-     * @ORM\Column(type="integer")
-     * @ORM\GeneratedValue(strategy="AUTO")
-     */
-    protected $id;
-
-    /**
-     * @ORM\Column(type="string", length=255)
-     * @Assert\NotBlank()
-     * @Assert\Email()
-     */
-    protected $email;
-
-    /**
-     * @ORM\Column(type="string", length=255)
-     * @Assert\NotBlank()
-     */
-    protected $plainPassword;
-
-    public function getId()
-    {
-        return $this->id;
-    }
-
-    public function getEmail()
-    {
-        return $this->email;
-    }
-
-    public function setEmail($email)
-    {
-        $this->email = $email;
-    }
-
-    public function getPlainPassword()
-    {
-        return $this->plainPassword;
-    }
-
-    public function setPlainPassword($password)
-    {
-        $this->plainPassword = $password;
-    }
-}
-
                  -
                  -

                  Esta entidad Usuario contiene tres campos y dos de ellos (email y plainPassword) se deben mostrar en el formulario. La propiedad email debe ser única en la base de datos, esto se consigue añadiendo esta validación en la parte superior de la clase.

                  -
                  -

                  Nota

                  -

                  Si deseas integrar este Usuario en el sistema de seguridad, necesitas implementar la entidad UserInterface del componente de seguridad.

                  -
                  -
                  -
                  -

                  Creando un formulario para el modelo

                  -

                  A continuación, crea el formulario para el modelo Usuario:

                  -
                  // src/Acme/AccountBundle/Form/Type/UserType.php
-namespace Acme\AccountBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class UserType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('email', 'email');
-        $builder->add('plainPassword', 'repeated', array(
-           'first_name'  => 'password',
-           'second_name' => 'confirm',
-           'type'        => 'password',
-        ));
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'data_class' => 'Acme\AccountBundle\Entity\User'
-        ));
-    }
-
-    public function getName()
-    {
-        return 'user';
-    }
-}
-
                  -
                  -

                  Sólo hay dos campos: email y plainPassword (repetido para confirmar la contraseña introducida). La opción data_class le dice al formulario el nombre de la clase datos (es decir, la entidad usuario).

                  -
                  -

                  Truco

                  -

                  Para explorar más cosas sobre el componente formulario, consulta Formularios en el libro.

                  -
                  -
                  -
                  -

                  Incorporando el formulario del usuario en un formulario de inscripción

                  -

                  El formulario que vamos a usar para la página de registro no es el mismo que el -formulario para simplemente modificar al usuario (es decir, UserType). El formulario de inscripción contendrá otros campos, como «Acepto los términos», cuyo valor no se almacena en la base de datos.

                  -

                  Comienza creando una simple clase que represente la «inscripción»:

                  -
                  // src/Acme/AccountBundle/Form/Model/Registration.php
-namespace Acme\AccountBundle\Form\Model;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-use Acme\AccountBundle\Entity\User;
-
-class Registration
-{
-    /**
-     * @Assert\Type(type="Acme\AccountBundle\Entity\User")
-     * @Assert\Valid()
-     */
-    protected $user;
-
-    /**
-     * @Assert\NotBlank()
-     * @Assert\True()
-     */
-    protected $termsAccepted;
-
-    public function setUser(User $user)
-    {
-        $this->user = $user;
-    }
-
-    public function getUser()
-    {
-        return $this->user;
-    }
-
-    public function getTermsAccepted()
-    {
-        return $this->termsAccepted;
-    }
-
-    public function setTermsAccepted($termsAccepted)
-    {
-        $this->termsAccepted = (Boolean) $termsAccepted;
-    }
-}
-
                  -
                  -

                  Luego, crea el formulario para este modelo Registration:

                  -
                  // src/Acme/AccountBundle/Form/Type/RegistrationType.php
-namespace Acme\AccountBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-
-class RegistrationType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('user', new UserType());
-        $builder->add(
-            'terms',
-            'checkbox',
-            array('property_path' => 'termsAccepted')
-        );
-    }
-
-    public function getName()
-    {
-        return 'registration';
-    }
-}
-
                  -
                  -

                  No es necesario utilizar el método especial para incorporar el formulario UserType. -Un formulario es un campo, también — así que lo puedes agregar como cualquier otro campo, con la expectativa de que la propiedad Registration.user mantendrá una instancia de la clase usuario.

                  -
                  -
                  -

                  Manejando el envío del formulario

                  -

                  Después, necesitas un controlador para manejar el formulario. Comienza creando un simple controlador para mostrar el formulario de inscripción:

                  -
                  // src/Acme/AccountBundle/Controller/AccountController.php
-namespace Acme\AccountBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Symfony\Component\HttpFoundation\Response;
-
-use Acme\AccountBundle\Form\Type\RegistrationType;
-use Acme\AccountBundle\Form\Model\Registration;
-
-class AccountController extends Controller
-{
-    public function registerAction()
-    {
-        $form = $this->createForm(
-            new RegistrationType(),
-            new Registration()
-        );
-
-        return $this->render(
-            'AcmeAccountBundle:Account:register.html.twig',
-            array('form' => $form->createView())
-        );
-    }
-}
-
                  -
                  -

                  y su plantilla:

                  -
                  {# src/Acme/AccountBundle/Resources/views/Account/register.html.twig #}
-<form action="{{ path('create')}}" method="post" {{ form_enctype(form) }}>
-    {{ form_widget(form) }}
-
-    <input type="submit" />
-</form>
-
                  -
                  -

                  Finalmente, crea el controlador que maneja el envío del formulario. Esto llevará a cabo la validación y guardará los datos en la base de datos:

                  -
                  public function createAction()
-{
-    $em = $this->getDoctrine()->getEntityManager();
-
-    $form = $this->createForm(new RegistrationType(), new Registration());
-
-    $form->bind($this->getRequest());
-
-    if ($form->isValid()) {
-        $registration = $form->getData();
-
-        $em->persist($registration->getUser());
-        $em->flush();
-
-        return $this->redirect(...);
-    }
-
-    return $this->render(
-        'AcmeAccountBundle:Account:register.html.twig',
-        array('form' => $form->createView())
-    );
-}
-
                  -
                  -

                  ¡Eso es todo! Tu formulario ahora valida, y te permite guardar en la base de datos el objeto Usuario. La casilla de verificación adicional términos `` en la  clase ``Registration del modelo se utiliza durante la validación, pero en realidad no se utiliza más tarde, cuando se guarda al usuario en la base de datos.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/resolve_target_entity.html b/cookbook/doctrine/resolve_target_entity.html deleted file mode 100644 index 082eb0d..0000000 --- a/cookbook/doctrine/resolve_target_entity.html +++ /dev/null @@ -1,263 +0,0 @@ - - - - - - - Cómo definir relaciones con interfaces y clases abstractas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo definir relaciones con interfaces y clases abstractas

                  -

                  -Nuevo en la versión 2.1: El ResolveTargetEntityListener es nuevo para Doctrine 2.2, fue empacado por primera vez con Symfony 2.1.

                  -

                  Uno de los objetivos de los paquetes es la creación discreta de paquetes de funcionalidad que no tienen muchas dependencias (o ninguna, en su caso), lo cual te permite utilizar esa funcionalidad en otras aplicaciones sin incluir elementos innecesarios.

                  -

                  Doctrine 2.2 incluye una nueva utilidad llamada ResolveTargetEntityListener, con la cual las funciones interceptan llamadas dentro de Doctrine y reescriben los parámetros targetEntity en tu correlación de metadatos en tiempo de ejecución. Esto significa que en tu paquete eres capaz de utilizar una interfaz o una clase abstracta en tus asignaciones y esperar una correcta correlación en una entidad concreta en tiempo de ejecución.

                  -

                  Esta funcionalidad te permite definir las relaciones entre diferentes entidades sin volverlas dependencias duras.

                  -
                  -

                  Antecedentes

                  -

                  Supongamos que tienes un InvoiceBundle que proporciona la funcionalidad de facturación y un CustomerBundle que contiene herramientas para la gestión de clientes. Los quieres mantener separados, ya que se pueden utilizar en otros sistemas el uno sin el otro, pero para tu aplicación deseas usarlos juntos.

                  -

                  En este caso, tiene una entidad factura (Invoice) con una relación a un objeto inexistente, un InvoiceSubjectInterface. El objetivo es conseguir que el ResolveTargetEntityListener reemplace cualquier mención a la interfaz con un objeto real que implemente esa interfaz.

                  -
                  -
                  -

                  Configurando

                  -

                  Vamos a usar las siguientes entidades básicas (incompletas por razones de brevedad) para explicar cómo configurar y utilizar el ResolveTargetEntityListener.

                  -

                  Una entidad Cliente:

                  -
                  // src/Acme/AppBundle/Entity/Customer.php
-
-namespace Acme\AppBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-use Acme\CustomerBundle\Entity\Customer as BaseCustomer;
-use Acme\InvoiceBundle\Model\InvoiceSubjectInterface;
-
-/**
- * @ORM\Entity
- * @ORM\Table(name="customer")
- */
-class Customer extends BaseCustomer implements InvoiceSubjectInterface
-{
-    // En nuestro ejemplo, todos los métodos definidos en la
-    // InvoiceSubjectInterface ya están implementados en
-    // BaseCustomer
-
                  -
                  -

                  La entidad Factura:

                  -
                  // src/Acme/InvoiceBundle/Entity/Invoice.php
-
-namespace Acme\InvoiceBundle\Entity;
-
-use Doctrine\ORM\Mapping AS ORM;
-use Acme\InvoiceBundle\Model\InvoiceSubjectInterface;
-
-/**
- * Representa una ``Factura``.
- *
- * @ORM\Entity
- * @ORM\Table(name="invoice")
- */
-class Invoice
-{
-    /**
-     * @ORM\ManyToOne(targetEntity="Acme\InvoiceBundle\Model\InvoiceSubjectInterface")
-     * @var InvoiceSubjectInterface
-     */
-    protected $subject;
-}
-
                  -
                  -

                  Una InvoiceSubjectInterface:

                  -
                  // src/Acme/InvoiceBundle/Model/InvoiceSubjectInterface.php
-
-namespace Acme\InvoiceBundle\Model;
-
-/**
- * Una interfaz que debe implementar el objeto súbdito de la factura.
- * En la mayoría de los casos, un único objeto debe implementar esta
- * interfaz puesto que ResolveTargetEntityListener sólo puede
- * cambiar el destino a un único objeto.
- */
-interface InvoiceSubjectInterface
-{
-    // Enumera los métodos adicionales que necesita tu InvoiceBundle
-    // para acceder al súbdito para que puedas garantizar
-    // que tienes acceso a esos métodos.
-
-    /**
-     * @return string
-     */
-    public function getName();
-}
-
                  -
                  -

                  A continuación, tienes que configurar el escucha, el cual informa a DoctrineBundle acerca de la sustitución:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-doctrine:
-    # ....
-    orm:
-        # ....
-        resolve_target_entities:
-            Acme\InvoiceBundle\Model\InvoiceSubjectInterface: Acme\AppBundle\Entity\Customer
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
-
-    <doctrine:config>
-        <doctrine:orm>
-            <!-- ... -->
-            <doctrine:resolve-target-entity interface="Acme\InvoiceBundle\Model\InvoiceSubjectInterface">Acme\AppBundle\Entity\Customer</resolve-target-entity>
-        </doctrine:orm>
-    </doctrine:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('doctrine', array(
-    'orm' => array(
-        // ...
-        'resolve_target_entities' => array(
-            'Acme\InvoiceBundle\Model\InvoiceSubjectInterface' => 'Acme\AppBundle\Entity\Customer',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Consideraciones finales

                  -

                  Con el ResolveTargetEntityListener, puedes separar tus paquetes, y siguen siendo útiles por sí mismos, pero aún así capaces de definir relaciones entre diferentes objetos. Usando este método, los paquetes terminan siendo más fáciles de mantener de manera independiente.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/doctrine/reverse_engineering.html b/cookbook/doctrine/reverse_engineering.html deleted file mode 100644 index defb756..0000000 --- a/cookbook/doctrine/reverse_engineering.html +++ /dev/null @@ -1,257 +0,0 @@ - - - - - - - Cómo generar entidades desde una base de datos existente — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo generar entidades desde una base de datos existente

                  -

                  Cuando empiezas a trabajar en el proyecto de una nueva marca que utiliza una base de datos, es algo natural que sean dos situaciones diferentes. En la mayoría de los casos, el modelo de base de datos se diseña y construye desde cero. A veces, sin embargo, comenzarás con un modelo de base de datos existente y probablemente inmutable. Afortunadamente, Doctrine viene con un montón de herramientas para ayudarte a generar las clases del modelo desde tu base de datos existente.

                  -
                  -

                  Nota

                  -

                  Como dicen las herramientas de documentación de Doctrine, la ingeniería inversa es un proceso de una sola vez para empezar a trabajar en un proyecto. Doctrine es capaz de convertir aproximadamente el 70-80% de la información asignada basándose en los campos, índices y restricciones de clave externa. Doctrine no puede descubrir asociaciones inversas, tipos de herencia, entidades con claves externas como claves principales u operaciones semánticas en asociaciones tales como eventos en cascada o ciclo de vida de los eventos. Posteriormente, será necesario algún trabajo adicional sobre las entidades generadas para diseñar cada una según tus características específicas del modelo de dominio.

                  -
                  -

                  Esta guía asume que estás usando una sencilla aplicación de blog con las siguientes dos tablas: blog_post y blog_comment. Un registro de comentarios está vinculado a un registro de comentario gracias a una restricción de clave externa.

                  -
                  CREATE TABLE `blog_post` (
-  `id` bigint(20) NOT NULL AUTO_INCREMENT,
-  `title` varchar(100) COLLATE utf8_unicode_ci NOT NULL,
-  `content` longtext COLLATE utf8_unicode_ci NOT NULL,
-  `created_at` datetime NOT NULL,
-  PRIMARY KEY (`id`)
-) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
-
-CREATE TABLE `blog_comment` (
-  `id` bigint(20) NOT NULL AUTO_INCREMENT,
-  `post_id` bigint(20) NOT NULL,
-  `autor` varchar(20) COLLATE utf8_unicode_ci NOT NULL,
-  `contenido` longtext COLLATE utf8_unicode_ci NOT NULL,
-  `creado_at` datetime NOT NULL,
-  PRIMARY KEY (`id`),
-  KEY `blog_comment_post_id_idx` (`post_id`),
-  CONSTRAINT `blog_post_id` FOREIGN KEY (`post_id`) REFERENCES `blog_post` (`id`) ON DELETE CASCADE
-) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8 COLLATE=utf8_unicode_ci;
-
                  -
                  -

                  Antes de zambullirte en la receta, asegúrate de que los parámetros de conexión de tu base de datos están configurados correctamente en el archivo app/config/parameters.yml (o cualquier otro lugar donde mantienes la configuración de base de datos) y que has iniciado un paquete que será la sede de tu futura clase entidad. Esta guía supone que existe un AcmeBlogBundle y está localizado bajo el directorio src/Acme/BlogBundle.

                  -

                  El primer paso para crear las clases de la entidad en una base de datos existente es pedir a Doctrine que introspeccione la base de datos y genere los archivos de metadatos correspondientes. Los archivos de metadatos describen la clase de la entidad para generar tablas basándose en los campos.

                  -
                  $ php app/console doctrine:mapping:convert xml ./src/Acme/BlogBundle/Resources/config/doctrine/metadata/orm --from-database --force
-
                  -
                  -

                  Esta herramienta de línea de ordenes le pide a Doctrine que inspeccione la estructura de la base de datos y genere los archivos XML de metadatos bajo el directorio src/Acme/BlogBundle/Resources/config/doctrine/metadata/orm de tu paquete.

                  -
                  -

                  Truco

                  -

                  También es posible generar los metadatos de clase en formato YAML cambiando el primer argumento a yml.

                  -
                  -

                  El archivo de metadatos generado BlogPost.dcm.xml es el siguiente:

                  -
                  <?xml version="1.0" encoding="utf-8"?>
-<doctrine-mapping>
-  <entity name="BlogPost" table="blog_post">
-    <change-tracking-policy>DEFERRED_IMPLICIT</change-tracking-policy>
-    <id name="id" type="bigint" column="id">
-      <generator strategy="IDENTITY"/>
-    </id>
-    <field name="title" type="string" column="title" length="100"/>
-    <field name="content" type="text" column="content"/>
-    <field name="isPublished" type="boolean" column="is_published"/>
-    <field name="createdAt" type="datetime" column="created_at"/>
-    <field name="updatedAt" type="datetime" column="updated_at"/>
-    <field name="slug" type="string" column="slug" length="255"/>
-    <lifecycle-callbacks/>
-  </entity>
-</doctrine-mapping>
-
                  -
                  -
                  -

                  Nota

                  -

                  Si tienes relaciones UnoAMuchos entre tus entidades, necesitarás editar los archivos xml o yml generados para añadir una sección en las entidades específicas UnoAMuchos definiendo las piezas inversedBy y mappedBy.

                  -
                  -

                  Una vez generados los archivos de metadatos, puedes pedir a Doctrine que importe el esquema y construya las clases relacionadas con la entidad, ejecutando las dos siguientes ordenes.

                  -
                  $ php app/console doctrine:mapping:import AcmeBlogBundle annotation
-$ php app/console doctrine:generate:entities AcmeBlogBundle
-
                  -
                  -

                  La primer orden genera las clases de entidad con una asignación de anotaciones, pero por supuesto puedes cambiar el argumento annotation a xml o yml. -La clase entidad BlogComment recién creada se ve de la siguiente manera:

                  -
                  <?php
-
-// src/Acme/BlogBundle/Entity/BlogComment.php
-namespace Acme\BlogBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-
-/**
- * Acme\BlogBundle\Entity\BlogComment
- *
- * @ORM\Table(name="blog_comment")
- * @ORM\Entity
- */
-class BlogComment
-{
-    /**
-     * @var bigint $id
-     *
-     * @ORM\Column(name="id", type="bigint", nullable=false)
-     * @ORM\Id
-     * @ORM\GeneratedValue(strategy="IDENTITY")
-     */
-    private $id;
-
-    /**
-     * @var string $author
-     *
-     * @ORM\Column(name="author", type="string", length=100, nullable=false)
-     */
-    private $author;
-
-    /**
-     * @var text $content
-     *
-     * @ORM\Column(name="content", type="text", nullable=false)
-     */
-    private $content;
-
-    /**
-     * @var datetime $createdAt
-     *
-     * @ORM\Column(name="created_at", type="datetime", nullable=false)
-     */
-    private $createdAt;
-
-    /**
-     * @var BlogPost
-     *
-     * @ORM\ManyToOne(targetEntity="BlogPost")
-     * @ORM\JoinColumn(name="post_id", referencedColumnName="id")
-     */
-    private $post;
-}
-
                  -
                  -

                  Como puedes ver, Doctrine convierte todos los campos de la tabla a propiedades privadas puras y anotaciones de clase. Lo más impresionante es que también descubriste la relación con la clase entidad BlogPost basándote en la restricción de la clave externa. -Por lo tanto, puedes encontrar una propiedad privada $post asignada a una entidad BlogPost en la clase entidad BlogComment.

                  -

                  La última orden genera todos los captadores y definidores de tus dos propiedades de la clase entidad BlogPost y BlogComment. Las entidades generadas ahora están listas para utilizarse. ¡Que te diviertas!

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/email/dev_environment.html b/cookbook/email/dev_environment.html deleted file mode 100644 index de075b4..0000000 --- a/cookbook/email/dev_environment.html +++ /dev/null @@ -1,270 +0,0 @@ - - - - - - - Cómo trabajar con correos electrónicos durante el desarrollo — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo trabajar con correos electrónicos durante el desarrollo

                  -

                  Cuando estás creando una aplicación que envía mensajes de correo electrónico, a menudo, mientras desarrollas, no quieres enviar realmente los correos electrónicos al destinatario especificado. Si estás utilizando el SwiftmailerBundle con Symfony2, puedes lograr fácilmente esto a través de ajustes de configuración sin tener que realizar ningún cambio en el código de tu aplicación en absoluto. Hay dos opciones principales cuando se trata de manejar correos electrónicos durante el desarrollo: (a) desactivar el envío de correos electrónicos por completo o (b) enviar todos los mensajes de correo electrónico a una dirección específica.

                  -
                  -

                  Desactivando el envío

                  -

                  Puedes desactivar el envío de correos electrónicos estableciendo la opción disable_delivery a true. Este es el predeterminado en el entorno test de la distribución estándar. Si haces esto en la configuración específica de test, los mensajes de correo electrónico no se enviarán cuando ejecutas las pruebas, pero se seguirán enviando en los entornos prod y dev:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_test.yml
-swiftmailer:
-    disable_delivery:  true
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_test.xml -->
-
-<!--
-    xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-    http://symfony.com/schema/dic/swiftmailer http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd
--->
-
-<swiftmailer:config
-    disable-delivery="true" />
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_test.php
-$container->loadFromExtension('swiftmailer', array(
-    'disable_delivery'  => "true",
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Si también deseas inhabilitar el envío en el entorno dev, sólo tienes que añadir esta misma configuración en el archivo config_dev.yml.

                  -
                  -
                  -

                  Enviando a una dirección específica

                  -

                  También puedes optar por hacer que todos los correos sean enviados a una dirección específica, en vez de la dirección real especificada cuando se envía el mensaje. Esto se puede conseguir a través de la opción delivery_address:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_dev.yml
-swiftmailer:
-    delivery_address:  dev@example.com
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_dev.xml -->
-
-<!--
-    xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-    http://symfony.com/schema/dic/swiftmailer http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd
--->
-
-<swiftmailer:config
-    delivery-address="dev@example.com" />
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_dev.php
-$container->loadFromExtension('swiftmailer', array(
-    'delivery_address'  => "dev@example.com",
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, supongamos que estás enviando un correo electrónico a recipient@example.com.

                  -
                  public function indexAction($name)
-{
-    $message = \Swift_Message::newInstance()
-        ->setSubject('Hello Email')
-        ->setFrom('send@example.com')
-        ->setTo('recipient@example.com')
-        ->setBody(
-            $this->renderView(
-                'HelloBundle:Hello:email.txt.twig',
-                array('name' => $name)
-            )
-        )
-    ;
-    $this->get('mailer')->send($message);
-
-    return $this->render(...);
-}
-
                  -
                  -

                  En el entorno dev, el correo electrónico será enviado a dev@example.com. -SwiftMailer añadirá una cabecera adicional al correo electrónico, X-Swift-To, conteniendo la dirección reemplazada, por lo tanto todavía serás capaz de ver qué se ha enviado.

                  -
                  -

                  Nota

                  -

                  Además de las direcciones para, también se detendrá el correo electrónico que se envíe a cualquier dirección CC y BCC establecida. SwiftMailer agregará encabezados adicionales al correo electrónico con la dirección reemplazada en ellos. -Estas son X-Swift-CC y X-Swift-CCO para las direcciones CC y BCC, respectivamente.

                  -
                  -
                  -
                  -

                  Visualizando desde la barra de depuración web

                  -

                  Puedes ver cualquier correo electrónico enviado por una respuesta cuando estás en el entorno dev usando la barra de depuración web. El icono de correo electrónico en la barra de herramientas mostrará cuántos correos electrónicos fueron enviados. Si haces clic en él, se abrirá un informe mostrando los detalles de los mensajes de correo electrónico enviados.

                  -

                  Si estás enviando un correo electrónico e inmediatamente rediriges a otra página, la barra de herramientas de depuración web no mostrará un icono de correo electrónico o un informe en la siguiente página.

                  -

                  En su lugar, puedes ajustar la opción intercept_redirects a true en el archivo config_dev.yml, lo cual provocará que la redirección se detenga y te permitirá abrir el informe con los detalles de los correos enviados.

                  -
                  -

                  Truco

                  -

                  Como alternativa, puedes abrir el perfilador después de la redirección y buscar la URL utilizada en la petición anterior (por ejemplo /contact/handle). -La característica de búsqueda del perfilador te permite cargar información del perfil de peticiones anteriores.

                  -
                  -
                  -
                    -
                  • YAML
                    # app/config/config_dev.yml
-web_profiler:
-    intercept_redirects: true
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_dev.xml -->
-
-<!--
-    xmlns:webprofiler="http://symfony.com/schema/dic/webprofiler"
-    xsi:schemaLocation="http://symfony.com/schema/dic/webprofiler
-    http://symfony.com/schema/dic/webprofiler/webprofiler-1.0.xsd">
--->
-
-<webprofiler:config
-    intercept-redirects="true"
-/>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_dev.php
-$container->loadFromExtension('web_profiler', array(
-    'intercept_redirects' => 'true',
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/email/email.html b/cookbook/email/email.html deleted file mode 100644 index 64f0704..0000000 --- a/cookbook/email/email.html +++ /dev/null @@ -1,250 +0,0 @@ - - - - - - - Cómo enviar correo electrónico — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo enviar correo electrónico

                  -

                  El envío de correo electrónico es una tarea clásica para cualquier aplicación web, y la cual tiene complicaciones especiales y peligros potenciales. En lugar de reinventar la rueda, una solución para enviar mensajes de correo electrónico es usando el SwiftmailerBundle, el cual aprovecha el poder de la biblioteca SwiftMailer.

                  -
                  -

                  Nota

                  -

                  No olvides activar el paquete en tu núcleo antes de usarlo:

                  -
                  public function registerBundles()
-{
-    $bundles = array(
-        // ...
-
-        new Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle(),
-    );
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Configurando

                  -

                  Antes de usar SwiftMailer, asegúrate de incluir su configuración. El único parámetro de configuración obligatorio es transport:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-swiftmailer:
-    transport:  smtp
-    encryption: ssl
-    auth_mode:  login
-    host:       smtp.gmail.com
-    username:   your_username
-    password:   your_password
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-
-<!--
-    xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-    http://symfony.com/schema/dic/swiftmailer http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd
--->
-
-<swiftmailer:config
-    transport="smtp"
-    encryption="ssl"
-    auth-mode="login"
-    host="smtp.gmail.com"
-    username="your_username"
-    password="your_password" />
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('swiftmailer', array(
-    'transport'  => "smtp",
-    'encryption' => "ssl",
-    'auth_mode'  => "login",
-    'host'       => "smtp.gmail.com",
-    'username'   => "your_username",
-    'password'   => "your_password",
-));
-
                    -
                    -
                    • -
                  -
                  -

                  La mayoría de los atributos de configuración de SwiftMailer tratan con la forma en que se deben entregar los mensajes.

                  -

                  Los atributos de configuración disponibles son los siguientes:

                  -
                    -
                  • transport (smtp, mail, sendmail o gmail)
                    • -
                  • username
                    • -
                  • password
                    • -
                  • host
                    • -
                  • port
                    • -
                  • encryption (tls, o ssl)
                    • -
                  • auth_mode (plain, login o cram-md5)
                    • -
                  • spool -
                    • -
                  • delivery_address (una dirección de correo electrónico de donde enviar todo el correo electrónico)
                    • -
                  • disable_delivery (true para desactivar la entrega por completo)
                    • -
                  -
                  -
                  -

                  Enviando correo electrónico

                  -

                  La biblioteca SwiftMailer trabaja creando, configurando y luego enviando objetos Swift_Message. El «mailer» es responsable de la entrega real del mensaje y es accesible a través del servicio mailer. En general, el envío de un correo electrónico es bastante sencillo:

                  -
                  public function indexAction($name)
-{
-    $message = \Swift_Message::newInstance()
-        ->setSubject('Hello Email')
-        ->setFrom('send@example.com')
-        ->setTo('recipient@example.com')
-        ->setBody(
-            $this->renderView(
-                'HelloBundle:Hello:email.txt.twig',
-                array('name' => $name)
-            )
-        )
-    ;
-    $this->get('mailer')->send($message);
-
-    return $this->render(...);
-}
-
                  -
                  -

                  Para mantener las cosas disociadas, el cuerpo del correo electrónico se ha almacenado en una plantilla y reproducido con el método RenderView().

                  -

                  El objeto $message admite muchas más opciones, como incluir archivos adjuntos, agregar contenido HTML, y mucho más. Afortunadamente, SwiftMailer cubre el tema con gran detalle en Creando mensajes de su documentación.

                  -
                  -

                  Truco

                  -

                  Hay disponibles varios artículos en el recetario relacionados con el envío de mensajes de correo electrónico en Symfony2:

                  - -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/email/gmail.html b/cookbook/email/gmail.html deleted file mode 100644 index af21de1..0000000 --- a/cookbook/email/gmail.html +++ /dev/null @@ -1,192 +0,0 @@ - - - - - - - Cómo utilizar Gmail para enviar mensajes de correo electrónico — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar Gmail para enviar mensajes de correo electrónico

                  -

                  Durante el desarrollo, en lugar de utilizar un servidor SMTP regular para enviar mensajes de correo electrónico, verás que es más fácil y más práctico utilizar Gmail. El paquete SwiftMailer hace que esto sea muy fácil.

                  -
                  -

                  Truco

                  -

                  En lugar de utilizar tu cuenta normal de Gmail, por supuesto, recomendamos crear una cuenta especial.

                  -
                  -

                  En el archivo de configuración de desarrollo, cambia el ajuste transport a gmail y establece el username y password a las credenciales de Google:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_dev.yml
-swiftmailer:
-    transport: gmail
-    username:  tu_nombre_de_usuario_gmail
-    password:  tu_contraseña_gmail
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_dev.xml -->
-
-<!--
-    xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-    http://symfony.com/schema/dic/swiftmailer http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd
--->
-
-<swiftmailer:config
-    transport="gmail"
-    username="tu_nombre_de_usuario_gmail"
-    password="tu_contraseña_gmail" />
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_dev.php
-$container->loadFromExtension('swiftmailer', array(
-    'transport' => "gmail",
-    'username'  => "tu_nombre_de_usuario_gmail",
-    'password'  => "tu_contraseña_gmail",
-));
-
                    -
                    -
                    • -
                  -
                  -

                  ¡Ya está!

                  -
                  -

                  Truco

                  -

                  Si estás usando la edición estándar de Symfony, configura los parámetros en tu archivo parameters.yml

                  -
                  # app/config/parameters.yml
-parameters:
-    ...
-    mailer_transport: gmail
-    mailer_host:      ~
-    mailer_user:      tu_nombre_de_usuario_gmail
-    mailer_password:  tu_contraseña_gmail
-
                  -
                  -
                  -
                  -

                  Nota

                  -

                  El transporte gmail simplemente es un acceso directo que utiliza el transporte smtp y establece encryption, auth_mode y host para trabajar con Gmail.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/email/index.html b/cookbook/email/index.html deleted file mode 100644 index 2948fa5..0000000 --- a/cookbook/email/index.html +++ /dev/null @@ -1,153 +0,0 @@ - - - - - - - Email — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/email/spool.html b/cookbook/email/spool.html deleted file mode 100644 index 45c3216..0000000 --- a/cookbook/email/spool.html +++ /dev/null @@ -1,235 +0,0 @@ - - - - - - - Cómo formar en la cola mensajes de correo electrónico — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo formar en la cola mensajes de correo electrónico

                  -

                  Cuando estás utilizando el SwiftmailerBundle para enviar correo electrónico desde una aplicación Symfony2, de manera predeterminada el mensaje será enviado inmediatamente. Sin embargo, posiblemente quieras evitar el impacto en el rendimiento de la comunicación entre SwiftMailer y el transporte de correo electrónico, lo cual podría hacer que el usuario tuviera que esperar la carga de la siguiente página mientras que se envía el correo electrónico. Puedes evitar todo esto eligiendo «spool», para formar los mensajes en la cola de correo en lugar de enviarlos directamente. Esto significa que SwiftMailer no intentará enviar el correo electrónico, sino que guardará el mensaje en alguna parte, tal como un archivo. Otro proceso puede leer la cola y hacerse cargo de enviar los correos que están organizados en la cola. Actualmente sólo la organización en archivos o memoria es compatible con Swiftmailer.

                  -
                  -

                  Organizar usando la memoria

                  -

                  Cuándo organizas almacenando los mensajes de correo electrónico en memoria, conseguirás enviarlos antes de que el núcleo termine. Esto significa que el mensaje de correo será enviado si la petición entera se ejecutó sin excepción no controladas o algún error. Para configurar swiftmailer con la opción de memoria, usa la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-swiftmailer:
-    # ...
-    spool: { type: memory }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-
-<!--
-    xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-    http://symfony.com/schema/dic/swiftmailer http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd
--->
-
-<swiftmailer:config>
-     <swiftmailer:spool type="memory" />
-</swiftmailer:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('swiftmailer', array(
-     ...,
-    'spool' => array('type' => 'memory')
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Organizar usando un archivo

                  -

                  Para utilizar la organización con un archivo, usa la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-swiftmailer:
-    # ...
-    spool:
-        type: file
-        path: /ruta/a/spool
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-
-<!--
-    xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer"
-    http://symfony.com/schema/dic/swiftmailer http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd
--->
-
-<swiftmailer:config>
-     <swiftmailer:spool
-         type="file"
-         path="/ruta/a/spool" />
-</swiftmailer:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('swiftmailer', array(
-     // ...
-
-    'spool' => array(
-        'type' => 'file',
-        'path' => '/ruta/a/spool',
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Si deseas almacenar la cola de correo en algún lugar en el directorio de tu proyecto, recuerda que puedes utilizar el parámetro %kernel.root_dir% para referirte a la raíz del proyecto:

                  -
                  path: "%kernel.root_dir%/spool"
-
                  -
                  -
                  -

                  Ahora, cuando tu aplicación envía un correo electrónico, no se enviará realmente, sino que se añade a la cola de correo. El envío de los mensajes desde la cola se hace por separado. -Hay una orden de consola para enviar los mensajes en la cola de correo:

                  -
                  $ php app/console swiftmailer:spool:send --env=prod
-
                  -
                  -

                  Tiene una opción para limitar el número de mensajes que se enviarán:

                  -
                  $ php app/console swiftmailer:spool:send --message-limit=10 --env=prod
-
                  -
                  -

                  También puedes establecer el límite de tiempo en segundos:

                  -
                  $ php app/console swiftmailer:spool:send --time-limit=10 --env=prod
-
                  -
                  -

                  Por supuesto que en realidad no deseas ejecutar esto manualmente. En cambio, la orden de consola la debe activar un trabajo cronometrado o tarea programada y ejecutarse a intervalos regulares.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/email/testing.html b/cookbook/email/testing.html deleted file mode 100644 index 1cb85bd..0000000 --- a/cookbook/email/testing.html +++ /dev/null @@ -1,192 +0,0 @@ - - - - - - - Cómo verificar que se envía un mensaje de correo electrónico en una prueba funcional — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo verificar que se envía un mensaje de correo electrónico en una prueba funcional

                  -

                  Enviar correos electrónicos con Symfony2 es bastante sencillo gracias al SwiftmailerBundle, el cual aprovecha el poder de la biblioteca Swiftmailer.

                  -

                  A probar funcionalmente que se envió un correo electrónico, e incluso acertar el asunto del correo electrónico, contenido o cualquiera otra cabecera, puedes utilizar el Generador de perfiles de Symfony2.

                  -

                  Empieza con una fácil acción del controlador que envía un correo electrónico:

                  -
                  public function sendEmailAction($name)
-{
-    $message = \Swift_Message::newInstance()
-        ->setSubject('Hello Email')
-        ->setFrom('send@example.com')
-        ->setTo('recipient@example.com')
-        ->setBody('You should see me from the profiler!')
-    ;
-
-    $this->get('mailer')->send($message);
-
-    return $this->render(...);
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  No olvides habilitar el generador de perfiles como se explica en Cómo utilizar el generador de perfiles en una prueba funcional.

                  -
                  -

                  En tu prueba funcional, usa el recolector swiftmailer en el generador de perfiles para conseguir la información sobre los mensajes enviados en la petición anterior:

                  -
                  // src/Acme/DemoBundle/Tests/Controller/MailControllerTest.php
-use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-
-class MailControllerTest extends WebTestCase
-{
-    public function testMailIsSentAndContentIsOk()
-    {
-        $client = static::createClient();
-
-        // Habilita el perfilador para la próxima petición
-        // (no hace nada si el perfilador no está disponible)
-        $cliente->enableProfiler();
-
-        $crawler = $client->request('POST', '/path/to/above/action');
-
-        $mailCollector = $client->getProfile()->getCollector('swiftmailer');
-
-        // Comprueba que se envió un mensaje de correo electrónico
-        $this->assertEquals(1, $mailCollector->getMessageCount());
-
-        $collectedMessages = $mailCollector->getMessages();
-        $message = $collectedMessages[0];
-
-        // Acierta los datos del correo electrónico
-        $this->assertInstanceOf('Swift_Message', $message);
-        $this->assertEquals('Hello Email', $message->getSubject());
-        $this->assertEquals('send@example.com', key($message->getFrom()));
-        $this->assertEquals('recipient@example.com', key($message->getTo()));
-        $this->assertEquals(
-            'You should see me from the profiler!',
-            $message->getBody()
-        );
-    }
-}
-
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/event_dispatcher/before_after_filters.html b/cookbook/event_dispatcher/before_after_filters.html deleted file mode 100644 index e5ecfd4..0000000 --- a/cookbook/event_dispatcher/before_after_filters.html +++ /dev/null @@ -1,377 +0,0 @@ - - - - - - - Cómo configurar los filtros before y after — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo configurar los filtros before y after

                  -

                  Es bastante común en el desarrollo de aplicaciones web la necesidad de ejecutar algo de lógica justo antes o justo después de la acción actuando como filtros o ganchos.

                  -

                  En symfony1, esto se consiguió con los métodos preExecute y postExecute. -La mayoría de las plataformas importantes tienen métodos similares pero no hay tal cosa en Symfony2. -La buena noticia es que hay mucho mejor una manera de interferir en el proceso Petición -> Respuesta usando el componente EventDispatcher.

                  -
                  -

                  Ejemplo de validación de ficha

                  -

                  Imagina que necesitas desarrollar una API dónde algunos controladores son públicos, pero otros se restringen a uno o algunos clientes. Por estas características particulares, podrías proporcionar una ficha a tus clientes para identificarse.

                  -

                  Por lo tanto, antes de ejecutar la acción del controlador, necesitas comprobar si la acción está restringida o no. Si está restringida, necesitas validar la ficha proporcionada.

                  -
                  -

                  Nota

                  -

                  Por favor, ten en cuenta que para simplificar esta receta, las fichas se definen en la configuración y no utilizaremos ni configuración de base de datos ni proveedor de autenticación a través del componente Security.

                  -
                  -
                  -
                  -

                  Filtros «antes» con el evento kernel.controller

                  -

                  Primero, almacena alguna ficha de configuración básica usando config.yml y parámetros clave:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-parameters:
-    tokens:
-        client1: pass1
-        client2: pass2
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<parameters>
-    <parameter key="tokens" type="collection">
-        <parameter key="client1">pass1</parameter>
-        <parameter key="client2">pass2</parameter>
-    </parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->setParameter('tokens', array(
-    'client1' => 'pass1',
-    'client2' => 'pass2',
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Comprobando etiquetas de controladores

                  -

                  Un escucha del kernel.controller recibe una notificación en cada petición, justo antes de ejecutar el controlador. Por lo tanto, primero necesitas alguna manera de identificar si el controlador que responde a la petición necesita validar la ficha.

                  -

                  Una forma limpia y fácil es crear una interfaz vacía y hacer que los controladores la implementen:

                  -
                  namespace Acme\DemoBundle\Controller;
-
-interface TokenAuthenticatedController
-{
-    // ...
-}
-
                  -
                  -

                  Un controlador que implementa esta interfaz es similar al siguiente:

                  -
                  namespace Acme\DemoBundle\Controller;
-
-use Acme\DemoBundle\Controller\TokenAuthenticatedController;
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class FooController extends Controller implements TokenAuthenticatedController
-{
-    // una acción que necesita autenticación
-    public function barAction()
-    {
-        // ...
-    }
-}
-
                  -
                  -
                  -
                  -

                  Creando un escucha del evento

                  -

                  A continuación, tienes que crear un escucha del evento que contenga la lógica que deseas ejecutar antes que tus controladores. Si no estás familiarizado con los escuchas de eventos, puedes aprender más sobre ellos en Cómo crear un escucha de evento:

                  -
                  // src/Acme/DemoBundle/EventListener/TokenListener.php
-namespace Acme\DemoBundle\EventListener;
-
-use Acme\DemoBundle\Controller\TokenAuthenticatedController;
-use Symfony\Component\HttpKernel\Exception\AccessDeniedHttpException;
-use Symfony\Component\HttpKernel\Event\FilterControllerEvent;
-
-class TokenListener
-{
-    private $tokens;
-
-    public function __construct($tokens)
-    {
-        $this->tokens = $tokens;
-    }
-
-    public function onKernelController(FilterControllerEvent $event)
-    {
-        $controller = $event->getController();
-
-        /*
-         * el $controller pasado puede ser una clase o un cierre.
-         * Esto no es habitual en Symfony2 pero puede suceder.
-         * Si se trata de una clase, viene en formato de arreglo
-         */
-        if (!is_array($controller)) {
-            return;
-        }
-
-        if ($controller[0] instanceof TokenAuthenticatedController) {
-            $token = $event->getRequest()->query->get('token');
-            if (!in_array($token, $this->tokens)) {
-                throw new AccessDeniedHttpException('This action needs a valid token!');
-            }
-        }
-    }
-}
-
                  -
                  -
                  -
                  -

                  Registrando el escucha

                  -

                  Por último, registra tu escucha como un servicio y etiquétalo como un escucha de eventos. -Al escuchar el kernel.controller, le estas diciendo a Symfony que deseas que tu escucha sea llamado justo antes de ejecutar cualquier controlador:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml (o en tu services.yml)
-services:
-    demo.tokens.action_listener:
-        class: Acme\DemoBundle\EventListener\TokenListener
-        arguments: ["%tokens%"]
-        tags:
-                - { name: kernel.event_listener, event: kernel.controller, method: onKernelController }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.yml (o en tu services.yml) -->
-<service id="demo.tokens.action_listener" class="Acme\DemoBundle\EventListener\TokenListener">
-    <argument>%tokens%</argument>
-    <tag name="kernel.event_listener" event="kernel.controller" method="onKernelController" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php (or inside your services.php)
-use Symfony\Component\DependencyInjection\Definition;
-
-$listener = new Definition('Acme\DemoBundle\EventListener\TokenListener', array('%tokens%'));
-$listener->addTag('kernel.event_listener', array(
-    'event'  => 'kernel.controller',
-    'method' => 'onKernelController'
-));
-$container->setDefinition('demo.tokens.action_listener', $listener);
-
                    -
                    -
                    • -
                  -
                  -

                  Con esta configuración, tu método TokenListener del onKernelController será ejecutado en cada petición. Si el controlador que está a punto de ejecutarse implementa el TokenAuthenticatedController, se aplica la autenticación. Esto te permite tener un filtro «antes» en cualquier controlador que desees.

                  -
                  -
                  -
                  -

                  Filtros «después» con el evento kernel.response

                  -

                  Además de tener un gancho que se ejecuta antes que tu controlador, también puedes añadir un gancho que se ejecuté «después» de tu controlador. Para este ejemplo, imagina que quieres agregar un fragmento cifrado con sha1 (con cierta sal que utiliza la ficha) a todas las respuestas a la que se les pase esta ficha de autenticación.

                  -

                  Otro evento del núcleo de Symfony —llamado kernel.response— es notificado en cada petición, pero después de que el controlador regresa un objeto Respuesta. Crear un escucha «después» es tan fácil cómo crear una clase escucha y registrarla como servicio en este evento.

                  -

                  Por ejemplo, tomando el TokenListener del ejemplo anterior y grabando primero la ficha de autenticación en los atributos de la petición. Esto servirá como indicador básico de que esta petición experimentó la autenticación de la ficha:

                  -
                  public function onKernelController(FilterControllerEvent $event)
-{
-    // ...
-
-    if ($controller[0] instanceof TokenAuthenticatedController) {
-        $token = $event->getRequest()->query->get('token');
-        if (!in_array($token, $this->tokens)) {
-            throw new AccessDeniedHttpException('This action needs a valid token!');
-        }
-
-        // marca la petición con autenticación de ficha aprobada
-        $event->getRequest()->attributes->set('auth_token', $token);
-    }
-}
-
                  -
                  -

                  Ahora, añade otro método a esta clase —onKernelResponse— que busque este indicador en el objeto Petición y de encontrarlo ponga una cabecera personalizada en la respuesta:

                  -
                  // Añade la nueva declaración use en la parte superior de tu archivo
-use Symfony\Component\HttpKernel\Event\FilterResponseEvent;
-
-public function onKernelResponse(FilterResponseEvent $event)
-{
-    // comprueba si onKernelController marcó este como una
-    // petición de ficha autenticada
-    if (!$token = $event->getRequest()->attributes->get('auth_token')) {
-        return;
-    }
-
-    $response = $event->getResponse();
-
-    // crea un fragmento cifrado y lo pone como cabecera de la respuesta
-    $hash = sha1($respuesta->getContent().$token);
-    $response->headers->set('X-CONTENT-HASH', $hash);
-}
-
                  -
                  -

                  Finalmente, es necesaria una segunda «etiqueta» en la definición del servicio para notificar a Symfony que el evento onKernelResponse se tendrá que notificar al evento kernel.response:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml (o en tu services.yml)
-services:
-    demo.tokens.action_listener:
-        class: Acme\DemoBundle\EventListener\TokenListener
-        arguments: ["%tokens%"]
-        tags:
-                - { name: kernel.event_listener, event: kernel.controller, method: onKernelController }
-                - { name: kernel.event_listener, event: kernel.response, method: onKernelResponse }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.yml (o en tu services.yml) -->
-<service id="demo.tokens.action_listener" class="Acme\DemoBundle\EventListener\TokenListener">
-    <argument>%tokens%</argument>
-    <tag name="kernel.event_listener" event="kernel.controller" method="onKernelController" />
-    <tag name="kernel.event_listener" event="kernel.response" method="onKernelResponse" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php (or inside your services.php)
-use Symfony\Component\DependencyInjection\Definition;
-
-$listener = new Definition('Acme\DemoBundle\EventListener\TokenListener', array('%tokens%'));
-$listener->addTag('kernel.event_listener', array(
-    'event'  => 'kernel.controller',
-    'method' => 'onKernelController'
-));
-$listener->addTag('kernel.event_listener', array(
-    'event'  => 'kernel.response',
-    'method' => 'onKernelResponse'
-));
-$container->setDefinition('demo.tokens.action_listener', $listener);
-
                    -
                    -
                    • -
                  -
                  -

                  ¡Eso es todo! El evento TokenListener ahora es notificado antes de ejecutar cada controlador (onKernelController) y después de que cada controlador regrese una respuesta (onKernelResponse). Al hacer que controladores específicos implementen la interfaz TokenAuthenticatedController, tu escucha sabe cuales controladores deben tomar una acción. -Y almacenando un valor en la bolsa de «atributos» de la petición, el método onKernelResponse sabe que tiene que añadir la cabecera extra. ¡Que te diviertas!

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/event_dispatcher/class_extension.html b/cookbook/event_dispatcher/class_extension.html deleted file mode 100644 index 99f8575..0000000 --- a/cookbook/event_dispatcher/class_extension.html +++ /dev/null @@ -1,241 +0,0 @@ - - - - - - - Cómo extender una clase sin necesidad de utilizar herencia — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo extender una clase sin necesidad de utilizar herencia

                  -

                  Para permitir que varias clases agreguen métodos a otra, puedes definir el método mágico __call() de la clase que deseas ampliar de esta manera:

                  -
                  class Foo
-{
-    // ...
-
-    public function __call($method, $arguments)
-    {
-        // crea un evento llamado 'foo.method_is_not_found'
-        $event = new HandleUndefinedMethodEvent($this, $method, $arguments);
-        $this->dispatcher->dispatch('foo.method_is_not_found', $event);
-
-        // ¿ningún escucha es capaz de procesar el evento? El método no existe
-        if (!$event->isProcessed()) {
-            throw new \Exception(sprintf('Call to undefined method %s::%s.', get_class($this), $method));
-        }
-
-        // regresa el escucha que devolvió el valor
-        return $event->getReturnValue();
-    }
-}
-
                  -
                  -

                  Este utiliza un HandleUndefinedMethodEvent especial que también se debe crear. Esta es una clase genérica que podrías reutilizar cada vez que necesites usar este modelo para extender clases:

                  -
                  use Symfony\Component\EventDispatcher\Event;
-
-class HandleUndefinedMethodEvent extends Event
-{
-    protected $subject;
-    protected $method;
-    protected $arguments;
-    protected $returnValue;
-    protected $isProcessed = false;
-
-    public function __construct($subject, $method, $arguments)
-    {
-        $this->asunto = $asunto;
-        $this->metodo = $metodo;
-        $this->arguments = $arguments;
-    }
-
-    public function getSubject()
-    {
-        return $this->subject;
-    }
-
-    public function getMethod()
-    {
-        return $this->method;
-    }
-
-    public function getArguments()
-    {
-        return $this->arguments;
-    }
-
-    /**
-     * Fija el valor a devolver y detiene la notificación a otros escuchas
-     */
-    public function setReturnValue($val)
-    {
-        $this->returnValue = $val;
-        $this->isProcessed = true;
-        $this->stopPropagation();
-    }
-
-    public function getReturnValue($val)
-    {
-        return $this->returnValue;
-    }
-
-    public function isProcessed()
-    {
-        return $this->isProcessed;
-    }
-}
-
                  -
                  -

                  A continuación, crea una clase que debe escuchar el evento foo.method_is_not_found y añade el método bar():

                  -
                  class Bar
-{
-    public function onFooMethodIsNotFound(HandleUndefinedMethodEvent $event)
-    {
-        // únicamente responde a las llamadas al método 'bar'
-        if ('bar' != $event->getMethod()) {
-            // permite que otro escucha se preocupe del método desconocido
-            return;
-        }
-
-        // el objeto subject (la instancia foo)
-        $foo = $event->getSubject();
-
-        // los argumentos del método bar
-        $arguments = $event->getArguments();
-
-        // ... hace algo
-
-        // fija el valor de retorno
-        $event->setReturnValue($someValue);
-    }
-}
-
                  -
                  -

                  Finally, add the new bar method to the Foo class by registering an -instance of Bar with the foo.method_is_not_found event:

                  -
                  $bar = new Bar();
-$dispatcher->addListener('foo.method_is_not_found', array($bar, 'onFooMethodIsNotFound'));
-
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/event_dispatcher/index.html b/cookbook/event_dispatcher/index.html deleted file mode 100644 index bc07f44..0000000 --- a/cookbook/event_dispatcher/index.html +++ /dev/null @@ -1,146 +0,0 @@ - - - - - - - Despachador de eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/event_dispatcher/method_behavior.html b/cookbook/event_dispatcher/method_behavior.html deleted file mode 100644 index 6a45a54..0000000 --- a/cookbook/event_dispatcher/method_behavior.html +++ /dev/null @@ -1,174 +0,0 @@ - - - - - - - Cómo personalizar el comportamiento de un método sin utilizar herencia — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo personalizar el comportamiento de un método sin utilizar herencia

                  -
                  -

                  Haciendo algo antes o después de llamar a un método

                  -

                  Si quieres hacer algo justo antes o justo después de invocar a un método, puedes enviar un evento, al principio o al final del método, respectivamente:

                  -
                  class Foo
-{
-    // ...
-
-    public function send($foo, $bar)
-    {
-        // hace algo antes que el método
-        $event = new FilterBeforeSendEvent($foo, $bar);
-        $this->dispatcher->dispatch('foo.pre_send', $event);
-
-        // obtiene $foo y $bar desde el evento, esto se puede modificar
-        $foo = $event->getFoo();
-        $bar = $event->getBar();
-
-        // aquí va la implementación real del método
-        $ret = ...;
-
-        // hace algo después del método
-        $event = new FilterSendReturnValue($ret);
-        $this->dispatcher->dispatch('foo.post_send', $event);
-
-        return $event->getReturnValue();
-    }
-}
-
                  -
                  -

                  En este ejemplo, se lanzan dos eventos: foo.pre_send, antes de ejecutar el método, y foo.post_send después de ejecutar el método. Cada uno utiliza una clase Evento personalizada para comunicar información a los escuchas de los dos eventos. Estas clases de evento se tendrían que crear por ti y deben permitir que, en este ejemplo, las variables $foo, $bar y $ret sean recuperadas y establecidas por los escuchas.

                  -

                  Por ejemplo, suponiendo que el FilterSendReturnValue tiene un método setReturnValue, un escucha puede tener este aspecto:

                  -
                  public function onFooPostSend(FilterSendReturnValue $event)
-{
-    $ret = $event->getReturnValue();
-    // modifica el valor original de ``$ret``
-
-    $event->setReturnValue($ret);
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/create_custom_field_type.html b/cookbook/form/create_custom_field_type.html deleted file mode 100644 index 694fa07..0000000 --- a/cookbook/form/create_custom_field_type.html +++ /dev/null @@ -1,420 +0,0 @@ - - - - - - - Cómo crear un tipo de campo personalizado para formulario — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear un tipo de campo personalizado para formulario

                  -

                  Symfony viene con un montón de tipos de campos fundamentales para la construcción de formularios. -Sin embargo, hay situaciones en las cuales quieres crear un tipo de campo de formulario personalizado -para un propósito específico. Esta receta asume que necesitas una definición de campo que contiene el género de una persona, basándote en el campo choice existente. Esta sección explica cómo definir el campo, cómo puedes personalizar su diseño y, por último, cómo lo puedes registrar para usarlo en tu aplicación.

                  -
                  -

                  Definiendo el tipo de campo

                  -

                  Con el fin de crear el tipo de campo personalizado, primero tienes que crear la clase que representa el campo. En esta situación, la clase contendrá el tipo de campo que se llamará GenderType y el archivo se guardará en la ubicación predeterminada para campos de formulario, la cual es <NombrePaquete>\Form\Type. Asegúrate de que el campo se extiende de -Symfony\Component\Form\AbstractType:

                  -
                  // src/Acme/DemoBundle/Form/Type/GenderType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class GenderType extends AbstractType
-{
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'choices' => array(
-                'm' => 'Male',
-                'f' => 'Female',
-            )
-        ));
-    }
-
-    public function getParent()
-    {
-        return 'choice';
-    }
-
-    public function getName()
-    {
-        return 'gender';
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  La ubicación de este archivo no es importante - el directorio Form\Type sólo es una convención.

                  -
                  -

                  En este caso, el valor de retorno de la función getParent indica que estas extendiendo el tipo de campo choice. Esto significa que, por omisión, heredas toda la lógica y represtación de ese tipo de campo. Para ver algo de la lógica, echa un vistazo a la clase ChoiceType. Hay tres métodos que son particularmente importantes:

                  -
                    -
                  • buildForm() - Cada tipo de campo tiene un método buildForm, que es donde configuras y construyes cualquier campo(s). Ten en cuenta que este es el mismo método que utilizas para configurar tus formularios, y aquí funciona igual.
                    • -
                  • buildView() - Este método se utiliza para establecer las variables extra que necesitarás al reproducir el campo en una plantilla. Por ejemplo, en ChoiceType, está definida una variable multiple que se fija y utiliza en la plantilla para establecer (o no un conjunto), el atributo multiple en el campo select. Ve Creando una plantilla para el campo para más detalles.
                    • -
                  • setDefaultOptions() - Define opciones para tu tipo de formulario que puedes utilizar en buildForm() y buildView(). Hay un montón de opciones comunes a todos los campos (consulta Tipo de campo Form), pero aquí, puedes crear cualquier otra que necesites.
                    • -
                  -
                  -

                  Truco

                  -

                  Si vas a crear un campo que consta de muchos campos, entonces, asegúrate de establecer tu tipo «padre» como form o algo que extienda a form. -Además, si necesitas modificar la «vista» de cualquiera de tus tipos descendientes de tu tipo padre, usa el método finishView().

                  -
                  -

                  El método getName() devuelve un identificador que debe ser único en tu aplicación. Este se utiliza en varios lugares, tales como cuando personalizas cómo será pintado tu tipo de formulario.

                  -

                  El objetivo de este campo es extender el tipo choice para habilitar la selección de un género. Esto se consigue fijando las opciones a una lista de posibles géneros.

                  -
                  -
                  -

                  Creando una plantilla para el campo

                  -

                  Cada tipo de campo está representado por un fragmento de la plantilla, el cual se determina en parte por el valor de su método getName(). Para más información, consulta ¿Qué son los temas de formulario?.

                  -

                  En este caso, debido a que el campo padre es choice, no necesitas hacer ningún trabajo debido a que el tipo de campo personalizado automáticamente lo dibuja como el tipo choice. Pero por el bien de este ejemplo, supón que al «expandir» tu campo (es decir, botones de radio o casillas de verificación, en vez de un campo de selección), lo quieres dibujar siempre en un elemento ul. En la plantilla del tema de tu formulario (consulta el enlace de arriba para más detalles), crea un bloque gender_widget para manejar esto:

                  -
                  -
                    -
                  • Twig
                    {# src/Acme/DemoBundle/Resources/views/Form/fields.html.twig #}
-{% block gender_widget %}
-    {% spaceless %}
-        {% if expanded %}
-            <ul {{ block('widget_container_attributes') }}>
-            {% for child in form %}
-                <li>
-                    {{ form_widget(child) }}
-                    {{ form_label(child) }}
-                </li>
-            {% endfor %}
-            </ul>
-        {% else %}
-            {# simplemente deja que el elemento gráfico 'choice' reproduzca la etiqueta select #}
-            {{ block('choice_widget') }}
-        {% endif %}
-    {% endspaceless %}
-{% endblock %}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- src/Acme/DemoBundle/Resources/views/Form/gender_widget.html.twig -->
-<?php if ($expanded) : ?>
-    <ul <?php $view['form']->block($form, 'widget_container_attributes') ?>>
-    <?php foreach ($form as $child) : ?>
-        <li>
-            <?php echo $view['form']->widget($child) ?>
-            <?php echo $view['form']->label($child) ?>
-        </li>
-    <?php endforeach ?>
-    </ul>
-<?php else : ?>
-    <!-- simplemente deja que el elemento gráfico 'choice' reproduzca la etiqueta select -->
-    <?php echo $view['form']->renderBlock('choice_widget') ?>
-<?php endif ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Asegúrate que utilizas el prefijo correcto para el elemento gráfico. En este ejemplo, el nombre debe set gender_widget, de acuerdo con el valor devuelto por getName. -Además, el archivo de configuración principal debe apuntar a la plantilla del formulario personalizado de modo que este se utilice al reproducir todos los formularios.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-twig:
-    form:
-        resources:
-            - 'AcmeDemoBundle:Form:fields.html.twig'
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<twig:config>
-    <twig:form>
-        <twig:resource>AcmeDemoBundle:Form:fields.html.twig</twig:resource>
-    </twig:form>
-</twig:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('twig', array(
-    'form' => array(
-        'resources' => array(
-            'AcmeDemoBundle:Form:fields.html.twig',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Usando el tipo de campo

                  -

                  Ahora puedes utilizar el tipo de campo personalizado de inmediato, simplemente creando una nueva instancia del tipo en uno de tus formularios:

                  -
                  // src/Acme/DemoBundle/Form/Type/AuthorType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-
-class AuthorType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('gender_code', new GenderType(), array(
-            'empty_value' => 'Choose a gender',
-        ));
-    }
-}
-
                  -
                  -

                  Pero esto sólo funciona porque el GenderType() es muy sencillo. ¿Qué pasa si los códigos de género se almacena en la configuración o en una base de datos? La siguiente sección se explica cómo resuelven este problema los tipos de campo más complejos.

                  -
                  -
                  -

                  Creando tu tipo de campo como un servicio

                  -

                  Hasta ahora, este artículo ha supuesto que tienes un tipo de campo personalizado muy simple. -Pero si necesitas acceder a la configuración de una conexión base de datos, o a algún otro servicio, entonces querrás registrar tu tipo personalizado como un servicio. Por ejemplo, supón que estas almacenando los parámetros de género en la configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-parameters:
-    genders:
-        m: Male
-        f: Female
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<parameters>
-    <parameter key="genders" type="collection">
-        <parameter key="m">Male</parameter>
-        <parameter key="f">Female</parameter>
-    </parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->setParameter('genders.m', 'Male');
-$container->setParameter('genders.f', 'Female');
-
                    -
                    -
                    • -
                  -
                  -

                  Para utilizar el parámetro, define tu tipo de campo personalizado como un servicio, inyectando el valor del parámetro genders como el primer argumento de la función __construct que vas a crear:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/DemoBundle/Resources/config/services.yml
-services:
-    acme_demo.form.type.gender:
-        class: Acme\DemoBundle\Form\Type\GenderType
-        arguments:
-            - "%genders%"
-        tags:
-                - { name:     form.type, alias: gender }
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/DemoBundle/Resources/config/services.xml -->
-<service id="acme_demo.form.type.gender" class="Acme\DemoBundle\Form\Type\GenderType">
-    <argument>%genders%</argument>
-    <tag name="form.type" alias="gender" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/DemoBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container
-    ->setDefinition('acme_demo.form.type.gender', new Definition(
-        'Acme\DemoBundle\Form\Type\GenderType',
-        array('%genders%')
-    ))
-    ->addTag('form.type', array(
-        'alias' => 'gender',
-    ))
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Asegúrate de que estás importando el archivo de servicios. Consulta Importando configuración con imports para más detalles.

                  -
                  -

                  Asegúrate de que la etiqueta del atributo alias corresponde con el valor devuelto por el método getName definido anteriormente. Verás la importancia de esto en un momento cuando utilices el tipo de campo personalizado. Pero primero, agrega un método __construct, el cual recibe la configuración del género:

                  -
                  // src/Acme/DemoBundle/Form/Type/GenderType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-// ...
-
-// ...
-class GenderType extends AbstractType
-{
-    private $genderChoices;
-
-    public function __construct(array $genderChoices)
-    {
-        $this->genderChoices = $genderChoices;
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'choices' => $this->genderChoices,
-        ));
-    }
-
-    // ...
-}
-
                  -
                  -

                  ¡Genial! El GenderType ahora es impulsado por los parámetros de configuración y está registrado como un servicio. Adicionalmente, debido a que utilizaste el alias form.type en tu configuración, es mucho más fácil utilizar el campo:

                  -
                  // src/Acme/DemoBundle/Form/Type/AuthorType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\FormBuilderInterface;
-
-// ...
-
-class AuthorType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('gender_code', 'gender', array(
-            'empty_value' => 'Choose a gender',
-        ));
-    }
-}
-
                  -
                  -

                  Ten en cuenta que en vez de crear una nueva instancia, puedes simplemente referirte a ella -por el alias utilizado en tu configuración del servicio, gender. ¡Que te diviertas!

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/create_form_type_extension.html b/cookbook/form/create_form_type_extension.html deleted file mode 100644 index 9605b78..0000000 --- a/cookbook/form/create_form_type_extension.html +++ /dev/null @@ -1,394 +0,0 @@ - - - - - - - Cómo crear una extensión del tipo «Form» — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear una extensión del tipo «Form»

                  -

                  Los Tipos de campo de formulario personalizados son buenos cuando necesitas tipos de campo con un propósito específico, tal como un selector de género, o una entrada de RFC (en méxico, Registro Federal de Causantes o VAT en los paises europeos).

                  -

                  Pero a veces, en realidad no necesitas añadir nuevos tipos de campos —deseas -agregar características en lo alto de tipos existentes—. Aquí es donde entran en juego la extensiones del tipo «Form».

                  -

                  Las extensiones del tipo «Form» tienen 2 casos de uso principales:

                  -
                    -
                  1. ¿Quieres añadir una característica genérica a varios tipos (por ejemplo, añadir un texto de «ayuda» a cada tipo de campo);
                    2. -
                  2. ¿Quieres añadir una característica específica a un solo tipo (tal como la adición de una característica «download» al tipo de campo «file»).
                    3. -
                  -

                  En ambos casos, puede ser posible lograr tu objetivo personalizando la representación del formulario, o con tipos de campos de formulario personalizados. Pero usar extensiones del tipo «Form» puede ser más limpio (al limitar la cantidad de lógica del negocio en plantillas) y más flexible (puedes agregar varias extensiones de tipo a un solo tipo «form»).

                  -

                  Las extensiones del tipo «Form» pueden conseguir la mayoría de los tipos de campos personalizados que puedes hacer, pero en vez de ser los tipos de campo propios, estos se conectan a los tipos existentes.

                  -

                  Imagina que administras una entidad Media, y que cada medio se asocia a un archivo. Tu formulaio Media utiliza un tipo de archivo, pero cuando editas la entidad, -te gustaría ver su imagen dibujada automáticamente junto a la entrada de archivo.

                  -

                  Por supuesto, lo podrías hacer personalizando la representación de este en una -plantilla. Pero las extensiones de tipo de campo te permiten hacer esto de una manera mucho más agradable.

                  -
                  -

                  Definiendo la extensión del tipo «Form»

                  -

                  Tu primera tarea será crear la clase de la extensión del tipo «Form». La llamarás ImageTypeExtension. Por norma gemeral, las extensiones de «form» viven en el directorio Form\Extension de uno de tus paquetes.

                  -

                  Al crear una extensión del tipo «form», puedes implementar la interfaz Symfony\Component\Form\FormTypeExtensionInterface o extender la clase Symfony\Component\Form\AbstractTypeExtension. En la mayoría de los casos, es más fácil extender la clase abstracta:

                  -
                  // src/Acme/DemoBundle/Form/Extension/ImageTypeExtension.php
-namespace Acme\DemoBundle\Form\Extension;
-
-use Symfony\Component\Form\AbstractTypeExtension;
-
-class ImageTypeExtension extends AbstractTypeExtension
-{
-    /**
-     * Devuelve el nombre del tipo que será extendido.
-     *
-     * @return string The name of the type being extended
-     */
-    public function getExtendedType()
-    {
-        return 'file';
-    }
-}
-
                  -
                  -

                  El único método que necesitas implementar es la función getExtendedType. -Esta se usa para indicar el nombre del tipo «form» que será extendido -por tu extensión.

                  -
                  -

                  Truco

                  -

                  El valor que regresas en el método getExtendedType corresponde al valor devuelto por el método getName en la clase del tipo «form» que deseas extender.

                  -
                  -

                  Además de la función getExtendedType, probablemente quieras sustituir uno de los siguientes métodos:

                  -
                    -
                  • buildForm()
                    • -
                  • buildView()
                    • -
                  • setDefaultOptions()
                    • -
                  • finishView()
                    • -
                  -

                  Para más información sobre que hacen estos métodos, puedes referirte al artículo -Creando tipos de campo personalizados en el recetario.

                  -
                  -
                  -

                  Registrando como servicio tu extensión del tipo «Form»

                  -

                  El siguiente paso es dar a conocer tu extensión a Symfony. Todo lo que tienes que hacer es declararla como un servicio utilizando la etiqueta form.type_extension:

                  -
                  -
                    -
                  • YAML
                    services:
-    acme_demo_bundle.image_type_extension:
-        class: Acme\DemoBundle\Form\Extension\ImageTypeExtension
-        tags:
-                - { name: form.type_extension, alias: file }
-
                    -
                    -
                    • -
                  • XML
                    <service id="acme_demo_bundle.image_type_extension"
-    class="Acme\DemoBundle\Form\Extension\ImageTypeExtension"
->
-    <tag name="form.type_extension" alias="file" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register(
-        'acme_demo_bundle.image_type_extension',
-        'Acme\DemoBundle\Form\Extension\ImageTypeExtension'
-    )
-    ->addTag('form.type_extension', array('alias' => 'file'));
-
                    -
                    -
                    • -
                  -
                  -

                  La clave alias de la etiqueta es el tipo de campo al que esta extensión se debe aplicar. En tu caso, cuando quieras extender el tipo de campo file, utilizarás file como un alias.

                  -
                  -
                  -

                  Añadiendo lógica del negocio a la extensión

                  -

                  El objetivo de tu extensión es mostrar bonitas imágenes junto a las entradas de archivo (cuándo el modelo subyacente contenga imágenes). Para ese propósito, supón que utilizas un enfoque similar al descrito en artículo -Cómo manejar archivos subidos con Doctrine: -Tienes un modelo de Medios con una propiedad file (correspondiente al campo de archivo en el formulario) y una propiedad path (correspondiente a la ruta de la imagen en la base de datos):

                  -
                  // src/Acme/DemoBundle/Entity/Media.php
-namespace Acme\DemoBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Media
-{
-    // ...
-
-    /**
-     * @var string The path - typically stored in the database
-     */
-    private $path;
-
-    /**
-     * @var \Symfony\Component\HttpFoundation\File\UploadedFile
-     * @Assert\File(maxSize="2M")
-     */
-    public $file;
-
-    // ...
-
-    /**
-     * Obtiene la url de la imagen
-     *
-     * @return null|string
-     */
-    public function getWebPath()
-    {
-        // ... $webPath comienza la url completa de la imagen, para utilizarla en plantillas
-
-        return $webPath;
-    }
-}
-
                  -
                  -

                  Tu clase de la extensión del tipo «form» deberá hacer dos cosas para extender -el tipo file de «form»:

                  -
                    -
                  1. Sustituye el método setDefaultOptions con el fin de añadir una opción image_path;
                    2. -
                  2. Sustituye los métodos buildForm y buildView para pasar la URL de la imagen a la vista.
                    3. -
                  -

                  La lógica es la siguiente: cuándo añades un campo de tipo file al formulario, serás capaz de especificar una nueva opción: image_path. Esta opción dirá al campo file cómo conseguir la URL real de la imagen para mostrarla en la vista:

                  -
                  // src/Acme/DemoBundle/Form/Extension/ImageTypeExtension.php
-namespace Acme\DemoBundle\Form\Extension;
-
-use Symfony\Component\Form\AbstractTypeExtension;
-use Symfony\Component\Form\FormView;
-use Symfony\Component\Form\FormInterface;
-use Symfony\Component\PropertyAccess\PropertyAccess;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class ImageTypeExtension extends AbstractTypeExtension
-{
-    /**
-     * Devuelve el nombre del tipo que será extendido.
-     *
-     * @return string The name of the type being extended
-     */
-    public function getExtendedType()
-    {
-        return 'file';
-    }
-
-    /**
-     * Añade la opción image_path
-     *
-     * @param OptionsResolverInterface $resolver
-     */
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setOptional(array('image_path'));
-    }
-
-    /**
-     * Pase la URL de la imagen a la vista
-     *
-     * @param FormView $view
-     * @param FormInterface $form
-     * @param array $options
-     */
-    public function buildView(FormView $view, FormInterface $form, array $options)
-    {
-        if (array_key_exists('image_path', $options)) {
-            $parentData = $form->getParent()->getData();
-
-            if (null !== $parentData) {
-                $accessor = PropertyAccess::getPropertyAccessor();
-                $imageUrl = $accessor->getValue($parentData, $options['image_path']);
-            } else {
-                 $imageUrl = null;
-            }
-
-            // configura una variable "image_url" que debe estar disponible al dibujar este campo
-            $view->set('image_url', $imageUrl);
-        }
-    }
-
-}
-
                  -
                  -
                  -
                  -

                  Sustituye el elemento gráfico del fragmento de plantilla

                  -

                  Cada tipo de campo es dibujado por un fragmento de plantilla. Estos fragmentos de plantilla se pueden sustituir para personalizar la forma de dibujarlo. Para más información, puedes referirte al artículo ¿Qué son los temas de formulario?.

                  -

                  En tu clase de la extensión, añadiste una nueva variable (image_url), pero -todavía necesitas aprovechar en tus plantillas esta nueva variable. -Específicamente, necesitas sustituir el bloque file_widget:

                  -
                  -
                    -
                  • Twig
                    {# src/Acme/DemoBundle/Resources/views/Form/fields.html.twig #}
-{% extends 'form_div_layout.html.twig' %}
-
-{% block file_widget %}
-    {% spaceless %}
-
-    {{ block('form_widget') }}
-    {% if image_url is not null %}
-        <img src="{{ asset(image_url) }}"/>
-    {% endif %}
-
-    {% endspaceless %}
-{% endblock %}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- src/Acme/DemoBundle/Resources/views/Form/file_widget.html.php -->
-<?php echo $view['form']->widget($form) ?>
-<?php if (null !== $image_url): ?>
-    <img src="<?php echo $view['assets']->getUrl($image_url) ?>"/>
-<?php endif ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Necesitarás cambiar tu archivo «config» o especificar explícitamente cómo quieres tematizar tu formulario a fin de que Symfony utilice tu bloque redefinido. Ve ¿Qué son los temas de formulario? para más información.

                  -
                  -
                  -
                  -

                  Usando la extensión del tipo «Form»

                  -

                  De ahora en adelante, cuándo añadas un campo de tipo file a tu formulario, puedes especificar una opción image_path que será la imagen a mostrar junto al campo de archivo. Por ejemplo:

                  -
                  // src/Acme/DemoBundle/Form/Type/MediaType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-
-class MediaType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('name', 'text')
-            ->add('file', 'file', array('image_path' => 'webPath'));
-    }
-
-    public function getName()
-    {
-        return 'media';
-    }
-}
-
                  -
                  -

                  Cuándo muestres el formulario, si el modelo subyacente ya fue asociado con una imagen, la verás junto a la entrada de archivo.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/data_transformers.html b/cookbook/form/data_transformers.html deleted file mode 100644 index 268cb41..0000000 --- a/cookbook/form/data_transformers.html +++ /dev/null @@ -1,431 +0,0 @@ - - - - - - - Cómo usar transformadores de datos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar transformadores de datos

                  -

                  A menudo te encontrarás con la necesidad de transformar en alguna otra cosa los datos que el usuario introdujo en un formulario para usarlos en tu programa. Lo podrías hacer fácilmente a mano en tu controlador, pero, ¿qué pasa si quieres utilizar ese formulario específico en diferentes sitios?

                  -

                  Digamos que tienes una relación uno a uno entre una Tarea y una Incidencia, por ejemplo, una Tarea opcionalmente está vinculada a una Incidencia. Añadir un cuadro de lista con todas las posibles Incidencias finalmente te puede conducir a una lista realmente larga en la cual es imposible encontrar algo. En su lugar mejor querrás añadir un cuadro de texto, en el cual el usuario sencillamente puede introducir el número de la incidencia.

                  -

                  Podrías intentar hacer esto en tu controlador, pero no es la mejor solución. -Sería mejor si esta incidencia se buscara y convirtiera automáticamente a un objeto Incidencia, para usarla en tu acción. -Aquí es donde entran en juego los Transformadores de datos.

                  -
                  -

                  Creando el transformador

                  -

                  En primer lugar, crea una clase IssueToNumberTransformer — esta clase será la responsable de la conversión hacia y desde el número de incidencia y el objeto Incidencia:

                  -
                  // src/Acme/TaskBundle/Form/DataTransformer/IssueToNumberTransformer.php
-namespace Acme\TaskBundle\Form\DataTransformer;
-
-use Symfony\Component\Form\DataTransformerInterface;
-use Symfony\Component\Form\Exception\TransformationFailedException;
-use Doctrine\Common\Persistence\ObjectManager;
-use Acme\TaskBundle\Entity\Issue;
-
-class IssueToNumberTransformer implements DataTransformerInterface
-{
-    /**
-     * @var ObjectManager
-     */
-    private $om;
-
-    /**
-     * @param ObjectManager $om
-     */
-    public function __construct(ObjectManager $om)
-    {
-        $this->om = $om;
-    }
-
-    /**
-     * Transforma un objeto (``issue``) a una cadena (``number``).
-     *
-     * @param  Issue|null $issue
-     * @return string
-     */
-    public function transform($issue)
-    {
-        if (null === $issue) {
-            return "";
-        }
-
-        return $issue->getNumber();
-    }
-
-    /**
-     * Transforma una cadena (``number``) a un objeto (``issue``).
-     *
-     * @param  string $number
-     *
-     * @return Issue|null
-     *
-     * @throws TransformationFailedException si no encuentra el objeto (issue).
-     */
-    public function reverseTransform($number)
-    {
-        if (!$number) {
-            return null;
-        }
-
-        $issue = $this->om
-            ->getRepository('AcmeTaskBundle:Issue')
-            ->findOneBy(array('number' => $number))
-        ;
-
-        if (null === $issue) {
-            throw new TransformationFailedException(sprintf(
-                'An issue with number "%s" does not exist!',
-                $number
-            ));
-        }
-
-        return $issue;
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Si quieres crear una nueva incidencia al introducir un número desconocido, puedes crear una nueva instancia en lugar de lanzar una TransformationFailedException.

                  -
                  -
                  -
                  -

                  Usando el transformador

                  -

                  Ahora que ya tienes incorporado el transformador, solamente lo tienes que añadir a tu campo incidencia en algún formulario.

                  -
                  -

                  También puedes utilizar transformadores sin necesidad de crear un nuevo tipo de formulario personalizado llamando a addModelTransformer (o a addViewTransformer — consulta la sección Transformadores de modelo y vista) en cualquier campo del constructor:

                  -
                  use Symfony\Component\Form\FormBuilderInterface;
-use Acme\TaskBundle\Form\DataTransformer\IssueToNumberTransformer;
-
-class TaskType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        // ...
-
-        // este asume que el gestor de la entidad se pasó como una
-        // opción
-        $entityManager = $options['em'];
-        $transformer = new IssueToNumberTransformer($entityManager);
-
-        // agrega un campo de texto normal, pero le añade tu transformador
-        $builder->add(
-            $builder->create('issue', 'text')
-                ->addModelTransformer($transformer)
-        );
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'data_class' => 'Acme\TaskBundle\Entity\Task',
-        ));
-
-        $resolver->setRequired(array(
-            'em',
-        ));
-
-        $resolver->setAllowedTypes(array(
-            'em' => 'Doctrine\Common\Persistence\ObjectManager',
-        ));
-
-        // ...
-    }
-
-    // ...
-}
-
                  -
                  -
                  -

                  Este ejemplo requiere que pases como una opción el gestor de la entidad al crear el formulario. Más tarde, aprenderás cómo puedes crear un tipo de campo incidencia personalizado para evitar la necesidad de hacer esto en tu controlador:

                  -
                  $taskForm = $this->createForm(new TaskType(), $task, array(
-    'em' => $this->getDoctrine()->getEntityManager(),
-));
-
                  -
                  -

                  ¡Estupendo, ya está! El usuario será capaz de introducir un número de incidencia en el campo de texto y se transformará en un objeto Incidencia. Esto significa que, después de vincularlo satisfactoriamente, la infraestructura del formulario pasa un objeto Incidencia real a Task::setIssue() en vez de el número de incidencia.

                  -

                  Si no encuentra la incidencia, creará un error en el formulario para ese campo y puedes controlar su mensaje de error con la opción invalid_message del campo.

                  -
                  -

                  Prudencia

                  -

                  Ten en cuenta que al añadir un transformador necesitas usar una sintaxis un poco más complicada cuando agregas el campo. Lo siguiente es incorrecto, debido a que puedes aplicar el transformador a todo el formulario, en lugar de sólo a este campo:

                  -
                  // ESTE ESTÁ MAL - LA TRANSFORMACIÓN SE APLICARÁ AL
-// FORMULARIO COMPLETO
-// ve el código correcto en el ejemplo anterior
-$builder->add('issue', 'text')
-    ->addModelTransformer($transformer);
-
                  -
                  -
                  -
                  -

                  Transformadores de modelo y vista

                  -

                  -Nuevo en la versión 2.1: Los nombres y métodos de los transformadores cambiaron en Symfony 2.1. -prependNormTransformer se convirtió en addModelTransformer y appendClientTransformer cambió a addViewTransformer.

                  -

                  En el ejemplo anterior, el transformador se utilizó como un transformador del «modelo». -De hecho, hay dos diferentes tipos de transformadores y tres diferentes tipos de datos subyacentes.

                  -../../_images/DataTransformersTypes.png -

                  En cualquier formulario, los 3 diferentes tipos de datos son los siguientes:

                  -
                    -
                  1. Datos del modelo — Estos son los datos en el formato que se utiliza en tu aplicación (por ejemplo, un objeto Insidencia). Si llamas a Form::getData o Form::setData, estás tratando con los datos del «modelo».
                    2. -
                  2. Datos normales — Esta es una versión normalizada de los datos, y suelen ser los mismos datos que los de tu «modelo» (aunque no en nuestro ejemplo). Comúnmente no se utiliza directamente.
                    3. -
                  3. Datos de la vista — Este es el formato que se utiliza para rellenar los campos del formulario en sí. También es el formato en el que el usuario enviará los datos. Cuando llamas a Form::bind($datos), los $datos están en el formato de la «vista».
                    4. -
                  -

                  Los 2 diferentes tipos de transformadores te ayudan a convertir hacia y desde cada uno de estos tipos de datos:

                  -
                  -
                  transformadores del modelo:
                  -
                  — transform: “datos del modelo” => “datos normales” -— reverseTransform: “datos normales” => “datos del modelo”
                  -
                  Transformadores de la vista:
                  -
                  — transform: “datos normales” => “datos de la vista” -— reverseTransform: “datos de la vista” => “datos normales”
                  -
                  -

                  ¿Qué transformador necesitas? depende de tu situación.

                  -

                  Para utilizar el transformador de la vista, llama a addViewTransformer.

                  -
                  -
                  -
                  -

                  ¿Así que por qué uso el modelo transformador?

                  -

                  En este ejemplo, el campo es un campo text, y un campo de texto siempre se espera que sea un sencillo, formato escalar en los formatos norm y view. Por esta razón, el transformador más adecuado fue el transformador del «modelo» (que se convierte a/desde el formato normal — cadena a número — al formato del modelo — emisión de objeto).

                  -

                  La diferencia entre los transformadores es sutil y siempre se debe pensar en lo que deben ser realmente los datos «normales» para un campo. Por ejemplo, los datos «normales» de un campo text son una cadena, pero es un objeto DateTime para un campo date.

                  -
                  -
                  -

                  Usando transformadores en un tipo de campo personalizado

                  -

                  En el ejemplo anterior, aplicaste el transformador a un campo text normal. -Esto fue fácil, pero tiene dos inconvenientes:

                  -
                    -
                  1. Necesitas recordar siempre que debes aplicar el transformador cuando vas a añadir un campo de número de incidencia.
                    2. -
                  2. Tienes que preocuparte de pasarlo en la opción em cada vez que creas un formulario que utiliza el transformador.
                    3. -
                  -

                  Debido a esto, puedes optar por crear un tipo de campo personalizado. -En primer lugar, crea la clase del tipo de campo personalizado:

                  -
                  // src/Acme/TaskBundle/Form/Type/IssueSelectorType.php
-namespace Acme\TaskBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Acme\TaskBundle\Form\DataTransformer\IssueToNumberTransformer;
-use Doctrine\Common\Persistence\ObjectManager;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class IssueSelectorType extends AbstractType
-{
-    /**
-     * @var ObjectManager
-     */
-    private $om;
-
-    /**
-     * @param ObjectManager $om
-     */
-    public function __construct(ObjectManager $om)
-    {
-        $this->om = $om;
-    }
-
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $transformer = new IssueToNumberTransformer($this->om);
-        $builder->addModelTransformer($transformer);
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'invalid_message' => 'The selected issue does not exist',
-        ));
-    }
-
-    public function getParent()
-    {
-        return 'text';
-    }
-
-    public function getName()
-    {
-        return 'issue_selector';
-    }
-}
-
                  -
                  -

                  A continuación, registra el tipo como un servicio y etiquétalo con form.type, para que sea reconocido como un tipo de campo personalizado:

                  -
                  -
                    -
                  • YAML
                    services:
-    acme_demo.type.issue_selector:
-        class: Acme\TaskBundle\Form\Type\IssueSelectorType
-        arguments: ["@doctrine.orm.entity_manager"]
-        tags:
-                - { name:     form.type, alias: issue_selector }
-
                    -
                    -
                    • -
                  • XML
                    <service id="acme_demo.type.issue_selector" class="Acme\TaskBundle\Form\Type\IssueSelectorType">
-    <argument type="service" id="doctrine.orm.entity_manager"/>
-    <tag name="form.type" alias="issue_selector" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->setDefinition('acme_demo.type.issue_selector', array(
-        new Reference('doctrine.orm.entity_manager'),
-    ))
-    ->addTag('form.type', array(
-        'alias' => 'issue_selector',
-    ))
-;
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, cada vez que necesites utilizar tu tipo de campo issue_selector especial, es muy fácil:

                  -
                  // src/Acme/TaskBundle/Form/Type/TaskType.php
-namespace Acme\TaskBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-
-class TaskType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('task')
-            ->add('dueDate', null, array('widget' => 'single_text'));
-            ->add('issue', 'issue_selector');
-    }
-
-    public function getName()
-    {
-        return 'task';
-    }
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/dynamic_form_generation.html b/cookbook/form/dynamic_form_generation.html deleted file mode 100644 index 014b9a0..0000000 --- a/cookbook/form/dynamic_form_generation.html +++ /dev/null @@ -1,243 +0,0 @@ - - - - - - - Cómo generar formularios dinámicamente usando eventos del formulario — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo generar formularios dinámicamente usando eventos del formulario

                  -

                  Antes de zambullirte en la generación dinámica de formularios, hagamos una rápida revisión de lo que es una clase formulario desnuda:

                  -
                  // src/Acme/DemoBundle/Form/Type/ProductType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-
-class ProductType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('name');
-        $builder->add('price');
-    }
-
-    public function getName()
-    {
-        return 'product';
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Si esta sección de código en particular no te es familiar, probablemente necesites dar un paso atrás y revisar en primer lugar el Capítulo de Formularios antes de continuar.

                  -
                  -

                  Asumiremos por un momento que este formulario utiliza una clase imaginaria «Product» que únicamente tiene dos propiedades relevantes (name y price). El formulario generado de esta clase a toda costa se verá exactamente igual si estás creando un nuevo Producto o si estás editando un producto existente (p. ej. un producto recuperado de la base de datos).

                  -

                  Ahora, supongamos que no deseas que el usuario pueda cambiar el valor del name una vez creado el objeto. Para ello, puedes confiar en el sistema Despachador de eventos de Symfony para analizar los datos en el objeto y modificar el formulario basándose en los datos del objeto Producto. En este artículo, aprenderás cómo añadir este nivel de flexibilidad a tus formularios.

                  -
                  -

                  Añadiendo un suscriptor de evento a una clase formulario

                  -

                  Por lo tanto, en lugar de añadir directamente el elemento gráfico name vía tu clase formulario ProductType, vas a delegar la responsabilidad de crear este campo en particular a un suscriptor de evento:

                  -
                  // src/Acme/DemoBundle/Form/Type/ProductType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Acme\DemoBundle\Form\EventListener\AddNameFieldSubscriber;
-
-class ProductType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('price');
-
-        $builder->addEventSubscriber(new AddNameFieldSubscriber());
-    }
-
-    public function getName()
-    {
-        return 'product';
-    }
-}
-
                  -
                  -
                  -
                  -

                  Dentro de la clase suscriptor de eventos

                  -

                  El objetivo es crear el campo «name» únicamente si el objeto Producto subyacente es nuevo (por ejemplo, no se ha persistido a la base de datos). Basándose en esto, el suscriptor podría tener la siguiente apariencia:

                  -

                  -Nuevo en la versión 2.2: La habilidad de pasar una cadena al método FormInterface::add se añadió en Symfony 2.2.

                  -
                  // src/Acme/DemoBundle/Form/EventListener/AddNameFieldSubscriber.php
-namespace Acme\DemoBundle\Form\EventListener;
-
-use Symfony\Component\Form\FormEvent;
-use Symfony\Component\Form\FormEvents;
-use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-
-class AddNameFieldSubscriber implements EventSubscriberInterface
-{
-    public static function getSubscribedEvents()
-    {
-        // Informa al despachador que deseas escuchar el evento
-        // form.pre_set_data y se debe llamar al método 'preSetData'.
-        return array(FormEvents::PRE_SET_DATA => 'preSetData');
-    }
-
-    public function preSetData(FormEvent $event)
-    {
-        $data = $event->getData();
-        $form = $event->getForm();
-
-        // Durante la creación del formulario setData() es llamado con null como
-        // argumento por el constructor FormBuilder. Solo te interesa cuando
-        // setData es llamado con un objeto Entity real (ya sea nuevo,
-        // o recuperado con Doctrine). Esta declaración 'if' permite evadir
-        // la condición null.
-        if (null === $data) {
-            return;
-        }
-
-        // comprueba si el objeto producto es "nuevo"
-        if (!$data->getId()) {
-            $form->add('name', 'text');
-        }
-    }
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  Es fácil malinterpretar el propósito del segmento if (null === $data) de este suscriptor de eventos. Para comprender plenamente su papel, también podrías considerar echarle un vistazo a la clase Form prestando especial atención a donde se llama a setData() al final del constructor, así como al método setData() en sí mismo.

                  -
                  -

                  La línea FormEvents::PRE_SET_DATA en realidad se resuelve en la cadena form.pre_set_data. -La clase FormEvents sirve a un propósito organizacional. Se trata de una ubicación centralizada en la cual puedes encontrar todos los eventos de formulario disponibles.

                  -

                  Si bien este ejemplo podría haber utilizado eficientemente el evento form.post_set_data, al usar form.pre_set_data garantizas que el dato recuperado desde el objeto Event no tiene manera alguna de ser modificado por ningún otro suscriptor o escucha debido a que form.pre_set_data es el primer evento remitido por el formulario.

                  -
                  -

                  Nota

                  -

                  Puedes ver la lista completa de eventos de formulario vía la clase FormEvents, del paquete form.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 29, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/dynamic_form_modification.html b/cookbook/form/dynamic_form_modification.html deleted file mode 100644 index ff9a06f..0000000 --- a/cookbook/form/dynamic_form_modification.html +++ /dev/null @@ -1,711 +0,0 @@ - - - - - - - How to Dynamically Modify Forms Using Form Events — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  How to Dynamically Modify Forms Using Form Events

                  -

                  Often times, a form can’t be created statically. In this entry, you’ll learn -how to customize your form based on three common use-cases:

                  -
                    -
                  1. Customizing your Form based on the underlying Data
                    2. -
                  -

                  Ejemplo: you have a “Product” form and need to modify/add/remove a field -based on the data on the underlying Product being edited.

                  -
                    -
                  1. How to Dynamically Generate Forms based on user Data
                    2. -
                  -

                  Ejemplo: you create a “Friend Message” form and need to build a drop-down -that contains only users that are friends with the current authenticated -user.

                  -
                    -
                  1. Dynamic generation for submitted Forms
                    2. -
                  -

                  Ejemplo: on a registration form, you have a “country” field and a “state” -field which should populate dynamically based on the value in the “country” -field.

                  -
                  -

                  Customizing your Form based on the underlying Data

                  -

                  Antes de zambullirte en la generación dinámica de formularios, hagamos una rápida revisión de lo que es una clase formulario desnuda:

                  -
                  // src/Acme/DemoBundle/Form/Type/ProductType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class ProductType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('name');
-        $builder->add('price');
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'data_class' => 'Acme\DemoBundle\Entity\Product'
-        ));
-    }
-
-    public function getName()
-    {
-        return 'product';
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Si esta sección de código en particular no te es familiar, probablemente necesites dar un paso atrás y en primer lugar revisar el Capítulo de formularios antes de continuar.

                  -
                  -

                  Assume for a moment that this form utilizes an imaginary “Product” class -that has only two properties (“name” and “price”). The form generated from -this class will look the exact same regardless if a new Product is being created -or if an existing product is being edited (e.g. a product fetched from the database).

                  -

                  Ahora, supongamos que no deseas que el usuario pueda cambiar el valor del name una vez creado el objeto. Para ello, puedes confiar en el sistema Despachador de eventos de Symfony para analizar los datos en el objeto y modificar el formulario basándote en los datos del objeto Producto. En este artículo, aprenderás cómo añadir este nivel de flexibilidad a tus formularios.

                  -
                  -

                  Adding An Event Subscriber To A Form Class

                  -

                  Por lo tanto, en lugar de añadir directamente el elemento gráfico name vía tu clase formulario ProductType, vas a delegar la responsabilidad de crear este campo en particular a un suscriptor de evento:

                  -
                  // src/Acme/DemoBundle/Form/Type/ProductType.php
-namespace Acme\DemoBundle\Form\Type;
-
-// ...
-use Acme\DemoBundle\Form\EventListener\AddNameFieldSubscriber;
-
-class ProductType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('price');
-
-        $builder->addEventSubscriber(new AddNameFieldSubscriber());
-    }
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Inside the Event Subscriber Class

                  -

                  El objetivo es crear el campo «name» únicamente si el objeto Producto subyacente es nuevo (por ejemplo, no se ha persistido a la base de datos). Basándose en esto, el suscriptor podría tener la siguiente apariencia:

                  -

                  -Nuevo en la versión 2.2: La habilidad de pasar una cadena al método FormInterface::add se añadió en Symfony 2.2.

                  -
                  // src/Acme/DemoBundle/Form/EventListener/AddNameFieldSubscriber.php
-namespace Acme\DemoBundle\Form\EventListener;
-
-use Symfony\Component\Form\FormEvent;
-use Symfony\Component\Form\FormEvents;
-use Symfony\Component\EventDispatcher\EventSubscriberInterface;
-
-class AddNameFieldSubscriber implements EventSubscriberInterface
-{
-    public static function getSubscribedEvents()
-    {
-        // Informa al despachador que deseas escuchar el evento
-        // form.pre_set_data y se debe llamar al método 'preSetData'.
-        return array(FormEvents::PRE_SET_DATA => 'preSetData');
-    }
-
-    public function preSetData(FormEvent $event)
-    {
-        $data = $event->getData();
-        $form = $event->getForm();
-
-        // check if the product object is "new"
-        // If you didn't pass any data to the form, the data is "null".
-        // This should be considered a new "Product"
-        if (!$data || !$data->getId()) {
-            $form->add('name', 'text');
-        }
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  The FormEvents::PRE_SET_DATA line actually resolves to the string -form.pre_set_data. Symfony\Component\Form\FormEvents serves -an organizational purpose. It is a centralized location in which you can -find all of the various form events available.

                  -
                  -
                  -

                  Nota

                  -

                  You can view the full list of form events via the Symfony\Component\Form\FormEvents -class.

                  -
                  -
                  -
                  -
                  -

                  How to Dynamically Generate Forms based on user Data

                  -

                  Sometimes you want a form to be generated dynamically based not only on data -from the form but also on something else - like some data from the current user. -Suppose you have a social website where a user can only message people who -are his friends on the website. In this case, a “choice list” of whom to message -should only contain users that are the current user’s friends.

                  -
                  -

                  Creating the Form Type

                  -

                  Using an event listener, your form might look like this:

                  -
                  // src/Acme/DemoBundle/Form/Type/FriendMessageFormType.php
-namespace Acme\DemoBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\Form\FormEvents;
-use Symfony\Component\Form\FormEvent;
-use Symfony\Component\Security\Core\SecurityContext;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class FriendMessageFormType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('subject', 'text')
-            ->add('body', 'textarea')
-        ;
-        $builder->addEventListener(FormEvents::PRE_SET_DATA, function(FormEvent $event){
-            // ... add a choice list of friends of the current application user
-        });
-    }
-
-    public function getName()
-    {
-        return 'acme_friend_message';
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-    }
-}
-
                  -
                  -

                  The problem is now to get the current user and create a choice field that -contains only this user’s friends.

                  -

                  Luckily it is pretty easy to inject a service inside of the form. This can be -done in the constructor:

                  -
                  private $securityContext;
-
-public function __construct(SecurityContext $securityContext)
-{
-    $this->securityContext = $securityContext;
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  You might wonder, now that you have access to the User (through the security -context), why not just use it directly in buildForm and omit the -event listener? This is because doing so in the buildForm method -would result in the whole form type being modified and not just this -one form instance. This may not usually be a problem, but technically -a single form type could be used on a single request to create many forms -or fields.

                  -
                  -
                  -
                  -

                  Customizing the Form Type

                  -

                  Now that you have all the basics in place you an take advantage of the securityContext -and fill in the listener logic:

                  -
                  // src/Acme/DemoBundle/FormType/FriendMessageFormType.php
-
-use Symfony\Component\Security\Core\SecurityContext;
-use Doctrine\ORM\EntityRepository;
-// ...
-
-class FriendMessageFormType extends AbstractType
-{
-    private $securityContext;
-
-    public function __construct(SecurityContext $securityContext)
-    {
-        $this->securityContext = $securityContext;
-    }
-
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('subject', 'text')
-            ->add('body', 'textarea')
-        ;
-
-        // grab the user, do a quick sanity check that one exists
-        $user = $this->securityContext->getToken()->getUser();
-        if (!$user) {
-            throw new \LogicException(
-                'The FriendMessageFormType cannot be used without an authenticated user!'
-            );
-        }
-
-        $factory = $builder->getFormFactory();
-
-        $builder->addEventListener(
-            FormEvents::PRE_SET_DATA,
-            function(FormEvent $event) use($user, $factory){
-                $form = $event->getForm();
-
-                $formOptions = array(
-                    'class' => 'Acme\DemoBundle\Entity\User',
-                    'multiple' => false,
-                    'expanded' => false,
-                    'property' => 'fullName',
-                    'query_builder' => function(EntityRepository $er) use ($user) {
-                        // build a custom query, or call a method on your repository (even better!)
-                    },
-                );
-
-                // create the field, this is similar the $builder->add()
-                // field name, field type, data, options
-                $form->add($factory->createNamed('friend', 'entity', null, $formOptions));
-            }
-        );
-    }
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Using the Form

                  -

                  Our form is now ready to use and there are two possible ways to use it inside -of a controller:

                  -
                    -
                  1. create it manually and remember to pass the security context to it;
                    2. -
                  -

                  o

                  -
                    -
                  1. define it as a service.
                    2. -
                  -
                  -

                  a) Creating the Form manually

                  -

                  This is very simple, and is probably the better approach unless you’re using -your new form type in many places or embedding it into other forms:

                  -
                  class FriendMessageController extends Controller
-{
-    public function newAction(Request $request)
-    {
-        $securityContext = $this->container->get('security.context');
-        $form = $this->createForm(
-            new FriendMessageFormType($securityContext)
-        );
-
-        // ...
-    }
-}
-
                  -
                  -
                  -
                  -

                  b) Defining the Form as a Service

                  -

                  To define your form as a service, just create a normal service and then tag -it with form.type.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-services:
-    acme.form.friend_message:
-        class: Acme\DemoBundle\Form\Type\FriendMessageFormType
-        arguments: [@security.context]
-        tags:
-            -
-                name: form.type
-                alias: acme_friend_message
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-    <services>
-    <service id="acme.form.friend_message" class="Acme\DemoBundle\Form\Type\FriendMessageFormType">
-        <argument type="service" id="security.context" />
-        <tag name="form.type" alias="acme_friend_message" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$definition = new Definition('Acme\DemoBundle\Form\Type\FriendMessageFormType');
-$definition->addTag('form.type', array('alias' => 'acme_friend_message'));
-$container->setDefinition(
-    'acme.form.friend_message',
-    $definition,
-    array('security.context')
-);
-
                    -
                    -
                    • -
                  -
                  -

                  If you wish to create it from within a controller or any other service that has -access to the form factory, you then use:

                  -
                  class FriendMessageController extends Controller
-{
-    public function newAction(Request $request)
-    {
-        $form = $this->createForm('acme_friend_message');
-
-        // ...
-    }
-}
-
                  -
                  -

                  You can also easily embed the form type into another form:

                  -
                  // inside some other "form type" class
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    $builder->add('message', 'acme_friend_message');
-}
-
                  -
                  -
                  -
                  -
                  -
                  -

                  Dynamic generation for submitted Forms

                  -

                  Another case that can appear is that you want to customize the form specific to -the data that was submitted by the user. For example, imagine you have a registration -form for sports gatherings. Some events will allow you to specify your preferred -position on the field. This would be a choice field for example. However the -possible choices will depend on each sport. Football will have attack, defense, -goalkeeper etc... Baseball will have a pitcher but will not have goalkeeper. You -will need the correct options to be set in order for validation to pass.

                  -

                  The meetup is passed as an entity hidden field to the form. So we can access each -sport like this:

                  -
                  // src/Acme/DemoBundle/Form/Type/SportMeetupType.php
-class SportMeetupType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('number_of_people', 'text')
-            ->add('discount_coupon', 'text')
-        ;
-        $factory = $builder->getFormFactory();
-
-        $builder->addEventListener(
-            FormEvents::PRE_SET_DATA,
-            function(FormEvent $event) use($user, $factory){
-                $form = $event->getForm();
-
-                // this would be your entity, i.e. SportMeetup
-                $data = $event->getData();
-
-                $positions = $data->getSport()->getAvailablePositions();
-
-                // ... proceed with customizing the form based on available positions
-            }
-        );
-    }
-}
-
                  -
                  -

                  When you’re building this form to display to the user for the first time, -then this example works perfectly.

                  -

                  However, things get more difficult when you handle the form submission. This -is be cause the PRE_SET_DATA event tells us the data that you’re starting -with (e.g. an empty SportMeetup object), not the submitted data.

                  -

                  On a form, we can usually listen to the following events:

                  -
                    -
                  • PRE_SET_DATA
                    • -
                  • POST_SET_DATA
                    • -
                  • PRE_BIND
                    • -
                  • BIND
                    • -
                  • POST_BIND
                    • -
                  -

                  When listening to BIND and POST_BIND, it’s already “too late” to make -changes to the form. Fortunately, PRE_BIND is perfect for this. There -is, however, a big difference in what $event->getData() returns for each -of these events. Specifically, in PRE_BIND, $event->getData() returns -the raw data submitted by the user.

                  -

                  This can be used to get the SportMeetup id and retrieve it from the database, -given you have a reference to the object manager (if using doctrine). In -the end, you have an event subscriber that listens to two different events, -requires some external services and customizes the form. In such a situation, -it’s probably better to define this as a service rather than using an anonymouse -function as the event listener callback.

                  -

                  The subscriber would now look like:

                  -
                  // src/Acme/DemoBundle/Form/EventListener/RegistrationSportListener.php
-namespace Acme\DemoBundle\Form\EventListener;
-
-use Symfony\Component\Form\FormFactoryInterface;
-use Doctrine\ORM\EntityManager;
-use Symfony\Component\Form\FormEvent;
-
-class RegistrationSportListener implements EventSubscriberInterface
-{
-    /**
-     * @var FormFactoryInterface
-     */
-    private $factory;
-
-    /**
-     * @var EntityManager
-     */
-    private $om;
-
-    /**
-     * @param factory FormFactoryInterface
-     */
-    public function __construct(FormFactoryInterface $factory, EntityManager $om)
-    {
-            $this->factory = $factory;
-        $this->om = $om;
-    }
-
-    public static function getSubscribedEvents()
-    {
-        return array(
-            FormEvents::PRE_BIND => 'preBind',
-            FormEvents::PRE_SET_DATA => 'preSetData',
-        );
-    }
-
-    /**
-     * @param event FormEvent
-     */
-    public function preSetData(FormEvent $event)
-    {
-        $meetup = $event->getData()->getMeetup();
-
-        // Before binding the form, the "meetup" will be null
-        if (null === $meetup) {
-            return;
-        }
-
-        $form = $event->getForm();
-        $positions = $meetup->getSport()->getPositions();
-
-        $this->customizeForm($form, $positions);
-    }
-
-    public function preBind(FormEvent $event)
-    {
-        $data = $event->getData();
-        $id = $data['event'];
-        $meetup = $this->om
-            ->getRepository('AcmeDemoBundle:SportMeetup')
-            ->find($id);
-
-        if ($meetup === null) {
-            $msg = 'The event %s could not be found for you registration';
-            throw new \Exception(sprintf($msg, $id));
-        }
-        $form = $event->getForm();
-        $positions = $meetup->getSport()->getPositions();
-
-        $this->customizeForm($form, $positions);
-    }
-
-    protected function customizeForm($form, $positions)
-    {
-        // ... customize the form according to the positions
-    }
-}
-
                  -
                  -

                  You can see that you need to listen on these two events and have different callbacks -only because in two different scenarios, the data that you can use is given in a -different format. Other than that, this class always performs exactly the same -things on a given form.

                  -

                  Now that you have that setup, register your form and the listener as services:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-acme.form.sport_meetup:
-    class: Acme\SportBundle\Form\Type\SportMeetupType
-    arguments: [@acme.form.meetup_registration_listener]
-    tags:
-            - { name:     form.type, alias: acme_meetup_registration }
-acme.form.meetup_registration_listener
-    class: Acme\SportBundle\Form\EventListener\RegistrationSportListener
-    arguments: [@form.factory, @doctrine]
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-    <services>
-    <service id="acme.form.sport_meetup" class="Acme\SportBundle\FormType\SportMeetupType">
-        <argument type="service" id="acme.form.meetup_registration_listener" />
-        <tag name="form.type" alias="acme_meetup_registration" />
-    </service>
-    <service id="acme.form.meetup_registration_listener" class="Acme\SportBundle\Form\EventListener\RegistrationSportListener">
-        <argument type="service" id="form.factory" />
-        <argument type="service" id="doctrine" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$definition = new Definition('Acme\SportBundle\Form\Type\SportMeetupType');
-$definition->addTag('form.type', array('alias' => 'acme_meetup_registration'));
-$container->setDefinition(
-    'acme.form.meetup_registration_listener',
-    $definition,
-    array('security.context')
-);
-$definition = new Definition('Acme\SportBundle\Form\EventListener\RegistrationSportListener');
-$container->setDefinition(
-    'acme.form.meetup_registration_listener',
-    $definition,
-    array('form.factory', 'doctrine')
-);
-
                    -
                    -
                    • -
                  -
                  -

                  In this setup, the RegistrationSportListener will be a constructor argument -to SportMeetupType. You can then register it as an event subscriber on -your form:

                  -
                  private $registrationSportListener;
-
-public function __construct(RegistrationSportListener $registrationSportListener)
-{
-    $this->registrationSportListener = $registrationSportListener;
-}
-
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    // ...
-    $subscriber = new AddNameFieldSubscriber($builder->getFormFactory());
-    $builder->addEventSubscriber($this->registrationSportListener);
-}
-
                  -
                  -

                  And this should tie everything together. You can now retrieve your form from the -controller, display it to a user, and validate it with the right choice options -set for every possible kind of sport that our users are registering for.

                  -

                  One piece that may still be missing is the client-side updating of your form -after the sport is selected. This should be handled by making an AJAX call -back to your application. In that controller, you can bind your form, but -instead of processing it, simply use the bound form to render the updated -fields. The response from the AJAX call can then be used to update the view.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/form_collections.html b/cookbook/form/form_collections.html deleted file mode 100644 index a8ad8cf..0000000 --- a/cookbook/form/form_collections.html +++ /dev/null @@ -1,691 +0,0 @@ - - - - - - - Cómo integrar una colección de formularios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo integrar una colección de formularios

                  -

                  En este artículo, aprenderás cómo crear un formulario que integra una colección de muchos otros formularios. Esto podría ser útil, por ejemplo, si tienes una clase Tarea y quieres crear/editar/eliminar muchos objetos Etiqueta relacionados con esa Tarea, justo dentro del mismo formulario.

                  -
                  -

                  Nota

                  -

                  En este artículo, vagamente asume que estás utilizando Doctrine como almacén de base de datos. Pero si no estás usando Doctrine (por ejemplo, Propel o simplemente una conexión directa a la base de datos), es casi lo mismo. Sólo hay unas cuantas partes de esta guía que realmente se preocupan de la «persistencia».

                  -

                  Si estás utilizando Doctrine, tienes que añadir los metadatos de Doctrine, incluyendo el asociación MuchosAMuchos en la definición de asignación en la propiedad tags de la Tarea.

                  -
                  -

                  Vamos a empezar por ahí: Supongamos que cada Tarea pertenece a múltiples objetos Tags. Empieza creando una sencilla clase Tarea:

                  -
                  // src/Acme/TaskBundle/Entity/Task.php
-namespace Acme\TaskBundle\Entity;
-
-use Doctrine\Common\Collections\ArrayCollection;
-
-class Task
-{
-    protected $description;
-
-    protected $tags;
-
-    public function __construct()
-    {
-        $this->tags = new ArrayCollection();
-    }
-
-    public function getDescription()
-    {
-        return $this->description;
-    }
-
-    public function setDescription($description)
-    {
-        $this->description = $description;
-    }
-
-    public function getTags()
-    {
-        return $this->tags;
-    }
-
-    public function setTags(ArrayCollection $tags)
-    {
-        $this->tags = $tags;
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  El ArrayCollection es específico de Doctrine y básicamente es lo mismo que usar un arreglo (pero este debe ser un ArrayCollection) si estás usando Doctrine.

                  -
                  -

                  Ahora, crea una clase Etiqueta. Cómo vimos arriba, una Tarea puede tener muchos objetos Etiqueta:

                  -
                  // src/Acme/TaskBundle/Entity/Tag.php
-namespace Acme\TaskBundle\Entity;
-
-class Tag
-{
-    public $name;
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Aquí, la propiedad name es pública, pero fácilmente puede ser protegida o privada (pero entonces necesitaríamos métodos getName y setName).

                  -
                  -

                  Ahora veamos los formularios. Crea una clase formulario para que el usuario pueda modificar un objeto Tag:

                  -
                  // src/Acme/TaskBundle/Form/Type/TagType.php
-namespace Acme\TaskBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class TagType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('name');
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'data_class' => 'Acme\TaskBundle\Entity\Tag',
-        ));
-    }
-
-    public function getName()
-    {
-        return 'tag';
-    }
-}
-
                  -
                  -

                  Con esto, tienes suficiente para que una etiqueta de formulario se dibuje por sí misma. Pero debido a que el objetivo final es permitir que las etiquetas de una Tarea sean modificadas directamente dentro del formulario de la tarea en sí mismo, crea un formulario para la clase Tarea.

                  -

                  Ten en cuenta que integraste una colección de formularios TagType usando el tipo de campo collection:

                  -
                  // src/Acme/TaskBundle/Form/Type/TaskType.php
-namespace Acme\TaskBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class TaskType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder->add('description');
-
-        $builder->add('tags', 'collection', array('type' => new TagType()));
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'data_class' => 'Acme\TaskBundle\Entity\Task',
-        ));
-    }
-
-    public function getName()
-    {
-        return 'task';
-    }
-}
-
                  -
                  -

                  En tu controlador, ahora tendrás que iniciar una nueva instancia de TaskType:

                  -
                  // src/Acme/TaskBundle/Controller/TaskController.php
-namespace Acme\TaskBundle\Controller;
-
-use Acme\TaskBundle\Entity\Task;
-use Acme\TaskBundle\Entity\Tag;
-use Acme\TaskBundle\Form\Type\TaskType;
-use Symfony\Component\HttpFoundation\Request;
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class TaskController extends Controller
-{
-    public function newAction(Request $request)
-    {
-        $task = new Task();
-
-        // código ficticio - esto está aquí sólo para que la tarea tenga algunas
-        // etiquetas, de lo contrario, este no sería un ejemplo interesante
-        $tag1 = new Tag();
-        $tag1->name = 'tag1';
-        $task->getTags()->add($tag1);
-        $tag2 = new Tag();
-        $tag2->name = 'tag2';
-        $task->getTags()->add($tag2);
-        // termina el código maniquí
-
-        $form = $this->createForm(new TaskType(), $task);
-
-        // procesa el formulario en POST
-        if ($request->isMethod('POST')) {
-            $form->bind($request);
-            if ($form->isValid()) {
-                // posiblemente hagas algún procesamiento del formulario,
-                // tal como guardar los objetos Task y Tag
-            }
-        }
-
-        return $this->render('AcmeTaskBundle:Task:new.html.twig', array(
-            'form' => $form->createView(),
-        ));
-    }
-}
-
                  -
                  -

                  La plantilla correspondiente, ahora es capaz de reproducir tanto el campo descripción del formulario de Tarea, así como todos los formularios TagType de las etiquetas que ya están relacionados con esta Tarea. En el controlador anterior, agregamos cierto código ficticio para poder ver esto en acción (debido a que una tarea tiene cero etiquetas al crearla por primera vez).

                  -
                  -
                    -
                  • Twig
                    {# src/Acme/TaskBundle/Resources/views/Task/new.html.twig #}
-
-{# ... #}
-
-<form action="..." method="POST" {{ form_enctype(form) }}>
-    {# reproduce únicamente los campos task: descripción #}
-    {{ form_row(form.description) }}
-
-    <h3>Tags</h3>
-    <ul class="tags">
-        {# itera sobre cada etiqueta existente y reproduce su único campo: name #}
-        {% for tag in form.tags %}
-            <li>{{ form_row(tag.name) }}</li>
-        {% endfor %}
-    </ul>
-
-    {{ form_rest(form) }}
-    {# ... #}
-</form>
-
                    -
                    -
                    • -
                  • PHP
                    <!-- src/Acme/TaskBundle/Resources/views/Task/new.html.php -->
-
-<!-- ... -->
-
-<form action="..." method="POST" ...>
-    <h3>Tags</h3>
-    <ul class="tags">
-        <?php foreach($form['tags'] as $tag): ?>
-            <li><?php echo $view['form']->row($tag['name']) ?></li>
-        <?php endforeach; ?>
-    </ul>
-
-    <?php echo $view['form']->rest($form) ?>
-</form>
-
-<!-- ... -->
                    -
                    -
                    • -
                  -
                  -

                  Cuando el usuario envía el formulario, los datos presentados por los campos Tag se utilizan para construir un ArrayCollection de los objetos Tag, que luego se establecen en el campo tag de la instancia Tarea.

                  -

                  La colección Tags, naturalmente, es accesible a través de $task->getTags() y se puede persistir en la base de datos o utilizar donde sea necesaria.

                  -

                  Hasta el momento, esto funciona muy bien, pero aún no te permite agregar dinámicamente nuevas etiquetas o eliminar existentes. Por lo tanto, durante la edición de etiquetas existentes funcionará bien, tu usuario en realidad no puede añadir ninguna nueva etiqueta, todavía.

                  -
                  -

                  Prudencia

                  -

                  En esta entrada, integraste una sola colección, pero de ninguna manera estás limitado a esto. También puedes integrar colecciones anidadas con tantos niveles descendientes como quieras. Pero si utilizas XDebug en tu configuración de desarrollo, puedes recibir un error La función alcanzó el máximo nivel de anidamiento de «100», ¡abortando!. -Esto se debe a la opción xdebug.max_nesting_level de PHP, que por omisión es de 100.

                  -

                  Esta directiva limita la recursividad a 100 llamadas que pueden no ser suficientes para reproducir el formulario en la plantilla si pintas todo el formulario de una vez (por ejemplo, form_widget(form)). Para solucionar este problema puedes redefinir esta directiva a un valor más alto (ya sea a través de un archivo ini de PHP o por medio de ini_set, por ejemplo, en app/autoload.php) o pintar cada campo del formulario a mano usando form_row.

                  -
                  -
                  -

                  Permitiendo «nuevas» etiquetas con «prototype»

                  -

                  Permitir al usuario añadir nuevas etiquetas dinámicamente significa que necesitarás usar algo de JavaScript. Anteriormente añadiste dos etiquetas a tu formulario en el controlador. -Now let the user add as many tag forms as he needs directly in the browser. -Esto se hará a través de un poco de JavaScript.

                  -

                  Lo primero que tienes que hacer es darle a conocer la colección del formulario que va a recibir una cantidad desconocida de etiquetas. Hasta ahora, añadiste dos etiquetas y el tipo de formulario espera recibir exactamente dos, de lo contrario lanzará un error: -Este formulario no debe contener campos adicionales. Para que esto sea flexible, añade la opción allow_add a tu campo colección:

                  -
                  // src/Acme/TaskBundle/Form/Type/TaskType.php
-
-// ...
-
-use Symfony\Component\Form\FormBuilderInterface;
-
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    $builder->add('description');
-
-    $builder->add('tags', 'collection', array(
-        'type'         => new TagType(),
-        'allow_add'    => true,
-        'by_reference' => false,
-    ));
-}
-
                  -
                  -

                  Ten en cuenta que también se añadió 'by_reference' => false. Normalmente, la plataforma de formularios modificaría las etiquetas en un objeto Tarea sin llamar en realidad a setTags. Al configurar by_reference a false, llamará a setTags. Esto, como verás, será muy importante más adelante.

                  -

                  Además de decirle al campo que acepte cualquier número de objetos presentados, allow_add también pone a tu disposición una variable «prototipo». Este «prototipo» es como una «plantilla» que contiene todo el código HTML necesario para poder pintar cualquier nueva etiqueta del formulario. Para ello, haz el siguiente cambio en tu plantilla:

                  -
                  -
                    -
                  • Twig
                    <ul class="tags" data-prototype="{{ form_widget(form.tags.vars.prototype)|e }}">
-    ...
-</ul>
-
                    -
                    -
                    • -
                  • PHP
                    <ul class="tags" data-prototype="<?php echo $view->escape($view['form']->row($form['tags']->vars['prototype'])) ?>">
-    ...
-</ul>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Si pintas todas tus etiquetas en subformularios simultáneamente (por ejemplo, form_row(form.tags)), entonces el prototipo estará disponible automáticamente en el div externo como el atributo data-prototype, similar a lo que ves arriba.

                  -
                  -
                  -

                  Truco

                  -

                  The form.tags.vars.prototype is a form element that looks and feels just -like the individual form_widget(tag) elements inside your for loop. -This means that you can call form_widget, form_row or form_label -on it. Incluso, puedes optar por pintar sólo uno de tus campos (por ejemplo, el campo nombre):

                  -
                  {{ form_widget(form.tags.vars.prototype.name)|e }}
-
                  -
                  -
                  -

                  En la página producida, el resultado será muy parecido a este:

                  -
                  <ul class="tags" data-prototype="&lt;div&gt;&lt;label class=&quot; required&quot;&gt;__name__&lt;/label&gt;&lt;div id=&quot;task_tags___name__&quot;&gt;&lt;div&gt;&lt;label for=&quot;task_tags___name___name&quot; class=&quot; required&quot;&gt;Name&lt;/label&gt;&lt;input type=&quot;text&quot; id=&quot;task_tags___name___name&quot; name=&quot;task[tags][__name__][name]&quot; required=&quot;required&quot; maxlength=&quot;255&quot; /&gt;&lt;/div&gt;&lt;/div&gt;&lt;/div&gt;">
-
                  -
                  -

                  El objetivo de esta sección es usar JavaScript para leer este atributo y agregar dinámicamente nuevas etiquetas al formulario cuando el usuario haga clic en un enlace «Agregar una etiqueta». -Para simplificar las cosas, este ejemplo usa jQuery y supone que lo has incluido en algún lugar de tu página.

                  -

                  Añade un elemento <script> en algún lugar de tu página para que puedas empezar escribir algún JavaScript.

                  -

                  En primer lugar, añade un enlace a la parte inferior de la lista de «tags» a través de JavaScript. En segundo lugar, vincula el evento click de ese enlace para que puedas añadir una nueva etiqueta al formulario (con addTagForm tal como se muestra a continuación):

                  -
                  // Obtiene la ul que contiene la colección de etiquetas
-var collectionHolder = $('ul.tags');
-
-// configura una enlace "Agregar una etiqueta"
-var $addTagLink = $('<a href="#" class="add_tag_link">Add a tag</a>');
-var $newLinkLi = $('<li></li>').append($addTagLink);
-
-jQuery(document).ready(function() {
-    // Añade el ancla "Agregar una etiqueta" y las etiquetas li y ul
-    collectionHolder.append($newLinkLi);
-
-    // cuenta las entradas actuales en el formulario (p. ej. 2),
-    // la usa como índice al insertar un nuevo elemento (p. ej. 2)
-    collectionHolder.data('index', collectionHolder.find(':input').length);
-
-    $addTagLink.on('click', function(e) {
-        // evita crear el enlace con una "#" en la URL
-        e.preventDefault();
-
-        // añade una nueva etiqueta form (ve el siguiente bloque de código)
-        addTagForm(collectionHolder, $newLinkLi);
-    });
-});
-
                  -
                  -

                  El trabajo de la función addTagForm será el de utilizar el atributo data-prototype para agregar dinámicamente un nuevo formulario cuando se haga clic en ese enlace. El HTML del data-prototype contiene el elemento input de la etiqueta text con el nombre de task[tags][__name__][nombre] ``y el identificador de ``task_tags___name___name. El __name__ es una especie de «comodín», que vamos a sustituir con un número incremental único (por ejemplo, task[tags][3][name]).

                  -

                  -Nuevo en la versión 2.1: El marcador de posición cambió de nombre de $$name$$ a __name__ en Symfony 2.1

                  -

                  El código real necesario para hacer que todo esto trabaje puede variar un poco, pero aquí está un ejemplo:

                  -
                  function addTagForm(collectionHolder, $newLinkLi) {
-    // Obtiene los datos del prototipo explicado anteriormente
-    var prototype = collectionHolder.data('prototype');
-
-    // Consigue el nuevo índice
-    var index = collectionHolder.data('index');
-
-    // Sustituye el '__name__' en el prototipo HTML para que
-    // en su lugar sea un número basado en cuántos elementos hay
-    var newForm = prototype.replace(/__name__/g, index);
-
-    // Incrementa en uno el índice para el siguiente elemento
-    collectionHolder.data('index', index + 1);
-
-    // Muestra el formulario en la página en un elemento li,
-    \\ antes del enlace 'Agregar una etiqueta'
-    var $newFormLi = $('<li></li>').append(newForm);
-    $newLinkLi.before($newFormLi);
-}
                  -
                  -
                  -

                  Nota

                  -

                  Es mejor separar tu JavaScript en archivos JavaScript reales que escribirlo dentro del HTML como se está haciendo aquí.

                  -
                  -

                  Ahora, cada vez que un usuario haga clic en el enlace Agregar una etiqueta, aparecerá un nuevo subformulario en la página. Cuando envíes el formulario, cualquier nueva etiqueta del formulario se convertirá en nuevos objetos Etiqueta y se añadirá a la propiedad etiquetas del objeto Tarea.

                  -
                  -

                  Doctrine: Las relaciona en cascada y guarda el lado «Inverso»

                  -

                  Para obtener las nuevas etiquetas para guardar en Doctrine, debes tener en cuenta un par de cosas más. En primer lugar, a menos que iteres sobre todos los nuevos objetos etiqueta y llames a $em->persist($tag) en cada una, recibirás un error de Doctrine:

                  -
                  -
                  Una nueva entidad se encontrará a través de la relación Acme\TaskBundle\Entity\Task#tags que no se ha configurado para persistirse en las operaciones en cascada de la entidad...
                  -

                  Para solucionar este problema, puedes optar por persistir automáticamente el objeto en la operación en «cascada» desde el objeto Task a cualquier etiqueta relacionada. Para ello, agrega la opción cascade a tus metadatos MuchosAMuchos:

                  -
                  -
                    -
                  • Annotations
                    // src/Acme/TaskBundle/Entity/Task.php
-
-// ...
-
-/**
- * @ORM\ManyToMany(targetEntity="Tag", cascade={"persist"})
- */
-protected $tags;
-
                    -
                    -
                    • -
                  • YAML
                    # src/Acme/TaskBundle/Resources/config/doctrine/Task.orm.yml
-Acme\TaskBundle\Entity\Task:
-    type: entity
-    # ...
-    oneToMany:
-        tags:
-            targetEntity: Tag
-            cascade:      [persist]
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/TaskBundle/Resources/config/doctrine/Task.orm.xml -->
-<doctrine-mapping xmlns="http://doctrine-project.org/schemas/orm/doctrine-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://doctrine-project.org/schemas/orm/doctrine-mapping
-                    http://doctrine-project.org/schemas/orm/doctrine-mapping.xsd">
-
-    <entity name="Acme\TaskBundle\Entity\Task" ...>
-        <!-- ... -->
-        <one-to-many field="tags" target-entity="Tag">
-            <cascade>
-                <cascade-persist />
-            </cascade>
-        </one-to-many>
-    </entity>
-</doctrine-mapping>
                    -
                    -
                    • -
                  -
                  -

                  El segundo problema potencial trata con el Lado propietario y lado inverso de las relaciones de Doctrine. En este ejemplo, si el lado «propietario» de la relación es la Tarea, entonces la persistencia no tendrá ningún problema puesto que las etiquetas se añaden correctamente a la tarea. Sin embargo, si el lado propietario es «Tag», entonces tendrás que trabajar un poco más para asegurarte de modificar el lado correcto de la relación.

                  -

                  El truco está en asegurarte de establecer una única «Tarea» en cada «Etiqueta». -Una forma fácil de hacerlo es añadir un poco de lógica adicional a setTags(), que es llamado por la infraestructura del formulario debido a que establece by_reference a false:

                  -
                  // src/Acme/TaskBundle/Entity/Task.php
-
-// ...
-
-public function setTags(ArrayCollection $tags)
-{
-    foreach ($tags as $tag) {
-        $tag->addTask($this);
-    }
-
-    $this->tags = $tags;
-}
-
                  -
                  -

                  En Tag, solo asegúrate de tener un método addTask:

                  -
                  // src/Acme/TaskBundle/Entity/Tag.php
-
-// ...
-
-public function addTask(Task $task)
-{
-    if (!$this->tasks->contains($task)) {
-        $this->tasks->add($task);
-    }
-}
-
                  -
                  -

                  Si tienes una relación UnoAMuchos, entonces la solución es similar, excepto que simplemente puedes llamar a setTask desde el interior de setTags.

                  -
                  -
                  -
                  -

                  Permitiendo la remoción de etiquetas

                  -

                  El siguiente paso es permitir la supresión de un elemento particular en la colección. -La solución es similar a permitir la adición de etiquetas.

                  -

                  Comienza agregando la opción allow_delete en el Tipo del formulario:

                  -
                  // src/Acme/TaskBundle/Form/Type/TaskType.php
-
-// ...
-use Symfony\Component\Form\FormBuilderInterface;
-
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    $builder->add('description');
-
-    $builder->add('tags', 'collection', array(
-        'type'         => new TagType(),
-        'allow_add'    => true,
-        'allow_delete' => true,
-        'by_reference' => false,
-    ));
-}
-
                  -
                  -
                  -

                  Modificaciones en plantillas

                  -

                  La opción allow_delete tiene una consecuencia: si un elemento de una colección no se envía en la presentación, los datos relacionados se quitan de la colección en el servidor. La solución a esto es eliminar el elemento del DOM del formulario.

                  -

                  En primer lugar, añade un enlace «eliminar esta etiqueta» a cada etiqueta del formulario:

                  -
                  jQuery(document).ready(function() {
-    // Añade un enlace para eliminar todas las etiquetas existentes
-    // en elementos li del formulario
-    collectionHolder.find('li').each(function() {
-        addTagFormDeleteLink($(this));
-    });
-
-    // ... el resto del bloque de arriba
-});
-
-function addTagForm() {
-    // ...
-
-    // Añade un enlace eliminar el nuevo formulario
-    addTagFormDeleteLink($newFormLi);
-}
-
                  -
                  -

                  La función addTagFormDeleteLink se verá similar a esta:

                  -
                  function addTagFormDeleteLink($tagFormLi) {
-    var $removeFormA = $('<a href="#">delete this tag</a>');
-    $tagFormLi.append($removeFormA);
-
-    $removeFormA.on('click', function(e) {
-        // evita crear el enlace con una "#" en la URL
-        e.preventDefault();
-
-        // quita el li de la etiqueta del formulario
-        $tagFormLi.remove();
-    });
-}
-
                  -
                  -

                  Cuando se quita una etiqueta del DOM del formulario y se envía, el objeto Etiqueta eliminado no se incluirá en la colección pasada a setTags. Dependiendo de tu capa de persistencia, esto puede o no ser suficiente para eliminar de hecho la relación entre la etiqueta retirada y el objeto Tarea.

                  -
                  -

                  Doctrine: Garantizando la persistencia en la base de datos

                  -

                  Al retirar objetos de esta manera, posiblemente necesites hacer un poco más de trabajo para asegurarte de que la relación entre la tarea y la etiqueta retirada se elimina correctamente.

                  -

                  En Doctrine, tienes dos lados de la relación: el lado propietario y el lado inverso. Normalmente, en este caso, tendrás una relación MuchosAMuchos y las etiquetas eliminadas desaparecerán y persistirán correctamente (añadiendo nuevas etiquetas también funciona sin esfuerzo).

                  -

                  Pero si tienes una relación UnoAMuchos o una MuchosAMuchos con un mappedBy en la entidad (significa que la Tarea es el lado «inverso»), tendrás que hacer más trabajo para eliminar las etiquetas persistidas correctamente.

                  -

                  En este caso, puedes modificar el controlador para eliminar la relación en las etiquetas eliminadas. Esto supone que tienes algún editAction, que se encarga de «actualizar» tu Tarea:

                  -
                  // src/Acme/TaskBundle/Controller/TaskController.php
-
-// ...
-
-public function editAction($id, Request $request)
-{
-    $em = $this->getDoctrine()->getManager();
-    $task = $em->getRepository('AcmeTaskBundle:Task')->find($id);
-
-    if (!$task) {
-        throw $this->createNotFoundException('No task found for is '.$id);
-    }
-
-    $originalTags = array();
-
-    // Crea un arreglo del los objetos 'Tag' actualmente en la base de datos
-    foreach ($task->getTags() as $tag) {
-        $originalTags[] = $tag;
-    }
-
-    $editForm = $this->createForm(new TaskType(), $task);
-
-    if ($request->isMethod('POST')) {
-        $editForm->bind($this->getRequest());
-
-        if ($editForm->isValid()) {
-
-            // filtra $originalTags para que contenga las etiquetas
-            // que ya no están presentes
-            foreach ($task->getTags() as $tag) {
-                foreach ($originalTags as $key => $toDel) {
-                    if ($toDel->getId() === $tag->getId()) {
-                        unset($originalTags[$key]);
-                    }
-                }
-            }
-
-            // Elimina la relación entre la etiqueta y la Tarea
-            foreach ($originalTags as $tag) {
-                // Elimina la Tarea de la Etiqueta
-                $tag->getTasks()->removeElement($task);
-
-                // Si se tratara de una relación MuchosAUno, elimina la relación con esto
-                // $tag->setTask(null);
-
-                $em->persist($tag);
-
-                // Si deseas eliminar la etiqueta completamente, también lo puedes hacer
-                // $em->remove($tag);
-            }
-
-            $em->persist($task);
-            $em->flush();
-
-            // Redirige de nuevo a alguna página de edición
-            return $this->redirect($this->generateUrl('task_edit', array('id' => $id)));
-        }
-    }
-
-    // pinta algún formulario en la plantilla
-}
-
                  -
                  -

                  Como puedes ver, agregar y quitar elementos correctamente puede ser complicado. -A menos que tengas una relación MuchosAMuchos donde la Tarea sea el lado «propietario», tendrás que hacer trabajo extra para asegurarte de que la relación se actualiza correctamente (si vas a añadir nuevas etiquetas o eliminar etiquetas existentes) en cada objeto Etiqueta en sí.

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/form_customization.html b/cookbook/form/form_customization.html deleted file mode 100644 index d15f413..0000000 --- a/cookbook/form/form_customization.html +++ /dev/null @@ -1,897 +0,0 @@ - - - - - - - Cómo personalizar la reproducción de un formulario — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo personalizar la reproducción de un formulario

                  -

                  Symfony ofrece una amplia variedad de formas para personalizar cómo se reproduce un formulario. -En esta guía, aprenderás cómo personalizar cada parte posible de tu formulario con el menor esfuerzo posible si utilizas Twig o PHP como tu motor de plantillas.

                  -
                  -

                  Fundamentos de la reproducción de formularios

                  -

                  Recuerda que label, error y los elementos gráficos HTML de un campo de formulario se pueden reproducir fácilmente usando la función form_row de Twig o el método ayudante row de PHP:

                  -
                  -
                    -
                  • Twig
                    {{ form_row(form.age) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->row($formulario['edad']) }} ?>
-
                    -
                    -
                    • -
                  -
                  -

                  También puedes reproducir cada una de las tres partes del campo individualmente:

                  -
                  -
                    -
                  • Twig
                    <div>
-    {{ form_label(form.age) }}
-    {{ form_errors(form.age) }}
-    {{ form_widget(form.age) }}
-</div>
-
                    -
                    -
                    • -
                  • PHP
                    <div>
-    <?php echo $view['form']->label($form['age']) }} ?>
-    <?php echo $view['form']->errors($form['age']) }} ?>
-    <?php echo $view['form']->widget($form['age']) }} ?>
-</div>
-
                    -
                    -
                    • -
                  -
                  -

                  En ambos casos, la etiqueta, errores y elementos gráficos del formulario HTML se reproducen con un conjunto de marcas que se incluyen de serie con Symfony. Por ejemplo, ambas plantillas anteriores reproducirán:

                  -
                  <div>
-    <label for="form_age">Age</label>
-    <ul>
-        <li>This field is required</li>
-    </ul>
-    <input type="number" id="form_age" name="form[age]" />
-</div>
-
                  -
                  -

                  para crear prototipos rápidamente y probar un formulario, puedes reproducir el formulario completo con una sola línea:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($formulario) }} ?>
-
                    -
                    -
                    • -
                  -
                  -

                  El resto de esta receta debe explicar cómo se puede modificar cada parte del marcado del formulario en varios niveles diferentes. Para más información sobre la forma de reproducción en general, consulta Reproduciendo un formulario en una plantilla.

                  -
                  -
                  -

                  ¿Qué son los temas de formulario?

                  -

                  Symfony utiliza fragmentos de formulario —una parte de una plantilla que sólo dibuja una pequeña parte de un formulario— para dibujar todas las partes de un formulario —etiquetas de campo, errores, campos de texto input, etiquetas select, etc.—

                  -

                  Los fragmentos se definen como bloques en Twig y como archivos de plantilla en PHP.

                  -

                  Un tema no es más que un conjunto de fragmentos que deseas utilizar al dibujar un formulario. En otras palabras, si deseas personalizar una parte de cómo dibujar un formulario, importa el tema que contiene una personalización apropiada de esos fragmentos del formulario.

                  -

                  Symfony viene con un tema predeterminado (form_div_layout.html.twig en Twig y FrameworkBundle:Form en PHP) que define todos y cada uno de los fragmentos necesarios para dibujar todas las partes de un formulario.

                  -

                  En la siguiente sección aprenderás cómo personalizar un tema redefiniendo todos o algunos de sus fragmentos.

                  -

                  Por ejemplo, cuando dibujas el elemento gráfico de un campo de tipo entero, se dibuja un campo input como número.

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.age) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['age']) ?>
-
                    -
                    -
                    • -
                  -
                  -

                  reproduce:

                  -
                  <input type="number" id="form_edad" name="form[edad]" required="required" value="33" />
-
                  -
                  -

                  Internamente, Symfony usa el fragmento integer_widget para dibujar el campo. -Esto se debe a que el tipo de campo es entero y estás dibujando su elemento gráfico (en comparación a label o errors).

                  -

                  En Twig de manera predeterminada es el bloque integer_widget de la plantilla form_div_layout.html.twig.

                  -

                  En PHP sería más bien el archivo integer_widget.html.php ubicado en el directorio FrameworkBundle/Resources/views/Form.

                  -

                  La implementación predeterminada del fragmento integer_widget tiene el siguiente aspecto:

                  -
                  -
                    -
                  • Twig
                    {# form_div_layout.html.twig #}
-{% block integer_widget %}
-    {% set type = type|default('number') %}
-    {{ block('form_widget_simple') }}
-{% endblock integer_widget %}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- integer_widget.html.php -->
-<?php echo $view['form']->block($form, 'form_widget_simple', array('type' => isset($type) ? $type : "number")) ?>
-
                    -
                    -
                    • -
                  -
                  -

                  Como puedes ver, este fragmento en sí mismo dibuja otro fragmento — form_widget_simple:

                  -
                  -
                    -
                  • Twig
                    {# form_div_layout.html.twig #}
-{% block form_widget_simple %}
-    {% set type = type|default('text') %}
-    <input type="{{ type }}" {{ block('widget_attributes') }} {% if value is not empty %}value="{{ value }}" {% endif %}/>
-{% endblock form_widget_simple %}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- FrameworkBundle/Resources/views/Form/form_widget_simple.html.php -->
-<input
-    type="<?php echo isset($type) ? $view->escape($type) : 'text' ?>"
-    <?php if (!empty($value)): ?>value="<?php echo $view->escape($value) ?>"<?php endif ?>
-    <?php echo $view['form']->block($form, 'widget_attributes') ?>
-/>
-
                    -
                    -
                    • -
                  -
                  -

                  El punto es que los fragmentos dictan la salida HTML de cada parte de un formulario. Para personalizar la salida del formulario, sólo tienes que identificar y redefinir el fragmento correcto. Un conjunto de estos fragmentos de formulario personalizados se conoce como un «tema» de formulario. -Al reproducir un formulario, puedes elegir el/los tema(s) que deseas aplicar al formulario.

                  -

                  En Twig un tema es un sólo archivo de plantilla y los fragmentos son los bloques definidos en ese archivo.

                  -

                  En PHP un tema es un directorio y los fragmentos son archivos de plantilla individuales en ese directorio.

                  - -
                  -
                  -

                  Tematizando formularios

                  -

                  Para ver el poder del tematizado de formularios, supongamos que deseas envolver todos los campos de entrada número con una etiqueta div. La clave para hacerlo es personalizar el fragmento text_widget.

                  -
                  -
                  -

                  Tematizando formularios en Twig

                  -

                  Cuando personalizamos el bloque de campo de formulario en Twig, tienes dos opciones en donde puede vivir el bloque personalizado del formulario:

                  - ----- - - - - - - - - - - - - - - - - -
                  MétodoProsContras
                  Dentro de la misma plantilla que el -formularioRápido y fácilNo se puede reutilizar en otra plantilla
                  Dentro de una plantilla separadaSe puede reutilizar en muchas -plantillasRequiere la creación de una plantilla -extra
                  -

                  Ambos métodos tienen el mismo efecto, pero son mejores en diferentes situaciones.

                  -
                  -

                  Método 1: Dentro de la misma plantilla que el formulario

                  -

                  La forma más sencilla de personalizar el bloque integer_widget es personalizarlo directamente en la plantilla que realmente pinta el formulario.

                  -
                  {% extends '::base.html.twig' %}
-
-{% form_theme form _self %}
-
-{% block integer_widget %}
-    <div class="integer_widget">
-        {% set type = type|default('number') %}
-        {{ block('form_widget_simple') }}
-    </div>
-{% endblock %}
-
-{% block content %}
-    {# ... pinta el formulario #}
-
-    {{ form_row(form.age) }}
-{% endblock %}
-
                  -
                  -

                  Al usar las etiquetas especiales {% form_theme form _self %}, Twig busca dentro de la misma plantilla cualquier bloque de formulario a sustituir. Suponiendo que el campo form.age es un campo de tipo entero, cuando se reproduzca el elemento gráfico, utilizará el bloque personalizado integer_widget.

                  -

                  La desventaja de este método es que los bloques personalizados del formulario no se pueden reutilizar en otros formularios reproducidos en otras plantillas. En otras palabras, este método es más útil cuando haces personalizaciones en forma que sean específicas a un único formulario en tu aplicación. Si deseas volver a utilizar una personalización a través de varios (o todos) los formularios de tu aplicación, lee la siguiente sección.

                  -
                  -
                  -

                  Método 2: Dentro de una plantilla independiente

                  -

                  También puedes optar por poner el bloque integer_widget personalizado del formulario en una plantilla completamente independiente. El código y el resultado final son el mismo, pero ahora puedes volver a utilizar la personalización de un formulario a través de muchas plantillas:

                  -
                  {# src/Acme/DemoBundle/Resources/views/Form/fields.html.twig #}
-{% block integer_widget %}
-    <div class="integer_widget">
-        {% set type = type|default('number') %}
-        {{ block('form_widget_simple') }}
-    </div>
-{% endblock %}
-
                  -
                  -

                  Ahora que has creado el bloque personalizado, es necesario decirle a Symfony que lo utilice. Dentro de la plantilla en la que estás reproduciendo tu formulario realmente, dile a Symfony que utilice la plantilla por medio de la etiqueta form_theme:

                  -
                  {% form_theme form 'AcmeDemoBundle:Form:fields.html.twig' %}
-
-{{ form_widget(form.age) }}
-
                  -
                  -

                  Cuando se reproduzca el form.age, Symfony utilizará el bloque integer_widget de la nueva plantilla y la etiqueta input será envuelta en el elemento div especificado en el bloque personalizado.

                  -
                  -
                  -
                  -

                  Tematizando formularios en PHP

                  -

                  Cuando usas PHP como motor de plantillas, el único método para personalizar un fragmento es crear un nuevo archivo de plantilla —esto es similar al segundo método utilizado por Twig.

                  -

                  El archivo de plantilla se debe nombrar después del fragmento. Debes crear un archivo integer_widget.html.php a fin de personalizar el fragmento integer_widget.

                  -
                  <!-- src/Acme/DemoBundle/Resources/views/Form/integer_widget.html.php -->
-<div class="integer_widget">
-    <?php echo $view['form']->block($form, 'form_widget_simple', array('type' => isset($type) ? $type : "number")) ?>
-</div>
-
                  -
                  -

                  Ahora que has creado la plantilla del formulario personalizado, necesitas decirlo a Symfony para utilizarlo. Dentro de la plantilla en la que estás reproduciendo tu formulario realmente, dile a Symfony que utilice la plantilla por medio del método ayudante setTheme:

                  -
                  <?php $view['form']->setTheme($form, array('AcmeDemoBundle:Form')) ;?>
-
-<?php $view['form']->widget($form['age']) ?>
-
                  -
                  -

                  Al reproducir el elemento gráfico form.age, Symfony utilizará la plantilla personalizada integer_widget.html.php y la etiqueta input será envuelta en el elemento div.

                  -
                  -
                  -

                  Refiriendo bloques del formulario base (específico de Twig)

                  -

                  Hasta ahora, para sustituir un bloque form particular, el mejor método consiste en copiar el bloque predeterminado desde form_div_layout.html.twig, pegarlo en una plantilla diferente y entonces, personalizarlo. En muchos casos, puedes evitarte esto refiriendo al bloque base cuando lo personalizas.

                  -

                  Esto se logra fácilmente, pero varía ligeramente dependiendo de si el bloque del formulario personalizado se encuentra en la misma plantilla que el formulario o en una plantilla separada.

                  -
                  -

                  Refiriendo bloques dentro de la misma plantilla que el formulario

                  -

                  Importa los bloques añadiendo una etiqueta use en la plantilla donde estás reproduciendo el formulario:

                  -
                  {% use 'form_div_layout.html.twig' with integer_widget as base_integer_widget %}
-
                  -
                  -

                  Ahora, cuando importes bloques desde form_div_layout.html.twig, el bloque integer_widget es llamado base_integer_widget. Esto significa que cuando redefines el bloque integer_widget, puedes referir el marcado predeterminado a través de base_integer_widget:

                  -
                  {% block integer_widget %}
-    <div class="integer_widget">
-        {{ block('base_integer_widget') }}
-    </div>
-{% endblock %}
-
                  -
                  -
                  -
                  -

                  Refiriendo bloques base desde una plantilla externa

                  -

                  Si tus personalizaciones del formulario viven dentro de una plantilla externa, puedes referir al bloque base con la función parent() de Twig:

                  -
                  {# src/Acme/DemoBundle/Resources/views/Form/fields.html.twig #}
-{% extends 'form_div_layout.html.twig' %}
-
-{% block integer_widget %}
-    <div class="integer_widget">
-        {{ parent() }}
-    </div>
-{% endblock %}
-
                  -
                  -
                  -

                  Nota

                  -

                  No es posible hacer referencia al bloque base cuando usas PHP como motor de plantillas. Tienes que copiar manualmente el contenido del bloque base a tu nuevo archivo de plantilla.

                  -
                  -
                  -
                  -
                  -

                  Personalizando toda tu aplicación

                  -

                  Si deseas que una personalización en cierto formulario sea global en tu aplicación, lo puedes lograr haciendo las personalizaciones del formulario en una plantilla externa y luego importarla dentro de la configuración de tu aplicación:

                  -
                  -

                  Twig

                  -

                  Al utilizar la siguiente configuración, los bloques personalizados del formulario dentro de la plantilla AcmeDemoBundle:Form:fields.html.twig se utilizarán globalmente al reproducir un formulario.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-twig:
-    form:
-        resources:
-            - 'AcmeDemoBundle:Form:fields.html.twig'
-    # ...
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<twig:config ...>
-        <twig:form>
-            <resource>AcmeDemoBundle:Form:fields.html.twig</resource>
-        </twig:form>
-        <!-- ... -->
-</twig:config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('twig', array(
-    'form' => array(
-        'resources' => array(
-            'AcmeDemoBundle:Form:fields.html.twig',
-        ),
-    ),
-
-    // ...
-));
-
                    -
                    -
                    • -
                  -
                  -

                  De forma predeterminada, Twig utiliza un diseño con div al reproducir formularios. Algunas personas, sin embargo, pueden preferir reproducir formularios en un diseño con tablas. Usa el recurso form_table_layout.html.twig para utilizarlo como diseño:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-twig:
-    form:
-        resources: ['form_table_layout.html.twig']
-    # ...
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<twig:config ...>
-        <twig:form>
-            <resource>form_table_layout.html.twig</resource>
-        </twig:form>
-        <!-- ... -->
-</twig:config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('twig', array(
-    'form' => array(
-        'resources' => array(
-            'form_table_layout.html.twig',
-        ),
-    ),
-
-    // ...
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Si sólo quieres hacer el cambio en una plantilla, añade la siguiente línea a tu archivo de plantilla en lugar de agregar la plantilla como un recurso:

                  -
                  {% form_theme form 'form_table_layout.html.twig' %}
-
                  -
                  -

                  Ten en cuenta que la variable form en el código anterior es la variable de la vista del formulario pasada a la plantilla.

                  -
                  -
                  -

                  PHP

                  -

                  Al utilizar la siguiente configuración, cualquier fragmento de formulario personalizado dentro del directorio src/Acme/DemoBundle/Resources/views/Form se usará globalmente al reproducir un formulario.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-framework:
-    templating:
-        form:
-            resources:
-                - 'AcmeDemoBundle:Form'
-    # ...
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<framework:config ...>
-    <framework:templating>
-        <framework:form>
-            <resource>AcmeDemoBundle:Form</resource>
-        </framework:form>
-    </framework:templating>
-    <!-- ... -->
-</framework:config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-// PHP
-$container->loadFromExtension('framework', array(
-    'templating' => array(
-        'form' => array(
-            'resources' => array(
-                'AcmeDemoBundle:Form',
-            ),
-        ),
-     ),
-
-     // ...
-));
-
                    -
                    -
                    • -
                  -
                  -

                  De manera predeterminada, el motor PHP utiliza un diseño div al reproducir formularios. Algunas personas, sin embargo, pueden preferir reproducir formularios en un diseño con tablas. Utiliza el recurso FrameworkBundle:FormTable para utilizar este tipo de diseño:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-framework:
-    templating:
-        form:
-            resources:
-                - 'FrameworkBundle:FormTable'
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<framework:config ...>
-    <framework:templating>
-        <framework:form>
-            <resource>FrameworkBundle:FormTable</resource>
-        </framework:form>
-    </framework:templating>
-    <!-- ... -->
-</framework:config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('framework', array(
-    'templating' => array(
-        'form' => array(
-            'resources' => array(
-                'FrameworkBundle:FormTable',
-            ),
-        ),
-    ),
-
-     // ...
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Si sólo quieres hacer el cambio en una plantilla, añade la siguiente línea a tu archivo de plantilla en lugar de agregar la plantilla como un recurso:

                  -
                  <?php $view['form']->setTheme($form, array('FrameworkBundle:FormTable')); ?>
-
                  -
                  -

                  Ten en cuenta que la variable $form en el código anterior es la variable de la vista del formulario que pasaste a tu plantilla.

                  -
                  -
                  -
                  -

                  Cómo personalizar un campo individual

                  -

                  Hasta ahora, hemos visto diferentes formas en que puedes personalizar elementos gráficos de todos los tipos de campo de texto. También puedes personalizar campos individuales. Por ejemplo, supongamos que tienes dos campos text —first_name y last_name— pero sólo quieres personalizar uno de los campos. Esto se puede lograr personalizando un fragmento cuyo nombre es una combinación del atributo id del campo y cual parte del campo estás personalizando. Por ejemplo:

                  -
                  -
                    -
                  • Twig
                    {% form_theme form _self %}
-
-{% block _product_name_widget %}
-    <div class="text_widget">
-        {{ block('form_widget_simple') }}
-    </div>
-{% endblock %}
-
-{{ form_widget(form.name) }}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- Plantilla principal -->
-<?php echo $view['form']->setTheme($form, array('AcmeDemoBundle:Form')); ?>
-
-<?php echo $view['form']->widget($form['name']); ?>
-
-<!-- src/Acme/DemoBundle/Resources/views/Form/_product_name_widget.html.php -->
-
-<div class="text_widget">
-      echo $view['form']->block('form_widget_simple') ?>
-</div>
-
                    -
                    -
                    • -
                  -
                  -

                  Aquí, el fragmento _product_name_widget define la plantilla a utilizar para el campo cuyo id es product_name (y nombre es product[name]).

                  -
                  -

                  Truco

                  -

                  La parte producto del campo es el nombre del formulario, el cual puedes ajustar manualmente o generar automáticamente a partir del nombre del tipo en el formulario (por ejemplo, ProductType equivale a producto). Si no estás seguro cual es el nombre del formulario, solo ve el código fuente del formulario generado.

                  -
                  -

                  También puedes sustituir el marcado de toda la fila de un campo usando el mismo método:

                  -
                  -
                    -
                  • Twig
                    {# _product_name_row.html.twig #}
-{% form_theme form _self %}
-
-{% block _product_name_row %}
-    <div class="name_row">
-        {{ form_label(form) }}
-        {{ form_errors(form) }}
-        {{ form_widget(form) }}
-    </div>
-{% endblock %}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- _product_name_row.html.php -->
-
-<div class="name_row">
-    <?php echo $view['form']->label($form) ?>
-    <?php echo $view['form']->errors($form) ?>
-    <?php echo $view['form']->widget($form) ?>
-</div>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Otras personalizaciones comunes

                  -

                  Hasta el momento, esta receta ha mostrado varias formas de personalizar una sola pieza de cómo se reproduce un formulario. La clave está en personalizar un fragmento específico que corresponde a la porción del formulario que deseas controlar (consulta nombrando bloques de formulario).

                  -

                  En las siguientes secciones, verás cómo puedes hacer varias personalizaciones de formulario comunes. -Para aplicar estas personalizaciones, utiliza uno de los dos métodos descritos en la sección Tematizando formularios.

                  -
                  -

                  Personalizando la exhibición de errores

                  -
                  -

                  Nota

                  -

                  El componente form sólo se ocupa de cómo se presentan los errores de validación, y no los mensajes de error de validación reales. Los mensajes de error están determinados por las restricciones de validación que apliques a tus objetos. -Para más información, ve el capítulo Validando.

                  -
                  -

                  Hay muchas maneras de personalizar el modo en que se representan los errores cuando se envía un formulario con errores. Los mensajes de error de un campo se reproducen cuando se utiliza el ayudante form_errors:

                  -
                  -
                    -
                  • Twig
                    {{ form_errors(form.age) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->errors($form['age']); ?>
-
                    -
                    -
                    • -
                  -
                  -

                  De forma predeterminada, los errores se representan dentro de una lista desordenada:

                  -
                  <ul>
-    <li>This field is required</li>
-</ul>
-
                  -
                  -

                  Para redefinir cómo se dibujan los errores para todos los campos, simplemente copia, pega y personaliza el fragmento form_errors.

                  -
                  -
                    -
                  • Twig
                    {# form_errors.html.twig #}
-{% block form_errors %}
-    {% spaceless %}
-        {% if errors|length > 0 %}
-        <ul>
-            {% for error in errors %}
-                <li>{{ error.message }}</li>
-            {% endfor %}
-        </ul>
-        {% endif %}
-    {% endspaceless %}
-{% endblock form_errors %}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- form_errors.html.php -->
-<?php if ($errors): ?>
-    <ul>
-        <?php foreach ($errors as $error): ?>
-            <li><?php echo $error->getMessage() ?></li>
-        <?php endforeach; ?>
-    </ul>
-<?php endif ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Consulta Tematizando formularios para ver cómo aplicar esta personalización.

                  -
                  -

                  También puedes personalizar la salida de error de sólo un tipo de campo específico. -Por ejemplo, algunos errores que son más globales en tu formulario (es decir, no específicos a un solo campo) se reproducen por separado, por lo general en la parte superior de tu formulario:

                  -
                  -
                    -
                  • Twig
                    {{ form_errors(form) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->render($form); ?>
-
                    -
                    -
                    • -
                  -
                  -

                  Para personalizar sólo el formato utilizado por estos errores, sigue las mismas instrucciones que el anterior, pero ahora llamamos al bloque form_errors (Twig) / el archivo form_errors.html.php (PHP). Ahora, al dibujar errores del tipo form, se utiliza tu fragmento personalizado en lugar del form_errors predeterminado.

                  -
                  -
                  -

                  Personalizando una «fila del formulario»

                  -

                  Cuando consigas manejarla, la forma más fácil para dibujar un campo de formulario es a través de la función form_row, la cual dibuja la etiqueta, errores y el elemento gráfico HTML de un campo. Para personalizar el marcadp utilizado para dibujar todas las filas de los campos del formulario, sustituye el fragmento form_row. Por ejemplo, supón que deseas agregar una clase al elemento div alrededor de cada fila:

                  -
                  -
                    -
                  • Twig
                    {# form_row.html.twig #}
-{% block form_row %}
-    <div class="form_row">
-        {{ form_label(form) }}
-        {{ form_errors(form) }}
-        {{ form_widget(form) }}
-    </div>
-{% endblock form_row %}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- form_row.html.php -->
-<div class="form_row">
-    <?php echo $view['form']->label($form) ?>
-    <?php echo $view['form']->errors($form) ?>
-    <?php echo $view['form']->widget($form) ?>
-</div>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Consulta Tematizando formularios para ver cómo aplicar esta personalización.

                  -
                  -
                  -
                  -

                  Añadiendo un asterisco «Requerido» a las etiquetas de campo

                  -

                  Si deseas denotar todos los campos obligatorios con un asterisco requerido (*), lo puedes hacer personalizando el fragmento form_label.

                  -

                  En Twig, si estás haciendo la personalización del formulario dentro de la misma plantilla que tu formulario, modifica la etiqueta use y añade lo siguiente:

                  -
                  {% use 'form_div_layout.html.twig' with form_label as base_form_label %}
-
-{% block form_label %}
-    {{ block('base_form_label') }}
-
-    {% if required %}
-        <span class="required" title="This field is required">*</span>
-    {% endif %}
-{% endblock %}
-
                  -
                  -

                  En Twig, si estás haciendo la personalización del formulario dentro de una plantilla separada, utiliza lo siguiente:

                  -
                  {% extends 'form_div_layout.html.twig' %}
-
-{% block form_label %}
-    {{ parent() }}
-
-    {% if required %}
-        <span class="required" title="This field is required">*</span>
-    {% endif %}
-{% endblock %}
-
                  -
                  -

                  Cuando usas PHP como motor de plantillas tienes que copiar el contenido desde la plantilla original:

                  -
                  <!-- form_label.html.php -->
-
-<!-- contenido original -->
-<?php if ($required) { $label_attr['class'] = trim((isset($label_attr['class']) ? $label_attr['class'] : '').' required'); } ?>
-<?php if (!$compound) { $label_attr['for'] = $id; } ?>
-<?php if (!$label) { $label = $view['form']->humanize($name); } ?>
-<label <?php foreach ($label_attr as $k => $v) { printf('%s="%s" ', $view->escape($k), $view->escape($v)); } ?>><?php echo $view->escape($view['translator']->trans($label, array(), $translation_domain)) ?></label>
-
-<!-- personalización -->
-<?php if ($required) : ?>
-    <span class="required" title="This field is required">*</span>
-<?php endif ?>
-
                  -
                  -
                  -

                  Truco

                  -

                  Consulta Tematizando formularios para ver cómo aplicar esta personalización.

                  -
                  -
                  -
                  -

                  Añadiendo mensajes de «ayuda»

                  -

                  También puedes personalizar los elementos gráficos del formulario para que tengan un mensaje de «ayuda» opcional.

                  -

                  En Twig, si estás haciendo la personalización del formulario dentro de la misma plantilla que tu formulario, modifica la etiqueta use y añade lo siguiente:

                  -
                  {% use 'form_div_layout.html.twig' with form_widget_simple as base_form_widget_simple %}
-
-{% block form_widget_simple %}
-    {{ block('base_form_widget_simple') }}
-
-    {% if help is defined %}
-        <span class="help">{{ help }}</span>
-    {% endif %}
-{% endblock %}
-
                  -
                  -

                  En Twig, si estás haciendo la personalización del formulario dentro de una plantilla separada, utiliza lo siguiente:

                  -
                  {% extends 'form_div_layout.html.twig' %}
-
-{% block form_widget_simple %}
-    {{ parent() }}
-
-    {% if help is defined %}
-        <span class="help">{{ help }}</span>
-    {% endif %}
-{% endblock %}
-
                  -
                  -

                  Cuando usas PHP como motor de plantillas tienes que copiar el contenido desde la plantilla original:

                  -
                  <!-- form_widget_simple.html.php -->
-
-<!-- contenido original -->
-<input
-    type="<?php echo isset($type) ? $view->escape($type) : 'text' ?>"
-    <?php if (!empty($value)): ?>value="<?php echo $view->escape($value) ?>"<?php endif ?>
-    <?php echo $view['form']->block($form, 'widget_attributes') ?>
-/>
-
-<!-- personalización -->
-<?php if (isset($help)) : ?>
-    <span class="help"><?php echo $view->escape($help) ?></span>
-<?php endif ?>
-
                  -
                  -

                  Para reproducir un mensaje de ayuda debajo de un campo, pásalo en una variable help:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.title, {'help': 'foobar'}) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['title'], array('help' => 'foobar')) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Consulta Tematizando formularios para ver cómo aplicar esta personalización.

                  -
                  -
                  -
                  -
                  -

                  Usando variables de formulario

                  -

                  La mayoría de las funciones disponibles para dibujar diferentes partes de un formulario (p. ej. -el elemento gráfico del formulario, etiquetas de formulario, elementos gráficos de formulario, etc.) también te permite hacer ciertas personalizaciones directamente. Considera el ejemplo siguiente:

                  -
                  -
                    -
                  • Twig
                    {# pinta un elemento gráfico, pero añadiéndole la clase "foo" #}
-{{ form_widget(form.name, { 'attr': {'class': 'foo'} }) }}
-
                    -
                    -
                    • -
                  • PHP
                    <!-- pinta un elemento gráfico, pero añadiéndole la clase "foo" -->
-<?php echo $view['form']->widget($form['name'], array(
-    'attr' => array(
-        'class' => 'foo',
-    ),
-)) ?>
-
                    -
                    -
                    • -
                  -
                  -

                  El arreglo pasado como segundo argumento contiene «variables» de formulario. Para más detalles sobre este concepto en Twig, ve Más sobre variables de formulario.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/index.html b/cookbook/form/index.html deleted file mode 100644 index 9b0320d..0000000 --- a/cookbook/form/index.html +++ /dev/null @@ -1,194 +0,0 @@ - - - - - - - Formularios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Formularios

                  -
                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/unit_testing.html b/cookbook/form/unit_testing.html deleted file mode 100644 index 1b7e066..0000000 --- a/cookbook/form/unit_testing.html +++ /dev/null @@ -1,336 +0,0 @@ - - - - - - - Cómo probar tus formularios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo probar tus formularios

                  -

                  El componente Form consta de 3 objetos del núcleo: un tipo form (implementando la Symfony\Component\Form\FormTypeInterface), Symfony\Component\Form\Form y Symfony\Component\Form\FormView.

                  -

                  La única clase que normalmente manipulan los programadores es la clase del tipo form que sirve como proyecto del formulario. Se usa para generar el Formulario y el FormView. La podrías probar directamente simulando sus interacciones con la fábrica pero sería complejo. Es mejor pasarla al FormFactory tal y como se hace en una aplicación real. Es sencillo arrancarla y puedes confiar en bastantes componentes de Symfony para utilizarlos como pruebas base.

                  -

                  Ya hay una clase de la cual te puedes beneficiar para pruebas sencillas de FormTypes: Symfony\Component\Form\Tests\Extension\Core\Type\TypeTestCase. -Se usa para probar los tipos del núcleo y la puedes utilizar para probar tus tipos también.

                  -
                  -

                  Nota

                  -

                  Dependiendo de la manera en que instalaste tu Symfony o el componente Form de Symfony las pruebas no se pueden descargar. Usa la opción --prefer-source de composer si este es el caso.

                  -
                  -
                  -

                  Fundamentos

                  -

                  La más sencilla implementación de TypeTestCase se parece a la siguiente:

                  -
                  // src/Acme/TestBundle/Tests/Form/Type/TestedTypeTests.php
-namespace Acme\TestBundle\Tests\Form\Type;
-
-use Acme\TestBundle\Form\Type\TestedType;
-use Acme\TestBundle\Model\TestObject;
-use Symfony\Component\Form\Tests\Extension\Core\Type\TypeTestCase;
-
-class TestedTypeTest extends TypeTestCase
-{
-    public function testBindValidData()
-    {
-        $formData = array(
-            'test' => 'test',
-            'test2' => 'test2',
-        );
-
-        $type = new TestedType();
-        $form = $this->factory->create($type);
-
-        $object = new TestObject();
-        $object->fromArray($formData);
-
-        $form->bind($formData);
-
-        $this->assertTrue($form->isSynchronized());
-        $this->assertEquals($object, $form->getData());
-
-        $view = $form->createView();
-        $children = $view->children;
-
-        foreach (array_keys($formData) as $key) {
-            $this->assertArrayHasKey($key, $children);
-        }
-    }
-}
-
                  -
                  -

                  Así que, ¿qué hace esta prueba? Permiteme explicarlo línea por línea.

                  -

                  Primero verifica si el FormType compila. Esto incluye la herencia de clase básica, la función buildForm y la resolución de opciones. Esta debería ser la primera prueba que escribas:

                  -
                  $type = new TestedType();
-$form = $this->factory->create($type);
-
                  -
                  -

                  Esta prueba verifica que ninguno de tus transformadores de datos utilizado por el formulario falló. El método isSynchronized() sólo se pone a false si un transformador de datos lanza una excepción:

                  -
                  $form->bind($formData);
-$this->assertTrue($form->isSynchronized());
-
                  -
                  -
                  -

                  Nota

                  -

                  No prueba la validación: Está es aplicada por un escucha que no está activo en el caso de prueba y este confía en la configuración de validación. -En cambio, tu prueba unitaria personalizada la restringe directamente.

                  -
                  -

                  Luego, comprueba la vinculación y asignación del formulario. La prueba de bajo verifica que todos los campos se hayan especificado correctamente:

                  -
                  $this->assertEquals($object, $form->getData());
-
                  -
                  -

                  Finalmente, comprueba la creación del FormView. Deberías comprobar si todos los elementos gráficos que quieres mostrar están disponibles en la propiedad descendiente:

                  -
                  $view = $form->createView();
-$children = $view->children;
-
-foreach (array_keys($formData) as $key) {
-    $this->assertArrayHasKey($key, $children);
-}
-
                  -
                  -
                  -
                  -

                  Añadiendo un tipo del cual depende tu formulario

                  -

                  Tu formulario puede depender de otros tipos que están definidos como servicios. Puede tener esta apariencia:

                  -
                  // src/Acme/TestBundle/Form/Type/TestedType.php
-
-// ... el método buildForm
-$builder->add('acme_test_child_type');
-
                  -
                  -

                  Para crear tu formulario correctamente, necesitas poner a disposición de la fábrica el tipo de formulario en tu prueba. La manera más fácil es registrándolo a mano antes de crear el formulario padre:

                  -
                  // src/Acme/TestBundle/Tests/Form/Type/TestedTypeTests.php
-namespace Acme\TestBundle\Tests\Form\Type;
-
-use Acme\TestBundle\Form\Type\TestedType;
-use Acme\TestBundle\Model\TestObject;
-use Symfony\Component\Form\Tests\Extension\Core\Type\TypeTestCase;
-
-class TestedTypeTest extends TypeTestCase
-{
-    public function testBindValidData()
-    {
-        $this->factory->addType(new TestChildType());
-
-        $type = new TestedType();
-        $form = $this->factory->create($type);
-
-        // ... tu prueba
-    }
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  Asegúrate de que el tipo hijo que añades está bien probado. De lo contrario puedes obtener errores que no están relacionados al formulario que estás probando actualmente sino a sus descendientes.

                  -
                  -
                  -
                  -

                  Añadiendo extensiones personalizadas

                  -

                  It often happens that you use some options that are added by -form extensions. Uno de esos casos puede ser el ValidatorExtension con su opción invalid_message. -El TypeTestCase sólo carga la extensión form del núcleo así que una excepción de «Opción no válida» será lanzada si intentas utilizarla para probar una clase que depende de otras extensiones. Necesitas añadir esas extensiones al objeto fábrica:

                  -
                  // src/Acme/TestBundle/Tests/Form/Type/TestedTypeTests.php
-namespace Acme\TestBundle\Tests\Form\Type;
-
-use Acme\TestBundle\Form\Type\TestedType;
-use Acme\TestBundle\Model\TestObject;
-use Symfony\Component\Form\Tests\Extension\Core\Type\TypeTestCase;
-
-class TestedTypeTest extends TypeTestCase
-{
-    protected function setUp()
-    {
-        parent::setUp();
-
-        $this->factory = Forms::createFormFactoryBuilder()
-            ->addTypeExtension(
-                new FormTypeValidatorExtension(
-                    $this->getMock('Symfony\Component\Validator\ValidatorInterface')
-                )
-            )
-            ->addTypeGuesser(
-                $this->getMockBuilder(
-                    'Symfony\Component\Form\Extension\Validator\ValidatorTypeGuesser'
-                )
-                    ->disableOriginalConstructor()
-                    ->getMock()
-            )
-            ->getFormFactory();
-
-        $this->dispatcher = $this->getMock('Symfony\Component\EventDispatcher\EventDispatcherInterface');
-        $this->builder = new FormBuilder(null, null, $this->dispatcher, $this->factory);
-    }
-
-    // ... tus pruebas
-}
-
                  -
                  -
                  -
                  -

                  Probando contra diferentes conjuntos de datos

                  -

                  Si todavía no estás familiarizado con los proveedores de datos de PHPUnit, esta podría ser una magnífica oportunidad para utilizarlos:

                  -
                  // src/Acme/TestBundle/Tests/Form/Type/TestedTypeTests.php
-namespace Acme\TestBundle\Tests\Form\Type;
-
-use Acme\TestBundle\Form\Type\TestedType;
-use Acme\TestBundle\Model\TestObject;
-use Symfony\Component\Form\Tests\Extension\Core\Type\TypeTestCase;
-
-class TestedTypeTest extends TypeTestCase
-{
-
-    /**
-     * @dataProvider getValidTestData
-     */
-    public function testForm($data)
-    {
-        // ... tu prueba
-    }
-
-    public function getValidTestData()
-    {
-        return array(
-            array(
-                'data' => array(
-                    'test' => 'test',
-                    'test2' => 'test2',
-                ),
-            ),
-            array(
-                'data' => array(),
-            ),
-            array(
-                'data' => array(
-                    'test' => null,
-                    'test2' => null,
-                ),
-            ),
-        );
-    }
-}
-
                  -
                  -

                  El código anterior correrá tres veces tus pruebas con 3 diferentes conjuntos de datos. Esto te permite desacoplar los accesorios de prueba de las pruebas y probar fácilmente contra múltiples conjuntos de datos.

                  -

                  También puedes pasar otro argumento, como un booleano si el formulario se tiene que sincronizar o no con el conjunto de datos dado, etc.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/use_empty_data.html b/cookbook/form/use_empty_data.html deleted file mode 100644 index 1563ed5..0000000 --- a/cookbook/form/use_empty_data.html +++ /dev/null @@ -1,210 +0,0 @@ - - - - - - - How to configure Empty Data for a Form Class — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  How to configure Empty Data for a Form Class

                  -

                  The empty_data option allows you to specify an empty data set for your -form class. This empty data set would be used if you bind your form, but -haven’t called setData() on your form or passed in data when you created -you form. Por ejemplo:

                  -
                  public function indexAction()
-{
-    $blog = // ...
-
-    // $blog is passed in as the data, so the empty_data option is not needed
-    $form = $this->createForm(new BlogType(), $blog);
-
-    // no data is passed in, so empty_data is used to get the "starting data"
-    $form = $this->createForm(new BlogType());
-}
-
                  -
                  -

                  By default, empty_data is set to null. Or, if you have specified -a data_class option for your form class, it will default to a new instance -of that class. That instance will be created by calling the constructor -with no arguments.

                  -

                  If you want to override this default behavior, there are two ways to do this.

                  -
                  -

                  Option 1: Instantiate a new Class

                  -

                  One reason you might use this option is if you want to use a constructor -that takes arguments. Remember, the default data_class option calls -that constructor with no arguments:

                  -
                  // src/Acme/DemoBundle/Form/Type/BlogType.php
-// ...
-
-use Symfony\Component\Form\AbstractType;
-use Acme\DemoBundle\Entity\Blog;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class BlogType extends AbstractType
-{
-    private $someDependency;
-
-    public function __construct($someDependency)
-    {
-        $this->someDependency = $someDependency;
-    }
-    // ...
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'empty_data' => new Blog($this->someDependency),
-        ));
-    }
-}
-
                  -
                  -

                  You can instantiate your class however you want. In this example, we pass -some dependency into the BlogType when we instantiate it, then use that -to instantiate the Blog object. The point is, you can set empty_data -to the exact “new” object that you want to use.

                  -
                  -
                  -

                  Option 2: Provide a Closure

                  -

                  Using a closure is the preferred method, since it will only create the object -if it is needed.

                  -

                  The closure must accept a FormInterface instance as the first argument:

                  -
                  use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-use Symfony\Component\Form\FormInterface;
-// ...
-
-public function setDefaultOptions(OptionsResolverInterface $resolver)
-{
-    $resolver->setDefaults(array(
-        'empty_data' => function (FormInterface $form) {
-            return new Blog($form->get('title')->getData());
-        },
-    ));
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/form/use_virtuals_forms.html b/cookbook/form/use_virtuals_forms.html deleted file mode 100644 index 0c490bf..0000000 --- a/cookbook/form/use_virtuals_forms.html +++ /dev/null @@ -1,268 +0,0 @@ - - - - - - - Cómo usar la opción virtual en los campos de formulario — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar la opción virtual en los campos de formulario

                  -

                  La opción virtual para los campos de formulario puede ser muy útil cuando tienes algunos campos duplicados en diferentes entidades.

                  -

                  Por ejemplo, imagina que tienes dos entidades, una Compañía y un Cliente:

                  -
                  // src/Acme/HelloBundle/Entity/Company.php
-namespace Acme\HelloBundle\Entity;
-
-class Company
-{
-    private $name;
-    private $website;
-
-    private $street;
-    private $zipcode;
-    private $city;
-    private $country;
-}
-
                  -
                  -
                  // src/Acme/HelloBundle/Entity/Customer.php
-namespace Acme\HelloBundle\Entity;
-
-class Customer
-{
-    private $firstName;
-    private $lastName;
-
-    private $street;
-    private $zipcode;
-    private $city;
-    private $country;
-}
-
                  -
                  -

                  Como puedes ver, cada entidad comparte algunos de los mismos campos: calle, código postal, ciudad, país.

                  -

                  Ahora, quieres construir dos formularios: uno para la Compañía y el segundo para un Cliente.

                  -

                  Comienzas creando un muy simple CompanyType y un CustomerType:

                  -
                  // src/Acme/HelloBundle/Form/Type/CompanyType.php
-namespace Acme\HelloBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilder;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-
-class CompanyType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('name', 'text')
-            ->add('website', 'text');
-    }
-}
-
                  -
                  -
                  // src/Acme/HelloBundle/Form/Type/CustomerType.php
-namespace Acme\HelloBundle\Form\Type;
-
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\Form\AbstractType;
-
-class CustomerType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('firstName', 'text')
-            ->add('lastName', 'text');
-    }
-}
-
                  -
                  -

                  Ahora, para hacer frente a los cuatro campos duplicados. Aquí está un (sencillo) tipo de formulario domicilio:

                  -
                  // src/Acme/HelloBundle/Form/Type/AddressType.php
-namespace Acme\HelloBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractType;
-use Symfony\Component\Form\FormBuilderInterface;
-use Symfony\Component\OptionsResolver\OptionsResolverInterface;
-
-class AddressType extends AbstractType
-{
-    public function buildForm(FormBuilderInterface $builder, array $options)
-    {
-        $builder
-            ->add('address', 'textarea')
-            ->add('zipcode', 'text')
-            ->add('city', 'text')
-            ->add('country', 'text');
-    }
-
-    public function setDefaultOptions(OptionsResolverInterface $resolver)
-    {
-        $resolver->setDefaults(array(
-            'virtual' => true
-        ));
-    }
-
-    public function getName()
-    {
-        return 'address';
-    }
-}
-
                  -
                  -

                  En realidad no tienes un campo calle en cada una de tus entidades, por lo tanto no puedes vincular directamente tu LocationType a CompanyType o a CustomerType. -Pero definitivamente quieres tener un tipo de formulario específico que se ocupe del domicilio (recuerda, ¡No te repitas!).

                  -

                  La opción virtual en los campos de formulario es la solución.

                  -

                  Podemos ajustar la opción 'virtual' => true en el método getDefaultOptions() de LocationType y comenzar a utilizarlo directamente en los dos tipos de formulario originales.

                  -

                  Mira el resultado:

                  -
                  // CompanyType
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    $builder->add('foo', new LocationType(), array(
-        'data_class' => 'Acme\HelloBundle\Entity\Company'
-    ));
-}
-
                  -
                  -
                  // CustomerType
-public function buildForm(FormBuilderInterface $builder, array $options)
-{
-    $builder->add('bar', new LocationType(), array(
-        'data_class' => 'Acme\HelloBundle\Entity\Customer'
-    ));
-}
-
                  -
                  -

                  Con la opción virtual establecida a false (el comportamiento predeterminado), el componente Formulario espera que cada objeto subyacente tenga una propiedad foo (o bar) que sea o bien un objeto o un arreglo que contiene los cuatro campos de la ubicación. -Por supuesto, ¡no tienes este objeto/arreglo en tus entidades y no lo quieres!

                  -

                  Con la opción virtual, ajustada al valor true, el componente formulario omite la propiedad foo (o bar), y en su lugar ¡«capta» y «define» los 4 campos del domicilio directamente en el objeto subyacente!

                  -
                  -

                  Nota

                  -

                  En lugar de establecer la opción virtual, en el AddressType, también puedes (al igual que con cualquier otra opción) pasar como argumento un arreglo al tercer parámetro de $builder->add().

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/index.html b/cookbook/index.html deleted file mode 100644 index bfbff03..0000000 --- a/cookbook/index.html +++ /dev/null @@ -1,306 +0,0 @@ - - - - - - - Recetario — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Recetario

                  -
                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/logging/channels_handlers.html b/cookbook/logging/channels_handlers.html deleted file mode 100644 index 498723a..0000000 --- a/cookbook/logging/channels_handlers.html +++ /dev/null @@ -1,211 +0,0 @@ - - - - - - - Cómo registrar mensajes en diferentes archivos de bitácora — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo registrar mensajes en diferentes archivos de bitácora

                  -

                  -Nuevo en la versión 2.1: La habilidad para especificar canales para un controlador MonologBundle específico se añadió en Symfony 2.1.

                  -

                  La edición estándar de Symfony contiene un montón de canales para la anotación cronológica de eventos: doctrine, -event, security y request. Cada canal corresponde a un servicio de la bitácora (monolog.logger.XXX) en el contenedor y se inyecta al servicio en cuestión. El propósito de los canales es poder organizar los diferentes tipos de mensajes de la bitácora.

                  -

                  De forma predeterminada, Symfony2 registra cada mensaje en un solo archivo (independientemente del canal).

                  -
                  -

                  Cambiando un canal a un diferente controlador

                  -

                  Ahora, supongamos que quieres registrar los eventos del canal de doctrine a un archivo diferente.

                  -

                  Para ello, basta con crear un nuevo controlador y configurarlo así:

                  -
                  -
                    -
                  • YAML
                    monolog:
-    handlers:
-        main:
-            type: stream
-            path: /var/log/symfony.log
-            channels: !doctrine
-        doctrine:
-            type: stream
-            path: /var/log/doctrine.log
-            channels: doctrine
-
                    -
                    -
                    • -
                  • XML
                    <monolog:config>
-    <monolog:handlers>
-        <monolog:handler name="main" type="stream" path="/var/log/symfony.log">
-            <monolog:channels>
-                <type>exclusive</type>
-                <channel>doctrine</channel>
-            </monolog:channels>
-        </monolog:handler>
-
-        <monolog:handler name="doctrine" type="stream" path="/var/log/doctrine.log" />
-            <monolog:channels>
-                <type>inclusive</type>
-                <channel>doctrine</channel>
-            </monolog:channels>
-        </monolog:handler>
-    </monolog:handlers>
-</monolog:config>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Especificación Yaml

                  -

                  Puedes especificar la configuración de muchas formas:

                  -
                  channels: ~    # Incluye todos los canales
-
-channels: foo  # Incluir sólo el canal "foo"
-channels: !foo # Incluye todos los canales, excepto "foo"
-
-channels: [foo, bar]   # Incluye sólo los canales "foo" y "bar"
-channels: [!foo, !bar] # Incluye todos los canales, excepto "foo" y "bar"
-
-channels:
-    type:     inclusive # Incluir sólo los que se enumeran a continuación
-    elements: [ foo, bar ]
-channels:
-    type:     exclusive # Incluye todos, excepto los enumerados a continuación
-    elements: [ foo, bar ]
-
                  -
                  -
                  -
                  -

                  Creando tu propio canal

                  -

                  Puedes cambiar el canal en que monolog lleva su registro cronológico a un servicio a la vez. Esto se hace etiquetando tu servicio con monolog.logger y especificando a qué canal tiene que registrar el servicio. Para ello, el registro cronológico es inyectado en ese servicio preconfigurado para utilizar el canal has especificado.

                  -

                  Para más información —incluyendo un ejemplo completo— consulta la sección «monolog.logger» en la referencia de las Etiquetas de inyección de dependencias.

                  -
                  -
                  -

                  Aprende más en el recetario

                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/logging/index.html b/cookbook/logging/index.html deleted file mode 100644 index 495a62b..0000000 --- a/cookbook/logging/index.html +++ /dev/null @@ -1,149 +0,0 @@ - - - - - - - Bitácora de eventos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/logging/monolog.html b/cookbook/logging/monolog.html deleted file mode 100644 index d4e222f..0000000 --- a/cookbook/logging/monolog.html +++ /dev/null @@ -1,443 +0,0 @@ - - - - - - - Cómo utilizar Monolog para escribir registros — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar Monolog para escribir registros

                  -

                  Monolog es una biblioteca para bitácora de eventos en PHP 5.3 utilizada por Symfony2. Inspirada en la biblioteca LogBook de Python.

                  -
                  -

                  Usando

                  -

                  Para registrar un mensaje, simplemente consigue el servicio de registro cronológico del contenedor en tu controlador:

                  -
                  public function indexAction()
-{
-    $logger = $this->get('logger');
-    $logger->info('I just got the logger');
-    $logger->err('An error occurred');
-
-    // ...
-}
-
                  -
                  -

                  El servicio logger tiene diferentes métodos para diferentes niveles de registro cronológico de eventos. -Ve la Symfony\Component\HttpKernel\Log\LoggerInterface para detalles de cuáles métodos están disponibles.

                  -
                  -
                  -

                  Manejadores y canales: escribiendo registros a diferentes ubicaciones

                  -

                  En Monolog cada cual registrador define un canal para su registro cronológico, el cual organiza tus mensajes de registro en diferentes «categorías». Luego, cada canal tiene una pila de manejadores para escribir los registros (los manejadores se pueden compartir).

                  -
                  -

                  Truco

                  -

                  Cuándo inyectas el registrador en un servicio puedes usar un canal personalizado para controlar en qué «canal» deberá llevar el registro cronológico de eventos.

                  -
                  -

                  El manipulador básico es el StreamHandler el cual escribe los registros en un flujo (por omisión en app/logs/prod.log en el entorno de producción y app/logs/dev.log en el entorno de desarrollo).

                  -

                  Monolog también viene con una potente capacidad integrada para encargarse del registro cronológico de eventos en el entorno de producción: FingersCrossedHandler. Esta te permite almacenar los mensajes en la memoria intermedia y registrarla sólo si un mensaje llega al nivel de acción (ERROR en la configuración prevista en la edición estándar) transmitiendo los mensajes a otro manipulador.

                  -
                  -

                  Utilizando varios manejadores

                  -

                  El registro cronológico de eventos utiliza una pila de manejadores que se van llamando sucesivamente. Esto te permite registrar los mensajes de varias formas fácilmente.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-monolog:
-    handlers:
-        applog:
-            type: stream
-            path: /var/log/symfony.log
-            level: error
-        main:
-            type: fingers_crossed
-            action_level: warning
-            handler: file
-        file:
-            type: stream
-            level: debug
-        syslog:
-            type: syslog
-            level: error
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:monolog="http://symfony.com/schema/dic/monolog"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/monolog http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-    <monolog:config>
-        <monolog:handler
-            name="applog"
-            type="stream"
-            path="/var/log/symfony.log"
-            level="error"
-        />
-        <monolog:handler
-            name="main"
-            type="fingers_crossed"
-            action-level="warning"
-            handler="file"
-        />
-        <monolog:handler
-            name="file"
-            type="stream"
-            level="debug"
-        />
-        <monolog:handler
-            name="syslog"
-            type="syslog"
-            level="error"
-        />
-    </monolog:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('monolog', array(
-    'handlers' => array(
-        'applog' => array(
-            'type'  => 'stream',
-            'path'  => '/var/log/symfony.log',
-            'level' => 'error',
-        ),
-        'main' => array(
-            'type'         => 'fingers_crossed',
-            'action_level' => 'warning',
-            'handler'      => 'file',
-        ),
-        'file' => array(
-            'type'  => 'stream',
-            'level' => 'debug',
-        ),
-        'syslog' => array(
-            'type'  => 'syslog',
-            'level' => 'error',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  La configuración anterior define una pila de controladores que se llamarán en el orden en el cual se definen.

                  -
                  -

                  Truco

                  -

                  El controlador denominado «file» no se incluirá en la misma pila que se utiliza como un controlador anidado del controlador fingers_crossed.

                  -
                  -
                  -

                  Nota

                  -

                  Si deseas cambiar la configuración de MonologBundle en otro archivo de configuración necesitas redefinir toda la pila. No se pueden combinar, ya que el orden es importante y una combinación no te permite controlar el orden.

                  -
                  -
                  -
                  -

                  Cambiando el formateador

                  -

                  El controlador utiliza un formateador para dar formato al registro del evento antes de ingresarlo. Todos los manipuladores Monolog utilizan una instancia de Monolog\Formatter\LineFormatter por omisión, pero la puedes reemplazar fácilmente. Tu formateador debe implementar Monolog\Formatter\FormatterInterface.

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-services:
-    my_formatter:
-        class: Monolog\Formatter\JsonFormatter
-monolog:
-    handlers:
-        file:
-            type: stream
-            level: debug
-            formatter: my_formatter
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:monolog="http://symfony.com/schema/dic/monolog"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/monolog http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-        <services>
-        <service id="my_formatter" class="Monolog\Formatter\JsonFormatter" />
-        </services>
-
-    <monolog:config>
-        <monolog:handler
-            name="file"
-            type="stream"
-            level="debug"
-            formatter="my_formatter"
-        />
-    </monolog:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container
-    ->register('my_formatter', 'Monolog\Formatter\JsonFormatter');
-
-$container->loadFromExtension('monolog', array(
-    'handlers' => array(
-        'file' => array(
-            'type'      => 'stream',
-            'level'     => 'debug',
-            'formatter' => 'my_formatter',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Agregando algunos datos adicionales en los mensajes de registro

                  -

                  Monolog te permite procesar el registro del evento antes de ingresarlo añadiendo algunos datos adicionales. Un procesador se puede aplicar al controlador de toda la pila o sólo a un controlador específico.

                  -

                  Un procesador simplemente es un ejecutable que recibe el registro como primer argumento.

                  -

                  Los procesadores se configuran usando la etiqueta DIC monolog.processor. Consulta la referencia sobre esto.

                  -
                  -

                  Agregando un segmento Sesión/Petición

                  -

                  A veces es difícil saber cuál de las entradas en el registro pertenece a cada sesión y/o petición. En el siguiente ejemplo agregaremos una ficha única para cada petición usando un procesador.

                  -
                  namespace Acme\MiBundle;
-
-use Symfony\Component\HttpFoundation\Session\Session;
-
-class SessionRequestProcessor
-{
-    private $session;
-    private $token;
-
-    public function __construct(Session $session)
-    {
-        $this->session = $session;
-    }
-
-    public function processRecord(array $record)
-    {
-        if (null === $this->token) {
-            try {
-                $this->token = substr($this->session->getId(), 0, 8);
-            } catch (\RuntimeException $e) {
-                $this->token = '????????';
-            }
-            $this->token .= '-' . substr(uniqid(), -8);
-        }
-        $record['extra']['token'] = $this->token;
-
-        return $record;
-    }
-}
-
                  -
                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-services:
-    monolog.formatter.session_request:
-        class: Monolog\Formatter\LineFormatter
-        arguments:
-            - "[%%datetime%%] [%%extra.token%%] %%channel%%.%%level_name%%: %%message%%\n"
-
-    monolog.processor.session_request:
-        class: Acme\MyBundle\SessionRequestProcessor
-        arguments:  ["@session"]
-        tags:
-                - { name: monolog.processor, method: processRecord }
-
-monolog:
-    handlers:
-        main:
-            type: stream
-            path: "%kernel.logs_dir%/%kernel.environment%.log"
-            level: debug
-            formatter: monolog.formatter.session_request
-
                    -
                    -
                    • -
                  • XML
                    <container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:monolog="http://symfony.com/schema/dic/monolog"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/monolog http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-        <services>
-        <service id="monolog.formatter.session_request" class="Monolog\Formatter\LineFormatter">
-            <argument>[%%datetime%%] [%%extra.token%%] %%channel%%.%%level_name%%: %%message%%\n</argument>
-        </service>
-
-        <service id="monolog.processor.session_request" class="Acme\MyBundle\SessionRequestProcessor">
-            <argument type="service" id="session" />
-            <tag name="monolog.processor" method="processRecord" />
-        </service>
-        </services>
-
-    <monolog:config>
-        <monolog:handler
-            name="main"
-            type="stream"
-            path="%kernel.logs_dir%/%kernel.environment%.log"
-            level="debug"
-            formatter="monolog.formatter.session_request"
-        />
-    </monolog:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container
-    ->register('monolog.formatter.session_request', 'Monolog\Formatter\LineFormatter')
-    ->addArgument('[%%datetime%%] [%%extra.token%%] %%channel%%.%%level_name%%: %%message%%\n');
-
-$container
-    ->register('monolog.processor.session_request', 'Acme\MyBundle\SessionRequestProcessor')
-    ->addArgument(new Reference('session'))
-    ->addTag('monolog.processor', array('method' => 'processRecord'));
-
-$container->loadFromExtension('monolog', array(
-    'handlers' => array(
-        'main' => array(
-            'type'      => 'stream',
-            'path'      => '%kernel.logs_dir%/%kernel.environment%.log',
-            'level'     => 'debug',
-            'formatter' => 'monolog.formatter.session_request',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Si utilizas varios manipuladores, también puedes registrar el procesador a nivel del manipulador en lugar de globalmente.

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/logging/monolog_email.html b/cookbook/logging/monolog_email.html deleted file mode 100644 index fb2f99a..0000000 --- a/cookbook/logging/monolog_email.html +++ /dev/null @@ -1,327 +0,0 @@ - - - - - - - Cómo configurar Monolog para reportar errores por correo electrónico — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo configurar Monolog para reportar errores por correo electrónico

                  -

                  Puedes configurar a Monolog para que envíe un correo electrónico cuando ocurra un error en una aplicación. La configuración para esto requiere unos cuantos controladores anidados a fin de evitar recibir demasiados mensajes de correo electrónico. Esta configuración se ve complicada al principio, pero cada controlador es bastante sencillo cuando lo diseccionas.

                  -
                  -
                    -
                  • YAML
                    # app/config/config_prod.yml
-monolog:
-    handlers:
-        mail:
-            type:         fingers_crossed
-            action_level: critical
-            handler:      buffered
-        buffered:
-            type:    buffer
-            handler: swift
-        swift:
-            type:       swift_mailer
-            from_email: error@example.com
-            to_email:   error@example.com
-            subject:    An Error Occurred!
-            level:      debug
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_prod.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:monolog="http://symfony.com/schema/dic/monolog"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/monolog http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-    <monolog:config>
-        <monolog:handler
-            name="mail"
-            type="fingers_crossed"
-            action-level="critical"
-            handler="buffered"
-        />
-        <monolog:handler
-            name="buffered"
-            type="buffer"
-            handler="swift"
-        />
-        <monolog:handler
-            name="swift"
-            from-email="error@example.com"
-            to-email="error@example.com"
-            subject="An Error Occurred!"
-            level="debug"
-        />
-    </monolog:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_prod.php
-$container->loadFromExtension('monolog', array(
-    'handlers' => array(
-        'mail' => array(
-            'type'         => 'fingers_crossed',
-            'action_level' => 'critical',
-            'handler'      => 'buffered',
-        ),
-        'buffered' => array(
-            'type'    => 'buffer',
-            'handler' => 'swift',
-        ),
-        'swift' => array(
-            'type'       => 'swift_mailer',
-            'from_email' => 'error@example.com',
-            'to_email'   => 'error@example.com',
-            'subject'    => 'An Error Occurred!',
-            'level'      => 'debug',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  El controlador mail es un controlador fingers_crossed lo cuál significa que sólo es lanzado cuándo se alcanza el nivel de acción, en este caso crítico. -Entonces registra todo, incluyendo, los mensajes bajo el nivel de acción. El nivel crítico sólo se lanza para códigos de error HTTP 5xx. Establecer el handler significa que el resultado entonces se pasa al controlador buffered.

                  -
                  -

                  Truco

                  -

                  Si quieres que ambos niveles de error 400 y 500 emitan un mensaje de correo electrónico, fija el action_level a error en vez de a critical.

                  -
                  -

                  El controlador buffered sencillamente guarda todos los mensajes para una petición y luego los pasa al controlador anidado para enviar solamente uno. Si no utilizas este controlador entonces cada mensaje será enviado por separado. Este entonces es pasado al controlador swift. Este es el controlador que de hecho trata de enviarte el error. Los ajustes para este son directos, las direcciones to, from y subject.

                  -

                  Puedes combinar estos controladores con otros a modo de que los errores todavía sean registrados en el servidor y enviados:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_prod.yml
-monolog:
-    handlers:
-        main:
-            type:         fingers_crossed
-            action_level: critical
-            handler:      grouped
-        grouped:
-            type:    group
-            members: [streamed, buffered]
-        streamed:
-            type:  stream
-            path:  "%kernel.logs_dir%/%kernel.environment%.log"
-            level: debug
-        buffered:
-            type:    buffer
-            handler: swift
-        swift:
-            type:       swift_mailer
-            from_email: error@example.com
-            to_email:   error@example.com
-            subject:    An Error Occurred!
-            level:      debug
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_prod.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:monolog="http://symfony.com/schema/dic/monolog"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/monolog http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-    <monolog:config>
-        <monolog:handler
-            name="main"
-            type="fingers_crossed"
-            action_level="critical"
-            handler="grouped"
-        />
-        <monolog:handler
-            name="grouped"
-            type="group"
-        >
-            <member type="stream"/>
-            <member type="buffered"/>
-        </monolog:handler>
-        <monolog:handler
-            name="stream"
-            path="%kernel.logs_dir%/%kernel.environment%.log"
-            level="debug"
-        />
-        <monolog:handler
-            name="buffered"
-            type="buffer"
-            handler="swift"
-        />
-        <monolog:handler
-            name="swift"
-            from-email="error@example.com"
-            to-email="error@example.com"
-            subject="An Error Occurred!"
-            level="debug"
-        />
-    </monolog:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_prod.php
-$container->loadFromExtension('monolog', array(
-    'handlers' => array(
-        'main' => array(
-            'type'         => 'fingers_crossed',
-            'action_level' => 'critical',
-            'handler'      => 'grouped',
-        ),
-        'grouped' => array(
-            'type'    => 'group',
-            'members' => array('streamed', 'buffered'),
-        ),
-        'streamed'  => array(
-            'type'  => 'stream',
-            'path'  => '%kernel.logs_dir%/%kernel.environment%.log',
-            'level' => 'debug',
-        ),
-        'buffered'    => array(
-            'type'    => 'buffer',
-            'handler' => 'swift',
-        ),
-        'swift' => array(
-            'type'       => 'swift_mailer',
-            'from_email' => 'error@example.com',
-            'to_email'   => 'error@example.com',
-            'subject'    => 'An Error Occurred!',
-            'level'      => 'debug',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Este utiliza el controlador group para enviar los mensajes a los dos miembros del grupo, los controladores buffered y stream. Ahora ambos mensajes serán escritos al archivo de registro y enviados por correo electrónico.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/profiler/data_collector.html b/cookbook/profiler/data_collector.html deleted file mode 100644 index 0fa0f07..0000000 --- a/cookbook/profiler/data_collector.html +++ /dev/null @@ -1,275 +0,0 @@ - - - - - - - Cómo crear un colector de datos personalizado — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear un colector de datos personalizado

                  -

                  El Generador de perfiles de Symfony2 delega la recolección de datos a los colectores de datos. Symfony2 incluye algunos colectores, pero puedes crear el tuyo fácilmente.

                  -
                  -

                  Creando un colector de datos personalizado

                  -

                  Crear un colector de datos personalizado es tan simple como implementar la clase Symfony\Component\HttpKernel\DataCollector\DataCollectorInterface:

                  -
                  interface DataCollectorInterface
-{
-    /**
-     * Collects data for the given Request and Response.
-     *
-     * @param Request    $request   A Request instance
-     * @param Response   $response  A Response instance
-     * @param \Exception $exception An Exception instance
-     */
-    function collect(Request $request, Response $response, \Exception $exception = null);
-
-    /**
-     * Returns the name of the collector.
-     *
-     * @return string The collector name
-     */
-    function getName();
-}
-
                  -
                  -

                  El método getName() debe devolver un nombre único. Este se utiliza para acceder a la información más adelante (consulta Cómo utilizar el generador de perfiles en una prueba funcional para ver un ejemplo).

                  -

                  El método collect() se encarga de almacenar los datos de las propiedades locales a las que quieres dar acceso.

                  -
                  -

                  Prudencia

                  -

                  Puesto que el generador de perfiles serializa instancias del colector de datos, no debes almacenar objetos que no se puedan serializar (como objetos PDO), o tendrás que proporcionar tu propio método serialize().

                  -
                  -

                  La mayoría de las veces, es conveniente extender Symfony\Component\HttpKernel\DataCollector\DataCollector y rellenar los datos de la propiedad $this->data (que se encarga de serializar la propiedad $this->data):

                  -
                  class MemoryDataCollector extends DataCollector
-{
-    public function collect(Request $request, Response $response, \Exception $exception = null)
-    {
-        $this->data = array(
-            'memory' => memory_get_peak_usage(true),
-        );
-    }
-
-    public function getMemory()
-    {
-        return $this->data['memory'];
-    }
-
-    public function getName()
-    {
-        return 'memory';
-    }
-}
-
                  -
                  -
                  -
                  -

                  Habilitando colectores de datos personalizados

                  -

                  Para habilitar un colector de datos, lo tienes que añadir como un servicio regular a tu configuración, y etiquetarlo con data_collector:

                  -
                  -
                    -
                  • YAML
                    services:
-    data_collector.your_collector_name:
-        class: Fully\Qualified\Collector\Class\Name
-        tags:
-                - { name: data_collector }
-
                    -
                    -
                    • -
                  • XML
                    <service id="data_collector.your_collector_name" class="Fully\Qualified\Collector\Class\Name">
-    <tag name="data_collector" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('data_collector.your_collector_name', 'Fully\Qualified\Collector\Class\Name')
-    ->addTag('data_collector')
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Añadiendo el generador de perfiles web en plantillas

                  -

                  Cuando desees mostrar los datos recogidos por el colector de datos en la barra de depuración o el generador de perfiles web, crea una plantilla Twig siguiendo este esqueleto:

                  -
                  {% extends 'WebProfilerBundle:Profiler:layout.html.twig' %}
-
-{% block toolbar %}
-    {# La barra de herramientas para depuración de contenido web #}
-{% endblock %}
-
-{% block head %}
-    {# Si el panel de perfiles web necesita algunos archivos CSS o JS específicos #}
-{% endblock %}
-
-{% block menu %}
-    {# el menú de contenido #}
-{% endblock %}
-
-{% block panel %}
-    {# el panel de contenido #}
-{% endblock %}
-
                  -
                  -

                  Cada bloque es opcional. El bloque toolbar se utiliza para la barra de herramientas de depuración web menu y panel se utilizan para agregar un grupo especial al generador de perfiles web.

                  -

                  Todos los bloques tienen acceso al objeto collector.

                  -
                  -

                  Truco

                  -

                  Built-in templates use a base64 encoded image for the toolbar (<img -src="data:image/png;base64,..."). Puedes calcular el valor base64 para una imagen con este pequeño guión: echo -base64_encode(file_get_contents($_SERVER['argv'][1]));.

                  -
                  -

                  Para habilitar la plantilla, agrega un atributo template a la etiqueta data_collector en tu configuración. Por ejemplo, asumiendo que tu plantilla está en algún AcmeDebugBundle:

                  -
                  -
                    -
                  • YAML
                    services:
-    data_collector.your_collector_name:
-        class: Acme\DebugBundle\Collector\Class\Name
-        tags:
-                - { name: data_collector, template: "AcmeDebugBundle:Collector:templatename", id: "your_collector_name" }
-
                    -
                    -
                    • -
                  • XML
                    <service id="data_collector.your_collector_name" class="Acme\DebugBundle\Collector\Class\Name">
-    <tag name="data_collector" template="AcmeDebugBundle:Collector:templatename" id="your_collector_name" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('data_collector.your_collector_name', 'Acme\DebugBundle\Collector\Class\Name')
-    ->addTag('data_collector', array(
-        'template' => 'AcmeDebugBundle:Collector:templatename',
-        'id'       => 'your_collector_name',
-    ))
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/profiler/index.html b/cookbook/profiler/index.html deleted file mode 100644 index 279edf8..0000000 --- a/cookbook/profiler/index.html +++ /dev/null @@ -1,141 +0,0 @@ - - - - - - - Generador de perfiles — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/request/index.html b/cookbook/request/index.html deleted file mode 100644 index e7b09bc..0000000 --- a/cookbook/request/index.html +++ /dev/null @@ -1,140 +0,0 @@ - - - - - - - Petición — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/request/mime_type.html b/cookbook/request/mime_type.html deleted file mode 100644 index e62cc8a..0000000 --- a/cookbook/request/mime_type.html +++ /dev/null @@ -1,202 +0,0 @@ - - - - - - - Cómo registrar un nuevo formato de petición y tipo MIME — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo registrar un nuevo formato de petición y tipo MIME

                  -

                  Cada Petición tiene un «formato» (por ejemplo, html, json), el cual se utiliza para determinar qué tipo de contenido regresar en la Respuesta. De hecho, el formato de petición, accesible a través del método getRequestFormat(), se utiliza para establecer el tipo MIME de la cabecera Content-Type en el objeto Respuesta. Internamente, Symfony incluye un mapa de los formatos más comunes (por ejemplo, html, json) y sus correspondientes tipos MIME (por ejemplo, text/html, application/json). Por supuesto, se pueden agregar entradas de formato tipo MIME adicionales fácilmente. Este documento te mostrará cómo puedes agregar el formato jsonp y el tipo MIME correspondiente.

                  -
                  -

                  Creando un escucha de kernel.request

                  -

                  La clave para definir un nuevo tipo MIME es crear una clase que debe «escuchar» el evento kernel.request enviado por el núcleo de Symfony. El evento kernel.request se difunde temprano en Symfony, el controlador de la petición lo procesa y te permite modificar el objeto Petición.

                  -

                  Crea la siguiente clase, sustituyendo la ruta con una ruta a un paquete en tu proyecto:

                  -
                  // src/Acme/DemoBundle/RequestListener.php
-namespace Acme\DemoBundle;
-
-use Symfony\Component\HttpKernel\HttpKernelInterface;
-use Symfony\Component\HttpKernel\Event\GetResponseEvent;
-
-class RequestListener
-{
-    public function onKernelRequest(GetResponseEvent $event)
-    {
-        $event->getRequest()->setFormat('jsonp', 'application/javascript');
-    }
-}
-
                  -
                  -
                  -
                  -

                  Registrando tu escucha

                  -

                  As with any other listener, you need to add it in one of your configuration -files and register it as a listener by adding the kernel.event_listener tag:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-services:
-    acme.demobundle.listener.request:
-        class: Acme\DemoBundle\RequestListener
-        tags:
-                - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<?xml version="1.0" ?>
-
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
-        <services>
-    <service id="acme.demobundle.listener.request" class="Acme\DemoBundle\RequestListener">
-        <tag name="kernel.event_listener" event="kernel.request" method="onKernelRequest" />
-    </service>
-        </services>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    # app/config/config.php
-$definition = new Definition('Acme\DemoBundle\RequestListener');
-$definition->addTag('kernel.event_listener', array(
-    'event'  => 'kernel.request',
-    'method' => 'onKernelRequest',
-));
-$container->setDefinition('acme.demobundle.listener.request', $definition);
-
                    -
                    -
                    • -
                  -
                  -

                  En este punto, el servicio acme.demobundle.listener.request se ha configurado y será notificado cuando el núcleo de Symfony difunda el evento kernel.request.

                  -
                  -

                  Truco

                  -

                  También puedes registrar el escucha en una clase de configuración llamada Extension (consulta Importando configuración vía el contenedor de extensiones para más información).

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/routing/custom_route_loader.html b/cookbook/routing/custom_route_loader.html deleted file mode 100644 index 3fa39b0..0000000 --- a/cookbook/routing/custom_route_loader.html +++ /dev/null @@ -1,378 +0,0 @@ - - - - - - - How to create a custom Route Loader — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  How to create a custom Route Loader

                  -

                  A custom route loader allows you to add routes to an application without -including them, for example, in a Yaml file. This comes in handy when -you have a bundle but don’t want to manually add the routes for the bundle -to app/config/routing.yml. This may be especially important when you want -to make the bundle reusable, or when you have open-sourced it as this would -slow down the installation process and make it error-prone.

                  -

                  Alternatively, you could also use a custom route loader when you want your -routes to be automatically generated or located based on some convention or -pattern. One example is the FOSRestBundle where routing is generated based -off the names of the action methods in a controller.

                  -
                  -

                  Nota

                  -

                  There are many bundles out there that use their own route loaders to -accomplish cases like those described above, for instance -FOSRestBundle, KnpRadBundle and SonataAdminBundle.

                  -
                  -
                  -

                  Loading Routes

                  -

                  The routes in a Symfony application are loaded by the -Symfony\Bundle\FrameworkBundle\Routing\DelegatingLoader. -This loader uses several other loaders (delegates) to load resources of -different types, for instance Yaml files or @Route and @Method annotations -in controller files. The specialized loaders implement -Symfony\Component\Config\Loader\LoaderInterface -and therefore have two important methods: -supports() -and load().

                  -

                  Take these lines from routing.yml:

                  -
                  _demo:
-    resource: "@AcmeDemoBundle/Controller/DemoController.php"
-    type:     annotation
-    prefix:   /demo
-
                  -
                  -

                  When the main loader parses this, it tries all the delegate loaders and calls -their supports() -method with the given resource (@AcmeDemoBundle/Controller/DemoController.php) -and type (annotation) as arguments. When one of the loader returns true, -its load() method -will be called, which should return a Symfony\Component\Routing\RouteCollection -containing Symfony\Component\Routing\Route objects.

                  -
                  -
                  -

                  Creating a Custom Loader

                  -

                  To load routes from some custom source (i.e. from something other than annotations, -Yaml or XML files), you need to create a custom route loader. This loader -should implement Symfony\Component\Config\Loader\LoaderInterface.

                  -

                  The sample loader below supports loading routing resources with a type of -extra. The type extra isn’t important - you can just invent any resource -type you want. The resource name itself is not actually used in the example:

                  -
                  namespace Acme\DemoBundle\Routing;
-
-use Symfony\Component\Config\Loader\LoaderInterface;
-use Symfony\Component\Config\Loader\LoaderResolver;
-use Symfony\Component\Routing\Route;
-use Symfony\Component\Routing\RouteCollection;
-
-class ExtraLoader implements LoaderInterface
-{
-    private $loaded = false;
-
-    public function load($resource, $type = null)
-    {
-        if (true === $this->loaded) {
-            throw new \RuntimeException('Do not add the "extra" loader twice');
-        }
-
-        $routes = new RouteCollection();
-
-        // prepare a new route
-        $pattern = '/extra/{parameter}';
-        $defaults = array(
-            '_controller' => 'AcmeDemoBundle:Demo:extra',
-        );
-        $requirements = array(
-            'parameter' => '\d+',
-        );
-        $route = new Route($pattern, $defaults, $requirements);
-
-        // add the new route to the route collection:
-        $routeName = 'extraRoute';
-        $routes->add($routeName, $route);
-
-        return $routes;
-    }
-
-    public function supports($resource, $type = null)
-    {
-        return 'extra' === $type;
-    }
-
-    public function getResolver()
-    {
-        // needed, but can be blank, unless you want to load other resources
-        // and if you do, using the Loader base class is easier (see below)
-    }
-
-    public function setResolver(LoaderResolver $resolver)
-    {
-        // same as above
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Make sure the controller you specify really exists.

                  -
                  -

                  Now define a service for the ExtraLoader:

                  -
                  -
                    -
                  • YAML
                    services:
-    acme_demo.routing_loader:
-        class: Acme\DemoBundle\Routing\ExtraLoader
-        tags:
-                - { name: routing.loader }
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" ?>
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
-
-        <services>
-        <service id="acme_demo.routing_loader" class="Acme\DemoBundle\Routing\ExtraLoader">
-            <tag name="routing.loader" />
-        </service>
-        </services>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-
-$container
-    ->setDefinition(
-        'acme_demo.routing_loader',
-        new Definition('Acme\DemoBundle\Routing\ExtraLoader')
-    )
-    ->addTag('routing.loader')
-;
-
                    -
                    -
                    • -
                  -
                  -

                  Notice the tag routing.loader. All services with this tag will be marked -as potential route loaders and added as specialized routers to the -Symfony\Bundle\FrameworkBundle\Routing\DelegatingLoader.

                  -
                  -

                  Using the Custom Loader

                  -

                  If you did nothing else, your custom routing loader would not be called. -Instead, you only need to add a few extra lines to the routing configuration:

                  -
                  -
                    -
                  • YAML
                    # app/config/routing.yml
-AcmeDemoBundle_Extra:
-    resource: .
-    type: extra
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <import resource="." type="extra" />
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-
-$collection = new RouteCollection();
-$collection->addCollection($loader->import('.', 'extra'));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  The important part here is the type key. Its value should be “extra”. -This is the type which our ExtraLoader supports and this will make sure -its load() method gets called. The resource key is insignificant -for the ExtraLoader, so we set it to ”.”.

                  -
                  -

                  Nota

                  -

                  The routes defined using custom route loaders will be automatically -cached by the framework. So whenever you change something in the loader -class itself, don’t forget to clear the cache.

                  -
                  -
                  -
                  -
                  -

                  More Advanced Loaders

                  -

                  In most cases it’s better not to implement -Symfony\Component\Config\Loader\LoaderInterface -yourself, but extend from Symfony\Component\Config\Loader\Loader. -This class knows how to use a Symfony\Component\Config\Loader\LoaderResolver -to load secondary routing resources.

                  -

                  Of course you still need to implement -supports() -and load(). -Whenever you want to load another resource - for instance a Yaml routing -configuration file - you can call the -import() method:

                  -
                  namespace Acme\DemoBundle\Routing;
-
-use Symfony\Component\Config\Loader\Loader;
-use Symfony\Component\Routing\RouteCollection;
-
-class AdvancedLoader extends Loader
-{
-    public function load($resource, $type = null)
-    {
-        $collection = new RouteCollection();
-
-        $resource = '@AcmeDemoBundle/Resources/config/import_routing.yml';
-        $type = 'yaml';
-
-        $importedRoutes = $this->import($resource, $type);
-
-        $collection->addCollection($importedRoutes);
-
-        return $collection;
-    }
-
-    public function supports($resource, $type = null)
-    {
-        return $type === 'advanced_extra';
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  The resource name and type of the imported routing configuration can -be anything that would normally be supported by the routing configuration -loader (Yaml, XML, PHP, annotation, etc.).

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/routing/index.html b/cookbook/routing/index.html deleted file mode 100644 index 7754185..0000000 --- a/cookbook/routing/index.html +++ /dev/null @@ -1,152 +0,0 @@ - - - - - - - Enrutando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/routing/method_parameters.html b/cookbook/routing/method_parameters.html deleted file mode 100644 index 6097054..0000000 --- a/cookbook/routing/method_parameters.html +++ /dev/null @@ -1,225 +0,0 @@ - - - - - - - Cómo utilizar métodos HTTP además de GET y POST en rutas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar métodos HTTP además de GET y POST en rutas

                  -

                  El método HTTP de la petición es uno de los requisitos que se pueden comprobar al ver si coincide con una ruta. Este se introduce en el capítulo de enrutado del libro «Enrutando», con ejemplos del uso de GET y POST. También puedes utilizar otros verbos HTTP de esta manera. Por ejemplo, si tienes una entrada del blog entonces podrías usar la misma ruta URL para mostrarla, hacerle cambios y eliminarla emparejándola con GET, POST y DELETE.

                  -
                  -
                    -
                  • YAML
                    blog_show:
-    path:     /blog/{slug}
-    defaults: { _controller: AcmeDemoBundle:Blog:show }
-    methods:   [GET]
-
-blog_update:
-    path:     /blog/{slug}
-    defaults: { _controller: AcmeDemoBundle:Blog:update }
-    methods:   [PUT]
-
-blog_delete:
-    path:     /blog/{slug}
-    defaults: { _controller: AcmeDemoBundle:Blog:delete }
-    methods:   [DELETE]
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="blog_show" path="/blog/{slug}" methods="GET">
-        <default key="_controller">AcmeDemoBundle:Blog:show</default>
-    </route>
-
-    <route id="blog_update" path="/blog/{slug}" methods="PUT">
-        <default key="_controller">AcmeDemoBundle:Blog:update</default>
-    </route>
-
-    <route id="blog_delete" path="/blog/{slug}" methods="DELETE">
-        <default key="_controller">AcmeDemoBundle:Blog:delete</default>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('blog_show', new Route('/blog/{slug}', array(
-    '_controller' => 'AcmeDemoBundle:Blog:show',
-), array(), array(), '', array(), array('GET')));
-
-$collection->add('blog_update', new Route('/blog/{slug}', array(
-    '_controller' => 'AcmeDemoBundle:Blog:update',
-), array(), array(), '', array(), array('PUT')));
-
-$collection->add('blog_delete', new Route('/blog/{slug}', array(
-    '_controller' => 'AcmeDemoBundle:Blog:delete',
-), array(), array(), '', array('DELETE')));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Faking the Method with _method

                  -
                  -

                  Nota

                  -

                  The _method functionality shown here is disabled by default in Symfony 2.2 -and enabled by default in Symfony 2.3. To control it in Symfony 2.2, you -must call Request::enableHttpMethodParameterOverride -before you handle the request (e.g. in your front controller). In Symfony -2.3, use the http_method_override option.

                  -
                  -

                  Desafortunadamente, la vida no es así de simple, ya que la mayoría de los navegadores no son compatibles con el envío de peticiones PUT y DELETE. Afortunadamente Symfony2 te proporciona una forma sencilla de trabajar en torno a esta limitación. Al incluir un argumento _method en la cadena de consulta o en los parámetros de una petición HTTP, Symfony2 lo utilizará como el método a coincidir con las rutas. Esto se puede hacer fácilmente en formularios con un campo oculto. Supongamos que tienes un formulario para editar una entrada de blog:

                  -
                  <form action="{{ path('blog_update', {'slug': blog.slug}) }}" method="post">
-    <input type="hidden" name="_method" value="PUT" />
-    {{ form_widget(form) }}
-    <input type="submit" value="Update" />
-</form>
-
                  -
                  -

                  La petición presentada ahora coincide con la ruta blog_update y usará el updateAction para procesar el formulario.

                  -

                  Del mismo modo puedes cambiar el formulario de eliminación para que se parezca a esto:

                  -
                  <form action="{{ path('blog_delete', {'slug': blog.slug}) }}" method="post">
-    <input type="hidden" name="_method" value="DELETE" />
-    {{ form_widget(delete_form) }}
-    <input type="submit" value="Delete" />
-</form>
-
                  -
                  -

                  Entonces, este coincidirá con la ruta blog_delete.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/routing/redirect_in_config.html b/cookbook/routing/redirect_in_config.html deleted file mode 100644 index 1bbfb34..0000000 --- a/cookbook/routing/redirect_in_config.html +++ /dev/null @@ -1,155 +0,0 @@ - - - - - - - Cómo configurar una redirección a otra ruta sin un controlador personalizado — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo configurar una redirección a otra ruta sin un controlador personalizado

                  -

                  Esta guía explica cómo configurar un redireccionamiento de una ruta a otra sin necesidad de utilizar un controlador personalizado.

                  -

                  Supone que no hay ningún controlador predefinido útil para la ruta / de tu aplicación y deseas redirigir esas peticiones a /app.

                  -

                  Tu configuración se ve así:

                  -
                  AppBundle:
-    resource: "@App/Controller/"
-    type:     annotation
-    prefix:   /app
-
-root:
-    path:     /
-    defaults:
-        _controller: FrameworkBundle:Redirect:urlRedirect
-        path: /app
-        permanent: true
-
                  -
                  -

                  En este ejemplo, configuras una ruta para / y dejas que Symfony\Bundle\FrameworkBundle\Controller\RedirectController la maneje. Este controlador viene integrado en Symfony y ofrece dos métodos para redirigir una petición:

                  -
                    -
                  • urlRedirect redirige a otra ruta. Debes proporcionar el argumento ruta que contiene la ruta del recurso al que deseas redirigir.
                    • -
                  • redirect (no mostrado aquí) redirige a otra ruta. Debes proporcionar el argumento ruta con el nombre de la ruta a la cual deseas redirigir.
                    • -
                  -

                  La opción permanent instruye a ambos métodos para emitir un código de estado HTTP 301.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/routing/scheme.html b/cookbook/routing/scheme.html deleted file mode 100644 index 63f46b7..0000000 --- a/cookbook/routing/scheme.html +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - Cómo forzar las rutas para que siempre usen HTTPS o HTTP — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo forzar las rutas para que siempre usen HTTPS o HTTP

                  -

                  A veces, deseas proteger algunas rutas y estar seguro de que siempre se accede a ellas a través del protocolo HTTPS. El componente Routing te permite forzar la estratégia de la URI a través de esquemas:

                  -
                  -
                    -
                  • YAML
                    secure:
-    path:     /secure
-    defaults: { _controller: AcmeDemoBundle:Main:secure }
-    schemes:  [https]
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="secure" path="/secure" schemes="http">
-        <default key="_controller">AcmeDemoBundle:Main:secure</default>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('secure', new Route('/secure', array(
-    '_controller' => 'AcmeDemoBundle:Main:secure',
-), array(), array(), '', array('https')));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  La configuración anterior obliga a utilizar siempre la ruta protegida HTTPS.

                  -

                  Cuando se genera la URL protegida, y si el esquema actual es HTTP, Symfony generará automáticamente una URL absoluta con HTTPS como esquema:

                  -
                  {# Si el esquema actual es HTTPS #}
-{{ path('secure') }}
-# genera /secure
-
-{# Si el esquema actual es HTTP #}
-{{ path('secure') }}
-{# genera https://example.com/secure #}
-
                  -
                  -

                  El requisito también aplica para las peticiones entrantes. Si intentas acceder a la ruta /secure con HTTP, automáticamente se te redirige a la misma URL, pero con el esquema HTTPS.

                  -

                  El ejemplo anterior utiliza la estratégia https, pero también puedes forzar que una URL siempre utilice http.

                  -
                  -

                  Nota

                  -

                  El componente Security proporciona otra manera de forzar el esquema HTTP a través de la opción requires_channel. Este método alternativo es más adecuado para proteger «una extensa área» de tu sitio web (todas las URL en /admin) o cuando deseas proteger direcciones URL definidas en un paquete de terceros.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/routing/service_container_parameters.html b/cookbook/routing/service_container_parameters.html deleted file mode 100644 index 326f071..0000000 --- a/cookbook/routing/service_container_parameters.html +++ /dev/null @@ -1,240 +0,0 @@ - - - - - - - Cómo utilizar parámetros del contenedor de servicios en tus rutas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar parámetros del contenedor de servicios en tus rutas

                  -

                  -Nuevo en la versión 2.1: La capacidad para usar parámetros en tus rutas se añadió en Symfony 2.1.

                  -

                  En ocasiones, posiblemente te resulte útil hacer configurables globalmente algunas partes de tus rutas. Por ejemplo, si construyes un sitio internacionalizado, probablemente sea bueno comenzar con una o dos localidades. Seguramente vas a añadir un requisito a tus rutas para evitar que un usuario coincida con una región que no estás apoyando.

                  -

                  Podrías codificar tu requisito _locale en todas tus rutas. Pero la mejor solución es utilizar un parámetro configurable del contenedor de servicios justo dentro de la configuración de enrutado:

                  -
                  -
                    -
                  • YAML
                    contact:
-    path:     /{_locale}/contact
-    defaults: { _controller: AcmeDemoBundle:Main:contact }
-    requirements:
-        _locale: %acme_demo.locales%
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="contact" path="/{_locale}/contact">
-        <default key="_controller">AcmeDemoBundle:Main:contact</default>
-        <requirement key="_locale">%acme_demo.locales%</requirement>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('contact', new Route('/{_locale}/contact', array(
-    '_controller' => 'AcmeDemoBundle:Main:contact',
-), array(
-    '_locale' => '%acme_demo.locales%',
-)));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, puedes controlar y poner el parámetro acme_demo.locales en algún lugar en tu contenedor:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-parameters:
-    acme_demo.locales: en|es
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<parameters>
-    <parameter key="acme_demo.locales">en|es</parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    # app/config/config.php
-$container->setParameter('acme_demo.locales', 'en|es');
-
                    -
                    -
                    • -
                  -
                  -

                  También puedes utilizar un parámetro para definir la trayectoria (completa o parte) de tu -ruta):

                  -
                  -
                    -
                  • YAML
                    some_route:
-    path:     /%acme_demo.route_prefix%/contact
-    defaults: { _controller: AcmeDemoBundle:Main:contact }
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="some_route" path="/%acme_demo.route_prefix%/contact">
-        <default key="_controller">AcmeDemoBundle:Main:contact</default>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('some_route', new Route('/%acme_demo.route_prefix%/contact', array(
-    '_controller' => 'AcmeDemoBundle:Main:contact',
-)));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Justo como en los archivos de configuración de contenedor de servicio normal, si realmente necesitas un % en tu ruta, puedes escapar el signo de porcentaje duplicándolo, p. ej. /puntuacion-50%%, la cual resolvería a /puntuacion-50%.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/routing/slash_in_parameter.html b/cookbook/routing/slash_in_parameter.html deleted file mode 100644 index d251b89..0000000 --- a/cookbook/routing/slash_in_parameter.html +++ /dev/null @@ -1,197 +0,0 @@ - - - - - - - Cómo permitir un carácter «/» en un parámetro de ruta — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo permitir un carácter «/» en un parámetro de ruta

                  -

                  A veces, es necesario componer las URL con parámetros que pueden contener una barra inclinada /. Por ejemplo, tomemos la ruta clásica /hello/{name}. Por omisión, /hello/Fabien coincidirá con esta ruta pero no /hello/Fabien/Kris. Esto se debe a que Symfony utiliza este carácter como separador entre las partes de la ruta.

                  -

                  Esta guía explica cómo puedes modificar una ruta para que /hello/Fabien/Kris coincida con la ruta /hello/{name}, donde {name} es igual a Fabien/Kris.

                  -
                  -

                  Configurando la ruta

                  -

                  De manera predeterminada, el componente Routing de Symfony requiere que los parámetros -emparejen la siguiente expresión regular de ruta: [^/]+. Esto significa que todos los caracteres están permitidos excepto /.

                  -

                  Explícitamente tienes que permitir que el carácter / sea parte de tu parámetro especificando una expresión regular de ruta más permisiva.

                  -
                  -
                    -
                  • YAML
                    _hello:
-    path:     /hello/{name}
-    defaults: { _controller: AcmeDemoBundle:Demo:hello }
-    requirements:
-        name: ".+"
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="_hello" path="/hello/{name}">
-        <default key="_controller">AcmeDemoBundle:Demo:hello</default>
-        <requirement key="name">.+</requirement>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('_hello', new Route('/hello/{name}', array(
-    '_controller' => 'AcmeDemoBundle:Demo:hello',
-), array(
-    'name' => '.+',
-)));
-
-return $collection;
-
                    -
                    -
                    • -
                  • Annotations
                    use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-
-class DemoController
-{
-    /**
-     * @Route("/hello/{name}", name="_hello", requirements={"name" = ".+"})
-     */
-    public function helloAction($name)
-    {
-        // ...
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  ¡Eso es todo! Ahora, el parámetro {name} puede contener el carácter /.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/acl.html b/cookbook/security/acl.html deleted file mode 100644 index 7044466..0000000 --- a/cookbook/security/acl.html +++ /dev/null @@ -1,293 +0,0 @@ - - - - - - - Cómo usar las listas para el control de acceso (ACL) — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar las listas para el control de acceso (ACL)

                  -

                  En aplicaciones complejas, a menudo te enfrentas al problema de que las decisiones de acceso no se pueden basar únicamente en la persona (Token) que está solicitando el acceso, sino también implica un objeto dominio al cual se está solicitando acceso. Aquí es donde entra en juego el sistema ACL.

                  -

                  Imagina que estás diseñando un sistema de blog donde los usuarios pueden comentar tus entradas. Ahora, deseas que un usuario pueda editar sus propios comentarios, pero no los de otros usuarios. Además, como usuario admin, quieres tener la posibilidad de editar todos los comentarios. En este escenario, Comentario sería nuestro objeto dominio al cual deseas restringir el acceso. Podrías tomar varios enfoques para lograr esto usando Symfony2, dos enfoques básicos (no exhaustivos) son:

                  -
                    -
                  • Reforzar la seguridad en los métodos de tu negocio: Básicamente, significa mantener una referencia dentro de cada comentario a todos los usuarios que tienen acceso, y luego comparar estos usuarios al Token provisto.
                    • -
                  • Reforzar la seguridad con roles: En este enfoque, debes agregar un rol a cada objeto comentario, es decir, ROLE_COMMENT_1, ROLE_COMMENT_2, etc.
                    • -
                  -

                  Ambos enfoques son perfectamente válidos. Sin embargo, su pareja lógica de autorización a tu código del negocio lo hace menos reutilizable en otros lugares, y también aumenta la dificultad de las pruebas unitarias. Además, posiblemente tengas problemas de rendimiento si muchos usuarios tuvieran acceso a un único objeto dominio.

                  -

                  Afortunadamente, hay una manera mejor, de la cual hablaremos ahora.

                  -
                  -

                  Proceso de arranque

                  -

                  Ahora, antes de que finalmente puedas entrar en acción, necesitas hacer un poco del proceso de arranque (bootstrapping). -En primer lugar, tienes que configurar la conexión al sistema ACL que se supone vas a usar:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    acl:
-        connection: default
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<acl>
-    <connection>default</connection>
-</acl>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', 'acl', array(
-    'connection' => 'default',
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  El sistema ACL requiere que configures cuando menos una conexión DBAL con Doctrine (utilizable de manera predeterminada) o MongoDB de Docrine (utilizable con MongoDBAclBundle). Sin embargo, eso no significa que tengas que utilizar Doctrine para asociar tus objetos del dominio. Puedes usar cualquier asignador de objetos que gustes, ya sea el ORM de Doctrine, ODM de MongoDB, Propel, o SQL crudo, etc. La elección es tuya

                  -
                  -

                  Después de configurar la conexión, tienes que importar la estructura de la base de datos. -Afortunadamente, existe una tarea para eso precisamente. Basta con ejecutar la siguiente orden:

                  -
                  $ php app/console init:acl
-
                  -
                  -
                  -
                  -

                  Cómo empezar

                  -

                  Volviendo al pequeño ejemplo desde el principio, implementarás ACL para ello.

                  -
                  -

                  Creando una ACL, y añade una ACE

                  -
                  // src/Acme/DemoBundle/Controller/BlogController.php
-namespace Acme\DemoBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-use Symfony\Component\Security\Acl\Domain\ObjectIdentity;
-use Symfony\Component\Security\Acl\Domain\UserSecurityIdentity;
-use Symfony\Component\Security\Acl\Permission\MaskBuilder;
-
-class BlogController
-{
-    // ...
-
-    public function addCommentAction(Post $post)
-    {
-        $comment = new Comment();
-
-        // ... configura $form, y vincula datos
-
-        if ($form->isValid()) {
-            $entityManager = $this->getDoctrine()->getManager();
-            $entityManager->persist($comment);
-            $entityManager->flush();
-
-            // creando la ACL
-            $aclProvider = $this->get('security.acl.provider');
-            $objectIdentity = ObjectIdentity::fromDomainObject($comment);
-            $acl = $aclProvider->createAcl($objectIdentity);
-
-            // recupera la identidad de seguridad del usuario
-            // registrado actualmente
-            $securityContext = $this->get('security.context');
-            $user = $securityContext->getToken()->getUser();
-            $securityIdentity = UserSecurityIdentity::fromAccount($user);
-
-            // otorga permiso de propietario
-            $acl->insertObjectAce($securityIdentity, MaskBuilder::MASK_OWNER);
-            $aclProvider->updateAcl($acl);
-        }
-    }
-}
-
                  -
                  -

                  Hay un par de decisiones de implementación importantes en este fragmento de código. -Por ahora, sólo quiero destacar dos:

                  -

                  En primer lugar, te habrás dado cuenta de que ->createAcl() no acepta objetos de dominio directamente, sino sólo implementaciones de ObjectIdentityInterface. -Este paso adicional de desvío te permite trabajar con ACL, incluso cuando no tienes a mano ninguna instancia real del objeto dominio. Esto será muy útil si deseas comprobar los permisos de un gran número de objetos sin tener que hidratar estos objetos.

                  -

                  La otra parte interesante es la llamada a ->insertObjectAce(). En el ejemplo, estas otorgando acceso de propietario al comentario al usuario que ha iniciado sesión. MaskBuilder::MASK_OWNER es una máscara de bits enteros predefinida; -no te preocupe que el constructor de la máscara abstraiga la mayoría de los detalles técnicos, pero gracias a esta técnica puedes almacenar muchos permisos diferentes en la fila de la base de datos, lo cual te dá un considerable impulso en rendimiento.

                  -
                  -

                  Truco

                  -

                  El orden en que las ACE son revisadas es significativo. Como regla general, debes poner las entradas más específicas al principio.

                  -
                  -
                  -
                  -

                  Comprobando el acceso

                  -
                  // src/Acme/DemoBundle/Controller/BlogController.php
-
-// ...
-
-class BlogController
-{
-    // ...
-
-    public function editCommentAction(Comment $comment)
-    {
-        $securityContext = $this->get('security.context');
-
-        // verifica el acceso para edición
-        if (false === $securityContext->isGranted('EDIT', $comment))
-        {
-            throw new AccessDeniedException();
-        }
-
-        // recupera el objeto comentario actual, y realiza tu edición aquí
-    }
-}
-
                  -
                  -

                  En este ejemplo, comproebas si el usuario tiene el permiso de EDICIÓN. -Internamente, Symfony2 asigna el permiso a varias máscaras de bits enteros, y comprueba si el usuario tiene alguno de ellos.

                  -
                  -

                  Nota

                  -

                  Puedes definir hasta 32 permisos base (dependiendo de tu sistema operativo, PHP puede variar entre 30 a 32). Además, también puedes definir permisos acumulados.

                  -
                  -
                  -
                  -
                  -

                  Permisos acumulados

                  -

                  En el primer ejemplo de arriba, sólo concediste al usuario el permiso OWNER base. Si bien este además permite efectivamente al usuario realizar cualquier operación, como ver, editar, etc., sobre el objeto dominio, hay casos en los que deseas conceder explícitamente estos permisos.

                  -

                  Puedes utilizar el MaskBuilder para crear máscaras de bits combinando fácilmente varios permisos base:

                  -
                  $builder = new MaskBuilder();
-$builder
-    ->add('view')
-    ->add('edit')
-    ->add('delete')
-    ->add('undelete')
-;
-$mask = $builder->get(); // int(29)
-
                  -
                  -

                  Esta máscara de bits de enteros, luego se puede utilizar para conceder a un usuario los permisos base añadidos anteriormente:

                  -
                  $identity = new UserSecurityIdentity('johannes', 'Acme\UserBundle\Entity\User');
-$acl->insertObjectAce($identity, $mask);
-
                  -
                  -

                  El usuario ahora puede ver, editar, borrar, y recuperar objetos eliminados.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/acl_advanced.html b/cookbook/security/acl_advanced.html deleted file mode 100644 index 38266a1..0000000 --- a/cookbook/security/acl_advanced.html +++ /dev/null @@ -1,280 +0,0 @@ - - - - - - - Cómo usar los conceptos avanzados ACL — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar los conceptos avanzados ACL

                  -

                  El objetivo de este capítulo es darte una descripción más detallada del sistema ACL, y también explicar algunas de las decisiones de diseño detrás de él.

                  -
                  -

                  Conceptos de diseño

                  -

                  La capacidad de la instancia del objeto seguridad de Symfony2 está basada en el concepto de una Lista de Control de Acceso. Cada instancia del objeto dominio tiene su propia ACL. La instancia de ACL contiene una detallada lista de las entradas de control de acceso (ACE) utilizada para tomar decisiones de acceso. El sistema ACL de Symfony2 se enfoca en dos objetivos principales:

                  -
                    -
                  • proporcionar una manera eficiente de recuperar una gran cantidad de ACL/ACE para los objetos de tu dominio, y para modificarlos;
                    • -
                  • proporcionar una manera de facilitar las decisiones de si a una persona se le permite realizar una acción en un objeto del dominio o no.
                    • -
                  -

                  Según lo indicado por el primer punto, una de las principales capacidades del sistema ACL de Symfony2 es una forma de alto rendimiento de recuperar las ACL/ACE. Esto es muy importante ya que cada ACL puede tener varias ACE, y heredar de otra ACL anterior en una forma de árbol. Por tanto, ningún ORM es forzoso, en su lugar la implementación predeterminada interacciona con tu conexión directamente usando el DBAL de Doctrine.

                  -
                  -

                  Identidades de objeto

                  -

                  El sistema ACL está disociado completamente de los objetos de tu dominio. Ni siquiera se tienen que almacenar en la misma base de datos, o en el mismo servidor. Para lograr esta disociación, en el sistema ACL los objetos son representados a través de objeto identidad objetos. Cada vez, que desees recuperar la ACL para un objeto dominio, el sistema ACL en primer lugar crea un objeto identidad de tu objeto dominio y, a continuación pasa esa identidad de objeto al proveedor de ACL para su posterior procesamiento.

                  -
                  -
                  -

                  Identidad de seguridad

                  -

                  Esto es análogo a la identidad de objeto, pero representa a un usuario o un rol en tu aplicación. Cada rol, o usuario tiene una identidad de seguridad propia.

                  -
                  -
                  -
                  -

                  Estructura de tablas en la base de datos

                  -

                  La implementación predeterminada usa cinco tablas de bases de datos enumeradas a continuación. Las tablas están ordenadas de menos filas a más filas en una aplicación típica:

                  -
                    -
                  • acl_security_identities: Esta tabla registra todas las identidades de seguridad (SID) de que dispone ACE. La implementación predeterminada viene con dos identidades de seguridad: RoleSecurityIdentity, y UserSecurityIdentity
                    • -
                  • acl_classes: Esta tabla asigna los nombres de clase a un identificador único el cual puede hacer referencia a otras tablas.
                    • -
                  • acl_object_identities: Cada fila de esta tabla representa una única instancia del objeto dominio.
                    • -
                  • acl_object_identity_ancestors: Esta tabla te permite determinar todos los ancestros de una ACL en una manera muy eficiente.
                    • -
                  • acl_entries: Esta tabla contiene todas las ACE. Esta suele ser la tabla con más filas. Puede contener decenas de millones sin impactar el rendimiento significativamente.
                    • -
                  -
                  -
                  -

                  Alcance de las entradas del control de acceso

                  -

                  Las entradas del control de acceso pueden tener diferente ámbito en el cual se aplican. En Symfony2, básicamente hay dos diferentes ámbitos:

                  -
                    -
                  • Class-Scope: Estas entradas se aplican a todos los objetos con la misma clase.
                    • -
                  • Object-Scope: Este fue el único ámbito de aplicación usado en el capítulo anterior, y solamente aplica a un objeto específico.
                    • -
                  -

                  A veces, encontraras la necesidad de aplicar una ACE sólo a un campo específico del objeto. Digamos que deseas que el ID sólo sea visto por un gestor, pero no por tu servicio al cliente. Para resolver este problema común, se añadieron dos subámbitos:

                  -
                    -
                  • Class-Field-Scope: Estas entradas se aplican a todos los objetos con la misma clase, pero sólo a un campo específico de los objetos.
                    • -
                  • Object-Field-Scope: Estas entradas se aplican a un objeto específico, y sólo a un campo específico de ese objeto.
                    • -
                  -
                  -
                  -

                  Decisiones de preautorización

                  -

                  Para las decisiones de preautorización, es decir, las decisiones antes de que se invoque al método o acción de seguridad, se usa el servicio AccessDecisionManager provisto. -El AccessDecisionManager también se utiliza para tomar decisiones de autorización basadas en roles. Al igual que los roles, el sistema ACL añade varios nuevos atributos que se pueden utilizar para comprobar diferentes permisos.

                  -
                  -

                  Mapa de permisos incorporados

                  - ----- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  AtributoSignificado previstoMáscara de Bits
                  VIEWCuando le es permitido a -alguien ver el objeto -dominio.VIEW, EDIT, OPERATOR, -MASTER u OWNER
                  EDITCuando le es permitido a -alguien hacer cambios al -objeto dominio.EDIT, OPERATOR, MASTER, -u OWNER
                  CREATECuando a alguien se le -permite crear el objeto -dominio.CREATE, OPERATOR, MASTER, -u OWNER
                  DELETECuando a alguien se le -permite eliminar el objeto -dominio.DELETE, OPERATOR, MASTER -u OWNER
                  UNDELETECuando le es permitido a -alguien restaurar un -objeto dominio previamente -eliminado.UNDELETE, OPERATOR, MASTER -u OWNER
                  OPERATORCuando le es permitido a -alguien realizar todas las -acciones anteriores.OPERATOR, MASTER u OWNER
                  MASTERCuando le es permitido a -alguien realizar todas las -acciones anteriores, y -además tiene permitido -conceder cualquiera de los -permisos anteriores a -otros.MASTER u OWNER
                  OWNERCuando alguien es dueño -del objeto dominio. -Un propietario puede -realizar cualquiera de las -acciones anteriores y -otorgar privilegios y -permisos de propietario.OWNER
                  -
                  -
                  -

                  Atributos de permisos frente a máscaras de bits de permisos

                  -

                  Los atributos los utiliza el AccessDecisionManager, justo como los roles. A menudo, estos atributos en realidad representan un conjunto de enteros como máscaras de bits. Las máscaras de bits de enteros en cambio, las utiliza internamente el sistema ACL para almacenar de manera eficiente los permisos de los usuarios en la base de datos, y realizar comprobaciones de acceso usando las extremadamente rápidas operaciones de las máscaras de bits.

                  -
                  -
                  -

                  Extensibilidad

                  -

                  El mapa de permisos citado más arriba no es estático, y, teóricamente, lo podrías reemplazar a voluntad por completo. Sin embargo, debería abarcar la mayoría de los problemas que encuentres, y para interoperabilidad con otros paquetes, te animamos a que le adhieras el significado que tienes previsto para ellos.

                  -
                  -
                  -
                  -

                  Decisiones de postautorización

                  -

                  Las decisiones de postautorización se realizan después de haber invocado a un método seguro, y por lo general implican que el objeto dominio es devuelto por este método. -Después de invocar a los proveedores también te permite modificar o filtrar el objeto dominio antes de devolverlo.

                  -

                  Debido a las limitaciones actuales del lenguaje PHP, no hay capacidad de postautorización integrada en el núcleo del componente seguridad. -Sin embargo, hay un JMSSecurityExtraBundle experimental que añade estas capacidades. Consulta su documentación para más información sobre cómo se logra esto.

                  -
                  -
                  -

                  Proceso para conseguir decisiones de autorización

                  -

                  La clase ACL proporciona dos métodos para determinar si una identidad de seguridad tiene la máscara de bits necesaria, isGranted y isFieldGranted. Cuando la ACL recibe una petición de autorización a través de uno de estos métodos, delega esta petición a una implementación de PermissionGrantingStrategy. Esto te permite reemplazar la forma en que se tomen decisiones de acceso sin tener que modificar la clase ACL misma.

                  -

                  PermissionGrantingStrategy primero verifica todo su ámbito de aplicación ACE a objetos si no es aplicable, comprobará el ámbito de la clase ACL, si no es aplicable, entonces el proceso se repetirá con las ACE de la ACL padre. Si no existe la ACL padre, será lanzada una excepción.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/custom_authentication_provider.html b/cookbook/security/custom_authentication_provider.html deleted file mode 100644 index 1b500f6..0000000 --- a/cookbook/security/custom_authentication_provider.html +++ /dev/null @@ -1,597 +0,0 @@ - - - - - - - Cómo crear un proveedor de autenticación personalizado — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear un proveedor de autenticación personalizado

                  -

                  Si has leído el capítulo sobre Seguridad, entiendes la distinción que Symfony2 hace entre autenticación y autorización en la implementación de la seguridad. Este capítulo cubre las clases del núcleo involucradas en el proceso de autenticación, y cómo implementar un proveedor de autenticación personalizado. Dado que la autenticación y autorización son conceptos independientes, esta extensión será un proveedor de usuario agnóstico, y funcionará con los proveedores de usuario de la aplicación, posiblemente basado en memoria, en una base de datos, o en cualquier otro lugar que elijas almacenarlos.

                  -
                  -

                  Conociendo WSSE

                  -

                  El siguiente capítulo demuestra cómo crear un proveedor de autenticación personalizado para la autenticación WSSE. El protocolo de seguridad para WSSE proporciona varias ventajas de seguridad:

                  -
                    -
                  1. Cifrado del nombre de usuario/contraseña
                    2. -
                  2. Salvaguarda contra ataques repetitivos
                    3. -
                  3. No requiere configuración del servidor web
                    4. -
                  -

                  WSSE es muy útil para proteger servicios web, pudiendo ser SOAP o REST.

                  -

                  Hay un montón de excelente documentación sobre WSSE, pero este artículo no se enfocará en el protocolo de seguridad, sino más bien en la manera en que puedes personalizar el protocolo para añadirlo a tu aplicación Symfony2. La base de WSSE es que una cabecera de la petición comprueba si las credenciales están cifradas, verificando una marca de tiempo y nonce, y autenticado por el usuario de la petición usando la suma de comprobación de la contraseña.

                  -
                  -

                  Nota

                  -

                  WSSE también es compatible con aplicaciones de validación de clave, lo cual es útil para los servicios web, pero está fuera del alcance de este capítulo.

                  -
                  -
                  -
                  -

                  El testigo

                  -

                  El papel del testigo en el contexto de la seguridad en Symfony2 es muy importante. -Un testigo representa los datos de autenticación del usuario en la petición. Una vez se ha autenticado una petición, el testigo conserva los datos del usuario, y proporciona estos datos a través del contexto de seguridad. En primer lugar, crearás tu clase testigo. -Esta permitirá pasar toda la información pertinente a tu proveedor de autenticación.

                  -
                  // src/Acme/DemoBundle/Security/Authentication/Token/WsseUserToken.php
-namespace Acme\DemoBundle\Security\Authentication\Token;
-
-use Symfony\Component\Security\Core\Authentication\Token\AbstractToken;
-
-class WsseUserToken extends AbstractToken
-{
-    public $created;
-    public $digest;
-    public $nonce;
-
-    public function __construct(array $roles = array())
-    {
-        parent::__construct($roles);
-
-        // Si el usuario tiene roles, lo considera autenticado
-        $this->setAuthenticated(count($roles) > 0);
-    }
-
-    public function getCredentials()
-    {
-        return '';
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  La clase WsseUserToken extiende la clase componente de seguridad Symfony\Component\Security\Core\Autenticación\Token\AbstractToken, que proporciona una funcionalidad de testigo básica. Implementa la clase Symfony\Component\Security\Core\Authentication\Token\TokenInterface en cualquier clase que utilices como testigo.

                  -
                  -
                  -
                  -

                  El escucha

                  -

                  Después, necesitas un escucha para que esté atento al contexto de seguridad. El escucha es el responsable de capturar las peticiones de seguridad al servidor e invocar al proveedor de autenticación. Un escucha debe ser una instancia de Symfony\Component\Security\Http\Firewall\ListenerInterface. -Un escucha de seguridad debería manejar el evento Symfony\Component\HttpKernel\Event\GetResponseEvent, y establecer el testigo autenticado en el contexto de seguridad en caso de éxito.

                  -
                  // src/Acme/DemoBundle/Security/Firewall/WsseListener.php
-namespace Acme\DemoBundle\Security\Firewall;
-
-use Symfony\Component\HttpFoundation\Response;
-use Symfony\Component\HttpKernel\Event\GetResponseEvent;
-use Symfony\Component\Security\Http\Firewall\ListenerInterface;
-use Symfony\Component\Security\Core\Exception\AuthenticationException;
-use Symfony\Component\Security\Core\SecurityContextInterface;
-use Symfony\Component\Security\Core\Authentication\AuthenticationManagerInterface;
-use Acme\DemoBundle\Security\Authentication\Token\WsseUserToken;
-
-class WsseListener implements ListenerInterface
-{
-    protected $securityContext;
-    protected $authenticationManager;
-
-    public function __construct(SecurityContextInterface $securityContext, AuthenticationManagerInterface $authenticationManager)
-    {
-        $this->securityContext = $securityContext;
-        $this->authenticationManager = $authenticationManager;
-    }
-
-    public function handle(GetResponseEvent $event)
-    {
-        $request = $event->getRequest();
-
-        $wsseRegex = '/UsernameToken Username="([^"]+)", PasswordDigest="([^"]+)", Nonce="([^"]+)", Creado="([^"]+)"/';
-        if (!$request->headers->has('x-wsse') || 1 !== preg_match($wsseRegex, $request->headers->get('x-wsse'), $matches)) {
-            return;
-        }
-
-        $token = new WsseUserToken();
-        $token->setUser($matches[1]);
-
-        $token->digest   = $matches[2];
-        $token->nonce    = $matches[3];
-        $token->created  = $matches[4];
-
-        try {
-            $authToken = $this->authenticationManager->authenticate($token);
-
-            $this->securityContext->setToken($authToken);
-        } catch (AuthenticationException $failed) {
-            // ... puedes registrar algo aquí
-
-            // para negar la autenticación limpia la ficha. Esto redirigirá a la página de inicio de sesión.
-            // $this->securityContext->setToken(null);
-            // return;
-
-            // niega la autenticación con una respuesta HTTP '403 Prohibido'
-            $response = new Response();
-            $response->setStatusCode(403);
-            $event->setResponse($response);
-
-        }
-    }
-}
-
                  -
                  -

                  Este escucha comprueba que la petición tenga la cabecera X-WSSE esperada, empareja el valor devuelto con la información WSSE esperada, crea un testigo utilizando esa información, y pasa el testigo al gestor de autenticación. Si no proporcionas la información adecuada, o el gestor de autenticación lanza una Symfony\Component\Security\Core\Exception\AuthenticationException, devuelve una respuesta 403.

                  -
                  -

                  Nota

                  -

                  Una clase no usada arriba, Symfony\Component\Security\Http\Firewall\AbstractAuthenticationListener, es una clase base muy útil que proporciona funcionalidad necesaria comúnmente por las extensiones de seguridad. Esto incluye mantener al testigo en la sesión, proporcionando manipuladores de éxito / fallo, url del formulario de acceso y mucho más. Puesto que WSSE no requiere mantener la autenticación entre sesiones o formularios de acceso, no la utilizaremos para este ejemplo.

                  -
                  -
                  -
                  -

                  Proveedor de autenticación

                  -

                  El proveedor de autenticación debe hacer la verificación del WsseUserToken. -Es decir, el proveedor verificará si es válido el valor de la cabecera Created dentro de los cinco minutos, el valor de la cabecera Nonce es único dentro de los próximos cinco minutos, y el valor de la cabecera PasswordDigest coincide con la contraseña del usuario.

                  -
                  // src/Acme/DemoBundle/Security/Authentication/Provider/WsseProvider.php
-namespace Acme\DemoBundle\Security\Authentication\Provider;
-
-use Symfony\Component\Security\Core\Authentication\Provider\AuthenticationProviderInterface;
-use Symfony\Component\Security\Core\User\UserProviderInterface;
-use Symfony\Component\Security\Core\Exception\AuthenticationException;
-use Symfony\Component\Security\Core\Exception\NonceExpiredException;
-use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-use Acme\DemoBundle\Security\Authentication\Token\WsseUserToken;
-
-class WsseProvider implements AuthenticationProviderInterface
-{
-    private $userProvider;
-    private $cacheDir;
-
-    public function __construct(UserProviderInterface $userProvider, $cacheDir)
-    {
-        $this->userProvider = $userProvider;
-        $this->cacheDir     = $cacheDir;
-    }
-
-    public function authenticate(TokenInterface $token)
-    {
-        $user = $this->userProvider->loadUserByUsername($token->getUsername());
-
-        if ($user && $this->validateDigest($token->digest, $token->nonce, $token->created, $user->getPassword())) {
-            $authenticatedToken = new WsseUserToken($user->getRoles());
-            $authenticatedToken->setUser($user);
-
-            return $authenticatedToken;
-        }
-
-        throw new AuthenticationException('The WSSE authentication failed.');
-    }
-
-    protected function validateDigest($digest, $nonce, $created, $secret)
-    {
-        // Verifica que el momento de la creación no está en el futuro
-        if (strtotime($created) > time()) {
-                return false;
-        }
-
-        // la marca de tiempo caduca después de 5 minutos
-        if (time() - strtotime($created) > 300) {
-                return false;
-        }
-
-        // Valida que $nonce es única en 5 minutos
-        if (file_exists($this->cacheDir.'/'.$nonce) && file_get_contents($this->cacheDir.'/'.$nonce) + 300 > time()) {
-            throw new NonceExpiredException('Previously used nonce detected');
-        }
-        file_put_contents($this->cacheDir.'/'.$nonce, time());
-
-        // Valida secreto
-        $expected = base64_encode(sha1(base64_decode($nonce).$created.$secret, true));
-
-        return $digest === $expected;
-    }
-
-    public function supports(TokenInterface $token)
-    {
-        return $token instanceof WsseUserToken;
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  La Symfony\Component\Security\Core\Authentication\Provider\AuthenticationProviderInterface requiere un método authenticate en el testigo del usuario, y un método supports, el cual informa al gestor de autenticación cuando o no utilizar este proveedor para el testigo dado. En el caso de múltiples proveedores, el gestor de autenticación entonces pasa al siguiente proveedor en la lista.

                  -
                  -
                  -
                  -

                  La factoría

                  -

                  Has creado un testigo personalizado, escucha personalizado y proveedor personalizado. Ahora necesitas mantener todo junto. ¿Cómo hacer disponible tu proveedor en la configuración de seguridad? La respuesta es usando una factoría. Una factoría es donde enganchas el componente de seguridad, diciéndole el nombre de tu proveedor y las opciones de configuración disponibles para ello. En primer lugar, debes crear una clase que implemente Symfony\Bundle\SecurityBundle\DependencyInjection\Security\Factory\SecurityFactoryInterface.

                  -
                  // src/Acme/DemoBundle/DependencyInjection/Security/Factory/WsseFactory.php
-namespace Acme\DemoBundle\DependencyInjection\Security\Factory;
-
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Reference;
-use Symfony\Component\DependencyInjection\DefinitionDecorator;
-use Symfony\Component\Config\Definition\Builder\NodeDefinition;
-use Symfony\Bundle\SecurityBundle\DependencyInjection\Security\Factory\SecurityFactoryInterface;
-
-class WsseFactory implements SecurityFactoryInterface
-{
-    public function create(ContainerBuilder $container, $id, $config, $userProvider, $defaultEntryPoint)
-    {
-        $providerId = 'security.authentication.provider.wsse.'.$id;
-        $container
-            ->setDefinition($providerId, new DefinitionDecorator('wsse.security.authentication.provider'))
-            ->replaceArgument(0, new Reference($userProvider))
-        ;
-
-        $listenerId = 'security.authentication.listener.wsse.'.$id;
-        $listener = $container->setDefinition($listenerId, new DefinitionDecorator('wsse.security.authentication.listener'));
-
-        return array($providerId, $listenerId, $defaultEntryPoint);
-    }
-
-    public function getPosition()
-    {
-        return 'pre_auth';
-    }
-
-    public function getKey()
-    {
-        return 'wsse';
-    }
-
-    public function addConfiguration(NodeDefinition $node)
-    {
-    }
-}
-
                  -
                  -

                  La Symfony\Bundle\SecurityBundle\DependencyInjection\Security\Factory\SecurityFactoryInterface requiere los siguientes métodos:

                  -
                    -
                  • el método create, el cual añade el escucha y proveedor de autenticación para el contenedor de inyección de dependencias en el contexto de seguridad adecuado;
                    • -
                  • el método getPosition, el cual debe ser del tipo pre_auth, form, http y remember_me define la posición en la que se llama al proveedor;
                    • -
                  • el método getKey el cual define la clave de configuración utilizada para hacer referencia al proveedor;
                    • -
                  • el método addConfiguration el cual se utiliza para definir las opciones de configuración bajo la clave de configuración en tu configuración de seguridad. -Cómo ajustar las opciones de configuración se explica más adelante en este capítulo.
                    • -
                  -
                  -

                  Nota

                  -

                  Una clase no utilizada en este ejemplo, Symfony\Bundle\SecurityBundle\DependencyInjection\Security\Factory\AbstractFactory, es una clase base muy útil que proporciona una funcionalidad común necesaria para proteger la factoría. Puede ser útil en la definición de un tipo proveedor de autenticación diferente.

                  -
                  -

                  Ahora que has creado una clase factoría, puedes utilizar la clave wsse como un cortafuegos en tu configuración de seguridad.

                  -
                  -

                  Nota

                  -

                  Te estarás preguntando «¿por qué necesito una clase factoría especial para añadir escuchas y proveedores al contenedor de inyección de dependencias?». Esta es una muy buena pregunta. La razón es que puedes utilizar tu cortafuegos varias veces, para proteger varias partes de tu aplicación. Debido a esto, cada vez que utilizas tu cortafuegos, se crea un nuevo servicio en el contenedor de inyección de dependencias. -La factoría es la que crea estos nuevos servicios.

                  -
                  -
                  -
                  -

                  Configurando

                  -

                  Es hora de ver en acción tu proveedor de autenticación. Tendrás que hacer algunas cosas a fin de hacerlo funcionar. Lo primero es añadir los servicios mencionados al contenedor de inyección de dependencias. Tu clase factoría anterior hace referencia a identificadores de servicio que aún no existen: wsse.security.authentication.provider y -wsse.security.authentication.listener. Es hora de definir esos servicios.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/DemoBundle/Resources/config/services.yml
-services:
-    wsse.security.authentication.provider:
-        class:  Acme\DemoBundle\Security\Authentication\Provider\WsseProvider
-        arguments: ["", "%kernel.cache_dir%/security/nonces"]
-
-    wsse.security.authentication.listener:
-        class:  Acme\DemoBundle\Security\Firewall\WsseListener
-        arguments: ["@security.context", "@security.authentication.manager"]
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/DemoBundle/Resources/config/services.xml -->
-<container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
-
-        <services>
-        <service id="wsse.security.authentication.provider"
-            class="Acme\DemoBundle\Security\Authentication\Provider\WsseProvider" public="false">
-            <argument /> <!-- User Provider -->
-            <argument>%kernel.cache_dir%/security/nonces</argument>
-        </service>
-
-        <service id="wsse.security.authentication.listener"
-            class="Acme\DemoBundle\Security\Firewall\WsseListener" public="false">
-            <argument type="service" id="security.context"/>
-            <argument type="service" id="security.authentication.manager" />
-        </service>
-        </services>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/DemoBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-$container->setDefinition('wsse.security.authentication.provider',
-    new Definition(
-        'Acme\DemoBundle\Security\Authentication\Provider\WsseProvider', array(
-            '',
-            '%kernel.cache_dir%/security/nonces',
-        )
-    )
-);
-
-$container->setDefinition('wsse.security.authentication.listener',
-    new Definition(
-        'Acme\DemoBundle\Security\Firewall\WsseListener', array(
-            new Reference('security.context'),
-            new Reference('security.authentication.manager'),
-        )
-    )
-);
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora que están definidos tus servicios, informa de tu factoría al contexto de seguridad en tu clase Bundle.

                  -

                  -Nuevo en la versión 2.1: Antes de 2.1, se añadió la factoría de abajo a través de security.yml en su lugar.

                  -
                  // src/Acme/DemoBundle/AcmeDemoBundle.php
-namespace Acme\DemoBundle;
-
-use Acme\DemoBundle\DependencyInjection\Security\Factory\WsseFactory;
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-class AcmeDemoBundle extends Bundle
-{
-    public function build(ContainerBuilder $container)
-    {
-        parent::build($container);
-
-        $extension = $container->getExtension('security');
-        $extension->addSecurityListenerFactory(new WsseFactory());
-    }
-}
-
                  -
                  -

                  ¡Y está listo! Ahora puedes definir las partes de tu aplicación como bajo la protección del WSSE.

                  -
                  -
                    -
                  • YAML
                    security:
-    firewalls:
-        wsse_secured:
-            pattern:   /api/.*
-            wsse:      true
-
                    -
                    -
                    • -
                  • XML
                    <config>
-    <firewall name="wsse_secured" pattern="/api/.*">
-        <wsse />
-    </firewall>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'wsse_secured' => array(
-            'pattern' => '/api/.*',
-            'wsse'    => true,
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  ¡Enhorabuena! ¡Has escrito tu propio proveedor de autenticación de seguridad!

                  -
                  -
                  -

                  Un poco más allá

                  -

                  ¿Qué hay de hacer de tu proveedor de autenticación WSSE un poco más emocionante? Las posibilidades son infinitas. ¿Por qué no empezar agregando algún destello al brillo?

                  -
                  -

                  Configurando

                  -

                  Puedes añadir opciones personalizadas bajo la clave wsse en tu configuración de seguridad. -Por ejemplo, el tiempo permitido antes de que expire la cabecera Created del elemento, por omisión, es de 5 minutos. Hazlo configurable, para que distintos cortafuegos puedan tener diferente longitud en sus tiempos de espera.

                  -

                  En primer lugar, tendrás que editar WsseFactory y definir la nueva opción en el método addConfiguration.

                  -
                  class WsseFactory implements SecurityFactoryInterface
-{
-    // ...
-
-    public function addConfiguration(NodeDefinition $node)
-    {
-      $node
-        ->children()
-        ->scalarNode('lifetime')->defaultValue(300)
-        ->end();
-    }
-}
-
                  -
                  -

                  Ahora, en el método create de la factoría, el argumento $config contendrá una clave 'lifetime', establecida en 5 minutos (300 segundos) a menos que se establezca en la configuración. Pasa este argumento a tu proveedor de autenticación a fin de utilizarlo.

                  -
                  class WsseFactory implements SecurityFactoryInterface
-{
-    public function create(ContainerBuilder $container, $id, $config, $userProvider, $defaultEntryPoint)
-    {
-        $providerId = 'security.authentication.provider.wsse.'.$id;
-        $container
-            ->setDefinition($providerId,
-              new DefinitionDecorator('wsse.security.authentication.provider'))
-            ->replaceArgument(0, new Reference($userProvider))
-            ->replaceArgument(2, $config['lifetime']);
-        // ...
-    }
-
-    // ...
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  También tendrás que añadir un tercer argumento a la configuración del servicio wsse.security.authentication.provider, el cual puede estar en blanco, pero se completará con la vida útil en la factoría. La clase WsseProvider ahora también tiene que aceptar un tercer argumento en el constructor —lifetime— el cual se debe utilizar en lugar de los rígidos 300 segundos. Estos dos pasos no se muestran aquí.

                  -
                  -

                  La vida útil de cada petición WSSE ahora es configurable y se puede ajustar a cualquier valor deseado por el cortafuegos.

                  -
                  -
                    -
                  • YAML
                    security:
-    firewalls:
-        wsse_secured:
-            pattern:   /api/.*
-            wsse:      { lifetime: 30 }
-
                    -
                    -
                    • -
                  • XML
                    <config>
-    <firewall name="wsse_secured"
-        pattern="/api/.*"
-    >
-        <wsse lifetime="30" />
-    </firewall>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'wsse_secured' => array(
-            'pattern' => '/api/.*',
-            'wsse'    => array(
-                'lifetime' => 30,
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  ¡El resto depende de ti! Todos los elementos de configuración correspondientes se pueden definir en la factoría y consumirse o pasarse a las otras clases en el contenedor.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/custom_provider.html b/cookbook/security/custom_provider.html deleted file mode 100644 index e7ebefd..0000000 --- a/cookbook/security/custom_provider.html +++ /dev/null @@ -1,426 +0,0 @@ - - - - - - - Cómo crear un proveedor de usuario personalizado — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear un proveedor de usuario personalizado

                  -

                  Parte del proceso de autenticación estándar de Symfony depende del «proveedor de usuarios». -Cuando un usuario envía un nombre de usuario y una contraseña, la capa de autenticación solicita al proveedor de usuarios configurado devuelva un objeto usuario para un nombre de usuario dado. -Symfony comprueba si la contraseña de este usuario es correcta y genera un indicador de seguridad para que el usuario quede autenticado durante la sesión actual. -Fuera de la caja, Symfony tiene un proveedor de usuario «en memoria» y una «entidad». -En este artículo varás cómo puedes crear un proveedor de usuarios propio, el cual te podría ser útil si tus usuarios se acceden a través de una base de datos personalizada, un archivo, o —como muestra este ejemplo— un servicio web.

                  -
                  -

                  Creando una clase usuario

                  -

                  En primer lugar, independientemente de dónde vengan los datos de tu usuario, tendrás que crear una clase User que represente esos datos. El usuario se puede ver como te apetezca y contener los datos que quieras. El único requisito es que implemente la clase Symfony\Component\Security\Core\User\UserInterface. -Los métodos de esta interfaz por lo tanto, se deben definir en la clase usuario personalizada: getRoles(), -getPassword(), -getSalt(), -getUsername(), -eraseCredentials(). -También puede ser útil implementar la interfaz Symfony\Component\Security\Core\User\EquatableInterface, la cual define un método para comprobar si el usuario es igual al usuario actual. Esta interfaz requiere un método isEqualTo().

                  -

                  Veamos esto en acción:

                  -
                  // src/Acme/WebserviceUserBundle/Security/User/WebserviceUser.php
-namespace Acme\WebserviceUserBundle\Security\User;
-
-use Symfony\Component\Security\Core\User\UserInterface;
-use Symfony\Component\Security\Core\User\EquatableInterface;
-
-class WebserviceUser implements UserInterface, EquatableInterface
-{
-    private $username;
-    private $password;
-    private $salt;
-    private $roles;
-
-    public function __construct($username, $password, $salt, array $roles)
-    {
-        $this->username = $username;
-        $this->password = $password;
-        $this->salt = $salt;
-        $this->roles = $roles;
-    }
-
-    public function getRoles()
-    {
-        return $this->roles;
-    }
-
-    public function getPassword()
-    {
-        return $this->password;
-    }
-
-    public function getSalt()
-    {
-        return $this->salt;
-    }
-
-    public function getUsername()
-    {
-        return $this->username;
-    }
-
-    public function eraseCredentials()
-    {
-    }
-
-    public function isEqualTo(UserInterface $user)
-    {
-        if (!$user instanceof WebserviceUser) {
-                return false;
-        }
-
-        if ($this->password !== $user->getPassword()) {
-                return false;
-        }
-
-        if ($this->getSalt() !== $user->getSalt()) {
-                return false;
-        }
-
-        if ($this->username !== $user->getUsername()) {
-                return false;
-        }
-
-            return true;
-    }
-}
-
                  -
                  -

                  -Nuevo en la versión 2.1: La EquatableInterface se añadió en Symfony 2.1. En Symfony 2.0, Usa el método equals() de la UserInterface.

                  -

                  Si tienes más información sobre tus usuarios —como un «nombre»— entonces puedes agregar un campo «first_name» para almacenar esos datos.

                  -
                  -
                  -

                  Creando un proveedor de usuario

                  -

                  Ahora que tienes una clase Usuario, debes crear un proveedor de usuarios, el cual toma información del usuario desde algún servicio web, crea un objeto WebserviceUser y lo rellena con datos.

                  -

                  El proveedor de usuarios sólo es una simple clase PHP que debe implementar la Symfony\Component\Security\Core\User\UserProviderInterface, la cual requiere que se definan tres métodos: loadUserByUsername($username), refreshUser(UserInterface $user) y supportsClass($class). para más detalles, consulta la Symfony\Component\Security\Core\User\UserProviderInterface.

                  -

                  Aquí tienes un ejemplo de cómo lo podrías hacer:

                  -
                  // src/Acme/WebserviceUserBundle/Security/User/WebserviceUserProvider.php
-namespace Acme\WebserviceUserBundle\Security\User;
-
-use Symfony\Component\Security\Core\User\UserProviderInterface;
-use Symfony\Component\Security\Core\User\UserInterface;
-use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
-use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
-
-class WebserviceUserProvider implements UserProviderInterface
-{
-    public function loadUserByUsername($username)
-    {
-        // aquí haz una llamada a tu servicio web
-        $userData = ...
-        // pretende que devuelve un arreglo cuando tiene éxito,
-        // false si no hay usuario
-
-        if ($userData) {
-            $password = '...';
-
-            // ...
-
-            return new WebserviceUser($username, $password, $salt, $roles);
-        }
-
-        throw new UsernameNotFoundException(sprintf('Username "%s" does not exist.', $username));
-    }
-
-    public function refreshUser(UserInterface $user)
-    {
-        if (!$user instanceof WebserviceUser) {
-            throw new UnsupportedUserException(sprintf('Instances of "%s" are not supported.', get_class($user)));
-        }
-
-        return $this->loadUserByUsername($user->getUsername());
-    }
-
-    public function supportsClass($class)
-    {
-        return $class === 'Acme\WebserviceUserBundle\Security\User\WebserviceUser';
-    }
-}
-
                  -
                  -
                  -
                  -

                  Creando un servicio para el proveedor de usuario

                  -

                  Ahora has disponible el proveedor de usuarios como un servicio:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/WebserviceUserBundle/Resources/config/services.yml
-parameters:
-    webservice_user_provider.class: Acme\WebserviceUserBundle\Security\User\WebserviceUserProvider
-
-services:
-    webservice_user_provider:
-        class: "%webservice_user_provider.class%"
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/WebserviceUserBundle/Resources/config/services.xml -->
-<parameters>
-    <parameter key="webservice_user_provider.class">Acme\WebserviceUserBundle\Security\User\WebserviceUserProvider</parameter>
-</parameters>
-
-    <services>
-    <service id="webservice_user_provider" class="%webservice_user_provider.class%"></service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/WebserviceUserBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container->setParameter('webservice_user_provider.class', 'Acme\WebserviceUserBundle\Security\User\WebserviceUserProvider');
-
-$container->setDefinition('webservice_user_provider', new Definition('%webservice_user_provider.class%');
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  La implementación real del proveedor de usuario probablemente tendrá algunas dependencias u opciones de configuración u otros servicios. Agrégalas como argumentos en la definición del servicio.

                  -
                  -
                  -

                  Nota

                  -

                  Asegúrate de que estás importando el archivo de servicios. Consulta Importando configuración con imports para más detalles.

                  -
                  -
                  -
                  -

                  Modificando security.yml

                  -

                  Todo viene junto en tu configuración de seguridad. Añade el proveedor de usuario a la lista de proveedores en la sección de «seguridad». Elige un nombre para el proveedor de usuarios (p. ej. «webservice») y menciona el id del servicio que acabas de definir.

                  -
                  -
                    -
                  • YAML
                    // app/config/security.yml
-security:
-    providers:
-        webservice:
-            id: webservice_user_provider
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <provider name="webservice" id="webservice_user_provider" />
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'providers' => array(
-        'webservice' => array(
-            'id' => 'webservice_user_provider',
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Symfony también necesita saber cómo codificar las contraseñas suministradas por los usuarios del sitio web, por ejemplo, rellenando un formulario de acceso. Lo puedes hacer añadiendo una línea a la sección «encoders» en tu configuración de seguridad:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    encoders:
-        Acme\WebserviceUserBundle\Security\User\WebserviceUser: sha512
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <encoder class="Acme\WebserviceUserBundle\Security\User\WebserviceUser">sha512</encoder>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'encoders' => array(
-        'Acme\WebserviceUserBundle\Security\User\WebserviceUser' => 'sha512',
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  El valor aquí debe corresponder con cualquiera de las contraseñas que fueron codificadas originalmente al crear a los usuarios (cuando se crearon los usuarios). cuando un usuario envía su contraseña, se añade el valor de sal a la contraseña y entonces se codifica utilizando el algoritmo antes de comparar la contraseña con algoritmo hash devuelto por el método getPassword(). Además, dependiendo de tus opciones, la contraseña se puede codificar varias veces y codificar a base64.

                  -
                  -

                  Detalles sobre cómo se codifican las contraseñas

                  -

                  Symfony utiliza un método específico para combinar la sal y codificar la contraseña antes de compararla con la contraseña codificada. Si getSalt() no devuelve nada, entonces la contraseña es presentada simplemente codificada utilizando el algoritmo que especificaste en security.yml. Si se especificó una sal, entonces se crea el siguiente valor y luego codifica mediante el algoritmo:

                  -
                  -
                  $password.'{'.$salt.'}';
                  -

                  Si tus usuarios externos tienen sus contraseñas saladas por medio de un método diferente, entonces tendrás que trabajar un poco más para que Symfony codifique correctamente la contraseña. Eso está fuera del alcance de este artículo, pero incluimos la subclase MessageDigestPasswordEncoder y reemplazamos el método mergePasswordAndSalt.

                  -

                  Además, la codificación predeterminada, se codifica en múltiples ocasiones y finalmente es codificada en base64. Para detalles más específicos, consulta MessageDigestPasswordEncoder. -Para impedir esto, especifícalo en tu archivo de configuración:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    encoders:
-        Acme\WebserviceUserBundle\Security\User\WebserviceUser:
-            algorithm: sha512
-            encode_as_base64: false
-            iterations: 1
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <encoder class="Acme\WebserviceUserBundle\Security\User\WebserviceUser"
-        algorithm="sha512"
-        encode-as-base64="false"
-        iterations="1"
-    />
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'encoders' => array(
-        'Acme\WebserviceUserBundle\Security\User\WebserviceUser' => array(
-            'algorithm'         => 'sha512',
-            'encode_as_base64'  => false,
-            'iterations'        => 1,
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/entity_provider.html b/cookbook/security/entity_provider.html deleted file mode 100644 index 287d8e5..0000000 --- a/cookbook/security/entity_provider.html +++ /dev/null @@ -1,699 +0,0 @@ - - - - - - - Cómo cargar usuarios desde la base de datos con seguridad (el Proveedor de entidad) — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo cargar usuarios desde la base de datos con seguridad (el Proveedor de entidad)

                  -

                  La capa de seguridad es una de las más inteligentes herramientas de Symfony. Esta maneja dos cosas: la autenticación y los procesos de autorización. A pesar de que puede parecer difícil entender cómo funciona internamente, el sistema de seguridad es muy flexible y te permite integrar tu aplicación con cualquier tipo de mecanismo de autenticación, como Active Directory, un servidor de OAuth o una base de datos.

                  -
                  -

                  Introducción

                  -

                  Este artículo se enfoca en la manera de autenticar usuarios en una tabla de base de datos gestionada por una clase entidad de Doctrine. El contenido de esta receta se divide en tres partes. La primera parte trata de diseñar una clase entidad User de Doctrine y hacerla útil en la capa de seguridad de Symfony. La segunda parte describe cómo autenticar a un usuario fácilmente con el objeto Symfony\Bridge\Doctrine\Security\User\EntityUserProvider de Doctrine incluido con la plataforma y alguna configuración. -Por último, la guía muestra cómo crear un objeto Symfony\Bridge\Doctrine\Security\User\EntityUserProvider para recuperar usuarios de una base de datos con condiciones personalizadas.

                  -

                  En esta guía asumimos que hay un paquete Acme\UserBundle cargado en el núcleo de la aplicación durante el proceso de arranque.

                  -
                  -
                  -

                  El modelo de datos

                  -

                  Para los fines de esta receta, el paquete AcmeUserBundle contiene una clase de entidad User con los siguientes campos: id, username, salt, password, email e isActive. El campo isActive indica si o no la cuenta de usuario está activa.

                  -

                  Para hacerlo más corto, los métodos get y set para cada uno se han removido para concentrarnos en los métodos más importantes que provienen de la clase Symfony\Component\Security\Core\User\UserInterface.

                  -
                  // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Doctrine\ORM\Mapping as ORM;
-use Symfony\Component\Security\Core\User\UserInterface;
-
-/**
- * Acme\UserBundle\Entity\User
- *
- * @ORM\Table(name="acme_users")
- * @ORM\Entity(repositoryClass="Acme\UserBundle\Entity\UserRepository")
- */
-class User implements UserInterface, \Serializable
-{
-    /**
-     * @ORM\Column(type="integer")
-     * @ORM\Id
-     * @ORM\GeneratedValue(strategy="AUTO")
-     */
-    private $id;
-
-    /**
-     * @ORM\Column(type="string", length=25, unique=true)
-     */
-    private $username;
-
-    /**
-     * @ORM\Column(type="string", length=32)
-     */
-    private $salt;
-
-    /**
-     * @ORM\Column(type="string", length=40)
-     */
-    private $password;
-
-    /**
-     * @ORM\Column(type="string", length=60, unique=true)
-     */
-    private $email;
-
-    /**
-     * @ORM\Column(name="is_active", type="boolean")
-     */
-    private $isActive;
-
-    public function __construct()
-    {
-        $this->isActive = true;
-        $this->salt = md5(uniqid(null, true));
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function getUsername()
-    {
-        return $this->username;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function getSalt()
-    {
-        return $this->salt;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function getPassword()
-    {
-        return $this->password;
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function getRoles()
-    {
-        return array('ROLE_USER');
-    }
-
-    /**
-     * @inheritDoc
-     */
-    public function eraseCredentials()
-    {
-    }
-
-    /**
-     * @see \Serializable::serialize()
-     */
-    public function serialize()
-    {
-        return serialize(array(
-            $this->id,
-        ));
-    }
-
-    /**
-     * @see \Serializable::unserialize()
-     */
-    public function unserialize($serialized)
-    {
-        list (
-            $this->id,
-        ) = unserialize($serialized);
-    }
-}
-
                  -
                  -

                  Para utilizar una instancia de la clase AcmeUserBundle:User en la capa de seguridad de Symfony, la clase entidad debe implementar la Symfony\Component\Security\Core\User\UserInterface. Esta interfaz obliga a la clase a implementar los siguientes cinco métodos:

                  -
                    -
                  • getRoles(),
                    • -
                  • getPassword(),
                    • -
                  • getSalt(),
                    • -
                  • getUsername(),
                    • -
                  • eraseCredentials()
                    • -
                  -

                  Para más detalles sobre cada uno de ellos, consulta la Symfony\Component\Security\Core\User\UserInterface.

                  -

                  -Nuevo en la versión 2.1: En Symfony 2.1, se removió el método equals de la UserInterface. -Si necesitas sustituir la implementación predeterminada de la lógica de comparación, implementa la nueva interfaz Symfony\Component\Security\Core\User\EquatableInterface e implementa el método isEqualTo.

                  -
                  // src/Acme/UserBundle/Entity/User.php
-
-    namespace Acme\UsuarioBundle\Entity;
-
-use Symfony\Component\Security\Core\User\EquatableInterface;
-
-// ...
-
-public function isEqualTo(UserInterface $user)
-{
-    return $this->id === $user->getId();
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  La interfaz Serializable y sus métodos serialize y unserialize se añadieron para permitir serializar la clase Usuario a la sesión. Esto puede o no ser necesario dependiendo de tu configuración, pero probablemente sea una buena idea. Sólo necesitas serializar el id, porque el método refreshUser() vuelve a cargar el usuario en cada petición usando el id.

                  -
                  -

                  A continuación se muestra una exportación de mi tabla User de MySQL. Para obtener más información sobre cómo crear registros de usuario y codificar su contraseña, consulta Codificando la contraseña del usuario.

                  -
                  $ mysql> select * from user;
-+----+----------+----------------------------------+------------------------------------------+--------------------+-----------+
-| id | username | salt                             | password                                 | email              | is_active |
-+----+----------+----------------------------------+------------------------------------------+--------------------+-----------+
-|  1 | hhamon   | 7308e59b97f6957fb42d66f894793079 | 09610f61637408828a35d7debee5b38a8350eebe | hhamon@example.com |         1 |
-|  2 | jsmith   | ce617a6cca9126bf4036ca0c02e82dee | 8390105917f3a3d533815250ed7c64b4594d7ebf | jsmith@example.com |         1 |
-|  3 | maxime   | cd01749bb995dc658fa56ed45458d807 | 9764731e5f7fb944de5fd8efad4949b995b72a3c | maxime@example.com |         0 |
-|  4 | donald   | 6683c2bfd90c0426088402930cadd0f8 | 5c3bcec385f59edcc04490d1db95fdb8673bf612 | donald@example.com |         1 |
-+----+----------+----------------------------------+------------------------------------------+--------------------+-----------+
-4 rows in set (0.00 sec)
-
                  -
                  -

                  La base de datos contiene cuatro usuarios con diferentes nombres de usuario, correos electrónicos y -estados. La segunda parte se centrará en cómo autenticar uno de estos usuarios gracias a la entidad proveedora de usuario de Doctrine y a un par de líneas de configuración.

                  -
                  -
                  -

                  Autenticando a alguien contra una base de datos

                  -

                  Autenticar a un usuario de Doctrine contra la base de datos con la capa de seguridad de Symfony es un trozo del pastel. Todo reside en la configuración de la SecurityBundle almacenada en el archivo app/config/security.yml.

                  -

                  A continuación se muestra un ejemplo de configuración donde el usuario podrá ingresar su nombre de usuario y contraseña a través de la autenticación HTTP básica. Esa información luego se cotejará con los registros de la entidad Usuario en la base de datos:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    encoders:
-        Acme\UserBundle\Entity\User:
-            algorithm:        sha1
-            encode_as_base64: false
-            iterations:       1
-
-    role_hierarchy:
-        ROLE_ADMIN:       ROLE_USER
-        ROLE_SUPER_ADMIN: [ ROLE_USER, ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH ]
-
-    providers:
-        administrators:
-            entity: { class: AcmeUserBundle:User, property: username }
-
-    firewalls:
-        admin_area:
-            pattern:    ^/admin
-            http_basic: ~
-
-    access_control:
-        - { path: ^/admin, roles: ROLE_ADMIN }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <encoder class="Acme\UserBundle\Entity\User"
-        algorithm="sha1"
-        encode-as-base64="false"
-        iterations="1"
-    />
-
-    <role id="ROLE_ADMIN">ROLE_USER</role>
-    <role id="ROLE_SUPER_ADMIN">ROLE_USER, ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH</role>
-
-    <provider name="administrators">
-        <entity class="AcmeUserBundle:User" property="username" />
-    </provider>
-
-    <firewall name="admin_area" pattern="^/admin">
-        <http-basic />
-    </firewall>
-
-    <rule path="^/admin" role="ROLE_ADMIN" />
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'encoders' => array(
-        'Acme\UserBundle\Entity\User' => array(
-            'algorithm'         => 'sha1',
-            'encode_as_base64'  => false,
-            'iterations'        => 1,
-        ),
-    ),
-    'role_hierarchy' => array(
-        'ROLE_ADMIN'       => 'ROLE_USER',
-        'ROLE_SUPER_ADMIN' => array('ROLE_USER', 'ROLE_ADMIN', 'ROLE_ALLOWED_TO_SWITCH'),
-    ),
-    'providers' => array(
-        'administrator' => array(
-            'entity' => array(
-                'class'    => 'AcmeUserBundle:User',
-                'property' => 'username',
-            ),
-        ),
-    ),
-    'firewalls' => array(
-        'admin_area' => array(
-            'pattern' => '^/admin',
-            'http_basic' => null,
-        ),
-    ),
-    'access_control' => array(
-        array('path' => '^/admin', 'role' => 'ROLE_ADMIN'),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  La sección encoders asocia el codificador de contraseña sha1 a la clase entidad. Esto significa que Symfony espera que la contraseña en la base de datos esté cifrada usando este algoritmo. Para más información sobre cómo crear un nuevo objeto usuario con una contraseña cifrada correctamente, consulta la sección Codificando la contraseña del usuario del capítulo de seguridad.

                  -

                  La sección proveedores define un proveedor de usuario administradores. A proveedor de usuario es la «fuente» de donde se cargan los usuarios durante la autenticación. -En este caso, la palabra clave entidad significa que Symfony utilizará la entidad proveedor de usuarios de Doctrine para cargar los objetos entidad de usuario desde la base de datos usando el campo único username. En otras palabras, esto le dice a Symfony cómo buscar al usuario en la base de datos antes de comprobar la validez de la contraseña.

                  -

                  Este código y configuración funciona, pero no es suficiente para asegurar la aplicación para usuarios activos. A partir de ahora, todavía puedes autenticar con maxime. La siguiente sección explica cómo negar el acceso a usuarios no activos.

                  -
                  -
                  -

                  Denegando acceso a usuarios no activos

                  -

                  La forma más fácil de excluir a los usuarios inactivos es implementar la interfaz Symfony\Component\Security\Core\User\AdvancedUserInterface que se encarga de comprobar el estado de la cuenta del usuario. -La Symfony\Component\Security\Core\User\AdvancedUserInterface extiende la interfaz Symfony\Component\Security\Core\User\UserInterface, por lo que sólo hay que cambiar a la nueva interfaz en la clase de la entidad AcmeUserBundle:User para beneficiarse del comportamiento de autenticación simple y avanzado.

                  -

                  La interfaz Symfony\Component\Security\Core\User\AdvancedUserInterface añade cuatro métodos adicionales para validar el estado de la cuenta:

                  -
                    -
                  • isAccountNonExpired() comprueba si la cuenta del usuario ha caducado,
                    • -
                  • isAccountNonLocked() comprueba si el usuario está bloqueado,
                    • -
                  • isCredentialsNonExpired() comprueba si las credenciales del usuario (contraseña) ha expirado,
                    • -
                  • isEnabled() comprueba si el usuario está habilitado.
                    • -
                  -

                  Para este ejemplo, los tres primeros métodos devolverán true mientras que el método isEnabled() devolverá el valor booleano del campo isActive.

                  -
                  // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-// ...
-use Symfony\Component\Security\Core\User\AdvancedUserInterface;
-
-class User implements AdvancedUserInterface
-{
-    // ...
-
-    public function isAccountNonExpired()
-    {
-            return true;
-    }
-
-    public function isAccountNonLocked()
-    {
-            return true;
-    }
-
-    public function isCredentialsNonExpired()
-    {
-            return true;
-    }
-
-    public function isEnabled()
-    {
-        return $this->isActive;
-    }
-}
-
                  -
                  -

                  Si tratas de autenticarte como maxime, el acceso ahora está prohibido, puesto que el usuario no tiene una cuenta activa. La siguiente sesión se enfocará en cómo escribir un proveedor de entidad personalizado para autenticar a un usuario con su nombre de usuario o dirección de correo electrónico.

                  -
                  -
                  -

                  Autenticando a alguien con un proveedor de entidad personalizado

                  -

                  El siguiente paso es permitir a un usuario que se autentique con su nombre de usuario o su -dirección de correo electrónico, puesto que ambos son únicos en la base de datos. Desafortunadamente, el proveedor de entidad nativo sólo puede manejar una sola propiedad al buscar al usuario en -la base de datos.

                  -

                  Para lograr esto, crea un proveedor de entidad personalizado que busque a un usuario cuyo campo nombre de usuario o correo electrónico coincida con el nombre de usuario presentado para iniciar sesión. -La buena noticia es que un objeto repositorio de Doctrine puede actuar como un proveedor de entidad usuario si implementa la Symfony\Component\Security\Core\User\UserProviderInterface. Esta interfaz viene con tres métodos a implementar: loadUserByUsername($username), refreshUser(UserInterface $user) y supportsClass($class). para más detalles, consulta la Symfony\Component\Security\Core\User\UserProviderInterface.

                  -

                  El siguiente código muestra la implementación de la Symfony\Component\Security\Core\User\UserProviderInterface en la clase UserRepository:

                  -
                  // src/Acme/UserBundle/Entity/UserRepository.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Security\Core\User\UserInterface;
-use Symfony\Component\Security\Core\User\UserProviderInterface;
-use Symfony\Component\Security\Core\Exception\UsernameNotFoundException;
-use Symfony\Component\Security\Core\Exception\UnsupportedUserException;
-use Doctrine\ORM\EntityRepository;
-use Doctrine\ORM\NoResultException;
-
-class UserRepository extends EntityRepository implements UserProviderInterface
-{
-    public function loadUserByUsername($username)
-    {
-        $q = $this
-            ->createQueryBuilder('u')
-            ->where('u.username = :username OR u.email = :email')
-            ->setParameter('username', $username)
-            ->setParameter('email', $username)
-            ->getQuery()
-        ;
-
-        try {
-            // El método Query::getSingleResult() lanza una excepción
-            // si no hay algún registro que coincida con los criterios.
-            $user = $q->getSingleResult();
-        } catch (NoResultException $e) {
-            $message = sprintf(
-                'Unable to find an active admin AcmeUserBundle:User object identified by "%s".',
-                $username
-            );
-            throw new UsernameNotFoundException($message, 0, $e);
-        }
-
-        return $user;
-    }
-
-    public function refreshUser(UserInterface $user)
-    {
-        $class = get_class($user);
-        if (!$this->supportsClass($class)) {
-            throw new UnsupportedUserException(
-                sprintf(
-                    'Instances of "%s" are not supported.',
-                    $class
-                )
-            );
-        }
-
-        return $this->find($user->getId());
-    }
-
-    public function supportsClass($class)
-    {
-        return $this->getEntityName() === $class
-            || is_subclass_of($class, $this->getEntityName());
-    }
-}
-
                  -
                  -

                  Para finalizar la implementación, debes cambiar la configuración de la capa de seguridad para decirle a Symfony que utilice el nuevo proveedor de entidad personalizado en lugar del proveedor de entidad genérico de Doctrine. It’s trivial to achieve by removing the -property field in the security.providers.administrators.entity section -of the security.yml file.

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    # ...
-    providers:
-        administrators:
-            entity: { class: AcmeUserBundle:User }
-    # ...
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <!-- ... -->
-
-    <provider name="administrator">
-        <entity class="AcmeUserBundle:User" />
-    </provider>
-
-    <!-- ... -->
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    ...,
-    'providers' => array(
-        'administrator' => array(
-            'entity' => array(
-                'class' => 'AcmeUserBundle:User',
-            ),
-        ),
-    ),
-    ...,
-));
-
                    -
                    -
                    • -
                  -
                  -

                  De esta manera, la capa de seguridad utilizará una instancia del UserRepository y llamará a su método loadUserByUsername() para recuperar un usuario de la base de datos si llenó su nombre de usuario o dirección de correo electrónico.

                  -
                  -
                  -

                  Gestionando roles en la base de datos

                  -

                  El final de esta guía se centra en cómo almacenar y recuperar una lista de roles desde la base de datos. Como se mencionó anteriormente, cuando se carga el usuario, su método getRoles() devuelve el arreglo de roles de seguridad que se deben asignar al usuario. Puedes cargar estos datos desde cualquier lugar —una lista de palabras codificadas para todos los usuarios (p. ej. array('ROLE_USER')), una propiedad array de Doctrine llamada roles, o por medio de una relación de Doctrine, como aprenderás en esta sección.

                  -
                  -

                  Prudencia

                  -

                  En una configuración típica, el método getRoles() siempre debe devolver un rol por lo menos. Por convención, se suele devolver una función denominada ROLE_USER. -Si no devuelves ningún rol, puede aparentar como si el usuario no estuviera autenticado en absoluto.

                  -
                  -

                  En este ejemplo, la clase de la entidad AcmeUserBundle:User define una relación muchos-a-muchos con una clase entidad AcmeUserBundle:Group. Un usuario puede estar relacionado con varios grupos y un grupo puede estar compuesto por uno o más usuarios. Puesto que un grupo también es un rol, el método getRoles() anterior ahora devuelve la lista de los grupos relacionados:

                  -
                  // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Doctrine\Common\Collections\ArrayCollection;
-// ...
-
-class User implements AdvancedUserInterface, \Serializable
-{
-    /**
-     * @ORM\ManyToMany(targetEntity="Group", inversedBy="users")
-     *
-     */
-    private $groups;
-
-    public function __construct()
-    {
-        $this->groups = new ArrayCollection();
-    }
-
-    // ...
-
-    public function getRoles()
-    {
-        return $this->groups->toArray();
-    }
-
-    /**
-     * @see \Serializable::serialize()
-     */
-    public function serialize()
-    {
-        return serialize(array(
-            $this->id,
-        ));
-    }
-
-    /**
-     * @see \Serializable::unserialize()
-     */
-    public function unserialize($serialized)
-    {
-        list (
-            $this->id,
-        ) = unserialize($serialized);
-    }
-}
-
                  -
                  -

                  La clase de la entidad AcmeUserBundle:Group define tres campos de tabla (id, username y role). El campo único role contiene el nombre del rol utilizado por la capa de seguridad de Symfony para proteger partes de la aplicación. Lo más importante a resaltar es que la clase de la entidad AcmeUserBundle:Group implementa la Symfony\Component\Security\Core\Role\RoleInterface que te obliga a tener un método getRole():

                  -
                  // src/Acme/Bundle/UserBundle/Entity/Group.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Security\Core\Role\RoleInterface;
-use Doctrine\Common\Collections\ArrayCollection;
-use Doctrine\ORM\Mapping as ORM;
-
-/**
- * @ORM\Table(name="acme_groups")
- * @ORM\Entity()
- */
-class Group implements RoleInterface
-{
-    /**
-     * @ORM\Column(name="id", type="integer")
-     * @ORM\Id()
-     * @ORM\GeneratedValue(strategy="AUTO")
-     */
-    private $id;
-
-    /**
-     * @ORM\Column(name="name", type="string", length=30)
-     */
-    private $name;
-
-    /**
-     * @ORM\Column(name="role", type="string", length=20, unique=true)
-     */
-    private $role;
-
-    /**
-     * @ORM\ManyToMany(targetEntity="User", mappedBy="groups")
-     */
-    private $users;
-
-    public function __construct()
-    {
-        $this->users = new ArrayCollection();
-    }
-
-    // ... captadores y definidores para cada propiedad
-
-    /**
-     * @see RoleInterface
-     */
-    public function getRole()
-    {
-        return $this->role;
-    }
-}
-
                  -
                  -

                  Para mejorar el rendimiento y evitar la carga diferida de grupos al recuperar un usuario desde el proveedor de entidad personalizado, la mejor solución es unir la relación de grupos en el método UserRepository::loadUserByUsername(). Esto buscará al usuario y sus roles / grupos asociados con una sola consulta:

                  -
                  // src/Acme/UserBundle/Entity/UserRepository.php
-namespace Acme\UserBundle\Entity;
-
-// ...
-
-class UserRepository extends EntityRepository implements UserProviderInterface
-{
-    public function loadUserByUsername($username)
-    {
-        $q = $this
-            ->createQueryBuilder('u')
-            ->select('u, g')
-            ->leftJoin('u.groups', 'g')
-            ->where('u.username = :username OR u.email = :email')
-            ->setParameter('username', $username)
-            ->setParameter('email', $username)
-            ->getQuery();
-
-        // ...
-    }
-
-    // ...
-}
-
                  -
                  -

                  El método generador de consultas QueryBuilder::leftJoin() se une y recupera a partir de los grupos relacionados al modelo de la clase AcmeUserBundle:User de usuario cuando un usuario se recupera con su dirección de correo electrónico o nombre de usuario.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/force_https.html b/cookbook/security/force_https.html deleted file mode 100644 index ce3173d..0000000 --- a/cookbook/security/force_https.html +++ /dev/null @@ -1,192 +0,0 @@ - - - - - - - Cómo forzar HTTPS o HTTP a diferentes URL — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo forzar HTTPS o HTTP a diferentes URL

                  -

                  Puedes forzar áreas de tu sitio para que utilicen el protocolo HTTPS en la configuración de seguridad. Esto se hace a través de las reglas access_control usando la opción requires_channel. Por ejemplo, si deseas forzar que todas las URL que empiecen con /secure usen HTTPS podrías utilizar la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    access_control:
-    - path: ^/secure
-      roles: ROLE_ADMIN
-      requires_channel: https
-
                    -
                    -
                    • -
                  • XML
                    <access-control>
-    <rule path="^/secure" role="ROLE_ADMIN" requires_channel="https" />
-</access-control>
-
                    -
                    -
                    • -
                  • PHP
                    'access_control' => array(
-    array(
-        'path'             => '^/secure',
-        'role'             => 'ROLE_ADMIN',
-        'requires_channel' => 'https',
-    ),
-),
-
                    -
                    -
                    • -
                  -
                  -

                  El formulario de acceso necesita permitir acceso anónimo, de lo contrario los usuarios serán incapaces de autenticarse. Para forzarlo a usar HTTPS puedes utilizar reglas access_control usando el rol IS_AUTHENTICATED_ANONYMOUSLY:

                  -
                  -
                    -
                  • YAML
                    access_control:
-    - path: ^/login
-      roles: IS_AUTHENTICATED_ANONYMOUSLY
-      requires_channel: https
-
                    -
                    -
                    • -
                  • XML
                    <access-control>
-    <rule path="^/login"
-          role="IS_AUTHENTICATED_ANONYMOUSLY"
-          requires_channel="https" />
-</access-control>
-
                    -
                    -
                    • -
                  • PHP
                    'access_control' => array(
-    array(
-        'path'             => '^/login',
-        'role'             => 'IS_AUTHENTICATED_ANONYMOUSLY',
-        'requires_channel' => 'https',
-    ),
-),
-
                    -
                    -
                    • -
                  -
                  -

                  También es posible especificar el uso de HTTPS en la configuración de enrutado consulta Cómo forzar las rutas para que siempre usen HTTPS o HTTP para más detalles.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/form_login.html b/cookbook/security/form_login.html deleted file mode 100644 index 7827266..0000000 --- a/cookbook/security/form_login.html +++ /dev/null @@ -1,421 +0,0 @@ - - - - - - - Cómo personalizar el formulario de acceso — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo personalizar el formulario de acceso

                  -

                  Usar un formulario de acceso para autenticación es -un método común y flexible para gestionar la autenticación en Symfony2. Casi todos los aspectos del formulario de acceso se pueden personalizar. La configuración predeterminada completa se muestra en la siguiente sección.

                  -
                  -

                  Referencia de configuración del formulario de acceso

                  -

                  Para ver la referencia de la configuración del formulario de acceso completa, consulta la Referencia de configuración de Security. Algunas de las opciones más interesantes se explican a continuación.

                  -
                  -
                  -

                  Redirigiendo después del ingreso

                  -

                  Puedes cambiar el lugar al cual el formulario de acceso redirige después de un inicio de sesión satisfactorio utilizando diferentes opciones de configuración. Por omisión, el formulario redirigirá a la URL que el usuario solicitó (por ejemplo, la URL que provocó la exhibición del formulario de acceso). -Por ejemplo, si el usuario solicitó http://www.example.com/admin/post/18/edit, -entonces después de que inicie sesión, eventualmente sera llevada a http://www.example.com/admin/post/18/edit. -Esto se consigue almacenando en la sesión la URL solicitada. -Si no hay presente una URL en la sesión (tal vez el usuario se dirigió directamente a la página de inicio de sesión), entonces el usuario es redirigido a la página predeterminada, la cual es / (es decir, la página predeterminada del formulario de acceso). Puedes cambiar este comportamiento de varias maneras.

                  -
                  -

                  Nota

                  -

                  Como se ha mencionado, por omisión el usuario es redirigido a la página que solicitó originalmente. A veces, esto puede causar problemas, como si una petición en segundo plano de AJAX «pareciera» ser la última URL visitada, causando que el usuario sea redirigido allí. Para información sobre cómo controlar este comportamiento, consulta Cómo cambiar el comportamiento predeterminado de la ruta destino.

                  -
                  -
                  -

                  Cambiando la página predeterminada

                  -

                  En primer lugar, la página predeterminada se puede configurar (es decir, la página a la cual el usuario es redirigido si no se almacenó una página previa en la sesión). To set it to the -default_security_target route use the following config:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    firewalls:
-        main:
-            form_login:
-                # ...
-                default_target_path: default_security_target
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <form-login
-            default_target_path="default_security_target"
-        />
-    </firewall>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main' => array(
-            // ...
-
-            'form_login' => array(
-                // ...
-                'default_target_path' => 'default_security_target',
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Now, when no URL is set in the session, users will be sent to the -default_security_target route.

                  -
                  -
                  -

                  Redirigiendo siempre a la página predeterminada

                  -

                  Puedes hacer que los usuarios siempre sean redirigidos a la página predeterminada, independientemente de la URL que hayan solicitado con anterioridad, estableciendo la opción always_use_default_target_path a true:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    firewalls:
-        main:
-            form_login:
-                # ...
-                always_use_default_target_path: true
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <form-login
-            always_use_default_target_path="true"
-        />
-    </firewall>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main' => array(
-            // ...
-
-            'form_login' => array(
-                // ...
-                'always_use_default_target_path' => true,
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Utilizando la URL referente

                  -

                  En caso de no haber almacenado una URL anterior en la sesión, posiblemente desees intentar usar el HTTP_REFERER en su lugar, ya que a menudo será el mismo. Lo puedes hacer estableciendo use_referer a true (el valor predefinido es false):

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    firewalls:
-        main:
-            form_login:
-                # ...
-                use_referer:        true
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <form-login
-            use_referer="true"
-        />
-    </firewall>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main' => array(
-            // ...
-
-            'form_login' => array(
-                // ...
-                'use_referer' => true,
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  -Nuevo en la versión 2.1: A partir de 2.1, si la referencia es igual a la opción login_path, el usuario será redirigido a default_target_path.

                  -
                  -
                  -

                  Controlando la URL a redirigir desde el interior del formulario

                  -

                  También puedes sustituir a dónde es redirigido el usuario a través del formulario en sí mismo incluyendo un campo oculto con el nombre _target_path. Por ejemplo, para redirigir a la URL definida por alguna ruta cuenta, usa lo siguiente:

                  -
                  -
                    -
                  • Twig
                    {# src/Acme/SecurityBundle/Resources/views/Security/login.html.twig #}
-{% if error %}
-    <div>{{ error.message }}</div>
-{% endif %}
-
-<form action="{{ path('login_check') }}" method="post">
-    <label for="username">Username:</label>
-    <input type="text" id="username" name="_username" value="{{ last_username }}" />
-
-    <label for="password">Password:</label>
-    <input type="password" id="password" name="_password" />
-
-    <input type="hidden" name="_target_path" value="cuenta" />
-
-    <input type="submit" name="login" />
-</form>
-
                    -
                    -
                    • -
                  • PHP
                    <!-- src/Acme/SecurityBundle/Resources/views/Security/login.html.php -->
-<?php if ($error): ?>
-    <div><?php echo $error->getMessage() ?></div>
-<?php endif; ?>
-
-<form action="<?php echo $view['router']->generate('login_check') ?>" method="post">
-    <label for="username">Username:</label>
-    <input type="text" id="username" name="_username" value="<?php echo $last_username ?>" />
-
-    <label for="password">Password:</label>
-    <input type="password" id="password" name="_password" />
-
-    <input type="hidden" name="_target_path" value="cuenta" />
-
-    <input type="submit" name="login" />
-</form>
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, el usuario será redirigido al valor del campo oculto del formulario. El valor del atributo puede ser una ruta relativa, una URL absoluta, o un nombre de ruta. Incluso, puedes cambiar el nombre del campo oculto en el formulario cambiando la opción target_path_parameter a otro valor.

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    firewalls:
-        main:
-            form_login:
-                target_path_parameter: redirect_url
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <form-login
-            target_path_parameter="redirect_url"
-        />
-    </firewall>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main' => array(
-            'form_login' => array(
-                'target_path_parameter' => redirect_url,
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Redirigiendo en ingreso fallido

                  -

                  Además de redirigir al usuario después de un inicio de sesión exitoso, también puedes definir la URL a que el usuario será redirigido después de un ingreso fallido (por ejemplo, si presentó un nombre de usuario o contraseña no válidos). Por omisión, el usuario es dirigido de nuevo al formulario de acceso. You can set this to a different route (e.g. -login_failure) with the following config:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    firewalls:
-        main:
-            form_login:
-                # ...
-                failure_path: login_failure
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <form-login
-            failure_path="login_failure"
-        />
-    </firewall>
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main' => array(
-            // ...
-
-            'form_login' => array(
-                // ...
-                'failure_path' => 'login_failure',
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/index.html b/cookbook/security/index.html deleted file mode 100644 index 45804d4..0000000 --- a/cookbook/security/index.html +++ /dev/null @@ -1,198 +0,0 @@ - - - - - - - Seguridad — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Seguridad

                  -
                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/remember_me.html b/cookbook/security/remember_me.html deleted file mode 100644 index 9d3521c..0000000 --- a/cookbook/security/remember_me.html +++ /dev/null @@ -1,282 +0,0 @@ - - - - - - - Cómo agregar la funcionalidad «recuérdame» al inicio de sesión — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo agregar la funcionalidad «recuérdame» al inicio de sesión

                  -

                  Una vez que un usuario está autenticado, normalmente sus credenciales se almacenan en la sesión. Esto significa que cuando termina la sesión esta se desechará y tendrás que proporcionar de nuevo tus datos de acceso la siguiente vez que quieras acceder a la aplicación. Puedes permitir a tus usuarios que elijan entre permanecer conectados durante más tiempo del que dure la sesión con una cookie con la opción remember_me del cortafuegos. -El cortafuegos necesita tener configurada una clave secreta, la cual se utiliza para cifrar el contenido de la cookie. También tiene varias opciones con los valores predefinidos mostrados a continuación:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-firewalls:
-    main:
-        remember_me:
-            key:      "%secret%"
-            lifetime: 31536000 # 365 días en segundos
-            path:     /
-            domain:   ~ # El valor predeterminado es el dominio actual de $_SERVER
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <firewall>
-        <remember-me
-            key      = "%secret%"
-            lifetime = "31536000" <!-- 365 días en segundos -->
-            path     = "/"
-            domain   = "" <!-- El valor predeterminado es el dominio actual de $_SERVER -->
-        />
-    </firewall>
-</config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'main' => array(
-            'remember_me' => array(
-                'key'      => '%secret%',
-                'lifetime' => 31536000, // 365 days in seconds
-                'path'     => '/',
-                'domain'   => '', // Defaults to the current domain from $_SERVER
-            ),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Es buena idea ofrecer al usuario la opción de utilizar o no la funcionalidad recuérdame, ya que no siempre es adecuada. La forma habitual de hacerlo consiste en añadir una casilla de verificación en el formulario de acceso. Al dar a la casilla de verificación el nombre _remember_me, la cookie se ajustará automáticamente cuando la casilla esté marcada y el usuario inicia sesión satisfactoriamente. Por lo tanto, tu formulario de acceso específico en última instancia, podría tener este aspecto:

                  -
                  -
                    -
                  • Twig
                    {# src/Acme/SecurityBundle/Resources/views/Security/login.html.twig #}
-{% if error %}
-    <div>{{ error.message }}</div>
-{% endif %}
-
-<form action="{{ path('login_check') }}" method="post">
-    <label for="username">Username:</label>
-    <input type="text" id="username" name="_username" value="{{ last_username }}" />
-
-    <label for="password">Password:</label>
-    <input type="password" id="password" name="_password" />
-
-    <input type="checkbox" id="remember_me" name="_remember_me" checked />
-    <label for="remember_me">Keep me logged in</label>
-
-    <input type="submit" name="login" />
-</form>
-
                    -
                    -
                    • -
                  • PHP
                    <!-- src/Acme/SecurityBundle/Resources/views/Security/login.html.php -->
-<?php if ($error): ?>
-    <div><?php echo $error->getMessage() ?></div>
-<?php endif; ?>
-
-<form action="<?php echo $view['router']->generate('login_check') ?>" method="post">
-    <label for="username">Username:</label>
-    <input type="text" id="username"
-           name="_username" value="<?php echo $last_username ?>" />
-
-    <label for="password">Password:</label>
-    <input type="password" id="password" name="_password" />
-
-    <input type="checkbox" id="remember_me" name="_remember_me" checked />
-    <label for="remember_me">Keep me logged in</label>
-
-    <input type="submit" name="login" />
-</form>
-
                    -
                    -
                    • -
                  -
                  -

                  El usuario entonces, se registra automáticamente en las subsecuentes visitas, mientras que la cookie sea válida.

                  -
                  -

                  Forzando al usuario a volver a autenticarse antes de acceder a ciertos recursos

                  -

                  Cuando el usuario vuelve a tu sitio, se autentica automáticamente en función de la información almacenada en la cookie recuérdame. Esto permite al usuario acceder a recursos protegidos como si el usuario se hubiera autenticado en realidad al visitar el sitio.

                  -

                  En algunos casos, sin embargo, puedes obligar al usuario a realmente volver a autenticarse antes de acceder a ciertos recursos. Por ejemplo, podrías permitir a un usuario de «recuérdame» ver la información básica de la cuenta, pero luego obligarlo a volver a autenticarse realmente antes de modificar dicha información.

                  -

                  El componente de seguridad proporciona una manera fácil de hacerlo. Además de los roles asignados explícitamente, a los usuarios se les asigna automáticamente uno de los siguientes roles, dependiendo de cómo se hayan autenticado:

                  -
                    -
                  • IS_AUTHENTICATED_ANONYMOUSLY — asignado automáticamente a un usuario que está en una parte del sitio protegida por el cortafuegos, pero que no ha iniciado sesión. -Esto sólo es posible si se le ha permitido el acceso anónimo.
                    • -
                  • IS_AUTHENTICATED_REMEMBERED — asignado automáticamente a un usuario autenticado a través de una cookie recuérdame.
                    • -
                  • IS_AUTHENTICATED_FULLY — asignado automáticamente a un usuario que haya proporcionado sus datos de acceso durante la sesión actual.
                    • -
                  -

                  Las puedes utilizar para controlar el acceso más allá de los roles asignados explícitamente.

                  -
                  -

                  Nota

                  -

                  Si tienes el rol IS_AUTHENTICATED_REMEMBERED, entonces también tienes el rol IS_AUTHENTICATED_ANONYMOUSLY. Si tienes el rol IS_AUTHENTICATED_FULLY, entonces también tienes los otros dos roles. En otras palabras, estos roles representan tres niveles de «fortaleza» incremental en la autenticación.

                  -
                  -

                  Puedes utilizar estos roles adicionales para un control más preciso sobre el acceso a ciertas partes de un sitio. Por ejemplo, posiblemente desees que el usuario pueda ver su cuenta en /cuenta cuando está autenticado por cookie, pero tiene que proporcionar sus datos de acceso para poder editar la información de la cuenta. Lo puedes hacer protegiendo acciones específicas del controlador usando estos roles. La acción de edición en el controlador se puede proteger usando el servicio Contexto.

                  -

                  En el siguiente ejemplo, la acción sólo es permitida si el usuario tiene el rol IS_AUTHENTICATED_FULLY.

                  -
                  // ...
-use Symfony\Component\Security\Core\Exception\AccessDeniedException
-
-public function editAction()
-{
-    if (false === $this->get('security.context')->isGranted(
-        'IS_AUTHENTICATED_FULLY'
-       )) {
-        throw new AccessDeniedException();
-    }
-
-    // ...
-}
-
                  -
                  -

                  También puedes optar por instalar y utilizar el opcional JMSSecurityExtraBundle, el cual puede proteger tu controlador usando anotaciones:

                  -
                  use JMS\SecurityExtraBundle\Annotation\Secure;
-
-/**
- * @Secure(roles="IS_AUTHENTICATED_FULLY")
- */
-public function editAction($name)
-{
-    // ...
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Si, además, hubiera un control de acceso en tu configuración de seguridad que requiere que el usuario tenga un rol ROLE_USER a fin de acceder a cualquier área de la cuenta, entonces tendríamos la siguiente situación:

                  -
                    -
                  • Si un usuario no autenticado (o un usuario autenticado anónimamente) intenta acceder al área de la cuenta, el usuario se tendrá que autenticar.
                    • -
                  • Una vez que el usuario ha introducido su nombre de usuario y contraseña, asumiendo que el usuario recibe el rol ROLE_USER de tu configuración, el usuario tendrá el rol IS_AUTHENTICATED_FULLY y podrá acceder a cualquier página en la sección de cuenta, incluyendo el controlador editAction.
                    • -
                  • Si termina la sesión del usuario, cuando el usuario vuelve al sitio, podrá acceder a cada página de la cuenta —a excepción de la página de edición— sin verse obligado a volver a autenticarse. Sin embargo, cuando intenta acceder al controlador editAction, se verá obligado a volver a autenticarse, ya que no está, sin embargo, totalmente autenticado.
                    • -
                  -
                  -

                  Para más información sobre proteger servicios o métodos de esta manera, consulta Cómo proteger cualquier servicio o método de tu aplicación.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/securing_services.html b/cookbook/security/securing_services.html deleted file mode 100644 index c2fda8a..0000000 --- a/cookbook/security/securing_services.html +++ /dev/null @@ -1,363 +0,0 @@ - - - - - - - Cómo proteger cualquier servicio o método de tu aplicación — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo proteger cualquier servicio o método de tu aplicación

                  -

                  En el capítulo sobre seguridad, puedes ver cómo proteger un controlador requiriendo el servicio security.context desde el Contenedor de servicios y comprobando el rol del usuario actual:

                  -
                  // ...
-use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-
-public function helloAction($name)
-{
-    if (false === $this->get('security.context')->isGranted('ROLE_ADMIN')) {
-        throw new AccessDeniedException();
-    }
-
-    // ...
-}
-
                  -
                  -

                  También puedes proteger cualquier servicio de manera similar, inyectándole el servicio security.context. Para una introducción general a la inyección de dependencias en servicios consulta el capítulo Contenedor de servicios del libro. Por ejemplo, supongamos que tienes una clase NewsletterManager que envía mensajes de correo electrónico y deseas restringir su uso a únicamente los usuarios que tienen algún rol ROLE_NEWSLETTER_ADMIN. Antes de agregar la protección, la clase se ve algo parecida a esta:

                  -
                  // src/Acme/HelloBundle/Newsletter/NewsletterManager.php
-namespace Acme\HelloBundle\Newsletter;
-
-class NewsletterManager
-{
-
-    public function sendNewsletter()
-    {
-        // ... donde realmente haces el trabajo
-    }
-
-    // ...
-}
-
                  -
                  -

                  Nuestro objetivo es comprobar el rol del usuario cuando se llama al método sendNewsletter(). El primer paso para esto es inyectar el servicio security.context en el objeto. Dado que no tiene sentido no realizar la comprobación de seguridad, este es un candidato ideal para el constructor de inyección, lo cual garantiza que el objeto del contexto de seguridad estará disponible dentro de la clase NewsletterManager:

                  -
                  namespace Acme\HelloBundle\Newsletter;
-
-use Symfony\Component\Security\Core\SecurityContextInterface;
-
-class NewsletterManager
-{
-    protected $securityContext;
-
-    public function __construct(SecurityContextInterface $securityContext)
-    {
-        $this->securityContext = $securityContext;
-    }
-
-    // ...
-}
-
                  -
                  -

                  Luego, en tu configuración del servicio, puedes inyectar el servicio:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager
-
-services:
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        arguments: ["@security.context"]
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Newsletter\NewsletterManager</parameter>
-</parameters>
-
-    <services>
-    <service id="newsletter_manager" class="%newsletter_manager.class%">
-        <argument type="service" id="security.context"/>
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Newsletter\NewsletterManager');
-
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%',
-    array(new Reference('security.context'))
-));
-
                    -
                    -
                    • -
                  -
                  -

                  El servicio inyectado se puede utilizar para realizar la comprobación de seguridad cuando se llama al método sendNewsletter():

                  -
                  namespace Acme\HelloBundle\Newsletter;
-
-use Symfony\Component\Security\Core\Exception\AccessDeniedException;
-use Symfony\Component\Security\Core\SecurityContextInterface;
-// ...
-
-class NewsletterManager
-{
-    protected $securityContext;
-
-    public function __construct(SecurityContextInterface $securityContext)
-    {
-        $this->securityContext = $securityContext;
-    }
-
-    public function sendNewsletter()
-    {
-        if (false === $this->securityContext->isGranted('ROLE_NEWSLETTER_ADMIN')) {
-            throw new AccessDeniedException();
-        }
-
-        // ...
-    }
-
-    // ...
-}
-
                  -
                  -

                  Si el usuario actual no tiene el rol ROLE_NEWSLETTER_ADMIN, se le pedirá que inicie sesión.

                  -
                  -

                  Protegiendo métodos usando anotaciones

                  -

                  También puedes proteger con anotaciones las llamadas a métodos en cualquier servicio usando el paquete opcional JMSSecurityExtraBundle. Este paquete está incluido en la edición estándar de Symfony2.

                  -

                  Para habilitar la funcionalidad de las anotaciones, etiqueta el servicio que deseas proteger con la etiqueta security.secure_service (también puedes habilitar esta funcionalidad automáticamente para todos los servicios, consulta la barra lateral más adelante):

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-# ...
-
-services:
-    newsletter_manager:
-        # ...
-        tags:
-            -  { name: security.secure_service }
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<!-- ... -->
-
-    <services>
-    <service id="newsletter_manager" class="%newsletter_manager.class%">
-        <!-- ... -->
-        <tag name="security.secure_service" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-$definition = new Definition(
-    '%newsletter_manager.class%',
-    array(new Reference('security.context'))
-));
-$definition->addTag('security.secure_service');
-$container->setDefinition('newsletter_manager', $definition);
-
                    -
                    -
                    • -
                  -
                  -

                  Entonces puedes obtener los mismos resultados que el anterior usando una anotación:

                  -
                  namespace Acme\HelloBundle\Newsletter;
-
-use JMS\SecurityExtraBundle\Annotation\Secure;
-// ...
-
-class NewsletterManager
-{
-
-    /**
-     * @Secure(roles="ROLE_NEWSLETTER_ADMIN")
-     */
-    public function sendNewsletter()
-    {
-        // ...
-    }
-
-    // ...
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  Las anotaciones trabajan debido a que se crea una clase delegada para la clase que realiza las comprobaciones de seguridad. Esto significa que, si bien puedes utilizar las anotaciones sobre métodos públicos y protegidos, no las puedes utilizar con los métodos privados o los métodos marcados como finales.

                  -
                  -

                  El JMSSecurityExtraBundle también te permite proteger los parámetros y valores devueltos de los métodos. Para más información, consulta la documentación de JMSSecurityExtraBundle.

                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/target_path.html b/cookbook/security/target_path.html deleted file mode 100644 index e6ee011..0000000 --- a/cookbook/security/target_path.html +++ /dev/null @@ -1,189 +0,0 @@ - - - - - - - Cómo cambiar el comportamiento predeterminado de la ruta destino — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo cambiar el comportamiento predeterminado de la ruta destino

                  -

                  By default, the security component retains the information of the last request -URI in a session variable named _security.main.target_path (with main being -the name of the firewall, defined in security.yml). Upon a successful -login, the user is redirected to this path, as to help her continue from the -last known page she visited.

                  -

                  En algunas ocasiones, esto es inesperado. Por ejemplo, cuando la URI de la última petición HTTP POST contra una ruta que está configurada para permitir sólo un método POST, el usuario es redirigido a esta ruta sólo para obtener un error 404.

                  -

                  Para evitar este comportamiento, sólo tendrías que extender la clse ExceptionListener y anular el método llamado setTargetPath().

                  -

                  En primer lugar, redefine el parámetro security.exception_listener.class en el archivo de configuración. Lo puedes hacer en tu archivo de configuración (en app/config) o en un archivo de configuración importado desde un paquete:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    security.exception_listener.class: Acme\HelloBundle\Security\Firewall\ExceptionListener
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="security.exception_listener.class">Acme\HelloBundle\Security\Firewall\ExceptionListener</parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-// ...
-$container->setParameter('security.exception_listener.class', 'Acme\HelloBundle\Security\Firewall\ExceptionListener');
-
                    -
                    -
                    • -
                  -
                  -

                  A continuación, crea tu propio escucha ExceptionListener:

                  -
                  // src/Acme/HelloBundle/Security/Firewall/ExceptionListener.php
-namespace Acme\HelloBundle\Security\Firewall;
-
-use Symfony\Component\HttpFoundation\Request;
-use Symfony\Component\Security\Http\Firewall\ExceptionListener as BaseExceptionListener;
-
-class ExceptionListener extends BaseExceptionListener
-{
-    protected function setTargetPath(Request $request)
-    {
-        // no guarda la ruta destino de peticiones XHR y distintas de GET
-        // Puedes añadir cualquier lógica que quieras
-        if ($request->isXmlHttpRequest() || 'GET' !== $request->getMethod()) {
-            return;
-        }
-
-        $request->getSession()->set('_security.main.target_path', $request->getUri());
-    }
-}
-
                  -
                  -

                  ¡Aquí añade tanta lógica como requieras para tu escenario!

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/security/voters.html b/cookbook/security/voters.html deleted file mode 100644 index fd3f901..0000000 --- a/cookbook/security/voters.html +++ /dev/null @@ -1,292 +0,0 @@ - - - - - - - Cómo implementar tu propio votante para agregar direcciones IP a la lista negra — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo implementar tu propio votante para agregar direcciones IP a la lista negra

                  -

                  El componente Security de Symfony2 ofrece varias capas para autenticar a los usuarios. -Una de las capas se llama voter («votante» en adelante). Un votante es una clase dedicada que comprueba si el usuario tiene el derecho a conectarse con la aplicación. Por ejemplo, Symfony2 proporciona una capa que comprueba si el usuario está plenamente autenticado o si se espera que tenga algún rol.

                  -

                  A veces es útil crear un votante personalizado para tratar un caso específico que la plataforma no maneja. En esta sección, aprenderás cómo crear un votante que te permitirá añadir usuarios a la lista negra por su IP.

                  -
                  -

                  La interfaz Votante

                  -

                  Un votante personalizado debe implementar la clase Symfony\Component\Security\Core\Authorization\Voter\VoterInterface, la cual requiere los tres siguientes métodos:

                  -
                  interface VoterInterface
-{
-    function supportsAttribute($attribute);
-    function supportsClass($class);
-    function vote(TokenInterface $token, $object, array $attributes);
-}
-
                  -
                  -

                  El método supportsAttribute() se utiliza para comprobar si el votante admite el atributo usuario dado (es decir: un rol, una acl, etc.).

                  -

                  El método supportsClass() se utiliza para comprobar si el votante apoya a la clase simbólica usuario actual.

                  -

                  El método vote() debe implementar la lógica del negocio que verifica cuando o no se concede acceso al usuario. Este método debe devolver uno de los siguientes valores:

                  -
                    -
                  • VoterInterface::ACCESS_GRANTED: El usuario ahora puede acceder a la aplicación
                    • -
                  • VoterInterface::ACCESS_ABSTAIN: El votante no puede decidir si permitir al usuario o no
                    • -
                  • VoterInterface::ACCESS_DENIED: El usuario no tiene permitido el acceso a la aplicación
                    • -
                  -

                  En este ejemplo, debes comprobar si la dirección IP del usuario coincide con una lista de direcciones en la lista negra. Si la IP del usuario está en la lista negra, devuelves VoterInterface::ACCESS_DENIED, de lo contrario devuelves VoterInterface::ACCESS_ABSTAIN porque la finalidad del votante sólo es denegar el acceso, no permitir el acceso.

                  -
                  -
                  -

                  Creando un votante personalizado

                  -

                  Para poner a un usuario en la lista negra basándote en su IP, puedes utilizar el servicio request y comparar la dirección IP contra un conjunto de direcciones IP en la lista negra:

                  -
                  // src/Acme/DemoBundle/Security/Authorization/Voter/ClientIpVoter.php
-namespace Acme\DemoBundle\Security\Authorization\Voter;
-
-use Symfony\Component\DependencyInjection\ContainerInterface;
-use Symfony\Component\Security\Core\Authorization\Voter\VoterInterface;
-use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
-
-class ClientIpVoter implements VoterInterface
-{
-    public function __construct(ContainerInterface $container, array $blacklistedIp = array())
-    {
-        $this->container     = $container;
-        $this->blacklistedIp = $blacklistedIp;
-    }
-
-    public function supportsAttribute($attribute)
-    {
-        // no vas a verificar contra un atributo de usuario, por tanto devuelve 'true'
-        return true;
-    }
-
-    public function supportsClass($class)
-    {
-        // tu votante apoya todo tipo de clases, por tanto devuelve 'true'
-        return true;
-    }
-
-    function vote(TokenInterface $token, $object, array $attributes)
-    {
-        $request = $this->container->get('request');
-        if (in_array($request->getClientIp(), $this->blacklistedIp)) {
-            return VoterInterface::ACCESS_DENIED;
-        }
-
-        return VoterInterface::ACCESS_ABSTAIN;
-    }
-}
-
                  -
                  -

                  ¡Eso es todo! El votante está listo. El siguiente paso es inyectar el votante en el nivel de seguridad. Esto se puede hacer fácilmente a través del contenedor de servicios.

                  -
                  -
                  -

                  Declarando el votante como servicio

                  -

                  Para inyectar al votante en la capa de seguridad, lo debes declarar como servicio, y etiquetarlo como «security.voter»:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/AcmeBundle/Resources/config/services.yml
-services:
-    security.access.blacklist_voter:
-        class:      Acme\DemoBundle\Security\Authorization\Voter\ClientIpVoter
-        arguments:  ["@service_container", [123.123.123.123, 171.171.171.171]]
-        public:     false
-        tags:
-                - { name: security.voter }
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/AcmeBundle/Resources/config/services.xml -->
-<service id="security.access.blacklist_voter"
-         class="Acme\DemoBundle\Security\Authorization\Voter\ClientIpVoter" public="false">
-    <argument type="service" id="service_container" strict="false" />
-    <argument type="collection">
-        <argument>123.123.123.123</argument>
-        <argument>171.171.171.171</argument>
-    </argument>
-    <tag name="security.voter" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/AcmeBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-$definition = new Definition(
-    'Acme\DemoBundle\Security\Authorization\Voter\ClientIpVoter',
-    array(
-        new Reference('service_container'),
-        array('123.123.123.123', '171.171.171.171'),
-    ),
-);
-$definition->addTag('security.voter');
-$definition->setPublic(false);
-
-$container->setDefinition('security.access.blacklist_voter', $definition);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Asegúrate de importar este archivo de configuración desde el archivo de configuración principal de tu aplicación (por ejemplo, app/config/config.yml). Para más información, consulta Importando configuración con imports. Para leer más acerca de definir los servicios en general, consulta el capítulo Contenedor de servicios.

                  -
                  -
                  -
                  -

                  Cambiando la estrategia de decisión de acceso

                  -

                  A fin de que los cambios del nuevo votante tengan efecto, tienes que cambiar la estrategia de decisión de acceso predeterminada, la cual por omisión, concede el acceso si cualquier votante permite el acceso.

                  -

                  En este caso, escoge la estrategia unanimous. A diferencia de la estrategia afirmativa (predeterminada), con la estrategia unanimous, aunque un votante sólo niega el acceso (p. ej. el ClientIpVoter), no otorga acceso al usuario final.

                  -

                  Para ello, sustituye la sección predeterminada access_decision_manager del archivo de configuración de tu aplicación con el siguiente código.

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    access_decision_manager:
-        # la estrategia puede ser: affirmative, unanimous o consensus
-        strategy: unanimous
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <!-- La estrategia pueder ser: affirmative, unanimous o consensus -->
-    <access-decision-manager strategy="unanimous">
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.xml
-$container->loadFromExtension('security', array(
-    // la estrategia puede ser: affirmative, unanimous o consensus
-    'access_decision_manager' => array(
-        'strategy' => 'unanimous',
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  ¡Eso es todo! Ahora, a la hora de decidir si un usuario debe tener acceso o no, el nuevo votante niega el acceso a cualquier usuario en la lista negra de direcciones IP.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/serializer.html b/cookbook/serializer.html deleted file mode 100644 index 6fc647f..0000000 --- a/cookbook/serializer.html +++ /dev/null @@ -1,231 +0,0 @@ - - - - - - - How to use the Serializer — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  How to use the Serializer

                  -

                  Serializing and deserializing to and from objects and different formats (e.g. -JSON or XML) is a very complex topic. Symfony comes with a -Serializer Component, which gives you some -tools that you can leverage for your solution.

                  -

                  In fact, before you start, get familiar with the serializer, normalizers -and encoders by reading the Serializer Component. -You should also check out the JMSSerializerBundle, which expands on the -functionality offered by Symfony’s core serializer.

                  -
                  -

                  Activating the Serializer

                  -

                  -Nuevo en la versión 2.3: The Serializer has always existed in Symfony, but prior to Symfony 2.3, -you needed to build the serializer service yourself.

                  -

                  The serializer service is not available by default. To turn it on, activate -it in your configuration:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-framework:
-    # ...
-    serializer:
-        enabled: true
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<framework:config ...>
-    <!-- ... -->
-    <framework:serializer enabled="true" />
-</framework:config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('framework', array(
-    // ...
-    'serializer' => array(
-        'enabled' => true
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Adding Normalizers and Encoders

                  -

                  Once enabled, the serializer service will be available in the container -and will be loaded with two encoders -(Symfony\Component\Serializer\Encoder\JsonEncoder and -Symfony\Component\Serializer\Encoder\XmlEncoder) -but no normalizers, meaning you’ll -need to load your own.

                  -

                  You can load normalizers and/or encoders by tagging them as -serializer.normalizer and -serializer.encoder. It’s also -possible to set the priority of the tag in order to decide the matching order.

                  -

                  Here an example on how to load the load -the Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-services:
-   get_set_method_normalizer:
-      class: Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer
-      tags:
-             - { name: serializer.normalizer }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-    <services>
-    <service id="get_set_method_normalizer" class="Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer">
-        <tag name="serializer.normalizer" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$definition = new Definition(
-    'Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer'
-));
-$definition->addTag('serializer.normalizer');
-$container->setDefinition('get_set_method_normalizer', $definition);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  The Symfony\Component\Serializer\Normalizer\GetSetMethodNormalizer -is broken by design. As soon as you have a circular object graph, an -infinite loop is created when calling the getters. You’re encouraged -to add your own normalizers that fit your use-case.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/service_container/compiler_passes.html b/cookbook/service_container/compiler_passes.html deleted file mode 100644 index a601a3b..0000000 --- a/cookbook/service_container/compiler_passes.html +++ /dev/null @@ -1,156 +0,0 @@ - - - - - - - Cómo trabajan los pases del compilador en los paquetes — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo trabajan los pases del compilador en los paquetes

                  -

                  Los pases del compilador te brindan la oportunidad de manipular otras definiciones de servicio que se han registrado en el contenedor de servicios. Puedes leer sobre su creación en la sección de componentes «Compilando el contenedor». -Para registrar un pase del compilador desde un paquete, necesitas añadirlo al método constructor de la definición de la clase de tu paquete:

                  -
                  // src/Acme/MailerBundle/AcmeMailerBundle.php
-namespace Acme\MailerBundle;
-
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-use Acme\MailerBundle\DependencyInjection\Compiler\CustomCompilerPass;
-
-class AcmeMailerBundle extends Bundle
-{
-    public function build(ContainerBuilder $container)
-    {
-        parent::build($container);
-
-        $container->addCompilerPass(new CustomCompilerPass());
-    }
-}
-
                  -
                  -

                  Uno de los más comunes casos de uso de los pases del compilador es trabajar con servicios etiquetados (lee más acerca de las etiquetas en la sección de componentes «Trabajando con servicios etiquetados»). -Si estás utilizando etiquetas personalizadas en un paquete, entonces por convención, los nombres de etiqueta consisten del nombre del paquete (en minúsculas, guiones bajos como separadores), seguidos por un punto y finalmente el nombre «real». Por ejemplo, si quieres introducir una especie de «transporte» en tu etiqueta AcmeMailerBundle, la debes nombrar acme_mailer.transport.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/service_container/event_listener.html b/cookbook/service_container/event_listener.html deleted file mode 100644 index bc0dcd0..0000000 --- a/cookbook/service_container/event_listener.html +++ /dev/null @@ -1,239 +0,0 @@ - - - - - - - Cómo crear un escucha de evento — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear un escucha de evento

                  -

                  Symfony dispone de varios eventos y ganchos que puedes utilizar para desencadenar un comportamiento personalizado en tu aplicación. Estos eventos los desencadena el componente HttpKernel y se pueden ver en la clase Symfony\Component\HttpKernel\KernelEvents.

                  -

                  Para enganchar a un evento y agregar tu propia lógica personalizada, tienes que crear un servicio que actúe como un escucha de eventos en ese evento. En este artículo, vas a crear un servicio que actúe como un Escucha de excepción, permitiéndote modificar la forma en que tu aplicación exhibe las excepciones. El evento KernelEvents::EXCEPTION es sólo uno de los eventos principales del núcleo:

                  -
                  // src/Acme/DemoBundle/EventListener/AcmeExceptionListener.php
-namespace Acme\DemoBundle\EventListener;
-
-use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent;
-use Symfony\Component\HttpFoundation\Response;
-use Symfony\Component\HttpKernel\Exception\HttpExceptionInterface;
-
-class AcmeExceptionListener
-{
-    public function onKernelException(GetResponseForExceptionEvent $event)
-    {
-        // consigues el objeto excepción del evento recibido
-        $exception = $event->getException();
-        $message = sprintf(
-            'My Error says: %s with code: %s',
-            $exception->getMessage(),
-            $exception->getCode()
-        );
-
-        // Personaliza tu objeto respuesta para mostrar los detalles de la excepción
-        $response = new Response();
-        $response->setContent($message);
-
-        // HttpExceptionInterface es un tipo de excepción especial que
-        // contiene el código de estado y detalles de la cabecera
-        if ($exception instanceof HttpExceptionInterface) {
-            $response->setStatusCode($exception->getStatusCode());
-            $response->headers->replace($exception->getHeaders());
-        } else {
-            $response->setStatusCode(500);
-        }
-
-        // envía el objeto respuesta modificado al evento
-        $event->setResponse($response);
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Cada evento recibe un tipo de objeto $event ligeramente diferente. El evento kernel.exception, es de la clase Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent. -Para ver qué tipo de objeto recibe cada escucha de eventos, consulta la clase Symfony\Component\HttpKernel\KernelEvents.

                  -
                  -

                  Ahora que has creado la clase, sólo la tienes que registrar como un servicio y notificar a Symfony que es un «escucha» para el evento kernel.exception usando una «etiqueta» especial:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-services:
-    kernel.listener.your_listener_name:
-        class: Acme\DemoBundle\EventListener\AcmeExceptionListener
-        tags:
-                - { name: kernel.event_listener, event: kernel.exception, method: onKernelException }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<service id="kernel.listener.your_listener_name" class="Acme\DemoBundle\EventListener\AcmeExceptionListener">
-    <tag name="kernel.event_listener" event="kernel.exception" method="onKernelException" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container
-    ->register('kernel.listener.your_listener_name', 'Acme\DemoBundle\EventListener\AcmeExceptionListener')
-    ->addTag('kernel.event_listener', array('event' => 'kernel.exception', 'method' => 'onKernelException'))
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Existe una opción adicional para la etiqueta priority, esta no es obligatoria y por omisión es 0. Este valor puede ser desde -255 hasta 255, y los escuchas se ejecutan en ese orden de prioridad. Esto es útil cuando necesitas garantizar que un escucha se ejecuta antes que otro.

                  -
                  -
                  -

                  Eventos de petición, comprobación de tipo

                  -

                  Una sola página puede hacer varias peticiones (una petición maestra, y luego múltiples subpeticiones), por lo tanto cuando trabajas con la instancia del KernelEvents::REQUEST, podrías necesitar verificar el tipo de la petición. Esto se puede hacer fácilmente de la siguiente manera:

                  -
                  // src/Acme/DemoBundle/EventListener/AcmeRequestListener.php
-namespace Acme\DemoBundle\EventListener;
-
-use Symfony\Component\HttpKernel\Event\GetResponseEvent;
-use Symfony\Component\HttpKernel\HttpKernel;
-
-class AcmeRequestListener
-{
-    public function onKernelRequest(GetResponseEvent $event)
-    {
-        if (HttpKernel::MASTER_REQUEST != $event->getRequestType()) {
-            // no hace nada si no es una petición mástil
-            return;
-        }
-
-        // ...
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Dos tipos de peticiones están disponibles en la interfaz Symfony\Component\HttpKernel\HttpKernelInterface: HttpKernelInterface::MASTER_REQUEST y HttpKernelInterface::SUB_REQUEST.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/service_container/factories.html b/cookbook/service_container/factories.html deleted file mode 100644 index d1e684b..0000000 --- a/cookbook/service_container/factories.html +++ /dev/null @@ -1,309 +0,0 @@ - - - - - - - Cómo utilizar el patrón factoría para crear servicios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar el patrón factoría para crear servicios

                  -

                  Los contenedores de servicios de Symfony2 proporcionan una forma eficaz de controlar la creación de objetos, lo cual te permite especificar los argumentos pasados al constructor, así como llamar a los métodos y establecer parámetros. A veces, sin embargo, esto no te proporcionará todo lo necesario para construir tus objetos. -Por esta situación, puedes utilizar una factoría para crear el objeto y decirle al contenedor de servicios que llame a un método en la factoría y no crear directamente una instancia del objeto.

                  -

                  Supongamos que tienes una factoría que configura y devuelve un nuevo objeto NewsletterManager:

                  -
                  namespace Acme\HelloBundle\Newsletter;
-
-class NewsletterFactory
-{
-    public function get()
-    {
-        $newsletterManager = new NewsletterManager();
-
-        // ...
-
-        return $newsletterManager;
-    }
-}
-
                  -
                  -

                  Para que el objeto NewsletterManager esté disponible como servicio, puedes configurar el contenedor de servicios para usar la clase factoría NewsletterFactory:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager
-    newsletter_factory.class: Acme\HelloBundle\Newsletter\NewsletterFactory
-services:
-    newsletter_manager:
-        class:          %newsletter_manager.class%
-        factory_class:  %newsletter_factory.class%
-        factory_method: get
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Newsletter\NewsletterManager</parameter>
-    <parameter key="newsletter_factory.class">Acme\HelloBundle\Newsletter\NewsletterFactory</parameter>
-</parameters>
-
-    <services>
-    <service id="newsletter_manager"
-             class="%newsletter_manager.class%"
-             factory-class="%newsletter_factory.class%"
-             factory-method="get"
-    />
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Newsletter\NewsletterManager');
-$container->setParameter('newsletter_factory.class', 'Acme\HelloBundle\Newsletter\NewsletterFactory');
-
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%'
-))->setFactoryClass(
-    '%newsletter_factory.class%'
-)->setFactoryMethod(
-    'get'
-);
-
                    -
                    -
                    • -
                  -
                  -

                  Cuando especificas la clase que utiliza la factoría (a través de factory_class), el método será llamado estáticamente. Si la factoría debe crear una instancia y se llama al método del objeto resultante (como en este ejemplo), configura como servicio la propia factoría:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager
-    newsletter_factory.class: Acme\HelloBundle\Newsletter\NewsletterFactory
-services:
-    newsletter_factory:
-        class:            %newsletter_factory.class%
-    newsletter_manager:
-        class:            %newsletter_manager.class%
-        factory_service:  newsletter_factory
-        factory_method:   get
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Newsletter\NewsletterManager</parameter>
-    <parameter key="newsletter_factory.class">Acme\HelloBundle\Newsletter\NewsletterFactory</parameter>
-</parameters>
-
-    <services>
-    <service id="newsletter_factory" class="%newsletter_factory.class%"/>
-    <service id="newsletter_manager"
-             class="%newsletter_manager.class%"
-             factory-service="newsletter_factory"
-             factory-method="get"
-    />
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Newsletter\NewsletterManager');
-$container->setParameter('newsletter_factory.class', 'Acme\HelloBundle\Newsletter\NewsletterFactory');
-
-$container->setDefinition('newsletter_factory', new Definition(
-    '%newsletter_factory.class%'
-))
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%'
-))->setFactoryService(
-    'newsletter_factory'
-)->setFactoryMethod(
-    'get'
-);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  El servicio factoría se especifica por su nombre de id y no una referencia al propio servicio. Por lo tanto, no es necesario utilizar la sintaxis @.

                  -
                  -
                  -

                  Pasando argumentos al método factoría

                  -

                  Si tienes que pasar argumentos al método factoría, puedes utilizar la opción arguments dentro del contenedor de servicios. Por ejemplo, supongamos que el método get en el ejemplo anterior tiene el servicio de templating como argumento:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Newsletter\NewsletterManager
-    newsletter_factory.class: Acme\HelloBundle\Newsletter\NewsletterFactory
-services:
-    newsletter_factory:
-        class:            %newsletter_factory.class%
-    newsletter_manager:
-        class:            %newsletter_manager.class%
-        factory_service:  newsletter_factory
-        factory_method:   get
-        arguments:
-            -             @templating
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Newsletter\NewsletterManager</parameter>
-    <parameter key="newsletter_factory.class">Acme\HelloBundle\Newsletter\NewsletterFactory</parameter>
-</parameters>
-
-    <services>
-    <service id="newsletter_factory" class="%newsletter_factory.class%"/>
-    <service id="newsletter_manager"
-             class="%newsletter_manager.class%"
-             factory-service="newsletter_factory"
-             factory-method="get"
-    >
-        <argument type="service" id="templating" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Newsletter\NewsletterManager');
-$container->setParameter('newsletter_factory.class', 'Acme\HelloBundle\Newsletter\NewsletterFactory');
-
-$container->setDefinition('newsletter_factory', new Definition(
-    '%newsletter_factory.class%'
-))
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%',
-    array(new Reference('templating'))
-))->setFactoryService(
-    'newsletter_factory'
-)->setFactoryMethod(
-    'get'
-);
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/service_container/index.html b/cookbook/service_container/index.html deleted file mode 100644 index 7655ed5..0000000 --- a/cookbook/service_container/index.html +++ /dev/null @@ -1,145 +0,0 @@ - - - - - - - Contenedor de servicios — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/service_container/parentservices.html b/cookbook/service_container/parentservices.html deleted file mode 100644 index dc6d1cc..0000000 --- a/cookbook/service_container/parentservices.html +++ /dev/null @@ -1,609 +0,0 @@ - - - - - - - Cómo gestionar dependencias comunes con servicios padre — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo gestionar dependencias comunes con servicios padre

                  -

                  A medida que agregas más funcionalidad a tu aplicación, puedes comenzar a tener clases relacionadas que comparten algunas de las mismas dependencias. Por ejemplo, puedes tener un gestor de boletines que utiliza inyección para definir sus dependencias:

                  -
                  namespace Acme\HelloBundle\Mail;
-
-use Acme\HelloBundle\Mailer;
-use Acme\HelloBundle\EmailFormatter;
-
-class NewsletterManager
-{
-    protected $mailer;
-    protected $emailFormatter;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEmailFormatter(EmailFormatter $emailFormatter)
-    {
-        $this->emailFormatter = $emailFormatter;
-    }
-    // ...
-}
-
                  -
                  -

                  y también una clase para tus Tarjetas de saludo que comparte las mismas dependencias:

                  -
                  namespace Acme\HelloBundle\Mail;
-
-use Acme\HelloBundle\Mailer;
-use Acme\HelloBundle\EmailFormatter;
-
-class GreetingCardManager
-{
-    protected $mailer;
-    protected $emailFormatter;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEmailFormatter(EmailFormatter $emailFormatter)
-    {
-        $this->emailFormatter = $emailFormatter;
-    }
-    // ...
-}
-
                  -
                  -

                  La configuración del servicio de estas clases se vería algo como esto:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Mail\NewsletterManager
-    greeting_card_manager.class: Acme\HelloBundle\Mail\GreetingCardManager
-services:
-    my_mailer:
-        # ...
-    my_email_formatter:
-        # ...
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        calls:
-            - [ setMailer, [ @my_mailer ] ]
-            - [ setEmailFormatter, [ @my_email_formatter] ]
-
-    greeting_card_manager:
-        class:     %greeting_card_manager.class%
-        calls:
-            - [ setMailer, [ @my_mailer ] ]
-            - [ setEmailFormatter, [ @my_email_formatter] ]
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Mail\NewsletterManager</parameter>
-    <parameter key="greeting_card_manager.class">Acme\HelloBundle\Mail\GreetingCardManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ... >
-      <!-- ... -->
-    </service>
-    <service id="my_email_formatter" ... >
-      <!-- ... -->
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    <service id="greeting_card_manager" class="%greeting_card_manager.class%">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Mail\NewsletterManager');
-$container->setParameter('greeting_card_manager.class', 'Acme\HelloBundle\Mail\GreetingCardManager');
-
-$container->setDefinition('my_mailer', ... );
-$container->setDefinition('my_email_formatter', ... );
-$container->setDefinition('newsletter_manager', new Definition(
-    '%newsletter_manager.class%'
-))->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-$container->setDefinition('greeting_card_manager', new Definition(
-    '%greeting_card_manager.class%'
-))->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Hay mucha repetición, tanto en las clases como en la configuración. Esto significa que si cambias, por ejemplo, las clases de correo de la aplicación Mailer de EmailFormatter para inyectarlas a través del constructor, tendrías que actualizar la configuración en dos lugares. Del mismo modo, si necesitas hacer cambios en los métodos definidores tendrías que hacerlo en ambas clases. La forma típica de hacer frente a los métodos comunes de estas clases relacionadas es extraerlas en una superclase:

                  -
                  namespace Acme\HelloBundle\Mail;
-
-use Acme\HelloBundle\Mailer;
-use Acme\HelloBundle\EmailFormatter;
-
-abstract class MailManager
-{
-    protected $mailer;
-    protected $emailFormatter;
-
-    public function setMailer(Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function setEmailFormatter(EmailFormatter $emailFormatter)
-    {
-        $this->emailFormatter = $emailFormatter;
-    }
-    // ...
-}
-
                  -
                  -

                  Entonces NewsletterManager y GreetingCardManager pueden extender esta -superclase:

                  -
                  namespace Acme\HelloBundle\Mail;
-
-class NewsletterManager extends MailManager
-{
-    // ...
-}
-
                  -
                  -

                  y:

                  -
                  namespace Acme\HelloBundle\Mail;
-
-class GreetingCardManager extends MailManager
-{
-    // ...
-}
-
                  -
                  -

                  De manera similar, el contenedor de servicios de Symfony2 también apoya la extensión de servicios en la configuración por lo que también puedes reducir la repetición especificando un padre para un servicio.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Mail\NewsletterManager
-    greeting_card_manager.class: Acme\HelloBundle\Mail\GreetingCardManager
-    mail_manager.class: Acme\HelloBundle\Mail\MailManager
-services:
-    my_mailer:
-        # ...
-    my_email_formatter:
-        # ...
-    mail_manager:
-        class:     %mail_manager.class%
-        abstract:  true
-        calls:
-            - [ setMailer, [ @my_mailer ] ]
-            - [ setEmailFormatter, [ @my_email_formatter] ]
-
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        parent: mail_manager
-
-    greeting_card_manager:
-        class:     %greeting_card_manager.class%
-        parent: mail_manager
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Mail\NewsletterManager</parameter>
-    <parameter key="greeting_card_manager.class">Acme\HelloBundle\Mail\GreetingCardManager</parameter>
-    <parameter key="mail_manager.class">Acme\HelloBundle\Mail\MailManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ... >
-      <!-- ... -->
-    </service>
-    <service id="my_email_formatter" ... >
-      <!-- ... -->
-    </service>
-    <service id="mail_manager" class="%mail_manager.class%" abstract="true">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%" parent="mail_manager"/>
-    <service id="greeting_card_manager" class="%greeting_card_manager.class%" parent="mail_manager"/>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Mail\NewsletterManager');
-$container->setParameter('greeting_card_manager.class', 'Acme\HelloBundle\Mail\GreetingCardManager');
-$container->setParameter('mail_manager.class', 'Acme\HelloBundle\Mail\MailManager');
-
-$container->setDefinition('my_mailer', ... );
-$container->setDefinition('my_email_formatter', ... );
-$container->setDefinition('mail_manager', new Definition(
-    '%mail_manager.class%'
-))->SetAbstract(
-    true
-)->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-$container->setDefinition('newsletter_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%newsletter_manager.class%'
-);
-$container->setDefinition('greeting_card_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%greeting_card_manager.class%'
-);
-
                    -
                    -
                    • -
                  -
                  -

                  En este contexto, tener un servicio padre implica que los argumentos y las llamadas a métodos del servicio padre se deben utilizar en los servicios descendientes. -En concreto, los métodos definidores especificados para el servicio padre serán llamados cuando se crean instancias del servicio descendiente.

                  -
                  -

                  Nota

                  -

                  Si quitas la clave de configuración del padre, el servicio todavía seguirá siendo una instancia, por supuesto, extendiendo la clase MailManager. La diferencia es que la omisión del padre en la clave de configuración significa que las llamadas definidas en el servicio mail_manager no se ejecutarán al crear instancias de los servicios descendientes.

                  -
                  -

                  La clase padre es abstracta, ya que no se deben crear instancias directamente. Al establecerla como abstracta en el archivo de configuración como se hizo anteriormente, significa que sólo se puede utilizar como un servicio primario y no se puede utilizar directamente como un servicio para inyectar y retirar en tiempo de compilación. En otras palabras, existe sólo como una “plantilla” que otros servicios pueden utilizar.

                  -
                  -

                  Sustituyendo dependencias padre

                  -

                  Puede haber ocasiones en las que deses sustituir que clase se pasa a una dependencia en un servicio hijo único. Afortunadamente, añadiendo la llamada al método de configuración para el servicio hijo, las dependencias establecidas por la clase principal se sustituyen. Así que si necesitas pasar una dependencia diferente sólo para la clase NewsletterManager, la configuración sería la siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Mail\NewsletterManager
-    greeting_card_manager.class: Acme\HelloBundle\Mail\GreetingCardManager
-    mail_manager.class: Acme\HelloBundle\Mail\MailManager
-services:
-    my_mailer:
-        # ...
-    my_alternative_mailer:
-        # ...
-    my_email_formatter:
-        # ...
-    mail_manager:
-        class:     %mail_manager.class%
-        abstract:  true
-        calls:
-            - [ setMailer, [ @my_mailer ] ]
-            - [ setEmailFormatter, [ @my_email_formatter] ]
-
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        parent: mail_manager
-        calls:
-            - [ setMailer, [ @my_alternative_mailer ] ]
-
-    greeting_card_manager:
-        class:     %greeting_card_manager.class%
-        parent: mail_manager
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Mail\NewsletterManager</parameter>
-    <parameter key="greeting_card_manager.class">Acme\HelloBundle\Mail\GreetingCardManager</parameter>
-    <parameter key="mail_manager.class">Acme\HelloBundle\Mail\MailManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" ... >
-      <!-- ... -->
-    </service>
-    <service id="my_alternative_mailer" ... >
-      <!-- ... -->
-    </service>
-    <service id="my_email_formatter" ... >
-      <!-- ... -->
-    </service>
-    <service id="mail_manager" class="%mail_manager.class%" abstract="true">
-        <call method="setMailer">
-             <argument type="service" id="my_mailer" />
-        </call>
-        <call method="setEmailFormatter">
-             <argument type="service" id="my_email_formatter" />
-        </call>
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%" parent="mail_manager">
-         <call method="setMailer">
-             <argument type="service" id="my_alternative_mailer" />
-        </call>
-    </service>
-    <service id="greeting_card_manager" class="%greeting_card_manager.class%" parent="mail_manager"/>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Mail\NewsletterManager');
-$container->setParameter('greeting_card_manager.class', 'Acme\HelloBundle\Mail\GreetingCardManager');
-$container->setParameter('mail_manager.class', 'Acme\HelloBundle\Mail\MailManager');
-
-$container->setDefinition('my_mailer', ... );
-$container->setDefinition('my_alternative_mailer', ... );
-$container->setDefinition('my_email_formatter', ... );
-$container->setDefinition('mail_manager', new Definition(
-    '%mail_manager.class%'
-))->SetAbstract(
-    true
-)->addMethodCall('setMailer', array(
-    new Reference('my_mailer')
-))->addMethodCall('setEmailFormatter', array(
-    new Reference('my_email_formatter')
-));
-$container->setDefinition('newsletter_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%newsletter_manager.class%'
-)->addMethodCall('setMailer', array(
-    new Reference('my_alternative_mailer')
-));
-$container->setDefinition('greeting_card_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%greeting_card_manager.class%'
-);
-
                    -
                    -
                    • -
                  -
                  -

                  El GreetingCardManager recibirá las mismas dependencias que antes, pero la NewsletterManager será pasada a my_alternative_mailer en lugar del servicio my_mailer.

                  -
                  -
                  -

                  Colección de dependencias

                  -

                  Cabe señalar que el método definidor sustituido en el ejemplo anterior en realidad se invoca dos veces — una vez en la definición del padre y otra más en la definición del hijo. En el ejemplo anterior, esto estaba muy bien, ya que la segunda llamada a setMailer sustituye al objeto mailer establecido por la primera llamada.

                  -

                  En algunos casos, sin embargo, esto puede ser un problema. Por ejemplo, si la sustitución a la llamada al método consiste en añadir algo a una colección, entonces se agregarán dos objetos a la colección. A continuación mostramos tal caso, si la clase padre se parece a esto:

                  -
                  namespace Acme\HelloBundle\Mail;
-
-use Acme\HelloBundle\Mailer;
-use Acme\HelloBundle\EmailFormatter;
-
-abstract class MailManager
-{
-    protected $filters;
-
-    public function setFilter($filter)
-    {
-        $this->filters[] = $filter;
-    }
-    // ...
-}
-
                  -
                  -

                  Si tienes la siguiente configuración:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    newsletter_manager.class: Acme\HelloBundle\Mail\NewsletterManager
-    mail_manager.class: Acme\HelloBundle\Mail\MailManager
-services:
-    my_filter:
-        # ...
-    another_filter:
-        # ...
-    mail_manager:
-        class:     %mail_manager.class%
-        abstract:  true
-        calls:
-            - [ setFilter, [ @my_filter ] ]
-
-    newsletter_manager:
-        class:     %newsletter_manager.class%
-        parent: mail_manager
-        calls:
-            - [ setFilter, [ @another_filter ] ]
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="newsletter_manager.class">Acme\HelloBundle\Mail\NewsletterManager</parameter>
-    <parameter key="mail_manager.class">Acme\HelloBundle\Mail\MailManager</parameter>
-</parameters>
-
-    <services>
-    <service id="my_filter" ... >
-      <!-- ... -->
-    </service>
-    <service id="another_filter" ... >
-      <!-- ... -->
-    </service>
-    <service id="mail_manager" class="%mail_manager.class%" abstract="true">
-        <call method="setFilter">
-             <argument type="service" id="my_filter" />
-        </call>
-    </service>
-    <service id="newsletter_manager" class="%newsletter_manager.class%" parent="mail_manager">
-         <call method="setFilter">
-             <argument type="service" id="another_filter" />
-        </call>
-    </service>
-    </services>
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('newsletter_manager.class', 'Acme\HelloBundle\Mail\NewsletterManager');
-$container->setParameter('mail_manager.class', 'Acme\HelloBundle\Mail\MailManager');
-
-$container->setDefinition('my_filter', ... );
-$container->setDefinition('another_filter', ... );
-$container->setDefinition('mail_manager', new Definition(
-    '%mail_manager.class%'
-))->SetAbstract(
-    true
-)->addMethodCall('setFilter', array(
-    new Reference('my_filter')
-));
-$container->setDefinition('newsletter_manager', new DefinitionDecorator(
-    'mail_manager'
-))->setClass(
-    '%newsletter_manager.class%'
-)->addMethodCall('setFilter', array(
-    new Reference('another_filter')
-));
-
                    -
                    -
                    • -
                  -
                  -

                  En este ejemplo, el setFilter del servicio newsletter_manager se llamará dos veces, dando lugar a que el array $filters contenga ambos objetos my_filter y another_filter. Esto es genial si sólo quieres agregar filtros adicionales para subclases. Si deseas reemplazar los filtros pasados a la subclase, elimina de la matriz el ajuste de la configuración, esto evitará que la clase setFilter base sea llamada.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/service_container/scopes.html b/cookbook/service_container/scopes.html deleted file mode 100644 index a2743c4..0000000 --- a/cookbook/service_container/scopes.html +++ /dev/null @@ -1,433 +0,0 @@ - - - - - - - Cómo trabajar con ámbitos — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo trabajar con ámbitos

                  -

                  Esta entrada trata sobre los ámbitos, un tema un tanto avanzado relacionado con el Contenedor de servicios. Si alguna vez has tenido un error hablando de «ámbitos» en la creación de servicios o necesitas crear un servicio que depende del servicio Petición, entonces este artículo es para ti.

                  -
                  -

                  Entendiendo los ámbitos

                  -

                  El ámbito de un servicio controla la duración de una instancia de un servicio utilizado por el contenedor. El componente Inyección de dependencias tiene dos ámbitos genéricos:

                  -
                    -
                  • container (la opción predeterminada): Usa la misma instancia cada vez que la solicites desde el contenedor.
                    • -
                  • prototype: Crea una nueva instancia cada vez que solicitas el servicio.
                    • -
                  -

                  The -Symfony\Component\HttpKernel\DependencyInjection\ContainerAwareHttpKernel -also defines a third scope: request. This scope is tied to the request, -meaning a new instance is created for each subrequest and is unavailable -outside the request (for instance in the CLI).

                  -

                  Los ámbitos agregan una restricción en las dependencias de un servicio: un servicio no puede depender de los servicios de un ámbito más estrecho. For example, if you create a generic -my_foo service, but try to inject the request service, you will receive -a Symfony\Component\DependencyInjection\Exception\ScopeWideningInjectionException -when compiling the container. Lee la barra lateral más adelante para más detalles.

                  -
                  -

                  Ámbitos y dependencias

                  -

                  Imagina que has configurado un servicio my_mailer. No has configurado el ámbito del servicio, por lo tanto el predeterminado es el contenedor. En otras palabras, cada vez que solicitas al contenedor el servicio my_mailer, obtienes el mismo objeto. Esta, por lo general, es la forma en que deseas que trabajen tus servicios.

                  -

                  Sin embargo, imagina que necesitas el servicio Petición en tu servicio my_mailer, tal vez porque estás leyendo la URL de la Petición actual. -Por lo tanto, lo agregas como argumento del constructor. Ve por qué esto representa un problema:

                  -
                    -

                  • Al solicitar my_mailer, se crea una instancia de my_mailer (llamada MailerA) y se pasa al servicio Petición (llamado RequestA). ¡La vida es buena!

                    -
                    • -

                  • Ahora hiciste una subpetición en Symfony, la cual es una elegante manera de decir que has llamado, por ejemplo, a la función {{ render(...) }} de Twig, que ejecuta otro controlador. Internamente, el antiguo servicio Petición (RequestA) en realidad es reemplazado por una instancia de la nueva petición (RequestB). -Esto sucede en segundo plano, y es totalmente normal.

                    -
                    • -

                  • En tu controlador incorporado, una vez más invocas al servicio my_mailer. Debido a que tu servicio está en el ámbito del contenedor, se vuelve a utilizar la misma instancia (MailerA). Pero aquí está el problema: la instancia de MailerA todavía contiene el viejo objeto RequestA, que ahora no es el objeto petición correcto (RequestB que ahora es el servicio Petición actual). Esto es nuy sutil, pero el desajuste puede causar grandes problemas, lo cual no está permitido.

                    -

                    Por lo tanto, esa es la razón por la cual existen los ámbitos, y la forma en que pueden causar problemas. Sigue leyendo para encontrar las soluciones comunes.

                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Un servicio puede, por supuesto, depender de un servicio desde un ámbito más amplio sin ningún problema.

                  -
                  -
                  -
                  -

                  Usando un servicio de menor ámbito

                  -

                  If your service has a dependency on a scoped service (like the request), -you have three ways to deal with it:

                  -
                    -
                  • Use setter injection if the dependency is “synchronized”; this is the -recommended way and the best solution for the request instance as it is -synchronized with the request scope (see -Using a synchronized Service).
                    • -
                  • Put your service in the same scope as the dependency (or a narrower one). If -you depend on the request service, this means putting your new service -in the request scope (see Changing the Scope of your Service);
                    • -
                  • Pass the entire container to your service and retrieve your dependency from -the container each time you need it to be sure you have the right instance -– your service can live in the default container scope (see -Passing the Container as a Dependency of your Service);
                    • -
                  -

                  Each scenario is detailed in the following sections.

                  -
                  -

                  Using a synchronized Service

                  -

                  -Nuevo en la versión 2.3: Synchronized services are new in Symfony 2.3.

                  -

                  Injecting the container or setting your service to a narrower scope have -drawbacks. For synchronized services (like the request), using setter -injection is the best option as it has no drawbacks and everything works -without any special code in your service or in your definition:

                  -
                  // src/Acme/HelloBundle/Mail/Mailer.php
-namespace Acme\HelloBundle\Mail;
-
-use Symfony\Component\HttpFoundation\Request;
-
-class Mailer
-{
-    protected $request;
-
-    public function setRequest(Request $request = null)
-    {
-        $this->request = $request;
-    }
-
-    public function sendEmail()
-    {
-        if (null === $this->request) {
-            // throw an error?
-        }
-
-        // ... haz algo con la respuesta de redirección
-    }
-}
-
                  -
                  -

                  Whenever the request scope is entered or left, the service container will -automatically call the setRequest() method with the current request -instance.

                  -

                  You might have noticed that the setRequest() method accepts null as a -valid value for the request argument. That’s because when leaving the -request scope, the request instance can be null (for the master -request for instance). Of course, you should take care of this possibility in -your code. This should also be taken into account when declaring your service:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-services:
-    greeting_card_manager:
-        class: Acme\HelloBundle\Mail\GreetingCardManager
-        calls:
-            - [setRequest, ['@?request']]
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-    <services>
-    <service id="greeting_card_manager"
-        class="Acme\HelloBundle\Mail\GreetingCardManager"
-    />
-    <call method="setRequest">
-        <argument type="service" id="request" on-invalid="null" strict="false" />
-    </call>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-
-$definition = $container->setDefinition(
-    'greeting_card_manager',
-    new Definition('Acme\HelloBundle\Mail\GreetingCardManager')
-)
-->addMethodCall('setRequest', array(
-    new Reference('request', ContainerInterface::NULL_ON_INVALID_REFERENCE, false)
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  You can declare your own synchronized services very easily; here is -the declaration of the request service for reference:

                  -
                  -
                    -
                  • YAML
                    services:
-    request:
-        scope: request
-        synthetic: true
-        synchronized: true
-
                    -
                    -
                    • -
                  • XML
                    <services>
-<service id="request" scope="request" synthetic="true" synchronized="true" />
-</services>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\ContainerInterface;
-
-$definition = $container->setDefinition('request')
-    ->setScope('request')
-    ->setSynthetic(true)
-    ->setSynchronized(true);
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  Changing the Scope of your Service

                  -

                  Changing the scope of a service should be done in its definition:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-services:
-    greeting_card_manager:
-        class: Acme\HelloBundle\Mail\GreetingCardManager
-        scope: request
-        arguments: [@request]
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-    <services>
-    <service id="greeting_card_manager"
-        class="Acme\HelloBundle\Mail\GreetingCardManager"
-        scope="request"
-    />
-    <argument type="service" id="request" />
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$definition = $container->setDefinition(
-    'greeting_card_manager',
-    new Definition(
-        'Acme\HelloBundle\Mail\GreetingCardManager',
-        array(new Reference('request'),
-    ))
-)->setScope('request');
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Passing the Container as a Dependency of your Service

                  -

                  Setting the scope to a narrower one is not always possible (for instance, a -twig extension must be in the container scope as the Twig environment -needs it as a dependency). In these cases, you can pass the entire container -into your service:

                  -
                  // src/Acme/HelloBundle/Mail/Mailer.php
-namespace Acme\HelloBundle\Mail;
-
-use Symfony\Component\DependencyInjection\ContainerInterface;
-
-class Mailer
-{
-    protected $container;
-
-    public function __construct(ContainerInterface $container)
-    {
-        $this->container = $container;
-    }
-
-    public function sendEmail()
-    {
-        $request = $this->container->get('request');
-        // ... haz algo con la respuesta de redirección
-    }
-}
-
                  -
                  -
                  -

                  Prudencia

                  -

                  Ten cuidado de no guardar la petición en una propiedad del objeto para una futura llamada del servicio, ya que sería el mismo problema descrito en la primera sección (excepto que Symfony no puede detectar qué estás haciendo mal).

                  -
                  -

                  La configuración del servicio de esta clase sería algo como esto:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/services.yml
-parameters:
-    # ...
-    my_mailer.class: Acme\HelloBundle\Mail\Mailer
-services:
-    my_mailer:
-        class:     "%my_mailer.class%"
-        arguments: ["@service_container"]
-        # scope: el contenedor se puede omitir como si fuera el predefinido
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/services.xml -->
-<parameters>
-    <!-- ... -->
-    <parameter key="my_mailer.class">Acme\HelloBundle\Mail\Mailer</parameter>
-</parameters>
-
-    <services>
-    <service id="my_mailer" class="%my_mailer.class%">
-         <argument type="service" id="service_container" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-use Symfony\Component\DependencyInjection\Reference;
-
-// ...
-$container->setParameter('my_mailer.class', 'Acme\HelloBundle\Mail\Mailer');
-
-$container->setDefinition('my_mailer', new Definition(
-    '%my_mailer.class%',
-    array(new Reference('service_container'))
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Inyectar el contenedor completo en un servicio generalmente no es una buena idea (inyecta sólo lo que necesitas).

                  -
                  -
                  -

                  Truco

                  -

                  If you define a controller as a service then you can get the Request -object without injecting the container by having it passed in as an -argument of your action method. See -La Petición como argumento para el controlador for details.

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/service_container/tags.html b/cookbook/service_container/tags.html deleted file mode 100644 index 23ff1e4..0000000 --- a/cookbook/service_container/tags.html +++ /dev/null @@ -1,290 +0,0 @@ - - - - - - - Cómo hacer que tus servicios utilicen etiquetas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo hacer que tus servicios utilicen etiquetas

                  -

                  Varios de los servicios básicos de Symfony2 dependen de etiquetas para reconocer cuales servicios se deben cargar, notificar eventos, o manipular de alguna manera especial. -Por ejemplo, Twig utiliza la etiqueta twig.extension para cargar extensiones adicionales.

                  -

                  Pero también puedes utilizar etiquetas en tus propios paquetes. Por ejemplo, en caso de que tu servicio maneje una colección de algún tipo, o implementa una “cadena”, en la cual varias estrategias alternativas son juzgadas hasta que una de ellas tiene éxito. En este artículo voy a utilizar el ejemplo de una “cadena de transporte”, que es una colección de clases que implementan el \Swift_Transport. -Utilizando la cadena, el cliente de correo de Swift puede intentar varias formas de transporte, hasta que uno lo consigue. -Este artículo se centra principalmente en la parte de inyección de dependencias de la historia.

                  -

                  En primer lugar, define la clase TransportChain:

                  -
                  namespace Acme\MailerBundle;
-
-class TransportChain
-{
-    private $transports;
-
-    public function __construct()
-    {
-        $this->transports = array();
-    }
-
-    public function addTransport(\Swift_Transport  $transport)
-    {
-        $this->transports[] = $transport;
-    }
-}
-
                  -
                  -

                  Entonces, define la cadena como un servicio:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/MailerBundle/Resources/config/services.yml
-parameters:
-    acme_mailer.transport_chain.class: Acme\MailerBundle\TransportChain
-
-services:
-    acme_mailer.transport_chain:
-        class: %acme_mailer.transport_chain.class%
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/MailerBundle/Resources/config/services.xml -->
-
-<parameters>
-    <parameter key="acme_mailer.transport_chain.class">Acme\MailerBundle\TransportChain</parameter>
-</parameters>
-
-    <services>
-    <service id="acme_mailer.transport_chain" class="%acme_mailer.transport_chain.class%" />
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/MailerBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container->setParameter('acme_mailer.transport_chain.class', 'Acme\MailerBundle\TransportChain');
-
-$container->setDefinition('acme_mailer.transport_chain', new Definition('%acme_mailer.transport_chain.class%'));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Definiendo servicios con una etiqueta personalizada

                  -

                  Ahora queremos que varias de las clases \Swift_Transport para ejecutarse y añadirse a la cadena automáticamente usando el método addTransport(). -Como ejemplo podemos añadir los siguientes transportes como los servicios de:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/MailerBundle/Resources/config/services.yml
-services:
-    acme_mailer.transport.smtp:
-        class: \Swift_SmtpTransport
-        arguments:
-            - %mailer_host%
-        tags:
-            -  { name: acme_mailer.transport }
-    acme_mailer.transport.sendmail:
-        class: \Swift_SendmailTransport
-        tags:
-            -  { name: acme_mailer.transport }
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/MailerBundle/Resources/config/services.xml -->
-<service id="acme_mailer.transport.smtp" class="\Swift_SmtpTransport">
-    <argument>%mailer_host%</argument>
-    <tag name="acme_mailer.transport" />
-</service>
-
-<service id="acme_mailer.transport.sendmail" class="\Swift_SendmailTransport">
-    <tag name="acme_mailer.transport" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/MailerBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$definitionSmtp = new Definition('\Swift_SmtpTransport', array('%mailer_host%'));
-$definitionSmtp->addTag('acme_mailer.transport');
-$container->setDefinition('acme_mailer.transport.smtp', $definitionSmtp);
-
-$definitionSendmail = new Definition('\Swift_SendmailTransport');
-$definitionSendmail->addTag('acme_mailer.transport');
-$container->setDefinition('acme_mailer.transport.sendmail', $definitionSendmail);
-
                    -
                    -
                    • -
                  -
                  -

                  Observa las etiquetas de nombre “acme_mailer.transport”. Queremos que el paquete reconozca estos transportes y los añada a la cadena por sí mismo. A fin de conseguirlo, tenemos que añadir un método build() para la clase AcmeMailerBundle:

                  -
                  namespace Acme\MailerBundle;
-
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-
-use Acme\MailerBundle\DependencyInjection\Compiler\TransportCompilerPass;
-
-class AcmeMailerBundle extends Bundle
-{
-    public function build(ContainerBuilder $container)
-    {
-        parent::build($container);
-
-        $container->addCompilerPass(new TransportCompilerPass());
-    }
-}
-
                  -
                  -
                  -
                  -

                  Crear un CompilerPass

                  -

                  Habrás detectado una referencia a alguna clase TransportCompilerPass que todavía no existe. -Esta clase se asegurará de que se agreguen todos los servicios con una etiqueta acme_mailer.transport a la clase TransportChain llamando al -método addTransport(). El TransportCompilerPass debería tener este aspecto:

                  -
                  namespace Acme\MailerBundle\DependencyInjection\Compiler;
-
-use Symfony\Component\DependencyInjection\ContainerBuilder;
-use Symfony\Component\DependencyInjection\Compiler\CompilerPassInterface;
-use Symfony\Component\DependencyInjection\Reference;
-
-class TransportCompilerPass implements CompilerPassInterface
-{
-    public function process(ContainerBuilder $container)
-    {
-        if (false === $container->hasDefinition('acme_mailer.transport_chain')) {
-            return;
-        }
-
-        $definition = $container->getDefinition('acme_mailer.transport_chain');
-
-        foreach ($container->findTaggedServiceIds('acme_mailer.transport') as $id => $attributes) {
-            $definition->addMethodCall('addTransport', array(new Reference($id)));
-        }
-    }
-}
-
                  -
                  -

                  El método process() comprueba la existencia del servicio acme_mailer.transport_chain, a continuación, busca todos los servicios etiquetados cómo acme_mailer.transport. Los añade a la definición del servicio acme_mailer.transport_chain llamando a addTransport() por cada servicios "acme_mailer.transport" que haya encontrado. -El primer argumento de cada una de estas llamadas será el servicio de transporte de correo en sí mismo.

                  -
                  -

                  Nota

                  -

                  Por convención, los nombres de las etiquetas consisten del nombre del paquete (en minúsculas, y guiones bajos como separadores), seguido de un punto, y finalmente el nombre “real”, por lo que la etiqueta "transport" en el AcmeMailerBundle debe ser: acme_mailer.transport.

                  -
                  -
                  -
                  -

                  Definiendo el servicio compilado

                  -

                  Añadir el compilador pasado dará como resultado la generación automática de las siguientes líneas de código en el contenedor del servicio compilado. En caso de que estés trabajando en el entorno "dev", abre el archivo /cache/dev/appDevDebugProjectContainer.php y busca el método getTransportChainService(). Este debe tener este aspecto:

                  -
                  protected function getAcmeMailer_TransportChainService()
-{
-    $this->services['acme_mailer.transport_chain'] = $instance = new \Acme\MailerBundle\TransportChain();
-
-    $instance->addTransport($this->get('acme_mailer.transport.smtp'));
-    $instance->addTransport($this->get('acme_mailer.transport.sendmail'));
-
-    return $instance;
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/symfony1.html b/cookbook/symfony1.html deleted file mode 100644 index 6cc03cf..0000000 --- a/cookbook/symfony1.html +++ /dev/null @@ -1,348 +0,0 @@ - - - - - - - En qué difiere Symfony2 de symfony1 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  En qué difiere Symfony2 de symfony1

                  -

                  La plataforma Symfony2 representa una evolución significativa en comparación con la primera versión. Afortunadamente, con la arquitectura MVC en su núcleo, las habilidades para dominar un proyecto Symfony1 siguen siendo muy relevantes para el desarrollo de Symfony2. Claro, app.yml se ha ido, pero el enrutado, los controladores y las plantillas permanecen.

                  -

                  En este capítulo recorrerás las diferencias entre Symfony1 y Symfony2. -Como verás, se abordan muchas tareas de una manera ligeramente diferente. Llegarás a apreciar estas diferencias menores ya que promueven código estable, predecible, verificable y disociado de tus aplicaciones Symfony2.

                  -

                  Por lo tanto, siéntate y relájate mientras te llevo de «entonces» a «ahora».

                  -
                  -

                  Estructura del directorio

                  -

                  When looking at a Symfony2 project - for example, the `Symfony2 Standard Edition`_ - -you’ll notice a very different directory structure than in symfony1. Las diferencias, sin embargo, son un tanto superficiales.

                  -
                  -

                  El directorio app/

                  -

                  En symfony1, tu proyecto tiene una o más aplicaciones, y cada una vive dentro del directorio apps/ (por ejemplo, apps/frontend). De forma predeterminada en Symfony2, tienes una sola aplicación representada por el directorio app/. Al igual que en Symfony1, el directorio app/ contiene configuración específica a esa aplicación. Este también contiene directorios de caché, registro y plantillas específicas de tu aplicación, así como una clase núcleo (AppKernel), la cual es el objeto base que representa la aplicación.

                  -

                  A diferencia de Symfony1, casi no vive código PHP en el directorio app/. Este directorio no está destinado a ser el hogar de módulos o archivos de biblioteca como lo hizo en Symfony1. -En cambio, simplemente es el hogar de la configuración y otros recursos (plantillas, archivos de traducción).

                  -
                  -
                  -

                  El directorio src/

                  -

                  En pocas palabras, tu verdadero código va aquí. En Symfony2, todo el código real de tu aplicación, vive dentro de un paquete (aproximadamente equivalente a un complemento de Symfony1) y, por omisión, cada paquete vive dentro del directorio src. De esta manera, el directorio src es un poco como el directorio plugins en Symfony1, pero mucho más flexible. Además, mientras que tus paquetes deben vivir en el directorio src/, los paquetes de otros fabricantes pueden vivir en algún lugar dentro del directorio vendor/.

                  -

                  Para obtener una mejor imagen del directorio src/, primero vamos a pensar en una aplicación Symfony1. En primer lugar, parte de tu código probablemente viva dentro de una o más aplicaciones. Comúnmente son módulos, pero también podrían incluir otras clases PHP que pones en tu aplicación. Es posible que también crees un archivo schema.yml en el directorio config de tu proyecto y construyas varios archivos de modelo. Por último, para ayudar con alguna funcionalidad común, estarás usando varios complementos de terceros que viven en el directorio plugins/. -En otras palabras, el código que impulsa tu aplicación vive en muchos lugares diferentes.

                  -

                  En Symfony2, la vida es mucho más simple porque todo el código Symfony2 debe vivir en un paquete. En el pretendido proyecto de Symfony1, todo el código se podría trasladar a uno o más complementos (la cual, de hecho, es una muy buena práctica). Suponiendo que todos los módulos, clases PHP, esquema, configuración de enrutado, etc. fueran trasladados a un complemento, el directorio plugins/ de Symfony1 sería muy similar al src/ de Symfony2.

                  -

                  En pocas palabras de nuevo, el directorio src/ es donde vive el código, activos, plantillas y la mayoría de cualquier otra cosa específica a tu proyecto.

                  -
                  -
                  -

                  El directorio vendor/

                  -

                  El directorio vendor/ básicamente es el equivalente al directorio lib/vendor/ de Symfony1, el cual fue el directorio convencional para todas las bibliotecas y paquetes de los proveedores. De manera predeterminada, encontrarás los archivos de la biblioteca Symfony2 en este directorio, junto con varias otras bibliotecas dependientes, como Doctrine2, Twig y SwiftMailer. Los paquetes de terceros usados por Symfony2 generalmente vive en algún lugarn dentro del directorio vendor/.

                  -
                  -
                  -

                  El Directorio web/

                  -

                  No ha cambiado mucho el directorio web/. La diferencia más notable es la ausencia de los directorios css/`, js/ e images/. Esto es intencional. Al igual que con tu código PHP, todos los activos también deben vivir dentro de un paquete. Con la ayuda de una consola de ordenes, el directorio Resources/public/ de cada paquete se copia o enlaza simbólicamente al directorio web/bundles/. Esto nos permite mantener los activos organizados dentro de tu paquete, pero estando disponibles al público. Para asegurarte de que todos los paquetes están disponibles, ejecuta la siguiente orden:

                  -
                  $ php app/console assets:install web
-
                  -
                  -
                  -

                  Nota

                  -

                  Esta orden es el equivalente Symfony2 a la orden plugin:publish-assets de Symfony1.

                  -
                  -
                  -
                  -
                  -

                  Carga automática

                  -

                  Una de las ventajas de las plataformas modernas es nunca tener que preocuparte de requerir archivos manualmente. Al utilizar un cargador automático, puedes referirte a cualquier clase en tu proyecto y confiar en que esté disponible. La carga automática de clases ha cambiado en Symfony2 para ser más universal, más rápida e independiente de la necesidad de vaciar la caché.

                  -

                  En Symfony1, la carga automática de clases se llevó a cabo mediante la búsqueda en todo el proyecto de la presencia de archivos de clases PHP y el almacenamiento en caché de esa información en un arreglo gigante. -Ese arreglo decía a Symfony1 exactamente qué archivo contenía cada clase. En el entorno de producción, esto causó que necesitaras borrar la memoria caché cuando añadías o movías clases.

                  -

                  En Symfony2, una herramienta llamada Composer maneja este proceso. -La idea detrás del cargador automático es simple: el nombre de tu clase (incluyendo el espacio de nombres) debe coincidir con la ruta al archivo que contiene esa clase. -Tomemos como ejemplo el FrameworkExtraBundle de la edición estándar de Symfony2:

                  -
                  namespace Sensio\Bundle\FrameworkExtraBundle;
-
-    use Symfony\Component\HttpKernel\Bundle\Bundle;
-// ...
-
-class SensioFrameworkExtraBundle extends Bundle
-{
-    // ...
-}
-
                  -
                  -

                  El archivo en sí mismo vive en vendor/sensio/framework-extra-bundle/Sensio/Bundle/FrameworkExtraBundle/SensioFrameworkExtraBundle.php. -Como puedes ver, la ubicación del archivo sigue el espacio de nombres de la clase. -Específicamente, el espacio de nombres, Sensio\Bundle\FrameworkExtraBundle, explica el directorio en que el archivo debe vivir (vendor/sensio/framework-extra-bundle/Sensio/Bundle/FrameworkExtraBundle/). -Composer entonces puede buscar el archivo en ese sitio específico y cargarlo muy rápidamente.

                  -

                  Si el archivo no vive en ese lugar exacto, recibirás un error La clase "Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle" no existe. En Symfony2, una «clase no existe» significa que el espacio de nombres de la clase sospechosa y la ubicación física no coinciden. Básicamente, Symfony2 está buscando en una ubicación exacta dicha clase, pero ese lugar no existe (o contiene una clase diferente). Para que una clase se cargue automáticamente, en Symfony2 nunca necesitas vaciar la caché.

                  -

                  Como se mencionó anteriormente, para que trabaje el cargador automático, este necesita saber que el espacio de nombres Sensio vive en el directorio vendor/sensio y que, por ejemplo, el espacio de nombres Doctrine vive en el directorio vendor/doctrine/orm/lib/. Esta asociación es controlada enteramente por Composer. Cada biblioteca de terceros que cargues a través de composer tiene sus ajustes definidos y el Composer cuida de todo por ti.

                  -

                  Para que este trabaje, todas las bibliotecas de terceros utilizadas por tu proyecto se tienen que definir en el archivo composer.json.

                  -

                  Si nos fijamos en el HelloController de la edición estándar de Symfony2 puedes ver que este vive en el espacio de nombres AcmeDemoBundleController. Sin embargo, el AcmeDemoBundle no está definido en tu archivo composer.json. Empero, los archivos son cargados automáticamente. Esto es porque puedes decir a composer que cargue archivos automáticamente de directorios específicos sin definir una dependencia:

                  -
                  "autoload": {
-    "psr-0": { "": "src/" }
-}
-
                  -
                  -
                  -
                  -

                  Usando la consola

                  -

                  En Symfony1, la consola se encuentra en el directorio raíz de tu proyecto y se llama symfony:

                  -
                  $ php symfony
-
                  -
                  -

                  En Symfony2, la consola se encuentra ahora en el subdirectorio app/ y se llama console:

                  -
                  $ php app/console
-
                  -
                  -
                  -
                  -

                  Aplicaciones

                  -

                  En un proyecto Symfony1, es común tener varias aplicaciones: una para la interfaz de usuario y otra para la interfaz de administración, por ejemplo.

                  -

                  En un proyecto Symfony2, sólo tienes que crear una aplicación (una aplicación de blog, una aplicación de intranet, ...). La mayoría de las veces, si deseas crear una segunda aplicación, en su lugar podrías crear otro proyecto y compartir algunos paquetes entre ellos.

                  -

                  Y si tienes que separar la interfaz y las funciones de interfaz de administración de algunos paquetes, puedes crear subespacios de nombres para los controladores, subdirectorios de plantillas, diferentes configuraciones semánticas, configuración de enrutado separada, y así sucesivamente.

                  -

                  Por supuesto, no hay nada malo en tener varias aplicaciones en el proyecto, lo cual es una elección totalmente tuya. Una segunda aplicación significaría un nuevo directorio, por ejemplo, mi_app/, con la misma configuración básica que el directorio app/.

                  -
                  -

                  Truco

                  -

                  Lee la definición de un Proyecto, una Aplicación, y un Paquete en el glosario.

                  -
                  -
                  -
                  -

                  Paquetes y complementos

                  -

                  En un proyecto Symfony1, un complemento puede contener configuración, módulos, bibliotecas PHP, activos y cualquier otra cosa relacionada con tu proyecto. En Symfony2, la idea de un complemento es reemplazada por el «paquete». Un paquete es más poderoso aún que un complemento porque el núcleo de la plataforma Symfony2 consta de una serie de paquetes. En Symfony2, los paquetes son ciudadanos de primera clase y son tan flexibles que incluso el código del núcleo en sí es un paquete.

                  -

                  En Symfony1, un complemento se debe activar dentro de la clase ProjectConfiguration:

                  -
                  // config/ProjectConfiguration.class.php
-public function setup()
-{
-    // aquí algunos complementos
-    $this->enableAllPluginsExcept(array(...));
-}
-
                  -
                  -

                  En Symfony2, los paquetes se activan en el interior del núcleo de la aplicación:

                  -
                  // app/AppKernel.php
-public function registerBundles()
-{
-    $bundles = array(
-        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
-        new Symfony\Bundle\TwigBundle\TwigBundle(),
-        ...,
-        new Acme\DemoBundle\AcmeDemoBundle(),
-    );
-
-    return $bundles;
-}
-
                  -
                  -
                  -

                  Enrutando (routing.yml) y configurando (config.yml)

                  -

                  En Symfony1, los archivos de configuración routing.yml y app.yml cargan cualquier complemento automáticamente. En Symfony2, la configuración de enrutado y de la aplicación dentro de un paquete se debe incluir manualmente. Por ejemplo, para incluir un recurso de enrutado de un paquete llamado AcmeDemoBundle, puedes hacer lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # app/config/routing.yml
-_hello:
-    resource: "@AcmeDemoBundle/Resources/config/routing.yml"
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/routing.yml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <import resource="@AcmeDemoBundle/Resources/config/routing.xml" />
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/routing.php
-use Symfony\Component\Routing\RouteCollection;
-
-$collection = new RouteCollection();
-$collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  Esto cargará las rutas que se encuentren en el archivo Resources/config/routing.yml del AcmeDemoBundle. La sintaxis especial @AcmeDemoBundle es un atajo que, internamente, resuelve la ruta al directorio del paquete.

                  -

                  Puedes utilizar esta misma estrategia en la configuración de un paquete:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-imports:
-    - { resource: "@AcmeDemoBundle/Resources/config/config.yml" }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<imports>
-    <import resource="@AcmeDemoBundle/Resources/config/config.xml" />
-</imports>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$this->import('@AcmeDemoBundle/Resources/config/config.php')
-
                    -
                    -
                    • -
                  -
                  -

                  En Symfony2, la configuración es un poco como app.yml en Symfony1, salvo que mucho más sistemática. Con app.yml, simplemente puedes crear las claves que quieras. -Por omisión, estas entradas no tenían sentido y dependían completamente de cómo se utilizaban en tu aplicación:

                  -
                  # some app.yml file from symfony1
-all:
-  email:
-    from_address:  foo.bar@example.com
-
                  -
                  -

                  En Symfony2, también puedes crear entradas arbitrarias bajo la clave parameters de tu configuración:

                  -
                  -
                    -
                  • YAML
                    parameters:
-    email.from_address: foo.bar@example.com
-
                    -
                    -
                    • -
                  • XML
                    <parameters>
-    <parameter key="email.from_address">foo.bar@example.com</parameter>
-</parameters>
-
                    -
                    -
                    • -
                  • PHP
                    $container->setParameter('email.from_address', 'foo.bar@example.com');
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora puedes acceder a ella desde un controlador, por ejemplo:

                  -
                  public function helloAction($name)
-{
-    $fromAddress = $this->container->getParameter('email.from_address');
-}
-
                  -
                  -

                  En realidad, la configuración de Symfony2 es mucho más poderosa y se utiliza principalmente para configurar los objetos que puedes utilizar. Para más información, consulta el capítulo titulado «Contenedor de servicios».

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/templating/PHP.html b/cookbook/templating/PHP.html deleted file mode 100644 index d5d25aa..0000000 --- a/cookbook/templating/PHP.html +++ /dev/null @@ -1,355 +0,0 @@ - - - - - - - Cómo usar plantillas PHP en lugar de Twig — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo usar plantillas PHP en lugar de Twig

                  -

                  No obstante que Symfony2 de manera predeterminada usa Twig como su motor de plantillas, puedes usar código PHP simple si lo deseas. Ambos motores de plantilla son igualmente compatibles en Symfony2. Symfony2 añade algunas características interesantes en lo alto de PHP para hacer más poderosa la escritura de plantillas con PHP.

                  -
                  -

                  Reproduciendo plantillas PHP

                  -

                  Si deseas utilizar el motor de plantillas PHP, primero, asegúrate de activarlo en el archivo de configuración de tu aplicación:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-framework:
-    # ...
-    templating:    { engines: ['twig', 'php'] }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<framework:config ...>
-    <!-- ... -->
-    <framework:templating ...>
-        <framework:engine id="twig" />
-        <framework:engine id="php" />
-    </framework:templating>
-</framework:config>
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('framework', array(
-    // ...
-
-    'templating' => array(
-        'engines' => array('twig', 'php'),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora puedes reproducir una plantilla PHP en lugar de una Twig simplemente usando la extensión .php en el nombre de la plantilla en lugar de .twig. El controlador a continuación reproduce la plantilla index.html.php:

                  -
                  // src/Acme/HelloBundle/Controller/HelloController.php
-
-// ...
-
-public function indexAction($name)
-{
-    return $this->render('AcmeHelloBundle:Hello:index.html.php', array('name' => $name));
-}
-
                  -
                  -

                  También puedes utilizar el método abreviado @Template -para dibujar la plantilla predeterminada AcmeHelloBundle:Hello:index.html.php:

                  -
                  // src/Acme/HelloBundle/Controller/HelloController.php
-
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-
-// ...
-
-/**
- * @Template(engine="php")
- */
-public function indexAction($name)
-{
-    return array('name' => $name);
-}
-
                  -
                  -
                  -
                  -

                  Decorando plantillas

                  -

                  Muy a menudo, las plantillas en un proyecto comparten elementos comunes, como los bien conocidos encabezados y pies de página. En Symfony2, nos gusta pensar en este problema de forma diferente: una plantilla se puede decorar con otra.

                  -

                  La plantilla index.html.php está decorada por layout.html.php, gracias a la llamada a extend():

                  -
                  <!-- src/Acme/HelloBundle/Resources/views/Hello/index.html.php -->
-<?php $view->extend('AcmeHelloBundle::layout.html.php') ?>
-
-Hello <?php echo $name ?>!
-
                  -
                  -

                  La notación AcmeHelloBundle::layout.html.php ¿te suena familiar, no? Es la misma notación utilizada para referir una plantilla. La parte :: simplemente significa que el elemento controlador está vacío, por lo tanto el archivo correspondiente se almacena directamente bajo views/.

                  -

                  Ahora, echemos un vistazo al archivo layout.html.php:

                  -
                  <!-- src/Acme/HelloBundle/Resources/views/layout.html.php -->
-<?php $view->extend('::base.html.php') ?>
-
-<h1>Hello Application</h1>
-
-<?php $view['slots']->output('_content') ?>
-
                  -
                  -

                  El diseño en sí mismo está decorado por otra (::base.html.php). Symfony2 admite varios niveles de decoración: un diseño en sí se puede decorar con otro. Cuando la parte nombre del paquete de la plantilla está vacía, se buscan las vistas en el directorio app/Resources/views/. Este directorio almacena vistas globales de tu proyecto completo:

                  -
                  <!-- app/Resources/views/base.html.php -->
-<!DOCTYPE html>
-    <html>
-        <head>
-        <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-        <title><?php $view['slots']->output('title', 'Hello Application') ?></title>
-        </head>
-        <body>
-        <?php $view['slots']->output('_content') ?>
-    </body>
-</html>
-
                  -
                  -

                  Para ambos diseños, la expresión $view['slots']->output('_content') se sustituye por el contenido de la plantilla hija, index.html.php y layout.html.php, respectivamente (más de ranuras en la siguiente sección).

                  -

                  Como puedes ver, Symfony2 proporciona métodos en un misterioso objeto $view. En una plantilla, la variable $view siempre está disponible y se refiere a un objeto especial que proporciona una serie de métodos que hacen funcionar el motor de plantillas.

                  -
                  -
                  -

                  Trabajar con ranuras

                  -

                  Una ranura es un fragmento de código, definido en una plantilla, y reutilizable en cualquier diseño para decorar una plantilla. En la plantilla index.html.php, se define una ranura title:

                  -
                  <!-- src/Acme/HelloBundle/Resources/views/Hello/index.html.php -->
-<?php $view->extend('AcmeHelloBundle::layout.html.php') ?>
-
-<?php $view['slots']->set('title', 'Hello World Application') ?>
-
-Hello <?php echo $name ?>!
-
                  -
                  -

                  El diseño base ya tiene el código para reproducir el título en el encabezado:

                  -
                  <!-- app/Resources/views/base.html.php -->
-    <head>
-    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
-    <title><?php $view['slots']->output('title', 'Hello Application') ?></title>
-    </head>
-
                  -
                  -

                  El método output() inserta el contenido de una ranura y, opcionalmente, toma un valor predeterminado si la ranura no está definida. Y _content sólo es una ranura especial que contiene la plantilla hija reproducida.

                  -

                  Para ranuras grandes, también hay una sintaxis extendida:

                  -
                  <?php $view['slots']->start('title') ?>
-    Una gran cantidad de HTML
-<?php $view['slots']->stop() ?>
-
                  -
                  -
                  -
                  -

                  Incluyendo otras plantillas

                  -

                  La mejor manera de compartir un fragmento de código de plantilla es definir una plantilla que se pueda incluir en otras plantillas.

                  -

                  Crea una plantilla hello.html.php:

                  -
                  <!-- src/Acme/HelloBundle/Resources/views/Hello/hello.html.php -->
-Hello <?php echo $name ?>!
-
                  -
                  -

                  Y cambia la plantilla index.html.php para incluirla:

                  -
                  <!-- src/Acme/HelloBundle/Resources/views/Hello/index.html.php -->
-<?php $view->extend('AcmeHelloBundle::layout.html.php') ?>
-
-<?php echo $view->render('AcmeHelloBundle:Hello:hello.html.php', array('name' => $name)) ?>
-
                  -
                  -

                  El método render() evalúa y devuelve el contenido de otra plantilla (este exactamente es el mismo método que utilizamos en el controlador).

                  -
                  -
                  -

                  Integrando otros controladores

                  -

                  ¿Y si deseas incrustar el resultado de otro controlador en una plantilla? -Eso es muy útil cuando se trabaja con Ajax, o cuando la plantilla incrustada necesita alguna variable que no está disponible en la plantilla principal.

                  -

                  Si creas una acción fancy, y quieres incluirla en la plantilla index.html.php, basta con utilizar el siguiente código:

                  -
                  <!-- src/Acme/HelloBundle/Resources/views/Hello/index.html.php -->
-<?php echo $view['actions']->render('AcmeHelloBundle:Hello:fancy', array(
-    'name'  => $name,
-    'color' => 'green'
-)) ?>
-
                  -
                  -

                  Aquí, la cadena AcmeHelloBundle:Hello:fancy se refiere a la acción fancy del controlador -Hello:

                  -
                  // src/Acme/HelloBundle/Controller/HelloController.php
-
-class HelloController extends Controller
-{
-    public function fancyAction($name, $color)
-    {
-        // crea algún objeto, basándose en la variable $color
-        $object = ...;
-
-        return $this->render('AcmeHelloBundle:Hello:fancy.html.php', array(
-            'name'   => $name,
-            'object' => $object
-        ));
-    }
-
-    // ...
-}
-
                  -
                  -

                  Pero ¿dónde se define el elemento arreglo $view['actions'] de la vista? Al igual que ``$view['slots'], este invoca a un ayudante de plantilla, y la siguiente sección contiene más información sobre ellos.

                  -
                  -
                  -

                  Usando ayudantes de plantilla

                  -

                  El sistema de plantillas de Symfony2 se puede extender fácilmente por medio de los ayudantes. Los ayudantes son objetos PHP que ofrecen funciones útiles en el contexto de la plantilla. actions y slots son dos de los ayudantes integrados en Symfony2.

                  -
                  -

                  Creando enlaces entre páginas

                  -

                  Hablando de aplicaciones web, forzosamente tienes que crear enlaces entre páginas. En lugar de codificar las URL en las plantillas, el ayudante router sabe cómo generar URL basándose en la configuración de enrutado. De esta manera, todas tus URL se pueden actualizar fácilmente cambiando la configuración:

                  -
                  <a href="<?php echo $view['router']->generate('hello', array('name' => 'Thomas')) ?>">
-    Greet Thomas!
-    </a>
-
                  -
                  -

                  El método generate() toma el nombre de la ruta y un arreglo de parámetros como argumentos. El nombre de la ruta es la clave principal en la cual son referidas las rutas y los parámetros son los valores de los marcadores de posición definidos en el patrón de la ruta:

                  -
                  # src/Acme/HelloBundle/Resources/config/routing.yml
-hello: # El nombre de la ruta
-    path:  /hello/{name}
-    defaults: { _controller: AcmeHelloBundle:Hello:index }
-
                  -
                  -
                  -
                  -

                  Usando activos: imágenes, JavaScript y hojas de estilo

                  -

                  ¿Qué sería de Internet sin imágenes, JavaScript y hojas de estilo? -Symfony2 proporciona la etiqueta assets para hacer frente a los activos fácilmente:

                  -
                  <link href="<?php echo $view['assets']->getUrl('css/blog.css') ?>" rel="stylesheet" type="text/css" />
-
-<img src="<?php echo $view['assets']->getUrl('images/logo.png') ?>" />
-
                  -
                  -

                  El principal objetivo del ayudante assets es hacer más portátil tu aplicación. Gracias a este ayudante, puedes mover el directorio raíz de tu aplicación a cualquier lugar bajo tu directorio raíz del servidor web sin cambiar nada en el código de tu plantilla.

                  -
                  -
                  -
                  -

                  Mecanismo de escape

                  -

                  Al utilizar plantillas PHP, escapa las variables cada vez que se muestren al usuario:

                  -
                  <?php echo $view->escape($var) ?>
-
                  -
                  -

                  De forma predeterminada, el método escape() supone que la variable se emite dentro de un contexto HTML. El segundo argumento te permite cambiar el contexto. Por ejemplo, para mostrar algo en un archivo de JavaScript, utiliza el contexto js:

                  -
                  <?php echo $view->escape($var, 'js') ?>
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/templating/global_variables.html b/cookbook/templating/global_variables.html deleted file mode 100644 index 0a29ae8..0000000 --- a/cookbook/templating/global_variables.html +++ /dev/null @@ -1,205 +0,0 @@ - - - - - - - Cómo inyectar variables en todas las plantillas (es decir, Variables globales) — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo inyectar variables en todas las plantillas (es decir, Variables globales)

                  -

                  En ocasiones desearás que una variable sea accesible en todas las plantillas que usas. -Esto es posible en tu archivo app/config/config.yml:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-twig:
-    # ...
-    globals:
-        ga_tracking: UA-xxxxx-x
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<twig:config ...>
-    <!-- ... -->
-    <twig:global key="ga_tracking">UA-xxxxx-x</twig:global>
-</twig:config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('twig', array(
-     // ...
-     'globals' => array(
-         'ga_tracking' => 'UA-xxxxx-x',
-     ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, la variable ga_tracking está disponible en todas las plantillas Twig:

                  -
                  <p>The google tracking code is: {{ ga_tracking }}</p>
-
                  -
                  -

                  ¡Así de fácil! También puedes tomar ventaja de los Parámetros del servicio integrados en el sistema, lo cual te permite aislar o reutilizar el valor:

                  -
                  # app/config/parameters.yml
-parameters:
-    ga_tracking: UA-xxxxx-x
-
                  -
                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-twig:
-    globals:
-        ga_tracking: "%ga_tracking%"
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<twig:config ...>
-    <twig:global key="ga_tracking">%ga_tracking%</twig:global>
-</twig:config>
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('twig', array(
-     'globals' => array(
-         'ga_tracking' => '%ga_tracking%',
-     ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  La misma variable está disponible como antes.

                  -
                  -

                  Variables globales más complejas

                  -

                  Si la variable global que deseas establecer es más complicada —digamos, un objeto, por ejemplo— entonces no podrás utilizar el método anterior. En su lugar, tendrás que crear una Extensión de Twig y devolver la variable global como una de las entradas en el método getGlobals.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/templating/index.html b/cookbook/templating/index.html deleted file mode 100644 index ddbd455..0000000 --- a/cookbook/templating/index.html +++ /dev/null @@ -1,164 +0,0 @@ - - - - - - - Plantillas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/templating/namespaced_paths.html b/cookbook/templating/namespaced_paths.html deleted file mode 100644 index c3f7032..0000000 --- a/cookbook/templating/namespaced_paths.html +++ /dev/null @@ -1,195 +0,0 @@ - - - - - - - Cómo utilizar y rutas Twig con espacios de nombres — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar y rutas Twig con espacios de nombres

                  -

                  -Nuevo en la versión 2.2: El soporte para las rutas con espacios de nombres se añadió en 2.2.

                  -

                  Normalmente, cuándo te refieres a una plantilla, utilizas el formato MiBundle:Subdirectorio:nombrearchivo.html.twig (consulta Nomenclatura y ubicación de plantillas).

                  -

                  Además nativamente Twig ofrece una característica llamada «rutas con espacios de nombres», y el soporte se integra automáticamente en todos tus paquetes.

                  -

                  Toma como ejemplo las siguientes rutas:

                  -
                  {% extends "AcmeDemoBundle::layout.html.twig" %}
-{% include "AcmeDemoBundle:Foo:bar.html.twig" %}
-
                  -
                  -

                  Con rutas en espacios de nombres, las siguientes también trabajan:

                  -
                  {% extends "@AcmeDemo/layout.html.twig" %}
-{% include "@AcmeDemo/Foo/bar.html.twig" %}
-
                  -
                  -

                  Ambas rutas de manera predeterminada son válidas y operacionales en Symfony2.

                  -
                  -

                  Truco

                  -

                  Como bono adicional, la sintaxis del espacio de nombres es más rápida.

                  -
                  -
                  -

                  Registrando tus propios espacios de nombres

                  -

                  También puedes registrar tus propios espacios de nombres. Supón que estás utilizando alguna biblioteca de terceros que incluye plantillas Twig que viven en acme/vendor/foo-project/templates. Primero, registra un espacio de nombres para ese directorio:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-twig:
-    # ...
-    paths:
-        "%kernel.root_dir%/../vendor/acme/foo-bar/templates": foo_bar
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<?xml version="1.0" ?>
-<container xmlns="http://symfony.com/schema/dic/services"
-           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-           xmlns:twig="http://symfony.com/schema/dic/twig"
->
-
-    <twig:config debug="%kernel.debug%" strict-variables="%kernel.debug%">
-        <twig:path namespace="foo_bar">%kernel.root_dir%/../vendor/acme/foo-bar/templates</twig:path>
-    </twig:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('twig', array(
-    'paths' => array(
-        '%kernel.root_dir%/../vendor/acme/foo-bar/templates' => 'foo_bar',
-    );
-));
-
                    -
                    -
                    • -
                  -
                  -

                  El espacio de nombres registrado se llama foo_bar, el cual se refiere al directorio acme/vendor/foo-project/templates. Suponiendo que en ese directorio existe un archivo llamado sidebar.twig, lo puedes utilizar fácilmente:

                  -
                  {% include '@foo_bar/side.bar.twig` %}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/templating/render_without_controller.html b/cookbook/templating/render_without_controller.html deleted file mode 100644 index 93d48a9..0000000 --- a/cookbook/templating/render_without_controller.html +++ /dev/null @@ -1,244 +0,0 @@ - - - - - - - Cómo dibujar una plantilla sin un controlador personalizado — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo dibujar una plantilla sin un controlador personalizado

                  -

                  Normalmente, cuándo necesitas crear una página, necesitas crear un controlador y dibujar una plantilla dentro del controlador. Pero si estás reproduciendo una plantilla sencilla a la que no necesitas pasar ningún dato, puedes evitar la creación del controlador por completo, utilizando el controlador integrado FrameworkBundle:Template:template.

                  -

                  Por ejemplo, supón que deseas reproducir la plantilla AcmeBundle:Static:privacy.html.twig, la cual no requiere que se le pasen variables. Lo puedes hacer sin crear un controlador:

                  -
                  -
                    -
                  • YAML
                    acme_privacy:
-    path: /privacy
-    defaults:
-        _controller: FrameworkBundle:Template:template
-        template: 'AcmeBundle:Static:privacy.html.twig'
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="acme_privacy" path="/privacy">
-        <default key="_controller">FrameworkBundle:Template:template</default>
-        <default key="template">AcmeBundle:Static:privacy.html.twig</default>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('acme_privacy', new Route('/privacy', array(
-    '_controller'  => 'FrameworkBundle:Template:template',
-    'template'     => 'AcmeBundle:Static:privacy.html.twig',
-)));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  El controlador FrameworkBundle:Template:template sencillamente dibujará cualquier plantilla que le pases como el valor predeterminado de template.

                  -

                  Naturalmente, también puedes utilizar este truco al reproducir controladores integrados dentro de una plantilla. Pero debido a que típicamente el propósito de reproducir un controlador dentro de una plantilla es para preparar algún dato en un controlador personalizado, probablemente esto sólo sea útil si quisieras memorizar esta página parcial (ve Memorizando en caché una plantilla estática).

                  -
                  -
                    -
                  • Twig
                    {{ render(url('acme_privacy')) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['actions']->render(
-    $view['router']->generate('acme_privacy', array(), true)
-) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Memorizando en caché una plantilla estática

                  -

                  -Nuevo en la versión 2.2: La habilidad de memorizar plantillas dibujadas vía FrameworkBundle:Template:template es nueva en Symfony 2.2.

                  -

                  Debido a que las plantillas que se dibujan de este modo típicamente son estáticas, posiblemente tenga sentido memorizarlas en caché. Afortunadamente, ¡esto es muy fácil! Configurando unas cuantas variables en tu ruta, puedes controlar exactamente cómo memorizar tu página:

                  -
                  -
                    -
                  • YAML
                    acme_privacy:
-    path: /privacy
-    defaults:
-        _controller: FrameworkBundle:Template:template
-        template: 'AcmeBundle:Static:privacy.html.twig'
-        maxAge: 86400
-        sharedMaxAge: 86400
-
                    -
                    -
                    • -
                  • XML
                    <?xml version="1.0" encoding="UTF-8" ?>
-
-<routes xmlns="http://symfony.com/schema/routing"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/routing http://symfony.com/schema/routing/routing-1.0.xsd">
-
-    <route id="acme_privacy" path="/privacy">
-        <default key="_controller">FrameworkBundle:Template:template</default>
-        <default key="template">AcmeBundle:Static:privacy.html.twig</default>
-        <default key="maxAge">86400</default>
-        <default key="sharedMaxAge">86400</default>
-    </route>
-</routes>
-
                    -
                    -
                    • -
                  • PHP
                    use Symfony\Component\Routing\RouteCollection;
-use Symfony\Component\Routing\Route;
-
-$collection = new RouteCollection();
-$collection->add('acme_privacy', new Route('/privacy', array(
-    '_controller'  => 'FrameworkBundle:Template:template',
-    'template'     => 'AcmeBundle:Static:privacy.html.twig',
-    'maxAge'       => 86400,
-    'sharedMaxAge' => 86400,
-)));
-
-return $collection;
-
                    -
                    -
                    • -
                  -
                  -

                  Los valores maxAge y sharedMaxAge se suelen usar para modificar el objeto Respuesta creado en el controlador. Para más información sobre la memorización, ve la Caché HTTP.

                  -

                  También existe una variable privada (no mostrada aquí). De manera predeterminada, la Respuesta será pública, siempre y cuando se le pase maxAge o sharedMaxAge. -Si se configura como true, la Respuesta será marcada como privada.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/templating/twig_extension.html b/cookbook/templating/twig_extension.html deleted file mode 100644 index 4721a69..0000000 --- a/cookbook/templating/twig_extension.html +++ /dev/null @@ -1,242 +0,0 @@ - - - - - - - Cómo escribir una extensión Twig personalizada — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo escribir una extensión Twig personalizada

                  -

                  La principal motivación para escribir una extensión es mover el código usado frecuentemente a una clase reutilizable como agregar apoyo para la internacionalización. -Una extensión puede definir etiquetas, filtros, pruebas, operadores, variables globales, funciones y visitantes de nodo.

                  -

                  La creación de una extensión también hace una mejor separación del código que se ejecuta en tiempo de compilación y el código necesario en tiempo de ejecución. Por lo tanto, hace que tu código sea más rápido.

                  -
                  -

                  Truco

                  -

                  Before writing your own extensions, have a look at the -`Twig official extension repository`_.

                  -
                  -
                  -

                  Creando la clase de la extensión

                  -
                  -

                  Nota

                  -

                  This cookbook describes how to write a custom Twig extension as of -Twig 1.12. If you are using an older version, please read -Twig extensions documentation legacy.

                  -
                  -

                  Para obtener la funcionalidad personalizada primero debes crear la clase para la extensión Twig. -Como ejemplo vas a crear un filtro para dar formato a un precio suministrando un número en el precio:

                  -
                  // src/Acme/DemoBundle/Twig/AcmeExtension.php
-namespace Acme\DemoBundle\Twig;
-
-class AcmeExtension extends \Twig_Extension
-{
-    public function getFilters()
-    {
-        return array(
-            new \Twig_SimpleFilter('price', array($this, 'priceFilter')),
-        );
-    }
-
-    public function priceFilter($number, $decimals = 0, $decPoint = '.', $thousandsSep = ',')
-    {
-        $price = number_format($number, $decimals, $decPoint, $thousandsSep);
-        $price = '$'.$price;
-
-        return $price;
-    }
-
-    public function getName()
-    {
-        return 'acme_extension';
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Along with custom filters, you can also add custom functions and register -global variables.

                  -
                  -
                  -
                  -

                  Registrando una extensión como servicio

                  -

                  Now you must let the Service Container know about your newly created Twig Extension:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/DemoBundle/Resources/config/services.yml
-services:
-    acme.twig.acme_extension:
-        class: Acme\DemoBundle\Twig\AcmeExtension
-        tags:
-                - { name: twig.extension }
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/DemoBundle/Resources/config/services.xml -->
-    <services>
-    <service id="acme.twig.acme_extension" class="Acme\DemoBundle\Twig\AcmeExtension">
-        <tag name="twig.extension" />
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/DemoBundle/Resources/config/services.php
-use Symfony\Component\DependencyInjection\Definition;
-
-$container
-    ->register('acme.twig.acme_extension', '\Acme\DemoBundle\Twig\AcmeExtension')
-    ->addTag('twig.extension');
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Ten en cuenta que las extensiones Twig no se cargan de manera diferida. Esto significa que hay una mayor probabilidad de que obtengas una CircularReferenceException o ScopeWideningInjectionException si cualquier servicio (o tu extensión Twig —en este caso—) es dependiente del servicio Petición. -Para obtener más información, échale un vistazo a Cómo trabajar con ámbitos.

                  -
                  -
                  -
                  -

                  Usando la extensión personalizada

                  -

                  Usar tu recién creada extensión de Twig no es diferente a cualquier otra:

                  -
                  {# produce $5,500.00 #}
-{{ '5500'|price }}
-
                  -
                  -

                  Pasando otros argumentos a tu filtro:

                  -
                  {# outputs $5500,2516 #}
-{{ '5500.25155'|price(4, ',', '') }}
-
                  -
                  -
                  -
                  -

                  Aprendiendo más

                  -

                  For a more in-depth look into Twig Extensions, please take a look at the -`Twig extensions documentation`_.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/testing/bootstrap.html b/cookbook/testing/bootstrap.html deleted file mode 100644 index 97c9c9e..0000000 --- a/cookbook/testing/bootstrap.html +++ /dev/null @@ -1,166 +0,0 @@ - - - - - - - Cómo personalizar el proceso de arranque antes de correr las pruebas — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo personalizar el proceso de arranque antes de correr las pruebas

                  -

                  A veces, al correr pruebas, necesitas hacer trabajo adicional en el proceso de arranque antes de correr esas pruebas. Por ejemplo, si estás corriendo una prueba funcional y has -introducido un nuevo recurso de traducción, entonces necesitarás vaciar tu -cache antes de correr esas pruebas. Esta receta abarca cómo hacerlo.

                  -

                  Primero, añade el siguiente archivo:

                  -
                  // app/tests.bootstrap.php
-if (isset($_ENV['BOOTSTRAP_CLEAR_CACHE_ENV'])) {
-    passthru(sprintf(
-        'php "%s/console" cache:clear --env=%s --no-warmup',
-        __DIR__,
-        $_ENV['BOOTSTRAP_CLEAR_CACHE_ENV']
-    ));
-}
-
-require __DIR__.'/bootstrap.php.cache';
-
                  -
                  -

                  Reemplaza la prueba del archivo de arranque bootstrap.php.cache en aplication/phpunit.xml.dist con pruebas.bootstrap.php:

                  -
                  <!-- app/phpunit.xml.dist -->
-
-<!-- ... -->
-<phpunit
-    ...
-    bootstrap = "tests.bootstrap.php"
->
                  -
                  -

                  Ahora, puedes definir en tu archivo phpunit.xml.dist qué entorno de la caché quieres vaciar:

                  -
                  <!-- app/phpunit.xml.dist -->
-<php>
-    <env name="BOOTSTRAP_CLEAR_CACHE_ENV" value="test"/>
-</php>
-
                  -
                  -

                  Esto ahora se vuelve una variable de entorno (es decir, $_ENV) que está disponible en el archivo bootstrap (tests.bootstrap.php).

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/testing/doctrine.html b/cookbook/testing/doctrine.html deleted file mode 100644 index 02a2423..0000000 --- a/cookbook/testing/doctrine.html +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - Cómo probar repositorios Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo probar repositorios Doctrine

                  -

                  Correr pruebas unitarias en repositorios Doctrine de un proyecto Symfony no es recomendable. -Cuando estás tratando con un repositorio, en realidad estás tratando con algo -que está destinado a ser probado contra una conexión de base de datos real.

                  -

                  Afortunadamente, fácilmente puedes probar tus consultas contra una base de datos real, como se describe a continuación.

                  -
                  -

                  Probando la funcionalidad

                  -

                  Si realmente necesitas ejecutar una consulta, tendrás que arrancar el núcleo para conseguir una conexión válida. En este caso, debes extender a WebTestCase, el cual hace todo esto muy fácil:

                  -
                  // src/Acme/StoreBundle/Tests/Entity/ProductRepositoryFunctionalTest.php
-namespace Acme\StoreBundle\Tests\Entity;
-
-use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-
-class ProductRepositoryFunctionalTest extends WebTestCase
-{
-    /**
-     * @var \Doctrine\ORM\EntityManager
-     */
-    private $em;
-
-    /**
-     * {@inheritDoc}
-     */
-    public function setUp()
-    {
-        static::$kernel = static::createKernel();
-        static::$kernel->boot();
-        $this->em = static::$kernel->getContainer()
-            ->get('doctrine')
-            ->getManager()
-        ;
-    }
-
-    public function testSearchByCategoryName()
-    {
-        $products = $this->em
-            ->getRepository('AcmeStoreBundle:Product')
-            ->searchByCategoryName('foo')
-        ;
-
-        $this->assertCount(1, $products);
-    }
-
-    /**
-     * {@inheritDoc}
-     */
-    protected function tearDown()
-    {
-        parent::tearDown();
-        $this->em->close();
-    }
-}
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/testing/http_authentication.html b/cookbook/testing/http_authentication.html deleted file mode 100644 index e513b06..0000000 --- a/cookbook/testing/http_authentication.html +++ /dev/null @@ -1,180 +0,0 @@ - - - - - - - Cómo simular autenticación HTTP en una prueba funcional — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo simular autenticación HTTP en una prueba funcional

                  -

                  Si tu aplicación necesita autenticación HTTP, pasa el nombre de usuario y contraseña como variables del servidor a createClient():

                  -
                  $client = static::createClient(array(), array(
-    'PHP_AUTH_USER' => 'username',
-    'PHP_AUTH_PW'   => 'pa$$word',
-));
-
                  -
                  -

                  También lo puedes sustituir basándote en la Petición:

                  -
                  $client->request('DELETE', '/post/12', array(), array(), array(
-    'PHP_AUTH_USER' => 'username',
-    'PHP_AUTH_PW'   => 'pa$$word',
-));
-
                  -
                  -

                  Cuando tu aplicación está utilizando un form_login, puedes simplificar las pruebas, permitiendo a la configuración de tus pruebas usar la autenticación HTTP. De esta manera puedes utilizar lo anterior para autenticar en las pruebas, pero todavía tienes tu inicio de sesión para los usuarios a través del form_login normal. El truco consiste en incluir la clave http_basic en tu cortafuegos, junto con la clave form_login:

                  -
                  -
                    -
                  • YAML
                    # app/config/config_test.yml
-security:
-    firewalls:
-        your_firewall_name:
-            http_basic:
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config_test.xml -->
-<security:config>
-    <security:firewall name="your_firewall_name">
-      <security:http-basic />
-   </security:firewall>
-</security:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config_test.php
-$container->loadFromExtension('security', array(
-    'firewalls' => array(
-        'your_firewall_name' => array(
-            'http_basic' => array(),
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/testing/index.html b/cookbook/testing/index.html deleted file mode 100644 index 8505d96..0000000 --- a/cookbook/testing/index.html +++ /dev/null @@ -1,144 +0,0 @@ - - - - - - - Probando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/testing/insulating_clients.html b/cookbook/testing/insulating_clients.html deleted file mode 100644 index e6f6c32..0000000 --- a/cookbook/testing/insulating_clients.html +++ /dev/null @@ -1,163 +0,0 @@ - - - - - - - Cómo probar la interacción de varios clientes — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo probar la interacción de varios clientes

                  -

                  Si necesitas simular la interacción entre diferentes clientes (piensa en un chat, por ejemplo), crea varios clientes:

                  -
                  $harry = static::createClient();
-$sally = static::createClient();
-
-$harry->request('POST', '/say/sally/Hello');
-$sally->request('GET', '/messages');
-
-$this->assertEquals(201, $harry->getResponse()->getStatusCode());
-$this->assertRegExp('/Hello/', $sally->getResponse()->getContent());
-
                  -
                  -

                  Esto funciona, excepto cuando el código mantiene un estado global o si depende de bibliotecas de terceros que tienen algún tipo de estado global. En tal caso, puedes aislar a tus clientes:

                  -
                  $harry = static::createClient();
-$sally = static::createClient();
-
-$harry->insulate();
-$sally->insulate();
-
-$harry->request('POST', '/say/sally/Hello');
-$sally->request('GET', '/messages');
-
-$this->assertEquals(201, $harry->getResponse()->getStatusCode());
-$this->assertRegExp('/Hello/', $sally->getResponse()->getContent());
-
                  -
                  -

                  Los clientes con aislamiento transparente ejecutan sus peticiones en un proceso PHP específico y limpio, evitando así efectos secundarios.

                  -
                  -

                  Truco

                  -

                  Como un cliente con aislamiento es más lento, puedes mantener a un cliente en el proceso principal, y aislar a los demás.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/testing/profiling.html b/cookbook/testing/profiling.html deleted file mode 100644 index 9858ccc..0000000 --- a/cookbook/testing/profiling.html +++ /dev/null @@ -1,187 +0,0 @@ - - - - - - - Cómo utilizar el generador de perfiles en una prueba funcional — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo utilizar el generador de perfiles en una prueba funcional

                  -

                  Es altamente recomendable que una prueba funcional sólo pruebe la respuesta. Pero si escribes pruebas funcionales que controlan los servidores en producción, posiblemente desees escribir pruebas en los datos del generador de perfiles, ya que te da una gran manera de ver diferentes cosas y hacer cumplir algunas métricas.

                  -

                  El Generador de perfiles de Symfony2 reúne una gran cantidad de datos por cada petición. Utiliza estos datos para comprobar el número de llamadas a la base de datos, el tiempo invertido en la plataforma, ... Pero antes de escribir aserciones, habilita el perfilador y verifica que esté habilitado (de manera predeterminada está activado en el entorno test):

                  -
                  class HelloControllerTest extends WebTestCase
-{
-    public function testIndex()
-    {
-        $client = static::createClient();
-
-        // Habilita el perfilador para la próxima petición
-        // (no hace nada si el perfilador no está disponible)
-        $cliente->enableProfiler();
-
-        $crawler = $client->request('GET', '/hello/Fabien');
-
-        // ... Escribe algunas aserciones sobre Response
-
-        // verifica que el generador de perfiles esté habilitado
-        if ($profile = $client->getProfile()) {
-            // verifica la cantidad de peticiones
-            $this->assertLessThan(
-                10,
-                $profile->getCollector('db')->getQueryCount()
-            );
-
-            // comprueba el tiempo consumido en la plataforma
-            $this->assertLessThan(
-                500,
-                $profile->getCollector('time')->getTotalTime()
-            );
-        }
-    }
-}
-
                  -
                  -

                  Si una prueba falla debido a los datos del generador de perfiles (demasiadas consultas a la BD, por ejemplo), posiblemente desees utilizar el Generador de perfiles Web para analizar la petición después de terminar las pruebas. Es fácil conseguirlo si incorporas el símbolo en el mensaje de error:

                  -
                  $this->assertLessThan(
-    30,
-    $profile->get('db')->getQueryCount(),
-    sprintf('Checks that query count is less than 30 (token %s)', $profile->getToken())
-);
-
                  -
                  -
                  -

                  Prudencia

                  -

                  El almacén del generador de perfiles puede ser diferente en función del entorno (sobre todo si utilizas el almacén de datos SQLite, el cual es el valor configurado por omisión).

                  -
                  -
                  -

                  Nota

                  -

                  La información del generador de perfiles está disponible incluso si aíslas al cliente o si utilizas una capa HTTP para tus pruebas.

                  -
                  -
                  -

                  Truco

                  -

                  Lee la API para incorporar colectores de datos para aprender más acerca de sus interfaces.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/testing/simulating_authentication.html b/cookbook/testing/simulating_authentication.html deleted file mode 100644 index cf0e943..0000000 --- a/cookbook/testing/simulating_authentication.html +++ /dev/null @@ -1,188 +0,0 @@ - - - - - - - How to simulate Authentication with a Token in a Functional Test — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  How to simulate Authentication with a Token in a Functional Test

                  -

                  Authenticating requests in functional tests might slow down the suite. -It could become an issue especially when form_login is used, since -it requires additional requests to fill in and submit the form.

                  -

                  One of the solutions is to configure your firewall to use http_basic in -the test environment as explained in -Cómo simular autenticación HTTP en una prueba funcional. -Another way would be to create a token yourself and store it in a session. -While doing this, you have to make sure that appropriate cookie is sent -with a request. The following example demonstrates this technique:

                  -
                  // src/Acme/DemoBundle/Tests/Controller/DemoControllerTest.php
-namespace Acme\DemoBundle\Tests\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Test\WebTestCase;
-use Symfony\Component\BrowserKit\Cookie;
-use Symfony\Component\Security\Core\Authentication\Token\UsernamePasswordToken;
-
-class DemoControllerTest extends WebTestCase
-{
-    private $client = null;
-
-    public function setUp()
-    {
-        $this->client = static::createClient();
-    }
-
-    public function testSecuredHello()
-    {
-        $this->logIn();
-
-        $this->client->request('GET', '/demo/secured/hello/Fabien');
-
-        $this->assertTrue($this->client->getResponse()->isSuccessful());
-        $this->assertGreaterThan(0, $crawler->filter('html:contains("Hello Fabien")')->count());
-    }
-
-    private function logIn()
-    {
-        $session = $this->client->getContainer()->get('session');
-
-        $firewall = 'secured_area';
-        $token = new UsernamePasswordToken('admin', null, $firewall, array('ROLE_ADMIN'));
-        $session->set('_security_'.$firewall, serialize($token));
-        $session->save();
-
-        $cookie = new Cookie($session->getName(), $session->getId());
-        $this->client->getCookieJar()->set($cookie);
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  The technique described in Cómo simular autenticación HTTP en una prueba funcional. -is cleaner and therefore preferred way.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/validation/custom_constraint.html b/cookbook/validation/custom_constraint.html deleted file mode 100644 index 7718656..0000000 --- a/cookbook/validation/custom_constraint.html +++ /dev/null @@ -1,352 +0,0 @@ - - - - - - - Cómo crear una restricción de validación personalizada — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear una restricción de validación personalizada

                  -

                  Puedes crear una restricción personalizada extendiendo la clase base «constraint», Symfony\Component\Validator\Constraint. -A modo de ejemplo vas a crear un sencillo validador que compruebe si una cadena únicamente contiene caracteres alfanuméricos.

                  -
                  -

                  Creando la clase de la restricción

                  -

                  En primer lugar necesitas crear una clase para la restricción que extienda de Symfony\Component\Validator\Constraint:

                  -
                  // src/Acme/DemoBundle/Validator/Constraints/ContainsAlphanumeric.php
-namespace Acme\DemoBundle\Validator\Constraints;
-
-use Symfony\Component\Validator\Constraint;
-
-/**
- * @Annotation
- */
-class ContainsAlphanumeric extends Constraint
-{
-    public $message = 'The string "%string%" contains an illegal character: it can only contain letters or numbers.';
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  La anotación @Annotation es necesaria para esta nueva restricción con el fin de hacerla disponible para su uso en clases vía anotaciones. -Las opciones para tu restricción se representan como propiedades públicas en la clase constraint.

                  -
                  -
                  -
                  -

                  Creando el validador directamente

                  -

                  Como puedes ver, una clase de restricción es bastante mínima. La validación real la lleva a cabo otra clase «validadora de restricción». La clase validadora de restricción se configura con el método validatedBy() de la restricción, el cual por omisión incluye alguna sencilla lógica:

                  -
                  // en la clase base Symfony\Component\Validator\Constraint
-public function validatedBy()
-{
-    return get_class($this).'Validator';
-}
-
                  -
                  -

                  En otras palabras, si creas una restricción personalizada (por ejemplo, MyConstraint), cuando Symfony2 realmente lleve a cabo la validación automáticamente buscará otra clase, MyConstraintValidator.

                  -

                  La clase validator también es simple, y sólo tiene un método obligatorio: validate:

                  -
                  // src/Acme/DemoBundle/Validator/Constraints/ContainsAlphanumericValidator.php
-namespace Acme\DemoBundle\Validator\Constraints;
-
-use Symfony\Component\Validator\Constraint;
-use Symfony\Component\Validator\ConstraintValidator;
-
-class ContainsAlphanumericValidator extends ConstraintValidator
-{
-    public function validate($value, Constraint $constraint)
-    {
-        if (!preg_match('/^[a-zA-Za0-9]+$/', $value, $matches)) {
-            $this->context->addViolation($constraint->message, array('%string%' => $value));
-        }
-    }
-}
-
                  -
                  -
                  -

                  Nota

                  -

                  El método validate no devuelve un valor; en cambio, añade violaciones al validador de la propiedad context con una llamada al método addViolation si hay errores de validación. Por lo tanto, un valor se podría considerar como válido si no provoca que se añadan violaciones al contexto. -El primer parámetro de la llamada a addViolation es el mensaje de error a utilizar para esa violación.

                  -
                  -
                  -
                  -

                  Usando el nuevo Validador

                  -

                  Usar validadores personalizados es muy fácil, así como los proporcionados por el mismo Symfony2:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\DemoBundle\Entity\AcmeEntity:
-    properties:
-        name:
-            - NotBlank: ~
-            - Acme\DemoBundle\Validator\Constraints\ContainsAlphanumeric: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/DemoBundle/Entity/AcmeEntity.php
-use Symfony\Component\Validator\Constraints as Assert;
-use Acme\DemoBundle\Validator\Constraints as AcmeAssert;
-
-class AcmeEntity
-{
-    // ...
-
-    /**
-     * @Assert\NotBlank
-     * @AcmeAssert\ContainsAlphanumeric
-     */
-    protected $name;
-
-    // ...
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/DemoBundle/Resources/config/validation.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-    <class name="Acme\DemoBundle\Entity\AcmeEntity">
-        <property name="name">
-            <constraint name="NotBlank" />
-            <constraint name="Acme\DemoBundle\Validator\Constraints\ContainsAlphanumeric" />
-        </property>
-    </class>
-</constraint-mapping>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/DemoBundle/Entity/AcmeEntity.php
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\NotBlank;
-use Acme\DemoBundle\Validator\Constraints\ContainsAlphanumeric;
-
-class AcmeEntity
-{
-    public $name;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('name', new NotBlank());
-        $metadata->addPropertyConstraint('name', new ContainsAlphanumeric());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Si tu restricción contiene opciones, entonces deberían ser propiedades públicas en la clase de la restricción personalizada que creaste anteriormente. Estas opciones se pueden configurar como opciones en las restricciones del núcleo de Symfony.

                  -
                  -

                  Validadores de restricción con dependencias

                  -

                  Si el validador de la restricción tiene dependencias, tal como una conexión a base de datos, la tendrás que configurar como un servicio en el contenedor de inyección de dependencias. Este servicio debe incluir la etiqueta validator.constraint_validator y un atributo alias:

                  -
                  -
                    -
                  • YAML
                    services:
-    validator.unique.your_validator_name:
-        class: Nombre\De\Clase\Validator\Completamente\Cualificado
-        tags:
-                - { name: validator.constraint_validator, alias: alias_name }
-
                    -
                    -
                    • -
                  • XML
                    <service id="validator.unique.your_validator_name" class="Nombre\De\Clase\Validator\Completamente\Cualificado">
-    <argument type="service" id="doctrine.orm.default_entity_manager" />
-    <tag name="validator.constraint_validator" alias="alias_name" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('validator.unique.your_validator_name', 'Fully\Qualified\Validator\Class\Name')
-    ->addTag('validator.constraint_validator', array('alias' => 'alias_name'));
-
                    -
                    -
                    • -
                  -
                  -

                  Tu clase restricción ahora debe usar este alias para hacer referencia al validador adecuado:

                  -
                  public function validatedBy()
-{
-    return 'alias_name';
-}
-
                  -
                  -

                  Como mencionamos anteriormente, Symfony2 automáticamente buscará una clase llamada después de la restricción, con su Validador adjunto. Si tu restricción de validación está definida como un servicio, es importante que redefinas el método validatedBy() para que devuelva el alias utilizado cuando definiste tu servicio, de lo contrario Symfony2 no utilizará el servicio de la restricción de validación, y, en su lugar, creará una instancia de la clase, sin inyectar ningún tipo de dependencia.

                  -
                  -
                  -

                  Clase para la validación de restricción

                  -

                  Además de validar una propiedad de clase, una restricción puede tener un ámbito de clase proporcionándole un objetivo:

                  -
                  public function getTargets()
-{
-    return self::CLASS_CONSTRAINT;
-}
-
                  -
                  -

                  Con esto, el método validador validate() obtiene un objeto como primer argumento:

                  -
                  class ProtocolClassValidator extends ConstraintValidator
-{
-    public function validate($protocol, Constraint $constraint)
-    {
-        if ($protocol->getFoo() != $protocol->getBar()) {
-            $this->context->addViolationAt('foo', $constraint->message, array(), null);
-        }
-    }
-}
-
                  -
                  -

                  Ten en cuenta que una clase validadora de restricciones se aplica a la misma clase, y no a la propiedad:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\DemoBundle\Entity\AcmeEntity:
-    constraints:
-        Acme\DemoBundle\Validator\Constraints\ContainsAlphanumeric: ~
-
                    -
                    -
                    • -
                  • Annotations
                    /**
- * @AcmeAssert\ContainsAlphanumeric
- */
-class AcmeEntity
-{
-    // ...
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\DemoBundle\Entity\AcmeEntity">
-    <constraint name="Acme\DemoBundle\Validator\Constraints\ContainsAlphanumeric" />
-</class>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/validation/index.html b/cookbook/validation/index.html deleted file mode 100644 index 7c0fe4d..0000000 --- a/cookbook/validation/index.html +++ /dev/null @@ -1,141 +0,0 @@ - - - - - - - Validando — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/web_services/index.html b/cookbook/web_services/index.html deleted file mode 100644 index 418e584..0000000 --- a/cookbook/web_services/index.html +++ /dev/null @@ -1,136 +0,0 @@ - - - - - - - Servicios web — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/web_services/php_soap_extension.html b/cookbook/web_services/php_soap_extension.html deleted file mode 100644 index a113092..0000000 --- a/cookbook/web_services/php_soap_extension.html +++ /dev/null @@ -1,292 +0,0 @@ - - - - - - - Cómo crear un servicio Web SOAP en un controlador de Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear un servicio Web SOAP en un controlador de Symfony2

                  -

                  Configurar un controlador para que actúe como un servidor SOAP es muy sencillo con un par de herramientas. Debes, por supuesto, tener instalada la extensión SOAP de PHP. -Debido a que la extensión SOAP de PHP, actualmente no puede generar un WSDL, debes crear uno desde cero o utilizar un generador de un tercero.

                  -
                  -

                  Nota

                  -

                  Hay disponibles varias implementaciones del servidor SOAP para usarlas con PHP. Zend SOAP y NuSOAP son dos ejemplos. A pesar de que usamos la extensión SOAP de PHP en estos ejemplos, la idea general debería seguir siendo aplicable a otras implementaciones.

                  -
                  -

                  SOAP trabaja explotando los métodos de un objeto PHP a una entidad externa (es decir, la persona que utiliza el servicio SOAP). Para empezar, crea una clase —HelloService— que representa la funcionalidad que vas a exponer en tu servicio SOAP. -En este caso, el servicio SOAP debe permitir al cliente invocar a un método llamado hello, el cual sucede que envía un correo electrónico:

                  -
                  // src/Acme/SoapBundle/Services/HelloService.php
-namespace Acme\SoapBundle\Services;
-
-class HelloService
-{
-    private $mailer;
-
-    public function __construct(\Swift_Mailer $mailer)
-    {
-        $this->mailer = $mailer;
-    }
-
-    public function hello($name)
-    {
-
-        $message = \Swift_Message::newInstance()
-                                ->setTo('me@example.com')
-                                ->setSubject('Hello Service')
-                                ->setBody($name . ' says hi!');
-
-        $this->cartero->send($mensaje);
-
-
-        return 'Hello, '.$name;
-    }
-}
-
                  -
                  -

                  A continuación, puedes entrenar a Symfony para que sea capaz de crear una instancia de esta clase. -Puesto que la clase envía un correo electrónico, se ha diseñado para aceptar una instancia de Swift_Mailer. Usando el contenedor de servicios, puedes configurar a Symfony para construir correctamente un objeto HelloService:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-services:
-    hello_service:
-        class: Acme\SoapBundle\Services\HelloService
-        arguments: ["@mailer"]
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-    <services>
-    <service id="hello_service" class="Acme\SoapBundle\Services\HelloService">
-        <argument type="service" id="mailer"/>
-    </service>
-    </services>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container
-    ->register('hello_service', 'Acme\SoapBundle\Services\HelloService')
-    ->addArgument(new Reference('mailer'));
-
                    -
                    -
                    • -
                  -
                  -

                  A continuación hay un ejemplo de un controlador que es capaz de manejar una petición SOAP. Si indexAction() es accesible a través de la ruta /soap, entonces puedes recuperar el documento WSDL a través de /soap?wsdl.

                  -
                  namespace Acme\SoapBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-use Symfony\Component\HttpFoundation\Response;
-
-class HelloServiceController extends Controller
-{
-    public function indexAction()
-    {
-        $server = new \SoapServer('/ruta/a/hello.wsdl');
-        $server->setObject($this->get('hello_service'));
-
-        $response = new Response();
-        $response->headers->set('Content-Type', 'text/xml; charset=ISO-8859-1');
-
-        ob_start();
-        $server->handle();
-        $response->setContent(ob_get_clean());
-
-        return $response;
-    }
-}
-
                  -
                  -

                  Toma nota de las llamadas a ob_start() y ob_get_clean(). Estos métodos controlan la salida almacenada temporalmente lo cual te permite «atrapar» la salida difundida por $server->handle(). Esto es necesario porque Symfony espera que el controlador devuelva un objeto Respuesta con la salida como «contenido». -También debes recordar establecer la cabecera Content-Type a text/xml, ya que esto es lo que espera el cliente. Por lo tanto, utiliza ob_start() para empezar a almacenar la STDOUT y usa ob_get_clean() para volcar la salida difundida al contenido de la Respuesta y limpiar la memoria de salida. Por último, estás listo para devolver la Respuesta.

                  -

                  A continuación hay un ejemplo de llamada al servicio usando el cliente NuSOAP. Este ejemplo asume que el indexAction en el controlador de arriba es accesible a través de la ruta /soap:

                  -
                  $client = new \Soapclient('http://example.com/app.php/soap?wsdl', true);
-
-$result = $client->call('hello', array('name' => 'Scott'));
-
                  -
                  -

                  Abajo está un ejemplo de WSDL.

                  -
                  <?xml version="1.0" encoding="ISO-8859-1"?>
-<definitions xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
-    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/"
-    xmlns:tns="urn:arnleadservicewsdl"
-    xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
-    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
-    xmlns="http://schemas.xmlsoap.org/wsdl/"
-    targetNamespace="urn:helloservicewsdl">
-
-    <types>
-        <xsd:schema targetNamespace="urn:hellowsdl">
-            <xsd:import namespace="http://schemas.xmlsoap.org/soap/encoding/" />
-            <xsd:import namespace="http://schemas.xmlsoap.org/wsdl/" />
-        </xsd:schema>
-    </types>
-
-    <message name="helloRequest">
-        <part name="name" type="xsd:string" />
-    </message>
-
-    <message name="helloResponse">
-        <part name="return" type="xsd:string" />
-    </message>
-
-    <portType name="hellowsdlPortType">
-        <operation name="hello">
-            <documentation>Hello World</documentation>
-            <input message="tns:helloRequest"/>
-            <output message="tns:helloResponse"/>
-        </operation>
-    </portType>
-
-    <binding name="hellowsdlBinding" type="tns:hellowsdlPortType">
-        <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/>
-        <operation name="hello">
-            <soap:operation soapAction="urn:arnleadservicewsdl#hello" style="rpc"/>
-
-            <input>
-                <soap:body use="encoded" namespace="urn:hellowsdl"
-                    encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
-            </input>
-
-            <output>
-                <soap:body use="encoded" namespace="urn:hellowsdl"
-                    encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"/>
-            </output>
-        </operation>
-    </binding>
-
-    <service name="hellowsdl">
-        <port name="hellowsdlPort" binding="tns:hellowsdlBinding">
-            <soap:address location="http://example.com/app.php/soap" />
-        </port>
-    </service>
-</definitions>
-
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/workflow/index.html b/cookbook/workflow/index.html deleted file mode 100644 index fcd018f..0000000 --- a/cookbook/workflow/index.html +++ /dev/null @@ -1,148 +0,0 @@ - - - - - - - Flujo de trabajo — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/workflow/new_project_git.html b/cookbook/workflow/new_project_git.html deleted file mode 100644 index 64b933d..0000000 --- a/cookbook/workflow/new_project_git.html +++ /dev/null @@ -1,240 +0,0 @@ - - - - - - - Cómo crear y guardar un proyecto Symfony2 en git — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear y guardar un proyecto Symfony2 en git

                  -
                  -

                  Truco

                  -

                  <r0> A pesar de que este artículo específicamente es acerca de git, los mismos principios genéricos se aplican si estás guardando el proyecto en Subversión.

                  -
                  -

                  Una vez hayas leído Creando páginas en Symfony2 y te sientas cómodo usando Symfony, sin duda estarás listo para comenzar tu propio proyecto. En este artículo, aprenderás la mejor manera de empezar un nuevo proyecto Symfony2 y almacenarlo usando el sistema de control de versiones git.

                  -
                  -

                  Configuración inicial del proyecto

                  -

                  Para empezar, tendrás que descargar Symfony e iniciar tu repositorio git local:

                  -
                    -

                  1. Descarga la edición estándar de Symfony2 sin vendors.

                    -
                    2. -

                  2. Descomprime la distribución. Esto creará un directorio llamado Symfony con tu nueva estructura del proyecto, archivos de configuración, etc. Cambia el nombre Symfony a lo que quieras.

                    -
                    3. -

                  3. Crea un nuevo archivo llamado .gitignore en la raíz de tu nuevo proyecto (por ejemplo, junto al archivo composer.json) y pega lo siguiente ahí. Los archivos que coincidan con estos patrones serán ignorados por git:

                    -
                    /web/bundles/
-/app/bootstrap*
-/app/cache/*
-/app/logs/*
-/vendor/
-/app/config/parameters.yml
-
                    -
                    -
                    4. -
                  -
                  -

                  Truco

                  -

                  Posiblemente también quieras crear un .gitignore que puedas utilizar en todo el sistema, en cuyo caso, puedes encontrar más información aquí: Github .gitignore -De esta manera puedes excluir archivos y directorios usados frecuentemente por tu IDE en todos tus proyectos.

                  -
                  -
                    -

                  1. Copia app/config/parameters.yml a app/config/parameters.yml.dist. -El archivo parameters.yml es ignorado por git (ve más arriba) para no comprometer la configuración específica de la máquina —como la contraseña de la base de datos—. Al crear el archivo parameters.yml.dist, los nuevos desarrolladores rápidamente pueden clonar el proyecto, copiar este archivo a parameters.yml, personalizarlo y empezar a desarrollar.

                    -
                    2. -

                  2. Inicia el repositorio git:

                    -
                    $ git init
-
                    -
                    -
                    3. -

                  3. Agrega todos los archivos iniciales a git:

                    -
                    $ git add .
-
                    -
                    -
                    4. -

                  4. Crea una confirmación de cambios inicial en tu proyecto recién iniciado:

                    -
                    $ git commit -m "Initial commit"
-
                    -
                    -
                    5. -

                  5. Por último, descarga todas las bibliotecas de otros proveedores ejecutando el composer. Para obtener más información, consulta Actualizando vendors.

                    -
                    6. -
                  -

                  En este punto, tienes un proyecto Symfony2 totalmente operativo confirmado correctamente en git. Puedes comenzar a desarrollarlo inmediatamente, confirmando los nuevos cambios al repositorio git.

                  -

                  Puedes continuar, siguiendo el capítulo Creando páginas en Symfony2 para aprender más acerca de cómo configurar y desarrollar tu aplicación.

                  -
                  -

                  Truco

                  -

                  La edición estándar de Symfony2 viene con alguna funcionalidad de ejemplo. Para eliminar el código de ejemplo, sigue las instrucciones del artículo «Cómo eliminar el AcmeDemoBundle».

                  -
                  -
                  -
                  -

                  Gestionando bibliotecas de terceros con composer.json

                  -
                  -

                  ¿Cómo funciona?

                  -

                  Cada proyecto Symfony utiliza una gran cantidad de bibliotecas "vendor" de terceros. De una u otra manera el objetivo es descargar estos archivos en tu directorio vendor/ y, de ser posible, darle una forma sensata para manejar la versión exacta que necesita cada uno.

                  -

                  De manera predeterminada, estas bibliotecas se descargan ejecutando el «descargador» binario, php composer.phar install. Este archivo composer.phar es parte de una biblioteca llamada Composer y puedes leer más acerca de su instalación en el capítulo Instalación.

                  -

                  El archivo composer.phar lee el archivo composer.json en la raíz de tu proyecto. Se trata de un archivo en formato JSON, que contiene una lista de cada uno de los paquetes externos que necesita, la versión a descargar y mucho más. -El archivo composer.phar también lee el archivo composer.lock, el cual te permite fijar cada biblioteca a una versión exacta. De hecho, si existe un archivo composer.lock, las versiones que contiene tienen prioridad en composer.json. -Para actualizar tus bibliotecas a nuevas versiones, ejecuta php composer.phar update.

                  -
                  -

                  Truco

                  -

                  Si quieres añadir un nuevo paquete a tu aplicación, modifica el archivo composer.json:

                  -
                  {
-    "require": {
-        ...
-        "doctrine/doctrine-fixtures-bundle": "@dev"
-    }
-}
                  -
                  -

                  y luego ejecuta la orden update para este paquete específico, es decir:

                  -
                  $ php composer.phar update doctrine/doctrine-fixtures-bundle
-
                  -
                  -

                  También puedes combinar ambos pasos en una sola orden:

                  -
                  $ php composer.phar require doctrine/doctrine-fixtures-bundle:@dev
-
                  -
                  -
                  -

                  Para obtener más información sobre Composer, consulta GetComposer.org:

                  -

                  Es importante tener en cuenta que estas bibliotecas de proveedores en realidad no son parte de tu repositorio. En cambio, simplemente son archivos sin seguimiento que se descargan en el directorio vendor/. Pero, como toda la información necesaria para descargar estos archivos se guarda en composer.json y composer.lock (los cuales se almacenan en el repositorio), cualquier otro desarrollador puede utilizar el proyecto, ejecutar php composer.phar install, y descargar exactamente el mismo sistema de bibliotecas de proveedores. Esto significa que estás controlando exactamente cada biblioteca de proveedores, sin tener que confirmar los cambios a tu repositorio realmente.

                  -

                  Por lo tanto, cada vez que un desarrollador utilice tu proyecto, tendrá que ejecutar el guión php composer.phar install para asegurarse de descargar todas las bibliotecas de proveedores necesarias.

                  -
                  -

                  Actualizando Symfony

                  -

                  Debido a que Symfony sólo es un grupo de bibliotecas de terceros y las bibliotecas de terceros están completamente controladas a través de composer.json y composer.lock, actualizar Symfony simplemente significa actualizar cada uno de estos archivos para que coincida con su estado en la última edición estándar de Symfony.

                  -

                  Por supuesto, si has agregado nuevas entradas a composer.json, asegúrate de sustituir sólo las partes originales (es decir, asegúrate de no eliminar también cualquiera de tus entradas personalizadas).

                  -
                  -
                  -
                  -

                  Vendors y submódulos

                  -

                  En lugar de utilizar el sistema composer.json para gestionar tus bibliotecas de proveedores, puedes optar por utilizar submódulos git nativos. No hay nada malo con este enfoque, aunque el sistema composer.json es la forma oficial de solucionar este problema y, probablemente, sea mucho más fácil. A diferencia de los submódulos git, Composer es lo suficientemente inteligente como para calcular qué bibliotecas dependen de cuáles otras bibliotecas.

                  -
                  -
                  -
                  -

                  Almacenando tu proyecto en un servidor remoto

                  -

                  Ahora tienes un proyecto Symfony2 completamente operativo almacenado en git. Sin embargo, en la mayoría de los casos, también desearás guardar tu proyecto en un servidor remoto, tanto con fines de seguridad, como para que otros desarrolladores puedan colaborar en el proyecto.

                  -

                  La manera más fácil de almacenar tu proyecto en un servidor remoto es a través de GitHub. -Los repositorios públicos son gratuitos, sin embargo tendrás que pagar una cuota mensual para tener repositorios privados.

                  -

                  Alternativamente, puedes almacenar tu repositorio git en cualquier servidor creando un repositorio minimalista y luego enviando tus cambios al mismo. Una biblioteca que te ayuda a gestionar esto es Gitolite.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/cookbook/workflow/new_project_svn.html b/cookbook/workflow/new_project_svn.html deleted file mode 100644 index c9a3027..0000000 --- a/cookbook/workflow/new_project_svn.html +++ /dev/null @@ -1,259 +0,0 @@ - - - - - - - Cómo crear y guardar un proyecto Symfony2 en Subversion — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Cómo crear y guardar un proyecto Symfony2 en Subversion

                  -
                  -

                  Truco

                  -

                  Este artículo específicamente es sobre Subversion, y se basa en los principios que se encuentran en Cómo crear y guardar un proyecto Symfony2 en git.

                  -
                  -

                  Una vez hayas leído Creando páginas en Symfony2 y te sientas cómodo usando Symfony, sin duda estarás listo para comenzar tu propio proyecto. El método preferido para gestionar proyectos Symfony2 es usando git, pero algunos prefieren usar Subversion ¡lo cual está completamente bien! En esta receta, aprenderás a gestionar tu proyecto usando svn en una forma similar a como se debe hacer con git.

                  -
                  -

                  Truco

                  -

                  Este es un método para dar seguimiento a tu proyecto Symfony2 en un repositorio de Subversion. Hay varias maneras de hacerlo y esta simplemente es una que funciona.

                  -
                  -
                  -

                  El repositorio Subversion

                  -

                  Para este artículo supondrás que el diseño de tu repositorio sigue la estructura generalizada estándar:

                  -
                  myproject/
-    branches/
-    tags/
-    trunk/
-
                  -
                  -
                  -

                  Truco

                  -

                  La mayoría del alojamiento de subversión debe seguir esta práctica estándar. Este es el diseño recomendado del Control de versiones con Subversion y el diseño utilizado por la mayoría del alojamiento gratuito (consulta Soluciones de alojamiento Subversion).

                  -
                  -
                  -
                  -

                  Configuración inicial del proyecto

                  -

                  Para empezar, tendrás que descargar Symfony2 y obtener la configuración básica de Subversion:

                  -
                    -

                  1. Descarga la edición estándar de Symfony2 con o sin vendors.

                    -
                    2. -

                  2. Descomprime la distribución. Esto creará un directorio llamado Symfony con tu nueva estructura del proyecto, archivos de configuración, etc. Cámbiale el nombre a lo que quieras.

                    -
                    3. -

                  3. Copia el repositorio de Subversion que será el anfitrión de este proyecto. Digamos que está alojado en Google code y se llama miproyecto:

                    -
                    $ svn checkout http://myproject.googlecode.com/svn/trunk myproject
-
                    -
                    -
                    4. -

                  4. Copia los archivos del proyecto Symfony2 en el directorio de subversión:

                    -
                    $ mv Symfony/* myproject/
-
                    -
                    -
                    5. -

                  5. Ahora vamos a configurar las reglas de ignorar. No todo se debe almacenar en tu repositorio de Subversion. Algunos archivos (como el caché) se generan y otros (como la configuración de la base de datos) están destinados a ser personalizados en cada máquina. Este hace uso de la propiedad svn:ignore, de modo que los archivos específicos se pueden omitir.

                    -
                    $ cd myproject/
-$ svn add --depth=empty app app/cache app/logs app/config web
-
-$ svn propset svn:ignore "vendor" .
-$ svn propset svn:ignore "bootstrap*" app/
-$ svn propset svn:ignore "parameters.yml" app/config/
-$ svn propset svn:ignore "*" app/cache/
-$ svn propset svn:ignore "*" app/logs/
-
-$ svn propset svn:ignore "bundles" web
-
-$ svn ci -m "commit basic Symfony ignore list (vendor, app/bootstrap*, app/config/parameters.yml, app/cache/*, app/logs/*, web/bundles)"
-
                    -
                    -
                    6. -

                  6. Ahora, puedes añadir los archivos faltantes y confirmar los cambios al proyecto:

                    -
                    $ svn add --force .
-$ svn ci -m "add basic Symfony Standard 2.X.Y"
-
                    -
                    -
                    7. -

                  7. Copia app/config/parameters.yml a app/config/parameters.yml.dist. -El archivo parameters.yml es ignorado por svn (ve arriba) para no comprometer la configuración específica de la máquina ya que la contraseña de la base de datos no se envía. Al crear el archivo parameters.yml.dist, los nuevos desarrolladores rápidamente pueden clonar el proyecto, copiar este archivo a parameters.yml, personalizarlo y empezar a desarrollar.

                    -
                    8. -

                  8. Por último, descarga todas las bibliotecas de otros proveedores ejecutando el composer. Para obtener más información, consulta Actualizando vendors.

                    -
                    9. -
                  -
                  -

                  Truco

                  -

                  Si confías en las versiones «dev», entonces, puedes utilizar git para instalar bibliotecas, puesto que no hay un archivo disponible para descargar.

                  -
                  -

                  En este punto, tienes un proyecto Symfony2 completamente operativo almacenado en tu repositorio de Subversion. Puedes comenzar a desarrollar confirmando tus cambios al repositorio de Subversion.

                  -

                  Puedes continuar, siguiendo el capítulo Creando páginas en Symfony2 para aprender más acerca de cómo configurar y desarrollar tu aplicación.

                  -
                  -

                  Truco

                  -

                  La edición estándar de Symfony2 viene con alguna funcionalidad de ejemplo. Para eliminar el código de ejemplo, sigue las instrucciones del artículo «Cómo eliminar el AcmeDemoBundle».

                  -
                  -
                  -
                  -

                  Gestionando bibliotecas de terceros con composer.json

                  -
                  -

                  ¿Cómo funciona?

                  -

                  Cada proyecto Symfony utiliza una gran cantidad de bibliotecas "vendor" de terceros. De una u otra manera el objetivo es descargar estos archivos en tu directorio vendor/ y, de ser posible, darle una forma sensata para manejar la versión exacta que necesita cada uno.

                  -

                  De manera predeterminada, estas bibliotecas se descargan ejecutando el «descargador» binario, php composer.phar install. Este archivo composer.phar es parte de una biblioteca llamada Composer y puedes leer más acerca de su instalación en el capítulo Instalación.

                  -

                  El archivo composer.phar lee el archivo composer.json en la raíz de tu proyecto. Se trata de un archivo en formato JSON, que contiene una lista de cada uno de los paquetes externos que necesita, la versión a descargar y mucho más. -El archivo composer.phar también lee el archivo composer.lock, el cual te permite fijar cada biblioteca a una versión exacta. De hecho, si existe un archivo composer.lock, las versiones que contiene tienen prioridad en composer.json. -Para actualizar tus bibliotecas a nuevas versiones, ejecuta php composer.phar update.

                  -
                  -

                  Truco

                  -

                  Si quieres añadir un nuevo paquete a tu aplicación, modifica el archivo composer.json:

                  -
                  {
-    "require": {
-        ...
-        "doctrine/doctrine-fixtures-bundle": "@dev"
-    }
-}
                  -
                  -

                  y luego ejecuta la orden update para este paquete específico, es decir:

                  -
                  $ php composer.phar update doctrine/doctrine-fixtures-bundle
-
                  -
                  -

                  También puedes combinar ambos pasos en una sola orden:

                  -
                  $ php composer.phar require doctrine/doctrine-fixtures-bundle:@dev
-
                  -
                  -
                  -

                  Para obtener más información sobre Composer, consulta GetComposer.org:

                  -

                  Es importante tener en cuenta que estas bibliotecas de proveedores en realidad no son parte de tu repositorio. En cambio, simplemente son archivos sin seguimiento que se descargan en el directorio vendor/. Pero, como toda la información necesaria para descargar estos archivos se guarda en composer.json y composer.lock (los cuales se almacenan en el repositorio), cualquier otro desarrollador puede utilizar el proyecto, ejecutar php composer.phar install, y descargar exactamente el mismo sistema de bibliotecas de proveedores. Esto significa que estás controlando exactamente cada biblioteca de proveedores, sin tener que confirmar los cambios a tu repositorio realmente.

                  -

                  Por lo tanto, cada vez que un desarrollador utilice tu proyecto, tendrá que ejecutar el guión php composer.phar install para asegurarse de descargar todas las bibliotecas de proveedores necesarias.

                  -
                  -

                  Actualizando Symfony

                  -

                  Debido a que Symfony sólo es un grupo de bibliotecas de terceros y las bibliotecas de terceros están completamente controladas a través de composer.json y composer.lock, actualizar Symfony simplemente significa actualizar cada uno de estos archivos para que coincida con su estado en la última edición estándar de Symfony.

                  -

                  Por supuesto, si has agregado nuevas entradas a composer.json, asegúrate de sustituir sólo las partes originales (es decir, asegúrate de no eliminar también cualquiera de tus entradas personalizadas).

                  -
                  -
                  -
                  -
                  -

                  Soluciones de alojamiento Subversion

                  -

                  La mayor diferencia entre git y svn es que Subversion necesita un repositorio central para trabajar. Entonces, tiene varias soluciones:

                  -
                    -
                  • Autolojamiento: crea tu propio repositorio y accede ahí a través del sistema de archivos o la red. Para ayudarte en esta tarea puedes leer Control de versiones con Subversion.
                    • -
                  • Alojamiento de terceros: hay un montón de soluciones serias de alojamiento gratuito disponibles como ‘GitHub`_, Google code, SourceForge o Gna. Algunas de ellas también ofrecen alojamiento git.
                    • -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/genindex.html b/genindex.html deleted file mode 100644 index 1d07ae1..0000000 --- a/genindex.html +++ /dev/null @@ -1,2539 +0,0 @@ - - - - - - - - - Índice — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - -

                  Índice

                  - -
                  - A - | B - | C - | D - | E - | F - | G - | H - | I - | J - | K - | L - | M - | O - | P - | R - | S - | T - | V - | W - | Y - -
                  -

                  A

                  - - - -
                  - -
                  Acción -
                  - - -
                  Acme -
                  - - -
                  Activo -
                  - - -
                  API estable -
                  - -
                  - -
                  Aplicación -
                  - - -
                  - Assetic -
                  - -
                  - -
                  Aplicando filtros -
                  - - -
                  Introducción -
                  - - -
                  Optimizando imágenes -
                  - - -
                  Referencia de configuración -
                  - - -
                  YUI Compressor -
                  - -
                  - -
                  - Autocargador -
                  - -
                  - -
                  Configuración -
                  - -
                  - -
                  - Ayudantes de consola -
                  - -
                  - -
                  Ayudante Table -
                  - - -
                  Ayudante formateador -
                  - - -
                  Ayudantes de diálogo -
                  - - -
                  El ayudante Progress -
                  - -
                  -
                  - -

                  B

                  - - - -
                  - -
                  - Bitácora -
                  - -
                  - -
                  Enviando errores por correo electrónico -
                  - -
                  -
                  - -
                  BlockBundle -
                  - -
                  - -

                  C

                  - - - -
                  - -
                  - Cabeceras HTTP -
                  - -
                  - -
                  Cache-Control, [1] -
                  - - -
                  Etag -
                  - - -
                  Expires -
                  - - -
                  Last-Modified -
                  - - -
                  Vary -
                  - -
                  - -
                  Caché -
                  - -
                  - -
                  Cabecera Cache-Control, [1] -
                  - - -
                  Cabecera Etag -
                  - - -
                  Cabecera Expires -
                  - - -
                  Cabecera Last-Modified -
                  - - -
                  Caducidad HTTP -
                  - - -
                  Configuración -
                  - - -
                  Delegado -
                  - - -
                  Delegado inverso -
                  - - -
                  Delegado inverso de Symfony2 -
                  - - -
                  ESI -
                  - - -
                  Get Condicional -
                  - - -
                  HTTP -
                  - - -
                  Invalidando -
                  - - -
                  Métodos seguros -
                  - - -
                  Pasarela -
                  - - -
                  Tipos de -
                  - - -
                  Twig -
                  - - -
                  Validando -
                  - - -
                  Varnish -
                  - - -
                  Vary -
                  - -
                  - -
                  - CLI -
                  - -
                  - -
                  ODM de Doctrine -
                  - - -
                  ORM de Doctrine -
                  - -
                  - -
                  - Componentes -
                  - -
                  - -
                  ClassLoader -
                  - - -
                  Config -
                  - - -
                  Console, [1] -
                  - - -
                  CssSelector -
                  - - -
                  Debug -
                  - - -
                  DependencyInjection -
                  - - -
                  DomCrawler -
                  - - -
                  EventDispatcher -
                  - - -
                  Finder -
                  - - -
                  HttpFoundation -
                  - - -
                  HttpKernel -
                  - - -
                  Instalando -
                  - - -
                  Locale -
                  - - -
                  OptionsResolver -
                  - - -
                  Plantillas -
                  - - -
                  Process -
                  - - -
                  PropertyAccess -
                  - - -
                  Routing, [1] -
                  - - -
                  Serializer -
                  - - -
                  Stopwatch -
                  - - -
                  Usando -
                  - - -
                  Yaml, [1] -
                  - -
                  - -
                  Componentes de Symfony2 -
                  - - -
                  Config -
                  - -
                  - -
                  Almacenamiento en caché basado en recursos -
                  - - -
                  Cargando recursos -
                  - - -
                  Definiendo y procesando valores de configuración -
                  - -
                  - -
                  - Configuración -
                  - -
                  - -
                  Autocargador -
                  - - -
                  Caché -
                  - - -
                  Convención -
                  - - -
                  DBAL de Doctrine -
                  - - -
                  Modo de depuración -
                  - - -
                  ODM MongoDB de Doctrine -
                  - - -
                  PHPUnit -
                  - - -
                  Pruebas -
                  - - -
                  Semántica, [1] -
                  - - -
                  Validación -
                  - -
                  - -
                  - Console -
                  - -
                  - -
                  Aplicación de una sola orden -
                  - - -
                  Ayudantes de consola -
                  - - -
                  CLI, [1] -
                  - - -
                  Creando ordenes -
                  - - -
                  Enviando mensajes de correo electrónico -
                  - - -
                  Eventos -
                  - - -
                  Generando URL -
                  - - -
                  Habilitando el registro cronológico -
                  - - -
                  Usando, [1] -
                  - -
                  - -
                  Contenedor de Servicios -
                  - - -
                  Contenedor de servicios -
                  - -
                  - -
                  Configuración de extensión -
                  - - -
                  Configurando servicios -
                  - - -
                  Etiquetas -
                  - - -
                  Imports -
                  - - -
                  Pases del compilador -
                  - - -
                  Refiriendo servicios -
                  - - -
                  ¿Qué es un contenedor de servicios? -
                  - - -
                  ¿Qué es un servicio? -
                  - -
                  - -
                  Content, SymfonyCmfContentBundle -
                  - -
                  - -
                  ContentBundle, [1] -
                  - - -
                  Controlador, [1] -
                  - -
                  - -
                  Accediendo a servicios -
                  - - -
                  Argumentos del controlador -
                  - - -
                  Cadena denominando el formato -
                  - - -
                  Ciclo de vida de la petición, controlador, respuesta -
                  - - -
                  Clase base controlador -
                  - - -
                  Como servicio -
                  - - -
                  Ejemplo sencillo -
                  - - -
                  Gestionando errores -
                  - - -
                  La sesión -
                  - - -
                  Objeto Petición -
                  - - -
                  Objeto Respuesta -
                  - - -
                  Personalizando páginas de error -
                  - - -
                  Redirigiendo -
                  - - -
                  Reenviando -
                  - - -
                  Reproduciendo plantillas -
                  - - -
                  Rutas y controladores -
                  - - -
                  Tareas comunes -
                  - - -
                  páginas 404 -
                  - -
                  - -
                  Controlador frontal -
                  - - -
                  - Convenciones de nomenclatura -
                  - -
                  - -
                  Despachador de evento, [1] -
                  - - -
                  Paquete -
                  - -
                  - -
                  - Convención -
                  - -
                  - -
                  Configuración -
                  - -
                  - -
                  CoreBundle, [1] -
                  - - -
                  - Correo electrónico -
                  - -
                  - -
                  En desarrollo -
                  - - -
                  Gmail -
                  - - -
                  Organizando -
                  - - -
                  Probando -
                  - -
                  - -
                  Cortafuegos -
                  - - -
                  Creando páginas -
                  - -
                  - -
                  Ejemplo -
                  - -
                  - -
                  create.js -
                  - - -
                  CreateBundle, [1] -
                  - -
                  - -

                  D

                  - - - -
                  - -
                  DBAL -
                  - -
                  - -
                  Doctrine -
                  - -
                  - -
                  Depuración -
                  - - -
                  Depurando -
                  - - -
                  Despachador de evento, [1], [2], [3], [4], [5] -
                  - -
                  - -
                  Atajos del despachador -
                  - - -
                  Contenedor consciente del servicio -
                  - - -
                  Convenciones de nomenclatura, [1] -
                  - - -
                  Creando y despachando un evento, [1] -
                  - - -
                  Despachador de eventos consciente de eventos y escuchas -
                  - - -
                  Deteniendo el flujo del evento, [1] -
                  - - -
                  Escuchas, [1] -
                  - - -
                  Eventos, [1] -
                  - - -
                  Inspeccionando el nombre del evento -
                  - - -
                  Subclases de evento, [1] -
                  - - -
                  Suscriptores de evento, [1] -
                  - -
                  - -
                  Despachador de eventos -
                  - - -
                  Desplegando -
                  - -
                  - -
                  Diseño -
                  - - -
                  Distribución -
                  - - -
                  Doctrine, [1] -
                  - -
                  - -
                  Agregando metadatos de asociación -
                  - - -
                  Configuración DBAL -
                  - - -
                  Configurando el ODM MongoDB -
                  - - -
                  DBAL -
                  - - -
                  Definiendo relaciones con interfaces y clases abstractas -
                  - - -
                  Escuchas y suscriptores de eventos -
                  - - -
                  Extensiones comunes -
                  - - -
                  Formularios -
                  - - -
                  Funciones DQL personalizadas -
                  - - -
                  Generando entidades desde una base de datos existe -
                  - - -
                  Múltiples gestores de entidad -
                  - - -
                  Ordenes de consola ODM -
                  - - -
                  Ordenes de consola ORM -
                  - - -
                  Referencia de configuración del ORM -
                  - - -
                  Resolviendo entidades destino -
                  - - -
                  Sencillo formulario de registro -
                  - - -
                  Subiendo archivos -
                  - -
                  - -
                  DoctrinePHPCRBundle -
                  - - -
                  DomCrawler -
                  - -
                  - -

                  E

                  - - - -
                  - -
                  Edición estándar, instalando -
                  - - -
                  Emails -
                  - - -
                  Enrutador Apache -
                  - - -
                  Enrutando, [1] -
                  - -
                  - -
                  Bajo el capó -
                  - - -
                  Configurando la redirección a otra ruta sin un controlador personalizado -
                  - - -
                  Controladores -
                  - - -
                  Creando rutas -
                  - - -
                  Custom route loader -
                  - - -
                  Depurando -
                  - - -
                  Ejemplo avanzado -
                  - - -
                  Fundamentos -
                  - - -
                  Generando URL -
                  - - -
                  Generando URL en plantillas -
                  - - -
                  Importando recursos de enrutado -
                  - - -
                  Marcadores de posición -
                  - - -
                  Parámetros del contenedor del servicio -
                  - - -
                  Permite / en el parámetro ruta -
                  - - -
                  Reconociendo el nombre del servidor -
                  - - -
                  Requisitos -
                  - - -
                  Requisitos de método -
                  - - -
                  Scheme requirement -
                  - - -
                  URL absolutas -
                  - - -
                  métodos -
                  - - -
                  parámetro _format -
                  - -
                  - -
                  Entorno -
                  - - -
                  Entornos -
                  - -
                  - -
                  Archivos de configuración -
                  - - -
                  Configuración -
                  - - -
                  Creando un nuevo entorno -
                  - - -
                  Directorio de caché -
                  - - -
                  Ejecutando diferentes entornos -
                  - - -
                  Introducción -
                  - - -
                  Parámetros externos -
                  - -
                  - -
                  ESI -
                  - -
                  - -
                  Especificación HTTP -
                  - - -
                  Estructura del directorio -
                  - - -
                  - Evento -
                  - -
                  - -
                  Kernel -
                  - - -
                  kernel.controller -
                  - - -
                  kernel.exception -
                  - - -
                  kernel.request -
                  - - -
                  kernel.response -
                  - - -
                  kernel.view -
                  - -
                  - -
                  - Eventos -
                  - -
                  - -
                  Creando escuchas -
                  - -
                  - -
                  Extensiones Twig -
                  - - -
                  Extensiones Twig de Symfony2 -
                  - -
                  - -

                  F

                  - - - -
                  - -
                  Filesystem -
                  - - -
                  Finder -
                  - - -
                  - Flujo de trabajo -
                  - -
                  - -
                  Git -
                  - - -
                  Subversion -
                  - -
                  - -
                  - Formulario -
                  - -
                  - -
                  Empty data -
                  - - -
                  Eventos, [1] -
                  - - -
                  Extendiendo el tipo Form -
                  - - -
                  Formularios virtuales -
                  - - -
                  Integrar colección de formularios -
                  - - -
                  Probando formularios -
                  - - -
                  Reproducción personalizada de formularios -
                  - - -
                  Sencillo formulario de registro -
                  - - -
                  Tipo de campo personalizado -
                  - - -
                  Transformadores de datos -
                  - -
                  - -
                  Formularios -
                  - -
                  - -
                  Campos: Choice, [1] -
                  - - -
                  Campos: birthday -
                  - - -
                  Campos: checkbox -
                  - - -
                  Campos: collection -
                  - - -
                  Campos: country -
                  - - -
                  Campos: csrf -
                  - - -
                  Campos: date -
                  - - -
                  Campos: datetime -
                  - - -
                  Campos: email -
                  - - -
                  Campos: field -
                  - - -
                  Campos: file -
                  - - -
                  Campos: form -
                  - - -
                  Campos: hidden -
                  - - -
                  Campos: integer -
                  - - -
                  Campos: language -
                  - - -
                  Campos: locale -
                  - - -
                  Campos: money -
                  - - -
                  Campos: number -
                  - - -
                  Campos: password -
                  - - -
                  Campos: percent -
                  - - -
                  Campos: radio -
                  - - -
                  Campos: repetidos -
                  - - -
                  Campos: search -
                  - - -
                  Campos: text -
                  - - -
                  Campos: textarea -
                  - - -
                  Campos: time -
                  - - -
                  Campos: timezone -
                  - - -
                  Campos: url -
                  - - -
                  Creando clases Form -
                  - - -
                  Creando un formulario en un controlador -
                  - - -
                  Creando un formulario sencillo -
                  - - -
                  Deduciendo el tipo de campo, [1] -
                  - - -
                  Doctrine -
                  - - -
                  Heredando fragmentos de plantilla -
                  - - -
                  Integrando formularios -
                  - - -
                  Nombrando fragmentos de la plantilla -
                  - - -
                  Opciones del tipo de campo -
                  - - -
                  Personalizando campos -
                  - - -
                  Procesando el envío del formulario -
                  - - -
                  Protección CSRF -
                  - - -
                  Referencia de funciones de formulario Twig -
                  - - -
                  Referencia de tipos -
                  - - -
                  Reproducción básica de plantillas -
                  - - -
                  Reproduciendo cada campo a mano -
                  - - -
                  Reproduciendo en una plantilla -
                  - - -
                  Sin clase -
                  - - -
                  Tematizado global -
                  - - -
                  Tematizando -
                  - - -
                  Tipos de campo integrados -
                  - - -
                  Validando -
                  - - -
                  Validando grupos -
                  - -
                  -
                  - -
                  FOSJsRoutingBundle -
                  - - -
                  FOSRestBundle -
                  - - -
                  Funcionamiento interno -
                  - -
                  - -
                  Kernel -
                  - - -
                  Peticiones internas -
                  - - -
                  Procesando la petición -
                  - - -
                  Resolutor de controlador -
                  - -
                  - -
                  Fundamentos de Symfony2 -
                  - -
                  - -
                  Peticiones y respuestas -
                  - -
                  -
                  - -

                  G

                  - - - -
                  - -
                  Generador de perfiles -
                  - - -
                  Generador de perfiles: Usando el servicio generador de perfiles -
                  - -
                  - -
                  Generador de perfiles: Visualizando, [1] -
                  - -
                  - -

                  H

                  - - - -
                  - -
                  hallo.js -
                  - - -
                  - Hojas de estilo -
                  - -
                  - -
                  Incluyendo hojas de estilo -
                  - -
                  - -
                  How front controller, ``AppKernel`` and environments -
                  - - -
                  HTTP, [1], [2], [3], [4], [5] -
                  - -
                  - -
                  304 -
                  - - -
                  El paradigma petición/respuesta -
                  - -
                  -
                  - -
                  HttpFoundation, [1] -
                  - - -
                  HttpFoundation, Sesiones, [1], [2] -
                  - - -
                  HttpKernel -
                  - -
                  - -

                  I

                  - - - -
                  - -
                  I18N -
                  - - -
                  i18n -
                  - - -
                  instalación -
                  - -
                  - -
                  Instalando -
                  - - -
                  instalando -
                  - - -
                  Inyección de dependencias, [1] -
                  - -
                  - -
                  Compilación -
                  - - -
                  Configuración avanzada -
                  - - -
                  Configuradores de servicio -
                  - - -
                  Contenedor -
                  - - -
                  Definiendo servicios -
                  - - -
                  Etiquetas -
                  - - -
                  Extensión -
                  - - -
                  Factorías -
                  - - -
                  Flujo de trabajo; -
                  - - -
                  Parameters -
                  - - -
                  Pases del compilador -
                  - - -
                  Servicios padre -
                  - - -
                  Tipos de inyección -
                  - - -
                  Ámbitos -
                  - -
                  -
                  - -

                  J

                  - - - -
                  - -
                  Jackrabbit -
                  - - -
                  - JavaScript -
                  - -
                  - -
                  Incluyendo archivos JavaScript -
                  - -
                  -
                  - -
                  JMSSerializerBundle -
                  - -
                  - -

                  K

                  - - - -
                  - -
                  Kernel -
                  - -
                  - -
                  Evento -
                  - -
                  -
                  - -
                  KnpMenuBundle -
                  - -
                  - -

                  L

                  - - -
                  - -
                  Locale -
                  - -
                  - -

                  M

                  - - - -
                  - -
                  Menu, SymfonyCmfMenuBundle -
                  - - -
                  MenuBundle, [1] -
                  - - -
                  Midgard -
                  - -
                  - -
                  - Monolog -
                  - -
                  - -
                  Referencia de configuración -
                  - -
                  - -
                  Multilanguage -
                  - -
                  - -

                  O

                  - - - -
                  - -
                  ODM, [1], [2], [3], [4] -
                  - - -
                  Options Resolver -
                  - -
                  - -
                  ORM -
                  - -
                  - -

                  P

                  - - - -
                  - -
                  Paquete -
                  - -
                  - -
                  Buenas prácticas -
                  - - -
                  Configuración de extensión, [1] -
                  - - -
                  Convenciones de nomenclatura -
                  - - -
                  Eliminando el AcmeDemoBundle -
                  - - -
                  Extensión -
                  - - -
                  Herencia, [1] -
                  - - -
                  Instalando -
                  - -
                  - -
                  Páginas de error -
                  - - -
                  - Perfilando -
                  - -
                  - -
                  Colector de datos -
                  - -
                  - -
                  - Petición -
                  - -
                  - -
                  Añade un formato de petición y tipo MIME -
                  - - -
                  Delegados confiables -
                  - -
                  - -
                  PHPCR, [1], [2], [3], [4] -
                  - - -
                  - PHPUnit -
                  - -
                  - -
                  Configuración -
                  - -
                  - -
                  - Plantilla -
                  - -
                  - -
                  Excepción al sustituir plantillas -
                  - - -
                  Sustituyendo plantillas -
                  - -
                  - -
                  Plantillas -
                  - -
                  - -
                  Ayudantes, [1] -
                  - - -
                  Convenciones de nomenclatura -
                  - - -
                  Dibuja la plantilla sin controlador personalizado -
                  - - -
                  Diseño -
                  - - -
                  El servicio plantillas (templating) -
                  - - -
                  Enlazando activos -
                  - - -
                  Enlazando páginas -
                  - - -
                  Etiquetas y ayudantes -
                  - - -
                  Formatos -
                  - - -
                  Herencia -
                  - - -
                  Incluyendo -
                  - - -
                  Incluyendo hojas de estilo y JavaScript -
                  - - -
                  Incluyendo otras plantillas -
                  - - -
                  Integrando acción -
                  - - -
                  Integrando páginas -
                  - - -
                  Mecanismo de escape -
                  - - -
                  Patrón de herencia de tres niveles -
                  - - -
                  Ranura -
                  - - -
                  Rutas Twig con espacios de nombres -
                  - - -
                  Ubicación de archivos -
                  - - -
                  Variables globales -
                  - - -
                  ¿Qué es una plantilla? -
                  - -
                  -
                  - -
                  Plantillas PHP -
                  - - -
                  Process -
                  - - -
                  Propel -
                  - - -
                  PropertyAccess -
                  - - -
                  Proyecto -
                  - - -
                  Pruebas, [1] -
                  - -
                  - -
                  Aislando clientes -
                  - - -
                  Aserciones -
                  - - -
                  Autenticación HTTP -
                  - - -
                  Cliente -
                  - - -
                  Configuración -
                  - - -
                  Crawler -
                  - - -
                  Doctrine -
                  - - -
                  Perfiles -
                  - - -
                  Pruebas funcionales -
                  - - -
                  Pruebas unitarias -
                  - - -
                  Simulating authentication -
                  - -
                  - -
                  publish workflow -
                  - -
                  - -

                  R

                  - - - -
                  - -
                  Ranura -
                  - - -
                  RDBMS, [1] -
                  - - -
                  RDFa -
                  - - -
                  recinto de seguridad -
                  - - -
                  - Referencia de configuración -
                  - -
                  - -
                  Assetic -
                  - - -
                  Framework -
                  - - -
                  Kernel class -
                  - - -
                  Monolog -
                  - - -
                  ORM de Doctrine -
                  - - -
                  Swiftmailer -
                  - - -
                  Twig -
                  - - -
                  WebProfiler -
                  - -
                  - -
                  Registrando eventos cronológicamente, [1] -
                  - -
                  - -
                  - Rendimiento -
                  - -
                  - -
                  Archivos de arranque -
                  - - -
                  Autocargador -
                  - - -
                  Caché de código de bytes -
                  - -
                  - -
                  Requisitos -
                  - - -
                  Routing, [1], [2] -
                  - - -
                  Routing, SymfonyCmfRoutingExtraBundle -
                  - - -
                  RoutingExtraBundle, [1] -
                  - -
                  - -

                  S

                  - - - -
                  - -
                  sandbox -
                  - - -
                  SearchBundle -
                  - - -
                  Seguridad, [1] -
                  - -
                  - -
                  Conceptos ACL avanzados -
                  - - -
                  Forzando HTTPS -
                  - - -
                  Listas de control de acceso (ACL) -
                  - - -
                  Personalizando el formulario de acceso -
                  - - -
                  Protegiendo cualquier método -
                  - - -
                  Protegiendo cualquier servicio -
                  - - -
                  Proveedor de autenticación personalizado -
                  - - -
                  Proveedor de entidad -
                  - - -
                  Proveedor de usuario, [1] -
                  - - -
                  Referencia de configuración -
                  - - -
                  Ruta destino de reorientación -
                  - - -
                  Voters -
                  - - -
                  «Recuérdame» -
                  - -
                  - -
                  Seguridad, autenticación -
                  - - -
                  Seguridad, autorización -
                  - - -
                  Seguridad, cortafuegos -
                  - - -
                  Selector CSS -
                  - - -
                  Serializer, [1] -
                  - - -
                  Servicio -
                  - - -
                  - Servicios Web -
                  - -
                  - -
                  SOAP -
                  - -
                  - -
                  Sesión -
                  - -
                  - -
                  Almacenamiento en la base de datos -
                  - - -
                  Mensajes flash -
                  - -
                  -
                  - -
                  SimpleCMS, SymfonyCmfSimpleCMSBundle -
                  - - -
                  SimpleCmsBundle, [1] -
                  - - -
                  Sonata -
                  - - -
                  SonataAdminBundle -
                  - - -
                  SonataBlockBundle -
                  - - -
                  SonataDoctrinePHPCRAdminBundle -
                  - - -
                  SonatajQueryBundle -
                  - - -
                  Stopwatch -
                  - - -
                  Sustituyendo Symfony -
                  - - -
                  symfony1 -
                  - -
                  - -

                  T

                  - - - -
                  - -
                  Templating -
                  - - -
                  Traducciones -
                  - -
                  - -
                  Catálogos de mensajes -
                  - - -
                  Configuración -
                  - - -
                  Creando recursos de traducción -
                  - - -
                  Dominio de los mensajes -
                  - - -
                  En plantillas -
                  - - -
                  Marcadores de posición en mensajes -
                  - - -
                  Pluralización -
                  - - -
                  Región del usuario -
                  - - -
                  Región y reserva predeterminada -
                  - - -
                  Traducción básica -
                  - - -
                  Ubicación de recursos de traducción -
                  - -
                  - -
                  TreeBrowserBundle, [1] -
                  - -
                  - -
                  TreeBundle, [1], [2] -
                  - - -
                  - Twig -
                  - -
                  - -
                  Caché -
                  - - -
                  Introducción -
                  - - -
                  Referencia de configuración -
                  - -
                  -
                  - -

                  V

                  - - - -
                  - -
                  - Validación -
                  - -
                  - -
                  Configuración -
                  - - -
                  Configurando restricciones -
                  - - -
                  Fundamentos -
                  - - -
                  Objetivos de restricción -
                  - - -
                  Restricciones -
                  - - -
                  Restricciones personalizadas -
                  - - -
                  Restricción de captadores -
                  - - -
                  Restricción de propiedades -
                  - - -
                  Usando el validador -
                  - - -
                  Validando con formularios -
                  - - -
                  Validando valores crudos -
                  - -
                  - -
                  Validando -
                  - - -
                  - Varnish -
                  - -
                  - -
                  Configuración -
                  - - -
                  Invalidando -
                  - -
                  -
                  - -
                  Vendedor -
                  - - -
                  VIE.js -
                  - -
                  - -

                  W

                  - - - -
                  - -
                  Web Server -
                  - -
                  - -
                  work together -
                  - -
                  - -

                  Y

                  - - - -
                  - -
                  YAML -
                  - -
                  - -
                  Yaml, [1] -
                  - -
                  - -
                  Formato YAML -
                  - -
                  -
                  - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/glossary.html b/glossary.html deleted file mode 100644 index 72f8630..0000000 --- a/glossary.html +++ /dev/null @@ -1,153 +0,0 @@ - - - - - - - Glosario — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Glosario

                  -
                  -
                  Acción
                  -
                  Una acción es una función PHP o método que se ejecuta, por ejemplo, cuando corresponde una determinada ruta. El término acción es sinónimo de controlador, aunque un controlador también se puede referir a toda una clase PHP que incluye varias acciones. Consulta el capítulo Controlador.
                  -
                  Acme
                  -
                  Acme es el nombre de una empresa ficticia utilizado en las demostraciones y documentación de Symfony. -Se utiliza como un espacio de nombres donde normalmente se utiliza el nombre de tu propia empresa (por ejemplo, Acme\BlogBundle).
                  -
                  Activo
                  -
                  Un activo es cualquier componente estático, no ejecutable de una aplicación web, incluyendo CSS, JavaScript, imágenes y video. Los activos se pueden colocar directamente en el directorio web del proyecto, o publicarse desde un Paquete al directorio web, utilizando la tarea de consola assets:install.
                  -
                  Aplicación
                  -
                  Una aplicación es un directorio que contiene la configuración para un determinado conjunto de paquetes.
                  -
                  Contenedor de servicios
                  -
                  Un contenedor de servicios, también conocido como contenedor de inyección de dependencias, es un objeto especial que gestiona la creación de instancias de servicios dentro de una aplicación. En lugar de crear servicios directamente, el desarrollador prepara el contenedor de servicios (vía configuración) sobre cómo crear los servicios. El contenedor de servicios se encarga de iniciar instancias e inyectar los servicios dependientes. Ve el capítulo Contenedor de servicios.
                  -
                  Controlador
                  -
                  Un controlador es una función PHP que alberga toda la lógica necesaria para devolver un objeto Respuesta el cual representa una página en particular. -Normalmente, una ruta se asigna a un controlador, el cual a su vez, utiliza los datos de la petición para procesar información, realizar acciones, y, finalmente, construir y devolver un objeto Respuesta.
                  -
                  Controlador frontal
                  -
                  Un controlador frontal es un pequeño archivo PHP que vive en el directorio web de tu proyecto. Típicamente, todas las peticiones se manejan ejecutando el mismo controlador frontal, cuyo trabajo es arrancar la aplicación Symfony.
                  -
                  Cortafuegos
                  -
                  En Symfony2, un cortafuegos no tiene que ver con la creación de redes. En su lugar, este define los mecanismos de autenticación (es decir, maneja el proceso de determinar la identidad de los usuarios), ya sea para toda la aplicación o sólo para una parte de ella. Consulta el capítulo sobre Seguridad.
                  -
                  Distribución
                  -
                  Una distribución es un paquete hecho de componentes Symfony2, una selección de paquetes, una sensible estructura de directorios, una configuración predeterminada y opcionalmente un sistema de configuración.
                  -
                  Entorno
                  -
                  El entorno es una cadena (por ejemplo, prod o dev) que corresponde a un conjunto de configuración específico. La misma aplicación puede ejecutarse en la misma máquina utilizando diferente configuración, ejecutando la aplicación en diferentes entornos. Esto es útil ya que permite que una única petición tenga un entorno de desarrollo dev construido para la depuración y un entorno de producción prod optimizado para velocidad.
                  -
                  Especificación HTTP
                  -
                  La especificación HTTP es un documento que describe el Hypertext Transfer Protocol —un conjunto de normas para la clásica comunicación cliente–servidor vía petición–respuesta. La especificación define el formato utilizado para la petición y respuesta, así como las posibles cabeceras HTTP que cada una puede tener. Para más información, lee HTTP en Wikipedia o el artículo HTTP 1.1 RFC.
                  -
                  Kernel
                  -
                  El Kernel es el núcleo de Symfony2. El objeto núcleo controla las peticiones HTTP utilizando todos los paquetes y bibliotecas registrados en él. Consulta Arquitectura: El directorio app y el capítulo Funcionamiento interno.
                  -
                  Paquete
                  -
                  Un paquete o bundle es un directorio que contiene un conjunto de archivos (archivos PHP, hojas de estilo, JavaScript, imágenes, ...) que implementan una sola característica (un blog, un foro, etc.) En Symfony2, (casi) todo vive dentro de un paquete. (consulta El sistema de paquetes)
                  -
                  Proyecto
                  -
                  Un proyecto es un directorio compuesto por una aplicación, un conjunto de paquetes, bibliotecas de proveedores, un cargador automático, y un archivo controlador frontal web.
                  -
                  Servicio
                  -
                  Un servicio es un término genérico para cualquier objeto PHP que realiza una tarea específica. Un servicio generalmente se utiliza «globalmente», tal como un objeto de conexión a base de datos o un objeto que envía mensajes de correo electrónico. En Symfony2, los servicios a menudo se configuran y recuperan desde el contenedor del servicio. -Una aplicación que tiene muchos servicios disociados se dice que sigue una arquitectura orientada a servicios.
                  -
                  Vendedor
                  -
                  Un vendedor es un proveedor de bibliotecas y paquetes PHP incluyendo al mismo Symfony2. A pesar de la connotación comercial de la palabra, a menudo, vendedores en Symfony (aunque por lo general) es software libre. Cualquier biblioteca que agregues a tu proyecto Symfony2 debe ir en el directorio vendor. Consulta Arquitectura: Usando vendors.
                  -
                  YAML
                  -
                  YAML es un acrónimo recursivo para “YAML Ain’t a Markup Language”. Es un lenguaje de serialización de datos ligero, humanamente legible utilizado extensivamente en los archivos de configuración de Symfony2. Ve el capítulo El componente YAML.
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/index.html b/index.html deleted file mode 100644 index ad651c3..0000000 --- a/index.html +++ /dev/null @@ -1,265 +0,0 @@ - - - - - - - Documentación de Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Documentación de Symfony2

                  -
                  -

                  Guía de inicio rápido

                  -

                  Empieza a trabajar rápidamente con la Guía de inicio rápido de Symfony:

                  -
                  -
                  - -
                  - -
                  -

                  Recetario

                  -
                  -
                  -

                  Lee el Recetario.

                  -
                  -
                  -

                  Componentes

                  -
                  -
                  -

                  Lee la documentación de Componentes.

                  -
                  -
                  -

                  Documentos de referencia

                  -

                  Consigue respuestas rápidamente con los documentos de referencia:

                  -
                  -
                  - -
                  -
                  -

                  Paquetes

                  -

                  La edición estándar de Symfony2 viene con una configuración de seguridad sencilla, adaptada a las necesidades más comunes. Aprende más acerca de ellas:

                  -
                  -
                  - -
                  -
                  -

                  CMF

                  -

                  El CMFproject de Symfony facilita a los desarrolladores la adición de funcionalidad CMS a las aplicaciones PHP construidas con la plataforma Symfony2.

                  -
                  -
                  -
                  -
                  -

                  Colaborando

                  -

                  Colabora con Symfony2:

                  -
                  -
                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/quick_tour/index.html b/quick_tour/index.html deleted file mode 100644 index 9799607..0000000 --- a/quick_tour/index.html +++ /dev/null @@ -1,136 +0,0 @@ - - - - - - - Inicio rápido — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/quick_tour/the_architecture.html b/quick_tour/the_architecture.html deleted file mode 100644 index ad3dbcf..0000000 --- a/quick_tour/the_architecture.html +++ /dev/null @@ -1,361 +0,0 @@ - - - - - - - La arquitectura — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  La arquitectura

                  -

                  ¡Eres mi héroe! ¿Quién habría pensado que todavía estarías aquí después de las tres primeras partes? Tu esfuerzo pronto será bien recompensado. En las tres primeras partes no vimos en demasiada profundidad la arquitectura de la -plataforma. Porque esta hace que Symfony2 esté al margen de la multitud de plataformas, ahora vamos a profundizar en la arquitectura.

                  -
                  -

                  Comprendiendo la estructura de directorios

                  -

                  La estructura de directorios de una aplicación Symfony2 es bastante flexible, pero la estructura de directorios de la distribución de la edición estándar refleja la estructura típica y recomendada de una aplicación Symfony2:

                  -
                    -
                  • app/: Configuración de la aplicación:
                    • -
                  • src/: El código PHP del proyecto;
                    • -
                  • vendor/: Las dependencias de terceros;
                    • -
                  • web/: El directorio raíz del servidor web.
                    • -
                  -
                  -

                  El Directorio web/

                  -

                  El directorio web raíz, es el hogar de todos los archivos públicos y estáticos tales como imágenes, hojas de estilo y archivos JavaScript. También es el lugar donde vive cada controlador frontal:

                  -
                  // web/app.php
-require_once __DIR__.'/../app/bootstrap.php.cache';
-require_once __DIR__.'/../app/AppKernel.php';
-
-use Symfony\Component\HttpFoundation\Request;
-
-$kernel = new AppKernel('prod', false);
-$kernel->loadClassCache();
-$kernel->handle(Request::createFromGlobals())->send();
-
                  -
                  -

                  El núcleo requiere en primer lugar el archivo bootstrap.php.cache, el cual arranca la plataforma y registra el cargador automático (ve más abajo).

                  -

                  Al igual que cualquier controlador frontal, app.php utiliza una clase del núcleo, AppKernel, para arrancar la aplicación.

                  -
                  -
                  -

                  El directorio app/

                  -

                  La clase AppKernel es el punto de entrada principal para la configuración de la aplicación y, como tal, se almacena en el directorio app/.

                  -

                  Esta clase debe implementar dos métodos:

                  -
                    -
                  • registerBundles() debe devolver un arreglo de todos los paquetes necesarios para ejecutar la aplicación;
                    • -
                  • registerContainerConfiguration() carga la configuración de la aplicación (más sobre esto más adelante).
                    • -
                  -

                  La autocarga es manejada automáticamente vía Composer, ¡lo cual significa que -puedes utilizar cualquier clase PHP sin hacer nada en absoluto! Si necesitas más flexibilidad, puedes extender el autocargador en el archivo app/autoload.php. Todas las dependencias están almacenadas bajo el directorio vendor/, pero esto sólo es una convención. -Las puedes almacenar en cualquier lugar que gustes, globalmente en tu servidor o localmente en tus proyectos.

                  -
                  -

                  Nota

                  -

                  Si quieres aprender más sobre el autocargador de Composer, consulta Composer-Autoloader. -Symfony también tiene un componente autoloading — consulta «El componente ClassLoader».

                  -
                  -
                  -
                  -
                  -

                  Comprendiendo el sistema de paquetes

                  -

                  Esta sección introduce una de las más importantes y poderosas características de Symfony2, el sistema de paquetes.

                  -

                  Un paquete es un poco como un complemento en otros programas. Así que ¿por qué se llama paquete y no complemento? Esto se debe a que en Symfony2 todo es un paquete, desde las características del núcleo de la plataforma hasta el código que escribes para tu aplicación. Los paquetes son ciudadanos de primera clase en Symfony2. Esto te proporciona la flexibilidad para utilizar las características preconstruidas envasadas en paquetes de terceros o para distribuir tus propios paquetes. Además, facilita la selección y elección de las características por habilitar en tu aplicación y optimizarlas en la forma que desees. -Y al final del día, el código de tu aplicación es tan importante como el mismo núcleo de la plataforma.

                  -
                  -

                  Registrando un paquete

                  -

                  Una aplicación se compone de paquetes tal como está definido en el método registerBundles() de la clase AppKernel. Cada paquete vive en un directorio que contiene una única clase Paquete que lo describe:

                  -
                  // app/AppKernel.php
-public function registerBundles()
-{
-    $bundles = array(
-        new Symfony\Bundle\FrameworkBundle\FrameworkBundle(),
-        new Symfony\Bundle\SecurityBundle\SecurityBundle(),
-        new Symfony\Bundle\TwigBundle\TwigBundle(),
-        new Symfony\Bundle\MonologBundle\MonologBundle(),
-        new Symfony\Bundle\SwiftmailerBundle\SwiftmailerBundle(),
-        new Symfony\Bundle\DoctrineBundle\DoctrineBundle(),
-        new Symfony\Bundle\AsseticBundle\AsseticBundle(),
-        new Sensio\Bundle\FrameworkExtraBundle\SensioFrameworkExtraBundle(),
-        new JMS\SecurityExtraBundle\JMSSecurityExtraBundle(),
-    );
-
-    if (in_array($this->getEnvironment(), array('dev', 'test'))) {
-        $bundles[] = new Acme\DemoBundle\AcmeDemoBundle();
-        $bundles[] = new Symfony\Bundle\WebProfilerBundle\WebProfilerBundle();
-        $bundles[] = new Sensio\Bundle\DistributionBundle\SensioDistributionBundle();
-        $bundles[] = new Sensio\Bundle\GeneratorBundle\SensioGeneratorBundle();
-    }
-
-    return $bundles;
-}
-
                  -
                  -

                  Además del AcmeDemoBundle del cual ya te hemos hablado, observa que el núcleo también habilita otros paquetes como FrameworkBundle, DoctrineBundle, SwiftmailerBundle y AsseticBundle. -Todos ellos son parte del núcleo de la plataforma.

                  -
                  -
                  -

                  Configurando un paquete

                  -

                  Cada paquete se puede personalizar a través de archivos de configuración escritos en YAML, XML o PHP. Échale un vistazo a la configuración predeterminada:

                  -
                  # app/config/config.yml
-imports:
-    - { resource: parameters.yml }
-    - { resource: security.yml }
-
-framework:
-    #esi:             ~
-    #translator:      { fallback: "%locale%" }
-    secret:          "%secret%"
-    router:
-        resource: "%kernel.root_dir%/config/routing.yml"
-        strict_requirements: "%kernel.debug%"
-    form:            true
-    csrf_protection: true
-    validation:      { enable_annotations: true }
-    templating:      { engines: ['twig'] } #assets_version: SomeVersionScheme
-    default_locale:  "%locale%"
-    trusted_proxies: ~
-    session:         ~
-
-# Configuración de Twig
-twig:
-    debug:            "%kernel.debug%"
-    strict_variables: "%kernel.debug%"
-
-# Configuración de Assetic
-assetic:
-    debug:          "%kernel.debug%"
-    use_controller: false
-    bundles:        [ ]
-    #java: /usr/bin/java
-    filters:
-        cssrewrite: ~
-        #closure:
-        #    jar: "%kernel.root_dir%/Resources/java/compiler.jar"
-        #yui_css:
-        #    jar: "%kernel.root_dir%/Resources/java/yuicompressor-2.4.7.jar"
-
-# Configuración de Doctrine
-doctrine:
-    dbal:
-        driver:   "%database_driver%"
-        host:     "%database_host%"
-        port:     "%database_port%"
-        dbname:   "%database_name%"
-        user:     "%database_user%"
-        password: "%database_password%"
-        charset:  UTF8
-
-    orm:
-        auto_generate_proxy_classes: "%kernel.debug%"
-        auto_mapping: true
-
-# Configuración de Swiftmailer
-swiftmailer:
-    transport: "%mailer_transport%"
-    host:      "%mailer_host%"
-    username:  "%mailer_user%"
-    password:  "%mailer_password%"
-    spool:     { type: memory }
-
                  -
                  -

                  Cada entrada —como framework— define la configuración de un paquete específico. -Por ejemplo, framework configura el FrameworkBundle mientras que swiftmailer configura el SwiftmailerBundle.

                  -

                  Cada entorno puede reemplazar la configuración predeterminada proporcionando un archivo de configuración específico. Por ejemplo, el entorno dev carga el archivo config_dev.yml, el cual carga la configuración principal (es decir, config.yml) y luego la modifica agregando algunas herramientas de depuración:

                  -
                  # app/config/config_dev.yml
-imports:
-    - { resource: config.yml }
-
-framework:
-    router:   { resource: "%kernel.root_dir%/config/routing_dev.yml" }
-    profiler: { only_exceptions: false }
-
-web_profiler:
-    toolbar: true
-    intercept_redirects: false
-
-monolog:
-    handlers:
-        main:
-            type:  stream
-            path:  "%kernel.logs_dir%/%kernel.environment%.log"
-            level: debug
-        firephp:
-            type:  firephp
-            level: info
-
-assetic:
-    use_controller: true
-
                  -
                  -
                  -
                  -

                  Extendiendo un paquete

                  -

                  Además de ser una buena manera de organizar y configurar tu código, un paquete puede extender otro paquete. La herencia de paquetes te permite sustituir cualquier paquete existente con el fin de personalizar sus controladores, plantillas, o cualquiera de sus archivos. -Aquí es donde son útiles los nombres lógicos (por ejemplo, @AcmeDemoBundle/Controller/SecuredController.php): estos abstraen en dónde se almacena realmente el recurso.

                  -
                  -

                  Nombres lógicos de archivo

                  -

                  Cuando quieras hacer referencia a un archivo de un paquete, utiliza esta notación: -@NOMBRE_PAQUETE/ruta/al/archivo; Symfony2 resolverá @NOMBRE_PAQUETE a la ruta real del paquete. Por ejemplo, la ruta lógica @AcmeDemoBundle/Controller/DemoController.php se convierte en src/Acme/DemoBundle/Controller/DemoController.php, ya que Symfony conoce la ubicación del AcmeDemoBundle .

                  -
                  -
                  -

                  Nombres lógicos de Controlador

                  -

                  Para los controladores, necesitas hacer referencia a los nombres de método usando el formato NOMBRE_PAQUETE:NOMBRE_CONTROLADOR:NOMBRE_ACCIÓN. Por ejemplo, AcmeDemoBundle:Welcome:index representa al método indexAction de la clase Acme\DemoBundle\Controller\WelcomeController.

                  -
                  -
                  -

                  Nombres lógicos de plantilla

                  -

                  Para las plantillas, el nombre lógico AcmeDemoBundle:Welcome:index.html.twig se convierte en la ruta del archivo src/Acme/DemoBundle/Resources/views/Welcome/index.html.twig. -Incluso las plantillas son más interesantes cuando te das cuenta que no es necesario almacenarlas en el sistema de archivos. Puedes guardarlas fácilmente en una tabla de la base de datos, por ejemplo.

                  -
                  -
                  -

                  Extendiendo paquetes

                  -

                  Si sigues estas convenciones, entonces puedes utilizar herencia de paquetes para «redefinir» archivos, controladores o plantillas. Por ejemplo, puedes crear un paquete —AcmeNewBundle— y especificar que este sustituye a AcmeDemoBundle. -Cuando Symfony carga el controlador AcmeDemoBundle:Welcome:index, primero busca la clase WelcomeController en AcmeNewBundle y luego mirará en AcmeDemoBundle. Esto significa que, ¡un paquete puede redefinir casi cualquier parte de otro paquete!

                  -

                  ¿Entiendes ahora por qué Symfony2 es tan flexible? Comparte tus paquetes entre aplicaciones, guárdalas local o globalmente, tú eliges.

                  -
                  -
                  -
                  -
                  -

                  Usando vendors

                  -

                  Lo más probable es que tu aplicación dependerá de bibliotecas de terceros. Estas se deberían guardar en el directorio vendor/. Este directorio ya contiene las bibliotecas Symfony2, la biblioteca SwiftMailer, el ORM de Doctrine, el sistema de plantillas Twig y algunas otras bibliotecas y paquetes de terceros.

                  -
                  -
                  -

                  Comprendiendo la caché y los registros

                  -

                  Symfony2 probablemente es una de las plataformas más rápidas hoy día. Pero ¿cómo puede ser tan rápida si analiza e interpreta decenas de archivos YAML y XML por cada petición? La velocidad, en parte, se debe a su sistema de caché. La configuración de la aplicación sólo se analiza en la primer petición y luego se compila hasta código PHP simple y se guarda en el directorio app/cache/. En el entorno de desarrollo, Symfony2 es lo suficientemente inteligente como para vaciar la caché cuando cambias un archivo. Pero en el entorno de producción, es tu responsabilidad borrar la caché cuando actualizas o cambias tu código o configuración.

                  -

                  Al desarrollar una aplicación web, las cosas pueden salir mal de muchas formas. Los archivos de registro en el directorio app/logs/ dicen todo acerca de las peticiones y ayudan a solucionar rápidamente el problema.

                  -
                  -
                  -

                  Usando la interfaz de línea de ordenes

                  -

                  Cada aplicación incluye una herramienta de interfaz de línea de ordenes (app/console) que te ayuda a mantener la aplicación. Esta proporciona ordenes que aumentan tu productividad automatizando tediosas y repetitivas tareas.

                  -

                  Ejecútala sin argumentos para obtener más información sobre sus posibilidades:

                  -
                  $ php app/console
-
                  -
                  -

                  La opción --help te ayuda a descubrir el uso de una orden:

                  -
                  $ php app/console router:debug --help
-
                  -
                  -
                  -
                  -

                  Consideraciones finales

                  -

                  Llámame loco, pero después de leer esta parte, debes sentirte cómodo moviendo cosas y haciendo que Symfony2 trabaje por ti. Todo en Symfony2 está diseñado para allanar tu camino. Por lo tanto, no dudes en renombrar y mover directorios como mejor te parezca.

                  -

                  Y eso es todo para el inicio rápido. Desde probar hasta enviar mensajes de correo electrónico, todavía tienes que aprender mucho para convertirte en gurú de Symfony2. ¿Listo para zambullirte en estos temas ahora? No busques más — ve al Libro oficial y elije cualquier tema que desees.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/quick_tour/the_big_picture.html b/quick_tour/the_big_picture.html deleted file mode 100644 index 5432fa8..0000000 --- a/quick_tour/the_big_picture.html +++ /dev/null @@ -1,425 +0,0 @@ - - - - - - - Un primer vistazo — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Un primer vistazo

                  -

                  ¡Empieza a usar Symfony2 en 10 minutos! Este capítulo te guiará a través de algunos de los conceptos más importantes detrás de Symfony2 y explica cómo puedes empezar a trabajar rápidamente, mostrándote un sencillo proyecto en acción.

                  -

                  Si ya has usado una plataforma para desarrollo web, seguramente te sentirás a gusto con Symfony2. Si no es tu caso, ¡bienvenido a una nueva forma de desarrollar aplicaciones web!

                  -
                  -

                  Truco

                  -

                  ¿Quieres saber por qué y cuándo es necesario utilizar una plataforma? Lee el documento «Symfony en 5 minutos».

                  -
                  -
                  -

                  Descargando Symfony2

                  -

                  En primer lugar, comprueba que tienes instalado y configurado un servidor web (como Apache) con PHP 5.3.3 o superior.

                  -
                  -

                  Truco

                  -

                  Si tienes PHP 5.4, puedes usar el servidor web incorporado. El servidor incorporado se debe utilizar sólo para fines de desarrollo, pero te puede ayudar para iniciar tu proyecto sencilla y rápidamente.

                  -

                  Sólo tienes que usar esta orden para iniciar el servidor:

                  -
                  $ php -S localhost:80 -t /ruta/a/www
-
                  -
                  -

                  donde «/ruta/a/www» es la ruta a algún directorio de tu máquina en la que extrajiste Symfony por lo tanto la dirección final a tu aplicación es «http://localhost/Symfony/app_dev.php». También puedes extraer primero Symfony y luego iniciar el servidor web en el directorio «web» de Symfony. Si haces esto, la dirección URL de tu aplicación será «http://localhost/app_dev.php».

                  -
                  -

                  ¿Listo? Empecemos descargando la «edición estándar de Symfony2», una distribución de Symfony preconfigurada para la mayoría de los casos y que también contiene algún código de ejemplo que demuestra cómo utilizar Symfony2 (consigue el paquete que incluye proveedores para empezar aún más rápido).

                  -

                  Después de extraer el paquete bajo el directorio raíz del servidor web, deberías tener un directorio Symfony/ con una estructura como esta:

                  -
                  www/ <- el directorio raíz de tu servidor web
-    Symfony/ <- el archivo desempacado
-        app/
-            cache/
-            config/
-            logs/
-            Resources/
-        bin/
-        src/
-            Acme/
-                DemoBundle/
-                    Controller/
-                    Resources/
-                    ...
-        vendor/
-            symfony/
-            doctrine/
-            ...
-        web/
-            app.php
-            ...
-
                  -
                  -
                  -

                  Nota

                  -

                  Si estás familiarizado con Composer, puedes ejecutar la siguiente orden en lugar de descargar el archivo:

                  -
                  $ composer.phar create-project symfony/framework-standard-edition ruta/para/instalar 2.2.0
-
-# Elimina el historial de Git
-$ rm -rf .git
-
                  -
                  -

                  Para una versión exacta, sustituye 2.2.0 con la versión más resciente de Symfony (p. ej. 2.1.1). Para detalles, ve la Página de instalación de Symfony

                  -
                  -
                  -

                  Truco

                  -

                  Si tienes PHP 5.4, puedes usar el servidor web integrado.

                  -
                  # comprueba la configuración en la línea de ordenes PHP
-$ php ./app/check.php
-
-# ejecuta el servidor web integrado
-$ php ./app/console server:run
-
                  -
                  -

                  Entonces la URL de tu aplicación será «http://localhost:8000/app_dev.php».

                  -

                  El servidor integrado sólo se debe usar para fines de desarrollo, pero te puede ayudar para iniciar tu proyecto fácil y rápidamente.

                  -
                  -
                  -
                  -

                  Verificando tu configuración

                  -

                  Symfony2 integra una interfaz visual para probar la configuración del servidor, muy útil para solucionar problemas relacionados con el servidor Web o una incorrecta configuración de PHP. Usa la siguiente URL para examinar el diagnóstico:

                  -
                  http://localhost/config.php
-
                  -
                  -
                  -

                  Nota

                  -

                  Todas las URL del ejemplo asumen que has descargado y descomprimido Symfony directamente al directorio raíz de tu servidor web. Si seguiste las instrucciones anteriores y descomprimiste Symfony en el directorio raíz de tu servidor web, entonces añade /Symfony/web después de localhost a todas las URL que veas:

                  -
                  http://localhost/Symfony/web/config.php
-
                  -
                  -
                  -
                  -

                  Nota

                  -

                  Todas las URL del ejemplo asumen que has descargado y descomprimido Symfony directamente al directorio raíz de tu servidor web. Si seguiste las instrucciones anteriores, entonces añade /Symfony/web después de localhost a todas las URL que veas:

                  -
                  http://localhost/Symfony/web/config.php
-
                  -
                  -

                  Para conseguir bonitas y breves URL deberías apuntar el documento raíz de tu servidor web o servidor virtual al directorio Symfony/web/. En este caso, tus URL tendrán esta apariencia http://localhost/config.php o http://sitio.local/config.php, si creaste un servidor virtual en un ámbito llamado local, por ejemplo, sitio.local.

                  -
                  -

                  Si se enumeran errores o aspectos de configuración pendientes, corrígelos; Puedes realizar los ajustes siguiendo las recomendaciones. Cuando todo esté bien, haz clic en «Pospón la configuración y llévame a la página de bienvenida» para solicitar tu primera página web «real» en Symfony2:

                  -
                  http://localhost/app_dev.php/
-
                  -
                  -

                  ¡Symfony2 debería darte la bienvenida y felicitarte por tu arduo trabajo hasta el momento!

                  -../_images/welcome.png -
                  -
                  -

                  Comprendiendo los fundamentos

                  -

                  Uno de los principales objetivos de una plataforma es garantizar la separación de responsabilidades. -Esto mantiene tu código organizado y permite a tu aplicación evolucionar fácilmente en el tiempo, evitando mezclar llamadas a la base de datos, etiquetas HTML y código de la lógica del negocio en un mismo archivo. Para alcanzar este objetivo, debes aprender algunos conceptos y términos fundamentales.

                  -
                  -

                  Truco

                  -

                  ¿Quieres más pruebas de que usar una plataforma es mucho mejor que mezclar todo en un mismo archivo? Lee el capítulo del libro «Symfony2 frente a PHP simple».

                  -
                  -

                  La distribución viene con algún código de ejemplo que puedes utilizar para aprender más sobre los principales conceptos de Symfony2. Ingresa a la siguiente URL para recibir un saludo de Symfony2 (reemplaza Nacho con tu nombre):

                  -
                  http://localhost/app_dev.php/demo/hello/Nacho
-
                  -
                  -../_images/hola_nacho.png -

                  ¿Qué sucedió? Bien, diseccionemos la URL:

                  -
                    -
                  • app_dev.php: Es un controlador frontal. Es el único punto de entrada de la aplicación, mismo que responde a todas las peticiones del usuario;
                    • -
                  • /demo/hello/Nacho: Esta es la ruta virtual a los recursos que el usuario quiere acceder.
                    • -
                  -

                  Tu responsabilidad como desarrollador es escribir el código que asigna la petición del usuario (/demo/hello/Nacho) al recurso asociado con ella (la página HTML ¡Hola Nacho!).

                  -
                  -

                  Enrutando

                  -

                  Symfony2 encamina la petición al código que la maneja tratando de hacer coincidir la URL solicitada contra algunas rutas configuradas. De forma predeterminada, estas rutas están definidas en el archivo de configuración app/config/routing.yml. Cuando estás en el entorno dev —indicado por el controlador frontal app_dev.php— también se carga el archivo de configuración app/config/routing_dev.yml. En la edición estándar, las rutas a estas páginas de «demostración» se encuentran en ese archivo:

                  -
                  # app/config/routing_dev.yml
-_welcome:
-    path:  /
-    defaults: { _controller: AcmeDemoBundle:Welcome:index }
-
-_demo:
-    resource: "@AcmeDemoBundle/Controller/DemoController.php"
-    type:     annotation
-    prefix:   /demo
-
-# ...
-
                  -
                  -

                  Las primeras tres líneas (después del comentario) definen el código que se ejecuta cuando el usuario solicita el recurso «/» (es decir, la página de bienvenida que viste anteriormente). Cuando así lo solicites, el controlador AcmeDemoBundle:Welcome:index será ejecutado. En la siguiente sección, aprenderás exactamente lo que eso significa.

                  -
                  -

                  Truco

                  -

                  La edición estándar de Symfony2 utiliza YAML para sus archivos de configuración, pero Symfony2 también es compatible con XML, PHP y anotaciones nativas. Los diferentes formatos son compatibles y se pueden utilizar indistintamente en una aplicación. Además, el rendimiento de tu aplicación no depende del formato de configuración que elijas, ya que todo se memoriza en caché en la primer petición.

                  -
                  -
                  -
                  -

                  Controladores

                  -

                  «Controlador» es un nombre elegante para una función o método PHP que se encarga de las peticiones entrantes y devuelve las respuestas (a menudo código HTML). En lugar de utilizar variables globales y funciones PHP (como $_GET o header()) para manejar estos mensajes HTTP, Symfony utiliza objetos: Symfony\Component\HttpFoundation\Request y Symfony\Component\HttpFoundation\Response. El controlador más simple posible crea la respuesta a mano, basándose en la petición:

                  -
                  use Symfony\Component\HttpFoundation\Response;
-
-$name = $request->query->get('name');
-
-return new Response('Hello '.$name,
-                    200,
-                    array('Content-Type' => 'text/plain')
-           );
-
                  -
                  -
                  -

                  Nota

                  -

                  Symfony2 abarca la especificación HTTP, esta contiene las reglas que gobiernan todas las comunicaciones en la web. Lee el capítulo «Symfony2 y fundamentos HTTP» del libro para aprender más acerca de esto y la potencia que ello conlleva.

                  -
                  -

                  Symfony2 elige el controlador basándose en el valor del _controller de la configuración de enrutado: AcmeDemoBundle:Welcome:index. Esta cadena es el nombre lógico del controlador, y hace referencia al método indexAction de la clase Acme\DemoBundle\Controller\WelcomeController:

                  -
                  // src/Acme/DemoBundle/Controller/WelcomeController.php
-namespace Acme\DemoBundle\Controller;
-
-use Symfony\Bundle\FrameworkBundle\Controller\Controller;
-
-class WelcomeController extends Controller
-{
-    public function indexAction()
-    {
-        return $this->render('AcmeDemoBundle:Welcome:index.html.twig');
-    }
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  Podrías haber usado el nombre completo de la clase y método —Acme\DemoBundle\Controller\WelcomeController::indexAction— para el valor de _controller. Pero si sigues algunas simples convenciones, el nombre lógico es más conciso y te permite mayor flexibilidad.

                  -
                  -

                  La clase WelcomeController extiende la clase integrada Controller, la cual proporciona útiles atajos a métodos, como el render() que carga y reproduce una plantilla (AcmeDemoBundle:Welcome:index.html.twig). El valor devuelto es un objeto Respuesta poblado con el contenido reproducido. Por lo tanto, si surge la necesidad, la Respuesta se puede ajustar antes de enviarla al navegador:

                  -
                  public function indexAction()
-{
-    $response = $this->render('AcmeDemoBundle:Welcome:index.txt.twig');
-    $response->headers->set('Content-Type', 'text/plain');
-
-    return $response;
-}
-
                  -
                  -

                  Pero en todos los casos, el trabajo final del controlador es devolver siempre el objeto Respuesta que será entregado al usuario. Este objeto Respuesta se puede poblar con código HTML, representar una redirección al cliente, e incluso devolver el contenido de una imagen JPG con una cabecera Content-Type de image/jpg.

                  -
                  -

                  Truco

                  -

                  Derivar de la clase base Controller es opcional. De hecho, un controlador puede ser una simple función PHP e incluso un cierre PHP. -El capítulo «Controlador» del libro abarca todo sobre los controladores de Symfony2.

                  -
                  -

                  El nombre de la plantilla, AcmeDemoBundle:Welcome:index.html.twig, es el nombre lógico de la plantilla y hace referencia al archivo Resources/views/Welcome/index.html.twig dentro del AcmeDemoBundle (ubicado en src/Acme/DemoBundle). En la sección paquetes, a continuación, explicaré por qué esto es útil.

                  -

                  Ahora, de nuevo echa un vistazo a la configuración de enrutado y encuentra la clave _demo:

                  -
                  # app/config/routing_dev.yml
-_demo:
-    resource: "@AcmeDemoBundle/Controller/DemoController.php"
-    type:     annotation
-    prefix:   /demo
-
                  -
                  -

                  Symfony2 puede leer/importar la información de enrutado desde diferentes archivos escritos en YAML, XML, PHP o, incluso, incorporada en anotaciones PHP. En este caso, el nombre lógico del recurso es @AcmeDemoBundle/Controller/DemoController.php y se refiere al archivo src/Acme/DemoBundle/Controller/DemoController.php. En este archivo, las rutas se definen como anotaciones sobre los métodos de acción:

                  -
                  // src/Acme/DemoBundle/Controller/DemoController.php
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-
-class DemoController extends Controller
-{
-    /**
-     * @Route("/hello/{name}", name="_demo_hello")
-     * @Template()
-     */
-    public function helloAction($name)
-    {
-        return array('name' => $name);
-    }
-
-    // ...
-}
-
                  -
                  -

                  La anotación @Route() define una nueva ruta con la trayectoria /hello/{name} que, cuando concuerda, ejecuta el método helloAction. Una cadena encerrada entre llaves como {name} se conoce como marcador de posición. Como puedes ver, su valor se puede recuperar a través del argumento $name del método.

                  -
                  -

                  Nota

                  -

                  Incluso si las anotaciones no son compatibles nativamente en PHP, las utilizamos profusamente en Symfony2 como una conveniente manera de configurar el comportamiento de la plataforma y mantener la configuración del lado del código.

                  -
                  -

                  Si echas un vistazo más de cerca al código de la acción del controlador, puedes ver que en lugar de reproducir una plantilla y devolver un objeto Respuesta como antes, sólo devuelve un arreglo de parámetros. La anotación @Template() le dice a Symfony que reproduzca la plantilla por ti, pasando cada variable del arreglo a la plantilla. El nombre de la plantilla reproducida sigue al nombre del controlador. Por lo tanto, en este ejemplo, se reproduce la plantilla AcmeDemoBundle:Demo:hello.html.twig (ubicada en src/Acme/DemoBundle/Resources/views/Demo/hello.html.twig).

                  -
                  -

                  Truco

                  -

                  Las anotaciones @Route() y @Template() son más poderosas que lo mostrado en el ejemplo simple de esta guía. Aprende más sobre las «anotaciones en controladores» en la documentación oficial.

                  -
                  -
                  -
                  -

                  Plantillas

                  -

                  El controlador procesa la plantilla src/Acme/DemoBundle/Resources/views/Demo/hello.html.twig (o AcmeDemoBundle:Demo:hello.html.twig si utilizas el nombre lógico):

                  -
                  {# src/Acme/DemoBundle/Resources/views/Demo/hello.html.twig #}
-{% extends "AcmeDemoBundle::layout.html.twig" %}
-
-{% block title "Hello " ~ name %}
-
-{% block content %}
-    <h1>Hello {{ name }}!</h1>
-{% endblock %}
-
                  -
                  -

                  Por omisión, Symfony2 utiliza Twig como motor de plantillas, pero también puede utilizar plantillas PHP tradicionales si lo deseas. El siguiente capítulo es una introducción a cómo trabajan las plantillas en Symfony2.

                  -
                  -
                  -

                  Paquetes

                  -

                  Posiblemente te hayas preguntado por qué la palabra bundle (paquete en adelante), se utiliza en muchos de los nombres que hemos visto hasta ahora. Todo el código que escribas para tu aplicación está organizado en paquetes. Hablando en Symfony2, un paquete es un conjunto estructurado de archivos (archivos PHP, hojas de estilo, JavaScript, imágenes, ...) que implementa una sola característica (un blog, un foro, ...) y que fácilmente se puede compartir con otros desarrolladores. Hasta ahora, solo has manipulado un paquete, AcmeDemoBundle. Aprenderás más acerca de los paquetes en el último capítulo de esta guía.

                  -
                  -
                  -
                  -

                  Trabajando con entornos

                  -

                  Ahora que tienes una mejor comprensión de cómo funciona Symfony2, dale una mirada más atenta a la parte inferior de cualquier página reproducida por Symfony2. Deberás notar una pequeña barra con el logotipo de Symfony2. Esta se conoce como la «barra de depuración web» y es la mejor amiga del desarrollador.

                  -../_images/web_debug_toolbar_es.png -

                  Pero lo que ves al principio es sólo la punta del iceberg; haz clic en el extraño número hexadecimal para revelar otra muy útil herramienta de depuración de Symfony2: -el generador de perfiles.

                  -../_images/profiler_es.png -
                  -

                  Nota

                  -

                  Puedes conseguir más información rápidamente manteniendo el puntero del ratón sobre los elementos en la barra de depuración Web.

                  -
                  -

                  Por supuesto, no querrás mostrar estas herramientas al desplegar tu aplicación en producción. Es por eso que encontrarás otro controlador frontal en el directorio web/ (app.php), el cual está optimizado para el entorno de producción:

                  -
                  http://localhost/app.php/demo/hello/Fabien
-
                  -
                  -

                  Y si utilizas Apache con mod_rewrite habilitado, incluso puedes omitir la parte app.php de la URL:

                  -
                  http://localhost/demo/hello/Nacho
-
                  -
                  -

                  Por último pero no menos importante, en los servidores en producción, debes apuntar tu directorio web raíz al directorio web/ para proteger tu instalación e incluso, para que tus URL tengan un mejor aspecto:

                  -
                  http://localhost/demo/hello/Nacho
-
                  -
                  -
                  -

                  Nota

                  -

                  Ten en cuenta que las tres direcciones URL anteriores sólo se proporcionan aquí como ejemplos de cómo se ve una URL al utilizar el controlador frontal de producción (con o sin mod_rewrite). Si realmente lo intentas en una instalación de la edición estándar de Symfony, fuera de la caja obtendrás un error 404 puesto que AcmeDemoBundle sólo se activa en el entorno de desarrollo e importa sus rutas en app/config/routing_dev.yml.

                  -
                  -

                  Para hacer que tu aplicación responda más rápido, Symfony2 mantiene una caché en el directorio app/cache/. En el entorno de desarrollo (app_dev.php), esta caché se vacía automáticamente cada vez que realizas cambios en cualquier código o configuración. Pero ese no es el caso en el entorno de producción (app.php) donde el rendimiento es clave. Es por eso que siempre debes utilizar el entorno de desarrollo al estar desarrollando tu aplicación.

                  -

                  Diferentes entornos de una determinada aplicación sólo se diferencian en su configuración. De hecho, una configuración puede heredar de otra:

                  -
                  # app/config/config_dev.yml
-imports:
-    - { resource: config.yml }
-
-web_profiler:
-    toolbar: true
-    intercept_redirects: false
-
                  -
                  -

                  El entorno dev (el cual carga el archivo de configuración config_dev.yml) importa el archivo global config.yml y luego lo modifica, en este ejemplo, activando la barra de herramientas para depuración web.

                  -
                  -
                  -

                  Consideraciones finales

                  -

                  ¡Enhorabuena! Has tenido tu primera experiencia codificando en Symfony2. No fue tan difícil, ¿cierto? Hay mucho más por explorar, pero ya debes tener una idea de cómo Symfony2 facilita la implementación de mejores y más rápidos sitios web. Si estás interesado en aprender más acerca de Symfony2, sumérgete en la siguiente sección: -«La vista».

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/quick_tour/the_controller.html b/quick_tour/the_controller.html deleted file mode 100644 index 1ee1b0a..0000000 --- a/quick_tour/the_controller.html +++ /dev/null @@ -1,352 +0,0 @@ - - - - - - - El controlador — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El controlador

                  -

                  ¿Todavía aquí después de las dos primeras partes? ¡Ya te estás volviendo adicto a Symfony2! Sin más preámbulos, descubre lo que pueden hacer por ti los controladores.

                  -
                  -

                  Usando Formatos

                  -

                  Hoy día, una aplicación web debe ser capaz de ofrecer algo más que solo páginas HTML. Desde XML para alimentadores RSS o Servicios Web, hasta JSON para peticiones Ajax, hay un montón de formatos diferentes a elegir. Apoyar estos formatos en Symfony2 es sencillo. Modifica la ruta añadiendo un valor predeterminado de xml a la variable _format:

                  -
                  // src/Acme/DemoBundle/Controller/DemoController.php
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-
-// ...
-
-/**
- * @Route("/hello/{name}", defaults={"_format"="xml"}, name="_demo_hello")
- * @Template()
- */
-public function helloAction($name)
-{
-    return array('name' => $name);
-}
-
                  -
                  -

                  Al utilizar el formato de la petición (como lo define el valor _format), Symfony2 automáticamente selecciona la plantilla adecuada, aquí hello.xml.twig:

                  -
                  <!-- src/Acme/DemoBundle/Resources/views/Demo/hello.xml.twig -->
-<hello>
-    <name>{{ name }}</name>
-</hello>
-
                  -
                  -

                  Eso es todo lo que hay que hacer. Para los formatos estándar, Symfony2 también elije automáticamente la mejor cabecera Content-Type para la respuesta. Si quieres apoyar diferentes formatos para una sola acción, en su lugar, usa el marcador de posición {_format} en el patrón de la ruta:

                  -
                  // src/Acme/DemoBundle/Controller/DemoController.php
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-
-// ...
-
-/**
- * @Route("/hello/{name}.{_format}", defaults={"_format"="html"}, ↓
-          requirements={"_format"="html|xml|json"}, name="_demo_hello")
- * @Template()
- */
-public function helloAction($name)
-{
-    return array('name' => $name);
-}
-
                  -
                  -

                  El controlador ahora será llamado por la URL como /demo/hello/Fabien.xml o /demo/hello/Fabien.json.

                  -

                  La entrada requirements define las expresiones regulares con las cuales los marcadores de posición deben coincidir. En este ejemplo, si tratas de solicitar el recurso /demo/hello/Fabien.js, obtendrás un error HTTP 404, ya que no coincide con el requisito de _format.

                  -
                  -
                  -

                  Redirigiendo y reenviando

                  -

                  Si deseas redirigir al usuario a otra página, utiliza el método redirect():

                  -
                  return $this->redirect($this->generateUrl('_demo_hello',
-                                          array('name' => 'Lucas')
-                              )
-       );
-
                  -
                  -

                  El método generateUrl() es el mismo que la función path() utilizada en las plantillas. Este toma el nombre de la ruta y una serie de parámetros como argumentos y devuelve la URL amigable asociada.

                  -

                  Además, fácilmente puedes reenviar a otra acción con el método forward(). Internamente, Symfony hace una «subpetición», y devuelve el objeto Respuesta desde la subpetición:

                  -
                  $response = $this->forward('AcmeDemoBundle:Hello:fancy',
-                           array('name' => $name,
-                                 'color' => 'green'
-                           )
-            );
-
-// ... hace algo con la respuesta o la devuelve directamente
-
                  -
                  -
                  -
                  -

                  Obteniendo información de la petición

                  -

                  Además del valor de los marcadores de posición de enrutado, el controlador también tiene acceso al objeto Petición:

                  -
                  $request = $this->getRequest();
-
-$request->isXmlHttpRequest(); // ¿es una petición Ajax?
-
-$request->getPreferredLanguage(array('en', 'fr'));
-
-$request->query->get('page'); // obtiene un parámetro $_GET
-
-$request->request->get('page'); // obtiene un parámetro $_POST
-
                  -
                  -

                  En una plantilla, también puedes acceder al objeto Petición por medio de la variable app.request:

                  -
                  {{ app.request.query.get('pag') }}
-
-{{ app.request.parameter('pag') }}
-
                  -
                  -
                  -
                  -

                  Persistiendo datos en la sesión

                  -

                  Aunque el protocolo HTTP es sin estado, Symfony2 proporciona un agradable objeto sesión que representa al cliente (sea una persona real usando un navegador, un robot o un servicio web). Entre dos peticiones, Symfony2 almacena los atributos en una cookie usando las sesiones nativas de PHP.

                  -

                  Almacenar y recuperar información de la sesión se puede conseguir fácilmente desde cualquier controlador:

                  -
                  $session = $this->getRequest()->getSession();
-
-// guarda un atributo para reutilizarlo durante una
-// posterior petición del usuario
-$session->set('foo', 'bar');
-
-// en otro controlador por otra petición
-$foo = $session->get('foo');
-
-// usa un valor predefinido si la clave no existe
-$filters = $session->set('filters', array());
-
                  -
                  -

                  También puedes almacenar pequeños mensajes que sólo estarán disponibles para la siguiente petición:

                  -
                  // almacena un mensaje para la próxima petición (en un controlador)
-$session->getFlashBag()->add('notice',
-                             'Congratulations, your action succeeded!'
-                         );
-
-// muestra algún mensaje en la próxima petición (en una plantilla)
-
-{% for flashMessage in app.session.flashbag.get('notice') %}
-    <div>{{ flashMessage }}</div>
-{% endfor %}
-
                  -
                  -

                  Esto es útil cuando es necesario configurar un mensaje de éxito antes de redirigir al usuario a otra página (la cual entonces mostrará el mensaje). Por favor, ten en cuenta que cuándo utilizas has() en vez de get(), el mensaje flash no será limpiado y por lo tanto queda disponible para las siguientes peticiones.

                  -
                  -
                  -

                  Protegiendo recursos

                  -

                  La edición estándar de Symfony viene con una configuración de seguridad sencilla, adaptada a las necesidades más comunes:

                  -
                  # app/config/security.yml
-security:
-    encoders:
-        Symfony\Component\Security\Core\User\User: plaintext
-
-    role_hierarchy:
-        ROLE_ADMIN:       ROLE_USER
-        ROLE_SUPER_ADMIN: [ROLE_USER, ROLE_ADMIN, ROLE_ALLOWED_TO_SWITCH]
-
-    providers:
-        in_memory:
-            memory:
-                users:
-                    user:  { password: userpass, roles: [ 'ROLE_USER' ] }
-                    admin: { password: adminpass, roles: [ 'ROLE_ADMIN' ] }
-
-    firewalls:
-        dev:
-            pattern:  ^/(_(profiler|wdt)|css|images|js)/
-            security: false
-
-        login:
-            pattern:  ^/demo/secured/login$
-            security: false
-
-        secured_area:
-            pattern:    ^/demo/secured/
-            form_login:
-                check_path: /demo/secured/login_check
-                login_path: /demo/secured/login
-            logout:
-                path:   /demo/secured/logout
-                target: /demo/
-
                  -
                  -

                  Esta configuración requiere que los usuarios inicien sesión para cualquier URL que comience con /demo/secured/ y define dos usuarios válidos: user y admin. -Por otra parte, el usuario admin tiene un rol ROLE_ADMIN, el cual incluye el rol ROLE_USER también (consulta el ajuste role_hierarchy).

                  -
                  -

                  Truco

                  -

                  Para facilitar la lectura, las contraseñas se almacenan en texto plano en esta configuración simple, pero puedes usar cualquier algoritmo de codificación ajustando la sección encoders.

                  -
                  -

                  Al ir a la dirección http://localhost/app_dev.php/demo/secured/hello automáticamente te redirigirá al formulario de acceso, porque el recurso está protegido por un cortafuegos.

                  -

                  También puedes forzar la acción para exigir un determinado rol usando la anotación @Secure en el controlador:

                  -
                  use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-use JMS\SecurityExtraBundle\Annotation\Secure;
-
-/**
- * @Route("/hello/admin/{name}", name="_demo_secured_hello_admin")
- * @Secure(roles="ROLE_ADMIN")
- * @Template()
- */
-public function helloAdminAction($name)
-{
-    return array('name' => $name);
-}
-
                  -
                  -

                  Ahora, inicia sesión como user (el cual no tiene el rol ROLE_ADMIN) y desde la página protegida hello, haz clic en el enlace «Hola recurso protegido». -Symfony2 debe devolver un código de estado HTTP 403, el cual indica que el usuario tiene «prohibido» el acceso a ese recurso.

                  -
                  -

                  Nota

                  -

                  La capa de seguridad de Symfony2 es muy flexible y viene con muchos proveedores de usuario diferentes (por ejemplo, uno para el ORM de Doctrine) y proveedores de autenticación (como HTTP básica, suma de comprobación HTTP o certificados X509). Lee el capítulo «Seguridad» del libro para más información en cómo se usa y configura.

                  -
                  -
                  -
                  -

                  Memorizando recursos en caché

                  -

                  Tan pronto como tu sitio web comience a generar más tráfico, tendrás que evitar se genere el mismo recurso una y otra vez. Symfony2 utiliza cabeceras de caché HTTP para administrar los recursos en caché. Para estrategias de memorización en caché simples, utiliza la conveniente anotación @Cache():

                  -
                  use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Cache;
-
-/**
- * @Route("/hello/{name}", name="_demo_hello")
- * @Template()
- * @Cache(maxage="86400")
- */
-public function helloAction($name)
-{
-    return array('name' => $name);
-}
-
                  -
                  -

                  En este ejemplo, el recurso se mantiene en caché por un día. Pero también puedes utilizar validación en lugar de caducidad o una combinación de ambas, si se ajusta mejor a tus necesidades.

                  -

                  El recurso memorizado en caché es gestionado por el delegado inverso integrado en Symfony2. Pero debido a que la memorización en caché se gestiona usando cabeceras de caché HTTP normales, puedes sustituir el delegado inverso integrado, con Varnish o Squid y escalar tu aplicación fácilmente.

                  -
                  -

                  Nota

                  -

                  Pero ¿qué pasa si no puedes guardar en caché todas las páginas? Symfony2 todavía tiene la solución vía ESI (Edge Side Includes o Inclusión de borde lateral), con la cual es compatible nativamente. Consigue más información leyendo el capítulo «Caché HTTP» del libro.

                  -
                  -
                  -
                  -

                  Consideraciones finales

                  -

                  Eso es todo lo que hay que hacer, y ni siquiera estoy seguro de que hayan pasado los 10 minutos completos. En la primera parte te presentamos brevemente los paquetes, y todas las características que hemos explorado hasta ahora son parte del paquete básico de la plataforma. -Pero gracias a los paquetes, todo en Symfony2 se puede extender o sustituir. -Ese, es el tema de la siguiente parte de esta guía.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/quick_tour/the_view.html b/quick_tour/the_view.html deleted file mode 100644 index 6102582..0000000 --- a/quick_tour/the_view.html +++ /dev/null @@ -1,338 +0,0 @@ - - - - - - - La vista — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  La vista

                  -

                  Después de leer la primera parte de esta guía, has decidido que bien valen la pena otros 10 minutos en Symfony2. ¡Buena elección! En esta segunda parte, aprenderás más sobre el motor de plantillas de Symfony2, Twig. Twig es un motor de plantillas flexible, rápido y seguro para PHP. Este hace tus plantillas más legibles y concisas; además de hacerlas más amigables para los diseñadores web.

                  -
                  -

                  Nota

                  -

                  En lugar de Twig, también puedes utilizar PHP para tus plantillas. Ambos motores de plantillas son compatibles con Symfony2.

                  -
                  -
                  -

                  Familiarizándote con Twig

                  -
                  -

                  Truco

                  -

                  Si quieres aprender Twig, es altamente recomendable que leas su documentación oficial. Esta sección es sólo una descripción rápida de los principales conceptos.

                  -
                  -

                  Una plantilla Twig es un archivo de texto que puede generar cualquier tipo de contenido (HTML, XML, CSV, LaTeX, ...). Twig define dos tipos de delimitadores:

                  -
                    -
                  • {{ ... }}: Imprime una variable o el resultado de una expresión;
                    • -
                  • {% ... %}: Controla la lógica de la plantilla; se utiliza para ejecutar bucles for y declaraciones if, por ejemplo.
                    • -
                  -

                  A continuación tienes una plantilla mínima que ilustra algunos conceptos básicos, usa dos variables page_title y navigation, las cuales se deben pasar a la plantilla:

                  -
                  <!DOCTYPE html>
-    <html>
-        <head>
-        <title>{{ page_title }}</title>
-        </head>
-        <body>
-        <h1>{{ page_title }}</h1>
-
-        <ul id="navigation">
-            {% for item in navigation %}
-                <li><a href="{{ item.href }}">{{ item.caption }}</a></li>
-            {% endfor %}
-        </ul>
-    </body>
-</html>
-
                  -
                  -
                  -

                  Truco

                  -

                  Puedes incluir comentarios dentro de las plantillas con el delimitador {# ... #}.

                  -
                  -

                  Para reproducir una plantilla en Symfony, utiliza el método render dentro de un controlador, suministrando cualquier variable necesaria en la plantilla:

                  -
                  $this->render('AcmeDemoBundle:Demo:hello.html.twig',
-              array(
-                    'name' => $name,
-              )
-);
-
                  -
                  -

                  Las variables pasadas a una plantilla pueden ser cadenas, arreglos e incluso objetos. Twig abstrae la diferencia entre ellas y te permite acceder a los «atributos» de una variable con la notación de punto (.):

                  -
                  {# array('name' => 'Fabien') #}
-{{ name }}
-
-{# array('user' => array('name' => 'Fabien')) #}
-{{ user.name }}
-
-{# obliga a verlo como arreglo #}
-{{ user['name'] }}
-
-{# array('user' => new User('Fabien')) #}
-{{ user.name }}
-{{ user.getName }}
-
-{# obliga a ver el nombre como método #}
-{{ user.name() }}
-{{ user.getName() }}
-
-{# pasa argumentos al método #}
-{{ user.date('Y-m-d') }}
-
                  -
                  -
                  -

                  Nota

                  -

                  Es importante saber que las llaves no son parte de la variable, sino de la declaración de impresión. Si accedes a variables dentro de las etiquetas no las envuelvas con llaves.

                  -
                  -
                  -
                  -

                  Decorando plantillas

                  -

                  Muy a menudo, las plantillas en un proyecto comparten elementos comunes, como los bien conocidos encabezados y pies de página. En Symfony2, piensas en este problema de manera diferente: una plantilla se puede decorar con otra. Esto funciona exactamente igual que las clases PHP: La herencia de plantillas te permite crear un «esqueleto» de plantilla base que contenga todos los elementos comunes de tu sitio y define los bloques que las plantillas descendientes pueden sustituir.

                  -

                  La plantilla hello.html.twig hereda de layout.html.twig, gracias a la etiqueta extends:

                  -
                  {# src/Acme/DemoBundle/Resources/views/Demo/hello.html.twig #}
-{% extends "AcmeDemoBundle::layout.html.twig" %}
-
-{% block title "Hello " ~ name %}
-
-{% block content %}
-    <h1>Hello {{ name }}!</h1>
-{% endblock %}
-
                  -
                  -

                  La notación AcmeDemoBundle::layout.html.twig te suena familiar, ¿no es cierto? -Es la misma notación utilizada para hacer referencia a una plantilla regular. La parte :: simplemente significa que el elemento controlador está vacío, por lo tanto el archivo correspondiente se almacena directamente bajo el directorio Resources/views/.

                  -

                  Ahora, echemos un vistazo a un layout.html.twig simplificado:

                  -
                  {# src/Acme/DemoBundle/Resources/views/layout.html.twig #}
-<div class="symfony-content">
-    {% block content %}
-    {% endblock %}
-</div>
-
                  -
                  -

                  La etiqueta {% block %} define bloques que las plantillas derivadas pueden -llenar. Todas las etiquetas de bloque le dicen al motor de plantillas que una -plantilla derivada puede reemplazar esas porciones de la plantilla.

                  -

                  En este ejemplo, la plantilla hello.html.twig sustituye el bloque content, lo cual significa que el texto «Hello Fabien» se dibuja dentro del elemento div.symfony-content.

                  -
                  -
                  -

                  Usando etiquetas, filtros y funciones

                  -

                  Una de las mejores características de Twig es su extensibilidad a través de etiquetas, filtros y funciones. Symfony2 viene empacado con muchas de estas integradas para facilitar el trabajo del diseñador de la plantilla.

                  -
                  -

                  Incluyendo otras plantillas

                  -

                  La mejor manera de compartir un fragmento de código entre varias plantillas diferentes es crear una nueva plantilla, que luego puedas incluir en otras plantillas.

                  -

                  Crea una plantilla embedded.html.twig:

                  -
                  {# src/Acme/DemoBundle/Resources/views/Demo/embedded.html.twig #}
-Hello {{ name }}
-
                  -
                  -

                  Y cambia la plantilla index.html.twig para incluirla:

                  -
                  {# src/Acme/DemoBundle/Resources/views/Demo/hello.html.twig #}
-{% extends "AcmeDemoBundle::layout.html.twig" %}
-
-{# sustituye el bloque 'content' por embedded.html.twig #}
-{% block content %}
-    {{ include("AcmeDemoBundle:Demo:embedded.html.twig") }}
-{% endblock %}
-
                  -
                  -
                  -
                  -

                  Integrando otros controladores

                  -

                  ¿Y si deseas incrustar el resultado de otro controlador en una plantilla? -Eso es muy útil cuando se trabaja con Ajax, o cuando la plantilla incrustada necesita alguna variable que no está disponible en la plantilla principal.

                  -

                  Supón que has creado un método controlador fancyAction, y lo quieres «reproducir» dentro de la plantilla index, lo que significa incluir el resultado (por ejemplo, el HTML) del controlador. Para ello, usa la función render:

                  -
                  {# src/Acme/DemoBundle/Resources/views/Demo/index.html.twig #}
-{{ render(controller("AcmeDemoBundle:Demo:fancy", {'name': name, 'color': 'green'})) }}
-
                  -
                  -

                  Aquí, la cadena AcmeDemoBundle:Demo:fancy se refiere a la acción fancy del controlador Demo. Los argumentos (name y color) actúan como variables de la petición simulada (como si fancyAction estuviera manejando una petición completamente nueva) y se ponen a disposición del controlador:

                  -
                  // src/Acme/DemoBundle/Controller/DemoController.php
-
-class DemoController extends Controller
-{
-    public function fancyAction($name, $color)
-    {
-        // crea algún objeto, basándose en la variable $color
-        $object = ...;
-
-        return $this->render('AcmeDemoBundle:Demo:fancy.html.twig', array(
-            'name' => $name,
-            'object' => $object,
-        ));
-    }
-
-    // ...
-}
-
                  -
                  -
                  -
                  -

                  Creando enlaces entre páginas

                  -

                  Hablando de aplicaciones web, forzosamente tienes que crear enlaces entre páginas. En lugar de codificar las URL en las plantillas, la función path sabe cómo generar URL basándose en la configuración de enrutado. De esta manera, todas tus URL se pueden actualizar fácilmente con sólo cambiar la configuración:

                  -
                  <a href="{{ path('_demo_hello', { 'name': 'Thomas' }) }}">Greet Thomas!</a>
-
                  -
                  -

                  La función path toma el nombre de la ruta y un arreglo de parámetros como argumentos. El nombre de la ruta es la clave principal con la cual se hace referencia a las rutas y los parámetros son los valores de los marcadores de posición definidos en el patrón de la ruta:

                  -
                  // src/Acme/DemoBundle/Controller/DemoController.php
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route;
-use Sensio\Bundle\FrameworkExtraBundle\Configuration\Template;
-
-// ...
-
-/**
- * @Route("/hello/{name}", name="_demo_hello")
- * @Template()
- */
-public function helloAction($name)
-{
-    return array('name' => $name);
-}
-
                  -
                  -
                  -

                  Truco

                  -

                  La función url genera URL absolutas: {{ url('_demo_hello', { -'name': 'Thomas'}) }}.

                  -
                  -
                  -
                  -

                  Incluyendo activos: imágenes, JavaScript y hojas de estilo

                  -

                  ¿Qué sería de Internet sin imágenes, JavaScript y hojas de estilo? -Symfony2 proporciona la función asset para hacerles frente fácilmente:

                  -
                  <link href="{{ asset('css/blog.css') }}" rel="stylesheet" type="text/css" />
-
-<img src="{{ asset('images/logo.png') }}" />
-
                  -
                  -

                  El propósito principal de la función asset es hacer más portátil tu aplicación. -Gracias a esta función, puedes mover el directorio raíz de la aplicación a cualquier lugar bajo tu directorio web raíz sin cambiar nada en el código de tus plantillas.

                  -
                  -
                  -
                  -

                  Escapando variables

                  -

                  Twig está configurado para escapar automáticamente toda su producción. Lee la documentación de Twig para obtener más información sobre el mecanismo de escape y la extensión Escaper.

                  -
                  -
                  -

                  Consideraciones finales

                  -

                  Twig es simple pero potente. Gracias a los diseños, bloques, plantillas e inclusión de acciones, es muy fácil organizar tus plantillas de manera lógica y extensible. Sin embargo, si no te sientes cómodo con Twig, siempre puedes utilizar las plantillas PHP dentro de Symfony sin ningún problema.

                  -

                  Sólo has estado trabajando con Symfony2 durante unos 20 minutos, pero ya puedes hacer cosas muy sorprendentes con él. Ese es el poder de Symfony2. Aprender los conceptos básicos es fácil, y pronto aprenderás que esta simplicidad está escondida bajo una arquitectura muy flexible.

                  -

                  Pero me estoy adelantando demasiado. En primer lugar, necesitas aprender más sobre el controlador y ese exactamente es el tema de la siguiente parte de esta guía. -¿Listo para otros 10 minutos con Symfony2?

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/assetic.html b/reference/configuration/assetic.html deleted file mode 100644 index 2b106bf..0000000 --- a/reference/configuration/assetic.html +++ /dev/null @@ -1,232 +0,0 @@ - - - - - - - Referencia de la configuración de AsseticBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Referencia de la configuración de AsseticBundle

                  -
                  -

                  Configuración predeterminada completa

                  -
                  -
                    -
                  • YAML
                    assetic:
-    debug:                "%kernel.debug%"
-    use_controller:
-        enabled:              "%kernel.debug%"
-        profiler:             false
-    read_from:            "%kernel.root_dir%/../web"
-    write_to:             "%assetic.read_from%"
-    java:                 /usr/bin/java
-    node:                 /usr/bin/node
-    ruby:                 /usr/bin/ruby
-    sass:                 /usr/bin/sass
-    # Un par clave-valor de cualquier cantidad de nombres de elementos
-    variables:
-        un_nombre:                 []
-    bundles:
-
-        # Predeterminados (todos los paquetes registrados actualmente):
-        - FrameworkBundle
-        - SecurityBundle
-        - TwigBundle
-        - MonologBundle
-        - SwiftmailerBundle
-        - DoctrineBundle
-        - AsseticBundle
-        - ...
-    assets:
-        # Un arreglo de nombres de activos (p. ej. un_activo, otro_activo)
-        un_activo:
-            inputs:               []
-            filters:              []
-            options:
-                # Un arreglo clave-valor de opciones y valores
-                un_nombre_de_opcion: []
-    filters:
-
-        # Un arreglo de nombres de filtro (p. ej. un_filtro, otro_filtro)
-        un_filtro:                 []
-    twig:
-        functions:
-            # Un arreglo de nombres de función (p. ej.
-            # una_funcion, otra_funcion)
-            una_funcion:                 []
-
                    -
                    -
                    • -
                  • XML
                    <assetic:config
-    debug="%kernel.debug%"
-    use-controller="%kernel.debug%"
-    read-from="%kernel.root_dir%/../web"
-    write-to="%assetic.read_from%"
-    java="/usr/bin/java"
-    node="/usr/bin/node"
-    sass="/usr/bin/sass"
->
-    <!-- Predeterminados (todos los paquetes registrados actualmente) -->
-    <assetic:bundle>FrameworkBundle</assetic:bundle>
-    <assetic:bundle>SecurityBundle</assetic:bundle>
-    <assetic:bundle>TwigBundle</assetic:bundle>
-    <assetic:bundle>MonologBundle</assetic:bundle>
-    <assetic:bundle>SwiftmailerBundle</assetic:bundle>
-    <assetic:bundle>DoctrineBundle</assetic:bundle>
-    <assetic:bundle>AsseticBundle</assetic:bundle>
-    <assetic:bundle>...</assetic:bundle>
-
-    <assetic:asset>
-        <!-- prototipo -->
-        <assetic:name>
-            <assetic:input />
-
-            <assetic:filter />
-
-            <assetic:option>
-                <!-- prototipo -->
-                <assetic:name />
-            </assetic:option>
-        </assetic:name>
-    </assetic:asset>
-
-    <assetic:filter>
-        <!-- prototipo -->
-        <assetic:name />
-    </assetic:filter>
-
-    <assetic:twig>
-        <assetic:functions>
-            <!-- prototipo -->
-            <assetic:name />
-        </assetic:functions>
-    </assetic:twig>
-
-</assetic:config>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/doctrine.html b/reference/configuration/doctrine.html deleted file mode 100644 index 5664e77..0000000 --- a/reference/configuration/doctrine.html +++ /dev/null @@ -1,488 +0,0 @@ - - - - - - - Referencia de configuración de Doctrine — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Referencia de configuración de Doctrine

                  -
                  -
                    -
                  • YAML
                    doctrine:
-    dbal:
-        default_connection:   default
-        types:
-            # Una colección de tipos personalizados
-            # Ejemplo
-            un_tipo_personalizado:
-                class:                Acme\HelloBundle\MiTipoPersonalizado
-                commented:            true
-
-        connections:
-            default:
-                dbname:               database
-
-            # Una colección de diferentes nombres de conexión (p. ej. default, conn2, etc.)
-            default:
-                dbname:               ~
-                host:                 localhost
-                port:                 ~
-                user:                 root
-                password:             ~
-                charset:              ~
-                path:                 ~
-                memory:               ~
-
-                # El conector usado por MySQL
-                unix_socket:          ~
-
-                # true para que el controlador ibm_db2 la utilice como conexión persistente
-                persistent:           ~
-
-                # El protocolo que utilizará el controlador ibm_db2 (predefinido a TCPIP si se omite)
-                protocol:             ~
-
-                # true para usar dbname como nombre de servicio en vez del SID para Oracle
-                service:              ~
-
-                # El modo de sesión que usará el controlador oci8
-                sessionMode:          ~
-
-                # True para usar un servidor agrupado con el controlador oci8
-                pooled:               ~
-
-                # Configurando MultipleActiveResultSets para el controlador pdo_sqlsrv
-                MultipleActiveResultSets:  ~
-                driver:               pdo_mysql
-                platform_service:     ~
-                logging:              %kernel.debug%
-                profiling:            %kernel.debug%
-                driver_class:         ~
-                wrapper_class:        ~
-                options:
-                    # Un arreglo de opciones
-                    key:                  []
-                mapping_types:
-                    # un arreglo de tipos asignados
-                    name:                 []
-                slaves:
-
-                    # una colección de nombres de conexión esclavas (p. ej. slave1, slave2)
-                    slave1:
-                        dbname:               ~
-                        host:                 localhost
-                        port:                 ~
-                        user:                 root
-                        password:             ~
-                        charset:              ~
-                        path:                 ~
-                        memory:               ~
-
-                        # El conector usado por MySQL
-                        unix_socket:          ~
-
-                        # True para usarla como conexión persistente para el controlador ibm_db2
-                        persistent:           ~
-
-                        # El protocolo que utilizará el controlador ibm_db2 (predefinido a TCPIP si se omite)
-                        protocol:             ~
-
-                        # True para usar dbname como un nombre de servicio en vez de SID para Oracle
-                        service:              ~
-
-                        # El modo de sesión que usará el controlador oci8
-                        sessionMode:          ~
-
-                        # True para usar un servidor agrupado con el controlador oci8
-                        pooled:               ~
-
-                        # Configurando MultipleActiveResultSets para el controlador pdo_sqlsrv
-                        MultipleActiveResultSets:  ~
-
-    orm:
-        default_entity_manager:  ~
-        auto_generate_proxy_classes:  false
-        proxy_dir:            %kernel.cache_dir%/doctrine/orm/Proxies
-        proxy_namespace:      Proxies
-        # busca la clase "ResolveTargetEntityListener" para una receta sobre este
-        resolve_target_entities: []
-        entity_managers:
-            # Una colección de diferentes nombres de gestores de entidad (p. ej. un_em, otro_em)
-            some_em:
-                query_cache_driver:
-                    type:                 array # Requerido
-                    host:                 ~
-                    port:                 ~
-                    instance_class:       ~
-                    class:                ~
-                metadata_cache_driver:
-                    type:                 array # Requerido
-                    host:                 ~
-                    port:                 ~
-                    instance_class:       ~
-                    class:                ~
-                result_cache_driver:
-                    type:                 array # Requerido
-                    host:                 ~
-                    port:                 ~
-                    instance_class:       ~
-                    class:                ~
-                connection:           ~
-                class_metadata_factory_name:  Doctrine\ORM\Mapping\ClassMetadataFactory
-                default_repository_class:  Doctrine\ORM\EntityRepository
-                auto_mapping:         false
-                hydrators:
-
-                    # Un arreglo de nombres de hidratantes
-                    hydrator_name:                 []
-                mappings:
-                    # Un arreglo de asignaciones, que puede ser un nombre de paquete o algo más
-                    mapping_name:
-                        mapping:              true
-                        type:                 ~
-                        dir:                  ~
-                        alias:                ~
-                        prefix:               ~
-                        is_bundle:            ~
-                dql:
-                    # Una colección de funciones de cadena
-                    string_functions:
-                        # ejemplo
-                        # test_string: Acme\HelloBundle\DQL\StringFunction
-
-                    # Una colección de funciones numéricas
-                    numeric_functions:
-                        # ejemplo
-                        # test_numeric: Acme\HelloBundle\DQL\NumericFunction
-
-                    # Una colección de funciones datetime
-                    datetime_functions:
-                        # ejemplo
-                        # test_datetime: Acme\HelloBundle\DQL\DatetimeFunction
-
-                # Filtros SQL registrados en el gestor de la entidad
-                filters:
-                    # Un arreglo de filtros
-                    un_filtro:
-                        class:                ~ # Requerido
-                        enabled:              false
                    -
                    -
                    • -
                  • XML
                    <container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:doctrine="http://symfony.com/schema/dic/doctrine"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd">
-
-    <doctrine:config>
-        <doctrine:dbal default-connection="default">
-            <doctrine:connection
-                name="default"
-                dbname="database"
-                host="localhost"
-                port="1234"
-                user="user"
-                password="secret"
-                driver="pdo_mysql"
-                driver-class="MyNamespace\MyDriverImpl"
-                path="%kernel.data_dir%/data.sqlite"
-                memory="true"
-                unix-socket="/tmp/mysql.sock"
-                wrapper-class="MyDoctrineDbalConnectionWrapper"
-                charset="UTF8"
-                logging="%kernel.debug%"
-                platform-service="MyOwnDatabasePlatformService"
-            >
-                <doctrine:option key="foo">bar</doctrine:option>
-                <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
-            </doctrine:connection>
-            <doctrine:connection name="conn1" />
-            <doctrine:type name="custom">Acme\HelloBundle\MyCustomType</doctrine:type>
-        </doctrine:dbal>
-
-        <doctrine:orm default-entity-manager="default" auto-generate-proxy-classes="false" proxy-namespace="Proxies" proxy-dir="%kernel.cache_dir%/doctrine/orm/Proxies">
-            <doctrine:entity-manager name="default" query-cache-driver="array" result-cache-driver="array" connection="conn1" class-metadata-factory-name="Doctrine\ORM\Mapping\ClassMetadataFactory">
-                <doctrine:metadata-cache-driver type="memcache" host="localhost" port="11211" instance-class="Memcache" class="Doctrine\Common\Cache\MemcacheCache" />
-                <doctrine:mapping name="AcmeHelloBundle" />
-                <doctrine:dql>
-                    <doctrine:string-function name="test_string>Acme\HelloBundle\DQL\StringFunction</doctrine:string-function>
-                    <doctrine:numeric-function name="test_numeric>Acme\HelloBundle\DQL\NumericFunction</doctrine:numeric-function>
-                    <doctrine:datetime-function name="test_datetime>Acme\HelloBundle\DQL\DatetimeFunction</doctrine:datetime-function>
-                </doctrine:dql>
-            </doctrine:entity-manager>
-            <doctrine:entity-manager name="em2" connection="conn2" metadata-cache-driver="apc">
-                <doctrine:mapping
-                    name="DoctrineExtensions"
-                    type="xml"
-                    dir="%kernel.root_dir%/../vendor/gedmo/doctrine-extensions/lib/DoctrineExtensions/Entity"
-                    prefix="DoctrineExtensions\Entity"
-                    alias="DExt"
-                />
-            </doctrine:entity-manager>
-        </doctrine:orm>
-    </doctrine:config>
-</container>
                    -
                    -
                    • -
                  -
                  -
                  -

                  Describiendo la configuración

                  -

                  El siguiente ejemplo de configuración muestra todos los valores de configuración predeterminados que resuelve ORM:

                  -
                  doctrine:
-    orm:
-        auto_mapping: true
-        # la distribución estándar lo sustituye a true en depuración,
-        # false en cualquier otro caso
-        auto_generate_proxy_classes: false
-        proxy_namespace: Proxies
-        proxy_dir: "%kernel.cache_dir%/doctrine/orm/Proxies"
-        default_entity_manager: default
-        metadata_cache_driver: array
-        query_cache_driver: array
-        result_cache_driver: array
-
                  -
                  -

                  Hay un montón de opciones de configuración que puedes utilizar para redefinir ciertas clases, pero solamente son para casos de uso muy avanzado.

                  -
                  -

                  Controladores de caché

                  -

                  Para los controladores de caché puedes especificar los valores «array», «apc», «memcache», «memchached», «xcache» o «service».

                  -

                  El siguiente ejemplo muestra una descripción de los ajustes de la memoria caché:

                  -
                  doctrine:
-    orm:
-        auto_mapping: true
-        metadata_cache_driver: apc
-        query_cache_driver:
-            type: service
-            id: my_doctrine_common_cache_service
-        result_cache_driver:
-            type: memcache
-            host: localhost
-            port: 11211
-            instance_class: Memcache
-
                  -
                  -
                  -
                  -

                  Configurando la asignación

                  -

                  La definición explícita de todas las entidades asignadas es la única configuración necesaria para el ORM y hay varias opciones de configuración que puedes ajustar. Existen las siguientes opciones de configuración para una asignación:

                  -
                    -
                  • type Uno de annotation, xml, yml, php o staticphp. -Esta especifica cual tipo de metadatos usa el tipo de tu asignación.
                    • -
                  • dir Ruta a la asignación o archivos de entidad (dependiendo del controlador). Si esta ruta es relativa, se supone que es relativa a la raíz del paquete. Esto sólo funciona si el nombre de tu asignación es un nombre de paquete. Si deseas utilizar esta opción para especificar rutas absolutas, debes prefijar la ruta con los parámetros del núcleo existentes en el DIC (por ejemplo %kernel.root_dir%).
                    • -
                  • prefix Un prefijo común del espacio de nombres que comparten todas las entidades de esta asignación. Este prefijo nunca debe entrar en conflicto con otros prefijos de asignación definidos, de otra manera Doctrine no podrá encontrar algunas de tus entidades. Esta opción tiene predeterminado el espacio de nombres paquete + Entity, por ejemplo, para un paquete llamado AcmeHelloBundle el prefijo sería Acme\HelloBundle\Entity.
                    • -
                  • alias Doctrine ofrece una forma de simplificar el espacio de nombres de la entidad, para utilizar nombres más cortos en las consultas DQL o para acceder al Repositorio. Cuando utilices un paquete el alias predeterminado es el nombre del paquete.
                    • -
                  • is_bundle Esta opción es un valor derivado de dir y por omisión se establece en true, si dir es relativo provisto por un file_exists() comprueba que devuelve false. Este es false si al comprobar la existencia devuelve true. En este caso has especificado una ruta absoluta y es más probable que los archivos de metadatos estén en un directorio fuera del paquete.
                    • -
                  -
                  -
                  -
                  -

                  Configurando DBAL de Doctrine

                  -

                  DoctrineBundle apoya todos los parámetros que los controladores de Doctrine aceptan por omisión, convertidos a la nomenclatura estándar de XML o YAML que Symfony respeta. Consulta la documentación oficial de DBAL de Doctrine para más información. -El siguiente bloque muestra todas las posibles claves de configuración:

                  -
                  -
                    -
                  • YAML
                    doctrine:
-    dbal:
-        dbname:               database
-        host:                 localhost
-        port:                 1234
-        user:                 user
-        password:             secret
-        driver:               pdo_mysql
-        # the DBAL driverClass option
-        driver_class:         MyNamespace\MyDriverImpl
-        # the DBAL driverOptions option
-        options:
-            foo: bar
-        path:                 "%kernel.data_dir%/data.sqlite"
-        memory:               true
-        unix_socket:          /tmp/mysql.sock
-        # the DBAL wrapperClass option
-        wrapper_class:        MyDoctrineDbalConnectionWrapper
-        charset:              UTF8
-        logging:              "%kernel.debug%"
-        platform_service:     MyOwnDatabasePlatformService
-        mapping_types:
-            enum: string
-        types:
-            custom: Acme\HelloBundle\MyCustomType
-        # the DBAL keepSlave option
-        keep_slave:           false
-
                    -
                    -
                    • -
                  • XML
                    <!-- xmlns:doctrine="http://symfony.com/schema/dic/doctrine" -->
-<!-- xsi:schemaLocation="http://symfony.com/schema/dic/doctrine http://symfony.com/schema/dic/doctrine/doctrine-1.0.xsd"> -->
-
-<doctrine:config>
-    <doctrine:dbal
-        name="default"
-        dbname="database"
-        host="localhost"
-        port="1234"
-        user="user"
-        password="secret"
-        driver="pdo_mysql"
-        driver-class="MyNamespace\MyDriverImpl"
-        path="%kernel.data_dir%/data.sqlite"
-        memory="true"
-        unix-socket="/tmp/mysql.sock"
-        wrapper-class="MyDoctrineDbalConnectionWrapper"
-        charset="UTF8"
-        logging="%kernel.debug%"
-        platform-service="MyOwnDatabasePlatformService"
-    >
-        <doctrine:option key="foo">bar</doctrine:option>
-        <doctrine:mapping-type name="enum">string</doctrine:mapping-type>
-        <doctrine:type name="custom">Acme\HelloBundle\MyCustomType</doctrine:type>
-    </doctrine:dbal>
-</doctrine:config>
-
                    -
                    -
                    • -
                  -
                  -

                  Si deseas configurar varias conexiones en YAML, ponlas bajo la clave connections y dales un nombre único:

                  -
                  doctrine:
-    dbal:
-        default_connection:       default
-        connections:
-            default:
-                dbname:           Symfony2
-                user:             root
-                password:         null
-                host:             localhost
-            customer:
-                dbname:           customer
-                user:             root
-                password:         null
-                host:             localhost
-
                  -
                  -

                  El servicio database_connection siempre se refiere a la conexión default, misma que es la primera definida o la configurada a través del parámetro default_connection.

                  -

                  Cada conexión también es accesible a través del servicio doctrine.dbal.[nombre]_connection donde [nombre] es el nombre de la conexión.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/framework.html b/reference/configuration/framework.html deleted file mode 100644 index a6ee854..0000000 --- a/reference/configuration/framework.html +++ /dev/null @@ -1,577 +0,0 @@ - - - - - - - Configuración del FrameworkBundle («framework») — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configuración del FrameworkBundle («framework»)

                  -

                  Este documento de referencia es un trabajo en progreso. Este debe ser preciso, pero aún no están cubiertas completamente todas las opciones.

                  -

                  El FrameworkBundle contiene la mayor parte de la funcionalidad «base» de la plataforma y se puede ajustar bajo la clave framework en la configuración de tu aplicación. -Esto incluye ajustes relacionados con sesiones, traducción, formularios, validación, enrutado y mucho más.

                  -
                  -

                  Configurando

                  - -
                  -

                  secret

                  -

                  tipo: string required

                  -

                  Esta es una cadena que debe ser única para tu aplicación. En la práctica, se utiliza para generar los segmentos CSRF, pero se podría utilizar en cualquier otro contexto donde una cadena única sea útil. Se convierte en el parámetro llamado kernel.secret del contenedor de servicios.

                  -
                  -
                  -

                  http_method_override

                  -

                  -Nuevo en la versión 2.3: The http_method_override option is new in Symfony 2.3.

                  -

                  tipo: Boolean predeterminado: true

                  -

                  This determines whether the _method request parameter is used as the intended -HTTP method on POST requests. If enabled, the -Request::enableHttpMethodParameterOverride -gets called automatically. It becomes the service container parameter named -kernel.http_method_override. For more information, see -Cómo utilizar métodos HTTP además de GET y POST en rutas.

                  -
                  -
                  -

                  ide

                  -

                  tipo: string predefinido: null

                  -

                  Si estás utilizando un IDE como TextMate o Vim Mac, Symfony puede convertir todas las rutas de archivo de un mensaje de excepción en un enlace, el cual abrirá el archivo en el IDE.

                  -

                  Si usas TextMate o Vim Mac, simplemente puedes utilizar uno de los siguientes valores integrados:

                  -
                    -
                  • textmate
                    • -
                  • macvim
                    • -
                  -

                  También puedes especificar una cadena personalizada como enlace al archivo. Si lo haces, debes duplicar todos los signos de porcentaje (%) para escapar ese carácter. Por ejemplo, la cadena completa de TextMate se vería así:

                  -
                  framework:
-    ide:  "txmt://open?url=file://%%f&line=%%l"
-
                  -
                  -

                  Por supuesto, debido a que cada desarrollador utiliza un IDE diferente, es mejor poner esto a nivel del sistema. Esto se puede hacer estableciendo en php.ini el valor de xdebug.file_link_format a la cadena de enlace al archivo. Si estableces este valor de configuración, entonces no es necesario determinar la opción ide.

                  -
                  -
                  -

                  test

                  -

                  tipo: Boolean

                  -

                  Si este parámetro de configuración está presente (y no es false), entonces se cargará el servicio relacionado para probar tu aplicación (por ejemplo, test.client). -Este valor debe estar presente en tu entorno test (por lo general a través de app/config/config_test.yml). Para más información, consulta Probando.

                  -
                  -
                  -

                  trusted_proxies

                  -

                  tipo: array

                  -

                  Configura la dirección IP en que se debería confiar como delegada. Para más detalles, ve Delegados confiables.

                  -
                  -
                    -
                  • YAML
                    framework:
-    trusted_proxies:  [192.0.0.1]
-
                    -
                    -
                    • -
                  • XML
                    <framework:config trusted-proxies="192.0.0.1">
-    <!-- ... -->
-</framework>
-
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('framework', array(
-    'trusted_proxies' => array('192.0.0.1'),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  form

                  -
                  -
                  -

                  csrf_protection

                  -
                  -
                  -

                  session

                  - - - - - -
                  -

                  gc_probability

                  -

                  -Nuevo en la versión 2.1: La opción gc_probability es nueva en la versión 2.1

                  -

                  tipo: integer predeterminado: 1

                  -

                  Esta define la probabilidad que empiece el proceso del recolector de basura (GC por «Garbage Colector») en cada inicio de sesión. La probabilidad se calcula utilizando gc_probability / gc_divisor, p. ej. 1/100 significa que hay un 1% de posibilidad que el proceso del recolector de basura empiece en cada petición.

                  -
                  -
                  -

                  gc_divisor

                  -

                  -Nuevo en la versión 2.1: La opción gc_divisor es nueva en la versión 2.1

                  -

                  tipo: integer predeterminado: 100

                  -

                  Ve gc_probability.

                  -
                  -
                  -

                  gc_maxlifetime

                  -

                  -Nuevo en la versión 2.1: La opción gc_maxlifetime es nueva en la versión 2.1

                  -

                  tipo: integer predeterminado: 14400

                  -

                  Esta determina el número de segundos después de que los datos se han visto como «basura» y potencialmente limpiarlos. La recolección de basura puede ocurrir durante el inicio de sesión y depende de gc_divisor y gc_probability.

                  -
                  -
                  -

                  save_path

                  -

                  tipo: string predefinido: %kernel.cache.dir%/sessions

                  -

                  Esta determina el argumento a pasar al salvar el manejador. Si escoges el manejador de archivos predeterminado, esta es la ruta a dónde serán creados los archivos. You can -also set this value to the save_path of your php.ini by setting the -value to null:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-framework:
-    session:
-        save_path: null
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<framework:config>
-    <framework:session save-path="null" />
-</framework:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('framework', array(
-    'session' => array(
-        'save_path' => null,
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -
                  -

                  serializer

                  -
                  -

                  enabled

                  -

                  tipo: boolean default: false

                  -

                  Whether to enable the serializer service or not in the service container.

                  -

                  For more details, see How to use the Serializer.

                  -
                  -
                  -
                  -

                  templating

                  -
                  -

                  assets_base_urls

                  -

                  predeterminado: { http: [], ssl: [] }

                  -

                  This option allows you to define base URLs to be used for assets referenced -from http and ssl (https) pages. Puedes proporcionar un valor de cadena en vez de un arreglo de un solo elemento. If multiple base URLs are provided, Symfony2 -will select one from the collection each time it generates an asset’s path.

                  -

                  For your convenience, assets_base_urls can be set directly with a string or -array of strings, which will be automatically organized into collections of base -URLs for http and https requests. Si una URL comienza con https:// o -está relacionada al protocolo (es decir empieza con //) esta se debe añadir en ambas colecciones. URLs starting with http:// will only be added to the -http collection.

                  -

                  -Nuevo en la versión 2.1: A diferencia de la mayoría de los bloques de configuración, los valores sucesivos de assets_base_urls se deben sobrescribir unos a otros en lugar de fusionarse. Este comportamiento fue elegido porque los desarrolladores típicamente definen la URL base para cada entorno. -Dado que la mayoría de los proyectos tienden a heredar las configuraciones (por ejemplo, config_test.yml importa config_dev.yml) y/o comparten una configuración base común (es decir, config.yml), la fusión podría generar un conjunto de URL base para múltiples entornos.

                  -
                  -
                  -

                  assets_version

                  -

                  tipo: string

                  -

                  Esta opción se utiliza para detener la memorización en caché de activos a nivel global añadiendo un parámetro de consulta a todas las rutas de los activos reproducidos (por ejemplo /images/logo.png?v2). Esto se aplica sólo a los activos reproducidos a través de la función asset de Twig (o su equivalente PHP), así como los activos reproducidos con Assetic.

                  -

                  Por ejemplo, supongamos que tienes lo siguiente:

                  -
                  -
                    -
                  • Twig
                    <img src="{{ asset('images/logo.png') }}" alt="Symfony!" />
-
                    -
                    -
                    • -
                  • PHP
                    <img src="<?php echo $view['assets']->getUrl('images/logo.png') ?>" alt="Symfony!" />
-
                    -
                    -
                    • -
                  -
                  -

                  Por omisión, esto reproducirá la ruta hacia tu imagen tal como /images/logo.png. -Ahora, activa la opción assets_version:

                  -
                  -
                    -
                  • YAML
                    # app/config/config.yml
-framework:
-    # ...
-    templating: { engines: ['twig'], assets_version: v2 }
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/config.xml -->
-<framework:templating assets-version="v2">
-    <framework:engine id="twig" />
-</framework:templating>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/config.php
-$container->loadFromExtension('framework', array(
-    ...,
-    'templating'      => array(
-        'engines'        => array('twig'),
-        'assets_version' => 'v2',
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, el mismo activo se reproduce como /images/logo.png?v2, Si utilizas esta función, debes incrementar manualmente el valor de assets_version antes de cada despliegue de modo que cambien los parámetros de consulta.

                  -

                  También puedes controlar cómo funciona la cadena de consulta a través de la opción assets_version_format.

                  -
                  -
                  -

                  assets_version_format

                  -

                  tipo: string predefinido: %%s?%%s

                  -

                  Esta especifica un patrón sprintf que será utilizado con la opción assets_version para construir la ruta de un activo. Por omisión, el patrón añade la versión del activo como una cadena de consulta. Por ejemplo, si assets_version_format está establecido en %%s?version=%%s y assets_version está establecida en 5, la ruta del activo sería /images/logo.png?version=5.

                  -
                  -

                  Nota

                  -

                  Todos los signos de porcentaje (%) en la cadena de formato se deben duplicar para escapar el carácter. Sin escapar, los valores se pueden interpretar inadvertidamente como Parámetros del servicio.

                  -
                  -
                  -

                  Truco

                  -

                  Algunos CDN no son compatibles con caché rota a través de cadenas de consulta, por lo que la inyección de la versión en la ruta del archivo real es necesaria. Menos mal, assets_version_format no se limita a producir cadenas de consulta versionadas.

                  -

                  El patrón recibe la ruta original del activo y la versión de sus parámetros primero y segundo, respectivamente. Debido a que la ruta del activo es un parámetro, no la puedes modificar en el lugar (p. ej. /images/logo-v5.png); sin embargo, puedes prefijar la ruta del activo usando un patrón de version-%%2$s/%%1$s, el cual resultará en la ruta version-5/images/logo.png.

                  -

                  Entonces, las reglas de reescritura de URL se podrían utilizar para ignorar el prefijo de la versión antes de servir el activo. Como alternativa, puedes copiar los activos a la ruta de la versión apropiada como parte de tu proceso de despliegue y renunciar a toda la reescritura de URL. -La última opción es útil si deseas que las versiones anteriores de los activos permanezcan accesibles en la URL original.

                  -
                  -
                  -
                  -
                  -
                  -

                  Configuración predeterminada completa

                  -
                  -
                    -
                  • YAML
                    framework:
-    secret:               ~
-    http_method_override: true
-    trusted_proxies:      []
-    ide:                  ~
-    test:                 ~
-    default_locale:       en
-
-    # configuración de formulario
-    form:
-        enabled:              false
-    csrf_protection:
-        enabled:              false
-        field_name:           _token
-
-    # configuración esi
-    esi:
-        enabled:              false
-
-    # configuración de fragmentos
-    fragments:
-        enabled:              false
-        path:                 /_fragment
-
-    # configuración del perfilador
-    profiler:
-        enabled:              false
-        only_exceptions:      false
-        only_master_requests: false
-        dsn:                  file:%kernel.cache_dir%/profiler
-        username:
-        password:
-        lifetime:             86400
-        matcher:
-            ip:                   ~
-
-            # usa el formato urldecoded
-            path:                 ~ # Ejemplo: ^/ruta al recurso/
-            service:              ~
-
-    # configuración del enrutador
-    router:
-        resource:             ~ # Requerido
-        type:                 ~
-        http_port:            80
-        https_port:           443
-
-        # ponlo a true para lanzar una excepción cuando un parámetro no coincida con los requisitos
-        # ponlo a false para desactivar las excepcións cuando un parámetro no coincida con los requisitos (y en su lugar devuelve null)
-        # ponlo a null para desactivar el parámetro contra el cual comparar los requisitos
-        # 'true' es la configuración predefinida en modo de desarrollo, mientras que 'false' o 'null' pueden ser preferibles en producción
-        strict_requirements:  true
-
-    # configuración de sesión
-    session:
-        storage_id:           session.storage.native
-        handler_id:           session.handler.native_file
-        name:                 ~
-        cookie_lifetime:      ~
-        cookie_path:          ~
-        cookie_domain:        ~
-        cookie_secure:        ~
-        cookie_httponly:      ~
-        gc_divisor:           ~
-        gc_probability:       ~
-        gc_maxlifetime:       ~
-        save_path:            %kernel.cache_dir%/sessions
-
-    # serializer configuration
-    serializer:
-       enabled: false
-
-    # configuración de plantillas
-    templating:
-        assets_version:       ~
-        assets_version_format:  %%s?%%s
-        hinclude_default_template:  ~
-        form:
-            resources:
-
-                # Predefinido:
-                - FrameworkBundle:Form
-        assets_base_urls:
-            http:                 []
-            ssl:                  []
-        cache:                ~
-        engines:              # Requerido
-
-            # Ejemplo:
-            - twig
-        loaders:              []
-        packages:
-
-            # Prototipo
-            name:
-                version:              ~
-                version_format:       %%s?%%s
-                base_urls:
-                    http:                 []
-            ssl:                  []
-
-    # configuración del traductor
-    translator:
-        enabled:              false
-        fallback:             en
-
-    # configuración de validación
-    validation:
-        enabled:              false
-        cache:                ~
-        enable_annotations:   false
-        translation_domain:   validators
-
-    # configuración de anotaciones
-    annotations:
-        caché:                file
-        file_cache_dir:       %kernel.cache_dir%/annotations
-        debug:                %kernel.debug%
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/kernel.html b/reference/configuration/kernel.html deleted file mode 100644 index dc4a902..0000000 --- a/reference/configuration/kernel.html +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - Configuring in the Kernel (e.g. AppKernel) — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configuring in the Kernel (e.g. AppKernel)

                  -

                  Some configuration can be done on the kernel class itself (usually called -app/AppKernel.php). You can do this by overriding specific methods in -the parent Symfony\Component\HttpKernel\Kernel class.

                  -
                  -

                  Configurando

                  - -

                  -Nuevo en la versión 2.1: The getCharset() method is new -in Symfony 2.1

                  -
                  -

                  Charset

                  -

                  tipo: string predefinido: UTF-8

                  -

                  This returns the charset that is used in the application. To change it, override the -getCharset() method and return another -charset, for instance:

                  -
                  // app/AppKernel.php
-
-// ...
-class AppKernel extends Kernel
-{
-    public function getCharset()
-    {
-        return 'ISO-8859-1';
-    }
-}
-
                  -
                  -
                  -
                  -

                  Kernel Name

                  -

                  tipo: string predefinido: app (i.e. the directory name holding the kernel class)

                  -

                  To change this setting, override the getName() -method. Alternatively, move your kernel into a different directory. For example, -if you moved the kernel into a foo directory (instead of app), the -kernel name will be foo.

                  -

                  The name of the kernel isn’t usually directly important - it’s used in the -generation of cache files. If you have an application with multiple kernels, -the easiest way to make each have a unique name is to duplicate the app -directory and rename it to something else (e.g. foo).

                  -
                  -
                  -

                  Root Directory

                  -

                  tipo: string predefinido: the directory of AppKernel

                  -

                  This returns the root directory of your kernel. If you use the Symfony Standard -edition, the root directory refers to the app directory.

                  -

                  To change this setting, override the -getRootDir() method:

                  -
                  // app/AppKernel.php
-
-// ...
-class AppKernel extends Kernel
-{
-    // ...
-
-    public function getRootDir()
-    {
-        return realpath(parent::getRootDir().'/../');
-    }
-}
-
                  -
                  -
                  -
                  -

                  Cache Directory

                  -

                  tipo: string predefinido: $this->rootDir/cache/$this->environment

                  -

                  This returns the path to the cache directory. To change it, override the -getCacheDir() method. Read -“Sustituyendo el directorio cache” for more information.

                  -
                  -
                  -

                  Log Directory

                  -

                  tipo: string predefinido: $this->rootDir/logs

                  -

                  This returns the path to the log directory. To change it, override the -getLogDir() method. Read -“Sustituyendo el directorio logs” for more information.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/monolog.html b/reference/configuration/monolog.html deleted file mode 100644 index 5c63355..0000000 --- a/reference/configuration/monolog.html +++ /dev/null @@ -1,224 +0,0 @@ - - - - - - - Referencia de configuración de Monolog — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Referencia de configuración de Monolog

                  -
                  -
                    -
                  • YAML
                    monolog:
-    handlers:
-
-        # Ejemplos:
-        syslog:
-            type:                stream
-            path:                /var/log/symfony.log
-            level:               ERROR
-            bubble:              false
-            formatter:           mi_formateador
-            processors:
-                - un_ejecutable
-        main:
-            type:                fingers_crossed
-            action_level:        WARNING
-            buffer_size:         30
-            handler:             custom
-        custom:
-            type:                service
-            id:                  mi_controlador
-
-        # Opciones y valores predefinidos de "mi_controlador_personalizado"
-        mi_controlador_personalizado:
-            type:                 ~ # Requerido
-            id:                   ~
-            priority:             0
-            level:                DEBUG
-            bubble:               true
-            path:                 "%kernel.logs_dir%/%kernel.environment%.log"
-            ident:                false
-            facility:             user
-            max_files:            0
-            action_level:         WARNING
-            activation_strategy:  ~
-            stop_buffering:       true
-            buffer_size:          0
-            handler:              ~
-            members:              []
-            channels:
-                type:     ~
-                elements: ~
-            from_email:           ~
-            to_email:             ~
-            subject:              ~
-            email_prototype:
-                id:                   ~ # Requerido (cuando se usa el email_prototype)
-                factory-method:       ~
-            channels:
-                type:                 ~
-                elements:             []
-            formatter:            ~
-
                    -
                    -
                    • -
                  • XML
                    <container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:monolog="http://symfony.com/schema/dic/monolog"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/monolog http://symfony.com/schema/dic/monolog/monolog-1.0.xsd">
-
-    <monolog:config>
-        <monolog:handler
-            name="syslog"
-            type="stream"
-            path="/var/log/symfony.log"
-            level="error"
-            bubble="false"
-            formatter="mi_formateador"
-        />
-        <monolog:handler
-            name="main"
-            type="fingers_crossed"
-            action-level="warning"
-            handler="custom"
-        />
-        <monolog:handler
-            name="custom"
-            type="service"
-            id="mi_controlador"
-        />
-    </monolog:config>
-</container>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Cuando está habilitado el generador de perfiles, se agrega un controlador para almacenar los mensajes del registro en el generador de perfiles. El generador de perfiles utiliza el nombre «debug» por lo tanto está reservado y no se puede utilizar en la configuración.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/security.html b/reference/configuration/security.html deleted file mode 100644 index 6045458..0000000 --- a/reference/configuration/security.html +++ /dev/null @@ -1,558 +0,0 @@ - - - - - - - Referencia de configuración de Security — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Referencia de configuración de Security

                  -

                  El sistema de seguridad es una de las piezas más poderosas de Symfony2, y en gran medida se puede controlar por medio de su configuración.

                  -
                  -

                  Configuración predeterminada completa

                  -

                  La siguiente es la configuración predeterminada para el sistema de seguridad completo. -Cada parte se explica en la siguiente sección.

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    access_denied_url:    ~ # Ejemplo: /foo/error403
-
-    # la estrategia puede ser: none, migrate, invalidate
-    session_fixation_strategy:  migrate
-    hide_user_not_found:  true
-    always_authenticate_before_granting:  false
-    erase_credentials:    true
-    access_decision_manager:
-        strategy:             affirmative
-        allow_if_all_abstain:  false
-        allow_if_equal_granted_denied:  true
-    acl:
-
-        # cualquier nombre configurado en la sección doctrine.dbal
-        connection:           ~
-        cache:
-            id:                   ~
-            prefix:               sf2_acl_
-        provider:             ~
-        tables:
-            class:                acl_classes
-            entry:                acl_entries
-            object_identity:      acl_object_identities
-            object_identity_ancestors:  acl_object_identity_ancestors
-            security_identity:    acl_security_identities
-        voter:
-            allow_if_object_identity_unavailable:  true
-
-    encoders:
-        # Ejemplos:
-        Acme\DemoBundle\Entity\Usuario1: sha512
-        Acme\DemoBundle\Entity\Usuario2:
-            algorithm:           sha512
-            encode_as_base64:    true
-            iterations:          5000
-
-        # codificador PBKDF2
-        # ve la nota sobre PBKDF2 abajo para detalles sobre seguridad y velocidad
-        Acme\Your\Class\Name:
-            algorithm:            pbkdf2
-            hash_algorithm:       sha512
-            encode_as_base64:     true
-            iterations:           1000
-
-        # Example options/values for what a custom encoder might look like
-        Acme\DemoBundle\Entity\User3:
-            id:                   my.encoder.id
-
-    providers:            # Requerido
-        # Ejemplos:
-        my_in_memory_provider:
-            memory:
-                users:
-                    foo:
-                        password:           foo
-                        roles:              ROLE_USER
-                    bar:
-                        password:           bar
-                        roles:              [ROLE_USER, ROLE_ADMIN]
-
-        my_entity_provider:
-            entity:
-                class:              SecurityBundle:User
-                property:           username
-
-        # Example custom provider
-        my_some_custom_provider:
-            id:                   ~
-
-        # Chain some providers
-        my_chain_provider:
-            chain:
-                providers:          [ my_in_memory_provider, my_entity_provider ]
-
-    firewalls:            # Requerido
-        # Ejemplos:
-        cualquiernombre:
-            pattern: .*
-            request_matcher: un.id.de.servicio
-            access_denied_url: /foo/error403
-            access_denied_handler: un.id.de.servicio
-            entry_point: un.id.de.servicio
-            provider: some_key_from_above
-            # manages where each firewall stores session information
-            # See "Firewall Context" below for more details
-            context: context_key
-            stateless: false
-            x509:
-                provider: una_clave_de_arriba
-            http_basic:
-                provider: una_clave_de_arriba
-            http_digest:
-                provider: una_clave_de_arriba
-            form_login:
-                # aquí es dónde se presenta el formulario de acceso
-                check_path: /login_check
-
-                # el usuario es redirigido aquí cuando necesita ingresar
-                login_path: /login
-
-                # si es 'true', reenvía al usuario al formulario de acceso en lugar de redirigirlo
-                use_forward: false
-
-                # opciones para redirigir en ingreso satisfactorio (lee más adelante)
-                always_use_default_target_path: false
-                default_target_path:            /
-                target_path_parameter:          _target_path
-                use_referer:                    false
-
-                # opciones para redirigir en ingreso fallido (lee más adelante)
-                failure_path:    /foo
-                failure_forward: false
-                failure_path_parameter: _failure_path
-                failure_handler: un.id.de.servicio
-                success_handler: some.service.id
-
-                # nombres de campo para el nombre de usuario y contraseña
-                username_parameter: _username
-                password_parameter: _password
-
-                # opciones del elemento csrf
-                csrf_parameter: _csrf_token
-                intention:      authenticate
-                csrf_provider:  my.csrf_provider.id
-
-                # por omisión, el método del formulario de acceso DEBE ser POST, no GET
-                post_only:      true
-                remember_me:    false
-            remember_me:
-                token_provider: name
-                key: someS3cretKey
-                name: NameOfTheCookie
-                lifetime: 3600 # en segundos
-                path: /foo
-                domain: undominio.foo
-                secure: false
-                httponly: true
-                always_remember_me: false
-                remember_me_parameter: _remember_me
-            logout:
-                path:   /logout
-                target: /
-                invalidate_session: false
-                delete_cookies:
-                    a: { path: null, domain: null }
-                    b: { path: null, domain: null }
-                handlers: [un.id.de.servicio, otro.id.de.servicio]
-                success_handler: un.id.de.servicio
-            anonymous: ~
-
-        # Valores y opciones predefinidos para algún cortafuegos
-        un_escucha_del_cortafuegos:
-            pattern:              ~
-            security:             true
-            request_matcher:      ~
-            access_denied_url:    ~
-            access_denied_handler:  ~
-            entry_point:          ~
-            provider:             ~
-            stateless:            false
-            context:              ~
-            logout:
-                csrf_parameter:       _csrf_token
-                csrf_provider:        ~
-                intention:            logout
-                path:                 /logout
-                target:               /
-                success_handler:      ~
-                invalidate_session:   true
-                delete_cookies:
-
-                    # Prototipo
-                    name:
-                        path:                 ~
-                        domain:               ~
-                handlers:             []
-            anonymous:
-                key:                  4f954a0667e01
-            switch_user:
-                provider:             ~
-                parameter:            _switch_user
-                role:                 ROLE_ALLOWED_TO_SWITCH
-
-    access_control:
-        requires_channel:     ~
-
-        # usa el formato urldecoded
-        path:                 ~ # Ejemplo: ^/ruta al recurso/
-        host:                 ~
-        ip:                   ~
-        methods:              []
-        roles:                []
-    role_hierarchy:
-        ROLE_ADMIN:      [ROLE_ORGANIZER, ROLE_USER]
-        ROLE_SUPERADMIN: [ROLE_ADMIN]
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Configurando el formulario de acceso

                  -

                  Cuando usas el escucha de autenticación form_login bajo un cortafuegos, hay varias opciones comunes para experimentar en la configuración del «formulario de acceso»:

                  -

                  Para más información, consulta Cómo personalizar el formulario de acceso.

                  -
                  -

                  Procesando el formulario de acceso

                  -
                    -

                  • login_path (tipo: string, predefinido: /login) -This is the route or path that the user will be redirected to (unless -use_forward is set to true) when he/she tries to access a -protected resource but isn’t fully authenticated.

                    -

                    This path must be accessible by a normal, un-authenticated user, else -you may create a redirect loop. Para más información, consulta «Evitando errores comunes».

                    -
                    • -

                  • check_path (tipo: string, predefinido: /login_check) -This is the route or path that your login form must submit to. The -firewall will intercept any requests (POST requests only, by default) -to this URL and process the submitted login credentials.

                    -

                    Asegúrate de que esta dirección está cubierta por el cortafuegos principal (es decir, no crees un servidor de seguridad independiente sólo para la URL check_path).

                    -
                    • -

                  • use_forward (tipo: Boolean, predefinido: false) -Si deseas que el usuario sea remitido al formulario de acceso en vez de ser redirigido, marca esta opción a true.

                    -
                    • -

                  • username_parameter (tipo: string, predefinido: _username) -Este es el nombre del campo que debes dar al campo ‘nombre de usuario’ de tu formulario de acceso. Cuando se presenta el formulario a check_path, el sistema de seguridad buscará un parámetro POST con este nombre.

                    -
                    • -

                  • password_parameter (tipo: string, predefinido: _password) -Este es el nombre de campo que se debe dar al campo de la contraseña de tu formulario de inicio de sesión. Cuando se presenta el formulario a check_path, el sistema de seguridad buscará un parámetro POST con este nombre.

                    -
                    • -

                  • post_only (tipo: Boolean, predefinido: true) -De forma predeterminada, debes enviar tu formulario de acceso a la URL check_path como una petición POST. Al poner esta opción a false, puedes enviar una petición GET a la URL check_path.

                    -
                    • -
                  -
                  -
                  -

                  Redirigiendo después del inicio de sesión

                  -
                    -
                  • always_use_default_target_path (tipo: Boolean, predefinido: false)
                    • -
                  • default_target_path (tipo: string, predefinido: /)
                    • -
                  • target_path_parameter (tipo: string, predefinido: _target_path)
                    • -
                  • use_referer (tipo: Boolean, predefinido: false)
                    • -
                  -
                  -
                  -
                  -

                  Usando el codificador PBKDF2: seguridad y velocidad

                  -

                  -Nuevo en la versión 2.2: The PBKDF2 password encoder was added in Symfony 2.2.

                  -

                  El codificador PBKDF2 proporciona seguridad criptográfica de alto nivel, tal como la recomendada por el Instituto Nacional de Estándares y Tecnología (NIST por «National Institute of Standards and Technology»).

                  -

                  You can see an example of the pbkdf2 encoder in the YAML block on this page.

                  -

                  Pero usando PBKDF2 también garantizas un aviso: Usándolo (con un número de iteraciones alto) ralentiza el proceso. Por lo que, PBKDF2 se tendría que utilizar con precaución y muchísimo cuidado.

                  -

                  Una buena configuración está alrededor al menos 1000 iteraciones y sha512 -para el algoritmo de codificación.

                  -
                  -
                  -

                  Using the BCrypt Password Encoder

                  -

                  -Nuevo en la versión 2.2: The BCrypt password encoder was added in Symfony 2.2.

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    # ...
-
-    encoders:
-        Symfony\Component\Security\Core\User\User:
-            algorithm: bcrypt
-            cost:      15
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<config>
-    <!-- ... -->
-    <encoder
-        class="Symfony\Component\Security\Core\User\User"
-        algorithm="bcrypt"
-        cost="15"
-    />
-</config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-    // ...
-    'encoders' => array(
-        'Symfony\Component\Security\Core\User\User' => array(
-            'algorithm' => 'bcrypt',
-            'cost'      => 15,
-        ),
-    ),
-));
-
                    -
                    -
                    • -
                  -
                  -

                  The cost can be in the range of 4-31 and determines how long a password -will be encoded. Each increment of cost doubles the time it takes to -encode a password.

                  -

                  If you don’t provide the cost option, the default cost of 13 is used.

                  -
                  -

                  Nota

                  -

                  You can change the cost at any time — even if you already have some -passwords encoded using a different cost. New passwords will be encoded -using the new cost, while the already encoded ones will be validated -using a cost that was used back when they were encoded.

                  -
                  -

                  A salt for each new password is generated automatically and need not be -persisted. Since an encoded password contains the salt used to encode it, -persisting the encoded password alone is enough.

                  -
                  -

                  Nota

                  -

                  All the encoded passwords are 60 characters long, so make sure to -allocate enough space for them to be persisted.

                  -
                  -
                  -
                  -

                  Firewall Context

                  -

                  Most applications will only need one firewall. -But if your application does use multiple firewalls, you’ll notice that -if you’re authenticated in one firewall, you’re not automatically authenticated -in another. In other words, the systems don’t share a common “context”: each -firewall acts like a separate security system.

                  -

                  However, each firewall has an optional context key (which defaults to -the name of the firewall), which is used when storing and retrieving security -data to and from the session. If this key were set to the same value across -multiple firewalls, the “context” could actually be shared:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-    # ...
-
-    firewalls:
-        cualquiernombre:
-            # ...
-            context: my_context
-        othername:
-            # ...
-            context: my_context
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<security:config>
-   <firewall name="somename" context="my_context">
-     <! ... ->
-   </firewall>
-   <firewall name="othername" context="my_context">
-     <! ... ->
-   </firewall>
-</security:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-     'firewalls' => array(
-         'somename' => array(
-             // ...
-             'context' => 'my_context'
-         ),
-         'othername' => array(
-             // ...
-             'context' => 'my_context'
-         ),
-     ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  HTTP-Digest Authentication

                  -

                  To use HTTP-Digest authentication you need to provide a realm and a key:

                  -
                  -
                    -
                  • YAML
                    # app/config/security.yml
-security:
-   firewalls:
-      cualquiernombre:
-        http_digest:
-         key: "a_random_string"
-         realm: "secure-api"
-
                    -
                    -
                    • -
                  • XML
                    <!-- app/config/security.xml -->
-<security:config>
-   <firewall name="somename">
-      <http-digest key="a_random_string" realm="secure-api" />
-   </firewall>
-</security:config>
-
                    -
                    -
                    • -
                  • PHP
                    // app/config/security.php
-$container->loadFromExtension('security', array(
-     'firewalls' => array(
-         'somename' => array(
-             'http_digest' => array(
-                 'key'   => 'a_random_string',
-                 'realm' => 'secure-api',
-             ),
-         ),
-     ),
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/swiftmailer.html b/reference/configuration/swiftmailer.html deleted file mode 100644 index bee8b7f..0000000 --- a/reference/configuration/swiftmailer.html +++ /dev/null @@ -1,323 +0,0 @@ - - - - - - - Configurando el SwiftmailerBundle ("swiftmailer") — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configurando el SwiftmailerBundle ("swiftmailer")

                  -

                  Este documento de referencia es un trabajo en progreso. Este debe ser preciso, pero aún no están cubiertas completamente todas las opciones. Para una lista completa de las opciones de configuración predefinidas, consulta la Configuración predeterminada completa

                  -

                  La clave swiftmailer configura la integración de Symfony2 con Swiftmailer, el cual es responsable de crear y entregar los mensajes de correo electrónico.

                  -
                  -

                  Configurando

                  - -
                  -

                  transport

                  -

                  tipo: string predefinido: smtp

                  -

                  El método exacto a utilizar para entregar el correo electrónico. Los valores válidos son los siguientes:

                  - -
                  -
                  -

                  username

                  -

                  tipo: string

                  -

                  El nombre de usuario al utilizar smtp como transporte.

                  -
                  -
                  -

                  password

                  -

                  tipo: string

                  -

                  La contraseña cuando se utiliza smtp como transporte.

                  -
                  -
                  -

                  host

                  -

                  tipo: string predefinido: localhost

                  -

                  El servidor con el cual conectarse cuando se utiliza smtp como transporte.

                  -
                  -
                  -

                  port

                  -

                  tipo: string predefinido: 25 o 465 (dependiendo de encryption)

                  -

                  El puerto al utilizar smtp como transporte. De manera predeterminada es 465 si la codificación es ssl y 25 en cualquier otro caso.

                  -
                  -
                  -

                  encryption

                  -

                  tipo: string

                  -

                  El modo de codificación a utilizar cuando se usa smtp como transporte. Los valores válidos son tls, ssl, o null (indicando que no hay codificación).

                  -
                  -
                  -

                  auth_mode

                  -

                  tipo: string

                  -

                  El modo de autenticación a usar cuando se utiliza smtp como transporte. Los valores válidos son plain, login, cram-md5, o null.

                  -
                  -
                  -

                  spool

                  -

                  Para detalles sobre la cola de correo, consulta Cómo formar en la cola mensajes de correo electrónico.

                  -
                  -

                  Type

                  -

                  tipo: string predefinido: file

                  -

                  El método usado para guardar los mensajes en cola. Actualmente sólo es compatible con file. -No obstante, será posible una cola personalizada creando un servicio llamado swiftmailer.spool.myspool y este valor se establece a myspool.

                  -
                  -
                  -

                  path

                  -

                  tipo: string predefinido: %kernel.cache_dir%/swiftmailer/spool

                  -

                  Cuando utilizas la cola de file, esta es la ruta en dónde se deben guardar los mensajes en la cola.

                  -
                  -
                  -
                  -

                  sender_address

                  -

                  tipo: string

                  -

                  Si se establece, todos los mensajes serán entregados con esta dirección como la dirección de «ruta de retorno», que es a dónde llegarán los mensajes rebotados. Esto lo maneja internamente la clase Swift_Plugins_ImpersonatePlugin de Swiftmailer.

                  -
                  -
                  -

                  antiflood

                  -
                  -

                  threshold

                  -

                  tipo: string predefinido: 99

                  -

                  Usado con Swift_Plugins_AntiFloodPlugin. Este representa la cantidad de correos electrónicos a enviar antes de reiniciar el transporte.

                  -
                  -
                  -

                  sleep

                  -

                  tipo: string predefinido: 0

                  -

                  Usado con Swift_Plugins_AntiFloodPlugin. Esta es la cantidad de segundos a esperar durante el reinicio del transporte.

                  -
                  -
                  -
                  -

                  delivery_address

                  -

                  tipo: string

                  -

                  Si se establece, todos los mensajes de correo serán enviados a esta dirección en lugar de enviarlos a su destinatario real. Esto a menudo es útil en el desarrollo. Por ejemplo, al configurar este en el archivo config_dev.yml, puedes garantizar que todos los correos electrónicos se envían a una sola cuenta durante el desarrollo.

                  -

                  Este usa el Swift_Plugins_RedirectingPlugin. Los destinatarios originales están disponibles en las cabeceras X-Swift-To, X-Swift-Cc y X-Swift-Bcc.

                  -
                  -
                  -

                  disable_delivery

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el transport será establecido automáticamente a null, y en realidad no se entregará el correo.

                  -
                  -
                  -

                  logging

                  -

                  tipo: Boolean predeterminado: %kernel.debug%

                  -

                  Si es true, el recolector de datos de Symfony2 será activado para Swiftmailer y la información estará disponible en el generador de perfiles.

                  -
                  -
                  -
                  -

                  Configuración predeterminada completa

                  -
                  -
                    -
                  • YAML
                    swiftmailer:
-    transport:            smtp
-    username:             ~
-    password:             ~
-    host:                 localhost
-    port:                 false
-    encryption:           ~
-    auth_mode:            ~
-    spool:
-        type:                 file
-        path:                 "%kernel.cache_dir%/swiftmailer/spool"
-    sender_address:       ~
-    antiflood:
-        threshold:            99
-        sleep:                0
-    delivery_address:     ~
-    disable_delivery:     ~
-    logging:              "%kernel.debug%"
-
                    -
                    -
                    • -
                  • XML
                    <swiftmailer:config
-    transport="smtp"
-    username=""
-    password=""
-    host="localhost"
-    port="false"
-    encryption=""
-    auth_mode=""
-    sender_address=""
-    delivery_address=""
-    disable_delivery=""
-    logging="%kernel.debug%"
->
-    <swiftmailer:spool
-        path="%kernel.cache_dir%/swiftmailer/spool"
-        type="file"
-    />
-
-    <swiftmailer:antiflood
-        sleep="0"
-        threshold="99"
-    />
-</swiftmailer:config>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/twig.html b/reference/configuration/twig.html deleted file mode 100644 index 936d10e..0000000 --- a/reference/configuration/twig.html +++ /dev/null @@ -1,215 +0,0 @@ - - - - - - - Referencia de configuración del TwigBundle — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Referencia de configuración del TwigBundle

                  -
                  -
                    -
                  • YAML
                    twig:
-    exception_controller:  twig.controller.exception:showAction
-    form:
-        resources:
-
-            # Predefinido:
-            - form_div_layout.html.twig
-
-            # Ejemplo:
-            - MyBundle::form.html.twig
-    globals:
-
-        # Ejemplos:
-        foo:                 "@bar"
-        pi:                  3.14
-
-        # Opciones de ejemplo, pero el uso más sencillo es como se ve arriba
-        un_nombre_de_variable:
-            # el valor debería ser un id de servicio
-            id:                   ~
-            # Puesto a servicio o se dejar en blanco
-            type:                 ~
-            value:                ~
-    autoescape:           ~
-    base_template_class:  ~ # Ejemplo: Twig_Template
-    cache:                "%kernel.cache_dir%/twig"
-    charset:              "%kernel.charset%"
-    debug:                "%kernel.debug%"
-    strict_variables:     ~
-    auto_reload:          ~
-    optimizations:        ~
-
                    -
                    -
                    • -
                  • XML
                    <container xmlns="http://symfony.com/schema/dic/services"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xmlns:twig="http://symfony.com/schema/dic/twig"
-    xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd
-                        http://symfony.com/schema/dic/twig http://symfony.com/schema/dic/doctrine/twig-1.0.xsd">
-
-    <twig:config auto-reload="%kernel.debug%" autoescape="true" base-template-class="Twig_Template" cache="%kernel.cache_dir%/twig" charset="%kernel.charset%" debug="%kernel.debug%" strict-variables="false">
-        <twig:form>
-            <twig:resource>MyBundle::form.html.twig</twig:resource>
-        </twig:form>
-        <twig:global key="foo" id="bar" type="service" />
-        <twig:global key="pi">3.14</twig:global>
-    </twig:config>
-</container>
-
                    -
                    -
                    • -
                  • PHP
                    $container->loadFromExtension('twig', array(
-    'form' => array(
-        'resources' => array(
-            'MyBundle::form.html.twig',
-        )
-     ),
-     'globals' => array(
-         'foo' => '@bar',
-         'pi'  => 3.14,
-     ),
-     'auto_reload'         => '%kernel.debug%',
-     'autoescape'          => true,
-     'base_template_class' => 'Twig_Template',
-     'cache'               => '%kernel.cache_dir%/twig',
-     'charset'             => '%kernel.charset%',
-     'debug'               => '%kernel.debug%',
-     'strict_variables'    => false,
-));
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Configurando

                  -
                  -

                  exception_controller

                  -

                  tipo: string predefinido: twig.controller.exception:showAction

                  -

                  Este es el controlador que se activa después de una excepción en cualquier lugar de tu aplicación. El controlador predeterminado (Symfony\Bundle\TwigBundle\Controller\ExceptionController) es el responsable de reproducir plantillas específicas en diferentes condiciones de error (consulta Cómo personalizar páginas de error). La modificación de esta opción es un tema avanzado. Si necesitas personalizar una página de error debes utilizar el enlace anterior. Si necesitas realizar algún comportamiento en una excepción, debes añadir un escucha para el evento kernel.exception (consulta kernel.event_listener).

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/configuration/web_profiler.html b/reference/configuration/web_profiler.html deleted file mode 100644 index 0451a09..0000000 --- a/reference/configuration/web_profiler.html +++ /dev/null @@ -1,163 +0,0 @@ - - - - - - - Configurando WebProfiler — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Configurando WebProfiler

                  -
                  -

                  Configuración predeterminada completa

                  -
                  -
                    -
                  • YAML
                    web_profiler:
-
-    # DEPRECIADO, ya no es útil y lo puedes quitar de tu
-    # configuración sin peligro
-    verbose:              true
-
-    # mostrar la barra de depuración web en la parte inferior
-    # de las páginas con un resumen de información del perfil
-    toolbar:              false
-    position:             bottom
-
-    # te da la oportunidad ver los datos recogidos antes de seguir
-    # la redirección
-    intercept_redirects: false
-
                    -
                    -
                    • -
                  • XML
                    <web-profiler:config
-    toolbar="false"
-    verbose="true"
-    intercept_redirects="false"
-/>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints.html b/reference/constraints.html deleted file mode 100644 index 5cb79e7..0000000 --- a/reference/constraints.html +++ /dev/null @@ -1,211 +0,0 @@ - - - - - - - Referencia de restricciones de validación — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Referencia de restricciones de validación

                  -
                  -
                  -

                  El Validador está diseñado para validar objetos contra restricciones. -En la vida real, una restricción podría ser: «El pastel no se debe quemar». En Symfony2, las restricciones son similares: Son aserciones de que una condición es verdadera.

                  -
                  -

                  Restricciones compatibles

                  -

                  Las siguientes restricciones están disponibles nativamente en Symfony2:

                  -
                  -

                  Restricciones básicas

                  -

                  Estas son las restricciones básicas: utilízalas para afirmar cosas muy básicas sobre el valor de las propiedades o el valor de retorno de los métodos en tu objeto.

                  - -
                  -
                  -

                  Restricciones de cadena

                  - -
                  -
                  -

                  Restricciones de número

                  - -
                  -
                  -

                  Restricciones de fecha

                  - -
                  -
                  -

                  Restricciones de colección

                  - -
                  -
                  -

                  Restricciones de archivo

                  - -
                  -
                  -

                  Restricciones financieras

                  - -
                  -
                  -

                  Otras restricciones

                  - -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/All.html b/reference/constraints/All.html deleted file mode 100644 index 54acfb6..0000000 --- a/reference/constraints/All.html +++ /dev/null @@ -1,240 +0,0 @@ - - - - - - - All — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  All

                  -

                  Cuando se aplica a un arreglo (o a un objeto atravesable), esta restricción te permite aplicar un conjunto de restricciones a cada elemento del arreglo.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\All
                  ValidadorSymfony\Component\Validator\Constraints\AllValidator
                  -
                  -

                  Uso básico

                  -

                  Supongamos que tienes un arreglo de cadenas, y que deseas validar cada entrada de ese arreglo:

                  -
                  -
                    -
                  • YAML
                    # src/UserBundle/Resources/config/validation.yml
-Acme\UserBundle\Entity\User:
-    properties:
-        favoriteColors:
-            - All:
-                - NotBlank:  ~
-                - Length:
-                    min: 5
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    /**
-     * @Assert\All({
-     *     @Assert\NotBlank
-     *     @Assert\Length(min = "5"),
-     * })
-     */
-     protected $favoriteColors = array();
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/UserBundle/Resources/config/validation.xml -->
-<class name="Acme\UserBundle\Entity\User">
-    <property name="favoriteColors">
-        <constraint name="All">
-            <option name="constraints">
-                <constraint name="NotBlank" />
-                <constraint name="Length">
-                    <option name="min">5</option>
-                </constraint>
-            </option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('favoriteColors', new Assert\All(array(
-            'constraints' => array(
-                new Assert\NotBlank(),
-                new Assert\Length(array('limit' => 5)),
-            ),
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Ahora, cada entrada en el arreglo favoriteColors será validada para que no esté en blanco y que por lo menos sea de 5 caracteres.

                  -
                  -
                  -

                  Opciones

                  -
                  -

                  constraints

                  -

                  tipo: array [opción predeterminada]

                  -

                  Esta opción requerida es el arreglo de restricciones de validación que deseas aplicar a cada elemento del arreglo subyacente.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Blank.html b/reference/constraints/Blank.html deleted file mode 100644 index 2d24292..0000000 --- a/reference/constraints/Blank.html +++ /dev/null @@ -1,221 +0,0 @@ - - - - - - - Blank — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Blank

                  -

                  Valida que un valor está en blanco, es definida como igual a una cadena en blanco o igual a null. Para forzar que un valor estrictamente sea igual a null, consulta la restricción Null. Para forzar que el valor no esté en blanco, consulta NotBlank.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Blank
                  ValidadorSymfony\Component\Validator\Constraints\BlankValidator
                  -
                  -

                  Uso básico

                  -

                  Si por alguna razón, deseas asegurarte de que la propiedad firstName de una clase Author está en blanco, puedes hacer lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        firstName:
-            - Blank: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Blank()
-     */
-    protected $firstName;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="firstName">
-        <constraint name="Blank" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', new Assert\Blank());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should be blank (Este valor debe estar en blanco)

                  -

                  Este es el mensaje que se mostrará si el valor no está en blanco.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Callback.html b/reference/constraints/Callback.html deleted file mode 100644 index 4262140..0000000 --- a/reference/constraints/Callback.html +++ /dev/null @@ -1,345 +0,0 @@ - - - - - - - Callback — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Callback

                  -

                  El propósito de la aserción Callback es permitirte crear reglas de validación completamente personalizadas y asignar errores de validación a campos específicos de tu objeto. Si estás utilizando la validación con formularios, esto significa que puedes hacer que estos errores personalizados se muestren junto a un campo específico, en lugar de simplemente en la parte superior del formulario.

                  -

                  Este proceso funciona especificando uno o más métodos Callback, cada uno de los cuales se llama durante el proceso de validación. Cada uno de estos métodos puede hacer cualquier cosa, incluyendo la creación y asignación de errores de validación.

                  -
                  -

                  Nota

                  -

                  Un método retrollamado en sí no falla o devuelve cualquier valor. En su lugar, como verás en el ejemplo, un método retrollamado tiene la posibilidad de agregar «violaciones» de validación directamente.

                  -
                  - ---- - - - - - - - - - - - - - - -
                  Aplica aclase
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Callback
                  ValidadorSymfony\Component\Validator\Constraints\CallbackValidator
                  -
                  -

                  Configurando

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    constraints:
-        - Callback:
-            methods:   [isAuthorValid]
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-/**
- * @Assert\Callback(methods={"isAuthorValid"})
- */
-class Author
-{
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <constraint name="Callback">
-        <option name="methods">
-            <value>isAuthorValid</value>
-        </option>
-    </constraint>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addConstraint(new Assert\Callback(array(
-            'methods' => array('isAuthorValid'),
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  El método Callback

                  -

                  The callback method is passed a special ExecutionContextInterface object. Puedes establecer «violaciones» directamente en el objeto y determinar a qué campo se deben atribuir estos errores:

                  -
                  // ...
-use Symfony\Component\Validator\ExecutionContextInterface;
-
-class Author
-{
-    // ...
-    private $firstName;
-
-    public function isAuthorValid(ExecutionContextInterface $context)
-    {
-        // de alguna manera hay un arreglo de "nombres ficticios"
-        $fakeNames = array();
-
-        // comprueba si el nombre en realidad es un nombre ficticio
-        if (in_array($this->getFirstName(), $fakeNames)) {
-            $context->addViolationAt('firstname', 'This name sounds totally fake!', array(), null);
-        }
-    }
-}
-
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  methods

                  -

                  tipo: array predeterminado: array() [opción predeterminada]

                  -

                  Este es un arreglo de los métodos que se deben ejecutar durante el proceso de validación. Cada método puede tener uno de los siguientes formatos:

                  -
                    -

                  1. Cadena de nombre del método

                    -
                    -

                    If the name of a method is a simple string (e.g. isAuthorValid), that -method will be called on the same object that’s being validated and the -ExecutionContextInterface will be the only argument (see the above example).

                    -
                    -
                    2. -

                  2. Arreglo estático de retrollamada

                    -
                    -

                    También puedes especificar cada método como un arreglo de retrollamada estándar:

                    -
                    -
                      -
                    • YAML
                      # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    constraints:
-        - Callback:
-            methods:
-                -    [Acme\BlogBundle\MyStaticValidatorClass, isAuthorValid]
-
                      -
                      -
                      • -
                    • Annotations
                      // src/Acme/BlogBundle/Entity/Author.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-/**
- * @Assert\Callback(methods={
- *     { "Acme\BlogBundle\MyStaticValidatorClass", "isAuthorValid"}
- * })
- */
-class Author
-{
-}
-
                      -
                      -
                      • -
                    • XML
                      <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <constraint name="Callback">
-        <option name="methods">
-            <value>Acme\BlogBundle\MyStaticValidatorClass</value>
-            <value>isAuthorValid</value>
-        </option>
-    </constraint>
-</class>
-
                      -
                      -
                      • -
                    • PHP
                      // src/Acme/BlogBundle/Entity/Author.php
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\Callback;
-
-class Author
-{
-    public $name;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addConstraint(new Callback(array(
-            'methods' => array('isAuthorValid'),
-        )));
-    }
-}
-
                      -
                      -
                      • -
                    -
                    -

                    En este caso, el método estático isAuthorValid será llamado en la clase Acme\BlogBundle\MyStaticValidatorClass. It’s passed both the original -object being validated (e.g. Author) as well as the ExecutionContextInterface:

                    -
                    namespace Acme\BlogBundle;
-
-use Symfony\Component\Validator\ExecutionContextInterface;
-use Acme\BlogBundle\Entity\Author;
-
-class MyStaticValidatorClass
-{
-    public static function isAuthorValid(Author $author, ExecutionContextInterface $context)
-    {
-        // ...
-    }
-}
-
                    -
                    -
                    -

                    Truco

                    -

                    Si especificas la restricción Retrollamada a través de PHP, entonces también tienes la opción de hacer tu retrollamada o bien un cierre PHP o una retrollamada no estática. Esto no es posible actualmente, sin embargo, para especificar un servicio como una restricción. Para validar usando un servicio, debes crear una restricción de validación personalizada y añadir la nueva restricción a tu clase.

                    -
                    -
                    -
                    3. -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/CardScheme.html b/reference/constraints/CardScheme.html deleted file mode 100644 index 38607db..0000000 --- a/reference/constraints/CardScheme.html +++ /dev/null @@ -1,252 +0,0 @@ - - - - - - - CardScheme — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  CardScheme

                  -

                  -Nuevo en la versión 2.2: La validación CardScheme es nueva en Symfony 2.2.

                  -

                  Esta restricción garantiza que un número de tarjeta de crédito es válido para una determinada compañía de tarjetas de crédito. La puedes usar para validar el número antes de intentar iniciar un pago a través de una pasarela de pago.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\CardScheme
                  ValidadorSymfony\Component\Validator\Constraints\CardSchemeValidator
                  -
                  -

                  Uso básico

                  -

                  Para utilizar el validador CardScheme, sencillamente aplícalo a una propiedad o método en un objeto que contenga un número de tarjeta de crédito.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/SubscriptionBundle/Resources/config/validation.yml
-Acme\SubscriptionBundle\Entity\Transaction:
-    properties:
-        cardNumber:
-            - CardScheme:
-                schemes: [VISA]
-                message: El número de tu tarjeta de crédito no es válido.
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/SubscriptionBundle/Resources/config/validation.xml -->
-<class name="Acme\SubscriptionBundle\Entity\Transaction">
-    <property name="cardNumber">
-        <constraint name="CardScheme">
-            <option name="schemes">
-                <value>VISA</value>
-            </option>
-            <option name="message">El número de tu tarjeta de crédito no es válido.</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/SubscriptionBundle/Entity/Transaction.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Transaction
-{
-    /**
-     * @Assert\CardScheme(schemes = {"VISA"}, message = "El número de tu tarjeta de crédito no es válido.")
-     */
-    protected $cardNumber;
-}
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/SubscriptionBundle/Entity/Transaction.php
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\CardScheme;
-
-class Transaction
-{
-    protected $cardNumber;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('cardSchema', new CardScheme(array(
-            'schemes' => array(
-                'VISA'
-            ),
-            'message' => 'El número de tu tarjeta de crédito no es válido.',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones disponibles

                  -
                  -
                  -

                  schemes

                  -

                  tipo: mixed [opción default]

                  -

                  Esta opción es obligatoria y representa el nombre del número de esquema utilizado para validar el número de la tarjeta de crédito, este puede ser una cadena o un arreglo. Los valores válidos son:

                  -
                    -
                  • AMEX
                    • -
                  • CHINA_UNIONPAY
                    • -
                  • DINERS
                    • -
                  • DISCOVER
                    • -
                  • INSTAPAYMENT
                    • -
                  • JCB
                    • -
                  • LASER
                    • -
                  • MAESTRO
                    • -
                  • MASTERCARD
                    • -
                  • VISA
                    • -
                  -

                  Para más información sobre los esquemas utilizados, ve Wikipedia: Número de identificación del emisor (IIN por «Issuer identification number»).

                  -
                  -

                  message

                  -

                  tipo: string predefinido: Unsupported card type or invalid card number (Tipo de tarjeta no compatible o número de tarjeta nulo)

                  -

                  El mensaje mostrado cuándo el valor no pasa la comprobación del CardScheme.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Choice.html b/reference/constraints/Choice.html deleted file mode 100644 index cc9b06e..0000000 --- a/reference/constraints/Choice.html +++ /dev/null @@ -1,426 +0,0 @@ - - - - - - - Choice — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Choice

                  -

                  Esta restricción se utiliza para asegurar que el valor dado es uno de un determinado conjunto de opciones válidas. También la puedes utilizar para comprobar que cada elemento de un arreglo de elementos es una de esas opciones válidas.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Choice
                  ValidadorSymfony\Component\Validator\Constraints\ChoiceValidator
                  -
                  -

                  Uso básico

                  -

                  La idea básica de esta restricción es que le proporciones un arreglo de valores válidos (esto lo puedes hacer de varias maneras) y ella compruebe que el valor de la propiedad dada existe en el arreglo.

                  -

                  Si tu lista de opciones válidas es simple, la puedes pasar directamente a través de la opción choices:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        gender:
-            - Choice:
-                choices:  [male, female]
-                message:  Choose a valid gender.
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Choice(choices = {"male", "female"}, message = "Choose a valid gender.")
-     */
-    protected $gender;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="gender">
-        <constraint name="Choice">
-            <option name="choices">
-                <value>male</value>
-                <value>female</value>
-            </option>
-            <option name="message">Choose a valid gender.</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/EntityAuthor.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    protected $gender;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('gender', new Assert\Choice(array(
-            'choices' => array('male', 'female'),
-            'message' => 'Choose a valid gender.',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Suministrando opciones con una función retrollamada

                  -

                  También puedes utilizar una función retrollamada para especificar tus opciones. Esto es útil si deseas mantener tus opciones en una ubicación central para que, por ejemplo, puedas acceder fácilmente a las opciones para validación o para construir un elemento de formulario seleccionado.

                  -
                  // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-class Author
-{
-    public static function getGenders()
-    {
-        return array('male', 'female');
-    }
-}
-
                  -
                  -

                  Puedes pasar el nombre de este método a la opción callback de la restricción Choice.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        gender:
-            - Choice: { callback: getGenders }
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Choice(callback = "getGenders")
-     */
-    protected $gender;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="gender">
-        <constraint name="Choice">
-            <option name="callback">getGenders</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/EntityAuthor.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    protected $gender;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('gender', new Assert\Choice(array(
-            'callback' => 'getGenders',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Si la retrollamada estática se almacena en una clase diferente, por ejemplo Util, puedes pasar el nombre de clase y el método como un arreglo.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        gender:
-            - Choice: { callback: [Util, getGenders] }
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Choice(callback = {"Util", "getGenders"})
-     */
-    protected $gender;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="gender">
-        <constraint name="Choice">
-            <option name="callback">
-                <value>Util</value>
-                <value>getGenders</value>
-            </option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/EntityAuthor.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    protected $gender;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('gender', new Assert\Choice(array(
-            'callback' => array('Util', 'getGenders'),
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones disponibles

                  -
                  -

                  choices

                  -

                  tipo: array [opción predeterminada]

                  -

                  Una opción requerida (a menos que especifiques callback) — esta es la gran variedad de opciones que se deben considerar en el conjunto válido. El valor de entrada se compara contra ese arreglo.

                  -
                  -
                  -

                  Callback

                  -

                  tipo: string|array|Closure

                  -

                  Este es un método retrollamado que puedes utilizar en lugar de la opción choices para devolver el arreglo de opciones. Consulta Suministrando opciones con una función retrollamada para más detalles sobre su uso.

                  -
                  -
                  -

                  multiple

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si esta opción es true, se espera que el valor de entrada sea un arreglo en lugar de un solo valor escalar. La restricción debe verificar que cada valor del arreglo de entrada se pueda encontrar en el arreglo de opciones válidas. Si no se puede encontrar alguno de los valores ingresados, la validación fallará.

                  -
                  -
                  -

                  min

                  -

                  tipo: integer

                  -

                  Si la opción multiple es true, entonces puedes usar la opción min para forzar que por lo menos se seleccionen XX valores. Por ejemplo, si min es 3, pero el arreglo de entrada sólo contiene dos elementos válidos, la validación fallará.

                  -
                  -
                  -

                  max

                  -

                  tipo: integer

                  -

                  Si la opción multiple es true, entonces puedes usar la opción max para forzar que no se seleccionen más de XX valores. Por ejemplo, si max es 3, pero el arreglo ingresado consta de 4 elementos válidos, la validación fallará.

                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: The value you selected is not a valid choice (El valor que seleccionaste no es una opción válida)

                  -

                  Este es el mensaje que recibirás si la opción multiple se establece en false, y el valor subyacente no es válido en el arreglo de opciones.

                  -
                  -
                  -

                  multipleMessage

                  -

                  tipo: string predefinido: One or more of the given values is invalid (Uno o más de los valores indicados no es válido)

                  -

                  Este es el mensaje que recibirás si la opción multiple se establece en true, y uno de los valores del arreglo subyacente que se está comprobando no está en el arreglo de opciones válidas.

                  -
                  -
                  -

                  minMessage

                  -

                  tipo: string predefinido: You must select at least {{ limit }} choices (Por lo menos debes elegir {{ limit }} opciones)

                  -

                  Este es el mensaje de error de validación que se muestra cuando el usuario elige demasiado pocas opciones para la opción min.

                  -
                  -
                  -

                  maxMessage

                  -

                  tipo: string predefinido: You must select at most {{ limit }} choices (Máximo debes elegir {{ limit }} opciones)

                  -

                  Este es el mensaje de error de validación que se muestra cuando el usuario elige más opciones para la opción max.

                  -
                  -
                  -

                  strict

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el validador también comprobará el tipo del valor ingresado. Específicamente, este valor se pasa como el tercer argumento del método in_array de PHP cuando compruebas si un valor está en el arreglo de opciones válidas.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Collection.html b/reference/constraints/Collection.html deleted file mode 100644 index f30e7d1..0000000 --- a/reference/constraints/Collection.html +++ /dev/null @@ -1,382 +0,0 @@ - - - - - - - Collection — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Collection

                  -

                  Esta restricción se utiliza cuando los datos subyacentes son una colección (es decir, un arreglo o un objeto que implemente Traversable y ArrayAccess), pero que te gustaría validar las distintas claves de la colección en diferentes maneras. Por ejemplo, puedes validar la clave email usando la restricción Email y la clave inventario de la colección con la restricción Range.

                  -

                  Esta restricción también puede asegurarse de que ciertas claves de la colección están presentes y que no existen claves adicionales.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Collection
                  ValidadorSymfony\Component\Validator\Constraints\CollectionValidator
                  -
                  -

                  Uso básico

                  -

                  La restricción Collection te permite validar individualmente las diferentes claves de una colección. Tomemos el siguiente ejemplo:

                  -
                  // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-class Author
-{
-    protected $profileData = array(
-        'personal_email',
-        'short_bio',
-    );
-
-    public function setProfileData($key, $value)
-    {
-        $this->profileData[$key] = $value;
-    }
-}
-
                  -
                  -

                  Para validar que el elemento correo_electronico_personal de la propiedad datosDelPerfil es una dirección de correo electrónico válida y que el elemento mini_biografia no está en blanco, pero no tiene más de 100 caracteres de longitud, debes hacer lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        profileData:
-            - Collection:
-                fields:
-                    personal_email: Email
-                    short_bio:
-                        - NotBlank
-                        - Length:
-                            max:   100
-                            maxMessage: Your short bio is too long!
-                allowMissingFields: true
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Collection(
-     *     fields = {
-     *         "personal_email" = @Assert\Email,
-     *         "short_bio" = {
-     *             @Assert\NotBlank(),
-     *             @Assert\Length(
-     *                 max = 100,
-     *                 maxMessage = "Your bio is too long!"
-     *             )
-     *         }
-     *     },
-     *     allowMissingfields = true
-     * )
-     */
-     protected $profileData = array(
-         'personal_email',
-         'short_bio',
-     );
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="profileData">
-        <constraint name="Collection">
-            <option name="fields">
-                <value key="personal_email">
-                    <constraint name="Email" />
-                </value>
-                <value key="short_bio">
-                    <constraint name="NotBlank" />
-                    <constraint name="Length">
-                        <option name="max">100</option>
-                        <option name="maxMessage">Your bio is too long!</option>
-                    </constraint>
-                </value>
-            </option>
-            <option name="allowMissingFields">true</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    private $options = array();
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('profileData', new Assert\Collection(array(
-            'fields' => array(
-                'personal_email' => new Assert\Email(),
-                'lastName' => array(
-                    new Assert\NotBlank(),
-                    new Assert\Length(array("max" => 100)),
-                ),
-            ),
-            'allowMissingFields' => true,
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Presencia y ausencia de campos

                  -

                  De manera predeterminada, esta restricción valida más que simplemente si o no los campos individuales de la colección pasan sus restricciones asignadas. De hecho, si falta cualquiera de las claves de una colección o si hay alguna clave desconocida en la colección, lanzará errores de validación.

                  -

                  Si deseas permitir que las claves de la colección estén ausentes o si quisieras permitir claves «extra» en la colección, puedes modificar las opciones allowMissingFields y allowExtraFields, respectivamente. En el ejemplo anterior, la opción allowMissingFields se fijó en true, lo cual significa que si cualquiera de las propiedades personal_email o short_bio no estuviera en $personalData, no ocurrirá ningún error de validación.

                  -

                  -Nuevo en la versión 2.1: The Required and Optional constraints are new to Symfony 2.1.

                  -
                  -
                  -

                  Required and Optional Field Constraints

                  -

                  Constraints for fields within a collection can be wrapped in the Required or -Optional constraint to control whether they should always be applied (Required) -or only applied when the field is present (Optional).

                  -

                  For instance, if you want to require that the personal_email field of the -profileData array is not blank and is a valid email but the alternate_email -field is optional but must be a valid email if supplied, you can do the following:

                  -
                  -
                    -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Collection(
-     *     fields={
-     *         "personal_email"  = @Assert\Collection\Required({@Assert\NotBlank, @Assert\Email}),
-     *         "alternate_email" = @Assert\Collection\Optional({@Assert\Email}),
-     *     }
-     * )
-     */
-     protected $profileData = array(
-         'personal_email',
-     );
-}
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    protected $profileData = array('personal_email');
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('profileData', new Assert\Collection(array(
-            'fields' => array(
-                'personal_email'  => new Assert\Collection\Required(array(new Assert\NotBlank(), new Assert\Email())),
-                'alternate_email' => new Assert\Collection\Optional(array(new Assert\Email())),
-            ),
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Even without allowMissingFields set to true, you can now omit the alternate_email -property completely from the profileData array, since it is Optional. -However, if the the personal_email field does not exist in the array, -the NotBlank constraint will still be applied (since it is wrapped in -Required) and you will receive a constraint violation.

                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  fields

                  -

                  tipo: array [opción predeterminada]

                  -

                  Esta opción es obligatoria, y es un arreglo asociativo que define todas las claves de la colección y, para cada clave, exactamente, qué validaciones se deben ejecutar contra ese elemento de la colección.

                  -
                  -
                  -

                  allowExtraFields

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si esta opción está establecida en false y la colección subyacente contiene uno o más elementos que no están incluidos en la opción fields, devolverá un error de validación. Si se define como true, está bien tener campos adicionales.

                  -
                  -
                  -

                  extraFieldsMessage

                  -

                  tipo: Boolean predeterminado: The fields {{ fields }} were not expected (Los campos {{ fields }} no se esperaban)

                  -

                  El mensaje aparece si allowExtraFields es false y se detecta un campo adicional.

                  -
                  -
                  -

                  allowMissingFields

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si esta opción está establecida en false y uno o más campos de la opción fields no están presentes en la colección subyacente, devolverá un error de validación. Si se define como true, está bien si algunos campos de la opción fields no están presentes en la colección subyacente.

                  -
                  -
                  -

                  missingFieldsMessage

                  -

                  tipo: Boolean predeterminado: The fields {{ fields }} are missing (Faltan los campos {{ fields }})

                  -

                  El mensaje aparece si allowMissingFields es false y uno o más campos no se encuentran en la colección subyacente.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Count.html b/reference/constraints/Count.html deleted file mode 100644 index 44aa211..0000000 --- a/reference/constraints/Count.html +++ /dev/null @@ -1,267 +0,0 @@ - - - - - - - Count — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Count

                  -

                  Valida que el elemento de una determinada colección (es decir, un arreglo o un objeto que implemente a Countable) esté entre algún valor mínimo y máximo.

                  -

                  -Nuevo en la versión 2.1: La restricción Count se agregó en Symfony 2.1.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Count
                  ValidadorSymfony\Component\Validator\Constraints\CountValidator
                  -
                  -

                  Uso básico

                  -

                  Para verificar que el arreglo de campos emails contiene entre 1 y 5 elementos puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Participant:
-    properties:
-        emails:
-            - Count:
-                min: 1
-                max: 5
-                minMessage: "Debes especificar cuando menos una dirección de correo electrónico"
-                maxMessage: "No puedes especificar más de {{ limit }} direcciones de correo electrónico"
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\Count(
-     *      min = "1",
-     *      max = "5",
-     *      minMessage = "Debes especificar al menos una dirección de correo electrónico",
-     *      maxMessage = "No puedes especificar más de {{ limit }} direcciones de correo electrónico"
-     * )
-     */
-     protected $emails = array();
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/EventBundle/Resources/config/validation.xml -->
-<class name="Acme\EventBundle\Entity\Participant">
-    <property name="emails">
-        <constraint name="Count">
-            <option name="min">1</option>
-            <option name="max">5</option>
-            <option name="minMessage">Debes especificar cuando menos una dirección de correo electrónico</option>
-            <option name="maxMessage">No puedes especificar más de {{ limit }} direcciones de correo electrónico</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    public static function loadValidatorMetadata(ClassMetadata $data)
-    {
-        $metadata->addPropertyConstraint('emails', new Assert\Count(array(
-            'min'        => 1,
-            'max'        => 5,
-            'minMessage' => 'You must specify at least one email',
-            'maxMessage' => 'You cannot specify more than {{ limit }} emails',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  min

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor de cantidad mínima. La validación fallará si la cantidad de elementos de la colección suministrados menor que este valor mínimo.

                  -
                  -
                  -

                  max

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es la cantidad del valor máximo. La validación fallará si la cantidad de elementos dados de la colección es más grande que este valor máximo.

                  -
                  -
                  -

                  minMessage

                  -

                  tipo: string predefinido: This collection should contain {{ limit }} elements or more. (Esta colección debe contener {{ limit }} elementos o más).

                  -

                  El mensaje que será mostrado si la cantidad de elementos de la colección subyacente es menor que la opción min.

                  -
                  -
                  -

                  maxMessage

                  -

                  tipo: string predefinido: This collection should contain {{ limit }} elements or less. (Esta colección debe contener {{ limit }} elementos o menos.).

                  -

                  El mensaje que será mostrado si la cantidad de elementos de la colección subyacente es mayor que la opción max.

                  -
                  -
                  -

                  exactMessage

                  -

                  tipo: string predefinido: This collection should contain exactly {{ limit }} elements. (Esta colección debe contener exactamente {{ limit }} elementos.).

                  -

                  El mensaje que será mostrado si los valores min y max son iguales y la cantidad de elementos de la colección subyacente -no es exactamente este valor.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Country.html b/reference/constraints/Country.html deleted file mode 100644 index 50382ee..0000000 --- a/reference/constraints/Country.html +++ /dev/null @@ -1,220 +0,0 @@ - - - - - - - Country — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Country

                  -

                  Valida que un valor es un código de país de dos letras válido.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Country
                  ValidadorSymfony\Component\Validator\Constraints\CountryValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/UserBundle/Resources/config/validation.yml
-Acme\UserBundle\Entity\User:
-    properties:
-        country:
-            - Country:
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    /**
-     * @Assert\Country
-     */
-     protected $country;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/UserBundle/Resources/config/validation.xml -->
-<class name="Acme\UserBundle\Entity\User">
-    <property name="country">
-        <constraint name="Country" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    public static function loadValidationMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('country', new Assert\Country());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid country (Este valor no es un país válido)

                  -

                  Este mensaje se muestra si la cadena no es un código de país válido.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Date.html b/reference/constraints/Date.html deleted file mode 100644 index 9832cb1..0000000 --- a/reference/constraints/Date.html +++ /dev/null @@ -1,220 +0,0 @@ - - - - - - - Date — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Date

                  -

                  Valida que un valor sea una fecha válida, es decir, ya sea un objeto DateTime o una cadena (o un objeto que se pueda convertir en una cadena) y que sigue un formato «AAAA-MM-DD» válido.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Date
                  ValidadorSymfony\Component\Validator\Constraints\DateValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        birthday:
-            - Date: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Date()
-     */
-     protected $birthday;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="birthday">
-        <constraint name="Date" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('birthday', new Assert\Date());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid date (Este valor no es una fecha válida)

                  -

                  Este mensaje se muestra si los datos subyacentes no son una fecha válida.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/DateTime.html b/reference/constraints/DateTime.html deleted file mode 100644 index 47969b0..0000000 --- a/reference/constraints/DateTime.html +++ /dev/null @@ -1,220 +0,0 @@ - - - - - - - DateTime — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  DateTime

                  -

                  Valida que un valor sea una marca de tiempo válida, es decir, ya sea un objeto DateTime o una cadena (o un objeto que se pueda convertir en una cadena) y que sigue un formato «AAAA-MM-DD HH:MM:SS» válido.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\DateTime
                  ValidadorSymfony\Component\Validator\Constraints\DateTimeValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        createdAt:
-            - DateTime: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\DateTime()
-     */
-     protected $createdAt;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/UserBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="createdAt">
-        <constraint name="DateTime" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('createdAt', new Assert\DateTime());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid datetime (Estos valores no son una fecha y hora válida)

                  -

                  Este mensaje se muestra si los datos subyacentes no son una fecha y hora válidas.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Email.html b/reference/constraints/Email.html deleted file mode 100644 index 90d38dd..0000000 --- a/reference/constraints/Email.html +++ /dev/null @@ -1,251 +0,0 @@ - - - - - - - Email — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Email

                  -

                  Valida que un valor sea una dirección de correo electrónico válida. El valor subyacente se convierte en una cadena antes de validarlo.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Email
                  ValidadorSymfony\Component\Validator\Constraints\EmailValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        email:
-            - Email:
-                mensaje: The email "{{ value }}" is not a valid email.
-                checkMX: true
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Email(
-     *     message = "The email '{{ value }}' is not a valid email.",
-     *     checkMX = true
-     * )
-     */
-     protected $email;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<?xml version="1.0" encoding="UTF-8" ?>
-<constraint-mapping xmlns="http://symfony.com/schema/dic/constraint-mapping"
-    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-    xsi:schemaLocation="http://symfony.com/schema/dic/constraint-mapping http://symfony.com/schema/dic/constraint-mapping/constraint-mapping-1.0.xsd">
-
-    <class name="Acme\BlogBundle\Entity\Author">
-        <property name="email">
-            <constraint name="Email">
-                <option name="message">The email "{{ value }}" is not a valid email.</option>
-                <option name="checkMX">true</option>
-            </constraint>
-        </property>
-    </class>
-</constraint-mapping>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('email', new Assert\Email(array(
-            'message' => 'The email "{{ value }}" is not a valid email.',
-            'checkMX' => true,
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid email address (Este valor no es una dirección de correo electrónico válida)

                  -

                  Este mensaje se muestra si los datos subyacentes no son una dirección de correo electrónico válida.

                  -
                  -
                  -

                  checkMX

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, entonces puedes utilizar la función checkdnsrr de PHP para comprobar la validez de los registros MX del servidor del correo electrónico dado.

                  -
                  -
                  -

                  checkHost

                  -

                  -Nuevo en la versión 2.1: La opción checkHost se añadió en Symfony 2.1

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, entonces puedes utilizar la función checkdnsrr de PHP para comprobar la validez de los registros MX, A o AAAA del servidor del correo electrónico dado.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/False.html b/reference/constraints/False.html deleted file mode 100644 index 05a491c..0000000 --- a/reference/constraints/False.html +++ /dev/null @@ -1,245 +0,0 @@ - - - - - - - False — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  False

                  -

                  Valida que un valor es false. En concreto, esta comprueba si el valor es exactamente false, exactamente el número entero 0, o exactamente la cadena «0».

                  -

                  Además consulta True.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\False
                  ValidadorSymfony\Component\Validator\Constraints\FalseValidator
                  -
                  -

                  Uso básico

                  -

                  La restricción False se puede aplicar a una propiedad o a un método «captador», pero comúnmente, es más útil en este último caso. Por ejemplo, supongamos que quieres garantizar que una propiedad state no está en un arreglo dinámico de invalidStates. En primer lugar, crearías un método «captador»:

                  -
                  protected $state;
-
-protected $invalidStates = array();
-
-public function isStateInvalid()
-{
-    return in_array($this->state, $this->invalidStates);
-}
-
                  -
                  -

                  En este caso, el objeto subyacente es válido sólo si el método isStateInvalid devuelve false:

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author
-    getters:
-        stateInvalid:
-            - "False":
-                mensaje: You've entered an invalid state.
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\False(
-     *     message = "You've entered an invalid state."
-     * )
-     */
-     public function isStateInvalid()
-     {
-        // ...
-     }
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <getter property="stateInvalid">
-        <constraint name="False">
-            <option name="message">You've entered an invalid state.</option>
-        </constraint>
-    </getter>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addGetterConstraint('stateInvalid', new Assert\False());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Prudencia

                  -

                  Cuando utilices YAML, asegúrate de rodear False entre comillas ("False") o de lo contrario YAML lo convertirá en un valor booleano.

                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should be false (Este valor debe ser 'false')

                  -

                  Este mensaje se muestra si el dato subyacente no es false.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/File.html b/reference/constraints/File.html deleted file mode 100644 index 1768f81..0000000 --- a/reference/constraints/File.html +++ /dev/null @@ -1,330 +0,0 @@ - - - - - - - File — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  File

                  -

                  Valida que un valor es un «archivo» legítimo, el cual puede ser uno de los siguientes:

                  -
                    -
                  • Una cadena (u objeto con un método __toString()) que representa una ruta a un archivo existente;
                    • -
                  • Un objeto Symfony\Component\HttpFoundation\File\File válido (incluidos los objetos de la clase Symfony\Component\HttpFoundation\File\UploadedFile).
                    • -
                  -

                  Esta restricción se usa comúnmente en formularios con el tipo de formulario file (archivo).

                  -
                  -

                  Truco

                  -

                  Si el archivo que estás validando es una imagen, prueba la restricción Image.

                  -
                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\File
                  ValidadorSymfony\Component\Validator\Constraints\FileValidator
                  -
                  -

                  Uso básico

                  -

                  Esta restricción se utiliza comúnmente en una propiedad que se debe pintar en un formulario con tipo de formulario archivo. Por ejemplo, supongamos que estás creando un formulario de autor donde puedes cargar una «biografía» PDF para el autor. En tu formulario, la propiedad archivoBio sería de tipo file. -La clase Autor podría ser la siguiente:

                  -
                  // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\HttpFoundation\File\File;
-
-class Author
-{
-    protected $bioFile;
-
-    public function setBioFile(File $file = null)
-    {
-        $this->bioFile = $file;
-    }
-
-    public function getBioFile()
-    {
-        return $this->bioFile;
-    }
-}
-
                  -
                  -

                  Para garantizar que el objeto bioFile es un File válido, y que está por debajo de un determinado tamaño de archivo y es un archivo PDF válido, añade lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        bioFile:
-            - File:
-                maxSize: 1024k
-                mimeTypes: [application/pdf, application/x-pdf]
-                mimeTypesMessage: Please upload a valid PDF
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\File(
-     *     maxSize = "1024k",
-     *     mimeTypes = {"application/pdf", "application/x-pdf"},
-     *     mimeTypesMessage = "Please upload a valid PDF"
-     * )
-     */
-    protected $bioFile;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="bioFile">
-        <constraint name="File">
-            <option name="maxSize">1024k</option>
-            <option name="mimeTypes">
-                <value>application/pdf</value>
-                <value>application/x-pdf</value>
-            </option>
-            <option name="mimeTypesMessage">Please upload a valid PDF</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('bioFile', new Assert\File(array(
-            'maxSize' => '1024k',
-            'mimeTypes' => array(
-                'application/pdf',
-                'application/x-pdf',
-            ),
-            'mimeTypesMessage' => 'Please upload a valid PDF',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  La propiedad bioFile es validada para garantizar que se trata de un archivo real. -Su tamaño y tipo MIME también son validados por las correspondientes opciones especificadas.

                  -
                  -
                  -

                  Opciones

                  -
                  -

                  maxSize

                  -

                  tipo: mixed

                  -

                  Si se establece, el tamaño del archivo subyacente debe estar por debajo de ese tamaño de archivo para ser válido. El tamaño del archivo se puede dar en uno de los siguientes formatos:

                  -
                    -
                  • bytes: Para especificar el maxSize en bytes, pasa un valor que sea totalmente numérico (por ejemplo, 4096);
                    • -
                  • kilobytes: Para especificar el maxSize en kilobytes, pasa un número con una «k» minúscula como sufijo (por ejemplo, 200k);
                    • -
                  • megabytes: Para especificar el maxSize en megabytes, pasa un número con una «M» como sufijo (por ejemplo, 4M).
                    • -
                  -
                  -
                  -

                  mimeTypes

                  -

                  tipo: array o string

                  -

                  Si lo estableces, el validador comprobará que el tipo mime del archivo subyacente sea igual al tipo mime proporcionado (en el caso de una cadena) o existe en la colección de determinados tipos mime (en el caso de un arreglo).

                  -

                  Puedes encontrar una lista de tipos mime existentes en el sitio web de IANA

                  -
                  -
                  -

                  maxSizeMessage

                  -

                  tipo: string predefinido: The file is too large ({{ size }}). Allowed maximum size is {{ limit }} (El archivo es demasiado grande. El tamaño máximo permitido es {{ limit }})

                  -

                  El mensaje mostrado si el archivo es mayor que la opción maxSize.

                  -
                  -
                  -

                  mimeTypesMessage

                  -

                  tipo: string predefinido: The mime type of the file is invalid ({{ type }}). Allowed mime types are {{ types }} (El tipo mime del archivo ({{ type }}) no es válido. Los tipos mime permitidos son {{ types }})

                  -

                  El mensaje mostrado si el tipo mime del archivo no es un tipo mime válido para la opción mimeTypes.

                  -
                  -
                  -

                  notFoundMessage

                  -

                  tipo: string predefinido: The file could not be found (No se pudo encontrar el archivo)

                  -

                  El mensaje aparece si no se puede encontrar algún archivo en la ruta especificada. Este error sólo es probable si el valor subyacente es una cadena de ruta, puesto que un objeto File no se puede construir con una ruta de archivo no válida.

                  -
                  -
                  -

                  notReadableMessage

                  -

                  tipo: string predefinido: The file is not readable (No se puede leer el archivo)

                  -

                  El mensaje aparece si el archivo existe, pero la función is_readable de PHP falla cuando se le pasa la ruta del archivo.

                  -
                  -
                  -

                  uploadIniSizeErrorMessage

                  -

                  tipo: string predefinido: The file is too large. Allowed maximum size is {{ limit }} (El archivo es demasiado grande. El tamaño máximo permitido es {{ limit }})

                  -

                  El mensaje que se muestra si el archivo subido es mayor que la configuración de upload_max_filesize en php.ini.

                  -
                  -
                  -

                  uploadFormSizeErrorMessage

                  -

                  tipo: string predefinido: The file is too large (El archivo es demasiado grande)

                  -

                  El mensaje que se muestra si el archivo subido es mayor que el permitido por el campo HTML para la entrada de archivos.

                  -
                  -
                  -

                  uploadErrorMessage

                  -

                  tipo: string predefinido: The file could not be uploaded (No se puede subir el archivo)

                  -

                  El mensaje que se muestra si el archivo cargado no se puede subir por alguna razón desconocida, tal como cuando la subida del archivo ha fallado o no se puede escribir en el disco.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Image.html b/reference/constraints/Image.html deleted file mode 100644 index b8608d9..0000000 --- a/reference/constraints/Image.html +++ /dev/null @@ -1,333 +0,0 @@ - - - - - - - Image — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Image

                  -

                  La restricción Image funciona exactamente igual que la restricción File, salvo que sus opciones mimeTypes y mimeTypesMessage se configuran automáticamente para trabajar con archivos de imagen específicamente.

                  -

                  Además, a partir de Symfony 2.1, cuentas con opciones que puedes validar contra la anchura y altura de la imagen.

                  -

                  Consulta la restricción File para la mayor parte de la documentación relativa a esta restricción.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\File
                  ValidadorSymfony\Component\Validator\Constraints\FileValidator
                  -
                  -

                  Uso básico

                  -

                  Esta restricción se utiliza comúnmente en una propiedad que se debe pintar en un formulario con tipo de formulario archivo. Por ejemplo, supongamos que estás creando un formulario de autor donde puedes cargar una imagen con el «semblante» del autor. En tu formulario, la propiedad semblante sería de tipo file. La clase Autor podría ser la siguiente:

                  -
                  // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\HttpFoundation\File\File;
-
-class Author
-{
-    protected $headshot;
-
-    public function setHeadshot(File $file = null)
-    {
-        $this->headshot = $file;
-    }
-
-    public function getHeadshot()
-    {
-        return $this->headshot;
-    }
-}
-
                  -
                  -

                  Para garantizar que el objeto semblante es un tipo File de imagen válido y que está en cierto rango de tamaño, añade lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author
-    properties:
-        headshot:
-            - Image:
-                minWidth: 200
-                maxWidth: 400
-                minHeight: 200
-                maxHeight: 400
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Image(
-     *     minWidth = 200,
-     *     maxWidth = 400,
-     *     minHeight = 200,
-     *     maxHeight = 400
-     * )
-     */
-    protected $headshot;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="headshot">
-        <constraint name="Image">
-            <option name="minWidth">200</option>
-            <option name="maxWidth">400</option>
-            <option name="minHeight">200</option>
-            <option name="maxHeight">400</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-// ...
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\Image;
-
-class Autor
-{
-    // ...
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('headshot', new Image(array(
-            'minWidth' => 200,
-            'maxWidth' => 400,
-            'minHeight' => 200,
-            'maxHeight' => 400,
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  La propiedad headshot se valida para garantizar que es una imagen real y que tiene una cierta anchura y altura.

                  -
                  -
                  -

                  Opciones

                  -

                  Esta restricción comparte todas sus opciones con la restricción File. No obstante, modifica dos de los valores predefinidos de la opción y añade muchas otras opciones.

                  -
                  -

                  mimeTypes

                  -

                  tipo: array o string predefinido: image/*

                  -

                  Puedes encontrar una lista de tipos mime existentes en el sitio web de IANA

                  -
                  -
                  -

                  mimeTypesMessage

                  -

                  tipo: string predefinido: This file is not a valid image (Este archivo no es una imagen válida)

                  -

                  -Nuevo en la versión 2.1: Todas las opciones min/max width/height son nuevas para Symfony 2.1.

                  -
                  -
                  -

                  minWidth

                  -

                  tipo: integer

                  -

                  Si lo fijas, el ancho del archivo de imagen tiene que ser mayor que o igual a este -valor en píxeles.

                  -
                  -
                  -

                  maxWidth

                  -

                  tipo: integer

                  -

                  Si lo fijas, el ancho del archivo de imagen tiene que ser menor de o igual a este -valor en píxeles.

                  -
                  -
                  -

                  minHeight

                  -

                  tipo: integer

                  -

                  Si lo fijas, la altura del archivo de imagen tiene que ser mayor que o igual a este -valor en píxeles.

                  -
                  -
                  -

                  maxHeight

                  -

                  tipo: integer

                  -

                  Si lo fijas, la altura del archivo de imagen tiene que ser menor de o igual a este -valor en píxeles.

                  -
                  -
                  -

                  sizeNotDetectedMessage

                  -

                  tipo: string predefinido: The size of the image could not be detected —(no se puede determinar el tamaño de la imagen)

                  -

                  Si el sistema es incapaz de determinar el tamaño de la imagen, este error será mostrado. Esto sólo ocurrirá cuándo al menos se haya fijado una de las cuatro opciones de restricción de tamaño.

                  -
                  -
                  -

                  maxWidthMessage

                  -

                  tipo: string predefinido: The image width is too big ({{ width }}px).  Allowed maximum width is {{ max_width }}px —(El ancho de la imagen es demasiado grande ({{ width }}px). El máximo permitido es {{ max_width }}).

                  -

                  El mensaje de error mostrado si el ancho de la imagen supera el maxWidth.

                  -
                  -
                  -

                  minWidthMessage

                  -

                  tipo: string predefinido: The image width is too small ({{ width }}px). Minimum width expected is {{ min_width }}px —(El ancho de la imagen es demasiado pequeño ({{ width }}px). El ancho mínimo esperado es de {{ min_width }}px).

                  -

                  El mensaje de error mostrado si el ancho de la imagen es menor de minWidth.

                  -
                  -
                  -

                  maxHeightMessage

                  -

                  tipo: string predefinido: The image height is too big ({{ height }}px). Allowed maximum height is {{ max_height }}px —(La altura de la imagen es demasiado grande ({{ height }}px). La altura máxima permitida es de {{ max_height }}px)

                  -

                  El mensaje de error mostrado si la altura de la imagen supera el maxHeight.

                  -
                  -
                  -

                  minHeightMessage

                  -

                  tipo: string predefinido: The image height is too small ({{ height }}px). Minimum height expected is {{ min_height }}px —(La altura de la imagen es demasiado pequeña ({{ height }}px). La altura mínima esperada es de {{ min_hegiht }}px.)

                  -

                  El mensaje de error mostrado si la altura de la imagen es menor que minHeight.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Ip.html b/reference/constraints/Ip.html deleted file mode 100644 index 2528da9..0000000 --- a/reference/constraints/Ip.html +++ /dev/null @@ -1,250 +0,0 @@ - - - - - - - Ip — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Ip

                  -

                  Valida que un valor es una dirección IP válida. Por omisión, este lo valida como IPv4, pero hay una serie de diferentes opciones para validarlo como IPv6 y muchas otras combinaciones.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Ip
                  ValidadorSymfony\Component\Validator\Constraints\IpValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        ipAddress:
-            - Ip:
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Ip
-     */
-     protected $ipAddress;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="ipAddress">
-        <constraint name="Ip" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('ipAddress', new Assert\Ip());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  version

                  -

                  tipo: string predefinido: 4

                  -

                  Esta determina exactamente cómo se valida la dirección IP y puede tomar uno de una serie de diferentes valores:

                  -

                  Todos los rangos

                  -
                    -
                  • 4 — Valida direcciones IPv4
                    • -
                  • 6 — Valida direcciones IPv6
                    • -
                  • all — Valida todos los formatos IP
                    • -
                  -

                  No hay rangos privados

                  -
                    -
                  • 4_no_priv — Valida por IPv4, pero sin rangos IP privados
                    • -
                  • 6_no_priv — Valida por IPv6, pero sin rangos IP privados
                    • -
                  • all_no_priv — Valida todos los formatos IP, pero sin rangos IP privados
                    • -
                  -

                  No hay rangos reservados

                  -
                    -
                  • 4_no_res — Valida por IPv4, pero sin rangos IP reservados
                    • -
                  • 6_no_res — Valida por IPv6, pero sin rangos IP reservados
                    • -
                  • all_no_priv — Valida todos los formatos IP, pero sin rangos IP reservados
                    • -
                  -

                  Sólo rangos públicos

                  -
                    -
                  • 4_public — Valida por IPv4, pero sin rangos IP privados y reservados
                    • -
                  • 6_public — Valida por IPv6, pero sin rangos IP privados y reservados
                    • -
                  • all_public — Valida todos los formatos IP, pero sin rangos IP privados y reservados
                    • -
                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This is not a valid IP address (Esta no es una dirección IP válida)

                  -

                  Este mensaje se muestra si la cadena no es una dirección IP válida.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Language.html b/reference/constraints/Language.html deleted file mode 100644 index 3ae1f9e..0000000 --- a/reference/constraints/Language.html +++ /dev/null @@ -1,220 +0,0 @@ - - - - - - - Language — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Language

                  -

                  Valida que un valor es un código de idioma válido.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Language
                  ValidadorSymfony\Component\Validator\Constraints\LanguageValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/UserBundle/Resources/config/validation.yml
-Acme\UserBundle\Entity\User:
-    properties:
-        preferredLanguage:
-            - Language:
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    /**
-     * @Assert\Language
-     */
-     protected $preferredLanguage;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/UserBundle/Resources/config/validation.xml -->
-<class name="Acme\UserBundle\Entity\User">
-    <property name="preferredLanguage">
-        <constraint name="Language" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('preferredLanguage', new Assert\Language());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid language (Este valor no es un idioma válido)

                  -

                  Este mensaje se muestra si la cadena no es un código de idioma válido.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Length.html b/reference/constraints/Length.html deleted file mode 100644 index 0b23a23..0000000 --- a/reference/constraints/Length.html +++ /dev/null @@ -1,272 +0,0 @@ - - - - - - - Length — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Length

                  -

                  Valida que la longitud de una cadena dada está entre algún valor mínimo y máximo.

                  -

                  -Nuevo en la versión 2.1: La restricción Length se añadió en Symfony 2.1.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Length
                  ValidadorSymfony\Component\Validator\Constraints\LengthValidator
                  -
                  -

                  Uso básico

                  -

                  Para verificar que la longitud del campo firstName de una clase está entre 2 y 50, puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Participant:
-    properties:
-        firstName:
-            - Length:
-                min: 2
-                max: 50
-                minMessage: "Tu primer nombre por lo menos debe tener {{ limit }} caracteres de largo"
-                maxMessage: "Tu primer nombre no puede tener más de {{ limit }} caracteres de largo"
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\Length(
-     *      min = "2",
-     *      max = "50",
-     *      minMessage = "Tu primer nombre por lo menos debe tener {{ limit }} caracteres de largo",
-     *      maxMessage = "Tu primer nombre no puede tener más de {{ limit }} caracteres de largo"
-     * )
-     */
-     protected $firstName;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/EventBundle/Resources/config/validation.xml -->
-<class name="Acme\EventBundle\Entity\Participant">
-    <property name="firstName">
-        <constraint name="Length">
-            <option name="min">2</option>
-            <option name="max">50</option>
-            <option name="minMessage">Tu primer nombre por lo menos debe tener {{ limit }} caracteres de largo</option>
-            <option name="maxMessage">Tu primer nombre no puede tener más de {{ limit }} caracteres de largo</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', new Assert\Length(array(
-            'min'        => 2,
-            'max'        => 50,
-            'minMessage' => 'Your first name must be at least {{ limit }} characters length',
-            'maxMessage' => 'Your first name cannot be longer than than {{ limit }} characters length',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  min

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor de la longitud mínima. La validación fallará si la longitud del valor suministrado es menor que este valor mínimo.

                  -
                  -
                  -

                  max

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor de la longitud máxima. La validación fallará si la longitud del valor suministrado es mayor que este valor máximo.

                  -
                  -
                  -

                  charset

                  -

                  tipo: string predefinido: UTF-8

                  -

                  El juego de caracteres a usar al calcular la longitud del valor. Se utiliza la función grapheme_strlen de PHP si está disponible. Si no, se utiliza la función mb_strlen de PHP si está disponible. Si ninguna está disponible, se utiliza la función strlen de PHP.

                  -
                  -
                  -

                  minMessage

                  -

                  tipo: string predefinido: This value is too short. It should have {{ limit }} characters or more (Este debe tener {{ limit }} caracteres o más)

                  -

                  El mensaje que se mostrará si la longitud del valor subyacente es menor que la opción min.

                  -
                  -
                  -

                  maxMessage

                  -

                  tipo: string predefinido: This value is too long. It should have {{ limit }} characters or less (Este debe tener {{ limit }} caracteres o menos)

                  -

                  El mensaje que se mostrará si la longitud del valor subyacente es mayor que la opción max.

                  -
                  -
                  -

                  exactMessage

                  -

                  tipo: string predefinido: This value should have exactly {{ limit }} characters. (Este valor debe tener exactamente {{ limit }} caracteres.)

                  -

                  El mensaje que se mostrará si los valores min y max son iguales y la longitud del valor subyacente no es de exactamente este valor.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Locale.html b/reference/constraints/Locale.html deleted file mode 100644 index 15cb9c9..0000000 --- a/reference/constraints/Locale.html +++ /dev/null @@ -1,221 +0,0 @@ - - - - - - - Locale — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Locale

                  -

                  Valida que un valor es una región válida.

                  -

                  El «valor» de cada región es o bien el del código de idioma ISO639-1 de dos letras (por ejemplo, «es»), o el código de idioma seguido de un guión bajo (_), luego el código de país ISO3166 (por ejemplo, «fr_FR» para Francés/Francia).

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Locale
                  ValidadorSymfony\Component\Validator\Constraints\LocaleValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/UserBundle/Resources/config/validation.yml
-Acme\UserBundle\Entity\User:
-    properties:
-        locale:
-            - Locale:
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    /**
-     * @Assert\Locale
-     */
-     protected $locale;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/UserBundle/Resources/config/validation.xml -->
-<class name="Acme\UserBundle\Entity\User">
-    <property name="locale">
-        <constraint name="Locale" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class User
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('locale', new Assert\Locale());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid locale (Este valor no es una región válida)

                  -

                  Este mensaje se muestra si la cadena no es una región válida.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Luhn.html b/reference/constraints/Luhn.html deleted file mode 100644 index 7524170..0000000 --- a/reference/constraints/Luhn.html +++ /dev/null @@ -1,228 +0,0 @@ - - - - - - - Luhn — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Luhn

                  -

                  -Nuevo en la versión 2.2: La validación Luhn es nueva en Symfony 2.2.

                  -

                  Esta restricción se usa para garantizar que un número de tarjeta de crédito pasa el algoritmo Luhn. -Es útil como primer paso para validar una tarjeta de crédito: Antes de comunicarte con una pasarela de pago.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Luhn
                  ValidadorSymfony\Component\Validator\Constraints\LuhnValidator
                  -
                  -

                  Uso básico

                  -

                  Para usar el validador Luhn, sencillamente aplicalo a una propiedad en un objeto que -contendrá un número de tarjeta de crédito.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/SubscriptionBundle/Resources/config/validation.yml
-Acme\SubscriptionBundle\Entity\Transaction:
-    properties:
-        cardNumber:
-            - Luhn:
-                mensaje: Por favor, verifica el número de tu tarjeta de crédito.
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/SubscriptionBundle/Resources/config/validation.xml -->
-<class name="Acme\SubscriptionBundle\Entity\Transaction">
-    <property name="cardNumber">
-        <constraint name="Luhn">
-            <option name="message">Please check your credit card number.</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/SubscriptionBundle/Entity/Transaction.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Transaction
-{
-    /**
-     * @Assert\Luhn(message = "Please check your credit card number.")
-     */
-    protected $cardNumber;
-}
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/SubscriptionBundle/Entity/Transaction.php
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\Luhn;
-
-class Transaction
-{
-    protected $cardNumber;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('luhn', new Luhn(array(
-            'message' => 'Por favor, verifica el número de tu tarjeta de crédito',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones disponibles

                  -
                  -

                  message

                  -

                  tipo: string predefinido: Invalid card number (Número de tarjeta no válido)

                  -

                  El mensaje predefinido suministrado cuándo el valor no pasa la validación Luhn.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Max.html b/reference/constraints/Max.html deleted file mode 100644 index 359a2e6..0000000 --- a/reference/constraints/Max.html +++ /dev/null @@ -1,243 +0,0 @@ - - - - - - - Max — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Max

                  -
                  -

                  Prudencia

                  -

                  La restricción max está depreciada desde la versión 2.1 y será eliminada en Symfony 2.3. En su lugar usa Range con la opción max.

                  -
                  -

                  Valida que un número dado es menor que un número máximo.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Max
                  ValidadorSymfony\Component\Validator\Constraints\MaxValidator
                  -
                  -

                  Uso básico

                  -

                  Para verificar que el campo edad de una clase no es superior a 50, puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Participant:
-    properties:
-        edad:
-            - Max: { limit: 50, message: You must be 50 or under to enter. }
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\Max(limit = 50, message = "You must be 50 or under to enter.")
-     */
-     protected $age;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/EventBundle/Resources/config/validation.yml -->
-<class name="Acme\EventBundle\Entity\Participant">
-    <property name="age">
-        <constraint name="Max">
-            <option name="limit">50</option>
-            <option name="message">You must be 50 or under to enter.</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('age', new Assert\Max(array(
-            'limit'   => 50,
-            'message' => "You must be 50 or under to enter.",
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  limit

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor máximo. La validación fallará si el valor es mayor que este valor máximo.

                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should be {{ limit }} or less (Este valor debe ser {{ limit }} o menor)

                  -

                  El mensaje que se mostrará si el valor subyacente es mayor que la opción limit.

                  -
                  -
                  -

                  invalidMessage

                  -

                  tipo: string predefinido: This value should be a valid number (Este valor debe ser un número válido)

                  -

                  El mensaje que se mostrará si el valor subyacente no es un número (por medio de la función is_numeric de PHP).

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 19, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/MaxLength.html b/reference/constraints/MaxLength.html deleted file mode 100644 index d201dc6..0000000 --- a/reference/constraints/MaxLength.html +++ /dev/null @@ -1,240 +0,0 @@ - - - - - - - MaxLength — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  MaxLength

                  -
                  -

                  Prudencia

                  -

                  La restricción MaxLength está depreciada desde desde la versión 2.1 y será eliminada en Symfony 2.3. En su lugar usa Length con la opción max.

                  -
                  -

                  Valida que la longitud de una cadena no es mayor que el límite establecido.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\MaxLength
                  ValidadorSymfony\Component\Validator\Constraints\MaxLengthValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Blog:
-    properties:
-        summary:
-            - MaxLength: 100
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Blog.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Blog
-{
-    /**
-     * @Assert\MaxLength(100)
-     */
-    protected $summary;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Blog">
-    <property name="summary">
-        <constraint name="MaxLength">
-            <option name="limit">100</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Blog.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Blog
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('summary', new Assert\MaxLength(array(
-            'limit' => 100,
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  limit

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor máximo. La validación fallará si la longitud de la cadena dada es mayor de este número.

                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is too long. It should have {{ limit }} characters or less (Este valor es demasiado largo. Debería tener {{ limite }} caracteres o menos)

                  -

                  El mensaje que se mostrará si la cadena subyacente tiene una longitud mayor que la opción limit.

                  -
                  -
                  -

                  charset

                  -

                  tipo: charset default: UTF-8

                  -

                  Si está instalada la extensión mbstring de PHP, entonces se utiliza la función mb_strlen de PHP para calcular la longitud de la cadena. El valor de la opción charset se pasa como segundo argumento a esa función.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 19, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Min.html b/reference/constraints/Min.html deleted file mode 100644 index 1416cb1..0000000 --- a/reference/constraints/Min.html +++ /dev/null @@ -1,243 +0,0 @@ - - - - - - - Min — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Min

                  -
                  -

                  Prudencia

                  -

                  La restrición Min está depreciada desde la versión 2.1 y será eliminada en Symfony 2.3. En su lugar usa Range con la opción min.

                  -
                  -

                  Valida que un número dado es mayor que un número mínimo.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Min
                  ValidadorSymfony\Component\Validator\Constraints\MinValidator
                  -
                  -

                  Uso básico

                  -

                  Para verificar que el campo edad de una clase es 18 o más, puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Participant:
-    properties:
-        edad:
-            - Min: { limit: 18, message: You must be 18 or older to enter. }
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\Min(limit = "18", message = "You must be 18 or older to enter.")
-     */
-     protected $age;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/EventBundle/Resources/config/validation.yml -->
-<class name="Acme\EventBundle\Entity\Participant">
-    <property name="age">
-        <constraint name="Min">
-            <option name="limit">18</option>
-            <option name="message">You must be 18 or older to enter.</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity\Participant;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('age', new Assert\Min(array(
-            'limit'   => '18',
-            'message' => 'You must be 18 or older to enter.',
-        ));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  limit

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor mínimo. La validación fallará si el valor es menor que este valor mínimo.

                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should be {{ limit }} or more (Este valor debe ser {{ limit }} o más)

                  -

                  El mensaje que se mostrará si el valor subyacente es menor que la opción limit.

                  -
                  -
                  -

                  invalidMessage

                  -

                  tipo: string predefinido: This value should be a valid number (Este valor debe ser un número válido)

                  -

                  El mensaje que se mostrará si el valor subyacente no es un número (por medio de la función is_numeric de PHP).

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 19, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/MinLength.html b/reference/constraints/MinLength.html deleted file mode 100644 index 5d1ce54..0000000 --- a/reference/constraints/MinLength.html +++ /dev/null @@ -1,245 +0,0 @@ - - - - - - - MinLength — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  MinLength

                  -
                  -

                  Prudencia

                  -

                  La restricción MinLength está depreciada desde la versión 2.1 y será eliminada en Symfony 2.3. En su lugar usa Length con la opción min.

                  -
                  -

                  Valida que la longitud de una cadena por lo menos es tan larga como el límite dado.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\MinLength
                  ValidadorSymfony\Component\Validator\Constraints\MinLengthValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Blog:
-    properties:
-        firstName:
-            - MinLength: { limit: 3, message: "Your name must have at least {{ limit}} characters." }
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Blog.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Blog
-{
-    /**
-     * @Assert\MinLength(
-     *     limit=3,
-     *     message="Your name must have at least {{ limit}} characters."
-     * )
-     */
-    protected $summary;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Blog">
-    <property name="summary">
-        <constraint name="MinLength">
-            <option name="limit">3</option>
-            <option name="message">Your name must have at least {{ limit }} characters.</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Blog.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Blog
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('summary', new Assert\MinLength(array(
-            'limit'   => 3,
-            'message' => 'Your name must have at least {{ limit }} characters.',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  limit

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor mínimo. La validación fallará si la longitud de la cadena dada es menor de este número.

                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is too short. It should have {{ limit }} characters or more (Este valor es demasiado corto. Debería tener {{ limit }} caracteres o más)

                  -

                  El mensaje que se mostrará si la cadena subyacente tiene una longitud menor que la opción limit.

                  -
                  -
                  -

                  charset

                  -

                  tipo: charset default: UTF-8

                  -

                  Si está instalada la extensión mbstring de PHP, entonces se utiliza la función mb_strlen de PHP para calcular la longitud de la cadena. El valor de la opción charset se pasa como segundo argumento a esa función.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Mar 19, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/NotBlank.html b/reference/constraints/NotBlank.html deleted file mode 100644 index 4c824af..0000000 --- a/reference/constraints/NotBlank.html +++ /dev/null @@ -1,221 +0,0 @@ - - - - - - - NotBlank — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  NotBlank

                  -

                  Valida que un valor no está en blanco, el cual fue definido como distinto a una cadena en blanco y no es igual a null. Para forzar que el valor no sea simplemente igual a null, consulta la restricción NotNull.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\NotBlank
                  ValidadorSymfony\Component\Validator\Constraints\NotBlankValidator
                  -
                  -

                  Uso básico

                  -

                  Si te quieres asegurar de que la propiedad firstName de una clase Author no está en blanco, puedes hacer lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        firstName:
-            - NotBlank: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\NotBlank()
-     */
-    protected $firstName;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="firstName">
-        <constraint name="NotBlank" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should not be blank (Este valor no debe estar en blanco)

                  -

                  Este es el mensaje que se mostrará si el valor está en blanco.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/NotNull.html b/reference/constraints/NotNull.html deleted file mode 100644 index f69a575..0000000 --- a/reference/constraints/NotNull.html +++ /dev/null @@ -1,221 +0,0 @@ - - - - - - - NotNull — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  NotNull

                  -

                  Valida que el valor no es estrictamente igual a null. Para garantizar que el valor no está simplemente en blanco (no es una cadena en blanco), consulta la restricción NotBlank.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\NotNull
                  ValidadorSymfony\Component\Validator\Constraints\NotNullValidator
                  -
                  -

                  Uso básico

                  -

                  Si te quieres asegurar de que la propiedad firstName de una clase Author no es estrictamente igual a null, deberías comprobar:

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        firstName:
-            - NotNull: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\NotNull()
-     */
-    protected $firstName;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="firstName">
-        <constraint name="NotNull" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', new Assert\NotNull());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should not be null (Este valor no debería ser nulo)

                  -

                  Este es el mensaje que se mostrará, si el valor es null.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Null.html b/reference/constraints/Null.html deleted file mode 100644 index 2b41a69..0000000 --- a/reference/constraints/Null.html +++ /dev/null @@ -1,221 +0,0 @@ - - - - - - - Null — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Null

                  -

                  Valida que un valor es exactamente igual a null. Para obligar a que una propiedad no es más que simplemente un valor en blanco (cadena en blanco o null), consulta la restricción Blank. Para asegurarte de que una propiedad no es null, consulta la restricción NotNull.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Null
                  ValidadorSymfony\Component\Validator\Constraints\NullValidator
                  -
                  -

                  Uso básico

                  -

                  Si, por alguna razón, quisieras asegurarte de que la propiedad firstName de una clase Author es exactamente igual a null, podrías hacer lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        firstName:
-            - 'Null': ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Null()
-     */
-    protected $firstName;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="firstName">
-        <constraint name="Null" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', Assert\Null());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should be null (Este valor debe ser nulo)

                  -

                  Este es el mensaje que se mostrará si el valor no es null.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Range.html b/reference/constraints/Range.html deleted file mode 100644 index e245bb3..0000000 --- a/reference/constraints/Range.html +++ /dev/null @@ -1,266 +0,0 @@ - - - - - - - Range — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Range

                  -

                  Valida que un número dado está entre algún número mínimo y máximo.

                  -

                  -Nuevo en la versión 2.1: La restricción Range se añadió en Symfony 2.1.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Range
                  ValidadorSymfony\Component\Validator\Constraints\RangeValidator
                  -
                  -

                  Uso básico

                  -

                  Para verificar que el campo estatura de una clase está entre 120 y 180, puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Participant:
-    properties:
-        estatura:
-            - Range:
-                min: 120
-                max: 180
-                minMessage: Para entrar por lo menos debes tener una estatura de 120 cm
-                maxMessage: No puedes ser más alto de 180 cm para ingresar
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\Range(
-     *      min = "120",
-     *      max = "180",
-     *      minMessage = "Para entrar por lo menos debes tener una estatura de 120 cm",
-     *      maxMessage = "No puedes ser más alto de 180 cm para ingresar"
-     * )
-     */
-     protected $estatura;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/EventBundle/Resources/config/validation.xml -->
-<class name="Acme\EventBundle\Entity\Participant">
-    <property name="height">
-        <constraint name="Range">
-            <option name="min">120</option>
-            <option name="max">180</option>
-            <option name="minMessage">You must be at least 120cm tall to enter</option>
-            <option name="maxMessage">You cannot be taller than 180cm to enter</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/EventBundle/Entity/Participant.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('height', new Assert\Range(array(
-            'min'        => 120,
-            'max'        => 180,
-            'minMessage' => 'You must be at least 120cm tall to enter',
-            'maxMessage' => 'You cannot be taller than 180cm to enter',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  min

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor mínimo. La validación fallará si el valor es menor que este valor mínimo.

                  -
                  -
                  -

                  max

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor máximo. La validación fallará si el valor es mayor que este valor máximo.

                  -
                  -
                  -

                  minMessage

                  -

                  tipo: string predefinido: This value should be {{ limit }} or more (Este valor debe ser {{ limit }} o más)

                  -

                  El mensaje que se mostrará si el valor subyacente es menor que la opción min.

                  -
                  -
                  -

                  maxMessage

                  -

                  tipo: string predefinido: This value should be {{ limit }} or less. (Este valor debe ser {{ limit }} o menor)

                  -

                  El mensaje que se mostrará si el valor subyacente es mayor que la opción max.

                  -
                  -
                  -

                  invalidMessage

                  -

                  tipo: string predefinido: This value should be a valid number (Este valor debe ser un número válido)

                  -

                  El mensaje que se mostrará si el valor subyacente no es un número (por medio de la función is_numeric de PHP).

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Regex.html b/reference/constraints/Regex.html deleted file mode 100644 index 1caf7ca..0000000 --- a/reference/constraints/Regex.html +++ /dev/null @@ -1,304 +0,0 @@ - - - - - - - Regex — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Regex

                  -

                  Valida que un valor coincide con una expresión regular.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Regex
                  ValidadorSymfony\Component\Validator\Constraints\RegexValidator
                  -
                  -

                  Uso básico

                  -

                  Supongamos que tienes un campo descripción y que deseas verificar que comienza con un carácter constituyente de palabra válido. La expresión regular para comprobar esto sería /^\w+/, la cual indica que estás buscando al menos uno o más caracteres constituyentes de palabra al principio de la cadena:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        description:
-            - Regex: "/^\w+/"
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Regex("/^\w+/")
-     */
-    protected $description;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="description">
-        <constraint name="Regex">
-            <option name="pattern">/^\w+/</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('description', new Assert\Regex(array(
-            'pattern' => '/^\w+/',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Alternativamente, puedes fijar la opción match a false con el fin de confirmar que una determinada cadena no coincide. En el siguiente ejemplo, afirmas que el campo firstName no contiene ningún número y proporcionas un mensaje personalizado:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        firstName:
-            - Regex:
-                pattern: "/\d/"
-                match:   false
-                message: Your name cannot contain a number
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Regex(
-     *     pattern="/\d/",
-     *     match=false,
-     *     message="Your name cannot contain a number"
-     * )
-     */
-    protected $firstName;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="firstName">
-        <constraint name="Regex">
-            <option name="pattern">/\d/</option>
-            <option name="match">false</option>
-            <option name="message">Your name cannot contain a number</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', new Assert\Regex(array(
-            'pattern' => '/\d/',
-            'match'   => false,
-            'message' => 'Your name cannot contain a number',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  pattern

                  -

                  tipo: string [default option]

                  -

                  Esta opción requerida es el patrón de la expresión regular con el cual se comparará lo ingresado. Por omisión, este validador no funcionará si la cadena introducida no coincide con la expresión regular (a través de la función preg_match de PHP). -Sin embargo, si estableces match en false, la validación fallará si la cadena ingresada no coincide con este patrón.

                  -
                  -
                  -

                  match

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true (o no se ha fijado), este validador pasará si la cadena dada coincide con el patrón (pattern) de la expresión regular. Sin embargo, cuando estableces esta opción en false, ocurrirá lo contrario: la validación pasará si la cadena ingresada no coincide con el patrón de la expresión regular.

                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje que se mostrará si el validador falla.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Size.html b/reference/constraints/Size.html deleted file mode 100644 index 7e082ea..0000000 --- a/reference/constraints/Size.html +++ /dev/null @@ -1,260 +0,0 @@ - - - - - - - Size — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Size

                  -

                  Valida que la longitud de una cadena dada o la cantidad de elementos en una colección está entre un valor mínimo y máximo.

                  -

                  -Nuevo en la versión 2.1: La restricción Size se añadió en Symfony 2.1.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Size
                  ValidadorSymfony\Component\Validator\Constraints\SizeValidator
                  -
                  -

                  Uso básico

                  -

                  Para verificar que la longitud del campo firstName de una clase está entre 2 y 50, puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Participant:
-    properties:
-        firstName:
-            - Size:
-                min: 2
-                max: 50
-                minMessage: Tu primer nombre por lo menos debe tener 2 caracteres de largo
-                maxMessage: Tu primer nombre no puede tener más de 50 caracteres de largo
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\Size(
-     *      min = "2",
-     *      max = "50",
-     *      minMessage = "Tu primer nombre por lo menos debe tener 2 caracteres de largo",
-     *      maxMessage = "Tu primer nombre no puede tener más de 50 caracteres de largo"
-     * )
-     */
-     protected $firstName;
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Colecciones — Uso básico

                  -

                  Para verificar que la matriz de campos emails contiene entre 1 y 5 elementos puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Participant:
-    properties:
-        emails:
-            - Size:
-                min: 1
-                max: 5
-                minMessage: Debes especificar al menos una dirección de correo electrónico
-                maxMessage: No puedes especificar más de 5 direcciones de correo electrónico
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\Size(
-     *      min = "1",
-     *      max = "5",
-     *      minMessage = "Debes especificar al menos una dirección de correo electrónico",
-     *      maxMessage = "No puedes especificar más de 5 direcciones de correo electrónico"
-     * )
-     */
-     protected $emails = array();
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  min

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor de la longitud mínima. La validación fallará si la longitud del valor suministrado es menor que este valor mínimo.

                  -
                  -
                  -

                  max

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor de la longitud máxima. La validación fallará si la longitud del valor suministrado es mayor que este valor máximo.

                  -
                  -
                  -

                  type

                  -

                  tipo: string

                  -

                  El tipo del valor a comprobar. Este bien puede ser string o collection. Si no lo especificas, el validador intentará determinar el tipo correcto basándose en el dato validado subyacente.

                  -
                  -
                  -

                  charset

                  -

                  tipo: string predefinido: UTF-8

                  -

                  El juego de caracteres a usar al calcular la longitud del valor. Se utiliza la función grapheme_strlen de PHP si está disponible. Si no, se utiliza la función mb_strlen de PHP si está disponible. Si ninguna está disponible, se utiliza la función strlen de PHP.

                  -
                  -
                  -

                  minMessage

                  -

                  tipo: string predefinido: This value is too short. It should have {{ limit }} characters or more. (Este valor es muy corto. Debe tener {{ limit }} caracteres o más) cuando valides una cadena, o This collection should contain {{ limit }} elements or more. (Esta colección debe contener {{ limit }} elementos o más.) cuando validas una colección.

                  -

                  El mensaje que se mostrará si la longitud del valor subyacente o la cantidad de elementos en la colección es menor que la opción min.

                  -
                  -
                  -

                  maxMessage

                  -

                  tipo: string predefinido: This value is too long. It should have {{ limit }} characters or less. (Este valor es muy largo. Debe tener {{ limit }} caracteres o menos) cuando valides una cadena, o This collection should contain {{ limit }} elements or less. (Esta colección debe contener {{ limit }} elementos o menos.) cuando validas una colección.

                  -

                  El mensaje que se mostrará si la longitud del valor subyacente o la cantidad de elementos en la colección es mayor que la opción max.

                  -
                  -
                  -

                  exactMessage

                  -

                  tipo: string predefinido: This value should have exactly {{ limit }} characters. (Este valor debe tener exactamente {{ limit }} caracteres.) cuando valides una cadena, o This collection should contain exactly {{ limit }} elements. (Esta colección debe contener exactamente {{ limit }} elementos.) cuando validas una colección.

                  -

                  El mensaje que se mostrará si los valores min y max son iguales y la longitud del valor subyacente no es exactamente este valor.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/SizeLength.html b/reference/constraints/SizeLength.html deleted file mode 100644 index 8bf79ee..0000000 --- a/reference/constraints/SizeLength.html +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - SizeLength — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  SizeLength

                  -

                  Valida que la longitud de una cadena está entre algún valor mínimo y máximo según el juego de caracteres proporcionado.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\SizeLength
                  ValidadorSymfony\Component\Validator\Constraints\SizeLengthValidator
                  -
                  -

                  Uso básico

                  -

                  Para verificar que la longitud del campo firstName de una clase está entre 2 y 50, puedes agregar lo siguiente:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Height:
-    properties:
-        firstName:
-            - SizeLength:
-                min: 2
-                max: 50
-                minMessage: Tu primer nombre por lo menos debe tener 2 caracteres de largo
-                maxMessage: Tu primer nombre no puede tener más de 50 caracteres de largo
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Participant.php
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Participant
-{
-    /**
-     * @Assert\SizeLength(
-     *      min = "2",
-     *      max = "50",
-     *      minMessage = "Tu primer nombre por lo menos debe tener 2 caracteres de largo",
-     *      maxMessage="Tu primer nombre no puede tener más de 50 caracteres de largo"
-     * )
-     */
-     protected $firstName;
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  min

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor de la longitud mínima. La validación fallará si la longitud del valor suministrado es menor que este valor mínimo.

                  -
                  -
                  -

                  max

                  -

                  tipo: integer [default option]

                  -

                  Esta opción requerida es el valor de la longitud máxima. La validación fallará si la longitud del valor suministrado es mayor que este valor máximo.

                  -
                  -
                  -

                  charset

                  -

                  tipo: string predeterminado: UTF-8

                  -

                  El juego de caracteres a usar al calcular la longitud del valor. Si está disponible, se usa la función grapheme_strlen de PHP. Si no, se usa la función mb_strlen de PHP, si está disponible. Si ninguna está disponible, se usa la función strlen de PHP.

                  -
                  -
                  -

                  minMessage

                  -

                  tipo: string predeterminado: This value is too short. It should have {{ limit }} characters or more (Este valor es demasiado corto. Debería tener {{ limit }} caracteres o más)

                  -

                  El mensaje que se mostrará si la longitud del valor subyacente es menor que la opción min.

                  -
                  -
                  -

                  maxMessage

                  -

                  tipo: string predeterminado: This value is too long. It should have {{ limit }} characters or less (Este valor es demasiado largo. Debería tener {{ limit }} caracteres o menos)

                  -

                  El mensaje que se mostrará si la longitud del valor subyacente es mayor que la opción max.

                  -
                  -
                  -

                  exactMessage

                  -

                  tipo: string predeterminado: This value should have exactly {{ limit }} characters. (Este valor debería tener exactamente {{ limit }} caracteres.)

                  -

                  El mensaje que se mostrará si los valores min y max son iguales y la longitud del valor subyacente no es de exactamente este valor.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Jan 11, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Time.html b/reference/constraints/Time.html deleted file mode 100644 index 4072450..0000000 --- a/reference/constraints/Time.html +++ /dev/null @@ -1,221 +0,0 @@ - - - - - - - Time — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Time

                  -

                  Valida que un valor sea una hora legítima, es decir, ya sea un objeto DateTime o una cadena (o un objeto que se puede convertir en una cadena) y que sigue un formato «HH:MM:SS» válido.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Time
                  ValidadorSymfony\Component\Validator\Constraints\TimeValidator
                  -
                  -

                  Uso básico

                  -

                  Supongamos que tienes una clase Evento, con un campo comenzaraALas que es el momento del día en que comienza el evento:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/EventBundle/Resources/config/validation.yml
-Acme\EventBundle\Entity\Event:
-    properties:
-        startsAt:
-            - Time: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/EventBundle/Entity/Event.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Event
-{
-    /**
-     * @Assert\Time()
-     */
-     protected $startsAt;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/EventBundle/Resources/config/validation.xml -->
-<class name="Acme\EventBundle\Entity\Event">
-    <property name="startsAt">
-        <constraint name="Time" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/EventBundle/Entity/Event.php
-namespace Acme\EventBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Event
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('startsAt', new Assert\Time());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid time (Este valor no es una hora válida)

                  -

                  Este mensaje se muestra si los datos subyacentes no son una hora válida.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/True.html b/reference/constraints/True.html deleted file mode 100644 index 6593dac..0000000 --- a/reference/constraints/True.html +++ /dev/null @@ -1,254 +0,0 @@ - - - - - - - True — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  True

                  -

                  Valida que un valor es true. En concreto, este comprueba si el valor es exactamente true, exactamente el número entero 1, o exactamente la cadena «1».

                  -

                  Además consulta False.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\True
                  ValidadorSymfony\Component\Validator\Constraints\TrueValidator
                  -
                  -

                  Uso básico

                  -

                  Puedes aplicar esta restricción a propiedades (por ejemplo, una propiedad termsAccepted en un modelo de registro) o a un método captador. Esta es más potente en este último caso, donde puedes confirmar que un método devuelve un valor true. Por ejemplo, supongamos que tienes el siguiente método:

                  -
                  // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-class Author
-{
-    protected $token;
-
-    public function isTokenValid()
-    {
-        return $this->token == $this->generateToken();
-    }
-}
-
                  -
                  -

                  A continuación, puedes limitar este método con True.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    getters:
-        tokenValid:
-            - "True": { message: "The token is invalid." }
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    protected $token;
-
-    /**
-     * @Assert\True(message = "The token is invalid")
-     */
-    public function isTokenValid()
-    {
-        return $this->token == $this->generateToken();
-    }
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/Blogbundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <getter property="tokenValid">
-        <constraint name="True">
-            <option name="message">The token is invalid.</option>
-        </constraint>
-    </getter>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints\True;
-
-class Autor
-{
-    protected $token;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addGetterConstraint('tokenValid', new True(array(
-            'message' => 'The token is invalid.',
-        )));
-    }
-
-    public function isTokenValid()
-    {
-        return $this->token == $this->generateToken();
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Si isTokenValid() devuelve false, la validación fallará.

                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should be true (Este valor no debe ser 'true')

                  -

                  Este mensaje se muestra si el dato subyacente no es true.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Type.html b/reference/constraints/Type.html deleted file mode 100644 index 81ae668..0000000 --- a/reference/constraints/Type.html +++ /dev/null @@ -1,251 +0,0 @@ - - - - - - - Type — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Type

                  -

                  Valida que un valor es de un tipo de dato específico. Por ejemplo, si una variable debe ser un array, puedes utilizar esta restricción con la opción type para validarla.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Type
                  ValidadorSymfony\Component\Validator\Constraints\TypeValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        edad:
-            - Type:
-                type: integer
-                message: The value {{ value }} is not a valid {{ type }}.
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Type(type="integer", message="The value {{ value }} is not a valid {{ type }}.")
-     */
-    protected $age;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="age">
-        <constraint name="Type">
-            <option name="type">integer</option>
-            <option name="message">The value {{ value }} is not a valid {{ type }}.</option>
-        </constraint>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('age', new Assert\Type(array(
-            'type'    => 'integer',
-            'message' => 'The value {{ value }} is not a valid {{ type }}.',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  type

                  -

                  tipo: string [default option]

                  -

                  Esta opción requerida es el nombre de clase completo o uno de los tipos de datos PHP según lo determinado por las funciones is_ de PHP.

                  - -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value should be of type {{ type }} (Este valor debe ser de tipo {{ type }})

                  -

                  El mensaje si el dato subyacente no es del tipo dado.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/UniqueEntity.html b/reference/constraints/UniqueEntity.html deleted file mode 100644 index dd66188..0000000 --- a/reference/constraints/UniqueEntity.html +++ /dev/null @@ -1,270 +0,0 @@ - - - - - - - UniqueEntity — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  UniqueEntity

                  -

                  Valida que un campo en particular (o campos) en una entidad Doctrine sea único. Este se utiliza comúnmente, por ejemplo, para prevenir que un nuevo usuario se registre con una dirección de correo electrónico existente en el sistema.

                  - ---- - - - - - - - - - - - - - - -
                  Applies toclass
                  Options -
                  ClassSymfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity
                  ValidatorSymfony\Bridge\Doctrine\Validator\Constraints\UniqueEntityValidator
                  -
                  -

                  Uso básico

                  -

                  Supongamos que tienes un AcmeUserBundle con una entidad User que tiene un campo email. Puedes utilizar la restricción UniqueEntity para garantizar que el campo email siga siendo único en toda tu tabla User:

                  -
                  -
                    -
                  • YAML
                    # src/Acme/UserBundle/Resources/config/validation.yml
-Acme\UserBundle\Entity\Author:
-    constraints:
-        - Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity: email
-    properties:
-        email:
-            - Email: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-use Doctrine\ORM\Mapping as ORM;
-
-// ¡NO OLVIDES usar esta declaración!
-use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
-
-/**
- * @ORM\Entity
- * @UniqueEntity("email")
- */
-class Author
-{
-    /**
-     * @var string $email
-     *
-     * @ORM\Column(name="email", type="string", length=255, unique=true)
-     * @Assert\Email()
-     */
-    protected $email;
-
-    // ...
-}
-
                    -
                    -
                    • -
                  • XML
                    <class name="Acme\UserBundle\Entity\Author">
-    <constraint name="Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity">
-        <option name="fields">email</option>
-        <option name="message">This email already exists.</option>
-    </constraint>
-    <property name="email">
-        <constraint name="Email" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // Acme/UserBundle/Entity/User.php
-namespace Acme\UserBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-// ¡NO OLVIDES usar esta declaración!
-use Symfony\Bridge\Doctrine\Validator\Constraints\UniqueEntity;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addConstraint(new UniqueEntity(array(
-            'fields'  => 'email',
-            'message' => 'This email already exists.',
-        )));
-
-        $metadata->addPropertyConstraint(new Assert\Email());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  fields

                  -

                  tipo: array | string [opción predeterminada]

                  -

                  Esta opción requerida es el campo (o lista de campos) en el cual esta entidad debe ser única. Por ejemplo, si has especificado ambos campos email y name en una sola restricción UniqueEntity, entonces esta debería forzar a que la combinación de valores sea única (por ejemplo, dos usuarios pueden tener la misma dirección de correo electrónico, siempre y cuando no tengan el mismo nombre también).

                  -

                  Si necesitas requerir dos campos únicos individualmente (por ejemplo, una dirección de correo electrónico única y un nombre de usuario), utiliza dos entradas UniqueEntity, cada una con un solo campo.

                  -
                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is already used. (Este valor ya se está usando)

                  -

                  El mensaje a mostrar cuando esta restricción falla.

                  -
                  -
                  -

                  em

                  -

                  tipo: string

                  -

                  El nombre del gestor de entidades que hará la consulta para determinar la unicidad. Si lo dejas en blanco, el gestor de entidades correcto será determinado por esta clase. Por esa razón, probablemente no será necesario utilizar esta opción.

                  -
                  -
                  -

                  repositoryMethod

                  -

                  tipo: string predefinido: findBy

                  -

                  -Nuevo en la versión 2.1: The repositoryMethod option was added in Symfony 2.1. Before, it -always used the findBy method.

                  -

                  The name of the repository method to use for making the query to determine the -uniqueness. If it’s left blank, the findBy method will be used. This -method should return a countable result.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Url.html b/reference/constraints/Url.html deleted file mode 100644 index f98ba51..0000000 --- a/reference/constraints/Url.html +++ /dev/null @@ -1,226 +0,0 @@ - - - - - - - Url — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Url

                  -

                  Valida que un valor es una cadena URL válida.

                  - ---- - - - - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Url
                  ValidadorSymfony\Component\Validator\Constraints\UrlValidator
                  -
                  -

                  Uso básico

                  -
                  -
                    -
                  • YAML
                    # src/BlogBundle/Resources/config/validation.yml
-Acme\BlogBundle\Entity\Author:
-    properties:
-        bioUrl:
-            - Url:
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Url()
-     */
-     protected $bioUrl;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/BlogBundle/Resources/config/validation.xml -->
-<class name="Acme\BlogBundle\Entity\Author">
-    <property name="bioUrl">
-        <constraint name="Url" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/BlogBundle/Entity/Author.php
-namespace Acme\BlogBundle\Entity;
-
-use Symfomy\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('bioUrl', new Assert\Url());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: string predefinido: This value is not a valid URL (Este valor no es una URL válida)

                  -

                  Este mensaje aparece si la URL no es válida.

                  -
                  -
                  -

                  protocols

                  -

                  tipo: array predeterminado: array('http', 'https')

                  -

                  Los protocolos que se consideran válidos. Por ejemplo, si también necesitas que las URL tipo ftp:// sean válidas, redefine el arreglo de protocolos, listando http, https, y además ftp.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/UserPassword.html b/reference/constraints/UserPassword.html deleted file mode 100644 index fe20019..0000000 --- a/reference/constraints/UserPassword.html +++ /dev/null @@ -1,241 +0,0 @@ - - - - - - - UserPassword — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  UserPassword

                  -

                  -Nuevo en la versión 2.1: Esta restricción es nueva en la versión 2.1.

                  -
                  -

                  Nota

                  -

                  Since Symfony 2.2, the UserPassword* classes in the -SymfonyComponentSecurityCoreValidatorConstraint namespace are -deprecated and will be removed in Symfony 2.3. Please use the -UserPassword* classes in the -SymfonyComponentSecurityCoreValidatorConstraints namespace instead.

                  -
                  -

                  Esta verifica que un valor ingresado sea igual a la contraseña del usuario actualmente autenticado. Esto es útil en un formulario donde el usuario puede cambiar su contraseña, pero por seguridad, tiene que introducir su antigua contraseña.

                  -
                  -

                  Nota

                  -

                  No lo deberías usar para validar un formulario de acceso, ya que esto lo hace automáticamente el sistema de seguridad.

                  -
                  - ---- - - - - - - - - - - - - - - -
                  Applies toproperty or method
                  Options -
                  ClassSymfony\Component\Security\Core\Validator\Constraints\UserPassword
                  ValidatorSymfony\Component\Security\Core\Validator\Constraints\UserPasswordValidator
                  -
                  -

                  Uso básico

                  -

                  Supongamos que tienes una clase PasswordChange, que se utiliza en un formulario donde el usuario puede cambiar su contraseña, introduciendo su contraseña antigua y una nueva contraseña. -Esta restricción validará que la contraseña anterior coincide con la contraseña actual del usuario:

                  -
                  -
                    -
                  • YAML
                    # src/UserBundle/Resources/config/validation.yml
-Acme\UserBundle\Form\Model\ChangePassword:
-    properties:
-        oldPassword:
-            - Symfony\Component\Security\Core\Validator\Constraints\UserPassword:
-                mensaje: "Wrong value for your current password"
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/UserBundle/Form/Model/ChangePassword.php
-namespace Acme\UserBundle\Form\Model;
-
-use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;
-
-class ChangePassword
-{
-    /**
-     * @SecurityAssert\UserPassword(
-     *     message = "Wrong value for your current password"
-     * )
-     */
-     protected $oldPassword;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/UserBundle/Resources/config/validation.xml -->
-<class name="Acme\UserBundle\Form\Model\ChangePassword">
-    <property name="Symfony\Component\Security\Core\Validator\Constraints\UserPassword">
-        <option name="message">Wrong value for your current password</option>
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/UserBundle/Form/Model/ChangePassword.php
-namespace Acme\UserBundle\Form\Model;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Security\Core\Validator\Constraints as SecurityAssert;
-
-class ChangePassword
-{
-    public static function loadValidatorData(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('oldPassword', new SecurityAssert\UserPassword(array(
-            'message' => 'Wrong value for your current password',
-        )));
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  message

                  -

                  tipo: message default: This value should be the user current password (Este valor debe ser la contraseña actual del usuario)

                  -

                  Este es el mensaje que aparece cuando la cadena subyacente no coincide con la contraseña del usuario actual.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/constraints/Valid.html b/reference/constraints/Valid.html deleted file mode 100644 index 0c8ba3c..0000000 --- a/reference/constraints/Valid.html +++ /dev/null @@ -1,382 +0,0 @@ - - - - - - - Valid — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Valid

                  -

                  Esta restricción se utiliza para permitir la validación de objetos que se incrustan como propiedades en un objeto que se está validando. Esto te permite validar un objeto y todos los subobjetos asociados con él.

                  - ---- - - - - - - - - - - - -
                  Aplica apropiedad o método
                  Opciones -
                  ClaseSymfony\Component\Validator\Constraints\Type
                  -
                  -

                  Uso básico

                  -

                  El siguiente ejemplo, crea dos clases Autor y Domicilio y ambas tienen restricciones en sus propiedades. Además, Autor almacena una instancia de Domicilio en la propiedad $address.

                  -
                  // src/Acme/HelloBundle/Entity/Address.php
-namespace Amce\HelloBundle\Entity;
-
-class Address
-{
-    protected $street;
-    protected $zipCode;
-}
-
                  -
                  -
                  // src/Acme/HelloBundle/Entity/Author.php
-namespace Amce\HelloBundle\Entity;
-
-class Author
-{
-    protected $firstName;
-    protected $lastName;
-    protected $address;
-}
-
                  -
                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/validation.yml
-Acme\HelloBundle\Entity\Address:
-    properties:
-        street:
-            - NotBlank: ~
-        zipCode:
-            - NotBlank: ~
-            - Length:
-                max: 5
-
-Acme\HelloBundle\Entity\Author:
-    properties:
-        firstName:
-            - NotBlank: ~
-            - Length:
-                min: 4
-        lastName:
-            - NotBlank: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/HelloBundle/Entity/Address.php
-namespace Acme\HelloBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Address
-{
-    /**
-     * @Assert\NotBlank()
-     */
-    protected $street;
-
-    /**
-     * @Assert\NotBlank
-     * @Assert\Length(max = "5")
-     */
-    protected $zipCode;
-}
-
-// src/Acme/HelloBundle/Entity/Author.php
-namespace Acme\HelloBundle\Entity;
-
-class Autor
-{
-    /**
-     * @Assert\NotBlank
-     * @Assert\Length(min = "4")
-     */
-    protected $firstName;
-
-    /**
-     * @Assert\NotBlank
-     */
-    protected $lastName;
-
-    protected $address;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/validation.xml -->
-<class name="Acme\HelloBundle\Entity\Address">
-    <property name="street">
-        <constraint name="NotBlank" />
-    </property>
-    <property name="zipCode">
-        <constraint name="NotBlank" />
-        <constraint name="Length">
-            <option name="max">5</option>
-        </constraint>
-    </property>
-</class>
-
-<class name="Acme\HelloBundle\Entity\Author">
-    <property name="firstName">
-        <constraint name="NotBlank" />
-        <constraint name="Length">
-            <option name="min">4</option>
-        </constraint>
-    </property>
-    <property name="lastName">
-        <constraint name="NotBlank" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Entity/Address.php
-namespace Acme\HelloBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Address
-{
-    protected $street;
-    protected $zipCode;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('street', new Assert\NotBlank());
-        $metadata->addPropertyConstraint('zipCode', new Assert\NotBlank());
-        $metadata->addPropertyConstraint(
-            'zipCode',
-            new Assert\Length(array("max" => 5)));
-    }
-}
-
-// src/Acme/HelloBundle/Entity/Author.php
-namespace Acme\HelloBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    protected $firstName;
-    protected $lastName;
-    protected $address;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('firstName', new Assert\NotBlank());
-        $metadata->addPropertyConstraint('firstName', new Assert\Length(array("min" => 4)));
-        $metadata->addPropertyConstraint('lastName', new Assert\NotBlank());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Con esta asignación puedes validar satisfactoriamente a un autor con una dirección no válida. Para evitarlo, agrega la restricción Valid a la propiedad $address.

                  -
                  -
                    -
                  • YAML
                    # src/Acme/HelloBundle/Resources/config/validation.yml
-Acme\HelloBundle\Author:
-    properties:
-        address:
-            - Valid: ~
-
                    -
                    -
                    • -
                  • Annotations
                    // src/Acme/HelloBundle/Entity/Author.php
-namespace Acme\HelloBundle\Entity;
-
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    /**
-     * @Assert\Valid
-     */
-    protected $address;
-}
-
                    -
                    -
                    • -
                  • XML
                    <!-- src/Acme/HelloBundle/Resources/config/validation.xml -->
-<class name="Acme\HelloBundle\Entity\Author">
-    <property name="address">
-        <constraint name="Valid" />
-    </property>
-</class>
-
                    -
                    -
                    • -
                  • PHP
                    // src/Acme/HelloBundle/Entity/Author.php
-namespace Acme\HelloBundle\Entity;
-
-use Symfony\Component\Validator\Mapping\ClassMetadata;
-use Symfony\Component\Validator\Constraints as Assert;
-
-class Autor
-{
-    protected $address;
-
-    public static function loadValidatorMetadata(ClassMetadata $metadata)
-    {
-        $metadata->addPropertyConstraint('address', new Assert\Valid());
-    }
-}
-
                    -
                    -
                    • -
                  -
                  -

                  Si ahora validas a un autor con una dirección no válida, puedes ver que la validación de los campos Address falla:

                  -
                  Acme\HelloBundle\Author.address.zipCode:
-Este valor es demasiado largo. Debe tener 5 caracteres o menos
-
                  -
                  -
                  -
                  -

                  Opciones

                  -
                  -

                  traverse

                  -

                  tipo: boolean default: true

                  -

                  Si esta restricción se aplica a una propiedad que contiene un arreglo de objetos, cada objeto del arreglo será válido sólo si esta opción está establecida en true.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/dic_tags.html b/reference/dic_tags.html deleted file mode 100644 index 19bcae3..0000000 --- a/reference/dic_tags.html +++ /dev/null @@ -1,904 +0,0 @@ - - - - - - - Etiquetas de inyección de dependencias — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Etiquetas de inyección de dependencias

                  -

                  Las etiquetas para la inyección de dependencia son pequeñas cadenas que se pueden aplicar a la «bandera» de un servicio para poder usarla de alguna manera especial. Por ejemplo, si tienes un servicio que quieres registrar como escucha de uno de los principales eventos de Symfony, lo puedes marcar con la etiqueta kernel.event_listener.

                  -

                  Puedes aprender un poco más sobre las «etiquetas» leyendo la sección «Etiquetas» -del capítulo Contenedor de Servicio.

                  -

                  A continuación mostramos información sobre todas las etiquetas disponibles en Symfony2. También puede haber etiquetas usadas en otros paquetes que no aparecen aquí. Por ejemplo, AsseticBundle tiene muchas etiquetas no mencionadas aquí.

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  Tag NameUsage
                  data_collectorCreate a class that collects custom data for the profiler
                  form.typeCreate a custom form field type
                  form.type_extensionCreate a custom “form extension”
                  form.type_guesserAdd your own logic for “form type guessing”
                  kernel.cache_warmerRegister your service to be called during the cache warming process
                  kernel.event_listenerListen to different events/hooks in Symfony
                  kernel.event_subscriberTo subscribe to a set of different events/hooks in Symfony
                  kernel.fragment_rendererAdd new HTTP content rendering strategies
                  monolog.loggerLogging with a custom logging channel
                  monolog.processorAdd a custom processor for logging
                  routing.loaderRegister a custom service that loads routes
                  security.voterAdd a custom voter to Symfony’s authorization logic
                  security.remember_me_awareTo allow remember me authentication
                  security.listener.factoryNecessary when creating a custom authentication system
                  serializer.encoderRegister a new encoder in the serializer service
                  serializer.normalizerRegister a new normalizer in the serializer service
                  swiftmailer.pluginRegister a custom SwiftMailer Plugin
                  templating.helperMake your service available in PHP templates
                  translation.loaderRegister a custom service that loads translations
                  twig.extensionRegister a custom Twig Extension
                  twig.loaderRegister a custom service that loads Twig templates
                  validator.constraint_validatorCreate your own custom validation constraint
                  validator.initializerRegister a service that initializes objects before validation
                  -
                  -

                  data_collector

                  -

                  Propósito: Crear una clase que recopile datos personalizados para el generador de perfiles

                  -

                  Para información detallada sobre cómo crear tu propio recolector de datos personalizado, lee el artículo en el recetario: Cómo crear un colector de datos personalizado.

                  -
                  -
                  -

                  form.type

                  -

                  Propósito: Crear un tipo de campo de formulario personalizado

                  -

                  Para obtener más información sobre cómo crear tu propio tipo de formulario personalizado, lee el artículo en el recetario: -Cómo crear un tipo de campo personalizado para formulario.

                  -
                  -
                  -

                  form.type_extension

                  -

                  Propósito: Crear una «extensión personalizada de Form»

                  -

                  Las extensiones de tipo Form son una manera para «enganchar» la creación de cualquier campo en tu formulario. Por ejemplo, la adición del fragmento CSRF se hace a través de una extensión del tipo Form (la clase Symfony\Component\Form\Extension\Csrf\Type\FormTypeCsrfExtension).

                  -

                  Una extensión del tipo Form puede modificar cualquier parte de cualquier campo en tu formulario. Para crear una extensión del tipo Form, primero debes crear una clase que implemente la interfaz Symfony\Component\Form\FormTypeExtensionInterface. -Por simplicidad, a menudo extenderás una clase -Symfony\Component\Form\AbstractTypeExtension en lugar de la interfaz directamente:

                  -
                  // src/Acme/MainBundle/Form/Type/MyFormTypeExtension.php
-namespace Acme\MainBundle\Form\Type;
-
-use Symfony\Component\Form\AbstractTypeExtension;
-
-class MyFormTypeExtension extends AbstractTypeExtension
-{
-    // ... rellena cualquier método que quieras redefinir
-    // como buildForm(), buildView(), finishView(), setDefaultOptions()
-}
-
                  -
                  -

                  Para dar a conocer tu extensión del tipo Form a Symfony y usarla, ponle la etiqueta form.type_extension:

                  -
                  -
                    -
                  • YAML
                    services:
-    main.form.type.my_form_type_extension:
-        class: Acme\MainBundle\Form\Type\MyFormTypeExtension
-        tags:
-                - { name: form.type_extension, alias: field }
-
                    -
                    -
                    • -
                  • XML
                    <service id="main.form.type.my_form_type_extension" class="Acme\MainBundle\Form\Type\MyFormTypeExtension">
-    <tag name="form.type_extension" alias="field" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('main.form.type.my_form_type_extension', 'Acme\MainBundle\Form\Type\MyFormTypeExtension')
-    ->addTag('form.type_extension', array('alias' => 'field'))
-;
-
                    -
                    -
                    • -
                  -
                  -

                  La clave alias de la etiqueta es el tipo de campo al que esta extensión se debe aplicar. Por ejemplo, para aplicar la extensión a cualquier «campo», utiliza el valor 'field'.

                  -
                  -
                  -

                  form.type_guesser

                  -

                  Propósito: Añade tu propia lógica para «deducir el tipo del formulario»

                  -

                  Esta etiqueta te permite agregar tu propia lógica al proceso de Deducción del tipo del formulario. De manera predeterminada, la deducción del tipo del formulario se hace por medio de «inferencias» basadas en los metadatos de validación y de Doctrine (si estás usando Doctrine).

                  -

                  Para añadir tu propio adivino del tipo de formulario, crea una clase que implemente la interfaz Symfony\Component\Form\FormTypeGuesserInterface. A continuación, marca la definición de este servicio con form.type_guesser (esta no tiene opciones).

                  -

                  Para ver un ejemplo de cómo podría ser esta clase, consulta la clase ValidatorTypeGuesser en el componente Form.

                  -
                  -
                  -

                  kernel.cache_warmer

                  -

                  Propósito: Registra tu servicio para que sea llamado durante el proceso de precalentamiento para el almacenamiento en caché.

                  -

                  El precalentamiento de la caché se produce cuando ejecutas la tarea cache:warmup o cache:clear (a menos que pases -no-warmp a cache:clear). El propósito es iniciar cualquier caché que necesitará la aplicación y evitar que el primer usuario de algún «uso de caché» importante genera dinámicamente la memoria caché.

                  -

                  Para registrar tu propio precalentamiento de caché, en primer lugar crea un servicio que implemente la interfaz Symfony\Component\HttpKernel\CacheWarmer\CacheWarmerInterface:

                  -
                  // src/Acme/MainBundle/Cache/MyCustomWarmer.php
-namespace Acme\MainBundle\Cache;
-
-use Symfony\Component\HttpKernel\CacheWarmer\CacheWarmerInterface;
-
-class MyCustomWarmer implements CacheWarmerInterface
-{
-    public function warmUp($cacheDir)
-    {
-        // hacer algún tipo de operaciones para "calentar" tu memoria caché
-    }
-
-    public function isOptional()
-    {
-            return true;
-    }
-}
-
                  -
                  -

                  El método isOptional debe devolver true si es posible utilizar la aplicación sin necesidad de llamar al precalentamiento de caché. En Symfony 2.0, los precalentadores opcionales de cualquier modo siempre se ejecutan, por lo tanto esta función no tiene ningún efecto real.

                  -

                  Para registrar tu precalentador en Symfony, ponle la etiqueta kernel.cache_warmer:

                  -
                  -
                    -
                  • YAML
                    services:
-    main.warmer.my_custom_warmer:
-        class: Acme\MainBundle\Cache\MyCustomWarmer
-        tags:
-                - { name: kernel.cache_warmer, priority: 0 }
-
                    -
                    -
                    • -
                  • XML
                    <service id="main.warmer.my_custom_warmer" class="Acme\MainBundle\Cache\MyCustomWarmer">
-    <tag name="kernel.cache_warmer" priority="0" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('main.warmer.my_custom_warmer', 'Acme\MainBundle\Cache\MyCustomWarmer')
-    ->addTag('kernel.cache_warmer', array('priority' => 0))
-;
-
                    -
                    -
                    • -
                  -
                  -

                  El valor priority es opcional y por omisión es 0. Este valor puede estar en el rango de -255 a 255, y los precalentadores se ejecutan en ese orden de prioridad.

                  -
                  -
                  -

                  kernel.event_listener

                  -

                  Propósito: Para escuchar los diferentes eventos o ganchos en Symfony

                  -

                  Esta etiqueta te permite conectar tus propias clases en diferentes puntos del proceso de Symfony.

                  -

                  Para ver un ejemplo completo de este escucha, ve el artículo Cómo crear un escucha de evento del recetario.

                  -

                  Para otro ejemplo práctico de un escucha del núcleo consulta en el recetario el -artículo: Cómo registrar un nuevo formato de petición y tipo MIME.

                  -
                  -

                  Referencia de escuchas de eventos del núcleo

                  -

                  Al agregar tus propios escuchas, puede ser útil saber sobre los otros escuchas del núcleo de Symfony y sus prioridades.

                  -
                  -

                  Nota

                  -

                  Todos los escuchas enumerados aquí posiblemente no figuren dependiendo de tu entorno, configuración y paquetes. Además, los paquetes de terceros traerán escucha adicionales que no figuran en esta lista.

                  -
                  -
                  -

                  kernel.request

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - -
                  Nombre de la clase escuchaPrioridad
                  Symfony\Component\HttpKernel\EventListener\ProfilerListener1024
                  Symfony\Bundle\FrameworkBundle\EventListener\TestSessionListener192
                  Symfony\Bundle\FrameworkBundle\EventListener\SessionListener128
                  Symfony\Component\HttpKernel\EventListener\RouterListener32
                  Symfony\Component\HttpKernel\EventListener\LocaleListener16
                  Symfony\Component\Security\Http\Firewall8
                  -
                  -
                  -

                  kernel.controller

                  - ---- - - - - - - - - -
                  Nombre de la clase escuchaPrioridad
                  Symfony\Bundle\FrameworkBundle\DataCollector\RequestDataCollector0
                  -
                  -
                  -

                  kernel.response

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  Nombre de la clase escuchaPrioridad
                  Symfony\Component\HttpKernel\EventListener\EsiListener0
                  Symfony\Component\HttpKernel\EventListener\ResponseListener0
                  Symfony\Bundle\SecurityBundle\EventListener\ResponseListener0
                  Symfony\Component\HttpKernel\EventListener\ProfilerListener-100
                  Symfony\Bundle\FrameworkBundle\EventListener\TestSessionListener-128
                  Symfony\Bundle\WebProfilerBundle\EventListener\WebDebugToolbarListener-128
                  Symfony\Component\HttpKernel\EventListener\StreamedResponseListener-1024
                  -
                  -
                  -

                  kernel.exception

                  - ---- - - - - - - - - - - - -
                  Nombre de la clase escuchaPrioridad
                  Symfony\Component\HttpKernel\EventListener\ProfilerListener0
                  Symfony\Component\HttpKernel\EventListener\ExceptionListener-128
                  -
                  -
                  -

                  kernel.terminate

                  - ---- - - - - - - - - -
                  Nombre de la clase escuchaPrioridad
                  Symfony\Bundle\SwiftmailerBundle\EventListener\EmailSenderListener0
                  -
                  -
                  -
                  -
                  -

                  kernel.event_subscriber

                  -

                  Propósito: Para suscribirse a un conjunto de diferentes eventos o ganchos en Symfony.

                  -

                  -Nuevo en la versión 2.1: La habilidad para añadir suscriptores a eventos del núcleo se agregó en la versión 2.1.

                  -

                  Para habilitar un suscriptor personalizado, agrégalo como un servicio regular en una de tus configuraciones, y etiquétalo con kernel.event_subscriber:

                  -
                  -
                    -
                  • YAML
                    services:
-    kernel.subscriber.your_subscriber_name:
-        class: Nombre\De\Clase\Del\Suscriptor\Completamente\Cualificado
-        tags:
-                - { name: kernel.event_subscriber }
-
                    -
                    -
                    • -
                  • XML
                    <service id="kernel.subscriber.your_subscriber_name" class="Nombre\De\Clase\Del\Suscriptor\Completamente\Cualificado">
-    <tag name="kernel.event_subscriber" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('kernel.subscriber.your_subscriber_name', 'Nombre\De\Clase\Del\Suscriptor\Completamente\Cualificado')
-    ->addTag('kernel.event_subscriber')
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Tu servicio debe implementar la SymfonyComponentEventDispatcherEventSubscriberInterface.

                  -
                  -
                  -

                  Nota

                  -

                  Si tu servicio es creado por una factoría, DEBES establecer correctamente el parámetro class para que esta etiqueta trabaje correctamente.

                  -
                  -
                  -
                  -

                  kernel.fragment_renderer

                  -

                  Propósito: Add a new HTTP content rendering strategy.

                  -

                  To add a new rendering strategy - in addition to the core strategies like -EsiFragmentRenderer - create a class that implements -Symfony\Component\HttpKernel\Fragment\FragmentRendererInterface, -register it as a service, then tag it with kernel.fragment_renderer.

                  -
                  -
                  -

                  monolog.logger

                  -

                  Propósito: Para utilizar un canal personalizado para el registro cronológico de eventos con Monolog.

                  -

                  Monolog te permite compartir sus controladores entre varios canales del registro cronológico de eventos. -El servicio de registro cronológico utiliza el canal app pero puedes cambiar el canal cuando inyectes el registro cronológico en un servicio.

                  -
                  -
                    -
                  • YAML
                    services:
-    my_service:
-        class: Nombre\De\Clase\Del\Cargador\Completamente\Cualificado
-        arguments: ["@logger"]
-        tags:
-                - { name: monolog.logger, channel: acme }
-
                    -
                    -
                    • -
                  • XML
                    <service id="my_service" class="Nombre\De\Clase\Del\Cargador\Completamente\Cualificado">
-    <argument type="service" id="logger" />
-    <tag name="monolog.logger" channel="acme" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $definition = new Definition('Nombre\De\Clase\Del\Cargador\Completamente\Cualificado', array(new Reference('logger'));
-$definition->addTag('monolog.logger', array('channel' => 'acme'));
-$container->register('my_service', $definition);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  Esto sólo funciona cuando el servicio del registro cronológico es un argumento del constructor, no cuando se inyecta a través de un definidor.

                  -
                  -
                  -
                  -

                  monolog.processor

                  -

                  Propósito: Añadir un procesador personalizado al registro cronológico.

                  -

                  Monolog te permite agregar procesadores al registro cronológico o a los controladores para añadir datos adicionales en los registros. Un procesador recibe el registro como argumento y lo tiene que devolver después de añadir alguna información adicional en el atributo extra del registro.

                  -

                  Vamos a ver cómo puedes utilizar el IntrospectionProcessor integrado para agregar el archivo, la línea, la clase y el método en que se activó el registro cronológico.

                  -

                  Puedes agregar un procesador globalmente:

                  -
                  -
                    -
                  • YAML
                    services:
-    my_service:
-        class: Monolog\Processor\IntrospectionProcessor
-        tags:
-                - { name: monolog.processor }
-
                    -
                    -
                    • -
                  • XML
                    <service id="my_service" class="Monolog\Processor\IntrospectionProcessor">
-    <tag name="monolog.processor" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $definition = new Definition('Monolog\Processor\IntrospectionProcessor');
-$definition->addTag('monolog.processor');
-$container->register('my_service', $definition);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Si el servicio no es ejecutable (con __invoke) puedes agregar el atributo method en la etiqueta para utilizar un método específico.

                  -
                  -

                  También puedes agregar un procesador para un controlador específico utilizando el atributo handler:

                  -
                  -
                    -
                  • YAML
                    services:
-    my_service:
-        class: Monolog\Processor\IntrospectionProcessor
-        tags:
-                - { name: monolog.processor, handler: firephp }
-
                    -
                    -
                    • -
                  • XML
                    <service id="my_service" class="Monolog\Processor\IntrospectionProcessor">
-    <tag name="monolog.processor" handler="firephp" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $definition = new Definition('Monolog\Processor\IntrospectionProcessor');
-$definition->addTag('monolog.processor', array('handler' => 'firephp');
-$container->register('my_service', $definition);
-
                    -
                    -
                    • -
                  -
                  -

                  También puedes agregar un procesador para un canal del registro cronológico específico usando el atributo channel. Esto registrará el procesador únicamente para el canal de registro cronológico de security utilizado en el componente de seguridad:

                  -
                  -
                    -
                  • YAML
                    services:
-    my_service:
-        class: Monolog\Processor\IntrospectionProcessor
-        tags:
-                - { name: monolog.processor, channel: security }
-
                    -
                    -
                    • -
                  • XML
                    <service id="my_service" class="Monolog\Processor\IntrospectionProcessor">
-    <tag name="monolog.processor" channel="security" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $definition = new Definition('Monolog\Processor\IntrospectionProcessor');
-$definition->addTag('monolog.processor', array('channel' => 'security');
-$container->register('my_service', $definition);
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  No puedes utilizar ambos atributos handler y channel para la misma etiqueta debido a que los controladores se comparten entre todos los canales.

                  -
                  -
                  -
                  -

                  routing.loader

                  -

                  Propósito: Registrar un servicio personalizado que carga rutas.

                  -

                  Para habilitar un cargador de enrutado personalizado, añádelo como un servicio regular en tu configuración, y etiquétalo con routing.loader:

                  -
                  -
                    -
                  • YAML
                    services:
-    routing.loader.your_loader_name:
-        class: Nombre\De\Clase\Completamente\Cualificado
-        tags:
-                - { name: routing.loader }
-
                    -
                    -
                    • -
                  • XML
                    <service id="routing.loader.your_loader_name" class="Nombre\De\Clase\Completamente\Cualificado">
-    <tag name="routing.loader" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('routing.loader.your_loader_name', 'Nombre\De\Clase\Del\Cargador\Completamente\Cualificado')
-    ->addTag('routing.loader')
-;
-
                    -
                    -
                    • -
                  -
                  -

                  For more information, see How to create a custom Route Loader.

                  -
                  -
                  -

                  security.listener.factory

                  -

                  Propósito: Necesaria cuando creas un sistema de autenticación personalizado.

                  -

                  Esta etiqueta se utiliza al crear tu propio sistema de autenticación personalizado. Para más información, consulta Cómo crear un proveedor de autenticación personalizado.

                  -
                  -
                  -

                  security.remember_me_aware

                  -

                  Propósito: Para permitir la autenticación «recuérdame».

                  -

                  Esta etiqueta se utiliza internamente para permitir que trabaje la autenticación por recordatorio. Si tienes un método de autenticación personalizado en que el usuario se pueda autenticar por medio de recordatorio, entonces posiblemente tengas que utilizar esta etiqueta.

                  -

                  Si tu factoría de autenticación personalizada extiende la clase Symfony\Bundle\SecurityBundle\DependencyInjection\Security\Factory\AbstractFactory y tu escucha de autenticación personalizado extiende la clase Symfony\Component\Security\Http\Firewall\AbstractAuthenticationListener, entonces el escucha de autenticación personalizado ya está etiquetado y funcionará automáticamente.

                  -
                  -
                  -

                  security.voter

                  -

                  Propósito: Agregar un votante personalizado a la lógica de autorización de Symfony.

                  -

                  Cuando llamas a isGranted en el contexto de seguridad de Symfony, detrás del escenario se usa un sistema de «votantes» para determinar si el usuario debe tener acceso. La etiqueta security.voter te permite agregar tu propio votante personalizado al sistema.

                  -

                  Para obtener más información, lee el artículo del recetario: Cómo implementar tu propio votante para agregar direcciones IP a la lista negra.

                  -
                  -
                  -

                  serializer.encoder

                  -

                  Propósito: Register a new encoder in the serializer service

                  -

                  The class that’s tagged should implement the Symfony\Component\Serializer\Encoder\EncoderInterface -and Symfony\Component\Serializer\Encoder\DecoderInterface.

                  -

                  For more details, see How to use the Serializer.

                  -
                  -
                  -

                  serializer.normalizer

                  -

                  Propósito: Register a new normalizer in the Serializer service

                  -

                  The class that’s tagged should implement the Symfony\Component\Serializer\Normalizer\NormalizerInterface -and Symfony\Component\Serializer\Normalizer\DenormalizerInterface.

                  -

                  For more details, see How to use the Serializer.

                  -
                  -
                  -

                  swiftmailer.plugin

                  -

                  Propósito: Registrar un complemento personalizado a SwiftMailer.

                  -

                  Si estás usando un complemento personalizado para SwiftMailer (o deseas crear uno), lo puedes registrar en SwiftMailer creando un servicio para tu complemento y etiquétalo como swiftmailer.plugin (que no tiene opciones).

                  -

                  Un complemento de SwiftMailer debe implementar la interfaz Swift_Events_EventListener. -Para más información sobre los complementos, consulta la sección Complemento para SwiftMailer de su documentación.

                  -

                  Varios complementos de SwiftMailer son fundamentales para Symfony y los puedes activar a través de diversa configuración. Para obtener más información, consulta Configurando el SwiftmailerBundle (“swiftmailer”).

                  -
                  -
                  -

                  templating.helper

                  -

                  Propósito: Poner tu servicio a disposición de las plantillas PHP

                  -

                  Para habilitar un ayudante de plantilla personalizado, añádelo como un servicio regular en tu configuración, etiquétalo con templating.helper y define un atributo alias (el ayudante será accesible a través de este alias en las plantillas):

                  -
                  -
                    -
                  • YAML
                    services:
-    templating.helper.your_helper_name:
-        class: Nombre\De\Clase\Ayudante\Completamente\Cualificado
-        tags:
-                - { name: templating.helper, alias: alias_name }
-
                    -
                    -
                    • -
                  • XML
                    <service id="templating.helper.your_helper_name" class="Nombre\De\Clase\Ayudante\Completamente\Cualificado">
-    <tag name="templating.helper" alias="alias_name" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('templating.helper.your_helper_name', 'Nombre\De\Clase\Ayudante\Completamente\Cualificado')
-    ->addTag('templating.helper', array('alias' => 'alias_name'))
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  translation.loader

                  -

                  Propósito: Registrar un servicio personalizado que carga traducciones.

                  -

                  De forma predeterminada, las traducciones se cargan desde el sistema de archivos en una variedad de diferentes formatos (YAML, XLIFF, PHP, etc.). Si necesitas cargar traducciones de alguna otra fuente, en primer lugar crea una clase que implemente la interfaz Symfony\Component\Translation\Loader\LoaderInterface:

                  -
                  // src/Acme/MainBundle/Translation/MyCustomLoader.php
-namespace Acme\MainBundle\Translation;
-
-use Symfony\Component\Translation\Loader\LoaderInterface;
-use Symfony\Component\Translation\MessageCatalogue;
-
-class MyCustomLoader implements LoaderInterface
-{
-    public function load($resource, $locale, $domain = 'messages')
-    {
-        $catalogue = new MessageCatalogue($locale);
-
-        // de alguna forma carga algunas traducciones desde el
-        // directorio "resource" y luego las coloca en el catálogo
-        $catalogue->set('hello.world', 'Hello World!', $domain);
-
-        return $catalogue;
-    }
-}
-
                  -
                  -

                  El método load de tu cargador personalizado es responsable de devolver una clase Symfony\Component\Translation\MessageCatalogue.

                  -

                  Ahora, registra tu cargador como un servicio y etiquétalo como translation.loader:

                  -
                  -
                    -
                  • YAML
                    services:
-    main.translation.my_custom_loader:
-        class: Acme\MainBundle\Translation\MyCustomLoader
-        tags:
-                - { name: translation.loader, alias: bin }
-
                    -
                    -
                    • -
                  • XML
                    <service id="main.translation.my_custom_loader" class="Acme\MainBundle\Translation\MyCustomLoader">
-    <tag name="translation.loader" alias="bin" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('main.translation.my_custom_loader', 'Acme\MainBundle\Translation\MyCustomLoader')
-    ->addTag('translation.loader', array('alias' => 'bin'))
-;
-
                    -
                    -
                    • -
                  -
                  -

                  La opción alias es necesaria y muy importante: Esta define la «extensión» del archivo que se utilizará para los archivos de recursos que usa este cargador. Por ejemplo, supongamos que tienes un formato bin personalizado que necesitas cargar. -Si tienes un archivo bin que contiene traducciones al Francés del dominio menssages, entonces podrías tener un archivo app/Resources/translations/messages.fr.bin.

                  -

                  Cuando Symfony intenta cargar el archivo bin, pasa la ruta de acceso a tu cargador personalizado como el argumento $resource a cargar. Entonces, puedes llevar a cabo cualquier lógica que necesites en ese archivo para cargar tus traducciones.

                  -

                  Si vas a cargar las traducciones desde una base de datos, todavía necesitas un archivo de recursos, pero bien podría estar en blanco o contener un poco de información sobre la carga de los recursos desde la base de datos. El archivo es la clave para activar el método load en tu cargador personalizado.

                  -
                  -
                  -

                  twig.extension

                  -

                  Propósito: Registrar una extensión de Twig personalizada.

                  -

                  Para habilitar una extensión Twig, añádela como un servicio regular en tu configuración, y etiquétala con twig.extension:

                  -
                  -
                    -
                  • YAML
                    services:
-    twig.extension.your_extension_name:
-        class: Nombre\De\Clase\De\La\Extensión\Completamente\Cualificado
-        tags:
-                - { name: twig.extension }
-
                    -
                    -
                    • -
                  • XML
                    <service id="twig.extension.your_extension_name" class="Nombre\De\Clase\De\La\Extensión\Completamente\Cualificado">
-    <tag name="twig.extension" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('twig.extension.your_extension_name', 'Nombre\De\Clase\De\La\Extensión\Completamente\Cualificado')
-    ->addTag('twig.extension')
-;
-
                    -
                    -
                    • -
                  -
                  -

                  Para más información sobre cómo crear la clase real para la extensión de Twig, consulta el tema en la documentación de extensiones o lee el artículo del recetario: -Cómo escribir una extensión Twig personalizada

                  -

                  Antes de escribir tus propias extensiones, echa un vistazo al Repositorio oficial de extensiones Twig el cual ya cuenta con varias útiles extensiones. Por ejemplo Intl y su filtro localizeddate que formatea una fecha según la configuración regional del usuario. Estas extensiones oficiales de Twig también se tienen que añadir como servicios normales:

                  -
                  -
                    -
                  • YAML
                    services:
-    twig.extension.intl:
-        class: Twig_Extensions_Extension_Intl
-        tags:
-                - { name: twig.extension }
-
                    -
                    -
                    • -
                  • XML
                    <service id="twig.extension.intl" class="Twig_Extensions_Extension_Intl">
-    <tag name="twig.extension" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('twig.extension.intl', 'Twig_Extensions_Extension_Intl')
-    ->addTag('twig.extension')
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  twig.loader

                  -

                  Propósito: Registrar un servicio personalizado que cargue plantillas Twig

                  -

                  De manera predeterminada, Symfony sólo utiliza un Cargador Twig —Symfony\Bundle\TwigBundle\Loader\FilesystemLoader. Si necesitas cargar plantillas Twig desde otro recurso, puedes crear un servicio para -el nuevo cargador y etiquetarlo con twig.loader:

                  -
                  -
                    -
                  • YAML
                    services:
-    acme.demo_bundle.loader.some_twig_loader:
-        class: Acme\DemoBundle\Loader\SomeTwigLoader
-        tags:
-                - { name: twig.loader }
-
                    -
                    -
                    • -
                  • XML
                    <service id="acme.demo_bundle.loader.some_twig_loader" class="Acme\DemoBundle\Loader\SomeTwigLoader">
-    <tag name="twig.loader" />
-</service>
-
                    -
                    -
                    • -
                  • PHP
                    $container
-    ->register('acme.demo_bundle.loader.some_twig_loader', 'Acme\DemoBundle\Loader\SomeTwigLoader')
-    ->addTag('twig.loader')
-;
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  validator.constraint_validator

                  -

                  Propósito: Crear tu propia restricción de validación personalizada.

                  -

                  Esta etiqueta te permite crear y registrar tu propia restricción de validación personalizada. -Para obtener más información, lee el artículo del recetario: Cómo crear una restricción de validación personalizada.

                  -
                  -
                  -

                  validator.initializer

                  -

                  Propósito: Registrar un servicio que inicia los objetos antes de validarlos.

                  -

                  Esta etiqueta proporciona una pieza de funcionalidad muy poco común que te permite realizar algún tipo de acción sobre un objeto justo antes de validarlo. -Por ejemplo, Doctrine lo utiliza para consultar todos los datos cargados de manera diferida en un objeto antes de validarlos. Sin esto, algunos datos sobre una entidad de Doctrine parecería que hubieran «desaparecido» cuando se validan, a pesar de que este no sea realmente el caso.

                  -

                  Si necesitas usar esta etiqueta, solo crea una nueva clase que implemente la interfaz Symfony\Component\Validator\ObjectInitializerInterface. -Luego, etiquétala como validator.initializer (que no tiene opciones).

                  -

                  Para un ejemplo, consulta la clase EntityInitializer en el puente de Doctrine.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/twig_reference.html b/reference/forms/twig_reference.html deleted file mode 100644 index 1b3f945..0000000 --- a/reference/forms/twig_reference.html +++ /dev/null @@ -1,270 +0,0 @@ - - - - - - - Funciones de plantillas Twig para formularios y referencia de variables — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Funciones de plantillas Twig para formularios y referencia de variables

                  -

                  Al trabajar con formularios en una plantilla, tienes a tu disposición dos potentes cosas:

                  -
                    -
                  • Functiones para pintar cada parte del formulario
                    • -
                  • Variables para conseguir cualquier información sobre algún campo
                    • -
                  -

                  A menudo utilizarás funciones para pintar tus campos. Las variables, por otro lado, generalmente se utilizan menos, pero son infinitamente potentes debido a que puedes acceder a las etiquetas de los campos, los atributo id, errores y cualquier otra información sobre el campo.

                  -
                  -

                  Funciones para pintar formularios

                  -

                  Este manual de referencia cubre todas las posibles funciones Twig disponibles para reproducir formularios. Dispones de muchas funciones diferentes, y cada una es responsable de dibujar una diferente parte de un formulario (por ejemplo, etiquetas, errores, elementos gráficos, etc.).

                  -
                  -
                  -

                  form_label(view, label, variables)

                  -

                  Dibuja la etiqueta para el campo dado. Si lo deseas, puedes pasar como segundo argumento la etiqueta específica que deseas mostrar.

                  -
                  {{ form_label(form.name) }}
-
-{# las dos siguientes sintaxis son equivalentes #}
-{{ form_label(form.name, 'Your Name', {'label_attr': {'class': 'foo'}}) }}
-{{ form_label(form.name, null, {'label': 'Your name', 'label_attr': {'class': 'foo'}}) }}
-
                  -
                  -

                  Ve «Más sobre variables de formulario» para aprender sobre el argumento variables.

                  -
                  -
                  -

                  form_errors(view)

                  -

                  Reproduce los errores para el campo dado.

                  -
                  {{ form_errors(form.name) }}
-
-{# reproduce cualquier error 'global' #}
-{{ form_errors(form) }}
-
                  -
                  -
                  -
                  -

                  form_widget(view, variables)

                  -

                  Pinta el elemento gráfico HTML de un determinado campo. Si aplicas este a todo el formulario o a la colección de campos, dibujará cada fila subyacente del formulario.

                  -
                  {# pinta un elemento gráfico, pero añadiéndole la clase "foo" #}
-{{ form_widget(form.name, {'attr': {'class': 'foo'}}) }}
-
                  -
                  -

                  El segundo argumento de form_widget es un conjunto de variables. La variable más común es attr, que es un arreglo de atributos HTML que puedes aplicar al elemento gráfico HTML. En algunos casos, ciertos tipos también tienen otras opciones relacionadas con la plantilla que les puedes pasar. Estas se explican en base a tipo por tipo. -Los atributos no son aplicados recursivamente a los campos hijo si estás -dibujando muchos campos simultáneamente (p. ej. form_widget(form)).

                  -

                  Ve «Más sobre variables de formulario para aprender más sobre el argumento variables.

                  -
                  -
                  -

                  form_row(view, variables)

                  -

                  Pinta la «fila» (row) de un determinado campo, el cual es la combinación de la etiqueta del campo, los errores y el elemento gráfico.

                  -
                  {# pinta la fila de un campo, pero muestra una etiqueta con el texto 'foo' #}
-{{ form_row(form.name, {'label': 'foo'}) }}
-
                  -
                  -

                  El segundo argumento de form_row es un arreglo de variables. Las plantillas provistas en Symfony sólo permiten redefinir la etiqueta como muestra el ejemplo anterior.

                  -

                  Ve «Más sobre variables de formulario» para aprender sobre el argumento variables.

                  -
                  -
                  -

                  form_rest(view, variables)

                  -

                  Esta dibuja todos los campos que aún no se han pintado en el formulario dado. -Es buena idea tenerlo siempre en alguna parte dentro del formulario ya que debe representar los campos ocultos por ti y los campos que se te olvide dibujar (puesto que va a representar el campo por ti).

                  -
                  {{ form_rest(form) }}
-
                  -
                  -
                  -
                  -

                  form_enctype(view)

                  -

                  Si el formulario contiene al menos un campo para cargar archivos, esta reproducirá el atributo "enctype=multipart/form-data" requerido. Es una buena idea incluirlo siempre en tu etiqueta de formulario:

                  -
                  <form action="{{ path('form_submit') }}" method="post" {{ form_enctype(form) }}>
-
                  -
                  -
                  -
                  -

                  Más sobre variables de formulario

                  -
                  -

                  Truco

                  -

                  Para una lista de variables completa, ve: Referencia de variables de formulario.

                  -
                  -

                  En casi cada una de las funciones Twig anteriores, el argumento final es un arreglo de «variables» que se utiliza al dibujar una parte del formulario. Por ejemplo, lo siguiente dibuja el «elemento gráfico» para un campo, y modifica sus atributos -para incluir una clase especial:

                  -
                  {# pinta un elemento gráfico, pero añadiéndole la clase "foo" #}
-{{ form_widget(form.name, { 'attr': {'class': 'foo'} }) }}
-
                  -
                  -

                  El propósito de estas variables —qué hacen y de donde vienen— puede no ser claro inmediatamente, pero son increíblemente potentes. Siempre que pintas cualquier parte de un formulario, el bloque que estés dibujando usa una serie de variables. De manera predefinida, estos bloques viven en form_div_layout.html.twig.

                  -

                  Considera la form_label por ejemplo:

                  -
                  {% block form_label %}
-    {% if not compound %}
-        {% set label_attr = label_attr|merge({'for': id}) %}
-    {% endif %}
-    {% if required %}
-        {% set label_attr = label_attr|merge({'class': (label_attr.class|default('') ~ ' required')|trim}) %}
-    {% endif %}
-    {% if label is empty %}
-        {% set label = name|humanize %}
-    {% endif %}
-    <label{% for attrname, attrvalue in label_attr %} {{ attrname }}="{{ attrvalue }}"{% endfor %}>{{ label|trans({}, translation_domain) }}</label>
-{% endblock form_label %}
-
                  -
                  -

                  Este bloque utiliza diversas variables: compound, label_attr, required, -label, name and translation_domain. -Estas variables las hace disponibles el sistema de representación del formulario. Pero más importante aún, estas son las variables que puedes sustituir cuándo llamas a form_label -(debido a que en este ejemplo, estás dibujando la etiqueta).

                  -

                  Las variables disponibles exactas a sustituir dependen de en qué parte del formulario estás dibujando (p. ej. etiqueta frente a elemento gráfico) y en qué campo estás dibujando (p. ej. un elemento gráfico de elección —choice— tiene una opción expanded extra). Si te sientes cómodo viendo a través del form_div_layout.html.twig, siempre serás capaz de ver qué opciones tienes disponibles.

                  -
                  -

                  Truco

                  -

                  Detrás de la escena, estas variables las hace disponibles el objeto FormView de tu formulario cuándo el componente form llama a buildView y buildViewBottomUp en cada «nodo» de tu árbol del formulario. Para «ver» qué variables en particular tiene el campo, busca el campo en el código fuente del formulario (y sus campos padre) y observa las dos funciones anteriores.

                  -
                  -
                  -

                  Nota

                  -

                  Si estás dibujando simultáneamente un formulario entero (o un formulario integrado entero), el argumento variables sólo será aplicado al formulario en sí mismo y no a sus descendientes. En otras palabras, lo siguiente no pasará un atributo de clase «foo» a todos los campos descendientes en el formulario:

                  -
                  {# **no** trabaja  - las variables no son recursivas #}
-{{ form_widget(form, { 'attr': {'class': 'foo'} }) }}
-
                  -
                  -
                  -
                  -

                  Referencia de variables de formulario

                  -

                  Las siguientes variables son comunes a cada tipo de campo. Ciertos tipos de campo incluso pueden tener más variables y aquí algunas variables en realidad sólo aplican a determinados tipos.

                  -

                  Suponiendo que tienes una variable form en tu plantilla, y quieres hacer una referencia a las variables en el campo nombre, puedes acceder a las variables utilizando la propiedad pública vars en el objeto de la clase Symfony\Component\Form\FormView:

                  -
                  -
                    -
                  • Twig
                    <label for="{{ form.name.vars.id }}"
-    class="{{ form.name.vars.required ? 'required' : '' }}">
-    {{ form.name.vars.label }}
-</label>
                    -
                    -
                    • -
                  • PHP
                    <label for="<?php echo $view['form']->get('name')->vars['id'] ?>"
-    class="<?php echo $view['form']->get('name')->vars['required'] ? 'required' : '' ?>">
-    <?php echo $view['form']->get('name')->vars['label'] ?>
-</label>
-
                    -
                    -
                    • -
                  -
                  -

                  -Nuevo en la versión 2.1: Las variables valid, label_attr, compound y disabled son nuevas en Symfony 2.1.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types.html b/reference/forms/types.html deleted file mode 100644 index 74744af..0000000 --- a/reference/forms/types.html +++ /dev/null @@ -1,202 +0,0 @@ - - - - - - - Referencia de tipos para formulario — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Referencia de tipos para formulario

                  -
                  -
                  -

                  Un formulario se compone de campos, cada uno de los cuales se construye con la ayuda de un tipo de campo (por ejemplo, un tipo text, tipo choices, etc.) Symfony2 viene con una larga lista de tipos de campo que puedes utilizar en tu aplicación.

                  -
                  -

                  Tipos de campo admitidos

                  -

                  Los siguientes tipos de campo están disponibles de forma nativa en Symfony2:

                  -
                  -

                  Campos de texto

                  - -
                  -
                  -

                  Campos de elección

                  - -
                  -
                  -

                  Campos de fecha y hora

                  - -
                  -
                  -

                  Otros campos

                  - -
                  -
                  -

                  Campos agrupados

                  - -
                  -
                  -

                  Campos ocultos

                  - -
                  -
                  -

                  Campos base

                  - -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/birthday.html b/reference/forms/types/birthday.html deleted file mode 100644 index e47e467..0000000 --- a/reference/forms/types/birthday.html +++ /dev/null @@ -1,311 +0,0 @@ - - - - - - - Tipo de campo birthday — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo birthday

                  -

                  Un campo date que se especializa en el manejo de fechas de cumpleaños.

                  -

                  Se puede reproducir como un cuadro de texto, tres cuadros de texto (mes, día y año), o tres cuadros de selección.

                  -

                  Este tipo esencialmente es el mismo que el tipo date, pero con un predeterminado más apropiado para la opción years. La opción predeterminada de years es 120 años atrás del año en curso.

                  - ---- - - - - - - - - - - - - - - - - - - - - -
                  Underlying Data Typecan be DateTime, string, timestamp, or array (see the input option)
                  Rendered ascan be three select boxes or 1 or 3 text boxes, based on the widget option
                  Options -
                  Inherited -options -
                  Parent typedate
                  ClassSymfony\Component\Form\Extension\Core\Type\BirthdayType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  years

                  -

                  tipo: array predeterminado: 120 años atrás de la fecha actual

                  -

                  Lista de años disponibles para el tipo de campo year. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo date:

                  -
                  -
                  -
                  -

                  widget

                  -

                  tipo: string predefinido: choice

                  -

                  La forma básica en que se debe reproducir este campo. Puede ser una de las siguientes:

                  -
                    -
                  • choice: pinta tres selectores. The order of the selects is defined -in the format option.
                    • -
                  • text: pinta tres campos de entrada de tipo text (para el mes, día y año).
                    • -
                  • single_text: renders a single input of type date (text in Symfony 2.0). User’s -input is validated based on the format option.
                    • -
                  -
                  -

                  Prudencia

                  -

                  If timestamp is used, DateType is limited to dates between -Fri, 13 Dec 1901 20:45:54 GMT and Tue, 19 Jan 2038 03:14:07 GMT on 32bit -systems. This is due to a limitation in PHP itself.

                  -
                  -
                  -
                  -

                  input

                  -

                  tipo: string predefinido: datetime

                  -

                  El formato del dato input —es decir, el formato de la fecha en que se almacena en el objeto subyacente. Los valores válidos son los siguientes:

                  -
                    -
                  • string (por ejemplo 2011-06-05)
                    • -
                  • datetime (un objeto DateTime)
                    • -
                  • array (por ejemplo array('year' => 2011, 'month' => 06, 'day' => 05))
                    • -
                  • timestamp (por ejemplo 1307232000)
                    • -
                  -

                  El valor devuelto por el formulario también se normaliza de nuevo a este formato.

                  -
                  -

                  Prudencia

                  -

                  If timestamp is used, DateType is limited to dates between -Fri, 13 Dec 1901 20:45:54 GMT and Tue, 19 Jan 2038 03:14:07 GMT on 32bit -systems. This is due to a limitation in PHP itself.

                  -
                  -
                  -
                  -

                  months

                  -

                  tipo: array predeterminado: 1 a 12

                  -

                  Lista de los meses disponibles para el tipo de campo month. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  days

                  -

                  tipo: array predeterminado: 1 a 31

                  -

                  Lista de los días disponibles para el tipo de campo day. Esta opción sólo es relevante cuando la opción widget está establecida en choice:

                  -
                  'days' => range(1,31)
-
                  -
                  -
                  -
                  -

                  format

                  -

                  tipo: integer o string predefinido: IntlDateFormatter::MEDIUM

                  -

                  Opción pasada a la clase IntlDateFormatter, utilizada para transformar la entrada del usuario al formato adecuado. Esto es crítico cuando la opción widget se configura a single_text, y necesitas definir la forma en que el usuario debe introducir los datos. -De manera predeterminada, el formato se determina basándose en la configuración regional del usuario actual; significa que el formato esperado será diferente para distintos usuarios. La puedes redefinir pasando el formato como una cadena.

                  -

                  Para más información sobre formatos válidos, consulta la Sintaxis de formatos Date/Time. For -example, to render a single text box that expects the user to enter yyyy-MM-dd, -use the following options:

                  -
                  $builder->add('date_created', 'date', array(
-    'widget' => 'single_text',
-    'format' => 'yyyy-MM-dd',
-));
-
                  -
                  -
                  -
                  -

                  data_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria en que se almacenan los datos entrantes. Esta debe ser una de las zonas horarias compatibles con PHP

                  -
                  -
                  -

                  user_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria para mostrar los datos al usuario (y por lo tanto también los datos que el usuario envía). Esta debe ser una de las zonas horarias compatibles con PHP

                  -

                  Estas opciones las hereda del tipo date:

                  -
                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -

                  These options inherit from the date type:

                  -
                  -
                  -

                  virtual

                  -

                  tipo: boolean default: false

                  -

                  This option determines if the form will be mapped with data. This can be useful -if you need a form to structure the view. See Cómo usar la opción virtual en los campos de formulario.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/checkbox.html b/reference/forms/types/checkbox.html deleted file mode 100644 index 73cb8ea..0000000 --- a/reference/forms/types/checkbox.html +++ /dev/null @@ -1,225 +0,0 @@ - - - - - - - Tipo de campo checkbox — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo checkbox

                  -

                  Crea una única casilla de entrada. Este siempre se debe utilizar para un campo que tiene un valor booleano: si la casilla está marcada, el campo se establece en true, si la casilla está desmarcada, el valor se establece en false.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput checkbox field
                  Options -
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\CheckboxType
                  -
                  -

                  Ejemplo de uso

                  -
                  $builder->add('public', 'checkbox', array(
-    'label'     => 'Show this entry publicly?',
-    'required'  => false,
-));
-
                  -
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  value

                  -

                  tipo: mixed predeterminado: 1

                  -

                  El valor utilizado realmente como valor de la casilla de verificación. Esto no afecta al valor establecido en tu objeto.

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/choice.html b/reference/forms/types/choice.html deleted file mode 100644 index 9314b16..0000000 --- a/reference/forms/types/choice.html +++ /dev/null @@ -1,422 +0,0 @@ - - - - - - - Tipo de campo choice — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo choice

                  -

                  Un campo multipropósito para que el usuario pueda «elegir» una o más opciones. -Este se puede representar como una etiqueta select, botones de radio o casillas de verificación.

                  -

                  Para utilizar este campo, debes especificar algún elemento de la choice_list o choices.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered ascan be various tags (see below)
                  Options -
                  Inherited -options -
                  Parent typeform (if expanded), field otherwise
                  ClassSymfony\Component\Form\Extension\Core\Type\ChoiceType
                  -
                  -

                  Ejemplo de uso

                  -

                  La forma fácil de utilizar este campo es especificando las opciones directamente a través de la opción choices. La clave del arreglo se convierte en el valor que en realidad estableces en el objeto subyacente (por ejemplo, m), mientras que el valor es lo que el usuario ve en el formulario (por ejemplo, Hombre).

                  -
                  $builder->add('gender', 'choice', array(
-    'choices'   => array('m' => 'Male', 'f' => 'Female'),
-    'required'  => false,
-));
-
                  -
                  -

                  Al establecer multiple a true, puedes permitir al usuario elegir varios valores. El elemento gráfico se reproduce como una etiqueta select múltiple o una serie de casillas de verificación dependiendo de la opción expanded:

                  -
                  $builder->add('availability', 'choice', array(
-    'choices'   => array(
-        'morning'   => 'Morning',
-        'afternoon' => 'Afternoon',
-        'evening'   => 'Evening',
-    ),
-    'multiple'  => true,
-));
-
                  -
                  -

                  También puedes utilizar la opción choice_list, la cual toma un objeto que puede especificar las opciones para el elemento gráfico.

                  -
                  -
                  -

                  Etiqueta select, casillas de verificación o botones de radio

                  -

                  Este campo se puede reproducir como uno de varios campos HTML, dependiendo de las opciones expanded y multiple:

                  - ----- - - - - - - - - - - - - - - - - - - - - - - - - -
                  tipo elementoexpandidomúltiple
                  etiqueta de selecciónfalsefalse
                  etiqueta de selección (con atributo -multiple)falsetrue
                  botones de radiotruefalse
                  caja de verificación (checkboxes)truetrue
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  choices

                  -

                  tipo: array predeterminado: array()

                  -

                  Esta es la forma más sencilla de especificar las opciones que debe utilizar este campo. La opción choices es un arreglo, donde la clave del arreglo es el valor del elemento y el valor del arreglo es la etiqueta del elemento:

                  -
                  $builder->add('gender', 'choice', array(
-    'choices' => array('m' => 'Male', 'f' => 'Female')
-));
-
                  -
                  -
                  -
                  -

                  choice_list

                  -

                  tipo: Symfony\Component\Form\Extension\Core\ChoiceList\ChoiceListInterface

                  -

                  Esta es una manera de especificar las opciones que se utilizan para este campo. -La opción choice_list debe ser una instancia de ChoiceListInterface. -Para casos más avanzados, puedes crear una clase personalizada que implemente la interfaz para suplir las opciones.

                  -
                  -
                  -

                  multiple

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el usuario podrá seleccionar varias opciones (en contraposición a elegir sólo una opción). Dependiendo del valor de la opción expanded, esto reproducirá una etiqueta de selección o casillas de verificación si es true y una etiqueta de selección o botones de radio si es false. El valor devuelto será un arreglo.

                  -
                  -
                  -

                  expanded

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los botones de radio o casillas de verificación se reproducirán (en función del valor de multiple). Si es false, se reproducirá un elemento de selección.

                  -
                  -
                  -

                  preferred_choices

                  -

                  tipo: array predeterminado: array()

                  -

                  Si se especifica esta opción, entonces un subconjunto de todas las opciones se trasladará a la parte superior del menú de selección. Lo siguiente debe mover la opción «Baz» a la parte superior, con una separación visual entre esta y el resto de las opciones:

                  -
                  $builder->add('foo_choices', 'choice', array(
-    'choices' => array('foo' => 'Foo', 'bar' => 'Bar', 'baz' => 'Baz'),
-    'preferred_choices' => array('baz'),
-));
-
                  -
                  -

                  Ten en cuenta que las opciones preferidas sólo son útiles cuando se reproducen como un elemento select (es decir, expanded es false). Las opciones preferidas y las opciones normales están separadas visualmente por un conjunto de líneas punteadas (es decir, -------------------). -Esto se puede personalizar cuando reproduzcas el campo:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.foo_choices, { 'separator': '=====' }) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['foo_choices'], array('separator' => '=====')) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  empty_value

                  -

                  tipo: string o Boolean

                  -

                  Esta opción determina si o no una opción empty especial (por ejemplo, «Elige una opción») aparecerá en la parte superior de un elemento gráfico de selección. Esta opción sólo se aplica si ambas opciones expanded y multiple se establecen en false.

                  -
                    -

                  • Añade un valor vacío con «Elige una opción», como el texto:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => 'Choose an option',
-));
-
                    -
                    -
                    • -

                  • Garantiza que ninguna opción con valor empty se muestre:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => false,
-));
-
                    -
                    -
                    • -
                  -

                  Si dejas sin establecer la opción empty_value, entonces automáticamente se añadirá una opción con espacio en blanco (sin texto) si y sólo si la opción required es false:

                  -
                  // añadirá una opción de espacio en blanco (sin texto)
-$builder->add('states', 'choice', array(
-    'required' => false,
-));
-
                  -
                  -
                  -
                  -

                  empty_data

                  -

                  tipo: mixed predeterminado: array() si multiple o expanded, de lo contrario ''

                  -

                  Esta opción determina qué valor devolverá el campo cuando está seleccionada la -opción empty_value.

                  -

                  Por ejemplo, si deseas que el campo género que, cuando no hay valor seleccionado, se configure en null, lo puedes hacer de la siguiente manera:

                  -
                  $builder->add('gender', 'choice', array(
-    'choices' => array(
-        'm' => 'Male',
-        'f' => 'Female'
-    ),
-    'required'    => false,
-    'empty_value' => 'Choose your gender',
-    'empty_data'  => null
-));
-
                  -
                  -
                  -

                  Nota

                  -

                  If you want to set the empty_data option for your entire form class, -see the cookbook article How to configure Empty Data for a Form Class

                  -
                  -
                  -
                  -

                  by_reference

                  -

                  tipo: Boolean predeterminado: true

                  -

                  En muchos casos, si tienes un campo name, entonces esperas que setName sea invocado en el objeto subyacente. No obstante, en algunos casos, posiblemente setName no sea invocado. Al configurar by_reference te aseguras de que el definidor se llama en todos los casos.

                  -

                  Para explicar mejor esto, aquí tienes un sencillo ejemplo:

                  -
                  $builder = $this->createFormBuilder($article);
-$builder
-    ->add('title', 'text')
-    ->add(
-        $builder->create('author', 'form', array('by_reference' => ?))
-            ->add('name', 'text')
-            ->add('email', 'email')
-    )
-
                  -
                  -

                  Si by_reference es true, lo siguiente se lleva a cabo tras bambalinas al llamar a bind en el formulario:

                  -
                  $article->setTitle('...');
-$article->getAuthor()->setName('...');
-$article->getAuthor()->setEmail('...');
-
                  -
                  -

                  Ten en cuenta que no se llama a setAuthor. El autor es modificado por referencia.

                  -

                  Si configuraste by_reference a falso, el vínculo se parece esto:

                  -
                  $article->setTitle('...');
-$author = $article->getAuthor();
-$author->setName('...');
-$author->setEmail('...');
-$article->setAuthor($author);
-
                  -
                  -

                  Por lo tanto, by_reference=false lo que realmente hace es forzar a la plataforma a llamar al definidor en el padre del objeto.

                  -

                  Del mismo modo, si estás usando el tipo Colección del formulario en el que los datos subyacentes de la colección son un objeto (como con ArrayCollection de Doctrine), entonces debes establecer by_reference a false si necesitas invocar al definidor (por ejemplo, setAuthors).

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -

                  These options inherit from the date type:

                  -
                  -
                  -

                  virtual

                  -

                  tipo: boolean default: false

                  -

                  This option determines if the form will be mapped with data. This can be useful -if you need a form to structure the view. See Cómo usar la opción virtual en los campos de formulario.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/collection.html b/reference/forms/types/collection.html deleted file mode 100644 index 475e889..0000000 --- a/reference/forms/types/collection.html +++ /dev/null @@ -1,464 +0,0 @@ - - - - - - - Tipo de campo Collection — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo Collection

                  -

                  Este tipo de campo suele reproducir una «colección» de algún campo o formulario. En el sentido más sencillo, puede ser un arreglo de campos de texto que pueblan un arreglo de campos del tipo email. En ejemplos más complejos, puedes incrustar formularios enteros, lo cual es útil cuándo creas formularios que exponen relaciones uno-a-muchos (por ejemplo, un producto desde donde puedes gestionar muchos productos relacionados con fotos).

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asdepends on the type option
                  Options -
                  Inherited -options -
                  Parent typeform
                  ClassSymfony\Component\Form\Extension\Core\Type\CollectionType
                  -
                  -

                  Nota

                  -

                  If you are working with a collection of Doctrine entities, pay special -attention to the allow_add, allow_delete and by_reference options. -You can also see a complete example in the cookbook article -Cómo integrar una colección de formularios.

                  -
                  -
                  -

                  Uso básico

                  -

                  Este tipo se utiliza cuándo quieres gestionar una colección de elementos similares en un formulario. Por ejemplo, supongamos que tienes un campo emails que corresponde a un arreglo de direcciones de correo electrónico. En el formulario, quieres exponer cada dirección de correo electrónico en su propio cuadro de entrada de texto:

                  -
                  $builder->add('emails', 'collection', array(
-    // cada elemento en el arreglo debe ser un campo "email"
-    'type'   => 'email',
-    // estas opciones se pasan a cada tipo "email"
-    'options'  => array(
-        'required'  => false,
-        'attr'      => array('class' => 'email-box')
-    ),
-));
-
                  -
                  -

                  La manera más sencilla de reproducir esto es pintar todo simultáneamente:

                  -
                  -
                    -
                  • Twig
                    {{ form_row(form.emails) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->row($form['emails']) ?>
-
                    -
                    -
                    • -
                  -
                  -

                  Un método mucho más flexible sería el siguiente:

                  -
                  -
                    -
                  • Twig
                    {{ form_label(form.emails) }}
-{{ form_errors(form.emails) }}
-
-<ul>
-{% for emailField in form.emails %}
-    <li>
-        {{ form_errors(emailField) }}
-        {{ form_widget(emailField) }}
-    </li>
-{% endfor %}
-</ul>
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->label($form['emails']) ?>
-<?php echo $view['form']->errors($form['emails']) ?>
-
-<ul>
-<?php foreach ($form['emails'] as $emailField): ?>
-    <li>
-        <?php echo $view['form']->errors($emailField) ?>
-        <?php echo $view['form']->widget($emailField) ?>
-    </li>
-<?php endforeach; ?>
-</ul>
-
                    -
                    -
                    • -
                  -
                  -

                  En ambos casos, no se reproducirán campos de entrada a menos que tu arreglo de datos emails ya contenga algunas direcciones de correo electrónico.

                  -

                  En este sencillo ejemplo, todavía es imposible añadir nuevas direcciones o eliminar direcciones existentes. Es posible añadir nuevas direcciones utilizando la opción allow_add (y opcionalmente la opción prototype) (ve el ejemplo más adelante). Es posible eliminar direcciones de correo del arreglo emails con la opción allow_delete.

                  -
                  -

                  Agregando y quitando elementos

                  -

                  Si fijas allow_add en true, entonces si se presenta algún elemento no reconocido, simplemente será añadido al arreglo de elementos. Esto es grandioso en teoría, pero en la practica, conlleva un poco más de esfuerzo conseguir el JavaScript correcto de lado del cliente.

                  -

                  Siguiendo con el ejemplo anterior, supongamos que empiezas con dos direcciones de correo electrónico en el arreglo de datos emails. En este caso, se pintarán dos campos de entrada que se verán algo así (dependiendo del nombre de tu -formulario):

                  -
                  <input type="email" id="form_emails_0" name="form[emails][0]" value="foo@foo.com" />
-<input type="email" id="form_emails_1" name="form[emails][1]" value="bar@bar.com" />
-
                  -
                  -

                  Para permitir que tu usuario agregue otro correo electrónico, solo establece allow_add a true y —vía JavaScript— reproduce otro campo con el nombre de form[emails][2] (y así sucesivamente para más y más campos).

                  -

                  Para facilitarte esto, ajusta la opción prototype a true para permitirte reproducir un campo plantilla, el cual luego puedes usar en tu JavaScript para ayudarte a crear estos nuevos campos dinámicamente. Al pintar un campo prototipo se verá algo como esto:

                  -
                  <input type="email" id="form_emails___name__" name="form[emails][__name__]" value="" />
-
                  -
                  -

                  Al reemplazar __name__ con algún valor único (por ejemplo 2), puedes construir e insertar nuevos campos HTML en tu formulario.

                  -

                  Al usar jQuery, un ejemplo sencillo se podría ver como este. Si estás pintando tu colección de campos simultáneamente (por ejemplo, form_row(form.emails)), entonces las cosas son aún más fáciles, porque el atributo data-prototype automáticamente los reproduce por ti (con una ligera diferencia —ve la nota abajo—) y todo lo que necesitas es el código JavaScript:

                  -
                  -
                    -
                  • Twig
                    <form action="..." method="POST" {{ form_enctype(form) }}>
-    {# ... #}
-
-    {# almacena el prototipo en el atributo data-prototype #}
-    <ul id="email-fields-list" data-prototype="{{ form_widget(form.emails.vars.prototype) | e }}">
-    {% for emailField in form.emails %}
-        <li>
-            {{ form_errors(emailField) }}
-            {{ form_widget(emailField) }}
-        </li>
-    {% endfor %}
-    </ul>
-
-    <a href="#" id="add-another-email">Add another email</a>
-
-    {# ... #}
-</form>
-
-<script type="text/javascript">
-    // realiza un seguimiento de cuántos campos de correo electrónico se han pintado
-    var emailCount = '{{ form.emails | length }}';
-
-    jQuery(document).ready(function() {
-        jQuery('#add-another-email').click(function() {
-            var emailList = jQuery('#email-fields-list');
-
-            // graba la plantilla prototipo
-            var newWidget = emailList.attr('data-prototype');
-            // sustituye el "__name__" usado en el id y name del prototipo con un
-            // número que es único en tus correos termina con el
-            // atributo name viéndose como name="contact[emails][2]"
-            newWidget = newWidget.replace(/\$\$name\$\$/g, emailCount);
-            emailCount++;
-
-            // crea un nuevo elemento lista y lo añade a la lista
-            var newLi = jQuery('<li></li>').html(newWidget);
-            newLi.appendTo(jQuery('#email-fields-list'));
-
-                return false;
-        });
-    })
-</script>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Truco

                  -

                  Si estás reproduciendo la colección entera a la vez, entonces el prototipo automáticamente está disponible en el atributo data-prototype del elemento (por ejemplo div o table) que rodea a tu colección. La única diferencia es que la «fila del formulario» entera es dibujada para ti, lo cual significa que no tendrás que envolverla en ningún elemento contenedor como se hizo arriba.

                  -
                  -
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  type

                  -

                  tipo: string o Symfony\Component\Form\FormTypeInterface requerido

                  -

                  Este es el tipo de campo para cada elemento de esta colección (por ejemplo, text, choice, etc.) Por ejemplo, si tienes un arreglo de direcciones de correo electrónico, debes usar el tipo email. Si quieres integrar una colección de algún otro formulario, crea una nueva instancia de tu tipo formulario y pásala como esta opción.

                  -
                  -
                  -

                  options

                  -

                  tipo: array predeterminado: array()

                  -

                  Este es el arreglo que pasaste al tipo formulario especificado en la opción type. Por ejemplo, si utilizaste el tipo choice como tu opción type (por ejemplo, para una colección de menús desplegables), entonces necesitarás —por lo menos— pasar la opción choices al tipo subyacente:

                  -
                  $builder->add('favorite_cities', 'collection', array(
-    'type'   => 'choice',
-    'options'  => array(
-        'choices'  => array(
-            'nashville' => 'Nashville',
-            'paris'     => 'Paris',
-            'berlin'    => 'Berlin',
-            'london'    => 'London',
-        ),
-    ),
-));
-
                  -
                  -
                  -
                  -

                  allow_add

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si la fijas a true, entonces si envías elementos no reconocidos a la colección, estos se añadirán cómo nuevos elementos. El arreglo final contendrá los elementos existentes así como el nuevo elemento que estaba en el dato entregado. Ve el ejemplo anterior para más detalles.

                  -

                  Puedes usar la opción prototype para ayudarte a reproducir un elemento prototipo que puedes utilizar —con JavaScript— para crear dinámicamente nuevos elementos en el cliente. Para más información, ve el ejemplo anterior y Permitiendo «nuevas» etiquetas con «prototype».

                  -
                  -

                  Prudencia

                  -

                  Si estás integrando otros formularios enteros para reflejar una relación de base de datos uno-a-muchos, posiblemente necesites asegurarte manualmente que la llave externa de estos nuevos objetos se establece correctamente. Si estás utilizando Doctrine, esto no sucederá automáticamente. Ve el enlace anterior para más detalles.

                  -
                  -
                  -
                  -

                  allow_delete

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si lo fijas a true, entonces si un elemento existente no está contenido en el dato entregado, correctamente estará ausente del arreglo de los elementos finales. Esto significa que puedes implementar un botón «eliminar» vía JavaScript el cuál sencillamente quita un elemento del DOM del formulario. Cuándo el usuario envía el formulario, la ausencia del dato entregado significará que fue quitado del arreglo final.

                  -

                  Para más información, ve Permitiendo la remoción de etiquetas.

                  -
                  -

                  Prudencia

                  -

                  Se prudente cuándo utilices esta opción al integrar una colección de objetos. En este caso, si se retira algún formulario incrustado, este se debería olvidar correctamente en el arreglo de objetos final. Aun así, dependiendo de la lógica de tu aplicación, cuándo uno de estos objetos es removido, posiblemente quieras eliminarlo o al menos quitar la referencia de la clave externa del objeto principal. -Nada de esto se maneja automáticamente. Para más información, ve Permitiendo la remoción de etiquetas.

                  -
                  -
                  -
                  -

                  prototype

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Esta opción es útil cuando utilizas la opción allow_add. Si es true (y si además allow_add también es true), un atributo «prototype» especial estará disponible a modo de que puedas reproducir una «plantilla» de ejemplo en la página en que aparecerá un nuevo elemento. El atributo name dado a este elemento es __name__. Esto te permite añadir un botón «añadir otro» vía JavaScript el cuál lee el prototipo, reemplaza __name__ con algún nombre o número único y lo reproduce dentro de tu formulario. Cuándo se envía, este se añade a tu arreglo subyacente gracias a la opción allow_add.

                  -

                  El campo prototipo se puede pintar vía la variable prototype del campo colección:

                  -
                  -
                    -
                  • Twig
                    {{ form_row(form.emails.vars.prototype) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->row($form['emails']->vars['prototype']) ?>
-
                    -
                    -
                    • -
                  -
                  -

                  Ten en cuenta que todo lo que realmente necesitas es el «elemento gráfico», pero dependiendo del formulario que estés reproduciendo, puede ser más fácil para ti pintar la «fila del formulario» entera.

                  -
                  -

                  Truco

                  -

                  Si estás reproduciendo el campo colección entero a la vez, entonces el prototipo de la fila del formulario automáticamente está disponible en el atributo data-prototype del elemento (por ejemplo div o table) que envuelve tu colección.

                  -
                  -

                  Para obtener más información sobre como utilizar esta opción, ve el ejemplo anterior, así como Permitiendo «nuevas» etiquetas con «prototype».

                  -
                  -
                  -

                  prototype_name

                  -

                  -Nuevo en la versión 2.1: La opción prototype_name se agregó en Symfony 2.1

                  -

                  tipo: string predefinido: __name__

                  -

                  Si tienes varias colecciones en tu formulario, o peor aún, colecciones anidadas posiblemente quieras cambiar el marcador de posición a modo que los marcadores de posición no relacionados no sean reemplazados con el mismo valor.

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones heredan del tipo field. -No todas las opciones figuran en esta lista —solo las aplicables a este tipo:

                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -

                  by_reference

                  -

                  tipo: Boolean predeterminado: true

                  -

                  En muchos casos, si tienes un campo name, entonces esperas que setName sea invocado en el objeto subyacente. No obstante, en algunos casos, posiblemente setName no sea invocado. Al configurar by_reference te aseguras de que el definidor se llama en todos los casos.

                  -

                  Para explicar mejor esto, aquí tienes un sencillo ejemplo:

                  -
                  $builder = $this->createFormBuilder($article);
-$builder
-    ->add('title', 'text')
-    ->add(
-        $builder->create('author', 'form', array('by_reference' => ?))
-            ->add('name', 'text')
-            ->add('email', 'email')
-    )
-
                  -
                  -

                  Si by_reference es true, lo siguiente se lleva a cabo tras bambalinas al llamar a bind en el formulario:

                  -
                  $article->setTitle('...');
-$article->getAuthor()->setName('...');
-$article->getAuthor()->setEmail('...');
-
                  -
                  -

                  Ten en cuenta que no se llama a setAuthor. El autor es modificado por referencia.

                  -

                  Si configuraste by_reference a falso, el vínculo se parece esto:

                  -
                  $article->setTitle('...');
-$author = $article->getAuthor();
-$author->setName('...');
-$author->setEmail('...');
-$article->setAuthor($author);
-
                  -
                  -

                  Por lo tanto, by_reference=false lo que realmente hace es forzar a la plataforma a llamar al definidor en el padre del objeto.

                  -

                  Del mismo modo, si estás usando el tipo Colección del formulario en el que los datos subyacentes de la colección son un objeto (como con ArrayCollection de Doctrine), entonces debes establecer by_reference a false si necesitas invocar al definidor (por ejemplo, setAuthors).

                  -
                  -
                  -

                  empty_data

                  -

                  tipo: mixed predeterminado: array() si multiple o expanded, de lo contrario ''

                  -

                  Esta opción determina qué valor devolverá el campo cuando está seleccionada la -opción empty_value.

                  -

                  Por ejemplo, si deseas que el campo género que, cuando no hay valor seleccionado, se configure en null, lo puedes hacer de la siguiente manera:

                  -
                  $builder->add('gender', 'choice', array(
-    'choices' => array(
-        'm' => 'Male',
-        'f' => 'Female'
-    ),
-    'required'    => false,
-    'empty_value' => 'Choose your gender',
-    'empty_data'  => null
-));
-
                  -
                  -
                  -

                  Nota

                  -

                  If you want to set the empty_data option for your entire form class, -see the cookbook article How to configure Empty Data for a Form Class

                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/country.html b/reference/forms/types/country.html deleted file mode 100644 index 8403892..0000000 --- a/reference/forms/types/country.html +++ /dev/null @@ -1,276 +0,0 @@ - - - - - - - Tipo de campo country — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo country

                  -

                  El tipo country es un subconjunto de ChoiceType que muestra los países del mundo. Como bono adicional, los nombres de los países se muestran en el idioma del usuario.

                  -

                  El «valor» para cada país es el código de país de dos letras.

                  -
                  -

                  Nota

                  -

                  La configuración regional del usuario se deduce usando Locale::getDefault().

                  -
                  -

                  A diferencia del tipo choice, no es necesario especificar una opción choices o choice_list como el tipo de campo utilizando automáticamente todos los países del mundo. Puedes especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo choice directamente.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered ascan be various tags (see Etiqueta select, casillas de verificación o botones de radio)
                  Inherited -options -
                  Parent typechoice
                  ClassSymfony\Component\Form\Extension\Core\Type\CountryType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo choice:

                  -
                  -

                  multiple

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el usuario podrá seleccionar varias opciones (en contraposición a elegir sólo una opción). Dependiendo del valor de la opción expanded, esto reproducirá una etiqueta de selección o casillas de verificación si es true y una etiqueta de selección o botones de radio si es false. El valor devuelto será un arreglo.

                  -
                  -
                  -

                  expanded

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los botones de radio o casillas de verificación se reproducirán (en función del valor de multiple). Si es false, se reproducirá un elemento de selección.

                  -
                  -
                  -

                  preferred_choices

                  -

                  tipo: array predeterminado: array()

                  -

                  Si se especifica esta opción, entonces un subconjunto de todas las opciones se trasladará a la parte superior del menú de selección. Lo siguiente debe mover la opción «Baz» a la parte superior, con una separación visual entre esta y el resto de las opciones:

                  -
                  $builder->add('foo_choices', 'choice', array(
-    'choices' => array('foo' => 'Foo', 'bar' => 'Bar', 'baz' => 'Baz'),
-    'preferred_choices' => array('baz'),
-));
-
                  -
                  -

                  Ten en cuenta que las opciones preferidas sólo son útiles cuando se reproducen como un elemento select (es decir, expanded es false). Las opciones preferidas y las opciones normales están separadas visualmente por un conjunto de líneas punteadas (es decir, -------------------). -Esto se puede personalizar cuando reproduzcas el campo:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.foo_choices, { 'separator': '=====' }) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['foo_choices'], array('separator' => '=====')) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  empty_value

                  -

                  tipo: string o Boolean

                  -

                  Esta opción determina si o no una opción empty especial (por ejemplo, «Elige una opción») aparecerá en la parte superior de un elemento gráfico de selección. Esta opción sólo se aplica si ambas opciones expanded y multiple se establecen en false.

                  -
                    -

                  • Añade un valor vacío con «Elige una opción», como el texto:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => 'Choose an option',
-));
-
                    -
                    -
                    • -

                  • Garantiza que ninguna opción con valor empty se muestre:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => false,
-));
-
                    -
                    -
                    • -
                  -

                  Si dejas sin establecer la opción empty_value, entonces automáticamente se añadirá una opción con espacio en blanco (sin texto) si y sólo si la opción required es false:

                  -
                  // añadirá una opción de espacio en blanco (sin texto)
-$builder->add('states', 'choice', array(
-    'required' => false,
-));
-
                  -
                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/csrf.html b/reference/forms/types/csrf.html deleted file mode 100644 index 47b1368..0000000 --- a/reference/forms/types/csrf.html +++ /dev/null @@ -1,182 +0,0 @@ - - - - - - - Tipo de campo csrf — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo csrf

                  -

                  El tipo csrf es un campo de entrada oculto que contiene un fragmento CSRF.

                  - ---- - - - - - - - - - - - - - - -
                  Dibujado comocampo input hidden
                  Opciones
                    -
                  • csrf_provider
                    • -
                  • intention
                    • -
                  • property_path
                    • -
                  -
                  Tipo del padrehidden
                  ClaseSymfony\Component\Form\Extension\Csrf\Type\CsrfType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  csrf_provider

                  -

                  tipo: Symfony\Component\Form\CsrfProvider\CsrfProviderInterface

                  -

                  El objeto CsrfProviderInterface que debe generar la ficha CSRF. -Si no se establece, el valor predeterminado es el proveedor predeterminado.

                  -
                  -
                  -

                  intención

                  -

                  tipo: string

                  -

                  Un opcional identificador único que se utiliza para generar la ficha CSRF.

                  -
                  -
                  -

                  property_path

                  -

                  tipo: cualquiera predeterminado: El valor del campo

                  -

                  Los campos, por omisión, muestran una propiedad valor del objeto de dominio formulario. Cuando se envía el formulario, el valor presentado se escribe de nuevo en el objeto.

                  -

                  Si deseas reemplazar la propiedad que un campo lee y escribe, puedes establecer la opción property_path. Su valor predeterminado es el nombre del campo.

                  -

                  Si quieres que el campo sea omitido al leer o escribir el objeto, puedes configurar la opción property_path a false, pero usar property_path para este propósito no es recomendable, lo debes hacer de la manera decrita a continuación:

                  -

                  -Nuevo en la versión 2.1: A partir de 2.1, la opción mapped se añadió para este propósito.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/date.html b/reference/forms/types/date.html deleted file mode 100644 index 8e2e863..0000000 --- a/reference/forms/types/date.html +++ /dev/null @@ -1,346 +0,0 @@ - - - - - - - Tipo de campo date — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo date

                  -

                  Un campo que permite al usuario modificar información de fecha a través de una variedad de diferentes elementos HTML.

                  -

                  Los datos subyacentes utilizados para este tipo de campo pueden ser un objeto DateTime, una cadena, una marca de tiempo o un arreglo. Siempre y cuando la opción input se configure correctamente, el campo se hará cargo de todos los detalles.

                  -

                  El campo se puede reproducir como un cuadro de texto, tres cuadros de texto (mes, día y año) o tres cuadros de selección (ve la opción widget).

                  - ---- - - - - - - - - - - - - - - - - - - - - -
                  Underlying Data Typecan be DateTime, string, timestamp, or array (see the input option)
                  Rendered assingle text box or three select fields
                  Options -
                  Inherited -options -
                  Parent typefield (if text), form otherwise
                  ClassSymfony\Component\Form\Extension\Core\Type\DateType
                  -
                  -

                  Uso básico

                  -

                  Este tipo de campo es altamente configurable, pero fácil de usar. Las opciones más importantes son input y widget.

                  -

                  Supongamos que tienes un campo publishedAt cuya fecha subyacente es un objeto DateTime. El siguiente código configura el tipo date para ese campo como tres campos de opciones diferentes:

                  -
                  $builder->add('publishedAt', 'date', array(
-    'input'  => 'datetime',
-    'widget' => 'choice',
-));
-
                  -
                  -

                  La opción input se debe cambiar para que coincida con el tipo de dato de la fecha subyacente. Por ejemplo, si los datos del campo publishedAt eran una marca de tiempo Unix, habría la necesidad de establecer input a timestamp:

                  -
                  $builder->add('publishedAt', 'date', array(
-    'input'  => 'timestamp',
-    'widget' => 'choice',
-));
-
                  -
                  -

                  El campo también es compatible con array y string como valores válidos de la opción input.

                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  widget

                  -

                  tipo: string predefinido: choice

                  -

                  La forma básica en que se debe reproducir este campo. Puede ser una de las siguientes:

                  -
                    -
                  • choice: pinta tres selectores. The order of the selects is defined -in the format option.
                    • -
                  • text: pinta tres campos de entrada de tipo text (para el mes, día y año).
                    • -
                  • single_text: renders a single input of type date (text in Symfony 2.0). User’s -input is validated based on the format option.
                    • -
                  -
                  -

                  Prudencia

                  -

                  If timestamp is used, DateType is limited to dates between -Fri, 13 Dec 1901 20:45:54 GMT and Tue, 19 Jan 2038 03:14:07 GMT on 32bit -systems. This is due to a limitation in PHP itself.

                  -
                  -
                  -
                  -

                  input

                  -

                  tipo: string predefinido: datetime

                  -

                  El formato del dato input —es decir, el formato de la fecha en que se almacena en el objeto subyacente. Los valores válidos son los siguientes:

                  -
                    -
                  • string (por ejemplo 2011-06-05)
                    • -
                  • datetime (un objeto DateTime)
                    • -
                  • array (por ejemplo array('year' => 2011, 'month' => 06, 'day' => 05))
                    • -
                  • timestamp (por ejemplo 1307232000)
                    • -
                  -

                  El valor devuelto por el formulario también se normaliza de nuevo a este formato.

                  -
                  -

                  Prudencia

                  -

                  If timestamp is used, DateType is limited to dates between -Fri, 13 Dec 1901 20:45:54 GMT and Tue, 19 Jan 2038 03:14:07 GMT on 32bit -systems. This is due to a limitation in PHP itself.

                  -
                  -
                  -
                  -

                  empty_value

                  -

                  tipo: string o array

                  -

                  Si la opción de elemento gráfico se ajusta a choice, entonces este campo se reproduce como una serie de cajas de selección. Puedes utilizar la opción empty_value para agregar una entrada «en blanco» en la parte superior de cada caja de selección:

                  -
                  $builder->add('dueDate', 'date', array(
-    'empty_value' => '',
-));
-
                  -
                  -

                  Alternativamente, puedes especificar una cadena que se mostrará en lugar del valor «en blanco»:

                  -
                  $builder->add('dueDate', 'date', array(
-    'empty_value' => array('year' => 'Year', 'month' => 'Month', 'day' => 'Day')
-));
-
                  -
                  -
                  -
                  -

                  years

                  -

                  tipo: array predeterminado: cinco años antes a cinco años después del año en curso

                  -

                  Lista de años disponibles para el tipo de campo year. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  months

                  -

                  tipo: array predeterminado: 1 a 12

                  -

                  Lista de los meses disponibles para el tipo de campo month. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  days

                  -

                  tipo: array predeterminado: 1 a 31

                  -

                  Lista de los días disponibles para el tipo de campo day. Esta opción sólo es relevante cuando la opción widget está establecida en choice:

                  -
                  'days' => range(1,31)
-
                  -
                  -
                  -
                  -

                  format

                  -

                  tipo: integer o string predefinido: IntlDateFormatter::MEDIUM

                  -

                  Opción pasada a la clase IntlDateFormatter, utilizada para transformar la entrada del usuario al formato adecuado. Esto es crítico cuando la opción widget se configura a single_text, y necesitas definir la forma en que el usuario debe introducir los datos. -De manera predeterminada, el formato se determina basándose en la configuración regional del usuario actual; significa que el formato esperado será diferente para distintos usuarios. La puedes redefinir pasando el formato como una cadena.

                  -

                  Para más información sobre formatos válidos, consulta la Sintaxis de formatos Date/Time. For -example, to render a single text box that expects the user to enter yyyy-MM-dd, -use the following options:

                  -
                  $builder->add('date_created', 'date', array(
-    'widget' => 'single_text',
-    'format' => 'yyyy-MM-dd',
-));
-
                  -
                  -
                  -
                  -

                  data_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria en que se almacenan los datos entrantes. Esta debe ser una de las zonas horarias compatibles con PHP

                  -
                  -
                  -

                  user_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria para mostrar los datos al usuario (y por lo tanto también los datos que el usuario envía). Esta debe ser una de las zonas horarias compatibles con PHP

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -

                  These options inherit from the date type:

                  -
                  -
                  -

                  virtual

                  -

                  tipo: boolean default: false

                  -

                  This option determines if the form will be mapped with data. This can be useful -if you need a form to structure the view. See Cómo usar la opción virtual en los campos de formulario.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/datetime.html b/reference/forms/types/datetime.html deleted file mode 100644 index 5274e4e..0000000 --- a/reference/forms/types/datetime.html +++ /dev/null @@ -1,311 +0,0 @@ - - - - - - - Tipo de campo datetime — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo datetime

                  -

                  Este tipo de campo permite al usuario modificar los datos que representan una fecha y hora específica (por ejemplo, 05/06/2011 12:15:30).

                  -

                  Se pueden reproducir como una entrada de texto o etiquetas de selección. El formato subyacente de los datos puede ser un objeto DateTime, una cadena, una marca de tiempo o un arreglo.

                  - ---- - - - - - - - - - - - - - - - - - - - - -
                  Underlying Data Typecan be DateTime, string, timestamp, or array (see the input option)
                  Rendered assingle text box or three select fields
                  Options -
                  Inherited -options -
                  Parent typeform
                  ClassSymfony\Component\Form\Extension\Core\Type\DateTimeType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  date_widget

                  -

                  tipo: string predefinido: choice

                  -

                  Define la opción widget para el tipo date

                  -
                  -
                  -

                  time_widget

                  -

                  tipo: string predefinido: choice

                  -

                  Define la opción widget para el tipo time

                  -
                  -
                  -

                  input

                  -

                  tipo: string predefinido: datetime

                  -

                  El formato del dato input —es decir, el formato de la fecha en que se almacena en el objeto subyacente. Los valores válidos son los siguientes:

                  -
                    -
                  • string (por ejemplo 2011-06-05 12:15:00)
                    • -
                  • datetime (un objeto DateTime)
                    • -
                  • array (por ejemplo array(2011, 06, 05, 12, 15, 0))
                    • -
                  • timestamp (por ejemplo 1307276100)
                    • -
                  -

                  El valor devuelto por el formulario también se normaliza de nuevo a este formato.

                  -
                  -
                  -

                  date_format

                  -

                  tipo: integer o string predefinido: IntlDateFormatter::MEDIUM

                  -

                  Define la opción format que se transmite al campo de fecha. -Consulta la opción de formato para el tipo date para más detalles.

                  -
                  -
                  -

                  hours

                  -

                  tipo: integer predeterminado: 0 a 23

                  -

                  Lista de las horas disponibles para el tipo de campo hours. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  minutes

                  -

                  tipo: integer predeterminado: 0 a 59

                  -

                  Lista de los minutos disponibles para el tipo de campo minutes. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  seconds

                  -

                  tipo: integer predeterminado: 0 a 59

                  -

                  Lista de los segundos disponibles para el tipo de campo segundos. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  years

                  -

                  tipo: array predeterminado: cinco años antes a cinco años después del año en curso

                  -

                  Lista de años disponibles para el tipo de campo year. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  months

                  -

                  tipo: array predeterminado: 1 a 12

                  -

                  Lista de los meses disponibles para el tipo de campo month. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  days

                  -

                  tipo: array predeterminado: 1 a 31

                  -

                  Lista de los días disponibles para el tipo de campo day. Esta opción sólo es relevante cuando la opción widget está establecida en choice:

                  -
                  'days' => range(1,31)
-
                  -
                  -
                  -
                  -

                  with_seconds

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si debe o no incluir los segundos en la entrada. Esto resultará en una entrada adicional para capturar los segundos.

                  -
                  -
                  -

                  data_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria en que se almacenan los datos entrantes. Esta debe ser una de las zonas horarias compatibles con PHP

                  -
                  -
                  -

                  user_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria para mostrar los datos al usuario (y por lo tanto también los datos que el usuario envía). Esta debe ser una de las zonas horarias compatibles con PHP

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -

                  These options inherit from the date type:

                  -
                  -
                  -

                  virtual

                  -

                  tipo: boolean default: false

                  -

                  This option determines if the form will be mapped with data. This can be useful -if you need a form to structure the view. See Cómo usar la opción virtual en los campos de formulario.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/email.html b/reference/forms/types/email.html deleted file mode 100644 index caed3d9..0000000 --- a/reference/forms/types/email.html +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - Tipo de campo email — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo email

                  -

                  El campo email es un campo de texto que se reproduce usando etiquetas HTML5 <input type="email" />.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered asinput email field (a text box)
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\EmailType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  max_length

                  -

                  tipo: integer

                  -

                  Esta opción se utiliza para añadir un atributo max_length, que algunos navegadores utilizan para limitar la cantidad de texto en un campo.

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  trim

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, el espacio en blanco de la cadena presentada será eliminado a través de la función trim() cuando se vinculan los datos. Esto garantiza que si un valor es presentado con espacios en blanco excedentes, estos serán removidos antes de fusionar de nuevo el valor con el objeto subyacente.

                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/entity.html b/reference/forms/types/entity.html deleted file mode 100644 index c4c3469..0000000 --- a/reference/forms/types/entity.html +++ /dev/null @@ -1,379 +0,0 @@ - - - - - - - Tipo de campo entity — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo entity

                  -

                  Un campo choice especial que está diseñado para cargar las opciones de una entidad Doctrine. Por ejemplo, si tiene una entidad Categoria, puedes utilizar este campo para mostrar un campo select todos o algunos de los objetos Categoria de la base de datos.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered ascan be various tags (see Etiqueta select, casillas de verificación o botones de radio)
                  Options -
                  Inherited -options -
                  Parent typechoice
                  ClassSymfony\Bridge\Doctrine\Form\Type\EntityType
                  -
                  -

                  Uso básico

                  -

                  El tipo entidad tiene una sola opción obligatoria: la entidad que debe aparecer dentro del campo de elección:

                  -
                  $builder->add('users', 'entity', array(
-    'class' => 'AcmeHelloBundle:User',
-    'property' => 'username',
-));
-
                  -
                  -

                  En este caso, todos los objetos Usuario serán cargados desde la base de datos y representados como etiquetas select, botones de radio o una serie de casillas de verificación (esto depende del valor multiple y expanded). -Si el objeto entidad no tiene un método __toString() la opción property es necesaria.

                  -
                  -

                  Usando una consulta personalizada para las Entidades

                  -

                  Si es necesario especificar una consulta personalizada a utilizar al recuperar las entidades (por ejemplo, sólo deseas devolver algunas entidades, o necesitas ordenarlas), utiliza la opción query_builder. La forma más fácil para utilizar la opción es la siguiente:

                  -
                  use Doctrine\ORM\EntityRepository;
-// ...
-
-$builder->add('users', 'entity', array(
-    'class' => 'AcmeHelloBundle:User',
-    'query_builder' => function(EntityRepository $er) {
-        return $er->createQueryBuilder('u')
-            ->orderBy('u.username', 'ASC');
-    },
-));
-
                  -
                  -
                  -
                  -
                  -

                  Etiqueta select, casillas de verificación o botones de radio

                  -

                  Este campo se puede reproducir como uno de varios campos HTML, dependiendo de las opciones expanded y multiple:

                  - ----- - - - - - - - - - - - - - - - - - - - - - - - - -
                  tipo elementoexpandidomúltiple
                  etiqueta de selecciónfalsefalse
                  etiqueta de selección (con atributo -multiple)falsetrue
                  botones de radiotruefalse
                  caja de verificación (checkboxes)truetrue
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  class

                  -

                  tipo: string required

                  -

                  La clase de tu entidad (por ejemplo, AcmeStoreBundle:Category). Este puede ser un nombre de clase completo (por ejemplo, Acme\StoreBundle\Entity\Category) o el nombre del alias corto (como te mostramos anteriormente).

                  -
                  -
                  -

                  property

                  -

                  tipo: string

                  -

                  Esta es la propiedad que se debe utilizar para visualizar las entidades como texto en el elemento HTML. Si la dejas en blanco, el objeto entidad será convertido en una cadena y por lo tanto debe tener un método __toString().

                  -
                  -
                  -

                  group_by

                  -

                  tipo: string

                  -

                  Esta es una propiedad ruta (por ejemplo, author.name) usada para organizar en grupos las opciones disponibles. Sólo funciona cuando se representa como una etiqueta de selección y lo hace añadiendo etiquetas optgroup en torno a las opciones. Las opciones que no devuelvan un valor para esta propiedad ruta se dibujan directamente debajo de la etiqueta de selección, sin un optgroup circundante.

                  -
                  -
                  -

                  query_builder

                  -

                  tipo: Doctrine\ORM\QueryBuilder o un Closure

                  -

                  Si lo especificas, se utiliza para consultar el subconjunto de opciones (y el orden) que se debe utilizar para el campo. El valor de esta opción puede ser un objeto QueryBuilder o un Cierre. Si utilizas un Cierre, este debe tener un sólo argumento, el cual es el EntityRepository de la entidad.

                  -
                  -
                  -

                  em

                  -

                  tipo: string predefinido: el gestor de la entidad

                  -

                  Si lo especificas, el gestor de la entidad especificada se utiliza para cargar las opciones en lugar de las predeterminadas del gestor de la entidad.

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo choice:

                  -
                  -

                  multiple

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el usuario podrá seleccionar varias opciones (en contraposición a elegir sólo una opción). Dependiendo del valor de la opción expanded, esto reproducirá una etiqueta de selección o casillas de verificación si es true y una etiqueta de selección o botones de radio si es false. El valor devuelto será un arreglo.

                  -
                  -

                  Nota

                  -

                  If you are working with a collection of Doctrine entities, it will be helpful -to read the documention for the Tipo de campo Collection -as well. In addition, there is a complete example in the cookbook article -Cómo integrar una colección de formularios.

                  -
                  -
                  -
                  -

                  expanded

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los botones de radio o casillas de verificación se reproducirán (en función del valor de multiple). Si es false, se reproducirá un elemento de selección.

                  -
                  -
                  -

                  preferred_choices

                  -

                  tipo: array predeterminado: array()

                  -

                  Si se especifica esta opción, entonces un subconjunto de todas las opciones se trasladará a la parte superior del menú de selección. Lo siguiente debe mover la opción «Baz» a la parte superior, con una separación visual entre esta y el resto de las opciones:

                  -
                  $builder->add('foo_choices', 'choice', array(
-    'choices' => array('foo' => 'Foo', 'bar' => 'Bar', 'baz' => 'Baz'),
-    'preferred_choices' => array('baz'),
-));
-
                  -
                  -

                  Ten en cuenta que las opciones preferidas sólo son útiles cuando se reproducen como un elemento select (es decir, expanded es false). Las opciones preferidas y las opciones normales están separadas visualmente por un conjunto de líneas punteadas (es decir, -------------------). -Esto se puede personalizar cuando reproduzcas el campo:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.foo_choices, { 'separator': '=====' }) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['foo_choices'], array('separator' => '=====')) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  empty_value

                  -

                  tipo: string o Boolean

                  -

                  Esta opción determina si o no una opción empty especial (por ejemplo, «Elige una opción») aparecerá en la parte superior de un elemento gráfico de selección. Esta opción sólo se aplica si ambas opciones expanded y multiple se establecen en false.

                  -
                    -

                  • Añade un valor vacío con «Elige una opción», como el texto:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => 'Choose an option',
-));
-
                    -
                    -
                    • -

                  • Garantiza que ninguna opción con valor empty se muestre:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => false,
-));
-
                    -
                    -
                    • -
                  -

                  Si dejas sin establecer la opción empty_value, entonces automáticamente se añadirá una opción con espacio en blanco (sin texto) si y sólo si la opción required es false:

                  -
                  // añadirá una opción de espacio en blanco (sin texto)
-$builder->add('states', 'choice', array(
-    'required' => false,
-));
-
                  -
                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/field.html b/reference/forms/types/field.html deleted file mode 100644 index d1feec2..0000000 --- a/reference/forms/types/field.html +++ /dev/null @@ -1,135 +0,0 @@ - - - - - - - El tipo abstracto field — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  El tipo abstracto field

                  -

                  A partir de Symfony 2.1 se desaconseja el uso del tipo field para formularios. -Por favor, en su lugar usa el Tipo field del formulario.

                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/file.html b/reference/forms/types/file.html deleted file mode 100644 index bd073cf..0000000 --- a/reference/forms/types/file.html +++ /dev/null @@ -1,249 +0,0 @@ - - - - - - - Tipo de campo file — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo file

                  -

                  El tipo file representa una entrada de archivo en tu formulario.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered asinput file field
                  Inherited -options -
                  Parent typeform
                  ClassSymfony\Component\Form\Extension\Core\Type\FileType
                  -
                  -

                  Uso básico

                  -

                  Digamos que tienes esta definición de formulario:

                  -
                  $builder->add('attachment', 'file');
-
                  -
                  -
                  -

                  Prudencia

                  -

                  No olvides añadir el atributo enctype en la etiqueta del formulario: <form -action="#" method="post" {{ form_enctype(form) }}>.

                  -
                  -

                  Cuando se envía el formulario, el campo de datos adjuntos (attchment) será una instancia de Symfony\Component\HttpFoundation\File\UploadedFile. Este lo puedes utilizar para mover el archivo adjunto a una ubicación permanente:

                  -
                  use Symfony\Component\HttpFoundation\File\UploadedFile;
-
-public function uploadAction()
-{
-    // ...
-
-    if ($form->isValid()) {
-        $someNewFilename = ...
-
-        $form['attachment']->getData()->move($dir, $someNewFilename);
-
-        // ...
-    }
-
-    // ...
-}
-
                  -
                  -

                  El método move() toma un directorio y un nombre de archivo como argumentos. -Puedes calcular el nombre de archivo en una de las siguientes formas:

                  -
                  // usa el nombre de archivo original
-$file->move($dir, $file->getClientOriginalName());
-
-// calcula un nombre aleatorio e intenta deducir la extensión (más seguro)
-$extension = $file->guessExtension();
-if (!$extension) {
-    // no se puede deducir la extensión
-    $extension = 'bin';
-}
-$file->move($dir, rand(1, 99999).'.'.$extension);
-
                  -
                  -

                  Usar el nombre original a través de getClientOriginalName() no es seguro, ya que el usuario final lo podría haber manipulado. Además, puede contener caracteres que no están permitidos en nombres de archivo. Antes de usar el nombre directamente, lo debes desinfectar.

                  -

                  Lee en el recetario el ejemplo de cómo manejar la carga de archivos adjuntos con una entidad Doctrine.

                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/form.html b/reference/forms/types/form.html deleted file mode 100644 index 351ba30..0000000 --- a/reference/forms/types/form.html +++ /dev/null @@ -1,216 +0,0 @@ - - - - - - - Tipo de campo Form — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo Form

                  -

                  Consulta Symfony\Component\Form\Extension\Core\Type\FormType.

                  -

                  El tipo form predefine un par de opciones que luego estarán disponibles en todos los campos.

                  -
                  -

                  data

                  -

                  tipo: mixed predeterminado: De manera predeterminada al campo del objeto subyacente (si existe)

                  -

                  Cuando creas un formulario, cada campo inicialmente muestra el valor de la propiedad correspondiente al objeto del dominio del formulario (si está ligado un objeto al formulario). Si deseas sustituir el valor inicial del formulario, o simplemente un campo individual, lo puedes configurar en la opción data:

                  -
                  $builder->add('token', 'hidden', array(
-    'data' => 'abcdef',
-));
-
                  -
                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  constraints

                  -

                  tipo: arreglo o Symfony\Component\Validator\Constraint predefinido: null

                  -

                  Te permite asociar una o más restricciones de validación a un campo específico. -Para más información, ve Añadiendo validación. -Esta opción se añadió en la clase Symfony\Component\Form\Extension\Validator\Type\FormTypeValidatorExtension de la extensión form.

                  -
                  -
                  -

                  cascade_validation

                  -

                  tipo: Booleano predeterminado: false

                  -

                  Pon esta opción a true para forzar la validación en tipos de formulario incorporando. -Por ejemplo, si tienes un ProductType con un CategoryType incorporando, poner cascade_validation a true en ProductType causará que el dato de CategoryType a también sea validado.

                  -

                  En vez de utilizar esta opción, también puedes utilizar la restricción Valid en tu modelo para forzar la validación en un objeto hijo almacenado en una propiedad.

                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  trim

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, el espacio en blanco de la cadena presentada será eliminado a través de la función trim() cuando se vinculan los datos. Esto garantiza que si un valor es presentado con espacios en blanco excedentes, estos serán removidos antes de fusionar de nuevo el valor con el objeto subyacente.

                  -
                  -
                  -

                  mapped

                  -

                  tipo: boolean

                  -

                  Si quieres que el campo sea omitido al leer o escribir el objeto, puedes configurar la opción mapped a false.

                  -
                  -
                  -

                  property_path

                  -

                  tipo: cualquiera predeterminado: El valor del campo

                  -

                  Los campos, por omisión, muestran una propiedad valor del objeto de dominio formulario. Cuando se envía el formulario, el valor presentado se escribe de nuevo en el objeto.

                  -

                  Si deseas reemplazar la propiedad que un campo lee y escribe, puedes establecer la opción property_path. Su valor predeterminado es el nombre del campo.

                  -

                  Si quieres que el campo sea omitido al leer o escribir el objeto, puedes configurar la opción property_path a false, pero usar property_path para este propósito no es recomendable, lo debes hacer de la manera decrita a continuación:

                  -

                  -Nuevo en la versión 2.1: A partir de 2.1, la opción mapped se añadió para este propósito.

                  -
                  -
                  -

                  attr

                  -

                  tipo: array predeterminado: Un arreglo vacío

                  -

                  Si deseas añadir atributos extra a la representación HTML del campo puedes usar la opción attr. Es un arreglo asociativo con el atributo HTML como clave. Esto puede ser útil cuando necesitas fijar una clase personalizada para algún elemento gráfico:

                  -
                  $builder->add('body', 'textarea', array(
-    'attr' => array('class' => 'tinymce'),
-));
-
                  -
                  -
                  -
                  -

                  translation_domain

                  -

                  tipo: string predefinido: messages —(mensajes)

                  -

                  Este es el dominio de traducción que se utilizará para cualquier etiqueta u opción que sea reproducida para este campo.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/hidden.html b/reference/forms/types/hidden.html deleted file mode 100644 index 520862a..0000000 --- a/reference/forms/types/hidden.html +++ /dev/null @@ -1,182 +0,0 @@ - - - - - - - Tipo de campo hidden — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo hidden

                  -

                  El tipo hidden representa un campo de entrada oculto.

                  - ---- - - - - - - - - - - - - - - -
                  Dibujado comocampo input hidden
                  Opciones -heredadas
                    -
                  • data
                    • -
                  • property_path
                    • -
                  -
                  Tipo del padrefield
                  ClaseSymfony\Component\Form\Extension\Core\Type\HiddenType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  data

                  -

                  tipo: mixed predeterminado: De manera predeterminada al campo del objeto subyacente (si existe)

                  -

                  Cuando creas un formulario, cada campo inicialmente muestra el valor de la propiedad correspondiente al objeto del dominio del formulario (si está ligado un objeto al formulario). Si deseas sustituir el valor inicial del formulario, o simplemente un campo individual, lo puedes configurar en la opción data:

                  -
                  $builder->add('token', 'hidden', array(
-    'data' => 'abcdef',
-));
-
                  -
                  -
                  -
                  -

                  property_path

                  -

                  tipo: cualquiera predeterminado: El valor del campo

                  -

                  Los campos, por omisión, muestran una propiedad valor del objeto de dominio formulario. Cuando se envía el formulario, el valor presentado se escribe de nuevo en el objeto.

                  -

                  Si deseas reemplazar la propiedad que un campo lee y escribe, puedes establecer la opción property_path. Su valor predeterminado es el nombre del campo.

                  -

                  Si quieres que el campo sea omitido al leer o escribir el objeto, puedes configurar la opción property_path a false, pero usar property_path para este propósito no es recomendable, lo debes hacer de la manera decrita a continuación:

                  -

                  -Nuevo en la versión 2.1: A partir de 2.1, la opción mapped se añadió para este propósito.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/integer.html b/reference/forms/types/integer.html deleted file mode 100644 index 98b90aa..0000000 --- a/reference/forms/types/integer.html +++ /dev/null @@ -1,251 +0,0 @@ - - - - - - - Tipo de campo integer — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo integer

                  -

                  Reproduce un campo de entrada para «número». Básicamente, se trata de un campo de texto que es bueno manejando datos enteros en un formulario. El campo de entrada number se parece a un cuadro de texto, salvo que —si el navegador del usuario es compatible con HTML5— tendrá algunas funciones de interfaz adicionales.

                  -

                  Este campo tiene diferentes opciones sobre cómo manejar los valores de entrada que no son enteros. Por omisión, todos los valores no enteros (por ejemplo 6.78) se redondearán hacia abajo (por ejemplo, 6).

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput text field
                  Options -
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\IntegerType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  rounding_mode

                  -

                  tipo: integer predeterminado: IntegerToLocalizedStringTransformer::ROUND_DOWN

                  -

                  Por omisión, si el usuario introduce un número no entero, se redondeará hacia abajo. Hay varios métodos de redondeo, y cada uno es una constante en la clase Symfony\Component\Form\Extension\Core\DataTransformer\IntegerToLocalizedStringTransformer:

                  -
                    -
                  • IntegerToLocalizedStringTransformer::ROUND_DOWN modo de redondeo para redondear hacia cero.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_FLOOR modo de redondeo para redondear hacia el infinito negativo.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_UP modo de redondeo para redondear alejándose del cero.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_CEILING modo de redondeo para redondear hacia el infinito positivo.
                    • -
                  -
                  -
                  -

                  grouping

                  -

                  tipo: integer predeterminado: false

                  -

                  Este valor se utiliza internamente como el valor de NumberFormatter::GROUPING_USED cuando se utiliza la clase PHP NumberFormatter. Su documentación no existe, pero parece que si se establece este a true, los números se agrupan con una coma o un punto (dependiendo de tu región): 12345.123 lo mostrará cómo 12,345.123.

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/language.html b/reference/forms/types/language.html deleted file mode 100644 index b041e7a..0000000 --- a/reference/forms/types/language.html +++ /dev/null @@ -1,276 +0,0 @@ - - - - - - - Tipo de campo language — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo language

                  -

                  El tipo lenguaje es un subconjunto de ChoiceType que permite al usuario seleccionar entre una larga lista de idiomas. Como bono adicional, los nombres de idioma se muestran en el idioma del usuario.

                  -

                  El «valor» para cada región es el identificador de idioma Unicode (por ejemplo, es o zh-Hant).

                  -
                  -

                  Nota

                  -

                  La configuración regional del usuario se deduce usando Locale::getDefault().

                  -
                  -

                  A diferencia del tipo choice, no es necesario especificar una opción choice o choice_list ya que el tipo de campo automáticamente utiliza una larga lista de idiomas. Puedes especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo choice directamente.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered ascan be various tags (see Etiqueta select, casillas de verificación o botones de radio)
                  Inherited -options -
                  Parent typechoice
                  ClassSymfony\Component\Form\Extension\Core\Type\LanguageType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo choice:

                  -
                  -

                  multiple

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el usuario podrá seleccionar varias opciones (en contraposición a elegir sólo una opción). Dependiendo del valor de la opción expanded, esto reproducirá una etiqueta de selección o casillas de verificación si es true y una etiqueta de selección o botones de radio si es false. El valor devuelto será un arreglo.

                  -
                  -
                  -

                  expanded

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los botones de radio o casillas de verificación se reproducirán (en función del valor de multiple). Si es false, se reproducirá un elemento de selección.

                  -
                  -
                  -

                  preferred_choices

                  -

                  tipo: array predeterminado: array()

                  -

                  Si se especifica esta opción, entonces un subconjunto de todas las opciones se trasladará a la parte superior del menú de selección. Lo siguiente debe mover la opción «Baz» a la parte superior, con una separación visual entre esta y el resto de las opciones:

                  -
                  $builder->add('foo_choices', 'choice', array(
-    'choices' => array('foo' => 'Foo', 'bar' => 'Bar', 'baz' => 'Baz'),
-    'preferred_choices' => array('baz'),
-));
-
                  -
                  -

                  Ten en cuenta que las opciones preferidas sólo son útiles cuando se reproducen como un elemento select (es decir, expanded es false). Las opciones preferidas y las opciones normales están separadas visualmente por un conjunto de líneas punteadas (es decir, -------------------). -Esto se puede personalizar cuando reproduzcas el campo:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.foo_choices, { 'separator': '=====' }) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['foo_choices'], array('separator' => '=====')) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  empty_value

                  -

                  tipo: string o Boolean

                  -

                  Esta opción determina si o no una opción empty especial (por ejemplo, «Elige una opción») aparecerá en la parte superior de un elemento gráfico de selección. Esta opción sólo se aplica si ambas opciones expanded y multiple se establecen en false.

                  -
                    -

                  • Añade un valor vacío con «Elige una opción», como el texto:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => 'Choose an option',
-));
-
                    -
                    -
                    • -

                  • Garantiza que ninguna opción con valor empty se muestre:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => false,
-));
-
                    -
                    -
                    • -
                  -

                  Si dejas sin establecer la opción empty_value, entonces automáticamente se añadirá una opción con espacio en blanco (sin texto) si y sólo si la opción required es false:

                  -
                  // añadirá una opción de espacio en blanco (sin texto)
-$builder->add('states', 'choice', array(
-    'required' => false,
-));
-
                  -
                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/locale.html b/reference/forms/types/locale.html deleted file mode 100644 index 65c63d4..0000000 --- a/reference/forms/types/locale.html +++ /dev/null @@ -1,276 +0,0 @@ - - - - - - - Tipo de campo locale — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo locale

                  -

                  El tipo locale es un subconjunto de ChoiceType que permite al usuario seleccionar entre una larga lista de regiones (idioma + país). Como bono adicional, los nombres regionales se muestran en el idioma del usuario.

                  -

                  El «valor» de cada región es o bien el del código de idioma ISO639-1 de dos letras (por ejemplo, «es»), o el código de idioma seguido de un guión bajo (_), luego el código de país ISO3166 (por ejemplo, «fr_FR» para Francés/Francia).

                  -
                  -

                  Nota

                  -

                  La configuración regional del usuario se deduce usando Locale::getDefault().

                  -
                  -

                  A diferencia del tipo choice, no es necesario especificar una opción choices o choice_list, ya que el tipo de campo utiliza automáticamente una larga lista de regiones. Puedes especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo choice directamente.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered ascan be various tags (see Etiqueta select, casillas de verificación o botones de radio)
                  Inherited -options -
                  Parent typechoice
                  ClassSymfony\Component\Form\Extension\Core\Type\LanguageType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo choice:

                  -
                  -

                  multiple

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el usuario podrá seleccionar varias opciones (en contraposición a elegir sólo una opción). Dependiendo del valor de la opción expanded, esto reproducirá una etiqueta de selección o casillas de verificación si es true y una etiqueta de selección o botones de radio si es false. El valor devuelto será un arreglo.

                  -
                  -
                  -

                  expanded

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los botones de radio o casillas de verificación se reproducirán (en función del valor de multiple). Si es false, se reproducirá un elemento de selección.

                  -
                  -
                  -

                  preferred_choices

                  -

                  tipo: array predeterminado: array()

                  -

                  Si se especifica esta opción, entonces un subconjunto de todas las opciones se trasladará a la parte superior del menú de selección. Lo siguiente debe mover la opción «Baz» a la parte superior, con una separación visual entre esta y el resto de las opciones:

                  -
                  $builder->add('foo_choices', 'choice', array(
-    'choices' => array('foo' => 'Foo', 'bar' => 'Bar', 'baz' => 'Baz'),
-    'preferred_choices' => array('baz'),
-));
-
                  -
                  -

                  Ten en cuenta que las opciones preferidas sólo son útiles cuando se reproducen como un elemento select (es decir, expanded es false). Las opciones preferidas y las opciones normales están separadas visualmente por un conjunto de líneas punteadas (es decir, -------------------). -Esto se puede personalizar cuando reproduzcas el campo:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.foo_choices, { 'separator': '=====' }) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['foo_choices'], array('separator' => '=====')) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  empty_value

                  -

                  tipo: string o Boolean

                  -

                  Esta opción determina si o no una opción empty especial (por ejemplo, «Elige una opción») aparecerá en la parte superior de un elemento gráfico de selección. Esta opción sólo se aplica si ambas opciones expanded y multiple se establecen en false.

                  -
                    -

                  • Añade un valor vacío con «Elige una opción», como el texto:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => 'Choose an option',
-));
-
                    -
                    -
                    • -

                  • Garantiza que ninguna opción con valor empty se muestre:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => false,
-));
-
                    -
                    -
                    • -
                  -

                  Si dejas sin establecer la opción empty_value, entonces automáticamente se añadirá una opción con espacio en blanco (sin texto) si y sólo si la opción required es false:

                  -
                  // añadirá una opción de espacio en blanco (sin texto)
-$builder->add('states', 'choice', array(
-    'required' => false,
-));
-
                  -
                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/money.html b/reference/forms/types/money.html deleted file mode 100644 index def71fb..0000000 --- a/reference/forms/types/money.html +++ /dev/null @@ -1,266 +0,0 @@ - - - - - - - Tipo de campo money — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo money

                  -

                  Reproduce un campo de entrada de texto especializado en el manejo de la presentación de datos tipo «moneda».

                  -

                  Este tipo de campo te permite especificar una moneda, cuyo símbolo se representa al lado del campo de texto. También hay otras opciones para personalizar la forma de la entrada y salida de los datos manipulados.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput text field
                  Options -
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\MoneyType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  currency

                  -

                  tipo: string predefinido: EUR

                  -

                  Especifica la moneda en la cual se especifica el dinero. Esta determina el símbolo de moneda que se debe mostrar en el cuadro de texto. Dependiendo de la moneda — el símbolo de moneda se puede mostrar antes o después del campo de entrada de texto.

                  -

                  This can be any 3 letter ISO 4217 code. You can also set this to false to -hide the currency symbol.

                  -
                  -
                  -

                  divisor

                  -

                  tipo: integer predeterminado: 1

                  -

                  Si, por alguna razón, tienes que dividir tu valor inicial por un número antes de reproducirlo para el usuario, puedes utilizar la opción divisor. -Por ejemplo:

                  -
                  $builder->add('price', 'money', array(
-    'divisor' => 100,
-));
-
                  -
                  -

                  En este caso, si el campo price está establecido en 9900, entonces en realidad al usuario se le presentará el valor 99. Cuando el usuario envía el valor 99, este se multiplicará por 100 y finalmente se devolverá 9900 a tu objeto.

                  -
                  -
                  -

                  precision

                  -

                  tipo: integer predeterminado: 2

                  -

                  Por alguna razón, si necesitas alguna precisión que no sean dos decimales, puedes modificar este valor. Probablemente no necesitarás hacer esto a menos que, por ejemplo, desees redondear al dólar más cercano (ajustando la precisión a 0).

                  -
                  -
                  -

                  grouping

                  -

                  tipo: integer predeterminado: false

                  -

                  Este valor se utiliza internamente como el valor de NumberFormatter::GROUPING_USED cuando se utiliza la clase PHP NumberFormatter. Su documentación no existe, pero parece que si se establece este a true, los números se agrupan con una coma o un punto (dependiendo de tu región): 12345.123 lo mostrará cómo 12,345.123.

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/number.html b/reference/forms/types/number.html deleted file mode 100644 index c30763a..0000000 --- a/reference/forms/types/number.html +++ /dev/null @@ -1,259 +0,0 @@ - - - - - - - Tipo de campo number — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo number

                  -

                  Reproduce un campo de entrada de texto y se especializa en el manejo de entradas numéricas. Este tipo ofrece diferentes opciones para precisión, redondeo y agrupamiento que desees utilizar para tu número.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput text field
                  Options -
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\NumberType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  precision

                  -

                  tipo: integer predeterminado: Específico a la región (usualmente alrededor de 3)

                  -

                  Este especifica cuantos decimales se permitirán para redondear el campo al valor presentado (a través de rounding_mode). Por ejemplo, si precision se establece en 2, un valor presentado de 20.123 se redondeará a, por ejemplo, 20.12 (dependiendo de tu rounding_mode).

                  -
                  -
                  -

                  rounding_mode

                  -

                  tipo: integer predeterminado: IntegerToLocalizedStringTransformer::ROUND_HALFUP

                  -

                  Si es necesario redondear un número presentado (basándonos en la opción precision), tienes varias opciones configurables para el redondeo. Cada opción es una constante en Symfony\Component\Form\Extension\Core\DataTransformer\IntegerToLocalizedStringTransformer:

                  -
                    -
                  • IntegerToLocalizedStringTransformer::ROUND_DOWN modo de redondeo para redondear hacia cero.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_FLOOR modo de redondeo para redondear hacia el infinito negativo.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_UP modo de redondeo para redondear alejándose del cero.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_CEILING modo de redondeo para redondear hacia el infinito positivo.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_HALFDOWN El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso se redondea hacia abajo.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_HALFEVEN El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso, se redondea hacia el vecino par.
                    • -
                  • IntegerToLocalizedStringTransformer::ROUND_HALFUP El modo de redondeo para redondear hacia «el vecino más cercano» a menos que ambos vecinos sean equidistantes, en cuyo caso se redondea hacia arriba.
                    • -
                  -
                  -
                  -

                  grouping

                  -

                  tipo: integer predeterminado: false

                  -

                  Este valor se utiliza internamente como el valor de NumberFormatter::GROUPING_USED cuando se utiliza la clase PHP NumberFormatter. Su documentación no existe, pero parece que si se establece este a true, los números se agrupan con una coma o un punto (dependiendo de tu región): 12345.123 lo mostrará cómo 12,345.123.

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/password.html b/reference/forms/types/password.html deleted file mode 100644 index be7e0d8..0000000 --- a/reference/forms/types/password.html +++ /dev/null @@ -1,229 +0,0 @@ - - - - - - - Tipo de campo password — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo password

                  -

                  El tipo de campo password reproduce un campo de texto para entrada de contraseñas.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput password field
                  Options -
                  Inherited -options -
                  Parent typetext
                  ClassSymfony\Component\Form\Extension\Core\Type\PasswordType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  always_empty

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, el campo siempre se reproduce en blanco, incluso si el campo correspondiente tiene un valor. Cuando se establece en false, el campo de la contraseña se reproduce con el atributo value fijado a su valor real.

                  -

                  En pocas palabras, si por alguna razón deseas reproducir tu campo de contraseña con el valor de contraseña ingresado anteriormente en el cuadro, ponlo a false.

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -
                  -

                  max_length

                  -

                  tipo: integer

                  -

                  Esta opción se utiliza para añadir un atributo max_length, que algunos navegadores utilizan para limitar la cantidad de texto en un campo.

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  trim

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, el espacio en blanco de la cadena presentada será eliminado a través de la función trim() cuando se vinculan los datos. Esto garantiza que si un valor es presentado con espacios en blanco excedentes, estos serán removidos antes de fusionar de nuevo el valor con el objeto subyacente.

                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/percent.html b/reference/forms/types/percent.html deleted file mode 100644 index 04fa0b5..0000000 --- a/reference/forms/types/percent.html +++ /dev/null @@ -1,254 +0,0 @@ - - - - - - - Tipo de campo percent — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo percent

                  -

                  El tipo de campo percent reproduce un campo de entrada de texto, especializado en el manejo de datos porcentuales. Si los datos porcentuales se almacenan como un decimal (por ejemplo, 0.95), puedes utilizar este campo fuera de la caja. Si almacenas tus datos como un número (por ejemplo, 95), debes establecer la opción type a integer.

                  -

                  Este campo añade un signo de porcentaje «%» después del cuadro de entrada.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput text field
                  Options -
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\PercentType
                  -
                  -

                  Opciones

                  -
                  -

                  type

                  -

                  tipo: string predefinido: fractional

                  -

                  Esto controla la forma en que se almacenan tus datos en el objeto. Por ejemplo, en el objeto puedes almacenar un porcentaje correspondiente al «55%» como 0.55 o 55. Los dos «tipos» manejan estos dos casos:

                  -
                    -
                  • fractional -Si los datos se almacenan como un decimal (por ejemplo, 0.55), usa este tipo. -Los datos se multiplicarán por 100 antes de mostrarlos al usuario (por ejemplo, 55). Los datos presentados se dividirán por 100 al presentar el formulario para almacenar el valor decimal (0.55);
                    • -
                  • integer -Si almacenas tus datos como un entero (por ejemplo, 55), entonces, utiliza esta opción. -El valor crudo (55) se muestra al usuario y se almacena en tu objeto. -Ten en cuenta que esto sólo funciona para valores enteros.
                    • -
                  -
                  -
                  -

                  precision

                  -

                  tipo: integer predeterminado: 0

                  -

                  De manera predeterminada, los números ingresados se redondean. Para tomar en cuenta más cifras decimales, utiliza esta opción.

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/radio.html b/reference/forms/types/radio.html deleted file mode 100644 index eaf9e13..0000000 --- a/reference/forms/types/radio.html +++ /dev/null @@ -1,218 +0,0 @@ - - - - - - - Tipo de campo radio — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo radio

                  -

                  Crea un solo botón de radio. Si el botón de radio es seleccionado, el campo se establecerá al valor especificado. Los botones de radio no se pueden deseleccionar —el valor cambia únicamente cuándo seleccionas otro botón de radio con el mismo nombre.

                  -

                  El tipo radio no suele usarse directamente. Comúnmente se utiliza internamente por otros tipos, tales como choice. -Si quieres tener un campo booleano, utiliza una casilla de verificación.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput radio field
                  Options -
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\RadioType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  value

                  -

                  tipo: mixed predeterminado: 1

                  -

                  El valor utilizado realmente como valor para el botón de radio. Esto no afecta al valor establecido en tu objeto.

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/repeated.html b/reference/forms/types/repeated.html deleted file mode 100644 index 27afc91..0000000 --- a/reference/forms/types/repeated.html +++ /dev/null @@ -1,302 +0,0 @@ - - - - - - - Tipo de campo repeated — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo repeated

                  -

                  Este es un campo «grupo» especial, el cual crea dos campos idénticos, cuyos valores deben coincidir (o lanza un error de validación). Se utiliza comúnmente cuando necesitas que el usuario repita su contraseña o correo electrónico para verificar su exactitud.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Dibujado comocampo input text por omisión, pero ve la opción type
                  Opciones -
                  Opciones -heredadas -
                  Tipo del padrefield
                  ClaseSymfony\Component\Form\Extension\Core\Type\RepeatedType
                  -
                  -

                  Ejemplo de uso

                  -
                  $builder->add('password', 'repeated', array(
-    'type' => 'password',
-    'invalid_message' => 'The password fields must match.',
-    'options' => array('attr' => array('class' => 'password-field')),
-    'required' => true,
-    'first_options'  => array('label' => 'Password'),
-    'second_options' => array('label' => 'Repeat Password'),
-));
-
                  -
                  -

                  Al presentar satisfactoriamente un formulario, el valor ingresado en ambos campos «contraseña» se convierte en los datos de la clave password. En otras palabras, a pesar de que ambos campos efectivamente son reproducidos, sólo el dato final del formulario es el único valor que necesitas (generalmente una cadena).

                  -

                  La opción más importante es type, la cual puede ser cualquier tipo de campo y determina el tipo real de los dos campos subyacentes. La opción options se pasa a cada uno de los campos individuales, lo cual significa —en este ejemplo— que en este arreglo puedes pasar cualquier opción compatible con el tipo password.

                  -
                  -

                  Rendering

                  -

                  The repeated field type is actually two underlying fields, which you can -render all at once, or individually. To render all at once, use something -like:

                  -
                  -
                    -
                  • Twig
                    {{ form_row(form.password) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->row($form['password']) ?>
-
                    -
                    -
                    • -
                  -
                  -

                  To render each field individually, use something like this:

                  -
                  -
                    -
                  • Twig
                    {{ form_row(form.password.first) }}
-{{ form_row(form.password.second) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->row($form['password']['first']) ?>
-<?php echo $view['form']->row($form['password']['second']) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -

                  Nota

                  -

                  The sub-field names are first and second by default, but can -be controlled via the first_name and second_name options.

                  -
                  -
                  -
                  -

                  Validando

                  -

                  Una de las características clave del campo repeated es la validación interna (sin necesidad de hacer nada para configurar esto) el cual obliga a que los dos campos tengan un valor coincidente. Si los dos campos no coinciden, se mostrará un error al usuario.

                  -

                  El invalid_message se utiliza para personalizar el error que se mostrará cuando los dos campos no coinciden entre sí.

                  -
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  type

                  -

                  tipo: string predefinido: text

                  -

                  Los dos campos subyacentes serán de este tipo de campo. Por ejemplo, pasando un tipo de password reproducirá dos campos de contraseña.

                  -
                  -
                  -

                  options

                  -

                  tipo: array predeterminado: array()

                  -

                  Este arreglo de opciones se pasará a cada uno de los dos campos subyacentes. En otras palabras, estas son las opciones que personalizan los tipos de campo individualmente. -Por ejemplo, si la opción type se establece en password, este arreglo puede contener las opciones always_empty o required — ambas opciones son compatibles con el tipo de campo password.

                  -
                  -
                  -

                  first_options

                  -

                  tipo: array predeterminado: array()

                  -

                  -Nuevo en la versión 2.1: La opción first_options es nueva en Symfony 2.1.

                  -

                  Las opciones adicionales (se fusionarán en opciones arriba) estas sólo se deben suministrar para el primer campo. Estas son útiles especialmente para personalizar la etiqueta:

                  -
                  $builder->add('password', 'repeated', array(
-    'first_options'  => array('label' => 'Password'),
-    'second_options' => array('label' => 'Repeat Password'),
-));
-
                  -
                  -
                  -
                  -

                  second_options

                  -

                  tipo: array predeterminado: array()

                  -

                  -Nuevo en la versión 2.1: La opción second_options es nueva en Symfony 2.1.

                  -

                  Las opciones adicionales (se fusionarán en opciones arriba) estas sólo se deben suministrar para el segundo campo. Estas son útiles especialmente para personalizar la etiqueta (ve las first_options).

                  -
                  -
                  -

                  first_name

                  -

                  tipo: string predefinido: first

                  -

                  Este es el nombre real del campo que se utilizará para el primer campo. Esto sobre todo no tiene sentido, sin embargo, puesto que los datos reales especificados en ambos campos disponibles bajo la clave asignada al campo repeated en sí mismo (por ejemplo, password). Sin embargo, si no especificas una etiqueta, se utiliza el nombre de este campo para «deducir» la etiqueta por ti.

                  -
                  -
                  -

                  second_name

                  -

                  tipo: string predefinido: second

                  -

                  Al igual que first_name, pero para el segundo campo.

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/search.html b/reference/forms/types/search.html deleted file mode 100644 index b04ff84..0000000 --- a/reference/forms/types/search.html +++ /dev/null @@ -1,215 +0,0 @@ - - - - - - - Tipo de campo search — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - - - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/text.html b/reference/forms/types/text.html deleted file mode 100644 index 388bc7f..0000000 --- a/reference/forms/types/text.html +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - Tipo de campo text — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo text

                  -

                  El campo de texto reproduce el campo de entrada de texto más básico.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered asinput text field
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\TextType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  max_length

                  -

                  tipo: integer

                  -

                  Esta opción se utiliza para añadir un atributo max_length, que algunos navegadores utilizan para limitar la cantidad de texto en un campo.

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  trim

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, el espacio en blanco de la cadena presentada será eliminado a través de la función trim() cuando se vinculan los datos. Esto garantiza que si un valor es presentado con espacios en blanco excedentes, estos serán removidos antes de fusionar de nuevo el valor con el objeto subyacente.

                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/textarea.html b/reference/forms/types/textarea.html deleted file mode 100644 index c35b608..0000000 --- a/reference/forms/types/textarea.html +++ /dev/null @@ -1,214 +0,0 @@ - - - - - - - Tipo de campo textarea — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo textarea

                  -

                  Reproduce un elemento textarea HTML.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered astextarea tag
                  Inherited -options -
                  Parent typefield
                  ClassSymfony\Component\Form\Extension\Core\Type\TextareaType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  max_length

                  -

                  tipo: integer

                  -

                  Esta opción se utiliza para añadir un atributo max_length, que algunos navegadores utilizan para limitar la cantidad de texto en un campo.

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  trim

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, el espacio en blanco de la cadena presentada será eliminado a través de la función trim() cuando se vinculan los datos. Esto garantiza que si un valor es presentado con espacios en blanco excedentes, estos serán removidos antes de fusionar de nuevo el valor con el objeto subyacente.

                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/time.html b/reference/forms/types/time.html deleted file mode 100644 index 33b8db0..0000000 --- a/reference/forms/types/time.html +++ /dev/null @@ -1,301 +0,0 @@ - - - - - - - Tipo de campo time — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo time

                  -

                  Un campo para capturar entradas horarias.

                  -

                  Este se puede reproducir como un campo de texto, una serie de campos de texto (por ejemplo, horas, minutos, segundos) o una serie de campos de selección. Los datos subyacentes se pueden almacenar como un objeto DateTime, una cadena, una marca de tiempo (timestamp) o un arreglo.

                  - ---- - - - - - - - - - - - - - - - - - - - - -
                  Underlying Data Typecan be DateTime, string, timestamp, or array (see the input option)
                  Rendered ascan be various tags (see below)
                  Options -
                  Inherited -options -
                  Parent typeform
                  ClassSymfony\Component\Form\Extension\Core\Type\TimeType
                  -
                  -

                  Uso básico

                  -

                  Este tipo de campo es altamente configurable, pero fácil de usar. Las opciones más importantes son input y widget.

                  -

                  Supongamos que tienes un campo startTime cuyo dato de hora subyacente es un objeto DateTime. Lo siguiente configura el tipo time para ese campo como tres campos de opciones diferentes:

                  -
                  $builder->add('startTime', 'time', array(
-    'input'  => 'datetime',
-    'widget' => 'choice',
-));
-
                  -
                  -

                  La opción input se debe cambiar para que coincida con el tipo de dato de la fecha subyacente. Por ejemplo, si los datos del campo startTime fueran una marca de tiempo Unix, habría necesidad de establecer la entrada a timestamp:

                  -
                  $builder->add('startTime', 'time', array(
-    'input'  => 'timestamp',
-    'widget' => 'choice',
-));
-
                  -
                  -

                  El campo también es compatible con array y string como valores válidos de la opción input.

                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  widget

                  -

                  tipo: string predefinido: choice

                  -

                  La forma básica en que se debe reproducir este campo. Puede ser una de las siguientes:

                  -
                    -
                  • choice: pinta dos (o tres si with_seconds es true) cuadros de selección.
                    • -
                  • text: pinta dos o tres cuadros de texto (horas, minutos, segundos).
                    • -
                  • single_text: pinta un sólo campo de entrada de tipo text. La entrada del usuario se validará contra la forma hh:mm (o hh:mm:ss si se utilizan segundos).
                    • -
                  -
                  -
                  -

                  input

                  -

                  tipo: string predefinido: datetime

                  -

                  El formato del dato input —es decir, el formato de la fecha en que se almacena en el objeto subyacente. Los valores válidos son los siguientes:

                  -
                    -
                  • string (por ejemplo 12:17:26)
                    • -
                  • datetime (un objeto DateTime)
                    • -
                  • array (por ejemplo array('hour' => 12, 'minute' => 17, 'second' => 26))
                    • -
                  • timestamp (por ejemplo 1307232000)
                    • -
                  -

                  El valor devuelto por el formulario también se normaliza de nuevo a este formato.

                  -
                  -
                  -

                  with_seconds

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si debe o no incluir los segundos en la entrada. Esto resultará en una entrada adicional para capturar los segundos.

                  -
                  -
                  -

                  hours

                  -

                  tipo: integer predeterminado: 0 a 23

                  -

                  Lista de las horas disponibles para el tipo de campo hours. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  minutes

                  -

                  tipo: integer predeterminado: 0 a 59

                  -

                  Lista de los minutos disponibles para el tipo de campo minutes. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  seconds

                  -

                  tipo: integer predeterminado: 0 a 59

                  -

                  Lista de los segundos disponibles para el tipo de campo segundos. Esta opción sólo es relevante cuando la opción widget está establecida en choice.

                  -
                  -
                  -

                  data_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria en que se almacenan los datos entrantes. Esta debe ser una de las zonas horarias compatibles con PHP

                  -
                  -
                  -

                  user_timezone

                  -

                  tipo: string predefinido: la zona horaria del sistema

                  -

                  La zona horaria para mostrar los datos al usuario (y por lo tanto también los datos que el usuario envía). Esta debe ser una de las zonas horarias compatibles con PHP

                  -
                  -
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -

                  invalid_message

                  -

                  tipo: string predefinido: This value is not valid (Este valor no es válido)

                  -

                  Este es el mensaje para el error de validación utilizado cuando se determina que los datos ingresados en este campo no tienen sentido (es decir, falla la validación).

                  -

                  Esto puede ocurrir, por ejemplo, si el usuario introduce una cadena sin sentido en el campo time que no se puede convertir -a una hora real o si el usuario introduce una cadena (por ejemplo, manzana) en un campo de número.

                  -

                  La validación (con la lógica del negocio) normal (por ejemplo, al establecer una longitud mínima en un campo) la debes establecer usando mensajes de validación con tus reglas de validación (referencia).

                  -
                  -
                  -

                  invalid_message_parameters

                  -

                  tipo: array predeterminado: array()

                  -

                  Al establecer la opción invalid_message, posiblemente sea necesario que incluyas algunas variables en la cadena. Esto se puede lograr agregando marcadores de posición y variables en esa opción:

                  -
                  $builder->add('some_field', 'some_type', array(
-    // ...
-    'invalid_message'            => 'You entered an invalid value - it should include %num% letters',
-    'invalid_message_parameters' => array('%num%' => 6),
-));
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -

                  These options inherit from the date type:

                  -
                  -
                  -

                  virtual

                  -

                  tipo: boolean default: false

                  -

                  This option determines if the form will be mapped with data. This can be useful -if you need a form to structure the view. See Cómo usar la opción virtual en los campos de formulario.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/timezone.html b/reference/forms/types/timezone.html deleted file mode 100644 index 449c64c..0000000 --- a/reference/forms/types/timezone.html +++ /dev/null @@ -1,272 +0,0 @@ - - - - - - - Tipo de campo timezone — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo timezone

                  -

                  El tipo timezone es un subconjunto de ChoiceType que permite al usuario seleccionar entre todas las posibles zonas horarias.

                  -

                  El «valor» para cada zona horaria es el nombre completo de la zona horaria, por ejemplo América/Chicago o Europa/Estambul.

                  -

                  A diferencia del tipo choice, no es necesario especificar una opción choices o choice_list, ya que el tipo de campo utiliza automáticamente una larga lista de regiones. Puedes especificar cualquiera de estas opciones manualmente, pero entonces sólo debes utilizar el tipo choice directamente.

                  - ---- - - - - - - - - - - - - - - -
                  Rendered ascan be various tags (see Etiqueta select, casillas de verificación o botones de radio)
                  Inherited -options -
                  Parent typechoice
                  ClassSymfony\Component\Form\Extension\Core\Type\TimezoneType
                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo choice:

                  -
                  -

                  multiple

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, el usuario podrá seleccionar varias opciones (en contraposición a elegir sólo una opción). Dependiendo del valor de la opción expanded, esto reproducirá una etiqueta de selección o casillas de verificación si es true y una etiqueta de selección o botones de radio si es false. El valor devuelto será un arreglo.

                  -
                  -
                  -

                  expanded

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los botones de radio o casillas de verificación se reproducirán (en función del valor de multiple). Si es false, se reproducirá un elemento de selección.

                  -
                  -
                  -

                  preferred_choices

                  -

                  tipo: array predeterminado: array()

                  -

                  Si se especifica esta opción, entonces un subconjunto de todas las opciones se trasladará a la parte superior del menú de selección. Lo siguiente debe mover la opción «Baz» a la parte superior, con una separación visual entre esta y el resto de las opciones:

                  -
                  $builder->add('foo_choices', 'choice', array(
-    'choices' => array('foo' => 'Foo', 'bar' => 'Bar', 'baz' => 'Baz'),
-    'preferred_choices' => array('baz'),
-));
-
                  -
                  -

                  Ten en cuenta que las opciones preferidas sólo son útiles cuando se reproducen como un elemento select (es decir, expanded es false). Las opciones preferidas y las opciones normales están separadas visualmente por un conjunto de líneas punteadas (es decir, -------------------). -Esto se puede personalizar cuando reproduzcas el campo:

                  -
                  -
                    -
                  • Twig
                    {{ form_widget(form.foo_choices, { 'separator': '=====' }) }}
-
                    -
                    -
                    • -
                  • PHP
                    <?php echo $view['form']->widget($form['foo_choices'], array('separator' => '=====')) ?>
-
                    -
                    -
                    • -
                  -
                  -
                  -
                  -

                  empty_value

                  -

                  tipo: string o Boolean

                  -

                  Esta opción determina si o no una opción empty especial (por ejemplo, «Elige una opción») aparecerá en la parte superior de un elemento gráfico de selección. Esta opción sólo se aplica si ambas opciones expanded y multiple se establecen en false.

                  -
                    -

                  • Añade un valor vacío con «Elige una opción», como el texto:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => 'Choose an option',
-));
-
                    -
                    -
                    • -

                  • Garantiza que ninguna opción con valor empty se muestre:

                    -
                    $builder->add('states', 'choice', array(
-    'empty_value' => false,
-));
-
                    -
                    -
                    • -
                  -

                  Si dejas sin establecer la opción empty_value, entonces automáticamente se añadirá una opción con espacio en blanco (sin texto) si y sólo si la opción required es false:

                  -
                  // añadirá una opción de espacio en blanco (sin texto)
-$builder->add('states', 'choice', array(
-    'required' => false,
-));
-
                  -
                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/forms/types/url.html b/reference/forms/types/url.html deleted file mode 100644 index b1ce22c..0000000 --- a/reference/forms/types/url.html +++ /dev/null @@ -1,228 +0,0 @@ - - - - - - - Tipo de campo url — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Tipo de campo url

                  -

                  El campo url es un campo de texto que prefija el valor presentado con un determinado protocolo (por ejemplo, http://) si el valor presentado no tiene ya un protocolo.

                  - ---- - - - - - - - - - - - - - - - - - -
                  Rendered asinput url field
                  Options -
                  Inherited -options -
                  Parent typetext
                  ClassSymfony\Component\Form\Extension\Core\Type\UrlType
                  -
                  -

                  Opciones del campo

                  -
                  -
                  -

                  default_protocol

                  -

                  tipo: string predefinido: http

                  -

                  Si un valor es presentado que no comience con un protocolo (por ejemplo, http://, ftp://, etc.), se prefija la cadena con este protocolo al vincular los datos al formulario.

                  -
                  -

                  Opciones heredadas

                  -

                  Estas opciones las hereda del tipo field:

                  -
                  -
                  -
                  -

                  max_length

                  -

                  tipo: integer

                  -

                  Esta opción se utiliza para añadir un atributo max_length, que algunos navegadores utilizan para limitar la cantidad de texto en un campo.

                  -
                  -
                  -

                  required

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, reproducirá un atributo required de HTML5. La label correspondiente será reproducida con una clase required.

                  -

                  Esto es superficial e independiente de la validación. A lo sumo, si dejas que Symfony deduzca el tipo de campo, entonces el valor de esta opción, se puede inferir a partir de tu información de validación.

                  -
                  -
                  -

                  label

                  -

                  tipo: string predefinido: La etiqueta se «deduce» a partir del nombre del campo

                  -

                  Establece la etiqueta que se utilizará al reproducir el campo. La etiqueta también se puede fijar directamente dentro de la plantilla:

                  -
                  {{ form_label(form.name, 'Tu nombre') }}
-
                  -
                  -
                  -
                  -

                  trim

                  -

                  tipo: Boolean predeterminado: true

                  -

                  Si es true, el espacio en blanco de la cadena presentada será eliminado a través de la función trim() cuando se vinculan los datos. Esto garantiza que si un valor es presentado con espacios en blanco excedentes, estos serán removidos antes de fusionar de nuevo el valor con el objeto subyacente.

                  -
                  -
                  -

                  read_only

                  -

                  -Nuevo en la versión 2.1: The read_only option was changed in 2.1 to render as a readonly -HTML attribute. Previously, it rendered as a disabled attribute. -Use the disabled option if you need the old behavior.

                  -

                  tipo: Boolean predeterminado: false

                  -

                  If this option is true, the field will be rendered with the readonly -attribute so that the field is not editable.

                  -
                  -
                  -

                  disabled

                  -

                  -Nuevo en la versión 2.1: The disabled option is new in version 2.1

                  -

                  type: boolean default: false

                  -

                  Si no deseas que un usuario pueda modificar el valor de un campo, puedes establecer la opción disabled en true. Cualquier valor recibido será omitido.

                  -
                  -
                  -

                  error_bubbling

                  -

                  tipo: Boolean predeterminado: false

                  -

                  Si es true, los errores de este campo serán pasados al campo padre o al formulario. Por ejemplo, si estableces en true un campo normal, cualquier error de ese campo se adjuntará al formulario principal, no al campo específico.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - - - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/index.html b/reference/index.html deleted file mode 100644 index 564099a..0000000 --- a/reference/index.html +++ /dev/null @@ -1,162 +0,0 @@ - - - - - - - Documentos de referencia — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Documentos de referencia

                  -
                  -
                  - -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/requirements.html b/reference/requirements.html deleted file mode 100644 index d6a44fe..0000000 --- a/reference/requirements.html +++ /dev/null @@ -1,169 +0,0 @@ - - - - - - - Requisitos para que funcione Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Requisitos para que funcione Symfony2

                  -

                  Para ejecutar Symfony2, el sistema debe cumplir con una lista de requisitos. Fácilmente puedes ver si el sistema pasa todos los requisitos ejecutando web/config.php en tu distribución de Symfony. Debido a que la CLI (por Command Line Interface o Interfaz de la línea de ordenes) a menudo utiliza un archivo de configuración php.ini diferente, también es una buena idea revisar tus requisitos desde la línea de ordenes por medio de:

                  -
                  $ php app/check.php
-
                  -
                  -

                  A continuación mostramos la lista de requisitos obligatorios y opcionales.

                  -
                  -

                  Obligatorio

                  -
                    -
                  • PHP debe ser una versión mínima de PHP 5.3.3
                    • -
                  • Es necesario habilitar JSON
                    • -
                  • Es necesario tener habilitado el ctype
                    • -
                  • Tu PHP.ini debe tener configurado el valor date.timezone
                    • -
                  -
                  -
                  -

                  Opcional

                  -
                    -
                  • Necesitas tener instalado el módulo PHP-XML
                    • -
                  • Necesitas tener por lo menos la versión 2.6.21 de libxml
                    • -
                  • Necesitas activar el tokenizer de PHP
                    • -
                  • tienes que habilitar las funciones mbstring
                    • -
                  • tienes que activar iconv
                    • -
                  • POSIX tiene que estar habilitado (únicamente en *nix)
                    • -
                  • Debes tener instalado Intl con ICU 4+
                    • -
                  • APC 3.0.17+ (u otra caché opcode debe estar instalada)
                    • -
                  • Configuración recomendada en PHP.ini
                      -
                    • short_open_tag = Off
                      • -
                    • magic_quotes_gpc = Off
                      • -
                    • register_globals = Off
                      • -
                    • session.autostart = Off
                      • -
                    -
                    • -
                  -
                  -
                  -

                  Doctrine

                  -

                  Si deseas utilizar Doctrine, necesitarás tener instalado PDO. Además, es necesario tener instalado el controlador de PDO para el servidor de base de datos que desees utilizar.

                  -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/reference/twig_reference.html b/reference/twig_reference.html deleted file mode 100644 index cd74a41..0000000 --- a/reference/twig_reference.html +++ /dev/null @@ -1,388 +0,0 @@ - - - - - - - Extensiones Twig de Symfony2 — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -
                  -

                  Extensiones Twig de Symfony2

                  -

                  Twig es el motor de plantillas predeterminado en Symfony2. Por sí mismo, ya tiene integradas muchas funciones, filtros, etiquetas y pruebas (http://gitnacho.github.com/Twig luego desplázate hasta abajo).

                  -

                  Symfony2 añade más extensiones personalizadas en lo alto de Twig para integrar algunos componentes a las plantillas de Twig. Abajo está la información sobre todas las funciones personalizadas, filtros, etiquetas y pruebas añadidas usando el núcleo de la plataforma Symfony2.

                  -

                  También puede haber etiquetas en los paquetes que utilizas comúnmente que no están enumeradas aquí.

                  -
                  -

                  Funciones

                  -

                  -Nuevo en la versión 2.1: Las funciones csrf_token, logout_path y logout_url se agregaron en Symfony 2.1

                  -

                  -Nuevo en la versión 2.2: The render and controller functions are new in Symfony 2.2. Anteriormente se utilizaba la etiqueta {% render %} y tenía una firma diferente.

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  Function SyntaxUsage
                  render(uri, options = {}) -render(controller('B:C:a', {params})) -render(path('route', {params})) -render(url('route', {params}))This will render the fragment for the given controller or URL -For more information, see Integrando controladores. -Integrando controladores.
                  render_esi(controller('B:C:a', {params})) -render_esi(url('route', {params})) -render_esi(path('route', {params}))Esta genera una etiqueta ESI cuando es posible o de lo contrario vuelve a caer -al comportamiento de render. Para más -información, ve Integrando controladores.
                  render_hinclude(controller(...)) -render_hinclude(url('route', {params})) -render_hinclude(path('route', {params}))Esta genera una etiqueta hinclude para el controlador o la URL -dada. para más información, ve
                  controller(attributes = {}, query = {})Used along with the render tag to refer to the controller that you want to render.
                  asset(path, packageName = null)Get the public path of the asset, more information in -“Enlazando activos”.
                  asset_version(packageName = null)Obtiene la versión actual del paquete, más información en -«Enlazando activos».
                  form_enctype(view)Dibuja el atributo enctype="multipart/form-data" requerido si el formulario cuando -menos tiene un campo para subir archivos, más información en la -Referencia de formularios Twig.
                  form_widget(view, variables = {})Dibuja un formulario completo o el HTML del elemento gráfico de un campo específico, más -información en la -Referencia de formularios Twig.
                  form_errors(view)Dibuja cualquier error para el campo dado o los errores «globales», más información en la -Referencia de formularios Twig.
                  form_label(view, label = null, variables = {})Dibuja la etiqueta del campo dado, más información en la -Referencia de formularios Twig.
                  form_row(view, variables = {})Dibuja la fila (las etiquetas de los campos, errores y elementos gráficos) del campo dado, -más información en la -Referencia de formularios Twig.
                  form_rest(view, variables = {})Dibuja todos los campos que no se han pintado todavía, más información en la -Referencia de formularios Twig.
                  csrf_token(intention)Dibuja un testigo CSRF. Usa esta función si deseas protección CSRF sin crear un -formulario
                  is_granted(role, object = null, field = null)Devuelve true si el usuario actual tiene el rol necesario, más información en -«Controlando el acceso en plantillas»
                  logout_path(key)Genera la URL relativa para cerrar la sesión del cortafuegos dado
                  logout_url(key)Igual a logout_path(...) pero esta genera una URL absoluta
                  path(name, parameters = {})Obtiene una URL relativa para la ruta dada, más información en -«Enlazando páginas».
                  url(name, parameters = {})Igual a path(...) pero esta genera una URL absoluta
                  -
                  -
                  -

                  Filtros

                  -

                  -Nuevo en la versión 2.1: El filtro humanize se añadió en Symfony 2.1

                  - ---- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
                  Filter SyntaxUsage
                  text|humanizeMakes a technical name human readable (replaces underscores by -spaces and capitalizes the string)
                  text|trans(arguments = {}, domain = 'messages', locale = null)This will translate the text into the current language, more -information in . -Translation Filters.
                  text|transchoice(count, arguments = {}, domain = 'messages', locale = null)This will translate the text with pluralization, more information -in Translation Filters.
                  variable|yaml_encode(inline = 0)Transforma el texto de la variable a la sintaxis de YAML.
                  variable|yaml_dumpDibuja una sintaxis yaml con su tipo.
                  classname|abbr_classDibuja un elemento abbr con el nombre corto de una clase -PHP.
                  methodname|abbr_methodDibuja un método PHP dentro de un elemento abbr (p. ej. -Symfony\Component\HttpFoundation\Response::getContent)
                  arguments|format_argsDibuja una cadena con los argumentos de una función y sus tipos
                  arguments|format_args_as_textIgual a [...]|format_args, pero le quita las etiquetas.
                  path|file_excerpt(line)Dibuja un extracto de un archivo de código en torno a una -determinada línea.
                  path|format_file(line, text = null)Dibuja la ruta a un archivo en un enlace.
                  exceptionMessage|format_file_from_textIgual a format_file excepto que añade a la cadena de error -predefinida la ruta al archivo (es decir, ‘en foo.php en la línea -45’)
                  path|file_link(line)Dibuja la ruta al archivo correcto (y número de línea)
                  -
                  -
                  -

                  Etiquetas

                  - ---- - - - - - - - - - - - - - - - - - - - -
                  Tag SyntaxUsage
                  {% form_theme form 'file' %}This will look inside the given file for overridden form blocks, -more information in Cómo personalizar la reproducción de un formulario.
                  {% trans with {variables} %}...{% endtrans %}This will translate and render the text, more information in -Plantillas Twig
                  {% transchoice count with {variables} %} -... -{% endtranschoice %}This will translate and render the text with pluralization, more -information in Plantillas Twig
                  {% trans_default_domain language %}This will set the default domain for message catalogues in the -current template
                  -
                  -
                  -

                  Pruebas

                  -

                  -Nuevo en la versión 2.1: La prueba selectedchoice se añadió en Symfony 2.1

                  - ---- - - - - - - - - - - -
                  Sintaxis de la pruebaUso
                  selectedchoice(choice, selectedValue)Devuelve true si la opción para el valor dado en el formulario -está seleccionada
                  -
                  -
                  -

                  Variables globales

                  - ---- - - - - - - - - - - -
                  VariableUso
                  app Attributes: app.user, app.request -app.session, app.environment, app.debug -app.securityLa variable app está disponible en todas partes, y proporciona rápido acceso a -muchos objetos necesarios comúnmente. La variable app es una instancia de -Symfony\Bundle\FrameworkBundle\Templating\GlobalVariables
                  -
                  -
                  -

                  Extensiones de la edición estándar de Symfony

                  -

                  La edición estándar de Symfony añade algunos paquetes al núcleo de la plataforma Symfony2. -Dichos paquetes pueden tener otras extensiones de Twig:

                  - -
                  -
                  - - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/robots.txt b/robots.txt deleted file mode 100644 index f783256..0000000 --- a/robots.txt +++ /dev/null @@ -1,5 +0,0 @@ - -# This file can be used to affect how search engines and other web site crawlers see your site. -# For more information, please see http://www.w3.org/TR/html4/appendix/notes.html#h-B.4.1.1 -# WebMatrix 2.0 - diff --git a/search.html b/search.html deleted file mode 100644 index aedf0ee..0000000 --- a/search.html +++ /dev/null @@ -1,139 +0,0 @@ - - - - - - - Búsqueda — Manual de Symfony2 en Español - - - - - - - - - - - - - - - - - - - - -
                  -
                  -
                  -
                  - -

                  Búsqueda

                  -
                  - -

                  - Please activate JavaScript to enable the search - functionality. -

                  -
                  -

                  - From here you can search these documents. Enter your search - words into the box below and click "search". Note that the search - function will automatically search for all of the words. Pages - containing fewer words won't appear in the result list. -

                  -
                  - - - -
                  - -
                  - -
                  - -
                  -
                  -
                  -
                  -
                  - Bifúrcame en GitHub - -
                  -
                  -

                  Navegación

                  - -
                  -
                  - - -
                  -
                  - -
                  - © Copyright 2011-2013, Traducido por Nacho Pacheco. - Actualizado por última vez en Apr 22, 2013. - Creado con Sphinx 1.1.3. -
                  -
                  - - - - - \ No newline at end of file diff --git a/searchindex.js b/searchindex.js deleted file mode 100644 index acba731..0000000 --- a/searchindex.js +++ /dev/null @@ -1 +0,0 @@ -Search.setIndex({objects:{},terms:{yaml_encod:344,https_port:226,yellow:[61,314,7],four:[],instalada:[183,273,331,349,179,79,9,370],prefix:[0,243,341,58,81,326,121,211,346,197,198,148,86,388,231,339,201,354,156,70,313,347],escriba:[91,182,121,33],"agreg\u00f3":[22,373,201,293,302],otro:[0,91,1,92,93,354,2,284,94,298,193,96,6,99,7,146,305,115,102,273,199,286,277,299,278,200,14,108,202,109,110,204,16,18,314,19,20,177,318,207,319,22,23,211,25,321,26,322,29,326,8,121,33,328,222,37,331,330,226,71,72,231,337,338,341,234,270,343,46,345,47,48,49,238,349,242,362,135,56,136,248,138,58,356,142,251,60,252,61,144,62,63,148,149,150,152,153,65,367,157,158,73,161,74,342,308,77,78,309,165,375,271,167,210,166,98,172,212,279,174,175,176,382,383,84,386,388,182,184,88,289,346,293,188,297,186],setexcept:[51,211],denegar:[219,139,392],acmecustomerbundl:115,numberformatt:[224,359,206,295],otra:[0,91,189,92,93,2,238,94,166,4,193,5,6,99,7,9,305,306,115,273,198,199,11,105,310,200,14,112,311,109,204,16,312,18,145,20,219,318,207,319,23,24,211,222,26,322,213,326,8,121,32,218,33,328,35,331,221,223,335,228,43,231,337,129,338,247,234,270,344,46,345,47,49,341,51,240,349,242,362,56,136,248,138,142,60,61,144,62,63,255,148,64,152,153,364,256,366,367,206,304,70,370,161,315,268,342,75,77,78,375,275,167,272,271,98,380,277,83,280,175,282,383,384,84,386,180,388,182,286,363,389,346,186,293,188,297,90],igual:[50,284,373,163,269,349,354,2,23,3,25,380,193,96,56,362,8,122,60,305,33,306,282,102,146,222,166,331,84,38,286,323,210,387,105,310,367,219,128,290,257,341,338,343,344,389,204,16,46,158,346,186,161],hermano:[245,343],some_em:148,"personal\u00edzalo":[99,213],digit:331,sensioframeworkextrabundl:[26,383,341,37,114,118,8,16,243],treebrows:245,regional:[339,60,294],dictado:14,prepersist:[66,297,166,131],universalclassload:201,compuesta:[46,186,211],compuesto:[260,2,354,33,247],doctrine_mongodb:[338,207,388],decimo:[],acercamiento:[],minimalista:337,autocrlf:33,haber:[238,18,91,319,375,271,25,193,248,138,99,121,383,146,286,335,367,67,344,293,73,186,49],sustituyen:[238,331,204,335,90,49],admin_bundle_simplecms_page_edit:86,persisten:338,correctament:[268,145,22,166,135,213,247,28,326,9,297,102,346,331,182,337,14,341,202,343,293,204,313,186],dirnam:177,"dise\u00f1ar":[135,247],fuera:[306,268,18,91,20,318,2,102,166,383,342,341,248,205,82,6,99,7,215,121,61,62,70,148,331,84,334,388,234,204,46,313,186],agrego:[],my_custom_load:293,pulsa:331,aclprovid:136,"haci\u00e9ndol":61,factibl:218,redirectcontrol:198,elegant:[234,144,121,334,204],second:[204,331,199,141,310,98,70,358,285,235,33,87],mibundl:[176,147],fuert:[108,186],feedread:77,durat:[],agregu:[22,260,166,33],"importaci\u00f3n":[299,349],"8390105917f3a3d533815250ed7c64b4594d7ebf":247,instalast:182,muev:[61,306,14,7,204,297],enfocar:338,"entr\u00f3":331,dialogo:186,construrlo:328,widget:[61,266,329,285,314,137,28,85,99,154,294,178,22,181,228,362,297,235,167],getfullnam:[93,39],probabilidad:[270,226,49],"par\u00e1metro":[0,189,298,6,305,273,199,271,106,83,200,14,108,110,204,138,164,209,210,211,319,321,322,323,213,119,30,121,32,218,328,222,331,332,226,227,42,231,338,56,342,111,346,347,52,349,350,351,242,362,135,244,341,248,205,58,134,60,143,144,148,153,66,367,259,70,157,158,161,78,375,275,166,380,277,212,282,383,283,385,84,388,47,186,293,48,90],explorar:[74,273,389,315,343,207,326,121,186,211],"sucedi\u00f3":[331,121],"seg\u00fan":[204,77,286,241,70,352,387,293,60,135,49],here:[245,282,70,292,199,234,343,81,99,326,204,172,297,347,298],content_repositori:218,migrar:[241,166,161],"pu\u00f1ado":218,colabora:26,simpleread:140,"querr\u00eda":331,renombra:289,"visualizaci\u00f3n":[211,18],acertar:[93,343,43],envoltura:245,asumimo:247,retrasado:[],round_floor:[359,295],reporta:313,blog_post_id:135,ejecutando:[268,92,241,21,23,275,135,213,214,341,326,166,99,7,277,33,61,144,319,84,124,151,179,337,363,260,338,70,370,90],gitolit:337,ligera:[22,211],substr:[314,176,350],unix:[145,169,148,28,84,6,199,235,49],config_prod:[14,382,205,144,71],unir:[166,247],instalando:[17,239,0,18,1,163,273,203,315,358,2,320,241,21,39,23,24,271,191,321,26,168,375,27,248,138,378,326,255,7,120,142,349,173,385,33,61,144,145,384,197,231,37,149,199,221,124,180,53,152,363,86,65,365,240,213,177,224,316,289,338,201,383,69,101,70,46,72,237,160],ligero:[260,331,161],logicexcept:[51,327],"combinaci\u00f3n":[176,144,129,153,91,322,45,109,242,42,346,167],scripthandl:[213,101],dure:[98,293],diciembr:215,fastcgi_split_path_info:169,exigir:242,until:[177,313,141],funciona:[18,91,388,318,92,2,241,80,166,211,40,247,362,99,82,121,60,305,33,144,253,222,148,331,84,149,150,179,226,105,278,337,289,338,14,341,202,90,293,204,46,181,186,161],relat:[172,108,342,213,347],"cron\u00f3metro":152,yahoo:71,notic:[245,322,222,234,58,81,8,386,242],"tendr\u00edan":[165,215,346,390,236],hover:240,insinuacion:[],getrawuri:[],"almacenar\u00e1":[166,99,346,186,207],facilidad:[71,23,313,319],hold:[233,313,347,197],getconnect:221,hola:[242,313,121,341],echemo:[305,56],rusia:60,acl_object_ident:[286,58],concepto:[213,220,62,204,273,341,338,108,189,166,286,110,121,347,111,305,367,186,84,167],itself:[137,28,261,81,141,110,313,233,347],enorgullec:204,issecur:[272,84],getsess:[222,138,332,242,375,186],construyen:[271,14,248,99],smtp:[284,14,134,227,117,353],finalment:[74,18,206,349,207,241,353,330,4,193,136,139,7,215,331,61,102,222,199,221,86,228,182,367,184,260,389,311,157,346,161],cautiou:197,mantent:84,bienvenu:141,caution:217,pinta:[109,137,28,202,99,235,167],want:[22,271,254,245,169,170,7,81,141,326,217,212,327,61,35,273,178,39,86,335,87,339,108,344,347],cardschema:376,absoluta:[306,231,177,0,96,289,14,388,342,90,305,344,110,346,204,148,297,5,25],"reci\u00e9n":[337,338,270,241,33,166,135],"cr\u00edtico":[137,28,382],yui:[71,322,189,377],cielo:84,mydoctrinedbalconnectionwrapp:148,"\u00e1rea":[26,5,369,139,256,304,98,204,346,166],recuperen:386,conllev:351,event_dispatch:180,predefinid:[],hoi:[242,1,313,16],"podr\u00edan":[177,383,18,346,342,8,226,312,23,252,166],how:[189,349,356,22,275,245,170,58,81,99,7,194,217,83,327,280,61,196,273,178,226,87,339,108,270,292,293,347],serviceid:[282,336],fiablement:166,agreguen:[94,353,161],failure_handl:58,fuent:[1,145,20,191,167,322,213,341,60,252,279,33,199,150,180,367,289,389,247,342,109,293,345,186],setusernam:23,abstractproxi:49,authortyp:[93,362],diagram:141,sede:135,wrong:[172,3,222],calidad:[14,20,204,130,186,161],estrecho:234,"ser\u00eda":[238,18,335,77,354,22,271,167,193,56,136,248,250,8,388,60,305,175,281,273,148,40,226,105,228,182,128,313,108,234,202,204,297,161],preferir:[46,2,167],sentir:[338,166],addresstyp:380,loadmydata:70,isvalid:[74,222,207,136,67,202,93,99,297],empuja:[],obsolet:[],enganchando:297,sport_meetup:327,icuvers:224,boleto:[313,33],"d\u00e9mono":[],allow_if_object_identity_unavail:58,romper:[268,84,11,204,313,33],cerrada:256,feedback:[313,33],document_class:[347,218,86,317,96],resolviendo:383,"apreciar\u00e1":[204,341],cerrado:186,s_maxag:[331,375,138],autocompletar:191,vari:[307,331,30],doctrine_integr:302,unirs:281,getinst:46,unirt:89,fit:[292,156],missingfieldsmessag:254,contextlisten:383,fix:[322,141,86,313,33,87],comprueban:319,sufija:[350,158,222],hidden:[88,298,76,327,99,232,212,127,186,25],fin:[266,0,18,93,319,241,351,6,166,353,167,40,268,362,250,98,23,32,357,60,279,382,62,222,221,107,84,231,338,342,389,204,16,392,49,313,186,161],easier:[110,347,81,212],corrigiendo:[],prependextensioninterfac:[175,319],collectionhold:202,surgir:186,proce:[221,327],enrich:[],"justificaci\u00f3n":[11,309],"averiguaci\u00f3n":[],method_access_control:[225,162],"pintar\u00e1n":22,multidimensional:[163,142],"anotaci\u00f3n":[93,165,242,209,210,166,354,57,326,121,32,278,307,144,383,222,221,125,42,66,259,119,47],porcentaj:[283,14,82,364,226,60,212],acmenewsbundl:[],form_them:[99,344,167],incluyen:[322,319,314,145,20,338,99,215,166,167],integrast:202,abordan:[8,204],accommod:[],representa:[284,67,206,219,207,2,242,376,211,342,362,99,8,142,9,144,62,331,11,286,232,128,200,260,234,343,16,46,181,186,161],abortando:202,timeout:[358,388],"regresar\u00e1":[314,163,139,383],debug:[284,239,205,20,144,211,322,103,341,331,326,344,217,204,306,176,382,222,147,148,199,153,226,87,368,14,68,343,264,70,16,328,346,159],"gur\u00fa":16,last_modifi:[331,375,138],enfoqu:[175,266,337,341,136,14,331,84,99,110,386,204,210,186],generando:[230,231,118,0,205,274,57,342,186,338,241,204,321,346,275,243,166],resum:211,ioexcept:[199,289],role_organ:58,sincronizar:182,funcionamiento:[26,273,260,316,338,211],"var\u00ed":383,convertidor:210,soliciten:331,setmethodcal:282,webservic:102,permitirt:[22,99,342,80,49],loadclassmetadata:166,dsn:[277,226,30],"especif\u00edcalo":102,branch:[313,33,92],comodin:[231,346,0],adapt:[231,339,0,197,87],lazyservicemappass:330,reconocimiento:215,"especif\u00edcala":349,navig:[60,305,204],correcta:[306,102,200,314,84,99,204,71,186,161],correcto:[306,218,349,222,375,290,234,20,202,362,99,344,204,22,228,45,313,186,383,167],omiss:[],omiten:318,"_routing_nam":205,usaremo:14,type_extens:[266,293],md5:[284,247,331,256,134,23],apuntar:[322,145,121,362],projectconfigur:8,adivinado:[],alterar:[326,77],mimetypesmessag:[128,105],consumirs:62,pagin:156,unabl:[363,384,247],passwordencoderinterfac:256,nombreaccion:230,confus:[],ifmodul:205,agregan:[158,60,234,89,319],"est\u00e1":[0,91,1,92,93,300,2,190,166,4,193,96,302,240,6,99,7,215,9,100,305,10,307,308,102,197,199,286,105,106,14,257,108,202,109,110,111,16,313,17,15,18,314,19,206,20,219,318,319,21,346,22,117,23,386,211,222,322,27,119,28,30,31,326,8,121,32,122,218,33,328,332,204,254,123,331,311,124,293,354,225,226,227,157,42,127,43,229,230,128,232,325,338,44,247,234,45,343,344,248,46,345,371,47,48,49,341,50,52,388,349,140,350,241,351,228,242,362,135,56,136,137,138,139,58,250,334,142,60,61,144,62,361,146,147,231,255,115,149,150,64,153,364,256,65,337,366,367,259,389,264,70,130,71,158,73,235,161,306,268,342,75,269,77,79,80,375,209,167,272,210,273,271,98,380,172,278,279,175,281,282,383,384,283,178,84,179,86,180,387,188,182,285,213,277,183,184,185,363,290,297,291,90,187,391,145,89,181,392,205,186],"excepci\u00f3n":[51,268,314,319,209,166,211,222,193,247,139,98,99,7,251,297,384,144,383,70,331,104,256,286,153,226,388,182,363,14,289,342,68,204,311,47,186,48],patrocinadora:1,"est\u00e9":[315,373,145,20,349,93,164,383,241,208,22,166,243,361,322,214,247,326,98,8,121,353,60,143,33,175,62,222,118,331,180,11,386,257,218,215,368,338,201,186,109,89,204,16,313,90,161],instruct:[217,108,273],numeric_funct:[303,148],interpretar:[341,84,226,161],agregar:[266,74,238,268,0,18,373,189,282,93,2,241,351,80,117,23,166,167,193,136,28,138,249,134,99,98,251,122,33,10,220,102,346,123,84,11,387,335,336,231,259,185,290,130,291,202,270,338,293,204,46,157,392,47,186,161],"subpetici\u00f3n":[242,383,234,222,211],list_act:161,is_authenticated_anonym:[219,213,369,308,98,186],empinada:240,content_datetim:141,movido:[297,161],caen:166,master:[234,199,124,349,180,286,326,241,21,70,23,313,33,89],centralizada:146,agrega:[61,238,162,93,241,166,211,341,362,99,7,277,60,33,10,222,331,180,179,335,228,337,153,338,201,234,202,389,391,264,204,71,158,297],cmf_find:308,predecibilidad:11,bundlealia:388,method_is_not_found:94,"trasladar\u00e1":[329,178,85,154,294,181],tematizado:167,localizarla:389,eventlisten:[383,146,131,293,70,251,157,158,327,211],basando:[218,24],travers:[391,254,289],db_port:[349,70],phpcrimagecontrol:101,"a\u00f1\u00e1delo":[293,213],database_driv:[115,349,326,16,277,166],alimentador:[242,140,77],"a\u00f1\u00e1dela":293,geticuvers:[],number_format:270,date_format:[285,141],implementen:[219,96,342,110,157,23],securityextrabundl:[259,341,119,124,98,16,242,209,186],invitado:[281,331],tree:[245,168,338,108,141,301,110,86,156,166,347,244],setarg:[],project:[322,169,147,96,338,339,145,273,202,241,110,121,8,70,217,86,367,166,213],cssselector:[343,240,107,142,159],haya:[20,349,92,299,2,241,346,165,117,166,353,98,121,277,33,175,319,331,153,105,46,259,337,338,130,389,70,312,313,186],"180cm":123,treeview:244,"contrase\u00f1a1":186,"contrase\u00f1a2":186,olvida:161,annotationfileload:[231,0],esta:[268,0,91,1,92,93,300,2,238,94,3,166,193,332,97,98,6,99,7,215,388,216,9,100,305,101,306,307,308,102,273,198,199,311,104,11,298,105,310,299,200,13,14,201,108,202,327,109,110,111,16,312,313,112,113,222,15,256,18,314,19,206,20,282,190,281,21,208,22,117,23,24,211,212,26,322,54,214,119,28,163,29,326,8,121,353,32,118,122,218,204,33,355,219,328,329,35,254,123,331,221,124,293,126,40,226,157,286,228,336,127,158,230,128,232,129,338,44,247,234,131,45,343,344,337,236,137,46,345,371,47,347,49,341,51,240,335,349,140,350,241,352,242,362,135,376,56,136,57,138,139,58,250,142,373,251,60,143,248,360,319,61,144,62,146,231,255,148,149,150,64,153,154,65,287,66,366,367,259,207,252,67,68,389,304,70,339,71,72,73,235,161,266,74,315,162,342,75,77,78,164,346,79,165,375,209,167,272,168,359,271,82,172,278,175,176,382,383,384,284,178,84,224,85,323,86,180,387,188,182,285,277,183,184,185,288,363,290,297,291,390,90,187,391,145,89,294,295,181,392,386,205,186],pesada:[383,166,204],pesado:[99,375,204],esto:[0,91,92,93,300,2,284,190,3,298,193,96,97,98,6,99,7,215,216,9,305,240,115,102,273,199,104,286,105,299,200,13,14,15,202,109,110,111,16,312,313,113,222,18,314,19,206,20,177,207,319,22,117,23,211,25,322,323,213,214,119,28,29,30,326,8,121,32,306,218,327,33,355,219,328,329,204,37,331,332,293,125,354,40,226,227,71,42,336,127,229,231,337,338,44,341,234,131,270,282,343,225,236,248,46,371,47,48,49,238,52,335,349,350,241,351,228,242,362,353,247,136,137,138,139,140,250,334,142,251,60,143,360,61,144,62,146,255,148,339,150,64,152,153,154,155,366,367,259,368,260,252,369,67,262,70,130,157,158,73,235,161,266,74,315,268,342,163,77,164,253,80,165,375,271,167,168,210,359,166,82,277,361,279,175,176,382,383,178,84,85,386,256,388,182,285,310,184,287,389,346,390,90,391,145,294,295,181,392,297,186],"inhabilitar\u00e1":319,spectrum:[],parenthes:350,chosen:[347,87],increment:[98,58,202],deliberar:281,incompat:[217,386],timevalid:95,requestdatacollector:293,sitio:[18,348,1,315,189,349,318,77,116,383,242,24,211,222,193,5,30,99,98,8,121,59,142,218,305,102,204,273,331,84,180,244,363,86,105,228,366,128,184,288,283,14,369,131,343,110,89,70,71,313,186],especi:[341,74,138,294,20,318,22,2,329,94,375,353,222,4,56,162,383,81,31,99,8,216,142,251,60,10,62,146,178,331,84,85,11,154,227,228,336,194,310,278,260,14,311,202,109,343,293,204,130,46,181,346,186,49],anexando:[193,365],vinculado:[338,248,93,99,271,135],jms_di_extra:[165,302],nuev:84,format_file_from_text:344,vinculada:[228,386,161],form_emails_1:22,menudo:[284,2,166,25,322,56,136,338,99,121,60,305,33,175,111,331,64,286,330,228,260,108,109,293,204,311,46,370,49],simplifi:347,"cargar\u00e1":[213,341,326,8,226,367],contribuir:[89,33],ignorada:186,object:[239,342,163,80,352,209,166,170,247,378,140,81,141,344,305,219,197,39,286,65,182,338,56,234,327,292,110,293,392],articlebundl:204,revuelta:186,header_client_port:272,addviolationat:[80,32],conceden:219,geturl:[266,322,56,341,226,204,312],"impl\u00edcita":129,geturi:[331,332,343,142],dummi:350,referido:[277,367,166,351],"har\u00eda":[326,331,351],causant:266,incompleta:200,bifurca:[313,89],came:[],"id\u00e9ntica":[188,331,345],bajo:[17,1,145,350,2,346,210,386,166,135,321,4,27,96,56,345,58,6,99,326,8,121,211,60,305,33,382,62,294,36,37,148,331,180,310,153,226,188,182,367,129,338,14,354,342,343,110,70,16,46,71,158,161,313,186,353,49],"id\u00e9ntico":[310,144,346,161],dicken:34,advisori:[],eventual:96,compararla:102,compararlo:367,incluso:[268,375,18,314,115,219,318,350,2,241,346,210,166,25,40,341,136,355,205,99,8,121,142,311,60,305,240,328,383,361,222,37,20,331,84,153,278,42,366,43,367,218,338,14,108,342,202,109,389,204,16,46,158,73,297,186,161],setverticalborderchar:34,somes3cretkei:58,layout:[10,273,147,56,315,149,156,121,65,204,305,161],combinado:40,ment:[110,84,357],menu:[10,245,96,108,141,218,347,244],combinada:256,apach:[341,145,169,288,375,205,166,199,84,189,349,6,363,121,70,345,161,275,87],dbu:342,siet:[231,331],rico:[375,204,131,138],theme:244,busi:[],za0:32,optionsresolv:[266,74,170,327,39,202,362,99,380,228,159],semblant:105,"oblig\u00e1ndolo":186,eliminarlo:[22,23,297,184],rica:[331,346,343],serv:[322,169,222,375,327,87],relacionar:[277,166],foremost:[],constantement:[389,14],sustituir:[266,238,138,145,189,177,318,92,2,351,242,375,275,167,213,247,356,99,341,25,100,305,306,144,84,149,153,386,41,337,127,367,232,311,202,335,186,282,109,204,16,46,47,90],representacion:[331,161],optgroup:181,relacional:[78,338],"devolvi\u00f3":94,propuso:281,asumist:331,buscador:[177,159],lamentablement:331,auto_map:[213,338,148,388,349,326,70,16],"remoci\u00f3n":[22,297,202,280,319],propelpdo:277,respond:[383,331,94,2,121,46,157,117,244],"\u00e1brelo":[],"_secur":332,emailsenderlisten:[383,293],setexitcod:51,padr:[238,268,294,206,76,308,77,22,167,245,341,248,97,326,29,362,99,82,216,142,278,355,282,329,204,178,385,295,149,85,286,154,65,335,287,182,367,310,359,232,13,14,67,159,109,343,110,111,44,181,186,113],result:[283,148,342,141,343,204,9,161,45,327,347,87],couldnotfindrouteexcept:141,respons:[74,284,239,251,138,349,77,93,207,2,383,242,375,166,211,361,341,139,134,379,344,121,358,277,9,60,252,327,10,307,62,222,197,331,84,149,312,228,336,87,367,129,338,108,342,68,109,343,110,293,89,204,46,157,72,347,161],ahorrar:[331,205],default_document_manag:[70,388],acl_entri:[286,58],best:[217,326,39,234],targetent:[166,200,202,135,247],"men\u00fa":[10,245,329,96,18,178,1,108,85,110,154,294,22,181,218,24,347],wikipedia:[260,376,84,129],superclas:[238,335],redirigiendo:[220,222,138,58,343,242,375,186,25],mycustomwarm:293,figur:[],cifrada:[62,247],"precauci\u00f3n":58,setvrossingchar:34,irc:[26,309,281,20,31,116,174],alguien:[281,220,145,247,331,84,318,286],maxidletim:49,never:[239,141],reemplazarlo:[306,204],storebundl:[338,131,2,277,46,181,166,229],personaliza:[384,363,362,99,7,251,167],debe:[0,92,93,2,94,3,4,193,96,362,99,7,9,10,115,102,198,104,310,368,105,299,200,14,257,311,202,327,109,110,111,16,313,222,18,314,19,206,20,318,190,281,22,210,211,212,322,323,213,119,28,30,8,121,32,122,204,33,329,35,254,123,331,221,38,40,226,42,336,127,229,128,232,338,44,341,342,131,45,343,319,137,46,345,346,48,284,388,349,249,350,241,351,352,242,228,54,353,247,136,57,138,58,142,357,60,143,248,61,144,62,146,231,148,150,180,153,154,65,367,359,207,260,67,68,389,70,130,71,158,370,235,161,266,74,268,373,75,76,78,164,80,270,271,167,168,375,166,82,277,176,219,383,178,84,85,179,386,256,387,188,269,285,118,185,288,363,290,297,291,90,187,391,293,294,295,181,392,205,186],webprofil:[204,144,211,55,64],deba:[338,153,51,166,33],"5fz2z8qika7utz4bykoc":256,"v\u00eddeo":289,extens:[266,234,206,76,355,207,2,329,356,22,353,319,193,213,137,28,97,249,29,82,216,178,359,305,175,62,204,148,295,180,85,310,153,154,294,287,182,127,285,87,232,13,339,14,67,270,293,70,44,46,235,347,113],mustra:[],"_target_path":[186,58,25],extienden:[219,23,346],round_halfup:359,moderador:[281,33],idprefix:367,rolehierarchi:219,desactivado:[71,204],"6_public":112,"indicaci\u00f3n":[],deniega:186,fingers_cross:[176,382,264],reconstruido:[],countri:[224,88,324,75,85,93,99,343,380,327],elija:[342,62,60,121],seri:[0,18,145,20,93,2,21,242,375,166,167,168,56,28,138,99,326,8,277,60,383,178,153,364,386,231,338,14,112,341,186,109,389,204,46,181,297,235,161],"reflexi\u00f3n":383,exitoso:[99,139,25],restructuredtext:[158,372,180],basecontrol:149,"envolvi\u00e9ndola":60,"colaboraci\u00f3n":89,setbarwidth:364,lanzamiento:11,felicidad:14,"dep\u00f3sito":[],securitycontrol:186,duplicando:[60,204],"_intern":[],diff:[277,241,33],tarea:[266,205,20,92,93,319,23,166,222,168,341,136,134,99,7,8,262,277,61,281,383,35,84,150,228,78,322,260,14,202,338,293,204,16,48,161],assum:[339,327,273],symfony_cmf_post:156,duplic:[233,375,347,138],listenerinterfac:[62,139,256],"espa\u00f1ola":60,desactivada:[389,144],fri:[137,28],difund:[383,249,2,46,211,161],txmt:226,beta1:[],tomemo:[323,254,14,153,8,204,46,346],nodenam:[142,70,349],eveto:[],maskbuild:136,life:[],recomend:[232,342,20,145,76,140,305,99,343,229,70,165,127,186,33,361],some_custom_typ:[],"criptogr\u00e1fica":58,aplanada:383,"a\u00f1adirla":[],correo_electronico_person:254,rootnod:[245,153,193],storesubscrib:[46,2,336],child:[193,273,348,108,163,362,111,335],anteponiendo:[175,363,288],desactiva:[175,272,204,96,389,104,99,142,210,211],medida:[322,84,341,37,331,108,20,58,338,153,238,386,335,166],"a\u00f1adirlo":[4,62,15,342,367],ant:[91,189,93,2,238,193,97,98,99,7,216,176,102,196,286,12,13,14,201,108,202,110,204,311,313,113,138,314,206,20,328,376,23,211,322,119,28,31,326,121,327,33,220,319,331,221,126,226,335,127,338,341,342,343,46,371,47,48,51,52,350,242,55,135,247,136,355,134,142,251,60,252,61,144,62,146,115,180,363,259,67,157,73,161,145,268,163,77,375,166,167,379,82,277,361,175,281,383,284,179,182,285,287,288,289,389,346,390,293,297,186],field_error:[99,167],asegura:[319,314,178,221,166,338,22,186,211],"d\u00f3lar":206,login_firewal:186,manej:[205,331,198,204,166,353],importancia:[331,222,362],modifiqu:[],spoof:[],tokenauthenticatedcontrol:157,conservadora:331,undelet:[136,286],acmedefinit:[],"resincronizaci\u00f3n":358,establecida:[380,62,254,153,331,137,28,64,285,99,391,238,226,390,335,60,235,49],useabetterpassword:326,split:[322,313],big:[327,105],my_block:197,spaceless:[266,99,167,362],relacion:[267,200,338,189,202,22,277,47,166,135],selecttre:245,setbaseurl:90,memoria:[138,19,20,77,102,375,383,171,8,9,176,328,62,197,148,331,84,104,256,152,258,14,186,293,90,48,161],memoric:[],http_x_forwarded_for:[],filterxpath:[343,142],ob_flush:375,fairli:[],aprovechando:[346,204,18],"rambi\u00e9n":[],memoriz:331,fabricant:8,doctrineextensionsbundl:[],nonuniqueresultexcept:166,setresolv:81,familiarializado:[],"conexi\u00f3n":[51,0,162,275,115,349,78,30,166,135,193,136,362,32,277,273,148,84,286,388,229,260,202,131,338,70,161],potencialment:[281,330,342,343,226,49],runtimeexcept:[176,222,314,81,350,358],igualment:[222,56],form_rest:[99,344,202,109],gzip:318,settimeout:358,emailconstraint:93,letra:[61,36,324,7,85,2,294,46],bellow:347,entityiniti:293,autenticar:[247,139,256,98,293,392,100,186],exhib:251,preparando:199,autentican:186,desaparecen:222,destacar:136,multilangmenuitem:[],previous:[206,355,329,137,28,97,29,82,216,359,62,178,85,154,127,285,287,13,44,67,294,295,181,235,113],roleinterfac:[219,247],hai:[0,91,1,92,93,354,284,362,99,7,9,307,102,273,198,199,286,14,112,108,202,110,204,18,314,206,20,282,318,319,22,210,211,25,214,326,8,121,32,33,219,34,222,331,226,335,228,231,337,338,56,342,270,343,46,47,48,49,341,238,240,242,244,247,136,139,58,134,142,60,61,144,62,254,255,148,149,64,153,366,367,368,289,157,73,161,74,315,268,77,80,165,375,166,167,172,278,177,383,178,84,386,388,182,288,363,389,346,186,145,89,295,297,90],format_quiet_nomax:364,getsalt:[102,23,186,256,247],xmlhttprequest:343,easi:[156,239,327,111],incorporando:[331,207,74,127,267],"mencion\u00f3":[144,247,14,108,110,8,252,367],had:[],antiflood:284,involucrart:49,rest_controller_class:213,"mencion\u00e9":[326,342],entera:[193,331,204,22,60,48],haz:[342,145,93,2,242,23,166,211,322,213,96,7,121,142,277,33,61,102,222,331,149,338,234,202,131,343,89,204,46,297,186],add_tag_link:202,getroutecont:[110,347,367],presentarlo:[99,33,161],entero:[138,2,22,209,54,167,375,109,136,82,358,172,218,384,286,363,288,338,302,187,343,295,46,346],sanit:[],preserv:[],centrart:166,appendto:22,clonar:[337,124,273,92],invoca:[193,56,338,14,335,234,256,77,343,238,142,91,166,49],measur:[],aprovechar:[224,193,266,153,331,93,99,2,46,212,186,49],specif:[322,246,273,233,261,131,327,70,199,347,367],symfonycmfbundleblockbundlemodelfeeditem:246,positivo:[219,359,295],arrayinput:[61,7],fixed_toolbar:213,agrad:[266,144,222,37,104,180,166,99,242,186],"atribuci\u00f3n":[188,17,345],ninguna:[314,294,388,77,165,244,322,213,214,136,345,99,326,122,329,70,197,178,331,85,153,154,387,188,367,277,200,129,290,342,202,110,204,181,186,161],seleccionen:190,non_default:175,registerstreamwrapp:177,ninguno:[314,182,84,219],aprovechan:[389,14],"instalaci\u00f3n":[315,337,213,197,273,199,145,20,180,92,179,326,121,70,311,336,218,24,331],ignorando:145,right:[308,39,234,86,327,87],nodedefinit:62,aparentar:247,intercalada:[350,158],tenemo:[277,331,60,353],insidencia:228,default_sess:70,consoleev:[51,320],beneficiar:[91,331,6,11,182,161],precompilado:[],latest_articl:[],fluy:139,esquema:[321,231,0,376,18,338,115,349,166,78,153,326,8,241,277,72,90,135,5],txt:[289,64,134,121,375,186],bottom:55,file_get_cont:[10,363,62,384],subclass:[335,87],unit:[60,141],otro_activo:103,condit:[358,278],getlistact:230,foo:[222,384,0,256,138,294,212,22,2,94,117,210,386,209,167,380,193,273,58,141,7,8,32,178,277,60,242,319,61,177,329,142,147,166,148,84,150,125,85,152,153,225,154,180,336,229,231,218,363,338,14,233,375,390,90,68,109,343,344,204,46,181,72,73,313,186,334],price:[146,338,206,327,277,270,166],setschem:90,sensibl:[145,260,14,331,84,375,166,211,87],gsrelf569mskdsfods6lyq8t:256,"invoc\u00f3":2,inmediato:[91,331,15,362,153,343,186],baggag:[],refieren:204,cambiando:[176,144,193,56,331,205,220,125,392,383,133,341,72,161,275,135,25],annotcontrol:[37,150],alterada:193,refieret:[],emparejarla:346,"centrar\u00e1":247,planificado:383,exhibido:[61,7],slightli:[],abarcar:286,truevalid:54,"informaci\u00f3n":[0,1,92,93,300,2,96,303,97,98,362,99,7,215,216,305,101,10,102,273,199,286,13,14,108,109,110,111,16,312,113,138,314,206,20,207,22,117,210,24,72,211,25,322,213,214,28,29,30,8,121,204,33,329,222,331,311,293,125,226,41,127,43,231,337,338,44,247,342,131,270,343,344,355,46,346,347,341,284,349,249,241,351,242,55,135,244,245,376,56,137,139,58,142,60,61,144,62,148,150,64,152,153,364,154,366,367,259,260,67,70,158,161,266,74,315,268,77,78,375,275,167,272,359,166,82,277,361,281,383,178,84,85,386,388,287,390,186,145,294,295,181,392,90],sendnewsletteract:14,plain_text_typ:213,dibujan:[181,300,167],almacen:[331,210],decorar:[305,204,56],basenam:144,son:[0,91,1,92,93,300,2,298,95,193,96,6,99,7,9,305,71,199,286,105,12,376,14,108,109,110,204,16,313,256,18,145,20,282,22,117,23,319,322,213,119,28,30,8,121,122,33,219,328,329,222,37,331,330,40,226,41,42,128,337,338,247,342,111,131,343,225,46,47,347,49,341,284,240,349,228,242,362,353,245,246,56,136,137,139,134,142,60,61,144,62,254,147,231,255,148,64,152,153,154,155,367,389,70,157,158,73,235,161,266,373,75,77,333,165,209,167,272,166,277,278,280,281,382,383,384,178,84,85,386,180,387,388,285,310,184,288,363,290,346,293,294,295,181,186],creativ:[188,313,345],indeterminado:[110,367],use_control:[217,322,103,16],facilita:[61,26,144,142,307,14,1,341,20,78,363,7,121,93,16,384],hallo:[345,213],regenerarlo:19,getpropertypath:[],colocarlo:[],dificultando:193,support:[299,102,213,197,247,256,1,108,375,81,141,11,62,210,39,111,339,156,347],addtagformdeletelink:202,happi:339,avail:[245,239,70,178,199,108,261,141,292,241,111,293,327,347,87],width:105,resulten:153,solicitado:[272,231,0,341,331,84,204,25],wordpress:84,"establecer\u00eda":49,iterator_count:177,solicitada:[315,84,342,110,121,25,186,161],preferimo:313,importacion:[61,7],offer:[292,111,339],searchbycategorynam:229,seguir:[18,92,93,2,210,166,211,341,55,99,326,277,9,60,331,177,199,11,388,350,338,47,110,89,46,158,313,161],utilizast:[22,99,273,362],ensayo:18,renam:[233,289],pasast:[22,167],getpassword:[207,102,62,256,247],getfirstnam:[163,39,80],depura:[144,186,204],publishedat:28,depurar:[319,331,104,71,346,211],sonata_block_include_stylesheet:77,"logr\u00f3":[],removeupload:297,moderna:[14,8,84],liberal:345,splfileinfo:177,verbosidd:7,mirror:289,moderno:[84,213],ramita:[],"dise\u00f1ado":[84,213,18,389,331,75,342,93,386,142,16,181,9,222],liberar:33,encontrada:[222,197,311],leer:[240,1,163,76,77,78,241,346,211,384,4,341,121,277,305,313,177,145,222,331,180,153,386,334,41,337,92,127,392,128,232,363,338,14,108,202,344,204,16,71,158,49,297,186,48,161],onkernelresponsemid:[46,2],encontrado:[245,299,31,215,117,218,353],tenerlo:[109,166,367],role:[162,308,62,242,209,213,247,136,119,58,98,219,220,102,180,53,286,256,87,259,369,344,69,186],estupendament:150,leen:[213,357],utilidad:[308,200,130,145,71,186],roll:221,tenerla:186,"le\u00eddo":[337,62,315,92],treebuild:[153,193,365],twig_extens:270,intend:226,extrajist:121,"ren\u00f3mbralo":99,min_height:105,scale:166,modelo:[266,74,267,318,207,94,54,243,213,247,7,8,308,135,277,218,280,61,220,37,331,11,228,127,184,341,342,110,204,186,161],admin_bundle_blog_blog_cr:156,mirando:[241,222],lorem:[277,177,166],cercano:[359,206],domingo:215,sintaxi:[320,164,166,384,322,214,56,137,28,99,8,143,222,147,84,149,180,363,388,228,367,377,288,14,341,109,344,204,130,346,186,161],pbkdf2:[58,186],locationtyp:380,postpersist:[338,297,131,70,166],driverchain:[],incluida:[331,108,11,111,172,60,347],acme_mail:[4,117,353],time:[75,93,166,361,95,137,28,58,141,99,82,358,359,327,61,281,62,310,226,285,7,88,289,234,206,70,295,235,48,49],push:33,incluido:[128,108,204,247,14,199,84,202,184,145,259,111,341,186,211,254],puso:367,mydomain:[],pospongan:11,from_address:8,considerado:331,reiniciar:284,"agregaci\u00f3n":104,dividieron:60,dejando:[281,205],desactivar:[0,162,118,243,193,96,302,134,99,218,175,144,37,64,363,226,231,368,389,110,204,71],inmediatament:[322,145,337,204,109,331,15,342,349,64,99,326,383,386,211,70,186,48,161],especifiqu:[214,150,70,190,186,33],admin_bundle_menu_multilangmenunode_edit:86,getqual:375,viceversa:[93,72,186],millisecond:[],decid:[204,18,14,199,140,292,87,60,331,347,161],form_emails___name__:22,reprodujera:161,doctrinemongodbbundl:[338,26,388,166,114],decim:[277,82,166,270],vez:[91,92,93,2,238,94,193,362,99,7,273,199,104,286,299,200,14,15,202,110,204,313,18,19,145,20,319,22,23,211,25,26,322,213,31,326,121,327,33,328,222,331,125,226,335,228,127,337,338,341,234,131,343,236,46,47,49,51,349,242,135,56,248,205,139,58,142,60,61,315,146,148,180,153,366,367,259,368,260,304,70,72,73,161,266,342,77,62,271,166,98,277,382,383,384,84,64,288,363,389,346,297,186],splobjectstorag:142,cotejamiento:166,default_ttl:331,comun:[238,240,163,20,282,249,93,2,242,384,166,167,245,4,56,248,58,362,99,277,60,305,280,144,222,26,37,385,84,150,153,335,218,363,338,14,341,234,262,159,109,343,389,204,311,46,186,161],decir:[74,18,294,206,20,328,92,93,207,2,329,241,346,386,166,383,25,95,312,226,213,214,295,136,137,28,52,139,58,362,99,82,8,121,178,9,60,254,331,306,245,177,62,167,63,222,255,115,199,84,322,189,85,286,153,333,154,155,285,219,310,359,337,371,260,14,234,373,235,338,344,389,204,16,46,181,392,90,297,186,49],destruir:49,vea:[341,338,150,186,121,313,166],ven:180,setmail:[238,91,14,335,248,252,271,212],branch_nam:[],acabarlo:33,mysql_fetch_assoc:161,child1:244,child2:244,child3:244,heredan:[22,49],registernamespacefallback:[],getresult:166,getincrementalerroroutput:358,sub_request:[251,383,211],minuto:[281,62,331,145,285,121,305,242,313,235,49],heredar:[286,226,121],"eiqu\u00e9talo":367,anotar:[],exact:[327,170,141],cambiast:306,montar:[211,354],unsupport:376,querer:[255,60,18],team:[110,367],cooki:[307,222,138,237,331,84,343,30,98,194,226,142,242,386,375,47,186,49],guardando:[277,337,166,204],prevent:[297,335],gendertyp:362,exceptionmessag:344,sigu:[18,145,92,350,116,241,23,167,95,322,273,341,140,99,326,8,121,60,331,33,204,197,199,84,153,333,334,155,337,260,346,234,2,343,70,16,46,72,313,186,49],"act\u00faa":[383,384,331,19,93,363,386,46,346,166,161],cubren:[219,18],piensa:[31,253,305,204],prevista:176,habilitado:[144,383,213,96,247,367,297,264,370,153,110,121,204,302,218,252,211,361],addprefix:231,lazili:[],currenc:206,previsto:[286,241],habilitada:[193,302,37,256,31,343,218,186,367],current:[327,339,234,326,141,98,344,241,70,217,3,347],eventdispatch:[51,146,336,139,327,94,2,383,334,46,157,182,107],loadxml:142,useattributeaskei:193,db_time_col:30,comprendiendo:[121,16],generatorbundl:[321,341,16],indexada:46,variacion:383,pintar:[128,109,202,99,105,22],operacion:[245,383,213,240,289,202,286,343,293,243,388,49,135,129],modif:289,address:[12,112,64,93,99,391,380,9,347],balancador:[],along:[197,339,108,270,344,70],afirma:[250,343],"aj\u00fastala":49,examinando:308,createcli:[253,343,194,100,43,361],errorhandl:239,accountcontrol:[207,74],una_funcion:103,conveniencia:334,financiera:[93,75],provocado:47,asegurando:186,tabulacion:[363,288],anotacion:[17,0,349,93,165,209,166,135,213,302,119,98,121,32,218,220,37,150,180,225,226,223,299,388,66,366,278,350,27,231,259,338,346,72,297,186],localizar:204,"matem\u00e1tica":60,"_scheme":0,prefer:[170,145,99,194,226,182,313,327],"llamar\u00eda":153,escena:[109,20,211],ejecuta:[251,65,268,19,145,118,349,92,241,210,24,166,243,322,341,57,326,7,8,121,358,277,101,61,383,222,273,255,199,84,180,363,364,86,64,230,337,179,260,14,368,234,270,338,343,293,33,236,311,157,49,346,161],obsolescencia:89,countrycod:224,editcommentact:136,createfromformat:180,fake:[83,298,80],instal:[15,145,189,92,356,271,213,341,81,8,217,101,70,273,20,199,39,124,179,86,337,260,339,108,389,204,72,347,161],mejora:[213,27,363,248,279,11,99,319,384,271,33,49],setmessag:[],suceden:210,exclusividad:158,newslett:[14,259,143],recurrentement:177,app_dev:[306,144,169,222,341,199,145,104,322,121,242,87],desviacion:331,iscredentialsnonexpir:247,genericev:334,database_us:[115,349,30,326,16,277,166],scope:[286,234,141],tightli:[],analyz:[],addnodelist:142,domainobject:119,"mayor\u00eda":[266,222,298,18,20,219,92,93,2,384,30,166,135,167,375,341,136,138,134,99,8,121,60,10,144,383,204,255,331,149,256,286,153,226,334,337,350,367,299,200,288,363,14,343,110,111,46,157,158,161,186,49],beneficio:[130,319],asserttru:[182,194,343],"tratar\u00e1n":72,enhanc:347,persistir:[349,341,338,115,202,166,99,241,357,277,23,297,186],cuanta:[281,383,20,202,166,300,110,241,23,186],cuanto:[382,383,222,205,331,341,149,74,153,330,386,204,328,343,359,186,161],easiest:[233,156],content_typ:[343,84,222],examplecontrol:[231,0],controllers_by_typ:[110,367],pretend:[102,18,14,199,342,383,72,367],etiqueta:[61,359,266,294,206,318,350,319,383,21,22,117,210,211,167,245,4,322,181,213,56,355,97,7,29,362,99,82,344,121,353,32,251,216,60,305,280,10,176,329,204,197,26,351,178,331,295,125,85,310,330,225,154,157,341,66,127,285,367,218,287,259,13,338,14,108,67,202,270,385,109,343,110,293,304,70,44,71,313,113],subespacio:[225,201,118,153,8,158],whatev:141,twig_function_method:[],aliviar:20,obteniendo:[282,383,35,354,385,242,173,258,212],"s\u00fabdito":200,tuviera:[48,161],materi:[],absoluto:[247,139,64,351,16,367],"ejecut\u00f3":[119,48],nombrar:[4,341,331,84,153,311,161,313,167],encapsul:[],requ:[],adhiera:286,incrementar:[322,226],evita:[99,346,202],incremental:[],"1a31be6":33,"otorgar\u00e1":49,"ejecut\u00e9":157,apunta:[108,273,341,130,84,139,256,99,110,346,244],menu_nam:96,enlaza:[110,326,8,204],llegu:149,thenemptyarrai:193,fpm:169,colocar:[328,222,341,260,338,99,389,70,313,166,161],getcompos:[337,273,199,145,92,179],orderbypric:277,llega:176,wrapper_class:148,getcachedir:[306,233],invalidoptionsexcept:39,spot:261,addhtmlcont:142,"aplicar\u00e1n":99,dato:[189,92,93,300,2,284,191,95,192,96,97,98,6,99,216,10,102,197,199,349,286,12,13,14,108,202,110,204,16,312,113,18,206,20,328,318,207,22,23,211,26,54,213,28,30,326,121,32,327,220,34,222,37,331,333,226,334,228,127,43,229,316,337,338,130,341,342,111,131,343,133,355,46,237,49,51,267,241,352,242,362,55,135,247,136,137,138,140,142,357,60,360,144,62,146,115,256,363,155,367,359,368,260,67,70,157,370,235,161,266,74,315,77,78,375,275,254,210,273,166,82,277,361,280,176,383,384,178,84,386,182,285,310,287,288,290,346,187,293,295,181,297,186],emparejadora:211,date:[75,308,93,210,166,137,28,141,99,218,305,177,178,331,84,333,228,285,88,289,338,370,235,161],"a\u00f1adici\u00f3n":[],validado:[290,99,127,128],controlar:[91,300,164,209,210,167,322,193,213,58,99,98,23,25,143,176,219,34,319,283,225,226,65,388,228,367,338,364,204,186,49],checkhost:12,validada:[128,208],truco:[0,91,92,93,300,362,99,7,100,305,10,102,104,107,14,15,202,109,204,311,312,313,138,314,145,20,382,207,22,210,211,322,119,8,121,306,218,327,33,222,37,331,39,226,227,335,228,128,337,338,339,234,131,270,282,343,346,48,51,240,349,241,42,242,135,341,136,205,249,134,142,251,60,61,253,147,231,149,64,363,364,66,367,70,71,161,266,74,268,78,80,165,375,166,167,169,98,277,361,176,177,383,384,84,179,184,288,153,293,392,297,186],type_before_remov:319,sandbox:[245,246,213,339,199,156,41,244],subcollect:[231,0],callabl:352,ssi:197,controlan:[9,177,361],mezcla:[193,163,204],"conversi\u00f3n":228,blog_post:135,experimenta:70,principio:[1,92,241,99,166,211,341,136,139,250,121,357,252,331,175,382,319,385,41,337,390,158,313],autoexplicativo:111,adaptarlo:[326,110,213,341],citado:[286,363,288],"petici\u00f3nla":[],ttl:[331,318,197],gitignor:[145,337,33],treatfalselik:193,symfony_cmf_simple_cm:[218,24,347],"est\u00e1ndar":[180,372,268,1,145,177,315,92,350,383,241,80,114,242,23,24,211,384,255,26,322,214,341,331,334,58,6,99,326,8,121,313,358,60,204,33,174,219,176,144,102,151,35,273,149,148,199,311,124,64,349,11,153,259,386,125,218,367,184,337,288,363,389,14,201,342,318,343,344,70,16,158,47,186,227],ofreciera:[84,18],disconnect:[],my_servic:[153,293,330],othernam:58,excesivament:222,conlleva:[22,121,89],teniendo:20,notreadablemessag:128,"asignaci\u00f3n":[267,0,349,93,241,351,80,166,135,213,274,356,99,78,101,148,363,388,66,231,288,338,202,182,391,204,346,161],entrada:[266,222,51,268,298,52,314,234,242,206,76,355,326,92,341,190,281,208,22,346,210,271,211,167,96,248,136,137,28,97,139,7,99,82,8,121,216,359,236,33,61,176,220,163,204,331,84,295,286,153,65,337,44,285,235,128,367,184,232,338,14,108,67,202,45,145,249,70,16,158,297,186,161],getcontrol:[157,383,211],reveal:[],matcher:[231,383,0,205,180,226,211],comprend:[297,146],nation:58,"cr\u00e9dito":[126,376,215],"memorizaci\u00f3n":[144,197,19,104,77,300,226,242,331],macvim:226,comprens:213,symfony_cmf_cont:[317,326,110,218,347,367],"simb\u00f3licament":[8,204,341],role_blog_admin:186,aleatoria:[186,197],determinar:[19,41,20,282,77,2,383,80,211,96,341,57,249,99,243,60,33,144,315,118,331,256,286,226,105,230,184,260,108,342,45,290,110,293,111,311,46,49,346,186,161],revers:[61,7,308],customertyp:380,soportan:18,separ:[329,178,58,141,154,294,339,181,85,271,347,212],actualizada:[331,20,241,386,297,166],fabian:[],determinan:[],annotationdriv:338,complex:292,caminar:[],aplana:33,actualizado:[331,241,204,277,297,166],veint:84,compil:[4,282,213,335,234,322,330,319,351,16,328,117,353,212],getdisplai:[61,7,35],cookie_httponli:226,organizan:[14,60,204],salada:102,handlerespons:375,"experiment\u00f3":157,acmemainbundl:[315,273],organizar:[341,328,222,18,14,171,125,134,93,111,16,181,60,305,48],hellowsdl:9,contentrepositoryinterfac:[110,342],permanec:[98,84],intermin:[],autocaga:[],renderexcept:268,revisemo:[186,204],"redise\u00f1ado":161,authenticationexcept:[62,139,186,256],utilizaban:8,"autenticaci\u00f3n":[284,189,53,102,242,25,247,139,58,98,194,293,100,219,220,62,196,256,260,186,343,69,157,159],internet:[331,84,305,56],route2:[231,0],route1:[231,0],rootdocu:326,apikernel:87,bootstrap_clear_cache_env:371,tienen:[175,74,0,18,314,206,20,92,93,207,2,253,23,166,167,245,322,375,136,137,28,138,391,285,99,82,8,306,60,331,33,319,10,281,219,102,222,37,212,266,359,157,286,337,336,240,107,350,367,231,259,200,215,338,14,108,310,235,109,343,293,204,295,46,71,158,346,186,49],quita:[344,184,14,202,356,238,386,335,22],envelop:9,unpublish:[],resuelv:[282,146,96,14,84,99,8,211,148,346,33],test_project:[],"afirmaci\u00f3n":[],templates_by_class:[110,24,218,347,367],project_error:169,minimizar:[322,40,248,189,377,71,271],session_start:386,"byte":[389,128,360],render_templ:161,"amar\u00e1n":204,reusabl:81,setdefault:[380,74,170,39,202,362,99,110,228,327,367],pareciera:25,ordenar:177,"funcion\u00f3":[],router:[0,205,300,99,165,25,96,56,81,37,98,222,273,255,331,226,367,231,14,341,342,186,110,204,16,346,90,347,161],rompan:322,atraves:208,oper:[286,9,301,86,70],mucha:[238,18,1,335,177,77,2,346,117,375,166,211,167,322,193,341,389,138,134,99,8,388,305,144,383,222,312,331,84,150,125,153,65,105,200,338,14,112,342,109,343,344,293,89,204,16,46,71,47,161],widget_attribut:167,onc:[282,199,322,310,292,142],mucho:[266,222,384,18,1,145,20,349,92,242,2,383,344,22,346,209,362,271,167,322,375,247,136,248,138,338,6,99,8,121,142,313,311,60,204,33,319,240,281,219,62,111,166,178,331,84,150,153,226,157,341,366,278,134,218,337,363,260,14,130,342,202,109,343,110,89,70,16,46,71,47,186,161],reopen:152,voto:[281,219,186],apoda:166,vote:[219,392],"consistir\u00e1":256,open:[245,226,81],"__construct":[0,138,91,350,2,102,39,94,117,375,271,353,170,247,248,268,362,9,278,252,327,176,62,330,166,221,153,334,228,66,366,231,259,14,234,202,46,157,392],decorada:[56,84,49],adjunta:[31,375,138],convent:[261,81],"reenv\u00edo":222,"est\u00e1n":[222,284,0,138,294,75,308,77,281,329,21,228,375,386,166,135,167,322,193,213,341,240,383,99,7,8,121,211,388,344,251,60,252,204,319,61,176,144,62,226,111,254,37,178,331,85,11,153,323,154,181,286,200,182,92,367,231,278,88,368,14,67,202,90,343,110,145,337,70,16,71,47,186,48,49],"reenv\u00eda":58,adjunto:[336,67,32,134],access_denied_handl:58,soluciona:[331,186],empiezan:[219,349,186,166],citi:[93,34,380],alivia:388,pdo_sqlsrv:148,subdividida:386,conveni:226,addviewtransform:228,includ:[342,206,242,245,322,169,213,341,331,137,28,81,82,359,305,70,147,199,310,285,87,339,201,108,261,204,295,313,235,347,161],provino:383,rompen:[179,33],programar:20,profiledata:254,ingres:[],symfomi:263,envolviendo:60,typevalid:352,registren:330,necesiten:[166,186,271],iceberg:121,addmodeltransform:228,securereturn:119,rehac:[],param1:193,futura:[268,234,135,18],futuro:[62,289,331,2,111,46],conn1:[148,388],blueprint:[],sai:[253,326,311,251,9,313],controlada:[8,337,48,92],test_numer:[303,148],sal:[157,102,256],setabstract:[238,335],"m\u00e1gico":94,ayudart:[315,20,92,241,22,23,166,191,168,193,213,341,7,326,135,61,145,273,338,156,204,186],siendo:[238,200,18,331,84,45,8,386,335,9,367,186,161],argument:[238,91,335,350,94,80,164,117,362,271,353,212,170,248,140,81,30,7,32,9,143,327,61,176,282,62,221,256,153,86,41,228,259,289,14,234,344,293,39,70,252,157,392],arreglo:[247,0,93,2,190,193,99,7,305,308,102,103,310,299,376,14,202,109,204,16,222,19,177,208,22,117,210,211,212,213,28,8,121,219,329,319,331,226,334,42,336,127,231,56,342,343,346,49,350,245,341,356,142,254,128,148,256,153,154,367,263,157,72,235,161,373,163,80,375,166,167,378,380,172,175,282,383,384,178,84,85,386,285,184,288,289,389,187,391,294,181,363],ayudarl:[],construida:[26,383,319,1,84,20,330,211,161],profusament:121,documentroot:[169,6],construido:[328,193,273,260,315,383,84,367],digamo:[52,67,140,92,286,153,228],pertinentement:281,browserkit:[194,107,180],sat:84,extremadament:[286,336],"reducci\u00f3n":130,captado:328,convirtiera:228,pdodefinit:30,note:[281,322,273,339,108,261,141,110,347],getdql:[],anexarla:99,nota:[0,93,2,3,298,5,302,6,99,7,194,9,305,306,307,102,197,199,11,278,14,201,108,202,109,110,204,16,313,256,205,145,20,282,318,207,319,21,164,117,23,24,211,25,322,213,214,326,8,121,353,32,217,218,362,327,33,219,222,331,311,124,224,225,226,227,71,42,336,43,231,338,130,341,234,270,343,46,47,49,238,239,335,349,241,242,134,135,246,247,136,58,141,142,251,60,143,61,144,62,361,146,255,115,149,150,180,153,154,65,66,366,367,259,215,368,289,156,70,339,157,158,73,161,266,74,315,342,77,78,22,80,375,271,167,169,273,81,166,98,380,277,212,176,177,383,384,283,178,84,85,179,386,64,182,87,310,184,288,363,389,346,264,186,292,293,89,294,181,297,90],take:[170,199,234,58,81,141,111,358,270,297,327,347,212],orderbynam:277,bcrypt:[58,186],noth:[81,87],coincida:[231,177,323,337,222,96,247,283,28,341,186,226,92,346,235,367],funcion:[61,267,18,314,370,189,219,318,93,352,209,375,166,211,167,26,377,56,303,366,138,295,99,7,8,121,142,172,60,100,305,360,10,308,383,361,196,273,255,148,199,84,224,386,240,43,194,350,371,200,130,171,262,270,109,343,344,304,204,14,158,161,297,49],savehtml:142,request_match:58,buffer:[358,382,375],cualquier:[0,91,189,92,93,300,2,284,191,97,98,6,99,7,216,305,307,115,103,199,11,106,107,200,13,14,108,202,109,110,204,16,113,15,332,18,314,206,20,282,318,207,319,22,117,23,211,222,321,322,213,214,28,29,326,8,121,219,220,329,35,37,331,311,293,354,226,228,127,231,337,129,338,44,247,342,270,343,344,355,46,345,346,49,341,51,349,351,242,362,135,244,56,136,137,58,356,134,142,60,252,61,144,62,166,148,150,64,153,154,65,367,259,260,289,67,68,70,157,158,235,74,80,165,375,209,167,210,359,271,82,380,277,278,175,281,177,383,384,178,84,85,179,386,256,181,285,310,184,287,288,363,389,145,294,295,188,392,297,186],"r\u00e9plica":388,homepag:[222,338,84,186,277,106,346,166],limpiament:18,textarea:[88,99,380,287,127,327,167],usuario:[1,189,93,301,190,3,303,97,98,6,99,7,216,100,102,349,11,310,13,14,108,202,110,204,311,113,222,18,314,206,219,207,116,22,209,23,25,322,213,28,29,31,8,121,218,327,33,220,329,111,331,332,228,127,338,130,247,342,45,344,355,48,49,341,284,240,267,241,242,245,56,136,137,138,139,58,358,60,252,61,145,146,255,256,153,154,366,367,259,260,369,67,69,70,44,71,158,235,161,74,77,62,375,359,82,175,177,383,283,178,84,85,386,285,286,287,293,294,295,181,392,186],phil:331,"perfecci\u00f3n":204,sale:[11,363,104,384],emparejamo:312,templatenam:10,componentsecur:[],auto_start:386,dolor:[277,177,20,166],model_class:[213,101],salt:[102,58,247],round_down:[359,295],seria:[346,92],joinwithcategori:277,flashmessag:[242,222],some_default:350,phpcr_pass:70,subprocess:358,subproceso:[358,145],createphp_attribut:213,cronograma:11,apoyado:[78,180,70],loadprofilefromrespons:211,xml:[298,91,93,300,284,190,3,191,95,193,5,302,303,240,6,99,195,9,100,305,10,102,103,199,105,106,299,278,12,376,14,112,108,202,110,111,16,313,257,222,205,115,319,208,164,117,210,211,25,200,322,54,213,118,324,36,30,8,121,243,32,306,122,327,332,204,123,37,331,311,38,125,126,330,40,226,227,71,228,72,230,128,338,130,247,234,131,45,343,225,249,248,346,48,341,50,238,52,335,349,58,241,351,352,242,362,55,135,56,136,57,140,141,250,142,251,60,143,360,144,62,254,147,166,148,149,180,153,155,367,259,252,369,68,263,264,70,339,157,158,73,370,371,266,353,162,373,269,78,333,79,80,165,270,209,167,197,292,81,271,98,277,212,175,176,382,383,384,283,84,323,86,64,388,134,183,185,363,291,90,187,391,293,347,392,297,186],userdata:102,slow:[194,81],injectparam:[66,221,366,278,302],transact:[126,376,221],activ:[240,289,247,292,86,204],intencion:[46,153,8,166],volverlo:99,desaconseja:132,estar:[266,18,91,269,219,350,354,2,211,193,5,247,139,99,326,121,252,33,144,62,273,331,153,226,213,128,338,14,257,341,131,389,293,236,46,72,49,370,186,161],localelisten:293,isprocess:94,getmessagecount:43,genera:[0,18,19,118,241,210,166,135,384,322,5,341,274,57,205,99,344,243,277,305,306,144,102,222,197,331,363,367,230,231,338,15,110,293,204,297,90,161],"cumplimentaci\u00f3n":[],addrefer:23,llave:[288,350,363,121,22,305],pensado:16,requir:[347,294,19,206,349,92,242,346,329,241,21,326,22,23,24,167,194,246,341,355,97,7,29,141,99,82,156,216,81,217,60,327,101,61,39,226,254,283,255,124,199,84,104,85,224,354,323,86,181,310,106,66,127,367,277,359,287,371,13,339,338,44,15,67,202,109,110,337,70,295,154,161,297,178,113],acmefoobundl:[71,322,40,225,130],mi_controlador:264,generateurl:[222,338,346,202,93,99,242,277,297,166],serializerbundl:[213,101],getstor:331,admin_bundle_blog_blog_edit:156,clave:[266,222,238,0,375,18,348,1,145,212,177,77,242,319,284,254,346,22,117,210,386,166,135,167,245,26,322,193,197,56,138,383,249,99,98,8,121,243,178,60,100,305,384,144,62,204,103,148,331,256,317,310,153,226,334,335,341,127,231,218,288,363,338,14,247,342,389,343,293,304,70,312,157,158,47,186,49],asertiva:93,where:[169,247,108,58,81,327,326,156,70,297,166,161],whoami:145,methodinvoc:221,myservic:[119,225,330,153],fileloc:[231,0,248,299,153,271,319],jsr303:93,emailformatt:[238,335],formview:[109,182,266],getroutedefault:[110,367],deseamo:[],prototipo:[193,103,58,202,153,301,226,388,22,167],maxwidth:105,aleatorio:[360,67,27,211,186],contenido:[247,222,18,1,315,317,318,77,341,326,22,375,24,135,167,322,213,96,56,138,140,134,98,121,211,142,358,9,60,19,10,177,383,70,197,255,331,84,349,244,86,204,43,367,218,14,108,342,305,343,110,89,111,249,346,186,347,161],create_routes_typ:213,clientipvot:392,setenableparsephpimport:[],admin_bundle_routingextra_route_cr:86,vender:129,mappingexcept:326,entendiendo:[340,234,186,167],apoyamo:70,defaultcommand:236,precalentador:293,renombrar:[306,16],sortabl:168,agradablement:152,permitindo:[],screen:[71,244],punto:[18,91,206,92,2,383,346,375,271,211,167,4,322,213,295,248,138,139,249,6,121,353,142,293,60,305,101,319,219,221,204,273,84,150,163,286,363,359,65,184,337,288,289,389,14,341,145,33,70,16,46,157,158,161,313,49],marcarlo:338,elijan:98,"gener\u00f3":[226,211,388],uuid:70,conmutaron:[],db_host:[349,70],"har\u00e1n":331,mani:[61,322,202,81,327,7,60,166,347],mano:[281,136,202,99,121,228,182],publishstartd:308,widget_container_attribut:362,sentirt:16,symfonycomponentvalidatorconstraintvalid:[],copiando:[204,341],definen:[176,226,0,231,14,84,341,99,121,204,157,60,167],emparejan:[106,342],considera:[341,308,62,384,363,19,84,109,2,364,89,204,46,313,331,167],emparejar:[231,144,315,342,159,326,110,211,312,106,210,346,186,160,367],basaron:[],cuadrando:[],securedcontrol:16,twig:[189,93,300,301,99,193,96,362,304,305,10,308,103,310,14,201,108,202,109,110,204,311,313,315,207,22,209,24,25,26,322,213,326,8,121,218,328,329,222,37,331,16,40,226,42,230,130,341,234,270,344,346,347,52,242,353,245,246,56,134,60,144,63,147,149,64,153,154,197,367,68,156,70,339,71,158,161,266,74,77,167,273,98,280,178,85,179,86,180,377,293,294,181,297,186],hellobundl:[238,78,241,351,23,341,303,248,134,380,143,175,222,148,332,64,153,388,259,338,14,56,234,391,158,346],"min\u00fascula":[4,128,84,153,2,225,46,158,353],entregar:[14,284,134],confiamo:311,detallar:144,breath:[],is_authenticated_fulli:[219,98,186],threshold:284,"presentaci\u00f3n":[206,341,84,202,93,99,204,33,161],entregan:[],form_div_layout:[68,99,167,266,109],revertir:[11,33],tomen:286,documentando:[313,372],csrfprovid:76,especifiar:375,"redirecci\u00f3n":[342,222,198,234,331,189,64,186,343,110,121,83,55,211],thousand:[],creo:20,getmessageparamet:[],"cronolog\u00eda":152,observa:[341,268,222,18,331,16,99,2,353,204,109,46,354,166,363,288],formev:[146,327],bonjour:60,"clonar\u00e1":273,my_form:[66,343],passwordleg:93,rueda:[326,51,134],sufijo:[128,177,0,231,118,350,153,204,388,158,35],pobr:342,"t\u00edtulo":[56,140,77,31,326,215,111,218,33],contestast:33,cree:[215,354,14,58,8,166],my_context:58,hash_algorithm:58,context_kei:58,gettoken:[136,221,361,186,327],zipcod:[391,380],utilitaria:375,pre_send:390,convinc:339,fromaccount:136,"sentir\u00e1":[14,121],ambient:[177,20,90],symfony_cmf_bundle_menubundle_document_multilangmenunod:245,filtrado:[177,343,142],ascii:[375,138],curl:[179,199,145,273],forzosament:[305,56],favorite_c:22,corregir:[11,89,33,107],data_dir:148,isact:247,"requerir\u00e1":18,asset_vers:344,cyan:[61,7],vimo:[341,338,84,202,318,16],subdomain:231,all_bundl:165,symfonyfan:142,confirmado:[337,145,20],jmsdiextrabundl:[26,17,124,225,21,114,366],extern:327,"continuaci\u00f3n":[74,238,76,78,207,241,351,94,117,54,271,353,25,321,322,232,56,248,98,166,99,7,121,9,305,61,370,332,125,11,179,335,286,228,127,229,93,200,153,338,313,247,202,343,293,89,157,297,186,161],confirmada:215,costa:[11,146],estamo:[1,331],reflejado:282,phpprocess:358,my_command:236,costo:[389,319,70],metadatabag:49,plegado:[363,313,288],prefija:[13,163,350,2,46,158,33],emitiendo:166,rolesecurityident:286,prefijo:[0,93,6,166,243,354,362,326,218,33,148,226,388,367,231,389,201,338,343,158,346,186],category_id:[277,166],dimension:142,"falsificaci\u00f3n":99,nosql:18,vamo:[74,40,200,338,205,207,14,341,202,92,78,99,2,8,293,322,16,46,23,186,161],resp:[245,349,70],listcommandtest:[61,7,35],remembermetoken:219,rest:[99,62,202,180,213],custom_first:78,habilidad:[146,18,14,300,139,125,78,153,8,293,72,327,319],filter_var:[375,138],is_cal:[46,2],protegiendo:[242,220,259,186,98],"apoyar\u00eda":213,hasdefinit:[117,282,353],sebio:89,littl:213,access_denied_url:58,save_path:[226,49],stopwatch:[152,159],localebundl:339,categoria:181,rompa:33,around:[245,213],dars:201,validatedigest:62,extensioninterfac:319,dart:[328,383,35,341,145,286,121,334,49],sumo:[206,287,13,295,216,44,97,67,355,29,85,82,329,154,294,178,181,359,127,113],addargu:[61,176,282,35,248,7,330,9,271,212],darl:[315,337,273,341,84,202,92,11,166],aspecto:[17,0,18,23,353,167,341,205,30,98,121,25,221,222,84,153,364,231,346,390,204,297,186],world:[56,218,222,138,84,375,77,326,293,142,358,9,60,346],porcion:[341,60,305,204,240],"llevar\u00e1":[341,74,15,297,18],suma:[242,343,62,69],pon:[343,145,127,388,367],"t\u00e9rmino":[367,74,207,260,84,99,110,121,204,345,188,60,166,161],enero:215,knp_menu_rend:[108,96],integ:[74,268,314,373,206,355,79,352,190,166,193,247,137,28,97,287,30,99,82,216,122,359,123,226,387,105,88,285,277,183,185,13,290,291,295,241,297,235,113],proporcionart:343,afectado:[130,345,188],fixxmlconfig:193,manag:[175,322,62,156,303,148,1,388,115,58,301,326,110,261,70,339,217,392,23,327,342],yyyi:[137,28],personalment:[84,341],resuelva:[],providerkei:256,abordar:[161,18],"multiplicar\u00e1":206,pieza:[341,210,18,331,84,58,350,99,293,204,277,167,346,135,161],islocalus:366,aplicalo:126,type_optim:319,satisfecho:161,excelent:[62,14,331,343,71,33],exif:130,ataqu:[62,166,99,226,204,186,161],hoja:[341,322,56,260,240,189,377,121,204,16,71,305],definir:[341,222,238,0,18,314,189,177,77,299,354,2,102,307,94,166,211,25,193,96,56,136,119,28,140,267,362,99,7,8,277,278,61,281,144,62,204,283,84,150,223,317,153,65,335,392,367,231,200,14,108,270,249,70,137,46,158,371,346,186,161],definit:[238,91,30,62,351,164,117,362,271,353,212,193,249,81,141,9,143,327,282,102,319,385,153,330,335,259,338,14,108,234,131,270,292,293,204,252,328,157,392,73,159],validation_group:99,level_nam:176,cuida:[331,8,161],referiremo:14,exit:[186,268],agravio:129,trans_default_domain:[60,344],coincidir:[231,0,341,342,298,310,8,121,242,66,346,222],power:[342,70,141],pdo_sqlit:[273,131,166],ofrecen:[389,92,186,161,56],"in\u00fatil":90,"adem\u00e1":[0,189,2,298,193,6,99,305,308,102,197,286,105,14,108,202,110,204,311,313,18,314,145,207,319,21,22,209,211,25,213,214,30,8,121,32,218,33,222,331,221,224,226,334,231,338,342,343,46,346,240,348,349,242,54,341,136,248,60,252,147,362,64,152,153,364,66,366,367,368,67,263,69,70,157,73,370,161,266,77,375,166,273,98,83,383,384,84,363,187,391,293,16,186],starttim:235,"__name__":[22,202],"dar\u00e1":[46,338,367,353,341],acmearticlebundl:204,presta_cms_page_edit:245,isset:[175,371,39,153,334,161,297,167],auto_reload:68,sizevalid:290,"tendr\u00edamo":98,pudiendo:62,encoderinterfac:293,addconstraint:[80,45],acm:[93,2,190,3,95,4,193,303,362,99,7,194,195,9,305,10,102,105,12,200,14,112,202,204,16,257,222,118,207,208,376,23,72,25,214,324,36,326,8,121,353,32,122,218,327,35,254,123,332,38,126,333,228,43,229,128,338,339,247,234,131,45,343,249,236,46,346,341,50,238,349,58,350,241,351,352,242,54,135,56,136,248,140,250,251,60,143,61,62,146,147,148,149,256,153,155,366,259,260,263,70,157,158,161,266,74,268,373,269,78,79,80,270,166,167,170,81,98,380,277,175,176,383,84,387,388,182,183,184,185,290,291,186,187,391,293,181,392,297,90],acl:[220,162,136,145,189,58,286,392,69,209,186],mylazylisten:2,viniendo:84,act:58,"proporcionar\u00e1":[164,143],ingresar:[247,123,58,186],"demostraci\u00f3n":[273,205,255,199,315,350,121],rss_controller_class:246,"estar\u00e1n":[242,127,70],realpath:233,effici:339,deserializar:72,php_auth_pw:[343,100],status_cod:311,recorrido:[46,343,2,177,142],reflexion:77,mensaj:[189,93,190,3,95,99,7,195,9,310,105,12,14,257,16,112,314,206,117,214,324,28,36,121,32,122,33,222,123,331,38,125,126,333,226,227,228,127,43,128,45,133,237,48,49,50,284,241,352,242,54,137,134,250,60,252,61,254,64,363,155,258,259,260,263,264,158,235,161,373,269,79,376,167,171,359,82,172,361,176,382,384,84,386,387,285,183,185,290,47,291,186,187,295,90],minombremetodo:225,ayuda:[266,222,88,214,96,338,14,1,20,31,363,8,16,337,384,24,166,33,167],aceptada:33,otro_filtro:103,"apoyar\u00e1":[],setlastnam:163,her:332,lanzar:[231,383,0,314,342,221,139,256,226,228,211,222],from_email:[382,264],role_super_admin:[242,219,186,247],registrador:[176,328],sendemailact:[14,43],lanzan:[331,390],satisfactorio:[93,58,25],"desv\u00edo":136,hei:343,completa:[266,222,284,384,0,18,314,315,118,317,93,319,388,117,24,55,146,283,96,268,58,99,7,142,25,204,33,328,383,35,103,331,84,349,179,226,345,231,184,363,368,342,109,343,111,311,188,158,49,346,161],bottl:289,destello:62,modificar:[306,74,268,205,294,206,355,77,207,2,329,351,166,211,167,312,323,213,341,331,137,28,97,383,249,29,362,99,82,216,251,277,359,327,33,98,219,145,226,146,254,178,199,295,150,85,286,153,154,127,285,287,129,13,300,338,14,67,202,390,235,343,293,204,44,46,181,346,186,342,113],bundl:[189,92,354,4,96,99,194,9,305,101,307,103,198,199,108,202,110,204,311,312,314,118,207,21,23,24,211,35,321,322,323,213,326,8,121,217,218,222,37,331,221,124,330,42,43,229,337,338,339,56,342,343,344,346,347,341,349,241,242,134,353,244,245,246,247,136,140,356,141,60,62,255,149,150,180,153,367,260,68,156,70,157,158,161,74,268,77,165,166,210,81,277,175,383,86,388,87,184,293,16,297,186],completo:[222,375,18,342,1,20,93,300,319,383,352,242,23,166,167,322,193,213,214,56,58,134,99,344,121,348,293,60,173,175,329,204,331,149,150,64,286,354,210,125,228,338,14,108,234,156,69,70,311,181,158,186,49],modifican:[19,204],aceptado:[307,74,375,207,84,99,210],"proporcion\u00f3":[314,256],enablehttpmethodparameteroverrid:[226,298],congratul:242,phpcrbundl:[326,349,70],pull:[213,261,151,89,70,313],enlac:[240,145,22,116,242,211,56,362,142,305,306,281,177,199,84,180,226,345,289,202,68,343,344,204,188,346,186],seleccionar:[245,329,314,178,85,343,154,294,181,33],quedars:193,isgrant:[219,259,330,136,139,286,98,293,209,186],preconfigur:[],seleccionan:240,replacexxx:47,ismethod:[93,99,297,202],crear:[189,92,93,300,2,284,94,192,6,99,7,9,305,10,102,199,286,277,14,15,202,110,204,16,313,138,145,115,282,319,22,117,23,211,222,213,30,326,8,243,32,306,327,220,35,331,311,125,227,335,228,337,338,340,247,234,131,270,343,344,46,386,353,346,341,238,52,349,249,350,241,351,362,135,245,56,136,248,18,140,142,251,60,143,61,144,62,146,118,149,180,153,258,367,260,252,156,70,265,157,159,161,266,74,268,342,77,164,374,80,375,275,167,166,172,280,175,281,177,383,178,385,84,86,256,182,87,297,390,186,293,296,392,205,90],conozca:[],"cuesti\u00f3n":[219,14,125,299,99,2,46,60,186],escapan:60,creat:[213,74,375,138,342,163,115,267,58,207,22,30,182,135,194,246,170,140,81,141,99,326,110,121,243,277,83,327,101,62,197,273,166,178,199,39,293,189,349,286,271,228,66,87,289,338,339,108,234,131,270,292,156,145,70,345,347],certain:347,loadfromextens:[247,52,115,144,78,62,6,166,211,25,322,40,56,136,58,30,99,98,134,60,100,175,176,382,102,167,319,147,37,362,331,64,153,226,227,341,93,306,259,200,303,14,108,131,68,292,343,110,347,204,130,71,392,346,186,48],mundo:[152,319,18,331,84,85,11,99,2,341,46,277],"migraci\u00f3n":[47,360,20,166,241],caracter:[138,67,350,79,208,375,166,211,323,250,7,32,122,177,254,364,387,93,183,290,342,391,158,186],crean:[238,193,335,289],objectidentityinterfac:136,feedurl:[],googl:[92,227,52],taskcontrol:202,reciben:[51,142],getorigin:152,overrideglob:[375,138],"discuti\u00f3":11,apoyart:99,alohaeditor:[],writabl:386,getdescript:202,pedir:[117,73,89,135],conectada:336,corrija:33,proporciona:[0,301,191,298,193,5,96,7,305,101,308,197,199,286,200,14,201,110,204,311,312,18,314,317,24,211,330,322,213,326,121,218,33,222,331,16,224,72,231,338,56,342,111,343,344,346,49,239,348,349,242,244,245,341,205,58,250,142,60,360,61,62,149,152,153,65,367,289,69,70,71,158,161,268,163,77,166,168,98,219,383,84,288,363,389,293,392,186],allowoverrid:[169,6],conectado:[98,84,115,49],inventar:186,maxlifetim:49,restringir:[177,259,213,136,219,338,186],knp_menu:[108,96],proporcionamo:342,prudentement:186,helpcommand:236,cookie_domain:226,mask:136,mimic:[],"p\u00e1gina":[341,74,315,18,1,145,189,317,77,207,383,22,55,211,25,26,213,56,331,166,139,326,202,99,98,344,121,142,251,60,204,242,368,282,62,35,222,273,255,316,199,84,104,64,349,223,179,259,386,180,345,92,367,218,337,300,260,346,108,111,305,68,343,110,89,70,311,328,188,161,313,186,48,49],"todav\u00eda":[266,238,240,342,1,20,242,383,241,21,22,166,211,319,193,247,139,99,326,344,353,278,100,19,33,306,382,221,222,255,331,84,64,11,153,65,335,182,367,368,338,346,234,202,110,293,16,73,47,186,161],"analizar\u00e1":213,deje:[322,186,222],"quedar\u00e1":297,cpu:331,estrictament:[11,50,257],"establecer\u00e1n":99,consider:[136,331],poners:11,illustr:347,ansicon_:[],yaml_dump:344,wsse_secur:62,configuraremo:[],"pas\u00f3":228,ponerl:[],mezclar:[288,363,121,70,60,166],analic:[363,318],scp:20,undominio:58,text_error:167,cartero:9,fromarrai:182,rewrit:169,redirect_control:[110,347,367],userpasswordvalid:3,aplican:[286,337,109,93,99,210,186],estructura:[18,145,20,220,92,350,241,165,24,275,135,321,193,341,136,57,356,8,121,218,306,144,222,189,151,349,286,363,386,230,118,337,288,260,108,338,111,16,158,346,161],aplicar:[266,18,189,93,208,117,54,167,322,193,109,99,172,60,176,286,179,40,228,377,342,187,293,71],completament:[284,18,145,219,92,383,80,209,166,167,40,213,341,8,32,277,204,101,282,315,222,331,84,286,153,225,226,66,337,346,202,305,343,293,111,158,297,186,161],getconfigur:153,introduc:[61,306,298,295,314,137,28,206,285,310,99,82,204,16,359,313,235,161],felizment:204,"pas\u00e1ndo":383,proteja:186,"inclusi\u00f3n":[213,331,318,186,179,204,242,305],"represtaci\u00f3n":362,abstractauthenticationlisten:[62,293],sessionnam:70,isfullyauthent:209,entiend:[341,62,318,142,16],creando:[61,74,284,266,1,145,316,220,77,93,207,2,320,356,326,346,209,134,275,383,146,26,210,273,56,136,192,276,267,362,99,7,380,341,32,277,60,173,204,280,319,10,144,102,63,222,166,312,385,149,64,153,86,125,105,228,92,366,305,128,337,140,338,14,108,375,202,131,270,282,133,343,374,293,249,111,311,46,157,392,313,186,347,161],appart:[],harri:253,last_nam:[61,7,222,167],min_hegiht:105,adjust:[],larga:[322,329,88,288,240,294,363,2,154,204,228,46,79,33],sana:[],small:[105,111,87],require_onc:[306,341,144,319,205,389,201,15,104,16,73,331,161],largo:[183,387,341,290,391,350,2,204,172,46,122],repositoryclass:[338,166,247],"habr\u00e1":[136,346,93,389,297,353],pase:[4,328,222,266,314,14,340,341,189,300,2,293,351,228,157,117,385,319],manifiesto:18,pasa:[238,314,342,315,328,77,93,242,2,383,79,346,190,376,23,211,319,310,210,213,139,140,362,99,172,60,100,297,33,382,62,222,370,84,126,153,335,286,228,366,367,128,183,14,234,305,343,110,293,252,46,161,47,49],using_compon:[],"empezar\u00e1":[14,326,20],"recepci\u00f3n":186,inferido:99,definido:[0,138,91,388,115,350,383,351,30,166,211,167,375,56,269,362,99,7,8,172,60,305,175,177,62,222,148,331,84,150,153,212,182,277,259,200,338,341,204,16,186],pass:[342,193,80,142,273,339,39,234,140,327,319,110,86,70,335,170,186,33,87],definida:[238,18,77,93,2,166,211,25,5,56,303,362,326,121,32,281,37,148,331,84,150,257,335,14,201,354,342,110,204,46,158,346,186],is_:[39,352],defaultfals:193,"ll\u00e1mame":16,sessionstorageinterfac:211,deleg:[81,244],"causar\u00e1":[231,127,0],acmetestbundl:341,"decoraci\u00f3n":56,section:[245,322,218,239,247,234,108,212,152,110,39,70,41,172,156,339,87],fallado:128,testsearchbycategorynam:229,traducirlo:99,delet:[84,298,136,119,331,221,202,141,286,343,145,243,70,346,277,297,100,186,135,166],potencia:121,pagodabox:20,method:[74,238,239,0,91,163,212,140,350,22,2,383,80,346,94,343,166,3,211,25,170,354,248,58,81,141,99,98,142,358,83,143,327,176,282,39,226,204,197,37,221,298,150,180,152,251,86,234,335,271,164,87,231,207,338,14,233,67,202,131,45,109,165,264,293,249,70,252,157,297,186],goutt:142,explicaremo:[14,204,99],hasn:313,getdigit:[375,138],hash:[102,288,363,204,157,186],ignoreannot:166,denominar:60,"localizaci\u00f3n":60,filterbeforesendev:390,aquello:[308,319,224,334,277,47,166,49],transportar:117,aquella:383,"permitir\u00e1":[62,14,145,64,392,186],cargalo:15,erase_credenti:58,domnodelist:142,"subversi\u00f3n":[337,92],sociar:[],serializar:[10,72,383,186,247],turkish:[],setmetadatadriverimpl:[],transparenta:93,prior:[292,213,347,87],phpcr:[18,1,349,77,245,213,96,325,140,141,326,156,218,308,70,273,255,199,86,41,367,339,108,342,110,111,312,345],pick:[339,33],action:[74,298,314,234,207,2,346,22,25,245,56,81,141,99,98,264,142,242,61,176,382,222,197,331,43,367,230,300,339,67,202,109,156,204,46,157,297,186],httpcoremodul:341,via:[273,240,39,20,310,217,72,327,87],unconventionalextensionclass:153,vie:[213,101],escuchar:[146,338,139,249,131,94,2,293,46,157,327],ordinaria:93,vim:226,"dividir\u00e1n":82,getappl:[61,7,51],reemplazo:224,corto:[214,247,290,148,331,344,79,387,388,181,158],corta:[214,341,130,84,377,158,166,33],"iniciaci\u00f3n":330,suposicion:[],beatric:342,"aqu\u00ed":[266,222,0,161,18,314,1,349,77,93,242,102,307,22,210,166,211,167,245,380,322,40,56,136,383,58,362,99,326,8,121,344,60,305,33,306,281,144,62,204,198,255,178,331,311,152,153,330,41,228,350,367,231,278,332,300,338,14,201,341,234,202,390,90,109,343,110,293,337,70,16,73,297,186,244,49],etc:[267,1,20,349,92,299,356,22,166,167,245,26,168,193,213,304,136,338,81,99,8,277,60,327,383,222,148,199,84,149,189,331,256,337,182,218,88,13,260,14,341,109,293,204,392,49,313,186,161],objetivo:[266,18,145,349,92,93,241,384,24,166,211,222,56,240,362,99,326,121,32,252,327,101,144,383,146,273,255,331,84,11,153,86,337,286,259,200,363,341,342,202,156,345,346,186],conocen:[99,331,222],hexencod:360,"contribuci\u00f3n":[313,18],morn:178,mejorar:[385,319,247,331,199,11,389,186,211,161],more:[239,373,163,282,350,79,190,375,271,212,322,169,58,81,6,110,344,122,83,327,281,144,70,273,123,39,349,246,226,387,335,87,367,290,339,233,108,270,156,293,111,291,347],findbypric:[338,166],tester:[61,7,35],"pedir\u00e1":[299,314,331,259,33],hundr:[],omissi:342,failure_forward:58,compani:[99,380],function_exist:224,messagetempl:[],endpoint:[312,367,141],"ejecuci\u00f3n":[61,152,51,200,319,341,314,145,20,270,78,7,364,204,73,252,49],deserializando:72,malo:[14,322,8,337,289],coincidencia:[299,225,342],learn:[217,282,39,327,212],ispublish:[99,135],male:[178,39,362,93,190,22],mala:[186,204],begintransact:221,salto:[363,288,33],prompt:[],registr:[327,74,319,207,338,268,149,45,93,99,142,186],salta:[383,211,205],accept:[170,331,84,234,141,110,375,313],delicado:47,decorando:[305,63,56],adaptars:84,subdirectorio:[222,147,343,8,204,158],impacta:90,registo:268,lograr:[266,19,145,78,2,346,167,214,247,136,137,28,99,82,359,206,319,255,331,295,64,286,386,285,310,14,204,130,46,297,235],concordant:[342,186],impacto:[130,111,48,368],estudiado:[],blogcom:135,acmeawesomebundl:[],fundamento:[26,342,316,84,20,93,121,182,237,159,280,167],dotart:166,respectiva:[199,108],predetermnada:[],respectivo:367,onxxx:[],apliqu:[71,40,167],"85\u00ba":313,aplan:33,simpl:[61,74,384,166,18,20,93,207,2,80,190,209,141,24,271,211,222,245,26,96,56,248,362,99,8,121,32,60,305,242,10,144,102,204,273,37,316,331,84,149,153,298,386,388,341,218,288,363,338,14,108,131,327,247,343,380,70,16,46,158,346,186,347,161],definitivament:[31,145,380],exception_listen:[332,211],getextensionconfig:175,referenc:[70,140,141,156,226,111,166],usars:[14,142,29],email_prototyp:264,articlecontrol:204,variant:[61,7,87],switch_us:[58,186],referent:25,simplecmsbundl:[213,273,1,315,141,86,70,218,24,347],plana:212,plano:[61,213,0,231,338,14,331,234,93,153,7,142,242,186,25],github:[239,0,138,1,163,92,116,383,21,375,271,191,213,248,240,326,99,7,142,358,33,61,177,39,384,273,231,199,221,124,152,363,65,224,337,289,201,261,2,344,69,89,70,46,72,313,186],asociando:[222,166],accessdeniedexcept:[219,259,136,139,98,186],proto:272,acme_group:247,"reproducir\u00e1":[206,77,329,355,97,29,82,216,359,315,222,178,85,310,226,181,127,287,13,44,67,109,294,295,154,113],distribuirlo:158,cambiamo:[],dotar:175,fundamental:[293,331,341,121,362],media:[266,71,84,244],cerca:[121,89],descartarlo:33,gestionando:[138,1,282,92,375,166,319,247,220,222,385,221,86,335,77,337,339,338,14,110,265,328,386,237,159],checkbox:[74,88,207,44,343,99,98,142,178,181],signo:[283,14,82,226,71,212],papel:[62,146,161],trade:[],createitem:245,scott:9,"significar\u00e1":[22,319],optionsresolverinterfac:[266,74,170,39,202,362,99,380,228,327],alla:383,pronto:[219,331,19,305,99,89,16,242,158,186],buscan:56,mailerbundl:[4,353],conn2_connect:388,buscar:[0,240,20,177,299,166,211,319,213,247,8,60,144,222,64,349,231,184,338,14,201,341,343,204,346],toqu:161,"biograf\u00eda":128,vece:[61,238,138,314,91,335,93,2,102,164,117,375,271,135,25,193,5,341,248,6,99,7,8,388,172,60,143,10,176,144,62,384,166,331,180,266,363,323,386,277,182,286,218,288,14,46,392,73,346,186,371],definitionsendmail:[117,353],"descompr\u00edmelo":145,consigu:[74,51,145,242,166,211,25,26,362,99,121,353,251,33,176,273,221,124,179,386,42,342,202,343,346],main_provid:186,"recordar\u00e1":93,eficientement:[153,331,146,18],cargador:[0,268,299,211,341,326,8,60,221,124,224,65,365,367,231,260,201,338,293,389,16,159,161],"bas\u00e1dot":[],consiga:[117,219,167],expresion:[231,144,0,162,366,119,240,177,225,142,242,209,60,346,27],jsonencod:[292,72,330],subir:[128,343,84,20,344],tematizar:266,troubleshoot:[],pertenecen:[99,344,166,277],authent:[219,62,196,162,139,189,58,256,194,293,392,327],"notific\u00e1ndot":14,gettim:[],achiev:[247,281,163,87],item_2:70,autentifica:139,uniqueentityvalid:45,found:[128,108,338,84,163,202,327,204,277,166,347,161],reescriben:200,cubrir:[341,199,20,204,158,186],selectbox:[],seed_tabl:162,invalidmessag:[291,185,123],desarrollada:161,procedur:[],"reproducci\u00f3n":[14,108,189,99,344,161,280,167],setmaxag:[307,331,375,138],settermsaccept:[207,74],verific:8,renderrespons:77,getresponseforcontrollerresultev:[383,211],ftp:[263,177,20,13],asociado:[266,219,193,129,96,247,342,108,139,256,391,110,121,211,277,297,166,33],acmebundl:[99,392,300],foovalu:[153,319],"all\u00e1":[220,193,142,14,1,139,98,62,351,70,60,331],"all\u00ed":[338,30,326,241,89,204,166,25],asociada:[70,222,1,65,111,41,242,277,166],bubbl:264,"\u00f3rdene":[368,51,268,236,214,18,145,273,326,349,7,320,70,364,159],"comparar\u00e1":250,occurr:[],setbiofil:128,qualifi:[10,86,32],typehint:39,proxi:[272,148,331,221,226,388,166],redirectact:[110,347,367],csrftype:76,"puedr\u00eda":313,like:[1,163,322,193,58,81,141,217,327,197,39,310,87,339,234,202,131,110,293,70,313,347],reintento:388,transparencia:11,imagina:[266,222,136,331,234,77,99,380,204,277,157,23,186,166],httpsport:[231,0],getwebpath:[266,297],symfony_cmf_routing_extra_terms_form_typ:[110,367],acord:[226,77],localizada:[152,110,367],"maniqu\u00ed":[199,202],juzgada:353,paramconverterlisten:383,role_private_servic:119,taskform:228,acmetaskbundleent:[],amortiguar:[],slotshelp:65,major:[],hellocontrol:[222,341,14,56,8,158],your_usernam:134,lastnam:[61,39,254,163,391,99,7,380],number:[350,322,359,88,123,291,295,250,270,126,99,110,32,228,185,376,60,167],statuscod:268,magnolia_url:70,toxpath:240,tinymc:127,setchildren:163,usleep:358,differ:[239,212,245,322,246,58,81,141,326,8,358,217,25,327,199,86,87,339,233,292,293,313,347],activarlo:[341,331,110,211,56],contra:[75,93,190,167,247,121,280,220,62,254,332,225,226,105,182,229,231,186,343,70,386,392,235],omnipresent:221,notado:[312,297],illeg:32,"comunicaci\u00f3n":[260,331,84,48],relationship:335,formmapp:70,adolec:[],fabien:[61,194,323,361,35,214,138,341,375,343,350,7,129,121,89,242,158,60,305,383,65],exception_control:[68,311],consult:[],transactionalpointcut:221,mencion:18,security_factori:[],reinstal:[],necesitemo:[],base64_decod:62,estandarizar:[14,271,211,248],aunqu:[268,145,392,242,166,319,341,248,18,99,142,144,383,222,84,150,386,228,366,72,337,260,15,342,338,343,204,158,297,186,161],yamluserfil:[299,19],reus:[218,347],debajo:[128,172,181,186,167],esquina:166,video:[260,289],replaceargu:[282,62],listen:[62,197,338,199,139,249,131,327,251,2,293,70,46,157,66,158],revisar:[281,146,145,327,370,166,33,213],comput:197,"definici\u00f3n":[238,0,388,102,351,117,210,166,353,4,193,57,362,8,277,278,385,307,282,62,330,148,331,153,335,231,338,14,201,67,202,389,293,157],setal:386,hidrata:166,wysiwyg:[326,213],packag:[350,217,226,347,70],"inc\u00f3modo":166,clicabl:142,properli:[297,1,86],"compresi\u00f3n":[331,318],configurar:[91,1,189,92,93,193,96,6,99,7,9,101,306,115,197,198,199,310,271,200,14,202,110,204,16,18,145,20,219,318,164,210,24,211,25,321,213,30,326,8,121,32,328,34,319,37,331,225,71,127,232,342,133,346,48,49,284,348,349,351,242,362,341,136,248,138,142,60,252,61,144,255,148,150,153,337,366,367,143,70,157,72,268,76,22,165,375,166,272,273,275,379,277,83,175,382,178,84,386,388,289,186,90],revelar:121,transformada:383,ventaja:[52,91,77,93,2,166,322,40,341,99,8,62,222,37,331,150,153,350,338,14,46,71,297,161],equival:[347,167],pasan:[222,119,153,319,22,42,66,252,33,254],addviol:32,self:[383,211,142,32,240],controllermapperinterfac:[],organizada:[322,341,14,2,46,313,161],namespac:[93,2,190,3,95,4,193,362,99,7,194,195,9,102,199,105,12,200,14,257,202,312,112,118,207,208,23,35,324,36,326,8,121,353,32,122,327,222,123,332,38,333,228,229,128,338,341,234,131,45,343,236,46,346,50,238,349,140,350,241,351,352,54,135,247,136,249,141,250,251,60,143,61,62,146,147,148,149,180,153,155,366,259,263,70,157,72,161,266,74,268,373,269,79,80,270,166,254,210,81,380,277,175,176,383,182,183,185,291,187,391,293,392,297,186],separada:[294,167,26,304,99,7,8,60,33,61,329,70,178,331,85,363,154,388,288,313,204,181,346],pasar:[266,238,0,335,93,22,2,383,164,375,182,211,327,96,166,99,7,380,300,190,172,60,143,204,61,236,177,62,146,310,226,334,277,42,66,231,289,338,14,368,305,109,343,70,46,71,346,186],append:[193,23,145,202,180],configuran:[176,260,14,145,326,105,186],separado:[382,193,200,341,389,14,84,343,368,218,248,167,48,161],organizado:[341,18,14,1,84,8,121,48,161],http_user_ag:343,loggabl:[168,166],minwidthmessag:105,encantan:[],"pas\u00e1ndola":172,plan:89,"pas\u00e1ndolo":[61,7],rssblockservic:140,getbag:386,asum:[231,375,0,388,138,341,202,362,99,204,228,71,9,23,135],devuelvan:181,email_configur:252,cover:87,rais:335,comunicacion:121,ext:[339,60],"serializaci\u00f3n":[260,363,72,288,384],getbar:[2,390,32],enctyp:[99,344,67,297,109],microsoft:[166,30],proporcionada:[308,70,37,331,342,256,338,334,111,165,157,218,204,367],sublicenciar:129,demobundl:[266,268,327,349,249,383,351,305,242,167,194,170,341,136,58,81,362,7,8,121,32,251,60,204,61,62,35,84,146,218,366,43,184,338,270,343,293,70,16,157,392,297,90],esperada:[62,105],"expl\u00edcitament":[266,91,93,165,210,193,96,341,136,99,98,218,33,175,144,331,323,386,66,107,367,60,368,110,49,297,186,161],licenciador:[188,345],ilustrar:33,"__contruct":[],session:[138,349,242,375,211,25,245,58,30,326,194,357,60,176,222,370,332,226,66,278,70,14,344,204,16,386,237,186,49],esperado:[137,28,193,105],ojo:93,doctrineannot:[326,349],crece:[341,84,161],impact:[],configurara:153,empujar:20,solut:[281,246,110,1,234,292,326,194,347],technic:[344,327,87],hasprevioussess:[375,138],factor:18,invalid_messag:[137,28,206,285,310,82,295,228,182,359,235],getrepositori:[338,115,202,327,228,166,229,161],customfirst:78,"movi\u00f3":[336,60,244],corrido:210,seguridad:[74,315,18,91,1,259,189,53,77,93,207,102,326,242,209,23,3,383,26,27,247,136,119,162,139,58,166,31,99,98,215,293,174,219,220,62,197,273,255,316,199,221,151,286,225,256,41,107,84,367,184,337,260,369,159,69,204,392,161,297,186,49],llamarl:[],desmarcada:44,"intentar\u00e1":[290,256,186,48],vuelven:[145,341],finalidad:392,abreviada:230,nombre_controlador:16,opcional:[61,193,214,18,14,108,370,7,365,2,293,334,91,46,60,346,347],abreviado:[231,193,0,56,338,204,60,166],"desencadenar\u00e1":311,phplexer:180,"comenzar\u00e1":[207,135],originalautoexit:268,necesitar:[222,96,268,331,326,41,251,367],synthet:234,tratamo:[],mylisten:66,rfc:[260,266,331,84],fusionada:[],necesitan:[46,248,177,60,342],despach:[46,2],anteriorment:[238,239,18,314,163,318,166,247,136,119,362,99,8,121,32,344,144,84,149,152,153,367,289,338,342,202,110,204,355,181,72,313],retirada:202,fusionado:[153,313],manytoon:[200,166,135],set:[213,222,246,332,138,342,206,212,318,77,242,254,292,39,326,22,362,386,271,25,245,141,193,226,170,56,58,81,6,7,194,121,142,344,358,9,60,204,61,247,308,163,167,35,197,166,178,199,84,266,153,169,86,65,335,87,367,218,140,179,14,233,108,234,375,327,109,110,293,70,339,157,297,47,347,161],productbundl:[],ser:[0,1,92,93,2,284,3,191,193,362,99,7,305,115,102,199,104,11,105,310,299,14,108,202,109,110,204,16,313,18,314,20,282,318,207,319,22,376,23,211,25,322,213,28,30,326,8,121,32,218,33,219,34,222,123,331,38,330,226,335,228,127,72,229,231,337,341,342,131,45,343,344,248,46,346,50,238,240,349,352,242,54,353,247,137,139,58,357,251,60,61,144,62,146,128,148,150,256,153,364,367,259,368,68,157,158,370,235,161,266,74,268,75,77,271,361,210,166,380,212,279,177,383,178,84,179,386,182,285,286,118,185,288,363,290,291,187,293,181,392,186],subseccion:[],potent:[17,318,209,54,211,27,341,277,305,176,144,331,84,386,336,338,14,109,389,204,311,186],anotador:[],see:[335,349,140,80,22,285,375,212,322,169,213,96,247,137,28,58,81,6,156,344,217,218,327,282,329,226,294,197,178,39,85,86,41,43,87,367,339,108,234,131,110,293,70,181,154,235],nativament:[147,18,14,75,99,121,242],sec:247,sea:[91,93,300,2,190,3,191,95,193,82,6,99,7,9,101,104,286,35,12,14,257,108,202,204,313,18,314,206,208,22,210,25,323,213,28,31,326,33,222,331,333,226,227,228,127,128,232,129,325,338,341,270,248,46,345,47,49,238,52,350,42,242,247,136,137,58,357,359,61,144,146,269,153,155,337,367,260,157,72,73,235,161,268,76,77,45,166,167,271,98,380,383,283,178,385,84,285,310,389,346,186,293,89,295,188,297,90],seo:110,revisarlo:[],sei:[11,60,49],lee:[234,242,145,76,177,318,92,78,207,346,22,166,211,167,4,303,139,58,8,121,216,361,305,33,144,383,222,26,84,104,11,277,337,127,367,93,232,260,14,15,67,338,293,89,204,339,313,186],muten:331,forzarlo:369,calentamiento:[],setflash:[],is_grant:[344,186,311],gethref:204,verbo:[46,2,84,298,33],dominar:[144,255,331,189,6,8,275,87],enterament:[8,383,84,18],some_typ:[137,28,206,235,310,82,295,359,285],acmesocialblogbundl:158,attibut:84,complementan:326,europa:329,insertar:[22,277,202,204,166],"llamar\u00e1":[266,238,247,221,202,362,99,335,23,166],calentar:293,javascript:[240,189,22,375,244,245,322,169,213,56,249,99,121,305,383,197,16,40,226,260,339,341,202,377,344,204,311,71,158,346],helloservicewsdl:9,your_password:134,matthia:193,getmethod:[332,142,331,84,343,204,94],my_alia:66,complementar:224,bodi:[348,244,213,56,57,142,9,218,305,383,222,331,84,65,204,127,60,341,327,111,311,347,161],last:[61,169,332,138,331,163,343,141,7,142,375,240],reduciendo:130,consolecommandev:51,pdo:[10,78,370,273,30],asumido:161,my_convert:210,pdf:[128,375,204,180,138],whole:327,complementa:110,createdat:[155,135],load:[0,19,273,77,299,356,23,271,319,213,341,248,81,326,83,175,144,204,197,199,153,86,87,231,339,108,342,292,110,293,70,347],markdown:180,imaginar:[117,84,166],schedul:[],absolutament:[346,204],returncod:[61,7],"agn\u00f3stica":[166,18],"p\u00e1rrafo":[119,89],cortafuego:[219,62,260,139,58,256,159,98,344,69,53,311,242,100,186],"_hello":[8,323],tonto:140,"\u00e9sto":49,"agn\u00f3stico":[110,199,62,273,18],filter_set:70,definidor:[238,268,91,2,22,166,135,247,57,271,99,278,282,178,385,335,338,14,293,248,46,72],poblar:[231,383,0,331,121,142],manipulado:[121,206,67],comprar:11,conjunto:[0,18,314,294,1,115,177,299,241,208,190,375,386,166,167,193,341,138,139,338,362,99,7,121,142,178,172,60,280,219,144,329,226,204,20,331,84,149,85,11,153,154,388,286,182,231,288,363,260,14,108,342,109,343,293,111,181,392,346,186,347,161],"acab\u00f3":331,calcula:[338,226,67,166,49],blob:[124,349,70],hydrator_nam:148,emisor:376,depreciado:[99,47,55],guardan:[256,341],fr_fr:[60,294,36],validatorinterfac:182,fire:[61,7],typetestcas:182,depreciada:[79,183,291,47,185],necesitara:8,blog_db:161,gettitl:[161,204,141],getcommandnam:[236,268],sethostnamepattern:367,guardar:[74,284,145,189,92,207,242,166,99,277,222,118,331,84,337,338,297,234,202,265,16,346,186],productqueri:277,mootool:240,content_repository_id:218,principalment:[144,193,91,8,386,353,161],formato:[203,384,0,372,189,349,92,93,80,346,242,343,285,30,166,135,167,95,26,193,213,341,57,28,58,6,99,276,121,211,172,60,360,174,270,176,144,383,226,222,147,231,118,331,84,180,244,153,330,333,210,155,228,158,367,230,128,337,288,363,260,14,112,311,137,159,338,243,293,249,204,16,157,72,313,235,161],histor:[],impedir:[331,102,139,186],formatt:[61,172,7,264,176],jre6:71,uuidgener:302,dominio:[232,213,149,136,119,345,76,180,286,98,293,188,106,158,60,127,90,135,161],error:[91,189,93,190,96,97,82,99,7,251,121,273,199,11,105,13,202,109,110,204,311,313,113,332,314,206,318,22,211,25,28,29,31,326,8,216,32,217,218,33,329,222,331,39,223,228,128,44,234,343,344,133,355,47,48,239,349,242,341,137,58,358,359,61,144,145,254,151,363,154,367,67,68,264,235,161,268,80,166,167,81,98,172,361,176,382,383,384,178,84,85,386,182,285,310,287,289,89,294,295,181,297,186],enlazado:[326,180,341],real:[266,145,284,18,75,20,355,77,93,2,352,242,384,375,166,353,146,4,322,193,213,295,136,137,28,138,163,82,134,99,7,8,121,32,357,358,172,60,297,33,61,281,331,102,167,142,222,341,199,84,293,64,152,363,226,105,310,228,182,285,229,128,359,200,338,14,108,342,202,390,235,343,110,206,346,204,16,46,90,205,186],"bater\u00eda":[179,158,343,33],nativememcachedsessionhandl:[],voi:353,arraynod:193,excavar:204,cortafueog:[],is_authenticated_rememb:[98,219],"mirar\u00e1":16,imponers:84,guardast:[],decor:87,getdisplaylanguag:224,acaba:[14,331,102,346,383],hexadecim:[363,121,288],supportsattribut:[219,392],intl_is_failur:224,x64:71,retroalimentar:358,shorter:[],rdf:[218,213,101],"ap\u00fantala":186,allow_row_lock:30,amc:391,phpcr_:326,caer:[99,344,222,167],route_prefix:283,acmenewbundl:16,"t\u00e1ctica":204,field_factori:[],"incorporaci\u00f3n":71,"necesitar\u00e1":[266,268,145,2,22,117,23,271,135,166,362,99,326,277,306,206,255,368,338,14,201,342,202,293,46,370,371],alert:204,"a\u00f1o":[331,137,28,84,11,49,285,161],stack:[199,141],determinevalidationgroup:99,symfony20find:33,buildview:[266,109,293,362],"navegaci\u00f3n":[245,142],comencemo:[],person:[99,72,163,39,341],recorren:[338,166],concreta:[225,200,383],getdisplaycountri:224,lograrlo:[46,99,2,144,161],concreto:[238,187,153,65,335,54],knp:[255,156,96],combinan:[346,222],salvo:[322,193,341,91,331,295,153,2,8,105,46,158,90,49],format_quiet:364,tanto:[306,238,380,18,314,91,19,163,282,326,92,93,164,383,241,305,22,117,210,166,135,327,322,193,342,214,56,137,28,240,98,285,99,7,8,121,32,251,293,9,60,143,204,33,61,281,177,102,146,270,178,331,84,64,286,153,368,335,181,341,366,107,350,337,207,338,108,234,202,131,235,343,264,145,70,16,157,392,161,47,186,242,49],"_file":[375,211,138],form_self:99,emparejen:[177,323,166],perspicaz:93,mysql:[193,288,273,247,338,148,349,30,363,326,70,277,166,161],descubrir:[14,15,139,16,60,135],sidebar:[204,147],combinar:[61,176,382,193,337,288,18,354,322,92,153,7,102,191,277,40,363,319],gc_probabl:[226,49],comenzando:15,acmeaccountbundl:[207,74],"encargar\u00e1n":222,puesto:[341,18,145,92,2,241,42,346,389,271,211,244,255,40,96,247,248,166,99,121,142,9,60,331,33,319,10,62,222,273,37,199,310,334,106,367,128,200,338,14,108,342,202,68,109,343,110,89,204,297,186],predeterminada:[189,92,93,300,2,190,96,302,362,99,7,306,102,103,199,286,14,108,205,204,311,313,18,145,118,219,319,208,210,211,25,321,323,213,28,326,8,121,218,222,37,331,16,125,226,127,230,232,338,130,56,234,45,343,137,46,346,48,341,284,55,243,247,136,57,138,58,60,144,254,147,255,180,363,337,367,368,260,158,73,268,80,165,375,275,167,272,197,166,82,361,177,383,179,386,388,289,389,293,181,392,297,186],input:[74,51,298,268,206,76,355,98,350,207,22,25,137,28,97,7,29,99,82,216,142,9,167,297,33,61,236,35,103,310,285,359,232,13,44,67,202,235,343,70,295,90,47,186,113],acerca:[92,2,117,166,211,361,4,341,99,121,33,328,222,26,331,84,180,153,337,200,338,14,89,204,16,46,392,49,186,161],puesta:[20,70],predeterminado:[0,189,354,190,193,97,82,99,7,273,310,12,13,300,201,204,311,113,222,138,314,206,115,22,23,211,25,28,29,30,216,220,329,319,37,331,332,226,127,231,232,338,44,56,234,343,344,137,346,284,242,341,355,250,60,61,144,254,148,64,153,154,66,367,359,67,68,263,158,235,342,76,80,375,166,167,210,103,98,380,178,84,85,387,285,287,186,294,295,181,90],tomar:[52,20,209,166,136,18,99,82,142,60,33,219,222,273,331,221,286,71,338,112,342,157,313],formar:[284,171,189,134,158,346,90,48],format:[230,213,327,70,341,57,28,118,141,292,330,204,137,210,285,243,212],restriccion:[26,193,0,254,231,119,75,93,99,391,304,32,208,60,127,186,135,167],proponent:281,hayan:[242,182,98,25],"presentar\u00e1":206,keep_slav:148,expandiendo:244,demanda:386,codecoverageignorestart:268,independient:[18,342,206,319,329,326,386,166,211,167,295,355,97,58,29,99,82,8,216,357,358,359,177,62,294,178,331,84,85,154,287,127,200,13,14,67,131,343,70,44,181,113,186,161],toman:[375,138],forman:84,formal:84,globalizado:18,cronometrado:48,pertinent:[62,213,341,345,47,33,319],textimage_on:30,form_emails_0:22,continua:[20,33],continuo:89,utilizaremo:[157,62],"traducir\u00e1":99,encount:[],"iniciar\u00e1":[11,33],ofuscada:186,customerbundl:200,desacoplan:84,"postinstalaci\u00f3n":145,askandvalid:314,desacoplar:182,etiquetar:[259,14,20,140,131,152,117,60],redirig:[222,5,198,339,202,64,386,25,186,49],sampl:81,bloqu:[266,77,350,166,167,322,246,341,140,362,99,326,172,218,204,280,10,282,383,70,197,148,180,226,65,41,60,202,305,109,111,86,313,49],comprobabilidad:[386,357],kernelinterfac:[268,87],newformli:202,abbr_class:344,suplir:[338,178],enrrutado:[],tradicion:[14,186],adivin:[],"m\u00e1ximo":[128,183,185,0,123,290,373,314,205,202,152,99,387,105,190,122,158,331],superado:[],"resolver\u00e1":16,"preautorizaci\u00f3n":[286,220],comparar:[102,136,331,78,226,392,186],intenten:256,usergroupadmin:23,noncommerci:27,machin:[],success_handl:58,form_table_bas:[],conducto:[],"m\u00e1quina":[341,337,18,260,84,349,92,343,121,388,211],crlf:33,requier:[20,349,300,2,62,242,24,271,167,193,136,248,166,99,98,277,60,252,219,382,102,115,331,150,153,323,386,228,336,367,338,14,16,46,392,186],santi:342,libera:[17,84,129],parcial:300,coexist:347,suministrado:[290,373,221,126,99,387,122],muestr:[266,329,178,180,85,154,294,181,346,186,161],utf8_unicode_ci:135,mynamespac:[148,225],enturbiar:60,ga_track:52,anterior:[354,2,3,193,5,6,99,100,71,307,308,309,273,11,14,202,205,109,204,313,138,314,19,21,164,210,211,25,326,121,33,328,319,331,124,40,226,335,228,43,231,129,338,247,131,343,46,346,238,180,52,349,42,341,18,60,143,360,144,62,254,256,153,366,367,259,252,68,157,72,268,77,22,165,375,166,167,277,278,175,176,177,383,84,386,64,388,182,286,288,363,389,297,186],volcar:[61,306,322,384,363,19,205,20,153,7,142,341,9,199],letter:[61,39,35,240,137,28,206,82,285,310,7,32,295,359,235],auto_connect:193,resolve_target_ent:[148,200],intl:[224,339,199,370,293],inspirada:176,soportar:18,minwidth:105,saludar:341,integrar:[247,74,84,18,207,15,189,140,202,99,344,280,277,22,181,158,297,101],modifiquen:[46,2,211],wsseusertoken:62,reenviar:242,span:[0,1,301,190,3,191,298,95,40,96,82,7,195,307,308,103,199,310,105,12,13,112,257,201,113,17,138,206,177,208,22,376,23,24,321,322,27,324,28,36,29,30,326,264,216,122,218,355,329,123,37,221,38,126,333,226,42,127,128,377,232,338,44,45,132,248,50,284,239,240,348,241,352,54,55,243,244,245,354,137,58,250,142,358,359,61,254,231,255,269,317,152,364,154,65,365,155,287,367,67,68,156,69,70,130,157,72,235,373,163,76,77,79,80,375,271,167,168,210,273,171,378,276,380,176,382,383,178,224,85,86,387,388,285,213,183,184,185,289,290,291,187,391,294,295,181,325],almacena:[74,268,207,242,211,96,56,137,28,362,99,82,190,218,305,222,331,152,386,22,285,60,341,391,16,157,158,297,235],sock:[148,169],precis:[359,82,206],submit:[74,298,207,58,327,99,98,194,280,142,343,297,186,33,25],custom:[245,380,189,200,270,148,1,264,115,58,81,141,156,86,347,339,293,83,327,280,87],doubt:[],user_timezon:[137,28,235,285],suit:194,my_some_custom_provid:58,votar:281,xpath:[343,142,240],returnvalu:94,"qui\u00e9n":[383,119,1,11,89,16,186],realista:[277,166],evidentement:[1,18],lint:204,transactional_interceptor:221,"resolver\u00eda":283,somedepend:170,link:[341,322,142,56,339,240,343,110,204,217,71,244,305,161],supeditada:179,atom:156,"par\u00e9ntesi":343,line:[240,370,199,268,261,81,344,226,313,327,87],mitig:[],setinfo:[],cid:330,indican:[331,84],vcl_fetch:318,difundida:9,contact_process:346,getint:[375,138],"encapsulaci\u00f3n":386,indicar:[266,288,338,84,350,363,47,166],escrita:[158,89,318,161],my_custom_handl:[],escrito:[175,341,382,62,138,331,311,121,23,16,71,60,386],mockarraysessionstorag:357,"crear\u00eda":187,genial:[238,145,335,362],balanceador:272,supervisor:308,user_db:186,desaconsejado:[],percenttyp:82,retriev:[273,197,234,58,141,65,335,358,327,347,212],loaderresolv:[299,81],parser:[363,384],estilo:[61,341,322,377,288,56,260,108,189,172,7,156,121,204,16,71,240,305,363],"personalizaci\u00f3n":[14,167,342,213,99],maxheight:105,datacollector:[10,293],obligatoria:[251,181,376,254],chat:253,diversa:[109,322,20,293],"alusi\u00f3n":91,diverso:[328,341,383,18],obligatorio:[61,177,193,204,222,274,370,134,99,7,32,158,346,211,167],"mont\u00f3n":[61,322,62,375,138,148,84,20,343,125,362,11,7,142,388,242,92,346,135],jcr:70,preguntar:[314,139,319,77],sustituta:110,graeat:[],invalid:[206,93,190,376,54,193,137,28,58,82,359,197,128,331,310,386,285,126,14,234,187,70,295,235,49],tard:[281,74,204,153,14,108,349,166,99,2,341,111,46,228,23,186],sethorizontalborderchar:34,reforzar:[136,161],jcb:376,"limpiar\u00e1":368,"almacen\u00f3":25,optimizando:331,getstylesheet:77,selectlink:[343,142],secundario:[343,253,60,166,319],secundaria:[],obliga:[310,305,247,5,161],welcomecontrol:[121,16],vivimo:18,"p\u00e1rr":[],referida:[281,56],longitud:[183,62,254,290,137,28,206,166,310,99,82,79,387,295,122,285,359,235],elemento:[266,0,18,294,345,77,341,190,2,329,254,208,22,386,375,24,211,167,193,197,96,56,28,138,58,362,99,326,121,373,60,305,33,240,177,62,226,146,103,178,331,288,85,363,246,154,188,287,182,127,350,213,231,218,200,140,290,108,202,327,109,343,344,280,204,46,181,364,47],ago:177,colacion:[],"_demo":[184,121,81],lanc:[99,51,166,268],mydoctrinelisten:338,algorithm:[247,102,58,186],reprodic:[],"desechar\u00e1":98,flushqueu:90,constraintvalid:[66,32],fresh:[],"tendr\u00eda":[245,306,193,332,273,14,84,375,150,58,326,238,218,204,335,77,366,161],fromaddress:8,hello:[268,205,163,77,319,383,242,375,222,323,56,138,326,134,7,194,121,142,358,9,60,305,61,253,361,35,84,64,244,153,259,65,106,43,218,341,343,293,204,158,346],creast:[341,84,93,99,121,32,60],encontrast:[],code:[239,52,234,19,206,92,350,211,213,268,141,251,33,197,199,180,86,87,108,261,110,70,313],partial:[],symfonycmftreebrowserbundl:86,scratch:[],compruebr:[],haga:[319,331,202,186,153,2,46,343,166],ajeno:99,estatura:123,resulta:[338,139,256],reemplaza:[307,23,197,268,325,145,149,99,110,121,22,60,331,371],iin:376,listado:[93,99],"impresi\u00f3n":[90,180,305],tomayko:331,send:[341,144,383,213,197,138,14,331,84,64,134,390,16,9,375,205,43,48,161],routeenhanc:367,atento:[46,2,62,211,131],"magn\u00edfica":[182,383],sens:[339,141,271,70,87],manejando:[74,383,213,289,267,207,295,60,305,161],atenta:121,sent:[194,375,383,25],deactiv:86,"eval\u00faa":56,aprend:[1,92,93,320,384,166,211,222,26,341,248,326,356,99,7,121,361,204,177,70,37,331,84,125,180,367,337,338,14,305,109,343,293,133,16,157,158,346,186,161],desencadena:[251,383,222],"utilizar\u00ed":193,"albergar\u00e1":[99,222],role_foo:119,devuelva:[231,102,0,268,338,331,153,32,9,222],alik:[188,313,345],booleana:[99,289],llama:[0,92,164,2,383,80,22,117,210,166,211,222,197,341,99,326,8,244,143,384,319,62,146,147,178,331,221,256,152,153,386,228,77,231,259,363,338,14,109,343,293,204,16,46,392,73,346,186,49],menuproviderinterfac:108,booleano:[289,193,288,187,44,247,29,363,2,182,127,384],tri:[58,81],apreciada:1,gender_widget:362,magic:163,magia:[14,222],tra:[22,178,342,166],wrote:213,admitido:[338,60,88],tre:[74,0,138,207,2,210,166,167,375,213,247,137,28,362,99,98,121,277,60,144,102,331,84,11,228,182,392,231,184,338,341,342,235,204,16,46,72,346,186,161],newform:202,"try":[176,62,268,384,247,289,221,234,256,141,363,169,39,70,339,217,166],propiea:[209,366],"aserci\u00f3n":80,canbeinvokedfromotherservic:119,admitida:[153,384,363],"permiti\u00e9ndono":[],failure_path:[58,25],redeclarar:166,redirect_url:25,impli:141,natur:[37,99,166,135,18],"_routing__control":205,privilegio:[286,199,186],crezca:[331,161],odm:[18,1,388,349,207,23,166,245,213,96,136,140,326,156,218,308,70,273,255,199,86,41,66,367,338,339,108,342,110,111,312,345,186],getjavascript:77,odd:[204,87],index:[0,138,354,6,24,375,56,141,326,121,60,305,282,383,222,331,84,124,179,367,339,341,202,131,110,89,204,16,158,346,347,161],directiva:[14,331,202,180,6,386,73,49],aleatoriament:[331,318,186,256,49],porqu:[0,205,145,318,242,2,22,362,166,322,213,247,139,140,30,99,326,8,142,357,9,60,252,33,328,222,331,311,153,226,367,231,338,14,341,234,343,16,46,386,392,346,186,161],"quiz\u00e1":[99,383,139],firma:[222,314,91,221,343,344,210,107],tagtyp:202,categorytyp:[99,127],fileresourc:19,"autorizaci\u00f3n":[219,220,62,27,247,136,331,139,53,159,286,225,69,293,209,186,129],always_remember_m:58,francia:[60,313,294,36],isrun:358,funtion:[],lea:[305,33,341],"llam\u00f3":91,smaxag:[37,307],checkdefinitionvaliditypass:319,colaborar:[337,313],requestmatcherinterfac:342,httpkernel:[175,239,268,342,2,383,211,330,4,341,139,249,8,353,251,173,10,176,328,62,222,221,149,180,152,153,256,107,87,289,233,234,293,46,157,159],ignore_on_invalid_refer:14,ostensiblement:[],prefiera:341,let:[358,322,39,202,270],ubuntu:[199,145],"revalidaci\u00f3n":331,"s\u00edmbolo":[206,361],great:[322,60],technolog:58,symfonyroutingextrabundl:96,fetch:[347,261,327,33],oficial:[293,89],profundo:[193,186,211,222],format_normal_nomax:364,restring:[177,182],isnotfound:343,profunda:186,causar:[234,186,204,25],firefox:84,polaco:89,consejo:[245,204,318,70,33],getroutebynam:312,form_div_bas:[],submodul:221,"dib\u00fajala":34,sirv:[322,383,146,268,93,99,182,186,33,213],palabra:[222,238,115,78,207,2,346,166,167,322,247,355,250,99,98,8,121,32,60,33,281,144,221,35,312,331,84,310,153,350,260,14,341,234,109,338,46,158,297,186,161],selectedchoic:344,almacenarla:[319,23,166,16],"fijaci\u00f3n":[],getus:[74,136,327,207,204,186],sensio_blog_post_index:354,verlo:[338,277,305,166,161],zip:145,commun:281,client1:157,client2:157,doubl:[58,352],upgrad:[21,33],confidenci:186,next:[308,273,339,199,70,217,313],chainrout:[110,342,367],meno:[0,138,373,1,206,317,318,93,190,2,79,208,22,375,166,391,193,96,247,136,205,58,99,121,122,60,33,61,281,177,62,123,331,84,286,153,226,250,105,387,240,350,231,183,359,172,290,370,341,202,109,343,344,293,389,204,158,161,297,186,49],cualquiera:[162,294,145,115,349,92,319,329,166,383,254,272,322,341,139,362,7,60,61,281,177,102,70,76,311,85,286,330,154,345,337,127,43,367,232,338,201,342,343,204,16,188,186,49],sesion:[62,222,159,84,189,30,357,226,70,41,242,386,237,275,211,49],manytomani:[202,247],"so\u00f1ar":204,mi_foo:[],getdefaultopt:[99,380,207],sustituto:193,recordatorio:293,checkmx:12,max_nesting_level:202,encapsula:334,potenciador:[110,342,367],outputformatterstyl:[61,7],concentrarno:[99,247],"per\u00edodo":[],odmassert:70,sabe:[2,166,222,213,341,140,99,277,305,219,383,330,84,152,153,184,338,14,56,186,204,157,90],oldpassword:3,envolv:[60,51,167,49],"porci\u00f3n":[161,84,99,383,204,60,346,211,167],process:[327,353,383,319,368,199,342,58,81,159,293,351,358,117,107,347,87],lock:[337,92],output_buff:375,loco:16,high:[110,87],accessmapinterfac:219,proceso:[341,18,253,315,20,328,116,102,309,80,210,166,135,319,26,322,193,247,136,389,139,58,8,357,60,174,219,220,62,196,273,189,331,84,151,11,153,226,157,367,286,215,368,260,346,108,342,383,159,338,343,110,293,89,71,371,297,186,48,49],onlin:186,procesa:[175,322,222,341,202,77,319,121,249,204,60,186,161],phpcr_odm:[213,101],acme_test_child_typ:182,task_edit:202,suceso:161,despachar:[46,2],comedi:34,esper:[331,236],"infracci\u00f3n":129,getnombr:338,"estrat\u00e9gico":158,delai:[],especial:[61,272,222,0,207,1,84,134,99,7,346,167],tien:[298,91,92,93,2,3,95,193,96,6,99,7,215,100,305,101,71,10,102,197,199,286,105,310,200,13,14,108,202,109,110,111,16,312,313,15,18,314,19,206,20,317,318,281,208,22,209,23,211,222,322,54,213,214,119,28,30,326,8,121,353,32,218,204,33,219,328,35,254,331,221,124,293,125,330,225,226,334,41,228,127,230,337,338,44,247,234,131,45,343,344,319,355,46,47,48,49,341,238,335,349,249,350,241,351,242,362,135,244,245,56,136,248,138,139,140,134,250,142,251,60,143,61,144,62,146,148,149,64,152,153,366,367,259,260,252,67,70,130,157,158,370,235,161,266,74,315,268,342,163,77,164,79,80,165,375,271,167,272,168,210,273,359,166,98,380,172,278,175,176,177,383,384,178,84,179,323,386,256,182,277,183,184,288,363,389,346,390,145,89,295,181,392,297,186],overridden:344,singular:[60,18],stop:[152,199,163,204,56],requiriendo:[259,385,73,186],"paginaci\u00f3n":346,"inscripci\u00f3n":[338,207,74,210,267],borrar:[23,319,138,136,331,341,375,8,204,16,277,60],conducido:383,"cambiar\u00e1":314,"teor\u00eda":[22,117],representando:219,essenti:[],cusom:156,counter:334,robot:[242,222],formatterhelp:172,element:[245,197,290,373,108,202,125,141,264,70],issu:[281,322,213,339,194,70,228],symfonycmfcorebundl:255,"m\u00e9xico":266,dominarlo:84,elejist:70,"5e45":193,"rel\u00e1jat":8,directa:[14,386,202,367],directo:[382,193,319,149,150,2,227,158,186],move:[281,233,297,67,271],schmittjoh:[221,124],ingresa:[60,121,33],operativo:[337,341,136,145,92,31,111,186],addcontrol:225,"concordar\u00e1":[346,186],producen:14,ingreso:[220,186,58,25],authtoken:62,asociacion:[213,115,349,70,277,166,135],adivinar:[66,360],"tambi\u00e9n":[0,1,92,93,300,2,238,94,166,193,5,96,302,97,98,6,99,7,215,216,9,100,305,240,307,115,102,273,199,311,11,298,368,106,107,278,13,14,201,108,202,109,110,111,16,313,113,222,15,256,18,314,19,206,20,282,190,281,329,346,22,117,210,211,25,322,213,214,119,28,29,326,8,121,353,32,218,33,355,219,328,34,204,254,331,221,354,330,40,226,334,157,228,127,128,337,129,338,44,247,342,45,343,225,236,248,46,47,380,48,49,341,51,52,335,349,249,350,242,135,56,136,137,138,58,142,357,60,252,360,319,61,144,62,146,147,231,255,148,149,150,64,152,153,364,154,65,367,259,207,260,369,67,263,156,69,70,71,158,370,235,161,74,163,77,80,165,270,209,167,272,375,359,271,82,344,293,212,175,176,177,383,384,283,178,84,85,179,386,180,388,182,285,286,184,287,288,363,297,90,145,294,295,181,205,186],routerlisten:[383,293,211],aceptan:148,hasanyrol:209,modulo1:386,detallada:[322,341,338,14,1,286,110,293,346,186,33],modulo2:386,puerto:284,adivino:[99,293],getclassnam:41,adivinan:[],detallado:[350,218,214],nadi:331,isemptyxxx:47,nombre_rama:33,publishworkflowinterfac:111,python:[176,288,363],nada:[138,77,350,2,383,22,166,211,361,96,56,139,99,8,251,305,102,222,331,84,310,179,43,367,337,153,14,341,186,16,46,71,297,90],overal:[],"uni\u00e9ndot":[89,372],separamo:271,aportcion:[],getdefaultset:[140,77],comenzaremo:[],tasktyp:[99,202,228],transparent:[338,144,253,331],legacyus:256,equatableinterfac:[102,186,247],empleado:[144,313,89],sizelengthvalid:387,parezca:[281,298,84,204,16,346],beneath:[],remplazada:60,invocarlo:49,some_twig_load:293,usergroup:23,"cu\u00e1ndo":[266,18,314,41,115,219,242,383,22,376,166,319,272,193,268,139,29,7,121,172,278,252,331,176,382,34,236,147,199,150,256,126,364,105,367,300,313,368,109,110,145,70,311,47,186,48],inversedbi:[166,135,247],claridad:[331,49],meta:[56,19,341,204,311,158,199],"static":[50,373,208,269,317,93,300,2,79,80,352,190,376,54,3,254,95,291,169,250,324,123,391,263,99,326,194,195,32,122,60,100,327,253,361,146,36,38,126,333,105,155,185,336,43,229,367,128,183,12,112,375,45,187,343,110,46,297,257],phpcrodmtre:245,sioc:101,patch:[],falta:[254,18,289,1,84,224,99,21,204],variabl:[266,209,0,52,91,206,189,350,242,2,352,22,117,362,275,211,167,26,193,147,56,137,28,138,82,6,304,7,344,121,60,100,204,280,319,61,305,332,63,103,270,166,84,310,153,222,106,285,367,231,359,300,346,341,375,202,390,235,68,109,343,110,111,295,46,313,186,347,371],ejercicio:161,tuya:[306,289,136,149,8,60,346],testbindvaliddata:182,anidado:[176,382,60,331,18],anidada:[22,363,202,288],postinsert:277,getintlicuvers:224,intldateformatt:[224,137,28,285],atajo:[2,320,243,214,341,274,57,99,7,8,121,61,222,386,368,313,354,186,343,73,346,159],contacttyp:[],matric:[],puedist:383,limitacion:[240,331,286,99,188,345],sendmail:[284,14,134,248,117,271,353,212],optimizar:[130,104,319,189,377],ordenador:[322,145],setxxx:47,cuidadozo:[],organ:[199,226,271],firewallmap:139,log:[284,268,145,144,92,2,275,169,341,98,121,142,306,176,382,273,148,221,125,388,337,289,233,264,293,16,158],idiosincrasia:186,instruy:198,could:[128,213,339,39,58,81,141,110,105,212,327,194],lexer:180,put:[108,298,339,331,84,234,39,346,186,347,87],asociarla:[],david:342,frent:[26,238,56,331,18,316,318,286,109,2,380,121,335,46,305,211,161],enforc:[],trabaj:[306,341,184,319,268,149,331,145,115,202,6,8,293,204,16,358,24],outsid:234,parament:[],timezon:[99,329,88,370],manager_registri:367,softwar:[129,341,260,20,33,161],"suceder\u00e1":22,scene:87,estacionamiento:20,potencial:[319,134],validatevalu:93,owner:[136,119,286],engineinterfac:14,literalment:204,"minimizaci\u00f3n":[71,377],cuadro:[137,28,206,355,235,99,82,216,204,295,22,228,186],omitido:[206,76,355,166,137,28,97,29,82,216,359,329,178,85,154,287,127,285,232,13,44,67,294,295,181,113,235,161],mantenida:[215,33],numericfunct:[303,148],licens:[350,345,158,27,33],intl_get_error_messag:224,system:[70,137,28,342,58,131,141,156,293,111,199,347],calculatortest:343,verifica:[286,62,136,331,392,186,126,179,388,182,3,211,361],"comod\u00edn":[231,177,0,341,84,202,346],"document\u00e9":338,obtien:[266,234,242,222,326,215,32,60,175,308,142,331,180,224,386,334,345,152,342,202,390,344,236,188,346,186],inspriat:[],lot:87,recient:[199,145,349,11,21,204,279,33],boton:[329,178,29,85,152,343,154,294,181,362],accompani:[],sorpresa:144,necesitamo:[255,72,346,341],haven:170,sustanci:33,datatyp:60,post_set_data:[146,327],detereminado:[],febrero:[11,215],autenticart:247,autenticars:[220,369,98],sobrescrib:193,"a\u00f1adieron":[177,51,247,286,204,186],ormtestcas:[],proveyendo:[224,277,199,49],cobertura:[179,343,151],a_few:60,setcontentdisposit:375,ciudadano:[341,8,16],falso:[22,178,328],empecemo:[207,121],"volver\u00e1":[166,388],fail:[322,62,386,256],denotar:[363,288,167],"magn\u00edfico":[99,60],permutacion:18,"c\u00f3mica":84,ayudandot:[],cuatro:[321,0,247,130,331,77,11,99,380,105,60],allow_reload:331,registrarlo:[],engancharla:51,engancharlo:367,registrarla:[157,349,176],soap:[296,9,62,189],documento:[284,349,18,1,145,317,77,350,207,351,388,23,222,26,322,375,213,96,240,140,304,326,215,121,142,9,218,101,313,308,383,204,197,331,339,180,33,11,86,41,367,260,297,342,338,343,110,89,70,249,312,226,47],aparec:[128,254,263,14,77,153,181,3],allow:[342,145,141,271,212,245,322,169,170,81,6,327,144,39,246,226,105,128,339,108,261,110,293,70,347],vist:[99,60,121,186],"jerarqu\u00eda":[219,193,91,153,204,365,158,186],oracl:148,visa:376,bucear:84,xarg:[],provenient:186,segment:[],unida:18,lsmith77:342,prueban:343,repita:[310,363,380,384],secure_all_servic:[225,259,162],"autenticar\u00e1":186,loadprofil:211,inactividad:[237,49],jmsaopbundl:[26,221,124,21,114],face:[],brew:199,trampa:[186,222],fact:292,jmsdiextrabundleannotationtag:[],dbo:30,"cotejar\u00e1":247,appusermatch:19,bring:[322,70],removexxx:47,trivial:[247,218,349,161],principal:[266,322,383,384,341,331,14,1,104,328,64,11,363,251,121,211,286,293,305,135,49],redirect:[74,222,198,207,339,332,58,64,202,93,99,338,347,242,277,297,166,211,367],footbal:327,getdata:[266,74,146,207,67,99,228,182,327,170],conociendo:[220,62],pegamento:84,jar:[322,199,349,377,70,16,71],terminar:[179,118,153,158,33,361],jstree:[245,244],jan:[137,28],terminan:[231,200,0],expandido:[178,181],suppos:[39,327],"__call":94,analiza:[14,384,363,16],hope:[],meant:87,use_acme_goodby:175,acced:[138,163,219,92,78,242,388,190,23,166,211,319,375,5,341,268,362,99,98,8,121,142,277,60,305,10,220,383,222,273,148,84,86,334,41,218,200,338,14,109,343,70,386,392,73,186,161],familiar:[146,56,108,327,350,292,204,313,305],twigbundl:[103,341,14,311,68,153,8,293,204,16],superada:93,autor:[50,18,269,93,22,80,352,190,54,135,263,345,250,60,254,178,38,11,333,105,155,128,12,129,14,112,342,45,187,391,188,257],acces:[52,210,211,341,249,134,99,9,60,199,144,222,273,148,331,84,226,202,293,204,186,161],utilizalo:222,abbr:344,wouter:[163,39],menunodeid:245,gitnacho:[326,344,89],rebasa:313,event_subscrib:[338,293,131,70],stuff:[358,218,141],lote:[61,7],comma:[],logbook:176,mongodbbundl:[338,207],nist:58,configuren:193,rellenando:102,aprovechamo:[],enrutar:367,fixturesbundl:[326,23],temporarili:[],securityident:136,finddefinit:282,"est\u00e1ticament":[164,221,143],operativa:[277,145,166,33,341],unzip:145,pasen:300,identificar:[222,138,108,157,375,167],devuelto:[266,0,314,294,282,93,2,102,329,23,211,341,119,28,383,362,121,142,61,177,62,222,197,178,84,85,286,154,285,350,219,231,259,343,204,137,46,181,235],devuelta:[66,84,342,331],conn1_connect:388,destino:[177,193,200,222,289,331,332,189,220,204,25],processedconfigur:193,confirmar:[61,74,337,250,314,145,92,207,215,54],email:[74,373,75,189,93,207,22,166,247,134,99,8,33,382,254,178,64,180,88,43,12,290,171,45,158,113],recompilando:319,perfect:327,mong:338,flattenexcept:383,image_path:266,manejada:[222,341,14,342,110,111,16,346,213],manejado:[210,367],type_person:99,ryanpass:186,consideracion:[350,267,200,204,18,93,99,121,111,16,242,305,222],addviolationatsubpath:[],base_template_class:68,negando:186,doxygen:166,exactitud:[310,99],figuren:293,memcachedsessionhandl:49,un_activo:103,tld:169,"metodolog\u00eda":[331,161],afortunadament:[238,298,145,318,300,166,135,322,341,136,134,99,8,277,331,84,150,335,229,338,14,236,346,186],devuelven:[177,115,343,142,166,49],duda:[92,337,18],my_multilang:212,deteniendo:[46,2],symfony2_project:6,indica:[299,384,197,207,57,19,247,250,362,31,363,2,204,46,346,331,242],setprofiledata:254,doctrinebundl:[200,103,341,148,349,16,73],reenviando:[242,222],pueblan:22,"m\u00ednimo":[288,123,255,373,291,363,79,387,105,122,158,290,331,49],"repetici\u00f3n":[238,335],invalidando:[331,59,318],setgroup:23,kahw:342,"est\u00e9n":[175,35,14,388,11,148,117,166,33,254],agregada:[],fortaleza:98,miembro:382,decidido:[186,305],immedi:[],agregado:[177,337,341,331,92,161],equipo:[372,104,116,215,89,313,33],inheritdoc:[23,229,247],"re\u00fan":361,swift_sendmailtransport:[117,353],noresultexcept:[166,247],"funcci\u00f3n":[],"fusionar\u00e1n":[310,33],expuesto:[110,96,367],togeth:[327,326,189,275,87],productrepositoryfunctionaltest:229,containerbuild:[175,4,328,62,319,336,248,153,351,335,117,73,271,353,330],default_connect:[193,148,115,349,131,326,70,388],solucion:[197,18,1,234,92,265,161],empiec:[226,139,349],"autom\u00e1tica":[341,389,346,201,84,20,99,8,353,158,297,211,161],intranet:8,"autom\u00e1tico":[389,231,0,268,260,201,221,124,224,338,8,258,204,16,341,210,211,161],cve:215,capta:380,route_repository_service_id:312,responsabilidad:[383,129,341,37,342,389,2,121,16,46,60,252,327,146],globalvari:[344,186,204],site:[339,141,99,326,110,204,217,6],"autom\u00e1ticament":[0,2,3,5,96,6,99,305,306,105,35,14,201,15,202,110,204,16,18,118,318,21,22,117,23,211,319,322,213,326,8,121,32,218,33,329,222,331,221,124,225,228,231,338,111,343,46,347,49,284,241,351,42,242,362,353,341,60,147,255,153,154,66,258,367,259,70,161,266,268,165,166,167,210,98,277,219,178,85,179,386,388,389,186,293,294,181,297,90],archiv:[217,210,0,231],revisando:33,conserva:62,default_entity_manag:[148,115,32],fusiona:[331,319],mutar:331,ilustr:31,session_tim:30,endtranschoic:[60,344],symfony__:6,formulario:[266,74,369,380,298,206,76,267,77,93,190,102,351,80,346,22,386,3,25,321,26,232,304,137,28,97,139,58,29,362,99,82,344,216,142,341,167,327,242,355,98,220,62,226,146,222,178,84,329,189,85,310,153,359,154,256,105,228,182,127,285,128,316,356,88,13,207,338,44,287,67,202,235,109,343,132,293,280,294,295,181,161,297,186,113],"segmentaci\u00f3n":70,"pres\u00e9ntes":89,mostrado:[128,198,314,14,326,373,98,121,105,376,186,167],siempr:[341,51,138,145,189,349,77,93,300,2,241,351,346,23,166,211,25,193,5,96,56,355,28,240,140,362,99,98,215,121,142,313,358,90,60,305,33,319,236,219,383,222,197,273,148,331,84,256,153,40,369,228,278,83,363,338,14,201,247,375,45,109,293,204,44,312,158,161,47,186,49],"deber\u00eda":[306,50,268,161,18,314,145,177,318,77,350,383,79,22,3,211,330,245,193,205,139,166,99,326,215,121,353,313,9,60,331,175,236,144,62,204,273,199,241,256,349,286,225,226,387,182,367,219,183,184,297,342,45,68,343,110,70,328,71,158,73,47,186,49],supuesto:[266,238,138,20,92,93,241,351,346,166,135,384,380,341,140,362,99,8,121,277,9,144,222,331,256,363,226,227,335,337,338,14,234,389,249,204,130,313,186,48],mostrada:[300,7,383,166,311],upon:332,coffe:[40,213],dai:[137,28,98,307,285],"7d33018":33,infinito:[359,288,363,295,60,33],nombreplantilla:341,php:[0,91,1,189,92,93,300,2,190,3,166,95,4,40,5,303,6,99,7,194,195,9,100,305,101,10,307,102,273,199,104,11,298,105,310,106,278,12,376,14,201,108,202,327,109,110,204,16,312,313,112,347,222,15,332,18,158,19,206,20,177,207,200,329,21,208,22,117,23,24,211,25,26,322,54,213,214,324,119,28,123,30,31,326,8,121,243,32,306,122,218,297,33,39,35,254,36,37,124,331,221,38,293,126,354,333,226,227,157,286,42,43,229,230,128,316,337,338,130,233,247,234,131,45,282,343,344,236,137,46,386,353,371,47,48,49,341,50,238,239,251,52,335,349,249,350,241,351,352,242,217,228,362,135,244,56,136,57,138,58,141,250,142,357,358,60,143,248,360,319,61,144,62,63,147,231,255,115,149,64,153,154,65,212,155,66,366,367,259,368,260,252,369,375,118,68,263,389,70,339,71,72,73,370,235,161,266,74,268,373,163,269,78,164,253,79,80,270,209,146,169,170,292,274,359,81,271,98,380,257,148,277,167,280,175,176,382,383,384,283,178,84,224,85,179,323,86,180,387,388,182,285,87,134,183,184,185,288,363,290,237,291,90,187,391,145,346,294,295,181,392,205,186],infinita:[314,62],login:[369,284,332,58,134,98,194,142,242,60,186,25],expand:[245,329,292,178,85,109,154,294,22,181,362,327],johndo:[],off:[169,370,273,81,30],maxlengthvalid:183,phar:[145,20,349,92,241,21,23,24,326,121,217,101,273,255,199,124,179,86,337,338,339,15,389,33,161],exampl:[213,375,138,335,2,80,346,22,134,271,25,245,194,322,169,5,96,247,137,28,58,81,141,8,388,170,9,212,327,382,319,273,64,153,40,217,106,156,43,87,231,259,130,233,108,234,90,292,343,110,70,339,181,158,73,313,186,347],command:[61,236,51,35,197,268,199,261,349,358,7,320,70,273,217,158,370,90,87],filesystem:[199,159,289],"igualaci\u00f3n":[],encontrara:286,dar:[10,128,144,327,349,146,214,176,389,14,58,92,11,98,293,266,270,279,33,161],less:[281,183,185,123,290,373,322,387,122,361],symfonycmfcontentbundl:[255,326,110,70,367],trayecto:231,generalizada:92,momento:[91,145,93,2,346,362,166,211,167,95,248,271,99,121,245,308,62,146,179,14,202,204,46,297,186],complicada:[382,52,331,153,204,228,117],complicado:[219,72,202,240],"confirmaci\u00f3n":[314,386,337,33],annotation_read:221,evolucionar:121,web:[189,92,93,5,192,6,99,7,9,305,306,102,103,199,104,105,14,204,16,313,18,315,20,318,116,24,211,213,30,326,8,121,217,218,328,222,331,128,337,341,131,345,346,180,240,349,242,55,244,56,205,134,59,60,61,144,145,118,64,363,367,260,69,70,157,158,370,161,10,62,375,275,361,169,273,171,166,383,84,386,256,296,87,288,186,89,188,297,90],"grabar\u00e1":6,jinja:180,mybundle3:388,mybundle2:388,mybundle1:388,priorit:110,mybundle5:388,mybundle4:388,combina:[231,322,0,77,89,204,346,211],garantizamo:[],"distribuci\u00f3n":[145,337,345,260,148,84,124,64,92,389,326,121,16,188,370,186,161],crud:[321,86,243],piec:327,symfoni:[0,375,91,1,189,92,93,300,2,238,94,3,191,166,95,4,193,5,96,302,303,281,97,98,6,99,7,194,195,216,9,305,101,10,308,102,273,198,199,311,104,11,298,368,105,310,106,107,299,12,13,14,201,15,202,327,109,110,111,16,312,313,112,113,347,222,108,256,138,158,261,19,206,20,177,190,200,329,21,39,208,22,117,23,24,211,212,26,322,54,213,214,277,324,28,123,29,30,31,326,8,121,32,306,122,218,204,33,355,219,34,35,254,36,37,124,331,221,38,293,125,126,330,333,226,227,41,228,336,337,127,43,229,128,316,232,338,44,233,341,234,131,45,282,343,132,249,236,248,46,386,346,380,48,49,50,51,239,251,240,335,349,140,350,241,351,352,242,217,362,353,245,376,246,247,136,137,205,139,58,141,114,250,334,142,357,358,60,143,319,61,144,62,146,147,231,255,115,149,150,64,152,153,364,154,65,155,287,66,366,367,259,215,207,260,252,289,67,68,263,156,69,389,70,157,72,73,370,235,161,266,74,315,268,342,163,76,77,78,164,79,80,270,275,269,167,272,210,170,292,359,314,81,271,332,82,344,257,148,172,278,175,176,382,383,384,283,178,84,224,85,373,179,323,86,180,387,388,182,285,87,134,183,184,185,288,363,290,291,264,90,187,391,145,89,294,295,181,392,297,186],desd:[0,189,93,354,2,4,193,96,99,7,251,9,102,197,199,106,35,14,201,108,202,110,204,16,312,313,138,145,20,328,319,21,22,209,210,211,25,322,213,30,326,8,121,220,222,37,331,332,124,41,228,231,338,130,341,234,343,46,346,48,49,180,350,241,351,242,135,247,136,248,140,142,357,358,60,61,144,146,149,64,152,153,66,258,367,259,260,71,158,73,370,161,267,342,163,77,79,375,271,167,171,378,166,277,282,383,84,179,256,183,185,289,389,291,390,186,293,89,181,392,297,90],dese:[61,238,19,206,211,25,341,7,99,98,359,33,10,361,35,149,286,335,389,370,343,204,16,46,157,346],password:[74,284,314,6,115,349,93,207,326,242,134,3,25,193,247,355,58,30,99,98,142,277,102,166,148,256,310,226,227,388,78,88,70,16,186],recurs:289,fr_be:60,uploadedfil:[128,343,67,297,266],desc:218,"mostr\u00e1ndot":[121,33],resid:[341,247],controller_class:[213,101],schmitt:221,dataprovid:182,my_entity_provid:58,"an\u00e1lisi":[363,384,211],xmlsoap:9,centraremo:186,comparador:19,http_kernel:222,evadir:[146,236],"encontrar\u00e1":[241,341,338,108,202,389,8,121,204,277,228,186],presentar:[179,18,343,310,99,82,186,33],symfonycomponentsecuritycorevalidatorconstraint:3,conservar:[99,222,357],instapay:376,necesidad:[18,1,189,349,242,94,166,211,384,26,341,28,140,379,99,8,121,33,236,35,198,20,199,84,286,363,388,228,367,310,338,346,342,235,389,110,293,111,157,297,186,49],swift_:201,conservan:[363,288],flush:[74,375,197,138,136,202,99,326,338,207,23,297,166],guarante:[],collectionconstraint:[],transport:[4,353,284,14,248,134,227,70,16,271,9,90,117,48,212],"s\u00e1bado":215,feder:266,avoid:347,getslug:204,devuelv:[266,0,138,314,115,308,77,93,242,2,102,80,346,164,54,166,211,222,375,213,56,119,383,334,326,362,99,7,121,32,60,143,61,177,62,142,197,148,331,84,152,226,65,299,388,42,350,219,231,289,338,14,247,341,187,343,344,46,386,392,297,186,161],routingbundl:[108,347],salvado:[],userproviderinterfac:[102,62,256,247],getexitcod:51,stanbol_url:213,desgracia:60,valid_children:[245,301,86,244],preload:245,"p\u00f3nlo":41,controladora:[230,84,346,278,49],imaginari:327,symlink:[199,145,86,204,289],recentarticlesact:204,lifecycleeventarg:[131,70],stage:[],incrustar:[288,56,331,363,22,305,222],"tomar\u00e1":[219,297],traslado:297,db_data_col:30,cadena:[298,93,2,3,95,193,97,99,7,195,121,305,310,12,13,14,112,110,204,257,113,138,314,206,118,282,208,117,210,211,212,324,28,326,215,216,32,122,218,327,219,222,36,331,38,333,226,228,127,128,338,342,343,344,355,46,346,50,240,348,54,353,376,56,137,250,142,60,61,144,163,146,148,153,155,66,367,359,260,263,235,75,269,79,80,375,166,82,172,177,383,384,84,386,387,388,285,183,184,287,288,289,290,187,293,295,181,186,363],iniciando:[255,86,24,349,101],kri:323,"_exit":186,un_nombre_de_opcion:103,incrustan:391,obten:[138,314,20,282,92,93,22,210,271,211,322,375,96,247,248,166,99,8,142,305,177,331,332,152,182,367,259,337,214,338,130,202,270,343,293,204,16,346],simulada:305,secure_control:259,pluralizado:60,simulado:357,promuev:[14,161],banca:49,"cron\u00f3grafo":159,voluntad:286,banco:1,mere:335,merg:[109,308,261,33,313],proporcionan:[193,96,252,331,349,121,357,164,172,367,143,49],url_rewrit:205,"u\u00f1a":[],existemt:[],contien:[290,74,315,0,138,373,19,145,76,328,92,93,207,2,383,351,326,190,384,375,166,243,167,380,322,193,273,56,274,57,139,250,362,99,7,8,121,32,251,293,60,360,319,219,144,221,222,254,198,341,331,84,125,286,153,246,226,391,337,77,350,231,218,200,288,363,260,14,247,234,202,109,343,338,69,389,204,16,46,386,346,186,161],acoplada:[],symfony_cmf_tre:[245,86],"dici\u00e9ndol":62,findonebyidjoinedtocategori:166,proporcionar:[0,18,314,348,315,273,93,2,386,193,213,96,98,110,60,101,10,236,177,222,197,198,84,104,152,153,226,345,286,231,218,342,156,33,70,46,157,158,346,49],deliveri:[1,343,64],examplefilt:388,getent:131,dificulta:[248,271,33],addcommentact:136,caducado:[247,49],conector:148,grati:33,mainbundl:[199,293,140,326],configureformfield:70,iso639:[60,294,36],dibujo:34,adivinanza:[],evident:[331,47],admin_bundle_menu_multilangmenunode_cr:86,circunstancia:[343,211,49],faltant:[224,99,92],problem:[245,322,86,327,141],my_service_typ:153,explicacion:[],inicialment:[99,383,127,232,142],"int":[136,338,352,30],ce617a6cca9126bf4036ca0c02e82de:247,setdispatch:51,novemb:[],ini:[128,384,389,370,202,180,6,363,226,386,158,375,313,191,49],inf:[363,60,288],"\u00edtem":213,inc:89,luhn:[93,126,75],setfilecont:70,gastado:161,nonetheless:[],"6_no_r":112,avanzado:[286,220,383,247,148,84,115,189,68,153,326,69,234,204,178,341,346,166,161],lookup:339,varieti:[],getopt:[61,7,331,35,268],servernam:[169,6],frecuencia:[331,49],adaptado:20,repeat:[310,99,74,88,207],propelbundl:277,"class":[0,375,91,1,189,93,354,2,284,94,3,191,166,95,4,193,96,302,366,97,82,362,99,7,194,195,216,9,305,10,307,308,102,103,273,199,104,349,286,298,105,200,299,12,13,14,201,108,202,109,110,204,312,313,112,113,213,17,332,138,206,115,177,190,319,329,208,22,117,23,24,211,212,321,322,323,27,324,119,28,123,29,30,326,8,121,243,32,306,122,218,327,355,351,39,35,254,36,37,331,221,38,126,330,40,226,334,41,42,336,127,43,229,128,377,232,325,338,44,233,247,234,131,45,282,343,132,249,236,248,46,386,353,346,347,341,50,238,239,251,240,348,335,267,140,350,241,292,352,217,228,54,55,135,244,245,376,246,56,136,137,58,141,301,250,142,358,60,143,61,144,62,361,146,222,231,255,148,339,149,150,180,317,152,153,364,154,65,365,155,287,66,197,367,219,259,207,252,67,68,263,156,69,70,130,157,72,73,235,161,266,74,268,373,163,76,77,78,164,333,79,80,270,275,269,167,168,210,170,225,171,359,378,81,271,276,380,257,277,278,280,175,176,382,383,178,84,224,85,86,256,387,388,182,285,87,310,183,184,185,289,290,291,264,390,90,187,391,293,294,295,181,392,297,186],definicion:[4,282,193,0,231,385,342,153,365,336,73,166,319],entity_manager_nam:175,crecient:18,"v\u00e9ase":[],filtercontrollerev:[157,383,211],"emitir\u00e1":49,"restrici\u00f3n":291,eof:[358,72],recibido:[51,206,355,137,28,97,139,140,29,82,216,251,359,219,329,178,84,85,154,127,285,287,13,44,67,294,295,181,235,113],recibida:342,alquilada:331,rule:[169,247,369,209,186,347],"apoyar\u00e1n":18,"consideraci\u00f3n":119,iterador:177,desencadenar:251,enrutamiento:[110,19,84,342],consient:[],"_rout":[231,308,0,84,342,346,222],cian:7,acordar:71,role_hierarchi:[242,247,58,186],tuyo:[10,172],agrupacion:18,autentificar:[383,69],voter:[219,330,162,58,293,392],"const":[46,350,2],getmethodcal:282,my_control:150,retirar:[238,202],"a\u00f1adist":[99,202,214,266],caducidad:[242,331,49],extensibilidad:[14,286,2,46,313,305,211],"utilizar\u00e1n":[230,167],documentrepositori:[312,338],integrado:[52,300,242,209,210,166,56,99,121,142,277,384,198,331,363,226,109,156,293,204,158,49],global_const:212,afirmar:[93,75],hacemo:213,getpar:[266,228,149,362],integrada:[344,176,383,214,368,338,331,159,286,7,320,121,204,305,23,366,186],confirmando:[337,92],necesitando:204,"supresi\u00f3n":202,maner:[],peligrosa:89,data_timezon:[137,28,235,285],servido:322,rangevalid:123,un_ejecut:264,incorporar:[74,255,77,99,204,361],mencionar:[158,23,341],dm2_document_manag:388,upload:[128,343,297,142,70],lectura:[84,222,18,163,86,242,277,158,386,166,49],value_opt:[61,7],"dar\u00e1n":349,positive_valu:193,ruteador:[231,0],mencionan:[],database_host:[115,349,30,326,16,277,166],hora:[95,281,62,88,289,331,137,28,206,392,166,310,99,82,295,155,285,359,235,49],ampliament:84,askhiddenrespons:[314,313],my_doctrine_common_cache_servic:148,seqdef:330,cuentan:[342,240],definan:[14,102],test_datetim:[303,148],calendario:11,menufactori:108,stateinvalid:187,told:[],"eligi\u00f3":210,manejo:[341,206,213,268,137,84,343,11,99,82,311,359,211,161],preguntado:[314,121,367],maneja:[74,284,268,314,207,8,22,23,213,247,326,215,121,277,331,84,260,204,392,297,90,161],utilizaba:[346,344,313,204],formateador:[172,7,252,262,176],updateact:[298,338,93,277,166,222],interna:[231,161,222,341,49,310,60,0],recompensado:16,sonata_block_rend:[326,197,77],cachepath:19,"bit\u00e1cora":[176,144,341,189,125,133,166,161],anchor:[],datetim:[138,75,93,210,166,135,95,375,303,137,28,141,99,176,148,331,180,333,155,228,285,88,235],routing_dev:[341,184,121,16],anular:332,"_cooki":[375,211,138],createkernel:[35,229],cache_class:205,post_bind:327,onkernelexcept:[251,211],mkdir:289,ahorra:[14,331],releas:[11,215],incorpora:[207,361],"pluralizaci\u00f3n":[60,193],cualificado:[282,213,225,293,32,158,346,66,101],cualificada:331,sessionstorag:[49,211,30],nodehelp:326,highli:1,exacto:[60,284,14,8,172,23,346,186,383],"explotaci\u00f3n":[215,204],exacta:[337,145,92,109,2,8,121,46,60,346,166],setpaddingchar:34,henrikbjorn:342,subconfig:153,uniqid:[312,176,23,297,247],ntinterfac:[],appdevurlgener:144,autocompletado:[338,153,166,341],continuar:[61,327,337,146,145,92,99,277,166,161],tokenvalid:54,desarrol:[277,84],pudo:[128,193],"pr\u00f3ximament":138,rootdir:[306,233],darno:[],word:[313,343,100,58],enrutando:[342,26,222,156,273,341,347,316,1,84,189,367,298,110,121,8,83,346,159,160,213],err:[358,176],translation_strategi:348,"f\u00e1cile":[200,222,240,37,30,363,319,389,204,22,384,161],work:[189,22,275,212,245,156,327,282,319,385,39,86,87,70,339,234,110,111,14,181,313,159,347],beforelisten:[],libxml:[370,349],layout_borderless:34,permita:[14,108,186],construist:166,relacionarlo:166,notarial:[],invertida:177,"internacionalizaci\u00f3n":[60,270],empieza:[1,145,2,241,22,166,135,26,341,121,252,383,330,363,226,43,184,288,14,202,343,204,46,186],hellowsdlbind:9,democontrollertest:[343,194],"difundi\u00f3":215,cuidado:[231,0,166,119,15,20,58,180,90,153,319,234,186,33,222],autodetect:[],swift_transport:[117,353],termin:[51,331,145,118,383,320,293,60,48,49],indic:[],invertido:361,aaaa:[155,333,12],swift_plugins_antifloodplugin:284,trasladar:[386,8,20],basebal:327,buildform:[266,74,146,207,202,362,99,380,293,228,182,327],bag:386,supliendo:[],hemo:[231,0,248,115,93,242,2,121,204,16,46,346,186,167],gigant:[331,8],trust_proxy_head:[],objeto:[0,91,93,300,2,94,95,96,97,99,120,216,9,305,10,102,286,105,200,13,14,108,202,109,110,204,312,113,138,206,355,207,208,22,117,23,211,213,119,28,29,326,8,121,32,327,219,328,222,254,331,221,126,333,334,335,228,127,128,232,338,44,247,234,131,159,343,344,248,46,47,49,341,238,52,349,241,42,242,376,246,56,136,137,139,249,134,142,373,251,60,143,144,163,146,231,166,256,152,363,155,367,259,260,252,157,72,235,161,74,342,75,76,77,164,80,375,209,167,210,378,271,82,380,277,282,383,384,178,84,386,182,285,287,289,346,187,391,293,181,297,186],replicaset:388,disparador:18,significan:[91,343,166,204],length:[202,74,254,241,247,166,75,183,45,93,99,391,79,208,22,122,297,186,135,167],"a\u00f1adan":[46,2,32],guardada:386,significar:186,verifi:[],nombra:42,guardado:[331,386,49,237,159,211,161],barev:2,recogn:217,fosjsroutingbundl:[245,346,86],rebas:33,implementado:[383,200],implementada:[111,367],activast:273,"proporcion\u00e1ndol":32,recuperado:[277,108,315,146],"proporcion\u00e1ndot":[343,315,273],recetario:[266,1,145,189,93,346,166,211,26,341,248,356,134,99,315,222,331,125,367,338,14,67,186,133,343,293,204,158,297,90,161],doctrine_phpcr:[245,255,349,326,86,70,41,367],video_647:289,routecollect:[231,323,0,283,341,84,298,81,300,8,204,312,106,60,346,186,383,5],lap:152,disable_rol:162,averag:[],orden:[51,251,268,314,145,20,236,92,2,320,241,21,23,166,135,222,321,322,213,214,341,136,57,281,326,6,99,7,8,121,243,358,277,60,204,33,319,61,176,35,273,149,199,124,189,153,364,258,367,230,118,337,215,179,338,370,201,368,159,274,343,110,293,389,70,16,46,181,158,346,90,48,161],accesslisten:219,unoamucho:[202,135],blockserviceinterfac:[140,77],ajustast:351,mydriverimpl:148,inadecuada:91,credenti:58,"trabajar\u00e1":[61,349,99,7,186,367],greet:[61,222,214,56,268,343,7,305,35],hasta:[18,314,145,20,318,93,2,346,242,117,362,209,353,167,375,136,166,138,30,99,121,251,60,331,281,383,204,37,199,84,153,330,386,231,289,338,14,342,202,389,343,344,70,16,46,71,158,161,313,186,49],receiv:[39,254,273,108,234,347],diferencian:121,green:[61,222,56,7,242,305],order:[245,169,137,28,339,327,292,2,110,335,46,217,336,166],mymsg:204,asterisco:167,atribut:347,offici:[156,169,39,270],establecist:331,bella:[61,7],veri:[197,339,234,141,292,8,327,347,87],aislamiento:253,sandboxmainbundl:70,"enfocar\u00e1":[62,247],japan:89,flexibl:[266,222,138,91,78,242,2,22,375,271,25,168,247,248,240,166,99,8,305,383,70,37,84,153,386,338,14,341,202,131,204,16,46,158,346,186,161],mayor:[138,373,92,93,2,375,166,213,277,99,7,121,122,61,281,222,123,331,11,153,226,387,105,128,183,185,290,14,291,341,270,338,110,204,130,46,158,49,346,186,161],postexecut:157,delete_cooki:58,getattribut:[343,375],sender_address:284,probado:[182,199,186,229],"nombresesi\u00f3n":[],offic:111,date_cr:[137,28],variando:331,valor:[0,93,300,2,94,3,191,95,193,96,97,98,362,99,7,195,216,305,10,102,103,159,310,105,106,107,299,12,13,14,112,202,204,313,257,113,138,314,19,206,118,355,190,319,329,22,376,23,211,25,213,324,119,28,123,163,29,30,121,32,122,218,327,33,219,34,222,36,37,331,38,293,126,354,333,226,42,127,230,128,232,338,44,247,342,45,343,344,137,46,346,49,341,50,284,52,350,352,242,54,243,244,56,57,58,250,142,251,60,61,144,62,146,231,148,150,153,364,154,365,155,287,367,259,207,289,67,68,263,264,157,158,370,235,266,74,268,373,75,76,79,80,375,166,361,210,359,82,380,277,177,383,178,84,85,386,387,388,269,285,183,185,288,363,290,291,390,90,187,391,145,294,295,181,392,186],"subjerarqu\u00eda":201,comprobar:[50,298,138,349,190,209,210,212,375,96,247,136,205,250,361,33,219,102,148,331,84,286,179,388,182,366,259,12,290,342,343,157,392,313,186,49],reconstruiremo:161,deshabilitar:[70,367],them:[322,169,239,197,246,199,108,58,81,141,301,292,156,39,70,339,212,271,347,87],elegido:[11,248,226,271],pedimo:[],createformbuild:[22,99,297,178],fragment:[293,331,344,226,204],safe:311,restbundl:[213,101],pega:[15,337,167],"a\u00f1ad\u00eda":8,manejarla:167,responseheaderbag:[375,138],db_name:[349,70],proced:[314,221,197],"traer\u00e1n":293,traductor:[11,60,226,351],setvalu:[163,142],configurada:[77,78,166,98,99,326,121,277,278,175,70,197,148,331,332,367,218,342,110,111,346,186],retien:[],aport:350,caduqu:331,changelog:33,sonsulta:388,longtext:135,nombre_hidratent:[],colaborando:[26,372,1,116,89,313,174],"buscar\u00e1":[204,247,389,201,58,99,343,32,60,367],consiguiendo:[199,110,241,319,347],"regres\u00f3":383,buttoncrawlernod:343,conocimiento:[331,252,49],customtyp:351,"comprobar\u00e1":[128,383,286,190,186,367],descomprim:[337,92],estabilidad:[11,20],streamedrespons:[375,138],logo:[226,305,204,56],validacion:254,ommit:[],accessmap:219,"_demo_secured_hello_admin":242,hogar:[341,8,16],some_key_from_abov:58,cargada:[213,14,149,241,347,111,346,106,297,342,319],buscando:[328,184,18,255,1,145,20,250,8,389,204,165,199],"colocar\u00e1":367,setemail:[22,178,74,207],"movi\u00e9ndos":11,"pas\u00e1ndol":364,generamo:[],ella:[18,91,1,145,92,190,375,353,26,5,138,362,99,8,121,305,331,84,367,260,14,343,344,186],format_verbose_nomax:364,standard:[322,273,233,145,58,92,8,121,41,156,87],"sum\u00e9rget":[26,121],nth:240,borren:386,aparecen:[363,293,288],realizar:[51,18,241,210,166,243,136,205,99,121,277,219,383,222,84,150,64,286,259,260,14,108,68,338,343,110,293,204,186,161],sensio_blog_comunicado_index:[],optimizarla:[367,341,16],createj:213,regresa:[266,383,222,331,140,256,166,152,358,7,94,157,210,186,211,330],contribuyent:14,pseudolenguaj:180,getacmemailer_transportchainservic:353,mvc:[37,8,211,161],disfruta:161,buscara:228,"poni\u00e9ndolo":[2,367],subtl:358,realizan:[286,319],isequalto:[102,247],"representaci\u00f3n":[384,266,34,268,222,99,331,108,109,363,60,127,84,161],prestando:146,completars:1,chonfig:328,render:[341,74,234,206,273,355,93,207,329,222,326,22,285,167,245,327,322,246,213,56,137,28,97,140,29,134,99,82,121,216,359,305,34,204,197,178,331,64,85,310,154,65,294,127,43,287,13,300,44,108,67,202,235,344,293,70,295,181,161,346,186,347,113],organiza:[176,48,341],independ:[141,347,87],correspondient:[266,342,206,219,207,329,166,135,213,56,355,97,139,249,29,99,82,216,277,359,305,33,328,62,330,255,178,85,154,287,127,128,232,13,338,44,67,202,343,294,295,181,113,186,161],acmegoodbyebundl:175,adopta:331,role_comment_1:136,comic:84,blog_path:141,hidratant:148,tag2:202,"ocurri\u00f3":[363,384],role_comment_2:136,listener2:131,"resoluci\u00f3n":[319,151,299,215,182,211],invocado:[177,383,119,221,286,46,2,178,22,210],invocada:[14,197],myrssblock:246,enfrenta:136,"cu\u00e1n":346,asegur:[145,366],getlocal:[224,60],addition:[375,70],corresponden:[99,186],circundant:181,mailcontrollertest:43,receta:[371,247,148,92,99,157,362,135,167],sessionrequestprocessor:176,"contrucci\u00f3n":99,admin_sandbox_main_editablestaticcontent_edit:86,restringiendo:177,provid:[239,162,1,102,242,245,170,247,136,58,141,326,217,367,280,62,70,273,256,226,87,338,339,108,110,111,186,347],registerprefixfallback:224,bandera:[175,293,20],"contin\u00faar":314,database_password:[115,349,30,326,16,277,166],minut:[235,285],abriendo:[179,144],contento:204,manualment:[268,294,145,20,349,319,383,241,351,346,22,23,167,272,322,99,8,172,60,175,329,70,84,85,179,226,388,258,153,14,204,154,297,90,48],evolucionado:161,ponlo:[37,321,226,355],salvar:226,ponla:[148,331],"alej\u00e1ndos":[359,295],formatterinterfac:176,realm:[58,186],primaria:[210,243],"6_no_priv":112,containerinterfac:[14,234,326,336,23,366,392],licenciado:345,transmit:285,requirida:110,loadvalidatordata:3,anatomi:141,interesada:161,alojamiento:[265,92],"devolver\u00eda":142,usernam:[284,349,62,25,193,247,58,134,98,142,100,102,204,256,226,227,388,338,343,70,16,181,186],"_controlador":313,legibl:[288,341,260,350,363,345,188,305,161],acl_object_identity_ancestor:[286,58],"a\u00edsla":[343,361],promueven:[8,204],programm:[],knpradbundl:81,sub:[310,339,318,87],passthru:371,diferido:[17,383,330],paradigm:[],mybundl:[176,330,331,68,156,86,70,312,210],minheightmessag:105,mailcollector:43,diferida:[330,247,336,270,338,2,293,209,166],reconocido:[22,228],notnul:[50,269,75,38,93,99],bracket:[],wildcard:[],responden:197,request_context:90,reserva:[224,201,60],establecerla:238,traduc:[35,338,342,11,89,60,346],symfonycomponentvalidatorconstraint:[],acme_social_blog:158,introspeccion:135,unicidad:45,"act\u00faan":305,realizada:166,diccionario:[60,118],identifi:[273,247,256,326,70,347],form_error:[22,99,344,167,109],realizado:389,ogg:289,security_ident:58,involv:[],"funci\u00f3n":[266,216,138,314,294,163,341,242,2,329,79,361,346,190,209,375,166,383,167,290,247,355,97,250,362,99,98,344,121,142,358,122,60,252,305,384,175,307,177,161,226,222,103,123,366,178,331,84,85,11,153,154,387,277,185,182,127,350,128,183,377,12,13,363,260,130,291,287,234,202,240,343,338,293,389,204,46,181,73,313,186,244,113],just:[245,176,39,213,273,314,327,1,163,202,131,141,110,81,70,199,347,87],getmail:278,despliegu:[322,268,389,20,226,241],zend_service_amazon_s3:177,document_tre:[245,301,86],transforma:[341,345,342,344,142,228,188],qsa:205,acmestorebundleentitycategoryproxi:166,getord:[46,2,23],"remitir\u00e1":331,declarado:[119,186,6],suprimida:7,automatizada:158,organizacion:146,comoda:[],controllerresolverinterfac:[383,211],suscribirt:[338,166],suscribirs:293,hasxxx:47,obtenga:[129,270],searchtyp:216,sorprendent:305,concluida:33,runa:119,cleanli:[],delete_form:298,distribucion:145,sentido:[240,206,300,2,22,166,193,137,28,18,82,8,359,310,153,285,259,14,295,46,346,235],black:[61,7],dependa:[184,349],localizador:299,ofrecida:[256,18],detectada:367,abstracta:[266,267,238,200,189,299,350],auto_incr:[135,141],dividir:[152,206],dynamicrout:[96,255,339,342,110,111,347,367],awar:339,"publicaci\u00f3n":[308,218,111,18],htaccess:[169,386,205],bien:[306,222,238,268,0,18,314,91,145,20,349,77,93,2,383,80,346,30,271,146,193,331,56,136,248,205,362,99,380,23,121,60,204,33,319,175,144,62,167,111,254,36,166,199,84,150,11,179,259,386,294,341,182,92,158,231,218,288,363,290,14,108,342,202,335,305,389,343,110,293,70,16,46,72,161,47,186,49],cannotbeempti:193,drawn:[],awai:[],commandtest:[61,7,35],accord:[110,327],a6c1e0b6:386,var_dump:204,condicionalment:153,"guiar\u00e1":121,sendnewslett:259,errorlist:93,subfold:[],elaborada:[342,222],insertada:166,behaviour:[245,347],"visi\u00f3n":[],trasladado:8,contentcontrol:[315,347,273,367],han:[18,19,145,20,93,2,241,22,4,247,139,30,99,319,331,152,226,334,350,109,344,89,46,313,161],modular:[328,319],requesta:234,estuviera:[305,254,319,247],howev:[322,254,197,240,273,58,217,327,347,170],requestb:234,ahora:[298,92,93,354,2,40,302,6,99,7,305,101,306,102,273,199,14,15,202,110,204,16,313,222,205,145,115,219,207,319,21,208,117,23,24,211,25,322,323,213,30,326,8,121,353,32,327,33,35,331,124,125,226,71,228,337,338,130,56,234,343,46,371,346,48,341,52,349,241,242,362,135,247,136,248,139,142,251,60,61,144,62,146,255,149,64,153,368,157,72,73,161,266,74,268,77,166,167,271,380,277,382,383,283,84,86,388,184,391,293,89,392,297,186],com:[0,92,93,300,2,191,298,5,303,6,7,215,9,273,199,106,200,14,201,204,313,138,145,115,382,22,72,211,25,323,213,326,8,32,218,33,221,319,37,39,124,224,227,43,231,341,131,343,344,46,346,48,239,240,349,350,246,247,248,249,134,142,358,60,61,12,62,147,148,180,152,153,65,259,261,68,264,69,70,158,161,163,77,78,375,271,81,212,176,177,383,384,283,84,64,388,156,289,186,89,90,363],"com\u00fan":[138,91,145,308,93,2,383,375,166,25,99,8,388,252,319,144,62,222,148,84,149,286,226,71,14,109,293,204,46,157,73,346,49],con:[268,0,375,91,1,297,189,92,93,354,2,284,190,3,166,95,4,193,5,96,302,97,98,6,99,7,251,388,216,9,100,305,101,10,308,102,197,198,199,311,104,349,11,298,222,105,310,106,107,299,200,13,14,201,15,202,109,110,111,16,312,313,113,347,17,108,256,18,158,19,206,20,177,318,207,281,329,21,346,22,117,23,24,211,25,321,26,322,54,213,214,119,28,29,30,31,326,8,121,353,32,306,218,204,33,355,219,220,34,35,254,37,331,221,124,293,125,157,126,40,226,227,41,286,42,336,127,43,229,128,337,129,287,325,338,44,340,247,234,131,45,159,343,225,249,319,137,46,345,328,371,47,380,48,49,341,238,240,348,335,267,140,350,309,241,351,352,242,228,362,55,135,245,118,265,56,136,57,138,139,58,356,134,301,250,334,142,357,358,60,252,248,360,61,369,144,62,63,147,231,255,115,149,150,64,152,153,364,154,65,212,185,66,258,367,259,368,260,289,67,262,69,70,130,71,72,370,235,161,266,74,315,162,342,163,77,78,253,79,80,270,209,146,168,210,273,171,359,314,271,379,82,344,148,172,167,279,280,175,176,382,383,384,283,282,178,385,84,224,85,179,323,86,180,188,182,285,277,183,184,88,288,363,389,237,291,90,377,391,145,89,294,295,181,392,386,205,186],definiendo:[231,353,193,0,266,37,385,354,362,365,191,280,117,60,159,135],trunk:92,peacefulli:[],permut:[],centralizar:[14,2,248,46,271,161],wider:[],guid:[],bootstrap_cach:144,"a\u00f1ad":[247,0,91,94,193,96,99,7,101,102,197,286,105,108,202,110,312,17,138,314,145,318,207,22,117,23,24,211,322,213,326,121,32,218,33,329,330,332,124,226,228,231,338,130,56,343,344,386,161,346,48,349,350,241,353,341,136,60,61,62,128,255,180,154,66,366,367,157,371,266,77,221,375,166,167,82,175,282,383,178,85,86,182,293,294,181],hablamo:331,"convirti\u00f3":228,my_test_env:343,atribuir:[188,80,345],estaban:193,controllerindexact:110,coloca:[383,222,341,346,145,318,179,110,293,388,313,101,367],subscrib:[267,131,2,293,70,46,327],mysuperpag:218,mailer_host:[117,227,353,16],clearli:339,coherent:[152,84,89],"est\u00fapidament":207,considerablement:99,"codificaci\u00f3n":[26,102,313,58,151,350,284,256,242,158,367,47,186,33,174],my_post_controller_servic:354,reproducirlo:[99,206,204,77],ident:[136,264,135],properti:[50,387,91,163,269,93,190,79,352,165,376,54,208,3,244,95,291,247,324,123,58,263,99,195,32,373,122,60,327,254,36,39,38,126,333,257,250,105,155,185,128,183,12,290,339,112,45,187,391,338,70,181,297,186],reproducirla:204,procesen:161,aim:[60,347],fos_us:184,gna:92,orientada:[17,84,138,260,14,221,386,334,277,375,166,211,161],"aplicar\u00e1":228,publicli:[44,322],orientado:[46,2,386],getphpcrsess:326,findonebi:[312,228,338,166],my_in_memory_provid:58,memcach:[148,388,20,49],"funcionar\u00e1":[62,250,389,202,6,153,293,351,211],conf:180,usuario1:58,setid:[386,357],dumper:[363,319,384],conn:78,sometwigload:293,default_context:[255,326,86],perform:[358,322,169,327,87],getmetadatabag:[386,49],couchdb:18,informacion:[],"obt\u00e9n":33,getlogdir:[306,233],defaulttru:193,descend:[142,240],setnorm:39,fosrestbundl:[383,101,81,213],hand:[281,141],testigo:[220,62,344],nix:370,preferencia:110,building_config_tre:152,evit:[46,2],raiz:145,useradmin:23,seguimiento:[337,349,92,241,22,279],hant:154,figuran:[22,293,166],recurso:[18,19,219,318,299,116,319,242,209,166,191,167,26,193,341,139,58,356,6,98,8,121,60,279,384,174,220,309,222,198,37,331,84,149,153,226,365,106,363,14,201,354,383,159,293,204,16,158,346,186,371],campo:[298,91,189,93,95,96,97,362,99,146,102,273,286,13,108,202,109,111,113,18,206,207,22,210,25,28,29,31,216,122,218,327,329,123,331,88,228,127,128,232,338,44,342,45,343,344,355,349,135,245,247,57,58,250,142,359,254,154,185,67,70,235,266,74,373,76,77,80,166,167,82,380,280,178,84,85,387,182,285,310,287,290,291,137,391,293,294,295,181,297,186],causando:25,"decisi\u00f3n":[219,221,342,220,53,99,392],setsynchron:234,obien:[],imaginemo:[],master_request:[251,383,211],contact:[283,1,84,64,343,204,22,60,346,347],supervisar:389,aplicarl:99,caprichosa:90,preferiblement:[],arranqu:[341,220,196,247,136,104,145,189,389,343,70,371],findonebyid:[338,166],preconfigurada:[331,121],"operaci\u00f3n":[136,342,202,338,388,210,297,49],startinlin:180,"sali\u00f3":268,preconfigurado:[34,125],mongodbuniqu:207,getkei:62,explorado:242,packagenam:344,somedomain:[],"tuber\u00eda":[],boot:[35,229],posteriorment:[319,331,23,166,135,161],getenabledformatt:252,prueb:[343,117,35,361],provista:[109,158,342],setemptybarcharact:364,denegado:[383,139,186],provisto:[136,148,342,286,99,388,186],duplicar:[177,268,138,226,375,161],mayb:[],mayo:[11,215],gemer:266,admin_area:247,fusion:[313,33],"espec\u00edfica":[266,108,1,145,77,2,383,117,166,135,167,171,136,338,99,98,8,211,60,319,282,84,204,197,331,221,64,153,341,92,285,367,218,337,260,14,15,342,131,68,109,343,110,70,311,46,346,186,49],"espec\u00edfico":[0,92,93,2,193,97,98,362,99,7,10,176,102,310,13,14,202,110,204,16,113,18,206,22,330,119,29,8,216,329,222,331,125,334,228,127,72,231,337,338,44,342,343,344,46,346,49,352,341,355,60,315,255,153,154,359,260,67,157,158,266,145,162,77,253,80,166,167,82,380,277,280,175,281,383,178,84,85,386,286,287,293,294,295,181,392,186],capa:[267,18,1,189,78,383,241,242,375,166,211,361,213,247,119,138,277,218,33,102,331,221,60,202,343,70,71,392,346,186,161],some_variable_nam:[],"emparej\u00e1ndola":298,restablecerlo:268,filenam:[375,297,87],foobaract:[231,0],descomprimido:121,acmebarbundl:322,getallowedoptionvalu:[],night:[],sessionmod:148,"adopt\u00f3":[11,204],punteada:[329,178,85,154,294,181],negar:[62,186,247],contengan:204,root_dir:[306,322,147,103,341,14,388,148,153,217,16,165,71,73,346,166,48,213],provecho:[99,205],manual:[327,109,268,20,349,81,141,341,99,241,70,217,166],multilangsimpleblock:339,flatten:[],salir:[186,16],deprec:[47,3,33],bord:[242,331,186,318],role_user_ip:186,all_publ:112,securemethod:119,router_proxi:[],my_class:212,juev:281,peek:386,plu:[],choicelistinterfac:178,queda:[242,331,367],routingautobundl:[1,141],ordena:[338,177],pretendido:[14,8],"cap\u00f3":[210,346],dibujando:[197,108,140,77,109,326,167],repositori:[327,349,273,270,338,57,199,39,261,140,45,326,86,70,339,312,210,313,166,367],coloqu:313,post:[74,0,332,138,189,93,207,383,22,210,135,25,375,213,354,136,57,58,141,99,98,243,142,83,100,101,253,37,331,84,298,226,42,43,230,231,274,346,67,202,109,343,156,204,119,297,186,161],"simult\u00e1neament":[22,109,386,202,166],outputinterfac:[61,35,268,314,7,172,90],obj:[245,318,244],diner:376,setrequir:[228,110,39,367],swift_smtptransport:[117,353],"inspiraci\u00f3n":[],zambullirt:[327,146,135,16],zxvf:145,underli:[327,273,137,28,108,285,310,335,235,280],"propagaci\u00f3n":[46,2],admin_list:86,"float":[308,193,288,338,363,352,166],bound:[245,327],afecta:[44,144,215,29],useencod:330,"r\u00e1pida":[286,146,147,389,1,180,327,93,8,351,318,16,209,305,211,49],pantalla:[186,204,341],includejsfil:213,"r\u00e1pido":[0,205,145,166,167,26,121,381,305,331,84,104,11,153,386,231,338,270,389,343,344,204,16,71,186,161],registerextens:[153,319],loadvalidatormetadata:[50,373,208,269,93,79,80,352,190,376,54,95,291,250,123,263,99,195,32,122,60,254,36,38,126,333,105,155,185,128,183,12,112,45,187,391,297,257],page_titl:[305,204],accordingli:141,solicitarlo:[248,271],minimizarlo:322,wai:[245,194,327,170,273,281,261,1,163,234,271,110,347,70,339,156,233,342,87],anexarlo:218,"defin\u00eda":60,sha512:[102,58,256,186],default_local:[60,226,16],deshabilita:7,maxim:247,subformulario:[99,202],"true":[93,300,2,284,94,193,96,97,99,7,121,9,101,10,102,197,198,104,310,277,12,13,14,201,108,202,110,204,16,312,113,256,138,314,19,206,318,190,22,210,211,25,54,213,28,29,30,326,216,218,33,329,111,37,331,221,225,226,334,335,127,338,130,234,131,45,343,344,355,46,346,347,238,349,58,350,134,55,247,137,268,140,141,250,359,61,144,163,254,255,148,339,64,153,154,66,367,259,207,289,67,68,264,70,44,235,74,162,75,62,375,166,292,81,82,380,172,175,383,178,85,386,180,388,285,287,288,363,389,187,391,293,294,295,181,392,297,186],guessextens:[297,67],reset:[],maximum:[128,246,105],ayudant:[314,77,350,320,167,213,63,56,326,99,7,172,60,308,34,222,331,364,65,367,108,262,186,110,293,204,158,346,159,161],"agr\u00e9galo":293,siquiera:[341,338,286,153,2,242,166,161],colecciona:[],minor:313,encodingstyl:9,"concord\u00f3":[346,186],emit:[56,166,49],"agr\u00e9gala":102,lleve:[20,32],guesser:70,some_const:350,lleva:[193,18,14,84,125,153,110,241,32,178,22,186],detenido:[152,2],llevo:8,"abstract":[78,350,238,335],"se\u00f1al":256,tablehelp:34,desviar:144,fuertement:[245,186,244],symfonybundleframeworkbundletestwebtestcas:[],archivo:[0,189,92,93,284,191,166,193,96,240,6,99,7,305,101,10,102,197,199,104,105,299,14,201,15,202,109,110,111,16,313,18,19,145,20,177,319,21,23,24,211,222,26,322,213,214,30,326,8,121,243,306,218,204,33,328,332,35,331,311,124,125,40,226,227,71,128,337,129,338,130,247,342,343,344,133,248,345,353,371,346,48,341,238,52,349,350,241,351,362,135,244,56,57,138,140,356,134,142,358,60,61,144,315,147,231,255,148,149,180,363,65,366,367,368,260,289,67,304,157,158,73,370,159,161,266,267,75,375,275,167,273,171,271,277,175,176,382,384,283,385,84,179,86,64,388,118,184,288,153,389,186,377,293,89,392,297,90],config1:193,config2:193,dependient:[260,248,385,270,8,271],stringutil:186,cuya:[19,28],encrypt:[284,227,134],getfullpath:141,alternando:204,cuyo:[74,206,93,207,2,166,167,247,99,359,383,331,310,153,337,338,341,342,186,260,110,204,46,235],aleja:49,entrypoint:139,ampluso:89,test:[189,23,35,341,194,244,33,144,361,196,273,84,64,226,182,43,229,87,184,343,204,16,158,186,371],recientement:[313,124],registrationtyp:[207,74],realiti:141,mail2:212,mail3:212,mail1:212,imageurl:266,symfony_cmf_blog:156,blankvalid:257,enrutado:[341,369,0,18,118,354,351,242,243,298,245,283,96,56,57,205,356,8,121,60,305,144,383,222,197,37,84,149,150,223,86,218,106,367,230,231,184,339,108,342,343,110,293,204,226,158,346,161],textarea_widget:[99,167],seccion:[193,319,341,166,199,139,53,77,152,69,365,186,191,167],inicializar:[],endstylesheet:[71,322],errormessag:[93,172],file_put_cont:[363,62,319,384],anywher:[326,156],"computaci\u00f3n":331,countrytyp:85,config_:[144,341,87],post_send:390,precedent:343,afinar:[331,186,70],asimilando:[],global:[52,315,189,319,320,375,211,167,214,56,138,6,99,121,357,212,33,253,63,273,84,153,86,258,87,368,14,341,270,68,109,344,204,226,90,161],content_url_gener:96,switcher:339,actualizar:[238,138,145,115,92,241,21,375,166,56,268,99,277,305,33,273,20,331,124,179,335,337,338,346,341,202,389,71,297],"generar\u00e1":[19,145,66,5,330],abstienen:219,zona:[329,331,137,28,20,235,204,285,186,161],atributo:[222,375,138,294,385,206,318,242,383,22,117,134,386,209,211,25,193,213,295,355,97,29,362,99,82,162,32,348,216,60,297,10,307,219,329,167,142,166,178,331,84,85,286,354,154,41,42,127,210,367,359,287,13,338,44,108,67,202,305,157,109,343,344,293,70,181,71,392,237,113],getpublishedat:331,impulso:136,cannotbeoverwritten:193,flash:[242,386,237,222],enlazaron:[],proporcionen:96,preguntast:[26,304],aclara:331,relaciona:[277,202,166],variada:331,acmedemobundle_extra:81,imagecontrol:213,internacion:[],"c\u00f3mo":[298,1,189,92,93,300,2,284,94,4,193,5,96,303,192,98,6,99,194,9,100,305,10,102,196,197,198,199,104,349,286,106,200,14,112,15,202,110,204,16,313,222,332,138,314,19,206,20,317,318,207,319,22,117,72,211,25,227,323,213,28,30,326,8,121,353,32,306,218,327,33,219,220,34,35,331,311,293,125,40,226,223,71,228,43,229,231,337,338,130,340,247,234,131,159,343,344,249,133,248,46,328,371,47,48,49,341,238,52,267,140,241,351,242,362,135,245,56,136,137,205,139,58,356,134,59,142,251,60,143,144,62,167,63,147,255,115,339,149,150,64,152,153,364,258,367,259,215,368,260,252,361,369,67,68,374,70,265,157,158,235,160,161,266,74,315,268,342,77,78,253,270,275,146,168,375,273,171,359,166,379,276,380,277,83,280,175,176,382,383,236,283,178,84,322,296,182,285,87,184,346,390,90,377,145,347,295,181,392,297,186],value_inside_a_rang:193,"3am":[],"portugu\u00e9":89,"colorizaci\u00f3n":7,sujeta:[17,27],entretanto:[],loglisten:336,kitten:186,octob:[],comunitaria:161,alojar:158,brows:347,funcionar:[144,62,35,56,338,14,341,386,204,91,166],followlink:177,mystaticvalidatorclass:80,otorgando:136,dibjado:[],presenten:99,mypublicservic:119,seleccionast:190,especifico:[],mysubscrib:70,especifica:[294,206,189,80,164,23,40,377,213,341,359,326,178,60,143,204,33,144,329,226,70,148,331,149,85,310,153,154,388,66,210,367,218,290,108,338,343,110,111,181],funcionan:[231,0,240,149,11,179],funcional:[144,145,99,343,357,158,361],upper:204,regres:[157,219,383,367],alfa:[],cosa:[266,74,51,0,75,20,349,93,165,2,383,80,346,22,210,166,211,222,322,213,247,140,134,99,8,172,244,252,305,33,319,219,144,62,361,204,331,84,149,180,153,386,277,228,231,184,288,363,207,14,341,202,131,109,338,389,70,16,46,157,158,47,186,161],colaborador:11,repetitiva:[61,383,222,338,7,16,166],everytim:245,bindec:360,cubra:186,phpunit:[349,151,179,343,182,158,33,371],"descubrir\u00e1":60,cubri:[],profundament:49,participar:281,methodcal:282,"raz\u00f3n":[314,128,322,62,166,234,1,206,38,338,45,99,389,204,355,228,257,211,161],"aseg\u00far":[145,115,349,58,241,362,166,135,213,96,56,140,134,99,326,60,360,102,346,273,255,20,331,221,124,153,92,182,77,184,337,179,389,14,341,202,187,392,297,186,363],appear:327,loaderinterfac:[231,144,0,341,81,299,293,65,60],curso:[331,137,28,285,351],service_contain:[366,392,234],grabando:157,quedan:342,carga:[341,20,328,77,299,346,384,23,166,211,330,255,96,247,99,326,8,121,142,60,331,272,144,319,197,37,199,84,149,153,386,182,367,259,363,389,14,201,15,67,343,110,293,70,16,158,297,186,48,161],manejan:[260,82,211],cargu:[175,144,319,341,338,299,8,293,70,23],selecciona:[331,29,343,142,242,166],acme_foo:322,estambul:329,gener:[341,0,18,342,1,315,118,77,93,300,2,241,326,242,134,386,271,135,25,245,322,193,56,136,57,389,58,81,141,99,98,156,243,277,9,60,327,280,281,144,383,167,204,197,166,148,331,339,286,153,246,86,334,321,367,230,231,259,260,14,233,108,234,338,274,110,360,111,248,46,226,392,161,346,186,347,49],unauthor:87,"responder\u00e1":331,notificado:[46,157,2,139,249],basecustom:200,doctrineodmphpcreventlifecycleeventarg:[],derivar:[188,121,345],ifarrai:193,diextrabundl:[330,302,221,124,21,66,278,366],"gu\u00e1":[],bucl:[299,186,204,305],ini_set:[202,49],"especific\u00f3":102,routeprovid:[108,342,347,367],hydrator_namespac:388,"acci\u00f3n":[51,162,314,219,77,93,2,62,228,242,210,166,243,331,56,136,240,139,99,98,121,277,60,305,33,61,176,382,102,222,37,199,84,286,153,42,43,367,129,260,14,354,202,131,338,383,293,204,46,157,346,186,161],"_want_to_be_this_us":186,incorporada:[331,145,121,186],"revisar\u00e1":213,macintosh:84,csrf_token:344,integer_widget:167,regardless:[245,350,327],extra:[18,145,207,21,165,141,167,193,96,302,162,81,362,326,8,142,218,360,306,176,383,254,197,37,124,256,334,127,202,109,343,110,293,204,157],filterbynam:277,correccion:33,italiano:89,toarrai:247,"m\u00f3dulo":[8,370,319],http_:343,should:[50,239,314,373,206,269,93,79,352,285,54,3,291,375,213,292,137,28,7,81,141,82,335,122,359,327,61,254,273,123,199,39,38,310,226,387,217,43,87,350,183,185,290,339,257,234,131,45,187,156,293,70,295,386,313,235,347],createform:[74,170,207,202,93,99,228,327,222],difunda:[46,2,249],regex:[93,250,75],httpd:145,cookiejar:[343,47],"contin\u00faa":[186,204],"gu\u00e1rdalo":[71,158],"ejecutar\u00e1n":[93,238,335],"gu\u00e1rdala":16,acmehello:14,subvers:[265,145,189,92],"as\u00edncrono":[204,197],live:[322,84,234,169],usertyp:[207,74],greetcommand:[61,7,35,268],storage_id:[226,30],"di\u00e1logo":[314,7,186,262],max_fil:264,"sobrevivir\u00e1n":40,"as\u00edncrona":[],isauthent:[209,186],database_driver2:115,"instrucci\u00f3n":222,contienen:[231,177,84,0,389,221,104,262,77,343,184,328,277,210,346,211],ctype:370,anuncio:215,symfony_extra:37,phpcr_workspac:70,chocan:214,soportado:[],unseri:247,persistiendo:[242,277,338,166],purgu:[331,318],intercept_redirect:[211,121,55,64,16],routeenhancerinterfac:[110,342,367],iba:331,prepar:[199,375,186,81,138],focu:240,estupendo:228,can:[213,239,314,261,1,206,273,294,329,254,22,375,271,25,245,322,169,170,137,28,58,81,141,326,156,335,32,358,217,212,327,282,163,226,111,197,178,199,39,85,152,246,86,181,285,87,310,367,339,313,233,108,234,202,131,270,292,110,347,70,311,154,297,235,342],grouping_us:[359,206,295],pre_set_data:[46,2,146,327],content_id:[110,342,367],cae:311,boilerpl:[],fromrequest:[231,0],"us\u00e1ndolo":[209,58,360],noch:[313,89],escarva:213,"us\u00e1ndola":278,perder:277,reflectionmethod:221,abort:[],implican:286,occur:[176,382,383,289,261,311],cookie_path:226,reposititori:[],multipl:[329,226,294,178,233,108,212,58,85,190,156,154,142,22,181,362,313,327,342,87],productivo:[84,161],propertyaccessor:163,minheight:105,encontraron:193,importarla:167,"retrasar\u00e1":330,database_charset:277,importarlo:[153,351],anota:354,product:[239,222,338,115,131,327,146,277,87,166,229,167],adoptado:11,factory_method:[164,143],aop:221,situacion:[342,362,343,388,186,135,167],"detr\u00e1":[272,93,322,375,18,110,341,331,138,166,78,109,8,121,204,286,293,60,186,211],sugier:[342,33],"estar\u00eda":[193,248,204,16,72,271,161],choice_widget:362,pricefilt:270,encabezado:[307,56,180,64,204,305],sonatajqueri:244,explicit:[],base_field_label:[],aportado:342,capistrano:20,comenzamo:166,vaya:[331,108],escalar:[203,193,288,30,363,383,190,228,242],anoth:[245,40,213,233,39,58,81,141,194,386,204,335,22,66,327,347,87],helloact:[259,222,305,8,121,323,242,186],coloreando:[61,172,7],vertedor:[363,384],jmsdiextrabundleannotationinject:[],asociativo:[193,127,254],asociativa:[],ileg:161,hacia:[350,359,222,241,295,338,1,84,11,153,226,277,228,60,47,166,33,161],getstarttim:152,hydrator_dir:388,filtrando:[71,40,334,142,377],dynam:[110,273,255,342,189,99,156,312,327,280,367],cola:[284,171,189,180,134,258,90,48],forma:[298,91,92,93,2,56,98,99,286,14,15,202,204,311,313,18,206,20,318,164,23,211,222,322,28,8,121,218,33,328,319,331,16,125,335,336,337,129,338,341,234,343,248,46,345,346,49,238,388,349,241,351,353,247,137,58,134,142,251,60,143,360,144,148,149,153,67,157,235,266,271,167,166,82,176,177,178,84,179,386,181,88,389,186,293,188,297,90],newsletter_factori:[164,143],precondit:[],logout_url:344,yaml:[298,91,93,300,284,190,3,191,166,95,193,5,96,302,303,6,99,195,9,100,101,71,10,308,102,103,273,105,106,107,299,278,12,376,14,112,108,202,110,204,16,312,313,257,205,115,317,319,208,164,117,24,211,25,200,322,54,213,324,36,30,326,8,121,353,32,306,122,218,362,327,33,222,123,37,331,332,38,125,126,354,40,226,227,41,228,72,128,338,130,247,234,131,45,343,225,249,133,346,48,341,50,238,52,348,335,349,140,241,351,352,134,55,135,245,56,136,248,58,141,301,250,333,251,60,143,360,144,62,254,147,255,148,180,153,155,367,259,260,252,369,68,263,264,70,339,157,158,73,159,266,203,162,373,269,77,78,79,80,165,270,209,167,197,292,81,271,98,344,212,175,176,382,384,283,84,323,86,64,387,388,183,185,288,363,290,291,90,187,391,293,347,392,297,186],window:[245,289,199,7,71,33,244],servirlo:[322,40],countabl:[373,39,45],protegida:[5,338,139,202,256,166,93,99,98,204,242,278,186],non:[230,57,358,335],marzo:215,finalmatcherinterfac:342,internacionalizada:60,internacionalizado:283,factoryinterfac:108,redirija:[],protegido:[259,98,225,204,242,278,186],huella:331,equidistant:359,now:[327,254,339,199,39,202,81,141,156,217,270,271,347,25],discuss:[281,261,347,339],nor:[],introduct:[288,14,385,180,363,159,212],formbuilderinterfac:[266,74,146,202,362,99,380,70,228,327],setrequest:234,matcher_class:205,relleno:[172,222],rellena:[102,293],drop:[166,327],mappedbi:[166,202,135,247],explotando:9,un_proveedor_personalizado:[],gettag:202,enjuagan:343,domain:[169,136,58,98,344,293,106],auto_route_map:141,setcurr:364,replac:[239,138,39,202,141,251,344,386,70,335,22,375,47,347],vuelv:[234,2,211,247,99,98,110,91,218,175,366,60,389,14,201,342,344,204,46,161,313,371],fixer:33,recibir:[341,382,315,289,14,199,302,202,2,121,46],findbi:[338,166,45],year:[137,28,346,285,142],min_width:105,gedmo:[148,168],happen:[217,182,339,87],flujo:[18,189,308,93,2,241,166,211,139,357,277,173,176,177,383,197,385,84,53,363,386,288,338,186,343,265,46,328,49,159,161],arbitraria:[288,338,363,8,166,222],regenerar:[389,19,331,204,49],accomplish:81,corregiremo:[],concuerd:[346,186,341],wsseprovid:62,arbitrario:[231,0,131],condicion:[129,247,338,331,138,68,207,388,345,188,375,166],"a\u00f1aden":[383,319,197,20,202,367],regeneran:205,"seleccion\u00e1ndolo":343,asistir:18,foocontrol:157,recolecta:[],excedent:[287,13,355,97,216,127,113],cart:186,averiguar:[179,15,84],"especificaci\u00f3n":[384,138,260,331,84,125,93,363,121,133,226,375],caro:[277,166],"ubicaci\u00f3n":[0,118,177,190,213,341,57,362,8,60,306,144,146,147,84,149,153,230,231,184,389,14,130,67,204,16,71,297,380,161],card:[126,376],care:[358,234,273,141],loginact:[225,186],luego:[341,74,360,18,294,19,145,20,177,92,93,319,383,21,22,166,23,24,271,167,255,193,213,247,136,248,268,139,326,134,99,98,344,121,251,277,60,305,33,306,176,382,102,222,273,36,37,149,331,84,124,349,153,330,259,86,41,182,77,127,218,337,179,338,14,311,202,343,110,293,101,204,16,328,386,321,313,186,161],getnamespac:[153,319],"incluy\u00e9ndolo":346,domel:142,lambda:343,acelerador:[331,318],memorizar:[319,389,331,300,388,201],directli:[169,233,39,202,141,326,226,335,327,212],"_text":[343,142],"desempe\u00f1o":331,simpleblock:[245,326,77],blink:[61,7],acmemailerbundl:[4,353],automatic_controller_inject:165,comprobacion:[286,91,259,162],memorizan:[144,341],ring:34,tomorrow:[37,99,150,307],actionblock:[245,246,140,77],size:[128,177,290,70,105,277],mejorando:[],project_access:169,llegar:[145,240,331,84,383,204,71],"7308e59b97f6957fb42d66f894793079":247,caught:51,riesgo:[268,204,161],"ense\u00f1ar\u00e1":204,checker:[],max_length:[287,13,355,97,99,216,113],rounding_mod:[359,295],"invalidaci\u00f3n":[331,318],cachewarm:293,llegan:84,friend:327,ajustar:[277,62,380,268,14,15,104,64,166,343,364,121,70,148,226,167,252,186,210,49],preparado:99,preparada:[281,166],fields2:99,"p\u00fablicament":[188,158,73,215,345],baja:[130,110,367],pomm:60,than:[361,213,123,289,163,81,327,8,351,70,373,122,212,271,87],png:[10,56,289,226,204,218,305,244],admin_without_local:339,"sub\u00e1mbito":286,symfonycmfblogbundl:156,extrayendo:343,containerconfigcach:319,localidad:283,depurador:[104,311],consultando:[338,277,166],browser:[156,202,197,87],empty_valu:[329,178,28,85,154,294,22,181,362],redefinido:[266,268],schematool:[78,267],estudia:2,sensio_framework_extra:37,deliv:339,biofil:128,"__set":163,caus:[322,335,327,141],dividendo:161,usuariobundl:247,engin:[56,30,226,204,16,42,135],invalidst:187,doctrineparamconvert:210,kernel_dir:343,mapping_typ:[78,148],tradicionalment:[84,342,161],preg_match:[250,62,32],slave1:148,slave2:148,abarca:[121,371],wcm:313,begin:[217,221],explicando:[84,161],dibujar:[213,222,218,63,96,56,108,189,77,266,99,326,300,111,109,362,197,167],maxheightmessag:105,numero:313,sustituyendo:[306,144,238,213,331,104,233,335,149,249,356,385,153,351,204,311,275,101],rdfname:213,salvaguarda:62,alguno:[92,93,2,190,193,97,99,216,305,306,273,104,13,108,109,110,204,311,313,113,18,145,20,219,207,22,117,23,211,330,322,213,30,8,121,33,111,226,335,336,338,342,343,344,133,46,49,238,245,341,136,355,138,142,60,144,254,150,153,367,262,70,157,158,73,161,10,74,162,77,165,375,209,167,166,98,380,176,282,383,178,84,388,184,287,389,293,89,181,205,186],classnam:[344,213],"verificaci\u00f3n":[74,62,142,207,44,329,343,29,362,99,98,110,154,85,178,181,23,294,367],alguna:[0,1,92,93,2,238,193,5,99,146,305,306,115,102,273,104,286,277,14,257,202,109,204,16,313,201,18,314,206,20,219,318,319,22,117,23,211,25,321,26,213,214,28,31,8,121,32,218,33,332,222,37,331,311,38,293,335,228,231,337,247,234,131,343,355,46,47,48,49,341,51,240,349,350,353,244,56,137,138,139,60,252,62,361,254,147,128,148,149,180,153,364,367,359,368,262,304,70,157,158,235,161,315,268,342,308,77,80,165,375,166,167,272,82,172,278,281,177,383,283,84,386,256,285,310,184,389,346,145,89,295,181,297,186],"direcci\u00f3n":[284,373,93,22,242,166,211,272,391,247,58,134,215,121,33,254,84,64,354,226,12,290,112,171,45,343,392,346,186],kernelev:[251,383,139,211],twig_simplefilt:270,meanwhil:[],codifiqu:102,validpassword:256,newindex:[],encontrarla:[],hinclude_default_templ:[226,204],abstraer:[60,18],german:[],rendit:[],listenerid:62,"coincidir\u00e1n":346,headshot:105,andreia:89,abstraen:[342,211,16],"persistir\u00e1n":202,fifth:[],"40px":308,onli:[240,282,80,375,211,212,169,170,341,58,81,141,326,32,217,327,144,254,39,226,87,289,131,110,70,386,347],imitando:18,tienden:[46,1,226,2,18],chainuserprovid:256,annotationread:[],maxsizemessag:128,filesystemload:[293,65],"multil\u00ednea":350,overwritten:141,confiar:[272,146,331,150,327,182,2,8,226,165,158,186],ranura:[63,65,56],inevitablement:84,cannot:[282,123,373,93,250,86,122,297,327],getmessageplur:[],gethost:272,correspondan:[],vienen:[61,272,108,342,262,152,109,7,110,204,23],suced:[297,197,153,289,331,268,234,343,131,99,326,89,70,157,9,47,186,161],intercambiar:[331,357],filterbyexpensivepric:277,"imprementaci\u00f3n":107,error_log:[331,169],inhabilitado:110,un_nombre_de_paquet:[],apoy:20,ocurren:211,another_em:[],containsalphanumericvalid:32,relajar:18,convertido:[148,219,181,375,138],dbal:[267,18,115,349,78,241,166,136,58,6,326,277,144,273,148,199,189,286,201,131,70,16],"sin\u00f3nimo":260,enlazar:[99,326,297,204,367],indexar:213,ismal:39,contar:331,memorizando:[63,389,199,300,242,331,319],requerida:[183,185,70,123,255,373,291,208,387,45,250,79,111,352,190,122,290,367],"agr\u00e9gal":[61,7,15,35],sport:327,concern:[],"5c3bcec385f59edcc04490d1db95fdb8673bf612":247,encerrada:[172,121],codificadora:256,elmento:77,marcador:[0,206,22,242,210,166,56,137,28,82,121,60,305,383,222,197,310,354,106,285,231,359,341,202,295,346,235,160],datetimefunct:[303,148],"provocar\u00e1n":99,biblioteca:[240,91,145,92,78,2,253,241,23,166,211,168,265,213,341,383,158,134,99,8,60,176,328,84,384,147,221,322,11,179,386,43,93,337,363,260,201,15,342,338,343,389,204,16,46,72,161,186,49],ambo:[266,222,238,18,314,145,115,92,93,319,22,210,167,245,322,193,214,56,136,99,326,359,204,382,70,198,331,310,40,386,335,341,305,337,14,247,342,131,45,343,293,111,49,186,161],inventamo:161,between:[197,137,28,335,358,212],"import":[77,299,6,166,211,212,213,341,81,362,99,8,121,135,9,167,144,102,199,180,153,106,14,233,70,16,392,346],paramet:[238,0,332,52,342,20,92,242,351,164,117,30,271,135,212,245,193,213,341,248,205,58,81,6,99,326,8,353,344,277,143,385,102,319,197,159,166,362,199,39,153,246,226,227,335,156,231,259,337,339,283,14,234,90,343,110,70,16,273,157,158,186,347],amba:[238,294,335,242,23,166,167,341,391,326,357,277,60,329,222,147,178,331,256,85,310,363,226,181,106,367,288,111,343,204,154,346,186,161],datafixturesphpcr:70,amplio:[234,204],informamo:[],amplia:[338,84,145,166,167],conviert:[240,383,12,222,363,178,331,163,386,310,153,343,226,204,16,228,158,210,346,135,384],misterioso:56,set_data:[],"memorizar\u00e1":331,"devolver\u00e1n":247,tcpip:148,seguido:[4,288,36,255,294,118,363,2,353,142,46,158,33],admin_bundle_menu_multilangmenuitem_cr:[],suministrar:[310,118,84,145,243],groupbi:[],seguida:[322,84,331],seleccionamo:343,tutori:339,updateacl:136,antepuesta:175,asignador:[136,338,213,41],rss_reader:140,overview:[],cuando:[268,0,91,93,300,2,238,190,3,193,5,96,97,98,6,99,7,215,216,100,305,10,307,115,102,104,11,310,299,13,14,202,204,16,313,113,332,18,19,206,20,177,318,319,208,164,117,23,211,222,322,213,28,30,8,121,243,32,33,219,328,329,35,254,37,331,311,293,224,354,330,226,335,42,127,229,128,232,338,247,131,45,282,343,344,249,355,46,345,47,48,49,341,51,251,240,388,349,58,350,241,351,228,242,362,135,56,136,137,138,139,140,250,358,60,143,61,144,62,146,231,148,149,150,64,153,154,367,259,260,289,67,389,264,71,73,235,161,266,74,162,373,76,22,253,375,166,167,210,359,82,380,277,382,384,284,178,84,85,386,256,188,285,286,118,287,288,363,290,346,90,187,145,89,294,295,181,392,297,186],mask_own:136,dispatch:[245,51,390,139,131,94,2,383,334,46,182,336],strict_requir:[226,16],exploit:[],"_welcom":[346,184,121,204],enviando:[61,151,138,171,64,134,7,89,337,375,33],derivacion:17,pongan:11,afectada:215,findallorderedbynam:[338,277,166],contrario:[349,22,209,210,193,213,140,250,32,60,306,204,178,331,221,386,41,182,367,289,389,369,342,202,187,344,70,392,186],"caracter\u00edstica":[266,17,372,18,163,20,349,350,319,242,384,135,212,27,56,99,121,244,252,305,33,308,204,147,37,199,84,64,11,179,310,336,213,224,367,278,288,363,260,313,341,342,156,111,16,157,47],deduzca:[206,287,13,295,216,44,97,67,355,29,85,82,329,154,294,178,181,359,127,113],rebuild:[],contraria:166,conteniendo:[230,245,193,319,256,299,64],carec:[],getmock:182,task_success:99,endimag:130,getdoctrin:[74,136,202,99,228,297,166],repetido:[207,74],"delegar\u00e1":219,delivery_address:[284,64,134],rubi:[177,103],repetida:193,"c\u00f3digo":[0,91,1,92,2,362,99,7,215,195,305,273,198,199,311,104,11,14,15,202,109,204,16,313,17,18,314,19,145,20,177,318,22,211,321,26,322,27,324,28,31,326,8,121,327,33,222,36,37,331,221,124,224,334,228,231,337,338,56,342,270,282,343,344,46,345,47,341,51,239,251,350,241,242,6,353,247,136,248,138,357,358,60,252,61,144,253,146,115,150,151,152,153,367,158,73,161,268,77,375,271,167,180,166,380,277,174,382,383,385,84,85,179,386,64,182,213,288,363,389,186,294,392,90],cargadora:[231,0],rodear:[14,187],concedemo:[],activan:[8,297],foolisten:334,crecer:193,incluya:[319,137,28,206,285,310,153,82,215,295,359,235],admin_sandbox_main_editablestaticcontent_cr:86,trick:[],boletin:[238,335],exist:[222,238,138,1,206,328,92,190,319,383,241,39,94,375,166,135,167,327,322,193,273,341,136,163,81,141,99,326,8,300,353,251,217,60,19,242,282,102,204,147,199,84,254,11,153,386,334,335,286,228,127,367,128,359,232,289,389,14,311,131,45,292,110,337,70,295,339,72,47,186,347],activar:[162,241,209,168,193,213,341,134,99,8,142,360,175,144,363,259,293,71,370,186,48,49],buen:[14,383,273,211,33],incluyendo:[341,222,145,118,2,241,80,166,25,70,56,57,99,98,8,60,204,281,382,383,63,331,84,322,125,152,179,129,260,14,108,202,305,338,111,346,186,49],nextbyt:[186,360],permiten:[266,219,193,225,18,338,366,84,326,77,93,109,2,110,145,46,341,209,23,108,166],velocidad:[144,319,205,260,14,341,58,363,389,16,384],stdout:9,eran:[28,84],ofrec:[18,388,20,78,241,242,166,167,322,98,277,359,147,198,148,331,84,225,386,172,392,338,89,204,158,49,161],uncom:[],consulta:[0,92,93,2,190,298,362,99,10,102,273,199,286,105,14,257,108,110,204,16,201,222,18,145,20,318,319,209,210,211,25,322,213,28,8,33,111,38,331,311,124,125,226,228,127,229,231,337,338,341,342,131,45,343,248,46,346,347,50,284,249,241,351,242,54,247,137,138,139,58,142,251,60,315,147,148,150,153,367,259,260,369,68,70,161,74,269,78,375,271,167,166,98,277,361,176,84,179,388,285,186,187,293,181,392,297,90],referencedcolumnnam:[166,135],"dise\u00f1ada":[386,65],newsact:331,develop:[217,1,313,347,111],medio:[266,18,78,242,23,167,322,375,213,56,138,139,58,293,308,102,222,273,123,370,331,84,256,153,386,185,338,14,291,247,202,69,72,297,186,161],pathinfo:299,script_filenam:169,"a\u00f1adimo":[207,221],efectiva:[46,2,331],conectando:[46,2,388],medir:[152,144],document:[342,388,349,77,207,22,24,244,245,169,213,96,140,141,326,110,142,217,9,60,101,308,70,197,246,86,41,87,367,218,338,313,108,261,202,131,270,156,33,111,339,312,181,297,347],acme_blog_:158,pliegan:[],finish:[358,364,313,197,33],webserv:[],someon:[61,7,35],http_host:[343,84],clse:332,escasa:334,ispropagationstop:2,incluyan:204,perfilado:[158,211],distribuya:[338,129],"dir\u00e1":[93,266],rama:[313,124,21,33,41],radica:93,cco:64,fundamentalment:281,transmiten:60,getcountri:224,"indic\u00e1ndol":186,"_post":[222,138,84,242,375,211],hellorespons:9,touch:289,retirado:89,entrenar:9,speed:[],"aceptar\u00edamo":18,costumbr:[],warmp:293,utilizada:[138,163,77,350,383,351,242,375,222,322,193,56,137,28,99,8,60,204,176,144,62,35,331,84,104,64,286,246,389,108,342,305,377,111,47],complemento:[341,213,18,84,2,8,293,16,46,211],utilizadi:[],"empezar\u00e1n":386,utilizado:[222,138,206,92,207,319,285,375,271,211,167,245,193,247,137,28,139,295,29,362,99,82,32,60,248,236,144,383,146,166,331,84,310,354,364,226,182,72,359,376,260,14,311,234,235,343,293,70,44,158,90,346,186],"deber\u00e1":[176,266,338,331,115,166,343,121,204,241,158,297,107],identif:376,haslifecyclecallback:[297,166],usernametoken:62,versa:[],"interact\u00faa":[93,84],earli:[],file_cache_dir:226,envia:215,read:[306,246,239,273,103,339,233,163,342,270,292,386,181,346,161],lado:[322,109,338,252,331,206,202,11,99,121,204,22,297,244,47,186,49],psr:[350,8],seamo:[277,166],file_system:199,detoem:[],"conten\u00eda":8,transformer_typ:70,procesar:[298,18,19,94,211,319,322,193,341,99,142,176,328,383,222,84,386,260,130,204,346,186,161],verdadero:[272,328,8,166,84],procesan:[331,319],benefit:[],cascad:[202,135],output:[51,239,268,314,375,245,322,56,7,326,358,217,9,61,34,35,364,65,172,70,130,341,270,204,90,161],strcmp:177,"m\u00e1xima":[290,130,331,140,326,387,105,122],"conseguir\u00e1":48,"procesar\u00e1":186,seman:313,timetyp:235,resuelven:[161,319,362],amigablement:[],setrow:34,gettermsaccept:[207,74],"devolvi\u00e9ndola":331,"h\u00e9roe":16,test_str:[303,148],myformtyp:66,testmailissentandcontentisok:43,rewriteengin:205,gettarget:32,debera:[],agregaron:[46,2,344],"c\u00e1lculo":331,imprimiendo:172,alternativament:[218,337,288,273,250,28,363,358,60,166,211],llevada:25,concuerda:[231,0,343,121,210,346,186],sixth:[],equivalent:[240,145,375,166,193,354,138,99,8,277,60,360,175,307,222,331,84,363,226,42,288,368,109,204,161],llevado:241,estructurar:[158,189,356],dibuja:[34,197,109,341,180,77,99,344,172,362,305,167],blacklistedip:392,enable_iddqd_attribut:162,admin_bundle_blog_blog_delet:156,"throw":[268,314,350,102,94,166,247,136,139,81,141,98,358,217,327,219,62,222,221,153,277,228,259,338,234,202,157,49,297,186,161],nosotro:313,multipleactiveresultset:148,src:[93,190,3,95,4,193,362,99,7,194,195,9,305,10,102,311,105,12,200,14,112,15,202,204,16,313,201,222,145,118,318,207,208,376,23,211,25,322,213,324,36,326,8,121,353,32,306,122,327,33,332,35,254,123,38,331,221,124,126,40,226,71,228,43,229,224,338,130,247,234,131,45,343,333,346,341,50,238,241,351,352,242,54,135,244,56,136,248,249,250,251,60,143,61,62,146,128,149,153,257,155,259,263,70,339,157,73,161,266,74,268,373,269,79,80,165,270,166,167,170,98,380,277,175,177,84,179,387,388,182,183,184,185,289,290,291,186,187,391,293,392,297,90],addtagform:202,central:[144,139,92,190,2,204,46,327,211],greatli:347,lugarn:8,indexact:[307,115,93,354,211,222,170,56,134,121,9,218,176,383,204,37,331,150,64,367,78,60,14,341,110,70,16,346,186,347],srv:[259,115,186],productividad:16,intent:[99,344,76,58],backup:[],processor:[176,193,293,319,264],pasarela:[126,331,376],cambiarla:204,cambiarlo:[14,180,90,248,271,211],setextra:218,cssrewrit:[322,213,16],unregist:[],securityfunct:366,your:[213,222,298,375,314,261,273,140,93,242,79,292,326,22,347,386,3,212,245,194,322,169,170,250,58,81,141,99,7,156,358,122,367,327,280,61,226,70,197,178,199,254,126,246,86,217,87,289,339,233,234,202,131,270,109,110,293,249,111,157,313,342],transformar:[137,28,383,166,228],assertregexp:[61,343,7,253,35],prepara:[222,260,84,153,70,166,33,161],sucesivo:226,area:[139,186,256],aren:[],acmecorebundl:339,mime_typ:[],"expl\u00edcita":[91,331,388,115,148,60,33,367],start:[0,2,210,170,56,139,30,358,217,327,70,199,39,152,364,226,204,87,231,292,111,386,347,49],lop:[],low:[],mbstring:[370,183,79],checkispublish:308,submiss:327,"expl\u00edcito":[193,288,115,363,42,60,367],handler:[176,382,239,58,125,30,264,226,334,16,293,49],urlvalid:263,pitcher:327,posterior:[328,222,341,331,20,286,343,242,346,211],sirva:[46,2,331],logra:[286,144,145,186,167],autentica:[98,186],class_constraint:32,"registr\u00f3":[],produzca:[46,2],"default":[0,300,3,298,193,5,96,303,97,98,6,99,121,308,197,198,199,310,106,13,108,109,110,204,113,332,205,314,206,115,376,322,323,213,28,29,30,326,216,122,329,222,123,331,39,354,226,127,231,338,44,341,234,111,131,344,236,355,346,347,239,348,349,352,242,135,244,245,246,56,136,137,58,141,250,373,60,255,148,150,154,65,287,66,367,359,67,156,70,339,235,161,162,342,273,77,78,79,375,167,170,81,82,277,383,283,178,84,85,86,387,388,285,87,183,185,290,291,292,391,294,295,181,186],bucket:177,securitybundl:[62,103,247,338,341,58,98,86,16,293,186,25],"suplantaci\u00f3n":186,getrelativepathnam:177,definist:[231,115,351,32,341],postremov:[297,166],ifstr:193,"vendr\u00e1":[110,367],onerror:[331,318],fromdomainobject:136,encadenar:342,"organizaci\u00f3n":[341,331,204,60,48,161],directoryindex:[341,6],intenta:[145,193,5,201,163,67,99,98,383,121,293,182,60,186,210,367],tengo:[26,304],appendclienttransform:228,hazlo:[62,33],formattedlin:172,mover:[245,306,329,294,56,178,341,67,270,85,93,154,204,16,181,77,297,305],tenga:[0,145,77,93,300,2,383,351,271,193,341,136,248,166,99,98,380,277,33,219,62,331,84,152,153,367,231,260,14,202,338,293,204,392,346],intento:314,object_ident:58,accessdecisionmanag:[286,219],subtext:218,empezamo:84,monologbundl:[176,341,125,103,16],prepend:[175,319,347],valid:[266,50,387,314,373,75,269,74,93,207,301,79,80,352,190,285,54,208,3,254,95,291,193,310,187,324,137,28,123,58,263,99,82,195,32,391,122,60,327,33,295,206,142,36,84,38,349,126,333,226,257,250,105,155,185,66,127,107,128,183,359,12,376,290,112,234,45,182,109,343,293,39,70,16,157,297,235],you:[298,190,97,7,194,306,273,199,310,13,108,202,110,111,311,313,113,314,67,206,22,25,322,213,28,29,326,8,216,217,327,329,35,123,39,226,335,127,43,339,233,234,131,270,344,355,347,239,249,245,246,137,58,141,373,358,359,61,144,254,152,154,185,367,261,156,70,44,235,342,163,375,271,169,170,187,81,82,212,282,178,85,86,182,285,87,287,291,292,294,295,181,297],soapbundl:9,enfatiza:14,db_usernam:[349,70],registro:[266,74,51,268,189,267,207,2,54,166,243,247,281,99,8,135,142,176,382,221,125,349,258,12,201,341,264,293,133,16,46,186,49],registri:70,perfiladora:152,acme_main:[140,77],pear:[61,0,138,248,201,179,46],registra:[268,93,2,23,211,341,326,98,215,382,147,37,124,221,149,125,286,153,386,228,66,184,338,14,201,293,16,46,157,49],cuerpo:[278,111,57,84,134,350,343,383,204,218],pool:148,sensioblogbundl:[37,42,210,354],reduc:[322,60,343,142],unbind:245,modificado:[146,138,178,19,20,30,251,22,375,331,33],admin_topnav:339,modificada:[99,331,202],onfoomethodisnotfound:94,"oraci\u00f3n":[363,288],constraint_valid:[293,32],wsse:[220,62],base64encod:360,"export":[211,70,6],setexampl:[],"port\u00e1til":[305,204,56],tenido:[234,121],"apl\u00edcalo":376,correr:[196,199,189,343,156,371,229,319],month:[137,28,285,0,231],correo:[51,373,189,93,207,116,238,22,117,271,353,222,227,284,171,248,134,31,215,9,252,33,281,382,383,204,254,166,84,180,310,64,335,43,258,259,12,260,14,247,45,290,343,89,133,16,90,186,48,161],multilangpag:[218,213,347],mp4:289,addxxx:47,resolutor:[383,354],getglob:52,habla:[338,383,20,89],iconv:370,chain:[255,58,141,110,186,367],rebautizado:350,conecta:115,nombrepaquet:[341,362],acumulan:149,articl:[230,178,331,204,22,181,346],solicit:[14,121,234],comerci:[260,17],recolector:[293,284,226,43],icono:[245,166,64],nativememcachesessionhandl:[],estando:8,vers:[98,161],borrando:[363,384],estaba:[22,152,331,238,335],habilit:[153,18],establ:[26,316,199,124,11,8,21,107,89],discount_coupon:327,sensiogeneratorbundl:[321,26,341,114,16],decida:342,mechan:[110,199,108,347,87],verd:[11,61,7],findonebynam:[338,166],stty:314,mensual:337,dm1_document_manag:388,"resultar\u00eda":[],respectivament:[40,254,56,84,342,64,226,390,388,71,23,49],deficient:161,baseblockservic:[140,197,77],content_repository_service_id:367,stofdoctrineextensionsbundl:168,checkboxtyp:44,cabecera:[284,138,318,2,62,242,375,211,272,139,249,121,251,9,34,222,331,84,64,43,260,383,343,46,157,237,161],getdat:141,localevalid:36,somenewfilenam:67,corriendo:[179,199,145,151,371],disable_transact:70,"fallar\u00e1":[183,185,123,290,373,291,250,79,387,190,122,54],descodificar:72,linkscrawl:142,tradicional:[121,204],destruyendo:49,menunod:[108,86,96],abundant:158,hasargu:334,symfonycomponenteventdispatchereventsubscriberinterfac:293,ayudar:[184,18,313,1,20,383,99,8,121,89,226,386,60,47,153],replace_symfony_rout:367,ayudan:[228,341,16],destinada:[386,186,204],destinado:[144,222,14,92,93,8,204,158,229],value_non:[61,7,35],reca:186,eventsubscriberinterfac:[46,336,2,146,327],changehistori:343,"generar\u00e1n":204,"podr\u00e1":[388,341,329,349,294,241,52,389,148,247,345,85,98,188,154,204,178,181,158,161],"ver\u00e1":[266,222,145,93,319,241,80,22,23,166,167,341,326,362,99,98,8,144,146,331,84,153,227,299,338,14,202,110,204,186,161],sonatacachebundl:197,enturado:[],reproducido:[322,40,331,134,310,99,226,121,167],identidad:[136,260,286,226,186],ver:[266,222,315,298,268,19,163,328,77,78,319,102,241,21,346,22,117,23,55,135,25,380,322,273,56,136,139,326,362,31,99,98,8,121,211,32,251,172,60,204,33,10,144,62,167,146,197,166,370,199,293,64,152,153,364,383,391,158,331,367,286,259,260,14,361,341,342,202,305,109,343,338,145,70,311,71,72,297,186,161],reproducida:[206,77,322,56,355,97,29,82,216,121,359,329,294,178,85,154,127,287,13,44,67,204,295,181,113],modifi:[138,331,189,99,375,327,280],congelar:[],divisor:206,ahead:273,iso3166:[60,294,36],http_foundat:0,reason:[169,261,170],getquerycount:361,amount:[358,246],uploadformsizeerrormessag:128,eficient:[328,319,18,338,331,286,166],gestiona:[260,14,115,11,70,242,60,166,211],set_include_path:201,"1024k":128,jre:199,haschildren:163,settrustedheadernam:272,db_init:[349,70],username_paramet:58,href:[308,204,56,367,339,341,202,305,343,110,142,322,22,71,244,346,186,161],automatizando:16,solicitud:[313,89,33],interactuando:23,objectmanag:[228,326,23,70],eficaz:[164,153,143],testproductbycategorynam:[],not_exists_act:141,http_method_overrid:[226,298],configcach:[19,319],formbuild:[207,182,380,146,70],taken:[339,74,234,87],"utiliz\u00f3":228,toggl:[],decis:392,descargan:[337,92],vecino:359,twig_funct:130,documentar:[46,2],impulsa:[8,313,84,341],copiarla:[204,311],particularment:[240,314,91,362,313,186],"sustit\u00fayela":33,descargar:[145,337,138,15,92,179,121,204,182,375,186,161],transparentement:144,validan:293,singularidad:[],histori:[343,121,33],getmessagetempl:[],posibilitar:[],validar:[314,75,93,80,208,376,3,191,319,193,247,99,32,252,254,331,256,126,153,105,341,391,157,161],aparezca:[222,204],pointcutinterfac:221,"m\u00faltipl":[175,267,18,388,115,177,77,2,62,210,386,319,193,139,356,99,7,142,251,60,252,204,61,144,102,70,178,331,189,153,40,226,256,41,182,389,14,108,202,377,111,46,181,186],templat:[213,222,335,273,242,301,164,167,245,26,246,197,56,140,99,326,110,121,344,367,143,305,10,383,204,147,37,339,86,65,41,42,107,87,230,300,14,68,156,293,304,70,16,226,297,159,347,161],tarjeta:[126,376,238,335],"almac\u00e9n":[202,256,361],deshac:297,empresari:17,margen:16,magenta:[61,7],uncheck:240,"d\u00e9bil":108,vcl_recv:318,kilobyt:[128,177],setauthor:[22,178],utiliza:[0,91,189,92,93,2,238,94,3,193,5,96,97,98,6,99,7,388,216,9,305,10,102,197,199,349,286,105,299,13,14,201,108,202,109,110,204,16,312,113,18,314,19,206,118,177,318,190,21,22,23,24,211,319,323,213,29,30,31,326,8,121,243,306,122,218,33,219,328,329,222,254,37,331,311,224,225,226,227,41,42,72,230,128,337,129,338,341,342,45,343,344,355,46,345,353,346,49,51,240,335,267,350,351,228,242,362,135,56,57,138,249,142,357,60,143,61,144,62,146,147,231,150,180,153,154,367,359,368,260,289,389,264,70,157,158,73,370,161,266,74,163,76,77,78,164,79,375,166,167,272,210,273,82,277,361,176,382,383,384,284,84,86,256,188,310,183,184,287,288,363,290,390,90,391,293,294,295,181,392,297,186],beforenorm:193,snippet:[],obtienen:99,reject:313,arduo:[145,121],authenticatedvot:219,getarg:[],task_new:99,transportchain:[117,353],headerbag:[375,222,138],persista:297,datafixtur:[326,23,70],unlink:297,serverbag:[375,138],registrado:[2,117,210,4,103,136,139,338,362,326,60,175,382,319,147,148,153,389,14,260,46,73],setdued:99,registrada:[175,328,319,214,268,201,2,211],another_default:350,requestmatch:[219,139,186],containerawar:[158,23,222],llevarla:61,another_filt:[238,335],previo:[273,255,199,349,326,86,24],help:[282,332,239,236,214,338,39,261,322,70,16,181,212,166,167],hasrol:[119,209,225],soon:[292,110],held:[],memcachesessionhandl:49,symfonybundleframeworkbundlecontrollercontrol:[],hierarchi:[156,108,219],mail_manag:[238,335],subrequest:234,extensa:[99,5],"publicar\u00e1n":281,asignar:[218,18,338,346,247,342,166,93,99,80,354,23,24,186],lateral:331,alberga:[260,341],asignan:[99,60,108,346],idealment:[281,18],eventbundl:[95,185,123,290,373,291,387,122],mientra:[18,314,115,93,346,215,319,247,119,166,99,98,8,33,144,222,178,331,84,64,226,367,184,70,338,14,341,110,204,16,72,297,48,49],static_basepath:[326,317],rumano:89,cet:281,rwx:145,"as\u00ed":[175,74,238,0,52,91,248,326,93,164,2,253,228,22,209,386,271,383,222,322,193,213,214,341,331,119,18,139,140,99,7,8,121,32,60,143,204,280,319,61,84,146,197,198,199,221,149,150,125,153,298,86,218,335,106,182,252,367,231,184,200,179,260,14,342,202,110,346,111,16,46,226,72,73,313,186,161],"ocurrir\u00e1":[250,254,105],enumerar:[272,60],copiado:341,decimal:[359,82,206],allvalid:208,recursividad:202,democontrol:[323,81,343,121,16,242,305],gestor_foo:23,pidiendo:[61,314],fulli:[10,86,58,32,273],rastreador:[116,343,215,142,313,159],enumeran:[121,125],tratara:202,"establecer\u00e1":[331,166,29],entendido:[188,345],brevement:[242,313,186,341],"asociar\u00e1":99,allow_if_equal_granted_deni:58,addnamefieldsubscrib:[146,327],tiempo:[238,161,18,314,19,93,2,270,319,375,28,138,98,30,7,121,358,277,361,252,33,61,281,62,222,331,11,153,364,386,155,285,152,200,179,237,186,204,46,73,205,235,48,49],entendida:307,heavi:[],toda:[268,0,1,189,92,93,354,284,193,5,6,99,7,8,305,197,104,11,105,299,14,15,202,109,110,204,16,313,18,19,145,20,116,22,23,211,26,213,214,119,215,121,218,33,329,222,254,37,331,311,226,334,228,230,231,337,129,338,341,342,131,45,343,344,346,49,51,52,349,350,241,242,362,243,246,63,56,57,138,140,142,358,60,360,61,144,62,146,148,153,154,65,367,260,369,304,70,157,158,161,315,162,163,77,78,375,166,167,272,273,277,278,280,176,282,383,384,283,178,84,85,179,286,118,184,363,389,293,89,294,181,186],perezosament:[],construiremo:[],beyond:[],todo:[268,0,91,92,2,193,362,99,7,215,305,10,307,308,102,103,199,11,310,107,200,14,112,108,202,109,111,16,313,347,222,15,18,314,19,145,20,177,207,281,21,164,117,23,211,25,322,323,213,28,326,8,121,243,218,33,219,328,204,331,221,124,125,224,40,226,334,42,127,229,231,337,338,130,341,342,131,282,343,225,319,46,353,346,48,49,284,240,349,350,241,228,242,135,247,136,138,139,134,142,60,143,61,144,62,146,147,255,148,149,180,152,153,66,366,367,259,368,260,289,156,157,72,370,161,266,74,162,77,78,22,375,166,167,210,273,344,277,361,175,176,382,383,384,178,84,85,386,64,388,182,286,184,288,363,389,297,391,293,89,295,181,392,205,186],event:[51,189,2,383,390,94,336,211,244,95,249,99,251,327,280,245,62,146,125,152,363,256,66,288,338,131,293,70,46,157,334],hostnam:[],assertequ:[343,182,253,43],abstractmigr:[241,70],aportacion:33,estatu:[188,345],item:[245,70,246,142,240,140,141,156,204,375,305],"dec\u00eda":8,publish:[8,111],issuetonumbertransform:228,executioncontextinterfac:80,lord:34,definiedo:252,anidamiento:[363,202,288],eliminada:[183,185,313,291,202,79,297,166],setignorenotimportedannot:[],expirar:49,pue:[60,18],despleg:22,pub:177,eliminado:[287,13,136,297,97,202,286,216,355,127,113],asc:[338,181,218,166,30],pasada:[231,177,238,0,197,137,28,84,202,335,271,385,153,2,110,319,305,46,186,167],base:[189,92,93,2,238,191,40,96,6,99,305,102,273,199,349,286,14,108,202,109,110,204,16,312,313,18,315,20,207,319,22,209,23,222,26,213,28,30,326,8,121,32,327,220,221,35,331,39,226,334,71,229,316,337,338,247,342,111,131,343,46,346,347,49,341,51,335,267,241,362,135,245,56,136,137,138,141,60,360,144,62,361,146,115,149,150,367,260,68,70,157,158,370,161,266,74,78,375,275,167,210,81,166,277,212,280,219,84,182,88,186,377,293,181,297,90],basa:[166,331,107,318,92],ask:[61,314],trusted_proxi:[226,16],asi:[],pasado:[238,206,355,164,2,383,22,209,353,167,246,213,248,97,29,99,82,216,359,143,242,319,382,329,222,178,150,85,310,153,154,181,367,287,13,289,44,108,67,294,295,46,157,186,113],formtyp:[66,127,182,327],bash:313,basi:70,my_bundl:[312,86,150,367],isauthorvalid:80,launch:[],drupal:[383,6],caption:[305,204],funcionalment:43,crell:342,lifetim:[62,58,30,98,226,49],assign:[],"tratar\u00e1":60,timezonetyp:329,getphpfil:[343,142],siga:[37,343,84,45],"a\u00f1adi\u00f3":[138,314,76,2,102,346,375,283,341,62,99,122,327,360,177,34,146,147,123,125,153,364,334,106,127,231,12,290,232,202,344,204,313],file_excerpt:344,propiedad:[91,92,93,190,95,99,195,10,273,105,107,12,14,257,202,109,112,18,207,208,376,23,324,36,32,122,218,222,123,38,126,333,127,128,232,338,234,47,50,350,352,54,135,247,57,138,250,142,60,163,146,269,363,155,66,263,70,159,266,74,268,373,75,76,77,79,165,375,166,254,378,380,278,383,385,84,387,182,183,185,290,291,187,391,181,297,186],obviou:39,promedio:256,placehold:[231,0],getresponseev:[383,249,256,62,251,211],trozo:[204,247],miss:[339,313,254,327],content_datettim:141,getabsolutepath:297,"esfu\u00e9rz":33,js_async:197,gestionar:[322,238,337,319,18,14,1,341,189,6,377,386,204,248,22,92,331,25],reproducen:[329,222,178,85,99,154,294,181,167],gestionan:110,empty_data:[22,178,170],addconfigur:62,authornam:204,scheme:[231,0,376,90,360,5],image_upload_thumbnail:70,schema:[298,115,78,300,241,141,166,211,212,200,323,5,341,303,249,81,6,8,32,134,277,9,60,176,382,62,319,147,37,148,199,64,153,227,388,106,213,93,259,12,283,202,131,90,68,338,264,70,346,186,48],authord:331,xmln:[298,115,78,300,241,134,166,211,212,200,323,5,341,303,249,81,6,8,32,9,60,176,382,62,319,147,37,148,64,153,227,388,106,93,259,12,283,202,131,90,68,338,264,70,346,186,48],norma:[266,193,288,153,260,201,318,350,363,60,47,331],createqueri:[166,161],"pa\u00eds":[224,85],basar:[136,158],primarykei:277,driverclass:148,getter:[93,187,163,292,54],"violaci\u00f3n":[93,32],querybuild:[338,181,388,166,247],basad:166,sign:212,failure_path_paramet:58,"crear\u00e1n":336,grep:145,cookie_secur:226,situado:23,situada:331,ampliada:[363,384],posibl:[175,284,18,91,1,20,349,92,2,383,351,80,326,22,346,210,138,271,135,167,344,193,214,248,52,98,362,31,99,7,8,121,142,313,60,33,319,61,281,329,360,222,166,148,331,357,104,256,11,153,364,386,65,388,228,367,278,337,215,266,260,130,369,375,338,109,110,293,89,236,46,158,47,186,49],jqueri:[245,322,213,240,202,343,142,22,244],centrada:161,bridg:[181,74,247,45],"ahorrar\u00e1":209,externa:[144,14,145,179,211,22,9,23,166,135,167],toward:[],sabemo:84,randomli:[],cooperant:224,autorizado:[119,219,204,49],"sub\u00f3ptimo":331,nula:314,nulo:[50,288,38,363,376,166],"null":[61,50,284,268,0,375,138,314,342,75,115,326,78,2,383,80,352,22,228,23,166,135,146,344,193,170,247,231,205,163,58,81,30,99,7,194,32,178,277,269,218,327,10,176,62,35,273,128,148,221,38,266,363,226,299,105,42,182,127,350,367,93,288,14,257,234,202,109,343,110,39,339,46,297,347],intercala:163,option:[0,93,190,3,298,97,362,99,7,306,103,310,105,12,13,108,202,110,111,113,205,206,207,208,22,376,210,28,29,30,216,122,327,329,35,123,39,126,226,228,127,231,338,44,234,45,344,355,347,49,350,352,54,137,58,141,250,373,60,61,146,128,148,153,154,185,359,67,70,159,266,74,235,342,79,80,375,254,169,170,82,380,280,178,85,387,388,182,285,183,287,289,290,291,187,391,294,295,181,297],autorizar:69,configurabilidad:211,incluiyen:[],outbound:70,lib:[289,148,201,349,326,8,388],x_forwarded_proto:[],"a\u00f1adir":[0,91,92,193,97,6,99,7,71,10,11,13,108,202,204,113,18,314,20,207,22,117,23,330,322,213,326,215,216,135,218,327,33,319,332,124,224,40,226,335,228,127,231,337,338,342,343,225,346,238,353,341,355,139,142,61,62,146,115,149,64,153,366,367,67,68,70,157,266,80,165,166,210,98,277,175,282,383,283,180,388,182,287,288,363,389,47,293,392,186],getsubscribedev:[146,131,2,46,336,327],routing_basepath:156,first_opt:310,enrutador:[315,222,96,205,255,342,1,84,189,110,226,204,311,312,346,275,383,367],comment:[61,136,119,331,261,7,156,148,364,210],desanim:331,proyecto_de_prueba:[277,166],apoyar:[308,18,331,242,60,33],access_control:[369,209,247,58,186],advertencia:[326,386,341],personalizamo:167,"conversaci\u00f3n":84,diferent:[0,91,189,93,2,190,191,166,193,96,99,7,215,305,306,102,273,104,286,200,14,112,108,109,204,311,201,369,18,145,115,282,319,117,23,211,25,322,213,28,8,121,218,220,222,331,39,125,224,226,41,228,72,231,338,56,342,270,343,344,133,248,46,328,346,341,238,239,251,240,335,349,351,242,135,247,136,137,138,142,358,60,252,61,144,253,254,255,148,150,180,152,153,364,65,66,367,359,368,260,289,68,69,70,158,370,235,161,268,163,62,375,275,167,272,271,380,277,361,280,176,177,383,384,84,386,256,182,363,186,293,295,297,90],apoyan:[84,204,18],alpha:60,segun:[],localment:[241,16],transfieren:99,recogido:[10,342,55,211],httpport:[231,0],recogida:211,"compilar\u00e1":[231,0],clear:[341,297,368,20,81,293,204,386,60,47,371],languagetyp:[154,294],componen:197,prettier:239,clean:[],lanzada:[51,14,182,193,286],x_forwarded_host:[],usual:[217,233,327,322,87],groupadmin:23,friend_messag:327,suficient:[224,383,213,247,331,281,202,11,99,2,338,386,326,218,186,211,319],personalizado:[266,222,1,189,220,92,78,300,2,102,80,166,211,167,213,247,192,250,267,362,99,32,251,83,280,10,176,177,62,63,198,148,221,349,41,228,367,184,338,342,110,293,319,312,392,186,49],treeinterfac:245,tener:[0,91,92,2,193,6,99,7,9,273,199,11,14,108,202,109,110,204,18,145,20,209,23,211,319,322,213,29,30,326,8,121,32,122,218,327,33,222,123,331,221,335,231,337,338,130,247,342,111,45,343,344,236,46,345,346,238,388,349,241,353,341,136,248,205,139,357,60,252,61,62,146,118,64,153,367,368,260,389,70,157,370,79,80,375,271,254,210,166,98,380,219,383,386,387,188,182,286,183,290,390,186,391,293,181,392,297,90],personalizada:[267,284,0,1,189,92,93,62,80,117,166,211,167,4,193,247,303,366,99,102,353,32,251,60,374,204,280,34,63,178,331,149,226,41,182,127,367,231,218,337,338,390,270,385,344,293,70,181,157,186],devolv:[52,93,94,190,210,166,211,193,247,138,99,121,142,277,9,60,242,10,383,222,331,84,256,153,42,392,299,260,341,375,338,293,204,16,181,158,73,161],debido:[240,91,177,318,92,299,300,383,346,242,117,210,209,211,167,272,322,331,268,362,99,142,277,9,60,297,384,219,144,62,361,146,273,370,199,149,256,349,286,363,259,226,228,218,337,14,234,202,90,109,343,293,89,204,71,49,47,186,161],field_label:[],comenzar:[380,145,337,283,341,166,84,118,92,238,89,335,277,158,313,186,33],bindrequest:[99,207],entry_point:58,agregando:[206,22,166,137,28,82,277,359,176,62,133,84,310,336,285,338,202,186,204,295,16,346,235,161],referencia:[145,284,384,18,1,75,349,77,93,164,2,351,344,22,304,209,23,24,166,353,25,26,213,295,136,137,28,311,58,99,82,264,121,32,178,277,167,143,305,33,319,176,220,62,111,103,148,331,84,149,293,125,286,363,359,222,65,285,310,184,88,338,14,108,342,235,68,109,110,206,101,70,16,226,72,297,186,346],qued:102,copyright:[350,129],sendemail:234,isauthor:163,setnam:[61,246,35,338,178,357,202,77,7,110,386,326,22,277,72,166,367],emitan:382,desplegar:[306,20,331,145,104,189,121,204,241],form_ag:167,cuent:[],usercontrol:[78,115],yml:[0,92,93,354,284,190,3,95,193,303,6,99,195,9,100,101,71,306,308,102,197,199,105,106,299,12,14,112,202,110,204,16,312,257,205,19,20,317,200,208,376,24,25,26,322,54,213,118,324,36,30,326,8,121,243,32,122,218,327,220,332,222,123,331,221,38,126,40,226,227,41,72,230,128,337,338,130,247,234,45,343,225,249,319,248,346,48,341,50,238,52,348,349,140,241,351,352,242,217,362,135,245,56,136,57,58,134,250,333,251,60,143,144,62,254,147,231,255,148,64,363,155,367,259,263,156,304,70,339,157,158,161,353,162,373,269,77,78,79,80,270,271,167,273,292,81,166,98,277,212,175,176,382,384,283,84,86,387,388,87,183,184,185,153,290,291,186,187,391,347,392,297,90],contactact:[99,84],testsessionlisten:293,"__file__":144,aislando:161,nativ:[277,226,49],"partici\u00f3n":145,sugerencia:[158,214],recargar:383,"mostrar\u00eda":77,setdata:[228,375,146,170],inputinterfac:[61,35,268,7,236,90],emplear:[],acme_extens:270,supongamo:[298,235,93,164,2,241,208,22,54,3,167,95,250,28,166,99,277,60,143,327,61,144,146,331,84,149,150,64,153,226,125,105,128,259,200,338,14,202,45,187,343,293,204,46,72,346,186],recoleccion:[],migrada:241,"reflej\u00e1ndos":77,redefina:[351,32],examinar:[343,145,121],contentbundl:[245,273,255,1,315,317,77,326,110,86,111,347,367],treebundl:[301,244],methodnam:[336,344],myblock:[326,77],convierta:[331,211],urltyp:13,"disociaci\u00f3n":286,juega:[93,115],declarast:110,"atracci\u00f3n":[313,89,33,279],factory_class:[164,143],addallowedvalu:39,particip:[185,123,290,373,291,387,122],won:[313,226],marcando:[385,73],"gen\u00e9rico":[245,337,247,260,14,331,234,326,120,334,159,367],comment_slug:210,"gen\u00e9rica":[266,330,99,204,94,117],unconfigur:141,marcadora:222,catalogu:[344,293],setautoexit:268,magallan:20,numer:[303,148,141,352],parecen:[],gethead:[251,383],felicitart:[145,121],setclass:[282,238,351,335],phpfileload:[231,0,271],collectiontyp:22,secure_servic:[225,259],catalogo:18,"mantendr\u00e1":[11,207,74,204],"depreciaci\u00f3n":[11,47],statistics_norecomput:30,experimentar:58,both:[339,347,80,70,141],secure_random:[186,360,162],invalidate_sess:58,acept:[61,7,91,202,2,46],pathactioninterfac:141,nativesqlitesessionhandl:[],maxitem:[246,140],setcallback:[375,138],secreto:[62,6],undetermin:[],configurationinterfac:[153,193,210],secreta:[99,98],un_escucha_del_cortafuego:58,galeta:49,mantienen:[23,241,204],createquerybuild:[338,181,166,247],header:[62,222,138,331,84,343,121,251,157,9,375,211,161],cotidiano:319,cotidiana:161,"invalidar\u00e1":319,"te\u00f3ricament":286,my_formatt:176,adminpass:242,"bifurcaci\u00f3n":[313,33],addlistenerservic:336,newinst:[9,43,64,134],default_layout:156,existencia:[148,117,158,353,388],box:[137,1,28,22,285,113],normalizada:[228,84],imag:[75,93,301,242,244,322,169,213,56,8,121,142,305,101,10,204,226,105,128,289,130,343,344,70,297],normalizado:[47,222],abajo:[0,145,349,383,241,22,213,58,30,99,326,215,9,60,33,175,62,273,331,295,256,367,231,359,201,342,344,70,16,158,73,186],asegurars:[219,337,254,389,119,20,92],deten:[46,152,2,226,70],asegurart:[273,314,14,199,38,202,166,93,8,241,22,257],staticphp:[148,388],ajustando:[242,153,331,206],getbiofil:128,look:[245,273,270,339,163,261,202,58,326,8,70,344,217,141,327],descubierta:60,reorganizan:89,"while":[51,268,199,289,58,194,70,358,364,331,161],getrequesttyp:[251,383,211],reorganizar:[245,222],"emisi\u00f3n":[228,215],"seguir\u00e1n":64,loop:[292,339,313,58,202],pack:[],reutiliza:[],conten:[0,342,145,166,193,99,8,373,60,33,102,286,153,323,310,231,215,290,14,67,202,110,293,204,158,186,161],readi:[245,202,22,313,327,347,244],"provocar\u00eda":204,readm:[217,145],jpg:[130,343,121,142,289],setborderformat:34,liipsearchbundl:348,conectan:[266,158],select_nod:[245,244],use_coffe:[],grant:326,belong:[],getrealpath:177,"dise\u00f1ador":[305,204],hello_:388,"id\u00f3neo":99,"din\u00e1mico":[231,322,0,96,255,1,315,342,338,331,187,110,204,312,166,367],grand:[128,177,40,56,331,234,201,341,104,30,373,70,105,166,49],"din\u00e1mica":[144,146,331,342,322,93,110,204,312,252,327,211],encontrando:[299,365],conectar:[319,2,293,70,46,336],formtypeinterfac:[22,182],"asegurar\u00e1":353,"aseg\u00fares":[],imagin:[39,327,70,141],optim:[68,389,20],usen:[369,346,83,189,5],"reuni\u00f3n":281,noviembr:[11,215],doctrinedb:[326,349,70],porcentual:82,user:[326,74,239,332,19,115,349,78,207,62,241,39,208,242,209,6,3,383,25,245,327,193,247,136,137,28,311,58,30,99,102,156,23,195,344,217,60,305,33,221,204,36,166,148,331,84,256,225,299,277,87,93,338,339,264,202,45,324,110,280,70,16,181,186,347],esilisten:[293,211],strtoupper:[61,7,35,268],form_label:[206,22,167,355,97,29,362,99,82,216,359,329,178,85,154,287,13,44,67,202,109,344,294,295,181,113],myaction:278,sha1:[62,247,207,157,297,186],entitytyp:181,redireccionamiento:198,older:[291,270],swift_messag:[9,43,64,134],doctrinemongodbev:338,doodl:281,ampliarlo:[363,384],conseguirlo:[199,353,361],commonli:110,influy:60,"tipogr\u00e1fico":[313,33],izquierdo:60,abstain:[],list_post:230,preocupamo:18,reconstruist:161,baseexceptionlisten:332,"llegar\u00e1n":284,uploaderrormessag:128,tick:[343,142],presentada:[102,287,222,13,355,97,298,216,127,186,211,113],create_imag:213,presentado:[76,93,346,211,322,247,355,97,99,82,216,142,359,204,222,84,287,127,232,13,14,202,111,297,186,113],shortcut:341,recopila:211,formateado:172,cosistent:[],getexcept:[251,51,383,211],informar:[],error_list:[],busqu:[383,222,247,14,343,16,157],"tendr\u00e1":[61,52,145,20,92,93,22,2,102,165,375,271,319,322,40,341,248,268,166,99,98,32,277,60,242,10,281,62,222,84,153,229,367,337,368,338,346,202,389,204,295,46,157,297,161],ifnotinarrai:193,marco:1,march:261,emparejador:[342,139],max_children:244,transmitido:2,validphpcrodm:[349,70],marca:[62,285,319,331,19,58,235,343,293,155,157,66,167,28,135,49],mobile_homepag:106,nginx:[169,341,289,145,375,275],getlastnam:163,cagar:15,gama:84,characterist:[],descubr:[242,60],"actual\u00edzalo":20,bolsa:[157,383,386],recinto:[273,255,1,315,77,326,204,41,199,367],convertir:[240,206,383,210,211,95,137,28,7,82,135,60,360,61,177,315,384,273,331,310,363,333,226,65,155,228,285,359,389,342,295,72,235],resolv:[266,74,349,2,383,141,166,170,81,362,99,380,327,177,84,39,286,335,228,200,342,202,70,46,159,161],defaultentrypoint:62,limitado:[193,386,129,202],agrupado:[99,88,148],popular:[240,78,177,383,18,84,11,204,217,72],my_namespac:[110,367],invoicesubjectinterfac:200,limitada:211,authenticationmanagerinterfac:[62,256],time_widget:285,mi_app:8,creation:[],some:[162,282,350,182,211,245,170,58,81,326,8,217,60,327,177,70,39,86,172,66,87,339,233,261,292,110,204,313,347],"deducci\u00f3n":293,"ver\u00edan":140,permitir:[369,18,314,189,22,2,94,117,271,211,330,322,193,247,248,166,99,98,9,83,328,254,178,385,332,256,363,323,334,367,129,153,14,341,342,202,390,391,293,204,46,392,186,49],phpcr_midgard_mysql:199,gracia:[341,268,1,22,242,375,138,211,247,136,18,135,277,60,305,331,42,43,56,71,186,161],inferencia:[293,213],estudiar:383,suministrando:[190,358,343,305,270],memorizarla:300,gratuita:129,slash:[],gratuito:[337,92],estructurando:14,run:[61,51,236,214,268,199,273,7,169,121,70,358,87],"permiti\u00e9ndot":[338,251,23,218,166],reach:358,redefin:[263,332,167],"permiti\u00e9ndol":343,step:[245,273,339,199,342,217,313],transmitir:[46,2,375,383,138],activada:[259,383],staticcont:[326,110,347,111,367],tocar:331,neutro:219,http_digest:58,mssql:[193,30],"marc\u00f3":157,prevenir:[99,166,45],acmerequestlisten:251,toquen:331,ido:8,trato:142,contentawarefactori:108,postupd:[277,297,166,131],trata:[0,20,92,93,319,242,166,211,35,322,247,99,215,33,382,146,231,64,153,256,388,350,128,337,338,234,202,343,89,295,157,186,161],block:[266,58,167,245,322,169,341,325,140,362,99,326,344,121,358,244,305,10,197,180,246,86,77,218,339,109,156,204,313,161],data_class:[74,170,99,202,207,380,228,327],biourl:263,children_url:245,visit:[339,332,346,240],gastar:[277,161],within:[327,156,254,70,212],forminterfac:[266,99,327,146,170],leyendo:[177,384,363,378,331,163,234,180,99,293,242,277,346,49],ensur:[281,313,166,141],apodando:[385,73],"leg\u00edtimo":[99,204,128],cuarto:[314,18],institut:58,"producir\u00e1":[163,186,214],metadata_cache_driv:[148,70,388],admin_bundle_simplecms_page_cr:86,stylesheet:[322,169,56,341,344,204,71,305,244],direccion:[373,189,220,22,144,272,5,121,382,331,64,388,290,14,112,342,186,110,293,392,346,90,161],actionnam:246,vincula:[136,99,202,222],encargado:204,defaultidmethod:277,doctyp:[142,56,331,341,204,311,305,161],ekofeedbundl:77,fusionando:[153,356],array_key_exist:[266,117],"visit\u00f3":[],tranquilo:7,newer:[],multiplicado:110,getresourc:319,primario:[99,238,180],limpio:[266,253,341,20,193,33],intuitiva:[78,321,177],utf:[298,138,115,93,300,79,375,166,135,212,323,5,56,81,8,32,277,60,283,387,122,106,183,12,290,233,341,186,204,311,346,90],encaminar:161,"prefijar\u00e1":218,allow_if_all_abstain:58,limpia:[62,142,297,331,343,386,236,157,252,161],"ordenaci\u00f3n":177,comporta:[343,346,186],referirt:[266,184,222,6,362,8,204,23,346,48],profilerlisten:[293,211],similar:[266,238,0,18,91,75,20,92,93,2,22,271,167,273,341,345,140,30,8,335,142,277,60,252,327,282,315,70,197,166,84,180,363,188,77,87,231,259,288,338,202,131,90,343,110,111,46,157,47,186,347],necesito:62,sustituido:[363,238,288,335],classmetadatafactori:148,"__tostr":[128,181],favoritecolor:208,implementan:[260,1,256,336,117,367,201,353,49],navegador:[298,240,315,273,242,245,322,213,341,355,97,99,121,142,216,144,222,197,331,84,179,226,287,13,343,295,49,186,113],repres:[140,70],implementar:[175,74,266,302,189,267,77,299,207,102,22,117,23,211,245,168,210,213,247,119,139,140,308,293,10,176,220,62,319,331,256,153,41,341,336,392,367,219,200,338,108,342,110,69,204,16,312,158,186],presentan:167,tablero:[],deliberadament:334,alboroto:161,incluimo:102,comprenda:331,helloservicecontrol:9,titl:[348,77,346,22,135,167,246,213,56,57,140,141,121,218,305,308,34,70,178,244,65,204,170,339,341,343,111,311,313,347,161],"ven\u00eda":383,analizado:[14,375],setenv:6,recordar:[61,288,363,7,241,228,9,166],secureparam:119,erasecredenti:[102,247],"traducir\u00e1n":60,getspool:90,draw:[],pretenden:142,gigabyt:[177,18],mongodb:[197,18,136,338,349,207,70,388,66,23,166],formdata:182,"identificaci\u00f3n":[376,186],funcionando:[144,383,222,205,145,342,173,186],tupaquet:153,distributionbundl:[341,16],ocurrido:[46,2,186],visita:[98,60,145,84],drak:386,accesorio2:23,getformatt:[61,7],accesorio1:23,preferido:[14,84,92],mimetyp:[128,105],database_connect:[78,148],preferida:[329,178,85,11,154,294,181],ispasswordleg:93,visual:[329,178,145,85,154,294,181,121,186,347,161],"env\u00eden":2,reconstruy:[61,7,60,297,161],awesom:[],privatefoobar:73,pad_index:30,mi_controlador_personalizado:264,adhier:93,awesomebundl:[],nombredeusuario:[],directory_inherit:145,editact:[98,202,354],apoyada:[11,153,216],"redirigi\u00e9ndolo":383,conectars:[392,284,388],slot:[341,161,65,204,56],theninvalid:193,similitud:222,aris:[],"74913f5cd5f61ec0bcfdb775414c2fb3d161b620":186,rollback:221,templatenameparserinterfac:65,getrootdir:233,nomina:89,native_fil:226,facebook:186,aproximadament:[8,135,84],replacedefault:39,especificacion:[363,384],codificador:[330,247,58,256,72,23,186],ocultar:[314,313,186],button:[343,186,142],numbertyp:359,ryan:[222,341,14,331,163,142,60,186],rutinario:161,single_text:[228,99,28,235,137],rutinaria:161,fieldtyp:[],peor:[22,161],pluralic:193,coloreado:214,"agrupaci\u00f3n":166,myspool:284,contenga:[266,238,222,140,202,350,204,335,22,157,376,313,305],passconfig:319,myuser:[161,30],my_custom_warm:293,jump:[],"bot\u00f3n":[29,343,89,142,22,33],"s\u00f3la":330,validando:[26,193,128,314,316,331,189,356,93,153,391,374,99,365,310,167],urlgener:[231,342,0,367],download:[266,199,145,349],"s\u00f3lo":[0,91,1,92,93,300,2,284,190,193,96,98,362,99,7,305,102,311,286,105,310,106,200,14,201,15,202,109,110,204,16,313,112,332,18,314,19,115,282,318,21,117,23,211,319,322,213,214,119,28,30,326,8,121,32,218,33,219,329,222,331,221,124,125,354,330,40,226,335,228,336,72,128,337,338,130,247,234,131,343,225,248,46,345,47,48,49,341,238,240,388,349,241,351,242,56,136,137,139,58,142,251,60,61,361,148,149,64,363,154,367,368,260,289,70,71,158,73,235,161,74,268,342,165,271,167,166,82,172,278,175,176,382,383,384,178,84,85,179,386,256,188,182,285,277,184,288,153,389,346,186,187,391,293,294,181,392,297,90],phpdoc:[350,158,47,33],"dividi\u00e9ndolo":[],suponen:214,incluiremo:[],arreglar:33,experiment:286,valen:305,"recuperar\u00e1":[277,282,342,166],stoppropag:[46,94,2],endcreatephp:[218,213],loadusergroupdata:23,urlmatcherinterfac:342,enfoca:[286,108,247],logginginterceptor:221,logout:[242,58,186],becom:[339,39,141,194,226,313],accessor:[266,163,212],especificarlo:[322,341],some_firewall_listen:[],pretti:[327,111,87],producto:[146,18,338,14,341,131,327,99,22,277,166,167],gent:[277,281],nombreclas:225,china_unionpai:376,your_validator_nam:32,chang:[234,206,355,81,326,261,375,135,212,322,246,137,28,97,58,29,141,82,216,359,327,33,306,282,329,222,178,199,339,85,154,294,127,285,87,287,13,44,233,67,156,70,295,181,313,235,347,113],namespacedattributebag:386,chanc:[],claro:[91,109,8,345,188,346,161],clara:[193,204],"boolean":[74,284,268,206,355,190,22,166,135,193,247,137,28,97,58,29,250,82,216,359,329,226,254,178,85,310,154,287,127,285,12,13,207,338,44,289,67,391,294,295,181,235,113],jugar:222,wip:[313,33],form_admin_field:301,detercta:346,subyacent:[266,373,208,282,93,190,79,352,22,228,54,3,211,254,95,232,187,137,28,97,287,99,326,380,216,122,327,144,146,123,178,331,310,333,387,155,185,127,285,128,183,12,13,290,291,342,109,110,70,355,235,113],jmsserializationbundl:[],cantidad:[266,284,18,314,373,92,2,166,211,361,322,56,355,97,140,326,216,33,319,103,331,286,364,337,287,13,290,202,338,204,311,46,113,161],onkernelrequest:[251,66,383,139,249],pudiera:14,registerload:[338,326],exhaustivo:136,alrededor:[350,359,58,167],despacha:[51,213,2,383,46,336],siguiendo:[10,168,383,337,166,331,84,338,92,31,314,215,121,22,277,313,186],ownerdocu:142,is_iddqd:162,benchmark:144,"a\u00f1adir\u00e1":[329,178,202,64,85,383,154,294,165,181],invoicebundl:200,setfactorymethod:[164,143],someauthenticationlisten:256,vuelta:[84,375,222,70,138],lapso:152,nativefilesessionhandl:49,"pagar\u00e1":161,ignore_cas:[],gancho:[251,157,293,277],adddefaultsifnotset:193,supon:[231,40,315,0,56,136,148,108,202,388,341,198,297,166,135,367],codificada:[102,247,138,375,256,72,23,186],enruta:367,inesperado:[306,332],rellenar:[10,383,241,204,228,60],importada:[106,346,160],meet:[281,347],tampoco:[70,367],codificado:256,alcanzado:313,control:[0,91,189,92,354,298,193,99,194,9,305,101,307,103,198,286,14,202,110,204,311,18,145,20,318,207,209,211,322,213,121,218,327,220,222,37,331,16,225,43,230,231,337,338,339,56,234,111,343,344,346,347,49,350,242,245,246,341,136,141,60,254,115,149,150,180,66,367,369,68,156,70,157,158,161,74,162,78,165,275,169,273,81,166,379,98,277,278,173,383,84,86,87,310,389,293,186],"_remember_m":[98,58],sudo:[199,145,273],getphpvalu:[343,142],floatnod:193,getresponseforexceptionev:[251,383,211],vcl_miss:318,"despach\u00f3":[46,2],nvarchar:30,escribiendo:[176,330,199,363,65,133,277,23,33,384],cual:[0,91,92,93,300,2,191,193,6,99,7,216,9,305,306,308,102,273,198,199,311,286,299,200,14,108,109,110,204,16,222,15,18,314,206,115,282,207,281,21,164,209,23,211,25,213,326,8,121,32,218,33,219,328,111,254,331,221,293,354,40,226,334,335,228,336,43,229,230,128,337,129,338,341,234,131,45,343,319,46,346,48,49,284,52,349,350,351,242,362,353,245,56,136,248,205,139,249,134,250,142,357,60,143,61,62,361,146,147,231,255,148,64,153,364,367,259,368,260,252,157,158,73,161,315,268,342,269,78,22,80,165,375,271,167,166,98,172,278,280,176,177,383,384,283,178,84,386,256,388,182,310,118,184,88,288,363,389,186,145,89,181,392,297,90],acme_demo:[184,319,283,81,362,228],nodeinterfac:[108,347,96],circular:[292,72,319],"a\u00f1ada":[266,319,205,386,21,367,353,89],providerid:62,constant_nam:212,otorgar:286,editar:[245,281,62,213,354,136,199,343,20,202,77,99,98,243,298,218,366,186,135,222],revisa:[328,197,341,14,199,145,342,180,77,31,364,311,218,24,331],otro_em:148,myapplicationbundl:156,"\u00fanicament":[162,93,319,326,94,166,146,272,193,136,119,140,29,30,99,7,142,277,218,252,327,33,383,32,224,330,259,386,367,60,338,14,202,343,364,293,70,312,370,186],allowextrafield:254,tome:[297,20,186],compilador:[4,322,213,341,14,340,189,328,351,117,385,353,319],agenda:281,role_us:[219,247,119,58,98,242,186],include_path:201,inmemoryuserprovid:256,tokeninterfac:[219,62,392,256],frustrant:322,aquel:[331,145,367],entityauthor:190,solucionando:326,predefinida:[284,315,0,375,162,314,163,349,77,383,210,166,272,193,213,96,341,136,326,344,218,33,306,177,145,236,273,331,153,226,41,367,231,338,14,342,109,110,70,86],confirmarlo:[145,313],interceptor:221,consensu:[219,392],setnotmodifi:331,temporal:158,him:[],workaround:[],localecod:224,interesant:[61,383,222,56,136,346,202,338,7,344,204,16,25,252,166,49],setfactoryclass:[164,143],purg:[331,318,70],extendido:266,consenso:219,multilangredirectrout:347,brindan:4,handl:[298,205,383,375,211,322,341,141,9,367,327,144,62,273,331,39,64,256,87,339,108,131,110,70,16,347,161],frontal:[306,144,222,341,260,331,84,104,389,121,16,346,161],camino:[18,84,2,110,16,46],auth:134,addallowedtyp:39,p16:342,front:[322,169,298,189,275,87],getset:77,makedisposit:[375,138],to_email:[382,264],somewher:186,"120cm":123,subrol:219,validez:[331,12,319,247],guard:[23,131,33,49],getqueri:[338,166,247],"b\u00e1sicament":[322,268,136,1,221,139,202,286,8,142,295,186],doctrinemigr:241,"negaci\u00f3n":209,rayo:331,modo:[108,298,205,314,19,118,144,92,165,319,238,241,22,117,166,243,167,321,322,193,213,57,268,139,362,7,300,32,178,218,331,61,368,382,383,222,284,148,199,84,11,363,359,226,335,230,152,278,289,14,15,219,377,343,293,204,295,312,71,72,186,49],globo:177,some_custom_provid:[],elegantement:204,"habr\u00eda":[14,28,18,235,16],notblankvalid:269,"redondear\u00e1":[359,295],oasi:60,setcontrol:[383,211],anidar:[363,288],authenticatedtoken:[62,256],almacenamiento:[0,18,1,273,349,191,319,213,331,30,8,357,60,19,307,328,222,197,199,386,365,367,231,70,14,385,110,293,111,159,49],special:[177,239,213,234,81,141,326,80,22,211],configuradora:252,max_height:105,sient:[322,342,305,350,109,166],store_subscrib:336,"decl\u00e1ralo":140,combinando:[136,322,193,186,365],niega:[392,219,62,186,383],dataarr:70,suitabl:342,causa:[179,18],"__invok":[46,2,293],validatortypeguess:[182,293],achiv:217,constituyent:250,sobrecarga:[389,331,211],tercero:[91,145,92,351,166,322,5,341,356,107,8,9,253,147,84,149,11,179,72,184,337,338,14,201,389,343,293,204,265,158,16,47],alcanc:[220,102,288,314,62,84,342,286,363,110,331],tercera:[346,186],manipul:[282,161],ech:342,mencionamo:32,getpath:[312,184],"_proxi":[],"\u00e1mbito":[14,340,189,270,286,121,234,32,60,49],"contar\u00e1n":161,newcrawl:343,desnuda:[146,327],resumen:[281,27,18,338,331,341,166,211,345,188,60,346,55,33],timer:[],keep:98,counterpart:[],comportamiento:[372,189,2,23,211,25,168,247,379,99,380,121,142,251,277,218,306,220,149,331,332,104,226,289,14,341,342,390,68,343,344,46,49,313,161],convierten:[177,193,222,93,363,211,288],emailtyp:113,"integr\u00e1ndolo":[],"4_public":112,"optimizaci\u00f3n":[322,319,389,130,20,313],qualiti:375,volubl:161,getpattern:312,oci8:148,your_helper_nam:293,jmsdiextrabundleannotationobserv:[],messagedigestpasswordencod:[102,256],"\u00fanico":[61,238,18,312,76,219,77,93,2,62,22,134,166,383,167,200,40,247,136,240,362,99,7,121,148,306,60,10,177,102,222,20,331,84,266,153,210,335,310,42,107,286,175,179,338,346,201,289,202,45,319,46,386,158,73,297,186,363,161],createfromglob:[272,231,144,383,0,138,331,84,104,16,341,375,205,161],quieran:[308,334],data:[373,145,189,140,22,23,211,244,245,375,170,137,28,58,99,344,148,327,280,10,146,197,273,178,199,86,334,182,127,285,232,289,15,202,109,343,110,293,70,72,235,347],perfectli:327,"\u00fanica":[306,74,18,207,383,22,24,211,255,341,99,218,175,176,62,197,37,148,331,286,226,388,182,44,367,278,260,14,342,202,45,338,70,16,46,386,346,186,161],pluralizando:[60,193],wrapper:148,hombro:331,phpcr_node:326,attach:67,attack:327,crearon:102,apasionado:84,inputargu:[61,7,35,268],"final":[341,222,18,1,145,267,77,93,22,2,241,346,94,167,322,193,273,247,205,99,121,358,311,60,204,33,175,281,282,383,146,197,331,84,11,153,225,310,392,350,367,219,152,259,200,288,363,130,289,67,202,390,305,109,111,14,46,158,16,297,186,242,161],prone:81,transcurrido:152,configura:[266,284,0,20,318,78,242,164,210,166,211,213,96,136,137,28,140,362,99,142,60,143,204,33,175,32,273,198,255,151,153,226,227,367,231,278,300,14,108,342,202,235,110,70,16,386,186,347],travi:[],methodolog:322,listo:[205,145,20,349,77,241,166,341,326,121,277,9,305,33,62,331,92,337,338,110,89,16,392],cache_dir:[231,62,0,148,221,68,153,284,226,70,388,66],"transacci\u00f3n":[221,49],rst:[158,124,89],arrayaccess:[39,254,334],exactli:[290,373,387,339,122,327],lista:[284,18,314,294,1,370,20,92,93,190,2,102,307,346,22,117,375,166,135,167,272,322,285,213,247,136,57,28,202,362,31,99,215,142,311,218,279,33,281,220,62,146,388,189,331,84,329,180,11,363,330,154,105,286,228,337,107,235,230,128,367,88,288,338,14,201,108,116,45,109,343,293,89,204,137,46,392,321,313,186,244,161],route_nam:[231,0,96],enviada:[331,84,383],photograph:[],envuelva:[305,49],target_path_paramet:[58,25],enviado:[382,284,249,64,186,99,2,215,343,43,48,161],disecciona:382,objectident:136,repeatedtyp:[310,207],"function":[0,375,91,189,93,354,2,238,94,3,298,95,4,193,302,303,362,99,7,194,195,9,305,101,10,307,102,196,103,199,105,200,299,12,376,14,112,202,327,109,110,111,16,312,313,257,222,332,138,314,115,190,319,208,22,117,23,24,211,212,321,26,54,213,324,119,123,326,8,121,32,306,122,218,204,39,35,36,37,331,221,38,126,330,333,334,335,42,336,43,229,128,338,130,233,247,234,131,45,343,344,236,46,346,347,341,50,51,251,349,249,350,241,351,352,242,217,228,141,353,244,245,56,136,248,140,134,250,142,358,60,143,61,144,62,361,146,231,255,148,149,64,153,155,66,366,259,207,252,67,263,304,70,157,72,161,266,74,268,373,163,269,78,164,79,80,270,271,254,210,170,292,81,166,98,380,277,278,175,176,177,383,84,224,323,86,256,182,183,184,185,291,390,90,187,391,293,181,392,297,186],exhibir:[199,386],choice_list:[178,329,154,294,85],magnolia_integr:41,tabl:[34,200,162,247,58,30,241,204,262,22,277,166,135,244],need:[213,234,1,206,273,355,249,81,326,375,271,212,245,181,170,137,28,97,58,29,141,82,156,216,358,217,359,327,306,329,294,197,178,199,39,85,86,157,127,285,87,287,13,339,44,108,67,202,335,292,110,347,70,295,154,235,342,113],border:244,procesador:[176,293],user_forward:[],presencia:[254,99,14,331,289,153,8,166,367],actualizars:11,prohibiendo:[],in_arrai:[144,184,341,84,187,80,16,190,157,392],"despu\u00e9":[326,74,51,138,206,20,328,77,93,2,331,241,228,242,23,386,166,211,25,322,193,213,341,136,119,28,383,58,82,379,99,7,121,32,277,60,252,305,33,319,61,313,220,62,167,142,222,273,199,221,104,64,349,11,153,226,42,285,350,286,179,389,14,361,289,375,390,68,343,293,346,70,16,46,157,158,297,186,363,49],trabajando:[4,282,349,273,14,19,315,140,305,385,343,215,121,353,328,277,117,159,33,161],peligro:[55,134],doloroso:60,compresor:71,alterna:[99,186,70],"4_no_priv":112,createnam:327,detector:[],instanci:347,singl:[327,322,137,28,108,141,156,142,212,285,87],posibilidad:[62,18,136,91,315,11,99,110,226,80,16,312,241,186,33,49],aceptar:[61,62,18,91,331,318,7,110,9,166,367],ancla:[218,202],divierta:[157,135,362],"trav\u00e9":[0,91,92,93,2,238,190,40,5,97,99,216,9,100,305,102,11,299,13,14,15,202,109,110,204,16,113,18,20,164,376,23,211,25,322,119,28,8,121,218,222,331,226,71,127,231,337,338,341,343,355,46,346,49,51,335,241,351,247,248,138,249,134,250,357,60,252,61,144,62,148,150,64,359,143,369,67,157,72,73,161,268,77,78,80,375,166,167,272,210,98,277,278,281,177,178,84,386,388,286,287,389,186,293,392,297,90],explican:[109,49,25],"a\u00f1adiendo":[266,74,238,384,372,91,145,318,319,346,242,117,336,167,193,27,341,192,99,365,120,142,60,280,10,176,177,102,146,37,385,180,363,226,181,106,182,127,213,338,14,202,335,89,71,47,160,161],explicar:[383,200,18,178,286,110,22,167],"configur\u00f3":131,reescritura:[226,161],barvalu:[153,319],subcomponent:331,attrvalu:109,icudatavers:224,setdefaultopt:[266,74,170,39,202,362,99,380,293,228,327],booleannod:193,autenticando:[220,256,247],url:[213,222,369,315,0,375,138,342,19,75,189,177,77,93,300,383,323,266,242,141,211,25,245,322,40,377,5,96,56,139,58,6,99,326,156,121,344,60,305,219,281,144,62,204,197,273,331,84,298,64,349,244,354,246,226,180,258,87,231,367,218,88,140,13,220,130,341,234,202,90,263,343,110,145,70,339,312,71,346,186,347,161],urn:[9,60],imagetypeextens:266,uri:[222,84,5,332,341,331,108,342,219,343,110,347,142,344,60,346,186,169,161],inde:[],usabilidad:1,phpcrmenuprovid:[108,347],"0x0a":[],sonataadminbundl:[339,301,86,81],juego:[266,375,138,136,84,342,290,387,228,122,23,186],"im\u00e1gen":[266,322,213,56,260,130,331,341,189,377,343,121,204,16,305],tolkien:34,verbos:[7,55,211,214],abstracttoken:[219,62],chain_provid:186,ausent:[22,254],constan:60,anywai:141,vario:[266,222,315,240,145,115,328,2,383,388,362,386,271,211,167,193,56,136,248,140,134,99,8,353,142,251,60,319,175,176,177,253,196,273,166,178,84,189,224,153,40,210,256,41,367,219,286,338,14,247,343,110,293,204,295,46,181,49,313,186,161],gramat:[],expirada:[256,49],"num\u00e9rico":[128,193,186],libra:[],tune:[],libro:[26,74,259,298,341,248,315,316,150,121,204,16,242,271,33],contenedora:[14,158],transmitiendo:[176,375,138],count:[62,373,75,163,93,343,194,344,60,47,361],webserviceuserprovid:102,gettyp:[99,140,77],"c\u00f3modo":[305,337,240,14,145,92,109,16,166],pass1:157,pass2:157,elejido:70,deseleccionar:29,yendo:[313,222],tbd:138,usernamenotfoundexcept:[102,247],pdosessionhandl:[49,189,275,30],enabl:[239,298,162,93,375,193,240,356,326,156,217,367,103,255,148,331,153,169,226,388,87,339,292,110,70,312,347],gust:[136,110,16],modificarla:[14,311],notcontain:177,authenticationproviderinterfac:[62,256],gran:[341,268,145,92,93,190,384,166,211,319,322,56,136,58,134,99,142,60,175,144,361,222,331,84,150,286,363,364,184,337,153,338,14,108,389,110,204,161],contain:[91,93,4,40,303,240,6,99,194,9,100,10,308,102,197,200,14,108,202,110,204,205,115,177,319,164,117,23,211,212,322,30,326,8,32,306,217,362,327,222,37,331,332,330,226,227,71,228,336,72,338,130,247,234,131,270,282,343,346,48,341,238,52,335,249,351,141,353,56,136,58,134,250,251,60,252,360,144,62,147,148,64,153,366,259,143,261,68,264,70,157,158,73,159,266,373,78,271,167,273,81,166,98,25,175,176,382,283,385,388,87,184,290,186,292,293,347,392,90],grab:327,legaci:270,"a\u00f1adi\u00e9ndol":[109,167],solo:[266,222,18,19,308,77,93,190,2,22,166,167,245,322,193,96,29,99,121,142,277,242,319,306,282,383,146,331,84,149,125,40,226,334,350,214,338,14,202,45,377,293,389,204,46,158,346,186,161],olvidara:161,auth_token:157,preventdefault:[202,244],prolija:[375,138],humano:[363,384],strtr:60,"transformar\u00e1":228,latin:166,bloqueado:247,"extracci\u00f3n":[47,213],empaca:[215,213,204],statu:[268,241,33,111,358,211,161],vincularlo:[228,386],correctli:[339,213,141],descomenta:199,engancha:62,createpath:326,formtypevalidatorextens:[182,127],tend:[],llamada:[247,238,138,145,115,282,92,93,2,383,351,388,94,117,375,166,353,222,193,213,56,136,205,139,249,99,7,8,121,32,358,277,9,60,319,61,177,102,361,142,147,341,331,221,104,244,330,335,337,84,219,259,200,338,14,108,234,202,389,343,204,46,297,186,49],written:[],caja:[341,102,268,204,18,331,178,28,205,349,318,99,82,121,334,70,181,389,186],confundir:[104,222,349],"env\u00ed":[382,64,33,202],"cumplea\u00f1o":137,equiv:[341,311,204,56],llamado:[222,238,332,18,91,335,92,164,2,284,80,94,210,211,167,341,139,6,326,8,121,9,60,143,204,242,319,144,84,146,147,148,199,221,150,152,153,225,226,65,157,77,367,184,337,14,15,234,202,383,293,70,46,71,161,346,186,49],solucionan:145,kei:[238,298,332,52,300,254,351,346,164,117,362,271,135,212,323,5,341,248,138,58,81,30,98,8,353,375,277,60,143,177,102,222,197,148,84,153,259,386,335,106,182,43,218,283,14,234,202,205,90,68,344,204,157,158,47,186,347],isol:368,experiencia:[245,18,84,11,121,49],jsroutingbundl:86,otherwis:[178,28,39,347,339],delegatingload:[299,19,81],vagament:202,cierr:[231,177,193,0,222,6,99,2,383,121,80,181,46,157,204,186,49],getdispatch:2,escapando:[177,305],urlredirect:198,admin:[349,242,23,211,25,245,5,96,247,136,326,194,218,219,70,273,256,86,156,87,231,367,60,339,108,110,111,346,186,347],identificador:[367,282,62,338,161,166,331,76,202,362,286,99,215,77,277,336,154,66,60,209,49],sessionbaginterfac:386,definimo:[],admit:[341,219,384,56,331,145,318,134,363,392],limita:[14,226,202,211],loadclasscach:[341,331,205,104,16],uncaught:[239,268],status_text:311,by_refer:[22,178,202],escritura:[231,145,0,273,56,14,18,243,204,33,49],unimpl:87,"dem\u00e1":[144,253,99,91,328,153,383,248,66,271],ajustamo:221,habitual:[168,20],print_r:93,formatblock:172,johann:[136,209,221],"un\u00edvoco":214,"c\u00e1lido":[],pathinfo_extens:299,suponga:367,tiend:18,doctrinemigrationsbundl:[26,23,241,114],desplegado:20,gethelperset:[61,172,314,34,364],ligado:[99,127,232],getsubject:[94,43,334],trasmitir:[188,345],utilizaron:19,setscop:[234,141],"interrogaci\u00f3n":71,a8ew9oaircfmpmalbpbh4fobiifylfuzmtsuwzzg:256,error_bubbl:[206,287,13,295,216,44,97,67,355,29,85,310,82,329,154,294,178,22,181,359,113],proveer:[193,35,319],denegando:[220,247],"solicit\u00e1ndola":331,capacidad:[61,176,17,268,0,283,18,231,221,20,286,341,360],"col\u00f3calo":[],formfactori:[66,182],"_templat":367,symfonycomponentconsoleoutput:7,estricto:210,notablement:[345,322],isknown:39,metadatadriv:[],mail:[382,238,234,134,284,212],twig_extension_debug:204,otr:[],reconocida:47,resaltada:96,"__get":163,getgend:190,multilangstaticcont:[245,339,111,101],text_widget:167,trataremo:66,suscrito:[46,2],contextu:[346,204,197],inspeccion:135,contexto:[238,240,53,209,245,56,186,139,98,32,293,60,219,62,331,84,256,226,335,258,259,108,342,159,69,204,90,49],annot_control:150,setcontain:[326,23,383],moverlo:[],endblock:[10,266,218,109,339,341,362,244,99,156,121,204,167,305,161],fondo:[61,172,7,84,383],demo:[61,184,35,214,205,199,273,343,81,305,7,194,121,323,242,157,186,213],preinsert:277,impidan:18,echarl:146,errorexcept:239,captura:[383,186,268],"est\u00fadiala":99,parti:[217,189,356],header_client_ip:272,setcategori:[99,166,277],"legislaci\u00f3n":[188,345],"permitir\u00e1n":359,matchesclass:221,mostrarlo:82,http:[0,189,92,93,300,2,191,298,40,5,303,6,7,194,9,100,101,307,196,273,198,199,349,106,83,200,13,14,201,202,204,311,313,369,332,138,145,115,177,318,319,211,25,26,322,323,213,326,8,121,32,218,219,220,221,222,37,331,39,124,224,354,226,227,231,316,338,247,131,343,344,46,237,48,341,239,240,53,249,241,242,246,56,248,139,58,134,142,358,60,61,12,144,62,147,148,180,152,363,256,65,259,260,289,261,68,263,156,69,70,72,159,161,163,77,78,375,271,361,272,169,81,166,212,173,176,382,383,384,283,84,179,64,388,87,153,346,264,186,293,89,90],junta:[315,273],fastcgi_script_nam:169,some_filt:[],mostrarla:[266,298],effect:[342,141],isopt:293,tomado:[119,20],vuelva:[331,49],initi:[337,138,339,293,386,375,297,347,87],estado:[240,92,383,241,242,375,138,211,322,247,268,357,251,305,253,222,198,331,84,386,258,337,343,89,311,186],hasflash:[],addcollect:[231,0,341,81,8,106,346,211],"programar\u00e1":11,lineformatt:176,duplicado:380,notfoundhttpexcept:[221,222],especificado:[238,138,388,93,22,375,166,167,29,277,144,222,148,84,125,310,386,64,335,182,367,368,14,45,343,110,186],"f\u00edsico":84,undefin:94,"f\u00edsica":[8,341],especificada:[128,214,289,14,345,64,181,188],getdisplaylocal:224,sibl:[343,142],pdo_mysql:[78,148,326,166,6],explicado:[383,346,202],"a\u00f1adiran":330,explicada:11,registrationcontrol:149,applicationtest:[61,7],sufr:297,desarrollar:[145,337,213,341,1,84,92,121,16,157,161],"quit\u00f3":[],sexto:314,extraer:[343,121,256,6],comentario:[61,281,203,288,363,136,130,389,219,305,153,7,121,135,204,210,313,186,33],"solicit\u00f3":[346,25],nullabl:[99,297,166,135],vida:[267,51,298,91,75,20,93,166,135,341,99,8,277,313,62,222,331,84,152,386,338,14,234,237,49,297,161],followredirect:343,colision:386,getsingleresult:[166,247],logger:[176,268,221,342,125,293],kick:339,definitiva:[],"evitar\u00e1":238,emplazamiento:158,"comportar\u00e1":341,admin_bundle_content_multilangstaticcontent_cr:86,"respondi\u00f3":314,definitivo:321,historia:[46,2,241,353],getvalidtestdata:182,desear:[252,166,77],role_allowed_to_switch:[242,247,58,186],formulaio:266,regresan:[358,172,84,197],gc_divisor:[226,49],pacheco:129,strtolow:334,"espec\u00edficament":[266,367,337,268,14,20,343,92,2,8,204,105,190,167,49],necessari:[199,293,213,347],avanzada:[193,153,14,385,159,99,2,172,73,186],xsd:[298,115,78,300,241,134,166,211,200,323,5,341,303,249,81,6,8,32,9,60,176,382,62,319,283,148,64,153,227,388,106,93,259,12,338,202,68,264,70,346,186,48],lose:339,rota:[322,226],"instalar\u00e1":[338,124,21,273],xsi:[298,115,78,300,241,166,211,212,200,323,5,341,303,249,81,6,8,32,9,60,176,382,62,319,147,148,64,153,388,106,93,259,12,283,202,90,68,338,264,70,346,186],page:[1,273,242,24,245,213,58,141,326,218,308,332,222,197,84,86,65,41,367,339,108,342,110,111,312,226,346,347,161],didn:327,violacion:[93,80,32],twitter:[156,186],registernamespac:[201,221,124],synfoni:33,warmer:293,login_failur:25,home:[169,204,70],motivo:[319,268],cualidad:375,modificarlo:[286,117,297],librari:[124,221,108],producido:[99,65],moneytyp:206,aplic_symfony_2:6,"corresponder\u00e1":346,rebautizando:[],web_profil:[26,144,64,304,121,16,55,211],solicita:[282,102,331,84,234,121,209,186],"manipulaci\u00f3n":[297,84,268,142,161],phpcr_midgard_sqlit:199,encourag:292,usan:[177,288,341,14,108,363,70,388],php_auth_us:[139,343,100],adaptada:[242,26,1],pueda:[341,268,138,314,294,206,355,77,93,190,2,383,22,375,386,222,327,193,96,56,136,137,28,97,98,29,99,82,216,60,305,360,306,295,328,329,146,178,331,84,150,85,11,333,154,155,287,127,285,367,359,200,13,14,15,67,202,235,293,337,204,44,46,181,186,113],familiarizado:[108,349,180,326,121,311,157,182,211,161],usag:[344,293],casilla:[74,329,294,207,44,343,29,85,99,98,110,154,142,178,181,362,367],usar:[0,91,189,92,93,300,284,94,3,298,193,96,302,99,7,146,100,115,273,159,199,104,349,286,200,376,14,15,202,110,204,222,205,19,145,20,282,207,319,22,209,211,25,322,214,28,30,326,121,32,122,218,33,220,35,37,331,126,40,41,228,127,231,232,129,130,341,342,45,343,225,137,46,346,51,240,267,351,242,243,56,136,57,139,356,134,358,60,143,61,144,63,148,150,180,363,65,258,367,368,252,369,67,389,70,158,73,235,161,266,74,268,76,77,164,270,275,167,168,375,166,380,277,278,280,176,177,383,384,283,178,84,386,256,387,285,118,288,290,293,297,186,190],messagecatalogu:293,menunam:96,testsuit:343,freedom:[],vcl_hit:318,esclava:148,argvinput:268,retry_queri:388,rodea:22,appdevurlmatch:144,"eval\u00fa":204,requestlisten:[66,249,211],stanbol:213,navega:84,newsletterfactori:[164,143],empti:[329,170,197,314,178,189,92,109,86,294,181,22,154,85,297,327,280,167],"_ext":180,getmessag:[384,268,43,93,363,98,251,25,186,167],uploadinisizeerrormessag:128,getlastupd:[],binaryfilerespons:[375,222],addnod:142,datevalid:333,aprendido:150,"refiri\u00e9ndot":326,supportsclass:[219,102,392,247],isfieldgr:286,propertyaccess:[266,163,378,159],inner:111,createnotfoundexcept:[222,338,202,277,166,161],"refiri\u00e9ndos":342,"aprender\u00e1":[145,92,241,166,146,247,99,121,167,327,222,84,153,228,337,338,14,341,202,305,343,204,392,346,186,161],"\u00f3ptimo":[],"creai\u00f3n":[],damo:18,securitycontext:[219,62,136,139,256,327,259,209,66,186],multican:[],neutral:[],midgard2:[199,349,70],eas:[],subscriptionbundl:[126,376],some_bundl:141,testindex:[343,361],redirectrespons:[375,222,383,138],displai:[217,246,327,339,141],derequisito:[],asynchron:[358,197],limit:[128,183,185,123,290,137,28,358,373,338,326,79,387,208,190,122,291,48],subplantilla:65,infier:99,sponsor:[],desencadenan:[99,331],addparametersnod:193,cutom:[],evalu:[],decena:[286,16],mejor:[247,18,145,189,345,93,242,319,331,346,22,384,375,271,167,341,322,213,56,136,248,138,356,166,31,99,326,8,121,142,358,60,305,33,281,144,222,283,178,199,84,349,11,363,226,188,228,182,337,288,338,14,108,342,202,270,389,343,110,360,204,16,46,157,158,47,186,161],rnewslettermanag:91,reemplazarla:[],blogbundl:[50,1,269,93,79,80,352,190,54,135,254,263,141,250,211,32,60,204,118,38,333,105,155,128,183,12,260,112,341,187,156,70,158,346,257,161],form_enctyp:[74,109,207,67,202,99,344,22,297],old:[206,355,137,28,97,29,141,82,216,359,329,178,85,154,127,285,287,13,44,67,294,295,181,297,235,113],integrars:96,futur:[],rememb:[327,98,293,170,87],parecida:[338,14,84,259],parecido:[338,145,104,202,204],novalid:99,stat:389,decoderinterfac:293,defaultdata:99,"misi\u00f3n":1,sencillament:[306,382,383,84,126,300,70,22,228,376,218,47,90,367],sofisticada:72,admin_sandbox_main_editablestaticcontent_delet:86,extraerla:[238,335],envuelta:167,asumen:[336,144,121,334],sphinx:[372,180],setcharset:[375,138],magnoliabundl:41,envuelto:[331,383],bcc:[284,64],portion:[],getstoragekei:386,asociar:[383,213,136,84,342,166,78,367,127,186,222],alwa:213,localizaban:239,allowifequalgranteddenieddecis:219,nottingham:331,addtyp:182,targetnamespac:9,encaden:186,superglobal:84,comprobamo:[],whose:[39,141],presenta:[84,58,99,22,297,186],determinando:[186,204],asignarl:[245,73],"regenerar\u00e1":322,service_nam:[346,367],aun:[319,18,119,342,140,363,22,106,384],cuadrado:343,acl_security_ident:[286,58],acme_meetup_registr:327,segmento:[176,146,363,110,226,158,209,384,367],mysql_connect:161,aux:145,codificando:[99,121,186,247],"v\u00e1lida":[314,349,93,190,95,99,98,307,254,147,36,331,256,333,226,105,155,182,229,128,12,112,263,391,186],getrefer:23,mydocu:[312,349],"v\u00e1lido":[284,206,93,242,190,285,166,211,25,95,250,136,137,28,6,99,82,195,32,359,62,123,331,84,126,363,333,105,155,263,107,128,185,288,376,291,324,310,186,187,391,295,158,235],reproduciendo:[383,63,56,99,300,204,22,218,167],forzando:[220,60,186,98],compacto:386,xmlschema:[298,115,78,300,241,106,166,212,323,5,341,303,249,81,8,32,9,60,176,382,62,319,147,148,153,388,200,93,259,12,283,202,186,68,338,264,70,346,90],appar:[],ajust:[175,382,238,328,205,148,331,341,144,64,275,153,8,121,227,70,242,226,158,186,211],setfacl:145,"invocaci\u00f3n":[119,221,49],velar:281,get_post_by_id:161,prohibido:[242,62,186,247],remember_m:[98,62,58],limpiado:242,elegir:[329,294,214,18,338,178,108,118,140,85,242,319,368,154,70,190,181,60,166,243,167],"jam\u00e1":186,filterorderev:[46,2,336],sleep:[284,375,138],modificast:70,concisa:[37,305,204],bean:93,paramater_nam:282,ejemplo:[0,375,92,93,300,2,284,190,191,298,4,193,5,96,97,98,6,99,7,216,9,305,10,102,273,198,310,105,299,200,13,14,201,311,202,109,110,204,16,312,313,113,222,256,18,314,19,206,20,282,207,281,21,22,117,23,24,211,25,26,322,54,213,214,28,29,30,31,326,8,121,353,32,218,327,33,355,219,328,329,35,254,36,37,331,221,124,293,125,157,354,330,225,226,334,41,42,336,127,158,230,128,332,338,44,247,234,131,45,343,337,319,137,46,371,346,49,341,238,52,335,349,249,350,241,351,352,242,228,362,243,244,245,246,209,56,136,57,138,139,58,141,250,142,60,143,248,360,61,144,62,361,146,147,231,166,148,149,150,64,152,153,364,154,287,66,367,259,368,260,252,369,67,68,263,156,304,70,71,72,73,235,161,266,74,315,268,342,163,77,164,253,80,270,275,167,272,210,170,274,359,271,379,82,380,277,278,173,175,176,177,383,283,178,84,85,179,323,386,180,388,240,285,184,88,288,363,389,297,264,390,187,391,145,294,295,181,392,205,186],usercheck:256,rescribir:23,getposit:[62,327],entr:[341,18,294,92,130,2,253,323,329,346,242,384,23,166,135,319,322,193,213,56,136,338,99,98,8,121,373,122,60,305,33,307,328,62,222,197,123,178,331,84,149,180,85,310,363,225,154,387,172,228,367,200,288,290,14,108,342,202,385,187,110,293,204,16,46,181,313,186,48,161],aggreg:[],even:[254,178,163,58,204,339,375,327],"asignar\u00e1":[],tipo:[91,189,93,354,2,190,3,191,95,193,97,82,6,99,380,195,305,159,11,105,107,299,12,13,14,112,108,202,109,110,111,313,257,113,222,18,206,20,208,22,209,23,211,212,321,26,322,54,213,324,28,123,29,326,216,353,32,122,329,204,36,331,38,125,126,333,226,228,127,128,232,129,287,338,44,233,341,131,45,343,132,355,46,346,49,50,284,349,249,351,352,362,135,245,376,246,247,137,58,250,251,359,252,62,254,148,256,153,154,65,155,88,66,367,67,68,263,304,70,158,235,161,266,267,373,76,77,78,253,79,80,375,166,269,167,210,274,389,276,344,277,278,280,177,383,384,178,385,84,85,179,386,387,388,182,285,310,183,185,288,363,290,291,187,391,293,294,295,340,181,392,297,186],neg:[],ficticio:[99,341,202,80,166],"present\u00f3":25,metadato:[200,213,274,119,199,388,202,356,338,99,319,225,293,351,70,148,386,237,166,135,49],"new":[0,91,93,300,2,238,94,3,166,95,4,193,5,97,98,362,99,7,194,195,216,9,305,101,308,102,273,199,104,105,106,299,12,13,14,201,15,202,257,110,204,16,312,313,112,113,222,138,314,19,206,282,190,319,329,21,208,164,117,23,24,211,212,321,322,54,213,214,324,28,123,29,30,326,8,121,353,32,122,218,327,33,355,219,39,35,36,37,331,221,124,126,354,330,225,226,334,335,228,336,127,128,338,44,233,341,234,131,45,343,333,236,248,46,386,346,380,49,50,51,251,349,249,350,241,351,352,217,141,243,376,246,247,136,137,205,139,58,134,250,142,357,358,60,143,61,144,62,146,231,255,298,256,152,153,154,65,155,287,367,259,207,252,289,67,263,70,339,157,72,73,235,161,74,268,373,163,269,77,79,80,270,209,254,375,170,292,359,81,271,82,344,277,280,175,176,177,383,384,283,178,84,85,323,86,182,285,87,183,184,185,363,389,291,390,187,391,293,294,295,181,392,297,186],net:[14,349,49],ever:[],metadata:[50,373,208,269,93,79,80,352,190,376,54,3,135,95,291,250,324,123,263,99,195,32,148,122,60,254,197,36,38,124,126,333,105,155,185,128,183,12,112,388,45,187,391,297,257],elimin:49,abov:[322,169,213,273,339,131,141,2,81,80,271,43,347,87],henrik:342,"env\u00edan":[284,222,2,343,46,90],goalkeep:327,"notaci\u00f3n":[230,193,222,56,274,57,163,150,343,225,243,16,60,305,211],met:[],activo:[306,145,20,77,322,40,247,331,139,7,8,305,33,61,220,319,103,189,199,84,226,71,182,118,260,56,377,344,204,86,186],serializando:72,aislar:[338,253,166,52],"72nd":313,createbundl:[213,339,1,77,218,101],formattedblock:172,activa:[144,213,247,354,118,343,68,99,2,110,121,360,70,46,226,367,186,211,49],establecido:[144,51,319,284,44,331,206,183,29,282,99,238,226,335,386,60,211,49],isaccountnonexpir:247,use_sonata_admin:[96,317,110,218,347,367],fixtur:[337,273,199,92,326,86,70,23,347],ofreciendo:321,domcrawl:[343,240,107,142,159],adecualo:[],credit:126,resto:[341,144,62,222,268,178,331,108,115,202,85,153,329,154,294,345,181,158,30,186,167],deseen:11,terminado:[313,33,341],permit:[92,93,2,94,193,5,303,6,99,7,146,9,305,311,11,299,200,14,108,202,110,204,16,312,138,19,206,207,208,22,209,23,211,319,322,119,28,8,121,328,329,222,37,331,221,40,334,71,336,127,337,129,338,130,56,342,343,47,49,341,51,180,52,243,247,136,248,249,142,357,358,143,61,144,254,256,153,154,367,259,368,260,252,69,157,161,74,162,77,164,165,375,166,167,210,271,98,176,383,84,386,64,182,285,286,289,346,391,293,294,392,186],terminada:[11,364],mime:[128,189,249,276,293,105],resta:[338,124],evitarlo:391,addgetterconstraint:[93,187,54],serializa:[10,383],subsista:119,describen:135,moral:[188,345],"ap\u00e1trida":186,esencia:161,deshacert:322,refleja:[289,166,16],forzoso:286,routestack:141,llenar:[343,305,211],"elegir\u00e1":[165,346,367],call:[238,298,91,335,273,94,2,80,165,375,271,245,213,248,81,141,380,217,9,87,252,327,197,39,152,226,41,170,14,233,234,202,131,292,293,70,339,86],typo:313,recommend:[339,199,234,342],calc:343,type:[298,91,93,354,284,40,97,98,362,99,216,9,305,198,199,310,299,13,14,311,202,110,204,16,113,222,138,206,355,207,164,376,211,25,322,213,28,29,30,326,121,32,327,329,111,39,125,226,334,71,228,127,128,232,338,44,247,234,131,45,343,248,386,346,48,341,238,240,335,349,249,241,351,352,242,134,135,244,245,246,56,137,140,141,301,142,358,359,143,62,146,148,363,154,367,259,252,67,68,264,70,339,157,235,266,74,75,76,77,78,22,375,271,167,170,81,166,82,380,277,212,176,382,383,178,84,85,86,388,182,285,287,288,290,391,293,347,294,295,181,392,297,186],tell:[339,39,327,141],fastcgi:375,recog:[330,211,367],apena:367,processed_video:289,warn:[176,264,386,268],berlin:22,warm:[342,293],granularidad:331,prioridad:[210,337,338,342,92,251,2,110,293,46,60,367],cercana:144,brasil:89,http_x:343,rolehierarchyvot:219,setus:[207,62,23,74],setup:[347,273,199,356,194,8,217,182,327,229],getstaticprefix:347,hizo:[238,222,139,20,99,8,22,166],xhr:332,setcooki:[375,211,138],root:[240,245,193,273,198,148,233,108,78,153,169,86,142,244],give:[110,292,108,339],aparezcan:313,getpathinfo:[84,375,161,138],recorriendo:[343,142],decirlo:167,colocado:[389,153],acmedemobundl:[315,298,205,314,145,189,92,383,356,242,167,323,5,341,81,362,8,121,60,305,62,35,147,273,115,84,388,106,184,337,283,327,204,16,346,186],colocada:[175,326,383,341],get_all_post:161,issue_selector:228,ficha:[176,219,62,139,76,256,379,99,157,346,211],"implementar\u00e1":136,temporizado:186,titular:[188,129,345],quot:[284,202],isredirect:343,getcreat:49,malinterpretar:146,getmethodannot:221,enviarlo:[284,383,48,33],abstracttyp:[266,74,170,207,202,362,99,380,228,66,327,146],answer:314,config:[0,92,93,354,284,190,3,191,95,193,303,6,99,195,9,100,101,71,306,115,102,103,273,199,105,106,299,12,14,112,108,202,110,111,16,312,257,222,205,19,145,20,317,200,208,376,24,211,25,26,322,54,213,324,36,30,326,8,121,353,32,122,218,327,33,328,204,123,37,331,332,38,125,126,40,226,227,41,128,337,338,130,247,234,131,45,343,225,319,386,346,48,341,50,238,52,348,335,349,249,241,351,352,242,217,362,55,135,245,56,136,248,58,356,134,250,333,251,60,143,144,62,254,147,231,255,148,149,64,153,365,155,367,259,252,261,68,263,156,304,70,339,157,158,370,159,161,266,162,373,269,308,77,78,79,80,270,271,167,169,197,292,81,166,98,277,212,175,176,382,283,385,84,179,86,387,388,87,183,184,185,290,291,264,90,187,391,347,392,297,186],enviarla:[346,121,180],updat:[360,298,145,115,349,92,241,21,23,24,166,243,213,141,99,326,217,327,101,197,255,124,179,86,337,338,339,33,386,297],routes_to_expos:[245,156,86],suponiendo:[383,147,91,390,109,326,8,351,204,244,167],mezcl:[],your_collector_nam:10,containerblock:[245,77],lenguaj:[162,209,166,27,341,119,60,384,331,84,180,286,363,154,288,260,14,89,204,158,313,161],cambiado:[61,319,18,14,331,7,8,313],estrategia:[219,177,220,342,331,108,20,58,256,8,69,111,242,392,186,353],adelant:[266,268,162,1,93,165,2,383,241,22,23,166,211,375,341,138,58,99,326,121,277,60,331,33,10,281,62,199,311,180,153,259,386,278,350,218,14,234,202,343,110,111,16,46,392,186],acmeextens:270,attempt:314,third:[234,86,33],igualar:222,"sesi\u00f3n":[222,138,189,349,281,102,326,242,375,383,25,213,247,136,139,58,30,98,357,60,100,176,220,62,70,148,104,256,226,259,14,159,344,69,346,204,386,237,186,49],semilla:[186,360,162],maintain:322,your_engine_nam:[],removeforma:202,"enf\u00e1ticament":[],applog:176,sluggabl:[338,168,189,267,166],"atenci\u00f3n":[188,146,345],especificast:102,access_deni:[219,392],"_route_nam":342,privileg:[],smallint:166,cerrar:[344,51,186,49],parameterbag:[84,375,138],better:[326,327,81],barato:[277,166],primary_domain:180,comenta:184,"requeri\u00e1":[],persist:[74,77,207,23,166,246,136,58,99,326,277,218,197,148,388,228,338,14,202,131,156,70,297,347],crea:[61,74,360,332,138,91,253,345,92,93,94,2,102,241,326,22,346,23,166,383,222,249,375,213,56,331,268,311,140,29,362,99,7,121,32,172,9,60,305,33,10,313,177,62,35,289,312,199,84,104,286,153,391,188,310,228,337,127,367,230,277,259,232,341,207,338,14,15,234,202,247,343,293,89,204,44,46,157,161,297,186,49],todel:202,miproyecto:[118,92],"basar\u00e1":219,passwordtyp:355,date_widget:285,promin:[],"redirigir\u00e1":[242,62,186,25],difier:[144,8,189,49],octal:[363,288,384],"prop\u00f3sito":[266,51,76,77,93,300,2,80,211,322,362,99,305,281,383,146,221,104,125,386,334,127,232,129,338,14,109,293,204,46],isen:247,request_uri:[231,84,205,0,161],"instanceof":[102,268,221,131,62,334,251,157,367],ipsum:[277,177,166],grammar:313,hubieran:293,always_use_default_target_path:[58,25],bonu:[],setdescript:[61,35,202,7,277,166],getvalu:[266,343,163,142],"rendrizar\u00e1":[],bono:[147,14,84,85,154,294],luca:[242,343,142],config_test:[144,64,343,226,100,90],sido:[93,139,186,166],went:[172,222],side:[242,331,327,147],mean:[39,213,163,234,202,141,292,226,347],cmd:[213,101],contrapart:[],maincontrol:[84,346],escapar:[283,14,305,226,65,204,60,166,212],esqueleto:[10,321,341,84,204,305],inserta:[93,277,166,56],"enviar\u00e1n":[343,64,48],role_previous_admin:186,showpostact:230,proteg:[247,144,62,5,162,331,84,189,220,318,98,259,121,186,49],extract:[343,335,142,161],securerandom:186,personalizan:310,requerir:[240,91,19,342,45,224,8,186],"o\u00eddo":221,getclientoriginalnam:[297,67],foo_bar:147,"cre\u00f3":[383,166],content:[341,222,138,348,1,317,242,375,211,167,245,322,56,249,141,99,326,156,121,135,9,218,204,177,383,70,273,84,244,86,367,339,108,305,343,110,293,111,311,157,346,347,161],"metainformaci\u00f3n":[130,349],header_client_host:272,"ayudar\u00e1":[326,315,328,273],reader:[221,140],personalizar:[266,222,294,206,20,62,329,211,167,341,58,362,379,99,344,178,25,280,220,34,196,273,189,311,223,85,310,153,364,154,367,14,108,390,68,343,110,204,16,312,181,371,346,186,49],foto:[22,343,18],entran:[228,60,266],preupload:297,situat:327,infin:141,restringida:157,entrar:[136,148,368,388,123],agregalo:101,restringido:186,adaptando:[188,345],controllers_by_alia:[],ckeditor:213,sigan:367,blockservic:140,type_guess:293,swift_events_eventlisten:293,teardown:229,iso:[375,288,138,233,206,363,9,60],isn:[233,58,81,141,217,375],setfactoryservic:[164,143],iphon:84,rapidez:[363,384,161],loud:[61,7],kriswallsmith:[],"funcionar\u00e1n":346,sonata_admin:[339,156,86,218],symfonycmftreebundl:[],default_databas:[338,388],"expiraci\u00f3n":[331,49],hook:[277,293,87],unlik:[],aplicacion:[1,145,93,2,8,26,56,136,215,121,305,360,175,62,331,84,256,386,334,200,389,341,343,16,157,186,49],anotarlo:165,providerbasedgener:342,decorado:56,posfijo:158,bonita:[266,145,121,346],strip_al:130,bonito:2,sometim:[39,327],loaduserbyusernam:[102,62,247],verbosity_verbos:7,autocarga:16,recomendacion:[158,145,121],segundo:[341,284,0,18,314,19,98,93,207,319,383,79,351,384,375,211,25,193,56,138,58,99,7,380,60,61,177,62,167,222,331,310,153,226,299,336,285,231,183,218,363,338,14,289,234,202,235,109,343,204,72,186,48,49],abril:215,segunda:[238,247,331,221,335,166,153,8,305,157,60,346,186,33,161],lighttpd:84,propon:[281,47,33],direct:108,requisito:[0,18,91,145,20,349,319,383,242,24,166,298,26,213,96,354,304,326,218,33,219,144,102,222,273,255,199,86,106,5,231,367,283,370,338,110,70,226,346,186,160],invalida:318,estilizada:222,always_empti:[310,355],somewhat:[],clasificada:331,abrir:[64,161],primarystr:277,mongodbodmproxi:388,silli:[],moviendo:16,xxxxnode:193,cachemanag:197,countvalid:373,vuelcan:328,inhabilitar:64,assets_base_url:226,"rec\u00edproca":17,modern:[],mind:[],lanza:[231,382,51,0,247,289,139,383,131,166,310,363,2,62,311,46,182,186,211,384],seed:[360,162],"liberaci\u00f3n":[11,313],seen:[322,110,347,367],incrementando:[],minu:[],autoexpireflashbag:386,escrib:[51,314,76,166,361,322,214,30,99,215,33,176,319,84,127,232,338,14,15,343,16,161],en_u:60,izquierda:172,getlifetim:49,getmockbuild:182,divulgu:215,blue:[61,314,7],"inyect\u00e1ndol":259,"determinaci\u00f3n":331,llamar:[175,91,77,93,164,2,22,271,354,248,326,166,379,7,143,327,61,282,383,146,178,149,363,386,41,338,202,390,293,46,73,346,186],pareja:[136,386],llaman:[14,73,297],regular:[239,0,177,242,166,40,250,305,10,144,323,227,106,231,338,343,225,293,48,346,186,160],testexecut:[61,7,35],showarch:[231,0],hide:[301,206],protocolvalid:[],consumen:364,simplic:[],don:[245,322,39,58,81,110,87],lanzaron:268,indicacion:99,multilangcontentbundl:101,stop_buff:264,doe:[245,102,222,254,84,273,58,141,86,375,335,228,218,297,347,212],"generaci\u00f3n":[146,166,110,313,327,353],getdefaultcommand:236,cotej:145,dot:[],"utilizar\u00e1":[266,108,298,314,206,20,319,22,117,23,243,167,247,355,97,139,29,99,82,216,32,178,60,329,294,148,149,85,310,359,154,127,230,218,287,13,44,15,67,109,110,293,236,295,181,186,113],emparejado:[342,222],inyectar:[278,238,63,52,260,14,302,189,219,271,392,2,259,234,32,91,46,66,210,252,248],devolverla:331,getavailableposit:327,devolverlo:286,emparejada:[383,342,225,60,218,186],anchura:105,syntax:[322,156,344],comprueba:[145,328,93,102,21,80,190,209,54,117,353,319,247,136,139,166,326,121,361,33,175,308,62,146,148,84,256,182,43,289,389,187,343,157,392,313,186],messageplur:[],object_mapp:213,filtra:[177,375,202,142,138],filtro:[238,388,189,77,26,322,40,379,304,60,252,305,71,177,103,148,335,130,342,270,377,344,293,204,157],proveedorderuta:[231,0],afirmativa:[219,392],delegada:[272,259,226,70,166,367],quieren:255,"ayud\u00e1ndot":199,explain:[339,261,131,194,70,347,87],delegado:[61,272,166,1,318,159,331,7,199,242,226,237,186,49],phpsessid:84,incorrecto:[314,14,33,228],totalment:[128,337,213,18,234,331,145,115,98,166,99,2,8,241,46,341,386,60,346,186,161],strict_vari:[68,341,16],folder:[199,273,244],your_loader_nam:293,empacada:[213,204],aminorar:70,simularla:357,empacado:[277,145,200,305,383],exporta:[363,384],persistirlo:[338,99,297,166],destruida:49,traza:7,sportmeetup:327,aportando:[372,151],independientement:[144,102,319,161,331,1,84,125,350,99,383,241,70,386,60,186,25],persistirla:[99,166,277],apacherequest:205,translation_domain:[226,109,127,167],bar:[384,0,138,294,163,22,2,94,117,375,209,212,380,193,58,141,7,8,178,277,60,242,319,61,177,329,222,147,166,148,84,150,125,85,153,225,154,180,231,218,363,338,14,390,68,343,204,339,181,73,313,90],baz:[329,384,363,178,180,85,153,154,294,181,313],disco:[389,128],reload:[68,339,343],jquerybundl:86,redefinir:[176,189,356,99,367,137,28,289,149,202,148,109,343,293,351,204,16,60,90,167],"dise\u00f1ando":[136,186],exceptioninterfac:289,"aseg\u00farart":96,forobundl:341,"tendr\u00e1n":[99,218,121,186],binario:[337,314,130,92,70,209,360],your_listener_nam:251,utilizars:[331,135],missingoptionsexcept:39,inactivo:247,deciden:331,aumentan:16,validatedbi:[66,32],subject:[382,200,343,264,334,70,94,327],said:[],routeparamet:96,"pac\u00edficament":386,routing_default:245,marcar:[288,14,363,293,336,33],"tuvi\u00e9ramo":204,flojera:23,simplest:[],symfony_cmf_cor:[308,110,96,367],enableprofil:[343,43,361],datetyp:[137,28],magic_quotes_gpc:370,attribut:[138,348,206,345,188,329,117,210,386,353,212,375,27,137,28,97,383,29,82,162,142,216,359,355,219,308,221,294,178,84,85,330,154,181,66,127,285,287,13,339,44,108,67,235,344,70,295,157,392,313,186,347,113],my_new_web_dir:306,setthem:[99,167],"sem\u00e1ntico":[326,213,18],ancho:[331,364,105],locale_switch:339,blog_show:[346,298,161],latencia:331,"sem\u00e1ntica":[193,213,341,14,189,356,153,8,158,367,107,135,319],"_get":[222,138,84,121,242,375,211,161],lazi:[338,66,39],considerando:99,"m\u00ednima":[373,206,137,28,82,32,122,359,305,273,255,331,310,387,105,285,367,290,14,110,295,370,235],conn2:[148,388],hicimo:277,article_id:346,session_regenerate_id:386,paramnam:209,eventualment:[25,222,18],symfony_cmf_tree_brows:[245,86],garantiza:[91,145,219,376,330,193,341,355,97,58,99,216,144,329,146,178,85,154,127,259,287,13,389,294,181,113],empareja:[231,62,222,225,342,110,186,367],mycontrol:[231,331,0],against:[110,87],una:[0,375,91,1,189,92,93,300,2,238,94,3,191,166,95,4,193,5,96,332,281,97,98,6,99,7,194,388,216,9,100,305,101,10,307,308,102,196,197,198,199,311,349,11,298,105,310,106,107,299,278,12,13,14,201,15,202,327,109,110,111,16,312,313,112,113,222,108,256,18,158,206,20,177,318,190,200,320,21,329,346,22,117,23,24,211,25,321,26,322,54,213,214,119,28,123,163,29,30,31,326,8,121,243,32,306,122,218,204,33,355,219,220,34,35,254,36,37,124,331,221,38,293,157,126,354,330,40,226,227,41,286,228,336,337,127,43,229,128,377,232,129,287,338,44,247,234,131,45,159,343,225,249,236,137,46,345,328,371,47,380,48,49,341,50,51,251,52,348,335,267,140,350,241,351,352,242,362,135,245,376,209,56,136,57,138,139,58,356,134,250,334,142,357,358,60,143,248,360,319,61,144,62,167,63,147,231,255,115,149,150,64,317,152,153,364,154,65,365,155,185,66,366,258,367,259,215,207,260,252,361,289,67,118,68,263,389,70,130,71,72,73,370,235,160,161,266,74,315,268,342,75,76,77,78,164,333,374,79,80,165,270,275,269,146,272,168,210,273,171,274,359,314,271,379,82,344,257,148,172,83,173,280,175,176,382,383,384,283,282,284,178,385,84,224,85,373,179,323,386,180,387,188,182,240,285,277,183,184,88,288,363,290,297,291,390,90,187,391,145,89,294,295,181,392,205,186,353],"destrucci\u00f3n":49,uploadact:[297,67],interno:[26,322,273,260,14,316,166,343,386,311,47,186,211,49],admin_bundle_menu_menuitem_delet:[],uno:[0,92,93,2,190,298,4,193,6,99,9,305,273,199,310,200,14,112,15,202,110,204,201,222,18,19,145,118,177,22,117,23,211,35,322,213,326,8,121,219,328,319,37,331,330,226,71,228,231,337,338,341,342,343,46,346,49,352,242,362,353,247,205,140,250,251,60,144,254,128,148,149,256,152,153,364,66,70,157,161,266,74,80,166,167,210,98,380,281,382,383,384,178,84,386,388,182,286,184,88,288,363,390,293,295,181,392,297,186],xcach:[148,388],foobar:[14,180,141,350,312,167],entendimiento:[],loader:[239,0,189,299,271,211,341,248,81,6,8,83,144,319,104,221,124,224,153,226,65,106,231,60,389,201,293,346],periodo:[11,152,49],stopsect:152,contrato:129,soport:[240,231,177,142,147,18,331,108,7,156,86,111,106,218,346,204],baract:157,averiguando:[],gc_maxlifetim:[226,49],motivada:89,interesa:146,mydatabas:30,three:[137,28,234,327,86,285,347,87],"inserci\u00f3n":166,trigger:[2,213],interest:[218,273,142,131],basic:[327,169,247,141,70,217,92,100,186,347,87],"construy\u00f3":153,adelgazan:37,usada:[272,144,62,293,181,166],reajustar:351,fijar:[206,92,93,22,212,250,355,97,29,6,99,82,216,359,33,329,222,178,331,85,154,337,127,287,13,44,67,294,295,181,297,113],pueden:[298,91,92,93,2,193,6,99,7,305,308,11,200,14,201,108,202,109,110,204,16,40,18,20,219,319,23,211,25,322,323,213,28,29,326,8,121,32,33,328,222,331,225,226,335,337,338,341,234,111,131,45,343,344,46,345,49,238,240,242,56,136,249,251,60,61,144,62,255,150,363,367,260,158,235,161,266,268,342,77,166,167,272,210,277,212,279,175,176,282,383,84,182,285,286,288,289,293,188,186],usado:[308,284,337,213,110,148,139,270,286,99,319,8,121,204,22,367,346,166,161],controlado:23,pista:[60,166,319],finishview:[266,293,362],pueder:392,cambi:[322,367,96,205],mailer_us:[227,16],block_cach:197,subsequ:141,desactuva:205,servic:[266,238,332,162,91,264,115,282,140,78,319,102,351,388,164,246,117,362,271,211,212,141,169,197,354,303,248,58,81,30,156,335,353,32,270,251,9,278,143,327,10,176,382,62,226,204,147,159,148,385,221,150,153,330,225,86,41,228,66,366,210,87,367,259,200,338,14,108,234,131,90,68,292,110,293,249,70,252,157,392,73,186,347],sharedmaxag:300,hiddentyp:232,encontrar:[0,240,342,41,349,77,241,228,190,117,23,166,135,222,322,210,341,30,99,191,388,60,384,219,144,145,146,231,255,148,331,84,256,153,65,105,218,128,184,337,363,338,14,108,234,389,343,110,89,204,311,312,161,186,49],calcul:343,extrarout:81,servir:[40,331,342,318,326,226,49],mycollect:70,precio:[338,166,270],addemailact:93,alimentar:[14,0,231],esicach:197,sever:[246,239,339,108,81,141,347,87],relacionada:[255,168,184,138,238,57,331,108,202,166,109,8,226,111,335,375,47,186,135],bello:331,unix_socket:148,subobjeto:391,construya:[389,84,99,8,204,135],make:[245,194,322,375,349,327,233,212,58,81,141,344,156,293,180,70,339,45,271,347,87],askconfirm:[61,314],produzcan:338,who:[61,7,35,327],compartiendo:[23,275,30],meetup:327,fachada:158,crearemo:161,diferencia:[306,238,294,282,92,22,383,241,165,166,319,193,341,99,7,8,60,204,61,144,329,35,331,85,363,226,335,228,367,278,337,288,338,14,108,305,70,154,392,47,186,161],seed_provid:162,"_env":371,ello:[247,74,161,18,91,145,349,78,207,2,346,375,166,222,168,56,136,248,138,99,7,8,121,277,252,305,33,319,61,62,146,197,331,84,149,322,64,286,153,125,157,341,392,367,93,259,288,363,338,14,108,342,202,327,110,70,16,46,71,72,73,297,186,347,49],lunet:339,atrapar:9,form_emails_:[],kit:41,itera:[383,330,389,342,202,210],some_provider_key_from_abov:[],emailvalid:12,issynchron:182,acme_hello:[175,259,319,341,153,204,106,158,346],repeticion:193,hacer:[0,91,1,92,93,300,2,238,190,298,193,96,6,99,7,215,305,306,102,11,310,299,35,14,257,15,202,109,110,204,16,313,18,314,206,20,282,319,21,22,23,211,25,213,119,31,8,121,32,33,332,222,38,331,221,124,293,330,226,335,228,127,231,232,338,342,343,46,371,346,48,49,51,251,349,350,351,42,242,362,353,56,136,248,139,142,357,358,60,252,61,62,361,254,269,149,150,64,153,366,367,157,72,73,161,266,268,76,77,80,165,375,271,167,272,166,98,380,172,278,175,177,383,283,178,84,256,388,286,288,363,389,390,145,392,297,186],contextmenu:245,inherit:[206,355,22,137,28,97,29,141,82,216,359,329,178,85,154,335,285,287,13,44,67,294,295,181,235,113],programa:[322,309,124,20,180,11,204,16,71,228,166],endif:[266,308,339,362,109,98,204,25,186,167],getreturnvalu:[94,390],swift_mail:[14,9,382],hacen:[266,322,56,331,84,343,109,2,46,117],left:[234,87,86,339,45],emitida:386,"dif\u00edcil":[176,240,91,331,84,247,281,121,204,357,71,60,313,186,161],protocol:[260,148,84,263,226,32],firstnam:[50,39,387,250,290,269,257,163,38,93,99,391,380,79,65,80,122],escaparlo:14,"f\u00edsicament":322,nordland:342,weakrefer:70,recbir:[],human:[109,344,167],multinivel:65,yet:[313,86,33,141],languag:[224,108,88,240,260,339,75,375,141,93,99,110,154,195,111,344,218,60,166,347,226],candidata:312,cachewarmerinterfac:293,sumando:49,multiservidor:30,formfactoryinterfac:327,candidato:[259,342],cuidadoso:315,pointcut:221,macport:199,cd01749bb995dc658fa56ed45458d807:247,invalidargumentexcept:[153,326],deduciendo:[99,186],eur:206,save:[222,339,261,194,226,277,297],migracion:[241,20,166,277],trabajen:[234,367],"t\u00e9cnicament":186,applic:[51,268,1,212,249,241,375,271,35,245,322,169,213,214,56,58,81,141,7,218,204,61,236,222,273,199,87,128,339,233,327,343,156,70,346],introduzca:314,logotipo:121,hinclud:[344,204],testform:182,amarillo:[11,61,7],settrustedproxi:272,etapa:[277,199,383,186,166],fijamo:8,driveropt:148,background:322,field_nam:226,formattermanag:252,phpcode:180,publicars:260,alltest:158,"grab\u00e1ndola":[],form_edad:167,form_login:[58,194,242,100,186,25],role_user_host:186,inasequ:[110,218],acme_friend_messag:327,get_set_method_norm:292,disposition_attach:[375,138],genderchoic:362,implementando:[182,110,342],www:[298,145,115,349,78,300,241,388,166,25,200,169,5,341,303,139,249,81,326,8,121,32,9,60,176,382,62,319,147,231,148,153,323,212,106,93,118,259,12,289,283,202,90,68,338,264,70,346,186],deal:234,ssl_http:[],"pondr\u00e1":367,interv:60,"sacar\u00eda":193,adelantado:166,"m\u00e1stil":251,"secci\u00f3n":[247,222,327,145,20,317,77,93,242,319,383,326,165,304,166,135,25,4,193,213,96,56,202,58,362,99,98,215,121,211,146,172,60,204,33,328,102,167,35,26,255,341,331,125,349,153,386,277,228,367,78,218,179,338,14,108,234,111,305,343,110,293,89,70,16,392,161,346,186,347,49],revel:215,intern:[322,141],malicioso:204,websiteid:245,interf:[],pintando:22,nativesessionhandl:49,decirt:161,total:[364,166,80,341],sf2debpkg:20,visitando:341,getpreferredlanguag:[242,222],mysql_real_escape_str:[],superglob:[343,386],extra_kei:197,generen:[338,166],render_esi:[331,344],tracker:[31,339],impulsado:362,decirm:[],impulsada:161,getpathel:141,dice:[74,138,2,23,166,375,247,121,33,177,222,331,153,288,363,260,14,341,338,343,204,46,71,73,346,186],localhost:[284,0,145,349,242,166,193,341,326,121,277,144,273,148,199,388,87,231,338,70,90,161],conced:[219,330,136,286,392,186],aumenta:[136,14,341],bold:[61,7],clarament:[31,281],producttyp:[327,127,146,167],reportado:[],habido:328,"super":[],habilitar:[0,268,145,189,93,301,96,341,362,7,60,331,10,204,199,225,43,258,367,231,259,338,343,293,70,16,312,370],postgresql:[349,166,30],confiabl:[272,14,331,343,226,241,237,159,161],conceal:[61,7],"cargar\u00e1n":14,negativo:[359,219,60,368,295],simul:[194,189,196],"env\u00eda":[206,76,92,2,383,22,167,171,137,28,285,99,215,142,251,9,252,33,313,102,222,189,331,84,64,386,151,127,43,259,232,260,14,67,202,235,343,46,297,186,48,161],hicieron:166,afternoon:178,generador:[284,19,189,23,166,211,361,27,96,247,192,99,121,9,360,10,328,196,37,180,43,338,343,264,293,90],mezclada:193,datacollectorinterfac:10,commit:[337,221,261,33,92],"correlaci\u00f3n":200,"env\u00edo":[313,74,383,222,171,207,14,84,298,267,64,134,99,343,33,279,90,297,186,48,161],"\u00e9xito":[62,84,93,99,102,353,242,186,33],foobarprovid:141,nombreusuario:33,vuelo:[130,20],down:[194,241,327,81,141],doctrina:[],formerli:[],setplainpassword:74,requerido:[219,367,193,222,148,199,365,58,109,264,86,70,344,22,226,210,167],terminaran:[],getrequestformat:[249,204],envolvent:[375,138],"activ\u00f3":293,"inyecci\u00f3n":[17,238,91,2,165,271,211,26,341,248,166,304,353,32,278,252,282,62,319,336,385,125,226,335,106,66,367,259,260,14,234,186,343,293,46,159,161],recommendada:255,editor:[213,18,130,77,326,111,339,33],fraction:82,viajen:71,comenzaraala:95,encanta:341,fork:[89,33],accesorio:[273,338,199,315,326,110,70,182,23,166,367],compatibilidad:[153,309,384,204,138,237,145,11,99,142,363,375,47,350,33,49],foro:[31,260,121],form:[266,74,298,294,206,76,355,98,93,207,2,301,351,329,344,22,210,3,25,321,380,322,170,232,136,137,28,97,163,58,29,362,99,82,194,216,142,182,167,327,33,295,62,226,146,222,178,84,189,85,310,153,359,154,228,66,44,127,285,367,274,88,13,339,14,287,67,202,235,68,109,343,110,293,280,70,16,46,181,297,186,342,113],sendfil:375,"adici\u00f3n":[266,144,26,1,202,293],storeev:[46,2],doctrinefixturesbundl:[26,338,326,70,114,23,166,347],exactament:[18,373,92,93,300,2,241,351,346,54,166,222,56,338,99,8,121,122,60,305,383,146,254,331,84,38,152,312,387,105,336,367,277,337,290,14,112,341,342,202,187,343,389,204,46,72,313,186],efectuar:23,terminen:273,mirada:[121,367],asignacion:[200,213,57,388,349,363,70,148,288],afectar:[328,319],afectan:[60,204],colector:[10,328,192,189,226,293,211,361],mi_apl:204,second_nam:[310,207,74],featur:[322,197,1,163,141,326,156,347,358,313,33,87],aprobada:157,classic:[],recupera:[282,222,247,136,331,84,115,256,77,338,386,142,357,277,158,166],zend:9,handleundefinedmethodev:94,fromstr:375,activation_strategi:264,ship:[246,273,197,70,87],jsmith:247,pdosessionstorag:30,vista:[26,383,56,381,362,266,343,121,204,42,71,228,167,297,305,211,161],somenam:58,garantizando:[23,108,202],proporcionando:[62,1,77,31,218,16,60],visto:[231,383,286,0,341,14,166,93,99,2,121,204,46,226,346,186,167],esperaba:[211,70],asegurar:[247,50,96,162,338,119,138,269,326,225,351,190,375,186],minvalid:291,digital:331,alerta:204,"as\u00edmismo":346,executioncontext:[],diez:[331,204],exhibiendo:222,reconozca:353,muchosamucho:202,publicar:[107,129],tagformli:202,optar:[175,337,222,341,248,221,202,64,271,98,204,228,346,186,167],poderoso:[341,319,240,84,99,8,311,166,153],teletipo:331,poderosa:[341,56,14,84,58,93,99,8,121,204,16,346,166,161],dicha:[231,219,0,138,108,152,98,8,375,346],femal:[178,39,362,93,190,22],furthermor:[],adminbundl:86,duplica:[366,289],dicho:[282,18,331,99,344,23],visualizarlo:386,ignor:[14,347,211,92],login_path:[242,186,58,25],session_destroi:386,ejecutado:[51,222,241,341,383,121,277,157,346],skip:[],phpdumper:319,ejecutada:214,invent:81,menor:[373,79,47,167,291,8,122,60,33,383,222,123,387,105,185,290,130,201,234,338,313,340],mile:[110,84],anadir:[],"_product_name_widget":167,primer:[152,387,332,18,314,327,1,145,349,318,93,319,102,351,117,23,166,135,25,310,26,322,193,341,136,383,268,139,140,362,99,7,8,121,353,32,381,122,60,236,33,61,176,282,62,142,273,255,221,124,180,146,11,153,225,256,299,277,286,228,336,311,84,219,126,259,215,179,290,14,289,202,305,187,343,293,89,204,16,72,297,186],"dej\u00e1ndot":367,hierarch:108,"verificar\u00e1":62,"pr\u00e1cticament":[222,142],depend:[175,342,253,145,20,219,102,22,271,169,170,96,248,356,99,7,121,172,218,327,280,61,328,62,70,197,39,153,226,217,228,182,184,14,108,234,335,111,181,297,186,347,49],torno:[222,338,14,84,298,349,166,344,181,186,161],intermedi:141,definitionsmtp:[117,353],sonata_block:[255,326,86,197],distingu:[363,225,288],cmfproject:26,debemo:[210,49],nextal:[343,142],noticia:[247,346,331,84,77,204,157,18],"suscr\u00edbet":89,string:[2,190,95,303,97,195,9,10,310,105,12,200,13,14,257,112,113,314,206,355,207,22,376,212,324,28,123,29,216,32,122,327,329,36,39,38,126,333,226,228,127,128,338,44,233,45,344,236,137,46,50,284,350,241,352,54,135,247,57,58,141,250,359,148,256,363,154,155,287,67,68,263,339,235,266,74,373,76,78,79,80,166,82,384,178,85,387,269,285,87,183,185,290,291,187,294,295,181,297,186],only_master_request:226,revalid:331,emailcount:22,escucha:[267,51,189,219,249,2,383,390,94,66,211,168,139,58,166,276,120,251,173,220,62,146,336,331,332,256,334,182,367,200,338,340,131,68,293,46,157,158,186,161],integridad:108,previa:25,insignific:81,"dise\u00f1a":[331,135],brinda:319,dio:117,did:[213,81],die:144,dig:[],iter:[61,177,102,247,39,58,202,7,110,186],"dise\u00f1o":[341,220,34,167,222,56,84,149,92,286,383,65,204,311,158,362,305,161],getextendedtyp:266,rendimiento:[316,328,199,165,211,26,247,136,121,385,144,319,331,349,286,364,368,389,14,201,130,48],"aparecer\u00e1n":[],public_html:306,addeventlisten:327,veamo:[231,102,0,341,84,202,166,277,186],div:[222,218,213,240,25,202,305,99,98,386,204,22,167,186,242,161],format_verbos:364,round:[],dir:[61,306,177,273,289,148,145,67,7,226,70,388,118],height:[123,387,105],admin_dashboard:339,setpric:[338,277,166],"cr\u00e9alo":14,database_port2:115,"bas\u00e1ndot":[327,346,96,153,166,313,338,362,99,326,135,204,392,100,186,33,161],comienza:[266,74,1,145,207,95,341,250,380,277,144,331,84,180,226,14,202,204,130,158,297,186],comienzo:[281,145,180],setpriv:[331,375,138],"l\u00f3gico":[341,289,77,121,16,346,33],"sit\u00faa":331,specialact:367,"l\u00f3gica":[266,18,206,77,93,2,326,22,166,211,247,136,137,28,268,82,362,99,7,121,32,251,277,60,305,280,61,295,144,332,222,84,149,310,153,41,285,367,359,140,260,108,342,202,235,338,110,293,204,16,157,392,186,161],"librer\u00eda":350,emitir:[386,166,198],getlanguag:[224,84,375],era:[231,248,152,204,336,271,161],vengan:102,agosto:215,"reducir\u00e1":389,propertypath:163,dataev:[],extendiendo:[238,222,341,335,342,362,236,16,218,32],french:141,ansicon:7,coincid:[0,93,383,242,166,298,214,341,139,3,250,142,60,219,62,222,84,231,338,311,392,346,186],"pasar\u00eda":161,wait:[358,313,197],alto:[266,268,145,349,207,383,211,245,213,56,18,58,99,315,222,273,123,286,364,367,14,342,202,344,70,49],nuevo:[189,92,2,193,97,98,6,99,216,306,199,286,106,200,13,14,15,202,110,204,311,313,113,18,314,145,118,319,21,164,23,211,25,321,322,213,28,326,8,121,32,327,33,222,331,124,125,41,228,127,230,232,338,341,342,45,343,355,46,371,47,239,349,241,243,245,247,137,138,249,60,143,144,62,146,152,153,337,70,71,235,161,266,372,163,76,78,22,374,375,275,167,210,166,276,277,281,282,383,386,285,87,287,363,346,293,89,392,297,186],instituto:58,scalarnod:[153,62,193],inclinada:[177,110,346,323,367],alta:[367,14,20,110,204,60,186,161],"acompa\u00f1ant":308,escaneado:[165,366],"dise\u00f1\u00f3":357,midgard_namespace_registri:199,manejador:[176,226,133],rslt:[245,244],setclientttl:[375,138],profundizar:16,useful:[],iana:[128,105],sufijada:142,your_extension_nam:293,evaluar:[199,331],getbodi:[43,204],existengt:[],default_templ:317,activado:[284,213,93,179,241,204,186,361],"un\u00edvocament":[331,84],robo:226,discut:[46,2],depuramo:144,finalizar:247,pasars:62,creamo:[140,41],sake:141,franca:[],dude:[33,16],perl:[363,288],everybodi:[],setrefer:23,regexvalid:250,tu_nombre_de_usuario_gmail:227,pasarl:161,checkout:[213,273,92,313,186,33],utilizando:[93,300,2,4,193,302,99,7,100,102,197,199,11,106,14,202,109,110,204,222,18,314,145,20,318,320,22,209,23,211,25,322,213,326,328,34,319,331,223,226,42,130,342,343,346,48,49,349,353,341,248,138,139,142,60,360,61,144,62,147,115,150,256,153,366,367,368,260,70,158,161,266,203,163,77,80,375,166,273,172,278,175,176,219,384,84,85,386,64,388,288,363,389,186,293,297,90],cuestan:[277,166],priorizada:367,soapact:9,priorizado:342,ordenarla:181,redondeo:[359,295],galleta:[219,383,331,139,226,49],oop:[51,311],examin:346,format_args_as_text:344,espera:[0,118,22,2,190,243,193,247,380,9,62,178,84,228,231,338,202,343,46,392,346,186,49],"acr\u00f3nimo":260,fly:[70,87],facilitan:[346,204],agregamo:[202,166],"reenv\u00edan":215,uniqu:[383,32,197,247,233,256,45,207,70,166],odm_mapp:41,atraiga:33,filebag:[375,138],convertida:383,fle:[],facilitar:[61,239,18,14,201,20,286,7,242,158,305,33],helloservic:9,purista:341,mongo:338,directorio:[266,222,0,19,145,20,177,92,130,354,21,165,23,275,135,35,322,169,213,56,166,389,356,362,99,326,8,121,277,60,204,101,306,144,167,70,147,273,149,148,199,311,124,180,349,289,153,299,388,233,189,231,118,184,337,179,260,14,201,15,67,341,305,338,343,293,33,111,16,328,71,158,297,90,48,161],metaorden:[61,7],agent:[331,84],coincident:[231,177,0,342,310,346,186,222],desajust:234,apoyando:[153,283],potenci:[61,383,129,342,202,350,7],conflict:141,sundai:[],"franc\u00e9":[60,293,89,294,36],normaliza:[137,28,235,285],myapplic:236,charset:[115,349,78,79,375,166,135,341,30,326,277,9,148,16,153,387,122,183,290,233,56,68,204,311],parch:[26,151,31,179,215,313,33,174],doctrine_phpcr_type_tree_model_widget:245,pura:[166,135],"pasar\u00e1":[222,153,341,250,310,109,2,46,49],foreach:[19,93,22,117,353,330,322,40,362,142,218,175,177,167,222,153,386,182,130,202,204,71,161],maestra:[251,383,313,89,211],maestro:[376,24,89],adicto:242,configuremo:[],map:[326,50,235,373,208,76,74,93,207,79,80,352,190,376,210,291,3,135,330,95,200,54,213,247,324,137,28,123,139,140,141,99,178,195,32,148,122,60,101,254,128,36,166,115,38,349,126,333,257,250,105,155,185,269,263,127,285,367,388,78,183,12,338,232,112,202,45,187,391,89,70,339,273,241,297,186],mar:331,http_refer:[343,25],preconstruida:[341,16],max:[230,183,193,185,254,123,290,130,331,387,373,391,204,105,190,122],topnav:339,usabl:322,habilitando:[10,130,192,258,268],mac:226,enc:9,"tu_contrase\u00f1a_gmail":227,mitipopersonalizado:148,mai:[199,58,81,141,326,313,327],foodevvalu:153,underscor:[61,7,344,86],session_:211,mal:[384,234,104,363,226,16,228],showact:[354,37,331,68,338,277,42,210,346,166,211,161],value_is_arrai:[61,7],quedaron:204,tale:[322,34,319,341,338,14,84,342,29,362,343,211,16,346,166,135,161],acmelisten:[46,2],"switch":[175,339,186,347,87],establecieron:49,cascada:[202,135,77],blockinterfac:[140,77],contribucion:18,tall:123,avanc:341,ida:70,talk:[],compilar:[389,117,40,319,204],"num\u00e9rica":[148,359],lsa:358,name_row:167,doctrinelisten:66,desarrollando:[121,213],"d\u00e9bile":331,entitl:[],nombr:[0,189,92,93,354,2,190,4,193,96,97,98,6,99,7,216,100,305,101,10,102,103,198,311,349,286,106,107,299,13,14,201,108,202,109,110,204,16,313,113,15,138,314,206,115,282,207,319,346,22,209,210,211,25,321,322,213,214,29,30,326,8,121,353,32,122,218,33,329,222,37,331,221,124,224,225,226,41,42,336,127,72,230,231,232,338,44,247,342,131,45,344,236,355,46,47,49,341,284,240,267,350,351,352,242,228,362,243,376,56,57,268,139,58,356,142,357,60,143,61,144,62,63,147,148,149,151,152,153,154,65,337,66,367,359,368,260,289,67,389,264,70,71,158,160,161,266,74,162,163,76,77,164,80,375,166,167,272,197,274,82,293,212,175,177,383,384,178,84,85,386,256,387,388,310,118,184,287,363,290,237,90,145,89,294,295,181,297,186],entiti:[266,50,387,241,373,208,115,74,93,190,79,80,352,22,228,23,291,166,135,254,95,200,54,170,247,136,57,123,58,263,99,380,195,32,122,60,327,175,146,36,148,38,256,126,333,391,257,250,105,155,88,269,185,229,128,183,274,12,376,303,290,112,324,202,131,45,187,243,338,70,181,297,186],geticudatavers:224,group:[382,359,247,206,141,93,99,156,86,295,23,166],thank:[],remember_me_paramet:58,userprovid:[62,256],"categr\u00eda":[],taller:123,establec:[284,0,375,52,294,206,76,282,164,62,80,346,22,386,23,138,166,211,212,193,213,250,137,28,97,334,249,29,362,99,82,380,216,190,178,277,9,60,143,355,175,382,34,226,222,231,148,331,311,329,85,310,153,359,154,227,388,287,127,285,210,367,128,259,232,13,289,44,67,202,235,357,343,293,204,295,181,113,297,186,48,49],formatean:341,instancia:[175,74,51,0,375,18,91,163,219,77,350,22,2,238,351,388,357,94,210,166,211,222,391,193,213,247,136,383,138,139,326,362,99,98,142,341,32,344,251,277,9,143,204,354,10,176,177,62,111,178,331,84,150,256,286,153,40,386,234,335,228,164,231,207,260,14,108,67,202,338,343,110,70,46,346,186,342,49],empat:281,encode_as_base64:[247,102,58,186],main:[342,166,25,322,5,81,98,358,277,176,382,332,111,283,331,84,125,217,106,87,339,261,264,293,204,16,346,186],soapclient:9,filterdataev:[],phpfunction:180,introdujeron:[],esperaban:254,"extra\u00f1o":[84,121],"5xx":382,entitymanag:[136,221,131,228,66,327,229],versionada:226,"factor\u00eda":[220,62,14,385,108,282,256,293,248,164,143,159],own:[213,339,234,293,81,270,292,156,86,347,111,217,367,342,87],my_router_class:[110,367],cazar:[14,346],compilerpass:[117,385,353],"condici\u00f3n":[93,75,129,146],nusoap:9,fileload:299,someversionschem:16,"leg\u00edtima":95,deducir:[310,99,67,293],gestionado:[322,338,115,166,204,242,186],full_nam:99,rock:343,gestionada:[278,166,247],postresponseev:383,"\u00f3ptima":389,entity_provider_nam:[],userpassword:[93,75,3],continu:[61,332,314,199,39,70,331,33],fijarlo:33,gira:[338,166],adit:347,facilitarno:[99,161],ascendent:23,"3rd":[217,189,356],recuper:161,suscriptor:[267,146,338,189,131,327,2,293,46,336,166],newslettermanag:[238,252,14,335,271,259,91,164,143,248,212],monolog:[26,382,176,201,189,328,125,179,264,293,304,133,16],inadvertidament:226,prudencia:[306,239,268,314,234,163,318,79,22,166,361,322,193,247,137,28,313,31,99,10,281,177,146,331,39,149,153,364,386,228,182,183,185,14,291,67,202,187,89,204,311,297,186],poco:[205,315,220,102,351,22,383,213,136,268,139,99,8,144,62,273,84,150,386,228,14,202,131,293,204,16,328,49,297,186,161],condimentada:[],consoleoutputinterfac:268,correct:[339,322,327,70],poca:[341,255,14,84,355,8,248,190,271],after:[313,177,51,240,261,199,39,189,379,383,358,157,297,327],"comprobaci\u00f3n":[245,62,319,389,340,221,256,251,259,69,242,376,33,161],"_content":[341,161,342,65,56],setvariablepattern:[110,367],asignarla:[],"f\u00e1brica":[182,163],headlin:218,oro:350,ajax:[245,222,56,327,244,86,242,25,346,305,211,213],orm:[74,18,115,349,78,241,242,23,166,135,210,213,247,136,99,326,8,32,277,278,327,111,148,221,286,228,66,229,367,200,338,201,342,202,131,45,303,70,16,181,72,297,186,161],arrancarla:182,setpassword:[207,23,186],org:[298,145,115,92,78,300,241,166,212,200,323,5,341,303,249,81,8,32,9,60,101,176,382,62,319,147,273,148,199,153,388,106,213,93,259,12,215,179,283,15,202,90,68,338,264,337,70,346,186],arrancarlo:[],registran:[338,319],iddqd:162,apagar:386,thing:[339,331,327,358,217,1,87],registrar:[267,51,268,189,328,78,2,21,117,210,271,319,4,168,341,303,248,249,362,276,251,176,144,62,204,147,166,331,221,124,125,65,367,338,14,201,131,293,133,46,351],principl:[],think:339,first:[240,77,350,245,170,141,326,142,122,327,33,204,39,310,335,87,93,339,343,70,313,347],ocupa:[99,167,49],kernel:[213,284,205,388,189,144,2,383,326,165,275,211,26,322,147,341,268,139,249,166,379,304,276,251,306,217,173,204,175,176,382,62,35,103,336,148,331,221,104,153,226,157,66,229,87,184,260,14,233,311,68,343,264,293,70,16,46,71,73,346,48,161],carri:[],carro:[363,288],assets_version_format:226,"pint\u00e1ndolo":99,desventaja:[175,322,259,341,314,91,20,389,167],fija:[281,382,213,99,331,341,144,180,362,94,105,22,346,211],fast:1,crit:268,sienten:240,getfoo:[390,32],obsoleto:[331,244],demostracion:260,isxmlhttprequest:[242,332,222],negocio:[266,18,136,137,28,206,392,166,310,338,82,121,295,277,285,359,235,280,161],tomando:[331,84,2,46,157,346],tedioso:236,tediosa:[175,16],my_mysql_connect:193,"comprensi\u00f3n":121,routerepositori:312,recuperada:[46,2,210,282,390],parezcan:346,"insinuaci\u00f3n":383,aprovecha:[144,383,134,99,43,167],temprana:[199,33],curiosidad:343,"llegar\u00e1":[8,386],corchet:[172,288,33,363],comment_id:210,temprano:[367,110,249,70,166],ignore_dup_kei:30,incorrecta:[121,33],memory_provider_nam:[],reimplementar:268,"n\u00famero":[314,91,75,93,2,79,22,376,54,166,167,193,27,136,137,28,58,250,82,344,121,60,33,270,281,177,206,361,384,123,331,126,363,40,226,388,310,228,285,350,367,128,183,359,185,288,338,291,202,235,187,343,110,360,295,46,364,346,186,48,49],webdebugtoolbarlisten:[383,293,211],simplista:[218,213],aceptando:[99,342],"vers\u00e1til":331,volviendo:[136,242,336,388],aumentar:[7,205],were:[34,222,254,261,58,141,212],surrog:[318,211],fijado:[91,355,250,105],registerfil:[255,326,349],recomienda:[386,60,145,186,49],"fij\u00f3":254,"sinn\u00famero":222,analizador:[363,384,65,180,288],appbundl:[200,198],apodar:73,dash:[],setparamet:[238,205,30,351,164,117,6,271,353,212,247,248,362,8,143,102,319,283,166,332,153,335,259,14,234,157,158,90],larri:342,webserviceus:102,schemaloc:[298,115,78,300,241,106,166,211,323,5,341,303,249,81,6,8,32,60,176,382,62,319,283,148,64,153,388,200,93,259,12,338,202,68,264,70,346,186],calendar:322,phpcr_backend:70,deducirlo:66,precargar:245,volverla:200,mueva:297,"gustar\u00eda":[266,23,254],round_up:[359,295],oculta:314,"evadir\u00e1":162,advis:197,interior:[144,222,341,338,14,202,166,93,99,2,8,204,46,277,60,346,186,25],fingerscrossedhandl:176,ob_start:[9,375,161],descarta:[],oculto:[88,298,99,76,109,232,25],channel:[176,1,264,293,125],performnodeepmerg:193,providepath:141,encodepassword:[23,186,256],obligada:84,track:[135,52],obligado:[99,98,331,161],setallowedtyp:[228,39],blobdir:[349,70],beta:338,enfocado:84,blog_com:135,pais:266,unidad:[364,166],phpcr_refer:70,agregast:[117,166],manerea:388,hellorequest:9,corrig:[],shop:[],estoi:[242,99,305],multilingu:110,precisa:104,serializ:[186,247],show:[231,0,354,14,217,311,261,141,298,156,70,44,42,346,204,347,161],puntuacion:283,"fijar\u00e1":[346,6],preciso:[98,284,226,49],olvidar:[22,57,230,166],form_submit:109,olvidan:166,addmethodcal:[282,238,14,335,234,271,91,117,252,248,353,212],usermatchercach:19,flack:213,frontend:[339,156,8,87],enfrent:49,"bas\u00e1ndos":[138,19,77,375,166,135,319,327,96,56,137,28,240,139,99,326,121,211,60,305,236,219,383,146,197,331,256,11,386,106,367,231,290,342,159,338,110,69,204,49,346,186,160,161],interaccinen:308,"asign\u00e1ndola":241,sucediendo:279,getprofil:[343,43,361],"espa\u00f1ol":[84,89],behind:[347,261,131,111,87],peticion:[0,332,138,53,318,253,242,375,211,298,40,213,205,139,121,251,361,279,219,328,62,222,198,331,84,64,5,367,260,186,343,110,16,346,90,161],inofensivo:204,"repetir\u00e1":286,companytyp:380,articleslug:331,disable_stream_wrapp:70,info:[61,176,51,268,221,343,153,7,216,70,16,166,33],sensata:[337,92],variou:[327,329,178,85,154,294,181,235],get:[0,189,93,298,99,194,9,308,199,14,109,110,204,138,314,115,207,34,164,23,211,35,121,217,327,39,222,37,331,332,330,226,43,229,231,338,339,354,234,111,343,344,346,239,242,353,246,247,136,248,58,134,142,358,60,143,360,61,253,64,364,210,366,259,261,70,157,73,161,268,163,78,62,375,271,361,169,170,81,98,172,83,176,383,84,386,388,184,47,186,292,392,297,90],conversacion:84,ilustra:[60,305],secondari:81,getxxx:47,domnod:142,operador:[338,350,177,209,270],invita:281,projectservicecontain:319,fqn:213,consist:[238,346,341,338,313,166,363,98,335,46,384,100,186,167],emaillist:22,httpexceptioninterfac:[251,383],multilangrouterepositori:218,expresament:[175,281,204],invalid_message_paramet:[137,28,206,235,310,82,295,359,285],summari:[348,183,79],wiki:[281,116,349],resguardo:[321,57],friendmessagecontrol:327,especificando:[238,319,14,335,125,153,323,80,178,72,186,49],actualizarlo:[338,277,20,166],eventdispatcherinterfac:[46,2,182],"multiling\u00fc":[70,339,1,108,342,110,86,111,218],factura:200,use_menu:[218,347],dummyi:[],relativa:[177,193,346,96,289,148,15,344,388,105,25,108,297,49],sean:[359,382,145,167,319,14,206,202,64,263,110,386,390,22,117,161,297,135,25],onetomani:[202,166],paciencia:313,relativo:[148,322,145,388],fijada:153,despachando:[46,2,383],exceptioncontrol:68,wonder:327,sustituy:[266,238,138,145,22,21,165,375,166,167,56,121,305,280,204,148,124,153,335,106,367,338,202,343,33,236,16,392],simplificar:[175,319,148,20,202,189,153,356,236,157,100,161],reutiliz:[175,56,136,14,270,99,326,91,161],escogimo:77,ain:260,llamen:186,label:[206,22,167,245,355,97,98,29,362,99,82,110,216,344,25,329,178,85,310,86,181,127,367,359,287,13,44,67,202,109,156,294,295,154,186,347,113],desplazamiento:313,enough:58,"sincr\u00f3nico":197,digest:[62,58],updatedat:135,aviso:[222,58,151,215,386,129],imita:[349,142],across:58,pusist:[213,214],"utiler\u00eda":[69,186],"si\u00e9ntat":8,august:[],parent:[238,268,205,294,206,349,329,22,182,353,167,4,137,28,97,326,29,82,216,142,359,355,236,62,204,178,331,339,149,85,153,154,335,66,285,229,287,13,44,233,67,343,70,295,181,235,347,113],renunciar:[226,18],"much\u00edsimo":58,symfonycmftre:244,tue:[137,28],prefijar:[319,338,148,186,226,388,71,158,166],all_no_priv:112,"hab\u00eda":[],consumar:331,nomenclatura:[222,147,341,314,148,201,163,151,350,153,2,386,204,346,46,60,47],solicitar:[219,314,234,338,121,242,186],cumplir:[338,331,370,166,361],empezar:[315,1,145,317,92,93,383,241,117,135,341,136,139,99,326,121,9,60,33,281,220,62,273,255,149,153,386,78,337,338,15,202,343,161],preexecut:157,inmut:135,improv:70,sucio:161,prefijan:158,registrationsportlisten:327,codifican:102,estemo:215,publish_workflow_check:308,unavail:234,alcanzar:[110,121],codificar:[102,283,56,247,256,305,152,204,106,23,186],recomendamo:[331,60,342,227],familiarizars:331,logic:[293,327,87],ultim:[],"due\u00f1o":286,toma:[0,138,93,354,2,242,384,375,166,211,319,56,9,305,33,307,177,102,222,147,178,331,179,386,334,231,363,14,341,67,343,46,49,346,186,161],wsselisten:62,iterar:177,bar_moo:193,un_em:148,acmestorebundl:[338,115,277,181,166,229],mark:[339,331,156,81],barra:[177,166,211,323,213,171,55,7,121,60,101,10,144,383,331,104,64,364,367,259,234,110,204,346],pre_bind:327,like_symfoni:343,dibuj:[99,202,77],"inyect\u00e1ndolo":[2,166],administrar:[242,60,23,115],validarla:352,short_open_tag:370,partida:[145,273,211],suscept:[26,331,304],squash:33,necesita:[0,91,92,93,300,2,4,40,96,362,99,7,100,305,10,102,273,199,104,310,200,14,15,110,204,16,313,138,314,206,115,318,207,319,22,117,23,211,222,322,213,28,326,8,32,306,218,33,111,331,221,124,293,330,225,41,228,127,72,229,231,337,338,339,247,234,45,343,248,46,371,346,49,341,238,240,335,349,140,42,56,136,137,58,251,60,360,61,144,62,150,180,153,65,367,368,369,68,263,156,70,157,158,370,161,266,74,342,77,253,165,375,209,167,272,166,98,277,278,175,176,282,384,283,178,84,179,388,182,184,288,363,389,186,145,181,297,90],omitiendo:[177,49],i18n:60,univers:[201,8],reconoc:[14,219,349,353,161],tematizando:[99,280,167],those:[245,347,322,213,81],sound:80,getremind:99,"reconstrucci\u00f3n":[313,319,341],getpropertyaccessor:[266,163],"diagn\u00f3stico":121,annotationregistri:[255,338,326,349],planeando:145,"prestaci\u00f3n":[],preocupar:[99,20],buchmann:342,preocupan:202,compila:[40,319,204,16,182,60],disociado:[260,14,286,2,8,46],disociada:[346,134],invoc:221,ciega:153,encuentran:[322,254,92,99,121,204],advantag:[39,327,212],tuvo:[84,268],"_routing__rout":205,destin:289,cluster:30,suena:[305,56],routing_load:81,"agreg\u00e1ndol":[],par:[219,204,103,247,136,252,331,288,202,363,110,386,70,9,359,127,211,214],rewritecond:205,thei:[239,213,197,58,131,141,347,70,33,254],l10n:60,argumento:[0,91,93,2,94,298,193,362,99,7,305,176,102,198,107,299,14,109,204,16,138,314,19,177,190,319,320,164,117,210,211,212,214,121,353,32,219,222,331,221,330,226,334,335,42,336,231,338,341,234,270,343,344,236,46,47,49,238,350,242,135,56,248,139,142,60,143,61,62,146,256,153,368,67,70,72,73,79,375,271,167,274,166,380,172,173,281,282,383,384,385,182,183,289,346,293,181,186,363],version20100621140655:241,obligar:[61,7,38,98],obviament:[389,225],indicador:[61,102,288,363,7,157],same:[322,70,80,339,163,234,58,81,141,110,131,111,217,327,347,212],"_token":[99,226],setroutecont:[110,367],pad:308,hecho:[108,18,1,219,92,2,241,346,166,211,254,322,341,140,99,7,8,121,319,313,382,383,222,255,331,84,104,153,330,386,228,367,337,260,14,15,202,338,110,249,70,46,297,186,161],array_merg:[350,153,77],hecha:[84,383],pai:22,"seleccionar\u00e1":[],twig_:201,aopbundl:[221,124,21],memchach:148,label_my_admin:86,persistido:[166,327,338,146,161],assist:[],capabl:[110,318],getrol:[102,62,219,247],dcm:135,descendentement:375,confiablement:158,ipaddress:112,"break":[175,322,313,33],inyecten:91,desactivando:[71,377,104,64,171],adicion:[74,162,349,319,117,135,254,354,136,18,251,218,219,222,147,255,84,64,85,154,285,389,14,202,186,110,293,294,371,235,161],"utilizaci\u00f3n":[245,383,129,14,201,15,349,99,326],dependencia:[17,238,91,145,20,349,77,2,102,21,165,271,211,244,245,26,213,96,302,248,301,304,326,8,353,32,348,218,252,219,282,62,319,197,273,255,385,124,125,179,330,151,335,106,336,278,367,259,200,260,14,341,234,159,338,343,156,293,16,46,186,342,161],ocultando:314,inyectado:[259,91,14,125,248,66,271],remitido:[58,146],createphp_cont:213,conoc:[266,1,78,166,211,167,341,99,121,277,331,255,199,11,338,14,202,389,293,16,346,186,161],insertobjectac:136,remitida:[318,311],trayectoria:[346,121,283],inyectada:367,"ingl\u00e9":[218,60,89,33],predec:[11,8,47],execut:[61,161,35,197,268,338,39,140,77,7,169,241,70,326,358,141,90,87],symfony_cmf_routing_extra:[110,96,255,156,312,218,347,367],db_id_col:30,retrasar:166,aspect:221,monei:[99,206,88],bloque:161,"pintar\u00e1":[],transport_chain:[117,353],"\u00e9chale":[270,99,77,16],pila:[176,328,319,368,342,386,345,117,210],parar:70,manejarlo:[],concuerdan:186,yuicompressor:[71,322,16],ignore_error:331,quitado:[22,184],puedan:[10,62,337,145,11,386,60,23,186],listando:263,invocar:[61,322,62,138,14,178,221,390,286,99,7,142,119,22,277,9,375,297,166,211,161],avalanche123:89,"inform\u00e1tica":14,setlastmodifi:[331,375,138],refiera:184,adivinarlo:[],tokenlisten:157,custom_authentication_provid:[],mysuperbrows:343,"m\u00f3vil":84,"aplicaci\u00f3n":[0,189,92,93,2,238,166,6,99,7,100,305,101,306,273,198,286,200,14,201,110,204,16,138,19,145,20,328,318,320,22,23,24,211,319,322,213,214,326,8,121,218,33,219,220,34,222,331,226,334,335,228,231,337,338,247,342,131,343,236,46,386,346,48,49,341,51,349,241,351,242,362,135,56,248,139,134,251,60,252,61,144,62,255,115,149,64,153,367,259,260,68,69,70,71,158,73,159,161,315,268,77,375,275,167,271,98,277,280,175,382,383,385,84,86,388,182,118,184,88,389,186,293,392,90],server:[388,145,169,273,197,138,166,199,84,189,349,30,338,343,121,70,311,9,375,275,87],procesada:[328,139,319,211],either:[245,322,273,141,110,70,347],"p\u00edxele":105,enriquec:224,db_type:[349,70],procesado:[193,319],exitcod:51,imagen:[10,128,222,142,18,130,325,322,266,8,121,70,105,226,72,297,350,213],cabl:71,consultar:[350,142,338,108,115,256,93,293,204,277,181,346,166],restringen:157,emparejamiento:[110,342],cabe:[238,335],setemailformatt:[238,335],trustresolv:219,"introspecci\u00f3n":[2,166],hello_servic:9,faltan:[254,204,319],itemclass:246,obtenemo:[],layer:[78,375,70],confirm:[207,74],mecanismo:[161,63,273,56,260,342,201,247,104,305,110,199,65,204,357,158,60,346,186,211,49],seteventdispatch:[46,2],"din\u00e1micament":[322,146,108,342,202,99,110,293,22,186,319],equipaj:1,"disposici\u00f3n":[26,222,304,84,202,305,109,2,293,204,182,346,186],inject:[302,248,221,234,327,165,66,278,366,271,212],maxvalid:185,creativa:346,carretera:331,fluida:[177,193],ocurrieron:[213,273],validatorextens:182,logs_dir:[264,153,382,176,16],tercer:[61,341,289,62,18,314,14,138,375,299,99,380,204,190,172,60,346,211],isabsolutepath:289,bb87a29949f3a1ee0559f8a57357487151281386:186,abstractfixtur:[326,23],fallback_local:60,generado:[213,108,146,57,19,15,118,180,99,241,243,158,331,135,167],generada:[144,179,338,138,322,256,166,99,241,70,277,375,90,135],"construcci\u00f3n":[91,84,20,362,99,2,46,161],lector:[326,313],queremo:[72,47,353],lejo:[1,161],textareatyp:287,comodidad:[222,341],definitiondecor:[238,62,335],phpcrodm:[70,339,108,349,140,111],volcando:[322,377,341,328,153,142],empresa:[11,260,118,341],trabajan:[4,259,273,147,14,340,315,189,121,351,277,241,117,367,319],liberado:[215,313,27],nullvalid:38,sensiodistributionbundl:[341,16],verbosidad:7,superveloz:14,aprendiendo:[84,63,270],strip:[347,273],combinarlo:[153,19],trabajar:[267,298,240,91,163,115,282,92,78,241,166,135,4,213,56,136,134,99,326,121,142,33,306,177,102,63,26,189,64,11,86,227,105,158,367,93,129,338,14,340,171,234,202,270,109,145,89,72,297,186],soapserv:9,evenento:152,validarlo:[293,112,12],some_cal:[],overwrit:110,"_demo_hello":[242,121,305],ipv4:112,ipv6:112,"saldr\u00e1":205,subsistema:[386,211],visualiza:222,pasando:[93,2,164,211,322,137,28,99,7,121,143,385,61,177,331,310,179,334,270,343,204,46,49],sucesivament:[22,176,2,8],bambalina:[22,178,166],value_requir:[61,7],"_session":[375,386,138],encadenando:[343,2,177],zambullida:[],sonatajquerybundl:[245,86,244],visitant:270,extend:[91,189,299,354,2,94,4,302,362,99,7,194,9,305,306,307,197,10,200,14,108,202,110,204,16,312,115,207,23,211,222,213,326,8,121,32,217,218,327,35,37,331,332,330,41,228,43,229,338,339,233,247,342,111,270,343,236,46,346,347,341,238,335,241,351,242,353,246,56,140,141,61,144,62,146,147,149,150,153,65,66,367,156,70,157,158,161,266,74,268,78,166,167,170,81,379,380,277,361,175,182,87,184,186,293,90],ejecutan:[253,319,341,338,368,251,2,293,204,46,23],onstoreord:[46,2,336],testbundl:[182,341],"pa\u00ed":[36,324,85,224,380,294,60],frecuent:341,embed:[327,326,305,141],baseproduct:277,empuj:[],ejecutar:[51,18,145,20,349,92,2,383,241,80,209,23,166,211,254,321,322,40,214,341,136,57,6,7,121,357,358,277,60,305,33,319,61,144,84,204,370,199,221,179,229,230,337,368,338,130,342,390,343,360,70,16,46,157,158,346,48,161],proveedor:[341,108,145,115,53,92,102,241,242,23,247,20,8,121,331,360,219,220,62,76,199,189,286,179,256,182,367,230,118,337,260,15,338,110,293,389,204,157,158,186],corren:145,cmf_next:308,implementarla:49,preocupart:[222,341,338,14,84,93,99,8,204,228,166,319],addtypeguess:182,protegerla:[],resultant:[193,222,331,288,342,363,319,204,345,164,188,49,143,161],generar:[175,222,19,76,267,241,346,242,166,135,167,321,322,96,56,331,57,99,7,243,172,9,204,360,61,313,383,146,189,199,221,226,341,182,305,258,367,230,118,338,14,108,342,90,389,343,110,70,312,158,297,186],fila:[61,34,109,136,166,286,99,7,344,22,277,186,167],"\u0436\u0435\u043d\u0438":[],mysql_select_db:161,examina:[186,166],cultur:346,ocurr:[384,363,149,99,60,166,33],prestado:[11,14],originalment:[368,102,60,186,25],fill:[194,327,87],antepon:175,again:[347,87],novedad:[20,289],api_url:180,involucra:[277,166],depth:[270,177,92,70,87],repent:161,sessionlisten:293,setlocal:60,un_nombr:103,"podr\u00eda":[266,222,51,298,142,18,314,105,75,77,93,94,2,383,326,22,117,23,386,166,146,375,322,193,331,96,341,136,366,268,139,140,30,98,8,121,32,251,60,252,327,319,175,102,35,283,255,199,84,38,286,153,330,226,41,228,182,161,367,128,389,346,369,67,202,131,343,293,204,46,157,73,297,186,48,49],generic_control:[110,218,347,367],architectur:[],visualizando:[171,64,152,346,211,49],resolut:[],verter:319,respuesta:[138,314,318,77,300,2,383,346,242,210,211,244,26,375,341,139,249,313,99,326,121,251,9,361,33,61,307,219,62,222,331,84,64,153,42,260,14,234,343,204,311,46,157,158,237,186,161],noderiv:27,sequenc:330,versionar:18,saltar:[],postcontrol:[230,211,354],ansi:[7,214],important:[0,18,91,20,92,2,383,346,6,166,23,247,136,28,138,140,362,99,7,121,32,60,305,61,176,144,62,222,312,331,84,157,286,363,41,310,231,337,288,313,201,375,202,131,235,109,343,293,16,46,71,161,297,186,49],recent:204,versionad:313,prudent:[22,364],concat:240,remota:33,sangrarlo:[363,288],implementaremo:221,admin_bundle_simplecms_page_delet:86,cocina:[],descript:[250,202,350,99,277,313,166],declarando:[220,392],remoto:[358,337,33,265],"agregar\u00e1":64,escogiendo:349,preupdat:[277,66,297,166],escap:[341,322,40,63,56,130,288,202,363,65,204,71,60,305,167],urlgeneratorinterfac:342,newli:[22,270],unset:[202,318],useincludepath:201,represent:[341,74,102,210,77],jsloader:213,forget:[245,339,213,81],recorrerlo:[343,142],breve:[93,346,281,14,145,31,99,121,341,158,313,161],moneda:[60,206],describir:[288,14,84,31,363,313],escondida:305,children:[245,62,96,163,141,301,153,343,193,142,182,218,244],getdefinit:[282,330,351,236,117,353],proporcionast:214,viajar:161,stringfunct:[303,148],sportmeetuptyp:327,solament:[382,341,148,286,228,161],"t\u00edpicament":[328,193,260,108,342,300,383,226],platafomra:161,multilangmenunod:[339,108,86,347],"cerrar\u00e1":[281,49],straightforward:[111,212],fals:[93,2,94,193,96,302,97,98,99,216,308,102,103,310,299,12,13,202,110,204,16,113,138,314,206,190,22,210,211,25,322,28,29,121,353,217,218,327,33,329,319,37,331,221,226,127,232,338,44,341,234,343,355,347,284,140,242,54,55,135,245,247,136,137,162,58,250,142,359,61,144,62,254,148,363,154,66,367,259,67,68,264,70,73,235,161,268,75,76,77,165,375,81,82,380,175,177,178,85,386,388,182,285,287,288,289,187,294,295,181,392,205,186],limpiar:[51,368,389,145,20,204,9,84],"dibujar\u00e1":[99,300,109],"traducci\u00f3n":[245,118,371,111,372,339,108,149,356,93,8,226,89,70,158,60,127,33,161],got:176,rescient:121,use_forward:58,"gu\u00eda":[18,1,315,349,93,207,242,23,24,135,167,26,322,323,247,331,326,121,305,101,273,198,255,199,86,367,338,14,341,342,202,313],"integraci\u00f3n":[168,184,302,338,342,20,356,77,301,153,343,284,70,348,166,49],instalarla:179,"aproximaci\u00f3n":108,"rat\u00f3n":121,liip_imagin:70,emailformattermanag:252,inscrito:[46,2],routerepositoryinterfac:312,"poblar\u00e1":199,"describi\u00f3":[153,149],further:[110,282,108,347,141],graba:22,procesarla:[319,311],abc:[318,341],streamhandl:176,default_head:70,abl:[39,273,87],invok:221,resolvetargetentitylisten:[148,200],forc:[347,115,92,33,277,218,166,135],abr:[144,341,389,322,153,241,353,49],initsubmodul:[213,101],exponen:22,sonatadoctrineormadminbundl:[],hhamon:247,sanear:297,issuer:376,"public":[0,375,91,93,354,2,94,3,95,4,193,302,362,99,7,194,195,9,305,101,10,307,102,199,105,200,299,12,376,14,112,202,204,16,312,313,257,138,115,190,319,208,164,117,23,24,72,211,222,321,322,54,213,324,119,36,326,8,121,32,306,122,218,327,39,35,123,37,331,221,38,126,330,40,334,71,42,336,43,229,128,338,44,233,247,234,131,45,343,333,236,46,346,380,341,50,238,335,349,249,350,241,351,352,242,217,228,141,353,56,136,248,140,134,250,251,60,143,61,144,62,361,146,231,255,149,64,153,210,155,66,366,259,207,252,67,263,70,130,157,158,73,161,266,74,268,373,163,269,78,79,80,270,271,254,169,170,81,166,98,344,277,278,175,176,383,84,323,86,256,182,183,184,185,291,390,187,391,293,392,297,186],exportar:6,"7fc64b4":33,autoexit:268,christi:34,variat:[],jmsdiextrabundleannotationinjectparam:[],component:[0,1,93,2,191,4,193,5,96,302,99,7,251,273,53,286,106,107,14,201,108,109,110,111,16,15,18,19,315,219,207,320,23,211,35,26,323,27,214,325,326,120,218,33,328,319,331,39,224,334,336,153,231,234,343,344,46,237,51,239,240,74,248,138,139,142,358,60,61,62,255,152,363,65,365,66,367,368,260,262,69,157,72,159,160,161,203,268,342,163,375,271,167,378,98,380,173,177,383,384,385,84,179,386,182,87,289,389,346,293,392,186],sophist:[1,87],vale:350,fragment_render:293,getflashbag:[242,386,222],free:87,getpublishedd:141,"garant\u00eda":129,dibujars:[],symfony_2_app:[],valu:[50,298,235,314,206,212,355,98,93,190,79,81,80,352,22,376,54,3,25,95,291,193,250,324,137,28,123,58,29,263,99,82,156,195,32,122,167,327,384,163,142,254,36,269,84,38,310,363,333,226,387,155,185,285,350,128,183,359,12,339,290,44,257,234,45,68,187,343,110,39,295,386,297,186,371],algoritmo:[177,102,18,331,247,58,126,311,242,210,186],expresar:[363,367,288,204,18],search:[99,216,88,339,217],comiencen:[231,0],post_id:[210,135],indetermin:240,preocupars:[84,222],mailer_password:[14,227,16],dicta:[144,282],una_clave_de_arriba:58,acmeuserbundl:[247,149,45],narrow:234,expresan:[363,219,288],configurationblock:180,document_manag:[338,308,70,388],experimentado:[255,166],ampliar:[35,268,14,150,386,94],demonstr:194,viewpost:156,json_data:244,"proces\u00e1ndolo":[60,311],"util\u00edzalo":[61,7],"reconocer\u00e1":140,"act\u00fa":[251,9,131],findmanybyurl:312,setparentdocu:[326,246,77],distinct:347,"detendr\u00e1":[61,64],regist:[266,74,239,349,207,94,271,212,248,249,141,32,251,217,9,327,10,176,199,149,389,201,108,270,110,293,70,47],two:[34,170,199,81,141,310,292,70,388,327,347,87],"corrigi\u00f3":[193,33],is_fil:297,apertura:49,desir:[],redirigirlo:[84,58],mozilla:84,routeproviderinterfac:[110,342,367],incluir:[341,0,20,351,166,298,322,56,134,99,326,8,32,277,60,100,305,33,84,125,386,285,231,200,338,14,15,342,109,343,389,204,71,73,346,235,161],particular:[18,20,299,319,241,23,271,167,168,193,248,240,166,217,60,327,282,146,331,40,129,260,14,202,45,109,204,157,49,161],"sangr\u00eda":[363,193,288,180],"selecci\u00f3n":[145,294,341,260,137,28,84,343,85,99,178,329,154,142,16,181,285,362,235,211],empero:8,dictat:[],guarda:[382,74,337,213,331,332,202,92,207,343,16,242,277,77,166,222],createproductact:[277,166],imprim:[61,177,383,222,84,305,7,204,172,60,166],hour:[177,235,285],dep:[124,213],sacan:99,dev:[268,328,92,281,241,21,242,23,353,322,213,341,326,121,217,306,176,144,383,273,255,104,199,124,64,349,179,87,184,337,368,260,14,338,204,16],remain:[],queryselectoral:240,del:[268,0,375,91,1,189,92,93,300,2,238,94,3,166,95,4,193,5,96,302,281,97,98,6,99,7,120,388,216,9,100,305,101,10,307,308,102,197,198,199,311,104,349,11,298,368,105,310,106,107,299,278,12,13,14,201,15,202,327,109,110,111,16,312,313,113,347,222,108,256,18,158,19,206,20,177,318,190,116,208,22,117,23,24,211,25,26,322,213,214,119,28,29,326,8,121,243,32,306,122,218,204,33,355,219,220,329,35,36,37,331,221,124,293,125,157,354,330,40,226,334,41,42,336,127,43,230,128,232,129,325,338,44,340,247,234,131,45,159,343,132,236,137,46,345,328,371,346,380,48,49,341,51,239,52,265,335,267,249,350,241,351,352,242,228,362,55,135,244,245,376,246,209,56,136,57,138,139,58,356,134,314,142,357,251,60,143,248,319,61,144,62,361,146,147,231,255,115,339,149,150,64,152,153,154,65,337,66,258,367,259,215,207,260,252,289,67,68,389,264,304,70,130,71,72,73,235,160,161,266,74,315,162,342,76,77,78,164,80,270,275,167,272,210,273,225,274,359,271,82,344,148,277,83,173,280,175,176,382,383,384,283,282,284,178,385,84,85,373,179,86,180,387,188,182,240,285,286,118,184,287,363,290,297,390,90,391,145,89,294,295,181,392,386,205,186,353],"simb\u00f3lico":[306,199,145,211,289],"int\u00e9ntalo":326,"simb\u00f3lica":[392,161],dictan:[110,167],traducen:99,almacenan:[77,242,210,166,213,137,28,98,82,99,326,222,199,386,92,285,337,130,186,70,235,49],almacenaj:[],compara:[231,0,331,225,190,346,166],document_tree_default:245,atend:[46,2],share:[199,58,110,345,188,313],compart:[238,338,331,335,380,105,158,16],explor:341,jackrabbit:[199,349,326,70,18],actualment:[284,18,1,349,80,209,24,3,211,96,136,9,218,103,180,182,367,108,342,202,70,48],getcredenti:62,strlen:[290,122,177,387],almacenar:[306,74,268,18,189,349,92,207,383,242,30,275,272,322,375,96,247,136,138,326,134,82,9,60,10,176,144,102,222,197,166,331,84,256,286,153,386,41,218,337,338,108,342,235,264,16,158,297,186,48],mapa:[219,330,389,20,139,249,286,346,161],importado:[332,346,341],secur:[369,332,162,259,53,93,102,221,242,209,23,3,383,25,26,5,247,136,119,139,58,304,98,194,293,100,327,360,219,220,62,197,149,84,124,125,225,256,66,366,87,27,184,215,338,341,159,344,69,204,16,157,392,186],programmat:[],"recibir\u00e1":[238,331,202,153,2,8,190,335,46,186],read_onli:[206,355,137,28,97,29,82,216,359,329,178,85,154,127,285,287,13,44,67,294,295,181,235,113],incalcul:331,allowmissingfield:254,acto:60,implantar:20,csv:[305,204],doctrine_extens:388,css:[10,341,322,213,56,260,15,77,343,8,204,305,242,71,158,240,159,244],regener:[],redirigir:[375,222,138,198,342,58,150,99,110,386,242,367,186,25],distribuir:[345,188,341,129,16],descomprimist:121,is_publish:135,attributebaginterfac:386,keepslav:148,sistema:[247,74,108,0,52,1,145,20,349,92,207,2,331,209,386,3,211,146,327,213,56,136,137,28,18,58,356,6,31,99,156,341,142,357,293,60,204,144,383,111,222,159,370,199,84,180,286,153,86,65,105,42,285,235,231,367,184,200,289,260,130,15,342,131,45,109,110,69,337,70,16,46,226,161,346,186,49],"correcci\u00f3n":[11,33],associ:[39,108,141,110,156,347],"\u00fatil":[51,384,18,314,91,145,282,318,165,2,62,300,346,22,117,375,55,211,167,193,284,331,56,136,119,268,3,338,6,99,7,380,121,142,251,60,305,242,61,368,144,34,222,283,198,166,102,84,150,126,153,364,226,388,42,127,392,219,152,288,363,260,313,201,247,342,202,131,187,383,293,204,46,72,297,186,190,49],spool:[284,180,134,16,90,48],encodedpassword:256,entityrepositori:[302,57,247,327,148,181,166],"sup\u00f3n":[266,330,147,99,314,366,362,153,300,305,277,252,166,167],setproperti:91,created_at:135,refiriendo:[96,14,30,248,271,280,167],vertiendo:[385,319,70],"guard\u00f3":49,stabil:[255,338,349,273],addsubscrib:[46,2,383],urlmatch:[231,383,0,205,342,367],gratament:49,"multiplicar\u00e1n":82,repiten:343,max_ag:[331,375,138],vendedor:260,hypertext:[260,84],migration_vers:241,autoload:[221,124,341,255,104,201,15,20,202,349,179,326,8,389,16,217,161,338,211,87],"har\u00e1":[219,322,383,28,139,202,77,45,297,186,161],buildviewbottomup:109,corregido:313,through:[327,1,226,326,87],"reclamaci\u00f3n":129,corregidi:70,"recuperaci\u00f3n":[388,18],addtag:[266,117,141,353,249,81,362,32,251,327,10,176,228,259,338,14,131,270,292,110,293,204,157,392],route_provider_service_id:367,corregida:[215,33],piscina:[149,186],"subm\u00f3dulo":[337,213],paa:20,rigen:331,"_csrf_token":58,controlador:[189,93,300,99,7,9,305,306,273,198,104,278,14,202,110,204,311,17,315,316,317,207,210,211,321,26,322,213,119,326,8,121,218,222,37,331,221,124,125,354,225,223,228,43,230,338,341,234,111,344,133,237,347,49,351,42,242,243,245,56,249,356,357,60,61,144,63,255,148,149,150,367,259,260,68,264,157,158,370,159,161,74,162,342,77,165,166,98,381,277,83,173,176,382,383,84,386,388,389,346,293,296,16,297,186],relev:281,late:327,pend:156,comenzast:338,customizeform:327,configuramo:[],lifecyclecallback:166,blog_hom:354,ifinarrai:193,good:[217,347],notario:[],resaltar:[14,180,131,247],fatalerrorexcept:239,check_path:[242,58,186],timestamp:[267,338,137,28,189,168,166,285,235],pollut:[],pag:242,"opci\u00f3n":[0,189,93,190,40,5,97,98,99,7,198,310,105,12,13,14,202,109,204,16,113,205,314,206,118,355,207,329,208,164,376,23,25,322,214,28,29,216,122,218,33,34,319,123,331,226,228,127,230,231,232,44,234,45,343,344,236,137,346,48,49,349,350,352,243,57,58,250,142,251,60,143,248,61,62,254,128,148,64,153,154,287,66,367,259,369,67,68,389,70,130,235,266,74,162,373,163,76,22,79,80,165,271,210,359,82,380,293,280,175,178,85,179,387,388,182,285,183,185,289,290,291,186,391,145,294,295,181,90],excepcion:[51,388,268,289,221,139,345,350,383,258,204,311,251,188,66,158,211],impar:204,default_repository_class:148,conducent:341,completar:383,potenciadores:[],"antepondr\u00e1":[],aplicars:[188,345],userinterfac:[93,74,102,186,247],easili:[322,342,234,39,261,141,327,347,87],token:[176,219,62,232,196,197,136,370,189,256,194,386,157,209,54,127,392,211,361],habitu:[331,157,98,386,326],gender:[178,39,362,93,190,22],visitar:[98,145],ciertament:[14,60,204,99],myconstraintvalid:32,acumulado:[136,220],textarea_error:99,idea:[0,18,342,20,328,190,166,322,247,98,99,7,8,121,217,9,60,61,144,383,273,255,84,153,334,231,338,14,234,109,389,111,370,186,161],phpengin:65,role_user_method:186,connect:[193,162,136,148,115,58,131,349,78,338,326,70,388,66],apply_to:[71,40,213],dext:[148,388],orient:221,desactivala:[],persistida:202,setfrom:[43,64,134],weakencod:256,symfony_cmf_search:348,"transformaci\u00f3n":[228,383],utf8:[148,115,349,30,78,326,16,277,166,135],print:[61,177,240,7,142,358],verdict:[],"quz\u00e1":367,inferir:[67,206,355,97,29,99,82,216,359,329,178,85,154,127,287,13,44,342,294,295,181,113],adecuado:[62,5,18,137,1,84,166,299,99,211,32,365,228,384,346,28,363,334],menu_basepath:[108,96],adecuada:[341,177,62,204,84,91,331,108,98,142,242,60,33],"cl\u00e1sica":[323,341,260,134,110,367],escogist:349,term:[74,339,11,207,110,142,367],role1:209,navegando:343,database_path:273,my_logging_pointcut:221,getcommand:51,omita:104,omit:[350,254,341,338,148,115,327,93,99,380,42,166,87],personaldata:254,perman:[339,198],escenario:[93,332,341,136,108,78,293],getelementsbytagnam:142,chgrp:289,hubiera:[175,343,98,331,142],get_class:[102,268,247,32,94,166],cada:[0,91,1,92,93,2,94,193,362,99,7,215,10,115,197,104,11,277,310,106,299,14,108,202,109,110,204,16,313,138,19,315,20,177,190,281,208,22,117,23,211,222,26,322,213,214,28,31,326,8,121,243,306,33,219,328,329,35,36,331,125,40,226,228,127,231,232,338,130,247,234,111,131,45,343,225,249,236,46,346,49,341,349,140,350,241,135,245,56,136,205,139,58,142,251,60,319,61,144,62,254,148,149,180,153,364,154,337,367,259,368,260,304,70,157,158,161,266,353,342,77,78,80,375,209,167,168,359,166,98,380,172,361,175,176,382,383,384,84,85,386,256,286,88,288,363,389,390,391,294,295,186],advanceduserinterfac:247,done:[245,233,234,141,358,327],dond:[266,209,384,166,268,145,328,299,2,383,21,221,346,22,117,6,3,135,167,245,341,322,23,149,136,119,140,362,99,7,8,121,142,178,54,277,60,252,204,33,282,62,146,134,148,331,84,124,180,349,363,330,259,226,105,228,366,323,367,128,218,260,14,247,312,202,357,338,109,110,70,16,46,71,297,161,47,186,49],stabl:[],setrespons:[46,251,2,62,211],involuntario:204,desactivast:268,magnolia_us:70,"implantaci\u00f3n":20,least:[123,373,79,70,190,122],abbr_method:344,sustancial:129,statement:[217,70],debugbundl:10,razon:[61,350,200,319,368,331,93,99,7,364,211,204,60,186,33,49],"coincidir\u00eda":346,descargast:[145,349],pare:[158,60,142],sensiolab:11,para:[268,0,375,91,1,189,92,93,300,2,238,94,3,191,166,4,193,5,96,302,303,281,97,98,6,99,7,215,388,216,9,100,305,101,10,307,308,102,197,198,199,311,104,53,11,298,368,222,105,310,106,107,299,278,12,13,14,201,15,202,327,109,110,111,16,312,313,112,113,200,347,17,108,349,256,18,158,19,206,20,177,318,190,116,329,21,208,22,117,23,24,211,25,321,26,322,323,27,214,119,28,123,163,29,30,31,326,8,121,243,32,306,122,218,204,33,355,219,220,34,35,254,36,37,124,331,221,38,293,125,157,126,354,330,40,226,227,41,286,42,336,337,127,43,229,230,128,232,129,287,338,44,247,234,131,45,159,343,132,249,133,137,46,345,328,47,380,48,49,341,50,51,239,251,240,348,335,267,140,350,241,351,352,242,228,362,135,244,245,118,246,209,56,136,57,138,139,58,356,134,301,250,334,59,142,357,358,60,143,248,360,319,61,369,144,62,361,146,147,231,255,115,339,149,150,64,317,152,153,364,154,65,212,185,66,366,367,259,207,260,252,289,67,262,68,389,156,69,304,70,130,71,72,73,370,235,161,266,74,315,162,342,75,76,376,77,78,164,346,79,80,165,270,275,269,167,272,168,210,273,225,171,359,314,384,271,332,82,344,257,148,172,83,280,175,176,382,383,236,283,282,284,178,385,84,224,85,373,179,86,180,387,188,182,285,213,277,183,184,88,288,363,290,297,291,264,390,90,377,391,145,89,294,295,181,392,386,205,186,353],paro:[],pari:22,selector:[245,266,240,137,28,15,343,142,159,244],part:[0,1,189,92,93,2,193,362,99,7,9,305,102,273,105,107,14,202,109,110,204,16,313,18,315,20,319,117,210,211,222,26,322,323,214,28,326,8,121,33,329,35,331,226,71,336,231,337,129,130,56,342,343,344,346,48,49,341,335,349,350,351,242,55,353,245,247,136,138,139,58,356,60,61,144,62,149,152,153,364,154,368,260,261,156,304,157,158,161,74,268,77,78,80,375,166,167,81,98,212,219,383,384,283,178,84,85,386,87,363,389,293,347,294,181,186],webprofilerbundl:[10,383,341,293,16,211],extiend:[268,219,77,2,166,167,321,96,247,205,362,99,121,177,62,37,150,224,363,288,108,342,343,293,204,46,49],"iteraci\u00f3n":60,"v\u00eda":[17,239,0,138,163,219,165,2,383,21,22,384,375,271,191,244,27,341,248,240,249,99,7,300,142,358,60,327,242,61,177,145,146,273,231,331,152,363,225,86,65,32,224,289,260,14,201,338,69,16,46,346,186],encaja:328,apetezca:102,"_em":[],exposur:215,publishworkflowcheck:308,almohadilla:[363,288],setmaxresult:166,getconfigtreebuild:[153,193],reorder_url:245,imaginario:204,"versi\u00f3n":[145,20,328,318,92,79,21,3,384,213,214,31,99,326,8,121,60,331,33,177,319,273,370,199,349,11,363,226,228,183,185,289,338,313,291,15,343,344,293,337,241,158,47,161],ejecutarla:314,sandbox_magnolia:[70,41],"guardar\u00e1":[74,48,362],label_attr:[109,167],interactivo:[230,321,368,57,118,69,243],declara:[221,350,99,110,111,165],interactiva:[321,214],markup:260,ejecutarlo:[322,383,326,214],pedist:[],confirma:[326,33],necesit:[145,20,93,22,94,23,166,222,96,6,99,142,357,277,327,236,146,255,362,221,149,153,330,228,367,14,15,202,293,204,311,73,186],favicon:341,acmedebug:[],mod_rewrit:[341,84,121,275,205],analizando:[153,356,211,240],"program\u00e1ticament":[199,241],doctrinephpcradminbundl:86,jpegoptim:[130,377],setvari:[307,331,375,138],gobiernan:121,built:[10,213,1,141,326,218],nombre_hidratant:[],blanco:[50,294,269,350,329,241,208,355,28,97,99,7,216,172,33,61,62,226,254,273,178,38,85,153,154,127,287,13,313,257,45,68,293,204,181,297,113],greetingcardmanag:[252,238,234,335],blanca:[272,107],infraestructura:[228,99,144,65,202],click:[22,339,343,202,244],route_repository_servic:367,build:[4,62,330,292,339,1,180,141,153,326,70,277,327,353],estafador:[],admin_dashboard_without_local:339,role_:[219,186],consisten:[4,353],transaccion:[221,70],permanecen:8,distribut:[350,322],myowndatabaseplatformservic:148,distribuy:[350,71],pregunt:[],previou:[322,39,347,87],defaultencod:256,mediant:[102,338,20,166,8,204,60,186],most:[339,39,58,81,141,110,190,217,313,347],getuploadrootdir:297,charl:34,mediano:30,cifra:82,geniecillo:331,configurarla:326,findpk:277,perfilar:211,desplegarla:144,reproducir:[216,294,206,355,77,300,383,22,167,213,56,137,28,97,29,362,31,99,82,121,172,218,305,329,222,178,331,84,85,154,285,359,287,13,44,341,67,202,235,68,109,204,295,181,161,346,186,113],diseccionemo:121,phpmethod:180,contamo:18,"garantizar\u00e1":218,forzar:[189,22,190,5,96,341,218,242,220,178,331,153,269,127,367,83,214,257,369,45,343,110,158,346,186],roughli:[],contentar:104,avanza:364,carefulli:273,mailer_transport:[227,16],elaborar:99,particularli:[],fino:213,puntual:341,usando:[0,91,1,92,93,354,2,191,193,96,98,6,99,7,120,9,305,307,273,159,311,349,11,310,106,200,14,201,108,202,204,16,312,113,17,15,18,19,206,20,282,320,21,39,164,117,23,211,319,26,322,213,214,28,31,326,8,243,32,219,220,34,222,254,331,221,124,224,330,40,226,227,41,42,336,230,231,337,338,130,340,247,234,45,343,344,133,137,46,386,328,346,48,49,341,51,239,240,53,241,228,242,362,135,244,245,56,136,57,138,58,356,134,334,142,357,358,60,252,248,61,369,144,62,146,166,316,149,180,152,153,154,65,365,366,367,259,368,260,289,375,69,70,157,72,235,160,251,266,267,342,163,77,22,374,80,165,270,209,63,272,210,171,274,359,378,271,82,293,167,280,176,177,383,384,178,385,84,85,179,86,64,388,285,286,118,363,377,145,347,294,295,181,297,186,353],find:[166,211,96,247,7,141,326,277,327,61,281,35,86,217,367,338,339,108,202,110,70,347,161],fing:142,manipularla:342,firewal:[219,62,247,332,139,58,256,98,194,293,242,100,186,383,25],"an\u00f3nimament":[98,219],createsearchbynamequerybuild:[],mypassword:[161,30],codifica:[102,375,186],prependnormtransform:228,dependen:[109,184,337,353,153],personalizarlo:[167,337,186,92],escond:[],admin_bundle_menu_menunode_cr:86,inacces:145,capifoni:20,sizenotdetectedmessag:105,plataforma:[138,1,93,242,319,22,117,375,211,222,26,247,268,31,99,8,121,358,361,204,360,328,383,35,37,178,199,84,11,153,226,106,184,368,14,341,342,202,343,344,111,16,157,392,47,161],"introducci\u00f3n":[17,317,2,165,209,166,191,247,248,271,326,120,121,218,360,220,331,53,365,336,367,259,339,110,69,46,186],mein:218,sql2:70,express:[209,197,162],luka:342,ayund:[],"tem\u00e1tica":26,setbodi:[9,218,43,64,134],theft:[],"documentaci\u00f3n":[17,108,372,367,1,206,273,349,93,207,2,319,241,346,24,166,135,222,26,168,27,96,341,331,359,345,356,134,31,99,326,344,121,211,277,60,204,33,174,313,177,62,151,111,197,255,148,199,339,293,180,11,153,364,65,105,286,101,350,213,78,118,259,129,368,260,14,15,342,305,338,343,110,145,89,70,295,46,188,158,297,186,347,49],expresa:129,restart:343,target:[200,240,166,289,202,124,58,141,110,70,242,60,297,186],preocup:[322,341,136,343,311,94,278,166,161],mycustomtyp:148,aprendamo:[],node_path:217,common:[281,327,388,247,338,148,201,221,58,131,202,345,326,215,335,70,228,188,23,313,166],greater_than:[],"japon\u00e9":89,radiotyp:29,esencial:341,altura:105,settoken:[219,62,256],hacerl:[298,305],containerawareinterfac:[158,23,326,383,302],individual:[144,40,254,153,84,150,310,99,204,186,167],hacers:48,"hac\u00eda":[277,166],hacert:297,dirigen:222,"elecci\u00f3n":[175,305,271,88,18,136,91,341,342,30,99,2,8,16,46,181,109,60,248],assertcount:[343,229],someth:[175,239,222,339,233,163,81,141,310,172,327,33],"_fragment":[331,226,204],debat:[],"alcanz\u00f3":[313,202],cuidadosament:[31,331,108,315],smallest:271,"estar\u00e1":[62,337,35,284,331,259,202,6,11,8,22,92,346,166,367],experi:70,filtersendreturnvalu:390,permitiendo:[175,314,252,84,202,11,46,2,204,22,100,186,280,161],altern:[233,375,197,81,87],descargador:[337,92],leido:108,appreci:[],admin_bundle_routingextra_route_edit:86,complement:347,aligerar:[331,262],altera:[188,345],invocando:[225,383,161],cachedir:[66,62,293],user_block:339,my_chain_provid:58,popul:327,audienc:[],subtitl:343,consideremo:[46,2],necesario:[91,2,193,6,99,7,9,199,310,106,14,108,202,204,16,312,18,315,115,219,318,207,21,164,23,211,330,323,213,28,31,326,121,33,329,319,37,331,124,226,231,325,338,341,111,270,343,344,46,47,49,349,241,242,135,247,137,357,60,143,61,206,255,150,256,153,154,359,70,370,235,161,74,268,77,78,165,45,166,167,82,277,278,177,84,85,179,386,388,285,288,363,389,346,186,145,294,295,181,297,90],"encargar\u00e1":[281,268],necesaria:[0,91,145,118,92,93,2,383,388,166,243,341,57,30,99,32,277,252,305,219,62,384,273,255,148,286,363,226,65,181,230,231,337,288,260,14,202,338,293,46,157,297,186],esperando:11,etiquetarlo:[10,392,293,204],tempor:[20,222],endjavascript:[71,322,40],invalidar:[19,331,318],"admininistraci\u00f3n":110,ocurra:[382,186,131,222],sortbynam:177,reescribiendo:213,"defini\u00f3":66,simpli:[339,141,110,70,327,87],point:[170,339,326,111,217,347],instanti:[350,339,347,170,280],mayoritariament:349,acabamo:[207,204],minimizada:[71,213],"9764731e5f7fb944de5fd8efad4949b995b72a3c":247,param:[10,266,268,346,221,350,344,236,312,228,297,327],getcategori:[152,99,166,277],your_firewall_nam:100,xkcd:84,backend:[326,108,273,70,349],helloadminact:242,"estabilizaci\u00f3n":11,"incluir\u00e1":[176,281,331,15,202,207,73],secret:[177,62,341,14,16,98,226,148,23],identificando:[375,186,138],nativeproxi:49,round_halfdown:359,demasiada:[144,361,331,16],"exportaci\u00f3n":[247,349,18],error_handl:14,convert:[37,210,239,135],demasiado:[128,382,214,322,84,183,11,358,391,364,79,387,105,190,305,211],plegar:[],understand:[281,273,189,261,111,339,275,347,87],"\u00e9sta":[282,328],instalado:[145,315,213,273,338,130,331,15,118,343,166,179,326,121,243,142,370,186,33],comprimir:331,completado:364,repetit:[],prependextensionconfig:[175,319],repetir:[175,193,14,221,71,60,166],"completar\u00e1":62,"postautorizaci\u00f3n":[286,220],customhandl:49,regla:[369,18,206,77,93,116,80,210,275,211,193,295,136,119,28,162,31,99,82,121,60,297,313,331,84,11,226,365,92,285,350,367,310,359,14,341,235,343,137,158,205,186,161],default_security_target:25,getentitymanag:[228,74,166,131],fue:[266,138,314,269,2,22,375,330,193,139,99,8,121,222,331,84,286,226,228,366,11,200,342,110,204,47,186],sobr:[0,91,1,92,93,300,2,284,190,4,193,96,303,99,7,216,305,115,102,199,11,310,14,108,202,109,110,204,16,312,313,222,15,18,145,20,207,319,22,376,210,211,25,322,213,28,326,215,121,218,33,35,37,331,311,330,226,71,43,231,337,338,56,234,111,343,344,248,46,345,346,347,49,341,51,349,241,351,135,244,245,247,136,137,138,139,58,142,60,252,61,144,62,255,148,150,153,364,367,259,260,70,157,161,266,74,315,342,75,78,375,271,167,166,98,277,361,176,177,383,384,84,286,184,293,295,188,297,186],throw_except:141,anonym:[58,186],declarar:[61,7,392,111,367],password1:186,password2:186,appcach:[144,205,331,87],sportbundl:327,busca:[0,177,117,210,166,211,167,245,213,99,7,353,277,60,61,144,383,148,311,231,338,14,201,109,89,204,16,346,186],userbundl:[36,136,247,149,45,324,326,3,195,208,155,217,186],getheadshot:105,checkdnsrr:12,convirtiendo:72,my_rout:[110,367],instalador:[179,145],cualesqui:[],passwordchang:3,"instant\u00e1neo":211,ruta:[0,1,189,299,300,298,40,5,96,6,99,9,305,306,308,197,198,106,14,201,15,110,204,16,312,138,19,145,319,23,24,211,25,322,323,213,326,8,121,218,33,220,332,222,37,311,224,354,226,230,231,338,130,341,342,111,343,344,346,48,284,58,241,351,242,243,245,56,205,249,142,60,144,63,147,128,148,149,150,180,366,367,260,369,70,339,158,73,159,160,266,375,166,210,277,83,177,383,384,283,84,179,86,388,184,289,186,293,181,297,90],getlin:268,setgroupnam:23,basta:[56,136,20,357,149,125,93,334,204,311],advanced_extra:81,admin_bundle_menu_menunode_delet:86,viven:[266,147,341,145,109,8,204,311,167],joincolumn:[166,135],content_nam:141,scopecrossinginjectionexcept:66,suficientement:[337,384,363,338,14,15,318,166,11,99,16,186,161],venir:[158,186,341],moment:[327,141],"_route_param":308,second_str:303,"seguir\u00e1":[99,238,335],exactmessag:[290,122,387,373],onkernelrespons:[46,157,2,211],descodificada:72,yesterdai:177,entra:[136,186],containerawareeventdispatch:336,task:[61,35,202,99,7,228],unanim:[219,392],entri:[204,273,44,199,58,110,70,327,347],spent:[],acmenuevobundl:[],adema:91,"liberar\u00e1":11,endfor:[308,222,339,202,362,93,109,204,22,167,305,242,161],convenient:[10,222,314,84,149,152,389,343,121,334,242,386,278,297,49],twig_filter_method:[],echa:[341,138,84,293,362,121,46,241,158,375,346],explan:[313,349],preferredlanguag:195,verificar:[310,185,331,123,290,91,291,171,189,186,93,250,343,387,373,190,122,392,43,33,251],imponen:231,"sustituci\u00f3n":[238,200,149,193,351,335,60],alternativo:[199,5,180,213],nuestra:[343,222],verifican:343,"ll\u00e9vame":121,confunda:186,heart:[],"ap\u00e9ndic":204,alternativa:[18,199,84,64,226,70,209,47,331,353],nuestro:[259,200,341,136,14,325,140,312,228],constraintviol:93,superficial:8,authentication_error:186,"ajust\u00f3":175,diveintohtml5:216,"inici\u00f3":[152,375,186,138],respeta:[148,342,277],reemplazando:[312,153,311],administrativo:204,appli:[254,313,342,141,326,71,210,45,3],administrativa:318,with_second:[235,285],settargetpath:332,app:[92,93,354,40,303,6,99,7,9,100,101,306,308,102,197,198,199,104,106,299,35,200,14,201,311,202,110,204,16,312,332,205,314,145,20,317,23,24,25,26,322,213,214,30,326,8,121,243,217,218,327,328,34,222,331,221,124,226,227,71,230,337,338,130,233,247,343,344,371,346,48,341,52,348,349,249,241,351,242,362,135,245,56,136,57,268,58,134,251,60,360,61,144,147,255,115,149,64,153,367,259,368,260,156,304,70,339,157,158,370,161,162,77,78,166,167,169,273,274,81,98,277,212,175,176,382,283,84,86,388,87,118,184,389,186,292,293,347,392,90],bin:[61,236,40,213,103,273,124,130,67,293,341,7,121,217,16,71,214],bio:254,varchar:[277,135,30],liipdoctrinecachebundl:199,formtypecsrfextens:293,type_after_remov:319,costoso:278,emparej:186,incrustado:22,dumpexcept:[363,384],"envi\u00f3":43,title_typ:[],newact:[99,225,202,327],establecen:[329,178,202,85,154,294,181],bit:[136,71,286,360,87],database_password2:115,incrustada:[305,211,56],afrontar:110,field_row:99,"coloc\u00e1ndola":204,vincular:[99,380,13],httponli:58,vinculan:[287,13,355,97,216,127,113],princip:[238,0,294,206,349,350,319,253,329,346,22,166,211,167,193,96,56,355,97,383,58,29,362,82,215,216,277,60,305,145,222,178,331,295,150,180,85,11,153,40,154,335,310,392,231,359,287,13,179,338,44,341,67,270,204,16,181,158,161,47,186,113],searchindexer2:131,imprimir:[61,108,84,93,99,7,383,204,172,360],produciendo:99,incluirlo:[109,108,342,96],autoload_namespac:389,asignada:[310,74,254,354,148,108,93,241,346,166,135],subrepticiament:204,often:[182,261,327],encuentren:[71,8],asignado:[338,148,186,99,98,388,166],back:[239,70,339,221,261,58,343,111,327,347],"autor\u00eda":[],opcod:370,slugifi:141,bastant:[115,166,384,322,193,341,134,32,277,60,382,383,222,331,84,150,363,182,43,338,14,389,204,16,157,158,186],publica:215,httpkernelinterfac:[251,383,249,211],sonatadoctrinephpcradminbundl:[96,1,108,301,110,86,111,347,367],eliminan:130,null_on_invalid_refer:234,config_benchmark:144,mostrar:[61,74,51,235,206,349,93,207,55,243,214,56,137,28,205,326,166,99,7,121,251,277,60,10,144,34,346,180,266,179,364,182,285,218,338,14,45,109,204,311,181,297,186,161],transformationfailedexcept:228,mailera:234,per:[339,70],larg:128,creada:[96,14,270,99,2,135,46,117,297,33],inicio:[189,98,383,25,26,139,58,326,381,100,220,62,256,152,226,338,69,70,16,386,346,186],eliminando:[338,130,104,153,277,166],inicia:[299,383,337,331,341,255,14,199,349,313,152,99,98,86,242,293,386,24,186,101,161],ajusta:[242,213,96,331,28,153,386,70,22,277,313,166,211,319],contacto:[145,222,84,77,93,204,346],reproduc:[206,77,22,166,167,322,56,355,28,97,99,82,121,216,359,383,222,178,331,363,226,287,288,341,202,109,204,295,113,186,161],eliminar:[175,306,184,337,289,338,331,84,189,202,356,92,286,389,145,142,22,277,297,166,243],rdfmapper:213,impon:[99,84,0],browsabl:[],personalizdo:[],property_path:[74,232,99,76,207,127],ubicada:[121,222,243,311],considerara:[],calcular:[10,183,337,290,331,67,79,387,122,186],simplecm:[1,218,347],unport:[188,313,27,345],olvid:[118,213,166,67,84,104,343,45,350,109,20,110,134,297,43,243,367],editablestat:[110,367],"matem\u00e1tico":60,denormalizerinterfac:293,wsdl:9,frecuentement:[60,337,204,270],impos:[175,18,199,22,228,60,161],mejorado:[331,161],usa:[93,2,193,96,362,99,9,305,102,197,199,286,277,299,14,108,202,109,110,204,312,138,145,115,177,319,209,23,211,25,322,213,31,326,121,218,33,328,34,222,331,124,126,226,41,336,43,128,338,341,234,343,132,236,46,47,48,284,52,349,350,241,242,56,58,142,358,60,315,148,180,317,152,153,364,367,67,264,70,158,161,266,342,163,77,79,375,166,167,272,210,82,344,172,175,282,383,84,179,386,387,388,182,183,185,389,346,291,293,297,186],constraint:[266,50,373,208,269,74,93,207,79,80,352,190,376,54,3,135,95,291,250,324,123,30,99,195,32,122,60,254,36,39,38,349,126,333,387,105,155,185,66,263,127,128,183,12,290,112,45,187,391,293,70,297,257],gestor:[267,238,388,189,53,210,166,23,213,96,326,148,60,175,219,62,330,115,256,349,286,335,228,338,14,131,45,110,70,181],justo:[51,91,349,166,213,99,277,278,175,383,319,283,157,286,188,367,342,202,390,293,204,345,73,297],reinicio:284,file_link_format:226,interacciona:286,"32bit":[137,28],setsalt:23,concuerden:186,"entregar\u00e1":[284,222],array_kei:182,estructurado:[386,341,121,383,18],postgenerateschema:66,magnu:342,enhorabuena:[62,341,338,84,121,346],getsetmethodnorm:[292,72],intl_get_error_cod:224,cabo:[74,18,20,318,241,22,166,341,99,8,142,61,383,32,178,84,153,14,110,293,297,186],inclus:[60,125],limitar:[266,287,13,18,355,97,216,54,186,48,113],acmeent:32,incluy:[315,145,273,349,93,242,166,244,322,213,341,249,6,99,326,344,121,32,60,101,10,144,62,204,147,331,104,125,224,363,226,182,230,200,260,108,342,156,33,111,16,72,49,161],megabyt:[128,177],parec:[238,247,178,206,335,30,93,99,204,295,22,182,359,211],robusto:[363,163,166,384],default_target_path:[58,25],lleguen:331,forward:[272,281,222,140,150,343,156,242],robusta:[37,153,84,383],poder:[18,20,93,2,241,346,23,166,211,167,213,341,268,326,134,98,172,305,33,319,175,35,331,125,277,43,338,14,108,202,110,293,204,46,73,297,186],format_norm:364,catchexcept:268,getto:43,"_failure_path":58,vivan:[149,341],longvarchar:277,varnishadm:197,redirectrouteinterfac:[110,342,367],limpieza:[51,20],translat:[168,84,35,166,339,108,189,267,141,344,226,351,111,16,293,158,60,107,347,167],loadblockwithphpcrpar:326,cram:[284,134],es_mx:60,"interpretaci\u00f3n":18,codeblock:313,"detenci\u00f3n":[],concaten:350,bjornskov:342,"problem\u00e1tico":91,newwidget:22,move_url:245,birthdaytyp:137,addtask:202,agrupamiento:359,utiliz:[136,277,166],constant:[219,359,319,385,84,186,383,295,6,275,212],phpcrodmbrows:86,iterando:364,addtransport:[117,353],passworddigest:62,utilic:[266,205,20,92,93,351,22,167,322,5,247,362,99,215,60,219,62,148,331,84,149,153,366,337,288,363,389,187,204,186,161],desordenada:167,muestra:[51,314,19,115,349,77,93,190,2,326,165,23,166,211,25,95,193,214,187,324,325,82,99,7,195,54,242,319,175,102,222,36,37,148,199,104,180,85,11,153,333,86,388,155,232,127,128,259,12,338,346,112,247,202,109,364,204,311,46,386,161,297,186,49],"200k":128,remuev:[99,331],producir:[40,226,218,204],"recorrer\u00e1":8,significativo:[136,222,111],cambio:[238,298,372,18,145,282,92,2,241,346,166,167,322,341,99,326,8,121,32,33,313,144,319,331,149,64,152,153,386,65,335,182,107,286,337,338,14,202,389,343,89,204,46,392,297,48],buscada:[231,84,0],significativa:8,deseri:[292,72],tubo:[],containerawarehttpkernel:234,llamando:[61,176,383,138,314,343,363,7,320,228,172,117,375,364,166,353],despacharlo:2,representan:[383,341,84,186,286,98,32,285,167],representar:[193,99,338,178,18,109,326,121,60,166],datatransformerinterfac:228,"coraz\u00f3n":[383,204,111],manten:[18,20,2,253,190,166,322,341,136,134,8,121,252,306,62,319,84,200,14,204,16,46,49,237,161],virtualhost:[169,6],autortyp:93,"b\u00e1sica":[341,267,315,138,75,20,349,92,93,242,320,346,190,375,166,211,222,247,274,137,28,205,139,98,31,7,8,243,277,60,297,101,61,62,35,273,37,199,331,153,182,200,289,338,14,108,235,69,111,157,158,47,186,161],"6683c2bfd90c0426088402930cadd0f8":247,sustituirs:84,consoleterminateev:51,"b\u00e1sico":[152,341,50,0,375,18,342,208,269,190,79,352,22,376,23,3,243,222,95,291,181,250,136,231,28,97,139,271,263,99,326,195,373,54,122,60,305,242,176,204,254,36,166,385,84,38,126,153,333,257,387,105,155,185,107,235,128,183,12,290,14,112,324,67,123,45,187,391,111,248,157,353,297,186,49],pluggabl:[],queri:[247,222,327,70,138,338,148,84,375,308,45,344,121,142,277,242,157,361,166,347,161],"normalizaci\u00f3n":[153,193,365],assertlessthan:361,reversetransform:228,inyectamo:[248,271],computeetag:331,abreviar:186,privat:[266,138,163,93,2,102,80,117,23,271,135,330,375,170,247,248,268,81,362,194,353,9,278,252,327,176,62,254,331,221,256,228,66,366,229,350,14,302,339,157,72,297,380],sensit:239,elsewher:[177,343,142,212],getchildren:163,documentmenuitem:[],proxy_namespac:[148,70,388],sensio:[321,307,323,56,37,341,180,354,8,121,16,242,42,210,297,305],"inyectar\u00e1":[165,23],deseado:[172,62,49],fatal:[326,239],masculino:93,ofici:[239,0,138,1,163,349,78,2,383,241,375,271,191,248,240,166,31,7,215,121,142,358,293,305,61,177,145,384,273,231,148,199,152,363,65,367,224,337,289,201,344,69,89,70,16,46,72,313],ingredient:341,loadvalidationmetadata:324,disclos:239,accedan:186,ispasswordvalid:256,envolverlo:[166,211],previament:286,"interacci\u00f3n":[328,253,196,341,385,84,189,343,383],"contraposici\u00f3n":[329,178,85,154,294,181],envolverla:22,rede:260,codecoverageignoreend:268,notabl:[99,278,8,47,166],comunicart:[126,331],comunicars:[78,331,84],controllermapp:[],localizado:135,"petici\u00f3n":[341,0,332,138,342,315,189,144,249,319,383,346,242,209,210,386,166,211,25,375,213,96,247,139,58,99,276,121,142,251,9,60,100,305,33,270,176,382,62,361,222,198,331,84,104,64,286,312,298,226,256,106,43,258,367,219,231,260,14,340,173,234,90,330,389,343,110,293,204,16,46,157,73,237,186,48,161],jmsserial:72,refer:[238,91,335,349,164,261,117,141,271,135,212,26,322,341,248,30,304,344,353,217,9,143,327,176,282,62,199,339,153,277,228,259,14,233,108,234,131,343,110,293,70,252,392,347],integra:[213,168,147,197,338,202,99,343,121,311,367,161],novato:331,fortun:327,redondear:[359,206,295],symfony_standard_vendors_2:145,consoleforexceptionev:51,cargado:[128,367,315,142,273,247,19,108,77,153,8,293,70,181,336,23,297,213],cron:20,priorizar:18,redondean:82,isanonym:[209,225],arquitectura:[26,383,341,260,14,381,318,8,16,305,161],maxag:[242,300,331,307],ciclo:[152,267,51,222,341,338,331,20,11,383,33,277,297,166,135],chicago:329,acceso:[61,222,369,18,145,189,53,98,2,62,242,209,375,3,211,25,193,213,247,136,119,383,162,139,58,166,99,7,204,319,10,220,102,35,331,221,149,150,286,330,225,227,200,392,219,175,289,338,14,201,341,111,131,343,344,293,70,46,71,158,161,186,49],access:[327,144,369,159,378,163,261,58,141,392,226,322,209,186,87],sobrescriban:193,form_row:[109,202,310,99,344,22,167],"podr\u00e1n":[],wssefactori:62,custom_constraint:[],porttyp:9,deduc:[206,287,13,295,216,44,97,67,355,29,85,99,82,329,154,294,178,22,181,359,113],nacho:[121,129],setobject:9,construyendo:[328,341,338,385,20,166,99,7,320,236,277,297,159],hacerlo:[238,268,1,77,93,166,167,322,247,345,140,99,98,33,144,62,222,199,84,153,335,42,92,350,129,338,346,202,110,360,188,297,186,347,371],acmeblogbundl:[230,274,57,84,118,93,243,204,165,158,346,135,161],vertir:[],recuperaremo:[],closur:[231,170,39,190,2,16,46,181,280,0],sino:[322,62,319,136,331,20,166,182,99,193,204,305,165,117,367,158,48,212],internament:[284,206,177,93,2,241,242,384,167,247,136,249,29,49,8,142,359,144,383,222,84,286,153,386,363,389,14,341,234,110,293,204,295,73,186,161],rescatar:161,extremo:18,sonataadmin:[110,347],backoffic:347,"0xc":[363,288],vertic:[363,60,288],sinc:[306,177,170,331,58,194,322,3,254],task_tags___name___nam:202,devolveremo:[],doctrine2:[61,168,338,7,8,277,23,166],consum:[358,330],broken:[292,70,141],cero:[388,202,295,9,359,158,135,161],getmeetup:327,descrita:[350,158,90,319],texttyp:97,existent:[266,267,138,41,189,349,77,350,2,320,388,326,22,375,166,135,193,213,268,140,362,99,7,243,142,277,33,61,282,315,146,148,149,180,11,386,105,336,128,338,108,342,202,45,110,16,46,158,186],implement:[373,312,93,2,62,351,39,117,23,353,254,193,96,247,383,140,81,141,326,60,252,327,319,175,102,146,178,199,221,256,153,169,228,336,87,200,289,108,342,131,110,293,70,46,157,392,186,347],descrito:[266,367,319,314,234,338,60,167],isedit:213,alhoa:213,deleteact:[225,222],foundat:[375,138],gatewai:212,definidora:[338,166],reutilizar:[52,338,331,341,99,204,94,277,167,161],base64_encod:[10,62,360],preservar:[],distribuido:158,isser:[99,163],"jer\u00e1rquico":[186,111],"crear\u00e1":[245,62,337,222,166,19,84,163,92,207,2,383,199,32,277,228,186,33],declarada:[110,342,111],websit:[380,156,131,70,327],getoutput:[358,51],xmlfileload:[231,319,248,153,271,0],multilangrout:347,formtypeextensioninterfac:[266,293],representada:[8,375,138],default_provid:186,mycustomload:293,"programaci\u00f3n":[17,84,288,338,221,20,166,363,386,334,277,186,384],trait:350,em2:148,representado:[286,322,138,362,93,99,181,375],pagado:11,token_provid:58,formopt:327,manejar:[266,74,51,18,314,342,315,115,267,92,93,207,383,23,166,211,222,40,213,247,240,139,140,362,99,326,121,9,60,219,328,62,204,189,331,84,64,224,153,330,386,367,337,338,14,108,67,343,110,111,295,72,297,186,161],mycachedcontain:319,descomentado:[],yui_css:[71,16],"posp\u00f3n":121,account:[74,234,207,111,186,347],almacenado:[19,315,318,77,6,166,25,322,134,306,328,383,331,386,41,92,127,367,337,14,342,343,49],scalabl:[],alia:[266,282,351,117,362,384,341,141,32,327,177,319,148,363,388,228,66,367,153,110,293,70,181,158,73,347],almacenada:[247,130,331,343,77,98,16,9,60,186,49],getfil:[343,297,142,70,268],obvious:[],config_extra:193,save_handl:49,subpeticion:[251,383,173],dynamic_router_route_enhanc:367,regresada:[],sqlite:[193,273,18,148,199,349,361,166,49],objectid:197,"n\u00facleo":[341,315,268,1,145,116,383,351,24,211,222,321,213,96,247,249,134,255,8,32,344,251,311,60,173,331,33,236,328,62,204,273,37,148,199,221,124,11,153,86,388,182,229,367,286,218,215,260,14,108,342,2,389,343,110,293,111,16,46,157,158,346,159,48,161],permanezcan:[226,18],regresado:[314,7,383,342],admin_bundle_routingextra_route_delet:86,nativo:[337,18,247,20,99,142,60,186,49],disable_acl:162,valer:119,nativa:[88,222,331,318,224,121,204,242,386,211],serial:[10,247,189,292,194,226,293,72,159],blog_list:161,notblank:[50,254,207,257,75,269,74,93,99,391,32,208,60,297],result_cache_driv:148,jms_aop:221,antecedent:[267,84,200],acmeassert:32,detenidament:166,reactivarla:104,probablement:[266,315,138,145,300,166,135,222,322,283,96,247,8,327,102,146,273,331,84,149,153,330,367,184,337,389,341,45,206,204,16,297,90],watch:322,"config\u00farala":349,preocupa:[61,350,7,15,331],espectro:18,getnumb:228,philosophi:[],myconvert:210,is_str:299,registerannotationclass:338,setpadtyp:34,bind:[245,74,170,178,202,327,93,99,22,228,9,244,297,182,222],desafortunadament:[40,298,240,389,247,90,360,161],correspond:[141,144,102,222,266,260,341,20,125,362,99,218,70,22,217,60,313,167],primera:[266,238,350,241,242,166,193,247,8,121,60,305,33,222,148,331,84,11,335,106,182,367,200,389,14,341,234,202,343,204,16,346,186,49],"abrir\u00e1":[226,166,64],ob_get_clean:[9,161],fallback:[339,60,226,169,16],mitiga:386,attributebag:386,primero:[0,138,163,273,177,93,383,23,166,211,193,213,56,205,362,99,8,121,142,277,60,281,144,62,319,147,331,149,293,349,286,153,226,299,182,231,218,179,338,339,201,247,375,202,270,343,145,204,16,157,297,186,371],bidireccion:346,request_filenam:205,rewriteapp:169,seudoclas:240,delegar:[201,146,327],my_mongo_provid:338,imperson:186,meter:297,colorear:[61,7],nterfac:111,"dubujar\u00e1":[],bunch:[],aument:331,globalment:[176,283,260,99,293,204,16,71,346,167],settitl:[22,178,326,218,77],labor:204,my_route_:312,"conf\u00eda":[272,338,186,182,92,158,211],xliff:[158,60,293],acme_someth:175,"extender\u00e1":293,descriptiva:60,getsport:327,recopilar:61,implementacion:[383,96,18,136,342,225,386,70,9,367,360,49],addpathel:141,"concatenaci\u00f3n":[158,225,222],dan:[],sonata_admin_doctrine_phpcr:86,"estrateg\u00eda":342,"rengl\u00f3n":99,descriptivo:[158,33],mention:[347,87],depreciar:[11,47],sonata:[245,218,111,96,255,339,1,108,273,140,77,326,110,86,70,156,197,325,347,367],"enviar\u00e1":[228,331,186,48],"qu\u00e9":[266,203,51,315,18,91,1,145,189,282,77,78,242,2,383,241,80,346,22,304,384,23,166,167,26,108,342,56,248,240,139,249,362,99,8,121,251,311,60,305,33,319,176,144,62,111,254,178,331,84,64,349,153,330,210,125,228,182,366,367,278,337,179,14,15,234,341,90,109,343,110,280,70,16,46,72,371,297,186,363,161],csrf_protect:[14,226,99,16],"significar\u00eda":[8,96,49],recuerda:[281,144,383,341,338,331,166,350,380,204,209,186,48,167],interceptan:200,significativament:[286,30],emb:[326,327],sf2_acl_:58,"devolv\u00eda":289,februari:[],interceptar:[186,268],dividirlo:193,permitida:[98,218,105],permitido:[128,62,213,354,139,67,286,98,323,234,105,392,186],"podr\u00edamo":[248,271,161],yamluserload:299,register_glob:370,votant:[219,220,330,162,189,53,392,293,209,186],bueno:[266,322,40,384,283,14,363,142,295,158,186,33],csrfproviderinterfac:76,corrigen:[89,33],buena:[18,314,91,98,326,23,166,211,255,322,247,58,99,7,8,305,33,61,62,222,273,37,331,84,149,153,338,370,234,109,343,204,16,157,158,346,186,161],exampletwo:388,suministra:[299,186],almacenen:[104,204],packagist:[152,239,0,138,163,2,375,271,191,248,240,7,142,358,217,61,177,383,384,39,224,363,65,231,289,201,15,69,46,72],entity_manag:[278,303,148,115,228,66,210],assertarrayhaskei:182,sirven:[322,40],renderview:[222,64,134],defaultvalu:[153,62,193],req:318,ret:390,stub:224,rel:[245,341,322,56,145,204,71,305,244],ref:[],defens:327,red:[61,314,331,92,7,71,211],mobilehomepag:106,franc:343,enviart:382,"nombre_acci\u00f3n":16,doctrinecachebundl:199,insid:[245,322,197,273,202,344,157,327,213],workflow:[],efectivament:[162,136,310,338,226,117,166],controladormetadato:[],inici:[367,259,232,206,25,92,110,265,337,77,127,49],standalon:[199,349,204],controllerresolv:[383,211],que:[0,375,91,1,189,92,93,300,2,238,94,346,3,166,95,4,193,5,96,332,281,97,98,6,99,7,215,195,388,216,9,305,101,10,308,102,197,198,199,311,104,11,298,368,105,310,200,107,299,278,12,13,14,201,15,202,327,109,110,111,16,312,313,112,113,222,108,256,18,158,19,206,20,177,318,190,116,21,208,22,117,23,24,211,25,321,26,322,54,213,214,324,119,28,123,163,29,30,31,326,8,121,243,32,389,306,122,218,204,33,355,219,328,329,35,254,36,37,124,331,221,38,293,125,157,126,354,330,40,226,227,41,286,42,336,337,127,43,229,230,128,232,129,287,325,338,44,247,234,131,45,282,343,225,249,236,137,46,345,353,371,47,380,48,49,341,50,51,251,52,335,349,140,350,241,351,352,242,228,362,135,244,245,376,56,136,57,138,139,58,134,250,334,142,357,358,60,143,248,360,319,61,369,144,62,361,146,147,231,255,115,149,150,64,317,152,153,364,154,257,212,155,185,66,366,367,259,207,260,252,289,67,118,68,263,156,304,70,130,71,72,73,370,235,161,266,74,315,268,342,75,76,77,78,164,333,253,79,80,165,270,209,269,167,272,168,210,273,171,274,359,314,271,82,344,148,172,83,279,280,175,176,382,383,384,283,284,178,385,84,224,85,373,179,323,86,180,387,188,182,240,285,277,183,184,88,288,363,290,297,291,390,90,187,391,145,89,294,295,181,392,386,205,186],vieja:[11,331,186],democommand:90,viejo:[234,319],asumir:281,"registrar\u00e1":[46,153,2,293,341],afterward:70,gettransport:[117,90],aprendizaj:[158,211,240],idioma:[218,111,372,36,294,84,375,85,224,154,89,70,346,60,18,195],xmlencod:[292,72,330],libr:[383,341,260,84,99,204,297],bruto:[93,60,166],authenticationtrustresolv:219,post_onli:58,datetimetyp:285,apcclassload:389,retain:332,"instal\u00e1ndolo":[152,239,0,138,163,2,375,271,191,248,240,7,142,358,61,177,383,384,224,363,65,231,289,201,69,46],quemar:[93,75],saca:389,"ignorar\u00e1":149,inyectando:[383,302,14,385,362,91,165,336,278],probada:[199,331],detectar:[2,210,234,343,318],autorizando:186,facil:264,session_fixation_strategi:58,"pr\u00f3ximo":[62,383],"14t21":[363,288],auto_discov:179,"pr\u00f3xima":[328,383,11,343,242,313,43,361],messag:[50,268,269,74,98,93,79,352,190,376,54,3,25,95,291,247,324,250,134,99,7,195,32,251,172,9,60,327,61,176,253,167,142,222,36,38,64,126,333,386,257,155,185,263,127,43,350,183,12,112,261,45,187,344,293,186,48],compartido:[306,331,367],imagine_filter_name2:70,imagine_filter_name1:70,"cu\u00e1l":[314,315,219,77,319,22,330,245,213,142,218,176,382,383,236,256,153,66,367,337,14,108,342,110,204,346,186,49],compartida:[46,2,331],animamo:[286,281,158,186,222],tree_block:86,max_depth:244,negra:[293,220,189,186,392],satisfactoria:314,check_c:[],descendient:[238,202,77,109,335,182,362,305],negro:[61,7],getinput:51,whitelist:343,escuch:[],"adecuaci\u00f3n":129,login_check:[242,98,186,58,25],textfield:[],"familiar\u00edz":89,jms_security_extra:[225,259,360,162],abstracto:[132,383,319,225],latest_new:331,isaccountnonlock:247,"c\u00edan":[61,7],structur:[137,28,118,285,110,8,178,235,347,87],charact:[183,387,290,58,30,326,79,32,122,313,166],llevar:[176,383,18,1,20,318,166,99,2,293,142,158,186,161],num:[137,28,206,235,310,82,295,359,285],try_fil:169,interpretada:[331,84],impactar:286,action_level:[176,382,264],interpretado:[99,204],confirmacion:33,my_mail:[238,91,14,335,234,248,252,212],"ten\u00edan":8,plaintext:[242,60,186],cmf_document_local:308,basepath:[218,273,108,326,110,156,347],nui:234,sf2:[389,156],inspeccionar:[78,144],listact:[156,161],generatetoken:54,propuesto:[338,281,341,166,311],have:[314,261,1,335,79,245,367,169,170,58,81,141,326,194,217,87,327,33,273,199,39,86,387,122,156,213,183,290,339,233,108,234,131,270,292,110,70,297,347],alias_nam:[293,32],flotant:[363,288],usuario2:58,havn:141,allow_page_lock:30,phpcollect:330,mil:350,paquet:[0,1,189,92,354,4,5,96,99,101,115,103,311,11,107,200,14,108,110,204,16,15,18,314,145,20,317,319,21,117,23,24,211,35,321,26,322,27,325,326,8,121,243,218,328,332,222,37,221,124,330,225,227,230,231,337,338,339,340,247,342,111,343,344,345,47,347,341,348,349,249,350,241,351,114,242,135,244,245,56,57,205,140,356,134,60,360,315,146,147,255,148,149,150,153,367,259,260,156,70,71,158,266,353,273,308,77,165,166,210,197,274,277,278,279,175,383,385,84,86,388,213,286,118,184,346,293,186],min:[277,193,213,123,290,373,291,208,93,99,391,79,387,105,190,122],espant:341,"_control":[298,205,300,211,323,5,56,81,121,60,383,222,283,198,84,150,354,106,367,231,339,341,342,110,204,346,186,161],aprendist:[99,186,6],aconsej:197,mix:[128,232,44,29,178,22,376,127],testadd:343,some_field:[137,28,206,235,310,82,295,359,285],issueselectortyp:228,mit:[350,345,129,33],uppercas:[61,7,39,35],"persistir\u00e1":[277,297,166],unless:[322,313,58,81,327],pastel:[93,75,247],mimick:[],role_b:[],role_a:[],salli:253,compilado:[328,40,319,130,49,353,213],dump_max_line_length:70,conmutar:244,payment:[],compilada:[144,209,204,70],form_widget:[266,74,329,298,109,207,178,202,85,99,344,154,294,22,181,362,297,167],segura:[0,338,14,84,166,226,204,241,186],seguro:[93,144,286,5,389,91,331,145,67,305,31,204,242,167,186,360,27],hardcod:[],escanea:[],database_port:[326,30,115,349,16],"recu\u00e9rdamen":[],voterinterfac:[219,392],reflejando:166,query_cache_driv:148,serializado:[19,222,166],serializada:[],text:[266,268,138,206,355,249,98,305,22,375,166,135,25,245,327,322,169,341,56,57,28,97,7,30,99,82,380,121,142,216,9,167,204,61,295,35,178,84,146,244,40,228,285,310,359,88,13,311,202,235,343,344,70,137,71,186,113],securityassert:3,arranca:[343,161,70,16],some_rout:283,introductoria:[342,367],cruzado:99,malintencionado:99,server_nam:169,extraload:81,setter:[163,234,70],choicetyp:[329,178,85,154,294,362],emailconfigur:252,fecha:[75,93,210,166,137,28,99,218,307,177,384,331,11,363,333,155,285,88,288,289,293,111,235,49],doctrinemongodblisten:66,removeel:202,"incl\u00fayelo":[37,321],controla:[260,82,234,305,204],inferior:[331,202,55,99,121,166,211],appkernel:[205,349,241,21,23,24,26,341,356,304,326,8,217,331,101,306,144,255,104,199,221,124,86,87,184,339,338,14,233,16,161],"evoluci\u00f3n":8,in_memori:[242,186],object_identity_ancestor:58,setbarcharact:364,recuperando:[338,277,186,166],isstoppedpropag:[],regularli:[358,212],"acu\u00e9rd":[],csrf:[88,14,76,58,99,344,226,293],guion:[61,4,213,268,7,6,350,2,46,158,353],increas:[],admin_bundle_menu_menuitem_edit:[],memorizars:[],ruso:[60,89],pensamo:[],loggerinterfac:[176,221,268],approach:[108,327,347],possibl:[273,339,39,234,292,70,313,327,347],db_tabl:30,ganan:346,adelantando:305,image_url:266,integr:[213,302,108,110,70,156,347],incio:70,session_pkei:30,convertirlo:[177,383],conform:[338,108,364,142,297,166],concordancia:367,predefinido:[0,301,190,95,193,96,97,82,99,195,273,198,199,310,105,12,13,257,110,204,312,112,113,314,206,115,22,376,25,322,213,324,28,123,29,326,216,122,218,329,222,36,38,126,333,226,41,127,231,44,233,234,45,355,50,284,349,352,242,54,245,246,354,137,58,250,357,359,315,128,148,256,364,154,365,155,287,367,67,68,263,264,70,235,342,269,79,166,98,172,383,178,85,373,386,285,183,185,290,291,187,294,295,181,90],acmeexceptionlisten:251,methodinterceptorinterfac:221,convertirla:[363,384],constraintviolationlist:93,setheadshot:105,compartir:[176,144,56,293,2,8,121,65,345,46,188,23,305],email_address:166,xxxxx:52,"validar\u00e1":[3,235],progreso:[7,284,226,364],pattern:[213,62,0,247,312,354,261,58,81,141,250,339,242,346,186,87],progresa:20,revalida:331,"modificar\u00eda":[202,77],tuvieron:18,extensivament:260,acelerar:[245,331,189,59,318],getrelativepath:177,progress:[7,364,313,262],"abarcar\u00e1":[363,288],perfilador:[383,64,152,343,226,43,361],thumbnail:70,addopt:[61,7,35],use_refer:[58,25],superior:[74,145,20,78,80,23,211,167,341,28,99,121,60,33,144,329,178,85,179,154,181,367,350,185,153,294,157,49],containerawarecommand:[268,35,90],addtypeextens:182,mongodbsessionhandl:49,rogamo:31,"precisi\u00f3n":[359,331,206],haciendo:[281,193,342,363,389,14,331,388,139,202,390,379,153,234,89,16,384,313,383,167],listan:[],swiftmail:[26,284,304,14,201,84,64,134,179,343,8,293,227,16,90,43,48],db_option:30,consideramo:1,phpcr_jackrabbit:199,programado:[209,268],liipimaginebundl:70,instant:341,flashbag:[242,386,222],plugin:[245,341,8,293,244],dobl:[288,341,180,6,363,204],anyth:[339,39,86,271,81],utilizan:[240,350,23,322,193,214,341,355,97,30,99,216,10,176,328,319,255,178,331,84,180,11,153,386,388,287,13,201,108,342,202,186,109,71,49,235,113],equal:[338,209,102,186,247],not_exist:141,falsevalid:187,conseguir:[266,145,349,77,242,22,375,271,193,214,248,166,99,121,142,172,218,33,220,222,37,199,124,64,152,363,277,43,229,286,184,200,288,14,109,343,110,204,161],instanc:[341,298,342,264,115,78,300,319,102,241,388,94,166,353,212,200,323,5,247,303,249,81,8,32,170,9,60,252,327,10,176,382,62,236,147,273,148,39,254,153,217,106,87,93,259,12,283,233,108,234,202,90,68,338,110,70,346,186,347],seleccionando:142,otorga:[136,392],localizaba:163,"caus\u00f3":8,orderedfixtureinterfac:23,streamedresponselisten:293,relevant:[146,137,28,285,363,8,235,33,288],plegamo:[],guidelin:[],"orientaci\u00f3n":281,apariencia:[193,146,197,331,375,99,326,383,121,172,182,60,327,367],wrap:[254,87],fancyact:[305,222,56],notifica:[46,338,2,166],compilerpassinterfac:[117,319,353,351],depurando:[14,189,346,204],thirdparti:322,aprenda:[84,166],always_authenticate_before_gr:58,is_numer:[291,268,185,123],endforeach:[322,40,222,130,202,362,93,218,204,22,71,167,161],actualiza:[322,15,389,346,331,84,20,202,93,179,215,241,89,364,16,277,117,23,313,33],setdocumentclassmapp:41,json:[145,349,92,241,21,242,23,24,244,375,213,96,341,311,249,326,8,217,218,101,306,383,222,255,199,84,124,179,330,86,367,184,337,338,370,15,292,343,110,265,72,346,161],routingextrabudl:347,"adjuntar\u00e1":[206,287,13,295,216,44,97,67,355,29,85,310,82,329,154,294,178,22,181,359,113],defina:[73,150,383],pluralizar:60,extendida:[367,268,56],"alfab\u00e9ticament":[338,166],getcharset:[233,375],registramo:[],"r\u00edgido":62,setpropertypath:[],restant:342,ignorevc:177,empezaremo:[],generan:[338,166,92],assert:[266,50,373,208,269,74,93,207,79,80,352,190,376,54,95,291,250,324,123,263,99,195,32,122,60,254,36,38,349,126,333,387,105,155,185,128,183,12,290,112,45,187,391,297,257],mejorando_foo_y_bar:[],minifi:[71,322],group_cont:86,addpropertyconstraint:[50,373,208,269,93,79,352,190,376,3,95,291,250,324,123,99,195,32,122,60,254,36,38,126,333,105,155,185,128,183,12,112,45,263,391,297,257],"cat\u00e1logo":[60,293],enabledformatt:252,general:70,podemo:[213,14,380,241,117,60,353],getencod:[23,186,256],multi:[111,339,1,108,110,142,218],write_to:[217,103],hubo:84,demostrar:326,notificar:[46,157,2,353,251],jmssecurityextrabundl:[26,259,27,341,114,124,286,98,16,186],plain:[284,134,121,375,138],cov:179,database_host2:115,recolectar:[19,343],istokenvalid:54,defin:[341,380,332,138,212,349,77,350,354,281,102,242,117,362,271,353,167,245,26,193,285,273,96,56,347,137,28,383,140,81,30,99,156,121,375,60,305,176,308,62,204,254,331,84,153,246,86,334,42,66,278,210,87,367,218,260,14,247,234,131,327,110,293,304,70,16,226,73,186,141],externo:[231,144,102,337,0,166,14,20,202,189,92,153,319,346,142,326,165,6,252,275,222],"simult\u00e1nea":[383,386,357],escog:[214,18,255,349,314,226,72,392],ill:[],deben:[74,238,18,242,145,328,93,207,319,284,80,190,23,386,166,353,254,193,247,383,134,99,7,8,354,297,33,61,144,102,226,222,331,11,153,210,335,310,228,66,367,299,338,14,341,390,305,204,157,158,47,186,49],analizar:[210,361,146,268,84,152,363,384,60,346,327,211,319],simplifica:[363,384],file:[266,284,138,261,75,177,93,319,8,384,375,271,212,322,169,213,247,249,81,134,99,156,142,344,217,60,385,306,176,144,161,222,273,199,84,363,226,105,350,87,128,88,289,338,339,233,67,343,110,347,70,386,73,297,48,49],helper:[34,288,314,363,364,293,65,172],convenientement:21,almost:[],logging_interceptor:221,squid:[242,331],preferred_choic:[329,178,85,154,294,181],glosario:[260,8],product_nam:167,reemplazada:[91,8,64,289],encadenado:367,stksection:41,deber:[],analizan:346,accessdeniedhttpexcept:[157,139],transferir:20,"\u00fatile":[145,166,222,168,56,121,142,279,308,329,294,178,331,85,224,363,154,367,310,200,288,338,342,262,343,293,204,16,181],acmestorebundlemodel:[],finito:60,extienda:[256,204,32,362],"ense\u00f1ar":14,auto:[74,193,96,247,148,317,30,68,110,241,218,70,141,297,166,347,367],infer:[],en_gb:60,escanear:165,secuencia:[363,7,288,330],"asociaci\u00f3n":[213,389,202,8,41,166],maravillosa:[],allowifallabstaindecis:219,nashvil:22,maxlength:[183,202],involucran:341,handi:[81,70],issuccess:[358,343,194],cumpl:144,mycommand:236,configuration_id:70,coexistir:386,friendmessageformtyp:327,practica:22,"emparejar\u00e1":[106,346,186,367],asocia:[231,247,266,2,110,41,46,42,211,367],memory_get_peak_usag:10,resultado:[0,240,177,77,166,353,167,193,214,56,268,326,7,380,142,172,60,305,382,384,84,153,231,259,363,14,368,202,343,204,130,346,186,161],nevertheless:[],deleteitem:245,builder:[266,74,206,207,329,351,22,362,193,136,137,28,141,99,82,380,358,359,327,62,146,178,85,310,153,154,228,182,127,285,232,44,67,202,294,295,181,235],usuario_de_prueba:[],thought:[],invoqu:[286,99,166],identificars:157,choos:[329,178,85,93,190,154,294,217,22,181,362,347],acmehellobundlecontrol:[],test2:182,svn:[20,92],"votaci\u00f3n":[281,219],"guard\u00e1ndola":[231,0],simulando:[182,375,138],mantien:[108,319,341,346,84,11,242,2,253,121,236,46,252,135],clave_de_acceso:[],mypersistentclass:339,notacion:225,localiza:184,param1v:193,quiero:136,field:[266,74,294,206,355,207,241,22,166,135,167,26,247,137,28,97,287,29,362,99,82,344,216,142,359,327,329,254,178,295,85,286,154,232,127,285,310,88,13,339,338,44,67,202,45,132,293,304,70,57,181,297,235,347,113],quiera:[266,74,0,332,138,349,92,22,117,375,166,211,322,193,341,162,326,98,8,358,33,102,311,11,225,367,231,184,337,368,202,343,293,204,16,73,297,48,49],reunir:[268,161],add:[0,1,92,300,94,298,5,362,99,7,273,310,106,202,110,204,312,138,67,206,207,22,222,323,213,28,326,217,218,327,33,329,35,39,225,228,127,231,337,44,342,270,343,386,346,347,351,242,245,341,136,137,205,139,249,356,141,142,60,61,146,154,232,367,359,261,156,70,235,266,74,221,375,81,82,380,219,383,283,178,84,85,86,182,285,87,47,292,293,294,295,181,297,186],polici:135,"equivocaci\u00f3n":166,ejecutars:[260,157,353,48],match:[231,62,0,273,205,339,342,141,93,250,110,292,70,310,367,346,347,32],gmt:[137,28,84,331],acierta:[343,43],realic:[14,241,204],acierto:331,"_sonata_admin":[],llena:[14,142,341],searchproductsbynamequeri:[],introduciendo:[386,3],allanar:16,cmf_rout:367,acme_demo_bundl:266,setauthent:62,llame:[99,91,202,164,2,236,46,143,166],backbon:213,success:[221,332],"am\u00e9rica":329,transferencia:[84,20],sessionhandlerinterfac:49,pegarlo:167,doctrin:[1,189,92,99,96,302,303,6,304,196,273,199,349,286,200,201,108,202,110,111,16,312,17,18,115,207,22,23,321,26,213,326,8,121,243,32,327,221,125,41,228,229,316,337,338,339,342,131,45,267,140,241,242,135,245,247,136,57,58,60,360,144,146,255,148,153,66,367,67,68,70,72,73,370,161,266,74,162,78,166,168,210,274,278,178,179,86,388,293,181,297,186],desarrolla:[144,222,341,14,150,64,153,72,319],"a\u00f1adirs":353,routing_repositoryroot:367,my_cm:141,tunombr:313,ingresarlo:176,crawler:[240,15,343,194,142,43,361],inutiliz:[73,367],propel:[26,288,136,316,202,363,277],registerxxx:47,mapping_nam:148,tmp:[148,349,70,289],adicional:[74,238,18,91,77,207,2,117,375,275,353,319,193,209,247,205,249,99,98,60,279,33,176,254,197,331,84,64,224,65,335,367,310,200,368,14,202,385,293,133,295,46,346,334],est:[0,375,1,92,93,300,2,238,94,3,298,95,193,5,96,303,97,98,362,99,7,215,195,388,216,9,305,101,10,308,102,273,198,199,311,104,11,105,310,200,299,12,13,14,201,108,202,327,109,110,111,16,312,313,112,113,222,15,332,18,314,19,206,20,177,318,190,319,21,22,376,23,211,25,322,323,27,324,119,28,123,29,30,326,8,121,353,32,306,122,218,204,33,355,219,328,329,35,36,37,331,221,38,293,354,330,40,226,334,157,286,228,337,127,158,229,128,232,129,325,338,44,247,234,45,343,333,249,248,46,345,47,347,49,341,50,51,348,335,349,140,241,351,352,242,54,243,244,245,56,136,137,205,139,58,250,142,373,251,60,143,360,61,144,62,146,231,255,115,339,149,150,64,317,153,154,65,155,287,367,259,207,260,289,67,68,263,156,69,389,70,130,71,72,73,235,161,266,74,315,162,342,163,76,77,78,164,79,80,165,270,271,269,167,210,359,166,82,380,257,148,172,278,175,382,383,384,284,178,84,85,386,256,387,188,182,285,213,277,183,184,185,288,363,290,346,291,390,90,187,391,145,294,295,181,392,297,186],setlayout:34,reabrir:[],devolviendo:[23,383,161],esa:[341,0,235,342,206,93,319,383,79,305,190,23,166,222,272,193,213,247,137,28,205,139,99,82,8,32,60,204,33,62,142,198,84,286,153,359,386,218,388,310,182,285,350,367,231,183,184,200,371,338,14,108,234,202,45,389,343,346,70,295,241,72,90,297,186,49],eso:[74,205,19,207,102,242,166,211,167,322,323,56,136,268,140,99,121,305,306,328,62,346,336,331,84,182,184,200,389,14,131,204,16,157,392,297,186,161],nocoffe:213,esi:[197,331,318,344,226,16,242,386,186,211],mode:[218,239,70,134],my_uuid_gener:302,articled:331,realment:[74,18,314,115,92,78,2,22,23,166,167,322,283,341,268,98,29,31,99,7,121,32,277,60,33,61,383,142,222,178,331,64,153,228,77,229,93,259,337,389,44,108,202,343,293,204,16,46,72,186,48,161],autoincr:277,midgard_tree_nod:199,cookie_lifetim:[226,49],host:[284,0,115,349,134,166,272,193,58,30,326,277,273,148,84,227,388,106,231,186,156,70,16,346,90],although:[342,347,141],expira:49,"removi\u00f3":[186,247],"electr\u00f3nico":[51,373,189,93,284,22,166,222,227,171,134,215,9,186,252,33,382,383,204,254,84,180,310,64,43,258,259,12,260,14,247,45,290,343,89,133,16,90,48,161],mi_formateador:264,setstatuscod:[62,138,331,84,251,375],"llen\u00f3":247,panel:[10,108,86,347,111],accessdecisionmanagerinterfac:219,about:[282,239,339,1,261,270,326,70,347,212],actual:[51,0,138,342,219,299,383,241,375,3,211,310,322,193,5,136,137,28,268,139,58,81,141,98,156,142,344,60,327,33,306,177,102,204,166,199,39,256,11,363,364,286,66,213,231,259,288,289,130,234,202,110,70,392,346,186,347,49],socket:148,fastcgi_pass:169,"explicar\u00e9":121,purgar:331,introducen:313,lifecycl:[166,135],discard:96,actuar:[383,247,84,131,142,211,161],"desarroll\u00f3":[110,342],cassandra:18,"provocar\u00e1":[166,319,186,64,49],setstyl:[61,7],exostent:[],diciendo:[157,346],hija:[201,204,56],sellada:49,leverag:292,getcontrollerresult:211,poniendo:[383,34,375,218,70],pictur:[],ajustars:11,daoauthenticationprovid:256,demo_bundl:293,contactoact:84,entityuserprovid:247,biggest:347,herencia:[334,356,189,84,149,211,305,379,94,2,390,351,65,204,16,46,182,186,135,167],anypass:142,vinculen:18,password_paramet:58,emocionant:[62,346],brand:217,baseurl:[231,0],oauth:247,"_password":[98,186,58,25],inlin:[384,273,1,363,344,331],bug:[313,349,33],editform:202,escal:331,embargo:[238,0,18,91,315,282,318,77,93,165,2,383,80,164,362,166,135,167,168,331,250,136,268,98,6,99,7,8,142,60,143,305,144,161,222,273,199,104,322,286,226,335,310,366,107,367,231,184,337,338,14,302,234,202,389,343,204,46,386,73,346,186,48,49],wish:[199,327,347,141],googlecod:92,describiendo:148,duro:138,"diferir\u00e1n":108,vencido:201,domina:331,"a\u00f1adir\u00e1n":[22,119,346],domino:226,myrepositori:302,pie:[2,204],dura:[281,331,200],invitamo:[],sustituya:[119,331],validateblock:77,"activar\u00e1":338,probabl:[128,322,169,148,388,150,141,156,16,327,87],propietario:[136,286,289,129,202],ciudad:380,"f\u00f3rmula":104,hellowsdlporttyp:9,not_blank:60,detail:[322,169,349,273,108,234,58,6,110,226,335,293,347,87],virtual:[273,137,28,145,189,349,235,380,121,178,285,297,90,280],phpcr_move:[245,86],controllers_by_class:[156,110,218,347,367],session_valu:30,"encontr\u00f3":[210,139,197],"tecnolog\u00eda":[331,84,58],collectedmessag:43,blogtyp:170,"investigaci\u00f3n":351,"ajustar\u00e1":[99,98,60],autentiqu:[186,247],findon:277,adddocu:142,"validaci\u00f3n":[74,314,373,75,189,349,77,93,207,319,329,79,351,80,208,190,376,54,182,167,26,193,250,137,28,97,295,29,379,99,82,216,32,122,359,242,355,62,226,254,123,178,331,84,149,293,365,85,126,153,154,387,181,287,66,127,285,310,183,356,185,13,290,14,291,67,391,374,206,304,294,44,157,161,297,235,113],datetime_funct:[303,148],cmf_is_publish:308,"eliminaci\u00f3n":[338,297,20,298,319],symfonycmfsimplecmsbundl:[24,347],observada:186,extrafieldsmessag:254,observado:338,data_load:70,decrita:[127,76,232],planteamiento:[],concedist:136,propset:92,"ning\u00fan":[342,94,165,166,222,96,247,326,362,250,7,32,277,204,33,383,146,254,198,64,286,153,22,367,184,129,300,338,14,108,234,202,305,389,110,293,70,346,186],original:[284,337,380,92],setvellheaderformat:34,show_post:[231,0],"m\u00e9trica":361,yell:[61,7,35,268],cookbook:[273,178,180,270,70,22,181],routerproxylisten:[],pida:186,actualizacion:33,pide:[299,314,331,166,31,186,135],tratar:[99,392,115],"v\u00ednculo":[22,178],ayud:211,tratan:[383,134],rdf_config_dir:213,documentmanag:[246,326,218,70,77],secured_area:[242,194,186,256],bank:[],setpath:326,"compa\u00f1\u00eda":[1,380,376],cuota:337,umask:145,concret:108,under:[156,185,169,70,141],"soluci\u00f3n":[18,242,134,24,247,30,215,218,101,283,331,84,228,389,202,110,204,312,72,49,297,380,161],testabl:[],getverbos:7,everi:[327,87],abrelo:145,registeract:[207,74,149],prefijado:209,fosuserbundl:[217,156,149,186,184],upstream:33,enganchar:[245,251,293,131],asist:77,"int\u00e9rpret":[268,199,368,20,6,363,313],prefijada:[346,70],decidir:[219,308,349,77,153,41,392,186,367],iteracion:[364,58],disable_deliveri:[343,284,64,134],atacant:[186,360],laser:376,datetimevalid:155,infinitament:109,titulado:8,routeabl:141,bienvenido:[1,121],bienvenida:[61,341,35,18,145,7,121],consistent:[47,360,341],"descargar\u00e1":[338,124,21,161],request:[347,0,256,138,261,273,308,318,249,93,242,2,253,165,210,211,222,245,194,322,375,213,341,383,205,139,58,141,99,276,156,121,142,344,251,60,100,327,10,272,144,62,361,204,197,37,331,84,104,125,298,226,151,66,366,43,87,231,332,339,14,234,202,343,110,293,89,70,16,46,392,313,186,342,161],sourceforg:92,street:[391,380],"sub\u00e1rbol":[231,244,0,18],respetan:[],ancestro:286,notificacion:211,import_rout:81,rolevot:219,myeventlisten:2,setsharedmaxag:[307,331,375,138],routingextrabundl:[70,18,255,1,342,326,110,86,111,347,367],introspect:[],"cuidar\u00e1":330,instance_class:[148,70,388],fuerza:[331,33],directori:[177,169,247,233,289,6,343,8,241,165,297,87],acmesecuritybundl:186,unauthenticatedtoken:256,nombrearchivo:[180,147],filterbypric:277,encamina:[121,161],attrnam:109,proveedora:[247,342,186,162],productrepositori:[338,166],my_service_opt:153,subtre:[70,244],cambiar:[266,51,298,138,91,145,189,177,77,93,281,383,351,305,22,375,3,135,25,327,96,56,331,28,30,99,211,313,60,297,319,176,144,332,146,149,199,84,104,125,349,153,368,386,341,107,367,200,289,220,130,247,235,357,343,293,346,204,14,392,90,47,186,161],rootcollect:[231,0],recarga:331,"actualiz\u00e1ndola":[],includejsfilesact:213,"pr\u00e1ctica":[341,110,14,314,84,149,189,92,99,8,226,356,204,46,158,23,346,331],pata:297,preparar:[383,341,84,20,11,300,368,60],"cap\u00edtulo":[222,298,145,349,318,92,93,242,271,167,247,248,6,99,8,121,277,218,327,62,146,166,331,84,150,286,363,259,60,337,288,260,14,341,338,293,389,204,392,346,186,161],path:[247,74,284,308,298,205,273,177,341,207,326,242,209,134,166,211,25,245,322,323,5,56,347,58,141,99,98,264,121,344,60,305,176,382,332,204,147,198,148,331,84,150,125,349,266,363,222,180,369,106,43,339,87,231,300,283,130,233,108,375,90,109,156,346,70,16,312,226,297,186,48,161],temporalment:9,incom:[110,347,273],"devolver\u00e1":[219,206,222,254,247,178,84,166,99,343,22,346,186,33,161],twig_templ:68,"_connect":148,projectservicecontin:[],anymor:[],grapheme_strlen:[290,122,387],errorlog:169,autenticado:[219,102,247,139,186,392,98,62,69,209,3],hydrat:[148,388],desafiant:[99,166,277],wdt:242,wsseregex:62,integramo:[],"le\u00edst":108,un_nombre_de_vari:68,relacionado:[18,145,22,134,166,247,30,121,277,319,331,84,153,226,334,182,341,234,202,343,47,161],ingresado:[235,314,137,28,206,355,3,310,250,82,295,190,285,359,186],ingresada:250,"configuraci\u00f3n":[0,91,1,189,92,93,354,284,191,166,193,5,96,302,6,99,100,305,101,71,10,307,115,102,103,198,199,104,299,14,202,110,111,16,312,17,205,19,145,20,282,318,319,209,210,211,25,26,322,27,28,30,326,8,121,243,218,33,220,204,37,331,332,125,224,40,226,227,41,42,230,128,337,338,130,247,234,343,225,249,137,328,386,346,48,49,341,238,348,335,349,140,351,242,362,55,135,244,245,56,57,268,58,356,134,60,252,248,360,144,62,222,231,255,148,339,149,150,180,317,363,154,365,367,259,260,369,68,264,304,70,265,157,158,73,370,159,161,306,267,315,162,342,163,77,78,165,275,167,273,271,98,277,175,176,382,384,283,385,84,85,179,86,64,388,182,213,118,184,288,153,389,293,294,392,297,186],allow_revalid:331,printf:[363,384,167],hablar:221,"consigui\u00f3":157,genderguess:39,ssicach:197,previen:99,describ:[288,213,247,260,339,331,268,81,270,31,363,194,347,70,16,217,47,166,229,87],would:[170,273,339,81,141,194,335,313,327,347,212],autenticada:[157,219,256],utilizamo:[213,56,14,325,121,47,161],entendist:204,asset:[266,145,20,244,26,322,40,213,56,304,7,8,306,217,305,61,103,189,199,226,65,71,260,130,341,377,344,204,16,86],utilizar:[0,91,1,189,92,93,300,2,284,94,298,193,5,96,240,98,6,99,7,9,100,305,10,307,115,196,197,198,199,11,106,278,12,376,14,201,15,202,110,204,16,313,369,18,158,206,20,219,318,190,319,346,22,117,23,211,222,200,322,213,119,28,30,326,8,121,32,218,328,329,35,331,311,293,125,354,330,226,227,335,42,127,43,231,337,338,130,247,234,45,343,133,46,47,48,49,341,238,52,349,140,351,352,242,228,362,353,56,136,248,138,58,356,134,314,334,59,142,251,60,143,61,144,62,361,63,147,166,148,339,149,150,180,153,154,366,367,259,207,252,289,67,68,264,70,44,72,73,370,161,306,74,315,268,342,163,77,78,164,165,375,275,167,210,273,171,359,271,379,82,172,83,175,176,177,383,384,283,178,84,85,386,256,388,182,286,184,88,288,363,389,297,390,90,377,145,294,181,392,205,186],preview:70,"\u00e1rbol":[245,231,367,193,0,96,18,108,349,77,286,109,142,111,365,218,24,153,213],pued:[0,375,91,1,92,93,300,2,238,94,3,191,166,95,4,193,5,96,302,303,97,98,6,99,7,251,388,216,9,100,305,10,307,102,273,199,311,104,11,298,368,105,310,106,107,299,278,12,13,14,201,15,202,109,110,204,16,313,112,113,222,108,256,18,158,19,206,20,177,318,190,281,329,21,39,346,22,117,23,386,211,25,321,200,322,54,213,214,119,28,29,30,326,8,121,353,32,306,122,218,327,33,355,219,34,35,254,123,37,331,221,124,293,125,157,224,354,330,40,226,41,286,42,336,127,43,229,230,128,232,287,338,44,247,234,131,45,282,343,225,337,236,137,46,345,371,47,380,48,49,341,51,239,52,348,335,349,249,241,351,352,242,228,362,55,135,376,56,136,57,138,139,58,250,142,373,358,60,143,248,360,319,61,369,144,62,361,146,147,231,255,115,149,150,64,152,153,364,154,65,185,66,366,367,259,207,260,252,289,67,389,264,69,70,130,71,72,73,370,235,161,266,74,315,268,342,163,76,77,78,164,253,80,165,270,209,269,167,272,210,359,314,271,332,82,344,257,148,172,212,175,176,382,383,384,283,284,178,84,85,179,323,86,180,387,188,182,240,285,277,184,88,288,363,290,297,291,390,90,187,391,145,89,294,295,181,392,205,186],getflash:[],knpbundl:[217,204,161],ganancia:201,type_part:99,saber:[314,91,1,78,351,271,96,341,248,99,8,121,19,60,305,33,61,176,282,102,293,186,161],muchosauno:202,symfonycmfblockbundl:[255,326,246,197],csrf_paramet:58,empiecen:369,must:[298,373,335,79,190,375,170,96,58,141,217,254,123,331,39,310,153,86,122,87,185,313,291,108,234,131,270,70,297],adecuadament:342,access_decision_manag:[392,58],join:166,"at\u00f3mico":297,"at\u00f3mica":33,"var\u00e1":102,blockbund:197,norm:228,"pol\u00edtica":60,decencod:360,instala:[245,23,15,180,179,326,145,111,241,60,347,244],overrid:[170,233,39,156,375,87],modificacion:[342,202,179,2,89,204,46],"creaci\u00f3n":[175,222,18,20,300,301,80,164,166,211,167,4,341,248,383,326,99,7,60,143,61,281,144,62,146,37,331,153,334,182,200,289,260,14,234,270,293,204,252,312,73,297,49],retrollamado:[383,80,190,277,297,166],"vinculaci\u00f3n":182,retrollamada:[267,375,314,93,99,80,190,277,49,297,166,244],"comercializaci\u00f3n":129,"menci\u00f3n":200,cargando:[231,367,0,248,19,326,159,299,153,2,319,365,271,244,186,191,213],consiguir:[],ambigua:214,xdebug:[179,226,202,239],end:[322,62,153,193,70,358,210,313,327],elector:[],dividida:197,comprimida:331,ent:89,env:[61,306,322,214,341,199,368,20,7,236,9,166,48,371],"recu\u00e9rdam":[220,139,189,219,98,293,386,209,186],expresivo:[363,384],dividido:319,collaps:[],pre_auth:62,symfonycmfroutingextrabundl:[255,156,70],alojada:[1,313],x509:[242,58],alojado:[11,215,92],"\u00e1rbole":[89,18],validation_constraint:99,befor:[51,298,240,189,282,375,212,245,379,217,327,177,270,39,87,261,202,45,292,293,157,313,347],especializado:[82,206,20],importedrout:81,symfonyrout:312,access_log:169,especializada:[60,204,142,18],mese:[11,137,28,285,49],inventori:[],util:[162,343,186,326,190,327,360],dependency_inject:[],locale_target_languag:339,amig:[17,27,104,363,204,311,242,305,33,384],bootstrap:[306,144,371,337,205,136,331,341,104,92,389,343,156,16,161,87],exclud:[177,210,343,33],naturaleza:[209,367,331,268],excluy:177,sandbox_main:[110,140,367],environ:[306,176,382,239,388,234,233,264,189,322,180,153,343,194,204,16,344,275,87],menubundl:[96,255,1,108,86,218,347],incorpor:[],enter:[61,291,185,123,314,137,28,206,234,285,310,187,82,295,359,235],exclus:125,frameworkbundl:[74,268,207,351,211,167,194,341,136,81,99,8,121,9,204,33,383,226,35,103,198,37,331,339,150,153,222,43,229,300,14,202,343,344,293,70,16,157,158,346,186,161],enviar:[51,18,189,284,346,375,166,272,171,138,58,134,31,99,215,142,33,281,382,383,222,331,84,64,226,227,43,258,14,390,90,343,110,16,386,49,313,186,48,161],reloj:331,requires_channel:[369,186,5,58],plantilla:[189,93,300,40,96,192,362,99,216,305,10,308,197,13,14,202,109,110,204,311,113,206,316,207,22,209,210,26,322,213,29,326,8,121,218,329,222,331,16,226,42,230,338,44,341,342,111,344,346,347,238,52,351,242,244,245,97,246,56,355,140,356,134,60,144,315,63,147,339,149,154,65,367,359,67,68,130,71,158,159,161,266,74,77,166,167,82,277,280,383,178,84,85,86,287,293,294,295,181,297,186],integrando:[17,63,56,338,331,302,342,99,110,204,344,22,367,305,222],over:[339,110,86,347],fall:[339,239],becaus:[322,383,197,39,234,141,327,87],jpeg:[130,343],london:22,recursivo:260,lazyservicesequencepass:330,firephp:[293,16],"desaparecer\u00e1n":202,param_convert:210,edita:[266,144,213,343],normalizan:193,cli:[370,234,70],img:[10,266,56,130,226,204,305],acmedemo:[204,147],fetchal:78,securityfactoryinterfac:62,redirigido:[186,58,332,25],"imprimir\u00e1":[61,7,346],comprehens:[],minimizado:71,normalizar:[153,193],proporcion:[129,96,314,190,218,186],newsarticl:213,trabajaremo:161,closureload:[231,0],refinclud:180,"lanzar\u00e1":[383,222,314,14,202,319,47,186,254],hide_user_not_found:58,"ingenier\u00eda":135,lento:[177,253,322],octubr:215,sessioninterfac:386,lenta:259,custom_second:78,myprivateservic:119,choic:[75,93,190,22,212,137,28,29,362,99,327,329,70,178,85,154,285,88,339,109,344,294,181,235],getdued:99,precedencia:[110,367],each:[322,246,70,197,273,339,233,202,234,58,131,141,310,343,110,226,142,313,327,347],"hist\u00f3rico":18,invocan:7,combinacion:112,prohibir:[],acmetaskbundl:[99,202,228],my_alternative_mail:[238,335],saturdai:[],blogcontrol:[136,307,346,161],customhydr:[],getcollector:[43,361],nunca:[18,318,165,166,96,341,99,8,60,84,222,148,331,221,363,367,288,14,342,346,186,161],miespaciodenombr:[],parseexcept:[363,384],silenciosament:[331,166],is_bundl:[148,70,388],userrepositori:247,estableciendo:[282,130,385,64,226,25,166,212],csrf_field_nam:99,extra_us:299,webserviceuserbundl:102,registercontainerconfigur:[14,144,87,341,16],forgeri:99,verdadera:[93,75,166,84],"planificaci\u00f3n":1,"exhibici\u00f3n":[167,386,25],"sistem\u00e1tica":[8,166],getfilenam:177,conservadorament:331,pernicioso:161,peopl:327,precompil:213,bylin:204,intentan:142,foo_choic:[329,178,85,154,294,181],activerecord:277,probar:[91,145,189,166,167,326,99,7,121,357,33,61,253,196,180,179,226,182,43,229,338,14,343,280,204,16,158,346],openssl:186,"contaminaci\u00f3n":386,appdevdebugprojectcontain:[144,353],filter:[238,138,388,301,242,375,322,40,213,240,326,194,142,177,222,103,148,334,335,130,270,343,344,70,16,71],"gui\u00f3n":[10,61,179,337,213,36,367,294,268,92,99,7,389,236,363,60,186,153,288],referirno:[],onto:339,elimina:[322,184,138,130,84,202,356,238,121,277,241,386,375,297,186,33],liip:[199,273],intentar:[322,388,228,376,186,353,25],rand:67,rang:[291,185,254,123,137,28,75,58,93,99,375,285],testsecuredhello:194,getdqlpart:[],setvellrowformat:34,getlog:331,manteniendo:[309,372,11,121,89,252],restrict:326,alreadi:[245,74,273,289,339,39,342,58,141,45,327,347],adicionalment:[222,331,342,362,334,346,213],cardnumb:[126,376],primari:[135,30],"p\u00fabica":331,"explicaci\u00f3n":[99,211,204,33,346],exprbuild:193,role2:209,getform:[99,297,146,327],top:[342,347],fiction:141,vaciado:20,your_gmail_password:[],quinto:314,too:[128,183,254,290,163,79,387,105,122,327],detalladament:31,inconvenient:[46,228,2,389],ligerament:[251,153,322,8,167],usarlo:[322,354,200,346,268,338,130,331,145,134,153,326,383,228,117,60,362,186],paso:[266,315,18,145,20,349,92,319,383,241,346,23,24,166,135,222,322,193,331,247,136,139,140,31,99,326,215,211,277,60,327,101,62,146,255,199,84,151,126,179,259,218,184,337,338,14,341,342,202,364,33,204,392,313,186,161],consol:[306,51,205,314,145,115,349,320,241,23,166,135,222,322,213,214,341,136,57,268,326,99,7,8,121,243,172,60,204,360,61,236,34,35,273,20,199,364,86,217,107,87,230,277,118,368,338,14,274,70,16,346,159,48,371],"descripci\u00f3n":[26,273,148,202,286,250,343,215,211,209,313,305,33,174],tool:[281,239,111,214,108,273,292,236,347],privaci:300,took:[],phpcrproxi:70,intercambiada:[],denominada:[153,277,247,204,30],conserv:[],simula:[343,35],createformfactorybuild:182,denominado:[99,225,176],gender_cod:362,acl_class:[286,58],loaduserdata:23,sugerimo:18,scenario:[234,327],warmup:[199,293,70,371],encontrarlo:[157,343],habilita:[367,218,213,162,255,180,343,70,16,60,43,361],content_path:141,"cambi\u00f3":[228,202],setuuidgener:302,cierren:49,probando:[61,26,35,341,316,357,189,343,180,7,320,226,258,142,280,182,237,159,229,196],thu:[331,87],ensurestop:152,emiten:7,close:[152,313,229,244],contentdocu:[110,367],getrequest:[74,62,222,331,242,202,256,249,207,2,204,46,157,60,297,186,211,343],base_form_label:167,raw:[218,60,213,204,327],efecto:[253,368,14,331,343,293,392,60,167],etrega:[],getalpha:[375,138],disparan:297,nestedmatch:[342,347,367],"construir\u00e1":99,ignorar:[226,166,92],accountbundl:[207,74],selectedvalu:344,ticket_xxx:33,determinarlo:110,customsecond:78,"may\u00fascula":[61,163,350,7,225,204,158],preauthor:[119,209],tratado:[222,161],client:[18,145,189,77,242,383,22,375,211,222,380,331,138,99,194,121,353,142,9,361,100,327,253,196,118,199,84,286,226,43,200,260,343,204,157,346,186,49],personalizando:[266,34,14,342,223,141,99,311,367,280,167],fuzzi:[],thoma:[305,186,56],tratada:278,getxsdvalidationbasepath:[153,319],desatendida:268,though:335,sonata_doctrine_phpcr_admin:[245,301,86],introduciremo:[],"gr\u00e1fico":[266,329,146,109,178,28,85,99,344,154,294,22,181,182,362,127,327,280,167],"recibir\u00e1n":338,cifrar:[98,49],insul:[343,253],getpublish:99,onfoopostsend:390,sidebarblock:[326,77],phpcr_odm_reference_collect:70,flow:[],max_width:105,repositorio:[239,0,138,1,163,115,349,77,2,388,375,24,271,191,384,245,168,213,96,247,248,240,326,166,7,215,142,148,358,293,218,33,61,177,383,196,231,224,20,199,124,180,11,363,65,41,92,189,158,229,367,152,337,289,338,201,302,312,343,69,89,70,265,46,72,313],declar:[234,350,110,86,347,87],"evaluaci\u00f3n":144,visualment:[329,178,85,154,294,181],ecosistema:11,cambia:[51,205,238,117,271,384,56,248,29,199,33,383,222,331,149,363,227,335,337,289,389,305,343,16,161],admin_bundle_content_multilangstaticcontent_delet:86,document_manager_nam:[348,96,77],testblock:326,header_client_proto:272,sizelength:387,random:[360,289,186,197,162],detenerlo:330,reorganiza:33,secco:[],coordinar:11,radio:[329,88,294,178,29,85,99,343,154,142,181,362],comprob:[61,14,7,357,91],enumera:[321,200,204],iniciado:[337,136,98,2,46,135,49],onkernelresponsepost:[46,2,336],authenticationprovidermanag:256,domicilio:[391,380],absolut:[326,141],big_valu:193,configur:[175,246,359,145,189,349,341,242,319,241,323,346,22,194,210,275,212,245,26,193,170,56,136,166,28,249,81,141,304,7,156,121,217,218,252,305,280,354,61,307,328,62,35,197,213,37,178,199,39,180,153,169,226,41,271,42,338,87,356,70,283,14,233,108,375,335,235,385,292,110,111,339,273,158,297,186,347,49],my_layout:156,hacerla:[248,305,271,32,247],lolcat:289,persistirs:[277,202],disableoriginalconstructor:182,photo:[177,343,142,289],atractiva:14,reemplazado:[22,119,234,204,6],rss:[246,140,77,326,156,242,346],"f\u00e1cilment":[306,222,298,302,145,318,93,242,319,301,351,190,23,24,166,167,375,56,136,249,6,99,121,142,357,251,218,305,10,176,144,383,35,147,37,370,331,84,150,64,153,386,388,228,182,229,367,289,338,14,247,342,202,343,110,204,16,392,161,346,186,49],fetch_depth:70,desactivo:[],escritor:11,onkernelview:211,applicationkernel:213,pathprovid:141,registerprefix:201,opcionalment:[51,18,2,22,211,341,7,60,33,61,70,199,386,65,228,367,260,56,342,343,110,111,46,158],referirla:33,"limitaci\u00f3n":[331,23,129,298],report:[],setcach:[331,375,138],sanearlo:[],pliegu:313,collector:10,provien:[19,383,211,186,204],desregistrar:[184,356],controllerrefer:[331,204],twice:81,pliega:313,dependiendo:[284,18,294,206,20,349,329,22,211,167,96,247,136,268,98,178,293,359,252,360,281,102,35,148,331,84,149,85,154,388,182,259,368,338,311,342,202,131,110,145,204,295,181,47,49],intencional:204,integertolocalizedstringtransform:[359,295],decodificar:186,complejo:[319,153,314,108,362,182,99,386,142,22,72,186,49],phpcrbrowser:[],my_typ:153,asignando:[338,210,346,186,166],full:[339,108,261,131,350,156,327,347],persistiremo:[],materializado:18,eventnam:[152,336],destinatario:[284,64],expertis:[],webtestcas:[35,343,194,43,229,361],hopefulli:[],databas:[266,314,115,349,78,166,135,193,6,326,277,327,273,148,199,388,87,108,342,70,297,347],hayamo:341,vuelca:[363,20,384],mui:[341,222,238,268,18,1,75,20,328,315,93,300,2,228,242,346,209,23,166,211,167,384,380,168,375,56,136,389,205,163,362,99,334,8,121,32,277,9,204,33,319,240,281,144,62,142,273,255,148,331,84,149,293,180,349,11,153,330,386,227,335,42,229,286,259,288,363,290,14,247,202,131,305,338,343,145,89,111,322,46,71,47,186,161],my_form_type_extens:293,label_translator_strategi:86,reemplazar:[306,238,91,76,351,22,167,354,99,60,305,33,175,176,282,311,149,11,153,127,367,286,232,343,204,16,312,158,346],ajax_layout:86,gestion:[14,319],html5:[206,213,355,97,29,99,82,216,359,329,178,85,154,127,287,13,44,67,294,295,181,113],multisitio:[],variar:[136,144,202],storagemetadatabag:386,reemplazan:342,none_or_on:60,protect:[50,238,332,268,91,208,269,74,93,190,2,79,352,94,376,54,291,3,353,254,95,200,250,324,119,123,58,263,99,7,195,32,373,122,278,252,327,61,236,62,35,36,166,331,39,38,349,126,333,257,387,105,155,185,182,229,128,183,259,12,207,290,14,112,234,202,335,45,187,391,338,70,46,241,90,297,186,350],irregular:193,encargu:84,subproducto:341,extracto:344,publishworkflowcheckerinterfac:308,escapada:[7,60],encarga:[10,281,328,222,247,260,14,202,121,204,186,211,161],explotacion:[],expensa:130,auth_mod:[284,227,134],guardarlo:[277,145],corebundl:[255,339,1,308],guardarla:16,hablemo:331,role_admin:[219,259,225,247,119,369,139,58,256,194,242,186],settag:202,straighforward:[],privacidad:[188,345],trust:[326,375,226],capturar:[62,221,235,388,285],migratorinterfac:70,hijo:[245,308,193,70,108,149,109,343,238,142,335,182,127,244],clearcooki:[375,138],"cronol\u00f3gica":[144,125],incorrectament:31,nonsens:[],infinit:292,"cronol\u00f3gico":[176,268,221,189,125,215,293,258],been:[375,313,347,33,87],render_hinclud:[344,204],mini_biografia:254,entonc:[0,91,92,2,238,190,298,4,193,97,98,6,99,7,216,9,240,102,273,286,106,12,13,14,201,15,202,204,16,313,113,18,206,282,318,319,22,117,23,25,213,214,28,29,8,121,32,328,329,222,311,225,226,335,127,231,44,234,45,343,236,355,46,371,51,52,351,242,362,353,248,138,139,142,60,252,61,144,62,256,153,154,66,259,67,161,203,342,79,80,165,375,271,167,272,359,166,82,175,382,383,384,178,84,85,180,183,287,363,389,293,294,295,181,297,186],getuploaddir:297,beneficiars:247,quickli:313,implica:[238,136,14,20,153,383,389,335,66],procesando:[193,222,58,99,334,191,365,159,211,161],xxx:[158,47,125,33],uncommon:[],greeting_card_manag:[252,238,234,335],predeterminar:[],els:[266,268,93,117,319,58,81,362,99,7,358,327,61,221,35,331,84,251,204,350,339,233,70,297,186,161],"catch":[176,62,239,384,247,289,331,221,256,363,383,268,166,211],getvar:[],blog_control:156,"refi\u00e9ret":[345,199],heredando:99,task_tags_:[],symfony_cmf:197,procesamiento:[341,328,222,205,331,84,202,286,2,386,319,211,49],participen:281,reducir:[238,389,331,342,343,40,226,335,158,49],"implementaci\u00f3n":[162,20,349,77,2,102,271,211,167,245,247,136,248,18,383,121,142,252,204,308,62,70,336,331,11,386,65,286,182,367,224,297,108,342,390,110,111,46,47,186],subcadena:60,enableallpluginsexcept:8,dashboard:[339,156,108,86],dm2:388,notpath:177,calculadora:343,etiquetada:107,a_random_str:58,abstractfactori:[62,293],sessionexpir:49,cardschem:[93,376,75],doctrineextens:[148,168,388],garak:89,procesarlo:[386,186,268],exterior:[350,186],"redondear\u00e1n":295,tediou:[],encoderfactori:256,phpcr_user:70,exampleon:388,adaptador:197,"beneficiar\u00e1":204,suggest:[],acmedebugbundl:10,findwithjoin:210,drawback:234,database_name2:115,agatha:34,complet:[254,273,358,156,22,181],"pedir\u00e1n":33,prebind:327,social:[158,327],entregado:[22,284,121,222],podamo:[312,341],visitada:25,visitado:144,formatea:293,dado:[274,314,373,93,190,2,102,79,352,22,209,210,211,244,341,136,57,383,243,142,60,175,219,62,123,331,226,345,185,182,230,259,12,289,346,291,109,343,344,311,46,71,392,49,47,161],arrancar:[328,222,341,260,152,70,16,229],checktimeout:358,"a\u00fan":[284,268,19,2,241,22,271,319,213,341,326,166,99,7,8,121,277,33,61,219,62,222,37,226,42,200,338,342,202,109,389,204,46,49,346,186,161],inteligent:[247,337,153,338,14,331,15,318,99,204,16,166,161],dada:[0,144,79,190,210,211,99,30,250,122,218,219,331,256,66,231,183,290,344,311,312,346],olvidado:99,visualizar:[181,346],file_widget:266,everyth:[234,327],"escap\u00f3":204,database_user2:115,testnameisoutput:[61,7],copiar:[337,129,289,119,145,20,92,226,204,345,188,167],uniqueent:[93,74,75,45],recursivament:[109,177,289],compleja:[193,63,52,136,346,84,20,338,166,93,363,319,334,277,72,60,252,209,343,288],presentamo:242,database_nam:[115,349,30,326,16,277,166],treebrowserbundl:[245,1,86,244],storagedefinit:30,group_bi:181,expos:156,parsing_config_fil:152,interfer:[],interpreta:[84,180,16],notfoundmessag:128,filterresponseev:[383,2,46,157,336,211],mencionada:[341,383,273,18,338,108,342,153,110,293],mencionado:[336,62,184,161,25],expon:[308,213,18,14,331,341,189,356,153,319,22,9,158,211,49],explanatori:[],memcachecach:[148,388],disposit:[375,138],descubrist:[135,341],"4f954a0667e01":58,perfecto:[383,346],collectionvalid:254,banda:331,"tama\u00f1o":[128,177,130,105],apart:[110,193,342,341],amethodonlytobeinvokedthroughaspecificchannel:119,colour:[],arbitrari:[70,87],"alg\u00f3":314,"cont\u00e1ctano":342,setset:246,configurast:[22,178,326,70],specifii:141,regularment:33,getschem:272,transformtext:350,acab:322,crearlo:[245,139,204,161],contesta:331,"_profil":211,fastcgi_param:169,abctestbundl:341,httpcach:331,donald:247,"agregar\u00e1n":[238,335],"d\u00f3nde":[284,19,145,77,383,25,245,322,193,56,325,139,58,134,218,102,70,84,179,226,388,336,230,341,204,16,157,346,186,161],successfulli:[],intval:161,contentawaregener:[339,110,342],icc:289,blacklist_vot:392,"var\u00eda":[331,383,167],cnd:70,select:[314,78,190,166,167,245,247,137,28,362,326,142,327,329,70,178,85,226,181,228,285,339,343,294,154,161],getresolv:81,incorporado:[383,342,234,30,286,121,228],testobject:182,reproductor:[108,204],acceda:186,icu:[224,339,370],number_of_peopl:327,core:[242,206,355,98,93,207,102,329,22,3,247,136,137,28,97,139,58,29,82,194,216,359,327,33,219,62,273,178,221,256,85,310,154,287,182,127,285,87,259,232,13,339,44,311,67,235,292,293,294,295,392,313,186,113],involucrado:351,enviamo:[],encima:[172,383,346,204],recordemo:[61,7,331],involucrada:[62,89],cort:221,yamlfileload:[271,231,319,0,248],textmat:226,corr:[343,186],excluir:[210,337,247],subjetiva:350,"separaci\u00f3n":[322,181,14,329,85,110,154,294,178,121,270,161],chapter:[363,349,288,131,87],indicando:[331,284],"incre\u00edblement":[240,338,186,109,343,166],esperan:18,"uni\u00f3n":[210,166,18],descarga:[321,145,337,37,199,15,349,180,92,255,86,71,24,101,161],surround:212,unfortun:70,jackalop:[273,18,199,349,326,70,345],determinada:[0,138,373,241,376,375,166,243,222,272,40,96,274,139,250,7,121,60,219,383,319,331,366,231,260,346,108,131,338,343,344,237,186],misma:[222,238,268,298,18,342,345,93,2,241,117,23,166,211,167,322,5,56,119,281,52,30,99,7,8,32,277,90,60,305,61,176,282,383,204,148,331,84,149,150,64,286,335,106,366,107,367,219,350,260,14,341,234,202,45,338,110,293,70,311,46,188,161,346,186,49],liber:313,mismo:[0,92,93,354,2,298,193,362,99,7,286,200,14,108,202,109,209,311,313,18,19,145,115,207,22,117,210,211,25,213,214,29,326,8,121,32,218,204,328,222,37,331,16,226,335,228,72,231,337,338,56,342,131,45,343,344,46,346,49,238,242,353,245,341,137,142,357,60,61,144,146,118,149,363,259,260,71,158,161,74,234,77,166,167,380,277,278,384,178,84,179,310,186,90],determinado:[0,18,219,318,242,352,190,209,166,211,167,193,354,11,139,338,243,60,177,383,319,231,336,256,224,386,66,128,13,260,45,109,343,110,389,204,71,186],produc:[61,341,322,222,214,240,145,141,7,293,311,270,166,211],encuentra:[0,240,145,328,77,78,241,209,210,243,167,272,96,341,274,57,326,8,121,60,308,222,197,179,330,386,388,228,231,184,338,14,201,389,343,204,313,186],transactionalinterceptor:221,agradecimiento:[99,222],encod:[298,115,93,300,242,23,135,212,323,5,247,58,81,8,32,277,9,60,10,102,330,283,331,256,106,12,341,375,90,292,293,72,346,186],appropri:[194,87],"convenci\u00f3n":[17,118,350,210,166,353,4,247,362,277,60,33,328,383,222,386,201,341,343,204,16,158,47,161],"util\u00edzala":[93,75,186],"car\u00e1cter":[83,288,363,14,189,250,6,99,110,226,323,386,60,313],formtypeguesserinterfac:293,storag:[199,108,30,226,357,347,49],search_field:348,mysql_clos:161,integertyp:295,familiarizart:[313,273],clasr:[],fieldnam:338,existen:[322,62,254,341,331,14,1,84,234,338,99,388,148,60,108,166],transform:[350,228,108],getcapt:204,interactuar:[338,14,331,84,150,142,166],reli:[339,108,347],familiarizara:281,carguen:319,etiquetast:330,ubicacion:[176,177,201,133,165,60],"a\u00e1mbito":66,salvaguardar:225,conducir:228,enfrentars:175,head:[10,231,0,56,331,84,65,204,311,341,244,346,305,33,161],medium:[137,28,199,285],realiza:[231,259,0,207,136,14,331,84,20,299,99,343,121,260,22,60,319],acme_oth:175,ucfirst:39,phpcrodm_children:[245,86],indicado:[288,286,363,121,190,319],routing_post_prefix:156,disponemo:[343,357,204,244],accepthead:375,securitycontextinterfac:[219,62,221,139,256,259],freenod:[281,20],abstraiga:136,viva:[338,84,8,311,237,166,49],processrecord:176,acmedemobundlecontrol:8,tengan:[40,236,331,45,310,2,121,204,46,392,167],vive:[341,322,184,204,153,260,14,311,149,99,8,142,16,346,166,222],attr:[245,109,310,99,343,142,22,244,127,167],"alem\u00e1n":218,vivo:[84,20,18],ciencia:331,escapa:[60,204,56],pagina:180,"llam\u00e9mosla":[],elseif:[84,70,161],sospechosa:8,"notificaci\u00f3n":[94,153,338,157],"_demo_secur":184,trim:[287,13,314,355,97,109,216,113,127,167],programada:[61,7,209,48],"ah\u00ed":[219,337,341,248,84,20,202,92,119,313,271],propio:[61,332,266,314,19,189,177,92,164,2,102,326,22,343,210,166,353,222,322,375,197,341,136,325,383,140,99,7,142,306,172,60,143,204,101,319,10,144,62,63,147,331,84,149,125,386,256,277,77,392,213,219,367,218,337,289,220,14,311,342,338,165,293,33,133,16,46,328,47,186,49],check:[144,240,367,370,39,131,126,292,98,121,70,358,217,361,297,327,33,87],propia:[162,145,93,2,351,164,166,213,96,341,99,251,293,218,143,306,177,383,331,84,286,345,107,367,184,260,14,108,342,338,343,110,69,204,46,188,186],junto:[266,315,268,145,77,2,62,80,117,40,341,139,99,8,100,328,102,204,273,84,193,337,200,70,46,161],readonli:[206,355,137,28,97,29,82,216,359,329,178,85,154,127,285,287,13,44,67,294,295,181,235,113],aplicast:[99,228],fooextens:14,reflejar:[22,99,193],tip:[],"obedecer\u00e1":331,newsletter_manag:[238,252,14,335,271,259,91,164,143,248,212],accesibilidad:110,tie:327,recopil:293,formaliza:383,borra:[389,20],"t\u00edpico":[93,51,20,383],validador:[50,138,373,75,269,93,374,79,80,352,190,376,54,208,95,291,375,263,324,123,250,195,32,122,254,36,38,126,333,387,105,155,185,66,128,183,12,290,112,187,257],especialment:[222,268,84,150,310,99,2,142,46,278,346,186,161],dependencyinject:[341,238,91,328,392,319,102,351,164,117,362,271,353,212,4,23,302,248,383,81,30,326,143,33,175,282,62,222,336,153,330,335,106,66,366,107,259,14,108,234,131,270,292,293,204,252,157,158],switcher_link:339,"com\u00fanment":[128,144,62,0,138,14,231,29,45,310,187,344,8,341,204,105,165,228,375,166,167],enumerado:[199,293,125,33,319],"t\u00edpica":[341,144,238,222,247,335,349,286,110,204,16,218,346],siguient:[268,0,93,354,2,284,193,303,6,99,7,215,305,101,308,102,197,199,104,11,105,107,200,14,201,15,202,109,110,204,311,312,313,257,222,256,18,314,19,145,115,319,21,22,117,23,24,211,25,322,54,213,28,30,326,8,121,353,122,218,327,33,329,35,254,123,37,38,331,124,224,226,334,335,42,336,72,128,337,129,325,338,130,247,342,386,343,248,46,345,371,47,48,49,341,238,240,388,349,249,241,228,242,362,135,245,56,136,137,205,139,58,134,250,251,60,360,61,144,75,146,147,231,255,148,150,64,153,154,185,367,369,67,389,70,157,158,235,161,266,315,162,373,163,269,77,62,80,165,375,271,167,272,210,273,166,98,277,175,176,177,383,178,84,85,179,323,86,180,387,188,182,285,184,88,288,363,290,346,291,90,391,294,181,392,297,186],sienta:[337,145,313,33,92],setargu:[334,236],consid:[39,327,141],sql:[136,148,30,241,277,166,275,161],introducir:[4,368,314,137,28,3,228,166],naveg:[315,273],mb_strlen:[290,122,183,79,387],longer:122,"miimplementaci\u00f3ndecontrolador":[],un_tipo_personalizado:148,retira:22,dic:[115,78,134,211,212,141,303,249,81,6,32,60,176,382,62,319,147,37,148,64,153,227,388,200,278,93,259,12,131,90,68,264,70,186,48],humanament:[260,363,345,288,188],setconfigur:252,cmf_children:308,pauta:[350,89,222],getincrementaloutput:358,"modific\u00f3":289,backward:[],nucleo:213,ubicar:328,identifica:[281,331,84,204,186,243],rol:[369,308,259,213,247,136,341,219,286,392,98,344,242,209,186],search_path:348,"correr\u00e1":182,thi:[91,93,2,94,3,95,193,96,302,97,98,362,99,7,194,195,216,9,305,101,10,102,197,273,199,310,105,299,278,12,13,14,112,108,202,327,110,111,16,312,313,257,113,222,256,314,261,206,115,355,207,329,21,22,117,23,25,322,54,213,324,119,28,123,29,326,8,121,32,122,218,204,39,35,36,38,331,221,124,330,333,226,335,228,127,43,229,128,332,338,44,233,247,234,131,45,343,344,248,46,346,347,341,50,238,349,350,352,242,217,134,353,245,56,136,137,58,141,250,373,60,252,360,61,144,62,361,254,150,64,153,364,154,155,287,66,366,367,259,67,263,156,70,339,157,72,235,161,306,74,268,342,163,269,77,78,253,79,80,270,271,167,169,170,359,81,166,82,172,212,175,176,178,85,86,180,387,182,285,87,277,183,184,185,290,291,390,90,187,294,295,181,392,297,186],article_show:[346,204],jsonp:[375,249],focus:[],is_act:247,recentarticl:204,signific:[],llamamo:[115,167],assertgreaterthan:[343,194],getcookiejar:[343,194],row:[109,247,202,310,99,22,167,161],precisament:[136,341],cnf:166,descargado:[145,15,121,341],div_bas:[],comunidad:[26,168,309,1,20,11,383,204,174,279,161],termina:[383,288,363,202,98,46,2,89,22,158],inverso:[272,331,202,318,242,186],readabl:[128,344],descargada:204,cach:[0,205,19,145,20,92,242,275,353,319,273,341,58,81,166,121,60,331,306,307,144,204,197,37,148,199,104,150,226,388,87,231,337,368,389,233,342,68,343,293,70,16,158,371],annotationexcept:326,getparamet:[175,158,8,326,212],"fot\u00f3grafo":18,rdfa:[213,101],paramconvert:[37,42,210,166,383],adivinada:[],sourc:[289,339,180,350,241,81,182,60,313],getcontain:[35,268,343,194,90,229],none:[34,58,141,169,111,244],feasibl:[],task_field:99,"connotaci\u00f3n":260,nonc:62,xxxxxxxxxx:14,facilitart:[22,222,166],cool:[339,204],edad:[291,167,185,331,352],generarla:180,"cons\u00edguelo":273,doesn:[163,347,141],level:[176,382,339,264,16,87],"un\u00e1nim":[],generarlo:322,gettempl:77,isdebug:319,interactivament:7,manager_typ:86,quick:327,flexibilidad:[327,218,91,146,153,389,14,84,6,99,110,121,334,16,341,158,161,346,166,49],eludiendo:331,despachado:[383,139],sortbytyp:177,read_from:[306,217,103],obsoleta:331,comienc:[13,14,331,93,99,242],"deber\u00edan":[219,383,330,18,342,110,226,32,16,72,252],"corr\u00edgelo":[145,121],"b\u00fasqueda":[177,18,338,348,240,349,131,299,8,216,64,60,166],inyecta:[176,383,14,234,125,2,293,91,210,211,49],apcuniversalclassload:201,inicien:242,comprueb:[190,91,32],port:[272,284,148,199,388,115,349,134,326,70,16,9,30],prefieren:92,factory_servic:[164,143],comit:221,repli:[],totalidad:[106,331,18],"m\u00e9todo":[0,91,189,92,93,354,2,284,94,166,95,4,193,5,240,362,99,7,380,195,9,305,101,10,307,308,102,197,198,199,286,298,105,200,107,278,12,376,14,201,311,202,257,110,204,16,312,313,112,332,138,314,145,20,282,318,190,319,208,22,117,23,24,211,25,322,27,324,119,36,163,326,121,32,306,122,218,327,33,219,220,34,222,254,123,37,331,221,38,126,225,226,41,42,336,72,128,338,247,342,343,333,249,46,386,47,49,341,50,238,52,335,349,140,350,241,351,352,242,228,54,353,245,56,136,248,268,139,58,356,134,250,142,357,358,60,143,61,62,146,231,255,149,150,151,152,153,364,65,155,66,367,259,207,260,252,289,67,263,157,158,161,266,74,162,373,75,269,77,164,79,80,165,375,209,167,272,210,271,379,98,344,172,83,175,176,177,383,384,385,84,224,86,256,387,182,213,277,183,184,185,363,290,346,291,390,90,187,391,293,295,181,392,297,186],migrationsbundl:241,yui_j:[71,322],valida:[50,373,269,74,207,79,352,54,95,291,250,324,123,263,99,195,122,62,254,36,38,333,387,105,155,185,128,183,12,290,112,45,187,391,257],realizaron:166,sacar:[93,99,193,205,184],expirado:[197,247],prosigu:[144,275],refreshus:[102,247],enumerando:218,convenio:[341,201,388,158,60,211],jackrabbit_jar:70,desarrollarla:145,toolbar:[10,144,121,16,55,211],inputopt:[61,7,35,268],cronjob:[61,7],dec:[137,28],onkernelcontrol:[157,211],acme_us:247,choicevalid:190,hostname_pattern:[],abstra:[375,138,84,60,305,211],logout_path:344,semant:1,tweak:[],nullsessionhandl:49,access_abstain:[219,392],pasarlo:[315,93,153,228,42,211],semana:49,pasarla:[248,331,93,2,46,182,271],kind:327,yourself:[292,194,81],file_exist:[389,148,62,319,388],almacenarlo:[337,386,62,145,186],memori:[10,193,148,58,131,134,16,242,186,48],method_cal:165,diagrama:161,todai:[],usecach:197,iniciarla:278,getbundl:184,suscribirlo:[],criteria:[],msg:327,criterio:[177,210,211,142,247],prev:308,dibulga:153,reorder:[],admin_bundle_menu_multilangmenuitem_edit:[],plug:[],capit:344,aplica:[50,294,208,115,93,79,80,352,190,376,54,95,291,322,181,5,187,324,119,123,250,263,99,286,215,195,32,373,122,60,219,329,226,254,36,178,38,85,126,333,154,257,387,105,155,185,269,350,128,183,184,12,290,14,112,15,342,109,391,110,204,157,47,186],eco:219,"servir\u00e1":157,ajustarla:49,gettask:[99,202],prototyp:[193,240,234,202,141,388,22,66,280],second_opt:310,routecontentenhanc:342,repository_method:210,tabular:34,"aut\u00f3nomo":186,"d\u00eda":[95,281,341,331,137,1,84,285,11,98,16,242,313,28,49],minimum:[255,338,169,349,105],sepa:[11,166,341,90,213],trigger_error:47,balanceada:70,twig_extensions_:[],datatim:[],"sanci\u00f3n":14,figura:153,stream:[176,382,264,125,16],paqut:184,funcionalidad:[238,1,189,308,77,383,241,346,117,166,222,26,168,341,99,98,8,216,357,9,175,220,62,196,197,255,149,256,226,335,337,92,229,367,219,259,200,389,14,342,270,293,386,237,186,49],backslash:[],baseblock:[140,77],critic:382,languagevalid:195,contribut:313,alwai:[61,193,254,261,39,234,141,292,7,339,45,313,327],action_listen:157,fos_js_rout:[245,156,86],mongodbaclbundl:136,"ser\u00e1n":[238,0,294,206,355,284,22,23,211,319,272,40,213,119,97,139,7,29,313,82,216,359,204,219,281,382,329,226,111,178,369,85,310,225,154,335,337,127,231,287,129,13,338,44,108,67,110,70,295,181,297,347,113],"duraci\u00f3n":[281,234,152,226,237,49],"necesitar\u00edan":18,setnodenam:326,duedat:[99,28,228],fourth:289,discov:376,containsalphanumer:32,inducir:153,somevalu:94,algo:[51,268,314,342,242,177,93,22,2,238,241,351,94,384,271,135,222,322,213,56,248,139,326,362,379,7,211,142,277,252,390,33,319,61,144,62,204,166,148,331,84,104,152,153,330,386,334,335,228,229,367,259,363,338,14,289,234,202,131,90,282,383,70,46,157,346,186,161],acmesearchbundlelistenersearchindex:[],entienden:331,clone:[199,145,313,273,33],getfrom:43,clona:[313,33],verificando:[62,121],separa:186,delega:[10,286,299,211,204],cambien:[322,226],"d\u00edgito":[375,346,138],varia:[0,91,92,93,2,94,191,193,7,251,9,305,308,102,197,286,14,201,110,204,313,18,20,219,190,22,117,23,211,25,326,8,33,329,319,37,331,39,224,231,338,342,236,46,49,239,240,353,136,248,138,58,142,357,358,60,360,61,144,62,148,149,153,154,65,366,359,368,260,289,69,70,72,161,266,375,271,167,210,166,98,176,177,383,384,178,85,386,388,288,363,293,294,181,392,205,186],domdocu:142,esperar:[284,200,338,11,204,336,166,48,367],first_nam:[74,102,222,163,310,207,167],garantizar:[50,284,18,145,20,93,2,193,121,251,60,41,306,281,255,126,105,128,200,389,108,45,187,33,204,46,186],permisiva:[323,129],replicado:99,inform:[350,144,332,239,70,273,293,233,108,261,58,64,349,31,156,226,111,344,217,215,347],preced:[110,313],combin:[322,169,347,33],especializa:[137,359,222],garantizan:[158,219],fallar:70,"_self":[99,167],minimizando:[71,377],manera:[0,91,92,93,300,2,284,94,191,166,193,5,96,302,303,98,99,7,251,100,305,306,115,197,199,311,286,298,200,14,201,108,202,109,110,204,16,312,313,18,145,20,282,318,190,319,22,117,23,211,25,322,323,213,28,326,8,121,243,218,33,34,222,254,37,331,39,224,226,335,336,127,72,230,231,232,338,130,247,234,270,343,137,46,345,346,48,49,341,238,239,240,241,135,56,136,57,138,142,358,60,252,248,61,144,62,146,147,255,148,149,150,180,152,363,65,337,367,259,368,69,70,157,158,73,161,266,353,315,268,342,163,76,77,80,165,375,209,167,272,210,273,271,82,277,361,177,383,384,178,84,386,388,182,118,288,289,389,297,186,293,188,205,90],exclusiva:331,exclusivo:60,addxmlcont:142,pintarlo:[],comprimen:322,mainli:[],platform_servic:148,setdefinit:[238,91,102,164,117,30,353,143,249,81,141,252,327,282,62,362,335,228,259,338,14,234,131,292,204,157,392,73],setroutebuild:86,compromet:[337,33,92],flashbaginterfac:386,my_handl:[],anonymousclass:219,"an\u00f3nima":[358,343,142],millon:286,"an\u00f3nimo":[209,369,186,98],oyent:[],ordenada:[61,342,286,7,166,211],encuentro:[255,273],newconfigentri:153,setpubl:[331,73,375,392,138],sessionhandl:49,getdebug:204,ibm_db2:148,desarrollo:[284,1,145,20,116,165,166,211,222,322,171,331,134,8,121,19,176,144,309,204,189,199,84,104,64,11,226,227,184,260,341,202,111,16,157,161],blog_basepath:156,only_except:[144,341,226,211,16],ucword:350,name:[268,298,91,93,354,301,190,3,95,193,303,97,98,362,99,7,380,195,216,9,100,305,10,102,103,273,199,310,105,200,12,13,14,112,108,202,109,110,204,312,257,113,222,332,138,314,206,115,177,319,329,208,22,117,210,25,322,54,213,118,324,119,123,29,326,8,121,353,32,122,327,33,39,35,254,36,221,38,125,126,40,226,71,228,43,128,338,130,233,247,342,131,45,343,225,249,236,386,346,341,50,349,140,241,351,352,242,217,134,135,244,245,376,56,355,205,58,141,250,142,251,60,61,62,146,148,64,153,154,65,155,287,367,259,67,263,264,70,44,157,72,371,266,162,373,163,269,77,78,333,79,80,165,270,166,167,375,197,292,359,81,82,344,277,175,176,382,383,178,85,323,86,388,87,183,185,291,187,391,293,294,295,181,392,297,186],executa:[],task_tags___name__:202,admintre:245,fijando:362,anunci:318,llevamo:[],showproductact:166,aborda:[331,313,204],suministr:[117,139],referencemani:70,"llev\u00f3":8,jmsdiextrabundleannotationservic:[],dispon:[1,92,93,190,193,96,52,99,7,9,305,102,273,199,11,310,14,202,109,110,204,313,18,314,145,20,21,164,376,211,35,321,26,322,28,326,8,32,122,218,222,37,331,126,334,127,43,230,338,342,111,343,344,236,248,346,49,284,240,349,241,351,242,243,245,246,56,57,134,142,251,143,61,62,146,118,180,153,364,367,259,368,389,304,70,72,235,371,266,75,22,166,167,197,271,361,176,219,386,387,182,285,286,88,289,290,137,186,293,181,90],inyectarlo:[248,271,77],distinto:[62,273,268,338,14,28,269,180,137,210,346,258],distinta:[332,254,84,99,70,161],individu:[144,161,232,339,202,310,99,322,172,60,127,280,167],buildeditform:77,inyectarla:[238,335],acepto:[207,74],ordenado:[61,338,7,277,375,166],setnombr:338,opportun:[],isrememberm:209,acepta:[61,177,0,136,84,99,7,386,89,111,375],"necesitar\u00edamo":202,"100k":177,asegurada:[],addeventsubscrib:[146,327],"omisi\u00f3n":[238,18,314,145,76,93,2,388,384,210,386,25,322,40,213,96,250,58,362,99,8,121,32,251,60,176,144,62,361,222,37,148,331,104,180,310,363,323,226,335,127,367,78,232,14,112,341,202,343,110,293,204,295,46,71,392,346,186,49],"producci\u00f3n":[145,20,241,165,166,211,319,322,341,331,7,8,121,358,172,361,305,61,176,144,222,199,104,226,368,260,130,70,16,71],profil:[10,144,103,341,148,293,43,343,226,16,242,217,386,55,211,361],phpcr_doctrine_db:199,satisfacen:[93,140],setfil:[73,297],factori:[62,148,327,264,293,164,182,143,186],she:[332,58],"\u00fasalo":[245,145,211],peekal:386,consta:[245,362,8,190,277,182,346,166],encargan:[14,144],state:[329,178,141,187,154,294,181,85,327,347,244],migrat:[273,201,58,241,70,277,49,386,87],notari:[],herramienta:[61,239,268,1,20,93,166,135,247,7,8,121,211,9,331,10,144,236,199,84,104,180,152,64,341,158,200,289,14,108,204,16,71,72,161,346,186,65],f4a7b1f3:386,"\u00fasala":[343,161],interesado:[331,121],"impedir\u00e1":[],git:[239,0,138,163,20,92,2,383,39,375,271,191,26,213,248,240,7,215,121,142,358,33,174,61,177,145,384,273,231,224,189,199,221,124,151,11,363,65,152,337,289,201,261,69,265,46,72,313],mysqld:166,usermatch:19,abstractdoctrinebundl:70,gusta:[104,204,56],simplicidad:[331,305,293,312,218,186],prefijando:346,empezando:[349,145,47,215,161],synchron:[234,197],gusto:[288,363,2,121,46,60],captador:[247,187,138,338,57,163,375,93,99,334,278,72,54,166,135,49],turn:[292,342,347],place:[339,199,326,156,70,87,327,347,212],falsificado:[],imposs:[],origin:[268,261,383,351,80,375,166,167,322,193,342,138,99,60,33,221,384,331,84,149,363,226,389,14,67,390,339,297,186,347],"mostrar\u00e9":331,integrarlo:[72,342],your_subscriber_nam:293,"mostrar\u00e1":[50,206,269,241,242,166,291,214,28,249,250,122,359,33,123,38,64,310,387,183,185,290,257,338,204,295,79,186],arrai:[0,91,93,300,2,94,3,166,193,5,303,98,6,99,7,194,9,100,305,101,10,102,197,199,310,105,106,299,12,376,14,201,108,202,110,204,16,312,222,369,138,314,19,206,115,219,190,319,329,21,39,208,22,117,23,24,211,25,321,200,322,54,213,277,28,30,326,8,121,32,306,122,218,327,34,35,254,123,37,331,221,124,126,40,226,227,157,42,336,127,128,232,338,130,247,234,131,45,343,249,236,46,386,346,48,49,341,238,251,52,335,349,140,350,241,352,242,217,228,362,353,245,56,136,137,205,139,58,141,250,334,142,358,60,143,61,144,62,146,147,231,255,148,298,150,64,153,154,65,367,259,207,252,289,68,263,70,44,71,72,235,161,266,74,373,163,77,78,164,79,80,270,209,167,272,375,170,292,359,378,81,271,82,380,172,212,175,176,382,383,384,283,178,385,84,224,85,323,86,256,388,182,285,87,134,183,184,185,288,363,290,291,187,391,293,347,294,295,181,392,297,186],quisiera:[254,300,14,38,153,225,165],"desempe\u00f1ars":389,languagecod:224,procedimiento:[31,139,205],doctrine_phpcr_admin_bundle_odm_brows:86,documentclassmapperinterfac:41,prototype_nam:22,volcado:[363,384,341],predefin:[127,86],getalia:[175,153,319],unrecogn:350,"an\u00e1logo":286,given:[10,108,342,81,141,344,190,327],gif:[],excepto:[253,331,234,202,125,166,215,323,344,186],basada:[17,18,349,241,375,166,321,274,138,326,142,60,252,33,219,331,84,286,386,367,338,293,101,204],convention:87,white:[61,7],nonceexpiredexcept:62,basado:[240,19,349,77,93,209,243,321,27,331,325,99,191,204,219,62,319,273,255,199,84,11,365,66,213,202,70,159],suert:[331,139],"dejar\u00e1":314,permitem:182,myfoolisten:2,copi:[207,289],habers:186,specifi:[245,170,110,373,199,39,81,141,152,156,70,327,347,213],"fall\u00f3":[182,256],mantenimiento:[84,11,153,89,313,33],classmetadata:[50,373,208,269,93,79,80,352,190,376,54,3,95,291,250,324,123,263,99,195,32,122,60,254,36,38,126,333,105,155,185,128,183,12,112,45,187,391,297,257],suero:[],holder:[],acmedemoextens:319,"enumerar\u00e1":214,multilangrouteprovid:347,wide:[],myvalid:66,target_path:332,controlando:[322,337,213,92,377,344,25,186,319],ifnul:193,posix:[370,289],balanc:[363,384],sera:25,posit:[86,55,327],cifrado:[157,62],compilan:341,pre:[0,1,301,190,3,191,298,95,40,96,82,7,195,307,308,103,199,310,105,12,13,112,257,111,201,113,17,138,206,177,208,22,376,23,24,321,322,27,324,28,36,29,30,326,264,216,122,218,355,329,123,37,221,38,126,333,226,42,127,128,377,232,338,44,45,132,248,50,284,239,240,348,241,352,54,55,243,244,245,354,137,58,250,142,358,359,61,254,231,255,269,317,152,364,154,65,365,155,287,367,67,68,156,69,70,130,157,72,235,373,163,76,77,79,80,375,271,168,210,273,171,378,276,380,176,382,383,178,224,85,86,387,388,285,213,183,184,185,289,290,291,187,391,294,295,181,325],local_nam:326,consumida:331,"_local":[245,308,60,213,283,339,342,218,346],desempacado:121,pro:167,consumido:361,ani:[322,273,339,206,234,58,81,141,110,249,346,327],recuadro:[],almacenando:[337,319,197,18,331,189,362,77,59,265,157,6,166,48,25],style:[61,7,308,9],administra:[266,115],nombrada:[110,342,204,70],nombrado:[153,34,0,231],mostrart:[326,40,341],type_before_optim:319,sonata_block_include_javascript:77,"despl\u00e1zat":344,techniqu:194,moreov:261,enlazando:[344,342,204],cargarla:[179,343],ideal:[281,259,384,18,1,363,211],milisegundo:152,nameofthecooki:58,baseproductqueri:277,getentitynam:247,cargarlo:[322,8,41,23,252,166],surg:121,sutil:[228,60,234],sure:[322,169,234,58,81,141,326,194,87],intermedia:[176,331],isstateinvalid:187,replicar:343,multipli:[],interfier:386,fallo:[26,62,20,279,31,116,215,70,388,313,186,33,174],reservado:[153,112,264],micro:[],reservada:166,falla:[206,93,80,361,137,28,250,82,359,199,331,310,285,128,60,289,45,391,70,295,235,161],icon:[341,218,244],latex:[305,204],sethost:[346,90],later:[245,259,70,289,331,234,318,110,204,242,60,313,186,383],runtim:[],"ser\u00e1":[92,300,2,284,193,97,362,99,216,11,105,106,13,14,108,202,109,110,204,16,113,18,314,206,319,208,164,117,210,25,214,28,29,326,121,353,218,33,329,222,331,293,226,335,228,336,127,44,342,111,45,355,46,47,48,49,238,349,242,135,341,136,137,138,139,249,60,143,62,255,64,153,154,287,367,359,368,67,157,72,73,235,161,266,373,163,22,79,80,375,166,167,82,172,281,382,383,178,84,85,386,180,182,285,286,183,185,289,389,346,291,391,145,89,294,295,181,186],hombr:[178,72],recipi:[43,64,134],salida:[61,322,51,268,236,179,130,331,206,99,7,258,204,358,172,9,60,158,101,167],reproduzca:[329,294,178,85,154,204,181,121,362,167],permiso:[231,220,0,273,136,145,286,345,188,209],cheap:326,"tr\u00e1fico":[242,331],permiss:[136,119,209],hack:213,hace:[0,1,92,93,2,94,3,99,305,199,107,14,205,109,110,204,16,18,314,20,282,22,209,23,211,222,321,322,121,33,219,319,331,125,330,225,226,227,43,229,230,231,338,270,343,46,346,48,334,241,242,243,341,136,57,138,142,251,60,144,62,118,149,64,152,153,364,367,259,368,369,71,161,268,163,77,375,166,167,277,361,177,383,178,84,386,182,389,390,293,181,297,186],nuevament:139,simplecredenti:70,explicitli:[110,108,347,70],removida:47,databaseconfigur:193,requiresatleastoneel:193,indexado:[245,2,60,386],enfocan:218,throwexcept:141,desea:[91,93,300,2,94,193,5,97,6,99,7,121,305,198,199,286,200,13,257,202,109,204,313,113,19,206,115,190,208,22,23,211,222,119,28,29,30,8,216,327,33,328,329,35,226,127,232,338,44,341,234,343,344,355,46,346,48,238,52,242,56,136,137,58,250,358,359,61,144,254,148,149,64,363,154,367,259,207,369,67,157,158,73,370,235,266,74,342,76,166,146,82,277,167,176,178,84,85,179,388,285,287,153,293,89,294,295,181,297,186],satisfiesparentsecuritypolici:119,nombrecontrolador:341,webpath:266,terminando:166,analys:347,prueba:[61,1,20,349,241,23,166,211,196,26,171,136,326,356,31,99,7,194,121,357,361,100,33,174,10,144,383,35,189,64,179,151,182,43,229,230,128,338,313,341,270,343,344,158,237,371],getid:[176,74,146,247,338,202,327,207,194,386,357,277,166,161],ssl:[284,226,186,134],tailor:[],seudoelemento:240,entenderlo:[],abarcando:18,getip:366,nombre_paquet:[204,16],neither:[],referir:[56,260,331,150,77,204,167],mapper:338,tocarlo:161,getemail:[207,74],scopewideninginjectionexcept:[14,234,270],otra_funcion:103,carecen:20,metert:33,isnotmodifi:[331,375,138],removido:[287,13,247,47,97,216,355,22,127,113],routefilterinterfac:342,afirmacion:[],sonata_type_model:70,exceptionlisten:[293,332,139,383,211],"volvi\u00e9ndolo":[248,108,271],proxy_dir:[148,70,388],referirs:[346,222,204,18],fusionen:33,referenceblock:[245,77],probarla:343,parentdata:266,dirigida:[255,199],conscient:[338,119,331,166,153,2,120,277,336,252,159],dirigido:[1,25],"\u00edndice":[282,84,222,163,202,131,343,204,60,166,135],probarlo:161,callbackvalid:80,detect:[62,70,105],review:[313,273],impresionant:[277,135],"provisi\u00f3n":218,alternate_email:254,endtran:[60,344],dinero:206,gscorpio:[],fundament:[60,84,18],unicode_rout:[],requieren:[14,201,186,273,18],cycl:204,myformtypeextens:293,viert:319,arroba:[215,89],como:[268,0,91,1,189,92,93,300,2,238,190,298,4,193,5,96,332,240,98,6,99,7,251,388,9,100,305,10,308,102,273,199,104,349,11,277,310,106,299,278,14,201,108,202,109,110,111,16,312,313,112,222,15,256,18,158,19,206,20,282,318,207,281,22,117,23,386,211,25,321,26,322,323,213,214,28,29,30,31,326,8,121,353,32,118,218,204,33,219,220,329,35,254,37,331,311,124,293,223,126,354,330,40,226,157,42,336,127,43,229,230,128,232,338,44,247,234,131,270,343,236,137,46,345,328,47,48,49,341,51,52,348,335,267,350,241,351,228,242,362,135,56,136,57,138,139,58,134,314,142,358,60,143,248,319,61,144,62,63,147,231,115,149,150,64,152,153,154,257,212,337,66,367,259,368,260,252,289,67,68,304,70,339,71,72,73,235,161,266,74,315,162,342,163,76,77,164,253,79,80,165,375,271,269,146,272,210,359,166,82,380,148,172,167,280,175,176,177,383,384,283,284,178,385,84,85,86,180,188,182,285,286,183,184,288,363,389,346,90,391,145,89,294,295,181,392,297,186],escalabilidad:[1,18],coma:[288,331,206,350,363,388,295,359,313,33],separador:[4,177,193,323,346,353],come:[81,292,110,86,347,87],presav:277,"anfitri\u00f3n":[346,92],region:[308,218,294,18,137,28,329,85,224,110,154,70,339,293,60,346,342,367],quier:[0,1,92,93,2,4,40,96,302,362,99,7,305,10,199,277,200,14,108,202,109,110,204,16,15,18,314,145,382,22,117,23,211,322,213,119,29,326,121,218,33,331,221,125,335,228,127,231,232,338,131,282,343,46,346,49,50,238,41,349,351,242,56,136,248,205,60,269,150,64,363,337,366,367,70,157,73,371,266,76,77,166,167,210,271,380,172,177,383,84,182,390,187,293,89,186],cache_warm:293,quiet:[7,214],renderblock:362,menciona:102,haspermiss:[209,225],symfony__database__password:6,quien:[186,129],lengthvalid:122,color:[61,222,56,314,7,242,172,305],inspir:111,por:[0,375,91,1,189,92,93,300,2,238,190,3,191,166,4,193,96,332,303,97,98,6,99,7,215,388,216,9,305,101,10,307,308,102,197,273,199,311,104,349,11,298,105,310,106,107,299,200,13,14,201,108,202,327,109,110,111,16,312,313,112,113,347,222,15,256,18,314,19,206,20,177,318,207,281,21,208,22,117,23,24,211,25,26,322,54,213,214,28,123,29,31,326,8,121,243,32,306,122,218,204,33,355,219,328,329,35,254,36,37,124,331,221,38,293,157,126,354,330,40,226,227,41,286,228,337,127,158,230,128,232,287,338,44,247,234,131,45,282,343,132,249,133,137,46,345,353,371,47,380,48,49,341,51,52,335,74,140,350,241,351,352,242,362,135,376,56,136,57,138,139,58,134,250,334,142,251,60,143,248,319,61,144,62,361,146,231,255,115,339,149,150,64,317,152,153,364,154,257,185,66,366,258,367,259,368,260,252,369,67,263,264,69,304,70,130,71,72,73,370,235,161,266,203,315,268,342,163,76,77,78,164,346,253,79,270,209,167,272,210,170,225,274,359,389,271,82,344,148,172,278,280,175,176,382,383,384,283,284,178,84,85,179,323,86,180,387,188,182,240,285,277,118,88,288,363,290,297,291,390,90,187,145,89,294,295,181,392,386,205,186],period:[],rescat:161,acabar:60,hicist:[234,115],thousandssep:270,show_act:161,"p\u00e1salo":[343,167],suavizar:211,coupl:70,symfony_cmf_block:[326,246,197,77],"p\u00e1sala":[22,343],"revisi\u00f3n":[215,146,33,327],"_usernam":[98,186,58,25],"usar\u00e1":[148,298,167],addit:[197,199,108,293,194,86,70,181,87],url_safe_id:245,app_test:144,protocolo:[369,177,62,5,13,138,148,84,263,226,242,375,222],repons:[],acceden:102,pena:305,manager_nam:[23,367],esifragmentrender:293,estension:319,conocida:[14,84,11,2,277,166],getprocess:358,findal:[338,115,166],workspac:[199,326,70,349],cmf:[18,1,315,349,77,116,24,244,245,26,246,213,96,140,141,326,156,218,101,308,70,273,255,199,86,41,367,339,108,342,110,111,312,345,347],taggedservic:117,aqui:[],careful:[],irrelevant:[144,33],matter:[261,87],"case":[175,234,81,141,292,70,335,217,313,327,347,367],casa:[],desviars:[],entregu:343,caso:[0,1,93,354,2,238,4,193,82,362,99,9,306,115,273,277,107,299,200,14,201,202,109,110,204,40,18,314,19,206,20,219,22,23,211,25,326,121,353,33,222,37,331,293,224,330,225,334,335,42,229,231,337,129,338,341,342,131,270,343,236,46,47,51,351,54,135,247,136,139,60,252,61,144,253,128,148,256,153,366,367,359,70,72,73,161,266,268,77,62,80,375,166,167,98,172,175,281,382,383,284,178,84,386,388,182,289,187,145,181,392,297,186],casi:[240,351,375,166,25,23,213,138,99,8,360,331,84,260,14,202,131,109,16,346,186,161],traducir:[213,18,84,99,89,60],entrega:[14,367,129,383,134],twigo:230,configvalu:299,"situaci\u00f3n":[341,331,84,149,362,98,241,164,228,386,143],traduciendo:[26,372,316,93,99,89,60,313],"tensi\u00f3n":331,task_item:99,paramconverterinterfac:210,agrupan:[359,206,319,295],segurament:[121,283],setsubject:[9,43,64,134],usarla:[389,14,148,30,293,91,228,9,186],agrupar:222,"activar\u00e1n":297,abcdef:[232,375,127,138],"f\u00e1cil":[266,222,268,0,52,145,115,349,93,300,2,241,351,346,22,384,23,166,146,341,375,247,331,28,138,334,326,362,99,98,121,32,178,277,60,305,101,319,144,167,142,273,20,199,84,150,180,152,153,227,181,228,182,43,229,231,337,363,338,14,361,15,342,202,235,389,343,204,311,46,157,161,297,186,49],exponiendo:153,evento:[267,51,189,2,320,390,94,166,135,146,95,168,341,139,249,379,120,211,251,173,204,176,144,62,70,336,125,152,334,66,338,340,202,131,327,68,383,293,133,311,46,157,158,297,159,353],"replegar\u00e1":314,http_port:226,termsaccept:[207,74,54],acmehelloextens:[175,153],author:[50,1,163,269,93,190,80,352,22,209,54,135,263,250,60,219,34,254,178,331,221,38,333,105,155,128,12,112,261,45,187,391,293,70,181,392,257],annotationdirectoryload:[231,0],comparten:[341,144,238,56,148,331,335,388,107,226,204,305,293,252,186],configdirectori:299,content_object:141,html:[93,300,301,97,82,362,99,194,216,305,10,273,13,108,202,109,110,204,311,313,113,138,206,207,22,24,25,213,28,29,326,121,329,222,37,331,16,42,127,230,128,339,56,343,344,137,346,347,240,242,6,244,246,341,355,249,134,142,359,315,147,149,180,154,65,367,67,68,156,70,44,235,161,266,74,375,167,98,383,178,84,85,179,86,285,287,294,295,181,186],getauthor:[22,178],changepassword:3,eventu:[],dm1:388,document_root:169,persona:[281,222,129,18,136,331,84,362,286,89,345,242,188,9,47,72,167],derecho:[219,129,345,188,392,60],e_user_deprec:47,nest:[],friendsofsymfoni:217,driver:[193,338,148,388,115,349,131,6,78,326,16,277,166],getcrawl:343,driven:[],onkernelresponsepr:[46,2,336],unitaria:[136,31,343,229,357,158,237,182,33],"analizar\u00e1n":[],directric:[116,273],rewriterul:[205,87],ntext:30,file_inherit:145,searchindex:[131,70],mantenga:166,"depend\u00edan":8,ficticia:260,asumiremo:146,"fusi\u00f3n":[384,363,153,226,33,319],modifica:[341,144,383,337,222,99,331,16,390,92,109,121,351,105,242,297,211,167],ubicado:[230,121,204,167],colocamo:271,implementa:[341,349,2,383,23,211,384,245,193,247,139,121,353,308,62,319,37,331,363,386,334,289,108,70,46,157,186,49],without:[254,339,39,234,81,335,313,327,347],model:[74,200,140,77,207,110,277,182,3,161],formnovalid:99,eliminarla:298,nodelist:142,clob:[166,30],when:[273,350,2,8,375,25,322,169,170,58,81,141,326,194,358,217,327,254,197,39,87,339,108,234,131,292,156,293,70,313,347],"preguntar\u00e1":[314,33],proporcionado:[128,308,193,213,342,1,108,139,387,99,98,110,32,330,209,367,49],altament:[305,166,1,186,331,343,110,70,28,235,361],capturen:211,"desear\u00e1":[337,186,52],allow_add:[22,202],derecha:[172,166],string_funct:[303,148],ocasion:[238,283,52,331,332,102,335],gather:[347,327,33],"llamar\u00e1n":176,hint:[],adivinador:[],getmemori:[10,152],except:[51,239,0,268,314,219,350,62,39,94,211,384,322,247,136,139,141,98,358,327,10,144,102,222,199,221,256,363,335,228,66,231,259,289,14,341,234,383,68,320,293,204,311,157,158,297,186,347,251],apache2:[17,169,27,275],blog:[0,138,79,210,135,298,375,170,56,136,141,99,8,121,305,222,37,331,84,150,231,183,215,260,14,354,156,204,346,186,161],asumiendo:[10,277,98],pathnotexist:141,jong:[163,39],vulner:[331,215],onfooact:[46,2],round_halfeven:359,table_nam:162,"alc\u00e1nzano":145,raizweb:[],frameworkextrabundl:[307,323,222,56,37,346,341,305,354,8,121,16,242,42,210,297,166],dejan:[231,0,319],domxpath:[142,240],normalment:[0,268,145,20,77,78,300,23,272,193,98,172,60,328,383,204,147,331,299,182,367,231,184,260,14,108,202,343,110,70,186],tanta:[231,332,0],"patr\u00f3n":[0,282,242,2,99,164,166,56,248,250,60,143,305,219,177,383,222,331,84,354,225,226,334,367,14,341,186,385,204,46,346,159,161],phpcr_odm_imag:70,saniti:327,open_database_connect:161,getcont:[177,253,331,343,344,157],tratando:[228,121,186,229],suministrada:[231,102,0,256,66,346],ico:341,referenced_class:70,complejidad:[346,331,115,341],captadora:[338,166],node:[40,62,142,103,339,199,108,343,193,86,70,217,244,213],turco:89,cardschemevalid:376,evitando:[253,368,248,385,58,186,121,271],addsecuritylistenerfactori:62,redondea:359,"dot\u00e1ndot":[231,0],administrador:[219,222,247,389,331,110,89,199],enumerada:[272,286,60,344],allow_delet:[22,202],memorydatacollector:10,informant:215,nativeredissessionhandl:[],"transmisi\u00f3n":[375,138],hidratar:136,escribirla:[37,161],field_widget:[],escribirlo:[93,202],legal:[188,222,345],sugiera:[188,345],"coincidir\u00e1":[341,323,346,186,298],makepathrel:289,complic:[],nodo:[245,308,193,349,142,96,18,108,343,365,270,109,326,145,70,41,218,153,244],inscribirs:[],saludo:[341,238,121,335],processbuild:358,quit:[33,141],dicen:[305,166,135,16],addcont:142,item_1:70,"colaci\u00f3n":[],optimo:165,visualizador:211,comunicado:215,group_gener:70,earlier:[2,347],subsecuent:[98,60,346,368],fina:211,is_read:128,"intenci\u00f3n":[350,99,76,18],explicamo:[],getproduct:166,bundlenam:149,formtabl:167,stand:[],phpclass:180,error403:58,mergepasswordandsalt:102,error404:311,encriptado:207,traduccion:[351,26,18,342,108,149,356,110,293,89,341,60,174],settask:[99,202],punta:121,desarrollado:[110,18],compos:[306,239,0,375,138,163,20,349,92,2,383,241,21,23,24,271,191,265,213,96,341,248,240,326,356,7,8,121,211,142,358,217,218,101,61,177,145,384,273,231,255,199,39,124,152,179,86,65,182,367,224,184,337,363,338,289,201,15,342,389,110,69,16,46,339,72,161],determina:[206,118,2,383,22,210,243,319,295,57,28,139,362,99,82,60,175,329,226,294,178,84,85,310,154,285,230,359,112,311,235,204,137,46,181,346,186],instrumento:18,"ver\u00e1n":[22,389,282],hipertexto:[84,77],buffer_s:264,trabajado:322,setpar:[326,110,367],setrout:165,interfaz:[266,308,18,91,145,370,220,318,77,207,2,383,23,166,211,222,245,322,193,213,214,247,240,295,326,8,121,251,60,331,319,321,177,102,70,178,199,84,256,386,367,218,200,14,341,342,110,293,111,16,46,157,392,346,186,161],writeln:[61,51,35,268,314,7,172],strict:[147,341,234,68,190,66,392],getextens:[175,62],interfac:[61,267,18,189,350,301,210,361,96,7,326,10,236,383,70,225,386,200,342,131,111,157,392,370,347],dom:[15,202,343,142,22,159],besid:[],usernamepasswordtoken:[194,256],adivinast:204,omitida:14,treat:193,hard:[281,141],retry_connect:388,vivir:[161,222,341,49,153,343,8,204,23,167],regard:[108,347],upload_max_files:128,role_newsletter_admin:259,"\u00faltimo":[0,18,314,92,350,241,23,166,54,213,247,138,362,7,8,121,142,9,61,222,149,152,225,367,231,337,338,14,201,375,187,343,110,89,111,157,186,161],seguist:[326,121],obligarlo:98,faster:[],notat:[],notar:121,custom_typ:351,comienzan:[338,153,84,186,166],doc:[328,273,124,180,326,156,86,89,158,313,33],controllerclassmapp:[],"retroalimentaci\u00f3n":[104,33],isrequir:[193,39],routenam:81,veremo:[40,14,84,2,46,72,23,186],"determin\u00f3":383,quitan:[319,89,202],dcterm:213,intercept:[221,211,58,64],sanea:140,feliz:[11,211,161],driver_class:148,"redistribuci\u00f3n":129,repositorymethod:45,strongli:342,decpoint:270,intro:[110,346],firebug:211,posiblement:[74,138,19,206,300,2,383,351,326,22,117,375,166,211,25,193,341,136,137,28,268,98,82,121,357,358,277,359,33,62,361,236,283,178,293,310,153,285,337,368,14,15,312,202,235,343,145,204,295,46,73,346,186,48,49],himself:[],refiriendos:[],reutilizarlo:[242,222],quitar:[184,319,166,130,202,186,22,297,55,161],creado_at:135,incorrect:[],igu:245,intentaremo:[66,342],autoescap:68,levantar:[281,156],anfitriona:[158,388],mockfilesessionstorag:357,getrout:347,somehow:[],rdbm:[349,70,18],"alg\u00fana":1,integernod:193,suscribir:383,sethead:34,fakenam:80,symbol:206,getalnum:[375,138],busquen:18,briefli:[],grupo:[18,145,92,93,23,166,322,40,247,99,60,10,382,152,386,388,350,310,337,289,338,89,204,181,186],plenament:[392,161,35,146,186],loadgroupdata:23,fos_rest:213,normalizerinterfac:293,curva:[158,211,240],decirl:[247,205,389,14,84,104,202,131,99,2,46,164,60,143,166,167],session_id:[357,386,30],chown:289,oportunidad:[4,319,281,99,182,49,55,211,161],potenti:[81,87],routeawareinterfac:[342,141,326,110,111,347],invoic:200,peligroso:204,all:[239,375,162,75,349,93,208,165,141,212,245,322,169,273,138,58,81,6,326,8,217,327,308,39,197,199,84,310,86,87,313,112,261,131,70,339,386,47,347],dist:[337,199,145,92,179,343,158,371],minlengthvalid:79,transformador:[99,182,189,280,228],enablephppars:363,separar:[200,221,202,166,8,65,158,186],scalar:[193,352],separan:14,lookupmethod:278,abil:[],dejamo:[],follow:[239,261,273,93,25,245,213,137,28,141,326,194,327,254,197,199,86,156,339,234,110,347,70,313,342],alt:[142,130,331,318,343,226,204],tarro:[],admin_bundle_menu_menuitem_cr:[],actualizac:364,rssblock:[246,140,197,77],personal_email:254,compra:18,ejemplar:[73,268],init:[245,337,213,273,136,199,349,141,326,70],program:221,dibujado:[310,232,76,213,266],dibujada:[22,266,300],"2xx":343,hasparamet:212,existir:14,colapsando:244,libertad:[222,204,345,188,166,49],liter:[0,1,301,190,3,191,298,95,40,96,82,7,195,307,308,103,199,310,105,12,13,112,257,201,113,17,138,206,177,208,22,376,23,24,321,322,27,324,28,36,29,30,326,264,216,122,218,355,329,123,37,221,38,126,333,226,42,127,128,377,232,338,44,45,132,248,50,284,239,240,348,241,352,54,55,243,244,245,354,137,58,250,142,358,359,61,254,231,255,269,317,152,363,364,154,65,365,155,287,367,67,68,156,69,70,130,157,72,235,373,163,76,77,79,80,375,271,168,210,273,171,378,276,380,176,382,383,178,224,85,86,387,388,285,213,183,184,185,288,289,290,291,187,391,294,295,181,325],filtrar:[177,138,342,286,142,375],lanzado:[382,383,139,219,11,2,46,211],far:[],reflectionclass:221,adjuntar:[138,375,18],ejecut:[61,176,383,222,138,260,346,145,7,368,338,2,364,293,46,343,375,252,166,211],failur:[],some_package_nam:[],unoffici:217,ticket:[281,313,33],getacceptablecontenttyp:375,informando:[372,151,31,215,241,313],compilando:[4,282,319,14,385,335,159,212],despachador:[383,146,336,189,139,327,379,338,2,120,334,46,158,159,211],treeaction:245,cuestion:[313,47,33],setsynthet:234,list:[368,246,204,214,247,339,108,273,141,301,70,22,92,327,347,161],fusionar:[193,287,129,13,355,97,153,319,216,127,33,113],dirigir:161,fusionan:[153,328,193],usersecurityident:[136,286],inacabada:364,"supondr\u00e1":92,selectora:240,minmessag:[123,290,373,387,190,122],poblado:[121,341],coloridament:152,jsoncont:72,tag1:202,ten:[222,0,18,294,145,77,350,242,2,346,22,117,362,166,167,375,213,96,341,119,138,30,99,82,121,32,277,60,33,175,313,177,329,204,270,178,331,180,85,153,154,181,228,231,278,179,338,130,234,202,90,389,343,110,70,46,157,73,205,186,342,161],esfuerzo:[18,331,84,202,16,22,277,186,167],syslog:[176,264],basura:[237,226,49],therefor:[339,194,273,81,87],design:[292,141,87],resaltado:180,brillo:62,rato:273,hasarg:[],what:[245,314,339,261,58,141,153,326,217,218,327,347,87],hospedando:[],"cl\u00e1sico":[37,204],usamo:[9,341],heredada:[206,355,22,137,28,97,29,82,216,359,329,178,85,310,154,105,287,285,232,13,44,67,294,295,181,235,113],version:[268,298,18,294,206,115,355,92,93,300,319,309,241,21,329,346,270,166,135,212,323,5,214,341,287,137,28,97,249,29,82,8,216,32,81,217,9,60,33,313,145,226,204,147,231,178,331,339,124,85,11,153,359,154,277,106,127,285,213,224,259,12,215,13,283,44,112,15,67,388,131,235,337,70,295,181,90,47,186,347,113],base_form_widget_simpl:167,modelado:213,short_bio:254,path_provid:141,"a\u00f1adi\u00e9ndolo":[255,349,86,24,101,367],interaccion:182,comprobado:[153,367],generatedvalu:[74,247,241,297,166,135],detectado:353,varnish:[197,331,189,318,59,242,161],exponenci:[363,288],eficacia:[],repositoryfactoryjackrabbit:70,assets_vers:[322,226,204,16],dedicado:[99,341,313,33,277],"edici\u00f3n":[1,145,349,77,383,241,114,242,23,24,211,26,322,213,341,136,98,8,121,218,101,176,315,35,273,255,199,125,11,259,227,92,184,337,389,202,343,344,16],dedicada:[255,331,89,277,392,313,186,161],goodby:175,optionn:[],contactprocess:346,event_listen:[338,249,131,68,293,70,251,157,66],instruccion:[315,92,30,275,167,96,341,166,7,121,331,61,281,145,197,255,199,367,337,342,110,111,186,347],inversa:[331,72,135,101],evitan:186,"dirigi\u00f3":25,db_password:[349,70],evitar:[177,318,300,106,242,271,193,247,248,166,60,252,33,382,222,283,37,331,332,104,40,386,388,228,66,367,389,313,343,293,70,297,186,48],"introducir\u00e1":[],miniatura:18,incrementa:[7,202],graph:292,mysql_queri:161,magnitud:177,requestcontext:[231,383,346,0],"extra\u00eddo":[338,145,375,166],recentlist:204,texto:[266,349,18,294,206,345,242,329,22,287,167,213,214,137,28,97,7,99,82,216,142,172,60,305,355,61,145,222,178,331,84,180,85,153,359,154,65,188,228,240,285,184,88,13,235,109,343,344,204,295,181,161,313,186,113],precalentamiento:293,"administraci\u00f3n":[245,367,145,111,96,18,110,1,84,77,331,8,86,70,218,199,347,213],empezast:326,serializador:[189,159],verificado:219,vital:111,transformando:139,inyect:[91,293,367],indefinido:193,"filosof\u00eda":[322,341,338,1,84,204,277,60,166,161],provocar:166,testedtyp:182,coverag:[179,343],origen:[331,33],trabaja:[18,91,115,166,193,213,56,134,215,251,277,9,60,305,33,177,383,222,104,151,367,338,342,109,343,110,70,297,186],"reintentar\u00e1n":388,createview:[74,207,202,93,99,182,297],provocan:[14,33],titulo:57,page_id:312,fueran:[193,8,241,235],trabajo:[51,268,18,1,145,20,308,93,284,241,371,375,386,166,135,319,345,322,265,341,331,138,139,362,99,7,121,211,357,277,173,305,33,61,177,383,204,197,189,199,84,150,349,11,153,364,226,188,259,260,14,108,342,202,159,385,338,343,89,70,252,328,71,161,186,48,49],form_table_layout:167,"vi\u00e9ndos":22,muestren:[193,80,56],abspath:180,mira:[144,383,213,338,77,326,380],flag:322,articledetail:204,known:[322,332,87],aprovechado:99,reconstruida:138,anticipadament:330,abordaremo:331,access_gr:[219,392],terminableinterfac:383,orderbi:[181,166],hasser:[99,163],pero:[0,91,1,92,93,300,2,284,190,3,193,5,96,362,99,7,100,305,10,115,102,199,286,277,200,14,112,108,202,109,110,204,16,313,256,18,206,20,177,318,22,117,23,211,319,322,323,213,28,30,8,121,243,306,218,33,219,329,222,37,331,293,226,334,71,228,127,128,232,129,338,130,247,234,131,343,344,248,46,345,353,47,347,341,238,240,335,349,140,242,135,56,136,137,138,58,142,60,61,144,62,361,254,231,148,149,64,153,154,337,367,359,368,68,69,70,157,158,235,161,266,74,342,76,77,375,271,167,272,210,166,98,380,172,278,176,382,383,384,283,84,85,180,388,182,310,118,184,288,363,389,346,187,145,294,295,188,297,186],abstracttypeextens:[266,293],iniciar:[281,383,337,330,376,247,260,331,145,202,166,121,89,70,357,293,209,186,33,161],asset_url:[71,322,40,130],cacheabl:197,phpcrodm_mov:[245,86],ponl:293,azul:[11,325],inician:[383,149,180],inicial:[386,23,337,273],pone:[272,375,213,18,331,84,202,110,8,142,312,157,182,367,346,383,222],setcatchexcept:268,mostramo:[238,93,293,335,181,370],"cronol\u00f3gicament":[],content_basepath:[110,317,96,367],csrf_provid:[76,58],concept:[339,347],recursiva:[299,109,289,18],cours:[197,39,234,81,141,156,375,87],goal:[281,339,342,141],authenticationentrypointinterfac:139,divid:[11,99,331,247],rather:[213,327,351,70,271,212],divin:34,renuncia:[188,345],"despublicaci\u00f3n":111,reconstruir:14,resourc:[0,93,354,190,3,95,40,362,99,195,305,101,102,197,198,105,106,299,12,14,257,202,204,16,112,19,207,319,208,376,211,212,322,54,213,324,36,326,8,121,353,32,122,328,332,222,123,38,311,124,224,333,226,41,231,338,130,341,234,111,45,343,346,50,238,349,241,351,352,242,6,135,245,56,248,58,250,60,143,144,62,254,128,149,153,155,259,68,263,156,70,339,71,158,126,161,266,74,373,269,79,80,270,166,167,273,81,98,277,25,177,86,387,388,183,185,290,291,187,391,293,392,297,186],decidimo:[],reflect:[322,221],catalog:[],cambiaron:228,lidiar:211,jmsserializerbundl:[292,213,101],quitando:22,incapac:369,"short":[290,122,79,254,387],datatransform:[228,359,295],postfix:326,recuperamo:312,dentro:[0,93,300,2,193,97,99,7,216,305,101,306,200,13,14,202,109,204,311,113,18,314,206,164,23,211,35,322,213,29,326,8,121,33,329,222,331,40,231,129,338,44,56,342,131,344,46,346,350,241,341,136,355,142,60,143,144,62,146,149,150,153,154,259,260,67,70,158,73,77,22,166,167,359,82,277,175,383,283,178,84,85,386,388,184,287,288,363,389,186,145,294,295,181,90],callback:[314,339,75,327,93,80,190,336,166,135],cmf_prev:308,concretament:383,"motivaci\u00f3n":270,incapaz:[342,105],comproeba:136,"multiprop\u00f3sito":178,knpmenu:108,anonymous:327,phprc:[],mission:[],satisfactoriament:[310,228,98,391],role_no_access:186,multilang:[347,218,317,96],member:[382,264],desconectado:166,recib:[98,176,331,166,19,139,140,256,362,286,299,2,293,226,142,46,157,186,251],setprogresschar:[],getstatuscod:[251,343,253,383],instruir:[331,319],lang:240,emparejando:[210,186,211],servicio:[91,189,93,284,4,96,302,6,99,9,10,308,102,197,286,106,278,14,110,204,312,17,20,328,319,164,117,23,211,222,26,322,213,119,326,8,32,218,220,35,221,124,125,330,225,226,223,41,228,336,72,316,338,340,354,234,131,270,343,249,47,238,52,335,140,351,242,362,353,341,248,268,58,356,134,251,60,252,360,144,62,63,166,148,150,153,66,366,258,367,259,260,143,68,70,157,158,73,159,161,266,162,77,78,80,165,275,168,210,271,98,277,83,280,176,282,383,283,385,388,182,184,346,186,293,296,392,90],might:[194,239,170,261,234,58,141,326,156,375,327,347,87],alter:166,validadora:32,"postactualizaci\u00f3n":145,consecuencia:[297,331,211,202,204],"return":[0,93,300,2,94,298,193,5,362,99,9,305,10,102,197,105,106,299,200,311,202,110,204,16,312,313,332,314,207,22,117,23,211,319,323,213,119,8,121,32,306,327,221,222,37,331,39,228,336,43,231,338,233,247,131,270,343,236,46,346,341,350,42,242,54,353,244,245,246,56,140,141,142,251,60,143,61,62,146,128,149,64,153,66,366,252,70,157,72,161,266,74,268,163,77,164,45,166,170,81,380,277,176,177,383,283,84,182,87,134,390,187,293,181,392,297,186,190],puent:[99,15,293],mezclando:[163,378],declararla:266,"protecci\u00f3n":[99,62,259,344],framework:[1,145,93,211,167,26,56,81,30,99,8,121,218,144,37,331,153,226,60,14,341,292,343,304,204,16,346],fallido:[58,25],responselisten:[293,211],aclarar:84,ausencia:[22,8,254],bigger:[],administr:[108,347,247],comprim:331,"da\u00f1o":[129,204],pedido:[197,18],pregunta:[61,230,118,62,346,214,153,314,57,331,342,99,7,89,321,313,166,243,161],getdefault:[154,294,85],sandboxmagnoliabundl:70,innodb:[135,30],mastercard:376,unicod:[363,154,288],admin_class:[86,317,96],gui:[],incidencia:228,tentador:60,needless:313,requestaccessevalu:366,addlisten:[46,94,2,51,139],expect:[281,62,254,197,137,28,131,110,86,70,105,347],entorno:[18,19,20,328,30,275,211,361,322,213,341,268,6,31,8,121,353,331,33,306,176,144,383,166,189,199,104,64,226,151,87,184,368,260,14,389,343,293,204,16,90,371],geterroroutput:[358,268],"posici\u00f3n":[0,206,22,383,242,210,166,56,137,28,82,121,142,60,305,281,282,62,222,197,310,354,106,285,231,359,341,202,295,346,235,160],matriz:[61,238,0,138,290,338,46],custom_match:211,"a\u00f1adido":[375,213,138,136,331,124,358,99,334,22,210],significa:[247,222,238,0,18,314,91,388,177,92,341,2,331,323,80,346,22,384,270,211,167,322,193,273,56,136,137,28,268,139,98,362,99,7,8,121,60,305,33,319,61,382,161,204,254,199,256,310,153,259,226,383,335,228,336,219,231,184,200,129,363,14,108,342,202,131,90,343,351,337,111,16,46,386,73,297,186,48,49],"desautenticar\u00e1":186,call_user_func:[46,2],etag:[331,375,138],"regi\u00f3n":[218,283,96,36,294,206,342,317,224,359,154,111,295,60,346,159,383],regenera:386,configuracion:[175,144,96,349,153,8,226,70,293,60],discreta:200,activarla:[37,331,204],"peque\u00f1o":[10,175,322,222,18,136,268,350,99,364,260,111,105,242,341,186],isempti:47,iterator_to_arrai:[177,180],symfony_cmf_bundle_menubundle_document_menunod:245,advanc:[169,319,108,81,364,83,347],tmp_name:[],"peque\u00f1a":[218,341,84,7,383,121,204,105,293,161,167],comunicar:[331,390],adivina:[],comunican:331,obra:[188,345],symfony_cmf_menu:[108,96],foobundl:[165,351],thrown:[51,358,221,39],includecssfil:213,introducida:[207,74,250],introducido:[93,98,371,375,138],perhap:[],deja:[314,206,355,97,29,362,99,82,216,359,329,319,198,178,84,85,154,127,287,13,44,67,45,294,295,181,113],sessin:[],session_nam:[386,357],taskbundl:[99,202,228],feed:[246,156,140,77],inventario:[14,254,18],notifi:[],persistencia:[18,338,84,202,186,99,277,166],repetitivo:62,feel:202,defecto:[297,18],ciento:18,esperamo:213,auto_generate_hydrator_class:388,tuvieran:136,remember_me_awar:293,construct:[],blank:[254,269,257,75,38,81,45,93,87],fanci:[242,305,222,56],gpl:129,collat:[224,326,166,135],progit:33,script:[245,213,322,40,204,199,15,202,226,70,22,71,244,101,87],"duplic\u00e1ndolo":283,interact:[230,57,118,243,214],visibilidad:11,pagar:337,reentrant:[363,384],enable_annot:[93,226,16],getperiod:152,detenga:[46,2,64],anonymoustoken:219,addtaglink:202,store:[194,273,197,266,339,108,261,58,2,110,347,46,336,297,342],luckili:327,actualizando:[337,338,145,92,277,166],"ten\u00eda":[84,344],checklist:313,silex:383,attchment:67,ignorerol:308,"prep\u00e1rat":84,gethistori:343,getargu:[61,282,383,35,268,7,334,94,211],is_arrai:157,language_fallback:212,unsupporteduserexcept:[102,247],simplist:[],metodo:94,whenev:[358,261,234,81,339],remot:33,remov:[245,327,375,197,138,166,289,247,202,186,338,386,70,335,60,47,3],dant:34,viaj:[84,70],cost:58,endspaceless:[266,99,167,362],blog_comment_post_id_idx:135,acoplan:60,stale:331,"preparar\u00e1":368,puntero:121,"suscripci\u00f3n":383,cleaner:194,saberlo:99,well:[213,375,70,349,141,110,80,181,212,271,87],"negociaci\u00f3n":342,testchildtyp:182,"etiqu\u00e9tala":293,garfield:342,expir:[307,62,138,37,331,150,375],dedic:[],importa:[138,241,351,375,166,167,341,6,99,121,144,383,222,331,84,363,226,184,288,338,354,346,186],microplataforma:383,query_build:[181,327],"etiqu\u00e9talo":[157,293,228],poner:[18,314,349,77,346,167,245,283,136,58,99,326,60,383,222,273,331,84,225,226,106,182,127,392,367,70,14,342,110,293,204,386,364,313,186],"_list":230,remote_addr:144,violat:254,configurador:[385,252,159,273],dynamic_rout:[255,110,96,367],ponerlo:[23,367],testedtypetest:182,clearxxx:47,piens:33,postdelet:277,ponerla:[],ponen:[342,305],vulnerabilidad:[215,204],nivel:[18,1,115,328,98,78,384,166,211,167,193,56,119,58,99,7,142,60,327,33,219,176,382,146,331,153,364,226,392,258,288,363,338,130,341,202,385,204,14,158,90,161],fresca:[328,19,331,326],sonata_admin_dashboard:339,"col\u00f3quelo":[],cargo:[322,28,343,60,297,186,48],httpfoundat:[266,74,239,0,332,138,234,219,93,207,383,210,166,211,272,375,341,205,139,30,99,121,357,251,277,9,60,176,144,62,222,231,331,84,104,256,386,105,107,128,338,297,67,202,159,343,344,204,16,49,237,186,161],copia:[144,337,129,18,389,124,199,221,20,180,92,99,8,351,89,204,166,33,167],fresco:[99,331],apacheurlmatch:[180,205],check_login_on_serv:70,jsp:349,suprimir:[214,49],messageparamet:[],getfilecont:70,amaz:60,"lim\u00edtat":350,swiftmailerbundl:[284,103,341,14,64,134,383,293,16,43,48],heredamo:[],tagattribut:117,capturada:[311,211,268],enrutarla:331,coinciden:[138,338,331,186,310,343,8,312,277,375,346,166],inicializa:[],pars:[322,193,384,81,299,363],retrasa:330,affect:[],credencial:[62,247,139,349,256,6,98,227,186],encaminada:341,getcod:[251,268],"4_no_r":112,autocargador:[389,201,341,343,16],cdn:[226,20],superar:[23,386],compound:[109,167],delimitador:[350,177,60,305],acmeproductbundl:[],mergedopt:350,publicada:11,fusionars:226,stopimmediatepropag:245,publicado:[281,308,215],coloreada:368,optimizado:[61,144,341,260,104,7,121],filevalid:[128,105],"_format":[242,346,204,367],camel:[],optimizada:349,customerem:115,modificando:[144,102,14,220,153,326],iec:177,symfonycomponenthttpkernellogloggerinterfac:[],"atr\u00e1":[350,146,137,331,11,153,204,346,47,327,33],hablando:[56,331,84,234,318,121,305],affirm:[392,219,58],hit:[],identificada:[281,161],routerinterfac:[110,342,211],previousal:[343,142],identificado:[281,219,84,342,2,46,243],"se\u00f1alar":[238,335],imaginaria:[14,346,146],handler_id:[226,30],verla:[93,338,60,186,166],proces:[338,14,166],emailfield:22,tratamiento:[213,142,311],escriben:357,type_remov:319,dejarlo:204,localizedd:293,nacion:58,desplegando:[189,20],"depuraci\u00f3n":[239,19,189,328,384,166,211,319,322,171,55,121,10,144,383,222,148,331,104,64,363,368,260,377,343,389,204,16,71],certif:[],is_subclass_of:247,dump:[306,341,322,70,273,363,389,199,205,20,153,204,217,384,319],"fusionar\u00e1":331,thenunset:193,audiencia:1,"compilaci\u00f3n":[322,238,319,385,328,270,40],progresshelp:364,yuo:[],ara:49,fabpot:[],arg:[131,161],disadvantag:[347,141],extenderla:222,horizont:313,file_link:344,regresar:[272,383,142,314,342,331,84,139,249,256,110,236,312,42,166,319],mt_rand:[297,289],nombre_de_usuario:[277,166],consistencia:222,difusa:18,symfonycmfmenubundl:[255,70],templatenamepars:65,setetag:[331,375,138],resourcenotfoundexcept:[231,342,0],alighieri:34,treattruelik:193,comprobando:[259,136,318,153,204,190,157,186],veredicto:219,sole:342,"porqu\u00e9":[312,186,204],remitir:331,sola:[341,284,0,18,145,92,320,241,242,375,166,135,167,322,247,138,99,7,8,121,251,277,60,33,312,231,337,260,14,108,202,45,236,46,181,73,346,159],lanzaba:289,succeed:242,solucionar:[231,337,0,145,202,186,121,16,90,161],solv:245,isfresh:[19,319],redireccion:[110,342,222,211,367],satisfi:[],getmanag:[207,136,115,202,99,338,297,166,229,161],considerar:[146,18,91,331,152,32,190],asunto:[94,221,43,33,18],notnam:177,loggingpointcut:221,assertinstanceof:43,paradigma:[46,2,386],desarrollarlo:337,consideran:[263,328,319],brevedad:200,addsubscriberservic:336,generalment:[18,234,115,109,166,322,193,341,99,8,144,383,222,256,310,153,225,260,342,338,73,49],cierto:[144,193,167,153,220,221,202,109,98,383,121,204,105,343,161,305,33,49],mostraremo:[331,204],sujeto:129,hablaremo:136,operacional:147,setag:72,tgz:145,utf8_general_ci:[326,166],cierta:[0,268,165,166,211,254,272,341,6,99,98,167,219,383,222,148,84,152,153,105,231,342,343,204,157,346],detal:[284,315,0,18,145,20,349,77,78,190,319,383,22,117,134,166,167,255,322,247,136,28,240,58,362,99,326,121,251,60,331,33,176,328,102,222,37,199,84,64,153,225,226,285,367,231,338,313,341,234,343,110,204,369,71,364,297,186,49],mistak:313,verbosity_norm:7,versionado:[26,309,18,349,11,174],java:[322,103,199,16,349,217,71],due:[99,28,137],whom:327,capacita:110,variedad:[338,28,145,389,293,190,386,166,167],treatnulllik:193,leftjoin:247,gettransportchainservic:353,symfony_cmf_cr:[213,101],strategi:[219,74,349,247,293,108,342,58,141,110,86,347,241,392,297,166,135],marcadp:167,menssag:293,"divi\u00e9rtet":15,auxiliar:[222,204],geten:77,cinco:[61,62,247,28,286,7,285,243],marcada:[44,300,98,142,47,107],bundle_dir:153,demand:[],ipvalid:112,marcado:[341,259,384,197,363,108,180,99,89,204,117,73,313,167],birthdai:[99,333,88,142,137],introspecciona:213,interactividad:368,vertida:[328,319],secondstringfunct:303,solucionarlo:14,hablado:16,abierta:[279,49],behavior:[206,355,245,170,137,28,97,29,141,82,216,359,329,178,85,154,127,285,87,287,13,44,67,294,295,181,235,113],acuerdo:[177,193,129,363,331,288,328,362,99,343,311,60,49],certificado:[242,69,186],abierto:[350,341,389,1,150,318,11,204,345,49,186,161],session_request:176,espacio:[294,189,349,350,2,389,386,166,222,321,214,341,355,97,326,30,99,7,8,216,178,172,204,101,319,61,329,226,63,147,37,148,199,221,124,85,153,154,388,127,107,118,287,288,13,363,260,201,354,338,33,70,46,181,158,49,313,113],setttl:[375,138],mostrando:[99,166,64],ajustado:186,ajustada:380,"da\u00f1ar":33,block_id:197,objectinitializerinterfac:293,minim:70,"pr\u00e1ctico":[386,331,293,227],coffeescript:[322,40,213],fueron:[102,215,273,18,338,315,64,110,358],simplificado:[315,305,273],viola:60,sqlite3:[],"asincr\u00f3nicament":204,layout_default:34,importando:[102,14,249,362,153,392,346],higher:[2,213],testcreatesearchbynamequerybuild:[],x86:71,symfony_cmf_routing_auto:141,indirectament:93,descargarlo:161,vaciar:[61,341,130,20,7,8,204,16,90,371],robust:[],"categor\u00eda":[176,118,152,99,326,215,277,158,166],apreciar:8,subpackag:350,stateless:[58,186],lower:[],pendient:[213,11,99,121,70,33],cualquiernombr:58,"l\u00eddere":1,getusernam:[102,247,221,62,204,209,186],"m\u00e1scara":[136,286],writemetadata:41,transformado:99,nodevalu:142,propos:70,"depender\u00e1":16,referenciar:18,endwhil:161,getplainpassword:74,"especif\u00edca":346,resolverlo:186,reemplac:200,cubierto:[99,297],intervalo:[331,60,48],reemplaz:[],setfilt:[238,335],comunica:84,"t\u00e9cnica":[93,136,201,158,153],addcachecontroldirect:331,also:[239,261,206,273,22,375,271,212,322,246,213,81,141,358,217,367,327,306,163,70,197,199,39,169,226,335,87,339,108,234,131,270,292,110,111,313,347],revert:[],"t\u00e9cnico":[136,20],block_rss:246,suelen:[175,228,343,300],multilenguaj:70,arriba:[18,349,92,93,383,241,22,23,272,168,193,136,248,362,99,142,9,359,62,256,286,179,310,259,337,108,202,68,110,70,346],relativament:[338,331,20,99,277,218,166,49],"abstracci\u00f3n":[70,222,331,78,241,111,277,211,161],adivinando:[],imprimirla:7,prominent:1,estandarizada:241,"estrat\u00e9gia":5,finder:[179,177,15,107,159],vendor:[145,20,349,92,241,23,211,213,341,311,326,8,121,217,306,147,148,221,124,179,388,337,260,201,15,389,16,161],xss:[226,204],saltart:[99,326],base_field_widget:[],admin_bundle_content_multilangstaticcontent_edit:86,form_nam:343,"r\u00e1pidament":[0,18,92,167,26,341,99,326,8,121,277,331,33,144,383,255,199,84,386,231,184,337,156,204,16],volver:[220,319,205,389,84,166,99,98,204,388,161,186,33,167],asoci:[],insert:[277,246,140,166],jsonformatt:176,"_method":[346,83,226,0,298],conectast:346,acmehellobundl:[181,222,56,14,341,153,8,388,148,106,158,346],redefiniendo:[306,167],getextra:218,docutil:[0,1,301,190,3,191,298,95,40,96,82,7,195,307,308,103,199,310,105,12,13,112,257,201,113,17,138,206,177,208,22,376,23,24,321,322,27,324,28,36,29,30,326,264,216,122,218,355,329,123,37,221,38,126,333,226,42,127,128,377,232,338,44,45,132,248,50,284,239,240,348,241,352,54,55,243,244,245,354,137,58,250,142,358,359,61,254,231,255,269,317,152,364,154,65,365,155,287,367,67,68,156,69,70,130,157,72,235,373,163,76,77,79,80,375,271,168,210,273,171,378,276,380,176,382,383,178,224,85,86,387,388,285,213,183,184,185,289,290,291,187,391,294,295,181,325],relajadament:244,parentpag:[326,246,77],recuperast:[338,99,166,351],limpiarlo:226,collect:[222,0,205,373,75,93,207,22,30,166,211,212,323,5,247,81,362,99,8,60,10,70,254,84,298,226,181,106,231,88,300,283,341,202,290,293,204,312,157,392,346,186,49],ignora:[343,177,308],revelan:111,verbosity_quiet:7,barbundl:[],uniendo:166,tareabundl:[],private_head:331,blockbundl:[245,197,255,1,140,77,326,86,325],visibl:[314,156,315,186,273],reescribir:[331,273,211],"recolecci\u00f3n":[10,383,368,226,237,49],conciso:[37,42,121,346],understood:141,sessionhandlerproxi:49,separando:18,personalizacion:[99,280,167],productrepositorytest:[],infieren:99,tato:[],"terminar\u00e1":90,equivocadament:331,acortar:[11,186,341],desagrad:161,fragmento:[266,314,76,77,21,167,56,136,362,99,305,280,331,124,180,153,226,343,293,204,157,49],datosdelperfil:254,prop:70,prod:[306,176,144,205,260,14,199,268,20,322,64,331,368,204,16,328,341,161,166,48,87],clavesegura:14,roto:179,asombrosa:84,"mejorar\u00e1":389,ymfoni:[],pago:[126,376],viabl:166,revuelv:186,"cu\u00e1nta":[61,281,7,166],magnolia_pass:70,anterioridad:25,"cu\u00e1nto":[22,259,346,202,64],"saltar\u00e1":139,nueva:[0,92,300,2,3,362,99,7,305,273,11,105,200,202,109,204,311,312,313,18,145,20,21,22,376,211,321,27,326,215,121,32,33,319,331,124,126,226,228,231,337,338,341,234,343,46,346,49,350,241,135,247,57,205,142,358,60,61,62,180,152,153,367,70,157,161,266,372,268,163,80,375,166,167,274,277,280,282,383,84,179,386,310,389,293,186],innecesario:[200,20],plazo:[11,49],acme_post:243,utilizarla:[266,322,193,331,84,342,93,99,241,70,117,182],utilizarlo:[62,222,273,341,14,15,342,99,2,380,319,46,182,167,166,161],prove:[277,193,77],symfony1:[157,8,189],symfony2:[298,1,189,92,93,2,284,281,6,99,7,9,305,10,115,273,199,311,286,222,106,107,14,201,108,110,204,16,313,17,15,18,314,145,20,318,116,164,23,211,25,321,26,27,30,31,326,8,121,32,218,33,328,35,37,331,221,125,330,225,226,335,43,316,337,129,338,341,342,111,343,344,319,46,345,47,48,49,238,349,350,351,242,353,246,56,136,138,58,134,64,357,60,143,61,144,62,346,147,255,148,150,180,363,66,367,259,260,304,70,265,157,158,370,159,161,203,315,372,75,77,78,375,166,361,272,168,277,176,383,384,84,179,386,151,296,87,184,88,153,389,297,293,89,188,392,205,186],"est\u00e1tico":[111,363,260,331,341,317,286,99,2,225,80,16,46,60,252,204,384],realli:[217,218,81],dialog:[61,314],"corregir\u00e1":161,rango:[177,293,112,105],setenabledformatt:252,"est\u00e1tica":[63,300,331,342,190,2,80,46,222],configurarlo:[319,273,138,338,349,125,99,375],round_ceil:[359,295],getroutekei:342,maxmessag:[254,123,290,373,387,190,122],"sistem\u00e1ticament":166,simplexmlel:[180,240],forzado:140,resalta:346,pintado:[22,109,344,362],"sumar\u00e1n":78,announc:[],disable_authent:162,canal:[176,281,20,125,31,116,293,133,186],dialoghelp:314,francesa:60,inputdefinit:236,question:[61,314,7],"long":[183,254,290,58,11,387,352,358,122],deferred_implicit:135,desconectar:184,my_foo:234,getendtim:152,dependencyextens:153,fields_error:[],getrespons:[253,343,2,194,46,157,211],fase:11,recorreremo:338,foreignt:277,selectbutton:[343,142],accediendo:[268,222,138,199,163,78,343,142,375,211],habilitarlo:[255,218,186,96,367],desarrollador:[18,1,20,92,116,166,26,341,240,99,121,60,175,281,383,222,255,331,84,11,153,226,337,260,14,2,110,311,46,161],"restricci\u00f3n":[50,373,75,189,349,93,374,79,80,352,190,376,54,208,3,135,99,32,122,60,254,123,269,38,126,105,66,127,128,183,185,129,290,257,234,45,187,391,293,297,186],routing_post_control:156,blog_upd:298,localizando:[299,365],portuario:[],format_arg:344,sustituyan:[343,211],comilla:[363,288,180,187],aludir:91,canbeen:193,highlight:180,default_protocol:13,content_method:141,welcom:[341,84,141,121,204,16],getsectionev:152,user2:[],user3:58,user1:[],dile:[322,167,6],"_switch_us":[58,186],unauthent:[],tienda:289,apagarlo:214,countryvalid:324,"reutilizaci\u00f3n":[129,389,248,84,204,345,188,271,161],hagamo:[146,327],cuento:350,opensect:152,email_formatter_manag:252,movimiento:[245,364,297,89,18],cuenta:[0,1,92,93,2,96,98,6,99,7,199,11,105,278,202,110,204,16,18,145,318,207,22,117,23,211,212,213,214,30,121,32,33,329,222,331,227,228,231,337,338,130,354,342,131,270,343,46,346,341,284,350,242,362,247,136,138,142,60,256,153,154,368,70,157,73,161,74,77,375,166,167,82,277,25,175,177,383,178,84,85,179,386,388,389,186,293,294,181,205,90],hellocontrollertest:361,"art\u00edculo":[266,315,19,145,219,92,93,102,384,362,166,353,146,247,303,134,99,251,327,144,62,35,255,331,84,153,341,78,184,337,260,14,15,234,202,186,338,343,293,204,297,90],perfil:[10,328,284,196,37,189,192,104,64,55,152,343,264,121,293,361,43,211,166],fragmentrendererinterfac:293,mock:[],nice:239,dale:[197,255,148,145,343,77,326,121,204,367],explicarlo:[182,20],version_format:226,reportar:[313,382,189,133],predelet:277,sobrescrito:149,getport:272,problema:[238,0,372,91,145,2,346,384,23,166,211,25,40,56,136,362,31,99,326,215,121,313,60,305,33,281,319,273,331,84,104,151,286,363,335,107,231,337,14,108,234,202,90,110,204,16,46,297,186,161],"ejec\u00fatala":16,vice:[],"l\u00ednea":[341,222,268,294,1,145,20,349,350,329,384,23,166,135,146,321,213,214,247,326,99,7,121,353,172,60,101,61,236,144,102,167,35,197,273,255,178,199,84,180,85,363,154,277,182,184,370,288,338,346,15,90,389,343,344,293,33,204,16,181,313,186],asseticbundl:[306,213,103,341,293,16,217],teaser:[],remit:211,jsonrespons:[375,222],"l\u00e1nzalo":349,app_cach:87,escogido:349,edg:[242,331],publicidad:[188,345],getfilt:270,producida:202,cargar:[341,0,18,19,189,220,77,299,346,384,23,271,191,319,322,193,213,96,247,138,166,326,353,60,252,144,222,231,199,84,64,153,330,386,65,105,336,367,128,363,338,14,201,108,342,109,343,110,293,389,204,328,181,73,297,186,161],soportada:18,gana:[331,149],tree_control:245,cargan:[322,23,319,247,328,270,179,8,293,209,60,346,336],superfici:[206,287,13,295,216,44,97,67,355,29,85,82,329,154,294,178,181,359,127,113],instalarlo:[326,273],acme_privaci:300,setallowedvalu:39,junio:215,optimiza:[319,318,18],base64:[10,102,186,247],base_url:[226,90],phpcr_children:[245,86],niegan:219,autostart:370,setcreatedvalu:166,luhnvalid:126,ponga:157,eligiendo:[1,48,33,18],"extensi\u00f3n":[266,238,241,52,20,328,299,79,211,319,168,40,213,56,331,18,356,326,142,9,60,204,280,175,308,62,63,273,189,199,84,104,180,349,224,153,335,182,127,305,183,14,341,67,270,385,377,344,293,70,312,71,297],envuelv:[22,99,331,343],complementaria:86,expectativa:[207,74],"copiar\u00e1n":145,searchbundl:[348,1,131,70],idebarblock:[],dando:[238,273,18,335,60,346],"declaraci\u00f3n":[350,184,146,341,338,1,342,45,93,99,204,305,157,117,30,166],alentar:[],dbname:[148,115,349,30,78,326,16,277,6,166],encoder_factori:[23,186],etiquetando:125,grandioso:22,disponibilidad:[49,18],mirar:[19,383],http_basic:[247,194,100,58,186],myvendor:312,fielderror:93,denomina:186,maxsiz:[128,297,266],admin_bundle_menu_multilangmenunode_delet:86,depreciacion:[11,309,47,151],programador:182,pleas:[61,128,350,213,314,270,126,218,3,347],smaller:[],base_integer_widget:167,setcont:[138,84,77,326,251,9,375],ocho:11,claudio:342,mantenerla:[119,252,313],retroced:[20,204],reunion:[26,281,309,174],"ejec\u00fatalo":[],fullnam:327,setreturnvalu:[94,390],compat:[284,298,375,18,75,177,318,93,21,242,376,6,166,210,56,137,28,138,134,99,121,60,305,240,144,62,384,331,325,180,224,363,226,256,388,310,285,367,219,299,278,129,289,14,341,342,235,343,110,145,204,295,386,346,186,48,161],recuperan:[260,14,331,386,166,49],compar:[],fine:[337,144,247,121,18],getformfactori:[182,327],luneticslocalebundl:339,"akama\u00ef":[331,318],detien:[94,152,186,70],recuperar:[18,388,115,219,2,242,210,271,211,375,247,136,248,138,166,99,121,142,277,9,282,222,197,331,256,286,312,386,41,338,14,342,204,46,181,90,161],femenino:93,explicito:110,solicitando:136,usualment:[359,346],chose:339,"p\u00fablica":[163,109,91,331,84,202,93,99,300,32,375,138,107,363,49],authenticationmanag:[219,62,256],"p\u00fablico":[138,91,118,93,188,375,322,341,119,8,144,385,225,157,336,107,259,337,14,112,16,345,73,161],registerbundl:[349,241,21,23,24,321,213,341,134,255,326,8,217,101,37,199,221,124,86,87,184,338,16],iniciativa:18,"g\u00e9nero":[22,93,178,266,362],alcanza:[314,382],explora:110,siguen:[200,222,341,201,84,350,153,8,386,60,331,161],decision:[220,330,18,136,119,286,209,161],userpass:242,cmf_embed_block:[326,77],purpos:[246,327,347,87],larger:[],"ver\u00eda":[231,238,0,14,84,226,204,335,218,252],"_name":[],test_databas:338,typic:[266,141],nativesessionstorag:49,evitart:167,caduca:62,apr:84,auto_generate_proxy_class:[148,326,388,70,16],approxim:313,apt:199,blog_delet:298,creado:[138,163,300,2,241,375,166,167,168,213,214,341,99,251,305,62,146,84,226,14,327,293,319,46,72,346,186,161],api:[268,316,349,93,375,138,361,26,18,58,62,84,180,364,386,334,107,87,78,14,343,70,157,237,49],delant:313,prefier:[388,166,273,341],motor:[167,222,56,14,341,349,305,99,344,121,65,204,311,357,60,166,161],revisada:136,pesar:[337,222,247,260,108,149,158,166,310,338,326,110,293,9,346,72],apc:[389,148,201,20,388,370],redi:20,beresp:318,hellowsdlport:9,cerrando:186,desaparecido:293,dejar:[367,161,346,273,14,68,153,2,386,345,188,60,313,166,49],multiplemessag:190,comentar:[136,281,186],from:[375,261,78,8,326,285,6,166,135,212,245,322,169,213,247,137,28,58,81,141,98,110,217,60,327,306,382,254,103,178,332,180,226,335,43,87,339,108,234,292,156,347,70,158,297,235,342,161],"_security_":194,fea:346,uso:[298,1,92,190,3,95,4,99,195,310,105,12,376,14,257,15,110,204,16,112,18,145,208,22,209,23,322,324,28,36,326,32,122,328,319,123,331,38,126,333,334,228,128,338,44,111,131,45,343,132,345,47,49,50,352,54,248,250,252,254,148,256,152,363,155,367,259,369,67,68,263,158,73,235,266,373,269,77,79,166,168,271,344,280,219,383,384,178,385,386,387,181,183,185,290,291,187,391,293,188,186],feo:[84,386],denotado:[363,288],apunt:[338,99,70,277,166,367],"memoriz\u00f3":331,few:[1,313,81],ust:[],uss:[],usr:[61,40,213,103,217,199,273,7,236,16,71,214],fuerzan:231,symfonycmfcreatebundl:[213,101],"realizaci\u00f3n":78,plainpassword:74,fiabl:[241,161],sort:[338,177,218],apuntada:108,recomendado:[245,199,124,92,60,244],recomendada:[341,58,16,158,370,161],detecta:[331,7,118,254,268],nombrando:[99,167],decorador:166,categorynam:[152,277,166],rabbit:289,demuestra:[326,62,121,256],"colecci\u00f3n":[238,0,91,19,75,189,93,22,117,166,353,330,341,139,338,99,178,60,385,280,254,231,148,331,84,373,363,299,335,128,288,290,14,342,202,109,181,346,186,161],editando:146,docrin:136,topic:[292,339],"interrupci\u00f3n":389,"anex\u00e1ndolo":193,solicitast:314,provenir:213,karlton:331,annot:[326,50,302,208,269,349,93,207,79,80,352,190,376,54,3,135,166,95,291,323,118,250,324,57,123,140,81,263,99,98,121,195,32,373,391,122,60,242,338,254,388,36,37,148,221,38,180,126,354,330,225,226,257,387,105,155,185,66,366,278,230,128,183,259,12,290,112,108,202,45,187,243,333,111,119,241,198,297,186],ralentiza:58,repasemo:84,service_id:282,"l\u00edmite":[183,314,331,84,318,99,79,48],construir:[0,18,91,1,20,190,164,166,245,96,341,99,380,9,218,143,383,319,231,84,256,153,226,65,22,128,260,342,202,338,343,110,161],"parecer\u00eda":[293,319],gettotaltim:361,patron:[337,106,346,186,160,367],intercepta:[186,211],liip_doctrine_cach:199,customlog:169,tag:[266,294,92,117,362,353,330,327,322,210,140,81,141,326,110,32,344,154,218,204,10,176,329,111,178,221,85,251,225,86,181,228,66,278,367,259,287,338,14,202,131,270,292,156,293,249,70,157,392,235],"configurar\u00e1":[277,166,6],getupdatedat:331,tal:[266,222,51,268,18,314,91,1,315,115,282,77,299,319,238,351,165,342,386,271,140,25,272,322,213,214,341,248,162,383,58,6,99,326,32,358,60,331,33,175,236,144,253,167,204,166,20,199,84,180,349,330,364,226,335,182,350,367,128,118,218,129,260,346,108,234,202,131,343,110,70,16,328,157,161,313,186,48,49],expandir:[245,362],tan:[138,19,145,20,79,346,242,384,375,271,167,341,248,166,99,8,121,33,10,219,383,222,331,84,363,14,89,204,16,157,158,313,186,161],format_fil:344,urldecod:[226,58],memoriza:[144,121,331],remembermeclass:219,sit:177,minlength:79,activando:[37,259,121,186,354],"alg\u00fan":[247,0,93,300,2,193,362,7,305,101,306,102,107,299,14,202,109,110,313,18,314,19,145,20,22,117,210,211,222,322,326,8,121,135,122,33,319,123,331,228,127,231,56,343,46,48,349,350,351,242,353,341,248,139,58,358,60,61,144,253,128,152,153,364,259,68,161,10,268,373,77,62,271,166,219,383,283,178,84,179,387,293,89,392,297,186],importar:[354,153,37,14,341,6,99,136,121,351,71,392,360],especificar:[266,369,162,91,206,93,190,80,346,164,23,166,319,193,213,96,341,303,119,28,99,7,388,178,60,143,61,329,226,204,225,252,148,331,16,150,125,85,373,153,40,154,180,294,336,210,367,128,218,214,368,290,14,354,338,110,70,130,181,297,186],aprovech:18,especifican:[61,193,7,204,186,49],sid:[286,148],instead:[327,233,39,81,141,156,3,347],utilicemo:[],sin:[0,91,189,92,93,300,2,94,193,302,98,6,99,7,305,273,198,199,104,11,310,107,200,14,112,108,202,204,16,313,17,18,206,318,164,23,211,322,214,28,326,8,121,32,218,33,329,222,331,226,335,228,230,231,337,129,338,130,341,234,343,344,236,137,46,346,48,49,238,349,350,242,362,55,135,56,136,57,138,250,142,357,60,143,61,144,145,63,149,64,363,154,366,367,359,368,70,71,73,235,161,315,268,77,80,165,375,166,167,168,379,82,277,83,282,383,178,84,85,386,180,388,285,286,184,288,389,390,293,89,294,295,181,297,186],refier:[222,147,56,148,149,305,153,343,121,204,209,60,186,161],docblock:[],addcompilerpass:[4,117,319,353,330],reportero:215,hello_us:241,getclientip:[272,392],exemplifi:347,arnleadservicewsdl:9,attent:22,omitir:[145,184,222,37,199,221,234,349,92,121,42,210,186],"conf\u00ed":89,nombre_asignado:[],"esperar\u00eda":[343,108,315,273,111],json_encod:[375,222],llamart:77,entitymanagermock:[],setissu:228,"expresi\u00f3n":[231,177,323,0,56,366,119,240,250,305,99,343,225,204,106,209,346,186,160],mapdef:330,instando:314,classload:[239,389,201,84,159,224,16,107],elig:[102,294,341,178,383,85,153,329,121,360,181,16,190,154,60,210],swift_plugins_impersonateplugin:284,iniciast:51,opuesto:72,ocup:[380,166,18],routers_by_id:[255,110,367],preremov:[297,166],elij:[242,16],whilst:141,trasladarlo:20,"acu\u00e1l":346,fooaction:[231,0],symfonycomponenthttpfoundationrespons:[],rebautizar:[306,388],write:[145,213,103,339,19,163,378,326,141,99,7,86,39,70,270,271,243,319],midgard:[199,349,70],app_benchmark:144,asercion:[93,343,75,361],rojo:[61,7],inexistent:[14,200],"simult\u00e1neo":46,permanent:[67,222],requiera:[332,20],"_server":[10,231,144,0,138,84,343,6,98,375,211,161],customcompilerpass:[4,319],circularreferenceexcept:270,abcd123:322,listar:[343,40,222,243],observador:[46,2,334],muestran:[62,232,341,14,76,85,99,154,334,294,386,127,167],condicional:338,guess:[39,293],devel:213,sprintf:[51,268,247,221,350,251,102,226,94,228,371,327,383,361],encontraba:289,form_widget_simpl:167,dispuesta:89,"c\u00e1mbial":92,escuela:186,trac:281,edit:[1,206,355,77,329,243,25,245,213,354,136,137,28,97,326,29,82,8,121,216,244,327,33,145,294,273,178,295,85,286,154,127,285,87,359,287,13,339,44,233,67,156,70,119,312,181,235,113],encapsular:386,tran:[367,35,109,110,344,60,167],derivado:[148,388],overrideservicecompilerpass:351,postsav:277,derivada:[341,129,305],pygment:180,fixtureinterfac:[23,70],symfony__database__us:6,documentclassmapp:41,informa:[31,62,200,146,327],acomodar:[],apoya:[145,70,18,148,331,163,345,11,7,238,111,335,188,392],our:[339,327,81,141],apoyo:[270,384,18,108,20,318,6,11,363,7,368,212,60,101,161],compressor:[71,322,189,377],out:[1,81,292,70,358,217,347,212],magnoliadocumentclassmapp:41,solicitan:331,"_product_name_row":167,categori:[99,346,166,277,181],plural:[60,193,344],redirectrout:[110,86,347,141],encargars:176,conflicto:[389,148,388,33,307],advancedload:81,actuando:157,adapta:389,extra_filt:70,"ejecutar\u00e1":[144,319,273,341,145,117,23],autolojamiento:92,"preparaci\u00f3n":[14,18],transportcompilerpass:[117,353],my_filt:[238,335],obstant:[284,222,273,56,338,178,18,349,77,350,165,326,110,105,22,71,383],processconfigur:[175,153,193,319],transfierelo:20,managerregistri:70,prerecuperado:70,blogpost:[135,131],latest:[346,241],ocurrir:[306,137,28,206,285,310,82,226,295,359,235,211,49],indistintament:121,"bas\u00e1ndono":[359,66,210],choicelist:178,organiz:327,yourservic:351,naturalment:[219,300,202,77,99,70,367],arraycollect:[22,178,166,202,247],ponemo:[],getclass:[282,210],isbn:34,introspectionprocessor:293,defaultcontrol:[383,338,99,70,277,166],baseappl:268,manipula:[299,375,138],instalar:[239,0,138,163,349,315,92,2,383,241,21,326,23,24,271,191,168,375,248,240,98,7,121,142,358,277,331,101,61,177,145,384,273,231,255,199,39,124,322,152,363,65,224,289,338,14,201,15,159,69,33,70,46,72,186],echo:[266,138,294,163,219,93,300,2,329,346,22,384,375,386,166,211,25,322,40,226,56,334,362,99,98,358,60,10,144,39,167,222,178,331,84,180,85,310,363,154,65,181,341,184,289,130,108,202,109,204,71,72,297,186,161],reinventar:[331,51,161,134],regresamo:312,"mantendr\u00e1n":[386,222],knpmenubundl:[255,108,96],myfactori:[],prioriti:[338,264,292,2,110,293,251,66,210,347,367],fingido:357,aislado:[322,161],registrando:[266,267,383,349,35,147,268,338,385,249,270,78,276,280,319,16,157,117,258,63],setentitynamespac:[],aislada:343,manzana:[359,137,28,206,285,310,82,295,60,235],realidad:[266,74,238,18,206,92,93,207,2,284,241,80,117,166,211,222,380,322,341,383,99,98,8,60,144,145,146,178,331,84,286,225,335,229,337,338,234,202,109,343,204,311,46,346,186,48,161],capac:[93,7,200,204,18],getcontext:[346,90],aplicarlo:89,capaz:[266,18,314,315,318,242,2,94,384,210,166,135,330,213,341,99,277,9,60,219,383,222,331,64,179,256,228,200,363,338,201,342,202,109,110,204,46,346],data_collector:[10,293],individualment:[259,254,45,310,99,343,167],utilicen:[369,383,353,131],shell:368,dibujarlo:[266,99,317,77],"reproducir\u00e1n":[329,178,85,154,294,22,181,167],permisivo:[],role_superadmin:58,convertirt:16,getauthornam:204,apropiada:[193,226,349,383,167],concordar:[144,186],jmsdiextrabundleannotationvalid:[],"ra\u00edz":[341,145,20,92,245,322,193,96,56,326,8,121,60,305,306,144,222,148,179,388,367,337,201,108,110,204,16,158,346,90,48,161],pathproviderinterfac:141,apropiado:[367,383,138,137,131,99,110,72,60,33,49],your_gmail_usernam:[],getdur:152,regresando:[319,244],contenedor:[222,238,268,91,189,282,77,164,319,383,346,22,343,117,23,275,353,212,4,328,213,302,248,249,6,8,32,9,83,143,384,176,144,62,35,283,26,166,316,385,150,125,153,226,120,335,271,106,336,392,258,367,259,363,260,14,340,354,234,159,165,293,252,312,158,73,47,186],escalan:110,postload:166,calentador:[],favorit:314,mailer:[222,238,90,14,335,234,64,43,248,91,271,278,9,134,252,117,212],myproject:92,permissiongrantingstrategi:286,"vac\u00edo":[193,56,314,178,15,118,85,99,329,154,294,181,278,127,305,153],admin_bundle_menu_multilangmenuitem_delet:[],clic:[281,211,145,202,64,99,343,121,89,242,166,33],simplement:[50,18,91,145,269,74,92,78,207,2,102,351,80,22,166,211,167,322,56,331,268,326,362,99,7,8,357,305,33,61,176,144,221,222,254,149,199,84,38,179,226,227,42,127,367,219,93,232,288,363,338,14,341,202,131,343,337,204,311,158,73,346,186,161],etiquetado:[4,328,330,14,385,107,110,293,117,159,353,367],protocolclassvalid:32,"vac\u00eda":[61,56,348,331,341,93,7,121,157,60,386,49],setexpir:[307,331,375,138],"registr\u00e1ndolo":182,memorizada:331,adminkernel:87,rout:[213,222,0,205,315,189,341,300,351,305,242,210,24,211,25,245,323,5,96,56,58,81,141,326,8,121,243,344,60,204,383,111,197,37,84,149,150,180,152,354,298,86,218,106,156,107,87,230,231,367,83,339,283,14,108,342,244,159,110,293,347,70,16,312,346,186,160,161],memorizado:[144,319,341,331,368,318,242],servidor:[306,284,145,20,144,318,341,241,389,166,244,272,265,56,58,6,99,7,121,358,9,361,100,331,61,281,382,62,204,273,159,148,199,84,349,286,226,227,388,106,231,12,260,346,247,202,90,338,370,337,70,16,386,313,186,160,49],configurando:[0,1,189,93,300,301,96,99,120,101,308,197,199,271,200,14,108,204,16,312,17,18,315,316,317,318,23,24,211,26,323,27,326,8,218,220,111,37,221,226,41,336,231,338,233,131,328,237,347,49,284,348,349,55,244,245,341,248,58,356,134,59,60,252,360,145,255,148,153,366,258,367,68,156,70,71,158,159,267,162,77,78,62,80,165,275,272,210,273,171,166,277,83,383,385,86,388,213,186,377,293,297,90],odm_configur:[70,41],which:[212,322,58,81,141,326,156,327,306,281,273,199,39,310,86,335,87,339,108,342,131,292,110,70,226,297,347],startsat:95,europeo:266,licencia:[26,17,129,372,1,151,350,345,188,158,174,313,33,27],legibilidad:[363,288],lugar:[91,1,189,93,354,2,284,190,193,96,240,6,99,7,8,305,102,104,286,106,299,35,14,311,202,110,204,16,18,314,19,145,20,282,318,319,346,117,23,25,322,28,30,31,215,121,353,32,327,33,332,222,37,331,221,124,225,226,227,335,42,337,338,247,343,132,46,47,48,341,238,52,349,140,351,228,242,362,135,56,136,248,138,58,134,358,60,61,62,63,149,150,64,363,260,68,70,71,158,161,268,77,79,80,375,271,146,166,380,277,167,176,177,283,84,179,386,183,185,288,153,389,297,291,187,293,89,181,205,186],"expirar\u00e1n":386,esperemo:[204,161],centra:[353,247],setformat:[364,249],multiidioma:[],"convertir\u00e1":[187,202,33],multitud:16,crearla:[202,161],comparado:319,emailmanag:252,strtotim:[307,177,62],why:[110,327,335,141],"_build":180,adaptar:[326,346],"09610f61637408828a35d7debee5b38a8350eeb":247,sufijar:314,depreciast:33,"contrase\u00f1a":[74,284,314,349,92,93,207,102,242,23,3,25,247,355,139,58,98,100,62,256,310,337,14,70,186],eleccion:145,reflejan:158,ignorado:[363,337,288,92],deni:169,fiel:84,determin:[375,273,137,28,39,342,58,141,110,226,70,178,217,285,45,235,347],aprenderemo:[],"aparecer\u00e1":[329,178,202,85,93,154,294,22,181,33],eludir:331,findtaggedserviceid:[117,353],wrapperclass:148,seleccionada:[22,178,60,96,344],swift_plugins_redirectingplugin:284,filetyp:67,seleccionado:[245,178,29,190,343,142,22,367],ilimitado:[],"familiariz\u00e1ndot":305,presentando:186,"comparaci\u00f3n":[247,177,8,186,167],retorno:[193,288,75,362,93,363,284,142,94,107,211],repository_id:70,durant:[341,74,51,91,315,20,328,284,241,80,242,384,166,211,222,245,171,383,98,134,7,277,305,61,281,144,102,146,273,189,331,84,64,11,363,330,226,227,14,247,202,293,204,186,49],locat:[245,231,322,169,0,81,141,299,165,9,244,327,87],blog_entri:204,manipulan:182,much:[141,347,87],practic:39,consistentement:161,interoperabilidad:[286,201,158,49],significado:[231,0,18,286,117,49],manipular:[4,282,384,111,138,18,342,322,153,319,211,142,343,353,375,297,363,49],pensar:[61,56,338,14,341,7,8,204,228,166],confianza:[272,186,204],label_catalogu:86,local:[145,317,93,211,245,213,96,99,344,121,217,60,33,10,75,294,273,36,331,104,85,224,154,277,337,107,218,88,283,339,108,343,110,293,70,16,159,347],consoleoutput:268,subdir:[],vigor:60,mailmanag:[238,335],suel:[144,328,222,273,247,119,150,29,286,110,22,277,72,166],incluirla:[331,305,204,56],cubr:[62,273,109,199,18,134,99,343,33],delgado:[363,384],webservice_user_provid:102,encaminamiento:[],unstructur:70,vien:[222,315,0,18,145,92,93,319,102,242,166,135,167,321,26,247,383,362,99,121,211,277,218,305,360,306,176,144,34,204,273,198,331,84,286,337,77,367,231,184,88,338,341,342,389,69,111,157,186,161],contenert:281,"caer\u00e1":99,partir:[341,0,342,206,20,328,165,22,386,25,96,247,355,97,29,99,82,216,178,60,219,144,329,167,294,255,76,331,180,85,11,153,154,256,105,287,127,107,231,359,232,13,289,44,108,67,90,132,204,295,181,113,47,186,49],manipulando:142,provoca:[383,166,32,161],menuitem:[108,347,96],do_esi:318,view:[266,74,339,294,202,93,207,383,346,22,209,211,25,327,322,40,226,213,56,136,119,28,326,362,99,98,344,121,154,341,60,305,242,329,167,204,222,37,178,331,311,149,85,286,225,86,65,181,228,182,285,350,310,300,130,108,137,235,109,156,70,16,71,158,297,186,161],aplicado:[109,225,319,33],suplantar:272,maxwidthmessag:105,signatur:[],knowledg:141,"alfanum\u00e9rico":[350,158,375,32,138],aplicada:182,admin_bundle_menu_menunode_edit:86,multipart:[99,344,109],"pre\u00e1mbulo":242,gmail:[284,171,221,189,134,227],still:[322,254,339,81,375,327],interferir:[46,157,2,349],"cach\u00e9":[306,0,138,19,145,20,328,318,92,300,2,242,375,275,191,222,26,322,341,331,205,326,7,8,121,59,60,204,319,61,307,144,63,197,37,148,199,84,104,189,226,365,77,231,316,368,389,130,201,159,385,293,70,16,46,386,371,370,186,161],despu:388,supera:105,cubierta:[284,331,58,226,204,345],favor:[18,314,315,350,207,21,346,242,209,345,31,215,218,33,70,273,199,124,126,132,366,367,60,339,108,342,110,111,157,313,186,347],crudo:[136,343,82,209],autorout:141,entrant:[144,315,5,341,137,28,84,342,235,153,110,121,204,312,106,285,346,186,211],entidad:[266,74,115,267,241,351,210,166,135,321,168,23,213,247,274,57,356,99,380,243,277,9,175,220,102,148,331,189,388,228,367,200,338,67,202,131,45,293,181,297,186],un_filtro:[148,103],coincidan:[231,337,0,153,186,367],presetdata:[146,327],hereda:[206,355,137,28,97,29,362,82,216,359,305,329,204,178,85,310,154,287,285,232,13,44,67,294,295,181,235,113],construirlo:328,searchindexersubscrib:131,class_metadata_factory_nam:148,amex:376,job:[],entir:[22,178,234],getcachekei:[197,77],opcion:[0,1,93,2,190,3,95,193,96,97,98,362,99,7,195,216,10,102,103,199,310,105,12,13,14,112,108,109,110,111,311,313,257,113,222,18,206,118,317,319,320,329,208,22,117,23,211,25,26,213,214,324,28,123,29,31,326,121,32,122,355,34,204,36,38,331,124,126,333,226,127,230,128,232,338,44,341,342,45,343,137,46,47,49,50,284,349,140,351,352,54,243,245,376,246,304,57,58,134,250,142,60,252,248,61,62,254,231,148,64,153,364,154,365,155,287,367,259,368,67,68,263,264,70,158,370,235,373,76,77,78,79,80,165,271,269,167,168,210,197,359,166,82,175,219,383,178,85,179,151,387,388,182,285,183,185,290,346,291,90,187,391,293,89,294,295,181,186],homebrew:199,exclam:218,swift:[382,284,117,64,353],amet:177,lanzarlo:[199,367],"querr\u00e1":[204,20,362,99,121,70,277,228,117,73,366,186],"escuchar\u00e1":338,"provoc\u00f3":25,conocido:[193,56,260,331,84,342,77,93,110,46,277,305,161],april:[],sencilla:[74,298,138,314,163,242,2,22,375,24,336,135,167,26,193,313,99,121,32,218,281,177,319,178,331,84,152,312,386,334,182,300,338,14,202,389,343,46,158,297,161],grain:[],proyecto:[306,1,145,20,92,2,241,30,166,135,222,265,213,56,140,6,99,7,8,121,218,305,33,319,61,204,273,124,199,84,104,150,189,11,179,226,341,182,229,367,118,184,337,260,346,201,15,342,338,343,110,249,111,16,46,72,47,186,48,161],sencillo:[74,138,242,315,189,144,77,93,207,2,22,23,24,166,222,375,341,268,326,267,362,99,7,380,121,32,277,9,60,33,61,382,383,204,273,178,331,84,349,153,86,228,182,43,219,134,218,338,201,342,131,68,89,70,311,386,72,346,186,161],myconstraint:[66,32],subclas:[102,138,268,383,2,238,204,335,46,375,211],parentdocu:349,colocando:[218,204],last_usernam:[98,186,25],rebotado:284,chmod:[145,289],emailformatterawareinterfac:252,rpc:9,reemplazamo:102,respect:[326,108,86,347,141],resuelto:[331,33],tabla:[135,34,360,247,166,220,30,286,326,383,241,89,70,16,277,45,186,33,167],newlinkli:202,sonatablockbundl:[197,255,325,77,326,86],platform:[358,148],entend:[240,315,93,166,211,384,247,99,326,60,144,383,319,273,199,84,363,338,14,342,110,339,186],"modificar\u00e1":383,normalizador:72,getenviron:[144,184,341,204,16,87],amiga:121,path_info_slash:86,compon:[0,375,91,93,300,2,238,94,3,298,95,4,193,5,97,98,362,99,7,194,195,216,9,10,102,273,159,199,104,310,105,106,299,12,13,14,201,15,202,109,110,204,16,312,112,113,222,332,138,314,19,206,282,190,319,329,39,208,22,117,23,211,212,323,214,324,28,123,29,30,326,8,121,32,122,327,355,219,328,34,35,36,331,221,38,126,330,333,334,335,228,336,127,158,128,232,287,338,44,233,341,234,131,45,343,344,236,248,46,346,347,49,50,51,239,251,240,249,351,352,242,54,353,376,247,136,137,205,139,58,141,250,142,357,358,60,143,61,144,62,146,231,269,149,180,152,153,364,154,65,155,185,66,366,367,259,207,252,289,67,263,389,70,157,72,235,161,266,74,268,342,163,76,164,79,80,270,271,254,272,210,170,292,359,81,166,82,380,257,172,175,176,177,383,384,283,178,84,224,85,373,179,386,256,387,182,285,87,277,183,88,363,290,291,187,391,293,294,295,392,297,186],literal:[363,288],faltar:[],responda:[61,121,213],revertirlo:18,exists_act:141,filippo:342,clase:[0,375,91,1,189,93,354,2,238,94,3,191,95,4,193,96,97,362,99,7,251,195,216,9,305,101,10,307,308,102,311,104,286,105,310,200,107,299,278,12,13,14,201,108,202,109,110,204,16,312,112,113,18,314,19,206,20,282,190,319,329,208,164,117,23,211,222,321,213,324,119,28,123,29,30,326,8,121,353,32,306,122,218,327,355,219,220,34,35,254,36,37,331,221,38,126,330,225,334,41,228,336,127,158,230,128,232,338,44,341,234,131,45,343,333,137,46,328,47,49,50,51,239,240,335,267,350,241,351,352,54,135,376,246,247,57,138,139,249,356,250,142,357,358,60,143,248,61,144,62,63,231,148,150,256,152,153,364,154,65,155,287,66,367,259,207,260,252,289,67,263,389,70,157,72,159,161,266,74,268,342,163,76,77,374,79,80,165,270,271,269,146,272,210,274,359,166,379,82,344,257,172,167,175,177,383,384,284,178,84,224,85,373,386,387,182,277,183,185,363,290,346,291,390,187,391,293,294,295,181,392,297,186],encuentr:[286,31,153,110,204,346],presenc:[],getblog:141,alloc:58,notifiqu:131,trustxsendfiletypehead:375,content_kei:96,menu_document_class:96,present:[254,153,91,331,15,202,6,350,99,110,226,210,347,25],matchesmethod:221,canbedis:193,"distinci\u00f3n":[62,204],setalia:73,escribir:[175,205,19,163,76,281,241,23,166,222,245,322,214,247,366,240,99,7,121,277,60,204,61,176,144,145,361,63,189,331,84,125,363,386,256,127,367,128,232,288,14,341,202,270,343,293,133,158,49,297,161],doctrinephpcrbundl:[255,1,349,326,70,199],suffix:[314,231,0,141],rebautiza:306,antigua:[47,3,33,21],antiguo:[99,234],heredado:186,observ:[66,278],argv:10,llamarlo:[],acmeblog:204,reconstruyen:[389,144],tar:145,"notar\u00e1":[172,77,30],alon:[1,58],comenzado:341,customis:[],"mutaci\u00f3n":222,bigint:[166,135],midgard2_test:[349,70],dual:11,recal:[],esencialment:[137,349,18],foreign:[277,135],publicando:[],loadformatt:252,"ind\u00edcalo":[],phpunit_framework_testcas:[61,343,7,35],cross:[99,313,204],"gen\u00e9ricament":18,aprendera:60,getkernel:[343,211,268],navegar:[343,108],is_expr_gr:209,config_dev:[144,284,341,14,322,64,153,121,227,16,226],formatsect:172,difficult:[327,141],createacl:136,slave:148,filter_admin_field:301,"resultar\u00e1":[99,73,226,235,285],"a\u00f1adida":[117,110,366,204,344],comparando:[241,186,256],cascade_valid:[99,127],columna:[338,277,166,204,30],viendo:[322,18,108,109,186,161],"\u00faltima":[19,163,349,77,241,211,25,40,341,326,99,98,135,358,277,33,307,177,332,222,331,84,124,11,226,92,337,343,204,386,346,186,49],notnullvalid:50,createact:[338,207,74,166,277],decoupl:141,"__dir__":[0,205,19,177,299,271,193,341,248,326,306,144,319,104,331,221,124,349,224,153,65,231,389,201,16,371,297,161],iftru:193,profundidad:[326,158,177,211,16],"escribi\u00f3":[331,383],registerbag:386,"manejar\u00e1":[342,110,315],simular:[253,196,138,189,343,194,357,375,100],privado:[259,337,319,225,331,14,112,385,215,278,119,73,186],english:141,refieran:[],"facturaci\u00f3n":200,privada:[350,268,338,331,202,186,93,300,278,166,135],dificultad:136,pertenec:[176,222,138,108,202,99,172,375],my_email_formatt:[238,335],fusionaran:33,percent:[99,82,60,88,212],obtain:347,progresivament:108,storefilenameforremov:297,"gesti\u00f3n":[200,18,386,375,237,159,211,49],bifurcar:33,subconjunto:[329,384,138,178,201,85,363,154,294,181,375,107],especula:218,introdujo:[228,177,161],consola:[51,268,314,20,320,241,346,166,222,214,341,326,6,7,8,172,204,61,34,35,189,153,258,70,368,260,14,262,90,338,343,236,47,159,48],getag:72,personaliz:1,smith:342,resultan:[153,193],filenameforremov:[],getlastus:49,construy:[34,88,222,96,18,283,14,84,362,389,236,135],book:[273,180],dql:[303,148,267,189,166],bool:[268,186,352],sko:213,propiament:219,candid:[],vistazo:[138,1,145,77,241,375,26,273,56,362,99,326,121,381,305,315,146,197,255,84,341,342,270,343,293,16,46,158,346],agnost:[],originaltag:202,my_doctrine_listen:338,db_url:6,filesystem_oper:152,know:[108,39,81,270],desconocido:[94,228],desconocida:[128,202,254],"activaci\u00f3n":14,"actualizaci\u00f3n":[319,338,331,20,215,386,277,297,166],interceptarla:268,actualizast:99,createphp:[218,213],restaurar:286,gestionarla:145,updated_at:[197,135],asignast:99,envasada:[341,16],configurado:[315,0,342,145,249,326,165,210,166,135,319,213,341,139,58,99,7,121,211,277,278,305,144,102,361,35,86,388,367,231,338,14,201,234,202,389,343,110,204,71,370,186,49],descubrirlo:184,llamarla:61,documentado:150,"mov\u00eda":8,ocurrencia:205,buildcreateform:77,suppli:[110,254],documentada:[99,326,49],compiler_pass:[],invariablement:84,tardar:145,context:[245,231,62,0,80,136,327,221,58,90,98,259,86,32,66,186],"_gettestentitymanag":[],cometen:[],horaria:[329,137,331,235,285,28],lead:339,accion:[51,77,78,166,243,119,140,99,98,277,278,305,33,383,222,286,366,230,260,108,338,204,346],leal:[188,345],"l\u00f3gicament":[152,33],inittre:[245,244],leav:[234,141],setto:[9,43,64,134],"obtendr\u00e1":[319,91,121,242,209,60],close_database_connect:161,corresponda:[231,222,0,186],leader:[],getnam:[61,74,51,266,207,2,210,166,146,327,362,99,7,194,357,277,305,10,35,386,228,66,72,200,233,202,270,158,380],desacoplado:1,role_iddqd:162,askhiddenresponseandvalid:314,"enum":[78,148,193],mitr:215,aloha:213,desacoplada:[91,252],pasta:[],asigna:[260,222,354,0,341,136,84,338,286,99,98,121,277,367,346,166,212],zambullirno:[],slug:[231,383,0,298,141,156,204,210,346,135,222],rara:[288,341,99,343,363,211],rare:141,extension:[266,267,189,166,353,26,168,40,341,249,31,304,280,175,328,62,319,385,180,153,182,338,14,270,344,293,204,158,49],column:[74,247,166,45,241,277,297,186,135],raro:49,subido:[266,267,128,84,189,99,343,297],constructor:[238,0,375,138,91,219,299,2,383,164,117,210,271,319,4,193,170,136,248,166,218,143,327,282,62,146,385,39,86,334,335,228,278,350,87,231,367,259,14,234,293,46,342,49],subida:128,disabl:[97,298,240,206,355,375,137,28,205,29,82,162,216,359,329,178,64,85,154,127,285,287,13,44,67,109,343,294,295,181,235,113],declaracion:[341,104,342,305,350,204,166],turno:110,app_:121,loadblockwithcmfpar:326,include_onc:6,autoriza:129,untick:142,stale_if_error:331,extracachekei:197,automat:[375,197,108,234,58,81,141,110,86,70,165,226,156,347],sustituirla:[99,110,367],dry:[],"relaci\u00f3n":[200,129,247,325,149,202,77,22,228,47,166,135],upload_err_ok:[],postal:380,van:[176,1,107,70,158,72],val:[94,211],garbag:[226,49],transfer:[260,84],agregaremo:176,appl:60,desinfectar:[67,161],wouldn:347,image_type_extens:266,"var":[266,268,118,2,42,22,209,23,135,245,169,56,99,326,60,327,176,37,125,256,228,229,200,289,202,45,109,264,204,46,346],"ajust\u00e1ndolo":351,adelanta:364,vat:266,explica:[0,383,8,166,222,168,323,247,58,362,215,121,218,33,62,204,198,331,11,43,231,338,70,311,351],"ll\u00e9nalo":19,conexion:[267,338,148,84,115,189,78,226,388],"rebautiz\u00e1ndolo":[],setprogresscharact:364,somesect:172,preguntando:[331,62,166],corporacion:331,"haci\u00e9ndolo":73,transchoic:[60,344],twig_extensions_extension_intl:293,manipulador:[176,62],made:[],temp:297,recorr:[338,177,343,142,367],whether:[339,375,226,254,347],anexar:[367,18],stale_while_revalid:331,record:176,below:[169,273,178,108,58,81,141,39,339,235],archiveact:210,tema:[266,18,93,242,362,166,167,341,303,134,99,215,60,305,280,281,144,222,255,331,334,108,234,68,293,204,16,72,313,186],sobrescribir:[193,213,153,226,70,41],routeobjectinterfac:[110,342,367],suplantando:186,"incluir\u00e1n":129,convencion:[314,163,350,2,26,341,356,8,121,60,33,174,37,151,11,153,42,47,201,16,46,346],persistent:[148,166,18],moraleja:[46,2,241],exceptionhandl:239,meetup_registration_listen:327,setopt:[266,367,39,49],"sabr\u00e1":[341,241,268],traducida:[60,342,84],aplic:[166,286,345,22,188,9,313,186,371],"continuar\u00e1":20,directament:[146,238,205,91,206,20,328,77,93,164,319,329,80,326,22,271,211,25,327,168,273,56,136,248,190,97,383,7,29,166,99,82,380,121,32,216,113,143,204,242,355,61,313,144,163,167,142,222,336,178,331,295,150,85,286,359,154,294,228,182,305,367,219,218,287,13,322,260,14,341,67,202,90,338,343,374,293,70,44,181,73,297,186,48,49],descargando:[71,377,145,121,138],dispos:[],eventsubscrib:[338,336,131,70],traducido:[111,60,89,70],"explic\u00f3":110,enlacemo:204,other:[249,301,356,375,322,169,213,58,81,141,142,358,217,327,175,199,39,335,87,108,342,110,347],simulan:357,bin2hex:360,normal:[240,234,206,355,165,329,81,22,23,166,96,137,28,97,58,29,99,82,216,359,100,327,242,61,39,236,283,178,84,85,310,153,154,227,294,228,285,367,7,287,13,338,44,67,90,292,343,293,70,295,181,72,49,235,113],setimag:70,multilanguag:347,php5:[199,169],escriban:161,salvaguardado:[],mediatyp:266,countxxx:47,june:[],shown:[339,335,298,131,141],provienen:[349,210,252,186,247],improving_foo_and_bar:313,contendo:[],"modificaci\u00f3n":[68,19,177,289],establezca:[248,62,271,204,268],rellen:[],debian:[199,20],consultado:[110,139,367],experienc:[],sass:[322,103],strpo:221,space:[344,58,240],"contendr\u00e1":[74,62,331,362,126,22],profit:70,archivobio:128,store_ord:2,coleccion:[17,213,290,202,363,226,22,288],perfectament:[136,346,222,204],complicacion:[357,134]},objtypes:{},titles:["El componente Routing","Documentaci\u00f3n del CMF de Symfony","El componente despachador de eventos","UserPassword","C\u00f3mo trabajan los pases del compilador en los paquetes","C\u00f3mo forzar las rutas para que siempre usen HTTPS o HTTP","C\u00f3mo configurar par\u00e1metros externos en el contenedor de servicios","El componente Console","En qu\u00e9 difiere Symfony2 de symfony1","C\u00f3mo crear un servicio Web SOAP en un controlador de Symfony2","C\u00f3mo crear un colector de datos personalizado","El proceso de versionado","Email","Tipo de campo url","Contenedor de servicios","C\u00f3mo instalar y usar componentes de Symfony2","La arquitectura","JMSDiExtraBundle","Eligiendo una capa de almacenamiento","Almacenamiento en cach\u00e9 basado en recursos","C\u00f3mo desplegar una aplicaci\u00f3n Symfony2","Instalando","Tipo de campo Collection","DoctrineFixturesBundle","Instalando y configurando el SimpleCmsBundle","C\u00f3mo personalizar el formulario de acceso","Documentaci\u00f3n de Symfony2","JMSSecurityExtraBundle","Tipo de campo date","Tipo de campo radio","C\u00f3mo utilizar PdoSessionHandler para almacenar sesiones en la base de datos","Informando de errores","C\u00f3mo crear una restricci\u00f3n de validaci\u00f3n personalizada","Enviando un parche","Ayudante Table","C\u00f3mo crear una orden de consola","Locale","SensioFrameworkExtraBundle","Null","The OptionsResolver Component","C\u00f3mo aplicar un filtro Assetic a una extensi\u00f3n de archivo especifica","Usando una clase documento personalizada asociada con PHPCR-ODM","@Template","C\u00f3mo verificar que se env\u00eda un mensaje de correo electr\u00f3nico en una prueba funcional","Tipo de campo checkbox","UniqueEntity","El componente despachador de eventos","Convenciones","C\u00f3mo formar en la cola mensajes de correo electr\u00f3nico","Configurando sesiones y controladores de guardado","NotNull","Usando eventos","C\u00f3mo inyectar variables en todas las plantillas (es decir, Variables globales)","Seguridad","True","Configurando WebProfiler","C\u00f3mo usar plantillas PHP en lugar de Twig","Generando una nueva entidad para resguardo con Doctrine","Referencia de configuraci\u00f3n de Security","Almacenando en cach\u00e9","Traduciendo","El componente Console","C\u00f3mo crear un proveedor de autenticaci\u00f3n personalizado","Plantillas","C\u00f3mo trabajar con correos electr\u00f3nicos durante el desarrollo","El componente Templating","Anotaciones","Tipo de campo file","Referencia de configuraci\u00f3n del TwigBundle","El componente Security","DoctrinePHPCRBundle","C\u00f3mo minimizar JavaScript y hojas de estilo con YUI Compressor","El componente Serializer","Configuraci\u00f3n avanzada del contenedor","C\u00f3mo implementar un sencillo formulario de registro","Referencia de restricciones de validaci\u00f3n","Tipo de campo csrf","BlockBundle","C\u00f3mo utiliza Doctrine la capa DBAL","MinLength","Callback","How to create a custom Route Loader","Tipo de campo percent","Enrutando","Symfony2 y fundamentos HTTP","Tipo de campo country","Creando un CMS con CMF y Sonata","Understanding how the Front Controller, Kernel and Environments work together","Referencia de tipos para formulario","Traduciendo","C\u00f3mo generar URL y enviar mensajes de correo electr\u00f3nico desde la consola","Tipos de inyecci\u00f3n","C\u00f3mo crear y guardar un proyecto Symfony2 en Subversion","Validando","C\u00f3mo extender una clase sin necesidad de utilizar herencia","Time","MenuBundle","Tipo de campo text","C\u00f3mo agregar la funcionalidad \u00abrecu\u00e9rdame\u00bb al inicio de sesi\u00f3n","Formularios","C\u00f3mo simular autenticaci\u00f3n HTTP en una prueba funcional","Instalando y configurando la edici\u00f3n en l\u00ednea","C\u00f3mo crear un proveedor de usuario personalizado","Referencia de la configuraci\u00f3n de AsseticBundle","C\u00f3mo optimizar tu entorno de desarrollo para depuraci\u00f3n","Image","C\u00f3mo emparejar una ruta bas\u00e1ndose en el servidor","API estable de Symfony2","Men\u00fa","Funciones de plantillas Twig para formularios y referencia de variables","Enrutando","Contenido","Ip","Tipo de campo email","Paquetes de la edici\u00f3n est\u00e1ndar de Symfony","C\u00f3mo trabajar con m\u00faltiples gestores de entidad y conexiones","Colaborando","Trabajando con servicios etiquetados","Generando la estructura para un nuevo paquete","Anotaciones","Despachador de eventos","Un primer vistazo","Length","Range","Instalando","C\u00f3mo registrar mensajes en diferentes archivos de bit\u00e1cora","Luhn","Tipo de campo Form","File","Licencia Symfony2","C\u00f3mo utilizar Assetic para optimizar im\u00e1genes con funciones Twig","C\u00f3mo registrar escuchas y suscriptores de eventos","El tipo abstracto field","Bit\u00e1cora de eventos","C\u00f3mo enviar correo electr\u00f3nico","C\u00f3mo generar entidades desde una base de datos existente","C\u00f3mo usar las listas para el control de acceso (ACL)","Tipo de campo birthday","El componente HttpFoundation","Cortafuegos y el contexto de seguridad","2. Creando tus propios bloques","RoutingAutoBundle","El componente DomCrawler","C\u00f3mo utilizar el patr\u00f3n factor\u00eda para crear servicios","C\u00f3mo dominar y crear nuevos entornos","Instalando y configurando Symfony","C\u00f3mo generar formularios din\u00e1micamente usando eventos del formulario","C\u00f3mo utilizar y rutas Twig con espacios de nombres","Referencia de configuraci\u00f3n de Doctrine","C\u00f3mo utilizar la herencia de paquetes para redefinir partes de un paquete","C\u00f3mo definir controladores como servicios","Aportando c\u00f3digo","El componente Stopwatch","C\u00f3mo exponer la configuraci\u00f3n sem\u00e1ntica de un paquete","Tipo de campo language","DateTime","BlogBundle","C\u00f3mo configurar los filtros before y after","C\u00f3mo usar las mejores pr\u00e1cticas para estructurar paquetes","Componentes","Enrutando","Symfony2 frente a PHP simple","Configurando","El componente PropertyAccess","Usando el patr\u00f3n factor\u00eda para crear servicios","Configurando","Bases de datos y Doctrine","C\u00f3mo personalizar la reproducci\u00f3n de un formulario","C\u00f3mo usar extensiones Doctrine: Timestampable, Sluggable, Translatable, etc.","Configuring a web server","How to configure Empty Data for a Form Class","Email","Ayudante formateador","HTTP del n\u00facleo","Colaborando","C\u00f3mo simplificar la configuraci\u00f3n de m\u00faltiples paquetes","C\u00f3mo utilizar Monolog para escribir registros","El componente Finder","Tipo de campo choice","Corriendo las pruebas de Symfony2","Formato de documentaci\u00f3n","Tipo de campo entity","C\u00f3mo probar tus formularios","MaxLength","C\u00f3mo eliminar el AcmeDemoBundle","Max","Seguridad","False","Licencia de la documentaci\u00f3n de Symfony2","Recetario","Choice","El componente Config","Generador de perfiles","Definiendo y procesando valores de configuraci\u00f3n","How to simulate Authentication with a Token in a Functional Test","Language","Probando","3. Almacenando en cach\u00e9","C\u00f3mo configurar una redirecci\u00f3n a otra ruta sin un controlador personalizado","Instalando el recinto de seguridad del CMF","C\u00f3mo definir relaciones con interfaces y clases abstractas","El componente ClassLoader","C\u00f3mo integrar una colecci\u00f3n de formularios","Yaml","Creando y usando plantillas","C\u00f3mo usar el enrutador de Apache","Tipo de campo money","C\u00f3mo implementar un sencillo formulario de inscripci\u00f3n con MongoDB","All","Lenguaje de autorizaci\u00f3n basado en expresiones","@ParamConverter","Funcionamiento interno","Introduction to Parameters","CreateBundle","Usando \u00f3rdenes de consola, atajos y \u00f3rdenes integradas","Problemas de seguridad","Tipo de campo search","How to install 3rd party Bundles","SimpleCmsBundle","Autorizaci\u00f3n","Seguridad","JMSAopBundle","Controlador","Controlador","El componente Locale","M\u00e9todo de seguridad para autorizaci\u00f3n","Configuraci\u00f3n del FrameworkBundle (\u00abframework\u00bb)","C\u00f3mo utilizar Gmail para enviar mensajes de correo electr\u00f3nico","C\u00f3mo usar transformadores de datos","C\u00f3mo probar repositorios Doctrine","Generando un nuevo controlador","El componente Routing","Tipo de campo hidden","Configuring in the Kernel (e.g. AppKernel)","C\u00f3mo trabajar con \u00e1mbitos","Tipo de campo time","Construyendo una aplicaci\u00f3n de una sola orden","Fundamento HTTP","C\u00f3mo gestionar dependencias comunes con servicios padre","El componente Debug","El componente CssSelector","DoctrineMigrationsBundle","El controlador","Generando un controlador CRUD basado en una entidad de Doctrine","TreeBundle","TreeBrowserBundle","1. Tipos de bloque","C\u00f3mo cargar usuarios desde la base de datos con seguridad (el Proveedor de entidad)","El componente Inyecci\u00f3n de dependencias","C\u00f3mo registrar un nuevo formato de petici\u00f3n y tipo MIME","Regex","C\u00f3mo crear un escucha de evento","Configurando servicios con un configurador de servicio","C\u00f3mo probar la interacci\u00f3n de varios clientes","Collection","Instalando y configurando el n\u00facleo del CMF","Autenticaci\u00f3n","Blank","Consola","C\u00f3mo proteger cualquier servicio o m\u00e9todo de tu aplicaci\u00f3n","Glosario","Git","Los ayudantes de consola","Url","Referencia de configuraci\u00f3n de Monolog","Flujo de trabajo","C\u00f3mo crear una extensi\u00f3n del tipo \u00abForm\u00bb","Doctrine","C\u00f3mo habilitar el registro cronol\u00f3gico en la consola de ordenes","NotBlank","C\u00f3mo escribir una extensi\u00f3n Twig personalizada","El componente Inyecci\u00f3n de dependencias","Delegados confiables","Instalando la edici\u00f3n est\u00e1ndar del CMF de Symfony","Generando una nueva clase de tipo Form basada en una entidad Doctrine","Configurando","Petici\u00f3n","Bases de datos y Propel","Us\u00e1ndola","Otros recursos","Formularios","Reuniones IRC","Working with Container Service Definitions","C\u00f3mo utilizar par\u00e1metros del contenedor de servicios en tus rutas","Configurando el SwiftmailerBundle ("swiftmailer")","Tipo de campo datetime","C\u00f3mo usar los conceptos avanzados ACL","Tipo de campo textarea","El formato YAML","El componente Filesystem","Size","Min","How to use the Serializer","Etiquetas de inyecci\u00f3n de dependencias","Tipo de campo locale","Tipo de campo integer","Servicios web","C\u00f3mo manejar archivos subidos con Doctrine","C\u00f3mo utilizar m\u00e9todos HTTP adem\u00e1s de GET y POST en rutas","Cargando recursos","C\u00f3mo dibujar una plantilla sin un controlador personalizado","SonataDoctrinePhpcrAdminBundle","Integrando con Doctrine","C\u00f3mo registrar funciones DQL personalizadas","Documentos de referencia","La vista","C\u00f3mo sustituir la estructura de directorios predeterminada de Symfony","@Cache","CoreBundle","Comunidad","Tipo de campo repeated","C\u00f3mo personalizar p\u00e1ginas de error","Usando un repositorio de rutas personalizado con un enrutador din\u00e1mico","Colaborando en la documentaci\u00f3n","Ayudantes de di\u00e1logo","Informaci\u00f3n general","Libro","ContentBundle","C\u00f3mo utilizar Varnish para acelerar mi sitio web","Compilando el contenedor","Consola","SensioGeneratorBundle","C\u00f3mo utilizar Assetic para gestionar activos","C\u00f3mo permitir un car\u00e1cter \u00ab/\u00bb en un par\u00e1metro de ruta","Country","4. Relaci\u00f3n al paquete Block de Sonata","Usando BlockBundle y ContentBundle con PHPCR","How to Dynamically Modify Forms Using Form Events","Construyendo el flujo de trabajo del contenedor","Tipo de campo timezone","Colecci\u00f3n de servicios diferidos","Cach\u00e9 HTTP","C\u00f3mo cambiar el comportamiento predeterminado de la ruta destino","Date","El objeto evento gen\u00e9rico","Gestionando dependencias comunes con servicios padre","Contenedor consciente del despachador de eventos","C\u00f3mo crear y guardar un proyecto Symfony2 en git","DoctrineMongoDBBundle","Gestionando documentos multiling\u00fces","Contenedor de servicios","Creando p\u00e1ginas en Symfony2","Enrutando","Probando","Extensiones Twig de Symfony2","Licencia","Enrutando","SimpleCMS","SearchBundle","Instalando y configurando Doctrine y PHPCR-ODM","Est\u00e1ndares de codificaci\u00f3n","C\u00f3mo sustituir cualquier parte de un paquete","Type","C\u00f3mo hacer que tus servicios utilicen etiquetas","@Route y @Method","Tipo de campo password","Paquetes","Probando con sesiones","El componente Process","Tipo de campo number","Generador de n\u00fameros aleatorios seguros","C\u00f3mo utilizar el generador de perfiles en una prueba funcional","C\u00f3mo crear un tipo de campo personalizado para formulario","El componente YAML","El ayudante Progress","Config","Creando tus propieas funciones de expresi\u00f3n","RoutingExtraBundle","C\u00f3mo usar la consola","C\u00f3mo forzar HTTPS o HTTP a diferentes URL","Requisitos para que funcione Symfony2","C\u00f3mo personalizar el proceso de arranque antes de correr las pruebas","Aportando documentaci\u00f3n","Count","Validando","El componente HttpFoundation","CardScheme","Assetic","Propiedad Access","Despachador de eventos","C\u00f3mo usar la opci\u00f3n virtual en los campos de formulario","Inicio r\u00e1pido","C\u00f3mo configurar Monolog para reportar errores por correo electr\u00f3nico","El componente HttpKernel","El componente YAML","Inyecci\u00f3n de dependencias","Gesti\u00f3n de la sesi\u00f3n","SizeLength","Configurando DoctrineMongoDBBundle","Rendimiento","C\u00f3mo personalizar el comportamiento de un m\u00e9todo sin utilizar herencia","Valid","C\u00f3mo implementar tu propio votante para agregar direcciones IP a la lista negra"],objnames:{},filenames:["components/routing","cmf/index","components/event_dispatcher/introduction","reference/constraints/UserPassword","cookbook/service_container/compiler_passes","cookbook/routing/scheme","cookbook/configuration/external_parameters","components/console/introduction","cookbook/symfony1","cookbook/web_services/php_soap_extension","cookbook/profiler/data_collector","contributing/community/releases","reference/constraints/Email","reference/forms/types/url","book/service_container","components/using_components","quick_tour/the_architecture","bundles/JMSDiExtraBundle/index","cmf/tutorials/choosing-a-storage-layer","components/config/caching","cookbook/deployment-tools","bundles/JMSDiExtraBundle/installation","reference/forms/types/collection","bundles/DoctrineFixturesBundle/index","cmf/tutorials/installing-configuring-simple-cms","cookbook/security/form_login","index","bundles/JMSSecurityExtraBundle/index","reference/forms/types/date","reference/forms/types/radio","cookbook/configuration/pdo_session_storage","contributing/code/bugs","cookbook/validation/custom_constraint","contributing/code/patches","components/console/helpers/tablehelper","cookbook/console/console_command","reference/constraints/Locale","bundles/SensioFrameworkExtraBundle/index","reference/constraints/Null","components/options_resolver","cookbook/assetic/apply_to_option","cmf/cookbook/phpcr-odm-custom-documentclass-mapper","bundles/SensioFrameworkExtraBundle/annotations/view","cookbook/email/testing","reference/forms/types/checkbox","reference/constraints/UniqueEntity","components/event_dispatcher","contributing/code/conventions","cookbook/email/spool","components/http_foundation/session_configuration","reference/constraints/NotNull","components/console/events","cookbook/templating/global_variables","components/security/index","reference/constraints/True","reference/configuration/web_profiler","cookbook/templating/PHP","bundles/SensioGeneratorBundle/commands/generate_doctrine_entity","reference/configuration/security","cookbook/cache/index","book/translation","components/console","cookbook/security/custom_authentication_provider","cookbook/templating/index","cookbook/email/dev_environment","components/templating","bundles/JMSDiExtraBundle/annotations","reference/forms/types/file","reference/configuration/twig","components/security/introduction","cmf/bundles/phpcr-odm","cookbook/assetic/yuicompressor","components/serializer","components/dependency_injection/advanced","cookbook/doctrine/registration_form","reference/constraints","reference/forms/types/csrf","cmf/bundles/block","cookbook/doctrine/dbal","reference/constraints/MinLength","reference/constraints/Callback","cookbook/routing/custom_route_loader","reference/forms/types/percent","cookbook/routing/index","book/http_fundamentals","reference/forms/types/country","cmf/tutorials/creating-cms-using-cmf-and-sonata","cookbook/configuration/front_controllers_and_kernel","reference/forms/types","contributing/documentation/translations","cookbook/console/sending_emails","components/dependency_injection/types","cookbook/workflow/new_project_svn","book/validation","cookbook/event_dispatcher/class_extension","reference/constraints/Time","cmf/bundles/menu","reference/forms/types/text","cookbook/security/remember_me","book/forms","cookbook/testing/http_authentication","cmf/tutorials/installing-configuring-inline-editing","cookbook/security/custom_provider","reference/configuration/assetic","cookbook/debugging","reference/constraints/Image","components/routing/hostname_pattern","book/stable_api","cmf/getting-started/menu","reference/forms/twig_reference","cmf/getting-started/routing","cmf/getting-started/content","reference/constraints/Ip","reference/forms/types/email","bundles/index","cookbook/doctrine/multiple_entity_managers","cmf/contributing/code","components/dependency_injection/tags","bundles/SensioGeneratorBundle/commands/generate_bundle","bundles/JMSSecurityExtraBundle/annotations","components/event_dispatcher/index","quick_tour/the_big_picture","reference/constraints/Length","reference/constraints/Range","bundles/JMSSecurityExtraBundle/installation","cookbook/logging/channels_handlers","reference/constraints/Luhn","reference/forms/types/form","reference/constraints/File","contributing/code/license","cookbook/assetic/jpeg_optimize","cookbook/doctrine/event_listeners_subscribers","reference/forms/types/field","cookbook/logging/index","cookbook/email/email","cookbook/doctrine/reverse_engineering","cookbook/security/acl","reference/forms/types/birthday","components/http_foundation","components/security/firewall","cmf/bundles/block/create_your_own_blocks","cmf/bundles/routing_auto","components/dom_crawler","cookbook/service_container/factories","cookbook/configuration/environments","book/installation","cookbook/form/dynamic_form_generation","cookbook/templating/namespaced_paths","reference/configuration/doctrine","cookbook/bundles/inheritance","cookbook/controller/service","contributing/code/index","components/stopwatch","cookbook/bundles/extension","reference/forms/types/language","reference/constraints/DateTime","cmf/bundles/blog","cookbook/event_dispatcher/before_after_filters","cookbook/bundles/best_practices","components/index","components/routing/index","book/from_flat_php_to_symfony2","bundles/JMSSecurityExtraBundle/configuration","components/property_access/introduction","components/dependency_injection/factories","bundles/JMSDiExtraBundle/configuration","book/doctrine","cookbook/form/form_customization","cookbook/doctrine/common_extensions","cookbook/configuration/web_server_configuration","cookbook/form/use_empty_data","cookbook/email/index","components/console/helpers/formatterhelper","components/http_kernel/index","contributing/index","cookbook/bundles/prepend_extension","cookbook/logging/monolog","components/finder","reference/forms/types/choice","contributing/code/tests","contributing/documentation/format","reference/forms/types/entity","cookbook/form/unit_testing","reference/constraints/MaxLength","cookbook/bundles/remove","reference/constraints/Max","book/security","reference/constraints/False","contributing/documentation/license","cookbook/index","reference/constraints/Choice","components/config/introduction","cookbook/profiler/index","components/config/definition","cookbook/testing/simulating_authentication","reference/constraints/Language","cookbook/testing/index","cmf/bundles/block/cache","cookbook/routing/redirect_in_config","cmf/cookbook/installing-cmf-sandbox","cookbook/doctrine/resolve_target_entity","components/class_loader","cookbook/form/form_collections","components/yaml/index","book/templating","cookbook/configuration/apache_router","reference/forms/types/money","bundles/DoctrineMongoDBBundle/form","reference/constraints/All","bundles/JMSSecurityExtraBundle/expressions","bundles/SensioFrameworkExtraBundle/annotations/converters","book/internals","components/dependency_injection/parameters","cmf/bundles/create","components/console/usage","contributing/code/security","reference/forms/types/search","cookbook/bundles/installation","cmf/bundles/simple-cms","components/security/authorization","cookbook/security/index","bundles/JMSAopBundle/index","book/controller","cookbook/controller/index","components/locale","bundles/JMSSecurityExtraBundle/method_security_authorization","reference/configuration/framework","cookbook/email/gmail","cookbook/form/data_transformers","cookbook/testing/doctrine","bundles/SensioGeneratorBundle/commands/generate_controller","components/routing/introduction","reference/forms/types/hidden","reference/configuration/kernel","cookbook/service_container/scopes","reference/forms/types/time","components/console/single_command_tool","components/http_foundation/index","cookbook/service_container/parentservices","components/debug","components/css_selector","bundles/DoctrineMigrationsBundle/index","quick_tour/the_controller","bundles/SensioGeneratorBundle/commands/generate_doctrine_crud","cmf/bundles/tree","cmf/bundles/tree-browser","cmf/bundles/block/types","cookbook/security/entity_provider","components/dependency_injection","cookbook/request/mime_type","reference/constraints/Regex","cookbook/service_container/event_listener","components/dependency_injection/configurators","cookbook/testing/insulating_clients","reference/constraints/Collection","cmf/tutorials/installing-cmf-core","components/security/authentication","reference/constraints/Blank","cookbook/console/index","cookbook/security/securing_services","glossary","contributing/code/git","components/console/helpers/index","reference/constraints/Url","reference/configuration/monolog","cookbook/workflow/index","cookbook/form/create_form_type_extension","cookbook/doctrine/index","cookbook/console/logging","reference/constraints/NotBlank","cookbook/templating/twig_extension","components/dependency_injection/introduction","components/http_foundation/trusting_proxies","cmf/getting-started/installing-symfony-cmf","bundles/SensioGeneratorBundle/commands/generate_doctrine_form","cookbook/configuration/index","cookbook/request/index","book/propel","bundles/JMSDiExtraBundle/usage","contributing/community/other","cookbook/form/index","contributing/community/irc","components/dependency_injection/definitions","cookbook/routing/service_container_parameters","reference/configuration/swiftmailer","reference/forms/types/datetime","cookbook/security/acl_advanced","reference/forms/types/textarea","components/yaml/yaml_format","components/filesystem","reference/constraints/Size","reference/constraints/Min","cookbook/serializer","reference/dic_tags","reference/forms/types/locale","reference/forms/types/integer","cookbook/web_services/index","cookbook/doctrine/file_uploads","cookbook/routing/method_parameters","components/config/resources","cookbook/templating/render_without_controller","cmf/bundles/doctrine_phpcr_admin","bundles/JMSDiExtraBundle/doctrine","cookbook/doctrine/custom_dql_functions","reference/index","quick_tour/the_view","cookbook/configuration/override_dir_structure","bundles/SensioFrameworkExtraBundle/annotations/cache","cmf/bundles/core","contributing/community/index","reference/forms/types/repeated","cookbook/controller/error_pages","cmf/cookbook/using-a-custom-route-repository","contributing/documentation/overview","components/console/helpers/dialoghelper","cmf/getting-started/overview","book/index","cmf/bundles/content","cookbook/cache/varnish","components/dependency_injection/compilation","components/console/index","bundles/SensioGeneratorBundle/index","cookbook/assetic/asset_management","cookbook/routing/slash_in_parameter","reference/constraints/Country","cmf/bundles/block/relation_to_sonata_block_bundle","cmf/tutorials/using-blockbundle-and-contentbundle","cookbook/form/dynamic_form_modification","components/dependency_injection/workflow","reference/forms/types/timezone","bundles/JMSDiExtraBundle/lazy_service_collections","book/http_cache","cookbook/security/target_path","reference/constraints/Date","components/event_dispatcher/generic_event","components/dependency_injection/parentservices","components/event_dispatcher/container_aware_dispatcher","cookbook/workflow/new_project_git","bundles/DoctrineMongoDBBundle/index","cmf/tutorials/handling-multilang-documents","cookbook/service_container/index","book/page_creation","cmf/components/routing","book/testing","reference/twig_reference","cmf/contributing/license","book/routing","cmf/getting-started/simplecms","cmf/bundles/search","cmf/tutorials/installing-configuring-doctrine-phpcr-odm","contributing/code/standards","cookbook/bundles/override","reference/constraints/Type","cookbook/service_container/tags","bundles/SensioFrameworkExtraBundle/annotations/routing","reference/forms/types/password","cookbook/bundles/index","components/http_foundation/session_testing","components/process","reference/forms/types/number","bundles/JMSSecurityExtraBundle/random_number_generator","cookbook/testing/profiling","cookbook/form/create_custom_field_type","components/yaml","components/console/helpers/progresshelper","components/config/index","bundles/JMSSecurityExtraBundle/cookbook/creating_your_own_expression_function","cmf/bundles/routing-extra","cookbook/console/usage","cookbook/security/force_https","reference/requirements","cookbook/testing/bootstrap","contributing/documentation/index","reference/constraints/Count","cookbook/validation/index","components/http_foundation/introduction","reference/constraints/CardScheme","cookbook/assetic/index","components/property_access/index","cookbook/event_dispatcher/index","cookbook/form/use_virtuals_forms","quick_tour/index","cookbook/logging/monolog_email","components/http_kernel/introduction","components/yaml/introduction","components/dependency_injection/index","components/http_foundation/sessions","reference/constraints/SizeLength","bundles/DoctrineMongoDBBundle/config","book/performance","cookbook/event_dispatcher/method_behavior","reference/constraints/Valid","cookbook/security/voters"]}) \ No newline at end of file