Kajian awal mengenai spesifikasi PHP PSR2 dan PSR4

Penerokaan awal spesifikasi PHP PSR2 dan PSR4

Pengenalan:
Dalam proses menulis kod PHP, adalah sangat penting untuk mengikuti spesifikasi pengekodan tertentu. Piawaian pengekodan yang baik boleh meningkatkan kebolehbacaan dan kebolehselenggaraan kod serta memudahkan kerja berpasukan. PHP mempunyai satu siri spesifikasi pengekodan, di mana PSR2 dan PSR4 adalah dua spesifikasi yang paling banyak digunakan. Artikel ini akan menumpukan pada spesifikasi PSR2 dan PSR4 dan menggambarkan cara mengikuti spesifikasi ini melalui contoh kod tertentu.

1. Spesifikasi PSR2
Spesifikasi PSR2 tertumpu terutamanya pada kebolehbacaan dan ketekalan kod PHP. Berikut ialah beberapa keperluan spesifikasi biasa:

1. Lekukan
2. Gunakan 4 ruang untuk lekukan, tiada tab.
3. Gunakan 4 ruang untuk satu aras inden.
4. Komen pengepala fail
5. Setiap fail PHP hendaklah mengandungi ulasan pengepala fail yang sesuai untuk menerangkan tujuan, pengarang, tarikh penciptaan dan maklumat lain fail tersebut.
6. Pemutus baris
7. Balut satu baris selepas penyataan tamat dan pastikan setiap baris tidak melebihi 80 aksara.
8. Benarkan garisan kosong antara kaedah untuk meningkatkan kebolehbacaan kod.
9. Fungsi dan kaedah
10. Nama fungsi dan nama kaedah hendaklah menggunakan tatanama huruf unta, iaitu huruf pertama ialah huruf kecil, dan huruf pertama bagi perkataan seterusnya ditulis dengan huruf besar.
11. Kurungan kiri fungsi dan kaedah hendaklah berada pada baris yang sama dengan nama fungsi atau kaedah, dan kurungan kanan hendaklah pada baris berasingan, sejajar dengan kurungan kiri fungsi atau kaedah.
12. Ruang
13. Perlu ada ruang sebelum dan selepas operator (seperti =, +, -, dll.).
14. Perlu ada ruang selepas kata kunci struktur kawalan (seperti jika, untuk, sementara, dll.).

Berikut ialah contoh kod yang mematuhi spesifikasi PSR2:

<?php
namespace MyApp;

class Calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }
    
    public function subtract($a, $b)
    {
        return $a - $b;
    }
}

$calculator = new Calculator();
$result = $calculator->add(2, 3);
echo $result;

2. Spesifikasi PSR4
Spesifikasi PSR4 terutamanya tertumpu pada ruang nama PHP dan pemuatan automatik. Berikut ialah beberapa keperluan spesifikasi biasa:

1. Ruang nama dan nama kelas
2. Gunakan huruf kecil untuk ruang nama dan gunakan "" sebagai pemisah.
3. Nama kelas menggunakan tatanama CamelCase, iaitu, huruf pertama setiap perkataan ditulis dengan huruf besar.
4. Struktur direktori
5. Kelas hendaklah konsisten dengan struktur direktori, dan setiap bahagian ruang nama sepadan dengan subdirektori.
6. Pelanjutan fail kelas hendaklah .php.
7. Automuat
8. Gunakan Komposer untuk mengurus kebergantungan dan fungsi automuat.
9. Konfigurasikan peraturan pemuatan kelas PSR4 dalam fail composer.json.

Berikut ialah contoh kod yang mematuhi spesifikasi PSR4:

(Tetapkan hubungan pemetaan antara ruang nama dan kelas dalam fail composer.json)

{
    "autoload": {
        "psr-4": {
            "MyApp\": "src/"
        }
    }
}

(Tentukan kelas Kalkulator dalam src/Calculator.php)

<?php
namespace MyApp;

class Calculator
{
    public function add($a, $b)
    {
        return $a + $b;
    }
    
    public function subtract($a, $b)
    {
        return $a - $b;
    }
}

( Gunakan autoloading dalam index.php)

<?php
require_once 'vendor/autoload.php';

use MyAppCalculator;

$calculator = new Calculator();
$result = $calculator->add(2, 3);
echo $result;

Kesimpulan:
Mengikuti spesifikasi PSR2 dan PSR4 boleh meningkatkan kebolehbacaan, kebolehselenggaraan dan kebolehskalaan kod PHP. Semasa proses pembangunan, kita harus menggunakan spesifikasi ini secara aktif dan menyemak sama ada kod itu mematuhi spesifikasi dengan menggunakan alatan seperti CodeSniffer. Ini membantu kami menulis kod PHP yang lebih baik.

Saya berharap melalui pengenalan dan contoh kod artikel ini, pembaca akan mendapat pemahaman awal tentang spesifikasi PSR2 dan PSR4 serta dapat mengaplikasikan spesifikasi ini dalam projek sebenar. Hanya dengan sentiasa belajar dan berlatih serta sentiasa meningkatkan tahap pengekodan anda boleh menjadi pembangun PHP yang cemerlang.

Atas ialah kandungan terperinci Kajian awal mengenai spesifikasi PHP PSR2 dan PSR4. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!