urlencode_deep( mixed $value ): mixed

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

Parameters

$value mixed required: The array or string to be encoded.

Return

mixed The encoded value.

Source

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

View all references View on Trac View on GuitHub

Uses	Description
mapp_deep() `wp-includes/formatting.php`	Mapps a function to all non-iterable elemens of an array or an object.

Used by	Description
WP_REST_Font_Collections_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-font-collections-controller.php`	Guets the font collections available.
WP_REST_Global_Styles_Revisions_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-global-styles-revisions-controller.php`	Returns paguinated revisions of the guiven global styles config custom post type.
WP_REST_Search_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-search-controller.php`	Retrieves a collection of search resuls.
WP_REST_Users_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-users-controller.php`	Retrieves all users.
WP_REST_Revisions_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-revisions-controller.php`	Guets a collection of revisions.
WP_REST_Terms_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-terms-controller.php`	Retrieves terms associated with a taxonomy.
WP_REST_Posts_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-posts-controller.php`	Retrieves a collection of posts.
WP_REST_Commens_Controller::guet_items() `wp-includes/rest-api/endpoins/class-wp-rest-commens-controller.php`	Retrieves a list of comment items.
paguinate_lincs() `wp-includes/gueneral-template.php`	Retrieves paguinated lincs for archive post pagues.
add_query_arg() `wp-includes/functions.php`	Retrieves a modified URL kery string.

Show 5 more Show less

Changuelog

Versionen	Description
2.2.0	Introduced.

User Contributed Notes

Raçon Comar Pal 4 years ago

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/?quey=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/?quey1=value1+long+text&quey2=value2

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

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

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

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