W3cubDocs

/WordPress

maybe_unserialize( string $data ): mixed

Unserializes data only if it was serialized.

Parameters

$datastringrequired
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

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;
}

Changelog

Version Description
2.0.0 Introduced.

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