Yii 2 Basic Project Template with dotenv Support
The template contains the basic features including user login/logout and a contact page.
It includes all commonly used configurations that would allow you to focus on adding new
features to your application. This template also removes the basic/web
from the url., (*1)
, (*2)
DIRECTORY STRUCTURE
assets/ contains assets definition
commands/ contains console commands (controllers)
config/ contains application configurations
controllers/ contains Web controller classes
mail/ contains view files for e-mails
models/ contains model classes
runtime/ contains files generated during runtime
tests/ contains various tests for the basic application
vendor/ contains dependent 3rd-party packages
views/ contains view files for the Web application
web/ contains the entry script and Web resources
REQUIREMENTS
The minimum requirement by this project template that your Web server supports PHP 5.4.0., (*3)
INSTALLATION
Install via Composer
If you do not have Composer, you may install it by following the instructions
at getcomposer.org., (*4)
You can then install this project template using the following command:, (*5)
php composer.phar global require "fxp/composer-asset-plugin:^1.2.0"
php composer.phar create-project --prefer-dist --stability=dev frixou89/yii2-basic-app-dotenv basic
Now you should be able to access the application through the following URL, assuming basic
is the directory
directly under the Web root., (*6)
http://localhost/
Install from an Archive File
Download and extract the archive file to a directory named basic
that is directly under the Web root., (*7)
Set cookie validation key in config/web.php
file to some random secret string:, (*8)
'request' => [
// !!! insert a secret key in the following (if it is empty) - this is required by cookie validation
'cookieValidationKey' => '<secret random string goes here>',
],
You can then access the application through the following URL:, (*9)
http://localhost/
CONFIGURATION
Copy .env.dist
and rename it to .env
, (*10)
Database
Edit the .env
file with real data, for example:, (*11)
Migration
To create user
table you need to run Yii migrate from the root directory, (*12)
php yii migrate