Учебник PHP

         

cpdf_setlinecap

(PHP 3>= 3.0.8, PHP 4)

cpdf_setlinecap - устанавливает параметр linecap.

Описание

void cpdf_setlinecap (int pdf document, int value)

Функция cpdf_setlinecap() устанавливает параметр linecap в значение от 0 до 2.
0 = butt end, 1 = round, 2 = projecting square.

cpdf_setlinejoin

(PHP 3>= 3.0.8, PHP 4)

cpdf_setlinejoin - устанавливает параметр linejoin.

Описание

void cpdf_setlinejoin (int pdf document, long value)

Функция cpdf_setlinejoin() устанавливает параметр linejoin в значение от 0 до 2.

0 = miter, 1 = round, 2 = bevel.

cpdf_setlinewidth

(PHP 3>= 3.0.8, PHP 4)

cpdf_setlinewidth - устанавливает ширину линии.

Описание

void cpdf_setlinewidth (int pdf document, float width)

Функция cpdf_setlinewidth() устанавливает ширину width линии.

cpdf_setmiterlimit

(PHP 3>= 3.0.8, PHP 4)

cpdf_setmiterlimit - устанавливает ограничение miter.

Описание

void cpdf_setmiterlimit (int pdf document, float value)

Функция cpdf_setmiterlimit() устанавливает ограничение miter в значение больше или равно 1.

cpdf_setrgbcolor

(PHP 3>= 3.0.8, PHP 4)

cpdf_setrgbcolor - устанавливает rgb-значение цвета прорисовки и заполнения.

Описание

void cpdf_setrgbcolor (int pdf document, float red value, float green value, float blue value)

Функция cpdf_setrgbcolor() устанавливает текущий цвет прорисовки и заполнения - rgb-значение цвета.

См. также cpdf_setrgbcolor_stroke(), cpdf_setrgbcolor_fill().

cpdf_setrgbcolor_fill

(PHP 3>= 3.0.8, PHP 4)

cpdf_setrgbcolor_fill - устанавливает rgb-значение цвета заполнения.



Описание

void cpdf_setrgbcolor_fill (int pdf document, float red value, float green value, float blue value)

Функция cpdf_setrgbcolor_fill() устанавливает rgb-значение текущего цвета заполнения пути/path.

См. также cpdf_setrgbcolor_stroke(), cpdf_setrgbcolor().

cpdf_setrgbcolor_stroke

(PHP 3>= 3.0.8, PHP 4)

cpdf_setrgbcolor_stroke - устанавливает rgb-значение цвета прорисовки.

Описание

void cpdf_setrgbcolor_stroke (int pdf document, float red value, float green value, float blue value)

Функция cpdf_setrgbcolor_stroke() устанавливает rgb-значение текущего цвета прорисовки.

См. также cpdf_setrgbcolor_fill(), cpdf_setrgbcolor().

cpdf_show

(PHP 3>= 3.0.8, PHP 4)

cpdf_show - выводит текст, начиная с текущей позиции.

Описание

void cpdf_show (int pdf document, string text)

Функция cpdf_show() выводит строку text в текущей позиции.

См. также cpdf_text(), cpdf_begin_text(), cpdf_end_text().

cpdf_show_xy

(PHP 3>= 3.0.8, PHP 4)

cpdf_show_xy - выводит текст в данной позиции.

Описание

void cpdf_show_xy (int pdf document, string text, float x-coor, float y-coor [, int mode])

Функция cpdf_show_xy() выводит строку текста text в позиции с координатами (x-coor, y-coor).

Необязательный параметр mode определяет размер единиц измерения/unit length. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

Примечание: функция cpdf_show_xy() идентична cpdf_text() без необязательных параметров.

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

cpdf_stringwidth

(PHP 3>= 3.0.8, PHP 4)

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

Описание

float cpdf_stringwidth (int pdf document, string text)

Функция cpdf_stringwidth() возвращает ширину строки в text. Она требует, чтобы шрифт был установлен до этого.

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

cpdf_stroke

(PHP 3>= 3.0.8, PHP 4)

cpdf_stroke - рисует линию вокруг пути/path.

Описание

void cpdf_stroke (int pdf document)

Функция cpdf_stroke() рисует линию вокруг текущего пути.

См. также cpdf_closepath(), cpdf_closepath_stroke().

cpdf_text

(PHP 3>= 3.0.8, PHP 4)

cpdf_text - выводит текст с параметрами.

Описание

void cpdf_text (int pdf document, string text, float x-coor, float y-coor [, int mode [, float orientation [, int alignmode]]])

Функция cpdf_text() выводит строку текста text в позиции с координатами (x-coor, y-coor).

Необязательный параметр mode определяет размер единиц измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц. Необязательный параметр orientation это поворот текста в градусах. Необязательный параметр alignmode определяет, как текст выравнивается.

См. в документации ClibPDF возможные значения.

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

cpdf_translate

(PHP 3>= 3.0.8, PHP 4)

cpdf_translate - устанавливает точку отсчёта системы координат.

Описание

void cpdf_translate (int pdf document, float x-coor, float y-coor [, int mode])

Функция cpdf_translate() устанавливает точку отсчёта системы координат (x-coor, y-coor).

Необязательный параметр mode определяет размер единиц измерения. Если он равен 0 или отсутствует, по умолчанию используются единицы, установленные для страницы. Иначе координаты измеряются в пунктах postscript без учёта текущих единиц.

crack_check

(PHP 4 >= 4.0.5)

crack_check - выполняет скрытую проверку с данным паролем.

Описание

bool crack_check ([resource dictionary, string password])

Возвращает TRUE, если password надёжен, FALSE в ином случае.

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

crack_check() выполняет скрытую проверку с данным паролем password в специфицированном словаре dictionary. Если dictionary не специфицирован, используется последний открыты словарь.

crack_closedict

(PHP 4 >= 4.0.5)

crack_closedict - закрывает открытый CrackLib-словарь.

Описание

bool crack_closedict ([resource dictionary])

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

Предупреждение!

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

crack_closedict() закрывает специфицированный идентификатор dictionary. Если dictionary не специфицирован, закрывается текущий словарь.

crack_getlastmessage

(PHP 4 >= 4.0.5)

crack_getlastmessage - возвращает сообщение от последней скрытой проверки.

Описание

string crack_getlastmessage (void)

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

crack_getlastmessage() возвращает от последней скрытой проверки/obscure check.

crack_opendict

(PHP 4 >= 4.0.5)

crack_opendict - открывает новый CrackLib-словарь.

Описание

resource crack_opendict (string dictionary)

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

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

crack_opendict() открывает специфицированный CrackLib dictionary для использования с crack_check().

Примечание: только один словарь может быть в открытом виде в данное время.

См. также crack_check() и crack_closedict().

crc32

(PHP 4 >= 4.0.1)

