White cat - Справочник по PHP Страница 31

Возвращает true в случае успеха и false иначе.

imap_undelete

Снимает отметку с сообщения помеченного на удаление.

Синтаксис:

int imap_undelete(int imap_stream, int msg_number);

Эта функция cнимает отметку с сообщения помеченного на удаление функцией imap_delete().

Возвращает true в случае успеха и false иначе.

imap_unsubscribe

Снимает подписку с почтового ящика.

Синтаксис:

int imap_unsubscribe(int imap_stream, string mbox);

Возвращает true в случае успеха и false иначе.

imap_qprint

Конвертирует строку формата quoted-printable в 8-битовую строку.

Синтаксис:

string imap_qprint(string string);

Возвращает 8-битовую (бинарную) строку.

imap_8bit

Конвертирует 8-битовую строку в формат quoted-printable.

Синтаксис:

string imap_8bit(string string);

Возвращает строку в формате quoted-printable.

imap_binary

Конвертирует 8-битную строку в формат base64.

Синтаксис:

string imap_binary(string string);

Возвращает строку в формате base64.

imap_scanmailbox

Читает список почтовых ящиков, проводит поиск в названиях ящиков.

Синтаксис:

array imap_scanmailbox(int imap_stream, string string);

Возвращает массив, содержащий имена почтовых ящиков, которые имеют строку string в названии.

imap_mailboxmsginfo

Получает информацию о текущем почтовом ящике.

Синтаксис:

array imap_mailboxmsginfo(int imap_stream);

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

Функция imap_mailboxmsginfo() проверяет статус текущего почтового ящика на сервере и возвращает информацию в объекте со следующими свойствами:

imap_rfc822_write_address

Возвращает правильно отформатированный email адрес.

Синтаксис:

string imap_rfc822_write_address(string mailbox, string host, string personal);

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

imap_rfc822_parse_adrlist

Проводит разбор адресной строки.

Синтаксис:

string imap_rfc822_parse_adrlist(string address, string default_host);

Эта функция разбирает адресную строку и для каждого адреса возвращает массив объектов.

Есть 4 типа объектов:

imap_setflag_full

Устанавливает флаги на сообщения.

Синтаксис:

string imap_setflag_full(int stream, string sequence, string flag, string options);

Эта функция застваляет добавить указанный флаг к набору флагов сообщения в указанной последовательности.

options - это битовая маска из ST_UID

Аргументы последовательности содержат UIDы вместо номеров

imap_clearflag_full

Очищает флаги сообщения.

Синтаксис:

string imap_clearflag_full(int stream, string sequence, string flag, string options);

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

options - это битовая маска из ST_UID

Аргументы последовательности содержат UIDы вместо номеров

imap_sort

Сортирует сообщения в текущем почтовом ящике.

Синтаксис:

string imap_sort(int stream, int criteria, int reverse, int options);

Возвращает массив номеров сообщений рассортированных по данному параметру

reverse должен быть равен 1 если нужна сортировка в обратном порядке

Критерии сортировки (должен быть указан только один):

опции - битовая маска из

imap_fetchheader

Возвращает заголовок сообщения.

Синтаксис:

string imap_fetchheader(int imap_stream, int msgno, int flags);

Эта функция заставляет извлечь полный, не отфильтрованный заголовок указанного сообщения в формате RFC 822 как текстовую строку.

Опиции:

imap_uid

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

Синтаксис:

string imap_uid(string mailbox, int msgno);

Функции SNMP

snmpget

Получает объект SNMP.

Синтаксис:

int snmpget(string hostname, string community, string object_id);

Возвращает значение SNMP объекта при успехе и false при ошибке.

Функция snmpget() используется для чтения значения SNMP объекта, указанного в object_id.

SNMP агент определяется именем хоста hostname и группа чтения определяется параметром community.

snmpget("127.0.0.1", "public", "system.SysContact.0")

snmpwalk

Получает все SNMP объекты у агента.

Синтаксис:

array snmpwalk(string hostname, string community, string object_id);

Возвращает массив значений SNMP объектов начиная с object_id и false при ошибке.

