domain_exists

函数
domain_exists ( $domain, $path, $network_id = 1 )
参数
  • (string) $domain The domain to be checked.
    Required:
  • (string) $path The path to be checked.
    Required:
  • (int) $network_id Optional. Network ID. Relevant only on multi-network installations.
    Required:
    Default: 1
返回值
  • (int|null) The site ID if the site name exists, null otherwise.
定义位置
相关方法
email_existscomment_existstag_existsterm_existspost_exists
引入
-
弃用
-

domain_exists: 这是一个WordPress函数,用来检查数据库中是否存在一个域: 这个函数可以用来检查一个特定的域名是否已经在WordPress多站点网络中注册。

检查一个网站名称是否已经被占用。

该名称是网站的子域或网站的子目录路径,取决于网络设置。

在新网站注册过程中使用,以确保每个网站名称是唯一的。

function domain_exists( $domain, $path, $network_id = 1 ) {
	$path   = trailingslashit( $path );
	$args   = array(
		'network_id'             => $network_id,
		'domain'                 => $domain,
		'path'                   => $path,
		'fields'                 => 'ids',
		'number'                 => 1,
		'update_site_meta_cache' => false,
	);
	$result = get_sites( $args );
	$result = array_shift( $result );

	/**
	 * Filters whether a site name is taken.
	 *
	 * The name is the site's subdomain or the site's subdirectory
	 * path depending on the network settings.
	 *
	 * @since 3.5.0
	 *
	 * @param int|null $result     The site ID if the site name exists, null otherwise.
	 * @param string   $domain     Domain to be checked.
	 * @param string   $path       Path to be checked.
	 * @param int      $network_id Network ID. Relevant only on multi-network installations.
	 */
	return apply_filters( 'domain_exists', $result, $domain, $path, $network_id );
}

常见问题

FAQs
查看更多 >