mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-03 22:32:40 +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