!Ahora ya no tienen excusa!

PDF	CHM	API DOC CHM
ZF_1.9.x_ES.pdf	ZF_1.9.x_ES.chm	ZF_1.9.x_API_Doc.chm
(6.8M)	(2.8M)	(10.6M)

Bugs
Si tienen problemas para visualizar los archivos CHM en su Windows revisen mi anterior post

Nota:
Si desean descargar la documentación en otros idiomas, lo pueden hacer aquí http://www.mikaelkael.fr/Zend-Framework-1-9-x-documentation.html

Primero
La documentación en español ya dio sus primero pasos, hemos alcanzado a traducir el 38% de los documentos, aún falta mucho, pero es reconfortante ver que avanzamos. Los que deseen pueden verlo online en esta url http://manual.zfdes.com/, y si encuentren un error no duden en reportarlo, les estaremos muy agradecidos.
Si desean unirse al grupo de traductores pueden enviarnos un mail a zendframeworkspanish@googlegroups.com solicitando ser incluidos.

Segundo
A veces no podemos estar siempre conectados a la red para poder consultar el manual online, así que compile el manual en CHM para que  de esa manera podamos aprovechar todas las ventajas de este formato.

Les dejo los links para que lo puedan descargar.

Manual en Español
http://codigolinea.googlecode.com/files/Zend_Framework_1.8.x_ES-REV380.chm

Manual en Ingles
http://codigolinea.googlecode.com/files/Zend_Framework_1.8.x_EN.chm

Manual Online
http://manual.zfdes.com/

Bugs
Si tienen algún problema en visualizar el archivo .chm,  les dejo unas recomendaciones que les pueden servir.

- Si están utilizando Microsoft Internet Explorer en Windows XP SP2 o posterior, tienen que “desbloquear” el archivo después de descargarlo, haciendo click derecho sobre ella y seleccionando la opción “propiedades” del menú contextual y a continuación hacen click en el botón “desbloquer“, con eso ya deben poder visualizar sin problemas el manual.  Esto se debe a un bug de Microsoft Internet Explorer.
- Si están utilizando Microsoft Internet Explorer en Windows Vista revisen este enlace

Espero que les sea de mucha utilidad, ¡hasta la próxima!.

¿Por que MySql Almacena fecha en ese formato?
La explicación es muy amplia y no lo trataremos ahora, pero lo podemos resumir en los siguientes puntos:
- Evitar formatos ambiguos
- Tener un formato único y universal
- Poder ser organizados de más a menos significativo
- Estar en formato ordenable, incluso si tratáramos a las fechas como cadenas de texto, podríamos ordenarlas alfabéticamente.

Si ingresamos una fecha que no cumpla con ese formato, simplemente provocará un error, ya que no sera recocido como fecha válida.

¿Como podemos solucionar esto?
Mysql Contiene una función llamada GET_FORMAT con el cual podemos insertar fechas con distinto formato, solo le tenemos que indicar en que formato estamos recibiendo la fecha para que MySQL luego lo procese.

Los formatos que acepta GET_FORMAT son los siguientes

Para demostrar el uso de esta función voy a crear una tabla:

CREATE TABLE `demo` (
`id` int(11) NOT NULL auto_increment,
`fecha` date default NULL,
PRIMARY KEY  (`id`)
) ENGINE=InnoDB

Supongamos que recibimos un fecha con el siguiente formato 15/01/2005 (dd/mm/YYYY). . Esto lo insertaremos de la siguiente manera.

INSERT INTO demo (fecha)
VALUES (STR_TO_DATE(REPLACE('15/01/2005','/','.') ,GET_FORMAT(date,'EUR')))

Explicaré lo que hace la sentencia
Convertimos la cadena de texto a un formato fecha con STR_TO_DATE.
Usamos REPLACE para reemplazamos las barras por el punto (.), según nuestra tabla de formatos.
Con GET_FORMAT(date,’EUR’) le decimos al mysql que la fecha que vamos ingresar esta en formato europeo

Probemos con otra fecha, insertaremos una fecha con el siguiente formato 10.31.2003 (mm.dd.YYYY)

INSERT INTO demo (fecha)
VALUES (STR_TO_DATE('10.31.2003' ,GET_FORMAT(date,'USA')))

Verificamos nuestros datos insertados, y vemos que esta en el formato estándar.

