typecho 自动订阅 RSS

昨天学习了一下 RSS 订阅知识之后，经过一番百度搜索，终于在自己的博客上实现了 RSS 订阅功能，但苦于技术有限，不能对 Feed 文件进行定时缓存，每次打开链接都会比较延迟。今天继续对这个功能进行了学习，突然，我发现了一个大佬提供的 rssphp 代码，有了他，很多实用功能不再需要自己去分析、判断和写代码了，最重要的是他提供了定时缓存 xml 文件的功能，于是将其拿来，在经过一番操作之后，终于在自己的博客上较为完美的实现了。

文档修改日志：

2024.12.01 实现 rss 订阅
2024.12.02 增加 atom 订阅，修复截取字符串乱码问题

一、下载代码存到自己的博客

上面的链接可以下载下来学习，里面也有两个 demo 文件供参考，但放入博客，真正要用的只需要 Feed.php 文件，我将其存放到自己主题目录下面，然后在 funciton.php 文件中引入（通常是放在函数代码块的前面，方便以后回忆代码）。

php 复制代码

include_once 'path/to/feed.php';

二、建立 Feed 文件下载缓存目录

就用 demo 中所说的 tmp 目录吧，在主题目录下面建立 tmp 目录，并赋权为 777（linux系统）

bash 复制代码

sudo chmod 777 -R tmp

三、在主题目录下建立模板文件 rss.php 实现订阅

下面是我写的模板文件，重点看订阅RSS部分的php代码，主要实现了几个功能

指定时区（不知道啥用）以及指定缓存位置及下载缓存文件的时间间隔
获取 RSS 订阅网址及 atom 订阅网址数据
对每个 RSS 文件进行读取和输出相关信息
加入了 try 防止有些 feed 文件不被识别而报错

php 复制代码

<?php

/**
 * RSS自动订阅
 *
 * @package custom
 */
?>

<?php if (!defined('__TYPECHO_ROOT_DIR__')) exit; ?>
<?php $this->need('header.php'); ?>

