mirror of
				https://github.com/yiisoft/yii2.git
				synced 2025-11-04 06:37:55 +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