Preklad príkladu - Blog Example for Delphi for PHP

Autor: Jonathan Benedicto

Inštalácia
Tento príklad blogu ja založený na MySQL databáze a obsahuje 3 tabuľky. Štruktúra databázy môže byť vytvorená použitím súboru blog_tables.sql.
Informácie o pripojení k databáze sú uložené v súbore configure.php. Prispôsobte tento súbor na Vaše nastavenie.

Administrácia
Prednastavené užívateľské meno a heslo pre administráciu je test/test. Aktuálne hodnoty sú uložené v tabuľke admins.

Spustenie
Otvorte index.php a stlačte tlačítko Run

UserGuide - kapitola 2.4

2.4 Nasadenie PHP aplikácií – prehľad

Potom, ako napíšete, otestuje a vyladíte Vašu aplikáciu, môžete ju sprístupniť pomocou jej nasadenia.

Redistribúcia súborov Delphi for PHP

Veľa súborov asociovaných s aplikáciami Delphi for PHP sú subjekty s obmedzenou redistribúciou alebo nemôžu byť redistribuované vôbec. Nasledovné dokumenty poukazujú na legálnosť týkajúcu sa redistribúcie týchto súborov.

• deploy.htm – obsahuje uváženie nasadenia pre Delphi for PHP.
• license.txt – adresuje legalitu a povinnosti ohľadne Delphi for PHP.
• readme.htm – obsahuje last minute informácie o Delphi for PHP, možné informácie, ktoré by mohli mať vplyv na redistribúciu práv pre súbory Delphi for PHP files.

Tieto súbory sú umiestnené v adresári kde je nainštalované Delphi for PHP alebo v hlavnom adresári na CD.

Redistribúcia softvéru tretích strán

Redistribučné práva pre softvér tretích strán (komponenty, utility a help aplikácie), sa riadia výrobcom, ktorý tento softvér poskytuje. Predtým ako budete redistribuovať softvér tretích strán spolu s Vašou aplikáciou vytvorenou v Delphi for PHP, konzultujte to s výrobcom alebo softvérovou dokumentáciou.

Užívateľská príručka v anglickom jazyku.

Preklad príkladu - Basic Authentification

Tento príklad charakterizuje komponent BasicAuthentification, ktorý dovoľuje pohodlne použiť HTTP autentifikáciu bez vytvárania súborov na serveri. Autentifikácia prebieha iba posielaním potrebných hlavičiek browseru.
Pre použite komponentu ho stačí vložiť do formulára a zavolať exekučnú metódu na udalosť OnBeforeShow stránky. Toto prinúti komponet zobraziť autentifikačné okno v prípade, že užívateľ nebol ešte validovaný.
Musíte zadať vlastnosti komponentu (UserName a Password), na špecifikáciu, ktorej kombinácia bude validná alebo môžete použiť udalosť OnAuthenticate na vykonanie komplikovanejšej autentifikácie ako napr. hľadanie v databáze.
Na rozoznanie, ktoré meno a heslo bolo zadané užívateľom, skontrolujte parameter udalosti $params.

UserGuide - kapitola 2.3

2.3 Ladenie – prehľad

Debugger Vám umožňuje nájsť a odstrániť chyby vzniknuté počas behu aplikácie a logické chyby. Použitím debuggera môžete krokovať kód, nastavovať body prerušenia (breakpoints) chodu aplikácie, sledovať, kontrolovať a modifikovať programové premenné. Ak ladíte Vašu aplikáciu, ladiace okná Vám pomôžu manažovať celé ladenie a poskytujú informácie o stave Vašej aplikácie.

Krokovanie kódu

Krokovanie kódu umožňuje spustiť Váš program riadok po riadku. Po každom kroku môžete kontrolovať stav programu, prezerať programové výstupy, modifikovať premenné a pokračovať s vykonávaním kódu na ďalšom riadku. Ďalší riadok kódu nebude vykonaný, pokiaľ neumožníte debuggeru pokračovať.
Menu Run poskytuje príkazy Trace Into a Step Over. Oba príkazy hovoria debuggeru aby pokračoval na nasledujúcom riadku kódu. Ak riadok obsahuje volanie funkcie, Trace into vykoná funkcie a zastaví sa na prvom riadku kódu vo funkcii. Step over vykoná funkciu a až potom sa zastaví na prvom riadku po ukončení funkcie. 2

Breakpoints

