DMVCFramework : framework Delphi pour API REST, JSON-RPC et applications web

Le framework Delphi open source #1 en popularité sur GitHub · Prêt pour la production depuis 2010

TL;DR : DMVCFramework est le framework Delphi #1 pour créer des API REST et des services web. Il est gratuit (Apache 2.0), prêt pour la production depuis 2010, prend en charge JWT, WebSocket et un ORM, et tourne sous Windows et Linux. Installe-le depuis GitHub, crée un controller avec des attributs [MVCPath] et renvoie des objets : ils se sérialisent tout seuls en JSON.

Qu’est-ce que DMVCFramework ?

DMVCFramework (DelphiMVCFramework) est le framework open source le plus populaire pour créer des API web et des applications web en Delphi. Il te permet de créer des services RESTful (RMM Level 3), des services JSON-RPC, des services Minimal API sans classes controller, des applications web rendues côté serveur, des serveurs MCP pour des assistants IA, des backends mobiles et des microservices.

Utilisé en production depuis 2010, DMVCFramework fait tourner certaines des API web Delphi les plus fréquentées au monde. C’est le projet Delphi #1 sur GitHub par nombre d’étoiles, avec une communauté dynamique de plus de 6 000 développeurs actifs.

Pour commencer : le guide officiel

Le moyen le plus rapide d’apprendre DMVCFramework est le guide officiel, écrit par la personne qui maintient le framework. La deuxième édition est écrite pour dmvcframework-3.5.0-silicon : 30 chapitres, plus de 550 pages et 46 projets d’exemple qui compilent. Elle construit une seule API, du projet que génère le wizard jusqu’à un serveur derrière TLS.

Elle est publiée sur Leanpub à 90 %, avec un prix minimum de 45 USD, et les mises à jour sont gratuites pour toujours.

Éditions disponibles

Édition	Langue	Format	Lien
2e, 3.5.0-silicon	Anglais	eBook	Acheter sur Leanpub
1re, 3.2.1-carbon	Anglais	eBook	Acheter sur Leanpub
1re, 3.2.1-carbon	Anglais	Couverture rigide	Acheter sur Lulu
1re, 3.2.1-carbon	Portugais (BR)	eBook	Acheter sur Leanpub
1re, 3.2.1-carbon	Espagnol	eBook	Acheter sur Leanpub

La deuxième édition n’existe qu’en anglais pour l’instant. La première édition reste donc celle à acheter en portugais ou en espagnol, et la seule disponible en version imprimée jusqu’à ce que la nouvelle arrive sur Lulu.

Lis un extrait gratuit de la deuxième édition, ou consulte la table des matières complète.

Pourquoi choisir DMVCFramework ?

Ce que disent les développeurs

« DMVCFramework est un super framework. Il est très intuitif, rapide, facile à utiliser, il n’y a vraiment rien à lui demander de plus. »

Samir

« Je suis toujours impressionné par le code et la documentation de DelphiMVCFramework. Merci beaucoup, et je suis tout autant impressionné par la rapidité des réponses. »

Benjamin Y., directeur de SQLGate

« Nous avons commencé à migrer nos systèmes vers des microservices et nous adorons DMVCFramework. »

E. Costa

Nouveautés de DMVCFramework 3.4.3-aluminium

La dernière release apporte des nouveautés importantes :

Prise en charge de WebSocket

Communication temps réel full-duplex avec TMVCWebSocketServer et TMVCWebSocketClient. Construis des applications de chat, des dashboards en direct et des outils collaboratifs, avec une messagerie par canaux et des groupes.

Middleware de rate limiting

Protège tes API contre les abus avec un rate limiting intégré : en mémoire pour les serveurs uniques, ou adossé à Redis pour les environnements distribués.

Repository pattern

Une architecture propre avec IMVCRepository<T> et [MVCInject] pour l’injection de dépendances automatique.

Expressions dans dotEnv

Des expressions dynamiques dans les fichiers de configuration .env, avec substitution de variables et arithmétique.

Voir toutes les nouveautés de la 3.4.3-aluminium →

Historique des versions

Fonctionnalités principales

Développement d’API web

