PHP內部函數的定義

相關推薦

PHP內部函數的定義

　　PHP（外文名:PHP: Hypertext Preprocessor，中文名：“超文本預處理器”）是一種通用開源腳本語言。語法吸收了C語言、Java和Perl的特點，利于學習，使用廣泛，主要適用于Web開發領域。那么PHP內部函數的定義是怎樣的呢？以下僅供參考！

　　如何找到函數的定義

　　作為開始，讓我們嘗試找出strpos函數的定義。

　　嘗試的第一步，就是去PHP 5.4根目錄然后在頁面頂部的搜索框輸入strpos。搜索的結果是一個很大的列表，展示了strpos在PHP源碼中出現的位置。

　　因為這個結果對我們并沒有太大的幫助，我們使用一個小技巧：我們搜索”PHP_FUNCTION strpos”（不要漏了雙引號，它們很重要），而不是strpos.

　　現在我們得到兩個入口鏈接：

　　/PHP_5_4/ext/standard/

　　php_string.h 48 PHP_FUNCTION(strpos);

　　string.c 1789 PHP_FUNCTION(strpos)

　　第一個要注意的事情是，兩個位置都是在ext/standard文件夾。這就是我們希望找到的，因為strpos函數（跟大部分string，array和文件函數一樣）是standard擴展的一部分。

　　現在，在新標簽頁打開兩個鏈接，然后看看它們背后藏了什么代碼。

　　你會看到第一個鏈接帶你到了php_string.h文件，它包含了下面的代碼：

　　// ...

　　PHP_FUNCTION(strpos);

　　PHP_FUNCTION(stripos);

　　PHP_FUNCTION(strrpos);

　　PHP_FUNCTION(strripos);

　　PHP_FUNCTION(strrchr);

　　PHP_FUNCTION(substr);

　　// ...

　　這就是一個典型的頭文件（以.h后綴結尾的文件）的樣子：單純的函數列表，函數在其他地方定義。事實上，我們對這些并不感興趣，因為我們已經知道我們要找的是什么。

　　第二個鏈接更有趣：它帶我們到string.c文件，這個文件包含了函數真正的源代碼。

　　在我帶你一步一步地查閱這個函數之前，我推薦你自己嘗試理解這個函數。這是一個很簡單的函數，盡管你不知道真正的細節，但大多數代碼看起來都很清晰。

　　PHP函數的骨架

　　所有的PHP函數都使用同一個基本結構。在函數頂部定義了各個變量，然后調用zend_parse_parameters函數，然后到了主要的邏輯，當中有RETURN_***和php_error_docref的調用。

　　那么，讓我們以函數的定義來開始：

　　zval *needle;

　　char *haystack;

　　char *found = NULL;

　　char needle_char[2];

　　long offset = 0;

　　int haystack_len;

　　第一行定義了一個指向zval的指針needle。zval是在PHP內部代表任意一個PHP變量的定義。它真正是怎么樣的會在下一篇文章重點談論。

　　第二行定義了指向單個字符的指針haystack。這時候，你需要記住，在C語言里面，數組代表指向它們第一個元素的指針。比如說，haystack變量會指向你所傳遞的$haystack字符串變量的第一個字符。haystack + 1會指向第二個字符，haystack + 2指向第三個，以此類推。因此，通過逐個遞增指針，可以讀取整個字符串。

　　那么問題來了，PHP需要知道字符串在哪里結束。不然的話，它會一直遞增指針而不會停止。為了解決這個問題，PHP也保存了明確的長度，這就是haystack_len變量。

　　現在，在上面的定義中，我們感興趣的是offset變量，這個變量用來保存函數的第三個參數：開始搜索的偏移量。它使用long來定義，跟int一樣，也是整型數據類型。現在這兩者的差異并不重要，但你需要知道的是在PHP中，整型值使用long來存儲，字符串的長度使用int來存儲。

　　現在來看看下面的三行：

　　if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz|l", &haystack, &haystack_len, &needle, &offset) == FAILURE) {

　　return;

　　}

　　這三行代碼做的事情就是，獲取傳遞到函數的參數，然后把它們存儲到上面聲明的變量中。

　　傳遞給函數的第一個參數是傳遞參數的數量。這個數字通過ZEND_NUM_ARGS()宏提供。

　　下一個函數是TSRMLS_CC宏，這是PHP的一種特性。你會發現這個奇怪的宏分散在PHP代碼庫的很多地方。是線程安全資源管理器（TSRM）的一部分，它保證PHP不會在多線程之間混亂變量。這對我們來說不是很重要，當你在代碼中看到TSRMLS_CC（或者TSRMLS_DC）的時候，忽略它就行。（有一個奇怪的地方你需要注意的是，在”argument”之前沒有逗號。這是因為不管你是否使用線程安全創建函數，該宏會被解釋為空或者, trsm_ls。因此，逗號是宏的一部分。）

　　現在，我們來到重要的東西：”sz|l”字符串標記了函數接收的參數。：

　　s // 第一個參數是字符串

　　z // 第二個參數是一個zval結構體，任意的變量

　　| // 標識接下來的參數是可選的

　　l // 第三個參數是long類型（整型）

