Composer частина 2. Створення власної бібліотеки. Завантаження на Packagist
- 818
- 2
- 17 травня, 2022
- читати 10 хв
Зміст
Ми почали з того, що таке Composer і навіщо він потрібний:
Рекомендуємо публікацію по темі
Тепер ми розберемо покрокове створення міні-проекту мовою PHP та додамо його на сервіс packagist.
Створення проекту
Спершу необхідно створити публічний GIT репозиторій, у моєму випадку це буде github.com.
Ініціалізація composer проекту
Після цього клонуємо репозиторій на комп'ютер і заходимо в директорію проекту, де необхідно створити файл composer.json. Можна створити його вручну, але composer має команду спеціально для цього — composer init.
Прописати цю команду треба докорінно проекту, після чого composer покроково задаватиме вам всі необхідні питання для заповнення даного файлу.
По зображенню вище видно питання, які задає composer під час ініціалізації проекту.
- Package name (<vendor>/<name>) — запитує назву вашого проекту. Також можна використати запропонований варіант від composer
- Description — опис проекту
- Author — дані про автора, зазвичай підтягує дані з репозиторію
- Minimum Stability — визначає стандартну поведінку для фільтрації пакетів за стабільністю. Типове значення stable
- Package Type — визначає тип пакету (вашого проекту). Типово – library
- License — Визначає ліцензію вашого пакета (детальніше тут)
Детальніше про composer.json можна переглянути за посиланням. Після створення файл конфігурації буде виглядати так:
У require можна вписати всі необхідні залежності для вашого проекту.
README файл
Кожен проект повинен мати README.md файл, в якому буде написано інструкцію з встановлення та використання цієї бібліотеки. Приклад заповнення такого файлу можна переглянути на цьому ресурсе.
Packagist
Packagist має сторінку реєстрації, але найлегший спосіб — це авторизація через github, як показано на зображенні нижче.
Реєстрація пакету
Зареєструвати вашу бібліотеку можна за посиланням або просто натиснути на Submit у верхньому меню. Далі вставляєте посилання на ваш репозиторій та натискаєте на кнопку Check.
Якщо перевірка пройшла успішно, ви будете перенаправлені на сторінку вашого створеного пакета. На цій сторінці користувачі зможуть побачити версії вашої бібліотеки, а також прочитати інструкцію щодо її використання, яка підтягується з README.md
Підключення вашої бібліотеки можливе за командою composer require <vendor>/<name>
PS: для зручності краще використовувати версії вашого проекту, таким чином користувачі зможу вибирати собі версію вашої бібліотеки самі:
git tag 1.0.0
git push origin 1.0.0
Почніть вивчати PHP! Курси ведуть лише практикуючі спеціалісти 👇
Рекомендуємо курс по темі
Схожі матеріали
- Laravel vs Symfony
- 61
- 1
Laravel vs Symfony
читати 15 хв-
Денис Розганяєв Software Engineer у Mobilunity
- Породжувальні патерни проєктування
- 279
- 2
Породжувальні патерни проєктування
читати 10 хв-
Денис Розганяєв Software Engineer у Mobilunity
- Чому варто вивчати PHP і куди рухатися після курсів
- 322
- 9
Чому варто вивчати PHP і куди рухатися після курсів
дивитись 93 хв-
Денис Розганяєв Software Engineer у Mobilunity