So, you want to get started with TYPO3 right away…we've put this basic installation document together to set you off on the right track. To ensure your installation is as simple as possible, you should read this document carefully, and any others referenced within.
This is not intended to replace the main TYPO3 installation & upgrade documents, and it does not give in depth instructions and explanation into TYPO3…just enough so that you understand what is required, and can get a basic install up and running. It also does not explain the procedures for compiling packages, or installing Apache, IIS, PHP, MySQL etc…you'll need to read the documentation relating to each for details. There are 2 TYPO3 documents that relate to installation…both are available on http://typo3.org/
- Installing & Upgrading - this document describes the folder structure of TYPO3, installation of all versions, and the upgrade methodology. There is also a section on installing the web server
If you're so keen to get started with TYPO3 that you can't wait until you've read to the bottom of this document first, do this… 1 - Download the testsite ZIP distribution 2 - Unzip the distribution to your server 3 - In your browser hit http://[your.site.name]/index.php 4 - Follow the instructions in the 1-2-3 install tool Please note - we're not going to support this…if you have a problem, read the rest of the document before you ask any questions!
TYPO3 is a powerful and complex professional application. When you start out there will be many things you donエt understand, or that don't seem to make sense. There is a widely used mailing list (more information on http://typo3.org/) where many experienced users and developers lurk…they are always willing to help, provided you followed these steps BEFORE you ask your question:
Please be aware that if you ask questions that are answered in the available documentation, you may not get a reply, or any help from the developers or any experienced users!
We are aware that there is still some work to be done on the documentation, and the platform for user support…please forgive us for not having all these gaps filled. If you feel that some information is missing, hard to find or just plain wrong, or you have a suggestion on improving TYPO3 or the 都upport services・ please let us know so that we can do what is necessary. You could also volunteer to help with the work!
TYPO3は、一般的な意味でのアプリケーションではないので、(TYPO3はWebサーバ上で動作します)、Linux/Unixでも、WindowsでもMacでも動作します。 TYPO3をインストール後動作させるためには、TYPO3自体に加え、幾つかほかのソフトウェアも必要になります。
以下のリストが助けになるでしょう。(http://typo3.org/でシステム要件についてもご覧ください)
- Image processing - TYPO3 is renowned for its capability to manipulate graphics. However, if you only intend to develop a plain, text-based web site you don't need to either install the server-side software that is required for image processing, or enable it within TYPO3. Be aware that you will be missing one of the great features of TYPO3 - ImageMagick - TYPO3 versions including and after 3.5 will happily work with the latest versions of ImageMagick (currently 5.x.x). However, there is a drawback with using this version. The RPM (for Linux) is compiled without LZW compression for GIF files, due to the patent issues with Unisys…this will slow down performance slightly. For the best performance on Linux, you can install version 4.2.9 to /usr/X11R6/bin/, and a later version to /usr/bin/…TYPO3 is setup to use ImageMagick installed to these locations. The Windows version of ImageMagick 4.2.9 available from http://typo3.org/ has LZW compression. The alternative to all this is to use the latest version of ImageMagick, and use a version of GD that has LZW for GIF! - GD - this is compiled into PHP, and activated by installing the extension in the php.ini file. On Linux you can re-compile PHP yourself with any version of GD, but for Windows users you will probably use a pre-compiled binary. GD Versions after 1.8.4 do not have GIF support, again due to the patent issues with Unisys. Note that if your build of PHP has a later version of GD without GIF support, you can't simply obtain an earlier PHP extension and use it, without recompiling PHP - PHP 1 - there have been problems reported when using the very latest version (4.3.x) - PHP 2 - TYPO3 will not currently run with the memory_limit directive in php.ini set to less than 8mb
Before you can install TYPO3, you have to have a working web server…
1 - Install Apache or IIS 2 - Test your install by hitting http://127.0.0.1 (or your web site address) from your web browser. If you don't see the server's “welcome” page, something is wrong at the most basic level…correct this before moving on 3 - Install PHP & configure the web server to use it (see the PHP documentation) 4 - Create a plain text file…enter 1 line as follows…<? phpinfo() ?>. Save the file in your web site's root as phpinfo.php 5 - In your web browser hit http://[your.site.name]/phpinfo.php. You should see a long page listing lots of information about PHP. If you don't, re-check the PHP configuration in your web server 6 - Install ImageMagick (see the ImageMagick documentation) 7 - Install & test MySQL (see the MySQL documentation - mysql.org) 8 - Install a PHP accelerator if you are going to use one (phpaccelerator.com, zend.com) 9 - Re-check your PHP configuration as in step 5. Scroll down the page…you should see a section titled “mysql” (if you don't, mysql is either not running, or not installed properly (support is automatic in PHP, so you don't have to do anything). Further down the page you should find a section called “gd”. This will show you what support your version of GD is giving you. Ideally you want to see FreeType, GIF, JPEG, PNG all enabled…if GIF is missing, your version of GD doesn't support it (see above). If you don't see a section for gd at all, check that you have enabled the gd extension in your php.ini file
WEBサーバの準備が整ったら、TYPO3のインストールができるようになります。
まずは、テストサイトパッケージをインストールします。
このパッケージは、TYPO3で実現可能な機能を導入したサイトです。このテストサイトのインストール方法は以下のとおり。
Either delete the /install folder, protect it using a .ht access file or at least change the install tool password Create a new administration user with a name and password that cannot be guessed (on page 2 of the Install Tool, Database Analyser)
Install an empty database ready to start building your site…
The easiest way to do this is to use the ZIP install package as above with the following exceptions…
Click Compare next to Update required tables, then click Write to database Click Import next to Dump static data You'll see an entry typo3conf/database.sql below…do not import this database
When a TYPO3 version is officially released (i.e. not previews or RC's), there is usually a “dummy” distribution that contains the normal files found in the testsite ZIP, but without the testsite database. Install a dummy package following the instructions just above.
GETTING INTO THE BACK END ADMINISTRATION AREA (BE) AND INSTALL TOOL
Your install is done, and you want to get on with learning about TYPO3, and building a site. You need to know how to access the BE, where all the site administration and construction takes place, and the install tool to update your configuration…
- To log into the BE, in your browser hit http://[your.site.name]/typo3 - To log into the Install Tool, hit http://[your.site.name]/typo3/install
You can also access the install tool from within the BE.
NOTE - the default passwords are…
- Install tool - joh316 - BE administration user - name=admin, password=password
REMEMBER - the default passwords above should be changed as they represent a serious security risk to your installation, especially if your site is on a server with public access.
Once in the BE, you'll see a menu of available modules to the left of the screen. I suggest you take time to read the Help>About module, as it gives a brief introduction to each one. You should also browse through the BE to find out where everything is.
TYPO3 is a simple system for end-users, but it is complex for developers, and isn't quick to learn. However, if you devote enough time to getting to grips with it, you'll find TYPO3 an enjoyable and rewarding tool to use. In particular, you'll need to get to grips with TypoScript (read the documents TSref and TypoScript by Example) …this is the “definition” scripting language developed by Kasper, with which you build your templates, and enable and configure the many functions within TYPO3
TYPO3 is one of the best and most extensively documented open source products around…make use of this valuable resource to learn about the system, and how to get the most from it. Extensive documentation is available from the documentation section on http://typo3.org/, including tutorials, technical and reference manuals.
It is highly recommended that you join the official TYPO3 mailing list. On the list you'll find many experienced members of the community who are willing to help with problems you may be having, or advice on how to accomplish a particular task. You may also wish to join one of the other mailing lists that are devoted to TYPO3. Visit the mailing list page on http://typo3.org/ for more information.
From TYPO3 version 3.5 the basic construction of the system was changed. Previously, all modules and components were built into the system, and every installation included everything…whether you needed it or not!
TYPO3 is now distributed as an installation of core files, and global extensions that are used all the time. Additional functionality is provided by downloading and installing other extensions, that are written by Kasper himself, or by other developers and users. The extensions are held in an online repository on http://typo3.org/.
In the BE, click the module Tools>Ext Manager to open the Extension Manager. This is the tool you use to view, download, install, uninstall, create and upload extensions. Use the drop down menu at the top to select what you want to see.
To download and install an extension, do this…
1 - Select the page “Import extensions from the online repository” and click the connect button 2 - The extensions will be listed…those that are available to you and which are not already on your system have an icon in the very left column…click this icon to download the extension to your server 3 - Select the page “Available extensions to install”…find the extension you want to install in the list and click the + button to the left…if any database updates are required, you will be prompted to do so 4 - Clear the cache, log out and back in, and the new extension will be ready to use (note that logging out and in is not required for all extensions)
As a first test…connect and download the extension Help>Welcome, then install it. After logging out and back in, you'll see the new module in the BE under…you guessed…Help>Welcome! Click on it to see an introduction on how to use some of the features of TYPO3.
Once you have gained some experience with TYPO3, you may want to start writing your own extensions…before you start, there are several documents you should read…
- Inside TYPO3 - explains the architecture and inner structure of TYPO3. This document includes the a section TYPO3 Extension API, which describes the process of creating an extension, naming conventions and rules - Coding Guidelines - guidelines that must be followed when coding for TYPO3
Once you have created an extension, you'll need to do the following to upload it to the extension repository, and view it…
1 - First register on the online extension repository at http://typo3.org/ 2 - Once you've registered, open the Extension Manager>Settings page…enter your username and password in the (the extension repository one, not the one for the BE)…click update 3 - Upload your extension 4 - Now when you connect using your username and password, you'll also see your own and other “members” extensions
NOTE - there is a known bug at present…when using TYPO3 on Windows together with the Apache ISAPI module, you will get errors when trying to download from the repository. Windows and Apache in CGI mode works OK.