• Bağımlılık Çözümlemesi: Composer, projenizin `composer.json` dosyasında tanımlanan bağımlılıkları (ve bu bağımlılıkların kendi bağımlılıklarını) otomatik olarak çözer. En uygun versiyon kombinasyonlarını bularak, versiyon çakışmalarını minimize eder ve tüm gereksinimlerinizi doğru bir şekilde karşılar.
• Otomatik Yükleme (Autoloading): Bağımlılıkları kurduktan sonra, Composer otomatik olarak projenizdeki sınıfları ve kütüphaneleri yüklemek için bir otomatik yükleyici (autoloader) dosyası (`vendor/autoload.php`) oluşturur. Bu sayede, her dosyayı manuel olarak `require` etmek zorunda kalmazsınız, bu da kodunuzu daha temiz ve düzenli hale getirir. Özellikle PSR-4 standardına uygun sınıf yüklemesi için güçlü bir destektir.
• Kolay Kurulum ve Güncelleme: Tek bir komutla (örneğin `composer require` veya `composer update`) yeni kütüphaneler ekleyebilir, mevcutları güncelleyebilir veya kaldırabilirsiniz. Bu, manuel bağımlılık yönetimine kıyasla zaman ve emek tasarrufu sağlar.
• Standardizasyon: Composer, PHP dünyasında bağımlılık yönetiminde fiili bir endüstri standardı haline gelmiştir. Bu, farklı projeler arasında geçiş yaparken veya ekip içinde çalışırken tutarlılık ve anlaşılırlık sağlar.
• Gelişmiş Paket Kaynakları: Composer, Packagist.org gibi merkezi bir havuzdan paketleri çeker. Bu, binlerce hazır kütüphaneye kolayca erişebilmenizi ve bunları projelerinize dahil edebilmenizi sağlar.

composer -V

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php -r "if (hash_file('sha384', 'e21205b207c3ffce0318629a4240dbb5cc8ab1b9ba7c570d544cb10bca6cba7234ed03bbddbcbcbc6faf8a2b21c0af76', 'composer-setup.php')) { echo 'Installer verified'; } else { echo 'Installer corrupt'; unlink('composer-setup.php'); } echo PHP_EOL;"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

{
    "name": "my-vendor/my-application",
    "description": "Bu, Composer ile geliştirilmiş örnek bir PHP uygulamasıdır.",
    "type": "project",
    "license": "MIT",
    "authors": [
        {
            "name": "John Doe",
            "email": "john.doe@example.com",
            "homepage": "https://johndoe.com"
        }
    ],
    "keywords": [
        "php", "composer", "package-management", "example"
    ],
    "minimum-stability": "stable",
    "prefer-stable": true,
    "require": {
        "php": ">=8.0",
        "monolog/monolog": "^2.0",
        "nesbot/carbon": "^2.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^9.5",
        "symfony/var-dumper": "^6.0"
    },
    "autoload": {
        "psr-4": {
            "MyApp\\": "src/"
        },
        "files": [
            "helpers/functions.php"
        ]
    },
    "autoload-dev": {
        "psr-4": {
            "MyApp\\Tests\\": "tests/"
        }
    },
    "scripts": {
        "post-install-cmd": [
            "@php -r \"copy('.env.example', '.env');\"
        ],
        "post-update-cmd": [
            "php artisan optimize"
        ],
        "test": "phpunit --colors=always",
        "start": "php -S localhost:8080 -t public"
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "allow-plugins": {
            "symfony/flex": true
        }
    },
    "extra": {
        "symfony": {
            "allow-contrib": "true"
        }
    }
}

