# Kurulum

Uyarı

Flarum beta yazılımıdır. Bu, hala bazı eksik özelliklere ve hatalara sahip olduğu anlamına gelir 🐛🐞 ve bir noktada - er ya da geç - muhtemelen kırılacaktır! 💥

Beta, tamamen bu sorunları çözmek ve Flarum'u iyileştirmekle ilgilidir. Ne yaptığınızı bilmiyorsanız lütfen üretimde Flarum kullanmayın. İşler ters giderse sizi destekleyemeyiz. Sonraki sürümlere yükseltmek mümkün olacak, ancak ellerinizi kirletmeyi içerebilir.

Hızlı test?

Flarum'u gösteri forumlarımızdan (opens new window) birinde denemekten çekinmeyin. Veya Flarum ekibine bağlı olmayan ücretsiz bir topluluk hizmeti olan Free Flarum (opens new window)'da kendi forumunuzu birkaç saniye içinde kurun.

# Sunucu Gereksinimleri

Flarum'u kurmadan önce, sunucunuzun gereksinimleri karşılayıp karşılamadığını kontrol etmeniz önemlidir. Flarum'u çalıştırmak için şunlara ihtiyacınız olacak:

  • Apache (mod_rewrite etkin) veya Nginx
  • PHP 7.3+ şu uzantılar aktif olmalı: curl, dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer, zip
  • MySQL 5.6 + veya MariaDB10.0.5+ Composer'ı çalıştırmak için SSH (komut satırı) erişimi

Paylaşımlı Hosting

Bu aşamada, bir ZIP dosyası indirerek ve dosyaları web sunucunuza yükleyerek Flarum'u kurmanız mümkün değildir. Bunun nedeni, Flarum'un komut satırında çalışması gereken Composer (opens new window) adlı bir bağımlılık yönetim sistemi kullanmasıdır.

Bu mutlaka bir VPS'ye ihtiyacınız olduğu anlamına gelmez. Bazı paylaşılan ana bilgisayarlar size, Composer ve Flarum'u sorunsuz bir şekilde yükleyebilmeniz için SSH erişimi sağlar. SSH'siz diğer ana bilgisayarlar için Pockethold (opens new window) gibi geçici çözümleri deneyebilirsiniz.

# Yükleme

Flarum, bağımlılıklarını ve uzantılarını yönetmek için Composer (opens new window) kullanır. Flarum'u kurmadan önce, makinenize Composer'ı kurmanız (opens new window) gerekir. Daha sonra, bu komutu Flarum'un yüklenmesini istediğiniz boş bir konumda çalıştırın:

composer create-project flarum/flarum . --stability=beta

