wpdb

Методы

add_placeholder_escape()

Метод add_placeholder_escape() класса wpdb добавляет строку-экранирование заполнителя, чтобы экранировать все, что похоже на заполнитель функции printf().

wpdb::add_placeholder_escape( string $query ): string

Метод add_placeholder_escape() принимает один обязательный параметр:

• $query (string) — Запрос, который нужно экранировать.

$query (string) — Обязательный. Запрос, который нужно экранировать.

Метод add_placeholder_escape() возвращает запрос с вставленной строкой-экранированием заполнителя, где это необходимо.

<?php
$query = "SELECT * FROM wp_posts WHERE post_title = %s AND post_status = %s";
$escaped_query = $wpdb->add_placeholder_escape( $query );
?>

В приведенном выше примере кода переменная $query содержит запрос, в котором присутствуют заполнители %s. Метод add_placeholder_escape() применяется к переменной $wpdb для экранирования заполнителей в запросе. Результат сохраняется в переменной $escaped_query.

bail()

Метод bail() класса wpdb используется для обработки ошибок и прекращения выполнения скрипта. Он оборачивает ошибки в красивый заголовок и подвал и завершает выполнение.

wpdb::bail( string $message, string $error_code = '500' ): void|false

Метод bail() принимает два параметра: $message (обязательный) и $error_code (необязательный). Он возвращает void (если отображение ошибок включено) или false (если отключено).

$message (string) — Обязательный. Сообщение об ошибке.

$error_code (string) — Необязательный. Строка, содержащая код ошибки для идентификации. По умолчанию ‘500’.

Метод bail() возвращает void, если отображение ошибок включено, или false, если отключено.

<code>$wpdb->bail( 'Ошибка базы данных', 'db_error' );</code>

В этом примере вызывается метод bail() объекта $wpdb с двумя параметрами: сообщением об ошибке «Ошибка базы данных» и кодом ошибки «db_error».

check_ascii()

Метод check_ascii() класса wpdb используется для проверки, является ли строка ASCII.

ASCII (American Standard Code for Information Interchange) — это стандартный набор символов, используемый для представления текстовой информации на компьютерах и других устройствах.

Метод проверяет, содержит ли строка только символы ASCII, и возвращает true, если это так, и false, если нет.

wpdb::check_ascii( string $input_string ): bool

Метод check_ascii() принимает один обязательный параметр:

• $input_string (string) — Строка, которую нужно проверить.

$input_string (string) — Обязательный. Строка, которую нужно проверить.

Метод check_ascii() возвращает true, если строка является ASCII, и false, если нет.

<?php
$input_string = "Hello, world!";
if ( $wpdb->check_ascii( $input_string ) ) {
    echo "The string is ASCII.";
} else {
    echo "The string is not ASCII.";
}
?>

В приведенном выше примере мы проверяем, является ли строка «Hello, world!» ASCII. Если строка является ASCII, выводится сообщение «The string is ASCII.». Если строка не является ASCII, выводится сообщение «The string is not ASCII.».

check_connection()

Метод check_connection() класса wpdb используется для проверки активности соединения с базой данных WordPress. Если соединение отсутствует, метод пытается восстановить его.

wpdb::check_connection( bool $allow_bail = true ): bool|void

Метод check_connection() принимает один необязательный параметр $allow_bail, который позволяет методу прекратить выполнение. По умолчанию значение параметра равно true.

$allow_bail bool (необязательный): Позволяет методу прекратить выполнение. По умолчанию: true.

Метод check_connection() возвращает true, если соединение активно.

<code>// Проверка соединения с базой данных
$result = $wpdb->check_connection();</code>

В приведенном примере кода метод check_connection() вызывается у объекта $wpdb для проверки активности соединения с базой данных.

check_database_version()

Метод check_database_version() класса wpdb используется для определения, достигла ли версия базы данных MySQL требуемой минимальной версии. Он проверяет текущую версию базы данных и сравнивает ее с минимальной версией, указанной в файле wp-includes/version.php. Если текущая версия базы данных ниже требуемой, метод генерирует ошибку.

wpdb::check_database_version(): void|WP_Error

Метод check_database_version() не принимает никаких аргументов. Он вызывается напрямую из объекта wpdb.

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

$wpdb = new wpdb( DB_USER, DB_PASSWORD, DB_NAME, DB_HOST );
$result = $wpdb->check_database_version();

Метод check_database_version() возвращает либо void, если версия базы данных достаточна, либо объект WP_Error, если версия недостаточна.

check_safe_collation()

Метод check_safe_collation() класса wpdb используется для проверки, является ли используемая в запросе сортировка безопасной для текущей версии MySQL. Он проверяет, соответствует ли сортировка требованиям безопасности, установленным в текущей версии MySQL.

wpdb::check_safe_collation( string $query ): bool

Метод check_safe_collation() принимает один параметр:

• $query (обязательный): Запрос, который нужно проверить.

$query string (обязательный): Запрос, который нужно проверить.

Метод check_safe_collation() возвращает значение типа bool. Если сортировка безопасна, возвращается true, в противном случае возвращается false.

<?php
// Проверяем безопасность сортировки в запросе
$query = "SELECT * FROM wp_posts ORDER BY post_title ASC";
$is_safe = $wpdb->check_safe_collation( $query );
if ( $is_safe ) {
    echo "Сортировка безопасна.";
} else {
    echo "Сортировка не безопасна.";
}
?>

close()

Метод close() класса wpdb используется для закрытия текущего соединения с базой данных WordPress.

Этот метод закрывает соединение с базой данных, которое было установлено с помощью метода connect() класса wpdb. После вызова метода close() дальнейшее взаимодействие с базой данных становится невозможным.

wpdb::close()

Этот код используется для закрытия текущего соединения с базой данных WordPress.

Обратите внимание, что метод close() не принимает никаких аргументов.

Метод close() возвращает значение типа bool. Если соединение с базой данных было успешно закрыто, метод возвращает true. Если соединение не было закрыто (например, если соединение не существует), метод возвращает false.

db_connect()

Метод db_connect() класса wpdb используется для подключения к базе данных WordPress и выбора базы данных.

wpdb::db_connect( bool $allow_bail = true ): bool

Метод db_connect() принимает один необязательный параметр $allow_bail, который позволяет функции прекратить выполнение в случае ошибки. По умолчанию значение параметра равно true.

$allow_bail bool (необязательный): Позволяет функции прекратить выполнение. Значение по умолчанию: true.

Метод db_connect() возвращает true в случае успешного подключения к базе данных и false в случае ошибки.

<?php
// Подключение к базе данных
$result = $wpdb->db_connect();
if ($result) {
    echo 'Подключение к базе данных успешно.';
} else {
    echo 'Ошибка подключения к базе данных.';
}
?>

В приведенном выше примере кода мы используем метод db_connect() для подключения к базе данных WordPress. Затем мы проверяем результат подключения и выводим соответствующее сообщение.

db_server_info()

Метод db_server_info() класса wpdb используется для получения полной информации о сервере базы данных. Он возвращает информацию о версии сервера, типе базы данных, имени базы данных и других параметрах.

wpdb::db_server_info(): string|false

Метод db_server_info() вызывается на объекте класса wpdb. Он возвращает строку с информацией о сервере базы данных или false в случае ошибки.

Метод db_server_info() возвращает строку с информацией о сервере базы данных в случае успешного выполнения или false в случае ошибки.

db_version()

Метод db_version() класса wpdb используется для получения версии сервера базы данных. Он возвращает номер версии базы данных, на которой работает WordPress.

wpdb::db_version()

Метод db_version() вызывается без передачи аргументов.

Метод db_version() возвращает строку (string) с номером версии базы данных в случае успеха и null в случае ошибки.

delete()

Метод delete() класса wpdb используется для удаления строки из таблицы в базе данных WordPress.

wpdb::delete( string $table, array $where, array|string $where_format = null ): int|false

Метод delete() принимает три параметра: $table, $where и $where_format. Он возвращает количество удаленных строк или false в случае ошибки.

$table (string) — Обязательный. Название таблицы.

$where (array) — Обязательный. Ассоциативный массив с условиями WHERE (в виде пар столбец => значение). Множественные условия будут объединены с помощью оператора AND. Как столбцы, так и значения в $where должны быть «сырыми» (неэкранированными). Отправка значения null создаст сравнение IS NULL — соответствующий формат будет проигнорирован в этом случае.

$where_format (array|string) — Необязательный. Массив форматов, которые будут применены к каждому значению в $where. Если строка, то этот формат будет использован для всех элементов в $where. Формат может быть одним из ‘%d’, ‘%f’, ‘%s’ (целое число, число с плавающей запятой, строка). Если параметр опущен, все значения в $where будут рассматриваться как строки, если не указано иное в wpdb::$field_types. По умолчанию: null.

Метод delete() возвращает количество удаленных строк или false в случае ошибки.

<?php
// Удаление строки из таблицы 'wp_posts', где 'ID' равно 10
$result = $wpdb->delete( 'wp_posts', array( 'ID' => 10 ) );
if ( $result === false ) {
    echo 'Ошибка при удалении строки.';
} else {
    echo 'Удалено строк: ' . $result;
}
?>

В этом примере мы используем метод delete() для удаления строки из таблицы ‘wp_posts’, где значение столбца ‘ID’ равно 10. Результатом выполнения метода будет количество удаленных строк, которое мы выводим на экран. Если произошла ошибка при удалении строки, будет выведено сообщение об ошибке.

determine_charset()

Метод determine_charset() класса wpdb используется для определения наиболее подходящего набора символов и сортировки (charset и collation) на основе заданных значений charset и collation.

wpdb::determine_charset( string $charset, string $collate ): array

Метод determine_charset() принимает два обязательных параметра: $charset (набор символов) и $collate (сортировка). Он возвращает массив, содержащий наиболее подходящий набор символов и сортировку для использования.

$charset (string) — Обязательный. Набор символов, который нужно проверить.

$collate (string) — Обязательный. Сортировка, которую нужно проверить.

Метод determine_charset() возвращает массив, содержащий наиболее подходящий набор символов и сортировку для использования.

<?php
// Задаем значения charset и collation
$charset = 'utf8';
$collate = 'utf8_general_ci';
// Вызываем метод determine_charset()
$result = $wpdb->determine_charset( $charset, $collate );
// Выводим результат
var_dump( $result );
?>

В этом примере мы задаем значения charset и collation, а затем вызываем метод determine_charset() для определения наиболее подходящего набора символов и сортировки. Результат выводится с помощью функции var_dump().

escape()

Метод escape() класса wpdb используется для экранирования данных перед их использованием в SQL-запросах. Он предназначен для предотвращения SQL-инъекций и обеспечения безопасности данных.

wpdb::escape( string|array $data ): string|array

Метод escape() принимает один обязательный параметр $data, который может быть строкой или массивом данных, которые требуется экранировать.

$data (string|array) — Обязательный. Данные, которые требуется экранировать.

