WP-CLI เป็นอินเทอร์เฟซบรรทัดคำสั่งสำหรับ WordPress คุณสามารถอัปเดตปลั๊กอิน กำหนดค่าการติดตั้งหลายไซต์ และอื่นๆ อีกมากมายได้โดยไม่ต้องใช้เว็บเบราว์เซอร์
การบำรุงรักษาอย่างต่อเนื่องสามารถทำได้โดย:
รุ่นเสถียรปัจจุบันคือเวอร์ชัน 2.11.0 สำหรับประกาศ โปรดติดตาม @wpcli บน Twitter หรือลงทะเบียนเพื่อรับการอัปเดตทางอีเมล ตรวจสอบแผนการทำงานเพื่อดูภาพรวมของสิ่งที่วางแผนไว้สำหรับการเปิดตัวที่กำลังจะมาถึง
ลิงค์ด่วน: การใช้ | กำลังติดตั้ง | สนับสนุน | การขยาย | มีส่วนร่วม | เครดิต
WP-CLI มีอินเทอร์เฟซบรรทัดคำสั่งสำหรับการดำเนินการหลายอย่างที่คุณอาจทำในผู้ดูแลระบบ WordPress ตัวอย่างเช่น wp plugin install --activate
(doc) ช่วยให้คุณสามารถติดตั้งและเปิดใช้งานปลั๊กอิน WordPress:
$ wp plugin install user-switching --activate
Installing User Switching (1.0.9)
Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating ' user-switching ' ...
Plugin ' user-switching ' activated.
Success: Installed 1 of 1 plugins.
WP-CLI ยังมีคำสั่งสำหรับหลายสิ่งที่คุณไม่สามารถทำได้ในผู้ดูแลระบบ WordPress ตัวอย่างเช่น wp transient delete --all
(doc) ให้คุณลบชั่วคราวหนึ่งรายการหรือทั้งหมด:
$ wp transient delete --all
Success: 34 transients deleted from the database.
หากต้องการข้อมูลเบื้องต้นเกี่ยวกับการใช้ WP-CLI ที่สมบูรณ์ยิ่งขึ้น โปรดอ่านคู่มือเริ่มต้นใช้งานฉบับย่อ หรือติดต่อกับเพื่อนเชลล์เพื่อเรียนรู้เกี่ยวกับยูทิลิตี้บรรทัดคำสั่งที่เป็นประโยชน์
รู้สึกสบายใจกับพื้นฐานแล้วหรือยัง? ข้ามไปที่รายการคำสั่งทั้งหมดเพื่อดูข้อมูลโดยละเอียดเกี่ยวกับการจัดการธีมและปลั๊กอิน การนำเข้าและส่งออกข้อมูล ดำเนินการค้นหาฐานข้อมูล-แทนที่ และอื่นๆ
การดาวน์โหลดไฟล์ Phar เป็นวิธีการติดตั้งที่เราแนะนำสำหรับผู้ใช้ส่วนใหญ่ หากคุณต้องการ โปรดดูเอกสารประกอบของเราเกี่ยวกับวิธีการติดตั้งอื่นๆ (Composer, Homebrew, Docker)
ก่อนติดตั้ง WP-CLI โปรดตรวจสอบให้แน่ใจว่าสภาพแวดล้อมของคุณตรงตามข้อกำหนดขั้นต่ำ:
เมื่อคุณตรวจสอบข้อกำหนดแล้ว ให้ดาวน์โหลดไฟล์ wp-cli.phar โดยใช้ wget
หรือ curl
:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
จากนั้น ให้ตรวจสอบไฟล์ Phar เพื่อยืนยันว่าใช้งานได้:
php wp-cli.phar --info
หากต้องการใช้ WP-CLI จากบรรทัดคำสั่งโดยพิมพ์ wp
ทำให้ไฟล์ปฏิบัติการได้และย้ายไปยังตำแหน่งใดที่หนึ่งใน PATH ของคุณ ตัวอย่างเช่น:
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
หากติดตั้ง WP-CLI สำเร็จ คุณควรเห็นสิ่งนี้เมื่อคุณรัน wp --info
:
$ wp --info
OS: Linux 5.10.60.1-microsoft-standard-WSL2 # 1 SMP Wed Aug 25 23:20:18 UTC 2021 x86_64
Shell: /usr/bin/zsh
PHP binary: /usr/bin/php8.1
PHP version: 8.1.0
php.ini used: /etc/php/8.1/cli/php.ini
MySQL binary: /usr/bin/mysql
MySQL version: mysql Ver 8.0.27-0ubuntu0.20.04.1 for Linux on x86_64 (( Ubuntu ))
SQL modes:
WP-CLI root dir: /home/wp-cli/
WP-CLI vendor dir: /home/wp-cli/vendor
WP_CLI phar path:
WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/
WP-CLI global config:
WP-CLI project config: /home/wp-cli/wp-cli.yml
WP-CLI version: 2.11.0
คุณสามารถอัปเดต WP-CLI ด้วย wp cli update
(doc) หรือโดยการทำซ้ำขั้นตอนการติดตั้ง
หาก WP-CLI เป็นของ root หรือผู้ใช้ระบบอื่น คุณจะต้องเรียกใช้ sudo wp cli update
อยากใช้ชีวิตบนขอบ? รัน wp cli update --nightly
เพื่อใช้ WP-CLI บิลด์ล่าสุดทุกคืน โครงสร้างทุกคืนมีความเสถียรมากหรือน้อยเพียงพอสำหรับคุณที่จะใช้ในสภาพแวดล้อมการพัฒนาของคุณ และรวมคุณสมบัติ WP-CLI ล่าสุดและดีที่สุดไว้ด้วยเสมอ
WP-CLI ยังมาพร้อมกับสคริปต์การเติมแท็บสำหรับ Bash และ ZSH เพียงดาวน์โหลด wp-completion.bash และแหล่งที่มาจาก ~/.bash_profile
:
source /FULL/PATH/TO/wp-completion.bash
อย่าลืมเรียกใช้ source ~/.bash_profile
หลังจากนั้น
หากใช้ zsh สำหรับเชลล์ของคุณ คุณอาจต้องโหลดและเริ่ม bashcompinit
ก่อนที่จะจัดหา ใส่สิ่งต่อไปนี้ใน .zshrc
ของคุณ :
autoload bashcompinit
bashcompinit
source /FULL/PATH/TO/wp-completion.bash
ผู้ดูแลและผู้มีส่วนร่วมของ WP-CLI มีความพร้อมจำกัดในการตอบคำถามสนับสนุนทั่วไป WP-CLI เวอร์ชันปัจจุบันเป็นเวอร์ชันเดียวที่ได้รับการสนับสนุนอย่างเป็นทางการ
เมื่อต้องการความช่วยเหลือ โปรดค้นหาคำถามของคุณในสถานที่เหล่านี้ก่อน:
หากคุณไม่พบคำตอบในสถานที่แห่งใดแห่งหนึ่งข้างต้น คุณสามารถ:
#cli
ใน WordPress.org Slack เพื่อสนทนากับใครก็ตามที่อาจว่างในขณะนั้น ตัวเลือกนี้เหมาะที่สุดสำหรับการถามคำถามสั้นๆปัญหา GitHub มีไว้สำหรับการติดตามการปรับปรุงและข้อบกพร่องของคำสั่งที่มีอยู่ ไม่ใช่การสนับสนุนทั่วไป ก่อนที่จะส่งรายงานข้อบกพร่อง โปรดตรวจสอบแนวทางปฏิบัติที่ดีที่สุดของเราเพื่อช่วยให้มั่นใจว่าปัญหาของคุณได้รับการแก้ไขอย่างทันท่วงที
กรุณาอย่าถามคำถามสนับสนุนบน Twitter Twitter ไม่ใช่สถานที่ที่ยอมรับได้สำหรับการสนับสนุน เนื่องจาก: 1) เป็นการยากที่จะจัดการสนทนาที่มีความยาวไม่เกิน 280 อักขระ และ 2) Twitter ไม่ใช่สถานที่ที่บุคคลที่มีคำถามเดียวกันของคุณสามารถค้นหาคำตอบในการสนทนาก่อนหน้าได้
จำไว้ว่า libre != gratis; ใบอนุญาตโอเพ่นซอร์สให้อิสระแก่คุณในการใช้และแก้ไข แต่ไม่ใช่ข้อผูกมัดในเรื่องเวลาของผู้อื่น โปรดให้ความเคารพและตั้งความคาดหวังของคุณตามนั้น
คำสั่ง คือหน่วยอะตอมมิกของฟังก์ชัน WP-CLI wp plugin install
(doc) คือคำสั่งเดียว wp plugin activate
(doc) เป็นอีกอันหนึ่ง
WP-CLI รองรับการลงทะเบียนคลาส ฟังก์ชัน หรือการปิดที่สามารถเรียกได้เป็นคำสั่ง มันอ่านรายละเอียดการใช้งานจาก PHPdoc ของการโทรกลับ WP_CLI::add_command()
(doc) ใช้สำหรับการลงทะเบียนคำสั่งทั้งภายในและบุคคลที่สาม
/**
* Delete an option from the database.
*
* Returns an error if the option didn't exist.
*
* ## OPTIONS
*
* <key>
* : Key for the option.
*
* ## EXAMPLES
*
* $ wp option delete my_option
* Success: Deleted 'my_option' option.
*/
$ delete_option_cmd = function ( $ args ) {
list ( $ key ) = $ args ;
if ( ! delete_option ( $ key ) ) {
WP_CLI :: error ( " Could not delete ' $ key ' option. Does it exist? " );
} else {
WP_CLI :: success ( " Deleted ' $ key ' option. " );
}
};
WP_CLI :: add_command ( ' option delete ' , $ delete_option_cmd );
WP-CLI มาพร้อมกับคำสั่งมากมาย การสร้างคำสั่ง WP-CLI แบบกำหนดเองนั้นง่ายกว่าที่คิด อ่านตำราคำสั่งเพื่อเรียนรู้เพิ่มเติม เรียกดูเอกสาร API ภายในเพื่อค้นหาฟังก์ชันที่เป็นประโยชน์มากมายที่คุณสามารถใช้ในคำสั่ง WP-CLI ที่คุณกำหนดเอง
เราขอขอบคุณที่คุณริเริ่มที่จะสนับสนุน WP-CLI เป็นเพราะคุณและชุมชนรอบตัวคุณที่ทำให้ WP-CLI จึงเป็นโครงการที่ยอดเยี่ยม
การมีส่วนร่วมไม่ได้จำกัดอยู่เพียงแค่โค้ดเท่านั้น เราขอแนะนำให้คุณมีส่วนร่วมในวิธีที่เหมาะสมกับความสามารถของคุณมากที่สุด โดยการเขียนบทช่วยสอน สาธิตที่งานมีตติ้งในพื้นที่ของคุณ ช่วยเหลือผู้ใช้รายอื่นในการตอบคำถามสนับสนุน หรือแก้ไขเอกสารประกอบของเรา
อ่านแนวทางการมีส่วนร่วมของเราในคู่มือเพื่อดูคำแนะนำอย่างละเอียดเกี่ยวกับวิธีการมีส่วนร่วม การปฏิบัติตามแนวทางเหล่านี้จะช่วยสื่อสารว่าคุณเคารพเวลาของผู้มีส่วนร่วมรายอื่นในโครงการ ในทางกลับกัน พวกเขาจะพยายามอย่างเต็มที่เพื่อตอบแทนความเคารพเมื่อทำงานร่วมกับคุณ ข้ามเขตเวลาและทั่วโลก
WP-CLI มีผู้ดูแลโปรเจ็กต์หนึ่งคน: schlessera
ในบางครั้ง เราให้สิทธิการเขียนแก่ผู้ร่วมให้ข้อมูลที่ได้แสดงให้เห็นในช่วงระยะเวลาหนึ่งว่าพวกเขามีความสามารถและลงทุนในการขับเคลื่อนโครงการไปข้างหน้า
อ่านเอกสารการกำกับดูแลในคู่มือเพื่อดูรายละเอียดการปฏิบัติงานเพิ่มเติมเกี่ยวกับโครงการ
นอกจากไลบรารีที่กำหนดไว้ใน composer.json แล้ว เรายังได้ใช้โค้ดหรือแนวคิดจากโปรเจ็กต์ต่อไปนี้:
wp shell
wp media regenerate
wp search-replace
wp export
wp import
wp scaffold plugin-tests