flock

(PHP 4, PHP 5, PHP 7, PHP 8)

flockPortables Datei-Sperrverfahren (advisory locking)

Beschreibung

flock(resource $stream, int $operation, int &$would_block = null): bool

flock() erlaubt, ein einfaches Leser-/Schreiber-Modell umzusetzen, was auf nahezu jeder Plattform (inklusive der meisten Unix-Abkömmlinge und sogar Windows) genutzt werden kann.

Die Sperre wird auch von fclose() gelöst oder wenn stream vom Garbage-Collector eingesammelt wird.

PHP unterstützt ein portables Verfahren, um komplette Dateien "beratend" zu sperren (was bedeutet, dass alle zugreifenden Programme das gleiche Sperrverfahren nutzen müssen, oder die Sperre wird nicht wirken). Standardmäßig wird diese Funktion blockieren, bis die angefragte Sperre erlangt wurde; dies kann mit der unten dokumentierten Option LOCK_NB gesteuert werden.

Parameter-Liste

stream

Eine Dateisystemressource (resource), wie sie in der Regel von fopen() zurückgegeben wird.

operation

operation ist einer der folgenden Werte:

  • LOCK_SH, um eine geteilte Sperre (Leser) zu erhalten.
  • LOCK_EX, um eine exklusive Sperre (Schreiber) zu erhalten.
  • LOCK_UN, um eine Sperre zu lösen (geteilt oder exklusiv).

Man kann auch LOCK_NB als Bitmaske zu einer der obigen Operationen hinzufügen, wenn flock() während des Sperrversuchs nicht blockieren soll.

would_block

Das optionale dritte Argument wird auf 1 gesetzt, falls die Sperre blockieren würde (EWOULDBLOCK-Fehlernummer).

Rückgabewerte

Gibt bei Erfolg true zurück. Bei einem Fehler wird false zurückgegeben.

Beispiele

Beispiel #1 flock()-Beispiel

<?php

$fp 
fopen("/tmp/lock.txt""r+");

if (
flock($fpLOCK_EX)) { // exklusive Sperre
    
ftruncate($fp0); // kürze Datei
    
fwrite($fp"Schreibe hier irgendwas\n");
    
fflush($fp); // leere Ausgabepuffer, bevor die Sperre aufgehoben wird
    
flock($fpLOCK_UN); // hebe Sperre auf
} else {
    echo 
"Konnte Sperre nicht erhalten!";
}

fclose($fp);

?>

Beispiel #2 flock() mit der Option LOCK_NB

<?php
$fp 
fopen('/tmp/lock.txt''r+');

/* Aktiviere die LOCK_NB-Option bei einer LOCK_EX-Operation */
if(!flock($fpLOCK_EX LOCK_NB)) {
    echo 
'Kann Sperre nicht erhalten';
    exit(-
1);
}

/* ... */

fclose($fp);
?>

Anmerkungen

Hinweis:

flock() nutzt unter Windows "verbindliche" (mandatory) anstatt "beratende" (advisory) Sperren. "Verbindliches" Sperren wird auch unter Linux und System-V-basierten Betriebssystemen durch den üblichen Mechanismus, der von dem fcntl()-Systemaufruf geliefert wird, unterstützt: das heißt, falls bei der fraglichen Datei das setgid-Zugriffs-Bit gesetzt ist und das Ausführungs-Bit für Gruppen null ist. Unter Linux muss das Dateisystem zusätzlich mit der Mount-Option mand eingebunden sein, damit dies Auswirkungen hat.

Hinweis:

Da flock() einen Dateizeiger benötigt, muss unter Umständen eine spezielle Sperrdatei benutzt werden, um den Zugriff auf eine Datei zu schützen, welche Sie mittels Öffnen im Schreibmodus (mit dem Argument "w" or "w+" von fopen()) kürzen wollen.

Hinweis:

