diff --git a/docs/guide-ru/structure-extensions.md b/docs/guide-ru/structure-extensions.md index 318e2da..b8a9677 100644 --- a/docs/guide-ru/structure-extensions.md +++ b/docs/guide-ru/structure-extensions.md @@ -2,8 +2,8 @@ ========== Расширения - это распространяемые программные пакеты, специально разработанные для использования в приложениях Yii и -содержащие готовые функции. Например, расширение [yiisoft/yii2-debug](tool-debugger.md) добавляет удобную панель -отладки в нижнюю часть каждой страницы вашего приложения, чтобы помочь вам разобраться в том, как генерируются +содержащие готовые функции. Например, расширение [yiisoft/yii2-debug](tool-debugger.md) добавляет удобную отладочную +панель в нижнюю часть каждой страницы вашего приложения, чтобы помочь вам разобраться в том, как генерируются страницы. Вы можете использовать расширения для ускорения процесса разработки. Вы также можете оформить ваш код как расширение, чтобы поделиться с другими людьми результатами вашей работы. @@ -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 @@ -389,7 +389,7 @@ Yii предоставляет следующие базовые расшире� - [yiisoft/yii2-codeception](https://github.com/yiisoft/yii2-codeception): предоставляет поддержку тестирования, основанного на [Codeception](http://codeception.com/). - [yiisoft/yii2-debug](https://github.com/yiisoft/yii2-debug): - предоставляет поддержку отладки в приложениях Yii. Когда это расширение используется, панель отладки появится в + предоставляет поддержку отладки в приложениях Yii. Когда это расширение используется, отладочная панель появится в нижней части каждой страницы. Это расширение также предоставляет набор отдельных страниц для отображения более подробной отладочной информации. - [yiisoft/yii2-elasticsearch](https://github.com/yiisoft/yii2-elasticsearch): @@ -408,10 +408,10 @@ Yii предоставляет следующие базовые расшире� предоставляет набор виджетов, основанный на взаимодействиях и виджетах [JQuery UI](http://jqueryui.com/). - [yiisoft/yii2-mongodb](https://github.com/yiisoft/yii2-mongodb): предоставляет поддержку использования [MongoDB](http://www.mongodb.org/). Оно включает такие возможности, как - базовые запросы, Active Record, миграции, кеширование, генерация кода и т.д. + базовые запросы, Active Record, миграции, кэширование, генерация кода и т.д. - [yiisoft/yii2-redis](https://github.com/yiisoft/yii2-redis): предоставляет поддержку использования [redis](http://redis.io/). Оно включает такие возможности, как базовые запросы, - Active Record, кеширование и т.д. + Active Record, кэширование и т.д. - [yiisoft/yii2-smarty](https://github.com/yiisoft/yii2-smarty): предоставляет шаблонизатор, основанный на [Smarty](http://www.smarty.net/). - [yiisoft/yii2-sphinx](https://github.com/yiisoft/yii2-sphinx):