PHPのお話です。もしかしたら海賊のお話です。
昔、ある海域では海賊たちは決して堅気の船を襲いませんでした。世界の成り立ちは今よりいくぶんシンプルで、任侠にはまだ美学が残っていました。
そんなわけで漁師たちは安心して沖へ出てゆくことができました。
しかしある年に、破天荒でやんちゃな海賊(5.2.9船団)が出現、その海域を席巻し、漁師以外の船もたびたび襲われるという事態が起こりました。
漁船は襲わないが、それ以外はなんであろうと略奪するというのが、彼らのモットーです。
漁師にはまだ同じ海を生きる男としての多少なりのリスペクトのようなものが働いていたのかもしれませんが、そうでなければたとえ老人と一匹の犬しか乗っていないような無邪気な船でも、海へ出た理由が素っ頓狂なものであれば、それはもうもみくちゃのひどい目にあいました。
漁師としても、漁師の呈を成していなければ老人や犬のように扱われたので今までのようには安心して暮らせません。
不安で漁獲高が減りました。
海賊の男気にもやはり抵触するものがあったのでしょうか、翌年から幸いにも、やはり堅気の船は襲うまいと、かつての暗黙のルールが復活することになりました。
これで以前の穏やかな暮らしに戻れると、漁師たちは安堵の胸をなでおろしましたが、ことはそう簡単には収まりませんでした。
やんちゃな海賊(5.2.9船団)は、海賊であるがゆえに、一度あげた旗をおろすのと同じくらい、前言撤回を嫌いました。一度男が口にした以上、なんとしても漁師以外の船は略取強奪のターゲットなのです。
そして今でもこの海域で彼らは目を光らせているのです。
漁師に告ぐ。襲われたくなくば、漁師らしくせよ、などと彼らが言ったかどうかは定かではありませんが、それ以来、漁師たちは現在でもきちっと、他の船と判別できるように、漁船に高々と漁船旗を掲げているそうです。
僕たちの暮らす海は平和でよかったですね。
いや、PHPの話でした。
やんちゃな海賊: PHP ver5.2.9
海の名前: array_unique()
暗黙のルール: デフォルト引数
堅気の船は襲わない: SORT_STRING(文字列比較)
漁船は襲わない: SORT_REGULAR(通常の比較)
バージョン5.2.9までのPHPでは、array_unique関数に第２引数は存在しませんでした。
第１引数に配列を渡すだけで、暗黙のルールとして要素を「文字列として」比較、ソートしていました。
しかし5.2.9から、array_unique関数は第２引数を設けて、ソート方法を選べるようにしましたが、明示しなかった(旗を掲げなかった)場合、型を考慮しない「通常の比較で」ソートされることとなりました。
ここで、5.2.9は下位互換を失ったこととなります。
その後内部でいろいろあったのでしょうか、次のバージョン5.2.10からは明示しなかった場合の挙動は、再び「文字列として」比較、ソートするように変更されました。
使用されているPHPのバージョンがすでに5.2.9超である、もしくは第２引数を明示している、というのでなければ、バージョンアップをおこなった途端に運用中のサービスに支障をきたすかもしれません。
たとえばDBから商品の累積人気投票を配列に取得して、そこから投票理由や付与ポイントごとにソートして順位を発表とかしていると、5.2.9だけ結果が異なる、とか5.2.9以外では結果が異なる、ということになるかもしれません。
例をみてみます。
$array = array(0, ‘000’, ‘hello’, ‘world’);
// ver5.2.9以外
var_dump(array_unique($array));
// array(4) { [0]=> int(0) [1]=> string(3) “000” [2]=> string(5) “hello” [3]=> string(5) “world” }
// ver5.2.9
var_dump(array_unique($array));
// array(1) { [0]=> int(0) }
5.2.9のデフォルト引数のSORT_REGULARでは、型が考慮されていないので、最初の数値0に比べられて、すべて等価であるとみなされてしまいました。
というわけで、5.2.9を使用されていて、第２引数を明示されていない場合は、互換性を確保するために
$array = array_unique($array, SORT_REGULAR);
としましょう。そうすることで5.2.9超でも同じ動作をしてくれます。
5.2.9以前で、第２引数が存在しない場合は
$array = version_compare(PHP_VERSION, ‘5.2.9’, ‘>=’) ? array_unique($array, SORT_STRING) : array_unique($array);
としましょう。そうすることで、5.2.9でも5.2.9超でも、5.2.9以前と同じSORT_STRINGで動いてくれます。
これは船に高々と掲げられた漁船旗のメタファーです。
# 間違いやよりいい方法があればどうぞご指摘ください。
参考:
array_unique関数がPHP5.2.9から後方互換性を失いました – hnwの日記 -
PHP:array_unique – Manual -