maybe_serialize( string|array|object $data )

Serialize data, if needed.

Contents

Description Description

Parameters Parameters

$data

(string|array|object) (Required) Data that might be serialized.

Top ↑

Return Return

(mixed) A scalar data

Top ↑

Source Source

File: wp-includes/functions.php

558
559
560
561
562
563
564
565
566
567
568
569
570
571
function maybe_serialize( $data ) {
    if ( is_array( $data ) || is_object( $data ) ) {
        return serialize( $data );
    }
 
    // Double serialization is required for backward compatibility.
    // See https://core.trac.wordpress.org/ticket/12930
    // Also the world will end. See WP 3.6.1.
    if ( is_serialized( $data, false ) ) {
        return serialize( $data );
    }
 
    return $data;
}

Expand full source code Collapse full source code View on Trac

Top ↑

Changelog Changelog

Changelog
Version Description
2.0.5 Introduced.

Top ↑

Top ↑

Used By Used By

Used By
Used By Description
wp-includes/option.php: update_network_option()

Update the value of a network option that was already added.
wp-includes/option.php: add_network_option()

Add a new network option.
wp-includes/deprecated.php: update_usermeta()

Update metadata of user.
wp-includes/option.php: update_option()

Update the value of an option that was already added.
wp-includes/option.php: add_option()

Add a new option.
wp-includes/meta.php: delete_metadata()

Delete metadata for the specified object.
wp-includes/meta.php: update_metadata_by_mid()

Update meta data by meta ID
wp-includes/meta.php: add_metadata()

Add metadata for the specified object.
wp-includes/meta.php: update_metadata()

Update metadata for the specified object. If no value already exists for the specified object ID and metadata key, the metadata will be added.
Show 4 more used by Hide more used by

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 Codex —

    Basic Examples

    ‘Hello World!’, ‘foo’ => ‘bar’ );
    echo maybe_serialize( $data );
    // a:2:{i:1;s:12:”Hello World!”;s:3:”foo”;s:3:”bar”;}

    // A serialized string will be serialized again.
    $data = ‘a:2:{i:1;s:12:”Hello World!”;s:3:”foo”;s:3:”bar”;}’;
    echo maybe_serialize( $data );
    // s:50:”a:2:{i:1;s:12:”Hello World!”;s:3:”foo”;s:3:”bar”;}”;

    ?>

  2. Skip to note 2 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 Codex —

    Basic Examples

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    27
    28
    29
    30
    31
    32
    33
    34
    35
    <?php
     
    // Strings are returned untouched.
    $data = 'Hello World!';
    echo maybe_serialize( $data );
    // Hello World!
     
    // Integers, floats and boolean values are also returned untouched.
    $data = 55;
    echo maybe_serialize( $data );
    // 55
     
    $data = 4.560
    echo maybe_serialize( $data );
    // 4.560
     
    $data = true;
    $data = maybe_serialize( $data );
    // $data = true;
     
    $data = null;
    $data = maybe_serialize( $data );
    // $data = null
     
    // An array or object will be returned as a serialized string.
    $data = array( 1 => 'Hello World!', 'foo' => 'bar' );
    echo maybe_serialize( $data );
    // a:2:{i:1;s:12:"Hello World!";s:3:"foo";s:3:"bar";}
     
    // A serialized string will be serialized again.
    $data = 'a:2:{i:1;s:12:"Hello World!";s:3:"foo";s:3:"bar";}';
    echo maybe_serialize( $data );
    // s:50:"a:2:{i:1;s:12:"Hello World!";s:3:"foo";s:3:"bar";}";
     
    ?>

    Expand full source codeCollapse full source code

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