hallindavid/phonehelper

此包已被废弃,不再维护。作者建议使用 hallindavid/manny 包。

一个用于Laravel的超级简单的电话号码格式化工具。注意 - 仅适用于北美电话号码。

dev-master 2021-02-19 04:18 UTC

README

hallindavid

PhoneHelper

一个用于Laravel的超级简单的电话号码格式化工具。注意 - 仅适用于北美电话号码。

demo-phonehelper.gif

入门 / 安装

composer require hallindavid/phonehelper

Laravel应该会自动发现Provider和别名。

现在你应该可以使用PhoneHelper别名来格式化电话号码。

例如

PhoneHelper::format('12345678912');
// defult result: 234-567-8912

用法

对于基本用法,您可以使用别名PhoneHelper和格式化函数。

use PhoneHelper;

class TestController extends Controller
{
    public function index()
    {
        $newPhone = PhoneHelper::format('12345678912');
    }
}

使用不同的格式

默认情况下,PhoneHelper包含以下格式

格式 输出(输入8888888888888)
10 8888888888
10-破折号(默认) 888-888-8888
10-括号 (888) 888-8888
10-括号扩展 (888) 888-8888 ext. 888
10-点 888.888.8888
11 18888888888
11-破折号 1-888-888-8888
11-括号 1 (888) 888-8888
11-点 1.888.888.8888
+11-括号 +1 (888) 888-8888
E.164(适用于Twilio和其他API) +18888888888

我还开始开发扩展,但离完成还有一段距离。它将很快推出。

创建/修改格式

您可以将配置发布

php artisan vendor:publish --provider="Hallindavid\PhoneHelper\PhoneHelperServiceProvider"

这将创建配置文件: config/phonehelper.php

从这里,您可以添加/删除/编辑格式,并且有很多注释可以帮助您做到这一点。

此图显示了电话号码格式化工具的不同部分。 formatting-phones.png

以下是示例格式

'my-custom-format'=> [
    'parts'=>['country','area','exchange','line','extension'],
    'delimiters'=>[
        'prefix'=> '+',
        'country_area'=> ' (',
        'area_exchange'=> ') ',
        'exchange_line'=>'-',
        'line_extension'=>' ext. ',
    ]
],

设置好之后 - 您可以执行此操作

PhoneHelper::format('8888888888888', 'my-custom-format');
// +1 (888) 888-8888 ext. 888

测试

对于包装格式,有很多测试 - 要运行它们,请拉取包然后

composer install
composer test

支持

为了表示感谢,您可以在社交媒体上分享该项目或

Buy Me A Coffee

问题

请在GitHub问题跟踪器中报告所有问题

贡献

给我发电子邮件,或在推特上私信我,我很乐意允许其他贡献者。