ユーザー定義関数 パラメーターの戻り値 変数関数 内部 (組み込み) 関数 無名関数 1. ユーザー定義関数
関数は次の構文で定義できます:
関数内には有効な PHP コードを含めることができます 内部的には、他の関数やクラス定義も含まれます。
関数名には、PHP の他の識別子と同じ命名規則があります。有効な関数名は文字またはアンダースコアで始まり、その後に文字、数字、またはアンダースコアが続きます。
は正規表現: [a-zA-Z_x7f-xff][a-zA-Z0-9_x7f-xff]* で表すことができます。
Example #
<p class="sycode"> <? phpfunction foo($arg_1, $arg_2, ..., $arg_n){ // 逻辑代码 echo " Example function.\n " ; return $retval;} ?> </p>
例 #2 条件関数 (条件関数)
<p class="sycode"> <? 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 " ;} ?> </p>
例 #3 関数内の関数
<p class="sycode"> <? phpfunction foo(){ function bar() { echo " I don't exist until foo() is called.\n " ; }} /* 现在还不能调用bar()函数,因为它还不存在 */ foo(); /* 现在可以调用bar()函数了,因为foo()函数 的执行使得bar()函数变为已定义的函数 */ bar(); ?> </p>
PHP のすべての関数とクラスにはグローバル スコープがあり、内部で定義して外部から呼び出すことができ、またその逆も可能です。
PHP は関数のオーバーロードをサポートしておらず、宣言された関数を定義解除または再定義することはできません。
注: 関数名では大文字と小文字が区別されませんが、関数を呼び出すときは、通常、関数が定義されたときと同じ形式が使用されます。
注: アクセス許可はクラス内の関数にのみ追加できます。
PHP は、可変数のパラメーターとデフォルトのパラメーターをサポートしています。詳細については、func_num_args()、func_get_arg()、および func_get_args() を参照してください。
例 #4 再帰関数
再帰関数は PHP で呼び出すことができます。ただし、スタックが破損し、現在のスクリプトが終了する可能性があるため、100 ~ 200 レベルを超える再帰的な関数/メソッド呼び出しは避けてください。
<p class="sycode"> <? phpfunction recursion($a){ if ($a < 20 ) { echo " $a\n " ; recursion($a + 1 ); }} ?> </p>
<p class="sycode"> <? phpfunction foo( & $bar) // 关键是参数前加个& { $bar = ' 2 ' ;}$str = ' 1 ' ;foo($str);echo $str; // 输出2 ?> </p>
情報は、カンマで区切られた式のリストであるパラメータ リストを通じて関数に渡すことができます。
PHP は、値によるパラメーターの受け渡し (デフォルト)、参照によるパラメーターの受け渡し、およびデフォルトのパラメーターをサポートしています。可変数のパラメーターもサポートしています
詳細については、可変長パラメーターのリストと関連関数 func_num_args()、func_get_arg()、および func_get_args() を参照してください。
例 #1 function&
<p class="sycode"> <? phpfunction takes_array($input){ echo " $input[0] + $input[1] = " , $input[ 0 ] + $input[ 1 ];}$shit = " 123 " ;takes_array($shit) ?> </p> <p class="sycode"> 输出:1 + 2 = 3 </p>
パラメータを参照で渡す デフォルトでは、関数パラメータは値によって渡されます (パラメータの値が内部で変更されたとしても)関数の外では値は変更されません)。関数がその引数値を変更できるようにするには、引数を参照渡しする必要があります。
関数のパラメーターを常に参照によって渡したい場合は、関数定義のパラメーターの前に記号 & を追加できます:
例 #2 関数のパラメーターを参照によって渡す
<p class="sycode"> <? phpfunction 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.' ?> </p>
デフォルトパラメータの値例 #3 関数内でデフォルトパラメータを使用する
<p class="sycode"> <? phpfunction makecoffee($type = " cappuccino " ){ return " @ $type;\n " ;}echo makecoffee(); </p> <p class="sycode"> echo makecoffee( null );//PHP 还允许使用数组和特殊类型 NULL 作为默认参数,例如:echo makecoffee( " espresso " ); // @ cappuccino; @ ; @ espresso; ?> </p>
例 #4 デフォルトパラメータとして非スカラー型を使用する
関数 makecoffee($types = array ("cappuccino"), $coffeeMaker = NULL)
{
$device = is_null($coffeeMaker) ? "hands" : $coffeeMaker
return "".join(", ", $types) のカップを作る." with $device.n";
echo makecoffee();
<p class="sycode"> <p class="sycode"> <pre class="sycode" name="code"> <p class="sycode"> 函数默认参数不正确的用法 </p>
<p class="sycode"> Example #5<?phpfunction 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 41Making a bowl of raspberry .Example #6 <?phpfunction makeyogurt($flavour, $type = "acidophilus"){ return "Making a bowl of $type $flavour.\n";}echo makeyogurt("raspberry"); // works as expected?>这个例子的输出是:Making a bowl of acidophilus raspberry. </p>
Note: 自 PHP 5 起,默认值可以通过引用传递。
可变数量的参数列表
PHP 4 及更高版本已经在用户自定义函数中支持可变数量的参数列表。其实很简单,只需使用 func_num_args(),func_get_arg(),和 func_get_args() 函数即可。
可变参数并不需要特别的语法,参数列表仍按函数定义的方式传递给函数,并按通常的方式使用这些参数。
~
三、返回值值通过使用可选的返回语句返回。可以返回包括数组和对象的任意类型。返回语句会立即中止函数的运行,并且将控制权交回调用该函数的代码行。更多信息见 return()。
Example #1 return() 的使用
<p class="sycode"> <? phpfunction square($num){ return $num * $num;}echo square( 4 ); // outputs '16'. ?> </p>
函数不能返回多个值,但可以通过返回一个数组来得到类似的效果。
Example #2 返回一个数组以得到多个返回值
<p class="sycode"> <? phpfunction small_numbers(){ return array ( 0 , 1 , 2 );}list ($zero, $one, $two) = small_numbers(); ?> </p>
从函数返回一个引用,必须在函数声明和指派返回值给一个变量时都使用引用操作符 & :
Example #3 从函数返回一个引用
<p class="sycode"> <? phpfunction & returns_reference(){ return $someref;}$newref =& returns_reference(); ?> </p>
~
~
四、可变函数PHP 支持可变函数的概念。这意味着如果一个变量名后有圆括号,PHP 将寻找与变量的值同名的函数,并且尝试执行它。可变函数可以用来实现包括回调函数,函数表在内的一些用途。
变量函数不能用于语言结构,例如 echo(),print(),unset(),isset(),empty(),include(),require() 以及类似的语句。需要使用自己的包装函数来将这些结构用作变量函数。
Example #1 可变函数示例
<p class="sycode"> <?phpfunction 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()?> </p>
还可以利用可变函数的特性来调用一个对象的方法。
Example #2 可变方法范例
<p class="sycode"> <?phpclass 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()?> </p>
请参阅 call_user_func(),可变变量和 function_exists()。
~
五、内部(内置)函数
PHP 有很多标准的函数和结构。还有一些函数需要和特定地 PHP 扩展模块一起编译,否则在使用它们的时候就会得到一个致命的“未定义函数”错误。例如,要使用image函数比如imagecreatetruecolor(),需要在编译 PHP 的时候加上 GD 的支持。或者,要使用 mysql_connect() 函数,就需要在编译 PHP 的时候加上 MySQL 支持。有很多核心函数已包含在每个版本的 PHP 中如字符串和变量函数。调用 phpinfo() 或者 get_loaded_extensions() 可以得知 PHP 加载了那些扩展库。同时还应该注意,很多扩展库默认就是有效的。PHP 手册按照不同的扩展库组织了它们的文档。请参阅配置,安装以及各自的扩展库章节以获取有关如何设置 PHP 的信息。
手册中如何阅读函数原型讲解了如何阅读和理解一个函数的原型。确认一个函数将返回什么,或者函数是否直接作用于传递的参数是很重要的。例如,str_replace() 函数将返回修改过的字符串,而 usort() 却直接作用于传递的参数变量本身。手册中,每一个函数的页面中都有关于函数参数、行为改变、成功与否的返回值以及使用条件等信息。了解这些重要的(常常是细微的)差别是编写正确的 PHP 代码的关键。
Note: 如果传递给函数的参数类型与实际的类型不一致,例如将一个array传递给一个string类型的变量,那么函数的返回值是不确定的。在这种情况下,通常函数会返回NULL。但这仅仅是一个约定,并不一定如此。
参见 function_exists(),函数参考,get_extension_funcs() 和 dl()。
六、匿名函数Note: 匿名函数只在PHP 5.3.0 及以上版本有效。
匿名函数(Anonymous functions),也叫闭包函数(closures),允许 临时创建一个没有指定名称的函数。最经常用作回调函数(callback)的参数。 当然,也有其他应用的情况。
Example #1 Anonymous function 示例
echo preg_replace_callback('~-([a-z])~', function ($match) {
return strtoupper($match[1]);
}, 'hello-world'); / 出力 helloWorld
?>
例 #2 匿名関数変数の割り当ての例
$greet = function($name)
{
printf("Hello %srn", $name
}; ( 'World');
$greet('PHP');
Closure オブジェクトも親スコープからクラス プロパティを継承します。これらの変数は、関数またはクラスの先頭で宣言する必要があります。親スコープから変数を継承することは、グローバル変数を使用することとは *異なります*。グローバル変数は、現在どの関数が実行されているかに関係なく、グローバル スコープ内に存在します。クロージャの親クラスのスコープは、クロージャを宣言する関数です (必ずしも呼び出される関数ではありません)。例は次のとおりです:
// いくつかの追加製品と各製品の数量を含む、基本的なショッピング カート。
// ショッピングカート内のすべての商品の合計金額を計算するために使用されるメソッドがあります。このメソッドはコールバック関数としてクロージャーを使用します。
クラスカート
{
const PRICE_BUTTER = 1.00;
const PRICE_EGGS = 6.95;
protected $products = array()
{
-> ;products[$product] = $quantity
}
public function getquantity($product) ' s through through through use through through through out through through through through through through - - - - - and gt; ] :
$callback =
関数 ($quantity, $product) use ($tax, &$total)
{ $pricePerItem = constant(__CLASS__ . "::PRICE_" .
strtoupper($product)); -> products, $callback);
returnround($total, 2);;
}
}
$my_cart = new Cart;
// ショッピングカートに商品を追加します
$my_cart->add( 'butter' , 1);
$my_cart->add('milk', 3);
// 5% の消費税を含む合計価格を出力します。
print $my_cart->getTotal(0.05) . "n";
// 結果は 54.29
?>
匿名関数は現在 Closure クラスを通じて実装されています。現時点では不安定であり、正式な開発には適していません。
注: 匿名関数は、PHP 5.3.0 以降でのみ使用できます。
注: func_num_args()、func_get_arg()、func_get_args() などの関数をクロージャ内で呼び出してパラメータ情報を取得できます。
~
~