Kode Keluar

WP-CLIWP-CLI WP-CLI adalah Antarmuka Baris Perintah untuk WordPress, yang digunakan untuk melakukan tugas administratif dan pengembangan secara terprogram. Halaman proyeknya adalah http://wp-cli.org/ https://make.wordpress.org/cli/ mengikuti konvensi Unix yang diadopsi secara luas untuk kode keluar: 0 menandakan keberhasilan (kondisi utama perintah terpenuhi), sedangkan nilai selain nol menandakan bahwa kondisi utama tidak terpenuhi. Hal ini dapat menunjukkan kesalahan operasional (perintah tidak dapat melakukan operasi yang diminta) atau hasil negatif yang diharapkan dan memang dimaksudkan untuk diuji oleh skrip pemanggil (misalnya, “belum terpasang”). Skrip yang memanggil perintah WP-CLI dapat memeriksa kode keluar untuk menentukan apakah harus melanjutkan, mencoba lagi, atau membatalkan.

Kode keluar standar

WP_CLI::error() (dokumentasi) adalah cara konvensional untuk melaporkan kegagalan dan keluar dengan kode 1.

WP_CLI::halt() (dokumentasi) dapat digunakan untuk keluar dengan kode selain nol tertentu ketika perintah perlu menyampaikan hasil tertentu kepada skrip pemanggil.

Kode keluar untuk perintah dengan hasil boolean

Beberapa perintah dirancang untuk menyampaikan hasil biner secara langsung melalui kode keluar, bukan melalui keluaran. Perintah-perintah ini tetap menggunakan kode standar 0/1, tetapi 1 berarti “kondisi tidak terpenuhi”, bukan “kesalahan operasional”. Contohnya:

• wp plugin is-installed <plugin> keluar dengan 0 jika pluginPlugin Plugin adalah perangkat lunak yang berisi sekumpulan fungsi yang dapat ditambahkan ke situs web WordPress. Plugin dapat memperluas fungsionalitas atau menambahkan fitur baru ke situs web WordPress Anda. Plugin WordPress ditulis dalam bahasa pemrograman PHP dan terintegrasi secara mulus dengan WordPress. Plugin ini dapat diperoleh secara gratis di Direktori Plugin WordPress.org https://wordpress.org/plugins/ atau berupa plugin berbayar dari pihak ketiga. terpasang, dan 1 jika tidak.
• wp theme is-installed <theme> mengikuti pola yang sama.
• wp core is-installed keluar dengan 0 ketika WordPress terpasang, dan 1 ketika tidak terpasang.

Gunakan kode keluar 1 untuk menandakan “kondisi tidak terpenuhi” (bukan kesalahan) ketika:

1. Hasil perintah bersifat biner (berhasil/gagal, ditemukan/tidak ditemukan) dan dimaksudkan untuk diuji secara langsung dalam kondisi shell.
2. Maksudnya didokumentasikan secara eksplisit sehingga penulis skrip mengetahui bahwa kode keluar membawa makna hasil, bukan makna kesalahan.

Jangan mengembalikan kode keluar selain nol untuk kondisi yang bersifat informasional, bukan hasil yang pasti (misalnya perintah daftar yang tidak menemukan item apa pun tetap merupakan operasi yang berhasil — perintah tersebut mengembalikan daftar kosong).

Menggunakan kode keluar dalam skrip

Karena WP-CLI menggunakan kode keluar standar, Anda dapat menggunakan perintah WP-CLI secara langsung dalam kondisi shell:

# Periksa apakah plugin terpasang sebelum mencoba mengaktifkannya
if wp plugin is-installed my-plugin; then
    wp plugin activate my-plugin
else
    echo "Plugin belum terpasang"
    exit 1
fi

Anda juga dapat memeriksa $? setelah perintah WP-CLI apa pun untuk memeriksa apakah perintah tersebut berhasil:

wp core update
if [ "$?" -ne 0 ]; then
    echo "Pembaruan gagal"
fi