Je\u015bli chodzi o baz\u0119 kodu, jeste\u015bmy teraz w dobrym miejscu. Zacz\u0119li\u015bmy refaktoryzowa\u0107 wi\u0119kszo\u015b\u0107 kodu do mniejszych, bardziej skoncentrowanych klas. W\u0142a\u015bnie skonfigurowali\u015bmy Rejestr, aby\u015bmy mogli rozpocz\u0105\u0107 prac\u0119 z instancjami obiekt\u00f3w w ca\u0142ej wtyczce bez potrzeby zbytniego \u0142\u0105czenia.<\/p>\n
Ale wci\u0105\u017c istnieje problem, z kt\u00f3rym si\u0119 borykamy i dotyczy on przestrzeni nazw i automatycznego \u0142adowania. M\u00f3wi\u0142em o tym troch\u0119 kilka lat temu<\/a>, ale nie w odniesieniu do Composera.<\/p>\n I w\u0142a\u015bnie temu przyjrzymy si\u0119 w tym po\u015bcie.<\/p>\n W drugim po\u015bcie z tej serii<\/a> zacz\u0119li\u015bmy rozmawia\u0107 o Composerze. Je\u015bli zapytasz wi\u0119kszo\u015b\u0107 programist\u00f3w PHP (w tym tych, kt\u00f3rzy pracuj\u0105 na WordPressie), prawdopodobnie us\u0142yszysz, \u017ce Composer jest mened\u017cerem pakiet\u00f3w lub mened\u017cerem zale\u017cno\u015bci.<\/p>\n Kr\u00f3tko m\u00f3wi\u0105c, jest to dla nas spos\u00f3b na wprowadzenie bibliotek innych firm do naszego projektu, a nast\u0119pnie wykorzystanie ich funkcji (wi\u0119c nie musimy pisa\u0107 w\u0142asnego kodu, aby to zrobi\u0107).<\/p>\n Ale jest jeszcze jedna funkcja oferowana przez Composer, kt\u00f3ra jest niezwykle u\u017cyteczna, zw\u0142aszcza gdy u\u017cywasz wielu klas i nie<\/strong> chcesz u\u017cywa\u0107 instrukcji require_once w ca\u0142ym kodzie.<\/p>\n I to jest autoloader.<\/p>\n Prosto z instrukcji:<\/a><\/p>\n W przypadku bibliotek, kt\u00f3re okre\u015blaj\u0105 informacje o automatycznym \u0142adowaniu, Composer generuje Je\u015bli do tej pory \u015bledzi\u0142e\u015b ten kod, zobaczysz, \u017ce faktycznie u\u017cywamy ju\u017c autoloadera wygenerowanego przez Composer.<\/p>\n Najpierw zdefiniowali\u015bmy niezb\u0119dn\u0105 konfiguracj\u0119<\/a> :<\/p>\n Nast\u0119pnie zacz\u0119li\u015bmy do\u0142\u0105cza\u0107 go do programu startowego wtyczki<\/a> (kt\u00f3ry doko\u0144czymy dzisiaj):<\/p>\n Ale tutaj pojawia si\u0119 problem: jak za\u0142adowa\u0107 tylko te klasy, kt\u00f3rych potrzebujemy do dystrybucji?<\/p>\n Innymi s\u0142owy: istnieje wiele bibliotek, kt\u00f3rych u\u017cywamy w fazie rozwoju, aby zapewni\u0107 pisanie wysokiej jako\u015bci kodu zgodnego ze standardami. Ale nie chcemy udost\u0119pnia\u0107 10 MB danych tym, kt\u00f3rzy korzystaj\u0105 z naszego projektu.<\/p>\n Zamiast tego musimy uwzgl\u0119dni\u0107 tylko te pliki, kt\u00f3re s\u0105 wymagane, prawda? Aby to zrobi\u0107, musimy upewni\u0107 si\u0119, \u017ce generujemy autoloader, kt\u00f3ry mo\u017cemy do\u0142\u0105czy\u0107, a kt\u00f3ry w\u0142a\u015bnie to robi.<\/p>\n Najpierw poka\u017c\u0119 ci polecenie<\/a>, a nast\u0119pnie wyja\u015bni\u0119, co robi:<\/p>\n To wygeneruje dok\u0142adnie to, czego potrzebujemy, aby nasz projekt dzia\u0142a\u0142 w \u015brodowisku produkcyjnym. Oto, co robi ka\u017cda flaga:<\/p>\n Je\u015bli naprawd\u0119 interesuje Ci\u0119 optymalizacja autoloadera dla projekt\u00f3w spoza tego postu, to polecam przeczytanie tej strony<\/a> w dokumentacji Composera. To wykracza poza zakres tego, co tutaj robimy, ale mo\u017ce si\u0119 przyda\u0107 w przypadku innej pracy, kt\u00f3r\u0105 wykonujesz teraz lub kt\u00f3r\u0105 wykonujesz w przysz\u0142o\u015bci.<\/p>\n Je\u015bli pracujesz na Boilerplate na lokalnym komputerze, mo\u017cesz zobaczy\u0107 co\u015b takiego:<\/p>\n Ale je\u015bli uruchomisz powy\u017csze polecenie, zobaczysz co\u015b takiego:<\/p>\n To du\u017ca r\u00f3\u017cnica, a to ma\u0142y projekt. Wyobra\u017a sobie, \u017ce robisz co\u015b znacznie wi\u0119kszego, co b\u0119dzie dzia\u0142a\u0107 w \u015brodowisku produkcyjnym.<\/p>\n M\u00f3wi\u0105c z do\u015bwiadczenia, mog\u0119 powiedzie\u0107, \u017ce projekty mog\u0105 szybko osi\u0105gn\u0105\u0107 20 MB lub wi\u0119cej zale\u017cno\u015bci, je\u015bli u\u017cywasz r\u00f3\u017cnych bibliotek innych firm do takich rzeczy, jak rejestrowanie, \u017c\u0105dania HTTP i narz\u0119dzia do jako\u015bci kodu.<\/p>\n Ludzie cz\u0119sto m\u00f3wi\u0105, \u017ce nie nale\u017cy uwzgl\u0119dnia\u0107 katalogu dostawc\u00f3w w kontroli \u017ar\u00f3de\u0142 i nie bez powodu: mo\u017ce by\u0107 ogromny.<\/p>\n Nawet dokumentacja Composera m\u00f3wi o tym:<\/a><\/p>\n Najlepsz\u0105 praktyk\u0105 jest, aby wszyscy programi\u015bci u\u017cywali Composera do instalowania zale\u017cno\u015bci. Podobnie serwer kompilacji, CI, narz\u0119dzia wdro\u017ceniowe itp. powinny by\u0107 przystosowane do uruchamiania Composera w ramach \u0142adowania pocz\u0105tkowego projektu.<\/p>\n<\/blockquote>\n Wi\u0119c co mamy zrobi\u0107? Potrzebujemy autoloadera i potrzebujemy pewnych zale\u017cno\u015bci, poniewa\u017c nasi u\u017cytkownicy nie b\u0119d\u0105 wiedzie\u0107, jak uruchomi\u0107 (ani nie powinni uruchamia\u0107!) Composera za ka\u017cdym razem, gdy pobieraj\u0105 nasz\u0105 prac\u0119.<\/p>\n Ze wzgl\u0119du na natur\u0119 WordPressa i prac\u0119, kt\u00f3r\u0105 wykonujemy, b\u0119dziemy musieli zatwierdzi\u0107 katalog dostawc\u00f3w, ale tylko z bardzo okre\u015blonymi wymaganiami.<\/p>\n Zr\u00f3bmy wi\u0119c ka\u017cdy krok i zobaczmy, jak wygl\u0105da, kiedy sko\u0144czymy.<\/p>\n Aby utworzy\u0107 now\u0105 ga\u0142\u0105\u017a z poziomu terminala, wprowad\u017a nast\u0119puj\u0105ce polecenie<\/a> :<\/p>\n Spowoduje to zabranie ca\u0142ego kodu, nad kt\u00f3rym pracujemy, a nast\u0119pnie utworzenie z nim nowej ga\u0142\u0119zi. Poniewa\u017c b\u0119dzie to ga\u0142\u0105\u017a, kt\u00f3rej u\u017cywamy do dzia\u0142ania jako to, czego b\u0119d\u0105 u\u017cywa\u0107 nasi u\u017cytkownicy (o masterze porozmawiamy w<\/strong> przysz\u0142ym po\u015bcie).<\/p>\n Najpierw przejrzyj sw\u00f3j plik composer.json i upewnij si\u0119, \u017ce zawiera on nast\u0119puj\u0105ce elementy:<\/p>\n Teraz musimy upewni\u0107 si\u0119, \u017ce uruchamiamy powy\u017csze polecenie Composer, aby upewni\u0107 si\u0119, \u017ce nic poza tym, czego potrzebujemy, nie znajduje si\u0119 w\u00a0 katalogu dostawcy<\/strong>.<\/p>\n Teraz musimy zaktualizowa\u0107 gitignore.<\/p>\n A je\u015bli \u015bledzi\u0142e\u015b zar\u00f3wno seri\u0119, jak i post do tej pory, wiesz, \u017ce b\u0119dzie to wygl\u0105da\u0142o mniej wi\u0119cej tak (mo\u017ce zawiera\u0107 mniej wi\u0119cej, ale powinno zawiera\u0107 przynajmniej to).<\/p>\n Dla mnie wygl\u0105da to tak<\/a> :<\/p>\n W zale\u017cno\u015bci od tego, czy u\u017cywasz terminala, czy klienta, zobaczysz, \u017ce s\u0105 nowe pliki do zatwierdzenia (w szczeg\u00f3lno\u015bci z katalogu dostawcy). Wi\u0119c dodaj je do swojej ga\u0142\u0119zi.<\/p>\n Nast\u0119pnie zatwierd\u017a swoje zmiany<\/a>. Je\u015bli pracujesz w terminalu, mo\u017ce by\u0107 konieczne okre\u015blenie nast\u0119puj\u0105cych danych:<\/p>\n A dzi\u0119ki temu Tw\u00f3j kod powinien dzia\u0142a\u0107 i by\u0107 dost\u0119pny w GitHub (lub dowolnej us\u0142udze kontroli \u017ar\u00f3d\u0142a, z kt\u00f3rej korzystasz). Mo\u017cesz zobaczy\u0107, co mam dost\u0119pne tutaj<\/a>.<\/p>\n Teraz, gdy mamy ju\u017c wszystkie niezb\u0119dne elementy, nadszed\u0142 czas, aby zacz\u0105\u0107 u\u017cywa\u0107 Composer, autoloadera, naszych klas abstrakcyjnych i naszego rejestru, aby rozpocz\u0105\u0107 dodawanie podstawowych funkcji do WordPress Widget Boilerplate, aby\u015bmy mieli co\u015b do pokazania w naszej pracy .<\/p>\n Dla tych, kt\u00f3rzy s\u0105 ciekawi, w tej chwili planuj\u0119 uporz\u0105dkowanie oddzia\u0142\u00f3w w nast\u0119puj\u0105cy spos\u00f3b:<\/p>\n Na razie jednak przejrzyj, co jest om\u00f3wione w tym po\u015bcie, a wznowimy to w nast\u0119pnym po\u015bcie.<\/p>\nSzablon WordPress Widget: Refaktoryzacja, cz\u0119\u015b\u0107 6<\/h2>\n
Definicja autoloadera<\/h3>\n
\n
vendor\/autoload.php<\/code>plik. Mo\u017cesz po prostu do\u0142\u0105czy\u0107 ten plik i zacz\u0105\u0107 korzysta\u0107 z klas dostarczanych przez te biblioteki bez dodatkowej pracy:<\/p>\n<\/blockquote>\n{\n \"name\": \"wordpress-widget-boilerplate\/wordpress-widget-boilerplate\",\n \"description\": \"An organized, maintainable boilerplate for building widgets using WordPress best practices.\",\n \"type\": \"wordpress-plugin\",\n \"license\": \"GPL-3.0-or-later\",\n \"homepage\": \"https:\/\/github.com\/tommcfarlin\/WordPress-Widget-Boilerplate\",\n \"authors\": [\n {\n \"name\": \"Tom McFarlin\",\n \"email\": \"tom@pressware.co\",\n \"homepage\": \"https:\/\/pressware.co\"\n }\n ],\n \"support\": {\n \"issues\": \"https:\/\/github.com\/tommcfarlin\/WordPress-Widget-Boilerplate\/issues\"\n },\n \"config\": {\n \"preferred-install\": \"dist\",\n \"platform\": {\n \"php\": \"7.1\"\n }\n },\n \"repositories\": [\n {\n \"type\": \"composer\",\n \"url\": \"https:\/\/wpackagist.org\"\n }\n ],\n \"require\": {\n \"php\": \"7.1\",\n \"composer\/installers\": \"^1.4\"\n },\n \"require-dev\": {\n \"friendsofphp\/php-cs-fixer\": \"^2.13.1\",\n \"jakub-onderka\/php-parallel-lint\": \"^1.0.0\",\n \"phpmd\/phpmd\": \"^v2.6.0\",\n \"nikic\/php-parser\": \"^4.0\",\n \"ocramius\/proxy-manager\": \"^2.0.0\",\n \"phpro\/grumphp\": \"^0.13.1\"\n },\n \"scripts\": {\n \"test\": [\n \".\/vendor\/bin\/grumphp run\"\n ]\n },\n \"minimum-stability\": \"stable\"\n }<\/code><\/pre>\n<?php\n\n\/\/ Include the autoloader.\n\/\/ TODO: Note this has not yet been defined.\nrequire_once __DIR__. '\/inc\/autoload.php';\n<\/code><\/pre>\n$ composer install --no-dev --no-ansi --no-interaction --optimize-autoloader --no-progress --prefer-dist<\/code><\/pre>\n\n
Nadal jeste\u015b zainteresowany?<\/h4>\n
Jak to wygl\u0105da na p\u0142ycie kot\u0142owej?<\/h2>\n
![\"Wid\u017cety](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161015-61e719e23bf2d.png\")
<\/a><\/p>\n![\"Wid\u017cety](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161015-61e719e5afd5a.png\")
<\/a><\/p>\nCzy uwzgl\u0119dnimy w naszym katalogu dostawc\u00f3w?<\/h2>\n
\n
\n
Tworzenie ga\u0142\u0119zi wydania<\/h3>\n
$ git checkout -b release<\/code><\/pre>\n\"autoload\": {\n \"psr-4\": {\n \"WordPressWidgetBoilerplate\": \"src\/\",\n \"WordPressWidgetBoilerplateSubscriber\": \"src\/Subscriber\/\",\n \"WordPressWidgetBoilerplateUtilities\": \"src\/Utilities\/\",\n \"WordPressWidgetBoilerplateViews\": \"src\/Views\/\"\n }\n},<\/code><\/pre>\n$ composer install --no-dev --no-ansi --no-interaction --optimize-autoloader --no-progress --prefer-dist<\/code><\/pre>\nAktualizacja tego, co ignorujemy<\/h3>\n
*.DS_Store\n*.log\nwp-config.php\nwp-content\/advanced-cache.php\nwp-content\/backup-db\/\nwp-content\/backups\/\nwp-content\/blogs.dir\/\nwp-content\/cache\/\nwp-content\/upgrade\/\nwp-content\/uploads\/\nwp-content\/mu-plugins\/\nwp-content\/wp-cache-config.php\nwp-content\/plugins\/hello.php\n\n\/.htaccess\n\/license.txt\n\/readme.html\n\/sitemap.xml\n\/sitemap.xml.gz\n\n\/vendor\/**\/.git\n\/vendor\/bin\ncomposer.lock\n<\/code><\/pre>\n$ git push --set-upstream origin release<\/code><\/pre>\nDodawanie funkcjonalno\u015bci<\/h2>\n
\n