Tento dokument si prosím přečtěte v celé jeho délce před tím, než budete pokračovat v instalaci, aktualizaci nebo převodu.

Tento dokument vás seznámí se základy instalace, aktualizace a převodu tohoto softwaru.

Základní informace týkající se provozu phpBB naleznete v přiloženém souboru README. Kromě dokumentu, který právě čtete, si prosím nezapomeňte prostudovat i tento druhý soubor. V případě zájmu o bližší informace související s používáním, instalací, aktualizací a převodem phpBB si přečtěte dokumentaci dostupnou online (v angličtině).

Instalace


1. Rychlá instalace

Pokud disponujete základními znalostmi v používání klienta FTP a jste si jisti, že na vašem hostingu nebo serveru phpBB3 poběží, můžete se prostřednictvím následujících kroků pustit rychle do práce. Máte-li zájem o podrobnější vysvětlení, měli byste tuto část přeskočit a přejít k části 2 níže.

  1. Dekomprimujte archiv s phpBB3 do místního adresáře na vašem počítači.
  2. Nahrajte všechny soubory obsažené v tomto archivu (při zachování adresářové struktury) do adresáře nacházejícího se na vašem serveru nebo přiřazeného k vašemu hostingovému účtu. Je zapotřebí, aby k tomuto adresáři bylo možné přistupovat z webu.
  3. Upravte oprávnění u souboru config.php tak, aby do něj mohl zapisovat kdokoliv (666 nebo -rw-rw-rw- ve vašem klientovi FTP).
  4. Upravte oprávnění u následujících adresářů tak, aby do nich mohl zapisovat kdokoliv (777 nebo -rwxrwxrwx ve vašem klientovi FTP):
    store/, cache/, files/ a images/avatars/upload/.
  5. Ve webovém prohlížeči zadejte cestu k umístění, do něhož jste nahráli soubory phpBB3, a připojte install/app.php nebo pouze install/, např. http://www.priklad.cz/phpBB3/install/app.php nebo http://www.priklad.cz/forum/install/.
  6. Klikněte na záložku INSTALACE, postupujte po jednotlivých krocích a vyplňte všechny požadované informace.
  7. Upravte oprávnění u souboru config.php tak, abyste do něj mohli zapisovat pouze vy (644 nebo -rw-r--r-- ve vašem klientovi FTP).
  8. phpBB3 by vám nyní mělo být k dispozici. NEZAPOMEŇTE si prosím přečíst alespoň část 7 kvůli důležitým poinstalačním instrukcím týkajícím se bezpečnosti a také nepřehlédněte část 8 pojednávající o opatřeních proti spamu.

Jestliže u kteréhokoliv z kroků výše narazíte na potíže nebo nebudete vědět, jak pokračovat, přečtěte si prosím zbytek tohoto dokumentu.


2. Požadavky

Před tím, než budete moct nainstalovat a používat phpBB 3.2.x, budete muset splnit několik požadavků.

  • Webový server nebo hostingový účet běžící na některém z hlavních operačních systémů s podporou PHP.
  • Databázový systém SQL, kterýkoliv z následujících:
    • MySQL 3.23 nebo vyšší (MySQLi je podporováno)
    • MariaDB 5.1 nebo vyšší
    • PostgreSQL 8.3+
    • SQLite 3.6.15+
    • MSSQL Server 2000 nebo vyšší (přes ODBC nebo nativní režim)
    • Oracle
  • PHP 5.4.7+ ale nižší než PHP 7.3 s podporou pro databázi, kterou hodláte používat.
  • Vyžadovány jsou následující PHP moduly:
    • json
  • Funkce getimagesize() musí být povolena.
  • Následující moduly PHP vám zajistí přístup k dalším prvkům, ale jejich přítomnost není vyžadována:
    • podpora komprese zlib
    • podpora vzdáleného FTP
    • podpora XML
    • podpora GD

Pokud váš server nebo hostingový účet výše uvedené požadavky nesplňuje, nebudete moct phpBB 3.2.x nainstalovat.


3. Nová instalace

Instalace phpBB se bude lišit v závislosti na vašem serveru a databázi. Disponuje-li váš účet přístupem k příkazovému řádku (například přes telnet nebo ssh), můžete nahrát celý archiv phpBB (v binárním režimu!) do adresáře u vašeho poskytovatele a rozbalit ho až tam.

