在Laravel中使用纯HTML表单及路由配置指南-php教程-PHP中文网

在Laravel中使用纯HTML表单及路由配置指南

聖光之護

发布： 2025-11-27 08:18:13

原创

988人浏览过

在Laravel中使用纯HTML表单及路由配置指南

本文详细阐述了如何在laravel应用中正确集成和使用纯html表单，并解决常见的路由配置错误。通过示例代码，我们将学习如何正确设置表单的`action`和`method`属性，以及如何在laravel路由文件中定义匹配的路由，确保数据能够被后端控制器正确处理，避免出现`method not allowed`等http 405错误。

理解“Method Not Allowed”错误

在使用纯HTML表单与Laravel框架交互时，开发者常会遇到“The POST method is not supported for this route. Supported methods: GET, HEAD, PUT, PATCH, DELETE.”或HTTP 405 (Method Not Allowed) 错误。这通常意味着以下两种情况之一：

路由方法不匹配： 表单提交的HTTP方法（例如POST）与Laravel路由文件中为该URI定义的允许方法不一致。例如，表单使用POST提交数据，但对应的路由只定义了GET方法。
路由URI不匹配： 表单的action属性指向的URI在Laravel路由文件中没有被定义，或者定义了一个不接受当前HTTP方法的默认路由。

Laravel作为一款强大的PHP框架，完全支持使用标准的HTML表单。关键在于正确配置表单的属性以及与之匹配的Laravel路由。

在Laravel中正确配置HTML表单

要在Laravel视图文件中使用纯HTML表单，需要关注以下几个核心要素：

1. action 属性与 route() 辅助函数

action属性指定了表单数据提交的目标URL。在Laravel中，强烈推荐使用route()辅助函数来生成URL，而不是硬编码URL路径。这使得应用更具可维护性，因为即使路由URI发生变化，只要路由名称不变，表单也能正常工作。

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

示例：

STORYD

帮你写出让领导满意的精美文稿

137

查看详情

<form action="{{ route('posts.store') }}" method="POST">
    <!-- 表单内容 -->
</form>

登录后复制

这里的posts.store是一个命名路由。

2. method 属性

method属性定义了表单提交数据时使用的HTTP方法。常见的有GET和POST。对于数据创建、更新或删除操作，通常使用POST方法。

示例：

<form action="{{ route('posts.store') }}" method="POST">
    <!-- 表单内容 -->
</form>

登录后复制

3. CSRF 保护 (@csrf)

Laravel默认启用CSRF（跨站请求伪造）保护。对于所有使用POST、PUT、PATCH或DELETE方法的表单，必须包含一个CSRF令牌字段。在Blade模板中，这通过@csrf指令轻松实现。它会生成一个隐藏的输入字段，其中包含一个有效的CSRF令牌。

示例：

<form action="{{ route('posts.store') }}" method="POST">
    @csrf
    <!-- 其他表单字段 -->
</form>

登录后复制

4. 表单输入字段

确保表单中的输入字段（zuojiankuohaophpcninput>、<textarea>、<select>等）都包含name属性，因为Laravel控制器会通过这些name属性来获取提交的数据。

示例：

<div class="form-group">
    <label for="title">标题</label>
    <input type="text" class="form-control" id="title" name="title">
</div>
<div class="form-group">
    <label for="body">内容</label>
    <textarea class="form-control" id="body" name="body" rows="5"></textarea>
</div>

登录后复制

定义对应的Laravel路由

为了让表单能够正确提交数据，你需要在routes/web.php文件中定义一个与表单action和method相匹配的路由。

示例： 如果你的表单使用POST方法提交到posts.store命名路由，那么路由文件应如下定义：

// routes/web.php
use App\Http\Controllers\PostController;

// 定义一个处理POST请求的路由，并命名为 'posts.store'
Route::post('/posts', [PostController::class, 'store'])->name('posts.store');

// 如果还需要显示创建表单的页面，可能还需要一个GET路由
Route::get('/posts/create', [PostController::class, 'create'])->name('posts.create');

登录后复制

控制器处理逻辑

最后，在对应的控制器（例如PostController）中，你需要编写处理表单提交数据的逻辑。

示例：

// app/Http/Controllers/PostController.php
namespace App\Http\Controllers;

use Illuminate\Http\Request;

