Logiciel beta
Gardez à l’esprit que Flarum est un logiciel en version bêta. Cela signifie :
- Il contient des fonctionnalités incomplètes, des bugs :bugs: et
- À un moment ou un autre, il arrivera que ça casse ! :surprised:
Une version bêta est avant tout une étape qui permet de solutionner les problèmes rencontrés et améliorer Flarum. Nous sommes occupés à rendre Flarum meilleur alors nous vous demandons de :
- Ne pas l’utiliser dans un environnement de production. Nous ne pouvons pas fournir un support technique si les choses vont mal. Et les mises à jour vers les versions ultérieurs peuvent demander de mettre les mains dans le cambouis.
- Reportez les bogues de façon responsable. Les rapports de bugs mal écrits prennent beaucoup de temps à gérer, rendant l’ajout de fonctionnalités et le passage en version stable plus laborieux.
Avant d’installer Flarum, veuillez lire notre article sur les contributions afin de savoir dans quoi vous vous engagez.
Configuration système requise
Flarum utilise Composer pour gérer ses bibliothèques et extensions. Cela signifie que Flarum ne peut pas être installé sur des hébergement qui ne supportent pas le SSH (protocole de communication avec lignes de commandes). Soyez rassurer, dans le futur, Flarum n’aura plus besoin de cela et sera disponible pour le plus grand nombre.
Vous aurez besoin de plusieurs choses pour faire tourner Flarum :
* Un serveur web : Apache (avec le module mod_rewrite) ou Nginx
* PHP version 7.1 ou ultérieures avec les extensions suivantes : dom, gd, json, mbstring, openssl, pdo_mysql, tokenizer
* MySQL version 5.5 ou ultérieures ou MariaDB version 10.0.5 ou supérieures
* Accès aux commandes en ligne SSH
Installer Flarum
Flarum utilise Composer pour gérer ses bibliothèques et extensions. Vous devez l’installer sur votre serveur avant de mettre en place Flarum. Ensuite, lancez cette commande dans le répertoire où vous voulez Flarum installé :
composer create-project flarum/flarum . --stability=beta
Ensuite dans votre navigateur web, allez à l’adresse de vous forum fraichement installé et suivez les inscrutions pour finir l’installation.
Installer la langue française
Pour installer le paquet de langue française qui se trouve sur Packagist, veuillez lancer cette commande sur le Composer de votre serveur une fois Flarum installé, dans le même répertoire que ce dernier :
composer require flarum-lang/french
Cette même commande peut être utilisé pour mettre à jour le paquet de la langue française sans rien toucher d’autre. Notez que vu que le paquet de langue française sera rajouté comme bibliothèque de Flarum, il sera automatiquement mis à jour lorsque vous mettrez à jour Flarum et ses bibliothèques via Composer.
Réécriture d’URL (URL Rewriting)
Apache
Flarum inclut un fichier .htaccess
, vérifiez que celui-ci fut uploadé correctement. Si vous utilisez un hébergement mutualisé, vérifier avec votre hébergeur que le module mod_rewrite
est bien activé. Vous aurez peut être besoin de rajouter ce qui suit dans votre configuration Apache :
<Directory "/path/to/your/forum">
AllowOverride All
</Directory>
Nginx
Ajouter les lignes suivantes dans la configuration de votre serveur :
location / { try_files $uri $uri/ /index.php?$query_string; }
location /api { try_files $uri $uri/ /api.php?$query_string; }
location /admin { try_files $uri $uri/ /admin.php?$query_string; }
location /flarum {
deny all;
return 404;
}
location ~* \.php$ {
fastcgi_split_path_info ^(.+.php)(/.+)$;
fastcgi_pass unix:/var/run/php5-fpm.sock;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_param HTTP_PROXY ""; # Fix for https://httpoxy.org/ vulnerability
fastcgi_index index.php;
}
location ~* \.html$ {
expires -1;
}
location ~* \.(css|js|gif|jpe?g|png)$ {
expires 1M;
add_header Pragma public;
add_header Cache-Control "public, must-revalidate, proxy-revalidate";
}
gzip on;
gzip_http_version 1.1;
gzip_vary on;
gzip_comp_level 6;
gzip_proxied any;
gzip_types application/atom+xml
application/javascript
application/json
application/vnd.ms-fontobject
application/x-font-ttf
application/x-web-app-manifest+json
application/xhtml+xml
application/xml
font/opentype
image/svg+xml
image/x-icon
text/css
text/plain
text/xml;
gzip_buffers 16 8k;
gzip_disable "MSIE [1-6]\.(?!.*SV1)";
Lighttpd
Ajouter les lignes suivantes dans la configuration de votre serveur :
url.rewrite-if-not-file = (
"/admin.*" => "/admin.php",
"/api.*" => "/api.php",
"/.*" => "/index.php"
)
Configurer SMTP (protocole de communication)
Il n’y a pour l’instant aucun éditeur visuel pour configurer votre protocole SMTP (voir #258). Pour l’instant, vous pouvez entrer vos coordonnées manuellement dans les paramètres (settings
) dans la table de votre base de données avec un outil comme phpMyAdmin :
mail_driver: smtp
mail_host: ...
mail_from: ...
mail_port: ...
mail_username: ...
mail_password: ...
mail_encryption: ...
Importer des données
Nous avons dans l’optique de créer des outils pour importer vos données à partir d’autres logiciels de forum. Cependant, il est encore trop tôt pour réaliser ça : nous devons atteindre une version stable avant tout !
Lien vers la documentation anglophone : Installation.