Jeśli masz podstawową wiedzę na temat FTP (ang. File Transfer Protocol) i znasz dane serwera hostingowego lub własnego serwera, na którym ma być uruchomiona witryna phpBB3, wykonaj poniższe działania, by przeprowadzić szybką instalację. Bardziej szczegółowy opis instalacji znajduje się w sekcji 2.

1. Rozpakuj archiwum phpBB3 do katalogu na dysku lokalnym.
2. Wgraj wszystkie pliki z tego archiwum, zachowując strukturę katalogów na swój serwer lub konto hostingowe.
3. Jeśli zachodzi potrzeba, za pomocą klienta FTP zmień uprawnienia pliku config.php na 666 lub -rw-rw-rw-.
4. Jeśli zachodzi potrzeba, za pomocą klienta FTP zmień uprawnienia poniższych katalogów na 777 lub -rwxrwxrwx:
   store/, cache/, files/ i images/avatars/upload/.
5. Za pomocą swojej przeglądarki internetowej przejdź do miejsca wgrania skryptu phpBB3, dodając na końcu adresu install/index.php, lub wpisując bezpośrednio w pasku adresu, np. http://www.twoja_domena.pl/phpBB3/install/index.php, http://www.twoja_domena.pl/forum/install/.
6. Kliknij kartę Instalacja i postępuj zgodnie ze wskazówkami, podając wszystkie wymagane informacje.
7. Jeśli zachodzi potrzeba, za pomocą klienta FTP zmień uprawnienia pliku config.php na 644 lub -rw-r--r--.
8. Teraz witryna phpBB3 powinna być dostępna. Przeczytaj przynajmniej sekcję 6, by zapoznać się z ważnymi, odpowiedzialnymi za bezpieczeństwo, instrukcjami dotyczącymi czynności, jakie należy wykonać po zainstalowaniu phpBB3, a także informacje w sekcji 7 dotyczące zabezpieczeń antyspamowych.

Jeśli wystąpią problemy lub nie wiesz, jak wykonać powyższe czynności, zapoznaj się z pozostałą częścią artykułu.

Aby zainstalować i używać phpBB 3.1.x, muszą być spełnione pewne wymagania.

• Serwer sieciowy lub konto na serwerze hostingowym muszą działać na jednym z głównych systemów operacyjnych obsługujących PHP.
• Serwer musi udostępniać jedną z następujących baz danych SQL:
  • MySQL 3.23 lub nowsze (MySQLi obsługiwana)
  • MariaDB 5.1 lub nowsze
  • PostgreSQL 8.3+
  • SQLite 2.8.2+
  • SQLite 3.6.15+
  • MS SQL Server 2000 lub nowsze (bezpośrednio lub przez ODBC, lub natywny adapter)
  • Oracle
• Serwer musi obsługiwać PHP 5.3.3+ z obsługą wybranej bazy danych.
• Następujące moduy PHP są wymagane:
• json
• Musi być włączona funkcja getimagesize().
• Obecność poniższych modułów PHP zapewnia dostęp do dodatkowych funkcji, ale nie są one wymagane:
  • zlib – obsługa kompresji
  • FTP – obsługa zdalnego FTP
  • XML – obsługa XML
  • Imagemagick – obsługa obrazków
  • GD – obsługa grafiki

Jeśli serwer lub konto hostingowe nie spełnia wymagań określonych powyżej, nie możesz zainstalować phpBB phpBB 3.1.x.

Instalacja phpBB będzie się różnić w zależności od twojego serwera i bazy danych. Jeśli masz dostęp przez terminal do swojego konta, np. przez Telnet lub SSH, możesz wgrać w trybie binarnym archiwum phpBB do katalogu na swoim koncie hostingowym i tam je rozpakować.

Jeśli nie masz dostępu do konta przez terminal lub nie chcesz go użyć, musisz za pomocą jednego z programów do kompresji danych, np. Winzip, RAR, ZIP itp. rozpakować archiwum phpBB na dysku lokalnym. Następnie, używając klienta FTP prześlij, zachowując strukturę katalogów i nazwy plików, wszystkie pliki na serwer. Po tej operacji sprawdź, czy pliki na serwerze mają taką samą strukturę i nazwy, jak w rozpakowanym katalogu. Nie wymuszaj zmiany nazw plików na duże lub małe znaki, ponieważ będzie to powodowało błędy w dalszej części instalacji.

Wszystkie pliki .php, .sql, .cfg, .css, .js, .html, .htaccess i .txt powinny być przesłane na serwer w trybie ASCII, a pliki graficzne w trybie BINARNYM. Jeśli nie wiesz, co to oznacza, zapoznaj się z dokumentacją swojego klienta FTP. W większości przypadków przesłanie na serwer jest bezproblemowo wykonywane przez klientów FTP, ale jeśli w późniejszym czasie wystąpią jakieś problemy, należy sprawdzić czy pliki zostały przesłane zgodnie z opisanymi tutaj zaleceniami.

Standardowo, phpBB jest dostarczane w języku angielskim brytyjskim. Inne języki są dostępne jako oddzielne pakiety. Jeśli język angielski nie jest twoim ojczystym językiem, możesz przed przejściem do dalszych czynności instalacyjnych zainstalować inne języki. Wówczas w dalszym procesie instalacyjnym, z dostępnych języków, można wybrać domyślny język. Języki można dowolnie zmieniać w późniejszym czasie. Więcej informacji na temat pakietów językowych – jak je pobrać i zainstalować – znajduje się w artykule README.

Po przesłaniu wszystkich plików na serwer, należy za pomocą przeglądarki przejść do katalogu /install/ znajdującym się w katalogu głównym skryptu. Na przykład, jeśli nazwa twojej domeny to www.moja_domena.pl i phpBB znajduje się w katalogu /phpBB3, należy podać adres http://www.moja_domena.pl/phpBB3/install/ lub alternatywnie http://www.moja_domena.pl/phpBB3/install/index.php. Po wykonaniu tej operacji zostanie wyświetlone okno instalacji.

Wprowadzenie:

W oknie instalacji wyświetlane jest krótkie wprowadzenie do phpBB. Można tutaj przeczytać o licencji, na jakiej phpBB zostało wydane (General Public License wer.2), a także zapoznać się informacjami dotyczącymi uzyskania pomocy. Aby rozpocząć instalację, należy w panelu instalacji wybrać kartę: Instalacja. Zostanie wyświetlone wprowadzenie do instalatora phpBB3. Zapoznaj się z zawartymi tam danymi i jeśli są spełnione opisane tam elementy przejdż do instalacji, naciskając przycisk Przejdź do następnego etapu

Wymagania

Na pierwszej wyświetlanej po uruchomieniu procesu instalacyjnego stronie, znajduje się lista wymagań. phpBB automatycznie sprawdza, czy na twoim serwerze są zainstalowane wszystkie wymagane do prawidłowej instalacji elementy. Aby kontynuować instalację, na serwerze musi być zainstalowane PHP w minimalnej wymaganej wersji i przynajmniej jedna baza danych. Bardzo ważne jest, aby wszystkie wyświetlane foldery były dostępne i miały prawidłowe uprawnienia. Aby dowiedzieć się czy wymagania są opcjonalne, czy wymagane do uruchomienia phpBB3, zobacz opisy w poszczególnych sekcjach. Jeśli wszystko jest w porządku, możesz kontynuować instalację, naciskając przycisk: Rozpocznij instalację.

Ustawienia bazy danych

Teraz należy zdecydować, której bazy danych użyć. Przejdź do sekcji Wymagania, by zobaczyć, które bazy danych są obsługiwane. Jeśli nie znasz ustawień swojej bazy danych, skontaktuj się z administracją swojego hosta i zapytaj o poniższe dane:

• Typ bazy danych – baza danych, która będzie używana.
• Nazwa serwera lub DSN (Data Source Name) bazy danych – adres serwera bazy danych (zazwyczaj localhost).
• Port serwera bazy danych – port serwera bazy danych (w większości przypadków nie jest potrzebny).
• Nazwa bazy danych – nazwa bazy danych na serwerze.
• Nazwa użytkownika i hasło bazy – dane potrzebne do zalogowania się do bazy danych.

