Волшебный Crontab

И так начнем.

Для выполнения программного кода в указанное время нужно добавить нашу команду в crontab. Для добавления программы в crontab используем команду crontab -e. Вы окажетесь в текстовом редакторе vi (редактор может отличатся), где сможете вводить текст сценария для cron. Краткая справка по редактору vi:

• для вставки текста нажмите i, затем вводите текст
• для удаления символов нажмите ESC, а затем наберите x
• для выхода из vi без сохранения изменений нажмите ESC, а затем наберите :q!
• для сохранения и выхода нажмите ESC, а затем наберите :wq
• для nanoCtrl + X will quit the editor and you will be asked if you want to save your changes. If you do, press Y for Yes.

  Ctrl + O should also work, since that means to save the file, but you won’t be asked «Save modifier buffer ? » because you already told nano to save.

Задания для cron пишутся по одному в строке. После каждой строки, в том числе после последней или единственной, обязательно нужно нажать enter — иначе задания работать не будут.

Задание для cron выглядит как строка, в начале находятся пять обязательных полей для указания периодичности задания, а далее следует команда, которую нужно запускать:

поле1 поле2 поле3 поле4 поле5 команда

Значения первых пяти полей:

1. минуты — число от 0 до 59
2. часы — число от 0 до 23
3. день месяца — число от 1 до 31
4. номер месяца в году — число от 1 до 12
5. день недели — число от 0 до 7 (0-Вс,1-Пн,2-Вт,3-Ср,4-Чт,5-Пт,6-Сб,7-Вс)

Для каждого конкретного параметра можно задать несколько значений через запятую. Например, если в поле «часы» написать 1,4,22, то задание будет запущено в 1 час ночи, в 4 часа утра и в 22 часа. Можно задать интервал — 4-9 будет означать, что программу нужно запускать каждый час в период с 4 до 9 часов включительно. Символ ‘*‘ означает «все возможные значения». Например, указание ‘*‘ в поле «часы» будет означать «запускать каждый час». Символ ‘/‘ служит для указания дополнительной периодичности задания. Например, ‘*/3‘ в поле «часы» означает «каждые три часа».

Примечание: если определены оба поля «день месяца» и «день недели» (т.е не равны *), то такое задание будет выполняться в каждый указанный день недели независимо от дня месяца. Например, следующая команда будет выполняться в 13 часов 13 минут каждую пятницу и каждое 10 число месяца, даже если 10 число не совпадет с пятницей.

13 13 10 * 5 /home/u12345/script.pl

Где /home/u12345/script.pl путь к исполняемому файлу (стоит отметить что на разных серверах команды могут отличатся).

Итак, как выглядит простейший сценарий cron:

0 */3 * * 2,5 /home/u12345/script.pl

Скрипт /home/u12345/script.pl будет автоматически запускаться каждые три часа во вторник и в пятницу. Введя такой сценарий в редакторе vi выйдите с сохранением результатов редактирования и, если вы не допустили ошибок, задание будет поставлено на выполнение с указанной периодичностью. Если при редактировании были допущены ошибки, cron сообщит вам о них.

Пара примеров использования:

# выполнять задание раз в час в 0 минут
0 */1 * * * /home/u12345/script.pl
# выполнять задание каждые три часа в 0 минут
0 */3 * * * /home/u12345/script.pl
# выполнять задание по понедельникам в 1 час 15 минут ночи
15 1 * * 1 /home/u12345/script.pl
# выполнять задание 5 апреля в 0 часов 1 минуту каждый год
1 0 5 4 * /home/u12345/script.pl
# выполнять задание ежемесячно 1 числа в 6 часов 10 минут
10 6 1 * * /home/u12345/script.pl


Стоит отметить что есть такая штука как wget — поскольку не все PHP-программы могут работать через CLI SAPI без предварительной модификации.

Например:

/usr/local/bin/wget -O /dev/null -q http://mysite.tld/cron.php?action=123

Если в скрипте используются функции require, include, причём в них указаны относительные пути, то в начале выполняемого скрипта используйте вызов функции chdir(), которая задаст текущую рабочую директорию.

Как получать сообщения об ошибках от программ, запускаемых cron

Если при выполнении программы, которая запускается из cron, возникли ошибки, наверняка вы захотите получать сообщения об этих ошибках, чтобы полностью контролировать работу периодически запускаемых заданий. Для этого в начале cron-сценария поместите такую строку:

MAILTO=адрес@домен.ru

Обратите внимание на то, что cron будет присылать по почте то, что выводят запускаемые скрипты. Например, если вы напишете скрипт, который будет печатать строчку «Hello, world» и поставите его на выполнение через cron, вы будете получать по почте письмо со строкой «Hello, world» каждый раз, когда cron будет запускать такой скрипт.

Чтобы избежать этого, например когда текст, выводимый скриптом, вам не нужен, надо добавить в конец строки-сценария для cron символы:

> /dev/null 2>&1

Полностью строка для cron будет выглядеть так:

0 1 * * * /usr/local/bin/php -q $HOME/script.php > /dev/null 2>&1

Напоследок:

Для того, чтобы убедиться что скрипт будет правильно работать через cron, предварительно проверьте его такой командой в unix shell:

/usr/local/bin/php -l script.php

Если ошибок в скрипте нет, вы увидите сообщение «No syntax errors detected in script.php».