Ora_Bind
(PHP 3, PHP 4)
Ora_Bind - связывает PHP-переменную с Oracle-параметром.
Описание
int ora_bind (int cursor, string PHP variable name, string SQL parameter name, int length [, int type])
Возвращает TRUE, если связывание прошло, иначе FALSE. Детали об ошибке можно запросить функциями ora_error() и ora_errorcode().
Эта функция связывает именованную PHP-переменную с SQL-параметром. SQL-параметр обязан иметь форму ":name". С помощью необязательного параметра type вы можете определять, является ли SQL-параметр in/out (0, по умолчанию), in (1) или out (2). Как и в PHP 3.0.1, вы можете использовать константы ORA_BIND_INOUT, ORA_BIND_IN и ORA_BIND_OUT вместо чисел.
ora_bind обязана вызываться после ora_parse() и до ora_exec(). Вводимые значения могут задаваться путём присвоения связанным PHP-переменным; после вызова ora_exec() связанные PHP-переменные содержат значения вывода, если доступны.
Ora_Close
(PHP 3, PHP 4)
Ora_Close - закрывает курсор Oracle.
Описание
int ora_close (int cursor)
Возвращает TRUE, если курсор закрылся, иначе FALSE. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
Эта функция закрывает курсор данных, открытый функцией ora_open().
Ora_ColumnName
(PHP 3, PHP 4)
Ora_ColumnName - получает имя результирующего столбца Oracle.
Описание
string Ora_ColumnName (int cursor, int column)
Возвращает имя поля/столбца column в курсоре cursor. Имя возвращается буквами верхнего регистра. Столбец 0 это первый столбец.
Ora_ColumnSize
(PHP 3, PHP 4)
Ora_ColumnSize - получает размер результирующего столбца Oracle.
Описание
int Ora_ColumnSize (int cursor, int column)
Возвращает размер Oracle-столбца column в курсоре cursor. Столбец 0 это первый столбец.
Ora_ColumnType
(PHP 3, PHP 4)
Ora_ColumnType - получает тип результирующего Oracle-столбца.
Описание
string Ora_ColumnType (int cursor, int column)
Возвращает имя типа данных Oracle для поля/столбца column в курсоре cursor. Столбец 0 является первым столбцом. Возвращается один из следующих типов:
Ora_Commit
(PHP 3, PHP 4)
Ora_Commit - подтверждает транзакцию Oracle.
Описание
int ora_commit (int conn)
Возвращает TRUE при успехе, FALSE при ошибке. Детали об ошибке можно запросить с помощью функций
Эта функция подтверждает транзакцию Oracle. Транзакция определяется как все изменения по данному соединению, выполненные после последней операции commit/rollback, отключения autocommit или установления соединения.
Ora_CommitOff
(PHP 3, PHP 4)
Ora_CommitOff - отключает автоматическое подтверждение.
Описание
int ora_commitoff (int conn)
Возвращает TRUE при успехе, FALSE при ошибке. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
Эта функция отключает автоматическое подтверждение после каждой ora_exec().
Ora_CommitOn
(PHP 3, PHP 4)
Ora_CommitOn - включает автоматическое подтверждение.
Описание
int ora_commiton (int conn)
Эта функция включает автоматическое подтверждение после каждой ora_exec() в данном соединении.
Возвращает TRUE при успехе, FALSE при ошибке. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
Ora_Do
(PHP 3, PHP 4)
Описание
int ora_do (int conn, string query)
Эта функция является комбинацией функций ora_parse(), ora_exec() и ora_fetch(). Она разбирает и выполняет оператор, затем извлекает первый результирующий ряд.
Возвращает TRUE при успехе, FALSE при ошибке. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
См. также ora_parse(), ora_exec() и ora_fetch().
Ora_Error
(PHP 3, PHP 4)
Ora_Error - получает сообщение об ошибке Oracle.
Описание
string Ora_Error (int cursor_or_connection)
Возвращает сообщение об ошибке в форме XXX-NNNNN, где XXX это место ошибки, а NNNNN идентифицирует сообщение об ошибке.
Примечание: поддержка id соединения была введена в 3.0.4.
В UNIX-версиях Oracle вы можете получить детали о сообщении об ошибке примерно так: $ oerr ora 00001 00001, 00000, "unique constraint (%s.%s) violated" // *Cause: An update or insert statement attempted to insert a duplicate key // For Trusted ORACLE configured in DBMS MAC mode, you may see // this message if a duplicate entry exists at a different level. // *Action: Either remove the unique restriction or do not insert the key
Ora_ErrorCode
(PHP 3, PHP 4)
Ora_ErrorCode - получает код ошибки Oracle.
Описание
int Ora_ErrorCode (int cursor_or_connection)
Возвращает числовой код ошибки последнего выполненного оператора специфицированного курсора или соединения.
Примечание: поддержка id соединения была введена в 3.0.4.
Ora_Exec
(PHP 3, PHP 4)
Ora_Exec - выполняет разобранный оператор Oracle-курсора.
Описание
int ora_exec (int cursor)
Возвращает TRUE при успехе, FALSE при ошибке. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
См. также ora_parse(), ora_fetch() и ora_do().
Ora_Fetch
(PHP 3, PHP 4)
Ora_Fetch - извлекает ряд данных из курсора.
Описание
int ora_fetch (int cursor)
Возвращает TRUE (извлечённый ряд) или FALSE (рядов больше нет или возникла ошибка). Если возникла ошибка, детали о ней можно запросить с помощью функций ora_error() и ora_errorcode(). Если ошибки не было, ora_errorcode() возвратит 0.
Запрашивает ряд данных из специфицированного курсора.
См. также ora_parse(), ora_exec() и ora_do().
Ora_Fetch_Into
(PHP 3, PHP 4)
Ora_Fetch_Into - извлекает ряд в специфицированный результирующий массив.
Описание
int ora_fetch_into (int cursor, array result [, int flags])
Извлекает ряд данных в массив. Параметр flags содержит значения двух флагов: если флаг ORA_FETCHINTO_NULLS установлен, столбцы с NULL-значениями устанавливаются в массиве; а если установлен флаг ORA_FETCHINTO_ASSOC, создаётся ассоциативный массив.
Возвращает количество извлечённых столбцов.
Ora_GetColumn
(PHP 3, PHP 4)
Ora_GetColumn - получает данные из извлечённого столбца.
Описание
mixed ora_getcolumn (int cursor, mixed column)
Возвращает данные столбца. Если возникает ошибка, возвращается FALSE, а ora_errorcode() возвращает ненулевое значение. Заметьте, однако, что проверка на FALSE в результатах этой функции может дать также TRUE в случаях, когда ошибки нет ( NULL-результат, пустая строка, число 0, строка "0").
Извлекает данные столбца или результата функции.
Ora_Logoff
(PHP 3, PHP 4)
Ora_Logoff - закрывает соединение Oracle.
Описание
int ora_logoff (int connection)
Возвращает TRUE при успехе, FALSE при ошибке. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
Выполняет Log out/выход пользователя и отсоединяет от сервера.
См. также ora_logon().
Ora_Logon
(PHP 3, PHP 4)
Ora_Logon - открывает соединение Oracle.
Описание
int ora_logon (string user, string password)
Устанавливает соединение PHP и БД Oracle с заданными username и password.
Соединение может быть создано с использованием SQL*Net путём предоставления TNS-имени пользователю user примерно так:
$conn = Ora_Logon("user<emphasis>@TNSNAME</emphasis>", "pass");
Если у вас имеются символьные данные с не-ASCII символами, вы должны убедиться, что NLS_LANG установлена в вашем окружении. Для серверных модулей вы должны установить её в серверном окружении до старта сервера.
Возвращает индекс соединения успехе, FALSE при неудаче. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
Ora_Numcols
(PHP 3, PHP 4)
Ora_Numcols - возвращает количество столбцов.
Описание
int ora_numcols (int cursor_ind)
ora_numcols() возвращает количество столбцов в результате. Возвращает только осмысленные значения после parse/exec/fetch.
См. также ora_parse(), ora_exec(), ora_fetch() и ora_do().
Ora_Numrows
(PHP 3, PHP 4)
Ora_Numrows - возвращает количество рядов.
Описание
int ora_numrows (int cursor_ind)
ora_numrows() возвращает количество рядов в результате.
Ora_Open
(PHP 3, PHP 4)
Ora_Open - открывает курсор Oracle.
Описание
int ora_open (int connection)
Открывает курсор Oracle, ассоциированный с соединением.
Возвращает индекс курсора, FALSE при неудаче. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
Ora_Parse
(PHP 3, PHP 4)
Ora_Parse - разбирает оператор SQL.
Описание
int ora_parse (int cursor_ind, string sql_statement, int defer)
Эта функция разбирает SQL-оператор или блок PL/SQL и ассоциирует его с данным курсором.
Возвращает TRUE при успехе, FALSE при неудаче.
См. также ora_exec(), ora_fetch() и ora_do().
Ora_pLogon
(PHP 3, PHP 4)
Ora_pLogon - открывает постоянное соединение Oracle.
Описание
int ora_plogon (string user, string password)
Устанавливает постоянное соединение между PHP и БД Oracle с заданными username и password.
См. также ora_logon().
Ora_Rollback
(PHP 3, PHP 4)
Ora_Rollback - откатывает транзакцию.
Описание
int ora_rollback (int connection)
Эта функция отменяет транзакцию Oracle. (См. в ora_commit() определение транзакции.)
Возвращает TRUE при успехе, FALSE при ошибке. Детали об ошибке можно запросить с помощью функций ora_error() и ora_errorcode().
ord
(PHP 3, PHP 4)
ord - возвращает ASCII-значение символа.
Описание
int ord (string string)
Возвращает ASCII-значение первого символа строки string. Эта функция дополняет chr().
overload
(PHP 4 >= 4.2.0)
overload - включает возможность перегрузки/overloading свойств и методов класса.
Описание
void overload ([string class_name])
Функция overload() включает возможность перегрузки свойств и методов класса class_name. См. пример во вводном разделе этой части.
ovrimos_close
(PHP 4 >= 4.0.3)
ovrimos_close - закрывает соединение с ovrimos.
Описание
void ovrimos_close (int connection)
ovrimos_close() используется для закрытия специфицированного соединения.
ovrimos_close() закрывает соединение с Ovrimos. Даёт эффект отката неподтверждённых транзакций.
ovrimos_commit
(PHP 4 >= 4.0.3)
ovrimos_commit - подтверждает транзакцию.
Описание
int ovrimos_commit (int connection_id)
ovrimos_connect
(PHP 4 >= 4.0.3)
ovrimos_connect - соединяет со специфицированной базой данных.
Описание
int ovrimos_connect (string host, string db, string user, string password)
ovrimos_connect() возвращает id соединения (больше 0), или 0 при ошибке. Значение 'host' и 'port' используются везде в Ovrimos APIs. 'Host' это имя хоста или IP-адрес, а 'db' это имя БД либо строка с номером порта.
ovrimos_cursor
(PHP 4 >= 4.0.3)
ovrimos_cursor - возвращает имя курсора.
Описание
int ovrimos_cursor (int result_id)
ovrimos_cursor() возвращает имя курсора. Используется, когда необходимо выполнить позиционированные update или delete.
ovrimos_exec
(PHP 4 >= 4.0.3)
ovrimos_exec - выполняет оператор SQL.
Описание
int ovrimos_exec (int connection_id, string query)
ovrimos_exec() выполняет SQL-оператор (запрос или update) и возвращает result_id или FALSE. Очевидно, оператор SQL не должен содержать параметров.
ovrimos_execute
(PHP 4 >= 4.0.3)
ovrimos_execute - выполняет подготовленный оператор SQL.
Описание
bool ovrimos_execute (int result_id [, array parameters_array])
ovrimos_execute() выполняет подготовленный оператор. Возвращает TRUE или FALSE. Если подготовленный оператор содержит параметры (знаки вопроса в операторе), должно передаваться корректное количество параметров в массиве. Заметьте, что я не следую соглашению PHP о размещении просто имени необязательного параметра в квадратных скобках. Не могу себя заставить.
ovrimos_fetch_into
(PHP 4 >= 4.0.3)
ovrimos_fetch_into - извлекает ряд из результирующего набора.
Описание
bool ovrimos_fetch_into (int result_id, array result_array [, string how [, int rownumber]])
ovrimos_fetch_into() извлекает ряд из результирующего набора в 'result_array', который должен передаваться по ссылке. То, какой ряд извлекается, определяется двумя последними параметрами. 'how' - это один из: 'Forward' (default), 'Назад', 'First', 'Last', 'Absolute', соответствующих направлениям от текущей позиции вперёд, назад, вперёд от начала, назад от конца и абсолютной позиции от начала (эквивалент 'first', но требует 'rownumber'). Регистр не имеет значения. 'Rownumber' это параметр по выбору, кроме абсолютного позиционирования, где необходим. Возвращает TRUE или FALSE.
ovrimos_fetch_row
(PHP 4 >= 4.0.3)
ovrimos_fetch_row - извлекает ряд из результирующего набора.
Описание
bool ovrimos_fetch_row (int result_id [, int how [, int row_number]])
ovrimos_fetch_row() извлекает ряд из результирующего набора. Значения столбцов должны запрашиваться другими вызовами. Возвращает TRUE или FALSE.
ovrimos_field_len
(PHP 4 >= 4.0.3)
ovrimos_field_len - возвращает длину столбца вывода.
Описание
int ovrimos_field_len (int result_id, int field_number)
ovrimos_field_len() используется для получения длины столбца вывода с номером field_number в результате result_id.
ovrimos_field_len() возвращает длину столбца вывода по специфицированному индексу (с базой 1).
ovrimos_field_name
(PHP 4 >= 4.0.3)
ovrimos_field_name - возвращает имя столбца вывода.
Описание
int ovrimos_field_name (int result_id, int field_number)
ovrimos_field_name() возвращает имя столбца вывода по специфицированному индексу (с базой 1).
ovrimos_field_num
(PHP 4 >= 4.0.3)
ovrimos_field_num - возвращает индекс (с базой 1) столбца вывода.
Описание
int ovrimos_field_num (int result_id, string field_name)
ovrimos_field_num() возвращает индекс (с базой 1) столбца вывода, специфицированного по имени, либо FALSE.
ovrimos_field_type
(PHP 4 >= 4.0.3)
ovrimos_field_type - возвращает (числовой) тип столбца вывода.
Описание
int ovrimos_field_type (int result_id, int field_number)
ovrimos_field_type() возвращает (числовой) тип столбца вывода по специфицированному индексу (с базой 1).
ovrimos_free_result
(PHP 4 >= 4.0.3)
ovrimos_free_result - освобождает специфицированный result_id.
Описание
bool ovrimos_free_result (int result_id)
ovrimos_free_result() освобождает специфицированный result_id. Возвращает TRUE.
ovrimos_longreadlen
(PHP 4 >= 4.0.3)
ovrimos_longreadlen - специфицирует, сколько байтов запрашиваются из типов данных long.
Описание
int ovrimos_longreadlen (int result_id, int length)
ovrimos_longreadlen() специфицирует, сколько байтов запрашиваются из типов данных long (long varchar и long varbinary). По умолчанию ноль. Устанавливает этот параметр в специфицированном результирующем набору. Возвращает TRUE.
ovrimos_num_fields
(PHP 4 >= 4.0.3)
ovrimos_num_fields - возвращает количество столбцов.
Описание
int ovrimos_num_fields (int result_id)
ovrimos_num_fields() возвращает количество столбцов в result_id, результирующем из запроса.
ovrimos_num_rows
(PHP 4 >= 4.0.3)
ovrimos_num_rows - возвращает количество рядов, задействованных в операциях update.
Описание
int ovrimos_num_rows (int result_id)
ovrimos_prepare
(PHP 4 >= 4.0.3)
ovrimos_prepare - готовит оператор SQL.
Описание
int ovrimos_prepare (int connection_id, string query)
ovrimos_prepare() подготавливает оператор SQL и возвращает result_id (или FALSE при неудаче).
ovrimos_result
(PHP 4 >= 4.0.3)
ovrimos_result - запрашивает столбец вывода.
Описание
int ovrimos_result (int result_id, mixed field)
ovrimos_result() запрашивает столбец вывода 'field' как строку или как индекс с базой 1.
ovrimos_result_all
(PHP 4 >= 4.0.3)
ovrimos_result_all - печатает весь результирующий набор как HTML-таблицу.
Описание
bool ovrimos_result_all (int result_id [, string format])
ovrimos_result_all() печатает весь результирующий набор как HTML-таблицу. Возвращает TRUE или FALSE.
ovrimos_rollback
(PHP 4 >= 4.0.3)
ovrimos_rollback - откатывает транзакцию.
Описание
int ovrimos_rollback (int connection_id)
pack
(PHP 3, PHP 4)
pack - упаковывает данные в бинарную строку.
Описание
string pack (string format [, mixed args])
Упаковывает данные аргументы в бинарную строку в соответствии с форматом format. Возвращает бинарную строку с данными.
Идея этой функции была взята из Perl, и весь код форматирования работает аналогично, однако отсутствуют некоторые коды форматирования, такие как Perl'овский "u". Строка форматирования состоит из кодов форматирования и последующего необязательного аргумента повторения/repeater. Аргумент repeater может быть целочисленным или * для повторения до конца данных ввода. Для a, A, h, H повторение специфицирует, сколько символов аргумента data принимается, для @ это абсолютная позиция для размещения следующих данных, для других параметров повторение специфицирует, сколько аргументов данных употребляется и упаковывается в результирующую бинарную строку. В настоящее время реализованы:
строка с NUL-заполнением
строка со SPACE-заполнение
h Hex-строка, сначала нижний разряд
H Hex-строка, сначала высший разряд
c знаковый char
C беззнаковый char
s знаковый short (всегда 16 бит, машинный байтовый порядок)
S беззнаковый short (всегда 16 бит, машинный байтовый порядок)
n беззнаковый short (всегда 16 бит, байтовый порядок big endian)
v беззнаковый short (всегда 16 бит, байтовый порядок little endian)
i signed integer (машиннозависимый размер и байтовый порядок)
I беззнаковый integer (машиннозависимый размер и байтовый порядок)
l signed long (всегда 32 бита, машинный байтовый порядок)
L беззнаковый long (всегда 32 бита, машинный байтовый порядок)
N беззнаковый long (всегда 32 бита, байтовый порядок big endian)
V беззнаковый long (всегда 32 бита, байтовый порядок little endian)
f float (машиннозависимый размер и представление)
d double (машиннозависимый размер и представление)
x NUL байт
X обратно на один байт
@ NUL-заполнение до абсолютной позиции
parse_ini_file
(PHP 4)
parse_ini_file - разбирает файл конфигурации.
Описание
array parse_ini_file (string filename [, bool process_sections])
parse_ini_file() загружает ini-файл filename и возвращает его установки в виде ассоциативного массива. Установив в последний параметр process_sections TRUE, вы получите многомерный массив, включая имена разделов и установки. По умолчанию process_sections имеет значение FALSE.
Примечание: эта функция ничего не делает с файлом php.ini. Он уже обработан при запуске скрипта. Эта функция может использоваться для чтения файлов конфигураций ваших приложений.
Примечание: если значение в ini-файле содержит не-алфавитно-числовые символы, необходимо заключить его в двойные кавычки (").
Примечание: начиная с PHP 4.2.1, на эту функцию воздействует также safe_mode и open_basedir.
Структура ini-файла аналогична структуре php.ini.
parse_str
(PHP 3, PHP 4)
parse_str - разбирает строку на переменные.
Описание
void parse_str (string str [, array arr])
Разбирает str так, как если бы она была строкой запроса, переданной через URL, и устанавливает переменные в текущей области видимости. Если имеется второй параметр arr, переменные вместо этого сохраняются в этой переменной как элементы массива.
Примечание: поддержка необязательного второго параметра была введена в PHP 4.0.3.
parse_url
(PHP 3, PHP 4)
parse_url - разбирает URL и возвращает его компоненты.
Описание
array parse_url (string url)
Эта функция возвращает ассоциативный массив, содержащий любые имеющиеся компоненты URL. Это могут быть:
scheme - например, http
host
port
user
pass
path
query - запрос, после знака вопроса ?
fragment - фрагмент, после знака хэша #
Эта функция не предназначена для проверки заданного URL, она только разбивает его на вышеперечисленные части. Частичные url также принимаются; parse_url() пытается разобрать их корректно.
Пример 1. Использование parse_url()
$ php -r 'print_r( parse_url("http://username:password@hostname/path?arg=value#anchor"));'
Array
(
[scheme] => http
[host] => hostname
[user] => username
[pass] => password
[path] => /path
[query] => arg=value
[fragment] => anchor
)
$ php -r 'print_r( parse_url("http://invalid_host..name/"));'
Array
(
[scheme] => http
[host] => invalid_host..name
[path] => /
)См. также pathinfo().
passthru
(PHP 3, PHP 4)
passthru - выполняет внешнюю программу и выводит сырой вывод.
Описание
void passthru (string command [, int return_var])
Функция passthru() похожа на функцию exec() тем, что выполняет команду command. Если имеется аргумент return_var, то здесь будет помещён return-статус Unix-команды. Эта функция должна использоваться вместо exec() или system(), если вывод Unix-команды является бинарными данными, которые должны передаваться непосредственно обратно в браузер. Её обычное использование - выполнение чего-нибудь вроде pbmplus-утилит, которые могут давать непосредственный вывод потока изображения. Установив в Content-type значение image/gif и вызвав затем pbmplus-программу для вывода gif, вы можете создать PHP-скрипт, выводящий изображения напрямую.
Примечание: если вы начинаете программу с использования этой функции и хотите оставить её работать в фоновом режиме, вам необходимо убедиться, что вывод этой программы перенаправляется в файл или в некоторый другой поток вывода, иначе PHP зависнет до тех пор, пока не закончится выполнение этой программы.
См. также exec(), system(), popen(), escapeshellcmd() и операцию backtick.
pathinfo
(PHP 4 >= 4.0.3)
pathinfo - возвращает информацию о пути к файлу.
Описание
array pathinfo (string path)
pathinfo() возвращает ассоциативный массив, содержащий информацию о path. Возвращаются элементы: dirname, basename и extension.
pclose
(PHP 3, PHP 4)
pclose - закрывает файловый указатель процесса.
Описание
int pclose (int fp)
Закрывает файловый указатель на канал/pipe, открытый функцией popen().
Файловый указатель обязан быть правильным и возвращаться успешным вызовом popen().
Возвращает статус завершения работавшего процесса.
См. также popen().
pcntl_exec
(PHP 4 >= 4.2.0)
pcntl_exec - выполняет специфицированную программу в пространстве текущего процесса.
Описание
bool pcntl_exec (string path [, array args [, array envs]])
pcntl_fork
(PHP 4 >= 4.1.0)
pcntl_fork - разветвляет текущий процесс.
Описание
int pcntl_fork (void)
Функция pcntl_fork() создаёт дочерний процесс, который отличается от родительского процесса только своими PID и PPID. См. на man-странице fork(2) вашей системы детали о том, как разветвление работает на вашей системе.
При успехе возвращается PID дочернего процесса в родительском потоке выполнения, а 0 возвращается в дочернем потоке выполнения. При неудаче возвращается -1 в родительском контексте, дочерний процесс не создаётся, и возникает ошибка PHP.
pcntl_signal
(PHP 4 >= 4.1.0)
pcntl_signal - инсталирует обработчик сигнала.
Описание
bool pcntl_signal (int signo, mixed handler)
Функция pcntl_signal() устанавливает новый обработчик сигнала для сигнала signo. Обработчик сигнала устанавливается в handler, который может быть именем функции, созданной пользователем, или одной из двух глобальных констант: SIG_IGN или SIG_DFL.
pcntl_signal() возвращает TRUE при успехе, FALSE при неудаче.
pcntl_waitpid
(PHP 4 >= 4.1.0)
pcntl_waitpid - ожидает или возвращает статус разветвлённого потомка.
Описание
int pcntl_waitpid (int pid, int status, int options)
Функция pcntl_waitpid() задерживает выполнение текущего процесса, пока потомок pid не выполнит выход или пока не будет получен сигнал, акцией которого является окончание текущего процесса или вызов обработки сигнала. Если потомок как запрошенный pid уже выполнил выход в момент вызова (так называемый "zombie"-процесс), функция возвращает немедленно. Любые системные ресурсы, используемые потомком, освобождаются. См. в вашей системной man-странице waitpid(2) специфические детали о работе waitpid в вашей системе.
pcntl_waitpid() возвращает process ID вышедшего потомка, -1 при ошибке или нуль, если была использована WNOHANG и нет доступного потомка.
Таблица 1. Возможные значения pid
pcntl_waitpid() сохранит информацию статуса в параметре status, который может быть вычислен с использование следующих функций: pcntl_wifexited(), pcntl_wifstopped(), pcntl_wifsignaled(), pcntl_wexitstatus(), pcntl_wtermsig() и pcntl_wstopsig().
Значением options является значение нуль или более следующих двух глобальных констант, которые OR друг с другом:
Таблица 2. Возможные значения options
См. также pcntl_fork(), pcntl_signal(), pcntl_wifexited(), pcntl_wifstopped(), pcntl_wifsignaled(), pcntl_wexitstatus(), pcntl_wtermsig() и pcntl_wstopsig().
pcntl_wexitstatus
(PHP 4 >= 4.1.0)
pcntl_wexitstatus - возвращает return-код завершившего работу потомка.
Описание
int pcntl_wexitstatus (int status)
Возвращает return-код завершившего работу потомка. Эта функция используется, только если pcntl_wifexited() возвратила TRUE.
Параметр status это параметр статуса, предоставленный для успешного вызова pcntl_waitpid().
См. также pcntl_waitpid() и pcntl_wifexited().
pcntl_wifexited
(PHP 4 >= 4.1.0)
pcntl_wifexited - возвращает TRUE, если код статуса представляет успешный выход.
Описание
int pcntl_wifexited (int status)
Параметр status это параметр статуса, предоставляемый при успешном вызове pcntl_waitpid().
См. также pcntl_waitpid() и pcntl_wexitstatus().
pcntl_wifsignaled
(PHP 4 >= 4.1.0)
pcntl_wifsignaled - возвращает TRUE, если код статуса представляет прерывание по сигналу.
Описание
int pcntl_wifsignaled (int status)
Возвращает TRUE, если дочерний процесс завершён по причине неотловленного сигнала.
Параметр status это параметр статуса, предоставленный при успешном вызове pcntl_waitpid().
См. также pcntl_waitpid() и pcntl_signal().
pcntl_wifstopped
(PHP 4 >= 4.1.0)
pcntl_wifstopped - возвращает TRUE, если дочерний процесс в данный момент остановлен.
Описание
int pcntl_wifstopped (int status)
Возвращает TRUE, если дочерний процесс, выполнивший возврат, в данный момент остановлен; это возможно только в том случае, если вызов pcntl_waitpid() был выполнен с опцией WUNTRACED.
Параметр status это параметр статуса, предоставленный при успешном вызове pcntl_waitpid().
См. также pcntl_waitpid().
pcntl_wstopsig
(PHP 4 >= 4.1.0)
pcntl_wstopsig - возвращает сигнал, который вызвал остановку дочернего процесса.
Описание
int pcntl_wstopsig (int status)
Возвращает число сигнала, который вызвал остановку дочернего процесса. Эта функция используется только в том случае, если pcntl_wifstopped() возвратила TRUE.
Параметр status это параметр статуса, предоставленный при успешном вызове pcntl_waitpid().
См. также pcntl_waitpid() и pcntl_wifstopped().
pcntl_wtermsig
(PHP 4 >= 4.1.0)
pcntl_wtermsig - возвращает сигнал, вызвавший прерывание дочернего процесса.
Описание
int pcntl_wtermsig (int status)
Возвращает номер сигнала, вызвавшего прерывание работы дочернего процесса. Эта функция используется только в том случае, если pcntl_wifsignaled() возвратила TRUE.
Параметр status это параметр статуса, предоставленный при успешном вызове pcntl_waitpid().
См. также pcntl_waitpid(), pcntl_signal() и pcntl_wifsignaled().
pdf_add_annotation
(PHP 3>= 3.0.12, PHP 4)
pdf_add_annotation - не рекомендуется: добавляет аннотацию.
Описание
pdf_add_outline() заменена на pdf_add_note().
См. также pdf_add_note().
pdf_add_bookmark
(PHP 4 >= 4.0.1)
pdf_add_bookmark - добавляет закладку/bookmark на текущей странице.
Описание
int pdf_add_bookmark (int pdf object, string text [, int parent [, int open]])
Добавляет вложенную закладку под parent, или новую закладку верхнего уровня/top-level, если parent = 0. Возвращает дескриптор закладки, который может использоваться как родитель для последующих вложенных закладок. Если open = 1, дочерние закладки будут развёрнуты, и невидимы, если open = 0.
pdf_add_launchlink
(PHP 4 >= 4.0.5)
pdf_add_launchlink - добавляет аннотацию запуска для текущей страницы.
Описание
int pdf_add_launchlink (int pdf object, float llx, float lly, float urx, float ury, string filename)
Добавляет аннотацию запуска/launch annotation (цели - файлу произвольного типа).
pdf_add_locallink
(PHP 4 >= 4.0.5)
pdf_add_locallink - добавляет ссылочную аннотацию/link annotation на текущую страницу.
Описание
int pdf_add_locallink ( int pdf object, float llx, float lly, float urx, float ury, int page, string dest)Добавляет ссылочную аннотацию цели в текущем PDF-файле.
pdf_add_note
(PHP 4 >= 4.0.5)
pdf_add_note - добавляет аннотацию заметки/note annotation на текущую страницу.
Описание
int pdf_add_note (int pdf object, float llx, float lly, float urx, float ury, string contents, string title, string icon, int open)
Добавляет аннотацию-заметку.
icon имеет одно из значений: "comment, "insert", "note",
"paragraph", "newparagraph", "key" или "help".
pdf_add_outline
(PHP 3>= 3.0.6, PHP 4)
pdf_add_outline - не рекомендуется: добавляет закладку на текущую страницу.
Описание
Не рекомендуется.
См. pdf_add_bookmark().
pdf_add_pdflink
(PHP 3>= 3.0.12, PHP 4)
pdf_add_pdflink - добавляет файловую аннотацию ссылки на текущую страницу.
Описание
int pdf_add_pdflink (int pdf object, float llx, float lly, float urx, float ury, string filename, int page, string dest)
Добавляет файловую аннотацию ссылки (в PDF-цель).
pdf_add_thumbnail
(PHP 4 >= 4.0.5)
pdf_add_thumbnail - добавляет уменьшенное изображение/thumbnail на текущую страницу.
Описание
int pdf_add_thumbnail (int pdf object, int image)
Добавляет существующее изображение как thumbnail на текущую страницу.
pdf_add_weblink
(PHP 3>= 3.0.12, PHP 4)
pdf_add_weblink - добавляет web-ссылку на текущую страницу.
Описание
int pdf_add_weblink (int pdf object, float llx, float lly, float urx, float ury, string url)
Добавляет weblink-аннотацию к целевому URL в Web.
pdf_arc
(PHP 3>= 3.0.6, PHP 4)
pdf_arc - рисует дугу (против часовой стрелки).
Описание
void pdf_arc (resource pdf object, float x, float y, float r, float alpha, float beta)
Рисует против часовой стрелки дугу окружности на количество градусов от alpha до beta.
См. также pdf_arcn().
pdf_arcn
(PHP 4 >= 4.0.5)
pdf_arcn - рисует дугу (по часовой стрелке).
Описание
void pdf_arc (resource pdf object, float x, float y, float r, float alpha, float beta)
Рисует по часовой стрелке дугу окружности на количество градусов от alpha до beta.
См. также pdf_arc().
pdf_attach_file
(PHP 4 >= 4.0.5)
pdf_attach_file - добавляет присоединение/attachement к файлу для текущей страницы.
Описание
int pdf_attach_file (int pdf object, float llx, float lly, float urx, float ury, string filename, string description, string author, string mimetype, string icon)
Добавляет аннотацию-присоединение.
icon это одно из: "graph, "paperclip", "pushpin" или "tag".
pdf_begin_page
(PHP 3>= 3.0.6, PHP 4)
pdf_begin_page - начинает новую страницу.
Описание
void pdf_begin_page (int pdf object, float width, float height)
Добавляет новую страницу в документ. width и height специфицируются в пунктах/points, каждый из которых равен 1/72 дюйма.
Таблица 1. Обычные размеры страниц в пунктах
pdf_begin_pattern
(PHP 4 >= 4.0.5)
pdf_begin_pattern - начинает новый патэрн.
Описание
int pdf_begin_pattern (int pdf object, float width, float height, float xstep, float ystep, int painttype)
Начинает определение нового патэрна и возвращает дескриптор патэрна.
width и height определяют ограничивающий бокс патэрна.
xstep и ystep задают смещение повторяемого патэрна.
painttype=1 означает, что патэрн имеет свои собственные установки цвета, а значение 2
указывает, что при применении патэрна используется текущий цвет.
pdf_begin_template
(PHP 4 >= 4.0.5)
pdf_begin_template - начинает новый шаблон.
Описание
void pdf_begin_template (int pdf object, float width, float height)
Начинает определение нового шаблона.
pdf_circle
(PHP 3>= 3.0.6, PHP 4)
pdf_circle - рисует окружность.
Описание
void pdf_circle (int pdf object, float x, float y, float r)
Рисует окружность с центром (x, y) и радиусом r.
pdf_clip
(PHP 3>= 3.0.6, PHP 4)
pdf_clip - усекает до текущего пути/path.
Описание
void pdf_clip (int pdf object)
Использует текущий path как clipping path.
pdf_close
(PHP 3>= 3.0.6, PHP 4)
pdf_close - закрывает pdf-объект.
Описание
void pdf_close (int pdf object)
Закрывает сгенерированный PDF-файл и освобождает все относящиеся к документу ресурсы.
pdf_close_image
(PHP 3>= 3.0.7, PHP 4)
pdf_close_image - закрывает изображение.
Описание
void pdf_close_image (int pdf object, int image)
Закрывает image, полученное одной из функций pdf_open_image*().
pdf_close_pdi
(PHP 4 >= 4.0.5)
pdf_close_pdi - закрывает PDF-документ ввода.
Описание
void pdf_close_pdi (int pdf object, int dochandle)
Закрывает все дескрипторы открытой страницы и закрывает PDF-документ ввода.
pdf_close_pdi_page
(PHP 4 >= 4.0.5)
pdf_close_pdi_page - закрывает дескриптор страницы.
Описание
void pdf_close_pdi_page (int pdf object, int pagehandle)
Закрывает дескриптор страницы и освобождает все относящиеся к странице ресурсы.
pdf_closepath
(PHP 3>= 3.0.6, PHP 4)
pdf_closepath - закрывает путь/path.
Описание
void pdf_closepath (int pdf object)
Закрывает текущий path.
pdf_closepath_fill_stroke
(PHP 3>= 3.0.6, PHP 4)
pdf_closepath_fill_stroke - закрывает, заполняет и перечёркивает/strokes текущий путь/path.
Описание
void pdf_closepath_fill_stroke (int pdf object)
Закрывает путь, заполняет и перечёркивает его.
pdf_closepath_stroke
(PHP 3>= 3.0.6, PHP 4)
pdf_closepath_stroke - закрывает путь/path и рисует линию вдоль пути.
Описание
void pdf_closepath_stroke (int pdf object)
Закрывает путь и перечёркивает его.
pdf_concat
(PHP 4 >= 4.0.5)
pdf_concat - выполняет конкатенацию матрицы и CTM.
Описание
void pdf_concat (int pdf object, float a, float b, float c, float d, float e, float f)
pdf_continue_text
(PHP 3>= 3.0.6, PHP 4)
pdf_continue_text - выводит текст на следующей строчке.
Описание
void pdf_continue_text (int pdf object, string text)
Печатает текст на следующей строчке. Расстояние между строчками определяется параметром leading.
pdf_curveto
(PHP 3>= 3.0.6, PHP 4)
Описание
void pdf_curveto (int pdf object, float x1, float y1, float x2, float y2, float x3, float y3)
Рисует кривую Безье/Bezier от текущей точки с использованием ещё трёх контрольных точек.
pdf_delete
(PHP 4 >= 4.0.5)
pdf_delete - удаляет PDF-объект.
Описание
void pdf_delete (int pdf object)
Удаляет PDF-объект и освобождает все внутренние ресурсы.
pdf_end_page
(PHP 3>= 3.0.6, PHP 4)
pdf_end_page - заканчивает страницу.
Описание
void pdf_end_page (int pdf object)
pdf_end_pattern
(PHP 4 >= 4.0.5)
pdf_end_pattern - заканчивает патэрн.
Описание
void pdf_end_pattern (int pdf object)
Заканчивает определение патэрна.
pdf_end_template
(PHP 4 >= 4.0.5)
pdf_end_template - заканчивает шаблон.
Описание
void pdf_end_template (int pdf object)
Заканчивает определение шаблона.
pdf_endpath
(PHP 3>= 3.0.6, PHP 4)
pdf_endpath - не рекомендуется: заканчивает текущий путь/path.
Описание
Не рекомендуется; используйте вместо неё одну из функций подчёркивания, заполнения или усечения.
pdf_fill
(PHP 3>= 3.0.6, PHP 4)
pdf_fill - заполняет текущий путь/path.
Описание
void pdf_fill_stroke (int pdf object)
Заполняет внутреннюю часть пути текущим цветом заполнения.
pdf_fill_stroke
(PHP 3>= 3.0.6, PHP 4)
pdf_fill_stroke - заполняет и перечёркивает текущий путь/path.
Описание
void pdf_fill_stroke (int pdf object)
Заполняет и перечёркивает текущий путь текущим цветом заполнения и рисования.
pdf_findfont
(PHP 4 >= 4.0.5)
pdf_findfont - готовит шрифт для дальнейшего использования с pdf_setfont().
Описание
int pdf_findfont (int pdf object, string fontname, string encoding, int embed)
Готовит шрифт для дальнейшего использования с pdf_setfont().
Метрики будут загружены, и, если embed не нулевой, шрифт будет проверен, но ещё не использован.
encoding это: "builtin", "macroman", "winansi", "host", пользовательское encoding-имя или имя CMap.
pdf_findfont() возвращает дескриптор шрифта, FALSE при ошибке.
pdf_get_buffer
(PHP 4 >= 4.0.5)
pdf_get_buffer - извлекает буфер, содержащий сгенерированные PDF-данные.
Описание
string pdf_get_buffer (int pdf object)
Получает содержимое буфера вывода PDF. Результат обязан использоваться клиентом до вызова любой другой PDFlib.
pdf_get_font
(PHP 4)
pdf_get_font - не рекомендуется: обработка шрифта.
Описание
Не рекомендуется.
См. pdf_get_value().
pdf_get_fontname
(PHP 4)
pdf_get_fontname - не рекомендуется: обработка шрифта.
Описание
Не рекомендуется.
См. pdf_get_parameter().
