Welcome to The Cookbook

Een controller wordt gebruikt om de logica van je applicatie te beheren. Het meest voorkomende is dat controllers worden gebruikt om de logica te beheren voor één enkel model. Bijvoorbeeld, bij het bouwen van een website voor een online bakkerij kun je een ReceptenController en een IngredientenController hebben om respectievelijk je recepten en hun ingrediënten te beheren. In CakePHP zijn controllers vernoemd naar het model dat ze afhandelen, in meervoudsvorm.

Het Recepten model wordt afgehandeld door de ReceptenController, het Product model wordt afgehandeld door de ProductenController, enzovoorts.

Je applicatie's controllers zijn klassen die de CakePHP AppController uitbreiden, welke op zijn beurt weer de core Controller class uitbreid. De AppController klasse kun je definiëren in /app/app_controller.php en dient alleen methoden te bevatten welke gedeeld worden over alle controllers van je applicatie. Deze breid de Controller klasse uit welke een standaard CakePHP library is.

Controllers kunnen een aantal methoden bevatten waarna over het algemeen als acties naar gerefereerd wordt. Acties zijn controller methoden welke gebruikt worden om views weer te geven. Een actie is één enkele methode van een controller. CakePHP's dispatcher roept de actie aan bij een inkomend verzoek waarvan de URL overeenkomt met een controller's actie. Om terug te komen op ons online bakkerij voorbeeld, onze ReceptenController kan de methoden view(), share() en search() bevatten. De controller zou dan te vinden zijn in /app/controllers/recepten_controller.php en zou bevatten:

    <?php
    
    # /app/controllers/recepten_controller.php

    class ReceptenController extends AppController {
        function view($id)     {
            //actie logica hier..
        }

        function share($klant_id, $recept_id) {
            //actie logica hier..
        }

        function search($query) {
            //actie logica hier..
        }
    }

    ?>

1. <?php
3. # /app/controllers/recepten_controller.php
4. class ReceptenController extends AppController {
5. function view($id) {
6. //actie logica hier..
7. }
8. function share($klant_id, $recept_id) {
9. //actie logica hier..
10. }
11. function search($query) {
12. //actie logica hier..
13. }
14. }
15. ?>

Om een controller effectief in je applicatie te kunnen gebruiken zullen we nu wat kern attributen en methoden bespreken welke te vinden zijn in CakePHP's controllers.

A controller is used to manage the logic for a part of your application. Most commonly, controllers are used to manage the logic for a single model. For example, if you were building a site for an online bakery, you might have a RecipesController and a IngredientsController managing your recipes and their ingredients. In CakePHP, controllers are named after the model they handle, in plural form.

The Recipe model is handled by the RecipesController, the Product model is handled by the ProductsController, and so on.

Your application's controllers are classes that extend the CakePHP AppController class, which in turn extends a core Controller class. The AppController class can be defined in /app/app_controller.php and it should contain methods that are shared between all of your application’s controllers. It extends the Controller class which is a standard CakePHP library.

Controllers can include any number of methods which are usually referred to as actions. Actions are controller methods used to display views. An action is a single method of a controller. CakePHP’s dispatcher calls actions when an incoming request matches a URL to a controller’s action. Returning to our online bakery example, our RecipesController might contain the view(), share(), and search() actions. The controller would be found in /app/controllers/recipes_controller.php and contain:

    <?php
    
    # /app/controllers/recipes_controller.php

    class RecipesController extends AppController {
        function view($id)     {
            //action logic goes here..
        }

        function share($customer_id, $recipe_id) {
            //action logic goes here..
        }

        function search($query) {
            //action logic goes here..
        }
    }

    ?>

1. <?php
3. # /app/controllers/recipes_controller.php
4. class RecipesController extends AppController {
5. function view($id) {
6. //action logic goes here..
7. }
8. function share($customer_id, $recipe_id) {
9. //action logic goes here..
10. }
11. function search($query) {
12. //action logic goes here..
13. }
14. }
15. ?>

In order for you to use a controller effectively in your own application, we’ll cover some of the core attributes and methods provided by CakePHP’s controllers.