Windows版PHPで拡張DLLを読み込めないときの原因と確認手順
作成日:2026.11.17
Windows版PHPで「Unable to load dynamic library」が出るときの確認手順を解説します。実行中のPHPとphp.ini、拡張DLLの配置先・互換条件・依存DLLを順に確認。intl拡張の検証例を通じて、DLL本体が存在しても読み込めない場合や、終了コードが0でも読み込みに失敗する場合を紹介します。
目次
Windows版PHPでphp.iniのextensionを有効にしたのに、Unable to load dynamic libraryという警告が出て、拡張を使えないときの対処法をまとめました。
こういうときは、実行しているPHPと設定ファイルを特定し、警告に出ているパス、DLLの互換条件、依存DLLを順に確認します。「指定されたモジュールが見つかりません」と出ても、拡張DLL本体がないとは限りません。
今回は、確認の順序と、intl拡張を使った正常・失敗の比較をまとめます。PHP更新時の設定移行全体については、php.iniを移行するときの確認項目を参照してください。
拡張DLLだけでなく、その依存先も必要
extension=intlのような設定は、PHPに拡張を読み込ませる指定です。Windowsでは、拡張DLLの配置先をextension_dirで指定します。ただし、そこにDLLがあれば必ず読み込める、というわけではありません。
拡張DLLは、PHPの版・TS/NTS・x86/x64などの条件に合っている必要があります。また、拡張が別のDLLを必要としていれば、その依存先も読み込める状態でなければなりません。extension_dirは拡張の配置先なので、そこを正しく指定するだけで依存DLLの問題まで解消するとは限らないのですね。
PHP公式でも、Windows版拡張のトラブルシューティングで、DLLと依存先の場所、extension_dir、ビルド条件を確認するよう案内しています。
なお、この記事は通常のPHP拡張が対象です。XdebugやOPcacheなど、zend_extensionで指定するZend拡張は、それぞれの導入手順を確認してください。
最初に、使っているPHPとphp.iniを特定する
PowerShellでは、まず次のようにCLIの環境を確認します。
Get-Command php -CommandType Application | Select-Object -ExpandProperty Source
php -v
php --ini
php -m
php --iniのLoaded Configuration Fileが、実際に読み込まれたphp.iniです。Additional .ini files parsedにファイルがあれば、追加の設定も確認します。編集したファイルと読み込まれたファイルが同じか、先に照合しておきましょう。
複数のPHPがある場合は、ここから先は実行ファイルをフルパスで指定すると取り違えを防げます。次のC:/php-test/php.exeは説明用なので、調べたいPHPの場所へ置き換えてください。
$php = 'C:/php-test/php.exe'
$output = & $php -m 2>&1
$exitCode = $LASTEXITCODE
$output
"exit=$exitCode"
警告は途中を省略せずに保存します。tried:以降には、読み込みを試みたパスが出る場合があります。想定外の古いフォルダーを参照していないか、実際のファイル名と合っているかを確認します。
2>&1は標準エラーも一緒に受け取る指定です。今回の後述の検証では警告が標準出力に出ていたため、標準エラーだけを見て「警告なし」と判断しないようにします。
設定、DLLの存在、ビルド条件を順に確認する
設定が読み込まれていることを確認できたら、次の順で絞っていきます。
- 対象の
extensionがコメントアウトされていないか、同じ設定を重複して指定していないか確認する。 extension_dirの有効値と、警告に表示された参照先を確認する。- その場所に対象の拡張DLLがあるか確認する。
- PHPと拡張の版・TS/NTS・アーキテクチャ・コンパイラー等の条件を照合する。
- 拡張が必要とする依存DLLとランタイムを、対象配布物の案内で確認する。
例えば、C:/php-testに用意したPHPでintlを有効にする設定は次のようになります。実際の配置先に合わせて変更してください。
extension_dir="C:/php-test/ext"
extension=intl
この場合、まずC:/php-test/ext/php_intl.dllの存在を調べます。extension=intlという拡張名による指定はPHP 7.2以降で利用でき、PHP公式でも推奨されています。ファイル名での指定も利用できます。
PHP側のビルド情報は、次のように確認できます。
& $php -i | Select-String 'PHP Version =>|Compiler =>|Architecture =>|Thread Safety =>|PHP Extension Build =>'
配布物の表記と照合し、PHP 8.3向けの拡張を別のPHP系列に流用したり、TSとNTS、x86とx64を混ぜたりしないようにします。PHPの選び方は、Windows版PHPのTS・NTSとApacheの接続方式の記事で説明しています。
依存DLLも、同名のファイルを別の環境から拾ってコピーするのではなく、対象PHP・拡張の配布元と対応条件を確認してそろえます。必要なVisual C++ランタイムについては、PHP公式のWindows向け導入条件も確認してください。
intl拡張で、正常時と読み込み失敗を比べる
実際の違いを確認するため、既存のPHPから実行ファイル・DLLを一時フォルダーへコピーし、専用のCLI環境で比較してみました。使用中のphp.iniやPHPの設置先は変更していません。
今回は、php.iniを読み込まない-nと、実行時に設定を指定する-dを組み合わせました。普段の設定の影響を外し、拡張だけを指定して比較するためです。各オプションはPHP公式のCLIオプションを参照してください。
まず、読み込み結果を確認するコードを用意する
次の内容をprobe.phpとして保存します。IntlChar::ord('A')は、intlを読み込んだ後に機能を一つ使えるか確かめるための処理です。成功時は文字Aのコードポイントである65を返します。
<?php
echo 'loaded=', extension_loaded('intl') ? 'yes' : 'no', PHP_EOL;
if (extension_loaded('intl')) {
echo 'ord=', IntlChar::ord('A'), PHP_EOL;
}
PHP一式を別途用意した検証用フォルダーがC:/php-testの場合、PowerShellの実行例は次のようになります。PHP本体だけでなく、同じ配布物の拡張と必要な依存DLLがそろった構成を使います。
$php = 'C:/php-test/php.exe'
& $php -n -d 'extension_dir=C:/php-test/ext' -d extension=intl -f ./probe.php
$exitCode = $LASTEXITCODE
"exit=$exitCode"
正常時の結果です。
loaded=yes
ord=65
exit=0
配置先の誤りと、依存DLL不足を比較する
正常構成から条件を変えて比較した結果は、次のとおりでした。依存DLL不足のケースでは、別の専用コピーに同じphp_intl.dllを置き、PHP直下のicuuc72.dllだけを含めない構成にしています。また、実行プロセスのPATHをWindowsのシステムディレクトリに限定し、元のPHP環境から依存DLLを拾わないようにしました。
| 条件 | 起動時の警告 | 読み込み結果 | 終了コード |
|---|---|---|---|
| extensionを指定しない | なし | loaded=no | 0 |
| 正常な配置先と依存DLL | なし | loaded=yes、ord=65 | 0 |
| extension_dirに空のフォルダーを指定 | Unable to load dynamic library | loaded=no | 0 |
| 存在しない拡張名missing_demoを指定 | Unable to load dynamic library | loaded=no | 0 |
| php_intl.dllは存在するが、icuuc72.dllがない | Unable to load dynamic library | loaded=no | 0 |
| 上の構成に、同じ正常構成のicuuc72.dllを戻す | なし | loaded=yes、ord=65 | 0 |
依存DLL不足の警告から、パスを説明用に置き換えて抜粋すると、次のようになります。
Warning: PHP Startup: Unable to load dynamic library 'intl'
(tried: C:\php-test\ext\intl (指定されたモジュールが見つかりません。),
C:\php-test\ext\php_intl.dll (指定されたモジュールが見つかりません。))
in Unknown on line 0
php_intl.dll本体は存在していても、「指定されたモジュールが見つかりません」と出ています。配置先を間違えた場合も同じ文言だったため、このメッセージだけで「拡張DLL本体がない」とは判断できません。
また、試行先としてintlとphp_intl.dllの両方が出ていますが、2個とも用意する必要があるという意味ではありません。PHPが拡張名から候補を試している表示です。
intlはICUライブラリを利用しますが、icuuc72.dllというファイル名は今回の配布物のものです。他の版にもこのファイル名をそのまま当てはめず、利用する配布物を確認してください。intlとICUの関係は、intlの要件に記載されています。
そして、今回は読み込みに失敗しても、コードが最後まで進み、終了コードは0でした。probe.phpは読み込み結果を表示する診断用コードなので、失敗時に非0で終了させる処理は入れていません。自動チェックで使う場合は、必要な拡張が未読込なら明示的に非0で終了するなど、判定を組み込みます。
この比較で実測したのは、設定なし、配置先の誤り、存在しない拡張名、依存DLL不足とその復旧です。TS/NTS・PHP系列・x86/x64の不一致については組み替え検証をしていないため、特定の警告文との対応までは断定しません。
CLIとApacheは別々に確認する
CLIで読み込めるようになっても、Apacheが同じPHPや設定を使っているとは限りません。確認用のPHPファイルでは、次のように実行環境と設定の有効値を表示できます。
<?php
if (PHP_SAPI !== 'cli') {
header('Content-Type: text/plain; charset=UTF-8');
}
echo 'PHP: ', PHP_VERSION, PHP_EOL;
echo 'SAPI: ', PHP_SAPI, PHP_EOL;
echo 'Build: ', PHP_ZTS ? 'TS' : 'NTS', PHP_EOL;
echo 'INI: ', php_ini_loaded_file() ?: '(none)', PHP_EOL;
echo 'Additional INI: ', php_ini_scanned_files() ?: '(none)', PHP_EOL;
echo 'extension_dir: ', ini_get('extension_dir'), PHP_EOL;
echo 'intl: ', extension_loaded('intl') ? 'loaded' : 'not loaded', PHP_EOL;
CLIで保存したファイルを実行した結果と、外部からアクセスできないローカルの検証用サイトでApacheを通して開いた結果を比べます。Apacheモジュール方式ならSAPIはapache2handlerとなるのが期待値です。FastCGI等の構成では値が異なるため、接続方式と合わせて見ます。
読み込み失敗のログは、Apacheの設定で指定されたErrorLogなどを確認します。ログの場所を一律に決めつけず、起動直後やリクエスト時に出ている警告を確認してください。Apache自体が起動できないなら、Web側の診断コードへ進む前に起動ログを読みます。
PHPの設定は起動時に読み込まれます。CLIは実行し直して確認し、Apacheモジュール方式では設定を反映するためにWebサーバーの再起動が必要です。FastCGIの構成ではPHPプロセス側の再起動方法を確認します。PHP公式の設定ファイルの説明も参照してください。
今回、診断コードはCLIで実行と構文を確認しましたが、Apache経由での実行・再起動・ログ比較は行っていません。この節はWeb側の確認手順と期待値です。確認用ファイルはパス等の情報を出すので、公開サイトへ置かず、確認後は削除してください。
修正後は、読み込みと実際の機能まで確認する
修正後は、警告が消えたこと、php -mやextension_loaded()で対象拡張が読み込まれていること、アプリケーションが必要とする最小限の機能が使えることを確認します。今回なら、依存DLLをそろえた後にloaded=yesとord=65へ戻るところまで確認しています。
「DLLがある」「終了コードが0だった」だけでは、拡張の読み込み成功とは限りません。エラー全文を残し、実行しているPHPと設定、拡張DLLと依存先を順に照合すると、むやみにDLLを入れ替えるより原因を追いやすくなるかと思います。
奈良市を拠点に、27年以上の経験を持つフリーランスWebエンジニア、阿部辰也です。
これまで、ECサイトのバックエンド開発や業務効率化システム、公共施設の予約システムなど、多彩なプロジェクトを手がけ、企業様や制作会社様のパートナーとして信頼を築いてまいりました。
【制作会社・企業様向けサポート】
Webシステムの開発やサイト改善でお困りの際は、どうぞお気軽にご相談ください。小さな疑問から大規模プロジェクトまで、最適なご提案を心を込めてさせていただきます。
ぜひ、プロフィールやWeb制作会社様向け業務案内、一般企業様向け業務案内もご覧くださいね。
XAMPPのPHP更新時にphp.iniをどう移行する? 引き継ぐ設定と確認方法
2026.11.12
XAMPPでPHPを更新する際のphp.iniの移行方法を解説します。旧設定と新しい設定例を比較し、引き継ぐ項目や変更が必要な項目を整理。拡張・パス・エラー出力・アップロード・セッションなどの注意点と、CLI・Apacheそれぞれで設定の反映を確認する方法を紹介します。
PHPでフリガナ欄の入力を検証する:全角ハイフン・長音・カタカナの扱い
2026.11.11
住所のフリガナ欄で、全角ハイフンを入力したつもりなのにエラーになることがあります。見た目が似たハイフンや長音の違いを確認し、PHPでカナや英数字を変換してから検証する方法を紹介します。入力を保持したエラー表示や、変換後の値を確認する方法も解説します。
ChatGPTからPHP製MCPへOAuth接続する:Auth0・XServerでつまずいた点と対処法
2026.11.10
PHP製MCPにAuth0のOAuth認証を追加し、ChatGPTから接続した際の記録です。OAuth設定の検出、APIへの権限付与、ログイン後のツール検出失敗を順に切り分け、最後に原因となったAuthorizationヘッダーの伝達問題と対処法を紹介します。
mPDFでPDFが開けない・出力できないときの確認方法:BOM・空白・警告を切り分ける
2026.11.07
mPDFで出力済みエラーが出たり、PDFが開けなかったりするときに、生成処理とHTTPでの返却を分けて原因を調べる方法を紹介します。BOM・空白・デバッグ出力・PHP警告の混入を比較し、出力バッファーやdebug設定による違い、ログで出力元を特定する手順を解説します。