DEV - STRONA GŁÓWNADokumentacjaZarządzanie systememInstalacja systemu

Instalacja TYPO3

Historycznie TYPO3 posiadał instalator jako jeden z pierwszych CMSów, ale przez wiele lat nie dokonywano w nim żadnych istotnych zmian, ponieważ całkiem dobrze spełniał swoje zadania. Brak ulepszeń spowodował być może, że dzisiaj instalator wygląda już trochę archaicznie w porównaniu z konkurencją, ale najbliższa wersja TYPO3 o numerze 4.2, która wyjdzie w okolicach lutego 2008 roku ma być już wyposażona w zupełnie nowy skrypt instalacyjny.

Wymagania

Podstawowe

  • System operacyjny: Unix (np. Linux), Windows lub Mac
  • Serwer WWW: Apache, IIS
  • Język PHP4 lub PHP5 (Uwaga! Od TYPO3 4.2.0 potrzebne jest PHP w wersji 5.1.x)
  • Baza danych: preferowany MySQL, ale można uruchamiać na innych systemach bazodanowych obsługiwanych przez TYPO3 DBAL (np. Oracle, Postgres i inne)
  • php_memory_limit ustawiony na minimum 16 MB (wskazane > 32MB)


Opcjonalne (ale mocno zalecane)

  • GraphicsMagick (standalone) albo ImageMagick - operacje na obrazkach, np. skalowanie, kadrowanie itp.
  • GDlib/Freetype (wkompilowane w PHP) - tworzenie obrazków z napisami, np. dynamicznie tworzone menu obrazkowe,
  • Apache with mod_gzip/mod_rewrite - mody apacha do kompresji i tworzenia przyjaznych url,
  • PHP-cache (np. eaccelerator / Zend Accelerator) - z akceleratorami TYPO3 potrafi generować stronę do 3x szybciej
  • włączone allow_url_fopen lub curl - bez nich nie będzie możliwe pobranie tłumaczeń panelu administratora i rozszerzeń (można wczytać ręcznie)

Umieszczenie źródeł i pakietu dummy na serwerze

Pobierz źródła TYPO3 i umieść je na serwerze. Jeżeli masz dostęp do konta tylko przez ftp to przesyłanie rozpakowanych źródeł TYPO3 może być czasochłonne (20MB małych plików). Możesz skorzystać z menadżerów plików php. np: extplorer, przesłać spakowane źródła i rozpakować je na serwerze.

Pobierz też pakiet Dummy. Jest to pakiet zawierający domyślną strukturę katalogów, plików konfiguracyjnych oraz aktywowane podstawowe rozszerzenia. Wgraj go do tego samego katalogu, w którym umieściłeś źródła TYPO3.

Możesz też pobrać plik zip zawierający zarówno źródła jak i pakiet Dummmy.

Po umieszczeniu źródeł TYPO3 i pakietu Dummy struktura plików i katalogów powinna wyglądać następująco:

fileadmin/
misc/
t3lib/
typo3/
typo3conf/
typo3temp/
uploads/
_.htaccess
ChangeLog
clear.gif
GPL.txt
index.php
INSTALL.txt
LICENCE.txt
NEWS.txt
README.txt
RELEASE_NOTES.txt

Skrypt instalacyjny

Przed uruchomieniem skryptu instalacyjnego utwórz bazę danych przeznaczoną dla TYPO3.

Uwaga! TYPO3 nie może współdzielić bazy z innymi aplikacjami.

Uruchom skrypt instalatora otwierając w przeglądarce stronę http://twoja-domena/typo3/install/ . Jeżeli nie instalujesz TYPO3 lokalnie (localhost) to powinien pojawić się taki komunikat:

The Install Tool is locked.

Fix: Create a file typo3conf/ENABLE_INSTALL_TOOL
This file may simply be empty.

For security reasons, it is highly recommended to rename
or delete the file after the operation is finished.

Instalator nie uruchomi się dopóki nie utworzysz pliku ENABLE_INSTALL_TOOL w katalogu typo3conf. Plik ENABLE_INSTALL_TOOL może być pusty. Po zakończeniu instalacji należy ten plik usunąć lub zmienić jego nazwę.

Po utworzeniu pliku ENABLE_INSTALL_TOOL i odświeżeniu lokalizacji http://twoja-domena/typo3/install/ pojawi się najpierw komunikat (zrzut 1) a później ekran konfiguracji w trzech krokach (zrzut 2). Jeżeli pojawi się ekran logowania zamiast ekranu z zrzutem 2 to spróbuj wymusić "tryb 1-2-3" instalatora przez wpisanie następującego adresu: http://twoja-domena/typo3/install/index.php?mode=123&step=1&password=joh316

Zrzut 1
Zrzut 2
Zrzut 3
Zrzut 4
Zrzut 5
Zrzut 6
Zrzut 7
Zrzut 8

Po wejściu w "tryb 1-2-3" pojawi się przypomnienie o zmianie standardowego hasła do instalatora (zrzut 1) - wykonamy tą czynność później. Pomiń komunikat i wpisz parametry połączenia z bazą danych (zrzut 2), wybierz z listy rozwijanej bazę, którą ma wykorzystać TYPO3 (zrzut 3), zaimportuj początkowe dane z dump'a dołączonego do źródeł (zrzut 4). W tym momencie instalacja jest w zasadzie ukończona (zrzut 5), ale trzeba jeszcze skonfigurować parę rzeczy. Klikając "Continue to configure TYPO3" przejdziesz do podstawowego instalatora, z jakiego będziesz korzystać w dalszej pracy z TYPO3. Najpierw ustaw nowe hasło dostępu do instalatora (domyślne hasło to joh316) (zrzut 6), a następnie wejdź w "5: All Configuration" i wyszukaj opcję [forceCharset], i ustaw ją na utf-8 (zrzut 7). Wejdź jeszcze w "1: Basic configuration" i sprawdź czy są prawa zapisu w odpowiednich katalogach (zrzut 8) i czy pozostałe ustawienia w tym dziale są oznaczone jako poprawne. Sprawdź również czy TYPO3 poprawnie operuje na plikach graficznych w sekcji "4: Image Processing".

Spolszczenie panelu administracyjnego

Zainstalowałeś TYPO3 i dokonałeś podstawowej konfiguracji. Możesz się już zalogować do panelu administracyjnego. Znajduje się on pod adresem http://twoja-domena/typo3/ domyślny login to: admin domyślne hasło: password

Standardowo język panelu ustawiony jest na angielski. Należy pobrać polskie pliki językowe i ustawić język użytkownika na polski. Wejdź w "Tools -> Ext Manager". Wybierz "Translation Handling". Z listy "Languages to fetch:" wybierz język/języki, które chcesz pobrać a następnie naciśnij przycisk "Save selection" a później "Update from repository".

Mimo, że zainstalowałeś polskie pliki językowe nie zobaczysz tłumaczenia panelu administracyjnego dopóki nie zmienisz języka w profilu użytkownika. Wejdź w "User->Setup". Z listy rozwijanej "LANGUAGE:" wybierz język polski i zapisz ustawienia. Odśwież panel administracyjny - powinien być po polsku. Będąc w "User->Setup" zmień też obowiązkowo standardowe hasło administratora.

Jeżeli nie będziesz już wchodził do Instalatora usuń albo zmień nazwę dla pliku ENABLE_INSTALL_TOOL z katalogu typo3conf/.

 
Instalacja TYPO3 zakończona. Jeżeli wszystko działa możesz sobie pogratulować!

Jeżeli zamierzasz teraz zacząć tworzyć pierwszą witrynę to obowiązkowo zapoznaj się z następującą dokumentacją:
typo3.org/documentation/document-library/tutorials/doc_tut_templselect/0.1.0/view/
typo3.org/documentation/document-library/tutorials/doc_tut_templselect2/current/

FAQ

Spolszczenie

