てっく★ゆきろぐ Rev2

cURLのマルチハンドルにおける、各ハンドルごとの通信内容の結果取得方法についてです。
データ本体ではなく、HTTPコードや通信時間、エラー理由（名前解決失敗やネットワーク接続失敗やconnection refusedなどといった、MACレイヤやTCP/IPレベルでの理由）の取得方法になります。

PHPの公式ドキュメントがクソわかりづらかったので、まとめました。

その１。
HTTPコードや通信時間などについては、curl_getinfo がそのまま使えます。
PHP: curl_getinfo – Manual

その２。
cURLが返すエラー理由については、curl_errorは使えません。curl_multi_infi_readの結果で取得できます。
PHP: curl_multi_info_read – Manual
参考：PHP: curl_error – Manual

なお、cURLのエラーコードについてはこちらに説明があります。
libcurl – Error Codes

curl_multiの使い方については以下のブログが詳しいのでそちらに説明を譲ります。
APIとの通信効率をよくする実装例(1) curl_multi – Yahoo! JAPAN Tech Blog

以下は実際に取得するためのサンプルコードです。
いろいろ端折ってます。

// make multi handle
$mh = curl_multi_init();

// make each handle (同時実行数分だけ行う）
$ch1 = curl_init() ;
curl_setopt( $ch1 , OPTION , VALUE ) ;         // option はここで設定
curl_multi_add_handle( $mh , $ch1 ) ;
$ch2 = curl_init() ;
curl_setopt( $ch2 , OPTION , VALUE ) ;         // option はここで設定
curl_multi_add_handle( $mh , $ch2 ) ;
$ch3 = curl_init() ;
curl_setopt( $ch3 , OPTION , VALUE ) ;         // option はここで設定
curl_multi_add_handle( $mh , $ch3 ) ;
    /* 途中省略 */
// ここまで each handle 分くりかえす
$mchary = array( $ch1 , $ch2 , $ch3 /* 中略 */ ) ;

// execute 
do {
    $mr = curl_multi_exec( $mh , $active ) ;
} while( $mr == CURLM_CALL_MULTI_PERFORM );

// get result 
$curlinfoary = array () ;
while( ( $cary = curl_multi_info_read( $mh ) ) != FALSE )   
{
    /* 1回の実行で1つのハンドル($chN)しか取得できないので注意 
     * $cary['handle'] ... curl_init で取得したハンドル 
     * $cary['result'] ... 結果コード
     */
    $curlinfoary[] = $cary ;

}

// get each handle results
foreach ( $mchary as $lch )
{
     /* content本体 */
     $content = curl_multi_getcontent($lch);
     /* info data */
     $infodata = curl_getinfo($c) ;     // curl single系のものをそのまま使えます
     /* どんな内容が得られるかは、 curl_getinfo のドキュメントを参照すべし */
     $httpconde = $infodata['http_code'] ;
     $tttime    = $infodata['total_time'] ;
     $ftime     = $infodata['filetime'] ; 
     /* 各ハンドルの result(エラーコード) 取得 */
     $rh = -1 ;
     foreach ( $curlinfoary as $cj )
     {
         if ( $cj['handle'] === $lch ) 
         {
              $rh = $cj['result'] ;
              break ; 
         }
     }
     /* $rh の値は、cURLのエラーコード(CURLE_*)になります。
        $rh に -1 が入ってるわけがないので、今回はそのまま強行します
       （念のためチェックはしたほうがいいかも？） 
      */
     curl_multi_remove_handle( $mh , $lch ) ;
}

L2〜L4で失敗した詳細の理由を欲しいとかいう場面は滅多にないと思いますが、どうしても原因がわからずに詰んでしまったときのデバッグのための手助けにはなると思います。

curl_setopt()の「CURLOPT_HEADERFUNCTION」と「CURLOPT_WRITEFUNCTION」の説明がわかりづらくて、かつどこにも説明してるサイトがなかったので自分でまとめてみました。

