extension_loaded() 是 PHP 核心函數,用於檢查指定擴展是否已載入,常用於條件載入、相容性檢查、優雅降級。本文詳細說明用法、配合 dl() 動態載入、以及多種查看已載入擴展的方法。
bool extension_loaded(string $name): bool
參數為擴展名稱(不區分大小寫,如 gd、pdo_mysql、json)。
<?php
// 檢查 GD 庫是否可用
if (!extension_loaded('gd')) {
// 嘗試動態載入(僅 CLI/CGI 模式支援,php.ini 需 enable_dl=On)
if (!dl('gd.so')) { // Windows 為 php_gd.dll
die('GD 擴展不可用,無法生成驗證碼圖片');
}
}
// 實際業務:根據擴展選擇不同實作
if (extension_loaded('redis')) {
$cache = new RedisCache();
} elseif (extension_loaded('memcached')) {
$cache = new MemcachedCache();
} else {
$cache = new FileCache(); // 降級到檔案快取
}
?>
$ php -m
[PHP Modules]
bcmath
bz2
calendar
Core
ctype
curl
date
dom
exif
fileinfo
filter
ftp
gd
gettext
hash
iconv
igbinary
json
libxml
mbstring
mysqli
mysqlnd
openssl
pcntl
pcre
PDO
pdo_mysql
pdo_sqlite
Phar
posix
readline
redis
Reflection
session
shmop
SimpleXML
soap
sockets
sodium
SPL
sqlite3
standard
tokenizer
xml
xmlreader
xmlwriter
xsl
Zend OPcache
zip
zlib
[Zend Modules]
Zend OPcache
<?php
// 獲取所有載入擴展
$extensions = get_loaded_extensions();
print_r($extensions);
// 檢查特定擴展版本
if (extension_loaded('redis')) {
echo 'Redis 版本: ' . phpversion('redis') . "\n";
}
// 顯示所有擴展詳細資訊
phpinfo(INFO_MODULES); // 僅顯示模組資訊
?>
<?php phpinfo(); ?>
在瀏覽器訪問,搜尋 "Loaded Configuration File" 確認 php.ini 路徑,查看 "Registered PHP Streams"、"Registered Stream Socket Transports" 等。
dl() 已在 PHP 5.3+ 移除於多線程 SAPI(Apache mod_php、PHP-FPM),僅 CLI/CGI/Embed SAPI 可用。php.ini extension=xxx 並重啟 PHP-FPM/Apache。docker-php-ext-install gd pdo_mysql redis。| 功能 | 擴展名稱 | 備註 |
|---|---|---|
| MySQL 改良版驅動 | mysqli | 推薦替代舊 mysql 擴展 |
| PDO MySQL | pdo_mysql | 資料庫抽象層 |
| Redis | redis | phpredis 擴展,非 predis 庫 |
| JSON | json | PHP 5.2+ 內建,不可卸載 |
| 多位元組字串 | mbstring | 中文處理必裝 |
| 圖像處理 | gd / imagick | imagick 功能更強 |
| 加密擴展 | openssl / sodium | sodium 為現代加密庫 |
| 壓縮 | zip / zlib / bz2 | |
| 異步/多進程 | pcntl / swoole | swoole 為協程框架 |