Heim Backend-Entwicklung PHP-Tutorial PHP-Generika in Laravel 11

PHP-Generika in Laravel 11

Oct 23, 2024 am 08:08 AM

PHP Generics in Laravel 11

Wenn Sie Webanwendungen mit Laravel erstellen und PHPStan für die statische Codeanalyse verwenden, werden beim Upgrade auf Laravel 11.x.

Bei einer Neuinstallation von Laravel mit

PHPStan wird beim ersten Ausführen von ./vendor/bin/phpstan der folgende Fehler ausgegeben:

 ------ -----------------------------------------------------------------------------------
  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
 ------ -----------------------------------------------------------------------------------
Nach dem Login kopieren
Nach dem Login kopieren
Nach dem Login kopieren
Was wurde also geändert? In Laravel 11 verfügt das HasFactory-Merkmal jetzt über ein

PHPDoc mit dem @template-Tag, das eines der reservierten generischen Tags ist. Wie Sie vielleicht schon vermutet haben, werden in vielen Teilen des Frameworks Generika verwendet.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}
Nach dem Login kopieren
Nach dem Login kopieren
Nach dem Login kopieren
Obwohl dies nicht empfohlen wird, kann diese Fehlerkategorie ignoriert werden, indem Sie einfach die folgenden Codezeilen zu Ihrer phpstan.neon-Datei hinzufügen:


parameters:
    ignoreErrors:
        -
            identifier: missingType.generics
Nach dem Login kopieren
Nach dem Login kopieren
Aber Generika sind nicht so schwer zu verstehen, also fangen wir an!

Was sind Generika?

Generika beziehen sich in der Programmierung auf eine Funktion, die es Ihnen ermöglicht, Code zu schreiben, der mit mehreren Datentypen arbeiten kann. Anstatt für jeden Datentyp separaten Code zu schreiben, können Sie einen einzelnen, generischen Codeabschnitt schreiben, der mit verschiedenen Typen arbeiten kann und dabei die Typsicherheit aufrechterhält, im Gegensatz zur Verwendung allgemeiner Typen wie gemischt oder Objekt.

Nehmen Sie die IlluminateDatabaseConcernsBuildsQueries::first-Methode aus

Laravel 10, sie kann eine Instanz von Model, ein allgemeines Objekt, eine Instanz der Klasse, die es verwendet, wie IlluminateDatabaseEloquentBuilder oder null, zurückgeben.

/**
 * 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();
}
Nach dem Login kopieren
Nach dem Login kopieren
Generika-Syntax

Generika werden in PHP als erstklassiger Bürger nicht unterstützt. Um sie zu haben, verwenden wir die

PHPDocs-Tags @template, @template-covariant, @template-contravariant, @extends, @implements und @use.

Die Regeln der generischen Typen werden mithilfe von

Typparametern definiert. In PHPDocs kommentieren wir sie mit dem @template-Tag. Der Name des Typparameters kann beliebig sein, solange Sie keinen vorhandenen Klassennamen verwenden. Sie können mithilfe des Schlüsselworts of auch mit einer Obergrenze einschränken, welche Typen anstelle des Typparameters verwendet werden können. Dies wird als begrenzter Typparameter bezeichnet

<?php

namespace Illuminate\Database\Eloquent;

/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 *
 */
class Builder implements BuilderContract
{
}
Nach dem Login kopieren
Nach dem Login kopieren
Arten von PHP-Generika

Generische Funktion

Eine generische Funktion ist genau wie eine normale Funktion, verfügt jedoch über Typparameter. Dadurch kann die generische Methode allgemeiner genutzt werden.

Nehmen Sie die Methode IlluminateSupportValidatedInput::enum als Beispiel:

  • Es definiert einen Typparameter TEnum.

  • Der $enumClass-Parameter ist vom Pseudotyp „class-string“ und an den gleichen Typparameter TEnum gebunden.

  • Der Rückgabetyp kann auch entweder TEnum oder null sein.


 ------ -----------------------------------------------------------------------------------
  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
 ------ -----------------------------------------------------------------------------------
Nach dem Login kopieren
Nach dem Login kopieren
Nach dem Login kopieren

Wenn Sie dann $request→validated()→enum(‘status‘, OrderStatus::class) aufrufen, weiß PHPStan, dass Sie ein OrderStatus-Objekt oder null erhalten!

Generische Klasse

