larger smaller normal text version of this page
Phplist Documentation » Message functions » Process the message queue »

Commandline Script Examples

This page provides some examples of commandline scripts applied by Phplist users. You are welcome to add your commandline script. Please include a brief description of what it does.

Commandline script that checks for running processes


#Just check if the script is running if it is about otherwise run the script
if [ `ps aux |grep phplist | grep -c -v 'grep'` -eq 0 ]
echo "" >> /var/log/list.log
echo "`date`" >> /var/log/list.log
/usr/local/bin/phplist -pprocessqueue >> /var/log/list.log
exit 0

This is a little bash script that I use to get around the problem of having the process queue already running when the cronjob calls it. I don't actually call the phplist command from the cronjob but rather call this shell script which just checks to see if phplist is running and if it is exits otherwise if it isn't it will call the phplist -processqueue command. I have noticed that phplist takes a lot out of mysql so you definitely wouldn't want to have 2 process queues running at once. I imagine you could write a batch file that does the same thing pretty easily. Source: Forum post by habbers

Commandline script that checks for user variable


# Place config data in environment
export CONFIG

# Check the USER environment variable is set
if [$USER]; then
   echo found USER variable
   export USER

# run the PHPlist index file with all parameters passed to this script
/usr/bin/php /home/website/public_html/lists/admin/index.php $*

After edited the phplist file to reflect the locations of my config.php and admin/index.php file, I inserted a check in my "phplist" commandline file which would set the USER environment variable (if it wasn't already set).
I relocated this to a location away from my public html files ( say /usr/local/cron_scripts ) and point to this in my cronjob line:

# every hour at 15 minutes past we process the queued messages
15 * * * * /usr/local/scripts/phplist -pprocessqueue

I found no need to include any login or password variables in the call to the admin/index.php file. The problem for me was that a cronjob does not have a USER environment variable set and it is from this that the admin/index.php file checks against commandline_users.
The solution was to create a pseudo (non existent) user in the commandline_users variable in the config.php file. so ...

$commandline_users = array("listprocessor","any other","users","you want","to set");

Finally I made sure the phplist file is executable (chmod 755). Source: Forum post by cafamily

Commandline script that logs the start and end of processing

Settings in config.php

define("MAILQUEUE_BATCH_PERIOD",500); // irrelevant with CLI and cron
$commandline_users = array("admin","listprocessor");

Commandline script

# identify the config file for your installation

[ -z $USER ] && USER=admin

echo "Process $PROCESS started on 'date'">>$LOGFILE

# run the PHPlist index file with all parameters passed to this script
/usr/bin/php /var/www/lists/admin/index.php $*>> $LOGFILE 2>&1
echo "Process $PROCESS ended on 'date'">>$LOGFILE

The definition of the users is important, otherwise phplist will not allow processing.

Cron job
The next step is to set up the cron job and execute the script every 10 minutes (remember to change the paths):

10 * * * * /var/www/phplist/lists/phplist -pprocessqueue -c/var/www/lists/config/config.php

Source: Die ContentSchmiede

Other Tips & Tricks from the forum

Page was generated in 0.2240 seconds