Gestore Cron: configurazione e aiuto

Nel Back Office, apri Moduli > "Module Manager", scegli "Upload a module" e carica lo ZIP del modulo. Installalo, poi fai clic su "Configure". Nelle versioni precedenti di PrestaShop, usa la pagina Moduli corrispondente.

Apri Cron Manager > Impostazioni > Configurazione. Usa Cron server (consigliato) quando il tuo hosting supporta comandi PHP pianificati. Usa cron-job.org o un altro pianificatore HTTP esterno quando ti serve un trigger remoto. Fallback Front Office e Fallback Back Office richiedono visite alle pagine. Non garantiscono un orario di esecuzione fisso.

Installa i moduli MPR di cui vuoi eseguire le attività. Apri Moduli in Cron Manager e sincronizza le loro definizioni. Un trigger centrale avvia le attività registrate giunte a scadenza. Non rileva script arbitrari come attività.

In Endpoint cron, copia Comando cron server, URL cron HTTP o Token cron condiviso. Il token viene generato come 64 caratteri esadecimali. Rigenerarlo invalida i vecchi comandi e URL. Aggiorna ogni pianificatore dopo la rigenerazione.

Cron server

Il comando generato da copiare usa --token=TOKEN, accettato dall'esecutore attuale. Per una configurazione server, puoi invece mettere il token nella prima riga di un file esterno alla directory web pubblica. Concedi l'accesso in lettura solo all'utente che esegue il PHP pianificato, per esempio con la modalità file 0400. Usa percorsi assoluti adatti al tuo hosting:

* * * * * /usr/bin/php /path/to/prestashop/modules/mprcron/cron.php --token-file=/private/mprcron.token --max-tasks=20 --max-seconds=300 --context=cron

Non copiare letteralmente questi percorsi di esempio. L'eseguibile PHP CLI deve poter caricare il negozio e le sue dipendenze. Le attività di comando richiedono anche che il server consenta l'esecuzione dei processi.

Pianificatore HTTP

Copia URL cron HTTP generato dal negozio. Il formato è:

https://yourshop.com/module/mprcron/cron?token=YOUR_TOKEN
https://yourshop.com/module/mprcron/cron?token=YOUR_TOKEN&max_tasks=20&max_seconds=300

Per cron-job.org, salva la chiave e l'intervallo, poi usa il controllo di creazione/sincronizzazione del job. Usa Test richiesta pubblica per verificare la raggiungibilità. Da questa schermata puoi mettere in pausa, riprendere, eliminare o disconnettere il job esterno. Le barriere di autenticazione, le restrizioni di manutenzione e i firewall possono bloccare le richieste remote.

Limiti e contesto

Una chiamata all'esecutore prevede per impostazione predefinita 20 attività e 300 secondi. I limiti vengono vincolati a un intervallo da 1 a 100 attività e da 10 a 300 secondi. Sono parametri di invocazione, non campi del modulo di configurazione. La CLI accetta --max-tasks, --max-seconds e --context=cron|front|admin. L'endpoint del front controller del modulo esegue nel contesto cron. Non aspettarti che la sua query string cambi quel contesto.

Usa Pannello di controllo per un riepilogo. Attività mostra il modulo proprietario, la chiave dell'attività, l'etichetta, il tipo, la pianificazione, lo stato di abilitazione, il contesto, la priorità, il timeout, l'ultima esecuzione e la prossima. Usa Esegui per l'esecuzione immediata. Usa Metti in pausa o Riprendi per modificare una singola attività. Modifica una frequenza definita dal modulo e, quando necessario, ripristina il valore predefinito del modulo.

Usa Moduli per sincronizzare le definizioni, mettere in pausa o riprendere le attività di un modulo oppure rimuovere le registrazioni. La rimozione di una registrazione definita dal modulo può essere annullata sincronizzando il proprietario. Rimuovere un'attività personalizzata elimina la relativa definizione personalizzata.

Crea un'attività personalizzata

Il tuo profilo dipendente deve avere i diritti di visualizzazione, aggiunta, modifica o eliminazione delle attività corrispondenti all'azione che usi.

