PHP-Generika 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 mitPHPStan 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 ------ -----------------------------------------------------------------------------------
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 { ... }
parameters: ignoreErrors: - identifier: missingType.generics
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(); }
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 vonTypparametern 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 { }
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 ------ -----------------------------------------------------------------------------------
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 { ... }
Ein Typparameter TModel ist definiert und an jede Unterklasse von IlluminateDatabaseEloquentModel gebunden. Derselbe Typparameter wird als Rückgabetyp der Methode make.
verwendetEin 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
ℹ️ 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(); }
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 { }
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)); }
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); } }
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 ------ -----------------------------------------------------------------------------------
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 { ... }
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!

Heiße KI -Werkzeuge

Undresser.AI Undress
KI-gestützte App zum Erstellen realistischer Aktfotos

AI Clothes Remover
Online-KI-Tool zum Entfernen von Kleidung aus Fotos.

Undress AI Tool
Ausziehbilder kostenlos

Clothoff.io
KI-Kleiderentferner

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

Heißer Artikel

Heiße Werkzeuge

Notepad++7.3.1
Einfach zu bedienender und kostenloser Code-Editor

SublimeText3 chinesische Version
Chinesische Version, sehr einfach zu bedienen

Senden Sie Studio 13.0.1
Leistungsstarke integrierte PHP-Entwicklungsumgebung

Dreamweaver CS6
Visuelle Webentwicklungstools

SublimeText3 Mac-Version
Codebearbeitungssoftware auf Gottesniveau (SublimeText3)

Heiße Themen

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.

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.

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.

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.

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.

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.

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.

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.
