file_put_contents in PHP

file_put_contents ist eine PHP-Funktion, die eine bestimmte Datenzeichenfolge in eine Datei schreibt. Wenn die betreffende Datei nicht existiert, wird sie erstellt. Wenn die Datei hingegen vorhanden ist, wird ihr Inhalt durch die angegebenen Daten überschrieben. Die Funktion ist einfach zu implementieren und erfordert lediglich das Schreiben des Dateinamens und der Daten als Parameter. Darüber hinaus ist es möglich, Daten in eine Remote-Datei zu schreiben, indem eine URL angegeben oder das Verhalten der Funktion mithilfe von Flags geändert wird. file_put_contents ist ein wertvolles Tool für eine Vielzahl von Zwecken, z. B. zum Speichern von Formulardaten, zum Generieren von Protokolldateien oder zum Debuggen durch die Erstellung schriftlicher Datensätze.

WERBUNG Beliebter Kurs in dieser Kategorie Content-Marketing-Beherrschung: Erfolgsstrategien – Spezialisierung | 4-Gänge-Reihe

Starten Sie Ihren kostenlosen Softwareentwicklungskurs

Webentwicklung, Programmiersprachen, Softwaretests und andere

Syntax und Parameter

Die Syntax und die Parameter der Funktion file_put_contents sind entscheidend für deren korrekte Verwendung und Verhalten. Die Syntax definiert den Aufbau der Funktion und die erforderliche Reihenfolge der Parameter. Die Parameter selbst ermöglichen die Angabe der Zieldatei, der zu schreibenden Daten und Optionen zur Änderung des Verhaltens der Funktion. Ein klares Verständnis der Syntax und der Parameter der Funktion file_put_contents ist wichtig für die genaue und effektive Nutzung der Funktion.

Syntax:

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

Parameter:

Parameter	Beschreibung
$filename (Pflichtfeld)	„$filename“ ist ein Parameter in der Funktion file_put_contents, der den Namen und den Speicherort der Datei angibt, in die Daten geschrieben werden. Der Parameter $filename ist erforderlich und gibt die Zieldatei an, in die die Daten geschrieben werden.
$data (obligatorisch)	$data ist eine Variable, die den Inhalt enthält, der mit der Funktion file_put_contents() in PHP in eine Datei geschrieben wird. Es kann ein String, ein Array oder ein beliebiger anderer PHP-Datentyp sein. Die Daten werden in einen String umgewandelt, bevor sie in die Datei geschrieben werden. Die im Parameter „$data“ übergebenen Daten werden in die in „$filename“ angegebene Datei geschrieben.
$flags (optional)	$flags ist ein optionaler Parameter für file_put_contents() in PHP, der bestimmte Flags setzt, um zu steuern, wie der Dateischreibvorgang ausgeführt wird. Es kann verwendet werden, um das Verhalten der Funktion file_put_contents() beim Schreiben in eine Datei zu ändern. Der Parameter $flags akzeptiert eine oder mehrere vordefinierte Konstanten als Werte, die den Schreibmodus steuern. Zu den häufig verwendeten Konstanten gehören: FILE_USE_INCLUDE_PATH – Mit diesem Flag können Sie nach der Datei im include_path suchen. Wenn die Datei im aktuellen Verzeichnis nicht gefunden wird, wird der enthaltene Pfad durchsucht. FILE_APPEND – Dieses Flag öffnet die Datei im Anhängemodus und schreibt Daten an das Ende der Datei. Wenn die Datei nicht existiert, wird sie erstellt. LOCK_EX – Dieses Flag bewirkt, dass die Datei für exklusiven Schreibzugriff gesperrt wird. Dies bedeutet, dass keine anderen Prozesse in die Datei schreiben können, bis sie entsperrt wird. FILE_TEXT – Dieses Flag setzt den Dateimodus auf Text. Dies wird für Textdateien verwendet und Zeilenenden werden in die Standardeinstellung des Systems konvertiert. FILE_BINARY – Dieses Flag setzt den Dateimodus auf Binär. Dies wird für Binärdateien verwendet und Zeilenenden werden nicht konvertiert. 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

Das obige ist der detaillierte Inhalt vonfile_put_contents in PHP. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!