crc32 - вычисляет crc32-полином строки.

Описание

int crc32 (string str)

Генерирует циклически избыточный checksum-полином 32-битных длин str. Это обычно используется для проверки целостности передаваемых данных.

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

create_function

(PHP 4 >= 4.0.1)

create_function - создаёт анонимную функцию (lambda-стиль).

Описание

string create_function (string args, string code)

Создаёт анонимную функцию из передаваемых параметров и возвращает уникальное имя для неё. Обычно аргументы args будут передаваться в единой закавыченной строке, это же рекомендуется и для code. Смысл использования отдельных закавыченных строк в том, чтобы защитить имена переменных от разбора, иначе, если вы используете двойные кавычки, появится необходимость мнемонизировать имена переменных, например, \$avar.

Вы можете использовать эту функцию для (например) создания функции из информации, получаемой на этапе прогона:

crypt

(PHP 3, PHP 4)

crypt - одностороннее шифрование строк (хэширование).

Описание

string crypt (string str [, string salt])

crypt() возвратит шифрованную строку с использованием стандартного алгоритма шифрования Unix на базе DES или альтернативных алгоритмов, которые могут быть доступны в данной системе. Аргументами является шифруемая строка и необязательная строка salt как база шифрования. См. Unix man-страницу для вашей crypt-функции.

Если аргумент salt не предоставлен, он будет произвольно сгенерирован PHP.

Некоторые ОС поддерживают более одного типа шифрования. На практике иногда стандартное DES-шифрование заменяется алгоритмом на базе MD5. Тип шифрования переключается аргументом salt. Во время установки PHP определяет возможности crypt-функции и будет принимать salts для других типов шифрования. Если salt не предоставлен, PHP будет автоматически генерировать стандартный двухсимвольный salt по умолчанию, если только тип шифрования по умолчанию в системе не MD5 - тогда генерируется произвольный MD5-совместимый salt. PHP устанавливает константу CRYPT_SALT_LENGTH, которая сообщает вам, применяется ли для вашей системы обычный двухсимвольный salt или более длинный 12-символьный salt.

Если вы используете предоставляемый salt, вы должны убедиться, что этот salt генерируется один раз. Если вы вызываете эту функцию рекурсивно, это может повлиять и на вид, и на безопасность.

Стандартная шифровка crypt() на базе DES возвращает salt как первые два символа вывода. Она также использует лишь первые восемь символов из str, поэтому строки большей длины, начинающиеся теми же самыми восемью символами, сгенерируют тот же результат (когда используется тот же salt).

В системах, где функция crypt() поддерживает несколько типов шифрования, следующие константы устанавливаются в значения 0 или 1, в зависимости от того, доступен ли данный тип:

CRYPT_STD_DES - стандартное шифрование на базе DES с двухсимвольным salt

CRYPT_EXT_DES - расширенное шифрование на базе DES с девятисимвольным salt

CRYPT_MD5 - шифрование MD5 с 12-символьным salt, начиная с $1$

CRYPT_BLOWFISH - Blowfish-шифрование с 16-символьным salt, начиная с $2$

Примечание: отсутствует функция дешифрования, поскольку crypt() использует однопутный алгоритм.

ctype_alnum

(PHP 4 >= 4.0.4)

ctype_alnum - проверяет наличие алфавитного символа(ов).

Описание

bool ctype_alnum (string text)

Возвращает TRUE, если каждый символ в text является буквой либо цифрой, FALSE в противном случае. В стандарте C локальными буквами являются [A-Za-z]. Эта функция эквивалентна (ctype_alpha($text) || ctype_digit($text)).

См. также ctype_alpha(), ctype_digit() и setlocale().

ctype_alpha

(PHP 4 >= 4.0.4)

ctype_alpha - проверяет наличие алфавитного символа(ов).

Описание

bool ctype_alpha (string text)

Возвращает TRUE, если каждый символ в text является буквой текущей локализации, FALSE - в противном случае. В стандарте C локальными буквами являются [A-Za-z]. Эта функция эквивалентна (ctype_upper($text) || ctype_lower($text)), но в других языках имеются буквы, которые не учитываются ни в верхнем, ни в нижнем регистре.

См. также ctype_upper(), ctype_lower() и setlocale().

ctype_cntrl

(PHP 4 >= 4.0.4)

ctype_cntrl - проверяет наличие управляющего символа(ов).

Описание

bool ctype_cntrl (string text)

Возвращает TRUE, если каждый символ в text выполняет специальную управляющую функцию, FALSE в противном случае. Управляющие символы это line feed/прогон строки, tab/табуляция, esc, и так далее.

ctype_digit

(PHP 4 >= 4.0.4)

ctype_digit - проверяет наличие цифр.

Описание

bool ctype_digit (string text)

Возвращает TRUE, если каждый символ в text является десятеричной цифрой, FALSE в ином случае.

См. также ctype_alnum() и ctype_xdigit().

ctype_graph

(PHP 4 >= 4.0.4)

ctype_graph - проверяет наличие печатаемых символов, за исключением space/пробелов.

Описание

bool ctype_graph (string text)

Возвращает TRUE, если каждый символ в text является печатаемым и создаёт видимый вывод (без пробелов), FALSE в ином случае.

См. также ctype_alnum(), ctype_print() и ctype_punct().

ctype_lower

(PHP 4 >= 4.0.4)

ctype_lower - проверяет наличие символов нижнего регистра.

Описание

bool ctype_lower (string text)

Возвращает TRUE, если каждый символ в text является буквой в нижнем регистре в текущей локализации.

См. также ctype_alpha() и ctype_upper().

ctype_print

(PHP 4 >= 4.0.4)

ctype_print - проверяет наличие печатаемых символов.

Описание

bool ctype_print (string text)

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

См. также ctype_cntrl(), ctype_graph() и ctype_punct().

ctype_punct

(PHP 4 >= 4.0.4)

ctype_punct - проверяет наличие печатаемых символов, которые не являются пробелами или алфавитно-числовыми символами.

Описание

bool ctype_punct (string text)

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

См. также ctype_cntrl() и ctype_graph().

ctype_space

(PHP 4 >= 4.0.4)

ctype_space - проверяет наличие пробельных символов.

Описание

bool ctype_space (string text)

Возвращает TRUE, если каждый символ в text создаёт какой-либо вид пробела, FALSE в ином случае. Помимо пробельных символов сюда входят также символы tab/табуляции, vertical tab/вертикальной табуляции, line feed/прогона строки, carriage return/возврата каретки и form feed/прогона страницы.

ctype_upper

(PHP 4 >= 4.0.4)

ctype_upper - проверяет наличие символов верхнего регистра.

Описание

bool ctype_upper (string text)

Возвращает TRUE, если каждый символ в text является буквой в верхнем регистре в текущей локализации.

