Sintaxe:
string basename (string $ path [, string $ sufixo])
Esta função pode receber dois argumentos. O primeiro argumento é obrigatório e receberá o nome do arquivo ou o nome do arquivo com o caminho como um valor de string. O segundo argumento é opcional e é usado para obter apenas o nome do arquivo sem extensão.
Exemplo 1: ler o nome do arquivo a partir do nome de arquivo existente e não existente
O exemplo a seguir mostra o uso da função basename () sem o argumento opcional.
Crie um arquivo PHP com o seguinte script. Aqui, a função basename () é usada para os arquivos existentes e não existentes. Verificar() função é definida para verificar se o arquivo específico existe ou não. Ambos Olá.TXT e mundo.TXT os arquivos são usados na função basename () para descobrir o nome do arquivo com a extensão.
função Verificar ($ arquivo)if (file_exists ($ file))
echo "$ arquivo existe.
";
senão
echo "$ arquivo não existe.
";
// Defina o nome do arquivo que existe
$ basepath1 = "olá.TXT";
verificar ($ basepath1);
// Uso da função basename () sem parâmetro opcional
echo "
O nome do arquivo com extensão é ".basename ($ basepath1) ."
";// Defina o nome do arquivo que não existe
$ basepath2 = "mundo.TXT";
verificar ($ basepath2);
// Uso da função basename () sem parâmetro opcional
echo "
O nome do arquivo com extensão é ".basename ($ basepath2) ."
";// Uso da função basename () com parâmetro opcional
echo "
O nome do arquivo sem extensão é ".basename ($ basepath1, ".TXT") ."
";?>
Resultado:
A seguinte saída aparecerá após a execução do script acima a partir do servidor. A saída mostra que o Olá.TXT arquivo existe na localização atual, e a função basename () retorna o nome do arquivo. O mundo.TXT arquivo não existe no local atual, mas a função basename () ainda retorna o nome do arquivo para este arquivo. Assim, a função basename () retorna o nome do arquivo de um caminho de arquivo se o arquivo existe ou não.
Exemplo 2: ler o nome do arquivo a partir do caminho do arquivo
No exemplo anterior, apenas o nome do arquivo é passado no primeiro argumento da função basename (). Este exemplo mostra o uso da função basename () para descobrir o nome do arquivo com uma extensão e sem uma extensão do caminho do arquivo. “.php”É usado como o valor do argumento opcional da função basename (). Se o arquivo PHP existe no caminho do arquivo, a função basename () retornará o nome do arquivo sem uma extensão do caminho.
// Defina o caminho do arquivo$ filepath = "var / www / html / php / book.php ";
// Recupera o nome do arquivo com extensão
echo "O nome do arquivo com extensão é";
echo basename ($ filepath)."
";
// Recupera o nome do arquivo sem extensão
echo "O nome do arquivo sem extensão é";
echo basename ($ filepath, ".php ")."
";
?>
Resultado:
A seguinte saída aparecerá após a execução do script acima a partir do servidor. O caminho usado no script, '/ var / www / html / php / book.php', contém um arquivo PHP, e a função basename () retorna livro.php quando usado sem um argumento opcional e retorna livro quando é usado com um argumento opcional.
Exemplo 3: Ler o nome do arquivo do endereço URL com consulta
O exemplo a seguir mostra como a função basename () pode ser usada para recuperar o nome do arquivo de um endereço URL que contém variáveis de consulta.
Crie um arquivo PHP com o seguinte script. O explodir() função é usada aqui para separar o URL e a string de consulta. Esta função retorna um array. O primeiro elemento da matriz contém o URL e o segundo elemento da matriz contém o valor da string de consulta. A função basename () é usada para descobrir o nome do arquivo a partir do primeiro elemento do array.
// Defina o endereço de URL com o parâmetro de consulta$ url = "http: // localhost / php / customer.php?id = 108967 ";
// Recupere o caminho do arquivo do URL
$ filepath = explode ("?", $ url);
// Recupera o nome do arquivo com extensão
echo "O nome do arquivo com extensão é";
echo basename ($ filepath [0])."
";
?>
Resultado:
A seguinte saída aparecerá após a execução do script acima a partir do servidor. Aqui, o nome do arquivo é cliente.php.
Exemplo 4: Leia o diretório e o diretório após omitir o último diretório do caminho
A função basename () também pode ser usada para descobrir o nome do diretório de um caminho. É usado no seguinte exemplo para descobrir o nome do diretório atual e o nome do diretório antes do diretório atual do caminho.
Crie um arquivo PHP com o seguinte script. O $ _SERVER ['PHP_SELF'] é usado na função dirname () para ler o caminho completo do script atual, e a função basename () é usada para ler o nome do diretório que contém este script. Quando um determinado caminho é definido na função dirname (), e '/' é usado no segundo argumento desta função, então o caminho irá ler o caminho do diretório omitindo o último nome do diretório. Neste caso, a função basename () retornará o nome do diretório após omitir o último diretório do caminho.
// Lê o diretório atual$ current_dir = basename (dirname ($ _ SERVER ['PHP_SELF']), "/");
// Imprime o diretório atual
echo "O diretório de trabalho atual é: ".$ current_dir."
";
// Leia o diretório pai do caminho
$ dir = basename (dirname ('/ var / www / html / php'), "/");
// Imprime o nome do diretório pai do caminho
echo "O diretório anterior do caminho fornecido é: ".$ dir."";
?>
Resultado:
A seguinte saída aparecerá após a execução do script acima a partir do servidor.
Exemplo 5: Leia o nome do script atual
A função basename () também pode ser usada para ler o nome do script atual. Quando __ARQUIVO__ é usado no primeiro argumento da função basename (), ele retornará o nome do arquivo do script como saída.
// Leia o nome do script atualecho "O nome do script atual é: ".nome de base (__ FILE__)."";
?>
Resultado:
A seguinte saída aparecerá após a execução do script acima a partir do servidor. A saída mostra o nome do arquivo de script em execução.
Conclusão
A função basename () é uma função útil do PHP quando o codificador trabalha com um arquivo ou diretório para vários fins. Diferentes usos da função basename () são explicados neste tutorial usando exemplos simples para ajudar os leitores a entender seu uso adequado e aplicá-lo em seus scripts PHP.