Question

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

Check whether a blogname is already taken.

---

description

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

---

参数

$domain

(string) (Required) The domain to be checked.

$path

(string) (Required) The path to be checked.

$site_id

(int) (Optional) Relevant only on multi-network installs.

Default value: 1

---

返回值

(int)

---

源代码

File: wp-includes/ms-functions.php

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

	/**
	 * Filters whether a blogname is taken.
	 *
	 * @since 3.5.0
	 *
	 * @param int|null $result  The blog_id if the blogname exists, null otherwise.
	 * @param string   $domain  Domain to be checked.
	 * @param string   $path    Path to be checked.
	 * @param int      $site_id Site ID. Relevant only on multi-network installs.
	 */
	return apply_filters( 'domain_exists', $result, $domain, $path, $site_id );
}

---

更新日志

Version	description
MU	Introduced.

---

相关函数

Uses

• wp-includes/ms-blogs.php: get_sites()
• wp-includes/formatting.php: trailingslashit()
• wp-includes/plugin.php: apply_filters()
• wp-includes/ms-functions.php: domain_exists

---

Used By

• wp-includes/ms-functions.php: wpmu_create_blog()
• wp-includes/ms-functions.php: wpmu_validate_blog_signup()
• wp-includes/ms-deprecated.php: create_empty_blog()

---

User Contributed Notes