WordPress开发者和主题制作者的搜索引擎



domain_exists ›

Since3.0.0
已弃用n/a
domain_exists ( $domain, $path, $network_id = 1 )
参数: (3)
  • (string) $domain The domain to be checked.
    Required: Yes
  • (string) $path The path to be checked.
    Required: Yes
  • (int) $network_id Optional. Network ID. Relevant only on multi-network installations.
    Required: No
    默认: 1
返回:
  • (int|null) The site ID if the site name exists, null otherwise.
定义在:
文档:
Change Log:
  • MU

Checks whether a site name is already taken.

The name is the site's subdomain or the site's subdirectory path depending on the network settings.

Used during the new site registration process to ensure that each site name is unique.



源码

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 );
}