Membangun Feed RSS 2.0 dengan CodeIgniter

() translation by (you can also view the original English article)

Dalam tutorial ini, kami akan membangun Feed RSS 2.0 dengan kerangka PHP CodeIgniter. Setelah tutorial ini, Anda akan dapat membuat feed untuk situs web kustom apa pun dalam waktu singkat.

Detail Tutorial

Program: Kerangka PHP CodeIgniter
Versi: 1.7.1
Kesulitan: Mudah
Perkiraan Waktu Penyelesaian: 30 menit

Langkah 1: Apa yang Kita Butuhkan

Pertama, kita akan melihat alat yang dibutuhkan untuk memulai. Selain instalasi CodeIgniter, kita memerlukan database MySQL yang berjalan dengan beberapa konten dari mana kita dapat membangun feed kita.

Untuk tujuan ini, berikut beberapa entri dummy yang dapat Anda impor. Buat database yang disebut tut_feeds. Kemudian, salin kode berikut, dan impor ke dalam database MySQL Anda.

    CREATE TABLE IF NOT EXISTS `posts` (
      `id` int(11) NOT NULL AUTO_INCREMENT,
      `title` varchar(120) NOT NULL,
      `text` text NOT NULL,
      `date` date NOT NULL,
      PRIMARY KEY (`id`)
    ) ENGINE=MyISAM;
    
    INSERT INTO `posts` (`id`, `title`, `text`, `date`) VALUES
    (1, 'Some great article', 'It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters, as opposed to using ''Content here, content here'', making it look like readable English. Many desktop publishing packages and web page editors now use Lorem Ipsum as their default model text, and a search for ''lorem ipsum'' will uncover many web sites still in their infancy. Various versions have evolved over the years, sometimes by accident, sometimes on purpose (injected humour and the like).', '2009-08-10'),
    (2, 'Another great article', 'It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters, as opposed to using ''Content here, content here'', making it look like readable English. Many desktop publishing packages and web page editors now use Lorem Ipsum as their default model text, and a search for ''lorem ipsum'' will uncover many web sites still in their infancy. Various versions have evolved over the years, sometimes by accident, sometimes on purpose (injected humour and the like).', '2009-08-10'),
    (3, 'News from myfeed', 'It is a long established fact that a reader will be distracted by the readable content of a page when looking at its layout. The point of using Lorem Ipsum is that it has a more-or-less normal distribution of letters, as opposed to using ''Content here, content here'', making it look like readable English. Many desktop publishing packages and web page editors now use Lorem Ipsum as their default model text, and a search for ''lorem ipsum'' will uncover many web sites still in their infancy. Various versions have evolved over the years, sometimes by accident, sometimes on purpose (injected humour and the like).', '2009-08-10');

Ini adalah bagaimana seharusnya muncul di phpmyadmin. Setelah Anda memasukkan kode, tekan tombol Ok di sisi kanan.

Jika semuanya berjalan dengan benar, Anda akan melihat sesuatu seperti ini:

Langkah 2: Menyiapkan CodeIgniter

Sebelum kita mulai menulis kode, kita perlu mengkonfigurasi CodeIgniter.

Telusuri ke folder CI Anda, dan kemudian ke dalam system/application/config. Kita perlu mengedit file-file berikut:

autoload.php
config.php
database.php
routes.php

Edit autoload.php seperti ini:

1	$autoload['libraries'] = array('database');

Ini akan memberitahu CI untuk memuat database secara otomatis; jadi kita tidak perlu memuatnya setiap saat.

Edit config.php seperti ini:

1	$config['base_url'] = "http://localhost/YOUR DIRECTORY";

Anda perlu mengganti tutorials/ci_feeds dengan direktori dan folder CI Anda.

Edit database.php seperti ini:

1	$db['default']['hostname'] = "localhost"; // your host
2	$db['default']['username'] = "root";
3	$db['default']['password'] = "";
4	$db['default']['database'] = "tut_feeds";

Dengan pengaturan ini, kita memberi tahu CI database mana yang akan digunakan. Di sini Anda juga harus mengganti hostname, username dan
password dengan info database pribadi Anda.

Edit routes.php seperti ini:

1	$route['default_controller'] = "Feed";

Controller default adalah controller "index" untuk aplikasi Anda. Setiap kali Anda membuka
localhost/YOUR DIRECTORY, controller default ini akan dimuat pertama kali. Kita akan membuat feed di langkah berikutnya.

Langkah 3: Membuat Controller Feed

Dalam controller ini, semua keajaiban terjadi. Jelajahi ke system/application/controllers dan buat file baru
bernama feed.php. Selanjutnya, buat controller Feed dan memperpanjang induk CI Controller.

	class Feed extends Controller {
      
      function Feed()
      {
		parent::Controller();
      }
}

Jika Anda sudah bingung silakan lihat milik Jeffrey
tutorial Pengembangan Mudah dengan CodeIgniter.
Setelah Anda mempelajari dasar-dasarnya, kembalilah untuk melanjutkan tutorial ini! :)

Sebelum langkah berikutnya, kami akan memanfaatkan helper CI yang hebat. Muat helper xml dan text.

