Refactor email handling in contact form: Transitioned from PHPMailer to native PHP mail() function, removing Composer dependencies. Updated documentation to reflect changes in email configuration and setup. Enhanced security features including CSRF protection and input validation. Adjusted product pricing and specifications in backend configuration files.

2026-05-27 13:04:52 +02:00
parent d44aaa197b
commit 67fbc68d45
9 changed files with 125 additions and 489 deletions
--- a/docs/KONTAKTFORMULAR-STATUS.md
+++ b/docs/KONTAKTFORMULAR-STATUS.md
@@ -1,145 +1,34 @@
-# HexaHost.de Kontaktformular - Status-Überprüfung
+# HexaHost.de Kontaktformular - Status

-## ✅ Behobene Probleme
+## Aktueller Stand

-### 1. Merge-Konflikt in contact-handler.php
- **Problem**: Git-Merge-Konflikt machte die Datei unbrauchbar
- **Lösung**: Konflikt aufgelöst, saubere Version erstellt
- **Status**: ✅ Behoben
+- Kontaktformular und Handler sind funktionsfähig
+- Versand erfolgt nativ über PHP `mail()`
+- Keine PHPMailer-/Composer-Abhängigkeit mehr

-### 2. CSRF-Token Problem
- **Problem**: HTML-Formular versuchte PHP-Code zu verwenden
- **Lösung**: CSRF-Token durch Honeypot-Feld ersetzt
- **Status**: ✅ Behoben
+## Sicherheitsfunktionen

-### 3. JavaScript-Merge-Konflikt
- **Problem**: Merge-Konflikt in contact.js
- **Lösung**: Konflikt aufgelöst
- **Status**: ✅ Behoben
+- CSRF-Token-Prüfung
+- Rate Limiting pro IP
+- Honeypot gegen Bots
+- E-Mail-Validierung und Input-Sanitization

-## ⚠️ Noch zu behebende Probleme
+## Konfiguration für Produktivbetrieb

-### 1. SMTP-Konfiguration
- **Problem**: SMTP-Einstellungen sind noch auf Testwerte
- **Aktueller Status**: 
-  ```php
-  'smtp_host' => 'smtp.gmail.com',
-  'smtp_username' => 'test@hexahost.de',
-  'smtp_password' => 'your-app-password',
-  ```
- **Erforderlich**: Echte SMTP-Daten eintragen
- **Status**: ⚠️ Zu konfigurieren
+Datei: `backend/config/mail-config.php`

-### 2. PHPMailer-Installation
- **Problem**: Composer ist nicht installiert
- **Aktueller Status**: Fallback auf native PHP mail() Funktion
- **Erforderlich**: Composer installieren und PHPMailer einrichten
- **Status**: ⚠️ Optional (Fallback funktioniert)
+Zu prüfen:
+- `SMTP_FROM_EMAIL` ist eine gültige Absenderadresse
+- `SMTP_TO_EMAIL` ist das richtige Zielpostfach
+- `mail()` ist beim Hoster aktiv

-## 📧 E-Mail-Funktionalität
+## Testempfehlung

-### Aktuelle Konfiguration
- **SMTP-Host**: smtp.gmail.com
- **Port**: 587
- **Verschlüsselung**: TLS
- **Fallback**: Native PHP mail() Funktion
+1. `scripts/test-email.php` ausführen
+2. Kontaktformular über `contact.php` absenden
+3. Empfang und Darstellung der E-Mail prüfen

-### Sicherheitsfeatures
- ✅ Rate Limiting (5 Anfragen/Stunde)
- ✅ Honeypot-Schutz
- ✅ Input-Sanitization
- ✅ E-Mail-Validierung
- ✅ Anti-Spam-Headers
+## Hinweis

-### E-Mail-Templates
- ✅ HTML-Template mit HexaHost-Design
- ✅ Text-Version als Fallback
- ✅ Responsive Design
- ✅ Strukturierte Darstellung aller Daten
+Falls der Versand nicht funktioniert, liegt die Ursache in der Regel an der Server-Mailkonfiguration (MTA/`mail()`), nicht am Formular-Code.

