本文档旨在指导开发者如何使用 CodeIgniter 3 框架，通过外键关联高效地从数据库表中获取所需数据。重点讲解如何使用 JOIN 查询替代低效的循环查询，从而优化数据获取性能，并强调在 Model 层进行数据库操作的 MVC 设计原则。
在 CodeIgniter 3 中，当需要在关联的两个或多个表中获取数据时，尤其是在使用外键关联的情况下，使用 JOIN 查询是一种高效且推荐的方法。避免在控制器中直接进行数据库操作，并遵循 MVC (Model-View-Controller) 架构，将数据获取逻辑封装在 Model 层中，可以提高代码的可维护性和可重用性。
1. 创建 Model
首先，创建一个 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 PacketID
* @return object|null 返回包含捐赠者信息的对象，如果未找到则返回 null
*/
public function get_donor_by_packet_id($packet_id) {
$this->db->select('donors.DonorName, donors.DonorMobile, packets.*');
$this->db->from('packets');
$this->db->join('donors', 'donors.DonorID = packets.DonorID');
$this->db->where('packets.PacketID', $packet_id);
$query = $this->db->get();
return $query->row(); // 返回单行结果，如果未找到则返回 null
}
/**
* 标记 Packet 为已使用
*
* @param int $packet_id PacketID
* @return bool 返回是否更新成功
*/
public function mark_as_used($packet_id) {
$data = array('isAvailable' => FALSE);
$this->db->where('PacketID', $packet_id);
return $this->db->update('packets', $data); // 返回 TRUE/FALSE 表示更新是否成功
}
/**
* 改变 Packet 的状态
*
* @param int $packet_id PacketID
* @return bool 返回是否更新成功
*/
public function change_status($packet_id) {
$data = array('isAvailable' => FALSE);
$this->db->where('PacketID', $packet_id);
return $this->db->update('packets', $data); // 返回 TRUE/FALSE 表示更新是否成功
}
}2. 使用 JOIN 查询
在 get_donor_by_packet_id 方法中，使用 JOIN 查询将 donors 表和 packets 表连接起来。$this->db->join('donors', 'donors.DonorID = packets.DonorID') 指定了连接条件，即 donors 表的 DonorID 字段与 packets 表的 DonorID 字段相等。
3. 在 Controller 中调用 Model
在 Controller 中，加载 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'); // 加载 Donor_Model
}
public function markAsUsed($packet_id) {
// 获取捐赠者信息
$donor_data = $this->Donor_Model->get_donor_by_packet_id($packet_id);
if ($donor_data) {
// 发送短信
$sid = 'twilio sid';
$token = 'twilio token';
$donor_mobile = '+94' . $donor_data->DonorMobile;
$twilio_number = 'twilio number';
$client = new Twilio\Rest\Client($sid, $token);
$message = $client->messages->create(
$donor_mobile,
array(
'from' => $twilio_number,
'body' => 'Thank you ' . $donor_data->DonorName . ' for your blood donation. Your donation has just saved a life.'
)
);
if ($message->sid) {
// 标记为已使用
$this->Donor_Model->change_status($packet_id);
redirect('staff/viewpackets');
} else {
// 处理短信发送失败的情况
echo "短信发送失败";
}
} else {
// 处理未找到捐赠者信息的情况
echo "未找到 Packet ID 为 " . $packet_id . " 的捐赠者信息";
}
}
}4. 注意事项
- 数据验证： 在 Controller 中，始终要验证从 Model 获取的数据是否存在，以避免空指针异常。
- 错误处理： 在实际应用中，需要添加更完善的错误处理机制，例如记录日志、显示友好的错误信息等。
- 安全性： 确保对输入数据进行适当的验证和过滤，以防止 SQL 注入等安全问题。
- 性能优化： 对于大型数据集，可以考虑使用索引来提高查询性能。
总结
通过使用 JOIN 查询，可以有效地从关联的表中获取数据，避免了低效的循环查询。遵循 MVC 架构，将数据操作逻辑封装在 Model 层中，可以提高代码的可维护性和可重用性。在实际开发中，还需要注意数据验证、错误处理和安全性等方面的问题。
