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

e8007f77

Для файла fp устанавливает указатель



Описание

int fseek(int fp, int offset); Для файла fp устанавливает указатель в потоке файла на смещение в offset байт. Эквивалентно вызову в Си fseek( fp, offset, SEEK_SET ). При удачном выполнении возвращает 0, в противном слчае возврщается -1. ЗАметим, что поиск после EOF не рассматривается как ошибка. Не испоьзуется для файловых указателей, возвращенных fopen() при использовании форматов "http://" или "ftp://". Смотри также ftell() и rewind().

Описание

int ftell(int fp); Возвращает позицию указателя в файле, на который ссылвется fp, т.е. смещение в потоке файла. При возникновении ошибки возвращается false. TФайловый указатель должен быть действующим и указывать на файл, успешно открытый fopen() или popen(). Смотри также fopen(),

popen(), fseek() и rewind().



Описание

int fwrite( int fp, string string, int [length]); fwrite() записывает содержимое string в файловый поток, указанный fp. Если аргумент length присутствует, запись останавливается после записи length-го байта, или после записи всей строки string. Заметим, что если есть аргумент length, то конфигурационные опции magic_quotes_runtime игнорируются и никакие слеши из string не удаляются. Смотри также fread(), fopen(), fsockopen(), popen(), и fputs().



Описание

bool is_dir(string filename); Возвращает true, если filename существует и это директория. Смотри также is_file() и is_link().



Описание

bool is_executable(string filename); Возвращает true, если filename существует и является исполнимым файлом. Смотри также is_file() и is_link().



Описание

bool is_file(string filename); Возвращает true, если filename существует и является обычным файлом. Смотри также is_dir() и is_link().



Описание

bool is_link(string filename); Возвращает true, если filename существует и является символической ссылкой. Смотри также is_dir() и is_file().



Описание

bool is_readable(string filename); Возвращает true, если filename существует и является доступным для чтения. Помните, что PHP может иметь доступ к файлу как поьлзователь, под чьим id запущен веб-сервер (часто 'nobody'). Ограничения безопасного режима не действуют внутри аккаунта. Смотри также is_writeable().



Описание

bool is_readable(string filename); Возврвщает true если файл существует и доступен для записи.Помните, что PHP может иметь доступ к файлу как поьлзователь, под чьим id запущен веб-сервер (часто 'nobody'). Ограничения безопасного режима не действуют внутри аккаунта. Смотри также is_readable().



Описание

int link( string target, string link); link() cсоздает жесткую ссылку. Смотри также symlink() создает символическую ссылку, и readlink() вместе с linkinfo().



Описание

int linkinfo(string path); linkinfo() возвращает поле st_dev из UNIX C структуры stat, возвращенной системным вызовом lstat. Эта функция используется для верификации, если ссылка (указанная в path) реально существует (испотльзует те же методы, что и макрос S_ISLNK, определенный в stat.h). Возвращает 0 или FALSE в случае ошибки. Смотри также symlink(), link(), и readlink().



Описание

int mkdir(string pathname, int mode); Пытается создать директорию, указанную в pathname. Заметим, что если вы захотите указать mode в восьмеричной системе, то число должно начинаться с 0. mkdir("/path/to/my/dir", 0700); Возвращает true при успешном выполнении и false при ошибке. Смотри также rmdir().



Описание

int pclose(int fp); Закрывает файловый указатель к каналу, открытому popen(). Файловый указатель должен быть действующим и возвращен успешным вызовом popen(). Возврващает статус завершения запущенного процесса. Смотри также popen().



Описание

int popen(string command, string mode); ОТкрывает канал к процессу, исполняемому путем форкинга команды command. Возвращает файловый указаель, идентичный возвращемому fopen(), но этот указатель мононаправленный (может использоваться только для чтения или только для записи) и должен бытть закрыт pclose(). Этот указатель можно использовать с fgets(), fgetss(), и fputs(). При возникновении ошибки возвращет false. $fp = popen( "/bin/ls", "r" ); Смотри также pclose().



