30979 skanuj0419

436 PHP i MySQL dla każdego

Funkcja makeDBConnection służy do nawiązywania połączenia z bazą. Zwraca wartość true, jeżeli udało się nawiązać połączenie z serwerem MySQL i wybrać bazę test, lub też wartość fal se, jeżeli jedna z tych czynności zakończyła się niepowodzeniem. Połączenie jest nawiązywane przez wywołanie funkcji mysq1_connect, natomiast wybór bazy jest dokonywany za pomocą funkcji mysql_select_db.

Zadaniem funkcji getOueryResults jest wykonanie zapytania SQL. Treść tego zapytanie jest jej przekazywana w postaci argumentu o nazwie query. Funkcja służy jedynie do wykonywania zapytań, których wynikiem jest jeden wiersz, nie jest natomiast przystosowana do zapytań zwracających wyniki wielowierszowe. Rezultatem działania getOueryResults jest tablica zawierająca wynik zapytania lub wartość fal se, jeśli zapytanie zostało odrzucone przez serwer bądź też jeśli zapytanie nie zwróciło wyniku (wynikiem jest pusty zbiór danych).

Funkcja deleteUser usuwa z tabeli użytkownika o identyfikatorze przekazanym jej w postaci argumentu o nazwie id. Została tu zastosowana procedura uproszczona, nie jest bowiem sprawdzane, czy użytkownik o podanym identyfikatorze faktycznie istnieje w bazie. Wykonywane jest po prostu zapytanie SQL w postaci:

OELETE FROM Users WHERE Id - $id

W przypadku gdy serwer odrzuciłby zapytanie, czyli kiedy funkcja mysql_query zwróciłaby wartość false, wynikiem działania funkcji deleteUser będzie również wartość false. Jeśli zapytanie zostało wykonane przez serwer, wynikiem działania deleteUser będzie wartość określająca, na ile rekordów w bazie miało wpływ to zapytanie. Dzięki temu zorientujemy się, czy dane faktycznie zostały usunięte.

Zadaniem funkcji searchUser jest odszukanie użytkownika o nazwie przekazanej w postaci argumentu nazwa. Wykonuje ona zatem zapytanie:

SELECT * FROM Users WHERE Nazwa='$nazwa'

poprzez wywołanie opisanej wyżej funkcji getOueryResults. Jeśli wynikiem będzie wartość false, searchUser zwróci wartość USERNAME_NOT_FOUND oznaczającą, że użytkownik o podanej nazwie nie został odnaleziony. Jeśli jednak dane zostaną odnalezione w bazie, są one zapisywane w zmiennych globalnych: id, nazwa, hasło, imię, nazwisko, email. Zmienne te zostaną zadeklarowane w skrypcie user_adm.php, który powstaniew dalszej kolejności, i pozwolą na wyświetlenie danych w formularzu. Po odczytaniu danych funkcja searchUser zwraca wartość true.

Funkcja addUser służy do dodawania nowego użytkownika do bazy. Otrzymuje ona sześć argumentów: id, nazwa, hasło, imię, nazwisko, email, których znaczenie jest zgodne z ich nazwami. Kod rozpoczyna się od sprawdzenia, czy wszystkie argumenty, z wyjątkiem id, zawierają jakieś dane, czyli czy nie występują wśród nich puste ciągi znaków. W przypadku wykrycia takiego faktu funkcja zwraca wartość DATA_MISSING_ ERROR oznaczającą niekompletność danych. Jeśli jednak wszystkie niezbędne dane są obecne, następuje sprawdzenie zawartości argumentu id; ma on bowiem istotny wpływ na dalsze działanie funkcji.