docker 部署的 wordpress 接入阿里云短信服务 详细实操介绍

一、阿里云短信服务配置：

1、登录 阿里云短信服务 完成指引短信相关配置

2、创建RAM用户 并完成授权

出于安全及规范考虑 需通过RAM 用户来完成OponApl 接口调用，创建成功需完成短信接口（AliyunDysmsFullAccess、AliyunDysmsReadOnlyAccess）授权。

RAM 用户

RAM用户是RAM的一种实体身份类型，有确定的身份ID和身份凭证，它通常与某个确定的人或应用程序一一对应。RAM用户具备以下特点：

• RAM用户由阿里云账号（主账号）或具有管理员权限的其他RAM用户、RAM角色创建，创建成功后，归属于该阿里云账号，它不是独立的阿里云账号。
• RAM用户不拥有资源，不能独立计量计费，由所属的阿里云账号统一付费。
• RAM用户必须在获得授权后，才能登录控制台或使用API访问阿里云账号下的资源。
• RAM用户拥有独立的登录密码或访问密钥。
• 一个阿里云账号下可以创建多个RAM用户，对应企业内的员工、系统或应用程序。

3、创建RAM用户的AccessKey

注意创建完及时转存 AccessKey Secret ，避免后面接口使用时找不到。

什么是AccessKey

访问密钥AccessKey（简称AK）是阿里云提供给用户的永久访问凭据，一组由AccessKey ID和AccessKey Secret组成的密钥对。

• AccessKey ID：用于标识用户。

• AccessKey Secret：是一个用于验证您拥有该AccessKey ID的密码。

AccessKey ID和AccessKey Secret根据算法由访问控制（RAM）生成，阿里云对AccessKey ID和AccessKey Secret的存储及传输均进行加密。

AccessKey不用于控制台登录，用于通过开发工具（API、CLI、SDK、Terraform等）访问阿里云时，发起的请求会携带AccessKey ID和AccessKey Secret加密请求内容生成的签名，进行身份验证及请求合法性校验。

操作步骤

• 登录RAM控制台。

• 在左侧导航栏，选择身份管理 > 用户。

• 在用户页面，单击目标RAM用户名称。

在认证管理页签下的AccessKey区域，单击创建AccessKey。

根据界面提示完成安全验证。

在创建AccessKey对话框，查看AccessKey ID和AccessKey Secret。

4、调用测试阿里OpenAPI

可以使用 在线SDK 调用，测试短信是否可接收。

二、wordpres 接入阿里短信 SDK

1、在WordPress 的docker 容器中接入阿里云短信 SDK

• 进入 Docker 容器

docker exec -it wordpress_container /bin/bash

• 安装 Composer
  在容器内安装 Composer。如果你还没有 Composer，可以使用以下命令来全局安装 Composer：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php --install-dir=/usr/local/bin --filename=composer
php -r "unlink('composer-setup.php');"

• 配置 Composer 使用阿里云镜像

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

• 在官网下载完整 SDK 包 ，将包里的 composer.json 文件放入容器 /var/www/html 目录下，代码类似下面，使用时请去官网下载最新版。

{
  "name": "alibabacloud/sample",
  "description": "Alibaba Cloud SDK Code Sample Library for PHP",
  "type": "library",
  "license": "Apache-2.0",
  "authors": [],
  "require": {
    "php": ">5.5",
    "alibabacloud/dysmsapi-20170525": "^2.0.24",
    "alibabacloud/darabonba-openapi": "^0.2.10",
    "alibabacloud/tea-console": "^0.1.0",
    "alibabacloud/tea-utils": "^0.2.19"
  }, 
  "autoload": {
    "psr-4": {
      "AlibabaCloud\\SDK\\Sample\\": "src"
    }
  },
  "scripts": {
    "fixer": "php-cs-fixer fix ./"
  },
  "config": {
    "sort-packages": true,
    "preferred-install": "dist",
    "optimize-autoloader": true
  },
  "prefer-stable": true
}

• 安装 阿里短信 SDK 依赖

composer install

安装完成 /var/www/html 会生成一个 vendor 文件夹 及 composer.lock 文件

