Memodenkan asas kod anda dengan jenis kesatuan Php 8

Menaik taraf PHP 7.x Codebases ke Php 8 dengan menggantikan jenis phpDoc yang diisi seperti @Param String | Int dengan jenis kesatuan asli seperti String | int untuk parameter dan jenis pulangan, yang meningkatkan keselamatan dan kejelasan jenis; 2. Sapukan jenis kesatuan kepada parameter input bercampur (contohnya, int | rentetan untuk ID), nilai nullable atau multi-jenis (misalnya, rentetan | int | null), dan fungsi yang mengembalikan pelbagai jenis yang mungkin (misalnya, pengguna | palsu); 3. Ikuti amalan terbaik dengan mengelakkan jenis campuran, memerintahkan jenis kesatuan secara konsisten (contohnya, yang paling biasa pertama), membolehkan pengisytiharan (strict_types = 1), mengeluarkan anotasi phpDoc yang berlebihan, dan memastikan keserasian IDE dan perkakas dengan PHP 8; 4. Elakkan perangkap seperti menggunakan kekosongan atau bercampur -campur dalam kesatuan, terlalu luas dengan jenis objek, dan mengabaikan untuk mengemas kini perkakas; 5. Contoh-contoh refactor seperti parsevalue untuk menggunakan jenis kesatuan asli, mengakibatkan kod pembersihan diri yang lebih bersih, lebih selamat, dan diri yang menangkap kesilapan sebelum ini dan meningkatkan pengalaman pemaju.

Menaik taraf PHP CodeBase anda untuk memanfaatkan jenis kesatuan PHP 8 bukan hanya menggunakan sintaks baru-ia adalah peluang untuk menjadikan kod anda lebih ekspresif, mendokumentasikan diri, dan kurang rawan kesilapan. Jika anda bergerak dari Php 7.x hingga Php 8, jenis kesatuan dapat meningkatkan keselamatan dan kejelasan jenis, terutamanya dalam aplikasi dunia nyata di mana pembolehubah atau parameter sering menerima lebih daripada satu jenis.

Inilah cara untuk memodenkan kod anda dengan berkesan menggunakan jenis kesatuan.

Apakah jenis kesatuan?

Dalam Php 8.0, jenis kesatuan membolehkan anda menentukan bahawa parameter, nilai pulangan, atau harta boleh menjadi salah satu daripada beberapa jenis. Sebelum Php 8, anda sama ada bergantung pada komen phpDoc atau tiada jenis petunjuk sama sekali:

 // php 7 - tiada sokongan kesatuan asli
/**
 * @param String | int $ id
 * @Return Array | Bool
 */
fungsi findUser ($ id) {...}

Sekarang, dengan Php 8, anda boleh menyatakan ini secara langsung dalam tandatangan:

 Fungsi FindUser (int | String $ id): Array | Bool {
    // ...
}

Ini dikuatkuasakan semasa runtime, jadi jenis tidak sah mencetuskan TypeError , dan IDE dapat memberikan autokomplet dan analisis yang lebih baik.

Di mana untuk memohon jenis kesatuan dalam asas kod anda

Cari corak biasa ini semasa menaik taraf:

1. Parameter dengan jenis input bercampur

Banyak fungsi menerima ID yang boleh menjadi bilangan bulat atau rentetan (misalnya, UUIDs vs ID DB Auto-Incremented):

 Fungsi Awam LoadRecord (int | String $ id) :? Objek
{
    // ...
}

Ini menggantikan cast string mixed atau longgar yang samar -samar dan membuat input yang sah secara eksplisit.

2. Jenis yang boleh dibatalkan (lebih baik daripada ?Type )

Sementara ?string adalah Shorthand untuk string|null , Jenis Kesatuan memberi anda lebih banyak fleksibiliti:

 fungsi setStatus (String | int | null $ status): void {...}

Di sini, ?string tidak akan meliputi int , jadi jenis kesatuan diperlukan.

3. Jenis pulangan dengan pelbagai kemungkinan

Fungsi yang mengembalikan data atau false terhadap kegagalan (corak PHP biasa) kini boleh ditaip dengan tepat:

 fungsi findByemail (String $ e -mel): Pengguna | Palsu
{
    kembali $ this-> pengguna-> cari ($ e-mel) ?: palsu;
}

Lebih baik: Pertimbangkan untuk kembali ?User (iaitu, User|null ) sebaliknya dan menempah false untuk kes -kes yang luar biasa - tetapi jika asas anda menggunakan false , sekurang -kurangnya sekarang ia didokumenkan.

Amalan terbaik semasa memodenkan

• Elakkan terlalu banyak mixed
  Walaupun mixed dibenarkan, lebih suka kesatuan tertentu. int|float|string mungkin verbose, tetapi ia memberitahu penelepon dengan tepat apa yang diharapkan.

• Jenis pesanan secara konsisten
  Tidak ada perintah yang dikuatkuasakan, tetapi banyak pasukan disusun mengikut kekhususan atau kekerapan:

   Logerror Fungsi Awam (String | Array $ Mesej): Kekosongan

  (Letakkan jenis yang paling biasa terlebih dahulu.)

• Gunakan dengan strict_types=1
  Dayakan ketat menaip untuk menangkap ketidakcocokan jenis awal:

   mengisytiharkan (strict_types = 1);

• Kemas kini phpdoc hanya apabila perlu
  Jenis kesatuan asli membuat banyak @param dan @return anotasi berlebihan. Keluarkan mereka untuk mengelakkan pertindihan dan ketidakcocokan yang berpotensi.

Berhati -hati untuk perangkap

• Tiada sokongan untuk void dalam kesatuan
  Anda tidak boleh melakukan string|void - void bermaksud "tidak pulangan", jadi tidak masuk akal dalam kesatuan.

• Tidak ada sokongan untuk mixed dalam kesatuan
  mixed|bool tidak sah kerana mixed sudah termasuk semua jenis.

• Berhati -hati dengan object
  Walaupun anda boleh menggunakan object|resource , ingat bahawa object adalah luas. Lebih suka jenis kelas tertentu jika mungkin.

• Keserasian IDE dan Alat
  Pastikan IDE anda, Linter (seperti phpstan atau mazmur), dan alat CI menyokong Php 8. Versi lama mungkin tidak memahami jenis kesatuan.

Contoh: Sebelum dan Selepas

Sebelum (Php 7):

 /**
 * @param int | string $ nilai
 * @return array
 */
fungsi parsevalue (nilai $)
{
    jika (is_string ($ nilai)) {
        pulangan meletup (',', $ nilai);
    }
    kembali [$ nilai];
}

Selepas (Php 8):

 fungsi parsevalue (int | string $ nilai): array
{
    pulangan is_string (nilai $)? meletup (',', $ nilai): [$ nilai];
}

Bersih, lebih selamat, dan mendokumentasikan diri.

Memodenkan dengan jenis kesatuan adalah salah satu peningkatan yang paling berkesan yang boleh anda buat ketika mengadopsi Php 8. Ia mengurangkan kekaburan, meningkatkan sokongan perkakas, dan menangkap pepijat lebih awal. Mulakan dengan mengenal pasti fungsi dengan kesatuan phpDoc yang dilawati, kemudian gunakan sintaks asli-dan jangan lupa untuk menjalankan ujian.

Pada asasnya, jika fungsi anda sudah mempunyai @param string|int dalam docblock, ia adalah calon yang sempurna. Hanya keluarkan komen dan tambahkan jenis sebenar. Itulah php moden.

Atas ialah kandungan terperinci Memodenkan asas kod anda dengan jenis kesatuan Php 8. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!