CodeIgniter 4 中使用单选按钮更新数据库记录的教程-php教程-PHP中文网

CodeIgniter 4 中使用单选按钮更新数据库记录的教程

本教程详细介绍了如何在 CodeIgniter 4 框架中，通过表单中的单选按钮（Radio Button）收集用户输入，并利用其强大的 Model 层来安全、高效地更新数据库中的指定记录。文章涵盖了视图、控制器和模型代码示例，并强调了正确识别更新记录的重要性。

在web应用开发中，从用户界面收集数据并更新数据库是常见的操作。codeigniter 4 提供了一套优雅的解决方案，特别是通过其模型（model）层，可以简化数据库交互。本教程将指导您如何利用html单选按钮（radio button）获取用户选择，并使用codeigniter 4的模型来更新数据库中的特定记录。

理解CodeIgniter 4的模型层

CodeIgniter 4 的模型层是处理数据库交互的核心组件。它封装了对数据库表的CRUD（创建、读取、更新、删除）操作，提供了更高级别的抽象，使得代码更易于维护、测试和扩展。相较于直接使用数据库查询构建器（Query Builder）进行复杂的更新操作，模型能够更好地管理数据映射、验证和生命周期事件。

构建数据更新流程

要实现从单选按钮更新数据库，我们需要在视图、控制器和模型之间建立清晰的交互。

1. 视图层：构建单选按钮表单

视图（View）负责呈现用户界面。我们将创建一个包含单选按钮的表单，允许用户选择一个选项并提交。为了确保更新特定记录，通常需要在表单中包含一个隐藏字段来传递该记录的唯一标识符（如ID）。

<!-- app/Views/home/edit_anotasi.php -->
<form method="post" action="<?= base_url('home/savecovid') ?>">
    <?= csrf_field() ?> <!-- CodeIgniter 4 CSRF 保护 -->

    <!-- 假设我们正在更新 ID 为 1 的记录 -->
    <input type="hidden" name="id" value="1"> 

    <div class="form-group">
        <label>请选择注解类型:</label><br>
        <input type="radio" name="anotasi" value="Positif" 
               <?= set_radio('anotasi', 'Positif', true); ?>/> Positif<br>
        <input type="radio" name="anotasi" value="Negatif"
               <?= set_radio('anotasi', 'Negatif'); ?>/> Negatif<br>
        <input type="radio" name="anotasi" value="Netral"
               <?= set_radio('anotasi', 'Netral'); ?>/> Netral
    </div>
    <button type="submit" name="saveCovid" class="btn btn-primary">提交</button>
</form>

登录后复制

代码解释：

话袋AI笔记

话袋AI笔记, 像聊天一样随时随地记录每一个想法，打造属于你的个人知识库，成为你的外挂大脑

查看详情

zuojiankuohaophpcn?= csrf_field() ?>: 这是CodeIgniter 4内置的CSRF保护机制，会在表单中生成一个隐藏的令牌字段，提高安全性。
<input type="hidden" name="id" value="1">: 这个隐藏字段至关重要，它告诉控制器我们要更新的是哪条记录。在实际应用中，这个 value 会从数据库动态加载。
name="anotasi": 所有单选按钮使用相同的 name 属性，确保它们是互斥的。
value="...": 每个单选按钮的值，将被提交到服务器。
<?= set_radio('anotasi', 'Positif', true); ?>: CodeIgniter的辅助函数，用于在表单提交失败或页面加载时保持单选按钮的选中状态。第三个参数 true 表示默认选中“Positif”。

2. 模型层：定义数据操作逻辑

接下来，我们需要创建一个模型来与 tbl_anotasi 表进行交互。

// app/Models/AnotasiModel.php
namespace App\Models;

use CodeIgniter\Model;

class AnotasiModel extends Model
{
    protected $table      = 'tbl_anotasi'; // 数据库表名
    protected $primaryKey = 'id';          // 主键名，假设您的表主键是 'id'

    protected $useAutoIncrement = true; // 主键是否自增

    protected $returnType     = 'array'; // 返回类型，可以是 'array' 或 'object'
    protected $useSoftDeletes = false;   // 是否使用软删除

    protected $allowedFields = ['anotasi']; // 允许被更新的字段

