【PHP8.x】MB_ONIGURUMA_VERSION定数の使い方

MB_ONIGURUMA_VERSION定数の使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年03月08日

基本的な使い方

MB_ONIGURUMA_VERSION定数は、PHPのmbstring拡張機能が内部で利用しているOniguruma正規表現ライブラリのバージョンを表す定数です。Onigurumaは、日本語のような多バイト文字を含む文字列を正確かつ効率的に処理するための、非常に強力な正規表現エンジンです。PHPのmbstring拡張機能は、このOnigurumaを基盤として、mb_ereg系の関数をはじめとする、多バイト文字列に関する幅広い機能を提供しています。

この定数を利用することで、開発者は現在プログラムが動作しているPHP環境で使用されているOnigurumaライブラリの正確なバージョン情報を、文字列形式でプログラムから取得できます。これは、特定のバージョンのOnigurumaで追加された機能を利用したい場合や、逆に特定のバージョンに存在する既知のバグを回避するためのコードを記述する際に非常に有用です。また、異なるPHP実行環境間での正規表現処理の互換性を確認したり、予期せぬ挙動の原因を特定したりするデバッグ作業においても、重要な情報源となります。システムエンジニアを目指す方にとって、依存するライブラリのバージョンを把握し、環境による挙動の違いを理解することは、堅牢なシステムを構築する上で不可欠な知識の一つです。

構文(syntax)


1<?php
2echo MB_ONIGURUMA_VERSION;
3?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

MB_ONIGURUMA_VERSION定数は、mb_oniguruma拡張モジュールのバージョン番号を表す文字列を返します。

サンプルコード

PHP mbstringのOnigurumaバージョンを表示する


1<?php
2
3/**
4 * このスクリプトは、PHPのmbstringエクステンションが内部で使用している
5 * Oniguruma正規表現ライブラリのバージョンを出力します。
6 *
7 * MB_ONIGURUMA_VERSION は、そのライブラリのバージョンを表す定数です。
8 * システムエンジニアを目指す初心者の方にとって、PHPがどのような外部ライブラリを
9 * 利用しているかを知る良い例となります。
10 */
11
12// MB_ONIGURUMA_VERSION 定数の値を取得し、出力します。
13// この定数は、PHPのmbstringエクステンションが有効な場合にのみ利用可能です。
14echo "Oniguruma Regular Expression Library Version: " . MB_ONIGURUMA_VERSION . PHP_EOL;
15

このPHPスクリプトは、PHPのmbstringエクステンションが内部で利用しているOniguruma正規表現ライブラリのバージョン情報を取得し、表示するものです。MB_ONIGURUMA_VERSIONは、Oniguruma正規表現ライブラリの具体的なバージョンを表すPHPの定数です。この定数には引数はなく、現在のバージョンを示す文字列（string）を直接返します。

Onigurumaは、様々な文字エンコーディングに対応した高度な正規表現機能を提供するオープンソースライブラリであり、PHPのmbstringエクステンションがマルチバイト文字列の正規表現処理を行う際に活用されています。システムエンジニアを目指す初心者の方々にとって、PHPが単体で全ての機能を提供するわけではなく、このように信頼性の高い外部ライブラリと連携して高度な機能を実現していることを理解する良い例となります。

サンプルコードでは、echo文を使用してMB_ONIGURUMA_VERSION定数の値を直接出力しています。これにより、PHPがどのバージョンのOnigurumaライブラリを使用しているかを簡単に確認できます。この定数は、PHPのmbstringエクステンションがサーバー環境で有効になっている場合にのみ利用可能ですので、ご注意ください。もし有効でない場合、この定数は未定義となり、エラーが発生する可能性があります。

このMB_ONIGURUMA_VERSION定数は、PHPのmbstringエクステンションが有効になっている場合にのみ利用可能です。mbstringが内部で利用するOniguruma正規表現ライブラリのバージョンを示す定数ですので、エクステンションが導入されていない環境ではエラーが発生します。

