gregpriday/laravel-serper

这是我开发的laravel-serper包

0.1 2024-02-29 17:10 UTC

This package is auto-updated.

Last update: 2024-09-15 10:37:56 UTC


README

介绍

laravel-serper包是一个简单的、高效的Serper.dev API包装器,旨在无缝集成到Laravel应用程序中。它提供了一个流畅、易于理解的接口,通过Serper.dev执行搜索并检索Google新闻结果,使开发者更容易在Laravel应用程序中包含搜索功能。

功能

  • 用于执行搜索和检索新闻结果的简单易用的外观。
  • 支持单次和多次查询,参数可自定义。
  • 与Laravel的服务容器集成,便于配置和扩展。
  • 利用GuzzleHttp进行高效的HTTP请求。
  • 包含一系列单元测试,以提高可靠性和可维护性。

安装

要安装Laravel Serper包,请在终端运行以下命令

composer require gregpriday/laravel-serper

安装后,通过运行以下命令发布包的配置文件

php artisan vendor:publish --provider="GregPriday\LaravelSerper\SerperServiceProvider"

配置

在使用Serper包之前,您必须从Serper.dev获取API密钥并将其添加到您的.env文件中

SERPER_API_KEY=your_serper_dev_api_key

然后,在config/serper.php配置文件中配置您的API密钥

return [
    'key' => env('SERPER_API_KEY', ''),
];

用法

Laravel Serper包提供了一个简单的API来执行搜索和新闻查询。以下是如何使用它的示例

执行搜索

要执行搜索,请使用Serper::search方法

use GregPriday\LaravelSerper\Facades\Serper;

$results = Serper::search('Laravel');

检索新闻结果

要检索新闻结果,请在search方法中指定类型为'news'

$newsResults = Serper::search('Laravel', 10, 'news');

执行多次搜索

要同时执行多次搜索,请使用Serper::searchMulti方法

$queries = ['Laravel', 'PHP'];
$results = Serper::searchMulti($queries, 10, 'search');

测试

此包包含一系列PHPUnit测试。要运行测试,请使用以下命令

vendor/bin/phpunit

贡献

欢迎贡献!请随时提交拉取请求或在该GitHub存储库上打开问题。

许可证

Laravel Serper包是开源软件,采用MIT许可证