PHP file_put_contents дописывает в файл или перезаписывает его?

Question

[Миша]

Здравствуйте, хочу вести кастомный лог типа

file_put_contents('debug.txt', date("H:i:s").' '.$text.PHP_EOL, FILE_APPEND);

интересует, как выполняется это команда? Файл будет считан, добавлен текст и после этого перезаписан файл(удалён и снова создан) или в существующий файл будет дописана одна строка без перезаписи?
Волнует, что если файл будет очень большой это создаст не нужные задержки в выполнении кода
Спасибо

Answer 1

[Danny Arty]

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

Comments

[Adamos]

Вообще-то вопрос был о другом - как оно реализовано: весь файл пишется заново с добавкой или как-то к нему подписывается дополнение, а все предыдущие гигабайты никто заново не пишет.
Но на этот вопрос нет ответа, потому что РНР не имеет прямого доступа к файловой системе.

[Миша]

Adamos, понятно

[Danny Arty]

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

[Adamos]

Danny Arty, вообще-то открытие для чтения и открытие для чтения и записи - это разный код.
Но в любом случае конкретной реализацией движения байтов руководит не РНР.

Answer 2

[rPman]

file_put_contents(... FILE_APPEND) дописывает содержимое в конец без пересоздания и перечитывания файла
это просто упрощенная запись конструкции
fopen(...,'a');fwrite(...);fclose(...);
если FILE_APPEND не указывать, то используется режим типа w+ (существующие файлы обрезаются в 0 размер, не существующие ошибки не вызывают)
p.s. важное замечание file_put_contents FILE_APPEND работает очень медленно, синхронизируя каждую запись с диском, я помню переписывал код на использование fopen/fwrite плюс там можно гибко задавать буфер записи

upd. на самом деле там используется просто режим 'a' и 'c' и чуть больше проверок
С интересом обнаружил по исходникам что file_put_contents умеет писать array, объединяя без разделителя значения и пропуская ключи.... век живи век учись, не знаю зачем но смешно

Comments

[Adamos]

Пых сам, конечно, не перечитывает и не перезаписывает файл.
Но как в реальности к нему "допишут в конец" функции операционной системы и реализация файловой системы - пых знать не знает и никак на это повлиять не может.

[rPman]

Adamos, не выдумывайте, система точно так же ничего перезаписывать САМА не будет
исключение - драйвера файловой системы, в которых реализован такой странный и не нужный функционал, но вангую что у автора все же типовой случай

Answer 3

[Adamos]

Кастомный лог имеет смысл делать в файлах с именем, содержащим дату, в папке, на которую можно натравить logrotate. Тогда вас не особенно будут волновать такие нюансы - не накопите же вы гигабайты лога за день.