CodeIgniter连接数据库及快速入门

原文:CodeIgniter连接数据库及快速入门

一、数据库配置

  CodeIgniter 有一个配置文件让你存放数据库连接值(username:用户名,password:密码,database name:数据库名,等等..). 该配置文件位于application/config/database.php. 你也可以通过放置不同的database.php文件到特定的环境配置文件夹里来设置特定环境的数据库连接值.

  配件文件存放在一个如下格式的一个多维数组里:

$db[‘default‘][‘hostname‘] = "localhost";
$db[‘default‘][‘username‘] = "root";
$db[‘default‘][‘password‘] = "";
$db[‘default‘][‘database‘] = "database_name";
$db[‘default‘][‘dbdriver‘] = "mysql";
$db[‘default‘][‘dbprefix‘] = "";
$db[‘default‘][‘pconnect‘] = TRUE;
$db[‘default‘][‘db_debug‘] = FALSE;
$db[‘default‘][‘cache_on‘] = FALSE;
$db[‘default‘][‘cachedir‘] = "";
$db[‘default‘][‘char_set‘] = "utf8";
$db[‘default‘][‘dbcollat‘] = "utf8_general_ci";
$db[‘default‘][‘swap_pre‘] = "";
$db[‘default‘][‘autoinit‘] = TRUE;
$db[‘default‘][‘stricton‘] = FALSE;

  我们使用多维数组的原因是为了让你随意的存储多个连接值的设置。举例:如果你运行多个环境(development:开发、production:生产、test:测试 等等..),你能为每个环境建立独立的连接组,并在组直接进行切换。举例,设置一个"test"环境,你可以这样做:

$db[‘test‘][‘hostname‘] = "localhost";
$db[‘test‘][‘username‘] = "root";
$db[‘test‘][‘password‘] = "";
$db[‘test‘][‘database‘] = "database_name";
$db[‘test‘][‘dbdriver‘] = "mysql";
$db[‘test‘][‘dbprefix‘] = "";
$db[‘test‘][‘pconnect‘] = TRUE;
$db[‘test‘][‘db_debug‘] = FALSE;
$db[‘test‘][‘cache_on‘] = FALSE;
$db[‘test‘][‘cachedir‘] = "";
$db[‘test‘][‘char_set‘] = "utf8";
$db[‘test‘][‘dbcollat‘] = "utf8_general_ci";
$db[‘test‘][‘swap_pre‘] = "";
$db[‘test‘][‘autoinit‘] = TRUE;
$db[‘test‘][‘stricton‘] = FALSE;

  那么,告诉系统使用"test"组,你可以设置位于配置文件中的变量:

$active_group = "test";

  注意: "test"的名字是任意的,这可以让你自由设置,我们的主要连接默认使用"default"这个名字,当然,您可以基于您的项目为它起一个更有意义的名字。

Active Record

  Active Record 类 可以通过数据库配置文件里的$active_record变量进行全局的设定(允许/禁止 TRUE/FALSE (boolean)). 如果你不用这个类,那么你可以通过将这个变量值设置成FALSE来减少在数据库类初始化时对电脑资源的消耗。

$active_record = TRUE;

注意: 一些CodeIgniter的类,例如Sessions,在执行一些函数的时候需要Active Records的支持。

