Entwickler Dokumentation und Hilfreiche Tools für Entwickler

In diesem Forum gibt es Starthilfe zum neuen Extension-System von phpBB 3.1/3.2. Fragen zur Entwicklung von Extensions und zur Konvertierung von phpBB 3.0.x MODs sind ebenfalls willkommen.
Benutzeravatar
gn#36
Administrator
Administrator
Beiträge: 9156
Registriert: 01.10.2006 16:20
Wohnort: Ganz in der Nähe...
Kontaktdaten:

Entwickler Dokumentation und Hilfreiche Tools für Entwickler

Beitragvon gn#36 » 12.08.2015 00:24

Die Einstiegshürde für die Entwicklung phpBB Erweiterungen ist hoch, da es sich nicht mehr um (beliebige) Änderungen am Quellcode handelt sondern die Erweiterungen einer vordefinierten Struktur folgen müssen, damit sie funktionieren.

Ein erster Einstieg in die Entwicklung findest du in unserer Knowledgebase: Eigene phpBB Erweiterungen erstellen

Inzwischen gibt es daneben sowohl für den Einstieg als auch als Referenz während der Entwicklung einige nützliche Tools, welche wir in diesem Thema sammeln möchten. Die Tools werden hierbei in Kategorien eingeteilt und mit einer kurzen Beschreibung versehen, so dass hoffentlich alle Entwickler die jeweils für sie besten Tools schnell finden und einsetzen können. Falls euch noch mehr phpBB spezifische oder sonstige sehr wichtige Tools einfallen freuen wir uns über einen Hinweis.

phpBB.com Entwickler Dokumentation
Das allgemein wohl nützlichste Tool ist die phpBB Development Documentation (englisch), wo die Entwickler auf phpBB.com einen großen Teil der Dokumentation zusammengetragen haben und das auch weiter tun wollen. Hier findet sich beispielsweise ein größerer Abschnitt über die Entwicklung von Erweiterungen (englisch), in dem sich auch diverse ausführliche Tutorials zu einzelnen Aspekten von Extensions finden. Für alte Hasen, die sich mit phpBB 3.0.x auskennen dürfte insbesondere der Abschnitt Converting a phpBB 3.0 Mod to a phpBB 3.1 Extension interessant sein.

Nützliche Extensions
Es gibt eine Reihe von phpBB Erweiterungen, die euch bei der Entwicklung helfen können:
  • Debug Tools
    Fügt ein paar nützliche Konsolebefehle hinzu, beispielsweise um Teile des Caches auszulesen oder das Routing zu debuggen.
  • Web Profiler Extension
    Profiling und Debugging mit Hilfe des Symfony profilers.
  • Quickly reenable extensions
    Erlaubt das schnelle Deaktivieren und direkt anschließende Aktivieren von Erweiterungen ohne nervige Zwischenklicks.
  • Template Events
    Zeigt einen kurzen Text in allen Template events an, der den Namen des Events enthält. So kann man sehr schnell das gewünschte Template Event finden.
  • Cron Status
    Zeigt den Zustand diverser Cronjobs an, sofern diese bestimmten Mustern folgen. Fehler in Cronjobs lassen sich so leichter finden.
  • phpBB Ext Skeleton
    Erstellt schnell und Einfach ein Grundgerüst für phpBB Erweiterungen, das als Basis für neue Erweiterungen dienen kann. Siehe auch den Blogeintrag zur Erweiterung auf phpBB.com.

Sonstige phpBB spezifische Tools und Hilfen
  • Quickinstall
    Schnell eine komplett neue Kopie von phpBB installieren um hierin sauber testen zu können. Falls man mal das Entwicklungsboard zerstört kann man hiermit schnell ein neues installieren.
  • Extension Prevalidator (EPV)
    Nützlich zum finden einfacher Fehler in der Extension. Wenn ein Github Repository existiert kann man den EPV direkt von der verlinkten Webseite aus ausführen. Ansonsten ist auch ein Download möglich.
  • phpBB Cross Referenz
    Neben den Dateien auf der eigenen Festplatte kann es hilfreich sein eine Code Doku mit zur Definition verlinkten Funktionsbezeichnungen zu verwenden. Diese wird hier von uns auf phpBB.de bereitgestellt
  • Liste aller phpBB DB-Tabellen inklusive Kurzbeschreibung
  • Liste von phpBB 3.1.x Events
    Umfangreiche Auflistung von phpBB Events inklusive übergebener Parameter.
  • Hallo Welt Extension
    Nickvergessen hat eine Hallo Welt Extension erstellt, die die grundlegenden Konzepte von Extensions erklärt.
  • Deutschsprachiges Tutorial zur Extension Entwicklung
    Dave hat eine eingängige und einfache Anleitung zum Erstellen von Extensions auf Deutsch geschrieben.

