Implementation of hook_schema().

Generate the current version of the database schema from the sequence of schema update functions. Uses a similar method to install.inc's drupal_get_schema_versions() to establish the update sequence.

To change the schema, add a new views_schema_N() function to match the associated views_update_N()

Parameters

$caller_function: The name of the function that called us. Used internally, if requesting a specific schema version.

File

./views.install, line 42

views.install Contains install and update functions for Views.

Code

function views_schema($caller_function = FALSE) {
  static $get_current;
  static $schemas = array();

  // If called with no arguments, get the latest version of the schema.
  if (!isset($get_current)) {
    $get_current = $caller_function ? FALSE : TRUE;
  }

  // Generate a sorted list of available schema update functions.
  if ($get_current || empty($schemas)) {
    $get_current = FALSE;
    $functions = get_defined_functions();
    foreach ($functions['user'] as $function) {
      if (strpos($function, 'views_schema_') === 0) {
        $version = substr($function, strlen('views_schema_'));
        if (is_numeric($version)) {
          $schemas[] = $version;
        }
      }
    }
    if ($schemas) {
      sort($schemas, SORT_NUMERIC);

      // If a specific version was requested, drop any later
      // updates from the sequence.
      if ($caller_function) {
        do {
          $schema = array_pop($schemas);
        } while ($schemas && $caller_function != 'views_schema_' . $schema);
      }
    }
  }

  // Call views_schema_<n>, for the highest available <n>.
  if ($schema = array_pop($schemas)) {
    $function = 'views_schema_' . $schema;
    return $function();
  }

  return array();
}