Perkongsian pengalaman praktikal projek spesifikasi PSR2 dan PSR4

Perkongsian pengalaman praktikal projek spesifikasi PSR2 dan PSR4

Kata Pengantar

Dalam pembangunan perisian moden Piawaian Pengekodan bersatu adalah sangat penting. Ia boleh meningkatkan kebolehbacaan dan kebolehselenggaraan kod dan mengurangkan geseran dalam kerja berpasukan. PHP-FIG (Kumpulan Interop Rangka Kerja PHP) telah membangunkan satu siri spesifikasi PSR, yang paling terkenal ialah PSR2 dan PSR4. Artikel ini akan berkongsi beberapa pengalaman dalam mengikuti spesifikasi PSR2 dan PSR4 dalam amalan projek dan menyediakan beberapa contoh kod khusus.

Spesifikasi PSR2

Spesifikasi PSR2 terutamanya tertumpu pada keseragaman gaya dan pemformatan kod. Berikut ialah beberapa cadangan daripada spesifikasi PSR2 yang kami ikuti dalam projek kami:

1. Lekukan kod: Gunakan 4 ruang untuk lekukan aras dan bukannya tab.

   // 错误的示例
   function helloWorld()
   {
   ∙∙echo "Hello World!";
   }
   
   // 正确的示例
   function helloWorld()
   {
   ∙∙∙∙echo "Hello World!";
   }

2. Had lebar baris: Setiap baris kod hendaklah tidak lebih daripada 80 aksara lebar.

   // 错误的示例
   function longMethodNameWithTooManyParametersAndALongReturnStatement(
   ∙∙$parameter1, $parameter2, $parameter3, $parameter4, $parameter5
   )
   {
   ∙∙∙∙//...
   }
   
   // 正确的示例
   function longMethodNameWithTooManyParametersAndALongReturnStatement(
   ∙∙$parameter1,
   ∙∙$parameter2,
   ∙∙$parameter3,
   ∙∙$parameter4,
   ∙∙$parameter5
   )
   {
   ∙∙∙∙//...
   }

3. Baris kosong: Gunakan garis kosong untuk memisahkan antara kaedah kelas dan antara blok logik kaedah.

   // 错误的示例
   class MyClass
   {
   ∙∙public function method1()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   ∙∙public function method2()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   }
   
   // 正确的示例
   class MyClass
   {
   ∙∙public function method1()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   
   ∙∙public function method2()
   ∙∙{
   ∙∙∙∙//...
   ∙∙}
   }

Spesifikasi PSR4
Spesifikasi PSR4 terutamanya tertumpu pada pelaksanaan pemuatan automatik. Berikut ialah beberapa pengalaman dengan spesifikasi PSR4 yang kami ikuti dalam projek:

1. Ruang nama dan nama kelas: Setiap kelas sepadan dengan fail bebas, dan nama fail dan nama kelas kekal konsisten dan teratur menggunakan ruang nama.

   // 文件路径：src/MyNamespace/MyClass.php
   namespace MyNamespace;
   
   class MyClass
   {
   ∙∙//...
   }

2. Auto-muat: Gunakan Komposer untuk mengurus kebergantungan dan menggunakan ciri pemuatan automatiknya dalam projek anda.

   // composer.json
   {
   ∙∙"autoload": {
   ∙∙∙∙"psr-4": {
   ∙∙∙∙∙∙"MyNamespace\": "src/"
   ∙∙∙∙}
   ∙∙}
   }

3. Struktur direktori: Struktur direktori yang mengikut spesifikasi PSR4 boleh meningkatkan organisasi dan kebolehselenggaraan kod.

   // 错误的示例
   src/
   ∙∙MyClass.php
   ∙∙MyOtherClass.php
   
   // 正确的示例
   src/
   ∙∙MyNamespace/
   ∙∙∙∙MyClass.php
   ∙∙∙∙MyOtherClass.php

Kesimpulan

Mengikut spesifikasi PSR2 dan PSR4 boleh menjadikan kod anda lebih konsisten dan boleh dibaca serta meningkatkan kecekapan kerjasama pasukan. Artikel ini menerangkan beberapa pengalaman kami mengikuti spesifikasi ini dalam projek dan menyediakan beberapa contoh kod konkrit. Sudah tentu, spesifikasi hanyalah asas Kita juga harus menggunakan spesifikasi ini secara fleksibel mengikut keperluan projek sebenar untuk mengejar kualiti kod dan kecekapan pembangunan yang lebih baik. Saya harap pengalaman ini akan membantu anda dalam projek anda menggunakan spesifikasi PSR2 dan PSR4.

Atas ialah kandungan terperinci Perkongsian pengalaman praktikal projek spesifikasi PSR2 dan PSR4. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!