    // 如果需要，可以定义验证规则
    protected $validationRules    = [];
    protected $validationMessages = [];
    protected $skipValidation     = false;
}

登录后复制

代码解释：

$table: 指定模型关联的数据库表。
$primaryKey: 指定表的主键字段，这对于 update() 方法至关重要。
$allowedFields: 这是一个安全特性，定义了哪些字段可以通过 insert() 或 update() 方法批量赋值。未在此列表中定义的字段将被忽略，防止恶意数据注入。

3. 控制器层：处理请求并调用模型

控制器（Controller）负责接收HTTP请求，处理业务逻辑，并协调模型和视图。

// app/Controllers/Home.php
namespace App\Controllers;

use App\Models\AnotasiModel; // 引入我们创建的模型
use CodeIgniter\Controller;

class Home extends Controller
{
    public function savecovid()
    {
        // 1. 获取表单提交的数据
        $recordId = $this->request->getPost('id');       // 获取要更新的记录ID
        $anotasiValue = $this->request->getPost('anotasi'); // 获取单选按钮的值

        // 确保获取到了ID和值
        if (empty($recordId) || $anotasiValue === null) {
            // 处理错误，例如重定向回表单并显示错误消息
            return redirect()->back()->with('error', '缺少必要的更新参数。');
        }

        // 2. 实例化模型
        $anotasiModel = new AnotasiModel();

        // 3. 准备更新数据
        $dataToUpdate = [
            'anotasi' => $anotasiValue
        ];

        // 4. 调用模型的 update 方法
        // update($id, $data) 方法会根据 $id 更新主键匹配的记录
        $isUpdated = $anotasiModel->update($recordId, $dataToUpdate);

        if ($isUpdated) {
            // 更新成功，可以重定向到成功页面或显示成功消息
            return redirect()->to('/success_page')->with('success', '记录更新成功！');
        } else {
            // 更新失败，可能是ID不存在或数据库错误
            // 可以获取模型的错误信息：$anotasiModel->errors()
            return redirect()->back()->with('error', '记录更新失败，请重试。');
        }
    }
}

登录后复制

代码解释：

use App\Models\AnotasiModel;: 导入我们创建的模型类。
$this->request->getPost('id'): 从表单中获取隐藏字段 id 的值，这是要更新的记录的主键。
$this->request->getPost('anotasi'): 获取用户选择的单选按钮的值。
$anotasiModel = new AnotasiModel();: 实例化模型。
$anotasiModel->update($recordId, $dataToUpdate);: 这是核心的更新操作。CodeIgniter 4 的 Model 类提供了 update($id, $data) 方法，它会自动构建 WHERE primaryKey = $id 的条件，并使用 $data 数组中的键值对更新相应的字段。这比手动使用查询构建器更简洁和安全。
redirect()->back()->with('error', '...'): 更新失败时重定向回上一页并附带错误消息。
redirect()->to('/success_page')->with('success', '...'): 更新成功时重定向到指定页面并附带成功消息。

完整示例代码（整合）

为了更清晰地展示，以下是视图、控制器和模型的整合示例。

1. app/Models/AnotasiModel.php

<?php namespace App\Models;

use CodeIgniter\Model;

class AnotasiModel extends Model
{
    protected $table      = 'tbl_anotasi';
    protected $primaryKey = 'id'; // 假设主键是 'id'

    protected $useAutoIncrement = true;
    protected $returnType     = 'array';
    protected $useSoftDeletes = false;

    protected $allowedFields = ['anotasi']; // 允许更新的字段

    protected $validationRules    = [];
    protected $validationMessages = [];
    protected $skipValidation     = false;
}

登录后复制

2. app/Controllers/Home.php

<?php namespace App\Controllers;

use App\Models\AnotasiModel;
use CodeIgniter\Controller;

class Home extends Controller
{
    public function index()
    {
        // 假设您从数据库加载了要编辑的记录
        // 仅用于演示目的，实际应用中应从数据库获取
        $data = [
            'current_anotasi' => 'Negatif', // 假设当前记录的注解是 Negatif
            'record_id' => 1 // 假设要编辑的记录ID是 1
        ];
        return view('home/edit_anotasi', $data);
    }