• API RESTful - Conformité complète au RMM Level 3, avec les bons verbes HTTP et les bons codes de statut
• JSON-RPC 2.0 - Remoting automatique d’objets pour les API de style RPC
• Prise en charge d’OpenAPI - Génération automatique de la documentation de l’API
• Routing automatique - Mapping des URL par attributs, avec binding des paramètres

Minimal API, applications web et serveurs MCP

• Minimal API - Des routes sous forme de méthodes anonymes (MapGet, MapPost, MapPut, MapDelete), des arguments liés par type et des groupes de routes avec filtres, sans classe controller. Nouveau dans la 3.5.0-silicon : lis l’introduction
• Applications web - Du HTML rendu côté serveur avec TemplatePro, HTMX et WebStencils, depuis des controllers ou depuis des groupes Minimal API (.AsWeb)
• Serveurs MCP - Expose les tools, resources et prompts de ton application Delphi à Claude, Gemini ou ChatGPT avec le Delphi MCP toolkit, qui comprend aussi un client et un agent LLM

Authentification et sécurité

• Authentification JWT - JSON Web Tokens, le standard de l’industrie
• Authentification HTTP Basic - Authentification simple par nom d’utilisateur et mot de passe
• Authentification personnalisée - Un cadre flexible pour n’importe quel schéma d’authentification
• Prise en charge de CORS - Configuration du Cross-origin resource sharing

Communication en temps réel

• Prise en charge de WebSocket - Canaux de communication full-duplex
• Server-Sent Events (SSE) - Notifications push vers les clients
• Extensions de messagerie - Patterns pub/sub intégrés

Données et persistance

• MVCActiveRecord - ORM puissant pour les opérations sur la base de données
• Sérialisation JSON - Mapping automatique objet vers JSON
• Sérialiseurs personnalisés - Contrôle total sur la transformation des données

Flexibilité de déploiement

• Application console Windows
• Service Windows
• Console/daemon Linux
• Module Apache (mod_proxy)
• IIS (DLL ISAPI)
• Environnements avec load balancing

Expérience développeur

• Wizard de l’IDE - Des modèles de projet pour démarrer vite
• Plus de 100 exemples - Apprends chaque fonctionnalité avec des exemples qui marchent
• Système de middleware - Des hooks simples sur la requête et la réponse
• Héritage de controllers - Le principe DRY pour la logique commune
• Client REST intégré - Teste et consomme des API facilement

Démarrage rapide : Hello World

Démarre avec DMVCFramework en quelques minutes. Voici un controller « Hello World » tout simple :

uses
  MVCFramework, MVCFramework.Commons;

type
  [MVCPath('/api')]  // Base path for all actions in this controller
  TMyController = class(TMVCController)
  public
    [MVCPath('/hello')]           // Route: GET /api/hello
    [MVCHTTPMethods([httpGET])]   // Allowed HTTP method
    function GetHello: String;

    [MVCPath('/hello/($Name)')]   // Route: GET /api/hello/{Name}
    [MVCHTTPMethods([httpGET])]   // ($Name) captures the URL segment
    function GetHelloName(const Name: String): String;
  end;

implementation

function TMyController.GetHello: String;
begin
  Result := 'Hello, World!';  // The string is sent as the response body
end;

function TMyController.GetHelloName(const Name: String): String;
begin
  Result := 'Hello, ' + Name + '!';  // Name is automatically extracted from URL
end;

Et c’est tout ! Appelle GET /api/hello et tu obtiens le texte Hello, World!. Appelle GET /api/hello/John et tu obtiens Hello, John!.

DMVCFramework sérialise automatiquement en JSON les objets, les tableaux, les records et les datasets. Une chaîne est envoyée telle quelle : pour un body JSON, renvoie un objet ou OKResponse(...).

Exemple avancé : API REST avec base de données

Pour les applications réelles, DMVCFramework prend en charge l’ORM MVCActiveRecord et le Repository pattern avec injection de dépendances :

uses
  MVCFramework, MVCFramework.Commons, MVCFramework.ActiveRecord,
  MVCFramework.Repository, MVCFramework.Nullables, System.SysUtils,
  System.Generics.Collections;