参数解析:

  • hostname - 数据库的主机名,通常位于本机,可以表示为 "localhost".
  • username - 需要连接到数据库的用户名.
  • password - 登陆数据库的密码.
  • database - 你需要连接的数据库名.
  • dbdriver - 数据库类型。如:mysql、postgres、odbc 等。必须为小写字母。
  • dbprefix - 当运行Active Record查询时数据表的前缀,它允许在一个数据库上安装多个CodeIgniter程序.
  • pconnect - TRUE/FALSE (boolean) - 使用持续连接.
  • db_debug - TRUE/FALSE (boolean) - 显示数据库错误信息.
  • cache_on - TRUE/FALSE (boolean) - 数据库查询缓存是否开启,详情请见数据库缓存类。
  • cachedir - 数据库查询缓存目录所在的服务器绝对路径。
  • char_set - 与数据库通信时所使用的字符集。
  • dbcollat - 与数据库通信时所使用的字符规则。

    提示: 就MYSQL或MYSQLi数据库而言,如果服务器运行环境PHP版本小于5.2.3、MYSQL版本小于5.0.7,那么该项设置仅被用来备份(由数据库维护类DB Forge所创建查询)。如果使用多字节字符集并且使用低版本PHP环境中不兼容的mysql_real_escape_string()函数,它将使网站更容易受到SQL注入的危险。
  • swap_pre - 替换默认的dbprefix表前缀,该项设置对于分布式应用是非常有用的,你可以在查询中使用由最终用户定制的表前缀。

    提示: 如果设置了 $db[‘default‘][‘dbprefix‘] 的值同时也设置了 $db[‘default‘][‘swap_pre‘] 的值,则会将查询代码中和$db[‘default‘][‘swap_pre‘] 的值一致的字符替换成 $db[‘default‘][‘dbprefix‘] 的值,如果没有设置 $db[‘default‘][‘swap_pre‘] 值,就直接在数据库表名前面加上 $db[‘default‘][‘dbprefix‘] 值。
  • autoinit - 当数据库类库(database library)被载入的时候是否需要自动连接数据库,如果设置为FALSE,将在首次查询前进行连接。
  • stricton - TRUE/FALSE (boolean) - 是否强制使用 "Strict Mode" 连接, 在开发程序时,使用 strict SQL 是一个好习惯。
  • port - 数据库端口号. 要使用这个值,你应该添加一行代码到数据库配置数组。
$db[‘default‘][‘port‘] = 5432;

提示: 并不是所有的值都是必须的,这取决与您所使用的数据库平台,如(MySQL, Postgres, 等.) 例如, 当你使用SQLite时,你不需要提供username或password, 数据库名字就是您数据库文件的路径. 以上内容假定您使用的是 MySQL 数据库。

二、连接数据库

有两种方法连接数据库:

自动连接

“自动连接” 功能将在每一个页面加载时被自动实例化数据库类。要启用“自动连接”,可在application/config/autoload.php中的 library 数组里添加database

$autoload[‘libraries‘] = array(‘database‘);

手动连接

如果仅仅是一部分页面要求数据库连接,你可以在你有需要的函数里手工添加如下代码或者在你的类里手工添加以供该类使用。

$this->load->database();

如果以上函数的第一个参数没有任何信息,它将会在系统指定的数据库配置文件中寻找,对多数人而言,这是一个首选的方法。

可用的参数

  1. 数据库连接值,用数组或DSN字符串传递。
  2. 是否返回连接ID,TRUE/FALSE (boolean),默认值为FALSE (参阅下面的“连接多数据库”)。
  3. 是否启用 Active Record 类,TRUE/FALSE (boolean),默认值为 NULL。如有疑问,请查看/system/core/Loader.php的database()方法

手动连接到一个数据库

函数的第一个参数能够从你的配置文件中自由的指定你自定义的详细的数据库配置信息。或者你甚至可以不通过指定的配置文件来提交数据库的连接属性。样例:

要从你的配置文件中选择一个指定的数组你可以这么做:

$this->load->database(‘group_name‘);

group_name指的是存在于你的配置文件中的带有数据库连接信息的数组的名字。

要手动连接你要求的数据库你可以通过定义以下数组来实现:

$config[‘hostname‘] = "localhost";
$config[‘username‘] = "myusername";
$config[‘password‘] = "mypassword";
$config[‘database‘] = "mydatabase";
$config[‘dbdriver‘] = "mysql";
$config[‘dbprefix‘] = "";
$config[‘pconnect‘] = FALSE;
$config[‘db_debug‘] = TRUE;
$config[‘cache_on‘] = FALSE;
$config[‘cachedir‘] = "";
$config[‘char_set‘] = "utf8";
$config[‘dbcollat‘] = "utf8_general_ci";

$this->load->database($config);

或者你可以以DSN的方式提交数据库配置信息。 DSN必然通过以下方式实现:

$dsn = ‘dbdriver://username:[email protected]/database‘;

$this->load->database($dsn);

当用 DSN 字符串连接时,要覆盖配置默认值,则添加配置变量为查询字符串。

$dsn = ‘dbdriver://username:[email protected]/database?char_set=utf8&dbcollat=utf8_general_ci&cache_on=true&cachedir=/path/to/cache‘;

$this->load->database($dsn);

当你的dbdriver值为mysqli来进行远程连接时,切记要指定一个参数Port为远程mysql端口

连接多数据库

如果你需要同时连接多于一个的数据库,你可以用以下方式来实现:

$DB1 = $this->load->database(‘group_one‘, TRUE);
$DB2 = $this->load->database(‘group_two‘, TRUE); 