    public function savecovid()
    {
        $recordId = $this->request->getPost('id');
        $anotasiValue = $this->request->getPost('anotasi');

        if (empty($recordId) || $anotasiValue === null) {
            return redirect()->back()->with('error', '缺少必要的更新参数。');
        }

        $anotasiModel = new AnotasiModel();
        $dataToUpdate = [
            'anotasi' => $anotasiValue
        ];

        $isUpdated = $anotasiModel->update($recordId, $dataToUpdate);

        if ($isUpdated) {
            return redirect()->to('/home/index')->with('success', '记录更新成功！');
        } else {
            // 可以在此处添加更详细的错误日志
            return redirect()->back()->with('error', '记录更新失败，请重试。');
        }
    }
}

登录后复制

3. app/Views/home/edit_anotasi.php

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>更新注解</title>
    <link rel="stylesheet" href="https://stackpath.bootstrapcdn.com/bootstrap/4.5.2/css/bootstrap.min.css">
</head>
<body>
    <div class="container mt-5">
        <h1>更新注解类型</h1>

        <?php if (session()->getFlashdata('success')): ?>
            <div class="alert alert-success">
                <?= session()->getFlashdata('success') ?>
            </div>
        <?php endif; ?>
        <?php if (session()->getFlashdata('error')): ?>
            <div class="alert alert-danger">
                <?= session()->getFlashdata('error') ?>
            </div>
        <?php endif; ?>

        <form method="post" action="<?= base_url('home/savecovid') ?>">
            <?= csrf_field() ?>

            <input type="hidden" name="id" value="<?= esc($record_id) ?>"> 

            <div class="form-group">
                <label>请选择注解类型:</label><br>
                <input type="radio" name="anotasi" value="Positif" 
                       <?= set_radio('anotasi', 'Positif', (isset($current_anotasi) && $current_anotasi == 'Positif')); ?>/> Positif<br>
                <input type="radio" name="anotasi" value="Negatif"
                       <?= set_radio('anotasi', 'Negatif', (isset($current_anotasi) && $current_anotasi == 'Negatif')); ?>/> Negatif<br>
                <input type="radio" name="anotasi" value="Netral"
                       <?= set_radio('anotasi', 'Netral', (isset($current_anotasi) && $current_anotasi == 'Netral')); ?>/> Netral
            </div>
            <button type="submit" name="saveCovid" class="btn btn-primary">提交</button>
        </form>
    </div>
</body>
</html>

登录后复制

注意： 在 edit_anotasi.php 视图中，set_radio 的第三个参数现在会根据从控制器传入的 $current_anotasi 值来判断哪个单选按钮应该被预选中。

注意事项与最佳实践

记录ID的传递与识别： 更新操作必须明确指定要更新哪条记录。通常通过隐藏表单字段或URL参数传递记录的主键（ID）。在模型 update($id, $data) 方法中，$id 参数就是用来识别这条记录的。
输入验证： 在控制器中接收用户输入后，强烈建议进行数据验证。CodeIgniter 4 提供了强大的验证服务。您可以在模型中定义验证规则，或者在控制器中直接使用 validate() 方法。
错误处理与用户反馈： 无论更新成功还是失败，都应向用户提供清晰的反馈。使用 CodeIgniter 的 session()->setFlashdata() 可以在重定向后显示一次性消息。
安全性：
- CSRF 保护： <?= csrf_field() ?> 在表单中是必不可少的，用于防止跨站请求伪造攻击。
- $allowedFields： 在模型中正确配置 $allowedFields 可以防止“大批量赋值漏洞”，即用户尝试更新不应该被修改的字段。
- 输入过滤： 在将数据存入数据库之前，始终对用户输入进行过滤和转义，以防止SQL注入和XSS攻击。CodeIgniter 框架通常会处理大部分情况，但仍需保持警惕。

总结

通过本教程，您应该已经掌握了在 CodeIgniter 4 中使用单选按钮更新数据库记录的完整流程。核心在于利用 CodeIgniter 4 的模型层，特别是 update($id, $data) 方法，它提供了一种简洁、安全且符合框架最佳实践的方式来处理数据库更新操作。始终牢记传递记录ID、进行数据验证以及提供用户反馈的重要性，以构建健壮可靠的Web应用程序。

以上就是CodeIgniter 4 中使用单选按钮更新数据库记录的教程的详细内容，更多请关注php中文网其它相关文章！