call_user_func

(PHP 4, PHP 5)

call_user_func — Aufruf der Callback-Funktion die als erster Parameter übergeben wurde

Beschreibung

mixed call_user_func ( callable $callback [, mixed $parameter [, mixed $... ]] )

Ruft die Funktion Callback die als erster Parameter übergeben wurde auf und über gibt dieser alle weiteren Parameter als Argumente.

Parameter-Liste

callback

Das aufzurufende callable.

parameter

Null oder mehr Parameter, die an die Callback-Funktion übergeben werden sollen

Hinweis:

Beachten Sie, dass die Parameter von call_user_func() nicht als Referenzen übergeben werden.

Beispiel #1 call_user_func()-Beispiel und Referenzen

<?php
error_reporting(E_ALL);
function increment(&$var)
{
    $var++;
}

$a = 0;
call_user_func('increment', $a);
echo $a."\n";

// Stattdessen kann dies verwendet werden
call_user_func_array('increment', array(&$a));
echo $a."\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

0
1

Rückgabewerte

Gibt den Rückgabewert des Callbacks zurück oder im Fehlerfall FALSE

Changelog

Version Beschreibung
5.3.0 Die Interpretation von objektorientierten Schlüsselwörtern wie parent oder self hat sich geändert. In früheren Versionen hat ein Aufruf davon mit einem Doppel-Doppelpunkt eine Warnung der Stufe E_STRICT hervorgerufen, weil diese als statisch interpretiert wurden.

Beispiele

Beispiel #2 call_user_func()-Beispiel

<?php
function friseur($type)
{
    echo "Sie möchten einen $type-Kopf, kein Problem\n";
}
call_user_func('friseur', "Bubi");
call_user_func('friseur', "Pilz");
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Sie möchten einen Bubi-Kopf, kein Problem
Sie möchten einen Pilz-Kopf, kein Problem

Beispiel #3 call_user_func() mit Namespacenamen

<?php

namespace Foobar;

class Foo {
    static public function test() {
        print "Hello world!\n";
    }
}

call_user_func(__NAMESPACE__ .'\Foo::test'); // Seit PHP 5.3.0
call_user_func(array(__NAMESPACE__ .'\Foo', 'test')); // Seit PHP 5.3.0

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Hello world!
Hello world!

Beispiel #4 Verwenden einer Klassenmethode mit call_user_func()

<?php

class myclass {
    static function say_hello()
    {
        echo "Hello!\n";
    }
}

$classname = "myclass";

call_user_func(array($classname, 'say_hello'));
call_user_func($classname .'::say_hello'); // Seit 5.2.3

$myobject = new myclass();

call_user_func(array($myobject, 'say_hello'));

?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

Hello!
Hello!
Hello!

Beispiel #5 Verwendung von Lambdafunktionen mit call_user_func()

<?php
call_user_func(function($arg) { print "[$arg]\n"; }, 'test'); /* Seit PHP 5.3.0 */
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

[test]

Anmerkungen

Hinweis:

Callbacks die für Funktionen wie call_user_func() und call_user_func_array() registeriert sind werden nicht mehr ausgeführt, wenn in einem vorherigen Calback eine Exception geworfen und nicht gefangen wurde.

Siehe auch