См. также ctype_alpha() и ctype_lower().

ctype_xdigit

(PHP 4 >= 4.0.4)

ctype_xdigit - проверяет наличие символов, представляющих 16-ричные цифры.

Описание

bool ctype_xdigit (string text)

Возвращает TRUE, если каждый символ в text является 16-ричной 'цифрой', то есть 10-ричной цифрой или символом в диапазоне [A-Fa-f], FALSE в противном случае.

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

curl_close

(PHP 4 >= 4.0.2)

curl_close - закрывает CURL-сессию.

Описание

void curl_close ( resource ch)

Эта функция закрывает сессию CURL и освобождает все ресурсы. CURL-дескриптор ch также удаляется.

curl_errno

(PHP 4 >= 4.0.3)

curl_errno - возвращает целое число, содержащее номер последней ошибки.

Описание

int curl_errno ( resource ch)

Предупреждение!

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

curl_error

(PHP 4 >= 4.0.3)

curl_error - возвращает строку содержащую номер последней ошибки для текущей сессии.

Описание

string curl_error (resource ch)

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

curl_exec

(PHP 4 >= 4.0.2)

curl_exec - выполняет CURL-сессию.

Описание

bool curl_exec (resource ch)

Эта функция должна вызываться после того, как вы инициализируете сессию CURL и все опции этой сессии уже установлены. Её назначение в том, чтобы просто выполнить предопределённую CURL-сессию (заданную в параметре ch).

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

curl_getinfo

(PHP 4 >= 4.0.4)

curl_getinfo - получает информацию, касающуюся специфической передачи/transfer.

Описание

string curl_getinfo (resource ch, int opt)

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

curl_init

(PHP 4 >= 4.0.2)

curl_init - инициализирует CURL-сессию.

Описание

resource curl_init ([string url])

Функция curl_init() инициализирует новую сессию и возвратит CURL-дескриптор для использования в функциях curl_setopt(), curl_exec() и curl_close(). Если необязательный параметр url предоставлен, то опция CURLOPT_URL получит значение этого параметра. Вы можете вручную устанавливать его с помощью функции curl_setopt().

curl_setopt

(PHP 4 >= 4.0.2)

curl_setopt - устанавливает опции для CURL-трансфера/transfer.

Описание

bool curl_setopt (resource ch, string option, mixed value)

Функция curl_setopt() устанавливает опции для CURL-сессии, идентифицируемой параметром ch. Параметр option является опцией, которую вы хотите установить, а value это значение опции option.

Параметр value должен быть long для следующих опций (специфицированных параметром option): CURLOPT_INFILESIZE: Если вы выгружаете файл на удалённый сайт, эта опция должна использоваться, для того чтобы сообщит PHP, какой будет ожидаемый размер infile. CURLOPT_VERBOSE: Установите эту опцию в ненулевое значение, если вы хотите, чтобы CURL сообщала обо всех действиях. CURLOPT_HEADER: Установите эту опцию в ненулевое значение, если вы хотите, чтобы шапка/header включалась в вывод.CURLOPT_NOPROGRESS: Установите эту опцию в ненулевое значение, если вы не хотите, чтобы PHP выводил индикатор процесса CURL-трансфера.

Примечание: PHP автоматически устанавливает эту опцию в ненулевое значение, изменять её необходимо лишь при отладке.

CURLOPT_NOBODY: Установите эту опцию в ненулевое значение, если вы не хотите, чтобы тело/body включалось в вывод.CURLOPT_FAILONERROR: Установите эту опцию в ненулевое значение, если вы хотите, чтобы PHP завершал работу скрыто, если возвращаемый HTTP-код имеет значение выше 300. По умолчанию страница возвращается нормально с игнорированием кода. CURLOPT_UPLOAD: Установите эту опцию в ненулевое значение, если вы хотите, чтобы PHP подготавливал файл к выгрузке.CURLOPT_POST: Установите эту опцию в ненулевое значение, если вы хотите, чтобы PHP выполнял регулярный HTTP POST. Этот POST имеет нормальный вид application/x-www-form-urlencoded, чаще всего используемый HTML-формами. CURLOPT_FTPLISTONLY: Установите эту опцию в ненулевое значение, и PHP будет выводит листинг имён FTP-директории. CURLOPT_FTPAPPEND: Установите эту опцию в ненулевое значение, и PHP будет присоединять к удалённому/remote файлу, вместо его перезаписи.CURLOPT_NETRC: Установите эту опцию в ненулевое значение, и PHP будет сканировать ваш файл ~./netrc с целью поиска ваших username и password для удалённого сайта, с которым вы устанавливаете соединение.CURLOPT_FOLLOWLOCATION: Установите эту опцию в ненулевое значение, чтобы следовать любому "Location: " header, который сервер высылает как часть HTTP header'а (заметьте, что это рекурсия, PHP будет следовать за всеми "Location: "-header'ами, которые высылаются.) CURLOPT_PUT: Установите эту опцию в ненулевое значение, чтобы HTTP PUT файл. Файл для PUT обязан быть установлен с помощью CURLOPT_INFILE и CURLOPT_INFILESIZE. CURLOPT_MUTE: Установите эту опцию в ненулевое значение, и PHP будет работать скрыто в отношении CURL-функций.CURLOPT_TIMEOUT: Передаёт long как параметр, который содержит максимальное время в секундах, которое вы отводите для работы CURL-функций.CURLOPT_LOW_SPEED_LIMIT: Передаёт long как параметр, который содержит скорость трансфера в байтах в секунду, ниже которого трансфер должен работать в процессе выполнения CURLOPT_LOW_SPEED_TIME, в секундах, чтобы PHP считал его слишком медленным и прерывал его. CURLOPT_LOW_SPEED_TIME: Передаёт long как параметр, который содержит время в секундах, ниже которого трансфер должен работать в процессе выполнения CURLOPT_LOW_SPEED_LIMIT, чтобы PHP считал его слишком медленным и прерывал его.

CURLOPT_RESUME_FROM: Передаёт long как параметр, который содержит смещение в байтах, с которого трансфер должен стартовать. CURLOPT_SSLVERSION: Передаёт long как параметр, который содержит используемую версию SSL (2 или 3). По умолчанию PHP пытается определить это сам, хотя в некоторых случаях вы обязаны устанавливать это вручную. CURLOPT_SSL_VERIFYHOST: Передаёт long, если CURL должна проверять Common-имя peer-сертификата в SSL handshake/"рукопожатие". Значение 1 указывает, что мы должны проверить существование общего /common имени, значение 2 указывает, что мы должны убедиться в совпадении с предоставленным hostname. CURLOPT_TIMECONDITION: Передаёт long как параметр, который определяет, как рассматривается CURLOPT_TIMEVALUE. Вы можете установить этот параметр для TIMECOND_IFMODSINCE или TIMECOND_ISUNMODSINCE. Это действует только для HTTP. CURLOPT_TIMEVALUE: Передаёт long как параметр, который является временем в секундах, прошедшим после 1 января 1970. Это время используется, как специфицировано опцией CURLOPT_TIMEVALUE, или по умолчанию будет использоваться TIMECOND_IFMODSINCE. CURLOPT_RETURNTRANSFER: Передаёт ненулевое значение, если вы хотите, чтобы CURL непосредственно возвращала трансфер, вместо его печати напрямую.

