(0)摘要
# 课程链接
入门到实战,讲讲公司的微信小程序【django+drf+小程序实战】_哔哩哔哩_bilibili
# 微信开发者文档
# 课程内容
(1)P28_用户登录页面
(2)P29_发送短信验证码
(3)P30_day04 用户登录
# 纵有疾风起,人生不言弃。
(1)P28_用户登录页面
# (1)这节武sir 只是当了回 cv 工程师~~~
百度云链接:https://pan.baidu.com/s/1n0btgLA_mTyWuLCPzRR3Yg 密码: h3a6
(2)P29_发送短信验证码
# (1)腾讯的发送短息验证码的 SDK_原生
1)首先上 SDK 的文档链接。
2)我们看了文档之后知道,要首先安装所提供的 SDK ,那么就是通过 pip 来安装了,命令:pip3 install --upgrade tencentcloud-sdk-python ,如下所示。【官方是给的 pip 来安装,但是亲测不行,需要用 pip3 来安装】
3)以下是发送短信的代码。
# -*- coding: utf-8 -*- from tencentcloud.common import credential from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException # 导入对应产品模块的client models。 from tencentcloud.sms.v20210111 import sms_client, models # 导入可选配置类 from tencentcloud.common.profile.client_profile import ClientProfile from tencentcloud.common.profile.http_profile import HttpProfile try: # 必要步骤: # 实例化一个认证对象,入参需要传入腾讯云账户密钥对secretId,secretKey。 # 这里采用的是从环境变量读取的方式,需要在环境变量中先设置这两个值。 # 你也可以直接在代码中写死密钥对,但是小心不要将代码复制、上传或者分享给他人, # 以免泄露密钥对危及你的财产安全。 # SecretId、SecretKey 查询: https://console.cloud.tencent.com/cam/capi cred = credential.Credential("secretId", "secretKey") # cred = credential.Credential( # os.environ.get(""), # os.environ.get("") # ) # 实例化一个http选项,可选的,没有特殊需求可以跳过。 httpProfile = HttpProfile() # 如果需要指定proxy访问接口,可以按照如下方式初始化hp(无需要直接忽略) # httpProfile = HttpProfile(proxy="http://用户名:密码@代理IP:代理端口") httpProfile.reqMethod = "POST" # post请求(默认为post请求) httpProfile.reqTimeout = 30 # 请求超时时间,单位为秒(默认60秒) httpProfile.endpoint = "sms.tencentcloudapi.com" # 指定接入地域域名(默认就近接入) # 非必要步骤: # 实例化一个客户端配置对象,可以指定超时时间等配置 clientProfile = ClientProfile() clientProfile.signMethod = "TC3-HMAC-SHA256" # 指定签名算法 clientProfile.language = "en-US" clientProfile.httpProfile = httpProfile # 实例化要请求产品(以sms为例)的client对象 # 第二个参数是地域信息,可以直接填写字符串ap-guangzhou,支持的地域列表参考 https://cloud.tencent.com/document/api/382/52071#.E5.9C.B0.E5.9F.9F.E5.88.97.E8.A1.A8 client = sms_client.SmsClient(cred, "ap-guangzhou", clientProfile) # 实例化一个请求对象,根据调用的接口和实际情况,可以进一步设置请求参数 # 你可以直接查询SDK源码确定SendSmsRequest有哪些属性可以设置 # 属性可能是基本类型,也可能引用了另一个数据结构 # 推荐使用IDE进行开发,可以方便的跳转查阅各个接口和数据结构的文档说明 req = models.SendSmsRequest() # 基本类型的设置: # SDK采用的是指针风格指定参数,即使对于基本类型你也需要用指针来对参数赋值。 # SDK提供对基本类型的指针引用封装函数 # 帮助链接: # 短信控制台: https://console.cloud.tencent.com/smsv2 # 腾讯云短信小助手: https://cloud.tencent.com/document/product/382/3773#.E6.8A.80.E6.9C.AF.E4.BA.A4.E6.B5.81 # 短信应用ID: 短信SdkAppId在 [短信控制台] 添加应用后生成的实际SdkAppId,示例如1400006666 # 应用 ID 可前往 [短信控制台](https://console.cloud.tencent.com/smsv2/app-manage) 查看 req.SmsSdkAppId = "1400787878" # 短信签名内容: 使用 UTF-8 编码,必须填写已审核通过的签名 # 签名信息可前往 [国内短信](https://console.cloud.tencent.com/smsv2/csms-sign) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-sign) 的签名管理查看 req.SignName = "腾讯云" # 模板 ID: 必须填写已审核通过的模板 ID # 模板 ID 可前往 [国内短信](https://console.cloud.tencent.com/smsv2/csms-template) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-template) 的正文模板管理查看 req.TemplateId = "449739" # 模板参数: 模板参数的个数需要与 TemplateId 对应模板的变量个数保持一致,,若无模板参数,则设置为空 req.TemplateParamSet = ["1234"] # 下发手机号码,采用 E.164 标准,+[国家或地区码][手机号] # 示例如:+8613711112222, 其中前面有一个+号 ,86为国家码,13711112222为手机号,最多不要超过200个手机号 req.PhoneNumberSet = ["+8613711112222"] # 用户的 session 内容(无需要可忽略): 可以携带用户侧 ID 等上下文信息,server 会原样返回 req.SessionContext = "" # 短信码号扩展号(无需要可忽略): 默认未开通,如需开通请联系 [腾讯云短信小助手] req.ExtendCode = "" # 国际/港澳台短信 senderid(无需要可忽略): 国内短信填空,默认未开通,如需开通请联系 [腾讯云短信小助手] req.SenderId = "" resp = client.SendSms(req) # 输出json格式的字符串回包 print(resp.to_json_string(indent=2)) # 当出现以下错误码时,快速解决方案参考 # - [FailedOperation.SignatureIncorrectOrUnapproved](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Afailedoperation.signatureincorrectorunapproved-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F) # - [FailedOperation.TemplateIncorrectOrUnapproved](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Afailedoperation.templateincorrectorunapproved-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F) # - [UnauthorizedOperation.SmsSdkAppIdVerifyFail](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Aunauthorizedoperation.smssdkappidverifyfail-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F) # - [UnsupportedOperation.ContainDomesticAndInternationalPhoneNumber](https://cloud.tencent.com/document/product/382/9558#.E7.9F.AD.E4.BF.A1.E5.8F.91.E9.80.81.E6.8F.90.E7.A4.BA.EF.BC.9Aunsupportedoperation.containdomesticandinternationalphonenumber-.E5.A6.82.E4.BD.95.E5.A4.84.E7.90.86.EF.BC.9F) # - 更多错误,可咨询[腾讯云助手](https://tccc.qcloud.com/web/im/index.html#/chat?webAppId=8fa15978f85cb41f7e2ea36920cb3ae1&title=Sms) except TencentCloudSDKException as err: print(err)
# (2)腾讯的发送短息验证码的 SDK_针对我们项目简化的
1)所需要的数据,就是如下的签名、模板、API key 等数据。这是调用 SDK 测试发送短信功能必须的数据。
2)简化后的代码,以及将国家的区号添加到手机号中。即如下代码。
# 4. 生成验证码 import random random_code = random.randint(1000, 9999) print(random_code) # 5. 然后将生成的验证码 random_code 发送到手机上面,这里需要购买相应的服务,只需要朝相应的 api 发请求就可以得到验证码了 # 一般买的是阿里云/腾讯云的服务,前者居多,但是微信小程序自然是选择腾讯云啦。 from tencentcloud.common import credential from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException # 导入对应产品模块的client models。 from tencentcloud.sms.v20210111 import sms_client, models CHINA = "+86" phoneNum = "{}{}".format(CHINA, phoneNum) try: # 这里是填 API Key cred = credential.Credential("SecretId", "SecretKey") # 填地方的 client = sms_client.SmsClient(cred, "ap-guangzhou") req = models.SendSmsRequest() # 填应用程序的 ID req.SmsSdkAppId = "填 SDK AppID" # 短信签名内容: 使用 UTF-8 编码,必须填写已审核通过的签名 # 签名信息可前往 [国内短信](https://console .cloud.tencent.com/smsv2/csms-sign) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-sign) 的签名管理查看 req.SignName = "填签名管理的签名内容" # 签名模板 id req.TemplateId = "填签名模板 id" # 模板的参数,就是我们的验证码填的地方, # 务必看一下模板定义的几个参数, 如果有两个参数,那么传参就需要两个,且为字符串类型 req.TemplateParamSet = [str(random_code), "1"] # 电话号码,但是我们是国内的手机号,所以要 +86 req.PhoneNumberSet = [phoneNum] resp = client.SendSms(req) # 输出json格式的字符串回包 print(resp.to_json_string(indent=2)) except TencentCloudSDKException as err: print(err) # 6. 保留验证码+手机号,并且保留30秒。 # 这里我们使用 django-redis 来做 from django_redis import get_redis_connection conn = get_redis_connection() # 创建链接 conn.set(phoneNum, random_code, ex=30) # 保留手机号和验证码,以及保留时间 30 秒
【这里已经看到课程的 7 分钟了。】
# (3)搭建 redis 数据库服务器
1)其实 redis 服务器的目的就是将生成的验证码存在内存数据库中(因为要设置数据的过期时间,并且有一定的性能要求,所以才会使用 redis),用于和用户发来的验证码进行校验。那么首先就是在虚拟机里面,开启 redis 服务端,如下所示,我们以自定义的 .conf 配置文件启动,
而后再另开一个终端界面,查看是否开启了 redis 服务进程,当然也可以是 netstat -tunlp | grep redis 命令。
执行完成后,我们务必清空一下防火墙规则,否则登陆不上。
2)搭建完成后,我们测试一下连通性,即回到 pycharm 里面建一个脚本测试,具体代码如下所示,显然已经连通了。
确认无误后,我们还需要执行一下清空 redis 当前键值缓存。具体的操作代码如下所示
3)最后,测试腾讯云短信发送的功能。这里直接上测试截图~~我们开启了 redis 还要 django 服务之后,在小程序端点击发送验证码,然后控制台如果显示如下界面,就是发送成功了
那么可以看到手机收到了验证码,如下所示:
4)可能踩得坑,一个是参数错误,还有一个是不支持的类型?总之如果出现 InvalidParameter 那就是参数错误了,然后要看是什么报错,比如我是设置模板参数的时候出问题了,后来看了下文档是因为模板内容有多个参数,所以有几个就要传几个。错误文档链接:短信 其他问题-常见问题-文档中心-腾讯云 。还要注意的是,模板参数是字符串类型数据。
# (4)进一步封装代码
1)我们可以把发送短信这一块的代码封装一下,方便以后的调用,如下所示。那么我们只提一下,我们之后的一些必要的短信参数,就写在配置文件里面,方便调用。
# -*- coding=utf-8 -*- # github: night_walkiner # csdn: 潘迪仔 from tencentcloud.common import credential from tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException # 导入对应产品模块的client models。 from tencentcloud.sms.v20210111 import sms_client, models from drf import settings def send_message(phone, random_code, expire="60", template="1465584"): phone = "{}{}".format("+86", phone) try: # 这里是填 API Key cred = credential.Credential(settings.TENCENT_SECRETID, settings.TENCENT_SECRETKEY) # 填地方的 client = sms_client.SmsClient(cred, settings.TENCENT_LOCATE) req = models.SendSmsRequest() # 填应用程序的 ID req.SmsSdkAppId = settings.TENCENT_APPID # 短信签名内容: 使用 UTF-8 编码,必须填写已审核通过的签名 # 签名信息可前往 [国内短信](https://console .cloud.tencent.com/smsv2/csms-sign) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-sign) 的签名管理查看 req.SignName = settings.TENCENT_SIGN # 签名模板 id req.TemplateId = template # 模板的参数,就是我们的验证码填的地方, # 务必看一下模板定义的几个参数, 如果有两个参数,那么传参就需要两个,且为字符串类型 req.TemplateParamSet = [str(random_code), expire] # 电话号码,但是我们是国内的手机号,所以要 +86 req.PhoneNumberSet = [phone] resp = client.SendSms(req) # 输出json格式的字符串回包 print(resp.to_json_string(indent=2)) # 返回的状态信息 if resp.SendStatusSet[0].Code == "Ok": return True except TencentCloudSDKException as err: print(err)
那么 settings.py 里面就是如下的配置,接着在调用的时候,只要导入 settings 模块,即 from drf import settings 即可。之后我们调用的时候就是 settings.TENCENT_SECRETID 这样。
2)如下所示,而且注意 resp.SendStatusSet ,虽然里面像是个列表嵌着字典,但实际上这个字典是个对象,因为调用的时候,就是 resp.SendStatusSet[0].Code ,如果这个值返回是 Ok ,说明发送成功,其他的说明都是失败。那么我们经过判断,如果是 Ok 就是返回 True,否则一律 False。
从而后面我们可以将这个值返回前端做渲染用。这里给出最新的验证码的代码。
class GetCode(APIView): def get(self, request, *args, **kwargs): # 1. 首先要使用正则模块校验手机号,然后才能继续获取验证码 ser = GetCodeSerializer(data=request.query_params) # 2. 如果校验没通过那么直接返回错误的信息 if not ser.is_valid(): return HttpResponse({"status": False, "msg": "手机格式错误"}) # 3. 显然我们校验成功后,数据就放在了 ser.validated_data 中,所以我们可以通过 ser.validated_data.get() 来取得号码 phoneNum = ser.validated_data.get("phoneNum") # print(phoneNum) # 4. 生成验证码 import random random_code = random.randint(1000, 9999) print(random_code) # 5. 然后将生成的验证码 random_code 发送到手机上面,这里需要购买相应的服务,只需要朝相应的 api 发请求就可以得到验证码了 # 一般买的是阿里云/腾讯云的服务,前者居多,但是微信小程序自然是选择腾讯云啦。 from utils.tencent.msg import send_message result = send_message(phoneNum, random_code) # 如果返回的 result 是 false, 那么说明就是发送失败了 if not result: return JsonResponse({'status': False, 'message': "短信发送失败"}) # 6. 保留验证码+手机号,并且保留30秒。其实一般是 60 秒的 # 这里我们使用 django-redis 来做 from django_redis import get_redis_connection conn = get_redis_connection() # 创建链接 conn.set(phoneNum, random_code, ex=30) # 保留手机号和验证码,以及保留时间 30 秒 ret = { "status": True, "msg": "发送成功" } return JsonResponse(ret)
# 这节课后面的就是说自己写一下登录的逻辑