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