1．前言

PHP (從 PHP 3.05

開始)為保存對象提供了一組序列化和反序列化的函數：serialize、unserialize。不過在 PHP

手冊中對這兩個函數的說明僅限于如何使用，而對序列化結果的格式卻沒做任何說明。因此，這對在其他語言中實現 PHP

方式的序列化來說，就比較麻煩了。雖然以前也搜集了一些其他語言實現的 PHP

序列化的程序，不過這些實現都不完全，當序列化或反序列化一些比較復雜的對象時，就會出錯了。于是我決定寫一份關于 PHP

序列化格式詳解的文檔(也就是這一篇文檔)，以便在編寫其他語言實現的 php 序列化程序時能有一個比較完整的參考。這篇文章中所寫的內容是我通過編寫程序測試和閱讀

PHP 源代碼得到的，所以，我不能 100%

保證所有的內容都是正確的，不過我會盡量保證我所寫下的內容的正確性，對于我還不太清楚的地方，我會在文中明確指出，也希望大家能夠給予補充和完善。

2．概述

PHP 序列化后的內容是簡單的文本格式，但是對字母大小寫和空白(空格、回車、換行等)敏感，而且字符串是按照字節(或者說是 8

位的字符)計算的，因此，更合適的說法是 PHP 序列化后的內容是字節流格式。因此用其他語言實現時，如果所實現的語言中的字符串不是字節儲存格式，而是

Unicode 儲存格式的話，序列化后的內容不適合保存為字符串，而應保存為字節流對象或者字節數組，否則在與 PHP 進行數據交換時會產生錯誤。

PHP

對不同類型的數據用不同的字母進行標示，Yahoo 開發網站提供的 Using Serialized PHP with Yahoo! Web Services

一文中給出所有的字母標示及其含義：

a - array b - boolean d - double i - integer o - common

object r - reference s - string C - custom object O - class N - null R - pointer

reference U - unicode string

N 表示的是 NULL，而 b、d、i、s 表示的是四種標量類型，目前其它語言所實現的 PHP

序列化程序基本上都實現了對這些類型的序列化和反序列化，不過有一些實現中對 s (字符串)的實現存在問題。

a、O

屬于最常用的復合類型，大部分其他語言的實現都很好的實現了對 a 的序列化和反序列化，但對 O 只實現了 PHP4 中對象序列化格式，而沒有提供對 PHP 5

中擴展的對象序列化格式的支持。

r、R

分別表示對象引用和指針引用，這兩個也比較有用，在序列化比較復雜的數組和對象時就會產生帶有這兩個標示的數據，后面我們將詳細講解這兩個標示，目前這兩個標示尚沒有發現有其他語言的實現。

C 是 PHP5 中引入的，它表示自定義的對象序列化方式，盡管這對于其它語言來說是沒有必要實現的，因為很少會用到它，但是后面還是會對它進行詳細講解的。

U 是 PHP6 中才引入的，它表示 Unicode 編碼的字符串。因為 PHP6 中提供了 Unicode

方式保存字符串的能力，因此它提供了這種序列化字符串的格式，不過這個類型 PHP5、PHP4

都不支持，而這兩個版本目前是主流，因此在其它語言實現該類型時，不推薦用它來進行序列化，不過可以實現它的反序列化過程。在后面我也會對它的格式進行說明。

最后還有一個 o，這也是我唯一還沒弄清楚的一個數據類型標示。這個標示在 PHP3 中被引入用來序列化對象，但是到了 PHP4 以后就被 O 取代了。在

PHP3 的源代碼中可以看到對 o 的序列化和反序列化與數組 a 基本上是一樣的。但是在 PHP4、PHP5 和 PHP6

的源代碼中序列化部分里都找不到它的影子，但是在這幾個版本的反序列化程序源代碼中卻都有對它的處理，不過把它處理成什么我還沒弄清楚。因此對它暫時不再作更多說明了。

3．NULL 和標量類型的序列化

NULL 和標量類型的序列化是最簡單的，也是構成符合類型序列化的基礎。這部分內容相信許多 PHP

開發者都已經熟知。如果您感覺已經掌握了這部分內容，可以直接跳過這一章。

3.1．NULL 的序列化

在 PHP 中，NULL 被序列化為：

N; 3.2．boolean 型數據的序列化

