Laravel & Symfony

This tutorial puts a Laravel or Symfony project online on a Tauri hosting account. You prepare the project on your own computer with Composer, send it as a single zip file over FTPS, then unpack it and run the framework's console over SSH. The site is then served over HTTPS on the account's domain, with its data in Tauri's built-in SQL database. Ce tutoriel met en ligne un projet Laravel ou Symfony sur un compte d'hébergement Tauri. Vous préparez le projet sur votre propre ordinateur avec Composer, l'envoyez en un seul fichier zip par FTPS, puis le décompressez et lancez la console du framework par SSH. Le site est alors servi en HTTPS sur le domaine du compte, ses données dans la base SQL intégrée de Tauri.

1. Before you startAvant de commencer

If your computer has a newer PHP than 8.3, tell Composer to resolve the dependencies for the server's PHP, in composer.json, then run composer update: Si votre ordinateur a un PHP plus récent que 8.3, demandez à Composer de résoudre les dépendances pour le PHP du serveur, dans composer.json, puis lancez composer update :

"config": {
    "platform": { "php": "8.3.26" }
}

2. Three things that differ from a usual hostTrois différences avec un hébergeur habituel

• The public folder is called www/. The account's home c:/user/<compte>/ is the project root, and only its www/ folder is served. Rename the framework's public/ folder to www/: app/, vendor/, .env, storage/ or var/ stay out of reach of the web.Le dossier public s'appelle www/. Le répertoire du compte c:/user/<compte>/ est la racine du projet, et seul son dossier www/ est servi. Renommez le dossier public/ du framework en www/ : app/, vendor/, .env, storage/ ou var/ restent hors d'atteinte du web.
• The database is a folder. There is no MySQL or PostgreSQL server: use the SQLite driver (pdo_sqlite), whose path points to a folder where Tauri keeps one table per entry — not to a .sqlite file. Do not upload an existing SQLite file: it would not be read.La base de données est un dossier. Il n'y a pas de serveur MySQL ni PostgreSQL : employez le pilote SQLite (pdo_sqlite), dont le chemin désigne un dossier où Tauri range une table par entrée — pas un fichier .sqlite. N'envoyez pas de fichier SQLite existant : il ne serait pas lu.
• One zip, unpacked on the server. FTPS sends files one by one; thousands of small files are slow to send, and FTPS cannot rename. Send one zip, then unpack it over SSH with unzip.Un seul zip, décompressé sur le serveur. FTPS envoie les fichiers un à un ; des milliers de petits fichiers sont longs à envoyer, et FTPS ne sait pas renommer. Envoyez un zip, puis décompressez-le par SSH avec unzip.

3. Laravel

On your computerSur votre ordinateur

composer create-project laravel/laravel monsite  # or your existing project# ou votre projet existant
cd monsite
mv public www                                    # the public folder becomes www/# le dossier public devient www/
rm database/database.sqlite                      # SQLite file of the skeleton: not used# fichier SQLite du squelette : inutile

In www/index.php, tell Laravel where its public folder is, just before the last line: Dans www/index.php, indiquez à Laravel où est son dossier public, juste avant la dernière ligne :

$app->usePublicPath(__DIR__);

$app->handleRequest(Request::capture());

In .env: Dans .env :

APP_ENV=production
APP_DEBUG=false
APP_URL=https://www.example.com

DB_CONNECTION=sqlite
DB_DATABASE=database/donnees

Keep the APP_KEY line (create-project generates it; otherwise run php artisan key:generate on your computer). DB_DATABASE is relative to the project root. Sessions, cache and queue may stay on database (their tables are created by the migrations). Then zip the contents of the project folder (not the folder itself), including the hidden files .env and www/.htaccess — it is .htaccess that gives Laravel its clean URLs. On Windows, select everything inside the project folder, then “Compress to ZIP file”. Gardez la ligne APP_KEY (create-project la génère ; sinon lancez php artisan key:generate sur votre ordinateur). DB_DATABASE est relatif à la racine du projet. Sessions, cache et file d'attente peuvent rester sur database (leurs tables sont créées par les migrations). Zippez ensuite le contenu du dossier du projet (pas le dossier lui-même), fichiers cachés .env et www/.htaccess compris — c'est .htaccess qui donne à Laravel ses URL propres. Sous Windows, sélectionnez tout le contenu du dossier du projet, puis « Compresser dans un fichier ZIP ».

