Sich gegenseitig ausschließende Flags auf file_put_contents?

Question

Auf der file_put_contents() Dokumentation, sagt er folgendes:

FILE_APPEND:

Unvereinbare mit LOCK_EX seit Appends Atom und somit ist es keinen Grund zu sperren.

LOCK_EX:

Unvereinbare mit FILE_APPEND.

Doch ein paar Zeilen unten ich den folgenden Code sehen:

<?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); 
?> 

So sind die FILE_APPEND und LOCK_EX Fahnen gegenseitig aus oder nicht? Wenn ja, warum verwenden sie es im Beispiel? Ist das eine schlechte Dokumentation?

Vielen Dank für Ihre Eingabe!

Answer 1

Das ist nur eine schlechte Dokumentation. Die manual clearly states:

FILE_APPEND: Wenn die Datei Dateiname bereits vorhanden ist, hängen die Daten an die Datei anstatt sie zu überschreiben. Gegenseitig mit LOCK_EX seit angefügt sind atomare und somit gibt es keinen Grund zu sperren.

LOCK_EX: Erwerben Sie eine exklusive Sperre auf die Datei während Sie weitergehen zu Schreiben. Gegenseitig exklusiv mit FILE_APPEND.

Und das Beispiel Sie sprechen von:

<?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); 
?> 

Es sieht aus wie die Person, die das Beispiel codiert die Bedeutung von ‚sich gegenseitig ausschließen‘ falsch verstanden, oder, die ein Geheimnis, nicht dokumentierte bahaviour produziert.

Answer 2

Wie @karim79 said, dies war ein Fehler in der Anleitung: siehe bug #49329, die ich nach dem Sehen dieser Frage/Antwort gemeldet und vor ein paar Minuten korrigiert/geschlossen wurde.

(Es wird einige Zeit dauern, in der Online-Version des Handbuch zum Ausdruck zu kommen, aber ahs in den Quellen korrigiert)