PHP ile geliştirilen web uygulamalarında bazı işlemleri belirli zamanlarda veya belirli aralıklarla çalıştırmanız gerekir. E-posta gönderme, rapor oluşturma, veritabanı yedekleme, stok kontrolü gibi görevlerin çoğu manuel olarak tetiklendiğinde hem zaman kaybı olur hem de unutulma riski taşır. İşte bu noktada PHP otomasyon sistemleri devreye girer.

Bu yazıda PHP ile zamanlanmış görevlerin nasıl yönetileceğini, hangi araçların kullanılabileceğini ve projelerinizde nelere dikkat etmeniz gerektiğini anlatacağım. İster küçük bir betik çalıştırmak isteyin, ister karmaşık bir kuyruk sistemi kurun, burada işinize yarayacak pratik bilgiler bulacaksınız.

Zamanlanmış Görevler İçin İlk Seçenek: Cron

Sunucularda en yaygın kullanılan zamanlama aracı cron’dur. Linux ve macOS tabanlı sunucularda varsayılan olarak bulunur; Windows sunucularda ise Görev Zamanlayıcı (Task Scheduler) benzer işi görür. Cron, belirli zamanlarda komut çalıştırmanızı sağlayan bir servistir. PHP betikleri de bir komut satırı aracılığıyla çalıştırılabildiği için cron ile kolayca entegre olur.

Cron Sözdizimi ve Örnekler

Cron ifadeleri beş alandan oluşur: dakika, saat, ayın günü, ay, haftanın günü. Örneğin:

• Her dakika: * * * * *
• Her saat başı: 0 * * * *
• Her gece 02:30’da: 30 2 * * *
• Her pazartesi sabah 09:00’da: 0 9 * * 1

Cron satırı şu şekilde bir PHP betiğini çalıştırabilir:

php /path/to/script.php

Bu komut, script.php dosyasını PHP yorumlayıcısıyla çalıştırır. Web sunucusundan bağımsız olduğu için betik hatalarınız genellikle log dosyalarına işlenir. Bu yüzden cron kullanırken çıktıyı bir dosyaya yönlendirmek ya da e-posta ile almak iyi bir alışkanlıktır.

Cron için Dikkat Edilmesi Gerekenler

Betiklerinizin cron ile sorunsuz çalışması için birkaç noktayı göz önünde bulundurmalısınız:

• Sunucu saati: Cron zamanını sunucunun saat dilimi üzerinden hesaplar. Sunucu saati farklıysa, görevleriniz beklediğiniz saatte çalışmayabilir.
• Ortam değişkenleri: Komut satırında çalışan PHP, web sunucusundaki ortam değişkenlerini (örneğin PATH) devralmaz. Bu yüzden PHP yolunu mutlaka tam olarak belirtin.
• Çıktı yönetimi: Betiğinizin ürettiği çıktıyı bir log dosyasına yazın. Böylece hataları takip edebilirsiniz.
• Kaynak kullanımı: Aynı anda başka bir işlemle çakışmamak için zamanlamayı dikkatli seçin.

PHP Tarafında Zamanlama: Sleep, Loop ve Zaman Fonksiyonları

Cron kullanmadan, PHP betiğinin kendi içinde belirli aralıklarla çalışmasını sağlayabilirsiniz. Bu yaklaşım, sunucuya erişiminizin olmadığı durumlarda veya web tabanlı tetikleyicilerle çalışırken kullanışlıdır. Ancak bu yöntemi dikkatli kullanmak gerekir; çünkü uzun süre çalışan bir PHP betiği sunucu kaynaklarını tüketebilir.

sleep() ve usleep() ile Basit Döngüler

PHP’de sleep() komutu, betiği belirli saniye kadar duraklatır. Örneğin, her 5 dakikada bir çalışması gereken bir görevi şöyle kurgulayabilirsiniz:

while (true) {
    // Görevi çalıştır
    runTask();
    sleep(300); // 300 saniye bekle
}

Bu döngü, kesintiye uğramadığı sürece sonsuza kadar çalışır. Ancak betiğin ömrünü ve hata durumlarını yönetmek zorlaşır. Ayrıca set_time_limit() ile süre sınırını aşmanız gerekir. Bu yöntem genellikle önerilmez; çünkü işlem aniden sonlanırsa görev yarım kalır.

Zaman Fonksiyonları ile Akıllı Bekleme

Bazı durumlarda bir sonraki çalışma zamanını hesaplayıp time_sleep_until() gibi fonksiyonlarla bekleyebilirsiniz. Bu döngü, saat başı gibi belirli zamanlarda çalışacak şekilde ayarlanabilir. Yine de bu yöntem, cron gibi işletim sistemi seviyesinde bir zamanlayıcının yerini tutmaz. Bu yüzden web uygulamalarında çoğunlukla cron ya da kuyruk sistemleri tercih edilir.

