Docs4dev
Docs
wordpress / latest / functions / maybe_unserialize.html

maybe_unserialize( string $data ): mixed

Unserializes data only if it was serialized.

Parameters

$data string Required
Data that might be unserialized.

Return

mixed Unserialized data can be any type.

More Information

Data might need to be serialized to allow it to be successfully stored and retrieved from a database in a form that PHP can understand.

Source

File: wp-includes/functions.php. View all references

function maybe_unserialize( $data ) {
	if ( is_serialized( $data ) ) { // Don't attempt to unserialize data that wasn't serialized going in.
		return @unserialize( trim( $data ) );
	}

	return $data;
}

Uses

Uses Description
is_serialized() wp-includes/functions.php

Checks value to find if it was serialized.

Used By

Used By Description
get_metadata_raw() wp-includes/meta.php

Retrieves raw metadata value for the specified object.
wp_user_personal_data_exporter() wp-includes/user.php

Finds and exports personal data associated with an email address from the user and user_meta table.
WP_Customize_Manager::import_theme_starter_content() wp-includes/class-wp-customize-manager.php

Imports theme starter content into the customized state.
get_network_option() wp-includes/option.php

Retrieves a network’s option value based on the option name.
_list_meta_row() wp-admin/includes/template.php

Outputs a single row of public meta data in the Custom Fields meta box.
wp_load_core_site_options() wp-includes/option.php

Loads and caches certain often requested site options if is_multisite() and a persistent cache is not being used.
get_option() wp-includes/option.php

Retrieves an option value based on an option name.
count_users() wp-includes/user.php

Counts number of users who have each of the user roles.
wpmu_activate_signup() wp-includes/ms-functions.php

Activates a signup.
get_metadata_by_mid() wp-includes/meta.php

Retrieves metadata by meta ID.

Changelog

Version Description
2.0.0 Introduced.

© 2003–2022 WordPress Foundation
Licensed under the GNU GPLv2+ License.
https://developer.wordpress.org/reference/functions/maybe_unserialize