本文旨在解决服务器端并发数据写入共享文件时可能发生的数据丢失问题。通过深入分析竞态条件（race condition）的成因，并提出基于php文件锁定（`flock`）机制的解决方案，确保在多请求环境下，数据能够安全、完整地追加到服务器文件。文章详细阐述了文件锁的实现步骤、关键函数及其作用，并提供了完整的代码示例和注意事项，帮助开发者构建鲁棒的数据存储逻辑。
在现代Web应用中，客户端（如通过JavaScript）向服务器发送数据是常见的操作。服务器接收到数据后，通常需要将其存储起来，例如写入到文件或数据库中。然而，当多个客户端几乎同时向服务器发送数据，并且这些数据都尝试写入同一个共享文件时，如果不采取适当的并发控制措施，就可能导致数据丢失或文件内容损坏，这种现象被称为“竞态条件”（Race Condition）。
考虑一个典型的场景：客户端通过AJAX请求将数据发送到服务器，服务器端PHP脚本接收数据并将其追加到一个JSON文件中。
原始的、存在问题的PHP代码示例：
if (isset($_POST['data'])) {
if (file_exists('data.json')) {
// 1. 读取文件内容
$file = file_get_contents('data.json');
$accumulatedData = json_decode($file);
// 2. 解码并追加新数据
$data = json_decode($_POST['data']);
array_push($accumulatedData, $data);
// 3. 编码并写入文件
$encodedAccumulatedData = json_encode($accumulatedData);
file_put_contents('data.json', $encodedAccumulatedData);
}
}这段代码在低并发环境下可能工作正常，但当请求间隔非常短时，问题就会显现。假设两个请求A和B几乎同时到达：
结果是，请求A或请求B中至少一个的数据会被覆盖，导致数据丢失。这是因为“读取-修改-写入”这一系列操作不是原子性的，即它们不是一个不可分割的单一操作。
为了解决这种竞态条件，我们需要确保在任何给定时刻，只有一个进程能够对 data.json 文件执行“读取-修改-写入”操作。这可以通过文件锁定（File Locking）机制来实现。文件锁定允许一个进程独占性地访问文件，直到它完成操作并释放锁，从而保证操作的原子性。
PHP提供了 flock() 函数来实现文件锁定。
以下是使用 flock() 函数改进后的PHP代码，它通过获取文件的独占锁来防止并发写入问题：
<?php
if (isset($_POST['data'])) {
$filePath = 'data.json';
// 确保文件存在，如果不存在则创建空JSON数组
if (!file_exists($filePath)) {
file_put_contents($filePath, json_encode([]));
}
// 1. 以读写模式打开文件句柄
// "r+" 模式表示以读写方式打开文件，文件指针位于文件开头。
// 如果文件不存在，fopen() 会失败。我们已经在前面确保了文件存在。
$fp = fopen($filePath, "r+");
if ($fp) {
// 2. 获取独占锁 (LOCK_EX)
// LOCK_EX 表示获取一个独占锁。如果文件已被其他进程锁定，
// flock() 会阻塞当前进程，直到获取到锁为止。
if (flock($fp, LOCK_EX)) {
// 3. 成功获取锁后，执行关键的“读取-修改-写入”操作
// 此时可以安全地读取文件内容，因为没有其他进程能修改它。
$fileContent = file_get_contents($filePath); // 使用file_get_contents更方便读取
$accumulatedData = json_decode($fileContent, true) ?: []; // 解码，如果为空或无效则初始化为空数组
$newData = json_decode($_POST['data'], true); // 解码POST数据
if ($newData !== null) { // 确保解码成功
array_push($accumulatedData, $newData); // 追加新数据
}
$encodedAccumulatedData = json_encode($accumulatedData, JSON_PRETTY_PRINT); // 重新编码为JSON
// 4. 清空文件内容并写入新数据
// ftruncate(fp, 0) 将文件截断到0字节，清空原有内容。
ftruncate($fp, 0);
// 将文件指针重置到文件开头，确保从头开始写入。
rewind($fp);
// 将更新后的JSON字符串写入文件。
fwrite($fp, $encodedAccumulatedData);
// 5. 释放锁 (LOCK_UN)
flock($fp, LOCK_UN);
echo "Data successfully saved.";
} else {
// 理论上，由于LOCK_EX的阻塞特性，这里很少会执行到。
// 但作为备用，可以返回一个错误信息，指示客户端稍后重试。
http_response_code(503); // Service Unavailable
echo "Couldn't acquire file lock. Please try again later.";
}
// 6. 关闭文件句柄
fclose($fp);
} else {
http_response_code(500); // Internal Server Error
echo "Failed to open data file.";
}
} else {
http_response_code(400); // Bad Request
echo "No data received.";
}代码解析：
客户端 JavaScript 代码（保持不变）：
客户端的职责是发送数据，对于服务器端如何处理并发问题，客户端通常不需要感知。
const XHR = new XMLHttpRequest();
function sendData(data) {
XHR.open('POST', 'savedata.php');
XHR.setRequestHeader('Content-type', 'application/x-www-form-urlencoded');
XHR.send('data=' + JSON.stringify(data)); // 注意：原始代码括号不匹配，已修正
}通过在服务器端利用PHP的 flock() 函数实现文件锁定，我们可以有效地防止在并发数据写入共享文件时发生的数据丢失问题。这种机制确保了“读取-修改-写入”操作的原子性，从而保障了数据存储的完整性。虽然文件锁定是解决此问题的有效方法，但在设计高并发系统时，也应考虑其局限性，并根据实际需求评估是否采用数据库、消息队列等更高级的并发控制和数据持久化方案。正确理解和应用这些技术，是构建稳定、可靠Web应用的关键。
以上就是确保服务器数据传输与存储的完整性：并发写入场景下的文件锁定机制的详细内容，更多请关注php中文网其它相关文章！
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移，垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是，许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
148
收藏
