maybe_serialize( string|array|object $data ): mixed

Parameters

$datastring|array|object

Data that might be serialized.

Return

mixed

A scalar data.

Uses · 1

• is_serialized()Checks value to find if it was serialized.

Used by · 12

• WP_Customize_Manager::import_theme_starter_content()Imports theme starter content into the customized state.
• WP_Site_Health::get_autoloaded_options_size()Calculates total amount of autoloaded data.
• add_metadata()Adds metadata for the specified object.
• add_network_option()Adds a new network option.
• add_option()Adds a new option.
• delete_metadata()Deletes metadata for the specified object.
• populate_options()Create WordPress options and set the default values.
• update_metadata()Updates metadata for the specified object. If no value already exists for the specified object ID and metadata key, the metadata will be added.
• update_metadata_by_mid()Updates metadata by meta ID.
• update_network_option()Updates the value of a network option that was already added.
• update_option()Updates the value of an option that was already added.
• update_usermeta()Update metadata of user.

Source

View on Trac ↗View on GitHub ↗

628function maybe_serialize( $data ) {629	if ( is_array( $data ) || is_object( $data ) ) {630		return serialize( $data );631	}632 633	/*634	 * Double serialization is required for backward compatibility.635	 * See https://core.trac.wordpress.org/ticket/12930636	 * Also the world will end. See WP 3.6.1.637	 */638	if ( is_serialized( $data, false ) ) {639		return serialize( $data );640	}641 642	return $data;643}

History

Introduced in 2.0.5. Unchanged from 6.7.7 through 7.1.0.

1. 6.7.7
2. 6.8.8
3. 6.9.7
4. 7.0.4
5. 7.1.0

Signature, return type and hooks compared across 5 parsed releases.

About this page

Parsed data

Generated from the wordpress-develop 6.9.7 tag, from src/wp-includes/functions.php, and regenerated for each WordPress release so it tracks the code rather than a snapshot of it.

Corrections

Something wrong on this page? Report it and it gets fixed in the next regeneration.