Changeset 58388

Timestamp:

06/11/2024 12:04:40 PM (6 months ago)

Author:

SergeyBiryukov

Message:

Docs: Further improve the wp_http_validate_url() DocBlock.

Follow-up to [58384].

See #61092.

File:

• trunk/src/wp-includes/http.php (modified) (1 diff)

trunk/src/wp-includes/http.php

@@ -540 +540 @@
  * Examples of URLs that are considered unsafe:
  *
- * - ftp://example.com/caniload.php (Invalid protocol - Only http and https are allowed)
- * - http:///example.com/caniload.php (Malformed URL)
- * - http://user:pass@example.com/caniload.php (Login information)
- * - http://exampleeeee.com/caniload.php (Invalid hostname, as the IP cannot be looked up in DNS)
- *
- * Examples of URLS that are considered unsafe by default:
- *
- * - http://192.168.0.1/caniload.php (IPs from LAN networks. This can be changed with the Wordpress filter http_request_host_is_external)
- * - http://198.143.164.252:81/caniload.php (By default, only 80, 443 and 8080 are allowed. This can be changed with the Wordpress filter http_allowed_safe_ports)
+ * - ftp://example.com/caniload.php - Invalid protocol - only http and https are allowed.
+ * - http:///example.com/caniload.php - Malformed URL.
+ * - http://user:pass@example.com/caniload.php - Login information.
+ * - http://exampleeeee.com/caniload.php - Invalid hostname, as the IP cannot be looked up in DNS.
+ *
+ * Examples of URLs that are considered unsafe by default:
+ *
+ * - http://192.168.0.1/caniload.php - IPs from LAN networks.
+ *   This can be changed with the {@see 'http_request_host_is_external'} filter.
+ * - http://198.143.164.252:81/caniload.php - By default, only 80, 443, and 8080 ports are allowed.
+ *   This can be changed with the {@see 'http_allowed_safe_ports'} filter.
  *
  * @since 3.5.2