Liberados Symfony 1.3 y 1.4

Hace algunas horas han sido liberados las versiones estables de Symfony 1.3 y 1.4 la lista de mejoras parece muy extensa, nuevas versiones para los ORM siendo Doctrine el nuevo motor por defecto, SwiftMailer será el encargado de las tareas de envío de emails, mejoras en las Forms, herramientas de Testing y Debug,  pero la promesa más importante del equipo de desarrollo es el aumento en el rendimiento de nuestras aplicaciones. Acá está el detalle de las novedades.

Ahora lo más interesante es que junto con actualizar el tutorial Jobeet (Practical Symfony) para las versiones 1.3 y 1.4 , han lanzado un nuevo libro, de nombre “More with symfony“, el cual toca tópicos más avanzados relacionados con este framework. Como dato adicional fue escrito en alrededor de 2 meses por más de 10 autores y está disponible en 5 idiomas, sin duda destacable el esfuerzo realizado.

No queda más que probar las nuevas virtudes de esta nueva versión de symfony

Symfony – Fixtures con las Ciudades y Comunas de Chile

Durante el desarrollo de nuestro proyecto para la Feria de Software tuvimos que tener algunos datos de prueba para las comunas y ciudades de Chile, como no era fundamental tener las regiones simplificamos el modelo propuesto en este sitio al siguiente (escrito en notación YAML)

Para las ciudades:

  ciudad:
   id: ~
   nombre:      { type: varchar(100) }

Para las comunas

  comuna:
   id: ~
   nombre:      { type: varchar(100) }
   ciudad_id:   { type: integer, foreignTable: ciudad, foreignReference: id, onDelete: restrict }

Los cuales, como es de presumir, fueron agregados a nuestro esquema (./config/schema.yml). Hasta aquí nada muy interesante, pero mientas discutíamos la forma más compleja y por ende mejor ( xD ) de cargar los datos,  Camila Maldonado se tomó la ‘molestia’ de pasar la información directamente a un par de archivos yaml para ser cargados como fixtures (./data/fixtures) en nuestro proyecto. Les dejo a continuación los archivos:

Descarga: Fixtures symfony – Ciudades y Comunas de Chile (zip – 5,5 KB)

Es muy posible que falten varias comunas, pero como comenté sólo necesitábamos datos de prueba y éstos se ajustaron bastante bien: 52 ciudades y 345 comunas no está mal

Symfony – Validador de RUT

Utilizando la clase para validar RUT que mostré en esta entrada cree un sencillo validador de RUT para los formulario de symfony 1.2

Por convención he creado la clase sfValidatorRut.class.php en el directorio /lib de la raíz del proyecto. Aquí está el código de esta clase:

<?php
/**
 * Validador de RUT para symfony 1.2
 *
 * @author Esteban Martini Muñoz
 * @version 1.0
 */
require_once dirname(__FILE__).'/../Rut.class.php';
class sfValidatorRut extends sfValidatorString
{
  public function configure ($options = array(), $messages = array())
  {
    $this->addMessage('invalid', 'El formato del RUT: %value% no es válido.');
    $this->addMessage('bad_dv', 'El dígito verificador del RUT es incorrecto.');
    $this->addMessage('required', 'RUT es requerido.');
  }
  public function doClean($value)
  {
      $clean = ltrim(rtrim(($value)));
      $rut = new Rut();
      if (!$rut->verificaFormatoRut($value))
        throw new sfValidatorError($this, 'invalid', array('value' => $value));
      else if(!$rut->isRut($value))
        throw new sfValidatorError($this, 'bad_dv', array('value' => $rut->getDV($value)));
      return (string)$rut->formatoUser($value);
  }
}

Su uso es igual al resto de los validadores de symfony sólo basta asignar el tipo de validación al campo a verificar de nuestro formulario.

//...
public function configure()
{
  $this->validatorSchema['rut_usuario'] = new sfValidatorRut();
}
//...

Espero les sea de utilidad.

Ordenar cadenas de texto que contengan números en MySQL y Symfony

En un proyecto reciente, tuve que ordenar una columna que contenía RUN, estas cadenas tienen entre 7 y 8 números enteros y un dígito verificador que puede ser un número entre 0-9 o una letra K, ordenar estas cadenas puede ser algo complicado pues el ordenamiento no es numérico.