Nie ma potrzeby w ustawieniach bazy danych zmiany prefiksu tabel, chyba że planujesz używanie wielu instalacji phpBB używających jednej bazy danych. W takim przypadku należy użyć różnych prefiksów dla każdej instalacji phpBB.

Po podaniu danych można kontynuować instalację, naciskając przycisk: Przejdź do następnego etapu. Teraz phpBB sprawdzi czy za pomocą podanych danych można przeprowadzić połączenie z bazą danych i czy istnieją tabele z podanym prefiksem.

Błąd Nie można połączyć się z bazą danych oznacza, że zostały podane nieprawidłowe dane dotyczące bazy danych i phpBB nie może połączyć się z bazą danych. Sprawdź, czy podane dane są prawidłowe, ewentualnie je skoryguj i ponów próbę. Jeśli błąd będzie występował nadal, skontaktuj się z administratorem swojego serwera.

Jeśli, wykorzystując tę bazę danych, z tym samym prefiksem była wcześniej instalowana inna wersja phpBB, zostanie wyświetlona stosowna informacja i należy wówczas wprowadzić inny prefiks dla tabel w bazie danych.

Jeśli zostanie wyświetlona informacja Połączono, przejdź do następnego etapu.

Dane administratora

Teraz należy utworzyć konto administratora. Ten użytkownik będzie miał dostęp do wszystkich czynności administracyjnych i będzie pierwszym użytkownikiem witryny. Wszystkie pola na tej stronie są wymagane. Można tutaj także określić domyślny język witryny. W standardowej instalacji phpBB jest tylko język angielski brytyjski. Można z witryny www.phpbb.com pobrać pakiety innych języków i przed instalacją lub w późniejszym czasie dodać je do katalogu language/. Jeśli pliki językowe zostaną dodane przed instalacją – w menu rozwijanym pola „Domyślny język witryny:” bedą widoczne dostępne języki.

Plik konfiguracyjny

Na tym etapie phpBB będzie próbowało zapisać plik konfiguracyjny automatycznie. Aby działać poprawnie, witryna musi być skonfigurowana. Plik ten zawiera wszystkie ustawienia bazy danych, a bez tych informacji phpBB nie będzie mogło uzyskać do niej dostępu.

Zazwyczaj automatyczny zapis ustawień działa bez problemów, ale czasami może, na przykład źle zapisać uprawnienia dostępu do plików. W takim przypadku należy plik ten przesłać na serwer ręcznie. phpBB poprosi, aby pobrać plik config.php i przekaże, co z nim zrobić. Przeczytaj instrukcje bardzo uważnie. Po przesłaniu pliku na serwer naciśnij przycisk: Wykonano, aby przejść do ostatniego etapu. Jeśli po naciśnięciu przycisku: Wykonano zostanie ponownie wyświetlona ta sama strona, oznacza to, że plik konfiguracyjny został przesłany nieprawidłowo.

Ustawienia zaawansowane

Ustawienia zaawansowane umożliwiają określenie dodatkowych parametrów konfiguracyjnych witryny. Są one opcjonalne i można je w każdej chwili zmienić. Jeśli nie znasz tych parametrów i nie wiesz, jak je ustawić – przejdź do następnego etapu.

Jeśli instalacja przebiegła prawidłowo, można się zalogować, używając przycisku: Zaloguj się, by przejść do panelu administracji. Gratulacje! phpBB3 zostało zainstalowane, ale przed tobą jest jeszcze trochę pracy do wykonania.

Jeśli nawet po zapoznaniu się z tym artykułem nie możesz zainstalować phpBB, przejdź do sekcji pomocy na stronie powitalnej instalatora, by dowiedzieć się, gdzie możesz uzyskać dalszą pomoc.

Jeśli w tym momencie dokonujesz konwersji z phpBB 2.0.x, informacje na ten temat uzyskasz w sekcji dotyczącej konwersji, jeśli nie, usuń ze swojego serwera katalog instalacyjny. Jeśli będzie on pozostawał w katalogu głównym phpBB, będzie możliwy dostęp tylko do panelu administracyjnego.

