TP5.1老项目适配HTTPS需闭环配置：一、Nginx正确加载SSL证书并设fastcgi_param HTTPS on；二、应用层手动识别HTTPS，补全$_SERVER['REQUEST_SCHEME']；三、MySQL连接可选启用SSL校验；四、前端资源、CDN及数据库内容须全量升级为HTTPS。
TP5.1 老项目适配 HTTPS，核心是两件事：Web 服务器（如 Nginx）正确加载并启用 SSL 证书，以及应用层（ThinkPHP）适配 HTTPS 环境下的请求识别与资源生成。很多老项目卡在跳转死循环、URL 仍是 http、或数据库 SSL 连接未校验等问题，本质不是“加个证书就行”，而是配置链要闭环。
一、Nginx 配置 HTTPS 并强制跳转
TP5.1 对 HTTPS 没有框架级自动感知，必须靠 Web 服务器明确传递协议信息。Nginx 是最常用场景，关键点如下：
- 443 端口监听必须启用
ssl，且ssl_certificate和ssl_certificate_key指向正确的 PEM 和 KEY 文件（路径建议用绝对路径，如/etc/nginx/ssl/yourdomain.pem）； - 务必添加
fastcgi_param HTTPS on;到 PHP 处理块中，否则 TP5.1 的request->isSsl()或url()生成仍会返回 http 链接； - 80 端口配置重定向时，推荐用
return 301 https://$host$request_uri;，避免使用rewrite+permanent可能引发的多层跳转； - 伪静态规则保持不变，但需确保
location /内的if (!-e $request_filename)逻辑在 HTTPS 下依然生效——它不依赖协议，只认文件是否存在。
二、TP5.1 应用层识别 HTTPS 状态
即使 Nginx 已启用 HTTPS，TP5.1 默认仍可能认为当前是 HTTP 请求，导致生成的 URL、跳转地址、图片链接等全是 http 开头。需手动补全协议识别逻辑：
- 在
public/index.php开头（define('APP_PATH', ...)之后），加入：if ($_SERVER['HTTPS'] === 'on' || $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {<br> $_SERVER['REQUEST_SCHEME'] = 'https';<br> $_SERVER['SERVER_PORT'] = '443';<br>} - 或统一在
application/tags.php的app_init钩子中设置：$_SERVER['REQUEST_SCHEME'] = (isset($_SERVER['HTTPS']) && $_SERVER['HTTPS'] === 'on') || (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') ? 'https' : 'http'; - 验证是否生效：在控制器中输出
\think\Request::instance()->scheme()，应返回https；调用url('index/index')生成的链接也应以 https:// 开头。
三、MySQL 连接启用 SSL 校验（可选但推荐）
如果数据库连接也走内网加密通道，并希望验证服务端身份（防中间人），TP5.1 原生不支持 PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT 参数，需手动干预：
- 打开
config/database.php，在对应数据库的'params'数组中添加：PDO::MYSQL_ATTR_SSL_CA => '/etc/mysql/ssl/ca.pem',<br>PDO::MYSQL_ATTR_SSL_CERT => '/etc/mysql/ssl/client-cert.pem',<br>PDO::MYSQL_ATTR_SSL_KEY => '/etc/mysql/ssl/client-key.pem'
； - 注意：TP5.1 的 PDO 封装不透传
PDO::MYSQL_ATTR_SSL_VERIFY_SERVER_CERT => true，所以仅配置 CA 不代表开启校验；若强需求证书验证，建议升级至 TP6 或在think\db\connector\Mysql类中 patch 连接创建逻辑； - 测试是否启用：连接成功后执行
SHOW STATUS LIKE 'Ssl_cipher';，返回非空值即表示已启用加密；若需验证证书链，可用 OpenSSL 手动检查 CA 文件是否包含服务端证书签发者。
四、前端资源与 CDN 适配
HTTPS 是全链路安全，任何混入的 http 资源都会触发浏览器“不安全内容”警告，导致样式、脚本、图片失效：
- 检查模板中所有硬编码的
http://链接（特别是 CSS、JS、图片、iframe），统一改为协议相对路径（//cdn.example.com/xxx.js）或使用{:url(...)}、{:asset(...)}等内置函数生成； - 若使用 CDN，确保 CDN 已配置 HTTPS 回源，并开启“强制 HTTPS 访问”；同时检查 CDN 缓存策略，避免缓存了旧的 http 版本响应；
- 数据库中存量文章内的 http 图片链接，可通过 SQL 批量更新：
UPDATE `article` SET `content` = REPLACE(`content`, 'http://yoursite.com/', 'https://yoursite.com/') WHERE `content` LIKE '%http://yoursite.com/%';
