Propel ist ein Werkzeug für die objektrelationale Abbildung (ORM), um PHP-Objekte in einer relationalen Datenbank speichern zu können. Propel wurde für PHP 5 entwickelt und basiert auf dem Apache-Torque-Projekt.^[2]

Propel erlaubt dem Entwickler, Objekte statt SQL zu verwenden, um Daten aus den Tabellen einer Datenbank zu lesen oder zu schreiben. Propel besteht aus zwei Werkzeugen:

• dem Generator, welcher SQL-Definitionsdateien und PHP-Klassen aus dem Datenmodell erstellt
• der Runtime-Engine, mit der Objekte in der Datenbank gespeichert und aus der Datenbank gelesen werden können

Propel bietet einfache Möglichkeiten, um die generierten Klassen an die eigenen Bedürfnisse anzupassen. Durch die Verwendung von XML für die Definition des Datenmodells lässt sich Propel leicht in existierende Frameworks integrieren. Die generierten Klassen können auch als Datenobjekte (DAO) bezeichnet werden.

Auf Basis eines einfachen XML-Schemas, mit dem die Datenbank und die Tabellen beschrieben werden, erstellt der Generator die PHP-Klassen, die mit dem Datenmodell interagieren können, und SQL-Definitionsdateien, um die Tabellen, Schlüssel usw. im relationalen Datenbanksystem zu erstellen.

Die Runtime-Engine bietet die Möglichkeit, die generierten Klassen in den eigenen PHP-Skripten zu verwenden, um das Lesen und Schreiben der Datenbank transparent zu halten. Im Gegensatz zum Generator steht sie auch in einer Version für PHP 4 zur Verfügung. Diese Version wird in Zukunft jedoch nicht mehr weiter gepflegt werden.

Folgende Voraussetzungen müssen erfüllt sein, um Propel nutzen zu können:

• auf dem Server muss PHP 5 installiert sein
• als Datenbankabstraktionsschicht setzt Propel auf PHP Data Objects
• für das Logging wird das PEAR-Paket PEAR::Log benötigt
• Phing wird benötigt, um aus dem Datenmodell des XML-Schemas die Klassen und die SQL-Definitionsdatei zu erstellen

Propel unterstützt derzeit folgende Datenbanken:

• MySQL
• PostgreSQL
• SQLite
• Microsoft SQL Server
• Oracle

• Propel-Projektseite (englisch)
• Propel-Benutzerhandbuch (englisch)
• API-Dokumentation zur Version 1.7.1 (englisch)

1. ↑ Release 1.7.2. 5. November 2019 (abgerufen am 1. Februar 2025).
2. ↑ Stephan Schmidt: PHP Design Patterns, 2. Auflage. O’Reilly Germany, Köln 2009, ISBN 978-3-89721-864-2, S. 351–408. (Kapitel 7, „Enterprise Patterns: Datenschicht und Business-Logik“)