Функция get_option() в WordPress

Общая информация

Функция get_option() позволяет получать значение определенной настройки (опции) в WordPress по имени. Она сначала проверяет кэш, и если нужные данные там отсутствуют, запрашивает их из базы данных.

Если опция хранится как сериализированная строка, она автоматически преобразуется в удобный формат при возврате.

Важно помнить:

• Любые скалярные значения (числа, строки и т.д.) будут возвращены в формате строки.
• Результат функции можно изменить с помощью фильтра option_(option).

Как использовать функцию

Синтаксис:

get_option( $option, $default_value );

• $option (строка) (обязательный) — имя опции, которую нужно получить. Имя не должно содержать символов, которые могут быть интерпретированы как SQL.
• $default_value (смешанный тип) (необязательный) — значение по умолчанию, если опция не существует. По умолчанию: false.

Примеры имен опций:

• admin_email — Email администратора сайта.
• blogname — Название блога.
• blogdescription — Описание блога.
• blog_charset — Кодировка блога.
• posts_per_page — Максимальное количество постов на странице архива.

Полный список опций можно найти в документации WordPress.

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

Пример 1: Вывод названия сайта в заголовке H1

или краткий вариант:

Пример 2: Отображение кодировки сайта

Текущая кодировка: 

Пример 3: Сохранение Email администратора в переменной

$admin_email = get_option('admin_email');

Пример 4: Обработка отсутствующих опций

$no_exists_value = get_option('no_exists_value');
var_dump($no_exists_value); // Вернет false

$no_exists_value = get_option('no_exists_value', 'default_value');
var_dump($no_exists_value); // Вернет 'default_value'

Пример 5: Изменение результата функции get_option() в реальном времени

add_filter('option_active_plugins', function($plugins){
    return []; // Возвращает пустой массив (выключает все плагины)
});

var_dump(get_option('active_plugins')); // Вернет пустой массив

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

• Возвращает значение опции.
• Вернет false, если опция не существует или ее не удается получить.

Примечания

• Функция использует глобальный объект базы данных $wpdb для взаимодействия с базой данных WordPress.

Изменения

Функция get_option() была представлена в версии 1.5.0.

Как работает функция

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

Связанные функции

• add_option()
• update_option()
• delete_option()
• get_site_option()
• И другие функции, связанные с опциями WordPress.

Эта статья поможет вам лучше понять, как работает функция get_option() и как её можно использовать для получения значений настроек в WordPress.