Pokud přístup k příkazovému řádku nemáte nebo ho nechcete využít, budete muset dekomprimovat archiv phpBB do místního adresáře na vašem počítači pomocí vašeho oblíbeného komprimačního programu, např. WinZip, RAR, ZIP atd. Následně musíte pomocí klienta FTP přenést VŠECHNY obsažené soubory k poskytovateli vašeho hostingu (nezapomeňte zachovat adresářovou strukturu a názvy souborů). Také se prosím ujistěte, že nedojde ke změně velikosti písmen v názvech souborů. NEVYNUCUJTE změnu písmen v názvech souborů na všechna malá nebo velká písmena, protože to by později způsobilo chyby.

Všechny soubory .php, .sql, .cfg, .css, .js, .html, .htaccess a .txt byste měli nahrávat v režimu ASCII, zatímco veškerou grafiku byste měli nahrávat v BINÁRNÍM režimu. Pokud nejste obeznámeni s tím, co to znamená, nahlédněte prosím do dokumentace k vašemu klientovi FTP. Ve většině případů to klient FTP řeší transparentně, pokud však v pozdější fázi narazíte na potíže, měli byste si být jisti tím, že soubory byly nahrány korektně tak, jak je zde popsáno.

S phpBB je jako standardní jazyk dodávána britská angličtina. K dispozici jsou však i samostatné balíky pro další jazyky. Pokud nejste rodilými anglickými mluvčími, můžete si jeden nebo více těchto balíků nainstalovat před tím, než budete pokračovat. V průběhu instalace si následně budete moct z dostupných jazyků zvolit výchozí jazyk fóra (který lze později pochopitelně změnit). Více informací o jazykových balících, kde je získat a jak je nainstalovat, naleznete v souboru README.

Až všechny soubory nahrajete na určené místo, měli byste do prohlížeče zadat adresu tohoto umístění a za ni doplnit /install/. Například, pokud je název vaší domény www.priklad.cz a soubory phpBB jste nahráli do adresáře /phpBB3 nalézajícím se v kořenovém adresáři vašeho webu, zadali byste do adresního řádku prohlížeče http://www.priklad.cz/phpBB3/install/ nebo (alternativně) http://www.priklad.cz/phpBB3/install/app.php. Až tuto adresu potvrdíte, měla by se před vámi objevit úvodní obrazovka phpBB.

Úvod

Úvodní obrazovka vám ve stručnosti představí phpBB. Můžete si na ní prostudovat licenci, v souladu s níž je phpBB vydáno (Obecná veřejná licence v2), a poskytuje informace o tom, jak lze získat podporu. K zahájení instalace použijte záložku INSTALOVAT.

Požadavky

První stránku, kterou spatříte po zahájení instalace, představuje seznam požadavků. phpBB automaticky zkontroluje, zda je na vašem serveru nainstalováno vše, co je zapotřebí ke správnému fungování fóra. Aby instalace mohla pokračovat, musíte mít nainstalovanou alespoň nejnižší požadovanou verzi PHP a také musíte mít k dispozici minimálně jednu databázi. Důležité je rovněž to, aby existovaly všechny vypsané adresáře a měly správná oprávnění. Projděte si prosím popis všech následujících částí, abyste věděli, zda jsou volitelné, nebo zda je phpBB k provozu vyžaduje. Je-li vše v pořádku, můžete pokračovat kliknutím na Zahájit instalaci.

Nastavení databáze

Nyní musíte určit, kterou databázi budete používat. Přehled podporovaných databází naleznete v části Požadavky. Nemáte-li informace o nastavení vaší databáze, kontaktujte prosím poskytovatele vašeho hostingu a vyžádejte si je. Bez nich nebude možné pokračovat. Potřebujete znát:

  • Druh databáze – databáze, kterou budete používat.
  • Název hostitele databázového serveru nebo DSN – adresa databázového serveru.
  • Port databázového serveru – port sloužící pro připojení k databázi (ve většině případů není zapotřebí).
  • Název databáze – název databáze na serveru.
  • Uživatelské jméno a heslo databáze – přístupové údaje k databázi.

Poznámka: Pokud používáte SQLite, měli byste do pole DSN zadat úplnou cestu k vaší databázi a pole pro jméno a heslo nechat prázdná. Z bezpečnostních důvodů byste měli zajistit, že soubor databáze bude uložen na místě, které není přístupné z webu.

Předponu tabulek v nastavení databáze měnit nemusíte, leda byste měli v úmyslu používat jednu databázi pro více instalací phpBB. V takovém případě zajistíte funkčnost tím, že pro každou instalaci použijete odlišnou předponu.

