davidsneighbour / dropbox-php-sdk

     *

     * @return \Dropbox\Models\MetadataCollection

     */

    public function listFolder(string $path = '', array $params = [])

    {

        //Specify the root folder as an

        //empty string rather than as "/"

        if ($path === '/') {

            $path = "";

        }

        //Set the path

        $params['path'] = $path;

        //Get File Metadata

        $response = $this->postToAPI('/files/list_folder', $params);

        //Make and Return the Model

        return $this->makeModelFromResponse($response);

    }

    /**

     * Paginate through all files and retrieve updates to the folder,

     *

     * @return \Dropbox\Models\SearchResults

     */

    public function search(string $path = '', $query, array $params = [])

    {

        //Specify the root folder as an

        //empty string rather than as "/"

        if ($path === '/') {

            $path = "";

        }

        //Set the path and query

        $params['path'] = $path;

        $params['query'] = $query;

        //Fetch Search Results

        $response = $this->postToAPI('/files/search', $params);

        //Make and Return the Model

        return $this->makeModelFromResponse($response);

    }

    /**

     * Create a folder at the given path

     * @link https://www.dropbox.com/developers/documentation/http/documentation#files-get_metadata

     *

     */

    public function getMetadata(string $path = '', array $params = [])

    {

        //Root folder is unsupported

        if ('/' === $path || '' === $path) {

            throw new DropboxClientException("Metadata for the root folder is unsupported.");

        }

        //Set the path

        $params['path'] = $path;

        //Get File Metadata

        $response = $this->postToAPI('/files/get_metadata', $params);

        //Make and Return the Model

        return $this->makeModelFromResponse($response);

    }

    /**

     * Make a HTTP POST Request to the API endpoint type