[php-composer/ru] Update Russian translation for Composer

Fix various translation and spelling errors.
This commit is contained in:
Andre Polykanine 2018-12-07 01:33:28 +02:00
parent 1e7a6f270b
commit 1a6e92f6c0

View File

@ -2,24 +2,26 @@
category: tool category: tool
tool: composer tool: composer
contributors: contributors:
- ["Alesey Lysenko", "https://github.com/nasgul"] - ["Brett Taylor", "https://github.com/glutnix"]
translators:
- ["Aleksey Lysenko", "https://github.com/nasgul"]
filename: LearnComposer-ru.sh filename: LearnComposer-ru.sh
lang: ru-ru lang: ru-ru
--- ---
[Composer](https://getcomposer.org/) это инструмент управления зависимостями в PHP. [Composer](https://getcomposer.org/) это инструмент управления зависимостями в PHP.
Он позволяет вам декларировать библиотеки, от которых зависит ваш проект, Он позволяет вам декларировать библиотеки, от которых зависит ваш проект,
и он будет управлять (устанавливать / обновлять) их для вас. и он будет управлять ими, то есть устанавливать/обновлять их для вас.
# Установка # Установка
```sh ```sh
# Устанавливаем composer.phar в текущую папку # Устанавливаем composer.phar в текущую папку
curl -sS https://getcomposer.org/installer | php curl -sS https://getcomposer.org/installer | php
# Если вы используете этот подход, вам нужно будет вызвать композер следующим образом: # Если вы используете этот подход, вам нужно будет вызвать Composer следующим образом:
php composer.phar about php composer.phar about
# Устанавливаем с бинарников ~/bin/composer # Устанавливаем бинарный файл в ~/bin/composer
# Примечание: убедитесь, что ~/bin находится в переменной PATH вашего окружения # Примечание: убедитесь, что ~/bin находится в переменной PATH вашего окружения
curl -sS https://getcomposer.org/installer | php -- --install-dir=~/bin --filename=composer curl -sS https://getcomposer.org/installer | php -- --install-dir=~/bin --filename=composer
``` ```
@ -30,58 +32,59 @@ curl -sS https://getcomposer.org/installer | php -- --install-dir=~/bin --filena
## Подтверждение установки ## Подтверждение установки
```sh ```sh
# # Проверить версию и параметры списка # # Проверить версию и перечислить параметры
composer composer
# Получить дополнительную помощь для параметров # Получить дополнительную помощь для параметров
composer help require composer help require
# Проверьте, способен ли Composer делать то, что ему нужно, и если он обновлен # Проверить, способен ли Composer делать то, что ему нужно, и обновлён ли он
композитор диагностирует
composer diagnose composer diagnose
composer diag # shorthand composer diag # краткий вариант
# Обновление Composer к последней версии # Обновление Composer до последней версии
composer self-update composer self-update
composer self # shorthand composer self # краткий вариант
``` ```
# Использование # Использование
Композитор сохраняет ваши зависимости проекта в `composer.json`. Composer сохраняет ваши зависимости проекта в `composer.json`.
Вы можете отредактировать этот файл, но лучше всего позволить Composer управлять им для вас. Вы можете отредактировать этот файл, но лучше всего позволить Composer управлять им за вас.
```sh ```sh
# Создать новый проект в текущей папке # Создать новый проект в текущей папке
composer init composer init
# запускается интерактивная анкета с просьбой предоставить подробную информацию о вашем проекте. # запускается интерактивная анкета с просьбой предоставить подробную информацию о вашем проекте.
# Оставляя их пустым, все прекрасно, если вы не делаете другие проекты зависимыми от этого. # Вы прекрасно можете оставить ответы пустыми, если не делаете другие проекты
# зависимыми от создаваемого проекта.
# Если файл composer.json уже существует, загрузите зависимости # Если файл composer.json уже существует, загрузите зависимости
composer install composer install
# Чтобы загрузить только производственные зависимости, т. Е. Исключая зависимости разработки # Чтобы загрузить только зависимости для готового продукта, т.е.
# исключая зависимости для разработки
composer install --no-dev composer install --no-dev
# Добавить зависимость от этого проекта # Добавить зависимость для готового продукта к этому проекту
composer require guzzlehttp/guzzle composer require guzzlehttp/guzzle
# выяснит, какая последняя версия guzzlehttp / guzzle есть, # выяснит, какая существует последняя версия guzzlehttp / guzzle,
# загрузите ее и добавьте новую зависимость в поле require.console. # загрузит её и добавит новую зависимость в поле require файла composer.json.
composer require guzzlehttp/guzzle:6.0.* composer require guzzlehttp/guzzle:6.0.*
# будет загружать последнюю версию, соответствующую шаблону (например, 6.0.2), # Загрузит последнюю версию, соответствующую шаблону (например, 6.0.2),
# и добавить зависимость к полю require.json # и добавит зависимость к полю require файла composer.json
composer require --dev phpunit/phpunit:~4.5.0 composer require --dev phpunit/phpunit:~4.5.0
# потребуется как зависимость от разработки. # Добавит как зависимость для разработки.
# Будет использовать последнюю версию> = 4.5.0 и <4.6.0 # Будет использовать последнюю версию> = 4.5.0 и <4.6.0
composer require-dev phpunit/phpunit:^4.5.0 composer require-dev phpunit/phpunit:^4.5.0
# потребуется как зависимость от разработки. Будет использовать последнюю версию> = 4.5.0 и <5.0 # Добавит как зависимость для разработки.
# Будет использовать последнюю версию> = 4.5.0 и <5.0
# Для получения дополнительной информации о совместимости версий Composer см. # Для получения дополнительной информации о совместимости версий Composer см.
# [Документация композитора по версиям] (https://getcomposer.org/doc/articles/versions.md) # [Документацию Composer по версиям] (https://getcomposer.org/doc/articles/versions.md)
# для получения более подробной информации
# Чтобы узнать, какие пакеты доступны для установки и в настоящее время установлены # Чтобы узнать, какие пакеты доступны для установки и в настоящее время установлены
composer show composer show
@ -89,36 +92,37 @@ composer show
# Чтобы узнать, какие пакеты в настоящее время установлены # Чтобы узнать, какие пакеты в настоящее время установлены
composer show --installed composer show --installed
# Чтобы найти пакет с «mailgun» в его названии или описании # Чтобы найти пакет со строкой «mailgun» в названии или описании
composer search mailgun composer search mailgun
``` ```
[Packagist.org](https://packagist.org/) является основным хранилищем для пакетов Composer. [Packagist.org](https://packagist.org/) является основным хранилищем для пакетов Composer.
Поиск там для существующих сторонних пакетов. Существующие сторонние пакеты ищите там.
## `composer.json` vs `composer.lock` ## composer.json` и `composer.lock`
Файл `composer.json` хранит ваши параметры плавающей версии вашего проекта для каждой зависимости, Файл `composer.json` хранит параметры допустимых версий каждой зависимости
а также другую информацию. вашего проекта, а также другую информацию.
Файл `composer.lock` хранит точно, какую версию он загрузил для каждой зависимости. Файл `composer.lock` хранит точную загруженную версию каждой зависимости.
Никогда не редактируйте этот файл. Никогда не редактируйте этот файл.
Если вы включите файл `composer.lock` в свой репозиторий git, Если вы включите файл `composer.lock` в свой Git-репозиторий,
каждый разработчик установит текущую версию зависимостей. каждый разработчик установит версии зависимостей, которые вы используете.
Даже когда выпущена новая версия зависимости, Composer продолжит загрузку версии, Даже когда будет выпущена новая версия зависимости, Composer продолжит загрузку версии,
записанной в файле блокировки. записанной в lock-файле.
```sh ```sh
# Если вы хотите обновить все зависимости до их новейшей версии, # Если вы хотите обновить все зависимости до новейших версий,
# которые по-прежнему соответствуют вашим предпочтениям в версии обновление композитора # которые по-прежнему соответствуют вашим предпочтениям для версий
composer update composer update
# Если вам нужна новая версия определенной зависимости: # Если вам нужна новая версия определённой зависимости:
composer update phpunit/phpunit composer update phpunit/phpunit
# Если вы хотите перенести пакет на более новую версию, # Если вы хотите перенести пакет на более новую версию
#с изменением предпочитаемой версии,
# вам может потребоваться сначала удалить старый пакет и его зависимости. # вам может потребоваться сначала удалить старый пакет и его зависимости.
composer remove --dev phpunit/phpunit composer remove --dev phpunit/phpunit
composer require --dev phpunit/phpunit:^5.0 composer require --dev phpunit/phpunit:^5.0
@ -126,8 +130,8 @@ composer require --dev phpunit/phpunit:^5.0
## Автозагрузчик ## Автозагрузчик
Composer создает класс автозагрузки, который вы можете потребовать от своего приложения. Composer создаёт класс автозагрузки, который вы можете вызвать
Вы можете создавать экземпляры классов через их пространство имен. из своего приложения. Вы можете создавать экземпляры классов через пространство имён.
```php ```php
require __DIR__ . '/vendor/autoload.php'; require __DIR__ . '/vendor/autoload.php';
@ -135,15 +139,12 @@ require __DIR__ . '/vendor/autoload.php';
$mailgun = new Mailgun\Mailgun("key"); $mailgun = new Mailgun\Mailgun("key");
``` ```
### PSR-4 Autoloader ### PSR-4-совместимый автозагрузчик
### Автозагрузчик PSR-4
Вы можете добавить свои собственные пространства имен в автозагрузчик. Вы можете добавить в автозагрузчик свои собственные пространства имён.
Вы можете добавить свои собственные пространства имен в автозагрузчик. Добавьте поле `autoload` в `composer.json`:
В `composer.json` добавьте поле 'autoload':
```json ```json
{ {
@ -152,31 +153,31 @@ $mailgun = new Mailgun\Mailgun("key");
} }
} }
``` ```
Это скажет автозагрузчику искать что-либо в пространстве имен `\ Acme \` в папке `src`. Это скажет автозагрузчику искать что-либо в пространстве имён `\Acme` в папке `src`.
Вы также можете использовать Вы также можете использовать
[PSR-0, Classmap или просто список файлов для включения](https://getcomposer.org/doc/04-schema.md#autoload). [PSR-0, карту классов или просто список файлов для включения](https://getcomposer.org/doc/04-schema.md#autoload).
Также существует поле `autoload-dev` для пространств имен, предназначенных только для разработки. Также существует поле `autoload-dev` для пространств имён, предназначенных только для разработки.
При добавлении или изменении ключа автозагрузки вам необходимо перестроить автозагрузчик: При добавлении или изменении ключа автозагрузки вам необходимо перестроить автозагрузчик:
```sh ```sh
composer dump-autoload composer dump-autoload
composer dump # shorthand composer dump # краткий вариант
# Оптимизирует пакеты PSR0 и PSR4 для загрузки классов. # Оптимизирует пакеты PSR0 и PSR4 для загрузки классов с помощью карты классов.
# Медленно запускается, но улучшает производительность при производстве. # Медленно запускается, но улучшает производительность готового продукта.
composer dump-autoload --optimize --no-dev composer dump-autoload --optimize --no-dev
``` ```
# Composer Кэш # Кэш Composer
```sh ```sh
# Composer сохранит загруженные пакеты для использования в будущем. Очистите его с помощью: # Composer хранит загруженные пакеты для использования в будущем. Очистите кэш с помощью:
composer clear-cache composer clear-cache
``` ```
# Поиск проблемы # Устранение неполадок
```sh ```sh
composer diagnose composer diagnose
@ -184,13 +185,13 @@ composer self-update
composer clear-cache composer clear-cache
``` ```
## Темы, которые пока (пока) не включены в этот учебник ## Темы, которые ещё (пока) не включены в этот учебник
* Создание и распространение ваших собственных пакетов на Packagist.org или в другом месте * Создание и распространение ваших собственных пакетов на Packagist.org или в другом репозитории
* Предварительные и пост-скриптовые перехватчики: запуск задач, * Предварительные и пост-скриптовые перехватчики: запуск задач,
когда происходят определенные события композитора когда происходят определенные события Composer
### Рекомендации ### Ссылки
* [Composer - Dependency Manager for PHP](https://getcomposer.org/) * [Composer - Dependency Manager for PHP](https://getcomposer.org/)
* [Packagist.org](https://packagist.org/) * [Packagist.org](https://packagist.org/)