After installing a app in the yii2-advanced application you normally would access the frontend from https://domain/app/frontend/web.

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

The yii2-app-practical 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 frontend/web is entirely eliminated and one can directly access the application frontend from https://domain/app

All other aspects of the app configuration remain the same as the yii2-advanced app. The common, backend and console will remain as is. The frontend config, assets, models, controllers, views, widgets and components, will still reside within the frontend directory. It is just the web access that is moved out to app root.

/
    /                    contains the frontend entry script, favicon, and robots.txt.
    assets/              contains the frontend web runtime assets
common
    config/              contains shared configurations
    mail/                contains view files for e-mails
    models/              contains model classes used in both backend and frontend
console
    config/              contains console configurations
    controllers/         contains console controllers (commands)
    migrations/          contains database migrations
    models/              contains console-specific model classes
    runtime/             contains files generated during runtime
backend
    assets/              contains backend application assets such as JavaScript and CSS
    config/              contains backend configurations
    controllers/         contains Web controller classes
    models/              contains backend-specific model classes
    runtime/             contains files generated during runtime
    views/               contains view files for the Web application
    web/                 contains the entry script and Web resources
frontend
    assets/              contains frontend application assets such as JavaScript and CSS
    config/              contains frontend configurations
    controllers/         contains Web controller classes
    models/              contains frontend-specific model classes
    runtime/             contains files generated during runtime
    views/               contains view files for the Web application
    widgets/             contains frontend widgets
vendor/                  contains dependent 3rd-party packages
environments/            contains environment-based overrides
tests                    contains various tests for the "practical" application
    codeception/         contains tests developed with Codeception PHP Testing Framework

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

After you install the application, you have to conduct the following steps to initialize the installed application. You only need to do these once for all.

1. Run command init to initialize the application with a specific environment.

2. Create a new database and adjust the components['db'] configuration in common/config/main-local.php accordingly.

3. Apply migrations with console command yii migrate. This will create tables needed for the application to work.

4. Set document roots of your Web server:

   • for frontend /path/to/yii-application/ and using the URL https://frontend/

   • for backend /path/to/yii-application/backend/ and using the URL https://backend/

To login into the application, you need to first sign up, with any of your email address, username and password. Then, you can login into the application with same email address and password at any time.

Install additional composer packages:

• php composer.phar require --dev "codeception/codeception: 1.8.*@dev" "codeception/specify: *" "codeception/verify: *"

This application boilerplate use database in testing, so you should create three databases that are used in tests:

• yii2_practical_unit - database for unit tests;

• yii2_practical_functional - database for functional tests;

• yii2_practical_acceptance - database for acceptance tests.

To make your database up to date, you can run in needed test folder yii migrate, for example if you are starting from frontend tests then you should run yii migrate in each suite folder acceptance, functional, unit it will upgrade your database to the last state according migrations.

To be able to run acceptance tests you need a running webserver. For this you can use the php builtin server and run it in the directory where your main project folder is located. For example if your application is located in /www/practical all you need to is: cd /www and then php -S 127.0.0.1:8080 because the default configuration of acceptance tests expects the url of the application to be /practical/. If you already have a server configured or your application is not located in a folder called practical, you may need to adjust the TEST_ENTRY_URL in frontend/tests/_bootstrap.php and backend/tests/_bootstrap.php.

After that is done you should be able to run your tests, for example to run frontend tests do:

• cd frontend

• ../vendor/bin/codecept build

• ../vendor/bin/codecept run

In similar way you can run tests for other application tiers - backend, console, common.

You also can adjust you application suite configs and _bootstrap.php settings to use other urls and files, as it is can be done in yii2-basic.

Follow the tests section README for further details on setting up the tests.

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