zip -r ../monsite.zip . -x ".git/*" "node_modules/*"  # Linux / macOS

On TauriSur Tauri

Send monsite.zip by FTPS to the root of the account (not into www/), then open an SSH session as the account — ssh <compte>@<your domain>, settings in SSH/FTP. You land in the project root; type: Envoyez monsite.zip par FTPS à la racine du compte (pas dans www/), puis ouvrez une session SSH sous le compte — ssh <compte>@<votre domaine>, réglages dans SSH/FTP. Vous arrivez à la racine du projet ; tapez :

unzip -o -q monsite.zip      # several minutes: 9,000 files# plusieurs minutes : 9 000 fichiers
rm monsite.zip               # give the space back# rendre la place
mkdir database/donnees       # Laravel wants the database folder to exist# Laravel veut que le dossier de la base existe
php artisan migrate --force  # create the tables# créer les tables
php artisan optimize         # cache configuration and routes# mettre en cache configuration et routes
exit                         # end the session# fermer la session

Open https://<your domain>/: the Laravel welcome page appears. Once the configuration is cached, a change to .env only counts after a new php artisan optimize. Ouvrez https://<votre domaine>/ : la page d'accueil de Laravel s'affiche. Une fois la configuration en cache, une modification de .env ne compte qu'après un nouveau php artisan optimize.

4. Symfony

On your computerSur votre ordinateur

composer create-project symfony/skeleton:"7.4.*" monsite  # 7.4 LTS, not 8# 7.4 LTS, pas la 8
cd monsite
composer require symfony/orm-pack                         # Doctrine, if you need a database# Doctrine, s'il vous faut une base
mv public www                                             # the public folder becomes www/# le dossier public devient www/

Also declare that folder in composer.json, so that the recipes of the packages you add later write into www/: Déclarez aussi ce dossier dans composer.json, pour que les recettes des paquets ajoutés plus tard écrivent dans www/ :

"extra": {
    "public-dir": "www",
    ...
}

The Symfony skeleton has no .htaccess: create www/.htaccess with these three lines, which send every URL that is not a file to index.php: Le squelette Symfony n'a pas de .htaccess : créez www/.htaccess avec ces trois lignes, qui envoient vers index.php toute URL qui n'est pas un fichier :

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [QSA,L]

In .env (or .env.local), with a secret of your own — php -r "echo bin2hex(random_bytes(16));" makes one. Doctrine creates the database folder var/donnees by itself. Dans .env (ou .env.local), avec un secret à vous — php -r "echo bin2hex(random_bytes(16));" en fabrique un. Doctrine crée seul le dossier de la base var/donnees.

APP_ENV=prod
APP_SECRET=<32 hexadecimal characters>
DATABASE_URL="sqlite:///%kernel.project_dir%/var/donnees"

Empty var/cache/, then zip the contents of the project as for Laravel. Videz var/cache/, puis zippez le contenu du projet comme pour Laravel.

On TauriSur Tauri

unzip -o -q monsite.zip
rm monsite.zip
php bin/console doctrine:schema:update --force  # or doctrine:migrations:migrate -n# ou doctrine:migrations:migrate -n
php bin/console cache:clear                     # prepare the prod cache# préparer le cache de prod
exit

Then open, for example, https://<your domain>/ or one of your routes. Ouvrez ensuite par exemple https://<votre domaine>/ ou l'une de vos routes.

5. Updating the siteMettre le site à jour

Zip only what changed (for instance app/ and routes/, or src/ and templates/), send it, and unpack it with unzip -o, which overwrites. Then run the migrations again and rebuild the caches: php artisan optimize for Laravel, php bin/console cache:clear for Symfony. After a composer update on your side, send vendor/ again. Zippez seulement ce qui a changé (par exemple app/ et routes/, ou src/ et templates/), envoyez, et décompressez avec unzip -o, qui écrase. Relancez ensuite les migrations et refaites les caches : php artisan optimize pour Laravel, php bin/console cache:clear pour Symfony. Après un composer update chez vous, renvoyez vendor/.

6. If something goes wrongEn cas de problème