White cat - Справочник по PHP
В случае ошибки функция возвращает 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("/");
// Тем самым мы определили свободное место в корневой директории "/"
Манипулирование каталогами
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() и closedir().Для класса доступны три метода: чтение, возврат к началу и закрытие (read, rewind и close соответственно).
Пример:
$d = dir("/etc");
echo "Handle: ".$d->handle."<br>n";
echo "Path: ".$d->path."<br>n";
while($entry=$d->read()) { // Последовательно выводить
echo $entry."<br>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: $handlen";
echo "Files:n";
while ($file = readdir($handle)) {
echo "$filen";
}
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.
Синтаксис:
