docs/fr/user/installation.rst

   1 Installer wallabag
   2 ==================
   3
   4 Pré-requis
   5 ------------
   6
   7 wallabag est compatible avec PHP >= 5.5, PHP 7 inclus.
   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 - pdo_mysql
  29 - pdo_sqlite
  30 - 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
  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 .. note::
  64
  65     Pour définir des paramètres via des variables d'environnement, vous pouvez les spécifier avec le préfixe ``SYMFONY__``. Par exemple, ``SYMFONY__DATABASE_DRIVER``. Vous pouvez lire `documentation Symfony
  66 <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ pour en savoir plus.
  67
  68 Installation avec Apache
  69 ------------------------
  70
  71 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 :
  72
  73 ::
  74
  75     <VirtualHost *:80>
  76         ServerName domain.tld
  77         ServerAlias www.domain.tld
  78
  79         DocumentRoot /var/www/wallabag/web
  80         <Directory /var/www/wallabag/web>
  81             AllowOverride None
  82             Order Allow,Deny
  83             Allow from All
  84
  85             <IfModule mod_rewrite.c>
  86                 Options -MultiViews
  87                 RewriteEngine On
  88                 RewriteCond %{REQUEST_FILENAME} !-f
  89                 RewriteRule ^(.*)$ app.php [QSA,L]
  90             </IfModule>
  91         </Directory>
  92
  93         # uncomment the following lines if you install assets as symlinks
  94         # or run into problems when compiling LESS/Sass/CoffeScript assets
  95         # <Directory /var/www/wallabag>
  96         #     Options FollowSymlinks
  97         # </Directory>
  98
  99         # optionally disable the RewriteEngine for the asset directories
 100         # which will allow apache to simply reply with a 404 when files are
 101         # not found instead of passing the request into the full symfony stack
 102         <Directory /var/www/wallabag/web/bundles>
 103             <IfModule mod_rewrite.c>
 104                 RewriteEngine Off
 105             </IfModule>
 106         </Directory>
 107         ErrorLog /var/log/apache2/wallabag_error.log
 108         CustomLog /var/log/apache2/wallabag_access.log combined
 109     </VirtualHost>
 110
 111 Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
 112
 113 Installation avec Nginx
 114 -----------------------
 115
 116 En imaginant que vous vouliez installer wallabag dans le dossier /var/www/wallabag, voici un fichier de configuration Nginx pour wallabag :
 117
 118 ::
 119
 120     server {
 121         server_name domain.tld www.domain.tld;
 122         root /var/www/wallabag/web;
 123
 124         location / {
 125             # try to serve file directly, fallback to app.php
 126             try_files $uri /app.php$is_args$args;
 127         }
 128         location ~ ^/app\.php(/|$) {
 129             fastcgi_pass unix:/var/run/php5-fpm.sock;
 130             fastcgi_split_path_info ^(.+\.php)(/.*)$;
 131             include fastcgi_params;
 132             # When you are using symlinks to link the document root to the
 133             # current version of your application, you should pass the real
 134             # application path instead of the path to the symlink to PHP
 135             # FPM.
 136             # Otherwise, PHP's OPcache may not properly detect changes to
 137             # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
 138             # for more information).
 139             fastcgi_param  SCRIPT_FILENAME  $realpath_root$fastcgi_script_name;
 140             fastcgi_param DOCUMENT_ROOT $realpath_root;
 141             # Prevents URIs that include the front controller. This will 404:
 142             # http://domain.tld/app.php/some-path
 143             # Remove the internal directive to allow URIs like this
 144             internal;
 145         }
 146
 147         error_log /var/log/nginx/wallabag_error.log;
 148         access_log /var/log/nginx/wallabag_access.log;
 149     }
 150
 151 Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.