Copix

Les options suivantes du fichier php.ini sont conseillées, mais Copix marchera quelles que soient leurs valeurs. L'option la plus importante étant magic_quotes_gpc qui doit être de préférence off : si ce n'est pas possible (par exemple, accès impossible au fichier php.ini), le plugin Copix MagicQuotes annulera l'échappement des chaînes d'entrée.

magic_quote_gpc = off

# ces 3 paramètres sont utiles si vous utilisez la session
Session.use_cookies = 1
Session_autostart = 0
Session.save_handler = files

# pour des raisons de sécurité
register_globals = Off

# pour plus de sécurité
display_errors = Off
file_uploads = Off # si vous ne faites pas d'upload de fichier
allow_url_fopen = Off
session.save_path = répertoire accessible uniquement par PHP (écriture et lecture)

Page d'installation de Copix 2.3.5

• Dupliquer les répertoires de l'archive de Copix dans le répertoire web : project/, temp/, utils/, var/ et www/ pour Copix 2.3.5 ;
• donner les droits de lecture au serveur web pour tous ces répertoires et leur contenu ;
• donner les droits d'écriture pour le répertoire temp/.

Si tout a été configuré correctement, une page de Copix s'affiche, proposant la configuration d'une base de données.

Le serveur web doit pointer sur le répertoire Copix www/, qui contient index.php.

Un module minimal nécessite la création de deux fichiers :

• une classe qui hérite de l'objet ActionGroup :

<?php
class ActionGroupTutorial extends CopixActionGroup
{
    function getSimpleHelloYou ()
    {
        $tpl = new CopixTpl();
        $tpl->assign('MAIN', 'Hello You !');

        return new CopixActionReturn(COPIX_AR_DISPLAY, $tpl);
    }
}
?>

ce fichier, appelé tutorial.actiongroup.php est à mettre dans le répertoire actiongroup/ d'un module : project/modules/tutorial/actiongroup/.

• un fichier de description :

<?php
$hello = & new CopixAction ('Tutorial', 'getSimpleHelloYou');
?>

ce fichier, appelé default.desc.php est à mettre dans le répertoire desc/ du module : project/modules/tutorial/desc/.

L'appel de la page qui affichera le message Hello You ! sera alors :

index.php?action=hello&module=tutorial

Le même objet peut être installé au niveau du projet :

• le fichier tutorial.actiongroup.php sera dans le répertoire project/actiongroup ;
• le contenu du fichier default.desc.php ajouté à celui qui existe : project/desc/default.desc.php ;
• l'URL de la page sera simplement :

index.php?action=hello

Une Zone Copix représente une portion du contenu qui sera affichée dans un écran. Les zones sont appelées par les Actions Copix qui leur délèguent une partie du travail. L'utilisation de zones n'est pas obligatoire mais simplifie le développement en séparant clairement les parties d'affichage dynamique. De plus, les zones Copix gèrent nativement un cache de contenu.

CopixDAO est une couche d'abstraction des bases de données utilisant comme définition un fichier XML. Ce fichier contient les données de connexion, la description des tables et de leurs champs, et optionnellement :

• des méthodes d'accès supplémentaires (en plus des méthodes standard qui sont : get, insert, update, delete, findAll et findBy) ;
• des méthodes écrites en PHP qui feront partie de l'objet concret CopixDAO correspondant.

La version 3 de Copix, vous permet également d'utiliser des DAO Automatiques. Ces DAO automatiques sont automatiquement générés depuis les champs de la table demandé à la DAO.

Le nom « DAO » vient du motif de conception utilisé : Data Access Object, un motif courant pour les accès aux bases de données. CopixDAO prend en charge la construction des requêtes SQL (sauf les plus complexes) ainsi que les problèmes de sécurité (e.g. les injections SQL).

ce module permet l'internalisation des mnémonics du framework selon le langage du site à utiliser