ساخت فید خوان آر اس اس (RSS Feed Reader) با PHP

فیدخوان آر اس اس (RSS Feed Reader) چیست؟

هر فید وب حاوی اطلاعاتی در چارچوب زبان XML است که در فایلی با همین پسوند ذخیره و نگهداری می شوند، به طور معمول این اطلاعات درون تگ های XML درج شده اند و به صورت خام چندان خوانا و قابل استفاده نیستند، به همین دلیل به برنامه یا اسکریپتی نیاز خواهیم داشت تا فایل فید را دریافت، اطلاعات موجود در آن را تجزیه و تحلیل نموده و در نهایت مطابق با هدف و نیازمان به خروجی صفحات HTML ارسال کند، با این تفسیر منظور از فیدخوان آر اس اس (RSS Feed Reader) برنامه ای است که قابلیت استخراج اطلاعات فیدهای RSS را داشته باشد و بدین منظور در وب به طور معمول یکی از زبان های برنامه نویسی سمت سرور مانند PHP مورد استفاده قرار می گیرد.

آشنایی با شیوه نگارش (Syntax) فید آر اس اس (RSS Feed)

قبل از اینکه به قسمت کدنویسی PHP بپردازیم بد نیست با شیوه نگارش (Syntax) یک نمونه فید آر اس اس (RSS Feed) آشنا شویم چرا که برنامه PHP که خواهیم نوشت ابتدا محتوای فایل XML مقصد (فید آر اس اس) را به عنوان اطلاعات ورودی دریافت و سپس تجزیه تحلیل خواهد کرد، بر همین اساس یک فید آر اس اس معمولی از تگ های خاصی به زبان XML استفاده می کند که در نمونه زیر ساختار کلی آن درج شده است:

<?xml version="1.0" encoding="UTF-8"?> 
<rss version="2.0"> 
<channel> 
<title>عنوان فید</title> 
<link>https://webgoo.ir</link> 
<description>توضیح</description> 
<language>fa</language> 
<copyright>Copyright</copyright>
<item> 
<title>عنوان مطلب</title> 
<description>توضیح مطلب</description> 
<link>لینک مطلب</link> 
<guid>لینک مطلب</guid> 
<pubDate>تاریخ مطلب به میلادی</pubDate> 
<source url="https://webgoo.ir/rss.xml">وبگو</source> 
</item> 
</channel> 
</rss>

توضیح:
- هر فید آر اس اس از تگ های کلیدی تشکیل شده که هر کدام برای نگهداری محتوای خاصی کاربرد دارند، به طور مثال تگ title عنوان مطلب و تگ link آدرس URL مطلب را در خود جای می دهند، یا از description برای پیش نمایش مطلب و pubDate برای درج تاریخ ایجاد آن استفاده می کنیم.
- کد PHP که در ادامه بررسی خواهیم کرد با دریافت فایل XML فید به عنوان ورودی، تگ های موجود در آن را تجزیه کرده و نتایج به دست آمده را به نحو دلخواه در خروجی نمایش می دهد.

کد PHP فید خوان آر اس اس (RSS Feed Reader)

برای استخراج و نمایش محتوای فیدهای آر اس اس در سایت یا وبلاگمان (در صورت استفاده از هاست و دامنه شخصی) می توانیم از توابع زیر که به زبان PHP نوشته شده اند استفاده کنیم، بدین منظور کافی است آدرس فید را جایگزین مقادیر پیش فرض در کد نمائیم.

<?php
//تنظیمات
$url = 'https://webgoo.ir/rss.xml';//آدرس فید
$num = '5';//تعداد آیتم

//تبدیل اطلاعات فید به آرایه
function xmlToArray($text){
    $regexp = '/<(\w+)[^>]*>(.*?)<\/\\1>/s';
    preg_match_all($regexp, $text, $match);
    $loop = 0;
    
    foreach($match[1] as $key=>$val){
        if(preg_match($regexp, $match[2][$key])){
            @$array[$val][$loop] = xmlToArray($match[2][$key]);
        } else {
            @$array[$val] = $match[2][$key];
        }
        
        $loop++;
    }
    
    return $array;
}

//آماده سازی فید جهت ایجاد خروجی
function displayFeed($url, $num){
    $template = '<div class="rss-item"> &raquo; <a href="#link#" target="_blank">#title#</a></div>' . "\n";
    
    if($rss = @file_get_contents($url)){
        $rss = xmlToArray($rss);
        
        if(is_array($rss)){
            $code = "";
            $count = 0;
            
            foreach($rss['rss'][0]['channel'][0]['item'] as $val){
                $tpl = strtolower($template);
                
                foreach($val as $key => $val2){
                    $val2 = html_entity_decode(htmlentities(@strip_tags($val2)));
                    $tpl = str_replace("#" . strtolower($key) . "#", $val2, $tpl);
                }
                
                if($count < $num){
                    $code .= $tpl;
                }
                
                ++$count;
            }
        } else {
            return false;
        }
        
        echo $code;
        return true;
    } else {
        return false;
    }
}

//چاپ خروجی
echo '<div class="rss-block">' . "\n";
displayFeed("$url", $num);
echo '</div>';
?>

