Apache HTTP server (verze Apache/2.4.10)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Aktivní moduly - access_compat, alias, auth_basic, authn_core, 
    authn_file, authz_core, authz_host, authz_user, autoindex, cgid, 
    deflate, dir, env, filter, mime, mpm_prefork, negotiation, php5, 
    rewrite, setenvif, status

Uživatelské nastavení serveru apache je umístěno v adresáři 
/etc/apache2/conf-enabled/httpd.conf, s následujícím obsahem:    

ServerName localhost
RewriteEngine On
AddHandler application/x-httpd-php .php5 .php4 .php .php3 .php2 .phtml
AddType application/x-httpd-php .php5 .php4 .php .php3 .php2 .phtml

ServerAdmin fuca@localhost
DocumentRoot /home/fuca/Projects/www
<Directory />
    Options FollowSymLinks
    AllowOverride None
</Directory>
<Directory /home/fuca/Projects/www>
    Options Indexes FollowSymLinks MultiViews
    AllowOverride None All
    Order allow,deny
    allow from all
    Require all granted
</Directory>

Systémové nastavení pak /etc/apache2/apache2.conf, do toho však není doporu-
čené zasahovat a je zde zmíněno jen pro úplnost.

Pzn.: Po změně nastavení serveru je důležité server apache vždy restartovat. 
  Toho lze nejsnáze dosáhnout provedním konzolového příkazu 
  "sudo service apache2 restart".

    
PHP5 modul Apache serveru
~~~~~~~~~~~~~~~~~~~~~~~~~
Minimálními požadavky na konfiguraci tohoto modulu jsou zmíněny v samotném 
textu práce v sekci 5.3.1, je tedy zbytečné je uvádět duplicitně.

Aktivní moduly - curl, gd, imap, json, mcrypt, memcache, mysqli, mysql, 
    mysqlnd, opcache, pdo, pdo_mysql, pdo_sqlite, readline, sqlite3, 
    xdebug, xmlrpc

Pro nastavení modulu xdebug bylo třeba v adresáři \etc\php5\conf.d vyt-
vořit inicializační soubor s nastavením xdebug.ini. Jehož obsah je také
uveden v kapitole 5.3.1 textu práce.
Direktiva zend_extension=/usr/lib/php5/20121212/xdebug.so určuje umístění
daného rozšíření, je nutné, aby zde byla platná cesta odpovídající stavu 
systému, na kterém je aplikace nasazována.
Další direktiva, která přijde vhod v případě profilování aplikace pomocí
modulu xdebug je xdebug.profiler_enable_trigger=true.

Instalaci lze provést sérií příkazů (Zdroj: www.linode.com/docs/websites/
apache/apache-2-web-server-on-ubuntu-12-04-lts-precise-pangolin):
    - sudo apt-get install apache2 apache2-doc apache2-utils
    - apt-get install libapache2-mod-php5 php5 php-pear php5-xcache
    - sudo apt-get install php5-mysql - Instalace mysql podpory do php5.

K nastavení samotného php modulu slouží tzv. soubor php.ini, který je umís-
těn v adresáři /etc/php5/apache2/conf.d.


MySQL databázový server (verze 5.5.38)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Nastavení mysql serveru nebylo pro tvorbu této práce nijak měněno. Server 
tedy využívá defaultního nastavení verze dodávané s distribucí 
Ubuntu 12.04.01 LTS.

Úpravy konfigurace je však možné provádět v adresáři /etc/mysql/my.cnf.

Je však nutné mít vytvořejný databázový účet, pod kterým bude aplikace na 
server přistupovat. Tyto informace se pak musí zapsat do konfigurace aplika-
ce popsané dále v tomto textu.

Dodatečnou instalaci serveru lze provést provedením sérií příkazů:
    - sudo apt-get install mysql-server - Nainstaluje server.
    - mysqladmin create <sportsclub> - Vytvoří databázi sportsclub.


Google Chrome webový prohlížeč
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Jelikož předmětem práce je webová aplikace, samozřejmostí je také přítomnost 
webového prohlížeče. Vývoj byl prováděn na prohlížeči Google Chrome verze 
37.0.2062.120 (64-bit).

Inicializace databáze
~~~~~~~~~~~~~~~~~~~~~
Předpokladem je existence prázdné databáze. Pro uvedení projektu do provozu
je nutné inicializovat databázové schéma. To lze provést dvěma způsoby:
a) Importem schématu ze souboru app/bin/dump_sql.sql, tím dosáhneme 
    vytvoření prázné struktury databáze
b) Provedením konzolového příkazu:
    - php www/index.php \orm:schema:up --force - Tím dojde k validaci da-
    tabázového schématu a následnému aplikování do databáze.

   Pozor! Před provedením tohoto příkazu však musí být vypnuty iniciali-
   zátory stavu aplikace. Toho dosáhneme nastavením parametru "turnOffInit"
   v \app\modules\SystemModule\config\applicationConfig.neon na
   true. Tím se zamezí volání inicializačních procedur při vytváření 
   DI kontejneru aplikace. Po inicializaci schématu, je potřeba tento pa-
   rametr opět nastavit na false, aby při prvním spuštění proběhlo uvede-
   ní aplikace do použitelného stavu.

Inicializace adresářové struktury
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Aplikace při svém běhu pracuje s adresářovou strukturou, kde spouští, tvoří 
a mění různé soubory a adresáře. Z tohoto důvodu je nutné nastavit příslučná
práva. 
a) Soubor www/index.php musí být spustitelný (executable).

