Sobre Symfony 2 : http://symfony-reloaded.org
Código http://github.com/symfony

¿Qué es Symfony 2?

Symfony 2 es una reescritura completa de su código original, el cual se enfoca en resolver los problemas de las anteriores versiones ( 1.0 a 1.4). Symfony, se convirtió en una herraminta apreciada por la comunidad PHP. Tiene una gran cantidad de plugins que resuelven distintos desafios y promete un mejor uso de los recursos que como lo hacia symfony 1.

¿Porque Symfony 2 para phpBB4?

La siguiente lista explica en cada punto las razones. La misma esta basada en los items de los Principios de Programación de phpBB4.

• phpBB4: PHP 5.3+
  • Symfony 2 fue re-escrito en PHP5.3, consistentemente con el enfoque de phpBB4.
• phpBB4: Hace uso de namespaces y de la autocarga standar.
  • Symfony 2 es el primer framework en seguir el autoloading standard de PHP5.3, mejorando la interoperabilidad del proyecto PHP.
• phpBB4: Código limpio y modular orientado a objetos con clases desacopladas
  • Symfony 2 es un framework orientado a objetos. De arquitectura simple y fácil API.
• phpBB4: Los Plugins pueden completamente reemplazar MODs sin ningun cambio en el código
  • Symfony 2: Como se menciono antes Symfony 2 esta en bundles que no necesitan de modificaciones. Symfony 2 hace uso de códifo generado.
• phpBB4: Usar existentes librerias / frameworks en luhar de reinventar la rueda
  • Symfony 2: El uso de un framework como Symfony 2 ya casi permite esto. Además Symfony 2 digue de cerca al Zend Framework.
• phpBB4: Fácil integración con software
  • Symfony 2: Usando Symfony 2 phpBB4 automaticamente podrá integrarse en un proyecto Symfony cualquiera. El diseño de Symfony 2 también requiere que hagamos phpBB de manera modular,.
• phpBB4: Escalabilidad (ejecutarse sobre clusters)
  • Symfony 2: Symfony tiene una historia de ejecutar grandes services, y Symfony 2 esta diseñado para la alta performance.
• phpBB4: Consistente con el uso de Dependency Injection
  • Symfony 2 esta construido alrededor de un Dependency Injection Container, usando Dependency Injection por todos lados.
• phpBB4: Pruebas automatizadas: Pruebas Unitarias, integración de pruebas y pruebas funcionales con PHPUnit, Selenium
  • Symfony 2 tiene ya las pruebas automatizadas y permite a los proyectos usar cualquier framework de pruebas.
• phpBB4: Un framework de desarrollo para phpBB (hacer aplicaciones basadas en phpBB, estandarizar nuestro framework en una libreria)
  • Symfony 2 es un framework y tiene mas sentido que hacer uno específico para phpBB. Partes de phpBB serán reusables.

Es absolutamente asombroso como Symfony 2 coincide con los requisitos de phpBB4.

¿Que otra cosa puede Symfony 2 dar?

Ya que su comunidad es muy grande, podemos contar con mas desarrolladores y mas aportes. Los clientes necesitan una integración de un foro dentro de un proyecto Symfony y es problema común para los programadores. En vez de crear un propio, se puede usar phpBB integrado. Los desarrolladores con esta necesidad pueden ayudar a phpBB.

Para conocer mas http://symfony-reloaded.org

La encuesta sigue en http://spreadsheets.google.com/viewform?formkey=dFVFLXdBcGNvcFEwdVZmN3ZLU193cmc6MA

Como recordaran por el benchmark que comente aqui http://groups.google.com/group/symfony-es/browse_thread/thread/6a6cc2ec5b1d0920/66bdce04bcd7a2b4?hl=en#66bdce04bcd7a2b4

Pronto publicare el resultado de usar SF1.3+Doctrine2 con el resto de los resultados existentes en  http://www.puentesdiaz.com.ar/blog/?p=167

Hasta ahora, el ranking del mas veloz, queda así

Symfony 1.3 ALPHA2 + Propel 1.4 BETA

supera a

Symfony 1.3 ALPHA2 + Propel 1.3 Final

supera a

Symfony 1.3 ALPHA2 + Doctrine 1.2 Final

Lo curioso es que Propel sigue siendo mucha mas rápido que Doctrine, e incluso a partir de las modificaciones que tiene PROPEL 1.4… es aun mas rápido… mucho mas rápido

Segun me comenta Francois Zaninotto en http://groups.google.com/group/propel-users/msg/8c512ae7c5f91059?hl=en
Si eliminamos los tiempos de carga propios de Symfony, es decir lo ajeno a los ORM. El verdadero rendimiento del ORM, se deja ver. Mostrando un rendimiento de casi el doble del calculado inicialmente.

Una explicaciones la expone aqui
http://groups.google.com/group/propel-users/msg/e1fa266179ae20da?hl=en

En pocas palabras, se puede decir que este es otro ejemplo de “sobreingenieria”. Doctrine es muy impresionante por todo lo ofrecido. Una fuerte OO, etc.

Sin embargo, la eleccion entre PROPEL y DOCTRINE, se me presenta como otro caso en que debemos determinar donde esta linea. Merece hacer tanta herencia de clases? Hasta cuanto podemos renunciar al rendimiento…

