Add initial support for opening a file in the file manager, still needs more work

app/Contracts/Repository/Daemon/FileRepositoryInterface.php

@@ -20,12 +20,11 @@ interface FileRepositoryInterface extends BaseRepositoryInterface
     /**
      * Return the contents of a given file if it can be edited in the Panel.
      *
-     * @param string $path
+     * @param string   $path
+     * @param int|null $notLargerThan
      * @return string
-     *
-     * @throws \GuzzleHttp\Exception\TransferException
      */
-    public function getContent(string $path): string;
+    public function getContent(string $path, int $notLargerThan = null): string;
 
     /**
      * Save new contents to a given file.

app/Http/Controllers/Api/Client/Servers/FileController.php

@@ -8,6 +8,7 @@ use Illuminate\Http\Response;
 use Pterodactyl\Models\Server;
 use Illuminate\Http\JsonResponse;
 use Illuminate\Contracts\Cache\Repository as CacheRepository;
+use Illuminate\Contracts\Config\Repository as ConfigRepository;
 use Pterodactyl\Http\Controllers\Api\Client\ClientApiController;
 use Pterodactyl\Contracts\Repository\Daemon\FileRepositoryInterface;
 use Pterodactyl\Http\Requests\Api\Client\Servers\Files\CopyFileRequest;
@@ -16,6 +17,7 @@ use Pterodactyl\Http\Requests\Api\Client\Servers\Files\DeleteFileRequest;
 use Pterodactyl\Http\Requests\Api\Client\Servers\Files\RenameFileRequest;
 use Pterodactyl\Http\Requests\Api\Client\Servers\Files\CreateFolderRequest;
 use Pterodactyl\Http\Requests\Api\Client\Servers\Files\DownloadFileRequest;
+use Pterodactyl\Http\Requests\Api\Client\Servers\Files\GetFileContentsRequest;
 
 class FileController extends ClientApiController
 {
@@ -24,6 +26,11 @@ class FileController extends ClientApiController
      */
     private $cache;
 
+    /**
+     * @var \Illuminate\Contracts\Config\Repository
+     */
+    private $config;
+
     /**
      * @var \Pterodactyl\Contracts\Repository\Daemon\FileRepositoryInterface
      */
@@ -32,14 +39,16 @@ class FileController extends ClientApiController
     /**
      * FileController constructor.
      *
+     * @param \Illuminate\Contracts\Config\Repository                          $config
      * @param \Pterodactyl\Contracts\Repository\Daemon\FileRepositoryInterface $fileRepository
      * @param \Illuminate\Contracts\Cache\Repository                           $cache
      */
-    public function __construct(FileRepositoryInterface $fileRepository, CacheRepository $cache)
+    public function __construct(ConfigRepository $config, FileRepositoryInterface $fileRepository, CacheRepository $cache)
     {
         parent::__construct();
 
         $this->cache = $cache;
+        $this->config = $config;
         $this->fileRepository = $fileRepository;
     }
 
@@ -55,9 +64,25 @@ class FileController extends ClientApiController
             'contents' => $this->fileRepository->setServer($request->getModel(Server::class))->getDirectory(
                 $request->get('directory') ?? '/'
             ),
+            'editable' => $this->config->get('pterodactyl.files.editable', []),
         ]);
     }
 
+    /**
+     * Return the contents of a specified file for the user.
+     *
+     * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\GetFileContentsRequest $request
+     * @return \Illuminate\Http\Response
+     */
+    public function getFileContents(GetFileContentsRequest $request): Response
+    {
+        return Response::create(
+            $this->fileRepository->setServer($request->getModel(Server::class))->getContent(
+                $request->get('file'), $this->config->get('pterodactyl.files.max_edit_size')
+            )
+        );
+    }
+
     /**
      * Creates a new folder on the server.
      *

app/Http/Requests/Api/Client/Servers/Files/GetFileContentsRequest.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace Pterodactyl\Http\Requests\Api\Client\Servers\Files;
+
+use Pterodactyl\Contracts\Http\ClientPermissionsRequest;
+use Pterodactyl\Http\Requests\Api\Client\ClientApiRequest;
+
+class GetFileContentsRequest extends ClientApiRequest implements ClientPermissionsRequest
+{
+    /**
+     * Returns the permissions string indicating which permission should be used to
+     * validate that the authenticated user has permission to perform this action aganist
+     * the given resource (server).
+     *
+     * @return string
+     */
+    public function permission(): string
+    {
+        return 'edit-files';
+    }
+
+    /**
+     * @return array
+     */
+    public function rules(): array
+    {
+        return [
+            'file' => 'required|string',
+        ];
+    }
+}

