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协议远程创建目录的基本函数，掌握它可以帮助开发者更好地管理远程服务器文件结构。通过递归创建函数，可以快速实现多层目录的批量创建，提升效率。