<!-- main-body -->
<div class="p-3 flex-1">
    <!-- 文章 -->
    <article class="flex flex-col mb-6">
        <!--标题-->
        <div
            class="mb-6 p-2 flex flex-col hyone-box">
            <p
                class="p-3 text-lg md:text-xl lg:text-2xl text-slate-900 line-clamp-1 font-extrabold tracking-tight dark:text-slate-300 ">
                <a itemprop="url"
                    href="<?php $this->permalink() ?>"><?php $this->title() ?></a>
            </p>
            <div class="px-3 text-base line-clamp-2 lg:line-clamp-3 mb-2">
                <p></p>
            </div>

        </div>

        <!-- 正文 -->
        <div
            class="mb-6 p-2 flex-1 flex flex-col hyone-box">

            <div class="px-3 md:px-6 py-6 text-base leading-9 mb-2 flex-1">


                <!-- 订阅基础设置 -->
                <?php
                // 指定时区
                if (!ini_get('date.timezone')) {
                    date_default_timezone_set('Asia/Shanghai');
                }

                // 指定缓存目录及缓存事件
                Feed::$cacheDir = __DIR__ . '/tmp';
                Feed::$cacheExpire = '6 hours';
                ?>

                <!-- 订阅RSS开始 -->
                <?php
                // 获取需要订阅RSS的网址
                $delimiter = ",";
                if ($this->options->rss) {
                    $rssfeed = explode($delimiter, $this->options->rss);
                } else {
                    $rssfeed = array(
                        "https://www.zhangxinxu.com/wordpress/feed/",
                        "https://www.hollowman.cn/feed/"
                    );
                }

                //调用每个RSS文件
                for ($i = 0; $i < count($rssfeed); $i++) {
                    $rssname = 'rss' . $i;
                    try {
                        $$rssname = Feed::loadRss($rssfeed[$i]);
                        echo ' <div class="accordion">';
                        echo ' <div class="accordion-title">' . htmlspecialchars($$rssname->title) . '</div>';
                        echo '<div class="accordion-body"><div>';

                        foreach ($$rssname->item as $item):
                            if (strlen($item->title) > 0) {
                                $description = mb_substr(trim(strip_tags($item->description)), 0, 150);
                                echo '<div class="rsspost"><a href="' . htmlspecialchars($item->url) . '" target="_blank" rel="noopener">' . htmlspecialchars($item->title) . '</a>(' . date('Y-n-j', (int) $item->timestamp) . ')<br><span class="line_over_hidden">' . htmlspecialchars($description) . '</span></div>';
                            }
                        endforeach;

                        echo '</div>';
                        echo '</div>';
                        echo '</div>';
                    } catch (Exception $e) {
                    }
                }
                ?>
                <!-- 订阅RSS结束 -->

                <!-- 订阅 atom 开始 -->
                <?php
                // 获取需要订阅 atom 的网址
                $delimiter = ",";
                if ($this->options->atom) {
                    $atomfeed = explode($delimiter, $this->options->atom);
                } else {
                    $atomfeed = array(
                        "http://www.ruanyifeng.com/blog/atom.xml"
                    );
                }

                //调用每个 atom 文件
                for ($i = 0; $i < count($atomfeed); $i++) {
                    $atomname = 'atom' . $i;
                    try {
                        $$atomname = Feed::loadAtom($atomfeed[$i]);
                        echo ' <div class="accordion">';
                        echo ' <div class="accordion-title">' . htmlspecialchars($$atomname->title) . '</div>';
                        echo '<div class="accordion-body"><div>';

                        foreach ($$atomname->entry as $entry):
                            if (strlen($entry->title) > 0) {
                                $content = mb_substr(trim(strip_tags($entry->content)), 0, 150);
                                echo '<div class="rsspost"><a href="' . htmlspecialchars($entry->url) . '" target="_blank" rel="noopener">' . htmlspecialchars($entry->title) . '</a>(' . date('Y-n-j', (int) $entry->timestamp) . ')<br><span class="line_over_hidden">' . htmlspecialchars($content) . '</span></div>';
                            }
                        endforeach;

                        echo '</div>';
                        echo '</div>';
                        echo '</div>';
                    } catch (Exception $e) {
                    }
                }
                ?>
                <!-- 订阅 atom 结束 -->

            </div>


            <div class="flex-1 px-3 md:px-6 py-6 post-content">

            </div>

        </div>

    </article>

</div>
<style>
    .rsspost {
        padding: 0 1rem;
    }

    .rsspost:hover {
        background-color: rgba(0, 0, 0, .2);
    }

    .rsspost a {
        color: green;
        font-weight: bolder;
    }

    .rsspost a:hover {
        color: yellowgreen;
    }

    /* 超出隐藏 */
    .line_over_hidden {
        overflow: hidden;
        display: -webkit-box;
        -webkit-box-orient: vertical;
        -webkit-line-clamp: 2;
    }
</style>

<?php $this->need('sidebar.php'); ?>
<?php $this->need('footer.php'); ?>

订阅 RSS 来源，我是通过在主题外观中添加了一个 input 框，将需要订阅的地址写入后进行订阅，如果后台不写入，则在此文件中添加默认的订阅网址。

可以在 function.php 文件的 themeConfig($form)函数中写入订阅 input 框

php 复制代码

//主题配置
function themeConfig($form){
...
    // rss订阅链接
    $rss = new \Typecho\Widget\Helper\Form\Element\Text('rss', null, null, _t('rss订阅链接'), _t('添加需要订阅的rss地址，以逗号分割'));
    $form->addInput($rss);
    // atom订阅链接
    $atom = new \Typecho\Widget\Helper\Form\Element\Text('atom', null, null, _t('atom订阅链接'), _t('添加需要订阅的atom地址，以逗号分割'));
    $form->addInput($atom);
...
}

typecho 自动订阅 RSS

一、下载代码存到自己的博客

二、建立 Feed 文件下载缓存目录

三、在主题目录下建立模板文件 rss.php 实现订阅

四、体验吧