Czym jest Composer i jak działa autoloading?

Question

Accepted Answer

**Composer** to standardowy **menedżer zależności** PHP — instaluje i zarządza pakietami trzecich stron (bibliotekami, frameworkami) oraz zapewnia **autoloading**, dzięki czemu klasy ładują się automatycznie bez ręcznych instrukcji `require`. Jest centralnym elementem całego nowoczesnego rozwoju w PHP.

## Zarządzanie zależnościami

```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` deklaruje zależności (z ograniczeniami wersji) i konfigurację autoloadera. Plik **`composer.lock`** fiksuje dokładne wersje (zatwierdzaj go, aby zapewnić reproducibilne instalacje w całym zespole i na produkcji — podobnie jak inne lockfile'i).

## Autoloading: klasy ładują się na żądanie

```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!
```

Z jednym `require "vendor/autoload.php"` autoloader Composera ładuje każdą klasę **na żądanie** przy pierwszym jej użyciu — mapując namespace klasy na ścieżkę pliku (**PSR-4**) i automatycznie go dołączając. To zastępuje starą, żmudną ręczną praktykę `require` każdego pliku klasy.

## Jak PSR-4 autoloading mapuje nazwy na pliki

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

## Optymalizacja autoloadingu

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

## Dlaczego to ważne

Composer jest fundamentalny dla nowoczesnego PHP — to jak praktycznie każdy projekt PHP zarządza zależnościami i ładuje klasy, więc zrozumienie go jest niezbędne dla każdego współczesnego rozwoju w PHP.

Jego dwie role są obie krytyczne: jako **menedżer zależności** instaluje i zarządza wersjami pakietów trzecich stron i frameworków (Laravel, Symfony, Guzzle, itp.), od których zależą rzeczywiste aplikacje, przy czym `composer.json` deklaruje zależności, a `composer.lock` zapewnia reproducibilne instalacje (zatwierdzaj je, jak każdy lockfile, dla spójnych wersji w zespole i na produkcji).

Jako **autoloader** eliminuje starą, podatną na błędy praktykę ręcznego `require`'owania każdego pliku klasy — zamiast tego jeden `require "vendor/autoload.php"` umożliwia klasom automatyczne ładowanie się na żądanie poprzez **PSR-4** (mapowanie namespace'ów na katalogi).

Ten autoloading, połączony z namespace'ami, jest fundamentem struktury nowoczesnego projektu PHP.

Ponieważ nie możesz używać żadnego nowoczesnego frameworka PHP ani pakietu bez Composera, a ponieważ autoloading to jak cały nowoczesny kod PHP jest organizowany i ładowany, zrozumienie Composera (zarządzanie zależnościami, plik lock, autoloading PSR-4 i bootstrap `vendor/autoload.php`) jest niezbędnym, codziennym wiedzą dla profesjonalnego rozwoju w PHP — jest równie centralny dla PHP, co npm dla Node.js.