Sayfa yükleniyor

Destek Müşteri Girişi Sepet (0)

Ders 87 – Ortam değişkenleri (.env)

PHP projelerinde gizli bilgileri güvenli bir şekilde yönetmek, .env dosyaları ve ortam değişkenleriyle nasıl yapılır? Adım adım örneklerle anlatıyoruz.

Ders 87 – Ortam değişkenleri (.env)

Günümüz web uygulamalarında veritabanı şifreleri, API anahtarları ve diğer gizli bilgiler kod içinde doğrudan bulunmamalıdır. Bu bilgiler yanlış ellere geçtiğinde uygulamanızın güvenliği tehlikeye girer, veri sızıntıları yaşanabilir ve yasal sorumluluklar doğabilir. .env dosyaları ve ortam değişkenleri, bu tür hassas verileri ayrı bir katmanda tutarak kodunuzu temiz ve güvenli hâle getirir. Bu ders, PHP’de ortam değişkenlerini nasıl tanımlayacağınızı, putenv ve $_ENV süperglobalini nasıl kullanacağınızı, vlucas/phpdotenv paketinin entegrasyonunu ve yaygın hataları nasıl önleyeceğinizi adım adım gösterir.

Temeller

Ortam değişkenleri, işletim sisteminin bir sürecine özgü olarak tanımlanan anahtar-değer çiftleridir. PHP, bu değişkenlere iki yoldan erişim sağlar:

  • putenv('KEY=VALUE') – Çalışma zamanında bir ortam değişkeni ekler veya değiştirir.
  • $_ENV['KEY'] – Çalışma anındaki ortam değişkenlerini okur.

Bu iki yöntem aynı amaca hizmet eder, fakat $_ENV daha okunaklıdır ve putenv sadece geçerli PHP sürecini etkiler. Çoğu modern proje, $_ENV üzerinden okunabilir bir yapı tercih eder. Ancak, $_ENV değişkenlerinin PHP konfigürasyonunda variables_order ve env ayarlarının doğru yapılandırılmış olması gerekir.

Adım Adım Ortam Değişkenleri Kullanımı

Bu bölümde, yerel geliştirme ortamınızda .env dosyasını oluşturup, vlucas/phpdotenv paketini kurarak ortam değişkenlerini nasıl okuyacağınızı göstereceğiz.

  1. .env dosyasını oluşturun: Proje kök dizininizde .env adında bir dosya yaratın ve içine gizli bilgileri anahtar=değer formatında yazın. Örneğin:
    DB_HOST=localhost
    DB_NAME=mysite
    DB_USER=muratsoft
    DB_PASS=GizliSifre123
    API_KEY=abcd1234efgh5678
    
  2. Composer ile phpdotenv paketini ekleyin: Terminalde composer require vlucas/phpdotenv komutunu çalıştırın. Bu paket, .env dosyasını okuyup $_ENV ve $_SERVER dizilerine otomatik olarak aktarır.
  3. Bootstrap dosyanıza entegrasyonu ekleyin: Genellikle public/index.php ya da bootstrap.php dosyalarında aşağıdaki kod bloğunu ekleyin:
    require __DIR__ . '/../vendor/autoload.php';
    $dotenv = Dotenv\Dotenv::createImmutable(__DIR__ . '/../');
    $dotenv->load();
    
    Bu kod, .env dosyasını proje kökünden okuyarak ortam değişkenlerini yükler.
  4. Değişkenleri güvenli bir şekilde okuyun: Artık $_ENV['DB_PASS'] gibi bir ifadeyle şifrelere erişebilirsiniz. Örneğin bir PDO bağlantısı şöyle oluşturulur:
    $dsn = sprintf('mysql:host=%s;dbname=%s;charset=utf8', $_ENV['DB_HOST'], $_ENV['DB_NAME']);
    $pdo = new PDO($dsn, $_ENV['DB_USER'], $_ENV['DB_PASS'], [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    ]);
    
  5. .env dosyasını versiyon kontrolünden hariç tutun: Projenizin kökünde .gitignore dosyasına .env satırını ekleyin. Böylece gizli bilgileriniz GitHub, GitLab gibi platformlara gönderilmez.

Örnek Kod

Aşağıdaki örnek, bir config.php dosyası içinde ortam değişkenlerini okuyarak konfigürasyon dizisi oluşturur. Bu dosya, uygulamanın diğer bölümlerinde require edilerek kullanılabilir.

// config.php
if (!function_exists('env')) {
    function env(string $key, $default = null) {
        return $_ENV[$key] ?? $default;
    }
}

return [
    'db' => [
        'host' => env('DB_HOST', '127.0.0.1'),
        'name' => env('DB_NAME', 'test'),
        'user' => env('DB_USER', 'root'),
        'pass' => env('DB_PASS', ''),
    ],
    'api' => [
        'key' => env('API_KEY'),
    ],
];

