suchen
HeimBackend-EntwicklungPHP-TutorialBeitrag zu PHP: So tragen Sie zum Handbuch von PHP bei

Diese zweiteilige Serie untersucht, wie man zum PHP-Projekt beiträgt und sich auf Dokumentation in Teil 1 konzentriert. Wir decken Kontoanfragen und Nachabrechnungsschritte ab.

Contributing to PHP: How to Contribute to PHP's Manual

Schlüsselpunkte:

  • Beitrag zur Dokumentation von PHP verbessert die Sprache und erhöht Ihr PHP -Fachwissen. Es kann auch zu einem Php.NET -Konto führen, der die Richtung der Sprache beeinflusst.
  • Die Dokumentation verwendet Docbook XML; Vertrautheit ist hilfreich, aber nicht obligatorisch.
  • Anfänger können den Online -Editor für einfache Patches verwenden. Überprüfung der Richtlinien im Voraus sind ratsam.
  • Häufige Mitwirkende oder diejenigen, die umfangreiche Änderungen benötigen, sollten die DOCs lokal einrichten und ein Php.net -Konto anfordern. Dies beinhaltet das Erstellen eines Verzeichnisses, das Klonen der Dokumente und das Konfigurieren von SVN -Schlüsselwörtern.
  • Beiträge umfassen Fehlerbehebungen, Übersetzungen, Erweiterung vorhandener Inhalte, Dokumentation von undokumentierten Funktionen und allgemeine Verbesserungen.

Warum beitragen?

PHP, der Open-Source ist, lebt vom Engagement der Gemeinschaft. Die verstärkte Teilnahme kommt allen zugute. Unabhängig davon, ob es sich um die Verbesserung der Dokumentation, das Beheben von Fehler oder das Hinzufügen von Funktionen, zählt jeder Beitrag. Aktive Teilnahme vertieft Ihr PHP -Wissen und ermöglicht es Ihnen, ein Php.net -Konto anzufordern, wobei die Zukunft der Sprache gestaltet wird.

PHP -Dokumentation

verstehen

Die Dokumentation befindet sich in Docbook XML. Vorwissen ist nicht ausschließlich notwendig; Die XML -Syntax ist leicht zu lernen.

Die Verzeichnisstruktur lautet:

Contributing to PHP: How to Contribute to PHP's Manual

doc-base enthält Tools zum Konvertieren der XML -Dokumentation. en hält die englische Dokumentation (andere Sprachen verwenden ihre Zwei-Buchstaben-Codes). reference enthält erweiterungsspezifische Verzeichnisse (Funktionen für prozedurale Erweiterungen, klassenbezeichnete Ordner für objektorientierte). Jeder Erweiterungsordner enthält book.xml (Zielseite) und versions.xml (Versioning -Info).

Die Dokumentation ist derzeit SVN-basiert (obwohl er zu Git migriert). Lokales Setup erfordert eine SVN -Vertrautheit.

Erstmalige Mitwirkende

Beginnen Sie mit dem Online -Dokumentationseditor. Dies ermöglicht die Anmeldung von OAuth und die Einreichung einfacher Patches. Konsistente Konto Verwendung vereinfacht die Verfolgung von Beiträgen für zukünftige Php.net -Kontoanwendungen.

Machen Sie sich mit Style -Richtlinien vor, bevor Sie Patches einreichen.

Beispiel: Auflösen von Fehler #71716

Dieser Fehler meldet eine fehlerhafte MongoDB -Client -Klasse in einem Beispiel. Verwenden Sie nach der Überprüfung den Online -Editor, um den Namespace zu korrigieren.

Video -Einbetten: https://www.php.cn/link/14aa36297925d3c82891d74fa28d7df1 (ersetzen Sie es bei Bedarf durch den tatsächlichen Einbett -Code)

Lokales Setup