boolean 型數據被序列化為：

b:;

其中

為 0 或 1，當 boolean 型數據為 false 時， 為 0，否則為 1。

3.3．integer 型數據的序列化

integer 型數據(整數)被序列化為：

i:;

其中

為一個整型數，范圍為：-2147483648 到

2147483647。數字前可以有正負號，如果被序列化的數字超過這個范圍，則會被序列化為浮點數類型而不是整型。如果序列化后的數字超過這個范圍(PHP

本身序列化時不會發生這個問題)，則反序列化時，將不會返回期望的數值。

3.4．double 型數據的序列化

double

型數據(浮點數)被序列化為：

d:;

其中 為一個浮點數，其范圍與 PHP

中浮點數的范圍一樣。可以表示成整數形式、浮點數形式和科學技術法形式。如果序列化無窮大數，則 為 INF，如果序列化負無窮大，則

為 -INF。序列化后的數字范圍超過 PHP 能表示的最大值，則反序列化時返回無窮大(INF)，如果序列化后的數字范圍超過 PHP

所能表示的最小精度，則反序列化時返回 0。

3.5．string 型數據的序列化

string 型數據(字符串)被序列化為：

s::"";

其中 是

的長度， 是非負整數，數字前可以帶有正號(+)。 為字符串值，這里的每個字符都是單字節字符，其范圍與

ASCII 碼的 0 - 255 的字符相對應。每個字符都表示原字符含義，沒有轉義字符， 兩邊的引號("")是必須的，但不計算在

當中。這里的 相當于一個字節流，而 是這個字節流的字節個數。

4．簡單復合類型的序列化

PHP

中的復合類型有數組(array)和對象(object)兩種，本章主要介紹在簡單情況下這兩種類型數據的序列化格式。關于嵌套定義的復合類型和自定義序列化方式的對象的序列化格式將在后面的章節詳細討論。

4.1．數組的序列化

數組(array)通常被序列化為：

a::{

1>...}

其中

表示數組元素的個數，、…… 表示數組下標，

1>、…… 表示與下標相對應的數組元素的值。

下標的類型只能是整型或者字符串型，序列化后的格式跟整型和字符串型數據序列化后的格式相同。

數組元素值可以是任意類型，其序列化后的格式與其所對應的類型序列化后的格式相同。

4.2．對象的序列化

對象(object)通常被序列化為：

O::"

name>"::{

2>...}

其中

表示對象的類名 的字符串長度。

表示對象中的字段1個數。這些字段包括在對象所在類及其祖先類中用 var、public、protected 和 private 聲明的字段，但是不包括

static 和 const 聲明的靜態字段。也就是說只有實例(instance)字段。

、

name 2>……表示每個字段的字段名，而 、

value 2>…… 則表示與字段名所對應的字段值。

字段名是字符串型，序列化后格式與字符串型數據序列化后的格式相同。

字段值可以是任意類型，其序列化后的格式與其所對應的類型序列化后的格式相同。

但字段名的序列化與它們聲明的可見性是有關的，下面重點討論一下關于字段名的序列化。

4.3．對象字段名的序列化

var 和 public

聲明的字段都是公共字段，因此它們的字段名的序列化格式是相同的。公共字段的字段名按照聲明時的字段名進行序列化，但序列化后的字段名中不包括聲明時的變量前綴符號 $。

protected 聲明的字段為保護字段，在所聲明的類和該類的子類中可見，但在該類的對象實例中不可見。因此保護字段的字段名在序列化時，字段名前面會加上

\0*\0

的前綴。這里的 \0 表示 ASCII 碼為 0 的字符，而不是 \0 組合。

private

聲明的字段為私有字段，只在所聲明的類中可見，在該類的子類和該類的對象實例中均不可見。因此私有字段的字段名在序列化時，字段名前面會加上

\0\0

的前綴。這里

表示的是聲明該私有字段的類的類名，而不是被序列化的對象的類名。因為聲明該私有字段的類不一定是被序列化的對象的類，而有可能是它的祖先類。

字段名被作為字符串序列化時，字符串值中包括根據其可見性所加的前綴。字符串長度也包括所加前綴的長度。其中 \0 字符也是計算長度的。

1注：在

