התקנה ושימוש ב-WP-CLI ב-Windows

מדריך מלא: מה זה WP-CLI, למה זה נחוץ, איך מתקינים, מגדירים ומשתמשים בו במערכת Windows.

---

מה זה WP-CLI

WP-CLI ‏(WordPress Command Line Interface) הוא כלי שורת פקודה לניהול אתרי WordPress בלי להשתמש בדפדפן.

באמצעותו ניתן:

• להתקין ולעדכן את WordPress,
• לנהל תוספים, תבניות ומשתמשים,
• לבצע חיפוש והחלפה במסד הנתונים,
• לאוטומט משימות בעזרת סקריפטים.

האתר הרשמי: https://wp-cli.org

---

למה זה שימושי

יתרונות WP-CLI:

• אוטומציה — מאפשר כתיבת סקריפטים לביצוע פעולות מרובות בבת אחת.
• מהירות — עבודה דרך שורת הפקודה מהירה יותר מה-Dashboard.
• גמישות — מאפשר ניהול גם ללא ממשק גרפי.
• אבטחה — ניתן לבטל את הגישה לממשק הניהול ולעבוד רק דרך הטרמינל.

---

דרישות מוקדמות

• ‏PHP גרסה ‎7.4 ומעלה (מומלץ ‎8.x)
• ‏WordPress גרסה ‎3.7 ומעלה
• ‏PHP CLI חייב להיות כלול במשתנה הסביבה ‎PATH
• חיבור אינטרנט להורדת הקבצים

בדיקת גרסת PHP:

php -v

---

התקנת WP-CLI ב-Windows

1. הורדת wp-cli.phar

פתח PowerShell והריץ:

curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

(אפשר גם להוריד ידנית ולשמור ב־C:\wp-cli\.)

---

2. בדיקת הפעולה

php C:\wp-cli\wp-cli.phar --info

אם מתקבלת תוצאה עם מידע על גרסה — הכל תקין.

---

3. יצירת קובץ wp.bat

צור קובץ בשם C:\wp-cli\wp.bat עם התוכן הבא:

@ECHO OFF
php "%~dp0wp-cli.phar" %*

כעת ניתן להריץ את WP-CLI ישירות בעזרת הפקודה wp.

---

4. הוספה ל-PATH

כדי שניתן יהיה להריץ את הפקודה מכל תיקייה:

setx PATH "$($env:PATH);C:\wp-cli" /M

לאחר מכן הפעל מחדש את PowerShell ובדוק:

wp --info

אם הכל עובד — ההתקנה הושלמה.

---

אפשרות חלופית: התקנה דרך Composer

composer global require wp-cli/wp-cli

לאחר מכן הוסף את הנתיב:

%USERPROFILE%\AppData\Roaming\Composer\vendor\bin

---

שימוש ב-WP-CLI

דוגמאות לפקודות:

התקנת WordPress:

wp core download --locale=he_IL

יצירת קובץ wp-config.php:

wp config create --dbname=wordpress --dbuser=root --dbpass=secret

התקנת אתר:

wp core install --url="http://localhost" --title="האתר שלי" --admin_user=admin --admin_password=1234 --admin_email=test@example.com

עדכונים:

wp core update
wp plugin update --all

ניהול משתמשים:

wp user create editor editor@example.com --role=editor --user_pass=pass123

---

פקודות שימושיות

• wp plugin list — מציג רשימת תוספים
• wp theme list — מציג רשימת תבניות
• wp search-replace "http://old" "https://new" — חיפוש והחלפה במסד הנתונים
• wp db export / wp db import — גיבוי ושחזור בסיס נתונים
• wp shell — פתיחת מעטפת PHP אינטראקטיבית

רשימת פקודות מלאה: https://developer.wordpress.org/cli/commands/

---

סקריפט PowerShell להתקנה אוטומטית

שמור כ־install-wp-cli.ps1 והריץ כמנהל מערכת:

$targetDir = "C:\wp-cli"
$pharUrl   = "https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar"
$pharPath  = "$targetDir\wp-cli.phar"
$batPath   = "$targetDir\wp.bat"

Write-Host "מתקין WP-CLI..." -ForegroundColor Cyan

if (!(Test-Path $targetDir)) {
    New-Item -ItemType Directory -Force -Path $targetDir | Out-Null
}

Invoke-WebRequest -Uri $pharUrl -OutFile $pharPath

"@ECHO OFF
php ""%~dp0wp-cli.phar"" %*" | Out-File $batPath -Encoding ASCII

$envPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($envPath -notlike "*$targetDir*") {
    [Environment]::SetEnvironmentVariable("Path", "$envPath;$targetDir", "Machine")
    Write-Host "✅ נוסף הנתיב $targetDir ל-PATH (נא להפעיל מחדש את הטרמינל)" -ForegroundColor Green
}

php $pharPath --info

לאחר ההרצה ניתן לבדוק:

wp --info

---

טיפים

• הפעל PowerShell כמנהל מערכת בעת שינוי משתנה PATH.
• לניהול אתרים מרוחקים השתמש ב־--ssh=<user>@<host>.
• אם יש שגיאות SSL, הוסף את הדגל --skip-ssl-check.
• בצע גיבוי לבסיס הנתונים לפני פעולות מסיביות.

---

סיכום

WP-CLI הוא כלי עוצמתי למנהלי ומפתחי WordPress.
הוא חוסך זמן, מאיץ תהליכים והופך את ניהול האתר ליעיל ובטוח יותר.

מחבר: hypo69
רישיון: MIT (https://opensource.org/licenses/MIT)