ftp_chdir

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_chdirMuda o diretório atual em um servidor FTP

Descrição

ftp_chdir(FTP\Connection $ftp, string $directory): bool

Muda o diretório atual para o especificado.

Parâmetros

ftp

Uma instância de FTP\Connection.

directory

O diretório de destino.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha. Se houver falha ao mudar o diretório, o PHP também irá disparar um alerta.

Registro de Alterações

Versão Descrição
8.1.0 O parâmetro ftp agora espera uma instância de FTP\Connection; anteriormente, um resource era esperado.

Exemplos

Exemplo #1 Exemplo de ftp_chdir()

<?php

// estabelece uma conexão básica
$ftp = ftp_connect($ftp_server);

// login com o nome de usuário e senha
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// confere a conexão
if ((!$ftp) || (!$login_result)) {
die(
"A conexão FTP falhou!");
}

echo
"Diretório atual: " . ftp_pwd($ftp) . "\n";

// tenta mudar para algumDiretorio
if (ftp_chdir($ftp, "algumDiretorio")) {
echo
"O diretório atual agora é: " . ftp_pwd($ftp) . "\n";
} else {
echo
"Não foi possível mudar o diretório\n";
}

// fecha a conexão
ftp_close($ftp);
?>

Veja Também

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
6
neil at 11 out of 10
17 years ago
Thanks to h3 at valleyfield dot netSame function with some minor changes and comments addedFTP function checks if a directory exists<?phpfunction ftp_is_dir( $dir ) {    global $ftpcon;    // get current directory    $original_directory = ftp_pwd( $ftpcon );    // test if you can change directory to $dir    // suppress errors in case $dir is not a file or not a directory    if ( @ftp_chdir( $ftpcon, $dir ) ) {        // If it is a directory, then change the directory back to the original directory        ftp_chdir( $ftpcon, $original_directory );        return true;    }     else {        return false;    }        } ?>
up
3
info at swiftyexpress dot com
16 years ago
Works like the other functions in this page's notes, but this one doesn't make use of a global FTP connection, so it takes parameters like the other functions in the extension

<?php
function ftp_directory_exists($ftp, $dir)
{
    // Get the current working directory
    $origin = ftp_pwd($ftp);
    
    // Attempt to change directory, suppress errors
    if (@ftp_chdir($ftp, $dir)) 
    {
        // If the directory exists, set back to origin
        ftp_chdir($ftp, $origin);    
        return true;
    }

    // Directory does not exist
    return false;
}
?>


[NOTE BY danbrown AT php DOT net: As the contributor mentions, the original function was noted here by (h3 AT valleyfield DOT net) on 13-JUL-2007.]
To Top