mirror of
				https://github.com/yiisoft/yii2.git
				synced 2025-11-04 06:37:55 +08:00 
			
		
		
		
	Updated guide
This commit is contained in:
		@ -147,7 +147,7 @@ All Rights Reserved.
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
* [Отладочная панель и отладчик](https://github.com/yiisoft/yii2-debug/blob/master/docs/guide/README.md)
 | 
					* [Отладочная панель и отладчик](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)
 | 
					* [Генерация кода с 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
 | 
					* [GridView](http://www.yiiframework.com/doc-2.0/yii-grid-gridview.html)
 | 
				
			||||||
* ListView: link to demo page
 | 
					* [ListView](http://www.yiiframework.com/doc-2.0/yii-widgets-listview.html)
 | 
				
			||||||
* DetailView: link to demo page
 | 
					* [DetailView](http://www.yiiframework.com/doc-2.0/yii-widgets-detailview.html)
 | 
				
			||||||
* ActiveForm: link to demo page
 | 
					* [ActiveForm](http://www.yiiframework.com/doc-2.0/guide-input-forms.html#activerecord-based-forms-activeform)
 | 
				
			||||||
* Pjax: link to demo page
 | 
					* [Pjax](http://www.yiiframework.com/doc-2.0/yii-widgets-pjax.html)
 | 
				
			||||||
* Menu: link to demo page
 | 
					* [Menu](http://www.yiiframework.com/doc-2.0/yii-widgets-menu.html)
 | 
				
			||||||
* LinkPager: link to demo page
 | 
					* [LinkPager](http://www.yiiframework.com/doc-2.0/yii-widgets-linkpager.html)
 | 
				
			||||||
* LinkSorter: link to demo page
 | 
					* [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)
 | 
					* [Виджеты 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)
 | 
					* [Виджеты Jquery UI](https://github.com/yiisoft/yii2-jui/blob/master/docs/guide/README.md)
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
				
			|||||||
@ -783,6 +783,66 @@ return [
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
С приведённой выше конфигурацией, каждый раз при запуске команды миграции, таблица `backend_migration` будет использована для записи истории миграций. И Вам больше не нужно указывать её через параметр `migrationTable` в командной строке.
 | 
					С приведённой выше конфигурацией, каждый раз при запуске команды миграции, таблица `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>
 | 
					## Миграции в Несколько Баз Данных <span id="migrating-multiple-databases"></span>
 | 
				
			||||||
 | 
					
 | 
				
			||||||
По умолчанию, миграции применяются для базы данных, указанной в `db` [компоненте приложения](structure-application-components.md).
 | 
					По умолчанию, миграции применяются для базы данных, указанной в `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` и так далее.
 | 
					Первая команда применит миграции в директории `@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->asEmail('cebe@example.com'); // выведет: <a href="mailto:cebe@example.com">cebe@example.com</a>
 | 
				
			||||||
   echo Yii::$app->formatter->asBoolean(true); // выведет: Yes
 | 
					   echo Yii::$app->formatter->asBoolean(true); // выведет: Yes
 | 
				
			||||||
   // он также умеет отображать null значения:
 | 
					   // он также умеет отображать null значения:
 | 
				
			||||||
   echo Yii::$app->formatter->asDate(null); // выведет: (Not set)
 | 
					   echo Yii::$app->formatter->asDate(null); // выведет: (not set)
 | 
				
			||||||
   ```
 | 
					   ```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
2. Используя метод [[yii\i18n\Formatter::format()|format()]] и имя формата.
 | 
					2. Используя метод [[yii\i18n\Formatter::format()|format()]] и имя формата.
 | 
				
			||||||
 | 
				
			|||||||
@ -1,4 +1,4 @@
 | 
				
			|||||||
Установка Yii
 | 
					Установка Yii <span id="installing-from-composer"></span>
 | 
				
			||||||
==============
 | 
					==============
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Вы можете установить Yii двумя способами: используя [Composer](https://getcomposer.org/) или скачав архив.
 | 
					Вы можете установить Yii двумя способами: используя [Composer](https://getcomposer.org/) или скачав архив.
 | 
				
			||||||
 | 
				
			|||||||
@ -107,6 +107,55 @@ exit($exitCode);
 | 
				
			|||||||
> yii <route> --appconfig=path/to/config.php ...
 | 
					> 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>
 | 
					Создание ваших собственных команд <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. 
 | 
					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
 | 
					### Bash completion
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
				
			|||||||
		Reference in New Issue
	
	Block a user