php/yii2
1
0
Fork 0
mirror of https://github.com/yiisoft/yii2.git synced 2025-11-03 13:58:55 +08:00
Code Issues Packages Projects Releases Wiki Activity

fixes for translation of file 'structure-extensions.md' to Russian

Browse Source
This commit is contained in:
maxmirazh33
2014-08-24 22:39:02 +07:00
parent 4890a71928
commit 2249a9eb99
1 changed files with 12 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
docs/guide-ru/structure-extensions.md
View File

@ -13,17 +13,17 @@
## Использование расширений <a name="using-extensions"></a> ## Использование расширений <a name="using-extensions"></a>
Чтобы использовать расширение, вам необходимо установить его. Большинство расширений распространяются как Чтобы использовать расширение, вам необходимо установить его. Большинство расширений распространяются как пакеты
[Composer](https://getcomposer.org/)-пакеты, которые могут быть установлены посредством следующих двух шагов: [Composer](https://getcomposer.org/), которые могут быть установлены посредством следующих двух шагов:
1. Отредактируйте файл вашего приложения `composer.json`, указав, какие расширения (Composer-пакеты) вы хотите 1. Отредактируйте файл вашего приложения `composer.json`, указав, какие расширения (пакеты Composer) вы хотите
установить. установить.
2. Выполните команду `php composer.phar install`, чтобы установить указанные расширения. 2. Выполните команду `php composer.phar install`, чтобы установить указанные расширения.
Обратите внимание, что вам может потребоваться установить [Composer](https://getcomposer.org/), если у вас его нет. Обратите внимание, что вам может потребоваться установить [Composer](https://getcomposer.org/), если у вас его нет.
По умолчанию, Composer устанавливает пакеты, зарегистрированные на [Packagist](https://packagist.org/) - крупнейшем По умолчанию, Composer устанавливает пакеты, зарегистрированные на [Packagist](https://packagist.org/) - крупнейшем
репозитории для Composer-пакетов с открытым исходным кодом. Вы также можете репозитории для пакетов Composer с открытым исходным кодом. Вы также можете
[создать свой репозиторий](https://getcomposer.org/doc/05-repositories.md#repository) и настроить Composer для его [создать свой репозиторий](https://getcomposer.org/doc/05-repositories.md#repository) и настроить Composer для его
использования. Это полезно, если вы разрабатываете закрытые расширения и хотите использовать их в нескольких своих использования. Это полезно, если вы разрабатываете закрытые расширения и хотите использовать их в нескольких своих
проектах. проектах.
@ -51,7 +51,7 @@
> Информация: `yiisoft/yii2-imagine` является базовым расширением, которое разрабатывает и поддерживает команда > Информация: `yiisoft/yii2-imagine` является базовым расширением, которое разрабатывает и поддерживает команда
разработчиков Yii. Все базовые расширения размещены на [Packagist](https://packagist.org/) и называются разработчиков Yii. Все базовые расширения размещены на [Packagist](https://packagist.org/) и называются
`yiisoft/yii2-xyz`, где `xyz` меняется для разных расширений. `yiisoft/yii2-xyz`, где `xyz` является названием расширения.
Теперь вы можете использовать установленное расширение как часть вашего приложения. Следующий пример показывает, как вы Теперь вы можете использовать установленное расширение как часть вашего приложения. Следующий пример показывает, как вы
можете использовать класс `yii\imagine\Image`, который содержится в расширении `yiisoft/yii2-imagine`. можете использовать класс `yii\imagine\Image`, который содержится в расширении `yiisoft/yii2-imagine`.
@ -256,7 +256,7 @@ class MyBootstrapClass implements BootstrapInterface
public function bootstrap($app) public function bootstrap($app)
{ {
$app->on(Application::EVENT_BEFORE_REQUEST, function () { $app->on(Application::EVENT_BEFORE_REQUEST, function () {
// полезный код // остальной код
}); });
} }
} }
@ -282,7 +282,7 @@ class MyBootstrapClass implements BootstrapInterface
#### Работа с базами данных <a name="working-with-databases"></a> #### Работа с базами данных <a name="working-with-databases"></a>
Ваше расширение может иметь доступ к базам данных. Не думайте, что приложения, которые используют ваше расширение, Ваше расширение может иметь доступ к базам данных. Не думайте, что приложения, которые используют ваше расширение,
всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вы должны объявить свойство `db` в классах, всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вам следует объявить свойство `db` в классах,
которым необходим доступ в БД. Это свойство позволит пользователям вашего расширения настроить соединение с БД, которым необходим доступ в БД. Это свойство позволит пользователям вашего расширения настроить соединение с БД,
которое они будут использовать в вашем расширении. В качестве примера вы можете обратиться к классу которое они будут использовать в вашем расширении. В качестве примера вы можете обратиться к классу
[[yii\caching\DbCache]] и посмотреть, как он объявляет и использует свойство `db`. [[yii\caching\DbCache]] и посмотреть, как он объявляет и использует свойство `db`.
@ -298,8 +298,8 @@ class MyBootstrapClass implements BootstrapInterface
Если ваше расширение является виджетом или модулем, то есть вероятность, что оно потребует некоторых Если ваше расширение является виджетом или модулем, то есть вероятность, что оно потребует некоторых
[ресурсов](structure-assets.md) для работы. Например, модуль может отображать некоторые страницы, которые содержат [ресурсов](structure-assets.md) для работы. Например, модуль может отображать некоторые страницы, которые содержат
изображения, JavaScript и CSS. Так как все файлы расширения находятся в одной директории, недоступной из интернета, у изображения, JavaScript и CSS. Так как все файлы расширения находятся в директории, недоступной из интернета, у вас
вас есть два варианта сделать директорию ресурсов непосредственно доступной из интернета: есть два варианта сделать директорию ресурсов непосредственно доступной из интернета:
- попросить пользователей расширения вручную скопировать файлы ресурсов в определённую, доступную из интернета папку; - попросить пользователей расширения вручную скопировать файлы ресурсов в определённую, доступную из интернета папку;
- объявить [связку ресурсов](structure-assets.md) и полагаться на механизм публикации ресурсов, который автоматически - объявить [связку ресурсов](structure-assets.md) и полагаться на механизм публикации ресурсов, который автоматически
@ -313,7 +313,7 @@ class MyBootstrapClass implements BootstrapInterface
Ваше расширение может быть использовано в приложениях, поддерживающих разные языки! Поэтому, если ваше расширение Ваше расширение может быть использовано в приложениях, поддерживающих разные языки! Поэтому, если ваше расширение
отображает содержимое конечному пользователю, вы должны попробовать отображает содержимое конечному пользователю, вы должны попробовать
[интернационализировать и локализовать](tutorial-i18n.md) его. В частности, [интернационализовать и локализовать](tutorial-i18n.md) его. В частности,
- Если расширение отображает сообщения, предназначенные для конечных пользователей, сообщения должны быть обёрнуты в - Если расширение отображает сообщения, предназначенные для конечных пользователей, сообщения должны быть обёрнуты в
метод `Yii::t()` так, чтобы они могли быть переведены. Сообщения, предназначенные для разработчиков (например, метод `Yii::t()` так, чтобы они могли быть переведены. Сообщения, предназначенные для разработчиков (например,
@ -360,7 +360,7 @@ class MyBootstrapClass implements BootstrapInterface
* Файл upgrade в корневой директории пакета: он даёт инструкции о том, как обновить старые версии расширения. Этот * Файл upgrade в корневой директории пакета: он даёт инструкции о том, как обновить старые версии расширения. Этот
файл может быть написан в формате Markdown и назван `upgrade.md`. файл может быть написан в формате Markdown и назван `upgrade.md`.
* Руководства пользователя, демо-версии, скриншоты и т.д.: они необходимы, если ваше расширение предоставляет много * Руководства пользователя, демо-версии, скриншоты и т.д.: они необходимы, если ваше расширение предоставляет много
возможностей, которые нельзя полностью описать в файле readme. возможностей, которые невозможно полностью описать в файле readme.
* Документация API: ваш код должен быть документирован, чтобы позволить другим людям легко читать и понимать его. Вы * Документация API: ваш код должен быть документирован, чтобы позволить другим людям легко читать и понимать его. Вы
можете обратиться к [файлу класса Object](https://github.com/yiisoft/yii2/blob/master/framework/base/Object.php), можете обратиться к [файлу класса Object](https://github.com/yiisoft/yii2/blob/master/framework/base/Object.php),
чтобы узнать, как нужно документировать код. чтобы узнать, как нужно документировать код.
@ -379,7 +379,7 @@ Yii предоставляет следующие базовые расшире
[Использование расширений](#using-extensions). [Использование расширений](#using-extensions).
- [yiisoft/yii2-apidoc](https://github.com/yiisoft/yii2-apidoc): - [yiisoft/yii2-apidoc](https://github.com/yiisoft/yii2-apidoc):
обеспечивает расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации предоставляет расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации
документации API фреймворка. документации API фреймворка.
- [yiisoft/yii2-authclient](https://github.com/yiisoft/yii2-authclient): - [yiisoft/yii2-authclient](https://github.com/yiisoft/yii2-authclient):
предоставляет набор наиболее часто используемых клиентов авторизации, таких, как Facebook OAuth2 клиент и GitHub предоставляет набор наиболее часто используемых клиентов авторизации, таких, как Facebook OAuth2 клиент и GitHub