投稿者: editor

PEAR :: Package :: DBに

This package been superseded by MDB2 but is still maintained for bugs and security fixes
(意訳: このパッケージの代わりに MDB2 が使われるようになりましたが、バグ、セキュリティの修正はまだ続けられています)

とあったので、PEAR::DB から PEAR::MDB2 への移行について書かれているサイトをメモしておきます。
 
DB to MDB2 migration
 
参考/情報元:
– PEAR::MDB2
– MDB2 Homepage

HTTP 認証に成功した上でスクリプトにアクセスした場合、

$_SERVER[‘PHP_AUTH_USER’]

に HTTP 認証した時のログインユーザ名が格納されます。
認証に失敗した、あるいは認証が行われていない場合は空になるため、
この変数を調べることでログイン状態を調べることが可能です。
 
参考:
– PHP による HTTP 認証(公式マニュアル)

PEAR を利用しているとよく

$res = $conn->query(“SELECT no_such_field FROM a_table”);
if(PEAR::isError($res)){ // DB::isError($res) も同じ
   die($res->getMessage()); // エラー表示して終了
}

という表記をしますが、全ての PEAR パッケージについて統一的にエラー処理したい場合は PEAR::setErrorHandling() というメソッドが有用です。
 
たとえば、次のコードは上のものと同様の結果になります。

// PEAR_ERROR_DIE: PEAR_Error がインスタンス化されたら getMessage() を出力して終了するようにする。
PEAR::setErrorHandling(PEAR_ERROR_DIE);
// あとは普通に実行
$res = $conn->query(“SELECT no_such_field FROM a_table”);
// ※ここでエラー処理は不要！

 
詳細なエラー処理を行いたい場合は PEAR_ERROR_CALLBACK を利用します。

// 例1:
PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, “var_dump”);
// エラー発生時に
// if(PEAR::isError($res)){ var_dump($res); }
// とするのと等価
 
// 例2:
PEAR::setErrorHandling(PEAR_ERROR_CALLBACK, “error_exit”);
function error_exit($pear_err){
  die($pear_err->getMessage().”:”.$pear_getDebugInfo());
}
// エラー発生時にユーザ定義関数 error_exit を呼び出すのと等価

 
static に呼ばずインスタンスメソッドとして setErrroHandling をコールした場合、そのインスタンスについてのみ、ハンドリングします。
 
参考:
– PEAR 基底クラス – はじめに

ふと、ImageLayerEffect() という関数を見付けたのですが、情報がなかったため、使い方を書いておきます。
 
User Contributed Notes より..

bool imagelayereffect ( resource image, int effect )
 
この関数は全ての描画関数の処理に影響を与えるという点で、既存の関数 ImageAlphaBlending() と似ています。(以下に示す)エフェクトモードを切替えることで既存の関数の機能を拡張できます。
 
effect には以下のうちいずれか一つを指定します。
 
IMG_EFFECT_REPLACE
ピクセル置換を利用します(ImageAlphaBlending(FALSE) と同等)
 
IMG_EFFECT_NORMAL
通常のピクセルブレンディングを利用します(ImageAlphaBlending(TRUE) と同等)
 
IMG_EFFECT_OVERLAY
 オーバーレイルーチンを利用します。オーバーレイは、黒い下地のピクセルは黒のまま、白い下地のピクセルは白のままですが、グレーの下地のピクセルに対しては上に乗るピクセルの色をとります。

 
当然気になるのは、IMG_EFFECT_OVERLAY です。
説明にある下地のピクセル(background pixels)というのは、たとえば imagecopy() を使う時の、コピー先の画像のそれぞれのピクセル、上に乗るピクセル(foreground pixels)というのはコピー元の画像のそれそれのピクセルにあたります。
 
下地がグレー(0x7F7F7F)の時は上に乗る色、
RGB のそれぞれが 0 に近付くほど、上に乗る色のそれぞれの色を暗くし、0になると元の色によらず 0 になります。つまり全てが0になると真黒(0x000000)になります。
同様に FF に近付くほど、元の色が明るくなり全てが FF になると真っ白(0xFFFFFF)になるようです。
 
例: 画像の任意の部分を黒に塗りつぶす

$im = imagecreatefromjpeg(“sample.jpg”); // 任意の元画像
// 画像サイズ
$w = imagesx($im);
$h = imagesy($im);
// 非透過
$c_visible = 0x007F7F7F;
// 背景(黒)
$c_bg = 0x00000000;
// 中央に円のあるマスクを作成
$im_mask = imagecreatetruecolor($w,$h);
imageFilledRectangle($im_mask, 0,0, $w,$h, $c_bg);
imageFilledEllipse ($im_mask, $w/2,$h/2, $w,$h, $c_visible);
 
// コピー先のエフェクトモードを変更(デフォルトは IMG_EFFECT_NORMAL)
imagelayereffect($im_mask, IMG_EFFECT_OVERLAY);
 
// 元画像にマスクを適用(結果はマスクに上書き)
imagecopy($im_mask, $im, 0,0, 0,0, $w,$h);
imagedestroy($im);
 
// マスク結果を出力
imagepng($im_mask);
imagedestroy($im_mask);

 
非透過とある部分を、 たとえば 0x00FF007F にすると、非透過部分のそれぞれのピクセルに対し、R 要素を FF, G 要素を 0, B 要素をそのままで出力します。
 
また、α値も組合せることが可能です。
 
例:画像の任意の部分を透過する

$im = imagecreatefromjpeg(“sample.jpg”); // 任意の元画像
// 画像サイズ
$w = imagesx($im);
$h = imagesy($im);
// 非透過
$c_visible = 0x007F7F7F;
// 背景(透過)
$c_bg = 0x7F7F7F7F;
// 中央に円のあるマスクを作成
$im_mask = imagecreatetruecolor($w,$h);
imagelayereffect($im_mask, IMG_EFFECT_REPLACE); // 透過色塗りのため上書きモードに変更。
imageFilledRectangle($im_mask, 0,0, $w,$h, $c_bg);
imageFilledEllipse ($im_mask, $w/2,$h/2, $w,$h, $c_visible);
imagelayereffect($im_mask, IMG_EFFECT_NORMAL); // 透過色を透過するため通常モードに戻す。
 
// コピー先のエフェクトモードを変更(デフォルトは IMG_EFFECT_NORMAL)
imagelayereffect($im_mask, IMG_EFFECT_OVERLAY);
 
// 元画像にマスクを適用(結果はマスクに上書き)
imagecopy($im_mask, $im, 0,0, 0,0, $w,$h);
// 透過色を保存する設定
imagesavealpha($im_mask, true);
 
imagepng($im_mask);
imagedestroy($im);