Отправка формы через submit: полное описание для PHP разработчиков

Раздел: Веб-разработка -> Обработка форм в PHP

Основы работы кнопки submit в PHP форме

Основной и наиболее эффективный способ отправки данных формы на сервер - использование элемента <input type="submit"> с атрибутом name. При нажатии на такую кнопку браузер отправляет данные формы (все поля, включая саму кнопку) методом, указанным в method (обычно POST). На стороне PHP проверяется наличие ключа кнопки в суперглобальном массиве $_POST. Это позволяет однозначно определить, что форма была отправлена именно этой кнопкой.


<form method="post" action="handler.php">
    <label>Имя: <input type="text" name="username"></label>
    <input type="submit" name="submit_form" value="Отправить">
</form>

Application form php (форма приложения на php)


<?php
if (isset($_POST['submit_form'])) {
    $name = htmlspecialchars($_POST['username'], ENT_QUOTES, 'UTF-8');
    echo "Привет, " . $name;
}
?>

Input type name value php (обработка полей name и value в php-форме)

Цель:

Обработка формы только после явного нажатия кнопки, защита от случайной отправки при обновлении страницы.

Типичные проблемы и ошибки:

  • Пропуск атрибута name у кнопки - тогда ключ submit_form отсутствует в массиве $_POST, даже если форма отправлена. Решение: всегда добавлять name.
  • Проверка isset($_POST['submit']) без указания своего имени - если у кнопки нет name, то по умолчанию ключом может быть submit только в старых браузерах. Надёжнее задавать уникальное имя.
  • Неэкранированный вывод данных (echo $_POST['username']) - приводит к XSS-уязвимости. Обязательно использовать htmlspecialchars.
  • Неправильная кодировка - если форма использует UTF-8, а PHP скрипт нет, возможны кракозябры. Установить заголовок header('Content-Type: text/html; charset=utf-8');.

Варианты реализации submit кнопки

Как сделать, чтобы форма отправлялась через GET, а не POST?

Используйте атрибут method="get". Данные пойдут в строку URL через $_GET. Подходит для поисковых форм, где важна закладность страницы.


<form method="get" action="search.php">
    <input type="text" name="q">
    <input type="submit" name="search" value="Искать">
</form>

Input type submit php (кнопка submit в php-форме)


<?php
if (isset($_GET['search'])) {
    $query = htmlspecialchars($_GET['q']);
    echo "Результаты поиска для: $query";
}
?>

Php input type text (поле ввода text в php-форме)

Проблема:

Длинный URL при большом количестве полей (ограничение 2048 символов). Решение: использовать POST для больших объёмов данных.

Как обработать форму, если кнопка не имеет атрибута name?

Можно проверять не кнопку, а наличие любого другого обязательного поля. Однако такой способ менее надёжен - форма может быть отправлена случайно (например, через нажатие Enter в любом поле). Рекомендуется всегда задавать name для кнопки.


<form method="post">
    <input type="text" name="email">
    <input type="submit" value="Подписаться">
</form>

Php request type (тип http-запроса (get/post) в php)


<?php
if (!empty($_POST['email'])) {
    // обработка
}
?>

Php form date (php дата из формы)

Ошибка:

Пустая отправка (поле email не заполнено) не обрабатывается, но если пользователь заполнит поле и нажмёт Enter, форма всё равно отправится. Это может привести к нежелательным действиям.

Как реализовать несколько действий с одной формой?

Добавьте несколько кнопок submit с разными атрибутами name и value. В PHP определите, какая кнопка нажата, по её ключу в $_POST.


<form method="post">
    <input type="text" name="item">
    <input type="submit" name="action" value="edit">
    <input type="submit" name="action" value="delete">
</form>

Php form input type (типы полей ввода в php-форме)


<?php
if (isset($_POST['action'])) {
    switch ($_POST['action']) {
        case 'edit':
            echo 'Редактирование...';
            break;
        case 'delete':
            echo 'Удаление...';
            break;
    }
}
?>

Проблема:

Имена кнопок должны быть уникальными, если вы используете одинаковое имя, то значение отправляется только одной кнопки (той, на которую нажали). Если же имена разные (name="edit" и name="delete"), то проверяйте каждую отдельно.

Как использовать элемент <button type="submit"> вместо input?

Элемент <button> позволяет размещать внутри HTML-разметку (иконки, текст с форматированием). У него также должен быть атрибут name (необязательно, но желательно). Значение отправляется как value атрибута или текст между тегами (работает не во всех браузерах, лучше задавать value).


<form method="post">
    <input type="hidden" name="user_id" value="123">
    <button type="submit" name="update" value="update_user">
        <span class="icon">✔</span> Обновить
    </button>
</form>


<?php
if (isset($_POST['update']) && $_POST['update'] === 'update_user') {
    $id = (int) $_POST['user_id'];
    echo "Обновлён пользователь с ID $id";
}
?>

Ошибка:

В Internet Explorer элемент <button> отправляет своё внутреннее содержимое как значение, а не атрибут value. Для кроссбраузерности лучше использовать <input type="submit"> или явно задавать value и не полагаться на текст.