Hasta ahora la encuesta muestra unos votos a favor de Doctrine…. Yo por mi parte le doy mi voto a PROPEL

El tutorial como es lógico está en constante cambio, revisando errores, y mejorando sus partes, con el finde dar un mejor recurso para los rrhh de las empresas. Con mejores versiones de cada una de sus partes así como el uso de las mejores prácticas del mundo profesional de desarrollo web
Y aunque esta muy bien realizado, se recomienda ver las últimos cambios en cada día del tutorial.

Como siempre, para nuestros dos más queridos ORMs

Symfony 1.3 + Propel:
http://www.symfony-project.org/jobeet/1_3/Propel/es/

Symfony 1.3 + Doctrine:
http://www.symfony-project.org/jobeet/1_3/Doctrine/es/

Symfony 1.2 + Propel:
http://www.symfony-project.org/jobeet/1_2/Propel/es/

Symfony 1.2 + Doctrine:
http://www.symfony-project.org/jobeet/1_2/Doctrine/es/

El planteo: Siguiendo Practical Jobeet con Propel y Doctrine, y usando Symfony1.3 ¿Cuanto demora interactuar con un simple ABM? Well, it’s just very initial

The problem: Follow Practical Jobeet with Propel and Doctrine, and using Symfony1.3, How long takes interac with a simple CRUD? Leyendo los Capítulos 1 y 3, para cada ORM, y envolviendo el controlador para el entorno DEV en un archivo benchmark estos fueron los tiempos.Los reportes tienen este formato:
0 _ORM_WEBDIR_URL-TIEMPO.BMK Reading the Chapters 1 and 3, for each ORM, and warp to front controller for DEV enviorement inside a benchmark file, these is the resultsThe reports has this format:
0 _ORM_WEBDIR_URL-TIME.BMK Luego de generar el projecto y la aplicación After generate project and application 0 _propel_web_benchmark.php-0.12712812423706.BMK

0 _doctrine_web_benchmark.php-0.1438159942627.BMK Luego de cargar los datos iniciales After load data 0 _propel_web_benchmark.php-0.13877201080322.BMK

0 _doctrine_web_benchmark.php-0.1630699634552.BMK Luego de la generacion del modulo y creacion del ABM After generate modele and create the CRUD 0 _propel_web_benchmark.php_job-0.16423082351685.BMK

Otros test, note que “ORM_WEBDIR_URL” tiene reemplazados los “/” por unos “_”, asi sabemos que test ejecutamos

Others test, note that “ORM_WEBDIR_URL” has replace the  “/” by “_”, thus we know which test run

20/10/2009  16:48                 0 _propel_web_benchmark.php_job-0.18634295463562.BMK 20/10/2009  16:48                 0 _propel_web_benchmark.php_job-0.20151519775391.BMK 20/10/2009  16:58                 0 _propel_web_benchmark.php_job_create-0.21860218048096.BMK 20/10/2009  16:56                 0 _propel_web_benchmark.php_job_create-0.25584602355957.BMK 20/10/2009  16:55                 0 _propel_web_benchmark.php_job_edit_id_1-0.24364185333252.BMK 20/10/2009  16:56                 0 _propel_web_benchmark.php_job_new-0.22872591018677.BMK 20/10/2009  16:50                 0 _propel_web_benchmark.php_job_show_id_1-0.17427802085876.BMK

20/10/2009  16:48                 0 _doctrine_web_benchmark.php_job-0.22568798065186.BMK 20/10/2009  16:48                 0 _doctrine_web_benchmark.php_job-0.27266120910645.BMK 20/10/2009  16:57                 0 _doctrine_web_benchmark.php_job_create-0.29636907577515.BMK 20/10/2009  16:58                 0 _doctrine_web_benchmark.php_job_create-0.31708693504333.BMK 20/10/2009  16:50                 0 _doctrine_web_benchmark.php_job_edit_id_1-0.36150407791138.BMK 20/10/2009  16:56                 0 _doctrine_web_benchmark.php_job_new-0.27971601486206.BMK 20/10/2009  16:50                 0 _doctrine_web_benchmark.php_job_show_id_1-0.27344703674316.BMK

Probando ahora con Symfony 1.3 y el nuevo Propel 1.4

Testing with Symfony 1.3 and the new one Propel 1.4

22/10/2009  14:01-> 0 _sfFULL_propel_web_benchmark.php-0.13401699066162.BMK 22/10/2009  14:07-> 0 _sfFULL_propel_web_benchmark.php_job-0.16235113143921.BMK 22/10/2009  14:07-> 0 _sfFULL_propel_web_benchmark.php_job-0.16368754986478.BMK 22/10/2009  14:08-> 0 _sfFULL_propel_web_benchmark.php_job_create-0.21050310134888.BMK 22/10/2009  14:08-> 0 _sfFULL_propel_web_benchmark.php_job_create-0.21248616913548.BMK 22/10/2009  14:07-> 0 _sfFULL_propel_web_benchmark.php_job_edit_id_1-0.25051593780518.BMK 22/10/2009  14:08-> 0 _sfFULL_propel_web_benchmark.php_job_edit_id_3-0.24934816360474.BMK 22/10/2009  14:07-> 0 _sfFULL_propel_web_benchmark.php_job_new-0.24454116821289.BMK 22/10/2009  14:04-> 0 _sfFULL_propel_web_benchmark.php_job_show_id_3-0.17340588569641.BMK 22/10/2009  14:08-> 0 _sfFULL_propel_web_benchmark.php_job_update_id_3-0.14927196502686.BMK