Bu komut çalışırken web sunucunuzu yapılandırabilirsiniz. Root klasörünüzü /path/to/your/forum/public olarak ayarlandığından emin olmanız ve aşağıdaki talimatlara göre [URL Yeniden Yazma] (# url-yeniden yazma) ayarlamanız gerekir.

Her şey hazır olduğunda, bir web tarayıcısında forumunuza gidin ve kurulumu tamamlamak için talimatları izleyin.

# URL Yönlendirme

# Apache

Flarum, public dizininde bir .htaccess dosyası içerir - doğru şekilde yüklendiğinden emin olun. mod_rewrite etkin değilse veya .htaccess e izin verilmiyorsa Flarum düzgün çalışmayacaktır. Bu özelliklerin etkin olup olmadığını barındırma sağlayıcınıza danışın. Kendi sunucunuzu yönetiyorsanız, .htaccess dosyalarını etkinleştirmek için site yapılandırmanıza aşağıdakileri eklemeniz gerekebilir:

<Directory "/path/to/flarum/public">
    AllowOverride All
</Directory>

Bu, htaccess geçersiz kılmalarına izin verilmesini sağlar, böylece Flarum URL'leri düzgün şekilde yeniden yazabilir.

mod_rewrite ı etkinleştirme yöntemleri işletim sisteminize bağlı olarak değişir. Ubuntu'da sudo a2enmod rewrite çalıştırarak etkinleştirebilirsiniz. CentOS'ta mod_rewrite varsayılan olarak etkindir. Değişiklikler yaptıktan sonra Apache'yi yeniden başlatmayı unutmayın!

# Nginx

Flarum bir .nginx.conf dosyası içerir - doğru şekilde yüklendiğinden emin olun. Ardından, Nginx içinde kurulmuş bir PHP siteniz olduğunu varsayarak, sunucunuzun yapılandırma bloğuna aşağıdakileri ekleyin:

include /path/to/flarum/.nginx.conf;

# Caddy

Caddy, Flarum'un düzgün çalışması için çok basit bir konfigürasyon gerektirir. URL'yi kendi URL'niz ile ve dizinide de kendi public klasörünüzün dizini ile değiştirmeniz gerektiğini unutmayın. PHP'nin farklı bir sürümünü kullanıyorsanız, doğru PHP yükleme soketinize veya URL'nize işaret etmek için fastcgi dizinini de değiştirmeniz gerekecektir.

www.example.com {
    root * /var/www/flarum/public
    try_files {path} {path}/ /index.php
    php_fastcgi / /var/run/php/php7.4-fpm.sock php
    header /assets {
        +Cache-Control "public, must-revalidate, proxy-revalidate"
        +Cache-Control "max-age=25000"
        Pragma "public" 
    }
    encode gzip
}

# Klasör Sahipliği

Kurulum sırasında Flarum, belirli dizinleri yazılabilir hale getirmenizi isteyebilir. Linux'ta bir dizine yazma erişimine izin vermek için aşağıdaki komutu yürütün:

chmod 775 /path/to/directory

Flarum hem dizine hem de içeriğine yazma erişimi isterse, dizin içindeki tüm dosyalar ve klasörler için izinlerin güncellenmesi için -R bayrağını eklemeniz gerekir:

chmod 775 -R /path/to/directory

Bu adımları tamamladıktan sonra, Flarum izinleri değiştirmenizi istemeye devam ederse, dosyalarınızın doğru gruba ve kullanıcıya ait olup olmadığını kontrol etmeniz gerekebilir.

Varsayılan olarak, çoğu Linux dağıtımında www-data hem PHP'nin hem de web sunucusunun altında çalıştığı grup ve kullanıcıdır. Çoğu Linux işletim sisteminde klasör sahipliğini, chown -R www-data:www-data foldername/ komutunu çalıştırarak değiştirebilirsiniz.

Linux'ta dosya izinleri ve sahipliğinin yanı sıra bu komutlar hakkında daha fazla bilgi edinmek için bu öğretici (opens new window)'yi okuyun . Windows'ta Flarum kuruyorsanız cevaplarınızı bulabilirsiniz, Bu Süper Kullanıcı sorusunun (opens new window) kullanışlı.

Ortamlar değişiklik gösterebilir

Ortamınız sağlanan belgelerden farklı olabilir, lütfen PHP ve web sunucusunun altında çalıştığı uygun kullanıcı ve grup için web sunucusu yapılandırmanıza veya web barındırma sağlayıcınıza danışın.

Asla izinlerde 777 kullanma

Bu izin düzeyi, kullanıcı veya gruptan bağımsız olarak herkesin klasör ve dosyanın içeriğine erişmesine izin verdiğinden, hiçbir klasör veya dosyayı asla 777 izin düzeyine ayarlamamalısınız.

# Dizinleri Özelleştirme

Varsayılan olarak Flarum'un dizin yapısı, yalnızca herkesin erişebileceği dosyaları içeren bir public dizini içerir. Bu, tüm hassas kaynak kodu dosyalarının web kökünden tamamen erişilemez olmasını sağlayan en iyi güvenlik uygulamasıdır.

Bununla birlikte, Flarum'u bir alt dizinde (siteniz.com/forum gibi) barındırmak isterseniz veya sunucunuz web kökünüz üzerinde kontrol sağlamazsa (public_html veya htdocs gibi), Flarum'u public dizini olmadan kurabilirsiniz.

Basitçe public dizini (.htaccess dahil) içindeki tüm dosyaları Flarum'a hizmet vermek istediğiniz dizine taşıyın. Daha sonra hassas kaynakları korumak için .htaccess i düzenleyin ve 9-15 satırlarının # işaretini kaldırın. Nginx için .nginx.conf un 8-11 satırlarının # işaretini kaldırın.

Ayrıca index.php dosyasını düzenlemeniz ve aşağıdaki satırı değiştirmeniz gerekecektir:

$site = require './site.php';

Son olarak, site.php dosyasını düzenleyin ve aşağıdaki satırlardaki yolları yeni dizin yapınızı yansıtacak şekilde güncelleyin:

'base' => __DIR__,
'public' => __DIR__,
'storage' => __DIR__.'/storage',

# Verileri İçe Aktarma

Mevcut bir topluluğunuz varsa ve sıfırdan başlamak istemiyorsanız, mevcut verilerinizi Flarum'a aktarabilirsiniz. Henüz resmi uzantı bulunmamakla birlikte, topluluk birkaç resmi olmayan uzantı yaptı:

Bunlar, önce phpBB'ye, sonra Flarum'a geçerek diğer forum yazılımları için de kullanılabilir. Bunların işe yarayacağını garanti edemeyeceğimizi ve onlar için destek sunamayacağımızı unutmayın.