Instalar Yii

Puedes instalar Yii de dos maneras, utilizando el administrador de paquetes Composer o descargando un archivo comprimido. La forma recomendada es la primera, ya que te permite instalar nuevas extensions o actualizar Yii con sólo ejecutar un comando.

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 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 via Composer

Si aún no tienes Composer instalado, puedes hacerlo siguiendo las instrucciones que se encuentran en getcomposer.org. En Linux y Mac OS X, se ejecutan los siguientes comandos:

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.

Por favor, consulta la Documentación de Composer si encuentras algún problema o deseas obtener un conocimiento más profundo sobre su utilización.

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:

composer global require "fxp/composer-asset-plugin:^1.4.1"
composer create-project --prefer-dist yiisoft/yii2-app-basic basic

El primer comando instala composer asset plugin, que permite administrar dependencias de paquetes bower y npm a través de Composer. Sólo necesitas ejecutar este comando una vez. El segundo comando instala Yii en un directorio llamado basic. Puedes elegir un nombre de directorio diferente si así lo deseas.

Note: Durante la instalación, Composer puede preguntar por tus credenciales de acceso de Github. Esto es normal ya que Composer necesita obtener suficiente límite de acceso de la API para traer la información de dependencias de Github. Para más detalles, consulta la documentación de Composer.

Tip: Si quieres instalar la última versión de desarrollo de Yii, puedes utilizar uno de los siguientes comandos, que agregan una opción de estabilidad:
Ventana de terminal
composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic
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.

Instalar desde un Archivo Comprimido

Instalar Yii desde un archivo comprimido involucra tres pasos:

Descargar el archivo desde yiiframework.com.
Descomprimirlo en un directorio accesible vía Web.
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):

// !!! 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

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 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:

Si sólo quieres instalar el núcleo del framework y entonces crear una nueva aplicación desde cero, puedes seguir las instrucciones explicadas en Generando una Aplicación desde Cero.
Si quisieras comenzar con una aplicación más avanzada, más adecuada para un entorno de desarrollo de equipo, deberías considerar instalar el Template de Aplicación Avanzada.

Verificando las Instalación

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 ejecutando el siguiente comando de consola estando parado en el directorio web de la aplicación:

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:

php yii serve --port=8888

Puedes utilizar tu navegador para acceder a la aplicación instalada de Yii en la siguiente URL:

http://localhost:8080/.

Instalación Correcta de Yii

Deberías ver la página mostrando “Congratulations!” en tu navegador. Si no ocurriera, por favor chequea que la instalación de PHP satisfaga los requerimientos de Yii. Esto puedes hacerlo usando cualquiera de los siguientes procedimientos:

Copiando /requirements.php a /web/requirements.php y visitando la URL http://localhost/basic/requirements.php en tu navegador
Corriendo los siguientes comandos:
Ventana de terminal
```
cd basic
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 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

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 como con un servidor HTTP Nginx, en Windows, Mac OS X, o Linux utilizando PHP 5.4 o mayor. Yii 2.0 también es compatible con HHVM 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.

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 URL https://www.example.com/index.php en vez de https://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 querer ocultar index.php de la URL, como se describe en la sección Parseo y Generación de URLs. 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 al código privado o archivos con información sensible de tu aplicación que están incluidos en los directorios del mismo nivel que basic/web. Denegando el acceso es una importante mejora en la seguridad.

Info: En caso de que tu aplicación corra en un entorno de hosting compartido donde no tienes permisos para modificar la configuración del servidor Web, aún puedes ajustar la estructura de la aplicación para mayor seguridad. Por favor consulta la sección Entorno de Hosting Compartido para más detalles.

Configuración Recomendada de Apache

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.

# Definir el document root como "basic/web"
DocumentRoot "path/to/basic/web"

<Directory "path/to/basic/web">
    # utiliza mod_rewrite para soporte de URLs amigables
    RewriteEngine on
    # Si el directorio o archivo existe, utiliza la petición directamente
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-d
    # Sino, redirige la petición a index.php
    RewriteRule . index.php

    # ...otras configuraciones...
</Directory>

Configuración Recomendada de Nginx

Para utilizar Nginx, debes instalar PHP como un FPM SAPI. Utiliza la siguiente configuración de Nginx, reemplazando path/to/basic/web con la ruta real a basic/web y mysite.test con el hostname real a servir.

server {
    charset utf-8;
    client_max_body_size 128M;

    listen 80; ## listen for ipv4
    #listen [::]:80 default_server ipv6only=on; ## listen for ipv6

    server_name mysite.test;
    root        /path/to/basic/web;
    index       index.php;

    access_log  /path/to/basic/log/access.log;
    error_log   /path/to/basic/log/error.log;

    location / {
        # Redireccionar a index.php todo lo que no sea un archivo real
        try_files $uri $uri/ /index.php$is_args$args;
    }

    # descomentar para evitar el procesamiento de llamadas de Yii a archivos estáticos no existente
    #location ~ \.(js|css|png|jpg|gif|swf|ico|pdf|mov|fla|zip|rar)$ {
    #    try_files $uri =404;
    #}
    #error_page 404 /404.html;

    location ~ \.php$ {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_pass   127.0.0.1:9000;
        #fastcgi_pass Unix:/var/run/php5-fpm.sock;
        try_files $uri =404;
    }

    location ~ /\.(ht|svn|git) {
        deny all;
    }
}

Al utilizar esta configuración, también deberías definir cgi.fix_pathinfo=0 en el archivo php.ini, y así evitar muchas llamadas innecesarias del sistema a stat().

Ten en cuenta también que al correr un servidor HTTPS, deberás agregar fastcgi_param HTTPS on; así Yii puede detectar propiamente si la conexión es segura.