Cómo crear un feed RSS con MySQL y PHP

Este es el primer tutorial que escribo en Cristalab. La creación de un feed RSS con MySQL y PHP. Si apenas estas comenzando te recomiendo que leas Cómo crear tu propio feed RSS manualmente, que aborda el tema del formato RSS a profundidad.

De todos modos si tienes idea de lo que es RSS adelante con este tip. Cabe mencionar que mis conocimientos son algos básicos en algunas cosas, sin embargo lo que se y he aprendiendo en esta gran comunidad lo comparto con ustedes, el ejemplo que les pondré a continuación esta basado en un ejemplo que desarrolló Alejandro Suazo por el año 2005. Este es uno de los ejemplos más difundidos de como realizar un Feed RSS, aunque contiene algunos errores de escritura y sintaxis, todos o la mayoría de esos errores los arregle y el ejemplo ya esta funcional.

Entendamos qué es RSS

El feed RSS es un sencillo formato de datos que es utilizado para redifundir contenidos a suscriptores de un sitio web. El formato permite distribuir contenido sin necesidad de un navegador, utilizando un software diseñado para leer estos contenidos RSS (agregador). A pesar de eso, es posible utilizar el mismo navegador para ver los contenidos RSS. Las últimas versiones de los principales navegadores permiten leer los RSS sin necesidad de software adicional.

Existen 3 formatos de RSS :

• RSS (0.91) Rich Site Summary
  
• RSS (0.0 y 1.0) RDF Site Summary
  
• RSS (2.0) Really Simple Sindication
  

Para mas información sobre el RSS, pueden visitar la página de Wikipedia.

¿Cómo creamos el documento RSS?

Es muy sencillo crear un documento RSS ya que en si es un archivo XML.

• El archivo debe comenzar indicando la versión de XML y la codificación. En este caso utilizo codificación “iso-8859-1“, para caracteres latinos (ñ o tildes).
  
• A continuacíon añadimos las etiquetas de apertura y cierre <rss></rss> e indicamos la versión del tipo de documento y después tendremos que crear un canal donde vamos a publicar nuestros contenidos .
  
• Los tres elementos siguientes son obligatorios en todo feed RSS e identifican a nuestro feed y a nuestro sitio web.
• En primer lugar indicaremos el título de nuestro sitio, a continuación especificamos la url donde se puede encontrar nuestra feed RSS y por último una breve descripción de lo que se puede encontrar en nuestro sitio.
  
• Después de las tres líneas anteriores añadiremos un elemento item por cada entrada que vayamos a incluir en nuestro feed.

Cada item consta de tres elementos obligatorios:

• title. Que contiene el título del artículo.
  
• link. Que contiene el enlace directo a la versión completa del artículo. De esta forma los suscriptores interesados podrán leer el artículo completo.
  
• description. Que contiene un resúmen de lo que encontraremos en el artículo.
  

Y varios elementos opcionales, de los cuales utilizo únicamente dos:

• pubDate. Que indica la fecha de publicación del artículo.
  
• category. Que contiene el nombre de la categoría al que pertenece el artículo.
  

Ejemplo:

Código :

    <?xml version=”1.0″ encoding=”iso-8859-1″ ?>
    <rss version=”2.0″>
    <channel>
    <item>
    <title>El título de mi artículo 1</title>
    <link>http://www.mipagina.com/noticia1.html</link>
    <description>Resúmen de la noticia</description>
    <pubDate>Lun, 14 Dic 2009 11:56:26 GMT</pubDate>
    <category>Categoría</category>
    </item>
    </channel>
    </rss>

Ya que tenemos más o menos claro lo que es RSS podemos poner manos a la obra y empezar a crear nuestro feed de noticias para nuestra página web.

Crear la base de datos

El primer paso será crear la base de datos y añadir los datos. Si nuestra página ya utiliza algún tipo de base de datos para guardar los artículos no será necesario crear otra base de datos ni tampoco hacer cambios, solamente necesitaras adecuar el script a tus necesidades.

• id_noticia – no es obligatorio pero a mi en lo particular me gusta manejar por números los registros
  
• autor – nombre del autor que publica las noticias
  
• titulo – título que veremos en el RSS
  
• categoria –categoría o tag del articulo (nos permitirá organizar mejor)
  
• fecha – fecha del articulo para la organización (los más nuevos son los primeros)
  
• noticia – nuestros artículos se guardaran en este campo
  

Esta sería la estructura SQL para facilitar un poco el como funciona este ejemplo:

Código :

