power lite pdo

PowerLite PDO

PowerLite PDO ist eine leichte, leistungsstarke PHP-Bibliothek, die eine einfache und effiziente Möglichkeit zur Interaktion mit Datenbanken mithilfe von PHP Data Objects (PDO) bietet. Es unterstützt mehrere Datenbanktreiber und umfasst Funktionen wie einfache Verbindungsverwaltung, Abfrageausführung, Ergebnisverarbeitung und Paginierung.

Inhaltsverzeichnis

• Merkmale
• Anforderungen
• Dokumentation
• Installation
• Konfiguration
• Verwendung/Beispiele
• Ausführen von Tests
• Mitwirken
• Lizenz

Merkmale

• Containerisierte Verbindungen: Die Container werden verwendet, um Ihre Datenbank zu verbinden und die Konfiguration und Abhängigkeiten nahtlos zu verwalten.
• Db- und QueryBuilder-Methoden: Führen Sie SQL-Abfragen aus und rufen Sie Ergebnisse mithilfe von Db-Methoden oder dem Fluent QueryBuilder ab.
• Effiziente Ergebnisverarbeitung: Rufen Sie eine einzelne Zeile, alle Zeilen oder den Wert einer bestimmten Spalte mit speziellen Methoden ab.
• Umfassende Datenbankoperationen: Bietet eine breite Palette von Methoden für verschiedene Datenbankinteraktionen.
• Paginierungsunterstützung: Behandeln Sie paginierte Ergebnisse mühelos mit der Pagination-Klasse.
• Fehlermanagement: Benutzerfreundliche Behandlung von Datenbankfehlern und Ausnahmen.
• Debug-Modus: Bietet detaillierte Informationen zu den Anforderungen für Debugging-Zwecke.
• Vorbereitete Anweisungen: Unterstützung für vorbereitete Anweisungen zur Verhinderung von SQL-Injection-Angriffen.
• Transaktionskontrolle: Verwalten Sie Datenbanktransaktionen mit Methoden zum Starten, Festschreiben und Zurücksetzen.
• Hohe Code-Qualitätsstandards: Der Code folgt Best Practices und Codierungsstandards.

Anforderungen

PHP ^7.4, PHP 8.x

Dokumentation

Die Dokumentation für PowerLite PDO ist auf der PowerLite PDO-Website verfügbar.

Zusätzlich zur Dokumentation steht hier auch ein PHPDoc für detailliertere Informationen zu den Klassen, Methoden und deren Parametern zur Verfügung.

Installation

Mit Composer klonen/herunterladen oder installieren

composer require migliori/power-lite-pdo

Konfiguration

Öffnen Sie src/connection.php in Ihrem Code-Editor und ersetzen Sie die Werte der Konstanten durch Ihre Datenbankverbindungseinstellungen (DB_HOST, DB_NAME, DB_USER, DB_PASS, DB_PORT, DB_CHARSET).

Sicherheitsbedenken

Um die Sicherheit zu erhöhen, speichern Sie die Datei außerhalb des Dokumentenstammverzeichnisses Ihres Webservers (dem Verzeichnis, das mit dem Internet verbunden ist) und ändern Sie den Pfad entsprechend in der Konfigurationsdatei ( src/config.php ). Dadurch wird verhindert, dass die Datei direkt über eine URL erreichbar ist.

Verwendung/Beispiele

Wählen Sie Datensätze mithilfe der Haupt-DB-Klasse aus

1. Fügen Sie die Bootstrap-Datei ein und holen Sie sich die Db-Instanz aus dem Container:

    use Migliori  PowerLitePdo  Db ;
   
   // Build the container and connect to the database
   $ container = require_once __DIR__ . ' /vendor/migliori/power-lite-pdo/src/bootstrap.php ' ;
   $ db = $ container -> get (Db::class);

2. Verwenden Sie die Select-Methode der Db-Klasse, um einige Datensätze auszuwählen:

    $ from = ' users ' ; // The table name
   $ fields = [ ' id ' , ' username ' , ' email ' ]; // The columns you want to select
   $ where = [ ' status ' => ' active ' ]; // The conditions for the WHERE clause
   
   $ db -> select ( $ from , $ fields , $ where );

3. Rufen Sie die ausgewählten Datensätze einzeln ab:

    while ( $ record = $ db -> fetch ()) {
       echo $ record -> id . ' , ' . $ record -> username . ' , ' . $ record -> email . "n" ;
   }

Wählen Sie Datensätze mit dem Fluent QueryBuilder aus

1. Fügen Sie die Bootstrap-Datei ein und rufen Sie die QueryBuilder-Instanz aus dem Container ab:

    use Migliori  PowerLitePdo  Query  QueryBuilder ;
   
   // Build the container and connect to the database
   $ container = require_once __DIR__ . ' /vendor/migliori/power-lite-pdo/src/bootstrap.php ' ;
   $ queryBuilder = $ container -> get (QueryBuilder::class);

2. Verwenden Sie den QueryBuilder, um einige Datensätze auszuwählen:

    $ queryBuilder -> select ([ ' id ' , ' username ' , ' email ' ])-> from ( ' users ' )-> where ([ ' status ' => ' active ' ])-> execute ();

3. Rufen Sie die ausgewählten Datensätze einzeln ab:

    while ( $ record = $ queryBuilder -> fetch ()) {
       echo $ record -> id . ' , ' . $ record -> username . ' , ' . $ record -> email . "n" ;
   }

Wählen Sie Datensätze mit Paginierung aus

1. Fügen Sie die Bootstrap-Datei ein und rufen Sie die Paginierungsinstanz aus dem Container ab:

    use Migliori  PowerLitePdo  Pagination ;
   
   // Build the container and connect to the database
   $ container = require_once __DIR__ . ' /vendor/migliori/power-lite-pdo/src/bootstrap.php ' ;
   $ pagination = $ container -> get (Pagination::class);

2. Wählen Sie einige Datensätze aus:

    $ from = ' users ' ; // The table name
   $ fields = [ ' id ' , ' username ' , ' email ' ]; // The columns you want to select
   $ where = [ ' status ' => ' active ' ]; // The conditions for the WHERE clause
   
   $ pagination -> select ( $ from , $ fields , $ where );

3. Rufen Sie die ausgewählten Datensätze einzeln ab:

    while ( $ record = $ pagination -> fetch ()) {
       echo $ record -> id . ' , ' . $ record -> username . ' , ' . $ record -> email . "n" ;
   }

4. Paginierung anzeigen:

    $ url = ' /users ' ; // The URL for the pagination links
   echo $ pagination -> pagine ( $ url );

Ausführen von Tests

Führen Sie zum Ausführen von Tests den folgenden Befehl aus

php ./vendor/bin/phpunit test 

Abhängigkeiten

• Composer: Ein Abhängigkeitsmanagement-Tool für PHP.
• PHP-DI: Ein Abhängigkeitsinjektionscontainer für PHP.
• PDO: Die PHP Data Objects-Erweiterung für den Zugriff auf Datenbanken.
• Datenbanktreiber: Die spezifischen Treiber für die Datenbanken, mit denen Sie eine Verbindung herstellen möchten (z. B. MySQL, PostgreSQL, Oracle, Firebird, ...).

Entwicklungsabhängigkeiten

• PHPUnit: Ein Testframework zum Unit-Testen von PHP-Code.
• PHPStan: Ein statisches Analysetool, das hilft, Fehler im PHP-Code zu finden.
• PHP CodeSniffer: Eine Reihe von Regeln, um sicherzustellen, dass PHP-Code den Codierungsstandards entspricht.

Mitwirken

Beiträge sind jederzeit willkommen!

Bitte kontaktieren Sie uns für Verbesserungsvorschläge oder senden Sie Ihre Pull-Anfragen

Lizenz

GNU General Public License v3.0