Параметр value должен быть строкой для следующих значений параметра option: CURLOPT_URL: Это URL, который PHP должен получать. Вы можете также устанавливать эту опцию при инициализации сессии функцией curl_init(). CURLOPT_USERPWD: Передаёт в РНР строку, отформатированную в виде [username]:[password], для использования при соединении.CURLOPT_PROXYUSERPWD: Передаёт в РНР строку, отформатированную в виде [username]:[password], для соединения с HTTP-прокси.CURLOPT_RANGE: Передаёт специфицированный вами диапазон. Он должен быть в формате "X-Y", где X или Y могут отсутствовать. HTTP-трансферы поддерживают также различные интервалы, разделённые запятыми, как, например, X-Y,N-M. CURLOPT_POSTFIELDS: Передаёт строку, содержащую полные данные для передачи операцией HTTP "POST". CURLOPT_REFERER: Передаёт строку, содержащую "referer/ссылающийся" header, используемый в HTTP-запросе. CURLOPT_USERAGENT: Передаёт строку, содержащую "user-agent" header, используемый в HTTP-запросе. CURLOPT_FTPPORT: Передаёт строку, содержащую значение, которое будет использоваться для получения IP-адреса для инструкции ftp "POST". POST-инструкция указывает удалённому серверу: соединиться со специфицированным IP-адресом. Строка может быть обычным IP-адресом, hostname/именем хоста, именем сетевого интерфейса (под UNIX), ил просто обычным '-', используемым для системного IP-адреса по умолчанию. CURLOPT_COOKIE: Передаёт строку с содержимым куки/cookie, установленным в HTTP header'е. CURLOPT_SSLCERT: Передаёт строку, содержащую filename форматированного сертификата PEM. CURLOPT_SSLCERTPASSWD: Передаёт строку, содержащую password, необходимый для работы сертификата CURLOPT_SSLCERT. CURLOPT_COOKIEFILE: Передаёт строку, содержащую имя файла с данными куки. Этот cookie-файл может иметь формат Netscape, или содержать обычные шапки/headers в HTTP-стиле, забитые в файл.CURLOPT_CUSTOMREQUEST: Передаёт строку, используемую вместо GET или HEAD при выполнении HTTP-запроса. Это делается для выполнения DELETE или других, более скрытых HTTP-запросов. Верными значениями являются GET, POST и так далее; то есть не вводите здесь полную строку HTTP-запроса. Например, ввод 'GET /index.html HTTP/1.0\r\n\r\n' будет некорректным.

Примечание: не делайте это, если не уверены, что ваш сервер поддерживает эту команду.

CURLOPT_PROXY: Передаёт имя HTTP-прокси туннельным запросам. CURLOPT_INTERFACE: Передаёт имя исходящего сетевого интерфейса для использования. Это может быть имя интерфейса, IP-адрес или имя хоста.CURLOPT_KRB4LEVEL: Передаёт KRB4 (Kerberos 4) уровень секретности. Это любая из следующих строк (в порядке от менее до более мощной): 'clear', 'safe', 'confidential', 'private'.
Если эта строка не совпадает с какой-либо из указанных, то используется 'private'. Если вы установите здесь NULL, это отключит KRB4-безопасность. KRB4-безопасность работает в настоящее время только с транзакциями FTP.CURLOPT_HTTPHEADER: Передаёт массив полей HTTP-header'а для установки.

CURLOPT_QUOTE: Передаёт массив FTP-команд для выполнения на сервере до выполнения FTP-запроса.CURLOPT_POSTQUOTE: Передаёт массив FTP-команд для выполнения на сервере после выполнения FTP-запроса.

Следующие опции ожидают дескриптора файла, который получается с помощью функции fopen(): CURLOPT_FILE: Файл, куда должен быть помещён вывод вашего трансфера, по умолчанию это STDOUT. CURLOPT_INFILE: Файл, из которого приходит ввод вашего трансфера. CURLOPT_WRITEHEADER: Файл для записи header-части вывода. CURLOPT_STDERR: Файл для записи ошибок, вместо stderr.

curl_version

(PHP 4 >= 4.0.2)

curl_version - возвращает версию текущей CURL.

Описание

string curl_version (void)

Функция curl_version() возвращает строку с текущей версией CURL.

current

(PHP 3, PHP 4)

current - возвращает текущий элемент массива.

Описание

mixed current (array array)

Каждый массив имеет внутренний указатель на его "текущий" элемент, который (указатель) инициализируется на первый элемент массива.

Функция current() просто возвращает элемент массива, на который в данный момент указывает внутренний указатель. Она не перемещает этот указатель. Если указатель стоит после конца списка элементов, current() возвращает FALSE. Предупреждение!Если в массиве содержатся пустые элементы (0 или "", пустые строки), эта функция будет также возвращать FALSE и для этих элементов. Это делает невозможным определение того, действительно ли вы находитесь в конце списка такого массива, с использованием current(). Чтобы правильно проходить по массиву, содержащему пустые элементы, используйте функцию each().

См. также end(), next(), prev() и reset().

cybercash_base64_decode

(PHP 4)

cybercash_base64_decode - декодирует base64-данные для Cybercash.

Описание

string cybercash_base64_decode (string inbuff)

cybercash_base64_encode

(PHP 4)

cybercash_base64_encode - кодирует данные на базе base64 для Cybercash.

Описание

string cybercash_base64_encode (string inbuff)

cybercash_decr

(PHP 4)

cybercash_decr - Cybercash decrypt/дешифровка.

Описание

array cybercash_decr (string wmk, string sk, string inbuff)

Эта функция возвращает ассоциативный массив с элементами "errcode" и, если "errcode" FALSE, "outbuff" (string), "outLth" (long) и "macbuff" (string).

cybercash_encr

(PHP 4)

cybercash_encr - Cybercash encrypt/шифровка.

Описание

array cybercash_encr (string wmk, string sk, string inbuff)

Функция возвращает ассоциативный массив с элементами "errcode" и, если "errcode" FALSE, "outbuff" (string), "outLth" (long) и "macbuff" (string).

cybermut_creerformulairecm

(PHP 4 >= 4.0.5)

cybermut_creerformulairecm - генерирует HTML-форму запроса для платежа.

Описание