app/Repositories/Wings/FileRepository.php

@@ -3,7 +3,9 @@
 namespace Pterodactyl\Repositories\Wings;
 
 use stdClass;
+use Exception;
 use Psr\Http\Message\ResponseInterface;
+use Pterodactyl\Exceptions\Http\Server\FileSizeTooLargeException;
 use Pterodactyl\Contracts\Repository\Daemon\FileRepositoryInterface;
 
 class FileRepository extends BaseWingsRepository implements FileRepositoryInterface
@@ -14,28 +16,47 @@ class FileRepository extends BaseWingsRepository implements FileRepositoryInterf
      * @param string $path
      * @return \stdClass
      *
+     * @throws \Exception
      * @throws \GuzzleHttp\Exception\TransferException
      */
     public function getFileStat(string $path): stdClass
     {
-        // TODO: Implement getFileStat() method.
+        throw new Exception('Function not implemented.');
     }
 
     /**
-     * Return the contents of a given file if it can be edited in the Panel.
+     * Return the contents of a given file.
      *
-     * @param string $path
+     * @param string   $path
+     * @param int|null $notLargerThan the maximum content length in bytes
      * @return string
      *
      * @throws \GuzzleHttp\Exception\TransferException
+     * @throws \Pterodactyl\Exceptions\Http\Server\FileSizeTooLargeException
      */
-    public function getContent(string $path): string
+    public function getContent(string $path, int $notLargerThan = null): string
     {
-        // TODO: Implement getContent() method.
+        $response = $this->getHttpClient()->get(
+            sprintf('/api/servers/%s/files/contents', $this->getServer()->uuid),
+            [
+                'query' => ['file' => $path],
+            ]
+        );
+
+        $length = (int) $response->getHeader('Content-Length')[0] ?? 0;
+
+        if ($notLargerThan && $length > $notLargerThan) {
+            throw new FileSizeTooLargeException(
+                trans('server.files.exceptions.max_size')
+            );
+        }
+
+        return $response->getBody()->__toString();
     }
 
     /**
-     * Save new contents to a given file.
+     * Save new contents to a given file. This works for both creating and updating
+     * a file.
      *
      * @param string $path
      * @param string $content
@@ -45,7 +66,13 @@ class FileRepository extends BaseWingsRepository implements FileRepositoryInterf
      */
     public function putContent(string $path, string $content): ResponseInterface
     {
-        // TODO: Implement putContent() method.
+        return $this->getHttpClient()->post(
+            sprintf('/api/servers/%s/files/write', $this->getServer()->uuid),
+            [
+                'query' => ['file' => $path],
+                'body' => $content,
+            ]
+        );
     }
 
     /**
@@ -59,9 +86,10 @@ class FileRepository extends BaseWingsRepository implements FileRepositoryInterf
     public function getDirectory(string $path): array
     {
         $response = $this->getHttpClient()->get(
-        // Reason for the path check is because it is unnecessary on the Daemon but we need
-        // to respect the interface.
-            sprintf('/api/servers/%s/files/list/%s', $this->getServer()->uuid, $path === '/' ? '' : $path)
+            sprintf('/api/servers/%s/files/list-directory', $this->getServer()->uuid),
+            [
+                'query' => ['directory' => $path],
+            ]
         );
 
         return json_decode($response->getBody(), true);