Các Câu Lệnh Phổ Biến Trong Drupal

Hướng Dẫn Các Câu Lệnh Phổ Biến Trong Drupal: Drush, Drupal Console và Composer

Drupal là một trong những hệ quản trị nội dung (CMS) mã nguồn mở mạnh mẽ nhất, được sử dụng rộng rãi để xây dựng các website phức tạp. Để quản lý và phát triển dự án Drupal hiệu quả, các công cụ như Drush, Drupal Console và Composer là không thể thiếu. Trong bài viết này, chúng ta sẽ tìm hiểu các câu lệnh phổ biến của từng công cụ, kèm giải thích chi tiết để bạn dễ dàng áp dụng.

1. Drush - Công Cụ Dòng Lệnh Cho Drupal

Drush (Drupal Shell) là công cụ dòng lệnh giúp quản lý Drupal nhanh chóng và hiệu quả. Dưới đây là các lệnh Drush phổ biến:

a. Cài Đặt Drush

Lệnh:

composer require drush/drush

Giải thích: Cài đặt Drush toàn cục thông qua Composer. Sau khi cài, bạn có thể chạy Drush từ thư mục dự án Drupal bằng lệnh ./vendor/bin/drush.

b. Xóa Cache

Lệnh:

drush cache:rebuild

hoặc viết tắt:

drush cr

Giải thích: Xóa toàn bộ bộ nhớ cache của Drupal, rất hữu ích khi bạn cập nhật module hoặc cấu hình.

c. Cập Nhật Cơ Sở Dữ Liệu

Lệnh:

drush updatedb

hoặc viết tắt:

drush updb

Giải thích: Chạy các bản cập nhật cơ sở dữ liệu (database updates) từ các module hoặc core khi chúng có thay đổi.

d. Kích Hoạt/Tắt Module

Lệnh:

drush en module_name

drush pm:uninstall module_name

Giải thích:
- en (enable): Kích hoạt module.
- pm:uninstall: Gỡ cài đặt module. Thay module_name bằng tên module cụ thể (ví dụ: views, pathauto).

e. Tạo Bản Sao Cơ Sở Dữ Liệu

Lệnh:

drush sql-dump > backup.sql

Giải thích: Xuất cơ sở dữ liệu hiện tại thành tệp backup.sql để sao lưu.

f. Chạy Cron

Lệnh:

drush cron

Giải thích: Thực thi các tác vụ cron của Drupal, như lập chỉ mục nội dung hoặc gửi email hàng loạt.

2. Drupal Console - Công Cụ Tạo Mã Nguồn

Drupal Console là công cụ dòng lệnh khác, tập trung vào việc tạo mã nguồn (code generation) và tương tác với Drupal 8/9/10. Một số lệnh phổ biến:

a. Cài Đặt Drupal Console

Lệnh:

composer require drupal/console:~1.0 --prefer-dist

Giải thích: Cài đặt Drupal Console thông qua Composer. Sau đó, chạy bằng lệnh ./vendor/bin/drupal.

b. Tạo Module Mới

Lệnh:

drupal generate:module

Giải thích: Tạo một module tùy chỉnh mới. Công cụ sẽ đặt câu hỏi để cấu hình tên module, mô tả, v.v.

c. Tạo Controller

Lệnh:

drupal generate:controller

Giải thích: Tạo một controller trong module hiện có, giúp định nghĩa các route và xử lý logic.

d. Kiểm Tra Cấu Hình

Lệnh:

drupal check

Giải thích: Kiểm tra mã nguồn Drupal để phát hiện lỗi cú pháp hoặc vấn đề tương thích.

e. Tạo Custom Block

Lệnh:

drupal generate:plugin:block

Giải thích: Tạo một block tùy chỉnh để thêm nội dung vào vùng giao diện.

3. Composer - Quản Lý Gói Trong Drupal

Composer là công cụ quản lý phụ thuộc phổ biến trong Drupal, giúp cài đặt core, module, theme và thư viện. Dưới đây là các lệnh Composer thường dùng:

a. Cài Đặt Drupal Core

Lệnh:

composer create-project drupal/recommended-project my_project

Giải thích: Tạo một dự án Drupal mới với cấu hình mặc định trong thư mục my_project.

b. Cài Đặt Module

Lệnh:

composer require drupal/module_name

Giải thích: Cài đặt một module cụ thể (thay module_name bằng tên module, ví dụ: drupal/token).

c. Cập Nhật Module/Core

Lệnh:

composer update drupal/core --with-dependencies

Giải thích: Cập nhật Drupal core và các phụ thuộc liên quan.

d. Xóa Module

Lệnh:

composer remove drupal/module_name

Giải thích: Gỡ bỏ một module khỏi dự án.

e. Kiểm Tra Phụ Thuộc

Lệnh:

composer show

Giải thích: Liệt kê tất cả các gói đã cài đặt trong dự án, bao gồm phiên bản.

Lưu Ý Khi Sử Dụng Các Công Cụ

Drush: Phù hợp để quản lý hệ thống (cache, database, cron).
Drupal Console: Tập trung vào phát triển (tạo mã nguồn, debug).
Composer: Quản lý phụ thuộc và cấu trúc dự án.
Đảm bảo bạn đã cài đặt PHP và Composer trên máy trước khi sử dụng các công cụ này.

Kết Luận

Việc sử dụng Drush, Drupal Console, và Composer giúp bạn tiết kiệm thời gian và tăng hiệu suất khi làm việc với Drupal. Các câu lệnh trên là nền tảng để bạn bắt đầu quản lý và phát triển dự án Drupal một cách chuyên nghiệp. Nếu bạn mới bắt đầu, hãy thử áp dụng từng lệnh trong môi trường thử nghiệm để làm quen!