萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 取得表單同名多欄位值:陣列語法 name="field[]" 完整指南

核心機制

HTML 表單中,若多個 `` 共用相同 `name` 並以 `[]` 結尾,PHP 會自動將其解析為**陣列**存入 `$_GET`、`$_POST` 或 `$_REQUEST`。

前端 HTML 範例

<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 處理

<?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 namePHP 變數結構適用場景
`name="field"`字串 (最後一個值)單一值、單選按鈕
`name="field[]"`索引陣列 `[val1, val2, ...]`核取方塊、多檔上傳、動態增減欄位
`name="field[key]"`關聯陣列 `['key' => val]`固定結構多組資料
`name="field[][sub]"`多維陣列 `[[sub=>val], [sub=>val]]`動態列表、明細表單

常見問題與解決

1. 核取方塊未勾選不送出值

<!-- 隱藏欄位確保陣列存在 -->
<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'] ?? []); // 移除空值

2. 檔案上傳多檔

<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],
    ];
}

3. JavaScript 動態新增欄位索引同步

function addItemRow() {
    const tbody = document.querySelector('#items tbody');
    const index = tbody.rows.length; // 0-based
    const row = tbody.insertRow();
    row.innerHTML = `
        
        
        
        
    `;
}

安全性檢查清單

  • ✅ 限制陣列長度:`if (count($books) > 100) die('超過上限');`
  • ✅ 驗證每個元素型別、長度、格式
  • ✅ 使用 Prepared Statement 防 SQL 注入
  • ✅ CSRF Token 保護表單提交
  • ✅ 檔案上傳驗證 MIME、副檔名、掃毒

善用 `name="field[]"` 語法,讓前端動態表單與後端處理無縫銜接,是 PHP 表單開發的基礎必修課。

copyright © 萬盛學電腦網 all rights reserved