1. Levate l'ancora!
Rotte senza problemi con ZF2
Zend Framework DAY, Milano - Italia 01-02-2013

2. Diego Drigani

3. @drigani

4. http://www.mvassociati.it/

5. http://friuli.grusp.org/

6. COS’È IL ROUTING?

7. Partiamo da una richiesta
http://sales.it/products/smartphones

8. Principio fondamentale di routing
• Matching di una richiesta ed estrazione
dei parametri
• Assembling di nuove richieste

9. Under the hood
namespace ZendMvcRouter;
use ZendStdlibRequestInterface as Request;
interface RouteInterface
{
public static function factory($options = array());
public function match(Request $request);
public function assemble(
array $params = array(),
array $options = array());
}

10. PERCHÈ IL ROUTING
È IMPORTANTE?

11. USER FRIENDLY URL

12. SEO FRIENDLY URL

13. MAGGIOR SICUREZZA

14. RESTFUL SERVICES API

15. TIPI DI ROTTE

16. Richiesta
http://www.zfday.it/about-us
http://www.zfday.it/about-us
16

17. Literal route
• Il più semplice
• Fa il matching/assembling letterale di una
stringa
• Non fa matching di alcun parametro
17

18. Literal route (esempio)
array(
'about' => array(
'type' => 'Literal',
'options' => array(
'route' => '/about-us',
'defaults' => array(
'controller' => 'Pages',
'action' => 'about-us',
)
)
)
)

19. Richiesta
http://www.hubme.in/get/events.rss
http://www.hubme.in/get/events.rss
http://www.hubme.in/get/cfps.atom
19

20. Regex route
• Il tipo di rotta parameter-matching più
veloce
• Il matching basato su regexp
• Fa l’assembling sulla base di un
replacement pattern
20

21. Regex route (esempio)
array(
'get' => array(
'type' => 'Regex',
'options' => array(
'regex'=>
/* Definizione di Named Sub patterns, ad es:
?<type> e ?<format> */
/get/(?<type>(events|cfps))(.(?<format>(atom|rss)))?',
'defaults' => array(
'controller' => 'Api',
'action' => 'get',
),
//Usato al momento dell’assemble
'spec' => '/get/%type%.%format%',
)
)
)

22. Richiesta
http://sale.it/catalog?brand=epson&priceto=20
0
http://sale.it/catalog?brand=epson&priceto=200
22

23. Query route
• Consente di specificare e catturare
parametri della query string
• L’idea è che venga usata come
child_route di un’altra rotta.
23

24. Query route (esempio)
array(
//...
'catalog_query' => array(
'type' => 'Query'
)
)

25. Richiesta
http://sale.it/catalog
http://sale.it/catalog
http://sale.it/catalog/electronics
http://sale.it/catalog/electronics
http://sale.it/catalog/electronics/smartphones
http://sale.it/catalog/electronics/smartphones
25

26. Segment route
• Il tipo più flessibile
• Matching molto veloce, giacchè i segment
patterns sono internamente convertiti in
regexp
• Fornisce il matching dei parametri basato
su delimeters e constraints
• Consente segmenti opzionali (letterali e
segmenti)
26

27. Segment route (esempio)
array(
'catalog' => array(
'type' => 'Segment',
'options' => array(
'route' => '/catalog[/:category[/:subcategory]]',
'constraints' => array(
‘category‘ => '[a-zA-Z][a-zA-Z0-9._-]*',
‘subcategory' => '[a-zA-Z][a-zA-Z0-9._-]*',
),
'defaults' => array(
'controller' => 'Catalog',
'action' => 'index',
)
)
)
)

28. Struttura segment patterns
• I segmenti opzionali
– Sono indicati tra parentesi quadre
– Possono essere annidati
– Possono contenere letterali e parametri
• Il delimitatore di default per i parametri è
la barra, ma può essere modificato con
parentesi graffe
28

29. Segment patterns (esempio)
• /events[/page-:id]
– Matches:
• /events
• /events/page-1
29

