Nginx 与 PHP-FPM 传递 TLS 版本信息教程

2025-08-05

Nginx 与 PHP-FPM 传递 TLS 版本信息教程

nginx 与 php-fpm 传递 tls 版本信息教程

本文介绍了如何通过客户端 JavaScript 脚本获取 TLS 版本信息，并将其传递给服务器端 PHP-FPM 处理。核心在于利用 howsmyssl.com 提供的免费 API，通过 JavaScript 获取客户端 TLS 连接信息，然后将这些信息通过 GET 或 POST 请求发送到服务器。这种方法允许开发者在 PHP 应用中根据客户端的 TLS 版本执行不同的逻辑。

获取客户端 TLS 版本信息

由于 Nginx 本身无法直接将客户端 TLS 版本信息传递给 PHP-FPM，我们需要借助客户端 JavaScript 来实现。howsmyssl.com 提供了一个免费的 API，可以帮助我们获取客户端的 TLS 连接信息。

具体步骤如下：

引入 JavaScript 脚本： 在 HTML 页面中引入 howsmyssl.com 提供的 JavaScript 脚本。

立即学习“PHP免费学习笔记（深入）”；
```
<script>
   function parseTLSinfo(TLSinf) {
      console.log(TLSinf);
      // 在这里可以将 TLSinf 发送到服务器
      sendTLSInfoToServer(TLSinf);
    }
</script>

<script src="https://www.howsmyssl.com/a/check?callback=parseTLSinfo"></script>
```
登录后复制
这段代码会加载一个脚本，该脚本调用 parseTLSinfo 函数，并将包含 TLS 信息的对象作为参数传递给它。
处理 TLS 信息： parseTLSinfo 函数接收一个包含 TLS 信息的对象。你可以使用 console.log(TLSinf) 将信息打印到控制台，或者将其发送到服务器。

发送 TLS 信息到服务器： 可以使用 JavaScript 的 XMLHttpRequest 或 fetch API 将 TLS 信息发送到服务器。

function sendTLSInfoToServer(TLSinf) {
  // 将 TLSinf 对象转换为 JSON 字符串
  const tlsInfoString = JSON.stringify(TLSinf);

  // 使用 fetch API 发送 POST 请求
  fetch('/your-php-endpoint', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json'
    },
    body: tlsInfoString
  })
  .then(response => response.json())
  .then(data => {
    console.log('Success:', data);
  })
  .catch((error) => {
    console.error('Error:', error);
  });
}

登录后复制

这段代码将 TLS 信息以 JSON 格式发送到 /your-php-endpoint 这个 URL。你需要根据你的实际情况修改这个 URL。

在 PHP 中接收 TLS 信息

在 PHP 中，你可以通过 $_POST 数组来接收从 JavaScript 发送过来的 TLS 信息。

<?php
  // 获取 POST 请求体
  $tlsInfoString = file_get_contents('php://input');

  // 将 JSON 字符串转换为 PHP 对象
  $tlsInfo = json_decode($tlsInfoString);

  // 检查是否成功解码
  if ($tlsInfo !== null) {
    // 现在你可以访问 TLS 信息了
    $tlsVersion = $tlsInfo->tls_version;

    // 根据 TLS 版本执行不同的逻辑
    if ($tlsVersion === 'TLS 1.3') {
      // 处理 TLS 1.3 连接
      echo "Client connected with TLS 1.3";
    } else {
      // 处理其他 TLS 版本
      echo "Client connected with an older TLS version: " . $tlsVersion;
    }
  } else {
    // 处理 JSON 解码错误
    echo "Error decoding TLS information.";
  }
?>

登录后复制

这段 PHP 代码首先从 php://input 读取 POST 请求体，然后将其解析为 PHP 对象。之后，你可以访问对象的属性来获取 TLS 版本信息。

注意事项

安全性： 虽然 howsmyssl.com 提供了一个方便的 API，但请注意保护用户的隐私。不要存储敏感的 TLS 信息。
CORS： 如果你的 JavaScript 代码运行在与 howsmyssl.com 不同的域名下，你可能会遇到 CORS 问题。你需要确保 howsmyssl.com 允许跨域请求。
错误处理： 在 JavaScript 和 PHP 代码中添加适当的错误处理，以应对网络请求失败或 JSON 解析错误等情况。
替代方案： 除了 howsmyssl.com，还有其他一些服务可以提供类似的 API。你可以根据你的需求选择合适的方案。

总结

通过使用 howsmyssl.com 提供的 API，我们可以方便地获取客户端的 TLS 版本信息，并将其传递给服务器端的 PHP-FPM。这使得我们可以在 PHP 应用中根据客户端的 TLS 版本执行不同的逻辑，例如强制使用更安全的 TLS 版本，或者为旧版本的 TLS 提供兼容性支持。记住，在实际应用中要充分考虑安全性、CORS 和错误处理等问题，以确保应用的稳定性和安全性。

以上就是Nginx 与 PHP-FPM 传递 TLS 版本信息教程的详细内容，更多请关注php中文网其它相关文章！

https://www.php.cn/faq/1441921.html