標題：WP-CLI 安裝、使用與常見錯誤處理指南
描述：從安裝到實戰經驗的完整指南，包含常見問題的解決方案
最後更新：2025-07-08
版本：v2.0
作者：rj0217
來源：COVIA官方知識
WP-CLI 安裝、使用與常見錯誤處理指南（更新版）
前言
WP-CLI 是 WordPress 官方提供的命令列工具，可以使用簡潔的 CLI 指令，管理、維護、變更 WordPress 系統。本指南結合了實戰經驗，涵蓋從安裝到常見問題處理的完整流程。
1. WP-CLI 安裝流程
環境準備
- Linux/Unix/macOS：直接在終端機執行安裝命令
- Windows：需要使用 WSL (Windows Subsystem for Linux)
# 在 PowerShell 中，可以使用以下命令安裝 WSL
# wsl --install
手動下載與安裝
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
確認安裝成功
wp --info
安裝必要依賴
WP-CLI 需要 PHP 和相關擴展才能正常工作：
# 安裝 PHP 及必要擴展
sudo apt update
sudo apt install php php-cli php-curl php-mbstring php-xml php-zip
# WordPress 需要 MySQL 擴展
sudo apt install php-mysql
# 檢查 PHP 安裝
php -v
2. 資料庫設定
安裝 MySQL
# 安裝 MySQL 服務器
sudo apt install mysql-server
# 啟動 MySQL 服務
sudo service mysql start
# 如果出現無法啟動的錯誤，嘗試修復用戶目錄問題
sudo mkdir -p /var/lib/mysql/
sudo chown -R mysql:mysql /var/lib/mysql/
sudo mysqld --initialize
sudo service mysql restart
建立資料庫和用戶
# 登入 MySQL
sudo mysql
# 在 MySQL 中執行
CREATE DATABASE wordpress_db;
CREATE USER 'wp_user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON wordpress_db.* TO 'wp_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
3. WordPress 安裝與設定
下載 WordPress 核心
wp core download
創建配置文件
wp config create --dbname=wordpress_db --dbuser=wp_user --dbpass=password --dbhost=127.0.0.1
安裝 WordPress
wp core install --url=http://localhost:8080 --title="網站標題" --admin_user=admin --admin_password=secure_password [email protected]
啟動開發伺服器
wp server
預設在 http://localhost:8080 運行
4. 常見錯誤處理
錯誤：Windows PowerShell 中的 curl 命令不同
原因： PowerShell 中的 curl 實際上是 Invoke-WebRequest 的別名。
解決： 在 WSL 環境中執行命令或在 PowerShell 中使用 curl.exe：
curl.exe -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
錯誤：缺少 PHP 或 PHP 擴展
錯誤訊息： /usr/bin/env: 'php': No such file or directory 或 Call to undefined function mysqli_init()
解決： 安裝必要的 PHP 和擴展：
sudo apt install php php-cli php-mysql php-curl php-mbstring php-xml php-zip
錯誤：MySQL 服務無法啟動
錯誤訊息： cannot change directory to /nonexistent: No such file or directory
解決： 修復用戶目錄問題：
sudo mkdir -p /var/lib/mysql/
sudo chown -R mysql:mysql /var/lib/mysql/
sudo mysqld --initialize
錯誤：無法連接到資料庫
錯誤訊息： Database connection error (2002) No such file or directory
解決： 確保 MySQL 已安裝且正在運行：
sudo service mysql status
sudo service mysql start
錯誤：無法訪問 WordPress 後台
原因： 永久鏈接結構或站點 URL 設置不正確。
解決： 設置正確的永久鏈接和 URL：
wp option update permalink_structure '/%postname%/'
wp option update siteurl 'http://localhost:8080'
wp option update home 'http://localhost:8080'
錯誤：不允許以 root 身份執行
原因： WP-CLI 默認為了保護系統安全，不允許 root 身份執行。
解決： 加上 --allow-root：
wp <command> --allow-root
5. 實用 WP-CLI 命令
網站管理
# 更新 WordPress 核心
wp core update
# 檢查 WordPress 安裝狀態
wp core is-installed
# 更新語言包
wp language core update
插件和主題管理
# 安裝並啟用插件
wp plugin install contact-form-7 --activate
# 更新所有插件
wp plugin update --all
# 安裝並啟用主題
wp theme install twentytwentyfour --activate
# 使用自製主題
wp theme activate 你的主題名稱
用戶管理
# 列出所有用戶
wp user list
# 創建新用戶
wp user create newuser [email protected] --role=editor
# 更新用戶密碼
wp user update admin --user_pass=新密碼
內容管理
# 創建頁面
wp post create --post_type=page --post_title='關於我們' --post_status=publish
# 生成測試內容
wp post generate --count=10 --post_type=post
資料庫管理
# 導出資料庫
wp db export backup.sql
# 導入資料庫
wp db import backup.sql
# 優化資料庫
wp db optimize
6. 結論
WP-CLI 大幅簡化了 WordPress 管理操作，特別適合開發者和系統管理員使用。通過本指南的實戰經驗，你可以避免常見的環境配置問題，高效地使用命令列工具管理 WordPress 網站。在不同環境（如 WSL、Docker）中使用時，需注意相應的設定調整以確保工具正常運行。
文檔迭代紀錄
協作夥伴戳記
- 向前待考察
- 2025/07/08 Claude 3.7 sonnet 24f79746-2cb6-4864-91bb-6ec19ad47d11