(PHP 4, PHP 5)
call_user_method — Call a user method on an specific object
This function was DEPRECATED in PHP 4.1.0, and REMOVED in PHP 7.0.0.
Alternatives to this function include:
method_nameThe method name being called.
obj
The object that method_name
is being called on.
parameter ...
The optional parameters.
Example #1 call_user_method() alternative
<?php
call_user_func(array($obj, $method_name), $parameter /* , ... */);
?>
<?php
class abc{
function func($argument) {
$argument="It works";
}
}
$obj=new abc;
$argument_to_be_changed="No it doesn't work";
call_user_method("func", $obj, &$argument_to_be_changed);
echo "Result : ".$argument_to_be_changed;
?>
This code is working. But will through some warning message which you can hide by configuring php.ini
It does not work to use Pointers as Arguments:
<?php
class abc{
function func(&$argument) {
$argument="It works";
}
}
$obj=new abc;
$argument_to_be_changed="No it doesnt";
call_user_method("func", $obj, $argument_to_be_changed);
echo "Result".$argument_to_be_changed;
?>
The result is: "No it doesnt".
Regards
der Jan
This function is very similar to this:
<?php
$method="Print";
$object->$method($param1,$param2);
?>
Note the extra $ after the ->
You can pass a variable number of parameters to a function, use a definition like:
function mymethod ($v1, $v2, $v3="", $v4="")
and then you can pass 2, 3 or 4 parameters. This is explained in the "Functions" section of the manual.
See also the PHP4 functions: func_num_args(), func_get_arg(), and func_get_args(), and examples therein
From what i've observed, call_user_func() does everything this funciton does and a little more. I made a pretty good example call_user_func()'s usage with object instances and figured it might be useful here:
<?php
/**
This is a demonstration of 2 neat features of PHP
* passing array arguments in as a big array, and using += to assign defaults to missing values
This would allow for function calls that more closely mimick thoes made in javascript using JSON, with enough work, it could be almost identical using associative arrays
* function callbacks within a class to global instances of other classes
This allows you pass a function callback to an object early on, and hold off its execution until later in the program (say during page outputing after everything has been setup)
**/
class Runner {
public $id;
public function __construct($id) {
$this->id = $id;
echo "constructing " . __CLASS__ . " with id of $id<br />\n";
}
public function run($distance = null, $measurement = 'km') {
if ($distance) {
echo 'I ran ' . $distance . ' ' . $measurement . '.';
} else {
echo 'I ran.';
}
echo "({$this->id})<br />\n";
}
}
class Speaker {
public $id;
public function __construct($id = 0) {
$this->id = $id;
echo "constructing " . __CLASS__ . " with id of $id<br />\n";
}
public function speak($statement = 'hello world') {
echo $statement . "({$this->id})<br />\n";
}
}
class Test {
protected $runCallback = null;
protected $speakCallback = null;
protected $statement;
protected $distance;
public function __construct(array $params = array()) {
echo "constructing " . __CLASS__ . "<br />\n";
$params += array('speakCallback' => array('Speaker', 'speak'), 'runCallback' => array('Runner', 'run'), 'statement' => 'Hello from ' . __CLASS__ . ' class!', 'distance' => 10);
foreach($params as $k => $v) {
$this->$k = $v;
}
}
public function getInstance() {
return new self(current(func_get_args()));
}
public function callRunner() {
if (is_callable($this->runCallback))
return call_user_func($this->runCallback, $this->distance);
else
throw new Exception("runCallback is not callable\n" . var_export($this->runCallback, true) . "\n");
}
public function callSpeaker() {
if (is_callable($this->speakCallback))
return call_user_func($this->speakCallback, $this->statement);
else
throw new Exception("speakCallback is not callable\n" . var_export($this->speakCallback, true) . "\n");
}
}
$r = new Runner(1);
$s = new Speaker(2);
// Note that we're using $s instead of 'Speaker'
call_user_func(array($s, 'speak'), 'Hello from global!');
// try out from global with call_user_func_array() to pass args as an array
call_user_func_array(array($r, 'run'), array(5, 'mi'));
$Test = new Test(array('runCallback' => array($r, 'run'), 'speakCallback' => array($s, 'speak')));
$Test->callRunner();
$Test->callSpeaker();
$Test = call_user_func(array('Test', 'getInstance'), array('runCallback' => array($r, 'run'), 'distance' => 15));
// should work as expected
$Test->callRunner();
// should throw an error for trying to use this during a static call to Speaker::speak() because of the default
$Test->callSpeaker();
?>
Hope that's helpful.
