|
|
|
|
basename
chgrp
chmod
chown
clearstatcache
copy
dirname
fclose
feof
fgetc
fgets
fgetss
file
file_exists
fileatime
filectime
filegroup
fileinode
filemtime
fileowner
fileperms
filesize
filetype
fopen
fpassthru
fputs
fread
fseek
ftell
fwrite
is_dir
is_executable
is_file
is_link
is_readable
is_writeable
link
linkinfo
mkdir
pclose
popen
readfile
readlink
rename
rewind
rmdir
stat
lstat
symlink
tempnam
touch
umask
unlink
basename
Опис
string basename(string path);
Отримавши рядок, що містить шлях до файлу, дана функція поверне базове ім'я файлу.
У Windows обидва слеші - правий (/) та лівий (\) - використовуються як розділювачі під час задання шляху. В інших оточеннях це тільки правий слеш (/).
Наприклад 1. basename() example
$path = "/home/httpd/html/index.php3";
$file = basename($path); // $file встановлюється в "index.php3"
Дивись також: dirname()
chgrp
chgrp - змінити файлову групу
опис
int chgrp(string filename, mixed group);
Намагається змінити групу файлу filename на group. Тільки супервізор може змінити поточну групу на будь-яку випадкову; інші користувачі можуть змінювати групу тільки на будь-яку з тих, для яких вони є користувачами.
Повертає true при успішному завершенні; в в іншому разі - false.
У Windows нічого не трапляється і повертається true.
Дивися також chown() и chmod().
chmod
chmod - змінити режим файлу
Опис
int chmod(string filename, int mode);
Намагається змінити режим файлу, вказаного в filename на mode.
Відзначимо, що mode не присвоюється автоматично вісімкове значення,
вам необхідно префікс mode з нулем (0):
chmod( "/somedir/somefile", 755 ); // десятковий; можливо невірний
chmod( "/somedir/somefile", 0755 ); // вісімковий; коректне значення режиму
Повертає true при успішному завершенні; в іншому випадку - false.
Дивися також chown() и chgrp().
chown
chown - змінює власника файлу
Опис
int chown(string filename, mixed user);
Намагається змінити власника файлу filename на користувача user.
Тільки суперюзер може змінювати власника файлу. Повертає true при успішному завершенні; інакше - false.
Note: У Window нічого не виконується і повертається true.
Дивися також chown() і chmod().
clearstatcache
clearstatcache - очистити кеш статистики файлу
Опис
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().
copy
copy - скопіювати файл
Опис
int copy(string source, string dest);
Створює копію файлу. Повертає true при успішному завершенні; інакше - false.
Приклад 1. copy()
if (!copy($file, $file.'.bak')) {
print("failed to copy $file...
\n");
}
Дивись також: rename()
dirname
dirname - шлях до файлу
Опис
string dirname(string path);
Одержавши рядок, що містить шлях до файлу, дана функція поверне директорію, що містить файл.
У Windows обидва слеші - правий (/) і лівий (\) - використовуються як роздільники при завданні шляху. У інших оточеннях це тільки правий слеш (/).
Приклад 1. dirname()
$path = "/etc/passwd";
$file = dirname($path); // $file is set to "/etc"
Дивися також: basename()
fclose
fclose -- close an open file pointer
Опис
int fclose(int fp);
Вказівник на файл fp закривається. Повертає true при вдалій операції і false при помилці.
Вказівник повинен бути таким, що діє і вказувати на файл, успішно відкритий fopen() або fsockopen().
feof
feof - перевірка на досягнення вказівником кінця файлу
Опис
int feof(int fp);
Повертає true якщо вказівник файлу рівний EOF або у разі помилки; інакше повертається false.
Вказівник повинен бути таким, що діє і вказувати на файл, успішно відкритий fopen(), popen(),
або fsockopen().
fgetc
fgetc - одержати символ з файлу
Опис
string fgetc(int fp);
Повертає рядок, що містить один символ, прочитаний по файловому вказівнику fp.
При EOF повертається false (as does feof()).
Вказівник повинен бути таким, що діє і вказувати на файл, успішно відкритий fopen(), popen(), або fsockopen().
Дивися також fopen(), popen(), fsockopen(), і fgets().
fgets
fgets - одержати рядок по вказівнику на файл
Опис
string fgets(int fp, int length);
Повертає рядок до length - читається по одному байту з файлу, вказаного в fp.
Читання закінчується, якщо прочитано length символів - 1 байт читатиметься у будь-якому випадку,
або до символів перекладу рядка і повернення караєтки, або до EOF.
При помилці повертається false.
Вказівник повинен бути таким, що діє і вказувати на файл, успішно відкритий fopen(), popen(), або fsockopen().
Дивися також fopen(), popen(), fgetc(), і fsockopen().
fgetss
fgetss - одержати рядок по вказівнику файлу і вирізувати HTML теги
Опис
string fgetss(int fp, int length);
Ідентично fgets(), відрізняють fgetss спроби видалити HTML і PHP теги з прочитаного тексту.
Дивися також fgets(), fopen(), fsockopen(), і popen().
file
file - прочитати файл в масив
Опис
array file(string filename);
Ідентична readfile(), але file() видає файл в масив. Кожен елемент масиву відповідає рядку файлу
(разом з символом повернення рядка).
Дивися також readfile(), fopen(), і popen().
file_exists
file_exists - перевіряє існування шуканого файлу.
Опис
int file_exists(string filename);
Повертає true, якщо файл, визначений в filename, існує; інакше - false.
Дивися також clearstatcache().
fileatime
fileatime - час останнього звернення до файлу
Опис
int fileatime(string filename);
Повертає час останнього успішного звернення до файлу, або false у разі помилки.
filectime
filectime - час останньої зміни файлу
Опис
int filectime(string filename);
Повертається час останньої зміни файлу, або false у разі помилки.
filegroup
filegroup - група файлу
Опис
int filegroup(string filename);
Повертає ID групи власника файлу, або false у разі помилки.
fileinode
fileinode - inode файлу
Опис
int fileinode(string filename);
Повертає номер inode файлу, або false у разі помилки.
filemtime
filemtime - час модифікації файлу
Опис
int filemtime(string filename);
Повертається час останнього зміни файлу, або false у разі помилки.
fileowner
fileowner - власник файлу
Опис
int fileowner(string filename);
Повертає ID користувача, власника файлу, або false у разі помилки.
fileperms
fileperms - дозволи для файлу
Опис
int fileperms(string filename);
Повертає дозволи, встановлені для файлу, або false у разі помилки.
filesize
filesize - розмір файлу
Опис
int filesize(string filename);
Повертає розмір файлу, або false у разі помилки.
filetype
filetype - тип файлу
Опис
string filetype(string filename);
Повертає тип файлу. Можливі значення:
fifo, char, dir
block, link, file, і
unknown.
У разі помилки повертається false
fopen
fopen - відкрити файл або URL
Опис
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). Якщо дане значення не має сенсу, воно ігнорується.
Приклад 1. fopen()
$fp = fopen("/home/rasmus/file.txt", "r");
$fp = fopen("http://www.php.net/", "r");
$fp = fopen("ftp://user:[email protected]/",
Якщо ви випробовуєте проблеми з читанням і записом у файл, використовуючи PHP як серверний модуль,
пам'ятайте, що використовувані вами файли і директорії повинні бути доступними для серверних процесів
На платформі Windows будьте обережні, уникаючи лівих слешів в шляхах або використовуйте праві слеші.
$fp = fopen("c:\\data\\info.txt", "r");
Дивися також fclose(), fsockopen(), і popen().
fpassthru
fpassthru - виведення всіх даних з вказівника файлу
Опис
int fpassthru(int fp);
Читає до EOF по одержаному вказівнику файлу і записує результат на стандартний пристрій висновку.
При виникненні помилки fpassthru() повертає false.
Файловий вказівник повинен бути таким, що діє і вказувати на файл, успішно відкритий fopen() popen(),
or fsockopen(). Файл, закритий fpassthru(), не читається, залишаючи fp невикористаним.
Якщо ви хочете зробити дамп файлу на stdout, ви можете використовувати readfile(), яка заощадить вам
один виклик fopen().
Дивися також readfile(), fopen(), popen(), і fsockopen()
fputs
fputs - запис у файл
Опис
int fputs(int fp, string str, int [length]);
fputs() - це псевдонім fwrite(), і обидві функції повністю ідентичні. Помітимо, що параметр length
опційний (необовязковий)і при його відсутності записується весь рядок str.
fread
fread - бінарне читання файлу
Опис
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().
fseek
fseek - пошук у файлі
Опис
int fseek(int fp, int offset);
Для файлу fp встановлює вказівник в потоці файлу на зсув в offset байт. Еквівалентно виклику
в Сі fseek( fp, offset SEEK_SET ).
При вдалому виконанні повертає 0, в іншому випадку повертається -1.
Помітимо, що пошук після EOF не розглядається як помилка.
Не використовується для файлових вказівників, повернених fopen() при використанні форматів "http://"
або "ftp://".
Дивися також ftell() і rewind().
ftell
ftell - поточна позиція вказівника у файлі
Опис
int ftell(int fp);
Повертає позицію вказівника у файлі, на який посилається fp, тобто зсув в потоці файлу.
При виникненні помилки повертається false.
TФайловий вказівник повинен бути таким, що діє і вказувати на файл, успішно відкритий fopen() або popen().
Дивися також fopen(), popen(), fseek() і rewind().
fwrite
fwrite - бінарний запис у файл
Опис
int fwrite(int fp, string string, int [length]);
fwrite() записує вміст string у файловий потік, вказаний fp. Якщо аргумент length присутній, запис
зупиняється після запису length-го байта, або після запису всього рядка string.
Помітимо, що якщо є аргумент length, то конфігураційні опції magic_quotes_runtime ігноруються і
ніякі слеші з string не видаляються.
Дивися також fread(), fopen(), fsockopen(), popen(), і fputs().
is_dir
is_dir - filename - директорія?
Опис
bool is_dir(string filename);
Повертає true, якщо filename існує і це директорія.
Дивися також is_file() і is_link().
is_executable
is_executable - файл відноситься до класу виконуваних
Опис
bool is_executable(string filename);
Повертає true, якщо filename існує і є виконуваним файлом.
Дивися також is_file() і is_link().
is_file
is_file - файл відноситься до класу звичайних файлів
Опис
bool is_file(string filename);
Повертає true, якщо filename існує і є звичайним файлом.
Дивися також is_dir() і is_link().
is_link
is_link - файл відноситься до файлу символічних посилань
Опис
bool is_link(string filename);
Повертає true, якщо filename існує і є символічним посиланням.
Дивися також is_dir() і is_file().
is_readable
is_readable - файл відноситься до класу читаних
Опис
bool is_readable(string filename);
Повертає true, якщо filename існує і є доступним для читання.
Пам'ятайте, що PHP може мати доступ до файлу як користувач, під чиїм id запущений веб-сервер
(часто 'nobody'). Обмеження безпечного режиму не діють усередині аккаунту.
Дивися також is_writeable().
is_writeable
is_writeable - файл відноситься до класу записуваних
Опис
bool is_readable(string filename);
Повертає true якщо файл існує і доступний для запису.
Пам'ятайте, що PHP може мати доступ до файлу яккористувач, під чиїм id запущений веб-сервер
(часто 'nobody'). Обмеження безпечного режиму не діють усередині аккаунту.
Дивися також is_readable().
link
link - створити строге посилання
Опис
int link(string target, string link);
link() створює строге посилання.
Дивися також symlink() створює символічне посилання, і readlink() разом з linkinfo().
linkinfo
linkinfo - інформація про посилання
Опис
int linkinfo(string path);
linkinfo() повертає поле st_dev з UNIX C структури stat, поверненої системним викликом lstat.
Ця функція використовується для верифікації, якщо посилання (вказана в path) реально існує
(використовує ті ж методи, що і макрос S_ISLNK, визначений в stat.h). Повертає 0 або FALSE у разі помилки.
Дивися також symlink(), link(), і readlink().
mkdir
mkdir - створити директорію
Опис
int mkdir(string pathname, int mode);
Намагається створити директорію, вказану в pathname.
Помітимо, що якщо ви захочете вказати mode у восьмирічній системі, то число повинне починатися з 0.
mkdir("/path/to/my/dir", 0700);
Повертає true при успішному виконанні і false при помилці.
Дивися також rmdir().
pclose
pclose - закриває процес файлового вказівника
Опис
int pclose(int fp);
Закриває файловий вказівник до каналу, відкритого popen().
Файловий вказівник повинен бути таким, що діє і повернений успішним викликом popen().
Повертає статус завершення запущеного процесу.
Дивися також popen().
popen
popen - відкрити процес файлового вказівника
Опис
int popen(string command, string mode);
Відкриває канал до процесу, що виконується шляхом форкінгу команди command.
Повертає файловий вказівник, ідентичний повернутому fopen(), але цей вказівник мононаправлений
(може використовуватися тільки для читання або тільки для запису) і повинен бути закритий pclose ().
Цей вказівник можна використовувати з fgets(), fgetss(), і fputs().
При виникненні помилки повертає false.
$fp = popen( "/bin/ls", "r" );
Дивися також pclose().
readfile
readfile - виведення файлу
Опис
int readfile(string filename);
Читає файл і записує його на стандартний пристрій висновку.
Повертає кількість прочитаних байтів. У разі виникнення помилки повертається false і за винятком функції,
викликаної як @readfile, виводиться повідомлення про помилку.
Якщо filename починається з "http://" (без урахування регістра), відкривається з'єднання HTTP 1.0 до
вказаного сервера і текст відповіді виводиться на стандартний пристрій висновку.
Оскільки редиректи HTTP не обробляються, ви повинні включати у вказівку директорії замикаючі слеші.
Якщо filename починається з "ftp://" (без урахування регістру), відкривається ftp з'єднання з вказаним
сервером і файл відповіді виводиться на стандартний пристрій висновку. Якщо сервер не підтримує режим
пасивного ftp, цей виклик завершиться помилкою.
Якщо filename починається якось інакше, буде відкритий файл файлової системи і його вміст виведеться на
стандартний пристрій висновку.
Дивися також fpassthru(), file(), fopen(), include(), require(), і virtual().
readlink
readlink - мета символічного посилання
Опис
string readlink(string path);
readlink() працює аналогічно функції Сі readlink і повертає вміст символічного посилання path або 0 у
разі помилки.
Дивися також symlink(), readlink() і linkinfo().
rename
rename - перейменувати файл
Опис
int rename(string oldname, string newname);
Намагається перейменувати oldname в newname.
Повертає true при успішному виконанні і false при збої.
rewind
rewind - rewind the position of а file pointer
Опис
int rewind(int fp);
Позиціонує файловий вказівник для fp на початок потоку файлу.
При виникненні помилки повертається 0.
Файловий вказівник повинен бути таким, що діє і вказувати на файл, успішно відкритий fopen().
Дивися також fseek() і ftell().
rmdir
rmdir - видалити директорію
Опис
int rmdir(string dirname);
Намагається видалити директорію, вказану шляхом. Директорія повинна бути порожньою, і релевантні дозволи
повинні допустити це. При виникненні помилок повертається 0.
Дивися також mkdir().
stat
stat - інформація про файл
Опис
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
lstat
lstat - інформація про файл або символічне посилання
Опис
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
symlink
symlink - створити символічне посилання
Опис
int symlink(string target, string link);
symlink() створює символічне посилання з існуючою метою target з вказаним ім'ям link.
Дивися також link() створює жорстке посилання, і readlink() разом з linkinfo().
tempnam
tempnam - створити унікальне ім'я файлу
Опис
string tempnam(string dir, string prefix);
Створює унікальне ім'я файлу у вказаній директорії. Якщо директорія не існує, tempnam() може генерувати
ім'я файлу в тимчасовій директорії системи.
Повертає нове тимчасове ім'я файлу, або нульовий рядок при помилці.
Приклад 1. tempnam()
$tmpfname = tempnam( "/tmp", "FOO" );
touch
touch - встановити час модифікації файлу
Опис
int touch(string filename, int time);
Намагається встановити час модифікації файлу filename в значення time. Якщо опція time відсутня,
використовується поточний час.
Якщо файл не існує, то він створюється.
Повертає true при успішному виконанні і false в зворотному випадку.
umask
umask - змінити поточну umask
Опис
int umask(int mask);
umask() встановлює поточну umask PHP в mask & 0777 і повертає стару umask. Коли PHP використовується
серверний модуль, umask зберігається при завершенні кожного запиту.
umask() без аргументів повертає поточну маску.
unlink
unlink - видалити файл
Опис
int unlink(string filename);
Видаляє filename. Аналогічно функції Unix C unlink().
Повертає 0 або FALSE при помилці.
Дивися також rmdir() для видалення директорій.
|
|
Книга Фріланс на західному ринку
|
|
