PHP on 梓晨's Blog

PHP 实现腾讯云短信 API 的简化客户端

Thu, 08 Jun 2023 00:00:00 +0000

前言

由于腾讯云官方的SDK需要引用一大堆库和文件，使用起来非常不方便，因此我根据腾讯云的签名方法，自己写了一个腾讯云的精简版PHP-SDK，这个SDK只需要一个php文件即可实现，里面包含了签名方法、请求方法，以及用于调用的方法。

这个SDK是以腾讯云短信服务为例，其他腾讯云服务只需要改一下里面的参数也可以用。

SDK代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125


<?php

//腾讯云短信服务SDK

class QcloudSimple
{
 private $SecretId;
 private $SecretKey;
 private $endpoint = "sms.tencentcloudapi.com";
 //接口请求域名
 private $service = "sms";
 //服务名称
 private $version = "2021-01-11";
 //API版本号
 private $region = "ap-guangzhou";
 //地域参数

 /**
 * 初始化
 * @access public
 * @param string $SecretId 腾讯云SecretId
 * @param string $SecretKey 腾讯云SecretKey
 */
 public function __construct($SecretId,$SecretKey)
 {
 $this->SecretId = $SecretId;
 $this->SecretKey = $SecretKey;
 }
 /**
 * 短信发送
 * @access public
 * @param string|array $PhoneNumber 手机号
 * @param string $AppId 应用ID
 * @param string $TemplateId 模板ID
 * @param string|array|null $TemplateParam 模板参数
 * @param string|null $SignName 短信签名
 * @param string|null $ExtendCode 短信码号扩展号
 * @param string|null $SessionContext 用户的 session 内容
 * @param string|null $SenderId 国内短信无需填写该项
 * @return false|mixed
 */
 public function SendSms($PhoneNumber, $AppId, $TemplateId, $TemplateParam = null, $SignName = null, $ExtendCode = null, $SessionContext = null, $SenderId = null)
 {
 $action = 'SendSms';
 $phones = is_array($PhoneNumber) ? $PhoneNumber : [$PhoneNumber];
 $param = [
 'PhoneNumberSet' => array_values(array_map('strval', $phones)),
 'SmsSdkAppId' => (string) $AppId,
 'TemplateId' => (string) $TemplateId,
 ];
 if ($TemplateParam !== null && $TemplateParam !== '') {
 $values = is_array($TemplateParam) ? $TemplateParam : [$TemplateParam];
 $param['TemplateParamSet'] = array_values(array_map('strval', $values));
 }
 $optional = [
 'SignName' => $SignName,
 'ExtendCode' => $ExtendCode,
 'SessionContext' => $SessionContext,
 'SenderId' => $SenderId,
 ];
 foreach ($optional as $name => $value) {
 if ($value !== null && $value !== '') {
 $param[$name] = (string) $value;
 }
 }
 return $this->send_request($action, $param);
 }
 private function send_request($action, $param)
 {
 $payload = json_encode($param, JSON_UNESCAPED_UNICODE);
 if ($payload === false) {
 return false;
 }
 $time = time();
 $authorization = $this->generateSign($payload, $time);
 $header = ['Authorization: ' . $authorization, 'Content-Type: application/json; charset=utf-8', 'X-TC-Action: ' . $action, 'X-TC-Timestamp: ' . $time, 'X-TC-Version: ' . $this->version, 'X-TC-Region: ' . $this->region];
 return $this->curl_post($payload, $header);
 }
 private function generateSign($payload, $time)
 {
 $algorithm = "TC3-HMAC-SHA256";
 // step 1: build canonical request string
 $httpRequestMethod = "POST";
 $canonicalUri = "/";
 $canonicalQueryString = "";
 $canonicalHeaders = "content-type:application/json; charset=utf-8\n" . "host:" . $this->endpoint . "\n";
 $signedHeaders = "content-type;host";
 $hashedRequestPayload = hash("SHA256", $payload);
 $canonicalRequest = $httpRequestMethod . "\n" . $canonicalUri . "\n" . $canonicalQueryString . "\n" . $canonicalHeaders . "\n" . $signedHeaders . "\n" . $hashedRequestPayload;
 // step 2: build string to sign
 $date = gmdate("Y-m-d", $time);
 $credentialScope = $date . "/" . $this->service . "/tc3_request";
 $hashedCanonicalRequest = hash("SHA256", $canonicalRequest);
 $stringToSign = $algorithm . "\n" . $time . "\n" . $credentialScope . "\n" . $hashedCanonicalRequest;
 // step 3: sign string
 $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);
 // step 4: build authorization
 $authorization = $algorithm . " Credential=" . $this->SecretId . "/" . $credentialScope . ", SignedHeaders=content-type;host, Signature=" . $signature;
 return $authorization;
 }
 private function curl_post($payload, $header)
 {
 $url = 'https://' . $this->endpoint . '/';
 $ch = curl_init($url);
 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
 curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
 curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
 curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
 curl_setopt($ch, CURLOPT_TIMEOUT, 10);
 curl_setopt($ch, CURLOPT_POST, 1);
 curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
 $json = curl_exec($ch);
 $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
 curl_close($ch);
 if ($httpCode == 200) {
 $arr = json_decode($json, true);
 return isset($arr['Response']) ? $arr['Response'] : false;
 } else {
 return false;
 }
 }
}

