# 2, Routing

*In deze les leer je wat routing is en hoe je binnen Yii de routing kunt instellen.*

### Wat is routing? (Algemeen)

Routing is de manier waarop de webserver en jouw programma weet welke pagina er moet worden getoond. Kijk maar eens goed naar de URL in je browser. Je kunt de URL opdelen in 5 stukjes:

[![image-1594292626981.png](https://www.roc.ovh/uploads/images/gallery/2020-07/scaled-1680-/image-1594292626981.png)](https://www.roc.ovh/uploads/images/gallery/2020-07/image-1594292626981.png)

<table border="1" id="bkmrk-onderdeel-wat-is-het" style="border-collapse: collapse; width: 100%;"><tbody><tr><td style="width: 12.8395%; background-color: #d0d0d0;">Onderdeel</td><td style="width: 24.9382%; background-color: #d0d0d0;">Wat is het?</td><td style="width: 62.2222%; background-color: #d0d0d0;">Uitleg</td></tr><tr><td style="width: 12.8395%;">Scheme</td><td style="width: 24.9382%;">protocol</td><td style="width: 62.2222%;">hoe wordt de informatie verzonden (http, https, ftp, smb, file, ...)</td></tr><tr><td style="width: 12.8395%;">domain name</td><td style="width: 24.9382%;">domein</td><td style="width: 62.2222%;">domein verwijst naar een server of een groep servers.</td></tr><tr><td style="width: 12.8395%;">file path</td><td style="width: 24.9382%;">path</td><td style="width: 62.2222%;">verijst naar de file die de webserver moet 'uitvoeren'</td></tr><tr><td style="width: 12.8395%;">parameters</td><td style="width: 24.9382%;">variabelen</td><td style="width: 62.2222%;">hiermee kun je informatie naar de webserver sturen.</td></tr><tr><td style="width: 12.8395%;">anchor</td><td style="width: 24.9382%;">verwijzing binnen de pagina</td><td style="width: 62.2222%;">hiermee kun je naar een onderdeel van de pagina springen.  
Voorbeeld: https://www.roc.ovh/link/302#bkmrk-nog-een-keer-in-sche</td></tr></tbody></table>

Het schema bepaald hoe de informatie wordt opgevraagd (bij een webserver is dit meestal http en https). De domain name is de naam van de server(s). Het file path verteld de server welke informatie er moet worden getoond. De parameters zijn variabele die mee kunnen worden gegeven bijvoorbeeld om waarden die een gebruiker heeft ingevoerd naar de webserver te sturen. Tot slotte is het anchor (weinig gebruikt) een verwijzing naar een stukje binnen een pagina.

Normaal gesproken komt het file path overeen met de locatie van de bestanden op de server. Het file path is het path vanaf de document root. Stel de document root staat op jouw laptop naar:

c:\\www

Je hebt XAMPP opgestart en je gaat naar:

[http://localhost/opgave1/uitslag/index.php](http://localhost/opgave1/uitslag/index.php)

Dan wordt de file

c:\\www\\opgave1\\uitslag\\index.php

door de webserver uitgevoerd. Het file path wordt dus achter de *document root* geplaatst

#### Hoe kom je van de URL in je browser naar de file op jouw laptop?

[![image-1613336806883.png](https://www.roc.ovh/uploads/images/gallery/2021-02/scaled-1680-/image-1613336806883.png)](https://www.roc.ovh/uploads/images/gallery/2021-02/image-1613336806883.png)

Met routing zorg je ervoor dat je ergens een vertaling wordt gemaakt tussen het URL en de file PHP die moet worden uitgevoerd.

Alles wat hierboven is beschreven is de *standaard* routing. Zo werkt het op jouw laptop als je plain PHP gebruikt (dat is PHP zonder framework).

Routing zorgt ervoor dat het path en eventueel de parameters de juiste code uitvoeren. Bij eenvoudige web applicaties is het path gewoon de locatie van de file op de harddisk, maar voor meer ingewikkelde programma's kan dat al snel onoverzichtelijk worden.

Met een framework werkt het daarom anders.

### Routing in Yii

Standaard hoef je niets te doen voor routing. Er zit al heel veel voorgebakken in Yii.

Stel je typt in je browser in

localhost:8080/<span style="background-color: #ffcc00;">country</span>/<span style="background-color: #00ccff;">index</span>

Dit path bestaat uit twee delen; <span style="background-color: #ffcc00;">country</span> en <span style="background-color: #00ccff;">index</span>.  
<span style="background-color: #ffcc00;">country</span> verwijst naar controllers/<span style="background-color: #ffcc00;">Country</span>Controller en  
<span style="background-color: #00ccff;">index</span> verwijst naar de public function action<span style="background-color: #00ccff;">Index</span> in de class <span style="background-color: #ffcc00;">Country</span>Controller.

Het path bestaat in Yii uit twee delen, de verwijzing naar de controller en de verwijzing naar de functie/method.

De vertaling van path naar controller en function/method gaat als volgt:

1. het eerste deel van het path is de controller-naam, maar 
    1. de controller-naam begint altijd met een hoofdletter, en;
    2. als er een streepje (-) in het path staat dan is dat een nieuw woord en in de controller begint dit nieuwe woord met een hoofdletter. Voorbeeld: <span style="background-color: #ccffff;">dit-is-het-eerste-deel </span>wordt <span style="background-color: #ccffff;">DitIsHetEersteDeel</span>
2. Het tweede deel van het path wordt opdezelfde manier vertaald maar er wordt ook nog eens het woord action voorgezet. Voorbeeld: <span style="background-color: #ccffff;">dit-is-het-tweede-deel</span> wordt <span style="background-color: #ccffff;">actionDitIsHetTweedeDeel</span>

##### Een paar voorbeelden:

<table border="1" id="bkmrk-path-file-public-fun" style="border-collapse: collapse; width: 100%; height: 174px;"><tbody><tr style="height: 29px;"><td style="width: 33.3333%; background-color: #f0f0f0; height: 29px;">path</td><td style="width: 33.3333%; background-color: #f0f0f0; height: 29px;">file</td><td style="width: 33.3333%; background-color: #f0f0f0; height: 29px;">public function</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">/kaart/overzicht</td><td style="width: 33.3333%; height: 29px;">KaartController</td><td style="width: 33.3333%; height: 29px;">actionOverzicht</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">/klas-lokaal/overzicht</td><td style="width: 33.3333%; height: 29px;">klasLokaalController</td><td style="width: 33.3333%; height: 29px;">actionOverzicht</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">/klas-lokaal/stoel-maat</td><td style="width: 33.3333%; height: 29px;">klasLokaalController</td><td style="width: 33.3333%; height: 29px;">actionStoelMaat</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">/klas-lokaal/index</td><td style="width: 33.3333%; height: 29px;">klasLokaalController</td><td style="width: 33.3333%; height: 29px;">actionIndex</td></tr><tr style="height: 29px;"><td style="width: 33.3333%; height: 29px;">/klas-lokaal</td><td style="width: 33.3333%; height: 29px;">klasLokaalController</td><td style="width: 33.3333%; height: 29px;">actionIndex</td></tr></tbody></table>

Zoals is te zien in de laatste regel, wordt de actionIndex uitgevoerd als het tweede deel van het path ontbreekt.

### Oefening

We gaan in onze World-applicatie oefenen met routing

(1) Zet in de CountryController in de CountryController class een nieuwe public function:

```
public function actionHello() {
    echo "Hello World!";
    exit;
}
```

**Opdracht:** Save de aangepaste CountryController en bedenk met welke url je nu deze nieuwe functie (method) moet aanroepen.

Controleer dat, zodat je in jouw browser het volgende ziet:

[![image-1594296881002.png](https://www.roc.ovh/uploads/images/gallery/2020-07/scaled-1680-/image-1594296881002.png)](https://www.roc.ovh/uploads/images/gallery/2020-07/image-1594296881002.png)

(2) Maak een nieuwe file **controllers/ExampleController.php** en zet daar het volgende in.

```PHP
<?php

namespace app\controllers;

use Yii;
use yii\web\Controller;


/**
 * CountryController implements the CRUD actions for country model.
 */
class ExampleController extends Controller
{
  public function actionSay($message = 'empty')
  {
    echo "Hello $message";
    exit;
  }
}
```

**Opdracht:** Ga nu naar [http://localhost:8080/..............?message=friend](http://localhost:8080/..............?message=friend) maar vervang de puntjes zodat je de functie (method) actionSay van de ExampleController uit laat voeren.

**Opdracht:** Pas de parameter in de url aan zodat er op het scherm komt "Hello" gevolgd door jouw voornaam. Gebruik voor jouw naam één woord.

### Extra

In de [vorige les](https://www.roc.ovh/link/296#bkmrk-we-openen-de-file-co) hebben een instelling in de config/web.php aangepast. Hierdoor hebben we eenvoudige routing aan gezet. Als je dit uit zet dan werkt de routing iets anders. Voor nu niet belangrijk maar als je wilt weten hoe het precies zit, kijk dan naar dit Engelse Youtube filmpje: [https://www.youtube.com/watch?v=QcZiS43iVxU](https://www.youtube.com/watch?v=QcZiS43iVxU)

Verder is er nog meer informatie te vinden op de officiële Yii documentatie pagina's: [https://www.yiiframework.com/doc/guide/2.0/en/runtime-routing](https://www.yiiframework.com/doc/guide/2.0/en/runtime-routing)  
\--