PHP 代码重构：利用循环优化重复逻辑与动态数据访问

本文将指导如何在 PHP 中优化重复代码逻辑，特别是处理如 file_id1 到 file_id24 这类序列化变量时。通过引入 for 循环和动态变量名构造技术，可以显著减少代码冗余。教程还将探讨如何从数据库动态获取循环上限，从而提升代码的灵活性和可维护性，适用于需要批量处理类似结构数据的场景。

理解代码重复与动态变量名需求

在 php 开发中，我们经常会遇到需要执行相似操作，但仅少数变量值不同的情况。原始代码中展示了一个典型的例子：当处理文件下载时，需要根据 $file[‘type’] 发送文件，但存在多个文件 id 字段，例如 $file[‘file_id’] 和 $file[‘file_id2’]，并且可能需要扩展到 $file[‘file_id3’] 乃至 $file[‘file_id24’]。这种通过简单复制粘贴代码来适应不同文件 id 的做法，会导致代码冗余、难以维护且容易出错。

核心需求是：

1. 重复执行一段代码逻辑，其中一个变量（例如 file_id）的后缀数字递增。
2. 重复的次数（例如 24 次）可以是固定的，也可以是从数据库中动态读取的。

解决方案一：使用 for 循环优化固定次数重复

为了避免代码重复，我们可以利用 for 循环结合字符串拼接来动态构造变量名。PHP 允许通过数组键的字符串形式访问关联数组的元素，这使得我们可以在循环中动态生成 file_id1、file_id2 等键名。

以下是优化后的代码片段，它将原始代码中重复发送文件的逻辑封装在一个 for 循环中，以处理从 file_id1 到 file_id24 的情况：

if (preg_match('/^\/start (.*)/', $text, $match) or preg_match('/^\/get_(.*)/', $text, $match)) {
$id = $match[1];
if (isJoin($from_id)) {
$fileData = mysqli_query($db, "SELECT * FROM `file` WHERE `id` = '{$id}'");
$file = mysqli_fetch_assoc($fileData);
if (mysqli_num_rows($fileData)) {
if ($file['password']) {
sendMessage($from_id, "please send pass :", "markdown", $btn_back, $message_id);
mysqli_query($db, "UPDATE `user` SET `step` = 'password', `getFile` = '$id' WHERE `from_id` = '$from_id'");
} else {
$downloads = number_format($file['downloads']);
$downloads++;
$caption = urldecode($file['caption']);
// 循环发送文件，处理 file_id1 到 file_id24
// 假设 file_id 字段从 1 开始计数，并且我们希望处理到 24 个文件
$max_file_index = 24; // 固定循环次数
for ($i = 1; $i <= $max_file_index; $i++) {
$file_id_key = "file_id" . $i; // 动态构造键名，例如 "file_id1", "file_id2"
// 检查对应的文件ID是否存在且不为空
if (isset($file[$file_id_key]) && !empty($file[$file_id_key])) {
Ilyad("send{$file['type']}", [
'chat_id' => $from_id,
$file['type'] => $file[$file_id_key], // 使用动态键名访问文件ID
'caption' => "? count : {$downloads}\n{$caption}\n Thanks",
'parse_mode' => "html",
]);
}
}
mysqli_query($db, "UPDATE `file` SET `downloads` = `downloads`+1 WHERE `id` = '$id'");
mysqli_query($db, "UPDATE `user` SET `step` = 'none', `downloads` = `downloads`+1 WHERE `from_id` = '$from_id'");
}
} else {
sendMessage($from_id, "hi welcome to bot", 'markdown', $btn_home, $message_id);
}
} else {
joinSend($from_id);
mysqli_query($db, "UPDATE `user` SET `getFile` = '$id' WHERE `from_id` = '$from_id'");
}
}

代码解析：

立即学习“PHP免费学习笔记（深入）”；

• for ($i = 1; $i <= $max_file_index; $i++): 这个循环会从 $i = 1 迭代到 $max_file_index（这里是 24）。
• $file_id_key = “file_id” . $i;: 在每次循环中，我们通过字符串拼接动态生成键名，例如在第一次迭代中是 file_id1，第二次是 file_id2，以此类推。
• $file[$file_id_key]: 使用动态生成的键名从 $file 关联数组中获取对应的文件 ID。
• isset($file[$file_id_key]) && !empty($file[$file_id_key]): 这是一个重要的检查，确保只有当对应的 file_idX 字段存在且不为空时才尝试发送文件，避免因数据库中缺少某个字段而导致错误。

解决方案二：动态设置循环上限

在实际应用中，文件数量可能不是固定的 24 个，而是根据具体情况而定。为了使代码更具灵活性，我们可以从数据库中获取循环的上限值。假设在 file 表中有一个字段，例如 num_attachments，存储了当前文件记录所关联的附件数量。

降重鸟

要想效果好，就用降重鸟。AI改写智能降低AIGC率和重复率。

113

查看详情

