先程アップデートしたWordPressプラグインで実装したコードの一部をご紹介。

以下で紹介する関数はPHPで条件付きGET（Conditional GET）に対応するための関数です。

どういうものかというと、ブラウザからリクエストがあった際に、最終更新日（Last-Modified）をレスポンスヘッダでおくると、そのブラウザは次回以降のアクセスの際に「あの日以降更新した？」と聞いてくるので、更新してなかったときには「まだしてないよ」とだけ返す（コンテンツは返さない）仕組みのことです。

ソース

function conditional_get($time = 0)
{
  $last_modified = gmdate('D, d M Y H:i:s T', $time);
  $etag = md5($last_modified);
  header('Last-Modified: '.$last_modified);
  header('ETag: "'.$etag.'"');
  if (isset($_SERVER['HTTP_IF_MODIFIED_SINCE'])) {
    if ($_SERVER['HTTP_IF_MODIFIED_SINCE'] == $last_modified) {
      header('HTTP/1.1 304 Not Modified');
      exit;
    }
  }
  if (isset($_SERVER['HTTP_IF_NONE_MATCH'])) {
    if (preg_match("/{$etag}/", $_SERVER['HTTP_IF_NONE_MATCH'])) {
      header('HTTP/1.1 304 Not Modified');
      exit;
    }
  }
}

使い方

あらかじめ、コンテンツの最終更新日を取得して、conditional_get() に渡すと、必要な処理をいろいろやってくれます。

そのあとで、実際のコンテンツを取得して出力です。
実際には、$time以降の更新がない場合は、conditional_get() 内で終了します。

$time = get_modified() // コンテンツの更新日時をローカルタイムスタンプで取得

conditional_get($time);

$html = get_contents(); // コンテンツを取得
echo $html;

conditioal_get() の前にコンテンツを取得しちゃうと意味が半減することがあるかもしれないので注意。

どうもよくわからんのでメモ。

参照渡しとは？

関数に値を渡す通常の方法。

<?php

$i = 0;

test($i);

print $i; // 0を出力。$iの値そのものは変わらない

function test($int){
  $int++;
}

?>

参照渡しにする。（関数の定義の引数の部分に&をつける。）

<?php

$i = 0;

test($i);

print $i; // 1を出力。$iの値がかわった！

function test(&$int){
  $int++;
}

?>

通常の関数の引数は、渡された変数の値のみが渡されるが、参照渡しをすると変数そのものが渡されるので、このような挙動になる。

PHP5での仕様変更

ここまでは、特に問題はない。

しかし、PHP4では、以下のように呼び出し側でも参照渡しの指定ができたが、これはPHP5ではphp.iniを変えないと動作しない。

<?php

$i = 0;

test(&$i); // 呼び出す際に&をつける

print $i; // 1を出力。$iの値がかわった！

function test($int){
  $int++;
}

?>

これは実際、そうするべきだと思う。

なんで呼び出し側で参照渡しをできるようにしていたのか、よくわからんので、改善だと思う。

が！問題はここから！

call_user_funcを使用した際の参照渡し

以下のようにcall_user_funcを使用すると、関数側で参照渡しするよう指定していても参照渡しされないばかりか、警告が出る！

<?php

$i = 0;

call_user_func('test', $i);

print $i; // 0

function test(&$int){
  $int++;
}

?>

出力結果

Warning: Parameter 1 to test() expected to be a reference, value given in...

ためしに、call_user_func(‘test’, &$i); としたら予想通り以下のエラー。

Deprecated: Call-time pass-by-reference has been deprecated in

なんじゃそりゃ！？

解決策

いろいろ試した結果、以下のような方法なら大丈夫なようだが、全く納得がいかない。

call_user_func_array() を使用する

<?php

$i = 0;

call_user_func_array('test', array(&$i));

print $i; // 1を出力。$iの値がかわった！

function test(&$int){
  $int++;
}

?>

関数名を変数に代入してコールする

<?php

$i = 0;

$func = 'test';

$func($i);

print $i; // 1を出力。$iの値がかわった！

function test(&$int){
  $int++;
}

?>

たまたま、今のバージョンで警告が出ていないだけなのか？
もしそうなら、 call_user_funcしたいときは、どうやって参照渡しするんだ？

参考

• PHP 5.3： 参照渡しの関数/メソッドを定義してた人は call_user_func_array に注意 – 肉とご飯と甘いもの @ sotarok