Não acho que o manual esteja errado, apenas incompleto. Não tenho familiaridade suficiente com o código-fonte do PHP para poder rastrear o problema até o ponto onde a mensagem de erro é emitida, mas creio ter entendido o que acontece.
O problema não é termos ou não uma referência; como a função é definida com &$array
como parâmetro, o argumento que ela recebe é sempre uma referência para a array passada. Eu acredito que você está enfatizando a parte errada da mensagem de erro:
Only variables can be passed by reference
A chave aqui é only variables, e não passed by reference. Em next([1, 2, 3]);
, você não passa uma variável, passa uma array literal. Não existe nenhuma referência a ela fora do escopo da função next
; assim que ela retornar, a contagem de referências da estrutura que representa a array será 0
, e a memória passa a ser coletável pelo "lixeiro".
Não faz sentido as funções que movem o ponteiro da array quererem alterar o estado de um objeto que deixará de existir assim que elas retornarem. Mover o ponteiro é uma operação dispensável, e elas têm uma guarda contra isso em algum lugar (não sei bem onde, mas se olhar o código-fonte elas diferem em uma ou duas linhas – exemplos: next
e current
). Existem inclusive testes para garantir que esse uso gere um erro (exemplo).
Repare que o erro não ocorre se a array for atribuída a uma variável, e a variável for passada à função:
next($var = [1, 2, 3]);
Nesse caso, $var
existe no escopo onde a função foi chamada, ou seja, continua disponível após a chamada e não pode ser reclamada pelo garbage collector.
Quando você pega o valor atual com current
, isso não modifica o estado;estado da array; nesse caso, o PHP não vê problemas e deixa passar. Dentro das minhas limitações de conhecimento quanto aos detalhes de implementação do PHP, essa é a avaliação que consegui fazer. Talvez eu esteja errado, se alguém tiver evidências disso favor me avisar.