README

一款必要的PHP库，用于抓取HTTP(S)和UDP追踪器以获取种子信息。

原始图片来自@alinnnaaaa。

特性

• 检索种子、吸血鬼和完成的种子信息
• 支持HTTP、HTTPS和UDP追踪器
• 自动丢弃无效追踪器和信息哈希
• 允许为每个追踪器设置超时和最大追踪器数量
• 每个抓取支持多达64个信息哈希
• 旨在尽可能轻量、直接和高效
• 支持通过抓取（默认）和公告请求进行抓取 ✨

注意

这是Scrapeer的唯一官方来源。其他存储库——例如Packagist上的存储库——是非官方的，应避免使用！

基本用法示例

单个信息哈希和单个追踪器

require 'scraper.php';

$scraper = new Scrapeer\Scraper();

$tracker = array( 'udp://tracker.coppersurfer.tk:6969/announce' );
$hash = array( '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

$info = $scraper->scrape( $hash, $tracker );
print_r( $info );

Array ( ["4344503B7E797EBF31582327A5BAAE35B11BDA01"] => Array ( ["seeders"] => 88 ["completed"] => 7737 ["leechers"] => 6 ) )

• 如果没有指定，端口将默认为HTTP/UDP的80和HTTPS的443。
• 单个元素也可以是字符串而不是数组。

单个信息哈希和多个追踪器（推荐用法）

$trackers = array( 'http://www.opentrackr.org/announce', 'udp://tracker.coppersurfer.tk:6969/announce' );
$hash = array( '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

$info = $scraper->scrape( $hash, $trackers );
print_r( $info );

Array ( ["4344503B7E797EBF31582327A5BAAE35B11BDA01"] => Array ( ["seeders"] => 59 ["completed"] => 83 ["leechers"] => 3 ) )

• 如果数组中的第一个追踪器失败（无效追踪器、无效信息哈希或对该追踪器无效的信息哈希），则将使用第二个追踪器，依此类推。
• 在这种情况下，我们从第一个追踪器获取有效结果，请注意，对于同一种子，我们得到不同的信息——这是预期的，因为不同的追踪器可能比其他追踪器更新或不更新。

多个信息哈希和单个追踪器

$tracker = array( 'http://tracker.internetwarriors.net:1337/announce' );
$hashes = array( '699cda895af6fbd5a817fff4fe6fa8ab87e36f48', '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

$info = $scraper->scrape( $hashes, $tracker );
print_r( $info );

Array ( ["699cda895af6fbd5a817fff4fe6fa8ab87e36f48"] => Array ( ["seeders"] => 4 ["completed"] => 236 ["leechers"] => 0 ) ["4344503B7E797EBF31582327A5BAAE35B11BDA01"] => Array ( ["seeders"] => 7 ["completed"] => 946 ["leechers"] => 3 ) )

• 信息哈希可以是大写或小写。

多个信息哈希和多个追踪器

$trackers = array( 'udp://tracker.coppersurfer.tk:6969/announce', 'http://explodie.org:6969/announce' );
$hashes = array( '699cda895af6fbd5a817fff4fe6fa8ab87e36f48', '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

$info = $scraper->scrape( $hashes, $trackers );
print_r( $info );

Array ( ["699cda895af6fbd5a817fff4fe6fa8ab87e36f48"] => Array ( ["seeders"] => 52 ["completed"] => 2509 ["leechers"] => 1 ) ["4344503B7E797EBF31582327A5BAAE35B11BDA01"] => Array ( ["seeders"] => 97 ["completed"] => 7751 ["leechers"] => 11 ) )

高级用法示例

错误日志记录

$trackers = array( 'http://invalidtracker:6767/announce', 'udp://tracker.coppersurfer.tk:6969/announce' );
$hashes = array( '699cda895af6fbd5a817fff4fe6fa8ab87e36f48', '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

$info = $scraper->scrape( $hashes, $trackers );

print_r( $info );

// Check if we have any errors.
if ( $scraper->has_errors() ) {
	// Get the errors and print them.
	print_r( $scraper->get_errors() );
}

Array ( ["699cda895af6fbd5a817fff4fe6fa8ab87e36f48"] => Array ( ["seeders"] => 49 ["completed"] => 2509 ["leechers"] => 1 ) ["4344503B7E797EBF31582327A5BAAE35B11BDA01"] => Array ( ["seeders"] => 99 ["completed"] => 7754 ["leechers"] => 7 ) ) Array ( [0] => "Invalid scrape connection (invalidtracker:6767)." )

• 第一个追踪器无效，它将被跳过，并将错误添加到错误记录器。
• 抓取器会继续抓取，直到找到有效追踪器或没有更多追踪器可尝试。
• 无效信息哈希将被记录并跳过。

高级选项

最大追踪器数量

$trackers = array( 'http://invalidtracker:6767/announce', 'udp://tracker.coppersurfer.tk:6969/announce' );
$hashes = array( '699cda895af6fbd5a817fff4fe6fa8ab87e36f48', '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

// The max. amount of trackers to try is 1.
$info = $scraper->scrape( $hashes, $trackers, 1 );

• 无论第一个追踪器的有效性如何，抓取器将在第一个追踪器后停止。
• 默认：数组中的所有追踪器。

每个追踪器的超时时间

$trackers = array( 'http://invalidtracker:6767/announce', 'udp://tracker.coppersurfer.tk:6969/announce' );
$hashes = array( '699cda895af6fbd5a817fff4fe6fa8ab87e36f48', '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

// The max. amount of trackers to try is 2 and timeout per tracker is 3s.
$info = $scraper->scrape( $hashes, $trackers, 2, 3 );

• 每个追踪器将有一个3秒的超时时间（在这种情况下，总超时时间为6秒）。
• 默认：2秒（推荐）。

公告抓取

$trackers = array( 'udp://tracker.opentrackr.org:1337/announce', 'http://explodie.org:6969/announce' );
$hashes = array( '699cda895af6fbd5a817fff4fe6fa8ab87e36f48', '4344503B7E797EBF31582327A5BAAE35B11BDA01' );

$info = $scraper->scrape( $hashes, $trackers, 2, 3, true );

• 默认：false。
• 对于多个信息哈希，首选抓取而不是公告请求（通常更快）。
• 注意：UDP追踪器仅返回种子和吸血鬼信息。这是协议限制。

常见问题解答

• 什么是信息哈希？我如何获取它们？

来自BitTorrent协议规范

元信息文件中info值的bencoded形式的20字节sha1哈希。请注意，这是一个元信息文件的子串。信息哈希必须是.torrent文件中找到的编码形式的哈希，无论其是否无效。此值几乎肯定需要转义。

有许多方法可以从您的种子中检索信息哈希，例如，基于PHP的解决方案可以是torrent-bencode。

• 我需要公共追踪器！在哪里可以找到一些呢？

请查看newTrackon和trackerslist。