Yii 2 Practical-B Application Template

The Yii 2 Practical-B Application Template is a skeleton Yii 2 application based on the yii2-basic template best for rapidly creating small projects. The template allows a practical method to directly access the application from the app root.

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.

Why yii2-practical-b?

After installing a app, in the yii2-basic application you normally would access the frontend by:

http://domain/app/web

However, in many practical scenarios (especially on shared and single domain hosts) one would want their users to directly access the app as:

http://domain/app

The yii2-app-practical-b enables you to achieve just that by carefully moving and rearranging the bootstrap files and web components of frontend to work directly out of the app root. The web folder is entirely eliminated and one can directly access the application frontend this way:

http://domain/app

All other aspects of the app configuration remain the same as the yii2-basic app. The original assets folder in the approot is renamed to assets_b, while the web/assets folder moves to app root.

DIRECTORY STRUCTURE

    /                   contains the entry script and web resources
    assets/             contains runtime web assets
    assets_b/           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 yii2-practical-b application
    vendor/             contains dependent 3rd-party packages
    views/              contains view files for the Web application

REQUIREMENTS

The minimum requirement by this application template that your Web server supports PHP 5.4.0.

INSTALLATION

Install from an Archive File

Extract the archive file downloaded from yiiframework.com to a directory named practical-b that is directly under the Web root.

You can then access the application through the following URL:

http://localhost/practical-b/

Install via Composer

If you do not have Composer, you may install it by following the instructions at getcomposer.org.

You can then install this application template using the following command:

php composer.phar create-project --prefer-dist --stability=dev kartik-v/yii2-app-practical-b practical-b

Now you should be able to access the application through the following URL, assuming practical-b is the directory directly under the Web root.

http://localhost/practical-b

CONFIGURATION

Database

Edit the file config/db.php with real data, for example:

return [
	'class' => 'yii\db\Connection',
	'dsn' => 'mysql:host=localhost;dbname=yii2practicalb',
	'username' => 'root',
	'password' => '1234',
	'charset' => 'utf8',
];

NOTE: Yii won't create the database for you, this has to be done manually before you can access it.

Also check and edit the other files in the config/ directory to customize your application.