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

Разблокирует документ для доступа другим



Описание

int hw_unlock(int connection, int objectID); Разблокирует документ для доступа другим пользователям. Смотри также hw_GetAndLock().

Описание

string hw_getusername(int connection); Возвращает имя пользователя соединения.  



Описание

array getimagesize(string filename, array [imageinfo]); Функция

GetImageSize() определяет размеры любых изображений в файлах GIF, JPG или PNG и возвращает размерность вместе с типом файла и строкой в формате высота/ширина, которую можно использовать в стандартном теге HTML IMG. Возвращается массив из четырех элементов. Индекс 0 содержит ширину изображения в пикселах. Элемент 1 содержит высоту. Элемент 2 - флаг типа изображения. 1 = GIF, 2 = JPG, 3 = PNG. Элемент 3 - строку с корректным заданием "height=xxx width=xxx" для прямого использования в теге IMG



Описание

int imagearc( int im, int cx, int cy, int w, int h, int s, int e, int col); ImageArc рисует чать эллипса с центро в cx, cy (верхний левый угол - 0,0) в изображении im. w и h определяют высоту и ширину эллипса в соответствии с начальной и конечной точкой, определенными в аргументах s и e.



Описание

int imagechar( int im, int font, int x, int y, string c, int col); ImageChar рисует первый символ из c в рисунке id с верхним левым углом в x,y (верхний левый - 0,0) цветом col. Шрифтом 1, 2, 3, 4 или 5, используются встроенные шрифты (больше цифра - больше шрифт). Смотри также imageloadfont().



Описание

int imagecharup( int im, int font, int x, int y, string c, int col); ImageCharUp рисует символ c вертикально в изображении im по координатам x, y (верхний левый - 0, 0) с цветом col. Если font равен 1, 2, 3, 4 или 5, используются встроенные шрифты. Смотри также imageloadfont().



Описание

int imagecolorallocate( int im, int red, int green, int blue); ImageColorAllocate возвращает цвет в схеме RGB. Аргумент im возвращается функцией imagecreate(). ImageColorAllocate должна быть вызвана для создания каждого цвета, который планируется использовать в изображении, представленном im. $white = ImageColorAllocate($im, 255,255,255); $black = ImageColorAllocate($im, 0,0,0);



Описание

int imagecolortransparent(int im, int [col]); ImageColorTransparent устанавливает прозрачный цвет в изображении im в col. im - идентификатор изображения, возвращенный imagecreate(), а col - идентификатор цвета, возвращенный функцией imagecolorallocate(). Возвращается идентификатор нового ( или текущего, если не указан параметр col) прозрачного цвета.



Описание

int imagecopyresized( int dst_im, int src_im, int dstX, int dstY, int srcX, int srcY, int dstW, int dstH, int srcW, int srcH); ImageCopyResized копир область одного изображения в другое. dst_im - изображение-получатель, src_im - исходное изображение. Если координаты исходного и результирующего изображений различны по ширине и высоте, производится соответствующее сжатие/растягивание фрагмента изображения. Координаты - относительно левого верхнего угла. Функция может быть использована для копирования фрагментов одного и того же изображения (если dst_im равно src_im) но если области перекроются, результат может быть непредсказуемым.



Описание

int imagecreate(int x_size, int y_size); ImageCreate возвращает идентификатор изображения чистого листа размерами x_size на y_size.



Описание

int imagecreatefromgif(string filename); ImageCreateFromGif возвращает идентификатор изображения, полученного из filename.



Описание

int imagedashedline( int im, int x1, int y1, int x2, int y2, int col); ImageLine рисует пунктирную линию от x1,y1 до x2,y2 (верхний левй угол - 0,0) в изображении im цветом col. Смотри также imageline().



Описание

int imagedestroy(int im); ImageDestroy освобождает память, ассоциированную с изображением im. im - идентификатор, возвращенный функцией imagecreate().



Описание

