====== Installation de LinkAce ======

===== Prérequis =====

Avant de commencer, assurez-vous d'avoir installé les paquets suivants sur votre système:

  * PHP 8.0+
  * Composer
  * Nginx
  * MySQL/mariaDB
  * npm
  * Git

apt-get install php8-fpm

===== Création d'un utilisateur système =====

Pour gérer LinkAce, nous allons créer un utilisateur dédié:

<code>
sudo adduser veille
</code>

===== Création de la base de données =====

<code>
mysql_secure_installation
CREATE DATABASE linkace_db;
CREATE USER 'linkace_user'@'localhost' IDENTIFIED BY 'M0t2p@sse#';
GRANT ALL PRIVILEGES ON linkace_db.* TO 'linkace_user'@'localhost';
FLUSH PRIVILEGES;
exit;
</code>



===== Téléchargement de LinkAce =====

Passez à l'utilisateur veille et téléchargez LinkAce dans le répertoire /opt:


<code>
sudo su veille
cd /opt
git clone https://github.com/Kovah/LinkAce.git
</code>

===== Configuration de LinkAce =====

Déplacez-vous dans le répertoire LinkAce et installez les dépendances avec Composer:

<code>
cd LinkAce
composer install --no-dev --optimize-autoloader
</code>

Renommez le fichier .env.example en .env et mettez à jour les valeurs de configuration de la base de données et autres selon vos besoins.

===== Installation de LinkAce =====

Exécutez les commandes suivantes pour installer LinkAce:

<code>
php artisan key:generate
php artisan migrate
php artisan setup:app
npm install && npm run production
</code>

===== Configuration de Nginx =====

Modifiez votre fichier de configuration Nginx (par exemple /etc/nginx/sites-available/linkace) pour qu'il ressemble à ceci :

<code>

server {
listen 80;
listen [::]:80;

server_name localhost;

root /opt/LinkAce/public;
index index.php;

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

location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.0-fpm.sock;
}

location ~ /\.ht {
deny all;
}
}
</code>

Activez le site et redémarrez Nginx:

<code>
sudo ln -s /etc/nginx/sites-available/linkace /etc/nginx/sites-enabled/
sudo systemctl restart nginx
</code>

===== Configuration du service Systemd =====

Créez un nouveau fichier de demarrage /opt/LinkAce/linkace.sh :

<code>
#!/bin/bash
LINKACE_PATH=/opt/LinkAce
# Déplacez-vous vers le répertoire de LinkAce\
cd $LINKACE_PATH
# Exécutez la commande\
sudo -u veille npm run production\
</code>

Créez un nouveau fichier de service systemd à /etc/systemd/system/linkace.service et ajoutez le contenu suivant:

<code>


[Unit]
Description=Start LinkAce
After=network.target mariadb.service nginx.service php8.0-fpm.service

[Service]
ExecStart=/opt/LinkAce/linkace_start.sh
User=veille
Group=www-data

[Install]
WantedBy=multi-user.target
</code>

Activez le service et démarrez-le:

<code>
sudo systemctl enable linkace
sudo systemctlstart linkace
</code>

===== Correction des problèmes de permission =====

Si vous rencontrez des erreurs liées aux permissions, par exemple lors de l'exécution de npm run production, vous pouvez corriger ces problèmes en modifiant les permissions sur les dossiers concernés. Voici comment vous pouvez le faire :

<code>
sudo chown -R veille:www-data /opt/LinkAce/storage
sudo chown -R veille:www-data /opt/LinkAce/bootstrap/cache
sudo chmod -R 775 /opt/LinkAce/storage
sudo chmod -R 775 /opt/LinkAce/bootstrap/cache
</code>

===== Installation des extensions PHP requises =====

Si vous rencontrez des erreurs indiquant que certaines extensions PHP sont manquantes, vous pouvez les installer en utilisant les commandes suivantes. Remplacez "bcmath" par le nom de l'extension requise :

<code>
sudo apt install php-bcmath
sudo systemctl restart nginx
</code>

===== Lancement de LinkAce au démarrage =====

Si vous souhaitez que LinkAce se lance automatiquement au démarrage de votre serveur, vous pouvez activer le service systemd que nous avons créé précédemment :

<code>
sudo systemctl enable linkace
</code>

À ce stade, LinkAce devrait être installé et fonctionnel. Vous pouvez accéder à LinkAce en visitant le nom de domaine que vous avez configuré depuis le reverse proxy de Nginx.