Beitragsanleitung
Beitragsrichtlinien
- Bug-Feedback
- Kernentwicklungsdiskussion
- Zweigauswahl
- Assets zusammenstellen
- Sicherheitslücke
- Codierungsstil
Fehler-Feedback
Um eine aktive Zusammenarbeit zu fördern, Laravel Es wird dringend empfohlen, Pull Requests zu verwenden, um Änderungen und nicht nur Fehler anzuzeigen. „Fehler-Feedback“ kann PR auch nutzen, um fehlgeschlagene Tests einzureichen.
Wenn Sie Feedback zu Fehlern einreichen, sollte Ihr Problem einen Titel und eine klare Beschreibung des Problems enthalten und möglichst viele relevante Informationen und Codebeispiele enthalten, die das Problem veranschaulichen. Der Zweck des Fehler-Feedbacks besteht darin, es Ihnen und anderen zu erleichtern, den Fehler zu reproduzieren und zu beheben.
Bitte denken Sie daran, dass der ursprüngliche Zweck des Fehlerfeedbacks darin besteht, anderen Personen mit demselben Problem die Zusammenarbeit mit Ihnen bei der Lösung des Problems zu ermöglichen. Erwarten Sie nicht, dass jemand einen Fehler schnell behebt, nachdem Sie ihn gemeldet haben. Das Erstellen von Fehlerfeedback ist eine Möglichkeit, Ihnen und anderen dabei zu helfen, mit der Behebung des Problems zu beginnen.
Der Laravel-Quellcode wird auf GitHub gehostet und jedes Laravel-Projekt verfügt über ein eigenes Code-Repository:
Kernentwicklungsdiskussion
Sie können im Laravel Ideas Issue Board neue Funktionen oder Verbesserungen des bestehenden Verhaltens von Laravel vorschlagen. Wenn Sie eine neue Funktion vorschlagen, möchten wir Sie bitten, zumindest einen Teil des für diese Funktion erforderlichen Codes auszufüllen.
Informelle Diskussionen über Fehler, neue Funktionen und die Implementierung neuer Funktionen finden im Laravel Discord #internals-Kanal statt. Taylor Otwell, der Betreuer von Laravel, ist normalerweise wochentags von 8 bis 17 Uhr (UTC-06:00 UTC-06:00 oder America/Chicago) auf dem Kanal und gelegentlich auch zu anderen Zeiten.
Zweigauswahl
Alle Fehlerbehebungen sollten an den neuesten stabilen Zweig oder den aktuellen LTS-Zweig gesendet werden. Fehlerbehebungen Niemals sollten an den Zweig master gesendet werden, es sei denn, der Fix betrifft eine Funktion, die erst in einer kommenden Version veröffentlicht wird.
Kleinere neue Funktionen, die vollständig abwärtskompatibel sind, werden an den neuesten stabilen Zweig gesendet.
Wichtige neue Funktionen sollten an den master-Zweig gesendet werden, der kommende Laravel-Releases enthält.
Wenn Sie nicht sicher sind, ob Ihr Beitrag als primär oder sekundär gilt, fragen Sie Taylor Otwell im #internals-Kanal auf dem Laravel Discord.
Kompilierte Assets
Wenn Sie Änderungen festschreiben, die kompilierte Dateien betreffen, z. B. die im laravel/laravel Repository resources/sass oder den meisten Dateien in resources/js bitte keine kompilierten Dateien einreichen. Aufgrund ihrer Größe konnten die Gutachter sie nicht physisch begutachten. Dies kann ausgenutzt werden, um Schadcode in Laravel einzuschleusen. Um dies zu verhindern, werden alle statischen Assets vom Laravel-Betreuer generiert und übermittelt.
Sicherheitslücke
Wenn Sie eine Sicherheitslücke in Laravel entdecken, senden Sie bitte eine E-Mail an Taylor Otwell: taylor@laravel.com. Er kümmert sich umgehend um alle Sicherheitsverstöße.
Codierungsstil
Laravel folgt der PSR-2-Codierungskonvention und PSR-4 Spezifikationen automatisch laden.
PHPDoc
Das Folgende ist der korrekt geschriebene Laravel-Dokumentationskommentar. Beachten Sie, dass auf das @param-Attribut zwei Leerzeichen, der Parametertyp, zwei Leerzeichen und schließlich der Variablenname folgen:
/**
* 在容器中注册绑定。
*
* @param string|array $abstract
* @param \Closure|string|null $concrete
* @param bool $shared
* @return void
* @throws \Exception
*/public function bind($abstract, $concrete = null, $shared = false){ //}StyleCI
Machen Sie sich keine Sorgen, wenn Ihr Codierungsstil nicht hübsch genug ist! Nach dem Zusammenführen der Pull-Anfrage korrigiert StyleCI automatisch alle Stile und führt sie in das Laravel-Repository ein. Dadurch können wir uns mehr auf den Inhalt des Beitrags konzentrieren als auf den Codierungsstil.