Описание

int readfile(string filename); Читает файл и записывает его на стандартное устройство вывода. Возвращает количество прочитанных байтов. В случае возникновения ошибки возвращется false и за исключением функции, вызванной как @readfile, выводится сообщение об ошибке. Если filename начинается с "http://" (без учета регистра), открывается соединение HTTP 1.0 к указанному серверу и текст ответа выводится на стандартное устротйство вывода. Поскольку редиректы HTTP не обрабатываются, вы должны включать в указание директории завершающие слеши. Если filename начинается с "ftp://" (без учета регистра), открывается ftp соединение с указанным сервером и файл ответа выводится на стандартное устройство вывода. Если сервер не поддерживает режим пассивного ftp, этот вызов завершится ошибкой. Если filename начинается как-нибудь иначе, будет открыт файл файловой системы и его ссодержимое выведется на стандартное устройство вывода. Смотри также fpassthru(), file(), fopen(), include(), require(), и virtual().



Описание

string readlink(string path); readlink() работает аналогично функции Си readlink и возвращает содержимое символической ссылки path или 0 в случае ошибки. Смотри также symlink(), readlink() и linkinfo().



Описание

int rename(string oldname, string newname); Пытается переименовать oldname в newname. Возвращает true при успешном выполнениии и false при сбое.



Описание

int rewind(int fp); Позиционирует файловфй указатель для fp на начало потока файла. При возникновении ошибки возвращается 0. Файловый указатель должен быть действующим и указавать на файл, успешно открытый fopen(). Смотри также fseek() и ftell().



Описание

int rmdir(string dirname); Пытается удалить директорию, указанную путем. Директория лдолжна быть пустой, и релевантные разрешения должны допустить это. При возникновении ошибкт возвращается 0. Смотри также mkdir().



Описание

array stat(string filename); Собирает статичтику о файле filename. Возвращает массив статистической информации о файле со следующими элементами:
  1. устройство
  2. inode
  3. номер ссылки
  4. id пользователя или владельца
  5. id группы владельца
  6. device type if inode device *
  7. размер в байтах
  8. время последнего доступа
  9. время последней модификации
  10. время последнего изменения
  11. размер блока для I/O файловой системы *
  12. количество занатых блоков
* - тоьлко для систем, поддерживающих тип st_blksize -- в других системах (i.e. Windows) возвращается -1



Описание

array lstat(string filename); Собирает информацию и файле иил символической ссылке filename. Эта функция идентична stat(), но если filename - это символическая ссылка, то возвращается статус символической ссылки, а не статус файла, на который указывает данная ссылка. Возвращает массив статистической информации со следующими элементами:
  1. устройство
  2. inode
  3. число ссылок
  4. id пользователя или владельца
  5. id группы владельца
  6. тип устройства, если inode - устройство *
  7. размер в байтах
  8. время последнего доступа
  9. время последней модификации
  10. время последнего изменения
  11. размер болка для I/O файловой системы *
  12. количество занатых блоков
* - тоьлко для систем, поддерживающих тип st_blksize -- в других системах (i.e. Windows) возвращается -1



Описание

int symlink(string target, string link); symlink() создает символическую ссылку с существующей целью target с указанным именем link. Смотри также link() создает жесткую ссылку, и readlink() вместе с linkinfo().



Описание

string tempnam(string dir, string prefix); Создает никальное имя файла в указанной директории. Если директория не существует, tempnam() может сгененрировать имя файла во временной директории системы. Возвращает новое временное имя файла, или нулевую строку при ошибке.



Описание

int touch(string filename, int time); Пытается установить время модификации файла filename в значение time. Если опция time отсутствует, испотьлзуется текущее время. Если файл не существует, то он создается. Возвращает true при успешном выполнении и false в обратном случае.



Описание

int umask(int mask); umask() устанавливает текущую umask PHP в mask & 0777 и возвращает старую umask. Когда PHP используется ска серверный модуль, umask сохраняется при завершении каждого запроса. umask() без аргументов возвращает текущую маску.