注意:改变 "group_one" 和 "group_two" 为你指定了连接属性的组名 (或者通过上边说过的连接数组的数组名)。

通过设置函数的第二个参数为TRUE(boolean)来返回一个数据库对象。

当你使用这种方法,你将用对象名来执行操作命令而不是用户向导模式,也就是说,你将用以下方式执行数据库操作:

$DB1->query();
$DB1->result();
etc...

而不是:

$this->db->query();
$this->db->result();
etc...

译注:要连接多个数据库请先设置 config/database.php 中的 $db[‘xxxxxx‘][‘pconnect‘] = FALSE; 这是
mysql_pconnect() 造成的问题,和 CI 无关。

重新连接 / 保持连接有效

当你正在进行一些重量级的PHP操作(例如处理图片)时,如果超出了数据库服务器的空闲超时限度,你应该考虑在执行更多查询之前使用reconnect()方法来向服务器发送ping命令,这样可以优雅地保持或重新建立连接。

$this->db->reconnect();

手动关闭连接

虽然CodeIgniter 可以智能的管理并自动关闭数据库连接,你仍可以用下面的方法显式的关闭掉。

$this->db->close();

三、数据库快速入门例子代码

下面的内容将简单说明怎样使用数据库。更详细的信息请阅读各个函数的单独介绍页面。

初始化数据库类

下面的代码将依据你的数据库配置载入并初始化数据库类:

$this->load->database();

一旦被载入,你可以在任何地方像这样使用它:

注意: 如果你的所有页面均要求初始化数据库类,你可以让它自动加载。

多结果标准查询(对象形式)

$query = $this->db->query(‘SELECT name, title, email FROM my_table‘);

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

echo ‘Total Results: ‘ . $query->num_rows(); 

上面的result()函数返回一个对象的数组。例如:$row->title

多结果标准查询(数组形式)

$query = $this->db->query(‘SELECT name, title, email FROM my_table‘);

foreach ($query->result_array() as $row)
{
    echo $row[‘title‘];
    echo $row[‘name‘];
    echo $row[‘email‘];
}

上面的result_array()函数返回一个带下标的数组。例如:$row[‘title‘]

测试查询结果

如果你的查询可能不返回结果,我们建议你先使用 num_rows()函数来测试:

$query = $this->db->query("YOUR QUERY");

if ($query->num_rows() > 0)
{
   foreach ($query->result() as $row)
   {
      echo $row->title;
      echo $row->name;
      echo $row->body;
   }
} 

单结果标准查询(对象形式)

$query = $this->db->query(‘SELECT name FROM my_table LIMIT 1‘);

$row = $query->row();
echo $row->name;

上面的row()函数返回一个 对象。例如:$row->name

单结果标准查询(数组形式)

$query = $this->db->query(‘SELECT name FROM my_table LIMIT 1‘);

$row = $query->row_array();
echo $row[‘name‘];

上面的row_array()函数返回一个 数组。例如:$row[‘name‘]

标准插入(insert)

$sql = "INSERT INTO mytable (title, name)
        VALUES (".$this->db->escape($title).", ".$this->db->escape($name).")";

$this->db->query($sql);

echo $this->db->affected_rows(); 

快捷查询

快捷查询类能为我们提供快速取得数据的途径:

$query = $this->db->get(‘table_name‘);

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

上面的get()函数返回数据表中所有的结果。 快捷查询类 提供所有数据库操作的快捷函数。

快捷插入(insert)

$data = array(
               ‘title‘ => $title,
               ‘name‘ => $name,
               ‘date‘ => $date
            );

$this->db->insert(‘mytable‘, $data);

// Produces: INSERT INTO mytable (title, name, date) VALUES (‘{$title}‘, ‘{$name}‘, ‘{$date}‘)

 

时间: 2024-10-08 00:45:09

CodeIgniter连接数据库及快速入门的相关文章

CodeIgniter框架——数据库类(配置+快速入门)

CodeIgniter用户指南——数据库类 数据库配置 入门:用法举例 连接数据库 查询 生成查询结果 查询辅助函数 Active Record 类 事务 表格元数据 字段元数据 自定义函数调用 查询缓存 数据库维护类 数据库工具类 1.数据库配置 CodeIgniter 有一个配置文件让你存放数据库连接值(username:用户名,password:密码,database name:数据库名,等等..). 该配置文件位于application/config/database.php. 你也可以

(推荐)PHP采集工具curl快速入门教程

