diff --git a/reference/oggvorbis/book.xml b/reference/oggvorbis/book.xml new file mode 100644 index 000000000..0611166b7 --- /dev/null +++ b/reference/oggvorbis/book.xml @@ -0,0 +1,53 @@ + + + + + + + OGG/Vorbis + oggvorbis + + + + &reftitle.intro; + + Формат файлов OGG/Vorbis, как определено в &url.ogg.vorbis; - это схема + сжатия аудио-потока с использованием множества факторов и минимальными + потерями качества. Это расширение добавляет поддержку Ogg Vorbis в + Обертки URL PHP. Когда используется в режиме чтения, + сжатые данные OGG/Vorbis расжимаются в сырой аудио поток PCM в одном из шести + форматов кодирования PCM, перечисленных в разделе + предопределенные константы. + + + + + &reference.oggvorbis.setup; + &reference.oggvorbis.constants; + &reference.oggvorbis.contexts; + &reference.oggvorbis.examples; + + + + + diff --git a/reference/oggvorbis/configure.xml b/reference/oggvorbis/configure.xml new file mode 100644 index 000000000..d006a86c6 --- /dev/null +++ b/reference/oggvorbis/configure.xml @@ -0,0 +1,33 @@ + + + + +
+ &reftitle.install; + + &pecl.info; + &url.pecl.package;oggvorbis + +
+ + + diff --git a/reference/oggvorbis/constants.xml b/reference/oggvorbis/constants.xml new file mode 100644 index 000000000..19a204ab8 --- /dev/null +++ b/reference/oggvorbis/constants.xml @@ -0,0 +1,66 @@ + + + + + + &reftitle.constants; + &extension.constants; + + OGG/Vorbis поддерживает кодирование PCM в следующих форматах + + + + Константа + Описание + + + + + OGGVORBIS_PCM_U8 + Беззнаковый 8-битный PCM. + + + OGGVORBIS_PCM_S8 + Знаковый 8-битный PCM. + + + OGGVORBIS_PCM_U16_LE + Беззнаковый 16-битный PCM. Порядок байт Little Endian. + + + OGGVORBIS_PCM_U16_BE + Беззнаковый 16-битный PCM. Порядок байт Big Endian. + + + OGGVORBIS_PCM_S16_LE + Знаковый 16-битный PCM. Порядок байт Little Endian. + + + OGGVORBIS_PCM_S16_BE + Знаковый 16-битный PCM. Порядок байт Big Endian. + + + +
+
+ + diff --git a/reference/oggvorbis/contexts.xml b/reference/oggvorbis/contexts.xml new file mode 100644 index 000000000..810d79c3b --- /dev/null +++ b/reference/oggvorbis/contexts.xml @@ -0,0 +1,92 @@ + + + + + + Опции контекста + + Опции настройки OGG/Vorbis + + + + Option + Definition + Relevance + Default + + + + + pcm_mode + Используется байтовая кодировка PCM. Смотрите константы ниже. + Чтение / Запись + OGGVORBIS_PCM_S16_LE + + + rate + Частота PCM. Измеряется в герцах. + Только запись + 44100 + + + bitrate + + Vorbis Average Bitrate Encoding / Variable Bitrate Encoding. + Измеряется в bps (ABR) или Уровне Качества (VBR: 0.0 to 1.0). + 128000 ABR примерно равно 0.4 VBR. + + Только запись + 128000 + + + channels + Количество каналов PCM. 1 == Моно, 2 == Стерео. + Только запись + 2 + + + serialno + + Серийный номер потока внутри файла. Должен быть уникален внутри файла. + Так как потенциально возможна ситуация, что в связанном файле + будет дублирующий серийный номер, озаботьтесь самостоятельным + управлением серийными номерами при кодировании. + + Только запись + Random + + + comments + + Ассоциативный массив комментариев файла. + Должно быть переведено с помощью strtoupper($name) . "=$value". + Обратите внимание: Данная опция контекста не доступна в oggvorbis-0.1 + + Только запись + array('ENCODER' => 'PHP/OggVorbis, http://pear.php.net/oggvorbis') + + + +
+
+ + diff --git a/reference/oggvorbis/examples.xml b/reference/oggvorbis/examples.xml new file mode 100644 index 000000000..c44ed7e06 --- /dev/null +++ b/reference/oggvorbis/examples.xml @@ -0,0 +1,98 @@ + + + + + + &reftitle.examples; +
+ Примеры использования обертки ogg://. + + + Чтение файла OGG/Vorbis + + +]]> + + + + + + + Кодирование аудио-файла в OGG/Vorbis + +array( + 'pcm_mode' => OGGVORBIS_PCM_S8, /* Знаковое 8-битное аудио */ + 'rate' => 44100, /* Качество 44kHz CD */ + 'bitrate' => 0.5, /* Среднее качество VBR */ + 'channels' => 1, /* Моно */ + 'serialno' => 12345))); /* Уникальный номер внутри файла */ + +/* Открываем файл для добавления. Мы "привяжем" второй поток OGG в конец файла. */ +$ogg = fopen('ogg://mysong.ogg', 'a', false, $context); + +$pcm = fopen('mysample.pcm', 'r'); + +/* Compress the raw PCM audio from mysample.pcm into mysong.ogg */ +stream_copy_to_stream($pcm, $ogg); + +fclose($pcm); +fclose($ogg); +?> +]]> + + + +
+
+ + + diff --git a/reference/oggvorbis/setup.xml b/reference/oggvorbis/setup.xml new file mode 100644 index 000000000..68c39597a --- /dev/null +++ b/reference/oggvorbis/setup.xml @@ -0,0 +1,59 @@ + + + + + + &reftitle.setup; + + +
+ &reftitle.required; + + Это расширение требует PHP >= 4.3.0, + libogg >= 1.0 и + libvorbis >= 1.0. + +
+ + + + &reference.oggvorbis.configure; + + + +
+ &reftitle.runtime; + &no.config; +
+ + + +
+ &reftitle.resources; + &no.resource; +
+ + +
+ + + diff --git a/reference/openssl/configure.xml b/reference/openssl/configure.xml new file mode 100644 index 000000000..5d69c5a44 --- /dev/null +++ b/reference/openssl/configure.xml @@ -0,0 +1,82 @@ + + + + +
+ &reftitle.install; + + Для поддержки OpenSSL в PHP вам необходимо скомпилировать PHP с опцией + . + + + Также библиотека OpenSSL имеет дополнительные требования для нормальной работы + во время исполнения. Самое главное, OpenSSL требуется доступ к генераторам случайных и + псевдослучайных чисел; на большинстве систем Unix/Linux, это означае + доступ к устройствам /dev/urandom или /dev/random. + + + Замечания для пользователей Win32 + + &ext.windows.path.dll; + libeay32.dll + + + Дополнительно, если вы собираетесь использовать функции генерации + ключей и подписи сертификатов, вам придется установить корректный + файл openssl.cnf в вашей системе. + Мы включили демонстрационный конфигурационный файл в бинарную + поставку под win32. Он лежит в директории + extras/openssl. + + + PHP будет искать openssl.cnf используя следующую логику: + + + Переменная окружения OPENSSL_CONF. Если установлена, то + должна содержать путь (включая имя файла) до конфигурационного файла. + + + + переменная окружения SSLEAY_CONF. Если установлена, то + должна содержать путь (включая имя файла) до конфигурационного файла. + + + + Файл openssl.cnf будет искаться по стандартному + пути для сертификатов, заданному при компиляции DLL. Обычно он задан как + c:\usr\local\ssl\openssl.cnf. + + + + + + При установке вы должны определить, установить ли файл по стандартному + пути c:\usr\local\ssl\openssl.cnf или хранить его в другом + месте и задать путь к нему через переменные окружения, что полезно при + использовании виртуальных хостов. Обратите внимание, что путь по + умолчанию можно переопределить в скрипте используя параметр + configargs функции, которой требуется этот файл. + + +
+ + diff --git a/reference/openssl/ini.xml b/reference/openssl/ini.xml new file mode 100644 index 000000000..c6118e066 --- /dev/null +++ b/reference/openssl/ini.xml @@ -0,0 +1,98 @@ + + + + +
+ &reftitle.runtime; + &extension.runtime; + + + &ConfigureOptions; openssl + + + + &Name; + &Default; + &Changeable; + Список изменений + + + + + openssl.cafile + "" + PHP_INI_PERDIR + Доступно с PHP 5.6.0. + + + openssl.capath + "" + PHP_INI_PERDIR + Доступно с PHP 5.6.0. + + + +
+ &ini.php.constants; +
+ + &ini.descriptions.title; + + + + + + openssl.cafile + string + + + + Местоположение файла Certificate Authority на локальной файловой системе, + который должен использоваться с опцией контекста verify_peer для + аутентификации удаленной точки. + + + + + + openssl.capath + string + + + + Если cafile не задан или сертификат не найден, то директория, указанная + в capath будет использована для поиска сертификата. + capath должна быть корректно хешированной директорией сертификата. + + + + + + + + Также смотрите опции контекста потока SSL. + + +
+ + + diff --git a/reference/pcre/functions/preg-replace-callback-array.xml b/reference/pcre/functions/preg-replace-callback-array.xml new file mode 100644 index 000000000..9bf445174 --- /dev/null +++ b/reference/pcre/functions/preg-replace-callback-array.xml @@ -0,0 +1,154 @@ + + + + + + + preg_replace_callback_array + Выполняет поиск и замену по регулярному выражению с использованием функций обратного вызова + + + + &reftitle.description; + + mixedpreg_replace_callback_array + arraypatterns_and_callbacks + mixedsubject + intlimit-1 + intcount + + + Поведение этой функции похоже на + preg_replace_callback, за исключением того, что для каждого шаблона + используется своя функция обратного вызова. + + + + + &reftitle.parameters; + + + + patterns_and_callbacks + + + Ассоциативный массив, связывающий шаблоны регулярного выражения (ключи) + и функции обратного вызова (значения). + + + + + subject + + + Строка, в которой будет производиться поиск и замена. + + + + + limit + + + Максимальное количество замен для каждого шаблона в строке + subject. По умолчанию + -1 (без ограничений). + + + + + count + + + Если задан, то в указанную переменную будет записано число произведенных замен. + + + + + + + + + &reftitle.returnvalues; + + preg_replace_callback_array возвращает массив, если + параметр subject является массивом и строку, если строкой. + В случае ошибки возвращается &null; + + + Если совпадения найдены, будет возвращена новая строка, а если нет, то исходная + subject. + + + + + &reftitle.examples; + + + Пример использования <function>preg_replace_callback_array</function> + + function ($match) { + echo strlen($match[0]), ' matches for "a" found', PHP_EOL; + }, + '~[b]+~i' => function ($match) { + echo strlen($match[0]), ' matches for "b" found', PHP_EOL; + } + ], + $subject +); +?> +]]> + + &example.outputs; + + + + + + + + + &reftitle.seealso; + + + Шаблоны PCRE + preg_replace_callback + preg_quote + preg_replace + preg_last_error + Анонимные функции + &seealso.callback; + + + + + + + diff --git a/reference/pdo_ibm/configure.xml b/reference/pdo_ibm/configure.xml new file mode 100644 index 000000000..bd88d8d59 --- /dev/null +++ b/reference/pdo_ibm/configure.xml @@ -0,0 +1,58 @@ + + + + +
+ &reftitle.install; + + Для сборки расширения PDO_IBM, на вашей системе должен быть установлен + DB2 Client версии v9.1 или выше. DB2 Client можно загрузить с сайта + Сайта Разработки Приложений IBM. + + + Обратите внимание + + DB2 Client версии v9.1 и выше поддерживает прямой доступ к DB2 для Linux, + UNIX и Windows Server v8 и v9.1. + + + Также DB2 Client v9.1 поддерживает доступ к серверам DB2 UDB для i5 и DB2 UDB + для z/OS используя отдельно купленый продукт + DB2 Connect. + + + + PDO_IBM - это расширение PECL, так что следуюте + инструкции для установки данного расширения. + Не забудьте указать команде configure местоположение + заголовочных файлов DB2 Client и библиотек: + + + + Команда configure по умолчанию будет использовать переменную + окружения DB2DIR. + +
+ + diff --git a/reference/pdo_ibm/reference.xml b/reference/pdo_ibm/reference.xml new file mode 100644 index 000000000..c8fbbd8cc --- /dev/null +++ b/reference/pdo_ibm/reference.xml @@ -0,0 +1,173 @@ + + + + + + Функции IBM (PDO_IBM) + IBM (PDO) + + +
+ &reftitle.intro; + + PDO_IBM - это драйвер, реализующий интерфейс PHP Data + Objects (PDO) для предоставления возможности работать с базами данных IBM. + +
+ + + &reference.pdo-ibm.configure; + +
+ + + + PDO_IBM DSN + Соединение с базой данных IBM + + + + &reftitle.description; + + Имя источника данных (DSN) PDO_IBM базируется на IBM CLI DSN. Главный компонент + PDO_IBM DSN: + + + Префикс DSN + + + Префикс DSN - ibm:. + + + + + DSN + + + DSN может быть одним из нижеследующего: + + + + a) Настройка источника данных с помощью db2cli.ini + или odbc.ini + + + + + b) Каталогизированное имя базы данных. Т.е. псевдоним базы данных + в каталоге клиента DB2 + + + + + c) Полноценная строка соединения: + DRIVER={IBM DB2 ODBC DRIVER};DATABASE=database;HOSTNAME=hostname;PORT=port;PROTOCOL=TCPIP;UID=username;PWD=password; + где параметры означают следующее: + + + database + + + Имя базы данных. + + + + + hostname + + + Имя хоста или IP-адрес сервера баз данных. + + + + + port + + + Порт TCP/IP, на котором слушает база. + + + + + username + + + Имя пользователя. + + + + + password + + + Пароль пользователя. + + + + + + + + + + + + + + + &reftitle.examples; + + + Пример PDO_IBM DSN с использованием <filename>db2cli.ini</filename> + + Следующий пример демонстрирует PDO_IBM DSN для соединения с базой DB2 + указанной как DB2_9 в db2cli.ini: + + + + + Пример PDO_IBM DSN с использованием строки соединения + + Следующий пример демонстрирует PDO_IBM DSN для соединения с базой DB2 + с именем testdb используя синтаксис соединения DB2 CLI. + + + + + + + + + +
+