string basename
(string path);
Получив строку, содержащую путь у файлу, данная функция возвратит базовое имя файла.
В Windows оба слеша - передний (/) и обратный (\) - используются как разделители при задании пути. В других окружениях это только передний слеш (/).
Пример 1. basename() example $path = "/home/httpd/html/index.php3"; $file = basename($path); // $file устанавливается в "index.php3" |
Смотри также: dirname()
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(),
int copy
(string source, string dest);
Создает копию файла. Возвращает true при успешном завершении; в противном случае - false.
Пример 1. copy() if (!copy($file, $file.'.bak')) { print("failed to copy $file...<br>\n"); } |
смотри также: rename()
string dirname
(string path);
Получив строку, содержащую путь у файлу, данная функция возвратит директорию, содержащую файла.
В Windows оба слеша - передний (/) и обратный (\) - используются как разделители при задании пути. В других окружениях это только передний слеш (/).
Пример 1. dirname() $path = "/etc/passwd"; $file = dirname($path); // $file is set to "/etc" |
смотри также: basename()
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 в случае ошибки.
string filetype
(string filename);
Возвращает тип файла. Возможные значения:
fifo, char, dir, block, link, file, и unknown.
В случае ошибки возвращется 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+' - Открыть для чтения и для записи, помещает указатель на конец файла. Если файл не сществует, создается новый файл.
Пример 1. fopen() $fp = fopen("/home/rasmus/file.txt", "r"); $fp = fopen("http://www.php.net/", "r"); $fp = fopen("ftp://user:password@example.com/", "w"); |
Если вы испытываете проблемы с чтением и записью в файл, используя PHP как серверный модуль, помните, что используемые вами файлы и директории должны быть доступными для серверных процессов
На платформе Windows будьте осторожны, избегая обратных слешей в путях или используйте передние слеши.
$fp = fopen("c:\\data\\info.txt", "r");
Смотри также fclose() , fsockopen(), и popen().
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().
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.
Возвращает массив статистической информации о файле со следующими элементами:
устройство
inode
номер ссылки
id пользователя или владельца
id группы владельца
device type if inode device *
размер в байтах
время последнего доступа
время последней модификации
время последнего изменения
размер блока для I/O файловой системы *
количество занатых блоков
array lstat
(string filename);
Собирает информацию и файле иил символической ссылке filename. Эта функция идентична stat(), но если filename - это символическая ссылка, то возвращается статус символической ссылки, а не статус файла, на который указывает данная ссылка.
Возвращает массив статистической информации со следующими элементами:
устройство
inode
число ссылок
id пользователя или владельца
id группы владельца
тип устройства, если inode - устройство *
размер в байтах
время последнего доступа
время последней модификации
время последнего изменения
размер болка для I/O файловой системы *
количество занатых блоков
int symlink
(string target, string link);
symlink() создает символическую ссылку с существующей целью target с указанным именем link.
Смотри также link() создает жесткую ссылку, и readlink() вместе с linkinfo().
string tempnam
(string dir, string prefix);
Создает никальное имя файла в указанной директории. Если директория не существует, tempnam() может сгененрировать имя файла во временной директории системы.
Возвращает новое временное имя файла, или нулевую строку при ошибке.
Пример 1. tempnam() $tmpfname = tempnam( "/tmp", "FOO" ); |
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() для удаления директорий.