# Configuration Email - Bluehost SMTP

## 🔧 Configuration Bluehost dans `.env`

Ajoutez ou modifiez ces lignes dans `api/.env` :

```env
# Type de mailer
MAIL_MAILER=smtp

# Serveur SMTP Bluehost
MAIL_HOST=smtp.bluehost.com
MAIL_PORT=587

# Authentification (utilisez votre email Bluehost complet)
MAIL_USERNAME=votre_email@votre-domaine.com
MAIL_PASSWORD=votre_mot_de_passe_email

# Chiffrement TLS (recommandé pour le port 587)
MAIL_ENCRYPTION=tls

# Adresse et nom de l'expéditeur
MAIL_FROM_ADDRESS=noreply@sommet-francophone.org
MAIL_FROM_NAME="Sommet Francophone"
```

## 📝 Exemple complet

```env
MAIL_MAILER=smtp
MAIL_HOST=smtp.bluehost.com
MAIL_PORT=587
MAIL_USERNAME=contact@sommet-francophone.org
MAIL_PASSWORD=votre_mot_de_passe
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS="noreply@sommet-francophone.org"
MAIL_FROM_NAME="Sommet Francophone"
```

## ⚙️ Paramètres Bluehost

### Ports disponibles

- **Port 587** (TLS) - **Recommandé** : Port standard pour SMTP avec authentification
- **Port 465** (SSL) : Alternative si le port 587 ne fonctionne pas
- **Port 25** : Non recommandé (souvent bloqué)

### Configuration avec port 465 (SSL)

Si le port 587 ne fonctionne pas, essayez :

```env
MAIL_MAILER=smtp
MAIL_HOST=smtp.bluehost.com
MAIL_PORT=465
MAIL_USERNAME=votre_email@votre-domaine.com
MAIL_PASSWORD=votre_mot_de_passe
MAIL_ENCRYPTION=ssl
MAIL_FROM_ADDRESS="noreply@sommet-francophone.org"
MAIL_FROM_NAME="Sommet Francophone"
```

## ✅ Étapes de configuration

### 1. Récupérer les identifiants Bluehost

1. Connectez-vous à votre compte Bluehost
2. Allez dans **Email Accounts** (Comptes email)
3. Notez :
   - L'adresse email complète (ex: `contact@sommet-francophone.org`)
   - Le mot de passe de l'email

### 2. Modifier le fichier `.env`

Ouvrez `api/.env` et ajoutez/modifiez les variables `MAIL_*` comme indiqué ci-dessus.

### 3. Vider le cache

```bash
cd api
php artisan config:clear
php artisan config:cache
```

### 4. Tester la configuration

#### Option A : Via Tinker

```bash
php artisan tinker
```

Puis :
```php
use Illuminate\Support\Facades\Mail;

Mail::raw('Test email depuis Laravel', function ($message) {
    $message->to('votre-email-personnel@example.com')
            ->subject('Test Email Bluehost');
});
```

#### Option B : Créer une route de test (temporaire)

Dans `routes/api.php` (à supprimer après test) :

```php
Route::get('/test-email-bluehost', function () {
    try {
        \Illuminate\Support\Facades\Mail::raw('Test email depuis Laravel avec Bluehost', function ($message) {
            $message->to('votre-email-personnel@example.com')
                    ->subject('Test Email Bluehost');
        });
        return response()->json(['message' => 'Email envoyé avec succès via Bluehost']);
    } catch (\Exception $e) {
        return response()->json([
            'error' => $e->getMessage(),
            'file' => $e->getFile(),
            'line' => $e->getLine(),
        ], 500);
    }
});
```

Puis tester : `GET http://localhost:8000/api/test-email-bluehost`

## 🔐 Sécurité - PLAIN/LOGIN avec TLS/SSL

**Important** : Si vous voyez "PLAIN" ou "LOGIN" dans les logs, c'est **normal et sécurisé** !

- Ces méthodes d'authentification sont **chiffrées** quand vous utilisez `MAIL_ENCRYPTION=tls` ou `ssl`
- Toute la communication (y compris l'authentification) passe dans un **tunnel chiffré**
- C'est la méthode standard utilisée par tous les serveurs SMTP (Gmail, Outlook, etc.)
- **Ce n'est PAS** du plain text si TLS/SSL est activé

**Analogie** : C'est comme envoyer une lettre dans une enveloppe scellée (TLS) plutôt que sur une carte postale.

## 🔍 Dépannage

### Erreur 535 : "Incorrect authentication data"

**Causes possibles** :
1. Mot de passe incorrect
2. Nom d'utilisateur incorrect (doit être l'email complet)
3. Serveur SMTP incorrect
4. Compte email n'existe pas dans Bluehost

**Solutions** :
1. Vérifier que le compte email existe dans Bluehost
2. Vérifier le mot de passe (réinitialiser si nécessaire)
3. Utiliser l'email complet pour `MAIL_USERNAME` (ex: `contact@haggai-bf.org`)
4. Tester avec un client email (Thunderbird/Outlook) pour vérifier les identifiants
5. Essayer `smtp.bluehost.com` au lieu de `mail.votre-domaine.com`

**Voir le guide complet** : `DEPANNAGE_EMAIL_BLUEHOST.md`

### Erreur : "Connection timeout"

**Solutions** :
1. Vérifiez que le port 587 n'est pas bloqué par votre firewall
2. Essayez le port 465 avec SSL
3. Vérifiez que `MAIL_HOST=smtp.bluehost.com` est correct

### Erreur : "Authentication failed"

**Solutions** :
1. Vérifiez que `MAIL_USERNAME` est l'email complet (ex: `contact@votre-domaine.com`)
2. Vérifiez que `MAIL_PASSWORD` est correct
3. Assurez-vous que le compte email existe dans Bluehost

### Erreur : "Could not authenticate"

**Solutions** :
1. Vérifiez que l'authentification SMTP est activée dans Bluehost
2. Essayez de vous connecter manuellement avec un client email (Thunderbird, Outlook) pour vérifier les identifiants
3. Vérifiez que le domaine est bien configuré dans Bluehost

### Erreur : "Connection refused"

**Solutions** :
1. Vérifiez que le serveur SMTP Bluehost est accessible
2. Essayez `ping smtp.bluehost.com` pour vérifier la connectivité
3. Vérifiez les paramètres de firewall

## 📊 Vérifier les logs

Si l'email échoue, vérifiez les logs Laravel :

```bash
tail -f api/storage/logs/laravel.log
```

Cherchez les erreurs liées à `Mail` ou `SMTP`.

## 🔐 Sécurité

**Important** : Ne commitez jamais le fichier `.env` dans Git. Il contient des mots de passe sensibles.

Le fichier `.env` devrait être dans `.gitignore` (ce qui est normalement le cas par défaut dans Laravel).

## 📝 Notes importantes

1. **MAIL_FROM_ADDRESS** : Doit être une adresse email valide sur votre domaine Bluehost
2. **MAIL_USERNAME** : Utilisez l'email complet, pas juste le nom d'utilisateur
3. **Limites Bluehost** : Vérifiez les limites d'envoi d'emails de votre plan Bluehost (généralement 500 emails/heure)

## 🚀 Production

Une fois que la configuration fonctionne en développement, vous pouvez utiliser les mêmes paramètres en production, ou configurer un service dédié comme SendGrid/Mailgun pour de meilleures performances.

---

**Document créé le** : 2026-01-XX