create_function

(PHP 4 >= 4.0.1, PHP 5, PHP 7)

create_function文字列のコードを評価し、動的に関数を作成する

警告

この関数は PHP 7.2.0 で 非推奨 になり、PHP 8.0.0 で 削除 されました。この関数に頼らないことを強く推奨します。

説明

create_function(string $args, string $code): string

指定したパラメータにより動的に関数を作成し、その関数のユニークな名前を返します。

警告

この関数は、内部的に eval() を実行しているので、 eval() と同様にセキュリティ上のリスクがあります。 さらに、パフォーマンスやメモリ使用効率の面でも問題があります。 なぜなら、この関数で作成された関数はグローバルに存在し、 解放できないからです。

この関数ではなく、ネイティブの 無名関数 を使うべきです。

パラメータ

通常、argsには、シングルクオートで括った文字列 を 指定することが推奨されます。 ダブルクオート を使用した場合には、\$somevarのように変数名を 注意深くエスケープする必要があります。

args

関数の引数を、カンマ区切りの文字列で指定します。

code

関数のコード。

戻り値

一意な関数名を表す文字列を返します。 失敗した場合に false を返します。 返される名前には、 印字できない文字("\0") が含まれているので注意して下さい。 よって、この名前を出力したり、 他の文字列に組み込む場合は特別な注意を払うべきです。

例1 create_function() や無名関数を使い、動的に関数を作成する

(たとえば) 実行時に取得した情報をもとにして関数を作成するために、動的に作成した関数が使えます。まず create_function() を使ってみます:

<?php
$newfunc 
create_function('$a,$b''return "ln($a) + ln($b) = " . log($a * $b);');
echo 
$newfunc(2M_E) . "\n";
?>

同じコードは、無名関数 でも実現できます。コードや引数は、文字列に含まれていない点に注意して下さい:

<?php
$newfunc 
= function($a,$b) { return "ln($a) + ln($b) = " log($a $b); };
echo 
$newfunc(2M_E) . "\n";
?>

上の例の出力は以下となります。

ln(2) + ln(2.718281828459) = 1.6931471805599

例2 create_function() や無名関数を使い、一般的な処理を行う関数を作成する

もしくは、パラメータリストに一連の処理を行うことができる 一般的なハンドラ関数を定義できます:

<?php
function process($var1$var2$farr)
{
    foreach (
$farr as $f) {
        echo 
$f($var1$var2) . "\n";
    }
}

// 数学関数群を作成します
$farr = array(
    
create_function('$x,$y''return "some trig: ".(sin($x) + $x*cos($y));'),
    
create_function('$x,$y''return "a hypotenuse: ".sqrt($x*$x + $y*$y);'),
    
create_function('$a,$b''if ($a >=0) {return "b*a^2 = ".$b*sqrt($a);} else {return false;}'),
    
create_function('$a,$b'"return \"min(b^2+a, a^2,b) = \".min(\$a*\$a+\$b,\$b*\$b+\$a);"),
    
create_function('$a,$b''if ($a > 0 && $b != 0) {return "ln(a)/b = ".log($a)/$b; } else { return false; }')
);

echo 
"\nUsing the first array of dynamic functions\n";
echo 
"parameters: 2.3445, M_PI\n";
process(2.3445M_PI$farr);

// 文字列処理関数群を作成します
$garr = array(
    
create_function('$b,$a''if (strncmp($a, $b, 3) == 0) return "** \"$a\" '.
        
'and \"$b\"\n** Look the same to me! (looking at the first 3 chars)";'),
    
create_function('$a,$b''return "CRCs: " . crc32($a) . ", ".crc32($b);'),
    
create_function('$a,$b''return "similar(a,b) = " . similar_text($a, $b, $p) . "($p%)";')
);
echo 
"\nUsing the second array of dynamic functions\n";
process("Twas brilling and the slithy toves""Twas the night"$garr);
?>

