[TASK] Make HtmlViewHelper compilable
[Packages/TYPO3.CMS.git] / INSTALL.md
index b718e21..b036c31 100644 (file)
@@ -2,7 +2,7 @@ INSTALLING TYPO3
 ================
 
 TYPO3 is an open source PHP based web content management system released
-under the GNU GPL. TYPO3 is copyright (c) 1999-2013 by Kasper Skaarhoj.
+under the GNU GPL. TYPO3 is copyright (c) 1999-2015 by Kasper Skaarhoj.
 
 This document describes:
 
@@ -13,10 +13,10 @@ This document describes:
 Client browser support
 ----------------------
 
-The TYPO3 backend is accessed through a web browser. TYPO3 CMS 6.2 LTS
+The TYPO3 backend is accessed through a web browser. TYPO3 CMS 7
 supports the following web browsers:
 
-* Internet Explorer 8 and later
+* Internet Explorer 9 and later
 * Google Chrome (Windows, MacOS, Linux)
 * Firefox (Windows, MacOS, Linux)
 * Safari on MacOS
@@ -26,13 +26,24 @@ Server system requirements
 --------------------------
 
 TYPO3 requires a web server with a PHP environment and a database. The minimum
-system requirements for running TYPO3 CMS 6.2 LTS are:
+system requirements for running TYPO3 CMS 7 are:
 
 * Webserver capable of running PHP applications (Apache, Nginx, IIS or other)
-* PHP >5.3.7 up to 5.5 (PHP 5.4 or later recommended)
-* MySQL 5.1 up to 5.6 or compatible
+* PHP >5.5 up to 5.6
+* MySQL 5.5 up to 5.6 or compatible (no "strict mode", see below)
 * more than 200 MB of disk space
 
+### MySQL environment
+
+TYPO3 works with MySQL in the above mentioned versions. It will also work on
+compatible "drop-in" replacements like MariaDB or Percona.
+
+Note that MySQL "strict mode" is currently not supported by TYPO3. If your
+MySQL server is configured with either STRICT_TRANS_TABLES or
+STRICT_ALL_TABLES (especially true with MySQL 5.6, as this is a new default),
+you need to configure setDBinit in the Install Tool. See question 2 in the
+"Installation FAQ" below for more information.
+
 ### PHP environment
 
 * memory_limit set to at least 64M
@@ -53,7 +64,7 @@ check if these are available.
   * filter
   * hash
   * openssl
-  * pcre
+  * pcre >= 8.30
   * session
   * soap
   * SPL
@@ -78,12 +89,12 @@ functionality:
 
 * Apache with mod_expires and mod_rewrite enabled
 
-* MySQL 5.1 or newer
+* MySQL 5.5 or newer
 
 * GraphicsMagick or ImageMagick v6 or newer installed on the server
 
 * PHP
-  * version 5.4 or later
+  * version 5.5 or later
   * memory_limit set to at least 128M
   * max_execution_time set to at least 240s
 
@@ -93,7 +104,8 @@ functionality:
   * apc caching (with at least 100 MB of memory available)
   * curl
   * mbstring
-  * FreeType (usually included within the PHP distribution)
+  * FreeType 2 (usually included within the PHP distribution)
+  * bcmath or gmp (needed if you'd like to use the openid system extension)
 
 * PHP access to /dev/urandom or /dev/random on Unix-like platforms for
   increased security. Make sure to add "/dev/random:/dev/urandom" to
@@ -102,30 +114,38 @@ functionality:
   reduces performance and throws out warnings in the TYPO3 system log.
 
 * TYPO3 works with PHP's IPv6 support, which is enabled by default since
-  PHP 5.3. If you compile PHP 5.3 on your own, be aware not to use option
+  PHP 5.3. If you compile PHP on your own, be aware not to use option
   "--disable-ipv6", because this will break the IPv6 support and the according
   unit tests.
 
 Installation
 ------------
 
+### Important note for upgrades from TYPO3 CMS versions **below 6.2 LTS**
+
+It is not possible to upgrade any version below 6.2 LTS to 7 directly,
+since some upgrade wizards are not available anymore on 7.
+
+It is highly recommended to upgrade to 6.2 LTS first and continue with
+a second upgrade to 7.
+
 ### If SSH and symlinks are possible
 
 If you have SSH access to your webserver and are able to create symlinks,
 this is the recommended way of setting up TYPO3 so that it can easily
 be upgraded later through the Install Tool:
 
-* Uncompress the `typo3_src-6.2.x.tar.gz` file one level above the Document
+* Uncompress the `typo3_src-7.0.x.tar.gz` file one level above the Document
   Root of your Web server:
 ```
 /var/www/site/htdocs/ $ cd ..
-/var/www/site/ $ tar xzf typo3_src-6.2.x.tar.gz
+/var/www/site/ $ tar xzf typo3_src-7.0.x.tar.gz
 ```
 
 * Create the symlinks in your Document Root:
 ```
   cd htdocs
-  ln -s ../typo3_src-6.2.x typo3_src
+  ln -s ../typo3_src-7.0.x typo3_src
   ln -s typo3_src/index.php index.php
   ln -s typo3_src/typo3 typo3
 ```
@@ -138,8 +158,8 @@ be upgraded later through the Install Tool:
 You end up with the follow structure of files:
 
 ```
-  typo3_src-6.2.x/
-  htdocs/typo3_src -> ../typo3_src-6.2.x/
+  typo3_src-7.0.x/
+  htdocs/typo3_src -> ../typo3_src-7.0.x/
   htdocs/typo3 -> typo3_src/typo3/
   htdocs/index.php -> typo3_src/index.php
   htdocs/.htaccess
@@ -154,7 +174,7 @@ be found in the Install Tool.
 On Windows Vista and Windows 7, you can create symbolic links using
 the `mklink` tool:
 ```
-  mklink /D C:\<dir>\example.com\typo3_src C:\<dir>\typo3_src-6.2.x
+  mklink /D C:\<dir>\example.com\typo3_src C:\<dir>\typo3_src-7.0.x
 ```
 
 Users of Windows XP/2000 or newer can use the `junction` program by
@@ -176,7 +196,7 @@ installation once a new patchlevel release is out.
 
 Please note that this is not a recommended setup!
 
-* Uncompress `typo3_src-6.2.x.tar.gz` locally
+* Uncompress `typo3_src-7.0.x.tar.gz` locally
 * Upload all files and subdirectories directly in your Document Root
   (where files that are served by your webserver are located).
 * In case your provider uses Apache:
@@ -256,7 +276,7 @@ A:  If you use MySQL 5.x or newer, try setting it to "compatible" mode. Open the
     example.com is the web site domain), navigate to "All configuration".
     Find "setDBinit", and add this line to the top of the input field:
 ```
-       SET SESSION sql_mode='MYSQL40'
+       SET SESSION sql_mode=''
 ```
 
 ### 3
@@ -271,4 +291,4 @@ A:  Fluid uses complex regular expressions which require a lot of stack space
                ThreadStackSize 8388608
        </IfModule>
 ```
-    Restart Apache after this change.
+    Restart Apache after this change.
\ No newline at end of file