rvdv / nntp
Client for communicating with servers throught the Network News Transfer Protocol (NNTP) protocol.
Installs: 2 008
Dependents: 0
Suggesters: 0
Security: 0
Stars: 39
Watchers: 10
Forks: 12
Open Issues: 5
Requires
- php: ^5.5|^7.0
Requires (Dev)
- friendsofphp/php-cs-fixer: 2.0.0-alpha
- phpunit/phpunit: ^4.8
- scrutinizer/ocular: ^1.1
- sllh/php-cs-fixer-styleci-bridge: ^2.1
README
Client for communicating with servers throught the Network News Transfer Protocol (NNTP) protocol.
Installation
The recommended way to install the library is through composer.
composer require rvdv/nntp:^0.9.0
NNTP?
NNTP specifies a protocol for the distribution, inquiry, retrieval, and posting of news articles using a reliable stream (such as TCP) server-client model. NNTP is designed so that news articles need only be stored on one (presumably central) host, and subscribers on other hosts attached to the LAN may read news articles using stream connections to the news host.
-- RFC Abstract (source)
Usage
Here is an example that fetches 100 articles from the php.doc of the news.php.net server:
<?php use Rvdv\Nntp\Connection\Connection; use Rvdv\Nntp\Client; $connection = new Connection('news.php.net', 119); $client = new Client($connection); $client->connect(); $overviewFormat = $client->overviewFormat(); $group = $client->group('php.doc'); $articles = $client->xover($group['first'], $group['first'] + 100, $overviewFormat); // Process the articles further... $client->disconnect();
Tests
To run the test suite, you need install the dependencies via composer, then run PHPUnit.
$ composer install $ php vendor/bin/phpunit
License
MIT © Robin van der Vleuten