int imagefill( int im, int x, int y, int col); ImageFill выполняет заливку, начиная с координат x, y (верхний левй угол - 0,0) цветом col изображения im.



Описание

int imagefilledpolygon( int im, array points, int num_points, int col); ImageFilledPolygon создает закрашенный многоугольник в изображении im. points - массив PHP содержит вершины многоугольника: points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, etc. num_points - общее число вершин.



Описание

int imagefilledrectangle( int im, int x1, int y1, int x2, int y2, int col); ImageFilledRectangle создает закрашенный прямоугольник цвета col в изображении im, начиная с координат верхнего левого угла x1, y1, и заканчивая в правом нижнем - x2, y2. 0, 0 - левый верхний угол изображения.



Описание

int imagefilltoborder( int im, int x, int y, int border, int col); ImageFillToBorder выполняет заливку до границы, определенной цветом в border. Начальная точка заливки - x,y (верхний левый угол - 0,0) и облласть заливается цветом col.



Описание

int imagefontheight(int font); Возвращает высоту шрифта font в пикселах.Смотри также imagefontwidth() и imageloadfont().



Описание

int imagefontwidth(int font); Возвращает ширину символа шрифта font в пикселах. Смотри также imagefontheight() и imageloadfont().



Описание

int imagegif(int im, string filename); ImageGif создает GIF файл с именем filename из изображения im. Аргумент im возвращается функцией imagecreate(). Формат изображения будет соответствовать спецификации GIF87a, если изображение не было сделано прозрачным функцией imagecolortransparent(), в этом случае формат будет соответствовать GIF89a. Аргумент filename опционален, и если он отсутствует, строки изображения будут выводиться непосредственно на брайзер потоком. Указав тип изображения image/gif в функции header, вы можете создавать PHP скрипты, которые будут выводить GIF на браузер.



Описание

int imageinterlace(int im, int [interlace]); ImageInterlace() переключает бит чередования. Если interlace равен 1, изображение im будет выводиться поэтапно, и если interlace равно 0, чередование выключено. Возвращается текущее состояние бита чередования для изображения.



Описание

int imageline( int im, int x1, int y1, int x2, int y2, int col); ImageLine рисует линию от x1,y1 до x2,y2 (левй верхний точка - 0,0) в изображении im цветом col. Смотри также imagecreate() и imagecolorallocate().



Описание

int imageloadfont(string file); ImageLoadFont загружает пользовательский растровый шрифт и возвращает идентификатор шрифта (который всегда больше 5, тобы не вызвать конфликта со встроенными шрифтами). Файл шрифта - двоичный и архиетктурно зависимый. Это значит, что Вам следует генерировать файл шрифта на том процессоре (архитектуре), на котором Вы будете запускать PHP.



Описание

int imagepolygon( int im, array points, int num_points, int col); ImagePolygon создает многоугольник в изображении im. points - массив PHP, содержащий вершины многоугольника, т.е points[0] = x0, points[1] = y0, points[2] = x1, points[3] = y1, etc. num_points - общее число вершин. Смотри также imagecreate().



Описание

int imagerectangle( int im, int x1, int y1, int x2, int y2, int col); ImageRectangle создает прямоугольник цветом col в изображении im, начиния с левой верхней координаты x1,y1 и заканчивая нижней правой x2,y2. 0,0 - левй верхний угол изображения.



Описание

int imagesetpixel( int im, int x, int y, int col); ImageSetPixel рисует пиксел x,y (верхний левый - 0,0) в изображении im цветом col. Смотри также imagecreate() и imagecolorallocate().



Описание

int imagestring( int im, int font, int x, int y, string s, int col); ImageString рисует строку s в изображении im по координатам x,y (верхний левый - 0,0) цветом col. Если font равен 1, 2, 3, 4 или 5, используются встроенные шрифты. Смотри также imageloadfont().



Описание

int imagestringup( int im, int font, int x, int y, string s, int col); ImageStringUp рисует строку s вертикально в изображении im по координатам x,y (верхний левый - 0,0) цветом col. Если font равен 1, 2, 3, 4 или 5, используются встроенные шрифты. Смотри также imageloadfont().