RESULTADOS

Symfony 1.3 + Propel 1.4 > Symfony 1.3 + Propel 1.3 > Symfony 1.3 + Doctrine 1.2

Comparando (%) Propel 1.4 y Doctrine 1.2

Comparation (%) Propel 1.4 and Doctrine 1.2

Sabiendo que Symfony 1.3 le toma 0.10 en carga todo, sin hacer uso de la DDBB

Knowing that Symfony 1.3 take 0.10 autoload all, without use the DDBB

Propel 1.4 beta 22/10/2009  14:04            0 _sfFULL_propel_web_benchmark.php_job_show_id_3-0.17340588569641.BMK Propel 1.3 20/10/2009  16:50            0 _propel_web_benchmark.php_job_show_id_1-0.17427802085876.BMK Doctrine 1.2 20/10/2009  16:50            0 _doctrine_web_benchmark.php_job_show_id_1-0.27344703674316.BMK Comparativa ORM Inicial ( Propel 1.4 / Doctrine 1.2 ) : ( 0.173 ) / ( 0.273 ) = 63% Comparativa ORM Real ( Propel 1.4 / Doctrine 1.2 ) : ( 0.173 – 0.10 ) / ( 0.273 – 0.10 ) = 42%

Propel 1.4 beta 22/10/2009  14:08            0 _sfFULL_propel_web_benchmark.php_job_create-0.21248616913548.BMK Propel 1.3 20/10/2009  16:56            0 _propel_web_benchmark.php_job_create-0.25584602355957.BMK Doctrine 1.2 20/10/2009  16:58            0 _doctrine_web_benchmark.php_job_create-0.31708693504333.BMK Comparativa ORM Inicial ( Propel 1.4 / Doctrine 1.2 ) : ( 0.212 ) / ( 0.317 ) = 66% Comparativa ORM Real ( Propel 1.4 / Doctrine 1.2 ) : ( 0.212 – 0.10 ) / ( 0.317 – 0.10 ) = 51%

Sin querer ofender a nadie , pero… Propel es dos veces más rápido

I don’t want offend to anyone , but… Propel is twice faster

Una gran cantidad de cosas impresionantes, se han añadido recientemente a la proxima gran entrega de symfony 1.2. Fabien ha trabajado muy duro para agregar sin dudas las más sofisticadas características que cualquier otro framework PHP pudiera tener hoy en día. No sólo son características agradables sino que fueron implementadas Orientada a Objeto por lo que ha sido sencillo para mi implmentar algunas características con otro ORM, Doctrine.Todo esto se hizo con muy poco trabajo de mi parte. Por lo tanto, doy muchas gracias a él y disfruta de este artículo.

Ejemplo del mundo real

En este artículo voy a empezar desde el principio con un nuevo proyecto symfony 1.2 para que puedas ponerte en marcha con Doctrine. Vamos a utilizar un esquema típico de tu sistema de gestión de contenidos. El esquema consta de los artículos, los autores y categorías donde los artículos son internacionalizados.

Comienza tu Proyecto

En primer lugar necesitas inicializar un nuevo proyecto symfony 1.2 y inicializar un app backend. Asegúrate de que estás utilizando el último código del svn pues beta1 no incluye esta funcionalidad de Doctrine.

Generar tu proyecto

mkdir cms
cd cms
symfony generate:project cms

Generar la aplicación backend

symfony generate:app backend

Todo el mundo encienda su Doctrine

Ahora tenemos que habilitar Doctrine y desactivar Propel Edita tu config/ProjectConfiguration.class.php y agregue el código siguiente a tu función setup().

public function setup()
{
  $this->enablePlugins(array('sfDoctrinePlugin'));
  $this->disablePlugins(array('sfPropelPlugin'));
}

Ahora que Doctrine está habilitado podemos enumerar las tareas disponibles de Doctrine:

./symfony list doctrine

Available tasks for the "doctrine" namespace:
  :build-all                   Generates Doctrine model, SQL and initializes the database (doctrine-build-all)
  :build-all-load              Generates Doctrine model, SQL, initializes database, and load data (doctrine-build-all-load)
  :build-all-reload            Generates Doctrine model, SQL, initializes database, and load data (doctrine-build-all-reload)
  :build-all-reload-test-all   Generates Doctrine model, SQL, initializes database, load data and run all test suites (doctrine-build-all-reload-test-all)
  :build-db                    Creates database for current model (doctrine-build-db)
  :build-filters               Creates filter form classes for the current model
  :build-forms                 Creates form classes for the current model (doctrine-build-forms)
  :build-model                 Creates classes for the current model (doctrine-build-model)
  :build-schema                Creates a schema from an existing database (doctrine-build-schema)
  :build-sql                   Creates SQL for the current model (doctrine-build-sql)
  :data-dump                   Dumps data to the fixtures directory (doctrine-dump-data)
  :data-load                   Loads data from fixtures directory (doctrine-load-data)
  :dql                         Execute a DQL query and view the results (doctrine-dql)
  :drop-db                     Drops database for current model (doctrine-drop-db)
  :generate-admin              Generates a Doctrine admin module
  :generate-migration          Generate migration class (doctrine-generate-migration)
  :generate-migrations-db      Generate migration classes from existing database connections (doctrine-generate-migrations-db, doctrine-gen-migrations-from-db)
  :generate-migrations-models  Generate migration classes from an existing set of models (doctrine-generate-migrations-models, doctrine-gen-migrations-from-models)
  :generate-module             Generates a Doctrine module (doctrine-generate-crud, doctrine:generate-crud)
  :generate-module-for-route   Generates a Doctrine module for a route definition
  :insert-sql                  Inserts SQL for current model (doctrine-insert-sql)
  :migrate                     Migrates database to current/specified version (doctrine-migrate)
  :rebuild-db                  Creates database for current model (doctrine-rebuild-db)

