Installation

Prérequis

Pour fonctionner, Azuriom nécessite simplement un serveur web avec PHP disposant d’au moins 100 MO d’espace disque ainsi que des prérequis suivants :

PHP 8.0 ou plus récent
Réécriture d’URL
Extension PHP BCMath
Extension PHP Ctype
Extension PHP JSON
Extension PHP Mbstring
Extension PHP OpenSSL
Extension PHP PDO
Extension PHP Tokenizer
Extension PHP XML
Extension PHP XMLWriter
Extension PHP cURL
Extension PHP Zip

Il est également très fortement recommandé de posséder une base de données MySQL/MariaDB ou PostgreSQL.

Installation des prérequis

Si vous utilisez un VPS ou un serveur dédié, il sera sûrement nécessaire d’installer vous-même un serveur web, PHP et MySQL, cela peut se faire par exemple avec les commandes suivantes :

apt update -y && apt upgrade -y

apt install -y nginx zip curl lsb-release apt-transport-https ca-certificates

wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" | tee /etc/apt/sources.list.d/php.list
apt update -y
apt install -y php8.0 php8.0-fpm php8.0-mysql php8.0-pgsql php8.0-sqlite3 php8.0-bcmath php8.0-mbstring php8.0-xml php8.0-curl php8.0-zip php8.0-gd

Une fois les prérequis installés, vous devez configurer le serveur web. Pour ce faire, des explications sont disponibles en bas de cette page.

Si vous préférez, vous pouvez aussi utiliser ce script non-officiel d’installation automatique qui installera tous les prérequis automatiquement (veillez simplement à le lancer uniquement sur un VPS qui vient d’être installé pour éviter d’éventuels conflits).

Hébergeurs

Azuriom peut être installé sur n’importe quel VPS ou serveur dédié ainsi que sur la majorité des hébergeurs web ayant les prérequis ci-dessus, cependant certains hébergeurs ne sont pas compatibles ou nécessitent des petites adaptations :

000webhost : Incompatible (La fonction putenv() est désactivée).
InovaPerf : Incompatible avec l’offre gratuite (La fonction fsockopen() est désactivée).
mTxServ : Incompatible (La fonction symlink() est désactivée).
LWS : Incompatible (La fonction symlink() est désactivée et la réécriture d’URL pose problème).
Ionos : En cas d’erreur 500 après l’installation, il faut simplement modifier le fichier .htaccess à la racine du site et rajouter RewriteBase / juste au-dessus de la ligne RewriteEngine On, ce qui doit donner quelque chose comme ça :
```
    ...
    </IfModule>

    RewriteBase /
    RewriteEngine On

    # Handle Authorization Header
    ...
```

Si vous recherchez un hébergeur web associatif abordable mais de qualité, nous vous recommandons notre partenaire NiHost !

Le code AZURIOM vous permet d’avoir une réduction de 10% sur vos services (hors domaines & TeamSpeak).

Installation

Azuriom propose un installateur automatique pour installer Azuriom facilement en suivant ces quelques étapes :

Azuriom peut également être installé avec Docker en suivant les étapes listées ici.

Télécharger la dernière version de l’installateur d’Azuriom sur notre site.
Extraire l’archive à la racine de votre site web.
Mettre les droits d’écriture à la racine du serveur web, par exemple avec cette commande :
```
chmod -R 755 /var/www/azuriom
```
(en remplaçant simplement /var/www/azuriom par l’emplacement du site)

Si l’utilisateur actuel n’est pas le même que l’utilisateur du serveur web, il peut être nécessaire de changer le propriétaire des fichiers, par exemple avec cette commande :
```
chown -R www-data:www-data /var/www/azuriom
```
(en remplaçant simplement /var/www/azuriom par l’emplacement du site et www-data par l’utilisateur du serveur web)
Se rendre sur votre site et suivre les étapes de l’installation.
(Optionnel) Mettre en place le scheduler : Certaines fonctionnalités ont besoin que le scheduler soit mis en place, pour cela vous devez configurer votre serveur pour que la commande php artisan schedule:run soit exécutée toutes les minutes, par exemple en ajoutant cette entrée Cron (n’oubliez pas de remplacer /var/www/azuriom par l’emplacement du site) :
```
* * * * * cd /var/www/azuriom && php artisan schedule:run >> /dev/null 2>&1
```
Cela peut être fait en modifiant la configuration de crontab avec la commande crontab -e.

Une fois l’installation terminée, afin d’éviter tout problème, veillez à ce que votre site ne soit pas accessible directement depuis l’IP de la machine (ex : http://0.0.0.0).

Environnement de développement

Si jamais Azuriom est installé en local pour du développement (par exemple pour faire des thèmes/plugins), il est très fortement recommandé d’activer le debug afin de simplifier le développement. Cela peut se faire très simplement en modifiant ces 2 lignes dans le .env à la racine du site :

APP_ENV=local
APP_DEBUG=true

Il est également recommandé de désactiver RocketBooster lors du développement.

Si jamais un est accessible publiquement, il est très fortement déconseillé d’activer le debug et de configurer l’environnement de développement.

Configuration du serveur web

Apache2

Si vous utilisez Apache2, il peut être nécessaire d’activer la réécriture d’URL.

Pour cela, commencez par activer le mod “rewrite” avec la commande suivante :

a2enmod rewrite

Ensuite vous pouvez configurer le site pour autoriser la réécriture d’URL. Il faut simplement modifier le fichier /etc/apache2/sites-available/000-default.conf et y ajouter les lignes suivantes entre les balises <VirtualHost> (en remplaçant var/www/azuriom par l’emplacement du site) :

<Directory "/var/www/azuriom">
    Options FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Pour finir, il faut juste redémarrer Apache2 :

service apache2 restart

Nginx

Si vous déployez Azuriom sur un serveur qui utilise Nginx, vous pouvez utiliser la configuration Nginx suivante pour que la réécriture d’URL soit considérée comme activée :

server {
    listen 80;
    server_name example.com;
    root /var/www/azuriom/public;

    add_header X-Frame-Options "SAMEORIGIN";
    add_header X-XSS-Protection "1; mode=block";
    add_header X-Content-Type-Options "nosniff";
    add_header Referrer-Policy "strict-origin-when-cross-origin";

    index index.html index.htm index.php;

    charset utf-8;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location = /favicon.ico { access_log off; log_not_found off; }
    location = /robots.txt  { access_log off; log_not_found off; }

    error_page 404 /index.php;

    location ~ \.php$ {
        fastcgi_pass unix:/var/run/php/php8.0-fpm.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
        include fastcgi_params;
    }

    location ~ /\.(?!well-known).* {
        deny all;
    }
}

Cette config doit être placée dans un site dans site-available et non dans le nginx.conf.

Pensez également à remplacer example.com par votre domaine, /var/www/azuriom par l’emplacement du site (sans enlever le /public de la ligne !) et php8.0 par votre version de PHP.