Funkce flock

Funkce flock nastavuje nebo odstraňuje zámek souboru. Jako první parametr přijímá ukazatel na soubor získaný pomocí fopen, jako druhý parametr typ zámku (LOCK_SH, LOCK_EX nebo LOCK_UN) a jako třetí volitelný parametr příznak pro neblokující operaci.

Syntaxe

phpflock(resource $handle, int $operation, int &$would_block = null): bool

Příklad

Zamčení souboru pro exkluzivní přístup (zápis):

php<?php
  $file = fopen("data.txt", "c+");
  if (flock($file, LOCK_EX)) {
    ftruncate($file, 0);
    fwrite($file, "Nový obsah");
    flock($file, LOCK_UN);
  }
  fclose($file);
?>

Příklad

Sdílený zámek pro čtení:

php<?php
  $file = fopen("data.txt", "r");
  if (flock($file, LOCK_SH)) {
    $content = fread($file, filesize("data.txt"));
    flock($file, LOCK_UN);
  }
  fclose($file);
  echo $content;
?>

Příklad

Neblokující pokus o získání zámku:

php<?php
  $file = fopen("data.txt", "c+");
  if (flock($file, LOCK_EX | LOCK_NB, $would_block)) {
    if ($would_block) {
      echo "Soubor je zamčen jiným procesem";
    } else {
      fwrite($file, "Data");
      flock($file, LOCK_UN);
    }
  }
  fclose($file);
?>

Viz také

  • funkci fopen,
    která otevírá soubor
  • funkci fclose,
    která zavírá soubor
  • funkci is_writable,
    která kontroluje možnost zápisu