Описание

int unlink(string filename); Удаляет filename. Аналогично функции Unix C unlink(). Возвращает 0 или FALSE при ошибке. Смотри также rmdir() для удаления директорий.  



Описание

int header(string string); Функция Header() используется в начале HTML- файла для отправки строки HTTP заголовка. Смотри HTTP 1.1 Specification для более подробной информации о заголовках HTTP.
Замечание: Помните, что функция Header() должна быть вызвана перед любыми другими операциями вывода, описанными стандартными тэгами HTML или PHP. Наиболее общие ошибки в коде - применение include() с auto_prepend и пробелами или пустыми строками, которые инициируеют вывод до вызова header(). Header("Location: http://www.php.net"); /* Редирект браузера на сайт PHP */ exit; /* Код, следующий ниже, не будет исполняться после редиректа. */ PHP-скрипты часто генерируют динамический HTML, который не следует кешировать на клиентском браузере или прокси-сервере. Многие прокси и клиенты можно заставить отключить кеш:
header("Expires: Mon, 26 Jul 1997 05:00:00 GMT"); // Прошедшая дата
header("Last-Modified: " . gmdate("D, d M Y H:i:s") . "GMT"); // всегда модифицировать
header("Cache-Control: no-cache, must-revalidate"); // HTTP/1.1
header("Pragma: no-cache"); // HTTP/1.0



Описание

int setcookie( string name, string value, int expire, string path, string domain, int secure); SetCookie() определяет кук, который будет послан вместе с остальной информацией из заголовка. Все аргументы, исключая name опциональны. Если присутствует только аргумент name, кук с указанным именем будет удален с клиента. Вы также можете представить любой из аргументов пустой строкой, с целью пропуска оного (""). Параметры expire и secure являются целочисленными и ен могут быть заменены пустыми строками. Для этой цели используют (0). Аргумент expire - это стандартное время Unix, возвращаемое функциями time() или mktime(). secure показывает, что кук следует передавать только по защищенному соединению HTTPS. Некоторые примеры:



Описание

int hw_changeobject( int connection, int object_to_change, string commands); Команда позволяет удалить, добавить или модифицировать индивидуальные атрибуты объектной записи. Объекты указываются идентификатором оюъекта, object_to_change; команды придерживаются следующего синитаксиса: <command>::= <remcmd> |
              <addcmd> |
              <remcmd> "\" <addcmd>

<remcmd>  ::= "rem " <attribute> "=" <value>

<addcmd>  ::= "add " <attribute> "=" <value>                Заметим, что в запросе на удаление или перемещение атрибута, его старое значение также поддерживается (некоторые атрибуты могут иметь одновременно несколько значений). Команда, подобная rem attr=value\add attr=value позводяет модифицировать атрибуты за одну операцию. Возвращает True при отсутствии ошибок, иначе False.



Описание

array hw_children(int connection, int objectID); Возвращает массив идентификаторов объектов. Каждый иденитификатор - коллекции с идентификатором objectID. Массив содержит всех наследников, документы и коллекции.




Описание

array hw_childrenobj(int connection, int objectID); Возвращает массив объектных записей. Каждая запись - коллекции с идентификатором objectID. Массив содержит всех наследников, документы и коллекции.




Описание

int hw_close(int connection); Возвращет false, если соединение не является действующим, в противном случае - true. Closes закрывает соединение с Hyperwave сервером с указанным номером соединения connection.




Описание

int hw_connect( string host, int port, string username, string password); Открывает соединение с Hyperwave сервером и возвращает номер соединение при успешном открытиии, или False, ели слединение не может быть установлено. Каждый аргумент должен быть "закавыченой" строкой, исключая номер порта. Аргумент username и password опциональны и могут не указываться. В случае ошибки идентификации, сервер завершит работу. Проще использовать идентификацию как пользователь anonymous. Функция возращает индекс соединения, необходимы для других функций Hyperwave. Вы можете открыть несколько соединений. Помните, что пароли не шифруются. Смотри также hw_pConnect().




