Documentazione · Requisiti di sistema

Requisiti di hosting

Introduzione

ADP Car Market Hub non impone requisiti insoliti a un host WordPress: qualsiasi provider che soddisfi i requisiti ufficiali di WordPress e consenta connessioni HTTPS in uscita verso l'API di AutoScout24 è in grado di eseguirlo. Detto questo, l'importazione dei veicoli comporta migliaia di chiamate API, download di immagini, attività in background pianificate e una libreria multimediale in continua crescita, quindi il profilo di hosting pratico è più vicino a quello di un negozio WooCommerce trafficato che a quello di un sito vetrina.

Questo documento descrive l'hosting, le risorse del server, l'accesso HTTPS in uscita, lo spazio di archiviazione, i backup, gli ambienti di staging e le considerazioni sulla prontezza per la produzione per ADP Car Market Hub.

Quando utilizzare questo documento

Utilizza questo documento quando desideri:

Scegliere un piano di hosting per il sito di una nuova concessionaria.
Verificare che un host esistente sia in grado di gestire agevolmente il carico di lavoro di importazione del plugin.
Pianificare la capacità di archiviazione per le immagini dei veicoli e i log del plugin.
Configurare un ambiente di staging, una politica di backup o una lista di controllo per la messa online.

Panoramica

Il profilo di hosting del plugin è delineato dai seguenti carichi di lavoro:

Connessioni HTTPS in uscita periodiche verso AutoScout24 (a ogni esecuzione del cron) e verso l'endpoint gestito di Google Gemini quando l'AI Assistant è abilitato.
Download di immagini dagli host di immagini di AutoScout24 in wp-content/uploads/, con ricodifica WebP opzionale.
Picchi di CPU e memoria PHP durante le attività di Batch-Wizard, Full Sync e generazione AI.
Scritture continue a basso volume nel database per eventi di analisi, lead, avvisi di ricerca e heartbeat del cron.
Log basati su file in wp-content/uploads/as24ci-logs/ (ruotati a 10 MB, con conservazione di 7 giorni).

Un host in grado di gestire agevolmente un negozio WooCommerce di medie dimensioni eseguirà questo plugin senza problemi.

Requisiti

Web server

Software: Qualsiasi web server ufficialmente supportato da WordPress — tipicamente Nginx o Apache (anche LiteSpeed e Caddy vanno bene nella pratica).
HTTPS: Un certificato TLS valido sul sito pubblico. Non vi è alcuna imposizione a livello di plugin, ma l'API di AutoScout24 e i browser moderni richiedono HTTPS.
Gestore PHP: PHP-FPM (o equivalente) con PHP 8.1+ (consulta Requisiti di PHP e database per i dettagli).
Riscrittura degli URL: Motore di riscrittura attivo (mod_rewrite per Apache, try_files per Nginx) in modo che i permalink personalizzati e la REST API funzionino correttamente.

Risorse del server

Queste sono raccomandazioni pratiche; il codice del plugin non impone valori specifici oltre ai limiti PHP verificati nella scheda System & Help.

CPU: Minimo 1 vCPU per inventari di piccole dimensioni (< 100 veicoli); consigliati 2 o più vCPU per inventari di medie dimensioni o quando la generazione AI è abilitata.
RAM: Minimo 1 GB di memoria totale del server; consigliati 2 GB o più. Il valore di memory_limit di PHP per il plugin dovrebbe essere di almeno 256 MB (la scheda System & Help segnala qualsiasi valore inferiore a 128 MB come "troppo basso").
Tempo di esecuzione PHP: Si consiglia un valore di max_execution_time pari o superiore a 120 secondi per importazioni con molte immagini; la scheda System & Help segnala valori compresi tra 30 e 60 secondi come semplicemente "accettabili".
Concorrenza: Consenti almeno 2 worker PHP concorrenti in modo che un'importazione a lungo termine non blocchi il sito pubblico o la bacheca di amministrazione.