PHP 手冊中，字段被稱為屬性，而實際上，在 PHP 5 中引入的用 __set、__get 來定義的對象成員更適合叫做屬性。因為用 __set、__get

來定義的對象成員與其它語言中的屬性的行為是一致，而 PHP

手冊中所說的屬性實際上在其他語言中(例如：C#)中被稱為字段，為了避免混淆，這里也稱為字段，而不是屬性。

5．嵌套復合類型的序列化

上一章討論了簡單的復合類型的序列化，大家會發現對于簡單的數組和對象其實也很容易。但是如果遇到自己包含自己或者 A 包含 B，B 又包含 A

這類的對象或數組時，PHP 又該如何序列化這種對象和數組呢？本章我們就來討論這種情況下的序列化形式。

5.1．對象引用和指針引用

在 PHP

中，標量類型數據是值傳遞的，而復合類型數據(對象和數組)是引用傳遞的。但是復合類型數據的引用傳遞和用 &

符號明確指定的引用傳遞是有區別的，前者的引用傳遞是對象引用，而后者是指針引用。

在解釋對象引用和指針引用之前，先讓我們看幾個例子。

echo "

";

class SampleClass {

var $value;

}

$a = new SampleClass();

$a->value = $a;

$b = new

SampleClass();

$b->value = &$b;

echo serialize($a);

echo

"\n";

echo serialize($b);

echo "\n";

echo "";

?>

這個例子的輸出結果是這樣的：

O:11:"SampleClass":1:{s:5:"value";r:1;}

O:11:"SampleClass":1:{s:5:"value";R:1;}

大家會發現，這里變量 $a 的 value 字段的值被序列化成了

r:1，而 $b 的 value 字段的值被序列化成了 R:1。

但是對象引用和指針引用到底有什么區別呢？

大家可以看下面這個例子：

echo "

";

class SampleClass {

var $value;

}

$a

= new SampleClass();

$a->value = $a;

$b = new SampleClass();

$b->value = &$b;

$a->value = 1;

$b->value = 1;

var_dump($a);

var_dump($b);

echo "";

大家會發現，運行結果也許出乎你的預料：

object(SampleClass)#1 (1) {

["value"]=>

int(1)

}

int(1)

改變 $a->value 的值僅僅是改變了 $a->value 的值，而改變

$b->value 的值卻改變了 $b 本身，這就是對象引用和指針引用的區別。

不過很不幸的是，PHP

對數組的序列化犯了一個錯誤，雖然數組本身在傳遞時也是對象引用傳遞，但是在序列化時，PHP 似乎忘記了這一點，看下面的例子：

echo

"

";

$a = array();

$a[1] = 1;

$a["value"] = $a;

echo $a["value"]["value"][1];

echo "\n";

$a =

unserialize(serialize($a));

echo $a["value"]["value"][1];

echo

"";

結果是：

1

大家會發現，將原數組序列化再反序列化后，數組結構變了。原本

$a["value"]["value"][1] 中的值 1，在反序列化之后丟失了。

原因是什么呢？讓我們輸出序列化之后的結果來看一看：

$a =

array();

$a[1] = 1;

$a["value"] = $a;

echo serialize($a);

結果是：

a:2:{i:1;i:1;s:5:"value";a:2:{i:1;i:1;s:5:"value";N;}}

原來，序列化之后，$a["value"]["value"] 變成了 NULL，而不是一個對象引用。

也就是說，PHP

只對對象在序列化時才會生成對象引用標示(r)。對所有的標量類型和數組(也包括 NULL)序列化時都不會生成對象引用。但是如果明確使用了 &

符號作的引用，在序列化時，會被序列化為指針引用標示(R)。

5.2．引用標示后的數字

在上面的例子中大家可能已經看到了，對象引用(r)和指針引用(R)的格式為：

r:;

R:;

大家一定很奇怪后面這個 是什么吧？本節我們就來詳細討論這個問題。

這個

簡單的說，就是所引用的對象在序列化串中第一次出現的位置，但是這個位置不是指字符的位置，而是指對象(這里的對象是泛指所有類型的量，而不僅限于對象類型)的位置。

我想大家可能還不是很明白，那么我來舉例說明一下：

class ClassA {

var $int;

var

$str;

var $bool;

var $obj;

var $pr;

}

$a =

new ClassA();

$a->int = 1;

$a->str = "Hello";