调用前检查

需要 PHP 的 cURL 扩展以及可用的系统 CA 证书。保留 TLS 校验；证书错误时修复 CA 配置，不要关闭校验。手机号使用 API 要求的国际区号格式，例如 +8613812345678。

false 表示传输或响应解析失败。返回数组时仍需检查 Error 字段，HTTP 200 不等于短信已发送成功。签名名称、模板和应用 ID 必须使用已审核且互相匹配的实际配置。

参考：腾讯云 SendSms API。

PHP 调用 gRPC：依赖、代码生成与客户端示例

Thu, 01 Jun 2023 00:00:00 +0000

前言

最近写项目的时候碰到一些api接口需要使用gRPC调用，本着php是世界上最好的语言的前提，简单研究了一下使用方法。

扩展安装

1

pecl install grpc

直接使用pecl命令编译，简单省事，如需手动编译建议自行谷歌。

1

extension=grpc.so

将此行添加到 php.ini 文件中的任意位置，例如 /etc/php/php.ini。

protoc编译器安装

1
2


sudo apt-get update
sudo apt-get install -y cmake git make g++

上述依赖命令适用于 Debian/Ubuntu。其他发行版的包名可能不同，不能仅替换包管理器名称。

1
2
3
4
5
6
7


git clone --recurse-submodules https://github.com/grpc/grpc
cd grpc
git submodule update --init --recursive
mkdir -p cmake/build
cd cmake/build
cmake ../.. -DgRPC_BUILD_TESTS=OFF
make protoc grpc_php_plugin

protoc：Protocol Buffers 编译器，用于生成消息类；服务客户端由下面的插件生成。

grpc_php_plugin：protoc的插件，用于生成服务存根类。

1
2


sudo install -m 0755 third_party/protobuf/protoc /usr/local/bin/protoc
sudo install -m 0755 grpc_php_plugin /usr/local/bin/grpc_php_plugin

将二进制文件移动到/usr/local/bin目录。

项目依赖与代码生成

以下步骤在自己的 PHP 项目根目录执行，不是在 gRPC 的编译目录中执行：

1
2


composer require grpc/grpc google/protobuf
mkdir -p proto src

将自己的 .proto 文件放到 proto 目录及其子目录。使用本文示例时，先创建 proto/helloworld.proto，内容如下：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


syntax = "proto3";
package Services.Base.HelloWorld;

service HelloWorldService {
 rpc Demo (HelloWorldRequest) returns (HelloWorldResponse);
}

message HelloWorldRequest {
 string name = 1;
}

message HelloWorldResponse {
 string message = 1;
}

准备好协议文件后，进入协议目录，自动查找全部 .proto，批量生成消息类和服务客户端到上一级 src：

1
2
3
4


cd proto \
&& mkdir -p ../src \
&& protoc --proto_path=./ --php_out=../src --grpc_out=../src \
 --plugin=protoc-gen-grpc=/usr/local/bin/grpc_php_plugin $(find . -type f -name "*.proto")

完成后回到 PHP 项目根目录：

1

cd ..

本文示例的协议使用 Services.Base.HelloWorld 包名，生成类位于 src/Services；将以下内容合并到现有 composer.json 的自动加载配置中。使用自己的协议时，命名空间与目录按生成结果调整：

1
2
3
4
5
6
7
8
9


{
 "autoload": {
 "psr-4": {
 "App\\": "src/App/",
 "Services\\": "src/Services/",
 "GPBMetadata\\": "src/GPBMetadata/"
 }
 }
}

1
2


mkdir -p src/App
composer dump-autoload

插件会生成服务客户端；下方手工 Client 用于解释调用路径，不需要替换生成文件。将其保存为 src/App/Client.php，调用类保存为 src/App/App.php。