Jeśli obecnie używasz stabilnego wydania phpBB, aktualizacja do najnowszej wersji jest bardzo łatwa. Należy pobrać jeden z czterech pakietów, a dokonany wybór pakietu określa dalsze postępowanie. Uwaga! Przed aktualizacją zaleca się wykonanie pełnej kopii zapasowej bazy danych i istniejących plików phpBB. Jeśli nie masz pewności, jak to zrobić, skonsultuj się z dostawcą usług hostingowych w celu uzyskania porady.

Sprawdź, czy została wykonana aktualizacja plików źródłowych, nawet jeśli został uruchomiony plik database_update.php.

4.1. Pełen pakiet

Pełen pakiet jest zazwyczaj przeznaczony dla nowych instalacji, ale jeśli chcesz zastąpić wszystkie pliki źródłowe plikami zawartymi w tym pakiecie, jest on przydatny.

Najpierw należy wykonać kopię zapasową istniejącego pliku config.php i zapisać w bezpiecznym miejscu, a następnie usunąć wszystkie istniejące pliki phpBB. Możesz pozostawić istniejące katalogi files/ i images/, a także style. Po wykonaniu tych czynności możesz przesłać na serwer nowe pliki phpBB. Więcej szczegółowych informacji znajduje się w sekcji Nowa instalacja. Po zakończeniu tych czynności skopiuj z powrotem zapisany wcześniej plik config.php, zastępując nim nowy plik. Inny sposób, to po prostu zastąpienie istniejących plików nowymi plikami z pakietu. Dopilnuj, by nie zastąpić istniejącego pliku config.php.

Teraz należy uruchomić skrypt install/database_update.php, który w zależności od twojej poprzedniej wersji wykona zmiany w bazie danych. Podczas wykonywania tej procedury możesz otrzymywać informacje Niepowodzenie. Nie powinny być one powodem do niepokoju, chyba że pojawi się informacja BŁĄD. W tym przypadku skrypt zostanie zatrzymany i należy szukać pomocy na naszych forach lub w systemie śledzenia błędów.

Po zakończeniu działania skryptu install/database_update.php, należy przejść do panelu administracyjnego i sprawdzić poprawność oraz zgodnie z zaleceniami usunąć katalog instalacyjny/.

4.2. Zmienione pliki

Pakiet jest przeznaczony dla tych osób, które chcą zamienić tylko zmienione pliki pomiędzy poprzednią, a ostatnią wersją.

Ten pakiet zawiera wiele archiwów. Każde z nich zawiera pliki, które uległy zmianie od danego wydania do ostatniej wersji. Należy wybrać odpowiednie archiwum dla zainstalowanej wersji. Na przykład, jeśli jest zainstalowana wersja 3.1.0, należy wybrać plik phpBB-3.1.1-files.zip/tar.bz2.

Struktura katalogu została zachowana, umożliwiając wgranie nieskompresowanej zawartości archiwum do odpowiedniej lokalizacji na serwerze, np. po prostu zastąpić istniejące na serwerze pliki ich nowymi wersjami. Należy pamiętać, że jeśli są zainstalowane jakieś mody, te pliki zastąpią istniejące pliki, co może uniemożliwić działanie tych modyfikacji. Trzeba będzie ponownie dodać modyfikacje do tych plików.

Po zakończeniu aktualizacji plików, należy uruchomić skrypt install/database_update.php. Skrypt dokona aktualizacji bazy danych i zmieni numer wersji.

4.3. Łatka

Plik łatki jest dla osób obeznanych z aplikacjami aktualizującymi oprogramowanie za pomocą tego typu plików.

Plik łatki jest dobrym rozwiązaniem dla aktualizacji witryn z dużą liczbą modyfikacji lub innych zmian plików bez ponownego dodawania modyfikacji do zmienionych plików. Aby użyć tego pliku, trzeba mieć dostęp do wiersza poleceń aplikacji realizującej aktualizacje za pomocą łatek. Jeśli nie ma się dostępu do wiersza poleceń, a chce się użyć tego typu aktualizacji, należy skorzystać z pakietu automatycznej aktualizacji opisanego poniżej. Jest to zalecana metoda aktualizacji.

