Merge pull request #8253 from kenjis/docs-restful-controller-ns

docs: fix incorrect sample code in restful.rst

user_guide_src/source/incoming/restful.rst

@@ -52,6 +52,12 @@ the controller that should be used:
 
 .. literalinclude:: restful/003.php
 
+.. literalinclude:: restful/017.php
+
+.. literalinclude:: restful/018.php
+
+See also :ref:`controllers-namespace`.
+
 Change the Placeholder Used
 ===========================
 
@@ -122,6 +128,12 @@ the controller that should be used:
 
 .. literalinclude:: restful/011.php
 
+.. literalinclude:: restful/019.php
+
+.. literalinclude:: restful/020.php
+
+See also :ref:`controllers-namespace`.
+
 Change the Placeholder Used
 ===========================
 

user_guide_src/source/incoming/restful/003.php

@@ -1,6 +1,5 @@
 <?php
 
-$routes->resource('photos', ['controller' => 'App\Gallery']);
-
+$routes->resource('photos', ['controller' => 'Gallery']);
 // Would create routes like:
-$routes->get('photos', 'App\Gallery::index');
+$routes->get('photos', '\App\Controllers\Gallery::index');

user_guide_src/source/incoming/restful/011.php

@@ -1,6 +1,5 @@
 <?php
 
-$routes->presenter('photos', ['controller' => 'App\Gallery']);
-
+$routes->presenter('photos', ['controller' => 'Gallery']);
 // Would create routes like:
-$routes->get('photos', 'App\Gallery::index');
+$routes->get('photos', '\App\Controllers\Gallery::index');

user_guide_src/source/incoming/restful/017.php

@@ -0,0 +1,5 @@
+<?php
+
+$routes->resource('photos', ['controller' => '\App\Gallery']);
+// Would create routes like:
+$routes->get('photos', '\App\Gallery::index');

user_guide_src/source/incoming/restful/018.php

@@ -0,0 +1,7 @@
+<?php
+
+use App\Controllers\Gallery;
+
+$routes->resource('photos', ['namespace' => '', 'controller' => Gallery::class]);
+// Would create routes like:
+$routes->get('photos', '\App\Controllers\Gallery::index');

user_guide_src/source/incoming/restful/019.php

@@ -0,0 +1,5 @@
+<?php
+
+$routes->presenter('photos', ['controller' => '\App\Gallery']);
+// Would create routes like:
+$routes->get('photos', '\App\Gallery::index');

user_guide_src/source/incoming/restful/020.php

@@ -0,0 +1,7 @@
+<?php
+
+use App\Controllers\Gallery;
+
+$routes->presenter('photos', ['namespace' => '', 'controller' => Gallery::class]);
+// Would create routes like:
+$routes->get('photos', '\App\Controllers\Gallery::index');

user_guide_src/source/incoming/routing.rst

@@ -83,6 +83,8 @@ You can supply multiple verbs that a route should match by passing them in as an
 Specifying Route Handlers
 =========================
 
+.. _controllers-namespace:
+
 Controller's Namespace
 ----------------------