为什么要用CURL? CURL(Client URL Library Functions)是一个利用URL语法在命令行方式下工作的文件传输工具.它支持很多协议:FTP, FTPS, HTTP, HTTPS, GOPHER,  TELNET, DICT, FILE 以及 LDAP.CURL同样支持HTTPS认证,HTTP POST方法, HTTP PUT方法,FTP 上传, kerberos认证,HTTP上传, 代理服务器, cookies, 用户名/密码认证,下载文件断点续传,上载文件断点续传,

MyBatis 学习总结 01 快速入门 OLD

一.Mybatis介绍 MyBatis是一个支持普通SQL查询,存储过程和高级映射的优秀持久层框架.MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装.MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录.mybatis提供一种“半自动化”的ORM实现.这里的“半自动化”,是相对Hibernate等提供了全面的数据库封装机制的“全自动化”ORM实

python RESTful API框架:Eve 快速入门

Eve是一款Python的REST API框架,用于发布高可定制的.全功能的RESTful的Web服务,帮你轻松创建和部署API,本文翻译自Eve官方网站: http://python-eve.org/quickstart.html#database-interlude Eve 快速入门: 渴望开始吗?这个页面将提供Eve一个很好的介绍.在这之前假设: 你已经安装好了Eve.如果你还没有,可以点击到安装页面. 已经安装了MongoDB. 并且MongoDB 已经运行了. 一个最小的应用 一个最小

Java Web快速入门——全十讲

Java Web快速入门——全十讲 这是一次培训的讲义,就是我在给学生讲的过程中记录下来的,非常完整,原来发表在Blog上,我感觉这里的学生可能更需要. 内容比较长,你可以先收藏起来,慢慢看. 第一讲(参考<Java Web程序设计基础教程>第1章)1 JSP 和 Java的关系 一般Java指的标注版 Java SE   另外两个版本:Java EE 和 Java ME JSP属于Java EE的一部分.   Java EE:     组件:Web层组件(JSP+Servlet)+业务层组件

架构设计:系统间通信(37)——Apache Camel快速入门(中)

========================== (接上文<架构设计:系统间通信(36)--Apache Camel快速入门(上)>) (补上文:Endpoint重要的漏讲内容) 3-1-2.特殊的Endpoint Direct Endpoint Direct用于在两个编排好的路由间实现Exchange消息的连接,上一个路由中由最后一个元素处理完的Exchange对象,将被发送至由Direct连接的下一个路由起始位置(http://camel.apache.org/direct.html)

BIML 101 - ETL数据清洗 系列 - BIML 快速入门教程 - 序

BIML 101 - BIML 快速入门教程 做大数据的项目,最花时间的就是数据清洗. 没有一个相对可靠的数据,数据分析就是无木之舟,无水之源. 如果你已经进了ETL这个坑,而且预算有限,并且有大量的活要做: 时间紧,任务多,是不是有点菊花一紧的感觉. 多少次,你对着几个月前自己写的代码在挠头, 多少次,指着屏幕上别人写的代码目瞪口呆,心中默默数有多少头草泥马.WTF. 不管你是做数据仓库,还是做数据转换,数据集成等等,大量的重复性的工作令人乏味: 但是,如果没有好的设计和遵从一致的流程,后期的

笔记:Spring Cloud Zuul 快速入门

Spring Cloud Zuul 实现了路由规则与实例的维护问题,通过 Spring Cloud Eureka 进行整合,将自身注册为 Eureka 服务治理下的应用,同时从 Eureka 中获取了所有其他微服务的实例信息,这样的设计非常巧妙的将服务治理体系中维护的实例信息利用起来,使得维护服务实例的工作交给了服务治理框架自动完成,而对路由规则的维护,默认会将通过以服务名作为 ContextPath 的方式来创建路由映射,也可以做一些特别的配置,对于签名校验.登录校验等在微服务架构中的冗余问题

javaweb-html快速入门

本文主要是进行HTML简单介绍(详细的属性查帮助文档就行了,这里主要为快速入门,赶时间,在最短的时间中看明白一个html文件的代码(如果能称之为代码的话)详细的样式表,布局啥的有时间再研究吧) HTML 1.html的简介 1.1,html的全称:HyperText Mark-up Language ,超文本标记型语言,是网页的语言. 超文本:比文本更加强大(后面还会讲到XML,可扩展标记性语言) 标记:就是标签,html所有操作都是通过标签直接或间接的操作(把需要操作的数据通过标签封装起来)