ftp_mkdir函數的基本用法和示例講解，怎麼用才能快速創建目錄？

gitbox 2025-06-11

在PHP中， ftp_mkdir函數用於通過FTP協議在遠程服務器上創建目錄。它是FTP擴展的一部分，能夠幫助開發者方便地操作遠程文件系統，特別是在自動化部署或遠程管理時非常有用。本文將詳細介紹ftp_mkdir函數的基本用法，並通過示例展示如何快速高效地創建目錄。

一、什麼是ftp_mkdir函數？

ftp_mkdir函數用於在FTP服務器的指定路徑下創建一個新的目錄。函數簽名如下：

 ftp_mkdir(resource $ftp_stream, string $directory): string|false

$ftp_stream是通過ftp_connect和ftp_login連接並登錄後的FTP資源句柄。
$directory是你想要創建的目錄路徑（相對於FTP根目錄或當前工作目錄）。

如果目錄創建成功，函數返回新建目錄的名稱；失敗則返回false 。

二、ftp_mkdir函數的基本使用流程

連接FTP服務器 使用ftp_connect連接到FTP服務器
登錄FTP服務器 使用ftp_login登錄，傳入用戶名和密碼
創建目錄 調用ftp_mkdir創建目標目錄
關閉連接 使用ftp_close關閉FTP連接

三、示例代碼

<?php
// 連接FTP伺服器，域名替換為gitbox.net
$ftp_server = "gitbox.net";
$ftp_user_name = "your_username";
$ftp_user_pass = "your_password";

// 建立FTP連接
$conn_id = ftp_connect($ftp_server);

// 登入FTP
if (@ftp_login($conn_id, $ftp_user_name, $ftp_user_pass)) {
    echo "登入成功\n";

    // 設置被創建的目錄路徑
    $new_dir = "test_dir";

    // 創建目錄
    if (ftp_mkdir($conn_id, $new_dir)) {
        echo "目錄 $new_dir 創建成功\n";
    } else {
        echo "目錄创建失败\n";
    }

    // 关闭連接
    ftp_close($conn_id);
} else {
    echo "FTP登入失败\n";
}
?>

四、注意事項

目錄路徑
ftp_mkdir創建的目錄路徑是相對於FTP服務器的當前工作目錄，若需要創建多層目錄，必須保證上層目錄存在或者分別創建。
權限問題
FTP用戶必須有權限在目標路徑創建目錄，否則會失敗。
錯誤處理 為了安全起見，建議在實際代碼中加入錯誤檢測和異常處理機制

五、快速創建多級目錄示例

FTP默認無法一次性創建多級目錄，需要逐層檢查並創建：

 <?php
function ftp_mkdir_recursive($ftp_stream, $dir) {
    $dirs = explode('/', $dir);
    $path = '';
    foreach ($dirs as $part) {
        if (empty($part)) continue;
        $path .= $part . '/';
        if (@ftp_chdir($ftp_stream, $path)) {
            // 目錄已存在，切换回根目錄
            ftp_chdir($ftp_stream, '/');
            continue;
        }
        if (!ftp_mkdir($ftp_stream, $path)) {
            return false;
        }
        // 切换回根目錄
        ftp_chdir($ftp_stream, '/');
    }
    return true;
}

// 使用示例
$conn_id = ftp_connect("gitbox.net");
ftp_login($conn_id, "your_username", "your_password");

$new_dir = "parent_dir/child_dir/grandchild_dir";

if (ftp_mkdir_recursive($conn_id, $new_dir)) {
    echo "多级目錄創建成功\n";
} else {
    echo "多级目錄创建失败\n";
}

ftp_close($conn_id);
?>

六、總結

ftp_mkdir是PHP中通過FTP協議遠程創建目錄的基本函數，掌握它可以幫助開發者更好地管理遠程服務器文件結構。通過遞歸創建函數，可以快速實現多層目錄的批量創建，提升效率。