客户端代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


<?php

namespace App;


use Grpc\BaseStub;

use Services\Base\HelloWorld\HelloWorldRequest;
use Services\Base\HelloWorld\HelloWorldResponse;

class Client extends BaseStub
{
 public function __construct($hostname, $opts, $channel = null)
 {
 parent::__construct($hostname, $opts, $channel);
 }

 /**
 * 用于请求和响应该服务
 * @param HelloWorldRequest $argument
 * @param array $metadata
 * @param array $options
 * @return
 */
 public function Demo(HelloWorldRequest $argument, $metadata = [], $options = [])
 {
 return $this->_simpleRequest('/Services.Base.HelloWorld.HelloWorldService/Demo',
 $argument,
 [HelloWorldResponse::class, 'decode'],
 $metadata, $options);
 }

}

调用gRPC代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46


<?php

namespace App;

use Grpc\ChannelCredentials;
use Services\Base\HelloWorld\HelloWorldRequest;

/**
 * grpc请求案例
 */
class App
{
 public $client;

 public static function run()
 {
 (new self())->grpc()->Main();
 }

 public function grpc()
 {
 $this->client = $this->client();
 return $this;
 }

 public function client()
 {
 return new Client('127.0.0.1:8000', [
 'credentials' => ChannelCredentials::createInsecure(),
 ]);
 }

 public function Main()
 {
 $request = new HelloWorldRequest();
 $request->setName("林逸博客");
 $get = $this->client->Demo($request)->wait();
 list($reply, $status) = $get;
 if ($status->code === 0 && $reply !== null) {
 print_r($reply->getMessage());
 } else {
 echo '获取返回内容失败：' . $status->details;
 }
 }

}

完整Demo

https://github.com/zihelyu/php-grpc-client

运行入口

在项目根目录创建 run.php：

1
2
3


<?php
require __DIR__ . '/vendor/autoload.php';
\App\App::run();

运行前需要在 127.0.0.1:8000 启动实现相同协议的 gRPC 服务端。createInsecure() 仅适用于本文本地示例；远程服务按其要求配置 TLS。编译工具链和联调步骤参考 PHP gRPC 官方入门。

服务端就绪后，在项目根目录执行 php run.php 发起调用。

PHP 根据小米路由器 SN 计算历史 root 密码

Mon, 15 Aug 2022 00:00:00 +0000

这是旧款小米路由器的历史算法记录，不能保证适用于全部机型和固件。计算出密码不等于设备已经启用 SSH/root 登录。

前言

由于小米官方获取root密码的步骤过于繁琐，故编写php脚本进行计算，代码如下。

计算代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35


#!/usr/bin/env php
<?php
//路由器固件解包后，从 /bin/mkxqimage 中提取的盐
$salt = array(
 'r1d' => 'A2E371B0-B34B-48A5-8C40-A7133F3B5D88',
 'others' => 'd44fb0960aa0-a5e6-4a30-250f-6d2df50a'
);

isset($argv[1]) or die('Usage: ' . $argv[0] . " SN\n");
print_line(get_passwd($argv[1]));

function print_line($message) {
 echo $message . "\n";
}

//密码算法：
//原始 SN 拼接反转后的盐，做 md5 运算取前 8 个字符
function get_passwd($sn) {
 return substr(md5($sn . get_salt($sn)), 0, 8);
}

// SN 中不含 '/' 则为 r1d
function get_salt($sn) {
 global $salt;
 if (false === strpos($sn, '/')) {
 return $salt['r1d'];
 } else {
 return swap_salt($salt['others']);
 }
}

//非 R1D 盐要反转后才能使用
function swap_salt($salt) {
 return implode('-', array_reverse(explode('-', $salt)));
}

使用教程

1

php password.php "实际路由器SN"

password.php 为计算代码保存的文件名。

Composer 指定依赖解析的 PHP 版本

Thu, 30 Dec 2021 00:00:00 +0000

指定目标 PHP 版本

当开发环境与部署环境的 PHP 版本不同时，可以让 Composer 按部署环境解析依赖。下面以历史项目的 PHP 7.2.34 为例，版本值应替换为实际目标版本。

在现有 composer.json 的 config 中合并以下设置：

1
2
3
4
5
6
7


{
 "config": {
 "platform": {
 "php": "7.2.34"
 }
 }
}

config.platform.php 只模拟 Composer 解析依赖时看到的 PHP 版本，不会安装 PHP、切换解释器，也不能保证应用代码兼容旧版本。

重新解析依赖

保存配置后执行：

1

composer update

