Słownik z branży informatycznej i tworzenia stron WWW

MySQL

MySQL - wolnodostępny system zarządzania relacyjnymi bazami danych.

MySQL tworzony jest przez szwedzką firmę MySQL AB, kupioną 16 stycznia 2008 roku przez Sun Microsystems.

Przydatne funkcje do operacji na bazie MySQL dla języka PHP:

mysql_connect

resource mysql_connect ([ string $serwer [, string $nazwa_uzytkownika [, string $haslo [, bool $nowe_polączenie [, int $flagi_klienta ]]]]] )

Otwiera lub ponownie używa połączenie do serwera MySQL.

parametry:

serwer

Zawiera adres serwera baz danych, można po adresie dodać numer portu. Przeważnie używanaą wartościa jest localhost.

nazwa_uzytkownika

Nazwa użytkownika bazy danych.

haslo

Hasło użytkownika bazy danych.

nowe_polączenie

Jeśli, ponownie wywołamy mysql_connect() z tymi samymi argumentami, nie zostanie nawiązane nowe połączenie, lecz zamiast tego, zostanie zwrócony identyfikator obecnie otwartego połączenia. Parametr nowe_połączenie modyfikuje to zachowanie i sprawia, że mysql_connect() zawsze otwiera nowe połączenie, nawet jeśli mysql_connect() zostało wywołane wcześniej z tymi samymi parametrami.

flagi_klienta

Parametr flagi_klienta może być kombinacją następujących stałych: 128 (włącza obsługę LOAD DATA LOCAL), MYSQL_CLIENT_SSL, MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE lub MYSQL_CLIENT_INTERACTIVE.

zwracane wartości

Zwraca identyfikator połączenia MySQL w przypadku sukcesu, lub FALSE w przypadku porażki.

więcej

mysql_close

bool mysql_close ([ resource $identyfikator_polaczenia ])

Zamyka nie stałe połączenie do serwera MySQL, które zostało skojarzone z podanym identyfikatorem połączenia. Jeśli identyfikator_połączenia nie został określony, zostanie użyte ostatnio używane połączenie.

parametry:

identyfikator_połączenia

Połączenie MySQL. Jeśli identyfikator połączenia nie zostanie podany, użyte zostanie ostatnie połączenie otwarte przez mysql_connect(). Jeśli połączenie takie nie zostanie znalezione, funkcja spróbuje nawiązać połączenie tak, jakby wywołana została funkcja mysql_connect() bez argumentów. Jeśli żadne połączenie nie zostanie znalezione lub nawiązane, wygenerowany zostanie błąd poziomu E_WARNING.

zwracane wartości

Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu.

więcej

mysql_select_db

bool mysql_select_db ( string $nazwa_bazy [, resource $identyfikator_polaczenia ] )

Ustawia aktywną bazę danych na serwerze określonym przez podany identyfikator połączenia. Kolejne wywołania funkcji mysql_query() będą dotyczyły aktywnej bazy danych.

parametry:

nazwa_bazy

Nazwa wybieranej bazy danych.

zwracane wartości

Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu.

więcej

mysql_error

string mysql_error ([ resource $ identyfikator_polaczenia ] )

Zwraca tekst komunikatu błędu z ostatnio użytej funkcji MySQL, lub '' (pusty łańcuch) jeśli wystąpi błąd.

więcej

mysql_escape_string

string mysql_escape_string ( string $lancuch_bez_znakow_unikowych )

Ta funkcja wstawi znaki unikowe do łańcuch_bez_znaków_unikowych , aby bezpiecznym było umieszczenie go w mysql_query().

więcej

mysql_query

resource mysql_query ( string $zapytanie [, resource $identyfikator_połączenia [, int $typ_wyniku ]] )

Wysyła zapytanie do aktywnej bazy na serwerze skojarzonym z podanym identyfikatorem połączenia. Jeżeli identyfikator_połączenia nie został podany, wykorzystywane jest ostatnio otwarte połączenie. Jeżeli żadne połączenie nie jest otwarte, podjęta zostanie próba ustanowienia go, poprzez wywołanie mysql_connect() bez argumentów.

parametry:

typ_wyniku

Może przyjmować wartość MYSQL_USE_RESULT lub MYSQL_STORE_RESULT. Domyślnie używana jest wartość MYSQL_STORE_RESULT, zatem wynik jest buforowany.

zwracane wartości

