urlencode_deep( mixed $value )

Navigates through an array, object, or scalar, and encodes the values to be used in a URL.

Contents

Parameters Parameters

$value

(mixed) (Required) The array or string to be encoded.

Top ↑

Return Return

(mixed) The encoded value.

Top ↑

Source Source

File: wp-includes/formatting.php 

function urlencode_deep( $value ) {
	return map_deep( $value, 'urlencode' );
}

Expand full source code Collapse full source code View on Trac View on GitHub

Top ↑

Top ↑

Uses Uses

Uses
Uses Description
wp-includes/formatting.php: map_deep()

Maps a function to all non-iterable elements of an array or an object.

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/rest-api/endpoints/class-wp-rest-search-controller.php: WP_REST_Search_Controller::get_items()

Retrieves a collection of search results.
wp-includes/rest-api/endpoints/class-wp-rest-users-controller.php: WP_REST_Users_Controller::get_items()

Retrieves all users.
wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php: WP_REST_Revisions_Controller::get_items()

Gets a collection of revisions.
wp-includes/rest-api/endpoints/class-wp-rest-terms-controller.php: WP_REST_Terms_Controller::get_items()

Retrieves terms associated with a taxonomy.
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php: WP_REST_Posts_Controller::get_items()

Retrieves a collection of posts.
wp-includes/rest-api/endpoints/class-wp-rest-comments-controller.php: WP_REST_Comments_Controller::get_items()

Retrieves a list of comment items.
wp-includes/general-template.php: paginate_links()

Retrieves paginated links for archive post pages.
wp-includes/functions.php: add_query_arg()

Retrieves a modified URL query string.
Show 3 more used by Hide more used by

Top ↑

Changelog Changelog

Changelog
Version Description
2.2.0 Introduced.

Top ↑

User Contributed Notes User Contributed Notes

  1. Skip to note 1 content
    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
    Contributed by Razon Komar Pal —

    Here is an example for string:

    echo urlencode_deep( 'foo bar' );

// Output will be: foo+bar

    Here is an example for array:

    $data = urlencode_deep( array( 'foo' => 'bar long text', 'key1' => 'value1' ) );

// Output will be for $data: array( 'foo' => 'bar+long+text', 'key1' => 'value1' )

    Here is a use case for multi word string as url parameter:

    echo add_query_arg( 'key', urlencode_deep( 'long value' ), 'http://example.com/' );

// Output will be: http://example.com/?key=long+value

    Here is a use case for an array multi word string as url parameter:

    $params = array( 
    'key1' => 'value1 long text',
    'key2' => 'value2',
);

echo add_query_arg(
    urlencode_deep( $params ),
    'http://example.com/?'
);

// Output will be: http://example.com/?key1=value1+long+text&key2=value2

    It’s making spaces between word, if string has space:

    echo add_query_arg( 'key', 'long value', 'http://example.com/' );

// Output will be: http://example.com/?key=long value

You must log in before being able to contribute a note or feedback.