-## 🧪 Test-Möglichkeiten
-
-### 1. Test-Datei
- **Datei**: `test-email.php`
- **Zweck**: E-Mail-Funktionalität ohne Formular testen
- **Verwendung**: Im Browser öffnen und "Test-E-Mail senden" klicken
-
-### 2. Kontaktformular
- **Datei**: `contact.html`
- **Zweck**: Vollständiges Formular testen
- **Verwendung**: Formular ausfüllen und absenden
-
-## 🔧 Konfiguration erforderlich
-
-### Für Produktivbetrieb:
-
-1. **SMTP-Daten eintragen** in `config.php`:
-   ```php
-   'smtp_username' => 'ihre-echte-email@gmail.com',
-   'smtp_password' => 'ihr-echtes-app-passwort',
-   'from_email' => 'ihre-echte-email@gmail.com',
-   'to_email' => 'info@hexahost.de',
-   ```
-
-2. **Composer installieren** (optional):
-   ```bash
-   # Windows: Composer-Installer herunterladen
-   # Linux/macOS:
-   curl -sS https://getcomposer.org/installer | php
-   sudo mv composer.phar /usr/local/bin/composer
-   ```
-
-3. **PHPMailer installieren** (optional):
-   ```bash
-   cd public
-   composer install
-   ```
-
-## 📊 Funktionsfähigkeit
-
-### ✅ Funktioniert
- Kontaktformular-HTML
- JavaScript-Validierung
- PHP-Backend-Verarbeitung
- Rate Limiting
- Spam-Schutz
- E-Mail-Templates
- Fallback auf native mail() Funktion
-
-### ⚠️ Benötigt Konfiguration
- SMTP-Einstellungen
- PHPMailer (optional)
-
-### ❌ Nicht funktioniert
- E-Mail-Versand ohne SMTP-Konfiguration
-
-## 🚀 Nächste Schritte
-
-1. **SMTP-Konfiguration anpassen**
-   - Echte SMTP-Daten in `config.php` eintragen
-   - Test mit `test-email.php`
-
-2. **E-Mail-Funktionalität testen**
-   - Kontaktformular ausfüllen
-   - E-Mail-Empfang prüfen
-
-3. **PHPMailer installieren** (optional)
-   - Composer installieren
-   - PHPMailer einrichten
-
-4. **DNS-Einträge konfigurieren**
-   - SPF Record
-   - DMARC Record
-   - DKIM (über Mail-Server)
-
-## 📞 Support
-
-Bei Problemen:
-1. `test-email.php` verwenden
-2. PHP-Error-Logs prüfen
-3. SMTP-Konfiguration überprüfen
-4. Hosting-Provider kontaktieren
-
---
-
-**Status**: Kontaktformular ist funktionsfähig, benötigt nur SMTP-Konfiguration für E-Mail-Versand. 
--- a/docs/README-EMAIL-SETUP.md
+++ b/docs/README-EMAIL-SETUP.md
@@ -2,172 +2,54 @@

 ## Übersicht

-Das Kontaktformular von HexaHost.de benötigt eine korrekte SMTP-Konfiguration, um E-Mails zu versenden. Diese Anleitung erklärt, wie Sie die E-Mail-Funktionalität einrichten.
+Das Kontaktformular nutzt den nativen PHP-Mailversand über `mail()`.
+Es wird keine zusätzliche Bibliothek und keine Composer-Installation benötigt.

-## Aktuelle Probleme
+## Erforderliche Konfiguration

-### 1. ✅ Behoben: Merge-Konflikt in contact-handler.php
- Der Git-Merge-Konflikt wurde aufgelöst
- Die Datei ist jetzt funktionsfähig
+Datei: `backend/config/mail-config.php`

-### 2. ⚠️ Zu beheben: SMTP-Konfiguration
- Die SMTP-Einstellungen sind noch auf Testwerte gesetzt
- Sie müssen mit echten SMTP-Daten konfiguriert werden
+Mindestens diese Werte müssen korrekt gesetzt sein:

-### 3. ⚠️ Zu beheben: PHPMailer-Installation
- Composer ist nicht installiert
- PHPMailer ist nicht verfügbar
- Fallback auf native PHP mail() Funktion ist aktiv
-
-## SMTP-Konfiguration
-
-### Option 1: Gmail SMTP (Empfohlen für Tests)
-
-1. **Gmail-Konto einrichten:**
-   - Gehen Sie zu Ihren Google-Kontoeinstellungen
-   - Aktivieren Sie "2-Schritt-Verifizierung"
-   - Erstellen Sie ein "App-Passwort"
-
-2. **config.php bearbeiten:**
 ```php
-'smtp_host' => 'smtp.gmail.com',
-'smtp_port' => 587,
-'smtp_username' => 'ihre-email@gmail.com',
-'smtp_password' => 'ihr-app-passwort',
-'smtp_encryption' => 'tls',
-'from_email' => 'ihre-email@gmail.com',
-'to_email' => 'info@hexahost.de',
+define('SMTP_FROM_EMAIL', 'kontakt@hexahost.de');
+define('SMTP_TO_EMAIL', 'info@hexahost.de');
 ```

-### Option 2: Eigener Mail-Server
+## Voraussetzungen auf dem Server