mysql> select * from demo;
+----+------------+
| id | fecha      |
+----+------------+
|  1 | 2005-01-15 |
|  2 | 2003-10-31 |
+----+------------+
2 rows in set (0.00 sec)

Espero que les sea de mucha utilidad y les evite muchos dolores de cabeza.

Hasta la próxima!

Como miembro del grupo de traductores del manual de ZF y viendo esta problemática instale un wiki http://www.zfdes.com/ para que todos puedan colaborar y así podamos avanzar con la traducción del manual, después de ser traducidos y revisados estos documentos serán enviados a Zend.

He empezado a enviar algunos avances a Zend, pueden verlo aquí

¿Y como ayudar?
Puedes ayudar de la siguiente manera:

- Traduciendo los documentos publicados
- Verificando las traducciones
- Corrigendo errores y/o reportándolos en el foro del wiki http://foro.zfdes.com/
- Comunicando a otros para que nos ayuden en la traducción

Así que ya no hay mas excusas para no poder ayudar, esperamos tu apoyo!

Enlaces:
wiki: http://zfdes.com/
SVN: http://framework.zend.com/svn/framework/standard/trunk/documentation/manual/es/

Zend Framework 1.6.2

Esta versión la 1.6.2 de Zend Framework corrige muchos bugs y añade nuevas características a los siguientes componentes :

• Dojo Integration
  • JSON-RPC Server
  • dojo.data Envelopes
  • Dojo View Helper
  • Dijit integration with Zend_Form & Zend_View
  • Dojo Library Distribution
• SOAP
  • SOAP Server
  • SOAP Server
  • SOAP Client
  • Autodiscovery
  • WSDL access
  • WSDL Generation
• SOAP Server
• SOAP Server
• SOAP Client
• Autodiscovery
• WSDL access
• WSDL Generation
• Preview of Tooling Project in Laboratory (see /laboratory folder)
  • Command Line Interface
  • Project Asset Management
• Unit Testing Harness for Controllers
• Lucene 2.3 Index File Format Support
• Zend_Session save handler for Database Tables
• Paginator Component
• Text/Figlet Support
• ReCaptcha Service
• Captcha Form Element
• Zend_Config_Xml Attribute Support
• Zend_File_Transfer Component
• File Upload Form Element
• Zend_Wildfire Component with FireBug Log Writer
• Media View Helpers (Flash, Quicktime, Object, and Page)
• Support in Zend_Translate for INI File Format

el detalle de los Bugs corregidos lo pueden ver aquí http://framework.zend.com/issues/secure/IssueNavigator.jspa?requestId=10862

Zend Framework 1.7.0PR

La Nueva sorpresa es el lanzamiento del Preview Release de la Versión 1.7.0 el cual Viene cargado de novedades las cuales son:

• Zend_AMF Basada en amfphp el cual nos ayuda a conectarnos a flash y flex
• Dojo Toolkit 1.2.0 Soportará las nuevas funcionalidades de esta versión
• ZendX_JQuery Para poder trabajar con JQuery
• Support for dijit editor Soportará el Dijit Editor
• Metadata API in Zend_Cache
• Google book search API
• Performance enhancements
• Application-wide locale with other i18n enhancements
• File upload form element enhancements

Las mejoras en cada versión son bárbaras, así que manos a la obra, aprovechemos las mejoras y saquemos el juego, ¿que opinan?

Este error afecta a hasta la versión Zend Framework 1.6.1 y aun tampoco se ha solucionado en la versión de desarrollo.

Veamos un ejemplo

class TestController extends Zend_Controller_Action
{
	function indexAction ()
    {
		$this->view->addHelperPath('Zend/Dojo/View/Helper/', 'Zend_Dojo_View_Helper');
		$form = new Zend_Dojo_Form();
		$form->addElement(
		    'CheckBox',
		    'checkboxValue',
		    array(
		        'label'        => 'Label',
		        'checkedValue' => 'checkedValue',
			'uncheckedValue' => 'notCheckedValue',
		    )
		);

		$form->addDecorators(array('FormElements', 'Form'));
		$this->view->form = $form;
	}
}

Esto produce el siguiente HTML:

<!-- Erroneo//-->
<input name="checkboxValue" type="hidden" value="0" />
<input id="checkboxValue" name="checkboxValue" type="checkbox" value="notCheckedValue" /> 

Pero debería generar el siguiente HTML

