{php 函數}
一、用戶(hù)自定義函數
一個(gè)函數可由以下的語(yǔ)法來(lái)定義:
任何有效的 PHP 代碼都有可能出現在函數內部,甚至包括其它函數和類(lèi)定義。
函數名和 PHP 中的其它標識符命名規則相同。有效的函數名以字母或下劃線(xiàn)打頭,后面跟字母,數字或下劃線(xiàn)。
可以用正則表達式表示為:[a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*。
Example #
<?php
function foo($arg_1, $arg_2, ..., $arg_n)
{
//邏輯代碼
echo "Example function.\n";
return $retval;
}
?>
Example #2 條件函數(Conditional functions)
<?php
$makefoo = true;
/* 我們不能在處調用foo()函數,
因為它還不存在,但可以調用bar()函數。*/
bar();
if ($makefoo) {
function foo()
{
echo "I don't exist until program execution reaches me.\n";
}
}
/* 現在我們可以安全調用函數 foo()了,
因為 $makefoo 值為真 */
if ($makefoo)
foo();
function bar()
{
echo "I exist immediately upon program start.\n";
}
?>
Example #3 函數中的函數
<?php
function foo()
{
function bar()
{
echo "I don't exist until foo() is called.\n";
}
}
/* 現在還不能調用bar()函數,因為它還不存在 */
foo();
/* 現在可以調用bar()函數了,因為foo()函數
的執行使得bar()函數變?yōu)橐讯x的函數 */
bar();
?>
PHP 中的所有函數和類(lèi)都具有全局作用域,可以在內部定義外部調用,反之亦然。
PHP 不支持函數重載,也不可能取消定義或者重定義已聲明的函數。
Note: 函數名是大小寫(xiě)無(wú)關(guān)的,不過(guò)在調用函數的時(shí)候,通常使用其在定義時(shí)相同的形式。
Note: function只有在class 里面才可以加訪(fǎng)問(wèn)權限!
PHP 支持可變數量的參數和默認參數。具體請參考: func_num_args(),func_get_arg(),以及func_get_args()。
Example #4 遞歸函數
在 PHP 中可以調用遞歸函數。但是要避免遞歸函數/方法調用超過(guò) 100-200 層,因為可能會(huì )破壞堆棧從而使當前腳本終止。
<?php
function recursion($a)
{
if ($a < 20) {
echo "$a\n";
recursion($a + 1);
}
}
?>
Example #5 回調函數
<?php
function foo(&$bar)//關(guān)鍵是參數前加個(gè)&
{ $bar='2';}
$str='1';
foo($str);
echo $str; //輸出2
?>
二、函數的參數
通過(guò)參數列表可以傳遞信息到函數,即以逗號作為分隔符的表達式列表。
PHP 支持按值傳遞參數(默認),通過(guò)引用傳遞參數以及默認參數。也支持可變數量的參數;
更多信息請參照可變長(cháng)度參數列表和涉及到的相關(guān)函數func_num_args(),func_get_arg() 以及 func_get_args()。
Example #1 向函數傳遞數組&
<?php
function takes_array($input)
{
echo "$input[0] + $input[1] = ", $input[0]+$input[1];
}
$shit="123";
takes_array($shit)
?>
輸出:1 + 2 = 3
通過(guò)引用傳遞參數
缺省情況下,函數參數通過(guò)值傳遞(因而即使在函數內部改變參數的值,它并不會(huì )改變函數外部的值)。如果希望允許函數修改它的參數值,必須通過(guò)引用傳遞參數。
如果想要函數的一個(gè)參數總是通過(guò)引用傳遞,可以在函數定義中該參數的前面預先加上符號 &:
Example #2 用引用傳遞函數參數
<?php
function add_some_extra(&$string)
{
$string .= 'and something extra.';
}
$str = 'This is a string, ';
add_some_extra($str);
echo $str; // $str的值被改變:outputs 'This is a string, and something extra.'
?>
默認參數的值
Example #3 在函數中使用默認參數
<?php
function makecoffee($type = "cappuccino")
{
return "@ $type;\n";
}
echo makecoffee();
echo makecoffee(null);//PHP 還允許使用數組和特殊類(lèi)型 NULL 作為默認參數,例如:
echo makecoffee("espresso");//@ cappuccino; @ ; @ espresso;
?>
Example #4 使用非標量類(lèi)型作為默認參數
<?php
function makecoffee($types = array("cappuccino"), $coffeeMaker = NULL)
{
$device = is_null($coffeeMaker) ? "hands" : $coffeeMaker;
return "Making a cup of ".join(", ", $types)." with $device.\n";
}
echo makecoffee();
echo makecoffee(array("cappuccino", "lavazza"), "teapot");
?>
默認值必須是常量表達式,不能是諸如變量,類(lèi)成員,或者函數調用等表達式。
請注意當使用默認參數時(shí),任何默認參數必須放在任何非默認參數的右側;否則,函數將不會(huì )按照預期的情況工作。考慮下面的代碼片斷:
函數默認參數不正確的用法
Example #5
<?php
function makeyogurt($type = "acidophilus", $flavour)
{
return "Making a bowl of $type $flavour.\n";
}
echo makeyogurt("raspberry"); // won't work as expected
?>
上述例子的輸出是:
Warning: Missing argument 2 in call to makeyogurt() in
/usr/local/etc/httpd/htdocs/php3test/functest.html on line 41
Making a bowl of raspberry .
Example #6
<?php
function makeyogurt($flavour, $type = "acidophilus")
{
return "Making a bowl of $type $flavour.\n";
}
echo makeyogurt("raspberry"); // works as expected
?>
這個(gè)例子的輸出是:
Making a bowl of acidophilus raspberry.
Note: 自 PHP 5 起,默認值可以通過(guò)引用傳遞。
可變數量的參數列表
PHP 4 及更高版本已經(jīng)在用戶(hù)自定義函數中支持可變數量的參數列表。其實(shí)很簡(jiǎn)單,只需使用 func_num_args(),func_get_arg(),和 func_get_args() 函數即可。
可變參數并不需要特別的語(yǔ)法,參數列表仍按函數定義的方式傳遞給函數,并按通常的方式使用這些參數。
~
三、返回值
值通過(guò)使用可選的返回語(yǔ)句返回。可以返回包括數組和對象的任意類(lèi)型。返回語(yǔ)句會(huì )立即中止函數的運行,并且將控制權交回調用該函數的代碼行。更多信息見(jiàn) return()。
Example #1 return() 的使用
<?php
function square($num)
{
return $num * $num;
}
echo square(4); // outputs '16'.
?>
函數不能返回多個(gè)值,但可以通過(guò)返回一個(gè)數組來(lái)得到類(lèi)似的效果。
Example #2 返回一個(gè)數組以得到多個(gè)返回值
<?php
function small_numbers()
{
return array (0, 1, 2);
}
list ($zero, $one, $two) = small_numbers();
?>
從函數返回一個(gè)引用,必須在函數聲明和指派返回值給一個(gè)變量時(shí)都使用引用操作符 & :
Example #3 從函數返回一個(gè)引用
<?php
function &returns_reference()
{
return $someref;
}
$newref =& returns_reference();
?>
~
~
四、可變函數
PHP 支持可變函數的概念。這意味著(zhù)如果一個(gè)變量名后有圓括號,PHP 將尋找與變量的值同名的函數,并且嘗試執行它。可變函數可以用來(lái)實(shí)現包括回調函數,函數表在內的一些用途。
變量函數不能用于語(yǔ)言結構,例如 echo(),print(),unset(),isset(),empty(),include(),require() 以及類(lèi)似的語(yǔ)句。需要使用自己的包裝函數來(lái)將這些結構用作變量函數。
Example #1 可變函數示例
<?php
function foo() {
echo "In foo()<br />\n";
}
function bar($arg = '') {
echo "In bar(); argument was '$arg'.<br />\n";
}
// 使用 echo 的包裝函數
function echoit($string)
{
echo $string;
}
$func = 'foo';
$func(); // This calls foo()
$func = 'bar';
$func('test'); // This calls bar()
$func = 'echoit';
$func('test'); // This calls echoit()
?>
還可以利用可變函數的特性來(lái)調用一個(gè)對象的方法。
Example #2 可變方法范例
<?php
class Foo
{
function Variable()
{
$name = 'Bar';
$this->$name(); // This calls the Bar() method
}
function Bar()
{
echo "This is Bar";
}
}
$foo = new Foo();
$funcname = "Variable";
$foo->$funcname(); // This calls $foo->Variable()
?>
請參閱 call_user_func(),可變變量和 function_exists()。
~
五、內部(內置)函數
PHP 有很多標準的函數和結構。還有一些函數需要和特定地 PHP 擴展模塊一起編譯,否則在使用它們的時(shí)候就會(huì )得到一個(gè)致命的“未定義函數”錯誤。例如,要使用image函數比如imagecreatetruecolor(),需要在編譯 PHP 的時(shí)候加上 GD 的支持。或者,要使用 mysql_connect() 函數,就需要在編譯 PHP 的時(shí)候加上 MySQL 支持。有很多核心函數已包含在每個(gè)版本的 PHP 中如字符串和變量函數。調用 phpinfo() 或者 get_loaded_extensions() 可以得知 PHP 加載了那些擴展庫。同時(shí)還應該注意,很多擴展庫默認就是有效的。PHP 手冊按照不同的擴展庫組織了它們的文檔。請參閱配置,安裝以及各自的擴展庫章節以獲取有關(guān)如何設置 PHP 的信息。
手冊中如何閱讀函數原型講解了如何閱讀和理解一個(gè)函數的原型。確認一個(gè)函數將返回什么,或者函數是否直接作用于傳遞的參數是很重要的。例如,str_replace() 函數將返回修改過(guò)的字符串,而 usort() 卻直接作用于傳遞的參數變量本身。手冊中,每一個(gè)函數的頁(yè)面中都有關(guān)于函數參數、行為改變、成功與否的返回值以及使用條件等信息。了解這些重要的(常常是細微的)差別是編寫(xiě)正確的 PHP 代碼的關(guān)鍵。
Note: 如果傳遞給函數的參數類(lèi)型與實(shí)際的類(lèi)型不一致,例如將一個(gè)array傳遞給一個(gè)string類(lèi)型的變量,那么函數的返回值是不確定的。在這種情況下,通常函數會(huì )返回NULL。但這僅僅是一個(gè)約定,并不一定如此。
參見(jiàn) function_exists(),函數參考,get_extension_funcs() 和 dl()。
六、匿名函數Note: 匿名函數只在PHP 5.3.0 及以上版本有效。
匿名函數(Anonymous functions),也叫閉包函數(closures),允許 臨時(shí)創(chuàng )建一個(gè)沒(méi)有指定名稱(chēng)的函數。最經(jīng)常用作回調函數(callback)的參數。 當然,也有其他應用的情況。
Example #1 Anonymous function 示例
<?php
echo preg_replace_callback('~-([a-z])~', function ($match) {
return strtoupper($match[1]);
}, 'hello-world');
// 輸出 helloWorld
?>
閉包函數也可以作為變量的值來(lái)使用。PHP會(huì )自動(dòng)把表達式轉換成內置類(lèi)Closure的 對象實(shí)例。把一個(gè)closure對象賦值給一個(gè)變量的方式與普通變量賦值的語(yǔ)法是一樣的,最后也要加上分號。
Example #2 匿名函數變量賦值示例
<?php
$greet = function($name)
{
printf("Hello %s\r\n", $name);
};
$greet('World');
$greet('PHP');
?>
Closure對象也會(huì )從父作用域中繼承類(lèi)屬性。這些變量都必須在函數或類(lèi)的頭部聲明。從父作用域中繼承 變量與使用全局變量是*不同*的。全局變量存在于一個(gè)全局的范圍,無(wú)論當前在執行的是哪個(gè)函數。而closure 的父類(lèi)作用域則是聲明該closure的函數(不一定要是它被調用的函數)。示例如下:
Example #3 Closures和作用域
<?php
// 一個(gè)基本的購物車(chē),包括一些已經(jīng)添加的商品和每種商品的數量。
// 其中有一個(gè)方法用來(lái)計算購物車(chē)中所有商品的總價(jià)格。該方法使用了一個(gè)closure作為回調函數。
class Cart
{
const PRICE_BUTTER = 1.00;
const PRICE_MILK = 3.00;
const PRICE_EGGS = 6.95;
protected $products = array();
public function add($product, $quantity)
{
$this->products[$product] = $quantity;
}
public function getQuantity($product)
{
return isset($this->products[$product]) ? $this->products[$product] :
FALSE;
}
public function getTotal($tax)
{
$total = 0.00;
$callback =
function ($quantity, $product) use ($tax, &$total)
{
$pricePerItem = constant(__CLASS__ . "::PRICE_" .
strtoupper($product));
$total += ($pricePerItem * $quantity) * ($tax + 1.0);
};
array_walk($this->products, $callback);
return round($total, 2);;
}
}
$my_cart = new Cart;
// 往購物車(chē)里添加條目
$my_cart->add('butter', 1);
$my_cart->add('milk', 3);
$my_cart->add('eggs', 6);
// 打出出總價(jià)格,其中有 5% 的銷(xiāo)售稅.
print $my_cart->getTotal(0.05) . "\n";
// The result is 54.29
?>
匿名函數目前是通過(guò) Closure類(lèi)來(lái)實(shí)現的。目前還不穩定,不適用于正式開(kāi)發(fā)。
Note: 匿名函數只在PHP 5.3.0 及以上版本有效。
Note: 在closure內部可以調用 func_num_args(), func_get_arg(), 和 func_get_args() 等函數來(lái)獲取參數信息。
~
~
- 上一篇 ?php常用函數,持續更新
- 下一篇 ?[PHP函數]日期時(shí)間函數