Docker ile PHP Uygulaması Nasıl Çalıştırılır?

Docker, PHP uygulamalarının ihtiyaç duyduğu çalışma ortamını container içerisinde hazırlayarak uygulamaların farklı sistemlerde çalıştırılmasını sağlayan bir teknolojidir. Docker kullanılarak PHP, Apache, Nginx ve MySQL gibi bileşenler ayrı veya birlikte yapılandırılabilir.

Docker ile PHP uygulaması çalıştırmak için hazır PHP imajları kullanılabilir ya da uygulamanın ihtiyaçlarına göre özel bir Dockerfile hazırlanabilir.

Integrasi Layanan Apache2 (PHP) dan MySQL melalui Docker Compose untuk Komunikasi Antar Kontainer | by Panduridhofani | Medium

Docker ile PHP Çalıştırmak Nedir?

Docker ile PHP çalıştırmak, PHP yorumlayıcısının ve gerekli uygulama bağımlılıklarının bir Docker Container içerisinde çalıştırılmasıdır.

Geleneksel bir PHP geliştirme ortamında PHP, Apache veya Nginx gibi yazılımların bilgisayara ya da sunucuya kurulması gerekir.

Docker kullanımında ise bu bileşenler Docker imajları üzerinden hazırlanabilir.

Docker ile PHP çalıştırmanın temel özellikleri şunlardır:

  • PHP uygulamaları izole ortamlarda çalıştırılabilir.

  • Farklı PHP sürümleri ayrı container'larda kullanılabilir.

  • Apache veya PHP-FPM gibi çalışma ortamları yapılandırılabilir.

  • MySQL ve PostgreSQL gibi veritabanlarıyla bağlantı kurulabilir.

  • Geliştirme ortamları daha kolay yeniden oluşturulabilir.

  • Uygulama bağımlılıkları Dockerfile üzerinden yönetilebilir.

Docker PHP Image Nedir?

Introduction to PHP on Docker with Visual Studio Code - DEVSENSE Blog

Docker PHP Image, PHP uygulamalarını çalıştırmak için hazırlanmış bir Docker imajıdır.

Docker Hub üzerinde farklı PHP sürümlerine ve çalışma ortamlarına yönelik imaj çeşitleri bulunur.

Örnek imajlar:

Docker Image

Açıklama

php:8.3-cli

PHP komut satırı uygulamaları için kullanılır.

php:8.3-apache

PHP ve Apache web sunucusunu içerir.

php:8.3-fpm

PHP-FPM üzerinden PHP işlemlerini yürütür.

php:8.3-alpine

Alpine Linux tabanlı PHP imajıdır.

PHP imajı seçilirken uygulamanın gereksinimleri, desteklenen PHP sürümleri ve gerekli eklentiler dikkate alınmalıdır.

Docker ile PHP Uygulaması Nasıl Kurulur?

Docker üzerinde PHP çalıştırmak için öncelikle Docker Engine veya Docker Desktop kurulu ve çalışır durumda olmalıdır.

Örnek olarak Apache üzerinde çalışan basit bir PHP web uygulaması hazırlanabilir.

1. Proje Klasörü Oluşturma

Terminal üzerinden yeni bir klasör oluşturulur.

mkdir docker-php
cd docker-php

2. PHP Dosyası Oluşturma

Proje klasöründe index.php isimli dosya oluşturulur.

<?php
echo "<h1>Docker PHP Uygulamasi</h1>";
echo "<p>PHP uygulamasi Docker Container uzerinde calisiyor.</p>";
echo "<p>PHP Surumu: " . PHP_VERSION . "</p>";
?>

Bu PHP dosyası, tarayıcıda bir başlık, açıklama ve kullanılan PHP sürümünü görüntüler.

3. Dockerfile Oluşturma

Aynı klasörde Dockerfile isimli dosya oluşturulur.

FROM php:8.3-apache

WORKDIR /var/www/html

COPY index.php .

EXPOSE 80

Bu yapılandırmada:

  • FROM: PHP 8.3 ve Apache içeren temel imajı seçer.

  • WORKDIR: Web uygulamasının çalışma dizinini belirler.

  • COPY: PHP dosyasını container imajına ekler.

  • EXPOSE: HTTP için kullanılan 80 numaralı portu belgeler.

4. Docker Image Oluşturma

Hazırlanan Dockerfile üzerinden imaj oluşturulur.

docker build -t php-uygulamam:v1 .

Bu komut, php-uygulamam isimli ve v1 etiketli bir Docker Image oluşturur.

5. PHP Container Başlatma

Oluşturulan imajı çalıştırmak için:

docker run -d --name php-web -p 8080:80 php-uygulamam:v1

Bu komut:

  1. Yeni bir container oluşturur.

  2. Container'a php-web ismini verir.

  3. Apache web sunucusunu başlatır.

  4. Sunucunun 8080 portunu container'ın 80 portuna yönlendirir.

6. PHP Uygulamasını Tarayıcıda Açma

Container başarıyla çalıştırıldıktan sonra aynı bilgisayardaki tarayıcıdan aşağıdaki adres açılır:

 http://localhost:8080 