Описание

int hw_cp( int connection, array object_id_array, int destination id); Копирует объекты с идентификаторами, указанными во втором параметре в коллекцию с идентификатором destination id. Возвращается число скопированных объектов. Смотри также hw_mv().




Описание

int hw_deleteobject(int connection, int object_to_delete); Удаляет объект с идентификатором, указанным во втором параметре. Будут удалены все экземпляры объекта. При отсутствии ошибок возвращает true, инача - false. Смотри также hw_mv().




Описание

int hw_docbyanchor(int connection, int anchorID); Возвращает идентификатор оъекта документа, который относится к якорю anchorID.




Описание

string hw_docbyanchorobj(int connection, int anchorID); Возвращает объектную запись объекта документа, относящегося к якорю anchorID.




Описание

string hw_documentattributes(int hw_document); Возвращает объектную запись документа. Смотри также hw_DocumentBodyTag(), hw_DocumentSize().




Описание

string hw_documentbodytag(int hw_document); Возвращает тег BODY для документа. Если документ в формате HTML, тег BODY должен быть напечатен перед документом. Смотри также hw_DocumentAttributes(), hw_DocumentSize().




Описание

int hw_documentsize(int hw_document); Возвращает размер документа в байтах. Смотри также hw_DocumentBodyTag(), hw_DocumentAttributes().




Описание

string hw_errormsg(int connection); Возвращает строку, содержащую последнее сообщени об ошибке или 'No Error'. Если возвратилось False, функция не выполнилась. Сообщение относится к последней команде.




Описание

int hw_edittext(int connection, int hw_document); Загружет текстовый документ на сервер. Объектная запись документа не должна модифицироваться, пока документ редактируется. Эта функция работает только с чисто текстовыми документами. Она не отрывает специальных соединений для данных, поэтому управление соединением во время передачи данных блокируется. Смотри также hw_PipeDocument(), hw_FreeDocument(), hw_DocumentBodyTag(), hw_DocumentSize(), hw_OutputDocument(), hw_GetText().




Описание

int hw_error(int connection); Возвращет номер последней ошибки. Если 0 - ошибок не было. Ошибка относится к последней команде.




Описание

int hw_free_document(int hw_document); освобождает память, занятую hw-документом.




Описание

array hw_getparentsobj(int connection, int objectID); Возвращает индексированный массив идентификаторов объектов. Каждый ИД объекта относится к родителям объекта с идентификатором objectID.




Описание

array hw_getparentsobj(int connection, int objectID); Возвращает индексированный массив объектных записей плюс ассоциативный массив со статистической информацией об объектных записях. Ассоциативный массив - последний член возвращенного массива. Каждая объектная запись относится к родителю объекта с ИД objectID.




Описание

array hw_getchildcoll(int connection, int objectID); Возвращает массив идентификаторов оюъектов. Каждый ИД объекта относится к наследной коллекции, коллекции с идентификатором objectID. Функция не возвращает наследуемые документы. Смотри также hw_GetChildren(), hw_GetChildDocColl().




Описание

array hw_getchildcollobj(int connection, int objectID); Возвращает массив объектных записей. Каждая запись относится к наследной коллекции, коллекции с идентификатором objectID. Функция не возвращает наследуемые документы. Смотри также hw_ChildrenObj(), hw_GetChildDocCollObj().



Описание

array hw_getsrcbydestobj(int connection, int objectID); Возвращает объектные записи всех якорных точек объекта с ИД objectID. Объект может быть как документом, так и якорем. Смотри также hw_GetAnchors().




Описание

array hw_getobject(int connection, int objectID); Возвращает объектную запись объекта с идентификатором objectID. Смотри также hw_GetAndLock().



Описание

string hw_getandlock(int connection, int objectID); Возвращает объектную запись объекта с ИД objectID. Объект также запирается, поэтому другие позователи не имеют к нему доступа, пока объект не будет разблокирован. Смотри также hw_Unlock(), hw_GetObject().




Описание