Der Online -Editor ist begrenzt; Richten Sie die DOCs lokal ein und fordern Sie ein php.net -Konto an.
    .
  1. phpdocs ein
  2. Verzeichnis erstellen.
  3. svn checkout https://svn.php.net/repository/phpdoc/modules/doc-en klonen Sie die Dokumente mit SVN:
  4. git clone http://git.php.net/repository/phd.git Klon -PhD (Rendering -Tool):
  5. git clone http://git.php.net/repository/web/php.git web-php klonen Sie die PHP.NET -Website: web-php/manual/en; Entfernen Sie
  6. und erstellen Sie eine symbolische Verbindung zu den gerenderten Dokumenten.
  7. ~/.subversion/config SVN -Schlüsselwörter in *.xml = svn:eol-style=native;svn:keywords=Id Rev Revision Date LastChangedDate LastChangedRevision Author LastChangedBy HeadURL URL:
  8. konfigurieren ref (optional) Erstellen Sie eine
  9. Datei mit Befehlen zur Validierung, Erstellung und Anzeige von Dokumenten lokal.

docs Workflow (lokal)

svn up Nach dem Einrichten aktualisieren Sie Repositories (git pull und php ~/phpdocs/doc-en/doc-base/configure.php). Bearbeiten Sie die entsprechende XML -Datei, validieren Sie mit svn ci -m "Resolve doc bug #..."), erstellen Sie mit PhD und starten Sie den lokalen Server. Bestimmungsänderungen mithilfe von SVN (

, verweisen Sie auf die Fehlernummer. Schließen Sie den Fehlerbericht auf der Registerkarte "Entwickler" nach der Verbreitung von Änderungen.

Anfordern eines php.net -Kontos

Fordern Sie nach lokalem Setup ein Php.NET -Konto bei DOCS Karma an. Während keine strengen Voraussetzungen vorhanden sind, ist es wichtig, einen aktiven Beitrag zu demonstrieren. Senden Sie das Kontokontoanforderungsformular und senden Sie eine E -Mail an phpdoc@lists.php.net, um Ihre Absichten, Wiki -Benutzernamen und frühere Beiträge zu erläutern.

Dokumentationsaufgaben

Beyond Fehlerbehebungen:
  • Übersetzungen
  • teilweise dokumentiertes Material
  • erweitern
  • Dokumentieren von undokumentierten Funktionen
Allgemeine Verbesserungen

Allgemeine Tipps
  • befolgen Sie die Stilrichtlinien.
  • Überprüfen Sie verwandte Aspekte bei der Behebung von Fehler.
  • präzise schreiben.
  • separates Beispielcode von Ausgabe.
  • korrekte Seitenreihenfolge sicherstellen.
  • PHP 4 Referenzen entfernen.
  • ordnungsgemäße Version neue Dateien.
wenden Sie sich an die FAQ- oder PHP-Docs-Mailingliste der DOCs.

Schlussfolgerung

Dieser Teil umfasste zwei Workflows: Online -Editor und lokales Setup. Teil zwei wird abdecken, der zum Kern von PHP beiträgt.

faqs (bewegt zum besseren Fluss)
  • beitragen Prozess: Erstellen Sie ein Konto, bearbeiten/erstellen Inhalte, übersetzen Sie Richtlinien.
  • Bedeutung des Beitrags: verbessert die Dokumentationsqualität, hält sie auf dem neuesten Stand, fördert die Community.
  • Stellen Sie sicher
  • Nicht-Muttersprachler:
  • Beiträge sind willkommen; Übersetzung ist ein wertvoller Beitrag.
  • Häufige Fehler:
  • Nicht -Richtlinien, ungenaue/unklare Informationen, Mangel an Korrekturlesen, unnötige Änderungen.
  • Hilfe erhalten:
  • Verwenden Sie Online -Foren, Diskussionsgruppen, Dokumentationsrichtlinien.
  • Anonymer Beitrag:
  • möglich, aber ein Konto wird gefördert.
  • Beitragshäufigkeit:
  • variiert je nach Verfügbarkeit und Interesse.
  • Entschädigung:
  • Im Allgemeinen Freiwilligenarbeit.
  • Meldungsfehler:
  • Korrigieren Sie sie, wenn ein Mitwirkender, ansonsten der Community Bericht erstattet.
  • Denken Sie daran, die Platzhalter -Bild -URLs durch die tatsächlichen Bild -URLs zu ersetzen. Ich habe die Bildformatierung bewahrt und die Bilder wie angefordert in ihren ursprünglichen Positionen aufbewahrt.

Das obige ist der detaillierte Inhalt vonBeitrag zu PHP: So tragen Sie zum Handbuch von PHP bei. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Stellungnahme
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
Was sind die Vorteile der Verwendung einer Datenbank zum Speichern von Sitzungen?Was sind die Vorteile der Verwendung einer Datenbank zum Speichern von Sitzungen?Apr 24, 2025 am 12:16 AM

Die Hauptvorteile der Verwendung von Datenbankspeichersitzungen sind Persistenz, Skalierbarkeit und Sicherheit. 1. Persistenz: Auch wenn der Server neu gestartet wird, können die Sitzungsdaten unverändert bleiben. 2. Skalierbarkeit: Anwendbar für verteilte Systeme, um sicherzustellen, dass Sitzungsdaten zwischen mehreren Servern synchronisiert werden. 3. Sicherheit: Die Datenbank bietet verschlüsselten Speicher zum Schutz vertraulicher Informationen.

Wie implementieren Sie eine benutzerdefinierte Sitzung in PHP?Wie implementieren Sie eine benutzerdefinierte Sitzung in PHP?Apr 24, 2025 am 12:16 AM

Das Implementieren der benutzerdefinierten Sitzung in PHP kann durch die Implementierung der SessionHandlerInterface -Schnittstelle durchgeführt werden. Die spezifischen Schritte umfassen: 1) Erstellen einer Klasse, die SessionHandlerInterface wie CustomSessionHandler implementiert; 2) Umschreiben von Methoden in der Schnittstelle (z. B. offen, schließen, lesen, schreiben, zerstören, GC), um die Lebenszyklus- und Speichermethode von Sitzungsdaten zu definieren; 3) Registrieren Sie einen benutzerdefinierten Sitzungsprozessor in einem PHP -Skript und starten Sie die Sitzung. Auf diese Weise können Daten in Medien wie MySQL und Redis gespeichert werden, um Leistung, Sicherheit und Skalierbarkeit zu verbessern.

