مقدمه

نصب wp-cli روی ویندوز همواره با مشکلات زیادی همراه بوده است. اما در این آموزش ساده و کوتاه، آسان‌ترین راه برای راه‌اندازی آن را برایتان می‌نویسم.

راه‌اندازی PHP

توجه! اگر مفسر PHP شما از پیش در PATH سیستم‌عامل ویندوز وجود دارد می‌توانید به قسمت بعدی آموزش بروید.

پیش از شروع هر چیزی باید مفسر PHP را به سیستم‌عامل ویندوز معرفی کنیم. به این منظور یکی از نسخه‌های کامپایل شده PHP برای ویندوز را از اینجا دانلود کنید. در هنگام نگارش این پست نسخه زیپ VS16 x64 Thread Safe (2024-Dec-17 14:59:22) را دانلود کرده‌ام. پس از استخراج فایل زیپ، آن را به یک مسیر دلخواه مانند C:\Program Files\php انتقال دهید. این مسیر را برای استفاده‌های بعدی حتماً یادداشت کنید.

در مسیر فعلی، یعنی همان‌جایی که مفسر PHP را در آن قرار داده‌اید، نام فایل php.ini-development را به php.ini تغییر دهید. انجام این کار ضروری است.

اکنون فایل php.ini را با یک ویرایشگر متنی باز کنید و مراحل زیر را دنبال کنید:

  1. کلمه extension_dir را جست‌وجو کرده و آن را به شکل زیر تغییر دهید:
1
2
3
4
5
; Before change
;extension_dir = "ext"

; After change
extension_dir = "C:\Program Files\php\ext"

دقت کنید که به جای C:\Program Files\php از مسیر مفسر PHP که در ابتدای آموزش یادداشت کرده بودید، استفاده کنید.

  1. کلمه ; Dynamic Extensions ; را جست‌وجو کرده و ماژول‌های ضروری زیر را از حالت کامنت خارج کنید. برای خارج کردن از حالت کامنت کافی است تا کاراکتر ; موجود در ابتدای هر خط را پاک کنید:
1
2
3
4
5
6
7
extension=curl
extension=fileinfo
extension=gd
extension=mbstring
extension=mysqli
extension=openssl
extension=pdo_mysql

سپس در تنظیمات ویندوز خودتان به دنبال Edit the system environment variables بگردید و آن را باز کنید.

در پنجره تازه باز شده، روی گزینه Environment Variables کلیک کنید.

حال رکورد Path را انتخاب و بر روی دکمه Edit کلیک کنید.

با کلیک بر روی دکمه New، آدرسی که مفسر PHP را در آن قرار داده بودید، جایگذاری کنید. برای مثال من باید مقدار C:\Program Files\php را جایگذاری کنم.

پس از اِعمال کلیه‌ی تغییرات، تنظیمات را ذخیره کنید.

راه‌اندازی WP-CLI

ابتدا اسکریپت wp-cli.phar را از اینجا دانلود کنید.

پس از دانلود آن را دقیقاً به پوشه‌ای که مفسر PHP را در آن قرار داده بودید، منتقل کنید. برای مثال من باید این فایل را به پوشه C:\Program Files\php انتقال دهم.

اکنون در پوشه‌ای که مفسر PHP در آن قرار دارد، یک فایل متنی با فرمت .bat بسازید و نام آن را wp.bat قرار دهید. در این فایل متنی محتوای زیر را جایگذاری و ذخیره کنید.

1
2
@ECHO OFF
php "C:/Program Files/php/wp-cli.phar" %*

تبریک، همه چیز آماده استفاده است! یک کامندپرامپت یا پاورشل تازه باز کرده و دسترسی به wp-cli را با دستور زیر بررسی نمائید:

1
wp --info

آموزش برایتان مفید واقع شد؟ آن را با دوستان وردپرسی خودتان نیز به اشتراک بگذارید.