17 Home
blaerf edited this page 2025-12-05 10:02:42 +01:00
This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

PHP-Projekt Wiki-Home

Willkommen im Wiki unseres PHP-Projekts.

Dieses Projekt ist ein Admin-Tool für:

  • LDAP-Login gegen das Active Directory
  • Server-Monitoring über SNMP
  • (geplant) AD-Benutzeranlage einzeln und per CSV-Import
  • (geplant) PowerShell-Wartungsroutinen

An dieser Stelle können wir alle Ideen und Informationen zu unserem Projekt sammeln.

Zur Zeit sind nur unter Anforderungen-und-Ziele, Windows Server Setup, Projektstruktur und Best Practices, Gitea-Workflow und Coding-Guidelines-PHP Inhalte hinterlegt. Nichts davon ist in Stein gemeißelt. Diese Seite ist nur so eine Idee von mir und jeder darf sich hier beteiligen.

Dieses Wiki ist die zentrale Arbeitsgrundlage für das gesamte Team:

  • Projektbeschreibung und Ziele
  • Einrichtung der Entwicklungsumgebung
  • Gemeinsame Coding-Guidelines
  • Arbeits- und Git-Workflow
  • Aufgabenverteilung & Status

Schnellstart

Wenn du neu im Projekt bist, lies die Seiten am besten in dieser Reihenfolge:

  1. Projektübersicht
  2. Anforderungen-und-Ziele
  3. Entwicklungsumgebung-einrichten
  4. Windows Server Setup
  5. Projektstruktur und Best Practices
  6. Gitea-Workflow
  7. Coding-Guidelines-PHP
  8. Logging und Fehlerbehandlung (WICHTIG)

Wichtige Seiten


Repository & Ordnerstruktur

Der Code ist in sinnvolle Module aufgeteilt:

  • public/ - Webroot (nur hier liegen Dateien, die öffentlich erreichbar sind)
  • app/ - Controller, Services, Models
  • config/ - Konfiguration (nicht versionierte secrets, siehe .gitignore im Projekt-Root)
  • storage/ - Logs, Cache, Uploads (über .gitignore komplett vom Repo ausgeschlossen)

Die vollständige Struktur findest du hier: Projektstruktur und Best Practices


Arbeitsweise & Regeln

  • Commits klein und verständlich.
  • Branch-Konzept: feature/… und bugfix/…
  • Pull Requests: mindestens ein Review.
  • Keine Direkt-Pushes auf main/master.
  • Coding-Guidelines einhalten: Coding-Guidelines-PHP

Screenshots & Anhänge

Screenshots bitte in images/ speichern und so einbinden:

Beispiel

Details: Richtlinien-für-Screenshots-und-Dokumentation


Wiki bearbeiten

  • Neue Seite anlegen durch Verlinkung: Seitentitel
  • Seitennamen mit Bindestrichen schreiben.
  • Wiki dient dem Team keine privaten Notizen.