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