This project is a skeleton Yii 2 application best for developing complex Web applications with multiple tiers.

The template includes three tiers: front end, back end, and console, each of which is a separate Yii application.

The template is designed to work in a team development environment.

Requirements check script:

php requirements.php

1. Clone the repository into the project destination directory.
2. Switch the project branch to the needed one: 'master', 'stage', 'live' etc.
3. Run the installation script using following command:

php install.php init/all

Project should be deployed beyond web accessible folder. Actual web root should be created as symlink to the 'web' folder:

ln -s /path/to/project/web /var/www/html/project

For assets (CSS and JavaScript) compression use following command:

cd /path/to/project/root
php yii asset config/frontend-asset-compress.php config/frontend-assets.php

See config/frontend-asset-compress.php file for more details.

The 'backend' assets compression is performed as separated command:

cd /path/to/project/root
php yii asset config/backend-asset-compress.php config/backend-assets.php

See config/backend-asset-compress.php file for more details.

Sitemap is generated by app\controllers\console\SitemapController::actionGenerate() method. Make sure all pages, which should appear at sitemap are processed in this method. For sitemap generation use following command:

cd /path/to/project/root
php yii sitemap/generate

After successful installation 'stage' or 'production' server can be updated using 'self-update' command.

In order to perform an update, run the following commands:

cd /path/to/project/root
php yii self-update config/self-update.php

Admin section generation:

php yii gii/adminCrud --modelClass="app\models\db\{NAME}" --controllerClass="app\controllers\backend\{NAME}Controller" --searchModelClass="app\models\backend\{NAME}Search" --viewPath="@app/views/backend/{NAME}" --enableI18N=1

Admin section with context generation:

php yii gii/adminCrud --modelClass="app\models\db\{NAME}" --controllerClass="app\controllers\backend\{NAME}Controller" --searchModelClass="app\models\backend\{NAME}Search" --viewPath="@app/views/backend/{NAME}" --contextClass="app\models\db\{CONTEXT}" --enableI18N=1

Translation messages generation:

php yii message messages/config.php

This project supports testing via PHPUnit as well as via Codeception

Regular PHPUnit tests are located under 'tests\unit' directory. In case you have PHPUnit installed you can run them using phpunit command from the project root.

Please refer to Codeception Testing manual for the details about Codeception tests setup and running.