composer.json

// Linux/macOS için:
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
sudo mv composer.phar /usr/local/bin/composer

// Windows için:
// Composer-Setup.exe dosyasını indirebilirsiniz: https://getcomposer.org/Composer-Setup.exe

composer --version

composer.json

{
    "name": "vendor/my-project",
    "description": "Basit bir Composer projesi",
    "type": "project",
    "license": "MIT",
    "authors": [
        {
            "name": "Adınız Soyadınız",
            "email": "email@example.com"
        }
    ],
    "require": {
        "php": ">=7.4",
        "monolog/monolog": "^2.0"
    },
    "require-dev": {
        "phpunit/phpunit": "^9.5"
    },
    "autoload": {
        "psr-4": {
            "MyApp\\": "src/"
        }
    },
    "scripts": {
        "test": "phpunit",
        "post-install-cmd": [
            "echo 'Proje bağımlılıkları başarıyla yüklendi!'"
        ]
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true
    },
    "minimum-stability": "dev",
    "prefer-stable": true
}

• name: Projenizin adı. Genellikle
  Kod:

  vendor-adı/proje-adı

  formatında olur.
• description: Projenin kısa açıklaması.
• type: Projenin tipi (project, library, metapackage, composer-plugin).
• license: Projenizin lisansı.
• authors: Projeyi geliştirenlerin listesi.
• require: Projenizin çalışması için gerekli olan bağımlılıkları ve versiyon kısıtlamalarını tanımlar. Örneğin,
  Kod:

  monolog/monolog: ^2.0

  demek, Monolog kütüphanesinin 2.x serisinden herhangi bir versiyonunun kullanılabileceği anlamına gelir.
• require-dev: Sadece geliştirme ortamında kullanılan bağımlılıkları (örn. test kütüphaneleri) tanımlar.
• autoload: Projenizin sınıflarının Composer tarafından nasıl otomatik yükleneceğini belirler (PSR-4 veya PSR-0). Bu,
  Kod:

  use

  anahtar kelimesiyle sınıfları kolayca kullanmanızı sağlar.
• scripts: Çeşitli Composer olaylarına (örneğin, bağımlılıklar yüklendikten sonra) veya manuel olarak çalıştırılabilecek özel komutları tanımlar.
• config: Composer'ın çalışma şekliyle ilgili ayarları içerir. Örneğin, otomatik yükleyiciyi optimize etme veya paketleri indirme tercihleri.
• minimum-stability: Kurulacak paketlerin minimum stabilite seviyesini belirler (dev, alpha, beta, RC, stable).
• prefer-stable: Eğer stable bir sürüm varsa, onu dev sürümlere tercih eder.

• 1.0.0: Tam olarak bu versiyon.
• ^1.0 (caret): ~1.0.0'a eşdeğerdir. 1.0.0 ve üzeri, ancak 2.0.0'dan küçük. Ana versiyonun (major version) kırıcı değişiklikler içermediği varsayıldığı için yaygın kullanılır.
• ~1.2 (tilde): 1.2.0 ve üzeri, ancak 1.3.0'dan küçük. Patch (yama) veya minor (küçük) güncellemeleri kabul eder.
• 1.0.*: 1.0.0, 1.0.1, 1.0.99 gibi 1.0 serisindeki tüm versiyonlar.
• >=1.0: 1.0 ve üzeri.
• <1.5: 1.5'ten küçük.
• 1.0 - 1.5: 1.0 dahil, 1.5 dahil aralığı.

^(caret)

composer install

composer.json

vendor/

composer.lock

Önemli Not:

Kod:

composer.lock

dosyası sürüm kontrol sisteminize (örn. Git) dahil edilmelidir. Bu, ekibinizdeki diğer geliştiricilerin ve üretim ortamının, tam olarak sizin kullandığınız bağımlılık versiyonlarını kullanmasını garanti eder. Bu sayede, farklı ortamlarda farklı davranışların önüne geçilir.

Kod:

vendor/

dizini ise sürüm kontrol sistemine dahil edilmemelidir (

Kod:

.gitignore

dosyasına eklenmelidir), çünkü bu dizin sadece Composer tarafından yönetilir ve gereksiz dosya şişkinliği yaratır.

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

• composer install: Eğer
  Kod:

  composer.lock

  dosyası varsa, bu dosyadaki versiyonları kullanarak bağımlılıkları kurar. Eğer yoksa,
  Kod:

  composer.json

  'dan okur ve yeni bir
  Kod:

  composer.lock

  dosyası oluşturur. Genellikle projeyi ilk kez kurarken veya yeni bir geliştirici ekibe katıldığında kullanılır.
• composer update:
  Kod:

  composer.json

  'daki versiyon kısıtlamalarına göre bağımlılıkları en son uygun versiyonlarına günceller ve
  Kod:

  composer.lock

  dosyasını yeniden yazar. Bu komut, bağımlılıklarınızı yeni özellikler veya güvenlik yamaları almak için güncel tutmak istediğinizde kullanılır.
• composer require [paket-adı]: Yeni bir bağımlılığı projenize ekler. Composer, paketi Packagist'ten bulur, indirir,
  Kod:

  composer.json

  ve
  Kod:

  composer.lock

  dosyalarını günceller.
  
  Kod:

      composer require guzzlehttp/guzzle
      composer require --dev phpunit/phpunit

  Yukarıdaki örnekte
  Kod:

  guzzlehttp/guzzle

  paketi
  Kod:

  require

  bölümüne,
  Kod:

  phpunit/phpunit

  ise
  Kod:

  --dev

  bayrağı sayesinde
  Kod:

  require-dev

  bölümüne eklenecektir.
