Flow Installation Hints
Hint: everything below is reStructuredText - leave the rst tags in place. Thanks!
Just leave your hints and comment on existing ones. For the FLOW3 releases we will go through them and integrate them into the installation instructions / manual where it makes sense.
"Maximum function nesting level reached" fatal error
In case you get a fatal error message saying something like "Maximum function nesting level of '100' reached, aborting!", check your php.ini-file for settings regarding "xdebug" and modify/add a line xdebug.max_nesting_level = 500 (suggested value; the blog example requires at least a value of about 150).
Memory exhausted during unit tests
If unit tests do not fully complete, it may be neccessary to extend the memory limit. Modify your php.ini and set it to at least 256M memory_limit = 256M
Usernames with "." don't work with workspace handling in BE editing
There is currently an issue with usernames containing a dot in it while trying to edit a page in the "content" module of the backend. TYPO3 is adding a "@user-USERNAME.html" to the websites URI and if you have a "." in your username (like "@user-foo.bar.html") you'll get a 404 message displayed. See #27991
Running on Windows OS's
If you haven't installed PHP to the default location (specified by the PHP_BINDIR constant which usually points to C:/php), you'll have to specify the path to your php binary explicitly:
Edit the file …/Configuration/Settings.yaml and set/uncomment the TYPO3.FLOW3.core.phpBinaryPathAndFilename directive. Please use single forward slashes, an uppercase drive letter in any case and avoid typical special characters like ~ or () (see http://forge.typo3.org/issues/35916 for more information on this). The whole setting should read e.g.:
TYPO3: FLOW3: core: phpBinaryPathAndFilename: 'C:/Programs/Zend/ZendServer/bin/php.exe'
If nothing works, it may be a good idea to add the executable to your PATH (if not there anyways) and just set this directive to php or php.exe.
Command Line Tool
To run the flow3 command line interface, make sure the directory of your php binary is in the path environment variable. You can add it to the path by executing:
An alternative solution is to edit the path in the flow3.bat script in the root directory. Afterwards you can run the CLI:
> CD path/to/your/flow3/installation > flow3.bat help
Note: If you get an error because PHP could not create the required symlinks, follow the steps mentioned above
If you want to clone FLOW3 to a Windows system, Git needs to be configured so it does not convert new line characters. This is done with the setting core.autocrlf and should be set to "input":
git config --global core.autocrlf input
If you don't do this you might run into errors like "Uncaught Exception The ... annotation for ... seems to be invalid."