mirror of
https://github.com/yiisoft/yii2.git
synced 2025-11-02 21:41:19 +08:00
fixes for translation of file 'structure-extensions.md' to Russian
This commit is contained in:
@ -13,17 +13,17 @@
|
||||
|
||||
## Использование расширений <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`, чтобы установить указанные расширения.
|
||||
|
||||
Обратите внимание, что вам может потребоваться установить [Composer](https://getcomposer.org/), если у вас его нет.
|
||||
|
||||
По умолчанию, Composer устанавливает пакеты, зарегистрированные на [Packagist](https://packagist.org/) - крупнейшем
|
||||
репозитории для Composer-пакетов с открытым исходным кодом. Вы также можете
|
||||
репозитории для пакетов Composer с открытым исходным кодом. Вы также можете
|
||||
[создать свой репозиторий](https://getcomposer.org/doc/05-repositories.md#repository) и настроить Composer для его
|
||||
использования. Это полезно, если вы разрабатываете закрытые расширения и хотите использовать их в нескольких своих
|
||||
проектах.
|
||||
@ -51,7 +51,7 @@
|
||||
|
||||
> Информация: `yiisoft/yii2-imagine` является базовым расширением, которое разрабатывает и поддерживает команда
|
||||
разработчиков Yii. Все базовые расширения размещены на [Packagist](https://packagist.org/) и называются
|
||||
`yiisoft/yii2-xyz`, где `xyz` меняется для разных расширений.
|
||||
`yiisoft/yii2-xyz`, где `xyz` является названием расширения.
|
||||
|
||||
Теперь вы можете использовать установленное расширение как часть вашего приложения. Следующий пример показывает, как вы
|
||||
можете использовать класс `yii\imagine\Image`, который содержится в расширении `yiisoft/yii2-imagine`.
|
||||
@ -256,7 +256,7 @@ class MyBootstrapClass implements BootstrapInterface
|
||||
public function bootstrap($app)
|
||||
{
|
||||
$app->on(Application::EVENT_BEFORE_REQUEST, function () {
|
||||
// полезный код
|
||||
// остальной код
|
||||
});
|
||||
}
|
||||
}
|
||||
@ -282,7 +282,7 @@ class MyBootstrapClass implements BootstrapInterface
|
||||
#### Работа с базами данных <a name="working-with-databases"></a>
|
||||
|
||||
Ваше расширение может иметь доступ к базам данных. Не думайте, что приложения, которые используют ваше расширение,
|
||||
всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вы должны объявить свойство `db` в классах,
|
||||
всегда используют `Yii::$db` в качестве соединения с БД. Вместо этого вам следует объявить свойство `db` в классах,
|
||||
которым необходим доступ в БД. Это свойство позволит пользователям вашего расширения настроить соединение с БД,
|
||||
которое они будут использовать в вашем расширении. В качестве примера вы можете обратиться к классу
|
||||
[[yii\caching\DbCache]] и посмотреть, как он объявляет и использует свойство `db`.
|
||||
@ -298,8 +298,8 @@ class MyBootstrapClass implements BootstrapInterface
|
||||
|
||||
Если ваше расширение является виджетом или модулем, то есть вероятность, что оно потребует некоторых
|
||||
[ресурсов](structure-assets.md) для работы. Например, модуль может отображать некоторые страницы, которые содержат
|
||||
изображения, JavaScript и CSS. Так как все файлы расширения находятся в одной директории, недоступной из интернета, у
|
||||
вас есть два варианта сделать директорию ресурсов непосредственно доступной из интернета:
|
||||
изображения, JavaScript и CSS. Так как все файлы расширения находятся в директории, недоступной из интернета, у вас
|
||||
есть два варианта сделать директорию ресурсов непосредственно доступной из интернета:
|
||||
|
||||
- попросить пользователей расширения вручную скопировать файлы ресурсов в определённую, доступную из интернета папку;
|
||||
- объявить [связку ресурсов](structure-assets.md) и полагаться на механизм публикации ресурсов, который автоматически
|
||||
@ -313,7 +313,7 @@ class MyBootstrapClass implements BootstrapInterface
|
||||
|
||||
Ваше расширение может быть использовано в приложениях, поддерживающих разные языки! Поэтому, если ваше расширение
|
||||
отображает содержимое конечному пользователю, вы должны попробовать
|
||||
[интернационализировать и локализовать](tutorial-i18n.md) его. В частности,
|
||||
[интернационализовать и локализовать](tutorial-i18n.md) его. В частности,
|
||||
|
||||
- Если расширение отображает сообщения, предназначенные для конечных пользователей, сообщения должны быть обёрнуты в
|
||||
метод `Yii::t()` так, чтобы они могли быть переведены. Сообщения, предназначенные для разработчиков (например,
|
||||
@ -360,7 +360,7 @@ class MyBootstrapClass implements BootstrapInterface
|
||||
* Файл upgrade в корневой директории пакета: он даёт инструкции о том, как обновить старые версии расширения. Этот
|
||||
файл может быть написан в формате Markdown и назван `upgrade.md`.
|
||||
* Руководства пользователя, демо-версии, скриншоты и т.д.: они необходимы, если ваше расширение предоставляет много
|
||||
возможностей, которые нельзя полностью описать в файле readme.
|
||||
возможностей, которые невозможно полностью описать в файле readme.
|
||||
* Документация API: ваш код должен быть документирован, чтобы позволить другим людям легко читать и понимать его. Вы
|
||||
можете обратиться к [файлу класса Object](https://github.com/yiisoft/yii2/blob/master/framework/base/Object.php),
|
||||
чтобы узнать, как нужно документировать код.
|
||||
@ -379,7 +379,7 @@ Yii предоставляет следующие базовые расшире
|
||||
[Использование расширений](#using-extensions).
|
||||
|
||||
- [yiisoft/yii2-apidoc](https://github.com/yiisoft/yii2-apidoc):
|
||||
обеспечивает расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации
|
||||
предоставляет расширяемый и высокопроизводительный генератор документации API. Оно также используется для генерации
|
||||
документации API фреймворка.
|
||||
- [yiisoft/yii2-authclient](https://github.com/yiisoft/yii2-authclient):
|
||||
предоставляет набор наиболее часто используемых клиентов авторизации, таких, как Facebook OAuth2 клиент и GitHub
|
||||
|
||||
Reference in New Issue
Block a user