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

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

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

基本的な使い方

INFO_MODULES定数は、PHPの実行環境に関する情報を詳細に表示するphpinfo()関数において、表示される情報の種類を制御するために使用される定数の一つです。この定数を利用することで、phpinfo()関数が、現在PHPに読み込まれているすべてのモジュール（拡張機能）と、それら各モジュールの設定に関する情報のみを出力するように指定できます。

phpinfo()関数は、PHPのバージョン、サーバー情報、PHPの設定項目（php.iniの設定）、環境変数など、多岐にわたる情報を表示しますが、すべてを表示すると情報量が非常に多くなり、必要な情報を見つけるのが困難になる場合があります。そこで、INFO_MODULES定数をphpinfo()関数の第二引数に渡すことにより、特定の情報セットに絞り込むことが可能になります。

具体的には、データベース接続を扱うPDOモジュールや、画像処理を行うGDモジュールなど、PHPが利用している様々な拡張機能が正しくロードされているか、またその設定が期待通りになっているかを迅速に確認したい場合に、この定数が役立ちます。システム開発やデバッグの際、特定の機能が動作しない原因がモジュールの有無や設定にある場合に、このINFO_MODULES定数を使って必要な情報だけを効率的に抽出することで、問題解決の時間を短縮できます。PHP 8の環境でも、この定数はPHP環境の健全性を確認するための重要なツールとして利用されています。

構文(syntax)


1<?php
2phpinfo(INFO_MODULES);
3?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

戻り値なし

戻り値はありません

サンプルコード

PHP INFO_MODULESでモジュール情報を表示する


1<?php
2
3/**
4 * このスクリプトは、PHPの環境設定情報の中から、
5 * 現在有効になっているモジュールとその設定情報のみを表示します。
6 * システムのPHP環境が意図通りに構成されているかを確認する際に役立ちます。
7 *
8 * phpinfo() 関数は、引数として INFO_MODULES 定数を受け取ることで、
9 * モジュール関連の情報に表示を限定します。
10 */
11phpinfo(INFO_MODULES);

このPHPスクリプトは、PHPの環境設定情報の中から、現在有効になっているモジュールとその詳細な設定のみを表示するために使用されます。システムエンジニアを目指す初心者の方にとって、開発環境や本番環境でPHPが意図通りに構成されているかを確認する際に非常に役立つでしょう。

phpinfo() 関数は、PHPのあらゆる環境情報をウェブページとして出力する機能を持っています。通常、引数なしで実行するとPHPのバージョン、設定、サーバー情報など膨大な情報が表示されますが、このサンプルコードのように INFO_MODULES という定数を引数として渡すことで、表示内容をPHPの「モジュール」（拡張機能）に関する情報だけに限定できます。

INFO_MODULES は、phpinfo() 関数に渡すことができる定数の一つで、PHPの「extension」（拡張モジュール）に関する情報、例えばデータベース接続用のモジュールや画像処理用のモジュールなどが、PHP環境に組み込まれており、適切に設定されているかを確認する際に利用します。この定数自体は特定の引数や戻り値を持たず、単に phpinfo() 関数の表示オプションを指定する役割を果たします。phpinfo() 関数も、画面に直接情報を出力するため、特定の戻り値は返しません。これにより、不要な情報を省き、必要なモジュール情報だけを効率的に確認することが可能になります。

このスクリプトはPHPの環境設定に関する詳細な情報を表示するため、セキュリティ上の注意が非常に重要です。phpinfo()関数は、ウェブサーバーの設定やパス、データベース接続情報など、システムの機密情報を含んだ多くの情報を出力する可能性があります。そのため、本番環境でこのスクリプトを公開することは、情報漏洩のリスクを高めますので絶対に避けてください。開発環境や検証環境で一時的に利用する際は、確認後にファイルを速やかに削除するか、アクセス制限をかけるようにしてください。INFO_MODULES定数を引数に指定することで、表示内容をPHPのロードされているモジュール情報に限定し、目的の情報を効率的に確認できますが、基本的なセキュリティリスクは変わりません。