Tutorial Yii Framework (parte 2)

Antes de comenzar vamos a colocar la lista de requerimientos a usar a lo largo del tutorial, el cual constara de varias sesiones.

• IDE Eclipse, considero que este entorno de desarrollo es el mejor que podemos elegir, tiene muchas opciones de personalización ademas de que se integra fácilmente con sistemas de control de versiones que usaremos en este tutorial también. Les recomiendo que revisen unos tutoriales anteriores que detallan la instalación de Eclipse y un sistema SVN.
• Obviamente necesitaremos de un servidor con soporte PHP y Base de Datos (usaremos Mysql) la solución para esta necesidad la proveerá MAMP (WAMP). No entraremos en detalles sobre como instalar este software.
• Usaremos Google Project Hosting para versionar nuestro proyecto.

 

Creando el repositorio

---

Creamos una cuenta de Google Project Hosting sugiero siempre usar repositorios para almacenar nuestros proyectos. En este repo iré subiendo el avance http://code.google.com/p/yii-framework-tutorial/

 

Descargando Yii

---

Vamos a http://www.yiiframework.com/ y descargamos la última versión del framework (v1.1.8) descomprimimos el paquete viendo que nos arroja una estructura de archivos similar a esta:

El contenido de las carpetas es muy obvio, incluyendo el framework en si ademas de una carpeta con demos, cabe señalar que la carpeta requirements contiene un verificador de requerimientos muy util a la hora de validar si nuestro entorno de desarrollo cumple con los requisitos para usar Yii. En un momento daremos un vistazo a esta carpeta, comenzemos renombrando la carpeta que contiene todo esto solamente a yii y copiemos esa carpeta dentro de nuestro folder del servidor local htdocs o www.

Una vez hecho esto accedamos a nuestro server para verificar que la carpeta yii sea accesible por medio de nuestro navegador de la siguiente forma:

Si navegamos hacia la carpeta requirements veremos la siguiente pantalla con una lista de las validaciones realizadas de la configuración de nuestro servidor:

Una ves comprobada esta validación y teniendo un entorno con los requisitos minimos para el buen funcionamiento del framework podemos comenzar a trabajar.

Generando nuestro proyecto

---

Una de las grandes ventajas a la hora de iniciar un proyecto con Yii Framework es su herramienta de linea de comando para automatizar tareas: yiic, esta se encuentra dentro de la carpeta framework y se usa desde la linea de comandos, usando una terminal pueden acceder a este archivo y ejecutarlo, su uso varia un poco dependiendo si usan Mac o PC a continuación pongo un ejemplo de ambos casos:

Usaremos a lo largo de estos tutoriales MAC OS X pero tratare de poner la versión en Windows para realizar las tareas donde sea conveniente. Si tienen problema con alguna versión no duden en escribir.

Abrimos una terminal en la cual realizaremos los siguientes pasos:

1. Nos dirigimos a la carpeta framework dentro de yii
2. Listamos los archivos
3. Ejecutamos php yiic
4. Al ejecutar el comando nos mostrara un error y un mensaje con los comandos disponibles, en este caso el comando que nos interesa es webapp

Creamos la aplicacion de la siguiente forma:

1. Ejecutamos el comando php yiic webapp ../../tutorial (donde ../../tutorial es la ruta y la carpeta que contendrá nuestra aplicación de tal forma que le estamos diciendo al comando webapp que cree la aplicación dos niveles arriba del nivel actual, es decir salimos de la carpeta framework, salimos de la carpeta yii y creamos el proyecto tutorial dentro de la carpeta htdocs pronto se familiarizaran con este comando, pueden hacer las pruebas que gusten).

1. El comando nos preguntara si queremos crear la aplicación y nos pondrá la ruta donde lo creara permitiendo continuar con Y o cancelar con N, tecleamos Y y damos Enter.
2. Se creara toda una serie de carpetas y al finalizar tendremos un mensaje de confirmación de creación del proyecto.

 

En el caso de Windows ejecutaran desde una linea de comandos yiic usando el archivo php.exe que esta dentro de la carpeta php de Wamp, comunmente la ruta sera algo como:

C:\wamp\bin\php\phpVersion\php.exe pueden navegar hasta esa carpeta en la terminal y cuando comprueben que ven el archivo php.exe ejecutar esto:

php.exe C:\wamp\www\yii\framework\yiic webapp ../../../www/tutorial

Para fines practicos en Windows es algo como:

ruta_hacia_php/php.exe ruta_hacia_yii_framework/yiic webapp ruta_hacia_htdocs/tutorial

Recuerden que webapp tratara de crear la aplicacion tutorial a partir de la ruta en que se encuentre asi que tendran que subir los niveles necesarios en la parte final del comando donde pasan el nombre de la aplicación.

Con esto tendremos el proyecto listo, pueden ir a su servidor localhost/tutorial y verificar la aplicación que esta creada y funcionando, ya tienen su primer sitio con el framework. =)

 

Naveguen el sitio, verán que ya cuenta con funcionalidad y un tema básico, exploren un poco el código de su aplicación, en el próximo tutorial veremos como funciona nuestra aplicación y que contiene cada una de las carpetas que se crearon.