El Esquema

Ahora empieza la diversión. Tenemos Doctrine habilitado por lo que la primera cosa que necesitamos es definir nuestro esquema del CMS en config/doctrine/schema.yml.

---
Article:
  actAs:
    Timestampable:
    I18n:
      fields: [title, content]
  columns:
    author_id: integer
    status:
      type: enum
      values: [Draft, Published]
      notnull: true
    title:
      type: string(255)
      notnull: true
    content:
      type: clob
      notnull: true
    is_on_homepage: boolean
    published_at: timestamp
  relations:
    Author:
      foreignAlias: Articles
    Categories:
      class: Category
      refClass: ArticleCategory
      foreignAlias: Articles
 
Category:
  columns:
    name:
      type: string(255)
      notnull: true
 
Author:
  columns:
    name:
      type: string(255)
      notnull: true
    about: string(1000)
 
ArticleCategory:
  columns:
    article_id: integer
    category_id: integer
  relations:
    Article:
      foreignAlias: ArticleCategories
    Category:
      foreignAlias: ArticleCategories
 

Datos Fixtures

Tenemos nuestro esquema, ahora necesitamos algunos datos para ponerlo a prueba por lo que copia de los siguientes YAML en data/fixtures/data.yml

---
Article:
  Article_1:
    Author: jwage
    status: Published
    is_on_homepage: true
    published_at: ''
    Categories: [article, ontheedge]
    Translation:
      en:
        title: symfony 1.2 and Doctrine
        content: Article about the new Doctrine integration in symfony 1.2
      fr:
        title: symfony 1.2 et doctrine
        content: Article sur l'intégration de Doctrine dans symfony 1.2

Author:
  jwage:
    name: Jonathan H. Wage
    about: Jonathan is the lead developer of the Doctrine project and is also a core contributor to the symfony project.

Category:
  article:
    name: Article
  tutorial:
    name: Tutorial
  ontheedge:
    name: Living on the edge
 

Desarrollo y Pruebas

Ahora que tenemos nuestro esquema y los datos tenemos todo lo que necesitamos para inicializar nuestra base de datos, modelos, formularios, datos, etc. Esto puede ser hecho con el muy simplemente comando siguiente:

./symfony doctrine:build-all-reload --no-confirmation
>> doctrine  dropping databases
>> doctrine  creating databases
>> doctrine  generating model classes
>> doctrine  generating sql for models
>> doctrine  generating form classes
>> doctrine  generating filter form classes
>> doctrine  created tables successfully
>> doctrine  loading data fixtures from "/Us...ymfony12doctrine/data/fixtures"

Eso fue demasiado fácil, cuando se va a poner difícil? Ahora vamos a hacer la inspección con DQL para ver los datos que se cargaron correctamente.

./symfony doctrine:dql "FROM Article a, a.Author a2, a.Translation t"
>> doctrine  executing dql query
DQL: FROM Article a, a.Author a2, a.Translation t
found 1 results
-
  id: '1'
  author_id: '1'
  status: Published
  is_on_homepage: true
  published_at: '2008-11-06 04:37:11'
  created_at: '2008-11-06 16:37:11'
  updated_at: '2008-11-06 16:37:11'
  Author:
    id: '1'
    name: 'Jonathan H. Wage'
    about: 'Jonathan is the lead developer of the Doctrine project and is also a core contributor to the symfony project.'
  Translation:
    en:
      id: '1'
      title: 'symfony 1.2 and Doctrine'
      content: 'Article about the new Doctrine integration in symfony 1.2'
      lang: en
    fr:
      id: '1'
      title: 'symfony 1.2 et doctrine'
      content: 'Article sur l''intégration de Doctrine dans symfony 1.2'
      lang: fr

Esto puede ser su primer gusto del Doctrine Query Language, también conocido como DQL. Se parece mucho a SQL no? Cierre la boca, que estás babeando.

Para aquellos de ustedes que no quieran escribir cadenas de DQL, no te preocupes tenemos un completo objeto Doctrine_Query para la construcción de tus consultas.

$q = Doctrine_Query::create()
  ->from('Article a, a.Author a2, a.Translation t');
$articles = $q->execute();

Generadores de Admin

Ahora que tenemos todo construido, podemos empezar a generar algunas cosas con la magia symfony. Vamos a empezar por la definición de la Colecciones de Rutas para la gestión de nuestros artículos, autores y categorías. Abre apps/backend/config/routing.yml en tu editor y pega las siguientes rutas dentro.

articles:
  class:         sfDoctrineRouteCollection
  options:
    model:       Article
    module:      articles
    with_show:   true
    collection_actions: { filter: post, batch: post }