Bu konfigürasyonu kullanmak için:

// index.php
$config = require __DIR__ . '/config.php';

$pdo = new PDO(
    sprintf('mysql:host=%s;dbname=%s;charset=utf8', $config['db']['host'], $config['db']['name']),
    $config['db']['user'],
    $config['db']['pass']
);

echo 'Veritabanına bağlanıldı!';

Sık Karşılaşılan Hatalar

  • .env dosyası okunamıyor: Dosya yolu yanlışsa Dotenv::createImmutable() bir istisna fırlatır. __DIR__ ve proje kök dizinini doğru belirlediğinizden emin olun.
  • $_ENV boş geliyor: variables_order php.ini ayarında EGPCS (Environment, GET, POST, Cookie, Server) bulunmalıdır. Ayrıca php -d variables_order=EGPCS ile geçici olarak ayarı kontrol edebilirsiniz.
  • Ortam değişkeni önceden tanımlı: Sunucu (ör. Apache, Nginx) bazı değişkenleri zaten tanımlayabilir. Çakışmayı önlemek için .env dosyasındaki anahtarları benzersiz bir ön ek (MS_ gibi) ile adlandırın.
  • Production’da .env dosyası eksik: Gerçek sunucularda .env dosyası yerine sunucu ortam değişkenlerini (Docker, Kubernetes, CI/CD pipeline) doğrudan ayarlamak daha güvenlidir. Dotenv sadece dosya yoksa hata vermez, ama $_ENV içinde değer bulunmaz.
  • Hata mesajları gizli bilgi sızdırıyor: PDO hatalarını doğrudan ekrana bastırmak yerine log dosyasına yönlendirin. PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION ve catch (Throwable $e) bloklarıyla kullanıcıya genel bir mesaj verin.

Özet

Bu derste, PHP projelerinde gizli bilgileri güvenli bir şekilde yönetmenin temellerini öğrendik. .env dosyaları, ortam değişkenleri ve vlucas/phpdotenv paketi sayesinde:

  • Gizli anahtarları koddan ayırdık.
  • Yerel geliştirme ve üretim ortamları arasında sorunsuz geçiş sağladık.
  • Versiyon kontrol sistemine hassas bilgilerin sızmasını önledik.
  • Ortam değişkenlerine erişimin en temiz ve test edilebilir yolunu uyguladık.

Uygulamanızın güvenliğini artırmak için aşağıdaki kontrol listesini her dağıtımda gözden geçirin.

  • .env dosyası .gitignore içinde mi?
  • Sunucu ortam değişkenleri doğru şekilde tanımlanmış mı?
  • php.ini içinde variables_order ayarı uygun mu?
  • Hata mesajları kullanıcıya gizli bilgi sızdırmayacak şekilde mi yapılandırılmış?
  • Üretim ortamında display_errors kapalı mı?

SSS

Soru 1: .env dosyasını doğrudan üretim sunucusuna koymalı mıyım?

Cevap: Genellikle önerilmez. Üretim ortamında .env dosyası yerine sunucu seviyesinde ortam değişkenleri (ör. Docker env, systemd, Apache SetEnv) tanımlanır. Bu, dosyanın yanlışlıkla sızmasını engeller.

Soru 2: putenv() yerine $_ENV kullanmak güvenli mi?

Cevap: $_ENV sadece okuma amaçlıdır; putenv() ise çalışma sürecinde değişken ekler. Çoğu durumda $_ENV üzerinden okuma yeterlidir ve kodun okunabilirliğini artırır.

Soru 3: .env dosyasında yorum satırı ekleyebilir miyim?

Cevap: Evet, # ya da ; ile başlayan satırlar yorum kabul edilir. Ancak, yorum satırları içinde = karakteri kullanmamaya dikkat edin.

Paylaş

Yorumlar

Henüz onaylanmış yorum yok. İlk yorumu siz yazın.

Yorum yaz

Yorumunuz yönetici onayından sonra yayınlanır.

İlgili yazılar

Ders 100 – İleri yol haritası

PHP serisinin son dersinde ileri seviye konular, framework seçimi, Composer ekosistemi, mikro pro…

Ders 99 – Güvenli yapılandırma kontrol listesi

Üretim ortamı için PHP yapılandırma ayarlarını adım adım kontrol eden, hatasız ve güvenli bir yap…

Ders 98 – OpCache ve performans ipuçları

OpCache'ın çalışma prensibi, yapılandırma adımları ve gerçek dünyada performans artırmak için pra…

Ders 97 – Fibers’a kısa bakış (PHP 8.1)

PHP 8.1 ile gelen Fibers özelliğini adım adım öğrenin, kooperatif concurrency kavramını kavrayın …

Demo
Büyütülmüş Görsel