mysql_connect
(PHP 4, PHP 5, PECL mysql:1.0)
mysql_connect — Kapcsolatot nyit meg egy MySQL szerverhez
LeÃrás
Megnyit vagy újrahasznosÃt egy MySQL szerver kapcsolatot.
Paraméterek
- server
-
A MySQL szerver. Tartalmazhat egy port számot is, pl. "hostname:port" vagy egy helyi socket útvonalát, pl. ":/path/to/socket".
Ha a mysql.default_host PHP direktÃva nem definiált (ez az alapértelmezés), akkor az alapértelmezett értéke ' localhost:3306'. SQL safe mode-ban, ezt a paramétert kihagyja, és mindig 'localhost:3306' értéket használja a PHP.
- username
-
A felhasználónév. Alapértelmezett értéke a mysql.default_user. SQL safe mode-ban, ezt a paramétert kihagyja, és a szerverfolyamat a tulajdonosának a nevét használja a PHP.
- password
-
A jelszó. Alapértelmezett értéke a mysql.default_password. In SQL safe mode-ban, ezt a paramétert kihagyja, és egy üres jelszót használ a PHP.
- new_link
-
Ha a mysql_connect() függvényt kétszer ugyanazokkal a paraméterekkel hÃvod meg, akkor nem jön létre újabb kapcsolat; a függvény a már meglévÅ‘ kapcsolat azonosÃtóját fogja visszaadni. A new_link paraméter módosÃtja ezt a viselkedésmódot, és a mysql_connect() függvényt új link megnyitására kényszerÃti, még akkor is, ha elÅ‘zÅ‘leg a mysql_connect() függvényt ugyanazokkal a paraméterekkel hÃvtad meg. SQL safe mode-ban ezt a paramétert kihagyja a PHP.
- client_flags
-
A client_flags az alábbi konstansok kombinációja lehet: MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE vagy MYSQL_CLIENT_INTERACTIVE. Lásd a MySQL részt további információkért. SQL safe mode-ban ezt a paramétert kihagyja a PHP.
Visszatérési értékek
Sikeres végrehajtás esetén visszaad egy MySQL kapcsolat azonosÃtót, hiba esetén pedig FALSE-ot.
Változások naplója
| Változat | LeÃrás |
|---|---|
| 4.3.0 | client_flags paraméter hozzáadása. |
| 4.2.0 | new_link paraméter hozzáadása. |
| 3.0.10 | A ":/path/to/socket" támogatása a server paraméterrel. |
| 3.0.0 | A ":port" támogatása a server paraméterrel. |
Példák
Example#1 mysql_connect() példa
<?php
$kapcsolat = mysql_connect("localhost", "felhasználónév", "titok");
if (!$kapcsolat) {
die('Nem lehet csatlakozni ' . mysql_error()));
}
echo('A csatlakozás sikerült');
mysql_close($kapcsolat);
?>
Example#2 mysql_connect() example using hostname:port syntax
<?php
// we connect to example.com and port 3307
$link = mysql_connect('example.com:3307', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
// we connect to localhost at port 3307
$link = mysql_connect('127.0.0.1:3307', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
?>
Example#3 mysql_connect() példa ":/path/to/socket" szintaxist használva
<?php
// kapcsolódás a localhost-hoz és socket-hez, pl: /tmp/mysql.sock
//1. változat: localhost kihagyása
$link = mysql_connect('/tmp/mysql', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
// 2. változat: localhost-tal
$link = mysql_connect('localhost:/tmp/mysql.sock', 'mysql_user', 'mysql_password');
if (!$link) {
die('Could not connect: ' . mysql_error());
}
echo 'Connected successfully';
mysql_close($link);
?>
Megjegyzések
Note: Amikor "localhost"-ot vagy "localhost:port"-t adsz meg szerverként a MySQL kliens könyvtár felülbÃrálja ezt és megpróbál egy helyi socket-hez kapcsolódni (Windows-on pipe). Ha TCP/IP-t szeretnél használni, használd a "127.0.0.1" alakot "localhost" helyett. Ha a MySQL kliens könyvtár rossz helyi socket-hez próbál csatlakozni, állÃtsd be a megfelelÅ‘ útvonalat a MySQL PHP beállÃtással, a szerver mezÅ‘t pedig hagyd üresen.
Note: A kapcsolat a szerverrel a lehetÅ‘ leghamarabb bezárul, amikor a szkript befejezi működését, kivéve ha korábban be lett zárva explicit módon a mysql_close() meghÃvásával.
Note: Az esetleges hibaüzeneteket a @ operátorral nyomhatod el, a függvényhÃvás elé való beszúrásával.