categories:
  class:         sfDoctrineRouteCollection
  options:
    model:       Category
    module:      categories
    with_show:   true
    collection_actions: { filter: post, batch: post }

authors:
  class:         sfDoctrineRouteCollection
  options:
    model:       Author
    module:      authors
    with_show:   true
    collection_actions: { filter: post, batch: post }

Estas rutas nos permitirán generar un módulo generador de administrador para la gestión de los datos a través de cada uno de los modelos de Doctrine. Ejecute los siguientes comandos para generar los tres módulos.

./symfony doctrine:generate-admin backend articles
$ ./symfony doctrine:generate-admin backend categories
$ ./symfony doctrine:generate-admin backend authors

Ahora, cuando tiene acceso al modulo categories desde el backend deberías ver lo siguiente.

Ahora deseas, perrsonalizar un poco los artículos generados de admin para mostrar sólo una serie de campos en la lista y los filtros del formulario. Puedes hacerlo editando el generator.yml situado en apps/backend/modules/categories/config/generator.yml.

config:
  list:
    display:  [title, published_at, is_on_homepage, status]
  filter:
    class:    ArticleFormFilter
    display:  [author_id, status, is_on_homepage, published_at, categories_list]

Puedes personalizar los otros módulos de la misma forma.

Ahora, si cambia la URL ?sf_culture=fr en su URL el título se mostrará la versión en francés. Debería ver lo siguiente en su navegador cuando levantes hacia arriba el módulo de artículos.

Edición de Traducciones

Ahora, ¿cómo trabaja la edición de esas traducciones? Si te acuerdas de esto con los antiguos generadores de admin, era casi imposible. Ahora, se trata de una cuestión de añadir una línea de código a nuestro ArticleForm. Todo que tenemos que hacer es embeber/integrar/fusionar el formulario ArticleTranslation. Esto se puede hacer editando lib/form/doctrine/ArticleForm.class.php y añadiendo el código siguiente al configure()

public function configure()
{
  $this->embedI18n(array('en', 'fr'));
}

Ahora, cuando editas un artículo, verás que tienes la capacidad de editar directamente las traducciones dentro del artículo.

Ahora que está muy bien pero que si deseas editar el Author directamente dentro del Article como así y que se cree un nuevo Author si no existe y el uso del actual Author si ese nombre existe. Esto es simple.

Editar / Añadir autor

Con el fin de añadir la funcionalidad descrita anteriormente tenemos que añadir un poco de código en tres lugares diferentes. En primer lugar necesitas embeber el formulario Author en el formulario Article editando lib/form/doctrine/ArticleForm.class.php y agregue el código siguiente.

public function configure()
{
  unset($this['author_id']);
  $authorForm = new AuthorForm($this->getObject()->getAuthor());
  unset($authorForm['about']);
  $this->embedForm('Author', $authorForm);

  $this->embedI18n(array('en', 'fr'));
}

Optionally Optimize Queries

Ahora podemos modificar las acciones de la clase articles para que se le sumen el Autor y la Traducción a fin de que los datos se sumen a la consulta principal y no perezosamente cargado por Doctrine invocando adicionales consultas a la base de datos. Este paso es opcional. Abre apps/backend/modules/articles/actions/actions.class.php y sobreescribe la función executeEdit().

public function executeEdit(sfWebRequest $request)
{
  $this->article = Doctrine_Query::create()
    ->from('Article a')
    ->leftJoin('a.Author a2')
    ->leftJoin('a.Translation t')
    ->where('a.id = ?', $request->getParameter('id'))
    ->fetchOne();
  $this->form = $this->configuration->getForm($this->article);
}

Ahora, al ver la la edición y la creación de un artículo verá el formulario incorporado para el autor con la información existente.

Ahora el último paso es decir a Doctrine para que busque objetos existentes de Author la hora de establecer el nombre para que un nombre duplicado de Author no sea creado. Edita lib/model/doctrine/Author.class.php y sobreescribe el name mutator añadiendo el siguiente código.

public function setName($name)
{
  $name = trim($name);
  $found = Doctrine_Query::create()
    ->select('a.id')
    ->from('Author a')
    ->where('a.name = ?', $name)
    ->fetchOne(array(), Doctrine::HYDRATE_ARRAY);
  if ($found)
  {
    $this->assignIdentifier($found['id']);
  } else {
    $this->_set('name', $name);
  }
}

El código anterior será para verificar si un Author con el nombre pasado ya existe, Si existe se asignará el identificador del registro encontrado de lo contrario es lo que normalmente haría, establecer el nombre para el objeto.

Los métodos _set() y _get() deben utilizarse para evitar un bucle infinito cuando se sobrescriben accessors y mutators.

Wow, lo que realmente acaba de construir todo un backend para gestionar el contenido de un simple sistema de gestión de contenido en menos de una hora? Estamos seguros de que sí. Pruébalo y disfruta el desarrollo de ricas funcionalidad basada en web utilizando symfony y Doctrine.

La presente, es una traducción al castellano realizada por Roberto G. Puentes Diaz,
sobre el artículo new-in-symfony-1-2-doctrine-goodies de Jonathan Wage.

Este trabajo esta licenciado bajo una Licencia Creative Commons Atribución-No Comercial-Sin Obras Derivadas 3.0 Unported.

Si bien, gracias a symfony y al autocompletado, se hace todo muy intuitivo. Con Eclipse podemos hacernos nuestros propios atajos de codigo.