Jest dostępnych wiele plików łatek umożliwiających aktualizację z poprzednich stabilnych wersji. Wybierz właściwą łatkę, np. jeśli twoją aktualną wersją jest wersja 3.1.0, potrzebujesz plik phpBB-3.1.1-patch.zip/tar.bz2. Umieść odpowiednią łatkę w katalogu zawierającym główne pliki phpBB, takie jak index.php, viewforum.php, itp. Po wykonaniu tych czynności uruchom polecenie: patch -cl -d [katalog_phpBB] -p1 < [nazwa_pliku_łatki], gdzie katalog_phpBB, to nazwa katalogu instalacji phpBB, np. phpBB3, a nazwa_pliku_łatki, to nazwa wybranego pliku łatki. Aktualizacja powinna zakończyć się szybko, mamy nadzieję, bez niepowodzeń.

Jeśli wystąpiły jakieś problemy, należy użyć pakietu Tylko zmienione pliki, by zamienić pliki, które spowodowały awarię łatki. W tym przypadku trzeba będzie do odpowiednich plików ręcznie ponownie wprowadzić zmiany dotyczące modyfikacji. Alternatywnie, jeśli znasz sposób sprawdzania plików .rej, można je sprawdzić, by dowiedzieć się, co i gdzie się nie powiodło i dokonać ręcznych zmian w odpowiednich plikach źródłowych.

Po użyciu, należy usunąć plik łatki i tak jak w innych procedurach aktualizacyjnych uruchomić skrypt install/database_update.php. Skrypt dokona aktualizacji bazy danych i zmieni numer wersji.

4.4. Pakiet automatycznej aktualizacji

Jest to zalecana metoda aktualizacji. Ten pakiet automatyczne wykrywa zmienione plików i dodaje, jeśli potrzeba, zmiany.

Pakiet automatycznej aktualizacji zaktualizuje obecnie zainstalowaną wersję do najnowszej wersji. Jest dostępnych wiele plików automatycznej aktualizacji i należy wybrać plik odpowiedni dla zainstalowanej wersji. Na przykład, jeśli jest zainstalowana wersja 3.1.0 potrzebny będzie plik phpBB-3.1.0_to_3.1.1.zip/tar.bz2.

Aby wykonać automatyczną aktualizację, należy postępować zgodnie z instrukcjami po przejściu do karty Panel administracji » System – zostanie wyświetlona informacja o zainstalowanej wersji i instrukcja, jak dokonać aktualizacji do najnowszej wersji – lub postępować zgodnie z instrukcjami podanymi poniżej.

• Przejdź na stronę pobierania i pobierz najnowszy pakiet aktualizacyjny odpowiedni dla twojej zainstalowanej wersji.
• Rozpakuj pobrany plik na dysku lokalnym i prześlij do swojej instalacji phpBB zawartość folderów install/ i vendor/, zachowując ich strukturę.
• Po wgraniu tego folderu, witryna phpBB przejdzie automatycznie w tryb offline.
• Wpisz w przeglądarce adres do katalogu instalacyjnego, np. http://www.moja_domena.pl/phpBB3/install/.
• Wybierz kartę „Aktualizacja” i postępuj zgodnie z instrukcjami.

4.5. Pakiety językowe

Jeśli są zainstalowane różne pakiety językowe, należy sprawdzić, czy są dostępne ich nowe wersje. Może być tak, że nie wszystkie pakiety językowe zostały zaktualizowane, więc należy okresowo sprawdzać dostępność aktualizacji.

Te metody aktualizacji zaktualizują tylko standardowe style, prosilver i subsilver2. Inne zainstalowane style zazwyczaj także wymagają aktualizacji.

Aktualizacja z phpBB 3.0.x do 3.1.x przebiega tak samo, jak aktualizacja stabilnej wersji phpBB 3.1.x

Można także dokonać aktualizacji z nowym zestawem plików phpBB 3.1.x.

1. Usuń wszystkie pliki z wyjątkiem:
   • pliku config.php,
   • katalogu images/,
   • katalogu files/,
   • katalogu store/.