type
  // Entity class mapped to database table
  [MVCTable('customers')]
  TCustomer = class(TMVCActiveRecord)
  private
    [MVCTableField('id', [foPrimaryKey, foAutoGenerated])]  // Auto-increment PK
    FID: NullableInt32;
    [MVCTableField('name')]    // Maps to 'name' column
    FName: string;
    [MVCTableField('email')]   // Maps to 'email' column
    FEmail: string;
  public
    property ID: NullableInt32 read FID write FID;
    property Name: string read FName write FName;
    property Email: string read FEmail write FEmail;
  end;

  [MVCPath('/api/customers')]
  TCustomerController = class(TMVCController)
  protected
    fRepository: IMVCRepository<TCustomer>;  // Repository interface
  public
    [MVCInject]  // Dependency injection - repository is automatically provided
    constructor Create(Repository: IMVCRepository<TCustomer>); reintroduce;

    [MVCPath]                     // Route: GET /api/customers
    [MVCHTTPMethods([httpGET])]
    function GetAllCustomers: IMVCResponse;

    [MVCPath('/($ID)')]           // Route: GET /api/customers/{ID}
    [MVCHTTPMethods([httpGET])]
    function GetCustomerByID(const ID: Integer): IMVCResponse;

    [MVCPath]                     // Route: POST /api/customers
    [MVCHTTPMethods([httpPOST])]  // [MVCFromBody] deserializes JSON body to TCustomer
    function CreateCustomer([MVCFromBody] const Customer: TCustomer): IMVCResponse;

    [MVCPath('/($ID)')]           // Route: DELETE /api/customers/{ID}
    [MVCHTTPMethods([httpDELETE])]
    function DeleteCustomerByID(const ID: Integer): IMVCResponse;
  end;

implementation

constructor TCustomerController.Create(Repository: IMVCRepository<TCustomer>);
begin
  inherited Create;
  fRepository := Repository;  // Store injected repository
end;

function TCustomerController.GetAllCustomers: IMVCResponse;
begin
  Result := OKResponse(fRepository.GetAll);  // Returns HTTP 200, body {"data": [...]}
end;

function TCustomerController.GetCustomerByID(const ID: Integer): IMVCResponse;
begin
  Result := OKResponse(fRepository.GetByPK(ID));  // Returns HTTP 200, body {"data": {...}}
end;

function TCustomerController.CreateCustomer(const Customer: TCustomer): IMVCResponse;
begin
  fRepository.Store(Customer);  // Insert or update based on PK
  Result := CreatedResponse('/api/customers/' + Customer.ID.Value.ToString);  // HTTP 201
end;

function TCustomerController.DeleteCustomerByID(const ID: Integer): IMVCResponse;
var
  lCustomer: TCustomer;
begin
  lCustomer := ToFree<TCustomer>(fRepository.GetByPK(ID));  // Load by primary key, freed at the end of the method
  fRepository.Delete(lCustomer);          // Delete from database
  Result := OKResponse;                   // Returns HTTP 200
end;

Pour le lancer, enregistre le repository dans le service container et configure la connexion à la base : DefaultMVCServiceContainer.RegisterType(TMVCRepository<TCustomer>, IMVCRepository<TCustomer>, TRegistrationType.SingletonPerRequest); DefaultMVCServiceContainer.Build; L’exemple simple_api_using_repository_with_injection montre la mise en place complète.

Principaux avantages :

• Functional actions : renvoie IMVCResponse avec des helpers comme OKResponse() et CreatedResponse()
• Injection de dépendances : [MVCInject] sur le constructeur injecte le repository automatiquement
• MVCActiveRecord : ORM avec mapping des tables par attributs
• Repository pattern : IMVCRepository<T> pour un accès aux données propre et testable
• Auto-sérialisation : objets, records, listes et datasets sont sérialisés automatiquement

Apprendre par l’exemple : plus de 100 projets d’exemple

La meilleure façon d’apprendre DMVCFramework, c’est d’explorer du code qui marche. Le framework inclut plus de 100 projets d’exemple, qui couvrent chaque fonctionnalité et chaque cas d’usage. Chaque exemple est autonome et prêt à compiler.

