Bummer! This is just a preview. You need to be signed in with a Basic account to view the entire video.

Preview

Start a free Basic trial
to watch this video

Sign up for Treehouse

Route Groups

4:46 with Alena Holligan

Since I want all my endpoints to be within the /api/v1/courses route, I can make a route group. Within that group, I can add my routes without having to include the /api/v1/courses every time.

To help organize routes into logical groups, the \Slim\App also provides a group() method. Each group’s route pattern is prepended to the routes or groups contained within it, and any placeholder arguments in the group pattern are ultimately made available to the nested routes.

  • 0:00

    Since I want all my API end points to be within the API v1 courses route,

  • 0:09

    I can make a route group, app->group.

  • 0:14

    And we say ('/api/v1/courses',

  • 0:22

    function() use ($app)).

  • 0:32

    And we'll put our other route within this group.

  • 0:39

    We have the courses route, but I don't want to append anything to my route,

  • 0:44

    I just want to use the APIv1 courses.

  • 0:47

    So instead of courses here, I'm just going to use an empty string.

  • 0:51

    If I put a slash here,

  • 0:53

    it would only work with the slash appended to the end of courses.

  • 0:58

    If I want it to work with or

  • 1:00

    without a trailing slash, I could add some middle ware.

  • 1:04

    Check the notes for more information.

  • 1:06

    Let's check this in a browser again.

  • 1:12

    Api/v1/courses.

  • 1:17

    Great, my courses are showing.

  • 1:21

    Let's add the rest of the get route.

  • 1:25

    I'll duplicate this route to build my next get route.

  • 1:32

    We're going to add the course_id.

  • 1:36

    This is going to get a single course.

  • 1:39

    So we get a single course and pass the ($args['course_id']).

  • 1:47

    We also want to be able to get our reviews.

  • 1:50

    These reviews will all reference a single course, so

  • 1:55

    we can create a second group within our first group.

  • 2:02

    $app->group, and

  • 2:06

    we'll add the course_id and reviews.

  • 2:19

    We'll use the app, And then end our semicolon.

  • 2:25

    Now we can copy our route to get a single course.

  • 2:31

    We'll paste this within our reviews group, and we'll change it,

  • 2:39

    To getReviews, ByCourseId.

  • 2:48

    We don't need this course_id since the course_id is within our group.

  • 2:53

    Instead of course, we need to change this to review.

  • 3:00

    Now for our final get route, we can copy this route,

  • 3:08

    And we'll use it to select our single review.

  • 3:12

    So we'll add review_id.

  • 3:17

    $this->review->getReview, and

  • 3:21

    we'll pass the review_id.

  • 3:25

    Let's take a look at these requests in the browser.

  • 3:31

    We have our courses.

  • 3:35

    We have our single course.

  • 3:42

    And our reviews have not been defined.

  • 3:46

    We have our review model, but let's add it to our dependencies.

  • 3:56

    We'll need a new container for review.

  • 4:08

    And we'll close our semicolon.

  • 4:09

    We'll return our new App\Model\Review.

  • 4:16

    And again, pass the get('db')).

  • 4:25

    Now we can see our reviews, And a single review.

  • 4:32

    A browser isn't really designed to test API calls, so for

  • 4:36

    our other HTTP requests, we're going to jump into a program called Postman,

  • 4:42

    which gives us easy access to the request and response.

You need to sign up for Treehouse in order to download course files.

Sign up