【DRF+Django】微信小程序入门到实战

（0）摘要

# 课程链接

入门到实战，讲讲公司的微信小程序【django+drf+小程序实战】_哔哩哔哩_bilibili

# 微信开发者文档

微信开放文档

# 课程内容

（1）P28_用户登录页面

（2）P29_发送短信验证码

（3）P30_day04 用户登录

# 纵有疾风起，人生不言弃。

（1）P28_用户登录页面

# （1）这节武sir 只是当了回 cv 工程师~~~

百度云链接：https://pan.baidu.com/s/1n0btgLA_mTyWuLCPzRR3Yg 密码: h3a6

# 课程的参考链接：入门到实战，讲讲公司的微信小程序【django+drf+小程序实战】_哔哩哔哩_bilibili

（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/capicred = 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.A8client = 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 randomrandom_code = random.randint(1000, 9999)print(random_code)# 5. 然后将生成的验证码 random_code 发送到手机上面，这里需要购买相应的服务，只需要朝相应的 api 发请求就可以得到验证码了# 一般买的是阿里云/腾讯云的服务，前者居多，但是微信小程序自然是选择腾讯云啦。from tencentcloud.common import credentialfrom tencentcloud.common.exception.tencent_cloud_sdk_exception import TencentCloudSDKException# 导入对应产品模块的client models。from tencentcloud.sms.v20210111 import sms_client, modelsCHINA = "+86"phoneNum = "{}{}".format(CHINA, phoneNum)try:# 这里是填 API Keycred = credential.Credential("SecretId", "SecretKey")# 填地方的client = sms_client.SmsClient(cred, "ap-guangzhou")req = models.SendSmsRequest()# 填应用程序的 IDreq.SmsSdkAppId = "填 SDK AppID"# 短信签名内容: 使用 UTF-8 编码，必须填写已审核通过的签名# 签名信息可前往 [国内短信](https://console .cloud.tencent.com/smsv2/csms-sign) 或 [国际/港澳台短信](https://console.cloud.tencent.com/smsv2/isms-sign) 的签名管理查看req.SignName = "填签名管理的签名内容"# 签名模板 idreq.TemplateId = "填签名模板 id"# 模板的参数，就是我们的验证码填的地方,# 务必看一下模板定义的几个参数, 如果有两个参数，那么传参就需要两个，且为字符串类型req.TemplateParamSet = [str(random_code), "1"]# 电话号码，但是我们是国内的手机号，所以要 +86req.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_connectionconn = 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 settingsdef send_message(phone, random_code, expire="60", template="1465584"):phone = "{}{}".format("+86", phone)try:# 这里是填 API Keycred = credential.Credential(settings.TENCENT_SECRETID, settings.TENCENT_SECRETKEY)# 填地方的client = sms_client.SmsClient(cred, settings.TENCENT_LOCATE)req = models.SendSmsRequest()# 填应用程序的 IDreq.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# 签名模板 idreq.TemplateId = template# 模板的参数，就是我们的验证码填的地方,# 务必看一下模板定义的几个参数, 如果有两个参数，那么传参就需要两个，且为字符串类型req.TemplateParamSet = [str(random_code), expire]# 电话号码，但是我们是国内的手机号，所以要 +86req.PhoneNumberSet = [phone]resp = client.SendSms(req)# 输出json格式的字符串回包print(resp.to_json_string(indent=2))    # 返回的状态信息if resp.SendStatusSet[0].Code == "Ok":return Trueexcept 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 randomrandom_code = random.randint(1000, 9999)print(random_code)# 5. 然后将生成的验证码 random_code 发送到手机上面，这里需要购买相应的服务，只需要朝相应的 api 发请求就可以得到验证码了# 一般买的是阿里云/腾讯云的服务，前者居多，但是微信小程序自然是选择腾讯云啦。from utils.tencent.msg import send_messageresult = 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_connectionconn = get_redis_connection()   # 创建链接conn.set(phoneNum, random_code, ex=30)      # 保留手机号和验证码，以及保留时间 30 秒ret = {"status": True,"msg": "发送成功"}return JsonResponse(ret)

# 这节课后面的就是说自己写一下登录的逻辑