快速入门：使用示例

本页面包含展示数据库类如何使用的示例代码。更多详细信息，请阅读描述各个函数的独立页面。

备注

CodeIgniter 不支持在表名和列名中使用点号（.）。 从 v4.5.0 版本开始，数据库名称支持使用点号。

初始化数据库类

以下代码根据你的 配置 设置加载并初始化数据库类：

<?php

$db = \Config\Database::connect();

加载后，该类即可按以下所述方式使用。

备注

如果你所有的页面都需要数据库访问，你可以自动连接。 详情请参阅 连接数据库 页面。

标准查询（多结果，对象版本）

<?php

$query   = $db->query('SELECT name, title, email FROM my_table');
$results = $query->getResult();

foreach ($results as $row) {
    echo $row->title;
    echo $row->name;
    echo $row->email;
}

echo 'Total Results: ' . count($results);

上述 getResult() 函数返回一个 对象 数组。

示例：$row->title

标准查询（多结果，数组版本）

<?php

$query   = $db->query('SELECT name, title, email FROM my_table');
$results = $query->getResultArray();

foreach ($results as $row) {
    echo $row['title'];
    echo $row['name'];
    echo $row['email'];
}

上述 getResultArray() 函数返回一个关联数组的数组。

示例：$row['title']

标准查询（单个结果）

<?php

$query = $db->query('SELECT name FROM my_table LIMIT 1');
$row   = $query->getRow();
echo $row->name;

上述 getRow() 函数返回一个 对象。示例：$row->name

标准查询（单个结果，数组版本）

<?php

$query = $db->query('SELECT name FROM my_table LIMIT 1');
$row   = $query->getRowArray();
echo $row['name'];

上述 getRowArray() 函数返回一个 关联数组。示例： $row['name']。

标准插入

<?php

$sql = 'INSERT INTO mytable (title, name) VALUES (' . $db->escape($title) . ', ' . $db->escape($name) . ')';
$db->query($sql);
echo $db->affectedRows();

查询构建器查询

查询构建器 为你提供了一种简化的数据检索方式：

<?php

$query = $db->table('table_name')->get();

foreach ($query->getResult() as $row) {
    echo $row->title;
}

上述 get() 函数从指定的表中检索所有结果。查询构建器 类包含一套完整的用于处理数据的函数。

查询构建器插入

<?php

$data = [
    'title' => $title,
    'name'  => $name,
    'date'  => $date,
];

$db->table('mytable')->insert($data);
// Produces: INSERT INTO mytable (title, name, date) VALUES ('{$title}', '{$name}', '{$date}')