akiraz2/yii2-app

Yii2 my advanced project template (Redis-cache, DB-queue, gentelella-admin, dektrium-user, DB-log)

Yii2 Fast Simple Advanced App

Yii2-app is Fast and Ready-to-production advanced project template., _(*1)

Dockerized, for development (mysql, nginx, php-fpm), _(*2)

Please, enable php intl extension for better work., _(*3)

Default, the template includes three tiers: frontend, backend, and console, each of which is a separate Yii application., _(*4)

NOTE: Template is in initial development. Anything may change at any time., _(*5)

Features

• Gentelella Admin template is beautiful and simple bootstrap, compatible with yii2 assets: yiister/yii2-gentelella, Demo
• Yii2 User is strong and proved user-module with many features: dektrium/yii2-user (login adminus, password adminus)
• Frontend and Backend User Controllers are filtered (by dektrium/yii2-user)
• File or DB cache, but I recommend Redis Cache - it is really fast
• Yii2 queue (DB table queue), but you can use Redis-queue or other yii2-queue docs
• Queue Manager with backend (/queuemanager/default/index) using ignatenkovnikita/yii2-queuemanager
• Log DB Target with backend (/log/index) - simply view log messages
• .htaccess - config for pretty urls (rewrite index.php), may be later add nginx config
• UrlManagerFrontend for backend app (all url rules in file frontend/config/urls.php, hostInfo in common/config/params.php)
• i18n translations in common/messages with config (current only English and Russian, language translation are welcome!)
• ContactForm in frontend app is improved: himiklab/yii2-recaptcha-widget, all email are saved to DB (common/models/EmailForm Model), optionally send message to Viber messenger via bot (install requirements Bogdaan/viber-bot-php and config, uncomment code in Model)
• Gii generator:

1. added yii2-queue Jobs generator
2. yii2 migration generator (from existing table) Insolita/yii2-migrik
3. schmunk42/yii2-giiant - really steroid, but in development with bugs

Available modules

These modules can be easy installed to Yii2-App using Composer:, _(*6)

• Yii2 Super Blog Module (semantic, seo): akiraz2/yii2-blog
• Yii2 many web-statictic counters (all-in-one) (yandex, google, own db-counter): akiraz2/yii2-stat
• yii2 opengraph component: dragonjet/yii2-opengraph
• yii2 settings (db+cache): yii2mod/yii2-settings
• etc...

Installation

Yii2-app template can be installed using composer. Run following command to download and install Yii2-app:, _(*7)

composer create-project --prefer-dist akiraz2/yii2-app my-site

After installation run init, _(*8)

Docker

Install yii2-app using Docker:, _(*9)

1. run command to create project

docker run --rm --interactive --tty \
  --volume $PWD:/app \
  --volume ${COMPOSER_HOME:-$HOME/.composer}:/tmp \
  composer create-project --prefer-dist akiraz2/yii2-app my-site

1. copy .env-dist to .env, configure if needed. You can change DB from mysql to postgresql - just change docker-compose.yml (and common/config/main-local.php after init)
2. copy /mysql/docker-entrypoint-initdb.d/createdb.sql.example to createdb.sql if you have ready DB (so dont run migrations)
3. docker-compose build (you can configure Docker PHP in /php/Dockerfile-debian before building, for example, add mongodb)
4. docker-compose up -d
5. docker-compose exec php bash, in terminal run composer install, then php init, then run other migrations (see next)
6. open http://localhost:8100 to test frontend (backend is on http://localhost:8200)

Access to Console App: docker-compose exec php bash and php yii mycommand/action, _(*10)

Migrations

NOTE: Make sure that you have properly configured db application component and run the following command, _(*11)

php yii migrate/up --migrationPath=@vendor/dektrium/yii2-user/migrations
php yii migrate --migrationPath=@yii/log/migrations/
php yii migrate --migrationPath=vendor/ignatenkovnikita/yii2-queuemanager/migrations/
php yii migrate/up

Default User Credentials

login: adminus password: adminus, _(*12)

Web server config

For newbies, I will recommend reading these instructions yiisoft/yii2-app-advanced/start-installation.md (apache, nginx, etc\hosts, _(*13)

Development

Messages

Change in common/config/main.php, _(*14)

'language' => 'ru-RU',
'sourceLanguage' => 'en-US',

Add your language in common/messages/config.php, _(*15)

    'languages' => [
        'ru-RU',
    ],

In shell, _(*16)

php yii message/extract common/messages/config.php

Support

If you have any questions or problems with Yii2-App you can ask them directly by using following email address: akiraz@bk.ru., _(*17)

Contributing

If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome. +PSR-2 style coding., _(*18)

I can apply patch, PR in 2-3 days! If not, please write me akiraz@bk.ru, _(*19)

Licensing

Yii2-App is released under the BSD License. See the bundled LICENSE.md for details., _(*20)