if (preg_match('/^\/start (.*)/', $text, $match) or preg_match('/^\/get_(.*)/', $text, $match)) {
$id = $match[1];
if (isJoin($from_id)) {
$fileData = mysqli_query($db, "SELECT * FROM `file` WHERE `id` = '{$id}'");
$file = mysqli_fetch_assoc($fileData);
if (mysqli_num_rows($fileData)) {
if ($file['password']) {
sendMessage($from_id, "please send pass :", "markdown", $btn_back, $message_id);
mysqli_query($db, "UPDATE `user` SET `step` = 'password', `getFile` = '$id' WHERE `from_id` = '$from_id'");
} else {
$downloads = number_format($file['downloads']);
$downloads++;
$caption = urldecode($file['caption']);
// 从数据库中获取动态循环上限
// 假设 $file 数组中包含一个名为 'num_attachments' 的字段
$max_file_index = isset($file['num_attachments']) ? (int)$file['num_attachments'] : 1; // 默认至少发送一个文件
// 确保上限至少为1，且不超过某个合理的最大值（例如24或更多，视系统设计而定）
// 避免数据库数据错误导致无限循环或资源耗尽
$max_file_index = max(1, $max_file_index);
// 也可以设置一个硬性上限，防止意外情况
// $max_file_index = min($max_file_index, 50);
for ($i = 1; $i <= $max_file_index; $i++) {
$file_id_key = "file_id" . $i;
if (isset($file[$file_id_key]) && !empty($file[$file_id_key])) {
Ilyad("send{$file['type']}", [
'chat_id' => $from_id,
$file['type'] => $file[$file_id_key],
'caption' => "? count : {$downloads}\n{$caption}\n Thanks",
'parse_mode' => "html",
]);
}
}
mysqli_query($db, "UPDATE `file` SET `downloads` = `downloads`+1 WHERE `id` = '$id'");
mysqli_query($db, "UPDATE `user` SET `step` = 'none', `downloads` = `downloads`+1 WHERE `from_id` = '$from_id'");
}
} else {
sendMessage($from_id, "hi welcome to bot", 'markdown', $btn_home, $message_id);
}
} else {
joinSend($from_id);
mysqli_query($db, "UPDATE `user` SET `getFile` = '$id' WHERE `from_id` = '$from_id'");
}
}

代码解析：

立即学习“PHP免费学习笔记（深入）”；

• $max_file_index = isset($file[‘num_attachments’]) ? (int)$file[‘num_attachments’] : 1;: 在这里，我们尝试从 $file 数组中获取 num_attachments 的值作为循环上限。如果该字段不存在或为空，则默认为 1。
• $max_file_index = max(1, $max_file_index);: 这是一个安全措施，确保循环上限至少为 1，避免因数据库数据异常导致循环不执行。
• 可以根据实际需求，增加一个硬性上限，例如 min($max_file_index, 50)，以防止数据库中的 num_attachments 值过大导致系统性能问题。

注意事项与最佳实践

1. 数据库设计优化：
   将 file_id1, file_id2, …, file_idX 作为单独的字段存储在数据库中并非最佳实践。更好的做法是创建一个独立的关联表，例如 file_attachments，其中包含 file_id (主文件ID), attachment_id (附件ID), attachment_type 等字段。这样可以更灵活地处理任意数量的附件，而无需修改表结构。

   例如：
   file 表: id, caption, type, downloads, password, num_attachmentsfile_attachments 表: id, parent_file_id, attachment_file_id, order_index

   查询时通过 JOIN 操作获取所有附件：
   SELECT fa.attachment_file_id FROM file_attachments fa WHERE fa.parent_file_id = ‘{$id}’ ORDER BY fa.order_index ASC

   然后遍历查询结果即可。

2. SQL 注入防护：
   原始代码中使用了 mysqli_query 并直接拼接了变量，例如 WHERE id = ‘{$id}’。这存在 SQL 注入的风险。在生产环境中，应始终使用参数化查询（如 mysqli_prepare 和 mysqli_stmt_bind_param）来防止此类安全漏洞。

3. 错误处理：

   • mysqli_query 可能会失败。应检查其返回值，并在查询失败时进行适当的错误处理，例如记录日志或向用户显示错误信息。
   • mysqli_fetch_assoc 在没有结果时会返回 null。在访问 $file 数组的元素之前，最好先确认 $file 不为 null。
   • 在循环中访问 $file[$file_id_key] 时，已经添加了 isset() 和 !empty() 检查，这是良好的实践。

4. 性能考虑：
   如果 num_attachments 的值非常大，在一个请求中发送大量文件可能会导致性能问题或超时。考虑分页、异步处理或限制单次请求发送的文件数量。

5. 代码可读性：
   尽管循环减少了重复代码，但如果逻辑变得过于复杂，可以考虑将循环体内的逻辑封装成一个独立的函数，提高代码的可读性和复用性。

总结

通过 for 循环和动态键名构造，我们可以高效地处理 PHP 中重复的代码逻辑，尤其是在处理序列化变量（如 file_id1, file_id2 等）时。结合从数据库动态获取循环上限的方法，能够极大地提升代码的灵活性、可维护性和扩展性。同时，为了构建健壮和安全的应用程序，务必注意数据库设计、SQL 注入防护、错误处理以及性能优化等方面的最佳实践。