2、wordpress 后台接入

• 在wordpress 主题文件 functions.php 中编写接入代码、准备好上面阿里服务创建的 RAM AccessKey 。创建好 Sample 类后续接口使用。

/**
 * 接入阿里云短信服务
 */

// 引入短信服务相关sdk
require '/var/www/html/vendor/autoload.php';

use AlibabaCloud\SDK\Dysmsapi\V20170525\Dysmsapi;
use AlibabaCloud\Tea\Utils\Utils;
use AlibabaCloud\Tea\Console\Console;
use \Exception;
use AlibabaCloud\Tea\Exception\TeaError;

use Darabonba\OpenApi\Models\Config;
use AlibabaCloud\SDK\Dysmsapi\V20170525\Models\SendSmsRequest;
use AlibabaCloud\Tea\Utils\Utils\RuntimeOptions;

class Sample
{

    /**
     * 使用AK&SK初始化账号Client
     * @return Dysmsapi Client
     */
    public static function createClient()
    {
        // 工程代码泄露可能会导致 AccessKey 泄露，并威胁账号下所有资源的安全性。以下代码示例仅供参考。
        // 建议使用更安全的 STS 方式，更多鉴权访问方式请参见：https://help.aliyun.com/document_detail/311677.html。
        $config = new Config([
            // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_ID。
            "accessKeyId" => getenv("ALIBABA_CLOUD_ACCESS_KEY_ID"), // 替换你实际保存变量的位置
            // 必填，请确保代码运行环境设置了环境变量 ALIBABA_CLOUD_ACCESS_KEY_SECRET。
            "accessKeySecret" => getenv('ALIBABA_CLOUD_ACCESS_KEY_SECRET')
        ]);
        // Endpoint 请参考 https://api.aliyun.com/product/Dysmsapi
        $config->endpoint = "dysmsapi.aliyuncs.com";
        return new Dysmsapi($config);
    }
}

• 短发服务接口编写
  这里我们使用内置函数生成随机6位数字验证码，注意$sendSmsRequest 填入你第一步阿里短信服务配置相关参数。
  另外验证码需要设置时效性及对应的验证，这里就不过多介绍。

/**
 * 短信服务
 */
function send_sms()
{

    // 获取手机号码
    $phone = isset($_POST['phone']) ? sanitize_text_field($_POST['phone']) : '';
    
    // 创建客户端并发送短信
    $client = Sample::createClient(); // Sample 类需要在这之前被引入
    $smsCode = rand(100000, 999999); // 生成随机6位数验证码

 
    $sendSmsRequest = new SendSmsRequest([
        "phoneNumbers" => $phone,
        "signName" => "xxxx科技公司", // 短信签名
        "templateCode" => xxxxxxxxx, // 短信模板CODE
        "templateParam" => json_encode(["code" => $smsCode])

    ]);

    $runtime = new RuntimeOptions([]);

    try {
        $resp = $client->sendSmsWithOptions($sendSmsRequest, $runtime);
        $response = array(
            'status' => 'success',
            'message' => '验证码已发送，请注意查收！'
        );

        wp_send_json($response);
    } catch (Exception $error) {
        // 处理异常
        if (!($error instanceof TeaError)) {
            $error = new TeaError([], $error->getMessage(), $error->getCode(), $error);
        }
        // 返回错误信息
        echo json_encode(array('status' => 'error', 'message' => '验证码发送失败：' . $error->message));
    }
}

add_action('wp_ajax_send_sms', 'send_sms');
add_action('wp_ajax_nopriv_send_sms', 'send_sms');

• 最后前端 php 页面发送 ajax 请求调用即可：

jQuery.ajax({
    type: 'POST',
    url: '<?php echo admin_url('admin-ajax.php'); ?>',
    data: {
        action: 'send_sms',
        phone: phone,
        type: type
    },
    success: function(response) {
        alert(response.message);
    },
    error: function(xhr, status, error) {
        alert('发生错误：' + error, 'warning');
    }
});

至此 完成 docker 部署的wordpress 阿里云短信服务接入！