Implementieren des Gmail-Versands mit Cloudflare Workers – Entwicklungshandbuch

Dies ist Teil 2 einer Serie zur Implementierung des Gmail-Versands mit Cloudflare Workers:

• Teil 1: Einrichtung ✅
• Teil 2: Entwicklungsumgebung (aktuell)
• Teil 3: Implementierung (in Kürze erhältlich)

Einführung

Nachdem wir in Teil 1 den Gmail-API-Zugriff eingerichtet haben, konfigurieren wir nun unsere Entwicklungsumgebung für Cloudflare Workers. Dieser Leitfaden konzentriert sich auf die Erstellung eines robusten Entwicklungs-Setups, das nahtlos mit Cloudflare Pages und Workers funktioniert.

Grundlegendes zur Cloudflare-Infrastruktur

Cloudflare arbeitet auf einer weltweit verteilten Edge-Computing-Plattform. Wenn der Datenverkehr zunimmt, werden Seiten auf diesen Servern repliziert und Benutzer werden zum nächstgelegenen Server weitergeleitet. Diese serverlose Architektur macht die Verwaltung eigener Server, Docker-Container oder Kubernetes-Cluster überflüssig.

Cloudflare-Mitarbeiter und -Seiten

Arbeitnehmerübersicht

Cloudflare Worker sind serverlose Funktionen, die die Anforderungsverarbeitung übernehmen. Während Cloudflare Pages das Frontend (statische Inhalte) verwaltet, verwalten Worker Backend-Vorgänge wie Formularverarbeitung und E-Mail-Versand.

Verfügbare Speicheroptionen

Mitarbeiter können verschiedene Cloudflare-Speicherlösungen integrieren:

1. D1:

   • SQLite-basierte serverlose SQL-Datenbank
   • Bis zu 10 GB Speicherkapazität
   • 30-Tage-Zeitreisefunktion

2. KV (Schlüsselwert):

   • Global verteilter Schlüsselwertspeicher
   • Optimiert für Kantenlesung

3. Langlebige Gegenstände:

   • Konsequentes Zustandsmanagement
   • Ideal für verteilte Systeme

4. R2:

   • S3-kompatibler Objektspeicher
   • Funktion zur Handhabung großer Dateien

5. Hyperantrieb:

   • PostgreSQL-Datenbank-Connector
   • Optimiertes Verbindungspooling

Wichtige Hinweise zu Wrangler

Die jüngsten Änderungen am Nutzungsverhalten von Wrangler erfordern Aufmerksamkeit. Früher wurde Wrangler normalerweise global installiert, aber der empfohlene Ansatz hat sich geändert:

Alte Methode (nicht empfohlen):

npm install -g wrangler
wrangler init my-project

Neue empfohlene Methode:

npm create cloudflare@latest

Diese Änderung sorgt für eine bessere Projektisolation und Versionsverwaltung.

Sprachumgebung in Cloudflare Workers

Während Cloudflare Workers möglicherweise Node.js ähnelt, gibt es wichtige Unterschiede:

• Native Node.js-Module sind nicht verfügbar
• Code muss browserkompatibel sein
• TypeScript wird unterstützt und bietet starke Vorteile beim Tippen
• Node.js wird pro Projekt nur für die Entwicklung installiert
• Direkte HTTP-Anfragen müssen anstelle von Node.js-Bibliotheken verwendet werden

Grundlegendes zu Cloudflare Pages-Anwendungen

Cloudflare Pages-Anwendungen unterscheiden sich von herkömmlichen Workern:

• Es handelt sich um vollständig integrierte Webanwendungen, die auf der Cloudflare Pages-Plattform ausgeführt werden
• Pages Functions erweitern diese Funktionalität über das /functions-Verzeichnis
• Diese Integration ermöglicht die serverseitige Verarbeitung (wie E-Mail-Verarbeitung) direkt in Ihrer Pages-Anwendung
• Bei Verwendung von Pages-Funktionen ist keine separate Worker-Bereitstellung erforderlich

Einrichtung der Entwicklungsumgebung

1. Voraussetzungen

• Erstellen Sie ein Cloudflare-Konto
• Verbinden Sie Ihr GitHub-Repository mit Pages
• Bereitstellungseinstellungen konfigurieren

2. Einrichtung der Projektstruktur

Erstellen Sie die folgende Verzeichnisstruktur:

npm install -g wrangler
wrangler init my-project

Initialisieren mit:

npm create cloudflare@latest

3. Abhängigkeiten installieren

your-project/
├── src/
│   └── pages/
│       └── index.astro
├── functions/
│   ├── contact-form.ts
│   └── tsconfig.json
├── public/
├── astro.config.mjs
├── package.json
└── wrangler.toml

4. Konfigurieren Sie TypeScript

Zu „functions/tsconfig.json“ hinzufügen:

mkdir functions
touch functions/contact-form.ts functions/tsconfig.json wrangler.toml

Projekt tsconfig.json aktualisieren:

npm install --save-dev typescript @cloudflare/workers-types

Nächste Schritte

Im nächsten Artikel dieser Reihe werden die Implementierungsdetails behandelt, darunter:

• Erstellen der E-Mail-Versandfunktion
• Bearbeitung von Formulareinsendungen
• Fehlerbehandlung und Validierung
• Testen und Bereitstellung

Bleiben Sie gespannt auf Teil 3, in dem wir alles mit der tatsächlichen Umsetzung zusammenführen.

Das obige ist der detaillierte Inhalt vonImplementieren des Gmail-Versands mit Cloudflare Workers – Entwicklungshandbuch. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!