函数名称:ftp_mkdir()
函数描述:在远程 FTP 服务器上创建一个新目录。
适用版本:PHP 4, PHP 5, PHP 7
语法:ftp_mkdir(resource $ftp_stream, string $directory)
参数:
- $ftp_stream:FTP 连接句柄,由 ftp_connect() 函数返回。
- $directory:要创建的目录的路径。
返回值:成功时返回新创建的目录名的字符串,失败时返回 false。
示例:
// 建立 FTP 连接
$ftp_server = 'ftp.example.com';
$ftp_user = 'username';
$ftp_pass = 'password';
$ftp_conn = ftp_connect($ftp_server);
ftp_login($ftp_conn, $ftp_user, $ftp_pass);
// 创建新目录
$directory = '/path/to/new_directory';
if (ftp_mkdir($ftp_conn, $directory)) {
echo "成功创建目录:$directory";
} else {
echo "创建目录失败";
}
// 关闭 FTP 连接
ftp_close($ftp_conn);
注意事项:
- 在使用该函数之前,必须先通过 ftp_connect() 和 ftp_login() 函数建立 FTP 连接。
- 创建目录时需要确保 FTP 用户有足够的权限。
- 目录路径可以是相对路径或绝对路径,但绝对路径更可靠。
- 如果目录已存在,该函数将返回 false。
- 如果创建目录时出现错误,可以通过调用 ftp_mkdir() 函数前的 ftp_chdir() 函数来检查错误。
- 为了安全起见,建议在使用完 ftp_mkdir() 函数后,通过调用 ftp_chmod() 函数来设置新目录的权限。
更多信息和示例代码可以在 PHP 官方文档中查看:https://www.php.net/manual/en/function.ftp-mkdir.php