Beitrag zur Open Source: Gatekeeper Fallstudie

tragen zum Open -Source -Projekt bei: ein praktischer Fall

Dieser Artikel erläutert ausführlich, wie Code für Open -Source -Projekte durch einen praktischen Fall beiträgt. Wir werden die Gatekeeper -Bibliothek als Beispiel nutzen, um eine Zählfunktion hinzuzufügen und den gesamten Prozess schrittweise zu demonstrieren, einschließlich der Kommunikation mit dem Projektbesitzer, der Code -Implementierung, dem Testen und der Übermittlung von Pull -Anfragen.

Einführung in die Gatekeeper -Bibliothek

Gatekeeper ist eine PHP -Bibliothek für Benutzerregistrierung, Authentifizierung und Autorisierung. Dies macht es vollständig von der Hauptanwendung entkoppelt und erleichtert es einfach zu skalieren und zu ändern.

Zählfunktion add

Um die Gesamtzahl der Benutzer in der Datenbank zu erhalten, muss Gatekeeper zuerst alle Benutzerdatensätze erhalten, dann SQL -Abfragen zählen oder manuell schreiben. Um dies zu verbessern, werden wir der Adapterschnittstelle eine Zählfunktion hinzufügen, um sie nativ zu machen und sich auf das Hinzufügen anderer Datenbankmotoren in der Zukunft vorzubereiten.

Schritt 1: Kommunizieren Sie mit dem Projektbesitzer

Kommunizieren Sie vor dem Beitrag zuerst mit dem Projektbesitzer, um zu bestätigen, ob die Funktion geplant ist und ob sie benötigt wird. Normalerweise ist es nur möglich, es in der Frage des Projekts vorzuschlagen.

Schritt 2: Gabel, Klon und Test

Fork -Projekt zu Ihrem eigenen Github -Repository. Dann geht Clone lokal, installieren Sie die Abhängigkeiten und führen Sie den Test aus:

git clone <你的fork地址>
cd gatekeeper
composer install
vendor/bin/phpunit

Alle Tests sollten bestanden werden. Erstellen Sie danach einen neuen Zweig, um sich zu entwickeln:

git checkout -b "feature-count"

Schritt 3: Aktionsplan

Gatekeeper unterstützt derzeit nur MySQL -Datenbanken. Wir müssen den folgenden Abschnitt ändern:

• Gatekeeper/DataSource: abstrakte DataSource -Klasse
• DataSource/MySQL: MySQL -Datenquelle mit tatsächlichen Methoden
• DataSource/Stub: Aktualisieren

Ein neuer Count -Prozessor wird ebenfalls benötigt, da Gatekeeper magische statische Anrufe verwendet, um Entitäten zu erstellen, zu finden, zu aktualisieren und zu löschen.

Schritt 4: Code -Implementierung

1. statischen Aufruf delegieren: einen Block in Gatekeeper::__callStatic den statischen Aufruf zum neuen Count -Prozessor hinzufügen. Aktualisieren Sie gleichzeitig die statischen Eigenschaften elseif. $actions

2. create count Processor: Datei erstellen, schreiben Sie die Logik des Count -Prozessors, der dem Prozessor erstellen, jedoch eine Zähloperation durchführt. Psecio/Gatekeeper/Handler/Count.php

3. DataSource und Stub ändern:

   add Methodensignatur in und abstrakten Klassen. Psecio/Gatekeeper/DataSource/Stub.php count

4. Implementieren Sie die Zählmethode der MySQL -Datenquelle:

   Implementieren Sie die -Methode in , mit der die DataSource/MySQL.php -Funktion von MySQL zum Zählen verwendet wird. count

Schritt 5: Test

Erstellen Sie ein neues Projekt, installieren Sie die modifizierte Gatekeeper -Bibliothek mit Composer und führen Sie Tests durch. Der Test sollte verschiedene Szenarien abdecken, z. B. das Zählen aller Benutzer, das Zählen von Benutzern anhand von Bedingungen usw.

Schritt 6: Pull -Anfrage sendet

Senden Sie den Code in Ihr eigenes Gabel -Repository und erstellen Sie eine Pull -Anfrage, um Code -Überprüfungen an den Projektbesitzer zu senden.

Zusammenfassung

Dieser Artikel führt ausführlich den Prozess des Beitrags von Code für Open -Source -Projekte in einem bestimmten Fall ein. Obwohl dieser Fall relativ einfach ist, deckt er die meisten Schritte ab, die zu Open -Source -Projekten beitragen, und bietet eine gute Referenz für Entwickler, die an Open -Source -Projekten teilnehmen möchten. Denken Sie daran, dass Tests und klare Kommunikation der Schlüssel zu erfolgreichen Beiträgen sind.

Das obige ist der detaillierte Inhalt vonBeitrag zur Open Source: Gatekeeper Fallstudie. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!