Body prerušenia pozastavia vykonávanie programu v určitom bode programu alebo keď sa objaví partikulárna podmienka. Potom môžete použiť debugger napr. na prezeranie stavu Vášho programu.
Debugger podporuje zdrojové body prerušenia, ktoré pozastavia vykonávanie v špecifickom mieste vo Vašom zdrojovom kóde.

Watches

Watches dovoľujú sledovať hodnoty premenných alebo ich výrazy keď krokujete vo Vašom programe. Hodnota sledovaného výrazu sa mení, keď Váš program updatuje ľubovoľnú premennú obsiahnutú v sledovanom výraze.

Užívateľská príručka v anglickom jazyku.

UserGuide - kapitola 2.2

2.2 Editovanie kódu – prehľad

Code Editor je prispôsobiteľný editor, ktorý poskytuje zvýrazňovanie syntaxe a možnosť mnohonásobných spätných krokov (undo). Keď navrhujete užívateľské rozhranie pre Vašu aplikáciu, Delphi for PHP vygeneruje kód. Keď modifikujete vlastnosti objektu, Vaše zmeny sa automaticky odzrkadlia v zdrojovom súbore.
Pretože všetky Vaše programy zdieľajú všeobecné charakteristiky, Delphi for PHP vygeneruje kód hneď po spustení. Vygenerovanie kódu si môžete predstaviť ako šablónu, ktorú môžete overovať a modifikovať za účelom vytvorenia Vášho programu.
Code Editor poskytuje nasledovné možnosti ako Vám pomôcť pri písaní

• Code Insight
• Bookmarks

Code Insight

Code Insight poukazuje na podmnožinu vlastností vstavaných v Code Editore, ktorá pomáha pri procese písania kódu. Tieto vlastnosti pomáhajú identifikovať všeobecné vyjadrenia (statements), ktoré si želáte vložiť do Vášho kódu a napomáhajú pri výbere vlastností a metód. Niektoré z týchto vlastností sú detailnejšie popísané v ďalších podkapitolách.

Bookmarks

Bookmarky poskytujú pohodlný spôsob navigácie v dlhých súboroch. Miesto vo Vašom kóde môžete označiť bookmarkom a skočiť do tohto miesta z iného miesta v súbore. Môžete použiť až 10 záložiek, označených od 0 po 9 v jednom súbore. Keď nastavíte bookmarku, v ľavom rohu Code Editora sa zobrazí ikona knihy.

Užívateľská príručka v anglickom jazyku.

UserGuide - kapitola 2 a 2.1

2 Koncepty
Táto kapitola obsahuje konceptuálne informácie pre Delphi for PHP.

2.1 Rozhranie pre užívateľský návrh – prehľad

Grafické vizuálne rozhranie (GUI) pozostáva z jedného alebo viacerých okien, ktoré umožňujú užívateľovi interakciu s jeho aplikáciou. V čase návrhu sú tieto okná nazývajú formuláre. Designer a formuláre Vám pomáhajú rýchlo a ľahko vytvoriť profesionálne vyzerajúce užívateľské rozhranie.

Designer

Keď vytvárate aplikáciu, IDE automaticky zobrazí vhodný typ formuláre. Keď umiestnite komponenty (návestia alebo textové polia) do formulára z palety nástrojov, Delphi for PHP vygeneruje kód do aplikácie. Použitím Object Inspectora môžete modifikovať vlastnosti komponentov a formulára. Výsledky týchto zmien sa zobrazia automaticky v zdrojovom kóde v záložke Code. Naopak, keď modifikujete kód v Code Editore, zmeny, ktoré vykonáte sú okamžite odzrkadlené v záložke Design.

Paleta nástrojov poskytuje možnosti na zjednodušenie vytvárania formulárov. Keď vytvárate menu podobné Windowsu, môžete napr. použiť komponent MainMenu na vytvorenie prispôsobiteľného hlavného menu za minútu. Po vložení komponentu do formulára vyplňte položky a príkazy hlavného menu poskytnuté v boxe.

Formuláre

Formuláre sú základom všetkých aplikácií vyvinutých použitím Delphi for PHP. Užívateľské rozhranie pre Vašu aplikáciu navrhujete použitím formulárov. Formuláre môžu obsahovať menu, tlačítka, editovacie políčka, dialógové boxy alebo iné objekty, ktoré potrebujete na to, aby aplikácia pracovala tak, ako chcete Vy.

Vašu aplikáciu vyvíjate prispôsobením hlavného formulára (main form) a pridávaním prispôsobiteľných formulárov pre iné časti rozhrania. Formuláre prispôsobujete pridávaním komponentov a nastavovaním vlastností.

