2 require_once 'Pman.php';
5 * notification script runner
7 * This does not actualy send stuf out, it only starts the NotifySend/{id}
8 * which does the actuall notifcations.
10 * It manages a pool of notifiers.
16 class Pman_Core_Notify extends Pman
19 static $cli_desc = "Runs the notification queue (usually from cron)
20 Normally used to sends out emails to anyone in the notification list.
22 /etc/cron.d/pman-core-notify
23 * * * * * www-data /usr/bin/php /home/gitlive/web.mtrack/admin.php Core/Notify > /dev/null
27 static $cli_opts = array(
29 'desc' => 'Turn on debugging (see DataObjects debugLevel )',
37 'desc' => 'List message to send, do not send them..',
45 'desc' => 'Show old messages.. (and new messages...)',
53 'desc' => 'Force redelivery, even if it has been sent before or not queued...',
59 /* removed - use GenerateNotifcations.php hooked classes
60 'generate' => 'Generate notifications for a table, eg. cash_invoice',
65 'desc' => 'Limit search for no. to send to ',
72 'desc' => 'Dry run - do not send.',
79 'desc' => 'Pool size',
87 * @var $nice_level Unix 'nice' level to stop it jamming server up.
89 var $nice_level = false;
91 * @var $max_pool_size maximum runners to start at once.
93 var $max_pool_size = 10;
95 * @var $max_to_domain maximum connections to make to a single domain
97 var $max_to_domain = 10;
100 * @var $maxruntime - maximum seconds a child is allowed to run - defaut 2 minutes
102 var $maxruntime = 120;
105 * @var {Boolean} log_events - default true if events should be logged.
107 var $log_events = true;
109 * @var {Number} try_again_minutes how long after failing to try again default = 30 if max runtime fails
111 var $try_again_minutes = 30;
114 * @var {String} table - the table that the class will query for notification events
116 var $table = 'core_notify';
118 * @var {String} target - the application that will run for each Row in the table (eg. Pman/Core/NotifySend)
120 var $target = 'Core/NotifySend';
124 var $evtype = ''; // any notification...
125 // this script should only handle EMAIL notifications..
134 $ff = HTML_FlexyFramework::get();
136 die("access denied");
138 HTML_FlexyFramework::ensureSingle($_SERVER["SCRIPT_NAME"] .'|'. __FILE__ .'|'. (empty($_SERVER['argv'][1]) ? '': $_SERVER['argv'][1]), $this);
144 function parseArgs(&$opts)
146 if ($opts['debug']) {
147 DB_DataObject::debugLevel($opts['debug']);
151 if (!empty($opts['poolsize'])) {
152 $this->max_pool_size = $opts['poolsize'];
155 if (empty($opts['limit'])) {
156 $opts['limit'] = '1000'; // not sure why it's not picking up the defautl..
159 if (!empty($opts['old'])) {
160 $opts['list'] = 1; // force listing..
163 $this->force = empty($opts['force']) ? 0 : 1;
165 if (!empty($opts['send-to'])) {
166 $this->send_to = $opts['send-to'];
170 var $queue = array();
171 var $domain_queue = array(); // false to use nextquee
172 var $next_queue = array();
175 function get($r,$opts=array())
177 $this->parseArgs($opts);
179 //date_default_timezone_set('UTC');
182 $this->generateNotifications();
184 $this->assignQueues();
186 //DB_DataObject::debugLevel(1);
187 $w = DB_DataObject::factory($this->table);
192 $ff = HTML_FlexyFramework::get();
193 if (!empty($ff->Core_Notify['servers']) && empty($ff->Core_Notify['servers-non-pool'][gethostname()])) {
195 if (!isset($ff->Core_Notify['servers'][gethostname()])) {
196 $this->jerr("Core_Notify['servers']['" . gethostname() ."'] is not set");
198 $w->server_id = array_search(gethostname(),array_keys($ff->Core_Notify['servers']));
200 if (!empty($this->evtype)) {
201 $w->evtype = $this->evtype;
206 if (!empty($opts['old'])) {
207 // show old and new...
209 $w->orderBy('act_when DESC'); // latest first
210 $w->limit($opts['limit']); // we can run
211 $total = min($w->count(), $opts['limit']);
215 //$w->whereAdd('act_when > sent'); // eg.. sent is not valid..
216 $w->whereAdd("sent < '1970-01-01' OR sent IS NULL"); // eg.. sent is not valid..
218 $w->whereAdd('act_start > NOW() - INTERVAL 14 DAY'); // ignore the ones stuck in the queue
220 $w->whereAdd('act_when < NOW()'); // eg.. not if future..
223 $w->orderBy('act_when ASC'); // oldest first.
224 $total = min($w->count(), $opts['limit']);
225 $this->logecho("QUEUE is {$w->count()} only running " . ((int) $opts['limit']));
227 $w->limit($opts['limit']); // we can run 1000 ...
239 $this->logecho("Nothing In Queue - DONE");
244 if (!empty($opts['list'])) {
247 while ($w->fetch()) {
251 $this->logecho("{$w->id} : {$w->person()->email} email : ".
252 $o->toEventString()." ". $w->status() );
257 //echo "BATCH SIZE: ". count($ar) . "\n";
261 // only add if we don't have any queued up..
262 if (empty($this->queue) && $w->fetch()) {
263 $this->queue[] = clone($w);
267 $this->logecho("BATCH SIZE: Queue=". count($this->queue) . " TOTAL = " . $total );
269 if (empty($this->queue)) {
270 $this->logecho("COMPLETED MAIN QUEUE - running maxed out domains");
271 if ($this->domain_queue !== false) {
272 $this->queue = $this->remainingDomainQueue();
276 break; // nothing more in queue.. and no remaining one
280 $p = array_shift($this->queue);
281 if (!$this->poolfree()) {
282 array_unshift($this->queue,$p); /// put it back on..
286 // not sure what happesn if person email and to_email is empty!!?
287 $email = empty($p->to_email) ? ($p->person() ? $p->person()->email : $p->to_email) : $p->to_email;
289 $black = $this->isBlacklisted($email);
290 if ($black !== false) {
291 $this->logecho("DOMAIN blacklisted - {$email} - moving to another pool");
292 $this->updateServer($p, $black);
297 if ($this->poolHasDomain($email) > $this->max_to_domain) {
299 // push it to a 'domain specific queue'
300 $this->logecho("REQUEING - maxed out that domain - {$email}");
301 $this->pushQueueDomain($p, $email);
309 $this->run($p->id,$email);
314 $this->logecho("REQUEUING all emails that maxed out:" . count($this->next_queue));
315 if (!empty($this->next_queue)) {
317 foreach($this->next_queue as $p) {
318 $this->updateServer($p);
323 $this->logecho("QUEUE COMPLETE - waiting for pool to end");
324 // we should have a time limit here...
325 while(count($this->pool)) {
333 $this->logecho("DONE");
338 function isBlacklisted($email)
340 // return current server id..
341 $ff = HTML_FlexyFramework::get();
342 //$this->logecho("CHECK BLACKLISTED - {$email}");
343 if (empty($ff->Core_Notify['servers'])) {
347 if (!isset($ff->Core_Notify['servers'][gethostname()]['blacklisted'])) {
352 $ea = explode('@',$email);
353 $dom = strtolower(array_pop($ea));
355 //$this->logecho("CHECK BLACKLISTED DOM - {$dom}");
356 if (!in_array($dom, $ff->Core_Notify['servers'][gethostname()]['blacklisted'] )) {
359 //$this->logecho("RETURN BLACKLISTED TRUE");
360 return array_search(gethostname(),array_keys($ff->Core_Notify['servers']));
363 // this sequentially distributes requeued emails.. - to other servers. (can exclude current one if we have that flagged.)
364 function updateServer($ww, $exclude = -1)
366 $w = DB_DataObject::factory($ww->tableName());
369 $ff = HTML_FlexyFramework::get();
371 if (empty($ff->Core_Notify['servers'])) {
374 $num = ($num+1) % count(array_keys($ff->Core_Notify['servers']));
375 if ($exclude == $num ) {
376 $num = ($num+1) % count(array_keys($ff->Core_Notify['servers']));
380 $w->server_id = $num;
382 $w->act_when = $w->sqlValue('NOW() + INTERVAL 1 MINUTE');
389 function generateNotifications()
391 // this should check each module for 'GenerateNotifications.php' class..
392 //and run it if found..
393 $ff = HTML_FlexyFramework::get();
395 $disabled = explode(',', $ff->disable);
397 $modules = array_reverse($this->modulesList());
399 // move 'project' one to the end...
401 foreach ($modules as $module){
402 if(in_array($module, $disabled)){
405 $file = $this->rootDir. "/Pman/$module/GenerateNotifications.php";
406 if(!file_exists($file)){
411 $class = "Pman_{$module}_GenerateNotifications";
413 if(!method_exists($x, 'generate')){
423 function assignQueues()
425 $ff = HTML_FlexyFramework::get();
427 if (empty($ff->Core_Notify['servers'])) {
431 if (isset($ff->Core_Notify['servers-non-pool'][gethostname()])) {
435 if (!isset($ff->Core_Notify['servers'][gethostname()])) {
437 $this->jerr("Core_Notify['servers']['" . gethostname() ."'] is not set");
439 // only run this on the main server...
440 if (array_search(gethostname(),array_keys($ff->Core_Notify['servers'])) > 0) {
444 $num_servers = count(array_keys($ff->Core_Notify['servers']));
445 $p = DB_DataObject::factory($this->table);
451 act_start < NOW() + INTERVAL 3 HOUR
456 if ($p->count() < 1) {
459 $p = DB_DataObject::factory($this->table);
460 // 6 seconds on this machne...
465 server_id = ((@row_number := CASE WHEN @row_number IS NULL THEN 0 ELSE @row_number END +1) % {$num_servers})
471 act_start < NOW() + INTERVAL 3 HOUR
483 function run($id, $email='', $cmdOpts="")
486 static $renice = false;
488 require_once 'System.php';
489 $renice = System::which('renice');
495 $tn = $this->tempName('stdout', true);
496 $descriptorspec = array(
497 0 => array("pipe", 'r'), // stdin is a pipe that the child will read from
498 1 => array("file", $tn, 'w'), // stdout is a pipe that the child will write to
499 2 => array("pipe", "w") // stderr is a file to write to
504 require_once 'System.php';
505 $php = System::which('php');
508 $sn = $_SERVER["SCRIPT_NAME"];
510 $cwd = $sn[0] == '/' ? dirname($sn) : dirname(realpath(getcwd() . '/'. $sn)); // same as run on.. (so script should end up being same relatively..)
511 $app = $cwd . '/' . basename($_SERVER["SCRIPT_NAME"]) . ' ' . $this->target . '/'. $id;
515 if (!empty($this->send_to)) {
516 $app .= ' --sent-to='.escapeshellarg($this->send_to);
518 $cmd = 'exec ' . $php . ' ' . $app . ' ' . $cmdOpts; //. ' &';
522 //$this->logecho("call proc_open $cmd");
525 if ($this->max_pool_size === 1) {
526 $this->logecho("call passthru [{$email}] $cmd");
532 if (!empty($this->opts['dryrun'])) {
533 $this->logecho("DRY RUN");
537 $p = proc_open($cmd, $descriptorspec, $pipes, $cwd );
538 $info = proc_get_status($p);
540 if ($this->nice_level !== false) {
541 $rcmd = "$renice {$this->nice_level} {$info['pid']}";
544 $this->pool[] = array(
546 'pid' => $info['pid'],
556 $this->logecho("RUN [{$email}] ({$info['pid']}) $cmd ");
564 foreach($this->pool as $p) {
566 //echo "CHECK PID: " . $p['pid'] . "\n";
567 $info = proc_get_status($p['proc']);
570 // update if necessday.
571 if ($info['pid'] && $p['pid'] != $info['pid']) {
572 $this->logecho("CHANING PID FROM " . $p['pid'] . " TO ". $info['pid']);
573 $p['pid'] = $info['pid'];
576 //echo @file_get_contents('/proc/'. $p['pid'] .'/cmdline') . "\n";
578 if ($info['running']) {
580 //if (file_exists('/proc/'.$p['pid'])) {
581 $runtime = time() - $p['started'];
582 //echo "RUNTIME ({$p['pid']}): $runtime\n";
583 if ($runtime > $this->maxruntime) {
585 proc_terminate($p['proc'], 9);
586 //fclose($p['pipes'][1]);
587 fclose($p['pipes'][0]);
588 fclose($p['pipes'][2]);
589 $this->logecho("TERMINATING: ({$p['pid']}) {$p['email']} " . $p['cmd'] . " : " . file_get_contents($p['out']));
593 $w = DB_DataObject::factory($this->table);
594 $w->get($p['notify_id']);
596 if ($this->log_events) {
597 $this->addEvent('NOTIFY', $w, 'TERMINATED - TIMEOUT');
599 $w->act_when = date('Y-m-d H:i:s', strtotime("NOW + {$this->try_again_minutes} MINUTES"));
608 fclose($p['pipes'][0]);
609 fclose($p['pipes'][2]);
610 //echo "CLOSING: ({$p['pid']}) " . $p['cmd'] . " : " . file_get_contents($p['out']) . "\n";
611 //fclose($p['pipes'][1]);
613 proc_close($p['proc']);
617 //if (file_exists('/proc/'.$p['pid'])) {
621 $this->logecho("ENDED: ({$p['pid']}) {$p['email']} " . $p['cmd'] . " : " . file_get_contents($p['out']) );
623 // at this point we could pop onto the queue the
624 $this->popQueueDomain($p['email']);
628 $this->logecho("POOL SIZE: ". count($pool) );
630 if (count($pool) < $this->max_pool_size) {
637 * see if pool is already trying to deliver to this domain.?
638 * -- if so it get's pushed to the end of the queue.
641 function poolHasDomain($email)
644 $ea = explode('@',$email);
645 $dom = strtolower(array_pop($ea));
646 foreach($this->pool as $p) {
647 $ea = explode('@',$p['email']);
648 $mdom = strtolower(array_pop($ea));
656 function popQueueDomain($email)
658 $ea = explode('@',$email);
659 $dom = strtolower(array_pop($ea));
660 if (empty($this->domain_queue[$dom])) {
663 array_unshift($this->queue, array_shift($this->domain_queue[$dom]));
667 function pushQueueDomain($e, $email)
669 if ($this->domain_queue === false) {
670 $this->next_queue[] = $e;
674 $ea = explode('@',$email);
675 $dom = strtolower(array_pop($ea));
676 if (!isset($this->domain_queue[$dom])) {
677 $this->domain_queue[$dom] = array();
679 $this->domain_queue[$dom][] = $e;
681 function remainingDomainQueue()
684 foreach($this->domain_queue as $dom => $ar) {
685 $ret = array_merge($ret, $ar);
687 $this->domain_queue = false;
695 $this->logecho("DONE");
698 function logecho($str)
700 echo date("Y-m-d H:i:s - ") . $str . "\n";