bootstrap.inc 11.3 KB
Newer Older
Dries's avatar
   
Dries committed
1
<?php
Dries's avatar
Dries committed
2
/* $Id$ */
Dries's avatar
   
Dries committed
3

Dries's avatar
   
Dries committed
4
5
6
7
/**
 * @file
 * Functions that need to be loaded on every Drupal request.
 */
Dries's avatar
   
Dries committed
8

Dries's avatar
   
Dries committed
9
10
11
12
13
14
15
16
/**
 * Locate the appropriate configuration file.
 *
 * Try finding a matching configuration file by stripping the website's
 * URI from left to right.  If no configuration file is found, return the
 * default value, "conf".
 */
function conf_init() {
17
  $uri = $_SERVER['PHP_SELF'];
Dries's avatar
   
Dries committed
18

19
  $file = strtolower(strtr($_SERVER['HTTP_HOST'] . substr($uri, 0, strrpos($uri, '/')), '/:', '..'));
Dries's avatar
   
Dries committed
20
21

  while (strlen($file) > 4) {
Dries's avatar
   
Dries committed
22
    if (file_exists('includes/'. $file .'.php')) {
Dries's avatar
   
Dries committed
23
24
25
      return $file;
    }
    else {
26
      $file = substr($file, strpos($file, '.') + 1);
Dries's avatar
   
Dries committed
27
28
29
    }
  }

30
  return 'conf';
Dries's avatar
   
Dries committed
31
32
}

Dries's avatar
   
Dries committed
33
34
35
36
37
38
39
/**
 * Load the persistent variable table.
 *
 * The variable table is composed of values that have been saved in the table
 * with variable_set() as well as those explicitly specified in the configuration
 * file.
 */
Dries's avatar
   
Dries committed
40
function variable_init($conf = array()) {
41
  $result = db_query('SELECT * FROM {variable} ');
Dries's avatar
   
Dries committed
42
43
44
45
46
47
48
49
50
  while ($variable = db_fetch_object($result)) {
    if (!isset($conf[$variable->name])) {
      $conf[$variable->name] = unserialize($variable->value);
    }
  }

  return $conf;
}

Dries's avatar
   
Dries committed
51
52
53
54
55
56
57
58
59
60
/**
 * Return a persistent variable.
 *
 * @param $name
 *   The name of the variable to return.
 * @param $default
 *   The default value to use if this variable has never been set.
 * @return
 *   The value of the variable.
 */
Dries's avatar
   
Dries committed
61
62
63
64
65
66
function variable_get($name, $default) {
  global $conf;

  return isset($conf[$name]) ? $conf[$name] : $default;
}

Dries's avatar
   
Dries committed
67
68
69
70
71
72
73
74
75
/**
 * Set a persistent variable.
 *
 * @param $name
 *   The name of the variable to set.
 * @param $value
 *   The value to set. This can be any PHP data type; these functions take care
 *   of serialization as necessary.
 */
Dries's avatar
   
Dries committed
76
77
78
79
80
81
82
83
84
function variable_set($name, $value) {
  global $conf;

  db_query("DELETE FROM {variable} WHERE name = '%s'", $name);
  db_query("INSERT INTO {variable} (name, value) VALUES ('%s', '%s')", $name, serialize($value));

  $conf[$name] = $value;
}

Dries's avatar
   
Dries committed
85
86
87
88
89
90
/**
 * Unset a persistent variable.
 *
 * @param $name
 *   The name of the variable to undefine.
 */
Dries's avatar
   
Dries committed
91
92
93
94
95
96
97
98
function variable_del($name) {
  global $conf;

  db_query("DELETE FROM {variable} WHERE name = '%s'", $name);

  unset($conf[$name]);
}

Dries's avatar
   
Dries committed
99
100
101
102
103
104
/**
 * Return data from the persistent cache.
 *
 * @param $key
 *   The cache ID of the data to retrieve.
 */
Dries's avatar
   
Dries committed
105
function cache_get($key) {
Dries's avatar
Dries committed
106
  $cache = db_fetch_object(db_query("SELECT data, created, headers FROM {cache} WHERE cid = '%s'", $key));
107
  return isset($cache->data) ? $cache : 0;
Dries's avatar
   
Dries committed
108
109
}

Dries's avatar
   
Dries committed
110
111
112
113
114
115
116
117
118
119
120
121
122
/**
 * Store data in the persistent cache.
 *
 * @param $cid
 *   The cache ID of the data to store.
 * @param $data
 *   The data to store in the cache. Complex data types must be serialized first.
 * @param $expire
 *   Whether the data should be removed from the cache when a cache expiration
 *   is triggered.
 * @param $headers
 *   A string containing HTTP header information for cached pages.
 */
