在 Laravel 中 “規(guī)范” 的開發(fā)短信驗證碼發(fā)送功能

Laravel簡介

Laravel是一套簡潔、優(yōu)雅的PHP Web開發(fā)框架(PHP Web Framework)。它可以讓你從面條一樣雜亂的代碼中解脫出來；它可以幫你構(gòu)建一個完美的網(wǎng)絡APP，而且每行代碼都可以簡潔、富于表達力。

在Laravel中已經(jīng)具有了一套高級的PHP ActiveRecord實現(xiàn) -- Eloquent ORM。它能方便的將“約束（constraints）”應用到關系的雙方，這樣你就具有了對數(shù)據(jù)的完全控制，而且享受到ActiveRecord的所有便利。Eloquent原生支持Fluent中查詢構(gòu)造器（query-builder）的所有方法。

 Laravel 中 “規(guī)范” 的開發(fā)短信驗證碼發(fā)送功能需求場景

發(fā)送「驗證碼」或者「消息通知」，可發(fā)送到手機或郵箱中。

完成

首先，在 Laravel 中的規(guī)范就是使用 Laravel 的「消息通知」，這里基于場景為「驗證碼」。這個需求幾乎所有軟件系統(tǒng)都有使用到。

創(chuàng)建通知場景

第一步，使用 php artisan make:notification 創(chuàng)建一個通知類，創(chuàng)建成功后默認已經(jīng)存在了三個方法 via、toMail 和 toArray ，因為是發(fā)送驗證碼，姑將這個控制類命名為 VerificationCode 。

然后創(chuàng)建一個驗證碼數(shù)據(jù)模型和數(shù)據(jù)表遷移，可以使用 php artisan make:model \"VerificationCode\" -m 直接快速創(chuàng)建數(shù)據(jù)模型和遷移。

ThinkSNS+的遷移如下：

第二步，打開數(shù)據(jù)模型類，在里面添加 Illuminate\Notifications\Notifiable 性狀：

從代碼里面，可以看到我們還添加了「軟刪除」，因為是基于手機號或者郵箱的驗證碼發(fā)送，所以不需要其他的內(nèi)置花花腸子，也不需要記錄到 「消息通知數(shù)據(jù)表」中，所以 routeNotificationFor 方法我們選擇直接返回需要發(fā)送的賬號（手機號或郵箱）。

加入工廠模式，快捷發(fā)送

打開 database/factories/ModelFactory.php 在里面添加一個關于通知數(shù)據(jù)模型的工廠定義：

這樣，我們就可以通過 factory(\Zhiyi\Plus\Models\VerificationCode::class) 工廠函數(shù)快捷的創(chuàng)建驗證碼并發(fā)送通知。

為什么在驗證碼數(shù)據(jù)模型增加通知性狀？

首先 Illuminate\Notifications\Notifiable 這份性狀，Laravel 默認添加到 User 模型中的，所以通過 $user->notify() 可以快速的給用戶發(fā)送一個通知，但是在規(guī)范文檔中有這么一句話：

Remember, you may use the Illuminate\Notifications\Notifiable trait on any of your models. You are not limited to only including it on your User model.

這是Laravel官方文檔原話，意思就是Illuminate\Notifications\Notifiable不僅僅是用在 User 模型上。

所以我們在驗證碼模型中添加 Illuminate\Notifications\Notifiable 是完全符合Laravel通知的正確使用的。

開發(fā)通知類

首先，在數(shù)據(jù)表遷移中存在一個字段 channel 也就是通知頻道標識，我們可根據(jù)這個值來決定用什么方式發(fā)送驗證碼，而這個操作在通知類的 via 中實現(xiàn)的：

我們選擇方式就是直接返回 channel 值，這個值可以是任何值，只要我們實現(xiàn)了這個通知頻道，都可以發(fā)送，而Laravel已經(jīng)內(nèi)置和一些發(fā)送頻道 database、mail 和 nexmo

完成郵件驗證碼發(fā)送

其實，這個步驟我們要做的事情已經(jīng)很少了，生產(chǎn)通知類的時候，已經(jīng)完成了 toMail 方法，所以，我們直接修改其消息內(nèi)容即可。

完成短信驗證碼發(fā)送

短信發(fā)送我們采用 overtrue/easy-sms 包，這是安正超開發(fā)的一個短信發(fā)送客戶端，已經(jīng)內(nèi)置了很多短信平臺，實現(xiàn)也很優(yōu)秀。（吐槽：雖然有些細節(jié)有問題，例如不按照契約調(diào)用方法傳遞網(wǎng)關）

首先依賴短信發(fā)送客戶端包composer require overtrue/easy-sms然后新建配置 /config/sms.php ，內(nèi)容嘛，就按照 easy-sms 首頁的說明增加即可，先貼出我們的配置內(nèi)容（為了減少文章字數(shù)，只保留阿里大于配置）：

我門增加了一個 channel 配置，用于不同場景，例如驗證碼場景 code 以方便消息器讀取配置。

然后打開 AppServiceProvider.php 在 register 中增加如下：

至此 EasySms 在 Laravel 中的集成已經(jīng)完成，但是還沒有開發(fā)實際功能，我們接著往下看。

開發(fā) sms 發(fā)送頻道

為什么要開發(fā)？首先，easy-sms 支持的很多，可以考慮單獨為每個發(fā)送平臺開發(fā)一個通知發(fā)送頻道類，也可以采用只開發(fā)一個 sms 發(fā)送頻道類，我們選擇開發(fā)一個sms通知發(fā)送類，通過 easy-sms 的策略機制去多平臺發(fā)送驗證碼。

首先，新建一個 app/Notifications/Channels/SmsChannel.php 文件，因為 Laravel 沒有提供生成函數(shù)，這個需要自己創(chuàng)建喲，只要實現(xiàn) send 方法即可。 SmsChannel 內(nèi)容如下：

這樣基于 easy-sms 的 短信通知發(fā)送頻道已經(jīng)完成。

開發(fā)場景發(fā)送消息

這部分完全屬于 easy-sms 使用開發(fā)，我們新建一個 VerificationCodeMessage.php ，內(nèi)容如下：

然后我們回到 VerificationCode 驗證碼通知類中，增加 toSms 方法，我的代碼如下：

場景配置，例如驗證碼不同頻道的 template 等，這樣消息器就可以根據(jù)發(fā)送網(wǎng)關來判斷使用場景的配置是什么。

再次吐槽，easy-sms 的契約設計也應該是這個思想，但是 getContent/getTemplate/getData 在實際網(wǎng)關調(diào)用的時候根本沒有傳遞網(wǎng)關過來。。。

好了我們的開發(fā)完成了。

發(fā)送驗證碼

在創(chuàng)建驗證碼數(shù)據(jù)模型的時候就已經(jīng)添加到「工廠」中，所以我們可以直接使用 factory 函數(shù)了，發(fā)送演示：

大功告成，easy-sms 是一個很不錯的包喲。

上面代碼都是來自于 ThinkSNS Plus ，看完整的開發(fā)代碼可以看倉庫：

GitHub: https://github.com/slimkit/thinksns-plus

總結(jié)

以上所述是小編給大家介紹的在 Laravel 中 “規(guī)范” 的開發(fā)短信驗證碼發(fā)送功能，希望對大家有所幫助，如果大家有任何疑問請給我留言，小編會及時回復大家的。在此也非常感謝大家對腳本之家網(wǎng)站的支持！