Метод escape() возвращает экранированные данные в том же типе, в котором они были переданы.

<?php
$data = "It's a sample data";
$escaped_data = $wpdb->escape( $data );
?>

В приведенном выше примере переменная $data содержит строку данных, которую требуется экранировать. Метод escape() вызывается на объекте $wpdb и передается переменная $data в качестве аргумента. Результат экранирования сохраняется в переменной $escaped_data.

escape_by_ref()

Метод escape_by_ref() класса wpdb используется для экранирования содержимого перед его вставкой в базу данных WordPress. Это делается для обеспечения безопасности данных и предотвращения SQL-инъекций.

wpdb::escape_by_ref( string $data )

Метод escape_by_ref() принимает один обязательный параметр:

• $data (строка, обязательный) — Строка, которую необходимо экранировать.

Метод escape_by_ref() принимает следующие параметры:

• $data (строка, обязательный) — Строка, которую необходимо экранировать. Это обязательный параметр.

<?php
$data = "Some data to be escaped";
$escaped_data = $wpdb->escape_by_ref( $data );
?>

В приведенном выше примере переменная $data содержит данные, которые необходимо экранировать. Метод escape_by_ref() вызывается на объекте $wpdb и передается переменная $data в качестве аргумента. Результат экранирования сохраняется в переменной $escaped_data.

esc_like()

Метод esc_like() класса wpdb используется для экранирования текста, который будет использоваться в выражении LIKE в SQL-запросе. Он применяет половину экранирования для специальных символов % и _ перед подготовкой к выполнению SQL-запроса.

wpdb::esc_like( string $text ): string

Метод esc_like() принимает один обязательный параметр $text, который представляет собой необработанный текст, который нужно экранировать. Входные данные, введенные пользователем, не должны содержать дополнительных или удаленных слешей.

$text (string) — Обязательный. Необработанный текст, который нужно экранировать. Входные данные, введенные пользователем, не должны содержать дополнительных или удаленных слешей.

Метод esc_like() возвращает текст в форме фразы LIKE. Полученный результат не является безопасным для SQL. Для безопасного использования следует вызвать метод wpdb::prepare() или wpdb::_real_escape().

<?php
$text = "example_text";
$escaped_text = $wpdb->esc_like( $text );
?>

В приведенном выше примере кода переменная $text содержит необработанный текст, который нужно экранировать. Метод esc_like() вызывается на объекте $wpdb и принимает $text в качестве параметра. Результат экранирования сохраняется в переменной $escaped_text.

flush()

Метод flush() класса wpdb в WordPress используется для удаления кэшированных результатов запросов. Кэширование результатов запросов позволяет ускорить выполнение повторных запросов к базе данных, но иногда может потребоваться очистить кэш для обновления данных или избежания некорректных результатов.

Метод flush() удаляет все кэшированные результаты запросов, что означает, что при следующем запросе к базе данных будут получены свежие данные. Это особенно полезно, когда вы вносите изменения в базу данных или обновляете содержимое сайта.

wpdb::flush();

Вызов метода flush() осуществляется через класс wpdb без создания экземпляра класса. Метод не принимает никаких аргументов.

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

get_blog_prefix()

Метод get_blog_prefix() класса wpdb возвращает префикс таблицы для указанного блога в WordPress. Префикс таблицы — это строка, которая добавляется перед именем таблицы в базе данных WordPress. Метод используется для получения префикса таблицы для определенного блога.

wpdb::get_blog_prefix( int $blog_id = null ): string

Метод get_blog_prefix() принимает один необязательный параметр $blog_id, который указывает идентификатор блога, для которого нужно получить префикс таблицы. Если параметр не указан, будет использован идентификатор текущего блога. Метод возвращает строку — префикс таблицы для указанного блога.

$blog_id (int) — Необязательный идентификатор блога, для которого нужно получить префикс таблицы. По умолчанию используется идентификатор текущего блога.

Метод get_blog_prefix() возвращает строку — префикс таблицы для указанного блога.

<code>$wpdb = new wpdb('username', 'password', 'database', 'localhost');
$prefix = $wpdb->get_blog_prefix(2);</code>

В приведенном выше примере кода создается новый объект класса wpdb с указанием имени пользователя, пароля, имени базы данных и хоста. Затем вызывается метод get_blog_prefix() с параметром 2, чтобы получить префикс таблицы для блога с идентификатором 2. Результат сохраняется в переменную $prefix.

get_caller()

Метод get_caller() класса wpdb возвращает список имен функций, которые вызвали wpdb. Он извлекает эту информацию из стека вызовов PHP.

wpdb::get_caller(): string

Метод get_caller() возвращает строку, содержащую имена функций, разделенные запятыми, которые вызвали wpdb.

Метод get_caller() возвращает строку, содержащую имена функций, разделенные запятыми, которые вызвали wpdb.

get_charset_collate()

Метод get_charset_collate() класса wpdb возвращает кодировку и сравнение символов базы данных WordPress.

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

wpdb::get_charset_collate(): string

Метод get_charset_collate() вызывается статически, без создания экземпляра класса wpdb. Он не принимает никаких аргументов.

Этот метод возвращает строку, содержащую информацию о кодировке и сравнении символов базы данных WordPress.

Метод get_charset_collate() возвращает строку, содержащую информацию о кодировке и сравнении символов базы данных WordPress.

get_col()

Метод get_col() класса wpdb используется для извлечения одной колонки из базы данных WordPress. Он позволяет выполнить произвольный SQL-запрос и вернуть результат в виде массива значений из указанной колонки.

wpdb::get_col( string|null $query = null, int $x ): array

Метод get_col() принимает два параметра: $query и $x.

$query (строка или null) — необязательный параметр, содержащий SQL-запрос. По умолчанию равен предыдущему запросу.

$x (целое число) — необязательный параметр, указывающий номер колонки, которую нужно вернуть. Индексация начинается с 0. По умолчанию равен 0.

$query (строка|null) — Необязательный SQL-запрос. По умолчанию равен предыдущему запросу. Если указано значение null, будет использован предыдущий запрос.

$x (целое число) — Необязательный номер колонки, которую нужно вернуть. Индексация начинается с 0. По умолчанию равен 0.

Метод get_col() возвращает результат запроса в виде массива значений из указанной колонки. Индексация массива начинается с 0, соответствует номеру строки в результирующем наборе данных.

<?php
// Получение всех идентификаторов пользователей из таблицы wp_users
$users = $wpdb->get_col( 'SELECT ID FROM wp_users' );
// Получение всех названий категорий из таблицы wp_terms
$categories = $wpdb->get_col( 'SELECT name FROM wp_terms', 1 );
// Получение всех заголовков постов из таблицы wp_posts
$titles = $wpdb->get_col( 'SELECT post_title FROM wp_posts', 2 );
?>

В этом примере мы используем метод get_col() для извлечения определенных колонок из базы данных WordPress. В первом запросе мы получаем все идентификаторы пользователей из таблицы wp_users. Во втором запросе мы получаем все названия категорий из таблицы wp_terms и указываем, что нужно вернуть вторую колонку. В третьем запросе мы получаем все заголовки постов из таблицы wp_posts и указываем, что нужно вернуть третью колонку.

get_col_charset()

Метод get_col_charset() класса wpdb используется для получения набора символов (character set) для указанной колонки в таблице базы данных WordPress.

wpdb::get_col_charset( string $table, string $column ): string|false|WP_Error

Метод get_col_charset() принимает два обязательных параметра:

• $table (строка) — Название таблицы.
• $column (строка) — Название колонки.

Метод возвращает набор символов колонки в виде строки. Если колонка не имеет набора символов, метод возвращает false. В случае ошибки возвращается объект WP_Error.

<?php
// Получение набора символов для колонки 'post_title' в таблице 'wp_posts'
$charset = $wpdb->get_col_charset( 'wp_posts', 'post_title' );
if ( $charset ) {
    echo 'Набор символов для колонки: ' . $charset;
} else {
    echo 'Колонка не имеет набора символов.';
}
?>

В данном примере мы получаем набор символов для колонки ‘post_title’ в таблице ‘wp_posts’. Если набор символов существует, выводится сообщение с набором символов. Если колонка не имеет набора символов, выводится сообщение об этом.

get_col_info()

Метод get_col_info() класса wpdb используется для получения метаданных столбцов из последнего запроса. Он возвращает информацию о столбцах, такую как имя, таблица, определение, максимальная длина, наличие значения NULL, является ли столбец первичным ключом, является ли столбец уникальным ключом, является ли столбец числовым, является ли столбец типом BLOB, тип столбца, является ли столбец беззнаковым и заполненным нулями.

wpdb::get_col_info( string $info_type = 'name', int $col_offset = -1 ): mixed

Метод get_col_info() принимает два параметра:

• $info_type (строка, необязательный) — Возможные значения: ‘name’, ‘table’, ‘def’, ‘max_length’, ‘not_null’, ‘primary_key’, ‘multiple_key’, ‘unique_key’, ‘numeric’, ‘blob’, ‘type’, ‘unsigned’, ‘zerofill’. По умолчанию ‘name’.
• $col_offset (целое число, необязательный) — 0: имя столбца, 1: таблица, в которой находится столбец, 2: максимальная длина столбца, 3: является ли столбец числовым, 4: тип столбца. По умолчанию -1.

$info_type (строка, необязательный) — Определяет, какую информацию о столбце нужно получить. Возможные значения: ‘name’, ‘table’, ‘def’, ‘max_length’, ‘not_null’, ‘primary_key’, ‘multiple_key’, ‘unique_key’, ‘numeric’, ‘blob’, ‘type’, ‘unsigned’, ‘zerofill’. По умолчанию ‘name’.

$col_offset (целое число, необязательный) — Определяет, какую информацию о столбце нужно получить. Возможные значения: 0: имя столбца, 1: таблица, в которой находится столбец, 2: максимальная длина столбца, 3: является ли столбец числовым, 4: тип столбца. По умолчанию -1.

Метод get_col_info() возвращает результаты столбца в виде массива.

/**
 * Пример использования метода get_col_info()
 */
// Создаем экземпляр класса wpdb
$wpdb = new wpdb('username', 'password', 'database', 'localhost');
// Выполняем запрос к базе данных
$results = $wpdb->get_results("SELECT * FROM wp_posts");
// Получаем метаданные столбцов из последнего запроса
$col_info = $wpdb->get_col_info();
// Выводим информацию о столбцах
foreach ($col_info as $col) {
    echo 'Имя столбца: ' . $col->name . '<br>';
    echo 'Таблица: ' . $col->table . '<br>';
    echo 'Определение: ' . $col->def . '<br>';
    echo 'Максимальная длина: ' . $col->max_length . '<br>';
    echo 'Наличие значения NULL: ' . $col->not_null . '<br>';
    echo 'Является ли столбец первичным ключом: ' . $col->primary_key . '<br>';
    echo 'Является ли столбец уникальным ключом: ' . $col->unique_key . '<br>';
    echo 'Является ли столбец числовым: ' . $col->numeric . '<br>';
    echo 'Является ли столбец типом BLOB: ' . $col->blob . '<br>';
    echo 'Тип столбца: ' . $col->type . '<br>';
    echo 'Является ли столбец беззнаковым: ' . $col->unsigned . '<br>';
    echo 'Заполнен ли столбец нулями: ' . $col->zerofill . '<br>';
    echo '<br>';
}