Web Tabanlı Tetikleyiciler: HTTP İstekleri ile Çalıştırma

Bir diğer yöntem, PHP betiğinizi bir URL üzerinden çalıştırmaktır. Bu, özellikle paylaşımlı hosting kullanıyorsanız ve cron erişiminiz yoksa işinize yarar. Ancak bu yöntemin güvenlik riskleri vardır. URL’nin herkes tarafından erişilebilir olması, görevinizi istenmeyen zamanlarda tetikleyebilir.

Güvenli Tetikleme

Güvenliği artırmak için aşağıdaki önlemleri alabilirsiniz:

• URL’ye tahmin edilmesi zor bir anahtar (token) ekleyin. Örneğin: https://site.com/cron.php?key=123456
• Betik içinde bu anahtarı kontrol edin.
• Yalnızca sunucu IP adresinden gelen istekleri kabul edin.
• HTTP Basic Authentication ekleyin.

Ayrıca, bir dış servis (uptime robot, cron jobs gibi) belirli aralıklarla bu URL’yi ziyaret edebilir. Böylece cron kullanmadan da otomasyonu sağlayabilirsiniz.

Görev Kuyruğu Sistemleri: Asenkron İşlemler için Profesyonel Çözüm

Cron ve basit döngüler, her görev için uygun değildir. Özellikle kullanıcı etkileşimi gerektiren ağır işlemlerde (örneğin e-posta gönderme, PDF üretme) kullanıcıyı bekletmemek için asenkron bir kuyruk sistemi kullanmak daha doğru olur. Kuyruk sistemleri, işleri listeleyip arka planda sırayla işleyen yapılardır. PHP tarafında en popüler araçlar şunlardır:

RabbitMQ ve Gearman

RabbitMQ, mesaj kuyruğu protokolü (AMQP) kullanan bir mesaj aracısıdır. İşleri bir kuyruğa gönderir, işçi (worker) süreçleri de bu kuyruktan işleri alıp çalıştırır. Gearman ise PHP kaynaklı da olsa artık çoklu dil desteği sunan bir iş dağıtım sistemi olarak bilinir. Her ikisi de ölçeklenebilir ve güvenilirdir; ancak kurulum ve yönetim maliyetleri vardır.

Redis ile Basit Kuyruk

Redis, liste veri yapıları sayesinde hafif bir kuyruk olarak da kullanılabilir. LPUSH ile iş ekleyip BRPOP ile iş alabilirsiniz. PHP’de predis veya phpredis kütüphaneleriyle bu yöntemi uygulamak mümkündür. Küçük projeler için RabbitMQ’ya göre daha az bağımlılık getirir.

Kuyruk sistemlerinin avantajı, işlerin anında alınması ve önceliklendirilebilmesidir. Ayrıca bir işçi süreci çökerse, kuyruktaki işler kaybolmaz; başka bir işçi devralabilir. Bu da hata toleransını artırır.

Kuyruk Sistemi Kurarken Dikkat Edilmesi Gerekenler

• İş yeniden deneme (retry) mantığı: Başarısız işleri belirli aralıklarla tekrar deneyin.
• Ölü mektup kuyruğu: Birkaç denemeden sonra başarısız olan işleri ayrı bir kuyruğa yönlendirin.
• İzleme: Kuyruk uzunluğunu ve işçi performansını izleyin.

Zamanlanmış Görevlerde Hata Yönetimi

Otomasyon sistemlerinde hatalar kaçınılmazdır. Görevinizin çalışmadığını fark etmemeniz, iş süreçlerinizi aksatabilir. Bu yüzden hata yönetimini otomasyonun bir parçası haline getirmelisiniz.

Loglama ve Bildirim

Her çalışmada bir log kaydı tutun. Log’a başlangıç ve bitiş zamanlarını, hata mesajlarını ve işin durumunu yazın. Ayrıca önemli hatalarda e-posta veya mesaj ile bildirim gönderin. PHP’de error_log() ile loglama yapabilir, mail() veya API tabanlı e-posta servisleriyle bildirim gönderebilirsiniz.

Loglama yaparken monolog gibi bir kütüphane kullanmak, farklı kanallara (dosya, veritabanı, e-posta) yazmayı kolaylaştırır. Örneğin, kritik bir görev başarısız olduğunda yöneticiye e-posta göndermek için farklı bir logger tanımlayabilirsiniz.

İstisna Yakalama