Poté, co zadáte podrobnosti, můžete postoupit dál stiskem tlačítka Pokračovat na další krok. phpBB nyní ověří, zda vámi zadané údaje povedou k úspěšnému připojení k databázi a zda v ní už neexistují tabulky se stejnou předponou.

Chyba Nepodařilo se připojit k databázi znamená, že jste nezadali správné údaje k databázi a phpBB se k ní proto nemůže připojit. Přesvědčte se, že všechny zadané údaje jsou v pořádku, a zkuste to znovu. V případě, že si nastavením své databáze nejste jistí, obraťte se prosím na poskytovatele vašeho hostingu.

Pokud jste se zadanou databází dříve propojili jinou verzi phpBB se stejnou předponou tabulek, phpBB vás o tom bude informovat a vy budete muset pouze zvolit jinou předponu.

Pokud uvidíte hlášení Úspěšně připojeno, můžete pokračovat na další krok.

Nastavení administrátora

Nyní musíte vytvořit účet administrátora. Tento uživatel získá úplná administrátorská oprávnění a stane se prvním členem vašeho fóra. Na této stránce musíte vyplnit všechna pole. Rovněž zde můžete určit výchozí jazyk vašeho fóra. Ve výchozí instalaci phpBB je zahrnuta pouze britská angličtina. Další jazyky si můžete stáhnout z www.phpbb.com a přidat je před zahájením instalace nebo i kdykoliv později.

Konfigurační soubor

V tomto kroku se phpBB pokusí automaticky zapsat konfigurační soubor. Tento soubor je nezbytný k tomu, aby fórum mohlo fungovat. Obsahuje kompletní nastavení databáze a bez něj se phpBB nedokáže k databázi připojit.

Automatické zapsání konfiguračního souboru funguje obvykle bez problému. Jestliže však u souboru nejsou správně nastavena oprávnění, může tento proces selhat. V takovém případě musíte nahrát soubor ručně. phpBB vás vyzve ke stažení souboru config.php a řekne vám, co s ním máte dělat. Pokyny si prosím důkladně přečtěte. Poté, co soubor nahrajete, stiskněte tlačítko Hotovo a postupte k poslednímu kroku. Pokud se po stisku tlačítka Hotovo vrátíte na stejnou stránku a neobjeví se hlášení o úspěšném dokončení tohoto kroku, nenahráli jste soubor správně.

Pokročilá nastavení

Pokročilá nastavení umožňují upravit další parametry konfigurace vašeho fóra. Jsou nepovinná a můžete se k nim vrátit i kdykoliv později. I když si tedy nejste jistí tím, co tato nastavení znamenají, můžete přesto postoupit k poslednímu kroku a dokončit instalaci.

Byla-li instalace úspěšně dokončena, můžete nyní použít tlačítko Přihlásit se a vstoupit do administrace fóra. Blahopřejeme, úspěšně jste nainstalovali phpBB. Vaše práce tím ale ještě nekončí!

Pokud se vám nedaří nainstalovat phpBB ani poté, co jste pročetli tohoto průvodce, podívejte se prosím do části „Podpora“ na úvodní stránce instalátoru, kde se dozvíte, jak požádat o další pomoc.

Jestliže přecházíte z phpBB 2.0.x, měli byste nyní pokračovat na další informace z části o převodu níže. Pokud ne, měli byste ze svého serveru odstranit adresář install, protože dokud na něm bude přítomen, budete moct vstoupit pouze do administrace.


4. Aktualizace ze stabilních verzí phpBB 3.2.x

Pokud momentálně používáte stabilní verzi phpBB, zaktualizujete ji na novou verzi některým z předem daných způsobů. Měli byste si stáhnout jeden ze čtyř nabízených balíků, přičemž vaše volba určí další postup. Poznámka: Před aktualizací vám vřele doporučujeme provést úplnou zálohu databáze i všech existujících souborů phpBB! Nejste-li si jistí, jak to udělat, požádejte prosím o radu svého poskytovatele hostingu.

Nezapomeňte prosím zaktualizovat také zdrojové soubory phpBB, a to i v případě, že pouze spouštíte skript pro aktualizaci databáze. Máte-li na vašem serveru přístup k příkazovému řádku, můžete aktualizaci provést s jeho pomocí. V kořenovém adresáři vašeho fóra spusťte následující příkaz: php bin/phpbbcli.php --safe-mode db:migrate.

4.i. Kompletní balík

Aktualizaci s pomocí kompletního balíku doporučujeme u těch fór, u nichž nedošlo k úpravě hlavních souborů phpBB.

