From: Nicolas Lœuillet Date: Tue, 3 May 2016 18:39:49 +0000 (+0200) Subject: Add LigHTTPd documentation X-Git-Tag: 2.0.4~3^2~5 X-Git-Url: https://git.immae.eu/?a=commitdiff_plain;h=e546a2d6eb3075b4c13f22cc0957bfc96b8e14d9;p=github%2Fwallabag%2Fwallabag.git Add LigHTTPd documentation Fix #1931 --- diff --git a/docs/en/user/installation.rst b/docs/en/user/installation.rst index 3057373c..3872ad3a 100644 --- a/docs/en/user/installation.rst +++ b/docs/en/user/installation.rst @@ -91,7 +91,7 @@ If you changed the database configuration to use MySQL or PostgreSQL, you need t Installation with Docker ------------------------ -We provide you a Docker image to install wallabag easily. Have a look to our repository on `Docker Hub `__ to have more information. +We provide you a Docker image to install wallabag easily. Have a look to our repository on `Docker Hub `__ to have more information. Command to launch container ~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -192,6 +192,45 @@ After reloading or restarting nginx, you should now be able to access wallabag a When you want to import large file into wallabag, you need to add this line in your nginx configuration ``client_max_body_size XM; # allows file uploads up to X megabytes``. +Configuration on LigHTTPd +~~~~~~~~~~~~~~~~~~~~~~~~~ + +Edit your ``lighttpd.conf`` file and paste this configuration into it: + +:: + + server.modules = ( + "mod_fastcgi", + "mod_access", + "mod_alias", + "mod_compress", + "mod_redirect", + "mod_rewrite", + ) + server.document-root = "/var/www/wallabag/web" + server.upload-dirs = ( "/var/cache/lighttpd/uploads" ) + server.errorlog = "/var/log/lighttpd/error.log" + server.pid-file = "/var/run/lighttpd.pid" + server.username = "www-data" + server.groupname = "www-data" + server.port = 80 + server.follow-symlink = "enable" + index-file.names = ( "index.php", "index.html", "index.lighttpd.html") + url.access-deny = ( "~", ".inc" ) + static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" ) + compress.cache-dir = "/var/cache/lighttpd/compress/" + compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" ) + include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port + include_shell "/usr/share/lighttpd/create-mime.assign.pl" + include_shell "/usr/share/lighttpd/include-conf-enabled.pl" + dir-listing.activate = "disable" + + url.rewrite-if-not-file = ( + "^/([^?])(?:\?(.))?" => "/app.php?$1&$2", + "^/([^?]*)" => "/app.php?=$1", + "^/wiki$" => "/app.php", + ) + Rights access to the folders of the project ------------------------------------------- diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst index 4645ef74..9039d608 100644 --- a/docs/fr/user/installation.rst +++ b/docs/fr/user/installation.rst @@ -74,7 +74,7 @@ La configuration par défaut utilise SQLite pour la base de données. Si vous so Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``. -.. caution:: Avec cette archive, wallabag ne vérifie pas si les extensions obligatoires sont présentes sur votre serveur pour bien fonctionner (ces vérifications sont faites durant le ``composer install`` quand vous avez un serveur dédié, voir ci-dessus). +.. caution:: Avec cette archive, wallabag ne vérifie pas si les extensions obligatoires sont présentes sur votre serveur pour bien fonctionner (ces vérifications sont faites durant le ``composer install`` quand vous avez un serveur dédié, voir ci-dessus). Exécutez cette commande pour télécharger et décompresser l'archive : @@ -82,7 +82,7 @@ Exécutez cette commande pour télécharger et décompresser l'archive : wget http://wllbg.org/latest-v2-package && tar xvf latest-v2-package -Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. +Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag. Si vous avez changé la configuration pour modifier le type de stockage (MySQL ou PostgreSQL), vous devrez vous créer un utilisateur via la commande ``php bin/console wallabag:install --env=prod``. Installation avec Docker @@ -189,6 +189,45 @@ Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir acc Si vous voulez importer un fichier important dans wallabag, vous devez ajouter cette ligne dans votre configuration nginx ``client_max_body_size XM; # allows file uploads up to X megabytes``. +Configuration avec LigHTTPd +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Éditez votre fichier ``lighttpd.conf`` collez-y cette configuration : + +:: + + server.modules = ( + "mod_fastcgi", + "mod_access", + "mod_alias", + "mod_compress", + "mod_redirect", + "mod_rewrite", + ) + server.document-root = "/var/www/wallabag/web" + server.upload-dirs = ( "/var/cache/lighttpd/uploads" ) + server.errorlog = "/var/log/lighttpd/error.log" + server.pid-file = "/var/run/lighttpd.pid" + server.username = "www-data" + server.groupname = "www-data" + server.port = 80 + server.follow-symlink = "enable" + index-file.names = ( "index.php", "index.html", "index.lighttpd.html") + url.access-deny = ( "~", ".inc" ) + static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" ) + compress.cache-dir = "/var/cache/lighttpd/compress/" + compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" ) + include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port + include_shell "/usr/share/lighttpd/create-mime.assign.pl" + include_shell "/usr/share/lighttpd/include-conf-enabled.pl" + dir-listing.activate = "disable" + + url.rewrite-if-not-file = ( + "^/([^?])(?:\?(.))?" => "/app.php?$1&$2", + "^/([^?]*)" => "/app.php?=$1", + "^/wiki$" => "/app.php", + ) + Droits d'accès aux dossiers du projet ------------------------------------- @@ -197,7 +236,7 @@ Environnement de test Quand nous souhaitons juste tester wallabag, nous lançons simplement la commande ``php bin/console server:run --env=prod`` pour démarrer l'instance wallabag et tout se passe correctement car l'utilisateur qui a démarré le projet a accès naturellement au repertoire courant, tout va bien. -Environnement de production +Environnement de production ~~~~~~~~~~~~~~~~~~~~~~~~~~~ Dès lors que nous utilisons Apache ou Nginx pour accéder à notre instance wallabag, et non plus la commande ``php bin/console server:run --env=prod`` pour la démarrer, il faut prendre garde à octroyer les bons droits aux bons dossiers afin de préserver la sécurité de l'ensemble des fichiers fournis par le projet.