class Feed extends Controller {
      
      function Feed()
      {
        parent::Controller();
        
        $this->load->helper('xml');
		$this->load->helper('text');
      }
}

Langkah 4: Membuat Model

Selanjutnya, akan membuat model untuk menerima data dari database. Jika Anda tidak tahu apa itu model, lihatlah
panduan pengguna CI. Jelajahi ke system/application/models
dan buat file bernama posts_model.php.

class Posts_model extends Model {
	
	// get all postings
	function getPosts($limit = NULL)
	{
		return $this->db->get('posts', $limit);
	}
}

Kami menggunakan active records untuk menerima data
dari database. Parameter pertama mendeklarasikan tabel yang ingin kita gunakan dan dengan yang kedua kita dapat menetapkan batas - jadi kita
dapat memberi tahu CI berapa banyak record yang ingin kita ambil.

Mungkin Anda telah memperhatikan bahwa $limit diatur ke NULL secara default. Ini memungkinkan untuk menetapkan batas, tetapi Anda tidak harus melakukannya.
Jika Anda tidak mengatur parameter kedua, fungsi ini hanya akan mengembalikan semua record.

Langkah 5: Kembali ke Controller Feed

Sekarang setelah kita membuat model kita, kita dapat melanjutkan dengan controller feed kami. Kita akan memuat posts_model yang baru kita buat.

class Feed extends Controller {
      
      function Feed()
      {
        parent::Controller();
        
        $this->load->helper('xml');
		$this->load->helper('text');
        $this->load->model('posts_model', 'posts');
      }
}

Dengan parameter kedua, kami menetapkan model kami ke nama objek yang berbeda - jadi kami memiliki lebih sedikit untuk mengetik :P. Sekarang kita buat metode index
yang merupakan metode yang dipanggil secara default.

	function index()
	{
		$data['feed_name'] = 'MyWebsite.com'; // your website
		$data['encoding'] = 'utf-8'; // the encoding
        $data['feed_url'] = 'http://www.MyWebsite.com/feed'; // the url to your feed
        $data['page_description'] = 'What my site is about comes here'; // some description
        $data['page_language'] = 'en-en'; // the language
        $data['creator_email'] = 'mail@me.com'; // your email
        $data['posts'] = $this->posts->getPosts(10);  
        header("Content-Type: application/rss+xml"); // important!
	}

Mari kita menyiapkan beberapa informasi untuk view feed nanti juga.Meskipun sebagian besar informasi di atas mudah dimengerti, kita akan melihat dua di antaranya.
header("Content-Type: application/rss+xml"); adalah bagian yang sangat penting. Ini memberitahu browser untuk mengurainya sebagai
sebuah Feed RSS. Jika tidak, browser akan mencoba mengurainya sebagai teks biasa atau html.

Dengan $data['posts'] = $this->posts->getPosts(10); kami menggunakan model kami dan menyimpan semua record dalam array $posts.
Saya menetapkan batas hingga 10; jadi itu akan mengembalikan, paling banyak, 10 record. Anda dapat menetapkan nilai ini lebih tinggi atau lebih rendah jika Anda mau. Jika kita tinggalkan
kosong, seperti $data['posts'] = $this->posts->getPosts();, itu akan mengembalikan semua record.

Akhirnya, kita perlu memuat view yang akan kita buat di langkah berikutnya.

	function index()
	{
		$data['feed_name'] = 'MyWebsite.com'; 
		$data['encoding'] = 'utf-8'; // the encoding
        $data['feed_url'] = 'http://www.MyWebsite.com/feed'; 
        $data['page_description'] = 'What my site is about comes here'; 
        $data['page_language'] = 'en-en'; 
        $data['creator_email'] = 'mail@me.com';
        $data['posts'] = $this->posts->getPosts(10);  
        header("Content-Type: application/rss+xml"); 
        
        $this->load->view('rss', $data);
	}

Array $data kita dilewatkan sebagai parameter kedua ke file view, sehingga kita dapat mengaksesnya dalam view.
Controller feed Anda seharusnya sekarang terlihat seperti ini:

class Feed extends Controller {
	
	function Feed()
	{
		parent::Controller();
		
		$this->load->helper('xml');
		$this->load->helper('text');
        $this->load->model('posts_model', 'posts');
	}
	
	function index()
	{
		$data['feed_name'] = 'MyWebsite.com';
		$data['encoding'] = 'utf-8';
        $data['feed_url'] = 'http://www.MyWebsite.com/feed';
        $data['page_description'] = 'What my site is about comes here';
        $data['page_language'] = 'en-en';
        $data['creator_email'] = 'mail@me.com';
        $data['posts'] = $this->posts->getPosts(10);    
        header("Content-Type: application/rss+xml");
		
		$this->load->view('rss', $data);
	}
	
}

Langkah 6: Membuat View

Akhirnya kita harus membuat file view - keluaran kita. Jelajahi ke system/application/views dan buat file yang disebut
rss.php.

Pertama kita mengatur versi xml dan pengkodean di dalam head.

