Учебник php (стр. 17 из 26)

set_file_buffer
Устанавливает размер буфера.

Синтаксис :
int set_file_buffer(int $f, int $size)

Эта функция устанавливает размер буфера, о котором говорилось выше, для указанного открытого файла $f.
Чаще всего она используется так:

set_file_buffer($f,0);

Приведенный код отключает буферизацию для указанного файла, так что теперь все данные, записываемые в файл, немедленно отправляются на диск или в сеть.

flock
Блокирование файла.

Синтаксис :
bool flock(int $f, int $operation [, int $wouldblock])

Функция устанавливает для указанного открытого дескриптора файла $f режим блокировки, который бы хотел получить текущий процесс. Этот режим задается аргументом $operation и может быть одной из следующих констант:

· LOCK_SH (или 1) - разделяемая блокировка;· LOCK_EX (или 2) - исключительная блокировка;· LOCK_UN (или 3) - снять блокировку;· LOCK_NB (или 4) - эту константу нужно прибавить к одной из предыдущих, если вы не хотите, чтобы программа подвисала наflock() в ожидании своей очереди, а сразу возвращала управление.

В случае, если был затребован режим без ожидания, и блокировка не была успешно установлена, в необязятельный параметр-переменную $wouldblock будет записано значение истина true.
В случае ошибки функция возвращает false, а в случае успешного завершения - true.

Манипулирование каталогами

mkdir
Создание каталога.

Синтаксис :
bool mkdir(string $name, int $perms)

Создает каталог с именем $name и правами доступа perms. Права доступа для каталогов указываются точно так же, как и для файлов. Чаще всего значение $perms устанавливают равным 0770 (предваряющий ноль обязателен - он указывает PHP на то, что это - восьмеричная константа, а не десятичное число).

Пример:

mkdir("my_directory",0755); // создает подкаталог в текущем каталогеmkdir("/data"); // создает подкаталог data в корневом каталоге

В случае успеха функция возвращает true, иначе - false.

rmdir
Удаление каталога.

Синтаксис :
bool rmdir(string $name)

Удаляет каталог с именем $name.
Каталог должен быть пустым, а его атрибуты должны позволять это.
В случае успеха функция возвращает true, иначе - false.

chdir
Смена текущего каталога.

Синтаксис :
int chdir(string $directory);

Изменяет текущий PHP каталог на directory. Возвращает FALSE если не может изменить, TRUE если смена произошла. Параметр $directory может определять и относительный путь, задающийся от текущего каталога.

Примеры:

chdir("/tmp/data"); // переходим по абсолютному путиchdir("./js"); // переходим в подкаталог текущего каталогаchdir(".."); // переходим в родительский каталогchdir("~/data"); // переходим в /home/пользователь/data (для Unix)

getcwd
Полный путь.

Синтаксис :
string getcwd()

Данная функция возвращает текущую директорию, относительно которой проводятся файловые операции, т.е. возвращает полный путь к текущему каталогу, начиная от "корня" (/). Если такой путь не можнет быть отслежен, вызов "проваливается" и возвращается false.

diskfreespace
Определяет свободное пространство в каталоге

Синтаксис :
float diskfreespace (string directory);

Данная функция возвращает в байтах свободное пространство в каталоге directory, то есть в соответствующей ей файловой системе или на разделе диска.

Пример:

$diskspace=diskfreespace("/");// Тем самым мы определили свободное место в корневой директории "/"

Работа с записями

dir
Класс каталога (псевдо-объектно ориентированный механизм).

Синтаксис :
new dir(string directory);

Псевдо-объектно ориентированный механизм для получения списка файлов каталога. Открывает каталог из directory.
После этого становятся доступны два свойства объекта: дескриптор каталога handle и строка path, указывающая, какой каталог в настоящий момент используется. Эти свойства доступны, если только каталог был открыт. Свойство handle может быть использован вместе с другими функциями работы с каталогом типа readdir(), rewinddir() и losedir().
Для класса доступны три метода: чтение, возврат к началу и закрытие (read, rewind и close соответственно).

Пример :

