gregpriday / laravel-serper
这是我开发的laravel-serper包
0.1
2024-02-29 17:10 UTC
Requires
- php: ^8.3
- guzzlehttp/guzzle: ^7.8
- illuminate/contracts: ^10.0
- spatie/laravel-package-tools: ^1.14.0
Requires (Dev)
- larastan/larastan: ^2.0.1
- laravel/pint: ^1.0
- nunomaduro/collision: ^7.8
- orchestra/testbench: ^8.8
- pestphp/pest: ^2.20
- pestphp/pest-plugin-arch: ^2.5
- pestphp/pest-plugin-laravel: ^2.0
- phpstan/extension-installer: ^1.1
- phpstan/phpstan-deprecation-rules: ^1.0
- phpstan/phpstan-phpunit: ^1.0
- spatie/laravel-ray: ^1.26
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许可证。