fileRepository = $fileRepository; $this->responseFactory = $responseFactory; $this->jwtService = $jwtService; } /** * Returns a listing of files in a given directory. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\ListFilesRequest $request * @param \Pterodactyl\Models\Server $server * @return array * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function directory(ListFilesRequest $request, Server $server): array { $contents = $this->fileRepository ->setServer($server) ->getDirectory($this->encode($request->get('directory') ?? '/')); return $this->fractal->collection($contents) ->transformWith($this->getTransformer(FileObjectTransformer::class)) ->toArray(); } /** * Return the contents of a specified file for the user. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\GetFileContentsRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\Response * * @throws \Pterodactyl\Exceptions\Http\Server\FileSizeTooLargeException * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function contents(GetFileContentsRequest $request, Server $server): Response { return new Response( $this->fileRepository->setServer($server)->getContent( $this->encode($request->get('file')), config('pterodactyl.files.max_edit_size') ), Response::HTTP_OK, ['Content-Type' => 'text/plain'] ); } /** * Generates a one-time token with a link that the user can use to * download a given file. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\GetFileContentsRequest $request * @param \Pterodactyl\Models\Server $server * @return array * * @throws \Exception */ public function download(GetFileContentsRequest $request, Server $server) { $token = $this->jwtService ->setExpiresAt(CarbonImmutable::now()->addMinutes(15)) ->setClaims([ 'file_path' => rawurldecode($request->get('file')), 'server_uuid' => $server->uuid, ]) ->handle($server->node, $request->user()->id . $server->uuid); return [ 'object' => 'signed_url', 'attributes' => [ 'url' => sprintf( '%s/download/file?token=%s', $server->node->getConnectionAddress(), $token->__toString() ), ], ]; } /** * Writes the contents of the specified file to the server. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\WriteFileContentRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\JsonResponse * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function write(WriteFileContentRequest $request, Server $server): JsonResponse { $this->fileRepository->setServer($server)->putContent( $this->encode($request->get('file')), $request->getContent() ); return new JsonResponse([], Response::HTTP_NO_CONTENT); } /** * Creates a new folder on the server. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\CreateFolderRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\JsonResponse * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function create(CreateFolderRequest $request, Server $server): JsonResponse { $this->fileRepository ->setServer($server) ->createDirectory($request->input('name'), $request->input('root', '/')); return new JsonResponse([], Response::HTTP_NO_CONTENT); } /** * Renames a file on the remote machine. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\RenameFileRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\JsonResponse * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function rename(RenameFileRequest $request, Server $server): JsonResponse { $this->fileRepository ->setServer($server) ->renameFiles($request->input('root'), $request->input('files')); return new JsonResponse([], Response::HTTP_NO_CONTENT); } /** * Copies a file on the server. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\CopyFileRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\JsonResponse * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function copy(CopyFileRequest $request, Server $server): JsonResponse { $this->fileRepository ->setServer($server) ->copyFile($request->input('location')); return new JsonResponse([], Response::HTTP_NO_CONTENT); } /** * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\CompressFilesRequest $request * @param \Pterodactyl\Models\Server $server * @return array * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function compress(CompressFilesRequest $request, Server $server): array { // Allow up to five minutes for this request to process before timing out. set_time_limit(300); $file = $this->fileRepository->setServer($server) ->compressFiles( $request->input('root'), $request->input('files') ); return $this->fractal->item($file) ->transformWith($this->getTransformer(FileObjectTransformer::class)) ->toArray(); } /** * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\DecompressFilesRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\JsonResponse * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function decompress(DecompressFilesRequest $request, Server $server): JsonResponse { // Allow up to five minutes for this request to process before timing out. set_time_limit(300); $this->fileRepository->setServer($server) ->decompressFile($request->input('root'), $request->input('file')); return new JsonResponse([], JsonResponse::HTTP_NO_CONTENT); } /** * Deletes files or folders for the server in the given root directory. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\DeleteFileRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\JsonResponse * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function delete(DeleteFileRequest $request, Server $server): JsonResponse { $this->fileRepository->setServer($server) ->deleteFiles( $request->input('root'), $request->input('files') ); return new JsonResponse([], Response::HTTP_NO_CONTENT); } /** * Updates file permissions for file(s) in the given root directory. * * @param \Pterodactyl\Http\Requests\Api\Client\Servers\Files\ChmodFilesRequest $request * @param \Pterodactyl\Models\Server $server * @return \Illuminate\Http\JsonResponse * * @throws \Pterodactyl\Exceptions\Http\Connection\DaemonConnectionException */ public function chmod(ChmodFilesRequest $request, Server $server): JsonResponse { $this->fileRepository->setServer($server) ->chmodFiles( $request->input('root'), $request->input('files') ); return new JsonResponse([], Response::HTTP_NO_CONTENT); } /** * Encodes a given file name & path in a format that should work for a good majority * of file names without too much confusing logic. * * @param string $path * @return string */ private function encode(string $path): string { return Collection::make(explode('/', rawurldecode($path)))->map(function ($value) { return rawurlencode($value); })->join('/'); } }