Yii puede ser instalado de dos maneras, usando [Composer](https://getcomposer.org/) o descargando un archivo comprimido.
Puedes instalar Yii de dos maneras, utilizando el administrador de paquetes [Composer](https://getcomposer.org/) o descargando un archivo comprimido.
Es preferible usar la primera forma, ya que te permite instalar [extensiones](structure-extensions.md) o actualizar Yii ejecutando un simple comando.
La forma recomendada es la primera, ya que te permite instalar nuevas [extensions](structure-extensions.md) o actualizar Yii con sólo ejecutar un comando.
> Note: A diferencia de Yii 1, la instalación estándar de Yii 2 resulta en la descarga e instalación tanto del framework como del esqueleto de la aplicación.
La instalación estándar de Yii cuenta tanto con el framework como un template de proyecto instalados.
Un template de proyecto es un proyecto Yii funcional que implementa algunas características básicas como: login, formulario de contacto, etc.
El código está organizado de una forma recomendada. Por lo tanto, puede servir como un buen punto de partida para tus proyectos.
En esta y en las próximas secciones, describiremos cómo instalar Yii con el llamado *Template de Proyecto Básico*
y cómo implementar nuevas características por encima del template. Yii también provee otro template llamado
[Template de Proyecto Avanzado](https://github.com/yiisoft/yii2-app-advanced/blob/master/docs/guide/README.md) qué es mejor para desarrollar aplicaciones con varios niveles
en el entorno de un equipo de desarrollo.
> Info: El Template de Proyecto Básico es adecuado para desarrollar el 90 porciento de las aplicaciones Web. Difiere del
Template de Proyecto Avanzado principalmente en cómo está organizado el código. Si eres nuevo en Yii, te recomendamos
utilizar el Template de Proyecto Básico por su simplicidad pero funcionalidad suficiente.
Instalando a través de Composer <spanid="installing-via-composer"></span>
Installing via Composer <spanid="installing-via-composer"></span>
-------------------------------
-------------------------------
Si aún no tienes Composer instalado, puedes hacerlo siguiendo las instrucciones que se encuentran en
Si aún no tienes Composer instalado, puedes hacerlo siguiendo las instrucciones que se encuentran en
[getcomposer.org](https://getcomposer.org/download/). En Linux y Mac OS X, se ejecutan los siguientes comandos:
[getcomposer.org](https://getcomposer.org/download/). En Linux y Mac OS X, se ejecutan los siguientes comandos:
curl -sS https://getcomposer.org/installer | php
```bash
mv composer.phar /usr/local/bin/composer
curl -sS https://getcomposer.org/installer | php
mv composer.phar /usr/local/bin/composer
```
En Windows, tendrás que descargar y ejecutar [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe).
En Windows, tendrás que descargar y ejecutar [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe).
Por favor, consulta la [Documentación de Composer](https://getcomposer.org/doc/) si encuentras algún problema
Por favor, consulta la [Documentación de Composer](https://getcomposer.org/doc/) si encuentras algún problema
o deseas obtener un conocimiento más profundo sobre su utilización.
o deseas obtener un conocimiento más profundo sobre su utilización.
Si ya tienes composer instalado asegurate que esté actualizado ejecutando `composer self-update`
Si ya tienes composer instalado, asegúrate de tener una versión actualizada. Puedes actualizar Composer
ejecutando el comando `composer self-update`
Teniendo Composer instalado, puedes instalar Yii ejecutando los siguientes comandos en un directorio accesible vía Web:
Teniendo Composer instalado, puedes instalar Yii ejecutando los siguientes comandos en un directorio accesible vía Web:
Nota: es posible que en al ejecutar el primer comando te pida tu username
composer global require "fxp/composer-asset-plugin:~1.1.1"
> Ten en cuenta que la versión de desarrollo de Yii no debería ser usada para producción ya que podría romper el funcionamiento actual de la aplicación.
> Ten en cuenta que la versión de desarrollo de Yii no debería ser utilizada en producción ya que podría romper tu código actual.
Instalando desde un Archivo Comprimido <spanid="installing-from-archive-file"></span>
Instalar desde un Archivo Comprimido <spanid="installing-from-archive-file"></span>
--------------------------------------
------------------------------------
Instalar Yii desde un archivo comprimido involucra dos pasos:
Instalar Yii desde un archivo comprimido involucra tres pasos:
1. Descargar el archivo desde [yiiframework.com](http://www.yiiframework.com/download/yii2-basic).
1. Descargar el archivo desde [yiiframework.com](http://www.yiiframework.com/download/yii2-basic).
2. Descomprimirlo en un directorio accesible vía Web.
2. Descomprimirlo en un directorio accesible vía Web.
3. Modificar el archivo `config/web.php` introduciendo una clave secreta para el ítem de configuración `cookieValidationKey`
(esto se realiza automáticamente si estás instalando Yii a través de Composer):
```php
// !!! insert a secret key in the following (if it is empty) - this is required by cookie validation
'cookieValidationKey' => 'enter your secret key here',
```
Otras Opciones de Instalación <spanid="other-installation-options"></span>
Otras Opciones de Instalación <spanid="other-installation-options"></span>
-----------------------------
-----------------------------
Las instrucciones anteriores muestran cómo instalar Yii, lo que también crea una aplicación Web lista para ser usada.
Las instrucciones anteriores muestran cómo instalar Yii, lo que también crea una aplicación Web lista para ser usada.
Este es un buen punto de partida para pequeñas aplicaciones, o cuando apenas estás aprendiendo a utilizar Yii.
Este es un buen punto de partida para la mayoría de proyectos, tanto grandes como pequeños. Es especialmente adecuado si recién
estás aprendiendo a utilizar Yii.
Pero también hay otras opciones de instalación disponibles:
Pero también hay otras opciones de instalación disponibles:
@ -65,45 +96,61 @@ Pero también hay otras opciones de instalación disponibles:
Verificando las Instalación <spanid="verifying-installation"></span>
Verificando las Instalación <spanid="verifying-installation"></span>
---------------------------
---------------------------
Después de la instalación, puedes acceder a la aplicación instalada a través de la siguiente URL:
Una vez finalizada la instalación, o bien configura tu servidor web (mira la sección siguiente) o utiliza
el [servidor web incluido en PHP](https://secure.php.net/manual/en/features.commandline.webserver.php) ejecutando el siguiente
comando de consola estando parado en el directorio `web` de la aplicación:
```bash
php yii serve
```
> Note: Por defecto el servidor HTTP escuchará en el puerto 8080. De cualquier modo, si el puerto está en uso o deseas
servir varias aplicaciones de esta manera, podrías querer especificar qué puerto utilizar. Sólo agrega el argumento --port:
```bash
php yii serve --port=8888
```
```
http://localhost/basic/web/index.php
Puedes utilizar tu navegador para acceder a la aplicación instalada de Yii en la siguiente URL:
```
```
http://localhost:8080/.
Esta URL da por hecho que Yii se instaló en un directorio llamado `basic`, directamente bajo el directorio del Servidor Web,
y que el Servidor Web está corriendo en tu máquina local (`localhost`). Sino, podrías necesitar ajustarlo de acuerdo a tu entorno de instalación.
![Instalación Correcta de Yii](images/start-app-installed.png)
![Instalación Correcta de Yii](images/start-app-installed.png)
Deberías ver la página mostrando "Congratulations!" en tu navegador. Si no ocurriera, por favor chequea que la instalación
Deberías ver la página mostrando "Congratulations!" en tu navegador. Si no ocurriera, por favor chequea que la instalación
de PHP satisface los requerimientos de Yii. Esto puedes hacerlo usando cualquiera de los siguientes procedimientos:
de PHP satisfaga los requerimientos de Yii. Esto puedes hacerlo usando cualquiera de los siguientes procedimientos:
* Visitando la URL `http://localhost/basic/requirements.php` en tu navegador
* Copiando `/requirements.php` a `/web/requirements.php` y visitando la URL `http://localhost/basic/requirements.php` en tu navegador
* Corriendo los siguientes comandos:
* Corriendo los siguientes comandos:
```
```bash
cd basic
cd basic
php requirements.php
php requirements.php
```
```
Deberías configurar tu instalación de PHP para que satisfaga los requisitos mínimos de Yii. Lo que es más importante,
debes tener PHP 5.4 o mayor. También deberías instalar la [Extensión de PHP PDO](http://www.php.net/manual/es/pdo.installation.php)
y el correspondiente driver de base de datos (como `pdo_mysql` para bases de datos MySQL), si tu aplicación lo necesitara.
Deberías configurar tu instalación de PHP para que satisfaga los requisitos mínimos de Yii. Lo que es más importante, debes tener PHP 5.4 o mayor.
También deberías instalar la [Extensión de PHP PDO](http://www.php.net/manual/es/pdo.installation.php) y el correspondiente driver de base de datos
(como `pdo_mysql` para bases de datos MySQL), si tu aplicación lo necesitara.
Configurar Servidores Web <spanid="configuring-web-servers"></span>
-------------------------
Configurando Servidores Web <spanid="configuring-web-servers"></span>
> Info: Puedes saltear esta sección por ahora si sólo estás probando Yii sin intención
---------------------------
de poner la aplicación en un servidor de producción.
> Info: Puedes saltear esta sección por ahora si sólo estás probando Yii sin intención de poner la aplicación en un servidor de producción.
La aplicación instalada siguiendo las instrucciones mencionadas debería estar lista para usar tanto
con un [servidor HTTP Apache](http://httpd.apache.org/) como con un [servidor HTTP Nginx](http://nginx.org/),
en Windows, Mac OS X, o Linux utilizando PHP 5.4 o mayor. Yii 2.0 también es compatible con [HHVM](http://hhvm.com/)
de Facebook. De todos modos, hay algunos casos donde HHVM se comporta diferente del
PHP oficial, por lo que tendrás que tener cuidados extra al utilizarlo.
La aplicación instalada debería estar lista para usar tanto con un [servidor HTTP Apache](http://httpd.apache.org/) como con un [servidor HTTP Nginx](http://nginx.org/),
En un servidor de producción, podrías querer configurar el servidor Web para que la aplicación sea accedida
en Windows, Mac OS X, o Linux.
a través de la URL `http://www.example.com/index.php` en vez de `http://www.example.com/basic/web/index.php`. Tal configuración
require apuntar el document root de tu servidor Web a la carpeta `basic/web`. También podrías
En un servidor de producción, podrías querer configurar el servidor Web para que la aplicación sea accedida a través de la
querer ocultar `index.php` de la URL, como se describe en la sección [Parseo y Generación de URLs](runtime-url-handling.md).
URL `http://www.example.com/index.php` en vez de `http://www.example.com/basic/web/index.php`. Tal configuración
require apuntar el document root de tu servidor Web al directorio `basic/web`. También podrías querer ocultar `index.php`
de la URL, como se describe en la sección [Parseo y Generación de URLs](runtime-url-handling.md).
En esta sub-sección, aprenderás a configurar tu servidor Apache o Nginx para alcanzar estos objetivos.
En esta sub-sección, aprenderás a configurar tu servidor Apache o Nginx para alcanzar estos objetivos.
> Info: Al definir `basic/web` como document root, también previenes que los usuarios finales accedan
> Info: Al definir `basic/web` como document root, también previenes que los usuarios finales accedan
@ -120,29 +167,29 @@ la sección [Entorno de Hosting Compartido](tutorial-shared-hosting.md) para má
Utiliza la siguiente configuración del archivo `httpd.conf` de Apache dentro de la configuración del virtual host. Ten en cuenta
Utiliza la siguiente configuración del archivo `httpd.conf` de Apache dentro de la configuración del virtual host. Ten en cuenta
que deberás reemplazar `path/to/basic/web` con la ruta real a `basic/web`.
que deberás reemplazar `path/to/basic/web` con la ruta real a `basic/web`.
```
```apache
# Definir el document root de "basic/web"
# Definir el document root como "basic/web"
DocumentRoot "path/to/basic/web"
DocumentRoot "path/to/basic/web"
<Directory"path/to/basic/web">
<Directory"path/to/basic/web">
# utiliza mod_rewrite para soporte de URLs amigables
RewriteEngine on
RewriteEngine on
# Si el directorio o archivo existe, utiliza la petición directamente
# Si el directorio o archivo existe, utiliza el request directamente
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteCond %{REQUEST_FILENAME} !-d
# Sino envía el request a index.php
# Sino, redirige la petición a index.php
RewriteRule . index.php
RewriteRule . index.php
# ...más configuraciones...
# ...otras configuraciones...
</Directory>
</Directory>
```
```
### Configuración Recomendada de Nginx <spanid="recommended-nginx-configuration"></span>
### Configuración Recomendada de Nginx <spanid="recommended-nginx-configuration"></span>
Deberías haber instalado PHP como un [FPM SAPI](http://php.net/install.fpm) para utilizar [Nginx](http://wiki.nginx.org/).
Para utilizar [Nginx](http://wiki.nginx.org/), debes instalar PHP como un [FPM SAPI](http://php.net/install.fpm).
Utiliza la siguiente configuración de Nginx, reemplazando `path/to/basic/web` con la ruta real a`basic/web` y `mysite.local` con el
Utiliza la siguiente configuración de Nginx, reemplazando `path/to/basic/web` con la ruta real a
hostname real del servidor.
`basic/web` y `mysite.local` con el hostname real a servir.
```
```
server {
server {
@ -156,12 +203,12 @@ server {
root /path/to/basic/web;
root /path/to/basic/web;
index index.php;
index index.php;
access_log /path/to/basic/log/access.log main;
access_log /path/to/basic/log/access.log;
error_log /path/to/basic/log/error.log;
error_log /path/to/basic/log/error.log;
location / {
location / {
# Redireccionar a index.php todo lo que no sea un archivo real
# Redireccionar a index.php todo lo que no sea un archivo real
try_files $uri $uri/ /index.php?$args;
try_files $uri $uri/ /index.php$is_args$args;
}
}
# descomentar para evitar el procesamiento de llamadas de Yii a archivos estáticos no existente
# descomentar para evitar el procesamiento de llamadas de Yii a archivos estáticos no existente