{"id":19300013,"url":"https://github.com/zfegg/sms-sender","last_synced_at":"2025-04-22T10:31:19.580Z","repository":{"id":57090473,"uuid":"65275419","full_name":"zfegg/sms-sender","owner":"zfegg","description":"SMS sender service. And use for send sms captcha handler  / 短信发送模块, 并且用于发送短信验证码处理程序","archived":false,"fork":false,"pushed_at":"2022-10-22T04:06:24.000Z","size":62,"stargazers_count":4,"open_issues_count":0,"forks_count":4,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-23T20:43:38.794Z","etag":null,"topics":["sms"],"latest_commit_sha":null,"homepage":"","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zfegg.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-08-09T08:01:26.000Z","updated_at":"2023-12-25T19:01:39.000Z","dependencies_parsed_at":"2022-08-20T16:50:13.178Z","dependency_job_id":null,"html_url":"https://github.com/zfegg/sms-sender","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zfegg%2Fsms-sender","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zfegg%2Fsms-sender/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zfegg%2Fsms-sender/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zfegg%2Fsms-sender/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zfegg","download_url":"https://codeload.github.com/zfegg/sms-sender/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223893052,"owners_count":17220834,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["sms"],"created_at":"2024-11-09T23:13:25.630Z","updated_at":"2024-11-09T23:13:26.291Z","avatar_url":"https://github.com/zfegg.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"短信发送抽象接口\n==============\n\n\n[![GitHub Actions: Run tests](https://github.com/zfegg/sms-sender/workflows/qa/badge.svg)](https://github.com/zfegg/sms-sender/actions?query=workflow%3A%22qa%22)\n[![Coverage Status](https://coveralls.io/repos/github/zfegg/sms-sender/badge.svg?branch=master)](https://coveralls.io/github/zfegg/sms-sender?branch=master)\n[![Coverage Status](https://coveralls.io/repos/github/zfegg/sms-sender/badge.svg?branch=master)](https://coveralls.io/github/zfegg/sms-sender?branch=master)\n[![Latest Stable Version](http://poser.pugx.org/zfegg/sms-sender/v)](https://packagist.org/packages/zfegg/sms-sender)\n[![Total Downloads](http://poser.pugx.org/zfegg/sms-sender/downloads)](https://packagist.org/packages/zfegg/sms-sender)\n[![License](http://poser.pugx.org/zfegg/sms-sender/license)](https://packagist.org/packages/zfegg/sms-sender)\n[![PHP Version Require](http://poser.pugx.org/zfegg/sms-sender/require/php)](https://packagist.org/packages/zfegg/sms-sender)\n\n\n抽象常用短信业务:\n\n1. 实现短信的限制发送（60s 内限制发送1次，1天上限发送10次）\n2. 短信验证码生成与验证功能 \n\n## Installation / 安装\n\n使用 Composer 安装\n\n~~~\n$ composer require zfegg/sms-sender\n~~~\n\n\n## Interfaces / 接口说明\n\n* `Zfegg/SmsSender/Provider/ProviderInterface` 短信供应商实现接口\n\n## Usage / 使用\n\n### 基本使用示例代码：\n\n[示例代码](examples/basic.php)\n\n### 在 Expressive 中使用：\n\n在 `config/application.php` 中添加模块加载.\n\n~~~php\nreturn array(\n    'modules' =\u003e array(\n        //... Your modules\n        'Zfegg/SmsSender'\n    ),\n);\n~~~\n\n添加短信发送配置 `module.config.php`\n\n~~~php\n\nreturn [\n    'dependencies' =\u003e [\n        'factories' =\u003e [\n            ProviderInterface::class =\u003e YourSmsProviderFactory::class,\n        ],\n    ]\n    'zfegg' =\u003e [\n        LimitSender::class =\u003e [\n            'provider' =\u003e ProviderInterface::class, // 设置短信商服务名. (可选), 默认 `ProviderInterface::class`\n            'cache' =\u003e CacheInterface::class, // 设置缓存服务名 (可选), 默认 `CacheInterface::class`\n            'day_send_times' =\u003e 10, // 设置每天发送次数上限 (可选), 默认10\n            'waiting_time' =\u003e 60, //设置每次发送等待时长 (可选), 默认60s\n        ],\n        PostSmsCaptchaHandler::class  =\u003e [\n            'types' =\u003e [\n               'register' =\u003e 'Register captcha code: {code}',\n               'login' =\u003e 'Login captcha code: {code}',\n            ]\n        ],\n    ]\n];\n~~~\n\n控制器使用：\n\n~~~php\n\n//发送验证码\n$app-\u003epost('/api/send-sms-captcha', PostSmsCaptchaHandler::class);\n\n//业务验证码验证\n$app-\u003epost('/register', [\n  function ($req, $handler) {\n  \n    //配置验证器\n    $inputFilter = (new \\Laminas\\InputFilter\\Factory)-\u003ecreate([\n        [\n            'name' =\u003e 'captcha',\n            'validators' =\u003e [\n                [\n                    'name' =\u003e SmsCode::class,\n                    'options' =\u003e [\n                        'inputName' =\u003e 'phone',\n                    ]\n                ]\n            ]\n        ],\n        [\n            'name' =\u003e 'phone',\n            'validators' =\u003e [\n                [\n                    'name' =\u003e 'PhoneNumber',\n                ]\n            ]\n        ],\n    ])\n  \n    if (! $inputFilter-\u003eisValid()) {\n        //验证失败响应\n        return new JsonResponse(['messages' =\u003e $inputFilter-\u003egetMessages()], 403);\n    }\n\n    //验证成功继续注册\n    return $handler-\u003ehandle($req);\n  },\n  YourRegisterHandler::class,\n])\n~~~\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzfegg%2Fsms-sender","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzfegg%2Fsms-sender","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzfegg%2Fsms-sender/lists"}