En este sitio presentan una solución bastante sencilla, básicamente es sumarle un cero a la columna por la que queremos ordenar.

mysql> SELECT column FROM table_name ORDER BY column+0;

Esta idea se puede llevar a symfony simplemente añadiendo una cláusula de ordenamiento en un Criteria.

$c = new Criteria();
$c->addDescendingOrderByColumn('USERNAME+0');

Saludos!

Usando JSON con jQuery en Symfony

JSON es una forma bastante cómoda de tratar con “objetos” y si lo usamos junto con AJAX puede resultar muy sencillo tratar con respuestas que contienen mas de un elemento, tales como una array o un objeto. En el siguiente ejemplo veremos como usar  jQuery y JSON para realizar consultas AJAX en symfony (sin helpers o similares)

Voy a evitar declarar el modelo de datos, por lo que supongo que el lector ya tiene algunos conocimientos básicos de este framework.

1.- El Action

Lo primero que haremos es crear un nuevo método para nuestro action, el objetivo es retornar un texto serializado con información de un usuario.

public function executeAjaxDatosCorredorById(sfWebRequest $request){

  /* Asegurar que la solicitud sea AJAX */
  if (!$request->isXmlHttpRequest())
    return $this->renderText(json_encode(array('error'=>'Sólo respondo consultas vía AJAX.')));

  /* si entra por POST o GET la variable sfUserId, continuar */
  if($request->getParameter('sfUserId'))
  {
     $usuario = sfGuardUserPeer::retrieveByPK($request->getParameter('sfUserId'));
     /* Crear array asociativo con los atributos del objeto $usuario */
     $datosUsuario = array(
        "nombre"    => $usuario->getProfile()->getNombre(),
         "apellidoP" => is_null($usuario->getProfile()->getApellidoP()) ? '' : $usuario->getProfile()->getApellidoP(),
         "apellidoM" => is_null($usuario->getProfile()->getApellidoM()) ? '' : $usuario->getProfile()->getApellidoM(),
         "rut"       => $usuario->getUsername()
      );

      /* retornar el arreglo en formato JSON */
      return $this->renderText(json_encode($datosUsuario));
   }
   return $this->renderText(json_encode(array('error'=>'Faltan parámetros para realizar la consulta')));
}

Listo. la respuesta está lista para ser “interpretada”. Ahora vamos a ver cómo procesamos la consulta:

2.- La funcion AJAX

Los parámetros de esta función son:
sfAction: es dirección http de la accion de symfony a ejecutar.
idTrigger: Id del elemento DOM que desencadena el evento.
valorParametro: valor que toma laa variable GET['sfUserId']

function getDatosUsuarioById(sfAction, idTrigger, valorParametro)
{
      $.ajax(
      {
        url: sfAction,
        data: ({sfUserId: valorParametro}),
        dataType: "json",
        beforeSend: function()
        {
          $("#"+idTrigger).append('<span id="cargando_datos"> Cargando datos...');
        },
        complete: function()
        {
          $("#cargando_datos").hide();
        },
        success: function (data, status)
        {
          $("#propuesta_nombre_contratante").val(data.nombre);
          $("#propuesta_apellido_p_contratante").val(data.apellidoP);
          $("#propuesta_apellido_m_contratante").val(data.apellidoM);
          /* ... etc */
        }
        error: function (data, status, e)
        {
            alert('Ocurrió un error cargando los datos solicitados:.\n'+data.error);
        }
    });
}

En la sección success se puede ver que la respuesta, representada por  data,  se interpreta como si fuera un objeto.

3.- La puesta en marcha

Para ver el código en funcionamiento debemos agregar el siguiente código en la vista o template en la que necesitemos la función recién implementada. En este ejemplo la función getDatosUsuarioById(…) se dispara al entrar en foco el elemento DOM con Id: propuesta_nombre_contratante. Por otra parte, nótese cómo se declara la variable sfCargaDatosUsuario, se utiliza el helper url_for para crear una ruta, utilizando enrutamiento absoluto, hacia el URL del action a ejecutar.

