file_put_contents
(PHP 5, PHP 7)
file_put_contents — Write data to a file
Descrierea
file_put_contents
(
string $filename
,
mixed $data
,
int $flags
= 0
,
resource $context
= ?
) :
int
If filename
does not exist, the file is created.
Otherwise, the existing file is overwritten, unless the
FILE_APPEND
flag is set.
Parametri
-
filename
-
Path to the file where to write the data.
-
data
-
The data to write. Can be either a string, an
array or a stream resource.
If data
is a stream resource, the
remaining buffer of that stream will be copied to the specified file.
This is similar with using stream_copy_to_stream().
You can also specify the data
parameter as a single
dimension array. This is equivalent to
file_put_contents($filename, implode('', $array))
.
-
flags
-
The value of flags
can be any combination of
the following flags, joined with the binary OR (|
)
operator.
Available flags
Flag |
Description |
FILE_USE_INCLUDE_PATH
|
Search for filename in the include directory.
See include_path for more
information.
|
FILE_APPEND
|
If file filename already exists, append
the data to the file instead of overwriting it.
|
LOCK_EX
|
Acquire an exclusive lock on the file while proceeding to the
writing. In other words, a flock() call happens
between the fopen() call and the
fwrite() call. This is not identical to an
fopen() call with mode "x".
|
-
context
-
A valid context resource created with
stream_context_create().
Valorile întoarse
This function returns the number of bytes that were written to the file, or
false
on failure.
Avertizare
Această funcție poate întoarce valoarea Boolean false
, dar poate de
asemenea întoarce o valoare non-Boolean care evaluează în false
. Vă rugăm să
citiți secțiunea despre tipul Boolean
pentru informații suplimentare. Utilizați
operatorul === pentru a
verifica valoarea întoarsă de această funcție.
Exemple
Example #1 Simple usage example
<?php
$file = 'people.txt';
// Open the file to get existing content
$current = file_get_contents($file);
// Append a new person to the file
$current .= "John Smith\n";
// Write the contents back to the file
file_put_contents($file, $current);
?>
Example #2 Using flags
<?php
$file = 'people.txt';
// The new person to add to the file
$person = "John Smith\n";
// Write the contents to the file,
// using the FILE_APPEND flag to append the content to the end of the file
// and the LOCK_EX flag to prevent anyone else writing to the file at the same time
file_put_contents($file, $person, FILE_APPEND | LOCK_EX);
?>
Note
Notă:
Această funcție acceptă și date binare.
Sfat
Un URL poate fi utilizat în calitate de denumire a fișierului în
această funcție dacă învelișurile
fopen au fost activate. Accesați fopen() pentru mai
multe detalii despre modul de specificare a denumirii fișierului. Accesați
Supported Protocols and Wrappers pentru referințe la informații despre posibilitățile
pe care le oferă diferite învelișuri, note despre utilizarea lor și informații
despre variabile predefinite pe care le oferă.