本文旨在指导开发者如何在 CodeIgniter 3 框架中，利用外键关系高效地从关联表中检索数据，特别是避免在控制器中直接进行数据库操作，并使用 JOIN 查询优化数据获取过程，以提升应用程序的性能和可维护性。
在 CodeIgniter 3 中，经常需要在不同的表之间建立关系，并通过外键来获取关联的数据。本教程将重点介绍如何使用 JOIN 查询来高效地从关联表中获取所需的数据，并遵循 MVC 架构的最佳实践，将数据库操作放在 Model 层中。
1. 理解数据库结构
假设我们有两个表：donors（捐赠者）和 packets（血包）。packets 表中有一个外键 DonorID，它引用 donors 表的 DonorID 字段。我们的目标是，给定一个 PacketID，获取对应的 DonorName 和 DonorMobile。
donors 表结构：
- DonorID (INT, Primary Key)
- DonorName (VARCHAR)
- DonorMobile (VARCHAR)
- ...
packets 表结构：
- PacketID (INT, Primary Key)
- DonorID (INT, Foreign Key referencing donors.DonorID)
- ...
2. 创建 Model
遵循 MVC 架构，我们将数据库操作封装在 Model 中。创建一个名为 Donor_Model.php 的文件，并添加以下代码：
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Donor_Model extends CI_Model {
public function __construct() {
parent::__construct();
$this->load->database(); // 加载数据库连接
}
/**
* 根据 PacketID 获取捐赠者信息
*
* @param int $packet_id 血包ID
* @return object|null 返回捐赠者信息对象，如果未找到则返回 null
*/
public function get_donor_by_packet_id($packet_id) {
$this->db->select('d.DonorName, d.DonorMobile, p.*');
$this->db->from('packets AS p');
$this->db->join('donors AS d', 'd.DonorID = p.DonorID', 'left'); // 使用 LEFT JOIN 确保即使 DonorID 为空也能返回 packets 信息
$this->db->where('p.PacketID', $packet_id);
$query = $this->db->get();
return $query->row(); // 返回单个结果对象
}
public function markAsUsed($donor_id)
{
$data = $this->db->get_where('donors', array('DonorID' => $donor_id));
return $data->row();
}
public function changeStatus($packet_id)
{
$data = array(
'isAvailable' => False,
);
return $this->db->update('packets', $data, ['PacketID' => $packet_id]);
}
}代码解释：
- $this->db->select()：指定要选择的字段，包括 donors 表的 DonorName 和 DonorMobile，以及 packets 表的所有字段（p.*）。
- $this->db->from('packets AS p')：指定主表为 packets，并使用别名 p。
- $this->db->join('donors AS d', 'd.DonorID = p.DonorID', 'left')：使用 JOIN 子句将 donors 表（别名 d）和 packets 表连接起来，连接条件是 d.DonorID = p.DonorID。left 参数指定使用 LEFT JOIN，这意味着即使 packets 表中的 DonorID 在 donors 表中没有匹配项，也会返回 packets 表的信息。
- $this->db->where('p.PacketID', $packet_id)：添加 WHERE 子句，根据 PacketID 过滤结果。
- $query->row()：返回查询结果的第一行，以对象的形式。
3. 在 Controller 中使用 Model
现在，在你的 Controller 中加载 Donor_Model，并调用 get_donor_by_packet_id() 方法：
<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Staff extends CI_Controller {
public function __construct() {
parent::__construct();
$this->load->model('Donor_Model');
}
public function markAsUsed($packet_id) {
// 获取捐赠者信息
$donor_data = $this->Donor_Model->get_donor_by_packet_id($packet_id);
if ($donor_data) {
// 现在可以直接访问 $donor_data 的属性，例如：
$donor_name = $donor_data->DonorName;
$donor_mobile = $donor_data->DonorMobile;
// 发送短信
$sid = 'twilio sid';
$token = 'twilio token';
$donorMobile = '+94' . $donor_data->DonorMobile;
$twilioNumber = 'twilio number';
$client = new Twilio\Rest\Client($sid, $token);
$message = $client->messages->create(
$donorMobile, array(
'from' => $twilioNumber,
'body' => 'Thank you ' . $donor_data->DonorName . ' for your blood donation. Your donation has just saved a life.'
)
);
if ($message->sid) {
$this->load->Model('Donor_Model');
$this->Donor_Model->changeStatus($packet_id);
redirect('staff/viewpackets');
}
} else {
// 处理未找到捐赠者的情况
echo "未找到该血包的捐赠者信息";
}
}
}代码解释：
- $this->load->model('Donor_Model')：加载 Donor_Model。
- $donor_data = $this->Donor_Model->get_donor_by_packet_id($packet_id)：调用 Model 中的方法，传入 PacketID，获取捐赠者信息。
- $donor_name = $donor_data->DonorName; 和 $donor_mobile = $donor_data->DonorMobile;：直接从 $donor_data 对象中获取 DonorName 和 DonorMobile。
4. 总结与注意事项
- 使用 JOIN 查询： JOIN 查询是在数据库层面进行关联，比在 PHP 代码中循环查询效率更高，尤其是在数据量大的情况下。
- MVC 架构： 将数据库操作放在 Model 中，保持 Controller 的简洁，提高代码的可维护性。
- 错误处理： 在 Controller 中添加错误处理，例如当 PacketID 不存在时，给出相应的提示。
- 安全性： 注意对输入参数进行验证和过滤，防止 SQL 注入等安全问题。
通过以上步骤，你可以在 CodeIgniter 3 中使用外键和 JOIN 查询，高效地从关联表中获取数据，并遵循 MVC 架构的最佳实践。 记住始终将数据库操作放在 Model 层，以提高代码的可维护性和性能。