Generische Klassen ermöglichen die Erstellung von Klassen, die mit jedem Datentyp arbeiten können und gleichzeitig die Typsicherheit gewährleisten. Sie ermöglichen die Definition einer Klasse mit einem Platzhalter für einen bestimmten Typ, der später bei der Instanziierung der Klasse ersetzt werden kann.

Ein gutes Beispiel aus dem Laravel-Quellcode wäre die IlluminateDatabaseEloquentBuilder-Klasse:

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

Ein Typparameter TModel ist definiert und an jede Unterklasse von IlluminateDatabaseEloquentModel gebunden. Derselbe Typparameter wird als Rückgabetyp der Methode make.

verwendet

Ein weiteres Beispiel wäre, wenn wir ein Auftragsmodell hätten, das einen lokalen Bereich zum Filtern von Aufträgen basierend auf ihrem Status hat. Die Scope-Methode sollte den TModel-Typ
angeben

parameters:
    ignoreErrors:
        -
            identifier: missingType.generics
Nach dem Login kopieren
Nach dem Login kopieren

ℹ️ Info: Alle Eloquent Beziehungsklassen im Namespace IlluminateDatabaseEloquentRelations wie BelongsTo und HasOne sind jetzt generisch.

Generische Schnittstelle

Generische Schnittstellen unterscheiden sich nicht so sehr. Das IlluminateContractsSupportArrayable ist ein Beispiel für eine generische Schnittstelle

