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ß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)

Erklären Sie JSON Web Tokens (JWT) und ihren Anwendungsfall in PHP -APIs. Erklären Sie JSON Web Tokens (JWT) und ihren Anwendungsfall in PHP -APIs. Apr 05, 2025 am 12:04 AM

JWT ist ein offener Standard, der auf JSON basiert und zur sicheren Übertragung von Informationen zwischen Parteien verwendet wird, hauptsächlich für die Identitätsauthentifizierung und den Informationsaustausch. 1. JWT besteht aus drei Teilen: Header, Nutzlast und Signatur. 2. Das Arbeitsprinzip von JWT enthält drei Schritte: Generierung von JWT, Überprüfung von JWT und Parsingnayload. 3. Bei Verwendung von JWT zur Authentifizierung in PHP kann JWT generiert und überprüft werden, und die Funktionen und Berechtigungsinformationen der Benutzer können in die erweiterte Verwendung aufgenommen werden. 4. Häufige Fehler sind Signaturüberprüfungsfehler, Token -Ablauf und übergroße Nutzlast. Zu Debugging -Fähigkeiten gehört die Verwendung von Debugging -Tools und Protokollierung. 5. Leistungsoptimierung und Best Practices umfassen die Verwendung geeigneter Signaturalgorithmen, das Einstellen von Gültigkeitsperioden angemessen.

Wie funktioniert die Session -Entführung und wie können Sie es in PHP mildern? Wie funktioniert die Session -Entführung und wie können Sie es in PHP mildern? Apr 06, 2025 am 12:02 AM

Die Hijacking der Sitzung kann in den folgenden Schritten erreicht werden: 1. Erhalten Sie die Sitzungs -ID, 2. Verwenden Sie die Sitzungs -ID, 3. Halten Sie die Sitzung aktiv. Zu den Methoden zur Verhinderung der Sitzung der Sitzung in PHP gehören: 1. Verwenden Sie die Funktion Session_regenerate_id (), um die Sitzungs -ID zu regenerieren. 2. Store -Sitzungsdaten über die Datenbank, 3. Stellen Sie sicher, dass alle Sitzungsdaten über HTTPS übertragen werden.

Was sind Aufzählungen (Enums) in PHP 8.1? Was sind Aufzählungen (Enums) in PHP 8.1? Apr 03, 2025 am 12:05 AM

Die Aufzählungsfunktion in Php8.1 verbessert die Klarheit und Type des Codes, indem benannte Konstanten definiert werden. 1) Aufzählungen können Ganzzahlen, Zeichenfolgen oder Objekte sein, die die Lesbarkeit der Code und die Type der Type verbessern. 2) Die Aufzählung basiert auf der Klasse und unterstützt objektorientierte Merkmale wie Traversal und Reflexion. 3) Die Aufzählung kann zum Vergleich und zur Zuordnung verwendet werden, um die Sicherheit der Typ zu gewährleisten. 4) Aufzählung unterstützt das Hinzufügen von Methoden zur Implementierung einer komplexen Logik. 5) Strenge Typ Überprüfung und Fehlerbehandlung können häufig auftretende Fehler vermeiden. 6) Die Aufzählung verringert den magischen Wert und verbessert die Wartbarkeit, achten Sie jedoch auf die Leistungsoptimierung.

Beschreiben Sie die soliden Prinzipien und wie sie sich für die PHP -Entwicklung anwenden. Beschreiben Sie die soliden Prinzipien und wie sie sich für die PHP -Entwicklung anwenden. Apr 03, 2025 am 12:04 AM

Die Anwendung des soliden Prinzips in der PHP -Entwicklung umfasst: 1. Prinzip der Einzelverantwortung (SRP): Jede Klasse ist nur für eine Funktion verantwortlich. 2. Open and Close Principle (OCP): Änderungen werden eher durch Erweiterung als durch Modifikation erreicht. 3.. Lischs Substitutionsprinzip (LSP): Unterklassen können Basisklassen ersetzen, ohne die Programmgenauigkeit zu beeinträchtigen. 4. Schnittstellen-Isolationsprinzip (ISP): Verwenden Sie feinkörnige Schnittstellen, um Abhängigkeiten und nicht verwendete Methoden zu vermeiden. 5. Abhängigkeitsinversionsprinzip (DIP): Hoch- und niedrige Module beruhen auf der Abstraktion und werden durch Abhängigkeitsinjektion implementiert.

Erklären Sie die späte statische Bindung in PHP (statisch: :). Erklären Sie die späte statische Bindung in PHP (statisch: :). Apr 03, 2025 am 12:04 AM

Statische Bindung (statisch: :) implementiert die späte statische Bindung (LSB) in PHP, sodass das Aufrufen von Klassen in statischen Kontexten anstatt Klassen zu definieren. 1) Der Analyseprozess wird zur Laufzeit durchgeführt.

Was sind REST -API -Designprinzipien? Was sind REST -API -Designprinzipien? Apr 04, 2025 am 12:01 AM

Die RESTAPI -Designprinzipien umfassen Ressourcendefinition, URI -Design, HTTP -Methodenverbrauch, Statuscode -Nutzung, Versionskontrolle und Hassoas. 1. Ressourcen sollten durch Substantive dargestellt und in einer Hierarchie aufrechterhalten werden. 2. HTTP -Methoden sollten ihrer Semantik entsprechen, z. B. Get wird verwendet, um Ressourcen zu erhalten. 3. Der Statuscode sollte korrekt verwendet werden, z. B. 404 bedeutet, dass die Ressource nicht vorhanden ist. 4. Die Versionskontrolle kann über URI oder Header implementiert werden. 5. Hateoas startet Client -Operationen durch Links als Antwort.

Wie können Sie mit Ausnahmen in PHP effektiv umgehen (versuchen Sie, schließlich zu werfen)? Wie können Sie mit Ausnahmen in PHP effektiv umgehen (versuchen Sie, schließlich zu werfen)? Apr 05, 2025 am 12:03 AM

In PHP wird das Ausnahmebehandlung durch den Versuch, Fang, schließlich und werfen Keywords erreicht. 1) Der Try -Block umgibt den Code, der Ausnahmen auslösen kann. 2) Der Catch -Block behandelt Ausnahmen; 3) Block stellt schließlich sicher, dass der Code immer ausgeführt wird. 4) Wurf wird verwendet, um Ausnahmen manuell zu werfen. Diese Mechanismen verbessern die Robustheit und Wartbarkeit Ihres Codes.

Was sind anonyme Klassen in PHP und wann könnten Sie sie verwenden? Was sind anonyme Klassen in PHP und wann könnten Sie sie verwenden? Apr 04, 2025 am 12:02 AM

Die Hauptfunktion anonymer Klassen in PHP besteht darin, einmalige Objekte zu erstellen. 1. Anonyme Klassen ermöglichen es, Klassen ohne Namen direkt im Code zu definieren, was für vorübergehende Anforderungen geeignet ist. 2. Sie können Klassen erben oder Schnittstellen implementieren, um die Flexibilität zu erhöhen. 3. Achten Sie bei der Verwendung auf Leistung und Code -Lesbarkeit und vermeiden Sie es, dieselben anonymen Klassen wiederholt zu definieren.

See all articles