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

ecf825b2

int hour, int minute, int



Описание

int mktime ( int hour, int minute, int second, int month, int day, int year); Предупреждение:Обратите внимание на необычный порядок аргументов, который отличается от порядка аргументов в вызове функции mktime() из UNIX, и который нехорошо ведет себя при неправильно заданных параметрах (см.ниже). Это очень часто встречающаяся ошибка в скриптах.Возвращает временную метку Unix согласно данным аргументам. Эта временная метка является целым числом, равным количеству секунд между эпохой Unix (1 Января 1970) и указанным временем. Аргументы могут быть опущены с права налево; каждый опущенный таким образом аргумент будет установлен в текущую величину согласно локальной дате и времени. MkTime is useful for doing date arithmetic and validation, as it MkTime полезена при арифметических дейтсвиях с датой и ее проверкой, она будет автоматически вычислять корректную величину для вешедших за границы параметров. Например, каждая из следующих строк возвращает строку

Описание



int gmmktime ( int hour, int minute, int second, int month, int day, int year); Идентична mktime() за исключением передаваемых параметров, представляющих дату в GMT.



Описание

int time (void); Возвращает текущее время, измеренное в числе секунд с эпохи Unix (1 Января 1970 00:00:00 GMT). См.также date() .



Описание

string microtime (void); Возвращает строку " msec sec" где sec текущее время, измеренное в числе секунд с эпохи Unix (0:00:00 1 Января, 1970 GMT), а msec - это часть в микросекундах. Эти функции доступны только в операционных системах, поддерживающих системный вызов gettimeofday(). См.также time() .  



Описание

int dbase_create(string filename, array fields); Параметр fields - это массив из массивов, каждый массив определяет формат одного поля в базе данных. Каждое поле состоит из имени, символа , указывающего тип поля, длины, и точность. Доступные типы полей:
LЛогическое. Не требует длину или точность.
MМемо. (Помните, что они не поддерживаются в PHP.) Не требует длину или точность.
Dдата (сохраненная как ГГГГММДД). Не требует длину или точность.
NЧисловое. Это поле имеет и длину и точность(количество цифр после десятичной точки).
CСтрока. Имеет длину и не требует точность.
Если создание базы данных успешно, то возвращает dbase_identifier(идентификатор базы данных), в противном случае возвращает false(ложь).


Описание

int dbase_open(string filename, int flags); Параметр flags используется для системного вызова open(). (Обычно 0 только для чтения, 1 только для записи, и 2 для записи и чтения.) Возвращает dbase_identifier(идентификатор базы данных) для открытой базы данных, или false(ложь) если база данных не была открыта.



Описание

bool dbase_close(int dbase_identifier); Закрыть базу данных, связанную с dbase_identifier.



Описание

