如何使用stream_supports_lock 確保文件複製過程中不發生並發衝突

M66 2025-06-27

在進行文件操作時，尤其是複制大文件或在多線程環境下複製文件時，可能會遇到並發衝突的問題。一個常見的並發問題是文件在復製過程中被其他進程訪問或修改，這不僅可能導致文件損壞，還可能產生不可預期的錯誤。在PHP 中，可以通過使用stream_supports_lock()函數來避免這一問題。本文將介紹如何使用該函數確保文件複製過程中不發生並發衝突。

什麼是stream_supports_lock()函數？

stream_supports_lock()是PHP 的一個內置函數，用於檢查指定的流是否支持文件鎖。文件鎖是用於控制多個進程或線程對同一文件的訪問的一種機制，避免多個進程同時寫入或讀取文件時發生衝突。 stream_supports_lock()函數可以幫助開發者在進行文件操作之前，確認是否可以使用文件鎖來確保數據的安全性。

函數原型：

 <span><span><span class="hljs-keyword">bool</span></span><span> </span><span><span class="hljs-title function_ invoke__">stream_supports_lock</span></span><span> ( resource </span><span><span class="hljs-variable">$stream</span></span><span> )
</span></span>

參數：該函數接受一個參數$stream ，它是一個有效的文件流資源，通常通過fopen()函數獲得。
返回值：如果流支持文件鎖，函數返回true ，否則返回false 。

如何使用stream_supports_lock()防止並發衝突

步驟1：打開源文件和目標文件

在進行文件複製之前，首先需要打開源文件和目標文件。這可以通過PHP 的fopen()函數來完成，並確保以讀寫模式打開文件。

 <span><span><span class="hljs-variable">$sourceFile</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-string">"source.txt"</span></span><span>, </span><span><span class="hljs-string">"r"</span></span><span>);
</span><span><span class="hljs-variable">$destFile</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fopen</span></span><span>(</span><span><span class="hljs-string">"destination.txt"</span></span><span>, </span><span><span class="hljs-string">"w"</span></span><span>);
</span></span>

步驟2：檢查流是否支持文件鎖

在進行任何文件操作之前，使用stream_supports_lock()檢查文件流是否支持鎖。如果不支持文件鎖，考慮使用其他方式來避免並發衝突（例如，使用數據庫鎖或應用級的並發控制）。

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">stream_supports_lock</span></span><span>(</span><span><span class="hljs-variable">$sourceFile</span></span><span>) &amp;&amp; </span><span><span class="hljs-title function_ invoke__">stream_supports_lock</span></span><span>(</span><span><span class="hljs-variable">$destFile</span></span><span>)) {
    </span><span><span class="hljs-comment">// 支持鎖，繼續操作</span></span><span>
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"文件流不支持鎖，無法確保並發安全！"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}
</span></span>

步驟3：應用文件鎖

如果文件流支持鎖，接下來我們可以使用flock()函數對源文件和目標文件進行加鎖。 flock()函數允許你在文件操作期間加鎖，從而避免其他進程或線程同時訪問文件。

 <span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">flock</span></span><span>(</span><span><span class="hljs-variable">$sourceFile</span></span><span>, LOCK_SH) &amp;&amp; </span><span><span class="hljs-title function_ invoke__">flock</span></span><span>(</span><span><span class="hljs-variable">$destFile</span></span><span>, LOCK_EX)) {
    </span><span><span class="hljs-keyword">while</span></span><span> (!</span><span><span class="hljs-title function_ invoke__">feof</span></span><span>(</span><span><span class="hljs-variable">$sourceFile</span></span><span>)) {
        </span><span><span class="hljs-variable">$data</span></span><span> = </span><span><span class="hljs-title function_ invoke__">fgets</span></span><span>(</span><span><span class="hljs-variable">$sourceFile</span></span><span>);
        </span><span><span class="hljs-title function_ invoke__">fwrite</span></span><span>(</span><span><span class="hljs-variable">$destFile</span></span><span>, </span><span><span class="hljs-variable">$data</span></span><span>);
    }
    </span><span><span class="hljs-comment">// 釋放鎖</span></span><span>
    </span><span><span class="hljs-title function_ invoke__">flock</span></span><span>(</span><span><span class="hljs-variable">$sourceFile</span></span><span>, LOCK_UN);
    </span><span><span class="hljs-title function_ invoke__">flock</span></span><span>(</span><span><span class="hljs-variable">$destFile</span></span><span>, LOCK_UN);
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"無法獲取文件鎖，操作失敗！"</span></span><span>;
    </span><span><span class="hljs-keyword">exit</span></span><span>;
}
</span></span>

LOCK_SH ：共享鎖，允許其他進程以只讀模式訪問文件。
LOCK_EX ：獨占鎖，禁止其他進程訪問文件。
LOCK_UN ：解除鎖定。

步驟4：關閉文件流

完成文件複製後，記得關閉文件流，以釋放系統資源。

 <span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$sourceFile</span></span><span>);
</span><span><span class="hljs-title function_ invoke__">fclose</span></span><span>(</span><span><span class="hljs-variable">$destFile</span></span><span>);
</span></span>

總結

通過使用stream_supports_lock()和flock()函數，PHP 提供了有效的文件鎖機制，可以確保在文件複製過程中不會發生並發衝突。通過合理的文件鎖控制，可以保證數據的完整性，避免文件損壞或複制錯誤。對於多進程或多線程的文件操作，使用文件鎖是確保並發安全的一個重要手段。