get_col_length()

Метод get_col_length() класса wpdb используется для получения максимальной длины строки, разрешенной в заданном столбце таблицы в базе данных WordPress.

Этот метод возвращает информацию о длине столбца в виде массива. Если столбец не имеет ограничения на длину (например, числовой столбец), метод вернет значение false. Если произошла ошибка, будет возвращен объект WP_Error.

wpdb::get_col_length( string $table, string $column )

Метод get_col_length() принимает два обязательных параметра:

• $table (строка) — Название таблицы.
• $column (строка) — Название столбца.

Метод get_col_length() принимает следующие параметры:

• $table (обязательный) — Название таблицы. Это строка, содержащая имя таблицы в базе данных WordPress.
• $column (обязательный) — Название столбца. Это строка, содержащая имя столбца в таблице.

Метод get_col_length() возвращает информацию о длине столбца в виде массива. Если столбец не имеет ограничения на длину (например, числовой столбец), метод вернет значение false. Если произошла ошибка, будет возвращен объект WP_Error.

<?php
/**
 * Пример использования метода get_col_length()
 */
global $wpdb;
$table = 'wp_posts'; // Название таблицы
$column = 'post_title'; // Название столбца
$col_length = $wpdb->get_col_length( $table, $column );
if ( false !== $col_length ) {
    echo 'Максимальная длина столбца ' . $column . ' в таблице ' . $table . ' составляет ' . $col_length . ' символов.';
} else {
    echo 'Столбец ' . $column . ' в таблице ' . $table . ' не имеет ограничения на длину.';
}
?>

В приведенном выше примере мы используем метод get_col_length() для получения максимальной длины столбца $column в таблице $table. Затем мы проверяем, есть ли ограничение на длину столбца, и выводим соответствующее сообщение.

get_results()

Метод get_results() класса wpdb используется для получения полного набора результатов SQL-запроса из базы данных (т.е. множества строк). Он возвращает результаты запроса в виде массива или объекта.

wpdb::get_results( string $query = null, string $output = OBJECT ): array|object|null

Метод get_results() принимает два параметра: $query (необязательный) и $output (необязательный).

$query — SQL-запрос. По умолчанию равен null.

$output — тип возвращаемых результатов. Может быть одним из следующих значений: ARRAY_A, ARRAY_N, OBJECT, OBJECT_K. По умолчанию используется OBJECT.

$query (string) — Необязательный SQL-запрос. По умолчанию: null.

$output (string) — Необязательный. Любая из констант ARRAY_A, ARRAY_N, OBJECT, OBJECT_K. С одной из первых трех вариантов возвращает массив строк, индексированный от 0 по номеру строки результата SQL. Каждая строка представлена ассоциативным массивом (столбец => значение, …), числовым индексированным массивом (0 => значение, …) или объектом (->столбец = значение), соответственно. С OBJECT_K возвращает ассоциативный массив объектов строк, индексированный значением первого столбца каждой строки. Дублирующиеся ключи отбрасываются. По умолчанию: OBJECT.

Метод get_results() возвращает результаты запроса базы данных в виде массива или объекта. Возможные типы возвращаемых значений: array, object, null.

<?php
$query = "SELECT * FROM wp_posts";
$output = OBJECT;
$results = $wpdb->get_results( $query, $output );
if ( $results ) {
    foreach ( $results as $result ) {
        // Доступ к значениям столбцов
        $post_title = $result->post_title;
        $post_content = $result->post_content;
        
        // Дальнейшая обработка данных
    }
}
?>

В приведенном выше примере мы выполняем SQL-запрос для выборки всех записей из таблицы «wp_posts». Результаты запроса сохраняются в переменной $results. Затем мы проверяем, есть ли результаты, и если есть, то проходимся по каждой строке и получаем доступ к значениям столбцов. Далее можно выполнять дополнительную обработку данных.

get_row()

Метод get_row() класса wpdb используется для получения одной строки из базы данных. Он выполняет SQL-запрос и возвращает результат в указанном формате.

wpdb::get_row( string|null $query = null, string $output = OBJECT, int $y ): array|object|null|void

Метод get_row() принимает три параметра:

• $query (строка|null): Опциональный SQL-запрос. По умолчанию равен null.
• $output (строка): Опциональный тип возвращаемого результата. Может быть OBJECT, ARRAY_A или ARRAY_N. По умолчанию равен OBJECT.
• $y (целое число): Опциональный номер строки для возврата. Индексируется с 0. По умолчанию равен 0.

Метод get_row() возвращает результат запроса к базе данных в указанном формате или null в случае ошибки.

<?php
  global $wpdb;
  
  $query = "SELECT * FROM wp_posts WHERE post_type = 'post'";
  $output = OBJECT;
  $row_number = 0;
  
  $result = $wpdb->get_row( $query, $output, $row_number );
  
  // Проверяем, успешно ли выполнен запрос
  if ( $result ) {
    // Выводим данные строки
    echo "ID: " . $result->ID . "<br>";
    echo "Заголовок: " . $result->post_title . "<br>";
    echo "Содержимое: " . $result->post_content . "<br>";
  } else {
    echo "Ошибка выполнения запроса.";
  }
?>

В этом примере мы используем метод get_row() для получения первой строки из таблицы wp_posts с типом записи post. Результат запроса сохраняется в переменную $result. Затем мы проверяем, успешно ли выполнен запрос, и выводим данные строки, если запрос выполнен успешно. В противном случае выводится сообщение об ошибке.

get_table_charset()

Метод get_table_charset() класса wpdb используется для получения набора символов (character set) для указанной таблицы в базе данных WordPress.

wpdb::get_table_charset( string $table ): string|WP_Error

Метод get_table_charset() принимает один обязательный параметр:

• $table (string) — Название таблицы.

Метод get_table_charset() принимает следующий параметр:

• $table (string) — Обязательный. Название таблицы.

Параметр $table указывает название таблицы, для которой нужно получить набор символов.

Метод get_table_charset() возвращает набор символов таблицы (string) или объект WP_Error, если набор символов не удалось найти.

<?php
/**
 * Пример использования метода get_table_charset()
 */
global $wpdb;
$table_name = 'wp_posts'; // Название таблицы
$table_charset = $wpdb->get_table_charset( $table_name );
if ( ! is_wp_error( $table_charset ) ) {
    echo 'Набор символов таблицы ' . $table_name . ': ' . $table_charset;
} else {
    echo 'Не удалось найти набор символов для таблицы ' . $table_name;
}
?>

В приведенном примере мы используем метод get_table_charset() для получения набора символов таблицы wp_posts. Затем мы проверяем, успешно ли получен набор символов, и выводим его значение. Если набор символов не удалось найти, выводится соответствующее сообщение.

get_table_from_query()

Метод get_table_from_query() класса wpdb используется для поиска имени первой таблицы, на которую ссылается запрос.

wpdb::get_table_from_query( string $query ): string|false

Метод get_table_from_query() принимает один обязательный параметр:

• $query (string) — Запрос, в котором нужно найти имя таблицы.

$query (string) — Обязательный. Запрос, в котором нужно найти имя таблицы.

Метод get_table_from_query() возвращает имя найденной таблицы или false, если таблица не может быть найдена.

$query = "SELECT * FROM wp_posts";
$table_name = $wpdb->get_table_from_query( $query );

В данном примере мы передаем запрос "SELECT * FROM wp_posts" в метод get_table_from_query() и сохраняем результат в переменную $table_name. Если таблица найдена, то в переменной будет содержаться имя таблицы "wp_posts". Если таблица не может быть найдена, то в переменной будет содержаться значение false.

get_var()

Метод get_var() класса wpdb используется для извлечения одной переменной из базы данных WordPress. Он позволяет выполнить произвольный SQL-запрос и получить результат в виде строки.

wpdb::get_var( string|null $query = null, int $x, int $y ): string|null

Метод get_var() принимает следующие параметры:

• $query (строка или null): Опциональный SQL-запрос. По умолчанию равен null, что означает использование результата предыдущего запроса.
• $x (целое число): Опциональный номер столбца, значение которого требуется вернуть. Индексация начинается с 0. По умолчанию равен 0.
• $y (целое число): Опциональный номер строки, значение которой требуется вернуть. Индексация начинается с 0. По умолчанию равен 0.

Метод get_var() возвращает результат запроса в виде строки или null в случае ошибки.

<code>$wpdb = new wpdb( 'username', 'password', 'database', 'localhost' );
// Выполнение SQL-запроса и получение значения переменной
$result = $wpdb->get_var( "SELECT COUNT(*) FROM wp_posts" );
// Вывод результата
echo "Количество записей в таблице wp_posts: " . $result;</code>

В приведенном примере мы создаем объект wpdb с указанием учетных данных для подключения к базе данных. Затем мы выполняем SQL-запрос, который возвращает количество записей в таблице wp_posts. Результат сохраняется в переменную $result и выводится на экран.

has_cap()

Метод has_cap() класса wpdb используется для определения поддержки определенной функции базы данных или WPDB.

wpdb::has_cap( string $db_cap ): bool

Метод has_cap() принимает один обязательный параметр $db_cap, который представляет собой функцию, которую необходимо проверить. Возможные значения для $db_cap: ‘collation’, ‘group_concat’, ‘subqueries’, ‘set_charset’, ‘utf8mb4’, ‘utf8mb4_520’ или ‘identifier_placeholders’.

$db_cap (string) (обязательный): Функция, которую необходимо проверить. Принимает значения ‘collation’, ‘group_concat’, ‘subqueries’, ‘set_charset’, ‘utf8mb4’, ‘utf8mb4_520’ или ‘identifier_placeholders’.

Метод has_cap() возвращает true, если функция базы данных поддерживается, и false в противном случае.

<?php
// Проверяем поддержку функции collation
if ( $wpdb->has_cap( 'collation' ) ) {
    // Функция collation поддерживается
    echo 'Функция collation поддерживается.';
} else {
    // Функция collation не поддерживается
    echo 'Функция collation не поддерживается.';
}
?>

В данном примере мы проверяем поддержку функции collation с помощью метода has_cap(). Если функция поддерживается, выводится сообщение «Функция collation поддерживается». В противном случае выводится сообщение «Функция collation не поддерживается».

hide_errors()

Метод hide_errors() класса wpdb отключает отображение ошибок базы данных. Он предназначен для использования в WordPress при работе с базой данных.

wpdb::hide_errors(): bool

Метод hide_errors() не принимает аргументов. Он возвращает логическое значение true или false, в зависимости от того, было ли ранее активно отображение ошибок.