int hw_gettext( int connection, int objectID, int rootID); Возвращается документ с идентификатором объекта objectID. Если документ имеет якоря, которые можно вставить, то они будут сразу вставлены. Опциональный параметр rootID определяет, как ссылки будут вставляться в документ. По умолчанию подставляется 0, что означает конструирование ссылок из имен объктов назначения ссылок. Это применимо для веб-приложений. Если ссылка указывает на объект с именем 'internet_movie', ссылка HTML будет выглядеть как <A HREF="/internet_movie">. Настоящее положение исходного объекта и объекта назначения в иерархии документа полностью игнорируется. Вы будете вынуждены установить ваш браузер, переписать URL приблизительно так: example '/my_script.php3/internet_movie'. 'my_script.php3' обработает $PATH_INFO и выдаст документ. Если rootID не равен 0, ссылка конструируется из всех имен, начиная с объекта с ИД rootID, разделенных слешами от текущего объекта. Если для предидущего примера документ 'internet_movie' расположен в 'a-b-c-internet_movie', где '-' - разделители между уровнями иерархии, и исходный документ расположен по пути 'a-b-d-source', результирующая HTML-ссылка будет: <A HREF="../c/internet_movie">. Это используется, если вы хотите утянуть се содержание сервера на диск и мапить иерархию докмента на файловую систему. Эта функция работает только с чисто текстовыми документами. Она не отрывает специальных соединений для данных, поэтому управляющее соединение во время передачи данных блокируется. Смотри также hw_PipeDocument(), hw_FreeDocument(), hw_DocumentBodyTag(), hw_DocumentSize(), hw_OutputDocument().




Описание

array hw_getobjectbyquery( int connection, string query, int max_hits); Ищет объекты по всему серверу и возвращает массив идентификаторов объектов. Максимальное число найденных димитируется в max_hits. Если max_hits установлен в -1, то максимальное число ответов не ограниченно. Смотри также hw_GetObjectByQueryObj().




Описание

array hw_getobjectbyqueryobj( int connection, string query, int max_hits); Ищет объекты по всему серверу и возвращает массив объектных записей. Максимальное число найденных димитируется в max_hits. Если max_hits установлен в -1, то максимальное число ответов не ограниченно. Смотри также hw_GetObjectByQuery().




Описание

array hw_getobjectbyquerycoll( int connection, int objectID, string query, int max_hits); Ищет объект в коллекции с идентификатором objectID и возвращает массив идентификаторов объектов. Максимальное число найденных димитируется в max_hits. Если max_hits установлен в -1, то максимальное число ответов не ограниченно. Смотри также hw_GetObjectByQueryCollObj().




Описание

array hw_getobjectbyquerycollobj( int connection, int objectID, string query, int max_hits); Ищет объект в коллекции с идентификатором objectID и возвращает массив объектных записей. Максимальное число найденных димитируется в max_hits. Если max_hits установлен в -1, то максимальное число ответов не ограниченно. Смотри также hw_GetObjectByQueryColl().




Описание

array hw_getchilddoccoll(int connection, int objectID); Возвращает массив идентификатров объектов наследуемых документов коллекции. Смотри также hw_GetChildren(), hw_GetChildColl() .




Описание

array hw_getchilddoccollobj(int connection, int objectID); Возвращает массив идентификатров объектов наследуемых документов коллекции. Смотри также hw_ChildrenObj(), hw_GetChildCollObj().




Описание

array hw_getanchors(int connection, int objectID); Возвращает массив идентификаторов объектов для якорей документа с ИД objectID.




Описание

array hw_getanchorsobj(int connection, int objectID); Возвращает массив объектных записей для якорей документа с ИД objectID.




Описание

int hw_mv( int connection, array object id array, int source id, int destination id); Перемещает объект с объектным идентификатром, указанным во втором параметре, из коллекции с идентификатором source id в коллекцию с идентификатором destination id. Если исходный ИД равен 0, объекты будут "отвязаны" от исходной коллекции. Если это последний экземпляр этого объекта, он будет удален. Возвращется число перемещенных объектов. Смотри также hw_cp(), hw_deleteobject().