Dries's avatar
Dries committed
123
function cache_set($cid, $data, $expire = 0, $headers = NULL) {
Dries's avatar
   
Dries committed
124
125
  $data = db_encode_blob($data);

126
  db_query("UPDATE {cache} SET data = '%s', created = %d, expire = %d, headers = '%s' WHERE cid = '%s'", $data, time(), $expire, $headers, $cid);
Dries's avatar
   
Dries committed
127
  if (!db_affected_rows()) {
128
   db_query("INSERT INTO {cache} (cid, data, created, expire, headers) VALUES('%s', '%s', %d, %d, '%s')", $cid, $data, time(), $expire, $headers);
Dries's avatar
   
Dries committed
129
 }
Dries's avatar
   
Dries committed
130
131
}

Dries's avatar
   
Dries committed
132
133
134
135
136
137
/**
 * Expire data from the cache.
 *
 * @param $cid
 *   If set, the cache ID to delete. Otherwise, all cache entries that can expire
 *   are deleted.
138
139
140
141
 *
 * @param $wildcard
 *   If set to true, the $cid is treated as a substring to match rather than a
 *   complete ID.
Dries's avatar
   
Dries committed
142
 */
143
function cache_clear_all($cid = NULL, $wildcard = false) {
Dries's avatar
   
Dries committed
144
145
146
147
  if (empty($cid)) {
    db_query("DELETE FROM {cache} WHERE expire <> 0");
  }
  else {
148
149
150
151
152
153
    if ($wildcard) {
      db_query("DELETE FROM {cache} WHERE cid LIKE '%%%s%%'", $cid);
    }
    else {
      db_query("DELETE FROM {cache} WHERE cid = '%s'", $cid);
    }
Dries's avatar
   
Dries committed
154
155
156
  }
}

Dries's avatar
   
Dries committed
157
158
159
/**
 * Store the current page in the cache.
 */
Dries's avatar
   
Dries committed
160
function page_set_cache() {
Dries's avatar
   
Dries committed
161
  global $user, $base_url;
Dries's avatar
   
Dries committed
162

163
164
  if (!$user->uid && $_SERVER['REQUEST_METHOD'] == 'GET') {
    // This will fail in some cases, see page_get_cache() for the explanation.
Dries's avatar
   
Dries committed
165
    if ($data = ob_get_contents()) {
Dries's avatar
   
Dries committed
166
167
168
169
170
171
172
173
      if (function_exists('gzencode')) {
        if (version_compare(phpversion(), '4.2', '>=')) {
          $data = gzencode($data, 9, FORCE_GZIP);
        }
        else {
          $data = gzencode($data, FORCE_GZIP);
        }
      }
Dries's avatar
   
Dries committed
174
      cache_set($base_url . request_uri(), $data, 1, drupal_get_headers());
Dries's avatar
   
Dries committed
175
176
177
178
    }
  }
}

Dries's avatar
   
Dries committed
179
180
181
182
183
184
185
186
/**
 * Retrieve the current page from the cache.
 *
 * Note, we do not serve cached pages when status messages are waiting (from
 * a redirected form submission which was completed).
 * Because the output handler is not activated, the resulting page will not
 * get cached either.
 */
Dries's avatar
   
Dries committed
187
function page_get_cache() {
Dries's avatar
   
Dries committed
188
  global $user, $base_url;
Dries's avatar
   
Dries committed
189
190

  $cache = NULL;
191

192
  if (!$user->uid && $_SERVER['REQUEST_METHOD'] == 'GET' && count(drupal_set_message()) == 0) {
Dries's avatar
   
Dries committed
193
    $cache = cache_get($base_url . request_uri());
Dries's avatar
   
Dries committed
194
195
196
197
198
199
200
201
202

    if (empty($cache)) {
      ob_start();
    }
  }

  return $cache;
}

Dries's avatar
   
Dries committed
203
204
205
/**
 * Set HTTP headers in preparation for a page response.
 */
Dries's avatar
   
