hallindavid / phonehelper
dev-master
2021-02-19 04:18 UTC
Requires
- php: ^7.2
- illuminate/support: ^6.0|^7.0|^8.0
Requires (Dev)
- orchestra/testbench: ^5.1
- phpunit/phpunit: ^8.0|^9.0
This package is auto-updated.
Last update: 2023-02-01 21:56:48 UTC
README
PhoneHelper
一个用于Laravel的超级简单的电话号码格式化工具。注意 - 仅适用于北美电话号码。
入门 / 安装
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
从这里,您可以添加/删除/编辑格式,并且有很多注释可以帮助您做到这一点。
以下是示例格式
'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
支持
为了表示感谢,您可以在社交媒体上分享该项目或
问题
请在GitHub问题跟踪器中报告所有问题
贡献
给我发电子邮件,或在推特上私信我,我很乐意允许其他贡献者。