]> git.mxchange.org Git - quix0rs-gnu-social.git/blob - lib/util.php
Merge branch '0.8.x' of git@gitorious.org:laconica/mainline into 0.8.x
[quix0rs-gnu-social.git] / lib / util.php
1 <?php
2 /*
3  * Laconica - a distributed open-source microblogging tool
4  * Copyright (C) 2008, 2009, Control Yourself, Inc.
5  *
6  * This program is free software: you can redistribute it and/or modify
7  * it under the terms of the GNU Affero General Public License as published by
8  * the Free Software Foundation, either version 3 of the License, or
9  * (at your option) any later version.
10  *
11  * This program is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU Affero General Public License for more details.
15  *
16  * You should have received a copy of the GNU Affero General Public License
17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
18  */
19
20 /* XXX: break up into separate modules (HTTP, user, files) */
21
22 // Show a server error
23
24 function common_server_error($msg, $code=500)
25 {
26     $err = new ServerErrorAction($msg, $code);
27     $err->showPage();
28 }
29
30 // Show a user error
31 function common_user_error($msg, $code=400)
32 {
33     $err = new ClientErrorAction($msg, $code);
34     $err->showPage();
35 }
36
37 function common_init_locale($language=null)
38 {
39     if(!$language) {
40         $language = common_language();
41     }
42     putenv('LANGUAGE='.$language);
43     putenv('LANG='.$language);
44     return setlocale(LC_ALL, $language . ".utf8",
45                      $language . ".UTF8",
46                      $language . ".utf-8",
47                      $language . ".UTF-8",
48                      $language);
49 }
50
51 function common_init_language()
52 {
53     mb_internal_encoding('UTF-8');
54     $language = common_language();
55     // So we don't have to make people install the gettext locales
56     $locale_set = common_init_locale($language);
57     bindtextdomain("laconica", common_config('site','locale_path'));
58     bind_textdomain_codeset("laconica", "UTF-8");
59     textdomain("laconica");
60     setlocale(LC_CTYPE, 'C');
61     if(!$locale_set) {
62         common_log(LOG_INFO,'Language requested:'.$language.' - locale could not be set:',__FILE__);
63     }
64 }
65
66 function common_timezone()
67 {
68     if (common_logged_in()) {
69         $user = common_current_user();
70         if ($user->timezone) {
71             return $user->timezone;
72         }
73     }
74
75     return common_config('site', 'timezone');
76 }
77
78 function common_language()
79 {
80
81     // If there is a user logged in and they've set a language preference
82     // then return that one...
83     if (_have_config() && common_logged_in()) {
84         $user = common_current_user();
85         $user_language = $user->language;
86         if ($user_language)
87           return $user_language;
88     }
89
90     // Otherwise, find the best match for the languages requested by the
91     // user's browser...
92     $httplang = isset($_SERVER['HTTP_ACCEPT_LANGUAGE']) ? $_SERVER['HTTP_ACCEPT_LANGUAGE'] : null;
93     if (!empty($httplang)) {
94         $language = client_prefered_language($httplang);
95         if ($language)
96           return $language;
97     }
98
99     // Finally, if none of the above worked, use the site's default...
100     return common_config('site', 'language');
101 }
102 // salted, hashed passwords are stored in the DB
103
104 function common_munge_password($password, $id)
105 {
106     return md5($password . $id);
107 }
108
109 // check if a username exists and has matching password
110 function common_check_user($nickname, $password)
111 {
112     // NEVER allow blank passwords, even if they match the DB
113     if (mb_strlen($password) == 0) {
114         return false;
115     }
116     $user = User::staticGet('nickname', $nickname);
117     if (is_null($user) || $user === false) {
118         return false;
119     } else {
120         if (0 == strcmp(common_munge_password($password, $user->id),
121                         $user->password)) {
122             return $user;
123         } else {
124             return false;
125         }
126     }
127 }
128
129 // is the current user logged in?
130 function common_logged_in()
131 {
132     return (!is_null(common_current_user()));
133 }
134
135 function common_have_session()
136 {
137     return (0 != strcmp(session_id(), ''));
138 }
139
140 function common_ensure_session()
141 {
142     $c = null;
143     if (array_key_exists(session_name, $_COOKIE)) {
144         $c = $_COOKIE[session_name()];
145     }
146     if (!common_have_session()) {
147         if (common_config('sessions', 'handle')) {
148             Session::setSaveHandler();
149         }
150         @session_start();
151         if (!isset($_SESSION['started'])) {
152             $_SESSION['started'] = time();
153             if (!empty($c)) {
154                 common_log(LOG_WARNING, 'Session cookie "' . $_COOKIE[session_name()] . '" ' .
155                            ' is set but started value is null');
156             }
157         }
158     }
159 }
160
161 // Three kinds of arguments:
162 // 1) a user object
163 // 2) a nickname
164 // 3) null to clear
165
166 // Initialize to false; set to null if none found
167
168 $_cur = false;
169
170 function common_set_user($user)
171 {
172
173     global $_cur;
174
175     if (is_null($user) && common_have_session()) {
176         $_cur = null;
177         unset($_SESSION['userid']);
178         return true;
179     } else if (is_string($user)) {
180         $nickname = $user;
181         $user = User::staticGet('nickname', $nickname);
182     } else if (!($user instanceof User)) {
183         return false;
184     }
185
186     if ($user) {
187         common_ensure_session();
188         $_SESSION['userid'] = $user->id;
189         $_cur = $user;
190         return $_cur;
191     }
192     return false;
193 }
194
195 function common_set_cookie($key, $value, $expiration=0)
196 {
197     $path = common_config('site', 'path');
198     $server = common_config('site', 'server');
199
200     if ($path && ($path != '/')) {
201         $cookiepath = '/' . $path . '/';
202     } else {
203         $cookiepath = '/';
204     }
205     return setcookie($key,
206                      $value,
207                      $expiration,
208                      $cookiepath,
209                      $server);
210 }
211
212 define('REMEMBERME', 'rememberme');
213 define('REMEMBERME_EXPIRY', 30 * 24 * 60 * 60); // 30 days
214
215 function common_rememberme($user=null)
216 {
217     if (!$user) {
218         $user = common_current_user();
219         if (!$user) {
220             common_debug('No current user to remember', __FILE__);
221             return false;
222         }
223     }
224
225     $rm = new Remember_me();
226
227     $rm->code = common_good_rand(16);
228     $rm->user_id = $user->id;
229
230     // Wrap the insert in some good ol' fashioned transaction code
231
232     $rm->query('BEGIN');
233
234     $result = $rm->insert();
235
236     if (!$result) {
237         common_log_db_error($rm, 'INSERT', __FILE__);
238         common_debug('Error adding rememberme record for ' . $user->nickname, __FILE__);
239         return false;
240     }
241
242     $rm->query('COMMIT');
243
244     common_debug('Inserted rememberme record (' . $rm->code . ', ' . $rm->user_id . '); result = ' . $result . '.', __FILE__);
245
246     $cookieval = $rm->user_id . ':' . $rm->code;
247
248     common_log(LOG_INFO, 'adding rememberme cookie "' . $cookieval . '" for ' . $user->nickname);
249
250     common_set_cookie(REMEMBERME, $cookieval, time() + REMEMBERME_EXPIRY);
251
252     return true;
253 }
254
255 function common_remembered_user()
256 {
257
258     $user = null;
259
260     $packed = isset($_COOKIE[REMEMBERME]) ? $_COOKIE[REMEMBERME] : null;
261
262     if (!$packed) {
263         return null;
264     }
265
266     list($id, $code) = explode(':', $packed);
267
268     if (!$id || !$code) {
269         common_log(LOG_WARNING, 'Malformed rememberme cookie: ' . $packed);
270         common_forgetme();
271         return null;
272     }
273
274     $rm = Remember_me::staticGet($code);
275
276     if (!$rm) {
277         common_log(LOG_WARNING, 'No such remember code: ' . $code);
278         common_forgetme();
279         return null;
280     }
281
282     if ($rm->user_id != $id) {
283         common_log(LOG_WARNING, 'Rememberme code for wrong user: ' . $rm->user_id . ' != ' . $id);
284         common_forgetme();
285         return null;
286     }
287
288     $user = User::staticGet($rm->user_id);
289
290     if (!$user) {
291         common_log(LOG_WARNING, 'No such user for rememberme: ' . $rm->user_id);
292         common_forgetme();
293         return null;
294     }
295
296     // successful!
297     $result = $rm->delete();
298
299     if (!$result) {
300         common_log_db_error($rm, 'DELETE', __FILE__);
301         common_log(LOG_WARNING, 'Could not delete rememberme: ' . $code);
302         common_forgetme();
303         return null;
304     }
305
306     common_log(LOG_INFO, 'logging in ' . $user->nickname . ' using rememberme code ' . $rm->code);
307
308     common_set_user($user);
309     common_real_login(false);
310
311     // We issue a new cookie, so they can log in
312     // automatically again after this session
313
314     common_rememberme($user);
315
316     return $user;
317 }
318
319 // must be called with a valid user!
320
321 function common_forgetme()
322 {
323     common_set_cookie(REMEMBERME, '', 0);
324 }
325
326 // who is the current user?
327 function common_current_user()
328 {
329     global $_cur;
330
331     if (!_have_config()) {
332         return null;
333     }
334
335     if ($_cur === false) {
336
337         if (isset($_REQUEST[session_name()]) || (isset($_SESSION['userid']) && $_SESSION['userid'])) {
338             common_ensure_session();
339             $id = isset($_SESSION['userid']) ? $_SESSION['userid'] : false;
340             if ($id) {
341                 $_cur = User::staticGet($id);
342                 return $_cur;
343             }
344         }
345
346         // that didn't work; try to remember; will init $_cur to null on failure
347         $_cur = common_remembered_user();
348
349         if ($_cur) {
350             common_debug("Got User " . $_cur->nickname);
351             common_debug("Faking session on remembered user");
352             // XXX: Is this necessary?
353             $_SESSION['userid'] = $_cur->id;
354         }
355     }
356
357     return $_cur;
358 }
359
360 // Logins that are 'remembered' aren't 'real' -- they're subject to
361 // cookie-stealing. So, we don't let them do certain things. New reg,
362 // OpenID, and password logins _are_ real.
363
364 function common_real_login($real=true)
365 {
366     common_ensure_session();
367     $_SESSION['real_login'] = $real;
368 }
369
370 function common_is_real_login()
371 {
372     return common_logged_in() && $_SESSION['real_login'];
373 }
374
375 // get canonical version of nickname for comparison
376 function common_canonical_nickname($nickname)
377 {
378     // XXX: UTF-8 canonicalization (like combining chars)
379     return strtolower($nickname);
380 }
381
382 // get canonical version of email for comparison
383 function common_canonical_email($email)
384 {
385     // XXX: canonicalize UTF-8
386     // XXX: lcase the domain part
387     return $email;
388 }
389
390 function common_render_content($text, $notice)
391 {
392     $r = common_render_text($text);
393     $id = $notice->profile_id;
394     $r = preg_replace('/(^|\s+)@([A-Za-z0-9]{1,64})/e', "'\\1@'.common_at_link($id, '\\2')", $r);
395     $r = preg_replace('/^T ([A-Z0-9]{1,64}) /e', "'T '.common_at_link($id, '\\1').' '", $r);
396     $r = preg_replace('/(^|\s+)@#([A-Za-z0-9]{1,64})/e', "'\\1@#'.common_at_hash_link($id, '\\2')", $r);
397     $r = preg_replace('/(^|\s)!([A-Za-z0-9]{1,64})/e', "'\\1!'.common_group_link($id, '\\2')", $r);
398     return $r;
399 }
400
401 function common_render_text($text)
402 {
403     $r = htmlspecialchars($text);
404
405     $r = preg_replace('/[\x{0}-\x{8}\x{b}-\x{c}\x{e}-\x{19}]/', '', $r);
406     $r = common_replace_urls_callback($r, 'common_linkify');
407     $r = preg_replace('/(^|\(|\[|\s+)#([\pL\pN_\-\.]{1,64})/e', "'\\1#'.common_tag_link('\\2')", $r);
408     // XXX: machine tags
409     return $r;
410 }
411
412 function common_replace_urls_callback($text, $callback, $notice_id = null) {
413     // Start off with a regex
414     $regex = '#'.
415     '(?:'.
416         '(?:'.
417             '(?:https?|ftps?|mms|rtsp|gopher|news|nntp|telnet|wais|file|prospero|webcal|irc)://'.
418             '|'.
419             '(?:mailto|aim|tel|xmpp):'.
420         ')'.
421         '[^.\s]+\.[^\s]+'.
422         '|'.
423         '(?:[^.\s/:]+\.)+'.
424         '(?:museum|travel|[a-z]{2,4})'.
425         '(?:[:/][^\s]*)?'.
426     ')'.
427     '#ix';
428     preg_match_all($regex, $text, $matches);
429
430     // Then clean up what the regex left behind
431     $offset = 0;
432     foreach($matches[0] as $orig_url) {
433         $url = htmlspecialchars_decode($orig_url);
434
435         // Make sure we didn't pick up an email address
436         if (preg_match('#^[A-Z0-9._%+-]+@[A-Z0-9.-]+\.[A-Z]{2,4}$#i', $url)) continue;
437
438         // Remove surrounding punctuation
439         $url = trim($url, '.?!,;:\'"`([<');
440
441         // Remove surrounding parens and the like
442         preg_match('/[)\]>]+$/', $url, $trailing);
443         if (isset($trailing[0])) {
444             preg_match_all('/[(\[<]/', $url, $opened);
445             preg_match_all('/[)\]>]/', $url, $closed);
446             $unopened = count($closed[0]) - count($opened[0]);
447
448             // Make sure not to take off more closing parens than there are at the end
449             $unopened = ($unopened > mb_strlen($trailing[0])) ? mb_strlen($trailing[0]):$unopened;
450
451             $url = ($unopened > 0) ? mb_substr($url, 0, $unopened * -1):$url;
452         }
453
454         // Remove trailing punctuation again (in case there were some inside parens)
455         $url = rtrim($url, '.?!,;:\'"`');
456
457         // Make sure we didn't capture part of the next sentence
458         preg_match('#((?:[^.\s/]+\.)+)(museum|travel|[a-z]{2,4})#i', $url, $url_parts);
459
460         // Were the parts capitalized any?
461         $last_part = (mb_strtolower($url_parts[2]) !== $url_parts[2]) ? true:false;
462         $prev_part = (mb_strtolower($url_parts[1]) !== $url_parts[1]) ? true:false;
463
464         // If the first part wasn't cap'd but the last part was, we captured too much
465         if ((!$prev_part && $last_part)) {
466             $url = mb_substr($url, 0 , mb_strpos($url, '.'.$url_parts['2'], 0));
467         }
468
469         // Capture the new TLD
470         preg_match('#((?:[^.\s/]+\.)+)(museum|travel|[a-z]{2,4})#i', $url, $url_parts);
471
472         $tlds = array('ac', 'ad', 'ae', 'aero', 'af', 'ag', 'ai', 'al', 'am', 'an', 'ao', 'aq', 'ar', 'arpa', 'as', 'asia', 'at', 'au', 'aw', 'ax', 'az', 'ba', 'bb', 'bd', 'be', 'bf', 'bg', 'bh', 'bi', 'biz', 'bj', 'bm', 'bn', 'bo', 'br', 'bs', 'bt', 'bv', 'bw', 'by', 'bz', 'ca', 'cat', 'cc', 'cd', 'cf', 'cg', 'ch', 'ci', 'ck', 'cl', 'cm', 'cn', 'co', 'com', 'coop', 'cr', 'cu', 'cv', 'cx', 'cy', 'cz', 'de', 'dj', 'dk', 'dm', 'do', 'dz', 'ec', 'edu', 'ee', 'eg', 'er', 'es', 'et', 'eu', 'fi', 'fj', 'fk', 'fm', 'fo', 'fr', 'ga', 'gb', 'gd', 'ge', 'gf', 'gg', 'gh', 'gi', 'gl', 'gm', 'gn', 'gov', 'gp', 'gq', 'gr', 'gs', 'gt', 'gu', 'gw', 'gy', 'hk', 'hm', 'hn', 'hr', 'ht', 'hu', 'id', 'ie', 'il', 'im', 'in', 'info', 'int', 'io', 'iq', 'ir', 'is', 'it', 'je', 'jm', 'jo', 'jobs', 'jp', 'ke', 'kg', 'kh', 'ki', 'km', 'kn', 'kp', 'kr', 'kw', 'ky', 'kz', 'la', 'lb', 'lc', 'li', 'lk', 'lr', 'ls', 'lt', 'lu', 'lv', 'ly', 'ma', 'mc', 'md', 'me', 'mg', 'mh', 'mil', 'mk', 'ml', 'mm', 'mn', 'mo', 'mobi', 'mp', 'mq', 'mr', 'ms', 'mt', 'mu', 'museum', 'mv', 'mw', 'mx', 'my', 'mz', 'na', 'name', 'nc', 'ne', 'net', 'nf', 'ng', 'ni', 'nl', 'no', 'np', 'nr', 'nu', 'nz', 'om', 'org', 'pa', 'pe', 'pf', 'pg', 'ph', 'pk', 'pl', 'pm', 'pn', 'pr', 'pro', 'ps', 'pt', 'pw', 'py', 'qa', 're', 'ro', 'rs', 'ru', 'rw', 'sa', 'sb', 'sc', 'sd', 'se', 'sg', 'sh', 'si', 'sj', 'sk', 'sl', 'sm', 'sn', 'so', 'sr', 'st', 'su', 'sv', 'sy', 'sz', 'tc', 'td', 'tel', 'tf', 'tg', 'th', 'tj', 'tk', 'tl', 'tm', 'tn', 'to', 'tp', 'tr', 'travel', 'tt', 'tv', 'tw', 'tz', 'ua', 'ug', 'uk', 'us', 'uy', 'uz', 'va', 'vc', 've', 'vg', 'vi', 'vn', 'vu', 'wf', 'ws', 'ye', 'yt', 'yu', 'za', 'zm', 'zw');
473
474         if (!in_array($url_parts[2], $tlds)) continue;
475
476         // Make sure we didn't capture a hash tag
477         if (strpos($url, '#') === 0) continue;
478
479         // Put the url back the way we found it.
480         $url = (mb_strpos($orig_url, htmlspecialchars($url)) === FALSE) ? $url:htmlspecialchars($url);
481
482         // Call user specified func
483         if (empty($notice_id)) {
484             $modified_url = call_user_func($callback, $url);
485         } else {
486             $modified_url = call_user_func($callback, array($url, $notice_id));
487         }
488
489         // Replace it!
490         $start = mb_strpos($text, $url, $offset);
491         $text = mb_substr($text, 0, $start).$modified_url.mb_substr($text, $start + mb_strlen($url), mb_strlen($text));
492         $offset = $start + mb_strlen($modified_url);
493     }
494
495     return $text;
496 }
497
498 function common_linkify($url) {
499     // It comes in special'd, so we unspecial it before passing to the stringifying
500     // functions
501     $url = htmlspecialchars_decode($url);
502
503     $canon = File_redirection::_canonUrl($url);
504
505     $longurl_data = File_redirection::where($url);
506     if (is_array($longurl_data)) {
507         $longurl = $longurl_data['url'];
508     } elseif (is_string($longurl_data)) {
509         $longurl = $longurl_data;
510     } else {
511         throw new ServerException("Can't linkify url '$url'");
512     }
513
514     $attrs = array('href' => $canon, 'rel' => 'external');
515
516     $is_attachment = false;
517     $attachment_id = null;
518     $has_thumb = false;
519
520     // Check to see whether there's a filename associated with this URL.
521     // If there is, it's an upload and qualifies as an attachment
522
523     $localfile = File::staticGet('url', $longurl);
524
525     if (!empty($localfile)) {
526         if (isset($localfile->filename)) {
527             $is_attachment = true;
528             $attachment_id = $localfile->id;
529         }
530     }
531
532     // if this URL is an attachment, then we set class='attachment' and id='attahcment-ID'
533     // where ID is the id of the attachment for the given URL.
534     //
535     // we need a better test telling what can be shown as an attachment
536     // we're currently picking up oembeds only.
537     // I think the best option is another file_view table in the db
538     // and associated dbobject.
539
540     $query = "select file_oembed.file_id as file_id from file join file_oembed on file.id = file_oembed.file_id where file.url='$longurl'";
541     $file = new File;
542     $file->query($query);
543     $file->fetch();
544
545     if (!empty($file->file_id)) {
546         $is_attachment = true;
547         $attachment_id = $file->file_id;
548
549         $query = "select file_thumbnail.file_id as file_id from file join file_thumbnail on file.id = file_thumbnail.file_id where file.url='$longurl'";
550         $file2 = new File;
551         $file2->query($query);
552         $file2->fetch();
553
554         if (!empty($file2)) {
555             $has_thumb = true;
556         }
557     }
558
559     // Add clippy
560     if ($is_attachment) {
561         $attrs['class'] = 'attachment';
562         if ($has_thumb) {
563             $attrs['class'] = 'attachment thumbnail';
564         }
565         $attrs['id'] = "attachment-{$attachment_id}";
566     }
567
568     return XMLStringer::estring('a', $attrs, $url);
569 }
570
571 function common_shorten_links($text)
572 {
573     if (mb_strlen($text) <= 140) return $text;
574     return common_replace_urls_callback($text, array('File_redirection', 'makeShort'));
575 }
576
577 function common_xml_safe_str($str)
578 {
579     // Neutralize control codes and surrogates
580         return preg_replace('/[\p{Cc}\p{Cs}]/u', '*', $str);
581 }
582
583 function common_tag_link($tag)
584 {
585     $canonical = common_canonical_tag($tag);
586     $url = common_local_url('tag', array('tag' => $canonical));
587     $xs = new XMLStringer();
588     $xs->elementStart('span', 'tag');
589     $xs->element('a', array('href' => $url,
590                             'rel' => 'tag'),
591                  $tag);
592     $xs->elementEnd('span');
593     return $xs->getString();
594 }
595
596 function common_canonical_tag($tag)
597 {
598   $tag = mb_convert_case($tag, MB_CASE_LOWER, "UTF-8");
599   return str_replace(array('-', '_', '.'), '', $tag);
600 }
601
602 function common_valid_profile_tag($str)
603 {
604     return preg_match('/^[A-Za-z0-9_\-\.]{1,64}$/', $str);
605 }
606
607 function common_at_link($sender_id, $nickname)
608 {
609     $sender = Profile::staticGet($sender_id);
610     $recipient = common_relative_profile($sender, common_canonical_nickname($nickname));
611     if ($recipient) {
612         $user = User::staticGet('id', $recipient->id);
613         if ($user) {
614             $url = common_local_url('userbyid', array('id' => $user->id));
615         } else {
616             $url = $recipient->profileurl;
617         }
618         $xs = new XMLStringer(false);
619         $attrs = array('href' => $url,
620                        'class' => 'url');
621         if (!empty($recipient->fullname)) {
622             $attrs['title'] = $recipient->fullname . ' (' . $recipient->nickname . ')';
623         }
624         $xs->elementStart('span', 'vcard');
625         $xs->elementStart('a', $attrs);
626         $xs->element('span', 'fn nickname', $nickname);
627         $xs->elementEnd('a');
628         $xs->elementEnd('span');
629         return $xs->getString();
630     } else {
631         return $nickname;
632     }
633 }
634
635 function common_group_link($sender_id, $nickname)
636 {
637     $sender = Profile::staticGet($sender_id);
638     $group = User_group::getForNickname($nickname);
639     if ($group && $sender->isMember($group)) {
640         $attrs = array('href' => $group->permalink(),
641                        'class' => 'url');
642         if (!empty($group->fullname)) {
643             $attrs['title'] = $group->fullname . ' (' . $group->nickname . ')';
644         }
645         $xs = new XMLStringer();
646         $xs->elementStart('span', 'vcard');
647         $xs->elementStart('a', $attrs);
648         $xs->element('span', 'fn nickname', $nickname);
649         $xs->elementEnd('a');
650         $xs->elementEnd('span');
651         return $xs->getString();
652     } else {
653         return $nickname;
654     }
655 }
656
657 function common_at_hash_link($sender_id, $tag)
658 {
659     $user = User::staticGet($sender_id);
660     if (!$user) {
661         return $tag;
662     }
663     $tagged = Profile_tag::getTagged($user->id, common_canonical_tag($tag));
664     if ($tagged) {
665         $url = common_local_url('subscriptions',
666                                 array('nickname' => $user->nickname,
667                                       'tag' => $tag));
668         $xs = new XMLStringer();
669         $xs->elementStart('span', 'tag');
670         $xs->element('a', array('href' => $url,
671                                 'rel' => $tag),
672                      $tag);
673         $xs->elementEnd('span');
674         return $xs->getString();
675     } else {
676         return $tag;
677     }
678 }
679
680 function common_relative_profile($sender, $nickname, $dt=null)
681 {
682     // Try to find profiles this profile is subscribed to that have this nickname
683     $recipient = new Profile();
684     // XXX: use a join instead of a subquery
685     $recipient->whereAdd('EXISTS (SELECT subscribed from subscription where subscriber = '.$sender->id.' and subscribed = id)', 'AND');
686     $recipient->whereAdd("nickname = '" . trim($nickname) . "'", 'AND');
687     if ($recipient->find(true)) {
688         // XXX: should probably differentiate between profiles with
689         // the same name by date of most recent update
690         return $recipient;
691     }
692     // Try to find profiles that listen to this profile and that have this nickname
693     $recipient = new Profile();
694     // XXX: use a join instead of a subquery
695     $recipient->whereAdd('EXISTS (SELECT subscriber from subscription where subscribed = '.$sender->id.' and subscriber = id)', 'AND');
696     $recipient->whereAdd("nickname = '" . trim($nickname) . "'", 'AND');
697     if ($recipient->find(true)) {
698         // XXX: should probably differentiate between profiles with
699         // the same name by date of most recent update
700         return $recipient;
701     }
702     // If this is a local user, try to find a local user with that nickname.
703     $sender = User::staticGet($sender->id);
704     if ($sender) {
705         $recipient_user = User::staticGet('nickname', $nickname);
706         if ($recipient_user) {
707             return $recipient_user->getProfile();
708         }
709     }
710     // Otherwise, no links. @messages from local users to remote users,
711     // or from remote users to other remote users, are just
712     // outside our ability to make intelligent guesses about
713     return null;
714 }
715
716 function common_local_url($action, $args=null, $params=null, $fragment=null)
717 {
718     static $sensitive = array('login', 'register', 'passwordsettings',
719                               'twittersettings', 'finishopenidlogin',
720                               'finishaddopenid', 'api');
721
722     $r = Router::get();
723     $path = $r->build($action, $args, $params, $fragment);
724
725     $ssl = in_array($action, $sensitive);
726
727     if (common_config('site','fancy')) {
728         $url = common_path(mb_substr($path, 1), $ssl);
729     } else {
730         if (mb_strpos($path, '/index.php') === 0) {
731             $url = common_path(mb_substr($path, 1), $ssl);
732         } else {
733             $url = common_path('index.php'.$path, $ssl);
734         }
735     }
736     return $url;
737 }
738
739 function common_path($relative, $ssl=false)
740 {
741     $pathpart = (common_config('site', 'path')) ? common_config('site', 'path')."/" : '';
742
743     if (($ssl && (common_config('site', 'ssl') === 'sometimes'))
744         || common_config('site', 'ssl') === 'always') {
745         $proto = 'https';
746         if (is_string(common_config('site', 'sslserver')) &&
747             mb_strlen(common_config('site', 'sslserver')) > 0) {
748             $serverpart = common_config('site', 'sslserver');
749         } else {
750             $serverpart = common_config('site', 'server');
751         }
752     } else {
753         $proto = 'http';
754         $serverpart = common_config('site', 'server');
755     }
756
757     return $proto.'://'.$serverpart.'/'.$pathpart.$relative;
758 }
759
760 function common_date_string($dt)
761 {
762     // XXX: do some sexy date formatting
763     // return date(DATE_RFC822, $dt);
764     $t = strtotime($dt);
765     $now = time();
766     $diff = $now - $t;
767
768     if ($now < $t) { // that shouldn't happen!
769         return common_exact_date($dt);
770     } else if ($diff < 60) {
771         return _('a few seconds ago');
772     } else if ($diff < 92) {
773         return _('about a minute ago');
774     } else if ($diff < 3300) {
775         return sprintf(_('about %d minutes ago'), round($diff/60));
776     } else if ($diff < 5400) {
777         return _('about an hour ago');
778     } else if ($diff < 22 * 3600) {
779         return sprintf(_('about %d hours ago'), round($diff/3600));
780     } else if ($diff < 37 * 3600) {
781         return _('about a day ago');
782     } else if ($diff < 24 * 24 * 3600) {
783         return sprintf(_('about %d days ago'), round($diff/(24*3600)));
784     } else if ($diff < 46 * 24 * 3600) {
785         return _('about a month ago');
786     } else if ($diff < 330 * 24 * 3600) {
787         return sprintf(_('about %d months ago'), round($diff/(30*24*3600)));
788     } else if ($diff < 480 * 24 * 3600) {
789         return _('about a year ago');
790     } else {
791         return common_exact_date($dt);
792     }
793 }
794
795 function common_exact_date($dt)
796 {
797     static $_utc;
798     static $_siteTz;
799
800     if (!$_utc) {
801         $_utc = new DateTimeZone('UTC');
802         $_siteTz = new DateTimeZone(common_timezone());
803     }
804
805     $dateStr = date('d F Y H:i:s', strtotime($dt));
806     $d = new DateTime($dateStr, $_utc);
807     $d->setTimezone($_siteTz);
808     return $d->format(DATE_RFC850);
809 }
810
811 function common_date_w3dtf($dt)
812 {
813     $dateStr = date('d F Y H:i:s', strtotime($dt));
814     $d = new DateTime($dateStr, new DateTimeZone('UTC'));
815     $d->setTimezone(new DateTimeZone(common_timezone()));
816     return $d->format(DATE_W3C);
817 }
818
819 function common_date_rfc2822($dt)
820 {
821     $dateStr = date('d F Y H:i:s', strtotime($dt));
822     $d = new DateTime($dateStr, new DateTimeZone('UTC'));
823     $d->setTimezone(new DateTimeZone(common_timezone()));
824     return $d->format('r');
825 }
826
827 function common_date_iso8601($dt)
828 {
829     $dateStr = date('d F Y H:i:s', strtotime($dt));
830     $d = new DateTime($dateStr, new DateTimeZone('UTC'));
831     $d->setTimezone(new DateTimeZone(common_timezone()));
832     return $d->format('c');
833 }
834
835 function common_sql_now()
836 {
837     return common_sql_date(time());
838 }
839
840 function common_sql_date($datetime)
841 {
842     return strftime('%Y-%m-%d %H:%M:%S', $datetime);
843 }
844
845 function common_redirect($url, $code=307)
846 {
847     static $status = array(301 => "Moved Permanently",
848                            302 => "Found",
849                            303 => "See Other",
850                            307 => "Temporary Redirect");
851
852     header('HTTP/1.1 '.$code.' '.$status[$code]);
853     header("Location: $url");
854
855     $xo = new XMLOutputter();
856     $xo->startXML('a',
857                   '-//W3C//DTD XHTML 1.0 Strict//EN',
858                   'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd');
859     $xo->element('a', array('href' => $url), $url);
860     $xo->endXML();
861     exit;
862 }
863
864 function common_broadcast_notice($notice, $remote=false)
865 {
866     return common_enqueue_notice($notice);
867 }
868
869 // Stick the notice on the queue
870
871 function common_enqueue_notice($notice)
872 {
873     static $localTransports = array('omb',
874                                     'twitter',
875                                     'facebook',
876                                     'ping');
877     static $allTransports = array('sms');
878
879     $transports = $allTransports;
880
881     $xmpp = common_config('xmpp', 'enabled');
882
883     if ($xmpp) {
884         $transports[] = 'jabber';
885     }
886
887     if ($notice->is_local == NOTICE_LOCAL_PUBLIC ||
888         $notice->is_local == NOTICE_LOCAL_NONPUBLIC) {
889         $transports = array_merge($transports, $localTransports);
890         if ($xmpp) {
891             $transports[] = 'public';
892         }
893     }
894
895     $qm = QueueManager::get();
896
897     foreach ($transports as $transport)
898     {
899         $qm->enqueue($notice, $transport);
900     }
901
902     return true;
903 }
904
905 function common_broadcast_profile($profile)
906 {
907     // XXX: optionally use a queue system like http://code.google.com/p/microapps/wiki/NQDQ
908     require_once(INSTALLDIR.'/lib/omb.php');
909     omb_broadcast_profile($profile);
910     // XXX: Other broadcasts...?
911     return true;
912 }
913
914 function common_profile_url($nickname)
915 {
916     return common_local_url('showstream', array('nickname' => $nickname));
917 }
918
919 // Should make up a reasonable root URL
920
921 function common_root_url($ssl=false)
922 {
923     return common_path('', $ssl);
924 }
925
926 // returns $bytes bytes of random data as a hexadecimal string
927 // "good" here is a goal and not a guarantee
928
929 function common_good_rand($bytes)
930 {
931     // XXX: use random.org...?
932     if (@file_exists('/dev/urandom')) {
933         return common_urandom($bytes);
934     } else { // FIXME: this is probably not good enough
935         return common_mtrand($bytes);
936     }
937 }
938
939 function common_urandom($bytes)
940 {
941     $h = fopen('/dev/urandom', 'rb');
942     // should not block
943     $src = fread($h, $bytes);
944     fclose($h);
945     $enc = '';
946     for ($i = 0; $i < $bytes; $i++) {
947         $enc .= sprintf("%02x", (ord($src[$i])));
948     }
949     return $enc;
950 }
951
952 function common_mtrand($bytes)
953 {
954     $enc = '';
955     for ($i = 0; $i < $bytes; $i++) {
956         $enc .= sprintf("%02x", mt_rand(0, 255));
957     }
958     return $enc;
959 }
960
961 function common_set_returnto($url)
962 {
963     common_ensure_session();
964     $_SESSION['returnto'] = $url;
965 }
966
967 function common_get_returnto()
968 {
969     common_ensure_session();
970     return $_SESSION['returnto'];
971 }
972
973 function common_timestamp()
974 {
975     return date('YmdHis');
976 }
977
978 function common_ensure_syslog()
979 {
980     static $initialized = false;
981     if (!$initialized) {
982         openlog(common_config('syslog', 'appname'), 0,
983             common_config('syslog', 'facility'));
984         $initialized = true;
985     }
986 }
987
988 function common_log_line($priority, $msg)
989 {
990     static $syslog_priorities = array('LOG_EMERG', 'LOG_ALERT', 'LOG_CRIT', 'LOG_ERR',
991                                       'LOG_WARNING', 'LOG_NOTICE', 'LOG_INFO', 'LOG_DEBUG');
992     return date('Y-m-d H:i:s') . ' ' . $syslog_priorities[$priority] . ': ' . $msg . "\n";
993 }
994
995 function common_log($priority, $msg, $filename=null)
996 {
997     $logfile = common_config('site', 'logfile');
998     if ($logfile) {
999         $log = fopen($logfile, "a");
1000         if ($log) {
1001             $output = common_log_line($priority, $msg);
1002             fwrite($log, $output);
1003             fclose($log);
1004         }
1005     } else {
1006         common_ensure_syslog();
1007         syslog($priority, $msg);
1008     }
1009 }
1010
1011 function common_debug($msg, $filename=null)
1012 {
1013     if ($filename) {
1014         common_log(LOG_DEBUG, basename($filename).' - '.$msg);
1015     } else {
1016         common_log(LOG_DEBUG, $msg);
1017     }
1018 }
1019
1020 function common_log_db_error(&$object, $verb, $filename=null)
1021 {
1022     $objstr = common_log_objstring($object);
1023     $last_error = &PEAR::getStaticProperty('DB_DataObject','lastError');
1024     common_log(LOG_ERR, $last_error->message . '(' . $verb . ' on ' . $objstr . ')', $filename);
1025 }
1026
1027 function common_log_objstring(&$object)
1028 {
1029     if (is_null($object)) {
1030         return "null";
1031     }
1032     if (!($object instanceof DB_DataObject)) {
1033         return "(unknown)";
1034     }
1035     $arr = $object->toArray();
1036     $fields = array();
1037     foreach ($arr as $k => $v) {
1038         $fields[] = "$k='$v'";
1039     }
1040     $objstring = $object->tableName() . '[' . implode(',', $fields) . ']';
1041     return $objstring;
1042 }
1043
1044 function common_valid_http_url($url)
1045 {
1046     return Validate::uri($url, array('allowed_schemes' => array('http', 'https')));
1047 }
1048
1049 function common_valid_tag($tag)
1050 {
1051     if (preg_match('/^tag:(.*?),(\d{4}(-\d{2}(-\d{2})?)?):(.*)$/', $tag, $matches)) {
1052         return (Validate::email($matches[1]) ||
1053                 preg_match('/^([\w-\.]+)$/', $matches[1]));
1054     }
1055     return false;
1056 }
1057
1058 /* Following functions are copied from MediaWiki GlobalFunctions.php
1059  * and written by Evan Prodromou. */
1060
1061 function common_accept_to_prefs($accept, $def = '*/*')
1062 {
1063     // No arg means accept anything (per HTTP spec)
1064     if(!$accept) {
1065         return array($def => 1);
1066     }
1067
1068     $prefs = array();
1069
1070     $parts = explode(',', $accept);
1071
1072     foreach($parts as $part) {
1073         // FIXME: doesn't deal with params like 'text/html; level=1'
1074         @list($value, $qpart) = explode(';', trim($part));
1075         $match = array();
1076         if(!isset($qpart)) {
1077             $prefs[$value] = 1;
1078         } elseif(preg_match('/q\s*=\s*(\d*\.\d+)/', $qpart, $match)) {
1079             $prefs[$value] = $match[1];
1080         }
1081     }
1082
1083     return $prefs;
1084 }
1085
1086 function common_mime_type_match($type, $avail)
1087 {
1088     if(array_key_exists($type, $avail)) {
1089         return $type;
1090     } else {
1091         $parts = explode('/', $type);
1092         if(array_key_exists($parts[0] . '/*', $avail)) {
1093             return $parts[0] . '/*';
1094         } elseif(array_key_exists('*/*', $avail)) {
1095             return '*/*';
1096         } else {
1097             return null;
1098         }
1099     }
1100 }
1101
1102 function common_negotiate_type($cprefs, $sprefs)
1103 {
1104     $combine = array();
1105
1106     foreach(array_keys($sprefs) as $type) {
1107         $parts = explode('/', $type);
1108         if($parts[1] != '*') {
1109             $ckey = common_mime_type_match($type, $cprefs);
1110             if($ckey) {
1111                 $combine[$type] = $sprefs[$type] * $cprefs[$ckey];
1112             }
1113         }
1114     }
1115
1116     foreach(array_keys($cprefs) as $type) {
1117         $parts = explode('/', $type);
1118         if($parts[1] != '*' && !array_key_exists($type, $sprefs)) {
1119             $skey = common_mime_type_match($type, $sprefs);
1120             if($skey) {
1121                 $combine[$type] = $sprefs[$skey] * $cprefs[$type];
1122             }
1123         }
1124     }
1125
1126     $bestq = 0;
1127     $besttype = 'text/html';
1128
1129     foreach(array_keys($combine) as $type) {
1130         if($combine[$type] > $bestq) {
1131             $besttype = $type;
1132             $bestq = $combine[$type];
1133         }
1134     }
1135
1136     if ('text/html' === $besttype) {
1137         return "text/html; charset=utf-8";
1138     }
1139     return $besttype;
1140 }
1141
1142 function common_config($main, $sub)
1143 {
1144     global $config;
1145     return isset($config[$main][$sub]) ? $config[$main][$sub] : false;
1146 }
1147
1148 function common_copy_args($from)
1149 {
1150     $to = array();
1151     $strip = get_magic_quotes_gpc();
1152     foreach ($from as $k => $v) {
1153         $to[$k] = ($strip) ? stripslashes($v) : $v;
1154     }
1155     return $to;
1156 }
1157
1158 // Neutralise the evil effects of magic_quotes_gpc in the current request.
1159 // This is used before handing a request off to OAuthRequest::from_request.
1160 function common_remove_magic_from_request()
1161 {
1162     if(get_magic_quotes_gpc()) {
1163         $_POST=array_map('stripslashes',$_POST);
1164         $_GET=array_map('stripslashes',$_GET);
1165     }
1166 }
1167
1168 function common_user_uri(&$user)
1169 {
1170     return common_local_url('userbyid', array('id' => $user->id));
1171 }
1172
1173 function common_notice_uri(&$notice)
1174 {
1175     return common_local_url('shownotice',
1176                             array('notice' => $notice->id));
1177 }
1178
1179 // 36 alphanums - lookalikes (0, O, 1, I) = 32 chars = 5 bits
1180
1181 function common_confirmation_code($bits)
1182 {
1183     // 36 alphanums - lookalikes (0, O, 1, I) = 32 chars = 5 bits
1184     static $codechars = '23456789ABCDEFGHJKLMNPQRSTUVWXYZ';
1185     $chars = ceil($bits/5);
1186     $code = '';
1187     for ($i = 0; $i < $chars; $i++) {
1188         // XXX: convert to string and back
1189         $num = hexdec(common_good_rand(1));
1190         // XXX: randomness is too precious to throw away almost
1191         // 40% of the bits we get!
1192         $code .= $codechars[$num%32];
1193     }
1194     return $code;
1195 }
1196
1197 // convert markup to HTML
1198
1199 function common_markup_to_html($c)
1200 {
1201     $c = preg_replace('/%%action.(\w+)%%/e', "common_local_url('\\1')", $c);
1202     $c = preg_replace('/%%doc.(\w+)%%/e', "common_local_url('doc', array('title'=>'\\1'))", $c);
1203     $c = preg_replace('/%%(\w+).(\w+)%%/e', 'common_config(\'\\1\', \'\\2\')', $c);
1204     return Markdown($c);
1205 }
1206
1207 function common_profile_uri($profile)
1208 {
1209     if (!$profile) {
1210         return null;
1211     }
1212     $user = User::staticGet($profile->id);
1213     if ($user) {
1214         return $user->uri;
1215     }
1216
1217     $remote = Remote_profile::staticGet($profile->id);
1218     if ($remote) {
1219         return $remote->uri;
1220     }
1221     // XXX: this is a very bad profile!
1222     return null;
1223 }
1224
1225 function common_canonical_sms($sms)
1226 {
1227     // strip non-digits
1228     preg_replace('/\D/', '', $sms);
1229     return $sms;
1230 }
1231
1232 function common_error_handler($errno, $errstr, $errfile, $errline, $errcontext)
1233 {
1234     switch ($errno) {
1235
1236      case E_ERROR:
1237      case E_COMPILE_ERROR:
1238      case E_CORE_ERROR:
1239      case E_USER_ERROR:
1240      case E_PARSE:
1241      case E_RECOVERABLE_ERROR:
1242         common_log(LOG_ERR, "[$errno] $errstr ($errfile:$errline) [ABORT]");
1243         die();
1244         break;
1245
1246      case E_WARNING:
1247      case E_COMPILE_WARNING:
1248      case E_CORE_WARNING:
1249      case E_USER_WARNING:
1250         common_log(LOG_WARNING, "[$errno] $errstr ($errfile:$errline)");
1251         break;
1252
1253      case E_NOTICE:
1254      case E_USER_NOTICE:
1255         common_log(LOG_NOTICE, "[$errno] $errstr ($errfile:$errline)");
1256         break;
1257
1258      case E_STRICT:
1259      case E_DEPRECATED:
1260      case E_USER_DEPRECATED:
1261         // XXX: config variable to log this stuff, too
1262         break;
1263
1264      default:
1265         common_log(LOG_ERR, "[$errno] $errstr ($errfile:$errline) [UNKNOWN LEVEL, die()'ing]");
1266         die();
1267         break;
1268     }
1269
1270     // FIXME: show error page if we're on the Web
1271     /* Don't execute PHP internal error handler */
1272     return true;
1273 }
1274
1275 function common_session_token()
1276 {
1277     common_ensure_session();
1278     if (!array_key_exists('token', $_SESSION)) {
1279         $_SESSION['token'] = common_good_rand(64);
1280     }
1281     return $_SESSION['token'];
1282 }
1283
1284 function common_cache_key($extra)
1285 {
1286     $base_key = common_config('memcached', 'base');
1287
1288     if (empty($base_key)) {
1289         $base_key = common_keyize(common_config('site', 'name'));
1290     }
1291
1292     return 'laconica:' . $base_key . ':' . $extra;
1293 }
1294
1295 function common_keyize($str)
1296 {
1297     $str = strtolower($str);
1298     $str = preg_replace('/\s/', '_', $str);
1299     return $str;
1300 }
1301
1302 function common_memcache()
1303 {
1304     static $cache = null;
1305     if (!common_config('memcached', 'enabled')) {
1306         return null;
1307     } else {
1308         if (!$cache) {
1309             $cache = new Memcache();
1310             $servers = common_config('memcached', 'server');
1311             if (is_array($servers)) {
1312                 foreach($servers as $server) {
1313                     $cache->addServer($server);
1314                 }
1315             } else {
1316                 $cache->addServer($servers);
1317             }
1318         }
1319         return $cache;
1320     }
1321 }
1322
1323 function common_compatible_license($from, $to)
1324 {
1325     // XXX: better compatibility check needed here!
1326     return ($from == $to);
1327 }
1328
1329 /**
1330  * returns a quoted table name, if required according to config
1331  */
1332 function common_database_tablename($tablename)
1333 {
1334
1335   if(common_config('db','quote_identifiers')) {
1336       $tablename = '"'. $tablename .'"';
1337   }
1338   //table prefixes could be added here later
1339   return $tablename;
1340 }
1341
1342 function common_shorten_url($long_url)
1343 {
1344     $user = common_current_user();
1345     if (empty($user)) {
1346         // common current user does not find a user when called from the XMPP daemon
1347         // therefore we'll set one here fix, so that XMPP given URLs may be shortened
1348         $svc = 'ur1.ca';
1349     } else {
1350         $svc = $user->urlshorteningservice;
1351     }
1352
1353     $curlh = curl_init();
1354     curl_setopt($curlh, CURLOPT_CONNECTTIMEOUT, 20); // # seconds to wait
1355     curl_setopt($curlh, CURLOPT_USERAGENT, 'Laconica');
1356     curl_setopt($curlh, CURLOPT_RETURNTRANSFER, true);
1357
1358     switch($svc) {
1359      case 'ur1.ca':
1360         require_once INSTALLDIR.'/lib/Shorturl_api.php';
1361         $short_url_service = new LilUrl;
1362         $short_url = $short_url_service->shorten($long_url);
1363         break;
1364
1365      case '2tu.us':
1366         $short_url_service = new TightUrl;
1367         require_once INSTALLDIR.'/lib/Shorturl_api.php';
1368         $short_url = $short_url_service->shorten($long_url);
1369         break;
1370
1371      case 'ptiturl.com':
1372         require_once INSTALLDIR.'/lib/Shorturl_api.php';
1373         $short_url_service = new PtitUrl;
1374         $short_url = $short_url_service->shorten($long_url);
1375         break;
1376
1377      case 'bit.ly':
1378         curl_setopt($curlh, CURLOPT_URL, 'http://bit.ly/api?method=shorten&long_url='.urlencode($long_url));
1379         $short_url = current(json_decode(curl_exec($curlh))->results)->hashUrl;
1380         break;
1381
1382      case 'is.gd':
1383         curl_setopt($curlh, CURLOPT_URL, 'http://is.gd/api.php?longurl='.urlencode($long_url));
1384         $short_url = curl_exec($curlh);
1385         break;
1386      case 'snipr.com':
1387         curl_setopt($curlh, CURLOPT_URL, 'http://snipr.com/site/snip?r=simple&link='.urlencode($long_url));
1388         $short_url = curl_exec($curlh);
1389         break;
1390      case 'metamark.net':
1391         curl_setopt($curlh, CURLOPT_URL, 'http://metamark.net/api/rest/simple?long_url='.urlencode($long_url));
1392         $short_url = curl_exec($curlh);
1393         break;
1394      case 'tinyurl.com':
1395         curl_setopt($curlh, CURLOPT_URL, 'http://tinyurl.com/api-create.php?url='.urlencode($long_url));
1396         $short_url = curl_exec($curlh);
1397         break;
1398      default:
1399         $short_url = false;
1400     }
1401
1402     curl_close($curlh);
1403
1404     return $short_url;
1405 }
1406
1407 function common_client_ip()
1408 {
1409     if (!isset($_SERVER) || !array_key_exists('REQUEST_METHOD', $_SERVER)) {
1410         return null;
1411     }
1412
1413     if ($_SERVER['HTTP_X_FORWARDED_FOR']) {
1414         if ($_SERVER['HTTP_CLIENT_IP']) {
1415             $proxy = $_SERVER['HTTP_CLIENT_IP'];
1416         } else {
1417             $proxy = $_SERVER['REMOTE_ADDR'];
1418         }
1419         $ip = $_SERVER['HTTP_X_FORWARDED_FOR'];
1420     } else {
1421         if ($_SERVER['HTTP_CLIENT_IP']) {
1422             $ip = $_SERVER['HTTP_CLIENT_IP'];
1423         } else {
1424             $ip = $_SERVER['REMOTE_ADDR'];
1425         }
1426     }
1427
1428     return array($ip, $proxy);
1429 }