Contoh tunjuk cara dan panduan penggunaan spesifikasi PSR2 dan PSR4 dalam rangka kerja Phalcon

Contoh tunjuk cara dan panduan penggunaan spesifikasi PSR2 dan PSR4 dalam rangka kerja Phalcon

Pengenalan:
Dengan perisian sumber terbuka dan pembangunan, penyeragaman kod telah menjadi topik yang sangat penting. Spesifikasi kod boleh meningkatkan kebolehbacaan dan kebolehselenggaraan kod, menjadikannya lebih mudah untuk ahli pasukan bekerjasama. PHP-FIG telah membangunkan satu siri spesifikasi PSR (Syor Piawaian PHP), yang paling biasa digunakan ialah PSR2 dan PSR4. Artikel ini akan mengambil rangka kerja Phalcon sebagai contoh untuk menunjukkan dan membimbing cara menggunakan spesifikasi PSR2 dan PSR4 dalam rangka kerja Phalcon.

Bahagian Pertama: Spesifikasi PSR2

Spesifikasi PSR2 tertumpu terutamanya pada gaya dan format kod, menjadikan kod lebih mudah dibaca dan konsisten.

1. Nama fail:

   • Nama fail hendaklah menggunakan huruf besar unta dan berakhir dengan .php ialah akhiran. Contohnya, UserController.php.
.php为后缀。例如，UserController.php。

2. 代码缩进和对齐：

   • 代码缩进使用四个空格。
   • 所有的代码应该完全由空格组成，而不是制表符。

3. 类的命名和声明：

   • 类名应使用大写驼峰命名法。
   • 类文件中的命名空间声明应和文件路径匹配。
   • 类的开始大括号{应该独占一行，并且与类名再垂直对齐。
   • 类的结束大括号}应单独成行。

4. 函数和方法的命名和声明：

   • 函数和方法名应使用小写驼峰命名法。
   • 函数和方法的括号后留一个空格。
   • 方法的开始和结束大括号{}与方法名再垂直对齐。

以下是一个示例代码遵循PSR2规范：

<?php

namespace AppControllers;

class UserController
{
    public function indexAction()
    {
        // 方法体代码
    }

    public function createAction()
    {
        // 方法体代码
    }
}

第二部分：PSR4规范

PSR4规范主要关注自动加载机制，使得应用程序的文件能够按照规范的方式被自动加载。

1. 命名空间和类的映射关系：

   • 命名空间顶级路径和文件系统文件夹一一对应。
   • 类名必须包含其完整的命名空间路径。

2. 类文件的存储位置：

   • 类文件存储在与命名空间对应的文件夹中。
   • 类文件名必须与类名完全匹配，包括大小写。

下面是一个示例代码遵循PSR4规范：

<?php

use PhalconLoader;

$loader = new Loader();

$loader->registerNamespaces([
    'AppControllers' => 'app/controllers',
    'AppModels'      => 'app/models',
]);

$loader->register();

上述代码中，我们通过Phalcon的Loader类注册了命名空间AppControllers和AppModels与文件系统中的路径app/controllers和app/models

Lekukan dan penjajaran kod:

Gunakan empat ruang untuk lekukan kod. #🎜🎜#Semua kod hendaklah terdiri sepenuhnya daripada ruang, bukan tab. #🎜🎜##🎜🎜#Penamaan dan pengisytiharan kelas: #🎜🎜##🎜🎜##🎜🎜#Nama kelas hendaklah menggunakan tatanama huruf besar unta. #🎜🎜#Pengisytiharan ruang nama dalam fail kelas hendaklah sepadan dengan laluan fail. #🎜🎜#Dakap pembuka kelas { hendaklah berada pada barisnya sendiri dan dijajarkan secara menegak dengan nama kelas. #🎜🎜#Kurungan penutup } kelas hendaklah berada pada baris yang berasingan. #🎜🎜##🎜🎜# Penamaan dan pengisytiharan fungsi dan kaedah: #🎜🎜##🎜🎜##🎜🎜#Nama fungsi dan kaedah hendaklah menggunakan nomenklatur huruf kecil unta . #🎜🎜#Tinggalkan ruang selepas kurungan untuk fungsi dan kaedah. #🎜🎜#Pendakap buka dan penutup {} kaedah dijajarkan secara menegak dengan nama kaedah. #🎜🎜#Berikut ialah contoh kod mengikut spesifikasi PSR2: #🎜🎜#rrreee#🎜🎜#Bahagian 2: Spesifikasi PSR4#🎜🎜## 🎜 🎜Spesifikasi #PSR4 tertumpu terutamanya pada mekanisme pemuatan automatik, supaya fail aplikasi boleh dimuatkan secara automatik dalam cara yang standard. #🎜🎜##🎜🎜##🎜🎜##🎜🎜#Hubungan pemetaan antara ruang nama dan kelas: #🎜🎜##🎜🎜##🎜🎜#Laluan peringkat atas ruang nama sepadan dengan folder sistem fail . #🎜🎜#Nama kelas mesti termasuk laluan ruang nama lengkapnya. #🎜🎜##🎜🎜#Lokasi storan fail kelas: #🎜🎜##🎜🎜##🎜🎜#Fail kelas disimpan dalam folder yang sepadan dengan ruang nama . #🎜🎜#Nama fail kelas mesti sepadan dengan nama kelas, termasuk huruf besar. #🎜🎜#Berikut ialah contoh kod yang mengikut spesifikasi PSR4: #🎜🎜#rrreee#🎜🎜#Dalam kod di atas, kami menggunakan Phalcon's Loader Kelas mendaftarkan ruang nama AppControllers dan AppModels dengan laluan dalam sistem fail app/controllers dan padanan apl/model. Dengan cara ini, apabila menggunakan rangka kerja Phalcon, fail kelas di bawah ruang nama ini akan dimuatkan secara automatik. #🎜🎜##🎜🎜#Kesimpulan: #🎜🎜#Artikel ini memperkenalkan contoh demonstrasi dan panduan penggunaan spesifikasi PSR2 dan PSR4 dalam rangka kerja Phalcon. Dengan mengikuti konvensyen ini, kami boleh menjadikan kod kami lebih konsisten, boleh dibaca dan diselenggara serta meningkatkan kecekapan kerjasama ahli pasukan. Dalam pembangunan sebenar, sila pilih piawaian pengekodan yang sesuai berdasarkan keadaan tertentu, dan pastikan seluruh pasukan mematuhi piawaian dengan ketat. Ini membolehkan penciptaan aplikasi Phalcon yang berkualiti tinggi dan mudah diselenggara. #🎜🎜#

Atas ialah kandungan terperinci Contoh tunjuk cara dan panduan penggunaan spesifikasi PSR2 dan PSR4 dalam rangka kerja Phalcon. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!