Nejprve byste si měli vytvořit kopii svého současného souboru config.php – uschovejte ji na bezpečném místě! Následně smažte všechny existující soubory phpBB – ponechte však soubory z adresářů files/, images/ a ext/. Jinak přijdete o přiložené soubory i nahrané obrázky a budou se vám zobrazovat chyby kvůli chybějícím souborům rozšíření. Zachovat můžete i alternativní vzhledy fóra. Až budete mít hotovo, můžete nahrát nové soubory phpBB (v případě potřeby nahlédněte do části Nová instalace). Poté nakopírujte zpět uložený soubor config.php a nahraďte jím ten nový. Další možností je jednoduše nahradit všechny existující soubory pomocí souborů z kompletního balíku – dejte si však pozor, abyste nepřepsali svůj současný soubor config.php.

Nyní byste měli zajít na stránku /install/app.php/update, na níž se zobrazí varování Nebyl nalezen platný aktualizační adresář. Ověřte prosím, že jste nahráli příslušné soubory. Pod tímto varováním uvidíte přepínač s předvybranou možností Zaktualizovat pouze databázi – stačí, když kliknete na tlačítko Odeslat. V závislosti na předchozí verzi vašeho fóra bude následně provedeno několik změn v databázi. Během toho může docházet k NEZDARŮM. To však není důvod k obavám, leda by se objevila skutečná CHYBA, v kterémžto případě se skript ukončí (v takové situaci byste měli požádat o pomoc na našem fóru nebo na něm nahlédnout do seznamu nahlášených chyb). Máte-li na vašem serveru přístup k příkazovému řádku, můžete aktualizaci provést s jeho pomocí. V kořenovém adresáři vašeho fóra spusťte následující příkaz: php bin/phpbbcli.php --safe-mode db:migrate.

Jakmile skript /install/app.php/update doběhne, zobrazí se hlášení Aktualizace databáze byla úspěšně dokončena. Následně můžete přejít do administrace fóra a poté podle pokynů odstranit adresář install.

4.ii. Změněné soubory

Tento balík je určen těm, kteří ve své verzi fóra chtějí pouze nahradit ty soubory, u nichž došlo při porovnání s nejnovější verzí ke změně.

Tento balík obsahuje několik archivů rozdělených podle jednotlivých verzí, z nichž v každém se nacházejí pouze ty soubory, u nichž došlo při porovnání s nejnovější verzí ke změně. Měli byste si proto vybrat archiv odpovídající vaší současné verzi, např. pokud momentálně máte verzi 3.2.0, měli byste z balíku phpBB-3.2.9-files.zip/tar.bz2 použít pouze odpovídající archiv.

Adresářová struktura zůstala zachována, což vám v případě zájmu umožňuje jednoduše nahrát dekomprimovaný obsah archivu do příslušného umístění na vašem serveru, tj. prostě přepsat existující soubory novými verzemi. Pamatujte, že pokud jste provedli nějaké úpravy, tyto nové soubory přepíšou současné upravené verze příslušných souborů a tím dané úpravy pravděpodobně zničí. Před nahráním jakýchkoliv takto dotčených souborů proto musíte dané úpravy opět provést i v jejich nejnovějších verzích.

Stejně jako u ostatních metod aktualizace byste i v tomto případě měli po zaktualizování souborů zajít na stránku /install/app.php/update, zvolit možnost „Zaktualizovat pouze databázi“ a stránku odeslat. Tím zaktualizujete schéma databáze i číslo verze phpBB. Máte-li na vašem serveru přístup k příkazovému řádku, můžete aktualizaci provést s jeho pomocí. V kořenovém adresáři vašeho fóra spusťte následující příkaz: php bin/phpbbcli.php --safe-mode db:migrate.

4.iii. Záplata

Balík záplat je určen těm, kteří chtějí provést aktualizaci prostřednictvím aplikace patch, a měli by ho používat pouze ti, kteří jsou s tímto postupem obeznámeni.

Záplata představuje ideální řešení pro ty, kteří provedli úpravy v hlavních souborech phpBB a nechtějí je provádět ručně znovu ve všech změněných souborech. Chcete-li využít tuto metodu, budete potřebovat přístup ke standardní aplikaci patch unixového typu prostřednictvím příkazového řádku. Pokud k takové aplikaci přístup nemáte, ale i tak chcete využít tuto metodu aktualizace, důrazně vám doporučujeme použít balík pro automatickou aktualizaci vysvětlený níže. Ten je zároveň doporučenou metodou aktualizace.