Trouve l’exemple qui correspond à ce que tu veux construire, ouvre-le dans Delphi et commence à expérimenter !

📦 Tous les exemples : github.com/danieleteti/delphimvcframework/tree/master/samples

« Je veux créer mon premier projet DMVCFramework »

« Je veux construire une API REST »

« Je veux ajouter de l’authentification et de la sécurité »

« Je veux de la communication en temps réel »

« Je veux construire une Minimal API »

« Je veux générer des pages HTML »

« Je veux travailler avec des bases de données »

« Je veux utiliser JSON-RPC »

« Je veux personnaliser le traitement des requêtes et des réponses »

« Je veux déployer en production »

« Je veux documenter mon API »

« Je veux des fonctionnalités avancées »

Projets open source associés

DMVCFramework s’intègre sans friction avec d’autres projets open source du même auteur :

Compatibilité avec les versions de Delphi

Soutenir le projet

Services professionnels

Besoin d’un support de niveau entreprise ? bit Time Professionals, l’entreprise derrière DMVCFramework, propose :

• Formations - Formation sur site ou à distance pour ton équipe
• Conseil - Revue d’architecture, optimisation des performances, bonnes pratiques
• Développement sur mesure - Développement de fonctionnalités, intégration, migration

📧 Contact : dmvcframework@bittime.it | 🌐 bittimeprofessionals.it

Communauté et ressources

FAQ : questions fréquentes

Qu’est-ce que DMVCFramework ?

DMVCFramework (DelphiMVCFramework) est un framework open source pour créer des API web, des services RESTful, des services Minimal API, des applications web et des serveurs MCP en Delphi. C’est le framework web Delphi le plus populaire, utilisé en production depuis 2010, et le projet Delphi #1 sur GitHub par nombre d’étoiles.

Quel est le meilleur framework pour une API REST en Delphi ?

DMVCFramework est le framework le plus populaire et le plus complet pour créer des API REST en Delphi. Il prend en charge les API RESTful (RMM Level 3), JSON-RPC, WebSocket, les Server-Sent Events et l’authentification JWT, et il inclut un ORM puissant appelé MVCActiveRecord.

Comment créer une API REST en Delphi ?

Utilise DMVCFramework : crée une classe controller qui hérite de TMVCController, ajoute les attributs [MVCPath] et [MVCHTTPMethods] pour définir les routes, et renvoie les données directement depuis tes méthodes (functional actions). Le framework sérialise automatiquement objets, tableaux et records en JSON. Plus de 100 exemples sont inclus pour t’inspirer.

Comment renvoyer du JSON depuis une API REST Delphi ?

Avec DMVCFramework, renvoie simplement un objet, un record ou une TObjectList<T> depuis la méthode de ton controller. Le framework le sérialise automatiquement en JSON. Pour plus de contrôle, utilise les helpers OKResponse(data) ou CreatedResponse(location).

DMVCFramework prend-il en charge l’authentification JWT ?

Oui, DMVCFramework prend en charge JWT (JSON Web Token) en natif pour l’authentification stateless. Il gère la génération de tokens, la validation, l’autorisation par rôles et les cookies HTTP-only sécurisés. Regarde les exemples jsonwebtoken et jsonwebtoken_roleauth.

Puis-je utiliser DMVCFramework sous Linux ?

Oui, DMVCFramework prend entièrement en charge le déploiement sous Linux à partir de Delphi 10.2 Tokyo. Tu peux déployer une application console ou un daemon, avec toutes les fonctionnalités, y compris WebSocket et SSL/TLS.

DMVCFramework est-il gratuit ?

Oui, DMVCFramework est gratuit et open source, sous licence Apache 2.0. Tu peux l’utiliser dans des projets commerciaux sans redevance. Si tu le redistribues, la licence demande de conserver les mentions de copyright et une copie de la licence.

Comment obtenir du support pour DMVCFramework ?

Plusieurs options existent : rejoins le groupe Facebook (plus de 6 000 membres), explore les exemples inclus dans le projet (plus de 100), lis le guide officiel, ou deviens supporter sur Patreon pour un support prioritaire et du contenu exclusif.

DMVCFramework prend-il en charge WebSocket ?