Dries committed
206
function drupal_page_header() {
207
  if (variable_get('dev_timer', 0)) {
Dries's avatar
   
Dries committed
208
209
210
    timer_start();
  }

211
  if (variable_get('cache', 0)) {
Dries's avatar
   
Dries committed
212
213
214
    if ($cache = page_get_cache()) {

      // Set default values:
215
      $date = gmdate('D, d M Y H:i:s', $cache->created) .' GMT';
Dries's avatar
   
Dries committed
216
217
218
      $etag = '"'. md5($date) .'"';

      // Check http headers:
219
220
      $modified_since = isset($_SERVER['HTTP_IF_MODIFIED_SINCE']) ? $_SERVER['HTTP_IF_MODIFIED_SINCE'] == $date : NULL;
      if (!empty($_SERVER['HTTP_IF_MODIFIED_SINCE']) && ($timestamp = strtotime($_SERVER['HTTP_IF_MODIFIED_SINCE'])) != -1) {
Dries's avatar
Dries committed
221
222
223
224
225
        $modified_since = $cache->created <= $timestamp;
      }
      else {
        $modified_since = NULL;
      }
226
      $none_match = !empty($_SERVER['HTTP_IF_NONE_MATCH']) ? $_SERVER['HTTP_IF_NONE_MATCH'] == $etag : NULL;
Dries's avatar
   
Dries committed
227
228
229

      // The type checking here is very important, be careful when changing entries.
      if (($modified_since !== NULL || $none_match !== NULL) && $modified_since !== false && $none_match !== false) {
230
        header('HTTP/1.0 304 Not Modified');
Dries's avatar
   
Dries committed
231
232
233
234
235
236
        exit();
      }

      // Send appropriate response:
      header("Last-Modified: $date");
      header("ETag: $etag");
Dries's avatar
   
Dries committed
237

Dries's avatar
   
Dries committed
238
      // Determine if the browser accepts gzipped data.
Dries's avatar
   
Dries committed
239
      if (@strpos($_SERVER['HTTP_ACCEPT_ENCODING'], 'gzip') === false && function_exists('gzencode')) {
Dries's avatar
   
Dries committed
240
        // Strip the gzip header and run uncompress.
Dries's avatar
   
Dries committed
241
242
243
244
245
246
        $cache->data = gzinflate(substr(substr($cache->data, 10), 0, -8));
      }
      elseif (function_exists('gzencode')) {
        header('Content-Encoding: gzip');
      }

Dries's avatar
   
Dries committed
247
248
249
      // Send the original request's headers.  We send them one after
      // another so PHP's header() function can deal with duplicate
      // headers.
250
      $headers = explode("\n", $cache->headers);
Dries's avatar
   
Dries committed
251
252
253
254
      foreach ($headers as $header) {
        header($header);
      }

Dries's avatar
   
Dries committed
255
      print db_decode_blob($cache->data);
Dries's avatar
   
Dries committed
256

Dries's avatar
   
Dries committed
257
258
      // Call all init() and exit() hooks without including all modules.
      // Only use those hooks for critical operations.
Dries's avatar
   
Dries committed
259
260
      foreach (bootstrap_hooks() as $hook) {
        module_invoke_all($hook);
Dries's avatar
   
Dries committed
261
262
263
264
265
266
      }
      exit();
    }
  }
}

Dries's avatar
   
Dries committed
267
268
269
/**
 * Define the critical hooks that force modules to always be loaded.
 */
Dries's avatar
   
Dries committed
270
271
272
273
function bootstrap_hooks() {
  return array('init', 'exit');
}

Dries's avatar
   
Dries committed
274
275
276
277
278
279
280
281
/**
 * Unserializes and appends elements from a serialized string.
 *
 * @param $obj
 *   The object to which the elements are appended.
 * @param $field
 *   The attribute of $obj whose value should be unserialized.
 */
Dries's avatar
   
Dries committed
282
283
284
285
286
287
288
289
290
291
292
function drupal_unpack($obj, $field = 'data') {
  if ($obj->$field && $data = unserialize($obj->$field)) {
    foreach ($data as $key => $value) {
      if (!isset($obj->$key)) {
        $obj->$key = $value;
      }
    }
  }
  return $obj;
}

Dries's avatar
   
Dries committed
293
294
295
/**
 * Return the URI of the referring page.
 */
Dries's avatar
   
Dries committed
296
function referer_uri() {
297
298
  if (isset($_SERVER['HTTP_REFERER'])) {
    return check_url($_SERVER['HTTP_REFERER']);
Dries's avatar
   
Dries committed
299
300
301
  }
}

Dries's avatar
   
Dries committed
302
303
304
305
306
307
308
309
310
311
312
/**
 * Return a component of the current Drupal path.
 *
 * When viewing a page at the path "admin/node/configure", for example, arg(0)
 * would return "admin", arg(1) would return "node", and arg(2) would return
 * "configure".
 *
 * Avoid use of this function where possible, as resulting code is hard to read.
 * Instead, attempt to use named arguments in menu callback functions. See the
 * explanation in menu.inc for how to construct callbacks that take arguments.
 */
Dries's avatar
   
Dries committed
313
function arg($index) {
Dries's avatar
   
Dries committed
314
  static $arguments, $q;
Dries's avatar
   
Dries committed
315

316
317
  if (empty($arguments) || $q != $_GET['q']) {
    $arguments = explode('/', $_GET['q']);
Dries's avatar
   
Dries committed
318
319
  }

Dries's avatar
   
Dries committed
320
321
322
  if (array_key_exists($index, $arguments)) {
    return $arguments[$index];
  }
Dries's avatar
   
Dries committed
323
324
}

