Компонент Файловая система¶

mkdir¶

mkdir() создаёт каталог рекурсивно. В файловых системах POSIX, каталоги создаются со значением режима по умолчанию 0777. Вы можете использовать второй аргумент, чтобы установить ваш собственный режим:

1

$fs->mkdir('/tmp/photos', 0700);

exists¶

exists() проверяет наличие одного или болеефайлоа или каталогов и возвращает false, если какие-либо из них отсутствуют:

1
2
3
4
5

// этот каталог существует, вернуть true
$fs->exists('/tmp/photos');

// rabbit.jpg существует, bottle.png не существует, вернуть false
$fs->exists(array('rabbit.jpg', 'bottle.png'));

copy¶

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

1
2
3
4
5

// работает только, если image-ICC было изменено после image.jpg
$fs->copy('image-ICC.jpg', 'image.jpg');

// image.jpg будет переопределено
$fs->copy('image-ICC.jpg', 'image.jpg', true);

touch¶

touch() устанавливает доступ и время изменения файла. Текущее время используется по умолчанию. Вы можете установить ваше собственное с помощью второго аргумента. Третий аргумент - это время доступа:

1
2
3
4
5
6

// устанавливает время изменения в текущей отметке времени
$fs->touch('file.txt');
// устанавливает время изменения на 10 секунд в будущем
$fs->touch('file.txt', time() + 10);
// устанавливает время изменения на 10 секунд в прошлом
$fs->touch('file.txt', time(), time() - 10);

chown¶

chown() изменяет владельца файла. Третий аргумент - рекурсивная булева опция:

1
2
3
4

// устанавливает владельца видео lolcat как www-data
$fs->chown('lolcat.mp4', 'www-data');
// рекурсивно изменяет владельца каталога видео
$fs->chown('/video', 'www-data', true);

chgrp¶

chgrp() изменяет группу файла. Третий аргумент - рекурсивная булева опция:

1
2
3
4

// устанавливает группу видео lolcat как nginx
$fs->chgrp('lolcat.mp4', 'nginx');
// рекурсивно изменяет группу каталога видео
$fs->chgrp('/video', 'nginx', true);

chmod¶

chmod() изменяет режим или разрешения файла. Четвертый аргумент - рекурсивная булева опция:

1
2
3
4

// устанавливает режим видео 0600
$fs->chmod('video.ogg', 0600);
// рекурсивно изменяет режим каталога src
$fs->chmod('src', 0700, 0000, true);

remove¶

remove() удаляет файлы, каталогы и сивольные ссылки:

1

$fs->remove(array('symlink', '/path/to/directory', 'activity.log'));

rename¶

rename() изменяет имя одного файла или каталога:

1
2
3
4

// переименовывает файл
$fs->rename('/tmp/processed_video.ogg', '/path/to/store/video_647.ogg');
// переименовывает каталог
$fs->rename('/tmp/files', '/path/to/store/files');

symlink¶

symlink() создаёт символьную ссылку от цели к направлению. Если файловая система не поддерживает символьные ссылки, доступен третий булев аргумент:

1
2
3
4
5

// создаёт символьную ссылку
$fs->symlink('/path/to/source', '/path/to/destination');
// дублирует каталог источника, если файловая система
// не поддерживает символьные ссылки
$fs->symlink('/path/to/source', '/path/to/destination', true);

readlink¶

readlink() читает ссылки целей.

Функция PHP readlink() возвращает цель символьной ссылки. Однако, её поведение полностью отличается в Windows и Unix. В системах Windows, readlink() рекурсивно разрешает дочерние ссылки до нахождения финмальной цели. В системах, основанных на Unix, readlink() разрешает только следующую ссылку.

Метод readlink(), предоставленные компонентом Файловая система всегда ведёт себя одинаково:

1
2
3
4
5
6

// возвращает следующую прямую цель ссылки, не рассматривая существование цели
$fs->readlink('/path/to/link');

// возвращает абсолютнуюп полностью разрешённую финальную версию цели
// (если были вложенные ссылки, они разрешены)
$fs->readlink('/path/to/link', true);

Её поведение следующее:

1

public function readlink($path, $canonicalize = false)

• Когда $canonicalize - false:

  • если $path не существует, или не является ссылкой, то возвращается null.
  • если $path - ссылка, возвращается следующая прямая цель ссылки, не рассматривая существование цели.

• Когда $canonicalize - true:

  • если $path не существует, то возвращается null.
  • если $path существует, то возвращается его абсолютная полностью разрешённая финальная версия.

makePathRelative¶

makePathRelative() берёт два абсолютных пути и возвращает относительный путь от второго пути к первому:

1
2
3
4
5
6
7

// возвращает '../'
$fs->makePathRelative(
    '/var/lib/symfony/src/Symfony/',
    '/var/lib/symfony/src/Symfony/Component'
);
// возвращает 'videos/'
$fs->makePathRelative('/tmp/videos', '/tmp')

mirror¶

mirror() копирует всё содержание каталога источника в целевой (используйте метод copy(), чтобы скопировать одиночные файлы):

1

$fs->mirror('/path/to/source', '/path/to/target');

isAbsolutePath¶

isAbsolutePath() возвращает true, если данный путь абсолютный, false - во всех других случаях:

1
2
3
4
5
6
7
8

// возвращает true
$fs->isAbsolutePath('/tmp');
// возвращает true
$fs->isAbsolutePath('c:\\Windows');
// возвращает false
$fs->isAbsolutePath('tmp');
// возвращает false
$fs->isAbsolutePath('../dir');

dumpFile¶

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

1

$fs->dumpFile('file.txt', 'Hello World');

Файл file.txt теперь содержит Hello World.

appendToFile¶

appendToFile() добавляет новое содержание в конце некоторого файла:

1

$fs->appendToFile('logs.txt', 'Email sent to [email protected]');

Если либо файл, либо каталог, содержащий его, не существует, то этот метод создаёт их перед добавлением содержания.