Lehký úvod do tvorby databázových aplikací v prostředí PostgreSQL a PHP3

Na čtenáře nejsou kladeny žádné zvláštní nároky. Stačí, když ovládá jazyk HTML a základy práce se systémem PHP3. Znalost jazyka SQL není vůbec na škodu, ale není nezbytně nutná.

Předtím než začneme programovat

Tato fáze vždy sestává z vytvoření datového modelu, který popisuje vztahy mezi jednotlivými entitami. Z tohoto modelu také vyčteme jaké tabulky budou v databázi, jaké budou primární klíče v jednotlivých tabulkách, jaké jsou vztahy mezi tabulkami, jaká platí integritní omezení atd.

Na rozebírání datového modelování zde není prostor. My si vše ukážeme na jednoduché úloze, kde si bez něj vystačíme. Pro složitější systémy je však důkladná analýza nezbytná.

Ukázková aplikace

PostgreSQL

PostgreSQL umožňuje na jednom počítači pracovat s více databázemi. Každá databáze pak může obsahovat několik tabulek, které mohou, ale nemusí, být navzájem provázány. Výpis všech databází uložených v systému získáme pomocí příkazu:

psql -l

psql jméno_databáze -c \\d

Vytvoření nové tabulky

psql jméno_databáze

create table jméno_tabulky (jméno_položky typ_položky, ... )

Vybrané datové typy MySQL

Typ	Popis
int	celé číslo
float	číslo s pohyblivou řádovou čárkou
varchar(n)	textový řetězec o maximální délce n
date	datum ve tvaru RRRR-MM-DD
time	čas ve tvaru HH:MM:SS

My vytvoříme tabulku adresar se čtyřmi položkami jméno, příjmení, e-mail a datum narození.

create table adresar (jmeno varchar(15), prijmeni varchar(15), 
                      email varchar(40), narozen date);

O tom, že se tabulka skutečně vytvořila, se můžeme přesvědčit pomocí příkazu \d zadaného v prostředí programu psql.

Přidání nového záznamu do tabulky

insert into jméno_tabulky values (hodnota1, ..., hodnotaN)

insert into adresar values ('Jan', 'Novák', 
                            'Jan.Novak@mail.cz', '1965-08-25');

Výběr a prohlížení záznamů v tabulce

select * from jméno_tabulky

select * from adresar;

select * from adresar where prijmeni like 'Novák';
select * from adresar where email = 'jkj@sorry.vse.cz';
select * from adresar where prijmeni = 'Procházka' and jmeno = 'Karel';
select * from adresar where prijmeni like 'Pro%';

Rušení záznamů v tabulce

delete from jméno_tabulky where podmínka

select oid, * from adresar;

delete from adresar where oid=24003;

Změna záznamu v tabulce

update jméno_tabulky set položka=hodnota, ... where podmínka

update adresar set email="novak@ini.cz" where oid=18937;

Smazání celé tabulky

drop table jméno_tabulky

Přístupová práva k tabulce

grant all on jméno_tabulky to public;

PHP3

<? $conn = pg_Connect("localhost", "", "", "", "jméno_databáze")?>

    práce s databází

<? pg_Close($conn)?>

Výpis záznamů z tabulky

V případě příkazu select je výsledkem seznam záznamů. Funkce v tomto případě vrací ukazatel na seznam záznamů. Tyto záznamy jsou pak dále přístupné pomocí dalších funkcí. Příklad dotazu v PHP:

<?
    $result = pg_exec("select * from adresar");
?>

<?
    $conn = pg_Connect("localhost", "", "", "", "test");
    $result = pg_exec("select * from adresar");
    $pocet = pg_NumRows($result);
    echo "V tabulce adresar je $pocet záznamů.";
    pg_Close($conn);
?>

pg_Result($result, číslo_záznamu, položka)

<?
    $conn = pg_Connect("localhost", "", "", "", "test");
    $result = pg_exec("select * from adresar");
    $pocet = pg_NumRows($result);
    echo "V tabulce adresar je $pocet záznamů.";
    echo "<P>";
    $i = 0;
    while ($i<$pocet):
        echo pg_Result($result, $i, "jmeno") . " " .
             pg_Result($result, $i, "prijmeni") . ", " .
             pg_Result($result, $i, "email") . ", " .
             pg_Result($result, $i, "narozen") . "<BR>";
        $i++;
    endwhile;
    pg_Close($conn);
?>

Pokud již nepotřebujeme s výsledkem dotazu dále pracovat, je vhodné uvolnit paměť, ve které je výsledek uložen. To provedeme voláním funkce pg_FreeResult($result).

Pokud výsledkem volání funkce pg_exec() není seznam záznamů (např. po SQL příkazech update, delete nebo insert), vrací funkce true. Pokud při provádění SQL příkazu došlo k chybě, vrátí funkce hodnotu false.

Počet záznamů, kterých se dotklo provedení operace update, delete nebo insert, vrací funkce pg_Affected_Rows().

Přidání nového záznamu do tabulky

<?
    $conn = pg_Connect("localhost", "", "", "", "test");
    $result = pg_exec("insert into adresar values ('$jmeno', '$prijmeni', " +
	              "'$email', '$narozen')");
    if ($result):
        echo "Do adresáře byl úspěšně přidán nový záznam.";
    else:
        echo "A sakra! Nový záznam se do adresáře nepodařilo přidat.";
    endif;
    pg_Close($conn);
?>    

Zrušení záznámu v tabulce

<?
    $conn = pg_Connect("localhost", "", "", "", "test");
    $result = pg_exec("delete from adresar where oid=$oid");
    if ($result):
        echo "Záznam se podařilo úspěšně vymazat.";
    else:
        echo "Záznam nelze vymazat, do povrchu pevného disku je vyryt.";
    endif;
    pg_Close($conn);
?>    

Změna záznámu v tabulce

<?
    $conn = pg_Connect("localhost", "", "", "", "test");
    $result = pg_exec("update adresar set email='$email' where oid=$oid");
    if ($result):
        echo "Záznam se podařilo úspěšně aktualizovat.";
    else:
        echo "Záznam nelze aktualizovat, do povrchu pevného disku je vyryt.";
    endif;
    pg_Close($conn);
?>