Laravel是一套簡潔、優雅的PHP Web開發架構(PHP Web Framework)。接下來透過本文跟大家分享在Laravel 中「規範」 的開發簡訊驗證碼發送功能,需要的朋友參考吧
Laravel簡介
Laravel是一套簡潔、優雅的PHP Web開發架構(PHP Web Framework)。它可以讓你從麵條一樣雜亂的程式碼中解脫出來;它可以幫你建立一個完美的網路APP,而且每行程式碼都可以簡潔、富於表達力。
在Laravel中已經具有了一套高階的PHP ActiveRecord實作 -- Eloquent ORM。它能方便的將「約束(constraints)」應用到關係的雙方,這樣你就具有了對數據的完全控制,而且享受到ActiveRecord的所有便利。 Eloquent原生支援Fluent中查詢建構器(query-builder)的所有方法。
Laravel 中「規格」 的開發簡訊驗證碼發送功能需求場景
發送「驗證碼」或「訊息通知」,可發送到手機或信箱。
完成
首先,在 Laravel 中的規格就是使用 Laravel 的「訊息通知」,這裡基於場景為「驗證碼」。這個需求幾乎所有軟體系統都有使用到。
建立通知場景
第一步,使用php artisan make:notification 建立一個通知類,創建成功後預設已經存在了三個方法via、toMail 和toArray ,因為是傳送驗證碼,姑將這個控制類別命名為VerificationCode 。
然後建立一個驗證碼資料模型和資料表遷移,可以使用 php artisan make:model \"VerificationCode\" -m 直接快速建立資料模型和遷移。
ThinkSNS+的遷移如下:
第二步,開啟資料模型類別,在裡面加入Illuminate\Notifications\Notifiable 性狀:
從代碼裡面,可以看到我們還添加了「軟刪除」,因為是基於手機號碼或郵箱的驗證碼發送,所以不需要其他的內置花花腸子,也不需要記錄到「訊息通知資料表」中,所以routeNotificationFor 方法我們選擇直接傳回需要傳送的帳號(手機號碼或信箱)。
加入工廠模式,快捷發送
#打開database/factories/ModelFactory.php 在裡面新增一個關於通知資料模型的工廠定義:
這樣,我們就可以透過factory(\Zhiyi\Plus\Models\VerificationCode::class) 工廠函數快速的建立驗證碼並傳送通知。
為什麼在驗證碼資料模型增加通知性狀?
首先Illuminate\Notifications\Notifiable 這份性狀,Laravel 預設加入到User 模型中的,所以透過$user->notify() 可以快速的給使用者發送一個通知,但是在規範文件中有這麼一句話:
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.
#Lara##Lara#Lara#官方文檔原話,意思是Illuminate\Notifications\Notifiable不只是用在User 模型上。 所以我們在驗證碼模型中加入 Illuminate\Notifications\Notifiable 是完全符合Laravel通知的正確使用的。開發通知類別
首先,在資料表遷移中存在一個欄位channel 也就是通知頻道標識,我們可根據這個值來決定用什麼方式發送驗證碼,而這個操作在通知類別的via 中實現的: 我們選擇方式就是直接回傳channel 值,這個值可以是任何值,只要我們實現了這個通知頻道,都可以發送,而Laravel已經內建和一些發送頻道database、mail 和nexmo完成郵件驗證碼發送
其實,這個步驟我們要做的事情已經很少了,生產通知類別的時候,已經完成了toMail 方法,所以,我們直接修改其訊息內容即可。完成簡訊驗證碼發送
簡訊發送我們採用overtrue/easy-sms 包,這是安正超開發的一個短信發送客戶端,已經內建了很多簡訊平台,實作也很優秀。 (吐槽:雖然有些細節有問題,例如不按照契約調用方法傳遞網關)
首先依賴短信發送客戶端包composer require overtrue/easy-sms然後新建配置/config/sms.php ,內容嘛,就按照easy-sms 首頁的說明增加即可,先貼出我們的配置內容(為了減少文章字數,只保留阿里大於配置):
##我門增加了一個channel 配置,用於不同場景,例如驗證碼場景code 以方便訊息器讀取配置。
然後開啟AppServiceProvider.php 在register 中增加如下: 至此EasySms 在Laravel 中的整合已經完成,但還沒有開發實際功能,我們接著往下看。開發 sms 發送頻道
為什麼要開發?首先,easy-sms 支援的很多,可以考慮單獨為每個發送平台開發一個通知發送頻道類,也可以採用只開發一個sms 發送頻道類,我們選擇開發一個sms通知發送類,透過easy-sms 的策略機制去多平台發送驗證碼。 首先,新建一個 app/Notifications/Channels/SmsChannel.php 文件,因為 Laravel 沒有提供生成函數,這個需要自己建立喲,只要實作 send 方法即可。 SmsChannel 內容如下: 這樣基於 easy-sms 的 簡訊通知發送頻道已經完成。 這部分完全屬於easy-sms 使用開發,我們新建一個VerificationCodeMessage.php ,內容如下: 然後我們回到VerificationCode 驗證碼通知類別中,增加toSms 方法,我的程式碼如下: 場景配置,例如驗證碼不同頻道的template 等,這樣訊息器就可以根據發送網關來判斷使用場景的配置是什麼。 再次吐槽,easy-sms 的契約設計也應該是這個思想,但是 getContent/getTemplate/getData 在實際網關呼叫的時候根本沒有傳遞網關過來。 。 。 好了我們的開發完成了。發送驗證碼
在建立驗證碼資料模型的時候就已經加入到「工廠」中,所以我們可以直接使用factory函數了,發送示範: 大功告成,easy-sms 是個很不錯的套件喲。以上是Laravel中開發簡訊驗證碼發送功能的「規格」 (圖)的詳細內容。更多資訊請關注PHP中文網其他相關文章!