README

Laravel Wikipedia Grabber

用于Laravel的Wikipedia/MediaWiki抓取器。

目录

• 使用方法
• 输出格式
• 可用方法
• 高级
  • MediaWiki
  • 修改抓取的页面
• 赞助商
• 许可协议

使用方法

1. 使用Composer安装包

   composer require illuminated/wikipedia-grabber

2. 发布配置

   php artisan vendor:publish --provider="Illuminated\Wikipedia\WikipediaGrabberServiceProvider"

3. 抓取完整页面或预览

   use Wikipedia;
   
   echo (new Wikipedia)->page('Michael Jackson');
   echo (new Wikipedia)->preview('Michael Jackson');
   
   // Or
   
   echo (new Wikipedia)->randomPage();
   echo (new Wikipedia)->randomPreview();

输出格式

以下是支持的输出格式列表

• plain（默认）
• bootstrap
• bulma

在您的配置文件中更改格式，或明确指定它

echo (new Wikipedia)->page('Michael Jackson')->bulma();

可用方法

当您调用page()或preview()方法时，您将获得适当的对象实例。

这些对象上有许多可用方法，例如

$page = (new Wikipedia)->page('Michael Jackson');

$page->isSuccess();         // true
$page->isMissing();         // false
$page->isInvalid();         // false
$page->isDisambiguation();  // false

echo $page->getId();        // 14995351
echo $page->getTitle();     // "Michael Jackson"
echo $page->getBody();      // Same as `echo $page;`

高级

MediaWiki

Wikipedia在底层使用MediaWiki API。

因此，您可以抓取任何MediaWiki网站的页面

use MediaWiki;

echo (new MediaWiki($url))->page('Michael Jackson');

修改抓取的页面

有时，可能需要将附加部分附加到抓取的页面上

$page = (new Wikipedia)->page('Michael Jackson');

$page->append('Interesting Facts', 'He had two pet llamas on his ranch called Lola and Louis.');

或者，您可以获取部分集合并按需更改它

$page = (new Wikipedia)->page('Michael Jackson');

$sections = $page->getSections();
$sections->push(
    new Section('Interesting Facts', 'He had two pet llamas on his ranch called Lola and Louis.', $level = 2)
);

赞助商

许可协议

Laravel Wikipedia Grabber是开源软件，根据MIT许可证授权。