2 // PukiWiki - Yet another WikiWikiWeb clone.
5 // 2002-2016 PukiWiki Development Team
6 // 2001-2002 Originally written by yu-ji
7 // License: GPL v2 or (at your option) any later version
9 // File related functions
12 define('PKWK_MAXSHOW_ALLOWANCE', 10);
13 define('PKWK_MAXSHOW_CACHE', 'recent.dat');
16 define('PKWK_AUTOLINK_REGEX_CACHE', 'autolink.dat');
18 // Get source(wiki text) data of the page
19 // Returns FALSE if error occurerd
20 function get_source($page = NULL, $lock = TRUE, $join = FALSE)
22 //$result = NULL; // File is not found
23 $result = $join ? '' : array();
24 // Compat for "implode('', get_source($file))",
25 // -- this is slower than "get_source($file, TRUE, TRUE)"
26 // Compat for foreach(get_source($file) as $line) {} not to warns
28 $path = get_filename($page);
29 if (file_exists($path)) {
32 $fp = @fopen($path, 'r');
33 if ($fp === FALSE) return FALSE;
39 $size = filesize($path);
40 if ($size === FALSE) {
42 } else if ($size == 0) {
45 $result = fread($fp, $size);
46 if ($result !== FALSE) {
47 // Removing Carriage-Return
48 $result = str_replace("\r", '', $result);
53 $result = file($path);
54 if ($result !== FALSE) {
55 // Removing Carriage-Return
56 $result = str_replace("\r", '', $result);
69 // Get last-modified filetime of the page
70 function get_filetime($page)
72 return is_page($page) ? filemtime(get_filename($page)) - LOCALZONE : 0;
75 // Get physical file name of the page
76 function get_filename($page)
78 return DATA_DIR . encode($page) . '.txt';
81 // Put a data(wiki text) into a physical file(diff, backup, text)
82 function page_write($page, $postdata, $notimestamp = FALSE)
84 if (PKWK_READONLY) return; // Do nothing
86 $postdata = make_str_rules($postdata);
87 $timestamp_to_keep = null;
89 $timestamp_to_keep = get_filetime($page);
91 $text_without_author = remove_author_info($postdata);
92 $postdata = add_author_info($text_without_author, $timestamp_to_keep);
93 $is_delete = empty($text_without_author);
95 // Do nothing when it has no changes
96 $oldpostdata = is_page($page) ? join('', get_source($page)) : '';
97 $oldtext_without_author = remove_author_info($oldpostdata);
98 if ($text_without_author === $oldtext_without_author) {
99 // Do nothing on updating with unchanged content
102 // Create and write diff
103 $diffdata = do_diff($oldpostdata, $postdata);
104 file_write(DIFF_DIR, $page, $diffdata);
107 make_backup($page, $is_delete, $postdata); // Is $postdata null?
110 file_write(DATA_DIR, $page, $postdata, $notimestamp, $is_delete);
115 // Modify original text with user-defined / system-defined rules
116 function make_str_rules($source)
118 global $str_rules, $fixed_heading_anchor;
120 $lines = explode("\n", $source);
121 $count = count($lines);
126 for ($i = 0; $i < $count; $i++) {
127 $line = & $lines[$i]; // Modify directly
129 // Ignore null string and preformatted texts
130 if ($line == '' || $line{0} == ' ' || $line{0} == "\t") continue;
134 if (! PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK &&
136 preg_match('/#[^{]*(\{\{+)\s*$/', $line, $matches)) {
137 // Multiline convert plugin start
139 $multiline = strlen($matches[1]); // Set specific number
142 if (! PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK &&
144 preg_match('/^\}{' . $multiline . '}\s*$/', $line)) {
145 // Multiline convert plugin end
150 if ($modify === FALSE) continue;
152 // Replace with $str_rules
153 foreach ($str_rules as $pattern => $replacement)
154 $line = preg_replace('/' . $pattern . '/', $replacement, $line);
156 // Adding fixed anchor into headings
157 if ($fixed_heading_anchor &&
158 preg_match('/^(\*{1,3}.*?)(?:\[#([A-Za-z][\w-]*)\]\s*)?$/', $line, $matches) &&
159 (! isset($matches[2]) || $matches[2] == '')) {
160 // Generate unique id
161 $anchor = generate_fixed_heading_anchor_id($matches[1]);
162 $line = rtrim($matches[1]) . ' [#' . $anchor . ']';
166 // Multiline part has no stopper
167 if (! PKWKEXP_DISABLE_MULTILINE_PLUGIN_HACK &&
168 $modify === FALSE && $multiline != 0)
169 $lines[] = str_repeat('}', $multiline);
171 return implode("\n", $lines);
175 * Add author plugin text for wiki text body
177 * @param string $wikitext
178 * @param integer $timestamp_to_keep Set null when not to keep timestamp
180 function add_author_info($wikitext, $timestamp_to_keep)
182 global $auth_user, $auth_user_fullname;
183 $author = preg_replace('/"/', '', $auth_user);
184 $fullname = $auth_user_fullname;
185 if (!$fullname && $author) {
186 // Fullname is empty, use $author as its fullname
187 $fullname = preg_replace('/^[^:]*:/', '', $author);
189 $datetime_to_keep = '';
190 if (!is_null($timestamp_to_keep)) {
191 $datetime_to_keep .= ';' . get_date_atom($timestamp_to_keep + LOCALZONE);
193 $displayname = preg_replace('/"/', '', $fullname);
194 $user_prefix = get_auth_user_prefix();
195 $author_text = sprintf('#author("%s","%s","%s")',
196 get_date_atom(UTIME + LOCALZONE) . $datetime_to_keep,
197 ($author ? $user_prefix . $author : ''),
198 $displayname) . "\n";
199 return $author_text . $wikitext;
202 function remove_author_info($wikitext)
204 return preg_replace('/^\s*#author\([^\n]*(\n|$)/m', '', $wikitext);
207 function get_date_atom($timestamp)
209 // Compatible with DATE_ATOM format
210 // return date(DATE_ATOM, $timestamp);
211 $zmin = abs(LOCALZONE / 60);
212 return date('Y-m-d\TH:i:s', $timestamp) . sprintf('%s%02d:%02d',
213 (LOCALZONE < 0 ? '-' : '+') , $zmin / 60, $zmin % 60);
217 function generate_fixed_heading_anchor_id($seed)
219 // A random alphabetic letter + 7 letters of random strings from md()
220 return chr(mt_rand(ord('a'), ord('z'))) .
221 substr(md5(uniqid(substr($seed, 0, 100), TRUE)),
225 // Read top N lines as an array
226 // (Use PHP file() function if you want to get ALL lines)
227 function file_head($file, $count = 1, $lock = TRUE, $buffer = 8192)
231 $fp = @fopen($file, 'r');
232 if ($fp === FALSE) return FALSE;
233 set_file_buffer($fp, 0);
234 if ($lock) flock($fp, LOCK_SH);
237 while (! feof($fp)) {
238 $line = fgets($fp, $buffer);
239 if ($line != FALSE) $array[] = $line;
240 if (++$index >= $count) break;
242 if ($lock) flock($fp, LOCK_UN);
243 if (! fclose($fp)) return FALSE;
249 function file_write($dir, $page, $str, $notimestamp = FALSE, $is_delete = FALSE)
251 global $_msg_invalidiwn, $notify, $notify_diff_only, $notify_subject;
252 global $whatsdeleted, $maxshow_deleted;
254 if (PKWK_READONLY) return; // Do nothing
255 if ($dir != DATA_DIR && $dir != DIFF_DIR) die('file_write(): Invalid directory');
257 $page = strip_bracket($page);
258 $file = $dir . encode($page) . '.txt';
259 $file_exists = file_exists($file);
264 if ($dir == DATA_DIR && $is_delete) {
266 if (! $file_exists) return; // Ignore null posting for DATA_DIR
268 // Update RecentDeleted (Add the $page)
269 add_recent($page, $whatsdeleted, '', $maxshow_deleted);
274 // Update RecentDeleted, and remove the page from RecentChanges
275 lastmodified_add($whatsdeleted, $page);
277 // Clear is_page() cache
278 is_page($page, TRUE);
282 } else if ($dir == DIFF_DIR && $str === " \n") {
283 return; // Ignore null posting for DIFF_DIR
287 // File replacement (Edit)
289 if (! is_pagename($page))
290 die_message(str_replace('$1', htmlsc($page),
291 str_replace('$2', 'WikiName', $_msg_invalidiwn)));
293 $str = rtrim(preg_replace('/' . "\r" . '/', '', $str)) . "\n";
294 $timestamp = ($file_exists && $notimestamp) ? filemtime($file) : FALSE;
296 $fp = fopen($file, 'a') or die('fopen() failed: ' .
297 htmlsc(basename($dir) . '/' . encode($page) . '.txt') .
299 'Maybe permission is not writable or filename is too long');
300 set_file_buffer($fp, 0);
308 if ($timestamp) pkwk_touch_file($file, $timestamp);
311 if ($dir == DATA_DIR) {
312 // Update RecentChanges (Add or renew the $page)
313 if ($timestamp === FALSE) lastmodified_add($page);
315 // Command execution per update
316 if (defined('PKWK_UPDATE_EXEC') && PKWK_UPDATE_EXEC)
317 system(PKWK_UPDATE_EXEC . ' > /dev/null &');
319 } else if ($dir == DIFF_DIR && $notify) {
320 if ($notify_diff_only) $str = preg_replace('/^[^-+].*\n/m', '', $str);
321 $footer['ACTION'] = 'Page update';
322 $footer['PAGE'] = & $page;
323 $footer['URI'] = get_script_uri() . '?' . pagename_urlencode($page);
324 $footer['USER_AGENT'] = TRUE;
325 $footer['REMOTE_ADDR'] = TRUE;
326 pkwk_mail_notify($notify_subject, $str, $footer) or
327 die('pkwk_mail_notify(): Failed');
330 is_page($page, TRUE); // Clear is_page() cache
333 // Update RecentDeleted
334 function add_recent($page, $recentpage, $subject = '', $limit = 0)
336 if (PKWK_READONLY || $limit == 0 || $page == '' || $recentpage == '' ||
337 check_non_list($page)) return;
340 $lines = $matches = array();
341 foreach (get_source($recentpage) as $line)
342 if (preg_match('/^-(.+) - (\[\[.+\]\])$/', $line, $matches))
343 $lines[$matches[2]] = $line;
345 $_page = '[[' . $page . ']]';
347 // Remove a report about the same page
348 if (isset($lines[$_page])) unset($lines[$_page]);
351 array_unshift($lines, '-' . format_date(UTIME) . ' - ' . $_page .
352 htmlsc($subject) . "\n");
354 // Get latest $limit reports
355 $lines = array_splice($lines, 0, $limit);
358 $fp = fopen(get_filename($recentpage), 'w') or
359 die_message('Cannot write page file ' .
360 htmlsc($recentpage) .
361 '<br />Maybe permission is not writable or filename is too long');
362 set_file_buffer($fp, 0);
365 fputs($fp, '#freeze' . "\n");
366 fputs($fp, '#norelated' . "\n"); // :)
367 fputs($fp, join('', $lines));
372 // Update PKWK_MAXSHOW_CACHE itself (Add or renew about the $page) (Light)
373 // Use without $autolink
374 function lastmodified_add($update = '', $remove = '')
376 global $maxshow, $whatsnew, $autolink;
378 // AutoLink implimentation needs everything, for now
380 put_lastmodified(); // Try to (re)create ALL
384 if (($update == '' || check_non_list($update)) && $remove == '')
387 $file = CACHE_DIR . PKWK_MAXSHOW_CACHE;
388 if (! file_exists($file)) {
389 put_lastmodified(); // Try to (re)create ALL
394 pkwk_touch_file($file);
395 $fp = fopen($file, 'r+') or
396 die_message('Cannot open ' . 'CACHE_DIR/' . PKWK_MAXSHOW_CACHE);
397 set_file_buffer($fp, 0);
400 // Read (keep the order of the lines)
401 $recent_pages = $matches = array();
402 foreach(file_head($file, $maxshow + PKWK_MAXSHOW_ALLOWANCE, FALSE) as $line)
403 if (preg_match('/^([0-9]+)\t(.+)/', $line, $matches))
404 $recent_pages[$matches[2]] = $matches[1];
406 // Remove if it exists inside
407 if (isset($recent_pages[$update])) unset($recent_pages[$update]);
408 if (isset($recent_pages[$remove])) unset($recent_pages[$remove]);
410 // Add to the top: like array_unshift()
412 $recent_pages = array($update => get_filetime($update)) + $recent_pages;
415 $abort = count($recent_pages) < $maxshow;
421 foreach ($recent_pages as $_page=>$time)
422 fputs($fp, $time . "\t" . $_page . "\n");
429 put_lastmodified(); // Try to (re)create ALL
436 // Update the page 'RecentChanges'
438 $recent_pages = array_splice($recent_pages, 0, $maxshow);
439 $file = get_filename($whatsnew);
442 pkwk_touch_file($file);
443 $fp = fopen($file, 'r+') or
444 die_message('Cannot open ' . htmlsc($whatsnew));
445 set_file_buffer($fp, 0);
451 foreach ($recent_pages as $_page=>$time)
452 fputs($fp, '-' . htmlsc(format_date($time)) .
453 ' - ' . '[[' . htmlsc($_page) . ']]' . "\n");
454 fputs($fp, '#norelated' . "\n"); // :)
460 // Re-create PKWK_MAXSHOW_CACHE (Heavy)
461 function put_lastmodified()
463 global $maxshow, $whatsnew, $autolink;
465 if (PKWK_READONLY) return; // Do nothing
467 // Get WHOLE page list
468 $pages = get_existpages();
470 // Check ALL filetime
471 $recent_pages = array();
472 foreach($pages as $page)
473 if ($page !== $whatsnew && ! check_non_list($page))
474 $recent_pages[$page] = get_filetime($page);
476 // Sort decending order of last-modification date
477 arsort($recent_pages, SORT_NUMERIC);
480 // BugTrack2/179: array_splice() will break integer keys in hashtable
481 $count = $maxshow + PKWK_MAXSHOW_ALLOWANCE;
483 foreach($recent_pages as $key=>$value) {
484 unset($recent_pages[$key]);
485 $_recent[$key] = $value;
486 if (--$count < 1) break;
488 $recent_pages = & $_recent;
490 // Re-create PKWK_MAXSHOW_CACHE
491 $file = CACHE_DIR . PKWK_MAXSHOW_CACHE;
492 pkwk_touch_file($file);
493 $fp = fopen($file, 'r+') or
494 die_message('Cannot open' . 'CACHE_DIR/' . PKWK_MAXSHOW_CACHE);
495 set_file_buffer($fp, 0);
499 foreach ($recent_pages as $page=>$time)
500 fputs($fp, $time . "\t" . $page . "\n");
504 // Create RecentChanges
505 $file = get_filename($whatsnew);
506 pkwk_touch_file($file);
507 $fp = fopen($file, 'r+') or
508 die_message('Cannot open ' . htmlsc($whatsnew));
509 set_file_buffer($fp, 0);
513 foreach (array_keys($recent_pages) as $page) {
514 $time = $recent_pages[$page];
515 $s_lastmod = htmlsc(format_date($time));
516 $s_page = htmlsc($page);
517 fputs($fp, '-' . $s_lastmod . ' - [[' . $s_page . ']]' . "\n");
519 fputs($fp, '#norelated' . "\n"); // :)
525 list($pattern, $pattern_a, $forceignorelist) =
526 get_autolink_pattern($pages);
528 $file = CACHE_DIR . PKWK_AUTOLINK_REGEX_CACHE;
529 pkwk_touch_file($file);
530 $fp = fopen($file, 'r+') or
531 die_message('Cannot open ' . 'CACHE_DIR/' . PKWK_AUTOLINK_REGEX_CACHE);
532 set_file_buffer($fp, 0);
536 fputs($fp, $pattern . "\n");
537 fputs($fp, $pattern_a . "\n");
538 fputs($fp, join("\t", $forceignorelist) . "\n");
544 // Get elapsed date of the page
545 function get_pg_passage($page, $sw = TRUE)
547 global $show_passage;
548 if (! $show_passage) return '';
550 $time = get_filetime($page);
551 $pg_passage = ($time != 0) ? get_passage($time) : '';
553 return $sw ? '<small>' . $pg_passage . '</small>' : ' ' . $pg_passage;
556 // Last-Modified header
557 function header_lastmod($page = NULL)
561 if ($lastmod && is_page($page)) {
563 header('Last-Modified: ' .
564 date('D, d M Y H:i:s', get_filetime($page)) . ' GMT');
568 // Get a list of encoded files (must specify a directory and a suffix)
569 function get_existfiles($dir = DATA_DIR, $ext = '.txt')
572 $pattern = '/^(?:[0-9A-F]{2})+' . preg_quote($ext, '/') . '$/';
574 $dp = @opendir($dir) or die_message($dir . ' is not found or not readable.');
575 while (($file = readdir($dp)) !== FALSE) {
576 if (preg_match($pattern, $file)) {
577 $aryret[] = $dir . $file;
585 // Get a page list of this wiki
586 function get_existpages($dir = DATA_DIR, $ext = '.txt')
589 $pattern = '/^((?:[0-9A-F]{2})+)' . preg_quote($ext, '/') . '$/';
591 $dp = @opendir($dir) or die_message($dir . ' is not found or not readable.');
593 while (($file = readdir($dp)) !== FALSE) {
594 if (preg_match($pattern, $file, $matches)) {
595 $aryret[$file] = decode($matches[1]);
603 // Get PageReading(pronounce-annotated) data in an array()
604 function get_readings()
606 global $pagereading_enable, $pagereading_kanji2kana_converter;
607 global $pagereading_kanji2kana_encoding, $pagereading_chasen_path;
608 global $pagereading_kakasi_path, $pagereading_config_page;
609 global $pagereading_config_dict;
611 $pages = get_existpages();
614 foreach ($pages as $page)
615 $readings[$page] = '';
617 $deletedPage = FALSE;
619 foreach (get_source($pagereading_config_page) as $line) {
621 if(preg_match('/^-\[\[([^]]+)\]\]\s+(.+)$/', $line, $matches)) {
622 if(isset($readings[$matches[1]])) {
623 // This page is not clear how to be pronounced
624 $readings[$matches[1]] = $matches[2];
626 // This page seems deleted
632 // If enabled ChaSen/KAKASI execution
633 if($pagereading_enable) {
635 // Check there's non-clear-pronouncing page
636 $unknownPage = FALSE;
637 foreach ($readings as $page => $reading) {
644 // Execute ChaSen/KAKASI, and get annotation
646 switch(strtolower($pagereading_kanji2kana_converter)) {
648 if(! file_exists($pagereading_chasen_path))
649 die_message('ChaSen not found: ' . $pagereading_chasen_path);
651 $tmpfname = tempnam(realpath(CACHE_DIR), 'PageReading');
652 $fp = fopen($tmpfname, 'w') or
653 die_message('Cannot write temporary file "' . $tmpfname . '".' . "\n");
654 foreach ($readings as $page => $reading) {
655 if($reading != '') continue;
656 fputs($fp, mb_convert_encoding($page . "\n",
657 $pagereading_kanji2kana_encoding, SOURCE_ENCODING));
661 $chasen = "$pagereading_chasen_path -F %y $tmpfname";
662 $fp = popen($chasen, 'r');
665 die_message('ChaSen execution failed: ' . $chasen);
667 foreach ($readings as $page => $reading) {
668 if($reading != '') continue;
671 $line = mb_convert_encoding($line, SOURCE_ENCODING,
672 $pagereading_kanji2kana_encoding);
674 $readings[$page] = $line;
679 die_message('Temporary file can not be removed: ' . $tmpfname);
682 case 'kakasi': /*FALLTHROUGH*/
684 if(! file_exists($pagereading_kakasi_path))
685 die_message('KAKASI not found: ' . $pagereading_kakasi_path);
687 $tmpfname = tempnam(realpath(CACHE_DIR), 'PageReading');
688 $fp = fopen($tmpfname, 'w') or
689 die_message('Cannot write temporary file "' . $tmpfname . '".' . "\n");
690 foreach ($readings as $page => $reading) {
691 if($reading != '') continue;
692 fputs($fp, mb_convert_encoding($page . "\n",
693 $pagereading_kanji2kana_encoding, SOURCE_ENCODING));
697 $kakasi = "$pagereading_kakasi_path -kK -HK -JK < $tmpfname";
698 $fp = popen($kakasi, 'r');
701 die_message('KAKASI execution failed: ' . $kakasi);
704 foreach ($readings as $page => $reading) {
705 if($reading != '') continue;
708 $line = mb_convert_encoding($line, SOURCE_ENCODING,
709 $pagereading_kanji2kana_encoding);
711 $readings[$page] = $line;
716 die_message('Temporary file can not be removed: ' . $tmpfname);
720 $patterns = $replacements = $matches = array();
721 foreach (get_source($pagereading_config_dict) as $line) {
723 if(preg_match('|^ /([^/]+)/,\s*(.+)$|', $line, $matches)) {
724 $patterns[] = $matches[1];
725 $replacements[] = $matches[2];
728 foreach ($readings as $page => $reading) {
729 if($reading != '') continue;
731 $readings[$page] = $page;
732 foreach ($patterns as $no => $pattern)
733 $readings[$page] = mb_convert_kana(mb_ereg_replace($pattern,
734 $replacements[$no], $readings[$page]), 'aKCV');
739 die_message('Unknown kanji-kana converter: ' . $pagereading_kanji2kana_converter . '.');
744 if($unknownPage || $deletedPage) {
746 asort($readings, SORT_STRING); // Sort by pronouncing(alphabetical/reading) order
748 foreach ($readings as $page => $reading)
749 $body .= '-[[' . $page . ']] ' . $reading . "\n";
751 page_write($pagereading_config_page, $body);
755 // Pages that are not prounouncing-clear, return pagenames of themselves
756 foreach ($pages as $page) {
757 if($readings[$page] == '')
758 $readings[$page] = $page;
764 // Get a list of related pages of the page
765 function links_get_related($page)
767 global $vars, $related;
768 static $links = array();
770 if (isset($links[$page])) return $links[$page];
772 // If possible, merge related pages generated by make_link()
773 $links[$page] = ($page === $vars['page']) ? $related : array();
775 // Get repated pages from DB
776 $links[$page] += links_get_related_db($vars['page']);
778 return $links[$page];
781 // _If needed_, re-create the file to change/correct ownership into PHP's
782 // NOTE: Not works for Windows
783 function pkwk_chown($filename, $preserve_time = TRUE)
785 static $php_uid; // PHP's UID
787 if (! isset($php_uid)) {
788 if (extension_loaded('posix')) {
789 $php_uid = posix_getuid(); // Unix
791 $php_uid = 0; // Windows
795 // Lock for pkwk_chown()
796 $lockfile = CACHE_DIR . 'pkwk_chown.lock';
797 $flock = fopen($lockfile, 'a') or
798 die('pkwk_chown(): fopen() failed for: CACHEDIR/' .
799 basename(htmlsc($lockfile)));
800 flock($flock, LOCK_EX) or die('pkwk_chown(): flock() failed for lock');
803 $stat = stat($filename) or
804 die('pkwk_chown(): stat() failed for: ' . basename(htmlsc($filename)));
805 if ($stat[4] === $php_uid) {
806 // NOTE: Windows always here
807 $result = TRUE; // Seems the same UID. Nothing to do
809 $tmp = $filename . '.' . getmypid() . '.tmp';
811 // Lock source $filename to avoid file corruption
812 // NOTE: Not 'r+'. Don't check write permission here
813 $ffile = fopen($filename, 'r') or
814 die('pkwk_chown(): fopen() failed for: ' .
815 basename(htmlsc($filename)));
817 // Try to chown by re-creating files
819 // * touch() before copy() is for 'rw-r--r--' instead of 'rwxr-xr-x' (with umask 022).
820 // * (PHP 4 < PHP 4.2.0) touch() with the third argument is not implemented and retuns NULL and Warn.
821 // * @unlink() before rename() is for Windows but here's for Unix only
822 flock($ffile, LOCK_EX) or die('pkwk_chown(): flock() failed');
823 $result = touch($tmp) && copy($filename, $tmp) &&
824 ($preserve_time ? (touch($tmp, $stat[9], $stat[8]) || touch($tmp, $stat[9])) : TRUE) &&
825 rename($tmp, $filename);
826 flock($ffile, LOCK_UN) or die('pkwk_chown(): flock() failed');
828 fclose($ffile) or die('pkwk_chown(): fclose() failed');
830 if ($result === FALSE) @unlink($tmp);
833 // Unlock for pkwk_chown()
834 flock($flock, LOCK_UN) or die('pkwk_chown(): flock() failed for lock');
835 fclose($flock) or die('pkwk_chown(): fclose() failed for lock');
840 // touch() with trying pkwk_chown()
841 function pkwk_touch_file($filename, $time = FALSE, $atime = FALSE)
843 // Is the owner incorrected and unable to correct?
844 if (! file_exists($filename) || pkwk_chown($filename)) {
845 if ($time === FALSE) {
846 $result = touch($filename);
847 } else if ($atime === FALSE) {
848 $result = touch($filename, $time);
850 $result = touch($filename, $time, $atime);
854 die('pkwk_touch_file(): Invalid UID and (not writable for the directory or not a flie): ' .
855 htmlsc(basename($filename)));
860 * Lock-enabled file_get_contents
864 function pkwk_file_get_contents($filename) {
865 if (! file_exists($filename)) {
868 $fp = fopen($filename, 'rb');
870 $file = file_get_contents($filename);
876 * Prepare some cache files for convert_html()
878 * * Make cache/autolink.dat if needed
880 function prepare_display_materials() {
883 // Make sure 'cache/autolink.dat'
884 $file = CACHE_DIR . PKWK_AUTOLINK_REGEX_CACHE;
885 if (!file_exists($file)) {
886 // Re-create autolink.dat