Menu  > Window > Preferences > PHP  > Templates

Nos ofrecera la posibilidad de editar los existentes o de crear uno nuevo. Le damos a NEW y debemos tener algo asi:

Captura de como crear un template de código PHP en Eclipse PDT

Es quizás muy petulante el título, pero esa es la idea. Osea Generar el Modelo.

Como seguro ya se darían cuenta, con anteriores artículos y traducciones, estoy estudiando symfony 1.2 para mi proyecto.

Una de las cosas que hice primero fue hacer un ambiente para mis pruebas, con el fin de tener un ámbito para jugar a lo que se me ocurra. Osea que mi schema tiene muchas cosas, pero como es de pruebas … que va!

Una de las cosas que siempre me gusto es lo del método mágico __toString() de las clases del modelo generado. El poder luego redefinirlo en la clase personalizada, solicitando que devuelva un getXXX() y poder ver el dato de la base en los ABM / CRUD del administrador en lugar de los PrimaryKey, es realmente mas lindo.

Pero tener que redefinir en cada clase, puede ser molesto …
Vamos, soy de los que se pierden haciendos “xxxxxx_id” por todos lados en el modelo … Por lo que tengo que redefinir muchos __toString() .

Entonces porque no poder en el schema, definir un atributo tostring a true o especificar el nombre del campo a utilizar por el método magico, para que el generador/builder/constructor del modelo lo haga por mi ya desde la BaseClase.php ?

Mi instalacion de Symfony 1.2 esta en /Symfony1.2.
Digamos que en otro equipo distinto del que estamos trabajando, hice una descarga por SVN del la versión 1.2, y luego la copie a este DIR.
Imagino que esto no tiene ningun tipo de incidencia.

Veamos un poco el schema:

propel:
   category:
    _attributes:    { phpName: Category, phpToString: Name }
    name:        varchar(255)

La idea central, es definir un atributo phpToString que nos permita definir un texto, en este caso Name, y que en este caso tambien hace referencia al campo name declarado en la linea debajo.
La finalidad es lograr que se genere un código / método toString() para esta clase, como el siguiente :

    /**
     * Magic Method __toString will return the value of some field
     * if you setup the attributes of your schema for this object/table
     */
    public function __toString()
    {
        return $this->getName();

    }

Note que por esta razón, puse Name, con la N en mayúsculas. Ya vere despues como hacer la transformación camelcase…
El generador al $this->get le agregará a continuación lo que hallamos definido

Entiendo que iniciamos el script por generar de cada BaseClase.php, desde SfObjectBuilder. A continuación un extracto de como las clases se van heredando, según su definición:

class SfObjectBuilder extends PHP5ObjectBuilder {

class PHP5ObjectBuilder extends ObjectBuilder {

abstract class ObjectBuilder extends OMBuilder {

abstract class OMBuilder extends DataModelBuilder {

Hagamos un salto al objeto OMBuilder (/Symfony1.2/lib/plugins/sfPropelPlugin/lib/vendor/propel-generator/classes/propel/engine/builder/om/OMBuilder.php)

	 /**
	 * Builds the PHP source for current class and returns it as a string.
	 *
	 * This is the main entry point and defines a basic structure that classes should follow.
	 * In most cases this method will not need to be overridden by subclasses.  This method
	 * does assume that the output language is PHP code, so it will need to be overridden if
	 * this is not the case.
	 *
	 * @return     string The resulting PHP sourcecode.
	 */
	public function build()
	{
		$this->validateModel();

		$script = "<" . "?php\n"; // intentional concatenation
		$this->addIncludes($script);
		$this->addClassOpen($script);
		$this->addClassBody($script);
		$this->addClassClose($script);
		return $script;
	}

Estos metodo tan interesantes los podemos encontrar implementado en (/Symfony1.2\lib\plugins\sfPropelPlugin\lib\vendor\propel-generator\classes\propel\engine\builder\om\php5\PHP5ObjectBuilder.php) el objeto PHP5ObjectBuilder (use la flechita que esta a la derecha de la barra siguiente para ver los metodos)

	/**
	 * Adds the include() statements for files that this class depends on or utilizes.
	 * @param      string &$script The script will be modified in this method.
	 */
	protected function addIncludes(&$script)
	{
	} // addIncludes()

	/**
	 * Adds class phpdoc comment and openning of class.
	 * @param      string &$script The script will be modified in this method.
	 */
	protected function addClassOpen(&$script)
	{

		$table = $this->getTable();
		$tableName = $table->getName();
		$tableDesc = $table->getDescription();
		$interface = $this->getInterface();

		$script .= "
/**
 * Base class that represents a row from the '$tableName' table.
 *
 * $tableDesc
 *";
		if ($this->getBuildProperty('addTimeStamp')) {
			$now = strftime('%c');
			$script .= "
 * This class was autogenerated by Propel " . $this->getBuildProperty('version') . " on:
 *
 * $now
 *";
		}
		$script .= "
 * @package    ".$this->getPackage()."
 */
abstract class ".$this->getClassname()." extends ".ClassTools::classname($this->getBaseClass())." ";

		$interface = ClassTools::getInterface($table);
		if ($interface) {
			$script .= " implements " . ClassTools::classname($interface);
		}

		$script .= " {

";
	}

