README

一个用于处理 Wikipedia 的 Laravel 包。非常容易使用。提供 Facade 和依赖注入的使用

安装

需要 PHP 5.5+ 或 HHVM 3.3+，以及 Composer。

首先，使用 Composer 引入该包。

$ composer require unicodeveloper/laravel-wikipedia

另一种选择是直接将以下行添加到你的 composer.json 文件的 require 块中。

"unicodeveloper/laravel-wikipedia": "1.0.*"

然后运行 composer install 或 composer update 下载它并更新自动加载器。

然后在 config/app.php 中包含这些服务提供者

'providers' => [
    ...
    Unicodeveloper\Larapedia\WikiRandServiceProvider::class,
    ...
];

此包还包含一个 Facade

'aliases' => [
    ...
    'WikiRand' => Unicodeveloper\Larapedia\WikiRandFacade::class,
    ...
]

运行以下命令，它会在你的 Laravel 应用中创建一个 config/wikirand.php 文件。你可以修改配置

    php artisan vendor:publish

使用方法

可以这样使用

对于那些非常喜欢 Facade 的人来说，我为你准备了蛋糕 😄 如下

{{ WikiRand::getFirstSentence() }}  // returns 5321 Jagras è un asteroide della fascia principale.

{{ WikiRand::getApiLanguage() }} // returns it

{{ WikiRand::getId() }} // returns 812464

{{ WikiRand::getTitle() }} // returns 5321 Jagras

{{ WikiRand::getLink() }} // returns http://it.wikipedia.org/wiki/5321_Jagras

{{ WikiRand::getNChar(25) }} // 5321 Jagras è un asteroide...

{{ WikiRand::getCategoriesRelated() }}
// returns
array(3) {
      [0]=> string(42) "Asteroidi della fascia principale centrale"
      [1]=> string(31) "Corpi celesti scoperti nel 1985"
      [2]=> string(16) "Stub - asteroidi"
}

{{ WikiRand::getOtherLangLinks() }}
// returns
array(10)
      { [0]=> array(3)
        { ["lang"]=> string(2) "en"
          ["url"]=> string(40) "http://en.wikipedia.org/wiki/5321_Jagras"
          ["*"]=> string(11) "5321 Jagras" }
        [1]=> array(3) {
          ["lang"]=> string(2) "eo"
          ["url"]=> string(41) "http://eo.wikipedia.org/wiki/5321_Jagraso"
          ["*"]=> string(12) "5321 Jagraso" }
        [2]=> array(3) {
          ["lang"]=> string(2) "fa"
          ["url"]=> string(84) "http://fa.wikipedia.org/wiki/%D8%B3%DB%8C%D8%A7%D8%B1%DA%A9_%DB%B5%DB%B3%DB%B2%DB%B1"               ["*"]=> string(19) "سیا" }
        [3]=> array(3) {
          ["lang"]=> string(2) "hu"
          ["url"]=> string(40) "http://hu.wikipedia.org/wiki/5321_Jagras"
          ["*"]=> string(11) "5321 Jagras" }
        [4]=> array(3) {
          ["lang"]=> string(2) "hy"
          ["url"]=> string(72) "http://hy.wikipedia.org/wiki/(5321)_%D5%8B%D5%A1%D5%A3%D6%80%D5%A1%D5%BD"
          ["*"]=> string(19) "(5321) Ջագրաս" }
        [5]=> array(3) {
          ["lang"]=> string(2) "la"
          ["url"]=> string(40) "http://la.wikipedia.org/wiki/5321_Jagras"
          ["*"]=> string(11) "5321 Jagras" }
        [6]=> array(3) {
          ["lang"]=> string(2) "oc"
          ["url"]=> string(40) "http://oc.wikipedia.org/wiki/5321_Jagras"
          ["*"]=> string(11) "5321 Jagras" }
        [7]=> array(3) {
          ["lang"]=> string(2) "pl"
          ["url"]=> string(42) "http://pl.wikipedia.org/wiki/(5321)_Jagras"
          ["*"]=> string(13) "(5321) Jagras" }
        [8]=> array(3) {
          ["lang"]=> string(2) "pt"
          ["url"]=> string(40) "http://pt.wikipedia.org/wiki/5321_Jagras"
          ["*"]=> string(11) "5321 Jagras" }
        [9]=> array(3) {
          ["lang"]=> string(2) "uk"
          ["url"]=> string(64) "http://uk.wikipedia.org/wiki/5321_%D0%AF%D2%91%D1%80%D0%B0%D1%81"
          ["*"]=> string(15) "5321 Яґрас"
        }
}

{{ WikiRand::getPlainTextArticle() }}
// returns
5321 Jagras è un asteroide della fascia principale. Scoperto nel 1985, presenta un'orbita caratterizzata da un semiasse maggiore pari a 2,5810209 UA e da un'eccentricità di 0,2213576, inclinata di 13,58746° rispetto all'eclittica. Collegamenti esterni (EN) Jagras - Dati riportati nel database dell'IAU Minor Planet Center (EN) Jagras - Dati riportati nel Jet Propulsion Laboratory - Small-Body Database

{{ WikiRand::getArticleImages() }}
// returns
array(2) {
      [0]=> string(63) "http://upload.wikimedia.org/wikipedia/commons/8/83/Celestia.png"
      [1]=> string(76) "http://upload.wikimedia.org/wikipedia/commons/9/9a/Galileo_Gaspra_Mosaic.jpg"
}

变更日志

请参阅 CHANGELOG 以获取更多信息。

测试

你可以使用以下命令运行测试

vendor/bin/phpunit run

或者，你可以这样运行测试

composer test

灵感

• WikiRandom

贡献

请参阅 CONTRIBUTING 以获取详细信息。

我该如何感谢你呢？

为什么不给 GitHub 仓库加星呢？我非常希望得到关注！为什么不分享这个仓库的链接到 Twitter 或 HackerNews？传播一下消息吧！

别忘了在 twitter 上关注我！

谢谢！Otemuyiwa Prosper。

许可证

MIT 许可证 (MIT)。请参阅 许可证文件 以获取更多信息。

安全

如果你发现任何与安全相关的问题，请通过电子邮件 prosperotemuyiwa@gmail.com 联系，而不是使用问题跟踪器。