Для загрузки сторонних пакетов зависимостей приложения у вас должен быть установлен Composer с плагином composer-asset-plugin, который используется для установки пакетов зависимостей из Bower и npm:
$ composer global require "fxp/composer-asset-plugin"
Загрузить приложение можно с помощью Composer:
$ composer create-project --prefer-dist --stability=dev kmarenov/yii2-app-test
Также можно клонировать репозиторий проекта с GitHub используя Git:
$ git clone https://github.com/kmarenov/yii2-app-test.git
И затем установить с помощью Composer все необходимые пакеты зависимостей:
$ сd yii2-app-test
$ composer install --prefer-dist
В файле config/db.php
необходимо указать параметры подключения к базе данных:
return [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=test',
'username' => 'root',
'password' => 'mysqlroot',
'charset' => 'utf8',
];
Саму базу данных необходимо создать вручную.
Создать все таблицы, необходимые для работы приложения, и наполнить их тестовыми данными можно используя миграции.
Для этого необходимо запустить их с помощью консольного приложения yii
$ сd yii2-app-test
$ ./yii migrate
Выполнение миграций может занять достаточно много времени в связи с тем, что происходит наполнение базы данных большим количеством тестовых записей, поэтому рекомендуется разворачивать базу данных используя готовый дамп базы данных, созданной при помощи данных миграций.
В корневом каталоге проекта находится файл test.sql
c дампом базы данных, развернув который можно получить готовую
базу данных, содержащую всё необходимое для работы приложения, включая тестовые записи.
Развернуть дамп можно с помощью утилиты mysql
:
$ сd yii2-app-test
$ mysql -u root -p test < test.sql
Располагать приложение на веб-сервере следует таким образом, чтобы корневым каталогом веб-сервера являлся каталог
приложения /web
Запустить приложение можно используя встроенный в PHP веб-сервер. Для этого его нужно запустить из каталога /web
$ сd yii2-app-test/web
$ php -S localhost:8888
После этого приложение будет доступно по адресу http://localhost:8888/
Проект содержит готовые файлы конфигурации для Vagrant.
Для запуска с использованием Vagrant у вас должны быть установлены VirtualBox и Vagrant. Также для Vagrant рекомендуется установить плагин vagrant-vbguest, который автоматически разрешает ситуацию в том случае, если версии VirtualBox Guest Additions на вашем компьютере и внутри виртуальной машины различаются:
$ vagrant plugin install vagrant-vbguest
Запуск виртуальной машины со всем необходимым окружением осуществляется с помощью команды vagrant up
из
каталога проекта:
$ сd yii2-app-test
$ vagrant up
В том случае, если запуск приложения осуществляется с помощью Vagrant, нет необходимости вручную создавать базу данных.
Она автоматически создастся при развертывании виртуальной машины, и приложение будет корректно функционировать используя
те параметры подключения к базе данных, которые уже прописаны в файле config/db.php
.
После запуска виртуальной машины приложение будет доступно по адресу http://localhost:8888/
При запуске с помощью Vagrant выполнять запуск миграций или развертывание дампа базы данных следует внутри виртуальной машины, поскольку предустановленный внутири неё сервер MySQL по умолчанию доступен только из неё самой. Для этого необходимо перейти в каталог приложения внутри виртуальной машины, используя команды:
$ сd yii2-app-test
$ vagrant ssh
$ cd /vagrant
и затем произвести развертывание базы данных, выполнив запуск миграций:
$ ./yii migrate
или развертывание дампа база данных:
$ mysql -u root -p test < test.sql
Остановить виртуальную машину можно выполнив из каталога проекта команду vagrant halt
:
$ сd yii2-app-test
$ vagrant halt