bool dbase_pack(int dbase_identifier); Упаковывает определенную базу данных (удаляет все записи, помеченные для удаления с помощью dbase_delete_record().



Описание

bool dbase_add_record(int dbase_identifier, array record); Добавляет данные из record в базу данных. Если количество полей в заданном record не идентично количеству полей в базе данных, то операция будет прервана и будет возвращено false(ложь).



Описание

bool dbase_delete_record(int dbase_identifier, int record); Помечает запись record to на удаление из базы данных. Чтобы физически удалить запись из базы данных, вы должны вызвать dbase_pack().



Описание

array dbase_get_record(int dbase_identifier, int record); Возвращает данные из записи record в массив. Массив индексирован начиная с 1, и включает в себя поле 'deleted', которое установлено в 1 если запись помечена на удаление (смотри dbase_delete_record().) Все поля преобразовываются в соответствующий PHP тип. (Даты остаются строками.)



Описание

int dbase_numfields(int dbase_identifier); Возвращает количество полей в определенной базе данных. Номера полей находятся в промежутке с 0 и до dbase_numfields($db)-1, в то время как номера записей начинаются с 1 и до dbase_numrecords($db).



Описание

int dbase_numrecords(int dbase_identifier); Возвращает количество записей в определенной базе данных. Номера записей начинаются с 1 и до dbase_numrecords($db) , в то время как номера полей находятся в промежутке с 0 и до dbase_numfields($db)-1.  



Описание

int dbmopen(string filename, int flags);Первый аргумент - это полный путь к открываемому dbm-файлу, а второй - режим открытия файла, который может быть следующим: "r","n", "w" соответственно только для чтения, создания (включает чтение-запись и может обрезать уже существующую базу данных с тем же именем) и чтения-записи.Возвращает идентификатор, который в дальнейшем передается другим dbm-функциям, или false при неуспехе.Если используется поддержка ndbm, создаются файлы filename.dir и filename.pag. gdbm использует только один файл, и Berkley db создает файл filename.db. Заметьте, что PHP3 самостоятельно делает свою собственную блокировку в дополнение к блокировке самой dbm-библиотки. PHP не удаляет .lck-файлы, созданные этой библиотекой, а рассматривает эти файлы просто как фиксированные i-узлы на которые надо делать блокировку. Более полную информацию о dbm-файлах можно получить на ftp://prep.ai.mit.edu/pub/gnu и man-страницах.



Описание

bool dbmclose(int dbm_identifier);Разблокирует и закрывает указанную базу данных.



Описание

bool dbmexists(int dbm_identifier, string key); Возвращает true если существует значение, ассоциируемое с ключом key.



Описание

string dbmfetch( int dbm_identifier, string key);Возвращает значение ключа key.



Описание

int dbminsert( int dbm_identifier, string key, string value);Добавляет в базу данных значение с указанным ключом key.Возвращает -1 если база данных была открыта в режими только чтение, 0 если добавление произошло успешно и 1 если указанный ключ уже существует. (Для замены значения следует использовать dbmreplace().)



Описание

bool dbmreplace( int dbm_identifier, string key, string value);Замещает значение указанного ключа. Если ключ не существует, функция добавляет его в базу данных.



Описание

bool dbmdelete(int dbm_identifier, string key); Удаляет значение ключа из базы данных. Возвращает false если ключ в базе данных не существует.



Описание

string dbmfirstkey(int dbm_identifier); Возвращает первый ключ базы данных. Заметьте, что упорядочивание не гарантируется, т.к. база данных может быть построена на основе хэш-таблиц, которые не предусматривают упорядочивание.



Описание

string dbmnextkey(int dbm_identifier, string key); Возвращает ключ, следующий после ключа key. С помощью вызова dbmfirstkey(), а затем dbmnextkey() возможно пройти по всем парам ключ/значение в базе данных. Например:



Описание

string dblist(void);  



Описание

int chdir(string directory); Изменяет текущий PHP каталог на directory. Возвращает FALSE если не может изменить, TRUE если смена произошла.



Описание

new dir(string directory); Псевдо- объектно ориентированный механизм для чтения каталога. Открывает каталог из directory. Два реквезита доступно, если только каталог был открыт. Реквезит handle может быть использован вместе с другими функциями работы с каталогом типа readdir(), rewinddir() и closedir(). Реквезит path установлен путь каталога, который был открыт. Три метода доступны: чтение, возврат к началу и закрытие.



Описание

void closedir(int dir_handle); Закрывает поток каталога, обозначенный как dir_handle. Поток предварительно должен быть открыт финкцией opendir().



Описание

int opendir(string path); Возвращает дескриптор(handle) каталога, который в последующем используется в closedir(), readdir(), и rewinddir() обращениях.



Описание

string readdir(int dir_handle); Возвращает имя следующего файла из каталога. Имена не возвращаются в любом специфическом порядке.



Описание

void rewinddir(int dir_handle); Сбрасывает поток каталога, обозначенный как dir_handle в начало данных.  



Описание

int dl(string library); Загружает PHP расширение определенное в library. Смотри также extension_dir директиву конфигурации.  



Описание

string escapeshellcmd(string command); EscapeShellCmd() убирает любые символы в строке, которые могут быть использованы в командном интерпретаторе как произвольные команды. Эту функцию нужно использовать, что бы убедится, что все ваши данные введены правильно, и эту функцию лучше всего вставлять в функции exec() или system(). Стандартное использование этой функции выглядит так: system(EscapeShellCmd($cmd))



Описание

string exec(string command, string [ array ], int [ return_var ]); exec() запускает программу из строки command, весь стандартный вывод отключен. Возвращает последнюю строку результата выполнения программы. Если вы хотите запустить команду и использовать все данные непосредственно без всякого вмешательства других программ, то используйте функцию PassThru(). Если параметр array установлен, то указанный массив будет заполнен выводом из программы. Помните, если массив уже содержит данные, то exec() добавляет свои данные. Если вы не хотите, что бы функция добавляла данные, вызывайте unset() для массива перед использованием exec(). Если параметр return_var установлен наряду с параметром array, то в него записывается результат выполнения команды. Обратите внимание, что если ваша функция будет использовать данные из ввода пользователей, то надо использовать EscapeShellCmd() для того, что бы пользователи не смогли запустить произвольные программы. См. также system(), PassThru(), popen() и EscapeShellCmd().



Описание

string system(string command, int [ return_var ]); System() такая же, как и C версия этой функции для запуска command и вывода результата. Если используется второй параметр, то в него записывается результат выполнения команды. Обратите внимание, что если ваша функция будет использовать данные из ввода пользователей, то надо использовать EscapeShellCmd() для того, что бы пользователи не смогли запустить произвольные программы. Вызов System() также пробует автоматически вставить в буфер вывода web сервера после каждой строки вывода, если PHP запущен как модель сервера. Если вы хотите запустить команду и использовать все данные непосредственно без всякого вмешательства других программ, то используйте функцию PassThru(). См. также exec() и popen() функции.



Описание

string passthru(string command, int [ return_var ]); Функция passthru() похожа на функцию Exec() для запуска command. Если параметр return_var установлен, то результат Unix команды помещается здесь. Эта функция должна использоваться вместо Exec() или System() тогда, когда вывод из Unix команды является двоичными данными, которые должны быть переданы непосредственно обратно в окно просмотра(browser). Это можно использовать, например, для запуска утилиты pbmplus для вывода непосредственно потока изображения. Установка типа image/gif и вызов программы pbmplus, чтобы вывести gif-рисунок, вы можете создавать PHP скрипты, которые выводят изображения непосредственно. См. также exec() и fpassthru().  



Описание

bool filepro(string directory); Читает и верифицирует map-файл, сохраняя файловый счетчик и инфо. Никакой блокировки не предусмотрено, поэтому вам следует избегать модификации вашей filePro базы данных, пока она открыта в PHP.



Описание

string filepro_fieldname(int field_number); Возвращает имя поля по соответствующему номеру field_number.



Описание

string filepro_fieldtype(int field_number); Возвращет тип поля, соответствующего номеру field_number.



Описание

int filepro_fieldwidth(int field_number); Возвращает ширину поля по номеру поля field_number.



Описание

string filepro_retrieve(int row_number, int field_number); Возвращает данные из указанной ячейки базы данных.



Описание

int filepro_fieldcount(void); Возвращает количество полей (колонок) в открытой базе filePro. Смотри также filepro().



Описание

int filepro_rowcount(void); Возвращает количество строк в открытой базе filePro. Смотри также filepro().  



Описание

string basename(string path); Получив строку, содержащую путь у файлу, данная функция возвратит базовое имя файла.В Windows оба слеша - передний (/) и обратный (\) - используются как разделители при задании пути. В других окружениях это только передний слеш (/).



Описание

int chgrp(string filename, mixed group); Пытается изменить группу файла filename на group. Только супервизор может изменить текущую группу на любую случайную; другие пользователи могут менять группу только на любую из тех, для которых они являются пользователями. Возвращает true при успешном завершении; в противном случае - false. В Windows ничего не происходит и возвращается true. смотри также chown() и chmod().



Описание

int chmod(string filename, int mode); Пытается изменить режим файла, указанного в filename на mode. Заметим, что mode не присваивает автоматически восьмиричное значение, вам необходим префикс mode с нулем (0):chmod( "/somedir/somefile", 755 ); // десятичный; возможно неправильныйt chmod( "/somedir/somefile", 0755 ); // восьмиричный; корректное значение режима Возвращает true при успешном завершении; в противном случае - false. смотри также chown() и chgrp().



Описание

int chown(string filename, mixed user); Пытается изменить владельца файла filename на пользователя user. Только суперюзер может изменять владельца файла. Возвращает true при успешном завершении; в противном случае - false. Note: В Window ничего не выполняется и возвращается true. Смотри также chown() и chmod().



Описание

void clearstatcache(void); Вызовы системных функций stat() или lstat() в большинстве систем достаточно "дорогостоящие". Поэтому, результаты последнего вызова любой из статусных функций (см. ниже) сохраняются для последующего использования при вызове этой же функции для этого же файла. Если вы желаете инициировать новый кеш, например, в случае, когда к файлу было много обращений по проверке статуса, или файл был изменен, используйте эту функцию для очистки памяти результатов вызовов.Affected functions include stat(), lstat(), file_exists(), is_writeable(), is_readable(), is_executable(), is_file(), is_dir(), is_link(), filectime(), fileatime(), filemtime(), fileinode(), filegroup(), fileowner(), filesize(), filetype(), и fileperms().



Описание

int copy(string source, string dest); Создает копию файла. Возвращает true при успешном завершении; в противном случае - false.



Описание

string dirname(string path); Получив строку, содержащую путь у файлу, данная функция возвратит директорию, содержащую файла.В Windows оба слеша - передний (/) и обратный (\) - используются как разделители при задании пути. В других окружениях это только передний слеш (/).



Описание

int fclose(int fp); Указатель на файл fp закрывается. Возвращает true при удачной операции и false при ошибке.
Указатель должен быть действующим и указывать на файл, успешно открытый fopen() или fsockopen().



Описание

int feof(int fp); Возвращает true если указатель файла равен EOF или в случае ошибки; в противном случае возвращается false. Указатель должен быть действующим и указывать на файл, успешно открытый fopen(), popen(), или fsockopen().



Описание

string fgetc(int fp); Возвращает строку, содержащую один символ, прочитанный по файловому указателю fp. При EOF возвращается false (as does feof()). Указатель должен быть действующим и указывать на файл, успешно открытый fopen(), popen(), или fsockopen(). Смотри также fopen(), popen(), fsockopen(), и fgets().



Описание

string fgets(int fp, int length); Возвращает строку до length - читается по одному байту из файла, указанного в fp. Чтение заканчивается, если прочитано length символов - 1 байт прочитается в любом случае, или до символов перевода строки и возврата караетки, или до EOF. При ошибке возвращается false. Указатель должен быть действующим и указывать на файл, успешно открытый fopen(), popen(), или fsockopen(). Смотри также fopen(), popen(), fgetc(), и fsockopen().



Описание

string fgetss(int fp, int length); Идентично fgets(), отличают fgetss попытки удалить HTML и PHP тэги из прочитанного текста. Смотри также fgets(), fopen(), fsockopen(), и popen().



Описание

array file(string filename); Идентична readfile(), но file() выдает файл в массив. Каждый элемент массива соответствует строке файла (вместе с символом возврата строки). Смотри также readfile(), fopen(), и popen().



Описание

int file_exists(string filename); Возвращает true, если файл, определенный в filename, существует; иначе - false. Смотри также clearstatcache().



Описание

int fileatime(string filename); Возврвщет время последнего усешного обращения к файлу, или false в случае ошибки.



Описание

int filectime(string filename); Возвращается время последего изменения файла, или false в случае ошибки.



Описание

int filegroup(string filename); Возврашает ID группы владельца файла, или false в случае ошибки.



Описание

int fileinode(string filename); Возвращает номер inode файла, или false в случае ошибки.



Описание

int filemtime(string filename); Возвращается время последего изменения файла, или false в случае ошибки.



Описание

int fileowner(string filename); Возвращает ID пользователя, владельца файла, или false в случае ошибки.



Описание

int fileperms(string filename); Возвращает разрешения, установленные для файла, или false в случае ошибки. .



Описание

int filesize(string filename); Возвращает размер файла, или false в случае ошибки.



Описание

int fopen(string filename, string mode); Если filename начинается с "http://" (без учета регистра), открывается соединение HTTP 1.0 с указанным сервером и возвращается указатель файла, нга начало текста ответа. Поскольку редиректы HTTP не обрабатываются, вы должны включать в указание директории завершающие слеши. Если filename начинается с "ftp://" (без учета регистра), открывается ftp соединение с указанным сервером и возвращается указатель на искомый файл. Если сервер не поддерживает режим пассивного ftp, данная операция завершится ошибкой. Вы можете открывать файлы как для чтения, так и для записи через ftp (но не обе операции одновременно). Если filename начинается как-нибудь иначе, откравается файл вашей файловой системы, и возвращается указатель на открытый файл. Если при открвтии файла происходит ошибка, функция возвращает false.mode выбирается из следующего списка:
  • 'r' - Открыть только для чтения, помещает указатель на начало файла.
  • 'r+' - Открыть для чтения и для записи, помещает указатель на начало файла.
  • 'w' - Открыть только для записи, помещает указатель на начало файла и очищает все содержимое файла. Если файл не сществует, создается новый файл
  • 'w+' - Открыть для чтения и для записи, помещает указатель на начало файла и очищает все содержимое файла. Если файл не сществует, создается новый файл.
  • 'a' - Открыть только для записи, помещает указатель на конец файла. Если файл не сществует, создается новый файл.
  • 'a+' - Открыть для чтения и для записи, помещает указатель на конец файла. Если файл не сществует, создается новый файл.
mode также может содержать символ 'b'. Используется в системах, различающих бинарные и текстовые файлы (не используется в Unix). Если данное значение не имеет смысла, оно игногрируется.



Описание

int fpassthru(int fp); Читает до EOF по полученному указателю файла и записывает результат на стандартное устройство вывода.При возникновении ошибки fpassthru() возвращает false. Файловый указатель должен быть действующим и указывать на файл, успешно открытый fopen() popen(), or fsockopen(). Файл, закрытый fpassthru(), не читается, оставляя fp неиспользованным. Если вы хотиде стедать дамп файла на stdout, вы можете использовать readfile(), которая сэкономит вам один вызов fopen(). Смотри также readfile(), fopen(), popen(), и fsockopen()



Описание

int fputs( int fp, string str, int [length]); fputs() - это псевдоним fwrite(), и обе функции полностью идентичны. Заметим, что параметр length опционален и при его отсутствии записывается вся строка str.



Описание

string fread(int fp, int length); fread() читает байты из файла, на который ссылается fp до length. Чтение заканчивается, когда прочитано length байт или достигнут EOF. // получить содержимое файла в строку $filename = "/usr/local/something.txt"; $fd = fopen( $filename, "r" ); $contents = fread( $fd, filesize( $filename ) ); fclose( $fd ); Смотри также fwrite(), fopen(), fsockopen(), popen(), fgets(), fgetss(), file(), и fpassthru().

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