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

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
Наверх