Třebaže minule jsme řešili naléhavé problémy s přihlašováním,
vrátíme se dnes k tématu, nadhozenému v předminulém
díle seriálu. Půjde o ukládání a zobrazování textů písní na našem
hudebním webu. Rozbor situace už jsme provedli a řekli jsme si, že
budeme nahrávat texty písní ze souboru, že je budeme ukládat do
databáze a že na to použijeme samostatnou tabulku.
Index v databázi
Zatm prázdná tabulka texty má jednu vadu. Tak, jak je definována, umožňuje zadat více textů k jedné písni. Což je v našem případě logický nesmysl. Tabulku můžeme rychle umravnit přidáním unikátního indexu k poli pisen, což nám umožní zadat ke každé písni nejvýše jeden text.
ALTER TABLE `texty` ADD
UNIQUE (
`pisen`
)
Ačkoli jsem se o tom příležitostně zmiňoval už jinde, tvorba
unikátních indexů má podstatný smysl, protože přenáší část aplikační
logiky na databázi. To oceníte zejména v případě, pokud bude s jednou
databází pracovat více aplikací.
Co neumím
Upřímně řečeno se mi nepodařilo vyřešit problém spočívající v tom,
že nahrávaný soubor může být kódován lecjak. My budeme za "správné"
kódování považovat UTF-8, protože jak web, tak databázi máme celou v
tomto kódování. Co však, když někdo dodá soubor v jiné znakové sadě,
například ISO-8859-2? Obecně řečeno existuje možnost, jak obsah souboru
načíst do proměnné a překonvertovat pomocí funkcí pro konverze
znakových sad, nějak takto:
iconv("ISO-8859-2", "UTF-8", $textpisne)
Pozn.: Abyste mohli používat
funkci iconv, musí být PHP na serveru nastaveno a zkompilováno s
podporou konverzních funkcí. Na Windows bývá situace o něco složitější,
ale i tam to jde zapnout.
Co ale nevím je, JAK zjistit, v jaké znakové sadě byl soubor dodán. Pokud někdo víte, nechám se poučit v diskusi. Kdybychom mohli nějak jednoduše detekovat vstupní kódování, je otázka převodu do UTF-8 hračka. Takto alespoň informujeme uživatele, že chceme, aby soubor byl v UTF-8.
Náhrávání souborů na server
Tento problém jsme již teoreticky rozebírali v díle o uploadu a
downloadu souborů. Děje se to pomocí speciálního formuláře, který
umožní uživateli vybrat soubor na svém disku a odeslat jej na server.
Většina ukázek podobných formulářů neobsahuje žádné jiné ovládací
prvky, není však problém aby formulář obsahoval ještě například další
textová pole. My bychom například zároveň potřebovali zadat název
písně, která se k
textu váže. A protože to musí podle zadání být již existující píseň v
databázi, nahrajeme si seznam písní pomocí funkce do rozevíracího
seznamu. Celé to bude vypadat nějak takto (viz obrázek):
Když se nad tím zamyslíme trochu podrobněji, zjistíme, že bychom asi
v seznamu písní nechtěli mít všechny písně, ale jen ty, které ještě v
databázi nemají zadaný text. Jak to jednoduše udělat? Poradím Vám trik,
kterým to zjistíte pomocí dotazu do databáze. Může se Vám to hodit.
Původní, "hloupý" databázový dotaz sestavující seznam písní mohl docela dobře být:
select id, nazev from
pisne order by nazev
Má však, jak již jsme uvedli tu nectnost, že vrátí i ty písně, které už text mají. Vylepšený dotaz bude tento:
select pisne.id,
pisne.nazev from pisne left join texty on pisne.id = texty.pisen where
texty.pisen is null order by nazev
Pokud se zrovna denně nepohybujete v databázích, dovolím si to
trochu vysvětlit. Dotaz spojuje (join) data ze dvou tabulek (pisne a
texty), a to pomocí tzv. levého vnějšího spojení (LEFT OUTER JOIN). To
znamená, že dotaz vrátí všechny záznamy z "levé" tabulky (v našem
případě tabulky pisne), a to i v případě, že odpovídající záznam v
"pravé" tabulce (v našem případě je to tabulka texty) neexistuje. Pokud
se to stane, jsou v odpovídajících polích vráceny hodnoty NULL. Nás
však shodou okolností zajímají POUZE písně bez textů, takže tomu musíme
trochu pomoci a vybrat tyto řádky pomocí klauzule where. Česky bychom
dotaz mohli převyprávět jako:"Vyber všechny záznamy z tabulky písní,
kde odpovídající text písně nelze najít."
Kromě toho dotazu je funkce pro nahrání písní do rozevíracího
seznamu prakticky totožná s funkcí, pomocí níž jsme nahrávali seznam
písní do diskografie.
Nemusíme se jí tedy příliš dopodrobna zabývat.
Uložení do databáze
Tuto věc jsme řešili v díle o ukládání
binárních dat do databáze. Aby uložení dat dopadlo dobře, musejí se
udělat zhruba tyto kroky:
- Nejprve uklidíme (možná existující) dočasné soubory
- Ověříme si pomocí funkce move_uploaded_file, zda se soubor podařilo nahrát a přesunout na námi zvolené místo.
- Pokud ano, zjistíme si jeho délku. Soubory s nulovou délkou a příliš dlouhé soubory ze zpracování vyloučíme.
- Nahrajeme obsah souboru do proměnné
- Ošetříme tuto proměnnou pomocí addslashes, abychom ji mohli použít pro bezpečné uložení do databáze.
- Provedeme vlastní databázový dotaz.
- Jelikož to mohlo z různých důvodů selhat, budeme testovat, zda se povedlo řádek vložit. Pokud ne, zobrazíme chybu.
- Každopádně odstraníme dočasný soubor.
Celý skript je nesmírně přímočarý a jednoduchý na pochopení. Příště si ukážeme, jak texty písní registrovaným uživatelům zpřístupnit a jak jim je umožnit postahovat.
Změny na portálu
- Změněný soubor admin.php - odkaz na zadání textu písně
- Nový soubor nahrajtextpisne.php - zadávání textu písně
Na současný stav projektu se můžete na našem webu podívat
nebo si jej můžete stáhnout.
Pozn.: Aby Vám stažená verze
fungovala na lokálním stroji, upravte si hodnotu konstant SQL_HOST,
SQL_USERNAME, SQL_PASSWORD a SQL_DBNAME. Případně si je můžete včlenit
do konfiguračního souboru podobně, jako jsem to udělal v souboru
func.php.