İçeriğe geç
zefıly
← Tüm yazılar

Statamic'i kendi sunucunuzda barındırmak: ne ister, nasıl kurulur

6 dk okuma

Statamic, içeriğini dosyalarda tutan bir Laravel uygulamasıdır. Bunun sunucu için anlamı. Yazılabilir olması gereken klasörler, nginx yapılandırması, önbellek, zamanlayıcı, yedekler ve dağıtım; Statamic 6 ile.

Statamic hakkında iki şeyi bildiğinizde onu barındırmak kolaydır. Bir Laravel uygulamasıdır; Laravel'in istediğini ister. Ve içeriğini dosyalarda tutar; veritabanı istemez, ama sıradan bir Laravel uygulamasından daha çok klasöre yazması gerekir.

Buradaki komutları 12 Kasım 2026'da yeni bir Statamic 6.41.0 projesiyle denedik; proje Laravel 13'ü kurdu ve PHP 8.5'te çalıştı.

Kısaca

  • Küçük bir VPS yeter. Çalıştırılacak veritabanı yoktur.
  • Web sunucusunu proje köküne değil, public/ klasörüne yönlendirin.
  • PHP kullanıcısı storage/, bootstrap/cache/, content/, users/ ve varlık klasörlerinize yazabilmelidir.
  • APP_ENV=production ve APP_DEBUG=false yapın, sonra Stache'i ısıtın.
  • Site çoğunlukla okunuyorsa statik önbelleği açın; en büyük farkı o yaratır.
  • Veritabanını değil, dosyaları yedekleyin. Ve geri yüklemeyi deneyin.

1. Sunucunun ihtiyacı

  • Olağan Laravel eklentileriyle PHP (mbstring, xml, curl, zip, bcmath, intl; görsel boyutlandırma için gd ya da imagick) ve Composer.
  • nginx, OpenLiteSpeed ya da Apache.
  • Node.js; yalnızca ön yüz dosyalarını sunucuda derliyorsanız.
  • MySQL yok, PostgreSQL yok. Yeni bir proje SQLite'ı yalnızca Laravel'in kendi küçük tabloları için kullanır; Statamic'in içeriği orada durmaz.

İzlenecek değer bellektir. Her PHP işçisi Laravel'i ve Statamic'i yükler. 2 GB'lık bir sunucu olağan bir siteyi rahat çalıştırır; statik önbellekle isteklerin çoğu PHP'ye hiç ulaşmaz.

2. Kodu sunucuya alın

Projeyi yerelde oluşturun, Git'e koyun ve sunucuda klonlayın:

composer create-project statamic/statamic my-site

Sunucuda, sitenin kendi Linux kullanıcısıyla:

git clone <deponuz> /home/mysite/app
cd /home/mysite/app
composer install --no-dev --optimize-autoloader
cp .env.example .env
php artisan key:generate

Sonra .env içinde şunları ayarlayın:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://example.com

Canlı sitede APP_DEBUG=true, hata tetikleyen herkese yapılandırmanızı gösterir. Yeni projede açık gelir; kapatın.

3. Web sunucusu

Belge kökü public/ klasörüdür. Geri kalan her şey (content/, users/, .env, vendor/) web'den erişilemez olmalıdır.

En küçük nginx server bloğu:

server {
    server_name example.com;
    root /home/mysite/app/public;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/run/php/php8.5-fpm-mysite.sock;
    }

    location ~ /\. { deny all; }
}

Siteyi kendi PHP-FPM havuzunda, kendi kullanıcısıyla çalıştırın. Havuz dosyası için Birden çok PHP sürümünü yan yana çalıştırmak yazısına bakın.

4. Yazılabilir klasörler

Statamic'in sıradan bir Laravel uygulamasından ayrıldığı yer burasıdır. Editör kontrol panelinde bir girdiyi kaydettiğinde Statamic bir dosya yazar. PHP kullanıcısının şuralara yazma izni olmalıdır:

Klasör Neden
storage/, bootstrap/cache/ Laravel'in önbellekleri, günlükleri ve oturumları
content/ girdiler, taksonomiler, global değerler, gezinme
users/ kullanıcı hesapları
resources/blueprints/, resources/fieldsets/, resources/forms/ editörler bunları kontrol panelinden değiştirdiğinde
varlık kapsayıcılarınız (çoğu zaman public/assets/) yüklemeler

En basit doğru kurulum: bütün proje sitenin Linux kullanıcısına aittir ve PHP-FPM aynı kullanıcıyla çalışır. O zaman chmod yapacak bir şey kalmaz. 777 asla kullanmayın.

5. İlk çalıştırma

php artisan storage:link
php artisan optimize
php please stache:warm
php please make:user

stache:warm, Statamic'in içerik dosyaları dizinini oluşturur. make:user kontrol paneli hesabınızı oluşturur; süper kullanıcı sorusuna evet deyin. Kontrol paneli /cp adresindedir.

6. Statik önbellek

Varsayılan olarak her sayfa görüntülemesi PHP'yi çalıştırır. Çoğunlukla okunan bir sitede Statamic bitmiş HTML'i kaydetsin.

.env içinde:

STATAMIC_STATIC_CACHING_STRATEGY=full

