PHPのftp_mkdir()関数とは？使い方とサンプルコードを解説

ftp_mkdir() 関数は、PHPでFTPサーバー上に新しいディレクトリ（フォルダ）を作成するために使用される組み込み関数です。ftp_connect() で確立したFTP接続を使い、指定した場所にディレクトリを追加できます。

構文

ftp_mkdir(con, dir);

パラメータ

• con − FTP接続のリソース。ftp_connect() で取得した接続を指定します。

• dir − 作成するディレクトリの名前（パス）。

戻り値

ftp_mkdir() 関数は、ディレクトリの作成に成功した場合は作成されたディレクトリ名を返し、失敗した場合は FALSE を返します。

使用例

以下は、FTPサーバー上に新しいディレクトリを作成するサンプルコードです。

<?php
   $ftp_server = "192.168.0.4";
   $ftp_user = "amit";
   $ftp_pass = "tywg61gh";

   // FTPサーバーへ接続
   $con = ftp_connect($ftp_server) or die("$ftp_server に接続できませんでした");

   // ユーザー認証（ログイン）
   $login = ftp_login($con, $ftp_user, $ftp_pass);

   $newdir = "newdir";

   if (ftp_mkdir($con, $newdir)) {
      echo "新しいディレクトリを作成しました！";
   } else {
      echo "新しいディレクトリを作成できませんでした！";
   }

   // 接続を閉じる
   ftp_close($con);
?>

このコードの流れは以下の通りです。

1. ftp_connect() でFTPサーバーに接続し、失敗した場合は die() で処理を終了します。

2. ftp_login() でユーザー名とパスワードによる認証を行います。

3. ftp_mkdir() で「newdir」という名前のディレクトリを作成し、結果に応じてメッセージを出力します。

4. 最後に ftp_close() でFTP接続を閉じます。

なお、ディレクトリ作成に失敗する主な原因としては、ログイン権限の不足、同名のディレクトリが既に存在している、書き込み権限がない、などが挙げられます。実運用では戻り値を必ずチェックし、エラー時に適切な処理を行うことをおすすめします。