K dispozici je několik záplat umožňujících vám aktualizovat fórum z jakékoliv předchozí stabilní verze. Nejprve vyberte správnou záplatu, např. používáte-li momentálně verzi 3.2.0, měli byste zvolit soubor phpBB-3.2.0_to_3.2.9.patch. Zvolenou záplatu umístěte do adresáře obsahujícího hlavní soubory phpBB (tj. index.php, viewforum.php atd.). Poté byste měli spustit následující příkaz: patch -cl -d [ADRESÁŘ PHPBB] -p1 < [ZÁPLATA] (kde ADRESÁŘ PHPBB je název adresáře, v němž se nachází vaše instalace phpBB, například „phpBB“, a kde ZÁPLATA je název příslušné záplaty). Tento příkaz by měl proběhnout rychle, ideálně bez hlášení o chybách v rozdílových úsecích.

Pokud se však s chybami setkáte, měli byste zvážit použití balíku se změněnými soubory, abyste sami nahradili ty soubory, u kterých se nepodařilo aplikovat záplatu. Nezapomeňte však prosím, že u těchto souborů budete muset znovu ručně zanést všechny provedené úpravy. Nebo, pokud víte jak, můžete prozkoumat soubory .rej a zjistit, co kde selhalo, a následně ručně sáhnout do příslušného zdrojového souboru.

Záplatu (případně záplaty) byste měli po použití pochopitelně smazat. Stejně jako u ostatních metod aktualizace byste i v tomto případě měli po zaktualizování souborů zajít na stránku /install/app.php/update, zvolit možnost „Zaktualizovat pouze databázi“ a stránku odeslat. Tím zaktualizujete schéma databáze (a případně i uložená data), jakož i číslo verze phpBB. Máte-li na vašem serveru přístup k příkazovému řádku, můžete aktualizaci provést s jeho pomocí. V kořenovém adresáři vašeho fóra spusťte následující příkaz: php bin/phpbbcli.php --safe-mode db:migrate.

4.iv. Balík pro automatickou aktualizaci

Tuto metodu aktualizace doporučujeme pouze u těch instalací, u nichž došlo k úpravě hlavních souborů phpBB. Tento balík automaticky nalezne upravené soubory a následně v nich provede potřebné změny.

Balík pro automatickou aktualizaci povýší fórum ze současné verze na nejnovější verzi. K dispozici je několik souborů pro automatickou aktualizaci a měli byste zvolit ten, který odpovídá verzi fóra, kterou právě používáte. Například, máte-li aktuálně verzi 3.2.0, potřebujete soubor phpBB-3.2.0_to_3.2.9.zip/tar.bz2.

Chcete-li použít tuto metodu aktualizace, postupujte buď podle instrukcí na záložce Systém v administraci fóra – kde byste měli najít jak upozornění na to, že používáte jeho zastaralou verzi, tak i průvodce aktualizací – nebo podle instrukcí uvedených níže.

  • Přejděte na stránku Download phpBB a stáhněte si nejnovější balík pro automatickou aktualizaci, s přihlédnutím k současné verzi vašeho fóra.
  • Obsah dekomprimovaného archivu nahrajte do vaší instalace phpBB – vyžadovány jsou pouze adresáře install/ a vendor/. Nahrajte veškerý obsah těchto adresářů a zachovejte při tom jejich strukturu.
  • Jakmile bude v instalaci phpBB přítomen adresář install, fórum se automaticky vypne.
  • V prohlížeči zadejte cestu k adresáři install, například http://www.priklad.cz/phpBB3/install/.
  • Přejděte na záložku „Aktualizovat“ a postupujte podle instrukcí.

4.v. Další druhy balíků

Máte-li nainstalován některý z neanglických jazykových balíků, mohlo by vás čas od času zajímat, jestli se neobjevila jeho nová verze. Možná v ní bude přidáno několik dříve chybějících řetězců, které – třebaže nejsou nezbytné – mohou přijít vašim uživatelům vhod. Mějte prosím na paměti, že ne vždy jsou všechny jazykové balíky zcela aktuální, a tak byste je měli pravidelně kontrolovat.

Výše uvedenými metodami aktualizace zaktualizujete pouze standardní vzhled prosilver, obvykle však bývá nutné zaktualizovat i všechny ostatní vzhledy nainstalované na vašem fóru.


5. Aktualizace z phpBB 3.0.x/3.1.x na phpBB 3.2.x

Aktualizace z phpBB 3.0.x nebo 3.1.x na 3.2.x probíhá stejně jako aktualizace ze stabilních verzí phpBB 3.2.x.

