WP_Network::get_by_path( string $domain = '', string $path = '', int|null $segments = null ): WP_Network|false

334	public static function get_by_path( $domain = '', $path = '', $segments = null ) {335		$domains = array( $domain );336		$pieces  = explode( '.', $domain );337 338		/*339		 * It's possible one domain to search is 'com', but it might as well340		 * be 'localhost' or some other locally mapped domain.341		 */342		while ( array_shift( $pieces ) ) {343			if ( ! empty( $pieces ) ) {344				$domains[] = implode( '.', $pieces );345			}346		}347 348		/*349		 * If we've gotten to this function during normal execution, there is350		 * more than one network installed. At this point, who knows how many351		 * we have. Attempt to optimize for the situation where networks are352		 * only domains, thus meaning paths never need to be considered.353		 *354		 * This is a very basic optimization; anything further could have355		 * drawbacks depending on the setup, so this is best done per-installation.356		 */357		$using_paths = true;358		if ( wp_using_ext_object_cache() ) {359			$using_paths = get_networks(360				array(361					'number'       => 1,362					'count'        => true,363					'path__not_in' => '/',364				)365			);366		}367 368		$paths = array();369		if ( $using_paths ) {370			$path_segments = array_filter( explode( '/', trim( $path, '/' ) ) );371 372			/**373			 * Filters the number of path segments to consider when searching for a site.374			 *375			 * @since 3.9.0376			 *377			 * @param int|null $segments The number of path segments to consider. WordPress by default looks at378			 *                           one path segment. The function default of null only makes sense when you379			 *                           know the requested path should match a network.380			 * @param string   $domain   The requested domain.381			 * @param string   $path     The requested path, in full.382			 */383			$segments = apply_filters( 'network_by_path_segments_count', $segments, $domain, $path );384 385			if ( ( null !== $segments ) && count( $path_segments ) > $segments ) {386				$path_segments = array_slice( $path_segments, 0, $segments );387			}388 389			while ( count( $path_segments ) ) {390				$paths[] = '/' . implode( '/', $path_segments ) . '/';391				array_pop( $path_segments );392			}393 394			$paths[] = '/';395		}396 397		/**398		 * Determines a network by its domain and path.399		 *400		 * This allows one to short-circuit the default logic, perhaps by401		 * replacing it with a routine that is more optimal for your setup.402		 *403		 * Return null to avoid the short-circuit. Return false if no network404		 * can be found at the requested domain and path. Otherwise, return405		 * an object from wp_get_network().406		 *407		 * @since 3.9.0408		 *409		 * @param null|false|WP_Network $network  Network value to return by path. Default null410		 *                                        to continue retrieving the network.411		 * @param string                $domain   The requested domain.412		 * @param string                $path     The requested path, in full.413		 * @param int|null              $segments The suggested number of paths to consult.