1. 引言：為何需要 PHP Redis 擴(kuò)展

在 PHP 開發(fā)中，與 Redis 緩存或數(shù)據(jù)存儲(chǔ)進(jìn)行交互是常見的需求。雖然可以使用如 Predis 這樣的純 PHP 客戶端庫，但直接安裝 PHP Redis 擴(kuò)展（ext-redis）通常能提供更好的性能、更豐富的功能以及更底層的操作能力。當(dāng)您的 Composer 項(xiàng)目提示 "Root composer.json requires PHP extension ext-redis * but it is missing from your system" 或您發(fā)現(xiàn) WAMP/MAMP 菜單中缺少 Redis 擴(kuò)展選項(xiàng)時(shí)，這意味著您需要正確安裝并啟用此擴(kuò)展。本教程將引導(dǎo)您完成這一過程，尤其適用于 PHP 7.4 及更高版本。

2. 環(huán)境準(zhǔn)備與先決條件

在開始安裝之前，請(qǐng)確保您的系統(tǒng)滿足以下條件：

• PHP 版本： 本教程以 PHP 7.4 為例，但步驟同樣適用于其他 PHP 7.x 或 8.x 版本。
• PHP 開發(fā)工具： 您需要安裝 PHP 的開發(fā)頭文件和工具，例如 phpize。
  • Debian/Ubuntu: sudo apt update && sudo apt install php-dev (或 php7.4-dev 等特定版本)
  • CentOS/RHEL: sudo yum install php-devel (或 php74-devel 等特定版本)
  • macOS (使用 Homebrew): brew install autoconf (通常隨 PHP 安裝)
• Redis 服務(wù)器： 確保您的系統(tǒng)上已安裝并運(yùn)行 Redis 服務(wù)器。如果尚未安裝，您可以參考以下命令（以編譯安裝為例）：

  mkdir redis && cd redis
  curl -O http://download.redis.io/redis-stable.tar.gz
  tar xzvf redis-stable.tar.gz
  cd redis-stable
  make
  make test # 可選，運(yùn)行測(cè)試
  sudo make install # 安裝 Redis 服務(wù)器

  登錄后復(fù)制

  請(qǐng)注意，上述步驟安裝的是 Redis 服務(wù)器，而不是 PHP 擴(kuò)展。

3. 安裝 PHP Redis 擴(kuò)展

有兩種主要方法可以安裝 PHP Redis 擴(kuò)展：使用 PECL（PHP 擴(kuò)展社區(qū)庫）或手動(dòng)從源代碼編譯。

立即學(xué)習(xí)“PHP免費(fèi)學(xué)習(xí)筆記（深入）”；

3.1 方法一：使用 PECL (推薦)

PECL 是安裝 PHP 擴(kuò)展最簡單和推薦的方式。

1. 安裝 PECL (如果尚未安裝): 在大多數(shù) Linux 發(fā)行版上，PECL 通常與 php-dev 或 php-pear 包一起安裝。如果 pecl 命令不可用，您可能需要手動(dòng)安裝 PEAR 和 PECL。

   sudo apt install php-pear # Debian/Ubuntu
   sudo yum install php-pear # CentOS/RHEL

   登錄后復(fù)制

2. 通過 PECL 安裝 Redis 擴(kuò)展: 執(zhí)行以下命令來安裝 Redis 擴(kuò)展：

   sudo pecl install redis

   登錄后復(fù)制

   在安裝過程中，可能會(huì)詢問一些配置選項(xiàng)。通常情況下，直接按 Enter 鍵接受默認(rèn)值即可。

   • 常見問題： 如果遇到編譯錯(cuò)誤，通常是缺少 php-dev 包或相關(guān)的編譯器工具（如 gcc）。請(qǐng)確保您的開發(fā)工具已正確安裝。

3.2 方法二：手動(dòng)從源代碼編譯 (備選)

如果 PECL 安裝失敗或您需要特定版本的擴(kuò)展，可以手動(dòng)編譯。

1. 下載 Redis 擴(kuò)展源代碼: 訪問 PECL 官網(wǎng)的 Redis 頁面 下載最新或指定版本的 .tgz 文件。

   wget https://pecl.php.net/get/redis-5.3.7.tgz # 替換為最新版本號(hào)

   登錄后復(fù)制

2. 解壓并進(jìn)入目錄:

   tar xzvf redis-5.3.7.tgz
   cd redis-5.3.7

   登錄后復(fù)制

3. 準(zhǔn)備編譯: 使用 phpize 工具為當(dāng)前 PHP 版本準(zhǔn)備編譯環(huán)境。

   phpize

   登錄后復(fù)制

   如果 phpize 命令未找到，請(qǐng)檢查您的 php-dev 包是否已安裝且 phpize 在 PATH 中。

