fwrite

(PHP 4, PHP 5, PHP 7, PHP 8)

fwrite — Бінарно-безпечний запис до файлу

Опис

fwrite(resource $stream, string $data, ?int $length = null): int|false

fwrite() записує вміст data у файловий потік stream

Список параметрів

stream

Вказівник (resource) на файл, який зазвичай створюється за допомогою функції fopen()

data

Рядок, що записується.

length

Якщо параметр length є цілим числом (int), запис зупиниться після того, як length байтів будуть записані або буде досягнуто кінець рядка data, дивлячись, що станеться раніше.

Значення, що повертаються

fwrite() повертає кількість записаних байт або **false**в случае возникновения ошибки.

Помилки

Функцияfwrite() видає помилку рівня **E_WARNING**в случае возникновения ошибки.

список змін

Версия	Опис
8.0.0	Параметр`length` тепер припускає значення `null`

Приклади

Приклад #1 Простий приклад використання fwrite()

Loading...

Примітки

Зауваження :

Запис у мережевий потік може припинитися до запису всіх даних. Це можна контролювати за допомогою перевірки значення функції, що повертається. fwrite() :
Loading...

Зауваження :

У системах, що розрізняють двійкові та текстові файли (наприклад, Windows), файл повинен бути відкритий, використовуючи прапор 'b' в кінці аргументу mode функції fopen()

Зауваження :

Якщо дескриптор stream був відкритий функцією fopen() в режимі "додавання в кінець", то дзвінки fwrite() будуть атомарними (за винятком випадку, якщо розмір data перевищить розмір блоку файлової системи на деяких платформах, і поки файл зберігається на локальній файловій системі). Тобто немає необхідності блокувати ресурс за допомогою flock() перед викликом fwrite(), і всі дані будуть записані без переривань.

Зауваження :

При повторному записі файлового покажчика, дані будуть додані в кінець вмісту файлу:
Loading...

Дивіться також

fread() - Бінарно-безпечне читання файлу
fopen() - Відкриває файл або URL
fsockopen() - Відкриває з'єднання з інтернет-сокетом або доменним сокетом Unix
popen() - Відкриває файловий покажчик процесу
file_get_contents() - Читає вміст файлу в рядок
pack() - Упакувати дані у бінарний рядок