installation.md 2.6 KB

Установка

Установка composer-пакета

Предпочтительнее установить это расширение через composer.

Либо запустите

php composer.phar require --dev --prefer-dist yiisoft/yii2-gii

либо добавьте

"yiisoft/yii2-gii": "~2.0.0"

в require-dev секцию Вашего файла composer.json.

Конфигурация приложения

После того, как расширение Gii было установлено, Вы можете пользоваться им, добавив этот код в конфигурационный файл приложения:

return [
    'bootstrap' => ['gii'],
    'modules' => [
        'gii' => [
            'class' => 'yii\gii\Module',
        ],
        // ...
    ],
    // ...
];

Теперь Gii доступен по адресу:

http://localhost/path/to/index.php?r=gii

Если Вы используете "красивые" адреса (pretty URLs), то используйте такой URL:

http://localhost/path/to/index.php/gii

Note: По-умолчанию, если Вы запускаете gii с ip-адреса, отличного от localhost, доступ к нему будет закрыт. Чтобы изменить это поведение, добавьте ip-адреса, которым разрешен доступ, в конфигурацию:

'gii' => [
    'class' => 'yii\gii\Module',
    'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'] // настройте, как Вам нужно здесь
],

Если Вы настроили Gii аналогичным образом в консольном приложении, Вы сможете таким образом через консоль запустить Gii:

# измените путь на базовый Вашего приложения
cd path/to/AppBasePath

# эта команда покажет справку Gii
yii help gii

# эта команда покажет справку по генератору Моделей в Gii
yii help gii/model

# сгенерирует модель City из таблицы city
yii gii/model --tableName=city --modelClass=City

Basic-приложение

В шаблоне Basic-приложения структура конфигурации несколько отличается, поэтому Gii должен быть настроен в config/web.php:

// ...
if (YII_ENV_DEV) {
    // configuration adjustments for 'dev' environment
    // настройка конфигурации для разработки
    $config['bootstrap'][] = 'debug';
    $config['modules']['debug'] = 'yii\debug\Module';

    $config['bootstrap'][] = 'gii';
    $config['modules']['gii'] = 'yii\gii\Module'; // <--- здесь
}

А для настройки ip-адресов надо сделать следующее:

if (YII_ENV_DEV) {
    // configuration adjustments for 'dev' environment
    // настройка конфигурации для разработки
    $config['bootstrap'][] = 'debug';
    $config['modules']['debug'] = 'yii\debug\Module';

    $config['bootstrap'][] = 'gii';
    $config['modules']['gii'] = [
        'class' => 'yii\gii\Module',
        'allowedIPs' => ['127.0.0.1', '::1', '192.168.0.*', '192.168.178.20'],
    ];
}