Tieto a mnoho iných vlastností môžete meniť použitím Object Inspectora.

Návrh užívateľského rozhrania pre HTML prehliadače

Navrhovanie užívateľského rozhrania PHP aplikácie, ktorá sa zobrazuje v HTML prehliadači, má viaceré obmedzenia, ktoré štandardné aplikačné rozhranie nemá. Napr. v HTML nemôžete prekrývať jeden prvok iným, pokiaľ chcete, aby sa Vaša aplikácia zobrazila správne vo všetkých prehliadačoch.

Keď rozvrhujete vaše užívateľské rozhranie a dva alebo viaceré komponenty sa prekrývajú, v ľavom hornom rohu každého komponentu sa zobrazí ikona žltého výkričníka. Ak sa to stane, pri spúšťaní skriptu sa nevypíšu žiadne chyby. Napriek tomu, vizuálne výsledky sú neočakávané a najpravdepodobnejšie sa jeden komponent nezobrazí. Preto najlepším pravidlom pri návrhu užívateľského rozhrania pre HTML prehliadače je, nespúšťať stránky, na ktorých je zobrazená ikona žltého výkričníka v Designeri. Prepracujte jednotlivé vrstvy tak, aby sa neprekrývali.

Vlastnosti Designera

Designer môžete konfigurovať nastavením vlastností, ktoré ovplyvňujú vzhľad a správanie Designera. Môžete napr. upraviť nastavenia mriežky alebo zobraziť titulky komponentu. Vlastnosti Designera sú v menu Page Designer, ktoré je umiestnené v Environmental Option v dialógovom menu Options.

Užívateľská príručka v anglickom jazyku.

Preklad príkladu Ajax - Database

Tento príklad ukazuje, ako použiť Ajax na prácu s databázou. Používa Ajax na poslanie tabuľky na server, ktorú chce užívateľ prehliadať a zmenu vlastností tabuľky za účelom otvorenia tej správnej.
Používa sa tu javascriptová udalosť OnChange ListBox-u na vykonanie volania Ajaxu:

params=document.AjaxDatabase.ListBox1.options[document.AjaxDatabase.ListBox1.value].text;

Nastaví paramentre do mena tauľky na ktorú užívateľ klikol a budú poslané na server. Potom:

echo $this->ListBox1->ajaxCall("changeTable",array(),array("ddaddress_book1"));

Tento dump Ajax javascriptového kódu vykoná volanie do metódy changeTable, ktorá tiež obdrží inštrukcie na update len DBGrid-u. Zvyšné riadiace prvky nebudú updatnuté. Je to výhodné pre zníženie trafiku na návrat Ajaxu.

UserGuide - kapitola 1.2

1.2 Prehliadka IDE Delphi for PHP

Keď otvoríte Delphi for PHP, IDE spustí a zobrazí viacero nástrojov a menu. IDE Vám pomáha vizuálne navrhnúť Vaše rozhranie, nastaviť vlastnosti objektov, písať kód, prezerať a manažovať Vašu aplikáciu rozličnými spôsobmi.
Prednastavený vzhľad IDE obsahuje niekoľko najobvyklejších používateľských nástrojov. Na zobrazenie alebo skrytie určitých nástrojov môžete použiť menu View. Vzhľad, ktorý je pre Vás najlepší si môžete prispôsobiť a uložiť.
Nástroje dostupné v IDE obsahujú:

• Start Page
• Forms
• Form Designer
• Tool Palette
• Object Inspector
• Project Manager
• Data Explorer
• Structure View
• Code Editor

Nasledovné časti popisujú každý z týchto nástrojov.

Start Page
Keď otvoríte Delphi for PHP, Start page sa zobrazí s odkazmi vyvíjaných zdrojov, napr. súvisiacimi článkami, školeniami a online pomocou. Pri vývoji projektu k nim môžete rýchlo pristupovať zo zoznamu posledných projektov na vrchnej časti stránky.

Forms
Je typické, že formulár reprezentuje okno alebo HTML stránku v užívateľskom rozhraní. V čase dizajnu je formulár zobrazený na vrchnej časti Designer-a. Na vytvorenie Vášho užívateľského rozhrania môžete použiť komponenty z Palety náradia (Tool Palette)

Form Designer
Form Designer alebo Designer je zobrazený automaticky, keď používate formuláre.

Visual Components
Vizuálne komponenty sa objavujú na formulári v čase návrhu a sú viditeľné pre koncového užívateľa v dobe behu aplikácie. Obsahujú také prvky ako napr. tlačítka, návestia, toolbary a listboxy.