Метод hide_errors() возвращает логическое значение true или false, указывающее, было ли ранее активно отображение ошибок базы данных.

init_charset()

Метод init_charset() класса wpdb устанавливает значения свойств $this->charset и $this->collate. Он вызывается при инициализации объекта wpdb и используется для установки кодировки и сравнения символов базы данных.

Кодировка определяет, как символы хранятся и обрабатываются в базе данных. Сравнение символов определяет порядок сортировки и сравнения символов в строках.

wpdb::init_charset();

Метод init_charset() вызывается автоматически при создании объекта wpdb. Он не требует явного вызова из кода.

Этот метод устанавливает значения свойств $this->charset и $this->collate объекта wpdb на основе значений, указанных в файле конфигурации WordPress.

Свойство $this->charset содержит кодировку, которая будет использоваться при общении с базой данных. Свойство $this->collate содержит правило сравнения символов для данной кодировки.

insert()

Метод insert() класса wpdb используется для вставки строки в таблицу базы данных WordPress.

wpdb::insert( string $table, array $data, array|string $format = null ): int|false

Метод insert() принимает три параметра: $table, $data и $format. Он возвращает количество вставленных строк или false в случае ошибки.

$table (string) — Обязательный. Название таблицы.

$data (array) — Обязательный. Данные для вставки в формате пар «столбец => значение». Оба столбца и значения должны быть «сырыми» (не должны быть экранированы SQL). Отправка значения null приведет к установке столбца в NULL — соответствующий формат будет проигнорирован в этом случае.

$format (array|string) — Необязательный. Массив форматов, которые будут сопоставлены каждому значению в $data. Если строка, то этот формат будет использоваться для всех значений в $data. Формат может быть одним из ‘%d’, ‘%f’, ‘%s’ (целое число, число с плавающей запятой, строка). Если параметр опущен, все значения в $data будут рассматриваться как строки, если не указано иное в wpdb::$field_types. По умолчанию: null.

Метод insert() возвращает количество вставленных строк или false в случае ошибки.

<?php
// Вставка строки в таблицу "wp_posts"
$table = 'wp_posts';
$data = array(
    'post_title'   => 'Заголовок поста',
    'post_content' => 'Содержимое поста',
    'post_status'  => 'publish',
    'post_author'  => 1
);
$format = array('%s', '%s', '%s', '%d');
$result = $wpdb->insert( $table, $data, $format );
if ( $result === false ) {
    echo 'Ошибка при вставке строки';
} else {
    echo 'Строка успешно вставлена. Количество вставленных строк: ' . $result;
}
?>

В этом примере мы вставляем новую строку в таблицу «wp_posts» с заданными значениями для столбцов «post_title», «post_content», «post_status» и «post_author». Мы также указываем форматы для каждого значения. После выполнения вставки мы проверяем результат и выводим сообщение об успехе или ошибке.

load_col_info()

Метод load_col_info() класса wpdb используется для загрузки метаданных столбцов из последнего запроса. Он извлекает информацию о столбцах из результата запроса и сохраняет ее во внутреннем кэше объекта wpdb. Это позволяет получить доступ к информации о столбцах, такой как их имена, типы данных, ограничения и другие свойства.

Метод load_col_info() вызывается автоматически после выполнения запроса к базе данных, и его результаты могут быть использованы в дальнейшем для различных целей, например, для проверки типов данных столбцов или для генерации динамических SQL-запросов.

wpdb::load_col_info();

Вызов метода load_col_info() не требует передачи аргументов. Он выполняется автоматически после выполнения запроса к базе данных, поэтому обычно нет необходимости вызывать его явно.

Метод load_col_info() загружает метаданные столбцов из последнего запроса и сохраняет их во внутреннем кэше объекта wpdb. Это позволяет получить доступ к информации о столбцах через другие методы класса wpdb, такие как get_col_types() или get_col_length().

log_query()

Метод log_query() класса wpdb используется для записи данных о выполненном запросе в журнал. Он принимает информацию о запросе, такую как SQL-запрос, время выполнения, стек вызовов, время начала выполнения и дополнительные пользовательские данные, и сохраняет ее для последующего анализа и отладки.

wpdb::log_query( string $query, float $query_time, string $query_callstack, float $query_start, array $query_data )

Метод log_query() принимает следующие параметры:

• $query (обязательный): SQL-запрос.
• $query_time (обязательный): Общее время выполнения запроса в секундах.
• $query_callstack (обязательный): Стек вызовов в виде строки, разделенной запятыми.
• $query_start (обязательный): Временная метка Unix начала выполнения запроса.
• $query_data (обязательный): Дополнительные пользовательские данные запроса в виде массива.

<?php
$query = "SELECT * FROM wp_posts";
$query_time = 0.123;
$query_callstack = "my_function, another_function";
$query_start = microtime(true);
$query_data = array('param1' => 'value1', 'param2' => 'value2');
// Запись данных о запросе в журнал
$wpdb->log_query($query, $query_time, $query_callstack, $query_start, $query_data);
?>

В приведенном выше примере кода мы создаем переменные, содержащие информацию о выполненном запросе. Затем мы вызываем метод log_query() объекта $wpdb с этими переменными в качестве аргументов, чтобы записать данные о запросе в журнал.

parse_db_host()

Метод parse_db_host() класса wpdb используется для разбора значения параметра DB_HOST и его интерпретации для функции mysqli_real_connect(). Он позволяет получить информацию о хосте, порте, сокете и является ли адрес IPv6.

wpdb::parse_db_host( string $host ): array|false

Метод parse_db_host() принимает один обязательный параметр:

• $host (строка, обязательный): Значение параметра DB_HOST для разбора.

Метод parse_db_host() принимает следующий параметр:

• $host (строка, обязательный): Значение параметра DB_HOST для разбора.

Параметр $host содержит значение параметра DB_HOST, которое требуется разобрать.

Метод parse_db_host() возвращает массив, содержащий хост, порт, сокет и информацию о том, является ли адрес IPv6. Порядок следования элементов в массиве: хост, порт, сокет, является ли адрес IPv6. Если хост не может быть разобран, метод возвращает false.

<code>// Пример использования метода parse_db_host()
$host = 'localhost:3306';
$result = $wpdb->parse_db_host($host);
/*
  $result содержит следующий массив:
  array(
    'host' => 'localhost',
    'port' => '3306',
    'socket' => '',
    'is_ipv6' => false
  )
*/

placeholder_escape()

Метод placeholder_escape() класса wpdb генерирует и возвращает строку для экранирования заполнителей, используемых в запросах, возвращаемых методом prepare(). Он предназначен для защиты от SQL-инъекций и обеспечения безопасности данных, передаваемых в запросы.

wpdb::placeholder_escape(): string

Метод placeholder_escape() возвращает строку, которая используется для экранирования заполнителей в запросах. Этот метод не принимает аргументов.

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

$wpdb = new wpdb( 'username', 'password', 'database', 'localhost' );
$placeholder = $wpdb->placeholder_escape();

В данном примере создается объект wpdb с указанными параметрами подключения к базе данных WordPress. Затем вызывается метод placeholder_escape(), который возвращает строку для экранирования заполнителей.

Метод placeholder_escape() возвращает строку, которая используется для экранирования заполнителей в запросах.

prepare()

Метод prepare() класса wpdb в WordPress используется для подготовки SQL-запроса перед его безопасным выполнением. Он позволяет защитить запрос от SQL-инъекций путем экранирования значений, подставляемых в запрос.

wpdb::prepare( string $query, mixed $args ): string|void

Метод prepare() принимает два параметра: $query и $args. Первый параметр ($query) является обязательным и представляет собой строку с запросом, содержащим плейсхолдеры в формате, аналогичном функции sprintf(). Второй параметр ($args) также является обязательным и представляет собой дополнительные переменные, которые будут подставлены в плейсхолдеры запроса.

$query (string) — Обязательный. Запрос с плейсхолдерами, аналогичными функции sprintf().

$args (mixed) — Обязательный. Дополнительные переменные для подстановки в плейсхолдеры запроса.

Метод prepare() возвращает безопасно экранированную строку запроса, если запрос был передан. В противном случае возвращается void.

<?php
$query = $wpdb->prepare(
    'SELECT * FROM wp_posts WHERE post_title = %s AND post_author = %d',
    $post_title,
    $post_author
);
?>

В данном примере мы используем метод prepare() для подготовки SQL-запроса, который выбирает все записи из таблицы wp_posts, где значение поля post_title равно определенной переменной $post_title, а значение поля post_author равно определенной переменной $post_author. Переменные $post_title и $post_author будут безопасно экранированы и подставлены в запрос.

print_error()

Метод print_error() класса wpdb используется для вывода ошибок SQL/БД. Он позволяет вывести сообщение об ошибке, которое содержит детали о произошедшей ошибке, такие как текст запроса, код ошибки и сообщение об ошибке.

wpdb::print_error( string $str = '' ): void|false

Метод print_error() принимает один необязательный параметр $str, который представляет собой текст ошибки, который будет выведен. По умолчанию, если параметр не указан, будет выведена ошибка, которая была сохранена в свойстве last_error объекта wpdb.

$str string (необязательно): Текст ошибки, который будет выведен. По умолчанию: » (пустая строка).

Метод print_error() возвращает void (ничего), если вывод ошибок включен, и false, если вывод ошибок отключен.

<?php
// Создание объекта wpdb
$wpdb = new wpdb( 'username', 'password', 'database', 'localhost' );
// Вызов метода print_error() без параметра
$wpdb->print_error();
// Вызов метода print_error() с параметром
$wpdb->print_error( 'Ошибка при выполнении запроса' );
?>

В этом примере мы создаем объект wpdb с указанием имени пользователя, пароля, имени базы данных и хоста. Затем мы вызываем метод print_error() без параметра, чтобы вывести последнюю сохраненную ошибку. Затем мы вызываем метод print_error() с параметром, чтобы вывести заданный текст ошибки.

process_fields()

Метод process_fields() класса wpdb используется для обработки массивов пар поле/значение и форматов полей.

Метод принимает таблицу, массив данных и форматы полей в качестве параметров. Он обрабатывает каждую пару поле/значение и форматирует их с помощью метода prepare() класса wpdb. Затем он возвращает массив полей, содержащий пары значение и формат.

wpdb::process_fields( string $table, array $data, mixed $format ): array|false

Метод process_fields() принимает следующие параметры:

• $table (обязательный) — Название таблицы.
• $data (обязательный) — Массив полей и их значений.
• $format (обязательный) — Формат каждого поля.

$table (string) — Обязательный. Название таблицы.

$data (array) — Обязательный. Массив пар поле/значение.

$format (mixed) — Обязательный. Формат для каждого поля.

Метод process_fields() возвращает массив полей, содержащий пары значение и формат. В случае недопустимых значений возвращает false.

