Google

NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.7">

XIICURL, Client URL Library 関数

PHP は、Daniel Stenbergにより開発されたライブラリlibcurl をサポー トします。このライブラリにより、多くの異なったプロトコルで様々なサー バーと接続し、通信することが可能になります。libcurl は現在 http, https, ftp, gopher, telnet, dict, file, ldap プロトコルをサ ポートしてします。libcurl は HTTPS 認証、HTTP POST、HTTP PUT、FTP アップロード(これはPHPのftp拡張機能でも実行可能です)、HTTPフォーム によるアップロード、プロキシ、クッキー、ユーザ名+パスワードによる 認証もサポートします。

CURL関数を使用するためには、CURLパッ ケージをインストールしておく必要があります。PHPは、 CURL 7.0.2-beta 以降を必要とします。7.0.2-beta以前のバージョンでは 動作しません。

PHPのCURLサポート機能を使用するには、--with-curl[=DIR] を付けてPHPをコンパイ ルしておく必要があります。ただし、DIRは、ディレクトリlibおよび includeを有するディレクトリの場所となります。 ディレクトリ"include"には、"curl"という名前のフォルダーがある必要 があり、そのフォルダには、ファイルeash.hおよびcurl.hがある必要があ ります。"libcurl.a"という名前のファイルがディレクトリ"lib"にある必 要があります。

これらの関数はPHP 4.0.2 で追加されました。

PHPをCURLサポート機能付きでコンパイルした場合、curl関数を使用可能 となります。CURL関数の基本的な使用法は、 curl_init()によりCURLセッションを初期化し、 続いてcurl_exec()により転送を実行し、 curl_close()によりセッションを終了するというも のになります。CURL関数を使用してPHPホームページをファイルに取得す る例を示します。

例 1PHPのCURLモジュールを使用してPHPホームページを取得する

<?php

$ch = curl_init ("http://www.php.net/");
$fp = fopen ("php_homepage.txt", "w");

curl_setopt ($ch, CURLOPT_FILE, $fp);
curl_setopt ($ch, CURLOPT_HEADER, 0);

curl_exec ($ch);
curl_close ($ch);
fclose ($fp);
?>

目次
curl_close -- CURLセッションを閉じる
curl_errno -- 直近のエラー番号を意味する整数を返す
curl_error --  カレントのセッションに関して直近のエラー文字列を返す
curl_exec -- CURLセッションを実行する
curl_getinfo --  指定した伝送に関する情報を得る
curl_init -- CURLセッションを初期化
curl_setopt -- CURL転送用オプションを設定する
curl_version -- カレントのCURLのバージョンを返す