full stratejisiyle Statamic her sayfayı HTML dosyası olarak yazar ve web sunucusu onu PHP'yi başlatmadan sunar. Bunun için nginx önce dosyaya bakmalıdır. Kuralları Statamic belgeleri verir; özü şudur:

location / {
    try_files /static${uri}_$args.html $uri /index.php?$args;
}

Statamic belgelerinin statik önbellek sayfasındaki tam sürümü kullanın: o sürüm form gönderimlerini ve canlı önizleme isteklerini de PHP'ye yollar.

Her dağıtımdan sonra:

php please static:clear
php please static:warm

Yeniden yazma kurallarını kurmak şimdilik fazla geliyorsa half stratejisi sayfaları uygulamanın içinde önbelleğe alır. PHP yine çalışır, ama sayfa yeniden oluşturulmaz.

7. Zamanlayıcı ve kuyruk

Laravel'in zamanlayıcısını site kullanıcısının crontab'ına ekleyin:

* * * * * cd /home/mysite/app && /usr/bin/php8.5 artisan schedule:run >> /dev/null 2>&1

Statamic bunu, başka şeylerin yanında, zamanlanmış girdiler için kullanır. O olmadan, yarın sabaha tarihlenmiş bir girdi statik önbellekli sitede yarın sabah görünmez.

Kuyruk işçisi isteğe bağlıdır. Büyük bir statik önbelleği ısıtırken (php please static:warm --queue) ya da form e-postalarını arka planda gönderirken işe yarar.

8. Sunucudaki içerik değişiklikleri

Editörler içeriği canlı sitede değiştirir; yani canlı sunucuda Git deponuzda olmayan dosyalar vardır. Bunların nasıl geri döneceğine karar verin:

  • Statamic'in Git entegrasyonu içerik değişikliklerini sunucuda kendisi commit eder (STATAMIC_GIT_ENABLED=true) ve push edebilir (STATAMIC_GIT_PUSH=true). En temiz yol budur.
  • Ya da content/, users/ ve varlıkları veri sayın: dağıtımların dışında tutun ve veritabanı gibi yedekleyin.

Hangisini seçerseniz seçin, dağıtım content/ klasörünü dizüstü bilgisayarınızdaki eski kopyayla asla ezmemelidir.

9. Dağıtım

git pull
composer install --no-dev --optimize-autoloader
php artisan optimize
php please stache:warm
php please static:clear
php please static:warm

Statamic'in kendisini güncellemek için Statamic güvenle nasıl güncellenir yazısına bakın.

10. Yedekler

Veritabanı olmaması yedeği kolaylaştırır: proje klasörünü kopyalayın. Başka hiçbir yerde olmayan kısımlar content/, users/, varlıklar, storage/forms/ (form gönderimleri) ve .env dosyasıdır.

Bunları sunucu dışındaki bir depolamaya, zamanlanmış olarak kopyalayın ve bir kez bir deneme klasörüne geri yükleyin. Hiç geri yüklemediğiniz yedek, yedek değil umuttur.

Zefily ile

Zefily, Statamic'i kendi sunucunuza tek tıkla kurar: Composer projesini, site kullanıcısını, PHP havuzunu, nginx ya da OpenLiteSpeed için web sunucusu kurallarını, HTTPS'i ve süper kullanıcı hesabınızı oluşturur. Zamanlanmış görevler, hazırlık kopyaları ve kendi depolamanıza yedekler panelin parçasıdır. PHP uygulamaları belgesine bakın.

Sık sorulan sorular

Statamic veritabanı ister mi?

Hayır. Statamic girdileri, kullanıcıları ve ayarları dosyalarda tutar. Yeni bir proje SQLite'ı yalnızca Laravel'in birkaç tablosu için kullanır.

Statamic için web sunucusu hangi klasörü göstermeli?

Projenin public/ klasörünü. Proje kökü web'den erişilemez olmalıdır; çünkü .env, content/ ve users/ oradadır.

Statamic için hangi klasörler yazılabilir olmalı?

storage/, bootstrap/cache/, content/, users/, resources/ altındaki blueprint ve form klasörleri ve varlık klasörleriniz. En basit yol, PHP'yi projenin sahibi olan kullanıcıyla çalıştırmaktır.

Statamic ne kadar sunucu ister?

Veritabanı sunucusu olmadığı için olağan bir siteye küçük bir VPS yeter. Tam statik önbellekle sayfaların çoğu dosya olarak sunulur ve PHP hiç başlamaz.

Statamic'i nasıl hızlandırırım?

Statik önbelleği açın, her dağıtımdan sonra php please stache:warm ile Stache'i ısıtın ve php artisan optimize çalıştırın.

Zefily'nin kurduğu PHP sürümleri ve web sunucuları için Web yığını belgesine bakın.

Diğer yazılar

Muhteşem Kasım · Siber Pazartesi

Gitmeden önce: ömürlük paketler indirimde

Ömürlük paketi bir kez ödeyin ya da yıllık paketlerin ilk yılında %30 indirim alın.

Paket başına yalnızca 100 ömürlük paket satılır. Bitince biter.

Kampanyayı inceleyin

Muhteşem Kasım

Kampanyayı inceleyin →