Nonvisual Components a Component Tray
Nevizuálne komponenty sa zobrazujú vo formulári, ale sú viditeľné iba v čase návrhu. Nie sú viditeľné pre koncového užívateľa v dobe behu aplikácie. Nevizuálne komponenty môžete použiť ako spôsob opätovného použitia skupín databázy a systémových objektov alebo na izolovanie častí Vašej aplikácie, ktorá spravuje databázové spojenie a prevádzkové práva.
Keď pridáte nevizuálny komponent do formulára, zobrazí sa ako malá ikona. Túto ikonu môžete označiť a nastaviť vlastnosti komponentu.

Tool Palette
Paleta nástrojov obsahuje vizuálne a nevizuálne komponenty, ktoré sa používajú pri vývoji aplikácie. Do formulára ich pridávate dvojklikom. Ak prezeráte zdrojový kód v Code Editore, paleta nástrojov zobrazuje časti kódu, ktoré môžete pridať do Vašej aplikácie.

Customized Componenets
Ku komponentom, ktoré sú nainštalované s Delphi for PHP môžete pridávať prispôsobiteľné komponenty alebo komponenty tretej strany a ukladať ich do vlastných kategórií.

Object Inspector
Object Inspector dovoľuje nastaviť vlastnosti a vytvoriť ovládanie udalostí pre komponenty. Toto poskytuje spojenie medzi Vašim aplikačným vizuálnym vzhľadom a kódom. Object Inspector obsahuje tri tabuľky:
Properties, Events a JavaScript Events.
Tabuľka Properties sa používa na zmenu fyzických atribútov komponentov. V závislosti na výbere, niektorá kategória nastaví zadané hodnoty v textovom poli, zatiaľ čo iné požadujú výber hodnôt z roletového menu (drop-down box). Pre boolovské hodnoty môžete voliť True alebo False. Po zmene fyzických atribútov komponentu môžete vytvoriť ovládanie udalosti, ktorá riadi ako komponent funguje.
Tabuľka Events špecifikuje udalosti označeného objektu. Ak existuje ovládanie udalostí, použite na jeho výber roletové menu.
Tabuľka JavaScript Events špecifikuje udalosti JavaScriptu pre označený objekt. Ak existuje ovládanie udalostí, použite na jeho výber roletové menu.

Project Manager
Projektový manažér vytvára viacero aplikačných súborov. Projektový manažér Vám umožňuje prezeranie a organizovanie Vašich projektových súborov. Pomocou projektového manažéra môžete pridávať alebo mazať súbory. Tiež môžete kombinovať príbuzné projekty do projektových skupín.

Data Explorer
Data Explorer umožňuje prehliadať databázové tabuľky a polia. Použitím kontextového menu môžete vytvoriť a manažovať databázové pripojenia. Tiež môžete využiť metódu „drag and drop“ na rýchle budovanie databázy.

Code Editor
Code Editor poskytuje pohodlnú cestu ako prezerať a modifikovať Váš zdrojový kód. Je to prispôsobiteľný editor, ktorý poskytuje zvýrazňovanie syntaxe, spätné kroky (undo), atď.

Code Explorer
Pomocou Code Exploreru môžete vidieť funkcie, konštanty, premenné použité vo Vašom kóde.

Užívateľská príručka v anglickom jazyku.

UserGuide - kapitola 1 a 1.1

1 Úvod
Integrované vývojové prostredie (IDE) Delphi for PHP poskytuje mnoho nástrojov a možností ako Vám pomôcť pri rýchlom vytváraní výkonných aplikácií.

1.1 Čo je Delphi for PHP?

Delphi for PHP je integrované vývojové prostredie (IDE) pre vytváranie PHP aplikácií. IDE Delphi poskytuje súbor nástrojov, ktoré zefektívňujú a zjednodušujú životný cyklus vývoja aplikácie. Nesledujúce časti v krátkosti popisujú tieto nástroje.

Návrh užívateľského rozhrania
Vizuálny dizajnér Delphi for PHP Vám dovoľuje vytvoriť grafické užívateľské rozhranie pomocou drag and drop komponentov z palety nástrojov (Tool Palette). Použitím dizajnéra môžete vytvoriť formuláre.

Generovanie a editácia kódu
Delphi for PHP generuje viacero kódov Vašej aplikácie, len čo začnete vytvárať projekt. Textový Code Editor Vám pomôže pri kompletizácii zostávajúcej aplikačnej logiky. Code Editor poskytuje možnosti ako kompletizovať kód. Zvýraznenie syntaxe robí Váš kód jednoduchší na čítanie a na navigáciu.