$a->bool =

false;

$a->obj = $a;

$a->pr = &$a->str;

echo

serialize($a);

這個例子的結果是：

O:6:"ClassA":5:{s:3:"int";i:1;s:3:"str";s:5:"Hello";s:4:"bool";b:0;s:3:"obj";r:1;s:2:"pr";R:3;}

在這個例子中，首先序列化的對象是 ClassA 的一個對象，那么給它編號為 1，接下來要序列化的是這個對象的幾個成員，第一個被序列化的成員是 int

字段，那它的編號就為 2，接下來被序列化的成員是 str，那它的編號就是 3，依此類推，到了 obj 成員時，它發現該成員已經被序列化了，并且編號為

1，因此它被序列化時，就被序列化成了 r:1; ，在接下來被序列化的是 pr 成員，它發現該成員實際上是指向 str 成員的一個引用，而 str 成員的編號為

3，因此，pr 就被序列化為 R:3; 了。

PHP 是如何來編號被序列化的對象的呢？實際上，PHP

在序列化時，首先建立一個空表，然后每個被序列化的對象在被序列化之前，都需要先計算該對象的 Hash 值，然后判斷該 Hash

值是否已經出現在該表中了，如果沒有出現，就把該 Hash

值添加到這個表的最后，返回添加成功。如果出現了，則返回添加失敗，但是在返回失敗前先判斷該對象是否是一個引用(用 & 符號定義的引用)，如果不是則也把

Hash 值添加到表后(盡管返回的是添加失敗)。如果返回失敗，則同時返回上一次出現的位置。

在添加 Hash

值到表中之后，如果添加失敗，則判斷添加的是一個引用還是一個對象，如果是引用，則返回 R 標示，如果是對象，則返回 r

標示。因為失敗時，會同時返回上一次出現的位置，因此，R 和 r 標示后面的數字，就是這個位置。

5.3．對象引用的反序列化

PHP

在反序列化處理對象引用時很有意思，如果反序列化的字符串不是 PHP 的 serialize()

本身生成的，而是人為構造或者用其它語言生成的，即使對象引用指向的不是一個對象，它也能正確地按照對象引用所指向的數據進行反序列化。例如：

echo

"

";

class StrClass {

var $a;

var $b;

}

$a = unserialize('O:8:"StrClass":2:{s:1:"a";s:5:"Hello";s:1:"b";r:2;}');

var_dump($a);

echo "";

運行結果：

object(StrClass)#1

(2) {

["a"]=>

string(5) "Hello"

["b"]=>

string(5)

"Hello"

}

大家會發現，上面的例子反序列化后，$a->b 的值與 $a->a 的值是一樣的，盡管 $a->a

不是一個對象，而是一個字符串。因此如果大家用其它語言來實現序列化的話，不一定非要把 string

作為標量類型來處理，即使按照對象引用來序列化擁有相同字符串內容的復合類型，用 PHP 同樣可以正確的反序列化。這樣可以更節省序列化后的內容所占用的空間。

6．自定義對象序列化 6.1．PHP 4 中自定義對象序列化

PHP 4 中提供了 __sleep 和 __wakeup

這兩個方法來自定義對象的序列化。不過這兩個函數并不改變對象序列化的格式，影響的僅僅是被序列化字段的個數。關于它們的介紹，在 PHP

手冊中寫的還算比較詳細。這里就不再多做介紹了。

6.2．PHP 5 中自定義對象序列化

PHP 5

中增加了接口(interface)功能。PHP 5 本身提供了一個 Serializable

接口，如果用戶在自己定義的類中實現了這個接口，那么在該類的對象序列化時，就會被按照用戶實現的方式去進行序列化，并且序列化后的標示不再是 O，而改為 C。C

標示的格式如下：

C::"":

length>:{}

其中 表示類名

的長度， 表示自定義序列化數據 的長度，而自定義的序列化數據

是完全的用戶自己定義的格式，與 PHP 序列化格式可以完全無關，這部分數據由用戶自己實現的序列化和反序列化接口方法來管理。

Serializable

接口中定義了 2 個方法，serialize() 和 unserialize($data)，這兩個方法不會被直接調用，而是在調用 PHP

序列化函數時，被自動調用。其中 serialize 函數沒有參數，它的返回值就是 的內容。而 unserialize($data)

