From 4bbe5dced4bea43f1a7d1427e0a04dd753e523ac Mon Sep 17 00:00:00 2001 From: Oleksii Lysenko Date: Tue, 20 Nov 2018 00:40:56 +0530 Subject: Add Russian translation of Composer --- ru-ru/php-composer-ru.html.markdown | 195 ++++++++++++++++++++++++++++++++++++ 1 file changed, 195 insertions(+) create mode 100644 ru-ru/php-composer-ru.html.markdown (limited to 'ru-ru/php-composer-ru.html.markdown') diff --git a/ru-ru/php-composer-ru.html.markdown b/ru-ru/php-composer-ru.html.markdown new file mode 100644 index 00000000..6c97eacd --- /dev/null +++ b/ru-ru/php-composer-ru.html.markdown @@ -0,0 +1,195 @@ +--- +category: tool +tool: composer +contributors: + - ["Alesey Lysenko", "https://github.com/nasgul"] +filename: LearnComposer.sh +lang: ru-ru +--- + +[Composer](https://getcomposer.org/) это инструмент управления зависимостями в PHP. +Он позволяет вам декларировать библиотеки, от которых зависит ваш проект, +и он будет управлять (устанавливать / обновлять) их для вас. + +# Установка + +```sh +# Устанавливаем composer.phar в текущую папку +curl -sS https://getcomposer.org/installer | php +# Если вы используете этот подход, вам нужно будет вызвать композер следующим образом: +php composer.phar about + +# Устанавливаем с бинарников ~/bin/composer +# Примечание: убедитесь, что ~/bin находится в переменной PATH вашего окружения +curl -sS https://getcomposer.org/installer | php -- --install-dir=~/bin --filename=composer +``` + +Пользователи Windows должны следовать +[Инструкциям по установке в Windows ](https://getcomposer.org/doc/00-intro.md#installation-windows) + +## Подтверждение установки + +```sh +# # Проверить версию и параметры списка +composer + +# Получить дополнительную помощь для параметров +composer help require + +# Проверьте, способен ли Composer делать то, что ему нужно, и если он обновлен + композитор диагностирует +composer diagnose +composer diag # shorthand + +# Обновление Composer к последней версии +composer self-update +composer self # shorthand +``` + +# Использование + +Композитор сохраняет ваши зависимости проекта в `composer.json`. +Вы можете отредактировать этот файл, но лучше всего позволить Composer управлять им для вас. +```sh +# Создать новый проект в текущей папке +composer init +# запускается интерактивная анкета с просьбой предоставить подробную информацию о вашем проекте. +# Оставляя их пустым, все прекрасно, если вы не делаете другие проекты зависимыми от этого. + +# Если файл composer.json уже существует, загрузите зависимости +composer install + +# Чтобы загрузить только производственные зависимости, т. Е. Исключая зависимости разработки +composer install --no-dev + +# Добавить зависимость от этого проекта +composer require guzzlehttp/guzzle +# выяснит, какая последняя версия guzzlehttp / guzzle есть, +# загрузите ее и добавьте новую зависимость в поле require.console. + +composer require guzzlehttp/guzzle:6.0.* +# будет загружать последнюю версию, соответствующую шаблону (например, 6.0.2), +# и добавить зависимость к полю require.json + +composer require --dev phpunit/phpunit:~4.5.0 +# потребуется как зависимость от разработки. +# Будет использовать последнюю версию> = 4.5.0 и <4.6.0 + +composer require-dev phpunit/phpunit:^4.5.0 +# потребуется как зависимость от разработки. Будет использовать последнюю версию> = 4.5.0 и <5.0 + +# Для получения дополнительной информации о совместимости версий Composer см. +# [Документация композитора по версиям] (https://getcomposer.org/doc/articles/versions.md) +# для получения более подробной информации + +# Чтобы узнать, какие пакеты доступны для установки и в настоящее время установлены +composer show + +# Чтобы узнать, какие пакеты в настоящее время установлены +composer show --installed + +# Чтобы найти пакет с «mailgun» в его названии или описании +composer search mailgun +``` + +[Packagist.org](https://packagist.org/) является основным хранилищем для пакетов Composer. +Поиск там для существующих сторонних пакетов. +## `composer.json` vs `composer.lock` + +Файл `composer.json` хранит ваши параметры плавающей версии вашего проекта для каждой зависимости, +а также другую информацию. + + +Файл `composer.lock` хранит точно, какую версию он загрузил для каждой зависимости. +Никогда не редактируйте этот файл. + +Если вы включите файл `composer.lock` в свой репозиторий git, +каждый разработчик установит текущую версию зависимостей. +Даже когда выпущена новая версия зависимости, Composer продолжит загрузку версии, +записанной в файле блокировки. + +```sh +# Если вы хотите обновить все зависимости до их новейшей версии, +# которые по-прежнему соответствуют вашим предпочтениям в версии обновление композитора +composer update + +# Если вам нужна новая версия определенной зависимости: +composer update phpunit/phpunit + +# Если вы хотите перенести пакет на более новую версию, +# вам может потребоваться сначала удалить старый пакет и его зависимости. +composer remove --dev phpunit/phpunit +composer require --dev phpunit/phpunit:^5.0 + +``` + +## Автозагрузчик + +Composer создает класс автозагрузки, который вы можете потребовать от своего приложения. +Вы можете создавать экземпляры классов через их пространство имен. + +```php +require __DIR__ . '/vendor/autoload.php'; + +$mailgun = new Mailgun\Mailgun("key"); +``` + +### PSR-4 Autoloader + +### Автозагрузчик PSR-4 + +Вы можете добавить свои собственные пространства имен в автозагрузчик. + +Вы можете добавить свои собственные пространства имен в автозагрузчик. + +В `composer.json` добавьте поле 'autoload': + +```json +{ + "autoload": { + "psr-4": {"Acme\\": "src/"} + } +} +``` +Это скажет автозагрузчику искать что-либо в пространстве имен `\ Acme \` в папке `src`. + +Вы также можете использовать +[PSR-0, Classmap или просто список файлов для включения] (https://getcomposer.org/doc/04-schema.md#autoload). +Также существует поле `autoload-dev` для пространств имен, предназначенных только для разработки. + +При добавлении или изменении ключа автозагрузки вам необходимо перестроить автозагрузчик: + +```sh +composer dump-autoload +composer dump # shorthand + +# Оптимизирует пакеты PSR0 и PSR4 для загрузки классов. +# Медленно запускается, но улучшает производительность при производстве. +composer dump-autoload --optimize --no-dev +``` + +# Composer Кэш + +```sh +# Composer сохранит загруженные пакеты для использования в будущем. Очистите его с помощью: +composer clear-cache +``` + +# Поиск проблемы + +```sh +composer diagnose +composer self-update +composer clear-cache +``` + +## Темы, которые пока (пока) не включены в этот учебник + +* Создание и распространение ваших собственных пакетов на Packagist.org или в другом месте +* Предварительные и пост-скриптовые перехватчики: запуск задач, +когда происходят определенные события композитора + +### Рекомендации + +* [Composer - Dependency Manager for PHP](https://getcomposer.org/) +* [Packagist.org](https://packagist.org/) -- cgit v1.2.3 From e1daa5e5e405f57476eadf96236d6243e575d5ce Mon Sep 17 00:00:00 2001 From: Divay Prakash Date: Tue, 20 Nov 2018 00:46:00 +0530 Subject: Remove trailing spaces --- ru-ru/php-composer-ru.html.markdown | 46 ++++++++++++++++++------------------- 1 file changed, 23 insertions(+), 23 deletions(-) (limited to 'ru-ru/php-composer-ru.html.markdown') diff --git a/ru-ru/php-composer-ru.html.markdown b/ru-ru/php-composer-ru.html.markdown index 6c97eacd..e582a1d5 100644 --- a/ru-ru/php-composer-ru.html.markdown +++ b/ru-ru/php-composer-ru.html.markdown @@ -7,8 +7,8 @@ filename: LearnComposer.sh lang: ru-ru --- -[Composer](https://getcomposer.org/) это инструмент управления зависимостями в PHP. -Он позволяет вам декларировать библиотеки, от которых зависит ваш проект, +[Composer](https://getcomposer.org/) это инструмент управления зависимостями в PHP. +Он позволяет вам декларировать библиотеки, от которых зависит ваш проект, и он будет управлять (устанавливать / обновлять) их для вас. # Установка @@ -24,7 +24,7 @@ php composer.phar about curl -sS https://getcomposer.org/installer | php -- --install-dir=~/bin --filename=composer ``` -Пользователи Windows должны следовать +Пользователи Windows должны следовать [Инструкциям по установке в Windows ](https://getcomposer.org/doc/00-intro.md#installation-windows) ## Подтверждение установки @@ -48,12 +48,12 @@ composer self # shorthand # Использование -Композитор сохраняет ваши зависимости проекта в `composer.json`. +Композитор сохраняет ваши зависимости проекта в `composer.json`. Вы можете отредактировать этот файл, но лучше всего позволить Composer управлять им для вас. ```sh # Создать новый проект в текущей папке composer init -# запускается интерактивная анкета с просьбой предоставить подробную информацию о вашем проекте. +# запускается интерактивная анкета с просьбой предоставить подробную информацию о вашем проекте. # Оставляя их пустым, все прекрасно, если вы не делаете другие проекты зависимыми от этого. # Если файл composer.json уже существует, загрузите зависимости @@ -64,22 +64,22 @@ composer install --no-dev # Добавить зависимость от этого проекта composer require guzzlehttp/guzzle -# выяснит, какая последняя версия guzzlehttp / guzzle есть, +# выяснит, какая последняя версия guzzlehttp / guzzle есть, # загрузите ее и добавьте новую зависимость в поле require.console. composer require guzzlehttp/guzzle:6.0.* -# будет загружать последнюю версию, соответствующую шаблону (например, 6.0.2), +# будет загружать последнюю версию, соответствующую шаблону (например, 6.0.2), # и добавить зависимость к полю require.json composer require --dev phpunit/phpunit:~4.5.0 -# потребуется как зависимость от разработки. +# потребуется как зависимость от разработки. # Будет использовать последнюю версию> = 4.5.0 и <4.6.0 composer require-dev phpunit/phpunit:^4.5.0 # потребуется как зависимость от разработки. Будет использовать последнюю версию> = 4.5.0 и <5.0 -# Для получения дополнительной информации о совместимости версий Composer см. -# [Документация композитора по версиям] (https://getcomposer.org/doc/articles/versions.md) +# Для получения дополнительной информации о совместимости версий Composer см. +# [Документация композитора по версиям] (https://getcomposer.org/doc/articles/versions.md) # для получения более подробной информации # Чтобы узнать, какие пакеты доступны для установки и в настоящее время установлены @@ -92,31 +92,31 @@ composer show --installed composer search mailgun ``` -[Packagist.org](https://packagist.org/) является основным хранилищем для пакетов Composer. +[Packagist.org](https://packagist.org/) является основным хранилищем для пакетов Composer. Поиск там для существующих сторонних пакетов. ## `composer.json` vs `composer.lock` -Файл `composer.json` хранит ваши параметры плавающей версии вашего проекта для каждой зависимости, +Файл `composer.json` хранит ваши параметры плавающей версии вашего проекта для каждой зависимости, а также другую информацию. -Файл `composer.lock` хранит точно, какую версию он загрузил для каждой зависимости. +Файл `composer.lock` хранит точно, какую версию он загрузил для каждой зависимости. Никогда не редактируйте этот файл. -Если вы включите файл `composer.lock` в свой репозиторий git, -каждый разработчик установит текущую версию зависимостей. -Даже когда выпущена новая версия зависимости, Composer продолжит загрузку версии, +Если вы включите файл `composer.lock` в свой репозиторий git, +каждый разработчик установит текущую версию зависимостей. +Даже когда выпущена новая версия зависимости, Composer продолжит загрузку версии, записанной в файле блокировки. ```sh -# Если вы хотите обновить все зависимости до их новейшей версии, +# Если вы хотите обновить все зависимости до их новейшей версии, # которые по-прежнему соответствуют вашим предпочтениям в версии обновление композитора composer update # Если вам нужна новая версия определенной зависимости: composer update phpunit/phpunit -# Если вы хотите перенести пакет на более новую версию, +# Если вы хотите перенести пакет на более новую версию, # вам может потребоваться сначала удалить старый пакет и его зависимости. composer remove --dev phpunit/phpunit composer require --dev phpunit/phpunit:^5.0 @@ -125,7 +125,7 @@ composer require --dev phpunit/phpunit:^5.0 ## Автозагрузчик -Composer создает класс автозагрузки, который вы можете потребовать от своего приложения. +Composer создает класс автозагрузки, который вы можете потребовать от своего приложения. Вы можете создавать экземпляры классов через их пространство имен. ```php @@ -153,8 +153,8 @@ $mailgun = new Mailgun\Mailgun("key"); ``` Это скажет автозагрузчику искать что-либо в пространстве имен `\ Acme \` в папке `src`. -Вы также можете использовать -[PSR-0, Classmap или просто список файлов для включения] (https://getcomposer.org/doc/04-schema.md#autoload). +Вы также можете использовать +[PSR-0, Classmap или просто список файлов для включения] (https://getcomposer.org/doc/04-schema.md#autoload). Также существует поле `autoload-dev` для пространств имен, предназначенных только для разработки. При добавлении или изменении ключа автозагрузки вам необходимо перестроить автозагрузчик: @@ -163,7 +163,7 @@ $mailgun = new Mailgun\Mailgun("key"); composer dump-autoload composer dump # shorthand -# Оптимизирует пакеты PSR0 и PSR4 для загрузки классов. +# Оптимизирует пакеты PSR0 и PSR4 для загрузки классов. # Медленно запускается, но улучшает производительность при производстве. composer dump-autoload --optimize --no-dev ``` @@ -186,7 +186,7 @@ composer clear-cache ## Темы, которые пока (пока) не включены в этот учебник * Создание и распространение ваших собственных пакетов на Packagist.org или в другом месте -* Предварительные и пост-скриптовые перехватчики: запуск задач, +* Предварительные и пост-скриптовые перехватчики: запуск задач, когда происходят определенные события композитора ### Рекомендации -- cgit v1.2.3 From 69489ac4f013a6c718cf291c07a06ed9d8aaba95 Mon Sep 17 00:00:00 2001 From: Divay Prakash Date: Tue, 20 Nov 2018 00:47:42 +0530 Subject: Various fixes --- ru-ru/php-composer-ru.html.markdown | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) (limited to 'ru-ru/php-composer-ru.html.markdown') diff --git a/ru-ru/php-composer-ru.html.markdown b/ru-ru/php-composer-ru.html.markdown index e582a1d5..a4277087 100644 --- a/ru-ru/php-composer-ru.html.markdown +++ b/ru-ru/php-composer-ru.html.markdown @@ -37,7 +37,7 @@ composer composer help require # Проверьте, способен ли Composer делать то, что ему нужно, и если он обновлен - композитор диагностирует +композитор диагностирует composer diagnose composer diag # shorthand @@ -50,6 +50,7 @@ composer self # shorthand Композитор сохраняет ваши зависимости проекта в `composer.json`. Вы можете отредактировать этот файл, но лучше всего позволить Composer управлять им для вас. + ```sh # Создать новый проект в текущей папке composer init @@ -94,6 +95,7 @@ composer search mailgun [Packagist.org](https://packagist.org/) является основным хранилищем для пакетов Composer. Поиск там для существующих сторонних пакетов. + ## `composer.json` vs `composer.lock` Файл `composer.json` хранит ваши параметры плавающей версии вашего проекта для каждой зависимости, @@ -120,7 +122,6 @@ composer update phpunit/phpunit # вам может потребоваться сначала удалить старый пакет и его зависимости. composer remove --dev phpunit/phpunit composer require --dev phpunit/phpunit:^5.0 - ``` ## Автозагрузчик @@ -154,7 +155,7 @@ $mailgun = new Mailgun\Mailgun("key"); Это скажет автозагрузчику искать что-либо в пространстве имен `\ Acme \` в папке `src`. Вы также можете использовать -[PSR-0, Classmap или просто список файлов для включения] (https://getcomposer.org/doc/04-schema.md#autoload). +[PSR-0, Classmap или просто список файлов для включения](https://getcomposer.org/doc/04-schema.md#autoload). Также существует поле `autoload-dev` для пространств имен, предназначенных только для разработки. При добавлении или изменении ключа автозагрузки вам необходимо перестроить автозагрузчик: -- cgit v1.2.3 From cebc11d3095bf4ce188be3fe5f5a25cd41d7d4f0 Mon Sep 17 00:00:00 2001 From: Divay Prakash Date: Tue, 20 Nov 2018 00:50:09 +0530 Subject: Add lang code suffix to filename --- ru-ru/php-composer-ru.html.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'ru-ru/php-composer-ru.html.markdown') diff --git a/ru-ru/php-composer-ru.html.markdown b/ru-ru/php-composer-ru.html.markdown index a4277087..ef6e4912 100644 --- a/ru-ru/php-composer-ru.html.markdown +++ b/ru-ru/php-composer-ru.html.markdown @@ -3,7 +3,7 @@ category: tool tool: composer contributors: - ["Alesey Lysenko", "https://github.com/nasgul"] -filename: LearnComposer.sh +filename: LearnComposer-ru.sh lang: ru-ru --- -- cgit v1.2.3