Upload více souborů, file[]

Přečetl jsem si tady na fóru hodně příspěvků o tom, že pro formulářové políčku typu upload nelze použít jméno se [] (např. image[]). Tím pádem se z jednoho políčka nevydoluje víc, než jeden soubor. A nějak cyklem procházet přes jména polí (image1, image2, …) mi přijde neohrabané.

Protože sám píšu aplikaci, která potřebuje nahrávat 0-X souborů zaráz, a protože podpora atributu multiple u nahrání souboru je v prohlížečích už solidní, hodně mi to překáželo. Rozhodl jsem se, že si přípíšu komponentu MultipleUpload, která bude defacto kopírovat chování komponenty Upload z nette formulářů.

Co funguje

• nahrání jednoho souboru
• nahrání více souborů z jednoho pole z prohlížečů s podporou (vše krom IE)
• všechny validační procedury by měly fungovat
• pravidlo isFilled kontroluje, zda existuje alespoň jeden soubor

Co nefunguje

• vložení více polí se stejným názvem (nette se brání více komponentám se stejným jménem) – snad to jde obejít přes javascriptové rozšížení formuláře, pak by to mělo nahrát více souborů i v IE
• pokud jeden soubor neprojde některým pravidlem, zahodí se všechny a nelze zjistit, který konkrétní sobour neprošel. Jen se standardně vypíše proč.

Jaký je výsledek

• ve formuláři se objeví input s názvem doplněným o [] a atributem multiple
• v poli formulářových dat je položka s názvem políčka (např. image), která obsahuje pole s jednotlivými uploady, a to i při jednom souboru.

<input type="file" class="text" name="image[]" id="..." data-nette-rules="..." multiple="multiple" />

Nette\ArrayHash(8) {
   description => "Text" (4)
   image => array(1) [
      0 => Nette\Http\FileUpload(5) {
         name private => "bw_hightrot.gif" (15)
         type private => "image/gif" (9)
         size private => 1628
         tmpName private => "C:\Windows\Temp\php989E.tmp" (27)
         error private => 0
      }
   ]
}

<?php
/*
* File MultiUpload.php
*/

namespace Nette\Forms\Controls;

use Nette,
		Nette\Http;

class MultiUploadControl extends UploadControl {

	public function getHtmlName() {
		return parent::getHtmlName() . '[]';
	}

	public function getControl() {
		return parent::getControl()->multiple(TRUE);
	}

	public function setValue($value) {
		foreach($value as $single) {
			if (is_array($single)) {
				$this->value[] = new Http\FileUpload($single);
			} elseif ($single instanceof Http\FileUpload) {
				$this->value[] = $single;
			} else {
				$this->value[] = new Http\FileUpload(NULL);
			}
		}
		return $this;
	}

	public function isFilled() {
		return $this->value[0] instanceof Http\FileUpload && $this->value[0]->isOK();
	}

	public static function validateFileSize(UploadControl $control, $limit)
	{
		$files = $control->getValue();
		foreach($files as $file) {
			if($file instanceof Http\FileUpload && $file->getSize() <= $limit)
				{}
			else
				return false;
		}

		return true;
	}

	public static function validateMimeType(UploadControl $control, $mimeType)
	{
		$files = $control->getValue();
		foreach($files as $file) {
			if ($file instanceof Http\FileUpload) {
				$type = strtolower($file->getContentType());
				$mimeTypes = is_array($mimeType) ? $mimeType : explode(',', $mimeType);
				if (!in_array($type, $mimeTypes, TRUE)) {
					return FALSE;
				}
				if (!in_array(preg_replace('#/.*#', '/*', $type), $mimeTypes, TRUE)) {
					return FALSE;
				}
			}
			return FALSE;
		}
		return TRUE;
	}

	public static function validateImage(UploadControl $control) {
		$files = $control->getValue();
		foreach($files as $file) {
			if($file instanceof Http\FileUpload && $file->isImage())
				{}
			else
				return false;
		}

		return true;
	}
}
?>

Aby to všechno fungovalo, je potřeba uložit soubor MultiUpload.php někam, kde jej najde autoloader, a někde (třeba v basepresenteru) ještě ke třídě Nette\Application\UI\Form připojit metodu addMultiUpload:

\Nette\Application\UI\Form::extensionMethod('addMultiUpload', function(\Nette\Application\UI\Form $form, $name, $label = NULL) {
	$form[$name] = new \Nette\Forms\Controls\MultiUploadControl($label);
	return $form[$name];
});

Poté už u libovolného formuláře stačí přidat input, např.:

$form->addMultiUpload("image", "Obrázek")->addRule(Form::IMAGE, "Lze vložit pouze obrázky");

Nezaručuju, že bude vše fungovat dokonale. Zkoušel jsem nahrávat soubory a základní validační pravidla pro vyplnění, typ a velikost. Pokud někdo najde nějakou nefunkčnost, klidně mě doplňte, rád si to upravím.

Postesk na závěr
Škoda, že to Nette neumí samo. Přitom MultiSelect je v podstatě stejná situace a je dostupný.

Editoval netrunner (5. 11. 2012 13:08)