Método __call

O método __call é um método mágico em PHP que é chamado automaticamente ao tentar acessar um método inexistente ou inacessível de uma classe. Ele recebe como primeiro parâmetro o nome do método chamado e como segundo, um array de argumentos.

Sintaxe

public function __call(string $name, array $arguments) {
	// implementação
}

Exemplo

Vamos criar uma classe com o método __call que irá interceptar todas as chamadas para métodos inexistentes:

<?php
	class Test {
		public function __call($name, $args) {
			echo "Método chamado: " . $name . "\n";
			echo "Argumentos: ";
			print_r($args);
		}
	}
	
	$test = new Test();
	$test->nonExistentMethod('a', 'b', 123);
?>

Resultado da execução do código:

Método chamado: nonExistentMethod
Argumentos: ['a', 'b', 123]

Exemplo

Vamos implementar um delegador simples de métodos usando __call:

<?php
	class Calculator {
		public function add($a, $b) {
			return $a + $b;
		}
	}
	
	class Math {
		private $calculator;
		
		public function __construct() {
			$this->calculator = new Calculator();
		}
		
		public function __call($name, $args) {
			if (method_exists($this->calculator, $name)) {
				return call_user_func_array(
					[$this->calculator, $name],
					$args
				);
			}
			throw new Exception("Método $name não encontrado");
		}
	}
	
	$math = new Math();
	echo $math->add(2, 3);
?>

Resultado da execução do código:

5

Veja também

o método __callStatic,
que intercepta chamadas de métodos estáticos
o método __get,
que intercepta acesso a propriedades inexistentes