/**
 * 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();
}
Nach dem Login kopieren
Nach dem Login kopieren

Die Schnittstelle definiert zwei Typparameter: TKey vom Typ Array-Key (kann int oder string sein) und TValue. Diese beiden Parameter werden verwendet, um den Rückgabetyp der toArray-Funktion zu definieren. Hier ist ein Beispiel:

<?php

namespace Illuminate\Database\Eloquent;

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

Die Benutzerklasse implementiert die Arrayable-Schnittstelle und gibt den Tkey-Typ als int und den TValue als String an.

Generisches Merkmal

Wir sind im Fehler am Anfang dieses Beitrags auf das Merkmal IlluminateDatabaseEloquentFactoriesHasFactory gestoßen. Schauen wir uns das genauer an:

/**
 * @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));
}
Nach dem Login kopieren

HasFactory definiert einen Typparameter TFactory, der an die Unterklassen von IlluminateDatabaseEloquentFactoriesFactory gebunden ist. Wie kann dieser Fehler behoben werden?

Der TFactory-Typ muss angegeben werden, wenn das Merkmal verwendet wird. Daher muss die Verwendungsanweisung des HasFactory-Merkmals mit PHPDocs @use:
annotiert werden

<?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);
    }
}
Nach dem Login kopieren

Allgemeingültigkeit bewahren

Beim Erweitern einer Klasse, Implementieren einer Schnittstelle oder Verwenden eines Merkmals ist es möglich, die Generizität in der Unterklasse beizubehalten.

Die Wahrung der Generizität wird implementiert, indem die gleichen Typparameter über der untergeordneten Klasse definiert und an @extends, @implements und @use-Tags übergeben werden.

Wir werden das generische Merkmal IlluminateDatabaseConcernsBuildsQueries als Beispiel verwenden,

es definiert einen Typparameter 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
 ------ -----------------------------------------------------------------------------------
Nach dem Login kopieren
Nach dem Login kopieren
Nach dem Login kopieren

Die IlluminateDatabaseEloquentBuilder-Klasse verwendet dieses Merkmal, behält jedoch ihre Generischkeit bei, indem der TModel-Parametertyp an sie übergeben wird. Es bleibt nun dem Client-Code überlassen, den Typ von TModel und folglich TValue im BuildsQueries-Merkmal anzugeben.

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

Letzte Gedanken

Zusammenfassend lässt sich sagen, dass PHP Generics zwar nicht nativ in der gleichen Weise wie einige andere Programmiersprachen unterstützt, die Einführung erweiterter Typhinweise und Tools wie PHPStan Entwicklern jedoch die Implementierung generics-ähnlicher Funktionen in ihren Code ermöglicht . Durch die Nutzung von PHPDocs, parametrisierten Klassen und Schnittstellen können Sie flexiblere und typsicherere Anwendungen erstellen, die die Wiederverwendbarkeit und Wartbarkeit des Codes fördern. Während sich PHP weiterentwickelt, wird der wachsende Fokus der Community auf Typsicherheit und statische Analyse wahrscheinlich zu robusteren Lösungen für die Implementierung von Generika führen. Die Übernahme dieser Praktiken verbessert nicht nur Ihre Programmierfähigkeiten, sondern trägt auch zur Entwicklung hochwertiger Software bei, die den Test der Zeit besteht.

Das obige ist der detaillierte Inhalt vonPHP-Generika in Laravel 11. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Erklärung dieser Website
Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn

Heiße KI -Werkzeuge

Undresser.AI Undress

Undresser.AI Undress

KI-gestützte App zum Erstellen realistischer Aktfotos

AI Clothes Remover

AI Clothes Remover

Online-KI-Tool zum Entfernen von Kleidung aus Fotos.

Undress AI Tool

Undress AI Tool

Ausziehbilder kostenlos

Clothoff.io

Clothoff.io

KI-Kleiderentferner

Video Face Swap

Video Face Swap

Tauschen Sie Gesichter in jedem Video mühelos mit unserem völlig kostenlosen KI-Gesichtstausch-Tool aus!

Heißer Artikel

<🎜>: Bubble Gum Simulator Infinity - So erhalten und verwenden Sie Royal Keys
4 Wochen vor By 尊渡假赌尊渡假赌尊渡假赌
Nordhold: Fusionssystem, erklärt
4 Wochen vor By 尊渡假赌尊渡假赌尊渡假赌
Mandragora: Flüstern des Hexenbaum
3 Wochen vor By 尊渡假赌尊渡假赌尊渡假赌

Heiße Werkzeuge

Notepad++7.3.1

Notepad++7.3.1

Einfach zu bedienender und kostenloser Code-Editor

SublimeText3 chinesische Version

SublimeText3 chinesische Version

Chinesische Version, sehr einfach zu bedienen

Senden Sie Studio 13.0.1

Senden Sie Studio 13.0.1

Leistungsstarke integrierte PHP-Entwicklungsumgebung

Dreamweaver CS6

Dreamweaver CS6

Visuelle Webentwicklungstools

SublimeText3 Mac-Version

SublimeText3 Mac-Version

Codebearbeitungssoftware auf Gottesniveau (SublimeText3)

Heiße Themen

Java-Tutorial
1672
14
PHP-Tutorial
1277
29
C#-Tutorial
1257
24
Erklären Sie sicheres Kennwort -Hashing in PHP (z. B. password_hash, password_verify). Warum nicht MD5 oder SHA1 verwenden? Erklären Sie sicheres Kennwort -Hashing in PHP (z. B. password_hash, password_verify). Warum nicht MD5 oder SHA1 verwenden? Apr 17, 2025 am 12:06 AM

In PHP sollten die Funktionen für Passwort_Hash und passwart_verify verwendet werden, um sicheres Passwort -Hashing zu implementieren, und MD5 oder SHA1 sollte nicht verwendet werden. 1) Passwort_hash generiert einen Hash, der Salzwerte enthält, um die Sicherheit zu verbessern. 2) Passwort_Verify prüfen Sie das Passwort und sicherstellen Sie die Sicherheit, indem Sie die Hash -Werte vergleichen. 3) MD5 und SHA1 sind anfällig und fehlen Salzwerte und sind nicht für die Sicherheit der modernen Passwort geeignet.

Wie funktioniert der Php -Typ -Hinweis, einschließlich Skalartypen, Rückgabetypen, Gewerkschaftstypen und nullbaren Typen? Wie funktioniert der Php -Typ -Hinweis, einschließlich Skalartypen, Rückgabetypen, Gewerkschaftstypen und nullbaren Typen? Apr 17, 2025 am 12:25 AM

PHP -Typ -Eingabeaufforderungen zur Verbesserung der Codequalität und der Lesbarkeit. 1) Tipps zum Skalartyp: Da Php7.0 in den Funktionsparametern wie int, float usw. angegeben werden dürfen. 3) Eingabeaufforderung für Gewerkschaftstyp: Da Php8.0 in Funktionsparametern oder Rückgabetypen angegeben werden dürfen. 4) Nullierstyp Eingabeaufforderung: Ermöglicht die Einbeziehung von Nullwerten und Handlungsfunktionen, die Nullwerte zurückgeben können.

PHP und Python: Verschiedene Paradigmen erklärt PHP und Python: Verschiedene Paradigmen erklärt Apr 18, 2025 am 12:26 AM

PHP ist hauptsächlich prozedurale Programmierung, unterstützt aber auch die objektorientierte Programmierung (OOP). Python unterstützt eine Vielzahl von Paradigmen, einschließlich OOP, funktionaler und prozeduraler Programmierung. PHP ist für die Webentwicklung geeignet, und Python eignet sich für eine Vielzahl von Anwendungen wie Datenanalyse und maschinelles Lernen.

PHP und Python: Code Beispiele und Vergleich PHP und Python: Code Beispiele und Vergleich Apr 15, 2025 am 12:07 AM

PHP und Python haben ihre eigenen Vor- und Nachteile, und die Wahl hängt von den Projektbedürfnissen und persönlichen Vorlieben ab. 1.PHP eignet sich für eine schnelle Entwicklung und Wartung großer Webanwendungen. 2. Python dominiert das Gebiet der Datenwissenschaft und des maschinellen Lernens.

Wie verhindern Sie die SQL -Injektion in PHP? (Vorbereitete Aussagen, PDO) Wie verhindern Sie die SQL -Injektion in PHP? (Vorbereitete Aussagen, PDO) Apr 15, 2025 am 12:15 AM

Die Verwendung von Vorverarbeitungsanweisungen und PDO in PHP kann SQL -Injektionsangriffe effektiv verhindern. 1) Verwenden Sie PDO, um eine Verbindung zur Datenbank herzustellen und den Fehlermodus festzulegen. 2) Erstellen Sie Vorverarbeitungsanweisungen über die Vorbereitungsmethode und übergeben Sie Daten mit Platzhaltern und führen Sie Methoden aus. 3) Abfrageergebnisse verarbeiten und die Sicherheit und Leistung des Codes sicherstellen.

PHP: Datenbanken und serverseitige Logik bearbeiten PHP: Datenbanken und serverseitige Logik bearbeiten Apr 15, 2025 am 12:15 AM

PHP verwendet MySQLI- und PDO-Erweiterungen, um in Datenbankvorgängen und serverseitiger Logikverarbeitung zu interagieren und die serverseitige Logik durch Funktionen wie Sitzungsverwaltung zu verarbeiten. 1) Verwenden Sie MySQLI oder PDO, um eine Verbindung zur Datenbank herzustellen und SQL -Abfragen auszuführen. 2) Behandeln Sie HTTP -Anforderungen und Benutzerstatus über Sitzungsverwaltung und andere Funktionen. 3) Verwenden Sie Transaktionen, um die Atomizität von Datenbankvorgängen sicherzustellen. 4) Verhindern Sie die SQL -Injektion, verwenden Sie Ausnahmebehandlung und Schließen von Verbindungen zum Debuggen. 5) Optimieren Sie die Leistung durch Indexierung und Cache, schreiben Sie hochlesbarer Code und führen Sie die Fehlerbehandlung durch.

Zweck von PHP: Erstellen dynamischer Websites Zweck von PHP: Erstellen dynamischer Websites Apr 15, 2025 am 12:18 AM

PHP wird verwendet, um dynamische Websites zu erstellen. Zu den Kernfunktionen gehören: 1. Dynamische Inhalte generieren und Webseiten in Echtzeit generieren, indem Sie eine Verbindung mit der Datenbank herstellen; 2. Verarbeiten Sie Benutzerinteraktions- und Formulareinreichungen, überprüfen Sie Eingaben und reagieren Sie auf Operationen. 3. Verwalten Sie Sitzungen und Benutzerauthentifizierung, um eine personalisierte Erfahrung zu bieten. 4. Optimieren Sie die Leistung und befolgen Sie die Best Practices, um die Effizienz und Sicherheit der Website zu verbessern.

Wählen Sie zwischen PHP und Python: Ein Leitfaden Wählen Sie zwischen PHP und Python: Ein Leitfaden Apr 18, 2025 am 12:24 AM

PHP eignet sich für Webentwicklung und schnelles Prototyping, und Python eignet sich für Datenwissenschaft und maschinelles Lernen. 1.PHP wird für die dynamische Webentwicklung verwendet, mit einfacher Syntax und für schnelle Entwicklung geeignet. 2. Python hat eine kurze Syntax, ist für mehrere Felder geeignet und ein starkes Bibliotheksökosystem.

See all articles