Runway scheduled tasks

Tasks like running backups and deleting spam can be automatically run on a schedule. In order to do this, you need to configure your server to periodically run a script.

The script should be set to run as frequently as your most frequent task, but ideally at least once per hour. If you wanted to update from Twitter every 15 minutes, your script should run at least every 15 minutes.

Setting up a secret

To prevent the scheduled tasks being run accidentally, you need to configure a ‘secret’ in your perch/config/config.local.php file. This should be lowercase letters and numbers, and no spaces. This will have been created automatically for you as part of the setup process.

define('PERCH_SCHEDULE_SECRET', 'mysecret');

Scheduling with cron

You can set up the script to run on the command line, or via a scheduling system like cron. Many hosting control panels will give you access to set this up.

php /path/to/site/perch/core/scheduled/run.php mysecret

If you check the Scheduled Tasks page under Settings in Runway, you should see the full path you need to use.

Note that some servers may require a path to the php command (perhaps something like /usr/bin/env php rather than just php) so check with your host.

Scheduling via a URL

You can also run the scheduled script via a URL in a browser (useful for remote scripts or Windows scheduled tasks).

Task history

You can view a log of the tasks that have run from the Scheduled Tasks page under Settings in Perch. This log keeps the ten most recent runs of each individual task. Older log entries are purged automatically.