Apri il modulo per l'attività personalizzata in Attività.

Usa Esecuzione di test o Salva ed esegui test e controlla il risultato. Un pianificatore HTTP o una visita a una pagina di fallback non esegue le attività di comando. L'azione Esegui di Attività usa il contesto esplicito di test amministrativo.

Pianificazioni

hourly:00
daily:04:00
weekly:1:08:00
weekly:1,3:08:00
every:3600
*/15 * * * *
0 3 * * *
30 2 * * 1

Nei giorni settimanali, 0 è domenica e 1 è lunedì. every:3600 usa i secondi. Le pianificazioni di calendario usano il fuso orario dell'ambiente PHP. Confrontalo con gli orari mostrati nell'elenco delle attività.

Per un'importazione da un fornitore, inserisci Nome Nightly supplier import, Tipo URL, Metodo POST, Pianificazione daily:02:30 e l'URL del fornitore. Imposta Stato HTTP atteso su 200. Aggiungi Content-Type: application/json a Intestazioni e questo Corpo:

{"source":"prestashop","mode":"scheduled"}

Per un callable usa module_name::method. Per un comando usa un comando assoluto come php /path/to/script.php.

1. Usa Esegui su un'attività sicura. Controlla Log per stato, contesto, durata e anteprima del risultato.
2. Attendi il prossimo trigger del pianificatore. Controlla Accessi per un accesso server o esterno, poi verifica Ultima esecuzione e Prossima esecuzione dell'attività.
3. Se arrivano accessi senza esecuzioni, controlla Abilita esecuzione cron, lo stato di abilitazione dell'attività, la pianificazione e il contesto. Un'attività già acquisita da un altro esecutore viene saltata.
4. Se non arrivano accessi, controlla il percorso del pianificatore, il token e la raggiungibilità pubblica. Un'esecuzione manuale prova solo l'attività stessa; il pianificatore dell'hosting deve comunque chiamare l'URL.
5. Per risultati di errore, timeout o arresto anomalo, esamina il risultato e lo script di destinazione. Le esecuzioni non riuscite posticipano la successiva esecuzione applicando un ritardo di nuovo tentativo. Quando disponibile, viene usato l'isolamento dei sottoprocessi CLI, così un'attività bloccata non deve necessariamente fermare il lotto.

Gli URL diagnostici autenticati usano lo stesso endpoint:

?token=YOUR_TOKEN&action=status
?token=YOUR_TOKEN&action=health
?token=YOUR_TOKEN&action=tasks
?token=YOUR_TOKEN&action=tasks&module=mprcron
?token=YOUR_TOKEN&action=run&id_task=123

Accessi distingue trigger server, esterni, front office, Back Office, fallback e manuali. Log registra le esecuzioni. Usa Impostazioni > Integrità per i controlli dell'installazione. Licenza, Assistenza e Aggiorna si trovano anch'essi sotto Impostazioni.

Se gestisci un modulo MPR, usa il MyPrestaRocks\Cron\CronTrait incluso, dichiara le attività in getCronTasks() e richiama i suoi metodi di installazione e disinstallazione del cron nel ciclo di vita del modulo. Una definizione di attività può contenere:

'refresh_feed' => [
    'label' => 'Refresh product feed',
    'callable' => 'mymodule::cronRefreshFeed',
    'schedule' => 'daily:03:00',
    'context' => 'cron',
    'priority' => 50,
    'timeout' => 120,
]

Sincronizza il proprietario in Moduli dopo aver modificato le definizioni.

Disattiva Abilita esecuzione cron per un arresto temporaneo e controlla separatamente il pianificatore esterno. Rimuovi la voce cron dell'hosting o metti in pausa/elimina il job esterno quando ritiri il modulo. Disinstallalo da "Module Manager". La procedura di disinstallazione annulla la registrazione delle attività proprie di Cron Manager e rimuove il suo menu. Conserva le tabelle cron condivise perché altri moduli possono ancora usarle.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.