Composer
A Composer a PHP függőségkezelője: telepítés, a legfontosabb parancsok és használata WordPress-projektben.
A Composer PHP-hoz készült függőségkezelő. Megmondod, melyik könyvtáraktól függ a projekted, ő pedig kiszámolja, mely verziókat kell telepíteni, és letölti őket a projekt vendor mappájába.
A Composer nem rendszerszintű csomagkezelő: alapból projektenként dolgozik, és semmit nem telepít globálisan. WordPressben pluginok, témák és PHP-könyvtárak kezelésére használjuk.
Mire jó WordPressben?
Szekció neve “Mire jó WordPressben?”- A függőségeket a
composer.jsonrögzíti, a tényleges kódot nem kell a Git-repóba tenni. - A
composer.lockfájl minden gépen ugyanazokat a verziókat telepíti. - Az autoloader egyetlen
requiresorral betölti az osztályaidat. - Bedrock-projektben a Composer a WordPress-magot, a pluginokat és a témákat is kezeli. Lásd: Bedrock.
Telepítés
Szekció neve “Telepítés”A Composerhez PHP kell. A letöltési parancsok pontos, mindig friss változata a getcomposer.org/download oldalon van, ezt kövesd, mert a telepítő ellenőrző összeget is használ.
-
Linux és macOS: a letöltött telepítő létrehozza a
composer.pharfájlt. Tedd egy olyan mappába, amely szerepel aPATH-ban, hogycomposernéven hívhasd:Terminál mv composer.phar /usr/local/bin/composerHa a parancs jogosultság miatt elbukik, futtasd
sudo-val. Ha/usr/local/binnem létezik, hozd létre előbb (mkdir -p /usr/local/bin). -
Windows: töltsd le és futtasd a Composer-Setup.exe telepítőt, majd nyiss új terminált.
-
Docker: a
composer/composerimage-ből futtathatod:docker run --rm -it -v "$(pwd):/app" composer/composer install.
Ellenőrzés:
composer -VA legfontosabb parancsok
Szekció neve “A legfontosabb parancsok”| Parancs | Mit csinál |
|---|---|
composer init |
létrehozza a composer.json fájlt |
composer install |
telepíti a composer.lock szerinti verziókat |
composer update |
frissíti a csomagokat a megengedett verziótartományon belül |
composer require vendor/csomag |
felvesz egy csomagot |
composer remove vendor/csomag |
eltávolít egy csomagot |
composer outdated |
kilistázza, melyikből van újabb verzió |
composer audit |
ismert biztonsági hibákat keres a telepített csomagokban |
composer dump-autoload |
újragenerálja az autoloadert |
WordPress-bővítmények Composerrel
Szekció neve “WordPress-bővítmények Composerrel”A wordpress.org-on elérhető pluginokat és témákat egy Composer-repository teszi elérhetővé, például a WPackagist. Használatát a WPackagist cikk írja le. A composer.json-ban a repositories részbe veszed fel, a composer/installers csomag pedig a megfelelő mappába teszi a bővítményeket:
{ "require": { "composer/installers": "^2.0" }, "extra": { "installer-paths": { "wp-content/plugins/{$name}/": ["type:wordpress-plugin"], "wp-content/themes/{$name}/": ["type:wordpress-theme"] } }, "config": { "allow-plugins": { "composer/installers": true } }}Az allow-plugins kell ahhoz, hogy a Composer lefuttassa a composer/installers bővítményt.
Verziómegkötések
Szekció neve “Verziómegkötések”| Írásmód | Jelentése |
|---|---|
1.2.3 |
pontosan ez a verzió |
>=1.2 <2.0 |
tartomány |
1.2.* |
bármely 1.2.x verzió |
~1.2.3 |
>=1.2.3 <1.3.0 |
^1.2.3 |
>=1.2.3 <2.0.0 |
dev-main |
a main ág legfrissebb állapota |
A ^ a leggyakoribb: megengedi a visszafelé kompatibilis frissítéseket, de a következő főverziót nem.
Éles telepítés
Szekció neve “Éles telepítés”Az éles környezetben csak a futáshoz szükséges csomagokat telepítsd, gyorsított autoloaderrel:
composer install --no-dev --optimize-autoloaderA composer.lock fájlt mindig told be a verziókezelőbe, hogy az éles szerver pontosan azt kapja, amit te teszteltél.
Hitelesítés privát repositoryhoz
Szekció neve “Hitelesítés privát repositoryhoz”Ha a repository jelszót kér, a hitelesítési adatokat a Composer konfigurációjába tedd:
composer config --global http-basic.example.com felhasznalo tokenAz adatok a gépeden, a globális auth.json fájlba kerülnek. Ha projekt-szintű auth.json fájlt használsz, tedd a .gitignore-ba, hogy ne kerüljön a Git-repóba.
Források
Szekció neve “Források”Készült: Frissítve: