Dari `Campuran` ke` void`: Panduan Praktikal untuk PHP REBAT Type Declarations

Jenis pulangan dalam PHP meningkatkan kebolehpercayaan kod dan kejelasan dengan menentukan fungsi apa yang mesti dikembalikan. 2. Gunakan jenis asas seperti rentetan, array, atau datetime untuk menguatkuasakan nilai pulangan yang betul dan menangkap kesilapan awal. 3. Memohon jenis yang boleh dibatalkan dengan? (contohnya ,? String) Apabila null adalah nilai pulangan yang sah. 4. Gunakan kekosongan untuk fungsi yang melakukan tindakan tanpa mengembalikan data, hanya membolehkan pulangan; atau tiada pernyataan pulangan. 5. Jenis kesatuan leverage (contohnya, rentetan | int | bool) dalam Php 8.0 untuk fungsi yang mengembalikan pelbagai jenis yang berbeza. 6. Lebih suka pengisytiharan jenis pulangan yang jelas mengenai campuran yang tersirat untuk meningkatkan sokongan dan penyelenggaraan IDE. 7. Elakkan jenis kesatuan yang terlalu banyak dan bercampur -campur, menempah bercampur untuk kes -kes di mana jenis mana -mana yang dijangkakan. 8. Mengendalikan fungsi PHP dalaman dengan teliti dengan menyelaraskan jenis pulangan dengan tingkah laku mereka, seperti menukar palsu kepada null untuk? Int. 9. Jangan kembali null dalam fungsi tidak sah untuk mengelakkan kekeliruan, walaupun secara teknikal dibenarkan. 10. Mengamalkan jenis pulangan secara progresif, bermula dengan logik teras dan API, untuk menjadikan kod lebih mudah diramalkan dan kurang rawan kesilapan sambil mengekalkan kebolehbacaan dan niat.

Sistem jenis PHP telah berkembang dengan ketara sejak hari -hari awalnya, dan pengisytiharan jenis pulangan adalah asas untuk menulis lebih banyak kod yang boleh diramal dan dikekalkan. Sekiranya anda pernah bekerja dengan fungsi php yang ditaip secara longgar, rentetan, tatasusunan, atau null tanpa kontrak yang jelas -anda mungkin berjalan ke dalam pepijat yang sukar dikesan. Di sinilah jenis pulangan masuk.

Bermula dengan PHP 7.0, kini anda boleh menentukan fungsi apa yang harus dikembalikan, membantu kedua -dua enjin dan rakan sepasukan anda memahami niat kod anda. Panduan ini membimbing anda daripada tidak menggunakan jenis ( mixed , walaupun tidak selalu eksplisit) untuk memeluk void , dengan contoh praktikal dan amalan terbaik.

Mengapa jenis pulangan penting

Sebelum menyelam ke dalam sintaks, patut difahami mengapa jenis pulangan membantu:

• Tangkap Bugs Awal : Mengembalikan array apabila anda mengharapkan rentetan? PHP akan membuang TypeError.
• Meningkatkan kebolehbacaan kod : Sesiapa yang membaca fungsi anda tahu apa yang diharapkan.
• Dayakan sokongan IDE yang lebih baik : Autocompletion, refactoring, dan dokumen sebaris menjadi lebih tepat.
• Galakkan reka bentuk yang disengajakan : Anda berfikir lebih sukar tentang apa fungsi anda harus kembali.

Tanpa jenis pulangan, segala -galanya mixed dengan berkesan -a nilai mana -mana jenis. Walaupun fleksibel, ini membawa kepada ketidakpastian. Jenis pulangan membolehkan anda menyempitkannya.

Jenis Pulangan Asas: Dari rentetan ke objek

Anda boleh mengisytiharkan jenis pulangan untuk semua jenis biasa:

 fungsi getUserName (): String {
    kembali "Alice";
}

fungsi getUserData (): array {
    kembali ['nama' => 'Alice', 'umur' => 30];
}

fungsi createdAteTime (): datetime {
    kembali DateTime baru ();
}

Sekiranya anda melanggar kontrak:

 fungsi getUserName (): String {
    kembali null; // Ralat maut: nilai pulangan mestilah jenis rentetan, null dikembalikan
}

Kecuali anda membenarkan null secara eksplisit menggunakan jenis yang tidak dapat dipertahankan:

 fungsi getUserName () :? String {
    kembali null; // ini sekarang sah
}

? Awalan bermaksud "jenis ini atau null".

Bila Menggunakan void : Fungsi yang tidak mengembalikan apa -apa

Gunakan void apabila fungsi melakukan tindakan tetapi tidak mengembalikan data yang bermakna seperti pembalakan, percetakan, atau mengubah keadaan.

 fungsi logMessage (string $ mesej): void {
    file_put_contents ('log.txt', $ mesej. php_eol, file_append);
    // Tiada pernyataan pulangan yang diperlukan
}

Atau dengan return; :

 fungsi abortifNotAdmin (pengguna $ pengguna): void {
    jika (! $ user-> isAdmin ()) {
        mati ('akses ditolak');
    }
    kembali; // Pilihan, tetapi dibenarkan
}

Peraturan Utama untuk void :

• Anda tidak boleh mengembalikan nilai: return 5; → Kesalahan maut.
• return; tanpa nilai dibenarkan (sama seperti tidak kembali).
• null bukan nilai pulangan yang sah sama ada.

Ini menguatkuasakan idea: "Fungsi ini melakukan sesuatu, tetapi tidak memberi anda apa -apa kembali."

Mengendalikan jenis pilihan atau berbilang dengan jenis kesatuan (Php 8.0)

Sebelum PHP 8.0, anda tidak dapat menyatakan "ini mengembalikan rentetan atau bool". Sekarang anda boleh:

 fungsi findUser (int $ id) :? user {
    // mengembalikan pengguna atau batal
}

Lebih baik dengan jenis kesatuan:

 Fungsi ProcessInput ($ input): String | int | bool {
    jika ($ input === '') {
        kembali palsu;
    }
    jika (is_numeric ($ input)) {
        kembali (int) $ input;
    }
    kembali trim ($ input);
}

Ini menjadikan kontrak kembali jelas dan bukannya meninggalkannya sebagai mixed tanpa dokumen.

? Petua: Elakkan jenis kesatuan yang terlalu banyak. Jika fungsi mengembalikan terlalu banyak jenis, pertimbangkan sama ada ia melakukan terlalu banyak.

Perangkap biasa dan amalan terbaik

Berikut adalah beberapa perkara untuk diperhatikan:

• Jangan tambahkan jenis hanya demi itu
  Mulakan dengan fungsi kritikal (API, Logik Teras), bukan setiap penolong.

• Berhati -hati dengan fungsi PHP dalaman
  Ada yang kembali false atas kegagalan (contohnya, strpos() ). Padanan Harapan:

   fungsi findPosition (String $ haystack, string $ jarum) :? int {
      $ pos = strpos ($ haystack, $ jarum);
      kembali $ pos === palsu? NULL: $ POS;
  }

  Sekarang jenis pulangan adalah ?int , yang lebih jelas daripada int|false .

• Gunakan mixed dengan sengaja (Php 8.0)
  Jika fungsi benar -benar menerima atau mengembalikan sebarang jenis, gunakan mixed :

   fungsi debugprint (nilai $ bercampur): void {
      var_dump ($ nilai);
  }

  Ini lebih baik daripada tiada jenis petunjuk sama sekali.

• Elakkan return null; dalam fungsi void
  Walaupun dibenarkan, ia boleh mengelirukan pembaca. Hilangkan return kecuali anda keluar awal.

---

Ringkasan

Bergerak dari Unyped ( mixed oleh konvensyen) ke fungsi yang ditaip dengan baik menjadikan kod PHP anda lebih mantap:

• Gunakan jenis tertentu ( string , array , User ) apabila anda mengetahui nilai pulangan.
• Gunakan ?Type Apabila null adalah tindak balas yang sah.
• Gunakan void untuk fungsi sampingan sahaja.
• Gunakan jenis kesatuan ( string|int ) apabila pelbagai jenis dijangka.
• Gunakan mixed dengan berhati -hati dan sengaja.

Matlamatnya bukanlah untuk menaip segala-galanya pada tahap maksimum, tetapi untuk menjadikan tingkah laku kod anda lebih jelas dan kurang rawan kesilapan.

Pada asasnya: Jika fungsi anda menjanjikan jenis kembali, pastikan ia menyimpan janji itu. PHP akan membantu anda menguatkuasakannya.

Atas ialah kandungan terperinci Dari `Campuran` ke` void`: Panduan Praktikal untuk PHP REBAT Type Declarations. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!