Функция snmpwalk() используется для чтения всех значений у SNMP агента, определяемого параметром hostname.

Community определяет группу чтения для агента.

Нулевой object_id берется как корень дерева SNMP объектов и все объекты под этим деревом возвращаются как массив.

Если object_id указан, то возвращаются все SNMP объекты ниже этого объекта.

$a = snmpwalk("127.0.0.1", "public", "");

Указанный выше вызов функции вернет все SNMP объекты из SNMP агента, напущенного на локальном хосте.По всем значениям можно пройти с помощью цикла :

for($i=0; $i<count($a); $i++) {

echo $a[$i];

}

Функции Vmailmgr

Эти функции требуют пакетов QMAIL www.qmail.org и vmailmgr Bruce Guenter

Для всех функций следующие две переменные определяются как: строка vdomain - имя домена вашего виртуального домена (vdomain.com) , строка basepwd - пароль для "real" пользователя, который поддерживает виртуальных пользователей.

Только до 8 символов распознаются в пароле для виртуальных пользователей.

Возвращается статус для всех функциональных значений ответа в response.h

<?php

dl("php3_vmailmgr.so"); //load the shared library

$vdomain="vdomain.com";

$basepwd="password";

?>

vm_adduser

Добавляет нового виртуального пользователя с паролем.

Синтаксис:

int vm_adduser(string vdomain, string basepwd, string newusername, string newuserpassword);

Добавляет нового виртуального пользователя с паролем. newusername - это имя почтового login-а и newuserpassword - это пароль для это пользователя.

vm_addalias

Добавляет новый псевдоним для виртуального пользователя.

Синтаксис:

int vm_addalias(string vdomain, string basepwd, string username, string alias);

Добавляет псевдоним виртуальному пользователю. username - это имя почтового login-а и alias - это псевдоним для этого пользователя.

vm_passwd

Изменяет пароль виртуальных пользователей.

Синтаксис:

int vm_passwd(string vdomain, string username, string password, string newpassword);

Изменяет пароль виртуальных пользователей. username - это имя почтового login-а, password - старый пароль пользователя, и newpassword - новый пароль.

vm_delalias

Удаляет псевдоним.

Синтаксис:

int vm_delalias(string vdomain, string basepwd, string alias);

vm_deluser

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

Синтаксис:

int vm_deluser (string vdomain, string username);

Сетевые функции

ip2long

Производит конвертацию строки адреса IPv4 в число.

Синтаксис:

int ip2long(string ip_address);

Функция ip2long() возвращает четырех байтовое численное представление адреса IP v4 из строки (числа, разделенные точками, например: "127.0.0.1").

// получить IP адрес хоста

$ip=gethostbyname("www.php.net");

echo "Следующие URL эквивалентны:<br>";

echo "http://www.php.net/, http://".$ip.

"/, и http://".ip2long($ip)."/<br>";

long2ip

Производит конвертацию числа в строку адреса IP v4.

Синтаксис:

string long2ip(int proper_address);

Функция long2ip() возвращает строковое представление IP-адреса (в формате: "aaa.bbb.ccc.ddd") из численного представления.

gethostbyaddr

Возвращает имя хоста, который соответствует заданному IP-адресу.

Синтаксис:

string gethostbyaddr(string ip_address);

Функция gethostbyaddr() возвращает доменное имя хоста, заданного своим IP-адресом. В аргументе указывается адрес IP в строковом формате. В случае ошибки возвращает ip_address.

Надо отметить, что функция не гарантирует, что полученное имя на самом деле будет соответствовать действительности. Она лишь опрашивает хост по адресу ip_address и просит его сообщить свое имя. Владелец хоста, таким образом, может передавать все, что ему заблагорассудится.

echo gethostbyaddr("127.0.0.1");

gethostbyname

Возвращает IP-адрес хоста.

Синтаксис:

string gethostbyname(string hostname);

Функция gethostbyname() получает в параметрах доменное имя хоста и возвращает его IP-адрес. Если адрес определить не удалось, функция возвращает hostname.

gethostbynamel