Symfony est l'un des frameworks PHP les plus populaires pour le développement d'applications web. Sa flexibilité et sa robustesse en font un choix privilégié pour les développeurs. Cependant, l'installation de Symfony sur un hébergement mutualisé peut poser quelques défis, surtout si vous n'êtes pas familier avec les outils comme SSH et Composer. Dans cet article, nous vous guiderons à travers le processus d'installation de Symfony sur un hébergement mutualisé, en utilisant Theory7 comme exemple.

1. Pourquoi choisir Symfony ?

Avant de plonger dans le processus d'installation, il est important de comprendre pourquoi Symfony est un excellent choix pour vos projets. Voici quelques avantages :

  • Modularité : Symfony est basé sur un système de bundles, ce qui permet de réutiliser des composants et de créer des applications modulaires.
  • Communauté active : Avec une large communauté de développeurs, vous trouverez facilement des ressources, des plugins et des solutions à vos problèmes.
  • Performance : Symfony est conçu pour être rapide et efficace, ce qui est essentiel pour les applications à fort trafic.

2. Prérequis pour l'installation

Avant de commencer, assurez-vous que votre hébergement mutualisé répond aux exigences suivantes :

  • PHP 8.1 ou supérieur : Symfony nécessite une version récente de PHP pour fonctionner correctement.
  • Composer : Cet outil de gestion de dépendances est essentiel pour installer Symfony et ses composants.
  • Base de données : Vous aurez besoin de MySQL ou PostgreSQL pour gérer vos données.

3. Installation de Symfony via SSH

Pour installer Symfony, vous devrez utiliser SSH pour vous connecter à votre serveur. Voici les étapes à suivre :

cd ~/domains/votredomaine.fr
composer create-project symfony/skeleton .

Cette commande crée un nouveau projet Symfony dans le répertoire spécifié. Assurez-vous de remplacer votredomaine.fr par votre propre nom de domaine.

4. Configuration du Document Root

Après l'installation, vous devez configurer le Document Root de votre hébergement. Cela signifie que vous devez pointer le dossier public_html vers le dossier public/ de votre projet Symfony. Voici comment procéder :

  1. Connectez-vous à votre panneau de contrôle d'hébergement (par exemple, cPanel ou DirectAdmin).
  2. Trouvez l'option pour gérer les fichiers ou le gestionnaire de fichiers.
  3. Accédez au dossier public_html et modifiez le chemin pour qu'il pointe vers ~/domains/votredomaine.fr/public.

Cette étape est cruciale, car elle garantit que les requêtes HTTP sont dirigées vers le bon dossier, où se trouvent les fichiers d'entrée de votre application Symfony.

5. Configuration de la base de données

Une fois Symfony installé, vous devez configurer la base de données. Voici comment procéder :

  1. Créez une base de données via votre panneau de contrôle d'hébergement.
  2. Notez le nom de la base de données, l'utilisateur et le mot de passe.
  3. Ouvrez le fichier .env dans le répertoire de votre projet Symfony et modifiez la ligne DATABASE_URL pour y inclure vos informations de connexion :
DATABASE_URL=mysql://username:password@localhost:3306/dbname

6. Exécution des migrations

Après avoir configuré votre base de données, vous pouvez exécuter les migrations pour créer les tables nécessaires. Utilisez la commande suivante :

php bin/console doctrine:migrations:migrate

Cela appliquera toutes les migrations définies dans votre projet.

7. Déploiement de votre application

Une fois que tout est configuré, vous pouvez déployer votre application. Assurez-vous de :

  • Vérifier les permissions des fichiers et des dossiers, en particulier le dossier var/.
  • Configurer le cache et les logs pour qu'ils soient accessibles en écriture par le serveur web.

8. Résolution des problèmes courants

Lors de l'installation de Symfony sur un hébergement mutualisé, vous pourriez rencontrer certains problèmes. Voici quelques solutions :

  • Erreur 500 : Vérifiez les permissions des fichiers et assurez-vous que le dossier var/ est accessible en écriture.
  • Problèmes de connexion à la base de données : Assurez-vous que les informations de connexion dans le fichier .env sont correctes.

9. Articles connexes

Pour approfondir vos connaissances, consultez ces articles :

10. Besoin d'aide ?

Nous sommes là pour vous aider ! Si vous rencontrez des difficultés ou avez des questions, n'hésitez pas à contacter notre équipe de support. Nous répondons généralement en quelques heures et sommes ravis de vous aider à trouver la meilleure solution pour votre projet.