# Dompdf Kurulum Rehberi

Ekspertiz raporlarının PDF olarak kaydedilmesi için Dompdf kütüphanesi gerekir. Aşağıdaki adımları takip edin.

---

## 1. Composer'ın kurulu olduğunu kontrol edin

**Laragon** kullanıyorsanız Composer genelde hazır gelir.

- **Laragon:** Sağ tık → Terminal (veya CMD) açın.
- Veya **Windows CMD / PowerShell** açıp şunu yazın:

```bash
composer --version
```

Çıktı örneği: `Composer version 2.x.x`  
Eğer "composer tanınmıyor" hatası alırsanız **Adım 2**ye geçin.

---

## 2. Composer yüklü değilse (Laragon’da genelde vardır)

1. https://getcomposer.org/download/ adresine gidin.
2. **Composer-Setup.exe** indirip çalıştırın.
3. Kurulumda **PHP’nin yolunu** seçin. Laragon kullanıyorsanız örnek:
   - `C:\laragon\bin\php\php-8.x.x\php.exe`
4. Kurulum bitince yeni bir CMD/PowerShell açıp tekrar `composer --version` yazın.

---

## 3. Proje klasörüne gidin

Terminalde (CMD veya PowerShell) proje kök klasörüne geçin:

```bash
cd c:\laragon\www\odak_ekspertiz
```

*(Kendi proje yolunuz farklıysa onu yazın.)*

---

## 4. Dompdf’i kurun

Aynı terminalde şu komutu çalıştırın:

```bash
composer install
```

Bu komut `composer.json` dosyasındaki paketleri (dompdf dahil) indirir ve `vendor` klasörünü oluşturur.

**Alternatif** (sadece Dompdf eklemek isterseniz):

```bash
composer require dompdf/dompdf
```

---

## 5. Kurulumu doğrulayın

- Proje içinde `vendor` klasörü oluşmuş olmalı.
- İçinde `vendor/dompdf/dompdf` klasörü görünmeli.

Kontrol için:

```bash
dir vendor\dompdf
```

(Linux/Mac’te: `ls vendor/dompdf`)

---

## 6. Raporu test edin

1. Sisteme giriş yapın.
2. Bir ekspertizi **tamamlayıp raporu bitirin** (tüm görevler tamamlanmış olsun).
3. **Raporu İndir** veya ilgili butona tıklayın.
4. PDF dosyası iniyor / açılıyorsa kurulum doğru çalışıyor demektir.

---

## Sık karşılaşılan sorunlar

| Sorun | Çözüm |
|--------|--------|
| `composer` tanınmıyor | Composer’ı kurun veya PATH’e ekleyin; Laragon’da “Terminal” ile deneyin. |
| `composer install` hata veriyor | İnternet bağlantısını kontrol edin; PHP 7.4+ kullandığınızdan emin olun (`php -v`). |
| Rapor hâlâ oluşmuyor | `storage/raporlar` klasörünün yazılabilir olduğundan emin olun. |
| PDF boş / hatalı | Tarayıcı konsolunda veya `storage/logs` (varsa) ve PHP error log’unda hata mesajına bakın. |

---

## Özet komutlar (tek seferde)

```bash
cd c:\laragon\www\odak_ekspertiz
composer install
```

Bu iki adımdan sonra Dompdf kullanıma hazır olur.