file_put_contents

Function • Params and return types changed in PHP 8.0

Write data to a file.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2-8.3
PHP 8.4
PHP 8.5
PHP 8.6

file_put_contents Function synopsis

file_put_contents(
    string $filename,
    mixed $data,
    int $flags = 0,
    $context = null
  ): int|false

Parameters

$filename

Typestring

Path to the file where to write the data.

$data

Typemixed

The data to write. Can be either a string, an array or a stream resource.

$flags

OptionalTypeintDefault value0

The value of $flags can be any combination of the following flags, joined with the binary OR (|) operator.

$flags accepts one or a bitmask of the following constant values:

$context

OptionalDefault valuenull

A valid context resource created with stream_context_create.

Return value

Typeint|false

This function returns the number of bytes that were written to the file, or false on failure.

Changes to the file_put_contents Function

PHP 8.0

  • Return type added: int|false
  • Parameter type added for parameter #1 ($filename): string
  • Parameter type added for parameter #2 ($data): mixed
  • Parameter type added for parameter #3 ($flags): int
  • Parameter default value added for position #3 ($flags): 0
  • Parameter default value added for position #4 ($context): null
  file_put_contents(
-     $filename,
+     string $filename,
-     $data,
+     mixed $data,
-     $flags,
+     int $flags = 0,
-     $context
+     $context = null
-   )
+   ): int|false

file_put_contents Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes