1. Why yii2-practical-b?
2. Some Key Additions
3. Directory Structure
4. Requirements
5. Installation
6. Configuration
7. Documentation
8. Report
9. License
10. Resources

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 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.

Note: This template offers a solution for developers running their app on a SHARED HOST or having complex needs to work with multiple subdomains without having any ability on their HOST to control the different webroots for different apps.

Some Key Additions ¶

1. The template has some security preconfigured for users with Apache web servers. It has a default .htaccess security configuration setup.
2. The template has prettyUrl enabled by default and the changes have been made to .htaccess as well as urlManager component config in the config directory.

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.

Documentation ¶

You can view the documentation and submit your comments.

Report ¶

• Report any issues on the project page
• Use the forum page for any discussions on this extension

License ¶

yii2-app-practical-b is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.

Resources ¶

• Github Project
• Packagist Package
• Documentation & Demo