Piawaian PSR adalah satu set garis panduan pengekodan yang dibuat oleh PHP-FIG untuk menggalakkan konsistensi dan interoperabilitas di seluruh projek PHP. Mereka termasuk PSR-1, yang meliputi piawaian pengekodan asas seperti penggunaan tag PHP dan konvensyen penamaan; PSR-4, yang mentakrifkan standard autoloading untuk laluan fail kelas; dan PSR-12, yang berkembang pada PSR-1 dengan peraturan pemformatan terperinci. PSR lain, seperti PSR-3 dan PSR-7, tingkah laku alamat dan bukan gaya. Piawaian ini penting kerana mereka memastikan konsistensi merentasi projek, meningkatkan kebolehbacaan dan penyelenggaraan kod, meningkatkan kerjasama, dan memastikan keserasian dengan alat seperti komposer dan phpunit. Untuk memohon piawaian PSR, pemaju boleh menggunakan formatters automatik seperti php-cs-fixer, menubuhkan cangkuk pra-komite git, membolehkan format auto dalam IDE, struktur projek baru mengikut PSR-4, dan mengkonfigurasi Composer.json dengan betul untuk autoloading. Walaupun tidak wajib, berikutan piawaian PSR dianggap amalan terbaik dalam pembangunan PHP profesional.

Piawaian PHP PSR-short untuk cadangan piawaian PHP-adalah satu set garis panduan pengekodan yang dicipta oleh Rangka Kerja PHP Interop Group (PHP-FIG). Piawaian ini bertujuan untuk menggalakkan konsistensi dan interoperabilitas di seluruh projek dan kerangka PHP yang berlainan. Mereka tidak menguatkuasakan bagaimana anda menulis logik anda, tetapi mereka menentukan bagaimana kod harus berstruktur dan diformat.

Apa sebenarnya piawaian PSR?

PSR bermula dengan beberapa cadangan asas dan telah berkembang dari masa ke masa. Yang paling sering dirujuk adalah:

• PSR-1 : Standard Pengekodan Asas-Meliputi perkara seperti menggunakan tag <?php dengan betul, kelas dan kaedah penamaan konvensyen, dan menggunakan ruang nama.
• PSR-4 : Standard Autoloading-Menentukan bagaimana kelas harus memetakan laluan supaya autoloading berfungsi dengan lancar.
• PSR-12 (dahulunya dikenali sebagai Panduan Gaya Pengekodan Lanjutan): Dibina pada PSR-1 dan PSR-12 dengan peraturan pemformatan yang lebih terperinci, seperti lekukan, jarak sekitar pengendali, dan panjang garis.

Terdapat PSR lain juga seperti PSR-3 untuk pembalakan, PSR-7 untuk mesej HTTP-tetapi mereka lebih banyak tentang tingkah laku daripada gaya kod.

Mengapa anda perlu mengambil berat tentang piawaian PSR?

Anda mungkin tertanya -tanya mengapa piawaian ini penting jika kod anda masih berjalan tanpa mereka. Inilah sebabnya mereka penting:

• Konsistensi merentasi projek : Apabila pelbagai pemaju bekerja pada projek yang sama-atau apabila anda menggunakan perpustakaan pihak ketiga-ia membantu jika semua orang mengikuti struktur yang sama.
• Pembacaan dan penyelenggaraan kod yang lebih mudah : Gaya seragam menjadikannya lebih mudah untuk membaca dan memahami kod yang ditulis oleh orang lain (atau bahkan diri anda bulan kemudian).
• Kerjasama yang lebih baik : Projek sumber terbuka sering memerlukan penyumbang untuk mengikuti piawaian PSR supaya menggabungkan dan mengkaji semula kod lebih lancar.
• Keserasian dengan alat dan perpustakaan : Banyak alat PHP moden (seperti komposer, phpunit, dan ides) mengharapkan psr-4 autoloading atau psr-12 formatting.

Jika anda membina pakej yang dimaksudkan untuk digunakan semula di seluruh aplikasi atau dikongsi secara terbuka, berikutan piawaian PSR menjadikan integrasi lebih mudah.

Cara Memohon Piawaian PSR dalam Projek Anda

Memohon piawaian PSR tidak perlu sukar. Inilah cara memulakan:

• Gunakan formatter kod automatik seperti php-cs-fixer atau php_codesniffer untuk memeriksa dan menetapkan gaya kod anda mengikut peraturan PSR.
• Sediakan cangkuk pra-komit dalam git untuk memastikan kod ditolak ke repo anda sudah mematuhi piawaian.
• Kebanyakan IDE moden (seperti PHPStorm atau VSCode dengan sambungan yang sesuai) boleh kod auto-format pada SAVE berdasarkan peraturan PSR.
• Jika anda memulakan projek baru, pastikan struktur folder dan persediaan ruang nama anda sejajar dengan PSR-4 dari hari pertama.

Komposer juga menyokong Autoloading PSR-4 dari kotak, jadi menentukan bahagian autoload anda dengan betul dalam composer.json adalah kunci.

Pemikiran terakhir

Piawaian PSR tidak wajib, tetapi mereka telah menjadi cara de facto untuk menyusun dan memformat kod PHP dalam persekitaran profesional. Sama ada anda bekerja bersendirian atau dalam satu pasukan, berpegang pada PSR menjadikan codebase pembersih, lebih mudah diramalkan, dan lebih mudah untuk skala.

Dan dengan jujur, apabila anda membiasakannya, menulis kod patuh PSR hanya menjadi sifat kedua.

Atas ialah kandungan terperinci Apakah piawaian PHP PSR dan mengapa mereka penting?. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!