函数原型
domain_exists( string $domain, string $path, int $network_id = 1 ): int|null
函数描述
Checks whether a site name is already taken.
是否弃用
未弃用
函数参数
-
$domain
string
Required - The domain to be checked.
-
$path
string
Required - The path to be checked.
-
$network_id
int
Optional - Network ID. Relevant only on multi-network installations.
Default:
1
函数返回值
int|null The site ID if the site name exists, null otherwise.
函数位置
File: wp-includes/ms-functions.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,
'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 );
}
源码链接
变更日志
| Version | Description |
|---|---|
| MU (3.0.0) | Introduced. |