　　除了s，z，l之外，還有更多的標識類型，但是大部分都能從字符中清楚其意思。例如b是boolean，d是double（浮點型數字），a是array，f是回調（function），o是object。

　　接下來的參數&haystack，&haystack_len，&needle，&offset指定了需要賦值的參數的變量。你可以看到，它們都是使用引用（&）傳遞的，意味著它們傳遞的不是變量本身，而是指向它們的指針。

　　這個函數調用之后，haystack會包含haystack字符串，haystack_len是字符串的長度，needle是needle的值，offset是開始的偏移量。

　　而且，這個函數使用FAILURE（當你嘗試傳遞無效參數到函數時會發生，比如傳遞一個數組賦值到字符串）來檢查。這種情況下zend_parse_parameters函數會拋出警告，而此函數馬上返回（會返回null給PHP的用戶層代碼）。

　　在參數解析完畢以后，主函數體開始：

　　if (offset < 0 || offset > haystack_len) {

　　php_error_docref(NULL TSRMLS_CC, E_WARNING, "Offset not contained in string");

　　RETURN_FALSE;

　　}

　　這段代碼做的事情很明顯，如果offset超出了邊界，一個E_WARNING級別的錯誤會通過php_error_docref函數拋出，然后函數使用RETURN_FALSE宏返回false。

　　php_error_docref是一個錯誤函數，你可以在擴展目錄找到它（比如，ext文件夾）。它的名字根據它在錯誤頁面中返回文檔參考（就是那些不會正常工作的函數）定義。還有一個zend_error函數，它主要被Zend Engine使用，但也經常出現在擴展代碼中。

　　兩個函數都使用sprintf函數，比如格式化信息，因此錯誤信息可以包含占位符，那些占位符會被后面的參數填充。下面有一個例子：

　　php_error_docref(NULL TSRMLS_CC, E_WARNING, "Failed to write %d bytes to %s", Z_STRLEN_PP(tmp), filename);

　　// %d is filled with Z_STRLEN_PP(tmp)

　　// %s is filled with filename

　　讓我們繼續解析代碼：

　　if (Z_TYPE_P(needle) == IS_STRING) {

　　if (!Z_STRLEN_P(needle)) {

　　php_error_docref(NULL TSRMLS_CC, E_WARNING, "Empty delimiter");

　　RETURN_FALSE;

　　}

　　found = php_memnstr(haystack + offset,

　　Z_STRVAL_P(needle),

　　Z_STRLEN_P(needle),

　　haystack + haystack_len);

　　}

　　前面的5行非常清晰：這個分支只會在needle為字符串的情況下執行，而且如果它是空的話會拋出錯誤。然后到了比較有趣的一部分：php_memnstr被調用了，這個函數做了主要的工作。跟往常一樣，你可以點擊該函數名然后查看它的源碼。

　　php_memnstr返回指向needle在haystack第一次出現的位置的指針（這就是為什么found變量要定義為char *，例如，指向字符的指針）。從這里可以知道，偏移量（offset）可以通過減法被簡單地計算，可以在函數的最后看到：

　　RETURN_LONG(found - haystack);

　　最后，讓我們來看看當needle作為非字符串的時候的分支：

　　else {

　　if (php_needle_needle, needle_char TSRMLS_CC) != SUCCESS) {

　　RETURN_FALSE;

　　}

　　needle_char[1] = 0;

　　found = php_memnstr(haystack + offset,

　　needle_char,

　　haystack + haystack_len);

　　}

　　我只引用在手冊上寫的”如果 needle 不是一個字符串，那么它將被轉換為整型并被視為字符順序值。”這基本上說明，除了寫strpos($str, 'A')，你還可以寫strpos($str, 65)，因為A字符的編碼是65。

　　如果你再查看變量定義，你可以看到needle_char被定義為char needle_char[2]，即有兩個字符的字符串，php_needle_char會將真正的字符（在這里是’A’）到needle_char[0]。然后strpos函數會設置needle_char[1]為0。這背后的原因是因為，在C里面，字符串是使用’’結尾，就是說，最后一個字符被設置為NUL（編碼為0的字符）。在PHP的語法環境里，這樣的情況不存在，因為PHP存儲了所有字符串的長度（因此它不需要0來幫助找到字符串的結尾），但是為了保證與C函數的兼容性，還是在PHP的內部實現了。

　　Zend functions

　　我對strpos這個函數感覺好累，讓我們找另一個函數吧：strlen。我們使用之前的方法：

　　從PHP5.4源碼根目錄開始搜索strlen。

　　你會看到一堆無關的函數的使用，因此，搜索“PHP_FUNCTION strlen”。當你這么搜索的時候，你會發現一些奇怪的事情發生了：沒有任何的結果。

　　原因是，strlen是少數通過Zend Engine而不是PHP擴展定義的函數。這種情況下，函數不是使用PHP_FUNCTION(strlen)定義，而是ZEND_FUNCTION(strlen)。因此，我們也要搜索“ZEND_FUNCTION strlen”。

　　我們都知道，我們需要點擊沒有分號結尾的鏈接跳到源碼的定義。這個鏈接帶我們到下面的函數定義：

　　ZEND_FUNCTION(strlen)

　　{

　　char *s1;

　　int s1_len;

　　if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &s1, &s1_len) == FAILURE) {

　　return;