Mã nào được sử dụng trong WordPress?

Các tiêu chuẩn mã hóa PHP này dành cho toàn bộ cộng đồng WordPress. Chúng là bắt buộc đối với WordPress Core và chúng tôi khuyến khích bạn sử dụng chúng cho cả chủ đề và plugin của mình

Mặc dù các chủ đề và plugin có thể chọn tuân theo một kiểu mã hóa khác, nhưng các tiêu chuẩn mã hóa này không chỉ về kiểu mã mà còn bao gồm các phương pháp hay nhất đã được thiết lập về khả năng tương tác, khả năng dịch và bảo mật trong hệ sinh thái WordPress, vì vậy, ngay cả khi sử dụng một kiểu mã khác

Mặc dù không phải tất cả mã đều có thể (chưa) hoàn toàn tuân thủ các tiêu chuẩn này, nhưng tất cả mã mới được cam kết và/hoặc cập nhật phải tuân thủ đầy đủ các tiêu chuẩn mã hóa này

Đồng thời xem Tiêu chuẩn tài liệu nội tuyến PHP để biết thêm hướng dẫn

Nếu bạn muốn tự động kiểm tra mã của mình theo tiêu chuẩn này, bạn có thể sử dụng công cụ Tiêu chuẩn mã hóa WordPress chính thức, được chạy bằng PHP_CodeSniffer

Khi nhúng các đoạn mã PHP nhiều dòng trong một khối HTML, các thẻ mở và đóng PHP phải nằm trên một dòng riêng lẻ

Đúng (Đa dòng)

