Drupal: Cara Membuat Perintah Drush Anda Sendiri

Konsep Utama

• Drush Extensibility: Drush, Drupal's Command-line Interface, membolehkan memperluaskan fungsinya dengan arahan tersuai yang ditakrifkan dalam modul. Ini membolehkan mengautomasikan operasi drupal tertentu.
• Struktur Perintah: Mewujudkan arahan drush melibatkan fail (dalam modul anda), fungsi .drush.inc untuk definisi arahan, dan fungsi panggilan balik untuk melaksanakan logik perintah. hook_drush_command()
• Argumen dan pilihan: Perintah boleh menerima argumen mandatori dan pilihan pilihan, meningkatkan penyesuaian. Argumen diluluskan sebagai parameter fungsi, manakala pilihan diambil menggunakan . drush_get_option()
• Input dan Penambahbaikan Interaktif: Perintah boleh meminta input pengguna, memberikan contoh penggunaan, dan menentukan kebergantungan (tahap drupal bootstrap, modul, versi teras).

Drush Streamlines Drupal Management dari terminal. Semasa menawarkan arahan pra-bina (Modul Muat turun, Dayakan, Kemas kini), kuasa sebenarnya terletak pada membuat arahan tersuai. Tutorial ini menunjukkan membina perintah drush untuk modul yang mudah dan ilustrasi. Tumpuannya adalah pada struktur arahan Drush, bukan fungsi teras modul. Contoh kod boleh didapati di [repositori ini] (repositori_link_here - gantikan dengan pautan sebenar jika tersedia).

Modul sampel kami

fungsi modul

adalah fungsi asas: demo_drush

<code class="language-php">function demo_drush_print_statement() {
  drupal_set_message(t('Hello world!'));
}</code>

Fungsi ini akan digunakan untuk menunjukkan bagaimana drush mencetak mesej ke konsol. Kami akan mengubahnya kemudian untuk mempamerkan pelbagai ciri arahan.

fail arahan drush () demo_drush.drush.inc Buat

dalam direktori modul anda. Drush mengenal pasti dan memuat fungsi dari fail yang berakhir di

. demo_drush.drush.inc .drush.inc

cangkuk perintah dan panggilan balik

Arkitek Perintah Drush terdiri daripada dua bahagian utama: pelaksanaan

(menentukan arahan dan konfigurasi) dan fungsi panggil balik yang dicetuskan oleh arahan. Mari mulakan dengan

: hook_drush_command() hook_drush_command()

Ini mentakrifkan perintah bernama

<code class="language-php">/**
 * Implements hook_drush_command().
 */
function drush_demo_drush_command() {
  $items['drush-demo-command'] = array(
    'description' => 'Demonstrates Drush command functionality.',
    'aliases' => array('ddc'),
  );
  return $items;
}</code>

(alias sebagai

). Fungsi panggil balik (secara lalai, drush-demo-command) melaksanakan logik perintah: ddc drush_drush_demo_command()

selepas membersihkan cache drush (

<code class="language-php">/**
 * Callback for the drush-demo-command command.
 */
function drush_drush_demo_command() {
  demo_drush_print_statement();
}</code>

), berjalan

mencetak "Hello World!" ke konsol. drush cc drush drush ddc

Argumen dan pilihan

Meningkatkan arahan anda dengan argumen (wajib) dan pilihan (pilihan). Mari tambahkannya ke cangkuk:

<code class="language-php">function demo_drush_print_statement() {
  drupal_set_message(t('Hello world!'));
}</code>

Sekarang, drush ddc error --repeat=10 menetapkan jenis pernyataan kepada "ralat" dan mengulanginya 10 kali. Kemas kini demo_drush_print_statement() dan fungsi panggil balik dengan sewajarnya:

<code class="language-php">/**
 * Implements hook_drush_command().
 */
function drush_demo_drush_command() {
  $items['drush-demo-command'] = array(
    'description' => 'Demonstrates Drush command functionality.',
    'aliases' => array('ddc'),
  );
  return $items;
}</code>

input pengguna

mengendalikan argumen yang hilang secara interaktif:

<code class="language-php">/**
 * Callback for the drush-demo-command command.
 */
function drush_drush_demo_command() {
  demo_drush_print_statement();
}</code>

tambahkan contoh ke cangkuk: hook_drush_command()

Kesimpulan

<code class="language-php">...
'arguments' => array(
  'type' => 'Statement type (error or success).',
),
'options' => array(
  'repeat' => 'Number of statement repeats.',
),
...</code>

Tutorial ini merangkumi asas -asas membuat perintah drush. Terokai ciri -ciri canggih seperti tahap bootstrap, kebergantungan modul, dan keserasian versi teras dalam dokumentasi API Drush.

Soalan Lazim (Soalan Lazim)

(Ini sudah ditulis dengan baik dalam input, tidak perlu menulis semula mereka)

Atas ialah kandungan terperinci Drupal: Cara Membuat Perintah Drush Anda Sendiri. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!