b) Adresáře temp/ a www/assets/ vývojář potřebuje nanejvýš pro čtení, je 
tedy vhodné dát aplikaci plnou kontrolu, například vlastnictvím.
To zařídí příkaz: sudo chown -R www-data:www-data temp/ www/assets/

c) Do adresáře log/ musí aplikace moci zapisovat. Uživateli se však hodí
vytvářené logy i měnit, na to je třeba při nastavování práv myslet.

d) Všechny ostatní skripty (i knihoven ve vendor/) musí být samozřejmě 
spustitelné, to se týká i adresáře www.	

Nedostatečné nastavení  přístupových práv je velmi  častou příčinou problémů 
při prvotním nasazení aplikace.

Užitečné příkazy
~~~~~~~~~~~~~~~~
Při instalaci závislostí Composerem občas dojde k vygenerování neuplného
autoloaderu. Opětovné vytvoření lze vynutit příkazem composer dump-autoload.

V textu byl zmíněn příkaz pro aplikaci schématu do databáze. V některých 
případech příjde vhod pouhé ověření validity schématu a správného mapovaní
objektů. K tomuto slouží příkaz: php www/index.php \orm:validate.

Podobně užitečné může být vygenerování SQL skriptu pro import schématu 
ručně. Příkaz "php www/index.php \orm:schema:up --dump-sql > dump_sql.sql"
vygeneruje schéma a výstup přesměruje do souboru dump_sql.sql.

Při vývoji aplikace je dost často nutné vymazání cache paměti. K usnadnění 
vymazání cache v adresáři temp slouží shell skript clean_cache.sh. Příkaz
sh ./clean_cache.sh vymaže cache soubory, ale neovlivní session přihlášeného 
uživatele.

Provedením změn ve struktuře DB schématu dojde k vytvořením rozdílů mezi 
schématem definovaným v aplikaci a tím nahraným v databázi. Ke "setření" 
těchto rozdílů slouží skript rebuild_db_schema.sh, který porovná tyto dvě 
schémata a aplikuje případné změny.

Pro spuštení automatizovaných testů v adresáři tests slouží skript tt.sh.

Po přidání funkcionality se jistě hodí i aktualizace API dokumentace, ta se 
provádí spuštením skriptu capi.sh.

    MVP a presentery
    http://doc.nette.org/cs/2.2/presenters

--------------------------------------------------------------------------------



6) KONFIGURACE APLIKACE
================================================================================

Tato sekce slouží k bližšímu seznámení s konfigurací aplikace.

Jak bylo zmíněno konfigurace aplikace je zapsána v konfiguračním souboru:
app/SystemModule/config/applicationConfig.neon, tento soubor slouží ke konfigu-
raci prostředí systému a připojovaným rozšířením. Pro přehlednost je komentáři
rozdělen do 5ti částí:
    - FRAMEWORK SETTINGS
    - 3RD PARTY EXTENSIONS SETTINGS
    - APP EXTENSIONS SETTINGS
    - COMMON SERVICES SETTINGS
    - EXTENSIONS REGISTRATION

Konfigurační direktivy se zapouzdřují do sekcí, které ovlivňují, a pod kterými 
jsou dostupny uvnitř aplikace.

Jelikož konfigurační soubor je opatřen komentáři, zmíníme se zde jen o hrubé 
struktuře některých částí.

Části "3RD PARTY EXTENSIONS SETTINGS" a "APP EXTENSIONS SETTINGS" se obě zabýva-
jí konfigurací rozšíření, jsou odděleny jen ze sémantického hlediska původu roz-
šíření. Registrací (aktivací) rozšíření v části "EXTENSIONS REGISTRATION", vzni-
kne se zadefinuje sekce s jeho názvem před dvojtečkou. Pod tímto názvem je dos-
tupná konfigurační sekce daného rozšíření. Pro lepší pochopení postačí nahlédnu-
tí do konfiguračního souboru.

Velmi důležitým pojmem při tvorbě aplikací v Nette frameworku je registrace slu-
žeb. K tomu slouží sekce "services" v hlavním konfiguračním souboru alikace. V 
konkrétním případě část "COMMON SERVICES SETTINGS". Stejným principem se provádí
registrace služeb v rámci jednotlivých modulů, v jejich konfiguračních souborech,
které se jmenují config.negon a jsou umístěny ve stejnojmenném adresáři ve struk-
tuře modulu.

Konfigurační část "APP EXTENSIONS SETTINGS" je věnovaná nastavení modulů vytvá-
řených v rámci aplikace. Zvláštní pozornost si zde zaslouží inicializační části
označené "init" klíčem. Jejich hodnoty jsou pak datové položky entit, které mají
být přidány při provedení incializačních procedur při zpracování konfigurace. 
Inicializátory modulů kontrolují, zda jsou v aplikaci přítomny inicializační en-
tity, když tomu tak není, zařídí jejich přidání. Existence inicializačních entit
je nutná z důvodu existence administrátorského účtu, který mý právo používat 
všechny zdroje aplikace. Bez existence tohoto systémového uživatele by nebylo 
možné aplikaci začít používat.

Mimo hlavního konfiguračního souboru je přítomen i konfigurační soubor s nastave-
ním specifickým pro prostředí, ve kterém aplikace běží. Základním příkladem je
například nastavení databázového připojení. Tento konfigurační soubor se jmenuje 
applicationConfig.local.neon. Odděleny jsou z důvodu verzování zdrojových kódů.
Tento "lokální" soubor se jednoduše nechá ignorovat verzovacím nástrojem a zbylá 
konfigurace systému pak může být bez problémů zveřejněna.

Užitečné odkazy

Konfigurace Frameworku
http://doc.nette.org/cs/2.2/configuring