Pyt 1.  Zrobiłem w "Menadżer Rozszerzeń"->"Translation handling"->"Update from repository" i ustawiłem w profilu użytkownika język polski, ale backend się nie spolszczył. Co może być przyczyną?

  1. Sprawdź czy istnieje katalog typo3conf/l10n/. Sprawdź czy jest możliwość zapisywania plików w tym katalogu.
  2. Sprawdź czy są pliki *-l10n-pl.zip w katalogu typo3temp/. Pliki o takich nazwach pobierane najpierw do katalogu typo3temp/ a następnie rozpakowywane do katalogu typo3conf/l10n/. Jeżeli w katalogu typo3temp/ nie ma zipów z językiem polskim sprawdż następujące punkty:
    • Pliki z serwera tłumaczeń pobierane są za pomocą funkcji fopen. Niektóre serwery mają wyłączone fopen ze względów bezpieczeństwa. Uruchom phpinfo() i sprawdź czy masz włączony fopen.
    • Jeżeli fopen jest wyłączone to pliki językowe mogą być pobierane z wykorzystaniem curl. Uruchom phpinfo() i sprawdź czy masz zainstalowane curl. Jeżeli tak to przejdź do "Tools->Install", albo bezpośrednio do instalatora wpisując: twoja-domena/typo3/install/. Wybierz "5:All configuration". Odszukaj opcję odpowiadającą za curl [curlUse] i ustaw na 1.
  3. Jeżeli wydaje Ci się, że tłumaczenie jest nieaktualne skasuj wszystkie pliki *-l10n-pl.zip z katalogu typo3temp/, usuń też wszstkie pliki z katalogu typo3conf/l10n/pl/ następnie wejdź do "Menadżera Rozszerzeń"->"Translation handling" i pobierz tłumaczenia raz jeszcze.

Problemy specyficzne dla dostawców hostingu

Problem  1:

Po instalacji pojawia się błąd:
The original character set "iso-8859-2" was not found in t3lib/csconvtbl/Forced charset not found.

Jest to błąd występujący jedynie na serwerach home.pl i związany jest ze specyficzną konfiguracją ścieżki dostępu. Należy zmienić plik index.php i podmienić linię, w której definiowana jest stała PATH_site (linia 51) na:

define('PATH_site', (dirname(PATH_thisScript) == '/' ? '' : dirname(PATH_thisScript)).'/');

Patrz bug: http://bugs.typo3.org/view.php?id=4276

 

Problem 2:

Podczas próby instalacji systemu na serwerze home.pl otrzymuję serię błędów PHP zaczynającą się od podobnego zapisu:
Warning: session_start() [function.session-start]: open(/tmp/sess_9071afb0b178dd70a506ef6c003f3de9, O_RDWR) failed: No such file or directory (2) in /katalog-subdomeny/t3lib/class.t3lib_userauth.php on line 1064

Znów jest to błąd specyficzny dla serwerów home.pl (choć niewykluczone, że może pojawić się również u innych dostawców). Wynika z faktu, że serwery tego operatora są skonfigurowane w ten sposób, by korzystać z katalogu tmp w tym samym katalogu na który wskazuje domena. Rozwiązaniem jest stworzenie katalogu tmp, w katalogu do którego wskazuje domena.

Forum

Jeżeli przy instalacji pojawiły się jakieś problemy możesz poprosić o pomoc na forum w dziale ZARZĄDZANIE SYSTEMEM->Instalacja

O autorach

Andrzej Korzec

jest jednym z głównych założycieli Społeczności TYPO3 w Polsce. TYPO3 zajmuje się od 2004 roku. Zatrudniony jako webdeweloper w zachodnioeuropejskiej agencji public relations.

email

Krystian Szymukowicz

jeden z głównych założycieli Społeczności TYPO3 w Polsce. Przygodę z TYPO3 rozpoczął pod koniec 2003 roku. Jest konsultantem/freelancer'em. Prowadzi własną firmę PROLABIUM.COM.

email