システムの環境構築や、特定の正規表現の動作がおかしい場合の原因調査、異なる環境間での互換性の確認などに役立ちます。定数が未定義の場合にエラーとならないよう、defined('MB_ONIGURUMA_VERSION')で存在チェックを行うとより安全にコードを利用できます。これは他のエクステンション関連の定数を扱う際にも共通する重要な注意点です。

PHP mbstring Oniguruma バージョン取得


1<?php
2
3/**
4 * このスクリプトは、PHPのmbstring拡張機能が利用するOniguruma正規表現エンジンのバージョン情報を取得し表示します。
5 * MB_ONIGURUMA_VERSION 定数と mb_get_info() 関数を比較することで、
6 * システムエンジニアを目指す初心者が情報の取得方法を理解できるようになります。
7 */
8
9// MB_ONIGURUMA_VERSION 定数からOnigurumaのバージョンを取得し表示します。
10// この定数は、mbstring拡張機能が利用するOnigurumaライブラリのバージョンを直接示します。
11echo "【MB_ONIGURUMA_VERSION 定数によるバージョン情報】" . PHP_EOL;
12echo "Oniguruma バージョン: " . MB_ONIGURUMA_VERSION . PHP_EOL;
13echo PHP_EOL;
14
15// mb_get_info() 関数は、mbstring拡張機能に関する詳細な設定情報を配列として返します。
16// この情報の中には、Onigurumaのバージョンも含まれています（キーは 'onig_version'）。
17echo "【mb_get_info() 関数によるバージョン情報】" . PHP_EOL;
18$mbInfo = mb_get_info();
19
20if (isset($mbInfo['onig_version'])) {
21    echo "mb_get_info()['onig_version'] からのOniguruma バージョン: " . $mbInfo['onig_version'] . PHP_EOL;
22
23    // 定数と関数から取得した値が一致するかどうかを確認します。
24    if ($mbInfo['onig_version'] === MB_ONIGURUMA_VERSION) {
25        echo "=> MB_ONIGURUMA_VERSION 定数と mb_get_info() のバージョン情報は一致しています。" . PHP_EOL;
26    } else {
27        echo "=> MB_ONIGURUMA_VERSION 定数と mb_get_info() のバージョン情報は一致していません。" . PHP_EOL;
28    }
29} else {
30    echo "mb_get_info() から Oniguruma のバージョン情報 ('onig_version' キー) を取得できませんでした。" . PHP_EOL;
31}
32
33?>

このPHPスクリプトは、多バイト文字列を扱うmbstring拡張機能が利用するOniguruma正規表現エンジンのバージョン情報を取得し、その方法を比較して示しています。

まず、MB_ONIGURUMA_VERSION定数を使用してOnigurumaのバージョン情報を直接取得します。この定数は引数を取らず、mbstring拡張機能が内部で使用するOnigurumaライブラリのバージョンを文字列として返します。これはOnigurumaのバージョンを確認する最も直接的な方法です。

次に、mb_get_info()関数を利用してバージョン情報を取得します。この関数も引数はなく、mbstring拡張機能に関するさまざまな設定情報を連想配列として返します。返される配列の中には、Onigurumaのバージョン情報が'onig_version'というキーで含まれています。

コードでは、これら二つの方法で取得したOnigurumaのバージョン情報が一致するかどうかを確認し、その結果を表示しています。これにより、システムエンジニアを目指す初心者は、PHPの拡張機能に関連するライブラリのバージョンを、定数と関数という異なるアプローチで確認する方法を学ぶことができます。

MB_ONIGURUMA_VERSIONは、mbstring拡張機能が利用するOniguruma正規表現エンジンのバージョンを直接示す定数です。一方、mb_get_info()関数は、mbstring拡張機能に関する多様な設定情報を配列として返します。この配列からOnigurumaのバージョンを取得する際は、キーが存在するかをisset()で必ず確認してください。キーが存在しない場合に直接アクセスするとエラーとなる可能性があります。定数と関数で同じバージョン情報を取得できますが、関数はより多くの情報を網羅的に取得したい場合に便利です。これらの機能は、PHPのmbstring拡張機能が有効な環境でのみ利用可能ですので、PHPの設定をご確認ください。