serialize

(PHP 4, PHP 5, PHP 7, PHP 8)

serialize 產(chǎn)生一個可存儲的值的表示

描述

serialize(mixed $value): string

serialize() 返回字符串,此字符串包含了表示 value 的字節(jié)流,可以存儲于任何地方。

這有利于存儲或傳遞 PHP 的值,同時不丟失其類型和結(jié)構(gòu)。

想要將已序列化的字符串變回 PHP 的值,可使用 unserialize()。serialize() 可處理除了 resource 之外的任何類型。甚至可以 serialize() 那些包含了指向其自身引用的數(shù)組。你正 serialize() 的數(shù)組/對象中的引用也將被存儲。

當(dāng)序列化對象時,PHP 將試圖在序列動作之前調(diào)用該對象的成員函數(shù) __sleep()。這樣就允許對象在被序列化之前做任何清除操作。類似的,當(dāng)使用 unserialize() 恢復(fù)對象時, 將調(diào)用 __wakeup() 成員函數(shù)。

注意:

在 PHP 3 中,對象屬性將被序列化,但是方法則會丟失。PHP 4 打破了此限制,可以同時存儲屬性和方法。請參見類與對象中的序列化對象部分獲取更多信息。

示例 #1 serialize() 示例

<?php
// $session_data 是包含了當(dāng)前用戶 session 信息的多維數(shù)組。
// 我們使用 serialize() 在請求結(jié)束之前將其存儲到數(shù)據(jù)庫中。

$conn odbc_connect ("webdb""php""chicken");
$stmt odbc_prepare ($conn,
      
"UPDATE sessions SET data = ? WHERE id = ?");
$sqldata = array (serialize($session_data), $PHP_AUTH_USER);
if (!
odbc_execute ($stmt, &$sqldata)) {
    
$stmt odbc_prepare($conn,
     
"INSERT INTO sessions (id, data) VALUES(?, ?)");
    if (!
odbc_execute($stmt, &$sqldata)) {
    
/* 出錯 */
    
}
}
?>

參見:unserialize()。