CodeIgniter 具有非常容易使用的 分页类 。在本教程中我会做一个从数据库返回一组结果并分页这些结果的简单例子。我将使用最新版本的 CI,写这篇文章时的版本是 1.5.1 。分页类并没有修改(至少我认为没有),用最新的稳定版框架总是好的。现在,让我们开始吧。
配置和数据库设置
很好,一切正常,当我们开始写一个 CI 应用程序时,我们要设置很多东西。我们首先打开 config.php 文件(可在 /system/application/config/ 中找到)。在这里我们将输入站点根 URL。这是我的设置:
1
|
$config['base_url'] = "http://localhost/~yannick/pagination/";
|
这个应用程序将使用一个数据库,所以我们下一步的工作是创建数据库,然后再以 CI 访问我们的数据库。要做到这一点请打开 database.php ,这也定位在你的 config 文件夹 中,并填写必要的信息,以便连接到你的数据库。您可以下载“例子代码”:如果你愿意可以使用例子代码和我的例子数据库。这将创建一个名为“ christian_books ”的表,并插入一些测试数据。同时,我想你现在可以猜一猜分页后是什么样?如果你猜对了一些“Christian Books”,你将是正确的。
控制器
我们的基本配置文件和数据库设置已经完成,现在我们需要创建一个控制器。我将它命名为“ books.php ”,并且它将包含下列代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
|
class Books extends Controller {
function __construct() {
parent::Controller();
$this->load->helper('url');
$this->load->database();
}
function index() {
// load pagination class
$this->load->library('pagination');
$config['base_url'] = base_url().'index.php/books/index/';
$config['total_rows'] = $this->db->count_all('christian_books');
$config['per_page'] = '5';
$config['full_tag_open'] = '<p>';
$config['full_tag_close'] = '</p>';
$this->pagination->initialize($config);
//load the model and get results
$this->load->model('books_model');
$data['results'] = $this->books_model->get_books($config['per_page'],$this->uri->segment(3));
// load the HTML Table Class
$this->load->library('table');
$this->table->set_heading('ID', 'Title', 'Author', 'Description');
// load the view
$this->load->view('books_view', $data);
}
}
|
首先,我们在构造函数中装载 URL 辅助函数 和数据库。当然,你不一定要创建一个构造函数并装载这些辅助函数,因为它可以很容易的在控制器中的其它函数/方法中装载,但是,如果辅助函数将用于控制器中的大多数/所有方法的话,我通常倾向于创建一个构造函数并把它们放在里面。
其次,我们创建了一个名为 index() 的方法。这是一个非常基本的应用程序,正因如此,我们将只需要这种单一的方法,使我们装载分页类,模型和 HTML 表格类(我们稍后将讨论的内容) 。
让我们开始吧!你会看到非常简单的使用分页类的方法。首先,我们配置要分页页面的 URL:
1
|
$config['base_url'] = base_url().'index.php/books/index/';
|
然后,我们设置数据库中的总行数:
1
|
$config['total_rows'] = $this->db->count_all('christian_books');
|
$config['per_page'] 变量简单地告诉分页类每页显示多少条记录。$config['full_tag_open'] 和 $config['full_tag_close'] 变量说明使用什么标签包围分页链接。
接下来,我们装载模型,我们将执行其中的一个方法:get_books()。它有两个参数,limit,这决定了每页显示多少项目,offset,它表示从哪行开始返回记录。你会发现,第一个参数(limit)从 $config['per_page'] 变量中取值,而第二个参数则通过 URL 辅助函数,从 URL 的第三段中取值:$this->uri->segment(3)。后者是这里非常有趣的原因。CI 的 URL 通常采取以下形式, www.your-site.com/index.php/class/function/ID ,所以大家可以看到第三段(index.php 的后面)代表 ID。所以允许采用如下的 URL:
http://localhost/~yannick/pagination/index.php/books/index/10
URL 第三段的 10 将被插入到我们模型函数的第二个参数中:get_books(5, 10),它表示偏移量(offset)。因此,我们的结果将返回数据库中前 10 条记录的后 5 条记录(因为根据前面的代码,我们每页显示 5 条记录)。非常妙,对不对?好了,我们先在停在这里休息一下,更详细的内容将在下一节中。
现在,这里有一些新东西。在这里,我们装载 HTML 表格类 ,这是新添加到 CI 1.5.0 版本中的。这个类允许你从数组或数据库结果中生成 HTML 表格。你可以进行相当多的定制,但在这个例子中,我使用他基本形式中的一种:我明确的指明表格的头部应该是什么。
1
|
$this->table->set_heading('ID', 'Title', 'Author', 'Description');
|
最后,我们装载“视图”,并传递给它我们将用到的任何数据。都做好后,我们的控制器就完成了。现在,让我们来看看我们的模型,看看怎样在分页中发挥它的威力。
模型
OK,这时候模型就开始重新调用你数据库里的信息了。在这个分页教程中,我们的模型将包含一个方法,它基于页面上的用户请求,从数据库中获取正确的结果。正如你所看到的,控制器方法有两个参数,一个 limit 和另一个 offset。然后,我们创建一个文件,命名为“ books_model.php ”,并在文件中输入下列代码:
1
2
3
4
5
6
7
8
9
10
|
class books_model extends Model {
function __construct(){
parent::Model();
}
function get_books($num, $offset) {
$query = $this->db->get('christian_books', $num, $offset);
return $query;
}
}
|
1
|
$query = $this->db->get('christian_books', $num, $offset);
|
1
|
SELECT * FROM christian_books LIMIT 10, 5
|
我们已经完成了 2/3 了,最后事情是,我们要创建视图。
视图
记住,一个视图就是一个简单的 Web 页面或页面片段。所以,在这里我们的视图是一个在表格里显示图书的 Web 页面。让我们来看看代码:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en-us" lang="en-us">
<head>
<meta http-equiv="content-type" c />
<link rel="stylesheet" href='<?php echo base_url(); ?>css/main.css' type="text/css" media="screen, projection" />
<title>CodeIgniter Pagination Tutorial</title>
</head>
<body>
<h1>Christian Books</h1>
<?php echo $this->table->generate($results); ?>
<?php echo $this->pagination->create_links(); ?>
</body>
</html>
|
1
|
$this->table->generate($results);
|
1
|
$this->pagination->create_links();
|
« First < 1 2 3 4 5 > Last »
现在访问你的页面,并在显示页码的地方开心的玩一玩。你也可以从一页切换到另一页,看看 URL 是怎样变化的,并且 URL 的第三段表示显示在表格中结果的偏移量。
总结
好了,上面我简单介绍了分页类,正如你看到的,添加分页功能到你的 CI 应用程序并不难。我也介绍了在 1.5.0 版本中新添加的 HTML 表格类,并且它也不是很难。这个类库使我们可以快速的创建 HTML 表格,以显示我们的结果。
就这样了,我希望你在享受本教程的同时,会发现它内容翔实并对你有帮助。如果你有兴趣学习如何在没有 CI 框架帮助的情况下,在 PHP 中做分页程序,那么,我建议你看看 Jonathan Sampson 制作的 分页视频 .
世界和平,上帝保佑。
下载例子代码: ci_pagination_tut.zip
原文: http://godbit.com/article/pagination-with-code-igniter
翻译: CodeIgniter 中国
鸣谢: CodeIgniter 中国开发者社区 的朋友们!