PHP’de tüm betiği try-catch bloğuna almak, öngörülemeyen hataları yakalamanızı sağlar. Böylece işlem yarıda kaldığında ne olduğunu anlayabilirsiniz. Ayrıca register_shutdown_function() ile kritik hatalarda son bir operasyon yapabilirsiniz.

try {
    runTask();
} catch (Exception $e) {
    logError($e->getMessage());
    notifyAdmin($e);
}

Unutmayın: Cron görevlerinde çıktıyı göremeyebilirsiniz. Bu yüzden her ihtimale karşı hataları kaydetmek şart.

Uzun Süren Görevler için Yönetim Stratejileri

Bazı görevler dakikalar, hatta saatler sürebilir. Bu tür görevlerde sunucu zamanaşımı (timeout) ve bellek limiti sorunlarıyla karşılaşabilirsiniz. İşte bu durumlar için bazı stratejiler:

Parçalara Bölme (Chunking)

Büyük bir veri kümesini işliyorsanız, tüm veriyi bir defada değil, parçalar halinde işleyin. Örneğin, 10.000 kayıt gönderecekseniz, her cron çalışmasında 100 kayıt işleyip bir sonraki adımı hatırlayın. Bu sayede betiğin çalışma süresi kısalır ve kaynak kullanımı düşer.

Önbellek Kullanımı

Tekrarlayan hesaplamaları önbelleğe almak, görev süresini ciddi şekilde azaltır. APC, Redis veya Memcached gibi araçlarla sık kullanılan verileri bellekte tutabilirsiniz. Bu, veritabanı yükünü azaltır ve yanıt sürelerini iyileştirir.

Çalışma Süresi ve Bellek Limitlerini Ayarlama

Komut satırından çalışan PHP betiklerinde set_time_limit(0) ile süre sınırını kaldırabilirsiniz. Ancak bu, betiğin sonsuza kadar çalışabileceği anlamına gelir. Bu durumda, görev içinde ilerlemeyi bir veritabanına kaydetmek, kesinti durumunda kaldığı yerden devam etmenizi sağlar.

set_time_limit(0);
ini_set('memory_limit', '512M');

Bellek limitini artırmak, özellikle büyük dizilerle çalışırken önemlidir. Ancak bu limitleri bilinçli artırın; aksi halde sunucunun genel performansını etkileyebilirsiniz.

PHP Otomasyonunda Güvenlik

Otomasyon sistemleri, sunucuya yeni bir saldırı yüzeyi ekler. Özellikle web tabanlı tetikleyiciler ve dış servisler söz konusu olduğunda güvenlik önlemleri kritik hale gelir.

Yetkilendirme

Komut satırında çalışan betikler, web isteklerine göre daha güvenlidir; çünkü dış erişime kapalıdır. Cron ile çalışan betiklerin sadece sunucu içinde çalıştığından emin olun. Eğer URL tabanlı tetikleme kullanıyorsanız, mutlaka bir anahtar/şifre kontrolü yapın.

Girdi Doğrulama

Otomasyon betiği dış dünyadan veri alıyorsa (örneğin bir API’den), bu verileri doğrulayın ve temizleyin. Aksi halde enjeksiyon saldırılarına açık olursunuz. PHP’de htmlspecialchars() ve veritabanı sorgularında hazır ifadeler kullanın.

Kendi Zamanlama Sınıfınızı Yazmak

Cron ve hazır kuyruk sistemleri dışında, basit bir zamanlama sınıfı yazmak da mümkündür. Bu, tamamen ihtiyaçlarınıza göre şekillendirebileceğiniz esnek bir çözüm sunar. Örneğin, bir dosyada görev tanımlarını tutabilir ve bu dosyayı okuyan bir betik, hangi görevin ne zaman çalışacağını belirler.

class TaskScheduler {
    private $tasks;

    public function register($name, $interval, $callback) {
        $this->tasks[$name] = [
            'interval' => $interval,
            'next_run' => time(),
            'callback' => $callback
        ];
    }

    public function run() {
        foreach ($this->tasks as $name => &$task) {
            if (time() >= $task['next_run']) {
                call_user_func($task['callback']);
                $task['next_run'] = time() + $task['interval'];
            }
        }
    }
}

Bu sınıf, her tetiklendiğinde üzerinden geçen süreyi kontrol eder; süre dolmuşsa görevi çalıştırır. Bu yöntem, özellikle cron kullanmak istemeyen veya daha fazla kontrol isteyen geliştiriciler için idealdir. Yine de bu betiğin sürekli çalışması gerektiğini unutmayın; bunu da cron ile saat başı çalıştırabilirsiniz.

Gerçek Hayattan Bir Senaryo: E-posta Raporlama

