萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP extension_loaded() 函數詳解:檢查擴展載入狀態與查看已載入模組

前言

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(); // 降級到檔案快取
}
?>

查看已載入擴展的多種方法

1. 命令列(最快)

$ 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

2. PHP 代碼獲取

<?php
// 獲取所有載入擴展
$extensions = get_loaded_extensions();
print_r($extensions);

// 檢查特定擴展版本
if (extension_loaded('redis')) {
    echo 'Redis 版本: ' . phpversion('redis') . "\n";
}

// 顯示所有擴展詳細資訊
phpinfo(INFO_MODULES); // 僅顯示模組資訊
?>

3. phpinfo() 完整頁面

<?php phpinfo(); ?>

在瀏覽器訪問,搜尋 "Loaded Configuration File" 確認 php.ini 路徑,查看 "Registered PHP Streams"、"Registered Stream Socket Transports" 等。

動態載入 dl() 限制與替代

  • dl() 已在 PHP 5.3+ 移除於多線程 SAPI(Apache mod_php、PHP-FPM),僅 CLI/CGI/Embed SAPI 可用。
  • 生產環境請直接修改 php.ini extension=xxx 並重啟 PHP-FPM/Apache。
  • Docker 環境建議構建映像時安裝擴展:docker-php-ext-install gd pdo_mysql redis。

常見擴展名稱對照表

功能擴展名稱備註
MySQL 改良版驅動mysqli推薦替代舊 mysql 擴展
PDO MySQLpdo_mysql資料庫抽象層
Redisredisphpredis 擴展,非 predis 庫
JSONjsonPHP 5.2+ 內建,不可卸載
多位元組字串mbstring中文處理必裝
圖像處理gd / imagickimagick 功能更強
加密擴展openssl / sodiumsodium 為現代加密庫
壓縮zip / zlib / bz2
異步/多進程pcntl / swooleswoole 為協程框架
copyright © 萬盛學電腦網 all rights reserved