curlopt_returntransfer 徹底解説！PHP cURLでのレスポンス取得
PHPで外部のWebサービスと連携したり、APIからデータを取得したり、あるいは単にWebサイトの内容をプログラムから確認したりする場合、多くの開発者が頼りにするのがcURLライブラリです。cURLは、様々なプロトコル（HTTP, HTTPS, FTPなど）を使用してデータを送受信するための強力なツールであり、PHPはそのcURLの機能を利用するための豊富な関数を提供しています。
PHPでcURLを使う際、最も基本的かつ重要なオプションの一つが CURLOPT_RETURNTRANSFER です。このオプションは、cURLリクエストの実行結果（通常はリモートサーバーからの応答、つまりレスポンス）をどのように扱うかを決定します。
この記事では、CURLOPT_RETURNTRANSFER オプションに焦点を当て、それが何をするのか、なぜ重要なのか、そしてどのように使うのかを、基本的な例から応用的なシナリオ、さらには関連するオプションや注意点まで含めて徹底的に解説します。約5000語のボリュームで、このオプションの全てを網羅することを目指します。
1. はじめに：PHPにおけるcURLの役割
PHPはサーバーサイドスクリプト言語として、Webサーバー上で動作し、動的なWebページを生成したり、様々な処理を実行したりします。Webアプリケーション開発において、自らのサーバーだけでなく、インターネット上の他のサーバーと連携することは非常に一般的です。例えば：
- 外部のRESTful APIを呼び出してデータを取得・送信する。
- OAuthなどの認証プロトコルを使ってユーザー認証を行う。
- 決済サービスと連携してトランザクションを処理する。
- ソーシャルメディアAPIを使って情報を投稿・取得する。
- RSSフィードやAtomフィードを読み込む。
- 単に他のWebページのHTML内容を取得する（Webスクレイピング）。
これらのタスクを実行するために、PHPは外部のURLに対してHTTPリクエストを発行し、その応答（レスポンス）を受け取る必要があります。PHPの標準ライブラリには file_get_contents() や stream_context_create() といった関数もありますが、HTTPリクエストに関する詳細な制御（カスタムヘッダー、POSTデータの送信、クッキー管理、プロキシ設定、タイムアウト設定、SSL検証など）が必要な場合、cURLが最も柔軟で強力な選択肢となります。
cURLは、多数のプロトコルをサポートし、非常にきめ細やかな設定が可能です。PHPのcURL拡張機能は、これらのcURLの機能をPHPスクリプトから簡単に利用できるようにするものです。基本的なcURLの使い方は以下の流れになります。
curl_init(): cURLセッションを初期化し、ハンドルを取得する。curl_setopt()またはcurl_setopt_array(): cURLセッションのオプションを設定する。これがこの記事の主題であるCURLOPT_RETURNTRANSFERを含め、様々な振る舞いを制御する部分です。curl_exec(): 設定されたオプションに従ってcURLセッションを実行し、リモートサーバーと通信する。curl_getinfo(): リクエストに関する情報（HTTPステータスコード、転送時間など）を取得する（オプション）。curl_close(): cURLセッションを終了し、リソースを解放する。
この一連の流れの中で、curl_exec() 関数が実行結果をどのように返すか、あるいはどのように出力するかが、CURLOPT_RETURNTRANSFER オプションによって制御されるのです。
2. CURLOPT_RETURNTRANSFER とは？ 基本概念の理解
CURLOPT_RETURNTRANSFER は、curl_setopt() 関数で使用されるcURLオプションの一つです。その名前が示唆するように、「戻り値として転送データ（レスポンス）を返すかどうか」を制御します。
このオプションは boolean (真偽値) を値として取ります。
false(または 0): デフォルト値。curl_exec()の実行結果として、リモートサーバーからのレスポンスデータを標準出力に直接出力します。この場合、curl_exec()関数の戻り値は、通常、リクエストが成功したかどうかを示す boolean 値（成功時にtrue、失敗時にfalse）になります。true(または 1):curl_exec()の実行結果として、リモートサーバーからのレスポンスデータを文字列として返します。この場合、curl_exec()関数の戻り値は、レスポンスデータそのもの（文字列）になります。リクエストが失敗した場合はfalseを返します。
つまり、CURLOPT_RETURNTRANSFER を true に設定すると、curl_exec() がechoやprintのように画面に直接レスポンスを表示するのではなく、そのレスポンスをプログラム内の変数に格納できるようになる、ということです。
3. CURLOPT_RETURNTRANSFER を使わない場合（デフォルト動作）
まず、CURLOPT_RETURNTRANSFER を明示的に設定しない場合、あるいは false に設定した場合のcURLの動作を見てみましょう。これは、curl_exec() 関数がレスポンスを標準出力に直接出力するモードです。
コード例 (デフォルト動作):
“`php
“`
実行結果とその説明:
上記のコードを実行すると、以下のような出力が得られるはずです（具体的なHTMLコンテンツは httpbin.org のレスポンスによって多少異なる場合があります）。
“`
— cURLリクエスト実行 (デフォルト動作) —
Moby Dick
Chapter 1
Loomings.
Call me Ishmael. Some years ago—never mind how long precisely—having
little or no money in my purse, and nothing particular to interest me on
shore, I thought I would sail about a little and see the watery part of
the world. It is a way I have of driving off the spleen and regulating
the circulation. Whenever I find myself growing grim about the mouth;
whenever it is a damp, drizzly November in my soul; whenever I find
myself involuntarily pausing before coffin warehouses, and bringing up
the rear of every funeral I meet; and especially whenever my hypos get
such an upper hand of me, that it requires a strong moral principle to
prevent me from deliberately stepping into the street, and methodically
knocking people’s hats off—then, I account it high time to get to sea as
soon as I can. This is my substitute for pistol and ball. With a
philosophical flourish Cato throws himself upon his sword; I quietly
take to the ship. There is nothing surprising in this. If they but knew
how dreary it is to wear a thoughtful soul in a thoughtful soul, and how
remorseless it is to persist in driving himself through all the
quadrangles of the world, and bruising himself against every stave, then
they would pause, and if there are no other arguments, they would pause
in soul.
— curl_exec() の戻り値を確認 —
curl_exec() は成功しました (true を返しました)。
— スクリプト終了 —
“`
この出力からわかるように、curl_exec() の実行中にリモートサーバーから受け取ったHTMLコンテンツが、echo ステートメントで出力したメッセージの間に直接表示されています。これは、CURLOPT_RETURNTRANSFER が false (デフォルト) のため、cURLライブラリがレスポンスデータをPHPの標準出力ストリーム（通常はWebサーバーの出力バッファやCLIのコンソール）に直接書き出した結果です。
そして、curl_exec() の戻り値 $result は、レスポンスデータそのものではなく、操作が成功したかどうかの真偽値 (true) になっています。
この動作の利点:
- シンプルさ: レスポンスデータを変数に格納する必要がなく、単純に内容を表示したい場合にコードが短くなります。
- メモリ効率: 特に非常に大きなレスポンスデータの場合、それを全てメモリ上の文字列変数として保持する必要がないため、メモリ消費を抑えられます。
- デバッグ: cURLリクエストが正しく実行され、リモートサーバーからの応答が来ているかを手軽に確認できます。
この動作の欠点:
- レスポンスデータの加工・解析が困難: レスポンスが直接出力されてしまうため、PHPスクリプト内でその内容を変数として取得し、JSONとしてデコードしたり、特定の情報を抽出したりといった後続の処理を行うことができません。
- 出力の制御が難しい: PHPスクリプトが出力する他の内容（HTML、デバッグメッセージなど）とcURLのレスポンス出力が混ざってしまいます。特定の場所にレスポンスを表示させたり、Webページの一部として埋め込んだりするのが難しくなります。
- プログラム的な処理に不向き: APIからの応答を元に次の処理を分岐させる、取得したデータをデータベースに保存する、別の形式に変換して返す、といった、レスポンスの内容に依存するロジックを記述できません。
これらの欠点、特に「レスポンスデータの内容をプログラム内で利用できない」という点が、多くのPHP開発において問題となります。API連携やデータ処理を行うためには、レスポンスを変数として取得できる必要があります。ここで CURLOPT_RETURNTRANSFER が true に設定されることの重要性が浮き彫りになります。
4. CURLOPT_RETURNTRANSFER を使う場合
CURLOPT_RETURNTRANSFER を true に設定すると、curl_exec() はレスポンスデータを標準出力に直接出力する代わりに、そのレスポンスデータを関数の戻り値として文字列で返します。これにより、取得したレスポンスを変数に格納し、PHPスクリプト内で自由に加工、解析、利用することが可能になります。
コード例 (CURLOPT_RETURNTRANSFER を true に設定):
“`php
“`
実行結果とその説明:
上記のコードを実行すると、以下のような出力が得られます。
--- cURLリクエスト実行 (RETURNTRANSFER = true) ---
--- curl_exec() の戻り値を確認 ---
$response の型: string
cURLリクエストは成功しました。
取得したレスポンスデータ (最初の200文字):
{
"slideshow": {
"author": "Yours Truly",
"date": "date of publication",
"slides": [
{
"title": "Wake up to Wonderwhee
...
--- JSONデータをデコードしました ---
Decoded title: Wake up to WonderWidgets!
Number of slides: 2
--- スクリプト終了 ---
この出力からわかるように、curl_exec() の実行中にレスポンスデータが直接出力されることはなく、スクリプトが順番に進んでいます。curl_exec() の戻り値は $response 変数に格納され、その型は string となっています。これは、リモートサーバーから取得したJSONデータが文字列として $response に代入されたことを意味します。
そして、その $response 変数の内容（JSON文字列）を json_decode() 関数に渡してデコードし、PHPの連想配列としてデータにアクセスできています。このように、CURLOPT_RETURNTRANSFER を true に設定することで、PHPスクリプト内でレスポンスデータを自由に加工、解析、利用する道が開かれます。
CURLOPT_RETURNTRANSFER = true を使うべき理由:
- データの加工・解析: 取得したレスポンスがJSON、XML、HTML、CSVなど、何らかの形式のデータである場合、それをPHPのデータ構造（配列、オブジェクト）に変換したり、必要な部分を抽出したりするために、レスポンス内容を文字列として取得する必要があります。
- 条件分岐やロジック: レスポンスのステータスコード、ヘッダー、またはボディの内容に基づいて、プログラムの処理を分岐させたい場合に、レスポンス内容を変数として参照する必要があります。
- 出力の制御: Webページの一部として外部コンテンツを埋め込みたい、あるいは取得したデータを加工してからユーザーに表示したい場合など、レスポンスを直接出力するのではなく、プログラムの制御下で出力したい場合に必須です。
- デバッグ情報の取得:
CURLOPT_HEADERオプションと組み合わせて使用する場合、レスポンスヘッダーもボディと一緒に取得した文字列に含まれます。これを分離してヘッダーやボディだけを確認したい場合に便利です。 - 複数リクエストの並行処理: 後述する
curl_multi関数群を使用して複数のcURLリクエストを並行して実行する場合、各リクエストの結果はバッファリングされ、後からまとめて取得する必要があります。この際、各リクエストに対してCURLOPT_RETURNTRANSFERをtrueに設定することで、それぞれのレスポンスを文字列として取得できるようになります。
デフォルトの false の挙動は、例えばWebサイトのミラーリングなど、取得した内容をそのままファイルに書き出すといった特定のシナリオでは有用ですが、現代のWebアプリケーション開発で主流となっているAPI連携などでは、レスポンスデータをプログラムで処理することが不可欠であるため、多くの場合 CURLOPT_RETURNTRANSFER は true に設定されます。
5. CURLOPT_RETURNTRANSFER と関連するオプション
CURLOPT_RETURNTRANSFER は、他のcURLオプションと組み合わせて使用することで、より柔軟なレスポンス処理が可能になります。特に関連が深いオプションをいくつか見てみましょう。
5.1. CURLOPT_HEADER
- 設定値: boolean (
trueまたはfalse) - デフォルト:
false
CURLOPT_HEADER を true に設定すると、レスポンスのボディだけでなく、ヘッダー情報（HTTPステータス行や各種ヘッダーフィールド）も取得します。
CURLOPT_RETURNTRANSFER が true の場合、CURLOPT_HEADER を true に設定すると、curl_exec() が返す文字列は「ヘッダー情報」と「ボディ情報」が連結されたものになります。ヘッダーとボディは通常、空行 (\r\n\r\n) で区切られます。
“`php
“`
この例のように、CURLOPT_RETURNTRANSFER と CURLOPT_HEADER を共に true に設定した場合、取得した文字列からヘッダーとボディを分離するためには、curl_getinfo() で取得できる CURLINFO_HEADER_SIZE を利用するのが一般的な方法です。ヘッダーサイズ分を substr() で切り出せばヘッダー、残りがボディとなります。
5.2. CURLOPT_NOBODY
- 設定値: boolean (
trueまたはfalse) - デフォルト:
false
CURLOPT_NOBODY を true に設定すると、HTTPリクエストメソッドが HEAD に変更され（または設定されたメソッドに関わらずボディの取得がスキップされ）、レスポンスのボディ部分を取得しなくなります。ヘッダー情報のみが必要な場合（例: ファイルサイズや最終更新日の確認、URLの存在確認など）に使用します。
CURLOPT_NOBODY が true の場合、CURLOPT_RETURNTRANSFER の設定に関わらず、curl_exec() はボディのデータを含む文字列を返すことはありません。CURLOPT_RETURNTRANSFER が true の場合、curl_exec() はヘッダー情報のみを含む文字列を返すか、あるいはボディがないことを示す値を返すことになります（cURLのバージョンや設定による挙動の違いがある可能性もあるため、ヘッダーのみ取得する場合は CURLOPT_HEADER と CURLOPT_NOBODY を組み合わせるのが確実です）。
“`php
= 0 ? $content_length . ” bytes” : “N/A”) . “\n”;
}
curl_close($ch);
?>
“`
この組み合わせでは、curl_exec() はヘッダー情報のみを含む文字列を返します。CURLINFO_HEADER_SIZE を使った分離は、この場合も有効です（ボディがないため、ヘッダーサイズが取得した文字列全体のサイズになります）。
5.3. CURLOPT_FILE
- 設定値: ファイルポインター（
fopen()などで開いたリソース） - デフォルト:
null(標準出力)
CURLOPT_FILE オプションは、リモートサーバーから取得したレスポンスデータをファイルに直接書き込むためのオプションです。fopen() などで開いたファイルリソースを値として設定します。
このオプションを設定した場合、CURLOPT_RETURNTRANSFER は無視されます。レスポンスデータは指定されたファイルポインターに書き込まれ、curl_exec() の戻り値は通常通り成功/失敗を示す boolean 値となります。
CURLOPT_FILE と CURLOPT_RETURNTRANSFER の使い分け:
CURLOPT_RETURNTRANSFER = true: レスポンスデータを変数に格納してプログラム内で処理したい場合。API応答の解析、Webスクレイピング、データ変換など。CURLOPT_FILE = <file_pointer>: レスポンスデータをそのままファイルとして保存したい場合。大きなファイルのダウンロードなど、メモリ上に全てのデータを保持するのが難しい場合に適しています。
メモリ効率の観点からは、大きなバイナリファイル（画像、動画、大きなアーカイブファイルなど）をダウンロードする場合は CURLOPT_FILE を使うべきです。APIからのJSON応答など、比較的小さなテキストデータを取得して処理する場合は CURLOPT_RETURNTRANSFER = true が適しています。
5.4. CURLOPT_VERBOSE
- 設定値: boolean (
trueまたはfalse) - デフォルト:
false
CURLOPT_VERBOSE を true に設定すると、cURLの通信過程に関する詳細な情報（リクエストヘッダー、レスポンスヘッダー、接続情報など）が標準エラー出力に表示されます。デバッグ時に非常に役立つオプションです。
CURLOPT_VERBOSE は CURLOPT_RETURNTRANSFER の設定とは独立して動作します。CURLOPT_RETURNTRANSFER が true の場合でも、冗長なデバッグ情報は標準エラー出力に表示され、curl_exec() の戻り値には含まれません。
“`php
“`
このコードを実行すると、標準出力にはボディのJSONデータが表示され、標準エラー出力（CLI実行ならコンソール、Webサーバーならエラーログなど）にはcURLの通信ログが出力されます。
6. レスポンスデータの処理
CURLOPT_RETURNTRANSFER = true を使ってレスポンスデータを文字列として取得した場合、その後の処理がPHPスクリプトの重要な部分となります。取得したデータがどのような形式であるかによって、適切な処理方法を選択する必要があります。
6.1. 取得した文字列からのヘッダーとボディの分離
前述の通り、CURLOPT_RETURNTRANSFER = true と CURLOPT_HEADER = true を組み合わせた場合、curl_exec() はヘッダーとボディを連結した文字列を返します。これを分離するには curl_getinfo() と CURLINFO_HEADER_SIZE を使います。
“`php
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HEADER, true); // ヘッダーも取得
$response = curl_exec($ch);
if ($response !== false) {
$header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$header = substr($response, 0, $header_size); // ヘッダー部分
$body = substr($response, $header_size); // ボディ部分
// ヘッダーを処理（例: 各ヘッダー行を配列にする）
$header_lines = explode("\r\n", trim($header));
// 最初の行はステータス行
$status_line = array_shift($header_lines);
echo "Status Line: " . $status_line . "\n";
// 残りはヘッダーフィールド
$headers_assoc = [];
foreach ($header_lines as $line) {
if (strpos($line, ':') !== false) {
list($key, $value) = explode(':', $line, 2);
$headers_assoc[trim($key)] = trim($value);
}
}
print_r($headers_assoc);
// ボディを処理（JSON, XMLなどに応じて）
// 例: JSONの場合
$data = json_decode($body, true);
if ($data !== null) {
print_r($data);
}
}
curl_close($ch);
“`
6.2. HTTPステータスコードの取得
レスポンスが成功したかどうか、またはどのような種類のエラーが発生したかを知るには、HTTPステータスコードを確認することが重要です。これは curl_getinfo() と CURLINFO_HTTP_CODE を使って取得できます。CURLOPT_RETURNTRANSFER の設定に関わらず取得可能です。
“`php
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // あるいは false
$response = curl_exec($ch);
// レスポンスが文字列として取得できたかどうかで最初のチェック
if ($response === false) {
// cURL実行自体が失敗した場合（接続エラーなど）
echo “cURL実行エラー: ” . curl_error($ch) . “\n”;
} else {
// HTTPステータスコードを取得
$http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
echo "HTTPステータスコード: " . $http_status . "\n";
if ($http_status >= 200 && $http_status < 300) {
echo "リクエストは成功しました。\n";
// $response（CURLOPT_RETURNTRANSFER=trueの場合）を処理
} elseif ($http_status >= 400 && $http_status < 500) {
echo "クライアントエラーが発生しました (例: 404 Not Found, 401 Unauthorized)。\n";
// エラーレスポンスの内容を確認
} elseif ($http_status >= 500 && $http_status < 600) {
echo "サーバーエラーが発生しました。\n";
// エラーレスポンスの内容を確認
} else {
echo "その他のステータスコード: " . $http_status . "\n";
}
// CURLOPT_RETURNTRANSFER = true の場合は $response を処理
if (curl_getinfo($ch, CURLINFO_RETURNTRANSFER)) {
// ここで取得したレスポンスボディ $response を利用
// ...
}
}
curl_close($ch);
“`
HTTPステータスコードは、API連携において特に重要です。2xxは成功、3xxはリダイレクト、4xxはクライアントエラー、5xxはサーバーエラーを示し、これによって後続の処理を適切に分岐させる必要があります。
6.3. JSONデータのデコード
APIからJSON形式の応答を受け取ることは非常に多いです。CURLOPT_RETURNTRANSFER = true で取得したJSON文字列は、json_decode() 関数を使ってPHPの配列やオブジェクトに変換できます。
“`php
$ch = curl_init($json_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response !== false) {
$http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($http_status >= 200 && $http_status < 300) {
$data = json_decode($response, true); // true で連想配列に
if ($data === null && json_last_error() !== JSON_ERROR_NONE) {
// JSONデコードエラー
echo "JSONデコードエラー: " . json_last_error_msg() . "\n";
} else {
// デコード成功、データを利用
// echo $data['some_key'];
print_r($data);
}
} else {
echo "HTTPエラー: " . $http_status . "\n";
// エラー時のレスポンスボディを確認する場合
echo "エラーレスポンスボディ: " . $response . "\n";
}
} else {
echo “cURL実行エラー: ” . curl_error($ch) . “\n”;
}
curl_close($ch);
“`
JSONデータの処理では、json_decode() の戻り値が null であった場合に、json_last_error() や json_last_error_msg() で具体的なエラー原因を確認することが重要です。
6.4. XMLデータのパース
XML形式の応答の場合、SimpleXML拡張機能の simplexml_load_string() 関数などが利用できます。
“`php
$ch = curl_init($xml_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response !== false) {
$http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($http_status >= 200 && $http_status < 300) {
// XMLエラーを補足するためにlibxml_use_internal_errorsを使用することが推奨されます
libxml_use_internal_errors(true);
$xml = simplexml_load_string($response);
if ($xml === false) {
echo "XMLパースエラー:\n";
foreach(libxml_get_errors() as $error) {
echo "- " . $error->message . "\n";
}
libxml_clear_errors(); // エラーをクリア
} else {
// パース成功、データを利用
// echo $xml->item[0]->title;
print_r($xml);
}
libxml_use_internal_errors(false); // エラーハンドリングを元に戻す
} else {
echo "HTTPエラー: " . $http_status . "\n";
}
} else {
echo “cURL実行エラー: ” . curl_error($ch) . “\n”;
}
curl_close($ch);
“`
XMLパースにおいても、エラーハンドリングは重要です。libxml_use_internal_errors を使うことで、パースエラーの詳細を取得できます。
6.5. HTML/テキストデータの解析
WebスクレイピングなどでHTMLやプレーンテキストを取得した場合、文字列操作関数 (strpos, preg_match, substr など) や、HTML DOMパーサーライブラリ（PHP標準ではないが、SymphonyのDomCrawlerなどがよく使われる）を利用して必要な情報を抽出します。
“`php
$ch = curl_init($html_url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
if ($response !== false) {
$http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($http_status >= 200 && $http_status < 300) {
echo "HTMLコンテンツを取得しました。サイズ: " . strlen($response) . " バイト\n";
// 例: <title>タグの内容を正規表現で抽出
if (preg_match('/<title>(.*?)<\/title>/is', $response, $matches)) {
echo "ページのタイトル: " . $matches[1] . "\n";
} else {
echo "タイトルタグが見つかりませんでした。\n";
}
// より高度なHTMLパースはDOMライブラリを使用
// $dom = new DOMDocument();
// @$dom->loadHTML($response); // @でエラーを抑制することも多い
// $xpath = new DOMXPath($dom);
// $elements = $xpath->query("//div[@class='some-class']");
// ...
} else {
echo "HTTPエラー: " . $http_status . "\n";
}
} else {
echo “cURL実行エラー: ” . curl_error($ch) . “\n”;
}
curl_close($ch);
“`
HTMLパースは複雑になりがちで、正規表現は限定的な用途（例: <title> タグなど構造が単純で出現回数が少ないもの）に留めるのが望ましいです。本格的なスクレイピングにはDOMパーサーライブラリの導入を検討しましょう。
6.6. エラーハンドリング
curl_exec() が false を返した場合、cURLリクエストの実行自体が失敗しています（ネットワーク接続エラー、タイムアウトなど）。この場合は curl_error() 関数や curl_errno() 関数を使って具体的なエラー情報を取得し、デバッグや適切なエラーメッセージの表示を行います。
“`php
$ch = curl_init($invalid_url); // 例: 存在しないホストなど
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 5); // タイムアウトを設定
$response = curl_exec($ch);
if ($response === false) {
// curl_exec() が false を返した場合（CURLOPT_RETURNTRANSFER = true の場合）
echo “cURL実行エラーが発生しました。\n”;
echo “エラーコード: ” . curl_errno($ch) . “\n”;
echo “エラーメッセージ: ” . curl_error($ch) . “\n”;
// エラーの種類に応じて、再試行やログ記録などの処理を行う
} else {
// curl_exec() が成功したが、HTTPステータスコードがエラーを示す場合
$http_status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($http_status >= 400) {
echo “HTTPエラーが発生しました。ステータスコード: ” . $http_status . “\n”;
// $response にはエラーページの内容などが含まれている可能性がある
echo “エラーレスポンスボディ: ” . $response . “\n”;
} else {
// 正常なレスポンスを処理
echo “リクエストは成功しました。\n”;
// … $response の処理
}
}
curl_close($ch);
“`
CURLOPT_RETURNTRANSFER = true の場合、curl_exec() は成功時に文字列（レスポンス）、失敗時に false を返します。この戻り値の型を確認することで、実行エラーか、HTTPステータスコードによる論理的なエラーかを区別できます。
7. 実用的なユースケース
CURLOPT_RETURNTRANSFER = true は、PHPで外部サービスと連携するほとんどのシナリオで利用されます。
-
API連携: 最も一般的なユースケース。RESTful APIなどからJSONやXML形式でデータを取得し、それをPHPのデータ構造に変換してアプリケーション内で利用します。認証トークンの送信、POST/PUT/DELETEリクエストでのデータ送信なども行いますが、レスポンスの受信時には
CURLOPT_RETURNTRANSFER = trueが必須です。
“`php
// 例: 外部APIからユーザー情報を取得
$ch = curl_init(“https://api.example.com/users/123”);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [‘Authorization: Bearer YOUR_ACCESS_TOKEN’]); // 認証ヘッダー
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);if ($status == 200 && $response !== false) {
$user_data = json_decode($response, true);
if ($user_data) {
echo “ユーザー名: ” . $user_data[‘name’] . “\n”;
}
} else {
echo “APIエラー: ステータス ” . $status . “\n”;
}
* **Webスクレイピング:** 他のWebサイトのHTMLコンテンツを取得し、必要な情報を抽出・加工して表示したり、データベースに保存したりします。ページの構造を解析し、特定の要素の内容を取得するために、レスポンスHTMLを変数として取得する必要があります。php
// 例: Webページのタイトルを取得
$ch = curl_init(“https://www.php.net/”);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$html = curl_exec($ch);
curl_close($ch);if ($html !== false) {
if (preg_match(‘/(.*?)<\/title>/is’, $html, $matches)) {<br /> echo “サイトのタイトル: ” . $matches[1] . “\n”;<br /> }<br /> }<br /> <code>* **外部サービスの応答確認:** 特定のURLが存在するか、正常に応答するか、応答内容に特定のエラーメッセージが含まれていないかなどをプログラムから確認したい場合に、レスポンスを取得して内容を検査します。<br /> * **非同期リクエスト (curl_multi):** 複数のcURLリクエストを並行して実行し、効率的に複数のAPIからデータを取得したり、複数のURLをチェックしたりする場合に `curl_multi` 関数群を利用します。この際、各個別リクエスト (`curl_init()` で生成) に対して `CURLOPT_RETURNTRANSFER = true` を設定することで、各リクエストのレスポンスをバッファリングさせ、`curl_multi_getcontent()` 関数で後から個別に取得できるようになります。これは `curl_multi` を使う上での必須設定と言えます。</code>php<br /> // 例: 複数URLを並列で取得<br /> $urls = [“https://httpbin.org/delay/1”, “https://httpbin.org/delay/2”, “https://httpbin.org/delay/3”];<br /> $mh = curl_multi_init();<br /> $chs = [];<br /> $results = [];</p> <p>foreach ($urls as $key => $url) {<br /> $chs[$key] = curl_init($url);<br /> curl_setopt($chs[$key], CURLOPT_RETURNTRANSFER, true); // レスポンスを文字列として取得<br /> curl_multi_add_handle($mh, $chs[$key]);<br /> }</p> <p>// 全てのリクエストが完了するまで待機<br /> $running = null;<br /> do {<br /> curl_multi_exec($mh, $running);<br /> } while ($running);</p> <p>// 各リクエストの結果を取得<br /> foreach ($chs as $key => $ch) {<br /> $results[$urls[$key]] = curl_multi_getcontent($ch); // ここでバッファされたレスポンスを取得<br /> curl_multi_remove_handle($mh, $ch);<br /> curl_close($ch);<br /> }<br /> curl_multi_close($mh);</p> <p>print_r($results); // 各URLのレスポンスが格納されている<br /> “`</p> </li> </ul> <p>これらのユースケース全てにおいて、リモートサーバーからの応答データをPHPスクリプト内で操作する必要があるため、<code>CURLOPT_RETURNTRANSFER = true</code> は不可欠な設定となります。</p> <h3>8. 注意点とトラブルシューティング</h3> <p><code>CURLOPT_RETURNTRANSFER = true</code> を使用する際に注意すべき点や、発生しやすい問題について解説します。</p> <ul> <li><strong>メモリ使用量:</strong> <code>CURLOPT_RETURNTRANSFER = true</code> はレスポンスデータ全体をメモリ上の文字列変数として保持します。取得するデータが非常に大きい場合（例: 数百MB〜数GBのファイル）、PHPのメモリ制限を超過する可能性があります。このような場合は、前述の <code>CURLOPT_FILE</code> を使用してファイルに直接書き込むことを検討してください。 <ul> <li>PHPの <code>memory_limit</code> 設定を確認し、必要に応じて調整します。ただし、無闇に増やすとサーバー全体のリソースを圧迫する可能性があります。</li> </ul> </li> <li><strong>タイムアウト:</strong> リモートサーバーからの応答が遅い場合、スクリプトの実行が長時間ブロックされる可能性があります。<code>CURLOPT_TIMEOUT</code> (転送全体の最大時間) および <code>CURLOPT_CONNECTTIMEOUT</code> (接続確立の最大時間) オプションを適切に設定し、タイムアウト時にはエラーハンドリングを行うことが重要です。<br /> <code>php<br /> curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 全体のタイムアウトを10秒に<br /> curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); // 接続確立のタイムアウトを5秒に</code><br /> タイムアウトによって <code>curl_exec()</code> が <code>false</code> を返した場合、<code>curl_errno($ch)</code> が <code>CURLE_OPERATION_TIMEDOUT</code> などの適切なエラーコードを返します。</li> <li><strong>文字コード:</strong> 取得したレスポンスの文字コードがスクリプトの期待するものと異なる場合があります。HTTPヘッダーの <code>Content-Type</code> フィールドで文字コード (<code>charset</code>) が指定されているか確認し、必要に応じて <code>mb_convert_encoding()</code> などの関数で文字コード変換を行います。<br /> <code>php<br /> // ヘッダーからContent-Typeを取得 (CURLOPT_HEADER が true の場合)<br /> $header_size = curl_getinfo($ch, CURLINFO_HEADER_SIZE);<br /> $header = substr($response, 0, $header_size);<br /> if (preg_match('/Content-Type:.*?charset=(.*?)\s*$/im', $header, $matches)) {<br /> $charset = trim($matches[1]);<br /> echo "Detected Charset: " . $charset . "\n";<br /> if (strcasecmp($charset, 'utf-8') !== 0) {<br /> // 例: Shift_JIS から UTF-8 へ変換<br /> $body = substr($response, $header_size);<br /> $body_utf8 = mb_convert_encoding($body, 'UTF-8', $charset);<br /> // $body_utf8 を処理...<br /> }<br /> }</code></li> <li><strong>SSL証明書の問題:</strong> HTTPS接続を行う際、リモートサーバーのSSL証明書検証に失敗することがあります。本番環境では、証明書検証を無効化 (<code>CURLOPT_SSL_VERIFYPEER = false</code>, <code>CURLOPT_SSL_VERIFYHOST = false</code>) するべきではありません。代わりに、PHPが信頼できる証明書 (<code>cacert.pem</code> ファイルなど) を参照できるように <code>CURLOPT_CAINFO</code> オプションを設定するか、PHPの設定ファイル (<code>php.ini</code>) で <code>curl.cainfo</code> を設定することが推奨されます。<br /> <code>php<br /> // 例: CA証明書ファイルパスを設定 (システムにない場合など)<br /> // curl_setopt($ch, CURLOPT_CAINFO, '/path/to/cacert.pem');</code><br /> デバッグ時のみ、一時的に検証を無効にすることは許容される場合がありますが、セキュリティリスクを理解した上で行ってください。</li> <li><strong>リダイレクトの処理:</strong> リクエストしたURLが別のURLにリダイレクトされることがあります (<code>3xx</code> ステータスコード)。デフォルトではcURLはリダイレクトを追跡しませんが、<code>CURLOPT_FOLLOWLOCATION = true</code> を設定することで自動的に追跡させることができます。リダイレクトを追跡する場合、取得されるレスポンスは最終的なリダイレクト先のものです。<br /> <code>php<br /> curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);</code></li> <li><strong>エラー時の戻り値:</strong> <code>CURLOPT_RETURNTRANSFER = true</code> の場合、<code>curl_exec()</code> は成功時にレスポンス文字列、失敗時に <code>false</code> を返します。必ずこの戻り値が <code>false</code> でないかを確認し、エラーハンドリングを行う必要があります。さらに、HTTPステータスコードも確認し、サーバーからのエラー応答（4xx, 5xx）とcURL実行自体のエラー（接続失敗など）を区別して処理することが堅牢なアプリケーションには不可欠です。</li> </ul> <h3>9. 高度な利用法と連携</h3> <p><code>CURLOPT_RETURNTRANSFER</code> は、他のcURLオプションと組み合わせることで、さらに高度なネットワーク通信を実現します。</p> <ul> <li><strong>POSTデータの送信:</strong> <code>CURLOPT_POST = true</code> および <code>CURLOPT_POSTFIELDS</code> オプションを使用することで、HTTP POSTリクエストを送信できます。APIへのデータ送信などで頻繁に利用されます。レスポンスとしてAPIからの処理結果を受け取るために、やはり <code>CURLOPT_RETURNTRANSFER = true</code> が必要です。<br /> <code>php<br /> $ch = curl_init("https://api.example.com/items");<br /> curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);<br /> curl_setopt($ch, CURLOPT_POST, true);<br /> $data = ['name' => 'New Item', 'price' => 100];<br /> curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data)); // または JSON 文字列など<br /> curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/x-www-form-urlencoded']); // Content-Typeを設定<br /> $response = curl_exec($ch);<br /> // ... レスポンス処理</code></li> <li><strong>カスタムヘッダーの送信:</strong> <code>CURLOPT_HTTPHEADER</code> オプションで、リクエストに任意のHTTPヘッダーを追加できます。APIキーの送信、コンテンツタイプ指定、ユーザーエージェント設定など、多様な用途があります。レスポンスの処理には <code>CURLOPT_RETURNTRANSFER = true</code> が必要です。<br /> <code>php<br /> curl_setopt($ch, CURLOPT_HTTPHEADER, [<br /> 'X-API-Key: YOUR_API_KEY',<br /> 'Accept: application/json',<br /> 'User-Agent: My PHP App/1.0'<br /> ]);</code></li> <li><strong>クッキーの処理:</strong> <code>CURLOPT_COOKIEJAR</code> および <code>CURLOPT_COOKIEFILE</code> オプションを使用することで、サーバーから受信したクッキーをファイルに保存し、以降のリクエストでそのクッキーを送信することが可能です。セッション管理やログイン状態の維持などに利用されます。レスポンス内容の取得には <code>CURLOPT_RETURNTRANSFER = true</code> を組み合わせます。<br /> <code>php<br /> $cookie_file = '/path/to/cookie.txt'; // 書き込み可能な場所<br /> curl_setopt($ch, CURLOPT_COOKIEJAR, $cookie_file); // 受信したクッキーを保存<br /> curl_setopt($ch, CURLOPT_COOKIEFILE, $cookie_file); // 保存したクッキーを送信</code></li> <li><strong>プロキシ設定:</strong> <code>CURLOPT_PROXY</code> オプションでプロキシサーバー経由で接続できます。企業のネットワーク環境下での接続や、特定のIPアドレスからのアクセスが必要な場合などに使用します。<br /> <code>php<br /> curl_setopt($ch, CURLOPT_PROXY, 'http://your_proxy_host:port');<br /> // curl_setopt($ch, CURLOPT_PROXYUSERPWD, 'user:password'); // 認証が必要な場合</code></li> </ul> <p>これらの高度な機能を利用する際も、最終的にリモートサーバーからの応答をプログラムで処理するためには、<code>CURLOPT_RETURNTRANSFER = true</code> が中心的な役割を果たします。</p> <h3>10. まとめ</h3> <p>この記事では、PHP cURLライブラリにおける <code>CURLOPT_RETURNTRANSFER</code> オプションについて、その基本から応用まで詳細に解説しました。</p> <ul> <li><code>CURLOPT_RETURNTRANSFER = false</code> (デフォルト) の場合、<code>curl_exec()</code> はレスポンスを標準出力に直接出力し、戻り値は成功/失敗の boolean です。これは単純な出力やデバッグには使えますが、レスポンス内容をプログラムで利用できません。</li> <li><code>CURLOPT_RETURNTRANSFER = true</code> に設定した場合、<code>curl_exec()</code> はレスポンスデータ全体を文字列として返し、その文字列をPHPの変数に格納できます。これにより、取得したデータを解析、加工、あるいはその内容に基づいて後続の処理を分岐させるといった、高度なプログラミングが可能になります。</li> <li>API連携、Webスクレイピング、非同期リクエストなど、PHPで外部と連携する多くの実用的なシナリオにおいて、<code>CURLOPT_RETURNTRANSFER = true</code> は必須の設定と言えます。</li> <li><code>CURLOPT_HEADER</code> と組み合わせることでヘッダー情報も取得できますが、ヘッダーとボディの分離には <code>CURLINFO_HEADER_SIZE</code> の利用が必要です。</li> <li>レスポンスデータの処理方法（JSONデコード、XMLパース、文字列検索など）は、取得したデータの形式に応じて適切に選択する必要があります。</li> <li>cURL実行自体のエラーや、HTTPステータスコードによるサーバー応答エラーに対する堅牢なエラーハンドリングは、アプリケーションの信頼性を高めるために不可欠です。</li> <li>大きなデータ取得時のメモリ使用量、タイムアウト、文字コード、SSL証明書の問題など、<code>CURLOPT_RETURNTRANSFER</code> を使用する際の注意点も理解しておく必要があります。</li> </ul> <p>PHPでcURLを効果的に利用するためには、<code>CURLOPT_RETURNTRANSFER</code> の役割と、それがデフォルトの動作とどう異なるのかを正確に理解することが最初のステップです。そして、取得したレスポンスを適切に処理し、発生しうるエラーや注意点に対処することで、より信頼性が高く、機能豊富なWebアプリケーションを開発できるようになります。</p> <p>この記事が、あなたのPHPにおけるcURLおよび <code>CURLOPT_RETURNTRANSFER</code> の理解を深め、日々の開発に役立つことを願っています。</p> <hr /> <p><strong>注意点:</strong><br /> * 上記のテキストは、指示された約5000語のボリュームを目指して記述されており、詳細な説明やコード例、背景知識、注意点などが含まれています。実際の文字数は環境や改行の扱いによって多少変動する可能性があります。<br /> * コード例は基本的なものであり、実際の運用ではより詳細なエラーハンドリングやセキュリティ対策（例: CSRF対策、入力値検証など）が必要になる場合があります。<br /> * 外部のテスト用サービス (<code>httpbin.org</code>) はサービス提供者の都合により変更・停止される可能性があります。</p> <hr /> <p>はい、承知いたしました。PHPのcURLライブラリにおける <code>CURLOPT_RETURNTRANSFER</code> オプションについて、詳細な解説を含む記事を作成します。以下がその内容です。</p> <hr /> <h2>curlopt_returntransfer 徹底解説！PHP cURLでのレスポンス取得</h2> <p>PHPで外部のWebサービスと連携したり、APIからデータを取得したり、あるいは単にWebサイトの内容をプログラムから確認したりする場合、多くの開発者が頼りにするのがcURLライブラリです。cURLは、様々なプロトコル（HTTP, HTTPS, FTPなど）を使用してデータを送受信するための強力なツールであり、PHPはそのcURLの機能を利用するための豊富な関数を提供しています。</p> <p>PHPでcURLを使う際、最も基本的かつ重要なオプションの一つが <code>CURLOPT_RETURNTRANSFER</code> です。このオプションは、cURLリクエストの実行結果（通常はリモートサーバーからの応答、つまりレスポンス）をどのように扱うかを決定します。</p> <p>この記事では、<code>CURLOPT_RETURNTRANSFER</code> オプションに焦点を当て、それが何をするのか、なぜ重要なのか、そしてどのように使うのかを、基本的な例から応用的なシナリオ、さらには関連するオプションや注意点まで含めて徹底的に解説します。約5000語のボリュームで、このオプションの全てを網羅することを目指します。</p> <h3>1. はじめに：PHPにおけるcURLの役割</h3> <p>PHPはサーバーサイドスクリプト言語として、Webサーバー上で動作し、動的なWebページを生成したり、様々な処理を実行したりします。Webアプリケーション開発において、自らのサーバーだけでなく、インターネット上の他のサーバーと連携することは非常に一般的です。例えば：</p> <ul> <li>外部のRESTful APIを呼び出してデータを取得・送信する。</li> <li>OAuthなどの認証プロトコルを使ってユーザー認証を行う。</li> <li>決済サービスと連携してトランザクションを処理する。</li> <li>ソーシャルメディアAPIを使って情報を投稿・取得する。</li> <li>RSSフィードやAtomフィードを読み込む。</li> <li>単に他のWebページのHTML内容を取得する（Webスクレイピング）。</li> </ul> <p>これらのタスクを実行するために、PHPは外部のURLに対してHTTPリクエストを発行し、その応答（レスポンス）を受け取る必要があります。PHPの標準ライブラリには <code>file_get_contents()</code> や <code>stream_context_create()</code> といった関数もありますが、HTTPリクエストに関する詳細な制御（カスタムヘッダー、POSTデータの送信、クッキー管理、プロキシ設定、タイムアウト設定、SSL検証など）が必要な場合、cURLが最も柔軟で強力な選択肢となります。</p> <p>cURLは、多数のプロトコルをサポートし、非常にきめ細やかな設定が可能です。PHPのcURL拡張機能は、これらのcURLの機能をPHPスクリプトから簡単に利用できるようにするものです。基本的なcURLの使い方は以下の流れになります。</p> <ol> <li><code>curl_init()</code>: cURLセッションを初期化し、ハンドルを取得する。</li> <li><code>curl_setopt()</code> または <code>curl_setopt_array()</code>: cURLセッションのオプションを設定する。これがこの記事の主題である <code>CURLOPT_RETURNTRANSFER</code> を含め、様々な振る舞いを制御する部分です。</li> <li><code>curl_exec()</code>: 設定されたオプションに従ってcURLセッションを実行し、リモートサーバーと通信する。</li> <li><code>curl_getinfo()</code>: リクエストに関する情報（HTTPステータスコード、転送時間など）を取得する（オプション）。</li> <li><code>curl_close()</code>: cURLセッションを終了し、リソースを解放する。</li> </ol> <p>この一連の流れの中で、<code>curl_exec()</code> 関数が実行結果をどのように返すか、あるいはどのように出力するかが、<code>CURLOPT_RETURNTRANSFER</code> オプションによって制御されるのです。</p> <h3>2. <code>CURLOPT_RETURNTRANSFER</code> とは？ 基本概念の理解</h3> <p><code>CURLOPT_RETURNTRANSFER</code> は、<code>curl_setopt()</code> 関数で使用されるcURLオプションの一つです。その名前が示唆するように、「戻り値として転送データ（レスポンス）を返すかどうか」を制御します。</p> <p>このオプションは boolean (真偽値) を値として取ります。</p> <ul> <li><code>false</code> (または 0): <strong>デフォルト値</strong>。<code>curl_exec()</code> の実行結果として、リモートサーバーからのレスポンスデータを<strong>標準出力に直接出力</strong>します。この場合、<code>curl_exec()</code> 関数の戻り値は、通常、リクエストが成功したかどうかを示す boolean 値（成功時に <code>true</code>、失敗時に <code>false</code>）になります。</li> <li><code>true</code> (または 1): <code>curl_exec()</code> の実行結果として、リモートサーバーからのレスポンスデータを<strong>文字列として返します</strong>。この場合、<code>curl_exec()</code> 関数の戻り値は、レスポンスデータそのもの（文字列）になります。リクエストが失敗した場合は <code>false</code> を返します。</li> </ul> <p>つまり、<code>CURLOPT_RETURNTRANSFER</code> を <code>true</code> に設定すると、<code>curl_exec()</code> がechoやprintのように画面に直接レスポンスを表示するのではなく、そのレスポンスをプログラム内の変数に格納できるようになる、ということです。</p> <h3>3. <code>CURLOPT_RETURNTRANSFER</code> を使わない場合（デフォルト動作）</h3> <p>まず、<code>CURLOPT_RETURNTRANSFER</code> を明示的に設定しない場合、あるいは <code>false</code> に設定した場合のcURLの動作を見てみましょう。これは、<code>curl_exec()</code> 関数がレスポンスを標準出力に直接出力するモードです。</p> <p><strong>コード例 (デフォルト動作):</strong></p> <p>“`php</p> <p><?php echo "--- cURLセッション初期化 ---\n"; // cURLセッションを初期化 $ch = curl_init(); if ($ch === false) { die("cURLセッションの初期化に失敗しました。\n"); } // 取得したいURLを設定 $url = "https://httpbin.org/html"; // テスト用のHTMLコンテンツを返すサービス echo "対象URL: " . $url . "\n"; // URLオプションを設定 curl_setopt($ch, CURLOPT_URL, $url); // CURLOPT_RETURNTRANSFER は設定しない（または false に設定） // curl_setopt($ch, CURLOPT_RETURNTRANSFER, false); // デフォルトなので不要 echo "\n--- cURLリクエスト実行 (デフォルト動作) ---\n"; echo "リモートサーバーからのレスポンスがここに直接出力されます:\n"; // cURLセッションを実行 // デフォルトではレスポンスが標準出力に直接出力される // $result は成功/失敗の boolean になる $result = curl_exec($ch); echo "\n--- curl_exec() の戻り値を確認 ---\n"; // デフォルト動作の場合、curl_exec() は成功/失敗の boolean を返す echo 'curl_exec() の戻り値の型: ' . gettype($result) . "\n"; echo 'curl_exec() の戻り値: ' . var_export($result, true) . "\n"; if ($result === true) { echo "cURLリクエストは成功したようです。\n"; // 注意: レスポンス内容は $result に含まれていない。既に出力されている。 } elseif ($result === false) { echo "cURLリクエストが失敗しました。\n"; echo "cURLエラーコード: " . curl_errno($ch) . "\n"; // エラーコードを取得 echo "cURLエラーメッセージ: " . curl_error($ch) . "\n"; // エラーメッセージを取得 } else { echo "curl_exec() は予期しない値を返しました。\n"; } echo "\n--- cURLセッション終了 ---\n"; // cURLセッションを終了 curl_close($ch); echo "--- スクリプト終了 ---\n"; ?></p> <p>“`</p> <p><strong>実行結果とその説明:</strong></p> <p>上記のコードを実行すると、以下のような出力が得られるはずです（具体的なHTMLコンテンツは <code>httpbin.org</code> のレスポンスによって多少異なる場合があります。また、CLIで実行した場合はコンソールに、Webサーバー経由の場合はブラウザまたはWebサーバーの出力バッファに出力されます）。</p> <p>“`<br /> — cURLセッション初期化 —<br /> 対象URL: https://httpbin.org/html</p> <p>— cURLリクエスト実行 (デフォルト動作) —<br /> リモートサーバーからのレスポンスがここに直接出力されます:</p> <p><!DOCTYPE html><br /> <html><br /> <head><br /> <title>Herman Melville – Moby Dick
Moby Dick
Chapter 1
Loomings.
Call me Ishmael. Some years ago—never mind how long precisely—having
little or no money in my purse, and nothing particular to interest me on
shore, I thought I would sail about a little and see the watery part of
the world. It is a way I have of driving off the spleen and regulating
the circulation. Whenever I find myself growing grim about the mouth;
whenever it is a damp, drizzly November in my soul; whenever I find
myself involuntarily pausing before coffin warehouses, and bringing up
the rear of every funeral I meet; and especially whenever my hypos get
such an upper hand of me, that it requires a strong moral principle to
prevent me from deliberately stepping into the street, and methodically
knocking people’s hats off—then, I account it high time to get to sea as
soon as I can. This is my substitute for pistol and ball. With a
philosophical flourish Cato throws himself upon his sword; I quietly
take to the ship. There is nothing surprising in this. If they but knew
how dreary it is to wear a thoughtful soul in a thoughtful soul, and how
remorseless it is to persist in driving himself through all the
quadrangles of the world, and bruising himself against every stave, then
they would pause, and if there are no other arguments, they would pause
in soul.