Diyelim ki her gün sabah 08:00’de önceki günün satış raporunu e-posta ile gönderen bir sistem kurmak istiyorsunuz. İşte adım adım yapmanız gerekenler:

1. Satış verilerini veritabanından çeken bir fonksiyon yazın.
2. Bu verileri HTML formatında bir e-posta şablonuna yerleştirin.
3. Sunucuda mail ayarlarınızın çalıştığından emin olun. SMTP kullanmak daha güvenilirdir; PHPMailer gibi bir kütüphane bu işi kolaylaştırır.
4. Raporu gönderen bir PHP betiği oluşturun ve cron’a ekleyin: 0 8 * * * php /path/to/daily-report.php
5. Betik içinde hata yakalama ve loglama yapın.

Bu örnekte e-posta yanıt süresi kullanıcıyı beklemediği için kuyruk sistemi kullanmaya gerek yok. Ancak aynı anda binlerce e-posta gönderecekseniz, kuyruk sistemleri daha sağlıklı bir tercih olur.

Cron ile Webhook Arasında Seçim Yapma

Bazen bir görevin tetiklenmesi için belirli bir zaman değil, bir olayın gerçekleşmesi gerekebilir. Bu gibi durumlarda zamanlama yerine webhook veya olay dinleyicileri kullanmak daha mantıklıdır. Örneğin, bir kullanıcı kaydolduğunda hoş geldin e-postası göndermek için cron beklemenize gerek yok; kayıt işlemi içinde e-postayı gönderebilirsiniz. Ya da bir ödeme tamamlandığında faturalandırma sürecini başlatabilirsiniz.

Cron, sabit zamanlarda tekrarlayan görevler için idealdir. Webhook ise anlık olaylara tepki vermek için kullanılır. İkisini birlikte kullanmak da mümkündür: olay meydana geldiğinde bir iş kuyruğuna ekleyin, zamanlanmış bir işçi de bu işleri işlesin. Bu sayede görevin hemen çalışmasını garanti ederken, ağır işleri arka planda yürütebilirsiniz.

Performans İyileştirme İpuçları

Otomasyon sistemlerinin performansı, sunucu kaynaklarını verimli kullanmasına bağlıdır. Aşağıdaki iyileştirmeleri uygulayarak yükü azaltabilirsiniz:

• Gereksiz veritabanı sorgularından kaçının. Sorguları toplu olarak paketleyin.
• Ağır işlemleri önbelleğe alın.
• Görevleri mümkün olduğunca bağımsız çalıştırın; birinin başarısızlığı diğerini etkilemesin.
• Kuyruk sistemlerinde işçi sayısını dinamik olarak ayarlayın. Aynı anda fazla işçi çalıştırmak bellek tüketimini artırır.

Sık Yapılan Hatalar ve Kaçınılması Gerekenler

Tecrübelerime dayanarak, PHP otomasyonunda sıkça karşılaşılan bazı hataları şöyle sıralayabilirim:

• Logları takip etmemek: Görev başarısız olmasına rağmen fark edilmez.
• Zaman dilimi karışıklığı: Sunucu saati UTC iken sen yerel saati düşünürsün.
• Bellek sızıntıları: Döngülerde büyük diziler oluşturup serbest bırakmamak.
• Güvenliği düşünmemek: URL tabanlı tetikleyicileri korumasız bırakmak.

Bu hataları önlemek için her görevi planlarken sadece işlevselliği değil, sürekliliği de düşünmenizi öneririm. Otomasyon zamanla büyüyebilir; bu yüzden erken aşamada iyi bir altyapı kurmak size avantaj sağlar.

Toparlarsak

PHP otomasyon sistemleri, doğru araçlarla kurulduğunda iş yükünüzü hafifletir ve hataları azaltır. İster cron gibi sistem seviyesinde bir zamanlayıcı kullanın, ister kendi döngünüzü yazın, ister profesyonel bir kuyruk sistemi kurun; görevinizin ihtiyacına göre en uygun yöntemi seçmek önemlidir.

Küçük projeler için cron ve basit bir PHP betiği yeterli olabilirken, büyük ve ölçeklenebilir sistemlerde kuyruk mimarileri daha sürdürülebilir bir çözüm sunar. Hangi yöntemi seçerseniz seçin, hata yönetimini ve güvenliği ihmal etmeyin.

Eğer siz de bir otomasyon kurmayı düşünüyorsanız, önce ihtiyaçlarınızı netleştirin. Göreviniz gerçekten zamana mı bağlı, yoksa bir olaya mı? Bu sorunun cevabı, doğru mimariye karar vermenizi sağlar. Sonrasında bu yazıdaki önerileri adım adım uygulayarak sağlam bir sistem kurabilirsiniz.