2. Do katalogu swojego forum na serwerze wgraj zawartość pakietu 3.1.x. Upewnij się, że w katalogu głównym znajduje się plik .htaccess.
3. Uruchom skrypt install/database_update.php
4. Usuń katalog install/

W tej sekcji opisano czynności, jakie należy wykonać, aby przeprowadzić konwersję istniejącej instalacji phpBB2 do phpBB3.

6.1. Wymagania przed konwersją

Przed konwersją zaleca się wykonanie pełnej kopii zapasowej bazy danych i istniejących plików! Jeśli nie masz pewności, jak to zrobić, skonsultuj się z dostawcą usług hostingowych w celu uzyskania porady. Zainstaluj phpBB zgodnie z instrukcją podaną w sekcji Nowa instalacja. Nie zastępuj starych plików – zainstaluj phpBB w innym miejscu.

Po wykonaniu kopii zapasowej i zainstalowaniu phpBB3, można rozpocząć konwersję.

Wykonanie konwersji wymaga, aby użytkownik bazy danych phpBB3 miał uprawnienia CREATE i DROP.

6.2. Konwersja

Aby rozpocząć konwersję, za pomocą swojej przeglądarki internetowej przejdź do miejsca wgrania skryptu phpBB3, dodając na końcu adresu install/index.php, lub wpisując bezpośrednio w pasku adresu, np. http://www.twoja_domena.pl/phpBB3/install/, http://www.twoja_domena.pl/forum/install/ itp. Po otwarciu panelu instalacji kliknij kartę Konwersja i postępuj zgodnie z wyświetlanymi wskazówkami.

Konwersja tak samo, jak instalacja jest zautomatyzowana. Tabele bazy danych, jak i pliki wersji 2.0.x nie zostaną zmienione. W trakcie konwersji tabele bazy danych phpBB3 zostaną wypełnione danymi ze starej bazy i do samej instalacji phpBB3 zostaną skopiowane dodatkowe dane. Ma to swoje dodatnie strony, ponieważ jeśli konwersja nie przebiegnie prawidłowo, będzie możliwość powrotu do konwersji i jej kontynuowanie, a stara witryna będzie nadal działała. Zalecamy wyłączenie starej witryny na czas konwersji, ponieważ może wystąpić niespójność danych, jeśli w czasie konwersji będą dokonywane jakieś zmiany na starej witrynie.

Proces konwersji może zająć trochę czasu i w zależności od ustawień serwera może się nie powieść z powodu przekroczenia limitu czasu połączenia. Jeśli taka sytuacja nastąpi, skontaktuj się z dostawcą usług hostingowych i poproś o tymczasowe umożliwienie przekroczenia ustawionego limitu czasu. Jeśli twój dostawca usug hostingowych nie chce zwiększyć limitu, zapoznaj się z artykułem, jak dokonać konwersji na komputerze lokalnym: Knowledge Base - Offline Conversions.

Po zakończeniu konwersji, witryna będzie natychmiast dostępna. Jeśli w trakcie konwersji wystąpią błędy, należy zgłosić problemy w naszym systemie śledzenia błędów lub poszukać pomocy na naszych forach. Więcej szczegółów na ten temat znajduje się w artykule Informacje podstawowe.

6.3. Czynności po konwersji

Po prawidłowym przebiegu i zakończeniu konwersji, oprócz sprawdzenia czy instalacja jest dostępna i wszystko wyświetla się poprawnie, należy wykonać kilka rzeczy.

Pierwszą rzeczą, którą trzeba zrobić, to w panelu administracji z poziomu karty „Ogólne” sprawdzić każdy element konfiguracji. Można zmienić nazwę czy opis witryny. Można także przejść do innych sekcji, by np. dostosować uprawnienia, emotikony, ikony rangi itp.

Podczas konwersji nie jest tworzony ani przenoszony indeks wyszukiwania. Oznacza to, że po konwersji wyszukiwanie nie będzie działało. Zaleca się przebudowanie indeksu wyszukiwania. W tym celu należy przejść do panelu administracji i w karcie Konserwacja wybrać Indeksowanie wyszukiwania.

Po weryfikacji ustawień, można usunąć z folderu instalacyjnego katalog install/, by włączyć witrynę. Do czasu usunięcia tego katalogu witryna będzie niedostępna dla użytkowników.

