Passer au contenu principal
Le développement local vous permet d’exécuter votre projet backend sur votre propre machine afin de tester les changements instantanément, d’inspecter les données sans affecter la production et de détecter les problèmes avant le déploiement. Consultez Configuration pour les prérequis et les instructions étape par étape.

​
Ce qui s’exécute localement

Le serveur de développement gère ces fonctionnalités entièrement sur votre machine :
  • Fonctions : les fonctions backend s’exécutent localement avec rechargement automatique lors des modifications de fichiers.
  • Entités : les données d’entités sont stockées dans une base de données locale en mémoire. Les modifications de schéma sont prises en compte automatiquement.
  • Médias : les téléchargements de fichiers sont enregistrés localement.
  • Authentification : l’inscription et la connexion par e-mail/mot de passe s’exécutent localement.
Les automatisations de fonctions ne s’exécutent pas localement.

​
Ce qui est redirigé

Certaines fonctionnalités ne sont pas encore gérées localement. Lorsque le serveur de développement reçoit une requête qu’il ne peut pas servir, il la redirige vers votre application déployée afin que l’appel fonctionne toujours. Le serveur enregistre un avertissement à chaque fois que cela se produit. Les fonctionnalités redirigées comprennent :
  • Authentification : les routes OAuth et de connexion sociale sont redirigées vers Base44 pour que les cookies de session fonctionnent correctement. L’authentification par e-mail/mot de passe s’exécute localement.
  • Intégrations principales : les endpoints comme SendEmail ou la génération IA sont redirigés. Les téléchargements de fichiers sont l’exception et s’exécutent localement.
  • Intégrations personnalisées : appels API configurés via des spécifications OpenAPI.
Cela signifie que votre application continue de fonctionner de bout en bout pendant le développement. Les fonctionnalités qui s’exécutent localement utilisent des données locales, et tout le reste utilise la production.

​
Fonctions

Les fonctions backend s’exécutent localement sur votre machine. Vous pouvez les appeler depuis votre frontend comme des fonctions déployées.
  • Chaque fonction s’exécute en tant que processus Deno séparé, qui doit être installé séparément.
  • Les fonctions se rechargent automatiquement lorsque vous modifiez le code source.
  • La sortie des fonctions est affichée directement dans votre terminal. Vous n’avez pas besoin d’utiliser base44 logs pendant le développement local.
Lorsqu’une requête atteint le serveur de développement et est relayée vers votre fonction Deno locale, le serveur peut ajouter ou normaliser des en-têtes pour que votre fonction voie la même forme de contexte qu’en production :
  • Base44-App-Id : défini à partir de l’en-tête entrant X-App-Id lorsqu’il est présent.
  • Base44-Service-Authorization : défini à partir de l’en-tête entrant Authorization lorsqu’il est présent, afin que le code qui lit l’en-tête d’autorisation de service localement corresponde au comportement déployé.
  • Base44-Api-Url : défini à l’URL de base de votre serveur de développement (schéma et hôte), afin que les fonctions puissent construire des rappels ou des URL absolues par rapport au serveur local.
L’en-tête Authorization original est toujours transmis tel quel.
La première requête à une fonction peut être plus lente car le serveur de développement démarre le processus à la demande. Les requêtes suivantes réutilisent le processus en cours d’exécution.

​
Entités

Les opérations d’entités vont vers une base de données locale en mémoire au lieu de la base de données distante. Cela vous permet de créer, lire, mettre à jour et supprimer des enregistrements sans affecter vos données de production.
  • Toutes les données sont stockées en mémoire et sont effacées lorsque vous arrêtez le serveur de développement.
  • Les modifications de schéma sont prises en compte automatiquement. La modification d’un schéma d’entité efface toutes les données en mémoire pour cette entité.
  • Les abonnements en temps réel fonctionnent localement. Si votre frontend utilise entities.subscribe(), il reçoit des événements pour les modifications d’entités locales.
  • L’entité User s’exécute localement. Au démarrage, le serveur de développement initialise un seul enregistrement utilisateur en utilisant vos identifiants CLI authentifiés. Les opérations de lecture et de mise à jour sur me fonctionnent comme en production. Les requêtes pour créer ou supprimer des utilisateurs sont ignorées silencieusement, correspondant au comportement de production où la gestion directe des utilisateurs n’est pas autorisée.

​
Médias

Les téléchargements de fichiers sont gérés localement afin que vous puissiez tester les fonctionnalités multimédias sans télécharger vers le stockage de production. Les fichiers sont enregistrés dans un répertoire temporaire et nettoyés lorsque le serveur de développement s’arrête. La taille maximale des fichiers est de 50 Mo.

​
Authentification

L’inscription et la connexion par e-mail/mot de passe s’exécutent localement lorsque votre application utilise le système d’authentification intégré. Les routes OAuth et de connexion sociale sont redirigées vers Base44. Pour enregistrer un nouvel utilisateur pendant le développement avec l’authentification e-mail/mot de passe :
  1. Appelez l’endpoint d’enregistrement. Le serveur de développement affiche un code de vérification unique dans votre terminal au lieu d’envoyer un e-mail.
  2. Soumettez le code à l’endpoint verify-OTP pour confirmer l’adresse et créer l’utilisateur.
  3. Connectez-vous avec l’e-mail et le mot de passe enregistrés.
Votre compte développeur (l’e-mail que vous avez utilisé pour base44 login) peut se connecter avec n’importe quel mot de passe, sans inscription nécessaire.
Les jetons émis par le serveur de développement local ne sont valables que localement. Ils sont signés avec un secret différent de celui de la production, donc votre application déployée les rejettera. Lorsque vous passez du développement local à votre application déployée, déconnectez-vous d’abord de votre session locale ou supprimez vos jetons du stockage de votre navigateur local. Connectez-vous ensuite à nouveau via l’application déployée pour obtenir un jeton valide.

​
Voir aussi

  • Configuration : prérequis et instructions étape par étape
  • Fonctions backend : écrivez des fonctions serverless qui s’exécutent sur l’infrastructure de Base44
  • Entités : définissez des modèles de données pour votre application
  • Structure du projet : comment les fichiers de projet sont organisés
Cette page a été traduite à l’aide de l’IA. Pour les informations les plus précises et à jour, consultez la version anglaise.