diff --git a/docs/guide-ru/README.md b/docs/guide-ru/README.md index f4b79b7333..527dc1a27c 100644 --- a/docs/guide-ru/README.md +++ b/docs/guide-ru/README.md @@ -147,7 +147,7 @@ All Rights Reserved. * [Отладочная панель и отладчик](https://github.com/yiisoft/yii2-debug/blob/master/docs/guide/README.md) * [Генерация кода с Gii](https://github.com/yiisoft/yii2-gii/blob/master/docs/guide/README.md) -* **TBD** [Генератор документации API](https://github.com/yiisoft/yii2-apidoc) +* [Генератор документации API](https://github.com/yiisoft/yii2-apidoc) Тестирование @@ -180,14 +180,14 @@ All Rights Reserved. Виджеты ------- -* GridView: link to demo page -* ListView: link to demo page -* DetailView: link to demo page -* ActiveForm: link to demo page -* Pjax: link to demo page -* Menu: link to demo page -* LinkPager: link to demo page -* LinkSorter: link to demo page +* [GridView](http://www.yiiframework.com/doc-2.0/yii-grid-gridview.html) +* [ListView](http://www.yiiframework.com/doc-2.0/yii-widgets-listview.html) +* [DetailView](http://www.yiiframework.com/doc-2.0/yii-widgets-detailview.html) +* [ActiveForm](http://www.yiiframework.com/doc-2.0/guide-input-forms.html#activerecord-based-forms-activeform) +* [Pjax](http://www.yiiframework.com/doc-2.0/yii-widgets-pjax.html) +* [Menu](http://www.yiiframework.com/doc-2.0/yii-widgets-menu.html) +* [LinkPager](http://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html) +* [LinkSorter](http://www.yiiframework.com/doc-2.0/yii-widgets-linksorter.html) * [Виджеты Bootstrap](https://github.com/yiisoft/yii2-bootstrap/blob/master/docs/guide/README.md) * [Виджеты Jquery UI](https://github.com/yiisoft/yii2-jui/blob/master/docs/guide/README.md) diff --git a/docs/guide-ru/db-migrations.md b/docs/guide-ru/db-migrations.md index f6c9941888..beef024cc1 100644 --- a/docs/guide-ru/db-migrations.md +++ b/docs/guide-ru/db-migrations.md @@ -783,6 +783,66 @@ return [ С приведённой выше конфигурацией, каждый раз при запуске команды миграции, таблица `backend_migration` будет использована для записи истории миграций. И Вам больше не нужно указывать её через параметр `migrationTable` в командной строке. +### Отдельностоящие Миграции + +Иногда может понадобится использовать миграции из другого пространства имён. Это может быть полезно для при использовании +расширений или модулей в вашем проекте. Одним таких примером могут быть миграции для [компонента RBAC](security-authorization.md#configuring-rbac). +Начиная с версии 2.0.10, есть возможность использовать свойство [[yii\console\controllers\MigrateController::migrationNamespaces|migrationNamespaces]] +для указания пространств имён с миграциями: + +```php +return [ + 'controllerMap' => [ + 'migrate' => [ + 'class' => 'yii\console\controllers\MigrateController', + 'migrationNamespaces' => [ + 'app\migrations', // Общие миграции приложения + 'module\migrations', // Миграции одного из модулей проекта +                'yii\rbac\migrations', // Миграции одного из расширений + ], + ], + ], +]; +``` + +Если необходимо, чтобы миграции из разных пространств имён были независимы друг от друга, вы можете сконфигурировать +несколько команд миграции, которые будут использовать разные пространства имён и разные таблицы для хранения истории +миграций: + +```php +return [ + 'controllerMap' => [ + // Общие миграции приложения + 'migrate-app' => [ + 'class' => 'yii\console\controllers\MigrateController', + 'migrationNamespaces' => ['app\migrations'], + 'migrationTable' => 'migration_app', + ], + // Миграции одного из модулей проекта + 'migrate-module' => [ + 'class' => 'yii\console\controllers\MigrateController', + 'migrationNamespaces' => ['module\migrations'], + 'migrationTable' => 'migration_module', + ], + // Миграции одного из расширений + 'migrate-rbac' => [ + 'class' => 'yii\console\controllers\MigrateController', +            'migrationNamespaces' => ['yii\rbac\migrations'], + 'migrationTable' => 'migration_rbac', + ], + ], +]; +``` + +Учтите, что для синхронизации базы данных при такой конфигурации потребуется вызвать несколько команд вместо одной: + +``` +yii migrate-app +yii migrate-module +yii migrate-rbac +``` + + ## Миграции в Несколько Баз Данных По умолчанию, миграции применяются для базы данных, указанной в `db` [компоненте приложения](structure-application-components.md). @@ -826,3 +886,4 @@ yii migrate --migrationPath=@app/migrations/db2 --db=db2 ``` Первая команда применит миграции в директории `@app/migrations/db1` к базе данных `db1`, а вторая команда применит миграции в директории `@app/migrations/db2` к базе данных `db2` и так далее. + diff --git a/docs/guide-ru/output-formatting.md b/docs/guide-ru/output-formatting.md index f1024c09be..4afb759acb 100644 --- a/docs/guide-ru/output-formatting.md +++ b/docs/guide-ru/output-formatting.md @@ -17,7 +17,7 @@ Formatter может быть использован двумя различны echo Yii::$app->formatter->asEmail('cebe@example.com'); // выведет: cebe@example.com echo Yii::$app->formatter->asBoolean(true); // выведет: Yes // он также умеет отображать null значения: - echo Yii::$app->formatter->asDate(null); // выведет: (Not set) + echo Yii::$app->formatter->asDate(null); // выведет: (not set) ``` 2. Используя метод [[yii\i18n\Formatter::format()|format()]] и имя формата. diff --git a/docs/guide-ru/start-installation.md b/docs/guide-ru/start-installation.md index 0147746e04..236149042e 100644 --- a/docs/guide-ru/start-installation.md +++ b/docs/guide-ru/start-installation.md @@ -1,4 +1,4 @@ -Установка Yii +Установка Yii ============== Вы можете установить Yii двумя способами: используя [Composer](https://getcomposer.org/) или скачав архив. diff --git a/docs/guide-ru/tutorial-console.md b/docs/guide-ru/tutorial-console.md index cea69deb60..23ef7b241f 100644 --- a/docs/guide-ru/tutorial-console.md +++ b/docs/guide-ru/tutorial-console.md @@ -107,6 +107,55 @@ exit($exitCode); > yii --appconfig=path/to/config.php ... > ``` +Автодополнение консольных команд +--------------- + +Автодополнение аргументов команд является полезной возможностью при работе в командной строке. +Начиная с версии 2.0.11, команда `./yii` поддерживает автодополнение для Bash и ZSH. + +### Автодополнение для Bash + +Убедитесь, что средства автодополнения для Bash установлены. В большинстве дистрибутивов они поставляются по умолчанию. + +Сохраните скрипт для автодополнения в директорию `/etc/bash_completion.d/`: + + curl -L https://raw.githubusercontent.com/yiisoft/yii2/master/contrib/completion/bash/yii -o /etc/bash_completion.d/yii + +Для временного использования, вы можете сохранить файл в произвольную директорию и подключить его на время работы сессии, +вызвав команду `source yii`. + +Если скрипт был установлен глобально, вам потребуется перезапустить терминал или выполнить команду `source ~/.bashrc` +для активации автодополнения. + +Обратитесь к [инструкции по автодополнению в Bash](https://www.gnu.org/software/bash/manual/html_node/Programmable-Completion.html) +чтобы узнать о других способах подключения скриптов автодополнения в ваше окружение. + +### Автодополнение для ZSH + +Сохраните скрипт автодополнения в директорию для скриптов автодополнения. Например, `~/.zsh/completion/` + +``` +mkdir -p ~/.zsh/completion +curl -L https://raw.githubusercontent.com/yiisoft/yii2/master/contrib/completion/zsh/_yii -o ~/.zsh/completion/_yii +``` + +Добавьте эту директорию в переменную среды `$fpath`, например добавив в конец `~/.zshrc` следующую строку: + +``` +fpath=(~/.zsh/completion $fpath) +``` + +Убедитесь, что программа `compinit` запущена. Если это не так - добавьте в `~/.zshrc` следующие строки: + +``` +autoload -Uz compinit && compinit -i +``` + +Затем перезапустите ваш терминал, либо выполните команду + +``` +exec $SHELL -l +``` Создание ваших собственных команд ---------------------------------- diff --git a/docs/guide/tutorial-console.md b/docs/guide/tutorial-console.md index 0f2bf86e6b..ffc5861d8c 100644 --- a/docs/guide/tutorial-console.md +++ b/docs/guide/tutorial-console.md @@ -111,7 +111,7 @@ Console command completion --------------- Auto-completion of command arguments is a useful thing when working with the shell. -Since version 2.0.11, the `./yii` command provides auto completion for the bash out of the box. +Since version 2.0.11, the `./yii` command provides auto completion for the Bash and ZSH out of the box. ### Bash completion