Пользовательские запросы SQL для WordPress

C помощью пользовательских запросов вы сможете читать любые данные и/или манипулировать ими так, как хочется. Новый мир WordPress открывается перед вами.

 

Зачем использовать пользовательские запросы?

Базовый функционал WordPress великолепен и отлично подходит для решения простых задач. Но если нужно сделать что-то особенное? Будете писать плагин? Но можно использовать SQL запросы! Документация имеется в WordPress Codex (Custom Queries и WPDB class - на английском языке).

 

Класс wpdb

Глобальный класс WordPress - ключевой для использования запросов. В действительности, каждая функция использует данный класс.

 

query

Для функции query нужно передать строку, в которой содержится пользовательский запрос. Возвращаемое значение является целым числом, соответствующим количеству выбранных строк или логическое значение false в случае ошибки.

$query = "SELECT COUNT(apple) FROM fruits";
$wpdb->query($query);

 

get_results

Функция получает несколько строк после выполнения запроса. По умолчанию результатом является массивом.

$query = "
	SELECT *
	FROM wp_terms wt
	INNER JOIN wp_term_taxonomy wtt ON wt.term_id = wtt.term_id
	WHERE wtt.taxonomy = 'post_tag' AND wtt.count = 0";

$wpdb->get_results($query);

 

get_var

Возвращается одна перменная из базы данных, но полный результат запроса кешируется для дальнейшего использования. В случае, если ничего не найдено, возвращается NULL.

$query = "SELECT COUNT(*) FROM users";
$wpdb->get_var($query);

 

get_row

Полная строка возвращается в качестве результата, который может быть объектом, ассоциированным массивом или индексированным массивом. Если ничего не найдено, то возвращается NULL. Переменная result_type может иметь значение OBJECT, ARRAY_A или ARRAY_N (объект, ассоциированный массив или индексированный массив). Смещение является целым числом и по умолчанию имеет значение 0.

$query = "
SELECT * FROM wp_posts
WHERE post_type = 'post'";

$wpdb->get_row($query, ARRAY_A, 3);

 

get_col

Для того, чтобы получить столбец, нужно использовать данную функцию. Она возвращает массив. Если результат запроса отсутствует, то возвращается пустой массив. Второй параметр является смещением в столбце.

$query = "
SELECT * FROM wp_posts
WHERE post_type = 'post'";

$wpdb->get_col($query, 3);

 

Подготовленный запрос

Подготовленный запрос является шаблоном для запросов SQL, которые может выполнять приложение, модифицируя переменные.

Можно защищать SQL запросы от инъекций SQL. Данные из запросов должны быть извлечены из запроса перед его выполнением. В следующем примере значения ’10′, ‘monkey’ и ‘apple’ извлечены с помощью метода prepare.

// Использование: $wpdb->prepare( 'query' [, value_parameter, value_parameter ... ] );

$wpdb->query( $wpdb->prepare(
	"INSERT INTO test_table (post_id, animal, food) VALUES ( %d, %s, %s )",
	array(
		10,
		'monkey',
		'apple'
	)
));

 

Включаем/выключаем сообщения об ошибках

Сообщения об ошибках можно включать или выключать с помощью функций show_errors и hide_errors:

$wpdb->show_errors();
$wpdb->hide_errors();


 

Очистка кеша

Кеш очищается функцией flush.

 

Вставляем данные

$wpdb->insert($table, $data, $format);

$wpdb->insert(
	'foods',
	array(
		'fruit' => 'apple',
		'year' => 2012
	),
	array(
		'%s',
		'%d'
	)
);

Параметры в порядке использования:

  • название таблицы, в которую будут вставляться данные
  • данные для вставки (пары столбец => значение)
  • массив форматов, используемые для значений в массиве $data. Если данный параметр отсутствует, то все значения будут обрабатываться как сторки

 

Обновляем данные

$wpdb->update(
	'foods',
	array(
		'fruit' => 'apple',	// строка
		'year' =>  'value2'	// целое
	),
	array( 'ID' => 1 ),
	array(
		'%s',	// значение 1
		'%d'	// значение 2
	),
	array( '%d' )
);

Используемые параметры:

  • имя таблицы
  • данные
  • условие отбора
  • формат
  • формат условия отбора

 

Информация о столбцах

Можно получать информацию о столбцах. Когда функция возвращает значение OBJECT, то значит есть неизвестные опции.

$wpdb->get_col_info('тип', смещение);
  • Тип: информация, которая ожидается, некоторые значения:
    • name – имя столбца (значение по умолчанию)
    • table – имя таблицы, которой принадлежит столбец
    • max_length – максимальная длина столбца
    • not_null – 1, если столбец не может иметь значение NULL
    • остальные значения можно найти в кодексе WordPress
  • Смещение: указывается столбец (0 - первый столбец)

 

Cсылки на таблицы WordPress

Таблицы базы данных WordPress могут быть доступны в классе wpdb:

  • $wpdb->posts;
  • $wpdb->postmeta;
  • $wpdb->comments;
  • $wpdb->commentmeta;
  • $wpdb->terms;
  • $wpdb->term_taxonomy;
  • $wpdb->term_relationships;
  • $wpdb->users;
  • $wpdb->usermeta;
  • $wpdb->links;
  • $wpdb->options;

Обратите внимание на то, что не нужно использовать префикс, так как класс wpdb выполняет всю работу за нас.

Источник: http://feedproxy.google.com/~r/ruseller/CdHX/~3/Vt1odziYePk/lessons.php

Читать комменты и комментировать

Добавить комментарий / отзыв



Защитный код
Обновить

Пользовательские запросы SQL для WordPress | | 2012-06-19 11:57:41 | | Статьи Web-мастеру | | C помощью пользовательских запросов вы сможете читать любые данные и/или манипулировать ими так, как хочется. Новый мир WordPress открывается перед вами. Зачем использовать пользовательские запросы | РэдЛайн, создание сайта, заказать сайт, разработка сайтов, реклама в Интернете, продвижение, маркетинговые исследования, дизайн студия, веб дизайн, раскрутка сайта, создать сайт компании, сделать сайт, создание сайтов, изготовление сайта, обслуживание сайтов, изготовление сайтов, заказать интернет сайт, создать сайт, изготовить сайт, разработка сайта, web студия, создание веб сайта, поддержка сайта, сайт на заказ, сопровождение сайта, дизайн сайта, сайт под ключ, заказ сайта, реклама сайта, хостинг, регистрация доменов, хабаровск, краснодар, москва, комсомольск |
 
Поделиться с друзьями: