Руководство по РНР 3.0

7fbce50e

ibase_timefmt



Описание

ibase_timefmt( );  

Описание

int ldap_add(целочисленный link_identifier, строковое dn, массив записи); возвращает true при успехе и false при ошибке. Функция ldap_add() используется для добавления записей в LDAP каталог. DN добавляемой записи выражается посредством dn. Массив записи определяет информацию о записи. Значения записей индексируются посредством индивидуальных атрибутов. В случае множественных значений для атрибута, они индексируются целыми числами начиная с 0.     запись["атрибут1"] = значение
    запись["атрибут2"][0] = значение1
    запись["атрибут2"][1] = значение2





Описание

int ldap_bind(целое link_identifier, строковое bind_rdn, строковое bind_password); Связь с LDAP каталогом с определенным RDN и паролем. Возвращает true при успехе и false при ошибке. ldap_bind() осуществляет операцию связи с каталогом. bind_rdn и bind_password используются факультативно. Если не определено, применяется связь anonymous.



Описание

int ldap_close(целое link_identifier); Возвращает true при успехе, false при ошибке. ldap_close() закрывает связь с LDAP сервером, которая ассоциировалась с определенным link_identifier. Этот вызов внутренне идентичен ldap_unbind(). LDAP API использует вызов ldap_unbind(), поэтому возможно он предпочтительнее вызова ldap_close().



Описание

int ldap_connect(строковое hostname, целое port); Возвращает положительный LDAP идентификатор связи при успехе, false при ошибке. ldap_connect() устанавливает соединение с LDAP сервером по определенным hostname и port. Оба аргумента факультативные. Если аргументы не определены, то будет возвращен идентефикатор уже открытого соединения. Если определено только hostname, то по умолчанию используется порт 389.



Описание

int ldap_count_entries(целое link_identifier, целое result_identifier); Возвращает количество записей в результате или false при ошибке. ldap_count_entries() возвращает количество записей хранимых в результате от предыдущей операции поиска. result_identifier идентифицирует внутренний ldap результат.



Описание

int ldap_delete(целое link_identifier, строковое dn); Возвращает true при успехе и false при ошибке. ldap_delete() удаляет отдельную запись из LDAP каталога, определенную по dn.



Описание

string ldap_dn2ufn(строковое dn); ldap_dn2ufn() преобразует DN в более дружественную для пользователя форму, удаляя имена типа.



Описание

array ldap_explode_dn(строковое dn, целое with_attrib); ldap_explode_dn() разбивает DN возвращаемое по ldap_get_dn() на составные части. Каждая часть известна как Relative Distinguished Name, или RDN. ldap_explode_dn() возвращает массив всех компонентов. with_attrib используется для запроса, возвращать ли RDN толъко со значениями или также с их атрибутами. Чтобы получить RDN-части с атрибутами (т.е. в формате атрибут=значение) установите with_attrib в 1, чтобы получить только значения установите его в 0.



Описание

string ldap_first_attribute(целое link_identifier, целое result_entry_identifier, целое ber_identifier); Возвращает первый атрибут в записи при успехе и false при ошибке. Подобно чтению записей, атрибуты также читаются один за другим из отдельной записи. ldap_first_attribute() возвращает первый атрибут в записи, отмеченной идентификатором записи. Оставшиеся атрибуты ищутся последовательными вызовами ldap_next_attribute(). ber_identifier является идентификатором указателя положения внутренней памяти. Он передается по ссылке. Аналогичный ber_identifier передается ldap_next_attribute() функции, которая изменяет этот указатель. См. также ldap_get_attributes()



Описание

int ldap_first_entry(целое link_identifier, целое result_identifier); Возвращает идентификатор записи для первой записи результата при успехе и false при ошибке. Записи в LDAP-результате считываются последовательно с использованием функций ldap_first_entry() и ldap_next_entry(). ldap_first_entry() возвращает идентификатор записи для первой записи в результате. Этот идентификатор записи передается затем в процедуру lap_next_entry() для получения последовательных записей из результата. См. также ldap_get_entries().



Описание

int ldap_free_result(целое result_identifier); Возвращает true при успехе и false при ошибке. ldap_free_result() освобождает внутреннюю память, предназначенную для хранения результата и отмечаемую посредством result_identifier. Вся память результата автоматически освобождается когда скрипт завершается. Обычно вся память, выделяемая для ldap результата освобождается при окончании скрипта. В случае, когда скрипт выполняет последовательные поиски, которые возвращают большие наборы записей в результате, ldap_free_result() может быть вызвана для сохранения работоспособности оперативной памяти для следующей части скрипта..



Описание

array ldap_get_attributes(целое link_identifier, целое result_entry_identifier); Возвращает полную информацию о записи в многоразмерном массиве при успехе и false при ошибке. ldap_get_attributes() используется для упрощения чтения атрибутов и значений из записи в результате от поиска. Возвращаемым значением функции является многоразмерный массив атрибутов и значений. Разместив определенную запись в каталоге, вы можете узнать какая информация хранится для этой записи, используя данный вызов. Вы могли бы использовать этот вызов в приложении которое "просматривает" каталог записей и/или когда вам не известна структура каталога записей. Во многих приложениях вы можете искать определенные атрибуты, такие как email-адрес или фамилия, не озадачиваясь при этом содержимым других данных. return_value["count"]= количество атрибутов в записи
return_value[0] = первый атрибут
return_value[n] = n-ый атрибут

return_value["attribute"]["count"] = количество значений атрибута
return_value["attribute"][0] = первое значение атрибута
return_value["attribute"][i] = i-тое значение атрибута



Описание

string ldap_get_dn(целое link_identifier, целое result_entry_identifier); Возвращает DN записи результата или false при ошибке. ldap_get_dn() используется для нахождения DN записи в результате.



Описание

array ldap_get_entries(целое link_identifier, целое result_identifier); Возвращает полную информацию о результате в многомерном массиве при успехе и false при ошибке. ldap_get_entries() используется для упрощения чтения множества записей из результата и затем чтения атрибутов и множественных значений. Информация о записи возвращается по одиночному вызову функции в многомерном массиве. Структура массива представлена ниже. Индекс атрибута преобразуется к нижнему регистру. (Атрибуты серверов каталогов нечувствительны к регистру, но не в том случае когда они используются в качестве индексов массива). return_value["count"]= количество записей в результате
return_value[0] : ссылается на детали первой записи

return_value[i]["dn"] =  DN i-той записи в результате

return_value[i]["count"] = количество атрибутов i-той записи
return_value[i][j] = j-тый атрибут i-той записи результата

return_value[i]["attribute"]["count"] = количество значений атрибута в i-той записи
return_value[i]["attribute"][j] = j-тое значение атрибута в i-той записи См. также ldap_first_entry() и ldap_next_entry()



Описание

array ldap_get_values(целое link_identifier, целое result_entry_identifier, строковое attribute); Возвращает массив значений атрибута при успехе и false при ошибке. ldap_get_values() используется для чтения всех значений атрибута в записи в данном результате. Запись определяется по result_entry_identifier. Количество значений может быть получено при индексации "счетчика" в результирующем массиве. Отдельные значения доступны по целочисленному индексу в массиве. Первый индекс начинается с 0. Для данного вызова необходим result_entry_identifier, поэтому нужно предварительно сделать один вызов ldap поиска, и один из вызовов для получения отдельной записи. Ваше приложение или может быть жестко настроено на поиск определенных атрибутов (таких как "фамилия" или "почта") или вы должны использовать вызов ldap_get_attributes() для получения информации о том, какие атрибуты существуют для данной записи. В LDAP может быть более одной записи для атрибута, поэтому можно, например, хранить несколько адресов email в записи каталога для одной персоны, при этом все записи будут отмечены с атрибутом "mail" return_value["count"]= количество значений для атрибута
return_value[0] = первое значение атрибута
return_value[i] = i-тое значение атрибута



Описание

int ldap_list(целое link_identifier, строковое base_dn, строковое filter); Возвращает идентификатор результата поиска или false при ошибке. ldap_list() выполняет поиск с определенным фильтром по каталогу с областью LDAP_SCOPE_ONELEVEL. LDAP_SCOPE_ONELEVEL означает что такой поиск может вернуть только информацию, находящуюся на уровне непосредственно ниже базового dn, заданного в вызове. (Эквивалентно вводу "ls" и получению списка файлов и папок в текущем рабочем каталоге).Этот вызов берет факультативно четвертый параметр который является массивом требуемых атрибутов. См. примечание к ldap_search().



Описание

int ldap_modify(целое link_identifier, строковое dn, массив entry); Возвращает true при успехе и false при ошибке. ldap_modify() используется для изменения существующих записей в каталоге LDAP. Структура записи такая же как и в ldap_add().



Описание

string ldap_next_attribute(целое link_identifier, целое result_entry_identifier, целое ber_identifier); Возвращает следующий атрибут в записи или false при ошибке. ldap_next_attribute() вызывается для поиска атрибутов в записи. Внутреннее положение указателя устанавливается по ber_identifier. Он посылается в данную функцию по ссылке. Первый вызов ldap_next_attribute() осуществляется с result_entry_identifier получаемым от ldap_first_attribute(). См. также ldap_get_attributes()



Описание

int ldap_next_entry(целое link_identifier, целое result_entry_identifier); Возвращает идентефикатор записи для следующей записи в результате, записи которого начинали считываться функцией ldap_first_entry(). Если больше нет записей в результате, то возвращается false. ldap_next_entry() используется для поиска записей, хранящихся в результате. Последовательные вызовы ldap_next_entry() возвращают записи одну за другой пока не закончатся все записи. Первое обращение к ldap_next_entry() осуществляется после вызова ldap_first_entry() с параметром result_identifier, который возвращается от ldap_first_entry(). См. также ldap_get_entries()



Описание

int ldap_read(целое link_identifier, строка base_dn, строка filter, массив [attributes]); Возвращает идентификатор результата поиска или false при ошибке. ldap_read() выполняет поиск при определенном фильтре по каталогу с областью LDAP_SCOPE_BASE. Таким образом, это эквивалентно чтению записи из каталога. Пустой фильтр не допустим. Если вы хотите получить абсолютно всю информацию для данной записи, используйте фильтр "objectClass=*". Если вы знаете какие типы записей используются в сервере каталога, вы можете применить подходящий фильтр, такой как "objectClass=inetOrgPerson". Этот вызов берет факультативно четвертый параметр который является массивом требуемых атрибутов. См. примечание ldap_search().



Описание

int ldap_search(целое link_identifier, строковое base_dn, строковое filter, массив [attributes]); Возвращает идентификатор результата поиска или false при ошибке. ldap_search() осуществляет поиск для определенного фильтра по каталогу с областью LDAP_SCOPE_SUBTREE. Это эквивалентно поиску по всему каталогу. base_dn определяет базовый DN для данного каталога. Имеется факультативный четвертый параметр, который может быть добавлен для ограничения атрибутов и значений возвращаемых сервером, если это требуется. Это значительно эффективнее чем действие по умолчанию (которое возвращает все атрибуты и их соответствующие значения). Использование четвертого параметра может поэтому рассматриваться как хорошая практика. Четвертый параметр является стандартным строковым массивом PHP с требуемыми атрибутами, т.е. array("mail","sn","cn"). Заметим, что "dn" требуется всегда, независимо от того, какие типы атрибутов запрашиваются. Отметим также, что некоторые хосты каталога сервера могут быть сконфигурированы так, что будут возвращать количество записей не превышающее предварительно установленное количество. Если это происходит, сервер будет показывать что он будет возвращать только ограниченные наборы результатов. Поисковый фильтр может быть простым или расширенным, использующим булевы операторы в формате описанном в документации LDAP (См. Netscape Directory SDK для дополнения информации по фильтрам). Приведенный ниже пример отыскивает the отдел организации, фамилию, данное имя и адрес email для всех людей в "My Company" где фамилия или данное имя содержат подстроку $person. Этот пример использует логический фильтр для указания серверу на поиск информации более чем в одном атрибуте.



Описание

int ldap_unbind(целое link_identifier); Возвращает true при успехе и false при ошибке. ldap_unbind() прекращает связь из каталога LDAP.  



Описание

bool mail( string to, string subject, string message, string additional_headers); Функция mail() позволяет отсылать почту.
Mail() автоматически посылает сообщение, содержащееся в message адресату, указанному в to.
Несколько получателей могут быть указаны в поле to в виде строки с адресами, разделенными пробелами.



Описание

mixed abs(mixed number); Возвращает абсолютную величину числа. Если число с плавающей запятой, то также возвращает число с плавающей запятой.



Описание

float acos(float arg); Возвращает арккосинус аргумента в радианах. См.также asin() и atan().



Описание

float asin(float arg); Возвращает арксинус аргумента в радианах. См.также acos() и atan().



Описание

float atan(float arg); Возвращает арктангенс аргумента в радианах. См.также acos() и atan().



Описание

float atan2(float y, float x); Эта функция вычисляет арктангенс от двух переменных x и y. Аналогично вычислению арктангенса y / x, за исключением того, что знаки обоих аргументов используются для определения сектора результата. Функция возвращает результат в радианах, находящихся между -PI и PI (включительно). См.также acos() и atan().



Описание

strin base_convert( string number, int frombase, int tobase); Возвращает строку, содержащую number, представленное по основанию tobase. Основание, в котором дается число which number указывается в frombase. Основания frombase и tobase должны находиться в диапазоне от 2 до 36 включительно. Цифры в числах с основанием выше, чем 10 будут представлены буквами a-z, со значениями a - 10, b - 11 и z - 36.



Описание

int bindec(string binary_string); Возвращает десятичный эквивалент двоичного числа, представленного аргументом binary_string. OctDec конвертирует двоичное число в десятичное. Наибольшее число, которое может быть сконвертировано равно 31 битам или 2147483647 в десятичном виде. См.также функцию decbin().



Описание

int ceil(float number); Возвращает следующее наивысшее целое значение number. Использование ceil() на целых числах - абсолютная трата времени. ЗАМЕЧАНИЕ: Функция ceil() в PHP/FI 2 возвращаля число типа float. Используйте: $new = (double)ceil($number); для того, чтобы сэмулировать старое поведение функции. См.также floor() и round().



Описание

float cos(float arg); Возвращает косинус аргумента в радианах. См.также sin() и tan().



Описание

string decbin(int number); Возвращает строку, содержащую двоичное представление аргумента number. Наибольшее число, которое может быть сконвертировано равно 2147483647 в десятичном виде или 31 бит. См.также функцию bindec().



Описание

string dechex(int number); Возвращает строку, содержащую шестнадцатиричное представление аргумента number. Наибольшее число, которое может быть сконвертировано равно 2147483647 в десятичном виде или "7fffffff" в шестнадцатиричном. См. также функцию hexdec().



Описание

string decoct(int number); Возвращает строку, содержащую восьмеричное представление аргумента number. Наибольшее число, которое может быть сконвертировано равно 2147483647 в десятичном виде или "17777777777" в восьмеричном. См.также octdec().



Описание

float exp(float arg); Возвращает число e, возведенное в степень arg. См.также pow().



Описание

int floor(float number); Возвращает следующее нижележащее значение после number. Использование floor() на целых числах - абсолютная потеря времени. ЗАМЕЧАНИЕ: Функция floor() в PHP/FI 2 возвращала число типа float. Используйте: $new = (double)floor($number); для эмулирования старого поведения этой функции. См.также ceil() и round().



Описание

int getrandmax(void ); Возвращает максимальную величигу, которая может быть возвращена вызовом функцииrand(). См.также rand(),srand()mt_rand(),mt_srand() иmt_getrandmax().



Описание

int hexdec(string hex_string); Возвращает десятичный эквивалент числа, представленного аргументом hex_string. HexDec конвертирует шестнадцатиричную сстроку в десятичное число. Наибольшее число, которое может быть сконверьтировано равно 7fffffff в шестнадцатиричном виде или 2147483647 в десятичном. См. также функцию dechex().



Описание

float log(float arg); Возвращает натуральный логарифм от аргумента arg.



Описание

float log10(float arg); Возвращает логарифм по основанию 10 от аргумента arg.



Описание

mixed max( mixed arg1, mixed arg2, mixed argn); max() возвращает наибольшее число из перечисленных в параметрах. Если первый элемент является массивом, max() возвращает максимальную величину массива. Если первый парметр - целое, строка или типа double, следует использовать как минимум два параметра, и в этом случае max() возвращает наибольшее из этих величин. Вы можете сравнивать неограниченное количнество значений. Если одна или более величин типа double, все остальные величины будут обращены double, и, соответственно, возвратится число типа double. Если ни одно из чисел не является double, то все будут обращены в целые и возвратится целое число.



