igbinary_serialize

(PECL igbinary >= 1.1.1)

igbinary_serialize — Создаёт компактное, сохраняемое двоичное представление значения

Описание

function igbinary_serialize(mixed $value): string|false

Создаёт сохраняемое представление значения.

Полезно для хранения или передачи значений PHP без потери их типа и структуры.

Чтобы снова превратить сериализованную строку в значение PHP, можно использовать igbinary_unserialize().

Список параметров

value

Значение, которое необходимо сериализовать. igbinary_serialize() обрабатывает все типы, кроме ресурсов (resource) и некоторых объектов (object) (смотрите примечание ниже). Даже массивы (array), содержащие ссылки на себя, могут быть сериализованы функцией igbinary_serialize(). Циклические ссылки внутри сериализующихся массивов (array) или объектов (object) также будут сохранены. Любая другая ссылка будет потеряна.

При сериализации объектов, igbinary будет пытаться вызвать функции __serialize() или __sleep() перед сериализацией. Это позволит объекту выполнить любую очистку в последнюю минуту и т.д. перед сериализацией. Аналогичным образом, когда объект восстанавливается с помощью igbinary_unserialize(), вызывается функция __unserialize() или __wakeup().

Замечание:
Начало имён закрытых членов объекта (object) дополняются именем класса, а начало имён защищённых членов символом '*'. Эти дополненные значения окружаются нулевым байтом с обеих сторон.

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

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

Обратите внимание, что это двоичная строка, которая может включать в себя любое байтовое значение и должна храниться и обрабатываться как таковая. Например, вывод функции igbinary_serialize() обычно должен храниться в поле базы данных BLOB, а не в поле CHAR или TEXT.

Примеры

Пример #1 Пример использования igbinary_serialize()

<?php
$ser = igbinary_serialize(['test', 'test']);
echo urlencode($ser), "\n";
var_export(igbinary_unserialize($ser));
?>

Результат выполнения приведённого примера:

%00%00%00%02%14%02%06%00%11%04test%06%01%0E%00
array (
  0 => 'test',
  1 => 'test',
)

Примечания

Замечание:
Обратите внимание, что многие встроенные объекты PHP не могут быть сериализованы. Однако те, у кого есть такая возможность, реализуют либо интерфейс Serializable, либо магические методы __serialize()/__unserialize() или __sleep()/__wakeup(). Если внутренний класс не соответствует ни одному из этих требований, он не может быть надёжно сериализован с помощью какого-либо сериализатора.

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

Смотрите также

serialize() - Генерирует сохраняемое представление переменной
igbinary_unserialize() - Создаёт значение PHP из сохранённого функцией igbinary_serialize представления
var_export() - Выводит или возвращает удобное для разбора строковое представление переменной
json_encode() - Возвращает JSON-представление данных
Сериализация объектов
__sleep()
__wakeup()
__serialize()
__unserialize()

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей

Пользователи ещё не добавляли примечания для страницы