<?php
// Пример использования метода process_fields()
$table = 'wp_posts'; // Название таблицы
$data = array(
    'post_title' => 'Заголовок поста',
    'post_content' => 'Содержимое поста',
    'post_author' => 1
); // Массив полей и их значений
$format = array(
    '%s',
    '%s',
    '%d'
); // Форматы полей
$fields = $wpdb->process_fields( $table, $data, $format ); // Обработка полей
if ( $fields ) {
    // Поля успешно обработаны
    foreach ( $fields as $field ) {
        $value = $field['value'];
        $format = $field['format'];
        
        // Дальнейшая обработка полей
        // ...
    }
} else {
    // Недопустимые значения полей
    // Обработка ошибки
    // ...
}
?>

process_field_charsets()

Метод process_field_charsets() класса wpdb добавляет наборы символов полей в массивы полей/значений/форматов, сгенерированные методом wpdb::process_field_formats(). Он используется для добавления информации о наборе символов к каждому полю в массиве данных.

wpdb::process_field_charsets( array $data, string $table ): array|false

Метод process_field_charsets() принимает два параметра: массив данных $data и имя таблицы $table. Он возвращает массив с теми же элементами, что и $data, но с дополнительными ключами ‘charset’. В случае ошибки метод возвращает false.

$data (array) — Обязательный. Массив полей со значениями, полученный из метода wpdb::process_field_formats().

$table (string) — Обязательный. Имя таблицы.

Метод process_field_charsets() возвращает массив с теми же элементами, что и $data, но с дополнительными ключами ‘charset’. В случае ошибки метод возвращает false.

<?php
// Пример использования метода process_field_charsets()
$data = array(
    'field1' => 'value1',
    'field2' => 'value2'
);
$table = 'my_table';
$result = $wpdb->process_field_charsets( $data, $table );
if ( $result ) {
    // Обработка успешного результата
    foreach ( $result as $field => $value ) {
        echo "Field: " . $field . ", Value: " . $value . ", Charset: " . $value['charset'] . "<br>";
    }
} else {
    // Обработка ошибки
    echo "Error occurred.";
}
?>

В этом примере мы создаем массив данных $data с двумя полями и значениями. Затем мы указываем имя таблицы $table. Мы вызываем метод process_field_charsets() и передаем ему массив данных и имя таблицы. Результат сохраняется в переменной $result. Если результат успешен, мы выводим каждое поле, его значение и набор символов в цикле. Если произошла ошибка, мы выводим сообщение об ошибке.

process_field_formats()

Метод process_field_formats() класса wpdb используется для подготовки массивов пар значений/форматов, которые передаются в методы CRUD (Create, Read, Update, Delete) объекта wpdb в WordPress.

Этот метод принимает массив полей и значений $data и форматы $format и возвращает массив, в котором ключами являются имена полей, а значениями — массивы с ключами ‘value’ и ‘format’.

wpdb::process_field_formats( array $data, mixed $format ): array

Метод process_field_formats() принимает два обязательных параметра: массив полей и значений $data и форматы $format. Он возвращает массив, в котором каждому полю соответствует массив с ключами ‘value’ и ‘format’.

$data (array) — Обязательный. Массив полей и значений.

$format (mixed) — Обязательный. Форматы, которые будут привязаны к значениям в массиве $data.

Метод process_field_formats() возвращает массив, в котором каждому полю соответствует массив с ключами ‘value’ и ‘format’.

<?php
$data = array(
    'name' => 'John',
    'age' => 30,
    'email' => 'john@example.com'
);
$format = array(
    'name' => '%s',
    'age' => '%d',
    'email' => '%s'
);
$result = $wpdb->process_field_formats($data, $format);
/*
Результат:
$result = array(
    'name' => array(
        'value' => 'John',
        'format' => '%s'
    ),
    'age' => array(
        'value' => 30,
        'format' => '%d'
    ),
    'email' => array(
        'value' => 'john@example.com',
        'format' => '%s'
    )
);
*/
?>

В приведенном выше примере мы создаем массив $data с полями и значениями, а также массив $format с форматами для каждого поля. Затем мы вызываем метод process_field_formats() и передаем ему эти два массива. Результатом будет новый массив, в котором каждому полю соответствует массив с ключами ‘value’ и ‘format’.

process_field_lengths()

Метод process_field_lengths() класса wpdb используется для обработки длины строковых полей в базе данных WordPress. Он записывает максимальную длину строки, которую поле может безопасно сохранить.

wpdb::process_field_lengths( array $data, string $table ): array|false

Метод process_field_lengths() принимает два параметра: $data (обязательный) и $table (обязательный). Параметр $data представляет собой массив полей со значениями, который получается из метода wpdb::process_field_charsets(). Параметр $table содержит имя таблицы.

$data (array) — Массив полей со значениями, полученный из метода wpdb::process_field_charsets().

$table (string) — Имя таблицы.

Метод process_field_lengths() возвращает тот же самый массив $data с дополнительными ключами ‘length’ для каждого поля, или false, если какое-либо из значений было слишком длинным для соответствующего поля.

<?php
// Пример использования метода process_field_lengths()
// Создаем экземпляр класса wpdb
$wpdb = new wpdb('username', 'password', 'database', 'localhost');
// Массив полей со значениями
$data = array(
    'field1' => 'value1',
    'field2' => 'value2',
    'field3' => 'value3'
);
// Имя таблицы
$table = 'my_table';
// Вызываем метод process_field_lengths()
$result = $wpdb->process_field_lengths($data, $table);
// Выводим результат
print_r($result);
?>

В данном примере мы создаем экземпляр класса wpdb и передаем ему параметры для подключения к базе данных. Затем мы создаем массив $data с полями и значениями. Указываем имя таблицы $table. Затем вызываем метод process_field_lengths() и передаем ему массив $data и имя таблицы $table. Результат выводится с помощью функции print_r().

query()

Метод query() выполняет запрос к базе данных, используя текущее соединение с базой данных.

Метод используется для выполнения SQL-запросов к базе данных WordPress. Он может использоваться для создания, изменения, удаления таблиц, а также для выборки данных из таблиц базы данных.

wpdb::query( string $query ) : int|bool

Метод query() принимает один обязательный параметр:

• $query (строка, обязательный) — SQL-запрос к базе данных.

$query (строка, обязательный): SQL-запрос к базе данных.

Метод query() возвращает результат выполнения запроса. Возвращаемое значение может быть:

• Целое число (int) или логическое значение (bool) true для запросов CREATE, ALTER, TRUNCATE и DROP. В этом случае запрос был успешно выполнен.
• Целое число (int) — количество затронутых/выбранных строк для всех остальных запросов.
• Логическое значение (bool) false в случае ошибки выполнения запроса.

<?php
global $wpdb;
$query = "SELECT * FROM wp_posts WHERE post_type = 'post'";
$result = $wpdb->query( $query );
if ( $result === false ) {
    echo "Ошибка выполнения запроса.";
} else {
    echo "Запрос выполнен успешно. Количество выбранных строк: " . $result;
}
?>

В приведенном выше примере мы используем глобальный объект $wpdb, чтобы выполнить SQL-запрос к базе данных WordPress. Запрос выбирает все записи из таблицы wp_posts, где тип записи равен «post». Результат выполнения запроса сохраняется в переменную $result. Затем мы проверяем результат и выводим сообщение об успешном выполнении запроса или об ошибке.

quote_identifier()

Метод quote_identifier() класса wpdb используется для экранирования идентификатора (например, названия таблицы или поля) для базы данных MySQL. Это необходимо для предотвращения возможных атак SQL-инъекций и обеспечения безопасности данных.

wpdb::quote_identifier( string $identifier ): string

Метод quote_identifier() принимает один обязательный параметр:

• $identifier (string) — Идентификатор, который требуется экранировать.

Метод quote_identifier() принимает следующий параметр:

• $identifier (string) — Обязательный параметр. Идентификатор, который требуется экранировать.

Метод quote_identifier() возвращает экранированный идентификатор в виде строки.

<?php
$wpdb = new wpdb( 'username', 'password', 'database', 'localhost' );
$identifier = 'my_table';
$escaped_identifier = $wpdb->quote_identifier( $identifier );
echo $escaped_identifier; // Выведет экранированный идентификатор
?>

В приведенном выше примере кода создается объект wpdb с указанными параметрами подключения к базе данных. Затем определяется переменная $identifier, содержащая идентификатор таблицы. Метод quote_identifier() вызывается на объекте $wpdb с передачей переменной $identifier в качестве аргумента. Результат экранирования сохраняется в переменной $escaped_identifier. Наконец, экранированный идентификатор выводится на экран.

remove_placeholder_escape()

Метод remove_placeholder_escape() класса wpdb используется для удаления строк-заменителей из запроса.

wpdb::remove_placeholder_escape( string $query ): string

Метод remove_placeholder_escape() принимает один обязательный параметр:

• $query (строка) — Запрос, из которого будет удален строковый заменитель.

Метод remove_placeholder_escape() принимает следующий параметр:

• $query (обязательный) — Запрос, из которого будет удален строковый заменитель.

Метод remove_placeholder_escape() возвращает строку — запрос с удаленным строковым заменителем.

<?php
$query = "SELECT * FROM wp_posts WHERE post_title = %s";
$clean_query = $wpdb->remove_placeholder_escape( $query );
?>

В данном примере мы имеем запрос, в котором используется строковый заменитель %s. Метод remove_placeholder_escape() применяется для удаления этого заменителя из запроса. Результат сохраняется в переменную $clean_query.

replace()

Метод replace() класса wpdb используется для замены строки в таблице. Он позволяет вставить новую строку в таблицу или обновить существующую строку, если она уже существует.

wpdb::replace( string $table, array $data, array|string $format = null ) : int|false

Метод replace() принимает три параметра: $table, $data и $format. Он возвращает количество затронутых строк или false в случае ошибки.

$table (string) — Обязательный. Название таблицы.

$data (array) — Обязательный. Данные для вставки (в виде пар «столбец» => «значение»). Как столбцы, так и значения должны быть «сырыми» (не должны быть экранированы SQL). Отправка значения null приведет к установке столбца в NULL — соответствующий формат в этом случае игнорируется.

$format (array|string) — Необязательный. Массив форматов, которые будут применены к каждому значению в $data. Если строка, то этот формат будет использоваться для всех значений в $data. Формат может быть одним из ‘%d’, ‘%f’, ‘%s’ (целое число, число с плавающей запятой, строка). Если не указан, все значения в $data будут рассматриваться как строки, если не указано иное в wpdb::$field_types. По умолчанию: null.

Метод replace() возвращает количество затронутых строк или false в случае ошибки.

<?php
// Заменить строку в таблице 'wp_users'
$table = 'wp_users';
// Данные для замены
$data = array(
    'user_login' => 'new_username',
    'user_email' => 'new_email@example.com',
    'user_registered' => '2022-01-01 00:00:00'
);
// Форматы значений
$format = array(
    '%s',
    '%s',
    '%s'
);
// Выполнить замену строки
$result = $wpdb->replace( $table, $data, $format );
if ( $result === false ) {
    echo 'Ошибка при замене строки.';
} else {
    echo 'Строка успешно заменена. Количество затронутых строк: ' . $result;
}
?>

