IRequest::getFile() accepts an array of keys like Request::getFile() (BC break) [Closes #214]

Author: dg

src/Http/IRequest.php

@@ -68,8 +68,9 @@ function getPost(?string $key = null): mixed;
 	/**
 	 * Returns the uploaded file for the given key, or null if not present.
 	 * Accepts a string key or an array of keys for nested file structures (e.g. ['form', 'avatar']).
+	 * @param  string|string[]  $key
 	 */
-	function getFile(string $key): ?FileUpload;
+	function getFile(string|array $key): ?FileUpload;
 
 	/**
 	 * Returns the tree of uploaded files, with each leaf being a FileUpload instance.

src/Http/Request.php

@@ -112,7 +112,7 @@ public function getPost(?string $key = null): mixed
 	 * Accepts a string key or an array of keys for nested file structures (e.g. ['form', 'avatar']).
 	 * @param  string|string[]  $key
 	 */
-	public function getFile($key): ?FileUpload
+	public function getFile(string|array $key): ?FileUpload
 	{
 		$res = Nette\Utils\Arrays::get($this->files, $key, null);
 		return $res instanceof FileUpload ? $res : null;

tests/Http/Request.files.phpt

@@ -109,3 +109,7 @@ Assert::true(isset($request->files['file1']));
 
 Assert::null($request->getFile('empty1'));
 Assert::null($request->getFile('empty2'));
+
+Assert::same($request->files['file3']['y']['z'], $request->getFile(['file3', 'y', 'z']));
+Assert::null($request->getFile(['file3', 'y']));
+Assert::null($request->getFile(['file3', 'x']));