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.
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?
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 komut satırı uygulamaları için kullanılır. |
|
|
PHP ve Apache web sunucusunu içerir. |
|
|
PHP-FPM üzerinden PHP işlemlerini yürütür. |
|
|
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:
-
Yeni bir container oluşturur.
-
Container'a
php-webismini verir. -
Apache web sunucusunu başlatır.
-
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?
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ı
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.







