Inicio con Yii y PHP : Primera configuración y Hola Mundo!

Este es el clásico tutorial de hola mundo, con el objeto de poner a rodar yii en tu servidor. En otros temas encontrarás mas profundidad y mas ejemplos, el objetivo aquí es simple: que tengas a yii funcionando.

PASO 1: DESCARGAR YII FRAMEWORK

Hay dos sitios de donde descargarlo, ambos son oficiales.

http://www.yiiframework.com/download/

o desde github:

https://github.com/yiisoft/yii/zipball/master

PASO 2: Descarga PHP

Yii Framework funciona bajo PHP, saca mucho provecho de las nuevas caracteristicas, asi que trata de seleccionar versiones de PHP de 5 para arriba.

http://php.net/downloads.php

PASO 3: Verifica que PHP funciona en tu entorno de desarrollo

En mi instalación, php esta ubicado en: C:\APPS\5.2.6, es decir, en este directorio encontraras a php.exe, php.ini y otros tantos mas.

Verficar tu entorno puede ser algo muy simple, como puede complicarse, asi que ire a lo mas simple, asumir que PHP esta instalado bajo tu Apache o IIS o cualquier otro gestor HTTP.

Pruebas:

En mi caso, mi Directorio WEB esta ubicado en E:\code, y mi hostname se llama localhost, por tanto yo pongo en mi explorador web la siguiente URL:

http://localhost/

al darle enter el browser me da un listado de todo lo que tengo en E:\code, trata de hacer lo mismo.

Para verificar que PHP funciona, lo que yo siempre hago es crear un script llamado info.php asi:

a) crea un nuevo archivo con extension PHP en tu directorio web, en mi caso: e:\code\info.php

b) escribe este codigo dentro del archivo:

Código PHP:

<?php echo phpinfo(); ?>

c) tras guardar el archivo, abre tu browser y navega asi:

Código:

http://localhost/info.php

eso DEBE mostrarte una pagina de información de PHP.

Si no aparece nada o si sale un error deberás revisar bien las rutas de tu directorio web. No puedo extenderme mucho en este punto aqui porque me salgo del foco y podria tomarme paginas extensas tratar de explicar todo para detectes el error. Trata de recurrir a un foro de php para que puedas solventar.

si php no esta corriendo, yii tampoco lo hará

PASO 4: instalar YII en tu sistema.

Bueno, el paso 1 es descargar Yii, ya deberias tener un archivo ZIP con todo Yii dentro. Solo vas a copiar ese archivo a alguna parte y lo descomprimirás (disculpame pero no voy a explicar como descomprimir un zip, tar o rar...)

Lo que si puedo decirte bien es que YII debe estar instalado de esta forma:

Mi directorio web esta ubicado en "E:\code", voy a poner los archivos descargados de YII en ese mismo directorio, asi: E:\code\yii , tu debes usar tu propio directorio web, es decir si e:\code es el mio y el tuyo es: C:\users\web, entonces vas a hacer que yii quede descompreso en C:\users\web\yii. Sea cual sea el caso, deberias ver lo siguiente en tu carpeta de instalacion de yii:

Código:

e:\code\yii\framework\
e:\code\yii\demos\
e:\code\yii\requirements\
e:\code\yii\README
e:\code\yii\LICENCE

PASO 5: Comprobar que YII funciona

Recuerda que en este ejemplo, mi directorio web esta en e:\code\,
recuerda que yii esta alojado ahi mismo, por tanto deberia aparecer contenido en tu browser si navegas hacia:

Código:

http://localhost/yii/requirements

Deberias recibir una pagina que dice:

Yii Requirement Checker

Description
This script checks if your server configuration meets the requirements for running Yii Web applications. It checks if the server is running the right version of PHP, if appropriate PHP extensions have been loaded, and if php.ini file settings are correct.

Esta pagina es para verificar que PHP tenga las extensiones requeridas instaladas, aparte de otros chequeos. Esa misma pagina te indica cuales extensiones deberias habilitar, deben estar en verde. En mi caso tengo lo siguiente:

Código:

PHP version                Passed
$_SERVER variable        Passed
Reflection extension    Passed
PCRE extension            Passed
SPL extension            Passed
DOM extension            Passed
PDO extension            Passed
PDO SQLite extension    Passed
PDO MySQL extension        Passed
PDO PostgreSQL extens    Warning
Memcache extension        Warning
APC extension            Warning
Mcrypt extension        Passed
SOAP extension            Passed
GD extension            Passed
Ctype extension            Passed

PASO 6: 
Creando una aplicación web con Yii Framework

Hasta aqui, yii esta instalado, ahora, no hemos creado la primera aplicacion, sino que hemos usado las herramientas basicas para instalarlo.

Vamos a crear una aplicacion en yii, esto se hace usando una herramienta de linea de comandos que trae yii llamada yiic.bat,

la encuentras en:

E:\code\yii\framework\yiic.bat

verifica que puedes llegar a ella mediante consola. de nuevo, estoy suponiendo que mi caso es e:\code, haz la prueba en tu propia instalacion.

cmd
e:
cd\
cd code
cd yii
cd framework
dir yiic.bat
deberias ver lo siguiente:
11/07/2012 14:59 616 yiic.bat

Lo importante aqui es que debes poder llegar a yiic.bat mediante consola, para puedas crear la aplicacion web.

ahora, para crea la aplicacion web "holamundo" en el directorio web e:\code tipeas lo siguiente:

E:\code\yii\framework\yiic.bat webapp e:\code\holamundo

te pedira confirmación: (tip*)

Create a Web application under 'E:\code\holamundo'? (yes|no) [no]:

tipeas: yes ( y luego enter )

yiic.bat respondera con:

Your application has been created successfully under E:\code\holamundo.

verifica el contenido del directorio:
E:\code\holamundo

y veras que contiene:

Código:

19/07/2012  18:40    <DIR>          .
19/07/2012  18:40    <DIR>          ..
19/07/2012  18:40    <DIR>          assets
19/07/2012  18:40    <DIR>          css
19/07/2012  18:40    <DIR>          images
19/07/2012  18:40    <DIR>          protected
19/07/2012  18:40    <DIR>          themes
19/07/2012  18:40               485 index-test.php
19/07/2012  18:40               480 index.php

ahora, de nuevo agarra el browser y navega hacia:

http://localhost/holamundo

veras que aparece la aplicacion web. Nos vemos en el siguiente tutorial para que aprendas a manejar esa aplicación web.

tip

Si obtienes un error de tipo : 

"php.exe" no se reconoce como un comando interno o externo, programa o archivo por lotes ejecutable.

debes editar el archivo yiic.bat y  modificar la ruta de tu php, exactamente donde esté el ejecutable php.exe, en mi caso es esta  linea :

if "%PHP_COMMAND%" == "" set PHP_COMMAND=D:\php\php.exe

----------------------------------------------------------------------------------------------

hey! si te he ayudado compartelo! o deja un comentario si podemos mejorar el código. 

if I have helped you share it! or leave a comment if we can improve the code.