docs/fr/user/installation.rst

   1 Installer wallabag
   2 ==================
   3
   4 Pré-requis
   5 ------------
   6
   7 wallabag est compatible avec php >= 5.5
   8
   9 Vous aurez besoin des extensions suivantes pour que wallabag fonctionne. Il est possible que certaines de ces extensions soient déjà activées dans votre version de php, donc vous n'avez pas forcément besoin d'installer tous les paquets correspondants.
  10
  11 - php-session
  12 - php-ctype
  13 - php-dom
  14 - php-hash
  15 - php-simplexml
  16 - php-json
  17 - php-gd
  18 - php-mbstring
  19 - php-xml
  20 - php-tidy
  21 - php-iconv
  22 - php-curl
  23 - php-gettext
  24 - php-tokenizer
  25
  26 wallabag utilise PDO afin de se connecter à une base de données, donc vous aurez besoin d'une extension et d'un système de bases de données parmi :
  27
  28 - php-pdo_mysql
  29 - php-pdo_sqlite
  30 - php-pdo_pgsql
  31
  32 Installation
  33 ------------
  34
  35 wallabag utilise un grand nombre de bibliothèques pour fonctionner. Ces bibliothèques doivent être installées à l'aide d'un outil nommé Composer. Vous devez l'installer si ce n'est déjà fait.
  36
  37 Installation de Composer :
  38
  39 ::
  40
  41     curl -s http://getcomposer.org/installer | php
  42
  43 Vous pouvez trouver des instructions spécifiques ici (en anglais) : __ https://getcomposer.org/doc/00-intro.md
  44
  45 Pour installer wallabag, vous devez exécuter ces deux commandes :
  46
  47 ::
  48
  49     git clone https://github.com/wallabag/wallabag.git
  50     cd wallabag
  51     git checkout 2.0.0-beta.2
  52     SYMFONY_ENV=prod composer install --no-dev -o --prefer-dist
  53     php bin/console wallabag:install --env=prod
  54
  55 Pour démarrer le serveur interne à php et vérifier que tout s'est installé correctement, vous pouvez exécuter :
  56
  57 ::
  58
  59     php bin/console server:run --env=prod
  60
  61 Et accéder wallabag à l'adresse http://lipdevotreserveur:8000
  62
  63 Installation avec Apache
  64 ------------------------
  65
  66 En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag et que vous utilisiez php comme un module Apache, voici un vhost pour wallabag :
  67
  68 ::
  69
  70     <VirtualHost *:80>
  71         ServerName domain.tld
  72         ServerAlias www.domain.tld
  73
  74         DocumentRoot /var/www/wallabag/web
  75         <Directory /var/www/wallabag/web>
  76             AllowOverride None
  77             Order Allow,Deny
  78             Allow from All
  79
  80             <IfModule mod_rewrite.c>
  81                 Options -MultiViews
  82                 RewriteEngine On
  83                 RewriteCond %{REQUEST_FILENAME} !-f
  84                 RewriteRule ^(.*)$ app.php [QSA,L]
  85             </IfModule>
  86         </Directory>
  87
  88         # uncomment the following lines if you install assets as symlinks
  89         # or run into problems when compiling LESS/Sass/CoffeScript assets
  90         # <Directory /var/www/wallabag>
  91         #     Options FollowSymlinks
  92         # </Directory>
  93
  94         # optionally disable the RewriteEngine for the asset directories
  95         # which will allow apache to simply reply with a 404 when files are
  96         # not found instead of passing the request into the full symfony stack
  97         <Directory /var/www/wallabag/web/bundles>
  98             <IfModule mod_rewrite.c>
  99                 RewriteEngine Off
 100             </IfModule>
 101         </Directory>
 102         ErrorLog /var/log/apache2/wallabag_error.log
 103         CustomLog /var/log/apache2/wallabag_access.log combined
 104     </VirtualHost>
 105
 106 Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
 107
 108 Installation avec Nginx
 109 -----------------------
 110
 111 En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag, voici un fichier de configuration Nginx pour wallabag :
 112
 113 ::
 114
 115     server {
 116         server_name domain.tld www.domain.tld;
 117         root /var/www/wallabag/web;
 118
 119         location / {
 120             # try to serve file directly, fallback to app.php
 121             try_files $uri /app.php$is_args$args;
 122         }
 123         location ~ ^/app\.php(/|$) {
 124             fastcgi_pass unix:/var/run/php5-fpm.sock;
 125             fastcgi_split_path_info ^(.+\.php)(/.*)$;
 126             include fastcgi_params;
 127             # When you are using symlinks to link the document root to the
 128             # current version of your application, you should pass the real
 129             # application path instead of the path to the symlink to PHP
 130             # FPM.
 131             # Otherwise, PHP's OPcache may not properly detect changes to
 132             # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
 133             # for more information).
 134             fastcgi_param  SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
 135             fastcgi_param DOCUMENT_ROOT $realpath_root;
 136             # Prevents URIs that include the front controller. This will 404:
 137             # http://domain.tld/app.php/some-path
 138             # Remove the internal directive to allow URIs like this
 139             internal;
 140         }
 141
 142         error_log /var/log/nginx/wallabag_error.log;
 143         access_log /var/log/nginx/wallabag_access.log;
 144     }
 145
 146 Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.