云策 WordPress 开发者社区

钩子文档

https_local_ssl_verify

查看官方原文 ↗
💡 云策文档标注

概述

本文档介绍了 WordPress 中的 https_local_ssl_verify 过滤器，用于控制本地 HTTP API 请求的 SSL 验证行为。开发者可以通过此过滤器调整 SSL 证书验证设置，以适配不同环境需求。

关键要点

  • 过滤器名称：https_local_ssl_verify
  • 参数：$ssl_verify（布尔值或字符串，控制 SSL 验证或指定证书路径）和 $url（请求 URL）
  • 用途：影响本地请求的 SSL 验证，常用于循环测试、REST API 检查等场景
  • 版本历史：从 WordPress 2.8.0 引入，5.1.0 版本添加了 $url 参数

代码示例

$ssl_verify = apply_filters( 'https_local_ssl_verify', $ssl_verify, $url );

注意事项

  • 此过滤器主要用于本地环境，修改 SSL 验证可能影响安全性，需谨慎使用
  • 相关函数包括 WP_Automatic_Updater、WP_Site_Health 等，用于处理自动更新、站点健康检查等任务
📄 原文内容

Filters whether SSL should be verified for local HTTP API requests.

Parameters

$ssl_verifybool|string
Boolean to control whether to verify the SSL connection or path to an SSL certificate.
$urlstring
The request URL.

Source

$ssl_verify = apply_filters( 'https_local_ssl_verify', $ssl_verify, $url );

View all references View on Trac View on GitHub

Used by Description
WP_Automatic_Updater::has_fatal_error()wp-admin/includes/class-wp-automatic-updater.php

Performs a loopback request to check for potential fatal errors.
WP_Site_Health::check_for_page_caching()wp-admin/includes/class-wp-site-health.php

Checks if site has page cache enabled or not.
WP_Site_Health::get_test_rest_availability()wp-admin/includes/class-wp-site-health.php

Tests if the REST API is accessible.
WP_Site_Health::can_perform_loopback()wp-admin/includes/class-wp-site-health.php

Runs a loopback test on the site.
wp_edit_theme_plugin_file()wp-admin/includes/file.php

Attempts to edit a file for a theme or plugin.
spawn_cron()wp-includes/cron.php

Sends a request to run cron through HTTP request that doesn’t halt page loading.
WP_Http_Curl::request()wp-includes/class-wp-http-curl.php

Send a HTTP request to a URI using cURL extension.
WP_Http_Streams::request()wp-includes/class-wp-http-streams.php

Send a HTTP request to a URI using PHP Streams.

Show 3 moreShow less

Changelog

Version Description
5.1.0 The $url parameter was added.
2.8.0 Introduced.