30. Segment patterns (esempio)
• /events/[page-:id]
– Matches:
• /events/
• /events/page-1
30

31. Combinando alcune rotte
array(
'catalog' => array(
'type' => 'Literal',
'options' => array(
'route' => '/catalog',
'defaults' => array(
'controller' => 'Catalog',
'action' => 'index',
)
),
'may_terminate' => true,
'child_routes' => array(
'category' => array(
'type' => 'Segment',
'options' => array(
'route' => '/:category',
//...
)
)
) …

32. TIPI AVANZATI DI ROTTE

33. Matching fuori dal path
• Hostname route
– :user.users.cpanel.it
• diego.users.cpanel.it
• Scheme route
– http, https, ...
• Method route
– GET, POST, PUT, ...
33

34. ROUTING NELLE APPLICAZIONI

35. Definizione delle rotte
//module.config.php
return array(
'router' => array(
'routes' => array(
// ...
)
)
);

36. I parametri dal controller
class ZfdayController extends AbstractActionController
{
public function indexAction()
{
$id = $this->params('id'/*, null */);
}
}

37. Redirect
class ZfdayController extends AbstractActionController
{
public function indexAction()
{
$this->redirect()->toRoute(
'routeName',
array(), // Params
array() // Options
);
}
}

38. Assembling URLs nel controller
class ZfdayController extends AbstractActionController
{
public function indexAction()
{
$url = $this->url()->fromRoute(
'routeName',
array(), // Params
array() // Options
);
$this->redirect()->toUrl($url . '#anchorName');
}
}

39. Assembling URLs nella view
<a href="<?php echo $this->url(
'routeName',
array(), // Params
array() // Options
);?>">Some Link</a>

40. APPLICAZIONI CLI E ROUTING

41. Introduzione console routing
• ZF2 ha una integrazione nativa del MVC
con la console
• Permette di individuare controller e action
da eseguire a partire da un comando della
console
• Le action sono eseguite e il risultato è
mostrato nella console
41

42. Boostrapping ZF2
Create file: bin/ecommerce-console
#!/usr/bin/php
<?php
include __DIR__.'/../public/index.php';

43. CLI: controller esempio
class ProductsController extends AbstractActionController {
public function importAction() {
$request = $this->getRequest();
if (!$request instanceof ZendConsoleRequest){
throw new RuntimeException('only from console!');
}
//do products import
return 'Import done!';
}
public function updateAction() {
//do products update prices and stocks
return 'Update done!';
}
}

44. Definizione: console routing
array(
'router' => array(
'routes' => array(
// HTTP routes are defined here
)
),
'console' => array(
'router' => array(
'routes' => array(
// Console routes go here
)
)
)
)

45. CLI Routing: esempio
array(
'console' => array(
'router' => array(
'routes' => array(
'command_import' => array(
'type' => 'simple',
'options' => array(
'route' => 'import',
'defaults' => array(
'controller' => 'Products',
'action' => 'import',
)
)
)
)
)
)
)

46. CLI Routing: esempio

47. Conclusioni
• Il Routing è stato scritto da zero per ZF2
• E’ abbastanza simile a ZF1, ma i
meccanismi interni sono più coerenti,
performanti, e spesso più semplici.
• ZF2 ha una integrazione nativa del MVC
con la console
47

48. DOMANDE?

49. Grazie per l’attenzione!
Diego Drigani
@drigani
d.drigani@mvassociati.it

50. Photo Credits
• http://www.flickr.com/photos/calsid yrose/49 25267732/
• http://www.flickr.com/photos/wili/2692420732/
• http://www.flickr.com/photos/theseanster93/5 027792986/
• http://www.flickr.com/photos/ mcbarnicle/7291518436/
• http://www.flickr.com/photos/arthurfa varo/8383257 961/
• http://www.flickr.com/photos/alt- n-anela/6186835140
• http://www.flickr.com/photos/neil singapore/4236445041/
• http://www.flickr.com/photos/thecolormarlee/49617807 46/
50

51. Diego Drigani
@drigani
d.drigani@mvassociati.it