Moodle 中文 API 之文件管理API

最新推荐文章于 2022-01-09 02:05:59 发布

栁罗风尘

最新推荐文章于 2022-01-09 02:05:59 发布

阅读量2.5k

点赞数 2

分类专栏： Moodle开发文章标签： moodle

Moodle开发专栏收录该内容

8 篇文章 5 订阅

订阅专栏

File API 文件管理

注意:很多时候, 当开发第三方插件时, pluginfile.php 被看做是一个回调函数在合适的插件里. 这里函数存放在lib.php 文件里且命名为 component_name_pluginfile().这些 arbitrary/extra/infomation.ext 是通过回调生成的. 例如, 文件存在 mod_forum+post 文件域(file area) 那么为他提供服务的是 mod_forum_pluginfile 函数在 mod/forum/lib.php.这个函数在 MYPLUGIN/lib.php 中通常会成对出现像下面的例子, 具体访问权限还要依赖插件所处的位置 (例如. assignment 文件只能让老师访问学生提交的文件, forum attachments 需要通过discussion 提交上来的文件):

function MYPLUGIN_pluginfile($course, $cm, $context, $filearea, $args, $forcedownload, array $options=array()) {
    // 检查上下文级别是否是期望的 - 如果你的插件是一个块, 它就会变成 CONTEXT_BLOCK, 等.
    if ($context->contextlevel != CONTEXT_MODULE) {
        return false; 
    }
 
    // 确保 filearea 是插件中的一个.
    if ($filearea !== 'expectedfilearea' && $filearea !== 'anotherexpectedfilearea') {
        return false;
    }
 
    // 确保用户是登陆的且有访问这个模块的权限 (插件不是课程模块的可以忽略'cm' 部分).
    require_login($course, true, $cm);
 
    // 检查相关权限- 这些可能依赖于 filearea 能否被访问.
    if (!has_capability('mod/MYPLUGIN:view', $context)) {
        return false;
    }
 
    // 如果你设置 itemid为空的话。就忽略下面这行， make_pluginfile_url (设置$itemid为0 代替).
    $itemid = array_shift($args); // 参数数组中的第一个参数.
 
    // 使用 itemid 任何相关的数据记录 和任何安全检查，如果用户的确有访问权限
 
    // 额外的 filename / filepath 来自参数数组.
    $filename = array_pop($args); // 参数数组最后一个参数.
    if (!$args) {
        $filepath = '/'; // 参数为空时路径为 '/'
    } else {
        $filepath = '/'.implode('/', $args).'/'; // 参数包含文件路径的元素
    }
 
    // 从文件API中遍历文件元素.
    $fs = get_file_storage();
    $file = $fs->get_file($context->id, 'mod_MYPLUGIN', $filearea, $itemid, $filepath, $filename);
    if (!$file) {
        return false; // 这个文件不存在    }
 
    // 我们现在发送文件给浏览者- 这会有一个环新村生命周期 1 天 且不会过滤. 
    // 从Moodle 2.3以后, 使用send_stored_file代替.
    send_file($file, 86400, 0, $forcedownload, $options);

你经常会用一个 API 去自动生成URL, 经常file_rewrite_pluginfile_urls函数.

3. 从用户那获取文件

在官网上查看 Using the File API in Moodle forms

5. 例子

远离核心代码的开发并不真正使用文件API，而是使用formslib代替他们自动完成.

5.1 浏览文件

$browser = get_file_browser();
$context = get_system_context();
 
$filearea = null;
$itemid   = null;
$filename = null;
if ($fileinfo = $browser->get_file_info($context, $component, $filearea, $itemid, '/', $filename)) {
    // 建立一个面包屑
    $level = $fileinfo->get_parent();
    while ($level) {
        $path[] = array('name'=>$level->get_visible_name());
        $level = $level->get_parent();
    }
    $path = array_reverse($path);
    $children = $fileinfo->get_children();
    foreach ($children as $child) {
        if ($child->is_directory()) {
            echo $child->get_visible_name();
            // 显示 contextid, itemid, component, filepath 和 filename
            var_dump($child->get_params());
        }
    }
}

5.2 移动文件

例如, 如果你仅仅建立一个文件在临时路径里

$from_zip_file = $CFG->dataroot . '/temp/backup/' . $preferences->backup_unique_code .
         '/' . $preferences->backup_name;

而且你想将他移动到course_backup 文件域, 那么你需要需做

$context = get_context_instance(CONTEXT_COURSE, $preferences->backup_course);
 $fs = get_file_storage();
 $file_record = array('contextid'=>$context->id, 'component'=>'course', 'filearea'=>'backup',
         'itemid'=>0, 'filepath'=>'/', 'filename'=>$preferences->backup_name,
         'timecreated'=>time(), 'timemodified'=>time());
 $fs->create_file_from_pathname($file_record, $from_zip_file);

5.3 文件列表

$fs = get_file_storage();
$files = $fs->get_area_files($contextid, 'mod_assignment', 'submission', $submission->id);
foreach ($files as $f) {
    // $f 是stored_file的一个实例
    echo $f->get_filename();
}

或者像链接...

$out = array();
 
$fs = get_file_storage();
$files = $fs->get_area_files($contextid, 'mod_assignment', 'submission', $submission->id);
 
foreach ($files as $file) {
    $filename = $file->get_filename();
    $url = moodle_url::make_file_url('/pluginfile.php', array($file->get_contextid(), 'mod_assignment', 'submission',
            $file->get_itemid(), $file->get_filepath(), $filename));
    $out[] = html_writer::link($url, $filename);
}
$br = html_writer::empty_tag('br');
 
return implode($br, $out);

5.4 创建文件

这儿介绍了如何创建一个文本字符串文件. 相当于 PHP 函数file_put_contents.

$fs = get_file_storage();
 
// 准备文件记录对象
$fileinfo = array(
    'contextid' => $context->id, // context的ID
    'component' => 'mod_mymodule',     // 模块名
    'filearea' => 'myarea',     // 文件域
    'itemid' => 0,               // usually = ID of row in table
    'filepath' => '/',           // 文件路径的开始和结束使用 /
    'filename' => 'myfile.txt'); // 文件名
 
// 创建包含文本'hello world'的文件
$fs->create_file_from_string($fileinfo, 'hello world');

如果你想创建一个文件在Moodle file area中基于一个真的文件，如.临时的目录中,你能用create_file_from_pathname代替. 类似的,你能创建一个其他已经存在于 Moodle的本地文件通过使用 create_file_from_storedfile. 浏览通过lib/filestorage/file_storage.php 获取具体信息.

不同与普通文件, 这个方法不会自动重写一个存在的文件. 如果你希望重写一个文件, 你首先得获取这个文件删除它 (如果它存在的话),然后再次创建他.

5.5 读文件

这是读文件的一种方式, 等价于file_get_contents.请注意你仅仅被允许访问来自 mod/mymodule/* 模块的代码, 他是不能在其他任何地方访问的. 其他代码不得不使用 file_browser接口代替.

$fs = get_file_storage();
 
// Prepare file record object
$fileinfo = array(
    'component' => 'mod_mymodule',     // usually = table name
    'filearea' => 'myarea',     // usually = table name
    'itemid' => 0,               // usually = ID of row in table
    'contextid' => $context->id, // ID of context
    'filepath' => '/',           // any path beginning and ending in /
    'filename' => 'myfile.txt'); // any filename
 
// 获取
$file = $fs->get_file($fileinfo['contextid'], $fileinfo['component'], $fileinfo['filearea'],
                      $fileinfo['itemid'], $fileinfo['filepath'], $fileinfo['filename']);
 
// 读取内容
if ($file) {
    $contents = $file->get_content();
} else {
    // 文件不存在时 代码
}

如果你想直接从硬盘访问这个文件, 他是禁止的.你可以在临时目录中得导一份拷贝.像这样 $file->copy_content_to($pathname)，然后就可以访问了.

5.6 删除文件

$fs = get_file_storage();
 
// 准备文件记录对象
$fileinfo = array(
    'component' => 'mod_mymodule',
    'filearea' => 'myarea',     // usually = table name
    'itemid' => 0,               // usually = ID of row in table
    'contextid' => $context->id, // ID of context
    'filepath' => '/',           // any path beginning and ending in /
    'filename' => 'myfile.txt'); // 文件名
 
// 获取文件
$file = $fs->get_file($fileinfo['contextid'], $fileinfo['component'], $fileinfo['filearea'], 
        $fileinfo['itemid'], $fileinfo['filepath'], $fileinfo['filename']);
 
// 如果存在删除它
if ($file) {
    $file->delete();
}

栁罗风尘

关注

2
点赞
踩
3

收藏

觉得还不错? 一键收藏
0
评论
Moodle 中文 API 之文件管理API

File API 文件管理目录1. 概述2. 文件域 2.1 命名文件域3. 提供文件给用户4. 从用户那获取文件5. 例子 5.1 浏览文件 5.2 移动文件 5.3 文件列表 5.4创建文件 5.5 读文件 5.6 删除文件 1. 概述文件 API 是讲述在Moodle中的所有的文件存储. 如果你对
复制链接

扫一扫