Как изменить URL отправки для конкретной кнопки?

Используйте атрибут formaction (начиная с HTML5). У разных кнопок внутри одной формы могут быть разные formaction, что позволяет направлять данные на разные обработчики.


<form method="post" action="default.php">
    <input type="text" name="data">
    <input type="submit" name="save" value="Сохранить" formaction="save.php">
    <input type="submit" name="export" value="Экспорт" formaction="export.php">
</form>

В PHP проверяем, какая кнопка нажата, и перенаправляем логику.


<?php
if (isset($_POST['save'])) {
    // обработка save.php
} elseif (isset($_POST['export'])) {
    // обработка export.php
}
?>

Проблема:

Атрибут formaction не поддерживается в старых версиях Internet Explorer (до 10). Для обратной совместимости используйте JavaScript.

Как сделать кнопку submit в виде изображения?

Элемент <input type="image"> работает как графическая кнопка submit. При нажатии отправляются координаты клика (name_x, name_y) и обычные поля формы. На сервере координаты можно использовать, например, для карты изображений.


<form method="post">
    <input type="text" name="search">
    <input type="image" name="map" src="search.png" alt="Найти">
</form>


<?php
if (isset($_POST['map_x'])) {
    $x = (int) $_POST['map_x'];
    $y = (int) $_POST['map_y'];
    echo "Клик по координатам: ($x, $y)";
}
?>

Ошибка:

Если изображение не загружено или у пользователя отключены изображения, кнопка не будет работать. Всегда добавляйте альтернативный submit на случай отключения графики.

Как отправить форму без перезагрузки страницы (AJAX)?

Используйте JavaScript, чтобы перехватить событие submit формы или клик по кнопке и отправить данные асинхронно. PHP скрипт возвращает данные (например, JSON), которые затем вставляются в DOM. Кнопка submit может оставаться, но её действие блокируется через event.preventDefault().


<form id="myForm" method="post" action="ajax_handler.php">
    <input type="text" name="message">
    <input type="submit" name="submit_ajax" value="Отправить AJAX">
</form>
<div id="result"></div>
<script>
document.getElementById('myForm').addEventListener('submit', function(e) {
    e.preventDefault();
    var formData = new FormData(this);
    fetch('ajax_handler.php', {
        method: 'POST',
        body: formData
    })
    .then(response => response.json())
    .then(data => {
        document.getElementById('result').innerHTML = data.message;
    });
});
</script>


<?php
// ajax_handler.php
if (isset($_POST['submit_ajax'])) {
    $msg = htmlspecialchars($_POST['message']);
    echo json_encode(['message' => "Вы написали: $msg"]);
} else {
    http_response_code(400);
}
?>

Проблемы:

  • Необходимо учитывать, что AJAX-запрос не обновляет страницу, поэтому логика сессий и перенаправлений должна быть реализована иначе.
  • Ошибка CORS, если форма и скрипт на разных доменах.
  • При отключённом JavaScript форма не будет работать, поэтому используется прогрессивное улучшение - форма отправляется обычным способом, а JS добавляет асинхронность.

Расширенные примеры работы с submit кнопкой

Пример 1: Форма с двумя кнопками и разными действиями

Форма редактирования товара с кнопками «Сохранить» и «Удалить». Каждая кнопка имеет уникальное имя, PHP обрабатывает соответствующее действие.

Пример 

<?php
// Пример обработчика edit_delete.php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    if (isset($_POST['save'])) {
        // Сохранение
        $product_id = (int) $_POST['product_id'];
        $name = htmlspecialchars($_POST['product_name']);
        echo "<p>Товар ID $product_id сохранён с именем «$name».</p>";
    } elseif (isset($_POST['delete'])) {
        // Удаление
        $product_id = (int) $_POST['product_id'];
        echo "<p>Товар ID $product_id удалён.</p>";
    }
}
?>
<!DOCTYPE html>
<html>
<body>
<form method="post" action="">
    <input type="hidden" name="product_id" value="42">
    <label>Название: <input type="text" name="product_name" value="Книга"></label><br>
    <input type="submit" name="save" value="Сохранить">
    <input type="submit" name="delete" value="Удалить">
</form>
</body>
</html>

Результат при нажатии «Сохранить»:

Товар ID 42 сохранён с именем «Книга».

Пример 2: Отправка файла с помощью submit кнопки

Используйте <input type="file"> внутри формы с enctype="multipart/form-data". PHP обрабатывает файл через $_FILES.

Пример 

<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_POST['upload'])) {
    if (isset($_FILES['userfile']) && $_FILES['userfile']['error'] === UPLOAD_ERR_OK) {
        $tmp_name = $_FILES['userfile']['tmp_name'];
        $name = basename($_FILES['userfile']['name']);
        $dest = 'uploads/' . $name;
        if (move_uploaded_file($tmp_name, $dest)) {
            echo "<p>Файл «$name» успешно загружен.</p>";
        } else {
            echo "<p>Ошибка перемещения файла.</p>";
        }
    } else {
        echo "<p>Ошибка загрузки файла (код: {$_FILES['userfile']['error']}).</p>";
    }
}
?>
<form method="post" enctype="multipart/form-data">
    <input type="file" name="userfile">
    <input type="submit" name="upload" value="Загрузить">
