CIBlock::makeFileArray函数介绍

简介

CIBlock::makeFileArray是ABitrix CMS的一种方法，具体用途是将传递给它的文件路径转换为一个符合Bitrix实体"data file"格式的数组。

语法

CIBlock::makeFileArray($path, $mimeType = false)

• $path: (string/array) 传递给函数的文件路径或文件路径数组。
• $mimeType: (string) 可选参数。文件MIME类型，如果提供，将会被用于在"data file"中标记文件类型。

返回值

该方法将返回一个数组，该数组包含了一个符合Bitrix实体"data file"格式的文件信息，其结构如下：

array(
  "name" => "filename.ext",
  "type" => "image/png",
  "tmp_name" => "/tmp/php6cNJ6O",
  "error" => 0,
  "size" => 2000,
)

示例

// 单个文件路径转换成数组
$file = "/path/to/file.png";
$fileArray = CIBlock::makeFileArray($file, "image/png");

// 多个文件路径转换成数组
$files = array(
  "/path/to/file1.png", 
  "/path/to/file2.jpg",
  "/path/to/file3.gif"
);
$fileArray = array();
foreach($files as $f){
  $fileArray[] = CIBlock::makeFileArray($f);
}

注意事项

1. 文件路径应为物理路径而非URL，掌握正确的文件路径的获取方法非常重要，否则将无法正常使用该函数。
2. 如果需要上传多个文件，请使用循环语句以单个文件形式调用函数，这将防止“最大文件张数被超限”的错误。
3. 如果未提供MIME类型，Bitrix将尝试通过文件扩展名确定MIME类型。

参考资料

ABitrix CMS文档：https://dev.1c-bitrix.ru/api_help/iblock/classes/ciblock/makefilearray.php