vps-docs/hestiacp/chapitres/10-deployer-symfony.md

Déployer un projet Symfony

Exemple : déployer depuis GitHub un projet Symfony sur {{SITE}}, avec sa base {{CLIENT}}_app.

Avec HestiaCP, PHP-FPM, le cron et SSH tournent tous sous {{CLIENT}}. Il n'y a donc plus de cron de permissions sur var/cache, plus d'ACL et plus de chmod 777.

[!NOTE] Prérequis

• Le site {{SITE}} existe, avec SSL (chapitre 7).
• La base {{CLIENT}}_app existe (chapitre 8).
• La boîte noreply existe (chapitre 9).

Se connecter en tant que {{CLIENT}}

Depuis votre ordinateur :

ssh -p {{SSH_PORT}} {{CLIENT}}@{{IP}}

Toutes les commandes de ce chapitre se lancent en {{CLIENT}}, sauf mention contraire.

Créer une clé de déploiement GitHub

ssh-keygen -t ed25519 -f ~/.ssh/github_deploy -N "" -C "deploy@{{SITE}}"
cat >> ~/.ssh/config << 'EOF'
Host github.com
    IdentityFile ~/.ssh/github_deploy
    IdentitiesOnly yes
EOF
chmod 600 ~/.ssh/config
cat ~/.ssh/github_deploy.pub

Sur GitHub, dans le dépôt : Settings › Deploy keys › Add deploy key. Collez la clé affichée et laissez « Allow write access » décoché.

[!CHECK] ssh -T git@github.com répond Hi <compte>/<dépôt>! You've successfully authenticated… (tapez yes à la première connexion).

Cloner le projet

Le dossier public_html contient une page d'accueil HestiaCP par défaut : videz-le, puis clonez le projet dedans.

cd ~/web/{{SITE}}/public_html
rm -f index.html robots.txt
# Remplacez COMPTE/PROJET par votre dépôt GitHub
git clone git@github.com:COMPTE/PROJET.git .
ls

[!CHECK] Vous voyez bin/, config/, public/, src/, composer.json…

[!WARNING] Le fichier .htaccess de Symfony Apache a besoin de public/.htaccess pour router les URL vers index.php. S'il n'existe pas dans votre dépôt, ajoutez-le sur votre poste avec composer require symfony/apache-pack, puis commitez-le.

Configurer l'environnement de production

Générez un secret :

php -r 'echo bin2hex(random_bytes(16)), PHP_EOL;'

Relevez la version exacte de MariaDB :

mariadb --version

Créez .env.local avec vos valeurs. serverVersion reprend la version affichée, par exemple 11.8.3-MariaDB :

cat > .env.local << 'EOF'
APP_ENV=prod
APP_DEBUG=0
APP_SECRET=collez_le_secret_ici
DATABASE_URL="mysql://{{CLIENT}}_app:MOT_DE_PASSE_BDD@127.0.0.1:3306/{{CLIENT}}_app?serverVersion=11.8.3-MariaDB&charset=utf8mb4"
MAILER_DSN=smtp://noreply%40{{DOMAINE}}:MOT_DE_PASSE_NOREPLY@mail.{{DOMAINE}}:587
EOF
chmod 600 .env.local

Installer les dépendances et la base

composer install --no-dev --optimize-autoloader
php bin/console doctrine:migrations:migrate --no-interaction
php bin/console cache:clear

[!CHECK] php bin/console about affiche Environment: prod et Debug: false.

Pointer le site sur le dossier public/

À faire avec {{USER}} (dans une autre session SSH). Le dernier argument yes est indispensable : sans lui, PHP n'aurait plus accès à vendor/, var/ ni config/, et le site planterait.

sudo v-change-web-domain-docroot {{CLIENT}} {{SITE}} {{SITE}} public yes

[!CHECK] curl -sI https://{{SITE}} | head -1 renvoie HTTP/2 200, et la page d'accueil de l'application s'affiche dans le navigateur.

Tip

Dans le panel, c'est Modifier le domaine › Options avancées › Racine de document personnalisée, avec Pointer vers = {{SITE}} et Répertoire = public.

Créer le script de déploiement

En {{CLIENT}}, créez ~/deploy-{{SITE}}.sh. Il utilise des chemins complets, car les alias (composer, php) ne fonctionnent pas dans un script.

cat > ~/deploy-{{SITE}}.sh << 'EOF'
#!/bin/bash
set -euo pipefail
PHP=/usr/bin/php8.4
COMPOSER="$PHP $HOME/.composer/composer"
cd "$HOME/web/{{SITE}}/public_html"

git pull --ff-only
$COMPOSER install --no-dev --optimize-autoloader --no-interaction
$PHP bin/console doctrine:migrations:migrate --no-interaction --allow-no-migration
$PHP bin/console cache:clear
echo "Déploiement terminé : $(git log -1 --format='%h %s')"
EOF
chmod 700 ~/deploy-{{SITE}}.sh

Pour déployer une nouvelle version, depuis votre ordinateur :

ssh -p {{SSH_PORT}} {{CLIENT}}@{{IP}} ./deploy-{{SITE}}.sh

Note

OPcache vérifie la date des fichiers : le nouveau code est pris en compte en quelques secondes, sans redémarrer PHP-FPM.

Ajouter les tâches planifiées

À faire avec {{USER}}. Les * doivent être entre guillemets. Exemple : une commande toutes les 5 minutes, et le worker Messenger, relancé toutes les 5 minutes pendant 4 min 50 s.

sudo v-add-cron-job {{CLIENT}} '*/5' '*' '*' '*' '*' "/usr/bin/php8.4 /home/{{CLIENT}}/web/{{SITE}}/public_html/bin/console app:ma-commande"
sudo v-add-cron-job {{CLIENT}} '*/5' '*' '*' '*' '*' "/usr/bin/php8.4 /home/{{CLIENT}}/web/{{SITE}}/public_html/bin/console messenger:consume async --time-limit=290 --quiet"
sudo v-list-cron-jobs {{CLIENT}}

Connaître les limites de PHP-FPM

Pour la sécurité, HestiaCP désactive certaines fonctions dans le PHP web (PHP-FPM) : exec, system, shell_exec, passthru, proc_open, popen. Tout ce qui lance un processus depuis une page web échouera, par exemple le composant Process ou le transport mail sendmail://. Faites ces traitements en console (cron, Messenger), où ces fonctions restent disponibles.

Les chemins accessibles à PHP-FPM (open_basedir) se limitent à public_html/, private/, ~/tmp et ~/.composer. Gardez var/ (cache, logs) dans le projet. Pour les fichiers envoyés par les utilisateurs, public_html/public/uploads ou private/ conviennent.

[!TIP] Journaux Erreurs Symfony : ~/web/{{SITE}}/public_html/var/log/prod.log. Erreurs Apache/PHP : ~/web/{{SITE}}/logs/.