1	<?php echo '<?xml version="1.0" encoding="' . $encoding . '"?>' . "\n"; ?>

Diikuti oleh beberapa informasi meta rss.

    <rss version="2.0"
        xmlns:dc="http://purl.org/dc/elements/1.1/"
        xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
        xmlns:admin="http://webns.net/mvcb/"
        xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
        xmlns:content="http://purl.org/rss/1.0/modules/content/">
    
        <channel>

Sekarang kita akan mengakses array $data dari langkah sebelumnya. Kita dapat mengakses data ini melalui kunci array, seperti:

    <title><?php echo $feed_name; ?></title>

    <link><?php echo $feed_url; ?></link>
    <description><?php echo $page_description; ?></description>
    <dc:language><?php echo $page_language; ?></dc:language>
    <dc:creator><?php echo $creator_email; ?></dc:creator>

    <dc:rights>Copyright <?php echo gmdate("Y", time()); ?></dc:rights>
    <admin:generatorAgent rdf:resource="http://www.codeigniter.com/" />

Sekarang kita perlu melakukan perulangan, dengan foreach, untuk mendapatkan semua record.

    <?php foreach($posts->result() as $post): ?>
    
       <item>

          <title><?php echo xml_convert($post->title); ?></title>
          <link><?php echo site_url('YOUR URL' . $post->id) ?></link>
          <guid><?php echo site_url('YOUR URL' . $post->id) ?></guid>

          	<description><![CDATA[ <?php echo character_limiter($post->text, 200); ?> ]]></description>
			<pubDate><?php echo $post->date; ?></pubDate>
        </item>

        
    <?php endforeach; ?>
	
    	</channel>
	<</rss>

Untuk link dan guide, Anda harus menetapkan tautan ke controller Anda tempat posting diambil. Sebagai contoh: my/posts/$post->id.

Saya harap Anda memperhatikan CDATA. Ini digunakan untuk text-output (konten). Ingat bagaimana kita belajar di head bahwa ini adalah xml;
jadi harus xml yang valid. Jika kami tidak menetapkan CDATA, kami berpotensi menghasilkan markup yang tidak valid.

Langkah 7: Gambaran

Sekarang file Anda akan terlihat seperti ini:

system/application/controllers/feed.php

class Feed extends Controller {
	
	function Feed()
	{
		parent::Controller();
		
		$this->load->helper('xml');
		$this->load->helper('text');
        $this->load->model('posts_model', 'posts');
	}
	
	function index()
	{
		$data['feed_name'] = 'MyWebsite.com';
		$data['encoding'] = 'utf-8';
        $data['feed_url'] = 'http://www.MyWebsite.com/feed';
        $data['page_description'] = 'What my site is about comes here';
        $data['page_language'] = 'en-en';
        $data['creator_email'] = 'mail@me.com';
        $data['posts'] = $this->posts->getPosts(10);    
        header("Content-Type: application/rss+xml");
		
		$this->load->view('rss', $data);
	}
	
}

system/application/models/posts_model.php

class Posts_model extends Model {
	
	// get all postings
	function getPosts($limit = NULL)
	{
		return $this->db->get('posts', $limit);
	}
}

system/application/views/rss.php

	<?php  echo '<?xml version="1.0" encoding="' . $encoding . '"?>' . "\n"; ?>
    <rss version="2.0"
        xmlns:dc="http://purl.org/dc/elements/1.1/"
        xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
        xmlns:admin="http://webns.net/mvcb/"
        xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
        xmlns:content="http://purl.org/rss/1.0/modules/content/">
    
        <channel>
        
        <title><?php echo $feed_name; ?></title>
    
        <link><?php echo $feed_url; ?></link>
        <description><?php echo $page_description; ?></description>
        <dc:language><?php echo $page_language; ?></dc:language>
        <dc:creator><?php echo $creator_email; ?></dc:creator>
    
        <dc:rights>Copyright <?php echo gmdate("Y", time()); ?></dc:rights>
        <admin:generatorAgent rdf:resource="http://www.codeigniter.com/" />
    
        <?php foreach($posts->result() as $post): ?>
        
            <item>
    
              <title><?php echo xml_convert($post->title); ?></title>
              <link><?php echo site_url('blog/posting/' . $post->id) ?></link>
              <guid><?php echo site_url('blog/posting/' . $post->id) ?></guid>
    
                <description><![CDATA[ <?php echo character_limiter($post->text, 200); ?> ]]></description>
                <pubDate><?php echo $post->date; ?></pubDate>
            </item>
    
            
        <?php endforeach; ?>
        
        </channel>
    </rss>

Dan feed kita terlihat seperti ini, hanya dengan konten lain :)

Kesimpulan

Saya harap Anda telah belajar betapa mudahnya membangun Feed RSS 2.0 dengan kekuatan CodeIgniter. Untuk tutorial dan screencasts lebih lanjut tentang CodeIgniter, periksa serial CodeIgniter dari Awal oleh Jeffrey.

Ikuti kami di Twitter, atau berlangganan RSS Feed Nettuts+ untuk tutorial pengembangan web terbaik di web.