CURLOPT_HEADERFUNCTIONは、「ヘッダが読まれたときにコールバックする関数」を指定し、
CURLOPT_WRITEFUNCTIONは、「コンテンツが読み込まれた時に逐次コールバックされる関数」を指定します。
全部読み込んで一気に処理するのではなく、戻ってきた分を逐次処理して返す場合に有効。

<?php
set_time_limit(0);

$c = curl_init() ;
curl_setopt( $c , CURLOPT_URL , $url ) ;
curl_setopt( $c , CURLOPT_USERAGENT , $useragent ) ;
curl_setopt( $c , CURLOPT_COOKIE , $cookies );

// curl_setopt( $c , CURLOPT_RETURNTRANSFER , TRUE ) ; // 不要

curl_setopt( $c , CURLOPT_HTTPHEADER , $headers ) ;
curl_setopt( $c , CURLOPT_HEADERFUNCTION , hdcallback ) ;
curl_setopt( $c , CURLOPT_WRITEFUNCTION , wrcallback ) ;

$r = curl_exec( $c ) ;
curl_close( $c );

////////////////////////////// callback function

function hdcallback( $res , $response )
{
    $h1 = explode( "\r\n" , $response ) ;

    foreach( $h1 as $hout )
    {
        if ( $hout == "Transfer-Encoding: chunked" ) continue ;
        header( $hout ) ;
    }
    return strlen( $response ) ;
}

function wrcallback( $res , $response )
{
        echo $response ;
        ob_flush() ;
        return strlen( $response ) ;
}

まず、PHPじゃこういう使い方しませんものね。（偏見）

《追記》CURLOPT_RETURNTRANSFERを指定すると変なことになっちゃいましたので外しました。

先日買いました。

はっきり言うと「レベルが高い」…けど「必要なことはすべて書いてある」。
でも、個人的には超がつくおすすめの1冊。
今、PHPプログラマとして働きたい人には是非読んで欲しいと思ってます。
（ちなみに私の会社では必読書にしたいと思ってます、そのくらいね）

読み方としては、「書いてあることを全部理解する」ことはしないほうがいいと思う、特に初心者は。
まず一通り目を通しておく。とにかく、どんなことが書いてあったかを頭に入れておく。
書いてある内容を理解という意味ではその次でいいと思う。

そういえば。
PHPってバージョン３の頃から触ってたなあ、と。
最初に入社した会社のときでした。10年くらい前かな？

まずは手始めに材料。

• HTML 2 PDF
• MBFPDF (PHP toolsのFPDFにあります)
• FPDF(元になっているもの)

まず、html2fpdfも、mbfpdfも、fpdfの派生クラスとして定義されています。
そんなわけで、html2fpdfの元クラスを変えてあげます。
※変更前

class HTML2FPDF extends FPDF

※変更後

class HTML2FPDF extends MBFPDF

あとの変更点は、以下に
HTML2PDF で日本語を使う為の設定 – hir_kazの日記
基本的には上記サイトに書いてあるとおりで大丈夫ですが、差異というかmbfpdf独特の注意点はこのへん。

●before

require_once(RELATIVE_PATH.'fpdf.php');

●after

require_once(RELATIVE_PATH.'mbfpdf.php');

あとは、SetFontの指定方法が変わります。

$this->SetFont( GOTHIC , '' , 11 ) ;

最後に、使うときのやりかたがかわります。
●japanese.phpの場合

$pdf->AddSJISFont();

●mbfphpの場合

$pdf->AddMBFont( GOTHIC , 'SJIS' ) ;

あと注意点としては、align=”left”以外の位置指定がおかしくなるところでしょうか。
若干どころかかなり右寄りになります。
どうやら、簡単には解決しそうにない問題です。
参考：HTML2FPDF同梱のFPDF – 日々是雑記

引数の文字関係がマニュアルとかだとわかりづらいんで作った。
参考：カナを(“全角かな”、”半角かな”等に)変換する

※1:U+0022, U+0027, U+005C, U+007Eを除く U+0021 – U+007E の範囲
※2:全角変換時に「V」を併用すると、濁点・半濁点つき文字を1文字にします。例）「ｶﾞ」→「ガ」
※3:全角ひらがな←→半角カタカナの変換となります。