Was ist eine Sitzungs -ID?Was ist eine Sitzungs -ID?Apr 24, 2025 am 12:13 AM

SessionID ist ein Mechanismus, der in Webanwendungen verwendet wird, um den Benutzersitzstatus zu verfolgen. 1. Es handelt sich um eine zufällig generierte Zeichenfolge, mit der die Identitätsinformationen des Benutzers während mehrerer Interaktionen zwischen dem Benutzer und dem Server aufrechterhalten werden. 2. Der Server generiert und sendet ihn über Cookies- oder URL -Parameter an den Client, um diese Anforderungen in mehreren Anforderungen des Benutzers zu identifizieren und zu verknüpfen. 3. Die Erzeugung verwendet normalerweise zufällige Algorithmen, um Einzigartigkeit und Unvorhersehbarkeit zu gewährleisten. 4. In der tatsächlichen Entwicklung können In-Memory-Datenbanken wie Redis verwendet werden, um Sitzungsdaten zu speichern, um die Leistung und Sicherheit zu verbessern.

Wie gehen Sie mit Sitzungen in einer staatenlosen Umgebung (z. B. API) um?Wie gehen Sie mit Sitzungen in einer staatenlosen Umgebung (z. B. API) um?Apr 24, 2025 am 12:12 AM

Das Verwalten von Sitzungen in staatenlosen Umgebungen wie APIs kann durch Verwendung von JWT oder Cookies erreicht werden. 1. JWT ist für Staatenlosigkeit und Skalierbarkeit geeignet, aber es ist groß, wenn es um Big Data geht. 2. Kookies sind traditioneller und einfacher zu implementieren, müssen jedoch mit Vorsicht konfiguriert werden, um die Sicherheit zu gewährleisten.

Wie können Sie vor SPRECTS-Angriffen (XSS) schützen?Wie können Sie vor SPRECTS-Angriffen (XSS) schützen?Apr 23, 2025 am 12:16 AM

Um die Anwendung vor Sitzungsangriffen im Zusammenhang mit den Sitzungen zu schützen, sind folgende Maßnahmen erforderlich: 1. Stellen Sie die HTTPonly- und sicheren Flags ein, um die Sitzungs Cookies zu schützen. 2. Exportcodes für alle Benutzereingaben. 3. Implementieren Sie die Inhaltssicherheitsrichtlinie (CSP), um die Skriptquellen einzuschränken. Durch diese Richtlinien können Sitzungsangriffe im Zusammenhang mit Sitzungen effektiv geschützt und Benutzerdaten sichergestellt werden.

