Tutorial Typo3

Getting started with by Robert Lemke Copyright © 2009, 2010 Robert Lemke, licensed under the Creative Commons Attribution-Share Alike 3.0 License Robert Lemke Copyright © 2009, 2010 Robert Lemke, licensed under the Creative Commons Attribution-Share Alike 3.0 License This tutorial gets you started with FLOW3. The most important concepts such as the MVC framework, object management, persistence and templating are explained on the basis of a sample application. 1. Introduction ............................................................................................................ 1 1. What's FLOW3? ............................................................................................. 1 2. in this tutorial? .................................................................................... 1 2. Requirements ......................................................................................................... 2 1. Server Environment ........................................................................................ 2 2. PHP .............................................................................................................. 2 3. Installation ............................................................................................................. 3 1. FLOW3 Download .......................................................................................... 3 2. Directory Structure ......................................................................................... 3 3. File Permissions ............................................................................................. 4 4. Web Server Configuration ............................................................................... 4 4.1. Setting Up a Virtual Host ..................................................................... 5 4.2. Configure a Context ............................................................................ 5 4.3. Welcome to FLOW3 ............................................................................ 5 4. Configuration .......................................................................................................... 7 1. Contexts ........................................................................................................ 7 2. Configuring FLOW3 ........................................................................................ 8 5. Modeling .............................................................................................................. 10 1. Domain-Driven Design .................................................................................. 10 2. Domain Model .............................................................................................. 11 3. Repositories ................................................................................................. 12 4. Aggregates .................................................................................................. 14 6. Kickstart ............................................................................................................... 16 1. Command Line Tool ..................................................................................... 16 2. Kickstart the package ................................................................................... 17 3. Controllers ...................................................................................... 18 4. Kickstart Models and Repositories ................................................................. 19 7. Model and Repository ........................................................................................... 20 1. Blog Model .................................................................................................. 20 2. Blog Repository ............................................................................................ 23 8. Controller ............................................................................................................. 25 1. Setup Controller ........................................................................................... 25 2. Basic Post Controller .................................................................................... 26 3. Create Action ............................................................................................... 27 9. View .................................................................................................................... 29 1. Resources .................................................................................................... 29 2. Layouts ........................................................................................................ 30 3. Templates .................................................................................................... 32 4. Forms .......................................................................................................... 34 4.1. Create a New Post ............................................................................ 34 4.2. Edit a Post ........................................................................................ 37 4.3. A Closer Look on Updates ................................................................. 39 10. Validation ........................................................................................................... 42 1. Declaring Validation Rules ............................................................................ 42 iii2. Displaying Validation Errors .......................................................................... 43 3. Validating Updated Arguments ...................................................................... 44 11. Routing .............................................................................................................. 46 1. Post Index Route ......................................................................................... 46 2. Composite Routes ........................................................................................ 46 3. An Action Route ........................................................................................... 47 4. Route Part Handlers ..................................................................................... 48 5. More on Routing .......................................................................................... 50 12. Summary ........................................................................................................... 51 1. Next Steps ................................................................................................... 51 2. Feedback ..................................................................................................... 51 iv 5.1. A simple model ................................................................................................. 11 5.2. Domain Model with properties ............................................................................ 12 5.3. Blog Repository and Blog .................................................................................. 13 5.4. A dedicated Post Repository .............................................................................. 14 5.5. The Post Aggregate ........................................................................................... 15 7.1. Blog Repository and Blog .................................................................................. 24 8.1. Output of the indexAction ................................................................................... 27 9.1. Layout, Template and Partial .............................................................................. 30 v 3.1. Directory structure of a FLOW3 application ........................................................... 3 4.1. Context Configurations ......................................................................................... 8 9.1. Directory structure of a FLOW3 package ............................................................. 29 9.2. Create, Show, Update detection ......................................................................... 41 vi FLOW3 is a PHP-based application framework. It is especially well-suited for enterprise- grade applications and explicitly supports Domain-Driven Design, a powerful software design philosophy. Convention over configuration, Test-Driven Development, Continuous Integration and an easy-to-read source code are other important principles we follow for the development of FLOW3. Needless to say, FLOW3 provides you with a full-stack MVC framework for building state-of-the-art web applications. More exciting though are the first class Dependency Injection support and the Aspect-Oriented Programming capabilities which can be used without a single line of configuration. This tutorial explains all the steps to get you started with your very own first FLOW3 project. Please bring your own computer, a reasonable knowledge of PHP and HTML and at least some initial experience with object-oriented programming. In return you'll surely get some new insights into modern programming paradigms and how to produce clean code in no time. Please note that this tutorial refers to FLOW3 1.0.0 alpha 7 which means that changes to the API are still possible. However, we're quite confident that the concepts described in this tutorial will remain the same in FLOW3 1.0.0 final. If you're stuck at some point or stumble over some weirdnesses during the tutorial, please let us know! We appreciate any feedback in our mailing lists, as 1 a ticket in our issue tracker or via private email . This tutorial goes best with a Caffè Lat