Kann nur mit Dateizeigern verwendet werden, die von fopen() für lokale Dateien zurückgegeben wurden, oder mit Dateizeigern, die auf Userspace-Streams zeigen, die die streamWrapper::stream_lock()-Methode implementieren.

Warnung

Weist man dem stream-Argument einen anderen Wert zu, wird nachfolgender Code die Sperre lösen.

Warnung

Bei einigen Betriebssystemen ist flock() auf dem Prozesslevel implementiert. Wenn Sie eine Multithreaded-Server-API benutzen, können Sie sich nicht auf flock() verlassen, um Dateien vor anderen PHP-Skripten zu schützen, welche in parallelen Threads der gleichen Server-Instanz laufen!

flock() wird von antiquierten Dateisystemen wie FAT und dessen Derivaten nicht unterstützt, und gibt deshalb in solchen Umgebungen immer false zurück.

Hinweis:

Wenn der sperrende Prozess unter Windows die Datei ein zweites Mal öffnet, kann er auf die Datei über dieses zweite Handle zugreifen, bis er die Datei entsperrt.

Hier Kannst Du einen Kommentar verfassen


Bitte gib mindestens 10 Zeichen ein.
Wird geladen... Bitte warte.
* Pflichtangabe
Es sind noch keine Kommentare vorhanden.

Was genau bedeutet "Vibe Coding"? Ein tiefgehender Blick für Entwickler

In der Welt der Softwareentwicklung gibt es unzählige Wege, wie man an ein Projekt herangeht. Manche schwören auf strikte Planung, andere auf bewährte Algorithmen und wieder andere lassen sich von etwas ganz anderem leiten: ihrem Gefühl. ...

admin

Autor : admin
Kategorie: Software & Web-Development

PHP cURL-Tutorial: Verwendung von cURL zum Durchführen von HTTP-Anfragen

cURL ist eine leistungsstarke PHP-Erweiterung, die es Ihnen ermöglicht, mit verschiedenen Servern über verschiedene Protokolle wie HTTP, HTTPS, FTP und mehr zu kommunizieren. ...

TheMax

Autor : TheMax
Kategorie: PHP-Tutorials

Midjourney Tutorial - Anleitung für Anfänger

Über Midjourney, dem Tool zur Erstellung digitaler Bilder mithilfe von künstlicher Intelligenz, gibt es ein informatives Video mit dem Titel "Midjourney Tutorial auf Deutsch - Anleitung für Anfänger" ...

Mike94

Autor : Mike94
Kategorie: KI Tutorials

Tutorial veröffentlichen

Tutorial veröffentlichen

Teile Dein Wissen mit anderen Entwicklern weltweit

Du bist Profi in deinem Bereich und möchtest dein Wissen teilen, dann melde dich jetzt an und teile es mit unserer PHP-Community

mehr erfahren

Tutorial veröffentlichen

Grid und Pos geht nicht ...

Export in your desired resolution—without watermarks or ads in CapCut mod download for free (https://capcut.gold/). ​

Geschrieben von capcutapks am 24.07.2025 08:53:32
Forum: PHP Developer Forum
Abfrage über mehrere Spalten und Gruppierung

Um dein Problem zu lösen, kannst du SQL mit GROUP BY, COUNT und SUM verwenden, um die Anzahl der Einträge und Gebühren nach Monat und Prozessna ...

Geschrieben von johnhsmith am 24.07.2025 08:27:34
Forum: SQL / Datenbanken
Suche Hilfe beim Server einrichten.

Guten Abend. Ich bin dabei ein Browser game (https://geometrydashapk.net/) auf einen Server zu installieren damit wir das in einer geschlossen ru ...

Helfen! Doppelte Bestelleinträge in meiner Verkaufstabelle

As a database developer, I've faced similar issues with duplicate entries in e-commerce systems. In one project, our order processing would someti ...

Geschrieben von NataliePasco am 18.07.2025 04:40:00
Forum: SQL / Datenbanken