Můžete však také začít se zbrusu novou sadou souborů z phpBB 3.2.x.

  1. Smažte všechny soubory S VÝJIMKOU následujících:
    • soubor config.php;
    • adresář images/;
    • adresář files/;
    • adresář store/;
    • adresář ext/.
  2. Nahrajte obsah kompletního balíku 3.2.x do adresáře vašeho fóra. Přesvědčte se, že jste nahráli i soubor .htaccess nacházející se v kořenovém adresáři fóra.
  3. Zajděte na stránku /install/app.php/update.
  4. Přečtěte si upozornění na to, že bude provedena pouze aktualizace databáze, a stiskněte Odeslat.
  5. Smažte adresář install/.

6. Převod z phpBB 2.0.x na phpBB 3.2.x

V této části naleznete kroky nezbytné k převodu vaší současné instalace fóra phpBB2 na fórum phpBB3.

6.i. Požadavky před převodem

Před převodem vám vřele doporučujeme provést úplnou zálohu databáze i všech souborů! Nejste-li si jisti, jak to udělat, požádejte prosím o radu svého poskytovatele hostingu. V podstatě vám stačí postupovat podle instrukcí pro novou instalaci. Nepřepisujte prosím žádné staré soubory – nainstalujte phpBB3 na jiné místo.

Poté, co vše zazálohujete a nainstalujete zbrusu novou verzi phpBB3, můžete zahájit samotný převod.

Mějte na paměti, že při převodu je nutné, aby účet spravující databázi phpBB3 disponoval oprávněními CREATE a DROP.

6.ii. Převod

Abyste mohli zahájit převod, navštivte adresář install/ vaší instalace phpBB3 (stejně, jako když jste phpBB3 instalovali). Nyní zde uvidíte novou záložku Převést. Klikněte na ni.

Stejně jako v případě instalace i převod je plně zautomatizován. Vaše staré databázové tabulky z verze 2.0.x se nezmění a to samé platí i pro původní soubory z verze 2.0.x. Při převodu ve skutečnosti dochází pouze k naplnění databázových tabulek phpBB3 a překopírování dalších dat do vaší nové instalace phpBB3. Výhodou tohoto přístupu je, že pokud se něco pokazí, můžete buď zahájit převod znovu od začátku, nebo v něm pokračovat, zatímco vaše staré fórum zůstane stále plně funkční. Vřele vám nicméně doporučujeme, abyste po dobu převodu své staré fórum vypnuli a tím zaručili, že vaše data budou plně aktuální i po skončení převodu.

Mějte prosím na paměti, že převod může trvat i delší dobu a v závislosti na nastavení vašeho hostingu kvůli tomu může celý proces selhat (v důsledku omezení nastavených na webovém serveru nebo vypršení různých časových limitů). V takovém případě byste se měli obrátit na poskytovatele vašeho hostingu a požádat ho, zda by skript řídící převod mohl dočasně překročit nastavená omezení (buďte milí a váš poskytovatel vám nejspíš rád vyhoví). Pokud váš poskytovatel není ochoten upravit omezení mající vliv na průběh převodu, nahlédněte prosím do následujícího článku pojednávajícího o tom, jak provést převod přímo na vašem počítači: Knowledge Base – Offline Conversions (v angličtině).

Jakmile převod skončí, fórum by vám mělo být okamžitě k dispozici. Došlo-li během převodu k nějakým chybám, měli byste nám je nahlásit nebo vyhledat pomoc na našem fóru (podrobnosti naleznete v souboru README).

6.iii. Nezbytné úkony po převodu

Po úspěšném převodu budete možná muset provést několik dalších úkonů – kromě toho, že ověříte, jestli je vaše fórum dostupné a jestli se vše zobrazuje správně.

První věcí, kterou byste měli udělat, je vstoupit do administrace fóra a zkontrolovat všechna nastavení na záložce „Obecné“. Poté bude možná nutné upravit název a popis fóra, a to v případě, že jste zde dříve používali HTML. Kromě toho můžete navštívit i další části administrace, jako je nastavení oprávnění, smajlíků, ikon témat, hodností atd.

Během převodu se nevytváří ani nepřenáší index pro vyhledávání. To znamená, že budete-li po převodu něco hledat, nepodaří se vám najít žádnou shodu. Doporučujeme proto, abyste index pro vyhledávání co nejdřív opět vytvořili, a to na stránce Administrace fóra -> Údržba -> Databáze -> Indexy pro vyhledávání.

Poté, co v administraci fóra ověříte jeho nastavení, můžete smazat adresář install a fórum zpřístupnit. Dokud tak neučiníte, zůstane fórum z pohledu běžného uživatele vypnuté.

