📄 Guide d'installation PDF pour serveur OVH

🎯 Objectif

Permettre l'envoi de factures et devis en PDF par email sur votre serveur OVH.

---

✅ Solution 1 : wkhtmltopdf (VPS/Serveur dédié)

Si vous avez un VPS ou serveur dédié OVH avec accès SSH :

Installation

```bash

Connexion SSH à votre serveur

ssh votre-utilisateur@votre-serveur.ovh.net

Installation (Debian/Ubuntu)

sudo apt-get update

sudo apt-get install wkhtmltopdf

Vérification

wkhtmltopdf --version

```

Le script détectera automatiquement l'installation.

---

✅ Solution 2 : TCPDF (Hébergement mutualisé - RECOMMANDÉ)

Cette solution fonctionne sur TOUS les hébergements OVH, même mutualisés !

Installation automatique

1. Accédez à l'interface d'administration

- Allez sur : https://votre-site.com/pages/admin/install-tcpdf.php

- Connectez-vous avec vos identifiants admin

1. Le script va :

- Télécharger TCPDF automatiquement

- L'installer dans le bon dossier

- Vérifier l'installation

Installation manuelle (si l'automatique ne fonctionne pas)

1. Téléchargez TCPDF

- URL : https://github.com/tecnickcom/TCPDF/archive/refs/heads/main.zip

- Téléchargez l'archive ZIP

1. Extrayez l'archive

- Extrayez le fichier ZIP

- Vous obtenez un dossier "TCPDF-main"

1. Uploadez sur votre serveur

- Via FTP/SFTP, créez le dossier : pages/admin/vendor/

- Renommez "TCPDF-main" en "tcpdf"

- Uploadez le dossier "tcpdf" dans pages/admin/vendor/

1. Structure finale

```

pages/admin/vendor/tcpdf/tcpdf.php

pages/admin/vendor/tcpdf/tcpdf_autoconfig.php

etc.

```

1. Vérification

- Accédez à : pages/admin/install-tcpdf.php

- Vérifiez que l'installation est confirmée

---

🧪 Test de l'installation

1. Allez dans l'administration
2. Ouvrez une facture ou un devis
3. Cliquez sur "📧 Envoyer par email"
4. Remplissez le formulaire et envoyez
5. Vérifiez votre boîte email
6. Le PDF doit être attaché à l'email !

---

🔧 Ordre de priorité

Le système essaie dans cet ordre :

1. wkhtmltopdf (si installé) - Meilleure qualité
2. TCPDF (si installé) - Fonctionne partout
3. Email HTML uniquement (si aucune solution disponible)

---

❓ Problèmes courants

Le PDF n'est pas généré

• Vérifiez que TCPDF est bien installé : pages/admin/vendor/tcpdf/tcpdf.php existe
• Vérifiez les permissions du dossier vendor/ (755)
• Consultez les logs d'erreur PHP

Erreur "Class TCPDF not found"

• Vérifiez que le fichier tcpdf.php existe bien
• Vérifiez le chemin : pages/admin/vendor/tcpdf/tcpdf.php

Le PDF est vide ou mal formaté

• TCPDF a des limitations avec le CSS complexe
• Le PDF sera fonctionnel mais peut avoir un rendu différent de wkhtmltopdf

---

📞 Support

Si vous rencontrez des problèmes :

1. Vérifiez les logs d'erreur PHP
2. Testez avec install-tcpdf.php
3. Vérifiez les permissions des dossiers

---

✨ Avantages de chaque solution

wkhtmltopdf

• ✅ Meilleure qualité de rendu
• ✅ Support CSS complet
• ✅ Rendu identique au navigateur
• ❌ Nécessite accès SSH
• ❌ Ne fonctionne pas sur hébergement mutualisé

TCPDF

• ✅ Fonctionne sur tous les hébergements
• ✅ Pas besoin d'accès SSH
• ✅ Bibliothèque PHP pure
• ✅ Installation simple
• ⚠️ Limitations CSS (mais fonctionnel)

---

Recommandation : Utilisez TCPDF pour un hébergement mutualisé OVH, c'est la solution la plus simple et la plus fiable !