</form>

Результат после успешной загрузки:

Файл «photo.jpg» успешно загружен.

Пример 3: Валидация данных на сервере с отображением ошибок

Форма регистрации с проверками имени, email и пароля. Ошибки выводятся рядом с полями. Кнопка submit отправляет форму, PHP возвращает ту же страницу с сообщениями.

Пример 

<?php
$errors = [];
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_POST['register'])) {
    $username = trim($_POST['username'] ?? '');
    $email = trim($_POST['email'] ?? '');
    $password = $_POST['password'] ?? '';

    if (strlen($username) < 3) {
        $errors['username'] = 'Имя должно содержать минимум 3 символа.';
    }
    if (!filter_var($email, FILTER_VALIDATE_EMAIL)) {
        $errors['email'] = 'Некорректный email.';
    }
    if (strlen($password) < 6) {
        $errors['password'] = 'Пароль должен быть не менее 6 символов.';
    }

    if (empty($errors)) {
        // Сохранение в базу данных
        echo "<p>Регистрация успешна!</p>";
        // Очистить поля
    }
}
?>
<form method="post">
    <label>Имя:
        <input type="text" name="username" value="<?= htmlspecialchars($_POST['username'] ?? '') ?>">
        <?php if (isset($errors['username'])): ?><span class="error"><?= $errors['username'] ?></span><?php endif; ?>
    </label><br>
    <label>Email:
        <input type="email" name="email" value="<?= htmlspecialchars($_POST['email'] ?? '') ?>">
        <?php if (isset($errors['email'])): ?><span class="error"><?= $errors['email'] ?></span><?php endif; ?>
    </label><br>
    <label>Пароль:
        <input type="password" name="password">
        <?php if (isset($errors['password'])): ?><span class="error"><?= $errors['password'] ?></span><?php endif; ?>
    </label><br>
    <input type="submit" name="register" value="Зарегистрироваться">
</form>

Результат при ошибках:

(Форма отображается с красными сообщениями об ошибках рядом с полями)

Пример 4: Асинхронная отправка формы с JSON ответом

Используется Fetch API. Кнопка submit отправляет данные без перезагрузки, PHP возвращает JSON, JavaScript обновляет страницу.

Пример 

<!DOCTYPE html>
<html>
<body>
<div id="response"></div>
<form id="feedbackForm" method="post" action="feedback_ajax.php">
    <input type="text" name="subject" placeholder="Тема" required>
    <textarea name="message" placeholder="Сообщение" required></textarea>
    <input type="submit" name="send_feedback" value="Отправить">
</form>
<script>
document.getElementById('feedbackForm').addEventListener('submit', function(e) {
    e.preventDefault();
    var form = e.target;
    var formData = new FormData(form);
    fetch(form.action, {
        method: 'POST',
        body: formData
    })
    .then(response => response.json())
    .then(result => {
        document.getElementById('response').innerHTML =
            result.success
                ? '<p style="color:green">' + result.message + '</p>'
                : '<p style="color:red">' + result.message + '</p>';
    })
    .catch(error => {
        document.getElementById('response').innerHTML = '<p>Произошла ошибка.</p>';
    });
});
</script>
</body>
</html>
Пример 

<?php
// feedback_ajax.php
header('Content-Type: application/json; charset=utf-8');
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_POST['send_feedback'])) {
    $subject = htmlspecialchars($_POST['subject']);
    $message = htmlspecialchars($_POST['message']);
    // Здесь можно отправить email или сохранить в БД
    echo json_encode([
        'success' => true,
        'message' => "Спасибо! Ваше сообщение на тему «$subject» получено."
    ]);
} else {
    echo json_encode(['success' => false, 'message' => 'Неверный запрос.']);
}
?>

Результат после отправки:

(Зелёное сообщение: «Спасибо! Ваше сообщение на тему «Отзыв о сайте» получено.»)

Пример 5: Защита от CSRF с помощью скрытого поля и проверки токена

В форму добавляется скрытое поле с уникальным токеном, хранящимся в сессии. При отправке PHP сравнивает токен.

Пример 

<?php
session_start();
if (empty($_SESSION['csrf_token'])) {
    $_SESSION['csrf_token'] = bin2hex(random_bytes(32));
}
$token = $_SESSION['csrf_token'];

if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_POST['submit_with_csrf'])) {
    if (!hash_equals($token, $_POST['csrf_token'] ?? '')) {
        die('Ошибка CSRF: неверный токен.');
    }
    // Обработка формы
    echo 'Форма обработана безопасно.';
}
?>
<form method="post">
    <input type="hidden" name="csrf_token" value="<?= $token ?>">
    <input type="text" name="data" required>
    <input type="submit" name="submit_with_csrf" value="Отправить с защитой">
</form>

Как это работает:

При каждой загрузке страницы генерируется новый токен. Если злоумышленник попытается отправить поддельную форму, токен не совпадёт, и запрос будет отклонён.

Кнопка submit в PHP-форме - comments

En
Input type submit php (php)