	/**
	 * Specifies the methods that are added as part of the basic OM class.
	 * This can be overridden by subclasses that wish to add more methods.
	 * @see        ObjectBuilder::addClassBody()
	 */
	protected function addClassBody(&$script)
	{
		$script = "\n" . $script;
		$table = $this->getTable();
		if (!$table->isAlias()) {
			$this->addConstants($script);
			$this->addAttributes($script);
		}

		$this->addConstructor($script);
		$this->addApplyDefaultValues($script);

		// NUEVO CODIGO // NEW CODE
		if ($this->getPhpToString() != false) {
			$this->addToString($script);
		}

		$this->addColumnAccessorMethods($script);
		$this->addColumnMutatorMethods($script);

		$this->addHasOnlyDefaultValues($script);

		$this->addHydrate($script);
		$this->addEnsureConsistency($script);

		$this->addManipulationMethods($script);
		$this->addValidationMethods($script);

		if ($this->isAddGenericAccessors()) {
			$this->addGetByName($script);
			$this->addGetByPosition($script);
			$this->addToArray($script);
		}

		if ($this->isAddGenericMutators()) {
			$this->addSetByName($script);
			$this->addSetByPosition($script);
			$this->addFromArray($script);
		}

		$this->addBuildCriteria($script);
		$this->addBuildPkeyCriteria($script);
		$this->addGetPrimaryKey($script);
		$this->addSetPrimaryKey($script);

		$this->addCopy($script);

		if (!$table->isAlias()) {
			$this->addGetPeer($script);
		}

		$this->addFKMethods($script);
		$this->addRefFKMethods($script);
		$this->addClearAllReferences($script);
	}

	/**
	 * Closes class.
	 * @param      string &$script The script will be modified in this method.
	 */
	protected function addClassClose(&$script)
	{
		$script .= "
} // " . $this->getClassname() . "
";
	}

Note la nueva porción de código

		// NUEVO CODIGO // NEW CODE
		if ($this->getPhpToString() != false) {
			$this->addToString($script);
		}

Quien se encarga de analizar el schema sea YML o XML, es la clase sfPropelDatabaseSchema (E:\wamp\apps\symfony\1.2\lib\plugins\sfPropelPlugin\lib\addon\sfPropelDatabaseSchema.class.php)

La Clase Abstracta XMLElement (/Symfony1.2/lib/plugins/sfPropelPlugin/lib/vendor/propel-generator/classes/propel/engine/database/model/XMLElement.php) representa a los elementos de un archivo XML. Es el método loadFromXML() quien toma esos atributos

	/**
	 * This is the entry point method for loading data from XML.
	 * It calls a setupObject() method that must be implemented by the child class.
	 * @param      array $attributes The attributes for the XML tag.
	 */
	public function loadFromXML($attributes)
	{
		$this->attributes = array_change_key_case($attributes, CASE_LOWER);
		$this->setupObject();
	}

La misma es heredada por otras como Table y Database.

A la clase Table, debemos agregarle estas modificaciones. Es quien hereda de XMLElement e implementa IDMethod.
(/Symfony1.2/lib/plugins/sfPropelPlugin/lib/vendor/propel-generator/classes/propel/engine/database/model/Table.php
)

Un atributo $phpToString

    /**
     * The field name for the magic method __toString().
     *
     * @var        string
     */
    private $phpToString;

Cargamos los valores al objeto, entre ellos $this->phpToString

	/**
	 * Sets up the Rule object based on the attributes that were passed to loadFromXML().
	 * @see        parent::loadFromXML()
	 */
	public function setupObject()
	{
		$this->name = $this->getAttribute("name");
		$this->phpName = $this->getAttribute("phpName");
		$this->idMethod = $this->getAttribute("idMethod", $this->getDatabase()->getDefaultIdMethod());
		$this->allowPkInsert = $this->booleanValue($this->getAttribute("allowPkInsert"));

		// retrieves the method for converting from specified name to a PHP name.
		$this->phpNamingMethod = $this->getAttribute("phpNamingMethod", $this->getDatabase()->getDefaultPhpNamingMethod());

		$this->skipSql = $this->booleanValue($this->getAttribute("skipSql"));
		$this->readOnly = $this->booleanValue($this->getAttribute("readOnly"));

		$this->phpToString = $this->getAttribute("phpToString");
		$this->pkg = $this->getAttribute("package");
		$this->abstractValue = $this->booleanValue($this->getAttribute("abstract"));
		$this->baseClass = $this->getAttribute("baseClass");
		$this->basePeer = $this->getAttribute("basePeer");
		$this->alias = $this->getAttribute("alias");

		$this->heavyIndexing = ( $this->booleanValue($this->getAttribute("heavyIndexing"))
		|| ("false" !== $this->getAttribute("heavyIndexing")
		&& $this->getDatabase()->isHeavyIndexing() ) );
		$this->description = $this->getAttribute("description");
		$this->enterface = $this->getAttribute("interface"); // sic ('interface' is reserved word)
		$this->treeMode = $this->getAttribute("treeMode");

		$this->reloadOnInsert = $this->booleanValue($this->getAttribute("reloadOnInsert"));
		$this->reloadOnUpdate = $this->booleanValue($this->getAttribute("reloadOnUpdate"));
	}

Los Getter y Setter