Composer 会按目标 PHP 版本重新解析并更新 composer.lock，无需先删除锁文件。

参考：Composer platform 配置。

PHP 围绕平均值生成随机红包

Fri, 11 Jun 2021 00:00:00 +0000

开发思路

先计算剩余金额的平均值，再取可行上下限距离平均值的较小值，作为对称浮动范围。每次围绕平均值生成随机金额，最后打乱红包顺序。这是对称区间内随机取值，不是正态分布。

kind=0 为随机红包，kind=1 为平均红包。随机模式下，max=0 或上限不符合校验条件时，自动回退为总金额的三分之一；仅当份数或分币精度使该上限无法分完时，提高到能完成分配的最小上限。

金额、数量和模式支持数字字符串。数量为零或金额不足时返回 false，平均分配处理分币尾差，随机分配在每一步保留两位小数。每份至少 0.01 元，返回两位小数的金额字符串。

PHP 代码

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66


<?php

class RedPacket
{
 /**
 * @param float|string $rmb 红包总金额（元）
 * @param int|string $num 红包数量
 * @param int|string $kind 0 随机，1 平均
 * @param float|string $max 单份上限，0 自动计算
 * @return array|false
 */
 public static function create($rmb, $num, $kind = 0, $max = 0)
 {
 if (!is_numeric($rmb) || !is_numeric($num) || !is_numeric($max)
 || $num < 1 || $num > PHP_INT_MAX || $num != (int) $num) {
 return false;
 }
 $rmb = round((float) $rmb, 2);
 $num = (int) $num;
 $max = (float) $max;
 if (!is_finite($rmb) || !is_finite($max)
 || $rmb <= 0 || $rmb >= PHP_INT_MAX / 100) {
 return false;
 }
 if ($num < 2) $kind = 1;
 $min = 0.01;
 $packets = [];
 if ($min * $num > $rmb + 1e-9) {
 return false;
 }
 switch ($kind) {
 case 1:
 // 以分处理平均分配尾差，保证总金额不变。
 $total = (int) round($rmb * 100);
 $base = (int) floor($total / $num);
 $extra = $total % $num;
 for ($i = 0; $i < $num; $i++) {
 $packets[] = sprintf('%.2f', ($base + ($i < $extra ? 1 : 0)) / 100);
 }
 return $packets;
 default:
 // 上限不满足分配条件时自动回退。
 if ($num * $max < $rmb - 1e-9 || $max + $num * $min > $rmb + 1e-9) {
 $max = $rmb / 3;
 }
 $max = floor($max * 100 + 1e-9) / 100;
 // 两份红包或分币尾差可能使三分之一上限不可行。
 $requiredMax = ceil(round($rmb * 100) / $num) / 100;
 $max = max($max, $requiredMax);

 while ($num >= 1) {
 $num--;
 $kMin = round(max($min, $rmb - $num * $max), 2);
 $kMax = round(min($max, $rmb - $num * $min), 2);
 $kAvg = $rmb / ($num + 1);
 $kDis = max(0, min($kAvg - $kMin, $kMax - $kAvg));
 $r = ((float) (rand(1, 10000) / 10000) - 0.5) * $kDis * 2;
 $k = $num === 0 ? $rmb : min($kMax, max($kMin, round($kAvg + $r, 2)));
 $rmb = round($rmb - $k, 2);
 $packets[] = sprintf('%.2f', $k);
 }
 shuffle($packets);
 return $packets;
 }
 }
}

示例

1
2
3
4
5
6
7
8


// 自动计算单份上限，并围绕剩余平均值随机分配。
$random = RedPacket::create('10.00', '5');

// kind 可以使用数字字符串；三份金额之和为 1.00 元。
$average = RedPacket::create('1.00', '3', '1');

// 数量为零，或总金额不足以让每份至少 0.01 元时返回 false。
$invalid = RedPacket::create('1.00', 0);

PHP on 梓晨's Blog

PHP 实现腾讯云短信 API 的简化客户端

前言

SDK代码

调用前检查

延伸阅读

PHP 调用 gRPC：依赖、代码生成与客户端示例

前言

扩展安装

protoc编译器安装

项目依赖与代码生成

客户端代码

调用gRPC代码

完整Demo

运行入口

延伸阅读

PHP 根据小米路由器 SN 计算历史 root 密码

前言

计算代码

使用教程

延伸阅读

Composer 指定依赖解析的 PHP 版本

指定目标 PHP 版本

重新解析依赖

延伸阅读

PHP 围绕平均值生成随机红包

开发思路

PHP 代码

示例