Kas yra Composer ir kaip veikia automatinis įkėlimas?

Question

Accepted Answer

**Composer** yra PHP standartinis **priklausomybių valdytojas** — jis įdiegia ir valdo trečiųjų šalių paketus (bibliotekos, darbo sistema) bei pateikia **automatinį įkėlimą**, kad klasės būtų įkeltos automatiškai be rankinio `require` pareiškimų. Tai yra svarbu visai moderniai PHP plėtrai.

## Priklausomybių valdymas

```bash
composer require guzzlehttp/guzzle    # add a package (records it + installs it)
composer install                       # install all deps from composer.json/lock
composer update                        # update to newer allowed versions
```

```json
// composer.json — declares your project's dependencies
{
  "require": {
    "guzzlehttp/guzzle": "^7.0",      // a package + version constraint
    "monolog/monolog": "^3.0"
  },
  "autoload": {
    "psr-4": { "App\": "src/" }        // map the App\ namespace to the src/ folder
  }
}
```

`composer.json` deklaruoja priklausomybes (su versijų apribojimais) ir automatinio įkėlimo konfigūraciją. **`composer.lock`** failas fiksuoja tikslias versijas (įsigitinti jį norint gauti pasikartojančias instaliacijas visoje komandoje ir produkcijoje — kaip ir kitame šaltinyje dėl šalčio).

## Automatinis įkėlimas: klasės įkeliamos pagal poreikį

```php
<?php
require "vendor/autoload.php";    // include the autoloader ONCE (bootstraps everything)

$user = new App\Models\User();    // App\Models\User loaded AUTOMATICALLY from src/Models/User.php
$client = new GuzzleHttp\Client(); // package classes load automatically too
// NO manual require for each class!
```

Su vienu `require "vendor/autoload.php"`, Composer autoloader įkelia bet kurią klasę **pagal poreikį** pirmą kartą, kai ji naudojama — atvaizdavęs klasės vardų erdvę į failo kelią (**PSR-4**) ir automatiškai jį įtraukdamas. Tai pakeičia senus, nuobodžius rankinio `require` kiekvieno klasės failo.

## Kaip PSR-4 automatinis įkėlimas atvaizdavęs vardus į failus

```text
Namespace prefix "App" → directory "src/"
Class App\Models\User → file src/Models/User.php
Class App\Services\Mailer → file src/Services/Mailer.php
→ The autoloader resolves the class name to a path and includes it. No config per class.
```

## Automatinio įkėlimo optimizavimas

```bash
composer dump-autoload -o    # generate an OPTIMIZED classmap for production (faster)
```

## Kodėl tai svarbu

Composer yra svarbi modernios PHP — tai yra kaip beveik kiekvienas PHP projektas valdo priklausomybes ir įkelia klases, todėl jų supratimas yra būtinas bet kuriam šiuolaikiniam PHP plėtojimui.

Jos dvi dalys yra abi kritinės: kaip **priklausomybių valdytojas**, jis įdiegia ir versijų tvarkytis trečiųjų šalių paketus ir darbo sistemas (Laravel, Symfony, Guzzle ir kt.), kuriomis tikros aplikacijos priklauso, su `composer.json` deklaruojant priklausomybes ir `composer.lock` užtikrinant pasikartojančias instaliacijas (įsigitinti jį, kaip bet kurią blokavimo failą, kad gauti nuoseklias versijas visoje komandoje ir produkcijoje).

Kaip **autoloader**, jis pašalina senąjį, klaidingą praktiką rankinio `require`-int kiekvieno klasės failo — vietoj to, vienas `require "vendor/autoload.php"` įjungia klases automatiškai pagal poreikį per **PSR-4** (vardų erdvės atvaizdavimas į katalogus).

Šis automatinis įkėlimas, sujungtas su vardų erdvėmis, yra modernaus PHP projekto struktūros pagrindas.

Kadangi negalite naudoti jokios modernios PHP darbo sistemos ar paketo be Composer, ir kadangi automatinis įkėlimas yra kaip visas modernus PHP kodas yra organizuojamas ir įkeliamas, supratimas Composer (valdžius priklausomybes, blokavimo failą, PSR-4 automatinį įkėlimą ir `vendor/autoload.php` pakeitimą) yra būtinas, kasdieninis žinojimas profesionaliam PHP plėtojimui — jis yra toks pat svarbus PHP, kaip npm yra Node.js.