HTML 表單中,若多個 `` 共用相同 `name` 並以 `[]` 結尾,PHP 會自動將其解析為**陣列**存入 `$_GET`、`$_POST` 或 `$_REQUEST`。
<form action="process.php" method="post">
<h3>購書清單</h3>
<div id="books">
<input type="text" name="books[]" placeholder="書名 1" required><br>
<input type="text" name="books[]" placeholder="書名 2"><br>
<input type="text" name="books[]" placeholder="書名 3"><br>
</div>
<button type="button" onclick="addBook()">+ 新增書名</button>
<button type="submit">送出</button>
</form>
<script>
function addBook() {
const div = document.getElementById('books');
const input = document.createElement('input');
input.type = 'text';
input.name = 'books[]';
input.placeholder = '書名 ' + (div.children.length / 2 + 1);
div.appendChild(input);
div.appendChild(document.createElement('br'));
}
</script>
<?php
// process.php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
// 直接取得陣列 (自動過濾空值需自行處理)
$books = $_POST['books'] ?? [];
// 過濾空白、去除首尾空白
$books = array_filter(array_map('trim', $books), fn($v) => $v !== '');
if (empty($books)) {
die('請至少輸入一本書名');
}
// 寫入資料庫範例
$pdo = new PDO('mysql:host=localhost;dbname=library', 'user', 'pass');
$stmt = $pdo->prepare('INSERT INTO books (title, created_at) VALUES (?, NOW())');
foreach ($books as $book) {
$stmt->execute([$book]);
}
echo "成功新增 " . count($books) . " 本書";
echo '<pre>'; print_r($books); echo '</pre>';
}
<!-- 訂單明細:每列有 品名、數量、單價 -->
<form method="post">
<table>
<tr><th>品名</th><th>數量</th><th>單價</th></tr>
<tr>
<td><input name="items[0][name]" required></td>
<td><input name="items[0][qty]" type="number" min="1" value="1"></td>
<td><input name="items[0][price]" type="number" step="0.01"></td>
</tr>
<tr>
<td><input name="items[1][name]"></td>
<td><input name="items[1][qty]" type="number" min="1" value="1"></td>
<td><input name="items[1][price]" type="number" step="0.01"></td>
</tr>
<!-- JS 動態新增時索引遞增 items[2][name]... -->
</table>
<button>送出訂單</button>
</form>
<?php
// 後端接收:自動形成多維陣列
$items = $_POST['items'] ?? [];
/*
$items = [
0 => ['name' => '筆記本', 'qty' => '2', 'price' => '45.00'],
1 => ['name' => '原子筆', 'qty' => '10', 'price' => '12.00'],
];
*/
// 驗證與儲存
$validItems = [];
foreach ($items as $idx => $item) {
$name = trim($item['name'] ?? '');
$qty = (int)($item['qty'] ?? 0);
$price = (float)($item['price'] ?? 0);
if ($name && $qty > 0 && $price > 0) {
$validItems[] = compact('name', 'qty', 'price');
}
}
// 批次插入
if ($validItems) {
$pdo = new PDO(...);
$sql = 'INSERT INTO order_items (name, qty, price) VALUES ' .
implode(',', array_fill(0, count($validItems), '(?,?,?)'));
$stmt = $pdo->prepare($sql);
$flat = [];
foreach ($validItems as $v) $flat = array_merge($flat, [$v['name'], $v['qty'], $v['price']]);
$stmt->execute($flat);
}
| HTML name | PHP 變數結構 | 適用場景 |
|---|---|---|
| `name="field"` | 字串 (最後一個值) | 單一值、單選按鈕 |
| `name="field[]"` | 索引陣列 `[val1, val2, ...]` | 核取方塊、多檔上傳、動態增減欄位 |
| `name="field[key]"` | 關聯陣列 `['key' => val]` | 固定結構多組資料 |
| `name="field[][sub]"` | 多維陣列 `[[sub=>val], [sub=>val]]` | 動態列表、明細表單 |
<!-- 隱藏欄位確保陣列存在 -->
<input type="hidden" name="tags[]" value="">
<input type="checkbox" name="tags[]" value="php"> PHP
<input type="checkbox" name="tags[]" value="js"> JavaScript
<input type="checkbox" name="tags[]" value="go"> Go
// PHP 端
$tags = array_filter($_POST['tags'] ?? []); // 移除空值
<input type="file" name="uploads[]" multiple>
// PHP 端 $_FILES 結構較特殊,需重組
$files = [];
$count = count($_FILES['uploads']['name']);
for ($i = 0; $i < $count; $i++) {
$files[] = [
'name' => $_FILES['uploads']['name'][$i],
'type' => $_FILES['uploads']['type'][$i],
'tmp_name' => $_FILES['uploads']['tmp_name'][$i],
'error' => $_FILES['uploads']['error'][$i],
'size' => $_FILES['uploads']['size'][$i],
];
}
function addItemRow() {
const tbody = document.querySelector('#items tbody');
const index = tbody.rows.length; // 0-based
const row = tbody.insertRow();
row.innerHTML = `
`;
}
善用 `name="field[]"` 語法,讓前端動態表單與後端處理無縫銜接,是 PHP 表單開發的基礎必修課。