Wie können Sie die PHP -Sitzungsleistung optimieren?Wie können Sie die PHP -Sitzungsleistung optimieren?Apr 23, 2025 am 12:13 AM

Methoden zur Optimierung der PHP -Sitzungsleistung gehören: 1. Start der Verzögerung der Sitzung, 2. Verwenden Sie Datenbank zum Speichern von Sitzungen, 3. Kompress -Sitzungsdaten, 14. Sitzungslebenszyklus verwalten und 5. Sitzungsfreigabe implementieren. Diese Strategien können die Effizienz von Anwendungen in hohen Parallelitätsumgebungen erheblich verbessern.

Wie lautet die Konfigurationseinstellung von Session.gc_maxlifetime?Wie lautet die Konfigurationseinstellung von Session.gc_maxlifetime?Apr 23, 2025 am 12:10 AM

Thesession.gc_maxlifetimesettingInphpdeterminesthelifspanofSessionData, setInseconds.1) ItsconfiguredInphp.iniorviaini_Set (). 2) AbalanceIsneedToAvoidPerformanceSandunexexwortedyg -Probablogouts

Wie konfigurieren Sie den Sitzungsnamen in PHP?Wie konfigurieren Sie den Sitzungsnamen in PHP?Apr 23, 2025 am 12:08 AM

In PHP können Sie die Funktion Session_name () verwenden, um den Sitzungsnamen zu konfigurieren. Die spezifischen Schritte sind wie folgt: 1. Verwenden Sie die Funktion Session_name (), um den Sitzungsnamen wie Session_name ("my_Session") festzulegen. 2. Nachdem Sie den Sitzungsnamen festgelegt haben, call Session_start (), um die Sitzung zu starten. Das Konfigurieren von Sitzungsnamen kann Sitzungsdatenkonflikte zwischen mehreren Anwendungen vermeiden und die Sicherheit verbessern, aber auf die Einzigartigkeit, Sicherheit, Länge und Festlegen des Zeitpunkts der Sitzungsnamen achten.

See all articles

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

MinGW – Minimalistisches GNU für Windows

MinGW – Minimalistisches GNU für Windows

Dieses Projekt wird derzeit auf osdn.net/projects/mingw migriert. Sie können uns dort weiterhin folgen. MinGW: Eine native Windows-Portierung der GNU Compiler Collection (GCC), frei verteilbare Importbibliotheken und Header-Dateien zum Erstellen nativer Windows-Anwendungen, einschließlich Erweiterungen der MSVC-Laufzeit zur Unterstützung der C99-Funktionalität. Die gesamte MinGW-Software kann auf 64-Bit-Windows-Plattformen ausgeführt werden.

mPDF

mPDF

mPDF ist eine PHP-Bibliothek, die PDF-Dateien aus UTF-8-codiertem HTML generieren kann. Der ursprüngliche Autor, Ian Back, hat mPDF geschrieben, um PDF-Dateien „on the fly“ von seiner Website auszugeben und verschiedene Sprachen zu verarbeiten. Es ist langsamer und erzeugt bei der Verwendung von Unicode-Schriftarten größere Dateien als Originalskripte wie HTML2FPDF, unterstützt aber CSS-Stile usw. und verfügt über viele Verbesserungen. Unterstützt fast alle Sprachen, einschließlich RTL (Arabisch und Hebräisch) und CJK (Chinesisch, Japanisch und Koreanisch). Unterstützt verschachtelte Elemente auf Blockebene (wie P, DIV),

Dreamweaver Mac

Dreamweaver Mac

Visuelle Webentwicklungstools

PHPStorm Mac-Version

PHPStorm Mac-Version

Das neueste (2018.2.1) professionelle, integrierte PHP-Entwicklungstool

MantisBT

MantisBT

Mantis ist ein einfach zu implementierendes webbasiertes Tool zur Fehlerverfolgung, das die Fehlerverfolgung von Produkten unterstützen soll. Es erfordert PHP, MySQL und einen Webserver. Schauen Sie sich unsere Demo- und Hosting-Services an.