README

简介

Phone-Number-Info 是一个Laravel包，提供有关电话号码的有用信息，包括家庭位置寄存器（HLR）洞察、号码类型、原始网络详情等。

特性

Phone-Number-Info Laravel包具有以下特性

电话号码验证
- 验证电话号码的格式和正确性。
HLR查询
- 执行家庭位置寄存器（HLR）查询以确定电话号码的实时状态和信息。
号码类型检测
- 检测电话号码类型，如移动电话或固定电话。
原始网络详情
- 检索电话号码原始网络提供商的详细信息。
号码携带检测
- 识别电话号码是否在不同运营商之间进行了携带。
短信和MMS电子邮件地址
- 获取与电话号码关联的短信和MMS电子邮件地址。
积分管理
- 跟踪用于API请求和使用的积分消耗。
请求参数
- 访问和分析用于获取电话号码信息的API请求中使用的参数。

先决条件

在开始使用Phone-Number-Info Laravel包之前，您必须满足以下先决条件

来自hlrlookup.com的API密钥和API密钥:
- 要访问HLR数据和执行电话号码查询，您需要从hlrlookup.com获取API密钥和API密钥。访问他们的网站（https://hlrlookup.com）以注册账户并获取所需的凭据。请注意，hlrlookup.com可能对其API服务的使用限制和定价政策有具体规定。
PHP 7.4或更高版本:
- 请确保您的服务器环境已安装PHP 7.4或更高版本，因为该包需要此最低PHP版本才能正确运行。
Laravel 8.0或更高版本:
- Phone-Number-Info Laravel包需要Laravel 8.0或更高版本。请确保您在项目中设置了兼容的Laravel框架。

安装

您可以通过Composer安装此包。在您的终端中运行以下命令

composer require bytes4sale/phone-number-info

配置

在开始使用此包之前，您需要在Laravel项目的.env文件中设置您的API密钥和API密钥。

打开您的Laravel项目的根目录。
创建或修改.env文件并添加以下内容

API_KEY=your_hlrlookup_api_key_here
API_SECRET=your_hlrlookup_api_secret_here,

使用方法

使用phone-number-info获取电话号码信息非常简单。只需按照以下步骤操作

初始化phone-number-info：在开始使用包之前，请确保初始化它。您可以通过将ServiceProvider添加到config/app.php文件来实现此操作
```
// config/app.php

'providers' => [
    // Other providers...
    Bytes4sale\PhoneNumberInfo\PhoneNumberInfoServiceProvider::class,
],
```

检索号码信息：一旦初始化了包，您就可以轻松获取电话号码的详细信息

 use Bytes4sale\PhoneNumberInfo\Facades\PhoneNumberInfo;

// Get information for a single phone number
 $phoneNumber = '921234567874';
 $response  = PhoneNumberInfo::getHlrDetails($phoneNumber);
 if ($response->isSuccessful()) {
     print_r($response->getContent());
     } else{
         print_r($response->getErrorResponse());
     }
 // Get information for multiple phone numbers
 $multiplePhoneNumbers = '921234567874,921234567891';
 $multipleResponse = PhoneNumberInfo::getHlrDetails($multiplePhoneNumbers);
 if ($multipleResponse->isSuccessful()) {
     print_r($multipleResponse->getContent());
     } else {
         print_r($multipleResponse->getErrorResponse());
     }

配置

phone-number-info允许您通过发布其配置文件来自定义其行为。为此，请运行以下artisan命令

php artisan vendor:publish --tag="number-info-config"

运行命令后，您将在config/phonenumberinfo.php中找到配置文件。您可以根据需要修改设置。

可用方法

贡献和错误报告

我们欢迎社区为改进bytes4sale电话号码信息做出贡献。如果您发现了一个错误或对新功能有建议，我们鼓励您参与进来，帮助我们使这个包变得更好。

错误报告

如果您在使用bytes4sale电话号码信息时遇到任何问题或错误，请在我们的GitHub仓库中提交一个issue。在报告错误时，请尽可能提供详细信息，包括

一个清晰且描述性的标题。
重现错误的步骤。
关于您的PHP和Laravel版本的信息。
任何相关的错误信息或截图。

功能请求

如果您有新的功能想法或改进，您也可以在我们的GitHub仓库中提交一个issue。请概述该功能的功能以及它解决的问题或为包增加的价值。

贡献

我们感谢社区为改进包做出的贡献。如果您想贡献代码，请按照以下步骤操作

从master分支创建仓库的分支。
实现您的更改或添加。
编写测试以确保新代码能够正确运行，并根据需要更新现有测试。
确保所有测试都通过。
创建一个pull request (PR)来提交您的更改。清楚地描述您所做的更改以及相关的issue或功能。

我们的团队将审查您的PR，如果一切看起来都很好，我们将将其合并到master分支。

通过为bytes4sale电话号码信息做出贡献，您同意在本次包下提供您的贡献。

我们感谢我们的贡献者，您的帮助将使该包对每个人来说都更好。谢谢！

许可

MIT许可（MIT）。有关更多信息，请参阅许可文件。

致谢

如果您觉得这个包很有帮助，请考虑给予作者和贡献者应有的认可。

bytes4sale / phone-number-info

维护者

详细信息