大苏科霍/laravel-dev-joke

本包提供了一种简单的方法,可以从DevJoke API获取随机开发笑话

v2.0.0 2023-06-08 14:48 UTC

This package is auto-updated.

Last update: 2024-09-15 20:40:59 UTC


README

Latest version on packagist MIT Licensed Unit Tests Static Analysis

本包提供了一种简单的方法,可以从这个DevJoke API获取随机开发笑话。

先决条件

本包需要

  • PHP 8.1或更高版本
  • Laravel 9.0或更高版本

如果你使用的是PHP 8.0版本,请使用本包的旧版本。

安装

你可以通过composer安装此包

composer require sissokho/laravel-dev-joke

用法

可以通过从容器中解析Sissokho\LaravelDevJoke\DevJoke类或将其注入到方法中来使用此包

use Sissokho\LaravelDevJoke\DevJoke;

public function joke(DevJoke $devJoke)
{
    $joke = $devJoke->random();

    $joke->question; // retrieve the question
    $joke->punchline; // retrieve the punchline
    $joke->toArray(); // ['question' => 'lorem', 'punchline' => 'ipsum']
}

randomJoke方法将返回一个Sissokho\LaravelDevJoke\DataTransferObjects\Joke对象,其中包含笑话的问题和结尾

您也可以使用外观

use Sissokho\LaravelDevJoke\Facades\DevJoke;

$joke = DevJoke::random();

Artisan

提供了一个Artisan命令,可以显示随机笑话

php artisan devjoke

笑话将显示如下

Screenshot from 2022-08-27 15-19-32

测试

您可以通过Laravel Pint在不更改文件的情况下运行PHPUnit测试、PHPStan/Larastan静态分析和检查代码中的样式错误

composer test

但是,您也可以单独运行这些测试。

  • 静态分析
composer test:types
  • PHPUnit测试
composer test:unit
  • 代码检查
composer test:style

要修复代码样式问题,请运行以下命令

composer stylefix

更新日志

请参阅更新日志以获取有关最近更改的更多信息。

致谢

非常感谢@askudhay提供此API。

许可证

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