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 git@github.com:wallabag/wallabag.git
  50     cd wallabag
  51     git checkout 2.0.0-beta.2
  52     SYMFONY_ENV=prod composer install --no-dev
  53     php bin/console wallabag:install --env=prod
  54     php bin/console server:run --env=prod
  55
  56 Pour démarrer le serveur interne à php et vérifier que tout s'est installé correctement, vous pouvez exécuter :
  57
  58 ::
  59
  60     php bin/console server:run --env=prod
  61
  62 Et accéder wallabag à l'adresse http://lipdevotreserveur:8000
  63
  64 Installation avec Apache
  65 ------------------------
  66
  67 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 :
  68
  69 ::
  70
  71     <VirtualHost *:80>
  72         ServerName domain.tld
  73         ServerAlias www.domain.tld
  74
  75         DocumentRoot /var/www/wallabag/web
  76         <Directory /var/www/wallabag/web>
  77             AllowOverride None
  78             Order Allow,Deny
  79             Allow from All
  80
  81             <IfModule mod_rewrite.c>
  82                 Options -MultiViews
  83                 RewriteEngine On
  84                 RewriteCond %{REQUEST_FILENAME} !-f
  85                 RewriteRule ^(.*)$ app.php [QSA,L]
  86             </IfModule>
  87         </Directory>
  88
  89         # uncomment the following lines if you install assets as symlinks
  90         # or run into problems when compiling LESS/Sass/CoffeScript assets
  91         # <Directory /var/www/wallabag>
  92         #     Options FollowSymlinks
  93         # </Directory>
  94
  95         # optionally disable the RewriteEngine for the asset directories
  96         # which will allow apache to simply reply with a 404 when files are
  97         # not found instead of passing the request into the full symfony stack
  98         <Directory /var/www/wallabag/web/bundles>
  99             <IfModule mod_rewrite.c>
 100                 RewriteEngine Off
 101             </IfModule>
 102         </Directory>
 103         ErrorLog /var/log/apache2/wallabag_error.log
 104         CustomLog /var/log/apache2/wallabag_access.log combined
 105     </VirtualHost>
 106
 107 Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
 108
 109 Installation avec Nginx
 110 -----------------------
 111
 112 En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag, voici un fichier de configuration Nginx pour wallabag :
 113
 114 ::
 115
 116     server {
 117         server_name domain.tld www.domain.tld;
 118         root /var/www/wallabag/web;
 119
 120         location / {
 121             # try to serve file directly, fallback to app.php
 122             try_files $uri /app.php$is_args$args;
 123         }
 124         location ~ ^/app\.php(/|$) {
 125             fastcgi_pass unix:/var/run/php5-fpm.sock;
 126             fastcgi_split_path_info ^(.+\.php)(/.*)$;
 127             include fastcgi_params;
 128             # When you are using symlinks to link the document root to the
 129             # current version of your application, you should pass the real
 130             # application path instead of the path to the symlink to PHP
 131             # FPM.
 132             # Otherwise, PHP's OPcache may not properly detect changes to
 133             # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
 134             # for more information).
 135             fastcgi_param  SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
 136             fastcgi_param DOCUMENT_ROOT $realpath_root;
 137             # Prevents URIs that include the front controller. This will 404:
 138             # http://domain.tld/app.php/some-path
 139             # Remove the internal directive to allow URIs like this
 140             internal;
 141         }
 142
 143         error_log /var/log/nginx/wallabag_error.log;
 144         access_log /var/log/nginx/wallabag_access.log;
 145     }
 146
 147 Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.