FoxServer

FoxServer ist ein eigenständiger HTTP- und HTTPS-Server, der in Visual FoxPro geschriebene Logik veröffentlicht und außerdem Websites ausliefert. Weder IIS noch Apache sind nötig: der Host ist ein eigener Prozess, der Ihre MTDLL über COM lädt und die Anfragen bedient.

Was ihn von jeder anderen Brücke unterscheidet: derselbe Controller wird dreifach veröffentlicht – als REST-API, als JSON-RPC-2.0-Methode und als MCP-Tool, ohne den Endpunkt dreimal zu schreiben. Sie schreiben eine VFP-Funktion, und ein KI-Agent ruft sie genauso auf wie Ihr Frontend.

In diesem Abschnitt

Installation: Voraussetzungen, der Installer, der Installationsbaum und wohin die Lizenz gehört.
Erste Schritte: Ihre erste REST-API, vom leeren Projekt bis zur ersten Antwort.
Konfiguration: Das Server-Manifest: Ports, HTTPS, Protokollierung, Ursprünge und Middlewares.
Routing: Wie eine Route im HELP-Kommentar deklariert wird, die Parameter und die Antworten.
Middleware: Die mitgelieferten Middlewares: JWT, Protokollierung, SSE, Webhooks, Status, OpenAPI.
Lizenzierung: Developer und Runtime, die Freischaltung, die Wartung und das Versionstor.
Erweiterte Funktionen: SSE, ausgehende Webhooks, der Status-Endpunkt und der Windows-Dienstmodus.
Beispiele: Hallo Welt, ein vollständiges CRUD und ein Master-Detail, fertig zum Kopieren.
API-Referenz: Die tatsächliche Oberfläche von ApiController, req und res, Member für Member.
FAQ: Häufige Fragen und worauf zu achten ist, wenn etwas nicht startet.

Was es leistet

REST, JSON-RPC 2.0 und MCP aus demselben Controller. Der Alias as <Fähigkeit> im HELP macht aus einer Route eine JSON-RPC-Methode und ein MCP-Tool
Eigenständiger HTTP- und HTTPS-Server, ohne IIS oder Apache, der auch statische Websites ausliefert
Routing mit Parametern, deklariert im HELP-Kommentar der Methode selbst
Middlewares des Hosts: JWT, Anfrageprotokollierung, SSE, ausgehende Webhooks, Status mit PIN, OpenAPI und Swagger unter /docs
/openapi.json, aus dem Projekt erzeugt, ohne dass etwas von Hand geschrieben wird
Ausgehende Webhooks mit Standard-Webhooks-Signatur, Wiederholungen und Dead-Letter-Warteschlange
Windows-Dienstmodus, an- und abgemeldet aus dem Host heraus
Lizenz beim Start lokal geprüft, ohne dass ein Server gefragt wird

Eine Developer-Lizenz hört nur auf 127.0.0.1 Das ist das Missverständnis Nummer eins bei diesem Produkt, und man sollte es vor dem Kauf wissen: die Plätze von FoxServer sind Developer-Lizenzen, und der Host antwortet mit 403 auf jede Anfrage, die nicht von 127.0.0.1 kommt. Das ist zum Entwickeln und zum Testen auf dem eigenen Rechner gedacht. Damit ein anderer Rechner im Netz oder im Internet Ihre API aufrufen kann, brauchen Sie eine Runtime-Lizenz, das zweite Produkt im Shop. Das Symptom sieht nach einem Rechteproblem aus und ist die Lizenz.

Voraussetzungen

Es sind zwei verschiedene Sätze, und sie zu vermischen verursacht die Hälfte der Stolpersteine: der Rechner, auf dem Sie entwickeln, braucht die Visual-FoxPro-IDE; der Rechner, von dem aus Sie ausliefern, nicht.

	Zum Entwickeln	Zum Ausliefern
Visual FoxPro	Die IDE von VFP 9 SP2. `init`, `controller-add` und `build` brauchen sie: `CREATE PROJECT` und `BUILD MTDLL` gibt es in der Laufzeit nicht	Nur die VFP-9-Laufzeit: `vfp9r.dll`, `vfp9t.dll`, `vfp9renu.dll` und `msvcr71.dll` neben Ihrer MTDLL
.NET	.NET 10 Runtime, Variante x86. Die 64-Bit-Variante nützt nichts, auch wenn sie installiert ist: der Host ist 32-bittig, weil er das COM von VFP lädt, und das ist es auch	Dasselbe: .NET 10 Runtime x86
Windows	Windows 10 oder neuer, 32 oder 64 Bit	Windows 10 oder neuer
Rechte	Eine erhöhte Konsole für `build`: `BUILD MTDLL` registriert die Coclass zum Schluss	Administrator nur zum Installieren und zum Anmelden des Dienstes
Lizenz	Developer (localhost)	Runtime, wenn andere Rechner bedient werden sollen

Ohne Internetverbindung FoxServer ruft für seine Arbeit keinen externen Server auf. Die Lizenz ist ein JWT, das beim Start lokal gegen einen öffentlichen Schlüssel im Programm geprüft wird. Veröffentlichte Version: 0.9.38.