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.
- .env dosyasını oluşturun: Proje kök dizininizde
.envadı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 - Composer ile phpdotenv paketini ekleyin: Terminalde
composer require vlucas/phpdotenvkomutunu çalıştırın. Bu paket, .env dosyasını okuyup$_ENVve$_SERVERdizilerine otomatik olarak aktarır. - Bootstrap dosyanıza entegrasyonu ekleyin: Genellikle
public/index.phpya dabootstrap.phpdosyalarında aşağıdaki kod bloğunu ekleyin:
Bu kod, .env dosyasını proje kökünden okuyarak ortam değişkenlerini yükler.require __DIR__ . '/../vendor/autoload.php'; $dotenv = Dotenv\Dotenv::createImmutable(__DIR__ . '/../'); $dotenv->load(); - 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, ]); - .env dosyasını versiyon kontrolünden hariç tutun: Projenizin kökünde
.gitignoredosyasına.envsatı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_orderphp.ini ayarındaEGPCS(Environment, GET, POST, Cookie, Server) bulunmalıdır. Ayrıcaphp -d variables_order=EGPCSile 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.
Dotenvsadece dosya yoksa hata vermez, ama$_ENViç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_EXCEPTIONvecatch (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_orderayarı uygun mu? - Hata mesajları kullanıcıya gizli bilgi sızdırmayacak şekilde mi yapılandırılmış?
- Üretim ortamında
display_errorskapalı 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.
Yorumlar
Henüz onaylanmış yorum yok. İlk yorumu siz yazın.
Yorum yaz
Yorumunuz yönetici onayından sonra yayınlanır.