string cybermut_creerformulairecm (string url_CM, string version, string TPE, string montant, string ref_commande, string texte_libre, string url_retour, string url_retour_ok, string url_retour_err, string langue, string code_societe, string texte_bouton)

cybermut_creerformulairecm() используется для генерации HTML-формы запроса для платежа.

cybermut_creerreponsecm

(PHP 4 >= 4.0.5)

cybermut_creerreponsecm - генерирует расписку о получении платежа.

Описание

string cybermut_creerreponsecm (string phrase)

cybermut_creerreponsecm() возвращает строку, содержащую сообщение о расписке о получении.

Параметр "OK", если сообщение о подтверждении платежа было корректно идентифицировано функцией cybermut_testmac(). Любая другая цепочка рассматривается как сообщение об ошибке.

См. также cybermut_creerformulairecm() и cybermut_testmac().

cybermut_testmac

(PHP 4 >= 4.0.5)

cybermut_testmac - убеждается, что не было "левых" данных в полученном сообщении подтверждения.

Описание

bool cybermut_testmac (string code_MAC, string version, string TPE, string cdate, string montant, string ref_commande, string texte_libre, string code-retour)

Функция cybermut_testmac() используется для того, чтобы убедиться, что не было "левых" данных в полученном сообщении подтверждения. Обратите внимание на параметры code-retour и texte-libre, которые не вычисляются как таковые из-за наличия дефиса. Вы обязаны затребовать их так:

cyrus_authenticate

(PHP 4 >= 4.1.0)

cyrus_authenticate - аутентификация относительно Cyrus IMAP-сервера.

Описание

bool cyrus_authenticate (resource connection [, string mechlist [, string service [, string user [, int minssf [, int maxssf]]]]])

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

cyrus_bind

(PHP 4 >= 4.1.0)

cyrus_bind - связывает обратные вызовы/callbacks с Cyrus IMAP-соединением.

Описание

bool cyrus_bind (resource connection, array callbacks)

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

cyrus_close

(PHP 4 >= 4.1.0)

cyrus_close - закрывает соединение с cyrus-сервером.

Описание

bool cyrus_close (resource connection)

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

cyrus_connect

(PHP 4 >= 4.1.0)

cyrus_connect - соединяет с Cyrus IMAP-сервером.

Описание

resource cyrus_connect ([string host [, string port [, int flags]]])

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

cyrus_query

(PHP 4 >= 4.1.0)

cyrus_query - отправляет запрос Cyrus IMAP-серверу.

Описание

bool cyrus_query (resource connection, string query)

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

cyrus_unbind

(PHP 4 >= 4.1.0)

cyrus_unbind - отвязывает ...

Описание

bool cyrus_unbind (resource connection, string trigger_name)

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

date

(PHP 3, PHP 4)

date - формат локального времени/даты.

Описание

string date (string format [, int timestamp])

Возвращает строку, отформатированную в соответствии со строкой формата с использованием заданного целочисленного timestamp или текущего локального времени, если timestamp/"штамп времени" не задан.

Примечание: правильный диапазон значений для timestamp обычно: с Fri, 13 Dec 1901 20:45:54 GMT до Tue, 19 Jan 2038 03:14:07 GMT. (Это даты, соответствующие максимальному и минимальному значениям 32-битного целого числа). В windows этот диапазон ограничен датами от 01-01-1970 до 19-01-2038.

Для генерации timestamp из строки, представляющей дату, вы можете использовать strtotime(). Кроме того, некоторые базы данных имеют функции для конвертации их форматов даты в timestamp'ы (такие как функция MySQL'а UNIX_TIMESTAMP).

В строке формата распознаются следующие символы: a - "am" или "pm"A - "AM" или "PM"B - время Swatch Internet d - день (число) месяца, 2 цифры с ведущим нулём, если необходимо; т. е. от "01" до "31" D - день недели, буквенный, 3 буквы; например, "Fri"F - месяц, буквенный, long; например, "January" g - час, 12-часовой формат без ведущих нулей; т.е. от "1" до "12" G - час, 24-часовой формат без ведущих нулей; т.е. от "0" до "23" h - час, 12-часовой формат; т.е. от "01" до "12"H - час, 24-часовой формат; т.е. от "00" до "23" i - минуты; т.е. от "00" до "59"I (заглавная i) - "1", если Daylight Savings Time, "0" - в противном случае.j - день (число) месяца без ведущих нулей; т.е. от "1" до "31" l ('L' в нижнем регистре) - день недели, буквенный, long; например, "Friday" L - boolean, указывающее, високосный ли год; т.е. "0" или "1" m - месяц; т.е. от "01" до "12"M - месяц, буквенный, 3 буквы; например, "Jan" n - месяц без ведущих нулей; т.е. от "1" до "12" O - Разница с временем по Гринвичу, в часах; например, "+0200" r - RFC 822 формат даты; например, "Thu, 21 Dec 2000 16:01:07 +0200" (введён в PHP 4.0.4) s - секунды; т.е. от "00" до "59"S - простой английский суффикс для дня (числа) месяца, 2 символа; т.е. "st", "nd", "rd" или "th"t - количество дней в данном месяце; т.е. от "28" до "31" T - установка Timezone/Часовой пояс на данной машине; например, "EST" или "MDT" U - секунды эпохи Unix Epoch (начиная с January 1 1970 00:00:00 GMT) w - день недели, числовой, т.е. от "0" (Sunday) до "6" (Saturday) W - ISO-8601 номер недели в году, недели начинаются с понедельника/Monday (введено в PHP 4.1.0) Y - год, 4 цифры; например, "1999"y - год, 2 цифры; например, "99" z - день года; т.е. от "0" до "365"Z - смещение часового пояса, в секундах (т.е. от "-43200" до "43200"). Смещение часовых поясов к западу от UTC всегда отрицательное, а для поясов в востоку от UTC - всегда положительное. Нераспознаваемые символы в строке формата печатаются как есть. Формат "Z" всегда возвращает "0" при использовании gmdate().

dba_close

(PHP 3>= 3.0.8, PHP 4 )

dba_close - закрывает базу данных.

Описание

void dba_close (resource handle)

dba_close() закрывает БД и освобождает все ресурсы, специфицированные handle.

handle это дескриптор БД, возвращённый функцией dba_open().

dba_close() не возвращает никакого значения.

См. также: dba_open() и dba_popen()

dba_delete

(PHP 3>= 3.0.8, PHP 4)

dba_delete - удаляет вхождение, специфицированное ключом.

Описание

bool dba_delete (string key, resource handle)

dba_delete() удаляет вхождение, специфицированное ключом key, из БД, специфицированной параметром handle.

key это ключ удаляемого вхождения.

handle это дескриптор БД, возвращаемый функцией dba_open().

dba_delete() возвращает TRUE или FALSE, если вхождение удаляется или нет, соответственно.

См. также dba_exists(), dba_fetch(), dba_insert() и dba_replace().

