Tutorial de instalación de Yii 2 plantilla avanzada en entorno local
Tutorial de instalación de Yii 2 plantilla avanzada en entorno local
En esté artículo muestro el proceso de instalación de la plantilla avanzada de Yii2.
Si ya tienes experiencia en Yii 2 te recomiendo primero aprender a instalar la versión básica que puedes encontrarla en el siguiente link.
1.- Requisitos de instalación de Yii 2 plantilla avanzada
Necesitas instalar composer, puedes encontrarlo en las siguientes ruta:
Si eres usuario Windows: https://getcomposer.org/download/
Yo recomiendo utilizar composer para la instalación ya que Yii2 es un framework que depende mucho de sus actualizaciones para tener actualizados los temas de seguridad y actualización de widgets.
2.- Instalación
En la documentación oficial sugiere la instalación de "composer global require "fxp/composer-asset-plugin:~1.1.1", pero yo te sugeriría intentar primero instalar sin instalar esto, ya que las últimas versiones de Composer tiene una versión más nueva del "composer-asset-plugin", por lo que tal vez no sea necesario instalar una versión anterior de este plugin.
Con Composer instalado, puedes entonces instalar la aplicación usando los siguientes comándos:
Entra a la carpeta de publicación web y ejecuta el siguiente comando, tomando en cuenta que el último parámetro "yii-application" será el nombre de tu carpeta que contendrá el proyecto, por lo que ese parámetro tu le puedes poner el nombre de tu proyecto o el que tu quieras.
Comando de instalación
composer create-project --prefer-dist yiisoft/yii2-app-advanced yii-application
3.- Preparando la aplicación
A diferencia de la plantilla básica ésta parte no puede comenzar a utilizarse, antes de utilizarse debes de preparar la aplicación, es decir ejecutar un comando que configura todo el entorno de acuerdo al tipo Desarrollo ó Producción.
Para tu sitio en desarrollo ejecuta el siguiente comando, marco en negrita el nombre de la aplicación.
php /path/to/yii-application/init
Y en producción puede ejecutar lo siguiente
php /path/to/yii-application/init --env=Production --overwrite=All
Te debe aparecer una ventana como esta
3.2 Configurando Base de Datos
Crea una nueva base de datos y ajusta la configuración de components['db'] en common/config/main-local.php como corresponde, cambiando la conexión por la de tu servidor, usuario y nombre de base de datos, el archivo luce como el siguiente.
3.2 Aplica las migraciones correspondientes
Aplica las migraciones con el comando de consola yii migrate. Te pedirá una confirmación y selecciona yes.
yii migrate
Al terminar aparecerá como aparece en la siguiente ventana.
Con ésta migración se crea la estructura básica para registrarse.
4.- Usando aplicación
Hay 3 aplicaciones en la plantilla avanzada: frontend, backend y consola.
También hay un directorio common que contiene los archivos usados por mas de una aplicación. Por ejemplo, el modelo User.
frontend y backend son ambas aplicaciones web y ambas contienen el directorio web. Este es el webroot al que debería apuntar tu servidor web.
Cada aplicación tiene su propio namespace y alias que corresponde a su nombre. Lo mismo se aplica al directorio common.
Para entrar a ver el sitio deberías poder entrar con estas urls en tu entorno local:
BACKEND
http://localhost/yii-application/backend/web/
- Frontend es tipicamente lo que se presenta a los usuarios finales, el proyecto en si.
- Backend es el panel de administración, analítica y tales funcionalidades.
- Consola es tipicamente usado para cron jobs y administración del servidor a bajo nivel. También es usado durante el despliegue de la aplicación y para manejar migraciones y assets.
También hay un directorio common que contiene los archivos usados por mas de una aplicación. Por ejemplo, el modelo User.
frontend y backend son ambas aplicaciones web y ambas contienen el directorio web. Este es el webroot al que debería apuntar tu servidor web.
Cada aplicación tiene su propio namespace y alias que corresponde a su nombre. Lo mismo se aplica al directorio common.
Para entrar a ver el sitio deberías poder entrar con estas urls en tu entorno local:
BACKEND
http://localhost/yii-application/backend/web/
Estructura de directorios
El directorio raíz contiene los siguientes subdirectorios:
backend - aplicación web backend.
common - archivos comunes de todas las aplicaciones.
console - aplicación de consola.
environments - entornos de configuración.
frontend - aplicación web frontend.
El directorio raíz contiene un conjunto de ficheros.
.gitignore contiene una lista de directorios ignorados por git sistema de versiones. Si tu necesitas algo que nunca lo incluirás en tu repositorio de código fuente, añádelo ahí.
composer.json - configuración de Composer descrito en Configurando Composer.
init - script de inicialización descrito en Configuración y Entorno.
init.bat - lo mismo para Windows.
LICENSE.md - información de la licencia. Pon la licencia de tu proyecto ahí. Especialmente cuando es de código abierto.
README.md - información básica sobre la instalación de la plantilla. Considerar remplazar esto con la información de tu proyecto y su instalación.
requirements.php - Comprobación de los requerimientos de Yii.
yii - para la aplicación de consola.
yii.bat - mismo para Windows.
Artículo actualizado: 12 de Marzo de 2020
Fuentes:
Comentarios
Publicar un comentario