mysqli_real_connect
mysqli->real_connect()
(PHP 5)
mysqli->real_connect() — Egy kapcsolatot nyit meg egy MySQL szerverhez
Leírás
Eljárást használó stílus
Objektum-orientált stílus (metódus)
Egy kapcsolatot hoz létre egy MySQL adatbázismotorhoz.
Ez a függvény különbözik a mysqli_connect() függvénytől:
-
a mysqli_real_connect() valódi objektumot igényel, amit a mysqli_init() fügvénnyel kell lérehozni
-
a mysqli_options() függvénnyel különféle opciók adhatóak meg a kapcsolat számára
-
van egy flags paraméter.
Paraméterek
- link
-
Procedural style only: A link identifier returned by mysqli_connect() or mysqli_init()
- host
-
Lehet hosztnév vagy IP cím. A NULL vagy "localhost" értékeket megadva a helyi hosztot veszi fel. Ha lehetséges, adatcsatornát (pipe) használ a TCP/IP protokoll helyett.
- username
-
A MySQL felhasználónévT.
- passwd
-
Ha nincs meg van adva, vagy NULL, akkor a MySQL szerver megpróbálja azonosítani a felhasználót azokkal a felhasználói rekordokkal, melyeknek nem kötelező jelszót megadni. Ez lehetővé teszi egy felhasználónév többféle használatát különböző jogosultságokkal (attól függ, hogy megadott-e jelszót, vagy nem).
- dbname
-
Ha meg van adva, megszabja az alapértelmezett adatbázist, amin majd a kéréseket végrehajtja.
- port
-
Megszabja a MySQL szerverhez való kapcsolódáskor használni kívánt port számát.
- socket
-
Megadja a használni kívánt socket-et vagy az elnevezett pipe-ot.
Note: A socket paramétert megadása nem fogja nyíltan meghatározni a MySQL szerverhez való csatlakozás során használni kívánt kapcsolat típusát. A MySQL adatbázishoz való kapcsolat a host paraméter segítségével lesz meghatározva.
- flags
-
A flags paraméterrel különféle kapcsolatopciók adhatóak meg:
Támogatott jelzők Név Leírás MYSQLI_CLIENT_COMPRESS Tömőrítő protokoll használata MYSQLI_CLIENT_FOUND_ROWS az egyező sorok számát adja vissza, nem az érintettekét MYSQLI_CLIENT_IGNORE_SPACE Engedélyezi a szóközöket a függvények nevei után. Minden függvénynév fentartott szó lesz. MYSQLI_CLIENT_INTERACTIVE Engedélyezi a interactive_timeout-ot (a wait_timeout helyett) a kapcsolat bezárása előtti inaktivitási időként MYSQLI_CLIENT_SSL SSL használata (titkosítás) Note: For security reasons the MULTI_STATEMENT flag is not supported in PHP. If you want to execute multiple queries use the mysqli_multi_query() function.
Visszatérési értékek
Siker esetén TRUE értékkel tér vissza, ellenkező esetben FALSE értéket ad.
Példák
Example#1 Objektum-orientált stílus
<?php
/* olyan kapcsolatobjektum létrehozás, ami még nem csatlakozott */
$mysqli = mysqli_init();
/* kapcsolat opcióinak megadása */
$mysqli->options(MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
$mysqli->options(MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* kapcsolódás a szerverhez */
$mysqli->real_connect('localhost', 'my_user', 'my_password', 'world');
/* kapcsolat ellenőrzése */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
printf ("Connection: %s\n.", $mysqli->host_info);
$mysqli->close();
?>
Example#2 Eljárást használó stílus
<?php
/* olyan kapcsolatobjektum létrehozás, ami még nem csatlakozott */
$link = mysqli_init();
/* kapcsolat opcióinak megadása */
mysqli_options($link, MYSQLI_INIT_COMMAND, "SET AUTOCOMMIT=0");
mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5);
/* kapcsolódás a szerverhez */
mysqli_real_connect($link, 'localhost', 'my_user', 'my_password', 'world');
/* kapcsolat ellenőrzése */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
printf ("Connection: %s\n.", mysqli_get_host_info($link));
mysqli_close($link);
?>
A fenti példa a következő kimenetet adja:
Connection: Localhost via UNIX socket