Gdy konwersja przebiegła prawidłowo, ustawienia są poprawne i witryna działa bezproblemowo, można zmienić nazwę tej instalacji na nazwę starej instalacji, zmieniając nazwę katalogu. W phpBB3 jest to możliwe i przebiega bezproblemowo, ale trzeba przed zmianą nazwy sprawdzić ustawienia ciasteczek i ewentualnie skorygować ścieżkę do nich.

6.4. Problemy związane z konwersją

Zdeformowane nie łacińskie znaki – skrypt konwersji zakłada, że kodowanie bazy danych w phpBB2 odpowiada kodowaniu zdefiniowanemu w pliku lang_main.php domyślnego pakietu językowego w instalacji źródłowej. Należy dokonać edycji tego pliku, dopasować kodowanie zgodne z kodowaniem bazy danych i ponownie uruchomić konwersję.

http 500 / białe puste strony – konwersja jest bardzo trudną i obciążającą serwer procedurą. Ograniczenia narzucone przez niektórych dostawców usług hostingowych mogą powodować problemy. Najczęstsze przyczyny to zbyt mała wartość ustawień php memory_limit i max_execution_time. Częstą przyczyną takich błędów są limity czasu CPU oraz ograniczenia liczby zapytań do bazy danych. Jeśli nie można zmienić tych ustawień, należy skontaktować się z dostawcą usługi hostingowej lub uruchomić konwersję na innym komputerze. Dobrym miejscem do poszukania pomocy są także fora phpBB.com.

Konwersja hasła – w trakcie konwersji nie zawsze jest możliwe przeniesienie wszystkich haseł ze względu na stosowanie w phpBB3 kodowania utf-8. Najprostszym sposobem rozwiązania problemu zagubionych podczas konwersji haseł jest użycie funkcji Nie pamiętam hasła.

Ścieżka do starej witryny – konwerter oczekuje relatywnej ścieżki do plików starej witryny. Na przykład, jeśli stara witryna jest umiejscowiona w http://www.twoja_domena.com/forum, a instalacja phpBB3 w http://www.twoja_domena.com/phpBB3, prawidłowa wartość powinna być ../forum. Uwaga! Użytkownik serwera sieciowego musi mieć dostęp do plików instalacyjnych na serwerze.

Zagubione obrazki – jeśli pakiet językowy domyślnego języka witryny nie zawiera wszystkich obrazków, w instalacji będzie brakowało obrazków nieistniejących w pakiecie. Należy zawsze jako domyślnego języka używać kompletnego pakietu językowego.

Emotikony – w trakcie konwersji mogą być wyświetlane ostrzeżenia o niepowodzeniu kopiowania plików obrazków. Może tak się zdarzyć, jeśli pliki emotikon na starej witrynie mają takie same nazwy, jak na nowej. Jeśli chce się używać starych emotikon na nowej witrynie, należy po zakończeniu konwersji skopiować je ręcznie.

Po zainstalowaniu phpBB, z katalogu głównego trzeba usunąć cały katalog install/. Pozostawienie tego katalogu spowoduje, że witryna phpBB3 nie będzie działała i będzie wyświetlany stosowny komunikat. Ponadto może to stanowić potencjalne zagrożenie bezpieczeństwa, które może doprowadzić do, np. usunięcia, zmiany plików itp. przez niepowołane osoby. Do czasu usunięcia tego katalogu, phpBB nie będzie działało i będzie wyświetlany stosowne ostrzeżenie. Bez szkody dla działania witryny, można też usunąć katalog docs/.

Po usunięciu tych katalogów, należy przejść do panelu administracyjnego. W zależności od sposobu zakończenia instalacji, może nastąpić automatyczne przekierowanie do panelu administracyjnego. Jeśli tak się nie stanie, należy zalogować się jako administrator określony podczas instalacji/konwersji, klikając znajdujący się na dole strony odnośnik Panel administracji. Po zalogowaniu, w karcie Ogólne należy sprawdzić poprawność danych!

7.1. Wgrywanie awatarów

