cari

Generik PHP dalam Laravel 11

Oct 23, 2024 am 08:08 AM

PHP Generics in Laravel 11

Jika anda seorang pembina aplikasi web dengan Laravel dan kebetulan menggunakan PHPStan untuk analisis kod statik, anda akan mula melihat ralat baharu apabila anda menaik taraf kepada Laravel 11.x.

Dalam pemasangan Laravel baharu dengan PHPStan, kali pertama menjalankan ./vendor/bin/phpstan ralat berikut akan dilemparkan:

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------

Jadi apa yang diubah? Dalam Laravel 11, ciri HasFactory kini mempunyai PHPDoc dengan teg @template yang merupakan salah satu teg generik terpelihara. Seperti yang anda mungkin sudah meneka, generik sedang digunakan dalam banyak bahagian rangka kerja.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}

Walaupun tidak disyorkan, kategori ralat ini boleh diabaikan dengan hanya menambah baris kod ini pada fail phpstan.neon anda:

parameters:
    ignoreErrors:
        -
            identifier: missingType.generics

Tetapi, generik tidak begitu sukar untuk difahami jadi mari kita mulakan!

Apakah Generik?

Generik dalam pengaturcaraan merujuk kepada ciri yang membolehkan anda menulis kod yang boleh berfungsi dengan berbilang jenis data. Daripada menulis kod berasingan untuk setiap jenis data, anda boleh menulis sekeping kod generik tunggal yang boleh beroperasi pada pelbagai jenis sambil mengekalkan keselamatan jenis, tidak seperti menggunakan jenis umum seperti campuran atau objek.

Ambil kaedah IlluminateDatabaseConcernsBuildsQueries::first daripada Laravel 10, ia boleh mengembalikan contoh Model, objek umum, contoh kelas yang menggunakannya seperti IlluminateDatabaseEloquentBuilder atau null.

/**
 * Execute the query and get the first result.
 *
 * @param  array|string  $columns
 * @return \Illuminate\Database\Eloquent\Model|object|static|null
 */
public function first($columns = ['*'])
{
    return $this->take(1)->get($columns)->first();
}

Sintaks Generik

Generik tidak disokong dalam PHP sebagai warganegara kelas pertama, untuk mendapatkannya, kami menggunakan tag PHPDocs @template, @template-covariant, @template-contravariant, @extends, @implements dan @guna.

Peraturan jenis generik ditakrifkan menggunakan parameter jenis. Dalam PHPDocs kami menganotasinya dengan teg @template . Nama parameter jenis boleh menjadi apa sahaja, selagi anda tidak menggunakan nama kelas sedia ada. Anda juga boleh mengehadkan jenis yang boleh digunakan sebagai ganti parameter jenis dengan sempadan atas menggunakan kata kunci. Ini dipanggil parameter jenis terhad.

<?php namespace Illuminate\Database\Eloquent;

/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 *
 */
class Builder implements BuilderContract
{
}

Jenis PHP Generik

Fungsi Generik

Fungsi generik adalah sama seperti fungsi biasa, namun, ia mempunyai parameter jenis. Ini membolehkan kaedah generik digunakan dengan cara yang lebih umum.

Ambil kaedah IlluminateSupportValidatedInput::enum sebagai contoh:

  • Ia mentakrifkan parameter jenis TEnum.

  • Parameter $enumClass adalah daripada rentetan kelas jenis pseudo dan dihadkan kepada parameter jenis yang sama TEnum.

  • Jenis pemulangan juga boleh sama ada TEnum atau null.

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------

Jika anda kemudian memanggil $request→validated()→enum(‘status‘, OrderStatus::class), PHPStan akan mengetahui bahawa anda mendapat objek OrderStatus atau null!

Kelas Generik

Kelas generik membolehkan mencipta kelas yang boleh beroperasi pada sebarang jenis data sambil memastikan keselamatan jenis. Ia membolehkan kelas ditakrifkan dengan pemegang tempat untuk jenis tertentu, yang kemudiannya boleh digantikan apabila kelas itu dibuat seketika.

Contoh yang baik daripada Laravel kod sumber ialah kelas IlluminateDatabaseEloquentBuilder:

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}

Parameter jenis TModel ditakrifkan dan dihadkan kepada mana-mana subkelas IlluminateDatabaseEloquentModel. Parameter jenis yang sama digunakan sebagai jenis pemulangan kaedah yang dibuat.

Contoh lain ialah jika kita mempunyai model Pesanan, yang mempunyai skop setempat untuk menapis pesanan berdasarkan statusnya. Kaedah skop harus menentukan jenis TModel

parameters:
    ignoreErrors:
        -
            identifier: missingType.generics

ℹ️ maklumat: Semua kelas perhubungan Fasih dalam ruang nama IlluminateDatabaseEloquentRelations seperti BelongsTo dan HasOne kini generik.

Antara Muka Generik

Antara muka generik tidak begitu berbeza. IlluminateContractsSupportArrayable ialah contoh antara muka generik

/**
 * Execute the query and get the first result.
 *
 * @param  array|string  $columns
 * @return \Illuminate\Database\Eloquent\Model|object|static|null
 */
public function first($columns = ['*'])
{
    return $this->take(1)->get($columns)->first();
}

Antara muka mentakrifkan dua jenis parameter: TKey jenis tatasusunan-kunci (ia boleh menjadi int atau rentetan) dan TValue. Kedua-dua parameter ini digunakan untuk menentukan jenis pemulangan fungsi toArray. Berikut ialah contoh:

<?php namespace Illuminate\Database\Eloquent;

/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 *
 */
class Builder implements BuilderContract
{
}

Kelas pengguna melaksanakan antara muka Boleh Susun dan menentukan jenis Tkey sebagai int dan TValue sebagai rentetan.

Sifat Generik

Kami menemui sifat IlluminateDatabaseEloquentFactoriesHasFactory dalam ralat pada permulaan siaran ini. Mari lihat lebih dekat:

/**
 * @template TEnum
 *
 * @param string $key
 * @param class-string<tenum> $enumClass
 * @return TEnum|null
 */
public function enum($key, $enumClass)
{
    if ($this->isNotFilled($key) ||
        ! enum_exists($enumClass) ||
        ! method_exists($enumClass, 'tryFrom')) {
        return null;
    }
    return $enumClass::tryFrom($this->input($key));
}
</tenum>

HasFactory mentakrifkan parameter jenis TFactory yang dihadkan kepada subkelas IlluminateDatabaseEloquentFactoriesFactory. Jadi bagaimanakah ralat itu boleh dibetulkan?

Jenis TFactory mesti dinyatakan apabila sifat sedang digunakan. Jadi, pernyataan penggunaan ciri HasFactory perlu dianotasi dengan PHPDocs @use:

<?php namespace Illuminate\Database\Eloquent;
/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 */
class Builder implements BuilderContract
{
    /**
     * @param  array  $attributes
     * @return TModel
     */
    public function make(array $attributes = [])
    {
        return $this->newModelInstance($attributes);
    }
}

Memelihara Generik

Apabila melanjutkan kelas, melaksanakan antara muka atau menggunakan ciri adalah mungkin untuk mengekalkan generik dalam subkelas.

Memelihara generik dilaksanakan dengan mentakrifkan parameter jenis yang sama di atas kelas kanak-kanak dan menghantarnya kepada @extends, @implements dan @use tag.

Kami akan menggunakan sifat generik IlluminateDatabaseConcernsBuildsQueries sebagai contoh,

ia mentakrifkan parameter jenis TValue:

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------

Kelas IlluminateDatabaseEloquentBuilder menggunakan sifat ini tetapi mengekalkan generiknya dengan menghantar jenis parameter TModel kepadanya. Ia kini diserahkan kepada kod pelanggan untuk menentukan jenis TModel dan seterusnya TValue dalam sifat BuildsQueries.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}

Fikiran Akhir

Kesimpulannya, walaupun PHP tidak menyokong generik secara asli dengan cara yang sama seperti beberapa bahasa pengaturcaraan lain, pengenalan petunjuk dan alatan jenis lanjutan seperti PHPStan membolehkan pembangun melaksanakan fungsi seperti generik dalam kod mereka . Dengan memanfaatkan PHPDocs, kelas berparameter dan antara muka, anda boleh mencipta aplikasi yang lebih fleksibel dan selamat jenis yang menggalakkan kebolehgunaan semula dan kebolehselenggaraan kod. Memandangkan PHP terus berkembang, tumpuan komuniti yang semakin meningkat pada keselamatan jenis dan analisis statik mungkin akan membawa kepada penyelesaian yang lebih mantap untuk melaksanakan generik. Menerima amalan ini bukan sahaja meningkatkan kemahiran pengekodan anda tetapi juga menyumbang kepada pembangunan perisian berkualiti tinggi yang tahan ujian masa.

Atas ialah kandungan terperinci Generik PHP dalam Laravel 11. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!

Kenyataan
Kandungan artikel ini disumbangkan secara sukarela oleh netizen, dan hak cipta adalah milik pengarang asal. Laman web ini tidak memikul tanggungjawab undang-undang yang sepadan. Jika anda menemui sebarang kandungan yang disyaki plagiarisme atau pelanggaran, sila hubungi admin@php.cn
Bagaimanakah PHP mengenal pasti sesi pengguna?Bagaimanakah PHP mengenal pasti sesi pengguna?May 01, 2025 am 12:23 AM

Phpidentifierauser'sSessionusingSessionCookiesandSessionIds.1) whensession_start () ISCALLED, phpGeneratesAuniquesessionIdstoredinacookienamedPhpsessidontheUserer'sBrowser.2) ThisIdallowsPhptoretRievesSessionDataFromtheserver.

Apakah beberapa amalan terbaik untuk mendapatkan sesi PHP?Apakah beberapa amalan terbaik untuk mendapatkan sesi PHP?May 01, 2025 am 12:22 AM

Keselamatan sesi PHP boleh dicapai melalui langkah -langkah berikut: 1. Gunakan session_regenerate_id () untuk menjana semula ID sesi apabila pengguna log masuk atau merupakan operasi penting. 2. Sulitkan ID sesi penghantaran melalui protokol HTTPS. 3. Gunakan session_save_path () untuk menentukan direktori selamat untuk menyimpan data sesi dan menetapkan kebenaran dengan betul.

Di manakah fail sesi php disimpan secara lalai?Di manakah fail sesi php disimpan secara lalai?May 01, 2025 am 12:15 AM

PhpsessionFileSarestoredIntHedirectorySpecifiedBySession.save_path, biasanya/tmponunix-likesystemsorc: \ windows \ temponwindows.tocustomethis: 1) usession_save_path ()

Bagaimana anda mengambil data dari sesi PHP?Bagaimana anda mengambil data dari sesi PHP?May 01, 2025 am 12:11 AM

ToretrievedataFromaphpsession, startTheSessionWithSsion_start () andaccessVariablesInthe $ _SessionArray.Forexample: 1) startTheSession: session_start ()

Bagaimana anda boleh menggunakan sesi untuk melaksanakan keranjang belanja?Bagaimana anda boleh menggunakan sesi untuk melaksanakan keranjang belanja?May 01, 2025 am 12:10 AM

Langkah -langkah untuk membina sistem keranjang belanja yang cekap menggunakan sesi termasuk: 1) Memahami definisi dan fungsi sesi. Sesi ini adalah mekanisme penyimpanan sisi pelayan yang digunakan untuk mengekalkan status pengguna merentasi permintaan; 2) melaksanakan pengurusan sesi asas, seperti menambah produk ke keranjang belanja; 3) memperluas penggunaan lanjutan, menyokong pengurusan kuantiti produk dan penghapusan; 4) Mengoptimumkan prestasi dan keselamatan, dengan berterusan data sesi dan menggunakan pengecam sesi yang selamat.

Bagaimana anda membuat dan menggunakan antara muka dalam PHP?Bagaimana anda membuat dan menggunakan antara muka dalam PHP?Apr 30, 2025 pm 03:40 PM

Artikel ini menerangkan cara membuat, melaksanakan, dan menggunakan antara muka dalam PHP, memberi tumpuan kepada manfaat mereka untuk organisasi kod dan penyelenggaraan.

Apakah perbezaan antara crypt () dan password_hash ()?Apakah perbezaan antara crypt () dan password_hash ()?Apr 30, 2025 pm 03:39 PM

Artikel ini membincangkan perbezaan antara crypt () dan password_hash () dalam php untuk hashing kata laluan, memberi tumpuan kepada pelaksanaan, keselamatan, dan kesesuaian untuk aplikasi web moden.

Bagaimanakah anda dapat mencegah skrip lintas tapak (XSS) dalam PHP?Bagaimanakah anda dapat mencegah skrip lintas tapak (XSS) dalam PHP?Apr 30, 2025 pm 03:38 PM

Artikel membincangkan mencegah skrip lintas tapak (XSS) dalam PHP melalui pengesahan input, pengekodan output, dan menggunakan alat seperti OWASP ESAPI dan pembersih HTML.

See all articles

Alat AI Hot

Undresser.AI Undress

Undresser.AI Undress

Apl berkuasa AI untuk mencipta foto bogel yang realistik

AI Clothes Remover

AI Clothes Remover

Alat AI dalam talian untuk mengeluarkan pakaian daripada foto.

Undress AI Tool

Undress AI Tool

Gambar buka pakaian secara percuma

Clothoff.io

Clothoff.io

Penyingkiran pakaian AI

Video Face Swap

Video Face Swap

Tukar muka dalam mana-mana video dengan mudah menggunakan alat tukar muka AI percuma kami!

Alat panas

EditPlus versi Cina retak

EditPlus versi Cina retak

Saiz kecil, penyerlahan sintaks, tidak menyokong fungsi gesaan kod

PhpStorm versi Mac

PhpStorm versi Mac

Alat pembangunan bersepadu PHP profesional terkini (2018.2.1).

SecLists

SecLists

SecLists ialah rakan penguji keselamatan muktamad. Ia ialah koleksi pelbagai jenis senarai yang kerap digunakan semasa penilaian keselamatan, semuanya di satu tempat. SecLists membantu menjadikan ujian keselamatan lebih cekap dan produktif dengan menyediakan semua senarai yang mungkin diperlukan oleh penguji keselamatan dengan mudah. Jenis senarai termasuk nama pengguna, kata laluan, URL, muatan kabur, corak data sensitif, cangkerang web dan banyak lagi. Penguji hanya boleh menarik repositori ini ke mesin ujian baharu dan dia akan mempunyai akses kepada setiap jenis senarai yang dia perlukan.

Pelayar Peperiksaan Selamat

Pelayar Peperiksaan Selamat

Pelayar Peperiksaan Selamat ialah persekitaran pelayar selamat untuk mengambil peperiksaan dalam talian dengan selamat. Perisian ini menukar mana-mana komputer menjadi stesen kerja yang selamat. Ia mengawal akses kepada mana-mana utiliti dan menghalang pelajar daripada menggunakan sumber yang tidak dibenarkan.

Hantar Studio 13.0.1

Hantar Studio 13.0.1

Persekitaran pembangunan bersepadu PHP yang berkuasa