dba_exists

(PHP 3>= 3.0.8, PHP 4)

dba_exists - проверяет, существует ли ключ.

Описание

bool dba_exists (string key, resource handle)

dba_exists() проверяет, существует ли специфицированный key в БД, специфицированной в handle.

Key это ключ, который проверяется.

Handle это дескриптор БД, возвращаемый функцией dba_open().

dba_exists() возвращает TRUE или FALSE, если ключ найден или нет, соответственно.

См. также dba_fetch(), dba_delete(), dba_insert() и dba_replace().

dba_fetch

(PHP 3>= 3.0.8, PHP 4)

dba_fetch - извлекает данные, специфицированные ключом.

Описание

string dba_fetch (string key, resource handle)

dba_fetch() извлекает данные, специфицированные ключом key, из БД, специфицированной в handle.

Key это ключ, которым специфицированы данные.

Handle это дескриптор БД, возвращаемый функцией dba_open().

dba_fetch() возвращает ассоциированную строку или FALSE, если пара key/data найдена или не найдена, соответственно.

См. также dba_exists(), dba_delete(), dba_insert() и dba_replace().

dba_firstkey

(PHP 3>= 3.0.8, PHP 4)

dba_firstkey - извлекает первый ключ.

Описание

string dba_firstkey (resource handle)

dba_firstkey() возвращает первый ключ из БД, специфицированной в handle, и переустанавливает внутренний указатель на ключ. Это позволяет выполнять линеарный поиск по всей БД.

Handle это дескриптор БД, возвращаемый функцией dba_open().

dba_firstkey() возвращает ключ или FALSE, в зависимости от того, успешно она выполнена или нет, соответственно.

См. также dba_nextkey() и пример 2 в примерах DBA.

dba_insert

(PHP 3>= 3.0.8, PHP 4)

dba_insert - вставляет вхождение.

Описание

bool dba_insert (string key, string value, resource handle)

dba_insert() вставляет вхождение, описанное ключом key и значением value, в БД, специфицированную дескриптором handle. Терпит неудачу, если вхождение с тем же самым key уже существует.

key это ключ вставляемого вхождения.

value это вставляемое значение.

handle это дескриптор БД, возвращаемый функцией dba_open().

dba_insert() возвращает TRUE или FALSE, в зависимости от успеха или неудачи, соответственно.

См. также dba_exists(), dba_delete(), dba_fetch(), dba_replace().

dba_nextkey

(PHP 3>= 3.0.8, PHP 4)

dba_nextkey - получает следующий ключ.

Описание

string dba_nextkey (resource handle)

dba_nextkey() возвращает следующий ключ из БД, специфицированной в handle и передвигающей внутренний указатель ключей.

handle это дескриптор БД, возвращаемый функцией dba_open().

dba_nextkey() возвращает ключ или FALSE, в зависимости от успеха или неудачи, соответственно.

См. также dba_firstkey() и пример 2 примерах DBA.

dba_open

(PHP 3>= 3.0.8, PHP 4)

dba_open - открывает базу данных.

Описание

resource dba_open (string path, string mode, string handler [, ...])

dba_open() устанавливает экземпляр БД для path с режимом mode, используя handler.

path это обычный регулярный путь в вашей файловой системе.

mode это "r" - режим доступа для чтения (read), "w" для чтения/записи (read/write) к уже существующей БД, "c" для чтения/записи и создания БД, если она не существует, "n" для создания, усечения и для чтения/записи.

handler это имя дескриптора, который будет использован при доступе к path. Он передаёт все параметры-опции для dba_open() и работает от его имени.

dba_open() возвращает положительный дескриптор или FALSE, в случаях успеха и неудачи, соответственно.

См. также dba_popen(), dba_close().

dba_optimize

(PHP 3>= 3.0.8, PHP 4)

dba_optimize - оптимизирует БД.

Описание

bool dba_optimize (resource handle)

dba_optimize() оптимизирует БД, специфицированную в handle.

handle это дескриптор БД , возвращаемый функцией dba_open().

dba_optimize() возвращает TRUE или FALSE, если оптимизация успешна или неудачна, соответственно.

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

dba_popen

(PHP 3>= 3.0.8, PHP 4)

dba_popen - открывает БД на постоянной основе.

Описание

resource dba_popen (string path, string mode, string handler [, ...])

dba_popen() устанавливает постоянный экземпляр БД для path с mode с использованием handler.

path это обычный регулярный путь вашей файловой системы.

mode это "r" - режим доступа для чтения (read), "w" для чтения/записи (read/write) к уже существующей БД, "c" для чтения/записи и создания БД, если она не существует, "n" для создания, усечения и для чтения/записи.

handler это имя дескриптора, который будет использован при доступе к path. Он передаёт все параметры-опции для dba_popen() и может работать от его имени.

dba_popen() возвращает положительный дескриптор или FALSE, в случаях успеха открытия или неудачи, соответственно.

См. также dba_open(), dba_close().

dba_replace

(PHP 3>= 3.0.8, PHP 4)

dba_replace - замещает или вставляет вхождение.

Описание

bool dba_replace (string key, string value, resource handle)

dba_replace() замещает или вставляет вхождение, описанное key и value в БД handle.

key это ключ вставляемого вхождения.

value это вставляемое значение.

handle это дескриптор БД, возвращаемый функцией dba_open().

dba_replace() возвращает TRUE или FALSE, в зависимости от успеха или неудачи, соответственно.

См. также dba_exists(), dba_delete(), dba_fetch() и dba_insert().

dba_sync

(PHP 3>= 3.0.8, PHP 4)

dba_sync - синхронизирует БД.

Описание

bool dba_sync (resource handle)

dba_sync() синхронизирует БД handle. Это может быть тригер физической записи на диск, если поддерживается.

handle это дескриптор БД, возвращённый из dba_open().

dba_sync() возвращает TRUE или FALSE, если синхронизация проходит или нет, соответственно.

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

dbase_add_record

(PHP 3, PHP 4)

dbase_add_record - добавляет запись в БД dBase.

Описание

bool dbase_add_record (int dbase_identifier, array record)

Добавляет данные в record в БД. Если количество элементов в предоставляемой записи не равно количеству полей в БД, операция терпит неудачу, и возвращается FALSE.

dbase_close

(PHP 3, PHP 4)

dbase_close - закрывает БД dBase.

Описание

bool dbase_close (int dbase_identifier)

Закрывает БД, ассоциированную с dbase_identifier.

dbase_create

(PHP 3, PHP 4)

dbase_create - создаёт БД dBase.

Описание

int dbase_create (string filename, array fields)

Параметр fields это массив массивов, где каждый массив описывает формат одного поля БД. Каждое поле состоит из имени, символа, указывающего тип поля, размера и точности.

Имеются следующие типы полей:

L

