180 строк кода для реализации глобальной функции отправки SMS (без зависимости от SKD)
180 строк кода для реализации глобальной функции отправки SMS (без зависимости от SKD)

Код, представленный в этой статье, не основан на официальном SDK. Для облегчения понимания читателям фрагменты кода, представленные в статье, включают подробные комментарии. Полный код функции можно найти в конце статьи. После удаления лишних комментариев и пустых строк он составляет менее 180 строк.

Фон приложения

При разработке приложения для трансграничной электронной коммерции продукт требовал использования SMS для проверки подлинности номера мобильного телефона. Команда разработчиков выбрала Tencent Cloud в качестве поставщика услуг. В соответствии с требованиями соответствия были применены внутренние и международные подписи и шаблоны SMS соответственно; это приводит к необходимости выбора соответствующей подписи и шаблона в соответствии с внутренними и международными номерами при отправке SMS, чтобы гарантировать правильность отправки проверочной информации.

После проверки командой разработчиков PHP было единогласно решено, что Tencent Cloud SDK необходимо импортировать слишком много файлов кода, что влияет на читаемость и удобство обслуживания проекта. Поэтому я решил сам упаковать простой SDK, чтобы участники проекта могли быстро приступить к работе.

Обзор Tencent Cloud SMS

Tencent Cloud SMS (служба коротких сообщений, SMS) аккумулировала более чем десятилетний опыт и технологии Tencent в сфере SMS-сервисов, обеспечивая быстрый и гибкий доступ к высококачественным внутренним SMS и международным платформам/платформам Гонконга, Макао и Тайваня, таким как QQ и WeChat. и более 100 000 клиентов.

  • Проверка внутренних SMS-сообщений осуществляется за считанные секунды, а уровень поступления составляет 99%.
  • Текстовые сообщения из других стран/Гонконга, Макао и Тайваня охватывают более 200 стран/регионов по всему миру, стабильны и надежны.

Создание базовых классов Tencent Cloud

Этот базовый алгоритм подписи соответствует спецификациям Tencent Cloud APIv3.,Применимо не только к классу отправки SMS, описанному в этой статье.,Также применимо к другим TencentИнтерфейс облачного продукта。может значительно упростить отделение от чиновникаSDKСложность разработки единого интерфейса продукта。

Язык кода:php
копировать
/**
 * Базовый класс Tencent Cloud
 * @author rehiy
 * @url https://www.rehiy.com/post/527/
 */
class QCloudBasic
{
    /**
     * @var string Доменное имя интерфейса
     */
    protected $domain = 'tencentcloudapi.com';

    /**
     * @var string Сервис интерфейса
     */
    protected $service = '';

    /**
     * @var string Версия интерфейса
     */
    protected $version = '';

    /**
     * @var string SecretId
     */
    protected $secretId = '';

    /**
     * @var string SecretKey
     */
    protected $secretKey = '';

    /**
     * Запросить интерфейс
     * @param string $region область
     * @param string $action Название операции
     * @param array $data Параметры запроса
     */
    protected function post($region, $action, $data)
    {
        $timestamp = time();
        $payload = json_encode($data, 320);
        $authorization = $this->signature($action, $payload, $timestamp);

        $headers = [
            "Authorization: {$authorization}",
            "Content-Type: application/json; charset=utf-8",
            "Host: {$this->domain}",
            "X-TC-Action: {$action}",
            "X-TC-Timestamp: {$timestamp}",
            "X-TC-Version: {$this->version}",
            "X-TC-Region: {$region}"
        ];

        return $this->httpRequest('POST', "https://{$this->domain}", $payload, $headers);
    }

    /**
     * Создать подпись
     * @param string $action Название операции
     * @param string $payload Параметры запроса
     * @param number $timestamp Временная метка
     */
    protected function signature($action, $payload = '{}', $timestamp = 0)
    {
        $algorithm = 'TC3-HMAC-SHA256';
        $date = gmdate('Y-m-d', $timestamp);

        $canonicalUri = '/';
        $canonicalQuery = '';
        $canonicalHeaders = implode("\n", [
            'content-type:application/json; charset=utf-8',
            'host:' . $this->domain,
            'x-tc-action:' . strtolower($action),
            ''
        ]);

        $signedHeaders = 'content-type;host;x-tc-action';
        $canonicalRequest = implode("\n", [
            'POST',
            $canonicalUri,
            $canonicalQuery,
            $canonicalHeaders,
            $signedHeaders,
            hash('SHA256', $payload)
        ]);

        $credentialScope = "{$date}/{$this->service}/tc3_request";
        $stringToSign = implode("\n", [
            $algorithm,
            $timestamp,
            $credentialScope,
            hash('SHA256', $canonicalRequest),
        ]);

        $secretDate = hash_hmac('SHA256', $date, 'TC3' . $this->secretKey, true);
        $secretService = hash_hmac('SHA256', $this->service, $secretDate, true);
        $secretSigning = hash_hmac('SHA256', 'tc3_request', $secretService, true);
        $signature = hash_hmac('SHA256', $stringToSign, $secretSigning);

        return implode(', ', [
            "{$algorithm} Credential={$this->secretId}/{$credentialScope}",
            "SignedHeaders={$signedHeaders}",
            "Signature={$signature}"
        ]);
    }

