Справочник по PHP - [41]

diskfreespace

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

Синтаксис:

float diskfreespace (string directory);

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

Пример:

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

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

dir

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

Синтаксис:

new dir(string directory);

Псевдо-объектно ориентированный механизм для получения списка файлов каталога. Открывает каталог из directory.

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

Пример:

$d = dir("/etc");
echo "Handle: ".$d->handle."n";
echo "Path: ".$d->path."n";
while($entry=$d->read()) { // Последовательно выводить
  echo $entry."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);

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

Пример:

  $handle=opendir(".");
  echo "Directory handle: $handlen";
  echo "Files:n";
  while ($file = readdir($handle)) {
    echo "$filen";
  }
  closedir($handle);
?>
Следует отметить, что функция также возвращает значения "." и "..". Если эти значения не требуются, то их можно исключить следующим образом:

$handle=opendir(".");
while($file=readdir($handle)) {
  if($file != "." && $file != "..") {
    echo "Имя файла: $file";
  };
};
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-сервера.