PHP Token函數是一種將字符串分解為標記的函數。它非常有用，因為它可以幫助開發人員對代碼進行詞法分析，從而更好地理解和維護代碼。舉個例子，我們可以使用Token函數來檢查代碼中是否有語法錯誤，或者查找特定的字符串模式。

在使用Token函數之前，我們需要先理解PHP中的Token是什么。Token是指在編譯器中被解釋為獨立詞法單元的字符串。簡單來說，Token是代碼中具有特定意義的單詞或符號，例如變量名、運算符、括號、關鍵字等等。

<?php
$str = "echo Hello World;";
$tokens = token_get_all($str);
print_r($tokens);
?>

在上面的示例中，我們使用了Token函數將字符串“echo Hello World;”分解為標記并保存在變量$tokens中。我們使用print_r函數打印$tokens數組，輸出結果如下：

Array
(
[0] => Array
(
[0] => 307
[1] => echo
[2] => 1
)
[1] => Hello
[2] => World
[3] => Array
(
[0] => 59
[1] => ;
[2] => 1
)
)

可以發現，Token函數將字符串分解為了4個標記。第一個標記是一個數組，包含了echo關鍵字的信息。第二個和第三個標記是普通字符串，分別代表Hello和World。最后一個標記是一個數組，包含了分號的信息。

Token函數返回的每個標記都是一個數組，包含了標記的類型和值。標記的類型是一個整數，代表了這個標記屬于哪個類型，例如關鍵字、變量名、運算符、括號等等。標記的值是一個字符串，代表了這個標記的具體內容。

下面是一個關于Token函數的更復雜的例子，該例子可以幫助我們理解更多的功能。假設我們需要對一個包含多個PHP文件的目錄進行代碼分析，找出其中所有的函數并打印它們的名稱和定義所處的文件。我們可以使用以下代碼實現：

<?php
function get_functions($path) {
$functions = array();
$iterator = new RecursiveIteratorIterator(new RecursiveDirectoryIterator($path));
foreach($iterator as $file) {
if($file->isFile() && $file->getExtension() == "php") {
$tokens = token_get_all(file_get_contents($file->getPathname()));
$function = array();
$line = $name = '';
$in_function = false;
foreach($tokens as $token) {
if(is_array($token)) {
if($token[0] == T_FUNCTION) {
$in_function = true;
continue;
}
if($token[0] == T_STRING && $in_function) {
$name = $token[1];
}
if($token[0] == T_VARIABLE && $in_function) {
$function['args'][] = str_replace('$', '', $token[1]);
}
if($token[0] == T_ENCAPSED_AND_WHITESPACE && $in_function) {
$function['body'] .= $token[1];
}
if($token[0] == T_WHITESPACE && $in_function && empty($function['line'])) {
$function['line'] = $line;
}
if($token[0] == T_OPEN_CURLY && $in_function) {
$in_function = false;
$function['name'] = $name;
$function['file'] = $file->getFilename();
$functions[] = $function;
$function = array();
}
$line = $token[2];
} else {
$line = $token;
}
}
}
}
return $functions;
}
print_r(get_functions('/path/to/directory'));
?>

上面的代碼中，我們定義了一個get_functions函數，該函數用于獲取一個目錄下所有PHP文件中的函數列表。我們首先使用RecursiveIteratorIterator和RecursiveDirectoryIterator類遍歷目錄，然后使用Token函數獲取每個文件的標記數組。接下來，我們遍歷標記數組，并對每個函數定義進行解析。

要解析函數定義，我們需要使用多個if語句來分別處理不同類型的標記。我們首先使用T_FUNCTION常量來判斷當前標記是否為函數定義的開始。如果是，我們將$in_function設置為true，并跳過當前標記。接下來，我們使用T_STRING常量來獲取函數的名稱。再接下來，我們使用T_VARIABLE常量來獲取函數的參數列表。然后，我們使用T_ENCAPSED_AND_WHITESPACE常量來獲取函數體。最后，我們使用T_WHITESPACE和T_OPEN_CURLY常量來確定函數定義的結束，并將該函數的信息保存到$functions數組中。

最后，我們僅需調用get_functions函數，并將要分析的目錄作為參數傳入。函數會輸出所有函數的名稱、參數列表、函數體和定義所處的文件。這個例子演示了Token函數在實際開發中的強大威力。