Ex:Ftp.NLSTコマンド - ダウンロードマクロ・コマンド (Download Macro Command) - PROSERPINE (プロセルピナ)

				プロセルピナ
Top	Internet Mail	Private Proxy	Capture Device		Download	Config and Words	Online Help	Online Home

[BACK]

☞ Top > FileDownload > Macro > Ex: Command > Ftp.NLST

Ex:Ftp.NLSTコマンド

Macro Top | Variables | Constants | Commands | Ex-Commands

書式

Ex:Ftp.NLST: (Parameters)

パラメータ :
server= : string, FTPサーバ(接続先)
user= : string, ログインユーザ名
passw= : string, ログインパスワード

rDir= : string, 確認するサーバ上のディレクトリ(無い場合は作成)
rDir.Base= : string 確認するディレクトリの基部 (optional)
O:rDir.NLST= : ファイル一覧の取得 (NLSTコマンド結果)

enc= : string, エンコード(charset) (optional)
O:result= : コマンド結果 (optional)
O:Xpwd= : FTPのXPWDコマンド実行結果 (optional)
no-pasv : flag-string, passiveモードを使用しないときに指定 (optional)
NLST.CwdMode : flag-string, CWDモードを使用するときに指定 (optional)

機能

FTPのNLSTコマンドでサーバのファイル一覧を取得します。

NLSTのターゲットとなるディレクトリは、 rDir= と、 rDir.Base= のパラメータで指定します。

ファイル一覧は O:rDir.NLST= で指定した文字列変数に、改行区切りで設定されます。
splitコマンドなどで各行に分解して使います。

コマンド実行が正常に実行されたかどうかの結果は、コマンドパラメータ O:result= で指定した文字列変数に設定されます。
正しく処理された場合は OK: の３文字で開始される文字列が設定され、エラーがあった場合は NG: の３文字で開始される文字列が設定されます。

ログインユーザ名(user=)と、ログインパスワード(passw=)の指定は、マクロファイルに直接記述するよりも、 Ex:InputFormコマンドなどの活用をおすすめします。

rDir= と rDir.Base= によるターゲットディレクトリの指定

ターゲットとなるディレクトリは、 rDir= と、 rDir.Base= のパラメータで指定します。

以下、 /user/myHome/img のディレクトリをターゲットとするときの例で説明します。

CWDコマンドでルート("/") にディレクトリを移動できる場合は
rDir="/user/myHome/img"
と指定します。 rDir.Base= の指定は不要です。

ログイン時のディレクトリが /user/myHome で、FTPユーザーはこれ以上は上位のディレクトリに移動できない場合は、
rDir.Base="/user/myHome" rDir="/img"
と分割して指定します。

ログイン時のディレクトリが /user/myHome で、/user のディレクトリには移動できても、それ以上は上位のディレクトリに移動できない場合は、
rDir.Base="/user" rDir="/myHome/img"
と指定します。
/user のディレクトリに移動する必要がない場合は、
rDir.Base="/user/myHome" rDir="/img"
と指定してもかまいません。

ログイン時のディレクトリを rDir.Base= に自動設定する場合は、
rDir.Base="(XPWD)"
を指定します。
ログイン時のディレクトリが /user/myHome で、FTPユーザーはこれ以上は上位のディレクトリに移動できない(または移動しない)場合は、
rDir.Base="(XPWD)" rDir="/img"
と指定することで、 /user/myHome/img をターゲットディレクトリとして扱うことができます。

オプションパラメータ

このコマンドはサーバにログインしたあと、FTPのXPWDコマンドを送信します。このコマンドの応答を取得したいときは O:Xpwd= オプションに文字列変数を指定してください。
設定されるのは OK: または NG: で開始される文字列です。
OK: で開始される場合、その後ろにサーバからの XPWDコマンド応答がそのまま付与されます。

FTPコマンドは "NLST /user/myHome/img" のようなイメージでサーバに送信されます。これを、CWDコマンドで /user/myHome/img ディレクトリに移動し、そこでNLSTコマンドを送信するようにするには、 NLST.CwdModeオプションを指定します (CWDモード)。
FTPサーバによっては、 NLST.CwdModeオプションを指定しないと正しくリストを取得できない場合があります。
CWDモードを指定した場合でも、 O:rDir.NLST= に設定されるイメージは変わりません。各ファイルはフルパスで設定されます。

Sample

ログイン時のディレクトリが /myHome の例

:Sample{
 str["server"]="ftp.example.geocities.jp"
 str["user"]="ftp_user"
 str["passw"]="user_password"
 str["rDir"]="/html"
 
 Ex:Ftp.NLST: server=str["server"] user=str["user"] passw=str["passw"] enc="UTF-8" O:result=strl[10] O:reply=strl["reply"] O:Xpwd=strl["xpwd"] rDir.Base="(XPWD)" rDir=str["rDir"] O:rDir.NLST=strl["NLST"]
 
 put: "XPWD: " strl["xpwd"]
 put: ""
 put: "NLST: \r\n" strl["NLST"]
 
end:
}

結果の例

XPWD: OK:"/myHome" is current directory.

NLST: 
/myHome/html/accLog.html
/myHome/html/accLog_bannedLog.html
/myHome/html/accLogHttp.html
/myHome/html/ais.html
/myHome/html/antiAd.html
/myHome/html/antiAd_3sec.html
/myHome/html/antiAd_check.html
/myHome/html/antiAd_customizeSample.html

Ftp.Uploadコマンドについて

Ex:Ftp.Uploadコマンドはファイルをアップロードをするときに使うコマンドですが、ファイルのアップロードを行わずにNLSTオプションのみを使用して、ファイル一覧取得目的で使うこともできます。

Ex:Ftp.NLSTコマンドは Ex:Ftp.Uploadコマンドと全く同じものです。
わかりやすいように、ファイルの一覧取得だけが目的の場合は Ex:Ftp.NLSTコマンドで記述します。
次の２行は、どちらも同じ機能です。

Ex:Ftp.Upload: server=str["server"] user=str["user"] passw=str["passw"] enc="UTF-8" O:result=strl[10] O:reply=strl["reply"] rDir.Base="(XPWD)" rDir=str["rDir"] O:rDir.NLST=strl["NLST"]
   
Ex:Ftp.NLST: server=str["server"] user=str["user"] passw=str["passw"] enc="UTF-8" O:result=strl[10] O:reply=strl["reply"] rDir.Base="(XPWD)" rDir=str["rDir"] O:rDir.NLST=strl["NLST"]

[BACK]

プロセルピナ

書式

機能

rDir= と rDir.Base= による ターゲットディレクトリの指定

オプションパラメータ

Sample

Ftp.Uploadコマンドについて

rDir= と rDir.Base= によるターゲットディレクトリの指定