Описание

mixed min( mixed arg1, mixed arg2, mixed argn); min() возвращает наименьшее значение из указанных в аргументах. Если первый параметр - массив, min() возвратит наименьшую величину массива. Если первый параметр - целое число, строка или double, следует указать минимум два парметра и min() возвратит наименьшую из них величину. Вы можете сравнивать неограниченно количество величин. Если одна или более величин типа double, все остальные величины будут обращены double, и, соответственно, возвратится число типа double. Если ни одно из чисел не является double, то все будут обращены в целые и возвратится целое число.



Описание

int mt_rand([int min], [int max]); Множество генераторов случайных чисел, написанных на старой библиотеке libcs, имеют неясные или неизвестные характеристики, и к тому же, медленны. По умолчанию с функциейrand() PHP использует генератор случайных чисел, написанный на libc. Функция mt_rand() является его полной заменой. Она использует генератор случайных чисел с известными характеристиками (Mersenne Twister), который производит случайные числа, пригодные для использования в криптографии и работает в четыре раза быстрее, чем средняя скорость, которую обеспечивает libc. Домашняя страница Mersenne Twister'а Вы можете найти по адресуhttp://www.math.keio.ac.jp/~matumoto/emt.htm, а оптимизированную версию исходных текстов наhttp://www.scp.syr.edu/~marc/hawk/twister.htm. Если функция вызывается без необязательных аргументов min и max, mt_rand() возвращает псевдо-случайное число между 0 и RAND_MAX. Если Вы хотите получить случайное число между 5 и 15 (включительно), то можно использовать следующий вызов функции: mt_rand(5,15). Не забудьте инициализировать генератор случайных чисел перед использованием функцииmt_srand(). См.также mt_srand(),mt_getrandmax(),srand(),rand() иgetrandmax().



Описание

void mt_srand(int seed); Инициализирует генератор случайных чисел значением seed. // инициализируется количеством микросекунд с посленей "целой" секунды mt_srand((double)microtime()*1000000); $randval = mt_rand(); См.также mt_rand(),mt_getrandmax(),srand(),rand() иgetrandmax().



Описание

int mt_getrandmax(void ); Возвращает максимальную величину, которая может быть возвращена вызовом функцииmt_rand(). См.также mt_rand(),mt_srand()rand(),srand() иgetrandmax().



Описание

string number_format( float number, int decimals, string dec_point, string thousands_sep); number_format() возвращает форматированную версию числа number. Эта функция принимает один, два или четыре параметра (не три): Если дан только один параметр, число number будет отформатировано без десятичных цифр, но с запятой (",") между каждой группой тысяч. Если дано два параметра, число number will будет отформатировано с десятичным знаком decimals с точкой (".") впереди и запятой (",") между каждой группой тысяч. Если даны все четыре параметра, то число number будет отформатировано с десятичным знаком decimals, dec_point вместо точки (".") перед десятичным знаком и thousands_sep вместо запятой (",") между каждой группой тысяч.



Описание

int octdec(string octal_string); Возвращает десятичный эквивалент восьмеричного числа, представленного аргументом octal_string. OctDec конвертирует восьмеричное число в десятичное. Максимальное число, которое может быть сконвертировано равно 17777777777 или 2147483647 в десятичном виде. См.также decoct().



Описание

double pi(void ); Вохвращает аппроксимированное значение pi.



Описание

float pow( float base, float exp); Возвращает base, возведенное в степень exp. См.также exp().



Описание

int rand([int min], [int max]); Если функция вызывается без необязательных параметров min и max, rand() возвращает псевдо-случайную величину между 0 и RAND_MAX. При желании получить случайное число между 5 и 15 (включительно), используйте rand(5,15). Не забудьте проинициализировать генератор случайных чисел перед использованиемsrand(). См.также srand(),getrandmax(),mt_rand(),mt_srand() иmt_getrandmax().



Описание

double round(double val); Возвращает округленную величину val. $foo = round( 3.4 ); // $foo == 3.0 $foo = round( 3.5 ); // $foo == 4.0 $foo = round( 3.6 ); // $foo == 4.0 См.также ceil() and floor().



