3. Exemple d'installation / utilisation de la classe MiniPoll

3.1 Installation des tables MySQL

Dans le fichier readme.txt, l'auteur nous demande de créer 3 tables MySQL et il donne le code SQL.
Il y a plusieurs façons de le faire ( voir mysql-intro.html )
Pour une petite application nous conseillons simplement de "plâtrer" les définitions SQL dans votre base de données à l'aide de phpMyAdmin. Concrètement il faut copier/coller le texte suivant:

# Table structure for table `poll_check`

CREATE TABLE `poll_check` (

  `pollid` int(11) NOT NULL default '0',

  `ip` varchar(20) NOT NULL default '',

  `time` varchar(14) NOT NULL default ''

) TYPE=MyISAM COMMENT='';

# --------------------------------------------------------

# Table structure for table `poll_data`

CREATE TABLE `poll_data` (

  `pollid` int(11) NOT NULL default '0',

  `polltext` varchar(50) NOT NULL default '',

  `votecount` int(11) NOT NULL default '0',

  `voteid` int(11) NOT NULL default '0',

  `status` varchar(6) default NULL

) TYPE=MyISAM COMMENT='';

# --------------------------------------------------------

# Table structure for table `poll_desc`

CREATE TABLE `poll_desc` (

  `pollid` int(11) NOT NULL default '0',

  `polltitle` varchar(100) NOT NULL default '',

  `timestamp` datetime NOT NULL default '0000-00-00 00:00:00',

  `votecount` mediumint(9) NOT NULL default '0',

  `STATUS` varchar(6) default NULL,

  PRIMARY KEY (`pollid`)

) TYPE=MyISAM COMMENT='';

La plupart des librairies ont un fichier de configuration qui demande d'indiquer les paramètres suivants:

le nom de la base de données, utilisateur MySQL, mot de passe, le nom de la machine "hôte" ("localhost" si MySQL est sur la même machine que le serveur Web)
Souvent (mais pas ici !) il faut également indiquer où se trouvent les fichiers et quel URL vous allez utiliser pour accéder à votre dispositif.

Note: Dans le fichier readme.txt l'auteur ne dit pas quel fichier il faut éditer, mais il est souvent sous-entendu qu'un tel fichier s'appelle "config.php" ou encore "config.inc.php".
Note: Dans la version téléchargé de phpclasses.org la structure des répertoires est cassée (les fichiers sont à plat), et les instructions de l'auteur ne collent pas.

// config.php

$host = "localhost"; // db host

$user = "nobody"; // db username

$pass = ""; // db password

$db = "demo"; // db name

Selon l'auteur (point 3 de readme.txt), vous avez 2 possibilités: soit vous suivez les instructions, soit vous adaptez les fichiers exemples.
Pour tester les classes, nous suggérons d'utiliser les fichiers exemples, et ensuite d'incorporer leur code dans vos propres pages *.php.
En gros, l'utilisation de la classe est assez simple:

Pour afficher un "poll":

include_once ("includes/miniPoll.class.php");

include_once ("config.php");

$connection = mysql_connect ($host, $user, $pass) or die ("Unable to connect");

mysql_select_db ($db) or die ("Unable to select database");

$test = new miniPoll;

$test->pollForm();

@mysql_close($connection);

(a) changer les instructions PHP "include_once (" ...")
(b) changer les lignes $this->results_page dans les classes. (voir points 6 et 7)