• composer remove [paket-adı]: Bir bağımlılığı projeden kaldırır.
  
  Kod:

      composer remove monolog/monolog

• composer dump-autoload: Autoloading dosyalarını yeniden oluşturur. Özellikle yeni sınıflar eklediğinizde veya
  Kod:

  composer.json

  'daki
  Kod:

  autoload

  bölümünü değiştirdiğinizde gerekebilir.
• composer validate:
  Kod:

  composer.json

  dosyanızın geçerli olup olmadığını kontrol eder.
• composer search [anahtar-kelime]: Packagist'te paket aramanızı sağlar.
• composer self-update: Composer'ın kendisini en son sürüme günceller.

require

include

composer.json

autoload

"autoload": {
    "psr-4": {
        "MyApp\\": "src/"
    },
    "files": [
        "app/Helpers.php"
    ]
}

src/

MyApp

src/Http/Kernel.php

MyApp\Http\Kernel

new MyApp\Http\Kernel();

files

vendor/autoload.php

index.php

public/index.php

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

// Artık Composer tarafından yüklenen tüm kütüphaneler ve kendi sınıflarınız kullanılabilir.
$log = new Monolog\Logger('my_app');
$log->pushHandler(new Monolog\Handler\StreamHandler('app.log', Monolog\Logger::WARNING));
$log->warning('Bu bir uyarı mesajıdır.');

$kernel = new MyApp\Http\Kernel(); // Kendi sınıfınız
$kernel->handleRequest();

require

require-dev

• Geliştirme Ortamı (Development Environment): Tüm bağımlılıklar (hem
  Kod:

  require

  hem de
  Kod:

  require-dev

  ) yüklüdür. Testler, kod analizi araçları gibi geliştirme araçlarına ihtiyaç duyulur.
  Kod:

  composer install

  komutu yeterlidir.
• Üretim Ortamı (Production Environment): Yalnızca projenin çalışması için zorunlu olan bağımlılıklar (
  Kod:

  require

  bölümündekiler) yüklenmelidir. Bu, disk alanından tasarruf sağlar ve potansiyel güvenlik açıklarını azaltır. Bu durumda
  Kod:

  composer install --no-dev

  komutu kullanılır.

• Versiyon Kısıtlamalarını Akıllıca Kullanın: Genellikle
  Kod:

  ^(caret)

  operatörü tercih edilir. Bu, bağımlılıklarınızın hem güvenli hem de güncel kalmasını sağlar. Büyük bir versiyon atlaması olmadan yeni özellikler ve güvenlik yamaları almanızı sağlar.
• composer.lock Dosyasını Git'e Ekleme: Daha önce de belirtildiği gibi, bu dosya tüm ekibin ve sunucuların aynı bağımlılık versiyonlarını kullanmasını garantiler.
• vendor/ Dizinini Git'ten Hariç Tutma: Bu dizin
  Kod:

  .gitignore

  'a eklenmelidir.
• Periyodik composer update: Geliştirme ortamında düzenli olarak
  Kod:

  composer update

  çalıştırarak bağımlılıklarınızı güncel tutun. Ancak bunu yapmadan önce mutlaka bir versiyon kontrolü kullanın ve potansiyel kırıcı değişikliklere karşı testlerinizi çalıştırın.
• minimum-stability ve prefer-stable: Bu ayarlar, paketin stabilite tercihini yönetir. Üretim projeleri için
  Kod:

  prefer-stable: true

  ve
  Kod:

  minimum-stability: stable

  kullanmak en güvenlisidir, ancak bazen yeni özellikler veya hata düzeltmeleri için
  Kod:

  dev

  veya
  Kod:

  beta

  paketlere ihtiyaç duyulabilir.
• Paketleri Packagist'ten Araştırın: Yeni bir özellik eklemeden önce, genellikle Packagist'te ihtiyacınızı karşılayacak bir paket bulabilirsiniz. Bu, tekerleği yeniden icat etmekten kurtarır ve zaman kazandırır.

• Bellek Sınırı Hatası: Özellikle çok sayıda bağımlılığı olan büyük projelerde Composer'ın bellek yetersizliği hatası verebilir.
  
  Kod:

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

  Bu komut PHP'nin bellek sınırını kaldırır. Sunucu yapılandırmasını kalıcı olarak değiştirmek yerine, sadece bu işlem için bellek limitini artırmak daha güvenlidir.
• Versiyon Çakışmaları: İki farklı bağımlılığın aynı alt paketin farklı versiyonlarına ihtiyaç duyması durumunda ortaya çıkar. Composer genellikle bu durumu size bildirir.
  Kod:

  composer why-not [çakışan-paket-adı]

  komutuyla neden belirli bir versiyonun yüklenemediğini veya bir bağımlılığın neden çakıştığını görebilirsiniz.
• Eski PHP Versiyonu: Bazı paketler belirli bir PHP versiyonu gerektirebilir.
  Kod:

  composer.json

  'daki
  Kod:

  php

  kısıtlamasını kontrol edin ve PHP versiyonunuzu güncelleyin.

Sonuç olarak: Composer, modern PHP geliştirmenin vazgeçilmez bir aracıdır. Bağımlılıklarınızı yönetmek, projelerinizi daha düzenli, sürdürülebilir ve işbirliğine açık hale getirir. Projelerinizi Composer ile başlatmak, gelecekteki olası sorunların önüne geçmenize yardımcı olur ve geliştirme sürecinizi büyük ölçüde hızlandırır.

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