Allgemeine Entwickler Tools
  • Entwicklungsumgebungen / IDE für PHP
    • Eclipse: PHP Development Tools (PDT)
      Schwergewichtige Entwicklungsumgebung mit sofortigem Syntax Check, Intelligenter Auto-Completion und vielen weiteren nützlichen Features.
    • Aptana Studio
      Ähnlicher Funktionsumfang wie Eclipse PDT da der PHP Teil in älteren Versionen die PDT genutzt hat, auch als Eclipse Plugin verfügbar.
    • Netbeans
  • Editoren
    • Notepad++
      Einfacher Text Editor mit Syntax-Highlighting, Code Folding für diverse Sprachen, Regulären Ausdrücken in der Suchen/Ersetzen Funktion und einigen nützlichen Zusatzfeatures wie Macros, eine Miniatur-Dokumentenübersicht, Column mode editing oder Multi-Editing.
    • PS-Pad
      Ein ebenfalls auf Webdesign zugeschnittener Texteditor. Unterstützt Syntax Highlighting, Makros, direkten FTP Upload (mit integriertem FTP Client) und vieles mehr.
    • komodo Edit
      Editor mit Syntax Highlighting für diverse Sprachen der ähnlich wie Notepad++ ein paar nützliche Zusatzfeatures beherrscht.
    • vim / emacs
      Die üblichen Verdächtigen der Konsole Editoren. Nützlich bei der direkten Dateibearbeitung auf einem Server mit Shellzugriff, aber steile Lernkurve bei der Verwendung.
  • Lokale Webserver
    • XAMPP
      Beinhaltet Apache und Mysql mit jeweils recht neuen PHP Versionen. Enthält außerdem phpmyadmin für die Datenbankverwaltung. Die Software ist für die Verwendung durch Entwickler vorkonfiguriert und verwendet beispielsweise standardmäßig kein Mysql Root Passwort um die Datenbankverwaltung zu erleichtern (dementsprechend in der Standardkonfiguration nicht für den Live-Betrieb zu empfehlen).
    • Auflistung weiterer Möglichkeiten für lokale Webserver
  • Git Tools
    • Git-SCM
      Git Download für mehr oder weniger beliebige Plattformen, verlinkt außerdem weitere Tools und Doku.
    • Msys-Git
      Git Konsole für Windows. Wird von Tortoise-Git benötigt.
    • Tortoise Git
      Windows Explorer Integration für Git. Stellt die meisten wichtigen Funktionen im Kontextmenü des Explorer bereit.
    • Github for Windows
      Github client für Windows.
    • Git Doku
      Ausführliche Git Dokumentation auf http://www.git-scm.com
  • Sonstiges
    • Winmerge
      Hilfreich zum Vergleichen von Dateien oder ganzen Verzeichnissen.
    • Meld
      Visuelles Diff und Merge Tool; File- und Verzeichnisvergleich; Syntax Highlighting; Unterstützung diverser VCS (u.a. Git, SVN)
  • PHP Tools
    • Composer und Packagist
      Paketverwaltung für PHP Software. Lässt sich nutzen, um externe PHP Bibliotheken automatisch zu installieren und zu aktualisieren und verträgt sich mit dem phpBB Extension System (die Abhängigkeiten der Extension können in die composer.json der Extension eingetragen werden). Über Packagist lassen sich auch Extensions selbst in phpBB als Abhängigkeiten definieren und so automatisch installieren und aktualisieren. Beispiel einer Extension mit Abhängigkeit Zugehörige composer.json.
Zuletzt geändert von gn#36 am 07.11.2016 20:49, insgesamt 5-mal geändert.
Grund: phpBB Ext Skeleton ergänzt
Begegnungen mit dem Chaos sind fast unvermeidlich, Aber nicht katastrophal, solange man den Durchblick behält.
Übertreiben sollte man's im Forum aber nicht mit dem Chaos, denn da sollen ja andere durchblicken und nicht nur man selbst.

Benutzeravatar
gn#36
Administrator
Administrator
Beiträge: 9156
Registriert: 01.10.2006 16:20
Wohnort: Ganz in der Nähe...
Kontaktdaten:

Re: Entwickler Dokumentation und Hilfreiche Tools für Entwic

Beitragvon gn#36 » 27.12.2015 14:20

Auch wenn phpBB 3.2.0 noch nicht erschienen ist gibt es natürlich bereits Hinweise, wie einige Dinge an Extensions anzupassen sind, damit sie auch mit phpBB 3.2 laufen.

Die Hinweise wurden von VSE auf phpbb.com zusammengefasst (englisch). Hinweise speziell zu Extensions, die den Beitragsinhalt anpassen gibt es von JoshyPHP ebenfalls auf phpBB.com.
Begegnungen mit dem Chaos sind fast unvermeidlich, Aber nicht katastrophal, solange man den Durchblick behält.
Übertreiben sollte man's im Forum aber nicht mit dem Chaos, denn da sollen ja andere durchblicken und nicht nur man selbst.


Zurück zu „Extension Bastelstube“