Zespół Laravel pracował nad narzędziem do automatycznego generowania bloków dokumentów na Fasadach we frameworku Laravel.
— Taylor Otwell 🪐 (@taylorotwell) 5 stycznia 2023 r.@timacdonald87 ma zautomatyzowane generowanie bloków dokumentów na fasadach.
Docblocks Facade są teraz automatycznie aktualizowane, gdy nowe metody są dodawane do ich bazowych celów lub gdy metody się zmieniają.
Pomaga to IDE zapewnić dokładniejsze i bardziej aktualne wrażenia podczas korzystania z fasad. ❤️
Dla społeczności Laravel oznacza to ulepszoną obsługę IDE dla Fasad, zapewniającą dokładniejsze uzupełnianie kodu:
Oto kolejny przykład z fasady Storage — został zaktualizowany wraz z FilesystemAdapter i FilesystemManager w Żądanie ściągnięcia nr 45517:
Jeśli zaktualizujesz Laravel 9 do najnowszej wersji, powinieneś zobaczyć ulepszenia w większości Fasad (wiele zostało zaktualizowanych w Żądanie ściągnięcia #45504), takie jak App, Cache, DB, Date, File, Http, Request i Vite, by wymienić tylko kilka.
Proces rozpoczął się w grudniu ubiegłego roku od tzw pierwsze żądanie ściągnięcia wprowadzenie tego narzędzia z ulepszeniami w stosunku do kolejnych wydań w celu udoskonalenia skryptu. Fasady można generować i aktualizować, uruchamiając następujące czynności:
php -f bin/facades.php
To narzędzie zostało zbudowane dla Fasady, które są dostarczane z frameworkiem Laravel. Jeśli śledzisz cotygodniowe wydania frameworka, być może widziałeś pull requesty w celu dodania Facade Docblocks dla określonych metod lub grup metod, które programiści mogą uznać za wymagające dodania. Teraz mogą być aktualizowane w większości automatycznie (z ludzkim okiem na poprawność) dzięki temu skryptowi!
Okrzyk do Tima MacDonalda oraz tym, którzy pomogli przejrzeć wygenerowane Docblocki, aby było to możliwe!