mysql_connect

(PHP 4, PHP 5, PECL mysql:1.0)

mysql_connect — Kapcsolatot nyit meg egy MySQL szerverhez

Leírás

resource mysql_connect ([ string $server [, string $username [, string $password [, bool $new_link [, int $client_flags ]]]]] )

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.

Lásd még