select()

Метод select() класса wpdb используется для выбора базы данных с использованием текущего или предоставленного соединения с базой данных. Он позволяет выполнить SQL-запрос к базе данных и вернуть результат в виде массива.

wpdb::select( string $db, mysqli|resource $dbh = null )

Метод select() принимает два параметра: $db (обязательный) — имя базы данных, и $dbh (необязательный) — соединение с базой данных. По умолчанию используется текущее соединение с базой данных.

$db (строка, обязательный): Имя базы данных.

$dbh (mysqli|resource, необязательный): Соединение с базой данных. По умолчанию используется текущее соединение с базой данных.

<?php
// Выбор базы данных с использованием текущего соединения
$db = 'my_database';
$wpdb->select( $db );
// Выбор базы данных с использованием предоставленного соединения
$db = 'my_database';
$dbh = mysqli_connect( 'localhost', 'username', 'password' );
$wpdb->select( $db, $dbh );
?>

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

set_blog_id()

Метод set_blog_id() класса wpdb используется для установки идентификатора блога в WordPress. Он позволяет установить текущий блог, с которым будут выполняться все запросы к базе данных.

wpdb::set_blog_id( int $blog_id, int $network_id ): int

Метод set_blog_id() принимает два параметра: $blog_id (обязательный) и $network_id (необязательный). Параметр $blog_id указывает идентификатор блога, который нужно установить. Параметр $network_id указывает идентификатор сети, к которой относится блог (по умолчанию равен 0).

$blog_id (int) — Обязательный. Идентификатор блога, который нужно установить.

$network_id (int) — Необязательный. Идентификатор сети, к которой относится блог. По умолчанию равен 0.

Метод set_blog_id() возвращает предыдущий идентификатор блога в виде целого числа (int).

<?php
// Установка идентификатора блога 2
$previous_blog_id = $wpdb->set_blog_id(2);
?>

В приведенном выше примере кода метод set_blog_id() используется для установки идентификатора блога 2. Предыдущий идентификатор блога сохраняется в переменной $previous_blog_id.

set_charset()

Метод set_charset() класса wpdb устанавливает набор символов для соединения с базой данных.

Этот метод используется для установки набора символов и сортировки для соединения с базой данных WordPress. Он позволяет указать, какие символы будут использоваться при обработке данных, передаваемых между WordPress и базой данных.

wpdb::set_charset( mysqli|resource $dbh, string $charset = null, string $collate = null )

Метод set_charset() принимает три параметра:

• $dbh (mysqli|resource) — Обязательный. Соединение, возвращаемое функцией mysqli_connect() или mysql_connect().
• $charset (string) — Необязательный. Набор символов. По умолчанию: null.
• $collate (string) — Необязательный. Сортировка. По умолчанию: null.

<?php
// Установка набора символов и сортировки для соединения с базой данных
global $wpdb;
$charset = 'utf8';
$collate = 'utf8_general_ci';
$wpdb->set_charset( $wpdb->dbh, $charset, $collate );
?>

В этом примере мы устанавливаем набор символов и сортировку для соединения с базой данных WordPress. Мы используем глобальную переменную $wpdb для доступа к экземпляру класса wpdb. Затем мы указываем набор символов и сортировку, которые будут использоваться при обработке данных, передаваемых между WordPress и базой данных.

set_prefix()

Метод set_prefix() класса wpdb устанавливает префикс таблиц для таблиц WordPress. Префикс таблиц используется для именования таблиц в базе данных WordPress. Этот метод позволяет изменить префикс таблиц на новый.

wpdb::set_prefix( string $prefix, bool $set_table_names = true ): string|WP_Error

Метод set_prefix() принимает два параметра:

• $prefix (обязательный) — новый префикс таблиц, должен быть алфавитно-цифровым.
• $set_table_names (необязательный) — определяет, должны ли обновляться имена таблиц, например, wpdb::$posts. По умолчанию значение true.

$prefix (string) — Новый префикс таблиц. Обязательный параметр. Должен быть алфавитно-цифровым.

$set_table_names (bool) — Определяет, должны ли обновляться имена таблиц. По умолчанию значение true.

Метод set_prefix() возвращает старый префикс или объект WP_Error в случае ошибки.

<?php
/**
 * Пример использования метода set_prefix()
 */
// Создаем экземпляр класса wpdb
$wpdb = new wpdb( 'username', 'password', 'database', 'localhost' );
// Устанавливаем новый префикс таблиц
$new_prefix = 'new_prefix_';
$result = $wpdb->set_prefix( $new_prefix );
if ( is_wp_error( $result ) ) {
    // Обработка ошибки
    echo $result->get_error_message();
} else {
    // Успешно установлен новый префикс
    echo 'Старый префикс: ' . $result;
}
?>

В приведенном выше примере мы создаем экземпляр класса wpdb и устанавливаем новый префикс таблиц с помощью метода set_prefix(). Если метод успешно выполняется, он возвращает старый префикс, который мы выводим на экран. Если происходит ошибка, мы выводим сообщение об ошибке.

set_sql_mode()

Метод set_sql_mode() класса wpdb изменяет текущий режим SQL и гарантирует его совместимость с WordPress. Он используется для установки режима SQL, который определяет, какие функции и возможности будут доступны при выполнении SQL-запросов.

wpdb::set_sql_mode( array $modes = array() )

Метод set_sql_mode() принимает один параметр — массив $modes, который содержит список режимов SQL, которые нужно установить. По умолчанию, если параметр не передан, используется пустой массив.

$modes (обязательный): Массив режимов SQL, которые нужно установить. По умолчанию: пустой массив.

<?php
// Устанавливаем режимы SQL
$modes = array(
    'STRICT_TRANS_TABLES',
    'NO_ZERO_IN_DATE',
    'NO_ZERO_DATE',
    'ERROR_FOR_DIVISION_BY_ZERO',
    'NO_AUTO_CREATE_USER',
    'NO_ENGINE_SUBSTITUTION'
);
$wpdb->set_sql_mode( $modes );
?>

В приведенном выше примере мы создаем массив $modes, содержащий список режимов SQL, которые нужно установить. Затем мы вызываем метод set_sql_mode() объекта $wpdb и передаем ему этот массив в качестве параметра.

show_errors()

Метод show_errors() класса wpdb включает отображение ошибок базы данных. Когда этот метод активирован, ошибки базы данных будут отображаться на экране, что может быть полезно при отладке и разработке.

wpdb::show_errors( bool $show = true ): bool

Метод show_errors() принимает один необязательный параметр:

• $show (тип: bool) — Определяет, нужно ли отображать ошибки базы данных. По умолчанию установлено значение true.

Метод show_errors() принимает следующий параметр:

• $show (тип: bool, необязательный) — Определяет, нужно ли отображать ошибки базы данных. По умолчанию установлено значение true.

Метод show_errors() возвращает значение типа bool, которое указывает, было ли отображение ошибок ранее активировано.

<code>// Включение отображения ошибок базы данных
$wpdb->show_errors(true);
// Отключение отображения ошибок базы данных
$wpdb->show_errors(false);</code>

strip_invalid_text()

Метод strip_invalid_text() класса wpdb используется для удаления недопустимых символов на основе пар значений/наборов символов.

Этот метод работает путем проверки каждого значения массива данных на наличие недопустимых символов и удаления их. Он особенно полезен при обработке входных данных, которые могут содержать недопустимые символы, такие как SQL-инъекции или неправильно закодированные символы.

wpdb::strip_invalid_text( array $data ): array|WP_Error

Метод strip_invalid_text() принимает массив данных $data и возвращает массив данных с удаленными недопустимыми символами. Если невозможно удалить недопустимые символы, возвращается объект WP_Error.

$data (обязательный): Массив массивов значений. Каждый массив значений имеет ключи ‘value’ и ‘charset’. Дополнительный ключ ‘ascii’ может быть установлен в значение false, чтобы избежать избыточных проверок ASCII.

Метод strip_invalid_text() возвращает параметр $data с удаленными недопустимыми символами из каждого значения. Это работает как пропуск: любые дополнительные ключи, такие как ‘field’, сохраняются в каждом массиве значений. Если невозможно удалить недопустимые символы, возвращается объект WP_Error.

<?php
// Пример использования метода strip_invalid_text()
// Массив данных для обработки
$data = array(
    array(
        'value' => "Hello, <script>alert('World!')</script>",
        'charset' => 'UTF-8'
    ),
    array(
        'value' => "Привет, мир!",
        'charset' => 'UTF-8'
    )
);
// Вызов метода strip_invalid_text()
$result = $wpdb->strip_invalid_text( $data );
// Вывод результата
var_dump( $result );
?>

В этом примере мы создаем массив данных $data с двумя значениями. Первое значение содержит недопустимые символы в виде скрипта JavaScript, а второе значение содержит корректные символы на русском языке.

Мы вызываем метод strip_invalid_text() и передаем ему массив данных. Метод удаляет недопустимые символы из каждого значения и возвращает измененный массив данных.

Затем мы выводим результат с помощью функции var_dump().

strip_invalid_text_for_column()

Метод strip_invalid_text_for_column() класса wpdb используется для удаления недопустимых символов из строки для указанной таблицы и столбца в базе данных WordPress.

wpdb::strip_invalid_text_for_column( string $table, string $column, string $value ): string|WP_Error

Метод strip_invalid_text_for_column() принимает три обязательных параметра:

• $table — имя таблицы
• $column — имя столбца
• $value — текст для проверки

$table string — Обязательный. Имя таблицы.

$column string — Обязательный. Имя столбца.

$value string — Обязательный. Текст для проверки.

Метод strip_invalid_text_for_column() возвращает преобразованную строку или объект WP_Error, если преобразование не удалось.

<?php
// Использование метода strip_invalid_text_for_column()
$table = 'wp_posts';
$column = 'post_title';
$value = 'Hello, World!';
$result = $wpdb->strip_invalid_text_for_column( $table, $column, $value );
if ( ! is_wp_error( $result ) ) {
  echo 'Converted string: ' . $result;
} else {
  echo 'Conversion failed: ' . $result->get_error_message();
}
?>

strip_invalid_text_from_query()

Метод strip_invalid_text_from_query() класса wpdb используется для удаления недопустимых символов из запроса.

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

wpdb::strip_invalid_text_from_query( string $query ): string|WP_Error

Метод strip_invalid_text_from_query() принимает один обязательный параметр:

• $query (string) — Запрос, который необходимо преобразовать.

$query (string) — Обязательный. Запрос, который необходимо преобразовать.

Метод strip_invalid_text_from_query() возвращает преобразованный запрос или объект WP_Error, если преобразование не удалось.

<?php
$query = "SELECT * FROM wp_posts WHERE post_title = 'Hello, world!'";
$converted_query = $wpdb->strip_invalid_text_from_query( $query );
?>

