Учебник PHP

         

vpopmail_alias_get_all

(PHP 4 >= 4.1.0)

vpopmail_alias_get_all - получает все строчки псевдонимов домена.

Описание

array vpopmail_alias_get_all (string domain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_auth_user

(PHP 4 >= 4.0.5)

vpopmail_auth_user - пытается проверить username/domain/password. Возвращает true/false.

Описание

bool vpopmail_auth_user (string user, string domain, string password [, string apop])

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_del_domain

(PHP 4 >= 4.0.5)

vpopmail_del_domain - удаляет виртуальный домен.

Описание

bool vpopmail_del_domain (string domain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_del_domain_ex

(PHP 4 >= 4.0.5)

vpopmail_del_domain_ex - удаляет виртуальный домен.

Описание

bool vpopmail_del_domain_ex (string domain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_del_user

(PHP 4 >= 4.0.5)

vpopmail_del_user - удаляет пользователя из виртуального домена.

Описание



bool vpopmail_del_user (string user, string domain)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_error

(PHP 4 >= 4.0.5)

vpopmail_error - получает текстовое сообщение для последней vpopmail-ошибки. Возвращает string.

Описание

string vpopmail_error (void)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_passwd

(PHP 4 >= 4.0.5)

vpopmail_passwd - изменяет пароль виртуального пользователя.

Описание

bool vpopmail_passwd (string user, string domain, string password)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vpopmail_set_user_quota

(PHP 4 >= 4.0.5)

vpopmail_set_user_quota - устанавливает квоту виртуального пользователя.

Описание

bool vpopmail_set_user_quota (string user, string domain, string quota)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

vprintf

(PHP 4 >= 4.1.0)

vprintf - выводит отформатированную строку.

Описание

void vprintf (string format, array args)

Отображает значения массива как форматированную строку в соответствии с format (который описан в документации для sprintf()).

Работает как printf(), но принимает массив аргументов, а не переменное количество аргументов.

См. также printf(), sprintf(), vsprintf().

vsprintf

(PHP 4 >= 4.1.0)

vsprintf - возвращает отформатированную строку.

Описание

string vsprintf (string format, array args)

Возвращает значения массива в виде отформатированной строки в соответствии с format (описан в документации к sprintf()).

Работает как sprintf(), но принимает массив аргументов, а не переменное количество аргументов.

См. также sprintf(), vprintf().

w32api_deftype

(PHP 4 >= 4.2.0)

w32api_deftype - определяет тип для использования с другими w32api_функциями.

Описание

int w32api_deftype (string typename, string member1_type, string member1_name)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

w32api_init_dtype

(PHP 4 >= 4.2.0)

w32api_init_dtype - создаёт экземпляр типа typename данных и заполняет его значениями val1, val2, затем возвращает DYNAPARM, который затем может быть передан как параметр при вызове функции.

Описание

resource w32api_init_dtype (string typename, mixed val1, mixed val2)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

w32api_invoke_function

(PHP 4 >= 4.2.0)

w32api_invoke_function - вызывает функцию funcname с аргументами, переданными после имени функции.

Описание

mixed w32api_invoke_function (string funcname)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

w32api_register_function

(PHP 4 >= 4.2.0)

w32api_register_function - регистрирует функцию function_name из библиотеки с PHP.

Описание

bool w32api_register_function (string libary, string function_name)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

w32api_set_call_method

(PHP 4 >= 4.2.0)

w32api_set_call_method - устанавливает используемый вызывающий метод.

Описание

void w32api_set_call_method (int method)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

wddx_add_vars

(PHP 3>= 3.0.7, PHP 4)

wddx_add_vars - добавляет переменные в пакет WDDX со специфицированным ID.

Описание

wddx_add_vars (int packet_id, mixed name_var [, mixed ...])

wddx_add_vars() используется для сериализации переданных переменных м добавления результата в пакет packet_id. Переменные для сериализации специфицируются точно так же, как и wddx_serialize_vars().

wddx_deserialize

(PHP 3>= 3.0.7, PHP 4)

wddx_deserialize - десериализует WDDX-пакет.

Описание

mixed wddx_deserialize (string packet)

wddx_deserialize() принимает строку packet и десериализует её. Возвращает результат, который может быть string, number или array. Обратите внимание, что структуры десериализуются в ассоциативные массивы.

wddx_packet_end

(PHP 3>= 3.0.7, PHP 4)

wddx_packet_end - заканчивает WDDX-пакет со специфицированным ID.

Описание

string wddx_packet_end (int packet_id)

wddx_packet_end() заканчивает WDDX-пакет packet_id и возвращает string с пакетом.

wddx_packet_start

(PHP 3>= 3.0.7, PHP 4)

wddx_packet_start - стартует новый WDDX-пакет со структурой внутри него.

Описание

int wddx_packet_start ([string comment])

wddx_packet_start() начинает новый WDDX-пакет для инкрементального  добавления переменных. Принимает необязательную строку comment и возвращает ID пакета для использования в других функциях. Автоматически создаёт определение структуры внутри пакета для содержания переменных.

wddx_serialize_value

(PHP 3>= 3.0.7, PHP 4)

wddx_serialize_value - сериализует одно значение в WDDX-пакет.

Описание

string wddx_serialize_value (mixed var [, string comment])

wddx_serialize_value() используется для создания WDDX-пакета из единственного заданного значения. Принимает значение var и необязательную строку comment, которое появляется в шапке/header пакета, и возвращает WDDX-пакет.

wddx_serialize_vars

(PHP 3>= 3.0.7, PHP 4)

wddx_serialize_vars - сериализует переменные в WDDX-пакет.

Описание

string wddx_serialize_vars (mixed var_name [, mixed ...])

wddx_serialize_vars() используется для создания WDDX-пакета со структурой, содержащий сериализованные представления переданных переменных.

wddx_serialize_vars() принимает переменное количество аргументов, каждый из которых может быть либо строкой с именем переменной, либо массивом, содержащим строки с именами переменных или другой массив, etc.

SWFMorph

(PHP 4 >= 4.0.5)

SWFMorph - создаёт новый SWFMorph-объект.

Описание

new swfmorph (void)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

Называется также "shape tween".

Методы здесь несколько странные. Было бы понятнее просто newSWFMorph(shape1, shape2);, но, поскольку имеем то, что имеем, необходим shape2 как вторая часть morph. (Это потому что она начинает записывать свой вывод сразу при получении команд рисования - она сохраняет своё собственное описание фигур, и записывать это и ещё некоторые вещи по завершении было бы намного проще.)

SWFMorph имеет следующие методы: swfmorph->getshape1() и swfmorph->getshape1().

В примере morph большой красный квадрат в маленький голубой квадрат с чёрной рамкой.

wordwrap

(PHP 4 >= 4.0.2)

wordwrap - делает перенос строки на данное количество символов с использованием символа разрыва строки.

Описание

string wordwrap (string str [, int width [, string break [, int cut]]])

Возвращает строку str с переносом в столбце с номером, специфицированным (необязательным) параметром width. Строчка разрывается с помощью (необязательного) параметра break.

wordwrap() автоматически переносит в столбце 75 и разрывает с использованием '\n' (newline), если width и break не заданы.

Если cut равен 1, строка всегда переносится на специфицированную ширину. Поэтому, если у вас имеется слово, которое больше данной ширины, оно разрывается. (См. второй пример).

Примечание: необязательный параметр cut был введён в PHP 4.0.3.

xml_error_string

(PHP 3>= 3.0.6, PHP 4)

xml_error_string - получает строку ошибки XML-разборщика.

Описание

string xml_error_string (int code)

code

Код ошибки из xml_get_error_code().

Возвращает строку с текстовым описанием кода ошибки code, или FALSE, если описание не найдено.

xml_get_current_byte_index

(PHP 3>= 3.0.6, PHP 4)

xml_get_current_byte_index - получает индекс текущего байта для XML-разборщика.

Описание

int xml_get_current_byte_index (resource parser)

parser

Ссылка на XML-разборщик для получения индекса байта.

Эта функция возвращает FALSE, если parser не ссылается на правильный разборщик, иначе возвращает, индекс байта, в котором находится разборщик в данный момент в своём буфере данных (начиная с 0).

xml_get_current_column_number

(PHP 3>= 3.0.6, PHP 4)

xml_get_current_column_number - получает номер текущего столбца для XML-разборщика.

Описание

int xml_get_current_column_number (resource parser)

parser

Ссылка на XML-разборщик для получения номера столбца.

Эта функция возвращает FALSE, если parser не ссылается на правильный разборщик, либо возвращает, в каком столбце на текущей строчке (как задано в xml_get_current_line_number()) находится разборщик.

xml_get_current_line_number

(PHP 3>= 3.0.6, PHP 4)

xml_get_current_line_number - получает номер текущей строчки для XML-разборщика.

Описание

int xml_get_current_line_number (resource parser)

parser

Ссылка на XML-разборщик для получения номера строчки.

Эта функция возвращает FALSE, если parser не ссылается на правильный разборщик, либо возвращает, в какой строчке находится в данный момент разборщик в своём буфере данных.

xml_get_error_code

(PHP 3>= 3.0.6, PHP 4)

xml_get_error_code - получает код ошибки XML-разборщика.

Описание

int xml_get_error_code (resource parser)

parser

Ссылка на XML-разборщик для получения кода ошибки.

Эта функция возвращает FALSE, если parser не ссылается на правильный разборщик, либо возвращает один из кодов ошибки, перечисленных в разделе кодов ошибки.

xml_parse

(PHP 3>= 3.0.6, PHP 4)

xml_parse - начинает разбор XML-документа.

Описание

bool xml_parse (resource parser, string data [, bool is_final])

parser

Ссылка на XML-разборщик.

data

Участок данных для разбора. Документ может разбираться по кускам с помощью вызова xml_parse() несколько раз с новыми данными о тех пор, пока параметр is_final не будет установлен и TRUE, когда разбираются последние данные.

is_final (optional)

Если установлен и TRUE, data это последний блок данных, отправленных при этом разборе.

Когда разбирается XML-документ, обработчики сконфигурированных событий вызываются столько раз, сколько нужно, после чего функция возвращает TRUE или FALSE.

TRUE возвращается, если разбор был успешным, FALSE - если не был успешным или если parser не ссылается на правильный разборщик. Для неуспешных разборов информация ошибки может быть получена с помощью xml_get_error_code(), xml_error_string(), xml_get_current_line_number(), xml_get_current_column_number() и xml_get_current_byte_index().

xml_parse_into_struct

(PHP 3>= 3.0.8, PHP 4)

xml_parse_into_struct - разбирает XML-данные в структуру массива.

Описание

int xml_parse_into_struct (resource parser, string data, array &values, array &index)

Эта функция разбирает XML-файл на две параллельные структуры: одна из которых (index) содержит указатели на местонахождение соответствующих значений в массиве values array. Последние два параметра обязаны передаваться по ссылке.

Пример иллюстрирует внутреннюю структуру сгенерированных массивов. Мы используем простой тэг note, встроенный в тэг para, а затем разбираем это и выводим сгенерированные структуры:

xml_parser_create

(PHP 3>= 3.0.6, PHP 4)

xml_parser_create - создаёт XML-разборщик.

Описание

resource xml_parser_create ([string encoding])

encoding (optional)

Какую кодировку символов должен использовать разборщик.

Поддерживаются следующие кодировки символов:ISO-8859-1 (по умолчанию) US-ASCIIUTF-8

Эта функция создаёт XML-разборщик и возвращает дескриптор для использования другими XML-функциями. Возвращает FALSE при неудаче.

xml_parser_create_ns

(PHP 4 >= 4.0.5)

xml_parser_create_ns - создаёт XML-разборщик.

Описание

resource xml_parser_create_ns ([string encoding [, string sep]])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xml_parser_free

(PHP 3>= 3.0.6, PHP 4)

xml_parser_free - освобождает XML-разборщик.

Описание

bool xml_parser_free (resource parser)

parser

Ссылка на XML-разборщик.

Эта функция возвращает FALSE, если parser не ссылается на правильный разборщик, иначе освобождает разборщик и возвращает TRUE.

xml_parser_get_option

(PHP 3>= 3.0.6, PHP 4)

xml_parser_get_option - получает опции для XML-разборщика.

Описание

mixed xml_parser_get_option (resource parser, int option)

parser

Ссылка на XML-разборщик.

option

Какую опцию извлекать. См. в xml_parser_set_option() список опций.

Эта функция возвращает FALSE, если parser не ссылается на правильный разборщик или если опция не может быть установлена.

См. в xml_parser_set_option() список опций.

xml_parser_set_option

(PHP 3>= 3.0.6, PHP 4)

xml_parser_set_option - устанавливает опции XML-разборщика.

Описание

bool xml_parser_set_option (resource parser, int option, mixed value)

parser

Ссылка на XML-разборщик.

option

Какую опцию устанавливать. См. ниже.

value

Новое значение опции.

Эта функция возвращает FALSE, если parser не ссылается на правильный разборщик или если опция не может быть установлена. Иначе опция устанавливается и возвращается TRUE.

Доступные опции:

Таблица 1. Опции XML--разборщика
Константа опцииТип данных Описание>XML_OPTION_CASE_FOLDINGintegerКонтролирует, включено ли выравнивание регистра для данного XML-разборщика. По молчанию включено/Enabled. XML_OPTION_TARGET_ENCODINGstringУстанавливает, какая целевая кодировка используется для этого XML-разборщика. По умолчанию устанавливается та же, что и кодировка источника, использованная функцией xml_parser_create(). Поддерживаемые целевые кодировки: ISO-8859-1, US-ASCII и UTF-8.

xml_set_character_data_handler

(PHP 3>= 3.0.6, PHP 4)

xml_set_character_data_handler - настраивает обработчик символьных данных.

Описание

bool xml_set_character_data_handler (resource parser, string handler)

Устанавливает функцию обработчика символьных данных для XML-разборщика parser.
handler
это строка с именем функции, которая обязана существовать в момент вызова xml_parse() для parser.

Функция, именованная в handler, обязана принимать два параметра: handler (resource parser, string data)

parser

Это ссылка на XML-разборщик, вызывающий обработчик.

data

Второй параметр, data, содержит символьные данные как string.

Если функция обработчика установлена как пустая строка, или FALSE, обработчик отключается/disabled.

TRUE возвращается, если обработчик настроен, а FALSE, если parser не является разборщиком.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

xml_set_default_handler

(PHP 3>= 3.0.6, PHP 4)

xml_set_default_handler - настраивает обработчик по умолчанию.

Описание

bool xml_set_default_handler (resource parser, string handler)

Устанавливает функцию обработчика по умолчанию для XML-разборщика parser.
handler
это строка с именем функции, которая обязана существовать в момент вызова xml_parse() для parser.

Функция, именованная в handler, обязана принимать два параметра: handler (resource parser, string data)

parser

Это ссылка на XML-разборщик, вызывающий обработчик.

data

Второй параметр, data, содержит символьные данные. Это может быть XML-объявление, объявление типа документа, мнемоники или другие данные, для которых нет другого обработчика.

Если функция обработчика установлена как пустая строка, или FALSE, обработчик отключается/disabled.

TRUE возвращается, если обработчик настроен, а FALSE, если parser не является разборщиком.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

xml_set_element_handler

(PHP 3>= 3.0.6, PHP 4)

xml_set_element_handler - настраивает обработчики стартового и конечного элементов.

Описание

bool xml_set_element_handler (resource parser, string start_element_handler, string end_element_handler)

Устанавливает функции обработчиков для XML-разборщика parser.
start_element_handler и end_element_handler это строки, содержащие имена функций, которые обязаны существовать в при вызове xml_parse() для parser.

Функция start_element_handler обязана принимать три параметра: start_element_handler (resource parser, string name, array attribs)

parser

Это ссылка на XML-разборщик, вызывающий обработчик.

name

Содержит имя элемента, для которого вызывается обработчик. Если выравнивание регистра включено для данного разработчика, имя элемента будет в верхнем регистре.

attribs

Содержит ассоциативный массив с атрибутами элемента (если имеются). Ключами этого массива являются имена атрибутов, значения - значения атрибутов. Имена атрибутов получают выравнивание регистра с теми же критериями, что и имена элементов. Регистр значений атрибутов не выравнивается.

Оригинальный порядок атрибутов можно запросить, пройдя по attribs нормальным способом с помощью each(). Первый ключ массива - первый атрибут, и так далее.

Функция end_element_handler обязана принимать два параметра: end_element_handler (resource parser, string name)

parser

Это ссылка на XML-разборщик, вызывающий обработчик.

name

Содержит имя элемента, для которого вызывается обработчик. Если выравнивание регистра включено для этого разборщика, имя элемента будет в верхнем регистре.

Если функция обработчика установлена как пустая строка, или FALSE, обработчик отключается.

TRUE возвращается, если обработчики настроены, а FALSE, если parser не является разборщиком.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

xml_set_end_namespace_decl_handler

(PHP 4 >= 4.0.5)

xml_set_end_namespace_decl_handler - настраивает обработчик символьных данных.

Описание

bool xml_set_end_namespace_decl_handler (resource pind, string hdl)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

xml_set_external_entity_ref_handler

(PHP 3>= 3.0.6, PHP 4)

xml_set_external_entity_ref_handler - настраивает внешний обработчик экземпляров.

Описание

bool xml_set_external_entity_ref_handler (resource parser, string handler)

Устанавливает функцию внешнего обработчика экземпляров для XML-разборщика parser.
handler
это строка с именем функции, которая обязана существовать в момент вызова xml_parse() для parser.

Функция handler обязана принимать 5 параметров и возвращать integer-значение. Если возвращается FALSE (если никакого значения не возвращено), XML-разборщик остановит разбор, а xml_get_error_code() возвратит return XML_ERROR_EXTERNAL_ENTITY_HANDLING.

handler (resource parser, string open_entity_names, string base, string system_id, string public_id)

parser

Это ссылка на XML-разборщик, вызывающий обработчик.

open_entity_names

Это список разделённых пробелами имён мнемоник, открытых для разбора этого экземпляра (включая имя экземпляра).

base

Это база для разрешения системного идентификатора (system_id) внешнего экземпляра/entity. В настоящее время в этот параметр всегда устанавливается пустая строка.

system_id

Это системный идентификатор, как специфицировано в объявлении экземпляра.

public_id

Это public-идентификатор, как специфицировано в объявлении экземпляра, или пустая строка, если ничего не было специфицировано; пробелы в public-идентификаторе будут нормализованы, как требует XML spec.

Если функция обработчика установлена как пустая строка, или FALSE, обработчик отключается/disabled.

TRUE возвращается, если обработчик настроен, а FALSE, если parser не является разборщиком.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

xml_set_notation_decl_handler

(PHP 3>= 3.0.6, PHP 4)

xml_set_notation_decl_handler - настраивает обработчик объявления нотации.

Описание

bool xml_set_notation_decl_handler (resource parser, string handler)

Устанавливает функцию обработчика объявления нотации для XML-разборщика parser.
handler это строка с именем функции, которая обязана существовать в момент вызова xml_parse() для parser.

Объявление нотации является частью ОТД/DTD документа и имеет формат:

xml_set_object

(PHP 4)

xml_set_object - использует XML Parser внутри объекта.

Описание

void xml_set_object (resource parser, object &object)

Эта функция позволяет использовать parser внутри object. Все callback-функции должны быть установлены с помощью xml_set_element_handler() etc и принимаются как методы объекта object.

xml_set_processing_instruction_handler

(PHP 3>= 3.0.6, PHP 4)

xml_set_processing_instruction_handler - настраивает обработчик инструкции процессинга/processing instruction (PI).

Описание

bool xml_set_processing_instruction_handler (resource parser, string handler)

Устанавливает функцию обработчика processing instruction (PI) для XML-разборщика parser.
handler это строка с именем функции, которая обязана существовать в момент вызова xml_parse() для parser.

Инструкция процессинга имеет формат:

<?
target
data?>

Вы можете поместить PHP-код внутрь такого тэга, но имейте в виду ограничение: в XML PI конечный тэг для PI (?>) не может быть в кавычках, поэтому данная последовательность символов не должна появляться в PHP-коде, который вы внедрили с PIs в XML-документы. Если же это так, остаток РНР-кода, а также "реальный" конечный тэг PI, будут рассматриваться как символьные данные.

Функция handler обязана принимать три параметра: handler (resource parser, string target, string data)

parser

Это ссылка на XML-разборщик, вызывающий обработчик.

target

Это цель PI.

data

Содержит PI-данные.

Если функция обработчика установлена как пустая строка, или FALSE, обработчик отключается/disabled.

TRUE возвращается, если обработчик настроен, а FALSE, если parser не является разборщиком.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

xml_set_start_namespace_decl_handler

(PHP 4 >= 4.0.5)

xml_set_start_namespace_decl_handler - настраивает обработчик символьных данных.

Описание

bool xml_set_start_namespace_decl_handler (resource pind, string hdl)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

Примечание: вместо имени функции может быть предоставлен также массив, содержащий ссылку на объект и имя метода.

xml_set_unparsed_entity_decl_handler

(PHP 3>= 3.0.6, PHP 4)

xml_set_unparsed_entity_decl_handler - настраивает обработчик объявления неразобранного экземпляра/unparsed entity.

Описание

bool xml_set_unparsed_entity_decl_handler (resource parser, string handler)

Устанавливает функцию обработчика объявления неразобранного экземпляра для XML-разборщика parser.
handler это строка с именем функции, которая обязана существовать в момент вызова xml_parse() для parser.

Этот обработчик будет вызываться, если XML-разборщик обнаружит объявление внешнего экземпляра с объявлением NDATA, как здесь:

xmlrpc_decode

(PHP 4 >= 4.1.0)

xmlrpc_decode - декодирует XML во встроенные типы PHP.

Описание

array xmlrpc_decode (string xml [, string encoding])

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_decode_request

(PHP 4 >= 4.1.0)

xmlrpc_decode_request - декодирует XML во встроенные типы PHP.

Описание

array xmlrpc_decode_request (string xml, string method [, string encoding])

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_encode

(PHP 4 >= 4.1.0)

xmlrpc_encode - генерирует XML для PHP-значения.

Описание

string xmlrpc_encode (mixed value)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_encode_request

(PHP 4 >= 4.1.0)

xmlrpc_encode_request - генерирует XML для запрашивания метода.

Описание

string xmlrpc_encode_request (string method, mixed params)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_get_type

(PHP 4 >= 4.1.0)

xmlrpc_get_type - получает xmlrpc-тип для PHP-значения. Специально используется для строк base64 и datetime.

Описание

string xmlrpc_get_type (mixed value)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_parse_method_descriptions

(PHP 4 >= 4.1.0)

xmlrpc_parse_method_descriptions - декодирует XML в список описаний методов.

Описание

array xmlrpc_parse_method_descriptions (string xml)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_server_add_introspection_data

(PHP 4 >= 4.1.0)

xmlrpc_server_add_introspection_data - добавляет интроспективную документацию.

Описание

int xmlrpc_server_add_introspection_data (resource server, array desc)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_server_call_method

(PHP 4 >= 4.1.0)

xmlrpc_server_call_method - разбирает XML-запросы и вызывает методы.

Описание

mixed xmlrpc_server_call_method (resource server, string xml, mixed user_data [, array output_options])

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_server_create

(PHP 4 >= 4.1.0)

xmlrpc_server_create - создаёт xmlrpc-сервер.

Описание

resource xmlrpc_server_create (void)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. >Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_server_destroy

(PHP 4 >= 4.1.0)

xmlrpc_server_destroy - разрушает ресурсы сервера.

Описание

void xmlrpc_server_destroy (resource server)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_server_register_introspection_callback

(PHP 4 >= 4.1.0)

xmlrpc_server_register_introspection_callback - регистрирует РНР-функцию для генерации документации.

Описание

bool xmlrpc_server_register_introspection_callback (resource server, string function)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_server_register_method

(PHP 4 >= 4.1.0)

xmlrpc_server_register_method - регистрирует РНР-функцию для совпадения метода ресурса с method_name.

Описание

bool xmlrpc_server_register_method (resource server, string method_name, string function)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xmlrpc_set_type

(PHP 4 >= 4.1.0)

xmlrpc_set_type - устанавливает xmlrpc-тип, base64 или datetime, для строкового значения PHP.

Описание

bool xmlrpc_set_type (string value, string type)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск. Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xpath_eval

(PHP 4 >= 4.0.4)

xpath_eval - вычисляет XPath Location Path в данной строке.

Описание

array xpath_eval (object xpath context)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

См. также xpath_new_context().

xpath_eval_expression

(PHP 4 >= 4.0.4)

xpath_eval_expression - вычисляет XPath Location Path в данной строке.

Описание

array xpath_eval_expression (object xpath_context)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

См. также xpath_eval().

xpath_new_context

(PHP 4 >= 4.0.4)

xpath_new_context - создаёт новый xpath-контекст.

Описание

object xpath_new_context (object dom document)

Предупреждение!Эта функция - ЭКСПЕРИМЕНТАЛЬНАЯ. Поведение, имя и всё остальное, что задокументировано для данной функции может быть изменено в будущих релизах РНР без предупреждения. Вы можете использовать эту функцию только на свой страх и риск.

См. также xpath_eval().

xptr_eval

(PHP 4 >= 4.0.4)

xptr_eval - вычисляет XPtr Location Path в данной строке.

Описание

int xptr_eval ([object xpath_context, string eval_str])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xptr_new_context

(PHP 4 >= 4.0.4)

xptr_new_context - создаёт новый XPath Context.

Описание

string xptr_new_context ([object doc_handle])

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xslt_create

(PHP 4 >= 4.0.3)

xslt_create - создаёт новый XSLT-процессор.

Описание

resource xslt_create (void)

Создаёт и возвращает ресурс нового XSLT-процессора для манипуляций с другими функциями XSLT.

xslt_errno

(PHP 4 >= 4.0.3)

xslt_errno - возвращает номер ошибки.

Описание

int xslt_errno (resource xh)

Возвращает error-код, описывающий последнюю ошибку, возникшую в переданном XSLT-процессоре.

xslt_error

(PHP 4 >= 4.0.3)

xslt_error - возвращает строку ошибки.

Описание

mixed xslt_error (resource xh)

Возвращает строку с описанием последней ошибки, возникшей в переданном XSLT-процессоре.

xslt_free

(PHP 4 >= 4.0.3)

xslt_free - освобождает XSLT-процессор.

Описание

void xslt_free (resource xh)

Освобождает XSLT-процессор, идентифицированный заданным дескриптором.

xslt_process

(PHP 4 >= 4.0.3)

xslt_process - выполняет XSLT-трансформацию.

Описание

mixed xslt_process (resource xh, string xml, string xsl [, string result [, array arguments [, array parameters]]])

xslt_process() это краеугольный камень нового расширения XSLT. Она даёт возможность выполнять XSLT-трансформацию с использованием почти всех типов источников ввода. Это делается с помощью буферов аргументов -- концепции, взятой из Sablotron XSLT-процессора (в настоящее время - единственного XSLT-процессора, который поддерживается данным расширением).

Самая простая трансформация функцией xslt_process() - это трансформация XML-файла XSLT-файлом с помещением результата в третий файл, содержащий новый XML (или HTML)-документ. Сделать это с помощью sablotron действительно довольно легко ...

xslt_set_base

(PHP 4 >= 4.0.5)

xslt_set_base - устанавливает базовый URI для всех XSLT-трансформаций.

Описание

void xslt_set_base (resource xh, string uri)

Устанавливает базовый URI для всех XSLT-трансформаций. Этот базовый URI используется с инструкциями Xpath для разрешения document() и других команд, имеющих доступ к внешним ресурсам.

xslt_set_encoding

(PHP 4 >= 4.0.5)

xslt_set_encoding - устанавливает кодировку для разбора XML-документов.

Описание

void xslt_set_encoding (resource xh, string encoding)

Устанавливает кодировку вывода для XSLT-трансформаций. При использовании с Sablotron backend эта опция доступна, только если вы компилируете Sablotron с поддержкой кодировки.

xslt_set_error_handler

(PHP 4 >= 4.0.4)

xslt_set_error_handler - устанавливает обработчик ошибок для XSLT-процессора.

Описание

void xslt_set_error_handler (resource xh, mixed handler)

Устанавливает функцию обработчика ошибок для XSLT-процессора xh. Эта функция будет вызываться при возникновении ошибки в XSLT-трансформации (вызывается также для уведомлений/notices).

xslt_set_log

(PHP 4 >= 4.0.6)

xslt_set_log - устанавливает log-файл для записи log-сообщений.

Описание

void xslt_set_log (resource xh, mixed log)

xh

Ссылка на XSLT-разборщик.

log

Булево значение, включающее/выключающее логинг, либо строковая константа, содержащая logfile, в который также записываются ошибки.

Эта функция позволяет установить файл, в который записываются XSLT log-сообщения. XSLT log-сообщения отличаются от error-сообщений тем, что log-сообщения не являются на самом деле error-сообщениями, а относятся к статусу процессора XSLT. Они используются при отладке XSLT, когда что-то не так.

По умолчанию логинг отключён; для его включения вы обязаны сначала вызывать xslt_set_log() с булевым параметром, включающим логинг, затем, если вы хотите установить log-файл для отладки, вы обязаны передать строку с именем файла:

xslt_set_sax_handler

(только 4.0.3 - 4.0.6)

xslt_set_sax_handler - устанавливает SAX-обработчики для XSLT-процессора.

Описание

void xslt_set_sax_handler (resource xh, array handlers)

Устанавливает SAX-обработчики в данном дескрипторе ресурса xh. SAX-обработчики должны быть двухмерным массивом в формате (все элементы верхнего уровня являются необязательными):

array(
[document] =>
array(
start document handler,
end document handler
),
[element] =>
array(
start element handler,
end element handler
),
[namespace] =>
array(
start namespace handler,
end namespace handler
),
[comment] => comment handler,
[pi] => processing instruction handler,
[character] => character data handler
)

xslt_set_sax_handlers

(PHP 4 >= 4.0.6)

xslt_set_sax_handlers - устанавливает SAX-обработчики, вызываемые при процессинге XML-документа.

Описание

void xslt_set_sax_handlers (resource processor, array handlers)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

xslt_set_scheme_handler

(только 4.0.5 - 4.0.6)

xslt_set_scheme_handler - устанавливает Scheme-обработчики для XSLT-процессора.

Описание

void xslt_set_scheme_handler (resource xh, array handlers)

Устанавливает Scheme-обработчики в дескрипторе ресурса xh. Scheme-обработчики должны быть массивом в формате (все элементы необязательны):

xslt_set_scheme_handlers

(PHP 4 >= 4.0.6)

xslt_set_scheme_handlers - устанавливает scheme-обработчики для XSLT-процессора.

Описание

void xslt_set_scheme_handlers (resource processor, array handlers)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

yaz_addinfo

(PHP 4 >= 4.0.1)

yaz_addinfo - возвращает дополнительную информацию об ошибке.

Описание

int yaz_addinfo (int id)

Возвращает дополнительное сообщение об ошибке для цели (последнего запроса). Возвращается пустая строка, если последняя операция была успешной или если целью не было предоставлено никакой дополнительной информации.

yaz_ccl_conf

(PHP 4 >= 4.0.5)

yaz_ccl_conf - конфигурирует CCL-разборщик.

Описание

int yaz_ccl_conf (int id, array config)

Эта функция конфигурирует CCL-разборщик запросов для цели/target с определениями точек доступа (CCL-квалификаторов) и их отображения в RPN. Для отображения специфического CCL-запроса/query в RPN вызовите затем yaz_ccl_parse(). Каждый индекс массива config это имя CCL-поля и соответствующее значение, содержащее строку, которая специфицирует отображение в RPN. Отображение это последовательность пар attribute-type, attribute-value. Attribute-type и attribute-value разделены знаком равенства (=). Каждая пара отделяется пробелом.

yaz_ccl_parse

(PHP 4 >= 4.0.5)

yaz_ccl_parse - вызывает CCL Parser.

Описание

int yaz_ccl_parse (int id, string query, array & result)

Эта функция вызывает CCL-разборщик. Она конвертирует заданный CCL FIND query в RPN query, который может быть передан функции yaz_search() для выполнения поиска. Для определения набора правильных CCL-полей вызовите yaz_ccl_conf() до вызова этой функции. Если предоставленный query был успешно конвертирован в RPN, эта функция возвращает TRUE, а индекс rpn предоставленного массива result будет содержать правильный RPN query. Если запрос/query не может быть конвертирован (из-за неправильного синтаксиса, неизвестного поля, etc.), эта функция возвращает FALSE, а три индекса устанавливаются в результирующем массиве для обозначения случая облома: errorcodeCCL error-код (integer), errorstringCCL error-строка и errorpos приблизительная позиция в запросе при обломе (integer это позиция символа).

yaz_close

(PHP 4 >= 4.0.1)

yaz_close - закрывает YAZ-соединение.

Описание

int yaz_close (int id)

Закрывает Z-ассоциацию, заданную параметром id. Этот id является целевым ID, возвращённым из предыдущим вызовом команды yaz_connect().

yaz_connect

(PHP 4 >= 4.0.1)

yaz_connect - готовит соединение и Z-ассоциацию к Z39.50-цели.

Описание

int yaz_connect (string zurl [, mixed options])

Эта функция возвращает положительный ID при успехе; нуль при неудаче.

yaz_connect() готовит к соединению с Z39.50-целью. Аргумент zurl имеет форму host[:port][/database]. Если port опущен, используется 210. Если database опущен, используется БД по умолчанию. Эта функция является не-блокирующей и не пытается установить сокет - она лишь готовит соединение для выполнения в дальнейшем при вызове yaz_wait().

Если второй аргумент options задан как string, он рассматривается как Z39.50 V2-строка аутентификации (OpenAuth).

Если options задан как массив, содержимое этого массива служит options/опциями. Заметьте, что массив options поддерживается только для PHP 4.1.0 и новее.

Опции yaz_connect()

user

Username для аутентификации.

group

Group для аутентификации.

password

Password для аутентификации.

cookie

Кука для сессии (YAZ proxy).

proxy

Proxy для соединения (YAZ proxy).

persistent

boolean. Если TRUE, соединение постоянное/persistent; если FALSE, соединение не постоянное. По умолчанию соединения постоянные.

piggyback

boolean. Если TRUE, piggyback включён для поиска; если FALSE, piggyback отключён. По умолчанию включён/enabled. Включение piggyback более эффективно и обычно уменьшает количество сетевых операций при первых извлечениях записей. Однако некоторые Z39.50-цели/targets не поддерживают piggyback или игнорируют имена набора элементов. Для таких целей piggyback должен быть отключён.

yaz_database

(PHP 4 >= 4.0.6)

yaz_database - специфицирует базы данных в сессии.

Описание

int yaz_database (int id, string databases)

Эта функция специфицирует одну или более БД для использования в поиске, запрашивании, etc. - переопределяя БД, специфицированные вызовом функции yaz_connect(). Несколько БД разделяются знаком плюс (+).

Эта функция позволяет использовать разные наборы БД внутри сессии.

Возвращает TRUE при успехе; FALSE при ошибке.

yaz_element

(PHP 4 >= 4.0.1)

yaz_element - специфицирует имя Element-Set для запрашивания.

Описание

int yaz_element (int id, string elementset)

Эта функция используется в сочетании с yaz_search() и yaz_present() для специфицирования имени набора элементов для запрашивания записей. Большинство серверов поддерживают F (full) и B (brief).

Возвращает TRUE при успехе; FALSE при ошибке.

yaz_errno

(PHP 4 >= 4.0.1)

yaz_errno - возвращает номер ошибки.

Описание

int yaz_errno (int id)

Возвращает ошибку для цели/target (последнего запроса). Возвращается положительное значение, если target возвращает код диагностики; нуль - если ошибок нет (успешно); отрицательное значение - для прочих ошибок (таких, когда target закрывает соединение, etc).

yaz_errno() должна вызываться после сетевой активности для каждой target - (после возвратов из yaz_wait()) для определения успеха/облома последней операции (например, поиска).

yaz_error

(PHP 4 >= 4.0.1)

yaz_error - возвращает описание ошибки.

Описание

string yaz_error (int id)

Возвращает error-сообщение для цели/target (последнего запроса). Возвращается пустая строка, если последняя операция прошла успешно.

yaz_error() возвращает текстовое сообщение на английском языке, соответствующее номеру последней ошибки, как при возвращении из yaz_errno().

yaz_hits

(PHP 4 >= 4.0.1)

yaz_hits - возвращает номер совпадения в ходе последнего поиска.

Описание

int yaz_hits (int id)

yaz_itemorder

(PHP 4 >= 4.0.5)

yaz_itemorder - готовит для Z39.50 Item Order с пакетом ILL-Request.

Описание

int yaz_itemorder (array args)

Эта функция готовит к запрашиванию Extended Services с использованием Profile для использования Z39.50 Item Order Extended Service для Transport ILL (Profile/1). См. здесь и спецификацию. Параметр args обязан быть хэш-массивом с информацией об отправляемом Item Order-запросе. Ключ хэша это имя соответствующего пути ASN.1-тэга. Например, ISBN ниже Item-ID имеет ключ item-id,ISBN.

Параметры ILL-Request/Запроса:

protocol-version-num
transaction-id,initial-requester-id,person-or-institution-symbol,person
transaction-id,initial-requester-id,person-or-institution-symbol,institution
transaction-id,initial-requester-id,name-of-person-or-institution,name-of-person
transaction-id,initial-requester-id,name-of-person-or-institution,name-of-institution
transaction-id,transaction-group-qualifier
transaction-id,transaction-qualifier
transaction-id,sub-transaction-qualifier
service-date-time,this,date
service-date-time,this,time
service-date-time,original,date
service-date-time,original,time
requester-id,person-or-institution-symbol,person
requester-id,person-or-institution-symbol,institution
requester-id,name-of-person-or-institution,name-of-person
requester-id,name-of-person-or-institution,name-of-institution
responder-id,person-or-institution-symbol,person
responder-id,person-or-institution-symbol,institution
responder-id,name-of-person-or-institution,name-of-person
responder-id,name-of-person-or-institution,name-of-institution
transaction-type
delivery-address,postal-address,name-of-person-or-institution,name-of-person
delivery-address,postal-address,name-of-person-or-institution,name-of-institution
delivery-address,postal-address,extended-postal-delivery-address
delivery-address,postal-address,street-and-number
delivery-address,postal-address,post-office-box
delivery-address,postal-address,city
delivery-address,postal-address,region
delivery-address,postal-address,country
delivery-address,postal-address,postal-code
delivery-address,electronic-address,telecom-service-identifier
delivery-address,electronic-address,telecom-service-addreess
billing-address,postal-address,name-of-person-or-institution,name-of-person
billing-address,postal-address,name-of-person-or-institution,name-of-institution
billing-address,postal-address,extended-postal-delivery-address
billing-address,postal-address,street-and-number
billing-address,postal-address,post-office-box
billing-address,postal-address,city
billing-address,postal-address,region
billing-address,postal-address,country
billing-address,postal-address,postal-code
billing-address,electronic-address,telecom-service-identifier
billing-address,electronic-address,telecom-service-addreess
ill-service-type
requester-optional-messages,can-send-RECEIVED
requester-optional-messages,can-send-RETURNED
requester-optional-messages,requester-SHIPPED
requester-optional-messages,requester-CHECKED-IN
search-type,level-of-service
search-type,need-before-date
search-type,expiry-date
search-type,expiry-flag
place-on-hold
client-id,client-name
client-id,client-status
client-id,client-identifier
item-id,item-type
item-id,call-number
item-id,author
item-id,title
item-id,sub-title
item-id,sponsoring-body
item-id,place-of-publication
item-id,publisher
item-id,series-title-number
item-id,volume-issue
item-id,edition
item-id,publication-date
item-id,publication-date-of-component
item-id,author-of-article
item-id,title-of-article
item-id,pagination
item-id,ISBN
item-id,ISSN
item-id,additional-no-letters
item-id,verification-reference-source
copyright-complicance
retry-flag
forward-flag
requester-note
forward-note
 

Есть также несколько параметров, являющихся частью пакета Extended Services Request и пакета ItemOrder:

package-name
user-id
contact-name
contact-phone
contact-email
itemorder-item

yaz_present

(PHP 4 >= 4.0.5)

yaz_present - готовит для запрашивания (Z39.50 существует).

Описание

int yaz_present (void)

Эта функция готовит для запрашивания записей после успешного поиска. yaz_range() должна вызываться до этой функции, чтобы специфицировать диапазон запрашиваемых записей.

yaz_range

(PHP 4 >= 4.0.1)

yaz_range - специфицирует максимальное количество записей для запрашивания.

Описание

int yaz_range (int id, int start, int number)

Эта функция используется вместе с yaz_search() для специфицирования максимального количества записей для запрашивания (number) и начальной позиции первой записи (start). Если эта функция не вызывается (а только yaz_search()), start устанавливается 1, а number устанавливается 10.

Возвращает TRUE при успехе; FALSE при ошибке.

yaz_record

(PHP 4 >= 4.0.1)

yaz_record - возвращает запись.

Описание

int yaz_record (int id, int pos, string type)

Возвращает запись/record в данной позиции или путую строку, если в данной позиции запись не существует.

yaz_record() проверяет запись в текущем результирующем наборе в специфицированной позиции. Если запись в БД не существует в данной позиции, возвращается пустая строка. Аргумент type специфицирует форму возвращаемой записи. Если type равен "string", запись возвращается как строковое представление, пригодное для печати (для XML и SUTRS). Если type равен "array", запись возвращается как массив (для структурированных записей).

yaz_scan

(PHP 4 >= 4.0.5)

yaz_scan - готовит к сканированию.

Описание

int yaz_scan (int id, string type, string startterm [, array flags])

Эта функция для Z39.50 Scan Request. Аргумент id специфицирует целевой ID. Точка стартового термина задана параметром startterm. Форма, в которой специфицирован starting term, задаётся параметром type. В настоящее время поддерживается type rpn. Необязательный flags специфицирует дополнительную информацию для управления поведением scan-запроса. В настоящее время из flags читаются три индекса: number (количество запрошенных терминов), position (предпочтительная позиция для term) и stepSize (предпочтительный размер шага/step). Для реального трансфера Scan Request в цель и получения Scan Response обязана вызываться функция yaz_wait(). По завершении yaz_wait() вызывайте yaz_error() и yaz_scan_result() для обработки ответа.

Синтаксис startterm аналогичен RPN query, как описано в yaz_search(). Параметр startterm состоит из нуль или более спецификаций @attr-операции, с последующей единственной лексемой/token.

yaz_scan_result

(PHP 4 >= 4.0.5)

yaz_scan_result - возвращает результат Scan Response.

Описание

array yaz_scan_result (int id [, array & result])

При данном целевом ID эта функция возвращает массив терминов, полученных из цели/target в последнем Scan Response. Эта функция возвращает массив (0..n-1), где n это количество возвращённых терминов. Каждое значение массива является парой, где первый элемент это термин/term, второй - result-count. Если result задан, он будет модифицирован для содержания дополнительной информации , принятой от Scan Response: number (количество возвращённых вхождений), stepsize (размер шага), position (позиция термина), status (Scan Status).

yaz_search

(PHP 4 >= 4.0.1)

yaz_search - готовит для поиска.

Описание

int yaz_search (int id, string type, string query)

yaz_search() готовит для поиска в цели/target с заданным id. Аргумент type представляет тип запроса - только "rpn" поддерживается сейчас, и в этом случае третий аргумент специфицирует Type-1 query (RPN). Как и yaz_connect(), эта функция является не-блокирующей и только подготавливает поиск, выполняемый позднее при вызове yaz_wait().

RPN query/запрос

RPN query это текстуальное представление Type-1 query, как определено в стандарте Z39.50. Однако в текстовом представлении в YAZ используется префиксная нотация, то есть операция предшествует операнду. Строка запроса/query string это последовательность лексем, где пробел игнорируется, если не окружён двойными кавычками. Лексемы, начинающиеся с at-символа (@), считаются операциями, иначе они рассматриваются как термины поиска.

Таблица 1. RPN-операции
СинтаксисОписание @and query1 query2пересечение query1 и query2 @or query1 query2union/объединение query1 и query2 @not query1 query2query1, и не query2@set nameссылка на результирующий набор @attrset set queryспецифицирует attribute-set для запроса. Эта конструкция допускается только однократно - в начале всего запроса/query@attr set type=value queryприменяет атрибут к запросу. type и value это целые числа, специфицирующие attribute-type и attribute-value соответственно.
set, если задан, специфицирует attribute-set.

yaz_sort

(PHP 4 >= 4.1.0)

yaz_sort - устанавливает критерий сортировки.

Описание

int yaz_sort (int id, string criteria)

Эта функция устанавливает критерий сортировки и включает Z39.50 Sort. Используйте её вместе с yaz_search() или yaz_present(). Отдельное использование не даст никакого эффекта. Если используется с yaz_search(), a Z39.50 Sort будет отправлен после получения ответа поиска и до запрашивания записей с помощью Z39.50 Present.

criteria имеет форму:

field1 flags1 field2 flags2 ...

где field1 специфицирует первичные атрибуты сортировки: секунды field2, etc... Поле/field специфицирует либо комбинации числовых атрибутов, состоящие из пар type=value, разделённых запятой (например, 1=4,2=1), или обычный строковой критерий (например, title. Аргумент flags это последовательность нижеследующих символов, которые могут быть не разделены пробелами:

Флаги сортировки

a

Сортировка в порядке возврастания

d

Сортировка в порядке убывания

i

Сортировка без учёта регистра символов

s

Сортировка с учётом регистра символов

Пример 1. Критерии сортировки

Для сортировки по заголовку Bib1-атрибута, без учёта регистра и по восходящей вы должны использовать следующий критерий сортировки:

1=4 ia

Если вторым критерием сортировки должен быть author, без учёта регистра и по восходящей, вы используете:

yaz_syntax

(PHP 4 >= 4.0.1)

yaz_syntax - специфицирует предпочтительный синтаксис записи для запрашивания.

Описание

int yaz_syntax (int id, string syntax)

Этот синтаксис специфицируется как OID (Object Identifier) в сырой dot-нотации (вроде 1.2.840.10003.5.10) или как один из известных зарегистрированных синтаксисов записи (sutrs, usmarc, grs1, xml, etc.). Эта функция используется вместе с yaz_search() и yaz_present() для специфицирования предпочтительного синтаксиса записей для запрашивания.

yaz_wait

(PHP 4 >= 4.0.1)

yaz_wait - ожидает завершения Z39.50-запросов.

Описание

int yaz_wait ([ array options])

Эта функция выполняет сетевую работу (блокированную) по выполнению отдельных запросов/requests, которые подготовлены функциями yaz_connect(), yaz_search(), yaz_present(), yaz_scan() и yaz_itemorder(). yaz_wait() возвращает, когда все цели/targets либо выполнили все запросы, либо прерваны (при наличии ошибок).

Если массив options задан, то опция в нём, изменяющая поведение yaz_wait():

timeout

устанавливает таймаут в секундах. Если target не отвечает в течение timeout, она считается dead/дохлой и yaz_wait() возвращает. По умолчанию значение timeout равно 15 секундам.

yp_all

(PHP 4 >= 4.0.6)

yp_all - проходит по катре/map и вызывает функцию для каждого вхождения.

Описание

void yp_all (string domain, string map, string callback)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

yp_cat

(PHP 4 >= 4.0.6)

yp_cat - возвращает массив, содержащий всю карту/map.

Описание

array yp_cat (string domain, string map)

Предупреждение!Эта функция в настоящее время ещё не задокументирована; имеется только список аргументов.

yp_err_string

(PHP 4 >= 4.0.6)

yp_err_string - возвращает строку ошибки, ассоциированной с предыдущей операцией.

Описание

string yp_err_string (void)

yp_err_string() возвращает сообщение об ошибке, ассоциированной с предыдущей операцией. Используется для указания на точную причину ошибки.

yp_errno

(PHP 4 >= 4.0.6)

yp_errno - возвращает error-код предыдущей операции.

Описание

int yp_errno (void)

Возможные ошибки:

1 неправильные аргументы для функции2 RPC облом - домен отвязан 3 не может привязать к серверу на этом домене4 нет такой карты на домене сервера 5 нет такого ключа в карте6 внутренняя ошибка yp-сервера или клиента 7 облом с выделением ресурса8 больше нет записей в БД карты 9 не может соединиться с portmapper10 не может соединиться с ypbind 11 не может соединиться с ypserv12 имя локального домена не установлено 13 yp-БД плохая14 ошибка с версией yp15 нарушение прав доступа 16 БД занята

См. также yp_err_string().

yp_first

(PHP 3>= 3.0.7, PHP 4)

yp_first - возвращает первую пару key-value из именованной карты.

Описание

array yp_first (string domain, string map)

yp_first() возвращает первую пару ключ-значение из именованной карты в именованном домене/domain, иначе FALSE.

yp_get_default_domain

(PHP 3>= 3.0.7, PHP 4)

yp_get_default_domain - извлекает NIS-домен по умолчанию данной машины.

Описание

int yp_get_default_domain (void)

yp_get_default_domain() возвращает домен по умолчанию данного узла или FALSE. Можно использовать как параметр domain для последующих вызовов NIS.

NIS-домен может быть описан группой NIS-карт. Каждый хост, который ищет информацию, привязывает себя к определённому домену. Обратитесь к документации, упомянутой в начале, для получения детальной информации.

yp_master

(PHP 3>= 3.0.7, PHP 4)

yp_master - возвращает машинное имя master NIS-сервера для карты.

Описание

string yp_master (string domain, string map)

yp_match

(PHP 3>= 3.0.7, PHP 4)

yp_match - возвращает совпавшую строчку.

Описание

string yp_match (string domain, string map, string key)

yp_match() возвращает значение, ассоциированное с переданным ключом извне данной карты/map или FALSE. Этот ключ обязан быть точным.

yp_next

(PHP 3>= 3.0.7, PHP 4)

yp_next - возвращает следующую пару key-value в именованной карте.

Описание

array yp_next (string domain, string map, string key)

yp_next() возвращает следующую пару key-value в именованной карте после специфицированного ключа или FALSE.

yp_order

(PHP 3>= 3.0.7, PHP 4)

yp_order - возвращает номер порядка для карты.

Описание

int yp_order (string domain, string map)

yp_order() возвращает номер порядка для карты или FALSE.

zend_logo_guid

(PHP 4)

zend_logo_guid - получает zend guid.

Описание

string zend_logo_guid (void)

Примечание: эта функциональность была введена в PHP 4.0.0.

zend_version

(PHP 4)

zend_version - получает текущую версию Zend-машины.

Описание

string zend_version (void)

Возвращает строку с версией текущего работающего PHP-разборщика.

zip_close

(PHP 4 >= 4.1.0)

zip_close - закрывает Zip File Archive.

Описание

void zip_close (resource zip)

Закрывает архивный zip-файл. Параметр zip обязан быть zip-архивом, открытым до этого функцией zip_open().

Эта функция не имеет return-занчения.

См. также zip_open() и zip_read().

zip_entry_close

(PHP 4 >= 4.1.0)

zip_entry_close - закрывает Directory Entry.

Описание

void zip_entry_close (resource zip_entry)

Закрывает вхождение директории, специфицированное параметром zip_entry. Параметр zip_entry обязан быть правильным вхождением директории, открытым функцией zip_entry_open().

Эта функция не имеет return-значения.

См. также zip_entry_open() и zip_entry_read().

zip_entry_compressedsize

(PHP 4 >= 4.1.0)

zip_entry_compressedsize - запрашивает Compressed Size для Directory Entry.

Описание

int zip_entry_compressedsize (resource zip_entry)

Возвращает сжатый размер вхождения директории zip_entry. Параметр zip_entry обязан быть правильным вхождением директории, открытым функцией zip_read().

См. также zip_open() и zip_read().

zip_entry_compressionmethod

(PHP 4 >= 4.1.0)

zip_entry_compressionmethod - запрашивает Compression Method для Directory Entry.

Описание

string zip_entry_compressionmethod (resource zip_entry)

Возвращает метод сжатия для вхождения директории zip_entry. Параметр zip_entry обязан быть правильным вхождением директории, открытым функцией zip_read().

См. также zip_open() и zip_read().

zip_entry_filesize

(PHP 4 >= 4.1.0)

zip_entry_filesize - запрашивает Actual File Size для Directory Entry.

Описание

int zip_entry_filesize (resource zip_entry)

Возвращает фактический размер вхождения директории zip_entry. Параметр zip_entry обязан быть правильным вхождением директории, открытым функцией zip_read().

См. также zip_open() и zip_read().

zip_entry_name

(PHP 4 >= 4.1.0)

zip_entry_name - запрашивает Name для Directory Entry.

Описание

string zip_entry_name (resource zip_entry)

Возвращает имя вхождения директории zip_entry. Параметр zip_entry обязан быть правильным вхождением директории, открытым функцией zip_read().

См. также zip_open() и zip_read().

zip_entry_open

(PHP 4 >= 4.1.0)

zip_entry_open - открывает вхождение директории для четния.

Описание

bool zip_entry_open (resource zip, resource zip_entry [, string mode])

Открывает вхождение директории в zip-файле для чтения. Параметр zip это правильный дескриптор ресурса, возвращённый функцией zip_open(). Параметр zip_entry это ресурс вхождения директории, возвращённый функцией zip_read(). Необязательный параметр mode может быть одним из режимов, специфицированных в документации для fopen().

Примечание: в настоящее время mode игнорируется и всегда имеет значение "rb". Это из-за того, что zip поддерживается в PHP с доступом только для чтения. См. в fopen() объяснение режимов, включая "rb".

Возвращает TRUE при успехе, FALSE при неудаче.

Примечание: в отличие от fopen() и других подобных функций, return-значение функции zip_entry_open() указывает только результат операции и не нужно для чтения или закрытия вхождения директории.

См. также zip_entry_read() и zip_entry_close().

zip_entry_read

(PHP 4 >= 4.1.0)

zip_entry_read - читает из открытого вхождения директории.

Описание

string zip_entry_read (resource zip_entry [, int length])

Читает до length байтов из открытого вхождения директории. Если length не специфицирован, zip_entry_read() пытается прочитать 1024 байта. Параметр zip_entry является правильным вхождением директории, возвращённым функцией zip_read().

Примечание: параметр length должен быть несжатым размером, который вы хотите прочитать.

Возвращает прочитанные данные, или FALSE, если достигнут конец файла.

См. также zip_entry_open(), zip_entry_close() и zip_entry_filesize().

zip_open

(PHP 4 >= 4.1.0)

zip_open - открывает Zip File Archive.

Описание

resource zip_open (string filename)

Открывает новый zip-архив для чтения. Параметр filename это имя файла открываемого zip-архива.

Возвращает дескриптор ресурса для дальнейшего использования в zip_read() и zip_close(), или возвращает FALSE, если filename не существует.

См. также zip_read() и zip_close().

zip_read

(PHP 4 >= 4.1.0)

zip_read - читает Forward Entry в файле Zip-архива.

Описание

resource zip_read (resource zip)

Читает следующее вхождение в файле zip-архива. Параметр zip обязан быть zip-архивом, открытым ранее функцией zip_open().

Возвращает ресурс вхождения директории для дальнейшего использования с zip_entry_...() функциями.

См. также zip_open(), zip_close(), zip_entry_open() и zip_entry_read().