本教程詳細介紹了如何利用php和mysql構建一個動態的年份范圍選擇器，用于過濾數據庫記錄。文章涵蓋了從數據庫中獲取最小和最大年份、生成5年間隔的選項、構建html下拉菜單，到處理用戶選擇并使用SQL的BETWEEN操作符進行數據過濾的全過程。同時強調了使用預處理語句防止sql注入等安全實踐。
1. 引言：動態年份過濾的需求
在管理大量時間序列數據時，用戶通常需要按特定的時間范圍進行篩選。例如，一個包含年份信息的數據庫表，用戶可能希望根據“2016-2020”或“2021-2025”這樣的年份區間來查看數據。手動創建這些選項既耗時又不靈活，因此，構建一個能夠根據數據庫實際數據動態生成年份范圍選項的下拉選擇器變得尤為重要。本文將詳細闡述如何使用php和mysql實現這一功能，并安全地處理用戶輸入進行數據過濾。
2. 構建動態年份范圍選擇器
要動態生成年份范圍選項，我們首先需要確定數據庫中存在的最小和最大年份。這為我們提供了生成所有可能年份區間的邊界。
2.1 獲取數據庫中的最小和最大年份
通過一條簡單的SQL查詢，我們可以從目標表中獲取Year列的最小值和最大值。
SELECT MIN(MPU_Ano) AS min_year, MAX(MPU_Ano) AS max_year FROM view_mpacompanhamentogeral;
在PHP中執行此查詢并獲取結果：
<?php // 假設 $conn 是一個有效的 mysqli 數據庫連接 // $conn = new mysqli("localhost", "username", "password", "database"); // if ($conn->connect_error) { // die("連接失敗: " . $conn->connect_error); // } $minMaxYearSql = "SELECT MIN(MPU_Ano) AS min_year, MAX(MPU_Ano) AS max_year FROM view_mpacompanhamentogeral"; $result = $conn->query($minMaxYearSql); $minYear = null; $maxYear = null; if ($result && $result->num_rows > 0) { $row = $result->fetch_assoc(); $minYear = (int)$row['min_year']; $maxYear = (int)$row['max_year']; } else { // 處理無數據的情況，或者設置默認年份范圍 $minYear = date("Y") - 10; // 例如，當前年份前10年 $maxYear = date("Y"); // 當前年份 } // 釋放結果集 if ($result) { $result->free(); } ?>
2.2 生成年份范圍選項
一旦獲取了最小和最大年份，我們就可以循環生成以5年為間隔的年份范圍。
立即學習“PHP免費學習筆記（深入）”；
<select id="selectFilterByyears" name="year_range"> <option value="">選擇年份范圍</option> <?php if ($minYear !== null && $maxYear !== null) { // 確保起始年份是5的倍數，或者從實際最小年份開始 // 我們可以直接從最小年份開始，然后以5為步長遞增 $currentStartYear = $minYear; while ($currentStartYear <= $maxYear) { $currentEndYear = $currentStartYear + 4; // 5年間隔 (例如 2016-2020) // 如果計算出的結束年份超出了最大年份，則將結束年份設為最大年份 if ($currentEndYear > $maxYear) { $currentEndYear = $maxYear; } $rangeValue = "{$currentStartYear}-{$currentEndYear}"; echo "<option value="{$rangeValue}">{$rangeValue}</option>"; // 移動到下一個5年區間的起始年份 $currentStartYear += 5; // 防止無限循環，如果下一個起始年份已經超過了最大年份且當前區間已覆蓋最大年份 if ($currentStartYear > $maxYear && $currentEndYear == $maxYear) { break; } } } ?> </select>
3. 處理用戶選擇并過濾數據
當用戶從下拉菜單中選擇一個年份范圍并提交表單時，我們需要解析這個范圍并將其應用到SQL查詢中。
3.1 解析年份范圍
用戶選擇的值（例如 “2016-2021″）可以通過$_GET或$_POST獲取。使用explode()函數可以輕松將其拆分為起始年份和結束年份。
<?php $selectedYearRange = $_GET['year_range'] ?? ''; // 假設通過GET方法提交 $startYear = null; $endYear = null; if (!empty($selectedYearRange)) { $years = explode('-', $selectedYearRange); if (count($years) === 2) { $startYear = (int)$years[0]; $endYear = (int)$years[1]; } } ?>
3.2 使用SQL BETWEEN 進行過濾
SQL的BETWEEN操作符非常適合按范圍過濾數據。它包含起始值和結束值。
SELECT SUP_Numero ID, MPU_Ano `Year`, MPU_Programada `Status`, TAC_Nome `Action` FROM view_mpacompanhamentogeral WHERE MPU_Ano BETWEEN ? AND ?;
3.3 安全的數據過濾（預處理語句）
重要提示： 直接將用戶輸入的值拼接到SQL查詢字符串中會導致SQL注入漏洞。務必使用預處理語句（Prepared Statements）來安全地綁定參數。
以下是使用MySQLi預處理語句進行數據過濾的示例：
<?php // ... (之前的數據庫連接 $conn 和年份范圍解析代碼) ... $filteredData = []; if ($startYear !== null && $endYear !== null) { $sql = "SELECT SUP_Numero ID, MPU_Ano `Year`, MPU_Programada `Status`, TAC_Nome `Action` FROM view_mpacompanhamentogeral WHERE MPU_Ano BETWEEN ? AND ?"; // 準備語句 if ($stmt = $conn->prepare($sql)) { // 綁定參數 $stmt->bind_param("ii", $startYear, $endYear); // "ii" 表示兩個整數類型參數 // 執行語句 $stmt->execute(); // 獲取結果 $result = $stmt->get_result(); if ($result->num_rows > 0) { while ($row = $result->fetch_assoc()) { $filteredData[] = $row; } } // 關閉語句 $stmt->close(); } else { echo "SQL 語句準備失敗: " . $conn->error; } } else { // 如果沒有選擇年份范圍，可以顯示所有數據或提示用戶選擇 // 例如： $sql = "SELECT SUP_Numero ID, MPU_Ano `Year`, MPU_Programada `Status`, TAC_Nome `Action` FROM view_mpacompanhamentogeral ORDER BY MPU_Ano DESC LIMIT 100"; // 示例：顯示最新100條 $result = $conn->query($sql); if ($result && $result->num_rows > 0) { while ($row = $result->fetch_assoc()) { $filteredData[] = $row; } } if ($result) { $result->free(); } } // 現在 $filteredData 數組包含了根據選擇的年份范圍過濾后的數據 // 你可以在這里循環遍歷 $filteredData 并將其展示在HTML表格中 // 示例：展示過濾后的數據 if (!empty($filteredData)) { echo "<h3>過濾結果:</h3>"; echo "<table border='1'>"; echo "<tr><th>ID</th><th>年份</th><th>狀態</th><th>操作</th></tr>"; foreach ($filteredData as $record) { echo "<tr>"; echo "<td>" . htmlspecialchars($record['ID']) . "</td>"; echo "<td>" . htmlspecialchars($record['Year']) . "</td>"; echo "<td>" . htmlspecialchars($record['Status']) . "</td>"; echo "<td>" . htmlspecialchars($record['Action']) . "</td>"; echo "</tr>"; } echo "</table>"; } else { echo "<p>沒有找到符合條件的記錄。</p>"; } // 關閉數據庫連接 $conn->close(); ?>
4. 完整示例代碼結構
將上述所有部分整合到一個PHP文件中，通常包括以下結構：
<!DOCTYPE html> <html lang="zh-CN"> <head> <meta charset="UTF-8"> <title>動態年份范圍過濾器</title> <style> body { font-family: Arial, sans-serif; margin: 20px; } select, button { padding: 8px; margin-right: 10px; } table { width: 100%; border-collapse: collapse; margin-top: 20px; } th, td { border: 1px solid #ddd; padding: 8px; text-align: left; } th { background-color: #f2f2f2; } </style> </head> <body> <h1>數據年份過濾器</h1> <?php // 1. 數據庫連接配置 $dbHost = 'localhost'; $dbUser = 'your_username'; // 替換為你的數據庫用戶名 $dbPass = 'your_password'; // 替換為你的數據庫密碼 $dbName = 'your_database'; // 替換為你的數據庫名 $conn = new mysqli($dbHost, $dbUser, $dbPass, $dbName); if ($conn->connect_error) { die("數據庫連接失敗: " . $conn->connect_error); } // 2. 獲取數據庫中的最小和最大年份 $minMaxYearSql = "SELECT MIN(MPU_Ano) AS min_year, MAX(MPU_Ano) AS max_year FROM view_mpacompanhamentogeral"; $resultMinMax = $conn->query($minMaxYearSql); $minYear = null; $maxYear = null; if ($resultMinMax && $resultMinMax->num_rows > 0) { $rowMinMax = $resultMinMax->fetch_assoc(); $minYear = (int)$rowMinMax['min_year']; $maxYear = (int)$rowMinMax['max_year']; } else { // 如果沒有數據，設置一個默認范圍或提示 $minYear = 2000; $maxYear = date("Y"); echo "<p>數據庫中沒有找到年份數據，將使用默認范圍。</p>"; } if ($resultMinMax) { $resultMinMax->free(); } // 3. 構建年份范圍選擇表單 ?> <form action="" method="GET"> <label for="selectFilterByYears">按年份范圍過濾:</label> <select id="selectFilterByYears" name="year_range"> <option value="">所有年份</option> <?php if ($minYear !== null && $maxYear !== null) { $currentStartYear = floor($minYear / 5) * 5; // 從最接近的5年倍數開始，或直接從minYear開始 if ($currentStartYear > $minYear) $currentStartYear -= 5; // 確保包含minYear if ($currentStartYear < $minYear) $currentStartYear = $minYear; // 確保不會低于minYear while ($currentStartYear <= $maxYear) { $currentEndYear = $currentStartYear + 4; if ($currentEndYear > $maxYear) { $currentEndYear = $maxYear; } $rangeValue = "{$currentStartYear}-{$currentEndYear}"; $selected = (isset($_GET['year_range']) && $_GET['year_range'] === $rangeValue) ? 'selected' : ''; echo "<option value="{$rangeValue}" {$selected}>{$currentStartYear}-{$currentEndYear}</option>"; $currentStartYear += 5; } } ?> </select> <button type="submit">應用過濾器</button> </form> <?php // 4. 處理用戶選擇并執行數據過濾 $selectedYearRange = $_GET['year_range'] ?? ''; $startYearFilter = null; $endYearFilter = null; $filteredData = []; if (!empty($selectedYearRange)) { $years = explode('-', $selectedYearRange); if (count($years) === 2) { $startYearFilter = (int)$years[0]; $endYearFilter = (int)$years[1]; } } // 構建SQL查詢 $sql = "SELECT SUP_Numero ID, MPU_Ano `Year`, MPU_Programada `Status`, TAC_Nome `Action` FROM view_mpacompanhamentogeral"; if ($startYearFilter !== null && $endYearFilter !== null) { $sql .= " WHERE MPU_Ano BETWEEN ? AND ?"; } $sql .= " ORDER BY MPU_Ano DESC, ID ASC"; // 增加排序以便查看 // 使用預處理語句 if ($stmt = $conn->prepare($sql)) { if ($startYearFilter !== null && $endYearFilter !== null) { $stmt->bind_param("ii", $startYearFilter, $endYearFilter); } $stmt->execute(); $result = $stmt->get_result(); if ($result->num_rows > 0) { while ($row = $result->fetch_assoc()) { $filteredData[] = $row; } } $stmt->close(); } else { echo "<p>SQL 語句準備失敗: " . $conn->error . "</p>"; } // 5. 展示過濾后的數據 echo "<h2>數據列表</h2>"; if (!empty($filteredData)) { echo "<table>"; echo "<tr><th>ID</th><th>年份</th><th>狀態</th><th>操作</th></tr>"; foreach ($filteredData as $record) { echo "<tr>"; echo "<td>" . htmlspecialchars($record['ID']) . "</td>"; echo "<td>" . htmlspecialchars($record['Year']) . "</td>"; echo "<td>" . htmlspecialchars($record['Status']) . "</td>"; echo "<td>" . htmlspecialchars($record['Action']) . "</td>"; echo "</tr>"; } echo "</table>"; } else { echo "<p>沒有找到符合當前過濾條件的記錄。</p>"; } // 6. 關閉數據庫連接 $conn->close(); ?> </body> </html>
5. 注意事項與最佳實踐
- 數據庫連接： 示例中使用mysqli擴展，你也可以選擇更現代、功能更強大的pdo（PHP Data Objects）來連接和操作數據庫。
- 錯誤處理： 在實際生產環境中，需要更健壯的錯誤處理機制，例如使用try-catch塊捕獲數據庫異常，并向用戶顯示友好的錯誤信息，而不是直接暴露系統錯誤。
- 用戶體驗：
- 性能優化： 對于非常大的數據集，確保MPU_Ano列有索引，這將顯著提高MIN(), MAX(), 和 BETWEEN 查詢的性能。
- 代碼組織： 對于大型應用，將數據庫操作、業務邏輯和視圖層分離，例如使用mvc（Model-View-Controller）架構。
6. 總結
通過上述步驟，我們成功構建了一個動態的年份范圍選擇器，它能夠根據數據庫中的實際數據生成過濾選項，并安全有效地對數據進行篩選。核心在于獲取數據范圍、循環生成選項以及使用預處理語句執行帶BETWEEN條件的SQL查詢。遵循這些實踐不僅能提高應用的靈活性和用戶體驗，還能確保數據的安全性和查詢效率。
? 版權聲明
文章版權歸作者所有，未經允許請勿轉載。
THE END
