Команда Laravel працювала над інструментом для автоматичної генерації docblock на Facades у фреймворку Laravel.
— Тейлор Отвелл 🪐 (@taylorotwell) 5 січня 2023 р.@timacdonald87 має автоматизовану генерацію докблоків на фасадах.
Фасадні doc-блоки тепер автоматично оновлюються, коли нові методи додаються до їхніх основних цілей або коли методи змінюються.
Це допомагає IDE надавати точнішу та актуальнішу роботу під час використання фасадів. ❤️
Для спільноти Laravel це означає покращену підтримку IDE для Facades, що забезпечує точніше завершення коду:
Ось ще один приклад із фасаду Storage — його було оновлено разом із FilesystemAdapter і FilesystemManager у Запит на отримання #45517:
Якщо ви оновите Laravel 9 до останньої версії, ви побачите покращення в більшості фасадів (кілька було оновлено в Запит на отримання #45504), як-от App, Cache, DB, Date, File, Http, Request і Vite, щоб назвати декілька.
Процес почався в грудні минулого року з перший запит на отримання Представляємо цей інструмент із покращеннями порівняно з наступними випусками для вдосконалення сценарію. Фасади можна створити та підтримувати в актуальному стані, виконавши наступне:
php -f bin/facades.php
Цей інструмент створено для Facades, які постачаються з фреймворком Laravel. Якщо ви стежите за щотижневими випусками фреймворку, ви могли бачити запити на додавання Facade Docblocks для певних методів або груп методів, які розробники можуть вважати необхідними. Тепер вони здебільшого можуть оновлюватися автоматично (з людським оком для правильності) завдяки цьому сценарію!
Крик до Тім Макдональд і тих, хто допоміг переглянути згенеровані Docblocks, щоб зробити це можливим!