Ce guide s'adresse aux développeurs souhaitant utiliser l'ORM Propel sur un hébergement où l'accès ligne de commande est restreint.

Préambule

• L’ORM permet de lier les objets d’une application aux tables d’une base de données. On manipule les données via des objets PHP plutôt que d'écrire du SQL brut.
• Propel est la couche d'abstraction qui gère ces interactions (relations, jointures, pagination) pour simplifier la maintenance du code.

Particularités & limitations

• Propel n'est pas préinstallé via Pear. Vous devez l'installer manuellement dans votre projet.
• Il est impératif de télécharger la version "Conventional Package" de Propel.
• Les commandes CLI (comme propel-gen) ne sont pas exécutables sur le serveur.
• En conséquence, Propel ne s'utilise qu'en mode "Runtime" sur la production. La génération des classes (build) doit être effectuée localement.
• Le workflow consiste à générer le code sur un environnement de développement, puis à transférer les fichiers résultants vers le serveur.

Dépendances

• L'ensemble des librairies nécessaires à Propel est disponible, à l'exception de Phing.
• L'absence de Phing n'impacte pas la production, car cet outil est uniquement requis lors de la phase de génération locale.