White cat - Справочник по PHP

Типы ресурсов:

Расширение определяет один новый тип ресурсов: указатель на bz2-файл, с которым идет работа.

Предопределенные константы:

Данное расширение не определяет никакие константы.

Пример:

Содержание:

Введение:

Расширение используется для чтения, записи файлов (.bz2), с использованием метода сжатия bzip2.

Требования:

Расширение использует функции библиотеки bzip2 (автор: Julian Seward) и требует bzip2/libbzip2 версий = 1.0.x.

Установка:

Поддержка Bzip2 в PHP не включена по умолчанию. Вам придется скомпилировать PHP с указанием директивы --with-bz2[=DIR].

Настройка во время выполнения:

Данное расширение не определяет никакие директивы конфигурации в php.ini.

Типы ресурсов:

Расширение определяет один новый тип ресурсов: указатель на bz2-файл, с которым идет работа.

Предопределенные константы:

Данное расширение не определяет никакие константы.

Пример:

Содержание:

bzclose

Закрывает файл bzip2.

Синтаксис:

int bzclose (resource bz)

Функция bzclose()Закрывает файл bzip2, на который ссылается указатель bz .

Функция возвращает TRUE в случае успешного завершения, FALSE в случае возникновения ошибки.

Указатель должен быть рабочим и должен ссылаться на файл, успешно открытый функцией bzopen().

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzcompress

Сжимает данные с использованием bzip2.

Синтаксис:

string bzcompress ( string source [, int blocksize [, int workfactor]])

Функция bzcompress()возвращает строку source , сжатую с использованием bzip2.

Опциональный параметр blocksize указывает размер блока используемого во время сжатия и должен быть числом от 1 до 9, где 9 дает наилучшее качество сжатия, но использует больше ресурсов. По умолчанию blocksize равен 4.

Опциональный параметр workfactor указывает как поведет себя процесс сжатия в худшем случае, при часто повторяющихся блоках. Параметр может принимать значения от 0 до 250, с 0 в специальном случае и с 30 по умолчанию. Независимо от параметра workfactor , результат сжатия всегда один.

Пример использования функции bzcompress():

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzdecompress

Распаковывает данные, сжатые с использованием bzip2.

Синтаксис:

string bzdecompress ( string source [, int small])

Функция bzdecompress()распаковывает и возвращает source строку, содержащую данные, сжатые с использованием bzip2. Если опциональный параметр small указан как TRUE, будет использован альтернативный алгоритм декомпрессии. Он использует меньше памяти (максимальный размер используемой памяти -- около 2300K), но работает в два раза медленнее.

Пример использования функции bzdecompress():

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzerrno

Возвращает код ошибки работы с bzip2.

Синтаксис:

int bzerrno ( resource bz)

Функция bzerrno()возвращает код ошибки последней bzip2 функций, отработавшей с указателем bz .

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzerror

Возвращает код и строку ошибки работы с bzip2.

Синтаксис:

array bzerror ( resource bz)

Функция bzerror()возвращает ассоциативный массив с кодом и строкой ошибки последней bzip2 функции, отработавшей с указателем bz .

Пример использования функции bzerror():

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzerrstr

Возвращает строку ошибки работы с bzip2.

Синтаксис:

string bzerrstr ( resource bz)

Функция bzerrstr()возвращает строку ошибки последней bzip2 функции, отработавшей с указателем bz .

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzflush

Вызывает запись всех буфферизированных данных.

Синтаксис:

sint bzflush ( resource bz)

Функция bzflush()записывает все буфферизированные bzip2 данные в файл, на который ссылается указатель bz .

Возвращает TRUE в случае успешного завершения, FALSE в случае возникновения ошибки.

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzopen

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

Синтаксис:

resource bzopen ( string filename, string mode)

Функция bzopen() открывает файл bzip2 (.bz2) для чтения или записи. filename путь к файлу. mode параметр аналогичный одноименному параметру функции fopen()("r" -- чтение, "w" -- запись, и т.д.).

При ошибке открытия функция возвращает FALSE, иначе она возвращает указатель на открытый файл.

Пример использования функции bzopen():

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzread

Бинарно-безопасное чтение файла bzip2.

Синтаксис:

string bzread ( resource bz [, int length])

Функция bzread()считывает length байт из файла bzip2, на который ссылается указатель bz . Чтение останавливается, когда length (несжатых) байт прочитано или достигнут конец файла (EOF). Если опциональный параметр length не задан, bzread()будет считывать по 1024 (несжатых) байт за раз.

Пример использования функции bzread():

Функция поддерживается PHP 4= 4.0.4, PHP 5

bzwrite

Бинарно-безопасная запись bzip2 файла.

Синтаксис:

int bzwrite ( resource bz, string data [, int length])

Функция bzwrite()записывает содержание строки data в поток файла bzip2, на который ссылается указатель bz . Если указан опциональный параметр length , запись будет остановлена по достижению length байт (несжатых), либо по достижению конца строки.