Instalando Yii 2

Se puede instalar Yii 2, de dos maneras diferentes. Utilizando Composer o por descarga. La primera es la preferida, ya que permite instalar extensiones o actualizaciones con un simple comando.

Instalación usando Composer

Desde el siguiente link se puede descargar tanto para Linux, Mac OS X o Windows: descargar composer.
En dicha página constan los comandos y opciones para Linux. O el enlace de descarga para el ejecutable en el caso de Windows. También hay los correspondientes manuales.

En Windows, descargamos el archivo Composer-Setup.exe y ejecutamos el instalador siguiendo las instrucciones.

Uno de los problemas que tuve, es que Composer valida que la extensión OpenSSL de PHP esté habilitada. Si tienen el mismo error se les presentará un mensaje de error que dice:

Some settings on your machine make Composer unable to work properly.
Make sure that you fix the issues listed below and run this script again:
The openssl extension is missing, which means that secure HTTPS transfers are impossible.
If possible you should enable it or recompile php with --with-openssl

No es difícil corregirlo. Solo hay que retroceder un paso, activar la extensión php_openssl.dll en el archivo de configuración de PHP (php.ini) y volver a intentar la instalación. Esta vez no habrá problemas.

Por otro lado, necesitamos una cuenta en GitHub. Es gratuito.

Luego debemos abrirnos una ventana de consola (cmd), e ir al directorio en el cual queremos instalar nuestra aplicación Yii, el cual debe ser accesible desde nuestro servidor web.

Ejecutamos el comando:

composer global require "fxp/composer-asset-plugin:1.0.0-beta3"

Este comando lo hay que ejecutar una sola vez, el cual instala el plugin que permite administrar las dependencias a través de Composer.

Luego, ejecutamos el siguiente comando:

composer create-project --prefer-dist yiisoft/yii2-app-basic basic

Este comando lo utilizamos para instalar Yii en un directorio llamado basic. Si queremos otro directorio, debemos escribir el adecuado a nuestras necesidades.

Cuando nos solicite el username y el password debemos utilizar los de nuestra cuenta de GitHub.

También es posible tener la última versión de desarrollo de Yii. Recordemos que la versión de desarrollo no debe ser utilizada en producción, o nuestros ambientes definitivos. Solo debe ser utilizada para pruebas. El comando que debemos seguir es el siguiente:

composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic

Verificando la instalación

Después de haber realizado estos pasos, podemos ir a nuestro navegador web para probar. Escribimos la dirección similar a la siguiente:

http://127.0.0.1/projects/basic/web/

donde:
127.0.0.1 es mi servidor web, que en este caso estoy trabajando de forma local en mi computadora.
projects es el directorio en el cual se alojan mis proyectos y depende del servidor web que utilicemos. En otros casos suele ser www. O en otros casos no requiere.
basic es el directorio en el cual está nuestra aplicación y es el que especificamos anteriormente como basic
web es el subdirectorio de yii desde el cual se inicia la aplicación.

Si todo es correcto, veremos una pantalla como la de la imagen:

Posibles errores en la instalación de Yii 2

A pesar de haber realizado los pasos tal cual se describen aquí, es posible que obtengamos algún error como el siguiente:

Warning: require(D:\Archivos de programa\EasyPHP-DevServer-14.1VC9\data\localweb\projects\yii2\basic\web/../vendor/autoload.php): failed to open stream: No such file or directory in D:\Archivos de programa\EasyPHP-DevServer-14.1VC9\data\localweb\projects\yii2\basic\web\index.php on line 7

Fatal error: require(): Failed opening required 'D:\Archivos de programa\EasyPHP-DevServer-14.1VC9\data\localweb\projects\yii2\basic\web/../vendor/autoload.php' (include_path='.;C:\php\pear') in D:\Archivos de programa\EasyPHP-DevServer-14.1VC9\data\localweb\projects\yii2\basic\web\index.php on line 7

En este caso hay que revisar que tengamos el archivo autoload.php; y es muy probable que no le tengamos. Simplemente hay que borrar todos los archivos y el directorio en el cual íbamos a instalar yii y repetir nuestro segundo comando (el primero ya no es necesario), es decir:

composer create-project --prefer-dist --stability=dev yiisoft/yii2-app-basic basic




Durante la instalación debemos ver que descarga varios paquetes al 100%.

Luego podemos volver a probar a través de nuestro navegador web.

Instalando desde un archivo

También se puede instalar Yii 2 desde un archivo y para ello hay que seguir estos pasos:

1. Descargar el archivo desde el sitio web de Yii Framework.
2. Descomprimir el archivo descargado en una directorio web accesible.
3. Modificar el archivo config/web.php ingresando una clave secreta para la configuración de cookieValidationKey (Utilizando Composer, esto es automático)

// !!! insert a secret key in the following (if it is empty) - this is required by cookie validation'cookieValidationKey' => 'enter your secret key here',

Nuestra clave secreta la debemos escribir en lugar de enter your secret key here

Otras opciones de instalación

Las formas de instalación vistas nos ayudan a tener un esqueleto de nuestra aplicación web, útil para aprender Yii 2 o proyectos pequeños. Otras opciones disponibles que se pueden considerar son:

• Si se requiere instalar el framework completo (el core o núcleo) y construir una aplicación completa desde cero, se pueden seguir las instrucciones de la entrada La construcción de aplicaciones desde cero (próximamente).
• Si se necesita iniciar con una aplicación más sofisticada, más adecuada a equipos en ambientes de desarrollo, se puede revisar la entrada Plantilla de aplicación avanzada (próximamente).

Revisando requerimientos

Si durante la verificación de la instalación no se presenta la página de "Congratulations" se debe revisar que se cumplen con los requisitos mínimos para el funcionamiento de Yii.

Se puede acceder a la URL http://127.0.0.1/projects/basic/requirements.php en la cual se nos presentará una pantalla con todos los detalles. Los requisitos que se cumplen y los que fallan; así como la conclusión.

Otra manera es ejecutar el comando:

cd basic
php requirements.php

Lo más importante es que por lo menos sea la versión de PHP 5.4 la que utilizamos. Y habilitar la extensión PDO y el correspondiente driver de la base de datos que vayamos a utilizar (si vamos a utilizar una).

Instalando Yii 2 en producción

Como habremos notado, hay un subdirectorio llamado web que debemos añadir en nuestra dirección url si queremos acceder a nuestro archivo index.php y toda nuestra aplicación. Seguramente, en nuestro ambiente de producción ya no queremos que aparezca este subdirectorio, incluso tal vez sea nuestra intención ocultar el archivo index.php. El cómo instalar Yii 2 en producción lo podemos revisar en Configurando el servidor web



También te puede interesar:
Yii Framework 2
Configurando el servidor web