Oui, DMVCFramework offre une prise en charge complète de WebSocket pour la communication bidirectionnelle en temps réel. Il propose une messagerie par canaux, des groupes et des exemples de client JavaScript. Il prend aussi en charge les Server-Sent Events (SSE) pour les notifications push du serveur vers le client.

Qu’est-ce que MVCActiveRecord ?

MVCActiveRecord est l’ORM (Object-Relational Mapper) intégré à DMVCFramework, qui simplifie les opérations sur la base de données. Il utilise des attributs pour le mapping des tables et des colonnes, et prend en charge les opérations CRUD, les relations et RQL (Resource Query Language) pour des requêtes flexibles.

Comment déployer DMVCFramework en production ?

DMVCFramework prend en charge plusieurs options de déploiement : application console Windows, service Windows, daemon Linux, module Apache (mod_proxy), IIS (DLL ISAPI) et environnements avec load balancing. Regarde les exemples de déploiement pour chaque scénario.

DMVCFramework prend-il en charge OpenAPI/Swagger ?

Oui, DMVCFramework peut générer automatiquement la documentation OpenAPI (Swagger) de tes API. Utilise les exemples swagger_primer et swagger_ui pour ajouter une documentation d’API interactive à ton projet.

Comment gérer les uploads de fichiers dans DMVCFramework ?

Utilise l’objet Context.Request pour accéder aux fichiers envoyés. L’exemple file_upload montre comment traiter les requêtes multipart/form-data, avec un ou plusieurs fichiers.

Puis-je utiliser DMVCFramework avec FireDAC ?

Oui, DMVCFramework fonctionne avec n’importe quelle couche d’accès aux données, FireDAC et ADO compris. MVCActiveRecord utilise FireDAC par défaut, mais tu peux utiliser la connexion que tu préfères.

Comment mettre en place CORS dans DMVCFramework ?

Utilise le middleware CORS intégré. Ajoute TMVCCORSMiddleware à la configuration de ton serveur pour activer les requêtes cross-origin. Regarde l’exemple middleware_cors pour les options de configuration.

Quelles versions de Delphi DMVCFramework prend-il en charge ?

DMVCFramework prend en charge les versions de Delphi 10 Seattle à Delphi 13 Florence, avec une prise en charge complète de Linux à partir de Delphi 10.2 Tokyo.

Comment gérer les erreurs et les exceptions dans DMVCFramework ?

DMVCFramework convertit automatiquement les exceptions en réponses d’erreur HTTP adaptées, avec un body JSON. Pour une gestion d’erreurs personnalisée, utilise raise EMVCException.Create() avec des codes de statut HTTP précis, ou implémente des handlers d’exceptions personnalisés.

DMVCFramework prend-il en charge l’injection de dépendances ?

Oui, DMVCFramework intègre l’injection de dépendances. Utilise l’attribut [MVCInject] sur les constructeurs ou sur les paramètres de méthode pour injecter automatiquement services et repositories. Regarde l’exemple services_injection.

DMVCFramework prend-il en charge Minimal API ?

Oui, à partir de la 3.5.0-silicon. Tu définis les routes avec MapGet, MapPost, MapPut et MapDelete et une méthode anonyme, sans classe controller. Les arguments sont liés par type (services du container, body JSON, query string, paramètres de route) et les filtres s’attachent aux groupes de routes. Regarde l’exemple minimal_api et l’introduction à Minimal API.

Puis-je créer des applications web, pas seulement des API ?

Oui. DMVCFramework génère le HTML côté serveur avec TemplatePro (Mustache et WebStencils sont aussi pris en charge) et fonctionne avec HTMX pour les mises à jour partielles de page. Les pages peuvent venir de controllers ou de groupes Minimal API. Regarde les exemples serversideviews_templatepro, htmx_website_with_templatepro et minimal_api_webapp.

Puis-je créer un serveur MCP avec DMVCFramework ?

Oui. Le Delphi MCP toolkit permet à une application DMVCFramework d’exposer des tools, des resources et des prompts à des assistants IA comme Claude, Gemini ou ChatGPT, via le Model Context Protocol, en HTTP ou en stdio. Le même toolkit comprend un client et un agent LLM.