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=productionveAPP_DEBUG=falseyapı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çingdya daimagick) 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.