Docker ile Symfony Projelerinde Veritabanı Bağlantı Sorunları Nasıl Çözülür? Adım Adım Rehber

Docker ve Symfony, yazılım geliştiricilerin sıkça tercih ettiği iki güçlü araçtır. Ancak, her şeyin mükemmel gittiğini düşündüğünüz bir anda, Docker ve Symfony kombinasyonuyla çalışırken beklenmedik veritabanı bağlantı sorunlarıyla karşılaşabilirsiniz. İşte bu yazı, tam olarak böyle anlarda size rehberlik etmek için yazıldı! Eğer veritabanı bağlantı sorunlarıyla boğuşuyorsanız, doğru yerdesiniz.

Docker, yazılım geliştirmeyi çok daha pratik ve taşınabilir hale getiriyor. Symfony ise PHP dünyasında tercih edilen bir framework. Ancak bu iki güçlü aracın birleşimi bazen karmaşık veritabanı bağlantı sorunlarını beraberinde getirebilir. Eğer Docker ile Symfony projelerinizde veritabanı bağlantı hatalarıyla karşılaşıyorsanız, yalnız değilsiniz.

Docker konteynerleri içinde çalışırken, Symfony’nin veritabanı bağlantısını doğru şekilde yapılandırmak bazen oldukça zorlayıcı olabilir. Symfony, doğru veritabanı yapılandırması yapılmadığı takdirde çeşitli hata mesajları verebilir. Bu hataların en yaygın olanları arasında şunlar yer alır:

- SQLSTATE[HY000] [1045] Access Denied for User: Bu hata genellikle veritabanı kullanıcı adı veya şifresinin doğru girilmemesi nedeniyle ortaya çıkar.
- SQLSTATE[HY000] [2002] No such file or directory: Symfony, Docker konteyneri içinde doğru bağlantıyı kuramadığında bu hatayı verebilir.
- PDOException: Veritabanı bağlantısı sırasında PHP'nin PDO (PHP Data Objects) ile yaptığı işlem sırasında meydana gelen hatalar bu şekilde görünür.

Şimdi, bu hataları nasıl çözeceğimize bakalım.

#### Adım 1: Veritabanı Bağlantı Bilgilerini Doğru Yapılandırın

İlk adım, Docker konteyneri içinde veritabanı bağlantı bilgilerinin doğru şekilde yapılandırıldığından emin olmaktır. Symfony projelerinde veritabanı bağlantısı genellikle `.env` dosyasına kaydedilir. Eğer veritabanınız Docker içinde çalışıyorsa, burada yazılı olan bilgiler de doğru olmalıdır.

Aşağıda örnek bir `.env` dosyası bağlantısı bulunmaktadır:

# .env dosyasındaki veritabanı bağlantısı örneği
DATABASE_URL=mysql://db_user:db_password@db_host:3306/db_name

Burada dikkat etmeniz gereken en önemli noktalar şunlardır:
- `db_user`: Docker'da tanımladığınız veritabanı kullanıcısı adı.
- `db_password`: Kullanıcı şifresi.
- `db_host`: Docker konteynerinin adı (bu genellikle Docker Compose kullanıyorsanız, `docker-compose.yml` dosyasındaki servis adı ile aynı olur).
- `db_name`: Veritabanı adı.

Docker Compose kullanıyorsanız, Docker konteynerlerinizin doğru şekilde iletişim kurabilmesi için `docker-compose.yml` dosyasının doğru yapılandırıldığından emin olmalısınız. Symfony ve MySQL'in aynı ağda olduğundan emin olun.

Örnek bir `docker-compose.yml` yapılandırması şu şekilde olabilir:

version: '3.7'
services:
  symfony:
    image: symfony:latest
    container_name: symfony_app
    ports:
      - "8000:8000"
    environment:
      - DATABASE_URL=mysql://db_user:db_password@db_host:3306/db_name
    networks:
      - app_network

  mysql:
    image: mysql:5.7
    container_name: mysql_db
    environment:
      MYSQL_ROOT_PASSWORD: root_password
      MYSQL_DATABASE: db_name
      MYSQL_USER: db_user
      MYSQL_PASSWORD: db_password
    networks:
      - app_network

networks:
  app_network:
    driver: bridge

Buradaki önemli noktalar:
- `mysql` servisi Symfony ile aynı ağda yer almalı.
- `db_host` burada `mysql` olmalıdır çünkü Symfony uygulamanız Docker konteyneri içinde bu isme ulaşacaktır.

Her şey doğru yapılandırıldıktan sonra, Symfony’de veritabanı bağlantısının doğru çalışıp çalışmadığını kontrol etmek için şu komutu çalıştırabilirsiniz:

php bin/console doctrine:database:create

Eğer bağlantı doğru kurulmuşsa, bu komut veritabanını başarıyla oluşturacaktır. Eğer bir hata alıyorsanız, hata mesajını dikkatlice inceleyin ve bağlantı bilgilerinizi yeniden kontrol edin.

Eğer hala sorun yaşıyorsanız, Docker konteynerlerinin loglarını kontrol etmek iyi bir fikir olabilir. Docker konteynerinin loglarını görmek için şu komutu kullanabilirsiniz:

docker logs mysql_db

Bu loglar, MySQL’in neden başlatılamadığını veya bağlantının neden kurulamıyor olabileceğini gösterebilir. Çoğu zaman, hatalar burada daha ayrıntılı şekilde belirtilecektir.

Symfony ile Docker kullanarak geliştirdiğiniz projelerde veritabanı bağlantı sorunlarını çözmek, doğru yapılandırmalar ve adım adım kontrol işlemleri ile oldukça basit hale gelir. Docker ve Symfony'nin her biri kendi başına güçlü araçlar olmasına rağmen, doğru entegrasyon sağlandığında sorunsuz çalışacaklardır.

Unutmayın, her zaman bağlantı bilgilerini dikkatlice kontrol edin, Docker konteynerlerinin doğru yapılandırıldığından emin olun ve gerekirse logları inceleyin. Adım adım bu süreci izlerseniz, veritabanı bağlantı hatalarını hızlı bir şekilde çözebilir ve Symfony projenizin tadını çıkarabilirsiniz!