CodeIgniter 4 更新功能开发与常见问题排查指南

<?php

namespace App\Models;

use CodeIgniter\Model;

class ModelSiswa extends Model
{
    // 数据库表名
    protected $table = 'users';
    // 表主键
    protected $primaryKey = 'id_user';
    // 允许通过 insert() 或 update() 方法写入的字段
    protected $allowedFields = ['nama_user', 'alamat', 'tgl', 'hp', 'email'];
    // 是否使用时间戳字段
    protected $useTimestamps = true;
    // 记录创建时间戳的字段名
    protected $createdField  = 'created_at';
    // 记录更新时间戳的字段名
    protected $updatedField  = 'updated_at';
    // 记录软删除时间戳的字段名 (如果启用软删除)
    protected $deletedField  = 'deleted_at';
    // 返回结果集的类型，'array' 或 'object'
    protected $returnType = 'array';

    public function __construct()
    {
        parent::__construct();
    }
}

<?php
namespace App\Controllers;

use App\Controllers\BaseController;
use App\Models\ModelSiswa; // 引入模型类

class Siswa extends BaseController
{
    // ... 其他方法 (如 index())

    /**
     * 加载学生编辑视图
     * @param int|null $id 学生ID
     * @return string
     */
    public function editSiswa($id = null)
    {
        // 实例化模型
        $model = new ModelSiswa();

        // 根据ID查询学生数据
        // first() 方法用于获取单条记录
        $data['siswa'] = $model->where('id_user', $id)->first();

        // 如果没有找到数据，可以重定向或显示错误
        if (empty($data['siswa'])) {
            // 示例：重定向回列表页并显示消息
            return redirect()->to(base_url('siswa'))->with('error', '未找到指定学生信息。');
        }

        // 加载编辑视图，并传递学生数据
        return view('siswa_edit_view', $data);
    }
}

<?php
namespace App\Controllers;

use App\Controllers\BaseController;
use App\Models\ModelSiswa; // 引入模型类

class Siswa extends BaseController
{
    // ... 其他方法 (如 index(), editSiswa())

    /**
     * 处理学生数据更新请求
     * @return \CodeIgniter\HTTP\RedirectResponse
     */
    public function updateSiswa() // 将原方法名 'updat' 更正为 'updateSiswa' 以符合命名规范
    {
        // 实例化模型
        $model = new ModelSiswa();

        // 获取表单提交的ID
        // FILTER_SANITIZE_NUMBER_INT 用于过滤非数字字符，确保ID是整数
        $id = $this->request->getVar('id', FILTER_SANITIZE_NUMBER_INT);

        // 获取其他表单数据
        $data = [
            'nama_user' => $this->request->getVar('nama_user'),
            'alamat'    => $this->request->getVar('alamat'),
            'tgl'       => $this->request->getVar('tgl'),
            'hp'        => $this->request->getVar('hp'),
            'email'     => $this->request->getVar('email')
        ];

        // 执行更新操作
        // 注意：这里必须使用局部变量 $model 调用 update() 方法
        // 原始代码中的 $this->model 是一个常见的错误，它会导致无法找到模型实例而产生致命错误（通常表现为白屏）。
        if ($model->update($id, $data)) {
            // 更新成功，重定向到学生列表页
            return $this->response->redirect(base_url('siswa'))->with('success', '学生信息更新成功。');
        } else {
            // 更新失败，重定向回编辑页并显示错误信息
            // 可以通过 withInput() 保持表单数据，并 with('error', '...') 传递错误消息
            return $this->response->redirect(base_url('siswa/editsiswa/' . $id))->withInput()->with('error', '学生信息更新失败，请重试。');
        }
    }
}

<form method="post" action="<?= base_url() . '/siswa/updateSiswa'; ?>">
    <div class="modal-header">
        <h4 class="modal-title">编辑学生信息</h4>
    </div>
    <div class="modal-body">
        <div class="form-group">
            <label>姓名</label>
            <input type="text" name="nama_user" id="edit_nama" class="form-control" value="<?= esc($siswa['nama_user']); ?>" required>
        </div>
        <div class="form-group">
            <label>地址</label>
            <input type="text" name="alamat" id="edit_alamat" class="form-control" value="<?= esc($siswa['alamat']); ?>" required>
        </div>
        <div class="form-group">
            <label>手机号</label>
            <input type="number" name="hp" id="edit_hp" class="form-control" value="<?= esc($siswa['hp']); ?>" required>
        </div>
        <div class="form-group">
            <label>生日</label>
            <input type="text" name="tgl" id="edit_tgl" class="form-control" value="<?= esc($siswa['tgl']); ?>" required>
        </div>
        <div class="form-group">
            <label>邮箱</label>
            <input type="text" name="email" id="edit_email" class="form-control" value="<?= esc($siswa['email']); ?>" required>
            <!-- 隐藏字段，用于传递待更新记录的ID -->
            <input type="hidden" name="id" id="edit_id" value="<?= esc($siswa['id_user']); ?>" required>
        </div>
    </div>
    <div class="modal-footer">
        <a class="btn btn-dark rounded-0 col-2" href="<?= base_url("/siswa") ?>"><i class="fa fa-angle-left"></i> 返回列表</a>
        <input type="submit" class="btn btn-info" value="更新">
    </div>
</form>