索引トップ用語の索引ランキング

FTP 関数

導入

この拡張モジュールの関数は、» http://www.faqs.org/rfcs/rfc959 で定義された File Transfer Protocol (FTP) を使用してファイルサーバにアクセスするクライアントの実装です。この拡張を利用することで、FTP サーバにアクセスしてさまざまな操作をするスクリプトを作成することができます。ただ単に FTP サーバ上のファイルを読み書きしたいだけなら、ファイルシステム関数で ftp:// ラッパを用いることを考えてください。こちらのほうがシンプルで直感的なインターフェースを提供します。

要件

外部ライブラリを必要としません。

インストール手順

PHP で FTP 関数を使用するには、PHP 4 をインストールする際には --enable-ftp オプション、 PHP 3 を使用する場合には --with-ftp を追加する必要があります。
Windows 版の PHP にはこの拡張モジュールのサポートが組み込まれています。これらの関数を使用するために拡張モジュールを追加でロードする必要はありません。

実行時設定

設定ディレクティブは定義されていません。

リソース型

この拡張モジュールは、1 種類のリソース型を使用します。これは FTP 接続のリソース ID で、ftp_connect() あるいは ftp_ssl_connect() により返されたものです。

定義済み定数

以下の定数が定義されています。この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、実行時に動的にロードされている場合のみ使用可能です。

FTP_ASCII (integer)
FTP_TEXT (integer)
FTP_BINARY (integer)
FTP_IMAGE (integer)
FTP_TIMEOUT_SEC (integer): 詳細は、ftp_set_option() を参照ください。

以下の定数は、PHP 4.3.0で追加されました。

FTP_AUTOSEEK (integer): 詳細は、ftp_set_option() を参照してください。
FTP_AUTORESUME (integer): GET および PUT リクエスト用のレジューム位置と開始位置を自動的に定義します（FTP_AUTOSEEK が有効な場合のみ動作します）。
FTP_FAILED (integer): 非同期伝送が失敗しました。
FTP_FINISHED (integer): 非同期伝送が終了しました。
FTP_MOREDATA (integer): 非同期伝送がまだアクティブです。

例

例 670. FTP の例


<?php

// 接続を確立する

$conn_id = ftp_connect($ftp_server); 



// ユーザ名とパスワードでログインする

$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass); 



// 接続できたか確認する

if ((!$conn_id) || (!$login_result)) { 

        echo "FTP connection has failed!";

        echo "Attempted to connect to $ftp_server for user $ftp_user_name"; 

        exit; 

    } else {

        echo "Connected to $ftp_server, for user $ftp_user_name";

    }



// ファイルをアップロードする

$upload = ftp_put($conn_id, $destination_file, $source_file, FTP_BINARY); 



// アップロード状況を確認する

if (!$upload) { 

        echo "FTP upload has failed!";

    } else {

        echo "Uploaded $source_file to $ftp_server as $destination_file";

    }



// FTP ストリームを閉じる

ftp_close($conn_id); 

?>