PHP uygulaması çalışıyorsa hazırlanan sayfa ve PHP sürüm bilgisi görüntülenir.

Docker ile PHP Dosyalarını Canlı Düzenleme

Docker Image oluşturulurken COPY komutuyla eklenen dosyalar, imajın oluşturulduğu andaki içerikleriyle saklanır.

Geliştirme sırasında her değişiklik için yeniden imaj oluşturmak yerine bind mount kullanılabilir.

Örnek:

docker run -d \
  --name php-gelistirme \
  -p 8081:80 \
  -v "$(pwd):/var/www/html" \
  php:8.3-apache

Bu örnekte:

  • Yerel proje klasörü container'a bağlanır.

  • PHP dosyalarında yapılan değişiklikler container içerisinden görülebilir.

  • Uygulama 8081 portu üzerinden erişilebilir hale gelir.

Bu komut Linux, macOS ve uygun Unix benzeri terminal ortamları için hazırlanmıştır. Windows PowerShell üzerinde klasör yolu belirtme biçimi farklı olabilir.

Bind mount kullanımı özellikle yerel geliştirme ortamlarında tercih edilir.

Docker ile PHP ve MySQL Nasıl Çalıştırılır?

DockerでのLAMP環境構築手順(Amazon Linux 2/PHP8.1(Laravel9)) ④Composerのインストール(全8回) #MySQL - Qiita

PHP uygulamalarında veritabanı işlemleri için MySQL kullanılabilir.

Docker üzerinde PHP ve MySQL servislerini birlikte çalıştırmak için Docker Compose kullanılabilir.

Bu yöntemle PHP ve MySQL ayrı container'larda çalışırken aynı Docker ağı üzerinden haberleşebilir.

1. Proje Yapısı

Örnek proje yapısı:

docker-php-mysql/
│
├── compose.yaml
├── Dockerfile
├── .env
│
└── www/
    └── index.php

2. Dockerfile Hazırlama

PHP uygulamasının MySQL bağlantısı kurabilmesi için gerekli PDO MySQL eklentisi etkinleştirilir.

FROM php:8.3-apache

RUN docker-php-ext-install pdo_mysql

WORKDIR /var/www/html

COPY www/ /var/www/html/

EXPOSE 80

Bu Dockerfile, PHP ve Apache içeren bir imaj oluşturur ve MySQL bağlantısı için pdo_mysql eklentisini kurar.

3. Docker Compose Dosyası Hazırlama

compose.yaml dosyası oluşturulur.

services:
  php:
    build: .
    ports:
      - "8080:80"
    volumes:
      - ./www:/var/www/html
    environment:
      DB_HOST: mysql
      DB_NAME: uygulama
      DB_USER: phpuser
      DB_PASSWORD: ${DB_PASSWORD}
    depends_on:
      mysql:
        condition: service_healthy

  mysql:
    image: mysql:8.4
    environment:
      MYSQL_ROOT_PASSWORD: ${MYSQL_ROOT_PASSWORD}
      MYSQL_DATABASE: uygulama
      MYSQL_USER: phpuser
      MYSQL_PASSWORD: ${DB_PASSWORD}
    volumes:
      - mysql_data:/var/lib/mysql
    healthcheck:
      test: ["CMD-SHELL", "mysqladmin ping -h localhost --silent"]
      interval: 10s
      timeout: 5s
      retries: 15
      start_period: 30s

volumes:
  mysql_data:

Bu yapılandırmada PHP ve MySQL ayrı servisler olarak tanımlanır.

MySQL verileri mysql_data isimli Docker volume içerisinde saklanır.

4. Ortam Değişkenlerini Tanımlama

Proje klasöründe .env dosyası oluşturulur.

MYSQL_ROOT_PASSWORD=buraya_guclu_root_parolasi
DB_PASSWORD=buraya_guclu_uygulama_parolasi

Bu değerler örnektir. Gerçek kullanımda güçlü ve benzersiz parolalar belirlenmelidir.

.env dosyası sürüm kontrolüne eklenmemelidir. Üretim ortamlarında gizli bilgilerin yönetimi için daha güvenli yöntemler değerlendirilmelidir.

5. PHP MySQL Bağlantısı Oluşturma

www/index.php dosyasına aşağıdaki PHP kodu yazılır.

<?php

$host = getenv('DB_HOST');
$dbname = getenv('DB_NAME');
$username = getenv('DB_USER');
$password = getenv('DB_PASSWORD');

try {
    $pdo = new PDO(
        "mysql:host=$host;dbname=$dbname;charset=utf8mb4",
        $username,
        $password,
        [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
        ]
    );

    echo "MySQL bağlantısı başarılı.";

} catch (PDOException $e) {
    http_response_code(500);
    error_log($e->getMessage());
    echo "Veritabanı bağlantısı kurulamadı.";
}

Bu kod, Docker ağı üzerindeki mysql servisine PDO aracılığıyla bağlanır.

Bağlantı hatasının teknik ayrıntıları ziyaretçiye gösterilmez; sunucu kayıtlarına yazılır.

6. PHP ve MySQL Servislerini Başlatma

