Documentation · System Requirements

Configuration requise pour l'hébergement

Introduction

ADP Car Market Hub n'impose pas d'exigences inhabituelles à un hébergeur WordPress : tout fournisseur qui répond aux exigences officielles de WordPress et autorise le trafic HTTPS sortant vers l'API AutoScout24 peut l'exécuter. Cela dit, les importations de véhicules impliquent des milliers d'appels API, des téléchargements d'images, des tâches d'arrière-plan planifiées et une bibliothèque de médias en pleine croissance, de sorte que le profil d'hébergement pratique est plus proche d'une boutique WooCommerce active que d'un site vitrine.

Ce document décrit l'hébergement, les ressources serveur, l'accès HTTPS sortant, le stockage, les sauvegardes, l'environnement de staging et les considérations de préparation à la mise en production pour ADP Car Market Hub.

Quand utiliser ce document

Utilisez ce document lorsque vous :

Choisissez une offre d'hébergement pour le site d'une nouvelle concession.
Validez qu'un hébergeur existant peut gérer confortablement la charge de travail d'importation de l'extension.
Planifiez la capacité de stockage pour les images de véhicules et les journaux de l'extension.
Configurez un environnement de staging, une politique de sauvegarde ou une liste de contrôle de mise en production.

Aperçu

Le profil d'hébergement de l'extension est façonné par ces charges de travail :

Requêtes HTTPS sortantes périodiques vers AutoScout24 (à chaque exécution du cron) et vers le point de terminaison géré Google Gemini lorsque l'AI Assistant est activé.
Téléchargements d'images depuis les hébergeurs d'images de AutoScout24 vers wp-content/uploads/, avec réencodage WebP optionnel.
Pics de processeur (CPU) et de mémoire PHP pendant les tâches du Batch-Wizard, de Full Sync et de génération par IA.
Écritures continues à faible volume dans la base de données pour les événements d'analyse, les leads, les alertes de recherche et les battements de cœur du cron.
Journaux basés sur des fichiers dans wp-content/uploads/as24ci-logs/ (rotation à 10 Mo, rétention de 7 jours).

Un hébergeur capable de faire fonctionner confortablement une boutique WooCommerce de taille moyenne exécutera cette extension sans aucun problème.

Configuration requise

Serveur web

Logiciel : Tout serveur web officiellement pris en charge par WordPress — généralement Nginx ou Apache (LiteSpeed et Caddy conviennent également en pratique).
HTTPS : Un certificat TLS valide sur le site public. Il n'y a pas d'obligation au niveau de l'extension, mais l'API AutoScout24 et les navigateurs modernes exigent le HTTPS.
Gestionnaire PHP : PHP-FPM (ou équivalent) avec PHP 8.1+ (voir Configuration requise pour PHP et la base de données pour plus de détails).
Réécriture d'URL : Moteur de réécriture actif (mod_rewrite pour Apache, try_files pour Nginx) afin que les permaliens personnalisés et l'API REST fonctionnent.

Ressources serveur

Il s'agit de recommandations pratiques ; le code de l'extension n'impose pas de valeurs spécifiques au-delà des limites PHP vérifiées par l'onglet Système & Aide.