    /**
     * Отправить HTTP-запрос
     * @param string $method Метод запроса
     * @param string $url Адрес сервера
     * @param array|string $data данные
     * @param array $header Заголовок запроса
     */
    protected function httpRequest($method, $url, $data = null, $header = null)
    {
        $ch = curl_init($url);

        curl_setopt($ch, CURLOPT_TIMEOUT, 25);
        curl_setopt($ch, CURLOPT_HEADER, false);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, $method);
        curl_setopt($ch, CURLOPT_HTTPHEADER, $header ?? []);

        if ($data && $method == 'POST') {
            if (is_array($data)) {
                if (in_array('Content-Type: application/json', $header)) {
                    $data = json_encode($data, 320);
                } else {
                    $data = http_build_query($data);
                }
            }
            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        }

        list($body, $errno, $error) = [
            curl_exec($ch), curl_errno($ch), curl_error($ch), curl_close($ch)
        ];

        if ($errno != 0) {
            throw new \Exception('CURL - ' . $error, $errno);
        }

        try {
            $res = json_decode($body, true);
            return $res['Response'] ?? '';
        } catch (\Exception $e) {
            return false;
        }
    }
}

Создать класс отправки SMS

на основеless is moreв принципе,Этот класс инкапсулирует толькоотправка текстового сообщенияинтерфейс,Его следует передать как массив во время инициализации.secretIdsecretKeysdkAppIdsignNametemplateCode и другие параметры.

Язык кода:php
копировать
/**
 * Облачные SMS-сообщения Tencent
 * @author rehiy
 * @url https://www.rehiy.com/post/527/
 */
class QCloudSms extends QCloudBasic
{
    /**
     * @var string
     */
    protected $service = 'sms';

    /**
     * @var string
     */
    protected $version = '2021-01-11';

    /**
     * @var string
     */
    protected $sdkAppId = '';

    /**
     * @var string СМС-подпись
     */
    protected $signName = '';

    /**
     * @var string КОД шаблона СМС
     */
    protected $templateCode = '';

    /**
     * Конструктор
     * @param array $config
     */
    public function __construct($config)
    {
        $this->domain = $this->service . '.' . $this->domain;
        foreach ($config as $key => $value) {
            $this->$key = $value;
        }
    }

    /**
     * отправка текстового сообщения
     * @param array $phoneNumbers Обязательные поля, список номеров мобильных телефонов
     * @param array $templateParam Если в шаблоне есть переменные, которые необходимо заменить, это обязательное поле.
     * @param string $extendCode Дополнительный 7-значный добавочный код SMS для восходящей линии связи.
     * @param string $sessionContext Необязательно, содержит контекстную информацию, сервер будет возвращен как есть
     */
    public function send($phoneNumbers, $templateParam, $extendCode = '', $sessionContext = '')
    {
        $data = [
            'PhoneNumberSet' => $phoneNumbers,
            'SmsSdkAppId' => $this->sdkAppId,
            'SignName' => $this->signName,
            'TemplateId' => $this->templateCode,
            'TemplateParamSet' => $templateParam,
        ];

        if ($extendCode) {
            $data['ExtendCode'] = $extendCode;
        }
        if ($sessionContext) {
            $data['SessionContext'] = $sessionContext;
        }

        return $this->post('ap-guangzhou', 'SendSms', $data);
    }
}

Позвонить в класс отправки СМС

Код в этом разделе используется только для демонстрации того, как Позвонить. в класс отправки СМСотправка текстового сообщения,Пожалуйста, напишите фактический бизнес-код в соответствии с требованиями проекта.

  • Пожалуйста, следуйте предыдущим шагамполучать Замена параметровПсевдопеременные конфигурации$c_chinaи$c_globalценить
Язык кода:php
копировать
/**
 * отправка текстового сообщения
 * @param string $phone номер телефона
 * @param string $code Проверочный код
 */
