mirror of
https://github.com/yiisoft/yii.git
synced 2026-03-09 17:46:55 +01:00
249 lines
10 KiB
Plaintext
249 lines
10 KiB
Plaintext
Creando primera aplicación Yii
|
|
==============================
|
|
|
|
Para ingresar al mundo de Yii, en esta scción le indicamos como crear
|
|
nuestra primera aplicación Yii. Usaremos la poderosa herramienta `yiic`
|
|
que puede ser utilizadapara automatizar la creación del códgo de ciertas
|
|
tareas. Por conveniencia asumimos que `YiiRoot` es el directorio donde Yii
|
|
se encuentra instalado y `WebRoot` es la ruta del documento de tu Web Server.
|
|
|
|
Ejecute `yiic` en la linea de comandos de la siguiente manera:
|
|
|
|
~~~
|
|
% YiiRoot/framework/yiic webapp WebRoot/testdrive
|
|
~~~
|
|
|
|
> Note|Nota: Cuando ejecuta `yiic` en Mac OS, Linux o Unix, usted deberá
|
|
> modificar los permisos del archivo `yiic` para poder ejecutarlo.
|
|
> Alternativamente puede correr la herramienta de la siguiente manera,
|
|
>
|
|
> ~~~
|
|
> % cd WebRoot/testdrive
|
|
> % php YiiRoot/framework/yiic.php webapp WebRoot/testdrive
|
|
> ~~~
|
|
|
|
Esto creará una aplicación Yii esqueleto en el directorio
|
|
`WebRoot/testdrive`. Esta aplicación contiene la estructura de directorios
|
|
requerida por la mayoría de las aplicaciones Yii.
|
|
|
|
Sin escribir ni una sola linea de código, nosotros podemos probar nuestra
|
|
primera aplicación Yii ingresando a la siguiente URL en un explorador Web:
|
|
|
|
~~~
|
|
http://hostname/testdrive/index.php
|
|
~~~
|
|
|
|
Como vemos, la aplicación contiene tres páginas: homepage (la página inicial),
|
|
contact (página de contacto) y login (página de login de usuario).
|
|
La página inicial muestra información de la aplicación y del estado del usuario logueado,
|
|
la página de contacto contiene un formulario para rellenar y enviar sus consultas y
|
|
la página de login de usuario permite a los mismos autenticarse para acceder a contenidos
|
|
que necesitan privilegios de acceso.
|
|
Mire las siguientes pantallas para más detalles.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
El siguiente diagrama muestra la estructura de directorios de nuestra aplicación.
|
|
Por favor mire [Convenciones](/doc/guide/basics.convention#directory) para una explicación
|
|
detallada acerca de esta estructura.
|
|
|
|
~~~
|
|
testdrive/
|
|
index.php archivo de entrada de la aplicación Web
|
|
assets/ contiene archivos de recursos públicos
|
|
css/ contiene archivos CSS
|
|
images/ contiene archivos de imágenes
|
|
themes/ contiene temas de la aplicación
|
|
protected/ contiene los archivos protegidos de la aplicación
|
|
yiic script de linea de comandos yiic
|
|
yiic.bat script de linea de comandos yiic para Windows
|
|
commands/ contiene comandos 'yiic' personalizados
|
|
shell/ contiene comandos 'yiic shell' personalizados
|
|
components/ contiene componentes reusables
|
|
MainMenu.php clase de widget 'MainMenu'
|
|
Identity.php clase 'Identity' utilizada para autenticación
|
|
views/ contiene los archivos de vistas para los widgets
|
|
mainMenu.php el archivo vista para el widget 'MainMenu'
|
|
config/ contiene archivos de configuración
|
|
console.php configuración aplicación consola
|
|
main.php configuración de la aplicación Web
|
|
controllers/ contiene los archivos de clase de controladores
|
|
SiteController.php la clase controlador predeterminada
|
|
extensions/ contiene extensiones de terceros
|
|
messages/ contiene mensajes traducidos
|
|
models/ contiene archivos clase de modeloscontaining model class files
|
|
LoginForm.php el formulario modelo para la acción 'login'
|
|
ContactForm.php el formulario modelo para la acción 'contact'
|
|
runtime/ contiene archivos temporarios generados
|
|
views/ contiene archivos de vista de controladores y de diseño
|
|
layouts/ contiene archivos de diseño
|
|
main.php el diseño default para todas las vistas
|
|
site/ contiene archivos vista para el controlador 'site'
|
|
contact.php contiene la vista para la acción 'contact'
|
|
index.php contiene la vista para la acción 'index'
|
|
login.php contiene la vista para la acción 'login'
|
|
system/ contiene archivos de vista del sistema
|
|
~~~
|
|
|
|
Conectandose a Base de Datos
|
|
----------------------------
|
|
|
|
La mayoría de las aplicaciónes Web utilizan bases de datos. Nuestra aplicación
|
|
test-drive no es una excepción. Para utilizar una base de datos, primero se debe
|
|
decir a la aplicación como conectarse a la misma. Esto se realiza modificando el archivo
|
|
de configuración de aplicación `WebRoot/testdrive/protected/config/main.php` como se
|
|
muestra a continuación.
|
|
|
|
~~~
|
|
[php]
|
|
return array(
|
|
......
|
|
'components'=>array(
|
|
......
|
|
'db'=>array(
|
|
'connectionString'=>'sqlite:protected/data/source.db',
|
|
),
|
|
),
|
|
......
|
|
);
|
|
~~~
|
|
|
|
En el ejemplo anterior agregamos la entrada `db` al arreglo de `components` (componentes)
|
|
el cual indica a la aplicación que se conecte a la base de datos
|
|
`WebRoot/testdrive/protected/data/source.db` cuando sea necesario.
|
|
|
|
> Note|Nota: Para utilizar la característica de base de datos de Yii necesitamos habilitar la
|
|
extensión PHP PDO y el driver especifico de la extensión PDO. Para la aplicación test-drive
|
|
se necesitará habilitar las extensiones `php_pdo` y `php_pdo_sqlite`.
|
|
|
|
En este momento tenemos que preparar una base de datos SQLite para que la configuración
|
|
anterior sea correcta. Usando alguna herramienta de administración SQLite podemos crear
|
|
la base de datos con la siguiente definición de tablas:
|
|
|
|
~~~
|
|
[sql]
|
|
CREATE TABLE User (
|
|
id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
|
|
username VARCHAR(128) NOT NULL,
|
|
password VARCHAR(128) NOT NULL,
|
|
email VARCHAR(128) NOT NULL
|
|
);
|
|
~~~
|
|
|
|
Para simplificar el ejemplo solo creamos la tabla `User` en nuestra base de datos.
|
|
El archivo de base de datos SQLite debe ser salvado como
|
|
`WebRoot/testdrive/protected/data/source.db`. Nota: tanto el archivo
|
|
como el directorio deben tener permisos de escritura para el proceso de servidor
|
|
Web como lo requiere SQLite.
|
|
|
|
Implementando operaciones CRUD
|
|
------------------------------
|
|
|
|
Ahora comienza la parte divertida. Queremos implementar las operaciones CRUD
|
|
para la tabla `User` que acabamos de crear. Esto es una práctica común en
|
|
aplicaciónes prácticas.
|
|
|
|
En vez de estar lidiando con escribir el codigo actual podemos utilizar la poderosa
|
|
herramienta `yiic` nuevamente para automaticar la generación de codigo por nosotros.
|
|
Este proceso es tambien conocido como *scaffolding*. Abre una ventana de linea de comandos
|
|
y executa los comando listados a continuación:
|
|
|
|
~~~
|
|
% cd WebRoot/testdrive
|
|
% protected/yiic shell
|
|
Yii Interactive Tool v1.0
|
|
Please type 'help' for help. Type 'exit' to quit.
|
|
>> model User
|
|
generate User.php
|
|
|
|
The 'User' class has been successfully created in the following file:
|
|
D:\wwwroot\testdrive\protected\models\User.php
|
|
|
|
If you have a 'db' database connection, you can test it now with:
|
|
$model=User::model()->find();
|
|
print_r($model);
|
|
|
|
>> crud User
|
|
generate UserController.php
|
|
generate create.php
|
|
mkdir D:/wwwroot/testdrive/protected/views/user
|
|
generate update.php
|
|
generate list.php
|
|
generate show.php
|
|
|
|
Crud 'user' has been successfully created. You may access it via:
|
|
http://hostname/path/to/index.php?r=user
|
|
~~~
|
|
|
|
En el código anterior utilizamos el comando `yiic shell` para interactuar
|
|
con la aplicación esqueleto. Hemos ejecutado dos comandos: `model User` y
|
|
`crud User`. El primero genera la clase Modelo para la tabla `User` mientras
|
|
que el segundo lee el modelo `User` y genera el código necesario para las
|
|
operaciones CRUD.
|
|
|
|
> Note|Nota: Usted se puede encontrar con errores del estilo "...could not
|
|
> find driver", a pesar de que el script de verificación de requerimientos
|
|
> le haya indicado que tiene habilitado PDO y el driver PD correspondiente.
|
|
> Si esto ocurre puede intentar correr la herramienta `yiic` de la siguiente
|
|
> manera:
|
|
>
|
|
> ~~~
|
|
> % php -c path/to/php.ini protected/yiic.php shell
|
|
> ~~~
|
|
>
|
|
> donde `path/to/php.ini` representa el archivo PHP ini correcto.
|
|
|
|
Vamos a disfrutar de nuestro trabajo navegando a la siguiente URL:
|
|
|
|
~~~
|
|
http://hostname/testdrive/index.php?r=user
|
|
~~~
|
|
|
|
Esto nos mostrará una listado de usuarios que se encuentran como entradas
|
|
de la tabla `User`. Como nuestra tabla se encuentra vacía en este momento
|
|
no verá ningún dato.
|
|
|
|
Haga click en el enlace `New User` de la página. Si no estamos logueados
|
|
con anterioridad se nos redireccionará a la página de login de usuario.
|
|
Luego de loguearse usted verá un formulario de entrada que nos permitirá
|
|
agregar un nuevo usuario a nuestra tabla. Complete el formulario y haga
|
|
click en el botón `Create`. Si tiene algún tipo de error de ingreso,
|
|
un bonito error se le mostrará que previene que grabemos nuestro usuario
|
|
hasta que no sea correcto. Volviendo a la lista de usuarios podremos ver
|
|
el nuevo usuario agregado en la lista.
|
|
|
|
Repita el paso anterior para agregar más usuarios. Fijese que la lista de
|
|
usuarios contiene paginación automática de los datos de usuario si agrega
|
|
muchos para ser mostrados en una sola página.
|
|
|
|
Si nos logueamos como administrador utilizando `admin/admin` podremos ver
|
|
la página de administración en la siguiente URL:
|
|
|
|
~~~
|
|
http://hostname/testdrive/index.php?r=user/admin
|
|
~~~
|
|
|
|
Esto nos mostrará una tabla de entradas de usuarios. Podemos clickear en
|
|
las celdas de los titulos para ordenar los datos de acuerdo a esa columna.
|
|
Este cuadro también contiene paginación en caso de que la cantidad de entradas
|
|
de usuarios sea mayor a las que se muestran en una página.
|
|
|
|
Todas estas bellas características han sido creadas sin que tengamos que
|
|
escribir ni una sola linea de código!
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
<div class="revision">$Id: quickstart.first-app.txt 723 2009-02-21 18:14:05Z sebathi $</div> |