11 Nov 2012

Getting started with TYPO3 Flow

TYPO3

The available Getting started tutorial is outdated. Obviously "FLOW3" was simply replaced by "Flow" resulting in some wrong information (incl. the url to the Git repository). A month ago Karsten posted a video on Vimeo showing how to getthe code and all dependencies using Composer. But this was before the renaming.

So here are the simple steps (mostly as seen in Karsten's video) to get started with Flow.

1. Clone the repository to your local machine:

git clone [git://git.typo3.org/FLOW3/Distributions/Base.git](git://git.typo3.org/FLOW3/Distributions/Base.git) /var/www/flow

The --recursive option is not required anymore as there are not submodules defined. Instead a composer configuration file was added telling composer where to get all dependencies from:

2. Get composer

cd /var/www/flow  
curl -s [getcomposer.org/installer](http://getcomposer.org/installer) | php

Download composer using the curl command. If you prefer having composer installed in a central place just download to /usr/local/bin (on Ubuntu and some other Linux).

3. Run composer

./composer.phar install --dev

This will download a dependencies in the correct versions.

4. Set file permissions

sudo ./flow flow:core:setfilepermissions <commandlineuser> <webuser> <webgroup>

Note that the command line tool was renamed from flow3 to flow. Get a full list of available commands by typing ./flow help.

5. Run unit tests

phpunit -c Build/buildessentials/PhpUnit/UnitTests.xml  
phpunit -c Build/buildessentials/PhpUnit/FunctionalTests.xml

Phpunit is also available as a single-file phar archive. Run this command to download it: 

wget [pear.phpunit.de/get/phpunit.phar](http://pear.phpunit.de/get/phpunit.phar)  
sudo chmod +x phpunit.phar

However there seems to be a problem with this phar version resulting in errors while executing the tests. Running them with a traditionally installed phpunit works fine.

6. Next steps

Now go on setting up Apache as described in the getting started tutorial and hit Flow in your browser. As soon as you can see the welcome screen you're ready to start coding!

Have fun!

Comments

This website uses disqus for the commenting functionality. In order to protect your privacy comments are disabled by default.

Enable Comments