Chapitre: Configurer le serveur
| « Créer une application | ^ Mise en route | Utiliser jelix-scripts » |
− Table des matières
Dans ce chapitre nous allons voir comment configurer le serveur web.
Si vous installez votre application sur une machine sur laquelle vous n'avez pas la possibilité de configurer le serveur web, vous voudriez probablement modifier l'organisation des répertoires de l'application afin de ne pas avoir à indiquer le répertoire www de l'application dans l'url de l'application. Voyez alors le chapitre sur le changement des répertoires.
À propos de PHP ¶
La version minimale de PHP supportée par Jelix est la version 7.4, mais il est recommander d'utiliser PHP 8.
Il n'est pas indiqué ici comment installer et configurer PHP dans le serveur web. Voyez la documentation de PHP pour cela.
À propos des fichiers temporaires de Jelix ¶
À chaque fois que vous modifiez la configuration du serveur web pour
votre site, ou que vous mettez à jour votre appli, il faut supprimer les
fichiers temporaires de jelix (dans myapp/temp/ etc par ex), afin que
Jelix prenne en compte la nouvelle configuration.
Exemple :
sudo rm -rf myapp/temp/*
Configuration du serveur web ¶
Le principe de base de la configuration d'un serveur web, et d'indiquer
le répertoire myapp/www/ comme étant la racine du site. Cela peut se faire
soit en modifiant les fichiers de configuration du serveur web (un "virtual host")
soit via une interface d'administration comme le proposent certains hébergeurs,
Si votre application ne contient pas de répertoire www/jelix, alors
il faut aussi que le contenu de lib/jelix-www/ fournit avec Jelix soit
accessible depuis le web, via le chemin d'URL jelix/. Cela peut être un
alias définit dans la configuration serveur ou un lien symbolique dans le répertoire
www/.
Jelix nécessite également de pouvoir indiquer une partie "pathinfo" dans l'url, c'est à dire un chemin après le index.php. Il faut donc activer dans votre serveur web la prise en charge du pathinfo.
Dans Apache (au niveau de la configuration serveur ou dans le
.htaccess si cela est permis), il peut s'agir de l'option Multiview,
AcceptPathInfo ou encore MultiviewsMatch selon la version d'Apache.
Avec Nginx, il faut utiliser les directives fastcgi_split_path_info,
fastcgi_param PATH_INFO et fastcgi_param PATH_TRANSLATED.
Dans la suite, on posera l'hypothèse que vous installez les sources de votre
application myapp/ dans /srv/monsite/.
Configuration avec Apache ¶
Vous indiquerez dans un fichier monsite.com.conf, une configuration
qui ressemble à cela, avec la spécification du document root, et celle
de l'alias jelix si nécessaire :
<VirtualHost *>
ServerName www.monsite.com
# ----- Racine du site web
DocumentRoot /srv/monsite/myapp/www/
<Directory "/srv/monsite/myapp/www/">
AllowOverride None
Order allow,deny
Allow from all
# pour le PathInfo
Options +Multiviews
AcceptPathInfo on
# commentez cette ligne si vous utilisez Apache 2.2 ou inférieur
Require all granted
</Directory>
# définir les alias jelix, si il n'y a pas de répertoire myapp/www/jelix
# ----- Alias jelix vers jelix-wwww si Jelix est installé avec Composer
Alias /jelix/ "/srv/monsite/myapp/vendor/jelix/jelix/lib/jelix-www/"
<Directory "/srv/monsite/myapp/vendor/jelix/jelix/lib/jelix-www/">
AllowOverride None
Order allow,deny
Allow from all
# commentez cette ligne si vous utilisez Apache 2.2 ou inférieur
Require all granted
</Directory>
# ------ ou alias jelix vers jelix-wwww si Jelix n'est installé avec Composer
#Alias /jelix/ "/srv/monsite/lib/jelix-www/"
#<Directory "/srv/monsite/lib/jelix-www/">
# AllowOverride None
# Order allow,deny
# Allow from all
# Require all granted # pour apache 2.4+ uniquement
#</Directory>
</VirtualHost>
En ce qui concerne le PathInfo, pour Apache 2.4 et suivant, il faut également rajouter dans la configuration générale (dans un fichier dans conf.d/ ou conf-enabled/), la configuration suivante :
RemoveType .php
<Files "*.php">
MultiviewsMatch Any
</Files>
Configuration avec Nginx ¶
En général on utilise Nginx avec PHP-FPM, donc des paramètres propres à fastcgi. Et on définiera la racine du site, ainsi qu'un alias pour le chemin d'url "/jelix".
server {
listen 80;
server_name www.monsite.com;
index index.html index.php;
root /srv/monsite/myapp/www;
location / {
root /srv/monsite/myapp/www;
try_files $uri $uri/ =404;
}
# à supprimer si il y a un répertoire myapp/www/jelix
location /jelix/ {
alias /srv/monsite/myapp/vendor/jelix/jelix/lib/jelix-www/;
#ou pour une installation Sans composer:
#alias /srv/monsite/lib/jelix-www/;
}
location ~ [^/]\.php(/|$) {
fastcgi_split_path_info ^(.+\.php)(/.*)$;
# because of bug http://trac.nginx.org/nginx/ticket/321
set $path_info $fastcgi_path_info;
try_files $fastcgi_script_name =404;
fastcgi_index index.php;
fastcgi_pass unix:/var/run/php/php8.2-fpm.sock;
fastcgi_param PATH_INFO $path_info;
fastcgi_param PATH_TRANSLATED $document_root$path_info;
include fastcgi.conf;
}
}
Vérification de la configuration ¶
Avec votre navigateur, essayez d'accéder à http://www.monsite.com
mais aussi au contenu de jelix-www/, par exemple
http://www.monsite.com/jelix/design/jelix.css.
Pour vérifier que la configuration du PathInfo fonctionne, créez sur votre site
web un fichier myapp/www/test.php qui affiche phpinfo() et essayez l'url :
monsite.com/test/foo/bar. Le phpinfo devrait s'afficher, et vous devriez
avoir dans $_SERVER['PATH_INFO'] la chaine "/foo/bar".
Ajustement dans la configuration de Jelix ¶
Changement du nom de l'alias vers jelix-www ¶
Vous pouvez indiquer un autre nom que "jelix" pour l'alias. Vous devez
alors l'indiquer dans l'option jelixWWWPath dans le fichier de
configuration de l'application var/config/localconfig.ini.php, ou
app/system/mainconfig.ini.php, section urlengine.
Spécifier le basePath ¶
Il y a une option basePath dans la configuration de Jelix. Elle indique le chemin d'url jusqu'au index.php. En général, vous pouvez laisser cette option vide, Jelix la devinera tout seul. Sauf dans quelques cas :
- vous avez plusieurs points d'entrée dans des répertoires différents.
- vous spécifiez un alias vers le répertoire myapp/www,
Exemple avec un alias /superappli/ vers myapp/www.
basePath="/superappli/"
Droits sur les répertoires ¶
Vous devez donner le droit en écriture à l'utilisateur exécutant votre serveur
web au moins sur le répertoire var/log/, ainsi que le répertoire
temp/.
Exemple, sur un serveur debian/ubuntu :
sudo chown www-data:www-data myapp/temp/ myapp/var/log
sudo chmod g+w myapp/temp myapp/var/log
Peut être que pour certaines applications, il y a d'autres répertoires à
configurer de la sorte dans var/. Renseignez-vous dans la procédure
d'installation spécifique à cette application si il y en a une.
