SplFileObject::flock()函式—用法及示例

SplFileObject::flock()函式是用來對檔案進行加鎖操作的。它可以確保在同一時間內只有一個程序或執行緒可以訪問檔案，避免資料競爭和衝突。

該函式的用法如下：

public bool SplFileObject::flock ( int $operation [, int &$wouldblock ] )

引數說明：

• $operation：表示加鎖操作的型別，可以是以下常量：
  • LOCK_SH：共享鎖（讀鎖）。
  • LOCK_EX：獨佔鎖（寫鎖）。
  • LOCK_UN：釋放鎖。
• $wouldblock（可選）：傳入一個變數，用於儲存一個布林值，表示在非阻塞模式下是否會被阻塞。如果傳入了該引數，則函式會返回一個布林值，表示加鎖是否成功。

返回值：

• 如果加鎖成功，則返回 true。
• 如果加鎖失敗，則返回 false。

示例：

$file = new SplFileObject('path/to/file.txt', 'r+');

// 對檔案加上共享鎖
if ($file->flock(LOCK_SH)) {
    // 在加鎖期間進行讀取操作
    echo $file->fgets();
    
    // 釋放鎖
    $file->flock(LOCK_UN);
} else {
    echo "無法獲取共享鎖";
}

// 對檔案加上獨佔鎖
if ($file->flock(LOCK_EX)) {
    // 在加鎖期間進行寫入操作
    $file->fwrite("Hello, World!");
    
    // 釋放鎖
    $file->flock(LOCK_UN);
} else {
    echo "無法獲取獨佔鎖";
}

在上述示例中，我們首先建立了一個SplFileObject物件，然後使用flock()函式對檔案進行加鎖操作。在讀取檔案時，我們使用了共享鎖（LOCK_SH），而在寫入檔案時，我們使用了獨佔鎖（LOCK_EX）。最後，我們透過呼叫flock()函式並傳入LOCK_UN來釋放鎖。

請注意，加鎖操作在多程序或多執行緒環境下才會發揮作用，如果只有單個程序在訪問檔案，加鎖操作可能沒有效果。