本教程详细介绍了如何在 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>
登录后复制
代码解释：
- 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中文网其它相关文章！
相关标签：