-1. **SMTP-Daten von Ihrem Hosting-Provider erhalten**
-2. **config.php bearbeiten:**
-```php
-'smtp_host' => 'mail.ihre-domain.de',
-'smtp_port' => 587,
-'smtp_username' => 'kontakt@ihre-domain.de',
-'smtp_password' => 'ihr-smtp-passwort',
-'smtp_encryption' => 'tls',
-'from_email' => 'kontakt@ihre-domain.de',
-'to_email' => 'info@hexahost.de',
-```
+- `mail()` muss in der PHP-Umgebung aktiviert sein
+- Ein Mail Transfer Agent (MTA) bzw. Mailversand beim Hoster muss funktionieren

-### Option 3: Andere E-Mail-Provider
+## Test der E-Mail-Funktion

-#### Outlook/Hotmail:
-```php
-'smtp_host' => 'smtp-mail.outlook.com',
-'smtp_port' => 587,
-'smtp_encryption' => 'tls',
-```
-
-#### GMX:
-```php
-'smtp_host' => 'mail.gmx.net',
-'smtp_port' => 587,
-'smtp_encryption' => 'tls',
-```
-
-#### Web.de:
-```php
-'smtp_host' => 'smtp.web.de',
-'smtp_port' => 587,
-'smtp_encryption' => 'tls',
-```
-
-## PHPMailer-Installation
-
-### Composer installieren:
-
-1. **Windows:**
-   - Laden Sie Composer von https://getcomposer.org/download/
-   - Führen Sie den Installer aus
-
-2. **Linux/macOS:**
-```bash
-curl -sS https://getcomposer.org/installer | php
-sudo mv composer.phar /usr/local/bin/composer
-```
-
-### PHPMailer installieren:
-
-```bash
-cd public
-composer install
-```
-
-## Test der E-Mail-Funktionalität
-
-### 1. Test-Datei verwenden:
- Öffnen Sie `test-email.php` im Browser
- Klicken Sie auf "Test-E-Mail senden"
-
-### 2. Kontaktformular testen:
- Öffnen Sie `contact.html`
- Füllen Sie das Formular aus
- Überprüfen Sie die Antwort
-
-## Sicherheitseinstellungen
-
-### DNS-Einträge für Spam-Schutz:
-
-1. **SPF Record (TXT):**
-```
-v=spf1 include:_spf.hexahost.de ~all
-```
-
-2. **DMARC Record (TXT):**
-```
-v=DMARC1; p=quarantine; rua=mailto:dmarc@hexahost.de
-```
-
-3. **DKIM (wird vom Mail-Server konfiguriert)**
+1. Per Script testen:
+   - `scripts/test-email.php`
+2. Kontaktformular testen:
+   - Seite `contact.php` öffnen
+   - Formular absenden
+   - Empfang im Zielpostfach prüfen

 ## Fehlerbehebung

-### Häufige Probleme:
+### Meldung: "Mail function not available"
+- `mail()` ist auf dem Server deaktiviert
+- Hoster kontaktieren und Mailfunktion aktivieren lassen

-1. **"SMTP connect() failed"**
-   - Überprüfen Sie Host und Port
-   - Prüfen Sie Firewall-Einstellungen
+### Nachricht kommt nicht an
+- Spam-Ordner prüfen
+- Absenderadresse (`SMTP_FROM_EMAIL`) auf gültige Domain setzen
+- PHP-Error-Log prüfen

-2. **"Authentication failed"**
-   - Überprüfen Sie Benutzername und Passwort
-   - Bei Gmail: App-Passwort verwenden
+### Versand funktioniert lokal nicht
+- Unter Windows/Lokalumgebung ist oft kein SMTP in `php.ini` konfiguriert
+- Auf dem echten Webserver testen

-3. **"Connection timeout"**
-   - Prüfen Sie Internetverbindung
-   - Überprüfen Sie SMTP-Host
+## Sicherheit

-4. **"Mail function not available"**
-   - PHP mail() Funktion ist deaktiviert
-   - Kontaktieren Sie Ihren Hosting-Provider
+Das Kontaktformular beinhaltet bereits:
+- CSRF-Schutz
+- Rate Limiting
+- Honeypot-Feld
+- Serverseitige Validierung und Sanitization

-## Debug-Modus aktivieren
-
-In `config.php` setzen Sie:
-```php
-'debug_mode' => true,
-```
-
-## Logs überprüfen
-
-E-Mail-Fehler werden in den PHP-Error-Logs gespeichert:
- Windows: Event Viewer
- Linux: `/var/log/php_errors.log`
-
-## Nächste Schritte
-
-1. ✅ Merge-Konflikt behoben
-2. ⚠️ SMTP-Konfiguration anpassen
-3. ⚠️ PHPMailer installieren (optional)
-4. ⚠️ E-Mail-Funktionalität testen
-5. ⚠️ DNS-Einträge für Spam-Schutz konfigurieren
-
-## Support
-
-Bei Problemen:
- Überprüfen Sie die PHP-Error-Logs
- Testen Sie mit `test-email.php`
- Kontaktieren Sie Ihren Hosting-Provider