CREATE TABLE IF NOT EXISTS `noticias` (
`id_noticia` int(4) NOT NULL auto_increment,
`autor` varchar(255) default NULL,
`titulo` varchar(255) default NULL,
`categoria` varchar(255) default NULL,
`fecha` date NOT NULL,
`noticia` text,
KEY `id_noticia` (`id_noticia`)
) ENGINE=MyISAM  DEFAULT CHARSET=latin1;

Para utilizar los datos genere un archivo llamado conexion donde almacenamos la información de nuestra BD.

Archivo: conexion.php

Código :

<?php
function Conectarse()
   {  //conectamos a la base
      if (!($link=mysql_connect(“servidor”,”usuario”,”contraseña”)))
    {
   echo “Error conectando a la base de datos.”;
   exit();
  }   //Seleccionamos la base
     if (!mysql_select_db(“base_de_datos”,$link))
  {
    echo “Error seleccionando la base de datos.”;
    exit();
   }
    return $link;
    }
?>

Ya que tenemos nuestra tabla en nuestra base de datos, vamos a empezar a ver el script que nos genera nuestro Feed de noticias.

Archivo: rss.php

Código :

<?php
header('Content-type: text/xml; charset="iso-8859-1"', true);
echo '<?xml version="1.0" encoding="iso-8859-1"?>';
//Aquí la conexión o archvio de conexión a la base de datos
include ("noticias/conexion.php");
$link=Conectarse(); 
//Hacemos la consulta y la ordenamos por post para mostrar siempre el último
$resultado=mysql_query("select * from noticias order by id_noticia Desc",$link);
//"Cortaremos" el artículo en 300 caracteres para nuestra descripción
$descripcion=substr($row[noticia],0,300)."...";

// Y generamos nuestro documento
echo '<rss version="2.0">';
echo '<channel>
      <title>Colegio Atid</title>
      <link>http://www.atid.edu.mx/</link>
      <language>es-CL</language>
      <description>Noticias del Colegio Atid</description>
      <generator>Randy Espiritu</generator>';
      
   while($row = mysql_fetch_array($resultado)){      
      echo '<item>
         <title>'.$row[titulo].'</title>
         <link>http://www.atid.edu.mx/comunidad/news.php?id='.$row[id_noticia].'</link>
         <pubDate>'.$row[fecha].'</pubDate>
         <category>'.$row[categoria].'</category>
         <description><![CDATA['.$row[noticia].']]></description>
      </item>';
      }
   echo'   
   </channel>
</rss>';
?>

Podemos ver que la estructura del documento es sencilla y hasta repetitiva. Básicamente podemos dividirlo en dos: <channel> e <item> en donde <channel> contiene a <item> . El primer bloque antes de <item> se llena con los datos de nuestro blog o web, luego bajo la etiqueta mencionada van los datos del post o noticia a mostrar.

Una práctica sana es utilizar la etiqueta <content:encoded> , para proporcionar la información que contiene nuestro artículo completo en vez de <description> ¿por qué?, porque los sistemas de recopilación de feeds o lectura de estos, leen la etiqueta <description> para darle al lector un resumen de lo que trata el post. Lo menciono, porque hay sistemas de blog's que usan <description> para generar la información del artículo completo y no dan la opción de ver si queremos o no seguir leyendo lo que nos ofrecen, aparte de ocupar espacio. Para estas dos etiquetas usamos la sección XML <![CDATA[ ]]> (character data), básicamente para que el XML no interprete ciertos caracteres como propios de su lenguaje y trate de ejecutarlos.

Para hacer accesible tu canal RSS debes de poner un enlace a tu archivo desde tu página web.
Bastará con que insertes una línea como la que se muestra a continuación en el código HTML de la página en la que quieras que aparezca el enlace:

Código :

<a type="application/rss+xml" href="rss.php"><img src="icono_rss.gif"></a>

También debemos incluir lo siguiente entre las etiquetas <head> de nuestras páginas:

Código :

<link rel="alternate" type="application/rss+xml" title="My RSS Feed" href="rss.php" />

De esta forma los navegadores (al menos los más utilizados, Firefox e Internet Explorer, en sus últimas versiones) detectarán que nuestro sitio tiene un feed RSS 2.0 y mostrarán un icono a los visitantes de nuestro sitio en la barra de direcciones para suscribirse directamente, en algunos navegadores viejos no se visualiza bien los feed, o también puede que tu servidor no reconozca este tipo de archivos.

Espero les sirva este tip, se que hay muchas formas de hacerlo, pero a mi en lo particular esta forma me a funcionado, si alguíen quiere hacerle mejoras seran bien recibidas.

Saludos

¿Sabes SQL? ¿No-SQL? Aprende MySQL, PostgreSQL, MongoDB, Redis y más con el Curso Profesional de Bases de Datos que empieza el martes, en vivo.