有一個參數 $data，這個參數的值就是 的內容。這樣大家應該就明白了，實際上接口中 serialize

方法就是讓用戶來自己序列化對象中的內容，序列化后的內容格式，PHP 并不關心，PHP 只負責把它充填到 中，等到反序列化時，PHP

只負責取出這部分內容，然后傳給用戶實現的 unserialize($data) 接口方法，讓用戶自己去反序列化這部分內容。

下面舉個簡單的例子，來說明

Serializable 接口的使用：

class MyClass implements Serializable

{

public $member;

function MyClass()

{

$this->member = 'member value';

}

public function

serialize()

{

return wddx_serialize_value($this->member);

}

public function unserialize($data)

{

$this->member = wddx_deserialize($data);

}

}

$a = new

MyClass();

echo serialize($a);

echo "\n";

print_r(unserialize(serialize($a)));

輸出結果為(瀏覽器中的源代碼)：

C:7:"MyClass":90:{

version='1.0'>member

value

}

MyClass Object

(

[member] => member value

)

因此如果想用其它語言來實現 PHP 序列化中的 C

標示的話，也需要提供一種這樣的機制，讓用戶自定義類時,能夠自己在反序列化時處理 內容，否則，這些內容就無法被反序列化了。

7．Unicode 字符串的序列化

好了，最后再談談 PHP 6 中關于 Unicode 字符串序列化的問題吧。

說實話，我不怎么喜歡把字符串搞成雙字節 Unicode 這種編碼的東西。JavaScript

中也是用這樣的字符串，因此在處理字節流的東西時，反而非常的不方便。C#

雖然也是用這種方式來編碼字符串，不過還好的是，它提供了全面的編碼轉換機制，而且提供這種字符串到字節流(實際上是到字節數組)的轉換，所以處理起來還算是可以。但是對于不熟悉這個的人來說，轉來轉去就是個麻煩。

PHP 6 之前一直是按字節來編碼字符串的，到了 PHP 6 突然冒出個 Unicode

編碼的字符串來，雖然是可選的，但仍然讓人覺得非常不舒服，如果配置不當，老的程序兼容性都成問題。

當然加了這個東西以后，許多老的與字符串有關的函數都進行了修改。序列化函數也不例外。因此，PHP 6 中增加了專門的 Unicode 字符串序列化標示

U。PHP 6 中對 Unicode 字符串的序列化格式如下：

U::"";

這里 是指原 Unicode String 的長度，而不是 的長度，因為

是經過編碼以后的字節流了。

但是還有一點要注意， 盡管是原 Unicode

String 的長度，但是也不是只它的字節數，當然也不完全是指它的字符數，確切的說是之它的字符單位數。因為 Unicode String 中采用的是 UTF16

編碼，這種編碼方式使用 16 位來表示一個字符的，但是并不是所有的都是可以用 16 位表示的，因此有些字符需要兩個 16 位來表示一個字符。因此，在 UTF16

編碼中，16 位字符算作一個字符單位，一個實際的字符可能就是一個字符單位，也有可能由兩個字符單位組成。因此， Unicode String

中字符數并不總是等于字符單位數，而這里的 指的就是字符單位數，而不是字符數。

那

string> 又是怎樣被編碼的呢？實際上，它的編碼也很簡單，對于編碼小于 128 的字符(但不包括 \)，按照單個字節寫入，對于大于 128 的字符和

\ 字符，則轉化為 16 進制編碼的字符串，以 \ 作為開頭，后面四個字節分別是這個字符單位的 16 進制編碼，順序按照由高位到低位排列，也就是第 16-13

位所對應的16進制數字字符(abcdef 這幾個字母是小寫)作為第一個字節，第 12-9 位作為第二個字節，第 8-5 位作為第三個字節，最后的第 4-1

位作為第四個字節。依次編碼下來，得到的就是 的內容了。

我認為對于其他語言來說，沒有必要實現這種序列化方式，因為用這種方式序列化的內容，對于目前的主流 PHP

服務器來說都是不支持的，不過倒是可以實現它的反序列化，這樣將來即使跟 PHP 6 進行數據交換，也可以互相讀懂了。

總結

以上是生活随笔為你收集整理的php serialize mysql_php 序列化（serialize）格式详解的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。