function foo() {
    ?>
    

        
    
    

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Chúng tôi thực sự khuyên bạn nên sử dụng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Sử dụng các chữ cái viết thường trong tên biến, hành động/bộ lọc và tên hàm (không bao giờ

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

function some_name( $some_variable ) {}

Đối với tên tham số chức năng, chúng tôi đặc biệt khuyên bạn nên tránh sử dụng các từ khóa dành riêng làm tên, vì nó dẫn đến mã khó đọc và khó hiểu khi sử dụng PHP 8. 0 tính năng “đặt tên tham số trong lời gọi hàm”.
Ngoài ra, hãy nhớ rằng việc đổi tên một tham số chức năng nên được coi là một thay đổi vi phạm kể từ PHP 8. 0, vì vậy hãy đặt tên các tham số chức năng cẩn thận.

Tên lớp, đặc điểm, giao diện và enum nên sử dụng các từ viết hoa được phân tách bằng dấu gạch dưới. Mọi từ viết tắt đều phải viết hoa

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các hằng số phải viết hoa tất cả với dấu gạch dưới ngăn cách các từ

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các tệp nên được đặt tên mô tả bằng các chữ cái viết thường. Dấu gạch nối nên ngăn cách các từ

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Tên tệp lớp phải dựa trên tên lớp với _____19 được thêm vào trước và dấu gạch dưới trong tên lớp được thay thế bằng dấu gạch nối, ví dụ: ____ ____

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Tiêu chuẩn đặt tên tệp này dành cho tất cả các tệp hiện tại và mới với các lớp, ngoại trừ các lớp kiểm tra.
Đối với các tệp chứa lớp kiểm tra, tên tệp phải phản ánh chính xác tên lớp, theo PSR4. Điều này là để đảm bảo khả năng tương thích giữa các phiên bản với tất cả các phiên bản PHPUnit được hỗ trợ.

Các tệp chứa các thẻ mẫu trong thư mục

function some_name( $some_variable ) {}

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các hook động nên được đặt tên bằng phép nội suy thay vì nối cho mục đích dễ đọc và dễ khám phá

Móc động là các móc bao gồm các giá trị động trong tên thẻ của chúng, e. g.

function some_name( $some_variable ) {}

Các biến được sử dụng trong thẻ móc phải được đặt trong dấu ngoặc nhọn

function some_name( $some_variable ) {}

function some_name( $some_variable ) {}

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Nếu có thể, các giá trị động trong tên thẻ cũng phải ngắn gọn và chính xác nhất có thể.

function some_name( $some_variable ) {}

function some_name( $some_variable ) {}

Luôn đặt dấu cách sau dấu phẩy và ở cả hai bên của toán tử logic, số học, so sánh, chuỗi và phép gán

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Đặt dấu cách ở hai bên dấu ngoặc đơn mở và đóng của khối cấu trúc điều khiển

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi xác định một hàm, hãy làm như vậy

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi gọi một chức năng, hãy làm như vậy

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi thực hiện so sánh logic, hãy làm như vậy

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Loại phôi phải là chữ thường. Luôn ưu tiên dạng rút gọn của kiểu chuyển,

function some_name( $some_variable ) {}

function some_name( $some_variable ) {}

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi đề cập đến các mục mảng, chỉ bao gồm một khoảng trắng xung quanh chỉ mục nếu đó là một biến, chẳng hạn

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Trong khối

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Trừ khi có quy định khác, dấu ngoặc đơn phải có khoảng trắng bên trong chúng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi sử dụng các toán tử tăng (

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Sự thụt đầu dòng của bạn phải luôn phản ánh cấu trúc logic. Sử dụng các tab thực, không phải khoảng trắng, vì điều này cho phép các máy khách linh hoạt nhất

Ngoại lệ. nếu bạn có một khối mã sẽ dễ đọc hơn nếu mọi thứ được căn chỉnh, hãy sử dụng dấu cách

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Đối với mảng kết hợp, mỗi mục phải bắt đầu trên một dòng mới khi mảng chứa nhiều mục

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Lưu ý dấu phẩy sau mục mảng cuối cùng. điều này được khuyến nghị vì nó giúp thay đổi thứ tự của mảng dễ dàng hơn và tạo ra sự khác biệt rõ ràng hơn khi các mục mới được thêm vào

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Đối với cấu trúc điều khiển

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

quy tắc ngón tay cái. Các tab nên được sử dụng ở đầu dòng để thụt lề, trong khi khoảng trắng có thể được sử dụng ở giữa dòng để căn chỉnh

Xóa khoảng trắng ở cuối mỗi dòng. Ưu tiên bỏ qua thẻ đóng PHP ở cuối tệp. Nếu bạn sử dụng thẻ, hãy nhớ xóa khoảng trắng ở cuối

Không được có các dòng trống ở cuối thân hàm

Dấu ngoặc nhọn sẽ được sử dụng cho tất cả các khối theo kiểu hiển thị ở đây

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Nếu bạn có một khối thực sự dài, hãy xem xét liệu nó có thể được chia thành hai hoặc nhiều khối, chức năng hoặc phương thức ngắn hơn để giảm độ phức tạp, cải thiện tính dễ kiểm tra và tăng khả năng đọc hay không

Niềng răng phải luôn luôn được sử dụng, ngay cả khi chúng không bắt buộc

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Lưu ý rằng việc yêu cầu sử dụng dấu ngoặc nhọn có nghĩa là cấu trúc điều khiển nội tuyến một câu lệnh bị cấm. Bạn có thể tự do sử dụng cú pháp thay thế cho các cấu trúc điều khiển (e. g. Ví dụ:

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Sử dụng cú pháp mảng dài (

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Mảng phải được khai báo bằng cú pháp mảng dài

Khi chia lệnh gọi hàm thành nhiều dòng, mỗi tham số phải nằm trên một dòng riêng. Nhận xét nội tuyến một dòng có thể chiếm dòng riêng của họ

Mỗi tham số không được chiếm quá một dòng. Các giá trị tham số nhiều dòng phải được gán cho một biến và sau đó biến đó sẽ được chuyển đến lệnh gọi hàm

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khai báo kiểu phải có chính xác một khoảng trắng trước và sau kiểu. Toán tử nullability (

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các khai báo kiểu trả về không được có khoảng cách giữa dấu ngoặc đơn đóng của khai báo hàm và dấu hai chấm bắt đầu kiểu trả về

Các quy tắc này áp dụng cho tất cả các cấu trúc cho phép khai báo kiểu. hàm, bao đóng, enum, điều kiện bắt cũng như PHP 7. 4 chức năng mũi tên và thuộc tính gõ

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Ghi chú.
Việc sử dụng khai báo kiểu có các hạn chế sau dựa trên phiên bản PHP yêu cầu tối thiểu của ứng dụng, cho dù đó là WordPress Core, plugin hay chủ đề.

• Không thể sử dụng các khai báo kiểu vô hướng

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  200,

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  201,

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  202 và

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  203 cho đến khi phiên bản PHP tối thiểu là PHP 7. 0 hoặc cao hơn
• Không thể sử dụng khai báo kiểu trả về cho đến khi phiên bản PHP tối thiểu là PHP 7. 0 hoặc cao hơn
• Không thể sử dụng các khai báo kiểu nullable cho đến khi phiên bản PHP tối thiểu là PHP 7. 1 hoặc cao hơn
• Không thể sử dụng các khai báo kiểu

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  204 và

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  205 cho đến khi phiên bản PHP tối thiểu là PHP 7. 1 hoặc cao hơn. Loại

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  205 chỉ có thể được sử dụng làm loại trả về
• Không thể sử dụng khai báo kiểu

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  207 cho đến khi phiên bản PHP tối thiểu là PHP 7. 2 hoặc cao hơn
• Không thể sử dụng khai báo loại thuộc tính cho đến khi phiên bản PHP tối thiểu là PHP 7. 4 hoặc cao hơn
• Không thể sử dụng

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  208 (chỉ loại trả về) cho đến khi phiên bản PHP tối thiểu là PHP 8. 0 hoặc cao hơn
• Không thể sử dụng loại

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  209 cho đến khi phiên bản PHP tối thiểu là PHP 8. 0 hoặc cao hơn. Hãy lưu ý rằng loại

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  209 bao gồm

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  211, do đó không thể biến thành null
• Không thể sử dụng các loại liên kết cho đến khi phiên bản PHP tối thiểu là PHP 8. 0 hoặc cao hơn
• Không thể sử dụng các loại giao lộ cho đến khi phiên bản PHP tối thiểu là PHP 8. 1 hoặc cao hơn
• Không thể sử dụng

  // Correct.
  require_once ABSPATH . 'file-name.php';
  
  // Incorrect.
  include_once  ( ABSPATH . 'file-name.php' );
  require_once     __DIR__ . '/file-name.php';
  

  212 (chỉ loại trả về) cho đến khi phiên bản PHP tối thiểu là PHP 8. 1 hoặc cao hơn
• Không thể sử dụng các loại biểu mẫu thông thường rời rạc (kết hợp các loại liên kết và các loại giao nhau) cho đến khi phiên bản PHP tối thiểu là PHP 8. 2 hoặc cao hơn
  

Cách sử dụng trong WordPress Core

Cảnh báo.
Việc thêm các khai báo kiểu vào các chức năng WordPress Core hiện có cần được thực hiện hết sức cẩn thận.

Chữ ký chức năng của bất kỳ chức năng (phương pháp) nào có thể bị quá tải bởi plugin hoặc chủ đề không được chạm vào.
Hiện tại, điều này chỉ để lại các hàm được khai báo vô điều kiện trong không gian tên chung, các phương thức lớp

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Ghi chú. Hiện tại, việc sử dụng từ khóa

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các hằng ma thuật

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi sử dụng hằng số

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi sử dụng toán tử trải rộng, phải có một khoảng trắng hoặc một dòng mới có thụt lề thích hợp trước toán tử trải rộng. Không được có khoảng trắng giữa toán tử trải rộng và lệnh gọi biến/hàm mà nó áp dụng cho. Khi kết hợp toán tử trải rộng với toán tử tham chiếu (

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Ghi chú.
Toán tử trải rộng (hoặc toán tử splat được biết đến trong các ngôn ngữ khác) có thể được sử dụng để đóng gói các đối số trong khai báo hàm (hàm biến đổi) và giải nén chúng trong các lệnh gọi hàm kể từ PHP 5. 6. Kể từ PHP 7. 4, toán tử trải rộng cũng được sử dụng để giải nén các mảng được lập chỉ mục bằng số, với tính năng giải nén mảng có khóa chuỗi có sẵn kể từ PHP 8. 1.
Khi được sử dụng trong khai báo hàm, toán tử trải rộng chỉ có thể được sử dụng với tham số cuối cùng.

Mỗi phần của tên không gian tên phải bao gồm các từ viết hoa được phân tách bằng dấu gạch dưới

Các khai báo không gian tên phải có chính xác một dòng trống trước khai báo và ít nhất một dòng trống sau

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Chỉ nên có một khai báo không gian tên cho mỗi tệp và nó phải ở đầu tệp. Không được phép khai báo không gian tên sử dụng cú pháp dấu ngoặc nhọn. Khai báo không gian tên chung rõ ràng (khai báo không gian tên không có tên) cũng không được phép

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Hiện tại không có mốc thời gian giới thiệu không gian tên cho WordPress Core

Việc sử dụng không gian tên trong plugin và chủ đề được khuyến khích mạnh mẽ. Đó là một cách tuyệt vời để thêm tiền tố vào nhiều mã của bạn để ngăn xung đột đặt tên với các plugin, chủ đề và/hoặc WordPress Core khác

Vui lòng đảm bảo rằng bạn sử dụng tiền tố không gian tên duy nhất và đủ dài để thực sự ngăn chặn xung đột. Nói chung, sử dụng tiền tố không gian tên dọc theo dòng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Cảnh báo.
Tiền tố không gian tên

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Ghi chú.
Không gian đặt tên không ảnh hưởng đến các biến, hằng được khai báo bằng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Sử dụng các câu lệnh import

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Câu lệnh nhập khẩu

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

1. // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   227 câu lệnh cho không gian tên, lớp, giao diện, đặc điểm và enums

2. // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   227 câu lệnh cho hàm

3. // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   227 câu lệnh cho hằng số

Bí danh có thể được sử dụng để tránh xung đột tên (hai lớp trong các không gian tên khác nhau sử dụng cùng một tên lớp).
Khi sử dụng bí danh, hãy đảm bảo bí danh tuân theo quy ước đặt tên của WordPress và là duy nhất.

Các ví dụ sau đây cho thấy cách sử dụng đúng và sai của câu lệnh import

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Chính xác

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Không đúng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Cảnh báo.
Nhập câu lệnh

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Ghi chú.
Lưu ý rằng, trừ khi bạn đã triển khai tự động tải, câu lệnh

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Lưu ý về việc sử dụng WordPres Core

Mặc dù các câu lệnh import

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Nhập câu lệnh

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Chẳng hạn, nếu chúng ta có một tệp tên là

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Lớp thứ hai phải ở trong tệp riêng của nó có tên là

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các câu lệnh Trait

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các ví dụ mã sau đây cho thấy các yêu cầu định dạng cho các câu lệnh đặc điểm

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Đối với tất cả các cấu trúc cho phép nó (thuộc tính, phương thức, hằng số lớp kể từ PHP 7. 1), khả năng hiển thị phải được khai báo rõ ràng.
Không được phép sử dụng từ khóa

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Cách sử dụng trong WordPress Core

Không thể sử dụng khả năng hiển thị cho các hằng số lớp trong WordPress Core cho đến khi phiên bản PHP tối thiểu được nâng lên PHP 7. 1

Khi sử dụng nhiều công cụ sửa đổi cho một khai báo lớp, thứ tự sẽ như sau

1. Đầu tiên, công cụ sửa đổi

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   249 hoặc

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   250 tùy chọn
2. Tiếp theo, công cụ sửa đổi

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   251 tùy chọn

Khi sử dụng nhiều công cụ sửa đổi cho một khai báo hằng bên trong các cấu trúc hướng đối tượng, thứ tự sẽ như sau

1. Đầu tiên, công cụ sửa đổi

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   250 tùy chọn
2. Tiếp theo, công cụ sửa đổi khả năng hiển thị

Khi sử dụng nhiều công cụ sửa đổi cho khai báo thuộc tính, thứ tự sẽ như sau

1. Đầu tiên, một công cụ sửa đổi khả năng hiển thị
2. Tiếp theo, công cụ sửa đổi

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   208 hoặc

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   251 tùy chọn (những từ khóa này loại trừ lẫn nhau)
3. Cuối cùng, khai báo tùy chọn

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   255

Khi sử dụng nhiều công cụ sửa đổi cho một khai báo phương thức, thứ tự sẽ như sau

1. Đầu tiên, công cụ sửa đổi

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   249 hoặc

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   250 tùy chọn
2. Sau đó, một công cụ sửa đổi khả năng hiển thị
3. Cuối cùng, công cụ sửa đổi

   // Correct.
   require_once ABSPATH . 'file-name.php';
   
   // Incorrect.
   include_once  ( ABSPATH . 'file-name.php' );
   require_once     __DIR__ . '/file-name.php';
   

   208 tùy chọn

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Ghi chú.
– Có thể khai báo khả năng hiển thị của hằng số OO kể từ PHP 7. 1.
– Các thuộc tính đã nhập có sẵn kể từ PHP 7. 4.
– Thuộc tính chỉ đọc có sẵn kể từ PHP 8. 1.
– Công cụ sửa đổi

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi khởi tạo một thể hiện đối tượng mới, phải luôn sử dụng dấu ngoặc đơn, ngay cả khi không thực sự cần thiết.
Không được có khoảng cách giữa tên của lớp được khởi tạo và dấu ngoặc đơn mở.

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi thực hiện so sánh logic liên quan đến biến, luôn đặt biến ở bên phải và đặt hằng, ký tự hoặc lệnh gọi hàm ở bên trái. Nếu không bên nào là một biến, thứ tự không quan trọng. (Theo thuật ngữ khoa học máy tính, khi so sánh luôn cố gắng đặt giá trị l ở bên phải và giá trị r ở bên trái. )

Trong ví dụ trên, nếu bạn bỏ qua dấu bằng (hãy thừa nhận điều đó, điều này xảy ra ngay cả với những người dày dặn kinh nghiệm nhất trong chúng ta), bạn sẽ gặp lỗi phân tích cú pháp vì bạn không thể gán cho một hằng số như

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Một chút kỳ lạ, đó là, để đọc. Làm quen với nó, bạn sẽ

Điều này áp dụng cho

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các toán tử bậc ba đều ổn, nhưng hãy luôn kiểm tra xem câu lệnh đó có đúng không, không sai. Nếu không, nó chỉ gây nhầm lẫn. (Một ngoại lệ sẽ là sử dụng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Toán tử bậc ba ngắn không được sử dụng

Ví dụ

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Như đã lưu ý trong các tài liệu PHP

PHP hỗ trợ một toán tử kiểm soát lỗi. dấu tại (@). Khi được thêm vào trước một biểu thức trong PHP, mọi lỗi chẩn đoán có thể do biểu thức đó tạo ra sẽ bị loại bỏ

Mặc dù toán tử này tồn tại trong Core, nhưng nó thường được sử dụng một cách lười biếng thay vì thực hiện kiểm tra lỗi thích hợp. Việc sử dụng nó rất không được khuyến khích, vì ngay cả các tài liệu PHP cũng nêu rõ

Cảnh báo. Trước PHP 8. 0. 0, toán tử @ có thể vô hiệu hóa các lỗi nghiêm trọng sẽ chấm dứt quá trình thực thi tập lệnh. Ví dụ: thêm @ vào lệnh gọi của một chức năng không tồn tại, do không khả dụng hoặc nhập sai, sẽ khiến tập lệnh kết thúc mà không có dấu hiệu giải thích tại sao

Tăng/giảm trước nên được ưu tiên hơn tăng/giảm sau đối với các câu lệnh độc lập

Tăng/giảm trước sẽ tăng/giảm rồi trả về, trong khi tăng/giảm sau sẽ trả về rồi tăng/giảm.
Sử dụng phiên bản “tiền” sẽ hiệu quả hơn một chút và có thể ngăn ngừa các lỗi trong tương lai khi mã được di chuyển xung quanh.

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Tránh chạm trực tiếp vào cơ sở dữ liệu. Nếu có một chức năng được xác định có thể lấy dữ liệu bạn cần, hãy sử dụng nó. Trừu tượng hóa cơ sở dữ liệu (sử dụng hàm thay vì truy vấn) giúp giữ cho mã của bạn tương thích chuyển tiếp và trong trường hợp kết quả được lưu trong bộ nhớ đệm, mã có thể nhanh hơn nhiều lần

Nếu bạn phải chạm vào cơ sở dữ liệu, hãy xem xét việc tạo một vé Trac. Ở đó, bạn có thể thảo luận về khả năng thêm chức năng mới để bao gồm chức năng bạn muốn, cho phiên bản WordPress trong tương lai

Khi định dạng các câu lệnh SQL, bạn có thể chia chúng thành nhiều dòng và thụt lề nếu nó đủ phức tạp để đảm bảo. Hầu hết các báo cáo hoạt động tốt như một dòng mặc dù. Luôn viết hoa các phần SQL của câu lệnh như

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các chức năng cập nhật cơ sở dữ liệu sẽ mong đợi các tham số của chúng thiếu dấu gạch chéo SQL thoát khi được thông qua. Thoát nên được thực hiện càng gần thời điểm truy vấn càng tốt, tốt nhất là bằng cách sử dụng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Xem Xác thực dữ liệu trong Sổ tay plugin để biết thêm chi tiết

Ưu tiên các giá trị chuỗi chỉ là

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

PHP chỉ hỗ trợ các đối số được đặt tên kể từ PHP 8. 0. Tuy nhiên, vì WordPress hiện vẫn hỗ trợ các phiên bản PHP cũ hơn nên chúng tôi chưa thể sử dụng các phiên bản đó.
Không có đối số được đặt tên, giá trị của các cờ là vô nghĩa, và mỗi khi gặp lệnh gọi hàm như ví dụ trên, chúng ta lại phải tìm kiếm định nghĩa hàm. Có thể làm cho mã dễ đọc hơn bằng cách sử dụng các giá trị chuỗi mô tả, thay vì các phép toán luận.

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi cần nhiều từ hơn để mô tả các tham số chức năng, một mảng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Hãy cẩn thận khi sử dụng mẫu này, vì nó có thể dẫn đến thông báo "Chỉ mục mảng không xác định" nếu đầu vào không được xác thực trước khi sử dụng. Chỉ sử dụng mẫu này khi nó hợp lý (tôi. e. nhiều đối số có thể), không chỉ vì lợi ích của nó

Nói chung, tính dễ đọc quan trọng hơn tính thông minh hoặc ngắn gọn

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Mặc dù dòng trên rất thông minh, nhưng bạn sẽ mất một lúc để mò mẫm nếu chưa quen. Vì vậy, chỉ cần viết nó như thế này

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Trừ khi thực sự cần thiết, không nên sử dụng phép so sánh lỏng lẻo, vì hành vi của chúng có thể gây hiểu nhầm

Chính xác

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Không đúng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Bài tập không được đặt trong câu điều kiện

Chính xác

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Không đúng

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Trong một câu lệnh

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Câu lệnh

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Cấu trúc

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Khi thích hợp, các bao đóng có thể được sử dụng thay thế cho việc tạo các hàm mới để chuyển dưới dạng gọi lại. Ví dụ

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Không nên chuyển các bao đóng dưới dạng lệnh gọi lại bộ lọc hoặc hành động, vì việc xóa chúng qua

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Các biểu thức chính quy tương thích với Perl (các hàm PCRE,

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Thuận tiện nhất là sử dụng các chuỗi trích dẫn đơn cho các biểu thức chính quy vì trái ngược với các chuỗi trích dẫn kép, chúng chỉ có hai siêu chuỗi cần thoát.

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

Mỗi #22400

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

299 là một chức năng khủng khiếp khiến mã khó gỡ lỗi hơn và khó hiểu hơn. Chúng ta nên ngăn cản việc sử dụng nó [sic] và loại bỏ tất cả những cách chúng ta sử dụng nó

Joseph Scott có một bài viết hay về lý do tại sao nó tệ

Việc sử dụng toán tử backtick giống hệt với

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

// Correct.
require_once ABSPATH . 'file-name.php';

// Incorrect.
include_once  ( ABSPATH . 'file-name.php' );
require_once     __DIR__ . '/file-name.php';

WordPress sử dụng PHP hay JavaScript?

Mã hóa WordPress là gì?

WordPress có sử dụng JavaScript không?

WordPress có sử dụng HTML không?