Boolean. Не имеют размера и точности.

M

Memo. (Эти не поддерживаются в PHP.) Не имеют размера и точности.

D

Date (дата, хранимая как YYYYMMDD). Не имеют размера и точности.

N

Number. Имеют размер и точность (количество цифр после десятичной точки).

C

String.

Если БД успешно создана, возвращается dbase_identifier, иначе возвращается FALSE.

dbase_delete_record

(PHP 3, PHP 4)

dbase_delete_record - удаляет запись из БД dBase.

Описание

bool dbase_delete_record (int dbase_identifier, int record)

Помечает record для удаления из БД. Для фактического удаления записи из БД вы оябзаны вызвать также функцию dbase_pack().

dbase_get_record

(PHP 3, PHP 4)

dbase_get_record - получает запись из БД dBase.

Описание

array dbase_get_record (int dbase_identifier, int record)

Возвращает данные из record в виде массива. Массив индексируется, начиная с 0, и включает ассоциативный член 'deleted', который установлен в 1, если запись помечена для удаления (см. dbase_delete_record()).

Каждое поле конвертируется в соответствующий тип PHP, за исключением:

Дат, остающихся строками.

Целые числа, которые могут вызывать переполнение (> 32 бит), возвращаются как строки.

dbase_get_record_with_names

(PHP 3>= 3.0.4, PHP 4)

dbase_get_record_with_names - получает запись из БД dBase как ассоциативный массив.

Описание

array dbase_get_record_with_names (int dbase_identifier, int record)

Возвращает данные из записи record в виде ассоциативного массива. Этот массив также включает ассоциативный член 'deleted', который установлен в 1, если запись помечена для удаления (см. dbase_delete_record()).

Каждое поле конвертируется в соответствующий тип PHP, исключая:

Даты, остающиеся как строки.

Целые числа, которые могут вызвать переполнение (> 32 бит), возвращаются как строки.

dbase_numfields

(PHP 3, PHP 4)

dbase_numfields - определяет, сколько полей имеется в БД dBase.

Описание

int dbase_numfields (int dbase_identifier)

Возвращает количество полей (столбцов) в специфицированной БД. Номера полей находятся в пределах от 0 до dbase_numfields($db)-1, а номера записей - от 1 до dbase_numrecords($db).

dbase_numrecords

(PHP 3, PHP 4)

dbase_numrecords - определяет, сколько записей имеется в БД dBase.

Описание

int dbase_numrecords (int dbase_identifier)

Возвращает количество записей (рядов) в специфицированной БД. Количество рядов находится в пределах от 1 до dbase_numrecords($db), а количество полей - от 0 до dbase_numfields($db)-1.

dbase_open

(PHP 3, PHP 4)

dbase_open - открывает БД dBase.

Описание

int dbase_open (string filename, int flags)

Флаги flags соответствуют флагам системного вызова open(). (Обычно 0 означает read-only, 1 означает write-only, в 2 означает read и write.)

Возвращает a dbase_identifier для открытой БД или FALSE, если БД не может быть открыта.

Примечание: если safe mode включён, PHP проверяет, имеют ли файл(ы)/директории, с которыми вы собираетесь работать, тот же самый UID, что и выполняемый скрипт.

dbase_pack

(PHP 3, PHP 4)

dbase_pack - упаковывает БД dBase.

Описание

bool dbase_pack (int dbase_identifier)

Упаковывает специфицированную БД (безвозвратно удаляя все записи, помеченные для удаления с использованием dbase_delete_record()).

dbase_replace_record

(PHP 3>= 3.0.11, PHP 4)

dbase_replace_record - замещает запись в БД dBase.

Описание

bool dbase_replace_record (int dbase_identifier, array record, int dbase_record_number)

Замещает данные, ассоциированные с записью record_number, данными из record в БД. Если количество элементов, предоставляемых записью, не равно количеству полей в БД, операция терпит неудачу, и возвращается значение FALSE.

dbase_record_number это целое число, которое находится в пределах от 1 до количества записей в БД (как возвращено из dbase_numrecords()).

dblist

(PHP 3, PHP 4)

dblist - описывает используемую DBM-совместимую библиотеку.

Описание

string dblist (void)

dbmclose

(PHP 3, PHP 4)

dbmclose - закрывает БД dbm.

Описание

bool dbmclose (resource dbm_identifier)

Разблокирует и закрывает специфицированную базу данных.

dbmdelete

(PHP 3, PHP 4)

dbmdelete - удаляет значение для данного ключа/key из БД DBM.

Описание

bool dbmdelete (resource dbm_identifier, string key)

Удаляет значение данного key в БД.

Возвращает FALSE, если этот key не существует в БД.

dbmexists

(PHP 3, PHP 4)

dbmexists - сообщает, существует ли значение для ключа в DBM-БД.

Описание

bool dbmexists (resource dbm_identifier, string key)

Возвращает TRUE, если имеется значение ассоциированное с ключом key.

dbmfetch

(PHP 3, PHP 4)

dbmfetch - получает значение для ключа из базы данных DBM.

Описание

string dbmfetch (resource dbm_identifier, string key)

Возвращает значение, ассоциированное с ключом key.

dbmfirstkey

(PHP 3, PHP 4)

dbmfirstkey - запрашивает первый ключ из БД DBM.

Описание

string dbmfirstkey (resource dbm_identifier)

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

dbminsert

(PHP 3, PHP 4)

dbminsert - вставляет значение с ключом в БД DBM.

Описание

int dbminsert (resource dbm_identifier, string key, string value)

Добавляет значение в БД со специфицированным ключом/key.

Возвращает -1, если БД была открыта как read-only; 0, если вставка прошла успешно, и 1, если специфицированный ключ уже существует. (Для замещения значения используйте функцию dbmreplace().)

dbmnextkey

(PHP 3, PHP 4)

dbmnextkey - запрашивает следующий ключ из БД DBM.

Описание

string dbmnextkey (resource dbm_identifier, string key)

Возвращает следующий ключ после key. Вызывая dbmfirstkey() с последующими вызовами dbmnextkey(), можно просмотреть каждую пару key/value (ключ/значение) dbm-базе данных. Например:

dbmopen

(PHP 3, PHP 4)

dbmopen - открывает DBM-БД.

Описание

resource dbmopen (string filename, string flags)

Первый аргумент это полный путь к открываемому DBM-файлу, а второй - это режим открытия файла, который может иметь значения "r", "n", "c" или "w" для режимов read-only, new (подразумевает read-write и, вероятнее всего, будет усекать уже имеющуюся БД с тем же именем), create (подразумевает read-write и не будет усекать уже имеющуюся БД с тем же именем) и read-write, соответственно.

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

