Kurulum
:::ipucu Hızlı test sürüşü mü?
Flarum'u gösteri forumlarımızdan birinde denemekten çekinmeyin. Veya Flarum ekibine bağlı olmayan ücretsiz bir topluluk hizmeti olan Free Flarum'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ılara sahip: curl, dom, fileinfo, gd, json, mbstring, openssl, pdo_mysql, tokenizer, zip
- MySQL 5.6+/8.0.23+ veya MariaDB10.0.5+ Composer'ı çalıştırmak için SSH (komut satırı) erişimi
- SSH (command-line) access to run potentially necessary software maintenance commands, and Composer if you intend on using the command-line to install and manage Flarum extensions.
Yükleme
Installing by unpacking an archive
If you don't have SSH access to your server or you prefer not to use the command line, you can install Flarum by unpacking an archive. Below is a list of the available archives, make sure you choose the one that matches your PHP version and public path or lack thereof preference.
Installing using the Command Line Interface
Flarum, bağımlılıklarını ve uzantılarını yönetmek için Composer kullanır. Flarum'u kurmadan önce, makinenize Composer'ı kurmanız gerekir. Daha sonra, bu komutu Flarum'un yüklenmesini istediğiniz boş bir konumda çalıştırın:
composer create-project flarum/flarum .
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.
If you wish to install and update extensions from the admin dashboard, you need to also install the Extension Manager extension.
composer require flarum/extension-manager:*
Uzantı yöneticisi, yönetici kullanıcının herhangi bir besteci paketini yüklemesine olanak tanır. Uzantı yöneticisini yalnızca bu tür izinlere sahip tüm forum yöneticilerinize güveniyorsanız yükleyin.
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
php_fastcgi unix//var/run/php/php7.4-fpm.sock
header /assets/* {
+Cache-Control "public, must-revalidate, proxy-revalidate"
+Cache-Control "max-age=25000"
Pragma "public"
}
file_server
}
Klasör Sahipliği
Kurulum sırasında Flarum, belirli dizinleri yazılabilir hale getirmenizi isteyebilir. Modern işletim sistemleri genellikle çok kullanıcılıdır, yani oturum açtığınız kullanıcı ile Flarum'un çalıştığı kullanıcı aynı değildir. Flarum'un çalıştığı kullanıcı, aşağıdakiler için okuma + yazma erişimine sahip olmalıdır:
- Flarum'un
config.phpdosyasını düzenleyebilmesi için kök kurulum dizini. storagealt dizini, böylece Flarum günlükleri düzenleyebilir ve önbelleğe alınmış verileri saklayabilir.- Logoların ve avatarların dosya sistemine yüklenebilmesi için
assetsalt dizini.
Uzantılar başka dizinler gerektirebilir, bu nedenle Flarum kök kurulum dizininin tamamına tekrar tekrar yazma erişimi vermek isteyebilirsiniz.
Dosya izinlerini ayarlamak için çalıştırmanız gereken birkaç komut vardır. Yüklemeniz bunlardan yalnızca bazılarını yürüttükten sonra uyarı göstermiyorsa geri kalanını çalıştırmanıza gerek olmadığını lütfen unutmayın.
Öncelikle, dizine yazma erişimine izin vermeniz gerekir. Linux'ta:
chmod 775 -R /path/to/directory
Bu yeterli değilse, dosyalarınızın doğru grup 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. Emin olmak için dağıtım ve web sunucusu kurulumunuzun özelliklerini incelemeniz gerekir. Çoğu Linux işletim sisteminde klasör sahipliğini aşağıdakileri çalıştırarak değiştirebilirsiniz:
chown -R www-data:www-data /path/to/directory
Web sunucunuz için farklı bir kullanıcı/grup kullanılıyorsa, www-data başka bir şeye değiştirildi.
Ek olarak, uzantıları kurabilmeniz ve CLI aracılığıyla Flarum kurulumunu yönetebilmeniz için CLI kullanıcınızın (terminalde oturum açtığınız kişi) sahip olduğundan emin olmanız gerekir. Bunu yapmak için mevcut kullanıcınızı (whoami) usermod -a -G www-data YOUR_USERNAME aracılığıyla web sunucusu grubuna (genellikle www-data) ekleyin. Bu değişikliğin etkili olması için muhtemelen oturumu kapatıp tekrar açmanız gerekecek.
Son olarak, bu işe yaramazsa, web sunucusunun dizine yazmasına izin vermek için SELinux'u yapılandırmanız gerekebilir. Bunu yapmak için şunu çalıştırın:
chcon -R -t httpd_sys_rw_content_t /path/to/directory
Bu komutların yanı sıra Linux'ta dosya izinleri ve sahiplik hakkında daha fazla bilgi edinmek için bu öğreticiyi okuyun. Flarum'u Windows'ta kuruyorsanız, bu Süper Kullanıcı sorusunun yanıtlarını faydalı bulabilirsiniz.
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.
Herhangi bir klasör veya dosyayı asla 777 izin düzeyine ayarlamamalısınız. Çünkü bu izin düzeyi, kullanıcı veya gruptan bağımsız olarak herkesin klasör ve dosyanın içeriğine erişmesine izin verir.
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ına web kökünden tamamen erişilemez olmasını sağlayan en iyi güvenlik uygulamasıdır.
Ancak, Flarum'u bir alt dizinde (domain.tld/forum gibi) barındırmak istiyorsanız veya barındırıcınız size web kökünüz üzerinde kontrol sağlamıyorsa (gibi bir şeye takılıp kalırsınız) public_html veya htdocs, Flarum'u public dizini olmadan kurabilirsiniz.
If you intend to install Flarum using one of the archives, you can simply use the no-public-dir (Public Path = No) archives and skip the rest of this section. If you're installing via Composer, you'll need to follow the instructions below.
public dizini içindeki tüm dosyaları (.htaccess dahil) Flarum'a hizmet vermek istediğiniz dizine taşımanız yeterlidir. Ardından, hassas kaynakları korumak için .htaccess dosyasını düzenleyin ve 9-15 satırlarındaki açıklamaları kaldırın. Nginx için, .nginx.conf'un 8-11. satırlarındaki yorumları 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';
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',
Son olarak, config.php'yi kontrol edin ve url değerinin doğru olduğundan emin olun.
Verileri İçe Aktarma
Mevcut bir topluluğunuz varsa ve sıfırdan başlamak istemiyorsanız, mevcut verilerinizi Flarum'a aktarabilirsiniz. Henüz resmi bir ithalatçı olmasa da, topluluk birkaç resmi olmayan ithalatçı yaptı:
Bunlar, önce phpBB'ye, ardından Flarum'a geçirilerek diğer forum yazılımları için de kullanılabilir. Bunların çalışacağını garanti edemeyeceğimizi ve onlar için destek sağlayamayacağımızı unutmayın.