README

安装

推荐安装方法：composer install/require。详见下文。

作为独立包安装

require tornevall/tornevall/tornelib-php-netcurl:^6.1

与整个网络套件一起安装

require tornevall/tornevall/tornelib-php-network:^6.1

启用curl和SOAP

根据您的需求，您可以从手中没有任何东西开始。Curl是具有许多其他功能的默认处理程序。然而，实际上并不需要。在Ubuntu中，合适的安装可能如下所示

apt-get install php-curl php-xml php-json php-soap

• 除非您想要SOAP等，否则不需要XML。
• SSL：OpenSSL或类似（如果进行https请求）。
• SOAP：SoapClient和XML驱动程序（如果进行https请求）。
• CURL（如果您更喜欢curl而不是流）。
• allow_url_fopen（如果您没有对curl的访问权限，则必须启用此功能）。

软件包

源代码可在bitbucket存储库中找到，以使升级更稳定。它还镜像到github，但新版本和标签（当准备好时）提交到github以保持最大稳定性（我们信任bitbucket吗？是的 - 我们的自己的服务器）。

联系信息文档

6.1版本的文档位于此处。有一个邮件列表专门用于所有关于netcurl的问题。您也可以在此处找到发布信息（目前是这样）。您可以通过此处订阅该列表。欢迎您加入JIRA项目。请不要害怕留下反馈！

入门

• MODULE_CURL 6.1
• 入门：单独的模块

安装网络模块将使getGitTagsByUrl等功能完全可用。

兼容性

此库支持PHP 5.6（不低于）。然而，您应该在此自行检查兼容性。

测试：Bamboo、github actions和bitbucket pipelines

NetCURL在几个不同的套件中进行测试。由于缺乏“测试时间”，测试在Bitbucket云中并不完全完成，因此测试也来自其他地方的提交。以下是这些实例的列表。

• Atlassian Bamboo - 5.6 - 8.0
• GitHub Actions - 5.6 + 7.3 - 8.0
• Bitbucket Pipelines - 5.6 + 7.3 - 8.0

Bamboo服务器有历史记录，这使得许多较旧的PHP版本可用。但截至2020年夏季中期，所有旧版本的测试都已删除。这也是一个持续进行的工作。Github测试仅针对非旧版本运行（5.6除外）以及bitbucked的目标。由于bamboo是测试的旗舰，旧版本目前在其中尚未删除。

其他要求和依赖关系

在其初始状态下，基本上没有要求，因为该模块尝试在运行时选择最佳可用驱动程序。

使用真实的RSS源

当使用composer安装netcurl时，还可以通过例如以下方式添加以下内容到composer

composer require laminas/laminas-feed

如果您希望使用 laminas HTTP 驱动程序，也应该使用 laminas/laminas-http 安装它。

composer require laminas/laminas-http

然而，使用该驱动程序并不是必要的，因为如果缺少 laminas 的该驱动程序，netcurl 将回退到它自己的驱动程序。您还应该知道，如果您使用 laminas-http，它将使用默认设置，因此很可能也会使用 Laminas\Http\Client 作为 User-Agent。您可以使用 laminas 请求 RSS 源，但是这样做您可能会有些孤立无援。在这种情况下，您将得到以 SimpleXML 格式呈现的条目。

库支持

当前

• curl
• 最简单的流驱动程序形式，以及二进制安全的 file_get_contents（而不是基于相同系统的 fopen-drivers）。
• SoapClient
• RSS 源

您是否会支持套接字？

目前还没有。此驱动程序需要更多，所以这项工作被搁置。

如果我升级，会发生什么问题吗？

不会。6.1 版本是为了与 v6.0 兼容而编写的，但是具有现代化的代码和 PSR-4。然而，不要使用 MODULE_CURL。在运行任何内容之前，请确保检查 https://docs.tornevall.net/x/DoBPAw，因为较旧的 PHP 版本可能不兼容。但是，如果它们不兼容，那么您也可能不兼容。