4. 配置、編譯和安裝:

   

   如知AI筆記

   如知筆記——支持markdown的在線筆記，支持ai智能寫作、AI搜索，支持DeepseekR1滿血大模型

   27

   查看詳情

   ./configure
   make
   sudo make install

   登錄后復(fù)制

   make install 命令會(huì)將編譯好的 redis.so (或 redis.dll 在 Windows 上) 文件放置到 PHP 擴(kuò)展目錄中。

4. 啟用 PHP Redis 擴(kuò)展

安裝完成后，您需要告訴 PHP 加載這個(gè)新安裝的擴(kuò)展。

1. 定位 php.ini 文件: PHP 可能有多個(gè) php.ini 文件，例如一個(gè)用于 CLI (命令行界面)，一個(gè)用于 Web 服務(wù)器 (如 Apache、Nginx 或 PHP-FPM)。您需要編輯 Web 服務(wù)器使用的那個(gè)。 要查找當(dāng)前 PHP 配置使用的 php.ini 文件路徑，可以運(yùn)行：

   php --ini

   登錄后復(fù)制

   或者創(chuàng)建一個(gè)包含 <?php phpinfo(); ?> 的 PHP 文件，通過瀏覽器訪問它，查找 "Loaded Configuration File" 條目。

2. 編輯 php.ini 文件: 使用文本編輯器打開找到的 php.ini 文件，并在文件末尾或擴(kuò)展部分添加以下行：

   extension=redis.so

   登錄后復(fù)制
   • Windows 用戶注意： 如果您在 Windows 環(huán)境下使用 WAMP/XAMPP，通常是 extension=redis.dll，并且您可能需要將下載的 redis.dll 文件手動(dòng)放置到 PHP 的 ext 目錄下。

5. 重啟服務(wù)

為了讓 PHP 加載新的配置和擴(kuò)展，您必須重啟相關(guān)的服務(wù)。

• Apache:

  sudo service apache2 restart # Debian/Ubuntu
  sudo systemctl restart httpd # CentOS/RHEL

  登錄后復(fù)制
• Nginx 和 PHP-FPM:

  sudo service nginx restart
  sudo service php7.4-fpm restart # 替換為您的 PHP-FPM 版本

  登錄后復(fù)制
• WAMP/MAMP/XAMPP: 通過其控制面板或菜單重啟所有服務(wù)。

6. 驗(yàn)證安裝

安裝并重啟服務(wù)后，務(wù)必驗(yàn)證 Redis 擴(kuò)展是否已成功加載。

1. 通過命令行驗(yàn)證:

   php -m | grep redis

   登錄后復(fù)制

   如果輸出中包含 redis，則表示擴(kuò)展已加載。

2. 通過 phpinfo() 驗(yàn)證: 再次訪問包含 <?php phpinfo(); ?> 的 PHP 頁面。在輸出中搜索 "redis" 部分。如果找到，表示擴(kuò)展已成功啟用，并會(huì)顯示其版本和配置信息。

7. 故障排除與注意事項(xiàng)

• "Unable to load dynamic library" 錯(cuò)誤： 這通常意味著 redis.so 文件不存在、路徑不正確，或者編譯的擴(kuò)展與當(dāng)前 PHP 版本不兼容。請(qǐng)檢查 php.ini 中的 extension_dir 配置，并確保 redis.so 位于該目錄或指定了完整路徑。
• WAMP/MAMP 菜單未顯示： 在 Windows 環(huán)境下，確保 redis.dll 文件已正確放置在 PHP 的 ext 目錄下，并且 php.ini 文件中已添加 extension=redis.dll。WAMP/MAMP 通常有自己的 PHP 版本管理，確保您修改的是當(dāng)前激活 PHP 版本的 php.ini。
• PHP 版本兼容性： 確保您下載或編譯的 Redis 擴(kuò)展版本與您的 PHP 版本兼容。PECL 通常會(huì)自動(dòng)處理兼容性問題。
• 權(quán)限問題： 確保 make install 命令使用 sudo 運(yùn)行，以避免權(quán)限不足導(dǎo)致文件無法寫入擴(kuò)展目錄。
• 多個(gè) php.ini 文件： 始終通過 php --ini 或 phpinfo() 確認(rèn)您正在編輯正確的 php.ini 文件。

8. 總結(jié)

正確安裝和啟用 PHP Redis 擴(kuò)展是優(yōu)化 PHP 應(yīng)用程序與 Redis 交互的關(guān)鍵一步。通過遵循本教程中的 PECL 或手動(dòng)編譯方法，并仔細(xì)配置 php.ini 文件，您可以成功解決 "ext-redis is missing" 的問題，并充分利用 Redis 帶來的性能優(yōu)勢(shì)。記得在任何配置更改后重啟您的 Web 服務(wù)器或 PHP-FPM 服務(wù)，并驗(yàn)證擴(kuò)展是否已成功加載。

以上就是如何安裝和啟用 PHP Redis 擴(kuò)展的詳細(xì)內(nèi)容，更多請(qǐng)關(guān)注php中文網(wǎng)其它相關(guān)文章！