Až budete se svou novou instalací spokojeni, můžete jí dát stejný název, jaký měla ta předchozí, a to tak, že přejmenujete adresář, ve kterém se nachází. V phpBB3 to lze udělat bez jakýchkoliv potíží, i tak byste ale měli zkontrolovat nastavení cookies v administraci fóra – pro případ, že před přejmenováním adresáře bude nutné upravit cestu ke cookie.

6.iv. Běžné potíže při převodu

Špatně zobrazené znaky nepatřící mezi standardní latinku Skript provádějící převod předpokládá, že kódování databáze zdrojového fóra phpBB2 odpovídá kódování definovanému v souboru lang_main.php z výchozího jazykového balíku vaší instalace phpBB2. Upravte tento soubor tak, aby obsahoval správné kódování databáze, a znovu zahajte převod.

HTTP 500 / bílé stránky Převod představuje pro server velkou zátěž a omezení nastavená některými poskytovali hostingu mohou způsobovat potíže. K jejich nejběžnějším příčinám patří příliš nízké hodnoty memory_limit a max_execution_time v nastavení PHP. Další častou příčinou těchto potíží jsou omezení týkající se množství času vyhrazeného z běhu procesoru a počtu povolených dotazů na databázi. Pokud tato nastavení nemůžete změnit, obraťte se na poskytovatele vašeho hostingu nebo převod proveďte na jiném počítači. Výtečným místem, kde požádat o pomoc, jsou také fóra phpBB.com.

Převod hesel Vzhledem k tomu, že hesla v phpBB3 jsou kódována pomocí UTF-8, může se stát, že se některá hesla nepřevedou. V případě, že se nějaké heslo „ztratí v překladu“, je nejsnazším řešením použít odkaz Zapomenuté heslo na přihlašovací stránce.

Cesta k vašemu starému fóru Konvertor očekává relativní cestu k souborům vašeho starého fóra. Takže například, pokud se staré fórum nachází na adrese http://www.vasedomena.cz/forum a phpBB3 se nachází na adrese http://www.vasedomena.cz/phpBB3, správná hodnota by byla ../forum. Mějte na paměti, že uživatel serveru musí být schopen přistupovat ke zdrojovým souborům fóra.

Chybějící obrázky Pokud výchozí jazykový balík vašeho fóra neobsahuje všechny nezbytné obrázky, mohou poté na vašem fóru některé obrázky chybět. Pro výchozí jazyk proto vždy používejte kompletní jazykový balík.

Smajlíci Během převodu se mohou zobrazit varování týkající se obrázků, které se nepodařilo zkopírovat. To se může stát, pokud se soubory smajlíků ze starého fóra jmenují stejně jako soubory z nového fóra. Chcete-li i nadále používat staré smajlíky, překopírujte příslušné soubory ručně po skončení převodu.


7. Důležité (s bezpečností související) poinstalační úkony pro všechny instalační metody

Poté, co úspěšně nainstalujete phpBB, NESMÍTE zapomenout smazat celý adresář install/. Necháte-li instalační adresář na místě, riskujete potenciálně velmi vážné narušení bezpečnosti, které by mohlo vést například až ke smazání nebo úpravě vašich souborů. Mějte prosím na paměti, že dokud tento adresář neodstraníte, phpBB nebude fungovat a místo toho se vám bude zobrazovat varování. Kromě tohoto adresáře můžete také případně smazat i adresář docs/.

Jakmile tyto adresáře smažete, měli byste přejít do administrace. V závislosti na výsledku instalace tam také můžete být přesměrováni automaticky. Pokud ne, přihlaste se jako administrátor, kterého jste vytvořili během instalace/převodu, a klikněte na odkaz Administrace fóra v zápatí jakékoliv stránky fóra. Přesvědčte se, že nastavení přístupná ze záložky Obecné jsou v pořádku!

7.i. Nahrávání avatarů

phpBB podporuje několik metod umožňujících uživatelům zvolit si vlastní avatar (avatar je malý obrázek, obvykle jiný pro každého uživatele, který se u příspěvků zobrazuje u uživatelského jména).