    /**
     * Get the value of phpToString.
     * @return     value of phpToString.
     */
    public function getPhpToString()
    {
        return $this->phpToString;
    }

    /**
     * Set the value of phpToString.
     * @param      v  Value to assign to phpToString.
     */
    public function setPhpToString($v)
    {
        $this->phpToString = $v;
    }

Y tambien debemos adaptar la clase Database
(/Symfony1.2/lib/plugins/sfPropelPlugin/lib/vendor/propel-generator/classes/propel/engine/database/model/Database.php)

Un atributo $phpToString

	private $phpToString;

Cargamos los valores al objeto, entre ellos $this->phpToString

	/**
	 * Sets up the Database object based on the attributes that were passed to loadFromXML().
	 * @see        parent::loadFromXML()
	 */
	protected function setupObject()
	{
		$this->name = $this->getAttribute("name");
		$this->phpToString = $this->getAttribute("phpToString");
		$this->pkg = $this->getAttribute("package");
		$this->baseClass = $this->getAttribute("baseClass");
		$this->basePeer = $this->getAttribute("basePeer");
		$this->defaultIdMethod = $this->getAttribute("defaultIdMethod", IDMethod::NATIVE);
		$this->defaultPhpNamingMethod = $this->getAttribute("defaultPhpNamingMethod", NameGenerator::CONV_METHOD_UNDERSCORE);
		$this->defaultTranslateMethod = $this->getAttribute("defaultTranslateMethod", Validator::TRANSLATE_NONE);
		$this->heavyIndexing = $this->booleanValue($this->getAttribute("heavyIndexing"));
	}

Los Getter y Setter

    /**
     * Get the value of phpToString.
     * @return     value of phpToString.
     */
    public function getPhpToString()
    {
        return $this->phpToString;
    }

    /**
     * Set the value of phpToString.
     * @param      v  Value to assign to phpToString.
     */
    public function setPhpToString($v)
    {
        $this->phpToString = $v;
    }

Ahora el XML

	/**
	 * @see        XMLElement::appendXml(DOMNode)
	 */
	public function appendXml(DOMNode $node)
	{
		$doc = ($node instanceof DOMDocument) ? $node : $node->ownerDocument;

		$dbNode = $node->appendChild($doc->createElement('database'));

		$dbNode->setAttribute('name', $this->name);

        if ($this->phpToString) {
            $dbNode->setAttribute('phpToString', $this->phpToString);
        }

		if ($this->pkg) {
			$dbNode->setAttribute('package', $this->pkg);
		}

		if ($this->defaultIdMethod) {
			$dbNode->setAttribute('defaultIdMethod', $this->defaultIdMethod);
		}

		if ($this->baseClass) {
			$dbNode->setAttribute('baseClass', $this->baseClass);
		}

		if ($this->basePeer) {
			$dbNode->setAttribute('basePeer', $this->basePeer);
		}

		if ($this->defaultPhpNamingMethod) {
			$dbNode->setAttribute('defaultPhpNamingMethod', $this->defaultPhpNamingMethod);
		}

		if ($this->defaultTranslateMethod) {
			$dbNode->setAttribute('defaultTranslateMethod', $this->defaultTranslateMethod);
		}

		/*

		FIXME - Before we can add support for domains in the schema, we need
		to have a method of the Column that indicates whether the column was mapped
		to a SPECIFIC domain (since Column->getDomain() will always return a Domain object)

		foreach ($this->domainMap as $domain) {
		$domain->appendXml($dbNode);
		}
		*/
		foreach ($this->vendorInfos as $vi) {
			$vi->appendXml($dbNode);
		}

		foreach ($this->tableList as $table) {
			$table->appendXml($dbNode);
		}

	}

Con estas dos clases modificadas, estamos en condiciones de usar estos cambios para la clase OMBuilder que hereda de DataModelBuilder. Pero esta ultima clase no sera necesario modificarla. (/Symfony1.2/lib/plugins/sfPropelPlugin/lib/vendor/propel-generator/classes/propel/engine/builder/om/OMBuilder.php). Solo hay que :

    /**
     * Gets the field name for the magic method __toString.
     * @return     string
     */
    public function getPhpToString()
    {
        $phpToString = ($this->getTable()->getPhpToString() ? $this->getTable()->getPhpToString() : $this->getDatabase()->getPhpToString());
        if (!$phpToString) {
            $phpToString = false;
        }
        return $phpToString;
    }

Como vimos la clase hija de la anterior OMBuilder, es PHP5ObjectBuilder.
(/Symfony1.2/lib/plugins/sfPropelPlugin/lib/vendor/propel-generator/classes/propel/engine/builder/om/php5/PHP5ObjectBuilder.php)

Esta vez, se analiza las nuevas clases del framework para el testing.
De mas esta decir que Fabien esta muy entusiasmado con estos tópicos
Las clases son fáciles de usar.

Prueba tus Aplicaciones

En el mismo nos sigue mostrando varios trucos de sfFormExtraPlugin y el uso de ReCaptcha.
Los métodos son muy sencillos e intuitivos.

Mas sabor para tus formularios con algunos lindos widgets y validadores

En el mismo nos muestra otra vez como jugar con la cultura del usuario de nuestro sitio web

Los métodos son muy sencillos e intuitivos.

Nuevamente los ARRAYs son participantes de este juego.A continuación el enlace al artículo traducido:

Jugando con el Lenguaje