phpBB obsługuje różne metody umożliwiające użytkownikom wybór ich własnego awatara. Awatar, to zazwyczaj mały, unikalny dla danego użytkownika obrazek wyświetlany w postach – w zależności od użytego stylu – powyżej lub poniżej nazwy użytkownika.

Dwie z tych metod umożliwiają użytkownikom wgranie awatara ze swojego komputera lub ze zdalnego położenia (poprzez podanie adresu URL). Jeśli chcesz włączyć tę funkcję, należy najpierw sprawdzić, czy na karcie Panel administracji » Ogólne » Konfiguracja witryny » Awatary jest podana prawidłowa ścieżka do katalogu zapisu wgrywanych awatarów. Domyślnie jest to images/avatars/uploads, ale można określić dowolne inne położenie katalogu awatarów. Należy upewnić się, że ustawienia konfiguracyjne zostały zaktualizowane, a także czy ten katalog jest udostępniony do zapisu i odczytu przez wszystkich. Jak należy to zrobić, zależy od klienta FTP lub systemu operacyjnego serwera.

W systemach uniksowych, można ustawić dla tego katalogu: a+rwx lub ugo+rwx, a nawet 777. Można to zrobić z poziomu wiersza poleceń, używając chmod lub za pomocą klienta FTP, używając funkcji zmiany uprawnień, chmod lub innego okna dialogowego. Dokładne informacje zazwyczaj znajdują się w dokumentacji klienta FTP. W większości klientów FTP lista uprawnień ma formę Użytkownik (odczyt, zapis, wykonywalny), Grupa (odczyt, zapis, wykonywalny) i Inne (odczyt, zapis, wykonywalny). Aby ustawić uprawnienia poprawnie, należy zaznaczyć wszystkie pola.

W systemach rodziny Windows, należy sprawdzić, czy katalog ten nie jest zabezpieczony przed zapisem i czy ma globalne uprawnienia do zapisu. Jeśli nie wiesz, jak to zrobić, zobacz dokumentację swojego serwera lub skontaktuj się z dostarczycielem usługi hostingowej.

Należy zachować ostrożność, ponieważ ustawienie globalnych uprawnień dostępu do zapisu katalogu, może stanowić potencjalne zagrożenie bezpieczeństwa. Choć jest mało prawdopodobne, że nastąpi coś złego, jak usunięcie wszystkich awatarów, to są jednak osoby, które lubią sprawiać takie problemy. Dlatego należy monitorować ten katalog i jeśli to możliwe regularne tworzyć kopie zapasowe.

7.2. Konfiguracja serwera sieciowego

W zależności od serwera sieciowego, można go tak skonfigurować, aby blokował dostęp do katalogów cache/, files/, store/ i innych katalogów. Uniemożliwi to użytkownikom dostęp do poufnych plików.

W serwerach Apache do blokowania służą pliki .htaccess. W serwerach działających na systemie Windows używających IIS do blokowania służą pliku web.config. Dla innych serwerót trzeba blokowanie ustawić samemu. Przykładowe pliki nginx i lighttpd znajdują się w katalogu docs/.

Jak każda witryna internetowa umożliwiająca interakcję z użytkownikami twoja witryna zbudowana na skrypcie phpBB jest narażona na ataki w postaci niechcianych wiadomości zwanych także spamem forumowym. Ogromna większość tych ataków pochodzi od automatycznych programów komputerowych znanych jako spamboty. Ataki generalnie nie są skierowane do poszczególnych użytkowników forów, ponieważ spamerzy próbują dotrzeć do szerszego grona odbiorców. phpBB ma wiele wbudowanych zabezpieczeń antyspamowych włącznie z CAPTCHA. Niemniej administratorzy usilnie zalecają – najszybciej, jak to tylko możliwe po zainstalowaniu witryny – przeczytanie i postępowanie zgodnie ze wskazówkami dotyczącymi zapobiegania spamowi w phpBB.

phpBB jest oprogramowaniem darmowym, wydanym na licencji GNU General Public License, wer. 2 (GPL-2.0). Prawa autorskie posiada Copyright © phpBB Limited. Więcej informacji dotyczących praw autorskich i licencji znajdziesz w katalogu /docs w pliku CREDITS.txt.