Описание

int imagesx(int im); ImageSX возвращает ширину изображения, определяемого im. Смотри также imagecreate() и imagesy().



Описание

int imagesy(int im); ImageSY возвращает высоту изображения, определяемого im. Смотри также imagecreate() и imagesx().



Описание

array ImageTTFBBox( int size, int angle, string fontfile, string text); Функция рассчитывает и возвращает границы области (в пикселах) для текста с шрифтами TrueType. text Измеряемая строка. size Размер шрифта. fontfile Имя файла TrueType шрифта. (Может быть и URL.) angle Угол в градусах, под которым наклонен измеряемый text. ImageTTFBBox() возвращает массив из 8-и элементов, представляющих четыре точки границы области текста:
0 нижний левый угол, позиция X
1 нижний левый угол, позиция Y
2 нижний правый угол, позиция X
3 нижний правый угол, позиция Y
4 верхний правый угол, позиция X
5 верхний правый угол, позиция Y
6 верхний левый угол, позиция X
7 верхний левый угол, позиция Y
Точки относятся к text безотносительно к углу, т.е "верхний левый" означает верхний левый угол текста при его горизонтальном расположении. Функция требует две библиотеки: GD и Freetype.Смотри также ImageTTFText().



Описание

array ImageTTFText( int im, int size, int angle, int x, int y, int col, string fontfile, string text); ImageTTFText рисует строку text в изображении, идентифицируемом im, начиная с координат x,y (верхняя левая - 0,0), под углом angle цветом col, используя файл TrueType шрифта, указанный в fontfile. Координаты, указанные в x, y определяют базовую точку символа (приблизительно нижний левый угол). Это отличается от ImageString(), где x,y определяют верхний правый угол первого символа. angle в градусах, 0 означает написание текста с лава на право (в направлении на 3 часа), более высокие значения - поворот против часовой стрелки (т.е. 90 - написание текста с низу вверх). fontfile - путь к файлу шрифта TrueType, который планируется использовать. text - строка текста, которая может включать символы UTF-8 (в форма: { ) для доступа к сиволам за пределами первых 255. col индекс цвета. Использование отрицания индекса цвета имеет эффект включения антиалиасинга. ImageTTFText() возвращает массив из 8 элементов, представляющих четыре точки границы области вывода текста. Порядок точек: вепхняя левая, верхняя правая, нижняя правая, нижняя левая. ТОчки относятся к тексту без учета угла, т.е. "верхняя левая" означает верхний левый угол горизонтально расположенного текста. Скрипт этого примера создает черный GIF 400x30 пикселей, со словом "Testing...", написанным шрифтом Arial.



Описание

int imagecolorat( int im, int x, int y);Returns the index of the color of the pixel at the specified location in the image.Смотри также imagecolorset() и imagecolorsforindex().



Описание

int imagecolorclosest( int im, int red, int green, int blue); Возвращает индекс цвета в палитре изображения, который "ближе всего" к указанному набору RGB. "Дистанция" между желанным цветом и каждым цветом в палитре определяется так, как будто значения RGB определяют точки в трехмерном пространстве.Смотри также imagecolorexact().



Описание

int imagecolorexact( int im, int red, int green, int blue); Возвращает индекс указанного цвета в палитре изображения. Если цвет в палитре изображения не присутствует, возвращается -1.Смотри также imagecolorclosest().



Описание

int imagecolorresolve( int im, int red, int green, int blue); Эта функция всегда возвращает индекс для запрашиваемого цвета, одно из двух - или указанный цвет, или ближайшую альтернативу.Смотри также imagecolorclosest().



Описание

bool imagecolorset( int im, int index, int red, int green, int blue); Эти установки устанавливают соответствие между индексом в палитре и цветом. это используется для создания эффектов сплошной заливки в палитре изображения без накладных расходов преобразования текущей заливки.Смотри также imagecolorat().



Описание

array imagecolorsforindex(int im, int index); Возвращается ассоциативный массив с красным, синим и зеленым ключами, которые содержат соответствующие значения для указанного индекса цвета.Смотри также imagecolorat() и imagecolorexact().



Описание

int imagecolorstotal(int im); Возвращает количество цветов в указанной палитре.Смотри также imagecolorat() и imagecolorsforindex().  



Описание

int imap_append( int imap_stream, string mbox, string message, stringflags);Возвращает true в случае успеха или false иначе.imap_append() добавляет текстовое сообщение в указанный почтовый ящик mbox. Если указаны необязательные флаги, также записывает в почтовый ящик и флаги.При общении с сервером Cyrus IMAP нужно использовать в качестве ограничителей строки "\r\n" вместо "\n", иначе действие не выполнится.



Описание

string imap_base64(string text);Функция imap_base64() декодирует текст в формате BASE-64. Декодированное сообщение возвращается как строка.



Описание

string imap_body( int imap_stream, int msg_number, int flags);Функция imap_body() возвращает тело сообщения, имеющего номер п/п msg_number в текущем почтовом ящике. Необязательные флаги это битовые маски изFT_UID - Номер сообщения msgno является UID'ом сообщения
FT_PEEK - Не устанавливать флаг \Seen если он еще не установлен.
FT_INTERNAL - Возвращаемая строка записана во внутреннем формате и не может быть приведена к канонической форме с CRLF.



Описание

array imap_check(int imap_stream);Возвращает информацию о текущем почтовом ящике. В случае неуспеха возвращает FALSE.Функция imap_check() проверяет статус текущего почтового ящика на сервере и возвращает информацию в объекте со следующими свойствами. Date : дата сообщения
Driver : драйвер
Mailbox : название почтового ящика
Nmsgs : количество сообщений
Recent : количество недавно пришедших сообщений



Описание

int imap_close(int imap_stream, int flags); Закрывает поток imap. Необязательный флаг CL_EXPUNGE заставляет стереть помеченные на удаление сообщения при закрытии.



Описание

int imap_createmailbox(int imap_stream, string mbox);imap_createmailbox() создает новый почтовый ящик указанный в mbox. Возвращает true в случае успеха и false при ошибке.



Описание

int imap_delete(int imap_stream, int msg_number);Возвращает true.
Функция imap_delete() помечает сообщение, указанное через msg_number на удаление. Настоящее удаление сообщений осуществляется функцией imap_expunge().



Описание

int imap_deletemailbox(int imap_stream, string mbox);imap_deletemailbox() удаляет указанный почтовый ящик. Возвращает true в случае успеха и false иначе.



Описание

int imap_expunge(int imap_stream);imap_expunge() удаляет все сообщения помеченные на удаление с помощью imap_delete(). Возвращает true.



Описание

string imap_fetchbody( int imap_stream, int msg_number, int part_number, flags flags);Эта функция заставляет извлечь подробную секцию указанного сообщения как текстовую строку. Секция - это строка целых чисел, разделенных точками, которые указывают на части тела сообщения в списке частей согласно спецификации IMAP4. Части тела не декодируются этой функцией. Необязательным параметром к imap_fetchbody () является битовая маска из
    FT_UID - msgono является UID'ом
    FT_PEEK - не устанавливать флаг \Seen если он не установлен
    FT_UID - возвращаемая строка записана во внутреннем формате, которое не может быть канонизированна с помощью CRLF




Описание

array imap_fetchstructure(int imap_stream, int msg_number); Эта функция заставляет извлечь всю информацию о структуре сообщения с номером msg_number. Возвращаемая величина является объектом со следующими элементами.
typeencodingifsubtypesubtypeifdescriptiondescriptionifididlinesbytesifparameters
типкодировкаподтип интерфейсаподтипописание интерфейсаописаниеидентификатор интерфейсаидентификаторстрокибайтыпараметры интерфейса
Также функция возвращает массив объектов под названием parameters[]. Этот объект имеет следующие свойства.
attributevalue
атрибутвеличина
В случае сообщения из нескольих частей, функция также возвращает массив объектов всех свойств под название parts[].



Описание

object imap_header(int imap_stream, int msg_number, int fromlength, int subjectlength, int defaulthost);Эта функция возвращает объект различных элементов заголовка remail,date,Date,subject,Subject,in_reply_to,message_id,newsgroups, followup_to,referencestoaddress (полная строка To: строка длиной до 1024 символов)to[] (возвращает массив объектов из строки To, содержит:) personal adl mailbox hostfromaddress (полная строка From: строка длиной до 1024 символов)from[] (возвращает массив объектов из строки From, содержит:) personal adl mailbox hostccaddress (полная строка Cc: строка длиной до 1024 символов) cc[] (возвращает массив объектов из строки Cc, содержит:) personal adl mailbox hostbccaddress (полная строка Bcc: строка длиной до 1024 символов) bcc[] (возвращает массив объектов из строки Bcc, содержит:) personal adl mailbox hostreply_toaddress (полная строка Reply_to: строка длиной до 1024 символов) reply_to[] (возвращает массив объектов из строки Reply_to, содержит:) personal adl mailbox hostsenderaddress (полная строка Sender: строка длиной до 1024 символов) sender[] (возвращает массив объектов из строки Sender, содержит:) personal adl mailbox hostreturn_path (полная строка Return-path: строка длиной до 1024 символов) return_path[] (возвращает массив объектов из строки Return_path, содержит:) personal adl mailbox hostudate ( дата сообщения в формате времени unix)fetchfrom (строка From, отформатированная до fromlength символов) fetchsubject (строка Subject, отформатированная до subjectlength символов)



Описание

array imap_headers(int imap_stream); Возвращает строковый массив из информации по заголокам. Один элемент массива на сообщение.



Описание

array imap_listmailbox( int imap_stream, string ref, string pat);Возвращает массив, содержащий названия почтовых ящиков.



Описание

array imap_listsubscribed( int imap_stream, string ref, string pattern);Возвращает массив всех почтовых ящиков на которые Вы подписаны. Аргументы ref и pattern указывают начальное месторасположение откуда начинать поиск и шаблон, которому должны удовлетворять названия почтовых ящиков.



Описание

int imap_mail_copy( int imap_stream, string msglist, string mbox, int flags);Возвращает true в случае успеха и false иначе. Копирует почтовые сообщения указанные с помощью msglist в почтовый ящик mbox. msglist - это диапазон, а не просто номера сообщений. флаги - это битовые маски из
    CP_UID - номера в последовательности содержат UID'ы
    CP_MOVE - после копирования удалить сообщения из текущего почтового ящика




Описание

int imap_mail_move( int imap_stream, string msglist, string mbox);Переносит почтовые сообщения указанные с помощью msglist в почтовый ящик mbox. msglist - это диапазон, а не просто номера сообщений. Возвращает true в случае успеха и false иначе.



Описание

int imap_num_msg(void); Возвращает количество сообщений в текущем почтовом ящике.



Описание

int imap_num_recent(int imap_stream); Возвращает количество недавно пришедших сообщений в текущем почтовом ящике.imap_openimap_open -- Открывает поток IMAP в почтовый ящик



Описание

int imap_open( string mailbox, string username, string password, int flags);В случае успеха возвращает поток IMAP или false иначе. Эта функция может быть использована для открытия потоков к POP3 и NNTP серверам. Для того, чтобы присоединиться к серверу IMAP на 143-й порт на локальной машине сделайте следующее:$mbox = imap_open("{localhost:143}INBOX","user_id","password");Для того, чтобы подсоединиться к POP3-серверу на 110-й порт на локальном сервере используйте:$mbox = imap_open("{localhost/pop3:110}INBOX","user_id","password");Для того, чтобы подсоединиться к NNTP-серверу на 119-й порт на локальном сервере используйте:$nntp = imap_open("{localhost/nntp:119}comp.test","","");Для того, чтобы подсоединиться к удаленному серверу замените "localhost" на имя или IP-адрес сервера к которому Вы хотите подсоединиться.Опции - битовая маска из
    OP_READONLY - Открыть почтовый ящик в режим "только чтение"
    OP_ANONYMOUS - Не использовать или не обновлять .newsrc при использовании новостей
    OP_HALFOPEN - Для IMAP и NNTP устанавливает соединение, но не открывает почтовый ящик
    CL_EXPUNGE - Автоматически очищать почтовый ящик при закрытии




Описание

int imap_ping(int imap_stream); Возвращает true если поток еще работоспособен и false иначе. Функция imap_ping() проверяет поток на работоспособность. Он может также проверять новую почту; это предпочтительный метод для периодической проверки новой почты и "живучести" удаленных серверов.



Описание

int imap_renamemailbox( int imap_stream, string old_mbox, string new_mbox);Эта функция переименовывает старый почтовый ящик в новый. Возвращает true в случае успеха и false иначе.



Описание

int imap_reopen( string imap_stream, string mailbox, string [flags]);Возвращает true в случае успеха и false иначе. Эта функция заново открывает указанный поток на новый ящик.Опции - битовая маска из
    OP_READONLY - Открыть почтовый ящик в режиме только чтение
    OP_ANONYMOUS - Не использовать или не обновлять .newsrc при работе с новостями
    OP_HALFOPEN - Для IMAP и NNTP устанавливает связь но не открывает почтовый ящик
    CL_EXPUNGE - Очищает почтовый ящик при закрытии




Описание

int imap_subscribe(int imap_stream, string mbox); Подписывает на новый почтовый ящик. Возвращает true в случае успеха и false иначе.



Описание

int imap_undelete(int imap_stream, int msg_number);Эта функция cнимает отметку с сообщения помеченного на удаление функцией imap_delete(). Возвращает true в случае успеха и false иначе.



Описание

int imap_unsubscribe(int imap_stream, string mbox);Снимает подписку с почтового ящика. Возвращает true в случае успеха и false иначе.



Описание

string imap_qprint(string string); Конвертирует строку формата quoted-printable в 8-битовую строку. Возвращает 8-битовую (бинарную) строку



Описание

string imap_8bit(string string);Конвертирует 8- битовую строку в формат quoted-printable. Возвращает строку в формате quoted-printable.



Описание

string imap_binary(string string);Конвертирует 8-битную строку в формат base64. Возвращает строку в формате base64.



Описание

array imap_scanmailbox(int imap_stream, string string); Возвращает массив, содержащий имена почтовых ящиков, которые имеют строку string в названии.



Описание

array imap_mailboxmsginfo(int imap_stream);Возвращает информацию о текущем почтовом ящике. FALSE в случае неудачи. Функция imap_mailboxmsginfo() проверяет статус текущего почтового ящика на сервере и возвращает информацию в объекте со следующими свойствами:
    Date : дата сообщения
    Driver : драйвер
    Mailbox : название почтового ящика
    Nmsgs : количество сообщений
    Recent : количество недавно пришедших сообщений
    Unread : количество непрочитанных сообщений
    Size : размер почтового ящика




Описание

string imap_rfc822_write_address( string mailbox, string host, string personal);Возвращает правильно отформатированный email адрес по данному почтовому ящику, хосту и персональной информации.



Описание

string imap_rfc822_parse_adrlist(string address, string default_host); Эта функция разбирает адресную строку и для каждого адреса возвращает массив объектов. Есть 4 типа объектов:
    mailbox - название почтового ящика (имя пользователя)
    host - название хоста
    personal - личное имя
    adl - путь к домену-источнику




Описание

string imap_setflag_full( int stream, string sequence, string flag, string options);Эта функция застваляет добавить указанный флаг к набору флагов сообщения в указанной последовательности.options - это битовая маска из
    ST_UID Аргументы последовательности содержат UIDы вместо номеров


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