【PHP8.x】version_compare関数の使い方

Copy
1<?php
2
3/**
4 * PHPのバージョン比較関数 `version_compare` の使い方をデモンストレーションします。
5 * システム要件の確認や、ソフトウェアのアップデート有無の判定などに応用できます。
6 */
7function demonstrateVersionComparison(): void
8{
9    // 現在のソフトウェアバージョンを想定
10    $currentSoftwareVersion = '8.1.5';
11    // 比較対象となる要件バージョンまたは最新バージョンを想定
12    $requiredMinimumVersion = '8.0.0';
13    $latestStableVersion = '8.2.10';
14    $specificTargetVersion = '8.1.5';
15
16    echo "--- バージョン比較のデモンストレーション ---\n";
17    echo "現在のバージョン: " . $currentSoftwareVersion . "\n";
18    echo "要求される最低バージョン: " . $requiredMinimumVersion . "\n";
19    echo "最新安定バージョン: " . $latestStableVersion . "\n";
20    echo "特定のターゲットバージョン: " . $specificTargetVersion . "\n\n";
21
22    // 1. オペレータを指定して真偽値 (bool) で比較する (一般的な使い方)
23
24    // 現在のバージョンが必要最低バージョン以上か確認
25    // '>=' 演算子を使用し、真偽値 (true/false) を返します。
26    if (version_compare($currentSoftwareVersion, $requiredMinimumVersion, '>=')) {
27        echo "✅ ({$currentSoftwareVersion}) は、要求される最低バージョン ({$requiredMinimumVersion}) 以上です。\n";
28    } else {
29        echo "❌ ({$currentSoftwareVersion}) は、要求される最低バージョン ({$requiredMinimumVersion}) 未満です。\n";
30    }
31
32    // 最新バージョンにアップデートが必要か確認 (現在のバージョンが最新より古いか)
33    // '<' 演算子を使用し、真偽値 (true/false) を返します。
34    if (version_compare($currentSoftwareVersion, $latestStableVersion, '<')) {
35        echo "⚠️ ({$currentSoftwareVersion}) は、最新安定バージョン ({$latestStableVersion}) より古いため、アップデートを推奨します。\n";
36    } else {
37        echo "✅ ({$currentSoftwareVersion}) は、最新安定バージョン ({$latestStableVersion}) と同等か、それ以上です。\n";
38    }
39
40    // 特定のバージョンと完全に一致するか確認
41    // '==' 演算子を使用し、真偽値 (true/false) を返します。
42    if (version_compare($currentSoftwareVersion, $specificTargetVersion, '==')) {
43        echo "✅ ({$currentSoftwareVersion}) は、特定のターゲットバージョン ({$specificTargetVersion}) と完全に一致します。\n";
44    } else {
45        echo "❌ ({$currentSoftwareVersion}) は、特定のターゲットバージョン ({$specificTargetVersion}) と一致しません。\n";
46    }
47
48    echo "\n";
49
50    // 2. オペレータを指定せずに整数値 (int) で比較する (より詳細な比較が必要な場合)
51    // 戻り値:
52    //   -1: version1 が version2 より小さい
53    //    0: version1 と version2 が等しい
54    //    1: version1 が version2 より大きい
55
56    $comparisonResultAgainstLatest = version_compare($currentSoftwareVersion, $latestStableVersion);
57    echo "{$currentSoftwareVersion} と {$latestStableVersion} の比較結果 (整数値): {$comparisonResultAgainstLatest}\n";
58
59    if ($comparisonResultAgainstLatest < 0) {
60        echo "   -> 結果は -1: {$currentSoftwareVersion} は {$latestStableVersion} より古いです。\n";
61    } elseif ($comparisonResultAgainstLatest === 0) {
62        echo "   -> 結果は 0: {$currentSoftwareVersion} と {$latestStableVersion} は同じです。\n";
63    } else { // $comparisonResultAgainstLatest > 0
64        echo "   -> 結果は 1: {$currentSoftwareVersion} は {$latestStableVersion} より新しいです。\n";
65    }
66
67    $comparisonResultAgainstSpecific = version_compare($currentSoftwareVersion, $specificTargetVersion);
68    echo "{$currentSoftwareVersion} と {$specificTargetVersion} の比較結果 (整数値): {$comparisonResultAgainstSpecific}\n";
69    if ($comparisonResultAgainstSpecific === 0) {
70        echo "   -> 結果は 0: {$currentSoftwareVersion} と {$specificTargetVersion} は同じです。\n";
71    }
72
73    echo "\n--- デモンストレーション終了 ---\n";
74}
75
76// 関数を実行してバージョン比較の例を表示します
77demonstrateVersionComparison();
78
79?>

PHPのversion_compare関数は、二つのバージョン文字列を正確に比較するために使用されます。システムの要件確認や、ソフトウェアのバージョンアップが必要かどうかの判定など、バージョン管理が重要な場面で非常に役立ちます。

この関数は、比較したいバージョン文字列を$version1と$version2として受け取ります。さらに、オプションで$operator引数に'==', '>', '<', '>='といった比較演算子を指定できます。

$operatorを指定した場合、比較結果が真であればtrue、偽であればfalseという真偽値（bool）が戻り値となります。これにより、「現在のバージョンが特定のバージョン以上か」といった条件を直接判定できます。

一方、$operatorを省略した場合、$version1が$version2より小さい場合は-1、等しい場合は0、大きい場合は1という整数値（int）が戻り値として返されます。この整数値を利用することで、より詳細なバージョンの大小関係に基づいて処理を分岐させることが可能です。

サンプルコードでは、現在のソフトウェアバージョンを例にとり、要求される最低バージョン、最新安定バージョンなどと比較する具体的な利用例を示しています。オペレータを指定してtrue/falseで比較する方法と、オペレータを省略して整数値でより詳細な比較を行う方法の両方が示されており、この関数の柔軟な使い方を学ぶことができます。