pear マニュアル

all version of later

PHP   Pear   MySQL  

PEAR_Common::downloadHttp

PEAR_Common::downloadHttp() – ファイルを HTTP 経由でダウンロードする

Synopsis

require_once 'PEAR/common.php';

string PEAR_Common::downloadHttp ( string $url , object &$ui , string $save_dir = '.' , mixed $callback = = null )

Description

ファイルを HTTP 経由でダウンロードします。 推奨するファイル名を Content-disposition: ヘッダで指定し、 さまざまなイベントに対応するコールバック関数を実行できるよう考慮します。 コールバック関数には、コールバックの型およびパラメータの 2 つのパラメータが渡されます。次の型のコールバックが実装されています。

  • 'setup' - いちばん最初にコールされます。 すべての出力に使用する UI オブジェクトをパラメータに指定します。

  • 'message' - 情報メッセージを含む文字列をパラメータに指定します。

  • 'saveas' - 異なるファイル名で保存する際に使用されます。 用いようとしているファイル名をパラメータに指定します。 'saveas' コールバックが空ではない文字列を返した場合、 その結果がファイル名として使用されます。 $save_dir はこれとは関係なく、 あくまでもファイルの名前だけが影響を受けることに注意しましょう。

  • 'start' - ダウンロードが始まります。パラメータにはファイルの総バイト数を指定します。 わからない場合は -1 となります。

  • 'bytesread' - パラメータにはこれまでに読み込んだバイト数を指定します。

  • 'done' - ダウンロードが完了しました。パラメータには読み込んだ総バイト数を指定します。

  • 'connfailed' - TCP 接続に失敗した場合に、このコールバックが

    <?php
    array(host,port,errno,errmsg)
    ?>

    を指定してコールされます。

  • 'writefailed' - ディスクへの書き込みに失敗した場合に、このコールバックが

    <?php
    array(destfile,errmsg)
    ?>

    を指定してコールされます。

HTTP プロキシが設定されている場合は (PEAR_Config の設定項目 http_proxy で)、 プロキシが使用されます。

Parameter

string $url

ダウンロードする URL。

object &$ui

PEAR_Frontend_* のインスタンス。

string $save_dir

ファイルを保存するディレクトリ。

mixed $callback

状態が更新された際にコールする関数/メソッド。

object $config

PEAR_Config のインスタンス。

Return value

string - ダウンロードされたファイルのフルパス、あるいは失敗した場合に PEAR error を返します。 ソケットに関連するエラーの場合、エラーオブジェクトには fsockopen のエラーコードが記録されます。これは getCode() で取得することができます。

Throws

Possible PEAR_Error values
エラーコード エラーの値 意味 対応
  "    

Note

This function can not be called statically.

 
 

Add Comment

※半角英数

Add Comment  (注) 修正するときは、以前入力したKeyを入力してください。(単純なキーの場合、上書きされてしまいます)

 
 

Comment

コメントはまだ登録されていません。一番乗りで関数の利用方法を書いてみませんか?

 
 
 
 
New Entry

php/function.preg-match.html

先頭3桁が070、080、090のいずれかで始まる電話番号にマッチするパターン

Show Detail

php/function.mb-strimwidth.html

文字コードを指定して、全角半角が混在している文字列を短縮。

Show Detail

mysql/index.html

H7EnFK dvyozfiiutul, [url=http://mcfonuzjslbq.com/]mcfonuzjslbq[/url], [link=http://rosbokkudfzh.com/]rosbokkudfzh[/link], http://stjnnhsdhiyo.com/

Show Detail

: JAPANESE/index.html

Замечательно, это весьма ценное сообщение Очень любопытно :) _________________________________________________________________________ http://trustavia.ru/communication/forum/user/4652/ http://omax.ru/communication/forum/user/1089/

Show Detail

index.html

はじめてのコメント

Show Detail