ここでも、 同じことが 無名関数 で実現できます。 変数名をエスケープする必要がないことに注意して下さい。 なぜなら、文字列に埋め込まれていないからです。

<?php
function process($var1$var2$farr)
{
    foreach (
$farr as $f) {
        echo 
$f($var1$var2) . "\n";
    }
}

// 数学関数群を作成します
$farr = array(
    function(
$x,$y) { return "some trig: ".(sin($x) + $x*cos($y)); },
    function(
$x,$y) { return "a hypotenuse: ".sqrt($x*$x $y*$y); },
    function(
$a,$b) { if ($a >=0) {return "b*a^2 = ".$b*sqrt($a);} else {return false;} },
    function(
$a,$b) { return "min(b^2+a, a^2,b) = " min($a*$a+$b$b*$b+$a); },
    function(
$a,$b) { if ($a && $b != 0) {return "ln(a)/b = ".log($a)/$b; } else { return false; } }
);

echo 
"\nUsing the first array of dynamic functions\n";
echo 
"parameters: 2.3445, M_PI\n";
process(2.3445M_PI$farr);

// 文字列処理関数群を作成します
$garr = array(
    function(
$b,$a) { if (strncmp($a$b3) == 0) return "** \"$a\" " .
        
"and \"$b\"\n** Look the same to me! (looking at the first 3 chars)"; },
    function(
$a,$b) { return "CRCs: " crc32($a) . ", ".crc32($b); },
    function(
$a,$b) { return "similar(a,b) = " similar_text($a$b$p) . "($p%)"; }
);
echo 
"\nUsing the second array of dynamic functions\n";
process("Twas brilling and the slithy toves""Twas the night"$garr);
?>

上の例の出力は以下となります。

Using the first array of dynamic functions
parameters: 2.3445, M_PI
some trig: -1.6291725057799
a hypotenuse: 3.9199852871011
b*a^2 = 4.8103313314525
min(b^2+a, a^2,b) = 8.6382729035898
ln(a)/b = 0.27122299212594

Using the second array of dynamic functions
** "Twas the night" and "Twas brilling and the slithy toves"
** Look the same to me! (looking at the first 3 chars)
CRCs: 3569586014, 342550513
similar(a,b) = 11(45.833333333333%)

例3 動的な関数をコールバック関数として使う

おそらく、動的な関数のもっとも一般的な用途は、コールバックに渡すことでしょう。 たとえば array_walk() あるいは usort() などで使用します。

<?php
$av 
= array("the ""a ""that ""this ");
array_walk($avcreate_function('&$v,$k''$v = $v . "mango";'));
print_r($av);
?>

無名関数 を使うと、下記のようになります:

<?php
$av 
= array("the ""a ""that ""this ");
array_walk($av, function(&$v,$k) { $v $v "mango"; });
print_r($av);
?>

上の例の出力は以下となります。

Array
(
  [0] => the mango
  [1] => a mango
  [2] => that mango
  [3] => this mango
)

create_function() を使い、文字列を長いものから短いものに並べます:

<?php
$sv 
= array("small""a big string""larger""it is a string thing");
echo 
"Original:\n";
print_r($sv);
echo 
"Sorted:\n";
usort($svcreate_function('$a,$b','return strlen($b) - strlen($a);'));
print_r($sv);
?>

無名関数 を使うと、下記のようになります:

<?php
$sv 
= array("small""a big string""larger""it is a string thing");
echo 
"Original:\n";
print_r($sv);
echo 
"Sorted:\n";
usort($sv, function($a,$b) { return strlen($b) - strlen($a); });
print_r($sv);
?>

上の例の出力は以下となります。

Original:
Array
(
  [0] => small
  [1] => a big string
  [2] => larger
  [3] => it is a string thing
)
Sorted:
Array
(
  [0] => it is a string thing
  [1] => a big string
  [2] => larger
  [3] => small
)

参考

関連キーワード:  関数, 作成, コード, 評価, string, create, function, 出力, 注意, array