Accesso HTTPS in uscita

Il server deve essere in grado di effettuare richieste HTTPS in uscita (porta 443) verso:

https://api.autoscout24.com — obbligatorio. Utilizzato dall'importatore per i token OAuth, gli annunci e gli URL delle immagini.
Host CDN di immagini di AutoScout24 — obbligatorio. Gli URL delle immagini dei veicoli restituiti dall'API vengono scaricati direttamente.
https://generativelanguage.googleapis.com — richiesto quando l'AI Assistant è abilitato. Utilizzato per chiamare l'endpoint gestito di Google Gemini configurato in AS24CI\Ai_Config.
https://api.wordpress.org — consigliato, affinché WordPress e gli aggiornamenti del plugin funzionino normalmente.

Se l'host utilizza un firewall o un proxy in uscita, consenti queste destinazioni e assicurati che i trasporti HTTP standard di WordPress (wp_remote_get / wp_remote_post, che utilizzano cURL sotto il cofano) funzionino.

Archiviazione

Spazio libero minimo su disco: La scheda System & Help segnala < 100 MB liberi come critico e < 500 MB liberi come avviso. Considera 1 GB libero come minimo assoluto, anche per piccoli inventari.
Dimensionamento pratico: Prevedi circa 5–25 MB di spazio di archiviazione multimediale per veicolo, a seconda del numero di immagini e dell'eventuale abilitazione della conversione in WebP. Un concessionario con 200 veicoli utilizza in genere 1–5 GB di caricamenti.
Permessi del file system: La cartella wp-content/uploads/ deve essere scrivibile dal processo PHP. Il plugin creerà wp-content/uploads/as24ci-logs/ al primo utilizzo e la proteggerà con i file di protezione standard di WordPress.
Limiti di inode: Gli host con quote di inode rigide dovrebbero tenere conto di molti file di piccole dimensioni (ogni immagine del veicolo più le relative dimensioni intermedie generate da WordPress).

Email

Per le funzionalità destinate all'utente finale è necessario un percorso di posta elettronica transazionale funzionante:

Notifiche dei lead dal modulo di contatto.
Notifiche di prenotazione dei test drive.
Conferme di double-opt-in per gli avvisi di ricerca (Smart Stock Alerts).
Email amministrative di WordPress (reimpostazione della password, notifiche di errore).

Funzionano sia un MTA fornito dall'hosting, sia un plugin SMTP collegato a un provider di recapito (Postmark, SendGrid, Brevo, Amazon SES, ecc.), sia un relay SMTP aziendale.

Backup

Il plugin non include un meccanismo di backup — i backup sono di responsabilità dell'hosting. Una distribuzione in produzione dovrebbe includere:

Backup giornalieri del database che coprano tutte le tabelle di WordPress, comprese le tabelle personalizzate del plugin ({prefix}as24_vehicles, la tabella di analisi, la tabella degli avvisi di ricerca).
Backup giornalieri del file system di wp-content/uploads/ (immagini dei veicoli e log del plugin) e wp-content/plugins/.
Conservazione off-site per almeno 7 giorni; più a lungo se richiesto dalle politiche locali di protezione dei dati.
Ripristini di prova almeno trimestrali. Le eliminazioni di Full Sync sono permanenti, pertanto i backup testati rappresentano l'unica via di ripristino.

Staging e prontezza per la produzione

Si raccomanda vivamente un ambiente di staging pulito prima del lancio o dell'aggiornamento:

Un'istanza separata di WordPress sulle stesse versioni PHP/MySQL della produzione.
Credenziali AutoScout24 distinte ove possibile, o utilizzo in sola lettura per evitare di alterare i dati di produzione.
Token cron distinti per ciascun ambiente.
Un processo di promozione documentato (esportazione/importazione del database, ricerca e sostituzione degli URL, riattivazione del plugin per aggiornare i ruoli e le regole di riscrittura).
La scheda "System & Help" / Health del plugin deve superare tutti i controlli in staging prima di promuovere le modifiche in produzione.

