pager_query

Хочешь помочь с переводом? Это очень просто и быстро. Лишь зарегистрируйся, и можешь тут же начать переводить.

includes/pager.inc, строка 50

Версии
5 – 6
pager_query($query, $limit = 10, $element = 0, $count_query = NULL)

Выполняет «постраничный» запрос к базе данных.

Используйте эту функцию, когда результирующие данные надо будет представить постранично. Функция использует SQL-конструкцию 'LIMIT', чтобы получать только те данные, которые нужны для отображения текущей страницы. Тем не менее, она должна получить общее количество записей, возвращаемых запросом, чтобы вычислить количество страниц (кол-во_записей / записей_на_страницу). Это реализуется вставкой 'COUNT(*)' в начальный запрос. Например, запрос 'SELECT nid, type FROM node WHERE status = 1 ORDER BY sticky DESC, created DESC' будет превращен в 'SELECT COUNT(*) FROM node WHERE status = 1 ORDER BY sticky DESC, created DESC'.

К сожалению, превращение запроса не всегда работает для запросов которые уже имеют 'COUNT(*)' или 'GROUP BY', и, возможно, для некоторых других сложных запросов. В этом случае, вы, по желанию, можете предоставить запрос, который будет использован для подсчета количества записей.

Например, если вы хотите разбить постранично запрос 'SELECT COUNT(*), type FROM node GROUP BY type', pager_query() запустит неправильный запрос 'SELECT COUNT(*) FROM node GROUP BY type'. Посему, вместо этого, вы должны передать 'SELECT COUNT(DISTINCT(TYPE)) FROM node' в $count_query аргумент функции.

Параметры

$query SQL запрос.

$limit Количество результатов на страницу.

$element (опционально) Целое число для идентификации листалки (если их несколько на странице).

$count_query SQL запрос количества элементов.

... Переменное количество аргуметов, Переменное количество аргументов, которые подставляются в запрос по типу printf(). Вместо переменного количества аргументов, можно использовать один массив, содержащий необходимые аргументы.

Возвращаемое значение

Результирующий ресурс запроса или FALSE, если запрос вызвал ошибку.

Связанные темы

▾ 27 функции вызывают pager_query()

aggregator_page_list in modules/aggregator/aggregator.module
blog_page_last in modules/blog/blog.module
Коллбэк меню. Показывает страницу Друпал с последними записями в блогах пользователей.
blog_page_user in modules/blog/blog.module
Показывает страницу Друпал с последними записями в блоге данного пользователя.
comment_admin_overview in modules/comment/comment.module
Конструктор формы; генерирует форму с кратким содержанием комментариев для администратора.
comment_render in modules/comment/comment.module
Отображает комментарии.
do_search in modules/search/search.module
Do a query on the full-text search index for a word or words.
forum_get_topics in modules/forum/forum.module
node_admin_nodes in modules/node/node.module
node_page_default in modules/node/node.module
Menu callback; Generate a listing of promoted nodes.
path_overview in modules/path/path.module
Return a listing of all defined URL aliases.
poll_page in modules/poll/poll.module
poll_votes in modules/poll/poll.module
Callback for the 'votes' tab for polls you can see other votes on
profile_browse in modules/profile/profile.module
Menu callback; display a list of user information.
statistics_node_tracker in modules/statistics/statistics.module
statistics_recent_hits in modules/statistics/statistics.module
Menu callback; presents the 'recent hits' page.
statistics_top_pages in modules/statistics/statistics.module
Menu callback; presents the 'top pages' page.
statistics_top_referrers in modules/statistics/statistics.module
Menu callback; presents the 'referrer' page.
statistics_top_visitors in modules/statistics/statistics.module
Menu callback; presents the 'top visitors' page.
statistics_user_tracker in modules/statistics/statistics.module
taxonomy_overview_terms in modules/taxonomy/taxonomy.module
Display a tree of all the terms in a vocabulary, with options to edit each one.
taxonomy_select_nodes in modules/taxonomy/taxonomy.module
Находит все ноды, которые соответствуют выбранным условиям таксономии.
tracker_page in modules/tracker/tracker.module
Menu callback. Prints a listing of active nodes on the site.
user_admin_account in modules/user/user.module
user_search in modules/user/user.module
Реализация hook_search().
watchdog_overview in modules/watchdog/watchdog.module
Menu callback; displays a listing of log messages.
watchdog_top in modules/watchdog/watchdog.module
Menu callback; generic function to display a page of the most frequent watchdog events of a specified type.
_locale_string_seek in includes/locale.inc
Perform a string search and display results in a table

Код

<?php
function pager_query($query, $limit = 10, $element = 0, $count_query = NULL) {
  global $pager_page_array, $pager_total, $pager_total_items;
  $page = isset($_GET['page']) ? $_GET['page'] : '';

  // Substitute in query arguments.
  $args = func_get_args();
  $args = array_slice($args, 4);
  // Alternative syntax for '...'
  if (isset($args[0]) && is_array($args[0])) {
    $args = $args[0];
  }

  // Construct a count query if none was given.
  if (!isset($count_query)) {
    $count_query = preg_replace(array('/SELECT.*?FROM /As', '/ORDER BY .*/'), array('SELECT COUNT(*) FROM ', ''), $query);
  }

  // Convert comma-separated $page to an array, used by other functions.
  $pager_page_array = explode(',', $page);

  // We calculate the total of pages as ceil(items / limit).
  $pager_total_items[$element] = db_result(db_query($count_query, $args));
  $pager_total[$element] = ceil($pager_total_items[$element] / $limit);
  $pager_page_array[$element] = max(0, min((int)$pager_page_array[$element], ((int)$pager_total[$element]) - 1));
  return db_query_range($query, $args, $pager_page_array[$element] * $limit, $limit);
}
?>
Войдите или зарегистрируйтесь, чтобы получить возможность отправлять комментарии

Вход в систему