• name: Vendor adı ve proje adını içerir (ör: `my-vendor/my-application`). Bu, paketin Packagist.org gibi bir depoda tanımlanma şeklidir ve genellikle küçük harflerle, `-` ile ayrılarak yazılır.
• description: Projenizin kısa ve açıklayıcı bir metni.
• type: Paketin türü. Yaygın türler `library` (yeniden kullanılabilir bir kütüphane), `project` (bağımsız bir uygulama), `metapackage` (sadece bağımlılıkları gruplayan bir paket) ve `composer-plugin` (Composer'ın işlevselliğini genişleten bir eklenti) olabilir.
• license: Projenizin kullandığı açık kaynak lisansı (ör: `MIT`, `GPL-3.0-or-later`, `Apache-2.0`). SPDX tanımlayıcılarını kullanmak en iyi uygulamadır.
• authors: Projenin geliştiricilerinin listesi. Her bir yazar için ad, e-posta, anasayfa gibi bilgiler tanımlanabilir.
• keywords: Projenizi tanımlayan anahtar kelimeler. Packagist gibi depolarda arama yaparken yardımcı olur.
• minimum-stability: Bağımlılıkların kabul edilebilir minimum kararlılık seviyesi (`dev`, `alpha`, `beta`, `RC`, `stable`). Varsayılan `stable`'dır.
• prefer-stable: `minimum-stability` 'dev' olsa bile, mümkünse kararlı sürümleri tercih etmeyi belirtir.
• require: Projenizin çalışması için kesinlikle gerekli olan bağımlılıklar. Bu bölümdeki kütüphaneler, uygulamanızın üretim ortamında da bulunmalıdır. Bağımlılık versiyon kısıtlamaları (ör: `^2.0`, `~1.5`, `>=8.0`) burada tanımlanır.
• require-dev: Sadece geliştirme veya test amaçlı kullanılan bağımlılıklar (ör: PHPUnit, kod kalitesi araçları). Bu paketler `composer install --no-dev` komutuyla yüklenmez, bu da üretim dağıtımlarını daha hafif ve güvenli yapar.
• autoload: Projenizdeki sınıfların ve fonksiyonların nasıl otomatik yükleneceğini belirler. En yaygın kullanılan standart PSR-4'tür. Ayrıca `files` (belirli dosyaları her zaman dahil etmek için), `classmap` (eski stil kütüphaneler için) veya `dev` (sadece geliştirme ortamında geçerli otomatik yükleme ayarları) gibi seçenekler de sunar.
• autoload-dev: Sadece geliştirme ortamında geçerli olan otomatik yükleme tanımlamaları, genellikle test sınıfları için kullanılır.
• scripts: Çeşitli Composer olaylarına (ör: `post-install-cmd`, `pre-update-cmd`) bağlı olarak veya manuel olarak çalıştırılacak özel komutları tanımlar. Bu, veritabanı migrate etme, cache temizleme, testleri çalıştırma gibi otomasyon görevleri için idealdir.
• config: Composer'ın çalışma zamanı davranışını yapılandırmak için kullanılır. Ör: `optimize-autoloader` (otomatik yükleyiciyi üretim için optimize eder), `preferred-install` (paketlerin nasıl indirileceğini belirler, `dist` veya `source`), `allow-plugins` (belirli eklentilerin çalışmasına izin verir).
• extra: Diğer araçlar veya kütüphaneler tarafından kullanılan özel, Composer'ın kendisi tarafından işlenmeyen veriler için esnek bir alandır.

• `1.2.3`: Yalnızca tam olarak `1.2.3` sürümü.
• `^1.2` (caret operatörü): Bu, en yaygın kullanılan operatördür. Semantik uyumlu en az `1.2.0` sürümü, ancak `2.0.0`'dan az demektir. Yani `1.x.x` serisindeki tüm yeni minor ve patch sürümlerini kabul eder, ancak yeni bir major sürüme otomatik olarak geçiş yapmaz (çünkü major sürümler API değişiklikleri içerebilir).
• `~1.2` (tilde operatörü): Semantik uyumlu en az `1.2.0`, ancak `1.3.0`'dan az demektir. Yani `1.2.x` serisindeki tüm patch sürümlerini kabul eder, ancak `1.3.0` veya daha üstüne geçmez. Genellikle küçük güncellemeler için tercih edilir.
• `>` , `<` , `>=` , `<=`: Daha büyük, daha küçük, büyük veya eşit, küçük veya eşit. Belirli bir aralık belirtmek için kullanılabilir (ör: `>=1.0 <2.0`).
• `1.2.*`: `1.2.0` ve `1.2.x` serisindeki tüm sürümler. `~1.2` ile benzerdir, ancak belirli minor sürüm kısıtlaması yerine joker karakter kullanır.
• `dev-master` veya `dev-main`: Projenin ana dalındaki en son geliştirme sürümü. Genellikle sadece geliştirme aşamasında veya çok yeni paketlerde kullanılır, üretimde önerilmez çünkü kararsız olabilir.

composer init

composer require monolog/monolog

composer require phpunit/phpunit --dev

composer install

composer install --no-dev --optimize-autoloader

composer update           // Tüm bağımlılıkları günceller
composer update monolog/monolog // Sadece Monolog'u günceller

composer remove monolog/monolog

composer dump-autoload
composer dump-autoload --optimize --no-dev

Önemli Not: `composer.lock` dosyası, projenizin versiyon kontrol sistemine (örneğin Git) mutlaka dahil edilmelidir. Bu, ekip üyelerinin ve dağıtım sunucularının tam olarak aynı bağımlılık setini kullanmasını garanti eder. Aksi takdirde, farklı geliştiriciler veya ortamlar farklı bağımlılık versiyonlarıyla karşılaşabilir, bu da hatalara yol açabilir. `vendor` dizini ise genellikle `.gitignore` dosyasına eklenerek versiyon kontrolünden hariç tutulur, çünkü bu klasör `composer install` komutuyla kolayca yeniden oluşturulabilir.

Genişletmek için tıkla ...

"autoload": {
    "psr-4": {
        "MyApp\\": "src/"
    }
}

• `MyApp\Controllers\HomeController` sınıfı çağrıldığında, Composer otomatik olarak `src/Controllers/HomeController.php` dosyasını arayacak ve yükleyecektir.
• `MyApp\Models\User` sınıfı çağrıldığında, Composer `src/Models/User.php` dosyasını arayacak ve yükleyecektir.

require __DIR__ . '/vendor/autoload.php';

use MyApp\Controllers\HomeController;

$controller = new HomeController();
$controller->index();

"scripts": {
    "post-install-cmd": [
        "@php -r \"copy('.env.example', '.env');\"",
        "php artisan migrate",
        "php artisan db:seed --class=InitialDataSeeder"
    ],
    "post-update-cmd": [
        "php artisan config:clear",
        "php artisan cache:clear"
    ],
    "test": "phpunit --colors=always --testdox",
    "lint": "phpcs --standard=PSR12 src/",
    "start": "php -S localhost:8000 -t public"
}

• Olay Scriptleri: `post-install-cmd` (Composer install sonrası), `post-update-cmd` (Composer update sonrası) gibi scriptler, ilgili Composer komutu çalıştıktan sonra otomatik olarak tetiklenir. Laravel gibi framework'ler bu mekanizmayı sıkça kullanır.
• Özel Scriptler: `test`, `lint`, `start` gibi kendi tanımladığınız scriptleri çalıştırmak için `composer run-script <script-adı>` veya kısaca `composer <script-adı>` (eğer script adı Composer'ın dahili komutlarıyla çakışmıyorsa) komutunu kullanın.
  
  Kod:

  composer run-script test
  // veya kısaca
  composer test
  composer start

• Versiyon Kontrolü (VCS) ve `.gitignore`: `composer.json` ve `composer.lock` dosyalarını projenizin versiyon kontrol sistemine (Git gibi) mutlaka dahil edin. Ancak, bağımlılıkların yüklendiği `vendor/` dizinini `.gitignore` dosyasına ekleyerek versiyon kontrolünden hariç tutun. Bu, repository'nizin boyutunu küçük tutar ve farklı ortamlarda tekrarlanabilir bağımlılık kurulumunu sağlar.
• Geliştirme ve Üretim Bağımlılıklarını Ayırma: `require` (üretim için gerekli) ve `require-dev` (sadece geliştirme ve test için gerekli) bağımlılıklarını net bir şekilde ayırın. Üretim ortamına dağıtım yaparken `composer install --no-dev` komutunu kullanarak gereksiz paketlerin yüklenmesini engelleyin, böylece daha az disk alanı kullanılır ve potansiyel güvenlik açıkları azalır.
• Otomatik Yükleyiciyi Optimize Etme: Üretim ortamında performans için `composer dump-autoload --optimize --no-dev --classmap-authoritative` komutunu kullanarak otomatik yükleyiciyi optimize edin. Bu, sınıf yükleme sürelerini önemli ölçüde azaltabilir.
• Bağımlılık Güncellemeleri: Bağımlılıklarınızı düzenli olarak güncelleyin (`composer update`), ancak ana sürüm güncellemelerinde (major versions) olası uyumluluk sorunlarına karşı dikkatli olun. Güncelleme yapmadan önce testlerinizi çalıştırmak veya ayrı bir ortamda deneme yapmak iyi bir alışkanlıktır.
• Temiz Ortamda Çalışma: Bazen bağımlılık sorunları veya önbellek bozulmaları yaşanabilir. Böyle durumlarda `vendor/` dizinini ve `composer.lock` dosyasını silip (`rm -rf vendor/ composer.lock`), ardından `composer install` komutunu çalıştırarak temiz bir başlangıç yapabilirsiniz.
• Global Composer Erişimi: `composer.phar` dosyasını sistem PATH'inize ekleyerek veya `/usr/local/bin/composer` gibi bir yere taşıyarak global olarak erişilebilir hale getirin. Bu, her projede `php composer.phar` yerine sadece `composer` yazmanızı sağlar.
• Paket Seçimi ve Güvenlik: Yeni bir paket seçerken, Packagist.org üzerindeki indirme sayılarına, aktif bakım durumuna, açık kaynak topluluğundaki popülaritesine ve güvenlik açıklarına karşı geçmişine dikkat edin. Güvenli olmayan veya terkedilmiş paketlerden kaçının.

• PHP Versiyon Uyuşmazlığı: Bir paket belirli bir PHP versiyonu gerektiriyorsa ve sizin sisteminizdeki PHP versiyonu bu gereksinimi karşılamıyorsa `Your PHP version (X.Y.Z) does not satisfy that requirement` gibi bir hata alırsınız. Bu durumda `composer.json` dosyanızdaki `php` versiyon kısıtlamasını kontrol edin ve PHP'nizi güncelleyin veya paketin daha eski, uyumlu bir versiyonunu kullanmayı düşünün.
• Bellek Yetersizliği (Memory Exhaustion): Özellikle büyük projelerde veya çok sayıda bağımlılık olduğunda `composer update` veya `composer install` sırasında `Allowed memory size of X bytes exhausted` hatası alabilirsiniz. Bu, PHP'nin komut satırı için ayrılan bellek limitinin yetersiz olduğu anlamına gelir. Geçici olarak artırmak için:
  
  Kod:

  php -d memory_limit=-1 /usr/local/bin/composer update

  Veya kalıcı olarak `php.ini` dosyasında `memory_limit` değerini artırın (örneğin `memory_limit = 1024M`).
• Composer Cache Sorunları: Bazen Composer'ın indirme veya bağımlılık çözümleme önbelleği bozulabilir. Bu, garip hatalara veya bağımlılıkların doğru yüklenmemesine neden olabilir. Önbelleği temizlemek genellikle bu tür sorunları çözer:
  
  Kod:

  composer clear-cache

• Bağımlılık Çakışmaları (Dependency Conflicts): İki farklı paketin aynı bağımlılığın farklı, birbiriyle uyumsuz versiyonlarını gerektirmesi durumunda çakışmalar oluşabilir. Composer genellikle bu durumu akıllıca çözmeye çalışır, ancak çözemediği zamanlarda detaylı bir hata mesajı verir. Bu tür durumlarda `composer why-not <vendor/package> <version>` komutunu kullanarak belirli bir paketin neden yüklenemediğini veya belirli bir versiyonun neden uyuşmadığını anlayabilirsiniz:
  
  Kod:

  composer why-not doctrine/orm 2.10
  // Çıktı, hangi paketin neden 2.10'u engellediğini gösterir.

  Bu, çakışmanın kaynağını bulup çözmenize yardımcı olur. Bazen bu, bir paketin daha eski bir versiyonunu kullanmak veya çakışan bağımlılıklardan birini bırakmak anlamına gelebilir.
• PHP Uzantıları Eksikliği: Bazı paketler belirli PHP uzantılarının yüklü olmasını gerektirir (örneğin `ext-json`, `ext-mbstring`, `ext-pdo`). Eğer bu uzantılar eksikse, Composer hata verir. `php.ini` dosyanızda ilgili uzantıları etkinleştirmeniz veya sisteminize kurmanız gerekebilir.