'Ze Cow (tm)' version 4

'Ze Cow (tm)' est un générateur automatique d'applications web pour Oracle écrit en PHP

Principales fonctionnalités
prérequis logiciels
Vérifications d'usage
Installer 'Ze Cow (tm)'
Configurer 'Ze Cow (tm)'
Exemples basiques
Tests de 'Ze Cow (tm)'
Remarques complémentaires

Principales fonctionnalités

affichage des données automatique (affichage dynamique du contenu d'une table ou vue, avec possibilité de tri ascendant ou descendant sur toutes les colonnes)
recherche multi-critères (affiche dynamiquement un formulaire de recherche, adapté à la table passée en paramètre et autorise les recherche mono ou multi-critères, sur mot complet ou partiel, sensible à la casse ou non)
mise à jour de données automatique (via des icones ou des boutons : création d'enregistrement, modification ou suppression)
multi plateforme (Windows avec EasyPHP par exemple, Unix, Linux. (il est codé en PHP)
personnalisable (s'appuie sur des feuilles de style prédéfinies aisément modifiable, entetes et bas de pages paramétrables)
simple à mettre en oeuvre : un seul fichier de configuration (au format texte) et 2 principaux modules PHP (affiche_liste.php et affiche_formulaire.php)
fait meuh !

Prérequis logiciels

un OS quelconque ;-)
un serveur web (apache par exemple)...
... avec le module PHP version 4 ou supérieure.
un client Oracle version 8 ou supérieure sur le même serveur
une base Oracle version 8 ou supérieure, sur le même serveur ou non

Vérifications d'usage

Vérifiez que votre serveur Web fonctionne (http://mon_serveur répond dans votre navigateur)
Verifiez que php fonctionne sur votre serveur (vous pouvez utiliser la page de test de 'Ze Cow (tm)' )
Vérifiez que les extensions Oracle (OCI8) de PHP sont bien installées : toujours sur la page de test de 'Ze Cow (tm)' verifiez que le module OCI8 apparait bien dans la configuration de PHP
Vérifier que le client oracle est correctement installé (essayez par exemple de consulter une table avec SQL+ ).

Installer 'Ze Cow (tm)'

Si ce n'est pas fait Télechargez 'Ze Cow (tm)' (V4) au format zip.

Décompressez l'arborescence complète sur (un sous répertoire de) la racine de votre serveur Web.

Tester que la connexion PHP / Oracle fonctionne en utilisant par exemple le fichier test/connexion_oracle.php fourni sur la page de test de 'Ze Cow (tm)'

Configurer 'Ze Cow (tm)'

récupérer le fichier mon_projet .ini
Configurer 'Ze Cow (tm)' :
- Avec le notepad ou un autre editeur,changez au moins :
- le nom de la base Oracle (Variable $database), du schéma (Variable $user), le mot de passe (Variable $passwod), de la table (Variable $nom_table) et les paramètres d'affichage voulus. Ce fichier est commenté.
- veillez à le sauvegarder localement sur votre disque dur avec le nom de votre projet et le suffixe '.ini'
- déposer le nouveau fichier projet sur le serveur dans le répertoire config
appeler l'URL correspondant à votre projet (en mettant nom_projet=votre_nom_de_projet comme paramètre d'appel de 'affiche_liste.php ou de 'affiche_formulaire.php' suivant le cas)

Exemples basiques

pour consulter le catalogue
http://mon_serveur/ZeCow/affiche_table.php?nom_projet=catalogue_client
ou pour la mise à jour du catalogue
http://mon_serveur/ZeCow/affiche_formulaire.php?nom_projet=catalogue_client&maj=1

D'autres exemples, un (tout petit) peu plus sophistiqués, écrans et fichiers de configuration associés sont disponibles ici.

par défaut : la recherche est insensible aux différences Majuscules / Minuscules et se fait sur le début du mot saisi. On peut modifier les paramètres adéquats et forcer la recherche sur "mot complet" uniquement et sensible aux majuscules / minuscules par exemple.
pour obtenir la possibilité de créer une nouvelle fiches via le formulaire ou voir les icones de modification / suppression apparaître à gauche de la liste, n'oubliez pas de rajouter le paramètre 'maj=1' en fin d'adresse URL, respectivement à l'appel de affiche_formulaire.php et affiche_liste.php

Tests

'Ze Cow (tm)' a été testé avec Oracle et (partiellement) avec MySQL.
Il fonctionne correctement avec IE6 et + (avec certains Netscape vous perdrez les couleurs fonds de cellules mais ca marche quand même).

Remarques complémentaires

'Ze Cow (tm)' est facilement portable vers d'autres SGBDRs. Il s'appuie sur <DataLib>
<Datalib> est un "Database Abstraction Layer" : une couche de communication standardisee multi SGBD, open source, sous licence GNU.
<DataLib> a ete écrit par Sean Finkel <alarion@databound-software.com>
et légèrement modifie par DD pour la partie Oracle et MySQL, pour notamment renvoyer les noms de colonne.
Plus d'infos dans le repertoire DOC de DataLib...et dans le Copyright <DataLib>

Comments : Vos remarques, commentaires, suggestions et correctifs sont les bienvenu(e)s.
Vous pouvez m'envoyer un mail en passant par les liens 'contacts' de mon site : http://didier.deleglise.free.fr (qui sont à priori plus pérenne que ma boite aux lettres actuelle).

Utilisation : 'Ze Cow (tm)' ne peut être vendu, et est librement utilisable à des fins non commerciales. Il devra conserver les références à son auteur (et lien correspondants) , dans les sources et en bas de page. En cas de projet particulier, me contacter via mon site ou mon forum Oracle.

ZeCow est dansune version éminemment perfectible et en cours de reecriture complète. Elle sera disponible pour le forum PHP 2004 de l'AFUP à Paris (lors duquel je ferai une conférence sur Oracle et PHP ;-)

Enjoy !

Didier 'Daredevil' Deleglise, The man with no fur.

Page (unfortunately) NOT powered by