Описание

int hw_identify(string username, string password); Идентификация пользователя с именем username и паролем password. Идентификация имеет силу только для текущей сессии. Я не думаю, что данная функция так уж часто используется. В большинстве случаев будет проще проводить идентификацию при установлении соединения. Смотри также hw_Connect().




Описание

array hw_incollections( int connection, array object_id_array, array collection_id array, int return_collections); Проверяет, является ли множество объектов (документов или коллекций), определенное в object_id_array, частью коллекций, определенных в коллекции id_array. Если четвертый параметр return_collections равен 0, подмножество идентификаторов объектов, которое является частью коллекций (т.е. документы или коллекции, которые являются наследниками одной или более коллекций идентификаторов коллекции или их подколлекций, рекурсивно) возвращается как массив. Когда четвертый праметр равен 1, однако, множество соллекций, которые имеют наследников в этом подмножестве, возвращается как массив. Это позволяет пользователю, например, подчеркнуть часть иерархии коллекции, которая содержит находки предидущего запроса, в графическом виде.




Описание

string hw_info(int connection); Возвращает сведения о текущем соединении. Возвращаемая строка имеет следующий формат: <Serverstring>, <Host>, <Port>, <Username>, <Port of Client>, <Byte swapping>




Описание

int hw_inscoll( int connection, int objectID, array object_array); Вставить новую коллекцию с атрибутами как в object_array в коллекцию с идентификатором objectID.




Описание

int hw_insdoc( int connection, int parentID, string object_record, string text); Вставить новый документ с атрибутами как в object_array в коллекцию с идентификатором objectID. Эта функци может добавить как отдельную объектную запись, так и чистый ascii текст из text, если text получен. Если вы хотите добавить документ в общем, используйте hw_insertdocument(). Смотри также hw_InsertDocument(), hw_InsColl().




Описание

int hw_putdocument( int connection, int parent_id, int hw_document); Загружает документ в коллекцию parent_id. Перед этим документ должен быть создан hw_NewDocument(). Удостоверьтесь, что объектная запись нового документа содержит следующие атрибуты: Type, DocumentType, Title и Name. Возможно, вы захотите также установить MimeType. Смотри также hw_PipeDocument().




Описание

int hw_new_document( string document_data, string object_record, int document_size); Возвращает новый hw-документ с данными, установленными по document_data и объектной записью object_record. Длина данных документа document_data передается в document_size. Эта функция не добавляет документ в Hyperwave сервер. Смотри также hw_FreeDocument(), hw_DocumentSize(), hw_DocumentBodyTag(), hw_OutputDocument(), hw_InsertDocument().




Описание

array hw_objrec2array(string object_record); Преобразует object_record в объектный массив.




Описание

int hw_outputdocument(int hw_document); Печатает документ без тега BODY.




Описание

int hw_pconnect( string host, int port, string username, string password); Возвращает индекс соединения в случае удачи, или false, если соединение не может быть установлено. Открывает устойчивое соединение с Hyperwave сервером. Каждый аргумент должен быть "заавыченной" строкой, исключая номер порта. Аргументы username и password опциональны и могут быть опущены. В случае ошибки идентификации, сервер будет остановлен. Проще применять вход пользователя anonymous. В ыможете открыть множество устойчивых соединений. Смотри также hw_Connect().




Описание

int hw_pipedocument(int connection, int objectID); Возвращает hw-документ с идентификатором objectID. Если документ имеет якоря, которые можно вставить, то данная операция произойдет автоматически. Документ передается через специальное соединение для данных, поэтому управляющее соединение не блокируется. Смотри также hw_GetText() for more on link insertion, hw_FreeDocument(), hw_DocumentSize(), hw_DocumentBodyTag(), hw_OutputDocument().




Описание

int hw_root(); Возвращает объектный идентификатор для гиперкоренной коллекции. Обычно это 0. Наследная коллекция от гиперкорневой - корневая, на сервере, с которым установлено соединение.


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