Configurazione di produzione consigliata

Hosting gestito per WordPress su un ramo PHP 8.x recente con PHP-FPM, Nginx o Apache, MySQL 8 / MariaDB 10.6+ e un container o VM con almeno 1 vCPU / 2 GB di RAM.
TLS 1.2+ sulle connessioni in entrata e uno stack TLS in uscita moderno con certificati CA aggiornati.
Valore di memory_limit di PHP pari a 256 MB+, max_execution_time a 300 s, upload_max_filesize a 64 MB+.
Almeno 10 GB di disco allocati a wp-content/uploads/ fin dal primo giorno.
Cron a livello di sistema operativo che attiva wp-cron.php (o l'endpoint cron REST del plugin) ogni 5–15 minuti, con DISABLE_WP_CRON impostato in wp-config.php.
SMTP tramite un provider transazionale con SPF/DKIM/DMARC correttamente allineati.
Backup giornalieri off-site di database + caricamenti, conservati per almeno 30 giorni.
Ambiente di staging identico, aggiornato periodicamente dalla produzione.
Monitoraggio dell'uptime sull'URL dell'archivio pubblico e sull'endpoint di attivazione del cron.

Note operative

Le immagini dei veicoli rappresentano la causa principale della crescita del disco. Monitora l'utilizzo dei caricamenti nel tempo e rimuovi i media obsoleti (il plugin rimuove automaticamente le immagini delle auto eliminate) oppure sposta i caricamenti su un archivio a oggetti tramite un plugin di offload dei media.
Gli host con un riciclo aggressivo dei worker PHP (ad esempio, che terminano i worker dopo 30 secondi) possono interrompere le importazioni di grandi dimensioni. Utilizza il Batch-Wizard (piccoli lotti adattivi) o la coda delle immagini (elaborazione asincrona) invece di un'unica importazione gigante.
Le CDN e i reverse proxy dovrebbero trasmettere il parametro di query del token cron inalterato e non dovrebbero memorizzare nella cache le risposte di wp-admin/, wp-login.php, wp-cron.php o /wp-json/as24ci/v1/*.
L'endpoint gestito di Gemini può presentare una latenza elevata per singola richiesta. Se abiliti la generazione AI durante le importazioni, aumenta max_execution_time di conseguenza e preferisci la coda di generazione AI asincrona.
I log del plugin crescono costantemente quando la registrazione dettagliata è attiva. Il plugin li ruota a 10 MB ed elimina i file ruotati più vecchi di 7 giorni, ma la directory dovrebbe comunque essere inclusa nel monitoraggio regolare dell'utilizzo del disco.

Risoluzione dei problemi

Importazioni lente / timeout frequenti: Aumenta la memoria PHP e il tempo di esecuzione, riduci la dimensione del lotto di veicoli per ciascun cron e assicurati che la coda delle immagini sia abilitata.
"Problema di connessione – impossibile recuperare gli annunci": Verifica la connessione HTTPS in uscita verso api.autoscout24.com, la risoluzione DNS dal server e se un proxy aziendale o un WAF sta intercettando la richiesta.
Mancato download delle immagini: Verifica lo spazio libero su disco, i permessi della cartella dei caricamenti e che gli host di immagini di AutoScout24 siano raggiungibili.
Avvisi sullo spazio su disco: Utilizza la scheda dello spazio di archiviazione in System & Help per confermare il dato sullo spazio libero, quindi ripulisci i vecchi media o estendi il volume.
Email non recapitate: Configura un plugin SMTP o un MTA di hosting; molti host condivisi bloccano la funzione diretta mail() di PHP.
I backup non acquisiscono tutti i dati del plugin: Assicurati che lo strumento di backup copra l'intero database di WordPress (comprese le tabelle personalizzate con prefisso {wp_prefix}as24_) e l'intera directory wp-content/uploads/.