| 1 |
<?php |
| 2 |
|
| 3 |
// File generated from our OpenAPI spec |
| 4 |
|
| 5 |
namespace Stripe\Service; |
| 6 |
|
| 7 |
class FileService extends \Stripe\Service\AbstractService |
| 8 |
{ |
| 9 |
/** |
| 10 |
* Returns a list of the files that your account has access to. The files are |
| 11 |
* returned sorted by creation date, with the most recently created files appearing |
| 12 |
* first. |
| 13 |
* |
| 14 |
* @param null|array $params |
| 15 |
* @param null|array|\Stripe\Util\RequestOptions $opts |
| 16 |
* |
| 17 |
* @throws \Stripe\Exception\ApiErrorException if the request fails |
| 18 |
* |
| 19 |
* @return \Stripe\Collection<\Stripe\File> |
| 20 |
*/ |
| 21 |
public function all($params = null, $opts = null) |
| 22 |
{ |
| 23 |
return $this->requestCollection('get', '/v1/files', $params, $opts); |
| 24 |
} |
| 25 |
|
| 26 |
/** |
| 27 |
* Retrieves the details of an existing file object. Supply the unique file ID from |
| 28 |
* a file, and Stripe will return the corresponding file object. To access file |
| 29 |
* contents, see the <a href="/docs/file-upload#download-file-contents">File Upload |
| 30 |
* Guide</a>. |
| 31 |
* |
| 32 |
* @param string $id |
| 33 |
* @param null|array $params |
| 34 |
* @param null|array|\Stripe\Util\RequestOptions $opts |
| 35 |
* |
| 36 |
* @throws \Stripe\Exception\ApiErrorException if the request fails |
| 37 |
* |
| 38 |
* @return \Stripe\File |
| 39 |
*/ |
| 40 |
public function retrieve($id, $params = null, $opts = null) |
| 41 |
{ |
| 42 |
return $this->request('get', $this->buildPath('/v1/files/%s', $id), $params, $opts); |
| 43 |
} |
| 44 |
|
| 45 |
/** |
| 46 |
* Create a file. |
| 47 |
* |
| 48 |
* @param null|array $params |
| 49 |
* @param null|array|\Stripe\Util\RequestOptions $opts |
| 50 |
* |
| 51 |
* @return \Stripe\File |
| 52 |
*/ |
| 53 |
public function create($params = null, $opts = null) |
| 54 |
{ |
| 55 |
$opts = \Stripe\Util\RequestOptions::parse($opts); |
| 56 |
if (!isset($opts->apiBase)) { |
| 57 |
$opts->apiBase = $this->getClient()->getFilesBase(); |
| 58 |
} |
| 59 |
|
| 60 |
// Manually flatten params, otherwise curl's multipart encoder will |
| 61 |
// choke on nested null|arrays. |
| 62 |
$flatParams = \array_column(\Stripe\Util\Util::flattenParams($params), 1, 0); |
| 63 |
|
| 64 |
return $this->request('post', '/v1/files', $flatParams, $opts); |
| 65 |
} |
| 66 |
} |
| 67 |
|
