[wp-trac] [WordPress Trac] #52886: Update esc_url to allow for specifying an https:// as default protocol

WordPress Trac noreply at wordpress.org
Mon Nov 24 19:06:37 UTC 2025


#52886: Update esc_url to allow for specifying an https:// as default protocol
-------------------------------------------------+-------------------------
 Reporter:  mkaz                                 |       Owner:  desrosj
     Type:  enhancement                          |      Status:  assigned
 Priority:  normal                               |   Milestone:  6.9
Component:  Formatting                           |     Version:
 Severity:  normal                               |  Resolution:
 Keywords:  has-patch has-unit-tests has-dev-    |     Focuses:
  note commit dev-reviewed                       |
-------------------------------------------------+-------------------------
Changes (by desrosj):

 * keywords:  has-patch has-unit-tests has-dev-note dev-feedback => has-
     patch has-unit-tests has-dev-note commit dev-reviewed
 * owner:  SergeyBiryukov => desrosj
 * status:  reopened => assigned


Comment:

 Replying to [comment:28 wildworks]:
 > Just to confirm, should we update the PHPDoc for deprecated functions as
 well? If so, I think we may also need to update the PHPDoc for the
 `clean_url()` function.

 I went and looked through the `deprecated.php` file and I was unable to
 find any function with a `@since` parameter with a higher version than the
 one noted in the `@deprecated` tag.

 I don't think that `clean_url()`'s docblock should be updated because:
 - `_deprecated_function()` is called, which leaves a notice in the
 `debug.log` about relying on a deprecated function.
 - The `clean_url()` function does not break. It just means that the old
 behavior will persist (always using `http://` when the URL is missing a
 protocal).
 - We don't typically update the documentation for deprecated functions to
 reflect changes to the preferred ones.

 If there's something I'm missing and this is desired, I think this can be
 adjusted later. For now, [61273] looks good to backport so that the inline
 docs are updated for the 6.9 release.

-- 
Ticket URL: <https://core.trac.wordpress.org/ticket/52886#comment:31>
WordPress Trac <https://core.trac.wordpress.org/>
WordPress publishing platform


More information about the wp-trac mailing list