PHP: Composer, PSR та інструменти
20 питань · ~20 хв · Версія v3.0
Увійдіть, щоб продовжити
Обмеження версій і lock-файл, автозавантаження й оптимізація, скрипти й локальні пакети, стандарти PSR, PHPStan, Rector і Pint - питання всіх рівнів, від junior до lead.
- За спробу
- 20
- У пулі
- 42
- Проходжень
- 1
- Середній бал
- 90%
- Пройшли на 70%+
- 100%
Питання для підготовки
14 питаньcomposer installставить рівно ті версії, що записані вcomposer.lock. Нічого не оновлює.composer updateшукає найновіші версії, дозволені обмеженнями зcomposer.json, ставить їх і переписуєcomposer.lock.
Звідси правило:
- На проді, в CI і після
git pull- лишеinstall. Так у всіх однакові версії, і те, що перевірили тести, саме те, що поїде на сервер. update- свідома дія розробника, щоб оновити залежності. Після неї ганяють тести і комітять новийcomposer.lock.
composer install --no-dev --optimize-autoloader # прод
composer update laravel/framework --with-dependencies # оновити один пакет
Пастка: composer update без аргументів оновлює все одразу. Якщо після нього щось зламалося, важко зрозуміти, який пакет винен. Краще оновлювати пакети поштучно чи невеликими групами.
Якщо composer.lock немає, install поводиться як update і створює його.
composer.json описує дозволені версії (^11.0 - будь-яка 11.x). composer.lock фіксує точні версії всіх пакетів, разом із залежностями залежностей, і хеші їхнього вмісту.
Для застосунку - комітити обов'язково. Інакше кожен composer install у колеги, в CI чи на сервері поставить «найновіше, що підходить», і версії поступово розійдуться. Баг «у мене працює» часто саме звідси.
Для бібліотеки (пакета, який ставлять інші) lock-файл зазвичай не комітять або він ні на що не впливає: застосунок, який ставить бібліотеку, однаково розв'язує версії сам, за своїм lock-файлом.
Що ще дає lock-файл:
composer installшвидший, бо не треба розв'язувати залежності.composer auditперевіряє на відомі вразливості саме встановлені версії.- Diff
composer.lockу pull request показує, що реально оновилося.
Конфлікти в lock-файлі при злитті гілок не правлять руками: беруть версію однієї гілки й заново виконують ту composer require чи update, яка була в іншій.
Докладніше в документації: composer.lock у системі контролю версій
PSR-4 зіставляє префікс простору імен з каталогом. Решта імені класу перетворюється на шлях до файлу:
"autoload": {
"psr-4": {
"App\\": "app/"
}
}
App\Services\Billing\Invoice → app/Services/Billing/Invoice.php.
Як це працює: vendor/autoload.php реєструє функцію через spl_autoload_register(). Коли код уперше звертається до невідомого класу, PHP викликає її, вона обчислює шлях і робить require. Класи, які не знадобилися в запиті, не завантажуються взагалі.
Що треба знати:
- Регістр важливий: на Linux
invoice.phpдля класуInvoiceне знайдеться, хоча на macOS усе працюватиме. Класична причина «на проді клас не знайдено». - Один клас - один файл, ім'я файлу збігається з ім'ям класу.
- Після зміни секції
autoloadуcomposer.jsonпотрібенcomposer dump-autoload. Нові класи в уже налаштованому каталозі підхоплюються без нього. - Для файлів з функціями (не класами) є секція
"files"- вони підключаються на кожному запиті.
Усі чотири конструкції підключають і виконують інший PHP-файл. Різниця - у реакції на відсутній файл і в повторному підключенні:
require- файлу немає: фатальна помилка, виконання зупиняється.include- файлу немає: попередження, виконання продовжується.require_once/include_once- якщо файл уже підключали, повторно не підключають.
require __DIR__ . '/vendor/autoload.php'; // без нього застосунок не має сенсу
include __DIR__ . '/partials/banner.php'; // банер необов'язковий
Коли що:
require- для того, без чого код не може працювати: автозавантажувач, конфігурація.*_once- для файлів з оголошеннями функцій і класів: повторне оголошення - фатальна помилка.include- для справді необов'язкових фрагментів. На практиці рідко: краще явно перевіритиfile_exists.
Що варто знати:
- Підключений файл бачить змінні з області видимості, де стоїть
include, і може повернути значення:$config = require 'config.php';- так влаштовані конфіг-файли Laravel. - Відносні шляхи розв'язуються відносно
include_pathі поточного робочого каталогу, а не файлу, що підключає. Тому завжди__DIR__ . '/...'. - Шлях від користувача в
include- вразливість (Local/Remote File Inclusion):include $_GET['page'] . '.php'.
У сучасному коді ручні require майже зникли: класи завантажує автозавантажувач Composer (PSR-4), а require лишається в точці входу (public/index.php) і для файлів, що повертають масиви.
Обидва дозволяють оновлення, які за семантичним версіонуванням не мають ламати сумісність:
^1.2.3- від 1.2.3 до (не включно) 2.0.0. Дозволені всі мінорні й патч-оновлення.~1.2.3- від 1.2.3 до (не включно) 1.3.0. Дозволені лише патчі.~1.2- від 1.2 до 2.0. Остання вказана цифра може рости.
Нюанс з нулем: для версій 0.x мінорна версія вважається ламкою. ^0.3.1 - це від 0.3.1 до 0.4.0, а не до 1.0.
Що обирати:
^- стандарт для більшості залежностей. Саме його пишеcomposer require.- Точна версія (
1.2.3) - лише коли пакет відомий тим, що ламає сумісність у мінорних версіях, і оновлювати його хочеться тільки вручну. *чиdev-masterу застосунку - ні: сьогоднішнійcomposer updateможе принести будь-що.
Важливо: обмеження в composer.json визначають, що дозволено. Що встановлено - записано в composer.lock, і на сервер їде саме воно.
Прочитати - ще не значить знати
20 питань, по одному на екран, ~20 хв. Після завершення - розбір кожної помилки з посиланням на питання.