Ladenie aplikácií
Integrovaný debugger Vám umožňuje nájsť a odstrániť logické chyby.

Užívateľská príručka v anglickom jazyku.

Preklad príkladu Ajax - Basic

Tento príklad ukazuje, ako najjednoduchším spôsobom použiť AJAX a to použitím metódy ajaxCall. Príklad robí dve veci:

• V udalosti Javascriptu generuje kód, ktorý vykoná ajaxCall
• V metóde PHP zmení viacero vlastností komponentov, ktoré budú updatnuté, keď je ukončené volanie Ajaxu

BUTTON1JSClick je udalosť Javascriptu, ktorá je volaná keď je kliknuté na tlačítko. V zdrojovom kóde nájdete nasledovný riadok:

echo $this->Button1->ajaxCall("Button1Click");

Tento kód dumpne javascriptový kód, ktorý je potrebný na vykonanie volania Ajaxu do PHP metódy na serveri nazvanej "Button1Click". Kód vo vnútri tejto metódy je PHP kód, ktorý mení titulok (Caption) pre viaceré riadiace prvky.
Spustením aplikácie a kliknutím na tlačítko budú updatnuté titulky a farba návestia bez odoslania formulára na server.

Čo je Delphi for PHP

Delphi for PHP je produkt spoločnosti CodeGear. Prináša revolúciu do vývoja webových aplikácií svojim integrovaným vizuálnym vývojovým prostredím pre rýchly vývoj aplikácií v jazyku PHP. Preverené a známe vlastnosti Delphi umožnia jeho užívateľom rýchly nárast produktivity programovania. Produkt obsahuje výkonný editor a ladiaci prostriedok pre PHP, obsahuje prepojiteľnosť s databázami MySQL a InterBase a integrovanú knižnicu komponentových tried VCL for PHP. Pomocou týchto nástrojov je možné rýchlo a vizuálne (metódou „drag and drop“) vytvárať webové aplikácie v PHP a začleňovať do nich komponenty zo sveta open source. Delphi for PHP je najrýchlejším nástrojom pre tvorbu výkonných a spoľahlivých webových aplikácií v PHP. Knižnica VCL for PHP je založená na najpopulárnejších skriptoch a knižniciach PHP, vrátane Qooxdoo, Adodb, DynAPI, Smarty, XAjax a JSCalendar. Architektúra knižnice komponentov bola inšpirovaná knižnicou VCL pre Delphi a je stopercentne napísaná v PHP. Delphi for PHP obsahuje paletu viacej než 50 opakovane použiteľných komponentov, ako napríklad tlačítka, návestia, zaškrtávacie políčka, obrázky, menu DHTML, objekty flash, mriežky, stromové štruktúry a ďalšie. K dispozícii sú aj databázové komponenty pre prácu s databázami, tabuľkami, dopytmi a uloženými procedúrami, rovnako tak ako aj dátovými mriežkami a navigáciou. Knižnicu je možné rozširovať o vlastné komponenty alebo o komponenty open source. Nové triedy komponentov sa vytvárajú ľahko, pretože každý komponent je vytvorený v čistom PHP.
Komponenty VCL for PHP majú zabudované vlastnosti, metódy a udalosti, takže vývoj webových rozhraní je za okamžik hotový.
Správca projektov umožňuje prehliadať a upravovať projektové súbory, štrukturálny panel ukazuje hierarchiu komponentov zobrazených vo vývojovom okne. Prehliadač kódu uľahčuje navigáciu, prehliadač dát umožní prechádzať databázové schémy a objekty na strane servera. Dômyselný editor a ladiaci prostriedok môžu premeniť frustrujúci proces hľadania chýb v kóde na proces rýchly a bezbolestný.
Editor Delphi for PHP má farebné zvýrazňovanie syntaxe, záložky pre ľahšiu navigáciu v rozsiahlych súboroch zdrojového kódu a nástroj Code Insight pre pomoc pri výbere vlastností a metód. Integrovaný ladiaci prostriedok pomáha nájsť a opraviť chyby, prehliadať body zastavenia, lokálne aj globálne premenné.

Článok je prevzatý z e-shopu spoločnosti CodeGear.

O čom by to malo byť

Pomocou tohoto blogu by som chcel uverejňovať preklady a príklady pre Delphi for PHP. Aj keď času nie je veľa, budem sa snažiť aspoň raz za týždeň pridať nejaký ten preklad užívateľskej príručky alebo príkladu.