naffiq/yii2-app-bridge

Yii 2 Bridge Project Template

, _(*1)

Yii 2 Bridge App

Based on «Yii 2 Basic Project Template» and is a skeleton Yii 2 application best for rapidly creating small projects with admin panel., _(*2)

Installation

Create project via composer by running following command:, _(*3)

$ composer create-project naffiq/yii2-app-bridge MY_APP_NAME

Create config/local.php (you may copy config/example.local.php for example) and configure your local environment DB., _(*4)

$ cp config/example.local.php config/local.php

Note: local.php is registered in .gitignore to prevent config collisions between developers, _(*5)

Then run migrations with single command:, _(*6)

$ ./vendor/bin/bridge-install

Usage

With fresh installation you will have http://localhost:8008/admin/ (assuming you run php yii serve) which is yii2-bridge. Add your sub-modules for creating admin sections. More docs at Yii2 Bridge Wiki (in progress), _(*7)

Users

Yii2 Bridge utilizes yii2-usuario under the hood, which takes user management to new level. Create your first user with CLI command:, _(*8)

$ php yii user/create <email> <username> <password> <role> // role should be admin for your first user

Read Usuario docs for further details., _(*9)

Environment

You can pre-configure application for different environments and switch them easily. Change your config for different modes in these files:, _(*10)

• config/local.php — Local development. This file overwrites all configuration defined in your main.php or mode_*.php files;
• config/mode_stage.php — Staging (development) server;
• config/mode_prod.php — Production server;
• config/mode_test.php — Configuration for tests (used by codeception);

Then switch easily between them by creating mode.php file with mode name:, _(*11)

Example of config/mode.php:, _(*12)

prod

Note: mode.php is registered in .gitignore to prevent config collisions between environments. You have to create it manually or with deployer job once in every project environment., _(*13)

Refer to janisto/yii2-environment for further details., _(*14)

Testing

The app is ready to test and has example test for 2amigos/yii2-usuario user model with fixture included. Run tests with:, _(*15)

$ ./vendor/bin/codecept