Dvě z těchto metod umožňují uživatelům nahrát avatar na fórum z jejich počítače nebo vzdáleného místa (skrze URL adresu). Chcete-li tyto metody povolit, měli byste se nejprve ujistit, že v nastavení Administrace fóra -> Obecné -> Konfigurace fóra -> Nastavení avatarů je uvedena správná cesta k ukládání avatarů. Ta standardně zní images/avatars/uploads, můžete ji ale upravit, jakkoliv chcete. Nezapomeňte se však přesvědčit, že se příslušné nastavení zaktualizovalo. Také musíte zajistit, že do daného adresáře bude moct webový server zapisovat. To obvykle znamená, že u tohoto adresáře musíte změnit oprávnění tak, aby do něj mohl kdokoliv zapisovat i z něj číst. Jak přesně byste to měli provést, závisí na vašem klientovi FTP, případně operačním systému vašeho serveru.

Například v UNIXových systémech nastavíte oprávnění adresáře na a+rwx (nebo ugo+rwx nebo i 777). To můžete provést z příkazového řádku na vašem serveru příkazem chmod nebo prostřednictvím vašeho klienta FTP. (V okně „Změnit oprávnění“, „chmod“ nebo v jiném dialogovém okně souvisejícím s nastavením oprávnění. Bližší informace naleznete v dokumentaci k vašemu klientovi FTP.) Většina klientů FTP zobrazuje přehled oprávnění rozdělený na oprávnění vlastníka (čtení, zápis, spouštění), oprávnění skupiny (čtení, zápis, spouštění) a oprávnění ostatních (čtení, zápis, spouštění). Chcete-li nastavit správná oprávnění, musíte zaškrtnout všechny uvedené položky.

V systémech Windows se musíte ujistit, že adresář není chráněn proti zápisu a že je u něj povolen globální zápis (pokud si nejste jistí tím, jak toho dosáhnout, nahlédněte do dokumentace k vašemu serveru nebo se obraťte na poskytovatele vašeho hostingu).

Mějte prosím na paměti, že povolit v oprávněních adresáře globální zápis představuje potenciální bezpečnostní riziko. A třebaže je nepravděpodobné, že by se stalo něco nepěkného (jako například, že by vám někdo smazal všechny avatary), faktem je, že existují lidé, kteří rádi škodí ostatním. Proto byste tuto složku měli sledovat a, bude-li to možné, pravidelně ji zálohovat.

7.ii. Konfigurace webového serveru

V závislosti na vašem webovém serveru ho možná budete muset nakonfigurovat tak, abyste zakázali přístup z webu k adresářům cache/, files/, includes/, phpbb/, store/, a vendor/. Tím zabráníte uživatelům v přístupu k citlivým souborům.

V případě serverů Apache jsou již přítomny soubory .htaccess, které to za vás zařídí u nejcitlivějších souborů a adresářů. Doporučujeme vám však, abyste v nastavení svého serveru Apache kompletně zakázali veškerý přístup k výše uvedeným adresářům a jejich příslušným podadresářům.
U serverů Apache 2.4 byste k adresáři phpbb v instalaci phpBB nacházející se v adresáři /var/www/html/ zakázali přístup přidáním následujících pravidel do konfiguračního souboru Apache (běžně apache.conf):

<Directory /var/www/html/phpbb/*>
	Require all denied
</Directory>
<Directory /var/www/html/phpbb>
	Require all denied
</Directory>

Stejná nastavení můžete použít i pro ostatní uvedené adresáře, stačí, když phpbb nahradíte názvem příslušného adresáře. Mějte prosím na paměti, že verze Apache 2.2 a 2.4 používají každá jinou syntaxi.

Obdobně na serverech využívajících Windows s IIS jsou na všech místech přítomny soubory web.config. U ostatních webových serverů budete muset upravit konfiguraci sami. Ukázkové soubory pro nginxlighttpd, které vám pomohou začít, naleznete v adresáři docs/.


8. Opatření proti spamu

Stejně jako jakákoliv jiná webová stránka umožňující uživatelům vkládat obsah se i vaše fórum může stát terčem nevyžádaných příspěvků, často označovaných za komentářový spam. Velká většina těchto útoků bude pocházet od automatizovaných počítačových programů známých jako spamboti. Tyto útoky nejsou, obecně vzato, osobní, jelikož spammeři se jenom snaží hledat zranitelné cíle. V phpBB je zabudováno několik opatření proti spamu, včetně různých testů CAPTCHA. Administrátorům nicméně vřele doporučujeme, aby si co nejdříve po nainstalování fóra přečetli rady, jak se bránit proti spamu v phpBB (v angličtině), a řídili se jimi.


9. Autorská práva a zřeknutí se odpovědnosti

phpBB je svobodný software vydaný v souladu s podmínkami Obecné veřejné licence GNU verze 2 (GPL-2.0). Copyright © phpBB Limited. Úplné informace o autorských právech a licenci naleznete v souboru docs/CREDITS.txt.