Dries's avatar
   
Dries committed
325
326
327
/**
 * Prepare user input for use in a database query, preventing SQL injection attacks.
 */
Dries's avatar
   
Dries committed
328
329
330
331
function check_query($text) {
  return addslashes($text);
}

Dries's avatar
   
Dries committed
332
333
334
335
336
/**
 * Prepare user input for use in a URI.
 *
 * We replace ( and ) with their entity equivalents to prevent XSS attacks.
 */
Dries's avatar
   
Dries committed
337
338
339
function check_url($uri) {
  $uri = htmlspecialchars($uri, ENT_QUOTES);

340
  $uri = strtr($uri, array('(' => '&040;', ')' => '&041;'));
Dries's avatar
   
Dries committed
341
342
343
344

  return $uri;
}

Dries's avatar
   
Dries committed
345
346
347
348
/**
 * Since request_uri() is only available on Apache, we generate an
 * equivalent using other environment vars.
 */
Dries's avatar
   
Dries committed
349
350
function request_uri() {

351
352
  if (isset($_SERVER['REQUEST_URI'])) {
    $uri = $_SERVER['REQUEST_URI'];
Dries's avatar
   
Dries committed
353
354
  }
  else {
355
    $uri = $_SERVER['PHP_SELF'] .'?'. $_SERVER['argv'][0];
Dries's avatar
   
Dries committed
356
357
358
359
  }

  return check_url($uri);
}
Dries's avatar
Dries committed
360

Dries's avatar
   
Dries committed
361
362
363
/**
 * Begin a global timer, for benchmarking of page execution time.
 */
Dries's avatar
   
Dries committed
364
365
function timer_start() {
  global $timer;
Dries's avatar
   
Dries committed
366
  list($usec, $sec) = explode(' ', microtime());
Dries's avatar
   
Dries committed
367
368
369
  $timer = (float)$usec + (float)$sec;
}

Dries's avatar
   
Dries committed
370
371
372
373
374
375
376
377
378
379
/**
 * Log a system message.
 *
 * @param $type
 *   The category to which this message belongs.
 * @param $message
 *   The message to store in the log.
 * @param $link
 *   A link to associate with the message.
 */
Dries's avatar
   
Dries committed
380
381
function watchdog($type, $message, $link = NULL) {
  global $user;
Kjartan's avatar
Kjartan committed
382
  db_query("INSERT INTO {watchdog} (uid, type, message, link, location, hostname, timestamp) VALUES (%d, '%s', '%s', '%s', '%s', '%s', %d)", $user->uid, $type, $message, $link, request_uri(), $_SERVER['REMOTE_ADDR'], time());
Dries's avatar
   
Dries committed
383
384
}

385
386
387
388
389
390
/**
 * @name Page messages
 *
 * Functions to get and set the message of the current page.
 * @{
 */
Dries's avatar
   
Dries committed
391
392
393
394
395
396
397
398
399
400

/**
 * Set a message for the user to see.
 *
 * The message is stored in the session so that it can persist through a redirect.
 *
 * If called with no arguments, this function returns all set messages without
 * clearing them.
 */
function drupal_set_message($message = NULL, $type = 'status') {
401
  if (isset($message)) {
Dries's avatar
   
Dries committed
402
403
404
405
406
407
408
409
410
    if (!isset($_SESSION['messages'])) {
      $_SESSION['messages'] = array();
    }

    if (!isset($_SESSION['messages'][$type])) {
      $_SESSION['messages'][$type] = array();
    }

    $_SESSION['messages'][$type][] = $message;
411
412
413
414
415
  }

  return $_SESSION['messages'];
}

Dries's avatar
   
Dries committed
416
417
418
419
420
/**
 * Return all messages that have been set.
 *
 * As a side effect, this function clears the message queue.
 */
421
422
423
424
425
426
427
428
429
function drupal_get_messages() {
  $messages = drupal_set_message();
  $_SESSION['messages'] = array();

  return $messages;
}

/* @} */

Dries's avatar
   
Dries committed
430
431
432
433
unset($conf);
$config = conf_init();

include_once "includes/$config.php";
434
435
436
include_once 'includes/database.inc';
include_once 'includes/session.inc';
include_once 'includes/module.inc';
Dries's avatar
   
Dries committed
437

Dries's avatar
   
Dries committed
438
// Initialize configuration variables, using values from conf.php if available.
Dries's avatar
   
Dries committed
439
440
$conf = variable_init(isset($conf) ? $conf : array());
?>