Документация для разработчиков
Темная тема

SaveFile

Описание и параметры

int
SaveFile(
	string name,
	array arRestriction = Array()
);

Метод сохраняет файл в системе. В случае удачной загрузки метод возвратит ID добавленного файла.

Параметры функции

Параметр Описание
name Имя поля для загрузки файла на сервер.
arRestriction Массив ограничений на загружаемый файл вида Array("вид_ограничения" => "значение_ограничения" [,...]). Вид ограничения может принимать следующие значения:
  • max_file_size - максимальный размер загружаемого файла в байтах;
  • max_width - максимальная ширина загружаемой картинки в пикселях;
  • max_height - максимальная высота загружаемой картинки в пикселях;
  • extensions - допустимые расширения загружаемого файла через запятую.
  • make_preview - если параметр установлен в значение Y, то метод создаст уменьшенную копию загружаемого файла с максимальной шириной max_width и максимальной высотой max_height. По умолчанию параметр равен N.
Необязательный параметр, по умолчанию ограничений нет.

Примеры использования

Мастер создания нового пользователя

<?
if(!defined("B_PROLOG_INCLUDED") || B_PROLOG_INCLUDED!==true)die();
class Step extends CWizardStep
{
	function InitStep()
	{
		$this->SetTitle("Загрузка файла");
		$this->SetStepID("step");
		$this->SetNextStep("step");
		$this->SetFinishStep("step");
		$this->SetNextCaption("Загрузить");
		$this->SetFinishCaption("Скопировать");
	}
	function OnPostForm()
	{
		$wizard =& $this->GetWizard();
		if ($wizard->IsNextButtonClick())
			$this->SaveFile("file", Array("max_file_size" => 20*1024, "extensions" => "gif,jpg,png"));
		elseif($wizard->IsFinishButtonClick())
 		{
			$fileID = $wizard->GetVar("file");
			if (intval($fileID) > 0)
				CWizardUtil::CopyFile($fileID, "/upload_picture.gif");
		}
	}
	function ShowStep()
	{
		$this->content .= "Загрузить файл:".$this->ShowFileField("file", Array("max_file_size" => 20*1024, "size" => "25"));
	}
}
?>


© «Битрикс», 2001-2024, «1С-Битрикс», 2024