$d = dir("/etc");echo "Handle: ".$d->handle."<br>&bsol;n";echo "Path: ".$d->path."<br>&bsol;n";while($entry=$d->read()) { // Последовательно выводить echo $entry."<br>&bsol;n"; // имя каждого файла,} // имеющегося в каталоге$d->close();

closedir
Закрыть дескриптор(handle) каталога.

Синтаксис :
void closedir(int dir_handle);

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

opendir
Открыть дескриптор каталога.

Синтаксис :
int opendir(string path);

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

readdir
Получение имени следующего файла в списке каталога.

Синтаксис :
string readdir(int dir_handle);

Возвращает имя следующего файла из каталога. Имена файлов возвращаются в виде неупорядоченной последовательности.

Пример:

<?php $handle=opendir(".");echo "Directory handle: $handle&bsol;n"; echo "Files:&bsol;n"; while ($file = readdir($handle)) { echo "$file&bsol;n"; } closedir($handle);?>

Следует отметить, что функция также возвращает значения "." и "..". Если эти значения не требуются, то их можно исключить следующим образом:

<?php$handle=opendir(".");while($file=readdir($handle)) { if($file != "." && $file != "..") { echo "Имяфайла: $file<br>";};};closedir($handle);?>

rewinddir
Реинициализация дескриптора каталога.

Синтаксис :
void rewinddir(int dir_handle);

После вызова этой функции функция readdir() с аргументом dir_handle будет возвращать имена файлов с начала в списке каталога.

Работа с FTP-сервером

ftp_connect
Производит подключение к FTP-серверу.

Синтаксис :
int ftp_connect(string host [, int port])

В функции ftp_connect() аргумент host указывает имя сервера, к которому производится подключение, а необязательный аргумент port указывает какой порт нужно использовать (по умолчанию это 21).
Функция возвращает дескриптор потока FTP или false в случае ошибки.

ftp_pasv
Производит переключение пассиваного режима.

Синтаксис :
int ftp_pasv(int ftp_stream, int pasv)

Функция ftp_pasv() производит переключение режима подключения в пассивный, в случае, если аргумент pasv равен true. Если false - то режим подключения будет активный.
В пассивном режиме передача данных инициируется клиентом, а в активном - сервером (это бывает необходимо при блокировке портов у клиента).
Функция возварщает true или false при ошибке.

ftp_login
Производит вход на сервер FTP.

Синтаксис :
int ftp_login(int ftp_stream, string username, string password)

Функция ftp_login() производит регистрацию в системе под именем username с паролем password. Возвращает true или false при ошибке.

ftp_quit
Производит завершение сеанса FTP.

Синтаксис :
int ftp_quit(int ftp_stream)

ftp_pwd
Производит определение текущего каталога.

Синтаксис :
int ftp_pwd(int ftp_stream)

Эта функция возвращает текущий каталог FTP-сервера или false при ошибке.

ftp_cdup
Производит переход в корневой каталог.

Синтаксис :
int ftp_cdup(int ftp_stream)

Функция возвращает true или false при ошибке.

ftp_chdir
Производит переход в каталог.

Синтаксис :
int ftp_chdir(int ftp_stream, string directory)

Функция возвращает true или false при ошибке.

ftp_mkdir
Производит создание каталога.

Синтаксис :
int ftp_mkdir(int ftp_stream, string directory)

Функция возвращает имя созданного каталога или false при ошибке.

ftp_rmdir
Производит удаление каталога.

Синтаксис :
int ftp_rmdir(int ftp_stream, string directory)

Функция true или false приошибке.

ftp_nlist
Производит получение листинга каталога.

Синтаксис :
int ftp_nlist(int ftp_stream, string directory)

Функция ftp_nlist() возвращает массив файловых имен или false при ошибке.

ftp_rawlist
Получение подробного листинга каталога.

Синтаксис :
int ftp_rawlist(int ftp_stream, string directory)

Функция ftp_rawlist() выполняет FTP-команду LIST, и возвращате его результаты в массиве, где каждый элемент соответствует строке текста "как есть". Идентификатор типа системы, возвращаемый ftp_systype(), может быть использован для определения того, как следует интерпретировать результаты.

ftp_systype
Возвращает системный идентификатор типа FTP-сервера.

Синтаксис :
int ftp_systype(int ftp_stream)

Функция возвращает строковое значение или false в случае ошибки.

Работа файлами

ftp_get
Производит загрузку с FTP-сервера.

Синтаксис :
int ftp_get(int ftp_stream, string local_file, string remote_file, int mode)

Функция ftp_get() загружает файл под названием remote_file с FTP-сервера и локально сохраняет его под именем local_file. Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).
Функция возвращает true или false при ошибке.

ftp_fget
Производит загрузку и запись файла.

Синтаксис :
int ftp_fget(int ftp_stream, string fp, string remote_file, int mode)

Функция ftp_fget() загружает файл под названием remote_file с FTP-сервера и сохраняет его в файле, который имеет дескриптор fp. Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).
Функция возвращает true или false при ошибке.

ftp_put
Производит загрузку файла на FTP-сервер.

Синтаксис :
int ftp_put(int ftp_stream, string remote_file, string local_file, int mode)

Функцияftp_put()загружаетфайлна FTP-серверподименемremote_file. Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).
Функция возвращает true или false при ошибке.

$upload = ftp_put($ftp_id, "C:&bsol;file.txt", "/file.txt", FTP_ASCII);

ftp_fput
Производит чтение и загрузку файла на FTP-сервер.

Синтаксис :
int ftp_fput(int ftp_stream, string remote_file, string fp, int mode)

Функция ftp_fput() читает открытый файл с дескриптором fp до конца и загружает этот файл на FTP-сервер под именем remote_file. Параметр mode устанавливает режим передачи файла и может принимать значения FTP_ASCII(текстовой) или FTP_BINARY(бинарный, двоичный).
Функция возвращает true или false при ошибке.