[TASK] Install tool test action fatals if image not exists
[Packages/TYPO3.CMS.git] / INSTALL.txt
index 9218ea9..437525f 100644 (file)
@@ -4,7 +4,7 @@ INSTALLING TYPO3
 
 This document is a part of the TYPO3 project. TYPO3 is an open source web
 content management system released under the GNU GPL. TYPO3 is copyright
-(c) 1999-2011 by Kasper Skaarhoj.
+(c) 1999-2013 by Kasper Skaarhoj.
 
 This document describes the system requirements for TYPO3 and the installation
 routine.
@@ -20,12 +20,14 @@ document assumes that Apache and MySQL will be used. This document does not
 cover using TYPO3 with other databases or web servers.
 
 The following configuration is the minimum required:
+
 - a web server capable of running PHP
-- PHP 5.3.0 or newer with the following extensions:
+- PHP 5.3.7 or newer with the following extensions:
+       - fileinfo
        - filter
        - GD2
        - JSON
-       - mysql
+       - mysqli
        - openssl
        - pcre
        - session
@@ -34,25 +36,27 @@ The following configuration is the minimum required:
        - standard
        - xml
        - zlib
-       Some extensions can be optionally compiled into PHP. A list of loaded
-       extensions can be checked using the phpinfo() function.
 - memory_limit set to at least 64M in php.ini
+- register_globals is disabled in php.ini
 - MySQL 5.0 or newer
 - 200 MB of disk space
 - AllowOverride in the Apache configuration includes "Indexes" and "FileInfo"
   (see FAQ below)
+- Apache stack size 8MB (or more). (see FAQ below)
 
 The following configuration is recommended:
+
 - Apache 2.x
 - mod_expires and mod_rewrite enabled in the Apache configuration
-- PHP 5.3.0 or newer with the following extensions:
+- PHP 5.3.7 or newer with the following extensions:
        - cURL
+       - fileinfo
        - filter
        - GD2
        - hash
        - JSON
        - mbstring
-       - mysql
+       - mysqli
        - openssl
        - pcre
        - session
@@ -61,12 +65,11 @@ The following configuration is recommended:
        - standard
        - xml
        - zlib
-       Some extensions can be optionally compiled into PHP. A list of loaded
-       extensions can be checked using the phpinfo() function.
 - Safe mode is not supported, thus it must not be activated
 - Magic Quotes is deprecated, thus it should be deactivated
 - memory_limit set to 128M or more in php.ini
 - MySQL 5.1 or newer
+- FreeType 2
 - GraphicsMagick or ImageMagick v6 or newer
 - 200 MB or more of disk space
 - AllowOverride in the Apache configuration includes "Indexes" and "FileInfo"
@@ -79,12 +82,16 @@ settings if you use it. If these paths are unavailable, TYPO3 will attempt to
 simulate random number generation. This is less secure, causes performance
 issues and warnings in the TYPO3 system log.
 
+TYPO3 relies on IPv6 support, which is by default enabled since PHP 5.3.
+Take care not to compile PHP 5.3 with the option "--disable-ipv6", because
+this will break the IPv6 support and the according unit tests.
+
 ===============================================================================
 Obtaining TYPO3
 ===============================================================================
 
 To get TYPO3, navigate to the following location:
-       http://typo3.org/download/packages/
+       http://typo3.org/download/
 
 TYPO3 consists of two packages: source and dummy. The source package contains
 files that are the same for every TYPO3 web site. The dummy package contains
@@ -115,7 +122,6 @@ the web server.
 
 Change permissions of the directories and files. The following directories and
 files should be read-only for the web server:
-       t3lib/
        typo3/
        index.php
 
@@ -151,15 +157,14 @@ pointing to the source package:
 
 On Windows Vista or Windows 7 create a symbolic link named typo3_src
 pointing to the source package:
-       mklink /D C:\<dir>\typo3_src-4.6.0 C:\<dir>\example.com\typo3_src
+       mklink /D C:\<dir>\example.com\typo3_src C:\<dir>\typo3_src-4.6.0
 
 Users of Windows XP/2000 or newer can use the "junction" program by
 Marc Russinovich to create links. The program can be obtained at:
        http://technet.microsoft.com/en-us/sysinternals/bb896768.aspx
 
-Next create links for the typo3/ and t3lib/ directories:
+Next create link for the typo3/ directory:
 cd /var/www/example.com
-       ln -s typo3_src/t3lib
        ln -s typo3_src/typo3
 
 Linux, Unix and Mac OS X users also create a symbolic link to index.php
@@ -191,7 +196,7 @@ Troubleshooting
 
 For troubleshooting read the FAQ below. If your problem is not listed, feel
 free to ask questions in the TYPO3 mailing lists:
-       http://typo3.org/community/mailing-lists/
+       http://typo3.org/support/mailing-lists/
 
 
 ===============================================================================
@@ -227,6 +232,16 @@ A: If you use MySQL 5.x or newer, try setting it to "compatible" mode. Open the
        and add this line to the top of the input field:
                SET SESSION sql_mode='MYSQL40'
 
+Q:     Some modules or extensions make Apache crash on Windows. What is the cause?
+A:     Fluid uses complex regular expressions which require a lot of stack space
+       during the first processing. On Windows the default stack size for Apache
+       is a lot smaller than on unix. You can increase the size to 8MB (default on
+       unix) by adding to the httpd.conf:
+               <IfModule mpm_winnt_module>
+                       ThreadStackSize 8388608
+               </IfModule>
+       Restart Apache after this change.
+
 Q:     What do I have to do regarding security?
 A:     You have to make sure that you keep your TYPO3-core and the extensions
        up to date.