Folders can be requested and item collections in those folders can be…

… obtained.

composer.json

@@ -3,8 +3,8 @@
     "description": "A PHP Box package.",
     "type": "library",
     "require": {
-        "guzzlehttp/guzzle": "^6.3@dev",
-        "firebase/php-jwt": "dev-master",
+        "guzzlehttp/guzzle": "^6.3.3",
+        "firebase/php-jwt": "5.0.0",
         "php": ">=7.0"
     },
     "license": "GPL-3.0-only",

src/Box.php

@@ -2,8 +2,10 @@
 
 namespace PhpBox;
 use PhpBox\Config\Config;
+use PhpBox\Items\{Folder};
 
 class Box {
+  private $baseUrl = "https://api.box.com/2.0/";
   private $AccessToken;
   private $config;
 
@@ -28,16 +30,58 @@ public function requestAccessToken() {
         'client_secret' => $appDetails->Secret
       ]
     ]);
-    $data = $response->getBody()->getContents();
-    $this->AccessToken = new Token(json_decode($data));
+    if($this->handleResponse($response)) {
+      $data = $response->getBody()->getContents();
+      $this->AccessToken = new Token(json_decode($data));
+    }
+    return false;
   }
 
   public function getAccessToken() {
     return $this->AccessToken;
   }
 
-  public function requestFolder($id, $findpath = false) {
-
+  public function getValidAccessToken() {
+    if(!Token::isValid($this->AccessToken)) {
+      $this->requestAccessToken();
+    }
+    return $this->AccessToken;
+  }
+
+  public function requestFolder($id = "0", $fields = []) {
+    $client = new \GuzzleHttp\Client();
+    $headers = $this->getDefaultHeaders();
+    $query = [];
+    if(!empty($fields)) {
+      $query['fields'] = implode(",", $fields);
+    }
+    $response = $client->request('GET', $this->baseUrl."folders/$id", [
+      'headers' => $headers,
+      'query' => $query
+    ]);
+    if($this->handleResponse($response)){
+      return new Folder(json_decode($response->getBody()->getContents()));
+    }
+    return false;
+  }
+
+  public function getDefaultHeaders() {
+    $token = $this->getValidAccessToken();
+    return [
+        'Authorization' => "Bearer $token",
+        'Accept'        => 'application/json',
+    ];
+  }
+
+  public function handleResponse(\GuzzleHttp\Psr7\Response $response) {
+    $statusCode = $response->getStatusCode();
+    switch($statusCode) {
+      case 200:
+        return true;
+      default:
+        throw new \Exception("Uncaught response code $statusCode");
+    }
+    return true;
   }
 }
 

src/Items/Folder.php

@@ -0,0 +1,27 @@
+<?php
+
+namespace PhpBox\Items;
+
+class Folder extends Item {
+  protected $contains = [];
+
+  public function __construct($data) {
+    parent::__construct($data);
+    if(isset($data->item_collection)) {
+      foreach ($data->item_collection->entries as $key => $value) {
+        $this->contains[] = new Item($value);
+      }
+    }
+  }
+
+  public function getItems() {
+    return $this->contains;
+  }
+
+  public function getFiles() {
+    return array_filter($this->contains, function($x) {return $x->isFile();});
+  }
+
+}
+
+?>

src/Items/Item.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace PhpBox\Items;
+
+class Item implements ItemInterface {
+  protected $data;
+  protected $id;
+  protected $type;
+
+  public function __construct($data) {
+    $this->data = $data;
+    $this->type = $data->type;
+    $this->id = $data->id;
+  }
+
+  public function isFolder() {
+    return $this->type == 'folder';
+  }
+
+  public function isFile() {
+    return $this->type == 'file';
+  }
+}
+
+?>

src/Items/ItemInterface.php

@@ -0,0 +1,9 @@
+<?php
+
+namespace PhpBox\Items;
+
+interface ItemInterface {
+
+}
+
+?>