Proje klasöründe aşağıdaki komut çalıştırılır:

docker compose up -d --build

Docker, PHP imajını oluşturur ve MySQL servisiyle birlikte çalıştırır.

Tarayıcı üzerinden:

 http://localhost:8080 

adresine erişildiğinde bağlantı başarılıysa PHP tarafından oluşturulan mesaj görüntülenir.

Docker PHP Container Yönetim Komutları

Docker üzerinde çalışan PHP uygulamalarını yönetmek için çeşitli komutlar kullanılabilir.

Çalışan container'ları listeleme:

docker ps

PHP container kayıtlarını görüntüleme:

docker logs php-web

Container içerisindeki PHP sürümünü kontrol etme:

docker exec php-web php -v

PHP container terminaline bağlanma:

docker exec -it php-web bash

Container durdurma:

docker stop php-web

Container yeniden başlatma:

docker start php-web

Docker Compose ile oluşturulan PHP ve MySQL servislerini durdurmak için:

docker compose down

Bu komut normal koşullarda Compose tarafından oluşturulan container'ları ve proje ağlarını kaldırır. Adlandırılmış volume'lar varsayılan olarak korunur.

Docker ile PHP Kullanırken Karşılaşılan Sorunlar

PHP Sayfasının Açılmaması

PHP uygulaması tarayıcıda görüntülenmiyorsa container'ın çalışıp çalışmadığı kontrol edilmelidir.

docker ps

Ayrıca port yönlendirmesinin doğru yapılandırıldığından emin olunmalıdır.

MySQL Bağlantı Hatası

PHP ve MySQL farklı container'larda çalışıyorsa PHP bağlantısında localhost yerine MySQL servis adı kullanılmalıdır.

Örnek:

$host = "mysql";

Ayrıca veritabanı kullanıcı adı, parola, veritabanı adı ve gerekli PHP eklentileri kontrol edilmelidir.

PHP Eklentilerinin Eksik Olması

PHP uygulamasının ihtiyaç duyduğu eklentiler Docker imajında bulunmayabilir.

Kurulu PHP eklentilerini görüntülemek için:

docker exec php-web php -m

Eksik eklentiler, uygun Dockerfile talimatlarıyla imaj oluşturma aşamasında kurulabilir.

Dosya İzinleri Sorunları

Container içerisinde çalışan web sunucusunun uygulama dosyalarını okuyabilmesi ve gerekli dizinlere yazabilmesi gerekir.

Dosya sahipliği ve izinleri, kullanılan işletim sistemi, bind mount ve container kullanıcısına göre yapılandırılmalıdır.

Docker ile PHP Kullanmanın Avantajları

Setting Up Nginx for Laravel: A Comprehensive Guide | by Vinayak Kalushe | Ortigan | Medium

Docker ile PHP uygulaması çalıştırmanın başlıca avantajları şunlardır:

  • Farklı PHP sürümleri ayrı container'larda çalıştırılabilir.

  • PHP uygulamalarının bağımlılıkları izole edilebilir.

  • Geliştirme ve test ortamları yeniden oluşturulabilir.

  • Apache, Nginx ve MySQL gibi servisler birlikte yönetilebilir.

  • Dockerfile ile uygulama ortamı standartlaştırılabilir.

  • Docker Compose ile çok servisli projeler hazırlanabilir.

  • Uygulamalar uyumlu Docker ortamlarına taşınabilir.

Docker ile PHP Çalıştırırken Dikkat Edilmesi Gerekenler

Docker üzerinde PHP uygulamaları hazırlanırken güvenlik ve veri yönetimi açısından bazı önlemler alınmalıdır.

  • Desteklenen ve güvenlik güncellemeleri alan PHP sürümleri tercih edilmelidir.

  • Üretim ortamlarında PHP hata ayrıntıları ziyaretçilere gösterilmemelidir.

  • Veritabanı parolaları kaynak koduna yazılmamalıdır.

  • MySQL gibi servislerin portları gereksiz yere dış erişime açılmamalıdır.

  • Kalıcı veriler için Docker volume kullanılmalıdır.

  • PHP uygulamalarının dosya izinleri doğru yapılandırılmalıdır.

  • Container imajları düzenli olarak güncellenmelidir.

  • Veritabanı ve uygulama verileri düzenli olarak yedeklenmelidir.

Sonuç

Docker, PHP uygulamalarının izole ve yeniden oluşturulabilir çalışma ortamlarında çalıştırılmasını sağlayan bir container teknolojisidir.

PHP ve Apache içeren hazır Docker imajlarıyla basit web uygulamaları çalıştırılabilir. Daha kapsamlı projelerde Dockerfile kullanılarak gerekli PHP eklentileri kurulabilir ve uygulamaya özel imajlar hazırlanabilir.

Docker Compose sayesinde PHP, MySQL ve diğer servisler tek bir yapılandırma dosyası üzerinden yönetilebilir.

Docker ile PHP kullanımı; web geliştirme, uygulama testleri, sunucu yönetimi ve yazılım dağıtım süreçlerinde uygulanabilen bir yöntemdir.

 


Alıntı