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

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