aboutsummaryrefslogtreecommitdiffhomepage
path: root/docs/fr/user/installation.rst
diff options
context:
space:
mode:
Diffstat (limited to 'docs/fr/user/installation.rst')
-rw-r--r--docs/fr/user/installation.rst316
1 files changed, 0 insertions, 316 deletions
diff --git a/docs/fr/user/installation.rst b/docs/fr/user/installation.rst
deleted file mode 100644
index 442241e6..00000000
--- a/docs/fr/user/installation.rst
+++ /dev/null
@@ -1,316 +0,0 @@
1Installer wallabag
2==================
3
4Pré-requis
5------------
6
7wallabag est compatible avec **PHP >= 5.6**, PHP 7 inclus.
8
9.. note::
10
11 Pour installer wallabag facilement, nous avons créé un ``Makefile``, vous avez donc besoin d'avoir installé l'outil ``make``.
12
13wallabag utilise un grand nombre de bibliothèques PHP 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 et vous assurer que vous utilisez bien la version 1.2 (si vous avez déjà Composer, faite un ``composer selfupdate``).
14
15Installation de Composer :
16
17::
18
19 curl -s https://getcomposer.org/installer | php
20
21Vous pouvez trouver des instructions spécifiques `ici (en anglais) <https://getcomposer.org/doc/00-intro.md>`__.
22
23Vous 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.
24
25- php-session
26- php-ctype
27- php-dom
28- php-hash
29- php-simplexml
30- php-json
31- php-gd
32- php-mbstring
33- php-xml
34- php-tidy
35- php-iconv
36- php-curl
37- php-gettext
38- php-tokenizer
39- php-bcmath
40
41wallabag 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 :
42
43- pdo_mysql
44- pdo_sqlite
45- pdo_pgsql
46
47Installation
48------------
49
50Sur un serveur dédié (méthode conseillée)
51~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
52
53Pour installer wallabag, vous devez exécuter ces commandes :
54
55::
56
57 git clone https://github.com/wallabag/wallabag.git
58 cd wallabag && make install
59
60Pour démarrer le serveur interne à php et vérifier que tout s'est installé correctement, vous pouvez exécuter :
61
62::
63
64 make run
65
66Et accéder wallabag à l'adresse http://lipdevotreserveur:8000
67
68.. tip::
69 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 la `documentation Symfony <http://symfony.com/doc/current/cookbook/configuration/external_parameters.html>`__ pour en savoir plus.
70
71Sur un serveur mutualisé
72~~~~~~~~~~~~~~~~~~~~~~~~
73
74Nous mettons à votre disposition une archive avec toutes les dépendances à l'intérieur.
75La configuration par défaut utilise SQLite pour la base de données. Si vous souhaitez changer ces paramètres, vous devez modifier le fichier ``app/config/parameters.yml``.
76
77Nous avons déjà créé un utilisateur : le login et le mot de passe sont ``wallabag``.
78
79.. 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).
80
81Exécutez cette commande pour télécharger et décompresser l'archive :
82
83.. code-block:: bash
84
85 wget https://wllbg.org/latest-v2-package && tar xvf latest-v2-package
86
87Vous trouverez `le hash md5 du dernier package sur notre site <https://static.wallabag.org/releases/>`_.
88
89Maintenant, lisez la documentation ci-dessous pour crééer un virtual host. Accédez ensuite à votre installation de wallabag.
90Si 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``.
91
92Installation avec Docker
93~~~~~~~~~~~~~~~~~~~~~~~~
94
95Nous vous proposons une image Docker pour installer wallabag facilement. Allez voir du côté de `Docker Hub <https://hub.docker.com/r/wallabag/wallabag/>`__ pour plus d'informations.
96
97Commande pour démarrer le containeur
98^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
99
100.. code-block:: bash
101
102 docker pull wallabag/wallabag
103
104Installation sur Cloudron
105~~~~~~~~~~~~~~~~~~~~~~~~
106
107Cloudron permet d'installer des applications web sur votre serveur
108wallabag est proposé en tant qu'application Cloudron et est disponible directement depuis le store.
109
110`Installer wallabag sur Cloudron <https://cloudron.io/store/org.wallabag.cloudronapp.html>`__
111
112Virtual hosts
113-------------
114
115Configuration avec Apache
116~~~~~~~~~~~~~~~~~~~~~~~~~
117
118N'oubliez pas d'activer le mod *rewrite* de Apache
119
120.. code-block:: bash
121
122 a2enmod rewrite && systemctl reload apache2
123
124En 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 :
125
126::
127
128 <VirtualHost *:80>
129 ServerName domain.tld
130 ServerAlias www.domain.tld
131
132 DocumentRoot /var/www/wallabag/web
133 <Directory /var/www/wallabag/web>
134 AllowOverride None
135 Order Allow,Deny
136 Allow from All
137
138 <IfModule mod_rewrite.c>
139 Options -MultiViews
140 RewriteEngine On
141 RewriteCond %{REQUEST_FILENAME} !-f
142 RewriteRule ^(.*)$ app.php [QSA,L]
143 </IfModule>
144 </Directory>
145
146 # uncomment the following lines if you install assets as symlinks
147 # or run into problems when compiling LESS/Sass/CoffeScript assets
148 # <Directory /var/www/wallabag>
149 # Options FollowSymlinks
150 # </Directory>
151
152 # optionally disable the RewriteEngine for the asset directories
153 # which will allow apache to simply reply with a 404 when files are
154 # not found instead of passing the request into the full symfony stack
155 <Directory /var/www/wallabag/web/bundles>
156 <IfModule mod_rewrite.c>
157 RewriteEngine Off
158 </IfModule>
159 </Directory>
160 ErrorLog /var/log/apache2/wallabag_error.log
161 CustomLog /var/log/apache2/wallabag_access.log combined
162 </VirtualHost>
163
164.. tip:: Pour Apache 2.4, dans la section `<Directory /var/www/wallabag/web>` vous devez remplacer les directives suivantes :
165
166::
167
168 AllowOverride None
169 Order Allow,Deny
170 Allow from All
171
172
173par
174
175::
176
177 Require All granted
178
179
180
181
182Après que vous ayez rechargé/redémarré Apache, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
183
184Configuration avec Nginx
185~~~~~~~~~~~~~~~~~~~~~~~~
186
187En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag``, voici un fichier de configuration Nginx pour wallabag :
188
189::
190
191 server {
192 server_name domain.tld www.domain.tld;
193 root /var/www/wallabag/web;
194
195 location / {
196 # try to serve file directly, fallback to app.php
197 try_files $uri /app.php$is_args$args;
198 }
199 location ~ ^/app\.php(/|$) {
200 fastcgi_pass unix:/var/run/php5-fpm.sock;
201 fastcgi_split_path_info ^(.+\.php)(/.*)$;
202 include fastcgi_params;
203 # When you are using symlinks to link the document root to the
204 # current version of your application, you should pass the real
205 # application path instead of the path to the symlink to PHP
206 # FPM.
207 # Otherwise, PHP's OPcache may not properly detect changes to
208 # your PHP files (see https://github.com/zendtech/ZendOptimizerPlus/issues/126
209 # for more information).
210 fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
211 fastcgi_param DOCUMENT_ROOT $realpath_root;
212 # Prevents URIs that include the front controller. This will 404:
213 # http://domain.tld/app.php/some-path
214 # Remove the internal directive to allow URIs like this
215 internal;
216 }
217
218 # return 404 for all other php files not matching the front controller
219 # this prevents access to other php files you don't want to be accessible.
220 location ~ \.php$ {
221 return 404;
222 }
223
224 error_log /var/log/nginx/wallabag_error.log;
225 access_log /var/log/nginx/wallabag_access.log;
226 }
227
228Après que vous ayez rechargé/redémarré Nginx, vous devriez pouvoir avoir accès à wallabag à l'adresse http://domain.tld.
229
230.. tip::
231
232 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``.
233
234Configuration avec lighttpd
235~~~~~~~~~~~~~~~~~~~~~~~~~~~
236
237En imaginant que vous vouliez installer wallabag dans le dossier ``/var/www/wallabag``, voici un fichier de configuration pour wallabag (éditez votre fichier ``lighttpd.conf`` collez-y cette configuration) :
238
239::
240
241 server.modules = (
242 "mod_fastcgi",
243 "mod_access",
244 "mod_alias",
245 "mod_compress",
246 "mod_redirect",
247 "mod_rewrite",
248 )
249 server.document-root = "/var/www/wallabag/web"
250 server.upload-dirs = ( "/var/cache/lighttpd/uploads" )
251 server.errorlog = "/var/log/lighttpd/error.log"
252 server.pid-file = "/var/run/lighttpd.pid"
253 server.username = "www-data"
254 server.groupname = "www-data"
255 server.port = 80
256 server.follow-symlink = "enable"
257 index-file.names = ( "index.php", "index.html", "index.lighttpd.html")
258 url.access-deny = ( "~", ".inc" )
259 static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )
260 compress.cache-dir = "/var/cache/lighttpd/compress/"
261 compress.filetype = ( "application/javascript", "text/css", "text/html", "text/plain" )
262 include_shell "/usr/share/lighttpd/use-ipv6.pl " + server.port
263 include_shell "/usr/share/lighttpd/create-mime.assign.pl"
264 include_shell "/usr/share/lighttpd/include-conf-enabled.pl"
265 dir-listing.activate = "disable"
266
267 url.rewrite-if-not-file = (
268 "^/([^?])(?:\?(.))?" => "/app.php?$1&$2",
269 "^/([^?]*)" => "/app.php?=$1",
270 )
271
272Droits d'accès aux dossiers du projet
273-------------------------------------
274
275Environnement de test
276~~~~~~~~~~~~~~~~~~~~~
277
278Quand 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.
279
280Environnement de production
281~~~~~~~~~~~~~~~~~~~~~~~~~~~
282
283Dè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.
284
285Aussi, le dossier, connu sous le nom de ``DocumentRoot`` (pour apache) ou ``root`` (pour Nginx), doit être impérativement accessible par l'utilisateur de Apache ou Nginx. Le nom de cet utilisateur est généralement ``www-data``, ``apache`` ou ``nobody`` (selon les systèmes linux utilisés).
286
287Donc le dossier ``/var/www/wallabag/web`` doit être accessible par ce dernier. Mais cela ne suffira pas si nous nous contentons de ce dossier, et nous pourrions avoir, au mieux une page blanche en accédant à la page d'accueil du projet, au pire une erreur 500.
288
289Cela est dû au fait qu'il faut aussi octroyer les mêmes droits d'accès au dossier ``/var/www/wallabag/var`` que ceux octroyés au dossier ``/var/www/wallabag/web``. Ainsi, on règle le problème par la commande suivante :
290
291.. code-block:: bash
292
293 chown -R www-data:www-data /var/www/wallabag/var
294
295Il en est de même pour les dossiers suivants :
296
297* /var/www/wallabag/bin/
298* /var/www/wallabag/app/config/
299* /var/www/wallabag/vendor/
300
301en tapant
302
303.. code-block:: bash
304
305 chown -R www-data:www-data /var/www/wallabag/bin
306 chown -R www-data:www-data /var/www/wallabag/app/config
307 chown -R www-data:www-data /var/www/wallabag/vendor
308
309sinon lors de la mise à jour vous finirez par rencontrer les erreurs suivantes :
310
311
312.. code-block:: bash
313
314 Unable to write to the "bin" directory.
315 file_put_contents(app/config/parameters.yml): failed to open stream: Permission denied
316 file_put_contents(/.../wallabag/vendor/autoload.php): failed to open stream: Permission denied