Hướng dẫn phong cách viết mã PHP hiện đại

Các tiêu chuẩn mã hóa PSR-1 và PSR-2 xác định mã sẽ trông như thế nào.

PSR-1 là tiêu chuẩn mã hóa cơ bản cho PHP. PSR-2 là hướng dẫn phong cách mã hóa.

Trước định nghĩa của họ, người ta sẽ sao chép một tiêu chuẩn mã hóa từ một trong những khuôn khổ phổ biến xung quanh, nhưng bây giờ PHP đã có một tiêu chuẩn mã hóa chính thức, tất cả chúng ta nên hướng tới việc tuân thủ nó.

Tóm lại PSR-1

  • Tệp NÊN khai báo các ký hiệu (lớp, hàm, hằng số, v.v.) hoặc gây ra hiệu ứng phụ (ví dụ: tạo đầu ra, thay đổi cài đặt .ini, v.v.) nhưng KHÔNG NÊN làm cả hai
  • Không gian tên và lớp PHẢI tuân theo PSR "tự động tải": [PSR-0, PSR-4]
  • Tên lớp PHẢI được khai báo trong StudlyCaps
  • Tên phương thức PHẢI được khai báo trong camelCase

Tóm lại PSR-2

  • Mã PHẢI sử dụng 4 dấu cách để thụt lề, không phải tab
  • KHÔNG PHẢI có giới hạn cứng về độ dài dòng; giới hạn mềm PHẢI là 120 ký tự; dòng NÊN có từ 80 ký tự trở xuống.
  • PHẢI có một dòng trống sau khai báo không gian tên và PHẢI có một dòng trống sau khai báo khối sử dụng.
  • Khả năng hiển thị PHẢI được khai báo trên tất cả các thuộc tính và phương thức; trừu tượng và cuối cùng PHẢI được khai báo trước khả năng hiển thị; static PHẢI được khai báo sau khả năng hiển thị.
  • Mở ngoặc đơn cho cấu trúc điều khiển KHÔNG ĐƯỢC có khoảng trắng sau chúng và đóng ngoặc đơn cho cấu trúc điều khiển KHÔNG ĐƯỢC có khoảng trắng trước.

Thực thi các tiêu chuẩn

Điều cần thiết là phải biết và hiểu các tiêu chuẩn mã hóa. Có IDE hoặc trình soạn thảo của bạn tự động thực thi nó là một bước tiến lớn để tuân thủ nó.

Trên PHPStorm

Nó được tích hợp sẵn. Vào Preferences -> Editor -> Code Style -> PHP, nhấp chuột phải vào “Set from ..” và chọn “Predefined Style” -> “PSR1 / PSR2”

Trên văn bản siêu phàm

Sử dụngsublime-phpfmt