В приведенном выше примере мы создаем переменную $query и присваиваем ей SQL-запрос для выборки всех записей из таблицы wp_posts, где значение поля post_title равно «Hello, world!». Затем мы вызываем метод strip_invalid_text_from_query() объекта $wpdb и передаем ему наш запрос. Результат преобразования сохраняется в переменной $converted_query.

supports_collation()

Метод supports_collation() класса wpdb проверяет поддерживает ли база данных сортировку.

wpdb::supports_collation(): bool

Метод supports_collation() является устаревшим. Вместо него следует использовать метод has_cap() класса wpdb.

Метод supports_collation() возвращает булево значение. Если сортировка поддерживается, то возвращается true, в противном случае — false.

suppress_errors()

Метод suppress_errors() класса wpdb включает или отключает подавление ошибок базы данных. Подавление ошибок означает, что ошибки, возникающие при выполнении запросов к базе данных, не будут выводиться на экран. Это может быть полезно, если вы хотите обрабатывать ошибки самостоятельно или просто не хотите видеть их.

wpdb::suppress_errors( bool $suppress = true ): bool

Метод suppress_errors() принимает один необязательный параметр:

• $suppress (тип: bool, по умолчанию: true) — указывает, нужно ли подавлять ошибки. Если значение равно true, ошибки будут подавлены, если false — ошибки будут отображаться.

Метод suppress_errors() возвращает значение типа bool, которое указывает, было ли подавление ошибок активно до вызова метода.

/**
 * Пример использования метода suppress_errors()
 */
// Включаем подавление ошибок
$wpdb->suppress_errors(true);
// Выполняем запрос к базе данных
$result = $wpdb->query( "SELECT * FROM wp_posts" );
// Проверяем, была ли ошибка
if ( $wpdb->last_error ) {
    // Обрабатываем ошибку
    echo "Ошибка базы данных: " . $wpdb->last_error;
}
// Выключаем подавление ошибок
$wpdb->suppress_errors(false);

В этом примере мы сначала включаем подавление ошибок с помощью метода suppress_errors(). Затем выполняем запрос к базе данных с помощью метода query(). Если произошла ошибка, мы обрабатываем ее. После этого мы отключаем подавление ошибок, чтобы ошибки снова отображались.

tables()

Метод tables() класса wpdb возвращает массив таблиц WordPress. Этот метод используется для получения списка всех таблиц, используемых в текущей установке WordPress.

wpdb::tables( string $scope = 'all', bool $prefix = true, int $blog_id ): string[]

Метод tables() принимает три необязательных параметра: $scope, $prefix и $blog_id. Параметры указываются в круглых скобках после имени метода.

$scope (строка, необязательный) — Возможные значения: ‘all’, ‘global’, ‘ms_global’, ‘blog’ или ‘old’. Значение по умолчанию: ‘all’.

$prefix (логическое значение, необязательный) — Определяет, нужно ли включать префиксы таблиц. Если запрашивается префикс блога, то пользовательские таблицы и таблицы пользовательских метаданных будут отображаться. Значение по умолчанию: true.

$blog_id (целое число, необязательный) — Идентификатор блога, к которому нужно добавить префикс. Используется только при запросе префикса. Значение по умолчанию: значение свойства $blogid класса wpdb.

Метод tables() возвращает массив имен таблиц. Когда запрашивается префикс, ключом является имя таблицы без префикса.

<?php
// Получение списка всех таблиц
$tables = $wpdb->tables();
?>

В данном примере кода метод tables() вызывается без параметров, поэтому будут возвращены все таблицы WordPress.

timer_start()

Метод timer_start() класса wpdb используется для запуска таймера в целях отладки. Он позволяет измерить время выполнения определенного участка кода и определить, сколько времени занимает его выполнение.

wpdb::timer_start();

Этот код запускает таймер.

Метод timer_start() возвращает значение true.

timer_stop()

Метод timer_stop() класса wpdb используется для остановки отладочного таймера. Он измеряет время выполнения запроса и возвращает общее время, затраченное на выполнение запроса в секундах.

wpdb::timer_stop(): float

Метод timer_stop() вызывается без аргументов и возвращает значение типа float. Возвращаемое значение представляет собой общее время, затраченное на выполнение запроса, измеренное в секундах.

Метод timer_stop() возвращает общее время, затраченное на выполнение запроса, в секундах. Значение возвращается в виде числа с плавающей точкой (тип float).

update()

Метод update() класса wpdb используется для обновления строки в таблице базы данных WordPress. Он позволяет изменить значения определенных столбцов в указанной таблице на новые значения.

wpdb::update( string $table, array $data, array $where, array|string $format = null, array|string $where_format = null ): int|false

Метод update() принимает следующие параметры:

• $table (обязательный) — Название таблицы.
• $data (обязательный) — Данные для обновления (в виде пар «столбец => значение»). Оба столбца и значения должны быть «сырыми» (не должны быть экранированы SQL). Отправка значения null приведет к установке столбца в NULL — соответствующий формат будет проигнорирован в этом случае.
• $where (обязательный) — Именованный массив условий WHERE (в виде пар «столбец => значение»). Множественные условия будут объединены с помощью оператора AND. Как столбцы, так и значения в условиях WHERE должны быть «сырыми». Отправка значения null создаст сравнение IS NULL — соответствующий формат будет проигнорирован в этом случае.
• $format (необязательный) — Массив форматов, которые будут применены к каждому значению в $data. Если строка, то этот формат будет использоваться для всех значений в $data. Формат может быть одним из ‘%d’, ‘%f’, ‘%s’ (целое число, число с плавающей запятой, строка). Если не указан, все значения в $data будут рассматриваться как строки, если не указано иное в wpdb::$field_types. По умолчанию: null.
• $where_format (необязательный) — Массив форматов, которые будут применены к каждому значению в $where. Если строка, то этот формат будет использоваться для всех элементов в $where. Формат может быть одним из ‘%d’, ‘%f’, ‘%s’ (целое число, число с плавающей запятой, строка). Если не указан, все значения в $where будут рассматриваться как строки. По умолчанию: null.

Метод update() возвращает количество обновленных строк или false в случае ошибки.

<?php
// Обновление строки в таблице 'wp_posts'
$table = 'wp_posts';
// Данные для обновления
$data = array(
    'post_title'   => 'Новый заголовок',
    'post_content' => 'Новый контент'
);
// Условие WHERE
$where = array(
    'ID' => 123
);
// Форматы данных
$format = array(
    '%s',
    '%s'
);
// Форматы условия WHERE
$where_format = array(
    '%d'
);
// Обновление строки
$result = $wpdb->update( $table, $data, $where, $format, $where_format );
if ( $result !== false ) {
    echo "Строка успешно обновлена.";
} else {
    echo "Ошибка при обновлении строки.";
}
?>

В этом примере мы обновляем строку в таблице ‘wp_posts’, устанавливая новые значения для столбцов ‘post_title’ и ‘post_content’. Условие WHERE указывает, что нужно обновить строку с ID равным 123. Мы также указываем форматы данных и форматы условия WHERE. Результат обновления строки выводится на экран.

_do_query()

Метод _do_query() является внутренней функцией, которая выполняет вызов mysql_query(). Он используется для выполнения запросов к базе данных MySQL.

wpdb::_do_query( string $query )

Метод _do_query() принимает один обязательный параметр:

• $query (string) — Запрос, который нужно выполнить.

Метод _do_query() принимает следующий параметр:

• $query (string) — Обязательный. Запрос, который нужно выполнить.

Параметр $query должен быть строкой, содержащей корректный SQL-запрос для базы данных MySQL.

<?php
/**
 * Пример использования метода _do_query()
 */
global $wpdb;
$query = "SELECT * FROM wp_posts";
$result = $wpdb->_do_query( $query );
if ( $result ) {
    // Обработка успешного выполнения запроса
} else {
    // Обработка ошибки выполнения запроса
}
?>

В приведенном выше примере мы создаем переменную $query и присваиваем ей SQL-запрос для выборки всех записей из таблицы wp_posts. Затем мы вызываем метод _do_query() объекта $wpdb и передаем ему наш запрос. Результат выполнения запроса сохраняется в переменной $result. Затем мы проверяем значение переменной $result и выполняем соответствующие действия в зависимости от результата запроса.

_escape()

Метод _escape() класса wpdb используется для экранирования данных. Он принимает строку или массив данных и возвращает экранированные данные того же типа, что и переданные.

wpdb::_escape( string|array $data ): string|array

Метод _escape() принимает один обязательный параметр $data, который представляет собой данные, которые нужно экранировать.

$data (string|array) (обязательный): Данные, которые нужно экранировать.

Метод _escape() возвращает экранированные данные того же типа, что и переданные.

<?php
$data = "It's a string";
$escaped_data = $wpdb->_escape( $data );
?>

В приведенном выше примере переменная $data содержит строку, которую нужно экранировать. Метод _escape() вызывается на объекте $wpdb и передается переменная $data в качестве параметра. Результат экранирования сохраняется в переменной $escaped_data.

_escape_identifier_value()

Метод _escape_identifier_value() класса wpdb используется для экранирования значения идентификатора без добавления окружающих кавычек. Он принимает строку и возвращает экранированное значение идентификатора.

wpdb::_escape_identifier_value( string $identifier ): string

Метод _escape_identifier_value() принимает один обязательный параметр:

• $identifier (string) — Идентификатор для экранирования.

Метод возвращает экранированное значение идентификатора в виде строки.

<?php
$wpdb = new wpdb( 'username', 'password', 'database', 'localhost' );
$identifier = 'table_name';
$escaped_identifier = $wpdb->_escape_identifier_value( $identifier );
echo $escaped_identifier;
?>

В приведенном выше примере мы создаем новый объект wpdb и передаем необходимые параметры для подключения к базе данных. Затем мы определяем идентификатор $identifier и вызываем метод _escape_identifier_value() для экранирования этого идентификатора. Наконец, мы выводим экранированное значение идентификатора.

_insert_replace_helper()

Метод _insert_replace_helper() является вспомогательной функцией для выполнения операций вставки и замены данных в базе данных WordPress. Он используется внутри класса wpdb для обработки запросов на вставку и замену данных.

wpdb::_insert_replace_helper( string $table, array $data, array|string $format = null, string $type = 'INSERT' ): int|false

Метод _insert_replace_helper() принимает следующие параметры:

• $table (обязательный) — Название таблицы, в которую будут вставлены или заменены данные.
• $data (обязательный) — Данные для вставки или замены в формате массива (в виде пар «столбец» => «значение»). Оба ключи и значения массива должны быть «сырыми» (не должны быть экранированы для SQL). Отправка значения null приведет к установке столбца в значение NULL — соответствующий формат будет проигнорирован в этом случае.
• $format (необязательный) — Массив форматов, которые будут применены к каждому значению в $data. Если это строка, то этот формат будет использоваться для всех значений в $data. Формат может быть одним из ‘%d’, ‘%f’, ‘%s’ (целое число, число с плавающей точкой, строка). Если параметр опущен, все значения в $data будут рассматриваться как строки, если не указано иное в свойстве wpdb::$field_types. По умолчанию: null.
• $type (необязательный) — Тип операции. Может быть ‘INSERT’ или ‘REPLACE’. По умолчанию: ‘INSERT’.

