Connettiti
Registrati
Aiuto
MYSQL PLUGIN
1) a_sampmysql.inc Download Link: Click
2a) SAMP-MySql Windows Plugin Package Download: Click
2b) SAMP-MySql Ubuntu Plugin Package Download: Click
Di seguito ci sono le istruzioni e informazioni varie riguardo al plugin MySql per SA-MP (Windows Package) il quale potrà essere usato per gestire in un altro modo i dati sul server.(invece che scriverli sui file, ad esempio)
Primi passi - Setup
I Database (DB) usano linguaggio SQL, per chi non sia pratico di questo linguaggio può cominciare a darci un'occhiata dal di qui.
Estraete tutto il contenuto dell'archivio e mettetelo in una cartella a vostra scelta.
Copiate ed in collate IL CONTENUTO della cartella "src" e mettetelo dentro la cartella plugins. Copiate ed incollate anche il file "sampmysql.dll" nella cartella plugins.
Aprite il file server.cfg e alla riga "plugins" aggiungete di fianco: sampmysql.
Andate qui per scaricare l'importantissimo file libmysql.dll che è la libreria del Database.
Questo file va messo nella cartella generale del vostro server, ovvero dove è presente il file samp-server.exe.
mettete il file "a_sampmysql.inc" dentro la cartella pawno/includes/ del vostro server, aprite la vostra GM e nelle prime righe aggiungete
#include <a_sampmysql>
Funzioni & Esempi
Elenco Funzioni.
samp_mysql_connect(server[], user[], password[]); samp_mysql_select_db(db[]); samp_mysql_query(query[]); samp_mysql_store_result(); samp_mysql_fetch_row(line[]); samp_mysql_get_field(field[], value[]); //questa funzione non è dichiarata nel file a_sampmysql.inc, aggiungila manualmente, funzionerà perfettamente samp_mysql_num_rows(); samp_mysql_num_fields(); samp_mysql_ping(); samp_mysql_real_escape_string(src[], dest[]); samp_mysql_free_result(); samp_mysql_strtok(dest[], separator[], src[]); samp_mysql_close();
samp_mysql_connect(server[], user[], password[])
La funzione iniziale senza la quale crea la connessione tra il vostro server e il DB.
Ritorna il valore 1 se tutto è andato bene altrimenti torna il valore 0.
Parametri della funzione:
Server[]: IP del Database
User[]: Lo username con cui vi connettete al DB
Password[]: La password con cui vi connettete al DB
Esempio:
samp_mysql_connect(123.45.67.890, UserSKE, PassSKE);
samp_mysql_select_db(db[])
La funzione si collega al Database che specifichiamo.
Ritorna il valore 1 se tutto è andato per il meglio altrimenti ritorna il valore 0.
Parametro della funzione:
DB[]: Nient'altro che il nome del database a cui collegarsi.
Esempio:
samp_mysql_connect(123.45.67.890, UserSKE, PassSKE); samp_mysql_select_db(NomeDB);
samp_mysql_query(query[])
La funzione eseguira una serie di istruzioni nel database: prelevare dati, registrare dati, cancellare dati.
Ritorna il valore 1 se tutto è andato per il meglio altrimenti ritorna il valore 0.
Parametro della funzione:
Query[]: Le istruzioni da eseguire.
Esempio:
samp_mysql_query("SELECT * FROM utenti WHERE nome_utente="Kevin");
La query appena descritta preleva i valori di tutti i campi della riga, della tabella "utenti", dove il campo "nome_utente" corrisponde alla stringa "Kevin".
samp_mysql_store_result()
Questa funzione DEVE essere chiamata appena dopo aver eseguito la funzione query appena vista, poichè prepara il risultato della query.
Ritorna il valore 1 se tutto è andato per il meglio altrimenti ritorna il valore 0.
Nessun parametro richiesto
Esempio:
samp_mysql_query("SELECT * FROM utenti WHERE nome_utente="Kevin");
samp_mysq_store_result();
samp_mysql_fetch_row(line[])
La funzione "fetch_row" separa tutti i valori dei campi della query eseguita con il carattere "|".
Ritorna il valore 1 se tutto è andato per il meglio, se non ci sono altri campi ritorna0.
Parametro della funzione:
Line[]: La stringa dentro la quale saranno contenuti tutti i valori dei campi della query.
Esempio:
new valori[128];
samp_mysql_query("SELECT * FROM utenti WHERE nome_utente="Kevin");
samp_mysq_store_result();
samp_mysql_fetch_row(valori);
In questo esempio dentro la stringa "valori" si avrà più o meno una cosa così
"Kevin|kevin.******@libero.it|mypassword|8500"
Il primo valore è il nome utente, il secondo è l'email, il terzo è la password e l'ultimo sono i soldi che il giocatore ha IN-GAME.
samp_mysql_get_field(field[], value[])
Questa funzione prende il valore di un campo specifico della tabella del database. (Questa funzione va eseguita dopo fetch_row per prendere i valori)
Ritorna il valore 1 se tutto è qualche valore è stato trovato, se non ha trovato nulla ritorna0.
Parametri della funzione:
Field[]: Il nome del campo da cui prelevare il valore.
Value[]: La variabile dove verrà inserito il valore dal campo prelevato.
Esempio: (Uso sempre lo stesso esempio che si amplia ogni volta in modo che possiate capire)
new valori[128], campo[64];
samp_mysql_query("SELECT * FROM utenti WHERE nome_utente="Kevin");
samp_mysq_store_result();
samp_mysql_fetch_row(valori);
samp_mysql_get_field("nome_utente", campo);
printf("Dal campo 'nome_utente' è stato prelevato il valore: %s", campo);
In questo caso vista la query e il valore preso dentro la stringa "campo" c'è il nome: "Kevin".
samp_mysql_num_rows()
La funzione ritorna il valore del numero di righe di un certo risultato di una query
Nessun parametro richiesto
Esempio:
new valori[128], campo[64];
samp_mysql_query("SELECT * FROM utenti WHERE nome_utente="Kevin");
samp_mysq_store_result();
new linee = samp_mysql_num_rows();
samp_mysql_num_field()
La funzione ritorna il valore del numero di campi di un certo risultato di una query
Nessun parametro richiesto
Esempio:
new valori[128], campo[64];
samp_mysql_query("SELECT * FROM utenti WHERE nome_utente="Kevin");
samp_mysq_store_result();
new campi = samp_mysql_num_field();
samp_mysql_num_ping()
La funzione controlla che la connessione al DB sia eseguita correttamente.
Se torna 0 allora tutto è ok, se torna un valore diverso da 0 allora la connessione non è correttamente riuscita.
Nessun parametro richiesto
Esempio:
samp_mysql_connect(123.45.67.890, UserSKE, PassSKE);
samp_mysql_select_db(NomeDB);
if(samp_mysql_ping() == 0)
{
print("Connessione al DB avvenuta con successo");
}
samp_mysql_real_escape_String(src[], dest[])
Questa funzione è davvero molto utile, infatti se dobbiamo eseguire una query essa controlla che non ci siano caratteri speciali e quindi "sistema" la query in modo che non rechi danni al DB.
Parametri della funzione:
Scr[]: Query sorgente da cui prelevare il codice
Dest[]: Stringa dove torna la query sistemata (Questa stringa DEVE essere grande il doppio+1 della query sorgente Es: se "query[64]" allora "query_sist[129]")
Esempio:
new q[128], q2[257];
format(q, sizeof(q), "INSERT INTO utenti(nome_utente, email, password, soldi) VALUES('%s', '%s', '%s', %d)", NomeUtente, Email, Pass, Soldi);
samp_mysql_real_escape_string(q,q2);
samp_mysql_query(q2);
La query inserisce nel database i vari valori per stabilire un nuovo account utente. Con la funzione real_escape_string si controlla che tutti i campi siano inseriti senza provocare "buchi" nel sistema.
samp_mysql_free_result()
La funzione farà crashare il vostro server.
Quindi è inutilizzabile comunque essa permette di liberare la memoria alloccata al risultato di una query eseguita.
Nessun parametro richiesto
Esempio:
samp_mysql_free_result();
samp_mysql_strtok(dest[], separator[], src[])
Questa funzione funziona esattamente come "strtok()", splitta una stringa a seconda del carattere separatore passato come paramentro.
Parametri della funzione:
Dest[]: La stringa dove destinare il valore di un campo.
Separator[]: Il carattere separatore al quale fare riferimento.
Src[]: La stringa a cui applicare la funzione.
Esempio:
new valori[128], campo[64];
samp_mysql_query("SELECT * FROM utenti WHERE nome_utente="Kevin");
samp_mysq_store_result();
samp_mysql_fetch_row(valori);
samp_mysql_strtok(campo, "|", valori);
printf("Il valore del primo campo della query è: %s", campo);
Alla fin fine questa funzione fa un lavoro simile alla funzione "get_field"
samp_mysql_close()
Chiude la connessione al DB.
Nessun parametro richiesto
Esempio:
samp_mysql_connect(123.45.67.890, UserSKE, PassSKE);
samp_mysql_select_db(NomeDB);
if(samp_mysql_ping() == 0)
{
print("Connessione al DB avvenuta con successo");
}
samp_mysql_close();
TUTORIAL MADE BY SKE92beyond
To Admins
Spoiler
Spero possa servire questo tutorial a qualche utente che usi il DB
Multi-quota
io col mio pc hosto il sito e il server: il sito lo apro con hfs, ho installato il database php e mysql e poi al sito gli faccio leggere i file che voglio, salvandoli nella cartella scriptfile.
Quindi è utilissimo
non capirebbero
