I started using Flow two days ago. I set up a virtual machine containing Ubuntu 18.04, MariaDB, Apache, PHP and Composer and configured as little as possible to make the tutorial project work.
I followed the instructions at https://flowframework.readthedocs.io/en/stable/TheDefinitiveGuide/PartII/Introduction.html to set up the tutorial project.
As it happens, the tutorial didn’t run right off the bat. E.g the AllowOverride Directive for the tutorial directory had to be extended to:
<Directory /usr/local/apache2/htdocs/tutorial/> AllowOverride FileInfo Options=MultiViews,Indexes,ExecCGI,Includes </Directory>
Otherwise, the .htaccess file in the Web/_Resources directory triggers errors because of prohibited use of the options Indexes, ExecCGI or Includes.
Furthermore, the DirectoryIndex directive had to be changed from index.html to index.php. Otherwise, the URI dev.tutorial.local shows an index with a list of the files in Web/ instead of redirecting to index.php.
Last but not least, after kickstarting the example application Acme.Blog, http://dev.tutorial.local/acme.blog showed the message “controller not found” until the global Configuration Configuration/Settings.yaml.example was copied to Configuration/Settings.yaml, probably because it configures the router.
I am not yet accustomed to PHP and its frameworks, so I suspect my points might seem obvious to the usual beginners starting with Flow and wouldn’t be worth mentioning. Otherwise I’d like to help to make the entry barrier a bit lower.
There is also a possibility that the configuration I had to imply is tied to my specific environment. E.g. I compiled Apache and PHP instead of using the Ubuntu repositories to download them.
What do you think?