De acordo com o manual do php.
Simplificando: Um se trata e um retorno de um valor, outro é para criação de um Generator.
YIELD
Uma declaração yield se parece muito com um retorno, exceto que em vez de parar a execução da função e retornar, o yield fornece um valor para o código de loop sobre o generator e pausa a execução da função do generator.
Não vou falar aqui sobre Generators, pois essa pergunta o explcia muito bem:
Quais as vantagens de usar um Generator (yield) no PHP?
Mas trocando em miúdos, o Generator é nada mais nada menor que uma forma simplificada de aplicar um Iterator sobre determinada operação.
Então, quando você usa yield
você está indicando que o valor passado para ele será parte de uma etapa da iteração que se deseja. Ocorrerá uma "pausa" na iteração e aqueles valores serão retornados em um objeto da classe Generator
.
O Generator por sua vez implementa uma interface chamada Iterator
no PHP. Seria bom entender seu uso, pois nesse caso, não seria importante aprender somente a sintaxe do Generator antes de aprender o que é iterator.
Se sabe o que é um Iterator
então podemos dizer: Quando você chama um objeto Generator
com foreach
, você está invocando os métodos na seguinte sequência:
foreach (gen() as $key => $value) {
}
Equivale a:
$gen = gen();
$gen->rewind();
while ($gen->valid()) {
$key = $gen->key();
$value = $gen->current();
$gen->next();
}
RETURN
O return
, que traduzindo é "retorno", serve para retornar um valor para uma função. São dois casos diferentes, já que no primeiro caso, o Generator
é apenas uma "pausa" para o loop que foi proposto lá dentro. Já return
representa o valor definitivo retornado para aquela chamada da função.
Posso usar os dois juntos?
Depende da versão do PHP que você está usando. Se estiver utilizando versões anteriores ao PHP 7, você receberá uma exceção ao tentar colocar return
e yield
na mesma função.
No PHP 7, você pode fazer isso. Nesse caso, terá que usar o método Generator::getReturn
.
function gen()
{
yield 1 => 2;
yield 3 => 4;
return 5;
}
gen()->getReturn(); // 5
Outras diferenças
O return
pode ser usado fora de uma função, já o yield
não pode.
A melhor forma te obter um generator
através do yield
, tendo o objeto Generator diretamente numa variável, é apenas com a self invoking function. Porém ela só está disponível para PHP 7.
Exemplo:
$gen = (function ()
{
yield "A" => "B";
})();
var_dump($gen); // Generator(object);
O yield
pode ser processado de acordo com o número de declarações, já o return
não. Você só pode até ter mais de um return
na função, porém quando o primeiro for executado, o restante será ignorado. Já o yield
não é assim.
function hello()
{
yield "Stack Overlow";
yield "Mandioca";
yield "Milho";
}
$gen = hello();
var_dump($gen->current());
$gen->next();
var_dump($gen->current());
A saída será:
string(13) "Stack Overlow"
string(8) "Mandioca"