class PostController extends Controller
{
    /**
     * 显示创建新文章的表单。
     *
     * @return \Illuminate\View\View
     */
    public function create()
    {
        return view('posts.create'); // 假设你的表单在 resources/views/posts/create.blade.php
    }

    /**
     * 存储新创建的文章。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\RedirectResponse
     */
    public function store(Request $request)
    {
        // 验证请求数据
        $request->validate([
            'title' => 'required|max:255',
            'body' => 'required',
        ]);

        // 获取表单数据
        $title = $request->input('title');
        $body = $request->input('body');

        // 这里可以执行数据存储操作，例如保存到数据库
        // Post::create($request->all());

        // 重定向并带上成功消息
        return redirect()->route('posts.index')->with('success', '文章创建成功！');
    }
}

登录后复制

完整示例代码

以下是一个完整的示例，展示了如何在Blade视图中使用纯HTML表单，并配置相应的Laravel路由和控制器。

1. resources/views/posts/create.blade.php (表单视图)

<!DOCTYPE html>
<html lang="zh">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>创建新文章</title>
    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
</head>
<body>
    <div class="container mt-5">
        <h1>创建新文章</h1>

        @if ($errors->any())
            <div class="alert alert-danger">
                <ul>
                    @foreach ($errors->all() as $error)
                        <li>{{ $error }}</li>
                    @endforeach
                </ul>
            </div>
        @endif

        <form action="{{ route('posts.store') }}" method="POST">
            @csrf
            <div class="mb-3">
                <label for="title" class="form-label">标题</label>
                <input type="text" class="form-control" id="title" name="title" value="{{ old('title') }}" required>
            </div>
            <div class="mb-3">
                <label for="body" class="form-label">内容</label>
                <textarea class="form-control" id="body" name="body" rows="5" required>{{ old('body') }}</textarea>
            </div>
            <button type="submit" class="btn btn-primary">提交</button>
        </form>
    </div>
</body>
</html>

登录后复制

2. routes/web.php (路由定义)

<?php

use Illuminate\Support\Facades\Route;
use App\Http\Controllers\PostController;

/*
|--------------------------------------------------------------------------
| Web Routes
|--------------------------------------------------------------------------
|
| Here is where you can register web routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| contains the "web" middleware group. Now create something great!
|
*/

Route::get('/', function () {
    return view('welcome');
});

// 显示创建文章的表单
Route::get('/posts/create', [PostController::class, 'create'])->name('posts.create');

// 处理表单提交，存储新文章
Route::post('/posts', [PostController::class, 'store'])->name('posts.store');

// 假设有一个显示所有文章的路由
Route::get('/posts', function() {
    return '所有文章列表页面';
})->name('posts.index');

登录后复制

3. app/Http/Controllers/PostController.php (控制器逻辑)

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;

class PostController extends Controller
{
    /**
     * 显示创建新文章的表单。
     *
     * @return \Illuminate\View\View
     */
    public function create()
    {
        return view('posts.create');
    }

    /**
     * 存储新创建的文章。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\RedirectResponse
     */
    public function store(Request $request)
    {
        // 验证请求数据
        $request->validate([
            'title' => 'required|string|max:255',
            'body' => 'required|string',
        ], [
            'title.required' => '标题是必填项。',
            'title.max' => '标题不能超过255个字符。',
            'body.required' => '内容是必填项。',
        ]);

        // 模拟数据存储
        // 实际应用中，这里会与数据库交互，例如：
        // Post::create([
        //     'title' => $request->title,
        //     'body' => $request->body,
        // ]);

        // 打印接收到的数据以供调试
        // dd($request->all()); 

        // 重定向到文章列表页，并带上成功消息
        return redirect()->route('posts.index')->with('success', '文章创建成功！');
    }
}

登录后复制

注意事项与总结

命名路由的重要性： 始终使用route()辅助函数和命名路由。它提供了灵活性和可维护性。
HTTP方法匹配： 确保HTML表单的method属性与Laravel路由中定义的HTTP方法（Route::get、Route::post等）严格匹配。
CSRF保护： 对于所有非GET请求的表单，@csrf指令是强制性的。
输入字段name属性： 确保所有需要提交的表单元素都有name属性，这是控制器获取数据的关键。
错误处理： 在表单视图中显示验证错误（如示例所示@if ($errors->any())）可以提升用户体验。
路由缓存： 在生产环境中，运行php artisan route:cache可以提高路由加载性能，但请记住，在修改路由文件后需要重新运行此命令。