Déployer son site Symfony sur un serveur Mutualisé

Il y a 2 ou 3 petites choses à faire, mais rien de bien sorcier, par contre la ressource n’est pas facilement trouvable sur le net.

Je vous conseille avant toute chose, de cloner votre projet dans un autre répertoire, il peut y avoir un risque de pétage de projet.

Tout d’abord, il faut faire un dump de votre environnement grâce à la commande :

composer dump-env prod

Une fois fait, vous vous retrouvez avec un fichier env.php qui contient un tableau associatif avec les accès BDD, serveur mail, etc. (ce qui se trouvait dans env.php). Pensez à mettre a jour avec vos identifiants BDD, serveur SMTP

Ensuite, passez en prod et relancez le composer install qui va ne prendre que les dépendances de la prod (pas de web profile, fixtures, etc.)

Une fois fait, vous devez ajouter 2 fichiers .htaccess. Un à la racine du site, le second dans le répertoire public.

Voici le contenu de celui à la racine, qui en gros redirige les requêtes vers le répertoire public en les passant en https.

RewriteEngine on

RewriteBase /

RewriteCond %{HTTPS} !=on
RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [R=301,L]

RewriteCond %{REQUEST_URI} !^/public/
RewriteRule ^(.*)$ /public/$1 [L]

Et celui à mettre dans public qui va faire les branchements avec le moteur de Symfony


<IfModule mod_negotiation.c>
    Options -MultiViews
</IfModule>

<IfModule mod_rewrite.c>
    RewriteEngine On

    RewriteCond %{REQUEST_URI}::$0 ^(/.+)/(.*)::\2$
    RewriteRule .* - [E=BASE:%1]

   
    RewriteCond %{HTTP:Authorization} .+
    RewriteRule ^ - [E=HTTP_AUTHORIZATION:%0]

    RewriteCond %{ENV:REDIRECT_STATUS} =""
    RewriteRule ^index\.php(?:/(.*)|$) %{ENV:BASE}/$1 [R=301,L]

    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ %{ENV:BASE}/index.php [L]
</IfModule>

<IfModule !mod_rewrite.c>
    <IfModule mod_alias.c>
        RedirectMatch 307 ^/$ /index.php/

    </IfModule>
</IfModule>

une fois fait, envoyez ça sur votre hébergement et normalement ça marche. En cas de problème, pensez à virer le cache, le plus facile c’est d’aller dans var et de renommer le répertoire prod en prod_ (c’est plus rapide, car il contient des centaines de fichiers)

Fichier robots.txt et autre ads avec Symfony

Comme vous le savez, une bonne pratique est d’ajouter un fichier robots.txt pour indiquer vos préférences en terme de crawler (enfin quand c’est pris en compte) idem si vous utilisez une régie de pub (ads.txt).

Pour qu’il soit visible dans un projet Symfony, il faut les placer dans le dossier public.

Gérer les relations ManyToMany dans Symfony

Dans Symfony, ce qui est génial c’est les commandes de génération de Code. Entre le Make:Entity et le Make Crud, on gagne un temps fou, mais il reste une certaine petite chose qui peuvent vous faire perdre du temps si vous débutez.

Et l’une d’elles qui m’as bien pris la tête alors que c’est tout bête, c’est la gestion des relations ManyToMany dans les formulaires.

Pour rappel, un ManyToMany, c’est une relation qui peut avoir plusieurs références à des entités. Comme des tags par exemple, je peux avoir un tag techno qui peut être lié à plusieurs articles, mais un article peut avoir plusieurs tags.

Dans le formBuilder, il faut ajouter sur notre champs M2M, le type de champs, donc EntityType , et la classe cible.

 ->add('category', EntityType::class, [
                'class' => Category::class               
            ])

Et surtout bien penser à ajouter une fonction __toString sur votre entity, sinon Symfony ne saura pas quoi afficher.


    public function __toString()
    {
        return $this->name;
    }
    

Générer les classes et les accesseurs avec Symfony depuis une BDD

Il est possible de générer toutes les classes et les entités depuis une base de données existante.

Cette commande génére l'entité sous forme de classe PHP:

php bin/console doctrine:mapping:import 'App\Entity' annotation --path=src/Entity

Si vous préferez le yml ou le xml à la place des annotations, il suffit de replacer annotation dans la commande.

 

Pour générer les accesseurs, il suffit de taper:

php bin/console make:entity --regenerate App

Il reste quelque petit trucs à ajouter à la main, mais ça supprime déjà pas mal de travail répétitif et sans intérêt.