<!-- Debería producir//-->
<input name="checkboxValue" type="hidden" value="notCheckedValue" />
<input id="checkboxValue" name="checkboxValue" type="checkbox" value="checkedValue" /> 

Esto genera que los datos siempre se envíen vacíos, quiere decir si marcamos el checkbox este llegará vació, como si no lo hubiésemos marcado.

Solución
Aun no existe un parche oficial para este problema, pero si queremos seguir trabajando podemos editar el helper del checkbox ubicado en Zend/Dojo/View/Helper/CheckBox.php y agregar una pequeña línea de código para solucionarlo, hasta esperar que corrijan dicho problema.

Hay que agregar lo siguiente $checkedOptions = $attribs['options']; después de la línea 74

 public function checkBox($id, $value = null, array $params = array(), array $attribs = array(), array $checkedOptions = null)
    {
        // Prepare the checkbox options
        require_once 'Zend/View/Helper/FormCheckbox.php';
        $checked = false;
        if (isset($attribs['checked']) && $attribs['checked']) {
            $checked = true;
        } elseif (isset($attribs['checked'])) {
            $checked = false;
        }
		//Linea Añadida < -----
	    $checkedOptions = $attribs['options'];

        $checkboxInfo = Zend_View_Helper_FormCheckbox::determineCheckboxInfo($value, $checked, $checkedOptions);
        $attribs['checked'] = $checkboxInfo['checked'];
        if (!array_key_exists('id', $attribs)) {
            $attribs['id'] = $id;
        }

        $attribs = $this->_prepareDijit($attribs, $params, 'element');

        // strip options so they don't show up in markup
        if (array_key_exists('options', $attribs)) {
            unset($attribs['options']);
        }
//.............

El equipo de Zend ya esta haciendo un seguimiento a este problema y pronto tendremos la solución:

Aquí pueden ver la respuesta a mi pregunta sobre dicho error
http://www.nabble.com/Error-Zend_Dojo-CheckBox-td19910115.html

Issue Tracker
http://framework.zend.com/issues/browse/ZF-4274

Zend Framework nos ofrece un componente para poder leerlos, llamado Zend_Config_Ini el cual esta apoyado en el parse_ini_file() de PHP.

Al ser archivos planos es fácil de leerlos, incluso a través del navegador web y eso lo hace muy vulnerable, ya que si no esta correctamente protegido, cualquiera puede leer nuestros parámetros de configuración y acceder a contraseñas, rutas de archivos, entre otras cosas.

Nuestros archivos .INI siempre deberían estar ubicados por encima del la raíz web de nuestro servidor.

Supongamos que tenemos la siguiente distribución de carpetas de nuestra aplicación

application/
    config/
         database.ini
    controllers/
    models/
    views/
        scripts/
        helpers/
        filters/
   web/
    .htaccess
    index.php

Todo lo contenido dentro de application debería estar estar fuera del acceso vía web, eso sería lo ideal, pero no siempre es así, ya que puede ocurrir que nos encontremos en un entorno donde no podemos contar con dichas facilidades, entonces debemos tomar las precauciones del caso.

Supongamos que estamos trabajando en un subdominio, o en una carpeta por debajo del árbol de la web, la distribución de carpetas de nuestra aplicación sería algo parecido a esto.

web/my_aplication/
			application/
				config/
			    	database.ini
			    controllers/
			    models/
			    views/
			    	scripts/
			        helpers/
			        filters/
			   html/
			   	index.php
			.htaccess

Quedaríamos expuestos y solo protegidos por las reglas declaradas dentro del .htaccess, ¿entonces que más podemos hacer?.

La solución es bien sencilla, consiste en convertir a nuestros archivos .ini en archivos .php y poner toda la información dentro de comentarios, de esa manera no podrán ser visualizados.

database.ini.php

/*
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; Configuration Database  ;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

; Production site configuration data
[production]
webhost                        = www.codigolinea.com
database.adapter         	= pdo_mysql
database.params.host      	= localhost
database.params.username  	= dbuser
database.params.password  	= secret
database.params.dbname    	= myDB
database.params.profiler	= false
*/

Y lo usamos como cualquier otro archivo .INI

require_once 'Zend/Config/Ini.php';

$config = new Zend_Config_Ini('database.ini.php', 'production');

echo $config->database->params->host;   // prints "localhost"
echo $config->database->params->dbname; // prints "myDB"

Así de sencillo, yo siempre lo uso de esa manera, y me quito la preocupación de que si algo falla, alguien pueda acceder a dicho fichero y leerlo.

Hay muchas otras soluciones a nivel de Servidor ¿pero si no tenemos acceso?, o usando la configuración a través de arrays(), pero la idea es no perder la simplicidad de los archivos .INI.

Lo malo es que la versión de Zend Framework no siempre es actual, ya que Zend Studio toma la versión vigente de Zend Framework al momento de la publicación del software, así tenemos que la última versión  de Zend Studio 5.5.1 traiga Zend Framework 1.0.3 cuando la versión vigente es una superior.

¿Cual es sería la solución?

Es bien simple, cuando el Zend Studio se instala, crea una carpeta dentro de su directorio raíz donde guarda dicho Framework, así que solo tenemos que reemplazar esta carpeta con la versión mas reciente del Framework.

Paso 1
Descargamos le versión más actual del Zend Framework http://framework.zend.com/download.

Paso 2
Descomprimimos el archivo bajado en cualquier ubicación de nuestro disco, la estructura de los directorios será mas o menos así:

Luego copiamos la carpeta Zend

Paso 3
No dirigimos a la ubicación donde se instalo Zend Studio y donde guarda el Framework, en mi caso es la siguiente ruta:
C:\Program Files\Zend\ZendStudio-5.5.1\bin\ZendFramework\library en el cual aparecerá una carpeta llamada Zend lo renombrados y le ponemos de nombre old

Paso 4
Pegamos la carpeta que copiamos, luego cerramos y volvemos a abrir el Zend Studio y ya podremos trabajar con las nuevas funcionalidades del Framework.

1. ¿Que necesitamos para instalar este Framework?

- PHP 5.2.3 ó superiores

Si trabajas con la versión 5.1.4 funcionará correctamente, pero Zend nos recomienda usar la versión 5.2.3 o superiores, puesto que en estas versiones hay mejoras importantes en la seguridad como en el funcionamiento de PHP, ya que algunas bibliotecas PHP usados por Zend Framework no eran completamente estables hasta la versión 5.2.3.

- Un servidor Web como Apache, IIS, u otros. PHP es multi plataforma así que funcionará en la mayoría de servidores web y sistemas operativos tales como Linux, Solaris, Windows, OS X, etc. En lo personal prefiero Linux y Apache

Si deseas dedicarte o te dedicas de manera profesional al desarrollo web con php, te recomiendo que uses Linux como Servidor Web, ya que te permitirá conocer el entorno y te enfrentaras a problemas reales que suelen suceder en la mayoría de servidores Web (hosting) que brindan soporte a PHP

SI trabajas con Windows hay programas que permiten montar APACHE + LINUX + MYSQL con una simple instalación, entre estos programas tenemos XAMPP, WAMPServer, Appserv, etc

- Las Extensiones PHP necesarios que deben estar instalados nuestro servidor web son:
Según el DB que usemos:

• pdo Para todos los adaptadores de Base de datos
• pdo_mssql y/o mssql para trabajar con Mcrosoft SQL Server
• pdo_mysql y/o mysql y/o mysqli para trabajar con Mysql
• pdo_oci y/o oci8 para trabajar con Oracle
• pdo_pgsql y/o pgsql para trabajar con postgreSQL
• pdo_sqlite y/o SQLite para trabajar con sqlLite
• ibm_db2 para trabajar con DB2
• odbc Adaptador ODBC

Otros:

• zlib Para los componentes  Zend_Pdf, Memcache
• json Para los componentes Zend_Json
• gd Para los componentes Zend_Pdf

Para  comprobar si lo tenemos instalado estos componentes solo tenemos que hacer uso de la función  phpinfo() de PHP.

Para más información detallada acerca de los componentes,  extensiones PHP y sus dependencias, lo encuentran en:
- PHP Extensions
- Zend Framework Components

2. Descargando Zend Framework

Una vez que tengamos nuestro entorno con los componentes necesarios, procederemos a descargar la versión mas reciente, estable y oficial del Zend Framework del siguiente link http://framework.zend.com/download y lo guardamos dentro de la carpeta library

Pero si eres osado y deseas contar con la versión mas actualizada , lo puedes descargar desde http://framework.zend.com/download/snapsho o haciendo uso de un cliente de subversión (SVN) desde  http://framework.zend.com/svn/framework/trunk y de esa manera tenerlo actualizado siempre. Estas versiones cuentan con las últimas mejoras y nuevos componentes, pero recuerda que están sujetos a posibles cambios futuros.

3. Estructura de Archivos

Va depender de como deseas configurarlo y el entorno en que te encuentres.

- Si nuestro proyecto va funcionar como principal aplicación de nuestro servidor web, optamos por la siguiente estructura.

- Si nuestro proyecto va funcionar como aplicación secundaria, lo podemos estructurar de la siguiente manera

Estos son estructuras propuestas, pueden ser cambiadas y adaptadas a nuestros entornos y manera de trabajo. En el siguiente enlace “Zend Framework Default Project Structure “ podemos encontrar diversas maneras de crear la estructura de archivos  para nuestros proyectos.

4. Configurando nuestro archivo .htaccess

RewriteEngine on
RewriteRule !\.(js|ico|gif|jpg|png|css|swf|pdf)$ index.php

Estas reglas encaminaran las peticiones hacia el front controller a excepción de las imágenes, archivos javascript, hojas de estilo, archivhos .swf (flash). Si deseamos que exceptué algún otra extensión solo lo añadimos a nuestra regla.

Ya tenemos nuestro entorno listo para trabajar, solo nos queda probar para ver si funciona todo correctamente.

5. Probando su funcionamiento
Vamos a crear nuestro proyecto dentro del localhost de nuestro servidor local, la ruta seria http://localhost/

5.1 Creando el archivo Index
Creamos el archivo /public/index.php con el siguiente contenido.

$basePath = dirname(dirname(__FILE__));
set_include_path(get_include_path() . PATH_SEPARATOR .
$basePath . '/library' . PATH_SEPARATOR);

/** @see Zend_Controller_Front */
require_once 'Zend/Controller/Front.php';

Zend_Controller_Front::run($basePath . '/application/controllers');

5.2 Creando el archivo IndexController
Creamos el archivo /application/controllers/indexController.php con el siguiente contenido.

/** @see Zend_Controller_Action */
require_once 'Zend/Controller/Action.php';

class IndexController extends Zend_Controller_Action
{
	public function indexAction()
	{
		$this->view->test = "Hola Mundo";
	}
}

5.3 Creando la Vista
Creamos el archivo /application/views/scripts/index.phtml con el siguiente contenido.

< !DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>test</title>
</head>

<body>
< ?php

echo $this->escape($this->test);

?>
</body>
</html>

5.4 Probando
Abrimos nuestro navegador y escribimos la ruta http://localhost y nos debe salir el mensaje ‘Hola Mundo’, si nos mostró el mensaje es decir que todo funciona bien y estamos listo para crear nuestras aplicaciones web.

Hasta aquí llegamos, eso sería todo, espero que les sea de mucha utilidad al momento de crear sus proyectos, Quedo abierto a sus preguntas y/o comentarios.

Hoy me entero a través de el blog de symfony en español, de un nuevo estudio realizado por Clever Age sobre los frameworks mas usados en PHP, titulado “Libro blanco sobre frameworks PHP para empresas”, donde se realiza un exhaustivo estudio de todas funcionalidades de dichos frameworks, mostrando los puntos fuertes y débiles de cada uno.

Dicho documento se encuentra en francés y lo pueden solicitar totalmente gratis desde este link, es necesario que coloquen su mail para recibir el pdf.

Para los que no pueden entender el francés, traduje la parte 9, que trata sobre “Evaluación por el método de QSOs (Qualification and Selection of Open Source software)” el cual me pareció que resume muy bien todo lo tratado en el libro.

El método QSOs se centra en los criterios para estimar los riesgos incurridos por un usuario al usar un software.

Para cada función, la regla de notación es el siguiente:

• 0 si la funcionalidad no está cubierto,
• 1 si la función está parcialmente cubierto,
• 2 si la función está completamente cubierto.

Expresada en porcentaje de puntuación máxima alcanzable, se muestra la repartición de las notas de estos 4 frameworks según las categorías analizadas:

Otra presentación en la forma de un gráfico de radar:

Conclusiones
Pienso que los datos de este estudio no son totalmente concluyentes puesto que cada framework esta en evolución y pude cambiar en el transcurso del tiempo, pero nos pude ayudar grandemente a tomar una mejor decisión al momento de querer embarcarnos en un nuevo proyecto en PHP.