xref: /dokuwiki/inc/common.php (revision 3ce054b34379d1e62c7f29167cd0f8d8620b936e) 
1<?
2/**
3 * Common DokuWiki functions
4 *
5 * @license    GPL 2 (http://www.gnu.org/licenses/gpl.html)
6 * @author     Andreas Gohr <andi@splitbrain.org>
7 */
8
9  require_once("conf/dokuwiki.php");
10  require_once("inc/io.php");
11  require_once('inc/utf8.php');
12  require_once('inc/mail.php');
13
14  //set up error reporting to sane values
15  error_reporting(E_ALL ^ E_NOTICE);
16
17  //make session rewrites XHTML compliant
18  ini_set('arg_separator.output', '&amp;');
19
20  //init session
21  session_name("DokuWiki");
22  session_start();
23
24  //kill magic quotes
25  if (get_magic_quotes_gpc()) {
26    if (!empty($_GET))    remove_magic_quotes($_GET);
27    if (!empty($_POST))   remove_magic_quotes($_POST);
28    if (!empty($_COOKIE)) remove_magic_quotes($_COOKIE);
29    if (!empty($_REQUEST)) remove_magic_quotes($_REQUEST);
30    if (!empty($_SESSION)) remove_magic_quotes($_SESSION);
31    ini_set('magic_quotes_gpc', 0);
32  }
33  set_magic_quotes_runtime(0);
34  ini_set('magic_quotes_sybase',0);
35
36  //disable gzip if not available
37  if($conf['usegzip'] && !function_exists('gzopen')){
38    $conf['usegzip'] = 0;
39  }
40
41  //remember original umask
42  $conf['oldumask'] = umask();
43
44  //make absolute mediaweb
45  if(!preg_match('#^(https?://|/)#i',$conf['mediaweb'])){
46    $conf['mediaweb'] = getBaseURL().$conf['mediaweb'];
47  }
48
49/**
50 * remove magic quotes recursivly
51 *
52 * @author Andreas Gohr <andi@splitbrain.org>
53 */
54function remove_magic_quotes(&$array) {
55  foreach (array_keys($array) as $key) {
56    if (is_array($array[$key])) {
57      remove_magic_quotes($array[$key]);
58    }else {
59      $array[$key] = stripslashes($array[$key]);
60    }
61  }
62}
63
64/**
65 * Returns the full absolute URL to the directory where
66 * DokuWiki is installed in (includes a trailing slash)
67 *
68 * @author Andreas Gohr <andi@splitbrain.org>
69 */
70function getBaseURL($abs=false){
71  global $conf;
72  //if canonical url enabled always return absolute
73  if($conf['canonical']) $abs = true;
74
75  //relative URLs are easy
76  if(!$abs){
77    $dir = dirname($_SERVER['PHP_SELF']).'/';
78    $dir = preg_replace('#//#','/',$dir);
79    $dir = preg_replace('#\\\/#','/',$dir); #bugfix for weird WIN behaviour
80    return $dir;
81  }
82
83  $port = ':'.$_SERVER['SERVER_PORT'];
84  //remove port from hostheader as sent by IE
85  $host = preg_replace('/:.*$/','',$_SERVER['HTTP_HOST']);
86
87  // see if HTTPS is enabled - apache leaves this empty when not available,
88  // IIS sets it to 'off', 'false' and 'disabled' are just guessing
89  if (preg_match('/^(|off|false|disabled)$/i',$_SERVER['HTTPS'])){
90    $proto = 'http://';
91    if ($_SERVER['SERVER_PORT'] == '80') {
92      $port='';
93    }
94  }else{
95    $proto = 'https://';
96    if ($_SERVER['SERVER_PORT'] == '443') {
97      $port='';
98    }
99  }
100  $dir = (dirname($_SERVER['PHP_SELF'])).'/';
101  $dir = preg_replace('#//#','/',$dir);
102  $dir = preg_replace('#\/$#','/',$dir); #bugfix for weird WIN behaviour
103
104  return $proto.$host.$port.$dir;
105}
106
107/**
108 * Return info about the current document as associative
109 * array.
110 *
111 * @author Andreas Gohr <andi@splitbrain.org>
112 */
113function pageinfo(){
114  global $ID;
115  global $REV;
116  global $USERINFO;
117  global $conf;
118
119  if($_SERVER['REMOTE_USER']){
120    $info['user']     = $_SERVER['REMOTE_USER'];
121    $info['userinfo'] = $USERINFO;
122    $info['perm']     = auth_quickaclcheck($ID);
123  }else{
124    $info['user']     = '';
125    $info['perm']     = auth_aclcheck($ID,'',null);
126  }
127
128  $info['namespace'] = getNS($ID);
129  $info['locked']    = checklock($ID);
130  $info['filepath']  = realpath(wikiFN($ID,$REV));
131  $info['exists']    = @file_exists($info['filepath']);
132  if($REV && !$info['exists']){
133    //check if current revision was meant
134    $cur = wikiFN($ID);
135    if(@file_exists($cur) && (@filemtime($cur) == $REV)){
136      $info['filepath'] = realpath($cur);
137      $info['exists']   = true;
138      $REV = '';
139    }
140  }
141  if($info['exists']){
142    $info['writable'] = (is_writable($info['filepath']) &&
143                         ($info['perm'] >= AUTH_EDIT));
144  }else{
145    $info['writable'] = ($info['perm'] >= AUTH_CREATE);
146  }
147  $info['editable']  = ($info['writable'] && empty($info['lock']));
148  $info['lastmod']   = @filemtime($info['filepath']);
149
150  //who's the editor
151  if($REV){
152    $revinfo = getRevisionInfo($ID,$REV);
153  }else{
154    $revinfo = getRevisionInfo($ID,$info['lastmod']);
155  }
156  $info['ip']     = $revinfo['ip'];
157  $info['user']   = $revinfo['user'];
158  $info['sum']    = $revinfo['sum'];
159  $info['editor'] = $revinfo['ip'];
160  if($revinfo['user']) $info['editor'].= ' ('.$revinfo['user'].')';
161
162  return $info;
163}
164
165/**
166 * print a message
167 *
168 * If HTTP headers were not sent yet the message is added
169 * to the global message array else it's printed directly
170 * using html_msgarea()
171 *
172 *
173 * Levels can be:
174 *
175 * -1 error
176 *  0 info
177 *  1 success
178 *
179 * @author Andreas Gohr <andi@splitbrain.org>
180 * @see    html_msgarea
181 */
182function msg($message,$lvl=0){
183  global $MSG;
184  $errors[-1] = 'error';
185  $errors[0]  = 'info';
186  $errors[1]  = 'success';
187
188  if(!headers_sent){
189    if(!isset($MSG)) $MSG = array();
190    $MSG[]=array('lvl' => $errors[$lvl], 'msg' => $message);
191  }else{
192    $MSG = array();
193    $MSG[]=array('lvl' => $errors[$lvl], 'msg' => $message);
194    html_msgarea();
195  }
196}
197
198/**
199 * This builds the breadcrumb trail and returns it as array
200 *
201 * @author Andreas Gohr <andi@splitbrain.org>
202 */
203function breadcrumbs(){
204  global $ID;
205  global $ACT;
206  global $conf;
207  $crumbs = $_SESSION[$conf['title']]['bc'];
208
209  //first visit?
210  if (!is_array($crumbs)){
211    $crumbs = array();
212  }
213  //we only save on show and existing wiki documents
214  if($ACT != 'show' || !@file_exists(wikiFN($ID))){
215    $_SESSION[$conf['title']]['bc'] = $crumbs;
216    return $crumbs;
217  }
218  //remove ID from array
219  $pos = array_search($ID,$crumbs);
220  if($pos !== false && $pos !== null){
221    array_splice($crumbs,$pos,1);
222  }
223
224  //add to array
225  $crumbs[] =$ID;
226  //reduce size
227  while(count($crumbs) > $conf['breadcrumbs']){
228    array_shift($crumbs);
229  }
230  //save to session
231  $_SESSION[$conf['title']]['bc'] = $crumbs;
232  return $crumbs;
233}
234
235/**
236 * Filter for page IDs
237 *
238 * This is run on a ID before it is outputted somewhere
239 * currently used to replace the colon with something else
240 * on Windows systems and to have proper URL encoding
241 *
242 * Urlencoding is ommitted when the second parameter is false
243 *
244 * @author Andreas Gohr <andi@splitbrain.org>
245 */
246function idfilter($id,$ue=true){
247  global $conf;
248  if ($conf['useslash'] && $conf['userewrite']){
249    $id = strtr($id,':','/');
250  }elseif (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN' &&
251      $conf['userewrite']) {
252    $id = strtr($id,':',';');
253  }
254  if($ue){
255    $id = urlencode($id);
256    $id = str_replace('%3A',':',$id); //keep as colon
257    $id = str_replace('%2F','/',$id); //keep as slash
258  }
259  return $id;
260}
261
262/**
263 * This builds a link to a wikipage (using getBaseURL)
264 *
265 * @author Andreas Gohr <andi@splitbrain.org>
266 */
267function wl($id='',$more='',$script='doku.php',$canonical=false){
268  global $conf;
269  $more = str_replace(',','&amp;',$more);
270
271  $id    = idfilter($id);
272  $xlink = getBaseURL($canonical);
273
274  if(!$conf['userewrite']){
275    $xlink .= $script;
276    $xlink .= '?id='.$id;
277    if($more) $xlink .= '&amp;'.$more;
278  }else{
279    $xlink .= $id;
280    if($more) $xlink .= '?'.$more;
281  }
282
283  return $xlink;
284}
285
286/**
287 * Just builds a link to a script
288 *
289 * @author Andreas Gohr <andi@splitbrain.org>
290 */
291function script($script='doku.php'){
292  $link = getBaseURL();
293  $link .= $script;
294  return $link;
295}
296
297/**
298 * Return namespacepart of a wiki ID
299 *
300 * @author Andreas Gohr <andi@splitbrain.org>
301 */
302function getNS($id){
303 if(strpos($id,':')!==false){
304   return substr($id,0,strrpos($id,':'));
305 }
306 return false;
307}
308
309/**
310 * Returns the ID without the namespace
311 *
312 * @author Andreas Gohr <andi@splitbrain.org>
313 */
314function noNS($id){
315  return preg_replace('/.*:/','',$id);
316}
317
318/**
319 * Spamcheck against wordlist
320 *
321 * Checks the wikitext against a list of blocked expressions
322 * returns true if the text contains any bad words
323 *
324 * @author Andreas Gohr <andi@splitbrain.org>
325 */
326function checkwordblock(){
327  global $TEXT;
328  global $conf;
329
330  if(!$conf['usewordblock']) return false;
331
332  $blockfile = file('conf/wordblock.conf');
333  //how many lines to read at once (to work around some PCRE limits)
334  if(version_compare(phpversion(),'4.3.0','<')){
335    //old versions of PCRE define a maximum of parenthesises even if no
336    //backreferences are used - the maximum is 99
337    //this is very bad performancewise and may even be too high still
338    $chunksize = 40;
339  }else{
340    //read file in chunks of 600 - this should work around the
341    //MAX_PATTERN_SIZE in modern PCRE
342    $chunksize = 600;
343  }
344  while($blocks = array_splice($blockfile,0,$chunksize)){
345    $re = array();
346    #build regexp from blocks
347    foreach($blocks as $block){
348      $block = preg_replace('/#.*$/','',$block);
349      $block = trim($block);
350      if(empty($block)) continue;
351      $re[]  = $block;
352    }
353    if(preg_match('#('.join('|',$re).')#si',$TEXT)) return true;
354  }
355  return false;
356}
357
358/**
359 * Return the IP of the client
360 *
361 * Honours X-Forwarded-For Proxy Headers
362 *
363 * @author Andreas Gohr <andi@splitbrain.org>
364 */
365function clientIP(){
366  $my = $_SERVER['REMOTE_ADDR'];
367  if($_SERVER['HTTP_X_FORWARDED_FOR']){
368    $my .= ' ('.$_SERVER['HTTP_X_FORWARDED_FOR'].')';
369  }
370  return $my;
371}
372
373/**
374 * Checks if a given page is currently locked.
375 *
376 * removes stale lockfiles
377 *
378 * @author Andreas Gohr <andi@splitbrain.org>
379 */
380function checklock($id){
381  global $conf;
382  $lock = wikiFN($id).'.lock';
383
384  //no lockfile
385  if(!@file_exists($lock)) return false;
386
387  //lockfile expired
388  if((time() - filemtime($lock)) > $conf['locktime']){
389    unlink($lock);
390    return false;
391  }
392
393  //my own lock
394  $ip = io_readFile($lock);
395  if( ($ip == clientIP()) || ($ip == $_SERVER['REMOTE_USER']) ){
396    return false;
397  }
398
399  return $ip;
400}
401
402/**
403 * Lock a page for editing
404 *
405 * @author Andreas Gohr <andi@splitbrain.org>
406 */
407function lock($id){
408  $lock = wikiFN($id).'.lock';
409  if($_SERVER['REMOTE_USER']){
410    io_saveFile($lock,$_SERVER['REMOTE_USER']);
411  }else{
412    io_saveFile($lock,clientIP());
413  }
414}
415
416/**
417 * Unlock a page if it was locked by the user
418 *
419 * @author Andreas Gohr <andi@splitbrain.org>
420 * @return bool true if a lock was removed
421 */
422function unlock($id){
423  $lock = wikiFN($id).'.lock';
424  if(@file_exists($lock)){
425    $ip = io_readFile($lock);
426    if( ($ip == clientIP()) || ($ip == $_SERVER['REMOTE_USER']) ){
427      @unlink($lock);
428      return true;
429    }
430  }
431  return false;
432}
433
434/**
435 * Remove unwanted chars from ID
436 *
437 * Cleans a given ID to only use allowed characters. Accented characters are
438 * converted to unaccented ones
439 *
440 * @author Andreas Gohr <andi@splitbrain.org>
441 */
442function cleanID($id){
443  global $conf;
444  global $lang;
445  $id = trim($id);
446  $id = utf8_strtolower($id);
447
448  //alternative namespace seperator
449  $id = strtr($id,';',':');
450  if($conf['useslash']) $id = strtr($id,'/',':');
451
452  if($conf['deaccent']) $id = utf8_deaccent($id,-1);
453
454  //remove specials (only ascii specials are removed)
455  $id = preg_replace('#[\x00-\x20 !"§$%&()\[\]{}\\?`\'\#~*+=,<>\|^°@µ¹²³¼½¬]#u','_',$id);
456
457  //clean up
458  $id = preg_replace('#__#','_',$id);
459  $id = preg_replace('#:+#',':',$id);
460  $id = trim($id,':._-');
461  $id = preg_replace('#:[:\._\-]+#',':',$id);
462
463  return($id);
464}
465
466/**
467 * returns the full path to the datafile specified by ID and
468 * optional revision
469 *
470 * The filename is URL encoded to protect Unicode chars
471 *
472 * @author Andreas Gohr <andi@splitbrain.org>
473 */
474function wikiFN($id,$rev=''){
475  global $conf;
476  $id = cleanID($id);
477  $id = str_replace(':','/',$id);
478  if(empty($rev)){
479    $fn = $conf['datadir'].'/'.$id.'.txt';
480  }else{
481    $fn = $conf['olddir'].'/'.$id.'.'.$rev.'.txt';
482    if($conf['usegzip'] && !@file_exists($fn)){
483      //return gzip if enabled and plaintext doesn't exist
484      $fn .= '.gz';
485    }
486  }
487  $fn = utf8_encodeFN($fn);
488  return $fn;
489}
490
491/**
492 * Returns the full filepath to a localized textfile if local
493 * version isn't found the english one is returned
494 *
495 * @author Andreas Gohr <andi@splitbrain.org>
496 */
497function localeFN($id){
498  global $conf;
499  $file = './lang/'.$conf['lang'].'/'.$id.'.txt';
500  if(!@file_exists($file)){
501    //fall back to english
502    $file = './lang/en/'.$id.'.txt';
503  }
504  return cleanText($file);
505}
506
507/**
508 * convert line ending to unix format
509 *
510 * @see    formText() for 2crlf conversion
511 * @author Andreas Gohr <andi@splitbrain.org>
512 */
513function cleanText($text){
514  $text = preg_replace("/(\015\012)|(\015)/","\012",$text);
515  return $text;
516}
517
518/**
519 * Prepares text for print in Webforms by encoding special chars.
520 * It also converts line endings to Windows format which is
521 * pseudo standard for webforms.
522 *
523 * @see    cleanText() for 2unix conversion
524 * @author Andreas Gohr <andi@splitbrain.org>
525 */
526function formText($text){
527  $text = preg_replace("/\012/","\015\012",$text);
528  return htmlspecialchars($text);
529}
530
531/**
532 * Returns the specified local text in parsed format
533 *
534 * @author Andreas Gohr <andi@splitbrain.org>
535 */
536function parsedLocale($id){
537  //disable section editing
538  global $parser;
539  $se = $parser['secedit'];
540  $parser['secedit'] = false;
541  //fetch parsed locale
542  $html = io_cacheParse(localeFN($id));
543  //reset section editing
544  $parser['secedit'] = $se;
545  return $html;
546}
547
548/**
549 * Returns the specified local text in raw format
550 *
551 * @author Andreas Gohr <andi@splitbrain.org>
552 */
553function rawLocale($id){
554  return io_readFile(localeFN($id));
555}
556
557
558/**
559 * Returns the parsed Wikitext for the given id and revision.
560 *
561 * If $excuse is true an explanation is returned if the file
562 * wasn't found
563 *
564 * @author Andreas Gohr <andi@splitbrain.org>
565 */
566function parsedWiki($id,$rev='',$excuse=true){
567  $file = wikiFN($id,$rev);
568  $ret  = '';
569
570  //ensure $id is in global $ID (needed for parsing)
571  global $ID;
572  $ID = $id;
573
574  if($rev){
575    if(@file_exists($file)){
576      $ret = parse(io_readFile($file));
577    }elseif($excuse){
578      $ret = parsedLocale('norev');
579    }
580  }else{
581    if(@file_exists($file)){
582      $ret = io_cacheParse($file);
583    }elseif($excuse){
584      $ret = parsedLocale('newpage');
585    }
586  }
587  return $ret;
588}
589
590/**
591 * Returns the raw WikiText
592 *
593 * @author Andreas Gohr <andi@splitbrain.org>
594 */
595function rawWiki($id,$rev=''){
596  return io_readFile(wikiFN($id,$rev));
597}
598
599/**
600 * Returns the raw Wiki Text in three slices.
601 *
602 * The range parameter needs to have the form "from-to"
603 * and gives the range of the section.
604 * The returned order is prefix, section and suffix.
605 *
606 * @author Andreas Gohr <andi@splitbrain.org>
607 */
608function rawWikiSlices($range,$id,$rev=''){
609  list($from,$to) = split('-',$range,2);
610  $text = io_readFile(wikiFN($id,$rev));
611  $text = split("\n",$text);
612  if(!$from) $from = 0;
613  if(!$to)   $to   = count($text);
614
615  $slices[0] = join("\n",array_slice($text,0,$from));
616  $slices[1] = join("\n",array_slice($text,$from,$to + 1  - $from));
617  $slices[2] = join("\n",array_slice($text,$to+1));
618
619  return $slices;
620}
621
622/**
623 * Joins wiki text slices
624 *
625 * function to join the text slices with correct lineendings again.
626 * When the pretty parameter is set to true it adds additional empty
627 * lines between sections if needed (used on saving).
628 *
629 * @author Andreas Gohr <andi@splitbrain.org>
630 */
631function con($pre,$text,$suf,$pretty=false){
632
633  if($pretty){
634    if($pre && substr($pre,-1) != "\n") $pre .= "\n";
635    if($suf && substr($text,-1) != "\n") $text .= "\n";
636  }
637
638  if($pre) $pre .= "\n";
639  if($suf) $text .= "\n";
640  return $pre.$text.$suf;
641}
642
643/**
644 * print debug messages
645 *
646 * little function to print the content of a var
647 *
648 * @author Andreas Gohr <andi@splitbrain.org>
649 */
650function dbg($msg,$hidden=false){
651  (!$hidden) ? print '<pre class="dbg">' : print "<!--\n";
652  print_r($msg);
653  (!$hidden) ? print '</pre>' : print "\n-->";
654}
655
656/**
657 * Add's an entry to the changelog
658 *
659 * @author Andreas Gohr <andi@splitbrain.org>
660 */
661function addLogEntry($date,$id,$summary=""){
662  global $conf;
663  $id     = cleanID($id);
664  if(!$date) $date = time(); //use current time if none supplied
665  $remote = $_SERVER['REMOTE_ADDR'];
666  $user   = $_SERVER['REMOTE_USER'];
667
668  $logline = join("\t",array($date,$remote,$id,$user,$summary))."\n";
669
670  $fh = fopen($conf['changelog'],'a');
671  if($fh){
672    fwrite($fh,$logline);
673    fclose($fh);
674  }
675}
676
677/**
678 * returns an array of recently changed files using the
679 * changelog
680 *
681 * @author Andreas Gohr <andi@splitbrain.org>
682 */
683function getRecents($num=0,$incdel=false){
684  global $conf;
685  $recent = array();
686  if(!$num) $num = $conf['recent'];
687
688  $loglines = file($conf['changelog']);
689  rsort($loglines); //reverse sort on timestamp
690
691  foreach ($loglines as $line){
692    $line = rtrim($line);        //remove newline
693    if(empty($line)) continue;   //skip empty lines
694    $info = split("\t",$line);   //split into parts
695    //add id if not in yet and file still exists and is allowed to read
696    if(!$recent[$info[2]] &&
697       (@file_exists(wikiFN($info[2])) || $incdel) &&
698       (auth_quickaclcheck($info[2]) >= AUTH_READ)
699      ){
700      $recent[$info[2]]['date'] = $info[0];
701      $recent[$info[2]]['ip']   = $info[1];
702      $recent[$info[2]]['user'] = $info[3];
703      $recent[$info[2]]['sum']  = $info[4];
704      $recent[$info[2]]['del']  = !@file_exists(wikiFN($info[2]));
705    }
706    if(count($recent) >= $num){
707      break; //finish if enough items found
708    }
709  }
710  return $recent;
711}
712
713/**
714 * gets additonal informations for a certain pagerevison
715 * from the changelog
716 *
717 * @author Andreas Gohr <andi@splitbrain.org>
718 */
719function getRevisionInfo($id,$rev){
720  global $conf;
721  $loglines = file($conf['changelog']);
722  $loglines = preg_grep("/$rev\t\d+\.\d+\.\d+\.\d+\t$id\t/",$loglines);
723  rsort($loglines); //reverse sort on timestamp (shouldn't be needed)
724  $line = split("\t",$loglines[0]);
725  $info['date'] = $line[0];
726  $info['ip']   = $line[1];
727  $info['user'] = $line[3];
728  $info['sum']   = $line[4];
729  return $info;
730}
731
732/**
733 * Saves a wikitext by calling io_saveFile
734 *
735 * @author Andreas Gohr <andi@splitbrain.org>
736 */
737function saveWikiText($id,$text,$summary){
738  global $conf;
739  global $lang;
740  umask($conf['umask']);
741  // ignore if no changes were made
742  if($text == rawWiki($id,'')){
743    return;
744  }
745
746  $file = wikiFN($id);
747  $old  = saveOldRevision($id);
748
749  if (empty($text)){
750    // remove empty files
751    @unlink($file);
752    $del = true;
753    //autoset summary on deletion
754    if(empty($summary)) $summary = $lang['deleted'];
755  }else{
756    // save file (datadir is created in io_saveFile)
757    io_saveFile($file,$text);
758    $del = false;
759  }
760
761  addLogEntry(@filemtime($file),$id,$summary);
762  notify($id,$old,$summary);
763
764  //purge cache on add by updating the purgefile
765  if($conf['purgeonadd'] && (!$old || $del)){
766    io_saveFile($conf['datadir'].'/.cache/purgefile',time());
767  }
768}
769
770/**
771 * moves the current version to the attic and returns its
772 * revision date
773 *
774 * @author Andreas Gohr <andi@splitbrain.org>
775 */
776function saveOldRevision($id){
777	global $conf;
778  umask($conf['umask']);
779  $oldf = wikiFN($id);
780  if(!@file_exists($oldf)) return '';
781  $date = filemtime($oldf);
782  $newf = wikiFN($id,$date);
783  if(substr($newf,-3)=='.gz'){
784    io_saveFile($newf,rawWiki($id));
785  }else{
786    io_makeFileDir($newf);
787    copy($oldf, $newf);
788  }
789  return $date;
790}
791
792/**
793 * Sends a notify mail to the wikiadmin when a page was
794 * changed
795 *
796 * @author Andreas Gohr <andi@splitbrain.org>
797 */
798function notify($id,$rev="",$summary=""){
799  global $lang;
800  global $conf;
801  $hdrs ='';
802  if(empty($conf['notify'])) return; //notify enabled?
803
804  $text = rawLocale('mailtext');
805  $text = str_replace('@DATE@',date($conf['dformat']),$text);
806  $text = str_replace('@BROWSER@',$_SERVER['HTTP_USER_AGENT'],$text);
807  $text = str_replace('@IPADDRESS@',$_SERVER['REMOTE_ADDR'],$text);
808  $text = str_replace('@HOSTNAME@',gethostbyaddr($_SERVER['REMOTE_ADDR']),$text);
809  $text = str_replace('@NEWPAGE@',wl($id,'','doku.php',true),$text);
810  $text = str_replace('@DOKUWIKIURL@',getBaseURL(true),$text);
811  $text = str_replace('@SUMMARY@',$summary,$text);
812  $text = str_replace('@USER@',$_SERVER['REMOTE_USER'],$text);
813
814  if($rev){
815    $subject = $lang['mail_changed'].' '.$id;
816    $text = str_replace('@OLDPAGE@',wl($id,"rev=$rev",'doku.php',true),$text);
817    require_once("inc/DifferenceEngine.php");
818    $df  = new Diff(split("\n",rawWiki($id,$rev)),
819                    split("\n",rawWiki($id)));
820    $dformat = new UnifiedDiffFormatter();
821    $diff    = $dformat->format($df);
822  }else{
823    $subject=$lang['mail_newpage'].' '.$id;
824    $text = str_replace('@OLDPAGE@','none',$text);
825    $diff = rawWiki($id);
826  }
827  $text = str_replace('@DIFF@',$diff,$text);
828
829  mail_send($conf['notify'],$subject,$text,$conf['mailfrom']);
830}
831
832/**
833 * Return a list of available page revisons
834 *
835 * @author Andreas Gohr <andi@splitbrain.org>
836 */
837function getRevisions($id){
838  $revd = dirname(wikiFN($id,'foo'));
839  $revs = array();
840  $clid = cleanID($id);
841  if(strrpos($clid,':')) $clid = substr($clid,strrpos($clid,':')+1); //remove path
842
843  if (is_dir($revd) && $dh = opendir($revd)) {
844    while (($file = readdir($dh)) !== false) {
845      if (is_dir($revd.'/'.$file)) continue;
846      if (preg_match('/^'.$clid.'\.(\d+)\.txt(\.gz)?$/',$file,$match)){
847        $revs[]=$match[1];
848      }
849    }
850    closedir($dh);
851  }
852  rsort($revs);
853  return $revs;
854}
855
856/**
857 * downloads a file from the net and saves it to the given location
858 *
859 * @author Andreas Gohr <andi@splitbrain.org>
860 */
861function download($url,$file){
862  $fp = @fopen($url,"rb");
863  if(!$fp) return false;
864
865  while(!feof($fp)){
866    $cont.= fread($fp,1024);
867  }
868  fclose($fp);
869
870  $fp2 = @fopen($file,"w");
871  if(!$fp2) return false;
872  fwrite($fp2,$cont);
873  fclose($fp2);
874  return true;
875}
876
877/**
878 * extracts the query from a google referer
879 *
880 * @author Andreas Gohr <andi@splitbrain.org>
881 */
882function getGoogleQuery(){
883  $url = parse_url($_SERVER['HTTP_REFERER']);
884
885  if(!preg_match("#google\.#i",$url['host'])) return '';
886  $query = array();
887  parse_str($url['query'],$query);
888
889  return $query['q'];
890}
891
892/**
893 * Try to set correct locale
894 *
895 * @deprecated No longer used
896 * @author     Andreas Gohr <andi@splitbrain.org>
897 */
898function setCorrectLocale(){
899  global $conf;
900  global $lang;
901
902  $enc = strtoupper($lang['encoding']);
903  foreach ($lang['locales'] as $loc){
904    //try locale
905    if(@setlocale(LC_ALL,$loc)) return;
906    //try loceale with encoding
907    if(@setlocale(LC_ALL,"$loc.$enc")) return;
908  }
909  //still here? try to set from environment
910  @setlocale(LC_ALL,"");
911}
912
913/**
914 * Return the human readable size of a file
915 *
916 * @param       int    $size   A file size
917 * @param       int    $dec    A number of decimal places
918 * @author      Martin Benjamin <b.martin@cybernet.ch>
919 * @author      Aidan Lister <aidan@php.net>
920 * @version     1.0.0
921 */
922function filesize_h($size, $dec = 1){
923  $sizes = array('B', 'KB', 'MB', 'GB');
924  $count = count($sizes);
925  $i = 0;
926
927  while ($size >= 1024 && ($i < $count - 1)) {
928    $size /= 1024;
929    $i++;
930  }
931
932  return round($size, $dec) . ' ' . $sizes[$i];
933}
934
935/**
936 * Run a few sanity checks
937 *
938 * @author Andreas Gohr <andi@splitbrain.org>
939 */
940function getVersion(){
941  //import version string
942  if(@file_exists('VERSION')){
943    //official release
944    return 'Release '.io_readfile('VERSION');
945  }elseif(is_dir('_darcs')){
946    //darcs checkout
947    $inv = file('_darcs/inventory');
948    $inv = preg_grep('#andi@splitbrain\.org\*\*\d{14}#',$inv);
949    $cur = array_pop($inv);
950    preg_match('#\*\*(\d{4})(\d{2})(\d{2})#',$cur,$matches);
951    return 'Darcs '.$matches[1].'-'.$matches[2].'-'.$matches[3];
952  }else{
953    return 'snapshot?';
954  }
955}
956
957/**
958 * Run a few sanity checks
959 *
960 * @author Andreas Gohr <andi@splitbrain.org>
961 */
962function check(){
963  global $conf;
964  global $INFO;
965
966  msg('DokuWiki version: '.getVersion(),1);
967
968  if(version_compare(phpversion(),'4.3.0','<')){
969    msg('Your PHP version is too old ('.phpversion().' vs. 4.3.+ recommended)',-1);
970  }elseif(version_compare(phpversion(),'4.3.10','<')){
971    msg('Consider upgrading PHP to 4.3.10 or higher for security reasons (your version: '.phpversion().')',0);
972  }else{
973    msg('PHP version '.phpversion(),1);
974  }
975
976  if(is_writable($conf['changelog'])){
977    msg('Changelog is writable',1);
978  }else{
979    msg('Changelog is not writable',-1);
980  }
981
982  if(is_writable($conf['datadir'])){
983    msg('Datadir is writable',1);
984  }else{
985    msg('Datadir is not writable',-1);
986  }
987
988  if(is_writable($conf['olddir'])){
989    msg('Attic is writable',1);
990  }else{
991    msg('Attic is not writable',-1);
992  }
993
994  if(is_writable($conf['mediadir'])){
995    msg('Mediadir is writable',1);
996  }else{
997    msg('Mediadir is not writable',-1);
998  }
999
1000  if(is_writable('conf/users.auth')){
1001    msg('conf/users.auth is writable',1);
1002  }else{
1003    msg('conf/users.auth is not writable',0);
1004  }
1005
1006  if(function_exists('mb_strpos')){
1007    if(defined('UTF8_NOMBSTRING')){
1008      msg('mb_string extension is available but will not be used',0);
1009    }else{
1010      msg('mb_string extension is available and will be used',1);
1011    }
1012  }else{
1013    msg('mb_string extension not available - PHP only replacements will be used',0);
1014  }
1015
1016  msg('Your current permission for this page is '.$INFO['perm'],0);
1017
1018  if(is_writable($INFO['filepath'])){
1019    msg('The current page is writable by the webserver',0);
1020  }else{
1021    msg('The current page is not writable by the webserver',0);
1022  }
1023
1024  if($INFO['writable']){
1025    msg('The current page is writable by you',0);
1026  }else{
1027    msg('The current page is not writable you',0);
1028  }
1029}
1030?>
1031