$(document).ready(function(){
  var sfCargaDatosUsuario  = "<?php echo url_for('propuesta/ajaxDatosUsuarioById')?>";
   $("#propuesta_nombre_contratante").focus(function()
   {
        if($("#propuesta_cliente_id").val()>0)
        {
            getDatosUsuarioById(
                sfCargaDatosUsuario,
                "propuesta_cliente_id",
                $("#propuesta_cliente_id").val(),
            );
        }
    });
});

Eso por el momento, espero le sea de utilidad a alguien, iré puliendo esta entrada para que quede más clara.

Symfony – Ver los detalles de error en Formularios Personalizados

Si no utilizas los templates que genera automáticamente symfony para nuestros formularios, ya sea porque requieres agregarle un poco de color, algo más de información etc, seguramente más de una vez te haz topado que algo falló y no sabes qué es (validación, olvidaste agregar un campo, etc), una solución rápida e informativa es agregar la siguiente pieza de código en alguna parte visible de nuestro template:

<ul class="error_list">
    <?php if($form->hasErrors()):?>
    <?php foreach ($form->getErrorSchema() as $name => $error): ?>
      <li><?php echo $name.': '.$error ?></li>
    <?php endforeach; endif?>
</ul>

Esto nos mostrará un listado los errores de nuestro formulario.

Saludos

Symfony – Obtener el nombre del Module o Action actual

Para obtener el nombre del Módulo (module) o Acción (action) en el que estamos trabajando:

Desde un Action

sfContext::getInstance()->getActionName();
sfContext::getInstance()->getModuleName();

Desde un  template:

$sf_context->getActionName();
$sf_context->getModuleName();

Esto puede útil si estamos construyendo una barra de menú y queremos saber “dónde estamos” para resaltar esta ubicación .

Me enteré vía: El blog de David Vega

Symfony – Accediendo a sfUser desde un Template

Para acceder al sfUser desde una vista o template es tan sencillo como:

<?php if($sf_user->isAuthenticated()):? >
     < ?php echo "User is authenticated"?>
<?php else:?>
     <?php echo "User is not authenticated"?>
<?php endif?>

Asimismo si quisiéramos acceder al sfGuardUser, podemos hacer algo como esto:

<?php

$usuarioId = $sf_user->getGuardUser()->getId();

?>

Fuente: symfonynotes

Primer vistazo al soporte de symfony en NetBeans 6.8

El pasado 1 de Agosto salió el Milestone 1 de NetBeans 6.8, el cual dentro de otras caracteristicas, ofrece “algo” de soporte para symfony.

Update: ya está disponible el Milestone 2 (enlace al final de la entrada).

Dentro de las principales caracteristicas:

• Permite crear e importar Proyectos symfony.
• Soporte para crear Aplicaciones añadiendoles flags u parámetros.
• Consola de comandos de symfony (casi igual a la de on Rails), característica que sin duda le gustará a los usuarios de Windows, donde es un poco más complejo utilizar la consola.
• Permite expandir/minimizar las secciones de los archivos YAML.

Todavía no pruebo otras caracteristicas propias del lenguaje, pero al menos provee lo básico para empezar o continuar un proyecto. Ojalá veamos pronto más novedades.

Enlace: Descarga NetBeans 6.8 M1 Descarga NetBeans 6.8 M2

Symfony – Configurando Eclipse como IDE

Es primera vez que meteré manos en el framework MVC para PHP de nombre symfony, no entraré en detalles de sus bondades, sólo diré que me aburrí de re-inventar la rueda cada vez y el proyecto en el que trabajaré los próximos meses merece el uso de este framework.

En esta primera entrada detallaré propondré una configuración  para el IDE Eclipse que permite alivianar un poco la  labor de programar, añadiendo soporte básico para las operaciones (de consola) de symfony y un editor para archivos yml.

Curso de Symfony – Javier Eguíluz

En mi búsqueda recopilatoria de información complementaria para la documentación oficial de Symfony me encontrado un curso (diapositivas) de Javier Eguíluz, que sigue el libro Jobbet, el cual pretende enseñar de forma práctica y en 24 sesiones de 1 hora el funcionamiento de Symfony.

Las Tecnologías que integra Symfony

Ilustración de las tecnologías que integra Symfony