Yii2 Practical-B App yii2-app-practical-b

Latest Stable Version Latest Unstable Version Total Downloads Monthly Downloads Daily Downloads
Thankful to Krajee!
to get more out of us.

NOTE: This extension depends on the kartik-v/yii2-krajee-base extension which in turn depends on the yiisoft/yii2-bootstrap extension. Check the composer.json for this extension's requirements and dependencies that may be updated by composer.

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.

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.

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.

Note

This template benefits mostly developers running their apps on shared hosts, who do not have any access for running more than one web site on their account, or have any access to methods for URL rewrite like Apache Virtual Host etc. Apps running on dedicated hosts or hosts with root access would be able to do this differently using the default yii2-basic-app.
    /                   contains the entry script and web resources
    assets/             contains web runtime assets
    assets_b/           contains application assets such as JavaScript and CSS
    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

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

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

Note

When using a archive file method, the vendor folder is not automatically created. You must extract the yii2-basic vendor folder from here. Then you must copy this folder directly under the app root (i.e. practical-b directory).

You can then access the application through the URL: http://localhost/practical-b/.

The preferred way to install this application template is through composer. If you do not have Composer, you may install it by following the instructions at getcomposer.org. You can then install the application using the following command:

php composer.phar global require "fxp/composer-asset-plugin:1.0.0-beta3"
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 URL http://localhost/practical-b/, assuming practical-b is the directory directly under the Web root.

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.

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