# .env'den Merkezi Konfigürasyona Geçiş Eşiği

> .env dosyaları nereye kadar yeter, merkezi bir konfigürasyon sistemi ne zaman gerekir? Sır yönetimi ve ortamlar arası tutarlılık.

- Tür: Notlar
- Yayın: 2026-11-21
- Etiketler: configuration, infrastructure, production
- Okuma süresi: 2 dk okuma
- Kaynak: https://muhammetsafak.com/tr/muhendislik/notlar/konfigurasyon-yonetimi/
- Dil: tr-TR
- Yazar: Muhammet Şafak

---
> **Kısaca:** .env tek uygulama, birkaç ortam ve küçük bir ekip için yeterlidir; merkezi secret manager'a geçiş bir olgunluk rozeti değil, ölçülmüş bir eşik kararıdır. Sinyaller artan ortam sayısı, paylaşılan sırlar, elle yapılan döndürme ve denetim izinin yokluğudur. Eşikten bağımsız olarak hassas olmayan config ile secret baştan ayrılır ve secret repoda durmaz.

Bir ekipte `.env` dosyaları Slack özel mesajlarında elden ele dolaşıyordu. Hangi sırrın güncel olduğundan kimse emin değildi; döndürülmüş bir anahtar, bir sunucuda hâlâ eski hâliyle duruyordu.

`.env` çoğu proje için doğru araçtır. Sorun, onu büyüdüğü hâlde kullanmaya devam etmektir.

## .env nereye kadar yeter

Tek bir uygulama, birkaç ortam ve küçük bir ekip için `.env` fazlasıyla yeterlidir. Basit, herkesin bildiği, ek bir sistem gerektirmeyen bir çözüm. Bunu erkenden bir secret manager ile değiştirmek, [olmayan bir problem için karmaşıklık](https://muhammetsafak.com/tr/muhendislik/denemeler/ileride-lazim-olur-kodunun-faturasi/) eklemektir.

Çoğu proje bütün ömrünü bu basitlikte geçirir. Bir sonraki bölüme geçmeden önce, gerçekten o eşiği aştığınızdan emin olun.

## Çatlağın başladığı yer

`.env`'in yetmediğini gösteren somut sinyaller:

- Ortam sayısı arttı — dev, staging, [çoklu production](https://muhammetsafak.com/tr/muhendislik/sistemler/laravel-production-stack/), önizleme ortamları — ve aynı sırrı birden çok yerde elle güncellemek gerekiyor.
- Birden çok uygulama aynı sırları paylaşıyor; tek bir doğru kaynak yok.
- Sır döndürme (rotation) elle yapılıyor ve düzenli olarak bir yer atlanıyor.
- "Bu anahtarı kim, ne zaman değiştirdi" sorusunun cevabı yok.
- Bir sır, bir sohbet geçmişinde ya da bir geliştiricinin diskinde dolaşıyor.

Bunlar tek tek küçük; toplamı, sırların bir incident kaynağına dönüşmesidir.

## Merkezi konfigürasyon ne getirir

Bir secret manager — Vault, AWS Secrets Manager, Doppler ve benzerleri — şunları getirir: tek doğru kaynak, otomatik döndürme, kimin neye eriştiğinin denetimi, erişim kontrolü.

Bedeli de var: çalıştırılacak ya da bağımlı olunacak bir sistem daha, öğrenilecek bir araç daha. Bu yüzden geçiş, bir moda değil, ölçülmüş bir eşik kararıdır.

## Config ile secret'ı ayırın

Bu eşikten bağımsız, baştan yapılması gereken bir ayrım var: **config** ile **secret** aynı şey değildir.

- **Config** — hassas olmayan ayarlar: özellik bayrakları, zaman aşımı değerleri, sayfa boyutu. Bunlar rahatça repoda, versiyon kontrolünde durabilir.
- **Secret** — sızması zarar veren değerler: veritabanı parolası, API anahtarı, şifreleme anahtarı. Bunlar asla repoda durmamalı.

İkisini tek bir `.env` yığınına karıştırmak, sıradan bir ayar değişikliğini bile bir sır dosyasına dokunmaya çevirir. Hassas olmayanı koddan yönetin, hassas olanı koddan uzak tutun.

## Geçiş eşiği

Karar tek bir cümleyle: sır sayısı × ortam sayısı × bu sırlara dokunan insan sayısı, elle `.env` yönetimini ölçülebilir bir hata kaynağına dönüştürdüğünde merkezi sisteme geçin. Bir konferansta duyduğunuz için değil; bir sır yanlış yönetildiği için gerçek bir incident yaşadığınızda.

Kullanılmayan, unutulmuş config anahtarları da ayrı bir sinyaldir — [gereğinden karmaşık sistem sinyallerinde](https://muhammetsafak.com/tr/muhendislik/denemeler/gereginden-karmasik-sistem-sinyalleri/) değindiğim gibi, hangi sisteme geçerseniz geçin, ölü ayarları düzenli temizleyin.

---

`.env`'den merkezi konfigürasyona geçiş, bir olgunluk rozeti değil, bir ölçek kararıdır. Küçük bir projede merkezi secret manager, `.env`'in çözmediği bir problemi çözer — yani hiçbir şeyi.

Aracı, projenin gerçek boyutuna göre seçin — hayalinizdeki boyuta göre değil.

## Kaynaklar

- [Laravel 12.x Configuration: Environment File Security](https://laravel.com/docs/12.x/configuration) — Laravel
