imagesx
(PHP 3, PHP 4)
imagesx - получает ширину изображения.
Описание
int imagesx (resource image)
imagesx() возвращает ширину изображения image.
См. также imagecreate() и imagesy().
imagesy
(PHP 3, PHP 4)
imagesy - получает высоту изображения.
Описание
int imagesy (resource image)
imagesy() возвращает высоту изображения image.
См. также imagecreate() и imagesx().
imagetruecolortopalette
(PHP 4 >= 4.0.6)
imagetruecolortopalette - конвертирует изображение true color в палитровое изображение.
Описание
void imagetruecolortopalette (resource image, bool dither, int ncolors)
imagetruecolortopalette() конвертирует truecolor-изображение в палитровое/palette изображение. Код для этой функции был первоначально взят из превосходного кода библиотеки Independent JPEG Group. Этот код был модифицирован, чтобы сохранить максимальное количество информации alpha-канала в результирующей палитре, сохраняя также, по возможности, цвета. Это не работает так, как хотелось бы. Обычно лучше просто создать выводное изображение truecolor, что гарантирует высокое качество вывода.
dither - если TRUE, используется dithering, что даёт более пятнистое изображение, но с лучшей цветопередачей.
ncolors устанавливает максимальное количество цветов палитры.
Примечание: эта функция была введена в PHP 4.0.6 и требует GD 2.0.1 или новее.
imagettfbbox
(PHP 3>= 3.0.1, PHP 4)
imagettfbbox - даёт обрамляющий текста с использованием шрифтов TrueType.
Описание
array imagettfbbox (int size, int angle, string fontfile, string text)
Эта функция вычисляет и возвращает обрамляющий бокс в пикселах для TrueType-текста.
- text
Измеряемая строка.
- size
Размер шрифта в пикселах.
- fontfile
-
Имя файла шрифта TrueType. (Это также может быть URL.) В зависимости от версии библиотеки, используемой PHP, может попытаться искать файлы, которые не начинаются с ведущего символа '/', присоединяя '.ttf' к имени файла, по всему пути шрифтов, определённому для библиотеки.
- angle
Угол в градусах, в которых будет измеряться text.
imagettfbbox() возвращает массив из 8 элементов, представляющих 4 точки, образующие бокс текста:
точки относительны к тексту, независимо от угла, поэтому "верхний левый" означает самый верхний левый угол, если смотреть на текст горизонтально.
Эта функция требует библиотек GD и FreeType.
См. также imagettftext().
imagettftext
(PHP 3, PHP 4)
imagettftext - записывает текст на изображение с использованием шрифтов TrueType.
Описание
array imagettftext (resource image, int size, int angle, int x, int y, int col, string fontfile, string text)
imagettftext() рисует строку text на изображении image, начиная с координат x, y (верхний левый угол обозначается 0, 0), на угол angle цветом col, с использованием файла шрифта TrueType fontfile. В зависимости от используемой в РНР версии библиотеки GD, если fontfile не начинается с ведущего '/', '.ttf' будет присоединено к имени файла, а библиотека будет пытаться искать файл с таким именем по всему пути шрифтов, определённому для библиотеки.
Координаты x, y будут определять базовую точку/basepoint первого символа (ориентировочно - левый верхний угол первого символа). Это отличается от imagestring(), где x, y определяют верхний правый угол первого символа.
Angle дан в градусах, где 0 градусов это чтение текста слева направо (направление 3 часа), а более высокие значения представляют ротацию против часовой стрелки (т.е. значение 90 должно дать чтение текста снизу вверх).
Fontfile это путь к используемому вами TrueType-шрифту.
Text это текстовая строка, которая может включать символьные последовательности UTF-8 (в форме {) для доступа к символам за пределами первых 255.
Col это индекс цвета. Использование отрицательных значений даёт эффект отключения antialiasing.
imagettftext() возвращает массив из 8 элементов, представляющих 4 точки, образующих бокс текста. Порядок точек таков: нижняя левая, нижняя правая, верхняя правая, верхняя левая. Эти точки относительно текста, вне зависимости от угла, так что "верхний левый" означает верхний левый угол, когда вы смотрите на текст горизонтально.
Вот пример скрипта, производящего чёрный GIF 400x30 пикселов со словами "Testing..." белым шрифтом Arial.
imagetypes
(только PHP 3 CVS, PHP 4 >= 4.0.2)
imagetypes - возвращает типы изображений, поддерживаемые даннымм построением РНР.
Описание
int imagetypes (void)
Эта функция возвращает битовое поле, соответствующее форматам изображений, поддерживаемым версией GD, подключённой к PHP. Возвращаются следующие биты: IMG_GIF | IMG_JPG | IMG_PNG | IMG_WBMP. Для проверки поддержки, например, сделайте так:
imagewbmp
(PHP 3>= 3.0.15, PHP 4 >= 4.0.1)
imagewbmp - выводит изображение в браузер или файл.
Описание
int imagewbmp (resource image [, string filename [, int foreground]])
imagewbmp() создаёт WBMP-файл с именем filename из изображения image. Аргумент image возвращён из imagecreate().
Аргумент filename является необязательным и, если опущен, сырой поток изображения будет выведен напрямую. Отправляя image/vnd.wap.wbmp content-type с использованием header(), вы можете создавать PHP-скрипт, выводящий WBMP-изображения напрямую.
Примечание: поддержка WBMP доступна только в том случае, если PHP была скомпилирована относительно GD-1.8 или новее.
Используя необязательный параметр foreground, вы можете установить цвет переднего плана. Используйте идентификатор, полученный из imagecolorallocate(). По умолчанию цвет переднего плана - чёрный.
См. также image2wbmp(), imagepng(), imagegif(), imagejpeg(), imagetypes().
imap_8bit
(PHP 3, PHP 4)
imap_8bit - конвертирует 8-битную строку в закавыченную печатаемую строку.
Описание
string imap_8bit (string string)
Конвертирует 8-битную строку в закавыченную печатаемую строку (в соответствии с RFC2045, разделом 6.7).
Возвращает закавыченную печатаемую строку.
См. также imap_qprint().
imap_alerts
(PHP 3>= 3.0.12, PHP 4)
imap_alerts - эта функция возвращает все IMAP-предупреждающие сообщения (если они есть), которые возникли в процессе запроса данной страницы или после восстановления стэка предупреждений.
Описание
array imap_alerts (void)
Эта функция возвращает массив всех IMAP-предупреждений, сгенерированных после последнего вызова imap_alerts() или начала страницы. Когда imap_alerts() вызывается, стэк предупреждений следом очищается. Спецификация IMAP требует, чтобы эти сообщения передавались пользователю.
imap_append
(PHP 3, PHP 4)
imap_append - присоединяет строковое сообщение к специфицированному mailbox.
Описание
int imap_append (int imap_stream, string mbox, string message [, string flags])
Возвращает TRUE при успехе, FALSE при ошибке.
imap_append() присоединяет строковое сообщение к специфицированному почтовому ящику mbox. Если необязательный параметр flags специфицирован, также записывает эти flags в этот mailbox.
Если говорить от Cyrus IMAP-сервере, вы обязаны использовать "\r\n" в качестве ограничителя строк вместо "\n", иначе операция потерпит неудачу.
Пример 1. imap_append()
$stream = imap_open("{your.imap.host}INBOX.Drafts","username", "password");
$check = imap_check($stream);
print "Msg Count before append: ". $check->Nmsgs."\n";
imap_append($stream,"{your.imap.host}INBOX.Drafts"
,"From: me@my.host\r\n"
."To: you@your.host\r\n"
."Subject: test\r\n"
."\r\n"
."this is a test message, please ignore\r\n"
);
$check = imap_check($stream);
print "Msg Count after append : ". $check->Nmsgs."\n";
imap_close($stream);imap_base64
(PHP 3, PHP 4)
imap_base64 - декодирует BASE64-кодированный текст.
Описание
string imap_base64 (string text)
imap_base64() декодирует BASE-64-кодированный текст (см. RFC2045, Раздел 6.8). Декодированное сообщение возвращается как строка.
См. также imap_binary().
imap_binary
(PHP 3>= 3.0.2, PHP 4)
imap_binary - конвертирует 8-бинтную строку в строку base64.
Описание
string imap_binary (string string)
Конвертирует 8-бинтную строку в строку base64 (в соответствии с RFC2045, Разделом 6.8).
Возвращает base64-строку.
См. также imap_base64().
imap_body
(PHP 3, PHP 4)
imap_body - читает тело сообщения.
Описание
string imap_body (int imap_stream, int msg_number [, int flags])
imap_body() возвращает тело сообщения, пронумерованное как msg_number в текущем mailbox. Необязательные flags это битовая маска с одним или более из следующих значений:
FT_UID - msgno это UID
FT_PEEK - не устанавливать флаг \Seen, если ещё не установлен (?)
FT_INTERNAL - return-строка во внутреннем формате, не канонизирует в CRLF.
imap_body() возвратит только дословную копию тела сообщения. Для извлечения отдельных частей многочастного MIME-кодированного сообщения вы должны использовать imap_fetchstructure() для анализа его структуры и imap_fetchbody() - для извлечения копии одного компонента тела.
imap_bodystruct
(PHP 3>= 3.0.4, PHP 4)
imap_bodystruct - читает структуру специфицированного раздела тела специфицированного сообщения.
Описание
object imap_bodystruct (int stream_id, int msg_no, int section)
imap_check
(PHP 3, PHP 4)
imap_check - проверяет текущий mailbox.
Описание
object imap_check (int imap_stream)
Возвращает информацию о текущем почтовом ящике/mailbox. Возвращает FALSE при неудаче.
Функция imap_check() проверяет текущий статус mailbox на сервере и возвращает информацию в виде объекта со следующими свойствами:
Date - дата последнего изменения содержимого mailbox
Driver - протокол, используемый для доступа к этому mailbox: POP3, IMAP, NNTP
Mailbox - имя mailbox'а
Nmsgs - количество сообщений в mailbox
Recent - количество последних сообщений в mailbox
imap_clearflag_full
(PHP 3>= 3.0.3, PHP 4)
imap_clearflag_full - очищает флаги сообщений.
Описание
string imap_clearflag_full (int stream, string sequence, string flag, string options)
Эта функция вызывает удаление специфицированного флага в наборе флагов для сообщений в специфицированной последовательности/sequence. Флаги, установку которых можно снять: "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" и "\\Draft" (как определено в RFC2060).
Параметр options это битовая маска с одним или более значений:
ST_UID- последовательность аргументов - содержит UID вместо номеров последовательности.
imap_close
(PHP 3, PHP 4)
imap_close - закрывает IMAP-поток.
Описание
int imap_close (int imap_stream [, int flags])
Закрывает imap-поток. Принимает необязательный флаг flag CL_EXPUNGE, который скрыто вычёркивает mailbox перед закрытием, удаляя все сообщения, помеченные для удаления.
imap_createmailbox
(PHP 3, PHP 4)
imap_createmailbox - создаёт новый mailbox/почтовый ящик.
Описание
int imap_createmailbox (int imap_stream, string mbox)
imap_createmailbox() создаёт новый mailbox mbox. Имена, содержащие интернациональные символы, должны кодироваться с помощью imap_utf7_encode().
Возвращает TRUE при успехе и FALSE при ошибке.
См. также imap_renamemailbox(), imap_deletemailbox() и imap_open() о формате имён mbox.
imap_delete
(PHP 3, PHP 4)
imap_delete - помечает сообщение на удаление из текущего mailbox.
Описание
int imap_delete (int imap_stream, int msg_number [, int flags])
Возвращает TRUE.
imap_delete() помечает на удаление сообщения, перечисленные в msg_number. Необязательный параметр flags имеет только одну опцию, FT_UID, которая говорит функции, что нужно рассматривать аргумент msg_number как UID. Сообщения, помеченные на удаление, будут оставаться в mailbox до тех пор, пока не будет вызвана imap_expunge() или imap_close() с опцией CL_EXPUNGE.
Примечание: POP3 mailbox'ы не сохраняют свои флаги в промежутке между соединениями, поэтому imap_expunge() обязана вызываться в ходе того же соединения, чтобы сообщения, помеченные на удаление, действительно были вычищены.
imap_deletemailbox
(PHP 3, PHP 4)
imap_deletemailbox - удаляет mailbox.
Описание
int imap_deletemailbox (int imap_stream, string mbox)
imap_deletemailbox() удаляет специфицированный mailbox (см. в imap_open() формат имён mbox).
Возвращает TRUE при успехе и FALSE при ошибке.
См. также imap_createmailbox(), imap_renamemailbox() и imap_open() о формате mbox.
imap_errors
(PHP 3>= 3.0.12, PHP 4)
imap_errors - эта функция возвращает все IMAP-ошибки (если имеются), возникшие в ходе запроса данной страницы или после восстановления стэка ошибок.
Описание
array imap_errors (void)
Эта функция возвращает массив из всех сообщений IMAP-ошибок после последнего вызова imap_errors() или после начала страницы. Когда imap_errors() вызывается, следом за этим стэк ошибок вычищается.
imap_expunge
(PHP 3, PHP 4)
imap_expunge - удаляет все сообщения, помеченные для удаления.
Описание
int imap_expunge (int imap_stream)
imap_expunge() удаляет все сообщения, помеченные для удаления функциями imap_delete(), imap_mail_move() или imap_setflag_full().
Возвращает TRUE.
imap_fetch_overview
(PHP 3>= 3.0.4, PHP 4)
imap_fetch_overview - читает обзор информации в header'ах данного сообщения.
Описание
array imap_fetch_overview (int imap_stream, string sequence [, int flags])
Эта функция извлекает mail header'ы данной sequence и возвращает обзор их содержимого.
sequence будет содержать последовательность индексов сообщений или UID'ы, если flags содержит FT_UID. Возвращаемое значение это массив объектов, каждый из которых
описывает один header сообщения:
subject - тема сообщения
from - кто отправил
date - когда было отправлено
message_id - ID сообщения
references - ссылка на id этого сообщения
size - размер в байтах
uid - UID, который сообщение имеет в mailbox
msgno - номер в последовательности сообщений в maibox
recent - это сообщение отмечено как последнее
flagged - это сообщение помечено
answered - это сообщение помечено как answered (на которое дан ответ)
deleted - это сообщение помечено на удаление
seen - это сообщение помечено как уже прочитанное
draft - это сообщение помечено как draft/набросок
Пример 1. imap_fetch_overview()
$mbox = imap_open("{your.imap.host:143}","username","password")
or die("can't connect: ".imap_last_error());
$overview = imap_fetch_overview($mbox,"2,4:6",0);
if(is_array($overview)) {
reset($overview);
while( list($key,$val) = each($overview)) {
print $val->msgno
. " - " . $val->date
. " - " . $val->subject
. "\n";
}
}
imap_close($mbox);imap_fetchbody
(PHP 3, PHP 4)
imap_fetchbody - извлекает определённый раздел тела сообщения.
Описание
string imap_fetchbody (int imap_stream, int msg_number, string part_number [, flags flags])
Эта функция вызывает извлечение определённого раздела тела специфицированного сообщения как текстовой строки и возвращает эту текстовую строку. Раздел специфицируется строкой целых чисел, разделённых тире, которая индексирует в списке частей тела, как в спецификации IMAP4. Части тела этой функцией не кодируются.
Опции для imap_fetchbody() это битовая маска с одним или более значениями:
FT_UID - msg_number это UID
FT_PEEK - не устанавливать флаг \Seen, если не установлен (?)
FT_INTERNAL - return-строка это "внутренний" формат без попытки канонизировать CRLF.
См. также imap_fetchstructure().
imap_fetchheader
(PHP 3>= 3.0.3, PHP 4)
imap_fetchheader - возвращает header сообщения.
Описание
string imap_fetchheader (int imap_stream, int msgno, int flags)
Эта функция извлекает полный неотфильтрованный header формата RFC2822 специфицированного сообщения как текстовую строку и возвращает эту текстовую строку.
Опции таковы:FT_UID - аргумент msgno это UID
FT_INTERNAL - return-строка во "внутреннем" формате без попытки канонизировать в CRLF-символы новой строки
FT_PREFETCHTEXT - RFC822.TEXT должен быть одновременно предварительно извлечён. Это исключит излишние RTT при IMAP-соединенииЮ, если нужен полный текст сообщения (например, при операции "savetolocalfile")
imap_fetchstructure
(PHP 3, PHP 4)
imap_fetchstructure - читает структуру определённого сообщения.
Описание
object imap_fetchstructure (int imap_stream, int msg_number [, int flags])
Эта функция извлекает всю структурную информацию данного сообщения. Необязательный параметр flags имеет только одну опцию, FT_UID, которая говорит функции - рассматривать аргумент msg_number как UID. Возвращаемый объект содержит оболочку, внутренние данные, размер, флаги и структуру тела вместе с похожим объектом для каждого mime-присоединения. Структура возвращаемых объектов такова:
Таблица 1. Возвращаемые объекты imap_fetchstructure()
Таблица 2. Первичный тип тела
Таблица 3. Кодировки трансфера
См. также imap_fetchbody().
imap_get_quota
(PHP 4 >= 4.0.5)
imap_get_quota - запрашивает установки уровня квоты и статистику использования mailbox'а.
Описание
array imap_get_quota (int imap_stream, string quota_root)
Возвращает массив с ограничителем целочисленных значений и использование данного mailbox'а. Значение ограничителя представляет общее количество пространства, отводимое для данного mailbox'а. Значение использования/usage представляет текущий уровень ёмкости mailbox'ов. Возвращает FALSE при неудаче.
Эта функция в настоящее время доступна только пользователям клиентской библиотеки c-client2000.
imap_stream должен быть значением, возвращённым из вызова
imap_status(). Этот поток должен быть открыт для работы как пользователь mail admin.
quota_root нормально должен иметь форму
user.name, где name это mailbox, о котором вы хотите запросить информацию.
imap_getmailboxes
(PHP 3>= 3.0.12, PHP 4)
imap_getmailboxes - читает список mailbox'ов, возвращает детальную информацию о каждом.
Описание
array imap_getmailboxes (int imap_stream, string ref, string pattern)
Возвращает массив объектов, содержащих информацию о mailbox'ах. Каждый объект имеет атрибуты: name, специфицирующий полное имя mailbox'а; delimiter, ограничитель иерархии для той части её, в которой находится данный mailbox; и attributes. Attributes это битовая маска, проверяемая относительно:
LATT_NOINFERIORS - этот mailbox не имеет "потомков/children" (ниже него нет mailbox'ов).
LATT_NOSELECT - это лишь контейнер, а не mailbox - вы не можете открыть его.
LATT_MARKED - этот mailbox помечен. Используется только в UW-IMAPD.
LATT_UNMARKED - этот mailbox не помечен. Используется только в UW-IMAPD.
Имена mailbox'ов, содржащие интернациональные символы за пределами печатаемого диапазона ASCII, будут кодированы и могут быть декодированы с помощью imap_utf7_decode().
ref нормально должен быть просто спецификацией сервера, как описано в imap_open(), а pattern специфицирует, где в иерархии mailbox'ов начинать поиск. Если вам нужны все mailbox'ы, передайте '*' для pattern.
Есть два специальных символа, которые вы можете передавать как часть
pattern: '*' и '%'.
'*' означает: вернуть все mailbox'ы. Если вы передаёте
pattern как '*', вы получите список всей иерархии mailbox'ов.
'%' означает: возвратить только текущий уровень. '%' как параметр pattern возвратит только mailbox'ы верхнего уровня; '~/mail/%' в UW_IMAPD will
возвратит каждый mailbox в директории ~/mail, но не в подкаталогах данного каталога/директории.
imap_getsubscribed
(PHP 3>= 3.0.12, PHP 4)
imap_getsubscribed - список всех подписанных mailbox'ов.
Описание
array imap_getsubscribed (int imap_stream, string ref, string pattern)
Эта функция идентична imap_getmailboxes(), но возвращает mailbox'ы, на которые подписался пользователь.
imap_header
(PHP 3, PHP 4)
imap_header - читает шапку/header сообщения.
Описание
object imap_header (int imap_stream, int msg_number [, int fromlength [, int subjectlength [, string defaulthost]]])
Это псевдоним imap_headerinfo(), идентичный во всём.
imap_headerinfo
(PHP 3, PHP 4)
imap_headerinfo - читает шапку/header сообщения.
Описание
object imap_headerinfo ( int imap_stream, int msg_number [, int fromlength [, int subjectlength [, string defaulthost]]])
Эта функция возвращает объект различных элементов шапки.
remail, date, Date, subject, Subject, in_reply_to, message_id,
newsgroups, followup_to, references
флаги сообщения:
Recent - 'R', если последнее и видимо,
'N', если последнее и невидимо,
' ', если не последнее
Unseen - 'U', если невидимо И не последнее,
' ', если
видимо ИЛИ невидимо и и последнее
Answered - 'A', если на него ответили,
' ', если не ответили
Deleted - 'D', если удалено,
' ', если не удалено
Draft - 'X', если отложено/draft,
' ', если не draft
Flagged - 'F', если установлен флаг,
' ', если флаг не установлен
Обратите внимание, что поведение несколько непарное. Если вы хотите
знать, является ли сообщение Unseen, вы обязаны проверить на
Unseen == 'U' || Recent == 'N'
toaddress (полный: строка, до 1024 символов)
to[] (возвращает массив объектов из строки To, содержащий):
personal
adl
mailbox
host
fromaddress (полный: строка, до 1024 символов)
from[] (возвращает массив объектов из строки From, содержащий):
personal
adl
mailbox
host
ccaddress (полный cc: строка, до 1024 символов)
cc[] (возвращает массив объектов из строки Cc, содержащий):
personal
adl
mailbox
host
bccaddress (полная bcc-строка, до 1024 символов)
bcc[] (возвращает массив объектов из строки Bcc, содержащий):
personal
adl
mailbox
host
reply_toaddress (полный reply_to: строка, до 1024 символов)
reply_to[] (возвращает массив объектов из строки Reply_to, содержащий):
personal
adl
mailbox
host
senderaddress (полный sender: строка, до 1024 символов)
sender[] (возвращает массив объектов из строки sender, содержащий):
personal
adl
mailbox
host
return_path (полный return-path: строка, до 1024 символов)
return_path[] (возвращает массив объектов из строки return_path, содержащий):
personal
adl
mailbox
host
udate (дата mail-сообщения в формате unix time)
fetchfrom (из строки, сформатировано для вмещения fromlength символов)
fetchsubject (строка темы, сформатированная для вмещения subjectlength символов)
imap_headers
(PHP 3, PHP 4)
imap_headers - возвращает шапки всех сообщений в mailbox'е.
Описание
array imap_headers (int imap_stream)
Возвращает массив отформатированной строки с header-информацией. Один элемента на mail-сообщение.
imap_last_error
(PHP 3>= 3.0.12, PHP 4)
imap_last_error - эта функция возвращает последнюю IMAP-ошибку (если имеется), возникшую в ходе запроса данной страницы.
Описание
string imap_last_error (void)
Эта функция возвращает полный текст последнего IMAP-сообщения об ошибке, возникшей на текущей странице. Стэк ошибок не задействуется; последующий вызов imap_last_error() без ошибок вернёт эту же самую ошибку.
imap_listmailbox
(PHP 3, PHP 4)
imap_listmailbox - читает список mailbox'ов.
Описание
array imap_listmailbox (int imap_stream, string ref, string pattern)
Возвращает массив, содержащий имена mailbox'ов. См. в imap_getmailboxes() описание аргументов ref и pattern.
imap_listsubscribed
(PHP 3, PHP 4)
imap_listsubscribed - список всех подписанных mailbox'ов.
Описание
array imap_listsubscribed (int imap_stream, string ref, string pattern)
Возвращает массив всех mailbox'ов, на которые вы подписались. Почти идентична функции imap_listmailbox(), но возвращает только те mailbox'ы, на которые вы, как текущий пользователь, подписались.
imap_mail
(PHP 3>= 3.0.14, PHP 4)
imap_mail - отправляет сообщение email.
Описание
string imap_mail (string to, string subject, string message [, string additional_headers [, string cc [, string bcc [, string rpath]]]])
Эта функция позволяет отправлять электромыло с корректной обработкой Cc и Bcc. Параметры to, cc и bcc являются строками и разбираются как адресные списки rfc822. Принимающие, специфицированные в bcc, получат почту, но исключены из header'ов. Используйте параметр rpath для специфицирования return-пути. Применяется при использовании РНР в качестве почтового клиента для нескольких пользователей.
imap_mail_compose
(PHP 3>= 3.0.5, PHP 4)
imap_mail_compose - создаёт MIME-сообщение на основе данных разделов envelope и body.
Описание
string imap_mail_compose (array envelope, array body)
imap_mail_copy
(PHP 3, PHP 4)
imap_mail_copy - копирует специфицированные сообщения в mailbox.
Описание
int imap_mail_copy (int imap_stream, string msglist, string mbox [, int flags])
Возвращает TRUE при успехе и FALSE при ошибке.
Копирует почтовые сообщения, специфицированные в списке msglist, в специфицированный mailbox.
msglist это диапазон, а не просто номера сообщений (как указано в
RFC2060).
Flags это битовая маска с одним или более значений:
CP_UID - последовательность номеров содержит UIDS
CP_MOVE - удаляет сообщение из текущего mailbox'а после копирования
imap_mail_move
(PHP 3, PHP 4)
imap_mail_move - перемещает специфицированные сообщения в mailbox.
Описание
int imap_mail_move (int imap_stream, string msglist, string mbox [, int flags])
Перемещает сообщения, специфицированные в списке msglist, в специфицированный mailbox.
msglist это диапазон, а не просто номера сообщений (как описано в
RFC2060).
Flags это битовая маска, которая может содержать одну опцию:
CP_UID - последовательность номеров содержит UIDS
Возвращает TRUE при успехе, FALSE при ошибке.
imap_mailboxmsginfo
(PHP 3>= 3.0.2, PHP 4)
imap_mailboxmsginfo - получает информацию о текущем mailbox'е.
Описание
object imap_mailboxmsginfo (int imap_stream)
Возвращает информацию о текущем mailbox'е. Возвращает FALSE при ошибке.
Функция imap_mailboxmsginfo() проверяет статус текущего mailbox'а на сервере. Она похожа на imap_status(), но будет также суммировать размер всех сообщений в mailbox'е, что потребует некоторого дополнительного времени. Она возвращает информацию в объекте со следующими свойствами:
Таблица 1. Mailbox-свойства
Пример 1. imap_mailboxmsginfo()
imap_mime_header_decode
(PHP 3>= 3.0.17, PHP 4)
imap_mime_header_decode - декодирует элементы MIME-шапки.
Описание
array imap_mime_header_decode (string text)
imap_mime_header_decode() декодирует расширения шапок MIME-сообщения, не являющиеся ASCII-текстом (см. RFC2047). Декодированные элементы возвращаются в массиве объектов, каждый из которых имеет два свойства: "charset" и "text". Если элемент не кодирован и, иначе говоря, является обычным текстом US-ASCII; свойство "charset" этого элемента получает значение "default".
imap_msgno
(PHP 3>= 3.0.3, PHP 4)
imap_msgno - эта функция возвращает количество последовательностей сообщений для данного UID.
Описание
int imap_msgno (int imap_stream, int uid)
Эта функция возвращает количество последовательностей сообщений для данного UID. Это инверсия imap_uid().
imap_num_msg
(PHP 3, PHP 4)
imap_num_msg - выдаёт количество сообщений в текущем mailbox'е.
Описание
int imap_num_msg (int imap_stream)
Возвращает количество сообщений в текущем mailbox'е.
См. также imap_num_recent() и imap_status().
imap_num_recent
(PHP 3, PHP 4)
imap_num_recent - выдаёт количество последних сообщений в текущем mailbox'е.
Описание
int imap_num_recent (int imap_stream)
Возвращает количество последних сообщений в текущем mailbox'е.
См. также: imap_num_msg() и imap_status().
imap_open
(PHP 3, PHP 4)
imap_open - открывает IMAP-поток в mailbox.
Описание
int imap_open (string mailbox, string username, string password [, int flags])
Возвращает IMAP-поток при успехе и FALSE при ошибке. Эта функция может использоваться также для открытия потоков к POP3 и NNTP серверам, но некоторые функции и их возможности доступны только на IMAP-серверах.
Имя mailbox'а состоит из серверной части и пути mailbox'а на этом сервере. Специальное имя INBOX предназначено для персонального mailbox'а текущего пользователя. Серверная часть, заключённая в '{' и '}', состоит из имени сервера или ip-адреса, необязательного номера порта (с префиксом ':') и необязательной спецификации протокола (с префиксом '/'). Серверная часть является обязательной во всех параметрах mailbox'а. Имена почтовых ящиков, содержащие интернациональные символы за пределами печатаемых ASCII, должны быть кодированы с помощью imap_utf7_encode().
Опции это битовая маска с одним или более значений:
OP_READONLY - открывть mailbox только для чтения
OP_ANONYMOUS - не использовать или не обновлять .newsrc на новый (только в NNTP)
OP_HALFOPEN - для имён IMAP и NNTP, открывает соединение, но не открывает mailbox
CL_EXPUNGE - очищает mailbox автоматически после его закрытия
Для соединения с IMAP-сервером, запущенным на порту 143 на локальной машине, сделайте так:
imap_ping
(PHP 3, PHP 4)
imap_ping - проверяет, активен ли IMAP-поток.
Описание
int imap_ping (int imap_stream)
Возвращает TRUE, если поток всё ещё активен, FALSE - в ином случае.
imap_ping() соединяется/ping с потоком, чтобы проверить, активен ли он ещё. Она может обнаружить новую почту; это предпочтительный метод для периодической "проверки новой почты", а также "keep alive" для серверов, которые имеют таймаут активности. (Поскольку PHP-скрипты не пытаются работать так долго, мне трудно представить, что кто-нибудь будет использовать эту функцию. (НЕ прим. перев.)
imap_popen
(PHP 3>= 3.0.12, PHP 4)
imap_popen - открывает постоянный IMAP-поток в mailbox.
Описание
int imap_popen (string mailbox, string user, string password [, int options])
imap_qprint
(PHP 3, PHP 4)
imap_qprint - конвертирует закавыченную печатаемую строку в 8-битную строку.
Описание
string imap_qprint (string string)
Конвертирует закавыченную печатаемую строку в 8-битную строку (в соответствии с RFC2045, разделом 6.7).
Возвращает 8-битную (двоичную) строку.
См. также imap_8bit().
imap_renamemailbox
(PHP 3, PHP 4)
imap_renamemailbox - переименовывает старый mailbox в новый mailbox.
Описание
int imap_renamemailbox (int imap_stream, string old_mbox, string new_mbox)
Эта функция переименовывает mailbox (см. в imap_open() формат имён mbox).
Возвращает TRUE при успехе, FALSE при ошибке.
См. также в imap_createmailbox(), imap_deletemailbox() и imap_open() формат mbox.
imap_reopen
(PHP 3, PHP 4)
imap_reopen - повторно открывает IMAP-поток в новый mailbox.
Описание
int imap_reopen (int imap_stream, string mailbox [, string flags])
Эта функция повторно открывает специфицированный поток в новый mailbox на IMAP или NNTP-сервере.
Опции являются битовой маской с одним или более значений:
OP_READONLY - открыть mailbox только для чтения
OP_ANONYMOUS - не использовать или не обновлять .newsrc на новые (только в NNTP)
OP_HALFOPEN - для имён IMAP и NNTP, открывает соединение, но не открывает mailbox.
CL_EXPUNGE - очищает mailbox автоматически после его закрытия (см. также imap_delete() и imap_expunge()).
Возвращает TRUE при успехе, FALSE при ошибке.
imap_rfc822_parse_adrlist
(PHP 3>= 3.0.2, PHP 4)
imap_rfc822_parse_adrlist - разбирает строку с адресом.
Описание
array imap_rfc822_parse_adrlist (string address, string default_host)
Эта функция разбирает строку адреса, как определено в RFC2822, и для каждого адреса возвращает массив объектов. Свойствами объекта являются:
mailbox - имя mailboxа (username)
host - имя хоста
personal - персональное имя
adl - от исходного маршрута домена
imap_rfc822_parse_headers
(PHP 4)
imap_rfc822_parse_headers - разбирает шапки почты из строки.
Описание
object imap_rfc822_parse_headers (string headers [, string defaulthost])
Эта функция возвращает объект различных header-элементов аналогично imap_header(), но без флагов и других элементов, которые приходят с IMAP-сервера.
imap_rfc822_write_address
(PHP 3>= 3.0.2, PHP 4)
imap_rfc822_write_address - возвращает соответствующим образом отформатированный email-адрес mailbox'а, хост и персональную информацию.
Описание
string imap_rfc822_write_address (string mailbox, string host, string personal)
Возвращает соответственно отформатированный email-адрес, как определено в RFC2822, данного mailbox'а, хост и персональную информацию.
imap_scanmailbox
(PHP 3, PHP 4)
imap_scanmailbox - читает список mailbox'ов, принимает строку для поиска в тексте mailbox'а.
Описание
array imap_scanmailbox (int imap_stream, string ref, string pattern, string content)
Возвращает массив, содержащий имена mailbox'ов, которые имеют content в тексте mailbox'а. Эта функция аналогична imap_listmailbox(), но дополнительно проверяет существование строки content в данных mailbox'а. См. в imap_getmailboxes() описание аргументов ref и pattern.
imap_search
(PHP 3>= 3.0.12, PHP 4)
imap_search - эта функция возвращает массив сообщений, совпадающих с данным критерием поиска.
Описание
array imap_search (int imap_stream, string criteria, int flags)
Эта функция выполняет поиск в mailbox'е, открытом в данный момент в imap-потоке.
criteria это строка, ограниченная пробелами, в которой допускается наличие ключевых
слов. Любые многословные аргументы (например, FROM "joey smith") обязаны быть в кавычках.
ALL - возвращать все сообщения, соответствующие остальной части критерия
ANSWERED - совпадать с сообщениями с установленным флагом \\ANSWERED
BCC "string" - совпадать с сообщениями со "string" в поле Bcc:
BEFORE "date" - совпадать с сообщениями с Date: перед "date"
BODY "string" - совпадать с сообщениями со "string" в теле сообщения
CC "string" - совпадать с сообщениями со "string" в поле Cc:
DELETED - совпадать с удалёнными сообщениями
FLAGGED - совпадать с сообщениями с установленным флагом \\FLAGGED (иногда называемым Important или Urgent)
FROM "string" - совпадать с сообщениями со "string" в поле From:
KEYWORD "string" - совпадать с сообщениями со "string" - ключевым словом
NEW - совпадать с новыми сообщениями
OLD - совпадать со старыми сообщениями
ON "date" - совпадать с сообщениями с Date: совпадающей с "date"
RECENT - совпадать с сообщениями с установленным флагом \\RECENT
SEEN - совпадать с прочитанными сообщениями (установлен флаг \\SEEN)
SINCE "date" - совпадать с сообщениями с Date: после "date"
SUBJECT "string" - совпадать с сообщениями со "string" в поле Subject:
TEXT "string" - совпадать с сообщениями с текстовой "string"
TO "string" - совпадать с сообщениями со "string" в поле To:
UNANSWERED - совпадать с сообщениями, на которые не дан ответ
UNDELETED - совпадать с сообщениями, которые не удалены
UNFLAGGED - совпадать с сообщениями, которые не помечены флагами
UNKEYWORD "string" - совпадать с сообщениями, не имеющими ключевого слова "string"
UNSEEN - совпадать с сообщениями, которые ещё не прочитаны
Например, чтобы найти все сообщения от Mom, на которые не даны ответы, можно использовать: "UNANSWERED FROM mom". Поиск происходит без учёта регистра. Этот список критериев взят из исходного кода UW c-клиента и может быть неполным и неточным (см. также RFC2060, раздел 6.4.4).
Правильными значениями флагов являются SE_UID, тогда возвращаемый массив содержит UID'ы вместо номеров последовательности сообщений.
imap_set_quota
(PHP 4 >= 4.0.5)
imap_set_quota - устанавливает квоту для данного mailbox'а.
Описание
int imap_set_quota (int imap_stream, string quota_root, int quota_limit)
Устанавливает верхний предел квоты на mailboxЭта функция требует, чтобы imap_stream был открыт как бюджет администратора почты. Она не будет работать, если он открыт как любой другой пользователь.
Эта функция в настоящее время доступна только для пользователей библиотеки c-client2000.
imap_stream это указатель потока, возвращаемый из imap_open(). Этот поток обязан быть открыт как mail administrator, иначе функция потерпит
неудачу.
quota_root это mailbox для установки квоты. Этот параметр должен следовать стандарту IMAP
для mailbox'а, 'user.name'.
quota_limit это максимальный размер (в KB) для quota_root.
Возвращает TRUE при успехе, FALSE при ошибке.
Пример 1. imap_set_quota()
$mbox = imap_open ("{your.imap.host:143}", "mailadmin", "password");
if(!imap_set_quota($mbox, "user.kalowsky", 3000)) {
print "Error in setting quota\n";
return;
}
imap_close($mbox);См. также imap_open(), imap_set_quota().
imap_setacl
(PHP 4 >= 4.1.0)
imap_setacl - устанавливает ACL для данного mailbox'а.
Описание
int imap_setacl (int stream_id, string mailbox, string id, string rights)
imap_setflag_full
(PHP 3>= 3.0.3, PHP 4)
imap_setflag_full - устанавливает флаги сообщений.
Описание
string imap_setflag_full (int stream, string sequence, string flag, string options)
Эта функция добавляет специфицированный флаг к набору флагов для сообщений специфицированной последовательности.
Флаги, которые можно установить: "\\Seen", "\\Answered", "\\Flagged", "\\Deleted" и "\\Draft" (как определено в RFC2060).
Аргумент options это битовая маска с одним значением или более:
ST_UID последовательность аргументов содержит UID'ы вместо номеров последовательности.
imap_sort
(PHP 3>= 3.0.3, PHP 4)
imap_sort - сортирует массив header'ов сообщения.
Описание
array imap_sort (int stream, int criteria, int reverse, int options)
Возвращает массив номеров сообщений, отсортированных по заданным параметрам.
Reverse равен 1 для сортировки в обратном порядке.
Criteria может иметь одно (и только одно) из следующих значений:
SORTDATE Date сообщения
SORTARRIVAL дата поступления
SORTFROM mailbox в первом адресе From
SORTSUBJECT тема сообщения
SORTTO mailbox в первом адресе To
SORTCC mailbox в первом адресе cc
SORTSIZE размер сообщения в октетах
Флаги это битовая маска с одним или более значениями:
SE_UID возвращает UID'ы вместо номеров последовательности
SE_NOPREFETCH не извлекает заранее найденные сообщения
imap_status
(PHP 3>= 3.0.4, PHP 4)
imap_status - эта функция возвращает информацию статуса mailbox'а, отличного от текущего.
Описание
object imap_status (int imap_stream, string mailbox, int options)
Эта функция возвращает объект, содержащий информацию статуса. Правильными флагами являются:
SA_MESSAGES - set status->messages сообщениям в mailbox'е
SA_RECENT - set status->recent последним сообщениям в mailbox'е
SA_UNSEEN - set status->unseen непросмотренным (новым) сообщениям в mailbox'е
SA_UIDNEXT - set status->uidnext следующему uid, используемому в mailbox'е
SA_UIDVALIDITY - set status->uidvalidity константе, которая изменяется, когда uid'ы mailbox'а могут больше не быть правильными
SA_ALL - устанавливает всё вышеуказанное
status->flags также устанавливается и содержит битовую маску, которая может сверяться с любой из вышеуказанных констант.
imap_subscribe
(PHP 3, PHP 4)
imap_subscribe - подписывает на mailbox.
Описание
int imap_subscribe (int imap_stream, string mbox)
Подписывает на новый mailbox.
Возвращает TRUE при успехе и FALSE при ошибке.
imap_thread
(PHP 4 >= 4.1.0)
imap_thread - возвращает поточное дерево REFERENCES (?).
Описание
int imap_thread (int stream_id [, int flags])
imap_uid
(PHP 3>= 3.0.3, PHP 4)
imap_uid - эта функция возвращает UID данного номера последовательности сообщений.
Описание
int imap_uid (int imap_stream, int msgno)
Эта функция возвращает UID данного номера последовательности сообщений. UID это уникальный идентификатор, не изменяющийся, в то время как номер последовательности сообщений может измениться при изменении содержимого mailbox'а. Эта функция - инверсия imap_msgno().
Примечание: не поддерживается POP3-mailbox'ами.
imap_undelete
(PHP 3, PHP 4)
imap_undelete - снимает с сообщения отметку на удаление.
Описание
int imap_undelete (int imap_stream, int msg_number)
Эта функция удаляет флаг deletion в специфицированном сообщении, установленный функцией imap_delete() или imap_mail_move().
Возвращает TRUE при успехе, FALSE при ошибке.
imap_unsubscribe
(PHP 3, PHP 4)
imap_unsubscribe - отменяет подписку на mailbox.
Описание
int imap_unsubscribe (int imap_stream, string mbox)
Отменяет подписку на специфицированный mailbox.
Возвращает TRUE при успехе, FALSE при ошибке.
imap_utf7_decode
(PHP 3>= 3.0.15, PHP 4)
imap_utf7_decode - декодирует модифицированную UTF-7-кодированную строку.
Описание
string imap_utf7_decode (string text)
Декодирует модифицированную UTF-7-строку text в 8-битные данные.
Возвращает декодированные 8-битные данные или FALSE, если строка ввода не была правильной модифицированной UTF-7. Эта функция необходима для декодирования имён mailbox'ов, содержащих интернациональные символы вне печатаемого диапазона ASCII. Модифицированная кодировка UTF-7 определена в RFC 2060, раздел 5.1.3 (оригинальная UTF-7 была определена в RFC1642).
imap_utf7_encode
(PHP 3>= 3.0.15, PHP 4)
imap_utf7_encode - конвертирует 8-битные данные в модифицированный UTF-7-текст.
Описание
string imap_utf7_encode (string data)
Конвертирует 8-битные data в модифицированный UTF-7-текст. Это необходимо для имён mailbox'ов, содержащих международные символы вне печатаемого диапазона ASCII. Модифицированная кодировка UTF-7 определена в RFC 2060, раздел 5.1.3 (оригинальная UTF-7 была определена в RFC1642).
Возвращает модифицированный UTF-7-текст.
imap_utf8
(PHP 3>= 3.0.13, PHP 4)
imap_utf8 - конвертирует текст в UTF8.
Описание
string imap_utf8 (string text)
Конвертирует данный text в UTF8 (как определено в RFC2044).
implode
(PHP 3, PHP 4)
implode - объединяет элементы массива со строкой.
Описание
string implode (string glue, array pieces)
Возвращает строку, содержащую строковое представление всех элементов массива в том же порядке со строкой glue между элементами.
import_request_variables
(PHP 4 >= 4.1.0)
import_request_variables - импортирует переменные GET/POST/Cookie в глобальную область видимости.
Описание
bool import_request_variables (string types [, string prefix])
Импортирует GET/POST/Cookie переменные в глобальную область видимости. Это применяется, если вы отключили register_globals, но хотели бы увидеть некоторые переменные в глобальной области.
Используя параметр types, вы можете специфицировать, какие переменные запроса импортировать. Вы можете
использовать символы 'G', 'P' и 'C' для GET, POST и Cookie, соответственно. Эти символы нечувствительны к регистру, поэтому
можно использовать комбинации 'g', 'p' и 'c'.
POST содержит информацию файла, загруженного методом POST. Обратите внимание,
что порядок букв имеет значение, так как, если использовать "gp", POST-переменные
перезапишут GET-переменные с тем же именем. Любые другие буквы, кроме GPC, отбрасываются.
Параметр prefix используется как префикс имени переменной, присоединяемый перед именами всех переменных, импортируемых в глобальную область видимости. Так, если вы имеете GET-переменную "userid" и предоставляете префикс "pref_", вы получите глобальную переменную $pref_userid.
Если вас интересует импортирование других переменных в глобальную область видимости, таких как SERVER, рассмотрите использование extract().
Примечание: хотя параметр prefix является необязательным, вы получите ошибку уровня E_NOTICE, если не специфицируете префикс или специфицируете пустую строку в качестве префикса. Это может нарушить безопасность. Ошибки уровня Notice/уведомление не выводятся при использовании уровня сообщения об ошибках по умолчанию.
in_array
(PHP 4)
in_array - возвращает TRUE, если значение существует в массиве.
Описание
bool in_array (mixed needle, array haystack [, bool strict])
Ищет haystack для needle и возвращает TRUE, если найдёт его в массиве, FALSE - в ином случае.
Если третий параметр strict установлен в TRUE, то функция in_array() также проверит типы needle в haystack.
Примечание: если needle это строка, сравнение выполняется с учётом регистра.
Примечание: в версиях PHP до 4.2.0 needle не мог быть массивом.
ingres_autocommit
(PHP 4 >= 4.0.2)
ingres_autocommit - включает/выключает автоподтверждение.
Описание
bool ingres_autocommit ([resource link])
ingres_autocommit() вызывается до открытия транзакции (до первого вызова ingres_query() или сразу после вызова ingres_rollback() или ingres_autocommit()) для в/отключения режима "autocommit" сервера (когда скрипт начинает работу, режим autocommit отключён).
Когда режим autocommit включён, каждый запрос автоматически подтверждается сервером, как если бы ingres_commit() вызывалась после каждого вызова ingres_query().
См. также ingres_query(), ingres_rollback() и ingres_commit().
ingres_close
(PHP 4 >= 4.0.2)
ingres_close - закрывает соединение с БД Ingres II.
Описание
bool ingres_close ([resource link])
Возвращает TRUE при успехе, FALSE при неудаче.
ingres_close() закрывает соединение с Ingres-сервером, ассоциированное со специфицированной ссылкой. Если параметр link не специфицирован, используется последняя открытая ссылка.
ingres_close() обычно не нужна, поскольку она не закрывает постоянные соединения и все непостоянные соединения автоматически закрываются в конце работы скрипта.
См. также ingres_connect() и ingres_pconnect().
ingres_commit
(PHP 4 >= 4.0.2)
ingres_commit - подтверждает транзакцию.
Описание
bool ingres_commit ([resource link])
ingres_commit() подтверждает открытую в данный момент транзакцию, делая все изменения в БД постоянными/permanent.
Закрывает транзакцию. Новая может быть открыта путём отправки запроса функцией ingres_query().
Вы можете также заставить сервер подтверждать автоматически после каждого запроса/query, вызывая ingres_autocommit() до открытия транзакции.
См. также ingres_query(), ingres_rollback() и ingres_autocommit().
ingres_connect
(PHP 4 >= 4.0.2)
ingres_connect - открывает соединение с БД Ingres II.
Описание
resource ingres_connect ([string database [, string username [, string password]]])
Возвращает ресурс ссылки Ingres II при успехе, FALSE при неудаче.
ingres_connect() открывает соединение с БД Ingres, обозначенной параметром database, который следует синтаксису [node_id::]dbname[/svr_class].
Если некоторые параметры опущены, ingres_connect() использует значения из php.ini для ingres.default_database, ingres.default_user и ingres.default_password.
Соединение закрывается, когда скрипт заканчивает работу или когда вызывается ingres_close() для данной ссылки.
Все другие ingres-функции используют по умолчанию последнюю открытую ссылку, поэтому вам необходимо сохранять возвращаемое значение только в том случае, если вы используете одновременно более одной ссылки.
ingres_fetch_array
(PHP 4 >= 4.0.2)
ingres_fetch_array - извлекает ряд из результата в массив.
Описание
array ingres_fetch_array ([int result_type [, resource link]])
ingres_fetch_array() возвращает массив, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.
Эта функция является расширенной версией ingres_fetch_row(). В дополнение к сохранению данных в числовых индексах результирующего массива, она также сохраняет данные в ассоциативных индексах, используя имена полей в качестве ключей.
Если два или более столбца результата имеют одинаковые имена полей, последний столбец будет иметь преимущество. Для доступа к другим столбцам с тем же именем вы обязаны использовать числовой индекс столбца или создать псевдоним столбца.
ingres_fetch_object
(PHP 4 >= 4.0.2)
ingres_fetch_object - извлекает ряд результата в объект.
Описание
object ingres_fetch_object ([int result_type [, resource link]])
ingres_fetch_object() возвращает объект, соответствующий извлечённому ряду, или FALSE, если рядов больше нет.
Эта функция аналогична ingres_fetch_array(), но возвращает объект, а не массив. Косвенно это означает, что вы можете иметь доступ к данным только по именам полей, но не по их смещениям (числа являются неверными именами свойств).
Необязательный аргумент result_type это константа, и он может иметь следующие значения: INGRES_ASSOC, INGRES_NUM и INGRES_BOTH.
По скорости работы эта функция аналогична ingres_fetch_array() и почти так же быстра, как ingres_fetch_row() (разница несущественна).
ingres_fetch_row
(PHP 4 >= 4.0.2)
ingres_fetch_row - извлекает ряд из результата в перечислимый массив.
Описание
array ingres_fetch_row ([resource link])
ingres_fetch_row() возвращает массив, соответствующий извлечённому ряду, либо FALSE, если рядов больше нет. Каждый результирующий столбец хранится в смещении массива, начиная со смещения 1.
Последующий вызов ingres_fetch_row() возвратит следующий ряд результирующего набора или FALSE, если рядов больше нет.
ingres_field_length
(PHP 4 >= 4.0.2)
ingres_field_length - получает длину поля.
Описание
int ingres_field_length (int index [, resource link])
ingres_field_length() возвращает длину поля. Это количество байтов, используемых сервером для хранения этого поля. Детальную информацию см. в Ingres/OpenAPI User Guide - Appendix C.
index это номер поля; обязан быть в диапазоне от 1 до значения, заданного функцией ingres_num_fields().
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_field_name
(PHP 4 >= 4.0.2)
ingres_field_name - получает имя поля в результате запроса.
Описание
string ingres_field_name (int index [, resource link])
ingres_field_name() возвращает имя поля в результате/query запроса или FALSE - при неудаче.
index это номер поля; обязан быть в диапазоне от 1 до значения, заданного функцией ingres_num_fields().
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_field_nullable
(PHP 4 >= 4.0.2)
ingres_field_nullable - проверяет, является ли поле обнуляемым.
Описание
bool ingres_field_nullable (int index [, resource link])
ingres_field_nullable() возвращает TRUE, если поле может получать значение NULL, и FALSE, если не может.
index это номер поля; обязан быть в диапазоне от 1 до значения, заданного функцией ingres_num_fields().
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_field_precision
(PHP 4 >= 4.0.2)
ingres_field_precision - получает точность поля.
Описание
int ingres_field_precision (int index [, resource link])
ingres_field_precision() возвращает точность поля. Это значение используется только для SQL-типов данных decimal, float и money. Детальную информацию см. в Ingres/OpenAPI User Guide - Appendix C.
index это номер поля; обязан быть в диапазоне от 1 до значения, заданного функцией ingres_num_fields().
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_field_scale
(PHP 4 >= 4.0.2)
ingres_field_scale - получает масштаб/scale поля.
Описание
int ingres_field_scale (int index [, resource link])
ingres_field_scale() возвращает масштаб поля. Это значение используется только для SQL-типа данных decimal. Детали см. в книге Ingres/OpenAPI User Guide - Appendix C.
index это номер поля; обязан быть в диапазоне от 1 до значения, заданного функцией ingres_num_fields().
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_field_type
(PHP 4 >= 4.0.2)
ingres_field_type - получает тип поля в результате запроса.
Описание
string ingres_field_type (int index [, resource link])
ingres_field_type() возвращает тип поля в результате/query запроса или FALSE - при неудаче. Примеры возвращаемых типов: "IIAPI_BYTE_TYPE", "IIAPI_CHA_TYPE", "IIAPI_DTE_TYPE", "IIAPI_FLT_TYPE", "IIAPI_INT_TYPE", "IIAPI_VCH_TYPE". некоторые из этих типов могут отображаться в в более чем один SQL-тип, в зависимости от длины поля (см. ingres_field_length()). Например, "IIAPI_FLT_TYPE" может быть float4 или float8. Детали см. в Ingres/OpenAPI User Guide - Appendix C.
index это номер поля; обязан быть в диапазоне от 1 до значения, заданного функцией ingres_num_fields().
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_num_fields
(PHP 4 >= 4.0.2)
ingres_num_fields - получает количество полей, возвращённых последним запросом.
Описание
int ingres_num_fields ([resource link])
ingres_num_fields() возвращает количество полей в результатах, возвращённых Ingres-сервером после вызова ingres_query().
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_num_rows
(PHP 4 >= 4.0.2)
ingres_num_rows - получает количество задействованных или возвращённых рядов после последнего запроса.
Описание
int ingres_num_rows ([resource link])
Для запросов delete, insert или update ingres_num_rows() возвращает количество задействованных в запросе рядов. Для других запросов ingres_num_rows() возвращает количество рядов в query-результате.
Примечание: эта функция в основном предназначена для получения количества модифицированных в БД рядов. Если эта функция вызывается перед использованием ingres_fetch_array(), ingres_fetch_object() или ingres_fetch_row(), сервер будет удалять результирующие данные, и скрипт не сможет их получить.
Вместо этого вы должны запросить результирующие данные с помощью одной из fetch-функций в цикле, пока функция не возвратит FALSE, указывая, что результатов больше нет.
См. также ingres_query(), ingres_fetch_array(), ingres_fetch_object() и ingres_fetch_row().
ingres_pconnect
(PHP 4 >= 4.0.2)
ingres_pconnect - открывает постоянное соединение с БД Ingres II.
Описание
resource ingres_pconnect ([string database [, string username [, string password]]])
Возвращает ресурс Ingres II-ссылки при успехе, FALSE при неудаче.
См. в ingres_connect() детали о параметрах и примеры. Есть только два отличия между ingres_pconnect() и ingres_connect() : первое - при соединении функция сначала пытается найти (постоянную) ссылку, которая уже открыта с теми же параметрами. Если она найдена, возвращается её идентификатор, вместо открытия нового соединения. Второе - соединение с Ingres-сервером не будет закрыто по окончании выполнения скрипта. Вместо этого, ссылка останется открытой для последующего использования (ingres_close() не закроет ссылки, установленные функцией ingres_pconnect()). Ссылки этого типа называются поэтому 'persistent/постоянные'.
См. также ingres_connect() и ingres_close().
ingres_query
(PHP 4 >= 4.0.2)
ingres_query - отправляет SQL-запрос/query в Ingres II.
Описание
bool ingres_query (string query [, resource link])
Возвращает TRUE при успехе, FALSE при неудаче.
ingres_query() отправляет данный query Ingres-серверу. Этот запрос обязан быть правильным SQL-запросом (см. справочник Ingres SQL).
Этот запрос становится частью текущей открытой транзакции. Если открытой транзакции нет, ingres_query() открывает новую транзакцию. Для закрытия транзакции вы можете вызвать либо ingres_commit() для подтверждения сделанных в БД изменений, либо ingres_rollback() - для отмены (отката) этих изменений. По окончании работы скрипта, любая открытая транзакция откатывается (вызовом ingres_rollback()). Вы можете также использовать ingres_autocommit() перед открытием новой транзакции, чтобы немедленно подтверждать каждый SQL-запрос.
Некоторые типы SQL-запросов не могут быть отправлены этой функцией:
close (см. ingres_close())
commit (см. ingres_commit())
connect (см. ingres_connect())
disconnect (см. ingres_close())
get dbevent
prepare to commit
rollback (см. ingres_rollback())
savepoint
set autocommit (см. ingres_autocommit())
все запросы, относящиеся к курсорам, не поддерживаются
ingres_rollback
(PHP 4 >= 4.0.2)
ingres_rollback - откатывает транзакцию.
Описание
bool ingres_rollback ([resource link])
ingres_rollback() откатывает текущую открытую транзакцию, отменяя все изменения, сделанные в БД в ходе этой транзакции.
Это закрывает транзакцию. Новая может быть открыта путём отправки запроса функцией ingres_query().
См. также ingres_query(), ingres_commit() и ingres_autocommit().
ini_alter
(PHP 4)
ini_alter - изменяет значение опции конфигурации.
Описание
string ini_alter (string varname, string newvalue)
Изменяет значение опции конфигурации, возвращая FALSE при неудаче и предыдущее значение опции конфигурации - при успехе.
Примечание: это псевдоним функции ini_set().
См. также ini_get(), ini_get_all(), ini_restore() и ini_set().
ini_get
(PHP 4)
ini_get - получает значение опции конфигурации.
Описание
string ini_get (string varname)
Возвращает значение опции конфигурации при успехе, пустую строку - при неудаче.
См. также get_cfg_var(), ini_get_all(), ini_alter(), ini_restore() и ini_set().
ini_get_all
(PHP 4 >= 4.2.0)
ini_get_all - получает все опции конфигурации.
Описание
array ini_get_all ([string extension])
Возвращает все зарегистрированные опции конфигурации в виде ассоциативного массива. Если установлен необязательный параметр extensionset, возвращает только опции, относящиеся к данному расширению.
См. также ini_alter(), ini_restore(), ini_get() и ini_set().
ini_restore
(PHP 4)
ini_restore - восстанавливает значение опции конфигурации.
Описание
string ini_restore (string varname)
Восстанавливает оригинальное значение данной опции конфигурации.
См. также ini_alter(), ini_get(), ini_get_all() и ini_set().
ini_set
(PHP 4)
ini_set - устанавливает значение опции конфигурации.
Описание
string ini_set (string varname, string newvalue)
Устанавливает значение данной опции конфигурации. Возвращает старое значение при успехе, FALSE при неудаче. Опция конфигурации будет сохранять это новое значение в процессе выполнения скрипта и восстановится по окончании работы скрипта.
Не все доступные опции могут быть изменены с помощью ini_set(). Ниже приведена таблица со списком всех опций PHP (как в PHP 4.2.0) и с указанием, какие могут быть изменены/установлены и на каком уровне.
Таблица 1. Опции конфигурации
Таблица 2. Определение констант PHP_INI_*
См. также: ini_alter(), ini_get() и ini_restore().
intval
(PHP 3, PHP 4)
intval - получает целочисленное значение переменной.
Описание
int intval (mixed var [, int base])
Возвращает integer-значение переменной var, используя для конвертации специфицированную базу/base (по умолчанию base равна 10).
var может быть скалярным типом. Вы не можете использовать intval() с array и object.
Примечание: аргумент base для intval() не имеет эффекта, если только аргумент var не является строкой.
См. также floatval(), strval(), settype() и Трюки с типами.
ip2long
(PHP 4)
ip2long - конвертирует строку, содержащую адрес (IPv4) Internet Protocol, в подходящий адрес.
Описание
int ip2long (string ip_address)
Функция ip2long() генерирует IPv4 Internet сетевой адрес из стандартного представления в Internet-формате (строки с точками).
iptcembed
(PHP 3>= 3.0.7, PHP 4)
iptcembed - внедряет двоичные IPTC-данные в JPEG-изображение.
Описание
array iptcembed (string iptcdata, string jpeg_file_name [, int spool])
iptcparse
(PHP 3>= 3.0.6, PHP 4)
iptcparse - разбирает двоичный IPTC-блок http://www.iptc.org/ на отдельные тэги.
Описание
array iptcparse (string iptcblock)
Эта функция разбирает двоичный IPTC-блок на отдельные тэги. Она возвращает массив с использованием tagmarker в качестве индекса и value в качестве значения. Возвращает FALSE при ошибке или если IPTC-данные не найдены. См. примеры в getimagesize().
ircg_channel_mode
(PHP 4 >= 4.0.5)
ircg_channel_mode - устанавливает флаги режима канала для пользователя.
Описание
boolean ircg_channel_mode (resource connection, string channel, string mode_spec, string nick)
Устанавливает флаги режима для канала channel на сервере по соединению connection. Флаги режима передаются в параметре mode_spec и применяются для пользователя, специфицированного в параметре nick.
Флаги режима устанавливаются или очищаются путём специфицирования символа режима и присоединения к нему спереди символов плюс или минус, соответственно. Например, режим операции/operator задаётся через '+o' и отменяется через '-o', передаваемые как mode_spec.
ircg_disconnect
(PHP 4 >= 4.0.4)
ircg_disconnect - закрывает соединение с сервером.
Описание
boolean ircg_disconnect (resource connection, string reason)
ircg_disconnect() закрывает соединение connection с сервером, установленное ранее функцией ircg-pconnect().
См. также ircg_pconnect().
