教程 − 读取新闻条目

在上一节中,我们通过如何写出一个包含静态页面的类来了解了一些这个框架的基本概念。我们也根据自定义路由规则重新梳理了URI。现在是时候向大家介绍动态内容和如何使用数据库了。

创建你的数据模型

数据库的运算并不是在控制类中进行的,而是在数据模型中,这样他们就可以在后面很容易地被反复使用。数据模型就是对你的数据库或其他数据存储方式进行取回、插入和更新的地方,它们的功能是展示你的数据(They represent your data)。

打开 application/models 文件夹新建一个文件 news_model.php ,代码如下。确保你已经按照 这里的说明配置了自己的数据库并且数据库服务器与PHP.ini有相应配置。

  1. <?php
  2. class News_model extends CI_Model {
  3.  
  4. public function __construct()
  5. {
  6. $this->load->database();
  7. }
  8. }

这段代码和早前写过的控制器的代码类似。它创建了一个继承 CIModel 的数据模型,并用来载入数据库。通过 $this->db_ 对象就可以使用数据库类了。

在对数据库进行查询前,我们要先建一个数据表。连接你的数据库并执行下面的 SQL 命令,并在里面加些内容。

  1. CREATE TABLE news (
  2. id int(11) NOT NULL AUTO_INCREMENT,
  3. title varchar(128) NOT NULL,
  4. slug varchar(128) NOT NULL,
  5. text text NOT NULL,
  6. PRIMARY KEY (id),
  7. KEY slug (slug)
  8. );

现在数据库和数据模型都设置好了,我们需要一个方法来把我们的文章从数据库中读取出来。数据库抽象层已经包含在CodeIgniter的 Active Record模式 中了。这样可以确保只写一次查询就可以应用到 所有的数据库系统上。在你的数据库模型中添加如下代码。

  1. public function get_news($slug = FALSE){
  2. if ($slug === FALSE)
  3. {
  4. $query = $this->db->get('news');
  5. return $query->result_array();
  6. }
  7.  
  8. $query = $this->db->get_where('news', array('slug' => $slug));
  9. return $query->row_array();
  10. }

通过上面的代码可以实现两个不同的查询,你可以得到所有的新闻纪录,也可以通过 slug得到某一篇新闻。你可能注意到了 $slug 变量在查询前并没有被检验过(sanitized),因为Active Record类已经把这个工作做完啦。

显示新闻

既然查询已经写完了,我们就要把这个数据模型和用来显示新闻内容的视图联系起来了。其实这个工作在我们之前写的pages控制类中就可以实现,但为了更清楚地向大家说明,我们来定义一个新的news控制类 application/controllers/news.php,代码如下。

  1. <?php
  2. class News extends CI_Controller {
  3.  
  4. public function __construct()
  5. {
  6. parent::__construct();
  7. $this->load->model('news_model');
  8. }
  9.  
  10. public function index()
  11. {
  12. $data['news'] = $this->news_model->get_news();
  13. }
  14.  
  15. public function view($slug)
  16. {
  17. $data['news_item'] = $this->news_model->get_news($slug);
  18. }
  19. }

看看上面的代码就会发现和我们之前写过的文件相似。首先,_construct方法是父级类 (_CI_Controller) 的构造函数,并调用了数据模型,这样这个控制器中的其他方法就能使用那个数据模型了。

其次,这里有两个方法分别用来显示所有的新闻和某一条。在第二个方法中可以看到 $slug 变量被传递给了数据模型中的方法。数据模型就是用这个slug来确定需要返回哪一篇文章的。

现在通过数据模型,数据已经被控制器获得了,但还无法显示出来。下面我们就要把数据传递给视图了。

  1. public function index(){
  2. $data['news'] = $this->news_model->get_news();
  3. $data['title'] = 'News archive';
  4.  
  5. $this->load->view('templates/header', $data);
  6. $this->load->view('news/index', $data);
  7. $this->load->view('templates/footer');
  8. }

上面的代码从数据模型中获得了所有新闻的记录,并把它们赋值给了一个变量。页面的标题也赋给了 $data['title'] ,这些所有的数据都会传递给视图。现在你需要创建一个视图来显示这些新闻。新建 application/views/news/index.php 代码如下。

  1. <?php foreach ($news as $news_item): ?>
  2.  
  3. <h2><?php echo $news_item['title'] ?></h2>
  4. <div class="main">
  5. <?php echo $news_item['text'] ?>
  6. </div>
  7. <p><a href="http://[你的域名]/index.php/news/<?php echo $news_item['slug'] ?>">View article</a></p>
  8.  
  9. <?php endforeach ?>

在这里,每条新闻都被循环出来展示给读者了。你可以看到我们的模板是用PHP和HTML混着写的,如果你更喜欢用模板语言的话,你可以用CodeIgniter的 模板解析器类 或者第三方模板解析器(模板引擎)。

新闻概述页面已经做好了,现在还缺少每一篇文章的页面。之前写好的数据模型现在就可以非常简单地用来实现这个功能啦。你只需要添加一些代码到控制器并且创建一个视图。把下面的代码添加到news控制器中。

public function view($slug){
  $data['news_item'] = $this->news_model->get_news($slug);

  if (empty($data['news_item']))
  {
    show_404();
  }

  $data['title'] = $data['news_item']['title'];

  $this->load->view('templates/header', $data);
  $this->load->view('news/view', $data);
  $this->load->view('templates/footer');
}

这里,$slug 变量作为参数传递给了 get_news() 方法,这样就可以返回特定的某一篇文章了。现在剩下的一件事就是创建视图 application/views/news/view.php了,代码如下。

<?php
echo '<h2>'.$news_item['title'].'</h2>';
echo $news_item['text'];

设置路由

因为之前设置了通配符路由规则,现在你需要额外的路由来显示刚刚写的控制器。按照下面的代码修改你的路由文件 (application/config/routes.php) ,这样就确保了请求调用的是news控制器而不是之前设置的pages控制器。第一行代码表示的是控制器中通过slug读取的那条新闻。

$route['news/(:any)'] = 'news/view/$1';
$route['news'] = 'news';
$route['(:any)'] = 'pages/view/$1';
$route['default_controller'] = 'pages/view';

把浏览器的地址改回根目录,在后面加上 index.php/news 来看看你的新闻页面吧。

翻译贡献者:250351515, csfhc, Hex, irini, kphcdr, odissey, scncpb, tongjingcheng, 就是欠揍