Download the PHP package zhouzishu/laravel-sms without Composer
On this page you can find all versions of the php package zhouzishu/laravel-sms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package laravel-sms
Laravel SMS
一个基于Laravel框架的功能强大的手机号合法性验证解决方案。
1. 关于本拓展包
laravel-sms 是基于toplan/laravel-sms修改的，因为原作者已经不维护，并且原先依赖的toplan/phpsms多数接口已经失效，故依赖overtrue/easy-sms进行短信发送。
config/laravel-sms.php验证码及短信发送业务配置
2. why me
为了更进一步提高开发效率，laravel-sms为Laravel框架定制好了如下功能：
- 可扩展的发送前数据验证
- 集成验证码发送与验证模块，从此告别重复写验证码短信发送与校验的历史
- 灵活的动态验证规则
- 可选的数据库日志
- 验证码发送与验证模块的无session支持
3. 如何快速开始?
上面提了这么多特性，那么如何快速上手并体验一下验证码发送与验证呢?只需要依次完成以下三个步骤即可。
- step1: 安装
- step2: 准备工作
- step3: 验证码模块
安装
在项目根目录下运行如下composer命令:
准备工作
1.注册服务提供器 (optional. if laravel < 5.5)
在config/app.php文件中providers数组里加入：
在config/app.php文件中的aliases数组里加入
2.参数配置
- 生成配置文件和migration文件
这里会生成配置文件，分别为laravel-sms.php。easy_sms的配置请参考overtrue/easy-sms
发送前数据验证
1. 声明
当客户端向服务器端请求发送验证码短信时，服务器端需要对接收到的数据(本库将其称为field)进行验证，只有在所有需验证的数据都通过了验证才会向第三方服务提供商发起请求。
对于每项你想验证的field，不管是使用静态验证规则还是动态验证规则，都需要提前到配置文件(config/laravel-sms.php)中声明，并做好必要的配置。
本文档中所说的
服务器端是我们自己的应用系统，而非第三方短信服务提供商。
配置项
对于每项数据，都有以下几项可设置:
| 配置项 | 必填 | 说明 |
|---|---|---|
| isMobile | 否 | 是否为手机号码 |
| enable | 是 | 是否需要进行验证 |
| default | 否 | 默认静态验证规则 |
| staticRules | 否 | 所有静态验证规则 |
示例
2. 使用
静态验证规则和动态验证规则的使用方法一致。
客户端
通过{field}_rule参数告知服务器{field}参数需要使用的验证规则的名称。
比如mobile_rule参数可以告知服务器在验证mobile参数时使用什么验证规则，
image_captcha_rule参数可以告知服务器在验证image_captcha参数时使用什么验证规则。
服务器端
示例见此
验证码模块
可以直接访问http[s]://your-domain/laravel-sms/info查看该模块是否启用，并可在该页面里观察验证码短信发送状态，方便你进行调试。
如果是api应用(无session)需要在上述地址后面加上
?access_token=xxxx
1. [服务器端]配置短信内容/模板
短信内容
如果你使用了内容短信，则需要设置content的值。
配置文件为config/laravel-sms.php
2. [浏览器端]请求发送验证码短信
该包已经封装好浏览器端的基于jQuery(zepto)的发送插件，只需要为发送按钮添加扩展方法即可实现发送短信。
js文件在本库的js文件夹中，请复制到项目资源目录。
laravel-sms.js 的更多用法请见此
3. [服务器端]合法性验证
用户填写验证码并提交表单到服务器时，在你的控制器中需要验证手机号和验证码是否正确，你只需要加上如下代码即可：
confirm_mobile_not_change,verify_code,confirm_rule的详解请参看Validator扩展
Validator扩展
zh_mobile
检测标准的中国大陆手机号码。
confirm_mobile_not_change
检测用户提交的手机号是否变更。
verify_code
检测验证码是否合法且有效，如果验证码错误，过期或超出尝试次数都无法验证通过。
confirm_rule:$ruleName
检测验证规则是否合法，后面跟的第一个参数为待检测的验证规则的名称。
如果不填写参数$ruleName（不写冒号才表示不填写哦），系统会尝试设置其为前一个访问路径的path部分。
数据库日志
开发调试过程中，如果需要查看短信发送结果的详细信息，建议打开数据库日志。
1. 生成数据表
运行如下命令在数据库中生成laravel_sms表。
2. 开启权限
在配置文件config/laravel-sms.php中设置dbLogs为true。
无会话支持
1. 服务器端准备
在config/laravel-sms.php中配置路由器组中间件middleware。
2. Access Token
Access Token值建议设置在请求头中的Access-Token上，当然也可以带在请求参数access_token中。
根据你的实际应用场景，也可考虑将手机号作为
access_token。
3. 请求地址
- 短信:
scheme://host/laravel-sms/verify-code
4. 默认参数
| 参数名 | 必填 | 说明 |
|---|---|---|
| mobile | 是 | 手机号码 |
| mobile_rule | 否 | 手机号检测规则 |
5. 响应数据
| 参数名 | 说明 |
|---|---|
| success | 是否请求发送成功 |
| type | 类型 |
| message | 详细信息 |
API
laravel-sms提供的所有功能都是由该章节的接口和phpsms的接口实现的。
虽然通过配置文件可以完成基本所有的常规需求，但是对于更加变态（个性化）的需求，
可能需要在laravel-sms的基础上做定制化的开发，在这种情况下阅读该章节或许能给你提供帮助，否则可以忽略该章节。
1. 发送前校验
validateSendable()
校验是否可进行发送。如果校验未通过，返回数据中会包含错误信息。
validateFields([$input][, $validation])
校验数据合法性。如果校验未通过，返回数据中会包含错误信息。
2. 发送
requestVerifySms()
请求发送验证码短信。
3. 发送状态
state([$key][, $default])
获取当前的发送状态（非持久化的）。
retrieveState([$key])
获取持久化存储的发送状态，即存储到session或缓存中的状态数据。
updateState($name, $value)
更新持久化存储的发送状态。
forgetState()
删除持久化存储的发送状态。
4. 动态验证规则
storeRule($field[, $name], $rule);
定义客户端数据（字段）的动态验证规则。
存储的动态验证规则可通过访问
http[s]://your-domain/laravel-sms/info查看。 动态验证规则的名称最好不要和静态验证规则同名,因为静态验证规则的优先级更高。
retrieveRule($field[, $name])
获取字段的指定名称的动态验证规则。
retrieveRules($field)
获取字段的所有动态验证规则。
forgetRule($field[, $name])
删除字段的指定名称的动态验证规则。
forgetRules($field)
删除字段的所有动态验证规则。
5. 客户端数据
input([$key][, $default])
获取客户端传递来的数据。客户端数据会自动注入到配置文件(laravel-sms.php)中闭包函数的$input参数中。
6. 其它
closure($closure)
序列化闭包。
laravel-sms.js
License
MIT