Zwraca identyfikator wyniku (lub FALSE w przypadku niepowodzenia) jedynie dla zapytań typu SELECT, SHOW, EXPLAIN i DESCRIBE. Dla innych zapytań SQL mysql_query() zwraca TRUE lub FALSE informując czy zapytanie zakończyło się sukcesem czy też nie. Jeśli nie została zwrócona wartość FALSE to znaczy, że zapytanie było prawidłowe i może być wykonane przez serwer. Nie mówi natomiast nic o liczbie przetworzonych lub zwróconych wierszy. Jest również możliwe, że zapytanie zostanie wykonane poprawnie, nie przetwarzając lub zwracając żadnych wierszy.

więcej

mysql_num_rows

int mysql_num_rows ( resource $wynik )

Zwraca liczbę wierszy w wyniku. Tę funkcję stosuje się tylko do operacji SELECT. Aby pobrać ilość wierszy przetworzonych w operacjach INSERT, UPDATE lub DELETE należy użyć funkcji mysql_affected_rows().

więcej

mysql_affected_rows

int mysql_affected_rows ([ resource $identyfikator_polaczenia ] )

Pobiera liczbę wierszy przetworzonych w ostatnim zapytaniu INSERT, UPDATE, REPLACE lub DELETE skojarzonym z identyfikator_połączenia.

parametry:

zwracane wartości

Zwraca liczbę przetworzonych wierszy w przypadku sukcesu i -1 jeśli ostatnie zapytanie zawiedzie.
Jeżeli ostatnim zapytaniem było DELETE bez użycia klauzuli WHERE, wszystkie rekordy zostaną usunięte z tabeli, ale funkcja zwróci zero w wersjach MySQL starszych niż 4.1.2.
Podczas operacji UPDATE, MySQL nie aktualizuje kolumn w których nowa wartość jest identyczna z poprzednią. Możliwe jest zatem, że zwrócona przez mysql_affected_rows() liczba nie będzie odpowiadać liczbie wierszy pasujących do zapytania, ale tych, które zostały faktycznie zmienione.
Wyrażenie REPLACE najpierw skasuje rekord z tym samym kluczem głównym następnie wstawi nowy rekord. Ta funkcja zwraca liczbę skasowanych rekordów plus liczbę wstawionych rekordów.

więcej

mysql_result

mixed mysql_result ( resource $wynik , int $wiersz [, mixed $ pole ] )

Zwraca zawartość jednej komórki z wyniku. Jako argument pole można podać ofset, nazwę pola lub nazwę tabeli z nazwą pola (tabela.pole). Jeżeli nazwa kolumny została zastąpiona synonimem ('select foo as bar from...'), należy użyć tej nazwy zamiast rzeczywistej.

więcej

mysql_fetch_row

array mysql_fetch_row ( resource $wynik )

Zwraca tablicę numeryczną, która odpowiada pobranemu wierszowi i przesuwa do przodu wewnętrzny wskaźnik danych.

parametry:

wynik

Wynik w postaci zmiennej typu resource, które jest przetwarzane. Wynik ten pochodzi z wywołania funkcji mysql_query().

zwracane wartości

Zwraca tablicę numeryczną, która odpowiada pobranemu wierszowi, lub FALSE jeśli nie ma więcej wierszy.
mysql_fetch_row() pobiera jeden wiersz danych z wyniku skojarzonego z podanym identyfikatorem wyniku. Wiersz zwracany jest jako tablica. Komórki są umieszczone pod oddzielnymi ofsetami, zaczynając od 0.

więcej

mysql_fetch_array

array mysql_fetch_array ( resource $wynik [, int $ typ_wyniku ] )

Zwraca tablicę zawierającą pobrany wiersz, lub FALSE jeżeli nie ma więcej wierszy w wynik.
mysql_fetch_array() jest rozszerzoną wersją mysql_fetch_row(). Oprócz zapisywania danych w indeksach numerycznych, zapisuje je też w indeksach przyporządkowujących (asocjacyjnych), używając nazw pól jako kluczy.
Jeżeli dwie lub więcej kolumn wyniku ma te same nazwy, ostatnia kolumna będzie brana pod uwagę. Dostęp do innych kolumn o tej samej nazwie jest możliwy jedynie przez indeksowanie numeryczne lub przez stworzenie aliasa. Po stworzeniu aliasa nie można już odwoływać się do danej kolumny używając jej prawdziwej nazwy (w tym przykładzie używając 'pole').

parametry:

typ_wyniku

Stała, która może przyjmować następujące wartości: MYSQL_ASSOC, MYSQL_NUM i MYSQL_BOTH. Wartością domyślną jest MYSQL_BOTH.

więcej

mysql_free_result

bool mysql_free_result ( resource $wynik )

Zwolni całą pamięć przydzieloną podanemu wskaźnikowi wyniku.

parametry:

zwracane wartości

Zwraca TRUE w przypadku powodzenia, FALSE w przypadku błędu.

więcej

źródło: Wikipedia, PHP.net