function send_sms($phone, $code)
{
    // Конфигурация внутренних SMS
    $c_china = [
        'secretId' => 'AK----------------------',
        'secretKey' => 'SK----------------------',
        'sdkAppId' => '1400000000',
        'signName' =>  'знак',
        'templateCode' => '123456',
    ];

    // Международная конфигурация SMS
    $c_global = [
        'secretId' => 'AK----------------------',
        'secretKey' => 'SK----------------------',
        'sdkAppId' => '1400000000',
        'signName' =>  'знак',
        'templateCode' => '654321',
    ];

    // Удаление внутреннего номера +86
    $phone = preg_replace('/^\+86(\d{11})$/', '$1', $phone);
    $config = strpos($phone, '+') === 0 ? $c_global : $c_china;

    // отправка текстового сообщения и вернуть результаты
    return (new QCloudSms($config))->send([$phone], [$code]);
}

// Отправить SMS внутри страны
print_r(
    send_sms('+8613800000000', '123456')
);

// Отправляйте международные текстовые сообщения
print_r(
    send_sms('+100000000000', '123456')
);

Полный код

Нажмите здесь, чтобы скачать

boy illustration
Неразрушающее увеличение изображений одним щелчком мыши, чтобы сделать их более четкими артефактами искусственного интеллекта, включая руководства по установке и использованию.
boy illustration
Копикодер: этот инструмент отлично работает с Cursor, Bolt и V0! Предоставьте более качественные подсказки для разработки интерфейса (создание навигационного веб-сайта с использованием искусственного интеллекта).
boy illustration
Новый бесплатный RooCline превосходит Cline v3.1? ! Быстрее, умнее и лучше вилка Cline! (Независимое программирование AI, порог 0)
boy illustration
Разработав более 10 проектов с помощью Cursor, я собрал 10 примеров и 60 подсказок.
boy illustration
Я потратил 72 часа на изучение курсорных агентов, и вот неоспоримые факты, которыми я должен поделиться!
boy illustration
Идеальная интеграция Cursor и DeepSeek API
boy illustration
DeepSeek V3 снижает затраты на обучение больших моделей
boy illustration
Артефакт, увеличивающий количество очков: на основе улучшения характеристик препятствия малым целям Yolov8 (SEAM, MultiSEAM).
boy illustration
DeepSeek V3 раскручивался уже три дня. Сегодня я попробовал самопровозглашенную модель «ChatGPT».
boy illustration
Open Devin — инженер-программист искусственного интеллекта с открытым исходным кодом, который меньше программирует и больше создает.
boy illustration
Эксклюзивное оригинальное улучшение YOLOv8: собственная разработка SPPF | SPPF сочетается с воспринимаемой большой сверткой ядра UniRepLK, а свертка с большим ядром + без расширения улучшает восприимчивое поле
boy illustration
Популярное и подробное объяснение DeepSeek-V3: от его появления до преимуществ и сравнения с GPT-4o.
boy illustration
9 основных словесных инструкций по доработке академических работ с помощью ChatGPT, эффективных и практичных, которые стоит собрать
boy illustration
Вызовите deepseek в vscode для реализации программирования с помощью искусственного интеллекта.
boy illustration
Познакомьтесь с принципами сверточных нейронных сетей (CNN) в одной статье (суперподробно)
boy illustration
50,3 тыс. звезд! Immich: автономное решение для резервного копирования фотографий и видео, которое экономит деньги и избавляет от беспокойства.
boy illustration
Cloud Native|Практика: установка Dashbaord для K8s, графика неплохая
boy illustration
Краткий обзор статьи — использование синтетических данных при обучении больших моделей и оптимизации производительности
boy illustration
MiniPerplx: новая поисковая система искусственного интеллекта с открытым исходным кодом, спонсируемая xAI и Vercel.
boy illustration
Конструкция сервиса Synology Drive сочетает проникновение в интрасеть и синхронизацию папок заметок Obsidian в облаке.
boy illustration
Центр конфигурации————Накос
boy illustration
Начинаем с нуля при разработке в облаке Copilot: начать разработку с минимальным использованием кода стало проще
boy illustration
[Серия Docker] Docker создает мультиплатформенные образы: практика архитектуры Arm64
boy illustration
Обновление новых возможностей coze | Я использовал coze для создания апплета помощника по исправлению домашних заданий по математике
boy illustration
Советы по развертыванию Nginx: практическое создание статических веб-сайтов на облачных серверах
boy illustration
Feiniu fnos использует Docker для развертывания личного блокнота Notepad
boy illustration
Сверточная нейронная сеть VGG реализует классификацию изображений Cifar10 — практический опыт Pytorch
boy illustration
Начало работы с EdgeonePages — новым недорогим решением для хостинга веб-сайтов
boy illustration
[Зона легкого облачного игрового сервера] Управление игровыми архивами
boy illustration
Развертывание SpringCloud-проекта на базе Docker и Docker-Compose