file_put_contents en PHP

file_put_contents est une fonction PHP qui écrit une chaîne de données spécifiée dans un fichier. Si le fichier concerné n'existe pas, il est créé. A l'inverse, si le fichier existe, son contenu sera écrasé par les données spécifiées. La fonction est facile à mettre en œuvre et nécessite uniquement que le nom du fichier et les données soient écrits en tant que paramètres. De plus, il est possible d'écrire des données dans un fichier distant en spécifiant une URL ou en modifiant le comportement de la fonction à l'aide d'indicateurs. file_put_contents est un outil précieux pour une multitude d'objectifs, tels que le stockage des données de formulaire, la génération de fichiers journaux ou le débogage via la création d'enregistrements écrits.

PUBLICITÉ Cours populaire dans cette catégorie Maîtrise du marketing de contenu : stratégies pour réussir - Spécialisation | Série de 4 cours

Commencez votre cours de développement de logiciels libres

Développement Web, langages de programmation, tests de logiciels et autres

Syntaxe et paramètres

La syntaxe et les paramètres de la fonction file_put_contents sont cruciaux pour son utilisation et son comportement corrects. La syntaxe définit la structure de la fonction et l'ordre requis des paramètres. Les paramètres eux-mêmes permettent de spécifier le fichier cible, les données à écrire et les options permettant de modifier le comportement de la fonction. Une compréhension claire de la syntaxe et des paramètres de la fonction file_put_contents est importante pour une utilisation précise et efficace de la fonction.

Syntaxe :

file_put_contents(filename, data, [flags, context]);

Paramètres :

Paramètre	Description
$filename (obligatoire)	«$filename» est un paramètre de la fonction file_put_contents qui spécifie le nom et l'emplacement du fichier dans lequel les données sont écrites. Le paramètre $filename est obligatoire et spécifie le fichier cible dans lequel les données seront écrites.
$data (obligatoire)	$data est une variable qui contient le contenu qui sera écrit dans un fichier à l'aide de la fonction file_put_contents() en PHP. Il peut s'agir d'une chaîne, d'un tableau ou de tout autre type de données PHP. Les données seront converties en chaîne avant d'être écrites dans le fichier. Les données transmises dans le paramètre « $data » sont écrites dans le fichier spécifié dans « $filename ».
$drapeaux (facultatif)	$flags est un paramètre facultatif pour file_put_contents() en PHP qui définit des indicateurs spécifiques pour contrôler la manière dont l'opération d'écriture de fichier est effectuée. Il peut être utilisé pour modifier le comportement de la fonction file_put_contents() en termes d'écriture dans un fichier. Le paramètre $flags prend une ou plusieurs constantes prédéfinies comme valeurs qui contrôlent le mode d'écriture. Certaines des constantes couramment utilisées incluent : FILE_USE_INCLUDE_PATH – Cet indicateur vous permet de rechercher le fichier dans include_path. Si le fichier n'est pas trouvé dans le répertoire courant, le chemin inclus est recherché. FILE_APPEND – Cet indicateur ouvre le fichier en mode ajout et écrit les données à la fin du fichier. Si le fichier n'existe pas, il est créé. LOCK_EX – Cet indicateur provoque le verrouillage du fichier pour un accès exclusif en écriture. Cela signifie qu'aucun autre processus ne peut écrire dans le fichier tant qu'il n'est pas déverrouillé. FILE_TEXT – Cet indicateur définit le mode fichier sur texte. Ceci est utilisé pour les fichiers texte et les fins de ligne sont converties aux valeurs par défaut du système. FILE_BINARY – Cet indicateur définit le mode fichier sur binaire. Ceci est utilisé pour les fichiers binaires et les fins de ligne ne sont pas converties. The default value of the $flags parameter in the file_put_contents function is 0.
$context (optional)	The context parameter in the file_put_contents function in PHP allows the user to specify a set of options that modify the behavior of the function when it writes data to a file or a remote server. The context is specified as an associative array that defines options for a stream, such as headers to be sent along with a request, timeout values, encryption method, etc. It allows the user to control the way data is sent and received through a stream in PHP.
$mode (optional)	The $mode parameter is an optional parameter and is not typically used in the file_put_contents function. $mode is a parameter in the file_put_contents function in PHP that specifies the access mode when opening the file. The value of $mode determines what kind of access the function has to the file, such as read-only or write-only access. By default, file_put_contents opens the file with write-only access. This means that the function can only write data to the file and cannot read the existing data in the file.

Examples

Here an array of data is converted to a JSON string and written to a remote URL using an HTTP POST request. The stream_context_create function is used to create a stream context resource that specifies the HTTP method, header information, and timeout for the request. The file_put_contents function is then used to send the JSON data to the specified URL using the specified context. The function then returns the number of bytes written to the file, or false if there is any error. The response is checked to determine if the data was sent successfully, and a message is displayed accordingly.

Example #1

Code:

<?php
$data = array("name" => "John Doe", "email" => "[email protected]", "phone" => "555-555-1212");
$json = json_encode($data);
$context = stream_context_create(array(
'http' => array(
'method' => 'POST',
'header' => "Content-Type: application/json\r\n".
"Accept: application/json\r\n".
"User-Agent: My PHP Script",
'content' => $json,
'timeout' => 60
)
));
$response = file_put_contents("https://www.example.com/api/create_user", $json, 0, $context);
if ($response === false) {
echo "Error: Could not send data to remote server.";
} else {
echo "Data successfully sent to remote server. Response: $response";
}
?>

Output:

The output in the above example would be a message indicating the success or failure of the data being sent to the remote server. If the data is sent successfully, the output would be:

If an error occurs, the output would be:

Example #2

Code:

<?php
$file = "https://cdn.educba.com/var/www/html/students.txt";
$data = "1, Alice, 23, History, 3.7\n2, Bob, 25, Mathematics, 3.9\n3, Charlie, 22, English, 3.5\n4, Dave, 24, Computer Science, 4.0\n";
// Writing data to the file
file_put_contents($file, $data);
// Check if the file was written successfully
if (file_exists($file)) {
echo "Data was successfully written to the file.";
} else {
echo "An error occurred while writing data to the file.";
}
?>

Output:

The output for the code would depend on the server’s response to the request. If the request was successful, the output would be:

If the request was unsuccessful, the output would be:

Conclusion

file_put_contents is a useful PHP function for writing data to a file. It has several parameters that allow you to control the behavior of the function, such as the file path, data to be written, and the mode in which the file is opened. With the help of the optional stream context, file_put_contents can even write data to remote servers. This function is a simple and efficient way to write data to a file, making it a popular choice among PHP developers.

Recommended Article

In this article, you learned about file_put_contents in PHP. To know more about the topic, you can refer to these articles.

1. PHP 7 MySQL
2. PHP 7 mysql_connect 
3. PHP Timestamp
4. PHP urlencode

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!