/*******************************/
/* SAMP-MySQL-lite v0.1        */
/*                             */
/* Instructions d'installation */
/*******************************/

1. Contenu de l'archive:
------------------------

o samp-mysql-linux: ce dossier contient le code source à compiler pour Linux.
o samp-mysql-win32: ce dossier contient le code source à compiler pour Windows.
o sampmysql.so: plugin pour Linux.
o sampmysql.dll: plugin pour Windows.
o installation-en.txt: instructions d'installation en Anglais.
o installation-fr.txt: instructions d'installation en Français.
o a_sampmysql.inc: fichier .inc à utiliser pour vos scripts.
o Untitled.pwn: exemple d'utilisation du plugin (attention de bien changer les paramètres avec ceux de votre serveur).



2. Installation sous Linux:
---------------------------

o Si ce n'est déjà fait, créez un dossier "plugins" dans le dossier du serveur.
o Copiez "sampmysql.so" dans ce dossier.
o Configurez le fichier "server.cfg", en n'oubliant pas de préciser l'extension (.so) du plugin.
o Maintenant si vous lancez le serveur, le plugin se charge normallement.
o En cas de problème, vérifiez qur vous avez bien MySQL d'installer et installez au cas où "libmysql".
o Pour compiler le code source sous Linux, vous trouverez un sujet sur les forums de SA:MP.



3. Installation sous Windows:
-----------------------------

o Si ce n'est déjà fait, créez un dossier "plugins" dans le dossier du serveur.
o Copiez "sampmysql.dll" dans ce dossier.
o Copiez libmysql.dll, fourni dans le package, dans le même dossier que samp-server.exe.
  PAS dans le dossier plugins
o Ajoutez cette ligne dans le fichier server.cfg:
  plugins samp-mysql (si cela ne fontionne pas rajoutez ".dll").
o Lorsque vou lancez le serveur, vous devriez avoir un message signalant que le plugin est chargé.



4. Compilation sous Linux:
--------------------------

o D'abord, installez le package 'libmysqlclient" (non fournis dans ce package).
o Ouvrez une console (ligne de commande).
o Tapez cette commande: %gcc -Wall -fPIC -c sampmysql.cpp -DLINUX -ISDK/amx
o Tapez cette seconde commande: %gcc -shared -W1,-soname,sampmysql -o sampmysql.so *.o -lmysqlclient



5. Compilation sous Windows:
----------------------------

o Si vous avez installer Dev-CPP, vérifiez que le devpak libmysql soit aussi intallé (non fournis dans ce package).
o Ouvrez le fichier projet devcpp (.dev), clickez sur "Executer", puis sur "Tout reconstruire".



6. Utiliser SAMP-MySQL dans Pawno:
----------------------------------

o Copiez "a_sampmysql.inc" dans le dossier "include" du dossier "Pawno" de la release Windows du serveur SA:MP.
o Incluez le fichier comme vous le faites pour les autres: "#include <a_sampmysql>" (sans les ").
o Compilez (touche F5) et normalement tout ce passe sans erreurs.
o Pour vous aider, un script (Untitled.pwn) est fourni dans l'archive.



7. Bugs Connus:
---------------

o 7.1 Sous Windows: Si le serveur MySQL n'est pas lancé, le serveur samp crashe si une fonction est appelée après un échec de connection par samp_mysql_connect.



8. Issues Connues:
------------------

o => 7.1: Vérifiez toujours les valeur de retour de chaque fonctions avant de continuer le traitement d'un requête.



9. Historique:
--------------

o v0.11:
   - Messages d'erreurs ajoutés.
   - Quelques corrections ont été aportées pour permettre au plugin de fonctionner sous Windows.

o v.01:
   - Première version du plugin.
   - Support minimal de MySQL: connexion, requete, traitement, deconnexion.