Читать онлайн «Справочник по PHP». Страница 29

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

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

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

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

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

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

Пример:

<?php

$filename = "/tmp/testfile.bz2";

$str = "This is a test string.n";

// открываем файл для записи

$bz = bzopen($filename, "w");

// пишем строку в файл

bzwrite($bz, $str);

// закрываем файл

bzclose($bz);

// открываем файл для чтения

$bz = bzopen($filename, "r");

// читаем и выводим 10 символов

print bzread($bz, 10);

// выводим всё, до конца файла и закрываем его.

print bzread($bz);

bzclose($bz);

?>

Содержание:

Введение:

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

Требования:

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

Установка:

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

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

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

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

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

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

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

Пример:

<?php

$filename = "/tmp/testfile.bz2";

$str = "This is a test string.n";

// открываем файл для записи

$bz = bzopen($filename, "w");

// пишем строку в файл

bzwrite($bz, $str);

// закрываем файл

bzclose($bz);

// открываем файл для чтения

$bz = bzopen($filename, "r");

// читаем и выводим 10 символов

print bzread($bz, 10);

// выводим всё, до конца файла и закрываем его.

print bzread($bz);

bzclose($bz);

?>

Содержание:

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

$str = "sample data";

$bzstr = bzcompress($str, 9);

print( $bzstr );

?>

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

bzdecompress

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

Синтаксис:

string bzdecompress ( string source [, int small])

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

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

<?php

$start_str = "This is not an honest face?";

$bzstr = bzcompress($start_str);

print( "Compressed String: " );

print( $bzstr );

print( "n<br>n" );

$str = bzdecompress($bzstr);

print( "Decompressed String: " );

print( $str );

print( "n<br>n" );

?>

Функция поддерживается 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

$error = bzerror($bz);

echo $error["errno"];

echo $error["errstr"];

?>

Функция поддерживается 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

$bz = bzopen("/tmp/foo.bz2", "r");

$decompressed_file = "";

while (!feof($bz)) {

$decompressed_file .= bzread($bz, 4096);

}

bzclose($bz);

print( "The contents of /tmp/foo.bz2 are: " );

print( "n<br>n" );

print( $decompressed_file );

?>

Функция поддерживается 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

$bz = bzopen("/tmp/foo.bz2", "r");

$str = bzread($bz, 2048);

print( $str );

?>

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

bzwrite

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

Синтаксис:

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

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

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

<?php

$str = "uncompressed data";

$bz = bzopen("/tmp/foo.bz2", "w");

bzwrite($bz, $str, strlen($str));

bzclose($bz);

?>

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

Для того, чтобы эти функции заработали вы должны скомпилировать PHP с флагом --with-imap.

Этот флаг требует,чтобы была установлена библиотека c-client. Последнюю версию можно получить по адресу ftp://ftp.cac.washington.edu/imap/.

Затем скопируйте c-client/c-client.a в /usr/local/lib или какую либо другую директорию, прописанную в пути, затем скопируйте c-client/rfc822.h, mail.h и linkage.h в /usr/local/include или другую директорию с include-файлами.