$table (string) — Обязательный. Название таблицы.

$data (array) — Обязательный. Данные для вставки или замены.

$format (array|string) — Необязательный. Массив форматов или строка формата.

$type (string) — Необязательный. Тип операции.

Метод _insert_replace_helper() возвращает количество затронутых строк или false в случае ошибки.

<?php
// Пример использования метода _insert_replace_helper()
$table = 'wp_posts';
$data = array(
    'post_title' => 'Новый пост',
    'post_content' => 'Содержимое нового поста',
    'post_author' => 1,
    'post_date' => '2022-01-01 00:00:00'
);
$format = array(
    '%s',
    '%s',
    '%d',
    '%s'
);
$type = 'INSERT';
$result = $wpdb->_insert_replace_helper( $table, $data, $format, $type );
if ( $result !== false ) {
    echo 'Данные успешно вставлены. Количество затронутых строк: ' . $result;
} else {
    echo 'Ошибка при выполнении операции вставки данных.';
}
?>

_real_escape()

Метод _real_escape() класса wpdb используется для защиты строки от SQL-инъекций путем экранирования специальных символов. Он использует функцию mysqli_real_escape_string() или mysql_real_escape_string() для выполнения экранирования.

Этот метод является внутренним методом класса wpdb и обычно используется внутри других методов этого класса для экранирования данных перед их использованием в SQL-запросах.

wpdb::_real_escape( string $data ): string

Метод _real_escape() принимает один обязательный параметр:

• $data (обязательный): Строка, которую нужно экранировать.

Метод возвращает экранированную строку.

<?php
// Создаем экземпляр класса wpdb
$wpdb = new wpdb('username', 'password', 'database', 'localhost');
// Строка, которую нужно экранировать
$data = "It's a string with 'special' characters.";
// Экранируем строку
$escaped_data = $wpdb->_real_escape( $data );
// Выводим экранированную строку
echo $escaped_data;
?>

В этом примере мы создаем экземпляр класса wpdb и передаем ему данные для подключения к базе данных. Затем мы создаем строку с особыми символами, которую нужно экранировать. Мы вызываем метод _real_escape() объекта $wpdb и передаем ему эту строку. Метод возвращает экранированную строку, которую мы выводим на экран.

_weak_escape()

Метод _weak_escape() класса wpdb является устаревшим и не рекомендуется к использованию. Вместо него следует использовать метод wpdb::prepare(). Метод _weak_escape() предназначен для экранирования данных, которые будут использоваться в SQL-запросах, чтобы предотвратить возможность SQL-инъекций.

wpdb::_weak_escape( string $data ): string

Метод _weak_escape() принимает один обязательный параметр:

• $data (string) — Строка, которую необходимо экранировать.

Метод возвращает экранированную строку.

// Экранирование строки
$data = "It's a sample string";
$escaped_data = $wpdb->_weak_escape( $data );

В данном примере переменная $data содержит строку, которую необходимо экранировать. Метод _weak_escape() вызывается на объекте $wpdb и передается экранируемая строка в качестве параметра. Результат экранирования сохраняется в переменную $escaped_data.

__construct()

Метод __construct() класса wpdb используется для подключения к серверу базы данных и выбора базы данных. Он вызывается при создании нового объекта класса wpdb.

wpdb::__construct( string $dbuser, string $dbpassword, string $dbname, string $dbhost )

Метод __construct() принимает четыре обязательных параметра:

• $dbuser — Имя пользователя базы данных.
• $dbpassword — Пароль пользователя базы данных.
• $dbname — Имя базы данных.
• $dbhost — Хост базы данных.

// Подключение к базе данных
$wpdb = new wpdb('username', 'password', 'database', 'localhost');

В данном примере создается новый объект класса wpdb и происходит подключение к базе данных с использованием указанных параметров. Замените значения 'username', 'password', 'database' и 'localhost' на соответствующие значения вашей базы данных.

• $dbuser — Обязательный параметр. Имя пользователя базы данных.
• $dbpassword — Обязательный параметр. Пароль пользователя базы данных.
• $dbname — Обязательный параметр. Имя базы данных.
• $dbhost — Обязательный параметр. Хост базы данных.

Метод __construct() принимает четыре обязательных параметра: $dbuser, $dbpassword, $dbname и $dbhost. Они используются для установления соединения с базой данных и выбора нужной базы данных.

__get()

Метод «__get()» класса «wpdb» используется для чтения приватных свойств объекта «wpdb» в целях обеспечения обратной совместимости.

wpdb::__get( string $name ): mixed

Метод «__get()» принимает один обязательный параметр:

• $name (string) — Название приватного свойства, которое нужно получить и, при необходимости, обработать.

Метод «__get()» принимает следующий параметр:

• $name (string) — Обязательный. Название приватного свойства, которое нужно получить и, при необходимости, обработать.

Параметр $name должен быть строкой.

Метод «__get()» возвращает значение приватного свойства.

Тип возвращаемого значения — «mixed».

<?php
/**
 * Пример использования метода "__get()" класса "wpdb"
 */
// Создание объекта "wpdb"
$wpdb = new wpdb();
// Получение значения приватного свойства "private_property"
$value = $wpdb->__get('private_property');
?>

В приведенном выше примере кода мы создаем объект «wpdb» и затем используем метод «__get()» для получения значения приватного свойства «private_property». Результат будет сохранен в переменной «$value».

__isset()

Метод «__isset()» класса «wpdb» используется для проверки наличия значения у приватного свойства объекта. Он делает приватные свойства проверяемыми для обратной совместимости.

wpdb::__isset( string $name ): bool

Метод «__isset()» принимает один обязательный параметр:

• $name (string) — Приватное свойство, которое нужно проверить.

Метод «__isset()» принимает следующий параметр:

• $name (string) — Обязательный. Приватное свойство, которое нужно проверить.

Параметр $name должен быть строкой.

Метод «__isset()» возвращает булево значение:

• bool — Возвращает true, если свойство установлено, и false, если свойство не установлено.

<?php
/**
 * Пример использования метода "__isset()" класса "wpdb".
 *
 * @param string $name Приватное свойство, которое нужно проверить.
 * @return bool Возвращает true, если свойство установлено, и false, если свойство не установлено.
 */
function example_method( $name ) {
    global $wpdb;
    
    // Проверяем наличие значения у приватного свойства "name" объекта "$wpdb"
    $is_set = $wpdb->__isset( $name );
    
    return $is_set;
}
?>

__set()

Метод «__set()» класса «wpdb» позволяет устанавливать значения для приватных свойств класса. Этот метод используется для обратной совместимости.

wpdb::__set( string $name, mixed $value )

Метод «__set()» принимает два параметра: $name (строка) и $value (любой тип данных). Он устанавливает значение $value для приватного свойства с именем $name.

$name (обязательный): Приватное свойство, для которого нужно установить значение.

$value (обязательный): Значение, которое нужно установить для приватного свойства.

<?php
// Установка значения для приватного свойства
$wpdb->__set( 'private_property', $value );
?>

В приведенном выше примере кода метод «__set()» используется для установки значения $value для приватного свойства с именем ‘private_property’.

__unset()

Метод «__unset()» класса «wpdb» используется для сделки приватных свойств неустанавливаемыми для обеспечения обратной совместимости. Этот метод делает приватные свойства недоступными для изменения, что может быть полезно, если вы хотите предотвратить изменение определенных свойств объекта.

wpdb::__unset( string $name )

Метод «__unset()» принимает один обязательный параметр:

• $name (string) — Название приватного свойства, которое должно быть сделано неустанавливаемым.

Метод «__unset()» принимает следующий параметр:

• $name (string) — Обязательный. Приватный член, который должен быть сделан неустанавливаемым.

Параметр $name должен быть строкой, содержащей название приватного свойства, которое вы хотите сделать неустанавливаемым.

<?php
/**
 * Пример использования метода "__unset()" класса "wpdb"
 *
 * @param string $name Название приватного свойства.
 */
$wpdb->__unset( $name );
?>

В приведенном выше примере кода метод «__unset()» вызывается на объекте «$wpdb» с передачей названия приватного свойства в качестве параметра. Это позволяет сделать указанное приватное свойство неустанавливаемым.

// Подключение к базе данных
$wpdb = new wpdb('username', 'password', 'database', 'localhost');

// Выборка всех записей из таблицы "users"
$results = $wpdb->get_results("SELECT * FROM {$wpdb->prefix}users");
// Вывод результатов выборки
foreach ($results as $result) {
    echo $result->user_login;
}

// Добавление новой записи в таблицу "posts"
$data = array(
    'post_title' => 'New Post',
    'post_content' => 'Lorem ipsum dolor sit amet',
    'post_author' => 1
);
$wpdb->insert("{$wpdb->prefix}posts", $data);

// Обновление записи в таблице "users"
$data = array(
    'user_email' => 'newemail@example.com'
);
$where = array(
    'ID' => 1
);
$wpdb->update("{$wpdb->prefix}users", $data, $where);

// Удаление записи из таблицы "posts"
$where = array(
    'ID' => 1
);
$wpdb->delete("{$wpdb->prefix}posts", $where);

// Создание экземпляра класса wpdb
$wpdb = new wpdb('username', 'password', 'database', 'localhost');
// Подключение к базе данных и выбор базы данных
$wpdb->db_connect();

// Выполнение запроса к базе данных
$result = $wpdb->query("SELECT * FROM wp_posts");

// Получение результатов запроса в виде массива
$results = $wpdb->get_results("SELECT * FROM wp_posts");
// Вывод результатов
foreach ($results as $result) {
    echo $result->post_title;
}

// Получение одной строки из базы данных
$row = $wpdb->get_row("SELECT * FROM wp_posts WHERE post_id = 1");
// Вывод результатов
echo $row->post_title;

global $wpdb;
$query = "SELECT column_name FROM table_name";
$result = $wpdb->get_col( $query );

global $wpdb;
$table_name = $wpdb->prefix . 'table_name';
$data = array(
    'column1' => 'value1',
    'column2' => 'value2',
);
$result = $wpdb->insert( $table_name, $data );

global $wpdb;
$table_name = $wpdb->prefix . 'table_name';
$data = array(
    'column1' => 'new_value1',
    'column2' => 'new_value2',
);
$where = array(
    'column3' => 'value3',
);
$result = $wpdb->update( $table_name, $data, $where );

global $wpdb;
$table_name = $wpdb->prefix . 'table_name';
$where = array(
    'column1' => 'value1',
);
$result = $wpdb->delete( $table_name, $where );