Project

General

Profile

CronJobs » History » Version 2

Simon, 07/24/2014 10:08 AM

1 1 Simon
h1. CronJobs
2
3 2 Simon
Depuis la version 1.8, Linea21 permet de planifier l’exécution de tâches de manière automatique (par exemple pour l'envoi d'emails, ou la réalisation d'une sauvegarde, ...)
4 1 Simon
5 2 Simon
h2. Configurer l’exécution de tâches automatiques
6
7
La première étape est de configurer l'appel au script fourni par Linea21. Il se situe dans le répertoire /admin/.
8
9
Vous devez pour cela créer un nouveau cronjob. Référez-vous à la "documentation":http://doc.ubuntu-fr.org/cron.
10
11
Ajoutez l'une des deux instructions suivantes :
12
<pre>
13
<code>
14
* * * * * /usr/bin/php /var/www/linea21/admin/cron.php token=votre_token_id
15
</code>
16
</pre>
17
18
ou (au cas où la première ne fonctionnerait pas) :
19
20
<pre>
21
<code>
22
* * * * * /usr/bin/curl http://www.mondomaine.tld/admin/cron.php?token=votre_token_id
23
</code>
24
</pre>
25
26
27
L'instruction @* * * * * @ indique que le script est exécuté par cron chaque minute. Vous pouvez changer cette caractéristiques en modifiant la valeur. Par exemple, @*/10 * * * * @ exécutera le script chaque 10 minutes. 
28
29
*Assurez-vous de la cohérence de la fréquence d'appel avec les différents cronjobs mise à disposition de l'application, sans quoi, ils ne seront pas exécutés.*
30
31
32
h2. Cronjobs par défaut
33
34
Par défaut, l'application exécute 2 cronjobs :
35
36
* l'envoi de la newsletter (chaque nuit, à 00h00)
37
* le traitement de la queue d'emails (chaque 10 minutes)
38
39
<pre>
40
<code>
41
@daily ../newsletter/send.php
42
*/10 * * * * ../mail/process_queue.php
43
</code>
44
</pre>
45
46
47
h2. Localisation des Cronjobs
48
49
Le script _/admin/cron.php_ exécute les cronjobs situés dans le répertoire '/config/cron/'.
50
51
Nous vous recommandons de ne pas modifier le fichier '/config/cron/1_default' qui comporte les tâches à exécuter par défaut et qui sera écrasé en cas de mise à jour de l'application.
52
53
Si vous souhaitez ajouter des cronjobs, il est recommandé de créer un nouveau fichier.
54
55
L'application s'assure qu'un cronjob n'est exécuté qu'une seule fois seulement par appel. Vous pouvez donc modifier le comportement d'un cronjob fourni par défaut par l'application en le dupliquant dans un fichier dont le nom commence par '0'.
56
57
Exemple d'un fichier nommé '/config/cron/0_user' :
58
59
<pre>
60
<code>
61
*/30 * * * * ../mail/process_queue.php
62
</code>
63
</pre>
64
65
L'application traitera la queue d'emails non plus chaque 10 minutes (comportement par défaut) mais chaque demi-heure comme défini par l'utilisateur.
66
67
68
h2. Cronjobs et override
69
70
L'exécution des tâches planifiées supporte l'override. Cela signifie que vous pouvez créer votre propre script pour modifier le comportement d'une tâche existante.
71
72
Par exemple, l'instruction @*/10 * * * * ../mail/process_queue.php@ appelera le script '_/templates/admin/montheme/override/mail/process_queue.php_' s'il est défini.
73
74 1 Simon
Pur tester le code, appeler le script depuis un terminal :
75
76
<pre>
77 2 Simon
<code>
78 1 Simon
/usr/bin/curl http://localhost/linea21/admin/cron.php?token=your_token_id
79 2 Simon
</code>
80
</pre>