Описание

float sin(float arg); Возврашает синус аргумента. См.также cos() и tan().



Описание

float sqrt(float arg); Возвращает квадратный корень аргумента.



Описание

void srand(int seed); Инициализирует генератор случайных чисел значением seed. // инициализируется числом микросекунд с последней "целой" секунды srand((double)microtime()*1000000); $randval = rand(); См.также rand(),getrandmax(),mt_rand(),mt_srand() иmt_getrandmax().



Описание

float tan(float arg); Возвращает тангенс аргумента. См.также sin() и cos().  



Описание

void eval(string code_str);
eval() производит выполнение строки, данной в code_str содержащей PHP код. Кстати, это может пригодиться для сохранения кода в текстовом поле базы данных для более позднего выполнения. Имеются некоторые условия, которые надо иметь в виду при использовании eval(). Не забудьте, что переданная строка должна иметь допустимый PHP код, при включении чего-нибудь подобного завершению кода с точкой с запятой дальнейшее выполнение  не прервется  на строке после eval(), поэтому пропускайте это в code_str. Также не забудьте, что при изменении переменных значений в eval() эти переменные будут изменены и в основных данных.
 



Описание

void die(string message);
Эта функция выводит сообщение и прекращает выполнение текущего скрипта. Не возвращает значение.
 



Описание

void exit(void);
Эта функция завершает текущий скрипт.  Не возвращает значение.



Описание

array iptcparse(string iptcblock);
Эта функция анализирует двоичный блок IPTC на одиночные теги.  Возвращает массив, использующий tagmarker как индекс и значение как значение. Возвращает false при ошибке или если никаких IPTC данных не было найдено. См. GetImageSize() для примера.



Описание

void leak(int bytes);
Leak() отсекает определенный объем памяти. Это полезно при отладке диспетчера памяти, который автоматически очищает "отсеченную" память при выполнении запроса.



Описание

string pack(string format, mixed [ args ]...);
Упаковывает данные в двоичную строку согласно формату. Возвращает двоичную строку, содержащую данные. Идея на эту функцию принималась из Perl и всей работы кодов форматирования также как там. Строка формата состоит из кодов формата, сопровождаемые факультативным параметром ретранслятора. Параметр ретранслятора может быть или целочисленное значение или * для повторение до конца входных данных. Для a, A, h, H количество повторов определяет, сколько принимается символов одного параметра данных, для @ это безусловная позиция, где поместить следующие данные, для всего остального количество повторов определяет сколько данных будет использовано и упаковано в возникающую в результате двоичную строку. В настоящее время выполнено:
 
    a строка NUL-заполнений A строка SPACE-заполнений h Hex строка, младший полубайт вначале H Hex строка, старший полубайт вначале c signed char C unsigned char s signed short (всегда 16 бит, machine byte order) S unsigned short (всегда 16 бит, machine byte order) n unsigned short (всегда 16 бит, big endian byte order) v unsigned short (всегда 16 бит, little endian byte order) i signed integer (machine dependant размер и byte order) I unsigned integer (machine dependant размер и byte order) l signed long (всегда 32 бит, machine byte order) L unsigned long (всегда 32 бит, machine byte order) N unsigned long (всегда 32 бит, big endian byte order) V unsigned long (всегда 32 бит, little endian byte order) f float (machine dependent размер и representation) d double (machine dependent размер и representation) x NUL байт X Копирует один байт @ NUL-Заполнение до конкретной позиции




Описание

int register_shutdown_function(string func);
Устанавливает функцию с именем func, которая будет выполнена при завершении.



Описание

string serialize(mixed value);
serialize() возвращает строку состоящую из потока байтов при представлениизначения value, которое может где-нибудь сохранено. Это полезно для сохранения или передачи значений PHP  без потери их типа и структуры.. Чтобы преобразовать строку обратно в PHP значение, используйте unserialize(). serialize() обрабатывает следующие типы:  integer ,  double ,  string ,  array(многомерный) и  object (объект будет преобразован в последовательную форму, но методы при этом будут утеряны).
 



Описание

void sleep(int seconds);
Sleep фукция выполняет задержку выполненя программы в секундах (seconds). См. также usleep().

Содержание раздела