检查是否已经使用了站点名称。

原型

domain_exists( string $domain, string $path, int $network_id = 1 )

描述

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

参数

$domain (string) (Required) 要检查的域。

$path (string) (Required) 要检查的路径。

$network_id (int) (Optional)  网络ID。仅与多网络安装相关。

返回值

(int|null)  如果站点名称存在,则为站点ID,否则为null。

源文件

路径:wp-includes/ms-functions.php

<?php
...
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,
	);
	$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 );
}
...
?>

其他

英文文档:https://developer.wordpress.org/reference/functions/domain_exists/