Если используется поддержка NDBM, то NDBM создаст файлы filename.dir и filename.pag.
GDBM использует только один файл, так как имеет внутреннюю поддержку flat-файлов, а Berkeley DB создаёт файл filename.db. Заметьте, что PHP выполняет свою собственную блокировку файлов, что может быть сделано и самой библиотекой DBM. PHP не удаляет .lck-файлы, создаваемые ею. Он использует эти файлы просто как фиксированные inodes, в которых выполняется блокировка файлов. Дополнительно о DBM-файлах см. страницы man Unix или получите GNU's GDBM.

Примечание: если safe mode включён, PHP проверяет, имеют ли файл(ы)/директории, с которыми вы намереваетесь работать, тот же UID, что и выполняемый скрипт.

dbmreplace

(PHP 3, PHP 4)

dbmreplace - замещает значение ключа в БД DBM.

Описание

int dbmreplace (resource dbm_identifier, string key, string value)

Замещает значение для специфицированного ключа/key в БД.

Также добавляется key в БД, если он ещё не существует.

dbplus_add

(только 4.1.0 - 4.2.1)

dbplus_add - добавляет tuple к relation/связи.

Описание

int dbplus_add (resource relation, array tuple)

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

Эта функция добавляет пару/tuple к relation/реляции.
tuple это массив пар attribute/value, вставляемых в данную relation. После успешного выполнения массив tuple будет содержать полные данные о вновь созданном tuple, включая все неявно устанавливаемые поля домена вроде sequences.

Эта функция возвращает нуль (aka. DBPLUS_ERR_NOERR) при успехе или db++ код ошибки - при неудаче. См. dbplus_errcode() или введение к этой главе на предмемт информации ол кодах ошибок db++.

dbplus_aql

(только 4.1.0 - 4.2.1)

dbplus_aql - выполняет AQL-запрос.

Описание

resource dbplus_aql (string query [, string server [, string dbpath]])

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

dbplus_aql() выполнит AQL-запрос query при заданных server и dbpath.

При успехе возвратит реляционный дескриптор. Результирующие данные могут быть получены из это связи путём вызова dbplus_next() и dbplus_current(). Другие функции реляционного доступа не будут работать со связью-результатом.

Информация о AQL A... Query Language предоставляется в оригинальном учебнике по db++.

dbplus_chdir

(только 4.1.0 - 4.2.1)

dbplus_chdir - получает/устанавливает виртуальную текущую директорию БД.

Описание

string dbplus_chdir ([string newdir])

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

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

dbplus_close

(только 4.1.0 - 4.2.1)

dbplus_close - закрывает связь/relation.

Описание

int dbplus_close (resource relation)

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

Вызов dbplus_close() закроет связь, ранее открытую функцией dbplus_open().

dbplus_curr

(только 4.1.0 - 4.2.1)

dbplus_curr - получает текущий tuple из связи/relation.

Описание

int dbplus_curr (resource relation, array tuple)

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

dbplus_curr() будет читать данные из текущего tuple для данной relation и передавать их обратно как ассоциативный массив в tuple.

Эта функция возвращает нуль (aka. DBPLUS_ERR_NOERR) при успехе или код ошибки db++ - при неудаче. См. в dbplus_errcode() или во введении к данной главе информацию о кода ошибок db++.

См. также dbplus_first(), dbplus_prev(), dbplus_next() и dbplus_last().

dbplus_errcode

(только 4.1.0 - 4.2.1)

dbplus_errcode - получает строку ошибки для данного errorcode или последней ошибки.

Описание

string dbplus_errcode (int errno)

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

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

dbplus_errno

(только 4.1.0 - 4.2.1)

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

Описание

int dbplus_errno (void)

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

dbplus_errno() возвратит код ошибки, возвращаемый последней операцией db++.

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

dbplus_find

(только 4.1.0 - 4.2.1)

dbplus_find - устанавливает ограничение для связи/relation.

Описание

int dbplus_find (resource relation, array constraints, mixed tuple)

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

dbplus_find() помещает ограничение на данную связь/relation. Последующие вызовы функций вроде dbplus_curr() или dbplus_next() вернут только tuples/пары, соответствующие данным ограничениям.

Ограничения это триплеты строк, содержащих имя домена, операцию сравнения и значение для сравнения. Массив параметров constraints может состоять из коллекции массивов строк, каждая из которых содержит domain, операцию и значение, или из однострочного массива, содержащего несколько триплетов.

Операция сравнения может быть одной из следующих строк: '==', '>', '>=', '<', '<=', '!=', '~' для совпадения с регулярным выражением, и 'BAND' или 'BOR' - для битовых операций.

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

dbplus_first

(только 4.1.0 - 4.2.1)

dbplus_first - получает первую tuple/пару из связи/relation.

Описание

int dbplus_first (resource relation, array tuple)

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

dbplus_curr() будет создавать данные для первой пары/tuple для данной relation, сделает её текущей tuple и передаст её обратно в tuple как ассоциативный массив.

Эта функция возвратит нуль (aka. DBPLUS_ERR_NOERR) при успехе или код ошибки db++ при неудаче. См. в dbplus_errcode() или во введении к этой главе информацию о кодах ошибок db++.

См. также dbplus_curr(), dbplus_prev(), dbplus_next() и dbplus_last().

dbplus_flush

(только 4.1.0 - 4.2.1)

dbplus_flush - очищает все изменения, сделанные в relation/связи.

Описание

int dbplus_flush (resource relation)

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

dbplus_flush() записывает все изменения, применённые к relation после последней записи на диск.

Эта функция возвратит нуль (aka. DBPLUS_ERR_NOERR) при успехе иди код ошибки db++ при неудаче. См. в dbplus_errcode() или во введении к этой главе информацию о кодах ошибок db++.

dbplus_freealllocks

(только 4.1.0 - 4.2.1)

dbplus_freealllocks - освобождает все блокировки/locks, удерживаемые данным клиентом.

Описание

int dbplus_freealllocks (void)

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

dbplus_freeaalllocks() освободит все блокировки пар/tuple, удерживаемые данным клиентом.

См. также dbplus_getlock(), dbplus_freelock() и dbplus_freerlocks().

dbplus_freelock

(только 4.1.0 - 4.2.1)

dbplus_freelock - освобождает блокировку записи на паре/tuple.

Описание

int dbplus_freelock (resource relation, string tname)

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

dbplus_freelock() освобождает блокировку записи на данной tuple, полученной до этого функцией dbplus_getlock().

См. также dbplus_getlock(), dbplus_freerlocks() и dbplus_freealllocks().

dbplus_freerlocks

(только 4.1.0 - 4.2.1)

dbplus_freerlocks - освобождает все блокировки пар/tuple в данной связи/relation.

Описание

int dbplus_freerlocks (resource relation)

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

dbplus_freerlocks() освобождает все блокировки пар, содержащиеся в данной relation.

См. также dbplus_getlock(), dbplus_freelock() и dbplus_freealllocks().