云策 WordPress 开发者社区

函数文档

wp_ssl_constants()

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

概述

wp_ssl_constants() 函数用于定义与 SSL 相关的 WordPress 常量，主要处理 FORCE_SSL_ADMIN 的设置，并兼容已弃用的 FORCE_SSL_LOGIN。

关键要点

  • 函数定义 FORCE_SSL_ADMIN 常量：如果站点 URL 使用 HTTPS 协议，则设为 true，否则设为 false。
  • 调用 force_ssl_admin() 函数应用 FORCE_SSL_ADMIN 设置。
  • 兼容已弃用的 FORCE_SSL_LOGIN 常量：如果已定义且为 true，则强制 SSL 管理。
  • 函数自 WordPress 2.6.0 版本引入，FORCE_SSL_LOGIN 在 4.0.0 版本中弃用。

代码示例

function wp_ssl_constants() {
	if ( ! defined( 'FORCE_SSL_ADMIN' ) ) {
		if ( 'https' === parse_url( get_option( 'siteurl' ), PHP_URL_SCHEME ) ) {
			define( 'FORCE_SSL_ADMIN', true );
		} else {
			define( 'FORCE_SSL_ADMIN', false );
		}
	}
	force_ssl_admin( FORCE_SSL_ADMIN );

	if ( defined( 'FORCE_SSL_LOGIN' ) && FORCE_SSL_LOGIN ) {
		force_ssl_admin( true );
	}
}

注意事项

  • FORCE_SSL_LOGIN 常量在 WordPress 4.0.0 版本后已弃用，建议使用 FORCE_SSL_ADMIN 替代。
  • 函数依赖于 get_option() 获取站点 URL，确保站点设置正确。
📄 原文内容

Defines SSL-related WordPress constants.

Source

function wp_ssl_constants() {
	/**
	 * @since 2.6.0
	 */
	if ( ! defined( 'FORCE_SSL_ADMIN' ) ) {
		if ( 'https' === parse_url( get_option( 'siteurl' ), PHP_URL_SCHEME ) ) {
			define( 'FORCE_SSL_ADMIN', true );
		} else {
			define( 'FORCE_SSL_ADMIN', false );
		}
	}
	force_ssl_admin( FORCE_SSL_ADMIN );

	/**
	 * @since 2.6.0
	 * @deprecated 4.0.0
	 */
	if ( defined( 'FORCE_SSL_LOGIN' ) && FORCE_SSL_LOGIN ) {
		force_ssl_admin( true );
	}
}

View all references View on Trac View on GitHub

Uses Description
force_ssl_admin()wp-includes/functions.php

Determines whether to force SSL used for the Administration Screens.
get_option()wp-includes/option.php

Retrieves an option value based on an option name.

Changelog

Version Description
3.0.0 Introduced.