simplepie/simplepie

一个简单的PHP Atom/RSS解析库

1.8.0 2023-01-20 08:37 UTC

README

SimplePie是一个非常快速且易于使用的PHP类,它将“简单”重新带回到“非常简单的聚合”(RSS)。SimplePie足够灵活,适合初学者和有经验的人,它专注于速度、易用性、兼容性和标准一致性

要求

  • PHP 7.2+(自SimplePie 1.8.0以来必需)
  • libxml2(某些2.7.x版本存在太多bug,可能导致崩溃)
  • iconv、mbstring或intl扩展之一
  • 可选,intl扩展、symfony/polyfill-intl-idn或具有IDN支持的cURL扩展来支持IDN
  • cURL或fsockopen()
  • PCRE支持

PSR-18:HTTP客户端支持

自SimplePie 1.9.0起,您可以使用PSR-18 HTTP客户端,如Guzzle其他实现。请注意,您还需要PSR-17RequestFactoryInterface实现和UriFactoryInterface实现。

$simplepie = new \SimplePie\SimplePie();
$simplepie->set_http_client(
    new \GuzzleHttp\Client(),
    new \GuzzleHttp\Psr7\HttpFactory(),
    new \GuzzleHttp\Psr7\HttpFactory(),
);

PSR-16:缓存支持

自SimplePie 1.8.0起,您可以使用来自PSR-16的缓存,例如来自Symfony其他实现

$simplepie = new \SimplePie\SimplePie();
$simplepie->set_cache(
    new \Symfony\Component\Cache\Psr16Cache(
        new \Symfony\Component\Cache\Adapter\FilesystemAdapter()
    ),
);

包中包含什么?

  1. src/ - 用于与自动加载器一起使用的SimplePie类
  2. autoloader.php - 如果您想使用单独的文件版本,则使用SimplePie自动加载器。
  3. README.markdown - 此文档。
  4. LICENSES/BSD-3-Clause.txt - BSD许可证的副本。
  5. compatibility_test/ - SimplePie兼容性测试,用于检查您的服务器是否设置了所需设置。
  6. demo/ - 一个基本的聚合阅读器演示,展示了SimplePie的一些显著特性。
  7. build/ - 与生成SimplePie相关联的脚本
  8. test/ - SimplePie的单元测试套件。

哪里是simplepie.inc

自SimplePie 1.3以来,我们将类拆分到单独的文件中,以便更容易维护和使用。

如果您想要一个单一的模块化文件,请查看发布版中的资产,或者您可以运行php build/compile.php来自动生成SimplePie.compiled.php

开始演示

  1. 将此包上传到您的Web服务器。
  2. 确保demo文件夹中的缓存文件夹可由服务器写入。
  3. 使用浏览器导航到demo文件夹。

需要支持?

有关进一步设置和安装文档、函数参考等,请访问Wiki。如果您正在使用GitHub上的最新版本,您还可以查看API文档

如果您在文档中找不到问题的答案,请访问我们的支持渠道。有关错误报告和功能请求,请访问问题跟踪器

项目状态

SimplePie 目前由 Malcolm Blaney 维护。

作为一个开源项目,SimplePie 的维护相对不规律。这意味着可能无法立即满足功能请求,因为时间需要优先分配。

如果您想为 SimplePie 贡献,最好的开始方式是在 GitHub 上创建项目的分支,并为补丁发送拉取请求。在这样做的时候,请留意我们的编码规范

下一个小版本的主要开发工作发生在 master 分支。请将您的拉取请求主要发送到这个分支。

我们不积极提供旧版本的错误修复和安全修复。尽管如此,如果您仍然需要支持旧版本的 PHP,欢迎创建回端口 PR。请将您的 PR 发送到相应的分支。

作者和贡献者

当前

校友

贡献者

贡献者完整列表

  1. 下拉获取最新的 SimplePie 代码
  2. simplepie 目录下,运行 git shortlog -ns

许可

新 BSD 许可证