توضیح:
- آدرس فید مد نظر را در ابتدای کدها در متغیر url جایگزین می کنیم (حتما باید آدرس کامل را به صورت http://www یا //:http درج کنیم)، این آدرس به طور معمول به فرمت xml ختم می شود (اگر آدرس به فرمت xml ختم نشد خروجی آن باید به زبان XML باشد).
- دقت کنیم که محتوای فید از نظر استاندار کدنویسی معتبر باشد، برای این منظور می توانیم از سرویس اعتبارسنجی W3C در آدرس زیر استفاده کنیم:

https://validator.w3.org/feed/

- در تابع displayFeed ابتدا محتویات فید مقصد را با روش file_get_contents دریافت و جهت تجزیه و استخراج اطلاعات تگ ها تابع xmlToArray را با مقادیر دریافت شده به عنوان آرگیومنت فراخوانی می کنیم.
- تابع xmlToArray مقادیر دریافتی از فید را با استفاده از روش preg_match_all و preg_match تجزیه کرده و نتیجه را به صورت آریه قابل استفاده در تابع displayFeed برمی گرداند.
- در ادامه، تابع displayFeed به صورت داینامیک الگوی هشتگ های موجود در متغیر template را با آرایه دریافتی مقایسه کرده و مقادیر متناظر آنها را جایگزین می کند تا سرانجام نتیجه برنامه در هر دور حلقه foreach ایجاد و در نهایت به مرورگر ارسال شود.
- با توجه به استفاده از تابع strtolower در کدنویسی برنامه، اسکریپت به بزرگ یا کوچک بودن حروف حساس نیست.
- خروجی کد بالا در بلاکی با آی دی rss-block تولید می شود و هر آیتم، کلاسی با نام rss-item دارد، از این کلاس ها می توانیم برای ایجاد تنظیمات و استایل CSS دلخواه استفاده کنیم (نمونه پیش فرض در انتهای همین صفحه به صورت پیش نمایش آنلاین درج شده است).

تنظیمات و استایل CSS قابل اعمال بر روی فید خوان PHP

کد بالا در حالت پیش فرض تنها لینک مطالب را به صورت HTML خروجی می دهد، اما همانطور که پیش تر گفتیم در صورت نیاز می توانیم محتوای هر کدام از تگ های RSS را در خروجی داشته باشیم، به طور مثال متن مربوط به توضیحات مطالب را با افزودن تگ description به صورت #description# به متغیر template علاوه بر لینک ها در خروجی نمایش دهیم، در نمونه کد زیر این کار را برای مقادیر تاریخ و توضیحات آیتم های فید انجام داده ایم:

$template = '<div class="rss-item"> &raquo; <a href="#link#" target="_blank">#title#</a><br>#description#<br>#pubDate#</div>' . "\n";

برای اعمال استایل دلخواه نیز می توانیم در فایل CSS مقادیر مورد نظر خود را به کلاس های rss-block و rss-item نسبت دهیم، مثال:

<style>
.rss-block{
    border:1px #666 solid;
    padding:4px;
    line-height:18px;
}
.rss-block a{
    text-decoration:none;
    color:#06C;
}
.rss-block a:hover{
    color:#09F;
}
.rss-item{
    height:auto;
}
</style>

پیش نمایش اسکریپت فید خوان آر اس اس

نمونه کامل کد فید خوان آر اس اس با برنامه نویسی PHP و پیش نمایش آنلاین آن در لینک زیر قابل تست و بررسی است.

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>وبگو | فید خوان آر اس اس با PHP</title>
<!-- Webgoo.ir -->
<style>
body {
    font-family: Tahoma, Geneva, sans-serif;
    font-size: 12px;
    direction: rtl;
}
.rss-block {
    border:1px #666 solid;
    padding:4px;
    line-height:18px;
}
.rss-block a {
    text-decoration:none;
    color:#06C;
}
.rss-block a:hover {
    color:#09F;
}
.rss-item {
    height:auto;
}
</style>
</head>
<body>
<?php
//تنظیمات
$url = 'https://webgoo.ir/rss.xml';//آدرس فید
$num = '5';//تعداد آیتم

//تبدیل اطلاعات فید به آرایه
function xmlToArray($text){
    $regexp = '/<(\w+)[^>]*>(.*?)<\/\\1>/s';
    preg_match_all($regexp, $text, $match);
    $loop = 0;
    
    foreach($match[1] as $key=>$val){
        if(preg_match($regexp, $match[2][$key])){
            @$array[$val][$loop] = xmlToArray($match[2][$key]);
        } else {
            @$array[$val] = $match[2][$key];
        }
        
        $loop++;
    }
    
    return $array;
}

//آماده سازی فید جهت ایجاد خروجی
function displayFeed($url, $num){
    $template = '<div class="rss-item"> &raquo; <a href="#link#" target="_blank">#title#</a><br>#description#<br>#pubDate#</div>' . "\n";
    
    if($rss = @file_get_contents($url)){
        $rss = xmlToArray($rss);
        
        if(is_array($rss)){
            $code = "";
            $count = 0;
            
            foreach($rss['rss'][0]['channel'][0]['item'] as $val){
                $tpl = strtolower($template);
                
                foreach($val as $key => $val2){
                    $val2 = html_entity_decode(htmlentities(@strip_tags($val2)));
                    $tpl = str_replace("#" . strtolower($key) . "#", $val2, $tpl);
                }
                
                if($count < $num){
                    $code .= $tpl;
                }
                
                ++$count;
            }
        } else {
            return false;
        }
        
        echo $code;
        return true;
    } else {
        return false;
    }
}

//چاپ خروجی
echo '<div class="rss-block">' . "\n";
displayFeed("$url", $num);
echo '</div>';
?>
</body>
</html>

پیش نمایش آنلاین