mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-01 20:19:42 +08:00
Updated guide
This commit is contained in:
SilverFire - Dmitry Naumenko
@ -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)
|
||||
|
||||
|
||||
@ -783,6 +783,66 @@ return [
|
||||
|
||||
С приведённой выше конфигурацией, каждый раз при запуске команды миграции, таблица `backend_migration` будет использована для записи истории миграций. И Вам больше не нужно указывать её через параметр `migrationTable` в командной строке.
|
||||
|
||||
### Отдельностоящие Миграции <span id="separated-migrations"></span>
|
||||
|
||||
Иногда может понадобится использовать миграции из другого пространства имён. Это может быть полезно для при использовании
|
||||
расширений или модулей в вашем проекте. Одним таких примером могут быть миграции для [компонента 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
|
||||
```
|
||||
|
||||
|
||||
## Миграции в Несколько Баз Данных <span id="migrating-multiple-databases"></span>
|
||||
|
||||
По умолчанию, миграции применяются для базы данных, указанной в `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` и так далее.
|
||||
|
||||
|
||||
@ -17,7 +17,7 @@ Formatter может быть использован двумя различны
|
||||
echo Yii::$app->formatter->asEmail('cebe@example.com'); // выведет: <a href="mailto:cebe@example.com">cebe@example.com</a>
|
||||
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()]] и имя формата.
|
||||
|
||||
@ -1,4 +1,4 @@
|
||||
Установка Yii
|
||||
Установка Yii <span id="installing-from-composer"></span>
|
||||
==============
|
||||
|
||||
Вы можете установить Yii двумя способами: используя [Composer](https://getcomposer.org/) или скачав архив.
|
||||
|
||||
@ -107,6 +107,55 @@ exit($exitCode);
|
||||
> yii <route> --appconfig=path/to/config.php ...
|
||||
> ```
|
||||
|
||||
Автодополнение консольных команд <span id="console-command-completion"></span>
|
||||
---------------
|
||||
|
||||
Автодополнение аргументов команд является полезной возможностью при работе в командной строке.
|
||||
Начиная с версии 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
|
||||
```
|
||||
|
||||
Создание ваших собственных команд <span id="create-command"></span>
|
||||
----------------------------------
|
||||
|
||||
@ -111,7 +111,7 @@ Console command completion <span id="console-command-completion"></span>
|
||||
---------------
|
||||
|
||||
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
|
||||
|
||||
|
||||
Reference in New Issue
Block a user