Processeur (CPU) : 1 vCPU minimum pour les petits inventaires (< 100 véhicules) ; 2 vCPU+ recommandés pour les inventaires de taille moyenne ou lorsque la génération par IA est activée.
RAM : 1 Go de mémoire serveur totale minimum ; 2 Go+ recommandés. La limite de mémoire PHP (memory_limit) de l'extension doit être d'au moins 256 Mo (l'onglet Système & Aide signale tout ce qui est inférieur à 128 Mo comme "trop bas").
Temps d'exécution PHP : Un max_execution_time de 120 secondes ou plus est recommandé pour les importations riches en images ; l'onglet Système & Aide signale 30 à 60 secondes comme simplement "acceptable".
Simultanéité : Autorisez au moins 2 processus PHP simultanés (workers) afin qu'une importation de longue durée ne bloque pas le site public ou le tableau de bord d'administration.

Accès HTTPS sortant

Le serveur doit être capable de faire des requêtes HTTPS sortantes (port 443) vers :

https://api.autoscout24.com — obligatoire. Utilisé par l'importateur pour les jetons OAuth, les annonces et les URL d'images.
Hébergeurs CDN d'images AutoScout24 — obligatoire. Les URL d'images de véhicules renvoyées par l'API sont téléchargées directement.
https://generativelanguage.googleapis.com — requis lorsque l'AI Assistant est activé. Utilisé pour appeler le point de terminaison géré Google Gemini configuré dans AS24CI\Ai_Config.
https://api.wordpress.org — recommandé, pour que WordPress et les mises à jour de l'extension fonctionnent normalement.

Si l'hébergeur utilise un pare-feu sortant ou un proxy, autorisez ces destinations et assurez-vous que les transports HTTP standard de WordPress (wp_remote_get / wp_remote_post, qui utilisent cURL en arrière-plan) fonctionnent.

Stockage

Espace disque libre minimum : L'onglet Système & Aide signale < 100 Mo libres comme critique et < 500 Mo libres comme un avertissement. Considérez 1 Go libre comme un minimum absolu, même pour les petits inventaires.
Dimensionnement pratique : Prévoyez environ 5 à 25 Mo de stockage multimédia par véhicule, selon le nombre d'images et si la conversion WebP est activée. Un concessionnaire de 200 véhicules utilise généralement 1 à 5 Go de téléversements.
Permissions du système de fichiers : wp-content/uploads/ doit être accessible en écriture par le processus PHP. L'extension créera wp-content/uploads/as24ci-logs/ lors de la première utilisation et le protégera avec les fichiers de sécurisation standard de WordPress.
Limites d'inodes : Les hébergeurs ayant des quotas d'inodes stricts doivent tenir compte de la présence de nombreux petits fichiers (chaque image de véhicule plus ses tailles intermédiaires générées par WordPress).

E-mail

Un canal d'e-mails transactionnels fonctionnel est requis pour les fonctionnalités destinées aux utilisateurs finaux :

Notifications de leads depuis le formulaire de contact.
Notifications de réservation d'essai routier.
Confirmations de double opt-in pour les alertes de recherche (Smart Stock Alerts).
E-mails administratifs de WordPress (réinitialisations de mot de passe, notifications d'erreurs).

Un MTA fourni par l'hébergement, une extension SMTP pointant vers un fournisseur de délivrabilité (Postmark, SendGrid, Brevo, Amazon SES, etc.) ou un relais SMTP d'entreprise conviennent tous.

Sauvegardes

L'extension n'intègre pas de mécanisme de sauvegarde — les sauvegardes relèvent de la responsabilité de l'hébergeur. Un déploiement en production doit inclure :

Des sauvegardes quotidiennes de la base de données couvrant toutes les tables WordPress, y compris les tables personnalisées de l'extension ({prefix}as24_vehicles, la table d'analyse, la table des alertes de recherche).
Des sauvegardes quotidiennes du système de fichiers de wp-content/uploads/ (images de véhicules et journaux de l'extension) et de wp-content/plugins/.
Une conservation hors site d'au moins 7 jours ; plus longue si les politiques locales de protection des données l'exigent.
Des tests de restauration au moins une fois par trimestre. Les suppressions lors de la Full Sync sont permanentes, les sauvegardes testées sont donc l'unique moyen de récupération.

Staging et préparation à la mise en production

Un environnement de staging propre est fortement recommandé avant le lancement ou la mise à niveau :

Une instance WordPress distincte sur les mêmes versions PHP/MySQL que la production.
Des identifiants AutoScout24 distincts dans la mesure du possible, ou une utilisation en lecture seule pour éviter de modifier les données de production.
Des jetons de cron distincts pour chaque environnement.
Un processus de déploiement documenté (export/import de base de données, recherche-remplacement d'URL, réactivation de l'extension pour rafraîchir les rôles et les règles de réécriture).
L'onglet "Système & Aide" / Santé de l'extension doit passer tous les contrôles sur le staging avant de déployer les modifications en production.

Configuration de production recommandée

Hébergement WordPress géré sur une branche PHP 8.x récente avec PHP-FPM, Nginx ou Apache, MySQL 8 / MariaDB 10.6+, et un conteneur ou une machine virtuelle avec au moins 1 vCPU / 2 Go de RAM.
TLS 1.2+ sur les connexions entrantes et une pile TLS sortante moderne avec des certificats CA à jour.
PHP memory_limit de 256 Mo+, max_execution_time de 300 s, upload_max_filesize de 64 Mo+.
10 Go+ de disque alloués à wp-content/uploads/ dès le premier jour.
Cron au niveau du système d'exploitation déclenchant wp-cron.php (ou le point de terminaison REST cron de l'extension) toutes les 5 à 15 minutes, avec DISABLE_WP_CRON défini dans wp-config.php.
SMTP via un fournisseur transactionnel avec SPF/DKIM/DMARC correctement alignés.
Sauvegardes quotidiennes hors site de la base de données + des téléversements, conservées pendant au moins 30 jours.
Environnement de staging identique, rafraîchi périodiquement à partir de la production.
Surveillance de la disponibilité (uptime) sur l'URL de l'archive publique et sur le point de terminaison du déclencheur cron.

Notes opérationnelles

Les images de véhicules représentent la majeure partie de la croissance du disque. Surveillez l'utilisation des téléversements au fil du temps et supprimez les médias obsolètes (l'extension supprime automatiquement les images des voitures supprimées) ou déplacez les téléversements vers un stockage objet via une extension de déchargement de médias (media-offload).
Les hébergeurs ayant un recyclage agressif des processus PHP (par exemple, arrêt des processus après 30 s) peuvent interrompre les importations volumineuses. Utilisez le Batch-Wizard (petits lots adaptatifs) ou la file d'attente d'images (traitement asynchrone) au lieu d'une seule importation géante.
Les CDN et les proxys inverses doivent transmettre le paramètre de requête du jeton cron sans le modifier, et ne doivent pas mettre en cache les réponses de wp-admin/, wp-login.php, wp-cron.php ou /wp-json/as24ci/v1/*.
Le point de terminaison géré Gemini peut présenter une latence élevée par requête. Si vous activez la génération par IA pendant les importations, augmentez max_execution_time en conséquence et privilégiez la file d'attente de génération par IA asynchrone.
Les journaux de l'extension augmentent régulièrement lorsque la journalisation détaillée est activée. L'extension effectue une rotation à 10 Mo et supprime les fichiers pivotés de plus de 7 jours, mais le répertoire doit tout de même être inclus dans la surveillance régulière de l'utilisation du disque.

Dépannage

Importations lentes / expirations fréquentes (timeouts) : Augmentez la mémoire PHP et le temps d'exécution, réduisez la taille du lot de véhicules par cron et assurez-vous que la file d'attente d'images est activée.
"Problème de connexion – impossible de récupérer les annonces" : Vérifiez l'accès HTTPS sortant vers api.autoscout24.com, la résolution DNS depuis le serveur et si un proxy d'entreprise ou un WAF intercepte la requête.
Échec du téléchargement des images : Vérifiez l'espace disque libre, les permissions du dossier des téléversements et l'accessibilité des hébergeurs d'images AutoScout24.
Alertes d'espace disque : Utilisez la carte de stockage de l'onglet Système & Aide pour confirmer le volume d'espace libre, puis nettoyez les anciens médias ou augmentez la taille du volume.
E-mails non distribués : Configurez une extension SMTP ou un MTA d'hébergement ; de nombreux hébergeurs partagés bloquent l'utilisation directe de mail() de PHP.
Les sauvegardes ne capturent pas toutes les données de l'extension : Assurez-vous que l'outil de sauvegarde couvre l'intégralité de la base de données WordPress (y compris les tables personnalisées préfixées par {wp_prefix}as24_) et l'intégralité du répertoire wp-content/uploads/.