A outra resposta e o comentário me ajudaram a entender o problema:
Talvez exista uma str_replace()
naquele namespace, que não é o nativo da linguagem, e por esse motivo a \ é especificada para fazer a referência correta. - @Havenard
No entanto acredito que seja necessário um exemplo para um melhor entendimento do motivo disto.
O motivo de usarmos eventualmente \
na frente de funções nativas como por exemplo \str_replace(...)
é porque geralmente existe uma função com mesmo nome dentro (não nativa) dentro do namespace, por exemplo:
src/Foo/utils.php
:
<?php
namespace Foo;
function str_replace($a, $b, $str)
{
//Isto chama a função nativa str_replace
return strtolower(\str_replace($a, $b, $str));
}
function foo($a, $b, $c)
{
//Isto chama Foo\str_replace
return str_replace($a, $b, $c);
}
Usando:
<?php
include 'src/Foo/utils.php';
Foo\foo('a', 'b', 'abcabcabc');
Foi necessário adicionar \
nesta linha return strtolower(\str_replace($a, $b, $str));
pois se não tivesse ele iria ficar recursivamente/"infinitamente" chamando Foo\str_replace
, pois estamos dentro de Foo
. Se fizermos
No momento que usamos \str_replace
chamamos a função que está fora do namespace
, que neste caso é uma função nativa.
Mas se fizermos assim:
<?php
namespace Foo;
function str_replace($a, $b, $str)
{
//Isto chama Foo\str_replace novamente
return strtolower(str_replace($a, $b, $str));
}
function foo($a, $b, $c)
{
//Isto chama Foo\str_replace
return str_replace($a, $b, $c);
}
Irá ocorrer o seguinte erro:
Fatal error: Allowed memory size of 134217728 bytes exhausted (tried to allocate 523800 bytes) in Z:\web\projeto\src\Foo\utils.php on line 6
Conclusão
Devemos usar \
para funções nativas quando declarar outra função com mesmo nome dentro do namespace.
<?php
namespace Foo\Bar {
function str_replace($a, $b, $c) {
//...Algo aqui
}
//Aqui usamos Foo\Bar\str_replace, pois é relativo ao namespace
echo str_replace('a', 'b', 'abc');
//Aqui chamamos a função nativa
echo \str_replace('a', 'b', 'abc');
}
Não há necessidade de usar \
se não houver uma função com mesmo nome de uma função nativa
<?php
namespace Foo\Bar {
//Aqui o PHP chama a função nativa pois não existe a função Foo\Bar\str_replace
echo str_replace('a', 'b', 'abc');
}
Funções não nativas declaras fora de namespace devem sempre usar o \
na frente se usadas dentro de um namespace diferente das funções nativas.
Arquivo vendor/Foo/Bar/Baz.php
:
<?php
namespace Foo\Bar {
class Baz {
public function output()
{
echo \test(); //Mostra 'Olá mundo!'
echo test(); //Causa erro
}
}
}
index.php
:
<?php
function test() {
echo 'Olá mundo!';
}
include 'vendor/Foo/Bar/Baz.php';
Foo\Bar\Baz::output();
str_replace()
naquele namespace, que não é o nativo da linguagem, e por esse motivo a \ é especificada para fazer a referência correta.