Tovább a tartalomhoz

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.

  • A függőségeket a composer.json rögzíti, a tényleges kódot nem kell a Git-repóba tenni.
  • A composer.lock fájl minden gépen ugyanazokat a verziókat telepíti.
  • Az autoloader egyetlen require sorral betölti az osztályaidat.
  • Bedrock-projektben a Composer a WordPress-magot, a pluginokat és a témákat is kezeli. Lásd: Bedrock.

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.phar fájlt. Tedd egy olyan mappába, amely szerepel a PATH-ban, hogy composer néven hívhasd:

    Terminál
    mv composer.phar /usr/local/bin/composer

    Ha a parancs jogosultság miatt elbukik, futtasd sudo-val. Ha /usr/local/bin nem 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/composer image-ből futtathatod: docker run --rm -it -v "$(pwd):/app" composer/composer install.

Ellenőrzés:

Terminál
composer -V
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

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:

composer.json
{
"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.

Í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.

Az éles környezetben csak a futáshoz szükséges csomagokat telepítsd, gyorsított autoloaderrel:

Terminál
composer install --no-dev --optimize-autoloader

A composer.lock fájlt mindig told be a verziókezelőbe, hogy az éles szerver pontosan azt kapja, amit te teszteltél.

Ha a repository jelszót kér, a hitelesítési adatokat a Composer konfigurációjába tedd:

Terminál
composer config --global http-basic.example.com felhasznalo token

Az 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.

Készült: Frissítve:

Tiszteletben tartjuk a magánszférádat

Sütiket használunk a böngészési élmény javítására és a forgalom elemzésére. Az analitika csak akkor indul, ha engeded. Adatvédelmi irányelvek, Sütitájékoztató.

Sütibeállítások